sf-decomposer 4.0.0

package/lib/metadata/getPackageDirectories.js

@@ -0,0 +1,50 @@
+'use strict';
+/* eslint-disable no-await-in-loop */
+import { existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { simpleGit } from 'simple-git';
+import { SFDX_PROJECT_FILE_NAME } from '../helpers/constants.js';
+export async function getPackageDirectories(metaDirectory) {
+    const options = {
+        baseDir: process.cwd(),
+        binary: 'git',
+        maxConcurrentProcesses: 6,
+        trimmed: true,
+    };
+    const git = simpleGit(options);
+    const repoRoot = (await git.revparse('--show-toplevel')).trim();
+    const dxConfigPath = resolve(repoRoot, SFDX_PROJECT_FILE_NAME);
+    if (!existsSync(dxConfigPath)) {
+        throw Error(`Salesforce DX Config File does not exist in this path: ${dxConfigPath}`);
+    }
+    const sfdxProjectRaw = await readFile(dxConfigPath, 'utf-8');
+    const sfdxProject = JSON.parse(sfdxProjectRaw);
+    const packageDirectories = sfdxProject.packageDirectories.map((directory) => resolve(repoRoot, directory.path));
+    const metadataPaths = [];
+    for (const directory of packageDirectories) {
+        const filePath = await searchRecursively(directory, metaDirectory);
+        if (filePath !== undefined) {
+            metadataPaths.push(resolve(filePath));
+        }
+    }
+    return metadataPaths;
+}
+async function searchRecursively(dxDirectory, subDirectoryName) {
+    const files = await readdir(dxDirectory);
+    for (const file of files) {
+        const filePath = join(dxDirectory, file);
+        const stats = await stat(filePath);
+        if (stats.isDirectory() && file !== subDirectoryName) {
+            const result = await searchRecursively(filePath, subDirectoryName);
+            if (result) {
+                return result;
+            }
+        }
+        else if (stats.isDirectory() && file === subDirectoryName) {
+            return filePath;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=getPackageDirectories.js.map

package/lib/metadata/getPackageDirectories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPackageDirectories.js","sourceRoot":"","sources":["../../src/metadata/getPackageDirectories.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,qCAAqC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAA+B,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAMjE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,aAAqB;IAC/D,MAAM,OAAO,GAA8B;QACzC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,KAAK;QACb,sBAAsB,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI;KACd,CAAC;IACF,MAAM,GAAG,GAAc,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,0DAA0D,YAAY,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,cAAc,GAAW,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAgB,CAAC;IAC3E,MAAM,kBAAkB,GAAG,WAAW,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAChH,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAuB,MAAM,iBAAiB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACvF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,WAAmB,EAAE,gBAAwB;IAC5E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YACnE,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC5D,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/metadata/getRegistryValuesBySuffix.d.ts

@@ -0,0 +1,9 @@
+interface MetaAttributes {
+    metaSuffix: string;
+    strictDirectoryName: boolean;
+    folderType: string;
+    metadataPaths: string[];
+    uniqueIdElements: string;
+}
+export declare function getRegistryValuesBySuffix(metaSuffix: string, command: string): Promise<MetaAttributes>;
+export {};

package/lib/metadata/getRegistryValuesBySuffix.js

@@ -0,0 +1,38 @@
+'use strict';
+import { RegistryAccess } from '@salesforce/source-deploy-retrieve';
+import { DEFAULT_UNIQUE_ID_ELEMENTS } from '../helpers/constants.js';
+import { getUniqueIdElements } from './getUniqueIdElements.js';
+import { getPackageDirectories } from './getPackageDirectories.js';
+export async function getRegistryValuesBySuffix(metaSuffix, command) {
+    if (metaSuffix === 'object') {
+        throw Error('Custom Objects are not supported by this plugin.');
+    }
+    if (metaSuffix === 'botVersion') {
+        throw Error('`botVersion` suffix should not be used. Please use `bot` to decompose/recompose bot and bot version files.');
+    }
+    const registryAccess = new RegistryAccess();
+    const metadataTypeEntry = registryAccess.getTypeBySuffix(metaSuffix);
+    if (metadataTypeEntry === undefined)
+        throw Error(`Metadata type not found for the given suffix: ${metaSuffix}.`);
+    if (metadataTypeEntry.strategies?.adapter &&
+        ['matchingContentFile', 'digitalExperience', 'mixedContent', 'bundle'].includes(metadataTypeEntry.strategies.adapter)) {
+        throw Error(`Metadata types with ${metadataTypeEntry.strategies.adapter} strategies are not supported by this plugin.`);
+    }
+    let uniqueIdElements;
+    if (command === 'decompose')
+        uniqueIdElements = await getUniqueIdElements(metaSuffix);
+    const metadataPaths = await getPackageDirectories(`${metadataTypeEntry.directoryName}`);
+    if (metadataPaths.length === 0)
+        throw Error(`No directories named ${metadataTypeEntry.directoryName} were found in any package directory.`);
+    const metaAttributes = {
+        metaSuffix: metadataTypeEntry.suffix,
+        strictDirectoryName: metadataTypeEntry.strictDirectoryName,
+        folderType: metadataTypeEntry.folderType,
+        metadataPaths,
+        uniqueIdElements: uniqueIdElements
+            ? `${DEFAULT_UNIQUE_ID_ELEMENTS},${uniqueIdElements}`
+            : DEFAULT_UNIQUE_ID_ELEMENTS,
+    };
+    return metaAttributes;
+}
+//# sourceMappingURL=getRegistryValuesBySuffix.js.map

package/lib/metadata/getRegistryValuesBySuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRegistryValuesBySuffix.js","sourceRoot":"","sources":["../../src/metadata/getRegistryValuesBySuffix.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,cAAc,EAAgB,MAAM,oCAAoC,CAAC;AAElF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAUnE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,UAAkB,EAAE,OAAe;IACjF,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,KAAK,CACT,4GAA4G,CAC7G,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAC5C,MAAM,iBAAiB,GAA6B,cAAc,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAC/F,IAAI,iBAAiB,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,iDAAiD,UAAU,GAAG,CAAC,CAAC;IAEjH,IACE,iBAAiB,CAAC,UAAU,EAAE,OAAO;QACrC,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAC7E,iBAAiB,CAAC,UAAU,CAAC,OAAO,CACrC,EACD,CAAC;QACD,MAAM,KAAK,CACT,uBAAuB,iBAAiB,CAAC,UAAU,CAAC,OAAO,+CAA+C,CAC3G,CAAC;IACJ,CAAC;IAED,IAAI,gBAAoC,CAAC;IACzC,IAAI,OAAO,KAAK,WAAW;QAAE,gBAAgB,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACtF,MAAM,aAAa,GAAa,MAAM,qBAAqB,CAAC,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;IAClG,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM,KAAK,CAAC,wBAAwB,iBAAiB,CAAC,aAAa,uCAAuC,CAAC,CAAC;IAE9G,MAAM,cAAc,GAAG;QACrB,UAAU,EAAE,iBAAiB,CAAC,MAAgB;QAC9C,mBAAmB,EAAE,iBAAiB,CAAC,mBAA8B;QACrE,UAAU,EAAE,iBAAiB,CAAC,UAAoB;QAClD,aAAa;QACb,gBAAgB,EAAE,gBAAgB;YAChC,CAAC,CAAC,GAAG,0BAA0B,IAAI,gBAAgB,EAAE;YACrD,CAAC,CAAC,0BAA0B;KAC/B,CAAC;IACF,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/lib/metadata/getUniqueIdElements.d.ts

@@ -0,0 +1 @@
+export declare function getUniqueIdElements(metaSuffix: string): Promise<string | undefined>;

package/lib/metadata/getUniqueIdElements.js

@@ -0,0 +1,13 @@
+'use strict';
+import { readFile } from 'node:fs/promises';
+export async function getUniqueIdElements(metaSuffix) {
+    const fileContent = await readFile(new URL('./uniqueIdElements.json', import.meta.url), 'utf-8');
+    const jsonData = JSON.parse(fileContent);
+    if (metaSuffix in jsonData) {
+        return jsonData[metaSuffix].uniqueIdElements.join(',');
+    }
+    else {
+        return undefined;
+    }
+}
+//# sourceMappingURL=getUniqueIdElements.js.map

package/lib/metadata/getUniqueIdElements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUniqueIdElements.js","sourceRoot":"","sources":["../../src/metadata/getUniqueIdElements.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,MAAM,WAAW,GAAW,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,yBAAyB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACzG,MAAM,QAAQ,GAAqB,IAAI,CAAC,KAAK,CAAC,WAAW,CAAqB,CAAC;IAE/E,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/lib/metadata/uniqueIdElements.json

@@ -0,0 +1,66 @@
+{
+    "profile": {
+        "uniqueIdElements": [
+            "application",
+            "apexClass",
+            "externalDataSource",
+            "flow",
+            "object",
+            "apexPage",
+            "recordType",
+            "tab",
+            "field",
+            "startAddress",
+            "dataCategoryGroup",
+            "layout",
+            "weekdayStart",
+            "friendlyname"
+        ]
+    },
+    "permissionset": {
+        "uniqueIdElements": [
+            "application",
+            "apexClass",
+            "externalDataSource",
+            "flow",
+            "object",
+            "apexPage",
+            "recordType",
+            "tab",
+            "field"
+        ]
+    },
+    "flow": {
+        "uniqueIdElements": [
+            "apexClass",
+            "object",
+            "field",
+            "layout",
+            "actionName",
+            "targetReference",
+            "assignToReference",
+            "choiceText",
+            "promptText"
+        ]
+    },
+    "globalValueSetTranslation": {
+        "uniqueIdElements": ["masterLabel"]
+    },
+    "standardValueSetTranslation": {
+        "uniqueIdElements": ["masterLabel"]
+    },
+    "bot": {
+        "uniqueIdElements": [
+            "developerName",
+            "stepIdentifier",
+            "invocationActionName",
+            "parameterName",
+            "nlpProviderType",
+            "dialog",
+            "chatButtonName"
+        ]
+    },
+    "marketingappextension": {
+        "uniqueIdElements": ["apiName"]
+    }
+}

package/lib/service/checkLogforErrors.d.ts

@@ -0,0 +1,2 @@
+export declare function readOriginalLogFile(logFile: string): Promise<string[]>;
+export declare function checkLogForErrors(logFile: string, originalLogContents: string[]): Promise<string[]>;

package/lib/service/checkLogforErrors.js

@@ -0,0 +1,29 @@
+'use strict';
+import { readFile } from 'node:fs/promises';
+export async function readOriginalLogFile(logFile) {
+    let originalLog;
+    try {
+        originalLog = (await readFile(logFile, 'utf-8')).split('\n');
+    }
+    catch (err) {
+        originalLog = [];
+    }
+    return originalLog;
+}
+export async function checkLogForErrors(logFile, originalLogContents) {
+    let currentLog;
+    const newErrors = [];
+    try {
+        currentLog = (await readFile(logFile, 'utf-8')).split('\n');
+    }
+    catch (err) {
+        return newErrors;
+    }
+    for (const line of currentLog) {
+        if (!originalLogContents.includes(line) && line.includes('[ERROR]')) {
+            newErrors.push(line);
+        }
+    }
+    return newErrors;
+}
+//# sourceMappingURL=checkLogforErrors.js.map

package/lib/service/checkLogforErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkLogforErrors.js","sourceRoot":"","sources":["../../src/service/checkLogforErrors.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,IAAI,WAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,WAAW,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,mBAA6B;IACpF,IAAI,UAAoB,CAAC;IACzB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,UAAU,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/service/decomposeFileHandler.d.ts

@@ -0,0 +1,7 @@
+export declare function decomposeFileHandler(metaAttributes: {
+    metadataPaths: string[];
+    metaSuffix: string;
+    strictDirectoryName: boolean;
+    folderType: string;
+    uniqueIdElements: string;
+}, prepurge: boolean, postpurge: boolean, debug: boolean, format: string): Promise<void>;

package/lib/service/decomposeFileHandler.js

@@ -0,0 +1,74 @@
+'use strict';
+/* eslint-disable no-await-in-loop */
+import { resolve, join } from 'node:path';
+import { readdir, stat, rm } from 'node:fs/promises';
+import { DisassembleXMLFileHandler, setLogLevel } from 'xml-disassembler';
+import { XmlToYamlDisassembler } from 'xml2yaml-disassembler';
+import { XmlToJsonDisassembler } from 'xml2json-disassembler';
+import { CUSTOM_LABELS_FILE } from '../helpers/constants.js';
+import { moveFiles } from './moveFiles.js';
+export async function decomposeFileHandler(metaAttributes, prepurge, postpurge, debug, format) {
+    const { metadataPaths, metaSuffix, strictDirectoryName, folderType, uniqueIdElements } = metaAttributes;
+    if (debug)
+        setLogLevel('debug');
+    for (const metadataPath of metadataPaths) {
+        if (strictDirectoryName || folderType) {
+            await subDirectoryHandler(metadataPath, uniqueIdElements, prepurge, postpurge, format);
+        }
+        else if (metaSuffix === 'labels') {
+            // do not use the prePurge flag in the xml-disassembler package for labels due to file moving
+            if (prepurge)
+                await prePurgeLabels(metadataPath);
+            const labelFilePath = resolve(metadataPath, CUSTOM_LABELS_FILE);
+            await disassembleHandler(labelFilePath, uniqueIdElements, false, postpurge, format);
+            // move labels from the directory they are created in
+            await moveLabels(metadataPath);
+        }
+        else {
+            await disassembleHandler(metadataPath, uniqueIdElements, prepurge, postpurge, format);
+        }
+    }
+}
+async function disassembleHandler(filePath, uniqueIdElements, prepurge, postpurge, format) {
+    let handler;
+    if (format === 'yaml') {
+        handler = new XmlToYamlDisassembler();
+    }
+    else if (format === 'json') {
+        handler = new XmlToJsonDisassembler();
+    }
+    else {
+        handler = new DisassembleXMLFileHandler();
+    }
+    await handler.disassemble({
+        filePath,
+        uniqueIdElements,
+        prePurge: prepurge,
+        postPurge: postpurge,
+    });
+}
+async function prePurgeLabels(metadataPath) {
+    const subFiles = await readdir(metadataPath);
+    for (const subFile of subFiles) {
+        const subfilePath = join(metadataPath, subFile);
+        if ((await stat(subfilePath)).isFile() && subFile !== CUSTOM_LABELS_FILE) {
+            await rm(subfilePath, { recursive: true });
+        }
+    }
+}
+async function moveLabels(metadataPath) {
+    const sourceDirectory = join(metadataPath, 'CustomLabels', 'labels');
+    const destinationDirectory = metadataPath;
+    await moveFiles(sourceDirectory, destinationDirectory, () => true);
+    await rm(join(metadataPath, 'CustomLabels'), { recursive: true });
+}
+async function subDirectoryHandler(metadataPath, uniqueIdElements, prepurge, postpurge, format) {
+    const subFiles = await readdir(metadataPath);
+    for (const subFile of subFiles) {
+        const subFilePath = join(metadataPath, subFile);
+        if ((await stat(subFilePath)).isDirectory()) {
+            await disassembleHandler(subFilePath, uniqueIdElements, prepurge, postpurge, format);
+        }
+    }
+}
+//# sourceMappingURL=decomposeFileHandler.js.map

package/lib/service/decomposeFileHandler.js.map

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

package/lib/service/moveFiles.d.ts

@@ -0,0 +1 @@
+export declare function moveFiles(sourceDirectory: string, destinationDirectory: string, predicate: (fileName: string) => boolean): Promise<void>;

package/lib/service/moveFiles.js

@@ -0,0 +1,17 @@
+'use strict';
+/* eslint-disable no-await-in-loop */
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { move } from 'fs-extra';
+export async function moveFiles(sourceDirectory, destinationDirectory, predicate) {
+    const files = await readdir(sourceDirectory);
+    for (const file of files) {
+        const fileStat = await stat(join(sourceDirectory, file));
+        if (fileStat.isFile() && predicate(file)) {
+            const sourceFile = join(sourceDirectory, file);
+            const destinationFile = join(destinationDirectory, file);
+            await move(sourceFile, destinationFile, { overwrite: true });
+        }
+    }
+}
+//# sourceMappingURL=moveFiles.js.map

package/lib/service/moveFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveFiles.js","sourceRoot":"","sources":["../../src/service/moveFiles.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,qCAAqC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,eAAuB,EACvB,oBAA4B,EAC5B,SAAwC;IAExC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/service/recomposeFileHandler.d.ts

@@ -0,0 +1,6 @@
+export declare function recomposeFileHandler(metaAttributes: {
+    metaSuffix: string;
+    strictDirectoryName: boolean;
+    folderType: string;
+    metadataPaths: string[];
+}, postpurge: boolean, debug: boolean, format: string): Promise<void>;

package/lib/service/recomposeFileHandler.js

@@ -0,0 +1,82 @@
+'use strict';
+/* eslint-disable no-await-in-loop */
+import { readdir, stat, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ReassembleXMLFileHandler, setLogLevel } from 'xml-disassembler';
+import { YamlToXmlReassembler } from 'xml2yaml-disassembler';
+import { JsonToXmlReassembler } from 'xml2json-disassembler';
+import { CUSTOM_LABELS_FILE } from '../helpers/constants.js';
+import { renameBotVersionFile } from './renameBotVersionFiles.js';
+import { moveFiles } from './moveFiles.js';
+export async function recomposeFileHandler(metaAttributes, postpurge, debug, format) {
+    const { metaSuffix, strictDirectoryName, folderType, metadataPaths } = metaAttributes;
+    if (debug)
+        setLogLevel('debug');
+    for (const metadataPath of metadataPaths) {
+        if (metaSuffix === 'labels') {
+            await reassembleLabels(metadataPath, metaSuffix, postpurge, format);
+        }
+        else {
+            let recurse = false;
+            if (strictDirectoryName || folderType)
+                recurse = true;
+            await reassembleDirectories(metadataPath, metaSuffix, recurse, postpurge, format);
+        }
+        if (metaSuffix === 'bot')
+            await renameBotVersionFile(metadataPath);
+    }
+}
+async function reassembleHandler(filePath, fileExtension, postPurge, format) {
+    let handler;
+    if (format === 'yaml') {
+        handler = new YamlToXmlReassembler();
+    }
+    else if (format === 'json') {
+        handler = new JsonToXmlReassembler();
+    }
+    else {
+        handler = new ReassembleXMLFileHandler();
+    }
+    await handler.reassemble({
+        filePath,
+        fileExtension,
+        postPurge,
+    });
+}
+async function reassembleLabels(metadataPath, metaSuffix, postpurge, format) {
+    let sourceDirectory = metadataPath;
+    let destinationDirectory = join(metadataPath, 'CustomLabels', 'labels');
+    await moveFiles(sourceDirectory, destinationDirectory, (fileName) => fileName !== CUSTOM_LABELS_FILE);
+    // do not use postpurge flag due to file moving
+    await reassembleHandler(join(metadataPath, 'CustomLabels'), `${metaSuffix}-meta.xml`, false, format);
+    sourceDirectory = join(metadataPath, 'CustomLabels', 'labels');
+    destinationDirectory = metadataPath;
+    await moveFiles(sourceDirectory, destinationDirectory, () => true);
+    await rm(join(metadataPath, 'CustomLabels'), { recursive: true });
+    if (postpurge)
+        await deleteFilesInDirectory(destinationDirectory);
+}
+async function deleteFilesInDirectory(directory) {
+    const files = await readdir(directory);
+    for (const file of files) {
+        const filePath = join(directory, file);
+        const fileStat = await stat(filePath);
+        if (fileStat.isFile() && file !== CUSTOM_LABELS_FILE) {
+            await rm(filePath);
+        }
+    }
+}
+async function reassembleDirectories(metadataPath, metaSuffix, recurse, postpurge, format) {
+    const subdirectories = (await readdir(metadataPath)).map((file) => join(metadataPath, file));
+    for (const subdirectory of subdirectories) {
+        const subDirStat = await stat(subdirectory);
+        if (subDirStat.isDirectory() && recurse) {
+            // recursively call this function and set recurse to false
+            await reassembleDirectories(subdirectory, metaSuffix, false, postpurge, format);
+        }
+        else if (subDirStat.isDirectory()) {
+            await reassembleHandler(subdirectory, `${metaSuffix}-meta.xml`, postpurge, format);
+        }
+    }
+}
+//# sourceMappingURL=recomposeFileHandler.js.map

package/lib/service/recomposeFileHandler.js.map

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

package/lib/service/renameBotVersionFiles.d.ts

@@ -0,0 +1 @@
+export declare function renameBotVersionFile(metadataPath: string): Promise<void>;

package/lib/service/renameBotVersionFiles.js

@@ -0,0 +1,23 @@
+'use strict';
+/* eslint-disable no-await-in-loop */
+import { lstat, readdir, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function renameBotVersionFile(metadataPath) {
+    const subDirectories = await readdir(metadataPath);
+    for (const subDirectory of subDirectories) {
+        const subDirectoryPath = join(metadataPath, subDirectory);
+        const stats = await lstat(subDirectoryPath);
+        if (stats.isDirectory()) {
+            const files = await readdir(subDirectoryPath);
+            for (const file of files) {
+                // Check if the bot meta file name contains "v" followed by a number
+                if (/v\d+\.bot-meta\.xml$/.test(file)) {
+                    const sourcePath = join(subDirectoryPath, file);
+                    const destinationPath = join(subDirectoryPath, file.replace('bot-meta.xml', 'botVersion-meta.xml'));
+                    await rename(sourcePath, destinationPath);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=renameBotVersionFiles.js.map

package/lib/service/renameBotVersionFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renameBotVersionFiles.js","sourceRoot":"","sources":["../../src/service/renameBotVersionFiles.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,qCAAqC;AACrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,YAAoB;IAC7D,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,KAAK,MAAM,YAAY,IAAI,cAAc,EAAE,CAAC;QAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAE1D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,oEAAoE;gBACpE,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;oBAChD,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC,CAAC;oBACpG,MAAM,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/messages/decomposer.decompose.md

@@ -0,0 +1,36 @@
+# summary
+
+Decomposes the metadata files created by retrievals.
+
+# description
+
+This command will read all of the original metadata files and separate them into smaller files.
+
+These smaller decomposed files can be XMLs, YAMLs, or JSONs.
+
+You should use this to create files for version control after retrieving metadata from an org.
+
+# examples
+
+- `sf decomposer decompose -m "flow" -f "xml" --prepurge --postpurge --debug`
+- `sf decomposer decompose -m "flow" -m "labels" -f "xml" --prepurge --postpurge --debug`
+
+# flags.metadata-type.summary
+
+The metadata suffix to process, such as 'flow', 'labels', etc. You can provide this flag multiple times to process multiple metadata types at once.
+
+# flags.prepurge.summary
+
+If provided, purge directories of pre-existing decomposed files.
+
+# flags.postpurge.summary
+
+If provided, purge the original files after decomposing them.
+
+# flags.debug.summary
+
+If provided, debug to log file.
+
+# flags.format.summary
+
+File format for the decomposed files.

package/messages/decomposer.recompose.md

@@ -0,0 +1,30 @@
+# summary
+
+Recomposes the files created by the `decompose` command prior to deployments.
+
+# description
+
+This command will read all of the decomposed files and recreate deployment compatible metadata files in each package directory.
+
+You should run this before you deploy the metadata to an org.
+
+# examples
+
+- `sf decomposer recompose -m "flow" -f "xml" --postpurge --debug`
+- `sf decomposer recompose -m "flow" -m "labels" -f "xml" --postpurge --debug`
+
+# flags.metadata-type.summary
+
+The metadata suffix to process, such as 'flow', 'labels', etc. You can provide this flag multiple times to process multiple metadata types at once.
+
+# flags.postpurge.summary
+
+If provided, purge the decomposed files after recomposing them.
+
+# flags.debug.summary
+
+If provided, debug to log file.
+
+# flags.format.summary
+
+File format for the decomposed files.