Files
classroomio/packages/utils/src/config/upload-limits.ts
T
Rotimi Best a61942feb9 feat: configurable upload file size limits via .env (#695)
* feat: make upload file size limits configurable via .env

Add UPLOAD_MAX_*_MB environment variables for documents, images, videos,
exercise assignment files, AI assistant documents, landing page images,
and media thumbnails. API presign routes validate file size server-side;
dashboard UI reads the same limits from layout data.

* chore: wire upload limit env vars through Docker compose and docs

Pass UPLOAD_MAX_*_MB from the root .env into api and dashboard containers
in both compose files, document them in .env.example and self-hosting guides.

Co-authored-by: Rotimi Best <rotimi-best@users.noreply.github.com>

* docs: cross-link upload limits in README, Railway, Coolify, and Cloudflare guides

Co-authored-by: Rotimi Best <rotimi-best@users.noreply.github.com>

* fix: address PR review feedback on upload limits

- Restore 5 MB default for thumbnail uploads (edit-asset-dialog regression)
- Add getResolvedUploadLimits() fallback for Storybook/tests
- Cache core getUploadLimits() like the dashboard helper
- Document presign fileSize as advisory; allow zero-byte fileSize in schema
- Only send fileSize to presign when greater than zero

* docs: remove upload limits from Cloudflare setup guide

---------
2026-06-29 12:48:51 +01:00

70 lines
2.0 KiB
TypeScript

const BYTES_PER_MB = 1024 * 1024;
function parseUploadLimitMb(value: string | undefined, defaultMb: number): number {
if (value === undefined || value === '') {
return defaultMb;
}
const parsed = Number(value);
if (!Number.isFinite(parsed) || parsed <= 0) {
return defaultMb;
}
return parsed;
}
export type UploadLimits = {
documentMb: number;
imageMb: number;
videoMb: number;
exerciseFileMb: number;
agentDocumentMb: number;
landingImageMb: number;
thumbnailMb: number;
documentBytes: number;
imageBytes: number;
videoBytes: number;
exerciseFileBytes: number;
agentDocumentBytes: number;
landingImageBytes: number;
thumbnailBytes: number;
};
export type UploadLimitEnv = {
UPLOAD_MAX_DOCUMENT_MB?: string;
UPLOAD_MAX_IMAGE_MB?: string;
UPLOAD_MAX_VIDEO_MB?: string;
UPLOAD_MAX_EXERCISE_FILE_MB?: string;
UPLOAD_MAX_AGENT_DOCUMENT_MB?: string;
UPLOAD_MAX_LANDING_IMAGE_MB?: string;
UPLOAD_MAX_THUMBNAIL_MB?: string;
};
export function resolveUploadLimits(env: UploadLimitEnv): UploadLimits {
const documentMb = parseUploadLimitMb(env.UPLOAD_MAX_DOCUMENT_MB, 5);
const imageMb = parseUploadLimitMb(env.UPLOAD_MAX_IMAGE_MB, 5);
const videoMb = parseUploadLimitMb(env.UPLOAD_MAX_VIDEO_MB, 800);
const exerciseFileMb = parseUploadLimitMb(env.UPLOAD_MAX_EXERCISE_FILE_MB, 2);
const agentDocumentMb = parseUploadLimitMb(env.UPLOAD_MAX_AGENT_DOCUMENT_MB, 5);
const landingImageMb = parseUploadLimitMb(env.UPLOAD_MAX_LANDING_IMAGE_MB, 0.5);
const thumbnailMb = parseUploadLimitMb(env.UPLOAD_MAX_THUMBNAIL_MB, 5);
return {
documentMb,
imageMb,
videoMb,
exerciseFileMb,
agentDocumentMb,
landingImageMb,
thumbnailMb,
documentBytes: documentMb * BYTES_PER_MB,
imageBytes: imageMb * BYTES_PER_MB,
videoBytes: videoMb * BYTES_PER_MB,
exerciseFileBytes: exerciseFileMb * BYTES_PER_MB,
agentDocumentBytes: agentDocumentMb * BYTES_PER_MB,
landingImageBytes: landingImageMb * BYTES_PER_MB,
thumbnailBytes: thumbnailMb * BYTES_PER_MB
};
}