@salesforce/b2c-cli 0.6.0 → 0.7.1

package/dist/commands/sandbox/clone/create.d.ts

@@ -14,6 +14,9 @@ export default class CloneCreate extends OdsCommand<typeof CloneCreate> {
         'target-profile': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         emails: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         ttl: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        '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>;
     };
     run(): Promise<{
         cloneId?: string;

package/dist/commands/sandbox/clone/create.js

@@ -5,7 +5,7 @@
  */
 import { Args, Flags, Errors } from '@oclif/core';
 import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
-import { getApiErrorMessage } from '@salesforce/b2c-tooling-sdk';
+import { getApiErrorMessage, waitForClone, ClonePollingTimeoutError, ClonePollingError, CloneFailedError, } from '@salesforce/b2c-tooling-sdk';
 import { t } from '../../../i18n/index.js';
 /**
  * Command to create a sandbox clone.
@@ -25,6 +25,8 @@ export default class CloneCreate extends OdsCommand {
         '<%= config.bin %> <%= command.id %> <sandboxId> --target-profile large',
         '<%= config.bin %> <%= command.id %> <sandboxId> --ttl 48',
         '<%= config.bin %> <%= command.id %> <sandboxId> --target-profile large --ttl 48 --emails dev@example.com,qa@example.com',
+        '<%= config.bin %> <%= command.id %> <sandboxId> --wait',
+        '<%= config.bin %> <%= command.id %> <sandboxId> --wait --poll-interval 15',
     ];
     static flags = {
         'target-profile': Flags.string({
@@ -42,10 +44,25 @@ export default class CloneCreate extends OdsCommand {
             required: false,
             default: 24,
         }),
+        wait: Flags.boolean({
+            char: 'w',
+            description: 'Wait for the clone to complete 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: 1800,
+            dependsOn: ['wait'],
+        }),
     };
     async run() {
         const { sandboxId: rawSandboxId } = this.args;
-        const { 'target-profile': targetProfile, emails, ttl } = this.flags;
+        const { 'target-profile': targetProfile, emails, ttl, wait, 'poll-interval': pollInterval, timeout } = this.flags;
         // Validate TTL
         if (ttl > 0 && ttl < 24) {
             throw new Errors.CLIError(t('commands.clone.create.invalidTTL', 'TTL must be 0 or negative (infinite), or 24 hours or greater. Values between 1-23 are not allowed. Received: {{ttl}}', { ttl }));
@@ -75,12 +92,48 @@ export default class CloneCreate extends OdsCommand {
             this.error(t('commands.clone.create.error', 'Failed to create sandbox clone: {{message}}', { message }));
         }
         const cloneId = result.data.data?.cloneId;
-        if (this.jsonEnabled()) {
-            return { cloneId };
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.clone.create.success', '✓ Sandbox clone creation started successfully'));
+            this.log(t('commands.clone.create.cloneId', 'Clone ID: {{cloneId}}', { cloneId }));
+        }
+        if (wait && cloneId) {
+            this.log(t('commands.clone.create.waiting', 'Waiting for clone to complete...'));
+            try {
+                await waitForClone(this.odsClient, {
+                    sandboxId,
+                    cloneId,
+                    pollIntervalSeconds: pollInterval,
+                    timeoutSeconds: timeout,
+                    onPoll: ({ elapsedSeconds, status, progressPercentage }) => {
+                        const progress = progressPercentage === undefined ? '' : ` (${progressPercentage}%)`;
+                        this.logger.info({ sandboxId, cloneId, elapsed: elapsedSeconds, status }, `[${elapsedSeconds}s] Status: ${status}${progress}`);
+                    },
+                });
+            }
+            catch (error) {
+                if (error instanceof ClonePollingTimeoutError) {
+                    this.error(t('commands.clone.create.timeout', 'Timeout waiting for clone after {{seconds}} seconds', {
+                        seconds: String(error.timeoutSeconds),
+                    }));
+                }
+                if (error instanceof CloneFailedError) {
+                    this.error(t('commands.clone.create.failed', 'Clone operation failed'));
+                }
+                if (error instanceof ClonePollingError) {
+                    this.error(t('commands.clone.create.pollError', 'Failed to fetch clone status: {{message}}', {
+                        message: error.message,
+                    }));
+                }
+                throw error;
+            }
+            if (!this.jsonEnabled()) {
+                this.log(t('commands.clone.create.completed', '✓ Clone completed successfully'));
+            }
+        }
+        else if (!this.jsonEnabled()) {
+            const bin = this.config.bin;
+            this.log(t('commands.clone.create.checkStatus', '\nTo check the clone status, run:\n  {{bin}} sandbox clone get {{sandboxId}} {{cloneId}}', { bin, sandboxId, cloneId }));
         }
-        this.log(t('commands.clone.create.success', '✓ Sandbox clone creation started successfully'));
-        this.log(t('commands.clone.create.cloneId', 'Clone ID: {{cloneId}}', { cloneId }));
-        this.log(t('commands.clone.create.checkStatus', '\nTo check the clone status, run:\n  <%= config.bin %> ods clone get {{sandboxId}} {{cloneId}}', { sandboxId, cloneId }));
         return { cloneId };
     }
 }

package/dist/commands/sandbox/clone/create.js.map

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

package/dist/commands/sandbox/update.d.ts

@@ -0,0 +1,24 @@
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type OdsComponents } from '@salesforce/b2c-tooling-sdk';
+type SandboxModel = OdsComponents['schemas']['SandboxModel'];
+/**
+ * Command to update an on-demand sandbox.
+ */
+export default class SandboxUpdate extends OdsCommand<typeof SandboxUpdate> {
+    static aliases: string[];
+    static args: {
+        sandboxId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        ttl: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auto-scheduled': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        tags: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        emails: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<SandboxModel>;
+    private printSandboxSummary;
+}
+export {};

package/dist/commands/sandbox/update.js

@@ -0,0 +1,111 @@
+/*
+ * 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, ux } from '@oclif/core';
+import cliui from 'cliui';
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { getApiErrorMessage } from '@salesforce/b2c-tooling-sdk';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Command to update an on-demand sandbox.
+ */
+export default class SandboxUpdate extends OdsCommand {
+    static aliases = ['ods:update'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., abcd-123)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.update.description', 'Update a sandbox (extend TTL, change scheduling, update tags or emails)'), '/cli/sandbox.html#b2c-sandbox-update');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> zzzv-123 --ttl 48',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --ttl 0',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --auto-scheduled',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --no-auto-scheduled',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --tags tag1,tag2',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --emails user@example.com,dev@example.com',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --ttl 48 --tags ci,nightly --json',
+    ];
+    static flags = {
+        ttl: Flags.integer({
+            description: 'Number of hours to add to sandbox lifetime (0 or less for infinite)',
+        }),
+        'auto-scheduled': Flags.boolean({
+            description: 'Enable or disable automatic start/stop scheduling',
+            allowNo: true,
+        }),
+        tags: Flags.string({
+            description: 'Comma-separated list of tags',
+        }),
+        emails: Flags.string({
+            description: 'Comma-separated list of notification email addresses',
+        }),
+    };
+    async run() {
+        const sandboxId = await this.resolveSandboxId(this.args.sandboxId);
+        const { ttl, 'auto-scheduled': autoScheduled, tags, emails } = this.flags;
+        // Require at least one update flag
+        if (ttl === undefined && autoScheduled === undefined && tags === undefined && emails === undefined) {
+            this.error('At least one update flag is required. Use --ttl, --auto-scheduled, --tags, or --emails.');
+        }
+        const body = {};
+        if (ttl !== undefined) {
+            body.ttl = ttl;
+        }
+        if (autoScheduled !== undefined) {
+            body.autoScheduled = autoScheduled;
+        }
+        if (tags !== undefined) {
+            body.tags = tags.split(',').map((tag) => tag.trim());
+        }
+        if (emails !== undefined) {
+            body.emails = emails.split(',').map((email) => email.trim());
+        }
+        this.log(t('commands.sandbox.update.updating', 'Updating sandbox {{sandboxId}}...', { sandboxId }));
+        const result = await this.odsClient.PATCH('/sandboxes/{sandboxId}', {
+            params: {
+                path: { sandboxId },
+            },
+            body,
+        });
+        if (!result.data?.data) {
+            const message = getApiErrorMessage(result.error, result.response);
+            this.error(`Failed to update sandbox: ${message}`);
+        }
+        const sandbox = result.data.data;
+        this.log(t('commands.sandbox.update.success', 'Sandbox updated successfully'));
+        if (this.jsonEnabled()) {
+            return sandbox;
+        }
+        this.printSandboxSummary(sandbox);
+        return sandbox;
+    }
+    printSandboxSummary(sandbox) {
+        const ui = cliui({ width: process.stdout.columns || 80 });
+        const fields = [
+            ['ID', sandbox.id],
+            ['Realm', sandbox.realm],
+            ['Instance', sandbox.instance],
+            ['State', sandbox.state],
+            ['Auto Scheduled', sandbox.autoScheduled?.toString()],
+            ['EOL', sandbox.eol ? new Date(sandbox.eol).toLocaleString() : undefined],
+        ];
+        if (sandbox.tags && sandbox.tags.length > 0) {
+            fields.push(['Tags', sandbox.tags.join(', ')]);
+        }
+        if (sandbox.emails && sandbox.emails.length > 0) {
+            fields.push(['Emails', sandbox.emails.join(', ')]);
+        }
+        for (const [label, value] of fields) {
+            if (value !== undefined) {
+                ui.div({ text: `${label}:`, width: 20, padding: [0, 2, 0, 0] }, { text: value, padding: [0, 0, 0, 0] });
+            }
+        }
+        ux.stdout(ui.toString());
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/sandbox/update.js.map

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

package/oclif.manifest.json

@@ -607,7 +607,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -903,7 +903,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1334,7 +1334,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10567,6 +10567,281 @@
         "stop.js"
       ]
     },
+    "sandbox:update": {
+      "aliases": [
+        "ods:update"
+      ],
+      "args": {
+        "sandboxId": {
+          "description": "Sandbox ID (UUID or realm-instance, e.g., abcd-123)",
+          "name": "sandboxId",
+          "required": true
+        }
+      },
+      "description": "Update a sandbox (extend TTL, change scheduling, update tags or emails)\n\nDocs: https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/sandbox.html#b2c-sandbox-update",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> zzzv-123 --ttl 48",
+        "<%= config.bin %> <%= command.id %> zzzv-123 --ttl 0",
+        "<%= config.bin %> <%= command.id %> zzzv-123 --auto-scheduled",
+        "<%= config.bin %> <%= command.id %> zzzv-123 --no-auto-scheduled",
+        "<%= config.bin %> <%= command.id %> zzzv-123 --tags tag1,tag2",
+        "<%= config.bin %> <%= command.id %> zzzv-123 --emails user@example.com,dev@example.com",
+        "<%= config.bin %> <%= command.id %> zzzv-123 --ttl 48 --tags ci,nightly --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output result as JSON",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-level": {
+          "description": "Set logging verbosity level",
+          "env": "SFCC_LOG_LEVEL",
+          "helpGroup": "GLOBAL",
+          "name": "log-level",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "trace",
+            "debug",
+            "info",
+            "warn",
+            "error",
+            "silent"
+          ],
+          "type": "option"
+        },
+        "debug": {
+          "char": "D",
+          "description": "Enable debug logging (shorthand for --log-level debug)",
+          "env": "SFCC_DEBUG",
+          "helpGroup": "GLOBAL",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "jsonl": {
+          "aliases": [
+            "json-logs"
+          ],
+          "description": "Output log messages as JSON lines",
+          "env": "SFCC_JSON_LOGS",
+          "helpGroup": "GLOBAL",
+          "name": "jsonl",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "lang": {
+          "char": "L",
+          "description": "Language for messages (e.g., en, de). Also respects LANGUAGE env var.",
+          "helpGroup": "GLOBAL",
+          "name": "lang",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "description": "Path to config file (in dw.json format; defaults to ./dw.json)",
+          "env": "SFCC_CONFIG",
+          "helpGroup": "GLOBAL",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instance": {
+          "char": "i",
+          "description": "Instance name from configuration file (i.e. dw.json, etc)",
+          "env": "SFCC_INSTANCE",
+          "helpGroup": "GLOBAL",
+          "name": "instance",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-directory": {
+          "aliases": [
+            "working-directory"
+          ],
+          "description": "Project directory",
+          "env": "SFCC_PROJECT_DIRECTORY",
+          "helpGroup": "GLOBAL",
+          "name": "project-directory",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "extra-query": {
+          "description": "Extra query parameters as JSON (e.g., '{\"debug\":\"true\"}')",
+          "env": "SFCC_EXTRA_QUERY",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "extra-query",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "extra-body": {
+          "description": "Extra body fields to merge as JSON (e.g., '{\"_internal\":true}')",
+          "env": "SFCC_EXTRA_BODY",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "extra-body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "extra-headers": {
+          "description": "Extra HTTP headers as JSON (e.g., '{\"X-Custom-Header\": \"value\"}')",
+          "env": "SFCC_EXTRA_HEADERS",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "extra-headers",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "client-id": {
+          "description": "Client ID for OAuth",
+          "env": "SFCC_CLIENT_ID",
+          "helpGroup": "AUTH",
+          "name": "client-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "client-secret": {
+          "description": "Client Secret for OAuth",
+          "env": "SFCC_CLIENT_SECRET",
+          "helpGroup": "AUTH",
+          "name": "client-secret",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "auth-scope": {
+          "description": "OAuth scopes to request (comma-separated)",
+          "env": "SFCC_OAUTH_SCOPES",
+          "helpGroup": "AUTH",
+          "name": "auth-scope",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "short-code": {
+          "description": "SCAPI short code",
+          "env": "SFCC_SHORTCODE",
+          "helpGroup": "AUTH",
+          "name": "short-code",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tenant-id": {
+          "aliases": [
+            "tenant"
+          ],
+          "description": "Organization/tenant ID",
+          "env": "SFCC_TENANT_ID",
+          "helpGroup": "AUTH",
+          "name": "tenant-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "auth-methods": {
+          "description": "Allowed auth methods in priority order (comma-separated)",
+          "env": "SFCC_AUTH_METHODS",
+          "exclusive": [
+            "user-auth"
+          ],
+          "helpGroup": "AUTH",
+          "name": "auth-methods",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "client-credentials",
+            "implicit",
+            "basic",
+            "api-key"
+          ],
+          "type": "option"
+        },
+        "user-auth": {
+          "description": "Use browser-based user authentication (implicit OAuth flow)",
+          "exclusive": [
+            "auth-methods"
+          ],
+          "helpGroup": "AUTH",
+          "name": "user-auth",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "account-manager-host": {
+          "description": "Account Manager hostname for OAuth (default: account.demandware.com)",
+          "env": "SFCC_ACCOUNT_MANAGER_HOST",
+          "helpGroup": "AUTH",
+          "name": "account-manager-host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sandbox-api-host": {
+          "description": "ODS API hostname (default: admin.dx.commercecloud.salesforce.com)",
+          "env": "SFCC_SANDBOX_API_HOST",
+          "name": "sandbox-api-host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ttl": {
+          "description": "Number of hours to add to sandbox lifetime (0 or less for infinite)",
+          "name": "ttl",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "auto-scheduled": {
+          "description": "Enable or disable automatic start/stop scheduling",
+          "name": "auto-scheduled",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "tags": {
+          "description": "Comma-separated list of tags",
+          "name": "tags",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "emails": {
+          "description": "Comma-separated list of notification email addresses",
+          "name": "emails",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sandbox:update",
+      "pluginAlias": "@salesforce/b2c-cli",
+      "pluginName": "@salesforce/b2c-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sandbox",
+        "update.js"
+      ]
+    },
     "sandbox:usage": {
       "aliases": [
         "ods:usage"
@@ -20366,7 +20641,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -20697,7 +20972,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -21028,7 +21303,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -21359,7 +21634,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -21690,7 +21965,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -22012,7 +22287,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -22343,7 +22618,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -22674,7 +22949,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -23018,7 +23293,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -23358,7 +23633,7 @@
           "description": "Inclusive end date (YYYY-MM-DD)",
           "helpGroup": "QUERY",
           "name": "to",
-          "default": "2026-03-09",
+          "default": "2026-03-11",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -35487,7 +35762,9 @@
         "<%= config.bin %> <%= command.id %> <sandboxId>",
         "<%= config.bin %> <%= command.id %> <sandboxId> --target-profile large",
         "<%= config.bin %> <%= command.id %> <sandboxId> --ttl 48",
-        "<%= config.bin %> <%= command.id %> <sandboxId> --target-profile large --ttl 48 --emails dev@example.com,qa@example.com"
+        "<%= config.bin %> <%= command.id %> <sandboxId> --target-profile large --ttl 48 --emails dev@example.com,qa@example.com",
+        "<%= config.bin %> <%= command.id %> <sandboxId> --wait",
+        "<%= config.bin %> <%= command.id %> <sandboxId> --wait --poll-interval 15"
       ],
       "flags": {
         "json": {
@@ -35729,6 +36006,35 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "description": "Wait for the clone to complete before returning",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "poll-interval": {
+          "dependsOn": [
+            "wait"
+          ],
+          "description": "Polling interval in seconds when using --wait",
+          "name": "poll-interval",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "dependsOn": [
+            "wait"
+          ],
+          "description": "Maximum time to wait in seconds when using --wait (0 for no timeout)",
+          "name": "timeout",
+          "default": 1800,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -51652,5 +51958,5 @@
       ]
     }
   },
-  "version": "0.6.0"
+  "version": "0.7.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-cli",
   "description": "A Salesforce B2C Commerce CLI",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "author": "Charles Lavery",
   "bin": {
     "b2c": "./bin/run.js"
@@ -25,7 +25,7 @@
     "marked": "15.0.12",
     "marked-terminal": "7.3.0",
     "open": "11.0.0",
-    "@salesforce/b2c-tooling-sdk": "0.7.0"
+    "@salesforce/b2c-tooling-sdk": "0.8.1"
   },
   "devDependencies": {
     "@eslint/compat": "^1",