@party-stack/ontology 0.19.0 → 0.20.0

package/lib/live/LiveOntology.js

@@ -1,135 +1,109 @@
-import { createBlobManager } from "@party-stack/blobs";
-import { createDefaultRuntime } from "@party-stack/runtime";
 import { provide } from "../utils/provide.js";
 import { createLiveOntologyActions } from "./actions/createLiveOntologyActions.js";
-import { createLiveOntologyAttachments, } from "./attachments/createLiveOntologyAttachments.js";
+import { createLiveOntologyAttachments } from "./attachments/createLiveOntologyAttachments.js";
 import { unsupportedOntologyAttachmentsAdapter } from "./attachments/unsupportedOntologyAttachmentsAdapter.js";
 import { createLiveOntologyObjectCollection } from "./objects/createLiveOntologyObjectCollection.js";
 import { waitForCollectionsReady } from "./waitForCollectionReady.js";
+import { createBlobManager } from "@party-stack/blobs";
+import { createDefaultRuntime } from "@party-stack/runtime";
+//#region src/live/LiveOntology.ts
 function getContextUserId(context) {
-    return typeof context.user === "string" ? context.user : undefined;
+	return typeof context.user === "string" ? context.user : void 0;
 }
 /**
- * Waits for LiveOntology subsystems required before safe use.
- * Starts on-demand object collection sync without loading subsets.
- */
-export async function waitForLiveOntologyReady(ontology) {
-    await ontology.ready;
-    await waitForCollectionsReady(Object.values(ontology.objects));
+* Waits for LiveOntology subsystems required before safe use.
+* Starts on-demand object collection sync without loading subsets.
+*/
+async function waitForLiveOntologyReady(ontology) {
+	await ontology.ready;
+	await waitForCollectionsReady(Object.values(ontology.objects));
 }
-export async function createLiveOntology(opts) {
-    const ontologyId = opts.id ?? "default";
-    const context = (opts.context ?? {});
-    const owner = getContextUserId(context) ??
-        "anonymous";
-    // TODO(errors): Decorate backend operations and collection options so
-    // normalized errors (especially UnauthenticatedError) are reported through
-    // the ConnectionMonitor. Promise-based calls can be wrapped directly;
-    // long-running sync handlers need a lifecycle-aware supervisor that pauses
-    // on needs-auth and restarts from a checkpoint after reconnection.
-    const backendAdapter = await provide(opts.backend, opts.ir, context);
-    const runtime = await provide(opts.runtime ?? createDefaultRuntime, owner, ontologyId);
-    const attachmentsAdapter = backendAdapter.attachments ?? unsupportedOntologyAttachmentsAdapter;
-    const blobManager = createBlobManager({
-        runtime,
-        remote: {
-            read: (id, readOptions) => {
-                const attachmentValue = readOptions?.meta?.attachment;
-                return attachmentsAdapter.getAttachmentContent(attachmentValue ?? { id });
-            },
-            metadata: attachmentsAdapter.getAttachmentMetadata
-                ? (id, readOptions) => attachmentsAdapter.getAttachmentMetadata(readOptions?.meta?.attachment ?? { id }, readOptions?.select ?? ["size", "type", "name"])
-                : undefined,
-        },
-    });
-    const attachments = createLiveOntologyAttachments({
-        ir: opts.ir,
-        attachmentsAdapter,
-        blobManager,
-    });
-    const objects = Object.fromEntries(opts.ir.objectTypes.map((objectType) => [
-        objectType.name,
-        createLiveOntologyObjectCollection({
-            ir: opts.ir,
-            objectType,
-            backendAdapter,
-            runtime,
-            persistObjects: opts.persistObjects ?? false,
-        }),
-    ]));
-    const actionsSubsystem = createLiveOntologyActions({
-        ir: opts.ir,
-        backendAdapter,
-        runtime,
-        context,
-        objects,
-        blobManager,
-        writes: opts.writes,
-        connection: opts.connection,
-    });
-    const queryFunctions = Object.fromEntries(opts.ir.queryFunctionTypes.map((queryFunctionType) => [
-        queryFunctionType.name,
-        (parameters) => backendAdapter.runQueryFunction(queryFunctionType.name, parameters, {
-            objects: objects,
-            context,
-        }),
-    ]));
-    const ready = Promise.all([actionsSubsystem.outbox.ready, blobManager.ready]).then(() => undefined);
-    void ready.catch(() => undefined);
-    let cleanupPromise;
-    const cleanup = () => {
-        cleanupPromise ??= (async () => {
-            // Settle subsystem startups before tearing down persistence.
-            await Promise.allSettled([
-                ready,
-            ]);
-            await actionsSubsystem.outbox.cleanup();
-            await Promise.all(Object.values(objects).map(async (collection) => {
-                const status = collection.status;
-                if (status ===
-                    "cleaned-up") {
-                    return;
-                }
-                // Settle in-flight startup only; ready/idle need no preload.
-                if (status ===
-                    "loading") {
-                    await Promise.allSettled([
-                        collection.preload(),
-                    ]);
-                }
-                try {
-                    await collection.cleanup();
-                }
-                catch {
-                    // Idempotent: already cleaned up during preload race.
-                }
-            }));
-            await Promise.all([
-                blobManager.cleanup(),
-                backendAdapter.cleanup?.(),
-            ]);
-            await runtime.cleanup?.();
-        })();
-        return cleanupPromise;
-    };
-    let destroyPromise;
-    const destroy = () => {
-        destroyPromise ??= cleanup()
-            .then(() => runtime.destroy?.())
-            .then(() => undefined);
-        return destroyPromise;
-    };
-    return {
-        ir: opts.ir,
-        context: context,
-        ready,
-        objects: objects,
-        actions: actionsSubsystem.actions,
-        queryFunctions: queryFunctions,
-        attachments,
-        outbox: actionsSubsystem.outbox,
-        destroy,
-        cleanup,
-    };
+async function createLiveOntology(opts) {
+	const ontologyId = opts.id ?? "default";
+	const context = opts.context ?? {};
+	const owner = getContextUserId(context) ?? "anonymous";
+	const backendAdapter = await provide(opts.backend, opts.ir, context);
+	const runtime = await provide(opts.runtime ?? createDefaultRuntime, owner, ontologyId);
+	const attachmentsAdapter = backendAdapter.attachments ?? unsupportedOntologyAttachmentsAdapter;
+	const blobManager = createBlobManager({
+		runtime,
+		remote: {
+			read: (id, readOptions) => {
+				const attachmentValue = readOptions?.meta?.attachment;
+				return attachmentsAdapter.getAttachmentContent(attachmentValue ?? { id });
+			},
+			metadata: attachmentsAdapter.getAttachmentMetadata ? (id, readOptions) => attachmentsAdapter.getAttachmentMetadata(readOptions?.meta?.attachment ?? { id }, readOptions?.select ?? [
+				"size",
+				"type",
+				"name"
+			]) : void 0
+		}
+	});
+	const attachments = createLiveOntologyAttachments({
+		ir: opts.ir,
+		attachmentsAdapter,
+		blobManager
+	});
+	const objects = Object.fromEntries(opts.ir.objectTypes.map((objectType) => [objectType.name, createLiveOntologyObjectCollection({
+		ir: opts.ir,
+		objectType,
+		backendAdapter,
+		runtime,
+		persistObjects: opts.persistObjects ?? false
+	})]));
+	const actionsSubsystem = createLiveOntologyActions({
+		ir: opts.ir,
+		backendAdapter,
+		runtime,
+		context,
+		objects,
+		blobManager,
+		writes: opts.writes,
+		connection: opts.connection
+	});
+	const queryFunctions = Object.fromEntries(opts.ir.queryFunctionTypes.map((queryFunctionType) => [queryFunctionType.name, (parameters) => backendAdapter.runQueryFunction(queryFunctionType.name, parameters, {
+		objects,
+		context
+	})]));
+	const ready = Promise.all([actionsSubsystem.outbox.ready, blobManager.ready]).then(() => void 0);
+	ready.catch(() => void 0);
+	let cleanupPromise;
+	const cleanup = () => {
+		cleanupPromise ??= (async () => {
+			await Promise.allSettled([ready]);
+			await actionsSubsystem.outbox.cleanup();
+			await Promise.all(Object.values(objects).map(async (collection) => {
+				const status = collection.status;
+				if (status === "cleaned-up") return;
+				if (status === "loading") await Promise.allSettled([collection.preload()]);
+				try {
+					await collection.cleanup();
+				} catch {}
+			}));
+			await Promise.all([blobManager.cleanup(), backendAdapter.cleanup?.()]);
+			await runtime.cleanup?.();
+		})();
+		return cleanupPromise;
+	};
+	let destroyPromise;
+	const destroy = () => {
+		destroyPromise ??= cleanup().then(() => runtime.destroy?.()).then(() => void 0);
+		return destroyPromise;
+	};
+	return {
+		ir: opts.ir,
+		context,
+		ready,
+		objects,
+		actions: actionsSubsystem.actions,
+		queryFunctions,
+		attachments,
+		outbox: actionsSubsystem.outbox,
+		destroy,
+		cleanup
+	};
 }
+//#endregion
+export { createLiveOntology, waitForLiveOntologyReady };
+
 //# sourceMappingURL=LiveOntology.js.map

package/lib/live/LiveOntology.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiveOntology.js","sourceRoot":"","sources":["../../src/live/LiveOntology.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LiveOntology.js","names":[],"sources":["../../src/live/LiveOntology.ts"],"sourcesContent":["import { createBlobManager, type BlobManager } from \"@party-stack/blobs\";\nimport { createDefaultRuntime, type RuntimeAdapterProvider } from \"@party-stack/runtime\";\nimport { type Collection } from \"@tanstack/db\";\nimport { provide } from \"../utils/provide.js\";\nimport { createLiveOntologyActions } from \"./actions/createLiveOntologyActions.js\";\nimport {\n    createLiveOntologyAttachments,\n    type LiveOntologyAttachments,\n} from \"./attachments/createLiveOntologyAttachments.js\";\nimport { unsupportedOntologyAttachmentsAdapter } from \"./attachments/unsupportedOntologyAttachmentsAdapter.js\";\nimport { createLiveOntologyObjectCollection } from \"./objects/createLiveOntologyObjectCollection.js\";\nimport { waitForCollectionsReady } from \"./waitForCollectionReady.js\";\nimport type { OntologyIR } from \"../ir/index.js\";\nimport type { attachment } from \"../utils/values.js\";\nimport type { LiveOntologyAction } from \"./actions/createLiveOntologyAction.js\";\nimport type { OntologyMutatorRegistry } from \"./mutators/types.js\";\nimport type { OntologyCollection } from \"./objects/createLiveOntologyObjectCollection.js\";\nimport type { OntologyObject } from \"./objects/OntologyObject.js\";\nimport type { OntologyBackendAdapter, OntologyBackendAdapterProvider } from \"./OntologyBackendAdapter.js\";\nimport type { OntologyOutbox } from \"./outbox/types.js\";\nimport type { ConnectionMonitor } from \"@party-stack/connections\";\n\nexport type { LiveOntologyAction, LiveOntologyActionOptions } from \"./actions/createLiveOntologyAction.js\";\nexport type { LiveOntologyAttachments } from \"./attachments/createLiveOntologyAttachments.js\";\nexport type { OntologyCollection } from \"./objects/createLiveOntologyObjectCollection.js\";\n\nexport type LiveOntologyWriteMode = \"direct\" | \"outbox\";\n\nexport type LiveOntologyWriteVisibility = \"confirmed\" | \"optimistic\";\n\nexport type LiveOntologyOutboxFailureStrategy = \"pause\" | \"discard-all\";\n\nexport interface LiveOntologyOutboxOptions {\n    failureStrategy?: LiveOntologyOutboxFailureStrategy;\n    maxRetries?: number;\n}\n\nexport interface LiveOntologyWrites {\n    defaultMode?: LiveOntologyWriteMode;\n    defaultVisibility?: LiveOntologyWriteVisibility;\n    mutators?: OntologyMutatorRegistry;\n    outbox?: LiveOntologyOutboxOptions;\n}\n\nexport interface OntologyDefinition {\n    context?: Record<string, unknown>;\n    objectTypes: Record<string, OntologyObject>;\n    actionTypes: Record<\n        string,\n        {\n            parameters: Record<string, unknown>;\n        }\n    >;\n    queryFunctionTypes: Record<\n        string,\n        {\n            parameters: Record<string, unknown>;\n            returnType: unknown;\n        }\n    >;\n}\n\ntype OntologyContext<Ontology extends OntologyDefinition> = Ontology extends {\n    context: infer Context extends Record<string, unknown>;\n}\n    ? Context\n    : Record<string, unknown>;\n\nexport type LiveOntologyQueryFunction<\n    Parameters extends Record<string, unknown> = Record<string, unknown>,\n    Return = unknown,\n> = (parameters: Parameters) => Promise<Return>;\n\nexport type LiveOntologyObjects<\n    ObjectTypes extends OntologyDefinition[\"objectTypes\"] = OntologyDefinition[\"objectTypes\"],\n> = {\n    [ObjectTypeName in keyof ObjectTypes]: OntologyCollection<ObjectTypes[ObjectTypeName]>;\n};\n\nexport type LiveOntologyActions<ActionTypes extends OntologyDefinition[\"actionTypes\"]> = {\n    [ActionTypeName in keyof ActionTypes]: LiveOntologyAction<ActionTypes[ActionTypeName][\"parameters\"]>;\n};\n\nexport type LiveOntologyQueryFunctions<QueryFunctionTypes extends OntologyDefinition[\"queryFunctionTypes\"]> =\n    {\n        [QueryFunctionTypeName in keyof QueryFunctionTypes]: LiveOntologyQueryFunction<\n            QueryFunctionTypes[QueryFunctionTypeName][\"parameters\"],\n            QueryFunctionTypes[QueryFunctionTypeName][\"returnType\"]\n        >;\n    };\n\nexport interface LiveOntology<Ontology extends OntologyDefinition = OntologyDefinition> {\n    readonly ir: OntologyIR;\n    readonly context: OntologyContext<Ontology>;\n    /**\n     * Resolves once outbox and blob metadata subsystems have finished starting.\n     * Object collections remain on-demand unless explicitly preloaded.\n     */\n    readonly ready: Promise<void>;\n    objects: LiveOntologyObjects<Ontology[\"objectTypes\"]>;\n    actions: LiveOntologyActions<Ontology[\"actionTypes\"]>;\n    queryFunctions: LiveOntologyQueryFunctions<Ontology[\"queryFunctionTypes\"]>;\n    attachments: LiveOntologyAttachments<Ontology>;\n    outbox: OntologyOutbox;\n    cleanup: () => Promise<void>;\n    destroy: () => Promise<void>;\n}\n\nexport interface CreateLiveOntologyOpts<Context extends Record<string, unknown> = Record<string, unknown>> {\n    id?: string;\n    ir: OntologyIR;\n    backend: OntologyBackendAdapterProvider<NoInfer<Context>>;\n    runtime?: RuntimeAdapterProvider;\n    persistObjects?: boolean;\n    writes?: LiveOntologyWrites;\n    context?: Context;\n    connection?: ConnectionMonitor;\n}\n\nfunction getContextUserId(context: Record<string, unknown>): string | undefined {\n    return typeof context.user === \"string\" ? context.user : undefined;\n}\n\n/**\n * Waits for LiveOntology subsystems required before safe use.\n * Starts on-demand object collection sync without loading subsets.\n */\nexport async function waitForLiveOntologyReady(ontology: LiveOntology): Promise<void> {\n    await ontology.ready;\n    await waitForCollectionsReady(\n        Object.values(ontology.objects) as Collection<Record<string, unknown>, string | number>[]\n    );\n}\n\nexport async function createLiveOntology<\n    Ontology extends OntologyDefinition = OntologyDefinition,\n    Context extends Record<string, unknown> = Record<string, unknown>,\n>(opts: CreateLiveOntologyOpts<Context>): Promise<LiveOntology<Ontology>> {\n    const ontologyId = opts.id ?? \"default\";\n    const context = (opts.context ?? {}) as Context;\n    const owner = getContextUserId(context) ?? \"anonymous\";\n    // TODO(errors): Decorate backend operations and collection options so\n    // normalized errors (especially UnauthenticatedError) are reported through\n    // the ConnectionMonitor. Promise-based calls can be wrapped directly;\n    // long-running sync handlers need a lifecycle-aware supervisor that pauses\n    // on needs-auth and restarts from a checkpoint after reconnection.\n    const backendAdapter: OntologyBackendAdapter = await provide(opts.backend, opts.ir, context);\n    const runtime = await provide(opts.runtime ?? createDefaultRuntime, owner, ontologyId);\n    const attachmentsAdapter = backendAdapter.attachments ?? unsupportedOntologyAttachmentsAdapter;\n    const blobManager: BlobManager = createBlobManager({\n        runtime,\n        remote: {\n            read: (id, readOptions) => {\n                const attachmentValue = readOptions?.meta?.attachment as attachment | undefined;\n                return attachmentsAdapter.getAttachmentContent(attachmentValue ?? { id });\n            },\n            metadata: attachmentsAdapter.getAttachmentMetadata\n                ? (id, readOptions) =>\n                      attachmentsAdapter.getAttachmentMetadata!(\n                          (readOptions?.meta?.attachment as attachment | undefined) ?? { id },\n                          readOptions?.select ?? [\"size\", \"type\", \"name\"]\n                      )\n                : undefined,\n        },\n    });\n    const attachments = createLiveOntologyAttachments<Ontology>({\n        ir: opts.ir,\n        attachmentsAdapter,\n        blobManager,\n    });\n    const objects = Object.fromEntries(\n        opts.ir.objectTypes.map((objectType) => [\n            objectType.name,\n            createLiveOntologyObjectCollection({\n                ir: opts.ir,\n                objectType,\n                backendAdapter,\n                runtime,\n                persistObjects: opts.persistObjects ?? false,\n            }),\n        ])\n    ) as Record<string, OntologyCollection<OntologyObject>>;\n    const actionsSubsystem = createLiveOntologyActions({\n        ir: opts.ir,\n        backendAdapter,\n        runtime,\n        context,\n        objects,\n        blobManager,\n        writes: opts.writes,\n        connection: opts.connection,\n    });\n    const queryFunctions = Object.fromEntries(\n        opts.ir.queryFunctionTypes.map((queryFunctionType) => [\n            queryFunctionType.name,\n            (parameters: Record<string, unknown>) =>\n                backendAdapter.runQueryFunction(queryFunctionType.name, parameters, {\n                    objects: objects,\n                    context,\n                }),\n        ])\n    );\n    const ready = Promise.all([actionsSubsystem.outbox.ready, blobManager.ready]).then(() => undefined);\n    void ready.catch(() => undefined);\n\n    let cleanupPromise: Promise<void> | undefined;\n    const cleanup = (): Promise<void> => {\n        cleanupPromise ??= (async () => {\n            // Settle subsystem startups before tearing down persistence.\n            await Promise.allSettled([ready]);\n            await actionsSubsystem.outbox.cleanup();\n            await Promise.all(\n                Object.values(objects).map(async (collection) => {\n                    const status = collection.status;\n                    if (status === \"cleaned-up\") {\n                        return;\n                    }\n                    // Settle in-flight startup only; ready/idle need no preload.\n                    if (status === \"loading\") {\n                        await Promise.allSettled([collection.preload()]);\n                    }\n                    try {\n                        await collection.cleanup();\n                    } catch {\n                        // Idempotent: already cleaned up during preload race.\n                    }\n                })\n            );\n            await Promise.all([blobManager.cleanup(), backendAdapter.cleanup?.()]);\n            await runtime.cleanup?.();\n        })();\n        return cleanupPromise;\n    };\n    let destroyPromise: Promise<void> | undefined;\n    const destroy = (): Promise<void> => {\n        destroyPromise ??= cleanup()\n            .then(() => runtime.destroy?.())\n            .then(() => undefined);\n        return destroyPromise;\n    };\n\n    return {\n        ir: opts.ir,\n        context: context as unknown as OntologyContext<Ontology>,\n        ready,\n        objects: objects as unknown as LiveOntologyObjects<Ontology[\"objectTypes\"]>,\n        actions: actionsSubsystem.actions as unknown as LiveOntologyActions<Ontology[\"actionTypes\"]>,\n        queryFunctions: queryFunctions as unknown as LiveOntologyQueryFunctions<\n            Ontology[\"queryFunctionTypes\"]\n        >,\n        attachments,\n        outbox: actionsSubsystem.outbox,\n        destroy,\n        cleanup,\n    };\n}\n"],"mappings":";;;;;;;;;AAuHA,SAAS,iBAAiB,SAAsD;CAC5E,OAAO,OAAO,QAAQ,SAAS,WAAW,QAAQ,OAAO,KAAA;AAC7D;;;;;AAMA,eAAsB,yBAAyB,UAAuC;CAClF,MAAM,SAAS;CACf,MAAM,wBACF,OAAO,OAAO,SAAS,OAAO,CAClC;AACJ;AAEA,eAAsB,mBAGpB,MAAwE;CACtE,MAAM,aAAa,KAAK,MAAM;CAC9B,MAAM,UAAW,KAAK,WAAW,CAAC;CAClC,MAAM,QAAQ,iBAAiB,OAAO,KAAK;CAM3C,MAAM,iBAAyC,MAAM,QAAQ,KAAK,SAAS,KAAK,IAAI,OAAO;CAC3F,MAAM,UAAU,MAAM,QAAQ,KAAK,WAAW,sBAAsB,OAAO,UAAU;CACrF,MAAM,qBAAqB,eAAe,eAAe;CACzD,MAAM,cAA2B,kBAAkB;EAC/C;EACA,QAAQ;GACJ,OAAO,IAAI,gBAAgB;IACvB,MAAM,kBAAkB,aAAa,MAAM;IAC3C,OAAO,mBAAmB,qBAAqB,mBAAmB,EAAE,GAAG,CAAC;GAC5E;GACA,UAAU,mBAAmB,yBACtB,IAAI,gBACD,mBAAmB,sBACd,aAAa,MAAM,cAAyC,EAAE,GAAG,GAClE,aAAa,UAAU;IAAC;IAAQ;IAAQ;GAAM,CAClD,IACJ,KAAA;EACV;CACJ,CAAC;CACD,MAAM,cAAc,8BAAwC;EACxD,IAAI,KAAK;EACT;EACA;CACJ,CAAC;CACD,MAAM,UAAU,OAAO,YACnB,KAAK,GAAG,YAAY,KAAK,eAAe,CACpC,WAAW,MACX,mCAAmC;EAC/B,IAAI,KAAK;EACT;EACA;EACA;EACA,gBAAgB,KAAK,kBAAkB;CAC3C,CAAC,CACL,CAAC,CACL;CACA,MAAM,mBAAmB,0BAA0B;EAC/C,IAAI,KAAK;EACT;EACA;EACA;EACA;EACA;EACA,QAAQ,KAAK;EACb,YAAY,KAAK;CACrB,CAAC;CACD,MAAM,iBAAiB,OAAO,YAC1B,KAAK,GAAG,mBAAmB,KAAK,sBAAsB,CAClD,kBAAkB,OACjB,eACG,eAAe,iBAAiB,kBAAkB,MAAM,YAAY;EACvD;EACT;CACJ,CAAC,CACT,CAAC,CACL;CACA,MAAM,QAAQ,QAAQ,IAAI,CAAC,iBAAiB,OAAO,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,KAAA,CAAS;CAClG,MAAW,YAAY,KAAA,CAAS;CAEhC,IAAI;CACJ,MAAM,gBAA+B;EACjC,oBAAoB,YAAY;GAE5B,MAAM,QAAQ,WAAW,CAAC,KAAK,CAAC;GAChC,MAAM,iBAAiB,OAAO,QAAQ;GACtC,MAAM,QAAQ,IACV,OAAO,OAAO,OAAO,CAAC,CAAC,IAAI,OAAO,eAAe;IAC7C,MAAM,SAAS,WAAW;IAC1B,IAAI,WAAW,cACX;IAGJ,IAAI,WAAW,WACX,MAAM,QAAQ,WAAW,CAAC,WAAW,QAAQ,CAAC,CAAC;IAEnD,IAAI;KACA,MAAM,WAAW,QAAQ;IAC7B,QAAQ,CAER;GACJ,CAAC,CACL;GACA,MAAM,QAAQ,IAAI,CAAC,YAAY,QAAQ,GAAG,eAAe,UAAU,CAAC,CAAC;GACrE,MAAM,QAAQ,UAAU;EAC5B,EAAA,CAAG;EACH,OAAO;CACX;CACA,IAAI;CACJ,MAAM,gBAA+B;EACjC,mBAAmB,QAAQ,CAAC,CACvB,WAAW,QAAQ,UAAU,CAAC,CAAC,CAC/B,WAAW,KAAA,CAAS;EACzB,OAAO;CACX;CAEA,OAAO;EACH,IAAI,KAAK;EACA;EACT;EACS;EACT,SAAS,iBAAiB;EACV;EAGhB;EACA,QAAQ,iBAAiB;EACzB;EACA;CACJ;AACJ"}

package/lib/live/OntologyBackendAdapter.d.ts

@@ -1,97 +1,104 @@
-import * as v from "../utils/values.js";
-import type { AttachmentTypeDef, OntologyIR } from "../ir/index.js";
-import type { Uncertain } from "../utils/uncertain.js";
-import type { ValidationIssue } from "../utils/validation.js";
-import type { PartialAttachmentMetadata } from "./attachments/types.js";
-import type { Collection, CollectionConfig } from "@tanstack/db";
-export type OntologyCollectionOptions = Omit<CollectionConfig<Record<string, unknown>, string | number>, "getKey">;
+import { Result, attachment } from "../utils/values.js";
+import { AttachmentTypeDef, OntologyIR } from "../ir/generated/types.js";
+import { ValidationIssue } from "../utils/validation.js";
+import "../ir/index.js";
+import { Uncertain } from "../utils/uncertain.js";
+import { PartialAttachmentMetadata } from "./attachments/types.js";
+import { Collection, CollectionConfig, UtilsRecord } from "@tanstack/db";
+//#region src/live/OntologyBackendAdapter.d.ts
+export interface OntologyCollectionUtils extends UtilsRecord {
+  /** Fetch and atomically replace the source snapshot, when supported by the adapter. */
+  refresh?: () => Promise<void>;
+}
+export type OntologyCollectionOptions = Omit<CollectionConfig<Record<string, unknown>, string | number, never, OntologyCollectionUtils>, "getKey">;
 export interface OntologyAttachmentUpload {
-    /**
-     * The attachment referenced by the prepared action parameters. Its ID is an
-     * opaque local handle and is not guaranteed to be valid for the backend.
-     */
-    attachment: v.attachment;
-    blob: Blob;
-    target?: AttachmentTypeDef;
+  /**
+   * The attachment referenced by the prepared action parameters. Its ID is an
+   * opaque local handle and is not guaranteed to be valid for the backend.
+   */
+  attachment: attachment;
+  blob: Blob;
+  target?: AttachmentTypeDef;
 }
 export interface OntologyAttachmentIdMapping {
-    /** The opaque attachment ID used before the backend canonicalized it. */
-    localId: string;
-    /** The canonical attachment ID returned by the backend. */
-    remoteId: string;
+  /** The opaque attachment ID used before the backend canonicalized it. */
+  localId: string;
+  /** The canonical attachment ID returned by the backend. */
+  remoteId: string;
 }
 export interface OntologyApplyActionResult {
-    /**
-     * Mappings for uploaded attachments whose canonical backend IDs differ from
-     * the local IDs supplied in `ApplyActionLiveOpts.attachmentUploads`.
-     */
-    attachmentIdMappings?: OntologyAttachmentIdMapping[];
+  /**
+   * Mappings for uploaded attachments whose canonical backend IDs differ from
+   * the local IDs supplied in `ApplyActionLiveOpts.attachmentUploads`.
+   */
+  attachmentIdMappings?: OntologyAttachmentIdMapping[];
 }
 export interface ApplyActionLiveOpts {
-    objects: Record<string, Collection<Record<string, unknown>>>;
-    context?: Record<string, unknown>;
-    /**
-     * Attachments that must be uploaded as part of action execution. Adapters
-     * must treat their IDs as opaque local handles, substitute any backend IDs or
-     * references required by the action invocation, and return an ID mapping for
-     * every upload whose canonical backend ID differs.
-     */
-    attachmentUploads?: OntologyAttachmentUpload[];
-    idempotencyKey?: string;
+  objects: Record<string, Collection<Record<string, unknown>>>;
+  context?: Record<string, unknown>;
+  /**
+   * Attachments that must be uploaded as part of action execution. Adapters
+   * must treat their IDs as opaque local handles, substitute any backend IDs or
+   * references required by the action invocation, and return an ID mapping for
+   * every upload whose canonical backend ID differs.
+   */
+  attachmentUploads?: OntologyAttachmentUpload[];
+  idempotencyKey?: string;
 }
 export interface ValidateActionLiveOpts {
-    objects: Record<string, Collection<Record<string, unknown>>>;
-    context?: Record<string, unknown>;
+  objects: Record<string, Collection<Record<string, unknown>>>;
+  context?: Record<string, unknown>;
 }
 export interface ValidateActionDraftLiveOpts extends ValidateActionLiveOpts {
-    knownParameters: readonly string[];
+  knownParameters: readonly string[];
 }
 export interface RunQueryLiveOpts {
-    objects: Record<string, Collection<Record<string, unknown>>>;
-    context?: Record<string, unknown>;
+  objects: Record<string, Collection<Record<string, unknown>>>;
+  context?: Record<string, unknown>;
 }
 export interface OntologyAttachmentsAdapter {
-    /**
-     * Generates a preferred ID for an attachment created directly against this adapter.
-     *
-     * This is a hint, not an invariant. Attachments can arrive with IDs generated elsewhere,
-     * so adapters must accept IDs downstream that were not produced by this function.
-     */
-    generateAttachmentId?: (blob: Blob, opts: {
-        target?: AttachmentTypeDef;
-    }) => Promise<string> | string;
-    canMaterializeAttachment?: (attachment: v.attachment, opts: {
-        target?: AttachmentTypeDef;
-    }) => boolean;
-    /**
-     * Materializes an attachment in the backend.
-     *
-     * The incoming attachment ID is opaque and may not be valid for this backend. When
-     * the backend assigns or requires another ID, return an attachment containing that
-     * canonical ID so the caller can rewrite parameters and bind the resulting mapping.
-     */
-    materializeAttachment?: (attachment: v.attachment, blob: Blob, opts: {
-        target?: AttachmentTypeDef;
-    }) => Promise<v.attachment | void>;
-    getAttachmentContent: (attachment: v.attachment) => Promise<Blob>;
-    getAttachmentMetadata?: (attachment: v.attachment, selection: readonly (keyof PartialAttachmentMetadata)[]) => Promise<PartialAttachmentMetadata>;
+  /**
+   * Generates a preferred ID for an attachment created directly against this adapter.
+   *
+   * This is a hint, not an invariant. Attachments can arrive with IDs generated elsewhere,
+   * so adapters must accept IDs downstream that were not produced by this function.
+   */
+  generateAttachmentId?: (blob: Blob, opts: {
+    target?: AttachmentTypeDef;
+  }) => Promise<string> | string;
+  canMaterializeAttachment?: (attachment: attachment, opts: {
+    target?: AttachmentTypeDef;
+  }) => boolean;
+  /**
+   * Materializes an attachment in the backend.
+   *
+   * The incoming attachment ID is opaque and may not be valid for this backend. When
+   * the backend assigns or requires another ID, return an attachment containing that
+   * canonical ID so the caller can rewrite parameters and bind the resulting mapping.
+   */
+  materializeAttachment?: (attachment: attachment, blob: Blob, opts: {
+    target?: AttachmentTypeDef;
+  }) => Promise<attachment | void>;
+  getAttachmentContent: (attachment: attachment) => Promise<Blob>;
+  getAttachmentMetadata?: (attachment: attachment, selection: readonly (keyof PartialAttachmentMetadata)[]) => Promise<PartialAttachmentMetadata>;
 }
 export interface OntologyBackendAdapter {
-    name: string;
-    /**
-     * Whether this adapter participates in long-lived synchronization.
-     *
-     * Defaults to true. Non-live adapters support confirmed request/response
-     * operations but cannot safely back optimistic actions.
-     */
-    live?: boolean;
-    getCollectionOptions: (objectType: string) => OntologyCollectionOptions;
-    applyAction: (name: string, parameters: Record<string, unknown>, live: ApplyActionLiveOpts) => Promise<OntologyApplyActionResult | void>;
-    validateAction?: (name: string, parameters: Record<string, unknown>, live: ValidateActionLiveOpts) => Promise<Uncertain<v.Result<void, readonly ValidationIssue[]>>>;
-    validateActionDraft?: (name: string, parameters: Record<string, unknown>, live: ValidateActionDraftLiveOpts) => Promise<Uncertain<v.Result<void, readonly ValidationIssue[]>>>;
-    runQueryFunction: (name: string, parameters: Record<string, unknown>, live: RunQueryLiveOpts) => Promise<unknown>;
-    attachments?: OntologyAttachmentsAdapter;
-    cleanup?: () => void | Promise<void>;
+  name: string;
+  /**
+   * Whether this adapter participates in long-lived synchronization.
+   *
+   * Defaults to true. Non-live adapters support confirmed request/response
+   * operations but cannot safely back optimistic actions.
+   */
+  live?: boolean;
+  getCollectionOptions: (objectType: string) => OntologyCollectionOptions;
+  applyAction: (name: string, parameters: Record<string, unknown>, live: ApplyActionLiveOpts) => Promise<OntologyApplyActionResult | void>;
+  validateAction?: (name: string, parameters: Record<string, unknown>, live: ValidateActionLiveOpts) => Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
+  validateActionDraft?: (name: string, parameters: Record<string, unknown>, live: ValidateActionDraftLiveOpts) => Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
+  runQueryFunction: (name: string, parameters: Record<string, unknown>, live: RunQueryLiveOpts) => Promise<unknown>;
+  attachments?: OntologyAttachmentsAdapter;
+  cleanup?: () => void | Promise<void>;
 }
 export type OntologyBackendAdapterProvider<Context extends Record<string, unknown> = Record<string, unknown>> = (ir: OntologyIR, context: Context) => OntologyBackendAdapter | Promise<OntologyBackendAdapter>;
+//#endregion
 //# sourceMappingURL=OntologyBackendAdapter.d.ts.map

package/lib/live/OntologyBackendAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OntologyBackendAdapter.d.ts","names":["v.attachment","v.Result"],"sources":["../../src/live/OntologyBackendAdapter.ts"],"mappings":";;;;;;;;iBAOiB,gCAAgC;;EAE7C,gBAAgB;;YAGR,4BAA4B,KACpC,iBAAiB,iDAAiD;iBAIrD;;;;;EAKb,YAAYA;EACZ,MAAM;EACN,SAAS;;iBAGI;;EAEb;;EAEA;;iBAGa;;;;;EAKb,uBAAuB;;iBAGV;EACb,SAAS,eAAe,WAAW;EACnC,UAAU;;;;;;;EAOV,oBAAoB;EACpB;;iBAGa;EACb,SAAS,eAAe,WAAW;EACnC,UAAU;;iBAGG,oCAAoC;EACjD;;iBAGa;EACb,SAAS,eAAe,WAAW;EACnC,UAAU;;iBAGG;;;;;;;EAOb,wBACI,MAAM,MACN;IACI,SAAS;QAEZ;EACL,4BACI,YAAYA,YACZ;IACI,SAAS;;;;;;;;;EAUjB,yBACI,YAAYA,YACZ,MAAM,MACN;IACI,SAAS;QAEZ,QAAQA;EACb,uBAAuB,YAAYA,eAAiB,QAAQ;EAC5D,yBACI,YAAYA,YACZ,2BAA2B,iCAC1B,QAAQ;;iBAGA;EACb;;;;;;;EAOA;EACA,uBAAuB,uBAAuB;EAC9C,cACI,cACA,YAAY,yBACZ,MAAM,wBACL,QAAQ;EACb,kBACI,cACA,YAAY,yBACZ,MAAM,2BACL,QAAQ,UAAUC,sBAAwB;EAC/C,uBACI,cACA,YAAY,yBACZ,MAAM,gCACL,QAAQ,UAAUA,sBAAwB;EAC/C,mBACI,cACA,YAAY,yBACZ,MAAM,qBACL;EACL,cAAc;EACd,uBAAuB;;YAIf,+BACR,gBAAgB,0BAA0B,4BACzC,IAAI,YAAY,SAAS,YAAY,yBAAyB,QAAQ"}

package/lib/live/OntologyBackendAdapter.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=OntologyBackendAdapter.js.map

package/lib/live/actions/createLiveOntologyAction.d.ts

@@ -1,33 +1,36 @@
-import type { OntologyIR } from "../../ir/index.js";
-import type { Uncertain } from "../../utils/uncertain.js";
-import type { ValidationIssue } from "../../utils/validation.js";
-import type { Result } from "../../utils/values.js";
-import type { LiveOntologyWriteMode, LiveOntologyWriteVisibility } from "../LiveOntology.js";
-import type { OntologyCollection } from "../objects/createLiveOntologyObjectCollection.js";
-import type { OntologyObject } from "../objects/OntologyObject.js";
-import type { OntologyApplyActionResult } from "../OntologyBackendAdapter.js";
-import type { OntologyActionRequest } from "../outbox/types.js";
+import { Result } from "../../utils/values.js";
+import { OntologyIR } from "../../ir/generated/types.js";
+import { ValidationIssue } from "../../utils/validation.js";
+import "../../ir/index.js";
+import { Uncertain } from "../../utils/uncertain.js";
+import { OntologyApplyActionResult } from "../OntologyBackendAdapter.js";
+import { OntologyObject } from "../objects/OntologyObject.js";
+import { OntologyCollection } from "../objects/createLiveOntologyObjectCollection.js";
+import { OntologyActionRequest } from "../outbox/types.js";
+import { LiveOntologyWriteMode, LiveOntologyWriteVisibility } from "../LiveOntology.js";
+//#region src/live/actions/createLiveOntologyAction.d.ts
 export interface LiveOntologyActionOptions {
-    idempotencyKey?: string;
-    mode?: LiveOntologyWriteMode;
-    visibility?: LiveOntologyWriteVisibility;
+  idempotencyKey?: string;
+  mode?: LiveOntologyWriteMode;
+  visibility?: LiveOntologyWriteVisibility;
 }
 export interface LiveOntologyActionDraftValidationOptions<Parameters extends Record<string, unknown>> {
-    knownParameters?: readonly (keyof Parameters)[];
+  knownParameters?: readonly (keyof Parameters)[];
 }
 export type LiveOntologyAction<Parameters extends Record<string, unknown> = Record<string, unknown>> = {
-    (parameters: Parameters, options?: LiveOntologyActionOptions): Promise<OntologyApplyActionResult | void>;
-    resolveParameters(parameters: Partial<Parameters>): Promise<Partial<Parameters>>;
-    validate(parameters: Parameters): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
-    validateDraft(parameters: Partial<Parameters>, options?: LiveOntologyActionDraftValidationOptions<Parameters>): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
+  (parameters: Parameters, options?: LiveOntologyActionOptions): Promise<OntologyApplyActionResult | void>;
+  resolveParameters(parameters: Partial<Parameters>): Promise<Partial<Parameters>>;
+  validate(parameters: Parameters): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
+  validateDraft(parameters: Partial<Parameters>, options?: LiveOntologyActionDraftValidationOptions<Parameters>): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
 };
 export declare function createLiveOntologyAction(options: {
-    ir: OntologyIR;
-    action: OntologyIR["actionTypes"][number];
-    context?: Record<string, unknown>;
-    objects: Record<string, OntologyCollection<OntologyObject>>;
-    submit(request: OntologyActionRequest, options?: LiveOntologyActionOptions): Promise<OntologyApplyActionResult | void>;
-    validate(actionTypeName: string, parameters: Record<string, unknown>): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
-    validateDraft(actionTypeName: string, parameters: Record<string, unknown>, validationOptions?: LiveOntologyActionDraftValidationOptions<Record<string, unknown>>): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
+  ir: OntologyIR;
+  action: OntologyIR["actionTypes"][number];
+  context?: Record<string, unknown>;
+  objects: Record<string, OntologyCollection<OntologyObject>>;
+  submit(request: OntologyActionRequest, options?: LiveOntologyActionOptions): Promise<OntologyApplyActionResult | void>;
+  validate(actionTypeName: string, parameters: Record<string, unknown>): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
+  validateDraft(actionTypeName: string, parameters: Record<string, unknown>, validationOptions?: LiveOntologyActionDraftValidationOptions<Record<string, unknown>>): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;
 }): LiveOntologyAction;
+//#endregion
 //# sourceMappingURL=createLiveOntologyAction.d.ts.map

package/lib/live/actions/createLiveOntologyAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLiveOntologyAction.d.ts","sourceRoot":"","sources":["../../../src/live/actions/createLiveOntologyAction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createLiveOntologyAction.d.ts","names":[],"sources":["../../../src/live/actions/createLiveOntologyAction.ts"],"mappings":";;;;;;;;;;;iBAYiB;EACb;EACA,OAAO;EACP,aAAa;;iBAGA,yCAAyC,mBAAmB;EACzE,kCAAkC;;YAG1B,mBAAmB,mBAAmB,0BAA0B;GACvE,YAAY,YAAY,UAAU,4BAA4B,QAAQ;EACvE,kBAAkB,YAAY,QAAQ,cAAc,QAAQ,QAAQ;EACpE,SAAS,YAAY,aAAa,QAAQ,UAAU,sBAAsB;EAC1E,cACI,YAAY,QAAQ,aACpB,UAAU,yCAAyC,cACpD,QAAQ,UAAU,sBAAsB;;wBAG/B,yBAAyB;EACrC,IAAI;EACJ,QAAQ;EACR,UAAU;EACV,SAAS,eAAe,mBAAmB;EAC3C,OACI,SAAS,uBACT,UAAU,4BACX,QAAQ;EACX,SACI,wBACA,YAAY,0BACb,QAAQ,UAAU,sBAAsB;EAC3C,cACI,wBACA,YAAY,yBACZ,oBAAoB,yCAAyC,2BAC9D,QAAQ,UAAU,sBAAsB;IAC3C"}

package/lib/live/actions/createLiveOntologyAction.js

@@ -1,25 +1,28 @@
 import { resolveActionParameters } from "../expression.js";
 import { createReadTx } from "../mutators/createMutatorTx.js";
-export function createLiveOntologyAction(options) {
-    const resolveParameters = (providedParameters) => resolveActionParameters({
-        ir: options.ir,
-        actionTypeName: options.action.name,
-        initialParameters: providedParameters,
-        context: options.context ?? {},
-        tx: createReadTx(options.objects),
-    });
-    const apply = async (providedParameters, executionOptions) => {
-        const idempotencyKey = executionOptions?.idempotencyKey ??
-            crypto.randomUUID();
-        return options.submit({
-            actionTypeName: options.action.name,
-            parameters: providedParameters,
-            idempotencyKey,
-        }, executionOptions);
-    };
-    apply.validate = async (providedParameters) => options.validate(options.action.name, providedParameters);
-    apply.resolveParameters = resolveParameters;
-    apply.validateDraft = async (parameters, validationOptions) => options.validateDraft(options.action.name, parameters, validationOptions);
-    return apply;
+//#region src/live/actions/createLiveOntologyAction.ts
+function createLiveOntologyAction(options) {
+	const resolveParameters = (providedParameters) => resolveActionParameters({
+		ir: options.ir,
+		actionTypeName: options.action.name,
+		initialParameters: providedParameters,
+		context: options.context ?? {},
+		tx: createReadTx(options.objects)
+	});
+	const apply = async (providedParameters, executionOptions) => {
+		const idempotencyKey = executionOptions?.idempotencyKey ?? crypto.randomUUID();
+		return options.submit({
+			actionTypeName: options.action.name,
+			parameters: providedParameters,
+			idempotencyKey
+		}, executionOptions);
+	};
+	apply.validate = async (providedParameters) => options.validate(options.action.name, providedParameters);
+	apply.resolveParameters = resolveParameters;
+	apply.validateDraft = async (parameters, validationOptions) => options.validateDraft(options.action.name, parameters, validationOptions);
+	return apply;
 }
+//#endregion
+export { createLiveOntologyAction };
+
 //# sourceMappingURL=createLiveOntologyAction.js.map