@party-stack/ontology 0.3.0 → 0.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"unsupportedOntologyAttachmentsAdapter.d.ts","sourceRoot":"","sources":["../../../src/live/attachments/unsupportedOntologyAttachmentsAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,eAAO,MAAM,qCAAqC,EAAE,0BAKnD,CAAC"}

package/lib/live/attachments/unsupportedOntologyAttachmentsAdapter.js

@@ -0,0 +1,5 @@
+export const unsupportedOntologyAttachmentsAdapter = {
+    getAttachmentContent: (attachment) => Promise.reject(new Error(`Ontology adapter cannot read attachment content for "${attachment.id}".`)),
+    getAttachmentMetadata: (attachment) => Promise.reject(new Error(`Ontology adapter cannot read attachment metadata for "${attachment.id}".`)),
+};
+//# sourceMappingURL=unsupportedOntologyAttachmentsAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unsupportedOntologyAttachmentsAdapter.js","sourceRoot":"","sources":["../../../src/live/attachments/unsupportedOntologyAttachmentsAdapter.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qCAAqC,GAA+B;IAC7E,oBAAoB,EAAE,CAAC,UAAU,EAAE,EAAE,CACjC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wDAAwD,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IACxG,qBAAqB,EAAE,CAAC,UAAU,EAAE,EAAE,CAClC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yDAAyD,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;CAC5G,CAAC"}

package/lib/live/expression.d.ts

@@ -1,6 +1,19 @@
-import type { OntologyCollection, OntologyObject } from "./LiveOntology.js";
+import type { OntologyReadTx } from "./mutators/types.js";
 import type { Expression, ObjectTypeDef, OntologyIR, ValueReferenceExpression } from "../ir/index.js";
-export declare function evaluateExpression(ir: OntologyIR, actionTypeName: string, expression: Expression, resolveParameter: (parameterName: string) => unknown, context: Record<string, unknown>, objects: Record<string, OntologyCollection<OntologyObject>>): unknown;
-export declare function resolveActionParameters(ir: OntologyIR, actionTypeName: string, initialParameters: Record<string, unknown>, context: Record<string, unknown>, objects: Record<string, OntologyCollection<OntologyObject>>): Record<string, unknown>;
+export declare function evaluateExpression(options: {
+    ir: OntologyIR;
+    actionTypeName: string;
+    expression: Expression;
+    resolveParameter: (parameterName: string) => Promise<unknown>;
+    context: Record<string, unknown>;
+    tx: OntologyReadTx;
+}): 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: ValueReferenceExpression): ObjectTypeDef;
 //# sourceMappingURL=expression.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/live/expression.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EACR,UAAU,EACV,aAAa,EACb,UAAU,EAEV,wBAAwB,EAC3B,MAAM,gBAAgB,CAAC;AAaxB,wBAAgB,kBAAkB,CAC9B,EAAE,EAAE,UAAU,EACd,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,EACpD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC,GAC5D,OAAO,CA8CT;AAED,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,UAAU,EACd,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC,GAC5D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCzB;AAED,wBAAgB,4BAA4B,CACxC,EAAE,EAAE,UAAU,EACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,wBAAwB,GACpC,aAAa,CAQf"}
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/live/expression.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EACR,UAAU,EACV,aAAa,EACb,UAAU,EAEV,wBAAwB,EAC3B,MAAM,gBAAgB,CAAC;AAWxB,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAC9C,EAAE,EAAE,UAAU,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,CACd,aAAa,EAAE,MAAM,KACpB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,EAAE,cAAc,CAAC;CACtB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwEnB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACnD,EAAE,EAAE,UAAU,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,EAAE,cAAc,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmDnC;AAED,wBAAgB,4BAA4B,CACxC,EAAE,EAAE,UAAU,EACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,wBAAwB,GACpC,aAAa,CAaf"}

package/lib/live/expression.js

@@ -1,81 +1,94 @@
+import { eq } from "@tanstack/db";
 import { get } from "lodash-es";
 import { Temporal } from "temporal-polyfill";
-import { resolveType } from "../utils/types.js";
+import { resolveType, unwrapType } from "../utils/types.js";
 function getActionType(ir, actionTypeName) {
     return ir.actionTypes.find((actionType) => actionType.name === actionTypeName);
 }
-function unwrapType(type) {
-    if (type.kind === "optional") {
-        return { type: type.value.type, isOptional: true };
-    }
-    return { type, isOptional: false };
-}
-export function evaluateExpression(ir, actionTypeName, expression, resolveParameter, context, objects) {
+export async function evaluateExpression(options) {
+    const { ir, actionTypeName, expression, resolveParameter, context, tx, } = options;
     switch (expression.kind) {
         case "valueReference": {
             const [parameterName, ...path] = expression.value.path;
-            const parameterValue = resolveParameter(parameterName);
-            if (path.length === 0) {
+            const parameterValue = await resolveParameter(parameterName);
+            if (path.length === 0)
                 return parameterValue;
-            }
             const actionType = getActionType(ir, actionTypeName);
-            const { type: parameterType, isOptional: parameterIsOptional } = unwrapType(resolveType(ir, actionType.parameters.find((parameter) => parameter.name === parameterName).type));
-            if (parameterType.kind === "objectReference") {
-                const objectType = ir.objectTypes.find((objectType) => objectType.name === parameterType.value.objectType);
-                const collection = objects[objectType.name];
-                const referencedObject = collection?.get(parameterValue);
-                if (!referencedObject && !parameterIsOptional) {
-                    throw new Error(`Missing loaded "${objectType.name}" object for parameter "${parameterName}" (${String(parameterValue)}).`);
-                }
-                return get(referencedObject, path);
-            }
-            else {
+            const parameter = actionType.parameters.find((candidate) => candidate.name === parameterName);
+            const { type: parameterType, isOptional: parameterIsOptional, } = unwrapType(resolveType(ir, parameter.type));
+            if (parameterType.kind !== "objectReference") {
                 return get(parameterValue, path);
             }
+            const referencedType = ir.objectTypes.find((candidate) => candidate.name ===
+                parameterType.value.objectType);
+            const referencedObject = await tx.query((query, objects) => query
+                .from({
+                object: objects[referencedType.name],
+            })
+                .where(({ object }) => eq(object[referencedType.primaryKey], parameterValue))
+                .select(({ object }) => object)
+                .findOne());
+            if (!referencedObject && !parameterIsOptional) {
+                throw new Error(`Missing loaded "${referencedType.name}" object for parameter "${parameterName}" (${String(parameterValue)}).`);
+            }
+            return get(referencedObject, path);
         }
         case "contextReference":
             return get(context, expression.value.path);
         case "literal":
             return expression.value.value;
         case "functionCall":
-            switch (expression.value.kind) {
-                case "uuid":
-                    return globalThis.crypto.randomUUID();
-                case "now":
-                    return Temporal.Now.instant();
-            }
+            return expression.value.kind === "uuid"
+                ? globalThis.crypto.randomUUID()
+                : Temporal.Now.instant();
     }
 }
-export function resolveActionParameters(ir, actionTypeName, initialParameters, context, objects) {
-    const action = getActionType(ir, actionTypeName);
-    const resolvedParameters = { ...initialParameters };
-    const parametersByName = new Map(action.parameters.map((parameter) => [parameter.name, parameter]));
+export 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 = new Set();
-    const resolveParameter = (parameterName) => {
+    const resolveParameter = async (parameterName) => {
         if (resolvedParameters[parameterName] !== undefined) {
             return resolvedParameters[parameterName];
         }
         const parameter = parametersByName.get(parameterName);
-        if (!parameter || !parameter.defaultValue) {
+        if (!parameter?.defaultValue)
             return undefined;
-        }
         if (resolving.has(parameterName)) {
             throw new Error(`Circular action parameter default for "${parameterName}".`);
         }
         resolving.add(parameterName);
-        resolvedParameters[parameterName] = evaluateExpression(ir, actionTypeName, parameter.defaultValue, resolveParameter, context, objects);
-        resolving.delete(parameterName);
-        return resolvedParameters[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) {
-        resolveParameter(parameter.name);
+        await resolveParameter(parameter.name);
     }
     return resolvedParameters;
 }
 export function getObjectReferenceObjectType(ir, actionTypeName, reference) {
     const actionType = getActionType(ir, actionTypeName);
-    const parameter = actionType.parameters.find((parameter) => parameter.name === reference.path[0]);
+    const parameter = actionType.parameters.find((candidate) => candidate.name === reference.path[0]);
     const resolvedType = unwrapType(resolveType(ir, parameter.type)).type;
-    return ir.objectTypes.find((objectType) => objectType.name === resolvedType.value.objectType);
+    return ir.objectTypes.find((candidate) => candidate.name === resolvedType.value.objectType);
 }
 //# sourceMappingURL=expression.js.map

package/lib/live/expression.js.map

@@ -1 +1 @@
-{"version":3,"file":"expression.js","sourceRoot":"","sources":["../../src/live/expression.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"expression.js","sourceRoot":"","sources":["../../src/live/expression.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=expression.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expression.test.d.ts","sourceRoot":"","sources":["../../src/live/expression.test.ts"],"names":[],"mappings":""}

package/lib/live/expression.test.js

@@ -0,0 +1,76 @@
+import { createCollection, localOnlyCollectionOptions, } from "@tanstack/db";
+import { describe, expect, it } from "vitest";
+import { o } from "../ir/index.js";
+import { evaluateExpression } from "./expression.js";
+import { createReadTx } from "./mutators/createMutatorTx.js";
+const ir = {
+    types: [],
+    linkTypes: [],
+    queryFunctionTypes: [],
+    objectTypes: [
+        {
+            name: "User",
+            displayName: "User",
+            pluralDisplayName: "Users",
+            primaryKey: "id",
+            properties: [
+                {
+                    name: "id",
+                    displayName: "ID",
+                    type: o.string({}),
+                },
+                {
+                    name: "name",
+                    displayName: "Name",
+                    type: o.string({}),
+                },
+            ],
+        },
+    ],
+    actionTypes: [
+        {
+            name: "assign",
+            displayName: "Assign",
+            parameters: [
+                {
+                    name: "user",
+                    displayName: "User",
+                    type: o.objectReference({
+                        objectType: "User",
+                    }),
+                },
+            ],
+            logic: [],
+        },
+    ],
+};
+describe("evaluateExpression", () => {
+    it("resolves object-reference paths through the read transaction", async () => {
+        const users = createCollection(localOnlyCollectionOptions({
+            id: "expression-users",
+            getKey: (user) => user.id,
+            initialData: [
+                {
+                    id: "user-1",
+                    name: "Ada",
+                },
+            ],
+        }));
+        await users.preload();
+        await expect(evaluateExpression({
+            ir,
+            actionTypeName: "assign",
+            expression: {
+                kind: "valueReference",
+                value: {
+                    path: ["user", "name"],
+                },
+            },
+            resolveParameter: () => Promise.resolve("user-1"),
+            context: {},
+            tx: createReadTx({ User: users }),
+        })).resolves.toBe("Ada");
+        await users.cleanup();
+    });
+});
+//# sourceMappingURL=expression.test.js.map

package/lib/live/expression.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.test.js","sourceRoot":"","sources":["../../src/live/expression.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,gBAAgB,EAChB,0BAA0B,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D,MAAM,EAAE,GAAe;IACnB,KAAK,EAAE,EAAE;IACT,SAAS,EAAE,EAAE;IACb,kBAAkB,EAAE,EAAE;IACtB,WAAW,EAAE;QACT;YACI,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,MAAM;YACnB,iBAAiB,EAAE,OAAO;YAC1B,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE;gBACR;oBACI,IAAI,EAAE,IAAI;oBACV,WAAW,EAAE,IAAI;oBACjB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;iBACrB;gBACD;oBACI,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,MAAM;oBACnB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;iBACrB;aACJ;SACJ;KACJ;IACD,WAAW,EAAE;QACT;YACI,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE;gBACR;oBACI,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,MAAM;oBACnB,IAAI,EAAE,CAAC,CAAC,eAAe,CAAC;wBACpB,UAAU,EAAE,MAAM;qBACrB,CAAC;iBACL;aACJ;YACD,KAAK,EAAE,EAAE;SACZ;KACJ;CACJ,CAAC;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAG,gBAAgB,CAC1B,0BAA0B,CAGxB;YACE,EAAE,EAAE,kBAAkB;YACtB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,EAAqB;YAC9B,WAAW,EAAE;gBACT;oBACI,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,KAAK;iBACd;aACJ;SACJ,CAAC,CACL,CAAC;QACF,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QAEtB,MAAM,MAAM,CACR,kBAAkB,CAAC;YACf,EAAE;YACF,cAAc,EAAE,QAAQ;YACxB,UAAU,EAAE;gBACR,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE;oBACH,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;iBACzB;aACU;YACf,gBAAgB,EAAE,GAAG,EAAE,CACnB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC7B,OAAO,EAAE,EAAE;YACX,EAAE,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACpC,CAAC,CACL,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/live/index.d.ts

@@ -1,3 +1,6 @@
-export * from "./OntologyAdapter.js";
+export * from "./OntologyBackendAdapter.js";
 export * from "./LiveOntology.js";
+export * from "./mutators/types.js";
+export * from "./mutators/runOptimisticAction.js";
+export * from "./outbox/types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC"}

package/lib/live/index.js

@@ -1,3 +1,6 @@
-export * from "./OntologyAdapter.js";
+export * from "./OntologyBackendAdapter.js";
 export * from "./LiveOntology.js";
+export * from "./mutators/types.js";
+export * from "./mutators/runOptimisticAction.js";
+export * from "./outbox/types.js";
 //# sourceMappingURL=index.js.map

package/lib/live/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { OntologyMutatorObjects, OntologyMutatorTx } from "./types.js";
+import type { OntologyIR } from "../../ir/index.js";
+export declare function applyActionLogicToMutatorTx(options: {
+    ir: OntologyIR;
+    actionTypeName: string;
+    parameters: Record<string, unknown>;
+    context: Record<string, unknown>;
+    objects: OntologyMutatorObjects;
+    tx: OntologyMutatorTx;
+}): Promise<void>;
+//# sourceMappingURL=OntologyEdits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OntologyEdits.d.ts","sourceRoot":"","sources":["../../../src/live/mutators/OntologyEdits.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,sBAAsB,EACtB,iBAAiB,EAGpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAER,UAAU,EAEb,MAAM,mBAAmB,CAAC;AA0C3B,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACvD,EAAE,EAAE,UAAU,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,sBAAsB,CAAC;IAChC,EAAE,EAAE,iBAAiB,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDhB"}

package/lib/live/mutators/OntologyEdits.js

@@ -0,0 +1,66 @@
+import { set } from "lodash-es";
+import { decorateObjectAttachmentSources } from "../attachments/attachmentSources.js";
+import { evaluateExpression, getObjectReferenceObjectType, } from "../expression.js";
+function objectType(ir, name) {
+    const type = ir.objectTypes.find((candidate) => candidate.name === name);
+    if (!type)
+        throw new Error(`Unknown object type "${name}".`);
+    return type;
+}
+async function propertyChanges(options) {
+    const changes = [];
+    for (const assignment of options.assignments) {
+        const value = await evaluateExpression({
+            ir: options.ir,
+            actionTypeName: options.actionTypeName,
+            expression: assignment.value,
+            resolveParameter: (name) => Promise.resolve(options.parameters[name]),
+            context: options.context,
+            tx: options.tx,
+        });
+        if (value !== undefined) {
+            changes.push({
+                path: assignment.property,
+                value,
+            });
+        }
+    }
+    return changes;
+}
+export async function applyActionLogicToMutatorTx(options) {
+    const action = options.ir.actionTypes.find((candidate) => candidate.name === options.actionTypeName);
+    if (!action) {
+        throw new Error(`Unknown action "${options.actionTypeName}".`);
+    }
+    for (const step of action.logic) {
+        if (step.kind === "createObject") {
+            const type = objectType(options.ir, step.value.objectType);
+            const object = {};
+            for (const change of await propertyChanges({
+                ...options,
+                assignments: step.value.values,
+            })) {
+                set(object, change.path, change.value);
+            }
+            decorateObjectAttachmentSources({
+                ir: options.ir,
+                objectType: type,
+                object,
+            });
+            await options.tx.mutate[type.name].create(object);
+            continue;
+        }
+        const type = getObjectReferenceObjectType(options.ir, options.actionTypeName, step.value.object);
+        const key = options.parameters[step.value.object.path[0]];
+        if (step.kind === "updateObject") {
+            await options.tx.mutate[type.name].update(key, await propertyChanges({
+                ...options,
+                assignments: step.value.values,
+            }));
+        }
+        else {
+            await options.tx.mutate[type.name].delete(key);
+        }
+    }
+}
+//# sourceMappingURL=OntologyEdits.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OntologyEdits.js","sourceRoot":"","sources":["../../../src/live/mutators/OntologyEdits.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+import { type Transaction } from "@tanstack/db";
+import type { OntologyMutatorObjects, OntologyMutatorTx, OntologyReadTx } from "./types.js";
+export declare function createReadTx(objects: OntologyMutatorObjects): OntologyReadTx;
+export declare function createMutatorTx(options: {
+    transaction: Transaction;
+    objects: OntologyMutatorObjects;
+    primaryKeys?: Record<string, string>;
+}): OntologyMutatorTx;
+//# sourceMappingURL=createMutatorTx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createMutatorTx.d.ts","sourceRoot":"","sources":["../../../src/live/mutators/createMutatorTx.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,WAAW,EACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACR,sBAAsB,EACtB,iBAAiB,EAEjB,cAAc,EACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CACxB,OAAO,EAAE,sBAAsB,GAChC,cAAc,CAOhB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACrC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,sBAAsB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,GAAG,iBAAiB,CAoEpB"}

package/lib/live/mutators/createMutatorTx.js

@@ -0,0 +1,67 @@
+import { eq, queryOnce, } from "@tanstack/db";
+import { set } from "lodash-es";
+export function createReadTx(objects) {
+    return {
+        query: (build) => queryOnce((query) => build(query, objects)),
+    };
+}
+export function createMutatorTx(options) {
+    return {
+        ...createReadTx(options.objects),
+        mutate: new Proxy({}, {
+            get: (_target, objectType) => {
+                if (typeof objectType !== "string") {
+                    return undefined;
+                }
+                const collection = options.objects[objectType];
+                if (!collection) {
+                    throw new Error(`Unknown object type "${objectType}".`);
+                }
+                return {
+                    create: (object) => {
+                        options.transaction.mutate(() => {
+                            collection.insert(object);
+                        });
+                        return Promise.resolve();
+                    },
+                    update: async (key, changes) => {
+                        await ensureObjectLoaded(collection, objectType, options.primaryKeys, key);
+                        options.transaction.mutate(() => {
+                            collection.update(key, (draft) => {
+                                applyChanges(draft, changes);
+                            });
+                        });
+                    },
+                    delete: async (key) => {
+                        await ensureObjectLoaded(collection, objectType, options.primaryKeys, key);
+                        options.transaction.mutate(() => {
+                            collection.delete(key);
+                        });
+                    },
+                };
+            },
+        }),
+    };
+}
+async function ensureObjectLoaded(collection, objectType, primaryKeys, key) {
+    if (collection.has(key))
+        return;
+    const primaryKey = primaryKeys?.[objectType];
+    if (!primaryKey)
+        return;
+    await queryOnce((query) => query
+        .from({ object: collection })
+        .where(({ object }) => eq(object[primaryKey], key))
+        .findOne());
+}
+function applyChanges(object, changes) {
+    if (Array.isArray(changes)) {
+        for (const change of changes) {
+            set(object, change.path, change.value);
+        }
+    }
+    else {
+        Object.assign(object, changes);
+    }
+}
+//# sourceMappingURL=createMutatorTx.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createMutatorTx.js","sourceRoot":"","sources":["../../../src/live/mutators/createMutatorTx.ts"],"names":[],"mappings":"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"}

package/lib/live/mutators/createMutatorTx.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createMutatorTx.test.d.ts.map

package/lib/live/mutators/createMutatorTx.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMutatorTx.test.d.ts","sourceRoot":"","sources":["../../../src/live/mutators/createMutatorTx.test.ts"],"names":[],"mappings":""}

package/lib/live/mutators/createMutatorTx.test.js

@@ -0,0 +1,90 @@
+import { createCollection, createTransaction, eq, localOnlyCollectionOptions, } from "@tanstack/db";
+import { describe, expect, it } from "vitest";
+import { createMutatorTx } from "./createMutatorTx.js";
+describe("createMutatorTx", () => {
+    it("queries local data and observes earlier writes", async () => {
+        const tasks = createCollection(localOnlyCollectionOptions({
+            id: "tasks",
+            getKey: (task) => task.id,
+            initialData: [
+                {
+                    id: "task-1",
+                    title: "Before",
+                },
+            ],
+        }));
+        await tasks.preload();
+        const transaction = createTransaction({
+            autoCommit: false,
+            mutationFn: () => Promise.resolve(),
+        });
+        void transaction.isPersisted.promise.catch(() => undefined);
+        const tx = createMutatorTx({
+            transaction,
+            objects: { Task: tasks },
+        });
+        await tx.mutate.Task.update("task-1", {
+            title: "After",
+        });
+        const result = await tx.query((query, objects) => query
+            .from({ task: objects.Task })
+            .where(({ task }) => eq(task.id, "task-1"))
+            .select(({ task }) => ({
+            title: task.title,
+        }))
+            .findOne());
+        expect(result?.title).toBe("After");
+        expect(tasks.get("task-1")?.title).toBe("After");
+        transaction.rollback();
+        expect(tasks.get("task-1")?.title).toBe("Before");
+        await tasks.cleanup();
+    });
+    it("loads a referenced object on demand before updating it", async () => {
+        let subsetLoads = 0;
+        const tasks = createCollection({
+            id: "lazy-tasks",
+            getKey: (task) => task.id,
+            syncMode: "on-demand",
+            sync: {
+                sync: ({ begin, write, commit, markReady, }) => {
+                    markReady();
+                    return {
+                        loadSubset: () => {
+                            subsetLoads += 1;
+                            begin({
+                                immediate: true,
+                            });
+                            write({
+                                type: "insert",
+                                value: {
+                                    id: "task-1",
+                                    title: "Before",
+                                },
+                            });
+                            commit();
+                            return Promise.resolve();
+                        },
+                    };
+                },
+            },
+        });
+        const transaction = createTransaction({
+            autoCommit: false,
+            mutationFn: () => Promise.resolve(),
+        });
+        void transaction.isPersisted.promise.catch(() => undefined);
+        const tx = createMutatorTx({
+            transaction,
+            objects: { Task: tasks },
+            primaryKeys: { Task: "id" },
+        });
+        await tx.mutate.Task.update("task-1", {
+            title: "After",
+        });
+        expect(subsetLoads).toBe(1);
+        expect(tasks.get("task-1")?.title).toBe("After");
+        transaction.rollback();
+        await tasks.cleanup();
+    });
+});
+//# sourceMappingURL=createMutatorTx.test.js.map

package/lib/live/mutators/createMutatorTx.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMutatorTx.test.js","sourceRoot":"","sources":["../../../src/live/mutators/createMutatorTx.test.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+import type { OntologyMutatorRegistry } from "./types.js";
+import type { OntologyIR } from "../../ir/index.js";
+import type { OntologyCollection } from "../objects/createLiveOntologyObjectCollection.js";
+import type { OntologyObject } from "../objects/OntologyObject.js";
+import type { Transaction } from "@tanstack/db";
+export declare function runOptimisticAction(options: {
+    transaction: Transaction;
+    ir: OntologyIR;
+    actionTypeName: string;
+    parameters: Record<string, unknown>;
+    context: Record<string, unknown>;
+    objects: Record<string, OntologyCollection<OntologyObject>>;
+    mutators?: OntologyMutatorRegistry;
+}): Promise<void>;
+//# sourceMappingURL=runOptimisticAction.d.ts.map