@salesforce/b2c-cli 0.2.1 → 0.4.0

package/dist/commands/scaffold/init.js

@@ -0,0 +1,221 @@
+/*
+ * 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 fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { input, select } from '@inquirer/prompts';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { isValidScaffoldName } from '@salesforce/b2c-tooling-sdk/scaffold';
+import { t, withDocs } from '../../i18n/index.js';
+const SCAFFOLD_TEMPLATE = `{
+  "name": "{{name}}",
+  "displayName": "{{displayName}}",
+  "description": "{{description}}",
+  "category": "{{category}}",
+  "version": "1.0",
+  "tags": [],
+  "parameters": [
+    {
+      "name": "exampleParam",
+      "prompt": "Enter a value for the example parameter:",
+      "type": "string",
+      "required": true
+    }
+  ],
+  "files": [
+    {
+      "template": "example.txt.ejs",
+      "destination": "{{exampleParam}}/example.txt"
+    }
+  ],
+  "postInstructions": "Your scaffold has been generated!\\n\\nNext steps:\\n1. Review the generated files\\n2. Customize as needed"
+}`;
+const EXAMPLE_TEMPLATE = `<%# Example template file %>
+<%# Available helpers: kebabCase, camelCase, pascalCase, snakeCase, year, date, uuid %>
+
+This is an example file generated by the <%= name %> scaffold.
+
+Parameter value: <%= exampleParam %>
+Generated on: <%= date %>
+`;
+/**
+ * Command to initialize a new custom scaffold.
+ */
+export default class ScaffoldInit extends BaseCommand {
+    static args = {
+        name: Args.string({
+            description: 'Name for the new scaffold (kebab-case)',
+            required: false,
+        }),
+    };
+    static description = withDocs(t('commands.scaffold.init.description', 'Create a new custom scaffold template'), '/cli/scaffold.html#b2c-scaffold-init');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-scaffold',
+        '<%= config.bin %> <%= command.id %> my-scaffold --project',
+        '<%= config.bin %> <%= command.id %> my-scaffold --user',
+        '<%= config.bin %> <%= command.id %> --output ./scaffolds/custom',
+    ];
+    static flags = {
+        project: Flags.boolean({
+            description: 'Create in project scaffolds directory (.b2c/scaffolds/)',
+            exclusive: ['user', 'output'],
+        }),
+        user: Flags.boolean({
+            description: 'Create in user scaffolds directory (~/.b2c/scaffolds/)',
+            exclusive: ['project', 'output'],
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Custom output directory for the scaffold',
+            exclusive: ['project', 'user'],
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Overwrite existing scaffold if it exists',
+            default: false,
+        }),
+    };
+    async run() {
+        let scaffoldName = this.args.name;
+        const isTTY = process.stdin.isTTY && process.stdout.isTTY;
+        // Prompt for name if not provided
+        if (!scaffoldName && isTTY) {
+            scaffoldName = await input({
+                message: 'What is the scaffold name?',
+                validate(value) {
+                    if (!value)
+                        return 'Name is required';
+                    if (!isValidScaffoldName(value)) {
+                        return 'Scaffold name must be kebab-case (lowercase letters, numbers, hyphens)';
+                    }
+                    return true;
+                },
+            });
+        }
+        if (!scaffoldName) {
+            this.error('Scaffold name is required');
+        }
+        if (!isValidScaffoldName(scaffoldName)) {
+            this.error('Scaffold name must be kebab-case (lowercase letters, numbers, hyphens)');
+        }
+        // Determine output location
+        let scaffoldDir;
+        let location;
+        if (this.flags.output) {
+            scaffoldDir = path.resolve(this.flags.output, scaffoldName);
+            location = 'custom';
+        }
+        else if (this.flags.user) {
+            scaffoldDir = path.join(os.homedir(), '.b2c', 'scaffolds', scaffoldName);
+            location = 'user';
+        }
+        else if (this.flags.project || !isTTY) {
+            scaffoldDir = path.join(process.cwd(), '.b2c', 'scaffolds', scaffoldName);
+            location = 'project';
+        }
+        else {
+            // Interactive location selection
+            const selectedLocation = await select({
+                message: 'Where should the scaffold be created?',
+                choices: [
+                    {
+                        name: 'Project (.b2c/scaffolds/)',
+                        value: 'project',
+                        description: 'Scaffold available only in this project',
+                    },
+                    {
+                        name: 'User (~/.b2c/scaffolds/)',
+                        value: 'user',
+                        description: 'Scaffold available to all your projects',
+                    },
+                ],
+            });
+            location = selectedLocation;
+            scaffoldDir =
+                location === 'user'
+                    ? path.join(os.homedir(), '.b2c', 'scaffolds', scaffoldName)
+                    : path.join(process.cwd(), '.b2c', 'scaffolds', scaffoldName);
+        }
+        // Check if scaffold already exists
+        try {
+            await fs.access(scaffoldDir);
+            if (!this.flags.force) {
+                this.error(`Scaffold already exists at ${scaffoldDir}. Use --force to overwrite.`);
+            }
+        }
+        catch {
+            // Directory doesn't exist, which is what we want
+        }
+        // Gather additional info interactively
+        let displayName = scaffoldName
+            .split('-')
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join(' ');
+        let description = 'A custom scaffold';
+        let category = 'cartridge';
+        if (isTTY && !this.jsonEnabled()) {
+            displayName = await input({
+                message: 'Display name for the scaffold:',
+                default: displayName,
+            });
+            description = await input({
+                message: 'Describe what this scaffold creates:',
+                default: description,
+            });
+            category = (await select({
+                message: 'Category for the scaffold:',
+                choices: [
+                    { name: 'Cartridge', value: 'cartridge' },
+                    { name: 'Custom API', value: 'custom-api' },
+                    { name: 'Page Designer', value: 'page-designer' },
+                    { name: 'Job', value: 'job' },
+                    { name: 'Metadata', value: 'metadata' },
+                ],
+            }));
+        }
+        // Create the scaffold directory structure
+        const filesDir = path.join(scaffoldDir, 'files');
+        await fs.mkdir(filesDir, { recursive: true });
+        // Generate scaffold.json
+        const manifestContent = SCAFFOLD_TEMPLATE.replaceAll('{{name}}', scaffoldName)
+            .replaceAll('{{displayName}}', displayName)
+            .replaceAll('{{description}}', description)
+            .replaceAll('{{category}}', category);
+        await fs.writeFile(path.join(scaffoldDir, 'scaffold.json'), manifestContent, 'utf8');
+        // Generate example template
+        const exampleContent = EXAMPLE_TEMPLATE.replaceAll('{{name}}', scaffoldName);
+        await fs.writeFile(path.join(filesDir, 'example.txt.ejs'), exampleContent, 'utf8');
+        const createdFiles = ['scaffold.json', 'files/example.txt.ejs'];
+        const response = {
+            name: scaffoldName,
+            path: scaffoldDir,
+            location,
+            files: createdFiles,
+        };
+        if (this.jsonEnabled()) {
+            return response;
+        }
+        this.log('');
+        this.log(t('commands.scaffold.init.success', 'Scaffold "{{name}}" created successfully!', { name: scaffoldName }));
+        this.log('');
+        this.log(`Location: ${scaffoldDir}`);
+        this.log('');
+        this.log('Created files:');
+        for (const file of createdFiles) {
+            this.log(`  + ${file}`);
+        }
+        this.log('');
+        this.log('Next steps:');
+        this.log('  1. Edit scaffold.json to define your parameters');
+        this.log('  2. Add template files in the files/ directory');
+        this.log('  3. Test with: b2c scaffold generate ' + scaffoldName + ' --dry-run');
+        this.log('  4. Validate with: b2c scaffold validate ' + scaffoldDir);
+        return response;
+    }
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,38 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type ScaffoldCategory, type ScaffoldSource } from '@salesforce/b2c-tooling-sdk/scaffold';
+/**
+ * Response type for the list command.
+ */
+interface ScaffoldListResponse {
+    count: number;
+    categories: ScaffoldCategory[];
+    sources: ScaffoldSource[];
+    data: Array<{
+        id: string;
+        displayName: string;
+        description: string;
+        category: ScaffoldCategory;
+        source: string;
+        path: string;
+    }>;
+}
+/**
+ * Command to list available project scaffolds.
+ */
+export default class ScaffoldList extends BaseCommand<typeof ScaffoldList> {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        columns: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        extended: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<ScaffoldListResponse>;
+    /**
+     * Determines which columns to display based on flags.
+     */
+    private getSelectedColumns;
+}
+export {};

package/dist/commands/scaffold/list.js

@@ -0,0 +1,131 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { Flags } 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,
+    },
+    path: {
+        header: 'Path',
+        get: (s) => s.path,
+        extended: true,
+    },
+};
+const DEFAULT_COLUMNS = ['id', 'displayName', 'category', 'source'];
+const tableRenderer = new TableRenderer(COLUMNS);
+/**
+ * Command to list available project scaffolds.
+ */
+export default class ScaffoldList extends BaseCommand {
+    static description = withDocs(t('commands.scaffold.list.description', 'List available project scaffolds'), '/cli/scaffold.html#b2c-scaffold-list');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --category cartridge',
+        '<%= config.bin %> <%= command.id %> --source project',
+        '<%= config.bin %> <%= command.id %> --extended',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        category: Flags.string({
+            char: 'c',
+            description: 'Filter by category',
+        }),
+        source: Flags.string({
+            char: 's',
+            description: 'Filter by source (built-in, user, project, plugin)',
+            options: ['built-in', 'user', 'project', 'plugin'],
+        }),
+        columns: Flags.string({
+            description: `Columns to display (comma-separated). Available: ${Object.keys(COLUMNS).join(', ')}`,
+        }),
+        extended: Flags.boolean({
+            char: 'x',
+            description: 'Show all columns including extended fields',
+            default: false,
+        }),
+    };
+    async run() {
+        const registry = createScaffoldRegistry();
+        const category = this.flags.category;
+        const source = this.flags.source;
+        const projectRoot = this.flags['working-directory'] || process.cwd();
+        const scaffolds = await registry.getScaffolds({
+            category,
+            sources: source ? [source] : undefined,
+            projectRoot,
+        });
+        // Collect unique categories and sources for metadata
+        const uniqueCategories = [...new Set(scaffolds.map((s) => s.manifest.category))];
+        const uniqueSources = [...new Set(scaffolds.map((s) => s.source))];
+        const response = {
+            count: scaffolds.length,
+            categories: uniqueCategories,
+            sources: uniqueSources,
+            data: scaffolds.map((s) => ({
+                id: s.id,
+                displayName: s.manifest.displayName,
+                description: s.manifest.description,
+                category: s.manifest.category,
+                source: s.source,
+                path: s.path,
+            })),
+        };
+        if (this.jsonEnabled()) {
+            return response;
+        }
+        if (scaffolds.length === 0) {
+            this.log(t('commands.scaffold.list.noScaffolds', 'No scaffolds found.'));
+            return response;
+        }
+        this.log(t('commands.scaffold.list.foundScaffolds', 'Found {{count}} scaffold(s):', { count: scaffolds.length }));
+        this.log('');
+        tableRenderer.render(scaffolds, this.getSelectedColumns());
+        return response;
+    }
+    /**
+     * Determines which columns to display based on flags.
+     */
+    getSelectedColumns() {
+        const columnsFlag = this.flags.columns;
+        const extended = this.flags.extended;
+        if (columnsFlag) {
+            const requested = columnsFlag.split(',').map((c) => c.trim());
+            const valid = tableRenderer.validateColumnKeys(requested);
+            if (valid.length === 0) {
+                this.warn(`No valid columns specified. Available: ${tableRenderer.getColumnKeys().join(', ')}`);
+                return DEFAULT_COLUMNS;
+            }
+            return valid;
+        }
+        if (extended) {
+            return tableRenderer.getColumnKeys();
+        }
+        return DEFAULT_COLUMNS;
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

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