sfdx-git-delta 6.41.2 → 6.43.0

package/lib/utils/metadataDiff/streamingDiff.js

@@ -0,0 +1,300 @@
+'use strict';
+import { deepEqual } from 'fast-equals';
+import { writeXmlDocument } from './xmlWriter.js';
+const ARRAY_SPECIAL_KEY = '<array>';
+const OBJECT_SPECIAL_KEY = '<object>';
+export const CARDINALITY_SAFETY_LIMIT = 100_000;
+/**
+ * Two-pass streaming diff engine. Pass 1 consumes from-side elements into
+ * per-bucket indexes; Pass 2 classifies to-side elements, emitting manifest
+ * entries (added/modified/deleted) and retaining survivors in prunedBySubType
+ * for later writer-driven output. Deferred buckets (array / object / keyless
+ * / unknown) drain at end of pass.
+ *
+ * Memory bound, per DESIGN.md \xc2\xa75.3: keyed subType indexes shrink during
+ * Pass 2 as matches drain, so peak on that bucket is O(changed_keyed_count).
+ * Deferred buckets (array/object/keyless/unknown) hold every to-side element
+ * of those subTypes until end-of-pass — they are O(element_count) per
+ * subType, capped by CARDINALITY_SAFETY_LIMIT. The writer closure then
+ * captures prunedBySubType and keeps it reachable until the IOExecutor
+ * invokes the writer or the HandlerResult is GC'd.
+ *
+ * The writer closure is not thread-safe against reuse: run() instantiates a
+ * fresh StreamingDiff per call and the writer is expected to fire at most
+ * once. Calling it twice is safe but produces the same bytes.
+ */
+export class StreamingDiff {
+    attributes;
+    generateDelta;
+    passOne = {
+        fromKeyed: new Map(),
+        fromArrays: new Map(),
+        fromObjectFingerprints: new Map(),
+        fromKeyless: new Map(),
+        fromUnknown: new Map(),
+    };
+    passTwo = {
+        toArrays: new Map(),
+        toObjectFingerprints: new Map(),
+        toKeyless: new Map(),
+        toUnknown: new Map(),
+    };
+    prunedBySubType = new Map();
+    // Tracks first-seen-in-to order across all subTypes (keyed + deferred)
+    // so buildWriter emits root children in the same order legacy's
+    // JsonTransformer produced (document order from to-side).
+    toSubTypeOrder = [];
+    seenSubTypes = new Set();
+    added = [];
+    modified = [];
+    deleted = [];
+    hasAnyChanges = false;
+    constructor(attributes, generateDelta) {
+        this.attributes = attributes;
+        this.generateDelta = generateDelta;
+    }
+    onFromElement = (subType, element) => {
+        if (!this.attributes.has(subType)) {
+            this.appendBounded(this.passOne.fromUnknown, subType, element);
+            return;
+        }
+        // Stryker disable next-line OptionalChaining -- defensive: attributes.has gate above guarantees a hit; optional chain is for future-proofing
+        const keyField = this.attributes.get(subType)?.key;
+        if (keyField === undefined) {
+            this.appendBounded(this.passOne.fromKeyless, subType, element);
+            return;
+        }
+        if (keyField === ARRAY_SPECIAL_KEY) {
+            this.appendBounded(this.passOne.fromArrays, subType, element);
+            return;
+        }
+        if (keyField === OBJECT_SPECIAL_KEY) {
+            const set = this.passOne.fromObjectFingerprints.get(subType) ?? new Set();
+            set.add(JSON.stringify(element));
+            this.passOne.fromObjectFingerprints.set(subType, set);
+            this.guardCardinality(set.size, subType);
+            return;
+        }
+        const key = element[keyField];
+        /* v8 ignore next -- defensive: keyed subTypes always have the configured key in well-formed metadata */
+        if (key === undefined)
+            return;
+        const map = this.passOne.fromKeyed.get(subType) ?? new Map();
+        map.set(key, element);
+        this.passOne.fromKeyed.set(subType, map);
+        this.guardCardinality(map.size, subType);
+    };
+    onToElement = (subType, element) => {
+        this.trackToOrder(subType);
+        if (!this.attributes.has(subType)) {
+            this.appendBounded(this.passTwo.toUnknown, subType, element);
+            return;
+        }
+        // Stryker disable next-line OptionalChaining -- defensive: attributes.has gate above guarantees a hit
+        const keyField = this.attributes.get(subType)?.key;
+        if (keyField === undefined) {
+            this.appendBounded(this.passTwo.toKeyless, subType, element);
+            return;
+        }
+        if (keyField === ARRAY_SPECIAL_KEY) {
+            this.appendBounded(this.passTwo.toArrays, subType, element);
+            return;
+        }
+        if (keyField === OBJECT_SPECIAL_KEY) {
+            this.appendObjectFingerprint(subType, element);
+            return;
+        }
+        this.classifyKeyedElement(subType, element, keyField);
+    };
+    trackToOrder(subType) {
+        if (this.seenSubTypes.has(subType))
+            return;
+        this.seenSubTypes.add(subType);
+        this.toSubTypeOrder.push(subType);
+    }
+    finalize() {
+        this.drainArrays();
+        this.drainObjectFingerprints();
+        this.drainKeyless();
+        this.drainUnknown();
+        this.drainDeletions();
+        return {
+            added: this.added,
+            modified: this.modified,
+            deleted: this.deleted,
+            hasAnyChanges: this.hasAnyChanges,
+            isEmpty: this.prunedBySubType.size === 0,
+        };
+    }
+    buildWriter(rootCapture) {
+        if (!this.generateDelta || !this.hasAnyChanges || !rootCapture) {
+            return undefined;
+        }
+        // No surviving children means the pruned output is just the empty
+        // root tag, which legacy treated as "do not emit". Skipping here keeps
+        // delete-only files out of the delta output entirely.
+        if (this.prunedBySubType.size === 0)
+            return undefined;
+        const rootChildren = this.collectRootChildren(rootCapture);
+        return async (out) => {
+            // Per-file pruned XML retains the legacy trailing newline (matches
+            // convertJsonToXml output). Manifest writer (PackageBuilder) uses the
+            // trimmed variant — see DESIGN.md \xc2\xa75.5.1.
+            await writeXmlDocument(out, rootCapture, rootChildren);
+        };
+    }
+    collectRootChildren(_rootCapture) {
+        const entries = [];
+        for (const subType of this.toSubTypeOrder) {
+            const elements = this.prunedBySubType.get(subType);
+            /* v8 ignore next -- defensive: trackToOrder is paired with retainSubTypeElement, so prunedBySubType is always populated for tracked subTypes */
+            if (!elements || elements.length === 0)
+                continue;
+            entries.push([subType, elements]);
+        }
+        return entries;
+    }
+    classifyKeyedElement(subType, element, keyField) {
+        const key = element[keyField];
+        /* v8 ignore next -- defensive: keyed subTypes always have the configured key in well-formed metadata */
+        if (key === undefined)
+            return;
+        const fromMap = this.passOne.fromKeyed.get(subType);
+        const fromElem = fromMap?.get(key);
+        if (fromMap === undefined || fromElem === undefined) {
+            this.recordAdded(subType, key);
+            this.retainSubTypeElement(subType, element);
+            return;
+        }
+        fromMap.delete(key);
+        if (deepEqual(fromElem, element))
+            return;
+        this.recordModified(subType, key);
+        this.retainSubTypeElement(subType, element);
+    }
+    recordAdded(subType, member) {
+        this.hasAnyChanges = true;
+        if (this.isPackageable(subType)) {
+            this.added.push({ type: this.xmlNameOf(subType), member });
+        }
+    }
+    recordModified(subType, member) {
+        this.hasAnyChanges = true;
+        if (this.isPackageable(subType)) {
+            this.modified.push({ type: this.xmlNameOf(subType), member });
+        }
+    }
+    isPackageable(subType) {
+        // Stryker disable next-line OptionalChaining -- defensive: callers gate via attributes.has so the entry is always present
+        return !this.attributes.get(subType)?.excluded;
+    }
+    xmlNameOf(subType) {
+        // Stryker disable next-line OptionalChaining,LogicalOperator -- defensive: every tracked subType has an xmlName in the registry; the optional chain + nullish-coalesce is unreachable in practice
+        /* v8 ignore next */
+        return this.attributes.get(subType)?.xmlName ?? '';
+    }
+    retainSubTypeElement(subType, element) {
+        if (!this.generateDelta)
+            return;
+        let existing = this.prunedBySubType.get(subType);
+        if (existing === undefined) {
+            existing = [];
+            this.prunedBySubType.set(subType, existing);
+        }
+        existing.push(element);
+    }
+    drainArrays() {
+        for (const [subType, toArr] of this.passTwo.toArrays.entries()) {
+            const fromArr = this.passOne.fromArrays.get(subType) ?? [];
+            if (!deepEqual(fromArr, toArr)) {
+                this.hasAnyChanges = true;
+                if (this.generateDelta)
+                    this.prunedBySubType.set(subType, toArr);
+            }
+        }
+    }
+    drainObjectFingerprints() {
+        for (const [subType, toArr,] of this.passTwo.toObjectFingerprints.entries()) {
+            const fromSet = this.passOne.fromObjectFingerprints.get(subType) ?? new Set();
+            const retained = [];
+            for (const [element, fingerprint] of toArr) {
+                if (!fromSet.has(fingerprint))
+                    retained.push(element);
+            }
+            if (retained.length > 0) {
+                this.hasAnyChanges = true;
+                if (this.generateDelta)
+                    this.prunedBySubType.set(subType, retained);
+            }
+        }
+    }
+    drainKeyless() {
+        for (const [subType, toArr] of this.passTwo.toKeyless.entries()) {
+            const fromArr = this.passOne.fromKeyless.get(subType) ?? [];
+            const changed = fromArr.length === 0 || !deepEqual(fromArr, toArr);
+            if (changed)
+                this.hasAnyChanges = true;
+            // Legacy JsonTransformer retains keyless content unconditionally when
+            // toMeta is non-empty (matches getPartialContentWithoutKey). Keep that
+            // behavior for byte-equality.
+            if (this.generateDelta && toArr.length > 0) {
+                this.prunedBySubType.set(subType, toArr);
+            }
+        }
+    }
+    drainUnknown() {
+        for (const [subType, toArr] of this.passTwo.toUnknown.entries()) {
+            const fromArr = this.passOne.fromUnknown.get(subType) ?? [];
+            const changed = fromArr.length === 0 || !deepEqual(fromArr, toArr);
+            if (changed)
+                this.hasAnyChanges = true;
+            if (this.generateDelta && toArr.length > 0) {
+                this.prunedBySubType.set(subType, toArr);
+            }
+        }
+    }
+    drainDeletions() {
+        for (const [subType, remaining] of this.passOne.fromKeyed.entries()) {
+            if (remaining.size === 0)
+                continue;
+            if (!this.isPackageable(subType))
+                continue;
+            // Stryker disable next-line OptionalChaining -- defensive: fromKeyed is only populated for subTypes with a configured key
+            const keyField = this.attributes.get(subType)?.key;
+            /* v8 ignore next -- defensive: passOne.fromKeyed is only populated for subTypes whose key field is defined */
+            if (keyField === undefined)
+                continue;
+            for (const [, element] of remaining.entries()) {
+                this.recordDeleted(subType, element[keyField]);
+            }
+        }
+    }
+    recordDeleted(subType, member) {
+        this.hasAnyChanges = true;
+        this.deleted.push({ type: this.xmlNameOf(subType), member });
+    }
+    appendBounded(bucket, subType, element) {
+        let list = bucket.get(subType);
+        if (list === undefined) {
+            list = [];
+            bucket.set(subType, list);
+        }
+        list.push(element);
+        this.guardCardinality(list.length, subType);
+    }
+    appendObjectFingerprint(subType, element) {
+        let list = this.passTwo.toObjectFingerprints.get(subType);
+        if (list === undefined) {
+            list = [];
+            this.passTwo.toObjectFingerprints.set(subType, list);
+        }
+        list.push([element, JSON.stringify(element)]);
+        this.guardCardinality(list.length, subType);
+    }
+    guardCardinality(size, subType) {
+        if (size > CARDINALITY_SAFETY_LIMIT) {
+            throw new Error(`cardinality safety limit exceeded for ${subType}`);
+        }
+    }
+}
+//# sourceMappingURL=streamingDiff.js.map

package/lib/utils/metadataDiff/streamingDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingDiff.js","sourceRoot":"","sources":["../../../src/utils/metadataDiff/streamingDiff.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAGZ,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAMvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,iBAAiB,GAAG,SAAS,CAAA;AACnC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAA;AAmC/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,aAAa;IA0BL;IACA;IA1BF,OAAO,GAAmB;QACzC,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,sBAAsB,EAAE,IAAI,GAAG,EAAE;QACjC,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,WAAW,EAAE,IAAI,GAAG,EAAE;KACvB,CAAA;IACgB,OAAO,GAAmB;QACzC,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,oBAAoB,EAAE,IAAI,GAAG,EAAE;QAC/B,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,SAAS,EAAE,IAAI,GAAG,EAAE;KACrB,CAAA;IACgB,eAAe,GAAG,IAAI,GAAG,EAAwB,CAAA;IAClE,uEAAuE;IACvE,gEAAgE;IAChE,0DAA0D;IACzC,cAAc,GAAa,EAAE,CAAA;IAC7B,YAAY,GAAG,IAAI,GAAG,EAAU,CAAA;IAChC,KAAK,GAAmB,EAAE,CAAA;IAC1B,QAAQ,GAAmB,EAAE,CAAA;IAC7B,OAAO,GAAmB,EAAE,CAAA;IACrC,aAAa,GAAG,KAAK,CAAA;IAE7B,YACmB,UAA2C,EAC3C,aAAsB;QADtB,eAAU,GAAV,UAAU,CAAiC;QAC3C,kBAAa,GAAb,aAAa,CAAS;IACtC,CAAC;IAEG,aAAa,GAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACjE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC9D,OAAM;QACR,CAAC;QACD,6IAA6I;QAC7I,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAA;QAClD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC9D,OAAM;QACR,CAAC;QACD,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC7D,OAAM;QACR,CAAC;QACD,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YACpC,MAAM,GAAG,GACP,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAU,CAAA;YACvE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;YAChC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YACrD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACxC,OAAM;QACR,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAuB,CAAA;QACnD,wGAAwG;QACxG,IAAI,GAAG,KAAK,SAAS;YAAE,OAAM;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;QAC5D,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACrB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC,CAAA;IAEM,WAAW,GAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC/D,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QACD,sGAAsG;QACtG,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAA;QAClD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QACD,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC3D,OAAM;QACR,CAAC;QACD,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YACpC,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC9C,OAAM;QACR,CAAC;QACD,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACvD,CAAC,CAAA;IAEO,YAAY,CAAC,OAAe;QAClC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAM;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC9B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAEM,QAAQ;QAIb,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,CAAC,uBAAuB,EAAE,CAAA;QAC9B,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,CAAC,cAAc,EAAE,CAAA;QACrB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;SACzC,CAAA;IACH,CAAC;IAEM,WAAW,CAAC,WAA+B;QAChD,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/D,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,kEAAkE;QAClE,uEAAuE;QACvE,sDAAsD;QACtD,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAA;QAC1D,OAAO,KAAK,EAAE,GAAa,EAAE,EAAE;YAC7B,mEAAmE;YACnE,sEAAsE;YACtE,iDAAiD;YACjD,MAAM,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;QACxD,CAAC,CAAA;IACH,CAAC;IAEO,mBAAmB,CAAC,YAAyB;QACnD,MAAM,OAAO,GAAwB,EAAE,CAAA;QACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAClD,gJAAgJ;YAChJ,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;QACnC,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,oBAAoB,CAC1B,OAAe,EACf,OAAmB,EACnB,QAAgB;QAEhB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAuB,CAAA;QACnD,wGAAwG;QACxG,IAAI,GAAG,KAAK,SAAS;YAAE,OAAM;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACnD,MAAM,QAAQ,GAAG,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC9B,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC3C,OAAM;QACR,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnB,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;YAAE,OAAM;QACxC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAEO,WAAW,CAAC,OAAe,EAAE,MAAc;QACjD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,OAAe,EAAE,MAAc;QACpD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,0HAA0H;QAC1H,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;IAChD,CAAC;IAEO,SAAS,CAAC,OAAe;QAC/B,kMAAkM;QAClM,oBAAoB;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;IACpD,CAAC;IAEO,oBAAoB,CAAC,OAAe,EAAE,OAAmB;QAC/D,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAM;QAC/B,IAAI,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,GAAG,EAAE,CAAA;YACb,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC7C,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAEO,WAAW;QACjB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YAC1D,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;gBACzB,IAAI,IAAI,CAAC,aAAa;oBAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,uBAAuB;QAC7B,KAAK,MAAM,CACT,OAAO,EACP,KAAK,EACN,IAAI,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAU,CAAA;YACvE,MAAM,QAAQ,GAAiB,EAAE,CAAA;YACjC,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,KAAK,EAAE,CAAC;gBAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACvD,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;gBACzB,IAAI,IAAI,CAAC,aAAa;oBAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAClE,IAAI,OAAO;gBAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YACtC,sEAAsE;YACtE,uEAAuE;YACvE,8BAA8B;YAC9B,IAAI,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAClE,IAAI,OAAO;gBAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YACtC,IAAI,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACpE,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;gBAAE,SAAQ;YAClC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;gBAAE,SAAQ;YAC1C,0HAA0H;YAC1H,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAA;YAClD,8GAA8G;YAC9G,IAAI,QAAQ,KAAK,SAAS;gBAAE,SAAQ;YACpC,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9C,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAW,CAAC,CAAA;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAe,EAAE,MAAc;QACnD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9D,CAAC;IAEO,aAAa,CACnB,MAAiC,EACjC,OAAe,EACf,OAAmB;QAEnB,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,EAAE,CAAA;YACT,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAClB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAEO,uBAAuB,CAAC,OAAe,EAAE,OAAmB;QAClE,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACzD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,EAAE,CAAA;YACT,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAEO,gBAAgB,CAAC,IAAY,EAAE,OAAe;QACpD,IAAI,IAAI,GAAG,wBAAwB,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;CACF"}

package/lib/utils/metadataDiff/xmlEventReader.d.ts

@@ -0,0 +1,28 @@
+import { type XmlContent } from '../xmlHelper.js';
+export type RootCapture = {
+    xmlHeader: XmlContent | undefined;
+    rootKey: string;
+    rootAttributes: Record<string, string>;
+};
+export type SubTypeElementHandler = (subType: string, element: XmlContent) => void;
+/**
+ * Parses the `from`-side blob for streaming diff ingestion. Errors and
+ * empty/missing sources resolve to `null` — preserving the ADDITION path
+ * where a missing `from` is treated as "no prior content" rather than a
+ * failure.
+ *
+ * Emits `onElement(subType, element)` per direct-child element of the
+ * document root, parsed one at a time via txml's parseNode primitive.
+ * Peak resident memory stays bounded by the largest single child rather
+ * than the full document because each parsed subtree is released as soon
+ * as onElement returns and the cursor advances.
+ */
+export declare const parseFromSideSwallowing: (source: Buffer | string | null | undefined, onElement: SubTypeElementHandler) => Promise<RootCapture | null>;
+/**
+ * Parses the `to`-side blob for streaming diff ingestion. Parse errors
+ * propagate so the caller's `MalformedXML` warning path fires.
+ *
+ * Emits `onElement(subType, element)` per direct-child element of the
+ * document root.
+ */
+export declare const parseToSidePropagating: (source: Buffer | string, onElement: SubTypeElementHandler) => Promise<RootCapture>;

package/lib/utils/metadataDiff/xmlEventReader.js

@@ -0,0 +1,221 @@
+'use strict';
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-expect-error -- txml does not re-export its .d.ts via package.json exports
+import { parse as txmlParse } from 'txml';
+import { getErrorMessage } from '../errorUtils.js';
+import { Logger, lazy } from '../LoggingService.js';
+import { tNodeToXmlContent, } from '../txmlAdapter.js';
+import { ATTRIBUTE_PREFIX, XML_HEADER_ATTRIBUTE_KEY, } from '../xmlHelper.js';
+const XML_DECL_RE = /^\s*<\?xml\b[^?]*\?>/;
+const COMMENT_RE = /^<!--[\s\S]*?-->/;
+const WS_RE = /^\s+/;
+const ROOT_OPEN_RE = /<([A-Za-z_:][\w.:-]*)([^>]*)>/y;
+const parseDeclaration = (decl) => {
+    const tree = txmlParse(decl);
+    const declNode = tree.find((n) => typeof n !== 'string' && n.tagName === XML_HEADER_ATTRIBUTE_KEY);
+    if (!declNode)
+        return { [XML_HEADER_ATTRIBUTE_KEY]: {} };
+    const headerAttrs = {};
+    for (const key of Object.keys(declNode.attributes)) {
+        const value = declNode.attributes[key];
+        headerAttrs[`${ATTRIBUTE_PREFIX}${key}`] = value === null ? true : value;
+    }
+    return { [XML_HEADER_ATTRIBUTE_KEY]: headerAttrs };
+};
+// Walks the prologue (BOM, optional declaration, leading whitespace,
+// comments, and `<!...>` declarations such as DOCTYPE) and stops at the
+// root opening tag. Returns the root name, its attributes, the byte
+// offset where the root's body starts so the streaming loop can pick up
+// from there, and whether the root is self-closing.
+const parsePrologue = (xml) => {
+    let i = 0;
+    let xmlHeader;
+    const declMatch = XML_DECL_RE.exec(xml);
+    if (declMatch && declMatch.index === 0) {
+        xmlHeader = parseDeclaration(declMatch[0]);
+        i += declMatch[0].length;
+    }
+    while (i < xml.length) {
+        const wsMatch = WS_RE.exec(xml.slice(i));
+        if (wsMatch) {
+            i += wsMatch[0].length;
+            continue;
+        }
+        const commentMatch = COMMENT_RE.exec(xml.slice(i));
+        if (commentMatch) {
+            i += commentMatch[0].length;
+            continue;
+        }
+        // `<!...>` declarations (DOCTYPE, ENTITY, etc.) before the root.
+        // Naive boundary at the next `>` — none of our metadata payloads use
+        // bracketed internal subsets, so a more elaborate scan would be
+        // unused work.
+        if (xml.startsWith('<!', i) && !xml.startsWith('<!--', i)) {
+            const end = xml.indexOf('>', i + 2);
+            if (end < 0)
+                return null;
+            i = end + 1;
+            continue;
+        }
+        break;
+    }
+    ROOT_OPEN_RE.lastIndex = i;
+    const rootMatch = ROOT_OPEN_RE.exec(xml);
+    if (!rootMatch || rootMatch.index !== i)
+        return null;
+    const [full, rootName, attrsRaw] = rootMatch;
+    const isSelfClosing = attrsRaw.trimEnd().endsWith('/');
+    const bodyStart = i + full.length;
+    // Reuse txml to parse just the root open tag's attributes consistently
+    // with how it parses every other tag. Wrapping it as self-closing gives
+    // us a clean parse target that always returns one node.
+    const synthetic = isSelfClosing
+        ? `<${rootName}${attrsRaw.replace(/\/\s*$/, '')}/>`
+        : `<${rootName}${attrsRaw}/>`;
+    const syntheticTree = txmlParse(synthetic);
+    const syntheticNode = syntheticTree.find((n) => typeof n !== 'string');
+    const rootAttributes = {};
+    if (syntheticNode) {
+        for (const key of Object.keys(syntheticNode.attributes)) {
+            const value = syntheticNode.attributes[key];
+            // Boolean attributes round-trip as "true" so the writer's
+            // `attr="value"` template renders them consistently.
+            rootAttributes[`${ATTRIBUTE_PREFIX}${key}`] =
+                value === null ? 'true' : value;
+        }
+    }
+    return {
+        xmlHeader,
+        rootName: rootName,
+        rootAttributes,
+        bodyStart,
+        isSelfClosing,
+    };
+};
+// One-shot per-element parse via txml's parseNode primitive. We loop
+// from bodyStart to the closing root tag, parsing exactly one direct
+// child per iteration and emitting it through onElement before advancing
+// the cursor. txml returns the parsed subtree fully built — but we drop
+// our reference after onElement, so peak resident memory stays bounded
+// by the largest single child rather than the full document.
+//
+// Returns the cursor position where the loop exited so the strict-mode
+// caller can verify the root close tag and reject trailing content.
+const streamRootChildren = (xml, bodyStart, onElement) => {
+    let pos = bodyStart;
+    while (pos < xml.length) {
+        const lt = xml.indexOf('<', pos);
+        /* v8 ignore next 4 -- defensive: well-formed XML always has the closing root tag, so '<' is reachable until the </Root> marker exits the loop below */
+        if (lt < 0) {
+            pos = xml.length;
+            break;
+        }
+        if (xml.startsWith('</', lt)) {
+            pos = lt;
+            break;
+        }
+        if (xml.startsWith('<!--', lt)) {
+            const end = xml.indexOf('-->', lt + 4);
+            pos = end < 0 ? xml.length : end + 3;
+            continue;
+        }
+        const res = txmlParse(xml, {
+            pos: lt,
+            parseNode: true,
+            setPos: true,
+            keepComments: true,
+        });
+        onElement(res.tagName, tNodeToXmlContent(res));
+        pos = res.pos;
+    }
+    return pos;
+};
+// Strict-mode tail check: confirms the document closes with `</rootName>`
+// (or is a self-closing root) and that only whitespace or comments
+// follow. Covers what txml itself is too tolerant to flag — unclosed
+// roots, multi-root documents, trailing junk after the root close.
+const verifyTail = (xml, pos, rootName, isSelfClosing) => {
+    let i = pos;
+    if (!isSelfClosing) {
+        const expected = `</${rootName}>`;
+        if (!xml.startsWith(expected, i)) {
+            throw new Error(`unclosed or mismatched root <${rootName}> at offset ${i}`);
+        }
+        i += expected.length;
+    }
+    while (i < xml.length) {
+        const ch = xml[i];
+        if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r') {
+            i++;
+            continue;
+        }
+        if (xml.startsWith('<!--', i)) {
+            const end = xml.indexOf('-->', i + 4);
+            if (end < 0)
+                throw new Error('unterminated comment after root close');
+            i = end + 3;
+            continue;
+        }
+        throw new Error(`unexpected content after root close: ${xml.slice(i, Math.min(i + 30, xml.length))}`);
+    }
+};
+const driveParse = (source, onElement, options) => {
+    const payload = typeof source === 'string' ? source : source.toString('utf8');
+    const prologue = parsePrologue(payload);
+    if (prologue === null)
+        return null;
+    const endPos = prologue.isSelfClosing
+        ? prologue.bodyStart
+        : streamRootChildren(payload, prologue.bodyStart, onElement);
+    // Strict mode (to-side): confirm the input closes cleanly so the
+    // MalformedXML warning path in the diff caller fires. Inner mismatches
+    // already throw via txml's per-child parseNode. The swallowing path
+    // skips this — its caller already discards errors and falls back to
+    // "no prior content", so a partial parse is acceptable there.
+    if (options.strict) {
+        verifyTail(payload, endPos, prologue.rootName, prologue.isSelfClosing);
+    }
+    return {
+        xmlHeader: prologue.xmlHeader,
+        rootKey: prologue.rootName,
+        rootAttributes: prologue.rootAttributes,
+    };
+};
+/**
+ * Parses the `from`-side blob for streaming diff ingestion. Errors and
+ * empty/missing sources resolve to `null` — preserving the ADDITION path
+ * where a missing `from` is treated as "no prior content" rather than a
+ * failure.
+ *
+ * Emits `onElement(subType, element)` per direct-child element of the
+ * document root, parsed one at a time via txml's parseNode primitive.
+ * Peak resident memory stays bounded by the largest single child rather
+ * than the full document because each parsed subtree is released as soon
+ * as onElement returns and the cursor advances.
+ */
+export const parseFromSideSwallowing = async (source, onElement) => {
+    if (!source)
+        return null;
+    try {
+        return driveParse(source, onElement, { strict: false });
+    }
+    catch (error) {
+        Logger.debug(lazy `parseFromSideSwallowing failed: ${() => getErrorMessage(error)}`);
+        return null;
+    }
+};
+/**
+ * Parses the `to`-side blob for streaming diff ingestion. Parse errors
+ * propagate so the caller's `MalformedXML` warning path fires.
+ *
+ * Emits `onElement(subType, element)` per direct-child element of the
+ * document root.
+ */
+export const parseToSidePropagating = async (source, onElement) => {
+    const capture = driveParse(source, onElement, { strict: true });
+    if (capture === null) {
+        throw new Error('to-side document has no root element');
+    }
+    return capture;
+};
+//# sourceMappingURL=xmlEventReader.js.map

package/lib/utils/metadataDiff/xmlEventReader.js.map

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

package/lib/utils/metadataDiff/xmlWriter.d.ts

@@ -0,0 +1,17 @@
+import type { Writable } from 'node:stream';
+import type { RootCapture } from './xmlEventReader.js';
+type ElementEntry = readonly [key: string, value: unknown];
+export type WriteOptions = {
+    trailingNewline?: boolean;
+};
+/**
+ * Streams a generic XML document to `out`. Iterative depth-first traversal
+ * with an explicit LIFO frame stack — safe under unexpectedly-deep input,
+ * cancellation-friendly, back-pressure aware via drain-await per chunk.
+ *
+ * Output is byte-identical to `fast-xml-builder` when given the same
+ * attribute prefix, comment key, and entity-passthrough (processEntities:
+ * false) conventions as the rest of the project. See DESIGN.md \xc2\xa75.5.1.
+ */
+export declare const writeXmlDocument: (out: Writable, rootCapture: RootCapture, rootChildren: ElementEntry[], options?: WriteOptions) => Promise<void>;
+export {};