@hyperframes/engine 0.9.12 → 0.9.13

package/dist/services/videoFrameExtractor.d.ts

@@ -178,7 +178,7 @@ export interface ExtractionPhaseBreakdown {
     /** Number of per-source transient failures retried inside this extraction. */
     transientRetries?: number;
 }
-export type VideoExtractionFailureKind = "cancelled" | "external_interruption" | "source_missing" | "source_rejected" | "download_not_found" | "download_transient" | "invalid_media" | "media_start_out_of_range" | "ffmpeg_unavailable" | "ffmpeg_timeout" | "ffmpeg_transient" | "ffmpeg_failed" | "zero_output" | "internal";
+export type VideoExtractionFailureKind = "cancelled" | "external_interruption" | "source_missing" | "source_rejected" | "download_not_found" | "download_transient" | "invalid_media" | "media_start_out_of_range" | "ffmpeg_unavailable" | "ffmpeg_timeout" | "ffmpeg_transient" | "ffmpeg_failed" | "disk_full" | "zero_output" | "internal";
 export interface VideoExtractionFailure {
     videoId: string;
     /** Always populated by this engine version; optional for source compatibility with older consumers. */

package/dist/services/videoFrameExtractor.js

@@ -259,6 +259,8 @@ function ffmpegReasonFrom(stderr, paths) {
         .join(" | ")
         .slice(-FFMPEG_REASON_CHARS);
 }
+// ffmpeg ends a full disk with its last frames' summary, so the strerror text is the only sign of it
+const DISK_FULL = /no space left on device|disk quota exceeded/i;
 export function isVideoSourceExtractionError(error) {
     return (typeof error === "object" &&
         error !== null &&
@@ -879,7 +881,7 @@ outputDirOverride) {
         !processResult.success &&
         !processResult.failureReason;
     const videoToolboxWasOptional = decodeWithVideoToolbox && !keepsHdrForChrome;
-    if (ffmpegExitedFailing && videoToolboxWasOptional)
+    if (ffmpegExitedFailing && videoToolboxWasOptional && !DISK_FULL.test(processResult.stderr))
         processResult = await extract([]);
     if (processResult.failureReason === "external_interruption") {
         throw new VideoSourceExtractionError("external_interruption", true, "Video frame extraction interrupted by host lifecycle", `FFmpeg exited with code ${processResult.exitCode}: ${processResult.stderr.slice(-500)}`);
@@ -910,6 +912,9 @@ outputDirOverride) {
         if (timedOut) {
             throw new VideoSourceExtractionError("ffmpeg_timeout", true, "Video frame extraction timed out", diagnostic, ffmpegReason);
         }
+        if (DISK_FULL.test(processResult.stderr)) {
+            throw new VideoSourceExtractionError("disk_full", false, "The disk filled up while video frames were extracted", diagnostic, ffmpegReason);
+        }
         const transientIo = /resource temporarily unavailable|device or resource busy|input\/output error/i.test(processResult.stderr);
         throw new VideoSourceExtractionError(transientIo ? "ffmpeg_transient" : "ffmpeg_failed", transientIo, transientIo
             ? "Video frame extraction hit a transient I/O failure"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.9.12",
+  "version": "0.9.13",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -9,6 +9,8 @@
   },
   "files": [
     "dist",
+    "!dist/services/__fixtures__/blurDifferential.*",
+    "!dist/services/__fixtures__/motionBlur",
     "README.md"
   ],
   "type": "module",
@@ -59,8 +61,8 @@
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
     "undici": "7.25.0",
-    "@hyperframes/core": "^0.9.12",
-    "@hyperframes/parsers": "^0.9.12"
+    "@hyperframes/parsers": "^0.9.13",
+    "@hyperframes/core": "^0.9.13"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",