@salesforce/b2c-cli 0.2.1 → 0.4.0

package/dist/commands/mrt/project/update.js

@@ -7,7 +7,7 @@ import { Args, Flags, ux } from '@oclif/core';
 import cliui from 'cliui';
 import { MrtCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import { updateProject } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
 /**
  * Valid AWS regions for MRT projects.
  */
@@ -67,7 +67,7 @@ export default class MrtProjectUpdate extends MrtCommand {
             required: true,
         }),
     };
-    static description = t('commands.mrt.project.update.description', 'Update a Managed Runtime project');
+    static description = withDocs(t('commands.mrt.project.update.description', 'Update a Managed Runtime project'), '/cli/mrt.html#b2c-mrt-project-update');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %> my-storefront --name "New Name"',

package/dist/commands/mrt/project/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/mrt/project/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/mrt/project/update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAC,aAAa,EAAgD,MAAM,4CAA4C,CAAC;AACxH,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,cAAc;IACd,WAAW;IACX,WAAW;IACX,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,cAAc;IACd,WAAW;CACH,CAAC;AAIX;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAA6B;IACxD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAC,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,EAAE,CAAC;IAEtB,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACX,EAAE,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAC,EAAE,EAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAC,CAAC,CAAC;IACjE,EAAE,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAC,EAAE,EAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAC,CAAC,CAAC;IACvE,EAAE,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAC,EAAE,EAAC,IAAI,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,EAAC,CAAC,CAAC;IAEvF,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,EAAE,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAC,EAAE,EAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAC,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,EAAE,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAC,EAAE,EAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAC,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,EAAE,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAC,EAAE,EAAC,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE,EAAC,CAAC,CAAC;IACvG,CAAC;IAED,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,UAAmC;IAC/E,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,cAAc;YAC3B,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,yCAAyC,EAAE,kCAAkC,CAAC,EAChF,sCAAsC,CACvC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,qEAAqE;QACrE,sEAAsE;QACtE,6EAA6E;KAC9E,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,UAAU,CAAC,SAAS;QACvB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,0BAA0B;SACxC,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,yBAAyB;SACvC,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,6CAA6C;YAC1D,OAAO,EAAE,WAAkC;SAC5C,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,MAAM,EAAC,IAAI,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACzB,MAAM,EAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAEvC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,sCAAsC,EAAE,gCAAgC,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC;QAE9F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC;gBACE,WAAW,EAAE,IAAI;gBACjB,IAAI;gBACJ,GAAG;gBACH,SAAS,EAAE,MAA+B;gBAC1C,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS;aAC7C,EACD,IAAI,CAAC,UAAU,EAAE,CAClB,CAAC;YAEF,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qCAAqC,EAAE,+BAA+B,CAAC,CAAC,CAAC;YACpF,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAE5B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,oCAAoC,EAAE,uCAAuC,EAAE,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAC,CAAC,CAC3G,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC"}

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

@@ -0,0 +1,27 @@
+import { MrtCommand } from '@salesforce/b2c-tooling-sdk/cli';
+export default class MrtTailLogs extends MrtCommand<typeof MrtTailLogs> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        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>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'cloud-origin': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'credentials-file': 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/mrt/tail-logs.js

@@ -0,0 +1,137 @@
+/*
+ * 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 { MrtCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getProfile, tailMrtLogs } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+import { t } from '../../i18n/index.js';
+import { formatMrtEntry, colorLevel, colorHighlight } from '../../utils/mrt-logs/index.js';
+export default class MrtTailLogs extends MrtCommand {
+    static description = t('commands.mrt.tail-logs.description', 'Tail application logs from a Managed Runtime environment');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> -p my-storefront -e staging',
+        '<%= config.bin %> <%= command.id %> -p my-storefront -e production --level ERROR --level WARN',
+        '<%= config.bin %> <%= command.id %> -p my-storefront -e staging --json',
+        '<%= config.bin %> <%= command.id %> -p my-storefront -e staging --search "timeout"',
+        '<%= config.bin %> <%= command.id %> -p my-storefront -e staging --search "GET|POST"',
+    ];
+    static flags = {
+        ...MrtCommand.baseFlags,
+        level: Flags.string({
+            description: 'Filter by log level (ERROR, WARN, INFO, DEBUG, etc.)',
+            multiple: true,
+        }),
+        search: Flags.string({
+            char: 'g',
+            description: 'Filter entries matching this regex pattern (case-insensitive)',
+        }),
+        'no-color': Flags.boolean({
+            description: 'Disable colored output',
+            default: false,
+        }),
+    };
+    async run() {
+        this.requireMrtCredentials();
+        const { mrtProject: project, mrtEnvironment: environment, mrtOrigin: origin } = this.resolvedConfig.values;
+        if (!project) {
+            this.error('MRT project is required. Provide --project flag, set SFCC_MRT_PROJECT, or set mrtProject in dw.json.');
+        }
+        if (!environment) {
+            this.error('MRT environment is required. Provide --environment flag, set SFCC_MRT_ENVIRONMENT, or set mrtEnvironment in dw.json.');
+        }
+        const auth = this.getMrtAuth();
+        const useColor = !this.flags['no-color'] && process.stdout.isTTY && !this.jsonEnabled();
+        const levelFilter = this.flags.level;
+        const searchFilter = this.flags.search;
+        // Compile search regex (case-insensitive, global for highlighting)
+        let searchRegex;
+        if (searchFilter) {
+            try {
+                searchRegex = new RegExp(searchFilter, 'gi');
+            }
+            catch {
+                this.error(`Invalid search pattern: "${searchFilter}". Must be a valid regular expression.`);
+            }
+        }
+        // Pre-compute level filter set
+        const upperLevels = levelFilter && levelFilter.length > 0 ? new Set(levelFilter.map((l) => l.toUpperCase())) : null;
+        // Best-effort user email for WebSocket connection
+        let user;
+        try {
+            const profile = await getProfile({ origin }, auth);
+            user = profile.email;
+        }
+        catch {
+            // Non-fatal: proceed without user email
+        }
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.mrt.tail-logs.connecting', 'Connecting to {{project}}/{{environment}} logs...', {
+                project,
+                environment,
+            }));
+            // Log active filters
+            if (upperLevels) {
+                const levels = useColor ? [...upperLevels].map((l) => colorLevel(l)).join(', ') : [...upperLevels].join(', ');
+                this.log(t('commands.mrt.tail-logs.filterLevel', 'Filtering by level: {{levels}}', { levels }));
+            }
+            if (searchFilter) {
+                const pattern = useColor ? colorHighlight(searchFilter) : searchFilter;
+                this.log(t('commands.mrt.tail-logs.filterSearch', 'Filtering by pattern: {{pattern}}', { pattern }));
+            }
+        }
+        const { stop, done } = await tailMrtLogs({
+            projectSlug: project,
+            environmentSlug: environment,
+            origin,
+            user,
+            onEntry: (entry) => {
+                // Apply level filter
+                if (upperLevels && (!entry.level || !upperLevels.has(entry.level.toUpperCase())))
+                    return;
+                // Apply search filter (regex match against message and raw)
+                if (searchRegex) {
+                    // Reset lastIndex since we reuse the global regex
+                    searchRegex.lastIndex = 0;
+                    const matchesMessage = searchRegex.test(entry.message);
+                    searchRegex.lastIndex = 0;
+                    const matchesRaw = searchRegex.test(entry.raw);
+                    if (!matchesMessage && !matchesRaw)
+                        return;
+                    // Reset for highlighting pass
+                    searchRegex.lastIndex = 0;
+                }
+                if (this.jsonEnabled()) {
+                    ux.stdout(JSON.stringify(entry));
+                }
+                else {
+                    ux.stdout(formatMrtEntry(entry, { useColor, searchHighlight: searchRegex }));
+                }
+            },
+            onConnect: () => {
+                if (!this.jsonEnabled()) {
+                    this.log(t('commands.mrt.tail-logs.connected', 'Connected. Waiting for log entries...'));
+                    this.log(t('commands.mrt.tail-logs.interrupt', 'Press Ctrl+C to stop.\n'));
+                }
+            },
+            onError: (error) => {
+                this.warn(t('commands.mrt.tail-logs.error', 'WebSocket error: {{message}}', { message: error.message }));
+            },
+            onClose: (_code, _reason) => {
+                if (!this.jsonEnabled()) {
+                    this.log(t('commands.mrt.tail-logs.disconnected', '\nDisconnected from log stream.'));
+                }
+            },
+        }, auth);
+        // Graceful shutdown on signals
+        const handleSignal = () => {
+            stop();
+        };
+        process.on('SIGINT', handleSignal);
+        process.on('SIGTERM', handleSignal);
+        await done;
+    }
+}
+//# sourceMappingURL=tail-logs.js.map

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

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

package/dist/commands/mrt/user/api-key.js

@@ -7,12 +7,12 @@ import { Flags } from '@oclif/core';
 import * as readline from 'node:readline';
 import { MrtCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import { resetApiKey } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
 /**
  * Reset the current user's API key.
  */
 export default class MrtUserApiKey extends MrtCommand {
-    static description = t('commands.mrt.user.api-key.description', 'Reset the API key for the current user (invalidates current key)');
+    static description = withDocs(t('commands.mrt.user.api-key.description', 'Reset the API key for the current user (invalidates current key)'), '/cli/mrt.html#b2c-mrt-user-api-key');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %>',

package/dist/commands/mrt/user/api-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-key.js","sourceRoot":"","sources":["../../../../src/commands/mrt/user/api-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAC,WAAW,EAAoB,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAC,CAAC,EAAC,MAAM,wBAAwB,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAgC;IACzE,MAAM,CAAC,WAAW,GAAG,CAAC,CACpB,uCAAuC,EACvC,kEAAkE,CACnE,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,qCAAqC;QACrC,2CAA2C;QAC3C,4CAA4C;KAC7C,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,UAAU,CAAC,SAAS;QACvB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,0BAA0B;YACvC,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,MAAM,EAAC,GAAG,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,CAAC,CACC,mCAAmC,EACnC,8GAA8G,CAC/G,CACF,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qCAAqC,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAE3E,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B;YACE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS;SAC7C,EACD,IAAI,CAAC,UAAU,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,sCAAsC,CAAC,CAAC,CAAC;YACzF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,2BAA2B,EAAE,EAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAC,CAAC,CAAC,CAAC;YACxG,IAAI,CAAC,GAAG,CACN,CAAC,CACC,mCAAmC,EACnC,yFAAyF,CAC1F,CACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe;QACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC9B,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;YAC1E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"api-key.js","sourceRoot":"","sources":["../../../../src/commands/mrt/user/api-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAC,WAAW,EAAoB,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAgC;IACzE,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,uCAAuC,EAAE,kEAAkE,CAAC,EAC9G,oCAAoC,CACrC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,qCAAqC;QACrC,2CAA2C;QAC3C,4CAA4C;KAC7C,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,UAAU,CAAC,SAAS;QACvB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,0BAA0B;YACvC,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,MAAM,EAAC,GAAG,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAClC,CAAC,CACC,mCAAmC,EACnC,8GAA8G,CAC/G,CACF,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qCAAqC,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAE3E,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B;YACE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS;SAC7C,EACD,IAAI,CAAC,UAAU,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,sCAAsC,CAAC,CAAC,CAAC;YACzF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,2BAA2B,EAAE,EAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAC,CAAC,CAAC,CAAC;YACxG,IAAI,CAAC,GAAG,CACN,CAAC,CACC,mCAAmC,EACnC,yFAAyF,CAC1F,CACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe;QACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC9B,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;YAC1E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/mrt/user/email-prefs.js

@@ -6,7 +6,7 @@
 import { Flags } from '@oclif/core';
 import { MrtCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
 import { getEmailPreferences, updateEmailPreferences, } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
 const COLUMNS = {
     field: {
         header: 'Preference',
@@ -22,7 +22,7 @@ const DEFAULT_COLUMNS = ['field', 'value'];
  * View or update email notification preferences.
  */
 export default class MrtUserEmailPrefs extends MrtCommand {
-    static description = t('commands.mrt.user.email-prefs.description', 'View or update email notification preferences');
+    static description = withDocs(t('commands.mrt.user.email-prefs.description', 'View or update email notification preferences'), '/cli/mrt.html#b2c-mrt-user-email-prefs');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %>',

package/dist/commands/mrt/user/email-prefs.js.map

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

package/dist/commands/mrt/user/profile.js

@@ -5,7 +5,7 @@
  */
 import { MrtCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
 import { getProfile } from '@salesforce/b2c-tooling-sdk/operations/mrt';
-import { t } from '../../../i18n/index.js';
+import { t, withDocs } from '../../../i18n/index.js';
 const COLUMNS = {
     field: {
         header: 'Field',
@@ -21,7 +21,7 @@ const DEFAULT_COLUMNS = ['field', 'value'];
  * Get the current user's profile information.
  */
 export default class MrtUserProfile extends MrtCommand {
-    static description = t('commands.mrt.user.profile.description', 'Display profile information for the current user');
+    static description = withDocs(t('commands.mrt.user.profile.description', 'Display profile information for the current user'), '/cli/mrt.html#b2c-mrt-user-profile');
     static enableJsonFlag = true;
     static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
     static flags = {

package/dist/commands/mrt/user/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../../src/commands/mrt/user/profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,UAAU,EAAE,WAAW,EAAiB,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAC,UAAU,EAAyC,MAAM,4CAA4C,CAAC;AAC9G,OAAO,EAAC,CAAC,EAAC,MAAM,wBAAwB,CAAC;AAIzC,MAAM,OAAO,GAA4C;IACvD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;KACpB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;KACpB;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,UAAiC;IAC3E,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,uCAAuC,EAAE,kDAAkD,CAAC,CAAC;IAEpH,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG,CAAC,qCAAqC,EAAE,4CAA4C,CAAC,CAAC;IAExG,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,UAAU,CAAC,SAAS;KACxB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAE9E,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B;YACE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS;SAC7C,EACD,IAAI,CAAC,UAAU,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAmB;gBAC9B,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,EAAC;gBAC7C,EAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG,EAAC;gBACvD,EAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,EAAC;gBACrD,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAC;gBACxD,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,EAAC;gBACpG,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,EAAC;aAC5C,CAAC;YACF,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../../src/commands/mrt/user/profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,UAAU,EAAE,WAAW,EAAiB,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAC,UAAU,EAAyC,MAAM,4CAA4C,CAAC;AAC9G,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAInD,MAAM,OAAO,GAA4C;IACvD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;KACpB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;KACpB;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,UAAiC;IAC3E,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,uCAAuC,EAAE,kDAAkD,CAAC,EAC9F,oCAAoC,CACrC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG,CAAC,qCAAqC,EAAE,4CAA4C,CAAC,CAAC;IAExG,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,UAAU,CAAC,SAAS;KACxB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAE9E,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B;YACE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS;SAC7C,EACD,IAAI,CAAC,UAAU,EAAE,CAClB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAmB;gBAC9B,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,EAAC;gBAC7C,EAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG,EAAC;gBACvD,EAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,EAAC;gBACrD,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAC;gBACxD,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,EAAC;gBACpG,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,EAAC;aAC5C,CAAC;YACF,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/dist/commands/{ods → sandbox}/create.d.ts

@@ -4,7 +4,8 @@ type SandboxModel = OdsComponents['schemas']['SandboxModel'];
 /**
  * Command to create a new on-demand sandbox.
  */
-export default class OdsCreate extends OdsCommand<typeof OdsCreate> {
+export default class SandboxCreate extends OdsCommand<typeof SandboxCreate> {
+    static aliases: string[];
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
@@ -17,26 +18,19 @@ export default class OdsCreate extends OdsCommand<typeof OdsCreate> {
         'poll-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'set-permissions': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'permissions-client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ocapi-settings': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'webdav-settings': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'start-scheduler': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'stop-scheduler': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<SandboxModel>;
     /**
      * Builds the sandbox settings object with OCAPI and WebDAV permissions.
-     * @param setPermissions - Whether to set permissions for the client ID
      * @returns Settings object or undefined if permissions should not be set
      */
     private buildSettings;
+    private parseJsonFlag;
     private printSandboxSummary;
-    /**
-     * Sleep for a given number of milliseconds.
-     */
-    private sleep;
-    /**
-     * Polls for sandbox status until it reaches a terminal state.
-     * @param sandboxId - The sandbox ID to poll
-     * @param pollIntervalSeconds - Interval between polls in seconds
-     * @param timeoutSeconds - Maximum time to wait (0 for no timeout)
-     * @returns The final sandbox state
-     */
-    private waitForSandbox;
 }
 export {};

package/dist/commands/sandbox/create.js

@@ -0,0 +1,264 @@
+/*
+ * 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 cliui from 'cliui';
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getApiErrorMessage, SandboxPollingError, SandboxPollingTimeoutError, SandboxTerminalStateError, waitForSandbox, } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Default OCAPI resources to grant the client ID access to.
+ * These enable common CI/CD operations like code deployment and job execution.
+ */
+const DEFAULT_OCAPI_RESOURCES = [
+    { resource_id: '/code_versions', methods: ['get'], read_attributes: '(**)', write_attributes: '(**)' },
+    { resource_id: '/code_versions/*', methods: ['patch', 'delete'], read_attributes: '(**)', write_attributes: '(**)' },
+    { resource_id: '/jobs/*/executions', methods: ['post'], read_attributes: '(**)', write_attributes: '(**)' },
+    { resource_id: '/jobs/*/executions/*', methods: ['get'], read_attributes: '(**)', write_attributes: '(**)' },
+    { resource_id: '/sites/*/cartridges', methods: ['post'], read_attributes: '(**)', write_attributes: '(**)' },
+];
+/**
+ * Default WebDAV permissions to grant the client ID.
+ * These enable common operations like code upload and data import/export.
+ */
+const DEFAULT_WEBDAV_PERMISSIONS = [
+    { path: '/impex', operations: ['read_write'] },
+    { path: '/cartridges', operations: ['read_write'] },
+    { path: '/static', operations: ['read_write'] },
+];
+/**
+ * Command to create a new on-demand sandbox.
+ */
+export default class SandboxCreate extends OdsCommand {
+    static aliases = ['ods:create'];
+    static description = withDocs(t('commands.sandbox.create.description', 'Create a new on-demand sandbox'), '/cli/sandbox.html#b2c-sandbox-create');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --realm abcd',
+        '<%= config.bin %> <%= command.id %> --realm abcd --ttl 48',
+        '<%= config.bin %> <%= command.id %> --realm abcd --profile large',
+        '<%= config.bin %> <%= command.id %> --realm abcd --auto-scheduled',
+        '<%= config.bin %> <%= command.id %> --realm abcd --wait',
+        '<%= config.bin %> <%= command.id %> --realm abcd --wait --poll-interval 15',
+        '<%= config.bin %> <%= command.id %> --realm abcd --json',
+    ];
+    static flags = {
+        realm: Flags.string({
+            char: 'r',
+            description: 'Realm ID (four-letter ID)',
+            required: true,
+        }),
+        ttl: Flags.integer({
+            description: 'Time to live in hours (0 for infinite)',
+            default: 24,
+        }),
+        profile: Flags.string({
+            description: 'Resource profile (medium, large, xlarge, xxlarge)',
+            default: 'medium',
+            options: ['medium', 'large', 'xlarge', 'xxlarge'],
+        }),
+        'auto-scheduled': Flags.boolean({
+            description: 'Enable automatic start/stop scheduling',
+            default: false,
+        }),
+        wait: Flags.boolean({
+            char: 'w',
+            description: 'Wait for the sandbox to reach started or failed state before returning',
+            default: false,
+        }),
+        'poll-interval': Flags.integer({
+            description: 'Polling interval in seconds when using --wait',
+            default: 10,
+            dependsOn: ['wait'],
+        }),
+        timeout: Flags.integer({
+            description: 'Maximum time to wait in seconds when using --wait (0 for no timeout)',
+            default: 600,
+            dependsOn: ['wait'],
+        }),
+        'set-permissions': Flags.boolean({
+            description: 'Automatically set OCAPI and WebDAV permissions for the client ID used to create the sandbox',
+            default: true,
+            allowNo: true,
+        }),
+        'permissions-client-id': Flags.string({
+            description: 'Client ID to use for default OCAPI/WebDAV permissions (defaults to auth client ID)',
+        }),
+        'ocapi-settings': Flags.string({
+            description: 'Custom OCAPI settings JSON array (replaces defaults). Format: [{"client_id":"...","resources":[...]}]',
+        }),
+        'webdav-settings': Flags.string({
+            description: 'Custom WebDAV settings JSON array (replaces defaults). Format: [{"client_id":"...","permissions":[...]}]',
+        }),
+        'start-scheduler': Flags.string({
+            description: 'Start schedule JSON. Format: {"weekdays":["MONDAY",...],"time":"08:00:00+03:00"}',
+        }),
+        'stop-scheduler': Flags.string({
+            description: 'Stop schedule JSON. Format: {"weekdays":["MONDAY",...],"time":"19:00:00Z"}',
+        }),
+    };
+    async run() {
+        const realm = this.flags.realm;
+        const profile = this.flags.profile;
+        const ttl = this.flags.ttl;
+        const autoScheduled = this.flags['auto-scheduled'];
+        const wait = this.flags.wait;
+        const pollInterval = this.flags['poll-interval'];
+        const timeout = this.flags.timeout;
+        const setPermissions = this.flags['set-permissions'];
+        const permissionsClientId = this.flags['permissions-client-id'];
+        const ocapiSettingsRaw = this.flags['ocapi-settings'];
+        const webdavSettingsRaw = this.flags['webdav-settings'];
+        const startSchedulerRaw = this.flags['start-scheduler'];
+        const stopSchedulerRaw = this.flags['stop-scheduler'];
+        this.log(t('commands.sandbox.create.creating', 'Creating sandbox in realm {{realm}}...', { realm }));
+        this.log(t('commands.sandbox.create.profile', 'Profile: {{profile}}', { profile }));
+        this.log(t('commands.sandbox.create.ttl', 'TTL: {{ttl}} hours', { ttl: ttl === 0 ? 'infinite' : String(ttl) }));
+        // Build settings with OCAPI and WebDAV permissions if enabled
+        const settings = this.buildSettings({
+            setPermissions,
+            permissionsClientId,
+            ocapiSettings: ocapiSettingsRaw,
+            webdavSettings: webdavSettingsRaw,
+        });
+        if (settings) {
+            const effectiveClientId = permissionsClientId || this.resolvedConfig.values.clientId;
+            const hasCustom = ocapiSettingsRaw || webdavSettingsRaw;
+            this.log(t('commands.sandbox.create.settingPermissions', 'Setting OCAPI and WebDAV permissions for client ID: {{clientId}}', { clientId: hasCustom ? 'custom settings' : effectiveClientId }));
+        }
+        // Parse scheduler flags
+        const startScheduler = startSchedulerRaw ? this.parseJsonFlag('start-scheduler', startSchedulerRaw) : undefined;
+        const stopScheduler = stopSchedulerRaw ? this.parseJsonFlag('stop-scheduler', stopSchedulerRaw) : undefined;
+        const result = await this.odsClient.POST('/sandboxes', {
+            body: {
+                realm,
+                ttl,
+                resourceProfile: profile,
+                autoScheduled,
+                analyticsEnabled: false,
+                settings,
+                startScheduler,
+                stopScheduler,
+            },
+        });
+        if (!result.data?.data) {
+            this.error(t('commands.sandbox.create.error', 'Failed to create sandbox: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        let sandbox = result.data.data;
+        this.log('');
+        this.logger.info({ sandboxId: sandbox.id }, t('commands.sandbox.create.success', 'Sandbox created successfully'));
+        if (wait && sandbox.id) {
+            this.log(t('commands.sandbox.create.waiting', 'Waiting for sandbox to get started..'));
+            try {
+                await waitForSandbox(this.odsClient, {
+                    sandboxId: sandbox.id,
+                    targetState: 'started',
+                    pollIntervalSeconds: pollInterval,
+                    timeoutSeconds: timeout,
+                    onPoll: ({ elapsedSeconds, state }) => {
+                        this.logger.info({ sandboxId: sandbox.id, elapsed: elapsedSeconds, state }, `[${elapsedSeconds}s] State: ${state}`);
+                    },
+                });
+            }
+            catch (error) {
+                if (error instanceof SandboxPollingTimeoutError) {
+                    this.error(t('commands.sandbox.create.timeout', 'Timeout waiting for sandbox after {{seconds}} seconds', {
+                        seconds: String(error.timeoutSeconds),
+                    }));
+                }
+                if (error instanceof SandboxTerminalStateError) {
+                    if (error.state === 'deleted') {
+                        this.error(t('commands.sandbox.create.deleted', 'Sandbox was deleted'));
+                    }
+                    this.error(t('commands.sandbox.create.failed', 'Sandbox creation failed'));
+                }
+                if (error instanceof SandboxPollingError) {
+                    this.error(t('commands.sandbox.create.pollError', 'Failed to fetch sandbox status: {{message}}', {
+                        message: error.message,
+                    }));
+                }
+                throw error;
+            }
+            const finalResult = await this.odsClient.GET('/sandboxes/{sandboxId}', {
+                params: {
+                    path: { sandboxId: sandbox.id },
+                },
+            });
+            if (!finalResult.data?.data) {
+                this.error(t('commands.sandbox.create.pollError', 'Failed to fetch sandbox status: {{message}}', {
+                    message: finalResult.response?.statusText || 'Unknown error',
+                }));
+            }
+            sandbox = finalResult.data.data;
+            this.log('');
+            this.logger.info({ sandboxId: sandbox.id }, t('commands.sandbox.create.ready', 'Sandbox is now ready'));
+        }
+        if (this.jsonEnabled()) {
+            return sandbox;
+        }
+        this.printSandboxSummary(sandbox);
+        return sandbox;
+    }
+    /**
+     * Builds the sandbox settings object with OCAPI and WebDAV permissions.
+     * @returns Settings object or undefined if permissions should not be set
+     */
+    buildSettings(options) {
+        if (!options.setPermissions) {
+            return undefined;
+        }
+        const hasCustomOcapi = options.ocapiSettings !== undefined;
+        const hasCustomWebdav = options.webdavSettings !== undefined;
+        const clientId = options.permissionsClientId || this.resolvedConfig.values.clientId;
+        // If no custom settings and no client ID, we can't build defaults
+        if (!hasCustomOcapi && !hasCustomWebdav && !clientId) {
+            return undefined;
+        }
+        const ocapi = hasCustomOcapi
+            ? this.parseJsonFlag('ocapi-settings', options.ocapiSettings)
+            : clientId
+                ? [{ client_id: clientId, resources: DEFAULT_OCAPI_RESOURCES }]
+                : [];
+        const webdav = hasCustomWebdav
+            ? this.parseJsonFlag('webdav-settings', options.webdavSettings)
+            : clientId
+                ? [{ client_id: clientId, permissions: DEFAULT_WEBDAV_PERMISSIONS }]
+                : [];
+        return { ocapi, webdav };
+    }
+    parseJsonFlag(flagName, value) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            this.error(`Invalid JSON for --${flagName}: ${value}`);
+        }
+    }
+    printSandboxSummary(sandbox) {
+        const ui = cliui({ width: process.stdout.columns || 80 });
+        ui.div({ text: '', padding: [0, 0, 0, 0] });
+        const fields = [
+            ['ID', sandbox.id],
+            ['Realm', sandbox.realm],
+            ['Instance', sandbox.instance],
+            ['State', sandbox.state],
+            ['Profile', sandbox.resourceProfile],
+            ['Hostname', sandbox.hostName],
+        ];
+        for (const [label, value] of fields) {
+            if (value !== undefined) {
+                ui.div({ text: `${label}:`, width: 15, padding: [0, 2, 0, 0] }, { text: value, padding: [0, 0, 0, 0] });
+            }
+        }
+        if (sandbox.links?.bm) {
+            ui.div({ text: '', padding: [0, 0, 0, 0] });
+            ui.div({ text: 'BM URL:', width: 15, padding: [0, 2, 0, 0] }, { text: sandbox.links.bm, padding: [0, 0, 0, 0] });
+        }
+        ux.stdout(ui.toString());
+    }
+}
+//# sourceMappingURL=create.js.map