@party-stack/ontology 0.20.0 → 0.21.0

package/lib/runtime/view.js

@@ -0,0 +1,256 @@
+import { ontologyCollectionDependency, ontologyCollections } from "../tanstack/descriptors.js";
+import { persistedCollectionOptions, replicatedCollectionOptions, scopedCollection } from "../tanstack/collections.js";
+import "../tanstack/index.js";
+import { createLiveOntologyAction } from "../live/actions/createLiveOntologyAction.js";
+import { makeOntologyPins } from "../live/pins.js";
+import { BackendError } from "@party-stack/ontology-backend";
+import { Runtime } from "@party-stack/runtime";
+import { Cause, Effect, Fiber, Schema, Scope, Stream } from "effect";
+import { DbClient } from "@tanstack/db";
+import { makeReplicaMonitor } from "@party-stack/ontology-replica";
+import { compileEffectSchemas } from "@party-stack/ontology-spec/effect";
+//#region src/runtime/view.ts
+const toEntry = (entry, forwarding = false) => ({
+	id: entry.invocation.id,
+	sequence: entry.sequence,
+	request: {
+		actionTypeName: entry.invocation.name,
+		parameters: entry.invocation.parameters,
+		idempotencyKey: entry.invocation.id,
+		replay: entry.invocation.replay
+	},
+	visibility: entry.optimistic ? "optimistic" : "confirmed",
+	status: entry.state,
+	createdAt: entry.createdAt,
+	attempts: entry.attempts,
+	attemptStage: forwarding ? "forwarding" : "execution",
+	retryable: entry.failureRetryable ?? true,
+	retryRequiresAcknowledgement: entry.retryRequiresAcknowledgement,
+	nextAttemptAt: entry.nextAttemptAt ?? 0,
+	lastError: entry.failure ? new BackendError({
+		operation: "applyAction",
+		kind: entry.failure,
+		message: entry.failureMessage ?? "Action is blocked; resolve its cause and retry or discard it.",
+		retryable: entry.failureRetryable ?? false,
+		actionOutcome: entry.failureOutcome,
+		issues: entry.failureIssues
+	}) : void 0
+});
+const actionResult = (receipt) => ({
+	receipt,
+	attachmentIdMappings: receipt.attachmentIdMappings ? [...receipt.attachmentIdMappings] : void 0
+});
+/** Materialize a scoped UI view over an existing replica; engine ownership is independent. */
+const makeReplicaOntologyView = Effect.fn("Ontology.view")(function* (options) {
+	const runtime = yield* Runtime;
+	const { ir, context, replica } = options;
+	const actionReturns = compileEffectSchemas(ir).actionReturnSchemas;
+	const visiblePending = replica.outbox.entries;
+	const replicaMonitor = yield* makeReplicaMonitor(replica.status.changes);
+	const outboxEntries = Effect.map(visiblePending, (entries) => entries.map((entry) => toEntry(entry, entry.forwarding)));
+	const owner = yield* Effect.scope;
+	const captured = yield* Effect.context();
+	const dbClient = yield* Effect.acquireRelease(Effect.sync(() => new DbClient({ [ontologyCollectionDependency]: (id, objectType, localOnly) => {
+		if (owner.state._tag === "Closed") throw new BackendError({
+			operation: "ontology.collection",
+			kind: "InvalidRequest",
+			retryable: false,
+			message: "Ontology view is closed."
+		});
+		const object = ir.objectTypes.find((object) => object.name === objectType);
+		if (!object) throw new BackendError({
+			operation: "ontology.collection",
+			kind: "InvalidRequest",
+			retryable: false,
+			message: `Unknown object type: ${objectType}.`
+		});
+		return Effect.runSyncWith(captured)(Scope.provide(replicatedCollectionOptions({
+			id,
+			replica,
+			objectType,
+			localOnly,
+			getKey: (row) => row[object.primaryKey]
+		}), owner));
+	} })), (client) => Effect.promise(() => client.cleanup()));
+	const pendingCollection = yield* scopedCollection(yield* persistedCollectionOptions({
+		id: `${runtime.namespace}:outbox`,
+		getKey: (entry) => entry.id,
+		changes: Stream.empty,
+		observe: () => replica.outbox.observe().pipe(Stream.map((entries) => ({
+			reset: true,
+			rows: entries.map((entry) => ({
+				key: entry.invocation.id,
+				value: toEntry(entry, entry.forwarding)
+			})),
+			removed: []
+		}))),
+		load: Effect.map(outboxEntries, (entries) => entries.map((entry) => ({
+			key: entry.id,
+			value: entry
+		})))
+	}), dbClient);
+	const run = (work, signal) => Effect.runPromiseWith(captured)(Effect.suspend(() => owner.state._tag === "Closed" ? Effect.interrupt : Effect.flatMap(Effect.forkIn(Scope.provide(work, owner), owner, { startImmediately: true }), (fiber) => Fiber.join(fiber).pipe(Effect.ensuring(Fiber.interrupt(fiber))))), { signal });
+	const wait = (id, until = "confirmed") => replica.outbox.wait(id, { until }).pipe(Effect.map((receipt) => receipt ? actionResult(receipt) : void 0));
+	const descriptors = ontologyCollections(Object.fromEntries(ir.objectTypes.map((type) => [type.name, type.primaryKey])));
+	const objectCollections = (localOnly) => {
+		const collections = {};
+		for (const object of ir.objectTypes) {
+			let collection;
+			Object.defineProperty(collections, object.name, {
+				enumerable: true,
+				get: () => {
+					if (collection) return collection;
+					if (owner.state._tag === "Closed") throw new BackendError({
+						operation: "ontology.collection",
+						kind: "InvalidRequest",
+						retryable: false,
+						message: "Ontology view is closed."
+					});
+					collection = dbClient.collection((localOnly ? descriptors.cachedObjects : descriptors.objects)[object.name]);
+					return collection;
+				}
+			});
+		}
+		return collections;
+	};
+	const objects = objectCollections(false);
+	const cachedObjects = objectCollections(true);
+	const enqueue = async (request, visibility) => {
+		const invocation = {
+			id: request.idempotencyKey ?? crypto.randomUUID(),
+			name: request.actionTypeName,
+			parameters: request.parameters,
+			replay: request.replay
+		};
+		const entry = await run(replica.outbox.enqueue(invocation, { optimistic: (visibility ?? options.writes?.defaultVisibility) === "optimistic" }));
+		const accepted = run(wait(entry.invocation.id, "accepted")).then(() => void 0);
+		accepted.catch(() => void 0);
+		const completed = run(wait(entry.invocation.id)).then((result) => {
+			if (!result) throw new BackendError({
+				operation: "applyAction",
+				kind: "ResultExpired",
+				message: "Action result is unavailable.",
+				retryable: false,
+				actionOutcome: "unknown"
+			});
+			return result;
+		});
+		completed.catch(() => void 0);
+		if (replica.upstreamKind === "speculative") await accepted;
+		return {
+			entry: toEntry(entry, replica.upstreamKind === "speculative"),
+			accepted,
+			completed
+		};
+	};
+	const outbox = {
+		collection: pendingCollection,
+		enqueue: async (request, settings) => {
+			const result = await enqueue(request, settings?.visibility);
+			return {
+				...result,
+				completed: result.completed
+			};
+		},
+		remove: (id, settings) => run(replica.outbox.remove(id, settings)),
+		retry: (id, settings) => run(replica.outbox.retry(id, settings)),
+		wait: (id, settings) => run(wait(id, settings?.until), settings?.signal),
+		edit: async (id, update) => {
+			const entry = (await run(visiblePending)).find((entry) => entry.invocation.id === id);
+			if (!entry) throw new BackendError({
+				operation: "outbox.edit",
+				kind: "NotFound",
+				retryable: false,
+				message: "Outbox entry is unavailable."
+			});
+			const request = toEntry(entry).request;
+			update(request);
+			const invocation = {
+				id,
+				name: request.actionTypeName,
+				parameters: request.parameters,
+				replay: request.replay
+			};
+			await run(replica.outbox.edit(id, invocation));
+		}
+	};
+	const actions = Object.fromEntries(ir.actionTypes.map((action) => [action.name, createLiveOntologyAction({
+		action,
+		resolveParameters: (name, parameters) => run(replica.actions.resolveParameters(name, parameters)),
+		submit: async (request, settings) => {
+			const visibility = settings?.visibility ?? options.writes?.defaultVisibility ?? "confirmed";
+			const receipt = await run(replica.actions.apply({
+				id: request.idempotencyKey ?? crypto.randomUUID(),
+				name: request.actionTypeName,
+				parameters: request.parameters,
+				replay: request.replay
+			}, { optimistic: visibility === "optimistic" }));
+			const schema = actionReturns[action.name];
+			const result = schema ? await run(Schema.decodeUnknownEffect(Schema.toCodecJson(schema))(receipt.result).pipe(Effect.mapError((cause) => new BackendError({
+				operation: "applyAction.result",
+				kind: "InvalidResponse",
+				retryable: false,
+				message: "Committed action result does not match its definition.",
+				cause
+			})))) : void 0;
+			return {
+				...actionResult(receipt),
+				result
+			};
+		},
+		validate: (name, parameters) => run(replica.actions.validate(name, parameters)),
+		validateDraft: (name, parameters, settings) => run(replica.actions.validate(name, parameters, { knownParameters: settings?.knownParameters ?? [] }))
+	})]));
+	const downloadPins = yield* makeOntologyPins({
+		backend: options.pinBackend ?? replica.demand.pins.backend,
+		dbClient
+	});
+	const clearFamily = downloadPins.clear;
+	return {
+		dbClient,
+		ir,
+		context,
+		objects,
+		cachedObjects,
+		actions,
+		outbox,
+		pins: Object.assign(downloadPins, {
+			get: () => run((options.pins ?? replica.demand).pinStatus),
+			set: (query, settings) => run((options.pins ?? replica.demand).setPin(query, settings)),
+			clear: (name) => name === void 0 ? run((options.pins ?? replica.demand).clearPin) : clearFamily(name),
+			subscribe: (listener, onError) => {
+				if (owner.state._tag === "Closed") throw new BackendError({
+					operation: "pins.subscribe",
+					kind: "InvalidRequest",
+					retryable: false,
+					message: "Ontology view is closed."
+				});
+				const watch = Stream.runForEach((options.pins ?? replica.demand).pinStatusChanges, (status) => Effect.sync(() => listener(status))).pipe(Effect.catchCause((cause) => Cause.hasInterruptsOnly(cause) ? Effect.void : Effect.sync(() => {
+					if (onError) onError(Cause.squash(cause));
+					else console.error("Pin subscription failed.", Cause.pretty(cause));
+				})));
+				const fiber = Effect.runSyncWith(captured)(Effect.forkIn(watch, owner));
+				return () => {
+					Effect.runFork(Fiber.interrupt(fiber));
+				};
+			}
+		}),
+		attachments: options.attachments,
+		decrypt: async (value, settings) => (await run(replica.decrypt(value, settings), settings?.signal)).value,
+		queryFunctions: Object.fromEntries(ir.queryFunctionTypes.map((query) => [query.name, (parameters) => run(replica.queryFunction(query.name, parameters))])),
+		traces: options.traces,
+		diagnostics: {
+			label: options.diagnosticLabel,
+			role: replica.upstreamKind === "committed" ? "host" : "replica",
+			location: "In process",
+			replica: replicaMonitor,
+			traces: options.traces,
+			parent: options.parentDiagnostics
+		},
+		replica
+	};
+});
+//#endregion
+export { makeReplicaOntologyView };
+
+//# sourceMappingURL=view.js.map

package/lib/runtime/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","names":[],"sources":["../../src/runtime/view.ts"],"sourcesContent":["import { BackendError } from \"@party-stack/ontology-backend\";\nimport { makeReplicaMonitor } from \"@party-stack/ontology-replica\";\nimport { compileEffectSchemas } from \"@party-stack/ontology-spec/effect\";\nimport { Runtime } from \"@party-stack/runtime\";\nimport { DbClient } from \"@tanstack/db\";\nimport { Schema } from \"effect\";\nimport { Effect, Scope, Fiber, Stream, Cause } from \"effect\";\nimport { createLiveOntologyAction } from \"../live/actions/createLiveOntologyAction.js\";\nimport { makeOntologyPins } from \"../live/pins.js\";\nimport { ontologyCollections, ontologyCollectionDependency } from \"../tanstack/descriptors.js\";\nimport {\n    replicatedCollectionOptions,\n    persistedCollectionOptions,\n    scopedCollection,\n} from \"../tanstack/index.js\";\nimport type { OntologyApplyActionResult } from \"../live/actions/types.js\";\nimport type { LiveOntologyAttachments } from \"../live/attachments/createLiveOntologyAttachments.js\";\nimport type { LiveOntology, LiveOntologyWrites } from \"../live/LiveOntology.js\";\nimport type { OntologyOutbox, OntologyOutboxEntry, OntologyActionRequest } from \"../live/outbox/types.js\";\nimport type { ActionRequest, ActionReceipt } from \"@party-stack/ontology-backend\";\nimport type { PendingAction, ReplicaService, ReplicaPinControls } from \"@party-stack/ontology-replica\";\nimport type { OntologyIR, OntologyObject } from \"@party-stack/ontology-spec\";\nimport type { TraceStore } from \"@party-stack/runtime/tracing\";\nimport type { Collection } from \"@tanstack/db\";\nconst toEntry = (entry: PendingAction, forwarding = false): OntologyOutboxEntry => ({\n    id: entry.invocation.id,\n    sequence: entry.sequence,\n    request: {\n        actionTypeName: entry.invocation.name,\n        parameters: entry.invocation.parameters,\n        idempotencyKey: entry.invocation.id,\n        replay: entry.invocation.replay,\n    },\n    visibility: entry.optimistic ? \"optimistic\" : \"confirmed\",\n    status: entry.state,\n    createdAt: entry.createdAt,\n    attempts: entry.attempts,\n    attemptStage: forwarding ? \"forwarding\" : \"execution\",\n    retryable: entry.failureRetryable ?? true,\n    retryRequiresAcknowledgement: entry.retryRequiresAcknowledgement,\n    nextAttemptAt: entry.nextAttemptAt ?? 0,\n    lastError: entry.failure\n        ? new BackendError({\n              operation: \"applyAction\",\n              kind: entry.failure,\n              message:\n                  entry.failureMessage ?? \"Action is blocked; resolve its cause and retry or discard it.\",\n              retryable: entry.failureRetryable ?? false,\n              actionOutcome: entry.failureOutcome,\n              issues: entry.failureIssues,\n          })\n        : undefined,\n});\nconst actionResult = (receipt: ActionReceipt): OntologyApplyActionResult => ({\n    receipt,\n    attachmentIdMappings: receipt.attachmentIdMappings ? [...receipt.attachmentIdMappings] : undefined,\n});\n\nexport interface ReplicaViewOptions {\n    readonly ir: OntologyIR;\n    readonly context: Record<string, unknown>;\n    readonly writes?: LiveOntologyWrites;\n    readonly replica: ReplicaService;\n    readonly attachments: LiveOntologyAttachments;\n    readonly pins?: ReplicaPinControls;\n    readonly pinBackend?: Effect.Effect<\n        import(\"@party-stack/ontology-backend\").OntologyBackendService,\n        BackendError,\n        Scope.Scope\n    >;\n    readonly traces?: TraceStore;\n    readonly parentDiagnostics?: LiveOntology[\"diagnostics\"];\n    readonly diagnosticLabel?: string;\n}\n\n/** Materialize a scoped UI view over an existing replica; engine ownership is independent. */\nexport const makeReplicaOntologyView = Effect.fn(\"Ontology.view\")(function* (\n    options: ReplicaViewOptions\n): Effect.fn.Return<Omit<LiveOntology, \"cleanup\">, BackendError, Runtime | Scope.Scope> {\n    const services = yield* Runtime;\n    const runtime = services;\n    const { ir, context, replica } = options;\n    const schemas = compileEffectSchemas(ir);\n    const actionReturns = schemas.actionReturnSchemas;\n    const visiblePending = replica.outbox.entries;\n    const replicaMonitor = yield* makeReplicaMonitor(replica.status.changes);\n    const outboxEntries = Effect.map(visiblePending, (entries) =>\n        entries.map((entry) => toEntry(entry, entry.forwarding))\n    );\n    const owner = yield* Effect.scope;\n    const captured = yield* Effect.context<Runtime>();\n    const dbClient = yield* Effect.acquireRelease(\n        Effect.sync(\n            () =>\n                new DbClient({\n                    [ontologyCollectionDependency]: (id: string, objectType: string, localOnly: boolean) => {\n                        if (owner.state._tag === \"Closed\")\n                            throw new BackendError({\n                                operation: \"ontology.collection\",\n                                kind: \"InvalidRequest\",\n                                retryable: false,\n                                message: \"Ontology view is closed.\",\n                            });\n                        const object = ir.objectTypes.find((object) => object.name === objectType);\n                        if (!object)\n                            throw new BackendError({\n                                operation: \"ontology.collection\",\n                                kind: \"InvalidRequest\",\n                                retryable: false,\n                                message: `Unknown object type: ${objectType}.`,\n                            });\n                        return Effect.runSyncWith(captured)(\n                            Scope.provide(\n                                replicatedCollectionOptions({\n                                    id,\n                                    replica,\n                                    objectType,\n                                    localOnly,\n                                    getKey: (row: OntologyObject) =>\n                                        row[object.primaryKey] as string | number,\n                                }),\n                                owner\n                            )\n                        );\n                    },\n                })\n        ),\n        (client) => Effect.promise(() => client.cleanup())\n    );\n    const pendingCollection = yield* scopedCollection(\n        yield* persistedCollectionOptions<OntologyOutboxEntry, string>({\n            id: `${runtime.namespace}:outbox`,\n            getKey: (entry) => entry.id,\n            changes: Stream.empty,\n            observe: () =>\n                replica.outbox.observe().pipe(\n                    Stream.map((entries) => ({\n                        reset: true,\n                        rows: entries.map((entry) => ({\n                            key: entry.invocation.id,\n                            value: toEntry(entry, entry.forwarding),\n                        })),\n                        removed: [],\n                    }))\n                ),\n            load: Effect.map(outboxEntries, (entries) =>\n                entries.map((entry) => ({ key: entry.id, value: entry }))\n            ),\n        }),\n        dbClient\n    );\n    const run = <A, E>(work: Effect.Effect<A, E, Scope.Scope>, signal?: AbortSignal) =>\n        Effect.runPromiseWith(captured)(\n            Effect.suspend(() =>\n                owner.state._tag === \"Closed\"\n                    ? Effect.interrupt\n                    : Effect.flatMap(\n                          Effect.forkIn(Scope.provide(work, owner), owner, { startImmediately: true }),\n                          (fiber) => Fiber.join(fiber).pipe(Effect.ensuring(Fiber.interrupt(fiber)))\n                      )\n            ),\n            { signal }\n        );\n    const wait = (id: string, until: \"accepted\" | \"confirmed\" = \"confirmed\") =>\n        replica.outbox\n            .wait(id, { until })\n            .pipe(Effect.map((receipt) => (receipt ? actionResult(receipt) : undefined)));\n    const descriptors = ontologyCollections(\n        Object.fromEntries(ir.objectTypes.map((type) => [type.name, type.primaryKey]))\n    );\n    const objectCollections = (localOnly: boolean) => {\n        const collections: Record<string, Collection<OntologyObject>> = {};\n        for (const object of ir.objectTypes) {\n            let collection: Collection<OntologyObject> | undefined;\n            Object.defineProperty(collections, object.name, {\n                enumerable: true,\n                get: () => {\n                    if (collection) return collection;\n                    if (owner.state._tag === \"Closed\")\n                        throw new BackendError({\n                            operation: \"ontology.collection\",\n                            kind: \"InvalidRequest\",\n                            retryable: false,\n                            message: \"Ontology view is closed.\",\n                        });\n                    // Descriptors and SDK getters share the same client-owned instance.\n                    collection = dbClient.collection(\n                        (localOnly ? descriptors.cachedObjects : descriptors.objects)[object.name]!\n                    );\n                    return collection;\n                },\n            });\n        }\n        return collections;\n    };\n    const objects = objectCollections(false);\n    const cachedObjects = objectCollections(true);\n    const enqueue = async (\n        request: Omit<OntologyActionRequest, \"idempotencyKey\"> & { idempotencyKey?: string },\n        visibility?: \"confirmed\" | \"optimistic\"\n    ) => {\n        const invocation: ActionRequest = {\n            id: request.idempotencyKey ?? crypto.randomUUID(),\n            name: request.actionTypeName,\n            parameters: request.parameters,\n            replay: request.replay,\n        };\n        const entry = await run(\n            replica.outbox.enqueue(invocation, {\n                optimistic: (visibility ?? options.writes?.defaultVisibility) === \"optimistic\",\n            })\n        );\n        const accepted = run(wait(entry.invocation.id, \"accepted\")).then(() => undefined);\n        void accepted.catch(() => undefined);\n        const completed = run(wait(entry.invocation.id)).then((result) => {\n            if (!result)\n                throw new BackendError({\n                    operation: \"applyAction\",\n                    kind: \"ResultExpired\",\n                    message: \"Action result is unavailable.\",\n                    retryable: false,\n                    actionOutcome: \"unknown\",\n                });\n            return result;\n        });\n        void completed.catch(() => undefined);\n        if (replica.upstreamKind === \"speculative\") await accepted;\n        return { entry: toEntry(entry, replica.upstreamKind === \"speculative\"), accepted, completed };\n    };\n    const outbox: OntologyOutbox = {\n        collection: pendingCollection,\n        enqueue: async <A>(\n            request: Omit<OntologyActionRequest, \"idempotencyKey\"> & { idempotencyKey?: string },\n            settings?: { visibility?: \"confirmed\" | \"optimistic\" }\n        ) => {\n            const result = await enqueue(request, settings?.visibility);\n            return { ...result, completed: result.completed as Promise<A> };\n        },\n        remove: (id, settings) => run(replica.outbox.remove(id, settings)),\n        retry: (id, settings) => run(replica.outbox.retry(id, settings)),\n        wait: <A>(id: string, settings?: { until?: \"accepted\" | \"confirmed\"; signal?: AbortSignal }) =>\n            run(wait(id, settings?.until), settings?.signal) as Promise<A | void>,\n        edit: async (id, update) => {\n            const entry = (await run(visiblePending)).find((entry) => entry.invocation.id === id);\n            if (!entry)\n                throw new BackendError({\n                    operation: \"outbox.edit\",\n                    kind: \"NotFound\",\n                    retryable: false,\n                    message: \"Outbox entry is unavailable.\",\n                });\n            const request = toEntry(entry).request;\n            update(request);\n            const invocation = {\n                id,\n                name: request.actionTypeName,\n                parameters: request.parameters,\n                replay: request.replay,\n            };\n            await run(replica.outbox.edit(id, invocation));\n        },\n    };\n    const actions = Object.fromEntries(\n        ir.actionTypes.map((action) => [\n            action.name,\n            createLiveOntologyAction({\n                action,\n                resolveParameters: (name, parameters) =>\n                    run(replica.actions.resolveParameters(name, parameters)),\n                submit: async (request, settings) => {\n                    const visibility =\n                        settings?.visibility ?? options.writes?.defaultVisibility ?? \"confirmed\";\n                    const receipt = await run(\n                        replica.actions.apply(\n                            {\n                                id: request.idempotencyKey ?? crypto.randomUUID(),\n                                name: request.actionTypeName,\n                                parameters: request.parameters,\n                                replay: request.replay,\n                            },\n                            { optimistic: visibility === \"optimistic\" }\n                        )\n                    );\n                    const schema = actionReturns[action.name];\n                    const result = schema\n                        ? await run(\n                              Schema.decodeUnknownEffect(Schema.toCodecJson(schema))(receipt.result).pipe(\n                                  Effect.mapError(\n                                      (cause) =>\n                                          new BackendError({\n                                              operation: \"applyAction.result\",\n                                              kind: \"InvalidResponse\",\n                                              retryable: false,\n                                              message:\n                                                  \"Committed action result does not match its definition.\",\n                                              cause,\n                                          })\n                                  )\n                              )\n                          )\n                        : undefined;\n                    return { ...actionResult(receipt), result };\n                },\n                validate: (name, parameters) => run(replica.actions.validate(name, parameters)),\n                validateDraft: (name, parameters, settings) =>\n                    run(\n                        replica.actions.validate(name, parameters, {\n                            knownParameters: settings?.knownParameters ?? [],\n                        })\n                    ),\n            }),\n        ])\n    );\n    const downloadPins = yield* makeOntologyPins({\n        backend: options.pinBackend ?? replica.demand.pins.backend,\n        dbClient,\n    });\n    const clearFamily = downloadPins.clear;\n    return {\n        dbClient,\n        ir,\n        context,\n        objects,\n        cachedObjects,\n        actions,\n        outbox,\n        pins: Object.assign(downloadPins, {\n            get: () => run((options.pins ?? replica.demand).pinStatus),\n            set: (\n                query: import(\"@party-stack/ontology-spec\").QueryDocument,\n                settings?: import(\"@party-stack/ontology-replica\").PinOptions\n            ) => run((options.pins ?? replica.demand).setPin(query, settings)),\n            clear: (name?: string) =>\n                name === undefined ? run((options.pins ?? replica.demand).clearPin) : clearFamily(name),\n            subscribe: (\n                listener: (status: import(\"@party-stack/ontology-replica\").PinStatus | undefined) => void,\n                onError?: (error: unknown) => void\n            ) => {\n                if (owner.state._tag === \"Closed\")\n                    throw new BackendError({\n                        operation: \"pins.subscribe\",\n                        kind: \"InvalidRequest\",\n                        retryable: false,\n                        message: \"Ontology view is closed.\",\n                    });\n                const watch = Stream.runForEach((options.pins ?? replica.demand).pinStatusChanges, (status) =>\n                    Effect.sync(() => listener(status))\n                ).pipe(\n                    Effect.catchCause((cause) =>\n                        Cause.hasInterruptsOnly(cause)\n                            ? Effect.void\n                            : Effect.sync(() => {\n                                  if (onError) onError(Cause.squash(cause));\n                                  else console.error(\"Pin subscription failed.\", Cause.pretty(cause));\n                              })\n                    )\n                );\n                const fiber = Effect.runSyncWith(captured)(Effect.forkIn(watch, owner));\n                return () => {\n                    Effect.runFork(Fiber.interrupt(fiber));\n                };\n            },\n        }),\n        attachments: options.attachments,\n        decrypt: async (value, settings) =>\n            (await run(replica.decrypt(value, settings), settings?.signal)).value as never,\n        queryFunctions: Object.fromEntries(\n            ir.queryFunctionTypes.map((query) => [\n                query.name,\n                (parameters: Record<string, unknown>) => run(replica.queryFunction(query.name, parameters)),\n            ])\n        ),\n        traces: options.traces,\n        diagnostics: {\n            label: options.diagnosticLabel,\n            role: replica.upstreamKind === \"committed\" ? \"host\" : \"replica\",\n            location: \"In process\",\n            replica: replicaMonitor,\n            traces: options.traces,\n            parent: options.parentDiagnostics,\n        },\n        replica,\n    };\n});\n"],"mappings":"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"}

package/lib/tanstack/collections.d.ts

@@ -0,0 +1,73 @@
+import { CollectionDemandDiagnostic } from "./diagnostics.js";
+import { Runtime } from "@party-stack/runtime";
+import { Effect, Scope, Stream } from "effect";
+import { CollectionConfig, DbClient, LoadSubsetOptions } from "@tanstack/db";
+import { Key } from "@party-stack/ontology-storage";
+import { ReplicaService } from "@party-stack/ontology-replica";
+//#region src/tanstack/collections.d.ts
+interface Change<A> {
+  readonly key: Key;
+  readonly type: "insert" | "update" | "delete";
+  readonly modified: A;
+}
+interface PersistedCollectionOptions<A extends object, K extends Key> {
+  readonly id: string;
+  readonly getKey: (value: A) => K;
+  readonly primaryKey?: string;
+  readonly load: Effect.Effect<readonly {
+    key: Key;
+    value: A;
+  }[], unknown> | ((subset: LoadSubsetOptions) => Effect.Effect<readonly {
+    key: Key;
+    value: A;
+  }[], unknown>);
+  readonly changes: Stream.Stream<void>;
+  readonly observe?: (subset: LoadSubsetOptions) => Stream.Stream<{
+    readonly reset: boolean;
+    readonly rows: readonly {
+      key: Key;
+      value: A;
+    }[];
+    readonly removed: readonly Key[];
+  }, unknown>;
+  readonly persist?: (mutations: readonly Change<A>[]) => Effect.Effect<void, unknown>;
+  readonly acquireDemand?: Effect.Effect<void, unknown, Scope.Scope> | ((subset: LoadSubsetOptions) => Effect.Effect<void, unknown, Scope.Scope>);
+  readonly describeSubset?: (subset: LoadSubsetOptions) => Omit<CollectionDemandDiagnostic, "subscription">;
+  /** Compare the regions actually acquired by this source, after residual
+   * filters/order have widened them. No inference from cached row contents.
+   */
+  readonly covers?: (requested: LoadSubsetOptions, held: LoadSubsetOptions) => boolean;
+  readonly supportsOrderedWindow?: (subset: LoadSubsetOptions) => boolean;
+}
+/** Options creators are Effects: their callback fibers and subscriptions belong to the caller's scope. */
+export declare const persistedCollectionOptions: <A extends object, K extends Key>(options: PersistedCollectionOptions<A, K>) => Effect.Effect<CollectionConfig<A, K, never, import("@tanstack/db").UtilsRecord>, never, Scope.Scope>;
+export declare const localCollectionOptions: <A extends object, K extends Key>(options: {
+  readonly name: string;
+  readonly getKey: (value: A) => K;
+  readonly schemaVersion?: number;
+}) => Effect.Effect<CollectionConfig<A, K, never, import("@tanstack/db").UtilsRecord>, never, Runtime | Scope.Scope>;
+export declare const replicatedCollectionOptions: <A extends object>(options: {
+  readonly replica: ReplicaService;
+  readonly objectType: string;
+  readonly getKey: (value: A) => Key;
+  readonly id: string;
+  /** Observe and retain local cache only; never acquire upstream demand. */
+  readonly localOnly?: boolean;
+}) => Effect.Effect<CollectionConfig<A, Key, never, import("@tanstack/db").UtilsRecord>, never, Scope.Scope>;
+export declare const scopedCollection: <A extends object, K extends Key>(options: CollectionConfig<A, K>, client?: DbClient) => Effect.Effect<import("@tanstack/db").Collection<A, K, import("@tanstack/db").UtilsRecord, never, A> & import("@tanstack/db").NonSingleResult, never, Scope.Scope>;
+export declare const makeLocalCollection: <A extends object, K extends Key>(options: {
+  readonly name: string;
+  readonly getKey: (value: A) => K;
+  readonly schemaVersion?: number;
+}) => Effect.Effect<import("@tanstack/db").Collection<A, K, import("@tanstack/db").UtilsRecord, never, A> & import("@tanstack/db").NonSingleResult, never, Runtime | Scope.Scope>;
+export declare const makeReplicatedCollection: <A extends object>(options: {
+  readonly replica: ReplicaService;
+  readonly objectType: string;
+  readonly getKey: (value: A) => Key;
+  readonly id: string;
+  /** Observe and retain local cache only; never acquire upstream demand. */
+  readonly localOnly?: boolean;
+}, client?: DbClient | undefined) => Effect.Effect<import("@tanstack/db").Collection<A, Key, import("@tanstack/db").UtilsRecord, never, A> & import("@tanstack/db").NonSingleResult, never, Scope.Scope>;
+//#endregion
+export {};
+//# sourceMappingURL=collections.d.ts.map

package/lib/tanstack/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","names":[],"sources":["../../src/tanstack/collections.ts"],"mappings":";;;;;;;UAaU,OAAO;WACJ,KAAK;WACL;WACA,UAAU;;UAmCb,2BAA2B,kBAAkB,UAAU;WACpD;WACA,SAAS,OAAO,MAAM;WACtB;WACA,MACH,OAAO;IAAkB,KAAK;IAAK,OAAO;oBACxC,QAAQ,sBAAsB,OAAO;IAAkB,KAAK;IAAK,OAAO;;WACvE,SAAS,OAAO;WAChB,WAAW,QAAQ,sBAAsB,OAAO;aAExC;aACA;MAAiB,KAAK;MAAK,OAAO;;aAClC,kBAAkB;;WAI1B,WAAW,oBAAoB,OAAO,SAAS,OAAO;WACtD,gBACH,OAAO,sBAAsB,MAAM,WACjC,QAAQ,sBAAsB,OAAO,sBAAsB,MAAM;WAChE,kBAAkB,QAAQ,sBAAsB,KAAK;;;;WAIrD,UAAU,WAAW,mBAAmB,MAAM;WAC9C,yBAAyB,QAAQ;;;qBAGjC,6BAA8B,kBAAkB,UAAU,KAAG,SAC7D,2BAA2B,GAAG,OAAE,OAAA,OAAA,iBAAA,GAAA,iCAAA,qBAAA,MAAA;qBA6lBhC,yBAAsD,kBAAkB,UAAU,KAAG;WAC/E;WACE,SAAC,OAAO,MAAM;WACN;MA0B3B,OAAA,OAAA,iBAAA,GAAA,iCAAA,qBAAA,UAAA,MAAA;qBACW,8BAA2D,kBAAgB;WAClE,SAAA;WACG;WACJ,SAAC,OAAO,MAAM;WAClB;;WAEQ;MAyEvB,OAAA,OAAA,iBAAA,GAAA,mCAAA,qBAAA,MAAA;qBACW,mBAAoB,kBAAkB,UAAU,KAAG,SACnD,iBAAiB,GAAG,IAAE,SACtB,aAAQ,OAAA,8BAAA,WAAA,GAAA,0BAAA,oBAAA,4BAAA,wBAAA,MAAA;qBAWR,sBACT,kBACA,UAAU,KAAG;WA5HE;;WAEU;MA6H3B,OAAA,8BAAA,WAAA,GAAA,0BAAA,oBAAA,4BAAA,wBAAA,UAAA,MAAA;qBACW,2BACT,kBAAgB;WAnGE,SAAA;WACG;WACU,SAAA,OAAA,MAAA;WAClB;;WAEQ;GAiGvB,SAAA,yBAAA,OAAA,8BAAA,WAAA,GAAA,4BAAA,oBAAA,4BAAA,wBAAA,MAAA"}