@salesforce/b2c-cli 0.3.0 → 0.4.1

package/dist/commands/setup/instance/create.js

@@ -0,0 +1,269 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags, ux } from '@oclif/core';
+import { input, password, confirm, select } from '@inquirer/prompts';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { DwJsonSource, createInstanceFromConfig } from '@salesforce/b2c-tooling-sdk/config';
+import { getActiveCodeVersion } from '@salesforce/b2c-tooling-sdk/operations/code';
+import { withDocs } from '../../../i18n/index.js';
+/**
+ * Extract the hostname from a URL or return the input as-is if it's already a hostname.
+ */
+function parseHostname(input) {
+    const trimmed = input.trim();
+    try {
+        const url = new URL(trimmed);
+        return url.hostname;
+    }
+    catch {
+        return trimmed;
+    }
+}
+/**
+ * Create a new B2C Commerce instance configuration.
+ */
+export default class SetupInstanceCreate extends BaseCommand {
+    static args = {
+        name: Args.string({
+            description: 'Instance name',
+        }),
+    };
+    static description = withDocs('Create a new B2C Commerce instance configuration', '/cli/setup.html#b2c-setup-instance-create');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> staging',
+        '<%= config.bin %> <%= command.id %> staging --hostname staging.example.com',
+        '<%= config.bin %> <%= command.id %> staging --hostname staging.example.com --active',
+        '<%= config.bin %> <%= command.id %> staging --hostname staging.example.com --username admin --force',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        hostname: Flags.string({
+            char: 's',
+            description: 'B2C instance hostname',
+        }),
+        username: Flags.string({
+            description: 'WebDAV username',
+        }),
+        password: Flags.string({
+            description: 'WebDAV password',
+        }),
+        'client-id': Flags.string({
+            description: 'OAuth client ID',
+        }),
+        'client-secret': Flags.string({
+            description: 'OAuth client secret',
+        }),
+        'code-version': Flags.string({
+            description: 'Code version',
+        }),
+        active: Flags.boolean({
+            description: 'Set as active instance',
+            default: false,
+        }),
+        force: Flags.boolean({
+            description: 'Non-interactive mode (fail if required flags missing)',
+            default: false,
+        }),
+    };
+    async run() {
+        const source = new DwJsonSource();
+        const force = this.flags.force;
+        if (!force) {
+            ux.stdout('Create a new B2C Commerce instance configuration.');
+            ux.stdout('For more information on configuration, see:');
+            ux.stdout('  https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/configuration.html');
+            ux.stdout('');
+        }
+        // Get or prompt for instance name
+        let name = this.args.name;
+        if (!name) {
+            if (force) {
+                this.error('Instance name is required in non-interactive mode. Provide as argument.');
+            }
+            name = await input({
+                message: 'Enter instance name:',
+                validate: (v) => (v.trim() ? true : 'Instance name is required'),
+            });
+        }
+        // Check if instance already exists
+        const existingInstances = source.listInstances({ configPath: this.flags.config });
+        if (existingInstances.some((i) => i.name === name)) {
+            this.error(`Instance "${name}" already exists. Use a different name.`);
+        }
+        // Get or prompt for hostname (accepts a URL or plain hostname)
+        let hostname = this.flags.hostname;
+        if (!hostname) {
+            if (force) {
+                this.error('Hostname is required in non-interactive mode. Use --hostname flag.');
+            }
+            hostname = await input({
+                message: 'Enter B2C instance hostname or URL:',
+                validate: (v) => (v.trim() ? true : 'Hostname is required'),
+            });
+        }
+        hostname = parseHostname(hostname);
+        // Build config
+        const config = {
+            hostname,
+        };
+        // Handle authentication - in non-interactive mode, use provided flags
+        if (force) {
+            // Basic auth
+            if (this.flags.username) {
+                config.username = this.flags.username;
+                if (!this.flags.password) {
+                    this.error('Password is required when username is provided in non-interactive mode.');
+                }
+                config.password = this.flags.password;
+            }
+            // OAuth
+            if (this.flags['client-id']) {
+                config.clientId = this.flags['client-id'];
+                if (this.flags['client-secret']) {
+                    config.clientSecret = this.flags['client-secret'];
+                }
+            }
+        }
+        else {
+            // Interactive mode - prompt for auth type and credentials
+            const authType = await select({
+                message: 'Configure authentication:',
+                choices: [
+                    { name: 'WebDAV (username/password or access key)', value: 'basic' },
+                    { name: 'API Client (OAuth client credentials)', value: 'oauth' },
+                    { name: 'Both', value: 'both' },
+                    { name: 'Skip for now', value: 'none' },
+                ],
+            });
+            // Basic auth
+            if (authType === 'basic' || authType === 'both') {
+                config.username =
+                    this.flags.username ||
+                        (await input({
+                            message: 'Enter WebDAV username:',
+                            validate: (v) => (v.trim() ? true : 'Username is required'),
+                        }));
+                const accessKeyUrl = `https://${hostname}/on/demandware.store/Sites-Site/default/ViewAccessKeys-List`;
+                config.password =
+                    this.flags.password ||
+                        (await password({
+                            message: `Enter WebDAV password or access key (${accessKeyUrl}):`,
+                            validate: (v) => (v.trim() ? true : 'Password or access key is required'),
+                        }));
+            }
+            // OAuth
+            if (authType === 'oauth' || authType === 'both') {
+                config.clientId =
+                    this.flags['client-id'] ||
+                        (await input({
+                            message: 'Enter OAuth client ID:',
+                            validate: (v) => (v.trim() ? true : 'Client ID is required'),
+                        }));
+                const clientSecret = this.flags['client-secret'] ||
+                    (await password({
+                        message: 'Enter OAuth client secret (leave blank for user auth):',
+                    }));
+                if (clientSecret.trim()) {
+                    config.clientSecret = clientSecret.trim();
+                }
+            }
+        }
+        // Code version - use flag, or try to detect via OCAPI if OAuth credentials are available
+        if (this.flags['code-version']) {
+            config.codeVersion = this.flags['code-version'];
+        }
+        else if (!force) {
+            let detectedVersion;
+            if (config.clientId) {
+                try {
+                    const tempInstance = createInstanceFromConfig({
+                        hostname,
+                        clientId: config.clientId,
+                        clientSecret: config.clientSecret,
+                    });
+                    const activeVersion = await getActiveCodeVersion(tempInstance);
+                    detectedVersion = activeVersion?.id;
+                }
+                catch {
+                    // Detection failed - continue without a default
+                }
+            }
+            const codeVersion = await input({
+                message: 'Enter code version:',
+                default: detectedVersion,
+            });
+            if (codeVersion.trim()) {
+                config.codeVersion = codeVersion.trim();
+            }
+        }
+        // Determine if this should be the active instance
+        let setActive = this.flags.active;
+        if (!force && !setActive && existingInstances.length > 0) {
+            setActive = await confirm({
+                message: 'Set as active instance?',
+                default: false,
+            });
+        }
+        else if (existingInstances.length === 0) {
+            // If this is the first instance, make it active by default
+            setActive = true;
+        }
+        // Show summary and confirm in interactive mode
+        if (!force) {
+            ux.stdout('');
+            ux.stdout('Instance configuration:');
+            ux.stdout(`  Name: ${name}`);
+            ux.stdout(`  Hostname: ${hostname}`);
+            if (config.codeVersion) {
+                ux.stdout(`  Code Version: ${config.codeVersion}`);
+            }
+            if (config.username) {
+                ux.stdout(`  Auth: Basic (${config.username})`);
+            }
+            if (config.clientId) {
+                ux.stdout(`  Auth: OAuth (${config.clientId})`);
+            }
+            if (setActive) {
+                ux.stdout('  Active: Yes');
+            }
+            ux.stdout('');
+            const proceed = await confirm({
+                message: 'Create this instance?',
+                default: true,
+            });
+            if (!proceed) {
+                ux.stdout('Instance creation cancelled.');
+                return {
+                    name,
+                    hostname,
+                    created: false,
+                };
+            }
+        }
+        // Create the instance
+        source.createInstance({
+            name,
+            config,
+            setActive,
+            configPath: this.flags.config,
+        });
+        const result = {
+            name,
+            hostname,
+            created: true,
+            active: setActive,
+        };
+        if (!this.jsonEnabled()) {
+            ux.stdout(`Instance "${name}" created successfully.`);
+            if (setActive) {
+                ux.stdout(`"${name}" is now the active instance.`);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/setup/instance/create.js.map

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

package/dist/commands/setup/instance/index.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * Default instance command - shows topic help for instance subcommands.
+ */
+export default class SetupInstanceIndex extends BaseCommand<typeof SetupInstanceIndex> {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/setup/instance/index.js

@@ -0,0 +1,22 @@
+/*
+ * 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 { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { withDocs } from '../../../i18n/index.js';
+/**
+ * Default instance command - shows topic help for instance subcommands.
+ */
+export default class SetupInstanceIndex extends BaseCommand {
+    static description = withDocs('Create, list, and manage B2C Commerce instance configurations', '/cli/setup.html#b2c-setup-instance');
+    static examples = [
+        '<%= config.bin %> setup instance create',
+        '<%= config.bin %> setup instance list',
+        '<%= config.bin %> setup instance set-active',
+    ];
+    async run() {
+        await this.config.runCommand('help', ['setup', 'instance']);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/setup/instance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/setup/instance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAsC;IACpF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,+DAA+D,EAC/D,oCAAoC,CACrC,CAAC;IAEF,MAAM,CAAC,QAAQ,GAAG;QAChB,yCAAyC;QACzC,uCAAuC;QACvC,6CAA6C;KAC9C,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC"}

package/dist/commands/setup/instance/list.d.ts

@@ -0,0 +1,31 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type InstanceInfo } from '@salesforce/b2c-tooling-sdk/config';
+/**
+ * JSON output structure for the list command.
+ */
+interface InstanceListResponse {
+    instances: InstanceInfo[];
+    count: number;
+}
+/**
+ * List all configured B2C Commerce instances.
+ */
+export default class SetupInstanceList extends BaseCommand<typeof SetupInstanceList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<InstanceListResponse>;
+}
+export {};

package/dist/commands/setup/instance/list.js

@@ -0,0 +1,68 @@
+/*
+ * 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 { ux } from '@oclif/core';
+import { BaseCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
+import { DwJsonSource } from '@salesforce/b2c-tooling-sdk/config';
+import { withDocs } from '../../../i18n/index.js';
+/**
+ * Table columns for instance listing.
+ */
+const COLUMNS = {
+    name: {
+        header: 'Name',
+        get: (i) => i.name,
+    },
+    hostname: {
+        header: 'Hostname',
+        get: (i) => i.hostname || '-',
+    },
+    source: {
+        header: 'Source',
+        get: (i) => i.source,
+    },
+    active: {
+        header: 'Active',
+        get: (i) => (i.active ? '✓' : ''),
+    },
+};
+const DEFAULT_COLUMNS = ['name', 'hostname', 'source', 'active'];
+/**
+ * List all configured B2C Commerce instances.
+ */
+export default class SetupInstanceList extends BaseCommand {
+    static description = withDocs('List configured B2C Commerce instances', '/cli/setup.html#b2c-setup-instance-list');
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        // Get instances from all sources that support listing
+        const source = new DwJsonSource();
+        const instances = source.listInstances({
+            configPath: this.flags.config,
+        });
+        const result = {
+            instances,
+            count: instances.length,
+        };
+        // In JSON mode, just return the data
+        if (this.jsonEnabled()) {
+            return result;
+        }
+        // Human-readable table output
+        if (instances.length === 0) {
+            ux.stdout('No instances configured. Use `b2c setup instance create` to add one.');
+            return result;
+        }
+        ux.stdout('');
+        ux.stdout('Instances');
+        ux.stdout('─'.repeat(60));
+        createTable(COLUMNS).render(instances, DEFAULT_COLUMNS);
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/setup/instance/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/setup/instance/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,EAAE,EAAC,MAAM,aAAa,CAAC;AAC/B,OAAO,EAAC,WAAW,EAAE,WAAW,EAAiB,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAC,YAAY,EAAoB,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,GAA4C;IACvD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;KACnB;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG;KAC9B;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;KACrB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;KAClC;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAUjE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,WAAqC;IAClF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,wCAAwC,EAAE,yCAAyC,CAAC,CAAC;IAEnH,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG,CAAC,qCAAqC,EAAE,4CAA4C,CAAC,CAAC;IAExG,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;KACzB,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,sDAAsD;QACtD,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;SAC9B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAyB;YACnC,SAAS;YACT,KAAK,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC;QAEF,qCAAqC;QACrC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,8BAA8B;QAC9B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,EAAE,CAAC,MAAM,CAAC,sEAAsE,CAAC,CAAC;YAClF,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACd,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE1B,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAExD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/setup/instance/remove.d.ts

@@ -0,0 +1,34 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * JSON output structure for the remove command.
+ */
+interface InstanceRemoveResponse {
+    name: string;
+    removed: boolean;
+}
+/**
+ * Remove a B2C Commerce instance configuration.
+ */
+export default class SetupInstanceRemove extends BaseCommand<typeof SetupInstanceRemove> {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<InstanceRemoveResponse>;
+}
+export {};

package/dist/commands/setup/instance/remove.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Args, Flags, ux } from '@oclif/core';
+import { confirm } from '@inquirer/prompts';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { DwJsonSource } from '@salesforce/b2c-tooling-sdk/config';
+import { withDocs } from '../../../i18n/index.js';
+/**
+ * Remove a B2C Commerce instance configuration.
+ */
+export default class SetupInstanceRemove extends BaseCommand {
+    static args = {
+        name: Args.string({
+            description: 'Instance name to remove',
+            required: true,
+        }),
+    };
+    static description = withDocs('Remove a B2C Commerce instance configuration', '/cli/setup.html#b2c-setup-instance-remove');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> staging',
+        '<%= config.bin %> <%= command.id %> staging --force',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            description: 'Skip confirmation prompt',
+            default: false,
+        }),
+    };
+    async run() {
+        const source = new DwJsonSource();
+        const name = this.args.name;
+        // Check if instance exists
+        const instances = source.listInstances({ configPath: this.flags.config });
+        const instance = instances.find((i) => i.name === name);
+        if (!instance) {
+            const availableNames = instances.map((i) => i.name).join(', ');
+            if (availableNames) {
+                this.error(`Instance "${name}" not found. Available instances: ${availableNames}`);
+            }
+            else {
+                this.error(`Instance "${name}" not found. No instances are configured.`);
+            }
+        }
+        // Confirm removal
+        if (!this.flags.force) {
+            const proceed = await confirm({
+                message: `Remove instance "${name}"? This cannot be undone.`,
+                default: false,
+            });
+            if (!proceed) {
+                ux.stdout('Instance removal cancelled.');
+                return {
+                    name,
+                    removed: false,
+                };
+            }
+        }
+        // Remove the instance
+        source.removeInstance(name, { configPath: this.flags.config });
+        const result = {
+            name,
+            removed: true,
+        };
+        if (!this.jsonEnabled()) {
+            ux.stdout(`Instance "${name}" removed successfully.`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/setup/instance/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../src/commands/setup/instance/remove.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAUhD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,WAAuC;IACtF,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,8CAA8C,EAC9C,2CAA2C,CAC5C,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,6CAA6C;QAC7C,qDAAqD;KACtD,CAAC;IAEF,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,WAAW,CAAC,SAAS;QACxB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,0BAA0B;YACvC,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAE5B,2BAA2B;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,EAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/D,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,qCAAqC,cAAc,EAAE,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,2CAA2C,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;gBAC5B,OAAO,EAAE,oBAAoB,IAAI,2BAA2B;gBAC5D,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC;gBACzC,OAAO;oBACL,IAAI;oBACJ,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,EAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAC,CAAC,CAAC;QAE7D,MAAM,MAAM,GAA2B;YACrC,IAAI;YACJ,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,EAAE,CAAC,MAAM,CAAC,aAAa,IAAI,yBAAyB,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/setup/instance/set-active.d.ts

@@ -0,0 +1,33 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * JSON output structure for the set-active command.
+ */
+interface InstanceSetActiveResponse {
+    name: string;
+    active: boolean;
+}
+/**
+ * Set a B2C Commerce instance as the default (active) instance.
+ */
+export default class SetupInstanceSetActive extends BaseCommand<typeof SetupInstanceSetActive> {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<InstanceSetActiveResponse>;
+}
+export {};

package/dist/commands/setup/instance/set-active.js

@@ -0,0 +1,78 @@
+/*
+ * 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 { search } from '@inquirer/prompts';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { DwJsonSource } from '@salesforce/b2c-tooling-sdk/config';
+import { withDocs } from '../../../i18n/index.js';
+/**
+ * Set a B2C Commerce instance as the default (active) instance.
+ */
+export default class SetupInstanceSetActive extends BaseCommand {
+    static args = {
+        name: Args.string({
+            description: 'Instance name to set as active',
+        }),
+    };
+    static description = withDocs('Set a B2C Commerce instance as the default (active) instance', '/cli/setup.html#b2c-setup-instance-set-active');
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> <%= command.id %> staging', '<%= config.bin %> <%= command.id %> production'];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const source = new DwJsonSource();
+        const instances = source.listInstances({ configPath: this.flags.config });
+        let name = this.args.name;
+        if (!name) {
+            if (instances.length === 0) {
+                this.error('No instances are configured. Use `b2c setup instance create` to add one.');
+            }
+            name = await search({
+                message: 'Select instance:',
+                source(term) {
+                    const filtered = term ? instances.filter((i) => i.name.includes(term)) : instances;
+                    const sorted = [...filtered].sort((a, b) => (a.active === b.active ? 0 : a.active ? -1 : 1));
+                    return sorted.map((i) => ({
+                        name: `${i.name}${i.hostname ? ` (${i.hostname})` : ''}${i.active ? ' [active]' : ''}`,
+                        value: i.name,
+                    }));
+                },
+            });
+        }
+        const instance = instances.find((i) => i.name === name);
+        if (!instance) {
+            const availableNames = instances.map((i) => i.name).join(', ');
+            if (availableNames) {
+                this.error(`Instance "${name}" not found. Available instances: ${availableNames}`);
+            }
+            else {
+                this.error(`Instance "${name}" not found. No instances are configured.`);
+            }
+        }
+        // Check if already active
+        if (instance.active) {
+            if (!this.jsonEnabled()) {
+                ux.stdout(`Instance "${name}" is already the active instance.`);
+            }
+            return {
+                name,
+                active: true,
+            };
+        }
+        // Set as active
+        source.setActiveInstance(name, { configPath: this.flags.config });
+        const result = {
+            name,
+            active: true,
+        };
+        if (!this.jsonEnabled()) {
+            ux.stdout(`Instance "${name}" is now the active instance.`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=set-active.js.map