@adobe/data 0.5.10 → 0.5.11

package/dist/functions/index.d.ts

@@ -2,3 +2,4 @@ export * from "./apply-args.js";
 export * from "./serialization/index.js";
 export * from "./blit.js";
 export * from "./copy-view-bytes.js";
+export * from "./merge-patch.js";

package/dist/functions/index.js

@@ -23,4 +23,5 @@ export * from "./apply-args.js";
 export * from "./serialization/index.js";
 export * from "./blit.js";
 export * from "./copy-view-bytes.js";
+export * from "./merge-patch.js";
 //# sourceMappingURL=index.js.map

package/dist/functions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/functions/merge-patch.d.ts

@@ -0,0 +1,11 @@
+export type Patch<T> = (T extends readonly any[] ? T : T extends object ? {
+    [K in keyof T]?: Patch<T[K]> | null;
+} : T) | null;
+/**
+ * Executes a JSON Merge Patch (RFC 7396) on `target` with `patch`.
+ * - Objects: recursively merge; `null` deletes a property.
+ * - Arrays: replaced wholesale (no element-wise merge).
+ * - Primitives: replaced.
+ * Does NOT mutate the input objects or arrays.
+ */
+export declare function mergePatch<T>(target: T, patch: Patch<T>): T;

package/dist/functions/merge-patch.js

@@ -0,0 +1,37 @@
+/**
+ * Executes a JSON Merge Patch (RFC 7396) on `target` with `patch`.
+ * - Objects: recursively merge; `null` deletes a property.
+ * - Arrays: replaced wholesale (no element-wise merge).
+ * - Primitives: replaced.
+ * Does NOT mutate the input objects or arrays.
+ */
+export function mergePatch(target, patch) {
+    // null always replaces (including deleting properties when nested)
+    if (patch === null)
+        return patch;
+    // Arrays in the patch replace wholesale
+    if (Array.isArray(patch))
+        return patch;
+    // Non-objects (string/number/boolean) replace
+    if (typeof patch !== "object")
+        return patch;
+    // If target isn't a plain object, any object-like patch replaces it
+    if (target === null || typeof target !== "object" || Array.isArray(target)) {
+        return patch;
+    }
+    // target & patch are plain objects → merge recursively
+    const result = { ...target };
+    for (const key of Object.keys(patch)) {
+        const value = patch[key];
+        if (value === null) {
+            // delete per RFC 7396
+            delete result[key];
+        }
+        else {
+            // recurse
+            result[key] = mergePatch(target[key], value);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=merge-patch.js.map

package/dist/functions/merge-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-patch.js","sourceRoot":"","sources":["../../src/functions/merge-patch.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAI,MAAS,EAAE,KAAe;IACpD,mEAAmE;IACnE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAU,CAAC;IAEtC,wCAAwC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAU,CAAC;IAE5C,8CAA8C;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAU,CAAC;IAEjD,oEAAoE;IACpE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzE,OAAO,KAAU,CAAC;IACtB,CAAC;IAED,uDAAuD;IACvD,MAAM,MAAM,GAA8C,EAAE,GAAI,MAAc,EAAE,CAAC;IAEjF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAA2B,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAI,KAAa,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,sBAAsB;YACtB,OAAO,MAAM,CAAC,GAAU,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACJ,UAAU;YACV,MAAM,CAAC,GAAU,CAAC,GAAG,UAAU,CAAE,MAAc,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAED,OAAO,MAAW,CAAC;AACvB,CAAC"}

package/dist/functions/merge-patch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/functions/merge-patch.test.js

@@ -0,0 +1,96 @@
+import { describe, expect, it } from "vitest";
+import { mergePatch } from "./merge-patch.js";
+/**
+ * RFC 7396 expectations:
+ * - null replaces (or deletes when nested in an object)
+ * - arrays replace wholesale (no deep merge)
+ * - primitives replace
+ * - objects merge recursively
+ */
+describe("mergePatch", () => {
+    it("replaces top-level with null", () => {
+        const target = { a: 1, b: 2 };
+        const patch = null;
+        const result = mergePatch(target, patch);
+        expect(result).toBeNull();
+    });
+    it("replaces primitives", () => {
+        expect(mergePatch(1, 2)).toBe(2);
+        expect(mergePatch("a", "b")).toBe("b");
+        expect(mergePatch(true, false)).toBe(false);
+    });
+    it("replaces arrays wholesale", () => {
+        const target = { items: [1, 2, 3] };
+        const patch = { items: [9] };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ items: [9] });
+    });
+    it("deletes object members when value is null", () => {
+        const target = { a: 1, b: 2 };
+        const patch = { b: null };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ a: 1 });
+        // ensure non-mutating
+        expect(target).toEqual({ a: 1, b: 2 });
+    });
+    it("recursively merges nested objects", () => {
+        const target = { a: { x: 1, y: 2 }, b: 5 };
+        const patch = { a: { y: 9 } };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ a: { x: 1, y: 9 }, b: 5 });
+    });
+    it("replaces non-object targets when patch is object", () => {
+        // Using explicit any generic to exercise runtime behavior intentionally outside typing constraints
+        expect(mergePatch(1, { a: 1 })).toEqual({ a: 1 });
+        expect(mergePatch([1, 2], { a: 1 })).toEqual({ a: 1 });
+        expect(mergePatch(null, { a: 1 })).toEqual({ a: 1 });
+    });
+    it("handles adding new keys", () => {
+        const target = { a: 1 };
+        const patch = { b: 2 };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ a: 1, b: 2 });
+    });
+    it("handles nested null to delete deep key", () => {
+        const target = { a: { x: 1, y: 2 }, b: 3 };
+        const patch = { a: { y: null } };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ a: { x: 1 }, b: 3 });
+    });
+    it("replaces array value with null to delete property", () => {
+        const target = { a: [1, 2, 3], b: 1 };
+        const patch = { a: null };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ b: 1 });
+    });
+    it("replaces scalar with array and vice versa", () => {
+        const t1 = { a: 1 };
+        const p1 = { a: [1, 2] };
+        expect(mergePatch(t1, p1)).toEqual({ a: [1, 2] });
+        const t2 = { a: [1, 2] };
+        const p2 = { a: 7 };
+        expect(mergePatch(t2, p2)).toEqual({ a: 7 });
+    });
+    it("does not mutate input objects or arrays", () => {
+        const target = { a: { x: 1 }, arr: [1, 2] };
+        const patch = { a: { y: 2 }, arr: [9] };
+        const targetClone = JSON.parse(JSON.stringify(target));
+        mergePatch({ ...target, a: { ...target.a }, arr: [...target.arr] }, patch);
+        expect(target).toEqual(targetClone);
+    });
+    it("merging empty object returns structural copy of target (no-op)", () => {
+        const target = { a: 1, b: { x: 2 } };
+        const patch = {};
+        const result = mergePatch(target, patch);
+        expect(result).toEqual(target);
+        // not the same reference when patching an object
+        expect(result).not.toBe(target);
+    });
+    it("merges when target has undefined keys (treats as normal values)", () => {
+        const target = { a: undefined };
+        const patch = { a: 1, b: undefined };
+        const result = mergePatch(target, patch);
+        expect(result).toEqual({ a: 1, b: undefined });
+    });
+});
+//# sourceMappingURL=merge-patch.test.js.map

package/dist/functions/merge-patch.test.js.map

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

package/dist/samples/todo/services/state-service/create-todo-database.d.ts

@@ -1,13 +1,13 @@
 import * as transactions from './transactions/index.js';
 export declare const createTodoDatabase: () => import("../../../../ecs/index.js").Database<{
-    order: number;
-    name: string;
     todo: true;
+    name: string;
+    order: number;
     complete: boolean;
     dragPosition: number | null;
 }, {
     displayCompleted: boolean;
 }, {
-    Todo: ("order" | "name" | "todo" | "complete" | "dragPosition")[];
+    Todo: ("todo" | "name" | "order" | "complete" | "dragPosition")[];
 }, import("../../../../ecs/index.js").ToTransactionFunctions<typeof transactions>>;
 export type TodoDatabase = ReturnType<typeof createTodoDatabase>;

package/dist/samples/todo/services/state-service/create-todo-store.d.ts

@@ -1,13 +1,13 @@
 export declare const todoStoreSchemaVersion = 1;
 export declare const createTodoStore: () => import("../../../../ecs/index.js").Store<{
-    order: number;
-    name: string;
     todo: true;
+    name: string;
+    order: number;
     complete: boolean;
     dragPosition: number | null;
 }, {
     displayCompleted: boolean;
 }, {
-    Todo: ("order" | "name" | "todo" | "complete" | "dragPosition")[];
+    Todo: ("todo" | "name" | "order" | "complete" | "dragPosition")[];
 }>;
 export type TodoStore = ReturnType<typeof createTodoStore>;