@salesforce/b2c-cli 0.0.0-nightly.20260119053920

package/dist/commands/code/deploy.js

@@ -0,0 +1,141 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Flags } from '@oclif/core';
+import { uploadCartridges, deleteCartridges, getActiveCodeVersion, reloadCodeVersion, } from '@salesforce/b2c-tooling-sdk/operations/code';
+import { CartridgeCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { t } from '../../i18n/index.js';
+export default class CodeDeploy extends CartridgeCommand {
+    static args = {
+        ...CartridgeCommand.baseArgs,
+    };
+    static description = t('commands.code.deploy.description', 'Deploy cartridges to a B2C Commerce instance');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> ./my-cartridges',
+        '<%= config.bin %> <%= command.id %> --server my-sandbox.demandware.net --code-version v1',
+        '<%= config.bin %> <%= command.id %> --reload',
+        '<%= config.bin %> <%= command.id %> --delete --reload',
+        '<%= config.bin %> <%= command.id %> -c app_storefront_base -c plugin_applepay',
+        '<%= config.bin %> <%= command.id %> -x test_cartridge',
+    ];
+    static flags = {
+        ...CartridgeCommand.baseFlags,
+        ...CartridgeCommand.cartridgeFlags,
+        reload: Flags.boolean({
+            char: 'r',
+            description: 'Reload (re-activate) code version after deploy',
+            default: false,
+        }),
+        delete: Flags.boolean({
+            description: 'Delete existing cartridges before upload',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireWebDavCredentials();
+        this.requireOAuthCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        let version = this.resolvedConfig.values.codeVersion;
+        // If no code version specified, discover the active one
+        if (!version) {
+            this.warn(t('commands.code.deploy.noCodeVersion', 'No code version specified, discovering active code version...'));
+            const activeVersion = await getActiveCodeVersion(this.instance);
+            if (!activeVersion?.id) {
+                this.error(t('commands.code.deploy.noActiveVersion', 'No active code version found. Specify one with --code-version.'));
+            }
+            version = activeVersion.id;
+            // Update the instance config so findAndDeployCartridges uses it
+            this.instance.config.codeVersion = version;
+        }
+        // Create lifecycle context
+        const context = this.createContext('code:deploy', {
+            cartridgePath: this.cartridgePath,
+            hostname,
+            codeVersion: version,
+            reload: this.flags.reload,
+            delete: this.flags.delete,
+            ...this.cartridgeOptions,
+        });
+        // Run beforeOperation hooks - check for skip
+        const beforeResult = await this.runBeforeHooks(context);
+        if (beforeResult.skip) {
+            this.log(t('commands.code.deploy.skipped', 'Deployment skipped: {{reason}}', {
+                reason: beforeResult.skipReason || 'skipped by plugin',
+            }));
+            return {
+                cartridges: [],
+                codeVersion: version,
+                reloaded: false,
+            };
+        }
+        // Find cartridges using providers (supports custom discovery plugins)
+        const cartridges = await this.findCartridgesWithProviders();
+        if (cartridges.length === 0) {
+            this.error(t('commands.code.deploy.noCartridges', 'No cartridges found in {{path}}', { path: this.cartridgePath }));
+        }
+        this.logger?.info({ path: this.cartridgePath, server: hostname, codeVersion: version }, t('commands.code.deploy.deploying', 'Deploying {{path}} to {{hostname}} ({{version}})', {
+            path: this.cartridgePath,
+            hostname,
+            version,
+        }));
+        // Log found cartridges
+        for (const c of cartridges) {
+            this.logger?.debug({ cartridgeName: c.name, path: c.src }, `  ${c.name}`);
+        }
+        try {
+            // Optionally delete existing cartridges first
+            if (this.flags.delete) {
+                await deleteCartridges(this.instance, cartridges);
+            }
+            // Upload cartridges
+            await uploadCartridges(this.instance, cartridges);
+            // Optionally reload code version
+            let reloaded = false;
+            if (this.flags.reload) {
+                try {
+                    await reloadCodeVersion(this.instance, version);
+                    reloaded = true;
+                }
+                catch (error) {
+                    this.logger?.debug(`Could not reload code version: ${error instanceof Error ? error.message : error}`);
+                }
+            }
+            const result = {
+                cartridges,
+                codeVersion: version,
+                reloaded,
+            };
+            this.logger?.info({ codeVersion: result.codeVersion, cartridgeCount: result.cartridges.length }, t('commands.code.deploy.summary', 'Deployed {{count}} cartridge(s) to {{codeVersion}}', {
+                count: result.cartridges.length,
+                codeVersion: result.codeVersion,
+            }));
+            if (result.reloaded) {
+                this.log(t('commands.code.deploy.reloaded', 'Code version reloaded'));
+            }
+            // Run afterOperation hooks with success
+            await this.runAfterHooks(context, {
+                success: true,
+                duration: Date.now() - context.startTime,
+                data: result,
+            });
+            return result;
+        }
+        catch (error) {
+            // Run afterOperation hooks with failure
+            await this.runAfterHooks(context, {
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                duration: Date.now() - context.startTime,
+            });
+            if (error instanceof Error) {
+                this.error(t('commands.code.deploy.failed', 'Deployment failed: {{message}}', { message: error.message }));
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/dist/commands/code/deploy.js.map

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

package/dist/commands/code/list.d.ts

@@ -0,0 +1,8 @@
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type CodeVersionResult } from '@salesforce/b2c-tooling-sdk/operations/code';
+export default class CodeList extends InstanceCommand<typeof CodeList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<CodeVersionResult>;
+}

package/dist/commands/code/list.js

@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { ux } from '@oclif/core';
+import { InstanceCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
+import { listCodeVersions } from '@salesforce/b2c-tooling-sdk/operations/code';
+import { t } from '../../i18n/index.js';
+const COLUMNS = {
+    id: {
+        header: 'ID',
+        get: (v) => v.id || '-',
+    },
+    active: {
+        header: 'Active',
+        get: (v) => (v.active ? 'Yes' : 'No'),
+    },
+    rollback: {
+        header: 'Rollback',
+        get: (v) => (v.rollback ? 'Yes' : 'No'),
+    },
+    lastModified: {
+        header: 'Last Modified',
+        get: (v) => (v.last_modification_time ? new Date(v.last_modification_time).toLocaleString() : '-'),
+    },
+    cartridges: {
+        header: 'Cartridges',
+        get: (v) => String(v.cartridges?.length ?? 0),
+    },
+};
+const DEFAULT_COLUMNS = ['id', 'active', 'rollback', 'lastModified', 'cartridges'];
+export default class CodeList extends InstanceCommand {
+    static description = t('commands.code.list.description', 'List code versions on a B2C Commerce instance');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --server my-sandbox.demandware.net',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    async run() {
+        this.requireOAuthCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        this.log(t('commands.code.list.fetching', 'Fetching code versions from {{hostname}}...', { hostname }));
+        const versions = await listCodeVersions(this.instance);
+        const result = {
+            count: versions.length,
+            data: versions,
+            total: versions.length,
+        };
+        // In JSON mode, just return the data - oclif handles output to stdout
+        if (this.jsonEnabled()) {
+            return result;
+        }
+        // Human-readable table output to stdout
+        if (versions.length === 0) {
+            ux.stdout(t('commands.code.list.noVersions', 'No code versions found.'));
+            return result;
+        }
+        createTable(COLUMNS).render(versions, DEFAULT_COLUMNS);
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/code/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/code/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,EAAE,EAAC,MAAM,aAAa,CAAC;AAC/B,OAAO,EAAC,eAAe,EAAE,WAAW,EAAiB,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAC,gBAAgB,EAA2C,MAAM,6CAA6C,CAAC;AACvH,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AAEtC,MAAM,OAAO,GAA2C;IACtD,EAAE,EAAE;QACF,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG;KACxB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;KACtC;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;KACxC;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,eAAe;QACvB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;KACnG;IACD,UAAU,EAAE;QACV,MAAM,EAAE,YAAY;QACpB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC;KAC9C;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;AAEnF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,eAAgC;IACpE,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,gCAAgC,EAAE,+CAA+C,CAAC,CAAC;IAE1G,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,qCAAqC;QACrC,wEAAwE;QACxE,4CAA4C;KAC7C,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAS,CAAC;QAEtD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B,EAAE,6CAA6C,EAAE,EAAC,QAAQ,EAAC,CAAC,CAAC,CAAC;QAEtG,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAsB;YAChC,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC;QAEF,sEAAsE;QACtE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,wCAAwC;QACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,+BAA+B,EAAE,yBAAyB,CAAC,CAAC,CAAC;YACzE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAEvD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/code/watch.d.ts

@@ -0,0 +1,34 @@
+import { CartridgeCommand } from '@salesforce/b2c-tooling-sdk/cli';
+export default class CodeWatch extends CartridgeCommand<typeof CodeWatch> {
+    static args: {
+        cartridgePath: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        cartridge: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'exclude-cartridge': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        server: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'webdav-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'code-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        username: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        scope: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/code/watch.js

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { watchCartridges } from '@salesforce/b2c-tooling-sdk/operations/code';
+import { CartridgeCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { t } from '../../i18n/index.js';
+export default class CodeWatch extends CartridgeCommand {
+    static args = {
+        ...CartridgeCommand.baseArgs,
+    };
+    static description = t('commands.code.watch.description', 'Watch cartridges and upload changes to an instance');
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> ./my-cartridges',
+        '<%= config.bin %> <%= command.id %> --server my-sandbox.demandware.net --code-version v1',
+        '<%= config.bin %> <%= command.id %> -c app_storefront_base',
+        '<%= config.bin %> <%= command.id %> -x test_cartridge',
+    ];
+    static flags = {
+        ...CartridgeCommand.baseFlags,
+        ...CartridgeCommand.cartridgeFlags,
+    };
+    async run() {
+        this.requireWebDavCredentials();
+        this.requireOAuthCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        const version = this.resolvedConfig.values.codeVersion;
+        this.log(t('commands.code.watch.starting', 'Starting watcher for {{path}}', { path: this.cartridgePath }));
+        this.log(t('commands.code.watch.target', 'Target: {{hostname}}', { hostname }));
+        if (version) {
+            this.log(t('commands.code.watch.codeVersion', 'Code Version: {{version}}', { version }));
+        }
+        try {
+            const result = await watchCartridges(this.instance, this.cartridgePath, {
+                ...this.cartridgeOptions,
+                onUpload: (files) => {
+                    this.log(t('commands.code.watch.uploaded', '[UPLOAD] {{count}} file(s)', { count: files.length }));
+                },
+                onDelete: (files) => {
+                    this.log(t('commands.code.watch.deleted', '[DELETE] {{count}} file(s)', { count: files.length }));
+                },
+                onError: (error) => {
+                    this.warn(t('commands.code.watch.error', 'Error: {{message}}', { message: error.message }));
+                },
+            });
+            this.log(t('commands.code.watch.watching', 'Watching {{count}} cartridge(s)...', { count: result.cartridges.length }));
+            this.log(t('commands.code.watch.pressCtrlC', 'Press Ctrl+C to stop'));
+            // Keep the process running until interrupted
+            await new Promise((resolve) => {
+                const cleanup = () => {
+                    this.log(t('commands.code.watch.stopping', '\nStopping watcher...'));
+                    result.stop().then(() => {
+                        resolve();
+                    });
+                };
+                process.on('SIGINT', cleanup);
+                process.on('SIGTERM', cleanup);
+            });
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(t('commands.code.watch.failed', 'Watch failed: {{message}}', { message: error.message }));
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/code/watch.js.map

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

package/dist/commands/docs/download.d.ts

@@ -0,0 +1,35 @@
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type DownloadDocsResult } from '@salesforce/b2c-tooling-sdk/operations/docs';
+export default class DocsDownload extends InstanceCommand<typeof DocsDownload> {
+    static args: {
+        output: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'keep-archive': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        server: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'webdav-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'code-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        username: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        scope: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<DownloadDocsResult>;
+}

package/dist/commands/docs/download.js

@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { downloadDocs } from '@salesforce/b2c-tooling-sdk/operations/docs';
+import { t } from '../../i18n/index.js';
+export default class DocsDownload extends InstanceCommand {
+    static args = {
+        output: Args.string({
+            description: 'Output directory for extracted documentation',
+            required: true,
+        }),
+    };
+    static description = t('commands.docs.download.description', 'Download Script API documentation from a B2C Commerce instance');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> ./docs',
+        '<%= config.bin %> <%= command.id %> ./docs --keep-archive',
+        '<%= config.bin %> <%= command.id %> --server sandbox.demandware.net ./my-docs',
+    ];
+    static flags = {
+        ...InstanceCommand.baseFlags,
+        'keep-archive': Flags.boolean({
+            description: 'Keep the downloaded archive file',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireServer();
+        this.requireWebDavCredentials();
+        const outputDir = this.args.output;
+        const keepArchive = this.flags['keep-archive'];
+        this.log(t('commands.docs.download.downloading', 'Downloading documentation from {{hostname}}...', {
+            hostname: this.resolvedConfig.values.hostname,
+        }));
+        const result = await downloadDocs(this.instance, {
+            outputDir,
+            keepArchive,
+        });
+        if (this.jsonEnabled()) {
+            return result;
+        }
+        this.log(t('commands.docs.download.success', 'Downloaded {{count}} documentation files to {{path}}', {
+            count: result.fileCount,
+            path: result.outputPath,
+        }));
+        if (result.archivePath) {
+            this.log(t('commands.docs.download.archiveKept', 'Archive saved to: {{path}}', {
+                path: result.archivePath,
+            }));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=download.js.map

package/dist/commands/docs/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/commands/docs/download.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAC,YAAY,EAA0B,MAAM,6CAA6C,CAAC;AAClG,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,eAAoC;IAC5E,MAAM,CAAC,IAAI,GAAG;QACZ,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,8CAA8C;YAC3D,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,CAAC,CACpB,oCAAoC,EACpC,gEAAgE,CACjE,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,4CAA4C;QAC5C,2DAA2D;QAC3D,+EAA+E;KAChF,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,eAAe,CAAC,SAAS;QAC5B,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,WAAW,EAAE,kCAAkC;YAC/C,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAE/C,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,oCAAoC,EAAE,gDAAgD,EAAE;YACxF,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ;SAC9C,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC/C,SAAS;YACT,WAAW;SACZ,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,gCAAgC,EAAE,sDAAsD,EAAE;YAC1F,KAAK,EAAE,MAAM,CAAC,SAAS;YACvB,IAAI,EAAE,MAAM,CAAC,UAAU;SACxB,CAAC,CACH,CAAC;QAEF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,oCAAoC,EAAE,4BAA4B,EAAE;gBACpE,IAAI,EAAE,MAAM,CAAC,WAAW;aACzB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/docs/read.d.ts

@@ -0,0 +1,29 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type DocEntry } from '@salesforce/b2c-tooling-sdk/operations/docs';
+interface ReadDocsResult {
+    entry: DocEntry;
+    content: string;
+}
+export default class DocsRead extends BaseCommand<typeof DocsRead> {
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        raw: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ReadDocsResult>;
+}
+export {};

package/dist/commands/docs/read.js

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { marked } from 'marked';
+// eslint-disable-next-line import/namespace
+import { markedTerminal } from 'marked-terminal';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { readDocByQuery } from '@salesforce/b2c-tooling-sdk/operations/docs';
+import { t } from '../../i18n/index.js';
+// Configure marked with terminal renderer
+marked.use(markedTerminal({
+    width: 80,
+    reflowText: true,
+    tableOptions: {
+        wordWrap: true,
+        colWidths: [35, 45],
+    },
+}));
+export default class DocsRead extends BaseCommand {
+    static args = {
+        query: Args.string({
+            description: 'Search query for documentation (class name, module path, or partial match)',
+            required: true,
+        }),
+    };
+    static description = t('commands.docs.read.description', 'Read Script API documentation for a class or module');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> ProductMgr',
+        '<%= config.bin %> <%= command.id %> dw.catalog.ProductMgr',
+        '<%= config.bin %> <%= command.id %> "dw system Status"',
+        '<%= config.bin %> <%= command.id %> ProductMgr --raw',
+        '<%= config.bin %> <%= command.id %> ProductMgr --json',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        raw: Flags.boolean({
+            char: 'r',
+            description: 'Output raw markdown without terminal formatting',
+            default: false,
+        }),
+    };
+    async run() {
+        const { query } = this.args;
+        const { raw } = this.flags;
+        const result = readDocByQuery(query);
+        if (!result) {
+            this.error(t('commands.docs.read.notFound', 'No documentation found matching: {{query}}', { query }), {
+                suggestions: ['Try a broader search term', 'Use "b2c docs search <query>" to see available matches'],
+            });
+        }
+        if (this.jsonEnabled()) {
+            return result;
+        }
+        // Determine if we should render markdown for terminal
+        const useRaw = raw || !process.stdout.isTTY;
+        if (useRaw) {
+            process.stdout.write(result.content);
+        }
+        else {
+            const rendered = marked.parse(result.content);
+            process.stdout.write(rendered);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/commands/docs/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/commands/docs/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAC9B,4CAA4C;AAC5C,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,cAAc,EAAgB,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EAAC,CAAC,EAAC,MAAM,qBAAqB,CAAC;AAOtC,0CAA0C;AAC1C,MAAM,CAAC,GAAG,CACR,cAAc,CAAC;IACb,KAAK,EAAE,EAAE;IACT,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE;QACZ,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;KACpB;CACF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAA4B;IAChE,MAAM,CAAC,IAAI,GAAG;QACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,4EAA4E;YACzF,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,gCAAgC,EAAE,qDAAqD,CAAC,CAAC;IAEhH,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,gDAAgD;QAChD,2DAA2D;QAC3D,wDAAwD;QACxD,sDAAsD;QACtD,uDAAuD;KACxD,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;QACxB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,iDAAiD;YAC9D,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,KAAK,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAC,GAAG,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,6BAA6B,EAAE,4CAA4C,EAAE,EAAC,KAAK,EAAC,CAAC,EAAE;gBAClG,WAAW,EAAE,CAAC,2BAA2B,EAAE,wDAAwD,CAAC;aACrG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,sDAAsD;QACtD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAE5C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAkB,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/docs/schema.d.ts

@@ -0,0 +1,32 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type SchemaEntry } from '@salesforce/b2c-tooling-sdk/operations/docs';
+interface SchemaResult {
+    entry: SchemaEntry;
+    content: string;
+}
+interface ListResult {
+    entries: SchemaEntry[];
+}
+export default class DocsSchema extends BaseCommand<typeof DocsSchema> {
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        list: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ListResult | SchemaResult>;
+}
+export {};