@nodetool-ai/websocket 0.7.0-rc.23 → 0.8.2

package/dist/lib/asset-export.js

@@ -0,0 +1,113 @@
+/**
+ * Asset resolution for the export surfaces — the timeline and storyboard zips
+ * and the workflow `.nodetool` bundle. Kept out of `http-api.ts` (which pulls
+ * in `@nodetool-ai/dsl` → `base-nodes` at module load) so a route or a test can
+ * reach it on its own.
+ *
+ * The zips stream: {@link resolveExportSource} answers a local file (a managed
+ * asset under the local store, or an external asset in place) by path, and
+ * only a backend with no local file hands over bytes. The workflow bundle
+ * rewrites graph refs from bytes and still reads them whole through
+ * {@link resolveAssetBytesForExport}.
+ */
+import { readFile, stat } from "node:fs/promises";
+import nodePath from "node:path";
+import { Asset } from "@nodetool-ai/models";
+import { safeFetch } from "@nodetool-ai/runtime";
+import { getAssetAdapter } from "./storage.js";
+import { localAssetPath, retrieveAssetBytes } from "./asset-paths.js";
+import { isLocalFileSource } from "./zip-stream.js";
+/**
+ * The asset id in an `asset://` locator, or null when the locator names a
+ * storage key instead. `asset://<id>` and `asset://<id>.<ext>` are both ids —
+ * `persistOutput` writes the suffixed form so a renderer can type the media —
+ * while anything carrying a slash is already owner-prefixed.
+ */
+function assetIdOf(rest) {
+    if (rest === "" || rest.includes("/"))
+        return null;
+    const ext = nodePath.extname(rest);
+    return ext ? rest.slice(0, -ext.length) : rest;
+}
+async function fileSource(path) {
+    return { path, size: (await stat(path)).size };
+}
+/**
+ * An asset's local file, read in place, or its stored bytes on a backend with
+ * no local file. Null when neither exists (including an offline external
+ * asset).
+ */
+export async function resolveAssetExportSource(asset) {
+    const adapter = getAssetAdapter();
+    const path = await localAssetPath(adapter, asset.user_id, asset.id, asset.content_type);
+    if (path)
+        return fileSource(path);
+    return retrieveAssetBytes(adapter, asset.user_id, asset.id, asset.content_type);
+}
+/** The object under a storage key, as a local file when there is one. */
+async function keyExportSource(adapter, key) {
+    const uri = adapter.uriForKey(key);
+    const path = await adapter.localPath(uri);
+    if (path)
+        return fileSource(path);
+    return adapter.retrieve(uri);
+}
+/**
+ * Resolve an export ref (`asset://`, `/api/storage/`, or a remote URL) to a
+ * local file or bytes. Null when it cannot be resolved; the caller reports
+ * it as missing.
+ */
+export async function resolveExportSource(ref) {
+    try {
+        if (ref.startsWith("asset://")) {
+            const rest = ref.slice("asset://".length).split("?")[0].split("#")[0];
+            const adapter = getAssetAdapter();
+            const assetId = assetIdOf(rest);
+            if (assetId) {
+                // The row carries the owner, and the bytes live under
+                // `<user_id>/<id>.<ext>` on every backend written since the per-owner
+                // layout. Reading the suffixed ref as a flat key skipped that prefix
+                // and found nothing on S3/Supabase, where no flat object exists.
+                const asset = (await Asset.get(assetId));
+                if (asset) {
+                    const source = await resolveAssetExportSource(asset);
+                    if (source)
+                        return source;
+                }
+                // No row (or no bytes under either candidate): an older graph can
+                // still name an object that only exists under the flat key.
+                return await keyExportSource(adapter, rest);
+            }
+            return await keyExportSource(adapter, rest);
+        }
+        if (ref.includes("/api/storage/")) {
+            const key = decodeURIComponent(ref
+                .slice(ref.indexOf("/api/storage/") + "/api/storage/".length)
+                .split("?")[0]);
+            return await keyExportSource(getAssetAdapter(), key);
+        }
+        if (/^https?:\/\//.test(ref)) {
+            const res = await safeFetch(ref);
+            if (!res.ok)
+                return null;
+            return new Uint8Array(await res.arrayBuffer());
+        }
+    }
+    catch {
+        // Unresolved — the caller reports the ref as missing.
+    }
+    return null;
+}
+/** Resolve a ref to bytes in memory, for the workflow bundle's graph rewrite. */
+export async function resolveAssetBytesForExport(ref) {
+    const source = await resolveExportSource(ref);
+    if (!source || !isLocalFileSource(source))
+        return source;
+    try {
+        return new Uint8Array(await readFile(source.path));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=asset-export.js.map

package/dist/lib/asset-export.js.map

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

package/dist/lib/asset-model-interface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The server's asset model interfaces: `createAsset` persists bytes through
+ * the storage layer (with a thumbnail) and saves the Asset row;
+ * `updateAssetBytes` overwrites an existing asset's bytes in place. One
+ * implementation each for every ProcessingContext the server hands out — chat
+ * turns, MCP sessions, and workflow runs — so an artifact persists identically
+ * no matter which surface produced it.
+ */
+import { Asset } from "@nodetool-ai/models";
+import type { AssetInfoEntry } from "@nodetool-ai/runtime";
+export interface CreateAssetArgs {
+    userId: string;
+    workflowId?: string | null;
+    jobId?: string | null;
+    projectId?: string | null;
+    nodeId?: string | null;
+    name: string;
+    contentType: string;
+    content?: Uint8Array | null;
+    parentId?: string | null;
+    /** Stored on the row; the generation seam stamps `generation_id`. */
+    metadata?: Record<string, unknown> | null;
+}
+export declare function createAssetModelInterface(args: CreateAssetArgs): Promise<Asset>;
+export interface UpdateAssetBytesArgs {
+    userId: string;
+    assetId: string;
+    content: Uint8Array;
+    contentType?: string;
+    name?: string;
+}
+/**
+ * The server's `updateAssetBytes` model interface: overwrite an owned asset's
+ * bytes in place, the same write `assets.update` performs when the editor
+ * saves. Returns null when the asset is missing or belongs to someone else.
+ *
+ * Changing the content type to one with a different extension without new
+ * bytes would orphan the object, so the bytes are always required here.
+ */
+export declare function updateAssetBytesModelInterface(args: UpdateAssetBytesArgs): Promise<AssetInfoEntry | null>;
+//# sourceMappingURL=asset-model-interface.d.ts.map

package/dist/lib/asset-model-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-model-interface.d.ts","sourceRoot":"","sources":["../../src/lib/asset-model-interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,KAAK,CAAC,CAiChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAiChC"}

package/dist/lib/asset-model-interface.js

@@ -0,0 +1,74 @@
+/**
+ * The server's asset model interfaces: `createAsset` persists bytes through
+ * the storage layer (with a thumbnail) and saves the Asset row;
+ * `updateAssetBytes` overwrites an existing asset's bytes in place. One
+ * implementation each for every ProcessingContext the server hands out — chat
+ * turns, MCP sessions, and workflow runs — so an artifact persists identically
+ * no matter which surface produced it.
+ */
+import { Asset } from "@nodetool-ai/models";
+import { storeAssetWithThumbnail } from "./thumbnail.js";
+import { probeAssetDurationSeconds } from "./asset-duration.js";
+import { getAssetFileName, normalizeAssetContentType } from "./asset-paths.js";
+export async function createAssetModelInterface(args) {
+    const asset = new Asset({
+        user_id: args.userId,
+        workflow_id: args.workflowId ?? null,
+        node_id: args.nodeId ?? null,
+        job_id: args.jobId ?? null,
+        project_id: args.projectId ?? "default",
+        name: args.name,
+        content_type: normalizeAssetContentType(args.contentType, args.name),
+        // No explicit parent means the user's home folder — the same default the
+        // upload path uses. `null` orphaned generated assets from every
+        // folder-scoped listing while global search still found them.
+        parent_id: args.parentId ?? args.userId
+    });
+    if (args.metadata && Object.keys(args.metadata).length > 0) {
+        asset.metadata = { ...args.metadata };
+    }
+    if (args.content) {
+        asset.duration = await probeAssetDurationSeconds(asset.content_type, {
+            bytes: args.content
+        });
+        const key = getAssetFileName(asset.id, asset.content_type);
+        await storeAssetWithThumbnail(asset.user_id, asset.id, key, args.content, asset.content_type);
+        asset.size = args.content.length;
+    }
+    await asset.save();
+    return asset;
+}
+/**
+ * The server's `updateAssetBytes` model interface: overwrite an owned asset's
+ * bytes in place, the same write `assets.update` performs when the editor
+ * saves. Returns null when the asset is missing or belongs to someone else.
+ *
+ * Changing the content type to one with a different extension without new
+ * bytes would orphan the object, so the bytes are always required here.
+ */
+export async function updateAssetBytesModelInterface(args) {
+    const asset = await Asset.find(args.userId, args.assetId);
+    if (!asset) {
+        return null;
+    }
+    if (args.contentType) {
+        asset.content_type = normalizeAssetContentType(args.contentType, asset.name);
+    }
+    if (args.name) {
+        asset.name = args.name;
+    }
+    const key = getAssetFileName(asset.id, asset.content_type);
+    await storeAssetWithThumbnail(asset.user_id, asset.id, key, args.content, asset.content_type);
+    asset.size = args.content.length;
+    asset.duration = await probeAssetDurationSeconds(asset.content_type, {
+        bytes: args.content
+    });
+    await asset.save();
+    return {
+        id: asset.id,
+        content_type: asset.content_type,
+        name: asset.name,
+        metadata: asset.metadata ?? null
+    };
+}
+//# sourceMappingURL=asset-model-interface.js.map

package/dist/lib/asset-model-interface.js.map

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

package/dist/lib/asset-paths.d.ts

@@ -4,7 +4,55 @@
  * so the tRPC router doesn't need to pull in the whole `http-api.ts` (which
  * imports `@nodetool-ai/dsl` → `base-nodes` → `kie-nodes` at module load).
  */
+import { assetFileNameCandidates, getAssetFileName } from "@nodetool-ai/protocol";
+import { type StorageAdapter } from "@nodetool-ai/storage";
 import type { StorageHandlerOptions } from "../storage-api.js";
-export declare function getAssetFileName(assetId: string, contentType: string): string;
+/**
+ * `getAssetFileName` is the legacy key shape (no owner prefix). It stays
+ * exported because stored `asset://` refs and already-written objects use it.
+ * New writes go through `getAssetStorageKey`.
+ */
+export { assetFileNameCandidates, getAssetFileName };
+/**
+ * Fill in a missing or generic content type from the file name. Browsers
+ * often send `application/octet-stream` (or nothing) for `.glb` / `.gltf`
+ * / `.svg`.
+ */
+export declare function normalizeAssetContentType(contentType: string, fileName?: string): string;
+/**
+ * Where an asset's bytes live: `<userId>/<assetId>.<ext>`. The owner is the
+ * leading path segment so the tenant boundary is expressible outside this
+ * process — a Supabase RLS policy or bucket policy can match on it, and a
+ * signed upload URL scoped to such a key can only write into its own owner's
+ * prefix.
+ */
+export declare function getAssetStorageKey(userId: string, assetId: string, contentType: string): string;
+/** Owner-prefixed thumbnail key for an asset. */
+export declare function getAssetThumbnailKey(userId: string, assetId: string): string;
+/**
+ * Resolve the key an asset's bytes actually live under, preferring the
+ * owner-prefixed layout and falling back to the flat legacy key. Lets a
+ * deployment roll forward before `nodetool storage migrate-keys` has moved
+ * its existing objects. Returns null when neither exists.
+ */
+export declare function resolveExistingAssetKey(adapter: StorageAdapter, userId: string, fileName: string): Promise<string | null>;
+/**
+ * Read an asset's bytes, trying the owner-prefixed key first and the legacy
+ * flat key second. Callers have already established that `userId` owns
+ * `assetId` (they loaded the row to get `contentType`).
+ */
+export declare function retrieveAssetBytes(adapter: StorageAdapter, userId: string, assetId: string, contentType: string): Promise<Uint8Array | null>;
+/**
+ * The URI an asset's bytes are stored under, trying the same keys as
+ * {@link retrieveAssetBytes}, without reading them. Null when none exists.
+ */
+export declare function existingAssetUri(adapter: StorageAdapter, userId: string, assetId: string, contentType: string): Promise<string | null>;
+/**
+ * The local file holding an asset's bytes, under the same keys
+ * {@link retrieveAssetBytes} reads: a managed file under the local asset root,
+ * or an external asset's in-place file. Null on backends that keep no local
+ * file, where the caller reads the bytes instead.
+ */
+export declare function localAssetPath(adapter: StorageAdapter, userId: string, assetId: string, contentType: string): Promise<string | null>;
 export declare function getAssetStoragePath(opts?: StorageHandlerOptions): string;
 //# sourceMappingURL=asset-paths.d.ts.map

package/dist/lib/asset-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-paths.d.ts","sourceRoot":"","sources":["../../src/lib/asset-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAmC/D,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAExE"}
+{"version":3,"file":"asset-paths.d.ts","sourceRoot":"","sources":["../../src/lib/asset-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;GAIG;AACH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,CAAC;AAsCrD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQ5B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAExE"}

package/dist/lib/asset-paths.js

@@ -5,39 +5,135 @@
  * imports `@nodetool-ai/dsl` → `base-nodes` → `kie-nodes` at module load).
  */
 import { getDefaultAssetsPath } from "@nodetool-ai/config";
-const CONTENT_TYPE_TO_EXTENSION = {
-    "image/jpeg": "jpg",
-    "image/png": "png",
-    "image/gif": "gif",
-    "image/svg+xml": "svg",
-    "image/webp": "webp",
-    "image/tiff": "tiff",
-    "image/bmp": "bmp",
-    "text/plain": "txt",
-    "text/csv": "csv",
-    "text/html": "html",
-    "application/json": "json",
-    "application/pdf": "pdf",
-    "application/zip": "zip",
-    "audio/mpeg": "mp3",
-    "audio/mp3": "mp3",
-    "audio/wav": "wav",
-    "audio/ogg": "ogg",
-    "audio/aac": "aac",
-    "audio/x-wav": "wav",
-    "audio/x-flac": "flac",
-    "audio/x-m4a": "m4a",
-    "video/mp4": "mp4",
-    "video/mpeg": "mpeg",
-    "video/quicktime": "mov",
-    "video/x-msvideo": "avi",
-    "video/webm": "webm"
+import { assetFileNameCandidates, getAssetFileName, hasAssetFileExtension } from "@nodetool-ai/protocol";
+import { assetKeyCandidates, assetObjectKey } from "@nodetool-ai/storage";
+/**
+ * `getAssetFileName` is the legacy key shape (no owner prefix). It stays
+ * exported because stored `asset://` refs and already-written objects use it.
+ * New writes go through `getAssetStorageKey`.
+ */
+export { assetFileNameCandidates, getAssetFileName };
+const EXTENSION_TO_INFERRED_TYPE = {
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    flac: "audio/x-flac",
+    m4a: "audio/x-m4a",
+    aac: "audio/aac",
+    mp4: "video/mp4",
+    webm: "video/webm",
+    mov: "video/quicktime",
+    avi: "video/x-msvideo",
+    mpeg: "video/mpeg",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    gif: "image/gif",
+    glb: "model/gltf-binary",
+    gltf: "model/gltf+json",
+    svg: "image/svg+xml"
 };
-function getFileExtension(contentType) {
-    return CONTENT_TYPE_TO_EXTENSION[contentType] ?? "bin";
+const GENERIC_CONTENT_TYPES = new Set(["", "application/octet-stream"]);
+function fileExtensionOf(fileName) {
+    if (!fileName) {
+        return undefined;
+    }
+    const base = fileName.split(/[\\/]/).pop() ?? "";
+    const dot = base.lastIndexOf(".");
+    if (dot <= 0 || dot === base.length - 1) {
+        return undefined;
+    }
+    return base.slice(dot + 1).toLowerCase();
+}
+/**
+ * Fill in a missing or generic content type from the file name. Browsers
+ * often send `application/octet-stream` (or nothing) for `.glb` / `.gltf`
+ * / `.svg`.
+ */
+export function normalizeAssetContentType(contentType, fileName) {
+    if (hasAssetFileExtension(contentType)) {
+        return contentType;
+    }
+    const ext = fileExtensionOf(fileName);
+    const inferred = ext ? EXTENSION_TO_INFERRED_TYPE[ext] : undefined;
+    if (inferred && GENERIC_CONTENT_TYPES.has(contentType)) {
+        return inferred;
+    }
+    return contentType || "application/octet-stream";
+}
+/**
+ * Where an asset's bytes live: `<userId>/<assetId>.<ext>`. The owner is the
+ * leading path segment so the tenant boundary is expressible outside this
+ * process — a Supabase RLS policy or bucket policy can match on it, and a
+ * signed upload URL scoped to such a key can only write into its own owner's
+ * prefix.
+ */
+export function getAssetStorageKey(userId, assetId, contentType) {
+    return assetObjectKey(userId, getAssetFileName(assetId, contentType));
+}
+/** Owner-prefixed thumbnail key for an asset. */
+export function getAssetThumbnailKey(userId, assetId) {
+    return assetObjectKey(userId, `${assetId}_thumb.jpg`);
+}
+/**
+ * Resolve the key an asset's bytes actually live under, preferring the
+ * owner-prefixed layout and falling back to the flat legacy key. Lets a
+ * deployment roll forward before `nodetool storage migrate-keys` has moved
+ * its existing objects. Returns null when neither exists.
+ */
+export async function resolveExistingAssetKey(adapter, userId, fileName) {
+    for (const candidate of assetKeyCandidates(userId, fileName)) {
+        if (await adapter.exists(adapter.uriForKey(candidate))) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Read an asset's bytes, trying the owner-prefixed key first and the legacy
+ * flat key second. Callers have already established that `userId` owns
+ * `assetId` (they loaded the row to get `contentType`).
+ */
+export async function retrieveAssetBytes(adapter, userId, assetId, contentType) {
+    for (const fileName of assetFileNameCandidates(assetId, contentType)) {
+        for (const candidate of assetKeyCandidates(userId, fileName)) {
+            const bytes = await adapter.retrieve(adapter.uriForKey(candidate));
+            if (bytes)
+                return bytes;
+        }
+    }
+    return null;
 }
-export function getAssetFileName(assetId, contentType) {
-    return `${assetId}.${getFileExtension(contentType)}`;
+/**
+ * The URI an asset's bytes are stored under, trying the same keys as
+ * {@link retrieveAssetBytes}, without reading them. Null when none exists.
+ */
+export async function existingAssetUri(adapter, userId, assetId, contentType) {
+    for (const fileName of assetFileNameCandidates(assetId, contentType)) {
+        for (const candidate of assetKeyCandidates(userId, fileName)) {
+            const uri = adapter.uriForKey(candidate);
+            if (await adapter.exists(uri))
+                return uri;
+        }
+    }
+    return null;
+}
+/**
+ * The local file holding an asset's bytes, under the same keys
+ * {@link retrieveAssetBytes} reads: a managed file under the local asset root,
+ * or an external asset's in-place file. Null on backends that keep no local
+ * file, where the caller reads the bytes instead.
+ */
+export async function localAssetPath(adapter, userId, assetId, contentType) {
+    for (const fileName of assetFileNameCandidates(assetId, contentType)) {
+        for (const candidate of assetKeyCandidates(userId, fileName)) {
+            const found = await adapter.localPath(adapter.uriForKey(candidate));
+            if (found)
+                return found;
+        }
+    }
+    return null;
 }
 export function getAssetStoragePath(opts) {
     return opts?.storagePath ?? getDefaultAssetsPath();

package/dist/lib/asset-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-paths.js","sourceRoot":"","sources":["../../src/lib/asset-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,MAAM,yBAAyB,GAA2B;IACxD,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,MAAM;IACnB,kBAAkB,EAAE,MAAM;IAC1B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,MAAM;IACtB,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO,yBAAyB,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,WAAmB;IAEnB,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAA4B;IAC9D,OAAO,IAAI,EAAE,WAAW,IAAI,oBAAoB,EAAE,CAAC;AACrD,CAAC"}
+{"version":3,"file":"asset-paths.js","sourceRoot":"","sources":["../../src/lib/asset-paths.ts"],"names":[],"mappings":"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"}

package/dist/lib/asset-response.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The wire shape of one asset row, shared by the REST asset routes and the
+ * tRPC `assets.*` procedures.
+ *
+ * Both surfaces answer the same JSON, so both mint it here: the same field
+ * list, the same owner-prefixed storage keys, and the same lazily-built URL
+ * builder. A field added on one path used to have to be added on the other.
+ */
+import type { Asset } from "@nodetool-ai/models";
+import type { AssetResponse } from "@nodetool-ai/protocol/api-schemas/assets.js";
+export declare function toAssetResponse(asset: Asset): Promise<AssetResponse>;
+//# sourceMappingURL=asset-response.d.ts.map

package/dist/lib/asset-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-response.d.ts","sourceRoot":"","sources":["../../src/lib/asset-response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AA0BjF,wBAAsB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAkE1E"}

package/dist/lib/asset-response.js

@@ -0,0 +1,89 @@
+/**
+ * The wire shape of one asset row, shared by the REST asset routes and the
+ * tRPC `assets.*` procedures.
+ *
+ * Both surfaces answer the same JSON, so both mint it here: the same field
+ * list, the same owner-prefixed storage keys, and the same lazily-built URL
+ * builder. A field added on one path used to have to be added on the other.
+ */
+import { loadAssetStorageConfig } from "@nodetool-ai/config";
+import { assetObjectKey, createAssetUrlBuilder } from "@nodetool-ai/storage";
+import { getAssetFileName } from "./asset-paths.js";
+import { assetHasRasterThumbnail, thumbnailKey } from "./thumbnail.js";
+import { externalAssetMtime, isExternalAssetOffline } from "./external-asset-lookup.js";
+import { videoProxyState } from "./video-proxy.js";
+let cachedConfig = null;
+let cachedBuilder = null;
+/**
+ * The URL builder for the configured storage backend, rebuilt when the
+ * backend kind changes (a test switching backends mid-process).
+ */
+function assetUrlBuilder() {
+    const config = loadAssetStorageConfig();
+    if (!cachedBuilder || cachedConfig?.kind !== config.kind) {
+        cachedConfig = config;
+        cachedBuilder = createAssetUrlBuilder(config);
+    }
+    return cachedBuilder;
+}
+export async function toAssetResponse(asset) {
+    const isFolder = asset.content_type === "folder";
+    const fileName = isFolder
+        ? null
+        : getAssetFileName(asset.id, asset.content_type);
+    // Owner-prefixed keys. Objects written before this layout are flat; the
+    // `/api/storage` route falls back to the legacy path on a miss, and cloud
+    // backends need `nodetool storage migrate-keys` (see docs/configuration.md).
+    const getUrl = fileName
+        ? await assetUrlBuilder()(assetObjectKey(asset.user_id, fileName)).catch(() => null)
+        : null;
+    const hasThumbnail = assetHasRasterThumbnail(asset.content_type);
+    const thumbKeyUrl = hasThumbnail
+        ? await assetUrlBuilder()(assetObjectKey(asset.user_id, thumbnailKey(asset.id))).catch(() => null)
+        : null;
+    // A relink regenerates an external asset's thumbnail under the same key.
+    // The file's mtime in the URL keeps a cached thumbnail of the previous file
+    // from standing in for the new one. `get_url` stays unversioned (D5).
+    const externalMtime = externalAssetMtime(asset);
+    const thumbUrl = thumbKeyUrl && externalMtime !== null
+        ? `${thumbKeyUrl}?v=${Math.trunc(externalMtime)}`
+        : thumbKeyUrl;
+    const response = {
+        id: asset.id,
+        user_id: asset.user_id,
+        workflow_id: asset.workflow_id ?? null,
+        parent_id: asset.parent_id ?? null,
+        name: asset.name,
+        content_type: asset.content_type,
+        size: asset.size ?? null,
+        metadata: asset.metadata ?? null,
+        sketch_document_id: asset.sketch_document_id ?? null,
+        created_at: asset.created_at,
+        get_url: getUrl,
+        thumb_url: thumbUrl,
+        duration: asset.duration ?? null,
+        node_id: asset.node_id ?? null,
+        job_id: asset.job_id ?? null,
+        timeline_id: asset.timeline_id ?? null,
+        project_id: asset.project_id,
+        favorite: asset.favorite
+    };
+    // Only assets that reference a file in place carry the flag.
+    if (asset.external_path) {
+        response.offline = await isExternalAssetOffline(asset);
+    }
+    // Video on a local server: whether the preview may play the proxy. The URL
+    // carries the source version, so a remade proxy is never served from cache.
+    const proxy = await videoProxyState(asset);
+    if (proxy) {
+        response.proxy_status = proxy.status;
+        response.proxy_url =
+            proxy.key !== null
+                ? await assetUrlBuilder()(proxy.key)
+                    .then((url) => `${url}?v=${proxy.version}`)
+                    .catch(() => null)
+                : null;
+    }
+    return response;
+}
+//# sourceMappingURL=asset-response.js.map

package/dist/lib/asset-response.js.map

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

package/dist/lib/audio-peaks.d.ts

@@ -0,0 +1,23 @@
+/** The count the timeline asks for; also the default. */
+export declare const DEFAULT_PEAK_COUNT = 2000;
+export declare const MAX_PEAK_COUNT = 20000;
+export interface AudioPeaks {
+    /** `count` abs-max values of channel 0, each in [0, 1] for normal audio. */
+    peaks: number[];
+    /** Decoded length of the audio stream. */
+    duration_ms: number;
+}
+/**
+ * Decode channel 0 of the first audio stream of `filePath` with ffmpeg and
+ * reduce it to `count` abs-max peaks. Returns null when the file has no audio
+ * stream. Throws {@link MediaToolingMissingError} when ffmpeg is missing.
+ */
+export declare function computeAudioPeaks(filePath: string, count: number): Promise<AudioPeaks | null>;
+/**
+ * GET /api/assets/:id/peaks?count=<n>
+ *
+ * Answers `{ peaks, duration_ms }` for an audio or video asset the caller
+ * owns. The `x-peaks-cache` header says whether the disk cache answered.
+ */
+export declare function handleAssetPeaks(userId: string, assetId: string, searchParams: URLSearchParams): Promise<Response>;
+//# sourceMappingURL=audio-peaks.d.ts.map

package/dist/lib/audio-peaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-peaks.d.ts","sourceRoot":"","sources":["../../src/lib/audio-peaks.ts"],"names":[],"mappings":"AA+BA,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,cAAc,QAAS,CAAC;AAUrC,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AA8FD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO5B;AA6ID;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAwEnB"}