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

package/dist/lib/example-recipes.js

@@ -0,0 +1,213 @@
+/**
+ * The shipped recipes: a named outcome, the example app that reaches it, and
+ * the ordered example workflows that app is made of.
+ *
+ * A recipe is a file on disk next to the examples it composes
+ * (`packages/base-nodes/nodetool/examples/recipes/<slug>.recipe.json`), the
+ * same layout the example apps and storyboards use. It stores no graphs and no
+ * app documents of its own — every step names a shipped example and every app
+ * a shipped bundle, and this module resolves those names against the
+ * directories the server is already serving, so a recipe cannot drift into
+ * claiming a workflow, an app, a model, or a thumbnail the install does not
+ * have.
+ *
+ * The site's downloadable `.nodetool` bundles are packed from the same
+ * manifests (`marketing/scripts/generate-recipes.mjs`), so the chain a page
+ * describes and the chain the app offers are one list.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import nodePath from "node:path";
+import { parseRecipeBundle } from "@nodetool-ai/protocol/api-schemas/recipes.js";
+import { deriveExampleAssetsDir, resolveExampleJsonPath } from "../example-workflows.js";
+import { getExampleAppSummary } from "./example-apps.js";
+import { withCacheBuster } from "./example-thumbnail.js";
+import { isString } from "./wire-values.js";
+const BUNDLE_SUFFIX = ".recipe.json";
+const EXAMPLES_THUMBNAILS_PREFIX = "/api/workflows/examples/thumbnails/";
+/**
+ * Where the manifests live: an explicit override, else the `recipes` sibling of
+ * the example workflows directory — the layout the monorepo, the packaged
+ * backend, and the server image share.
+ */
+export function resolveExampleRecipesDir(options) {
+    if (options.exampleRecipesDir) {
+        return existsSync(options.exampleRecipesDir)
+            ? options.exampleRecipesDir
+            : null;
+    }
+    if (!options.examplesDir)
+        return null;
+    const sibling = nodePath.join(nodePath.dirname(options.examplesDir), "recipes");
+    return existsSync(sibling) ? sibling : null;
+}
+function readBundle(dir, file) {
+    // Callers only pass names that came out of readdirSync, but resolve and
+    // check containment anyway so no future caller can read outside the
+    // recipes directory by passing a path-shaped name.
+    const root = nodePath.resolve(dir);
+    const target = nodePath.resolve(root, file);
+    if (target !== root && !target.startsWith(root + nodePath.sep))
+        return null;
+    try {
+        return parseRecipeBundle(JSON.parse(readFileSync(target, "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Every `{provider, model}` a graph references, in first-seen order.
+ *
+ * A model reference is any object carrying a `provider` field — that covers a
+ * top-level model property, one inside a settings object, and one nested in a
+ * list, which is why this walks rather than reads known keys.
+ */
+function modelRefs(graph) {
+    const seen = new Map();
+    const walk = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                walk(item);
+            return;
+        }
+        if (!value || typeof value !== "object")
+            return;
+        const record = value;
+        if (isString(record.provider) && record.provider) {
+            const model = record.id ?? record.model ?? record.repo_id ?? record.name;
+            if (isString(model) && model) {
+                const key = `${record.provider} ${model}`;
+                if (!seen.has(key)) {
+                    seen.set(key, { provider: record.provider, model });
+                }
+            }
+        }
+        for (const item of Object.values(record))
+            walk(item);
+    };
+    walk(graph);
+    return [...seen.values()];
+}
+function resolveExample(examplesDir, assetsDir, exampleName) {
+    const file = resolveExampleJsonPath(examplesDir, exampleName);
+    if (!file)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    const name = isString(parsed.name)
+        ? parsed.name
+        : nodePath.basename(file, ".json");
+    const jpgFile = `${name}.jpg`;
+    const jpgPath = nodePath.join(assetsDir, jpgFile);
+    const graph = (parsed.graph ?? {});
+    const nodes = Array.isArray(graph.nodes) ? graph.nodes : [];
+    return {
+        name,
+        id: nodePath.basename(file),
+        description: isString(parsed.description) ? parsed.description : "",
+        thumbnailUrl: existsSync(jpgPath)
+            ? withCacheBuster(`${EXAMPLES_THUMBNAILS_PREFIX}${encodeURIComponent(jpgFile)}`, jpgPath)
+            : null,
+        nodeCount: nodes.length,
+        models: modelRefs(graph)
+    };
+}
+/**
+ * Resolve one manifest against what is on disk, or null when a step names an
+ * example or an app this install does not ship — half a chain is worse than
+ * none, and `tests/example-recipes.test.ts` fails when a shipped recipe stops
+ * resolving.
+ */
+function buildRecipe(bundle, options, examplesDir, assetsDir, packageName) {
+    const apps = [];
+    for (const entry of bundle.apps) {
+        const app = getExampleAppSummary(options, entry.app);
+        if (!app)
+            return null;
+        apps.push({ ...app, role: entry.role });
+    }
+    const steps = [];
+    for (const step of bundle.steps) {
+        const example = resolveExample(examplesDir, assetsDir, step.example);
+        if (!example)
+            return null;
+        let alternative = null;
+        if (step.alternative) {
+            const alt = resolveExample(examplesDir, assetsDir, step.alternative.example);
+            if (!alt)
+                return null;
+            alternative = {
+                example: alt.name,
+                exampleId: alt.id,
+                packageName,
+                label: step.alternative.label,
+                why: step.alternative.why
+            };
+        }
+        steps.push({
+            example: example.name,
+            exampleId: example.id,
+            packageName,
+            description: example.description,
+            role: step.role,
+            handoff: step.handoff,
+            thumbnailUrl: example.thumbnailUrl,
+            nodeCount: example.nodeCount,
+            models: example.models,
+            alternative
+        });
+    }
+    const hero = resolveExample(examplesDir, assetsDir, bundle.hero);
+    if (!hero)
+        return null;
+    return {
+        slug: bundle.slug,
+        name: bundle.name,
+        outcome: bundle.outcome,
+        audience: bundle.audience,
+        summary: bundle.summary,
+        caveats: bundle.caveats,
+        thumbnailUrl: hero.thumbnailUrl,
+        providers: [
+            ...new Set(steps.flatMap((s) => s.models.map((m) => m.provider)))
+        ],
+        nodeCount: steps.reduce((total, step) => total + step.nodeCount, 0),
+        apps,
+        steps
+    };
+}
+/** Every shipped recipe whose steps all resolve, sorted by slug. */
+export function listExampleRecipes(options) {
+    const dir = resolveExampleRecipesDir(options);
+    if (!dir || !options.examplesDir || !existsSync(options.examplesDir)) {
+        return [];
+    }
+    const examplesDir = options.examplesDir;
+    const assetsDir = deriveExampleAssetsDir(examplesDir, options.examplesAssetsFallbackDir);
+    const packageName = nodePath.basename(examplesDir);
+    let files;
+    try {
+        files = readdirSync(dir)
+            .filter((file) => file.endsWith(BUNDLE_SUFFIX))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+    const recipes = [];
+    for (const file of files) {
+        const bundle = readBundle(dir, file);
+        if (!bundle)
+            continue;
+        const recipe = buildRecipe(bundle, options, examplesDir, assetsDir, packageName);
+        if (recipe)
+            recipes.push(recipe);
+    }
+    return recipes;
+}
+//# sourceMappingURL=example-recipes.js.map

package/dist/lib/example-recipes.js.map

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

package/dist/lib/example-storyboards.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The shipped example storyboards: curated boards that install into a user's
+ * library with their shots already directed and rendered.
+ *
+ * They work the way example workflows do — a file on disk, not a database row,
+ * so listing one needs no user and installing one is a single insert. The
+ * bundles live next to the example workflows and the example apps
+ * (`packages/base-nodes/nodetool/examples/storyboards/*.storyboard.json`, built
+ * by `scripts/build-example-storyboards.mjs`), and each shot's still is a
+ * `package://` asset served from the package asset root, so no bytes are
+ * copied per install.
+ */
+import { type StoryboardResponse } from "@nodetool-ai/models";
+import { type ExampleStoryboardSummary, type StoryboardBundle } from "@nodetool-ai/protocol/api-schemas/storyboards.js";
+export interface ExampleStoryboardOptions {
+    examplesDir?: string;
+    exampleStoryboardsDir?: string;
+}
+/**
+ * Where the bundles live: an explicit override, else the `storyboards` sibling
+ * of the example workflows directory — the layout the monorepo, the packaged
+ * backend, and the server image share.
+ */
+export declare function resolveExampleStoryboardsDir(options: ExampleStoryboardOptions): string | null;
+/** Every shipped example board, sorted by slug. Invalid files are skipped. */
+export declare function listExampleStoryboards(options: ExampleStoryboardOptions): ExampleStoryboardSummary[];
+/** One example's full bundle, or null when the slug names nothing shipped. */
+export declare function getExampleStoryboardBundle(options: ExampleStoryboardOptions, slug: string): StoryboardBundle | null;
+/**
+ * Install an example board: one row carrying the bundle's document verbatim.
+ * The shots keep their `package://` stills, so the installed board
+ * displays immediately and the user's asset library stays untouched until they
+ * render something of their own.
+ */
+export declare function installExampleStoryboard(userId: string, options: ExampleStoryboardOptions, input: {
+    slug: string;
+    projectId?: string;
+    name?: string;
+}): Promise<StoryboardResponse>;
+//# sourceMappingURL=example-storyboards.d.ts.map

package/dist/lib/example-storyboards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-storyboards.d.ts","sourceRoot":"","sources":["../../src/lib/example-storyboards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACtB,MAAM,kDAAkD,CAAC;AAM1D,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC,MAAM,GAAG,IAAI,CAYf;AAkDD,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,EAAE,CAU5B;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,IAAI,CASzB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}

package/dist/lib/example-storyboards.js

@@ -0,0 +1,131 @@
+/**
+ * The shipped example storyboards: curated boards that install into a user's
+ * library with their shots already directed and rendered.
+ *
+ * They work the way example workflows do — a file on disk, not a database row,
+ * so listing one needs no user and installing one is a single insert. The
+ * bundles live next to the example workflows and the example apps
+ * (`packages/base-nodes/nodetool/examples/storyboards/*.storyboard.json`, built
+ * by `scripts/build-example-storyboards.mjs`), and each shot's still is a
+ * `package://` asset served from the package asset root, so no bytes are
+ * copied per install.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import nodePath from "node:path";
+import { Storyboard } from "@nodetool-ai/models";
+import { packageAssetHttpPath } from "@nodetool-ai/protocol";
+import { parseStoryboardBundle } from "@nodetool-ai/protocol/api-schemas/storyboards.js";
+import { ApiErrorCode } from "../error-codes.js";
+import { throwApiError } from "../trpc/error-formatter.js";
+const BUNDLE_SUFFIX = ".storyboard.json";
+/**
+ * Where the bundles live: an explicit override, else the `storyboards` sibling
+ * of the example workflows directory — the layout the monorepo, the packaged
+ * backend, and the server image share.
+ */
+export function resolveExampleStoryboardsDir(options) {
+    if (options.exampleStoryboardsDir) {
+        return existsSync(options.exampleStoryboardsDir)
+            ? options.exampleStoryboardsDir
+            : null;
+    }
+    if (!options.examplesDir)
+        return null;
+    const sibling = nodePath.join(nodePath.dirname(options.examplesDir), "storyboards");
+    return existsSync(sibling) ? sibling : null;
+}
+function readBundle(dir, file) {
+    // Callers only pass names that came out of readdirSync, but resolve and
+    // check containment anyway so no future caller can read outside the
+    // examples directory by passing a path-shaped name.
+    const root = nodePath.resolve(dir);
+    const target = nodePath.resolve(root, file);
+    if (target !== root && !target.startsWith(root + nodePath.sep))
+        return null;
+    try {
+        return parseStoryboardBundle(JSON.parse(readFileSync(target, "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+const slugOf = (file) => file.slice(0, -BUNDLE_SUFFIX.length);
+function bundleFiles(dir) {
+    try {
+        return readdirSync(dir)
+            .filter((file) => file.endsWith(BUNDLE_SUFFIX))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+function summarize(slug, bundle) {
+    const shots = bundle.document.shots;
+    return {
+        slug,
+        name: bundle.name,
+        description: bundle.description,
+        // The bundle's description sells the example; its brief is the idea the
+        // board was directed from, which is what an inspiration chip pastes.
+        logline: bundle.document.brief,
+        tags: bundle.tags,
+        shotCount: shots.length,
+        clipCount: shots.filter((shot) => shot.clip?.uri).length,
+        aspectRatio: bundle.document.aspectRatio,
+        // The board's own first still is its card image — a shipped example needs
+        // no separate thumbnail file the way an example workflow does.
+        thumbnailUrl: packageAssetHttpPath(shots[0]?.keyframe?.uri),
+        stillUrls: shots
+            .map((shot) => packageAssetHttpPath(shot.keyframe?.uri))
+            .filter((url) => url !== null)
+    };
+}
+/** Every shipped example board, sorted by slug. Invalid files are skipped. */
+export function listExampleStoryboards(options) {
+    const dir = resolveExampleStoryboardsDir(options);
+    if (!dir)
+        return [];
+    const summaries = [];
+    for (const file of bundleFiles(dir)) {
+        const bundle = readBundle(dir, file);
+        if (!bundle)
+            continue;
+        summaries.push(summarize(slugOf(file), bundle));
+    }
+    return summaries;
+}
+/** One example's full bundle, or null when the slug names nothing shipped. */
+export function getExampleStoryboardBundle(options, slug) {
+    const dir = resolveExampleStoryboardsDir(options);
+    if (!dir)
+        return null;
+    // Match the slug against what is actually shipped instead of building a path
+    // out of it: the file name that reaches readBundle comes from the directory
+    // listing, so a path-shaped slug can only fail to match.
+    const file = bundleFiles(dir).find((entry) => slugOf(entry) === slug);
+    if (!file)
+        return null;
+    return readBundle(dir, file);
+}
+/**
+ * Install an example board: one row carrying the bundle's document verbatim.
+ * The shots keep their `package://` stills, so the installed board
+ * displays immediately and the user's asset library stays untouched until they
+ * render something of their own.
+ */
+export async function installExampleStoryboard(userId, options, input) {
+    const bundle = getExampleStoryboardBundle(options, input.slug);
+    if (!bundle) {
+        throwApiError(ApiErrorCode.NOT_FOUND, `No example storyboard named "${input.slug}"`);
+    }
+    const board = new Storyboard({
+        user_id: userId,
+        project_id: input.projectId ?? "default",
+        name: input.name ?? bundle.name,
+        document: JSON.stringify(bundle.document)
+    });
+    await board.save();
+    return board.toResponse();
+}
+//# sourceMappingURL=example-storyboards.js.map

package/dist/lib/example-storyboards.js.map

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

package/dist/lib/example-thumbnail.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cache-buster for example workflow thumbnail JPGs.
+ *
+ * Each thumbnail's md5 (first 8 hex chars) is appended to its
+ * `thumbnail_url` as `?v=<hash>` so that browsers drop their cached copy
+ * whenever the JPG is regenerated. Hashes are cached by `(absPath, mtimeMs)`
+ * — re-hashed only when the file is replaced on disk.
+ */
+/**
+ * Return the 8-char md5 of `absPath`'s contents, or `null` if the file is
+ * missing / unreadable. The result is memoised by `(path, mtime)` so the
+ * read+hash happens once per file per process (and once again whenever the
+ * file is regenerated).
+ */
+export declare function thumbnailHash(absPath: string): string | null;
+/**
+ * Append `?v=<md5-8>` to a thumbnail URL, or return the URL unchanged if
+ * the file isn't readable.
+ */
+export declare function withCacheBuster(url: string, absPath: string): string;
+//# sourceMappingURL=example-thumbnail.d.ts.map

package/dist/lib/example-thumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-thumbnail.d.ts","sourceRoot":"","sources":["../../src/lib/example-thumbnail.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpE"}

package/dist/lib/example-thumbnail.js

@@ -0,0 +1,50 @@
+/**
+ * Cache-buster for example workflow thumbnail JPGs.
+ *
+ * Each thumbnail's md5 (first 8 hex chars) is appended to its
+ * `thumbnail_url` as `?v=<hash>` so that browsers drop their cached copy
+ * whenever the JPG is regenerated. Hashes are cached by `(absPath, mtimeMs)`
+ * — re-hashed only when the file is replaced on disk.
+ */
+import { readFileSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
+const cache = new Map();
+/**
+ * Return the 8-char md5 of `absPath`'s contents, or `null` if the file is
+ * missing / unreadable. The result is memoised by `(path, mtime)` so the
+ * read+hash happens once per file per process (and once again whenever the
+ * file is regenerated).
+ */
+export function thumbnailHash(absPath) {
+    let stat;
+    try {
+        stat = statSync(absPath);
+    }
+    catch {
+        return null;
+    }
+    const cached = cache.get(absPath);
+    if (cached && cached.mtimeMs === stat.mtimeMs)
+        return cached.hash;
+    let hash;
+    try {
+        hash = createHash("md5")
+            .update(readFileSync(absPath))
+            .digest("hex")
+            .slice(0, 8);
+    }
+    catch {
+        return null;
+    }
+    cache.set(absPath, { mtimeMs: stat.mtimeMs, hash });
+    return hash;
+}
+/**
+ * Append `?v=<md5-8>` to a thumbnail URL, or return the URL unchanged if
+ * the file isn't readable.
+ */
+export function withCacheBuster(url, absPath) {
+    const hash = thumbnailHash(absPath);
+    return hash ? `${url}?v=${hash}` : url;
+}
+//# sourceMappingURL=example-thumbnail.js.map

package/dist/lib/example-thumbnail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-thumbnail.js","sourceRoot":"","sources":["../../src/lib/example-thumbnail.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,IAAiC,CAAC;IACtC,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAClE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;aACrB,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;aAC7B,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,OAAe;IAC1D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC"}

package/dist/lib/example-timelines.d.ts

@@ -0,0 +1,9 @@
+import { type ExampleTimelineOptions } from "@nodetool-ai/timeline/examples/node";
+export { getExampleTimelineBundle, listExampleTimelines, resolveExampleTimelinesDir } from "@nodetool-ai/timeline/examples/node";
+/** Save an editable copy of a shipped timeline for one user. */
+export declare function installExampleTimeline(userId: string, options: ExampleTimelineOptions, input: {
+    slug: string;
+    projectId?: string;
+    name?: string;
+}): Promise<import("@nodetool-ai/timeline").TimelineSequence>;
+//# sourceMappingURL=example-timelines.d.ts.map

package/dist/lib/example-timelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-timelines.d.ts","sourceRoot":"","sources":["../../src/lib/example-timelines.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,gEAAgE;AAChE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,6DAqB3D"}

package/dist/lib/example-timelines.js

@@ -0,0 +1,25 @@
+import { TimelineSequence } from "@nodetool-ai/models";
+import { getExampleTimelineBundle } from "@nodetool-ai/timeline/examples/node";
+import { ApiErrorCode } from "../error-codes.js";
+import { throwApiError } from "../trpc/error-formatter.js";
+export { getExampleTimelineBundle, listExampleTimelines, resolveExampleTimelinesDir } from "@nodetool-ai/timeline/examples/node";
+/** Save an editable copy of a shipped timeline for one user. */
+export async function installExampleTimeline(userId, options, input) {
+    const bundle = getExampleTimelineBundle(options, input.slug);
+    if (!bundle) {
+        throwApiError(ApiErrorCode.NOT_FOUND, `No example timeline named "${input.slug}"`);
+    }
+    const sequence = new TimelineSequence({
+        user_id: userId,
+        project_id: input.projectId ?? "default",
+        name: input.name ?? bundle.name,
+        fps: bundle.fps,
+        width: bundle.width,
+        height: bundle.height,
+        duration_ms: bundle.durationMs,
+        document: JSON.stringify(bundle.document)
+    });
+    await sequence.save();
+    return sequence.toTimelineSequence();
+}
+//# sourceMappingURL=example-timelines.js.map

package/dist/lib/example-timelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-timelines.js","sourceRoot":"","sources":["../../src/lib/example-timelines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,wBAAwB,EAEzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC;AAE7C,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,OAA+B,EAC/B,KAA0D;IAE1D,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,aAAa,CACX,YAAY,CAAC,SAAS,EACtB,8BAA8B,KAAK,CAAC,IAAI,GAAG,CAC5C,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC;QACpC,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACxC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;QAC/B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,UAAU;QAC9B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC1C,CAAC,CAAC;IACH,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,QAAQ,CAAC,kBAAkB,EAAE,CAAC;AACvC,CAAC"}

package/dist/lib/extension-dist.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Locate (and zip) the built Chrome extension so the UI can help users install
+ * it into their own Chrome.
+ *
+ * Resolution order:
+ *   1. `NODETOOL_EXTENSION_DIST` — set by the Electron main process to the
+ *      bundled resource path in packaged builds.
+ *   2. Walk up from this module and from cwd looking for
+ *      `chrome-extension/dist/manifest.json` (the dev/monorepo layout).
+ */
+interface ExtensionDistInfo {
+    /** Absolute path to the extension `dist` dir (may not exist). */
+    path: string;
+    /** Whether a valid build (with manifest.json) was found there. */
+    exists: boolean;
+}
+export declare function resolveExtensionDist(): ExtensionDistInfo;
+/**
+ * Zip the extension build into an in-memory buffer (the build is tiny — a few
+ * small JS/HTML/PNG files). Throws if no build is found.
+ */
+export declare function zipExtensionDist(): Promise<Buffer>;
+export {};
+//# sourceMappingURL=extension-dist.d.ts.map

package/dist/lib/extension-dist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-dist.d.ts","sourceRoot":"","sources":["../../src/lib/extension-dist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,UAAU,iBAAiB;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC;CACjB;AAkBD,wBAAgB,oBAAoB,IAAI,iBAAiB,CASxD;AAeD;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAQxD"}

package/dist/lib/extension-dist.js

@@ -0,0 +1,67 @@
+/**
+ * Locate (and zip) the built Chrome extension so the UI can help users install
+ * it into their own Chrome.
+ *
+ * Resolution order:
+ *   1. `NODETOOL_EXTENSION_DIST` — set by the Electron main process to the
+ *      bundled resource path in packaged builds.
+ *   2. Walk up from this module and from cwd looking for
+ *      `chrome-extension/dist/manifest.json` (the dev/monorepo layout).
+ */
+import { existsSync, readdirSync, statSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { zipSync } from "fflate";
+function isBuild(dir) {
+    return existsSync(path.join(dir, "manifest.json"));
+}
+function findUp(start) {
+    let dir = start;
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.join(dir, "chrome-extension", "dist");
+        if (isBuild(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+export function resolveExtensionDist() {
+    const env = process.env.NODETOOL_EXTENSION_DIST;
+    if (env && isBuild(env))
+        return { path: env, exists: true };
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const found = findUp(here) ?? findUp(process.cwd());
+    if (found)
+        return { path: found, exists: true };
+    return { path: env ?? "", exists: false };
+}
+/** Recursively collect a directory's files into a flat path → bytes map. */
+function addDir(files, dir, rel) {
+    for (const entry of readdirSync(dir)) {
+        const full = path.join(dir, entry);
+        const relPath = rel ? `${rel}/${entry}` : entry;
+        if (statSync(full).isDirectory()) {
+            addDir(files, full, relPath);
+        }
+        else {
+            files[relPath] = new Uint8Array(readFileSync(full));
+        }
+    }
+}
+/**
+ * Zip the extension build into an in-memory buffer (the build is tiny — a few
+ * small JS/HTML/PNG files). Throws if no build is found.
+ */
+export async function zipExtensionDist() {
+    const dist = resolveExtensionDist();
+    if (!dist.exists) {
+        throw new Error("Extension build not found");
+    }
+    const files = {};
+    addDir(files, dist.path, "");
+    return Buffer.from(zipSync(files, { level: 6 }));
+}
+//# sourceMappingURL=extension-dist.js.map

package/dist/lib/extension-dist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-dist.js","sourceRoot":"","sources":["../../src/lib/extension-dist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AASjC,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAChD,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE5D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,IAAI,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAEhD,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,4EAA4E;AAC5E,SAAS,MAAM,CAAC,KAAiC,EAAE,GAAW,EAAE,GAAW;IACzE,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAChD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}