sfdx-git-delta 6.41.2 → 6.43.0

package/lib/utils/txmlAdapter.js

@@ -0,0 +1,121 @@
+'use strict';
+// txml ships .d.ts via `tXml.d.ts` but its package.json `exports` map only
+// re-exports the runtime entry, so TypeScript can't pick the declarations
+// up automatically. Declare the slice we use explicitly.
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-expect-error -- type declarations not exposed via package exports
+import { parse as txmlParse } from 'txml';
+import { ATTRIBUTE_PREFIX, XML_HEADER_ATTRIBUTE_KEY, } from './xmlHelper.js';
+const COMMENT_KEY = '#comment';
+const COMMENT_PREFIX = '<!--';
+const COMMENT_SUFFIX = '-->';
+const isComment = (child) => typeof child === 'string' && child.startsWith(COMMENT_PREFIX);
+const isText = (child) => typeof child === 'string' && !child.startsWith(COMMENT_PREFIX);
+const stripComment = (raw) => raw.slice(COMMENT_PREFIX.length, raw.length - COMMENT_SUFFIX.length);
+const renderAttributes = (attributes) => {
+    const out = {};
+    for (const key of Object.keys(attributes)) {
+        const value = attributes[key];
+        // FlexXMLParser emitted boolean attributes (no value) as `true`; txml
+        // emits them as `null`. Map back to `true` so downstream code (and the
+        // xmlWriter, which renders `attr="value"` from the value's `String(...)`
+        // representation) keeps the same shape.
+        out[`${ATTRIBUTE_PREFIX}${key}`] = value === null ? true : value;
+    }
+    return out;
+};
+// `addChild(out, key, child)` collapses repeated tag names at the same
+// depth into an array — first repeat upgrades the slot from scalar to
+// array, subsequent repeats append.
+const addChild = (out, key, child) => {
+    const existing = out[key];
+    if (existing === undefined) {
+        out[key] = child;
+        return;
+    }
+    if (Array.isArray(existing)) {
+        existing.push(child);
+        return;
+    }
+    out[key] = [existing, child];
+};
+const addComment = (out, text) => {
+    const existing = out[COMMENT_KEY];
+    if (existing === undefined) {
+        out[COMMENT_KEY] = text;
+        return;
+    }
+    if (Array.isArray(existing)) {
+        existing.push(text);
+        return;
+    }
+    out[COMMENT_KEY] = [existing, text];
+};
+// Convert a single tNode into the value our compact format uses for it.
+// Three cases:
+//   - empty element  → {} (so xmlWriter emits `<tag></tag>`)
+//   - text-only leaf → primitive string
+//   - everything else (attributes, children, mixed) → XmlContent object
+export const tNodeToXmlContent = (node) => {
+    const attributes = renderAttributes(node.attributes);
+    const hasAttributes = Object.keys(attributes).length > 0;
+    if (node.children.length === 0) {
+        return hasAttributes ? attributes : {};
+    }
+    // Text-only leaf: a single text child and no attributes collapse to the
+    // primitive string. Attributes-bearing leaves keep object form so the
+    // writer can render them with attributes.
+    if (!hasAttributes &&
+        node.children.length === 1 &&
+        isText(node.children[0])) {
+        return node.children[0];
+    }
+    const out = { ...attributes };
+    for (const child of node.children) {
+        if (isComment(child)) {
+            addComment(out, stripComment(child));
+            continue;
+        }
+        if (typeof child === 'string') {
+            // Mixed content (text + elements) is rare in our payloads but kept
+            // verbatim so a future use case isn't silently dropped.
+            addChild(out, '#text', child);
+            continue;
+        }
+        addChild(out, child.tagName, tNodeToXmlContent(child));
+    }
+    return out;
+};
+/**
+ * Parses XML text into our compact JSON shape. Empty input short-circuits
+ * to `{}`; malformed input (parse throws) is swallowed and also yields
+ * `{}` — preserving the existing `xml2Json` contract.
+ */
+export const parseXml = (xmlContent) => {
+    if (!xmlContent)
+        return {};
+    try {
+        const tree = txmlParse(xmlContent, {
+            keepComments: true,
+        });
+        const out = {};
+        for (const child of tree) {
+            if (isComment(child)) {
+                addComment(out, stripComment(child));
+                continue;
+            }
+            if (typeof child === 'string')
+                continue; // top-level whitespace
+            if (child.tagName === XML_HEADER_ATTRIBUTE_KEY) {
+                out[XML_HEADER_ATTRIBUTE_KEY] = renderAttributes(child.attributes);
+                continue;
+            }
+            addChild(out, child.tagName, tNodeToXmlContent(child));
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+};
+//# sourceMappingURL=txmlAdapter.js.map

package/lib/utils/txmlAdapter.js.map

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

package/lib/utils/xmlHelper.d.ts

@@ -1,8 +1,3 @@
-import type { Config } from '../types/config.js';
-import type { FileGitRef } from '../types/git.js';
 export type XmlContent = Record<string, unknown>;
-export declare const xml2Json: (xmlContent: string) => XmlContent;
-export declare const parseXmlFileToJson: (forRef: FileGitRef, config: Config) => Promise<XmlContent>;
-export declare const convertJsonToXml: (jsonContent: XmlContent | unknown) => string;
 export declare const ATTRIBUTE_PREFIX = "@_";
 export declare const XML_HEADER_ATTRIBUTE_KEY = "?xml";

package/lib/utils/xmlHelper.js

@@ -1,61 +1,4 @@
 'use strict';
-import FlexXMLParser from '@nodable/flexible-xml-parser';
-import XMLBuilder from 'fast-xml-builder';
-import { readPathFromGit } from './fsHelper.js';
-const XML_PARSER_OPTION = {
-    skip: {
-        attributes: false,
-        nsPrefix: false,
-        comment: false,
-        declaration: false,
-    },
-    nameFor: {
-        comment: '#comment',
-    },
-    attributes: {
-        prefix: '@_',
-        valueParsers: [],
-    },
-    tags: {
-        valueParsers: ['trim'],
-    },
-};
-// processEntities MUST stay false: FlexXMLParser keeps XML entities raw in the
-// parsed JSON (e.g. "a & b" → "a & b", not "a & b"). Flipping this to
-// true makes XMLBuilder re-encode the already-raw entities, producing
-// double-encoded output like "a & b". Parser-builder symmetry matters.
-const JSON_PARSER_OPTION = {
-    commentPropName: '#comment',
-    ignoreAttributes: false,
-    ignoreNameSpace: false,
-    parseTagValue: false,
-    parseNodeValue: false,
-    parseAttributeValue: false,
-    trimValues: true,
-    processEntities: false,
-    format: true,
-    indentBy: '    ',
-    suppressBooleanAttributes: false,
-    suppressEmptyNode: false,
-};
-const xmlParser = new FlexXMLParser(XML_PARSER_OPTION);
-const xmlBuilder = new XMLBuilder(JSON_PARSER_OPTION);
-export const xml2Json = (xmlContent) => {
-    if (!xmlContent) {
-        return {};
-    }
-    try {
-        return xmlParser.parse(xmlContent);
-    }
-    catch {
-        return {};
-    }
-};
-export const parseXmlFileToJson = async (forRef, config) => {
-    const xmlContent = await readPathFromGit(forRef, config);
-    return xml2Json(xmlContent);
-};
-export const convertJsonToXml = (jsonContent) => xmlBuilder.build(jsonContent);
 export const ATTRIBUTE_PREFIX = '@_';
 export const XML_HEADER_ATTRIBUTE_KEY = '?xml';
 //# sourceMappingURL=xmlHelper.js.map

package/lib/utils/xmlHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"xmlHelper.js","sourceRoot":"","sources":["../../src/utils/xmlHelper.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,aAAkC,MAAM,8BAA8B,CAAA;AAC7E,OAAO,UAAU,MAAM,kBAAkB,CAAA;AAKzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAI/C,MAAM,iBAAiB,GAAe;IACpC,IAAI,EAAE;QACJ,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,KAAK;KACnB;IACD,OAAO,EAAE;QACP,OAAO,EAAE,UAAU;KACpB;IACD,UAAU,EAAE;QACV,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,EAAe;KAC9B;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,CAAC,MAAM,CAAc;KACpC;CACY,CAAA;AACf,+EAA+E;AAC/E,8EAA8E;AAC9E,sEAAsE;AACtE,+EAA+E;AAC/E,MAAM,kBAAkB,GAAG;IACzB,eAAe,EAAE,UAAU;IAC3B,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,KAAK;IACtB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,KAAK;IAC1B,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,KAAK;IACtB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,MAAM;IAChB,yBAAyB,EAAE,KAAK;IAChC,iBAAiB,EAAE,KAAK;CACzB,CAAA;AAED,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,iBAAiB,CAAC,CAAA;AACtD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAA;AAErD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAc,EAAE;IACzD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,KAAK,CAAC,UAAU,CAAe,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,MAAkB,EAClB,MAAc,EACO,EAAE;IACvB,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxD,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAA;AAC7B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAiC,EAAU,EAAE,CAC5E,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;AAE/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAA"}
+{"version":3,"file":"xmlHelper.js","sourceRoot":"","sources":["../../src/utils/xmlHelper.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAIZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAA"}

package/messages/delta.md

@@ -76,6 +76,10 @@ file listing paths to explicitly include for any destructive actions
 
 file containing additional metadata definitions to add to the registry
 
+# flags.changes-manifest.summary
+
+path to a JSON file grouping changed components by kind (add, modify, delete, rename); setting this flag also enables git rename detection
+
 # error.ParameterIsNotGitSHA
 
 --%s is not a valid sha pointer: '%s' (If in CI/CD context, check the fetch depth is properly set)
@@ -84,6 +88,14 @@ file containing additional metadata definitions to add to the registry
 
 '%s' is not a git repository
 
+# error.ChangesManifestNotAFile
+
+--changes-manifest must point to a file path, '%s' already exists and is not a regular file
+
+# error.ChangesManifestStatFailed
+
+--changes-manifest: cannot inspect '%s': %s
+
 # warning.ApiVersionOverridden
 
 API version '%s' is not supported, using '%s' instead