@party-stack/ontology 0.19.1 → 0.21.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","names":["_$___index_js0.LiveOntology"],"sources":["../../src/runtime/live.ts"],"mappings":";;;;;;YAKY,qBAAqB;WAAgC,iBAAiB;;;qBAErE,sBAAmB,SAAA,uBAAA,OAAA;;;eAAAA;;;;;;;2CAI9B,gYAAA,iCAAA;;qBAGW,0BAAuB,SAAA,uBAAA,OAAA,OAAA,KAAAA,kDAAA,yEAAA,gYAAA,iCAAA"}

package/lib/runtime/live.js

@@ -0,0 +1,31 @@
+import { makeReplicaHost } from "./host.js";
+import { makeReplicaOntologyView } from "./view.js";
+import { Effect, Tracer } from "effect";
+import { makeTraceCapture } from "@party-stack/runtime/tracing";
+//#region src/runtime/live.ts
+/** Native host acquisition with an independently configured tracer. No UI collections. */
+const makeReplicaResource = Effect.fnUntraced(function* (options) {
+	const traces = yield* makeTraceCapture(options.traceRecording);
+	const open = makeReplicaHost(options).pipe(Effect.map((host) => ({
+		...host,
+		traces
+	})));
+	return yield* traces ? open.pipe(Effect.provideService(Tracer.Tracer, traces.tracer)) : open;
+});
+/** SDK view over a scoped native host. */
+const makeReplicaLiveOntology = Effect.fnUntraced(function* (options) {
+	const { replica, attachments, traces } = yield* makeReplicaResource(options);
+	const view = makeReplicaOntologyView({
+		ir: options.ir,
+		context: options.context,
+		replica,
+		writes: options.writes,
+		attachments,
+		traces
+	});
+	return yield* traces ? view.pipe(Effect.provideService(Tracer.Tracer, traces.tracer)) : view;
+});
+//#endregion
+export { makeReplicaLiveOntology, makeReplicaResource };
+
+//# sourceMappingURL=live.js.map

package/lib/runtime/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","names":[],"sources":["../../src/runtime/live.ts"],"sourcesContent":["import { makeTraceCapture, type TraceRecordingMode } from \"@party-stack/runtime/tracing\";\nimport { Effect, Tracer } from \"effect\";\nimport { makeReplicaHost, type ReplicaHostOptions } from \"./host.js\";\nimport { makeReplicaOntologyView } from \"./view.js\";\n\nexport type ReplicaLiveOptions = ReplicaHostOptions & { readonly traceRecording?: TraceRecordingMode };\n/** Native host acquisition with an independently configured tracer. No UI collections. */\nexport const makeReplicaResource = Effect.fnUntraced(function* (options: ReplicaLiveOptions) {\n    const traces = yield* makeTraceCapture(options.traceRecording);\n    const open = makeReplicaHost(options).pipe(Effect.map((host) => ({ ...host, traces })));\n    return yield* traces ? open.pipe(Effect.provideService(Tracer.Tracer, traces.tracer)) : open;\n});\n\n/** SDK view over a scoped native host. */\nexport const makeReplicaLiveOntology = Effect.fnUntraced(function* (options: ReplicaLiveOptions) {\n    const { replica, attachments, traces } = yield* makeReplicaResource(options);\n    const view = makeReplicaOntologyView({\n        ir: options.ir,\n        context: options.context,\n        replica,\n        writes: options.writes,\n        attachments,\n\n        traces,\n    });\n    return yield* traces ? view.pipe(Effect.provideService(Tracer.Tracer, traces.tracer)) : view;\n});\n"],"mappings":";;;;;;AAOA,MAAa,sBAAsB,OAAO,WAAW,WAAW,SAA6B;CACzF,MAAM,SAAS,OAAO,iBAAiB,QAAQ,cAAc;CAC7D,MAAM,OAAO,gBAAgB,OAAO,CAAC,CAAC,KAAK,OAAO,KAAK,UAAU;EAAE,GAAG;EAAM;CAAO,EAAE,CAAC;CACtF,OAAO,OAAO,SAAS,KAAK,KAAK,OAAO,eAAe,OAAO,QAAQ,OAAO,MAAM,CAAC,IAAI;AAC5F,CAAC;;AAGD,MAAa,0BAA0B,OAAO,WAAW,WAAW,SAA6B;CAC7F,MAAM,EAAE,SAAS,aAAa,WAAW,OAAO,oBAAoB,OAAO;CAC3E,MAAM,OAAO,wBAAwB;EACjC,IAAI,QAAQ;EACZ,SAAS,QAAQ;EACjB;EACA,QAAQ,QAAQ;EAChB;EAEA;CACJ,CAAC;CACD,OAAO,OAAO,SAAS,KAAK,KAAK,OAAO,eAAe,OAAO,QAAQ,OAAO,MAAM,CAAC,IAAI;AAC5F,CAAC"}

package/lib/runtime/resource.d.ts

@@ -0,0 +1,24 @@
+import { LiveOntology, LiveOntologyOptions, OntologyDefinition } from "../live/LiveOntology.js";
+import { BackendError } from "@party-stack/ontology-backend";
+import { Runtimes } from "@party-stack/runtime";
+import { Effect, Scope, Tracer } from "effect";
+//#region src/runtime/resource.d.ts
+/** Native acquisition. Runtime, backend, collections and replica fibers share the caller's Scope. */
+export declare const makeOntologyResource: <Ontology extends OntologyDefinition = OntologyDefinition, Context extends Record<string, unknown> = Record<string, unknown>>(opts: LiveOntologyOptions<Context>) => Effect.Effect<{
+  replica: import("@party-stack/ontology-replica").ReplicaService;
+  backend: import("@party-stack/ontology-backend").OntologyBackendService;
+  attachments: LiveOntology["attachments"];
+  traces: {
+    tracer: Tracer.Tracer;
+    getSnapshot: () => readonly import("@party-stack/runtime/tracing").TraceRecord[];
+    subscribe: (listener: (record?: import("@party-stack/runtime/tracing").TraceRecord) => void) => () => void;
+    clear: () => void;
+  } | undefined;
+  ir: import("@party-stack/ontology-spec").OntologyIR;
+  context: Context;
+  close: Effect.Effect<void, never, never>;
+  view: Effect.Effect<LiveOntology<Ontology>, BackendError<"Conflict" | "Forbidden" | "HistoryExpired" | "Internal" | "InvalidConfiguration" | "InvalidRequest" | "InvalidResponse" | "NotFound" | "NotImplemented" | "RateLimited" | "ResultExpired" | "SchemaMismatch" | "SessionExpired" | "SessionReplaced" | "SourceMismatch" | "Unauthenticated" | "Unavailable" | "ValidationFailed" | "ViewReplaced">, never>;
+}, BackendError<"Conflict" | "Forbidden" | "HistoryExpired" | "Internal" | "InvalidConfiguration" | "InvalidRequest" | "InvalidResponse" | "NotFound" | "NotImplemented" | "RateLimited" | "ResultExpired" | "SchemaMismatch" | "SessionExpired" | "SessionReplaced" | "SourceMismatch" | "Unauthenticated" | "Unavailable" | "ValidationFailed" | "ViewReplaced"> | import("@party-stack/runtime").RuntimeAcquisitionError, Runtimes | Scope.Scope>;
+export type OntologyResource = Effect.Success<ReturnType<typeof makeOntologyResource>>;
+//#endregion
+//# sourceMappingURL=resource.d.ts.map

package/lib/runtime/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","names":[],"sources":["../../src/runtime/resource.ts"],"mappings":";;;;;;qBAWa,uBACT,iBAAiB,qBAAkB,oBACnC,gBAAgB,0BAAuB,yBAAA,MAAA,oBAAA,aAAA,OAAA;;;;;;;;;;;;;;GAyJzC,iYAAA,yBAAA,WAAA,MAAA;YAEU,mBAAmB,OAAO,QAAQ,kBAAkB"}

package/lib/runtime/resource.js

@@ -0,0 +1,127 @@
+import { makeReplicaOntologyView } from "./view.js";
+import { makeReplicaResource } from "./live.js";
+import { BackendError } from "@party-stack/ontology-backend";
+import { Runtime, Runtimes } from "@party-stack/runtime";
+import { Effect, Exit, Scope, Stream, Tracer } from "effect";
+import { equalValues } from "@party-stack/ontology-spec/query";
+import { contextPartition } from "@party-stack/ontology-spec/utils";
+import { ontologyDefinitionSignature } from "@party-stack/ontology-storage";
+import { digestBytes } from "@party-stack/ontology-storage/blobs";
+//#region src/runtime/resource.ts
+/** Native acquisition. Runtime, backend, collections and replica fibers share the caller's Scope. */
+const makeOntologyResource = Effect.fn("Ontology.acquire")(function* (opts) {
+	const scope = yield* Scope.fork(yield* Effect.scope);
+	const opened = Effect.gen(function* () {
+		const platformScope = yield* Scope.fork(scope);
+		const transportScope = yield* Scope.fork(scope);
+		const remote = opts.client ? yield* Scope.provide(Effect.isEffect(opts.client) ? opts.client : Effect.succeed(opts.client), transportScope) : void 0;
+		const client = remote && "ontology" in remote ? yield* Scope.provide(remote.ontology(opts.ontology), transportScope) : remote;
+		const ir = opts.ir ?? client?.ir;
+		if (!ir) return yield* new BackendError({
+			operation: "ontology.create",
+			kind: "InvalidConfiguration",
+			retryable: false,
+			message: "Supply an ontology definition when the server does not describe one."
+		});
+		if (client && opts.ir && client.definitionHash) {
+			const signature = yield* Effect.try({
+				try: () => ontologyDefinitionSignature(ir),
+				catch: (cause) => new BackendError({
+					operation: "ontology.create",
+					kind: "InvalidConfiguration",
+					retryable: false,
+					message: "Invalid client ontology definition.",
+					cause
+				})
+			});
+			if ((yield* digestBytes({
+				type: "application/json",
+				stream: Stream.make(new TextEncoder().encode(signature))
+			}).pipe(Effect.mapError((cause) => new BackendError({
+				operation: "ontology.create",
+				kind: "Internal",
+				retryable: false,
+				message: "Could not identify the client definition.",
+				cause
+			})))) !== client.definitionHash) return yield* new BackendError({
+				operation: "ontology.create",
+				kind: "SchemaMismatch",
+				retryable: false,
+				message: "Server definition differs from this client."
+			});
+		}
+		if (client?.context && opts.context && !equalValues(client.context, opts.context)) return yield* new BackendError({
+			operation: "ontology.create",
+			kind: "InvalidConfiguration",
+			retryable: false,
+			message: "Client context differs from the authenticated server context."
+		});
+		const ontologyId = opts.id ?? (client ? JSON.stringify(["source", client.sourceId]) : "default");
+		const context = client?.context ?? opts.context ?? {};
+		const owner = yield* Effect.try({
+			try: () => contextPartition(ir, context),
+			catch: (cause) => new BackendError({
+				operation: "runtime.partition",
+				kind: "InvalidConfiguration",
+				message: "Invalid context partition.",
+				retryable: false,
+				cause
+			})
+		});
+		const runtime = yield* Scope.provide(Effect.flatMap(Runtimes, (runtimes) => runtimes.acquire({
+			owner,
+			namespace: ontologyId
+		})), platformScope);
+		const resources = yield* Scope.fork(yield* Effect.scope);
+		return yield* Scope.provide(Effect.gen(function* () {
+			const source = client?.replication.kind === "speculative" ? client.replication.source : void 0;
+			const backend = client?.backend ?? (yield* (Effect.isEffect(opts.backend) ? opts.backend : Effect.succeed(opts.backend)).pipe(Effect.provideService(Runtime, runtime)));
+			const host = yield* makeReplicaResource({
+				backend,
+				source,
+				ir,
+				traceRecording: opts.traceRecording,
+				context,
+				writes: opts.writes,
+				live: opts.live,
+				demand: opts.demand,
+				cache: opts.cache,
+				authentication: opts.authentication
+			}).pipe(Effect.provideService(Runtime, runtime));
+			const close = Scope.close(scope, Exit.void);
+			const view = yield* Effect.cached(Scope.provide(makeReplicaOntologyView({
+				ir,
+				context,
+				replica: host.replica,
+				writes: opts.writes,
+				attachments: host.attachments,
+				pins: client?.pins,
+				pinBackend: client?.pinBackend,
+				diagnosticLabel: opts.label,
+				parentDiagnostics: client && (source || opts.parent) ? {
+					label: opts.parent?.label ?? "Parent",
+					role: "host",
+					location: opts.parent?.location,
+					replica: client.operations.replicaMonitor,
+					traces: client.operations.traces
+				} : void 0,
+				traces: host.traces
+			}).pipe(Effect.provideService(Runtime, runtime), (work) => host.traces ? work.pipe(Effect.provideService(Tracer.Tracer, host.traces.tracer)) : work), resources).pipe(Effect.map((view) => ({
+				...view,
+				cleanup: () => Effect.runPromise(close)
+			}))));
+			return {
+				...host,
+				ir,
+				context,
+				close,
+				view
+			};
+		}), resources);
+	});
+	return yield* Scope.provide(opened, scope).pipe(Effect.onExit((exit) => Exit.isFailure(exit) ? Scope.close(scope, exit) : Effect.void));
+});
+//#endregion
+export { makeOntologyResource };
+
+//# sourceMappingURL=resource.js.map

package/lib/runtime/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","names":[],"sources":["../../src/runtime/resource.ts"],"sourcesContent":["import { BackendError } from \"@party-stack/ontology-backend\";\nimport { equalValues } from \"@party-stack/ontology-spec/query\";\nimport { contextPartition } from \"@party-stack/ontology-spec/utils\";\nimport { ontologyDefinitionSignature } from \"@party-stack/ontology-storage\";\nimport { digestBytes } from \"@party-stack/ontology-storage/blobs\";\nimport { Runtime, Runtimes } from \"@party-stack/runtime\";\nimport { Effect, Exit, Scope, Tracer, Stream } from \"effect\";\nimport { makeReplicaResource } from \"./live.js\";\nimport { makeReplicaOntologyView } from \"./view.js\";\nimport type { LiveOntologyOptions, LiveOntology, OntologyDefinition } from \"../live/LiveOntology.js\";\n/** Native acquisition. Runtime, backend, collections and replica fibers share the caller's Scope. */\nexport const makeOntologyResource = Effect.fn(\"Ontology.acquire\")(function* <\n    Ontology extends OntologyDefinition = OntologyDefinition,\n    Context extends Record<string, unknown> = Record<string, unknown>,\n>(opts: LiveOntologyOptions<Context>) {\n    const scope = yield* Scope.fork(yield* Effect.scope);\n    const opened = Effect.gen(function* () {\n        // Close views/replication first, then transport, then local platform storage.\n        const platformScope = yield* Scope.fork(scope);\n        const transportScope = yield* Scope.fork(scope);\n        const remote = opts.client\n            ? yield* Scope.provide(\n                  Effect.isEffect(opts.client) ? opts.client : Effect.succeed(opts.client),\n                  transportScope\n              )\n            : undefined;\n        const client =\n            remote && \"ontology\" in remote\n                ? yield* Scope.provide(remote.ontology(opts.ontology), transportScope)\n                : remote;\n        const ir = opts.ir ?? client?.ir;\n        if (!ir)\n            return yield* new BackendError({\n                operation: \"ontology.create\",\n                kind: \"InvalidConfiguration\",\n                retryable: false,\n                message: \"Supply an ontology definition when the server does not describe one.\",\n            });\n        if (client && opts.ir && client.definitionHash) {\n            const signature = yield* Effect.try({\n                try: () => ontologyDefinitionSignature(ir),\n                catch: (cause) =>\n                    new BackendError({\n                        operation: \"ontology.create\",\n                        kind: \"InvalidConfiguration\",\n                        retryable: false,\n                        message: \"Invalid client ontology definition.\",\n                        cause,\n                    }),\n            });\n            const hash = yield* digestBytes({\n                type: \"application/json\",\n                stream: Stream.make(new TextEncoder().encode(signature)),\n            }).pipe(\n                Effect.mapError(\n                    (cause) =>\n                        new BackendError({\n                            operation: \"ontology.create\",\n                            kind: \"Internal\",\n                            retryable: false,\n                            message: \"Could not identify the client definition.\",\n                            cause,\n                        })\n                )\n            );\n            if (hash !== client.definitionHash)\n                return yield* new BackendError({\n                    operation: \"ontology.create\",\n                    kind: \"SchemaMismatch\",\n                    retryable: false,\n                    message: \"Server definition differs from this client.\",\n                });\n        }\n        if (client?.context && opts.context && !equalValues(client.context, opts.context))\n            return yield* new BackendError({\n                operation: \"ontology.create\",\n                kind: \"InvalidConfiguration\",\n                retryable: false,\n                message: \"Client context differs from the authenticated server context.\",\n            });\n        const ontologyId = opts.id ?? (client ? JSON.stringify([\"source\", client.sourceId]) : \"default\");\n        const context = (client?.context ?? opts.context ?? {}) as Context;\n        const owner = yield* Effect.try({\n            try: () => contextPartition(ir, context),\n            catch: (cause) =>\n                new BackendError({\n                    operation: \"runtime.partition\",\n                    kind: \"InvalidConfiguration\",\n                    message: \"Invalid context partition.\",\n                    retryable: false,\n                    cause,\n                }),\n        });\n        const runtime = yield* Scope.provide(\n            Effect.flatMap(Runtimes, (runtimes) => runtimes.acquire({ owner, namespace: ontologyId })),\n            platformScope\n        );\n        const resources = yield* Scope.fork(yield* Effect.scope);\n        return yield* Scope.provide(\n            Effect.gen(function* () {\n                const source =\n                    client?.replication.kind === \"speculative\" ? client.replication.source : undefined;\n                const backend =\n                    client?.backend ??\n                    (yield* (\n                        Effect.isEffect(opts.backend) ? opts.backend : Effect.succeed(opts.backend!)\n                    ).pipe(Effect.provideService(Runtime, runtime)));\n                const host = yield* makeReplicaResource({\n                    backend,\n                    source,\n                    ir,\n                    traceRecording: opts.traceRecording,\n                    context,\n                    writes: opts.writes,\n                    live: opts.live,\n                    demand: opts.demand,\n                    cache: opts.cache,\n                    authentication: opts.authentication,\n                }).pipe(Effect.provideService(Runtime, runtime));\n                const close = Scope.close(scope, Exit.void);\n                const view = yield* Effect.cached(\n                    Scope.provide(\n                        makeReplicaOntologyView({\n                            ir,\n                            context,\n                            replica: host.replica,\n                            writes: opts.writes,\n                            attachments: host.attachments,\n                            pins: client?.pins,\n                            pinBackend: client?.pinBackend,\n                            diagnosticLabel: opts.label,\n                            parentDiagnostics:\n                                client && (source || opts.parent)\n                                    ? {\n                                          label: opts.parent?.label ?? \"Parent\",\n                                          role: \"host\",\n                                          location: opts.parent?.location,\n                                          replica: client.operations.replicaMonitor,\n                                          traces: client.operations.traces,\n                                      }\n                                    : undefined,\n                            traces: host.traces,\n                        }).pipe(Effect.provideService(Runtime, runtime), (work) =>\n                            host.traces\n                                ? work.pipe(Effect.provideService(Tracer.Tracer, host.traces.tracer))\n                                : work\n                        ),\n                        resources\n                    ).pipe(\n                        Effect.map(\n                            (view) =>\n                                ({\n                                    ...view,\n                                    cleanup: () => Effect.runPromise(close),\n                                }) as LiveOntology<Ontology>\n                        )\n                    )\n                );\n                return { ...host, ir, context, close, view };\n            }),\n            resources\n        );\n    });\n    return yield* Scope.provide(opened, scope).pipe(\n        Effect.onExit((exit) => (Exit.isFailure(exit) ? Scope.close(scope, exit) : Effect.void))\n    );\n});\n\nexport type OntologyResource = Effect.Success<ReturnType<typeof makeOntologyResource>>;\n"],"mappings":"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"}

package/lib/runtime/transactions.d.ts

@@ -0,0 +1,27 @@
+import { OntologyMutatorRegistry, PrepareTransactionSources } from "../live/mutators/types.js";
+import { ActionRequest, BackendError } from "@party-stack/ontology-backend";
+import { Effect } from "effect";
+import { Collection, DbClient } from "@tanstack/db";
+import { OntologyIR, OntologyObject } from "@party-stack/ontology-spec";
+import { ActionMutatorRegistry } from "@party-stack/ontology-backend/actions";
+import { OwnedReadTransaction, OwnedTransaction } from "@party-stack/ontology-backend/owned";
+//#region src/runtime/transactions.d.ts
+type ExpressionReplay = NonNullable<ActionRequest["replay"]>;
+/** Ephemeral query collections; their only source is the supplied persisted transaction. */
+export declare const withTransactionCollections: <A, E, R>(ir: OntologyIR, tx: OwnedReadTransaction, body: (objects: Record<string, Collection<OntologyObject>>, ensureLoaded: PrepareTransactionSources, client: DbClient) => Effect.Effect<A, E, R>) => Effect.Effect<A, E | BackendError, R>;
+/** Promise/TanStack authoring bridge only. Portable action logic and replay live below ontology. */
+export declare const actionMutators: (ir: OntologyIR, registry?: OntologyMutatorRegistry) => ActionMutatorRegistry;
+export declare const executeTransactionMutator: (options: {
+  readonly ir: OntologyIR;
+  readonly tx: OwnedTransaction;
+  readonly name: string;
+  readonly parameters: Record<string, unknown>;
+  readonly operationId: string;
+  readonly replay?: ExpressionReplay;
+  readonly resolveOnly?: boolean;
+  readonly context?: Record<string, unknown>;
+  readonly mutators?: OntologyMutatorRegistry;
+}) => Effect.Effect<unknown, BackendError<any> | BackendError<"Conflict" | "Forbidden" | "HistoryExpired" | "Internal" | "InvalidConfiguration" | "InvalidRequest" | "InvalidResponse" | "NotFound" | "NotImplemented" | "RateLimited" | "ResultExpired" | "SchemaMismatch" | "SessionExpired" | "SessionReplaced" | "SourceMismatch" | "Unauthenticated" | "Unavailable" | "ValidationFailed" | "ViewReplaced">, never>;
+//#endregion
+export {};
+//# sourceMappingURL=transactions.d.ts.map

package/lib/runtime/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","names":[],"sources":["../../src/runtime/transactions.ts"],"mappings":";;;;;;;;KAQK,mBAAmB,YAAY;;qBAoBvB,6BAA8B,GAAG,GAAG,GAAC,IAC1C,YAAU,IACV,sBAAoB,OAEpB,SAAS,eAAe,WAAW,kBACnC,cAAc,2BACd,QAAQ,aACP,OAAO,OAAO,GAAG,GAAG,OAC1B,OAAO,OAAO,GAAG,IAAI,cAAc;;qBAqHzB,iBAAc,IACnB,YAAU,WACJ,4BACX;qBA+IU,4BAAyB;WACrB,IAAA;WACA,IAAA;WACE;WACM,YAAA;WACC;WACJ,SAAA;WACK;WACJ,UAAA;WACC,WAAA;MAetB,OAAA,gBAAA,oBAAA"}

package/lib/runtime/transactions.js

@@ -0,0 +1,188 @@
+import { createReadTx } from "../live/mutators/createReadTx.js";
+import { storageSubset } from "../tanstack/subset.js";
+import "../tanstack/index.js";
+import { BackendError } from "@party-stack/ontology-backend";
+import { Effect, Fiber, Semaphore } from "effect";
+import { BasicIndex, DbClient, collectionOptions, whenSyncAccepted } from "@tanstack/db";
+import { executeAction } from "@party-stack/ontology-backend/actions";
+import { Table } from "@party-stack/ontology-storage/tables";
+//#region src/runtime/transactions.ts
+const failure = (cause) => cause instanceof BackendError ? cause : new BackendError({
+	operation: "mutator",
+	kind: "Internal",
+	message: cause instanceof Error ? cause.message : "Transaction execution failed.",
+	retryable: false,
+	cause
+});
+/** Ephemeral query collections; their only source is the supplied persisted transaction. */
+const withTransactionCollections = (ir, tx, body) => Effect.scoped(Effect.gen(function* () {
+	const context = yield* Effect.context();
+	const scope = yield* Effect.scope;
+	let closed = false;
+	yield* Effect.addFinalizer(() => Effect.sync(() => {
+		closed = true;
+	}));
+	const run = (effect) => closed ? Promise.reject(failure("Transaction query scope is closed.")) : Effect.runPromiseWith(context)(Effect.flatMap(Effect.forkIn(effect, scope), Fiber.join));
+	const client = yield* Effect.acquireRelease(Effect.sync(() => new DbClient()), (client) => Effect.promise(() => client.cleanup()));
+	const publishers = /* @__PURE__ */ new Map();
+	const loaded = /* @__PURE__ */ new Map();
+	const objects = Object.fromEntries(ir.objectTypes.map((definition) => [definition.name, client.collection(collectionOptions({
+		id: `transaction:${crypto.randomUUID()}:${definition.name}`,
+		getKey: (value) => value[definition.primaryKey],
+		syncMode: "on-demand",
+		defaultIndexType: BasicIndex,
+		autoIndex: "eager",
+		startSync: true,
+		sync: {
+			rowUpdateMode: "full",
+			sync: ({ begin, write, commit, markReady, fail, collection }) => {
+				const published = new Set(collection.keys());
+				const requests = /* @__PURE__ */ new Map();
+				publishers.set(definition.name, async (rows) => {
+					if (closed) throw failure("Transaction query scope is closed.");
+					begin();
+					for (const row of rows) {
+						write({
+							type: published.has(row.key) ? "update" : "insert",
+							value: row.value
+						});
+						published.add(row.key);
+					}
+					const receipt = commit();
+					if (receipt !== true) receipt.catch(fail);
+					await whenSyncAccepted(receipt);
+				});
+				markReady();
+				return {
+					loadSubset: (subset) => {
+						const query = storageSubset(subset, ir, definition.name);
+						const key = Table.make({ name: "transaction-demand" }).encode(query);
+						let pending = requests.get(key);
+						if (!pending) {
+							pending = run(Effect.flatMap(tx.loadSubset(definition.name, query), (rows) => Effect.promise(() => publishers.get(definition.name)(rows))));
+							requests.set(key, pending);
+							pending.catch(() => requests.delete(key));
+						}
+						return pending;
+					},
+					cleanup: () => {
+						publishers.delete(definition.name);
+					}
+				};
+			}
+		}
+	}))]));
+	const ensureLoaded = async (types, request) => {
+		if (request?.plan !== void 0) return;
+		for (const type of types) {
+			const key = JSON.stringify([type, request?.key]);
+			let pending = loaded.get(key);
+			if (!pending) {
+				const publish = publishers.get(type);
+				if (!publish) throw failure("Unknown transaction query source.");
+				const read = request?.key === void 0 ? tx.loadSubset(type) : Effect.map(tx.get(type, request.key), (value) => value === void 0 ? [] : [{
+					key: request.key,
+					value
+				}]);
+				pending = run(Effect.flatMap(read, (rows) => Effect.promise(() => publish(rows))));
+				loaded.set(key, pending);
+			}
+			await pending;
+		}
+	};
+	return yield* body(objects, ensureLoaded, client);
+}));
+/** Promise/TanStack authoring bridge only. Portable action logic and replay live below ontology. */
+const actionMutators = (ir, registry = {}) => Object.fromEntries(Object.entries(registry).map(([name, handler]) => [name, (tx, request, context) => Effect.scoped(Effect.gen(function* () {
+	const services = yield* Effect.context();
+	const scope = yield* Effect.scope;
+	let closed = false;
+	const reads = /* @__PURE__ */ new Map();
+	const codec = Table.make({ name: "mutator-reads" });
+	const cached = (key, work) => Effect.suspend(() => {
+		const encoded = codec.encode(key);
+		return reads.has(encoded) ? Effect.succeed(reads.get(encoded)) : work.pipe(Effect.tap((value) => Effect.sync(() => reads.set(encoded, value))));
+	});
+	const invalidate = Effect.sync(() => reads.clear());
+	const mutations = yield* Semaphore.make(1);
+	const local = {
+		get: (type, key) => cached([
+			"get",
+			type,
+			key
+		], tx.get(type, key)),
+		loadSubset: (type, scan) => cached([
+			"query",
+			type,
+			scan
+		], tx.loadSubset(type, scan))
+	};
+	yield* Effect.addFinalizer(() => Effect.sync(() => {
+		closed = true;
+		reads.clear();
+	}));
+	const run = (work) => Effect.runPromiseWith(services)(Effect.suspend(() => closed ? Effect.fail(failure("Mutator scope is closed.")) : Effect.flatMap(Effect.forkIn(work, scope), Fiber.join)));
+	const read = { query: (build) => run(withTransactionCollections(ir, local, (objects, prepare) => Effect.tryPromise({
+		try: () => createReadTx(objects, prepare).query(build),
+		catch: failure
+	}))) };
+	const runMutation = (work) => run(mutations.withPermits(1)(work));
+	const mutate = new Proxy({}, { get: (_target, type) => {
+		const definition = ir.objectTypes.find((t) => t.name === type);
+		if (!definition) throw failure(`Unknown object type "${type}".`);
+		const requireObject = (key) => tx.get(type, key).pipe(Effect.flatMap((value) => value ? Effect.void : Effect.fail(new BackendError({
+			operation: "mutator",
+			kind: "NotFound",
+			retryable: false,
+			message: "Object is unavailable."
+		}))));
+		return {
+			create: (value) => runMutation(Effect.gen(function* () {
+				const key = value[definition.primaryKey];
+				if (typeof key !== "string" && typeof key !== "number") return yield* failure("Created object requires its primary key.");
+				if (yield* tx.get(type, key)) return yield* new BackendError({
+					operation: "mutator.create",
+					kind: "Conflict",
+					retryable: false,
+					message: "Object already exists."
+				});
+				yield* tx.put(type, value);
+			}).pipe(Effect.ensuring(invalidate))),
+			update: (key, changes) => runMutation(requireObject(key).pipe(Effect.andThen(tx.patch(type, key, Array.isArray(changes) ? changes : Object.entries(changes).map(([property, value]) => ({
+				path: [property],
+				value
+			})))), Effect.ensuring(invalidate))),
+			delete: (key) => runMutation(requireObject(key).pipe(Effect.andThen(tx.delete(type, key)), Effect.ensuring(invalidate)))
+		};
+	} });
+	return yield* Effect.tryPromise({
+		try: () => Promise.resolve(handler({
+			tx: {
+				...read,
+				mutate
+			},
+			args: request.parameters,
+			context
+		})),
+		catch: failure
+	});
+}))]));
+const executeTransactionMutator = Effect.fn("Ontology.executeMutator")(function* (options) {
+	return yield* executeAction({
+		ir: options.ir,
+		tx: options.tx,
+		request: {
+			id: options.operationId,
+			name: options.name,
+			parameters: options.parameters,
+			replay: options.replay
+		},
+		context: options.context,
+		resolveOnly: options.resolveOnly,
+		mutators: actionMutators(options.ir, options.mutators)
+	}).pipe(Effect.map((execution) => execution.result));
+});
+//#endregion
+export { actionMutators, executeTransactionMutator, withTransactionCollections };
+
+//# sourceMappingURL=transactions.js.map

package/lib/runtime/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","names":[],"sources":["../../src/runtime/transactions.ts"],"sourcesContent":["import { BackendError } from \"@party-stack/ontology-backend\";\nimport { executeAction } from \"@party-stack/ontology-backend/actions\";\nimport { Table } from \"@party-stack/ontology-storage/tables\";\nimport { BasicIndex, whenSyncAccepted, DbClient, collectionOptions } from \"@tanstack/db\";\nimport { Effect, Fiber, Semaphore } from \"effect\";\nimport { createReadTx } from \"../live/mutators/createReadTx.js\";\nimport { storageSubset } from \"../tanstack/index.js\";\nimport type { ActionRequest } from \"@party-stack/ontology-backend\";\ntype ExpressionReplay = NonNullable<ActionRequest[\"replay\"]>;\nimport type { OntologyMutatorTx } from \"../live/mutators/types.js\";\nimport type { OntologyMutatorRegistry, PrepareTransactionSources } from \"../live/mutators/types.js\";\nimport type { ActionMutatorRegistry } from \"@party-stack/ontology-backend/actions\";\nimport type { OwnedReadTransaction, OwnedTransaction } from \"@party-stack/ontology-backend/owned\";\nimport type { OntologyIR, OntologyObject } from \"@party-stack/ontology-spec\";\nimport type { Collection } from \"@tanstack/db\";\n\nconst failure = (cause: unknown) =>\n    cause instanceof BackendError\n        ? cause\n        : new BackendError({\n              operation: \"mutator\",\n              kind: \"Internal\",\n              message: cause instanceof Error ? cause.message : \"Transaction execution failed.\",\n              retryable: false,\n              cause,\n          });\n\n/** Ephemeral query collections; their only source is the supplied persisted transaction. */\nexport const withTransactionCollections = <A, E, R>(\n    ir: OntologyIR,\n    tx: OwnedReadTransaction,\n    body: (\n        objects: Record<string, Collection<OntologyObject>>,\n        ensureLoaded: PrepareTransactionSources,\n        client: DbClient\n    ) => Effect.Effect<A, E, R>\n): Effect.Effect<A, E | BackendError, R> =>\n    Effect.scoped(\n        Effect.gen(function* () {\n            const context = yield* Effect.context<never>();\n            const scope = yield* Effect.scope;\n            let closed = false;\n            yield* Effect.addFinalizer(() =>\n                Effect.sync(() => {\n                    closed = true;\n                })\n            );\n            const run = <B, F>(effect: Effect.Effect<B, F>) =>\n                closed\n                    ? Promise.reject(failure(\"Transaction query scope is closed.\"))\n                    : Effect.runPromiseWith(context)(\n                          Effect.flatMap(Effect.forkIn(effect, scope), Fiber.join)\n                      );\n            const client = yield* Effect.acquireRelease(\n                Effect.sync(() => new DbClient()),\n                (client) => Effect.promise(() => client.cleanup())\n            );\n            const publishers = new Map<\n                string,\n                (rows: readonly { key: string | number; value: OntologyObject }[]) => Promise<void>\n            >();\n            const loaded = new Map<string, Promise<void>>();\n            const objects = Object.fromEntries(\n                ir.objectTypes.map((definition) => [\n                    definition.name,\n                    client.collection(\n                        collectionOptions({\n                            id: `transaction:${crypto.randomUUID()}:${definition.name}`,\n                            getKey: (value: OntologyObject) =>\n                                value[definition.primaryKey] as string | number,\n                            syncMode: \"on-demand\",\n                            defaultIndexType: BasicIndex,\n                            autoIndex: \"eager\",\n                            startSync: true,\n                            sync: {\n                                rowUpdateMode: \"full\",\n                                sync: ({ begin, write, commit, markReady, fail, collection }) => {\n                                    const published = new Set(collection.keys());\n                                    const requests = new Map<string, Promise<void>>();\n                                    publishers.set(definition.name, async (rows) => {\n                                        if (closed) throw failure(\"Transaction query scope is closed.\");\n                                        begin();\n                                        for (const row of rows) {\n                                            write({\n                                                type: published.has(row.key) ? \"update\" : \"insert\",\n                                                value: row.value,\n                                            });\n                                            published.add(row.key);\n                                        }\n                                        const receipt = commit();\n                                        if (receipt !== true) void receipt.catch(fail);\n                                        await whenSyncAccepted(receipt);\n                                    });\n                                    markReady();\n                                    return {\n                                        loadSubset: (subset) => {\n                                            const query = storageSubset(subset, ir, definition.name);\n                                            const key = Table.make({ name: \"transaction-demand\" }).encode(\n                                                query\n                                            );\n                                            let pending = requests.get(key);\n                                            if (!pending) {\n                                                pending = run(\n                                                    Effect.flatMap(\n                                                        tx.loadSubset(definition.name, query),\n                                                        (rows) =>\n                                                            Effect.promise(() =>\n                                                                publishers.get(definition.name)!(rows)\n                                                            )\n                                                    )\n                                                );\n                                                requests.set(key, pending);\n                                                void pending.catch(() => requests.delete(key));\n                                            }\n                                            return pending;\n                                        },\n                                        cleanup: () => {\n                                            publishers.delete(definition.name);\n                                        },\n                                    };\n                                },\n                            },\n                        })\n                    ),\n                ])\n            );\n            const ensureLoaded: PrepareTransactionSources = async (types, request) => {\n                // TanStack drives query sources, join key batches and includes\n                // through loadSubset. Only imperative edits need preparation.\n                if (request?.plan !== undefined) return;\n                for (const type of types) {\n                    const key = JSON.stringify([type, request?.key]);\n                    let pending = loaded.get(key);\n                    if (!pending) {\n                        const publish = publishers.get(type);\n                        if (!publish) throw failure(\"Unknown transaction query source.\");\n                        const read =\n                            request?.key === undefined\n                                ? tx.loadSubset(type)\n                                : Effect.map(tx.get(type, request.key), (value) =>\n                                      value === undefined ? [] : [{ key: request.key!, value }]\n                                  );\n                        pending = run(Effect.flatMap(read, (rows) => Effect.promise(() => publish(rows))));\n                        loaded.set(key, pending);\n                    }\n                    await pending;\n                }\n            };\n            return yield* body(objects, ensureLoaded, client);\n        })\n    );\n\n/** Promise/TanStack authoring bridge only. Portable action logic and replay live below ontology. */\nexport const actionMutators = (\n    ir: OntologyIR,\n    registry: OntologyMutatorRegistry = {}\n): ActionMutatorRegistry =>\n    Object.fromEntries(\n        Object.entries(registry).map(([name, handler]) => [\n            name,\n            (tx, request, context) =>\n                Effect.scoped(\n                    Effect.gen(function* () {\n                        const services = yield* Effect.context<never>();\n                        const scope = yield* Effect.scope;\n                        let closed = false;\n                        const reads = new Map<string, unknown>();\n                        const codec = Table.make({ name: \"mutator-reads\" });\n                        const cached = <A>(key: unknown, work: Effect.Effect<A, BackendError>) =>\n                            Effect.suspend(() => {\n                                const encoded = codec.encode(key);\n                                return reads.has(encoded)\n                                    ? Effect.succeed(reads.get(encoded) as A)\n                                    : work.pipe(\n                                          Effect.tap((value) => Effect.sync(() => reads.set(encoded, value)))\n                                      );\n                            });\n                        const invalidate = Effect.sync(() => reads.clear());\n                        const mutations = yield* Semaphore.make(1);\n                        const local: OwnedReadTransaction = {\n                            get: (type, key) => cached([\"get\", type, key], tx.get(type, key)),\n                            loadSubset: (type, scan) =>\n                                cached([\"query\", type, scan], tx.loadSubset(type, scan)),\n                        };\n                        yield* Effect.addFinalizer(() =>\n                            Effect.sync(() => {\n                                closed = true;\n                                reads.clear();\n                            })\n                        );\n                        const run = <A>(work: Effect.Effect<A, BackendError>) =>\n                            Effect.runPromiseWith(services)(\n                                Effect.suspend(() =>\n                                    closed\n                                        ? Effect.fail(failure(\"Mutator scope is closed.\"))\n                                        : Effect.flatMap(Effect.forkIn(work, scope), Fiber.join)\n                                )\n                            );\n                        const read: ReturnType<typeof createReadTx> = {\n                            query: <A>(build: Parameters<ReturnType<typeof createReadTx>[\"query\"]>[0]) =>\n                                run(\n                                    withTransactionCollections(ir, local, (objects, prepare) =>\n                                        Effect.tryPromise({\n                                            try: () => createReadTx(objects, prepare).query<A>(build),\n                                            catch: failure,\n                                        })\n                                    )\n                                ),\n                        };\n                        const runMutation = <A>(work: Effect.Effect<A, BackendError>) =>\n                            run(mutations.withPermits(1)(work));\n                        const mutate = new Proxy(\n                            {},\n                            {\n                                get: (_target, type: string) => {\n                                    const definition = ir.objectTypes.find((t) => t.name === type);\n                                    if (!definition) throw failure(`Unknown object type \"${type}\".`);\n                                    const requireObject = (key: string | number) =>\n                                        tx.get(type, key).pipe(\n                                            Effect.flatMap((value) =>\n                                                value\n                                                    ? Effect.void\n                                                    : Effect.fail(\n                                                          new BackendError({\n                                                              operation: \"mutator\",\n                                                              kind: \"NotFound\",\n                                                              retryable: false,\n                                                              message: \"Object is unavailable.\",\n                                                          })\n                                                      )\n                                            )\n                                        );\n                                    return {\n                                        create: (value: Record<string, unknown>) =>\n                                            runMutation(\n                                                Effect.gen(function* () {\n                                                    const key = value[definition.primaryKey];\n                                                    if (typeof key !== \"string\" && typeof key !== \"number\")\n                                                        return yield* failure(\n                                                            \"Created object requires its primary key.\"\n                                                        );\n                                                    if (yield* tx.get(type, key))\n                                                        return yield* new BackendError({\n                                                            operation: \"mutator.create\",\n                                                            kind: \"Conflict\",\n                                                            retryable: false,\n                                                            message: \"Object already exists.\",\n                                                        });\n                                                    yield* tx.put(type, value);\n                                                }).pipe(Effect.ensuring(invalidate))\n                                            ),\n                                        update: (\n                                            key: string | number,\n                                            changes:\n                                                | Record<string, unknown>\n                                                | { path: string[]; value: unknown }[]\n                                        ) =>\n                                            runMutation(\n                                                requireObject(key).pipe(\n                                                    Effect.andThen(\n                                                        tx.patch(\n                                                            type,\n                                                            key,\n                                                            Array.isArray(changes)\n                                                                ? changes\n                                                                : Object.entries(changes).map(\n                                                                      ([property, value]) => ({\n                                                                          path: [property],\n                                                                          value,\n                                                                      })\n                                                                  )\n                                                        )\n                                                    ),\n                                                    Effect.ensuring(invalidate)\n                                                )\n                                            ),\n                                        delete: (key: string | number) =>\n                                            runMutation(\n                                                requireObject(key).pipe(\n                                                    Effect.andThen(tx.delete(type, key)),\n                                                    Effect.ensuring(invalidate)\n                                                )\n                                            ),\n                                    };\n                                },\n                            }\n                        ) as OntologyMutatorTx[\"mutate\"];\n                        return yield* Effect.tryPromise({\n                            try: () =>\n                                Promise.resolve(\n                                    handler({ tx: { ...read, mutate }, args: request.parameters, context })\n                                ),\n                            catch: failure,\n                        });\n                    })\n                ),\n        ])\n    );\n\nexport const executeTransactionMutator = Effect.fn(\"Ontology.executeMutator\")(function* (options: {\n    readonly ir: OntologyIR;\n    readonly tx: OwnedTransaction;\n    readonly name: string;\n    readonly parameters: Record<string, unknown>;\n    readonly operationId: string;\n    readonly replay?: ExpressionReplay;\n    readonly resolveOnly?: boolean;\n    readonly context?: Record<string, unknown>;\n    readonly mutators?: OntologyMutatorRegistry;\n}) {\n    return yield* executeAction({\n        ir: options.ir,\n        tx: options.tx,\n        request: {\n            id: options.operationId,\n            name: options.name,\n            parameters: options.parameters,\n            replay: options.replay,\n        },\n        context: options.context,\n        resolveOnly: options.resolveOnly,\n        mutators: actionMutators(options.ir, options.mutators),\n    }).pipe(Effect.map((execution) => execution.result));\n});\n"],"mappings":"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"}

package/lib/runtime/view.d.ts

@@ -0,0 +1,25 @@
+import { LiveOntologyAttachments } from "../live/attachments/createLiveOntologyAttachments.js";
+import { LiveOntology, LiveOntologyWrites } from "../live/LiveOntology.js";
+import { BackendError } from "@party-stack/ontology-backend";
+import { Runtime } from "@party-stack/runtime";
+import { Effect, Scope } from "effect";
+import { OntologyIR } from "@party-stack/ontology-spec";
+import { TraceStore } from "@party-stack/runtime/tracing";
+import { ReplicaPinControls, ReplicaService } from "@party-stack/ontology-replica";
+//#region src/runtime/view.d.ts
+export interface ReplicaViewOptions {
+  readonly ir: OntologyIR;
+  readonly context: Record<string, unknown>;
+  readonly writes?: LiveOntologyWrites;
+  readonly replica: ReplicaService;
+  readonly attachments: LiveOntologyAttachments;
+  readonly pins?: ReplicaPinControls;
+  readonly pinBackend?: Effect.Effect<import("@party-stack/ontology-backend").OntologyBackendService, BackendError, Scope.Scope>;
+  readonly traces?: TraceStore;
+  readonly parentDiagnostics?: LiveOntology["diagnostics"];
+  readonly diagnosticLabel?: string;
+}
+/** Materialize a scoped UI view over an existing replica; engine ownership is independent. */
+export declare const makeReplicaOntologyView: (options: ReplicaViewOptions) => Effect.Effect<Omit<LiveOntology<import("@party-stack/ontology-spec").OntologyDefinition>, "cleanup">, BackendError<"Conflict" | "Forbidden" | "HistoryExpired" | "Internal" | "InvalidConfiguration" | "InvalidRequest" | "InvalidResponse" | "NotFound" | "NotImplemented" | "RateLimited" | "ResultExpired" | "SchemaMismatch" | "SessionExpired" | "SessionReplaced" | "SourceMismatch" | "Unauthenticated" | "Unavailable" | "ValidationFailed" | "ViewReplaced">, Runtime | Scope.Scope>;
+//#endregion
+//# sourceMappingURL=view.d.ts.map

package/lib/runtime/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","names":[],"sources":["../../src/runtime/view.ts"],"mappings":";;;;;;;;;iBA0DiB;WACJ,IAAI;WACJ,SAAS;WACT,SAAS;WACT,SAAS;WACT,aAAa;WACb,OAAO;WACP,aAAa,OAAO,+CACe,wBACxC,cACA,MAAM;WAED,SAAS;WACT,oBAAoB;WACpB;;;qBAIA,0BAAuB,SAAA,uBAAA,OAAA,OAAA,KAAA,kDAAA,iCAAA,iWAAA,UAAA,MAAA"}