@pdfbutler/migration-cli 0.0.27 → 0.0.29

package/lib/commands/butler/pb/exportdatasource.d.ts

@@ -0,0 +1,28 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type ButlerPbExportdatasourceResult = {
+    path: string;
+};
+export default class ButlerPbExportdatasource extends SfCommand<ButlerPbExportdatasourceResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        target: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        id: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        folder: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'auth-env-var': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        endpoint: import("@oclif/core/lib/interfaces").OptionFlag<import("node:url").URL | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        stage: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        logs: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        parents: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        session: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        instance: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    private static readonly dataSourcesFolderName;
+    private static isLogsActive;
+    private static getDataSourceIds;
+    private static exportDataSource;
+    private static saveDataSource;
+    private static exportDataSourceWithParents;
+    run(): Promise<ButlerPbExportdatasourceResult>;
+}

package/lib/commands/butler/pb/exportdatasource.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = require("path");
+const node_fs_1 = require("node:fs");
+const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
+const core_1 = require("@salesforce/core");
+const logger_1 = require("../../../utils/logger");
+const constants_1 = require("../../../utils/constants");
+const authentication_1 = require("../../../utils/authentication");
+core_1.Messages.importMessagesDirectory(__dirname);
+const messages = core_1.Messages.loadMessages('@pdfbutler/migration-cli', 'butler.pb.exportdatasource');
+class ButlerPbExportdatasource extends sf_plugins_core_1.SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        target: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.target.summary'),
+            char: 't',
+            required: false,
+        }),
+        id: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.id.summary'),
+            char: 'i',
+            required: true,
+        }),
+        folder: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.folder.summary'),
+            // eslint-disable-next-line sf-plugin/dash-o
+            char: 'f',
+            required: true,
+        }),
+        'auth-env-var': sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.auth-env-var.summary'),
+            char: 'a',
+        }),
+        endpoint: sf_plugins_core_1.Flags.url({
+            summary: messages.getMessage('flags.endpoint.summary'),
+            char: 'e',
+        }),
+        stage: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.stage.summary'),
+            char: 's',
+            required: true,
+        }),
+        logs: sf_plugins_core_1.Flags.boolean({
+            summary: messages.getMessage('flags.logs.summary'),
+            char: 'l',
+        }),
+        parents: sf_plugins_core_1.Flags.boolean({
+            summary: messages.getMessage('flags.parents.summary'),
+            char: 'p',
+        }),
+        session: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.session.summary'),
+        }),
+        instance: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.instance.summary'),
+        }),
+    };
+    static dataSourcesFolderName = 'dataSources';
+    static isLogsActive = false;
+    static getDataSourceIds(id) {
+        logger_1.Logger.info(constants_1.MESSAGE.START_SPLIT_DATA_SOURCES, this.isLogsActive);
+        const tokens = id.split(/[\s,]+/).map((item) => item.trim()).filter(Boolean);
+        const dataSourceIds = tokens.filter((token) => constants_1.PATTERN.DATA_SOURCE_ID.test(token));
+        logger_1.Logger.info(constants_1.MESSAGE.SPLITTED_DATA_SOURCES_LIST.replace('[VALUE]', JSON.stringify(dataSourceIds, null, 2)), this.isLogsActive);
+        if (dataSourceIds.length <= 0) {
+            throw new Error(constants_1.ERROR.NO_MATCHING_DATA_SOURCES);
+        }
+        return dataSourceIds;
+    }
+    static async exportDataSource(connection, dataSourceId) {
+        try {
+            logger_1.Logger.info(constants_1.MESSAGE.FETCH_DATA, this.isLogsActive);
+            const endpoint = `${constants_1.PATH.EXPORT_DATA_SOURCE}${dataSourceId}`;
+            const response = await connection.apex.get(endpoint);
+            logger_1.Logger.success(constants_1.MESSAGE.FETCH_DATA_SUCCESS, this.isLogsActive);
+            return response;
+        }
+        catch (error) {
+            logger_1.Logger.error(constants_1.MESSAGE.FETCH_DATA_FAILED.replace('[ID]', dataSourceId), true);
+            throw new Error(constants_1.ERROR.EXPORT_DATA_SOURCE_FAILED);
+        }
+    }
+    static async saveDataSource(outputDir, dataSourceId, data) {
+        const dirName = path.join(outputDir, 'sfdc');
+        const filePath = path.join(dirName, `${dataSourceId}.json`);
+        await node_fs_1.promises.mkdir(dirName, { recursive: true });
+        await node_fs_1.promises.writeFile(filePath, JSON.stringify(data, null, 2));
+        return filePath;
+    }
+    static async exportDataSourceWithParents(connection, outputDir, dataSourceId, exportedIds, autoExportParents, logAsStandalone = false, isParentExport = false) {
+        if (exportedIds.has(dataSourceId)) {
+            return 0;
+        }
+        if (logAsStandalone) {
+            const exportMessage = isParentExport && autoExportParents
+                ? constants_1.MESSAGE.EXPORTING_PARENT_DATA_SOURCE
+                : constants_1.MESSAGE.EXPORTING_DATA_SOURCE;
+            logger_1.Logger.info(exportMessage
+                .replace('[INDEX]', '1')
+                .replace('[TOTAL]', '1')
+                .replace('[ID]', dataSourceId), true);
+        }
+        const dataSource = await this.exportDataSource(connection, dataSourceId);
+        await this.saveDataSource(outputDir, dataSourceId, dataSource);
+        exportedIds.add(dataSourceId);
+        const payload = dataSource;
+        const parentDataSourceId = payload.parentCustomerDataSourceId?.trim();
+        if (!parentDataSourceId) {
+            return 1;
+        }
+        if (!autoExportParents) {
+            logger_1.Logger.warn(constants_1.MESSAGE.PARENT_DATA_SOURCE_DETECTED_INFO
+                .replace('[ID]', dataSourceId)
+                .replace('[PARENT_ID]', parentDataSourceId) +
+                constants_1.MESSAGE.PARENT_DATA_SOURCE_DETECTED_WARN, true);
+            return 1;
+        }
+        if (exportedIds.has(parentDataSourceId)) {
+            return 1;
+        }
+        logger_1.Logger.info(constants_1.MESSAGE.PARENT_DATA_SOURCE_DETECTED_INFO
+            .replace('[ID]', dataSourceId)
+            .replace('[PARENT_ID]', parentDataSourceId), true);
+        const parentCount = await this.exportDataSourceWithParents(connection, outputDir, parentDataSourceId, exportedIds, autoExportParents, true, true);
+        return 1 + parentCount;
+    }
+    async run() {
+        const { flags } = await this.parse(ButlerPbExportdatasource);
+        ButlerPbExportdatasource.isLogsActive = !!flags.logs;
+        const outputDir = path.join(flags.folder, ButlerPbExportdatasource.dataSourcesFolderName);
+        const targetUsername = flags.target;
+        const session = flags.session;
+        const instance = flags.instance;
+        const autoExportParents = Boolean(flags.parents);
+        let connection;
+        try {
+            connection = (await (0, authentication_1.authenticate)(targetUsername, session, instance));
+        }
+        catch (error) {
+            process.exitCode = 1;
+            return { path: '' };
+        }
+        const dataSourceIds = ButlerPbExportdatasource.getDataSourceIds(flags.id);
+        const total = dataSourceIds.length;
+        const exportedIds = new Set();
+        const exportedCount = await dataSourceIds.reduce(async (accPromise, dataSourceId, index) => {
+            const acc = await accPromise;
+            logger_1.Logger.info(constants_1.MESSAGE.EXPORTING_DATA_SOURCE
+                .replace('[INDEX]', (index + 1).toString())
+                .replace('[TOTAL]', total.toString())
+                .replace('[ID]', dataSourceId), true);
+            return (acc +
+                (await ButlerPbExportdatasource.exportDataSourceWithParents(connection, outputDir, dataSourceId, exportedIds, autoExportParents)));
+        }, Promise.resolve(0));
+        logger_1.Logger.success(constants_1.MESSAGE.EXPORTED_DATA_SOURCES_SUCCESS.replace('[VALUE]', exportedCount.toString()), true);
+        return { path: path.join(outputDir, 'sfdc') };
+    }
+}
+exports.default = ButlerPbExportdatasource;
+//# sourceMappingURL=exportdatasource.js.map

package/lib/commands/butler/pb/exportdatasource.js.map

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

package/lib/commands/butler/pb/exportpack.d.ts

@@ -12,11 +12,26 @@ export default class ButlerPbExportpack extends SfCommand<ButlerPbExportpackResu
         target: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         out: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         logs: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'auth-env-var': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        endpoint: import("@oclif/core/lib/interfaces").OptionFlag<import("node:url").URL | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        stage: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        unzip: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        templates: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        docconfig: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         session: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         instance: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     private static isLogsActive;
+    private static processedDocConfigIds;
+    private static resolveExportDirectories;
     private static exportPackData;
     private static saveToFile;
+    private static exportDocConfigData;
+    private static saveDocConfigToFile;
+    private static saveDocConfigZip;
+    private static saveDocConfigUnzipped;
+    private static fetchBackendZip;
+    private static collectTemplateIdsFromBackend;
+    private static exportDocConfigsByMode;
     run(): Promise<ButlerPbExportpackResult>;
 }

package/lib/commands/butler/pb/exportpack.js

@@ -1,28 +1,131 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable @typescript-eslint/no-var-requires */
-/* eslint-disable @typescript-eslint/no-unsafe-return */
-/* eslint-disable @typescript-eslint/no-unsafe-assignment */
-/* eslint-disable complexity */
-/* eslint-disable @typescript-eslint/no-misused-promises */
-/* eslint-disable @typescript-eslint/no-unsafe-argument */
-/* eslint-disable @typescript-eslint/restrict-template-expressions */
-/* eslint-disable @typescript-eslint/no-unsafe-call */
-/* eslint-disable @typescript-eslint/no-unsafe-member-access */
-/* eslint-disable sf-plugin/no-missing-messages */
-/* eslint-disable @typescript-eslint/prefer-for-of */
-/* eslint-disable no-await-in-loop */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/* eslint-disable no-console */
-const fs_1 = require("fs");
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
 const sf_plugins_core_1 = require("@salesforce/sf-plugins-core");
 const core_1 = require("@salesforce/core");
+const AdmZip = require("adm-zip");
+const got_1 = __importDefault(require("got"));
 const logger_1 = require("../../../utils/logger");
 const constants_1 = require("../../../utils/constants");
 const authentication_1 = require("../../../utils/authentication");
+const ids_1 = require("../../../utils/ids");
+const pack_docconfigs_1 = require("../../../utils/pack-docconfigs");
+const extract_templates_1 = require("../../../utils/extract-templates");
 core_1.Messages.importMessagesDirectory(__dirname);
 const messages = core_1.Messages.loadMessages('@pdfbutler/migration-cli', 'butler.pb.exportpack');
 class ButlerPbExportpack extends sf_plugins_core_1.SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        name: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.name.summary'),
+            description: messages.getMessage('flags.name.description'),
+            char: 'n',
+            required: false,
+        }),
+        pack: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.pack.summary'),
+            char: 'p',
+            required: true,
+        }),
+        target: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.target.summary'),
+            char: 't',
+            required: false,
+        }),
+        out: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.out.summary'),
+            // eslint-disable-next-line sf-plugin/dash-o
+            char: 'o',
+            required: true,
+        }),
+        logs: sf_plugins_core_1.Flags.boolean({
+            summary: messages.getMessage('flags.logs.summary'),
+            char: 'l',
+        }),
+        'auth-env-var': sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.auth-env-var.summary'),
+            char: 'a',
+        }),
+        endpoint: sf_plugins_core_1.Flags.url({
+            summary: messages.getMessage('flags.endpoint.summary'),
+            char: 'e',
+        }),
+        stage: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.stage.summary'),
+            char: 's',
+            required: false,
+        }),
+        unzip: sf_plugins_core_1.Flags.boolean({
+            summary: messages.getMessage('flags.unzip.summary'),
+            char: 'u',
+        }),
+        templates: sf_plugins_core_1.Flags.boolean({
+            summary: messages.getMessage('flags.templates.summary'),
+            char: 'm',
+        }),
+        docconfig: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.docconfig.summary'),
+            options: ['none', 'pack', 'lead', 'full'],
+            default: 'none',
+            required: false,
+            char: 'd',
+        }),
+        session: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.session.summary'),
+        }),
+        instance: sf_plugins_core_1.Flags.string({
+            summary: messages.getMessage('flags.instance.summary'),
+        }),
+    };
+    static isLogsActive = false;
+    static processedDocConfigIds = new Set();
+    static resolveExportDirectories(baseOutputDir) {
+        const normalizedBaseDir = path.resolve(baseOutputDir);
+        return {
+            packsSfdc: path.join(normalizedBaseDir, 'packs', 'sfdc'),
+            docConfigsRoot: path.join(normalizedBaseDir, 'docConfigs'),
+            docConfigsSfdc: path.join(normalizedBaseDir, 'docConfigs', 'sfdc'),
+        };
+    }
     static async exportPackData(connection, packId) {
         const exportUrl = `${constants_1.PATH.EXPORT_PACK}${packId}`;
         try {
@@ -34,7 +137,7 @@ class ButlerPbExportpack extends sf_plugins_core_1.SfCommand {
             if (this.isLogsActive) {
                 const message = error instanceof Error ? error.message : String(error);
                 if (message.includes(constants_1.ERROR.URL_NOT_FOUND)) {
-                    logger_1.Logger.error(`${constants_1.ERROR.URL_NOT_FOUND}. ${constants_1.ERROR.VERSION_TOO_LOW}`);
+                    logger_1.Logger.error(constants_1.ERROR.URL_NOT_FOUND_VERSION_TOO_LOW);
                 }
                 if (message.includes(constants_1.ERROR.ID_NOT_EXIST)) {
                     logger_1.Logger.error(constants_1.ERROR.PACK_NOT_EXIST.replace('[PACK_ID]', packId));
@@ -46,13 +149,10 @@ class ButlerPbExportpack extends sf_plugins_core_1.SfCommand {
     static async saveToFile(directory, filename, data) {
         try {
             logger_1.Logger.info(constants_1.MESSAGE.SAVING_TO_DIRECTORY, this.isLogsActive);
-            const dirName = `./${directory}/sfdc`;
-            logger_1.Logger.info(constants_1.MESSAGE.DIRECTORY_HIERARCHY.replace('[PATH]', dirName), this.isLogsActive);
-            const filePath = `${dirName}/${filename}`;
-            logger_1.Logger.info(constants_1.MESSAGE.FILE_PATH.replace('[PATH]', filePath), this.isLogsActive);
-            await fs_1.promises.mkdir(dirName, { recursive: true });
-            await fs_1.promises.writeFile(filePath, JSON.stringify(data, null, 2));
-            logger_1.Logger.info(constants_1.MESSAGE.SUCCESS_EXPORT_TO.replace('[PATH]', filePath));
+            const filePath = path.join(directory, filename);
+            await node_fs_1.promises.mkdir(directory, { recursive: true });
+            await node_fs_1.promises.writeFile(filePath, JSON.stringify(data, null, 2));
+            logger_1.Logger.success(constants_1.MESSAGE.SUCCESS_EXPORT);
             return filePath;
         }
         catch (error) {
@@ -61,14 +161,158 @@ class ButlerPbExportpack extends sf_plugins_core_1.SfCommand {
             throw new Error(constants_1.ERROR.FAILED_TO_SAVE_FILE);
         }
     }
+    static async exportDocConfigData(connection, docConfigId) {
+        const exportUrl = `${constants_1.PATH.EXPORT_DOC_CONFIG}${docConfigId}`;
+        try {
+            logger_1.Logger.info(constants_1.MESSAGE.CALL_SERVICE);
+            return await connection.apex.get(exportUrl);
+        }
+        catch (error) {
+            if (this.isLogsActive) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (message.includes(constants_1.ERROR.URL_NOT_FOUND)) {
+                    logger_1.Logger.error(constants_1.ERROR.URL_NOT_FOUND_VERSION_TOO_LOW);
+                }
+                if (message.includes(constants_1.ERROR.ID_NOT_EXIST)) {
+                    logger_1.Logger.error(constants_1.ERROR.DOC_CONFIG_NOT_EXIST.replace('[DOC_CONFIG_ID]', docConfigId));
+                }
+            }
+            return null;
+        }
+    }
+    static async saveDocConfigToFile(directory, docConfigId, data) {
+        try {
+            logger_1.Logger.info(constants_1.MESSAGE.SAVING_TO_DIRECTORY, this.isLogsActive);
+            const filePath = path.join(directory, `${docConfigId}.json`);
+            await node_fs_1.promises.mkdir(directory, { recursive: true });
+            await node_fs_1.promises.writeFile(filePath, JSON.stringify(data, null, 2));
+            logger_1.Logger.success(constants_1.MESSAGE.SUCCESS_EXPORT);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.Logger.error(constants_1.ERROR.SAVING.replace('[MESSAGE]', message));
+            throw new Error(constants_1.ERROR.FAILED_TO_SAVE_FILE);
+        }
+    }
+    static async saveDocConfigZip(outputDir, docConfigId, zip, sfdcData) {
+        const zipToExport = new AdmZip();
+        for (const entry of zip.getEntries()) {
+            const entryData = zip.readFile(entry);
+            if (entryData != null) {
+                zipToExport.addFile(entry.entryName, entryData);
+            }
+        }
+        zipToExport.addFile('sfdc/docconfig.json', Buffer.from(JSON.stringify(sfdcData, null, 2)));
+        await node_fs_1.promises.writeFile(path.join(outputDir, `${docConfigId}.zip`), new Uint8Array(zipToExport.toBuffer()));
+        logger_1.Logger.success(constants_1.MESSAGE.ARCHIVE_RECORDED);
+    }
+    static saveDocConfigUnzipped(outputDir, docConfigId, zip) {
+        const extractionPath = path.join(outputDir, docConfigId);
+        zip.extractAllTo(extractionPath, true);
+        logger_1.Logger.success(constants_1.MESSAGE.ARCHIVE_UNZIPPED, this.isLogsActive);
+    }
+    static async fetchBackendZip(docConfigId, flags) {
+        if (!flags.endpoint || !flags['auth-env-var'] || !flags.stage) {
+            return null;
+        }
+        const auth = flags['auth-env-var'];
+        const base64Auth = auth.includes(':') ? Buffer.from(auth, 'utf8').toString('base64') : auth;
+        const finalUrl = `${flags.endpoint.toString()}config/export-config/${flags.stage}/${docConfigId}`;
+        try {
+            const buffer = await (0, got_1.default)(finalUrl, {
+                headers: { Authorization: `Basic ${base64Auth}` },
+            }).buffer();
+            return new AdmZip(buffer);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger_1.Logger.error(message);
+            logger_1.Logger.error(constants_1.MESSAGE.DOC_CONFIG_NO_BACKEND.replace('[VALUE]', docConfigId), this.isLogsActive);
+            return null;
+        }
+    }
+    static async collectTemplateIdsFromBackend(zip, outputDir, docConfigId) {
+        const tempExtractPath = path.join(outputDir, `.temp_${docConfigId}`);
+        zip.extractAllTo(tempExtractPath, true);
+        const templateIds = await (0, extract_templates_1.extractTemplateIds)(tempExtractPath);
+        await node_fs_1.promises.rm(tempExtractPath, { recursive: true, force: true });
+        return templateIds;
+    }
+    static async exportDocConfigsByMode(connection, docConfigsRoot, docConfigsSfdc, packData, mode, packId, flags) {
+        const shouldExportBackend = Boolean(flags.endpoint && flags['auth-env-var'] && flags.stage);
+        const shouldExtractTemplates = Boolean(flags.templates && shouldExportBackend);
+        if (mode !== 'none' && !shouldExportBackend && (flags.unzip || flags.templates)) {
+            logger_1.Logger.error(constants_1.ERROR.EXPORTPACK_DOC_CONFIG_FLAGS_REQUIRED);
+            return;
+        }
+        const initialDocConfigIds = (0, pack_docconfigs_1.getDocConfigIdsByMode)(packData, mode);
+        const docConfigIds = [...initialDocConfigIds];
+        if (docConfigIds.length === 0) {
+            logger_1.Logger.warn(constants_1.MESSAGE.NO_DOC_CONFIGS_IN_PACK.replace('[MODE]', mode).replace('[PACK]', packId));
+            return;
+        }
+        if (ButlerPbExportpack.isLogsActive) {
+            logger_1.Logger.info(constants_1.MESSAGE.DOC_CONFIGS_TO_EXPORT.replace('[DOC_CONFIGS]', docConfigIds.join(', ')));
+        }
+        const processQueue = async () => {
+            const docConfigId = docConfigIds.shift();
+            if (!docConfigId) {
+                return;
+            }
+            if (this.processedDocConfigIds.has(docConfigId)) {
+                await processQueue();
+                return;
+            }
+            logger_1.Logger.info(constants_1.MESSAGE.TRY_EXPORT_DOC_CONFIG.replace('[DOC_CONFIG]', docConfigId));
+            const docConfigData = await ButlerPbExportpack.exportDocConfigData(connection, docConfigId);
+            if (docConfigData == null) {
+                logger_1.Logger.error(constants_1.ERROR.DOC_CONFIG_NOT_EXIST.replace('[DOC_CONFIG_ID]', docConfigId));
+                this.processedDocConfigIds.add(docConfigId);
+                await processQueue();
+                return;
+            }
+            await ButlerPbExportpack.saveDocConfigToFile(docConfigsSfdc, docConfigId, docConfigData);
+            this.processedDocConfigIds.add(docConfigId);
+            if (!shouldExportBackend) {
+                await processQueue();
+                return;
+            }
+            const backendZip = await ButlerPbExportpack.fetchBackendZip(docConfigId, flags);
+            if (!backendZip) {
+                await processQueue();
+                return;
+            }
+            if (flags.unzip) {
+                ButlerPbExportpack.saveDocConfigUnzipped(docConfigsRoot, docConfigId, backendZip);
+            }
+            else {
+                await ButlerPbExportpack.saveDocConfigZip(docConfigsRoot, docConfigId, backendZip, docConfigData);
+            }
+            if (shouldExtractTemplates) {
+                const discoveredTemplateIds = await ButlerPbExportpack.collectTemplateIdsFromBackend(backendZip, docConfigsRoot, docConfigId);
+                const nextBatch = discoveredTemplateIds.filter((id) => !this.processedDocConfigIds.has(id));
+                if (nextBatch.length > 0 && ButlerPbExportpack.isLogsActive) {
+                    logger_1.Logger.info(constants_1.MESSAGE.NEW_TEMPLATES_FOUND.replace('[VALUE]', nextBatch.length.toString()));
+                }
+                for (const templateId of nextBatch) {
+                    docConfigIds.push(templateId);
+                }
+            }
+            await processQueue();
+        };
+        await processQueue();
+    }
     async run() {
-        const { flags } = await this.parse(ButlerPbExportpack);
+        const { flags } = (await this.parse(ButlerPbExportpack));
         const username = flags.target;
         const session = flags.session;
         const instance = flags.instance;
         const packsIds = flags.pack;
         const outputDir = flags.out;
-        ButlerPbExportpack.isLogsActive = flags.logs;
+        const directories = ButlerPbExportpack.resolveExportDirectories(outputDir);
+        const docConfigMode = flags.docconfig;
+        ButlerPbExportpack.isLogsActive = Boolean(flags.logs);
+        ButlerPbExportpack.processedDocConfigIds = new Set();
         if (outputDir.trim().length === 0) {
             logger_1.Logger.error(constants_1.ERROR.OUT_FLAG_REQUIRED);
             return { success: false };
@@ -76,60 +320,30 @@ class ButlerPbExportpack extends sf_plugins_core_1.SfCommand {
         if (ButlerPbExportpack.isLogsActive) {
             logger_1.Logger.info(constants_1.MESSAGE.USERNAME.replace('[USERNAME]', username));
             logger_1.Logger.info(constants_1.MESSAGE.PACKS_TO_EXPORT.replace('[PACKS]', packsIds));
-            logger_1.Logger.info(constants_1.MESSAGE.FOLDER_TO_OUTPUT.replace('[FOLDER]', outputDir));
+            logger_1.Logger.info(constants_1.MESSAGE.DOC_CONFIG_EXPORT_MODE.replace('[MODE]', docConfigMode));
         }
         const connection = await (0, authentication_1.authenticate)(username, session, instance);
-        for (const packId of packsIds.split(',')) {
+        await (0, ids_1.parseCommaSeparatedValues)(packsIds).reduce(async (previous, packId) => {
+            await previous;
             logger_1.Logger.info(constants_1.MESSAGE.TRY_EXPORT_PACK.replace('[PACK]', packId.trim()));
             const trimmedPackId = packId.trim();
             const outputFilename = `${trimmedPackId}.json`;
             const packData = await ButlerPbExportpack.exportPackData(connection, trimmedPackId);
             if (packData == null || packData.length < 1) {
                 logger_1.Logger.error(constants_1.ERROR.PACK_NOT_EXIST.replace('[PACK_ID]', trimmedPackId));
-                continue;
+                return;
             }
-            await ButlerPbExportpack.saveToFile(outputDir, outputFilename, packData);
-        }
+            const shouldExportPack = docConfigMode === 'none' || docConfigMode === 'full';
+            const shouldExportDocConfigs = docConfigMode !== 'none';
+            if (shouldExportPack) {
+                await ButlerPbExportpack.saveToFile(directories.packsSfdc, outputFilename, packData);
+            }
+            if (shouldExportDocConfigs) {
+                await ButlerPbExportpack.exportDocConfigsByMode(connection, directories.docConfigsRoot, directories.docConfigsSfdc, packData, docConfigMode, trimmedPackId, flags);
+            }
+        }, Promise.resolve());
         return { success: true };
     }
 }
-ButlerPbExportpack.summary = messages.getMessage('summary');
-ButlerPbExportpack.description = messages.getMessage('description');
-ButlerPbExportpack.examples = messages.getMessages('examples');
-ButlerPbExportpack.flags = {
-    name: sf_plugins_core_1.Flags.string({
-        summary: messages.getMessage('flags.name.summary'),
-        description: messages.getMessage('flags.name.description'),
-        char: 'n',
-        required: false,
-    }),
-    pack: sf_plugins_core_1.Flags.string({
-        summary: messages.getMessage('flags.pack.summary'),
-        char: 'p',
-        required: true,
-    }),
-    target: sf_plugins_core_1.Flags.string({
-        summary: messages.getMessage('flags.target.summary'),
-        char: 't',
-        required: false,
-    }),
-    out: sf_plugins_core_1.Flags.string({
-        summary: messages.getMessage('flags.out.summary'),
-        // eslint-disable-next-line sf-plugin/dash-o
-        char: 'o',
-        required: true,
-    }),
-    logs: sf_plugins_core_1.Flags.boolean({
-        summary: messages.getMessage('flags.logs.summary'),
-        char: 'l',
-    }),
-    session: sf_plugins_core_1.Flags.string({
-        summary: messages.getMessage('flags.session.summary'),
-    }),
-    instance: sf_plugins_core_1.Flags.string({
-        summary: messages.getMessage('flags.instance.summary'),
-    }),
-};
-ButlerPbExportpack.isLogsActive = false;
 exports.default = ButlerPbExportpack;
 //# sourceMappingURL=exportpack.js.map