@salesforce/b2c-cli 0.3.0 → 0.4.0

package/dist/commands/{ods → sandbox}/list.js

@@ -58,8 +58,9 @@ const tableRenderer = new TableRenderer(COLUMNS);
 /**
  * Command to list all on-demand sandboxes.
  */
-export default class OdsList extends OdsCommand {
-    static description = withDocs(t('commands.ods.list.description', 'List all on-demand sandboxes'), '/cli/ods.html#b2c-ods-list');
+export default class SandboxList extends OdsCommand {
+    static aliases = ['ods:list'];
+    static description = withDocs(t('commands.sandbox.list.description', 'List all on-demand sandboxes'), '/cli/sandbox.html#b2c-sandbox-list');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -109,7 +110,7 @@ export default class OdsList extends OdsCommand {
             }
             filterParams = parts.join('&');
         }
-        this.log(t('commands.ods.list.fetching', 'Fetching sandboxes from {{host}}...', { host }));
+        this.log(t('commands.sandbox.list.fetching', 'Fetching sandboxes from {{host}}...', { host }));
         const result = await this.odsClient.GET('/sandboxes', {
             params: {
                 query: {
@@ -119,7 +120,7 @@ export default class OdsList extends OdsCommand {
             },
         });
         if (result.error) {
-            this.error(t('commands.ods.list.error', 'Failed to fetch sandboxes: {{message}}', {
+            this.error(t('commands.sandbox.list.error', 'Failed to fetch sandboxes: {{message}}', {
                 message: getApiErrorMessage(result.error, result.response),
             }));
         }
@@ -132,7 +133,7 @@ export default class OdsList extends OdsCommand {
             return response;
         }
         if (sandboxes.length === 0) {
-            this.log(t('commands.ods.list.noSandboxes', 'No sandboxes found.'));
+            this.log(t('commands.sandbox.list.noSandboxes', 'No sandboxes found.'));
             return response;
         }
         tableRenderer.render(sandboxes, this.getSelectedColumns());

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

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

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

@@ -4,13 +4,19 @@ type SandboxOperationModel = OdsComponents['schemas']['SandboxOperationModel'];
 /**
  * Command to restart an on-demand sandbox.
  */
-export default class OdsRestart extends OdsCommand<typeof OdsRestart> {
+export default class SandboxRestart extends OdsCommand<typeof SandboxRestart> {
+    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: {
+        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<SandboxOperationModel>;
 }
 export {};

package/dist/commands/sandbox/restart.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { 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';
+/**
+ * Command to restart an on-demand sandbox.
+ */
+export default class SandboxRestart extends OdsCommand {
+    static aliases = ['ods:restart'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., abcd-123)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.restart.description', 'Restart an on-demand sandbox'), '/cli/sandbox.html#b2c-sandbox-restart');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> abc12345-1234-1234-1234-abc123456789',
+        '<%= config.bin %> <%= command.id %> zzzv-123',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --wait',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --wait --poll-interval 15',
+        '<%= config.bin %> <%= command.id %> zzzv_123 --json',
+    ];
+    static flags = {
+        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'],
+        }),
+    };
+    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;
+        this.log(t('commands.sandbox.restart.restarting', 'Restarting sandbox {{sandboxId}}...', { sandboxId }));
+        const result = await this.odsClient.POST('/sandboxes/{sandboxId}/operations', {
+            params: {
+                path: { sandboxId },
+            },
+            body: {
+                operation: 'restart',
+            },
+        });
+        if (!result.data?.data) {
+            this.error(t('commands.sandbox.restart.error', 'Failed to restart sandbox: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        const operation = result.data.data;
+        this.log(t('commands.sandbox.restart.success', 'Restart operation {{operationState}}. Sandbox state: {{sandboxState}}', {
+            operationState: operation.operationState,
+            sandboxState: operation.sandboxState || 'unknown',
+        }));
+        if (wait) {
+            try {
+                await waitForSandbox(this.odsClient, {
+                    sandboxId,
+                    targetState: 'started',
+                    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.restart.timeout', 'Timeout waiting for sandbox after {{seconds}} seconds', {
+                        seconds: String(error.timeoutSeconds),
+                    }));
+                }
+                if (error instanceof SandboxTerminalStateError) {
+                    this.error(t('commands.sandbox.restart.failed', 'Sandbox did not reach the expected state. Current state: {{state}}', {
+                        state: error.state || 'unknown',
+                    }));
+                }
+                if (error instanceof SandboxPollingError) {
+                    this.error(t('commands.sandbox.restart.pollError', 'Failed to fetch sandbox status: {{message}}', {
+                        message: error.message,
+                    }));
+                }
+                throw error;
+            }
+            this.log('');
+            this.logger.info({ sandboxId }, t('commands.sandbox.restart.ready', 'Sandbox is now ready'));
+        }
+        return operation;
+    }
+}
+//# sourceMappingURL=restart.js.map

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

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

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

@@ -4,13 +4,19 @@ type SandboxOperationModel = OdsComponents['schemas']['SandboxOperationModel'];
 /**
  * Command to start an on-demand sandbox.
  */
-export default class OdsStart extends OdsCommand<typeof OdsStart> {
+export default class SandboxStart extends OdsCommand<typeof SandboxStart> {
+    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: {
+        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<SandboxOperationModel>;
 }
 export {};

package/dist/commands/sandbox/start.js

@@ -0,0 +1,108 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { 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';
+/**
+ * Command to start an on-demand sandbox.
+ */
+export default class SandboxStart extends OdsCommand {
+    static aliases = ['ods:start'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., abcd-123)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.start.description', 'Start an on-demand sandbox'), '/cli/sandbox.html#b2c-sandbox-start');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> abc12345-1234-1234-1234-abc123456789',
+        '<%= config.bin %> <%= command.id %> zzzv-123',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --wait',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --wait --poll-interval 15',
+        '<%= config.bin %> <%= command.id %> zzzv_123 --json',
+    ];
+    static flags = {
+        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'],
+        }),
+    };
+    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;
+        this.log(t('commands.sandbox.start.starting', 'Starting sandbox {{sandboxId}}...', { sandboxId }));
+        const result = await this.odsClient.POST('/sandboxes/{sandboxId}/operations', {
+            params: {
+                path: { sandboxId },
+            },
+            body: {
+                operation: 'start',
+            },
+        });
+        if (!result.data?.data) {
+            this.error(t('commands.sandbox.start.error', 'Failed to start sandbox: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        const operation = result.data.data;
+        this.log(t('commands.sandbox.start.success', 'Start operation {{operationState}}. Sandbox state: {{sandboxState}}', {
+            operationState: operation.operationState,
+            sandboxState: operation.sandboxState || 'unknown',
+        }));
+        if (wait) {
+            this.log(t('commands.sandbox.start.waiting', 'Waiting for sandbox to reach state {{state}}...', { state: 'started' }));
+            try {
+                await waitForSandbox(this.odsClient, {
+                    sandboxId,
+                    targetState: 'started',
+                    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.start.timeout', 'Timeout waiting for sandbox after {{seconds}} seconds', {
+                        seconds: String(error.timeoutSeconds),
+                    }));
+                }
+                if (error instanceof SandboxTerminalStateError) {
+                    this.error(t('commands.sandbox.start.failed', 'Sandbox did not reach the expected state. Current state: {{state}}', {
+                        state: error.state || 'unknown',
+                    }));
+                }
+                if (error instanceof SandboxPollingError) {
+                    this.error(t('commands.sandbox.start.pollError', 'Failed to fetch sandbox status: {{message}}', {
+                        message: error.message,
+                    }));
+                }
+                throw error;
+            }
+            this.log('');
+            this.logger.info({ sandboxId }, t('commands.sandbox.start.ready', 'Sandbox is now ready'));
+        }
+        return operation;
+    }
+}
+//# sourceMappingURL=start.js.map

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

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

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

@@ -4,13 +4,19 @@ type SandboxOperationModel = OdsComponents['schemas']['SandboxOperationModel'];
 /**
  * Command to stop an on-demand sandbox.
  */
-export default class OdsStop extends OdsCommand<typeof OdsStop> {
+export default class SandboxStop extends OdsCommand<typeof SandboxStop> {
+    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: {
+        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<SandboxOperationModel>;
 }
 export {};

package/dist/commands/sandbox/stop.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { 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';
+/**
+ * Command to stop an on-demand sandbox.
+ */
+export default class SandboxStop extends OdsCommand {
+    static aliases = ['ods:stop'];
+    static args = {
+        sandboxId: Args.string({
+            description: 'Sandbox ID (UUID or realm-instance, e.g., abcd-123)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.sandbox.stop.description', 'Stop an on-demand sandbox'), '/cli/sandbox.html#b2c-sandbox-stop');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> abc12345-1234-1234-1234-abc123456789',
+        '<%= config.bin %> <%= command.id %> zzzv-123',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --wait',
+        '<%= config.bin %> <%= command.id %> zzzv-123 --wait --poll-interval 15',
+        '<%= config.bin %> <%= command.id %> zzzv_123 --json',
+    ];
+    static flags = {
+        wait: Flags.boolean({
+            char: 'w',
+            description: 'Wait for the sandbox to reach stopped 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'],
+        }),
+    };
+    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;
+        this.log(t('commands.sandbox.stop.stopping', 'Stopping sandbox {{sandboxId}}...', { sandboxId }));
+        const result = await this.odsClient.POST('/sandboxes/{sandboxId}/operations', {
+            params: {
+                path: { sandboxId },
+            },
+            body: {
+                operation: 'stop',
+            },
+        });
+        if (!result.data?.data) {
+            this.error(t('commands.sandbox.stop.error', 'Failed to stop sandbox: {{message}}', {
+                message: getApiErrorMessage(result.error, result.response),
+            }));
+        }
+        const operation = result.data.data;
+        this.log(t('commands.sandbox.stop.success', 'Stop operation {{operationState}}. Sandbox state: {{sandboxState}}', {
+            operationState: operation.operationState,
+            sandboxState: operation.sandboxState || 'unknown',
+        }));
+        if (wait) {
+            try {
+                await waitForSandbox(this.odsClient, {
+                    sandboxId,
+                    targetState: 'stopped',
+                    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.stop.timeout', 'Timeout waiting for sandbox after {{seconds}} seconds', {
+                        seconds: String(error.timeoutSeconds),
+                    }));
+                }
+                if (error instanceof SandboxTerminalStateError) {
+                    this.error(t('commands.sandbox.stop.failed', 'Sandbox did not reach the expected state. Current state: {{state}}', {
+                        state: error.state || 'unknown',
+                    }));
+                }
+                if (error instanceof SandboxPollingError) {
+                    this.error(t('commands.sandbox.stop.pollError', 'Failed to fetch sandbox status: {{message}}', {
+                        message: error.message,
+                    }));
+                }
+                throw error;
+            }
+            this.log('');
+            this.logger.info({ sandboxId }, t('commands.sandbox.stop.ready', 'Sandbox is now stopped'));
+        }
+        return operation;
+    }
+}
+//# sourceMappingURL=stop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/commands/sandbox/stop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,GAEf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAIhD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,UAA8B;IACrE,MAAM,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;IAE9B,MAAM,CAAC,IAAI,GAAG;QACZ,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,mCAAmC,EAAE,2BAA2B,CAAC,EACnE,oCAAoC,CACrC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,0EAA0E;QAC1E,8CAA8C;QAC9C,qDAAqD;QACrD,wEAAwE;QACxE,qDAAqD;KACtD,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,wEAAwE;YACrF,OAAO,EAAE,KAAK;SACf,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC;YAC7B,WAAW,EAAE,+CAA+C;YAC5D,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,WAAW,EAAE,sEAAsE;YACnF,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAEnC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gCAAgC,EAAE,mCAAmC,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC,CAAC;QAEhG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,mCAAmC,EAAE;YAC5E,MAAM,EAAE;gBACN,IAAI,EAAE,EAAC,SAAS,EAAC;aAClB;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,MAAM;aAClB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,6BAA6B,EAAE,qCAAqC,EAAE;gBACtE,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC;aAC3D,CAAC,CACH,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAEnC,IAAI,CAAC,GAAG,CACN,CAAC,CAAC,+BAA+B,EAAE,oEAAoE,EAAE;YACvG,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,SAAS;SAClD,CAAC,CACH,CAAC;QACF,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE;oBACnC,SAAS;oBACT,WAAW,EAAE,SAAS;oBACtB,mBAAmB,EAAE,YAAY;oBACjC,cAAc,EAAE,OAAO;oBACvB,MAAM,EAAE,CAAC,EAAC,cAAc,EAAE,KAAK,EAAC,EAAE,EAAE;wBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAC,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAC,EAAE,IAAI,cAAc,aAAa,KAAK,EAAE,CAAC,CAAC;oBACxG,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,0BAA0B,EAAE,CAAC;oBAChD,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,+BAA+B,EAAE,uDAAuD,EAAE;wBAC1F,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;qBACtC,CAAC,CACH,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;oBAC/C,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,8BAA8B,EAAE,oEAAoE,EAAE;wBACtG,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;qBAChC,CAAC,CACH,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;oBACzC,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,iCAAiC,EAAE,6CAA6C,EAAE;wBAClF,OAAO,EAAE,KAAK,CAAC,OAAO;qBACvB,CAAC,CACH,CAAC;gBACJ,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAC,SAAS,EAAC,EAAE,CAAC,CAAC,6BAA6B,EAAE,wBAAwB,CAAC,CAAC,CAAC;QAC5F,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC"}

package/dist/commands/scaffold/generate.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type GenerateResponse } from '../../lib/scaffold/generate-helper.js';
+export type { GenerateResponse } from '../../lib/scaffold/generate-helper.js';
+/**
+ * Command to generate a project from a scaffold.
+ */
+export default class ScaffoldGenerate extends BaseCommand<typeof ScaffoldGenerate> {
+    static args: {
+        scaffoldId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        option: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<GenerateResponse | void>;
+}

package/dist/commands/scaffold/generate.js

@@ -0,0 +1,74 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { executeScaffoldGenerate } from '../../lib/scaffold/generate-helper.js';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Command to generate a project from a scaffold.
+ */
+export default class ScaffoldGenerate extends BaseCommand {
+    static args = {
+        scaffoldId: Args.string({
+            description: 'Scaffold ID to generate',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.scaffold.generate.description', 'Generate files from a scaffold template'), '/cli/scaffold.html#b2c-scaffold-generate');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> cartridge',
+        '<%= config.bin %> <%= command.id %> cartridge --name app_custom',
+        '<%= config.bin %> <%= command.id %> custom-api --option apiName=my-api --option cartridgeName=app_custom',
+        '<%= config.bin %> <%= command.id %> cartridge --dry-run',
+        '<%= config.bin %> <%= command.id %> cartridge --force',
+        '<%= config.bin %> <%= command.id %> cartridge --output ./src',
+    ];
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            description: 'Primary name parameter (shorthand for --option name=VALUE)',
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output directory (defaults to scaffold default or current directory)',
+        }),
+        option: Flags.string({
+            description: 'Parameter value in key=value format (can be repeated)',
+            multiple: true,
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Preview files without writing them',
+            default: false,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip prompts, use defaults, and overwrite existing files',
+            default: false,
+        }),
+    };
+    async run() {
+        const projectRoot = this.flags['working-directory'] || process.cwd();
+        const response = await executeScaffoldGenerate({
+            scaffoldId: this.args.scaffoldId,
+            name: this.flags.name,
+            output: this.flags.output,
+            options: this.flags.option,
+            dryRun: this.flags['dry-run'],
+            force: this.flags.force,
+            projectRoot,
+        }, {
+            logger: this.logger,
+            log: (msg) => this.log(msg),
+            warn: (msg) => this.warn(msg),
+            error: (msg) => this.error(msg),
+        });
+        if (this.jsonEnabled()) {
+            return response;
+        }
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/scaffold/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/commands/scaffold/generate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,uBAAuB,EAAwB,MAAM,uCAAuC,CAAC;AACrG,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAIhD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAoC;IAChF,MAAM,CAAC,IAAI,GAAG;QACZ,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,wCAAwC,EAAE,yCAAyC,CAAC,EACtF,0CAA0C,CAC3C,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,+CAA+C;QAC/C,iEAAiE;QACjE,0GAA0G;QAC1G,yDAAyD;QACzD,uDAAuD;QACvD,8DAA8D;KAC/D,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,4DAA4D;SAC1E,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,sEAAsE;SACpF,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;YACvB,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,KAAK;SACf,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,0DAA0D;YACvE,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAC5C;YACE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YAC1B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,WAAW;SACZ,EACD;YACE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;SAChC,CACF,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC"}

package/dist/commands/scaffold/index.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type GenerateResponse } from '../../lib/scaffold/generate-helper.js';
+/**
+ * Default scaffold command - provides topic help and shorthand for `scaffold generate`.
+ *
+ * - `b2c scaffold` shows topic help with available subcommands
+ * - `b2c scaffold cartridge` is shorthand for `b2c scaffold generate cartridge`
+ */
+export default class ScaffoldIndex extends BaseCommand<typeof ScaffoldIndex> {
+    static args: {
+        scaffoldId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        option: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<GenerateResponse | void>;
+}