@salesforce/b2c-cli 0.2.1 → 0.4.0

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":"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,YAAa,SAAQ,UAA+B;IACvE,MAAM,CAAC,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;IAE/B,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,oCAAoC,EAAE,4BAA4B,CAAC,EACrE,qCAAqC,CACtC,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,iCAAiC,EAAE,mCAAmC,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC,CAAC;QAEjG,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,OAAO;aACnB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,8BAA8B,EAAE,sCAAsC,EAAE;gBACxE,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,gCAAgC,EAAE,qEAAqE,EAAE;YACzG,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,GAAG,CACN,CAAC,CAAC,gCAAgC,EAAE,iDAAiD,EAAE,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAC3G,CAAC;YAEF,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,gCAAgC,EAAE,uDAAuD,EAAE;wBAC3F,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,+BAA+B,EAAE,oEAAoE,EAAE;wBACvG,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,kCAAkC,EAAE,6CAA6C,EAAE;wBACnF,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,8BAA8B,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC"}

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":"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"}

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>;
+}

package/dist/commands/scaffold/index.js

@@ -0,0 +1,80 @@
+/*
+ * 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';
+/**
+ * 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 {
+    static args = {
+        scaffoldId: Args.string({
+            description: 'Scaffold ID to generate (optional - omit to see available commands)',
+            required: false,
+        }),
+    };
+    static description = withDocs(t('commands.scaffold.index.description', 'Work with project scaffolds and templates'), '/cli/scaffold.html');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> scaffold --help',
+        '<%= config.bin %> scaffold list',
+        '<%= config.bin %> scaffold cartridge',
+        '<%= config.bin %> scaffold cartridge --name app_custom',
+    ];
+    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 { scaffoldId } = this.args;
+        if (!scaffoldId) {
+            // No scaffold specified - show topic help
+            await this.config.runCommand('help', ['scaffold']);
+            return;
+        }
+        // Scaffold specified - run generation
+        const response = await executeScaffoldGenerate({
+            scaffoldId,
+            name: this.flags.name,
+            output: this.flags.output,
+            options: this.flags.option,
+            dryRun: this.flags['dry-run'],
+            force: this.flags.force,
+        }, {
+            logger: this.logger,
+            log: (msg) => this.log(msg),
+            warn: (msg) => this.warn(msg),
+            error: (msg) => this.error(msg),
+        });
+        if (this.jsonEnabled()) {
+            return response;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/scaffold/index.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;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAiC;IAC1E,MAAM,CAAC,IAAI,GAAG;QACZ,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,qCAAqC,EAAE,2CAA2C,CAAC,EACrF,oBAAoB,CACrB,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,mCAAmC;QACnC,iCAAiC;QACjC,sCAAsC;QACtC,wDAAwD;KACzD,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,EAAC,UAAU,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAE/B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,0CAA0C;YAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,sCAAsC;QACtC,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAC5C;YACE,UAAU;YACV,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;SACxB,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/info.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type ScaffoldManifest } from '@salesforce/b2c-tooling-sdk/scaffold';
+/**
+ * Response type for the info command.
+ */
+interface ScaffoldInfoResponse {
+    id: string;
+    source: string;
+    manifest: ScaffoldManifest;
+    path: string;
+}
+/**
+ * Command to show detailed information about a scaffold.
+ */
+export default class ScaffoldInfo extends BaseCommand<typeof ScaffoldInfo> {
+    static args: {
+        scaffoldId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<ScaffoldInfoResponse>;
+}
+export {};

package/dist/commands/scaffold/info.js

@@ -0,0 +1,89 @@
+/*
+ * 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, ux } from '@oclif/core';
+import cliui from 'cliui';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { createScaffoldRegistry } from '@salesforce/b2c-tooling-sdk/scaffold';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Command to show detailed information about a scaffold.
+ */
+export default class ScaffoldInfo extends BaseCommand {
+    static args = {
+        scaffoldId: Args.string({
+            description: 'Scaffold ID to get info for',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.scaffold.info.description', 'Show detailed information about a scaffold'), '/cli/scaffold.html#b2c-scaffold-info');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> cartridge',
+        '<%= config.bin %> <%= command.id %> custom-api --json',
+    ];
+    async run() {
+        const { scaffoldId } = this.args;
+        const registry = createScaffoldRegistry();
+        const projectRoot = this.flags['working-directory'] || process.cwd();
+        const scaffold = await registry.getScaffold(scaffoldId, {
+            projectRoot,
+        });
+        if (!scaffold) {
+            this.error(t('commands.scaffold.info.scaffoldNotFound', 'Scaffold not found: {{id}}', { id: scaffoldId }));
+        }
+        const response = {
+            id: scaffold.id,
+            source: scaffold.source,
+            manifest: scaffold.manifest,
+            path: scaffold.path,
+        };
+        if (this.jsonEnabled()) {
+            return response;
+        }
+        // Display formatted output
+        const ui = cliui({ width: process.stdout.columns || 80 });
+        // Header
+        ui.div({ text: `\n${scaffold.manifest.displayName}`, padding: [0, 0, 0, 0] });
+        ui.div({ text: '='.repeat(scaffold.manifest.displayName.length), padding: [0, 0, 1, 0] });
+        // Basic info
+        ui.div({ text: 'ID:', width: 15, padding: [0, 2, 0, 0] }, { text: scaffold.id });
+        ui.div({ text: 'Category:', width: 15, padding: [0, 2, 0, 0] }, { text: scaffold.manifest.category });
+        ui.div({ text: 'Source:', width: 15, padding: [0, 2, 0, 0] }, { text: scaffold.source });
+        ui.div({ text: 'Description:', width: 15, padding: [0, 2, 0, 0] }, { text: scaffold.manifest.description });
+        // Parameters
+        if (scaffold.manifest.parameters.length > 0) {
+            ui.div({ text: '\nParameters:', padding: [1, 0, 0, 0] });
+            ui.div({ text: '-'.repeat(11), padding: [0, 0, 1, 0] });
+            for (const param of scaffold.manifest.parameters) {
+                const required = param.required ? ' (required)' : '';
+                const defaultVal = param.default === undefined ? '' : ` [default: ${param.default}]`;
+                const conditional = param.when ? ` [when: ${param.when}]` : '';
+                ui.div({ text: `  ${param.name}`, width: 25, padding: [0, 2, 0, 0] }, { text: `${param.type}${required}${defaultVal}${conditional}` });
+                ui.div({ text: '', width: 25, padding: [0, 2, 0, 0] }, { text: param.prompt });
+                if (param.choices && param.choices.length > 0) {
+                    ui.div({ text: '', width: 25, padding: [0, 2, 0, 0] }, { text: `Choices: ${param.choices.map((c) => c.value).join(', ')}` });
+                }
+            }
+        }
+        // Usage example
+        ui.div({ text: '\nUsage:', padding: [1, 0, 0, 0] });
+        ui.div({ text: '------', padding: [0, 0, 1, 0] });
+        const requiredParams = scaffold.manifest.parameters
+            .filter((p) => p.required && !p.when)
+            .map((p) => `--option ${p.name}=<value>`)
+            .join(' ');
+        ui.div({ text: `  b2c scaffold generate ${scaffold.id} ${requiredParams}`, padding: [0, 0, 0, 0] });
+        // Post instructions
+        if (scaffold.manifest.postInstructions) {
+            ui.div({ text: '\nPost-generation instructions:', padding: [1, 0, 0, 0] });
+            ui.div({ text: '-----------------------------', padding: [0, 0, 1, 0] });
+            ui.div({ text: '  (shown after generation completes)', padding: [0, 0, 0, 0] });
+        }
+        ux.stdout(ui.toString());
+        return response;
+    }
+}
+//# sourceMappingURL=info.js.map

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

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

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

@@ -0,0 +1,29 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * Response type for the init command.
+ */
+interface ScaffoldInitResponse {
+    name: string;
+    path: string;
+    location: 'custom' | 'project' | 'user';
+    files: string[];
+}
+/**
+ * Command to initialize a new custom scaffold.
+ */
+export default class ScaffoldInit extends BaseCommand<typeof ScaffoldInit> {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        user: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<ScaffoldInitResponse>;
+}
+export {};