@openinary/core 1.1.0

package/dist/utils/video/config.js

@@ -0,0 +1,170 @@
+/**
+ * Video processing queue configuration
+ * These values can be overridden via environment variables
+ */
+import * as fs from "fs";
+import * as os from "os";
+const CGROUP_V2_MAX_PATH = "/sys/fs/cgroup/memory.max";
+const CGROUP_V1_LIMIT_PATH = "/sys/fs/cgroup/memory/memory.limit_in_bytes";
+// cgroup v1 reports this (or similar huge values) when no limit is set
+const CGROUP_V1_UNLIMITED_THRESHOLD = 1e18;
+const CGROUP_V2_CPU_MAX_PATH = "/sys/fs/cgroup/cpu.max";
+const CGROUP_V1_CPU_QUOTA_PATH = "/sys/fs/cgroup/cpu/cpu.cfs_quota_us";
+const CGROUP_V1_CPU_PERIOD_PATH = "/sys/fs/cgroup/cpu/cpu.cfs_period_us";
+/**
+ * Read the container memory limit from cgroup v2 or v1, if present.
+ * Returns null when no cgroup file is found or the limit is "unlimited".
+ */
+function readCgroupMemoryLimit() {
+    try {
+        const raw = fs.readFileSync(CGROUP_V2_MAX_PATH, "utf8").trim();
+        if (raw === "max")
+            return null;
+        const value = parseInt(raw, 10);
+        return Number.isFinite(value) ? value : null;
+    }
+    catch {
+        // cgroup v2 file not present, fall through to v1
+    }
+    try {
+        const raw = fs.readFileSync(CGROUP_V1_LIMIT_PATH, "utf8").trim();
+        const value = parseInt(raw, 10);
+        if (!Number.isFinite(value) || value >= CGROUP_V1_UNLIMITED_THRESHOLD)
+            return null;
+        return value;
+    }
+    catch {
+        // cgroup v1 file not present either
+    }
+    return null;
+}
+/**
+ * Effective memory available to the process: the lower of the host RAM
+ * and the container's cgroup memory limit (if one is set).
+ */
+function getEffectiveMemoryBytes() {
+    const cgroupLimit = readCgroupMemoryLimit();
+    const hostMemory = os.totalmem();
+    if (cgroupLimit !== null && cgroupLimit < hostMemory) {
+        return { bytes: cgroupLimit, source: "cgroup limit" };
+    }
+    return { bytes: hostMemory, source: "host RAM" };
+}
+/**
+ * Read the container CPU limit from cgroup v2 or v1, if present.
+ * Returns the number of CPUs as a float (e.g. 0.5, 2), or null when
+ * no cgroup file is found or the limit is "unlimited".
+ */
+function readCgroupCpuLimit() {
+    try {
+        // cgroup v2 format: "<quota> <period>" or "max <period>"
+        const raw = fs.readFileSync(CGROUP_V2_CPU_MAX_PATH, "utf8").trim();
+        const [quotaRaw, periodRaw] = raw.split(/\s+/);
+        if (quotaRaw === "max")
+            return null;
+        const quota = parseInt(quotaRaw, 10);
+        const period = parseInt(periodRaw, 10);
+        if (Number.isFinite(quota) && Number.isFinite(period) && quota > 0 && period > 0) {
+            return quota / period;
+        }
+        return null;
+    }
+    catch {
+        // cgroup v2 file not present, fall through to v1
+    }
+    try {
+        // cgroup v1 reports quota -1 when no limit is set
+        const quota = parseInt(fs.readFileSync(CGROUP_V1_CPU_QUOTA_PATH, "utf8").trim(), 10);
+        const period = parseInt(fs.readFileSync(CGROUP_V1_CPU_PERIOD_PATH, "utf8").trim(), 10);
+        if (Number.isFinite(quota) && Number.isFinite(period) && quota > 0 && period > 0) {
+            return quota / period;
+        }
+    }
+    catch {
+        // cgroup v1 file not present either
+    }
+    return null;
+}
+/**
+ * Effective CPU count available to the process: the lower of the host CPUs
+ * and the container's cgroup CPU quota (if one is set), floored to at least 1.
+ */
+function getEffectiveCpuCount() {
+    const cgroupLimit = readCgroupCpuLimit();
+    const hostCpus = os.cpus().length;
+    if (cgroupLimit !== null && cgroupLimit < hostCpus) {
+        return { count: Math.max(1, Math.floor(cgroupLimit)), source: "cgroup limit" };
+    }
+    return { count: hostCpus, source: "host CPUs" };
+}
+/**
+ * Detect optimal number of concurrent video jobs based on available resources.
+ * Memory: 1 worker per 2GB. CPU: at most 1 worker per effective CPU, so
+ * concurrent ffmpeg processes can never oversubscribe the container.
+ * Minimum 1, maximum 16.
+ */
+function detectOptimalConcurrency(memoryBytes, cpuCount) {
+    const memoryGB = memoryBytes / (1024 ** 3);
+    const byMemory = Math.max(1, Math.floor(memoryGB / 2));
+    // Cap at 16 workers to prevent excessive resource usage
+    return Math.max(1, Math.min(byMemory, cpuCount, 16));
+}
+const { bytes: effectiveMemoryBytes, source: memorySource } = getEffectiveMemoryBytes();
+const { count: effectiveCpuCount, source: cpuSource } = getEffectiveCpuCount();
+/**
+ * Effective CPU count (host CPUs or cgroup quota, whichever is lower)
+ */
+export const EFFECTIVE_CPU_COUNT = effectiveCpuCount;
+/**
+ * Number of threads each ffmpeg process may use.
+ * Leaves one CPU free for the HTTP serving event loop so video jobs never
+ * starve the API, or configured via VIDEO_FFMPEG_THREADS env variable.
+ */
+export const FFMPEG_THREADS = process.env.VIDEO_FFMPEG_THREADS
+    ? Math.max(1, parseInt(process.env.VIDEO_FFMPEG_THREADS, 10) || 1)
+    : Math.max(1, effectiveCpuCount - 1);
+/**
+ * Niceness applied to spawned ffmpeg processes (0-19, higher = lower priority).
+ * Keeps the Node event loop responsive even when ffmpeg saturates the CPU.
+ * Configurable via VIDEO_FFMPEG_NICENESS env variable.
+ */
+export const FFMPEG_NICENESS = process.env.VIDEO_FFMPEG_NICENESS
+    ? parseInt(process.env.VIDEO_FFMPEG_NICENESS, 10)
+    : 15;
+/**
+ * Maximum number of concurrent video jobs
+ * Auto-detected based on available memory and CPU (host or cgroup limit,
+ * whichever is lower), or configured via VIDEO_MAX_CONCURRENT env variable
+ */
+export const MAX_CONCURRENT_JOBS = process.env.VIDEO_MAX_CONCURRENT
+    ? parseInt(process.env.VIDEO_MAX_CONCURRENT, 10)
+    : detectOptimalConcurrency(effectiveMemoryBytes, effectiveCpuCount);
+// Log detected configuration on module load
+const effectiveMemoryGB = (effectiveMemoryBytes / (1024 ** 3)).toFixed(2);
+const configSource = process.env.VIDEO_MAX_CONCURRENT ? "env variable" : `${memorySource}, ${cpuSource}`;
+console.log(`[Video Config] Memory: ${effectiveMemoryGB}GB (${memorySource}) | CPUs: ${effectiveCpuCount} (${cpuSource}) | Max concurrent jobs: ${MAX_CONCURRENT_JOBS} (${configSource}) | ffmpeg threads: ${FFMPEG_THREADS}, niceness: ${FFMPEG_NICENESS}`);
+/**
+ * Maximum number of retry attempts for failed jobs
+ */
+export const JOB_RETRY_MAX = parseInt(process.env.VIDEO_JOB_RETRY_MAX || "3", 10);
+/**
+ * Hours after which completed/error jobs are cleaned up
+ */
+export const JOB_CLEANUP_HOURS = parseInt(process.env.VIDEO_JOB_CLEANUP_HOURS || "24", 10);
+/**
+ * Worker polling interval in milliseconds
+ */
+export const WORKER_POLL_INTERVAL_MS = parseInt(process.env.VIDEO_WORKER_POLL_INTERVAL_MS || "1000", 10);
+/**
+ * Priority for thumbnail extraction jobs (lower = higher priority)
+ */
+export const THUMBNAIL_PRIORITY = 1;
+/**
+ * Priority for video transformation jobs
+ */
+export const TRANSFORMATION_PRIORITY = 2;
+/**
+ * Priority for other video jobs
+ */
+export const LOW_PRIORITY = 3;
+//# sourceMappingURL=config.js.map

package/dist/utils/video/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/utils/video/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AACvD,MAAM,oBAAoB,GAAG,6CAA6C,CAAC;AAC3E,uEAAuE;AACvE,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAE3C,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AACxD,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AACvE,MAAM,yBAAyB,GAAG,sCAAsC,CAAC;AAEzE;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,GAAG,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,6BAA6B;YAAE,OAAO,IAAI,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB;IAC9B,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,GAAG,UAAU,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,yDAAyD;QACzD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACjF,OAAO,KAAK,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,IAAI,CAAC;QACH,kDAAkD;QAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACjF,OAAO,KAAK,GAAG,MAAM,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;IAClC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,GAAG,QAAQ,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,WAAmB,EAAE,QAAgB;IACrE,MAAM,QAAQ,GAAG,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,wDAAwD;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,uBAAuB,EAAE,CAAC;AACxF,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,oBAAoB,EAAE,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;IAC5D,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB;IAC9D,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,CAAC;IACjD,CAAC,CAAC,EAAE,CAAC;AAEP;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;IACjE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC;IAChD,CAAC,CAAC,wBAAwB,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;AAEtE,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,CAAC,oBAAoB,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1E,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,KAAK,SAAS,EAAE,CAAC;AACzG,OAAO,CAAC,GAAG,CAAC,0BAA0B,iBAAiB,OAAO,YAAY,aAAa,iBAAiB,KAAK,SAAS,4BAA4B,mBAAmB,KAAK,YAAY,uBAAuB,cAAc,eAAe,eAAe,EAAE,CAAC,CAAC;AAE7P;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CACnC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,GAAG,EACtC,EAAE,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,EAC3C,EAAE,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAC7C,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,MAAM,EACnD,EAAE,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC"}

package/dist/utils/video/format.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Supported image formats for video thumbnails
+ */
+export declare const IMAGE_FORMATS: Set<string>;
+/**
+ * Supported video formats
+ */
+export declare const VIDEO_FORMATS: Set<string>;
+/**
+ * Normalize format name (jpeg -> jpg)
+ */
+export declare const normalizeFormat: (format: string) => string;
+/**
+ * Determine output format and whether it's an image or thumbnail
+ */
+export declare const determineOutputFormat: (sourceExt: string | undefined, requestedFormat: string | undefined) => {
+    format: string;
+    isImageOutput: boolean;
+    isThumbnail: boolean;
+};
+export declare const contentTypeForFormat: (format: string) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/video/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/video/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,aAAa,aAAgE,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,aAAa,aAAkC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAEhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,GAAG,SAAS,EAC7B,iBAAiB,MAAM,GAAG,SAAS,KAClC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CA8BhE,CAAC;AAgBF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MAMrD,CAAC"}

package/dist/utils/video/format.js

@@ -0,0 +1,64 @@
+/**
+ * Supported image formats for video thumbnails
+ */
+export const IMAGE_FORMATS = new Set(["jpg", "jpeg", "png", "webp", "avif", "gif", "psd"]);
+/**
+ * Supported video formats
+ */
+export const VIDEO_FORMATS = new Set(["mp4", "mov", "webm"]);
+/**
+ * Normalize format name (jpeg -> jpg)
+ */
+export const normalizeFormat = (format) => {
+    return format === "jpeg" ? "jpg" : format;
+};
+/**
+ * Determine output format and whether it's an image or thumbnail
+ */
+export const determineOutputFormat = (sourceExt, requestedFormat) => {
+    const requestedFormatLower = requestedFormat?.toLowerCase();
+    const isImageFormat = !!requestedFormatLower &&
+        IMAGE_FORMATS.has(normalizeFormat(requestedFormatLower));
+    const isVideoSource = !!sourceExt && VIDEO_FORMATS.has(sourceExt);
+    const isThumbnail = isVideoSource && isImageFormat;
+    // Decide output extension:
+    // - Thumbnail => image format (default jpg)
+    // - Video transform => requested video format or fall back to mp4
+    let format;
+    if (isThumbnail) {
+        const normalizedFormat = normalizeFormat(requestedFormatLower);
+        format = IMAGE_FORMATS.has(normalizedFormat) ? normalizedFormat : "jpg";
+    }
+    else {
+        const baseVideoExt = requestedFormatLower && VIDEO_FORMATS.has(requestedFormatLower)
+            ? requestedFormatLower
+            : "mp4";
+        format = baseVideoExt;
+    }
+    return {
+        format,
+        isImageOutput: isImageFormat,
+        isThumbnail,
+    };
+};
+/**
+ * MIME content type for a resolved output format.
+ */
+const CONTENT_TYPE_BY_FORMAT = {
+    jpg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp",
+    avif: "image/avif",
+    gif: "image/gif",
+    mp4: "video/mp4",
+    webm: "video/webm",
+    mov: "video/quicktime",
+};
+export const contentTypeForFormat = (format) => {
+    const normalized = normalizeFormat(format.toLowerCase());
+    if (CONTENT_TYPE_BY_FORMAT[normalized]) {
+        return CONTENT_TYPE_BY_FORMAT[normalized];
+    }
+    return IMAGE_FORMATS.has(normalized) ? `image/${normalized}` : "video/mp4";
+};
+//# sourceMappingURL=format.js.map

package/dist/utils/video/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/utils/video/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE3F;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE;IACxD,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,SAA6B,EAC7B,eAAmC,EAC+B,EAAE;IACpE,MAAM,oBAAoB,GAAG,eAAe,EAAE,WAAW,EAAE,CAAC;IAE5D,MAAM,aAAa,GACjB,CAAC,CAAC,oBAAoB;QACtB,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAE3D,MAAM,aAAa,GAAG,CAAC,CAAC,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,aAAa,IAAI,aAAa,CAAC;IAEnD,2BAA2B;IAC3B,4CAA4C;IAC5C,kEAAkE;IAClE,IAAI,MAAc,CAAC;IACnB,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,gBAAgB,GAAG,eAAe,CAAC,oBAAqB,CAAC,CAAC;QAChE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,GAChB,oBAAoB,IAAI,aAAa,CAAC,GAAG,CAAC,oBAAoB,CAAC;YAC7D,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,KAAK,CAAC;QACZ,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;IAED,OAAO;QACL,MAAM;QACN,aAAa,EAAE,aAAa;QAC5B,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,sBAAsB,GAAqC;IAC/D,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,iBAAiB;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAc,EAAU,EAAE;IAC7D,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,IAAI,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7E,CAAC,CAAC"}

package/dist/utils/video/index.d.ts

@@ -0,0 +1,25 @@
+import type { VideoTransformParams } from "../../types";
+export * from "./types";
+export * from "./param-registry";
+export * from "./video-info";
+/**
+ * Transform a video with the specified parameters.
+ *
+ * Supports:
+ * - Video transformations (resize, quality, trim)
+ * - Thumbnail extraction (single frame as image)
+ * - Format conversion (mp4, mov, webm, jpg, png, webp, avif, …)
+ * - Auto-downscales to 720p max (unless explicit resize specified)
+ * - Default compression quality of 60/100 (CRF 31), optimised for 8K
+ * - Ultra-fast encoding preset with baseline profile for minimal CPU usage
+ * - Audio copied without re-encoding
+ * - 5-minute timeout protection (accommodates 8K videos)
+ *
+ * Thumbnail pipeline detail:
+ *   1. ffmpeg seeks to tt_N and extracts one JPEG frame (universal support).
+ *   2. If the requested format needs sharp (webp, avif, png, gif), the JPEG
+ *      buffer is post-processed by sharp, this avoids relying on optional
+ *      ffmpeg build flags such as libwebp.
+ */
+export declare const transformVideo: (inputPath: string, params: VideoTransformParams) => Promise<Buffer>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/video/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAexD,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAoC7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GACzB,WAAW,MAAM,EACjB,QAAQ,oBAAoB,KAC3B,OAAO,CAAC,MAAM,CAiEhB,CAAC"}

package/dist/utils/video/index.js

@@ -0,0 +1,104 @@
+import { mkdtemp } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { randomUUID } from "crypto";
+import { determineOutputFormat, IMAGE_FORMATS, normalizeFormat, } from "./format.js";
+import { applyThumbnailExtraction } from "./thumbnail.js";
+import { applyTrimming } from "./trim.js";
+import { applyAutoDownscale } from "./auto-downscale.js";
+import { applyResize } from "./resize.js";
+import { applyQuality } from "./quality.js";
+import { VideoCommandBuilder } from "./command-builder.js";
+// Re-export types for backward compatibility
+export * from "./types.js";
+export * from "./param-registry.js";
+export * from "./video-info.js";
+/**
+ * Image formats that ffmpeg cannot encode natively in all builds.
+ * For these we extract a JPEG frame via ffmpeg, then convert with sharp.
+ * This decouples thumbnail quality from ffmpeg's build flags (e.g. libwebp).
+ */
+const SHARP_CONVERTED_FORMATS = new Set(["webp", "avif", "png", "gif"]);
+/**
+ * Convert an image buffer to the target format using sharp.
+ * Falls back to the original buffer on any sharp error.
+ */
+async function convertWithSharp(buffer, targetFormat, quality) {
+    const sharp = (await import("sharp")).default;
+    const q = quality !== undefined ? Math.round(quality) : 80;
+    switch (targetFormat) {
+        case "webp":
+            return sharp(buffer).webp({ quality: q }).toBuffer();
+        case "avif":
+            return sharp(buffer).avif({ quality: q }).toBuffer();
+        case "png":
+            return sharp(buffer).png().toBuffer();
+        case "gif":
+            // sharp doesn't encode animated GIF well; best effort single frame
+            return sharp(buffer).gif().toBuffer();
+        default:
+            return buffer;
+    }
+}
+/**
+ * Transform a video with the specified parameters.
+ *
+ * Supports:
+ * - Video transformations (resize, quality, trim)
+ * - Thumbnail extraction (single frame as image)
+ * - Format conversion (mp4, mov, webm, jpg, png, webp, avif, …)
+ * - Auto-downscales to 720p max (unless explicit resize specified)
+ * - Default compression quality of 60/100 (CRF 31), optimised for 8K
+ * - Ultra-fast encoding preset with baseline profile for minimal CPU usage
+ * - Audio copied without re-encoding
+ * - 5-minute timeout protection (accommodates 8K videos)
+ *
+ * Thumbnail pipeline detail:
+ *   1. ffmpeg seeks to tt_N and extracts one JPEG frame (universal support).
+ *   2. If the requested format needs sharp (webp, avif, png, gif), the JPEG
+ *      buffer is post-processed by sharp, this avoids relying on optional
+ *      ffmpeg build flags such as libwebp.
+ */
+export const transformVideo = async (inputPath, params) => {
+    // Create temporary directory for output
+    const tmpDir = await mkdtemp(join(tmpdir(), "video-"));
+    // Get source file extension
+    const sourceExt = inputPath.split(".").pop()?.toLowerCase();
+    // Determine output format and flags
+    const { format, isImageOutput, isThumbnail } = determineOutputFormat(sourceExt, params.format);
+    // For thumbnails, always let ffmpeg output JPEG, it is universally supported
+    // regardless of ffmpeg build flags (no libwebp required).
+    // We post-process with sharp afterwards if the requested format differs.
+    const ffmpegFormat = isThumbnail ? "jpg" : format;
+    const needsSharpConversion = isThumbnail &&
+        IMAGE_FORMATS.has(normalizeFormat(format)) &&
+        SHARP_CONVERTED_FORMATS.has(normalizeFormat(format));
+    // Generate output path using the ffmpeg-friendly format
+    const outputPath = join(tmpDir, `${randomUUID()}.${ffmpegFormat}`);
+    // Build context object
+    const context = {
+        inputPath,
+        outputPath,
+        tmpDir,
+        params,
+        isImageOutput,
+        isThumbnail,
+    };
+    // Apply transformations pipeline and execute
+    // Order matters: thumbnail extraction or trimming first, auto-downscale, resize, then quality
+    const builder = new VideoCommandBuilder(context);
+    let buffer = await builder
+        .apply(applyThumbnailExtraction, applyTrimming, applyAutoDownscale, applyResize, applyQuality)
+        .execute();
+    // Post-process with sharp if needed (e.g. JPEG → WebP/AVIF/PNG)
+    if (needsSharpConversion) {
+        const qualityValue = params.quality !== undefined
+            ? typeof params.quality === "string"
+                ? parseInt(params.quality, 10)
+                : params.quality
+            : 80;
+        buffer = await convertWithSharp(buffer, normalizeFormat(format), qualityValue);
+    }
+    return buffer;
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/video/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,6CAA6C;AAC7C,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAE7B;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAExE;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAC7B,MAAc,EACd,YAAoB,EACpB,OAAgB;IAEhB,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9C,MAAM,CAAC,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3D,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvD,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvD,KAAK,KAAK;YACR,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,KAAK;YACR,mEAAmE;YACnE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxC;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,SAAiB,EACjB,MAA4B,EACX,EAAE;IACnB,wCAAwC;IACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEvD,4BAA4B;IAC5B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAE5D,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,qBAAqB,CAClE,SAAS,EACT,MAAM,CAAC,MAAM,CACd,CAAC;IAEF,6EAA6E;IAC7E,0DAA0D;IAC1D,yEAAyE;IACzE,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,oBAAoB,GACxB,WAAW;QACX,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1C,uBAAuB,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,wDAAwD;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IAEnE,uBAAuB;IACvB,MAAM,OAAO,GAAiB;QAC5B,SAAS;QACT,UAAU;QACV,MAAM;QACN,MAAM;QACN,aAAa;QACb,WAAW;KACZ,CAAC;IAEF,6CAA6C;IAC7C,8FAA8F;IAC9F,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,MAAM,GAAG,MAAM,OAAO;SACvB,KAAK,CACJ,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,YAAY,CACb;SACA,OAAO,EAAE,CAAC;IAEb,gEAAgE;IAChE,IAAI,oBAAoB,EAAE,CAAC;QACzB,MAAM,YAAY,GAChB,MAAM,CAAC,OAAO,KAAK,SAAS;YAC1B,CAAC,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;gBAClC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9B,CAAC,CAAC,MAAM,CAAC,OAAO;YAClB,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,GAAG,MAAM,gBAAgB,CAC7B,MAAM,EACN,eAAe,CAAC,MAAM,CAAC,EACvB,YAAY,CACb,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/utils/video/param-registry.d.ts

@@ -0,0 +1,64 @@
+import type { FfmpegCommand } from 'fluent-ffmpeg';
+import type { VideoContext } from './types';
+/**
+ * Parameter processor function type for video transformations
+ * Takes an FFmpeg command and context, returns modified command
+ */
+export type VideoParamProcessor = (command: FfmpegCommand, value: string, context: VideoContext) => FfmpegCommand;
+/**
+ * Parameter definition interface for video transformations
+ */
+export interface VideoParamDefinition {
+    /** Short parameter key used in URLs (e.g., 'w', 'h', 'so') */
+    param: string;
+    /** Human-readable name */
+    name: string;
+    /** Detailed description of the parameter */
+    description: string;
+    /** Example value for documentation */
+    example: string;
+    /** Default value if not specified */
+    defaultValue?: string | number | boolean;
+    /** Valid values or pattern description */
+    validValues?: string[];
+    /** Parameter aliases (alternative names) */
+    aliases?: string[];
+    /** The function that processes this parameter */
+    processor?: VideoParamProcessor;
+    /** Whether this parameter requires other parameters to work */
+    dependencies?: string[];
+    /** Processing order priority (lower = earlier) */
+    priority: number;
+}
+/**
+ * Complete parameter registry for video transformations
+ * Single source of truth for all video transformation parameters
+ */
+export declare const VIDEO_PARAMS: readonly VideoParamDefinition[];
+/**
+ * Helper function to apply resize with all related parameters
+ * This is a composite operation that uses w, h, r, c, and g parameters
+ */
+export declare const applyResizeComposite: (command: FfmpegCommand, context: VideoContext) => FfmpegCommand;
+/**
+ * Get parameter definition by param key
+ */
+export declare const getVideoParamDefinition: (param: string) => VideoParamDefinition | undefined;
+/**
+ * Get all parameter definitions sorted by priority
+ */
+export declare const getVideoParamsByPriority: () => readonly VideoParamDefinition[];
+/**
+ * Get default value for a parameter
+ */
+export declare const getVideoParamDefault: (param: string) => string | number | boolean | undefined;
+/**
+ * Validate if a parameter value is valid
+ */
+export declare const isValidVideoParamValue: (param: string, value: string) => boolean;
+/**
+ * Export types for external use
+ */
+export type VideoParamKey = typeof VIDEO_PARAMS[number]['param'];
+export type VideoParamRegistry = typeof VIDEO_PARAMS;
+//# sourceMappingURL=param-registry.d.ts.map

package/dist/utils/video/param-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-registry.d.ts","sourceRoot":"","sources":["../../../src/utils/video/param-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAM5C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,KAClB,aAAa,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,oBAAoB,EAgJ9C,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,aAAa,EACtB,SAAS,YAAY,KACpB,aAQF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG,oBAAoB,GAAG,SAE9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,SAAS,oBAAoB,EAExE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAGhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,OAYrE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,OAAO,YAAY,CAAC"}