@salesforce/b2c-cli 0.3.0 → 0.4.0

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

@@ -0,0 +1,32 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type ScaffoldCategory } from '@salesforce/b2c-tooling-sdk/scaffold';
+/**
+ * Response type for the search command.
+ */
+interface ScaffoldSearchResponse {
+    query: string;
+    count: number;
+    data: Array<{
+        id: string;
+        displayName: string;
+        description: string;
+        category: ScaffoldCategory;
+        source: string;
+    }>;
+}
+/**
+ * Command to search available scaffolds.
+ */
+export default class ScaffoldSearch extends BaseCommand<typeof ScaffoldSearch> {
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ScaffoldSearchResponse>;
+}
+export {};

package/dist/commands/scaffold/search.js

@@ -0,0 +1,97 @@
+/*
+ * 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, TableRenderer } from '@salesforce/b2c-tooling-sdk/cli';
+import { createScaffoldRegistry } from '@salesforce/b2c-tooling-sdk/scaffold';
+import { t, withDocs } from '../../i18n/index.js';
+const COLUMNS = {
+    id: {
+        header: 'ID',
+        get: (s) => s.id,
+    },
+    displayName: {
+        header: 'Name',
+        get: (s) => s.manifest.displayName,
+    },
+    category: {
+        header: 'Category',
+        get: (s) => s.manifest.category,
+    },
+    source: {
+        header: 'Source',
+        get: (s) => s.source,
+    },
+    description: {
+        header: 'Description',
+        get: (s) => s.manifest.description,
+        extended: true,
+    },
+};
+const DEFAULT_COLUMNS = ['id', 'displayName', 'category', 'description'];
+const tableRenderer = new TableRenderer(COLUMNS);
+/**
+ * Command to search available scaffolds.
+ */
+export default class ScaffoldSearch extends BaseCommand {
+    static args = {
+        query: Args.string({
+            description: 'Search query (matches name and description)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.scaffold.search.description', 'Search for scaffolds by name or description'), '/cli/scaffold.html#b2c-scaffold-search');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> controller',
+        '<%= config.bin %> <%= command.id %> api',
+        '<%= config.bin %> <%= command.id %> hook --category cartridge',
+        '<%= config.bin %> <%= command.id %> job --json',
+    ];
+    static flags = {
+        category: Flags.string({
+            char: 'c',
+            description: 'Filter results by category',
+        }),
+    };
+    async run() {
+        const { query } = this.args;
+        const registry = createScaffoldRegistry();
+        const category = this.flags.category;
+        const projectRoot = this.flags['working-directory'] || process.cwd();
+        const scaffolds = await registry.searchScaffolds(query, {
+            category,
+            projectRoot,
+        });
+        const response = {
+            query,
+            count: scaffolds.length,
+            data: scaffolds.map((s) => ({
+                id: s.id,
+                displayName: s.manifest.displayName,
+                description: s.manifest.description,
+                category: s.manifest.category,
+                source: s.source,
+            })),
+        };
+        if (this.jsonEnabled()) {
+            return response;
+        }
+        if (scaffolds.length === 0) {
+            this.log(t('commands.scaffold.search.noResults', 'No scaffolds found matching "{{query}}"', { query }));
+            return response;
+        }
+        this.log(t('commands.scaffold.search.foundScaffolds', 'Found {{count}} scaffold(s) matching "{{query}}":', {
+            count: scaffolds.length,
+            query,
+        }));
+        this.log('');
+        tableRenderer.render(scaffolds, DEFAULT_COLUMNS);
+        this.log('');
+        this.log(t('commands.scaffold.search.hint', 'Use "b2c scaffold info <id>" for more details'));
+        return response;
+    }
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type ValidationResult } from '@salesforce/b2c-tooling-sdk/scaffold';
+/**
+ * Response type for the validate command.
+ */
+interface ScaffoldValidateResponse extends ValidationResult {
+    path: string;
+}
+/**
+ * Command to validate a custom scaffold.
+ */
+export default class ScaffoldValidate extends BaseCommand<typeof ScaffoldValidate> {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        strict: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<ScaffoldValidateResponse>;
+}
+export {};

package/dist/commands/scaffold/validate.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 path from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { validateScaffoldDirectory } from '@salesforce/b2c-tooling-sdk/scaffold';
+import { t, withDocs } from '../../i18n/index.js';
+/**
+ * Command to validate a custom scaffold.
+ */
+export default class ScaffoldValidate extends BaseCommand {
+    static args = {
+        path: Args.string({
+            description: 'Path to the scaffold directory',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.scaffold.validate.description', 'Validate a custom scaffold manifest and templates'), '/cli/scaffold.html#b2c-scaffold-validate');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> ./my-scaffold',
+        '<%= config.bin %> <%= command.id %> ~/.b2c/scaffolds/my-scaffold',
+        '<%= config.bin %> <%= command.id %> .b2c/scaffolds/my-scaffold --json',
+    ];
+    static flags = {
+        strict: Flags.boolean({
+            description: 'Treat warnings as errors',
+            default: false,
+        }),
+    };
+    async run() {
+        const scaffoldPath = path.resolve(this.args.path);
+        // Use SDK validation function
+        const result = await validateScaffoldDirectory(scaffoldPath, {
+            strict: this.flags.strict,
+        });
+        const response = {
+            path: scaffoldPath,
+            ...result,
+        };
+        if (this.jsonEnabled()) {
+            return response;
+        }
+        // Display results
+        this.log('');
+        this.log(`Validating scaffold at: ${scaffoldPath}`);
+        this.log('');
+        if (result.issues.length === 0) {
+            this.log('No issues found.');
+        }
+        else {
+            for (const issue of result.issues) {
+                const prefix = issue.severity === 'error' ? 'ERROR' : 'WARN';
+                const fileInfo = issue.file ? ` (${issue.file})` : '';
+                this.log(`  ${prefix}: ${issue.message}${fileInfo}`);
+            }
+        }
+        this.log('');
+        this.log(`Summary: ${result.errors} error(s), ${result.warnings} warning(s)`);
+        if (result.valid) {
+            this.log('');
+            this.log('Scaffold is valid.');
+        }
+        else {
+            this.log('');
+            this.error('Validation failed');
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=validate.js.map

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

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

package/dist/commands/scapi/custom/status.d.ts

@@ -33,6 +33,7 @@ export default class ScapiCustomStatus extends ScapiCustomCommand<typeof ScapiCu
         'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'tenant-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         '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>;

package/dist/commands/scapi/schemas/get.d.ts

@@ -40,6 +40,7 @@ export default class ScapiSchemasGet extends ScapiSchemasCommand<typeof ScapiSch
         'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'tenant-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         '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>;

package/dist/commands/scapi/schemas/list.d.ts

@@ -27,6 +27,7 @@ export default class ScapiSchemasList extends ScapiSchemasCommand<typeof ScapiSc
         'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'tenant-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'user-auth': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         '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>;

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

@@ -0,0 +1,12 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * Default setup command - provides topic help and prompts to create an instance if none configured.
+ *
+ * - `b2c setup` with no instance configured (TTY): prompts to create one
+ * - `b2c setup` with instance configured or non-TTY: shows topic help
+ */
+export default class SetupIndex extends BaseCommand<typeof SetupIndex> {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/setup/index.js

@@ -0,0 +1,34 @@
+/*
+ * 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 { confirm } from '@inquirer/prompts';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { withDocs } from '../../i18n/index.js';
+/**
+ * Default setup command - provides topic help and prompts to create an instance if none configured.
+ *
+ * - `b2c setup` with no instance configured (TTY): prompts to create one
+ * - `b2c setup` with instance configured or non-TTY: shows topic help
+ */
+export default class SetupIndex extends BaseCommand {
+    static description = withDocs('Manage instances, view configuration, and install agent skills', '/cli/setup.html');
+    static examples = ['<%= config.bin %> setup --help', '<%= config.bin %> setup instance create'];
+    async run() {
+        const hasInstance = this.resolvedConfig.hasB2CInstanceConfig();
+        const isTTY = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+        if (!hasInstance && isTTY) {
+            const shouldCreate = await confirm({
+                message: 'No instance configured. Would you like to set one up?',
+                default: true,
+            });
+            if (shouldCreate) {
+                await this.config.runCommand('setup:instance:create');
+                return;
+            }
+        }
+        await this.config.runCommand('help', ['setup']);
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/setup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAA8B;IACpE,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,gEAAgE,EAAE,iBAAiB,CAAC,CAAC;IAEnH,MAAM,CAAC,QAAQ,GAAG,CAAC,gCAAgC,EAAE,yCAAyC,CAAC,CAAC;IAEhG,KAAK,CAAC,GAAG;QACP,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEnE,IAAI,CAAC,WAAW,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC;gBACjC,OAAO,EAAE,uDAAuD;gBAChE,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC"}

package/dist/commands/setup/{config.d.ts → inspect.d.ts}

@@ -1,9 +1,9 @@
 import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
 import type { ConfigSourceInfo } from '@salesforce/b2c-tooling-sdk/config';
 /**
- * JSON output structure for the config command.
+ * JSON output structure for the inspect command.
  */
-interface SetupConfigResponse {
+interface SetupInspectResponse {
     config: Record<string, unknown>;
     sources: ConfigSourceInfo[];
     warnings?: string[];
@@ -11,7 +11,8 @@ interface SetupConfigResponse {
 /**
  * Command to display resolved configuration.
  */
-export default class SetupConfig extends BaseCommand<typeof SetupConfig> {
+export default class SetupInspect extends BaseCommand<typeof SetupInspect> {
+    static aliases: string[];
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
@@ -28,7 +29,7 @@ export default class SetupConfig extends BaseCommand<typeof SetupConfig> {
         '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<SetupConfigResponse>;
+    run(): Promise<SetupInspectResponse>;
     /**
      * Build a map of field -> source name for display.
      */

package/dist/commands/setup/{config.js → inspect.js}

@@ -46,8 +46,9 @@ function getDisplayValue(field, value, unmask) {
 /**
  * Command to display resolved configuration.
  */
-export default class SetupConfig extends BaseCommand {
-    static description = withDocs('Display resolved configuration', '/cli/setup.html#b2c-setup-config');
+export default class SetupInspect extends BaseCommand {
+    static aliases = ['setup:config'];
+    static description = withDocs('Display resolved configuration', '/cli/setup.html#b2c-setup-inspect');
     static enableJsonFlag = true;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -133,6 +134,7 @@ export default class SetupConfig extends BaseCommand {
             ['scopes', config.scopes],
             ['authMethods', config.authMethods],
             ['accountManagerHost', config.accountManagerHost],
+            ['sandboxApiHost', config.sandboxApiHost],
         ], fieldSources, unmask);
         // SCAPI section
         this.renderSection(ui, 'SCAPI', [
@@ -172,4 +174,4 @@ export default class SetupConfig extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=config.js.map
+//# sourceMappingURL=inspect.js.map

package/dist/commands/setup/inspect.js.map

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

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

@@ -0,0 +1,43 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+/**
+ * JSON output structure for the create command.
+ */
+interface InstanceCreateResponse {
+    name: string;
+    hostname: string;
+    created: boolean;
+    active?: boolean;
+}
+/**
+ * Create a new B2C Commerce instance configuration.
+ */
+export default class SetupInstanceCreate extends BaseCommand<typeof SetupInstanceCreate> {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        hostname: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        username: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'code-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        active: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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<InstanceCreateResponse>;
+}
+export {};