@nodetool-ai/websocket 0.7.0-rc.22 → 0.8.1

package/dist/lib/timeline-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-bundle.d.ts","sourceRoot":"","sources":["../../src/lib/timeline-bundle.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAKzC,wEAAwE;AACxE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,2EAA2E;IAC3E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4EAA4E;IAC5E,YAAY,EAAE,yBAAyB,CAAC;CACzC;AAcD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAY7E;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAQ1E;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,sBAAsB,GAC1B,yBAAyB,CAuB3B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,sBAAsB,EACtE,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,CAAC,CAiBH;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,eAAe,CAAC;IAC1B,oEAAoE;IACpE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAwDjC;AAED,uEAAuE;AACvE,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,EAAE,eAAe,CAAC;IAC1B,wDAAwD;IACxD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACjC;AAOD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,GACnB,sBAAsB,CAiExB;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,CAqBV;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,UAAU,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,+EAA+E;IAC/E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA6DrC"}

package/dist/lib/timeline-bundle.js

@@ -0,0 +1,330 @@
+/**
+ * Timeline bundle codec — a portable zip holding one timeline document plus the
+ * bytes of every asset its clips point at, so a cut can move between installs
+ * instead of arriving with dangling `currentAssetId`s.
+ *
+ * Layout (a zip):
+ *   manifest.json   — format/version, the id → file table, checksums, the font
+ *                     families the document names, and the ids it references
+ *                     but does not carry
+ *   timeline.json   — the sequence wire shape minus id/project/user/timestamps
+ *   assets/<sha256><ext> — content-addressed asset bytes, deduped
+ *
+ * Asset ids stay in their own fields inside `timeline.json` (they are bare ids,
+ * not media refs, so the `bundle://` rewrite the workflow bundle performs does
+ * not apply here). The manifest's `assets[].asset_id` is what maps an id in the
+ * document to the file carrying its bytes; import stores each file and rewrites
+ * the four id fields to the newly created assets.
+ *
+ * The codec is storage-agnostic: the caller supplies `fetchAsset` on the way out
+ * and `storeAsset` on the way in, so the same functions serve the HTTP route and
+ * a test with an in-memory adapter.
+ */
+import { createHash } from "node:crypto";
+import { strFromU8, strToU8, unzipSync } from "fflate";
+import { z } from "zod";
+import { timelineDocument } from "@nodetool-ai/protocol/api-schemas/timeline.js";
+import { getAssetFileName } from "./asset-paths.js";
+import { collectZip, exportSourceSize, MAX_ZIP_ENTRY_BYTES, sha256OfSource } from "./zip-stream.js";
+export const TIMELINE_BUNDLE_FORMAT = "nodetool-timeline-bundle";
+export const TIMELINE_BUNDLE_VERSION = 1;
+const TIMELINE_ENTRY = "timeline.json";
+const ASSETS_PREFIX = "assets/";
+/** The timeline payload carried in a bundle (no per-user/db fields). */
+export const bundledTimeline = timelineDocument.extend({
+    name: z.string().min(1),
+    fps: z.number(),
+    width: z.number(),
+    height: z.number(),
+    durationMs: z.number(),
+    workflowId: z.string().optional()
+});
+function sha256Hex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function pushUnique(into, seen, value) {
+    if (typeof value !== "string" || value === "" || seen.has(value)) {
+        return;
+    }
+    seen.add(value);
+    into.push(value);
+}
+/**
+ * Every asset id the document points at, in document order, deduped. These are
+ * the only fields import rewrites — anything else stays as written.
+ */
+export function collectTimelineAssetIds(doc) {
+    const ids = [];
+    const seen = new Set();
+    for (const clip of doc.clips ?? []) {
+        pushUnique(ids, seen, clip.currentAssetId);
+        pushUnique(ids, seen, clip.thumbnailAssetId);
+        pushUnique(ids, seen, clip.waveformAssetId);
+        for (const version of clip.versions ?? []) {
+            pushUnique(ids, seen, version.assetId);
+        }
+    }
+    return ids;
+}
+/** Font families the document names, so a reader knows what it needs installed. */
+export function collectTimelineFonts(doc) {
+    const fonts = [];
+    const seen = new Set();
+    for (const clip of doc.clips ?? []) {
+        pushUnique(fonts, seen, clip.textStyle?.fontFamily);
+        pushUnique(fonts, seen, clip.caption?.style?.fontFamily);
+    }
+    return fonts;
+}
+/** Ids that resolve only on the exporting install; carried for information. */
+export function collectTimelineForeignRefs(doc) {
+    const refs = {
+        workflow_ids: [],
+        storyboard_ids: [],
+        script_ids: [],
+        job_ids: []
+    };
+    const seen = {
+        workflow: new Set(),
+        storyboard: new Set(),
+        script: new Set(),
+        job: new Set()
+    };
+    pushUnique(refs.workflow_ids, seen.workflow, doc.workflowId);
+    for (const clip of doc.clips ?? []) {
+        pushUnique(refs.workflow_ids, seen.workflow, clip.workflowId);
+        pushUnique(refs.storyboard_ids, seen.storyboard, clip.storyboardBoardId);
+        pushUnique(refs.script_ids, seen.script, clip.scriptId);
+        for (const version of clip.versions ?? []) {
+            pushUnique(refs.job_ids, seen.job, version.jobId);
+        }
+    }
+    return refs;
+}
+/**
+ * A copy of `doc` with every asset id present in `map` replaced. An id the map
+ * does not name is left alone — that is how a missing asset stays dangling
+ * instead of silently pointing at someone else's bytes.
+ */
+export function rewriteTimelineAssetIds(doc, map) {
+    const clone = structuredClone(doc);
+    const rewrite = (id) => typeof id === "string" ? (map.get(id) ?? id) : id;
+    for (const clip of clone.clips ?? []) {
+        if (clip.currentAssetId)
+            clip.currentAssetId = rewrite(clip.currentAssetId);
+        if (clip.thumbnailAssetId) {
+            clip.thumbnailAssetId = rewrite(clip.thumbnailAssetId);
+        }
+        if (clip.waveformAssetId) {
+            clip.waveformAssetId = rewrite(clip.waveformAssetId);
+        }
+        for (const version of clip.versions ?? []) {
+            if (version.assetId)
+                version.assetId = rewrite(version.assetId);
+        }
+    }
+    return clone;
+}
+/**
+ * Write a timeline zip to `writer`, embedding every asset its clips name.
+ * A local file is hashed and then streamed from disk, so no asset is held in
+ * memory whole. Returns the manifest, which is written last.
+ */
+export async function writeTimelineBundle(options, writer) {
+    const { sequence } = options;
+    const written = new Set();
+    const assets = [];
+    const missing = [];
+    for (const assetId of collectTimelineAssetIds(sequence)) {
+        const fetched = await options.fetchAsset(assetId);
+        const size = fetched ? exportSourceSize(fetched.source) : 0;
+        if (!fetched || size > MAX_ZIP_ENTRY_BYTES) {
+            // An asset the install no longer has does not fail the export: the id is
+            // recorded so the far side can say what it is missing. So is a file too
+            // large for a zip entry without Zip64.
+            missing.push(assetId);
+            continue;
+        }
+        const sha256 = await sha256OfSource(fetched.source);
+        const file = `${ASSETS_PREFIX}${getAssetFileName(sha256, fetched.contentType)}`;
+        // Content-addressed, so two ids sharing bytes pack one file and get two
+        // manifest rows pointing at it.
+        if (!written.has(file)) {
+            written.add(file);
+            await writer.add(file, fetched.source);
+        }
+        assets.push({
+            file,
+            asset_id: assetId,
+            name: fetched.name,
+            content_type: fetched.contentType,
+            bytes: size,
+            sha256
+        });
+    }
+    const manifest = {
+        format: TIMELINE_BUNDLE_FORMAT,
+        version: TIMELINE_BUNDLE_VERSION,
+        created_at: new Date().toISOString(),
+        timeline: { file: TIMELINE_ENTRY, name: sequence.name },
+        assets,
+        missing_assets: missing,
+        fonts: collectTimelineFonts(sequence),
+        foreign_refs: collectTimelineForeignRefs(sequence)
+    };
+    await writer.add(TIMELINE_ENTRY, strToU8(JSON.stringify(sequence, null, 2)), {
+        compress: true
+    });
+    await writer.add("manifest.json", strToU8(JSON.stringify(manifest, null, 2)), {
+        compress: true
+    });
+    return manifest;
+}
+/** Build a timeline zip in memory. The HTTP export streams instead. */
+export async function packTimelineBundle(options) {
+    const written = {};
+    const bytes = await collectZip(async (writer) => {
+        written.manifest = await writeTimelineBundle(options, writer);
+    });
+    if (!written.manifest)
+        throw new Error("Timeline bundle wrote no manifest");
+    return { bytes, manifest: written.manifest };
+}
+/** Max total decompressed size of a bundle — guards against zip bombs. */
+const MAX_BUNDLE_UNCOMPRESSED_BYTES = 512 * 1024 * 1024; // 512 MB
+/** Max number of entries in a bundle. */
+const MAX_BUNDLE_ENTRIES = 10_000;
+export function unpackTimelineBundle(zipBytes) {
+    // Bound decompression: `unzipSync` otherwise inflates every entry into memory
+    // with no size limit, so a small highly-compressible upload can expand to tens
+    // of GB and OOM the server. The filter runs per entry with the
+    // header-declared uncompressed size, before that entry is inflated.
+    let totalUncompressed = 0;
+    let entryCount = 0;
+    const entries = unzipSync(zipBytes, {
+        filter: (file) => {
+            entryCount += 1;
+            if (entryCount > MAX_BUNDLE_ENTRIES) {
+                throw new Error(`Bundle rejected: too many entries (limit ${MAX_BUNDLE_ENTRIES})`);
+            }
+            totalUncompressed += file.originalSize;
+            if (totalUncompressed > MAX_BUNDLE_UNCOMPRESSED_BYTES) {
+                throw new Error(`Bundle rejected: decompressed size exceeds ${MAX_BUNDLE_UNCOMPRESSED_BYTES} bytes`);
+            }
+            return true;
+        }
+    });
+    const manifestEntry = entries["manifest.json"];
+    if (!manifestEntry) {
+        throw new Error("Invalid bundle: missing manifest.json");
+    }
+    const manifest = JSON.parse(strFromU8(manifestEntry));
+    if (manifest.format !== TIMELINE_BUNDLE_FORMAT) {
+        throw new Error(`Unrecognized bundle format: ${String(manifest.format)}`);
+    }
+    if (manifest.version > TIMELINE_BUNDLE_VERSION) {
+        throw new Error(`Bundle version ${manifest.version} is newer than supported (${TIMELINE_BUNDLE_VERSION})`);
+    }
+    const timelineFile = manifest.timeline?.file || TIMELINE_ENTRY;
+    const timelineEntry = entries[timelineFile];
+    if (!timelineEntry) {
+        throw new Error(`Invalid bundle: missing ${timelineFile}`);
+    }
+    const timeline = JSON.parse(strFromU8(timelineEntry));
+    if (!Array.isArray(timeline?.tracks) ||
+        !Array.isArray(timeline?.clips) ||
+        !Array.isArray(timeline?.markers)) {
+        throw new Error(`Invalid bundle: ${timelineFile} has no tracks, clips, and markers arrays`);
+    }
+    const assets = new Map();
+    for (const [path, bytes] of Object.entries(entries)) {
+        if (path.startsWith(ASSETS_PREFIX)) {
+            assets.set(path.slice(ASSETS_PREFIX.length), bytes);
+        }
+    }
+    return { manifest, timeline, assets };
+}
+/** Verify each asset's bytes against the manifest sha256. Returns mismatches. */
+export function verifyTimelineBundleChecksums(bundle) {
+    const mismatches = [];
+    const checked = new Set();
+    for (const entry of bundle.manifest.assets ?? []) {
+        const fileName = entry.file.startsWith(ASSETS_PREFIX)
+            ? entry.file.slice(ASSETS_PREFIX.length)
+            : entry.file;
+        if (checked.has(fileName)) {
+            continue; // deduped bytes, hashed once
+        }
+        checked.add(fileName);
+        const bytes = bundle.assets.get(fileName);
+        if (!bytes) {
+            mismatches.push(`${entry.file} (missing)`);
+            continue;
+        }
+        if (entry.sha256 && sha256Hex(bytes) !== entry.sha256) {
+            mismatches.push(`${entry.file} (checksum)`);
+        }
+    }
+    return mismatches;
+}
+/**
+ * Store a bundle's assets and return a timeline ready to create. Assets shared
+ * by several ids are stored once; an id with no bytes keeps its original value
+ * and is reported in `missing`.
+ */
+export async function importTimelineBundle(zipBytes, options) {
+    const bundle = unpackTimelineBundle(zipBytes);
+    const checksumMismatches = verifyTimelineBundleChecksums(bundle);
+    if (options.verifyChecksums && checksumMismatches.length > 0) {
+        throw new Error(`Bundle checksum verification failed: ${checksumMismatches.join(", ")}`);
+    }
+    const imported = [];
+    const missing = new Set(bundle.manifest.missing_assets ?? []);
+    const idMap = new Map();
+    const storedByFile = new Map();
+    for (const entry of bundle.manifest.assets ?? []) {
+        const fileName = entry.file.startsWith(ASSETS_PREFIX)
+            ? entry.file.slice(ASSETS_PREFIX.length)
+            : entry.file;
+        const bytes = bundle.assets.get(fileName);
+        if (!bytes) {
+            missing.add(entry.asset_id);
+            continue;
+        }
+        let assetId = storedByFile.get(fileName);
+        if (!assetId) {
+            const stored = await options.storeAsset({
+                bytes,
+                name: entry.name || fileName,
+                contentType: entry.content_type || "application/octet-stream",
+                sourceAssetId: entry.asset_id
+            });
+            assetId = stored.assetId;
+            storedByFile.set(fileName, assetId);
+            // One row per stored file, so `imported.length` is what was written.
+            imported.push({
+                file: entry.file,
+                source_asset_id: entry.asset_id,
+                asset_id: assetId
+            });
+        }
+        idMap.set(entry.asset_id, assetId);
+    }
+    // Validate at the boundary — the same gate the tRPC `update` applies, so an
+    // uploaded document cannot smuggle fields the editor would then write back.
+    const validated = bundledTimeline.parse(bundle.timeline);
+    const timeline = rewriteTimelineAssetIds(validated, idMap);
+    // An id the document names that no manifest row covered has no bytes here.
+    for (const id of collectTimelineAssetIds(bundle.timeline)) {
+        if (!idMap.has(id)) {
+            missing.add(id);
+        }
+    }
+    return {
+        timeline,
+        imported,
+        missing: [...missing],
+        checksumMismatches
+    };
+}
+//# sourceMappingURL=timeline-bundle.js.map

package/dist/lib/timeline-bundle.js.map

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

package/dist/lib/video-proxy.d.ts

@@ -0,0 +1,114 @@
+import { Asset } from "@nodetool-ai/models";
+/** Setting (and env var): the source size, in pixels of its longer side, at which a proxy is made after import. */
+export declare const VIDEO_PROXY_MIN_SIZE_SETTING = "NODETOOL_VIDEO_PROXY_MIN_SIZE_PX";
+/** Default: sources of 1920 px (1080p) and larger get a proxy. */
+export declare const DEFAULT_VIDEO_PROXY_MIN_SIZE_PX = 1920;
+/** The proxy's longer side. */
+export declare const PROXY_LONG_SIDE_PX = 960;
+export type VideoProxyStatus = "none" | "queued" | "running" | "ready" | "failed";
+/** What {@link videoProxyState} tells the asset response. */
+export interface VideoProxyState {
+    status: VideoProxyStatus;
+    /** The proxy's storage key, when ready. */
+    key: string | null;
+    /** A short hash of the source version, for the proxy URL's `?v=`. */
+    version: string | null;
+}
+/** Every file a proxy can leave in the owner's folder. Asset delete removes them. */
+export declare function videoProxyFileNames(assetId: string): string[];
+/**
+ * Whether this server makes proxies: the local file store, outside
+ * production (the same gate as external assets, D6).
+ */
+export declare function videoProxiesAvailable(): boolean;
+/**
+ * The longer-side size, in pixels, at or above which an imported video gets a
+ * proxy. Read from the settings table, then the environment. `0` proxies every
+ * video, a negative value turns background proxies off, and a missing or
+ * non-numeric value falls back to the default. `ensureProxy` ignores it.
+ */
+export declare function getVideoProxyMinSizePx(): Promise<number>;
+/** The row fields a proxy depends on. */
+type ProxyAssetFields = Pick<Asset, "id" | "user_id" | "content_type" | "external_path" | "metadata">;
+/**
+ * The proxy state of a video asset, or null when proxies do not apply (not a
+ * video, or not a local server). A proxy made from another version of the
+ * source file is not ready.
+ */
+export declare function videoProxyState(asset: ProxyAssetFields): Promise<VideoProxyState | null>;
+export interface VideoProbe {
+    width: number;
+    height: number;
+    /** The denominator of the stream time base, when it is a whole number. */
+    timescale: number | null;
+}
+/** The first video stream's size, or null when the file has none. */
+export declare function probeVideo(filePath: string): Promise<VideoProbe | null>;
+/**
+ * Encode `input` into an all-intra preview proxy at `output`. Answers the
+ * codec and size written. Throws {@link MediaToolingMissingError} when ffmpeg
+ * is missing, and an AbortError when `signal` aborts.
+ */
+export declare function encodeVideoProxy(input: string, output: string, probe: VideoProbe, signal?: AbortSignal): Promise<{
+    codec: "h264" | "vp9";
+}>;
+export interface VideoProxyJob {
+    assetId: string;
+    userId: string;
+    /** Made at any size: an explicit request ignores the threshold. */
+    force: boolean;
+}
+/** What a job did, for logs and tests. */
+export type VideoProxyOutcome = "created" | "ready" | "skipped" | "gone" | "failed";
+export interface VideoProxyResult {
+    outcome: VideoProxyOutcome;
+    /** The source version the job read, recorded on a failure. */
+    sourceVersion: string | null;
+}
+export type VideoProxyRunner = (job: VideoProxyJob, signal: AbortSignal) => Promise<VideoProxyResult>;
+/**
+ * Runs proxy jobs one at a time, in order. A job already waiting for the same
+ * asset is not queued twice (an explicit request upgrades it to `force`). A
+ * failure is remembered per source version, so an import retrying the same
+ * file does not encode it again. `ensureProxy` clears it.
+ */
+export declare class VideoProxyQueue {
+    private readonly runner;
+    private readonly pending;
+    private running;
+    private readonly failures;
+    private readonly idleWaiters;
+    constructor(runner: VideoProxyRunner);
+    enqueue(job: VideoProxyJob): void;
+    /** `queued` or `running` for a job in flight, `failed` when this version failed. */
+    status(assetId: string, version: string): "queued" | "running" | "failed" | null;
+    clearFailure(assetId: string): void;
+    /** Drop a waiting job for the asset and stop its encode if it is running. */
+    cancel(assetId: string): void;
+    /** Resolves once no job is waiting or running. */
+    idle(): Promise<void>;
+    private pump;
+    private notifyIfIdle;
+}
+/**
+ * One job: read the row again (it may have been deleted or relinked while
+ * queued), skip a source below the threshold unless forced, encode next to
+ * the final file, move it into place, and write the manifest last, so a proxy
+ * is never ready half-written.
+ */
+export declare function runVideoProxyJob(job: VideoProxyJob, signal: AbortSignal): Promise<VideoProxyResult>;
+/** The server's proxy queue. */
+export declare const videoProxyQueue: VideoProxyQueue;
+/**
+ * Queue a proxy for a video just imported or relinked. Returns at once: the
+ * job probes the size against the threshold in the background. Does nothing
+ * for other content or off the local store.
+ */
+export declare function scheduleVideoProxy(asset: Pick<Asset, "id" | "user_id" | "content_type">): void;
+/**
+ * Remove an asset's proxy and stop any job for it. Asset delete and relink
+ * call this; relink queues a new proxy afterwards.
+ */
+export declare function discardVideoProxy(asset: Pick<Asset, "id" | "user_id">): Promise<void>;
+export {};
+//# sourceMappingURL=video-proxy.d.ts.map

package/dist/lib/video-proxy.d.ts.map

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