@party-stack/ontology 0.20.0 → 0.21.0

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

@@ -1 +0,0 @@
-{"version":3,"file":"createLiveOntologyActions.js","names":[],"sources":["../../../src/live/actions/createLiveOntologyActions.ts"],"sourcesContent":["import { createTransaction, type Transaction } from \"@tanstack/db\";\nimport { resolveActionParameters } from \"../expression.js\";\nimport { createReadTx } from \"../mutators/createMutatorTx.js\";\nimport { runOptimisticAction } from \"../mutators/runOptimisticAction.js\";\nimport { createOntologyOutbox, type OutboxProjection } from \"../outbox/createOntologyOutbox.js\";\nimport { createLiveOntologyAction } from \"./createLiveOntologyAction.js\";\nimport { prepareActionParameters } from \"./prepareActionParameters.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 { LiveOntologyWrites, LiveOntologyWriteVisibility } from \"../LiveOntology.js\";\nimport type { OntologyCollection } from \"../objects/createLiveOntologyObjectCollection.js\";\nimport type { OntologyObject } from \"../objects/OntologyObject.js\";\nimport type { OntologyApplyActionResult, OntologyBackendAdapter } from \"../OntologyBackendAdapter.js\";\nimport type { OntologyActionRequest, OntologyOutbox, OntologyOutboxEntry } from \"../outbox/types.js\";\nimport type {\n    LiveOntologyAction,\n    LiveOntologyActionDraftValidationOptions,\n    LiveOntologyActionOptions,\n} from \"./createLiveOntologyAction.js\";\nimport type { BlobManager } from \"@party-stack/blobs\";\nimport type { ConnectionMonitor } from \"@party-stack/connections\";\nimport type { RuntimeAdapter } from \"@party-stack/runtime\";\n\nexport interface LiveOntologyActionsSubsystem {\n    actions: Record<string, LiveOntologyAction>;\n    outbox: OntologyOutbox;\n}\n\nexport function createLiveOntologyActions(options: {\n    ir: OntologyIR;\n    backendAdapter: OntologyBackendAdapter;\n    runtime: RuntimeAdapter;\n    context: Record<string, unknown>;\n    objects: Record<string, OntologyCollection<OntologyObject>>;\n    blobManager: BlobManager;\n    writes?: LiveOntologyWrites;\n    connection?: ConnectionMonitor;\n}): LiveOntologyActionsSubsystem {\n    const defaultMode = options.writes?.defaultMode ?? \"direct\";\n    const defaultVisibility = options.writes?.defaultVisibility ?? \"confirmed\";\n\n    const executeRemote = async (\n        request: OntologyActionRequest\n    ): Promise<OntologyApplyActionResult | void> => {\n        const prepared = await prepareActionParameters({\n            ir: options.ir,\n            actionTypeName: request.actionTypeName,\n            parameters: request.parameters,\n            backendAdapter: options.backendAdapter,\n            blobManager: options.blobManager,\n        });\n        const result = await options.backendAdapter.applyAction(request.actionTypeName, prepared.parameters, {\n            objects: options.objects,\n            context: options.context,\n            attachmentUploads: prepared.attachmentUploads,\n            idempotencyKey: request.idempotencyKey,\n        });\n        const backendMappings = result?.attachmentIdMappings ?? [];\n        const attachmentIdMappings = [...prepared.attachmentIdMappings, ...backendMappings];\n        await Promise.all(\n            attachmentIdMappings.map((mapping) =>\n                options.blobManager.bindRemoteId(mapping.localId, mapping.remoteId)\n            )\n        );\n        return attachmentIdMappings.length > 0\n            ? {\n                  ...result,\n                  attachmentIdMappings,\n              }\n            : result;\n    };\n\n    const applyOptimisticAction = async (\n        transaction: Transaction,\n        request: OntologyActionRequest\n    ): Promise<boolean> => {\n        try {\n            const parameters = await resolveActionParameters({\n                ir: options.ir,\n                actionTypeName: request.actionTypeName,\n                initialParameters: request.parameters,\n                context: options.context,\n                tx: createReadTx(options.objects),\n            });\n            await runOptimisticAction({\n                transaction,\n                ir: options.ir,\n                actionTypeName: request.actionTypeName,\n                parameters,\n                context: options.context,\n                idempotencyKey: request.idempotencyKey,\n                objects: options.objects,\n                mutators: options.writes?.mutators,\n            });\n        } catch (error) {\n            if (transaction.state === \"pending\") {\n                transaction.rollback();\n            }\n            throw error;\n        }\n        return transaction.mutations.length > 0;\n    };\n\n    const project = async (entry: OntologyOutboxEntry): Promise<OutboxProjection | undefined> => {\n        const visibility = entry.visibility ?? defaultVisibility;\n        if (visibility !== \"optimistic\") return;\n\n        let resolve!: () => void;\n        let reject!: (error: Error) => void;\n        const completion = new Promise<void>((resolvePromise, rejectPromise) => {\n            resolve = resolvePromise;\n            reject = rejectPromise;\n        });\n        const transaction = createTransaction({\n            autoCommit: false,\n            mutationFn: () => completion,\n        });\n        if (!(await applyOptimisticAction(transaction, entry.request))) {\n            return;\n        }\n        void transaction.commit().catch(() => undefined);\n        void transaction.isPersisted.promise.catch(() => undefined);\n        return {\n            settle(error) {\n                if (error) reject(error);\n                else resolve();\n                return transaction.isPersisted.promise.then(\n                    () => undefined,\n                    () => undefined\n                );\n            },\n        };\n    };\n\n    const outbox = createOntologyOutbox({\n        runtime: options.runtime,\n        execute: (entry) => executeRemote(entry.request),\n        project,\n        failureStrategy: options.writes?.outbox?.failureStrategy ?? \"discard-all\",\n        maxRetries: options.writes?.outbox?.maxRetries,\n        connection: options.connection,\n    });\n\n    const executeDirect = async (\n        request: OntologyActionRequest,\n        visibility: LiveOntologyWriteVisibility\n    ): Promise<OntologyApplyActionResult | void> => {\n        if (visibility === \"confirmed\") {\n            return executeRemote(request);\n        }\n\n        let result: OntologyApplyActionResult | void = undefined;\n        const transaction = createTransaction({\n            autoCommit: false,\n            mutationFn: async () => {\n                result = await executeRemote(request);\n            },\n        });\n        if (!(await applyOptimisticAction(transaction, request))) {\n            return executeRemote(request);\n        }\n        await transaction.commit();\n        return result;\n    };\n\n    const submit = async (\n        request: OntologyActionRequest,\n        actionOptions?: LiveOntologyActionOptions\n    ): Promise<OntologyApplyActionResult | void> => {\n        const mode = actionOptions?.mode ?? defaultMode;\n        const visibility = actionOptions?.visibility ?? defaultVisibility;\n        if (visibility === \"optimistic\" && options.backendAdapter.live === false) {\n            throw new Error(\n                `Ontology backend adapter \"${options.backendAdapter.name}\" is not live and cannot reconcile optimistic actions.`\n            );\n        }\n        if (mode === \"outbox\") {\n            const enqueued = await outbox.enqueue<OntologyApplyActionResult | void>(request, { visibility });\n            return enqueued.completed;\n        }\n        return executeDirect(request, visibility);\n    };\n\n    const validate = (\n        actionTypeName: string,\n        parameters: Record<string, unknown>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>> => {\n        if (!options.backendAdapter.validateAction) {\n            return Promise.resolve({\n                certain: false,\n            });\n        }\n        return options.backendAdapter.validateAction(actionTypeName, parameters, {\n            objects: options.objects,\n            context: options.context,\n        });\n    };\n\n    const validateDraft = (\n        actionTypeName: string,\n        parameters: Record<string, unknown>,\n        validationOptions?: LiveOntologyActionDraftValidationOptions<Record<string, unknown>>\n    ): Promise<Uncertain<Result<void, readonly ValidationIssue[]>>> => {\n        if (!options.backendAdapter.validateActionDraft) {\n            return Promise.resolve({\n                certain: false,\n            });\n        }\n        return options.backendAdapter.validateActionDraft(actionTypeName, parameters, {\n            objects: options.objects,\n            context: options.context,\n            knownParameters: validationOptions?.knownParameters ?? [],\n        });\n    };\n\n    const actions = Object.fromEntries(\n        options.ir.actionTypes.map((action) => [\n            action.name,\n            createLiveOntologyAction({\n                ir: options.ir,\n                action,\n                context: options.context,\n                objects: options.objects,\n                submit,\n                validate,\n                validateDraft,\n            }),\n        ])\n    );\n\n    return {\n        actions,\n        outbox,\n    };\n}\n"],"mappings":"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"}

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

@@ -1,19 +0,0 @@
-import { OntologyIR } from "../../ir/generated/types.js";
-import "../../ir/index.js";
-import { OntologyAttachmentIdMapping, OntologyAttachmentUpload, OntologyBackendAdapter } from "../OntologyBackendAdapter.js";
-import { BlobManager } from "@party-stack/blobs";
-//#region src/live/actions/prepareActionParameters.d.ts
-export interface PreparedActionParameters {
-  parameters: Record<string, unknown>;
-  attachmentUploads: OntologyAttachmentUpload[];
-  attachmentIdMappings: OntologyAttachmentIdMapping[];
-}
-export declare function prepareActionParameters(opts: {
-  ir: OntologyIR;
-  actionTypeName: string;
-  parameters: Record<string, unknown>;
-  backendAdapter: OntologyBackendAdapter;
-  blobManager?: BlobManager;
-}): Promise<PreparedActionParameters>;
-//#endregion
-//# sourceMappingURL=prepareActionParameters.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prepareActionParameters.d.ts","names":[],"sources":["../../../src/live/actions/prepareActionParameters.ts"],"mappings":";;;;;iBA6BiB;EACb,YAAY;EACZ,mBAAmB;EACnB,sBAAsB;;wBA4RJ,wBAAwB;EAC1C,IAAI;EACJ;EACA,YAAY;EACZ,gBAAgB;EAChB,cAAc;IACd,QAAQ"}

package/lib/live/actions/prepareActionParameters.js

@@ -1,213 +0,0 @@
-import { resolveType } from "../../utils/types.js";
-import { invariant } from "@bobbyfidz/panic";
-//#region src/live/actions/prepareActionParameters.ts
-function isAttachment(value) {
-	return typeof value === "object" && value !== null && typeof value.id === "string";
-}
-function collectAttachment(opts, type, attachments) {
-	if (!isAttachment(opts.value)) return;
-	attachments.push({
-		attachment: opts.value,
-		target: type
-	});
-}
-function collectList(opts, type, attachments) {
-	if (!Array.isArray(opts.value)) return;
-	for (const value of opts.value) collectValue({
-		...opts,
-		type: type.elementType,
-		value
-	}, attachments);
-}
-function collectMap(opts, type, attachments) {
-	if (typeof opts.value !== "object" || opts.value === null) return;
-	for (const value of Object.values(opts.value)) collectValue({
-		...opts,
-		type: type.valueType,
-		value
-	}, attachments);
-}
-function collectStruct(opts, type, attachments) {
-	if (typeof opts.value !== "object" || opts.value === null) return;
-	const fieldsByName = new Map(type.fields.map((field) => [field.name, field.type]));
-	for (const [key, value] of Object.entries(opts.value)) {
-		const fieldType = fieldsByName.get(key);
-		if (!fieldType) continue;
-		collectValue({
-			...opts,
-			type: fieldType,
-			value
-		}, attachments);
-	}
-}
-function collectValue(opts, attachments) {
-	if (opts.value === void 0 || opts.value === null) return;
-	const type = resolveType(opts.ir, opts.type);
-	switch (type.kind) {
-		case "attachment":
-			collectAttachment(opts, type.value, attachments);
-			return;
-		case "optional":
-			collectValue({
-				...opts,
-				type: type.value.type
-			}, attachments);
-			return;
-		case "list":
-			collectList(opts, type.value, attachments);
-			return;
-		case "map":
-			collectMap(opts, type.value, attachments);
-			return;
-		case "struct":
-			collectStruct(opts, type.value, attachments);
-			return;
-		default: return;
-	}
-}
-function collectActionAttachments(opts) {
-	const action = opts.ir.actionTypes.find((candidate) => candidate.name === opts.actionTypeName);
-	const attachments = [];
-	for (const parameter of action.parameters) collectValue({
-		ir: opts.ir,
-		type: parameter.type,
-		value: opts.parameters[parameter.name]
-	}, attachments);
-	return [...new Map(attachments.map((entry) => [entry.attachment.id, entry])).values()];
-}
-async function collectActionAttachmentUploads(opts) {
-	if (opts.attachments.length === 0) return [];
-	const blobManager = opts.blobManager;
-	invariant(blobManager, "Missing required BlobManager for collecting attachment uploads.");
-	return Promise.all(opts.attachments.map(async (entry) => ({
-		...entry,
-		blob: await blobManager.read(entry.attachment.id)
-	})));
-}
-async function materializeValue(opts) {
-	if (opts.value === void 0 || opts.value === null) return opts.value;
-	const materializeAttachment = opts.backendAdapter.attachments?.materializeAttachment;
-	invariant(materializeAttachment, "Missing attachment materializer.");
-	const type = resolveType(opts.ir, opts.type);
-	switch (type.kind) {
-		case "attachment": {
-			if (!isAttachment(opts.value)) return opts.value;
-			const local = opts.value;
-			let pending = opts.materialized.get(local.id);
-			if (!pending) {
-				const materializeOptions = { target: type.value };
-				const canMaterialize = opts.backendAdapter.attachments?.canMaterializeAttachment?.(local, materializeOptions) ?? true;
-				pending = opts.blobManager.read(local.id).then(async (blob) => {
-					if (!canMaterialize) {
-						opts.uploads.push({
-							attachment: local,
-							target: type.value,
-							blob
-						});
-						return local;
-					}
-					return await materializeAttachment(local, blob, materializeOptions) ?? local;
-				}).then((result) => {
-					const remote = result;
-					if (remote.id !== local.id) opts.mappings.push({
-						localId: local.id,
-						remoteId: remote.id
-					});
-					return remote;
-				});
-				opts.materialized.set(local.id, pending);
-			}
-			return pending;
-		}
-		case "optional": return materializeValue({
-			...opts,
-			type: type.value.type
-		});
-		case "list":
-			if (!Array.isArray(opts.value)) return opts.value;
-			return Promise.all(opts.value.map((value) => materializeValue({
-				...opts,
-				type: type.value.elementType,
-				value
-			})));
-		case "map":
-			if (typeof opts.value !== "object" || opts.value === null || Array.isArray(opts.value)) return opts.value;
-			return Object.fromEntries(await Promise.all(Object.entries(opts.value).map(async ([key, value]) => [key, await materializeValue({
-				...opts,
-				type: type.value.valueType,
-				value
-			})])));
-		case "struct": {
-			if (typeof opts.value !== "object" || opts.value === null || Array.isArray(opts.value)) return opts.value;
-			const fields = new Map(type.value.fields.map((field) => [field.name, field.type]));
-			return Object.fromEntries(await Promise.all(Object.entries(opts.value).map(async ([key, value]) => {
-				const fieldType = fields.get(key);
-				return [key, fieldType ? await materializeValue({
-					...opts,
-					type: fieldType,
-					value
-				}) : value];
-			})));
-		}
-		default: return opts.value;
-	}
-}
-async function materializeActionParameters(opts) {
-	const action = opts.ir.actionTypes.find((candidate) => candidate.name === opts.actionTypeName);
-	const materialized = /* @__PURE__ */ new Map();
-	const attachmentIdMappings = [];
-	const attachmentUploads = [];
-	const parameters = { ...opts.parameters };
-	await Promise.all(action.parameters.map(async (parameter) => {
-		parameters[parameter.name] = await materializeValue({
-			ir: opts.ir,
-			type: parameter.type,
-			value: opts.parameters[parameter.name],
-			backendAdapter: opts.backendAdapter,
-			blobManager: opts.blobManager,
-			materialized,
-			mappings: attachmentIdMappings,
-			uploads: attachmentUploads
-		});
-	}));
-	return {
-		parameters,
-		attachmentIdMappings,
-		attachmentUploads
-	};
-}
-async function prepareActionParameters(opts) {
-	const attachments = collectActionAttachments({
-		ir: opts.ir,
-		actionTypeName: opts.actionTypeName,
-		parameters: opts.parameters
-	});
-	if (opts.backendAdapter.attachments?.materializeAttachment) {
-		const blobManager = opts.blobManager;
-		invariant(blobManager, "Missing required BlobManager for materializing attachments.");
-		const materialized = await materializeActionParameters({
-			ir: opts.ir,
-			actionTypeName: opts.actionTypeName,
-			parameters: opts.parameters,
-			backendAdapter: opts.backendAdapter,
-			blobManager
-		});
-		return {
-			parameters: materialized.parameters,
-			attachmentUploads: materialized.attachmentUploads,
-			attachmentIdMappings: materialized.attachmentIdMappings
-		};
-	}
-	return {
-		parameters: opts.parameters,
-		attachmentUploads: await collectActionAttachmentUploads({
-			attachments,
-			blobManager: opts.blobManager
-		}),
-		attachmentIdMappings: []
-	};
-}
-//#endregion
-export { prepareActionParameters };
-
-//# sourceMappingURL=prepareActionParameters.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prepareActionParameters.js","names":[],"sources":["../../../src/live/actions/prepareActionParameters.ts"],"sourcesContent":["import { invariant } from \"@bobbyfidz/panic\";\nimport { resolveType } from \"../../utils/types.js\";\nimport type {\n    AttachmentTypeDef,\n    ListTypeDef,\n    MapTypeDef,\n    OntologyIR,\n    StructTypeDef,\n    TypeDef,\n} from \"../../ir/index.js\";\nimport type { attachment } from \"../../utils/values.js\";\nimport type {\n    OntologyAttachmentIdMapping,\n    OntologyAttachmentUpload,\n    OntologyBackendAdapter,\n} from \"../OntologyBackendAdapter.js\";\nimport type { BlobManager } from \"@party-stack/blobs\";\n\ninterface MaterializeValueOptions {\n    ir: OntologyIR;\n    type: TypeDef;\n    value: unknown;\n}\n\ninterface ActionAttachment {\n    attachment: attachment;\n    target: AttachmentTypeDef;\n}\n\nexport interface PreparedActionParameters {\n    parameters: Record<string, unknown>;\n    attachmentUploads: OntologyAttachmentUpload[];\n    attachmentIdMappings: OntologyAttachmentIdMapping[];\n}\n\nfunction isAttachment(value: unknown): value is attachment {\n    return typeof value === \"object\" && value !== null && typeof (value as { id?: unknown }).id === \"string\";\n}\n\nfunction collectAttachment(\n    opts: MaterializeValueOptions,\n    type: AttachmentTypeDef,\n    attachments: ActionAttachment[]\n) {\n    if (!isAttachment(opts.value)) return;\n    attachments.push({\n        attachment: opts.value,\n        target: type,\n    });\n}\n\nfunction collectList(opts: MaterializeValueOptions, type: ListTypeDef, attachments: ActionAttachment[]) {\n    if (!Array.isArray(opts.value)) return;\n    for (const value of opts.value) {\n        collectValue(\n            {\n                ...opts,\n                type: type.elementType,\n                value,\n            },\n            attachments\n        );\n    }\n}\n\nfunction collectMap(opts: MaterializeValueOptions, type: MapTypeDef, attachments: ActionAttachment[]) {\n    if (typeof opts.value !== \"object\" || opts.value === null) return;\n    for (const value of Object.values(opts.value as Record<string, unknown>)) {\n        collectValue(\n            {\n                ...opts,\n                type: type.valueType,\n                value,\n            },\n            attachments\n        );\n    }\n}\n\nfunction collectStruct(opts: MaterializeValueOptions, type: StructTypeDef, attachments: ActionAttachment[]) {\n    if (typeof opts.value !== \"object\" || opts.value === null) return;\n    const fieldsByName = new Map(type.fields.map((field) => [field.name, field.type]));\n    for (const [key, value] of Object.entries(opts.value as Record<string, unknown>)) {\n        const fieldType = fieldsByName.get(key);\n        if (!fieldType) continue;\n        collectValue(\n            {\n                ...opts,\n                type: fieldType,\n                value,\n            },\n            attachments\n        );\n    }\n}\n\nfunction collectValue(opts: MaterializeValueOptions, attachments: ActionAttachment[]): void {\n    if (opts.value === undefined || opts.value === null) return;\n\n    const type = resolveType(opts.ir, opts.type);\n    switch (type.kind) {\n        case \"attachment\":\n            collectAttachment(opts, type.value, attachments);\n            return;\n        case \"optional\":\n            collectValue(\n                {\n                    ...opts,\n                    type: type.value.type,\n                },\n                attachments\n            );\n            return;\n        case \"list\":\n            collectList(opts, type.value, attachments);\n            return;\n        case \"map\":\n            collectMap(opts, type.value, attachments);\n            return;\n        case \"struct\":\n            collectStruct(opts, type.value, attachments);\n            return;\n        default:\n            return;\n    }\n}\n\nfunction collectActionAttachments(opts: {\n    ir: OntologyIR;\n    actionTypeName: string;\n    parameters: Record<string, unknown>;\n}): ActionAttachment[] {\n    const action = opts.ir.actionTypes.find((candidate) => candidate.name === opts.actionTypeName)!;\n    const attachments: ActionAttachment[] = [];\n    for (const parameter of action.parameters) {\n        collectValue(\n            {\n                ir: opts.ir,\n                type: parameter.type,\n                value: opts.parameters[parameter.name],\n            },\n            attachments\n        );\n    }\n    return [...new Map(attachments.map((entry) => [entry.attachment.id, entry])).values()];\n}\n\nasync function collectActionAttachmentUploads(opts: {\n    attachments: ActionAttachment[];\n    blobManager?: BlobManager;\n}): Promise<OntologyAttachmentUpload[]> {\n    if (opts.attachments.length === 0) return [];\n    const blobManager = opts.blobManager;\n    invariant(blobManager, \"Missing required BlobManager for collecting attachment uploads.\");\n    return Promise.all(\n        opts.attachments.map(async (entry) => ({\n            ...entry,\n            blob: await blobManager.read(entry.attachment.id),\n        }))\n    );\n}\n\nasync function materializeValue(opts: {\n    ir: OntologyIR;\n    type: TypeDef;\n    value: unknown;\n    backendAdapter: OntologyBackendAdapter;\n    blobManager: BlobManager;\n    materialized: Map<string, Promise<attachment>>;\n    mappings: OntologyAttachmentIdMapping[];\n    uploads: OntologyAttachmentUpload[];\n}): Promise<unknown> {\n    if (opts.value === undefined || opts.value === null) {\n        return opts.value;\n    }\n    const materializeAttachment = opts.backendAdapter.attachments?.materializeAttachment;\n    invariant(materializeAttachment, \"Missing attachment materializer.\");\n    const type = resolveType(opts.ir, opts.type);\n    switch (type.kind) {\n        case \"attachment\": {\n            if (!isAttachment(opts.value)) return opts.value;\n            const local = opts.value;\n            let pending = opts.materialized.get(local.id);\n            if (!pending) {\n                const materializeOptions = {\n                    target: type.value,\n                };\n                const canMaterialize =\n                    opts.backendAdapter.attachments?.canMaterializeAttachment?.(local, materializeOptions) ??\n                    true;\n                pending = opts.blobManager\n                    .read(local.id)\n                    .then(async (blob) => {\n                        if (!canMaterialize) {\n                            opts.uploads.push({\n                                attachment: local,\n                                target: type.value,\n                                blob,\n                            });\n                            return local;\n                        }\n                        return (await materializeAttachment(local, blob, materializeOptions)) ?? local;\n                    })\n                    .then((result) => {\n                        const remote = result;\n                        if (remote.id !== local.id) {\n                            opts.mappings.push({\n                                localId: local.id,\n                                remoteId: remote.id,\n                            });\n                        }\n                        return remote;\n                    });\n                opts.materialized.set(local.id, pending);\n            }\n            return pending;\n        }\n        case \"optional\":\n            return materializeValue({\n                ...opts,\n                type: type.value.type,\n            });\n        case \"list\":\n            if (!Array.isArray(opts.value)) return opts.value;\n            return Promise.all(\n                opts.value.map((value) =>\n                    materializeValue({\n                        ...opts,\n                        type: type.value.elementType,\n                        value,\n                    })\n                )\n            );\n        case \"map\":\n            if (typeof opts.value !== \"object\" || opts.value === null || Array.isArray(opts.value)) {\n                return opts.value;\n            }\n            return Object.fromEntries(\n                await Promise.all(\n                    Object.entries(opts.value as Record<string, unknown>).map(async ([key, value]) => [\n                        key,\n                        await materializeValue({\n                            ...opts,\n                            type: type.value.valueType,\n                            value,\n                        }),\n                    ])\n                )\n            );\n        case \"struct\": {\n            if (typeof opts.value !== \"object\" || opts.value === null || Array.isArray(opts.value)) {\n                return opts.value;\n            }\n            const fields = new Map(type.value.fields.map((field) => [field.name, field.type]));\n            return Object.fromEntries(\n                await Promise.all(\n                    Object.entries(opts.value as Record<string, unknown>).map(async ([key, value]) => {\n                        const fieldType = fields.get(key);\n                        return [\n                            key,\n                            fieldType\n                                ? await materializeValue({\n                                      ...opts,\n                                      type: fieldType,\n                                      value,\n                                  })\n                                : value,\n                        ];\n                    })\n                )\n            );\n        }\n        default:\n            return opts.value;\n    }\n}\n\nasync function materializeActionParameters(opts: {\n    ir: OntologyIR;\n    actionTypeName: string;\n    parameters: Record<string, unknown>;\n    backendAdapter: OntologyBackendAdapter;\n    blobManager: BlobManager;\n}): Promise<{\n    parameters: Record<string, unknown>;\n    attachmentIdMappings: OntologyAttachmentIdMapping[];\n    attachmentUploads: OntologyAttachmentUpload[];\n}> {\n    const action = opts.ir.actionTypes.find((candidate) => candidate.name === opts.actionTypeName)!;\n    const materialized = new Map<string, Promise<attachment>>();\n    const attachmentIdMappings: OntologyAttachmentIdMapping[] = [];\n    const attachmentUploads: OntologyAttachmentUpload[] = [];\n    const parameters: Record<string, unknown> = {\n        ...opts.parameters,\n    };\n    await Promise.all(\n        action.parameters.map(async (parameter) => {\n            parameters[parameter.name] = await materializeValue({\n                ir: opts.ir,\n                type: parameter.type,\n                value: opts.parameters[parameter.name],\n                backendAdapter: opts.backendAdapter,\n                blobManager: opts.blobManager,\n                materialized,\n                mappings: attachmentIdMappings,\n                uploads: attachmentUploads,\n            });\n        })\n    );\n    return {\n        parameters,\n        attachmentIdMappings,\n        attachmentUploads,\n    };\n}\n\nexport async function prepareActionParameters(opts: {\n    ir: OntologyIR;\n    actionTypeName: string;\n    parameters: Record<string, unknown>;\n    backendAdapter: OntologyBackendAdapter;\n    blobManager?: BlobManager;\n}): Promise<PreparedActionParameters> {\n    const attachments = collectActionAttachments({\n        ir: opts.ir,\n        actionTypeName: opts.actionTypeName,\n        parameters: opts.parameters,\n    });\n    if (opts.backendAdapter.attachments?.materializeAttachment) {\n        const blobManager = opts.blobManager;\n        invariant(blobManager, \"Missing required BlobManager for materializing attachments.\");\n        const materialized = await materializeActionParameters({\n            ir: opts.ir,\n            actionTypeName: opts.actionTypeName,\n            parameters: opts.parameters,\n            backendAdapter: opts.backendAdapter,\n            blobManager,\n        });\n        return {\n            parameters: materialized.parameters,\n            attachmentUploads: materialized.attachmentUploads,\n            attachmentIdMappings: materialized.attachmentIdMappings,\n        };\n    }\n    return {\n        parameters: opts.parameters,\n        attachmentUploads: await collectActionAttachmentUploads({\n            attachments,\n            blobManager: opts.blobManager,\n        }),\n        attachmentIdMappings: [],\n    };\n}\n"],"mappings":"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"}

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

@@ -1,10 +0,0 @@
-import { ObjectTypeDef, OntologyIR } from "../../ir/generated/types.js";
-import "../../ir/index.js";
-//#region src/live/attachments/attachmentSources.d.ts
-export declare function decorateObjectAttachmentSources(opts: {
-  ir: OntologyIR;
-  objectType: ObjectTypeDef;
-  object: Record<string, unknown>;
-}): Record<string, unknown>;
-//#endregion
-//# sourceMappingURL=attachmentSources.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"attachmentSources.d.ts","names":[],"sources":["../../../src/live/attachments/attachmentSources.ts"],"mappings":";;;wBAuEgB,gCAAgC;EAC5C,IAAI;EACJ,YAAY;EACZ,QAAQ;IACR"}

package/lib/live/attachments/attachmentSources.js

@@ -1,64 +0,0 @@
-import { resolveType } from "../../utils/types.js";
-//#region src/live/attachments/attachmentSources.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function isAttachment(value) {
-	return isRecord(value) && typeof value.id === "string";
-}
-function decorateAttachmentValue(opts) {
-	if (opts.value === void 0 || opts.value === null) return;
-	const type = resolveType(opts.ir, opts.type);
-	switch (type.kind) {
-		case "attachment":
-			if (isAttachment(opts.value)) opts.value.source = opts.source;
-			return;
-		case "optional":
-			decorateAttachmentValue({
-				...opts,
-				type: type.value.type
-			});
-			return;
-		case "list":
-			if (Array.isArray(opts.value)) for (const item of opts.value) decorateAttachmentValue({
-				...opts,
-				type: type.value.elementType,
-				value: item
-			});
-			return;
-		case "map":
-			if (isRecord(opts.value)) for (const item of Object.values(opts.value)) decorateAttachmentValue({
-				...opts,
-				type: type.value.valueType,
-				value: item
-			});
-			return;
-		case "struct":
-			if (isRecord(opts.value)) for (const field of type.value.fields) decorateAttachmentValue({
-				...opts,
-				type: field.type,
-				value: opts.value[field.name]
-			});
-			return;
-		default: return;
-	}
-}
-function decorateObjectAttachmentSources(opts) {
-	const primaryKey = opts.object[opts.objectType.primaryKey];
-	if (typeof primaryKey !== "string" && typeof primaryKey !== "number") return opts.object;
-	for (const property of opts.objectType.properties) decorateAttachmentValue({
-		ir: opts.ir,
-		type: property.type,
-		value: opts.object[property.name],
-		source: {
-			objectType: opts.objectType.name,
-			primaryKey,
-			property: property.name
-		}
-	});
-	return opts.object;
-}
-//#endregion
-export { decorateObjectAttachmentSources };
-
-//# sourceMappingURL=attachmentSources.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"attachmentSources.js","names":[],"sources":["../../../src/live/attachments/attachmentSources.ts"],"sourcesContent":["import { resolveType } from \"../../utils/types.js\";\nimport type { ObjectTypeDef, OntologyIR, TypeDef } from \"../../ir/index.js\";\nimport type { attachment } from \"../../utils/values.js\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null;\n}\n\nfunction isAttachment(value: unknown): value is attachment {\n    return isRecord(value) && typeof value.id === \"string\";\n}\n\nfunction decorateAttachmentValue(opts: {\n    ir: OntologyIR;\n    type: TypeDef;\n    value: unknown;\n    source: NonNullable<attachment[\"source\"]>;\n}) {\n    if (opts.value === undefined || opts.value === null) return;\n\n    const type = resolveType(opts.ir, opts.type);\n    switch (type.kind) {\n        case \"attachment\":\n            if (isAttachment(opts.value)) {\n                opts.value.source = opts.source;\n            }\n            return;\n        case \"optional\":\n            decorateAttachmentValue({\n                ...opts,\n                type: type.value.type,\n            });\n            return;\n        case \"list\":\n            if (Array.isArray(opts.value)) {\n                for (const item of opts.value) {\n                    decorateAttachmentValue({\n                        ...opts,\n                        type: type.value.elementType,\n                        value: item,\n                    });\n                }\n            }\n            return;\n        case \"map\":\n            if (isRecord(opts.value)) {\n                for (const item of Object.values(opts.value)) {\n                    decorateAttachmentValue({\n                        ...opts,\n                        type: type.value.valueType,\n                        value: item,\n                    });\n                }\n            }\n            return;\n        case \"struct\":\n            if (isRecord(opts.value)) {\n                for (const field of type.value.fields) {\n                    decorateAttachmentValue({\n                        ...opts,\n                        type: field.type,\n                        value: opts.value[field.name],\n                    });\n                }\n            }\n            return;\n        default:\n            return;\n    }\n}\n\nexport function decorateObjectAttachmentSources(opts: {\n    ir: OntologyIR;\n    objectType: ObjectTypeDef;\n    object: Record<string, unknown>;\n}): Record<string, unknown> {\n    const primaryKey = opts.object[opts.objectType.primaryKey];\n    if (typeof primaryKey !== \"string\" && typeof primaryKey !== \"number\") {\n        return opts.object;\n    }\n\n    for (const property of opts.objectType.properties) {\n        decorateAttachmentValue({\n            ir: opts.ir,\n            type: property.type,\n            value: opts.object[property.name],\n            source: {\n                objectType: opts.objectType.name,\n                primaryKey,\n                property: property.name,\n            },\n        });\n    }\n\n    return opts.object;\n}\n"],"mappings":";;AAIA,SAAS,SAAS,OAAkD;CAChE,OAAO,OAAO,UAAU,YAAY,UAAU;AAClD;AAEA,SAAS,aAAa,OAAqC;CACvD,OAAO,SAAS,KAAK,KAAK,OAAO,MAAM,OAAO;AAClD;AAEA,SAAS,wBAAwB,MAK9B;CACC,IAAI,KAAK,UAAU,KAAA,KAAa,KAAK,UAAU,MAAM;CAErD,MAAM,OAAO,YAAY,KAAK,IAAI,KAAK,IAAI;CAC3C,QAAQ,KAAK,MAAb;EACI,KAAK;GACD,IAAI,aAAa,KAAK,KAAK,GACvB,KAAK,MAAM,SAAS,KAAK;GAE7B;EACJ,KAAK;GACD,wBAAwB;IACpB,GAAG;IACH,MAAM,KAAK,MAAM;GACrB,CAAC;GACD;EACJ,KAAK;GACD,IAAI,MAAM,QAAQ,KAAK,KAAK,GACxB,KAAK,MAAM,QAAQ,KAAK,OACpB,wBAAwB;IACpB,GAAG;IACH,MAAM,KAAK,MAAM;IACjB,OAAO;GACX,CAAC;GAGT;EACJ,KAAK;GACD,IAAI,SAAS,KAAK,KAAK,GACnB,KAAK,MAAM,QAAQ,OAAO,OAAO,KAAK,KAAK,GACvC,wBAAwB;IACpB,GAAG;IACH,MAAM,KAAK,MAAM;IACjB,OAAO;GACX,CAAC;GAGT;EACJ,KAAK;GACD,IAAI,SAAS,KAAK,KAAK,GACnB,KAAK,MAAM,SAAS,KAAK,MAAM,QAC3B,wBAAwB;IACpB,GAAG;IACH,MAAM,MAAM;IACZ,OAAO,KAAK,MAAM,MAAM;GAC5B,CAAC;GAGT;EACJ,SACI;CACR;AACJ;AAEA,SAAgB,gCAAgC,MAIpB;CACxB,MAAM,aAAa,KAAK,OAAO,KAAK,WAAW;CAC/C,IAAI,OAAO,eAAe,YAAY,OAAO,eAAe,UACxD,OAAO,KAAK;CAGhB,KAAK,MAAM,YAAY,KAAK,WAAW,YACnC,wBAAwB;EACpB,IAAI,KAAK;EACT,MAAM,SAAS;EACf,OAAO,KAAK,OAAO,SAAS;EAC5B,QAAQ;GACJ,YAAY,KAAK,WAAW;GAC5B;GACA,UAAU,SAAS;EACvB;CACJ,CAAC;CAGL,OAAO,KAAK;AAChB"}

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

@@ -1,5 +0,0 @@
-import { OntologyAttachmentsAdapter } from "../OntologyBackendAdapter.js";
-//#region src/live/attachments/unsupportedOntologyAttachmentsAdapter.d.ts
-export declare const unsupportedOntologyAttachmentsAdapter: OntologyAttachmentsAdapter;
-//#endregion
-//# sourceMappingURL=unsupportedOntologyAttachmentsAdapter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"unsupportedOntologyAttachmentsAdapter.d.ts","names":[],"sources":["../../../src/live/attachments/unsupportedOntologyAttachmentsAdapter.ts"],"mappings":";;qBAEa,uCAAuC"}

package/lib/live/attachments/unsupportedOntologyAttachmentsAdapter.js

@@ -1,6 +0,0 @@
-//#region src/live/attachments/unsupportedOntologyAttachmentsAdapter.ts
-const unsupportedOntologyAttachmentsAdapter = { getAttachmentContent: (attachment) => Promise.reject(/* @__PURE__ */ new Error(`Ontology adapter cannot read attachment content for "${attachment.id}".`)) };
-//#endregion
-export { unsupportedOntologyAttachmentsAdapter };
-
-//# sourceMappingURL=unsupportedOntologyAttachmentsAdapter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"unsupportedOntologyAttachmentsAdapter.js","names":[],"sources":["../../../src/live/attachments/unsupportedOntologyAttachmentsAdapter.ts"],"sourcesContent":["import type { OntologyAttachmentsAdapter } from \"../OntologyBackendAdapter.js\";\n\nexport const unsupportedOntologyAttachmentsAdapter: OntologyAttachmentsAdapter = {\n    getAttachmentContent: (attachment) =>\n        Promise.reject(new Error(`Ontology adapter cannot read attachment content for \"${attachment.id}\".`)),\n};\n"],"mappings":";AAEA,MAAa,wCAAoE,EAC7E,uBAAuB,eACnB,QAAQ,uBAAO,IAAI,MAAM,wDAAwD,WAAW,GAAG,GAAG,CAAC,EAC3G"}

package/lib/live/expression.d.ts

@@ -1,24 +0,0 @@
-import { Expression, InputReferenceExpression, ObjectTypeDef, OntologyIR } from "../ir/generated/types.js";
-import "../ir/index.js";
-import { OntologyReadTx } from "./mutators/types.js";
-//#region src/live/expression.d.ts
-interface EvaluateExpressionOptions {
-  ir: OntologyIR;
-  actionTypeName: string;
-  expression: Expression;
-  resolveParameter: (parameterName: string) => Promise<unknown>;
-  context: Record<string, unknown>;
-  tx: OntologyReadTx;
-}
-export declare function evaluateExpression(options: EvaluateExpressionOptions): Promise<unknown>;
-export declare function resolveActionParameters(options: {
-  ir: OntologyIR;
-  actionTypeName: string;
-  initialParameters: Record<string, unknown>;
-  context: Record<string, unknown>;
-  tx: OntologyReadTx;
-}): Promise<Record<string, unknown>>;
-export declare function getObjectReferenceObjectType(ir: OntologyIR, actionTypeName: string, reference: InputReferenceExpression): ObjectTypeDef;
-//#endregion
-export {};
-//# sourceMappingURL=expression.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"expression.d.ts","names":[],"sources":["../../src/live/expression.ts"],"mappings":";;;;UAmBU;EACN,IAAI;EACJ;EACA,YAAY;EACZ,mBAAmB,0BAA0B;EAC7C,SAAS;EACT,IAAI;;wBAuCc,mBAAmB,SAAS,4BAA4B;wBA6MxD,wBAAwB;EAC1C,IAAI;EACJ;EACA,mBAAmB;EACnB,SAAS;EACT,IAAI;IACJ,QAAQ;wBAwCI,6BACZ,IAAI,YACJ,wBACA,WAAW,2BACZ"}

package/lib/live/expression.js

@@ -1,160 +0,0 @@
-import { isLinkHopFromForeignKeySource, resolveLinkHop } from "../utils/links.js";
-import { resolveType, unwrapType } from "../utils/types.js";
-import { getAtPath } from "../utils/paths.js";
-import { eq } from "@tanstack/db";
-import { Temporal } from "temporal-polyfill";
-//#region src/live/expression.ts
-function getActionType(ir, actionTypeName) {
-	return ir.actionTypes.find((actionType) => actionType.name === actionTypeName);
-}
-const ontologyReference = Symbol("ontologyReference");
-const ontologyObject = Symbol("ontologyObject");
-function isEvaluatedObjectReference(value) {
-	return typeof value === "object" && value !== null && ontologyReference in value;
-}
-function isEvaluatedOntologyObject(value) {
-	return typeof value === "object" && value !== null && ontologyObject in value;
-}
-function unwrapEvaluatedValue(value) {
-	if (isEvaluatedObjectReference(value)) return value.key;
-	if (isEvaluatedOntologyObject(value)) return value.value;
-	if (Array.isArray(value)) return value.map(unwrapEvaluatedValue);
-	if (value !== null && typeof value === "object" && Object.getPrototypeOf(value) === Object.prototype) return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, unwrapEvaluatedValue(entry)]));
-	return value;
-}
-async function evaluateExpression(options) {
-	return unwrapEvaluatedValue(await evaluateExpressionWithLocals(options, /* @__PURE__ */ new Map()));
-}
-async function evaluateExpressionWithLocals(options, locals) {
-	const { ir, actionTypeName, expression, resolveParameter, context, tx } = options;
-	switch (expression.kind) {
-		case "inputReference": {
-			const parameterValue = await resolveParameter(expression.value.name);
-			const parameter = getActionType(ir, actionTypeName).parameters.find((candidate) => candidate.name === expression.value.name);
-			const { type: parameterType, isOptional } = unwrapType(resolveType(ir, parameter.type));
-			if (parameterType.kind === "objectReference") return {
-				[ontologyReference]: true,
-				objectType: parameterType.value.objectType,
-				key: parameterValue,
-				optional: isOptional
-			};
-			return parameterValue;
-		}
-		case "localReference": {
-			const { name } = expression.value;
-			if (!locals.has(name)) throw new Error(`Unknown expression binding "${name}".`);
-			return locals.get(name);
-		}
-		case "contextReference": return context[expression.value.name];
-		case "getAt": {
-			const source = await evaluateExpressionWithLocals({
-				...options,
-				expression: expression.value.source
-			}, locals);
-			if (isEvaluatedObjectReference(source)) throw new Error(`Cannot access field "${expression.value.path.join(".")}" on an object reference without an object lookup.`);
-			return getAtPath(isEvaluatedOntologyObject(source) ? source.value : source, expression.value.path);
-		}
-		case "objectLookup": {
-			const reference = await evaluateExpressionWithLocals({
-				...options,
-				expression: expression.value.reference
-			}, locals);
-			if (!isEvaluatedObjectReference(reference)) throw new Error("Object lookup source must resolve to an object reference.");
-			if (reference.key === void 0 || reference.key === null) return;
-			const referencedType = ir.objectTypes.find((candidate) => candidate.name === reference.objectType);
-			const referencedObject = await tx.query((query, objects) => query.from({ object: objects[referencedType.name] }).where(({ object }) => eq(object[referencedType.primaryKey], reference.key)).select(({ object }) => object).findOne());
-			if (!referencedObject && !reference.optional) throw new Error(`Missing loaded "${referencedType.name}" object.`);
-			return referencedObject ? {
-				[ontologyObject]: true,
-				objectType: referencedType.name,
-				value: referencedObject
-			} : void 0;
-		}
-		case "linkHop": {
-			const source = await evaluateExpressionWithLocals({
-				...options,
-				expression: expression.value.source
-			}, locals);
-			if (!isEvaluatedOntologyObject(source)) throw new Error("Link hop source must resolve to an ontology object.");
-			const link = resolveLinkHop(ir, source.objectType, expression.value.link);
-			if (!link) throw new Error(`Unknown link "${expression.value.link}" on object type "${source.objectType}".`);
-			const foreignKeyOnSource = isLinkHopFromForeignKeySource(link, source.objectType, expression.value.link);
-			if ((foreignKeyOnSource ? "one" : link.cardinality) === "many") throw new Error(`Link "${expression.value.link}" on object type "${source.objectType}" is to-many.`);
-			const sourceType = ir.objectTypes.find((candidate) => candidate.name === source.objectType);
-			const targetType = ir.objectTypes.find((candidate) => candidate.name === (foreignKeyOnSource ? link.target.objectType : link.source.objectType));
-			const foreignKeyPath = link.foreignKey.split(".");
-			const sourceKey = foreignKeyOnSource ? getAtPath(source.value, foreignKeyPath) : source.value[sourceType.primaryKey];
-			if (sourceKey === void 0 || sourceKey === null) return;
-			const targetProperty = foreignKeyOnSource ? targetType.primaryKey : link.foreignKey;
-			const linkedObject = await tx.query((query, objects) => query.from({ object: objects[targetType.name] }).where(({ object }) => eq(object[targetProperty], sourceKey)).select(({ object }) => object).findOne());
-			return linkedObject ? {
-				[ontologyObject]: true,
-				objectType: targetType.name,
-				value: linkedObject
-			} : void 0;
-		}
-		case "struct": {
-			const fields = await Promise.all(expression.value.fields.map(async (field) => [field.name, await evaluateExpressionWithLocals({
-				...options,
-				expression: field.value
-			}, locals)]));
-			return Object.fromEntries(fields);
-		}
-		case "map": {
-			const source = await evaluateExpressionWithLocals({
-				...options,
-				expression: expression.value.source
-			}, locals);
-			if (source === void 0) return;
-			if (!Array.isArray(source)) throw new Error("Map expression source must resolve to a list.");
-			return Promise.all(source.map((item) => {
-				const itemLocals = new Map(locals);
-				itemLocals.set(expression.value.binding, item);
-				return evaluateExpressionWithLocals({
-					...options,
-					expression: expression.value.body
-				}, itemLocals);
-			}));
-		}
-		case "literal": return expression.value.value;
-		case "uuid": return globalThis.crypto.randomUUID();
-		case "now": return Temporal.Now.instant();
-	}
-}
-async function resolveActionParameters(options) {
-	const action = getActionType(options.ir, options.actionTypeName);
-	const resolvedParameters = { ...options.initialParameters };
-	const parametersByName = new Map(action.parameters.map((parameter) => [parameter.name, parameter]));
-	const resolving = /* @__PURE__ */ new Set();
-	const resolveParameter = async (parameterName) => {
-		if (resolvedParameters[parameterName] !== void 0) return resolvedParameters[parameterName];
-		const parameter = parametersByName.get(parameterName);
-		if (!parameter?.defaultValue) return void 0;
-		if (resolving.has(parameterName)) throw new Error(`Circular action parameter default for "${parameterName}".`);
-		resolving.add(parameterName);
-		try {
-			resolvedParameters[parameterName] = await evaluateExpression({
-				ir: options.ir,
-				actionTypeName: options.actionTypeName,
-				expression: parameter.defaultValue,
-				resolveParameter,
-				context: options.context,
-				tx: options.tx
-			});
-			return resolvedParameters[parameterName];
-		} finally {
-			resolving.delete(parameterName);
-		}
-	};
-	for (const parameter of action.parameters) await resolveParameter(parameter.name);
-	return resolvedParameters;
-}
-function getObjectReferenceObjectType(ir, actionTypeName, reference) {
-	const parameter = getActionType(ir, actionTypeName).parameters.find((candidate) => candidate.name === reference.name);
-	const resolvedType = unwrapType(resolveType(ir, parameter.type)).type;
-	return ir.objectTypes.find((candidate) => candidate.name === resolvedType.value.objectType);
-}
-//#endregion
-export { evaluateExpression, getObjectReferenceObjectType, resolveActionParameters };
-
-//# sourceMappingURL=expression.js.map