simple-ffmpegjs 0.5.2 → 0.5.4

package/README.md

@@ -4,8 +4,11 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/simple-ffmpegjs"><img src="https://img.shields.io/npm/v/simple-ffmpegjs.svg" alt="npm version"></a>
+  <a href="https://github.com/Fats403/simple-ffmpeg/actions/workflows/ci.yml"><img src="https://github.com/Fats403/simple-ffmpeg/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node.js ≥18"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="Node.js ≥20"></a>
+  <a href="https://codecov.io/gh/Fats403/simple-ffmpegjs"><img src="https://codecov.io/gh/Fats403/simple-ffmpegjs/branch/main/graph/badge.svg" alt="Coverage"></a>
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen.svg" alt="Zero Dependencies">
 </p>
 
 <p align="center">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-ffmpegjs",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Declarative video composition for Node.js — define clips, transitions, text, and audio as simple objects, and let FFmpeg handle the rest.",
   "author": "Brayden Blackwell <braydenblackwell21@gmail.com> (https://github.com/Fats403)",
   "license": "MIT",
@@ -33,13 +33,16 @@
   ],
   "sideEffects": false,
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
     "test:unit": "vitest run tests/unit",
-    "test:integration": "vitest run tests/integration"
+    "test:integration": "vitest run tests/integration",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   },
   "keywords": [
     "ffmpeg",
@@ -73,6 +76,10 @@
     "nodejs"
   ],
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.9.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^10.0.2",
     "vitest": "^3.0.0"
   }
 }

package/src/core/media_info.js

@@ -114,7 +114,7 @@ async function probeMedia(filePath) {
   } catch (error) {
     throw new MediaNotFoundError(
       `Failed to probe "${filePath}": ${error.message}`,
-      { path: filePath }
+      { path: filePath },
     );
   }
 
@@ -124,14 +124,14 @@ async function probeMedia(filePath) {
   } catch (parseError) {
     throw new MediaNotFoundError(
       `Invalid JSON response from ffprobe for "${filePath}": ${parseError.message}`,
-      { path: filePath }
+      { path: filePath },
     );
   }
 
   if (!metadata || !Array.isArray(metadata.streams)) {
     throw new MediaNotFoundError(
       `Invalid metadata structure for "${filePath}": missing or invalid 'streams' array`,
-      { path: filePath }
+      { path: filePath },
     );
   }
 
@@ -147,8 +147,8 @@ async function probeMedia(filePath) {
   const duration = Number.isFinite(formatDuration)
     ? formatDuration
     : Number.isFinite(streamDuration)
-    ? streamDuration
-    : null;
+      ? streamDuration
+      : null;
 
   // ── FPS ─────────────────────────────────────────────────────────────────
   // Prefer avg_frame_rate, fall back to r_frame_rate

package/src/core/resolve.js

@@ -11,6 +11,10 @@
  *    `position`, it is placed immediately after the previous clip on the
  *    same track (visual or audio). The first clip defaults to position 0.
  *
+ * 3. **fullDuration**: If an effect or text clip has `fullDuration: true`,
+ *    its position defaults to 0 and end is resolved later in _prepareExport()
+ *    once the visual timeline duration is known.
+ *
  * Clips are shallow-cloned — the caller's original objects are not mutated.
  */
 
@@ -48,6 +52,35 @@ function resolveClips(clips) {
     const c = { ...clip };
     const path = `clips[${index}]`;
 
+    // ── fullDuration shorthand ─────────────────────────────────────────
+    if (c.fullDuration === true) {
+      if (c.end != null) {
+        errors.push({
+          code: "INVALID_VALUE",
+          path: `${path}`,
+          message:
+            "Cannot specify both 'fullDuration' and 'end'. fullDuration spans the entire visual timeline automatically.",
+          received: { fullDuration: true, end: c.end },
+        });
+        return c;
+      }
+      if (c.duration != null) {
+        errors.push({
+          code: "INVALID_VALUE",
+          path: `${path}`,
+          message:
+            "Cannot specify both 'fullDuration' and 'duration'. fullDuration spans the entire visual timeline automatically.",
+          received: { fullDuration: true, duration: c.duration },
+        });
+        return c;
+      }
+      // Default position to 0; end is resolved in _prepareExport()
+      if (c.position == null) {
+        c.position = 0;
+      }
+      return c;
+    }
+
     // ── Conflict check: duration + end ──────────────────────────────────
     if (c.duration != null && c.end != null) {
       errors.push({

package/src/core/rotation.js

@@ -51,7 +51,7 @@ function unrotateVideo(inputUrl, options = {}) {
         new FFmpegError(`ffmpeg process error: ${error.message}`, {
           stderr,
           command: `ffmpeg ${args.join(" ")}`,
-        })
+        }),
       );
     });
 
@@ -65,8 +65,8 @@ function unrotateVideo(inputUrl, options = {}) {
             {
               stderr,
               command: `ffmpeg ${args.join(" ")}`,
-            }
-          )
+            },
+          ),
         );
         return;
       }
@@ -81,7 +81,7 @@ function unrotateVideo(inputUrl, options = {}) {
             stderr,
             command: `ffmpeg ${args.join(" ")}`,
             exitCode: code,
-          })
+          }),
         );
         return;
       }