videobook-engine 2.0.1

package/dist/cas.js

@@ -0,0 +1,139 @@
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { constants, copyFile, mkdir, readFile, rename, rm, stat, writeFile, } from "node:fs/promises";
+import * as path from "node:path";
+import { v7 as uuidv7 } from "uuid";
+export class ObjectStore {
+    remote;
+    root;
+    prefix;
+    constructor(root, remote, prefix = "superlzy-media/videobook/sha256") {
+        this.remote = remote;
+        this.root = root;
+        this.prefix = prefix.replace(/^\/+|\/+$/g, "");
+    }
+    async put(data) {
+        const buffer = Buffer.isBuffer(data) ? data : Buffer.from(data);
+        const hash = createHash("sha256").update(buffer).digest("hex");
+        const destination = this.pathFor(hash);
+        await mkdir(path.dirname(destination), { recursive: true });
+        const temporary = `${destination}.${uuidv7()}.tmp`;
+        try {
+            await writeFile(temporary, buffer, { flag: "wx" });
+            try {
+                await rename(temporary, destination);
+            }
+            catch (error) {
+                if (error.code !== "EEXIST")
+                    throw error;
+            }
+        }
+        finally {
+            await rm(temporary, { force: true }).catch(() => undefined);
+        }
+        return { hash, size: buffer.byteLength, path: destination };
+    }
+    async import(sourcePath) {
+        const source = path.resolve(sourcePath);
+        const [hash, sourceStat] = await Promise.all([
+            hashFile(source),
+            stat(source),
+        ]);
+        const destination = this.pathFor(hash);
+        await mkdir(path.dirname(destination), { recursive: true });
+        try {
+            await copyFile(source, destination, constants.COPYFILE_EXCL);
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
+        return { hash, size: sourceStat.size, path: destination };
+    }
+    async read(hash) {
+        await this.ensureLocal(hash);
+        return readFile(this.pathFor(hash));
+    }
+    /**
+     * Makes a content-addressed object available locally and returns its path
+     * without copying it into an artifact workspace.
+     */
+    async ensureLocalPath(hash) {
+        await this.ensureLocal(hash);
+        return this.pathFor(hash);
+    }
+    async materialize(hash, destinationPath) {
+        await this.ensureLocal(hash);
+        await mkdir(path.dirname(destinationPath), { recursive: true });
+        await copyFile(this.pathFor(hash), destinationPath);
+    }
+    async publish(hash, expectedSize) {
+        if (!this.remote)
+            return;
+        const key = this.keyFor(hash);
+        const current = await this.remote.head(key);
+        if (!current.exists) {
+            await this.remote.uploadFile(key, this.pathFor(hash));
+        }
+        else if (current.size !== undefined &&
+            current.size !== expectedSize) {
+            throw new Error(`Remote object size mismatch: ${hash}`);
+        }
+        const verified = await this.remote.head(key);
+        if (!verified.exists) {
+            throw new Error(`Remote object verification failed: ${hash}`);
+        }
+        if (verified.size !== undefined &&
+            verified.size !== expectedSize) {
+            throw new Error(`Remote object size mismatch: ${hash}`);
+        }
+    }
+    pathFor(hash) {
+        validateHash(hash);
+        return path.join(this.root, hash.slice(0, 2), hash);
+    }
+    keyFor(hash) {
+        validateHash(hash);
+        return `${this.prefix}/${hash.slice(0, 2)}/${hash}`;
+    }
+    async ensureLocal(hash) {
+        const destination = this.pathFor(hash);
+        try {
+            await stat(destination);
+            return;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        if (!this.remote)
+            throw new Error(`Object unavailable: ${hash}`);
+        await mkdir(path.dirname(destination), { recursive: true });
+        const temporary = `${destination}.${uuidv7()}.download`;
+        try {
+            await this.remote.downloadFile(this.keyFor(hash), temporary);
+            await rename(temporary, destination);
+        }
+        finally {
+            await rm(temporary, { force: true }).catch(() => undefined);
+        }
+    }
+}
+async function hashFile(filePath) {
+    const hash = createHash("sha256");
+    await new Promise((resolve, reject) => {
+        const input = createReadStream(filePath);
+        input.on("data", (chunk) => {
+            hash.update(chunk);
+        });
+        input.on("error", reject);
+        input.on("end", resolve);
+    });
+    return hash.digest("hex");
+}
+function validateHash(hash) {
+    if (!/^[a-f0-9]{64}$/.test(hash)) {
+        throw new Error(`Invalid SHA-256 hash: ${hash}`);
+    }
+}
+//# sourceMappingURL=cas.js.map

package/dist/cas.js.map

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

package/dist/communications.d.ts

@@ -0,0 +1,15 @@
+import type { AppendMessageInput, EngineError, ListPromptHistoryArgs, Message, PromptHistoryEntry, RecordPromptArgs, Result } from "./engine-types.js";
+import { EngineContext } from "./context.js";
+export declare function createPromptsApi(context: EngineContext): {
+    record: (input: RecordPromptArgs) => Promise<Result<PromptHistoryEntry, EngineError>>;
+    list: (options?: ListPromptHistoryArgs) => Result<PromptHistoryEntry[], EngineError>;
+    count: (options?: Pick<ListPromptHistoryArgs, "surface">) => Result<number, EngineError>;
+};
+export declare function createMessagesApi(context: EngineContext): {
+    append: <T extends Record<string, unknown>>(input: AppendMessageInput<T>) => Promise<Result<Message<T>, EngineError>>;
+    list: <T = Record<string, unknown>>(options?: {
+        limit?: number;
+        role?: string;
+    }) => Result<Message<T>[], EngineError>;
+};
+//# sourceMappingURL=communications.d.ts.map

package/dist/communications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communications.d.ts","sourceRoot":"","sources":["../src/communications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AAmBrE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa;oBAG1C,gBAAgB,KACtB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;qBAGxC,qBAAqB,KAC7B,MAAM,CAAC,kBAAkB,EAAE,EAAE,WAAW,CAAC;sBAGjC,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,KAC9C,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;EAGjC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa;aAE3C,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SACjC,kBAAkB,CAAC,CAAC,CAAC,KAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;WACpC,CAAC,sCACG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KACzC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC;EAGvC"}

package/dist/communications.js

@@ -0,0 +1,139 @@
+import { ok } from "./engine-types.js";
+import { resultOf, syncResultOf } from "./context.js";
+import { canonicalJson, parseJson } from "./store.js";
+import { newUuidV7 } from "./ids.js";
+export function createPromptsApi(context) {
+    return {
+        record: (input) => recordPrompt(context, input),
+        list: (options = {}) => syncResultOf(() => listPrompts(context, options)),
+        count: (options = {}) => syncResultOf(() => countPrompts(context, options)),
+    };
+}
+export function createMessagesApi(context) {
+    return {
+        append: (input) => appendMessage(context, input),
+        list: (options = {}) => syncResultOf(() => listMessages(context, options)),
+    };
+}
+async function recordPrompt(context, input) {
+    return resultOf(async () => {
+        const surface = input.surface.trim();
+        const prompt = input.prompt.trim();
+        if (!surface || !prompt) {
+            throw new Error("Prompt surface and prompt are required");
+        }
+        const promptId = newUuidV7();
+        const mutation = await context.store.semantic({
+            operation: "record_prompt",
+            details: { surface },
+            writeSet: [`prompt:${promptId}`],
+        }, ["prompt_entries"], (_operationId, now) => {
+            context.store.db
+                .prepare(`INSERT INTO prompt_entries(
+              prompt_id, surface, prompt, context_json, created_at
+            ) VALUES (?, ?, ?, ?, ?)`)
+                .run(promptId, surface, prompt, canonicalJson(input.context ?? {}), now);
+            return promptId;
+        });
+        return ok(promptFromRow(requiredPrompt(context, mutation.value)), mutation.revision);
+    });
+}
+function listPrompts(context, options) {
+    const clauses = [];
+    const params = [];
+    if (options.surface) {
+        clauses.push("surface=?");
+        params.push(options.surface);
+    }
+    params.push(Math.max(1, options.limit ?? 100));
+    const rows = context.store.db
+        .prepare(`SELECT prompt_id, surface, prompt, context_json, created_at
+       FROM prompt_entries
+       ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""}
+       ORDER BY created_at DESC, prompt_id DESC
+       LIMIT ?`)
+        .all(...params);
+    return rows.map(promptFromRow);
+}
+function countPrompts(context, options) {
+    const row = options.surface
+        ? context.store.db
+            .prepare("SELECT COUNT(*) AS count FROM prompt_entries WHERE surface=?")
+            .get(options.surface)
+        : context.store.db
+            .prepare("SELECT COUNT(*) AS count FROM prompt_entries")
+            .get();
+    return row.count;
+}
+async function appendMessage(context, input) {
+    return resultOf(async () => {
+        const role = input.role.trim();
+        if (!role)
+            throw new Error("Message role is required");
+        const messageId = newUuidV7();
+        const mutation = await context.store.semantic({
+            operation: "append_message",
+            details: { messageId, role },
+            writeSet: [`message:${messageId}`],
+        }, ["messages"], (_operationId, now) => {
+            context.store.db
+                .prepare(`INSERT INTO messages(message_id, role, body_json, created_at)
+             VALUES (?, ?, ?, ?)`)
+                .run(messageId, role, canonicalJson(input.body), now);
+        });
+        return ok(messageFromRow(requiredMessage(context, messageId)), mutation.revision);
+    });
+}
+function listMessages(context, options) {
+    const clauses = [];
+    const params = [];
+    if (options.role) {
+        clauses.push("role=?");
+        params.push(options.role);
+    }
+    params.push(Math.max(1, options.limit ?? 100));
+    const rows = context.store.db
+        .prepare(`SELECT message_id, role, body_json, created_at
+       FROM messages
+       ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""}
+       ORDER BY created_at DESC, message_id DESC
+       LIMIT ?`)
+        .all(...params);
+    return rows.reverse().map((messageFromRow));
+}
+function requiredPrompt(context, promptId) {
+    const row = context.store.db
+        .prepare(`SELECT prompt_id, surface, prompt, context_json, created_at
+       FROM prompt_entries WHERE prompt_id=?`)
+        .get(promptId);
+    if (!row)
+        throw new Error(`Prompt not found after insert: ${promptId}`);
+    return row;
+}
+function requiredMessage(context, messageId) {
+    const row = context.store.db
+        .prepare(`SELECT message_id, role, body_json, created_at
+       FROM messages WHERE message_id=?`)
+        .get(messageId);
+    if (!row)
+        throw new Error(`Message not found after insert: ${messageId}`);
+    return row;
+}
+function promptFromRow(row) {
+    return {
+        id: row.prompt_id,
+        surface: row.surface,
+        prompt: row.prompt,
+        context: parseJson(row.context_json, {}),
+        createdAt: row.created_at,
+    };
+}
+function messageFromRow(row) {
+    return {
+        messageId: row.message_id,
+        role: row.role,
+        body: parseJson(row.body_json, {}),
+        createdAt: row.created_at,
+    };
+}
+//# sourceMappingURL=communications.js.map

package/dist/communications.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,42 @@
+import type { Artifact, ArtifactKind, Book, EngineConfig, EngineError, Result } from "./engine-types.js";
+import { ObjectStore } from "./cas.js";
+import { DoltStore } from "./store.js";
+interface BookRow {
+    book_id: string;
+    slug: string;
+    created_at: number;
+}
+export interface ArtifactRow {
+    artifact_id: string;
+    slug: string;
+    kind: ArtifactKind;
+    created_at: number;
+}
+export interface FileRow {
+    artifact_id: string;
+    path: string;
+    object_hash: string;
+    size_bytes: number;
+    mtime_ms: number;
+    created_at: number;
+}
+export declare class EngineContext {
+    readonly store: DoltStore;
+    readonly objects: ObjectStore;
+    readonly config: EngineConfig;
+    constructor(config: EngineConfig);
+    bookRow(): BookRow;
+    book(row?: BookRow): Book;
+    artifactRow(reference: string): ArtifactRow;
+    artifactRowById(artifactId: string): ArtifactRow;
+    artifact(row: ArtifactRow): Artifact;
+    artifactPath(artifactId: string): string;
+    ensureArtifactWorkspace(artifactId: string): string;
+    close(): void;
+}
+export declare function normalizeBookSlug(input: string): string;
+export declare function isValidBookSlug(input: string): boolean;
+export declare function resultOf<T>(work: () => Promise<Result<T, EngineError> | T>): Promise<Result<T, EngineError>>;
+export declare function syncResultOf<T>(work: () => T): Result<T, EngineError>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEpD,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAElB,MAAM,EAAE,YAAY;IA0DhC,OAAO,IAAI,OAAO;IAalB,IAAI,CAAC,GAAG,UAAiB,GAAG,IAAI;IAQhC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAqB3C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAiBhD,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,QAAQ;IAUpC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxC,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAMnD,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMtD;AAuCD,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAcjC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAMrE"}

package/dist/context.js

@@ -0,0 +1,197 @@
+import { existsSync, mkdirSync } from "node:fs";
+import * as path from "node:path";
+import { v7 as uuidv7 } from "uuid";
+import { err } from "./engine-types.js";
+import { ObjectStore } from "./cas.js";
+import { DoltStore, EngineFault } from "./store.js";
+export class EngineContext {
+    store;
+    objects;
+    config;
+    constructor(config) {
+        const storage = config.rootDir !== undefined
+            ? {
+                dataDir: path.join(path.resolve(config.rootDir), "data"),
+                workspaceDir: path.join(path.resolve(config.rootDir), "workspaces"),
+            }
+            : {
+                dataDir: path.resolve(config.dataDir),
+                workspaceDir: path.resolve(config.workspaceDir),
+            };
+        this.config = {
+            ...config,
+            ...storage,
+            rootDir: undefined,
+        };
+        if (storage.dataDir === storage.workspaceDir) {
+            throw new EngineFault({
+                code: "INVALID_INPUT",
+                message: "dataDir and workspaceDir must be different directories",
+            });
+        }
+        const databasePath = path.join(storage.dataDir, "videobook.db");
+        const initialBook = !existsSync(databasePath)
+            ? (() => {
+                if (!config.initialBookSlug) {
+                    throw new EngineFault({
+                        code: "INVALID_INPUT",
+                        message: "initialBookSlug is required when creating a new engine root",
+                    });
+                }
+                return {
+                    bookId: uuidv7(),
+                    slug: normalizeBookSlug(config.initialBookSlug),
+                };
+            })()
+            : undefined;
+        this.store = new DoltStore({
+            dataDir: this.config.dataDir,
+            workspaceDir: this.config.workspaceDir,
+            initialBook,
+            ...(config.catalogBackup
+                ? { catalogBackup: config.catalogBackup }
+                : {}),
+        });
+        this.objects = new ObjectStore(this.store.objectsDir, config.remoteObjects, config.objectPrefix);
+    }
+    bookRow() {
+        const row = this.store.db
+            .prepare("SELECT book_id, slug, created_at FROM book")
+            .get();
+        if (!row) {
+            throw new EngineFault({
+                code: "SCHEMA_INCOMPATIBLE",
+                message: "Book catalog is missing its singleton book record",
+            });
+        }
+        return row;
+    }
+    book(row = this.bookRow()) {
+        return {
+            bookId: row.book_id,
+            slug: row.slug,
+            createdAt: row.created_at,
+        };
+    }
+    artifactRow(reference) {
+        const row = this.store.db
+            .prepare(`SELECT artifact_id, slug, kind, created_at
+         FROM artifacts
+         WHERE artifact_id = ? OR slug = ?
+         ORDER BY CASE WHEN artifact_id = ? THEN 0 ELSE 1 END
+         LIMIT 1`)
+            .get(reference, reference, reference);
+        if (!row) {
+            throw new EngineFault({
+                code: "NOT_FOUND",
+                message: `Artifact not found: ${reference}`,
+            });
+        }
+        return row;
+    }
+    artifactRowById(artifactId) {
+        const row = this.store.db
+            .prepare(`SELECT artifact_id, slug, kind, created_at
+         FROM artifacts
+         WHERE artifact_id = ?`)
+            .get(artifactId);
+        if (!row) {
+            throw new EngineFault({
+                code: "NOT_FOUND",
+                message: `Artifact not found: ${artifactId}`,
+            });
+        }
+        return row;
+    }
+    artifact(row) {
+        return {
+            artifactId: row.artifact_id,
+            slug: row.slug,
+            kind: row.kind,
+            createdAt: row.created_at,
+            path: this.artifactPath(row.artifact_id),
+        };
+    }
+    artifactPath(artifactId) {
+        return path.join(this.store.workspaceDir, artifactId);
+    }
+    ensureArtifactWorkspace(artifactId) {
+        const workspace = this.artifactPath(artifactId);
+        mkdirSync(workspace, { recursive: true });
+        return workspace;
+    }
+    close() {
+        this.store.close();
+    }
+}
+export function normalizeBookSlug(input) {
+    const slug = input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    if (!slug || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {
+        throw new Error(`Invalid book slug: ${input}`);
+    }
+    return slug;
+}
+export function isValidBookSlug(input) {
+    try {
+        return normalizeBookSlug(input) === input;
+    }
+    catch {
+        return false;
+    }
+}
+function toError(error) {
+    if (error instanceof EngineFault)
+        return error.error;
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("artifacts_active_slug") ||
+        /UNIQUE constraint failed: artifacts\.slug/i.test(message)) {
+        return { code: "SLUG_CONFLICT", message };
+    }
+    if (/UNIQUE constraint failed/i.test(message)) {
+        return { code: "ALREADY_EXISTS", message };
+    }
+    if (/object unavailable/i.test(message)) {
+        return { code: "OBJECT_UNAVAILABLE", message };
+    }
+    if (error?.code === "ENOENT" ||
+        /not found/i.test(message)) {
+        return { code: "NOT_FOUND", message };
+    }
+    if (/already exists/i.test(message)) {
+        return { code: "ALREADY_EXISTS", message };
+    }
+    if (/\blocked\b|is locked/i.test(message)) {
+        return { code: "LOCKED", message };
+    }
+    if (/invalid|required|must |only terminal|outside the artifact workspace/i.test(message)) {
+        return { code: "INVALID_INPUT", message };
+    }
+    return { code: "IO_ERROR", message };
+}
+export async function resultOf(work) {
+    try {
+        const value = await work();
+        if (typeof value === "object" &&
+            value !== null &&
+            "ok" in value) {
+            return value;
+        }
+        return { ok: true, value: value };
+    }
+    catch (error) {
+        return err(toError(error));
+    }
+}
+export function syncResultOf(work) {
+    try {
+        return { ok: true, value: work() };
+    }
+    catch (error) {
+        return err(toError(error));
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/domain.d.ts

@@ -0,0 +1,32 @@
+import type { EntityDocument, EntityType, NotebookCell, NotebookDocument, NotebookEdge, NotebookRun } from "./notebook/types.js";
+import type { EngineError, Result, Revision } from "./engine-types.js";
+import { EngineContext } from "./context.js";
+type NewNotebookCell = Omit<NotebookCell, "id"> & {
+    id?: string;
+};
+type NewNotebookEdge = Omit<NotebookEdge, "id"> & {
+    id?: string;
+};
+export declare function createEntitiesApi(context: EngineContext): {
+    create: (type: EntityType, name: string, input?: Partial<EntityDocument>) => Promise<Result<EntityDocument, EngineError>>;
+    list: (type?: EntityType) => EntityDocument[];
+    read: (entityId: string) => Result<EntityDocument, EngineError>;
+    write: (entity: EntityDocument) => Promise<Result<Revision, EngineError>>;
+    delete: (entityId: string) => Promise<Result<{
+        entityId: string;
+    }, EngineError>>;
+};
+export declare function createNotebooksApi(context: EngineContext): {
+    create: (name: string) => Promise<Result<NotebookDocument, EngineError>>;
+    createCell: (input: NewNotebookCell) => NotebookCell;
+    createEdge: (input: NewNotebookEdge) => NotebookEdge;
+    list: () => NotebookDocument[];
+    read: (notebookId: string) => Result<NotebookDocument, EngineError>;
+    write: (notebook: NotebookDocument) => Promise<Result<Revision, EngineError>>;
+    delete: (notebookId: string) => Promise<Result<{
+        notebookId: string;
+    }, EngineError>>;
+    recordRun: (run: NotebookRun) => Promise<Result<Revision, EngineError>>;
+};
+export {};
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EACL,aAAa,EAGd,MAAM,cAAc,CAAC;AA0CtB,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa;mBAG5C,UAAU,QACV,MAAM,UACL,OAAO,CAAC,cAAc,CAAC,KAC7B,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;kBAEjC,UAAU,KAAG,cAAc,EAAE;qBAC1B,MAAM,KAAG,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC;oBAE7C,cAAc,KAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;uBAG3D,MAAM,KACf,OAAO,CAAC,MAAM,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,CAAC,CAAC;EAGxD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa;mBAEtC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;wBAElD,eAAe,KAAG,YAAY;wBAI9B,eAAe,KAAG,YAAY;gBAIxC,gBAAgB,EAAE;uBACT,MAAM,KAAG,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC;sBAGrD,gBAAgB,KACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;yBAE3B,MAAM,KACjB,OAAO,CAAC,MAAM,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,CAAC,CAAC;qBAEtC,WAAW,KAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;EAGxE"}