@salesforce/b2c-cli 0.2.1 → 0.4.0

package/dist/commands/logs/get.js

@@ -0,0 +1,122 @@
+/*
+ * 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, ux } from '@oclif/core';
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getRecentLogs } from '@salesforce/b2c-tooling-sdk/operations/logs';
+import { t } from '../../i18n/index.js';
+import { DEFAULT_PREFIXES, formatEntry, setupPathNormalizer, parseSinceTime, filterBySince, filterByLevel, filterBySearch, } from '../../utils/logs/index.js';
+/**
+ * Default number of entries to retrieve.
+ */
+const DEFAULT_COUNT = 20;
+export default class LogsGet extends InstanceCommand {
+    static description = t('commands.logs.get.description', 'Get recent log entries from a B2C Commerce instance');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --count 50',
+        '<%= config.bin %> <%= command.id %> --filter error --filter customerror --filter debug',
+        '<%= config.bin %> <%= command.id %> --since 5m',
+        '<%= config.bin %> <%= command.id %> --since "2026-01-25T10:00:00"',
+        '<%= config.bin %> <%= command.id %> --level ERROR --level FATAL',
+        '<%= config.bin %> <%= command.id %> --search OrderMgr',
+        '<%= config.bin %> <%= command.id %> --since 1h --level ERROR --search "PaymentProcessor" --json',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...InstanceCommand.baseFlags,
+        filter: Flags.string({
+            char: 'f',
+            description: 'Log prefixes to filter (can specify multiple)',
+            multiple: true,
+            default: DEFAULT_PREFIXES,
+        }),
+        count: Flags.integer({
+            char: 'n',
+            description: 'Maximum number of entries to retrieve',
+            default: DEFAULT_COUNT,
+        }),
+        since: Flags.string({
+            description: 'Only show entries after this time (e.g., "5m", "1h", "2d", or ISO 8601)',
+        }),
+        level: Flags.string({
+            description: 'Filter by log level (ERROR, WARN, INFO, DEBUG, FATAL, TRACE)',
+            multiple: true,
+        }),
+        search: Flags.string({
+            char: 'g',
+            description: 'Filter entries containing this text (case-insensitive)',
+        }),
+        'cartridge-path': Flags.string({
+            description: 'Override cartridge path for path normalization (auto-discovered by default)',
+        }),
+        'no-normalize': Flags.boolean({
+            description: 'Disable automatic path normalization',
+            default: false,
+        }),
+        'no-color': Flags.boolean({
+            description: 'Disable colored output',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireServer();
+        this.requireWebDavCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        const useColor = !this.flags['no-color'] && process.stdout.isTTY && !this.jsonEnabled();
+        // Set up path normalizer for IDE click-to-open
+        const pathNormalizer = setupPathNormalizer(this.flags['cartridge-path'], this.flags['no-normalize']);
+        // Parse --since if provided
+        let sinceDate;
+        if (this.flags.since) {
+            sinceDate = parseSinceTime(this.flags.since);
+        }
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.logs.get.fetching', 'Fetching recent logs from {{hostname}} (prefixes: {{prefixes}})...', {
+                hostname,
+                prefixes: this.flags.filter.join(', '),
+            }));
+        }
+        // Fetch entries from SDK - request more than needed if we'll be filtering client-side
+        const needsClientFilter = sinceDate || this.flags.level || this.flags.search;
+        const fetchCount = needsClientFilter ? Math.max(this.flags.count * 5, 500) : this.flags.count;
+        let entries = await getRecentLogs(this.instance, {
+            prefixes: this.flags.filter,
+            maxEntries: fetchCount,
+            pathNormalizer,
+        });
+        // Apply client-side filters
+        if (sinceDate) {
+            entries = filterBySince(entries, sinceDate);
+        }
+        if (this.flags.level && this.flags.level.length > 0) {
+            entries = filterByLevel(entries, this.flags.level);
+        }
+        if (this.flags.search) {
+            entries = filterBySearch(entries, this.flags.search);
+        }
+        // Limit to requested count after filtering
+        entries = entries.slice(0, this.flags.count);
+        const result = {
+            count: entries.length,
+            entries,
+        };
+        if (this.jsonEnabled()) {
+            return result;
+        }
+        if (entries.length === 0) {
+            ux.stdout(t('commands.logs.get.noEntries', 'No log entries found.'));
+            return result;
+        }
+        // Output entries (most recent first, which is how they come from getRecentLogs)
+        for (const entry of entries) {
+            ux.stdout(formatEntry(entry, useColor));
+        }
+        this.log(t('commands.logs.get.summary', '\nRetrieved {{count}} log entries.', { count: entries.length }));
+        return result;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/logs/get.js.map

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

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

@@ -0,0 +1,45 @@
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type LogFile } from '@salesforce/b2c-tooling-sdk/operations/logs';
+interface LogsListResult {
+    count: number;
+    files: LogFile[];
+}
+export default class LogsList extends InstanceCommand<typeof LogsList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        filter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sort: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        order: import("@oclif/core/interfaces").OptionFlag<string, 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>;
+        certificate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        selfsigned: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verify: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        '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>;
+        'tenant-id': 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>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        '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<LogsListResult>;
+}
+export {};

package/dist/commands/logs/list.js

@@ -0,0 +1,94 @@
+/*
+ * 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, ux } from '@oclif/core';
+import { InstanceCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
+import { listLogFiles } from '@salesforce/b2c-tooling-sdk/operations/logs';
+import { t } from '../../i18n/index.js';
+/**
+ * Formats bytes into human-readable sizes.
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    const k = 1024;
+    const i = Math.min(Math.floor(Math.log(bytes) / Math.log(k)), units.length - 1);
+    const value = bytes / k ** i;
+    return `${value.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;
+}
+const COLUMNS = {
+    name: {
+        header: 'Name',
+        get: (f) => f.name,
+    },
+    prefix: {
+        header: 'Type',
+        get: (f) => f.prefix,
+    },
+    size: {
+        header: 'Size',
+        get: (f) => formatBytes(f.size),
+    },
+    modified: {
+        header: 'Modified',
+        get: (f) => f.lastModified.toLocaleString(),
+    },
+};
+const DEFAULT_COLUMNS = ['name', 'prefix', 'size', 'modified'];
+export default class LogsList extends InstanceCommand {
+    static description = t('commands.logs.list.description', 'List log files on a B2C Commerce instance');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --filter error --filter customerror',
+        '<%= config.bin %> <%= command.id %> --sort size --order asc',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...InstanceCommand.baseFlags,
+        filter: Flags.string({
+            char: 'f',
+            description: 'Filter by log prefix (can specify multiple)',
+            multiple: true,
+        }),
+        sort: Flags.string({
+            description: 'Sort field',
+            options: ['name', 'date', 'size'],
+            default: 'date',
+        }),
+        order: Flags.string({
+            char: 'o',
+            description: 'Sort order',
+            options: ['asc', 'desc'],
+            default: 'desc',
+        }),
+    };
+    async run() {
+        this.requireServer();
+        this.requireWebDavCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        this.log(t('commands.logs.list.fetching', 'Fetching log files from {{hostname}}...', { hostname }));
+        const files = await listLogFiles(this.instance, {
+            prefixes: this.flags.filter,
+            sortBy: this.flags.sort,
+            sortOrder: this.flags.order,
+        });
+        const result = {
+            count: files.length,
+            files,
+        };
+        if (this.jsonEnabled()) {
+            return result;
+        }
+        if (files.length === 0) {
+            ux.stdout(t('commands.logs.list.noFiles', 'No log files found.'));
+            return result;
+        }
+        createTable(COLUMNS).render(files, DEFAULT_COLUMNS);
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/commands/logs/tail.d.ts

@@ -0,0 +1,44 @@
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+export default class LogsTail extends InstanceCommand<typeof LogsTail> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        filter: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'cartridge-path': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-normalize': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        last: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        level: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-color': 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>;
+        certificate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        selfsigned: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verify: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        '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>;
+        'tenant-id': 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>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        '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/logs/tail.js

@@ -0,0 +1,138 @@
+/*
+ * 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, ux } from '@oclif/core';
+import { InstanceCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { tailLogs } from '@salesforce/b2c-tooling-sdk/operations/logs';
+import { t } from '../../i18n/index.js';
+import { DEFAULT_PREFIXES, formatEntry, setupPathNormalizer, matchesLevel, matchesSearch, } from '../../utils/logs/index.js';
+/**
+ * Default polling interval in milliseconds.
+ */
+const DEFAULT_INTERVAL = 3000;
+export default class LogsTail extends InstanceCommand {
+    static description = t('commands.logs.tail.description', 'Tail log files on a B2C Commerce instance in real-time');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --filter error --filter customerror --filter debug',
+        '<%= config.bin %> <%= command.id %> --interval 5000',
+        '<%= config.bin %> <%= command.id %> --cartridge-path ./cartridges',
+        '<%= config.bin %> <%= command.id %> --last 5',
+        '<%= config.bin %> <%= command.id %> --last 0',
+        '<%= config.bin %> <%= command.id %> --level ERROR --level FATAL',
+        '<%= config.bin %> <%= command.id %> --search "PaymentProcessor"',
+        '<%= config.bin %> <%= command.id %> --level ERROR --search "OrderMgr"',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...InstanceCommand.baseFlags,
+        filter: Flags.string({
+            char: 'f',
+            description: 'Log prefixes to filter (can specify multiple)',
+            multiple: true,
+            default: DEFAULT_PREFIXES,
+        }),
+        interval: Flags.integer({
+            description: 'Polling interval in milliseconds',
+            default: DEFAULT_INTERVAL,
+        }),
+        'cartridge-path': Flags.string({
+            description: 'Override cartridge path for path normalization (auto-discovered by default)',
+        }),
+        'no-normalize': Flags.boolean({
+            description: 'Disable automatic path normalization',
+            default: false,
+        }),
+        last: Flags.integer({
+            char: 'l',
+            description: 'Show last N entries per file on startup (0 to skip)',
+            default: 1,
+        }),
+        level: Flags.string({
+            description: 'Filter by log level (ERROR, WARN, INFO, DEBUG, FATAL, TRACE)',
+            multiple: true,
+        }),
+        search: Flags.string({
+            char: 'g',
+            description: 'Filter entries containing this text (case-insensitive)',
+        }),
+        'no-color': Flags.boolean({
+            description: 'Disable colored output',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireServer();
+        this.requireWebDavCredentials();
+        const hostname = this.resolvedConfig.values.hostname;
+        const useColor = !this.flags['no-color'] && process.stdout.isTTY && !this.jsonEnabled();
+        // Set up path normalizer for IDE click-to-open
+        const pathNormalizer = setupPathNormalizer(this.flags['cartridge-path'], this.flags['no-normalize']);
+        // Store filter flags for use in callback
+        const levelFilter = this.flags.level;
+        const searchFilter = this.flags.search;
+        this.log(t('commands.logs.tail.starting', 'Tailing logs from {{hostname}} (prefixes: {{prefixes}})...', {
+            hostname,
+            prefixes: this.flags.filter.join(', '),
+        }));
+        this.log(t('commands.logs.tail.interrupt', 'Press Ctrl+C to stop.\n'));
+        // Track discovered files for JSON output
+        const discoveredFiles = [];
+        const collectedEntries = [];
+        const { stop, done } = await tailLogs(this.instance, {
+            prefixes: this.flags.filter,
+            pollInterval: this.flags.interval,
+            lastEntries: this.flags.last,
+            pathNormalizer,
+            onEntry: (entry) => {
+                // Apply filters
+                if (levelFilter && levelFilter.length > 0 && !matchesLevel(entry, levelFilter)) {
+                    return;
+                }
+                if (searchFilter && !matchesSearch(entry, searchFilter)) {
+                    return;
+                }
+                if (this.jsonEnabled()) {
+                    // NDJSON output - one JSON object per line
+                    ux.stdout(JSON.stringify(entry));
+                    collectedEntries.push(entry);
+                }
+                else {
+                    ux.stdout(formatEntry(entry, useColor));
+                }
+            },
+            onFileDiscovered: (file) => {
+                discoveredFiles.push(file);
+                if (!this.jsonEnabled()) {
+                    this.log(t('commands.logs.tail.fileDiscovered', 'Discovered log file: {{name}}', { name: file.name }));
+                }
+            },
+            onFileRotated: (file) => {
+                if (!this.jsonEnabled()) {
+                    this.log(t('commands.logs.tail.fileRotated', 'Log file rotated: {{name}}', { name: file.name }));
+                }
+            },
+            onError: (error) => {
+                this.warn(t('commands.logs.tail.error', 'Error: {{message}}', { message: error.message }));
+            },
+        });
+        // Handle SIGINT (Ctrl+C) for graceful shutdown
+        const handleSignal = async () => {
+            this.log(t('commands.logs.tail.stopping', '\nStopping log tail...'));
+            await stop();
+        };
+        process.on('SIGINT', () => {
+            handleSignal().catch(() => { });
+        });
+        process.on('SIGTERM', () => {
+            handleSignal().catch(() => { });
+        });
+        // Wait for tailing to complete
+        await done;
+        this.log(t('commands.logs.tail.stopped', 'Log tailing stopped.'));
+    }
+}
+//# sourceMappingURL=tail.js.map

package/dist/commands/logs/tail.js.map

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

package/dist/commands/mrt/bundle/deploy.js

@@ -6,7 +6,27 @@
 import { Args, Flags } from '@oclif/core';
 import { MrtCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import { pushBundle, createDeployment, DEFAULT_SSR_PARAMETERS, } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
+/**
+ * Parses a glob pattern string into an array of patterns.
+ * Accepts either a JSON array (e.g. '["server/**\/*", "ssr.{js,mjs}"]')
+ * or a comma-separated string (e.g. 'server/**\/*,ssr.js').
+ * JSON array format supports brace expansion in individual patterns.
+ */
+function parseGlobPatterns(value) {
+    const trimmed = value.trim();
+    if (trimmed.startsWith('[')) {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed) || !parsed.every((item) => typeof item === 'string')) {
+            throw new Error(`Invalid glob pattern array: expected an array of strings`);
+        }
+        return parsed.map((s) => s.trim()).filter(Boolean);
+    }
+    return trimmed
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
 /**
  * Parses SSR parameter flags into a key-value object.
  * Accepts format: key=value
@@ -39,7 +59,7 @@ export default class MrtBundleDeploy extends MrtCommand {
             required: false,
         }),
     };
-    static description = t('commands.mrt.bundle.deploy.description', 'Push a local build or deploy an existing bundle to Managed Runtime');
+    static description = withDocs(t('commands.mrt.bundle.deploy.description', 'Push a local build or deploy an existing bundle to Managed Runtime'), '/cli/mrt.html#b2c-mrt-bundle-deploy');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %> --project my-storefront',
@@ -62,11 +82,11 @@ export default class MrtBundleDeploy extends MrtCommand {
             default: 'build',
         }),
         'ssr-only': Flags.string({
-            description: 'Glob patterns for server-only files (comma-separated, only for local builds)',
+            description: 'Glob patterns for server-only files (comma-separated or JSON array, only for local builds)',
             default: 'ssr.js,ssr.mjs,server/**/*',
         }),
         'ssr-shared': Flags.string({
-            description: 'Glob patterns for shared files (comma-separated, only for local builds)',
+            description: 'Glob patterns for shared files (comma-separated or JSON array, only for local builds)',
             default: 'static/**/*,client/**/*',
         }),
         'node-version': Flags.string({
@@ -138,8 +158,8 @@ export default class MrtBundleDeploy extends MrtCommand {
             this.error('MRT project is required. Provide --project flag, set SFCC_MRT_PROJECT, or set mrtProject in dw.json.');
         }
         const buildDir = this.flags['build-dir'];
-        const ssrOnly = this.flags['ssr-only'].split(',').map((s) => s.trim());
-        const ssrShared = this.flags['ssr-shared'].split(',').map((s) => s.trim());
+        const ssrOnly = parseGlobPatterns(this.flags['ssr-only']);
+        const ssrShared = parseGlobPatterns(this.flags['ssr-shared']);
         // Build SSR parameters from flags
         const ssrParameters = parseSsrParams(this.flags['ssr-param']);
         // --node-version is a convenience flag for SSRFunctionNodeVersion

package/dist/commands/mrt/bundle/deploy.js.map

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

package/dist/commands/mrt/bundle/download.js

@@ -9,7 +9,7 @@ import { pipeline } from 'node:stream/promises';
 import { Args, Flags } from '@oclif/core';
 import { MrtCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import { downloadBundle } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
 /**
  * Download a bundle artifact from Managed Runtime.
  */
@@ -20,7 +20,7 @@ export default class MrtBundleDownload extends MrtCommand {
             required: true,
         }),
     };
-    static description = t('commands.mrt.bundle.download.description', 'Download a Managed Runtime bundle artifact');
+    static description = withDocs(t('commands.mrt.bundle.download.description', 'Download a Managed Runtime bundle artifact'), '/cli/mrt.html#b2c-mrt-bundle-download');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %> 12345 --project my-storefront',

package/dist/commands/mrt/bundle/download.js.map

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

package/dist/commands/mrt/bundle/history.js

@@ -6,7 +6,7 @@
 import { Flags } from '@oclif/core';
 import { MrtCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
 import { listDeployments, } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
 const COLUMNS = {
     bundleId: {
         header: 'Bundle ID',
@@ -38,7 +38,7 @@ const DEFAULT_COLUMNS = ['bundleId', 'bundleMessage', 'status', 'type', 'created
  * List deployment history for an MRT environment.
  */
 export default class MrtBundleHistory extends MrtCommand {
-    static description = t('commands.mrt.bundle.history.description', 'List deployment history for a Managed Runtime environment');
+    static description = withDocs(t('commands.mrt.bundle.history.description', 'List deployment history for a Managed Runtime environment'), '/cli/mrt.html#b2c-mrt-bundle-history');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %> --project my-storefront --environment staging',