datum-merge 0.3.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Rohit Kulkarni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# datum-merge
+
+**datum-merge** is a modern typescript library that simplifies merge and diff operations for deeply nested objects.
+
+**Source Code** : https://github.com/therohk/datum-merge
+
+**NPM library** : https://www.npmjs.com/package/datum-merge
+
+![](https://github.com/therohk/datum-merge/actions/workflows/build.yml/badge.svg)
+
+---
+
+## Upcoming Features
+
+1. inline entire [deep-diff](https://github.com/flitbit/diff) library which is unmaintained and contains serious bugs.
+
+2. support merging for top level arrays or primitives.
+
+3. project should compile in strict mode.
+
+4. formalize support for deeply nested objects (for v1).
+
+Code contributions are welcome via issues and pull requests.
+
+---
+
+## Examples
+
+```
+import { merge, MergeConfig, UpdateCode } from "datum-merge";
+const conf: MergeConfig = {
+    "id": UpdateCode.I,
+    "field1": UpdateCode.B,
+    "arr*": UpdateCode.XM,
+    nested: UpdatedCode.N,
+    "obj1": {
+        scalar: UpdateCode.B,
+        vector: UpdateCode.XM,
+    },
+};
+const diff = merge(target, source, conf);
+```
+
+## Merge Strategy
+
+This string code describes how modifications to an attribute for a PUT/UPDATE operation should be handled.
+It decides whether a change to the value of the field is allowed during a merge operation between two entities.
+
+### Strategy Codes
+
+The same field within a source and target object is represented by `s` and `t` respectively.
+Whether the strategy requires data to be present for the field, is shown by { 0=no, 1=yes, X=irrelavant }. 
+The value of the source field is migrated to the target field only if the predicate passes.
+See the implementation of this logic in [merge-low.ts](src/merge-low.ts).
+
+| Code Value | Predicate | Meaning |
+|----|----|----|
+| C | n/a | always create new instance |
+| N | `0` | reject any change, skip merge |
+| Y | `sX & tX` | accept any change ; bypass merge |
+| B | `s1 & tX` | insert or update, no delete |
+| H | `s1 & t1` | update only if exists |
+| U | `sX & t1` | update or delete only, no insert |
+| I | `sX & t0` | insert only, no update or delete |
+| D | `s0 & tX` | delete only, no update or insert |
+| XR | `sX & tX` | full vector replacement |
+| XM | `s ∪ t`   | set union, vector merge |
+| XD | `s - t`   | set difference, delete given values |
+| XI | `s ∩ t`   | set intersection, delete missing values |
+| XS | `s + t` | preserve order insert (allows dupes) |
+| XF | `t + s` | insert from start (allows dupes) |
+
+Applying the merge results in one of these transitions per primitive value in the target object.
+
+| Code Value | Meaning | Transitions |
+|----|----|----|
+| Z | noop / ignore  | `null <- null` or `non-null == non-null` |
+| N | new / insert   | `null <- non-null` |
+| E | edit / update  | `non-null <- non-null` |
+| D | unset / delete | `non-null <- null` |
+
+---

package/dist/esm/data-utils.d.ts

@@ -0,0 +1,9 @@
+export declare function getObjectKeys(obj: any, excludeKeys?: string[], includeKeys?: string[]): string[];
+export declare function createGlobRegex(search: string): RegExp;
+export declare function deepEquals(lhs: any, rhs: any): boolean;
+export declare function objToString(value: any): string;
+export declare function deepClone(val: any): any;
+export declare function toUniqueArray<T>(arr: T[]): T[];
+export declare function areArraysEqual<T>(arr1: T[] | undefined, arr2: T[] | undefined): boolean;
+export declare function flattenObject(obj: any): any;
+export declare function unflattenObject(flatObj: any): any;

package/dist/esm/data-utils.js

@@ -0,0 +1,84 @@
+import { cloneDeep } from "lodash-es";
+import equal from 'fast-deep-equal';
+export function getObjectKeys(obj, excludeKeys, includeKeys) {
+    if (!obj) {
+        return [];
+    }
+    let sourceKeys = Object.keys(obj);
+    if (includeKeys && !!includeKeys.length) {
+        includeKeys.filter((k) => !sourceKeys.includes(k))
+            .forEach((k) => sourceKeys.push(k));
+    }
+    if (excludeKeys && !!excludeKeys.length) {
+        sourceKeys = sourceKeys.filter((k) => !excludeKeys.includes(k));
+    }
+    return sourceKeys;
+}
+;
+export function createGlobRegex(search) {
+    let pattern = search.replace(/\*/g, ".+");
+    return new RegExp(`^${pattern}$`);
+}
+export function deepEquals(lhs, rhs) {
+    return equal(lhs, rhs);
+}
+export function objToString(value) {
+    return JSON.stringify(value, null, 1);
+}
+export function deepClone(val) {
+    return cloneDeep(val);
+}
+export function toUniqueArray(arr) {
+    return [...new Set(arr)];
+}
+export function areArraysEqual(arr1, arr2) {
+    if (arr1 == null && arr2 == null)
+        return true;
+    if (arr1 == null || arr2 == null)
+        return false;
+    if (arr1.length !== arr2.length)
+        return false;
+    for (let i = 0; i < arr1.length; i++) {
+        if (arr1[i] !== arr2[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+export function flattenObject(obj) {
+    const flatten = {};
+    const path = [];
+    const isObject = (value) => Object(value) === value;
+    function dig(obj) {
+        for (const [key, value] of Object.entries(obj)) {
+            path.push(key);
+            if (isObject(value)) {
+                dig(value);
+            }
+            else {
+                flatten[path.join('.')] = value;
+            }
+            path.pop();
+        }
+    }
+    dig(obj);
+    return flatten;
+}
+export function unflattenObject(flatObj) {
+    const unFlatten = {};
+    for (const [path, value] of Object.entries(flatObj)) {
+        const chain = path.split('.');
+        let object = unFlatten;
+        for (const [i, key] of chain.slice(0, -1).entries()) {
+            if (!object[key]) {
+                const needArray = Number.isInteger(Number(chain[+i + 1]));
+                object[key] = needArray ? [] : {};
+            }
+            object = object[key];
+        }
+        const lastkey = chain.pop();
+        object[lastkey] = value;
+    }
+    return unFlatten;
+}
+//# sourceMappingURL=data-utils.js.map

package/dist/esm/data-utils.js.map

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

package/dist/esm/diff-high.d.ts

@@ -0,0 +1,4 @@
+import { Diff } from "deep-diff";
+export declare function deepDiffFlat(oldFlat: any, newFlat: any, flatten?: boolean): [any, any];
+export declare function deepDiffTyped<T>(lhsObj: T, rhsObj: T): Partial<T>;
+export declare function deepDiffLow<T, S>(lhsObj: T, rhsObj: S, orderInd?: boolean): Diff<T, S>[] | false;

package/dist/esm/diff-high.js

@@ -0,0 +1,48 @@
+import { applyChange, diff, orderIndependentDiff } from "deep-diff";
+import { flattenObject, getObjectKeys } from "./data-utils";
+export function deepDiffFlat(oldFlat, newFlat, flatten = false) {
+    if (flatten) {
+        oldFlat = flattenObject(oldFlat);
+        newFlat = flattenObject(newFlat);
+    }
+    const updated = Object.assign({}, oldFlat);
+    const removed = Object.assign({}, newFlat);
+    for (let key of Object.keys(newFlat)) {
+        if (newFlat[key] === oldFlat[key]) {
+            delete updated[key];
+            delete removed[key];
+        }
+    }
+    return [updated, removed];
+}
+export function deepDiffTyped(lhsObj, rhsObj) {
+    const differences = deepDiffLow(lhsObj, rhsObj);
+    const deltaObj = {};
+    if (!differences) {
+        return deltaObj;
+    }
+    for (const difference of differences) {
+        applyChange(deltaObj, null, difference);
+    }
+    cleanupObjArrays(deltaObj);
+    return deltaObj;
+}
+;
+function cleanupObjArrays(obj) {
+    var _a;
+    for (const objKey of getObjectKeys(obj)) {
+        if ((_a = obj[objKey]) === null || _a === void 0 ? void 0 : _a.filter) {
+            obj[objKey] = obj[objKey].filter((e) => !!e);
+        }
+    }
+}
+export function deepDiffLow(lhsObj, rhsObj, orderInd = false) {
+    const differences = !orderInd
+        ? diff(lhsObj, rhsObj)
+        : orderIndependentDiff(lhsObj, rhsObj);
+    return !(differences === null || differences === void 0 ? void 0 : differences.length)
+        ? false
+        : differences;
+}
+;
+//# sourceMappingURL=diff-high.js.map

package/dist/esm/diff-high.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-high.js","sourceRoot":"","sources":["../../src/diff-high.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,UAAU,YAAY,CACxB,OAAY,EACZ,OAAY,EACZ,OAAO,GAAG,KAAK;IAEf,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE3C,KAAK,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IACD,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CACzB,MAAS,EACT,MAAS;IAET,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACnC,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC;AACpB,CAAC;AAAA,CAAC;AAEF,SAAS,gBAAgB,CAAC,GAAQ;;IAE9B,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,MAAA,GAAG,CAAC,MAAM,CAAC,0CAAE,MAAM,EAAE,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CACvB,MAAS,EACT,MAAS,EACT,WAAoB,KAAK;IAEzB,MAAM,WAAW,GAAG,CAAC,QAAQ;QACzB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;QACtB,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,CAAA;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,WAAW,CAAC;AACtB,CAAC;AAAA,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,13 @@
+export { deepEquals } from "./data-utils";
+export { flattenObject, unflattenObject } from "./data-utils";
+export { deepDiffLow } from "./diff-high";
+export { deepDiffFlat } from "./diff-high";
+export { deepDiffTyped } from "./diff-high";
+export { UpdateCode } from "./merge-low";
+export { updateCodeInfo } from "./merge-low";
+export { MergeError } from "./merge-high";
+export { shallowMerge, immutableMerge } from "./merge-high";
+export { type DetailConfig, detailMerge } from "./merge-high";
+export { diffFromMerge } from "./merge-high";
+export { shallowMerge as merge } from "./merge-high";
+export { deepDiffTyped as diff } from "./diff-high";

package/dist/esm/index.js

@@ -0,0 +1,14 @@
+export { deepEquals } from "./data-utils";
+export { flattenObject, unflattenObject } from "./data-utils";
+export { deepDiffLow } from "./diff-high";
+export { deepDiffFlat } from "./diff-high";
+export { deepDiffTyped } from "./diff-high";
+export { UpdateCode } from "./merge-low";
+export { updateCodeInfo } from "./merge-low";
+export { MergeError } from "./merge-high";
+export { shallowMerge, immutableMerge } from "./merge-high";
+export { detailMerge } from "./merge-high";
+export { diffFromMerge } from "./merge-high";
+export { shallowMerge as merge } from "./merge-high";
+export { deepDiffTyped as diff } from "./diff-high";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAqB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,IAAI,IAAI,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/merge-high.d.ts

@@ -0,0 +1,37 @@
+import { UpdateCode } from "./merge-low";
+export type MergeTypes = string[] | number[] | string | number | boolean;
+export type MergeSafeTuple = {
+    [label: string]: MergeTypes;
+};
+export type MergeTuple = {
+    [label: string]: any;
+};
+export type MergeCode = `${UpdateCode}`;
+export type DetailConfig = {
+    [path: string]: UpdateCode;
+};
+export declare class MergeError extends Error {
+    readonly data: {
+        e: string;
+        n?: string;
+        s: any;
+        v?: string;
+        t?: any;
+    };
+    readonly code = 500;
+    constructor(data: {
+        e: string;
+        n?: string;
+        s: any;
+        v?: string;
+        t?: any;
+    });
+}
+export declare function detailMerge(target: {
+    [key: string]: any;
+}, source: {
+    [key: string]: any;
+}, mergeCodes: DetailConfig): boolean;
+export declare function shallowMerge(target: any, source: any, scalarCode: UpdateCode, vectorCode?: UpdateCode, excludeKeys?: string[], includeKeys?: string[]): boolean;
+export declare function immutableMerge(target: any, source: any, scalarCode: UpdateCode, vectorCode?: UpdateCode): any;
+export declare function diffFromMerge(target: any, source: any, scalarCode: UpdateCode, vectorCode?: UpdateCode): any | false;

package/dist/esm/merge-high.js

@@ -0,0 +1,56 @@
+import { emptyObject, isVectorArray } from "./type-utils";
+import { deepClone, getObjectKeys } from "./data-utils";
+import { mergeScalarField, mergeVectorField } from "./merge-low";
+import { deepDiffTyped } from "./diff-high";
+export class MergeError extends Error {
+    constructor(data) {
+        var _a;
+        super(data.e);
+        this.data = data;
+        this.code = 500;
+        this.name = (_a = data.n) !== null && _a !== void 0 ? _a : 'MergeError';
+    }
+}
+export function detailMerge(target, source, mergeCodes) {
+    const mergeKeys = getObjectKeys(mergeCodes);
+    let changed = false;
+    for (const label of mergeKeys) {
+        const mergeCode = mergeCodes[label];
+        if (mergeCode.toString().startsWith("X")
+            ? mergeVectorField(target, source, label, mergeCode)
+            : mergeScalarField(target, source, label, mergeCode)) {
+            changed = true;
+        }
+    }
+    return changed;
+}
+export function shallowMerge(target, source, scalarCode, vectorCode, excludeKeys, includeKeys) {
+    const sourceKeys = getObjectKeys(source, excludeKeys, includeKeys);
+    if (!(sourceKeys === null || sourceKeys === void 0 ? void 0 : sourceKeys.length)) {
+        return false;
+    }
+    let changed = false;
+    for (const label of sourceKeys) {
+        if (isVectorArray(target[label]) || isVectorArray(source[label])) {
+            if (mergeVectorField(target, source, label, vectorCode !== null && vectorCode !== void 0 ? vectorCode : scalarCode)) {
+                changed = true;
+            }
+            continue;
+        }
+        if (mergeScalarField(target, source, label, scalarCode))
+            changed = true;
+    }
+    return changed;
+}
+export function immutableMerge(target, source, scalarCode, vectorCode) {
+    const targetCopy = deepClone(target);
+    shallowMerge(targetCopy, source, scalarCode, vectorCode);
+    return targetCopy;
+}
+;
+export function diffFromMerge(target, source, scalarCode, vectorCode) {
+    const targetCopy = immutableMerge(target, source, scalarCode, vectorCode);
+    const delta = deepDiffTyped(target, targetCopy);
+    return emptyObject(delta) ? false : delta;
+}
+//# sourceMappingURL=merge-high.js.map

package/dist/esm/merge-high.js.map

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

package/dist/esm/merge-low.d.ts

@@ -0,0 +1,25 @@
+export declare enum UpdateCode {
+    T = "T",
+    C = "C",
+    N = "N",
+    Y = "Y",
+    B = "B",
+    U = "U",
+    H = "H",
+    I = "I",
+    D = "D",
+    XR = "XR",
+    XM = "XM",
+    XD = "XD",
+    XI = "XI",
+    XS = "XS",
+    XF = "XF"
+}
+export declare function updateCodeInfo(mergeCode: UpdateCode): {
+    insert: boolean;
+    update: boolean;
+    unset: boolean;
+    enable: boolean;
+};
+export declare function mergeScalarField(target: any, source: any, label: string, mergeCode: UpdateCode): boolean;
+export declare function mergeVectorField(target: any, source: any, label: string, mergeCode: UpdateCode): boolean;

package/dist/esm/merge-low.js

@@ -0,0 +1,160 @@
+import { differenceWith, intersectionWith, unionWith, isEqual } from "lodash-es";
+import { isArrayOfAny, isNullish } from "./type-utils";
+import { areArraysEqual, deepClone } from "./data-utils";
+export var UpdateCode;
+(function (UpdateCode) {
+    UpdateCode["T"] = "T";
+    UpdateCode["C"] = "C";
+    UpdateCode["N"] = "N";
+    UpdateCode["Y"] = "Y";
+    UpdateCode["B"] = "B";
+    UpdateCode["U"] = "U";
+    UpdateCode["H"] = "H";
+    UpdateCode["I"] = "I";
+    UpdateCode["D"] = "D";
+    UpdateCode["XR"] = "XR";
+    UpdateCode["XM"] = "XM";
+    UpdateCode["XD"] = "XD";
+    UpdateCode["XI"] = "XI";
+    UpdateCode["XS"] = "XS";
+    UpdateCode["XF"] = "XF";
+})(UpdateCode || (UpdateCode = {}));
+export function updateCodeInfo(mergeCode) {
+    const allowUnset = [
+        UpdateCode.Y, UpdateCode.D, UpdateCode.U,
+        UpdateCode.XR, UpdateCode.XD, UpdateCode.XI
+    ]
+        .includes(mergeCode);
+    const allowInsert = [
+        UpdateCode.Y, UpdateCode.I, UpdateCode.B,
+        UpdateCode.XR, UpdateCode.XM, UpdateCode.XS, UpdateCode.XF
+    ]
+        .includes(mergeCode);
+    const allowUpdate = [
+        UpdateCode.Y, UpdateCode.H, UpdateCode.U, UpdateCode.B
+    ]
+        .includes(mergeCode)
+        || mergeCode.startsWith("X");
+    return {
+        insert: allowInsert,
+        update: allowUpdate,
+        unset: allowUnset,
+        enable: allowInsert || allowUpdate || allowUnset,
+    };
+}
+export function mergeScalarField(target, source, label, mergeCode) {
+    const sourceHas = !isNullish(source[label]);
+    const targetHas = target.hasOwnProperty(label);
+    if (!targetHas && !sourceHas) {
+        return false;
+    }
+    if (targetHas && sourceHas) {
+        if (typeof target[label] !== typeof source[label]) {
+            throw new TypeError("field type mismatch for " + label);
+        }
+        if (target[label] === source[label]) {
+            return false;
+        }
+    }
+    let migrateVal = false;
+    switch (mergeCode) {
+        case UpdateCode.N:
+            return false;
+        case UpdateCode.Y:
+            target[label] = source[label];
+            return true;
+        case UpdateCode.B:
+            if (sourceHas)
+                migrateVal = true;
+            break;
+        case UpdateCode.U:
+            if (targetHas)
+                migrateVal = true;
+            break;
+        case UpdateCode.I:
+            if (!targetHas)
+                migrateVal = true;
+            break;
+        case UpdateCode.H:
+            if (targetHas && sourceHas)
+                migrateVal = true;
+            break;
+        case UpdateCode.D:
+            if (targetHas && !sourceHas)
+                migrateVal = true;
+            break;
+        case UpdateCode.XR:
+        case UpdateCode.XS:
+        case UpdateCode.XF:
+        case UpdateCode.XM:
+        case UpdateCode.XD:
+        case UpdateCode.XI:
+            return mergeVectorField(target, source, label, mergeCode);
+    }
+    if (migrateVal) {
+        if (sourceHas) {
+            target[label] = deepClone(source[label]);
+        }
+        else {
+            delete target[label];
+        }
+        return true;
+    }
+    return false;
+}
+;
+export function mergeVectorField(target, source, label, mergeCode) {
+    let sourceVals = source[label];
+    if (isNullish(sourceVals)) {
+        return false;
+    }
+    let sourceVec = isArrayOfAny(sourceVals);
+    const targetHas = target.hasOwnProperty(label);
+    const targetVec = isArrayOfAny(target[label]);
+    if (targetHas && !targetVec) {
+        throw new TypeError("type change to vector for " + label);
+    }
+    if (!sourceVec) {
+        sourceVals = [sourceVals];
+        sourceVec = true;
+    }
+    let targetVals;
+    switch (mergeCode) {
+        case UpdateCode.N:
+            return false;
+        case UpdateCode.Y:
+        case UpdateCode.XR:
+            target[label] = deepClone(sourceVals);
+            return true;
+        case UpdateCode.XS:
+            if (!targetHas)
+                target[label] = [];
+            target[label].push(...sourceVals);
+            return true;
+        case UpdateCode.XF:
+            if (!targetHas)
+                target[label] = [];
+            target[label].unshift(...sourceVals);
+            return true;
+        case UpdateCode.B:
+        case UpdateCode.XM:
+            targetVals = unionWith(target[label], sourceVals, isEqual);
+            break;
+        case UpdateCode.XD:
+            targetVals = differenceWith(target[label], sourceVals, isEqual);
+            break;
+        case UpdateCode.XI:
+            targetVals = intersectionWith(target[label], sourceVals, isEqual);
+            break;
+        default:
+            return false;
+    }
+    if (!(targetVals === null || targetVals === void 0 ? void 0 : targetVals.length)) {
+        delete target[label];
+        return true;
+    }
+    const changed = !areArraysEqual(targetVals, target[label]);
+    target[label] = targetVals;
+    return changed;
+}
+//# sourceMappingURL=merge-low.js.map

package/dist/esm/merge-low.js.map

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

package/dist/esm/type-utils.d.ts

@@ -0,0 +1,24 @@
+export type PrimitiveType = "string" | "number" | "boolean";
+export type Primitive = string | number | boolean;
+export type PrimitiveArray = string[] | number[] | boolean[];
+export type VectorArray = string[] | number[];
+export type ObjectKeys<T> = keyof T;
+export type ObjectVals<T> = T[keyof T];
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export declare function isString(value: any): value is string;
+export declare function isNumber(value: any): value is number;
+export declare function isBoolean(value: any): value is boolean;
+export declare function isPrimitive(value: any): value is Primitive;
+export declare function isNullish(value: any): boolean;
+export declare function emptyString(str: string): boolean;
+export declare function integerString(str: string): boolean;
+export declare function isRegExp(value: any): value is RegExp;
+export declare function isObject(value: any): boolean;
+export declare function emptyObject(obj: object): boolean;
+export declare function isArrayOfAny(value: any): value is any[];
+export declare function emptyArray(arr: any): boolean;
+export declare function isArrayOf<T>(arr: any, typeCheck: (item: any) => item is T): arr is T[];
+export declare function isArrayOfSame(arr: any): string | false;
+export declare function isVectorArray(arr: any): arr is VectorArray;

package/dist/esm/type-utils.js

@@ -0,0 +1,60 @@
+export function isString(value) {
+    return typeof value === 'string';
+}
+export function isNumber(value) {
+    return typeof value === 'number';
+}
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+export function isPrimitive(value) {
+    return ['string', 'number', 'boolean'].includes(typeof value);
+}
+export function isNullish(value) {
+    return value === undefined || value === null;
+}
+export function emptyString(str) {
+    return (str == null)
+        || (str === '')
+        || (/^\s*$/.test(str));
+}
+export function integerString(str) {
+    return ((str != null)
+        && (str !== '')
+        && Number.isSafeInteger(Number(str.toString())));
+}
+export function isRegExp(value) {
+    return value instanceof RegExp;
+}
+export function isObject(value) {
+    return typeof value === 'object'
+        && !Array.isArray(value)
+        && value !== null;
+}
+export function emptyObject(obj) {
+    return (obj === undefined)
+        || (obj === null)
+        || (!Object.keys(obj).length);
+}
+export function isArrayOfAny(value) {
+    return Array.isArray(value);
+}
+export function emptyArray(arr) {
+    return Array.isArray(arr) && !(arr === null || arr === void 0 ? void 0 : arr.length);
+}
+export function isArrayOf(arr, typeCheck) {
+    return Array.isArray(arr)
+        && arr.length > 0
+        && arr.every(typeCheck);
+}
+export function isArrayOfSame(arr) {
+    return Array.isArray(arr)
+        && new Set(arr.map((e) => typeof e)).size === 1
+        ? typeof arr[0] : false;
+}
+export function isVectorArray(arr) {
+    return Array.isArray(arr)
+        && new Set(arr.map((e) => typeof e)).size === 1
+        && ['string', 'number'].includes(typeof arr[0]);
+}
+//# sourceMappingURL=type-utils.js.map

package/dist/esm/type-utils.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "datum-merge",
+	"version": "0.3.1-alpha",
+	"author": "Rohit Kulkarni <rohk@live.com>",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/therohk/datum-merge.git"
+	},
+	"license": "MIT",
+	"description": "Simplified diff and merging for deeply nested objects.",
+	"keywords": ["merge", "diff", "compare", "patch", "update"],
+	"main": "dist/esm/index.js",
+	"types": "dist/esm/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"engines": {
+		"node": "^20",
+		"npm": ">=10"
+	},
+	"scripts": {
+		"lint": "npx eslint src",
+		"pretty": "prettier -c src",
+		"scantask": "findstr /s /i todo src\\*.*",
+		"test": "jest",
+		"build:esm": "tsc",
+		"build:cjs": "tsc --module CommonJS --outDir dist/cjs",
+		"build": "run-s test build:*",
+		"compile": "tsc -noEmit -skipLibCheck",
+		"cyccheck": "dpdm --exit-code circular:1 --no-tree ./src"
+	},
+	"devDependencies": {
+		"@types/node": "^16.11.6",
+		"@typescript-eslint/eslint-plugin": "5.62.0",
+		"@typescript-eslint/parser": "5.62.0",
+		"@types/lodash": "^4.14.169",
+		"@types/deep-diff": "^1.0.5",
+		"@types/lodash-es": "^4.17.12",
+		"@types/jest": "^29.5.2",
+		"eslint": "^8.0.1",
+		"prettier": "^3.1.0",
+		"npm-run-all2": "^6.2.0",
+		"jest": "^29.7.0",
+		"ts-jest": "^29.1.0",
+		"ts-node": "^10.9.2",
+		"tslib": "2.4.0",
+		"typescript": "5.4.5",
+		"lodash": "^4.17.21"
+	},
+	"dependencies": {
+		"fast-deep-equal": "^3.1.3",
+		"lodash-es": "^4.17.21",
+		"deep-diff": "^1.0.2"
+	}
+}