@uploadbox/video 0.4.0

package/dist/react/use-video-player.js

@@ -0,0 +1,319 @@
+"use client";
+import { useRef, useState, useEffect, useCallback } from "react";
+/**
+ * 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 function useVideoPlayer(src, options = {}) {
+    const { autoPlay = false, initialVolume = 1, spriteVttUrl } = options;
+    const videoRef = useRef(null);
+    const hlsRef = useRef(null);
+    const [isPlaying, setIsPlaying] = useState(false);
+    const [currentTime, setCurrentTime] = useState(0);
+    const [duration, setDuration] = useState(0);
+    const [volume, setVolumeState] = useState(initialVolume);
+    const [isMuted, setIsMuted] = useState(false);
+    const [playbackRate, setPlaybackRateState] = useState(1);
+    const [qualities, setQualities] = useState([]);
+    const [currentQuality, setCurrentQualityState] = useState(-1);
+    const [isFullscreen, setIsFullscreen] = useState(false);
+    const [isBuffering, setIsBuffering] = useState(false);
+    const [spriteCues, setSpriteCues] = useState([]);
+    // Parse sprite VTT
+    useEffect(() => {
+        if (!spriteVttUrl)
+            return;
+        fetch(spriteVttUrl)
+            .then((res) => res.text())
+            .then((text) => {
+            const cues = parseVtt(text, spriteVttUrl);
+            setSpriteCues(cues);
+        })
+            .catch(() => { });
+    }, [spriteVttUrl]);
+    // Setup HLS or native playback
+    useEffect(() => {
+        const video = videoRef.current;
+        if (!video || !src)
+            return;
+        let hls = null;
+        async function setup() {
+            const isHls = src.endsWith(".m3u8");
+            if (isHls && !video.canPlayType("application/vnd.apple.mpegurl")) {
+                // Use hls.js
+                try {
+                    const HlsModule = await Function('return import("hls.js")')();
+                    const Hls = HlsModule.default ?? HlsModule;
+                    if (!Hls.isSupported()) {
+                        console.warn("[uploadbox/video] HLS.js is not supported in this browser");
+                        video.src = src;
+                        return;
+                    }
+                    hls = new Hls({ enableWorker: true });
+                    hlsRef.current = hls;
+                    hls.loadSource(src);
+                    hls.attachMedia(video);
+                    hls.on(Hls.Events.MANIFEST_PARSED, () => {
+                        const levels = hls.levels.map((level, index) => ({
+                            index,
+                            width: level.width,
+                            height: level.height,
+                            bitrate: level.bitrate,
+                            label: `${level.height}p`,
+                        }));
+                        setQualities(levels);
+                        if (autoPlay)
+                            video.play().catch(() => { });
+                    });
+                    hls.on(Hls.Events.LEVEL_SWITCHED, (_, data) => {
+                        setCurrentQualityState(data.level);
+                    });
+                }
+                catch {
+                    // hls.js not available, try native
+                    video.src = src;
+                }
+            }
+            else {
+                // Native HLS (Safari) or regular video
+                video.src = src;
+                if (autoPlay)
+                    video.play().catch(() => { });
+            }
+        }
+        setup();
+        return () => {
+            if (hls) {
+                hls.destroy();
+                hlsRef.current = null;
+            }
+        };
+    }, [src, autoPlay]);
+    // Video event listeners
+    useEffect(() => {
+        const video = videoRef.current;
+        if (!video)
+            return;
+        const onPlay = () => setIsPlaying(true);
+        const onPause = () => setIsPlaying(false);
+        const onTimeUpdate = () => setCurrentTime(video.currentTime);
+        const onDurationChange = () => setDuration(video.duration || 0);
+        const onVolumeChange = () => {
+            setVolumeState(video.volume);
+            setIsMuted(video.muted);
+        };
+        const onWaiting = () => setIsBuffering(true);
+        const onPlaying = () => setIsBuffering(false);
+        const onCanPlay = () => setIsBuffering(false);
+        video.addEventListener("play", onPlay);
+        video.addEventListener("pause", onPause);
+        video.addEventListener("timeupdate", onTimeUpdate);
+        video.addEventListener("durationchange", onDurationChange);
+        video.addEventListener("volumechange", onVolumeChange);
+        video.addEventListener("waiting", onWaiting);
+        video.addEventListener("playing", onPlaying);
+        video.addEventListener("canplay", onCanPlay);
+        // Set initial volume
+        video.volume = initialVolume;
+        return () => {
+            video.removeEventListener("play", onPlay);
+            video.removeEventListener("pause", onPause);
+            video.removeEventListener("timeupdate", onTimeUpdate);
+            video.removeEventListener("durationchange", onDurationChange);
+            video.removeEventListener("volumechange", onVolumeChange);
+            video.removeEventListener("waiting", onWaiting);
+            video.removeEventListener("playing", onPlaying);
+            video.removeEventListener("canplay", onCanPlay);
+        };
+    }, [initialVolume]);
+    // Fullscreen change listener
+    useEffect(() => {
+        const onFullscreenChange = () => {
+            setIsFullscreen(!!document.fullscreenElement);
+        };
+        document.addEventListener("fullscreenchange", onFullscreenChange);
+        return () => document.removeEventListener("fullscreenchange", onFullscreenChange);
+    }, []);
+    const play = useCallback(() => {
+        videoRef.current?.play().catch(() => { });
+    }, []);
+    const pause = useCallback(() => {
+        videoRef.current?.pause();
+    }, []);
+    const toggle = useCallback(() => {
+        const video = videoRef.current;
+        if (!video)
+            return;
+        if (video.paused)
+            video.play().catch(() => { });
+        else
+            video.pause();
+    }, []);
+    const seek = useCallback((time) => {
+        const video = videoRef.current;
+        if (video)
+            video.currentTime = time;
+    }, []);
+    const setVolume = useCallback((vol) => {
+        const video = videoRef.current;
+        if (video) {
+            video.volume = Math.max(0, Math.min(1, vol));
+            if (vol > 0)
+                video.muted = false;
+        }
+    }, []);
+    const toggleMute = useCallback(() => {
+        const video = videoRef.current;
+        if (video)
+            video.muted = !video.muted;
+    }, []);
+    const setPlaybackRate = useCallback((rate) => {
+        const video = videoRef.current;
+        if (video) {
+            video.playbackRate = rate;
+            setPlaybackRateState(rate);
+        }
+    }, []);
+    const setQuality = useCallback((index) => {
+        const hls = hlsRef.current;
+        if (hls) {
+            hls.currentLevel = index; // -1 = auto
+            setCurrentQualityState(index);
+        }
+    }, []);
+    const enterFullscreen = useCallback(() => {
+        const video = videoRef.current;
+        const container = video?.parentElement;
+        if (container?.requestFullscreen) {
+            container.requestFullscreen().catch(() => { });
+        }
+    }, []);
+    const exitFullscreen = useCallback(() => {
+        if (document.fullscreenElement) {
+            document.exitFullscreen().catch(() => { });
+        }
+    }, []);
+    const toggleFullscreen = useCallback(() => {
+        if (document.fullscreenElement)
+            exitFullscreen();
+        else
+            enterFullscreen();
+    }, [enterFullscreen, exitFullscreen]);
+    const getSpriteForTime = useCallback((time) => {
+        const cue = spriteCues.find((c) => time >= c.startTime && time < c.endTime);
+        if (!cue)
+            return null;
+        return {
+            url: cue.url,
+            x: cue.x,
+            y: cue.y,
+            width: cue.width,
+            height: cue.height,
+        };
+    }, [spriteCues]);
+    return {
+        videoRef,
+        isPlaying,
+        currentTime,
+        duration,
+        volume,
+        isMuted,
+        playbackRate,
+        qualities,
+        currentQuality,
+        isAutoQuality: currentQuality === -1,
+        isFullscreen,
+        isBuffering,
+        play,
+        pause,
+        toggle,
+        seek,
+        setVolume,
+        toggleMute,
+        setPlaybackRate,
+        setQuality,
+        enterFullscreen,
+        exitFullscreen,
+        toggleFullscreen,
+        getSpriteForTime,
+    };
+}
+/** Parse a WebVTT sprite sheet file. */
+function parseVtt(text, baseUrl) {
+    const cues = [];
+    const lines = text.split("\n");
+    const baseDir = baseUrl.substring(0, baseUrl.lastIndexOf("/") + 1);
+    let i = 0;
+    // Skip header
+    while (i < lines.length && !lines[i].includes("-->"))
+        i++;
+    while (i < lines.length) {
+        const line = lines[i].trim();
+        if (line.includes("-->")) {
+            const [startStr, endStr] = line.split("-->").map((s) => s.trim());
+            const startTime = parseVttTimestamp(startStr);
+            const endTime = parseVttTimestamp(endStr);
+            i++;
+            const dataLine = lines[i]?.trim() ?? "";
+            // Parse: sprite-sheet.jpg#xywh=0,0,160,90
+            const hashIndex = dataLine.indexOf("#xywh=");
+            if (hashIndex !== -1) {
+                const file = dataLine.substring(0, hashIndex);
+                const coords = dataLine.substring(hashIndex + 6).split(",").map(Number);
+                if (coords.length === 4) {
+                    cues.push({
+                        startTime,
+                        endTime,
+                        url: file.startsWith("http") ? file : `${baseDir}${file}`,
+                        x: coords[0],
+                        y: coords[1],
+                        width: coords[2],
+                        height: coords[3],
+                    });
+                }
+            }
+        }
+        i++;
+    }
+    return cues;
+}
+function parseVttTimestamp(ts) {
+    const parts = ts.split(":");
+    if (parts.length === 3) {
+        const [h, m, s] = parts;
+        return parseInt(h) * 3600 + parseInt(m) * 60 + parseFloat(s);
+    }
+    if (parts.length === 2) {
+        const [m, s] = parts;
+        return parseInt(m) * 60 + parseFloat(s);
+    }
+    return parseFloat(ts);
+}
+//# sourceMappingURL=use-video-player.js.map

package/dist/react/use-video-player.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+/** Extracted metadata from a video file. */
+export interface VideoMetadata {
+    /** Video width in pixels. */
+    width: number;
+    /** Video height in pixels. */
+    height: number;
+    /** Duration in seconds. */
+    durationSeconds: number;
+    /** Video codec (e.g. "h264", "vp9"). */
+    codec: string;
+    /** Frame rate (e.g. 30, 60). */
+    frameRate: number;
+    /** Video bitrate in bits per second. */
+    bitrate: number;
+    /** Audio stream information, if present. */
+    audio?: {
+        codec: string;
+        sampleRate: number;
+        channels: number;
+        bitrate: number;
+    };
+}
+/** Status of a transcoding job. */
+export type TranscodingStatus = "pending" | "processing" | "completed" | "failed";
+/** A quality preset for HLS adaptive bitrate streaming. */
+export interface QualityPreset {
+    /** Human-readable label (e.g. "720p"). */
+    label: string;
+    /** Output width in pixels. */
+    width: number;
+    /** Output height in pixels. */
+    height: number;
+    /** Target video bitrate in bits per second. */
+    videoBitrate: number;
+    /** Target audio bitrate in bits per second. */
+    audioBitrate: number;
+    /** Maximum frame rate. Source frame rate is used if lower. */
+    maxFrameRate: number;
+}
+/** Built-in quality presets for HLS transcoding. */
+export declare const QUALITY_PRESETS: Record<string, QualityPreset>;
+/** State of a transcoding job. */
+export interface TranscodingJob {
+    /** Unique identifier for this job. */
+    jobId: string;
+    /** Current status. */
+    status: TranscodingStatus;
+    /** Progress percentage (0–100). */
+    progress: number;
+    /** S3 keys for generated outputs (playlists, segments, thumbnails). */
+    outputKeys: string[];
+    /** Error message if status is "failed". */
+    error?: string;
+}
+/** Options controlling the transcoding output. */
+export interface TranscodingOptions {
+    /** 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;
+    /** S3 key prefix for output files. */
+    s3OutputPrefix: string;
+}
+/** Progress callback payload. */
+export interface TranscodingProgress {
+    /** Job identifier. */
+    jobId: string;
+    /** Overall progress percentage (0–100). */
+    percent: number;
+    /** Quality preset currently being transcoded. */
+    currentQuality?: string;
+    /** Human-readable status message. */
+    message?: string;
+}
+/** Callback invoked during transcoding to report progress. */
+export type TranscodingProgressCallback = (progress: TranscodingProgress) => void;
+/** CDN cache header presets for HLS content. */
+export declare const CDN_CACHE_HEADERS: {
+    /** HLS segments (.ts): immutable, cache for 1 year. */
+    readonly segment: "public, max-age=31536000, immutable";
+    /** HLS playlists (.m3u8): short TTL for live-like updates. */
+    readonly playlist: "public, max-age=60";
+    /** Thumbnails and sprite sheets: cache for 1 day. */
+    readonly thumbnail: "public, max-age=86400";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElF,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,oDAAoD;AACpD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAiCzD,CAAC;AAEF,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,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,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GAAG,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAElF,gDAAgD;AAChD,eAAO,MAAM,iBAAiB;IAC5B,uDAAuD;;IAEvD,8DAA8D;;IAE9D,qDAAqD;;CAE7C,CAAC"}

package/dist/types.js

@@ -0,0 +1,45 @@
+/** Built-in quality presets for HLS transcoding. */
+export const QUALITY_PRESETS = {
+    "360p": {
+        label: "360p",
+        width: 640,
+        height: 360,
+        videoBitrate: 600_000,
+        audioBitrate: 64_000,
+        maxFrameRate: 30,
+    },
+    "480p": {
+        label: "480p",
+        width: 854,
+        height: 480,
+        videoBitrate: 1_500_000,
+        audioBitrate: 128_000,
+        maxFrameRate: 30,
+    },
+    "720p": {
+        label: "720p",
+        width: 1280,
+        height: 720,
+        videoBitrate: 3_000_000,
+        audioBitrate: 128_000,
+        maxFrameRate: 60,
+    },
+    "1080p": {
+        label: "1080p",
+        width: 1920,
+        height: 1080,
+        videoBitrate: 5_000_000,
+        audioBitrate: 192_000,
+        maxFrameRate: 60,
+    },
+};
+/** CDN cache header presets for HLS content. */
+export const CDN_CACHE_HEADERS = {
+    /** HLS segments (.ts): immutable, cache for 1 year. */
+    segment: "public, max-age=31536000, immutable",
+    /** HLS playlists (.m3u8): short TTL for live-like updates. */
+    playlist: "public, max-age=60",
+    /** Thumbnails and sprite sheets: cache for 1 day. */
+    thumbnail: "public, max-age=86400",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA0CA,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAkC;IAC5D,MAAM,EAAE;QACN,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,MAAM;QACpB,YAAY,EAAE,EAAE;KACjB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,EAAE;KACjB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,GAAG;QACX,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,EAAE;KACjB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,EAAE;KACjB;CACF,CAAC;AA6CF,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,uDAAuD;IACvD,OAAO,EAAE,qCAAqC;IAC9C,8DAA8D;IAC9D,QAAQ,EAAE,oBAAoB;IAC9B,qDAAqD;IACrD,SAAS,EAAE,uBAAuB;CAC1B,CAAC"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@uploadbox/video",
+  "version": "0.4.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./hooks/video-processing": {
+      "types": "./dist/hooks/video-processing.d.ts",
+      "import": "./dist/hooks/video-processing.js"
+    },
+    "./providers/ffmpeg": {
+      "types": "./dist/providers/ffmpeg.d.ts",
+      "import": "./dist/providers/ffmpeg.js"
+    },
+    "./providers/lambda": {
+      "types": "./dist/providers/lambda.d.ts",
+      "import": "./dist/providers/lambda.js"
+    },
+    "./providers/external": {
+      "types": "./dist/providers/external.d.ts",
+      "import": "./dist/providers/external.js"
+    }
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@uploadbox/core": "0.4.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "hls.js": "^1.5.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "hls.js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0"
+  },
+  "description": "Video streaming SDK for Uploadbox — HLS transcoding, metadata extraction, and headless player hook",
+  "keywords": [
+    "uploadbox",
+    "video",
+    "hls",
+    "streaming",
+    "transcoding",
+    "s3"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/federicostarace/uploadbox",
+    "directory": "packages/video"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}