@party-stack/foundry-ontology 0.18.0 → 0.19.0

package/lib/stagedWrites.d.ts

@@ -1,28 +1,29 @@
-import type { OntologyIR, OntologyMutator, OntologyMutatorObjects, OntologyMutatorTx } from "@party-stack/ontology";
-import type { InitialQueryBuilder } from "@tanstack/db";
+import { InitialQueryBuilder } from "@tanstack/db";
+import { OntologyIR, OntologyMutator, OntologyMutatorObjects, OntologyMutatorTx } from "@party-stack/ontology";
+//#region src/stagedWrites.d.ts
 /**
  * Structural subset of Foundry's staged-write `WriteableClient`.
  * Generated Foundry clients can be passed directly.
  */
 export interface FoundryStagedWriteClient {
-    create(objectType: unknown, object: Record<string, unknown>): Promise<unknown>;
-    update(object: {
-        $apiName: string;
-        $primaryKey: string | number;
-    }, changes: Record<string, unknown>): Promise<unknown>;
-    delete(object: {
-        $apiName: string;
-        $primaryKey: string | number;
-    }): Promise<unknown>;
-    query?<T>(build: (query: InitialQueryBuilder, objects: OntologyMutatorObjects) => unknown): Promise<T>;
+  create(objectType: unknown, object: Record<string, unknown>): Promise<unknown>;
+  update(object: {
+    $apiName: string;
+    $primaryKey: string | number;
+  }, changes: Record<string, unknown>): Promise<unknown>;
+  delete(object: {
+    $apiName: string;
+    $primaryKey: string | number;
+  }): Promise<unknown>;
+  query?<T>(build: (query: InitialQueryBuilder, objects: OntologyMutatorObjects) => unknown): Promise<T>;
 }
 export interface CreateFoundryStagedWriteMutatorTxOptions {
-    client: FoundryStagedWriteClient;
-    /**
-     * Generated OSDK object type tokens, keyed by ontology API name. Required
-     * for creates when the client cannot accept an `$apiName` placeholder.
-     */
-    objectTypes?: Record<string, unknown>;
+  client: FoundryStagedWriteClient;
+  /**
+   * Generated OSDK object type tokens, keyed by ontology API name. Required
+   * for creates when the client cannot accept an `$apiName` placeholder.
+   */
+  objectTypes?: Record<string, unknown>;
 }
 export declare function createFoundryStagedWriteMutatorTx(options: CreateFoundryStagedWriteMutatorTxOptions): OntologyMutatorTx;
 /**
@@ -30,11 +31,12 @@ export declare function createFoundryStagedWriteMutatorTx(options: CreateFoundry
  * transaction. Foundry provides atomic commit/rollback and read-after-write.
  */
 export declare function runFoundryOntologyMutator(options: {
-    ir: OntologyIR;
-    client: FoundryStagedWriteClient;
-    mutator: OntologyMutator;
-    args: Record<string, unknown>;
-    context?: Record<string, unknown>;
-    objectTypes?: Record<string, unknown>;
+  ir: OntologyIR;
+  client: FoundryStagedWriteClient;
+  mutator: OntologyMutator;
+  args: Record<string, unknown>;
+  context?: Record<string, unknown>;
+  objectTypes?: Record<string, unknown>;
 }): Promise<void>;
+//#endregion
 //# sourceMappingURL=stagedWrites.d.ts.map

package/lib/stagedWrites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stagedWrites.d.ts","sourceRoot":"","sources":["../src/stagedWrites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EAEpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC,MAAM,CACF,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,MAAM,CACF,MAAM,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;KAChC,EACD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,MAAM,CAAC,MAAM,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;KAChC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,KAAK,CAAC,CAAC,CAAC,EACJ,KAAK,EAAE,CACH,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,sBAAsB,KAC9B,OAAO,GACb,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED,MAAM,WAAW,wCAAwC;IACrD,MAAM,EAAE,wBAAwB,CAAC;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAmCD,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,wCAAwC,GAClD,iBAAiB,CAyDnB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACrD,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}
+{"version":3,"file":"stagedWrites.d.ts","names":[],"sources":["../src/stagedWrites.ts"],"mappings":";;;;;;;iBAaiB;EACb,OAAO,qBAAqB,QAAQ,0BAA0B;EAC9D,OACI;IACI;IACA;KAEJ,SAAS,0BACV;EACH,OAAO;IAAU;IAAkB;MAAiC;EACpE,OAAO,GAAG,QAAQ,OAAO,qBAAqB,SAAS,qCAAqC,QAAQ;;iBAGvF;EACb,QAAQ;;;;;EAKR,cAAc;;wBA0BF,kCACZ,SAAS,2CACV;;;;;wBAuDmB,0BAA0B;EAC5C,IAAI;EACJ,QAAQ;EACR,SAAS;EACT,MAAM;EACN,UAAU;EACV,cAAc;IACd"}

package/lib/stagedWrites.js

@@ -1,74 +1,63 @@
+//#region src/stagedWrites.ts
 function setPath(object, path, value) {
-    let target = object;
-    for (const segment of path.slice(0, -1)) {
-        const existing = target[segment];
-        if (typeof existing !== "object" ||
-            existing === null ||
-            Array.isArray(existing)) {
-            target[segment] = {};
-        }
-        target = target[segment];
-    }
-    target[path.at(-1)] = value;
+	let target = object;
+	for (const segment of path.slice(0, -1)) {
+		const existing = target[segment];
+		if (typeof existing !== "object" || existing === null || Array.isArray(existing)) target[segment] = {};
+		target = target[segment];
+	}
+	target[path.at(-1)] = value;
 }
 function changesToRecord(changes) {
-    if (!Array.isArray(changes))
-        return changes;
-    const record = {};
-    for (const change of changes) {
-        setPath(record, change.path, change.value);
-    }
-    return record;
+	if (!Array.isArray(changes)) return changes;
+	const record = {};
+	for (const change of changes) setPath(record, change.path, change.value);
+	return record;
 }
-export function createFoundryStagedWriteMutatorTx(options) {
-    return {
-        query: async (build) => {
-            if (!options.client.query) {
-                throw new Error("Foundry staged-write mutator queries require a query adapter backed by the ambient staged-write client.");
-            }
-            return options.client.query(build);
-        },
-        mutate: new Proxy({}, {
-            get: (_target, objectType) => {
-                if (typeof objectType !== "string") {
-                    return undefined;
-                }
-                return {
-                    create: async (object) => {
-                        await options.client.create(options.objectTypes?.[objectType] ?? {
-                            $apiName: objectType,
-                        }, object);
-                    },
-                    update: async (key, changes) => {
-                        await options.client.update({
-                            $apiName: objectType,
-                            $primaryKey: key,
-                        }, changesToRecord(changes));
-                    },
-                    delete: async (key) => {
-                        await options.client.delete({
-                            $apiName: objectType,
-                            $primaryKey: key,
-                        });
-                    },
-                };
-            },
-        }),
-    };
+function createFoundryStagedWriteMutatorTx(options) {
+	return {
+		query: async (build) => {
+			if (!options.client.query) throw new Error("Foundry staged-write mutator queries require a query adapter backed by the ambient staged-write client.");
+			return options.client.query(build);
+		},
+		mutate: new Proxy({}, { get: (_target, objectType) => {
+			if (typeof objectType !== "string") return;
+			return {
+				create: async (object) => {
+					await options.client.create(options.objectTypes?.[objectType] ?? { $apiName: objectType }, object);
+				},
+				update: async (key, changes) => {
+					await options.client.update({
+						$apiName: objectType,
+						$primaryKey: key
+					}, changesToRecord(changes));
+				},
+				delete: async (key) => {
+					await options.client.delete({
+						$apiName: objectType,
+						$primaryKey: key
+					});
+				}
+			};
+		} })
+	};
 }
 /**
- * Run a Party Stack ontology mutator inside Foundry's ambient staged-write
- * transaction. Foundry provides atomic commit/rollback and read-after-write.
- */
-export async function runFoundryOntologyMutator(options) {
-    const tx = createFoundryStagedWriteMutatorTx({
-        client: options.client,
-        objectTypes: options.objectTypes,
-    });
-    await options.mutator({
-        tx,
-        args: options.args,
-        context: options.context ?? {},
-    });
+* Run a Party Stack ontology mutator inside Foundry's ambient staged-write
+* transaction. Foundry provides atomic commit/rollback and read-after-write.
+*/
+async function runFoundryOntologyMutator(options) {
+	const tx = createFoundryStagedWriteMutatorTx({
+		client: options.client,
+		objectTypes: options.objectTypes
+	});
+	await options.mutator({
+		tx,
+		args: options.args,
+		context: options.context ?? {}
+	});
 }
+//#endregion
+export { createFoundryStagedWriteMutatorTx, runFoundryOntologyMutator };
+
 //# sourceMappingURL=stagedWrites.js.map

package/lib/stagedWrites.js.map

@@ -1 +1 @@
-{"version":3,"file":"stagedWrites.js","sourceRoot":"","sources":["../src/stagedWrites.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stagedWrites.js","names":[],"sources":["../src/stagedWrites.ts"],"sourcesContent":["import type {\n    OntologyIR,\n    OntologyMutator,\n    OntologyMutatorObjects,\n    OntologyMutatorTx,\n    OntologyPropertyChange,\n} from \"@party-stack/ontology\";\nimport type { InitialQueryBuilder } from \"@tanstack/db\";\n\n/**\n * Structural subset of Foundry's staged-write `WriteableClient`.\n * Generated Foundry clients can be passed directly.\n */\nexport interface FoundryStagedWriteClient {\n    create(objectType: unknown, object: Record<string, unknown>): Promise<unknown>;\n    update(\n        object: {\n            $apiName: string;\n            $primaryKey: string | number;\n        },\n        changes: Record<string, unknown>\n    ): Promise<unknown>;\n    delete(object: { $apiName: string; $primaryKey: string | number }): Promise<unknown>;\n    query?<T>(build: (query: InitialQueryBuilder, objects: OntologyMutatorObjects) => unknown): Promise<T>;\n}\n\nexport interface CreateFoundryStagedWriteMutatorTxOptions {\n    client: FoundryStagedWriteClient;\n    /**\n     * Generated OSDK object type tokens, keyed by ontology API name. Required\n     * for creates when the client cannot accept an `$apiName` placeholder.\n     */\n    objectTypes?: Record<string, unknown>;\n}\n\nfunction setPath(object: Record<string, unknown>, path: string[], value: unknown): void {\n    let target = object;\n    for (const segment of path.slice(0, -1)) {\n        const existing = target[segment];\n        if (typeof existing !== \"object\" || existing === null || Array.isArray(existing)) {\n            target[segment] = {};\n        }\n        target = target[segment] as Record<string, unknown>;\n    }\n    target[path.at(-1)!] = value;\n}\n\nfunction changesToRecord(\n    changes: Record<string, unknown> | OntologyPropertyChange[]\n): Record<string, unknown> {\n    if (!Array.isArray(changes)) return changes;\n    const record: Record<string, unknown> = {};\n    for (const change of changes) {\n        setPath(record, change.path, change.value);\n    }\n    return record;\n}\n\nexport function createFoundryStagedWriteMutatorTx(\n    options: CreateFoundryStagedWriteMutatorTxOptions\n): OntologyMutatorTx {\n    return {\n        query: async (build) => {\n            if (!options.client.query) {\n                throw new Error(\n                    \"Foundry staged-write mutator queries require a query adapter backed by the ambient staged-write client.\"\n                );\n            }\n            return options.client.query(build);\n        },\n        mutate: new Proxy(\n            {},\n            {\n                get: (_target, objectType) => {\n                    if (typeof objectType !== \"string\") {\n                        return undefined;\n                    }\n                    return {\n                        create: async (object: Record<string, unknown>) => {\n                            await options.client.create(\n                                options.objectTypes?.[objectType] ?? {\n                                    $apiName: objectType,\n                                },\n                                object\n                            );\n                        },\n                        update: async (\n                            key: string | number,\n                            changes: Record<string, unknown> | OntologyPropertyChange[]\n                        ) => {\n                            await options.client.update(\n                                {\n                                    $apiName: objectType,\n                                    $primaryKey: key,\n                                },\n                                changesToRecord(changes)\n                            );\n                        },\n                        delete: async (key: string | number) => {\n                            await options.client.delete({\n                                $apiName: objectType,\n                                $primaryKey: key,\n                            });\n                        },\n                    };\n                },\n            }\n        ),\n    };\n}\n\n/**\n * Run a Party Stack ontology mutator inside Foundry's ambient staged-write\n * transaction. Foundry provides atomic commit/rollback and read-after-write.\n */\nexport async function runFoundryOntologyMutator(options: {\n    ir: OntologyIR;\n    client: FoundryStagedWriteClient;\n    mutator: OntologyMutator;\n    args: Record<string, unknown>;\n    context?: Record<string, unknown>;\n    objectTypes?: Record<string, unknown>;\n}): Promise<void> {\n    const tx = createFoundryStagedWriteMutatorTx({\n        client: options.client,\n        objectTypes: options.objectTypes,\n    });\n    await options.mutator({\n        tx,\n        args: options.args,\n        context: options.context ?? {},\n    });\n}\n"],"mappings":";AAmCA,SAAS,QAAQ,QAAiC,MAAgB,OAAsB;CACpF,IAAI,SAAS;CACb,KAAK,MAAM,WAAW,KAAK,MAAM,GAAG,EAAE,GAAG;EACrC,MAAM,WAAW,OAAO;EACxB,IAAI,OAAO,aAAa,YAAY,aAAa,QAAQ,MAAM,QAAQ,QAAQ,GAC3E,OAAO,WAAW,CAAC;EAEvB,SAAS,OAAO;CACpB;CACA,OAAO,KAAK,GAAG,EAAE,KAAM;AAC3B;AAEA,SAAS,gBACL,SACuB;CACvB,IAAI,CAAC,MAAM,QAAQ,OAAO,GAAG,OAAO;CACpC,MAAM,SAAkC,CAAC;CACzC,KAAK,MAAM,UAAU,SACjB,QAAQ,QAAQ,OAAO,MAAM,OAAO,KAAK;CAE7C,OAAO;AACX;AAEA,SAAgB,kCACZ,SACiB;CACjB,OAAO;EACH,OAAO,OAAO,UAAU;GACpB,IAAI,CAAC,QAAQ,OAAO,OAChB,MAAM,IAAI,MACN,yGACJ;GAEJ,OAAO,QAAQ,OAAO,MAAM,KAAK;EACrC;EACA,QAAQ,IAAI,MACR,CAAC,GACD,EACI,MAAM,SAAS,eAAe;GAC1B,IAAI,OAAO,eAAe,UACtB;GAEJ,OAAO;IACH,QAAQ,OAAO,WAAoC;KAC/C,MAAM,QAAQ,OAAO,OACjB,QAAQ,cAAc,eAAe,EACjC,UAAU,WACd,GACA,MACJ;IACJ;IACA,QAAQ,OACJ,KACA,YACC;KACD,MAAM,QAAQ,OAAO,OACjB;MACI,UAAU;MACV,aAAa;KACjB,GACA,gBAAgB,OAAO,CAC3B;IACJ;IACA,QAAQ,OAAO,QAAyB;KACpC,MAAM,QAAQ,OAAO,OAAO;MACxB,UAAU;MACV,aAAa;KACjB,CAAC;IACL;GACJ;EACJ,EACJ,CACJ;CACJ;AACJ;;;;;AAMA,eAAsB,0BAA0B,SAO9B;CACd,MAAM,KAAK,kCAAkC;EACzC,QAAQ,QAAQ;EAChB,aAAa,QAAQ;CACzB,CAAC;CACD,MAAM,QAAQ,QAAQ;EAClB;EACA,MAAM,QAAQ;EACd,SAAS,QAAQ,WAAW,CAAC;CACjC,CAAC;AACL"}