@openinary/core 1.1.0

package/dist/utils/storage-level.d.ts

@@ -0,0 +1,66 @@
+export declare const IMAGE_EXTENSIONS: string[];
+export declare const VIDEO_EXTENSIONS: string[];
+export type MediaType = "image" | "video";
+export type FolderPreviewItem = {
+    path: string;
+    type: MediaType;
+};
+export type LevelFile = {
+    name: string;
+    path: string;
+    size?: number;
+    mtime?: string;
+};
+export type LevelFolder = {
+    name: string;
+    path: string;
+};
+export type FolderSummary = {
+    itemCount: number;
+    truncated: boolean;
+    previewItems: FolderPreviewItem[];
+};
+type ListedObject = {
+    key: string;
+    size?: number;
+    lastModified?: Date;
+};
+export declare const FOLDER_SUMMARY_MAX_KEYS = 100;
+export declare const FOLDER_PREVIEW_LIMIT = 4;
+export declare function getMediaType(name: string): MediaType | null;
+/**
+ * Normalizes a user-provided folder path.
+ * Returns "" for the root, null when the path is invalid (empty segments,
+ * "." or "..", critical to prevent traversal in the local-FS fallback).
+ */
+export declare function normalizeLevelPath(raw: string): string | null;
+/**
+ * Shapes one delimiter-listed directory level into folder names and files.
+ * `storagePrefix` is the raw listing prefix (e.g. "public/cows/"), `folderPath`
+ * the relative path of the listed folder ("" for root). The folder marker
+ * object (key === storagePrefix) is excluded.
+ */
+export declare function shapeLevel(storagePrefix: string, folderPath: string, delimited: {
+    prefixes: string[];
+    objects: ListedObject[];
+}): {
+    folderNames: string[];
+    files: LevelFile[];
+};
+/**
+ * Shapes a bounded single-page listing of a folder into its summary:
+ * direct child count (capped by the page size), truncation flag and up to
+ * FOLDER_PREVIEW_LIMIT media preview items.
+ */
+export declare function shapeFolderSummary(storagePrefix: string, folderPath: string, page: {
+    prefixes: string[];
+    objects: ListedObject[];
+    isTruncated: boolean;
+}, previewLimit?: number): FolderSummary;
+/**
+ * Derives every folder path (including intermediate ones) from a flat list of
+ * relative keys. Marker keys ("a/b/") count as folders themselves.
+ */
+export declare function deriveFolderPaths(keys: string[]): string[];
+export {};
+//# sourceMappingURL=storage-level.d.ts.map

package/dist/utils/storage-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-level.d.ts","sourceRoot":"","sources":["../../src/utils/storage-level.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,UAQ5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAA4B,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC,CAAC;AAEF,KAAK,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAExE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,GACzD;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAqB/C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,EAC3E,YAAY,SAAuB,GAClC,aAAa,CAqBf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAc1D"}

package/dist/utils/storage-level.js

@@ -0,0 +1,106 @@
+export const IMAGE_EXTENSIONS = [
+    ".jpg",
+    ".jpeg",
+    ".png",
+    ".webp",
+    ".gif",
+    ".avif",
+    ".psd",
+];
+export const VIDEO_EXTENSIONS = [".mp4", ".mov", ".webm"];
+export const FOLDER_SUMMARY_MAX_KEYS = 100;
+export const FOLDER_PREVIEW_LIMIT = 4;
+export function getMediaType(name) {
+    const lower = name.toLowerCase();
+    if (IMAGE_EXTENSIONS.some((ext) => lower.endsWith(ext)))
+        return "image";
+    if (VIDEO_EXTENSIONS.some((ext) => lower.endsWith(ext)))
+        return "video";
+    return null;
+}
+/**
+ * Normalizes a user-provided folder path.
+ * Returns "" for the root, null when the path is invalid (empty segments,
+ * "." or "..", critical to prevent traversal in the local-FS fallback).
+ */
+export function normalizeLevelPath(raw) {
+    const trimmed = raw.replace(/^\/+|\/+$/g, "");
+    if (!trimmed)
+        return "";
+    const segments = trimmed.split("/");
+    for (const segment of segments) {
+        if (!segment || segment === "." || segment === "..") {
+            return null;
+        }
+    }
+    return segments.join("/");
+}
+/**
+ * Shapes one delimiter-listed directory level into folder names and files.
+ * `storagePrefix` is the raw listing prefix (e.g. "public/cows/"), `folderPath`
+ * the relative path of the listed folder ("" for root). The folder marker
+ * object (key === storagePrefix) is excluded.
+ */
+export function shapeLevel(storagePrefix, folderPath, delimited) {
+    const folderNames = delimited.prefixes
+        .map((prefix) => prefix.slice(storagePrefix.length).replace(/\/+$/, ""))
+        .filter(Boolean)
+        .sort((a, b) => a.localeCompare(b));
+    const files = delimited.objects
+        .filter((obj) => obj.key !== storagePrefix)
+        .map((obj) => {
+        const name = obj.key.slice(storagePrefix.length);
+        return {
+            name,
+            path: folderPath ? `${folderPath}/${name}` : name,
+            size: obj.size,
+            mtime: obj.lastModified?.toISOString(),
+        };
+    })
+        .filter((file) => file.name)
+        .sort((a, b) => a.name.localeCompare(b.name));
+    return { folderNames, files };
+}
+/**
+ * Shapes a bounded single-page listing of a folder into its summary:
+ * direct child count (capped by the page size), truncation flag and up to
+ * FOLDER_PREVIEW_LIMIT media preview items.
+ */
+export function shapeFolderSummary(storagePrefix, folderPath, page, previewLimit = FOLDER_PREVIEW_LIMIT) {
+    const children = page.objects.filter((obj) => obj.key !== storagePrefix);
+    const previewItems = [];
+    for (const obj of children) {
+        if (previewItems.length >= previewLimit)
+            break;
+        const name = obj.key.slice(storagePrefix.length);
+        const type = getMediaType(name);
+        if (type) {
+            previewItems.push({
+                path: folderPath ? `${folderPath}/${name}` : name,
+                type,
+            });
+        }
+    }
+    return {
+        itemCount: page.prefixes.length + children.length,
+        truncated: page.isTruncated,
+        previewItems,
+    };
+}
+/**
+ * Derives every folder path (including intermediate ones) from a flat list of
+ * relative keys. Marker keys ("a/b/") count as folders themselves.
+ */
+export function deriveFolderPaths(keys) {
+    const folders = new Set();
+    for (const key of keys) {
+        const normalized = key.replace(/^\/+/, "");
+        const parts = normalized.split("/").filter(Boolean);
+        const dirDepth = normalized.endsWith("/") ? parts.length : parts.length - 1;
+        for (let i = 1; i <= dirDepth; i++) {
+            folders.add(parts.slice(0, i).join("/"));
+        }
+    }
+    return [...folders].sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=storage-level.js.map

package/dist/utils/storage-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-level.js","sourceRoot":"","sources":["../../src/utils/storage-level.ts"],"names":[],"mappings":"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"}

package/dist/utils/storage-tree.d.ts

@@ -0,0 +1,30 @@
+export type StorageNode = {
+    name: string;
+    path: string;
+    type: "file" | "directory";
+    size?: number;
+    mtime?: string;
+    children?: StorageNode[];
+};
+export type TreeDataItem = {
+    id: string;
+    name: string;
+    size?: number;
+    mtime?: string;
+    children?: TreeDataItem[];
+    draggable?: boolean;
+    droppable?: boolean;
+    disabled?: boolean;
+};
+export type ListedObject = {
+    key: string;
+    size?: number;
+    lastModified?: Date;
+};
+export declare function buildTreeFromKeys(keys: ListedObject[]): StorageNode;
+export declare function storageTreeToTreeData(root: StorageNode): TreeDataItem[];
+export declare function sumTreeSize(node: StorageNode): {
+    size: number;
+    fileCount: number;
+};
+//# sourceMappingURL=storage-tree.d.ts.map

package/dist/utils/storage-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-tree.d.ts","sourceRoot":"","sources":["../../src/utils/storage-tree.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,WAAW,CAkEnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,CAcvE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAWA"}

package/dist/utils/storage-tree.js

@@ -0,0 +1,81 @@
+export function buildTreeFromKeys(keys) {
+    const root = {
+        name: "storage",
+        path: "",
+        type: "directory",
+        children: [],
+    };
+    // Path-indexed lookups keep tree construction linear in the number of keys
+    const dirByPath = new Map([["", root]]);
+    const filePaths = new Set();
+    const ensureDir = (dirPath) => {
+        const existing = dirByPath.get(dirPath);
+        if (existing) {
+            return existing;
+        }
+        const slashIndex = dirPath.lastIndexOf("/");
+        const parent = ensureDir(slashIndex === -1 ? "" : dirPath.slice(0, slashIndex));
+        const dirNode = {
+            name: dirPath.slice(slashIndex + 1),
+            path: dirPath,
+            type: "directory",
+            children: [],
+        };
+        parent.children = parent.children || [];
+        parent.children.push(dirNode);
+        dirByPath.set(dirPath, dirNode);
+        return dirNode;
+    };
+    for (const { key, size, lastModified } of keys) {
+        const normalizedKey = key.replace(/^\/+/, "");
+        const isFolderMarker = normalizedKey.endsWith("/");
+        const parts = normalizedKey.split("/").filter(Boolean);
+        if (parts.length === 0) {
+            continue;
+        }
+        const fullPath = parts.join("/");
+        if (isFolderMarker) {
+            ensureDir(fullPath);
+            continue;
+        }
+        const parent = ensureDir(parts.slice(0, -1).join("/"));
+        if (filePaths.has(fullPath)) {
+            continue;
+        }
+        filePaths.add(fullPath);
+        parent.children = parent.children || [];
+        parent.children.push({
+            name: parts[parts.length - 1],
+            path: fullPath,
+            type: "file",
+            size,
+            mtime: lastModified?.toISOString(),
+        });
+    }
+    return root;
+}
+export function storageTreeToTreeData(root) {
+    if (!root.children)
+        return [];
+    const mapNode = (node) => {
+        return {
+            id: node.path || node.name,
+            name: node.name || node.path,
+            size: node.size,
+            mtime: node.mtime,
+            children: node.children?.map(mapNode),
+        };
+    };
+    return root.children.map(mapNode);
+}
+export function sumTreeSize(node) {
+    let size = node.size ?? 0;
+    let fileCount = node.type === "file" ? 1 : 0;
+    for (const child of node.children ?? []) {
+        const childStats = sumTreeSize(child);
+        size += childStats.size;
+        fileCount += childStats.fileCount;
+    }
+    return { size, fileCount };
+}
+//# sourceMappingURL=storage-tree.js.map

package/dist/utils/storage-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-tree.js","sourceRoot":"","sources":["../../src/utils/storage-tree.ts"],"names":[],"mappings":"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"}

package/dist/utils/upload-signature.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Signature utility for presigned client-side uploads.
+ * Mirrors utils/signature.ts (used for /authenticated delivery URLs) but the
+ * signed payload includes an expiry, since presigned uploads are meant to be
+ * handed to a browser and should stop working after a short window.
+ */
+export declare const UPLOAD_SIGNATURE_LENGTH = 16;
+/**
+ * Generates a cryptographically secure signature for a presigned upload.
+ * @param folder - The destination folder the upload is scoped to (empty string for root)
+ * @param expires - Unix timestamp (seconds) after which the signature is no longer valid
+ * @param secret - The API secret key
+ * @returns The signature (first UPLOAD_SIGNATURE_LENGTH characters of HMAC-SHA256)
+ */
+export declare function generateUploadSignature(folder: string, expires: number, secret: string): string;
+/**
+ * Verifies a presigned upload signature using timing-safe comparison.
+ * @param providedSignature - The signature submitted with the upload
+ * @param folder - The destination folder submitted with the upload
+ * @param expires - The expiry timestamp submitted with the upload
+ * @param secret - The API secret key
+ * @returns True if the signature is valid, false otherwise
+ */
+export declare function verifyUploadSignature(providedSignature: string, folder: string, expires: number, secret: string): boolean;
+//# sourceMappingURL=upload-signature.d.ts.map

package/dist/utils/upload-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-signature.d.ts","sourceRoot":"","sources":["../../src/utils/upload-signature.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CA2BT"}

package/dist/utils/upload-signature.js

@@ -0,0 +1,56 @@
+import crypto from 'crypto';
+/**
+ * Signature utility for presigned client-side uploads.
+ * Mirrors utils/signature.ts (used for /authenticated delivery URLs) but the
+ * signed payload includes an expiry, since presigned uploads are meant to be
+ * handed to a browser and should stop working after a short window.
+ */
+export const UPLOAD_SIGNATURE_LENGTH = 16; // 64 bits of entropy
+/**
+ * Generates a cryptographically secure signature for a presigned upload.
+ * @param folder - The destination folder the upload is scoped to (empty string for root)
+ * @param expires - Unix timestamp (seconds) after which the signature is no longer valid
+ * @param secret - The API secret key
+ * @returns The signature (first UPLOAD_SIGNATURE_LENGTH characters of HMAC-SHA256)
+ */
+export function generateUploadSignature(folder, expires, secret) {
+    if (!secret) {
+        throw new Error('API_SECRET is required for signature generation');
+    }
+    const stringToSign = `${folder}:${expires}`;
+    const hmac = crypto.createHmac('sha256', secret);
+    hmac.update(stringToSign);
+    return hmac.digest('hex').substring(0, UPLOAD_SIGNATURE_LENGTH);
+}
+/**
+ * Verifies a presigned upload signature using timing-safe comparison.
+ * @param providedSignature - The signature submitted with the upload
+ * @param folder - The destination folder submitted with the upload
+ * @param expires - The expiry timestamp submitted with the upload
+ * @param secret - The API secret key
+ * @returns True if the signature is valid, false otherwise
+ */
+export function verifyUploadSignature(providedSignature, folder, expires, secret) {
+    if (!secret || !providedSignature) {
+        return false;
+    }
+    if (providedSignature.length !== UPLOAD_SIGNATURE_LENGTH) {
+        return false;
+    }
+    if (!Number.isFinite(expires)) {
+        return false;
+    }
+    try {
+        const expectedSignature = generateUploadSignature(folder, expires, secret);
+        const providedBuffer = Buffer.from(providedSignature, 'utf8');
+        const expectedBuffer = Buffer.from(expectedSignature, 'utf8');
+        if (providedBuffer.length !== expectedBuffer.length) {
+            return false;
+        }
+        return crypto.timingSafeEqual(providedBuffer, expectedBuffer);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=upload-signature.js.map

package/dist/utils/upload-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-signature.js","sourceRoot":"","sources":["../../src/utils/upload-signature.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC,CAAC,qBAAqB;AAEhE;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,OAAe,EACf,MAAc;IAEd,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,YAAY,GAAG,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAE5C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,iBAAyB,EACzB,MAAc,EACd,OAAe,EACf,MAAc;IAEd,IAAI,CAAC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,KAAK,uBAAuB,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE3E,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAE9D,IAAI,cAAc,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,MAAM,CAAC,eAAe,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/video/auto-downscale.d.ts

@@ -0,0 +1,12 @@
+import type { TransformFunction } from './types';
+/**
+ * Automatically downscale videos larger than 720p to reduce processing load
+ * This prevents high-resolution videos (4K, 5K, 8K) from overwhelming the system
+ * Only applies if no explicit resize parameters are provided
+ *
+ * Uses 720p instead of 1080p for faster processing of very large videos (8K, 5K)
+ * - 8K (7680x4320) -> 720p = 98% pixel reduction (vs 94% to 1080p)
+ * - Processing time reduced by ~50% compared to 1080p output
+ */
+export declare const applyAutoDownscale: TransformFunction;
+//# sourceMappingURL=auto-downscale.d.ts.map

package/dist/utils/video/auto-downscale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-downscale.d.ts","sourceRoot":"","sources":["../../../src/utils/video/auto-downscale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAyBhC,CAAC"}

package/dist/utils/video/auto-downscale.js

@@ -0,0 +1,29 @@
+/**
+ * Automatically downscale videos larger than 720p to reduce processing load
+ * This prevents high-resolution videos (4K, 5K, 8K) from overwhelming the system
+ * Only applies if no explicit resize parameters are provided
+ *
+ * Uses 720p instead of 1080p for faster processing of very large videos (8K, 5K)
+ * - 8K (7680x4320) -> 720p = 98% pixel reduction (vs 94% to 1080p)
+ * - Processing time reduced by ~50% compared to 1080p output
+ */
+export const applyAutoDownscale = (command, context) => {
+    // Skip for thumbnail extraction
+    if (context.isThumbnail) {
+        return command;
+    }
+    const { resize, width, height } = context.params;
+    // Skip if user has explicitly specified dimensions
+    if (resize || width !== undefined || height !== undefined) {
+        return command;
+    }
+    // Auto-downscale to 720p max to reduce CPU/memory usage
+    // Using 720p instead of 1080p significantly speeds up processing of 8K/5K videos
+    // scale="min(1280\,iw):min(720\,ih)" means:
+    // - Width: minimum of 1280 or original width
+    // - Height: minimum of 720 or original height
+    // - Force even dimensions (required for h264 encoding)
+    const filter = "scale='min(1280,iw)':'min(720,ih)':force_original_aspect_ratio=decrease,scale=trunc(iw/2)*2:trunc(ih/2)*2";
+    return command.videoFilters(filter);
+};
+//# sourceMappingURL=auto-downscale.js.map

package/dist/utils/video/auto-downscale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-downscale.js","sourceRoot":"","sources":["../../../src/utils/video/auto-downscale.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CACnD,OAAO,EACP,OAAO,EACP,EAAE;IACF,gCAAgC;IAChC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,mDAAmD;IACnD,IAAI,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,wDAAwD;IACxD,iFAAiF;IACjF,4CAA4C;IAC5C,6CAA6C;IAC7C,8CAA8C;IAC9C,uDAAuD;IACvD,MAAM,MAAM,GAAG,2GAA2G,CAAC;IAE3H,OAAO,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC,CAAC"}

package/dist/utils/video/command-builder.d.ts

@@ -0,0 +1,22 @@
+import type { VideoContext, TransformFunction } from './types';
+/**
+ * Builder class for constructing and executing ffmpeg commands
+ * Provides a fluent interface for applying multiple transformations
+ */
+export declare class VideoCommandBuilder {
+    private command;
+    private context;
+    constructor(context: VideoContext);
+    /**
+     * Apply one or more transformation functions to the ffmpeg command
+     * Returns this for method chaining
+     */
+    apply(...transforms: TransformFunction[]): this;
+    /**
+     * Execute the ffmpeg command and return the output buffer
+     * Handles cleanup of temporary files
+     * Includes a 5-minute timeout to handle large videos (4K, 8K)
+     */
+    execute(): Promise<Buffer>;
+}
+//# sourceMappingURL=command-builder.d.ts.map

package/dist/utils/video/command-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-builder.d.ts","sourceRoot":"","sources":["../../../src/utils/video/command-builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG/D;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IAmBjC;;;OAGG;IACH,KAAK,CAAC,GAAG,UAAU,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAO/C;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAqCjC"}

package/dist/utils/video/command-builder.js

@@ -0,0 +1,79 @@
+import ffmpeg from 'fluent-ffmpeg';
+import { readFile, unlink, rmdir } from 'fs/promises';
+import { FFMPEG_THREADS, FFMPEG_NICENESS } from './config.js';
+/**
+ * Builder class for constructing and executing ffmpeg commands
+ * Provides a fluent interface for applying multiple transformations
+ */
+export class VideoCommandBuilder {
+    command;
+    context;
+    constructor(context) {
+        this.context = context;
+        // niceness lowers ffmpeg's scheduling priority so encoding never starves
+        // the HTTP event loop; threads are capped to the container's effective
+        // CPUs (leaving one for serving) instead of a hardcoded value
+        this.command = ffmpeg(context.inputPath, { niceness: FFMPEG_NICENESS })
+            .output(context.outputPath)
+            .addOption('-threads', String(FFMPEG_THREADS));
+        // -movflags and -max_muxing_queue_size are MOV/MP4 container options and are
+        // incompatible with image output formats (image2 muxer used for thumbnails).
+        // Only apply them for video output.
+        if (!context.isImageOutput) {
+            this.command = this.command
+                .addOption('-movflags', '+faststart') // Optimize for web streaming
+                .addOption('-max_muxing_queue_size', '1024'); // Prevent buffer issues
+        }
+    }
+    /**
+     * Apply one or more transformation functions to the ffmpeg command
+     * Returns this for method chaining
+     */
+    apply(...transforms) {
+        for (const transform of transforms) {
+            this.command = transform(this.command, this.context);
+        }
+        return this;
+    }
+    /**
+     * Execute the ffmpeg command and return the output buffer
+     * Handles cleanup of temporary files
+     * Includes a 5-minute timeout to handle large videos (4K, 8K)
+     */
+    async execute() {
+        const TIMEOUT_MS = 300000; // 5 minutes (increased for 8K videos)
+        return new Promise((resolve, reject) => {
+            // Set timeout to kill ffmpeg if it takes too long
+            const timeoutId = setTimeout(() => {
+                this.command.kill('SIGKILL');
+                reject(new Error('Video processing timeout: exceeded 5 minutes. Try reducing video resolution or duration.'));
+            }, TIMEOUT_MS);
+            this.command
+                .on('end', async () => {
+                clearTimeout(timeoutId);
+                try {
+                    // Read the output file
+                    const buffer = await readFile(this.context.outputPath);
+                    // Cleanup: remove output file and temp directory
+                    await unlink(this.context.outputPath);
+                    try {
+                        await rmdir(this.context.tmpDir);
+                    }
+                    catch {
+                        // Ignore if directory is not empty or already removed
+                    }
+                    resolve(buffer);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            })
+                .on('error', (error) => {
+                clearTimeout(timeoutId);
+                reject(new Error(`Video processing failed: ${error.message}`));
+            })
+                .run();
+        });
+    }
+}
+//# sourceMappingURL=command-builder.js.map

package/dist/utils/video/command-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-builder.js","sourceRoot":"","sources":["../../../src/utils/video/command-builder.ts"],"names":[],"mappings":"AAAA,OAAO,MAAyB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3D;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACtB,OAAO,CAAgB;IACvB,OAAO,CAAe;IAE9B,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,yEAAyE;QACzE,uEAAuE;QACvE,8DAA8D;QAC9D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;aACpE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;aAC1B,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QAEjD,6EAA6E;QAC7E,6EAA6E;QAC7E,oCAAoC;QACpC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;iBACxB,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,6BAA6B;iBAClE,SAAS,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC,CAAC,wBAAwB;QAC1E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,UAA+B;QACtC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,sCAAsC;QAEjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,kDAAkD;YAClD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC,CAAC;YAChH,CAAC,EAAE,UAAU,CAAC,CAAC;YAEf,IAAI,CAAC,OAAO;iBACT,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;gBACpB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,CAAC;oBACH,uBAAuB;oBACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAEvD,iDAAiD;oBACjD,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACtC,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBACnC,CAAC;oBAAC,MAAM,CAAC;wBACP,sDAAsD;oBACxD,CAAC;oBAED,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC;iBACD,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACrB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC;iBACD,GAAG,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,51 @@
+/**
+ * Video processing queue configuration
+ * These values can be overridden via environment variables
+ */
+/**
+ * Effective CPU count (host CPUs or cgroup quota, whichever is lower)
+ */
+export declare const EFFECTIVE_CPU_COUNT: number;
+/**
+ * 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 declare const FFMPEG_THREADS: number;
+/**
+ * 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 declare const FFMPEG_NICENESS: number;
+/**
+ * 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 declare const MAX_CONCURRENT_JOBS: number;
+/**
+ * Maximum number of retry attempts for failed jobs
+ */
+export declare const JOB_RETRY_MAX: number;
+/**
+ * Hours after which completed/error jobs are cleaned up
+ */
+export declare const JOB_CLEANUP_HOURS: number;
+/**
+ * Worker polling interval in milliseconds
+ */
+export declare const WORKER_POLL_INTERVAL_MS: number;
+/**
+ * Priority for thumbnail extraction jobs (lower = higher priority)
+ */
+export declare const THUMBNAIL_PRIORITY = 1;
+/**
+ * Priority for video transformation jobs
+ */
+export declare const TRANSFORMATION_PRIORITY = 2;
+/**
+ * Priority for other video jobs
+ */
+export declare const LOW_PRIORITY = 3;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/video/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqHH;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAoB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAEW,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAEtB,CAAC;AAEP;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAEqC,CAAC;AAOtE;;GAEG;AACH,eAAO,MAAM,aAAa,QAGzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAG7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAGnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,YAAY,IAAI,CAAC"}