@nebutra/video-compose 0.2.2 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/video-compose",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Pure timeline / edit-decision-list builder + provider-agnostic video compositor (concat, crossfade transitions, mux). Zero-config deterministic mock default; ffmpeg adapter documented.",
   "private": false,
   "license": "MIT",
@@ -10,13 +10,17 @@
     "category": "integrations",
     "summary": "Timeline builder + multi-tenant video compositor abstraction"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.2",
+    "@nebutra/capability-kit": "0.2.4",
     "@nebutra/provider-factory": "0.2.2"
   },
   "devDependencies": {
@@ -37,6 +41,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,17 +0,0 @@
-
-> @nebutra/video-compose@0.2.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/video-compose
-> tsup
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/video-compose/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js     2.87 KB
-ESM dist/index.js.map 6.72 KB
-ESM ⚡️ Build success in 10ms
-DTS Build start
-DTS ⚡️ Build success in 2721ms
-DTS dist/index.d.ts 2.49 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/video-compose@0.2.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/video-compose
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/video-compose
-
- ✓ src/__tests__/video-compose.test.ts (9 tests) 10ms
-
- Test Files  1 passed (1)
-      Tests  9 passed (9)
-   Start at  09:38:36
-   Duration  270ms (transform 44ms, setup 0ms, import 60ms, tests 10ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/video-compose@0.2.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/video-compose
-> tsc --noEmit
-

package/src/__tests__/video-compose.test.ts

@@ -1,67 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { composeTimeline, getVideoCompose, MockCompositor, VideoComposeError } from "../index";
-
-const clips = [
-  { uri: "mp4:a", durationSec: 4 },
-  { uri: "mp4:b", durationSec: 6 },
-  { uri: "mp4:c", durationSec: 2 },
-];
-
-describe("composeTimeline", () => {
-  it("concatenates: cumulative starts, total = sum", () => {
-    const t = composeTimeline(clips);
-    expect(t.totalDurationSec).toBe(12);
-    expect(t.segments.map((s) => s.startSec)).toEqual([0, 4, 10]);
-    expect(t.segments.map((s) => s.uri)).toEqual(["mp4:a", "mp4:b", "mp4:c"]);
-  });
-
-  it("crossfade overlaps each next clip, shortening the total", () => {
-    const t = composeTimeline(clips, { crossfadeSec: 1 });
-    // total = 12 - 1*(3-1) = 10; starts overlap by the crossfade
-    expect(t.totalDurationSec).toBe(10);
-    expect(t.segments.map((s) => s.startSec)).toEqual([0, 3, 8]);
-    expect(t.segments[1]?.transitionInSec).toBe(1);
-    expect(t.segments[0]?.transitionInSec ?? 0).toBe(0);
-  });
-
-  it("starts are strictly monotonic", () => {
-    const t = composeTimeline(clips, { crossfadeSec: 1.5 });
-    for (let i = 1; i < t.segments.length; i++) {
-      expect(t.segments[i]!.startSec).toBeGreaterThan(t.segments[i - 1]!.startSec);
-    }
-  });
-
-  it("rejects empty clip list", () => {
-    expect(() => composeTimeline([])).toThrow(VideoComposeError);
-  });
-
-  it("rejects a crossfade not shorter than the shortest clip", () => {
-    expect(() => composeTimeline(clips, { crossfadeSec: 2 })).toThrow(/crossfade/i);
-  });
-});
-
-describe("MockCompositor", () => {
-  it("renders a deterministic descriptor whose duration matches the timeline", async () => {
-    const t = composeTimeline(clips);
-    const c = new MockCompositor();
-    const a = await c.render(t);
-    const b = await c.render(t);
-    expect(a).toEqual(b);
-    expect(a.durationSec).toBe(12);
-    expect(a.uri.startsWith("data:video/")).toBe(true);
-  });
-  it("health() ok", async () => {
-    expect((await new MockCompositor().health()).ok).toBe(true);
-  });
-});
-
-describe("getVideoCompose", () => {
-  it("zero-config → working mock compositor", async () => {
-    const vc = await getVideoCompose();
-    const out = await vc.render(composeTimeline(clips));
-    expect(out.uri.startsWith("data:video/")).toBe(true);
-  });
-  it("ffmpeg provider is a fail-loud stub until landed", async () => {
-    await expect(getVideoCompose({ provider: "ffmpeg" })).rejects.toBeInstanceOf(VideoComposeError);
-  });
-});

package/src/index.ts

@@ -1,141 +0,0 @@
-/**
- * @nebutra/video-compose — the video-pipeline assembly gap.
- *
- * `composeTimeline` is pure (an edit-decision list: ordered segments +
- * crossfade math + total duration) so the assembly logic is unit-testable
- * with no ffmpeg binary. The `VideoCompositor` that actually renders is a
- * provider abstraction: a deterministic zero-config mock is the active
- * default; a real ffmpeg adapter is selected via the shared provider pattern
- * and fails loud until landed (stub lifecycle).
- */
-
-import { CapabilityError } from "@nebutra/capability-kit";
-import { resolveProviderType } from "@nebutra/provider-factory";
-
-export class VideoComposeError extends CapabilityError {
-  constructor(message: string, init: { code: string; suggestion: string; cause?: unknown }) {
-    super(message, init, {
-      name: "VideoComposeError",
-      emptySuggestionFallback:
-        "No suggestion was provided. This is a bug in @nebutra/video-compose — report it.",
-    });
-  }
-}
-
-export interface Clip {
-  readonly uri: string;
-  readonly durationSec: number;
-}
-
-export interface TimelineSegment {
-  readonly uri: string;
-  readonly startSec: number;
-  readonly durationSec: number;
-  /** Crossfade-in length from the previous segment (0 for the first). */
-  readonly transitionInSec: number;
-}
-
-export interface Timeline {
-  readonly segments: readonly TimelineSegment[];
-  readonly totalDurationSec: number;
-}
-
-export interface ComposeOptions {
-  /** Crossfade overlap between adjacent clips; must be < shortest clip. */
-  readonly crossfadeSec?: number;
-}
-
-/** Build the edit-decision list. Pure; no I/O. */
-export function composeTimeline(clips: readonly Clip[], opts: ComposeOptions = {}): Timeline {
-  if (clips.length === 0) {
-    throw new VideoComposeError("Cannot compose a timeline from zero clips.", {
-      code: "VC_NO_CLIPS",
-      suggestion: "Pass at least one rendered clip.",
-    });
-  }
-  const cf = opts.crossfadeSec ?? 0;
-  if (cf < 0) {
-    throw new VideoComposeError("crossfadeSec must be non-negative.", {
-      code: "VC_BAD_CROSSFADE",
-      suggestion: "Use a crossfade ≥ 0 and strictly shorter than the shortest clip.",
-    });
-  }
-  const shortest = Math.min(...clips.map((c) => c.durationSec));
-  if (cf > 0 && cf >= shortest) {
-    throw new VideoComposeError(
-      `crossfadeSec (${cf}) must be shorter than the shortest clip (${shortest}).`,
-      {
-        code: "VC_CROSSFADE_TOO_LONG",
-        suggestion: "Reduce the crossfade or remove clips shorter than it.",
-      },
-    );
-  }
-
-  const segments: TimelineSegment[] = [];
-  let cursor = 0;
-  clips.forEach((clip, i) => {
-    const transitionInSec = i === 0 ? 0 : cf;
-    const startSec = i === 0 ? 0 : cursor - cf;
-    segments.push({ uri: clip.uri, startSec, durationSec: clip.durationSec, transitionInSec });
-    cursor = startSec + clip.durationSec;
-  });
-
-  return { segments, totalDurationSec: cursor };
-}
-
-export type VideoComposeProviderType = "mock" | "ffmpeg";
-
-export interface VideoCompositor {
-  readonly name: VideoComposeProviderType;
-  render(timeline: Timeline): Promise<{ uri: string; durationSec: number }>;
-  health(): Promise<{ ok: boolean; detail: string }>;
-}
-
-function hash(s: string): string {
-  let h = 2166136261;
-  for (let i = 0; i < s.length; i++) {
-    h ^= s.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return (h >>> 0).toString(36);
-}
-
-/** Deterministic zero-config compositor (no ffmpeg). */
-export class MockCompositor implements VideoCompositor {
-  readonly name = "mock" as const;
-
-  async render(timeline: Timeline): Promise<{ uri: string; durationSec: number }> {
-    const sig = hash(
-      timeline.segments.map((s) => `${s.uri}@${s.startSec}+${s.transitionInSec}`).join("|"),
-    );
-    return {
-      uri: `data:video/x-nebutra-mock;base64,${Buffer.from(sig).toString("base64")}`,
-      durationSec: timeline.totalDurationSec,
-    };
-  }
-
-  async health(): Promise<{ ok: boolean; detail: string }> {
-    return { ok: true, detail: "mock compositor: deterministic, zero-config" };
-  }
-}
-
-export interface VideoComposeConfig {
-  readonly provider?: VideoComposeProviderType;
-}
-
-/** Resolve a compositor. Zero-config → mock; ffmpeg is a fail-loud stub. */
-export async function getVideoCompose(config?: VideoComposeConfig): Promise<VideoCompositor> {
-  const type = resolveProviderType<VideoComposeProviderType>({
-    explicit: config?.provider,
-    envVarName: "VIDEO_COMPOSE_PROVIDER",
-    detectors: [],
-    fallback: "mock",
-  });
-  if (type === "mock") return new MockCompositor();
-  throw new VideoComposeError(`The "${type}" compositor is not implemented yet.`, {
-    code: "VC_PROVIDER_UNIMPLEMENTED",
-    suggestion:
-      "Implement the ffmpeg adapter (render via fluent-ffmpeg/child_process + " +
-      "health) and register it here, or use the zero-config mock compositor.",
-  });
-}

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "incremental": false
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts"],
-  format: ["esm"],
-  dts: true,
-  clean: true,
-  sourcemap: true,
-  target: "es2022",
-});