@openinary/core 1.1.0

package/dist/utils/video/param-registry.js

@@ -0,0 +1,201 @@
+import { applyResize } from './resize.js';
+import { applyQuality } from './quality.js';
+import { applyTrimming } from './trim.js';
+import { applyThumbnailExtraction } from './thumbnail.js';
+/**
+ * Complete parameter registry for video transformations
+ * Single source of truth for all video transformation parameters
+ */
+export const VIDEO_PARAMS = [
+    {
+        param: 't',
+        name: 'Thumbnail',
+        description: 'Extracts a single frame as an image thumbnail. When enabled, the output will be an image format (jpg, png, webp, etc.) instead of a video.',
+        example: 't_true',
+        defaultValue: false,
+        validValues: ['true', 'false', '1', '0'],
+        processor: (command, _value, context) => {
+            return applyThumbnailExtraction(command, context);
+        },
+        priority: 1, // Thumbnail extraction should happen first
+    },
+    {
+        param: 'tt',
+        name: 'Thumbnail Time',
+        description: 'Specifies the time (in seconds) from which to extract the thumbnail. Works in conjunction with the thumbnail parameter.',
+        example: 'tt_5.5',
+        defaultValue: 0,
+        validValues: ['any positive number (seconds)'],
+        aliases: ['thumbnail_time'],
+        dependencies: ['t'],
+        processor: (command, _value, context) => {
+            // Thumbnail time is used by thumbnail extraction
+            return command;
+        },
+        priority: 0, // Config parameter
+    },
+    {
+        param: 'so',
+        name: 'Start Offset',
+        description: 'Trims the video by starting from the specified time in seconds. Can be used alone or with end offset.',
+        example: 'so_10',
+        validValues: ['any positive number (seconds)'],
+        aliases: ['start_offset', 'start'],
+        processor: (command, _value, context) => {
+            return applyTrimming(command, context);
+        },
+        priority: 2, // Trimming before resize
+    },
+    {
+        param: 'eo',
+        name: 'End Offset',
+        description: 'Trims the video by ending at the specified time in seconds. If used with start offset, creates a segment between the two times.',
+        example: 'eo_30',
+        validValues: ['any positive number (seconds)'],
+        aliases: ['end_offset', 'end'],
+        processor: (command, _value, context) => {
+            // End offset is processed together with start offset in trim
+            return command;
+        },
+        priority: 2, // Trimming before resize
+    },
+    {
+        param: 'w',
+        name: 'Width',
+        description: 'Sets the width of the video in pixels. Should be used with height for proper scaling.',
+        example: 'w_1280',
+        validValues: ['any positive integer'],
+        processor: (command, _value, context) => {
+            // Width is processed together with height in the resize step
+            return command;
+        },
+        priority: 3, // Resize operations
+    },
+    {
+        param: 'h',
+        name: 'Height',
+        description: 'Sets the height of the video in pixels. Should be used with width for proper scaling.',
+        example: 'h_720',
+        validValues: ['any positive integer'],
+        processor: (command, _value, context) => {
+            // Height is processed together with width in the resize step
+            return command;
+        },
+        priority: 3, // Resize operations
+    },
+    {
+        param: 'r',
+        name: 'Resize',
+        description: 'Specifies dimensions in WxH format (e.g., 1280x720). Alternative to using separate width and height parameters.',
+        example: 'r_1920x1080',
+        validValues: ['WxH format (e.g., 1920x1080)'],
+        aliases: ['resize', 'size'],
+        processor: (command, _value, context) => {
+            return applyResize(command, context);
+        },
+        priority: 3, // Resize operations
+    },
+    {
+        param: 'c',
+        name: 'Crop Mode',
+        description: 'Defines how the video should be resized. Options: fill/crop (cover entire area with cropping, no stretching), fit (fit within dimensions maintaining aspect ratio), scale (exact dimensions, may stretch), pad (fit within dimensions and pad with background).',
+        example: 'c_fill',
+        defaultValue: 'fill',
+        validValues: ['fill', 'fit', 'scale', 'crop', 'pad'],
+        aliases: ['crop_mode'],
+        dependencies: ['w', 'h'],
+        processor: (command, _value, context) => {
+            // Crop mode is applied together with width/height in applyResize
+            return command;
+        },
+        priority: 3, // Resize operations
+    },
+    {
+        param: 'g',
+        name: 'Gravity',
+        description: 'Defines the focal point when cropping (future support). Options: center (center), north (top), south (bottom), east (right), west (left), auto (entropy-based).',
+        example: 'g_center',
+        defaultValue: 'center',
+        validValues: ['center', 'north', 'south', 'east', 'west', 'auto'],
+        aliases: ['gravity'],
+        processor: (command, _value, context) => {
+            // Gravity will be used by resize operations (not yet fully implemented)
+            return command;
+        },
+        priority: 0, // Config parameter
+    },
+    {
+        param: 'q',
+        name: 'Quality',
+        description: 'Sets the quality of the output video (0-100). Uses CRF (Constant Rate Factor) encoding. Higher values produce better quality and larger files. Quality 100 ≈ CRF 18, Quality 50 ≈ CRF 28.',
+        example: 'q_80',
+        defaultValue: undefined,
+        validValues: ['0-100'],
+        processor: (command, _value, context) => {
+            return applyQuality(command, context);
+        },
+        priority: 4, // Quality after transformations
+    },
+    {
+        param: 'f',
+        name: 'Format',
+        description: 'Specifies the output format. Video formats: mp4, mov, webm. Image formats (for thumbnails): jpg, jpeg, png, webp, avif, gif. If not specified, defaults to mp4 for videos or jpg for thumbnails.',
+        example: 'f_webm',
+        defaultValue: 'mp4',
+        validValues: ['mp4', 'mov', 'webm', 'jpg', 'jpeg', 'png', 'webp', 'avif', 'gif'],
+        aliases: ['format'],
+        processor: (command, _value, context) => {
+            // Format is handled by the determineOutputFormat function
+            return command;
+        },
+        priority: 5, // Format conversion last
+    },
+];
+/**
+ * Helper function to apply resize with all related parameters
+ * This is a composite operation that uses w, h, r, c, and g parameters
+ */
+export const applyResizeComposite = (command, context) => {
+    const { resize, width, height } = context.params;
+    if (!width && !height && !resize) {
+        return command;
+    }
+    return applyResize(command, context);
+};
+/**
+ * Get parameter definition by param key
+ */
+export const getVideoParamDefinition = (param) => {
+    return VIDEO_PARAMS.find(p => p.param === param || p.aliases?.includes(param));
+};
+/**
+ * Get all parameter definitions sorted by priority
+ */
+export const getVideoParamsByPriority = () => {
+    return [...VIDEO_PARAMS].sort((a, b) => a.priority - b.priority);
+};
+/**
+ * Get default value for a parameter
+ */
+export const getVideoParamDefault = (param) => {
+    const def = getVideoParamDefinition(param);
+    return def?.defaultValue;
+};
+/**
+ * Validate if a parameter value is valid
+ */
+export const isValidVideoParamValue = (param, value) => {
+    const def = getVideoParamDefinition(param);
+    if (!def)
+        return false;
+    // If no validValues specified, assume any value is valid
+    if (!def.validValues || def.validValues.length === 0)
+        return true;
+    // Check if value matches any valid value or pattern
+    return def.validValues.some(valid => {
+        if (valid.includes('any'))
+            return true; // Pattern like "any positive integer"
+        return value === valid || value.startsWith(valid);
+    });
+};
+//# sourceMappingURL=param-registry.js.map

package/dist/utils/video/param-registry.js.map

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

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

@@ -0,0 +1,12 @@
+import type { TransformFunction } from './types';
+/**
+ * Apply quality settings to a video using CRF (Constant Rate Factor)
+ * CRF range: 0 (lossless) to 51 (lowest quality)
+ *
+ * Quality mapping:
+ * - quality 100 → CRF 18 (very high quality)
+ * - quality 50 → CRF 28 (medium quality)
+ * - quality 10 → CRF 45 (low quality)
+ */
+export declare const applyQuality: TransformFunction;
+//# sourceMappingURL=quality.d.ts.map

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

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

package/dist/utils/video/quality.js

@@ -0,0 +1,45 @@
+/**
+ * Apply quality settings to a video using CRF (Constant Rate Factor)
+ * CRF range: 0 (lossless) to 51 (lowest quality)
+ *
+ * Quality mapping:
+ * - quality 100 → CRF 18 (very high quality)
+ * - quality 50 → CRF 28 (medium quality)
+ * - quality 10 → CRF 45 (low quality)
+ */
+export const applyQuality = (command, context) => {
+    // Skip quality settings for thumbnail extraction
+    if (context.isThumbnail) {
+        return command;
+    }
+    const { quality } = context.params;
+    // Default quality if not specified: 60 (CRF 31 - faster encoding for 8K)
+    // This prevents ffmpeg from re-encoding without compression
+    // Lower quality = faster encoding, especially important for 8K videos
+    const defaultQuality = 60;
+    const qualityValue = quality !== undefined
+        ? (typeof quality === 'string' ? parseInt(quality, 10) : quality)
+        : defaultQuality;
+    // Validate quality range (0-100)
+    if (isNaN(qualityValue) || qualityValue < 0 || qualityValue > 100) {
+        // Use default if invalid
+        const crf = Math.round(51 - (defaultQuality / 100) * 33);
+        return command
+            .videoCodec('libx264')
+            .addOption('-preset', 'ultrafast') // Ultra fast preset for local dev
+            .addOption('-crf', crf.toString())
+            .audioCodec('copy'); // Copy audio without re-encoding
+    }
+    // Convert quality (0-100) to CRF (51-0)
+    // Higher quality = lower CRF
+    const crf = Math.round(51 - (qualityValue / 100) * 33);
+    return command
+        .videoCodec('libx264')
+        .addOption('-preset', 'ultrafast')
+        .addOption('-crf', crf.toString())
+        .addOption('-tune', 'fastdecode') // Optimize for fast decoding
+        .addOption('-profile:v', 'baseline') // Use baseline profile for compatibility & speed
+        .addOption('-level', '3.0') // Lower level = simpler encoding
+        .audioCodec('copy'); // Copy audio without re-encoding
+};
+//# sourceMappingURL=quality.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../../src/utils/video/quality.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsB,CAC7C,OAAO,EACP,OAAO,EACP,EAAE;IACF,iDAAiD;IACjD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEnC,yEAAyE;IACzE,4DAA4D;IAC5D,sEAAsE;IACtE,MAAM,cAAc,GAAG,EAAE,CAAC;IAC1B,MAAM,YAAY,GAAG,OAAO,KAAK,SAAS;QACxC,CAAC,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,CAAC,CAAC,cAAc,CAAC;IAEnB,iCAAiC;IACjC,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,GAAG,EAAE,CAAC;QAClE,yBAAyB;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,OAAO,OAAO;aACX,UAAU,CAAC,SAAS,CAAC;aACrB,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAE,kCAAkC;aACrE,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;aACjC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAE,iCAAiC;IAC3D,CAAC;IAED,wCAAwC;IACxC,6BAA6B;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAEvD,OAAO,OAAO;SACX,UAAU,CAAC,SAAS,CAAC;SACrB,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;SACjC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;SACjC,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,CAAI,6BAA6B;SACjE,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,iDAAiD;SACrF,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAU,iCAAiC;SACrE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAE,iCAAiC;AAC3D,CAAC,CAAC"}

package/dist/utils/video/queue-store.d.ts

@@ -0,0 +1,51 @@
+import type { parseParams } from "../parser";
+export type JobStatus = "pending" | "processing" | "completed" | "error" | "cancelled";
+export interface VideoJob {
+    id: string;
+    file_path: string;
+    params_json: string;
+    cache_path: string;
+    status: JobStatus;
+    priority: number;
+    progress: number;
+    error: string | null;
+    retry_count: number;
+    max_retries: number;
+    created_at: number;
+    started_at: number | null;
+    completed_at: number | null;
+}
+export interface JobStats {
+    total: number;
+    pending: number;
+    processing: number;
+    completed: number;
+    error: number;
+}
+/**
+ * Persistence contract for the video transformation queue. The self-hosted
+ * app backs this with SQLite (see sqlite-video-job-store.ts); a multi-tenant
+ * deployment can implement the same contract against a different backend
+ * (e.g. Cloudflare D1) without touching VideoJobQueue, VideoWorker, or any
+ * route that depends on this interface instead of a concrete database.
+ */
+export interface VideoJobStore {
+    createJob(filePath: string, params: ReturnType<typeof parseParams>, cachePath: string, priority?: number): string;
+    /** Atomically claims and returns the next pending job, or null if none. */
+    getNextPendingJob(): VideoJob | null;
+    updateJobStatus(jobId: string, status: JobStatus, progress?: number, error?: string): void;
+    getJobByFileAndParams(filePath: string, params: ReturnType<typeof parseParams>): VideoJob | null;
+    getJobById(jobId: string): VideoJob | null;
+    getJobStats(): JobStats;
+    getRecentJobs(limit?: number, offset?: number): VideoJob[];
+    getJobsByStatus(status: JobStatus, limit?: number): VideoJob[];
+    countProcessingJobs(): number;
+    cleanupOldJobs(olderThanHours?: number): number;
+    retryFailedJob(jobId: string): boolean;
+    cancelJob(jobId: string): boolean;
+    deleteJob(jobId: string): boolean;
+    /** Resets jobs orphaned by a crash/restart (stuck in "processing") back to "pending". */
+    resetOrphanedProcessingJobs(): number;
+    deleteJobsByFilePath(filePath: string): number;
+}
+//# sourceMappingURL=queue-store.d.ts.map

package/dist/utils/video/queue-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-store.d.ts","sourceRoot":"","sources":["../../../src/utils/video/queue-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC;IAEV,2EAA2E;IAC3E,iBAAiB,IAAI,QAAQ,GAAG,IAAI,CAAC;IAErC,eAAe,CACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAAC;IAER,qBAAqB,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GACrC,QAAQ,GAAG,IAAI,CAAC;IAEnB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE3C,WAAW,IAAI,QAAQ,CAAC;IAExB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE3D,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAE/D,mBAAmB,IAAI,MAAM,CAAC;IAE9B,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC,yFAAyF;IACzF,2BAA2B,IAAI,MAAM,CAAC;IAEtC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAChD"}

package/dist/utils/video/queue-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-store.js.map

package/dist/utils/video/queue-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-store.js","sourceRoot":"","sources":["../../../src/utils/video/queue-store.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,7 @@
+import type { TransformFunction } from './types';
+/**
+ * Apply resize transformation to a video
+ * Supports multiple crop modes: fill, crop, fit, scale, pad
+ */
+export declare const applyResize: TransformFunction;
+//# sourceMappingURL=resize.d.ts.map

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

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

package/dist/utils/video/resize.js

@@ -0,0 +1,40 @@
+/**
+ * Apply resize transformation to a video
+ * Supports multiple crop modes: fill, crop, fit, scale, pad
+ */
+export const applyResize = (command, context) => {
+    const { resize, width, height, crop } = context.params;
+    let w;
+    let h;
+    // Parse dimensions from resize parameter
+    if (resize) {
+        const [wStr, hStr] = resize.split('x');
+        w = wStr ? parseInt(wStr, 10) : undefined;
+        h = hStr ? parseInt(hStr, 10) : undefined;
+    }
+    // Individual width/height parameters take precedence
+    if (width !== undefined) {
+        w = typeof width === 'string' ? parseInt(width, 10) : width;
+    }
+    if (height !== undefined) {
+        h = typeof height === 'string' ? parseInt(height, 10) : height;
+    }
+    // Skip if no valid dimensions
+    if (!w || !h || isNaN(w) || isNaN(h) || w <= 0 || h <= 0) {
+        return command;
+    }
+    // Apply resize based on crop mode
+    if (crop === 'fill' || crop === 'crop') {
+        // Cover behavior (no stretching):
+        // 1) scale until the smallest side reaches the target, preserving aspect ratio
+        // 2) crop to exact WxH from the center
+        const filter = `scale=${w}:${h}:force_original_aspect_ratio=increase,crop=${w}:${h}`;
+        return command.videoFilters(filter);
+    }
+    else {
+        // Backwards-compatible behavior: simple resize to exact dimensions,
+        // which may stretch to fit
+        return command.size(`${w}x${h}`);
+    }
+};
+//# sourceMappingURL=resize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../../src/utils/video/resize.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB,CAC5C,OAAO,EACP,OAAO,EACP,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEvD,IAAI,CAAqB,CAAC;IAC1B,IAAI,CAAqB,CAAC;IAE1B,yCAAyC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1C,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IAED,qDAAqD;IACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,CAAC,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjE,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,kCAAkC;QAClC,+EAA+E;QAC/E,uCAAuC;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,8CAA8C,CAAC,IAAI,CAAC,EAAE,CAAC;QACrF,OAAO,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,oEAAoE;QACpE,2BAA2B;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/video/sqlite-video-job-store.d.ts

@@ -0,0 +1,29 @@
+import type Database from "better-sqlite3";
+import type { parseParams } from "../parser";
+import type { VideoJob, JobStats, JobStatus, VideoJobStore } from "./queue-store";
+/**
+ * SQLite-backed VideoJobStore, used by the self-hosted app. Takes the
+ * database instance as a constructor argument rather than importing a
+ * global, so callers control which database (and which schema/migrations)
+ * it operates against.
+ */
+export declare class SqliteVideoJobStore implements VideoJobStore {
+    private db;
+    constructor(db: Database.Database);
+    createJob(filePath: string, params: ReturnType<typeof parseParams>, cachePath: string, priority?: number): string;
+    getNextPendingJob(): VideoJob | null;
+    updateJobStatus(jobId: string, status: JobStatus, progress?: number, error?: string): void;
+    getJobByFileAndParams(filePath: string, params: ReturnType<typeof parseParams>): VideoJob | null;
+    getJobById(jobId: string): VideoJob | null;
+    getJobStats(): JobStats;
+    getRecentJobs(limit?: number, offset?: number): VideoJob[];
+    getJobsByStatus(status: JobStatus, limit?: number): VideoJob[];
+    countProcessingJobs(): number;
+    cleanupOldJobs(olderThanHours?: number): number;
+    retryFailedJob(jobId: string): boolean;
+    cancelJob(jobId: string): boolean;
+    deleteJob(jobId: string): boolean;
+    resetOrphanedProcessingJobs(): number;
+    deleteJobsByFilePath(filePath: string): number;
+}
+//# sourceMappingURL=sqlite-video-job-store.d.ts.map

package/dist/utils/video/sqlite-video-job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-video-job-store.d.ts","sourceRoot":"","sources":["../../../src/utils/video/sqlite-video-job-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACd,MAAM,eAAe,CAAC;AAqBvB;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,GACnB,MAAM;IA2DT,iBAAiB,IAAI,QAAQ,GAAG,IAAI;IA6CpC,eAAe,CACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAuCP,qBAAqB,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GACrC,QAAQ,GAAG,IAAI;IAmBlB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAgB1C,WAAW,IAAI,QAAQ;IAqBvB,aAAa,CAAC,KAAK,GAAE,MAAW,EAAE,MAAM,GAAE,MAAU,GAAG,QAAQ,EAAE;IAgBjE,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAgBlE,mBAAmB,IAAI,MAAM;IAkB7B,cAAc,CAAC,cAAc,GAAE,MAAW,GAAG,MAAM;IA6BnD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAmDtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAkCjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAsBjC,2BAA2B,IAAI,MAAM;IA2BrC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAwB/C"}