@uploadbox/video 0.4.0

package/dist/ffutils.d.ts

@@ -0,0 +1,39 @@
+/** Subset of ffprobe JSON output we use. */
+export interface FfprobeStream {
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    r_frame_rate?: string;
+    duration?: string;
+    bit_rate?: string;
+    sample_rate?: string;
+    channels?: number;
+}
+export interface FfprobeFormat {
+    duration?: string;
+    bit_rate?: string;
+}
+export interface FfprobeData {
+    streams: FfprobeStream[];
+    format: FfprobeFormat;
+}
+export interface FfprobeOptions {
+    /** Path to the ffprobe binary. @default "ffprobe" */
+    ffprobePath?: string;
+}
+/**
+ * Run ffprobe on a file path or readable stream and return parsed JSON output.
+ */
+export declare function ffprobe(input: string | NodeJS.ReadableStream, opts?: FfprobeOptions): Promise<FfprobeData>;
+export interface RunFFmpegOptions {
+    /** Path to the ffmpeg binary. @default "ffmpeg" */
+    ffmpegPath?: string;
+    /** Signal to abort the process. */
+    signal?: AbortSignal;
+}
+/**
+ * Run ffmpeg with the given argument list. Resolves on exit code 0, rejects otherwise.
+ */
+export declare function runFFmpeg(args: string[], opts?: RunFFmpegOptions): Promise<void>;
+//# sourceMappingURL=ffutils.d.ts.map

package/dist/ffutils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffutils.d.ts","sourceRoot":"","sources":["../src/ffutils.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACrC,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,WAAW,CAAC,CA2CtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoChF"}

package/dist/ffutils.js

@@ -0,0 +1,82 @@
+import { execFile, spawn } from "node:child_process";
+/**
+ * Run ffprobe on a file path or readable stream and return parsed JSON output.
+ */
+export function ffprobe(input, opts) {
+    const bin = opts?.ffprobePath ?? "ffprobe";
+    const baseArgs = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams"];
+    if (typeof input === "string") {
+        return new Promise((resolve, reject) => {
+            execFile(bin, [...baseArgs, input], { maxBuffer: 10 * 1024 * 1024 }, (err, stdout) => {
+                if (err)
+                    return reject(new Error(`ffprobe failed: ${err.message}`));
+                try {
+                    resolve(JSON.parse(stdout));
+                }
+                catch {
+                    reject(new Error("ffprobe returned invalid JSON"));
+                }
+            });
+        });
+    }
+    // Readable stream → pipe to stdin
+    return new Promise((resolve, reject) => {
+        const proc = spawn(bin, [...baseArgs, "-i", "pipe:0"], {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (d) => (stdout += d.toString()));
+        proc.stderr.on("data", (d) => (stderr += d.toString()));
+        proc.on("error", (err) => reject(new Error(`ffprobe failed: ${err.message}`)));
+        proc.on("close", (code) => {
+            if (code !== 0)
+                return reject(new Error(`ffprobe exited with code ${code}: ${stderr}`));
+            try {
+                resolve(JSON.parse(stdout));
+            }
+            catch {
+                reject(new Error("ffprobe returned invalid JSON"));
+            }
+        });
+        input.pipe(proc.stdin);
+        proc.stdin.on("error", () => {
+            // ignore EPIPE — ffprobe may close stdin early
+        });
+    });
+}
+/**
+ * Run ffmpeg with the given argument list. Resolves on exit code 0, rejects otherwise.
+ */
+export function runFFmpeg(args, opts) {
+    const bin = opts?.ffmpegPath ?? "ffmpeg";
+    return new Promise((resolve, reject) => {
+        const proc = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stderr = "";
+        proc.stderr.on("data", (d) => (stderr += d.toString()));
+        const onAbort = () => {
+            proc.kill("SIGKILL");
+        };
+        if (opts?.signal) {
+            if (opts.signal.aborted) {
+                proc.kill("SIGKILL");
+                return reject(new Error("Cancelled"));
+            }
+            opts.signal.addEventListener("abort", onAbort, { once: true });
+        }
+        proc.on("error", (err) => {
+            opts?.signal?.removeEventListener("abort", onAbort);
+            reject(new Error(`ffmpeg failed: ${err.message}`));
+        });
+        proc.on("close", (code) => {
+            opts?.signal?.removeEventListener("abort", onAbort);
+            if (code !== 0) {
+                // Extract last meaningful line from stderr for error message
+                const lastLine = stderr.trim().split("\n").pop() ?? "";
+                return reject(new Error(`ffmpeg exited with code ${code}: ${lastLine}`));
+            }
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=ffutils.js.map

package/dist/ffutils.js.map

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

package/dist/hooks/video-processing.d.ts

@@ -0,0 +1,47 @@
+import type { ProcessingHook } from "@uploadbox/core";
+import type { TranscodingProvider } from "../provider.js";
+import type { QualityPreset } from "../types.js";
+interface VideoProcessingHookOptions {
+    /** Quality presets to generate. Defaults to all QUALITY_PRESETS. */
+    qualities?: QualityPreset[];
+    /** HLS segment duration in seconds. @default 6 */
+    segmentDuration?: number;
+    /** Whether to generate a poster thumbnail. @default true */
+    generateThumbnail?: boolean;
+    /** Whether to generate a sprite sheet with WebVTT. @default true */
+    generateSpriteSheet?: boolean;
+    /** Timeout in milliseconds. @default 1800000 (30 minutes) */
+    timeoutMs?: number;
+    /**
+     * Function to determine the S3 output prefix for HLS content.
+     * Receives the file key and should return the prefix path.
+     * @default Derives from file key: `video/{fileKey}/`
+     */
+    getOutputPrefix?: (fileKey: string) => string;
+}
+/**
+ * Creates a processing hook that triggers video transcoding after upload.
+ *
+ * Implements the `@uploadbox/core` `ProcessingHook` interface. Only runs
+ * for files with a `video/*` MIME type.
+ *
+ * @param provider - The transcoding provider to use (FFmpeg, Lambda, External).
+ * @param options - Transcoding options.
+ *
+ * @example
+ * ```ts
+ * import { createVideoProcessingHook } from "@uploadbox/video/hooks/video-processing";
+ * import { createFFmpegProvider } from "@uploadbox/video/providers/ffmpeg";
+ *
+ * const provider = createFFmpegProvider();
+ * const videoHook = createVideoProcessingHook(provider, {
+ *   qualities: [QUALITY_PRESETS["720p"], QUALITY_PRESETS["1080p"]],
+ * });
+ *
+ * // Use with processing pipeline
+ * const processing = { hooks: [videoHook] };
+ * ```
+ */
+export declare function createVideoProcessingHook(provider: TranscodingProvider, options?: VideoProcessingHookOptions): ProcessingHook;
+export {};
+//# sourceMappingURL=video-processing.d.ts.map

package/dist/hooks/video-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-processing.d.ts","sourceRoot":"","sources":["../../src/hooks/video-processing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA2C,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,aAAa,CAAC;AAIrE,UAAU,0BAA0B;IAClC,oEAAoE;IACpE,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE,0BAA+B,GACvC,cAAc,CA4GhB"}

package/dist/hooks/video-processing.js

@@ -0,0 +1,115 @@
+import { QUALITY_PRESETS } from "../types.js";
+import { extractVideoMetadata } from "../metadata.js";
+/**
+ * Creates a processing hook that triggers video transcoding after upload.
+ *
+ * Implements the `@uploadbox/core` `ProcessingHook` interface. Only runs
+ * for files with a `video/*` MIME type.
+ *
+ * @param provider - The transcoding provider to use (FFmpeg, Lambda, External).
+ * @param options - Transcoding options.
+ *
+ * @example
+ * ```ts
+ * import { createVideoProcessingHook } from "@uploadbox/video/hooks/video-processing";
+ * import { createFFmpegProvider } from "@uploadbox/video/providers/ffmpeg";
+ *
+ * const provider = createFFmpegProvider();
+ * const videoHook = createVideoProcessingHook(provider, {
+ *   qualities: [QUALITY_PRESETS["720p"], QUALITY_PRESETS["1080p"]],
+ * });
+ *
+ * // Use with processing pipeline
+ * const processing = { hooks: [videoHook] };
+ * ```
+ */
+export function createVideoProcessingHook(provider, options = {}) {
+    const { qualities = Object.values(QUALITY_PRESETS), segmentDuration = 6, generateThumbnail = true, generateSpriteSheet = true, timeoutMs = 30 * 60 * 1000, getOutputPrefix = (fileKey) => {
+        const baseName = fileKey.replace(/\.[^.]+$/, "");
+        return `video/${baseName}`;
+    }, } = options;
+    return {
+        name: "video-processing",
+        timeoutMs,
+        shouldRun(ctx) {
+            return ctx.file.type.startsWith("video/");
+        },
+        async run(ctx) {
+            try {
+                // Extract metadata to filter presets by source resolution
+                const { GetObjectCommand } = await import("@aws-sdk/client-s3");
+                const response = await ctx.s3Client.send(new GetObjectCommand({
+                    Bucket: ctx.config.bucket,
+                    Key: ctx.file.key,
+                }));
+                // Write to temp file for ffprobe
+                const fs = await import("fs/promises");
+                const os = await import("os");
+                const path = await import("path");
+                const tmpFile = path.join(os.tmpdir(), `uploadbox-probe-${crypto.randomUUID()}`);
+                const body = await response.Body?.transformToByteArray();
+                if (!body) {
+                    return { success: false, error: "Failed to download video from S3" };
+                }
+                await fs.writeFile(tmpFile, body);
+                let metadata;
+                try {
+                    metadata = await extractVideoMetadata(tmpFile);
+                }
+                finally {
+                    await fs.rm(tmpFile, { force: true }).catch(() => { });
+                }
+                // Filter quality presets: only include presets at or below source resolution
+                const filteredQualities = qualities.filter((q) => q.height <= metadata.height);
+                // Always include at least the lowest quality
+                if (filteredQualities.length === 0 && qualities.length > 0) {
+                    const lowest = [...qualities].sort((a, b) => a.height - b.height)[0];
+                    if (lowest)
+                        filteredQualities.push(lowest);
+                }
+                const outputPrefix = getOutputPrefix(ctx.file.key);
+                const transcodingOptions = {
+                    qualities: filteredQualities,
+                    segmentDuration,
+                    generateThumbnail,
+                    generateSpriteSheet,
+                    s3OutputPrefix: outputPrefix,
+                };
+                // Submit transcoding job
+                const { jobId } = await provider.submit({
+                    sourceKey: ctx.file.key,
+                    sourceBucket: ctx.config.bucket,
+                    outputBucket: ctx.config.bucket,
+                    options: transcodingOptions,
+                    s3Config: {
+                        region: ctx.config.region,
+                        endpoint: ctx.config.endpoint,
+                        accessKeyId: ctx.config.accessKeyId,
+                        secretAccessKey: ctx.config.secretAccessKey,
+                        forcePathStyle: ctx.config.forcePathStyle,
+                    },
+                });
+                return {
+                    success: true,
+                    data: {
+                        jobId,
+                        providerName: provider.name,
+                        masterPlaylistKey: `${outputPrefix}/master.m3u8`,
+                        thumbnailKey: generateThumbnail ? `${outputPrefix}/thumbnail.jpg` : undefined,
+                        spriteSheetKey: generateSpriteSheet ? `${outputPrefix}/sprites/sprite-sheet.jpg` : undefined,
+                        spriteVttKey: generateSpriteSheet ? `${outputPrefix}/sprites/sprites.vtt` : undefined,
+                        qualities: filteredQualities.map((q) => q.label),
+                        metadata,
+                    },
+                };
+            }
+            catch (err) {
+                return {
+                    success: false,
+                    error: `Video processing failed: ${err.message}`,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=video-processing.js.map

package/dist/hooks/video-processing.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { VideoMetadata, TranscodingStatus, QualityPreset, TranscodingJob, TranscodingOptions, TranscodingProgress, TranscodingProgressCallback, } from "./types.js";
+export { QUALITY_PRESETS, CDN_CACHE_HEADERS } from "./types.js";
+export type { TranscodingProvider, TranscodingSubmitInput, } from "./provider.js";
+export { extractVideoMetadata } from "./metadata.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,YAAY,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { QUALITY_PRESETS, CDN_CACHE_HEADERS } from "./types.js";
+export { extractVideoMetadata } from "./metadata.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,19 @@
+import type { VideoMetadata } from "./types.js";
+/**
+ * Extract video metadata (dimensions, duration, codec, etc.) using ffprobe.
+ *
+ * Requires `ffprobe` to be installed on the system (available on `$PATH`).
+ *
+ * @param input - Path to the video file or a readable stream.
+ * @returns Extracted video metadata.
+ *
+ * @example
+ * ```ts
+ * import { extractVideoMetadata } from "@uploadbox/video";
+ *
+ * const metadata = await extractVideoMetadata("/tmp/video.mp4");
+ * console.log(metadata.width, metadata.height, metadata.durationSeconds);
+ * ```
+ */
+export declare function extractVideoMetadata(input: string | NodeJS.ReadableStream): Promise<VideoMetadata>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,GACpC,OAAO,CAAC,aAAa,CAAC,CAmCxB"}

package/dist/metadata.js

@@ -0,0 +1,50 @@
+import { ffprobe } from "./ffutils.js";
+/**
+ * Extract video metadata (dimensions, duration, codec, etc.) using ffprobe.
+ *
+ * Requires `ffprobe` to be installed on the system (available on `$PATH`).
+ *
+ * @param input - Path to the video file or a readable stream.
+ * @returns Extracted video metadata.
+ *
+ * @example
+ * ```ts
+ * import { extractVideoMetadata } from "@uploadbox/video";
+ *
+ * const metadata = await extractVideoMetadata("/tmp/video.mp4");
+ * console.log(metadata.width, metadata.height, metadata.durationSeconds);
+ * ```
+ */
+export async function extractVideoMetadata(input) {
+    const data = await ffprobe(input);
+    const videoStream = data.streams?.find((s) => s.codec_type === "video");
+    const audioStream = data.streams?.find((s) => s.codec_type === "audio");
+    if (!videoStream) {
+        throw new Error("No video stream found in file");
+    }
+    // Parse frame rate from r_frame_rate (e.g. "30/1" or "30000/1001")
+    let frameRate = 30;
+    if (videoStream.r_frame_rate) {
+        const [num, den] = videoStream.r_frame_rate.split("/").map(Number);
+        if (num && den)
+            frameRate = Math.round((num / den) * 100) / 100;
+    }
+    const metadata = {
+        width: videoStream.width ?? 0,
+        height: videoStream.height ?? 0,
+        durationSeconds: parseFloat(data.format?.duration ?? videoStream.duration ?? "0"),
+        codec: videoStream.codec_name ?? "unknown",
+        frameRate,
+        bitrate: parseInt(data.format?.bit_rate ?? videoStream.bit_rate ?? "0", 10),
+        audio: audioStream
+            ? {
+                codec: audioStream.codec_name ?? "unknown",
+                sampleRate: parseInt(audioStream.sample_rate ?? "0", 10),
+                channels: audioStream.channels ?? 0,
+                bitrate: parseInt(audioStream.bit_rate ?? "0", 10),
+            }
+            : undefined,
+    };
+    return metadata;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAqC;IAErC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAElC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,mEAAmE;IACnE,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,GAAG,IAAI,GAAG;YAAE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;QAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,CAAC;QAC/B,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,WAAW,CAAC,QAAQ,IAAI,GAAG,CAAC;QACjF,KAAK,EAAE,WAAW,CAAC,UAAU,IAAI,SAAS;QAC1C,SAAS;QACT,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,WAAW,CAAC,QAAQ,IAAI,GAAG,EAAE,EAAE,CAAC;QAC3E,KAAK,EAAE,WAAW;YAChB,CAAC,CAAC;gBACE,KAAK,EAAE,WAAW,CAAC,UAAU,IAAI,SAAS;gBAC1C,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW,IAAI,GAAG,EAAE,EAAE,CAAC;gBACxD,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,CAAC;gBACnC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,IAAI,GAAG,EAAE,EAAE,CAAC;aACnD;YACH,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,44 @@
+import type { TranscodingOptions, TranscodingJob, TranscodingProgressCallback } from "./types.js";
+/** Input passed to a transcoding provider's submit method. */
+export interface TranscodingSubmitInput {
+    /** S3 key of the source video file. */
+    sourceKey: string;
+    /** S3 bucket containing the source file. */
+    sourceBucket: string;
+    /** S3 bucket for transcoded output (may be the same as source). */
+    outputBucket: string;
+    /** Transcoding options controlling quality presets, segments, etc. */
+    options: TranscodingOptions;
+    /** S3 connection configuration. */
+    s3Config: {
+        region?: string;
+        endpoint?: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+        forcePathStyle?: boolean;
+    };
+    /** Optional callback for progress updates. */
+    onProgress?: TranscodingProgressCallback;
+}
+/**
+ * Interface for pluggable transcoding backends.
+ *
+ * Implementations handle the actual video transcoding work — locally via FFmpeg,
+ * remotely via AWS Lambda, or through external services like Mux or Cloudflare Stream.
+ */
+export interface TranscodingProvider {
+    /** Human-readable provider name for logging. */
+    name: string;
+    /**
+     * Submit a video for transcoding.
+     * Returns a job ID that can be used to track status.
+     */
+    submit(input: TranscodingSubmitInput): Promise<{
+        jobId: string;
+    }>;
+    /** Get the current status of a transcoding job. */
+    getJobStatus(jobId: string): Promise<TranscodingJob>;
+    /** Cancel a running transcoding job. */
+    cancel(jobId: string): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAElG,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,OAAO,EAAE,kBAAkB,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,8CAA8C;IAC9C,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElE,mDAAmD;IACnD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAErD,wCAAwC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC"}

package/dist/provider.js

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

package/dist/provider.js.map

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

package/dist/providers/external.d.ts

@@ -0,0 +1,40 @@
+import type { TranscodingProvider } from "../provider.js";
+import type { TranscodingJob } from "../types.js";
+interface ExternalProviderOptions {
+    /** Base URL for the external transcoding API. */
+    apiUrl: string;
+    /** API key for authentication. */
+    apiKey: string;
+    /** Webhook secret for verifying incoming status callbacks. */
+    webhookSecret?: string;
+    /**
+     * Map external API response to TranscodingJob format.
+     * If not provided, the response is assumed to already match.
+     */
+    mapResponse?: (response: Record<string, unknown>) => TranscodingJob;
+}
+/**
+ * Generic external transcoding provider.
+ *
+ * Adapter for external services like Mux, Cloudflare Stream, or any API
+ * that accepts a source URL and returns transcoded HLS outputs.
+ *
+ * @example
+ * ```ts
+ * import { createExternalProvider } from "@uploadbox/video/providers/external";
+ *
+ * const provider = createExternalProvider({
+ *   apiUrl: "https://api.mux.com/video/v1/assets",
+ *   apiKey: process.env.MUX_TOKEN_ID + ":" + process.env.MUX_TOKEN_SECRET,
+ *   mapResponse: (res) => ({
+ *     jobId: res.id as string,
+ *     status: mapMuxStatus(res.status as string),
+ *     progress: res.status === "ready" ? 100 : 50,
+ *     outputKeys: [],
+ *   }),
+ * });
+ * ```
+ */
+export declare function createExternalProvider(options: ExternalProviderOptions): TranscodingProvider;
+export {};
+//# sourceMappingURL=external.d.ts.map

package/dist/providers/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/providers/external.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,gBAAgB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAErE,UAAU,uBAAuB;IAC/B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,cAAc,CAAC;CACrE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CAgFrB"}

package/dist/providers/external.js

@@ -0,0 +1,94 @@
+/**
+ * Generic external transcoding provider.
+ *
+ * Adapter for external services like Mux, Cloudflare Stream, or any API
+ * that accepts a source URL and returns transcoded HLS outputs.
+ *
+ * @example
+ * ```ts
+ * import { createExternalProvider } from "@uploadbox/video/providers/external";
+ *
+ * const provider = createExternalProvider({
+ *   apiUrl: "https://api.mux.com/video/v1/assets",
+ *   apiKey: process.env.MUX_TOKEN_ID + ":" + process.env.MUX_TOKEN_SECRET,
+ *   mapResponse: (res) => ({
+ *     jobId: res.id as string,
+ *     status: mapMuxStatus(res.status as string),
+ *     progress: res.status === "ready" ? 100 : 50,
+ *     outputKeys: [],
+ *   }),
+ * });
+ * ```
+ */
+export function createExternalProvider(options) {
+    const { apiUrl, apiKey, mapResponse } = options;
+    function mapJob(data) {
+        if (mapResponse)
+            return mapResponse(data);
+        return {
+            jobId: data["jobId"] ?? data["id"] ?? "",
+            status: data["status"] ?? "pending",
+            progress: data["progress"] ?? 0,
+            outputKeys: data["outputKeys"] ?? [],
+            error: data["error"],
+        };
+    }
+    return {
+        name: "external",
+        async submit(input) {
+            const response = await fetch(apiUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    sourceKey: input.sourceKey,
+                    sourceBucket: input.sourceBucket,
+                    outputBucket: input.outputBucket,
+                    options: input.options,
+                    s3Config: {
+                        region: input.s3Config.region,
+                        endpoint: input.s3Config.endpoint,
+                    },
+                }),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => "");
+                throw new Error(`External transcoding API returned ${response.status}: ${text.slice(0, 500)}`);
+            }
+            const data = (await response.json());
+            const jobId = data["jobId"] ?? data["id"];
+            if (!jobId)
+                throw new Error("External API did not return a jobId");
+            return { jobId };
+        },
+        async getJobStatus(jobId) {
+            const response = await fetch(`${apiUrl}/${jobId}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                },
+            });
+            if (!response.ok) {
+                return {
+                    jobId,
+                    status: "failed",
+                    progress: 0,
+                    outputKeys: [],
+                    error: `API returned ${response.status}`,
+                };
+            }
+            const data = (await response.json());
+            return mapJob(data);
+        },
+        async cancel(jobId) {
+            await fetch(`${apiUrl}/${jobId}/cancel`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=external.js.map

package/dist/providers/external.js.map

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

package/dist/providers/ffmpeg.d.ts

@@ -0,0 +1,27 @@
+import type { TranscodingProvider } from "../provider.js";
+interface FFmpegProviderOptions {
+    /** Path to ffmpeg binary. @default "ffmpeg" */
+    ffmpegPath?: string;
+    /** Path to ffprobe binary. @default "ffprobe" */
+    ffprobePath?: string;
+    /** Temporary directory for intermediate files. @default os.tmpdir() */
+    tmpDir?: string;
+}
+/**
+ * Local FFmpeg transcoding provider.
+ *
+ * Downloads the source video from S3, transcodes it using a local FFmpeg binary,
+ * and uploads HLS segments, playlists, thumbnails, and sprites back to S3.
+ *
+ * Best for development and small-scale self-hosted deployments.
+ *
+ * @example
+ * ```ts
+ * import { createFFmpegProvider } from "@uploadbox/video/providers/ffmpeg";
+ *
+ * const provider = createFFmpegProvider({ ffmpegPath: "/usr/bin/ffmpeg" });
+ * ```
+ */
+export declare function createFFmpegProvider(options?: FFmpegProviderOptions): TranscodingProvider;
+export {};
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/providers/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../src/providers/ffmpeg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,gBAAgB,CAAC;AAUlF,UAAU,qBAAqB;IAC7B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,mBAAmB,CAwTrB"}