@salesforce/b2c-cli 0.3.0 → 0.4.1

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/{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/{ods → sandbox}/create.js

@@ -6,10 +6,8 @@
 import { 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 { getApiErrorMessage, SandboxPollingError, SandboxPollingTimeoutError, SandboxTerminalStateError, waitForSandbox, } from '@salesforce/b2c-tooling-sdk';
 import { t, withDocs } from '../../i18n/index.js';
-/** States that indicate sandbox creation has completed (success or failure) */
-const TERMINAL_STATES = new Set(['deleted', 'failed', 'started']);
 /**
  * Default OCAPI resources to grant the client ID access to.
  * These enable common CI/CD operations like code deployment and job execution.
@@ -33,8 +31,9 @@ const DEFAULT_WEBDAV_PERMISSIONS = [
 /**
  * Command to create a new on-demand sandbox.
  */
-export default class OdsCreate extends OdsCommand {
-    static description = withDocs(t('commands.ods.create.description', 'Create a new on-demand sandbox'), '/cli/ods.html#b2c-ods-create');
+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',
@@ -84,6 +83,21 @@ export default class OdsCreate extends OdsCommand {
             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;
@@ -94,14 +108,29 @@ export default class OdsCreate extends OdsCommand {
         const pollInterval = this.flags['poll-interval'];
         const timeout = this.flags.timeout;
         const setPermissions = this.flags['set-permissions'];
-        this.log(t('commands.ods.create.creating', 'Creating sandbox in realm {{realm}}...', { realm }));
-        this.log(t('commands.ods.create.profile', 'Profile: {{profile}}', { profile }));
-        this.log(t('commands.ods.create.ttl', 'TTL: {{ttl}} hours', { ttl: ttl === 0 ? 'infinite' : String(ttl) }));
+        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);
+        const settings = this.buildSettings({
+            setPermissions,
+            permissionsClientId,
+            ocapiSettings: ocapiSettingsRaw,
+            webdavSettings: webdavSettingsRaw,
+        });
         if (settings) {
-            this.log(t('commands.ods.create.settingPermissions', 'Setting OCAPI and WebDAV permissions for client ID: {{clientId}}', { clientId: this.resolvedConfig.values.clientId }));
+            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,
@@ -110,19 +139,63 @@ export default class OdsCreate extends OdsCommand {
                 autoScheduled,
                 analyticsEnabled: false,
                 settings,
+                startScheduler,
+                stopScheduler,
             },
         });
         if (!result.data?.data) {
-            this.error(t('commands.ods.create.error', 'Failed to create sandbox: {{message}}', {
+            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.ods.create.success', 'Sandbox created successfully'));
+        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('');
-            sandbox = await this.waitForSandbox(sandbox.id, pollInterval, timeout);
+            this.logger.info({ sandboxId: sandbox.id }, t('commands.sandbox.create.ready', 'Sandbox is now ready'));
         }
         if (this.jsonEnabled()) {
             return sandbox;
@@ -132,31 +205,38 @@ export default class OdsCreate extends OdsCommand {
     }
     /**
      * 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
      */
-    buildSettings(setPermissions) {
-        if (!setPermissions) {
+    buildSettings(options) {
+        if (!options.setPermissions) {
             return undefined;
         }
-        const clientId = this.resolvedConfig.values.clientId;
-        if (!clientId) {
+        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;
         }
-        return {
-            ocapi: [
-                {
-                    client_id: clientId,
-                    resources: DEFAULT_OCAPI_RESOURCES,
-                },
-            ],
-            webdav: [
-                {
-                    client_id: clientId,
-                    permissions: DEFAULT_WEBDAV_PERMISSIONS,
-                },
-            ],
-        };
+        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 });
@@ -180,75 +260,5 @@ export default class OdsCreate extends OdsCommand {
         }
         ux.stdout(ui.toString());
     }
-    /**
-     * Sleep for a given number of milliseconds.
-     */
-    async sleep(ms) {
-        await new Promise((resolve) => {
-            setTimeout(resolve, ms);
-        });
-    }
-    /**
-     * 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
-     */
-    async waitForSandbox(sandboxId, pollIntervalSeconds, timeoutSeconds) {
-        const startTime = Date.now();
-        const pollIntervalMs = pollIntervalSeconds * 1000;
-        const timeoutMs = timeoutSeconds * 1000;
-        this.log(t('commands.ods.create.waiting', 'Waiting for sandbox to be ready...'));
-        // Initial delay before first poll to allow the sandbox to be registered in the API
-        await this.sleep(pollIntervalMs);
-        while (true) {
-            // Check for timeout
-            if (timeoutSeconds > 0 && Date.now() - startTime > timeoutMs) {
-                this.error(t('commands.ods.create.timeout', 'Timeout waiting for sandbox after {{seconds}} seconds', {
-                    seconds: String(timeoutSeconds),
-                }));
-            }
-            // eslint-disable-next-line no-await-in-loop
-            const result = await this.odsClient.GET('/sandboxes/{sandboxId}', {
-                params: {
-                    path: { sandboxId },
-                },
-            });
-            if (!result.data?.data) {
-                this.error(t('commands.ods.create.pollError', 'Failed to fetch sandbox status: {{message}}', {
-                    message: result.response?.statusText || 'Unknown error',
-                }));
-            }
-            const sandbox = result.data.data;
-            const currentState = sandbox.state;
-            // Log current state on each poll
-            const elapsed = Math.round((Date.now() - startTime) / 1000);
-            const state = currentState || 'unknown';
-            this.logger.info({ sandboxId, elapsed, state }, `[${elapsed}s] State: ${state}`);
-            // Check for terminal states
-            if (currentState && TERMINAL_STATES.has(currentState)) {
-                switch (currentState) {
-                    case 'deleted': {
-                        this.error(t('commands.ods.create.deleted', 'Sandbox was deleted'));
-                        break;
-                    }
-                    case 'failed': {
-                        this.error(t('commands.ods.create.failed', 'Sandbox creation failed'));
-                        break;
-                    }
-                    case 'started': {
-                        this.log('');
-                        this.logger.info({ sandboxId }, t('commands.ods.create.ready', 'Sandbox is now ready'));
-                        break;
-                    }
-                }
-                return sandbox;
-            }
-            // Wait before next poll
-            // eslint-disable-next-line no-await-in-loop
-            await this.sleep(pollIntervalMs);
-        }
-    }
 }
 //# sourceMappingURL=create.js.map

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

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

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

@@ -0,0 +1,19 @@
+import { OdsCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * Command to delete an on-demand sandbox.
+ */
+export default class SandboxDelete extends OdsCommand<typeof SandboxDelete> {
+    static aliases: string[];
+    static args: {
+        sandboxId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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<void>;
+}

package/dist/commands/sandbox/delete.js

@@ -0,0 +1,141 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import * as readline from 'node:readline';
+import { Args, Flags } from '@oclif/core';
+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';
+/**
+ * Simple confirmation prompt.
+ */
+async function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stderr,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
+/**
+ * Command to delete an on-demand sandbox.
+ */
+export default class SandboxDelete extends OdsCommand {
+    static aliases = ['ods:delete'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., abcd-123)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.delete.description', 'Delete an on-demand sandbox'), '/cli/sandbox.html#b2c-sandbox-delete');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> abc12345-1234-1234-1234-abc123456789',
+        '<%= config.bin %> <%= command.id %> zzzv-123',
+        '<%= config.bin %> <%= command.id %> zzzv_123 --force',
+    ];
+    static flags = {
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation prompt',
+            default: false,
+        }),
+        wait: Flags.boolean({
+            char: 'w',
+            description: 'Wait for the sandbox to be fully deleted 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'],
+        }),
+    };
+    async run() {
+        const sandboxId = await this.resolveSandboxId(this.args.sandboxId);
+        const wait = this.flags.wait;
+        const pollInterval = this.flags['poll-interval'];
+        const timeout = this.flags.timeout;
+        // Get sandbox details first to show in confirmation
+        const getResult = await this.odsClient.GET('/sandboxes/{sandboxId}', {
+            params: {
+                path: { sandboxId },
+            },
+        });
+        if (!getResult.data?.data) {
+            this.error(t('commands.sandbox.delete.notFound', 'Sandbox not found: {{sandboxId}}', { sandboxId }));
+        }
+        const sandbox = getResult.data.data;
+        const sandboxInfo = `${sandbox.realm}/${sandbox.instance || sandboxId}`;
+        // Confirm deletion unless --force is used
+        if (!this.flags.force) {
+            const confirmed = await confirm(t('commands.sandbox.delete.confirm', 'Are you sure you want to delete sandbox "{{sandboxInfo}}"? (y/n)', {
+                sandboxInfo,
+            }));
+            if (!confirmed) {
+                this.log(t('commands.sandbox.delete.cancelled', 'Deletion cancelled'));
+                return;
+            }
+        }
+        this.log(t('commands.sandbox.delete.deleting', 'Deleting sandbox {{sandboxInfo}}...', { sandboxInfo }));
+        const result = await this.odsClient.DELETE('/sandboxes/{sandboxId}', {
+            params: {
+                path: { sandboxId },
+            },
+        });
+        if (result.response.status !== 202) {
+            this.error(t('commands.sandbox.delete.error', 'Failed to delete sandbox: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        this.log(t('commands.sandbox.delete.success', 'Sandbox deletion initiated. The sandbox will be removed shortly.'));
+        if (wait) {
+            this.log(t('commands.sandbox.delete.waiting', 'Waiting for sandbox to reach state {{state}}...', {
+                state: 'deleted',
+            }));
+            try {
+                await waitForSandbox(this.odsClient, {
+                    sandboxId,
+                    targetState: 'deleted',
+                    pollIntervalSeconds: pollInterval,
+                    timeoutSeconds: timeout,
+                    onPoll: ({ elapsedSeconds, state }) => {
+                        this.logger.info({ sandboxId, elapsed: elapsedSeconds, state }, `[${elapsedSeconds}s] State: ${state}`);
+                    },
+                });
+            }
+            catch (error) {
+                if (error instanceof SandboxPollingTimeoutError) {
+                    this.error(t('commands.sandbox.delete.timeout', 'Timeout waiting for sandbox after {{seconds}} seconds', {
+                        seconds: String(error.timeoutSeconds),
+                    }));
+                }
+                if (error instanceof SandboxTerminalStateError) {
+                    this.error(t('commands.sandbox.delete.failed', 'Sandbox did not reach the expected state. Current state: {{state}}', {
+                        state: error.state || 'unknown',
+                    }));
+                }
+                if (error instanceof SandboxPollingError) {
+                    this.error(t('commands.sandbox.delete.pollError', 'Failed to fetch sandbox status: {{message}}', {
+                        message: error.message,
+                    }));
+                }
+                throw error;
+            }
+            this.log('');
+            this.logger.info({ sandboxId }, t('commands.sandbox.delete.ready', 'Sandbox is now deleted'));
+        }
+    }
+}
+//# sourceMappingURL=delete.js.map