@uploadbox/video 0.4.0

package/dist/providers/ffmpeg.js

@@ -0,0 +1,282 @@
+import { QUALITY_PRESETS } from "../types.js";
+import { createS3Client } from "@uploadbox/core";
+import { ffprobe, runFFmpeg } from "../ffutils.js";
+import crypto from "crypto";
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+/**
+ * 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 function createFFmpegProvider(options = {}) {
+    const { ffmpegPath = "ffmpeg", ffprobePath = "ffprobe", tmpDir = os.tmpdir(), } = options;
+    const jobs = new Map();
+    return {
+        name: "ffmpeg-local",
+        async submit(input) {
+            const jobId = crypto.randomUUID();
+            const abortController = new AbortController();
+            const jobState = {
+                status: "pending",
+                progress: 0,
+                outputKeys: [],
+                abortController,
+            };
+            jobs.set(jobId, jobState);
+            // Run transcoding in background (don't await)
+            runTranscoding(jobId, input, jobState, abortController.signal).catch((err) => {
+                jobState.status = "failed";
+                jobState.error = err.message;
+            });
+            return { jobId };
+        },
+        async getJobStatus(jobId) {
+            const state = jobs.get(jobId);
+            if (!state) {
+                return {
+                    jobId,
+                    status: "failed",
+                    progress: 0,
+                    outputKeys: [],
+                    error: "Job not found",
+                };
+            }
+            return {
+                jobId,
+                status: state.status,
+                progress: state.progress,
+                outputKeys: state.outputKeys,
+                error: state.error,
+            };
+        },
+        async cancel(jobId) {
+            const state = jobs.get(jobId);
+            if (state?.abortController) {
+                state.abortController.abort();
+                state.status = "failed";
+                state.error = "Cancelled";
+            }
+        },
+    };
+    async function runTranscoding(jobId, input, state, signal) {
+        const workDir = path.join(tmpDir, `uploadbox-video-${jobId}`);
+        await fs.mkdir(workDir, { recursive: true });
+        const { GetObjectCommand, PutObjectCommand } = await import("@aws-sdk/client-s3");
+        const s3Client = createS3Client({
+            region: input.s3Config.region ?? "us-east-1",
+            bucket: input.sourceBucket,
+            accessKeyId: input.s3Config.accessKeyId,
+            secretAccessKey: input.s3Config.secretAccessKey,
+            endpoint: input.s3Config.endpoint,
+            forcePathStyle: input.s3Config.forcePathStyle,
+        });
+        try {
+            state.status = "processing";
+            state.progress = 0;
+            input.onProgress?.({ jobId, percent: 0, message: "Downloading source video" });
+            // Download source from S3
+            const sourcePath = path.join(workDir, "source");
+            const getResponse = await s3Client.send(new GetObjectCommand({ Bucket: input.sourceBucket, Key: input.sourceKey }));
+            const body = await getResponse.Body?.transformToByteArray();
+            if (!body)
+                throw new Error("Failed to download source video from S3");
+            await fs.writeFile(sourcePath, body);
+            if (signal.aborted)
+                throw new Error("Cancelled");
+            // Determine qualities to transcode
+            const qualities = input.options.qualities ?? Object.values(QUALITY_PRESETS);
+            const segmentDuration = input.options.segmentDuration ?? 6;
+            const outputPrefix = input.options.s3OutputPrefix;
+            const totalSteps = qualities.length + 2; // +1 thumbnail, +1 sprite
+            let completedSteps = 0;
+            // Transcode each quality
+            const qualityPlaylists = [];
+            for (const preset of qualities) {
+                if (signal.aborted)
+                    throw new Error("Cancelled");
+                const qualityDir = path.join(workDir, preset.label);
+                await fs.mkdir(qualityDir, { recursive: true });
+                input.onProgress?.({
+                    jobId,
+                    percent: Math.round((completedSteps / totalSteps) * 100),
+                    currentQuality: preset.label,
+                    message: `Transcoding ${preset.label}`,
+                });
+                const segmentPattern = path.join(qualityDir, "segment-%03d.ts");
+                const playlistOutput = path.join(qualityDir, "playlist.m3u8");
+                await runFFmpeg([
+                    "-i", sourcePath,
+                    "-vf", `scale=${preset.width}:${preset.height}:force_original_aspect_ratio=decrease,pad=${preset.width}:${preset.height}:(ow-iw)/2:(oh-ih)/2`,
+                    "-c:v", "libx264",
+                    "-b:v", `${preset.videoBitrate}`,
+                    "-maxrate", `${Math.round(preset.videoBitrate * 1.2)}`,
+                    "-bufsize", `${Math.round(preset.videoBitrate * 2)}`,
+                    "-r", `${Math.min(preset.maxFrameRate, 60)}`,
+                    "-c:a", "aac",
+                    "-b:a", `${preset.audioBitrate}`,
+                    "-ac", "2",
+                    "-hls_time", `${segmentDuration}`,
+                    "-hls_playlist_type", "vod",
+                    "-hls_segment_filename", segmentPattern,
+                    "-f", "hls",
+                    playlistOutput,
+                ], { ffmpegPath, signal });
+                // Upload segments and playlist to S3
+                const segmentFiles = await fs.readdir(qualityDir);
+                for (const file of segmentFiles) {
+                    const filePath = path.join(qualityDir, file);
+                    const fileContent = await fs.readFile(filePath);
+                    const s3Key = `${outputPrefix}/${preset.label}/${file}`;
+                    const contentType = file.endsWith(".m3u8")
+                        ? "application/vnd.apple.mpegurl"
+                        : "video/MP2T";
+                    await s3Client.send(new PutObjectCommand({
+                        Bucket: input.outputBucket,
+                        Key: s3Key,
+                        Body: fileContent,
+                        ContentType: contentType,
+                    }));
+                    state.outputKeys.push(s3Key);
+                }
+                qualityPlaylists.push({
+                    preset,
+                    playlistKey: `${outputPrefix}/${preset.label}/playlist.m3u8`,
+                });
+                completedSteps++;
+                state.progress = Math.round((completedSteps / totalSteps) * 100);
+            }
+            if (signal.aborted)
+                throw new Error("Cancelled");
+            // Generate master playlist
+            let masterPlaylist = "#EXTM3U\n#EXT-X-VERSION:3\n";
+            for (const { preset } of qualityPlaylists) {
+                const bandwidth = preset.videoBitrate + preset.audioBitrate;
+                masterPlaylist += `#EXT-X-STREAM-INF:BANDWIDTH=${bandwidth},RESOLUTION=${preset.width}x${preset.height}\n`;
+                masterPlaylist += `${preset.label}/playlist.m3u8\n`;
+            }
+            const masterKey = `${outputPrefix}/master.m3u8`;
+            await s3Client.send(new PutObjectCommand({
+                Bucket: input.outputBucket,
+                Key: masterKey,
+                Body: Buffer.from(masterPlaylist),
+                ContentType: "application/vnd.apple.mpegurl",
+            }));
+            state.outputKeys.push(masterKey);
+            // Generate poster thumbnail at ~10% duration
+            if (input.options.generateThumbnail !== false) {
+                input.onProgress?.({
+                    jobId,
+                    percent: Math.round((completedSteps / totalSteps) * 100),
+                    message: "Generating thumbnail",
+                });
+                const thumbnailPath = path.join(workDir, "thumbnail.jpg");
+                // Get duration for timestamp calculation
+                const probeData = await ffprobe(sourcePath, { ffprobePath });
+                const duration = parseFloat(probeData.format?.duration ?? "10");
+                const thumbnailTime = Math.max(0.1, duration * 0.1);
+                await runFFmpeg([
+                    "-ss", `${thumbnailTime}`,
+                    "-i", sourcePath,
+                    "-vframes", "1",
+                    "-q:v", "2",
+                    thumbnailPath,
+                ], { ffmpegPath, signal });
+                const thumbContent = await fs.readFile(thumbnailPath);
+                const thumbKey = `${outputPrefix}/thumbnail.jpg`;
+                await s3Client.send(new PutObjectCommand({
+                    Bucket: input.outputBucket,
+                    Key: thumbKey,
+                    Body: thumbContent,
+                    ContentType: "image/jpeg",
+                }));
+                state.outputKeys.push(thumbKey);
+                completedSteps++;
+            }
+            // Generate sprite sheet + WebVTT
+            if (input.options.generateSpriteSheet !== false) {
+                input.onProgress?.({
+                    jobId,
+                    percent: Math.round((completedSteps / totalSteps) * 100),
+                    message: "Generating sprite sheet",
+                });
+                const spritesDir = path.join(workDir, "sprites");
+                await fs.mkdir(spritesDir, { recursive: true });
+                // Extract frames every 10 seconds
+                const probeData = await ffprobe(sourcePath, { ffprobePath });
+                const duration = parseFloat(probeData.format?.duration ?? "10");
+                const interval = 10;
+                const thumbWidth = 160;
+                const thumbHeight = 90;
+                const cols = 10;
+                const frameCount = Math.ceil(duration / interval);
+                const rows = Math.ceil(frameCount / cols);
+                // Generate sprite sheet using a single FFmpeg command
+                await runFFmpeg([
+                    "-i", sourcePath,
+                    "-vf", `fps=1/${interval},scale=${thumbWidth}:${thumbHeight},tile=${cols}x${rows}`,
+                    "-frames:v", "1",
+                    "-q:v", "5",
+                    path.join(spritesDir, "sprite-sheet.jpg"),
+                ], { ffmpegPath, signal });
+                // Upload sprite sheet
+                const spriteContent = await fs.readFile(path.join(spritesDir, "sprite-sheet.jpg"));
+                const spriteKey = `${outputPrefix}/sprites/sprite-sheet.jpg`;
+                await s3Client.send(new PutObjectCommand({
+                    Bucket: input.outputBucket,
+                    Key: spriteKey,
+                    Body: spriteContent,
+                    ContentType: "image/jpeg",
+                }));
+                state.outputKeys.push(spriteKey);
+                // Generate WebVTT for sprite positions
+                let vtt = "WEBVTT\n\n";
+                for (let i = 0; i < frameCount; i++) {
+                    const startTime = i * interval;
+                    const endTime = Math.min((i + 1) * interval, duration);
+                    const col = i % cols;
+                    const row = Math.floor(i / cols);
+                    const x = col * thumbWidth;
+                    const y = row * thumbHeight;
+                    vtt += `${formatVttTime(startTime)} --> ${formatVttTime(endTime)}\n`;
+                    vtt += `sprite-sheet.jpg#xywh=${x},${y},${thumbWidth},${thumbHeight}\n\n`;
+                }
+                const vttKey = `${outputPrefix}/sprites/sprites.vtt`;
+                await s3Client.send(new PutObjectCommand({
+                    Bucket: input.outputBucket,
+                    Key: vttKey,
+                    Body: Buffer.from(vtt),
+                    ContentType: "text/vtt",
+                }));
+                state.outputKeys.push(vttKey);
+                completedSteps++;
+            }
+            state.status = "completed";
+            state.progress = 100;
+            input.onProgress?.({ jobId, percent: 100, message: "Transcoding complete" });
+        }
+        finally {
+            // Cleanup temp directory
+            await fs.rm(workDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+function formatVttTime(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    const ms = Math.round((seconds % 1) * 1000);
+    return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}.${String(ms).padStart(3, "0")}`;
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/providers/ffmpeg.js.map

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

package/dist/providers/lambda.d.ts

@@ -0,0 +1,49 @@
+import type { TranscodingProvider } from "../provider.js";
+import type { TranscodingJob } from "../types.js";
+interface LambdaProviderOptions {
+    /** AWS region where the Lambda function is deployed. */
+    region: string;
+    /** ARN of the Lambda function that performs transcoding. */
+    functionArn: string;
+    /**
+     * Function to poll job status. The Lambda function should store status
+     * in DynamoDB or a similar store that this function can query.
+     */
+    getStatus: (jobId: string) => Promise<TranscodingJob>;
+    /**
+     * Optional function to cancel a job.
+     */
+    cancelJob?: (jobId: string) => Promise<void>;
+}
+/**
+ * AWS Lambda transcoding provider.
+ *
+ * Invokes a user-provided Lambda function asynchronously for transcoding.
+ * The Lambda function is NOT included — users must implement and deploy it themselves.
+ *
+ * The Lambda function receives the same input payload and should:
+ * 1. Download the source video from S3
+ * 2. Transcode to HLS using FFmpeg (via a Lambda layer)
+ * 3. Upload outputs back to S3
+ * 4. Store job status in DynamoDB for polling
+ *
+ * Requires `@aws-sdk/client-lambda` to be installed by the user.
+ *
+ * @example
+ * ```ts
+ * import { createLambdaProvider } from "@uploadbox/video/providers/lambda";
+ *
+ * const provider = createLambdaProvider({
+ *   region: "us-east-1",
+ *   functionArn: "arn:aws:lambda:us-east-1:123456789:function:video-transcode",
+ *   getStatus: async (jobId) => {
+ *     // Query DynamoDB for job status
+ *     const item = await dynamodb.get({ TableName: "jobs", Key: { jobId } });
+ *     return item;
+ *   },
+ * });
+ * ```
+ */
+export declare function createLambdaProvider(options: LambdaProviderOptions): TranscodingProvider;
+export {};
+//# sourceMappingURL=lambda.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.d.ts","sourceRoot":"","sources":["../../src/providers/lambda.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,gBAAgB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,qBAAqB;IAC7B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACtD;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,mBAAmB,CA4DrB"}

package/dist/providers/lambda.js

@@ -0,0 +1,80 @@
+import crypto from "crypto";
+/**
+ * AWS Lambda transcoding provider.
+ *
+ * Invokes a user-provided Lambda function asynchronously for transcoding.
+ * The Lambda function is NOT included — users must implement and deploy it themselves.
+ *
+ * The Lambda function receives the same input payload and should:
+ * 1. Download the source video from S3
+ * 2. Transcode to HLS using FFmpeg (via a Lambda layer)
+ * 3. Upload outputs back to S3
+ * 4. Store job status in DynamoDB for polling
+ *
+ * Requires `@aws-sdk/client-lambda` to be installed by the user.
+ *
+ * @example
+ * ```ts
+ * import { createLambdaProvider } from "@uploadbox/video/providers/lambda";
+ *
+ * const provider = createLambdaProvider({
+ *   region: "us-east-1",
+ *   functionArn: "arn:aws:lambda:us-east-1:123456789:function:video-transcode",
+ *   getStatus: async (jobId) => {
+ *     // Query DynamoDB for job status
+ *     const item = await dynamodb.get({ TableName: "jobs", Key: { jobId } });
+ *     return item;
+ *   },
+ * });
+ * ```
+ */
+export function createLambdaProvider(options) {
+    const { region, functionArn, getStatus, cancelJob } = options;
+    return {
+        name: "aws-lambda",
+        async submit(input) {
+            // Dynamic import to keep @aws-sdk/client-lambda optional
+            let LambdaClient;
+            let InvokeCommand;
+            try {
+                const mod = await Function('return import("@aws-sdk/client-lambda")')();
+                LambdaClient = mod.LambdaClient;
+                InvokeCommand = mod.InvokeCommand;
+            }
+            catch {
+                throw new Error("@aws-sdk/client-lambda is not installed. Run: npm install @aws-sdk/client-lambda");
+            }
+            const lambda = new LambdaClient({
+                region,
+                credentials: {
+                    accessKeyId: input.s3Config.accessKeyId,
+                    secretAccessKey: input.s3Config.secretAccessKey,
+                },
+            });
+            const jobId = crypto.randomUUID();
+            const payload = {
+                jobId,
+                sourceKey: input.sourceKey,
+                sourceBucket: input.sourceBucket,
+                outputBucket: input.outputBucket,
+                options: input.options,
+                s3Config: input.s3Config,
+            };
+            await lambda.send(new InvokeCommand({
+                FunctionName: functionArn,
+                InvocationType: "Event",
+                Payload: Buffer.from(JSON.stringify(payload)),
+            }));
+            return { jobId };
+        },
+        async getJobStatus(jobId) {
+            return getStatus(jobId);
+        },
+        async cancel(jobId) {
+            if (cancelJob) {
+                await cancelJob(jobId);
+            }
+        },
+    };
+}
+//# sourceMappingURL=lambda.js.map

package/dist/providers/lambda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../src/providers/lambda.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAkB5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA8B;IAE9B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9D,OAAO;QACL,IAAI,EAAE,YAAY;QAElB,KAAK,CAAC,MAAM,CAAC,KAA6B;YACxC,yDAAyD;YACzD,IAAI,YAAiB,CAAC;YACtB,IAAI,aAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAO,QAAQ,CAAC,yCAAyC,CAAC,EAAmB,CAAC;gBAC1F,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;gBAChC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;gBAC9B,MAAM;gBACN,WAAW,EAAE;oBACX,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;oBACvC,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;iBAChD;aACF,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YAElC,MAAM,OAAO,GAAG;gBACd,KAAK;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC;YAEF,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,aAAa,CAAC;gBAChB,YAAY,EAAE,WAAW;gBACzB,cAAc,EAAE,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;aAC9C,CAAC,CACH,CAAC;YAEF,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,KAAa;YAC9B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAa;YACxB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { useVideoPlayer } from "./use-video-player.js";
+export type { UseVideoPlayerOptions, VideoPlayerState, QualityLevel, SpritePosition, } from "./use-video-player.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export { useVideoPlayer } from "./use-video-player.js";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react/use-video-player.d.ts

@@ -0,0 +1,110 @@
+import type { RefObject } from "react";
+/** A single HLS quality level. */
+export interface QualityLevel {
+    index: number;
+    width: number;
+    height: number;
+    bitrate: number;
+    label: string;
+}
+/** Sprite position for scrub preview. */
+export interface SpritePosition {
+    url: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Options for the useVideoPlayer hook. */
+export interface UseVideoPlayerOptions {
+    /** Auto-play the video when ready. @default false */
+    autoPlay?: boolean;
+    /** Initial volume (0–1). @default 1 */
+    initialVolume?: number;
+    /** URL to the WebVTT sprite sheet file. */
+    spriteVttUrl?: string;
+}
+/** Return value of the useVideoPlayer hook. */
+export interface VideoPlayerState {
+    /** Ref to attach to the <video> element. */
+    videoRef: RefObject<HTMLVideoElement | null>;
+    /** Whether the video is currently playing. */
+    isPlaying: boolean;
+    /** Current playback position in seconds. */
+    currentTime: number;
+    /** Total duration in seconds. */
+    duration: number;
+    /** Current volume (0–1). */
+    volume: number;
+    /** Whether audio is muted. */
+    isMuted: boolean;
+    /** Current playback rate. */
+    playbackRate: number;
+    /** Available quality levels. */
+    qualities: QualityLevel[];
+    /** Index of the current quality level (-1 for auto). */
+    currentQuality: number;
+    /** Whether adaptive quality selection is active. */
+    isAutoQuality: boolean;
+    /** Whether fullscreen is active. */
+    isFullscreen: boolean;
+    /** Whether the video is buffering. */
+    isBuffering: boolean;
+    /** Start playback. */
+    play: () => void;
+    /** Pause playback. */
+    pause: () => void;
+    /** Toggle play/pause. */
+    toggle: () => void;
+    /** Seek to a position in seconds. */
+    seek: (time: number) => void;
+    /** Set volume (0–1). */
+    setVolume: (vol: number) => void;
+    /** Toggle mute/unmute. */
+    toggleMute: () => void;
+    /** Set playback rate. */
+    setPlaybackRate: (rate: number) => void;
+    /** Set quality level by index. Pass -1 for auto. */
+    setQuality: (index: number) => void;
+    /** Enter fullscreen. */
+    enterFullscreen: () => void;
+    /** Exit fullscreen. */
+    exitFullscreen: () => void;
+    /** Toggle fullscreen. */
+    toggleFullscreen: () => void;
+    /** Get sprite position for a given time (for scrub preview). */
+    getSpriteForTime: (time: number) => SpritePosition | null;
+}
+/**
+ * Headless React hook for HLS video playback.
+ *
+ * Provides playback controls, quality switching, fullscreen, and sprite preview
+ * without any UI — you build your own player controls.
+ *
+ * Uses `hls.js` for adaptive streaming with a fallback to native `<video>` HLS
+ * support (Safari).
+ *
+ * @param src - URL to the HLS master playlist (.m3u8) or a regular video file.
+ * @param options - Configuration options.
+ *
+ * @example
+ * ```tsx
+ * import { useVideoPlayer } from "@uploadbox/video/react";
+ *
+ * function Player({ url }: { url: string }) {
+ *   const player = useVideoPlayer(url);
+ *
+ *   return (
+ *     <div>
+ *       <video ref={player.videoRef} />
+ *       <button onClick={player.toggle}>
+ *         {player.isPlaying ? "Pause" : "Play"}
+ *       </button>
+ *       <span>{player.currentTime} / {player.duration}</span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useVideoPlayer(src: string, options?: UseVideoPlayerOptions): VideoPlayerState;
+//# sourceMappingURL=use-video-player.d.ts.map

package/dist/react/use-video-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-video-player.d.ts","sourceRoot":"","sources":["../../src/react/use-video-player.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7C,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yBAAyB;IACzB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,qCAAqC;IACrC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,wBAAwB;IACxB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,0BAA0B;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,yBAAyB;IACzB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oDAAoD;IACpD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,wBAAwB;IACxB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,uBAAuB;IACvB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,gEAAgE;IAChE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;CAC3D;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,gBAAgB,CA+PlB"}