@salesforce/b2c-cli 1.5.0 → 1.7.0

package/dist/commands/cap/pull.js

@@ -0,0 +1,121 @@
+/*
+ * 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 { JobCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { listInstalledApps, pullCommerceApps, } from '@salesforce/b2c-tooling-sdk/operations/cap';
+import { t, withDocs } from '../../i18n/index.js';
+export default class CapPull extends JobCommand {
+    static description = withDocs(t('commands.cap.pull.description', 'Pull installed Commerce Apps from a B2C Commerce instance'), '/cli/cap.html#b2c-cap-pull');
+    static args = {
+        appName: Args.string({
+            description: 'Commerce App feature name to pull (e.g. avalara-tax). If omitted, pulls all registry apps.',
+            required: false,
+        }),
+    };
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> avalara-tax',
+        '<%= config.bin %> <%= command.id %> --site-id RefArch',
+        '<%= config.bin %> <%= command.id %> --output ./my-apps',
+    ];
+    static flags = {
+        ...JobCommand.baseFlags,
+        'site-id': Flags.string({
+            char: 's',
+            description: 'Site ID to query for installed apps. If omitted, queries all sites.',
+            aliases: ['site'],
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output directory (default: ./commerce-apps)',
+            default: 'commerce-apps',
+        }),
+        timeout: Flags.integer({
+            char: 't',
+            description: 'Timeout in seconds (default: no timeout)',
+        }),
+    };
+    operations = {
+        listInstalledApps,
+        pullCommerceApps,
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        this.requireWebDavCredentials();
+        const { appName } = this.args;
+        const { 'site-id': siteId, output, timeout } = this.flags;
+        const hostname = this.resolvedConfig.values.hostname;
+        this.log(t('commands.cap.pull.fetching', 'Fetching installed apps from {{hostname}}...', { hostname }));
+        const listResult = await this.operations.listInstalledApps(this.instance, {
+            sites: siteId ? [siteId] : undefined,
+            waitOptions: {
+                timeoutSeconds: timeout || undefined,
+                onPoll: (info) => {
+                    if (!this.jsonEnabled()) {
+                        this.log(t('commands.cap.pull.progress', '  Status: {{status}} ({{elapsed}}s elapsed)', {
+                            status: info.status,
+                            elapsed: Math.floor(info.elapsedSeconds).toString(),
+                        }));
+                    }
+                },
+            },
+        });
+        // Deduplicate features by name (same app installed on multiple sites shares the same version)
+        const uniqueFeatures = new Map();
+        for (const f of listResult.features) {
+            if (!uniqueFeatures.has(f.featureName)) {
+                uniqueFeatures.set(f.featureName, f);
+            }
+        }
+        let toPull;
+        if (appName) {
+            const feature = uniqueFeatures.get(appName);
+            if (!feature) {
+                this.error(t('commands.cap.pull.notFound', 'Commerce App "{{appName}}" not found on {{hostname}}', {
+                    appName,
+                    hostname,
+                }));
+            }
+            toPull = [feature];
+        }
+        else {
+            toPull = [...uniqueFeatures.values()].filter((f) => f.featureSource === 'AppRegistry');
+        }
+        if (toPull.length === 0) {
+            this.log(t('commands.cap.pull.noApps', 'No registry-sourced apps found.'));
+            return { pulled: [], failed: [] };
+        }
+        this.log(t('commands.cap.pull.pulling', 'Pulling {{count}} app(s)...', {
+            count: toPull.length,
+        }));
+        const result = await this.operations.pullCommerceApps(this.instance, toPull, {
+            outputDir: output,
+        });
+        if (!this.jsonEnabled()) {
+            const bold = '';
+            const dim = '';
+            const cyan = '';
+            const yellow = '';
+            const red = '';
+            const reset = '';
+            for (const app of result.pulled) {
+                const relativePath = path.relative(process.cwd(), app.extractedPath);
+                const sourceNote = app.source === 'github' ? ` ${yellow}(from GitHub)${reset}` : '';
+                process.stdout.write(`\n  ${bold}${app.featureName}${reset} v${app.version}${sourceNote}\n`);
+                process.stdout.write(`     ${dim}domain: ${app.domain}${reset}\n`);
+                process.stdout.write(`     ${cyan}→ ./${relativePath}${reset}\n`);
+            }
+            for (const fail of result.failed) {
+                process.stdout.write(`\n  ${red}${fail.featureName}: ${fail.error}${reset}\n`);
+            }
+            process.stdout.write('\n');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/cap/pull.js.map

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

package/dist/commands/cap/tasks.d.ts

@@ -0,0 +1,56 @@
+import { JobCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { listInstalledApps, type CommerceFeatureState } from '@salesforce/b2c-tooling-sdk/operations/cap';
+interface ConfigTask {
+    name: string;
+    description: string;
+    link: string;
+    taskNumber: string;
+}
+export default class CapTasks extends JobCommand<typeof CapTasks> {
+    static args: {
+        appName: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'site-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        server: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'webdav-server': 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>;
+        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>;
+        certificate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        selfsigned: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verify: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-scope': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        '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, 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>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        jsonl: 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>;
+        'project-directory': import("@oclif/core/interfaces").OptionFlag<string, 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>;
+    };
+    protected operations: {
+        listInstalledApps: typeof listInstalledApps;
+    };
+    run(): Promise<{
+        feature: CommerceFeatureState;
+        tasks: ConfigTask[];
+    }>;
+}
+export {};

package/dist/commands/cap/tasks.js

@@ -0,0 +1,90 @@
+/*
+ * 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 { JobCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { listInstalledApps } from '@salesforce/b2c-tooling-sdk/operations/cap';
+import { t, withDocs } from '../../i18n/index.js';
+export default class CapTasks extends JobCommand {
+    static args = {
+        appName: Args.string({
+            description: 'Commerce App feature name (e.g. avalara-tax)',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.cap.tasks.description', 'List configuration tasks for an installed Commerce App'), '/cli/cap.html#b2c-cap-tasks');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> avalara-tax --site-id RefArch',
+        '<%= config.bin %> <%= command.id %> avalara-tax --site-id RefArch --json',
+    ];
+    static flags = {
+        ...JobCommand.baseFlags,
+        'site-id': Flags.string({
+            char: 's',
+            description: 'Site ID to query',
+            required: true,
+            aliases: ['site'],
+        }),
+        timeout: Flags.integer({
+            char: 't',
+            description: 'Timeout in seconds (default: no timeout)',
+        }),
+    };
+    operations = {
+        listInstalledApps,
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        this.requireWebDavCredentials();
+        const { appName: name } = this.args;
+        const { 'site-id': siteId, timeout } = this.flags;
+        const hostname = this.resolvedConfig.values.hostname;
+        this.log(t('commands.cap.tasks.fetching', 'Fetching configuration tasks for {{name}} on {{hostname}}...', {
+            name,
+            hostname,
+        }));
+        const result = await this.operations.listInstalledApps(this.instance, {
+            sites: [siteId],
+            waitOptions: {
+                timeoutSeconds: timeout || undefined,
+                onPoll: (info) => {
+                    if (!this.jsonEnabled()) {
+                        this.log(t('commands.cap.tasks.progress', '  Status: {{status}} ({{elapsed}}s elapsed)', {
+                            status: info.status,
+                            elapsed: Math.floor(info.elapsedSeconds).toString(),
+                        }));
+                    }
+                },
+            },
+        });
+        const feature = result.features.find((f) => f.featureName === name);
+        if (!feature) {
+            this.error(t('commands.cap.tasks.notFound', 'Commerce App "{{name}}" not found on site {{siteId}}', { name, siteId }));
+        }
+        const tasks = (feature.configTasks ?? []);
+        if (tasks.length === 0) {
+            this.log(t('commands.cap.tasks.noTasks', 'No configuration tasks found.'));
+            return { feature, tasks };
+        }
+        this.log(t('commands.cap.tasks.found', 'Configuration tasks for {{name}} ({{status}}):', {
+            name: feature.featureName,
+            status: feature.configStatus,
+        }));
+        if (!this.jsonEnabled()) {
+            const bold = '';
+            const dim = '';
+            const cyan = '';
+            const reset = '';
+            for (const task of tasks) {
+                process.stdout.write(`\n  ${bold}${task.taskNumber}. ${task.name}${reset}\n`);
+                process.stdout.write(`     ${dim}${task.description}${reset}\n`);
+                process.stdout.write(`     ${cyan}→ https://${hostname}${task.link}${reset}\n`);
+            }
+        }
+        return { feature, tasks };
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/commands/cap/tasks.js.map

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

package/dist/commands/cap/uninstall.d.ts

@@ -0,0 +1,47 @@
+import { JobCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { commerceAppUninstall, listInstalledApps, type CommerceAppUninstallResult } from '@salesforce/b2c-tooling-sdk/operations/cap';
+export default class CapUninstall extends JobCommand<typeof CapUninstall> {
+    static args: {
+        appName: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'site-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        server: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'webdav-server': 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>;
+        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>;
+        certificate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        passphrase: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        selfsigned: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verify: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-scope': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        '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, 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>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        jsonl: 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>;
+        'project-directory': import("@oclif/core/interfaces").OptionFlag<string, 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>;
+    };
+    protected operations: {
+        commerceAppUninstall: typeof commerceAppUninstall;
+        listInstalledApps: typeof listInstalledApps;
+    };
+    run(): Promise<CommerceAppUninstallResult>;
+}

package/dist/commands/cap/uninstall.js

@@ -0,0 +1,123 @@
+/*
+ * 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 { JobCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { commerceAppUninstall, listInstalledApps, JobExecutionError, } from '@salesforce/b2c-tooling-sdk/operations/cap';
+import { t, withDocs } from '../../i18n/index.js';
+export default class CapUninstall extends JobCommand {
+    static args = {
+        appName: Args.string({
+            description: 'App ID to uninstall (from commerce-app.json "id" field, e.g. "avalara-tax")',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.cap.uninstall.description', 'Uninstall a Commerce App from a B2C Commerce instance'), '/cli/cap.html#b2c-cap-uninstall');
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> <%= command.id %> avalara-tax --site-id RefArch'];
+    static flags = {
+        ...JobCommand.baseFlags,
+        'site-id': Flags.string({
+            char: 's',
+            description: 'Site ID to uninstall the Commerce App from',
+            required: true,
+            aliases: ['site'],
+        }),
+        timeout: Flags.integer({
+            char: 't',
+            description: 'Timeout in seconds (default: no timeout)',
+        }),
+    };
+    operations = {
+        commerceAppUninstall,
+        listInstalledApps,
+    };
+    async run() {
+        this.requireOAuthCredentials();
+        this.requireWebDavCredentials();
+        const { appName } = this.args;
+        const { 'site-id': site, timeout } = this.flags;
+        const hostname = this.resolvedConfig.values.hostname;
+        this.log(t('commands.cap.uninstall.lookingUp', 'Looking up {{appName}} on {{hostname}} (site: {{site}})...', {
+            appName,
+            hostname,
+            site,
+        }));
+        const listResult = await this.operations.listInstalledApps(this.instance, {
+            sites: [site],
+            waitOptions: { timeoutSeconds: timeout || undefined },
+        });
+        const feature = listResult.features.find((f) => f.featureName === appName);
+        if (!feature) {
+            this.error(t('commands.cap.uninstall.notFound', 'Commerce App "{{appName}}" not found on site {{site}}', {
+                appName,
+                site,
+            }));
+        }
+        const domain = feature.featureDomain;
+        this.log(t('commands.cap.uninstall.uninstalling', 'Uninstalling {{appName}} from {{hostname}} (site: {{site}})...', {
+            appName,
+            hostname,
+            site,
+        }));
+        const context = this.createContext('cap:uninstall', { appName, domain, site, hostname });
+        const beforeResult = await this.runBeforeHooks(context);
+        if (beforeResult.skip) {
+            this.log(t('commands.cap.uninstall.skipped', 'Uninstall skipped: {{reason}}', {
+                reason: beforeResult.skipReason || 'skipped by plugin',
+            }));
+            return {
+                execution: { execution_status: 'finished', exit_status: { code: 'skipped' } },
+                appName,
+            };
+        }
+        try {
+            const result = await this.operations.commerceAppUninstall(this.instance, appName, domain, {
+                siteId: site,
+                waitOptions: {
+                    timeoutSeconds: timeout || undefined,
+                    onPoll: (info) => {
+                        if (!this.jsonEnabled()) {
+                            this.log(t('commands.cap.uninstall.progress', '  Status: {{status}} ({{elapsed}}s elapsed)', {
+                                status: info.status,
+                                elapsed: Math.floor(info.elapsedSeconds).toString(),
+                            }));
+                        }
+                    },
+                },
+            });
+            const durationSec = result.execution.duration ? (result.execution.duration / 1000).toFixed(1) : 'N/A';
+            this.log(t('commands.cap.uninstall.completed', 'Uninstall completed: {{status}} (duration: {{duration}}s)', {
+                status: result.execution.exit_status?.code || result.execution.execution_status,
+                duration: durationSec,
+            }));
+            await this.runAfterHooks(context, {
+                success: true,
+                duration: Date.now() - context.startTime,
+                data: result,
+            });
+            return result;
+        }
+        catch (error) {
+            await this.runAfterHooks(context, {
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                duration: Date.now() - context.startTime,
+                data: error instanceof JobExecutionError ? error.execution : undefined,
+            });
+            if (error instanceof JobExecutionError) {
+                await this.showJobLog(error.execution);
+                this.error(t('commands.cap.uninstall.failed', 'Uninstall failed: {{status}}', {
+                    status: error.execution.exit_status?.code || 'ERROR',
+                }));
+            }
+            if (error instanceof Error) {
+                this.error(t('commands.cap.uninstall.error', 'Uninstall error: {{message}}', { message: error.message }));
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/cap/uninstall.js.map

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

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

@@ -0,0 +1,11 @@
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type CapValidationResult } from '@salesforce/b2c-tooling-sdk/operations/cap';
+export default class CapValidate extends BaseCommand<typeof CapValidate> {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<CapValidationResult>;
+}

package/dist/commands/cap/validate.js

@@ -0,0 +1,49 @@
+/*
+ * 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 } from '@oclif/core';
+import { BaseCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { validateCap } from '@salesforce/b2c-tooling-sdk/operations/cap';
+import { t, withDocs } from '../../i18n/index.js';
+export default class CapValidate extends BaseCommand {
+    static args = {
+        path: Args.string({
+            description: 'Path to a CAP directory or .zip file',
+            required: true,
+        }),
+    };
+    static description = withDocs(t('commands.cap.validate.description', 'Validate the structure and manifest of a Commerce App Package (CAP)'), '/cli/cap.html#b2c-cap-validate');
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> <%= command.id %> ./commerce-avalara-tax-app-v0.2.5',
+        '<%= config.bin %> <%= command.id %> ./commerce-avalara-tax-app-v0.2.5.zip',
+    ];
+    async run() {
+        const { path } = this.args;
+        this.log(t('commands.cap.validate.validating', 'Validating CAP: {{path}}', { path }));
+        const result = await validateCap(path);
+        if (result.errors.length > 0) {
+            this.log(`\nErrors (${result.errors.length}):`);
+            for (const err of result.errors) {
+                this.log(`  ✗ ${err}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            this.log(`\nWarnings (${result.warnings.length}):`);
+            for (const warn of result.warnings) {
+                this.log(`  ⚠ ${warn}`);
+            }
+        }
+        if (result.valid) {
+            const appInfo = result.manifest ? ` (${result.manifest.name} v${result.manifest.version})` : '';
+            this.log(t('commands.cap.validate.valid', '\n✓ CAP is valid{{appInfo}}', { appInfo }));
+        }
+        else {
+            this.error(`CAP validation failed with ${result.errors.length} error(s)`, { exit: 1 });
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/cap/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAC,WAAW,EAA2B,MAAM,4CAA4C,CAAC;AACjG,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAA+B;IACtE,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,sCAAsC;YACnD,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,QAAQ,CAC3B,CAAC,CAAC,mCAAmC,EAAE,qEAAqE,CAAC,EAC7G,gCAAgC,CACjC,CAAC;IAEF,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE7B,MAAM,CAAC,QAAQ,GAAG;QAChB,uEAAuE;QACvE,2EAA2E;KAC5E,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAEzB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,kCAAkC,EAAE,0BAA0B,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC;QAEpF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;YACpD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B,EAAE,6BAA6B,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,MAAM,CAAC,MAAM,WAAW,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAC;QACvF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/setup/skills.js

@@ -6,7 +6,7 @@
 import { Args, Flags, ux } from '@oclif/core';
 import { checkbox, confirm, input } from '@inquirer/prompts';
 import { BaseCommand, createTable } from '@salesforce/b2c-tooling-sdk/cli';
-import { ALL_IDE_TYPES, detectInstalledIdes, downloadSkillsArtifact, scanSkills, installSkills, isSkillInstalled, getIdeDisplayName, getIdeDocsUrl, findSkillsByName, } from '@salesforce/b2c-tooling-sdk/skills';
+import { ALL_IDE_TYPES, ALL_SKILL_SETS, SKILL_SOURCES, detectInstalledIdes, downloadSkillsArtifact, scanSkills, installSkills, isSkillInstalled, getIdeDisplayName, getIdeDocsUrl, findSkillsByName, } from '@salesforce/b2c-tooling-sdk/skills';
 import { t, withDocs } from '../../i18n/index.js';
 /**
  * Table columns for skill listing.
@@ -33,8 +33,8 @@ const DEFAULT_SKILL_COLUMNS = ['name', 'description', 'skillSet'];
 export default class SetupSkills extends BaseCommand {
     static args = {
         skillset: Args.string({
-            description: 'Skill set to install: b2c or b2c-cli',
-            options: ['b2c', 'b2c-cli'],
+            description: 'Skill set to install: b2c, b2c-cli, or cap-dev',
+            options: ALL_SKILL_SETS,
         }),
     };
     static description = withDocs(t('commands.setup.skills.description', 'Install agent skills for AI-powered IDEs'), '/cli/setup.html#b2c-setup-skills');
@@ -42,6 +42,7 @@ export default class SetupSkills extends BaseCommand {
     static examples = [
         '<%= config.bin %> <%= command.id %> b2c',
         '<%= config.bin %> <%= command.id %> b2c-cli --ide cursor --global',
+        '<%= config.bin %> <%= command.id %> cap-dev --ide claude-code --global',
         '<%= config.bin %> <%= command.id %> b2c --list',
         '<%= config.bin %> <%= command.id %> b2c-cli --skill b2c-code --skill b2c-webdav --ide cursor',
         '<%= config.bin %> <%= command.id %> b2c --global --update --force',
@@ -93,15 +94,15 @@ export default class SetupSkills extends BaseCommand {
             skillsets = [this.args.skillset];
         }
         else if (this.flags.force) {
-            this.error(t('commands.setup.skills.skillsetRequired', 'Skillset argument required in non-interactive mode. Specify b2c or b2c-cli.'));
+            this.error(t('commands.setup.skills.skillsetRequired', 'Skillset argument required in non-interactive mode. Specify b2c, b2c-cli, or cap-dev.'));
         }
         else {
             skillsets = await checkbox({
                 message: t('commands.setup.skills.selectSkillset', 'Select skill set(s) to install:'),
-                choices: [
-                    { name: 'b2c - B2C Commerce development patterns', value: 'b2c' },
-                    { name: 'b2c-cli - B2C CLI commands and operations', value: 'b2c-cli' },
-                ],
+                choices: ALL_SKILL_SETS.map((id) => ({
+                    name: `${id} - ${SKILL_SOURCES[id].displayName}`,
+                    value: id,
+                })),
             });
             if (skillsets.length === 0) {
                 ux.stdout(t('commands.setup.skills.noSkillsetsSelected', 'No skill sets selected.'));
@@ -109,9 +110,21 @@ export default class SetupSkills extends BaseCommand {
             }
         }
         // Download and scan skills
-        this.log(t('commands.setup.skills.downloading', 'Downloading skills from release {{version}}...', {
-            version: this.flags.version || 'latest',
-        }));
+        const hasReleaseArtifacts = skillsets.some((s) => SKILL_SOURCES[s].type === 'release-artifact');
+        const hasRepoContents = skillsets.some((s) => SKILL_SOURCES[s].type === 'repo-contents');
+        if (hasReleaseArtifacts && hasRepoContents) {
+            this.log(t('commands.setup.skills.downloading', 'Downloading skills...'));
+        }
+        else if (hasRepoContents) {
+            this.log(t('commands.setup.skills.downloadingRepo', 'Downloading skills from repository ({{ref}})...', {
+                ref: this.flags.version || 'main',
+            }));
+        }
+        else {
+            this.log(t('commands.setup.skills.downloadingRelease', 'Downloading skills from release {{version}}...', {
+                version: this.flags.version || 'latest',
+            }));
+        }
         // Download skills for all skillsets in parallel
         const downloadResults = await Promise.all(skillsets.map(async (skillset) => {
             const skillsDir = await downloadSkillsArtifact(skillset, {