@party-stack/ontology 0.19.1 → 0.21.0

package/lib/live/actions/createLiveOntologyAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLiveOntologyAction.js","names":[],"sources":["../../../src/live/actions/createLiveOntologyAction.ts"],"sourcesContent":["import { resolveActionParameters } from \"../expression.js\";\nimport { createReadTx } from \"../mutators/createMutatorTx.js\";\nimport type { OntologyIR } from \"../../ir/index.js\";\nimport type { Uncertain } from \"../../utils/uncertain.js\";\nimport type { ValidationIssue } from \"../../utils/validation.js\";\nimport type { Result } from \"../../utils/values.js\";\nimport type { LiveOntologyWriteMode, LiveOntologyWriteVisibility } from \"../LiveOntology.js\";\nimport type { OntologyCollection } from \"../objects/createLiveOntologyObjectCollection.js\";\nimport type { OntologyObject } from \"../objects/OntologyObject.js\";\nimport type { OntologyApplyActionResult } from \"../OntologyBackendAdapter.js\";\nimport type { OntologyActionRequest } from \"../outbox/types.js\";\n\nexport interface LiveOntologyActionOptions {\n    idempotencyKey?: string;\n    mode?: LiveOntologyWriteMode;\n    visibility?: LiveOntologyWriteVisibility;\n}\n\nexport interface LiveOntologyActionDraftValidationOptions<Parameters extends Record<string, unknown>> {\n    knownParameters?: readonly (keyof Parameters)[];\n}\n\nexport type LiveOntologyAction<Parameters extends Record<string, unknown> = Record<string, unknown>> = {\n    (parameters: Parameters, options?: LiveOntologyActionOptions): Promise<OntologyApplyActionResult | void>;\n    resolveParameters(parameters: Partial<Parameters>): Promise<Partial<Parameters>>;\n    validate(parameters: Parameters): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n    validateDraft(\n        parameters: Partial<Parameters>,\n        options?: LiveOntologyActionDraftValidationOptions<Parameters>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n};\n\nexport function createLiveOntologyAction(options: {\n    ir: OntologyIR;\n    action: OntologyIR[\"actionTypes\"][number];\n    context?: Record<string, unknown>;\n    objects: Record<string, OntologyCollection<OntologyObject>>;\n    submit(\n        request: OntologyActionRequest,\n        options?: LiveOntologyActionOptions\n    ): Promise<OntologyApplyActionResult | void>;\n    validate(\n        actionTypeName: string,\n        parameters: Record<string, unknown>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n    validateDraft(\n        actionTypeName: string,\n        parameters: Record<string, unknown>,\n        validationOptions?: LiveOntologyActionDraftValidationOptions<Record<string, unknown>>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n}): LiveOntologyAction {\n    const resolveParameters = (providedParameters: Record<string, unknown>) =>\n        resolveActionParameters({\n            ir: options.ir,\n            actionTypeName: options.action.name,\n            initialParameters: providedParameters,\n            context: options.context ?? {},\n            tx: createReadTx(options.objects),\n        });\n    const apply: LiveOntologyAction = async (providedParameters, executionOptions) => {\n        const idempotencyKey = executionOptions?.idempotencyKey ?? crypto.randomUUID();\n        return options.submit(\n            {\n                actionTypeName: options.action.name,\n                parameters: providedParameters,\n                idempotencyKey,\n            },\n            executionOptions\n        );\n    };\n    apply.validate = async (providedParameters) => options.validate(options.action.name, providedParameters);\n    apply.resolveParameters = resolveParameters;\n    apply.validateDraft = async (parameters, validationOptions) =>\n        options.validateDraft(options.action.name, parameters, validationOptions);\n    return apply;\n}\n"],"mappings":";;;AAgCA,SAAgB,yBAAyB,SAkBlB;CACnB,MAAM,qBAAqB,uBACvB,wBAAwB;EACpB,IAAI,QAAQ;EACZ,gBAAgB,QAAQ,OAAO;EAC/B,mBAAmB;EACnB,SAAS,QAAQ,WAAW,CAAC;EAC7B,IAAI,aAAa,QAAQ,OAAO;CACpC,CAAC;CACL,MAAM,QAA4B,OAAO,oBAAoB,qBAAqB;EAC9E,MAAM,iBAAiB,kBAAkB,kBAAkB,OAAO,WAAW;EAC7E,OAAO,QAAQ,OACX;GACI,gBAAgB,QAAQ,OAAO;GAC/B,YAAY;GACZ;EACJ,GACA,gBACJ;CACJ;CACA,MAAM,WAAW,OAAO,uBAAuB,QAAQ,SAAS,QAAQ,OAAO,MAAM,kBAAkB;CACvG,MAAM,oBAAoB;CAC1B,MAAM,gBAAgB,OAAO,YAAY,sBACrC,QAAQ,cAAc,QAAQ,OAAO,MAAM,YAAY,iBAAiB;CAC5E,OAAO;AACX"}
+{"version":3,"file":"createLiveOntologyAction.js","names":[],"sources":["../../../src/live/actions/createLiveOntologyAction.ts"],"sourcesContent":["import type { LiveOntologyWriteVisibility } from \"../LiveOntology.js\";\nimport type { OntologyActionRequest } from \"../outbox/types.js\";\nimport type { OntologyApplyActionResult } from \"./types.js\";\nimport type { ActionRequest } from \"@party-stack/ontology-backend\";\nimport type { OntologyIR } from \"@party-stack/ontology-spec\";\nimport type { Uncertain } from \"@party-stack/ontology-spec/utils\";\nimport type { ValidationIssue } from \"@party-stack/ontology-spec/utils\";\nimport type { Result } from \"@party-stack/ontology-spec/values\";\n\nexport interface LiveOntologyActionOptions {\n    idempotencyKey?: string;\n    /** Portable inputs supplied by a forwarding ontology. */\n    replay?: NonNullable<ActionRequest[\"replay\"]>;\n    visibility?: LiveOntologyWriteVisibility;\n}\n\nexport interface LiveOntologyActionDraftValidationOptions<Parameters extends Record<string, unknown>> {\n    knownParameters?: readonly (keyof Parameters)[];\n}\n\nexport type LiveOntologyAction<\n    Parameters extends Record<string, unknown> = Record<string, unknown>,\n    Return = unknown,\n    Input extends Record<string, unknown> = Parameters,\n> = {\n    /** Queue in the replica's outbox, including offline. Visibility controls prediction;\n     * the Promise resolves after authoritative confirmation and local reconciliation.\n     */\n    (parameters: Input, options?: LiveOntologyActionOptions): Promise<OntologyApplyActionResult<Return>>;\n    resolveParameters(parameters: Partial<Parameters>): Promise<Partial<Parameters>>;\n    validate(parameters: Parameters): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n    validateDraft(\n        parameters: Partial<Parameters>,\n        options?: LiveOntologyActionDraftValidationOptions<Parameters>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n};\n\nexport function createLiveOntologyAction(options: {\n    action: OntologyIR[\"actionTypes\"][number];\n    resolveParameters: (\n        name: string,\n        parameters: Record<string, unknown>\n    ) => Promise<Record<string, unknown>>;\n    submit(\n        request: OntologyActionRequest,\n        options?: LiveOntologyActionOptions\n    ): Promise<OntologyApplyActionResult>;\n    validate(\n        actionTypeName: string,\n        parameters: Record<string, unknown>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n    validateDraft(\n        actionTypeName: string,\n        parameters: Record<string, unknown>,\n        validationOptions?: LiveOntologyActionDraftValidationOptions<Record<string, unknown>>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>>;\n}): LiveOntologyAction {\n    const apply: LiveOntologyAction = async (providedParameters, executionOptions) => {\n        const idempotencyKey = executionOptions?.idempotencyKey ?? crypto.randomUUID();\n        return options.submit(\n            {\n                actionTypeName: options.action.name,\n                parameters: providedParameters,\n                idempotencyKey,\n                replay: executionOptions?.replay,\n            },\n            executionOptions\n        );\n    };\n    apply.validate = async (providedParameters) => options.validate(options.action.name, providedParameters);\n    apply.resolveParameters = (parameters) => options.resolveParameters(options.action.name, parameters);\n    apply.validateDraft = async (parameters, validationOptions) =>\n        options.validateDraft(options.action.name, parameters, validationOptions);\n    return apply;\n}\n"],"mappings":";AAqCA,SAAgB,yBAAyB,SAmBlB;CACnB,MAAM,QAA4B,OAAO,oBAAoB,qBAAqB;EAC9E,MAAM,iBAAiB,kBAAkB,kBAAkB,OAAO,WAAW;EAC7E,OAAO,QAAQ,OACX;GACI,gBAAgB,QAAQ,OAAO;GAC/B,YAAY;GACZ;GACA,QAAQ,kBAAkB;EAC9B,GACA,gBACJ;CACJ;CACA,MAAM,WAAW,OAAO,uBAAuB,QAAQ,SAAS,QAAQ,OAAO,MAAM,kBAAkB;CACvG,MAAM,qBAAqB,eAAe,QAAQ,kBAAkB,QAAQ,OAAO,MAAM,UAAU;CACnG,MAAM,gBAAgB,OAAO,YAAY,sBACrC,QAAQ,cAAc,QAAQ,OAAO,MAAM,YAAY,iBAAiB;CAC5E,OAAO;AACX"}

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

@@ -0,0 +1,21 @@
+//#region src/live/actions/types.d.ts
+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;
+}
+export type OntologyApplyActionResult<Return = unknown> = {
+  receipt?: import("@party-stack/ontology-backend").ActionReceipt;
+  /**
+   * Mappings for uploaded attachments whose canonical backend IDs differ from
+   * the local IDs supplied in `ActionRequest.attachmentUploads`.
+   */
+  attachmentIdMappings?: OntologyAttachmentIdMapping[];
+} & (undefined extends Return ? {
+  result?: Return;
+} : {
+  result: Return;
+});
+//#endregion
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/live/actions/types.ts"],"mappings":";iBAAiB;;EAEb;;EAEA;;YAGQ,0BAA0B;EAClC,kDAAkD;;;;;EAKlD,uBAAuB;uBACJ;EAAW,SAAS;;EAAa,QAAQ"}

package/lib/live/attachments/createLiveOntologyAttachments.d.ts

@@ -1,13 +1,13 @@
-import { attachment, values_d_exports } from "../../utils/values.js";
-import { OntologyIR } from "../../ir/generated/types.js";
-import "../../ir/index.js";
-import { OntologyAttachmentCreateTarget } from "../../utils/targets.js";
 import { AttachmentMetadata, AttachmentMetadataSelection } from "./types.js";
-import { OntologyAttachmentsAdapter } from "../OntologyBackendAdapter.js";
-import { BlobManager } from "@party-stack/blobs";
+import { BackendError } from "@party-stack/ontology-backend";
+import { Effect, Scope } from "effect";
+import { OntologyAttachmentCreateTarget } from "@party-stack/ontology-spec/utils";
+import { ByteInput, ByteSource, ReadableByteInput } from "@party-stack/ontology-storage/blobs";
+import { ReplicaAttachments } from "@party-stack/ontology-replica";
+import * as v from "@party-stack/ontology-spec/values";
 //#region src/live/attachments/createLiveOntologyAttachments.d.ts
 export interface LiveOntologyEagerAttachmentCreation {
-  attachment: attachment;
+  attachment: v.attachment;
   isMaterialized?: Promise<void>;
 }
 interface LiveOntologyAttachmentCreateOptions {
@@ -24,8 +24,8 @@ interface AttachmentOntologyDefinition {
     parameters: Record<string, unknown>;
   }>;
 }
-type ExtractAttachment<Value> = Value extends attachment<infer Type> ? attachment<Type> : NonNullable<Value> extends ReadonlyArray<infer Element> ? ExtractAttachment<Element> : never;
-type AttachmentAtTarget<Ontology extends AttachmentOntologyDefinition, Target> = string extends keyof Ontology["objectTypes"] ? attachment : Target extends {
+type ExtractAttachment<Value> = Value extends v.attachment<infer Type> ? v.attachment<Type> : NonNullable<Value> extends ReadonlyArray<infer Element> ? ExtractAttachment<Element> : never;
+type AttachmentAtTarget<Ontology extends AttachmentOntologyDefinition, Target> = string extends keyof Ontology["objectTypes"] ? v.attachment : Target extends {
   kind: "objectProperty";
   objectType: infer ObjectType;
   property: infer Property;
@@ -33,11 +33,11 @@ type AttachmentAtTarget<Ontology extends AttachmentOntologyDefinition, Target> =
   kind: "actionParameter";
   actionType: infer ActionType;
   parameter: infer Parameter;
-} ? ActionType extends keyof Ontology["actionTypes"] ? Parameter extends keyof Ontology["actionTypes"][ActionType]["parameters"] ? ExtractAttachment<Ontology["actionTypes"][ActionType]["parameters"][Parameter]> : never : never : attachment;
+} ? ActionType extends keyof Ontology["actionTypes"] ? Parameter extends keyof Ontology["actionTypes"][ActionType]["parameters"] ? ExtractAttachment<Ontology["actionTypes"][ActionType]["parameters"][Parameter]> : never : never : v.attachment;
 type LiveOntologyAttachmentCreateResult<Ontology extends AttachmentOntologyDefinition, Options extends LiveOntologyAttachmentCreateOptions | undefined> = {
   attachment: Options extends {
     target: infer Target;
-  } ? AttachmentAtTarget<Ontology, Target> : attachment;
+  } ? AttachmentAtTarget<Ontology, Target> : v.attachment;
 } & (Options extends {
   eager: true;
 } ? {
@@ -46,19 +46,30 @@ type LiveOntologyAttachmentCreateResult<Ontology extends AttachmentOntologyDefin
   isMaterialized?: never;
 });
 export interface LiveOntologyAttachments<Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition> {
-  create: <const Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(blob: Blob | File, opts?: Options) => Promise<LiveOntologyAttachmentCreateResult<Ontology, Options>>;
+  create: <const Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(input: ByteInput | ReadableByteInput, opts?: Options) => Promise<LiveOntologyAttachmentCreateResult<Ontology, Options>>;
   metadata: {
-    <Type extends string>(attachment: attachment<Type>): Promise<AttachmentMetadata<Type>>;
-    <Type extends string, const Selection extends AttachmentMetadataSelection<Type>>(attachment: attachment<Type>, options: {
+    <Type extends string>(attachment: v.attachment<Type>, options?: {
+      readonly signal?: AbortSignal;
+    }): Promise<AttachmentMetadata<Type>>;
+    <Type extends string, const Selection extends AttachmentMetadataSelection<Type>>(attachment: v.attachment<Type>, options: {
       select: Selection;
+      readonly signal?: AbortSignal;
     }): Promise<AttachmentMetadata<Type, Selection[number]>>;
   };
-  blob: (attachment: attachment) => Promise<Blob>;
+  blob: (attachment: v.attachment, options?: {
+    readonly signal?: AbortSignal;
+  }) => Promise<Blob>;
+  /** Consume or cancel the stream, or abort the signal, to release this read before the ontology closes. */
+  source: (attachment: v.attachment, options?: {
+    readonly signal?: AbortSignal;
+  }) => Promise<ByteSource>;
 }
-export declare function createLiveOntologyAttachments<Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition>(opts: {
-  ir: OntologyIR;
-  attachmentsAdapter: OntologyAttachmentsAdapter;
-  blobManager: BlobManager;
+/** Typed Promise boundary. Validation, staging, upload and aliases are native Replica behavior. */
+export declare function createLiveOntologyAttachments<Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition>(options: {
+  readonly attachments: ReplicaAttachments;
+  readonly scope: Scope.Scope;
+  readonly run: <A>(work: Effect.Effect<A, BackendError>, signal?: AbortSignal) => Promise<A>;
 }): LiveOntologyAttachments<Ontology>;
 //#endregion
+export {};
 //# sourceMappingURL=createLiveOntologyAttachments.d.ts.map

package/lib/live/attachments/createLiveOntologyAttachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLiveOntologyAttachments.d.ts","names":["v","v.attachment"],"sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"mappings":";;;;;;;;iBAUiB;EACb,YAAYC;EACZ,iBAAiB;;UAGX;;;;EAIN;EACA,SAAS;EACT;;UAGM;EACN,aAAa,eAAe;EAC5B,aAAa;IAGL,YAAY;;;KAKnB,kBAAkB,SACnB,cAAcA,iBAAmB,QAC3BA,WAAa,QACb,YAAY,eAAe,oBAAoB,WAC7C,kBAAkB;KAGzB,mBACD,iBAAiB,8BACjB,+BACqB,0BACnBA,aACA;EACM;EACA,kBAAkB;EAClB,gBAAgB;IAEpB,yBAAyB,0BACrB,uBAAuB,wBAAwB,cAC3C,kBAAkB,wBAAwB,YAAY,6BAG9D;EACM;EACA,kBAAkB;EAClB,iBAAiB;IAErB,yBAAyB,0BACrB,wBAAwB,wBAAwB,4BAC5C,kBAAkB,wBAAwB,0BAA0B,8BAG5EA;KAEL,mCACD,iBAAiB,8BACjB,gBAAgB;EAEhB,YAAY;IAAkB,cAAc;MACtC,mBAAmB,UAAU,UAC7BA;KACL;EAAkB;;EAAkB,iBAAiB;;EAAoB;;iBAM7D,wBACb,iBAAiB,+BAA+B;EAEhD,eAAe,gBAAgB,6DAC3B,MAAM,OAAO,MACb,OAAO,YACN,QAAQ,mCAAmC,UAAU;EAC1D;KACK,qBAAqB,YAAYA,WAAa,QAAQ,QAAQ,mBAAmB;KACjF,2BAA2B,kBAAkB,4BAA4B,OACtE,YAAYA,WAAa,OACzB;MAAW,QAAQ;QACpB,QAAQ,mBAAmB,MAAM;;EAExC,OAAO,YAAYA,eAAiB,QAAQ;;wBAGhC,8BACZ,iBAAiB,+BAA+B,8BAClD;EACE,IAAI;EACJ,oBAAoB;EACpB,aAAa;IACb,wBAAwB"}
+{"version":3,"file":"createLiveOntologyAttachments.d.ts","names":[],"sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"mappings":";;;;;;;;iBAQiB;EACb,YAAY,EAAE;EACd,iBAAiB;;UAGX;;;;EAIN;EACA,SAAS;EACT;;UAGM;EACN,aAAa,eAAe;EAC5B,aAAa;IAGL,YAAY;;;KAKnB,kBAAkB,SACnB,cAAc,EAAE,iBAAiB,QAC3B,EAAE,WAAW,QACb,YAAY,eAAe,oBAAoB,WAC7C,kBAAkB;KAGzB,mBACD,iBAAiB,8BACjB,+BACqB,0BACnB,EAAE,aACF;EACM;EACA,kBAAkB;EAClB,gBAAgB;IAEpB,yBAAyB,0BACrB,uBAAuB,wBAAwB,cAC3C,kBAAkB,wBAAwB,YAAY,6BAG9D;EACM;EACA,kBAAkB;EAClB,iBAAiB;IAErB,yBAAyB,0BACrB,wBAAwB,wBAAwB,4BAC5C,kBAAkB,wBAAwB,0BAA0B,8BAG5E,EAAE;KAEP,mCACD,iBAAiB,8BACjB,gBAAgB;EAEhB,YAAY;IAAkB,cAAc;MACtC,mBAAmB,UAAU,UAC7B,EAAE;KACP;EAAkB;;EAAkB,iBAAiB;;EAAoB;;iBAE7D,wBACb,iBAAiB,+BAA+B;EAEhD,eAAe,gBAAgB,6DAC3B,OAAO,YAAY,mBACnB,OAAO,YACN,QAAQ,mCAAmC,UAAU;EAC1D;KACK,qBACG,YAAY,EAAE,WAAW,OACzB;eAAqB,SAAS;QAC/B,QAAQ,mBAAmB;KAC7B,2BAA2B,kBAAkB,4BAA4B,OACtE,YAAY,EAAE,WAAW,OACzB;MAAW,QAAQ;eAAoB,SAAS;QACjD,QAAQ,mBAAmB,MAAM;;EAExC,OAAO,YAAY,EAAE,YAAY;aAAqB,SAAS;QAAkB,QAAQ;;EAEzF,SAAS,YAAY,EAAE,YAAY;aAAqB,SAAS;QAAkB,QAAQ;;;wBAI/E,8BACZ,iBAAiB,+BAA+B,8BAClD;WACW,aAAa;WACb,OAAO,MAAM;WACb,MAAM,GAAG,MAAM,OAAO,OAAO,GAAG,eAAe,SAAS,gBAAgB,QAAQ;IACzF,wBAAwB"}

package/lib/live/attachments/createLiveOntologyAttachments.js

@@ -1,67 +1,50 @@
-import { getTargetValueType } from "../../utils/types.js";
-import { ImageMediaTypeOptions } from "../../ir/generated/constants.js";
-import { invariant } from "@bobbyfidz/panic";
+import { Effect, Exit, Scope, Stream } from "effect";
 //#region src/live/attachments/createLiveOntologyAttachments.ts
-function satisfiesRange(value, range) {
-	return (range.min === void 0 || value >= range.min) && (range.max === void 0 || value <= range.max);
-}
-function createLiveOntologyAttachments(opts) {
-	const { attachmentsAdapter, blobManager } = opts;
-	const create = async (blob, createOpts) => {
-		const normalizedOpts = createOpts ?? {};
-		const targetType = normalizedOpts.target ? getTargetValueType(opts.ir, normalizedOpts.target) : void 0;
-		invariant(targetType === void 0 || targetType.kind === "attachment", "Target is not an attachment.");
-		const constraint = targetType?.kind === "attachment" ? targetType.value.constraint : void 0;
-		invariant(!constraint?.size || satisfiesRange(blob.size, constraint.size), `Attachment size ${blob.size} is outside the allowed range.`);
-		const content = constraint?.content;
-		if (content?.kind === "image") invariant(content.value.mediaTypes ? content.value.mediaTypes.some((mediaType) => mediaType === blob.type) : ImageMediaTypeOptions.some((option) => option.value === blob.type), `Attachment media type "${blob.type || "(empty)"}" is not allowed by the target.`);
-		const id = normalizedOpts.id ?? (targetType?.kind === "attachment" && attachmentsAdapter.generateAttachmentId ? await attachmentsAdapter.generateAttachmentId(blob, { target: targetType.value }) : crypto.randomUUID());
-		await blobManager.stage(id, blob);
-		const attachment = {
-			id,
-			type: blob.type
-		};
-		const materializeAttachment = attachmentsAdapter.materializeAttachment;
-		const materializeOptions = { target: targetType?.kind === "attachment" ? targetType.value : void 0 };
-		const canMaterialize = materializeAttachment && (attachmentsAdapter.canMaterializeAttachment?.(attachment, materializeOptions) ?? true);
-		if (normalizedOpts.eager && canMaterialize) {
-			const promise = blobManager.read(id).then((storedBlob) => materializeAttachment(attachment, storedBlob, materializeOptions)).then(async (materialized) => {
-				if (materialized) {
-					if (materialized.id !== id) await blobManager.bindRemoteId(id, materialized.id);
-					Object.assign(attachment, materialized);
-				}
-			});
-			promise.catch(() => void 0);
+/** Typed Promise boundary. Validation, staging, upload and aliases are native Replica behavior. */
+function createLiveOntologyAttachments(options) {
+	const source = (value, settings) => options.run(Effect.gen(function* () {
+		const readScope = yield* Scope.fork(options.scope);
+		return yield* Scope.provide(Effect.gen(function* () {
+			const signal = settings?.signal;
+			if (signal) {
+				yield* Effect.acquireRelease(Effect.sync(() => {
+					const abort = () => {
+						Effect.runFork(Scope.close(readScope, Exit.void));
+					};
+					signal.addEventListener("abort", abort, { once: true });
+					if (signal.aborted) abort();
+					return () => signal.removeEventListener("abort", abort);
+				}), (remove) => Effect.sync(remove));
+				if (signal.aborted) return yield* Effect.interrupt;
+			}
+			const acquired = yield* options.attachments.source(value, settings);
+			let consumed = false;
 			return {
-				attachment,
-				isMaterialized: promise
+				...acquired,
+				stream: Stream.suspend(() => {
+					if (consumed) return Stream.unwrap(Effect.tryPromise({
+						try: (signal) => source(value, { signal: settings?.signal ? AbortSignal.any([signal, settings.signal]) : signal }),
+						catch: (cause) => cause
+					}).pipe(Effect.map((fresh) => fresh.stream)));
+					consumed = true;
+					return acquired.stream.pipe(Stream.ensuring(Scope.close(readScope, Exit.void)));
+				})
 			};
-		}
-		return { attachment };
-	};
-	const blob = (attachment) => blobManager.read(attachment.id, { meta: { attachment } });
-	async function metadata(attachment, options) {
-		const selection = options?.select ?? [
-			"size",
-			"type",
-			"name"
-		];
-		const resolved = await blobManager.metadata(attachment.id, {
-			meta: { attachment },
-			select: selection
-		});
-		if (selection.includes("dimensions") && resolved.dimensions === null) throw new Error(`Dimensions are unavailable for attachment "${attachment.id}".`);
-		const { name, ...metadata } = resolved;
-		return {
-			...attachment,
-			...metadata,
-			...typeof name === "string" ? { name } : {}
-		};
-	}
+		}), readScope).pipe(Effect.onExit((exit) => Exit.isFailure(exit) ? Scope.close(readScope, exit) : Effect.void));
+	}), settings?.signal);
 	return {
-		create,
-		metadata,
-		blob
+		create: (async (input, settings) => {
+			const created = await options.run(options.attachments.create(input, settings));
+			const isMaterialized = created.isMaterialized ? options.run(created.isMaterialized) : void 0;
+			isMaterialized?.catch(() => void 0);
+			return {
+				attachment: created.attachment,
+				...isMaterialized ? { isMaterialized } : {}
+			};
+		}),
+		source,
+		blob: (value, settings) => options.run(options.attachments.blob(value), settings?.signal),
+		metadata: ((value, settings) => options.run(options.attachments.metadata(value, settings?.select ? { select: settings.select } : void 0), settings?.signal))
 	};
 }
 //#endregion

package/lib/live/attachments/createLiveOntologyAttachments.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLiveOntologyAttachments.js","names":[],"sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"sourcesContent":["import { invariant } from \"@bobbyfidz/panic\";\nimport { ImageMediaTypeOptions } from \"../../ir/generated/constants.js\";\nimport { getTargetValueType } from \"../../utils/types.js\";\nimport * as v from \"../../utils/values.js\";\nimport type { OntologyIR } from \"../../ir/index.js\";\nimport type { OntologyAttachmentCreateTarget } from \"../../utils/targets.js\";\nimport type { OntologyAttachmentsAdapter } from \"../OntologyBackendAdapter.js\";\nimport type { AttachmentMetadata, AttachmentMetadataSelection, PartialAttachmentMetadata } from \"./types.js\";\nimport type { BlobManager } from \"@party-stack/blobs\";\n\nexport interface LiveOntologyEagerAttachmentCreation {\n    attachment: v.attachment;\n    isMaterialized?: Promise<void>;\n}\n\ninterface LiveOntologyAttachmentCreateOptions {\n    /**\n     * An opaque ID to use instead of generating one.\n     */\n    id?: string;\n    target?: OntologyAttachmentCreateTarget;\n    eager?: boolean;\n}\n\ninterface AttachmentOntologyDefinition {\n    objectTypes: Record<string, Record<string, unknown>>;\n    actionTypes: Record<\n        string,\n        {\n            parameters: Record<string, unknown>;\n        }\n    >;\n}\n\ntype ExtractAttachment<Value> =\n    Value extends v.attachment<infer Type>\n        ? v.attachment<Type>\n        : NonNullable<Value> extends ReadonlyArray<infer Element>\n          ? ExtractAttachment<Element>\n          : never;\n\ntype AttachmentAtTarget<\n    Ontology extends AttachmentOntologyDefinition,\n    Target,\n> = string extends keyof Ontology[\"objectTypes\"]\n    ? v.attachment\n    : Target extends {\n            kind: \"objectProperty\";\n            objectType: infer ObjectType;\n            property: infer Property;\n        }\n      ? ObjectType extends keyof Ontology[\"objectTypes\"]\n          ? Property extends keyof Ontology[\"objectTypes\"][ObjectType]\n              ? ExtractAttachment<Ontology[\"objectTypes\"][ObjectType][Property]>\n              : never\n          : never\n      : Target extends {\n              kind: \"actionParameter\";\n              actionType: infer ActionType;\n              parameter: infer Parameter;\n          }\n        ? ActionType extends keyof Ontology[\"actionTypes\"]\n            ? Parameter extends keyof Ontology[\"actionTypes\"][ActionType][\"parameters\"]\n                ? ExtractAttachment<Ontology[\"actionTypes\"][ActionType][\"parameters\"][Parameter]>\n                : never\n            : never\n        : v.attachment;\n\ntype LiveOntologyAttachmentCreateResult<\n    Ontology extends AttachmentOntologyDefinition,\n    Options extends LiveOntologyAttachmentCreateOptions | undefined,\n> = {\n    attachment: Options extends { target: infer Target }\n        ? AttachmentAtTarget<Ontology, Target>\n        : v.attachment;\n} & (Options extends { eager: true } ? { isMaterialized?: Promise<void> } : { isMaterialized?: never });\n\nfunction satisfiesRange(value: number, range: { min?: number; max?: number }): boolean {\n    return (range.min === undefined || value >= range.min) && (range.max === undefined || value <= range.max);\n}\n\nexport interface LiveOntologyAttachments<\n    Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition,\n> {\n    create: <const Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(\n        blob: Blob | File,\n        opts?: Options\n    ) => Promise<LiveOntologyAttachmentCreateResult<Ontology, Options>>;\n    metadata: {\n        <Type extends string>(attachment: v.attachment<Type>): Promise<AttachmentMetadata<Type>>;\n        <Type extends string, const Selection extends AttachmentMetadataSelection<Type>>(\n            attachment: v.attachment<Type>,\n            options: { select: Selection }\n        ): Promise<AttachmentMetadata<Type, Selection[number]>>;\n    };\n    blob: (attachment: v.attachment) => Promise<Blob>;\n}\n\nexport function createLiveOntologyAttachments<\n    Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition,\n>(opts: {\n    ir: OntologyIR;\n    attachmentsAdapter: OntologyAttachmentsAdapter;\n    blobManager: BlobManager;\n}): LiveOntologyAttachments<Ontology> {\n    const { attachmentsAdapter, blobManager } = opts;\n\n    const create = async <const Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(\n        blob: Blob | File,\n        createOpts?: Options\n    ): Promise<LiveOntologyAttachmentCreateResult<Ontology, Options>> => {\n        const normalizedOpts: LiveOntologyAttachmentCreateOptions = createOpts ?? {};\n        const targetType = normalizedOpts.target\n            ? getTargetValueType(opts.ir, normalizedOpts.target)\n            : undefined;\n        invariant(\n            targetType === undefined || targetType.kind === \"attachment\",\n            \"Target is not an attachment.\"\n        );\n        const constraint = targetType?.kind === \"attachment\" ? targetType.value.constraint : undefined;\n        invariant(\n            !constraint?.size || satisfiesRange(blob.size, constraint.size),\n            `Attachment size ${blob.size} is outside the allowed range.`\n        );\n        const content = constraint?.content;\n        if (content?.kind === \"image\") {\n            invariant(\n                content.value.mediaTypes\n                    ? content.value.mediaTypes.some((mediaType) => mediaType === blob.type)\n                    : ImageMediaTypeOptions.some((option) => option.value === blob.type),\n                `Attachment media type \"${blob.type || \"(empty)\"}\" is not allowed by the target.`\n            );\n            // TODO: Validate image dimensions once runtimes expose a portable media-inspection capability.\n        }\n        const id =\n            normalizedOpts.id ??\n            (targetType?.kind === \"attachment\" && attachmentsAdapter.generateAttachmentId\n                ? await attachmentsAdapter.generateAttachmentId(blob, {\n                      target: targetType.value,\n                  })\n                : crypto.randomUUID());\n        await blobManager.stage(id, blob);\n        const attachment: v.attachment = {\n            id,\n            type: blob.type,\n        };\n        const materializeAttachment = attachmentsAdapter.materializeAttachment;\n        const materializeOptions = {\n            target: targetType?.kind === \"attachment\" ? targetType.value : undefined,\n        };\n        const canMaterialize =\n            materializeAttachment &&\n            (attachmentsAdapter.canMaterializeAttachment?.(attachment, materializeOptions) ?? true);\n        if (normalizedOpts.eager && canMaterialize) {\n            const promise = blobManager\n                .read(id)\n                .then((storedBlob) => materializeAttachment(attachment, storedBlob, materializeOptions))\n                .then(async (materialized) => {\n                    if (materialized) {\n                        if (materialized.id !== id) {\n                            await blobManager.bindRemoteId(id, materialized.id);\n                        }\n                        Object.assign(attachment, materialized);\n                    }\n                });\n            void promise.catch(() => undefined);\n            return {\n                attachment,\n                isMaterialized: promise,\n            } as unknown as LiveOntologyAttachmentCreateResult<Ontology, Options>;\n        }\n        return {\n            attachment,\n        } as LiveOntologyAttachmentCreateResult<Ontology, Options>;\n    };\n\n    const blob = (attachment: v.attachment) =>\n        blobManager.read(attachment.id, {\n            meta: { attachment },\n        });\n\n    async function metadata<Type extends string>(\n        attachment: v.attachment<Type>\n    ): Promise<AttachmentMetadata<Type>>;\n    async function metadata<Type extends string, const Selection extends AttachmentMetadataSelection<Type>>(\n        attachment: v.attachment<Type>,\n        options: { select: Selection }\n    ): Promise<AttachmentMetadata<Type, Selection[number]>>;\n    async function metadata<Type extends string>(\n        attachment: v.attachment<Type>,\n        options?: { select: readonly (keyof PartialAttachmentMetadata)[] }\n    ): Promise<v.attachment<Type> & PartialAttachmentMetadata<Type>> {\n        const selection = options?.select ?? [\"size\", \"type\", \"name\"];\n        const resolved = await blobManager.metadata(attachment.id, {\n            meta: { attachment },\n            select: selection,\n        });\n        if (selection.includes(\"dimensions\") && resolved.dimensions === null) {\n            throw new Error(`Dimensions are unavailable for attachment \"${attachment.id}\".`);\n        }\n        const { name, ...metadata } = resolved;\n        return {\n            ...attachment,\n            ...metadata,\n            ...(typeof name === \"string\" ? { name } : {}),\n        } as v.attachment<Type> & PartialAttachmentMetadata<Type>;\n    }\n\n    return {\n        create,\n        metadata,\n        blob,\n    };\n}\n"],"mappings":";;;;AA6EA,SAAS,eAAe,OAAe,OAAgD;CACnF,QAAQ,MAAM,QAAQ,KAAA,KAAa,SAAS,MAAM,SAAS,MAAM,QAAQ,KAAA,KAAa,SAAS,MAAM;AACzG;AAmBA,SAAgB,8BAEd,MAIoC;CAClC,MAAM,EAAE,oBAAoB,gBAAgB;CAE5C,MAAM,SAAS,OACX,MACA,eACiE;EACjE,MAAM,iBAAsD,cAAc,CAAC;EAC3E,MAAM,aAAa,eAAe,SAC5B,mBAAmB,KAAK,IAAI,eAAe,MAAM,IACjD,KAAA;EACN,UACI,eAAe,KAAA,KAAa,WAAW,SAAS,cAChD,8BACJ;EACA,MAAM,aAAa,YAAY,SAAS,eAAe,WAAW,MAAM,aAAa,KAAA;EACrF,UACI,CAAC,YAAY,QAAQ,eAAe,KAAK,MAAM,WAAW,IAAI,GAC9D,mBAAmB,KAAK,KAAK,+BACjC;EACA,MAAM,UAAU,YAAY;EAC5B,IAAI,SAAS,SAAS,SAClB,UACI,QAAQ,MAAM,aACR,QAAQ,MAAM,WAAW,MAAM,cAAc,cAAc,KAAK,IAAI,IACpE,sBAAsB,MAAM,WAAW,OAAO,UAAU,KAAK,IAAI,GACvE,0BAA0B,KAAK,QAAQ,UAAU,gCACrD;EAGJ,MAAM,KACF,eAAe,OACd,YAAY,SAAS,gBAAgB,mBAAmB,uBACnD,MAAM,mBAAmB,qBAAqB,MAAM,EAChD,QAAQ,WAAW,MACvB,CAAC,IACD,OAAO,WAAW;EAC5B,MAAM,YAAY,MAAM,IAAI,IAAI;EAChC,MAAM,aAA2B;GAC7B;GACA,MAAM,KAAK;EACf;EACA,MAAM,wBAAwB,mBAAmB;EACjD,MAAM,qBAAqB,EACvB,QAAQ,YAAY,SAAS,eAAe,WAAW,QAAQ,KAAA,EACnE;EACA,MAAM,iBACF,0BACC,mBAAmB,2BAA2B,YAAY,kBAAkB,KAAK;EACtF,IAAI,eAAe,SAAS,gBAAgB;GACxC,MAAM,UAAU,YACX,KAAK,EAAE,CAAC,CACR,MAAM,eAAe,sBAAsB,YAAY,YAAY,kBAAkB,CAAC,CAAC,CACvF,KAAK,OAAO,iBAAiB;IAC1B,IAAI,cAAc;KACd,IAAI,aAAa,OAAO,IACpB,MAAM,YAAY,aAAa,IAAI,aAAa,EAAE;KAEtD,OAAO,OAAO,YAAY,YAAY;IAC1C;GACJ,CAAC;GACL,QAAa,YAAY,KAAA,CAAS;GAClC,OAAO;IACH;IACA,gBAAgB;GACpB;EACJ;EACA,OAAO,EACH,WACJ;CACJ;CAEA,MAAM,QAAQ,eACV,YAAY,KAAK,WAAW,IAAI,EAC5B,MAAM,EAAE,WAAW,EACvB,CAAC;CASL,eAAe,SACX,YACA,SAC6D;EAC7D,MAAM,YAAY,SAAS,UAAU;GAAC;GAAQ;GAAQ;EAAM;EAC5D,MAAM,WAAW,MAAM,YAAY,SAAS,WAAW,IAAI;GACvD,MAAM,EAAE,WAAW;GACnB,QAAQ;EACZ,CAAC;EACD,IAAI,UAAU,SAAS,YAAY,KAAK,SAAS,eAAe,MAC5D,MAAM,IAAI,MAAM,8CAA8C,WAAW,GAAG,GAAG;EAEnF,MAAM,EAAE,MAAM,GAAG,aAAa;EAC9B,OAAO;GACH,GAAG;GACH,GAAG;GACH,GAAI,OAAO,SAAS,WAAW,EAAE,KAAK,IAAI,CAAC;EAC/C;CACJ;CAEA,OAAO;EACH;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"createLiveOntologyAttachments.js","names":[],"sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"sourcesContent":["import { Effect, Exit, Scope, Stream } from \"effect\";\nimport type { AttachmentMetadata, AttachmentMetadataSelection, PartialAttachmentMetadata } from \"./types.js\";\nimport type { BackendError } from \"@party-stack/ontology-backend\";\nimport type { ReplicaAttachments } from \"@party-stack/ontology-replica\";\nimport type { OntologyAttachmentCreateTarget } from \"@party-stack/ontology-spec/utils\";\nimport type * as v from \"@party-stack/ontology-spec/values\";\nimport type { ByteInput, ReadableByteInput, ByteSource } from \"@party-stack/ontology-storage/blobs\";\n\nexport interface LiveOntologyEagerAttachmentCreation {\n    attachment: v.attachment;\n    isMaterialized?: Promise<void>;\n}\n\ninterface LiveOntologyAttachmentCreateOptions {\n    /**\n     * An opaque ID to use instead of generating one.\n     */\n    id?: string;\n    target?: OntologyAttachmentCreateTarget;\n    eager?: boolean;\n}\n\ninterface AttachmentOntologyDefinition {\n    objectTypes: Record<string, Record<string, unknown>>;\n    actionTypes: Record<\n        string,\n        {\n            parameters: Record<string, unknown>;\n        }\n    >;\n}\n\ntype ExtractAttachment<Value> =\n    Value extends v.attachment<infer Type>\n        ? v.attachment<Type>\n        : NonNullable<Value> extends ReadonlyArray<infer Element>\n          ? ExtractAttachment<Element>\n          : never;\n\ntype AttachmentAtTarget<\n    Ontology extends AttachmentOntologyDefinition,\n    Target,\n> = string extends keyof Ontology[\"objectTypes\"]\n    ? v.attachment\n    : Target extends {\n            kind: \"objectProperty\";\n            objectType: infer ObjectType;\n            property: infer Property;\n        }\n      ? ObjectType extends keyof Ontology[\"objectTypes\"]\n          ? Property extends keyof Ontology[\"objectTypes\"][ObjectType]\n              ? ExtractAttachment<Ontology[\"objectTypes\"][ObjectType][Property]>\n              : never\n          : never\n      : Target extends {\n              kind: \"actionParameter\";\n              actionType: infer ActionType;\n              parameter: infer Parameter;\n          }\n        ? ActionType extends keyof Ontology[\"actionTypes\"]\n            ? Parameter extends keyof Ontology[\"actionTypes\"][ActionType][\"parameters\"]\n                ? ExtractAttachment<Ontology[\"actionTypes\"][ActionType][\"parameters\"][Parameter]>\n                : never\n            : never\n        : v.attachment;\n\ntype LiveOntologyAttachmentCreateResult<\n    Ontology extends AttachmentOntologyDefinition,\n    Options extends LiveOntologyAttachmentCreateOptions | undefined,\n> = {\n    attachment: Options extends { target: infer Target }\n        ? AttachmentAtTarget<Ontology, Target>\n        : v.attachment;\n} & (Options extends { eager: true } ? { isMaterialized?: Promise<void> } : { isMaterialized?: never });\n\nexport interface LiveOntologyAttachments<\n    Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition,\n> {\n    create: <const Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(\n        input: ByteInput | ReadableByteInput,\n        opts?: Options\n    ) => Promise<LiveOntologyAttachmentCreateResult<Ontology, Options>>;\n    metadata: {\n        <Type extends string>(\n            attachment: v.attachment<Type>,\n            options?: { readonly signal?: AbortSignal }\n        ): Promise<AttachmentMetadata<Type>>;\n        <Type extends string, const Selection extends AttachmentMetadataSelection<Type>>(\n            attachment: v.attachment<Type>,\n            options: { select: Selection; readonly signal?: AbortSignal }\n        ): Promise<AttachmentMetadata<Type, Selection[number]>>;\n    };\n    blob: (attachment: v.attachment, options?: { readonly signal?: AbortSignal }) => Promise<Blob>;\n    /** Consume or cancel the stream, or abort the signal, to release this read before the ontology closes. */\n    source: (attachment: v.attachment, options?: { readonly signal?: AbortSignal }) => Promise<ByteSource>;\n}\n\n/** Typed Promise boundary. Validation, staging, upload and aliases are native Replica behavior. */\nexport function createLiveOntologyAttachments<\n    Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition,\n>(options: {\n    readonly attachments: ReplicaAttachments;\n    readonly scope: Scope.Scope;\n    readonly run: <A>(work: Effect.Effect<A, BackendError>, signal?: AbortSignal) => Promise<A>;\n}): LiveOntologyAttachments<Ontology> {\n    const source: LiveOntologyAttachments<Ontology>[\"source\"] = (value, settings) =>\n        options.run(\n            Effect.gen(function* () {\n                const readScope = yield* Scope.fork(options.scope);\n                return yield* Scope.provide(\n                    Effect.gen(function* () {\n                        const signal = settings?.signal;\n                        if (signal) {\n                            yield* Effect.acquireRelease(\n                                Effect.sync(() => {\n                                    const abort = () => {\n                                        Effect.runFork(Scope.close(readScope, Exit.void));\n                                    };\n                                    signal.addEventListener(\"abort\", abort, { once: true });\n                                    if (signal.aborted) abort();\n                                    return () => signal.removeEventListener(\"abort\", abort);\n                                }),\n                                (remove) => Effect.sync(remove)\n                            );\n                            if (signal.aborted) return yield* Effect.interrupt;\n                        }\n                        const acquired = yield* options.attachments.source(value, settings);\n                        let consumed = false;\n                        return {\n                            ...acquired,\n                            stream: Stream.suspend(() => {\n                                if (consumed)\n                                    return Stream.unwrap(\n                                        Effect.tryPromise({\n                                            try: (signal) =>\n                                                source(value, {\n                                                    signal: settings?.signal\n                                                        ? AbortSignal.any([signal, settings.signal])\n                                                        : signal,\n                                                }),\n                                            catch: (cause) => cause,\n                                        }).pipe(Effect.map((fresh) => fresh.stream))\n                                    );\n                                consumed = true;\n                                return acquired.stream.pipe(\n                                    Stream.ensuring(Scope.close(readScope, Exit.void))\n                                );\n                            }),\n                        };\n                    }),\n                    readScope\n                ).pipe(\n                    Effect.onExit((exit) =>\n                        Exit.isFailure(exit) ? Scope.close(readScope, exit) : Effect.void\n                    )\n                );\n            }),\n            settings?.signal\n        );\n    return {\n        create: (async (input, settings) => {\n            const created = await options.run(options.attachments.create(input, settings));\n            const isMaterialized = created.isMaterialized ? options.run(created.isMaterialized) : undefined;\n            void isMaterialized?.catch(() => undefined);\n            return { attachment: created.attachment, ...(isMaterialized ? { isMaterialized } : {}) };\n        }) as LiveOntologyAttachments<Ontology>[\"create\"],\n        source,\n        blob: (value, settings) => options.run(options.attachments.blob(value), settings?.signal),\n        metadata: ((\n            value: v.attachment,\n            settings?: {\n                select?: readonly (keyof PartialAttachmentMetadata)[];\n                readonly signal?: AbortSignal;\n            }\n        ) =>\n            options.run(\n                options.attachments.metadata(\n                    value,\n                    settings?.select ? { select: settings.select } : undefined\n                ),\n                settings?.signal\n            )) as LiveOntologyAttachments<Ontology>[\"metadata\"],\n    };\n}\n"],"mappings":";;;AAkGA,SAAgB,8BAEd,SAIoC;CAClC,MAAM,UAAuD,OAAO,aAChE,QAAQ,IACJ,OAAO,IAAI,aAAa;EACpB,MAAM,YAAY,OAAO,MAAM,KAAK,QAAQ,KAAK;EACjD,OAAO,OAAO,MAAM,QAChB,OAAO,IAAI,aAAa;GACpB,MAAM,SAAS,UAAU;GACzB,IAAI,QAAQ;IACR,OAAO,OAAO,eACV,OAAO,WAAW;KACd,MAAM,cAAc;MAChB,OAAO,QAAQ,MAAM,MAAM,WAAW,KAAK,IAAI,CAAC;KACpD;KACA,OAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;KACtD,IAAI,OAAO,SAAS,MAAM;KAC1B,aAAa,OAAO,oBAAoB,SAAS,KAAK;IAC1D,CAAC,IACA,WAAW,OAAO,KAAK,MAAM,CAClC;IACA,IAAI,OAAO,SAAS,OAAO,OAAO,OAAO;GAC7C;GACA,MAAM,WAAW,OAAO,QAAQ,YAAY,OAAO,OAAO,QAAQ;GAClE,IAAI,WAAW;GACf,OAAO;IACH,GAAG;IACH,QAAQ,OAAO,cAAc;KACzB,IAAI,UACA,OAAO,OAAO,OACV,OAAO,WAAW;MACd,MAAM,WACF,OAAO,OAAO,EACV,QAAQ,UAAU,SACZ,YAAY,IAAI,CAAC,QAAQ,SAAS,MAAM,CAAC,IACzC,OACV,CAAC;MACL,QAAQ,UAAU;KACtB,CAAC,CAAC,CAAC,KAAK,OAAO,KAAK,UAAU,MAAM,MAAM,CAAC,CAC/C;KACJ,WAAW;KACX,OAAO,SAAS,OAAO,KACnB,OAAO,SAAS,MAAM,MAAM,WAAW,KAAK,IAAI,CAAC,CACrD;IACJ,CAAC;GACL;EACJ,CAAC,GACD,SACJ,CAAC,CAAC,KACE,OAAO,QAAQ,SACX,KAAK,UAAU,IAAI,IAAI,MAAM,MAAM,WAAW,IAAI,IAAI,OAAO,IACjE,CACJ;CACJ,CAAC,GACD,UAAU,MACd;CACJ,OAAO;EACH,SAAS,OAAO,OAAO,aAAa;GAChC,MAAM,UAAU,MAAM,QAAQ,IAAI,QAAQ,YAAY,OAAO,OAAO,QAAQ,CAAC;GAC7E,MAAM,iBAAiB,QAAQ,iBAAiB,QAAQ,IAAI,QAAQ,cAAc,IAAI,KAAA;GACtF,gBAAqB,YAAY,KAAA,CAAS;GAC1C,OAAO;IAAE,YAAY,QAAQ;IAAY,GAAI,iBAAiB,EAAE,eAAe,IAAI,CAAC;GAAG;EAC3F;EACA;EACA,OAAO,OAAO,aAAa,QAAQ,IAAI,QAAQ,YAAY,KAAK,KAAK,GAAG,UAAU,MAAM;EACxF,YACI,OACA,aAKA,QAAQ,IACJ,QAAQ,YAAY,SAChB,OACA,UAAU,SAAS,EAAE,QAAQ,SAAS,OAAO,IAAI,KAAA,CACrD,GACA,UAAU,MACd;CACR;AACJ"}

package/lib/live/attachments/types.d.ts

@@ -1,6 +1,6 @@
-import { attachment } from "../../utils/values.js";
-import { ImageMediaType } from "../../ir/generated/types.js";
-import { BlobDimensions } from "@party-stack/blobs";
+import { ImageMediaType } from "@party-stack/ontology-spec";
+import { attachment } from "@party-stack/ontology-spec/values";
+import { BlobDimensions } from "@party-stack/ontology-replica/attachments";
 //#region src/live/attachments/types.d.ts
 type AttachmentMetadataValues<Type extends string> = {
   size: number;
@@ -13,4 +13,5 @@ export type AttachmentMetadataSelection<Type extends string = string> = Readonly
 export type PartialAttachmentMetadata<Type extends string = string> = Partial<AttachmentMetadataValues<Type>>;
 export type AttachmentMetadata<Type extends string = string, Selected extends AttachmentMetadataField<Type> = "size" | "type" | "name"> = attachment<Type> & Pick<AttachmentMetadataValues<Type>, Selected>;
 //#endregion
+export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/live/index.d.ts

@@ -1,12 +1,12 @@
+import { OntologyApplyActionResult, OntologyAttachmentIdMapping } from "./actions/types.js";
+import { EnqueuedOntologyAction, OntologyActionRequest, OntologyOutbox, OntologyOutboxEntry, OntologyOutboxStatus } from "./outbox/types.js";
+import { LiveOntologyAction, LiveOntologyActionOptions } from "./actions/createLiveOntologyAction.js";
 import { AttachmentMetadata, PartialAttachmentMetadata } from "./attachments/types.js";
-import { ApplyActionLiveOpts, OntologyApplyActionResult, OntologyAttachmentIdMapping, OntologyAttachmentUpload, OntologyAttachmentsAdapter, OntologyBackendAdapter, OntologyBackendAdapterProvider, OntologyCollectionOptions, RunQueryLiveOpts, ValidateActionDraftLiveOpts, ValidateActionLiveOpts } from "./OntologyBackendAdapter.js";
 import { LiveOntologyAttachments } from "./attachments/createLiveOntologyAttachments.js";
-import { OntologyCollection } from "./objects/createLiveOntologyObjectCollection.js";
-import { EnqueuedOntologyAction, NonRetryableError, OntologyActionRequest, OntologyOutbox, OntologyOutboxEntry, OntologyOutboxStatus } from "./outbox/types.js";
-import { LiveOntologyAction, LiveOntologyActionOptions } from "./actions/createLiveOntologyAction.js";
-import { OntologyMutator, OntologyMutatorObjects, OntologyMutatorRegistry, OntologyMutatorTx, OntologyPropertyChange, OntologyQueryFunctionHandler, OntologyQueryFunctionRegistry, OntologyReadTx } from "./mutators/types.js";
-import { CreateLiveOntologyOpts, LiveOntology, LiveOntologyActions, LiveOntologyObjects, LiveOntologyOutboxFailureStrategy, LiveOntologyOutboxOptions, LiveOntologyQueryFunction, LiveOntologyQueryFunctions, LiveOntologyWriteMode, LiveOntologyWriteVisibility, LiveOntologyWrites, OntologyDefinition, createLiveOntology, waitForLiveOntologyReady } from "./LiveOntology.js";
-import { createReadTx } from "./mutators/createMutatorTx.js";
-import { resolveActionParameters } from "./expression.js";
-import { runOptimisticAction } from "./mutators/runOptimisticAction.js";
-export { ApplyActionLiveOpts, type AttachmentMetadata, CreateLiveOntologyOpts, EnqueuedOntologyAction, LiveOntology, type LiveOntologyAction, type LiveOntologyActionOptions, LiveOntologyActions, type LiveOntologyAttachments, LiveOntologyObjects, LiveOntologyOutboxFailureStrategy, LiveOntologyOutboxOptions, LiveOntologyQueryFunction, LiveOntologyQueryFunctions, LiveOntologyWriteMode, LiveOntologyWriteVisibility, LiveOntologyWrites, NonRetryableError, OntologyActionRequest, OntologyApplyActionResult, OntologyAttachmentIdMapping, OntologyAttachmentUpload, OntologyAttachmentsAdapter, OntologyBackendAdapter, OntologyBackendAdapterProvider, type OntologyCollection, OntologyCollectionOptions, OntologyDefinition, OntologyMutator, OntologyMutatorObjects, OntologyMutatorRegistry, OntologyMutatorTx, OntologyOutbox, OntologyOutboxEntry, OntologyOutboxStatus, OntologyPropertyChange, OntologyQueryFunctionHandler, OntologyQueryFunctionRegistry, OntologyReadTx, type PartialAttachmentMetadata, RunQueryLiveOpts, ValidateActionDraftLiveOpts, ValidateActionLiveOpts, createLiveOntology, createReadTx, resolveActionParameters, runOptimisticAction, waitForLiveOntologyReady };
+import { OntologyMutator, OntologyMutatorObjects, OntologyMutatorRegistry, OntologyMutatorTx, OntologyPropertyChange, OntologyQueryFunctionHandler, OntologyQueryFunctionRegistry, OntologyReadTx, PrepareTransactionSources } from "./mutators/types.js";
+import { OntologyCollection } from "./objects/types.js";
+import { BoundPins, NoPinInputs, OntologyPins, PinDescriptor, PinInputArgs, PinInputs, PinRecord, definePin, makeOntologyPins } from "./pins.js";
+import { CreateLiveOntologyOpts, DecryptOptions, LiveOntology, LiveOntologyActions, LiveOntologyDecrypt, LiveOntologyFactoryOptions, LiveOntologyObjects, LiveOntologyOptions, LiveOntologyOutboxFailureStrategy, LiveOntologyOutboxOptions, LiveOntologyPins, LiveOntologyQueryFunction, LiveOntologyQueryFunctions, LiveOntologyWriteVisibility, LiveOntologyWrites, OntologyDefinition, OntologyDiagnostics, PinGraph, PinOptions, PinStatus, createLiveOntology, makeLiveOntology } from "./LiveOntology.js";
+import { createReadTx } from "./mutators/createReadTx.js";
+import { StorageOntologyBackendOptions, makeStorageOntologyBackend } from "./storageBackend.js";
+export { type AttachmentMetadata, BoundPins, CreateLiveOntologyOpts, DecryptOptions, EnqueuedOntologyAction, LiveOntology, type LiveOntologyAction, type LiveOntologyActionOptions, LiveOntologyActions, type LiveOntologyAttachments, LiveOntologyDecrypt, LiveOntologyFactoryOptions, LiveOntologyObjects, LiveOntologyOptions, LiveOntologyOutboxFailureStrategy, LiveOntologyOutboxOptions, LiveOntologyPins, LiveOntologyQueryFunction, LiveOntologyQueryFunctions, LiveOntologyWriteVisibility, LiveOntologyWrites, NoPinInputs, OntologyActionRequest, type OntologyApplyActionResult, type OntologyAttachmentIdMapping, type OntologyCollection, type OntologyDefinition, OntologyDiagnostics, OntologyMutator, OntologyMutatorObjects, OntologyMutatorRegistry, OntologyMutatorTx, OntologyOutbox, OntologyOutboxEntry, OntologyOutboxStatus, OntologyPins, OntologyPropertyChange, OntologyQueryFunctionHandler, OntologyQueryFunctionRegistry, OntologyReadTx, type PartialAttachmentMetadata, PinDescriptor, type PinGraph, PinInputArgs, PinInputs, type PinOptions, type PinRecord, type PinStatus, PrepareTransactionSources, StorageOntologyBackendOptions, createLiveOntology, createReadTx, definePin, makeLiveOntology, makeOntologyPins, makeStorageOntologyBackend };

package/lib/live/index.js

@@ -1,6 +1,5 @@
-import { resolveActionParameters } from "./expression.js";
-import { createReadTx } from "./mutators/createMutatorTx.js";
-import { runOptimisticAction } from "./mutators/runOptimisticAction.js";
-import { NonRetryableError } from "./outbox/types.js";
-import { createLiveOntology, waitForLiveOntologyReady } from "./LiveOntology.js";
-export { NonRetryableError, createLiveOntology, createReadTx, resolveActionParameters, runOptimisticAction, waitForLiveOntologyReady };
+import { createReadTx } from "./mutators/createReadTx.js";
+import { definePin, makeOntologyPins } from "./pins.js";
+import { createLiveOntology, makeLiveOntology } from "./LiveOntology.js";
+import { makeStorageOntologyBackend } from "./storageBackend.js";
+export { createLiveOntology, createReadTx, definePin, makeLiveOntology, makeOntologyPins, makeStorageOntologyBackend };

package/lib/live/mutators/createReadTx.d.ts

@@ -0,0 +1,5 @@
+import { OntologyMutatorObjects, OntologyReadTx, PrepareTransactionSources } from "./types.js";
+//#region src/live/mutators/createReadTx.d.ts
+export declare function createReadTx(objects: OntologyMutatorObjects, ensureLoaded?: PrepareTransactionSources): OntologyReadTx;
+//#endregion
+//# sourceMappingURL=createReadTx.d.ts.map

package/lib/live/mutators/createReadTx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReadTx.d.ts","names":[],"sources":["../../../src/live/mutators/createReadTx.ts"],"mappings":";;wBAGgB,aACZ,SAAS,wBACT,eAAe,4BAChB"}

package/lib/live/mutators/createReadTx.js

@@ -0,0 +1,19 @@
+import { Query, queryOnce } from "@tanstack/db";
+//#region src/live/mutators/createReadTx.ts
+function createReadTx(objects, ensureLoaded) {
+	return { query: async (build) => {
+		if (!ensureLoaded) return queryOnce((query) => build(query, objects));
+		const sources = /* @__PURE__ */ new Set();
+		const tracked = new Proxy(objects, { get: (target, name) => {
+			if (typeof name === "string" && name in target) sources.add(name);
+			return Reflect.get(target, name);
+		} });
+		const plan = build(new Query(), tracked);
+		await ensureLoaded([...sources], { plan });
+		return queryOnce({ query: plan });
+	} };
+}
+//#endregion
+export { createReadTx };
+
+//# sourceMappingURL=createReadTx.js.map

package/lib/live/mutators/createReadTx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReadTx.js","names":[],"sources":["../../../src/live/mutators/createReadTx.ts"],"sourcesContent":["import { Query, queryOnce } from \"@tanstack/db\";\nimport type { OntologyMutatorObjects, OntologyReadTx, PrepareTransactionSources } from \"./types.js\";\n\nexport function createReadTx(\n    objects: OntologyMutatorObjects,\n    ensureLoaded?: PrepareTransactionSources\n): OntologyReadTx {\n    return {\n        query: async (build) => {\n            if (!ensureLoaded) return queryOnce((query) => build(query, objects) as never);\n            const sources = new Set<string>();\n            const tracked = new Proxy(objects, {\n                get: (target, name) => {\n                    if (typeof name === \"string\" && name in target) sources.add(name);\n                    return Reflect.get(target, name);\n                },\n            });\n            const plan = build(new Query(), tracked);\n            await ensureLoaded([...sources], { plan });\n            return queryOnce({ query: plan as never });\n        },\n    };\n}\n"],"mappings":";;AAGA,SAAgB,aACZ,SACA,cACc;CACd,OAAO,EACH,OAAO,OAAO,UAAU;EACpB,IAAI,CAAC,cAAc,OAAO,WAAW,UAAU,MAAM,OAAO,OAAO,CAAU;EAC7E,MAAM,0BAAU,IAAI,IAAY;EAChC,MAAM,UAAU,IAAI,MAAM,SAAS,EAC/B,MAAM,QAAQ,SAAS;GACnB,IAAI,OAAO,SAAS,YAAY,QAAQ,QAAQ,QAAQ,IAAI,IAAI;GAChE,OAAO,QAAQ,IAAI,QAAQ,IAAI;EACnC,EACJ,CAAC;EACD,MAAM,OAAO,MAAM,IAAI,MAAM,GAAG,OAAO;EACvC,MAAM,aAAa,CAAC,GAAG,OAAO,GAAG,EAAE,KAAK,CAAC;EACzC,OAAO,UAAU,EAAE,OAAO,KAAc,CAAC;CAC7C,EACJ;AACJ"}

package/lib/live/mutators/types.d.ts

@@ -1,11 +1,16 @@
-import { OntologyObject } from "../objects/OntologyObject.js";
 import { Collection, InitialQueryBuilder } from "@tanstack/db";
+import { OntologyObject } from "@party-stack/ontology-spec";
 //#region src/live/mutators/types.d.ts
 export interface OntologyPropertyChange {
   path: string[];
   value: unknown;
 }
 export type OntologyMutatorObjects = Record<string, Collection<OntologyObject>>;
+/** Prepare only the local sources required by a transaction query or keyed edit. */
+export type PrepareTransactionSources = (types: readonly string[], request?: {
+  readonly key?: string | number;
+  readonly plan?: unknown;
+}) => Promise<void>;
 export interface OntologyReadTx {
   query<T>(build: (query: InitialQueryBuilder, objects: OntologyMutatorObjects) => unknown): Promise<T>;
 }
@@ -20,7 +25,7 @@ export type OntologyMutator = (options: {
   tx: OntologyMutatorTx;
   args: Record<string, unknown>;
   context: Record<string, unknown>;
-}) => void | Promise<void>;
+}) => unknown;
 export type OntologyMutatorRegistry = Record<string, OntologyMutator>;
 export type OntologyQueryFunctionHandler = (options: {
   tx: OntologyReadTx;

package/lib/live/mutators/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/live/mutators/types.ts"],"mappings":";;;iBAGiB;EACb;EACA;;YAGQ,yBAAyB,eAAe,WAAW;iBAE9C;EACb,MAAM,GAAG,QAAQ,OAAO,qBAAqB,SAAS,qCAAqC,QAAQ;;iBAGtF,0BAA0B;EACvC,QAAQ;IAGA,OAAO,QAAQ,0BAA0B;IACzC,OACI,sBACA,SAAS,0BAA0B,2BACpC;IACH,OAAO,uBAAuB;;;YAK9B,mBAAmB;EAC3B,IAAI;EACJ,MAAM;EACN,SAAS;aACA;YAED,0BAA0B,eAAe;YAEzC,gCAAgC;EACxC,IAAI;EACJ,MAAM;EACN,SAAS;;YAGD,gCAAgC,eAAe"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/live/mutators/types.ts"],"mappings":";;;iBAGiB;EACb;EACA;;YAGQ,yBAAyB,eAAe,WAAW;;YAGnD,6BACR,0BACA;WAAqB;WAAgC;MACpD;iBAEY;EACb,MAAM,GAAG,QAAQ,OAAO,qBAAqB,SAAS,qCAAqC,QAAQ;;iBAGtF,0BAA0B;EACvC,QAAQ;IAGA,OAAO,QAAQ,0BAA0B;IACzC,OACI,sBACA,SAAS,0BAA0B,2BACpC;IACH,OAAO,uBAAuB;;;YAK9B,mBAAmB;EAC3B,IAAI;EACJ,MAAM;EACN,SAAS;;YAGD,0BAA0B,eAAe;YAEzC,gCAAgC;EACxC,IAAI;EACJ,MAAM;EACN,SAAS;;YAGD,gCAAgC,eAAe"}

package/lib/live/objects/types.d.ts

@@ -0,0 +1,6 @@
+import { Collection } from "@tanstack/db";
+import { OntologyObject } from "@party-stack/ontology-spec";
+//#region src/live/objects/types.d.ts
+export type OntologyCollection<T extends OntologyObject> = Collection<T, string | number>;
+//#endregion
+//# sourceMappingURL=types.d.ts.map

package/lib/live/objects/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/live/objects/types.ts"],"mappings":";;;YAEY,mBAAmB,UAAU,kBAAkB,WAAW"}

package/lib/live/outbox/types.d.ts

@@ -1,13 +1,12 @@
+import { ActionRequest } from "@party-stack/ontology-backend";
 import { Collection } from "@tanstack/db";
 //#region src/live/outbox/types.d.ts
-export type OntologyOutboxStatus = "queued" | "executing" | "failed";
-export declare class NonRetryableError extends Error {
-  constructor(message: string, options?: ErrorOptions);
-}
+export type OntologyOutboxStatus = import("@party-stack/ontology-backend/protocol").PendingAction["state"];
 export interface OntologyActionRequest {
   actionTypeName: string;
   parameters: Record<string, unknown>;
   idempotencyKey: string;
+  replay?: NonNullable<ActionRequest["replay"]>;
 }
 export interface OntologyOutboxEntry {
   id: string;
@@ -16,32 +15,42 @@ export interface OntologyOutboxEntry {
   visibility?: "confirmed" | "optimistic";
   status: OntologyOutboxStatus;
   createdAt: number;
-  updatedAt: number;
   attempts: number;
+  /** Forwarding retries belong to a different stage than upstream execution retries. */
+  attemptStage?: "forwarding" | "execution";
   retryable: boolean;
   nextAttemptAt: number;
-  executionId?: string;
-  lastError?: {
-    name: string;
-    message: string;
-  };
+  /** Retry may duplicate a previous remote execution unless the caller acknowledges it. */
+  retryRequiresAcknowledgement?: boolean;
+  lastError?: import("@party-stack/ontology-backend").BackendError;
 }
 export interface EnqueuedOntologyAction<Result = unknown> {
   entry: OntologyOutboxEntry;
+  /** Immediate-parent acceptance; persistence depends on that parent's storage. */
+  accepted: Promise<void>;
+  /** Upstream commitment plus local read-back/journal settlement. */
   completed: Promise<Result>;
 }
 export interface OntologyOutbox {
   readonly collection: Collection<OntologyOutboxEntry, string>;
-  readonly ready: Promise<void>;
   enqueue<Result = unknown>(request: Omit<OntologyActionRequest, "idempotencyKey"> & {
     idempotencyKey?: string;
   }, options?: {
     visibility?: "confirmed" | "optimistic";
   }): Promise<EnqueuedOntologyAction<Result>>;
-  edit(id: string, update: (request: OntologyActionRequest) => void): Promise<OntologyOutboxEntry>;
-  remove(id: string): Promise<void>;
-  retry(id: string): Promise<void>;
-  cleanup(): Promise<void>;
+  /** Resolves when the owner accepts the edit; the collection updates through replication. */
+  edit(id: string, update: (request: OntologyActionRequest) => void): Promise<void>;
+  remove(id: string, options?: {
+    allowUnknownOutcome?: boolean;
+  }): Promise<void>;
+  retry(id: string, options?: {
+    allowUnknownOutcome?: boolean;
+  }): Promise<void>;
+  /** Cancel/timeout the observation with an AbortSignal; the action remains queued. */
+  wait<Result = unknown>(id: string, options?: {
+    until?: "accepted" | "confirmed";
+    signal?: AbortSignal;
+  }): Promise<Result | void>;
 }
 //#endregion
 //# sourceMappingURL=types.d.ts.map

package/lib/live/outbox/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/live/outbox/types.ts"],"mappings":";;YAEY;qBAEC,0BAA0B;EACnC,YAAY,iBAAiB,UAAU;;iBAM1B;EACb;EACA,YAAY;EACZ;;iBAGa;EACb;EACA;EACA,SAAS;EACT;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;EACA;IACI;IACA;;;iBAIS,uBAAuB;EACpC,OAAO;EACP,WAAW,QAAQ;;iBAGN;WACJ,YAAY,WAAW;WACvB,OAAO;EAChB,QAAQ,kBACJ,SAAS,KAAK;IACV;KAEJ;IACI;MAEL,QAAQ,uBAAuB;EAClC,KAAK,YAAY,SAAS,SAAS,iCAAiC,QAAQ;EAC5E,OAAO,aAAa;EACpB,MAAM,aAAa;EACnB,WAAW"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/live/outbox/types.ts"],"mappings":";;;YAGY,wEAAwE;iBAEnE;EACb;EACA,YAAY;EACZ;EACA,SAAS,YAAY;;iBAGR;EACb;EACA;EACA,SAAS;EACT;EACA,QAAQ;EACR;EACA;;EAEA;EACA;EACA;;EAEA;EACA,oDAAoD;;iBAGvC,uBAAuB;EACpC,OAAO;;EAEP,UAAU;;EAEV,WAAW,QAAQ;;iBAGN;WACJ,YAAY,WAAW;EAChC,QAAQ,kBACJ,SAAS,KAAK;IACV;KAEJ;IACI;MAEL,QAAQ,uBAAuB;;EAElC,KAAK,YAAY,SAAS,SAAS,iCAAiC;EACpE,OAAO,YAAY;IAAY;MAAkC;EACjE,MAAM,YAAY;IAAY;MAAkC;;EAEhE,KAAK,kBACD,YACA;IACI;IACA,SAAS;MAEd,QAAQ"}

package/lib/live/outbox/types.js

@@ -1,11 +1 @@
-//#region src/live/outbox/types.ts
-var NonRetryableError = class extends Error {
-	constructor(message, options) {
-		super(message, options);
-		this.name = "NonRetryableError";
-	}
-};
-//#endregion
-export { NonRetryableError };
-
-//# sourceMappingURL=types.js.map
+export {};

package/lib/live/pins.d.ts

@@ -0,0 +1,51 @@
+import { BackendError, OntologyBackendService } from "@party-stack/ontology-backend";
+import { Runtime } from "@party-stack/runtime";
+import { Effect, Scope } from "effect";
+import { Collection, DbClient } from "@tanstack/db";
+import { QueryDocument } from "@party-stack/ontology-spec";
+import { PinRecord, PinRecord as PinRecord$1 } from "@party-stack/ontology-replica";
+//#region src/live/pins.d.ts
+export type PinInputs = Readonly<Record<string, unknown>>;
+export type NoPinInputs = Record<string, never>;
+declare const pinInputType: unique symbol;
+export interface PinDescriptor<Inputs extends PinInputs = NoPinInputs> {
+  readonly name: string;
+  readonly query: QueryDocument;
+  readonly attachments: "none" | "all";
+  readonly [pinInputType]?: Inputs;
+}
+/** Pure metadata; binding it does not request or replace a download. */
+export declare function definePin<Inputs extends PinInputs = NoPinInputs>(name: string, options: {
+  readonly query: QueryDocument;
+  readonly attachments?: "none" | "all";
+}): PinDescriptor<Inputs>;
+export type PinInputArgs<Inputs extends PinInputs> = {} extends Inputs ? [inputs?: Inputs] : [inputs: Inputs];
+export interface BoundPins<Inputs extends PinInputs> {
+  readonly collection: Collection<PinRecord$1<Inputs>>;
+  readonly id: (...args: PinInputArgs<Inputs>) => string;
+  readonly set: (...args: PinInputArgs<Inputs>) => Promise<void>;
+  readonly remove: (...args: PinInputArgs<Inputs>) => Promise<void>;
+  readonly update: (change: {
+    readonly set?: readonly Inputs[];
+    readonly remove?: readonly Inputs[];
+  }) => Promise<void>;
+  /** Remove this named family across all query revisions. */
+  readonly clear: () => Promise<void>;
+}
+export interface OntologyPins {
+  <Inputs extends PinInputs>(definition: PinDescriptor<Inputs>): BoundPins<Inputs>;
+  readonly collection: Collection<PinRecord$1, string>;
+  readonly remove: (id: string) => Promise<void>;
+  readonly clear: (name: string) => Promise<void>;
+}
+export declare const makeOntologyPins: (options: {
+  readonly backend: Effect.Effect<OntologyBackendService, BackendError, Scope.Scope>;
+  readonly dbClient: DbClient;
+}) => Effect.Effect<(<Inputs extends PinInputs>(descriptor: PinDescriptor<Inputs>) => BoundPins<Inputs>) & {
+  collection: Collection<PinRecord$1<Record<string, unknown>>, string, import("@tanstack/db").UtilsRecord, never, PinRecord$1<Record<string, unknown>>> & import("@tanstack/db").NonSingleResult;
+  remove: (id: string) => Promise<void>;
+  clear: (name: string) => Promise<void>;
+}, never, Runtime | Scope.Scope>;
+//#endregion
+export type { PinRecord };
+//# sourceMappingURL=pins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pins.d.ts","names":["PinRecord"],"sources":["../../src/live/pins.ts"],"mappings":";;;;;;;YAoBY,YAAY,SAAS;YACrB,cAAc;cACZ;iBACG,cAAc,eAAe,YAAY;WAC7C;WACA,OAAO;WACP;YACC,gBAAgB;;;wBAGd,UAAU,eAAe,YAAY,aACjD,cACA;WAAoB,OAAO;WAAwB;IACpD,cAAc;YAOL,aAAa,eAAe,wBAAwB,UAAU,SAAS,WAAW,QAAQ;iBACrF,UAAU,eAAe;WAC7B,YAAY,WAAWA,YAAU;WACjC,QAAQ,MAAM,aAAa;WAC3B,SAAS,MAAM,aAAa,YAAY;WACxC,YAAY,MAAM,aAAa,YAAY;WAC3C,SAAS;aACL,eAAe;aACf,kBAAkB;QACzB;;WAEG,aAAa;;iBAET;GACZ,eAAe,WAAW,YAAY,cAAc,UAAU,UAAU;WAChE,YAAY,WAAWA;WACvB,SAAS,eAAe;WACxB,QAAQ,iBAAiB;;qBAGzB,mBAAgB;WACP,SAAA,OAAO,OAAO,wBAAwB,cAAc,MAAM;WACzD,UAAA;MA+FL,OAAA,SAAA,eAAe,WAAS,YAAc,cAAc,YAAU,UAAU;;EA+CrE,SAAA,eAAM;EACL,QAAA,iBAAM;UAE1B,UAAA,MAAA"}