@salesforce/b2c-cli 0.0.1 → 0.0.7

package/dist/i18n/locales/index.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Locale resources for b2c-cli commands.
+ *
+ * Each locale file exports a translation object matching the structure
+ * of keys used in t() calls. English is included for documentation
+ * but defaults are defined inline at point of use.
+ *
+ * To add a new language:
+ * 1. Create a new file (e.g., fr.ts) with translations
+ * 2. Import and add to the locales object below
+ */
+/**
+ * All locale resources for the 'cli' namespace.
+ */
+export declare const locales: {
+    de: {
+        commands: {
+            sites: {
+                list: {
+                    description: string;
+                    fetching: string;
+                    fetchFailed: string;
+                    noSites: string;
+                    foundSites: string;
+                    displayName: string;
+                    status: string;
+                    error: string;
+                };
+            };
+            code: {
+                deploy: {
+                    description: string;
+                    deploying: string;
+                    target: string;
+                    codeVersion: string;
+                    complete: string;
+                    failed: string;
+                };
+            };
+            sandbox: {
+                create: {
+                    description: string;
+                    creating: string;
+                    profile: string;
+                    ttl: string;
+                    stub: string;
+                    wouldCreate: string;
+                };
+            };
+            mrt: {
+                envVar: {
+                    set: {
+                        description: string;
+                        setting: string;
+                        stub: string;
+                        wouldSet: string;
+                        project: string;
+                        environment: string;
+                    };
+                };
+            };
+        };
+    };
+    en: {
+        commands: {
+            sites: {
+                list: {
+                    description: string;
+                    fetching: string;
+                    fetchFailed: string;
+                    noSites: string;
+                    foundSites: string;
+                    displayName: string;
+                    status: string;
+                    error: string;
+                };
+            };
+            docs: {
+                search: {
+                    description: string;
+                    queryRequired: string;
+                    noResults: string;
+                    resultCount: string;
+                    totalCount: string;
+                };
+                read: {
+                    description: string;
+                    notFound: string;
+                };
+                download: {
+                    description: string;
+                    downloading: string;
+                    success: string;
+                    archiveKept: string;
+                };
+                schema: {
+                    description: string;
+                    queryRequired: string;
+                    notFound: string;
+                    available: string;
+                    count: string;
+                };
+            };
+            code: {
+                list: {
+                    description: string;
+                    fetching: string;
+                    noVersions: string;
+                    error: string;
+                };
+                activate: {
+                    description: string;
+                    activating: string;
+                    activated: string;
+                    reloading: string;
+                    reloaded: string;
+                    failed: string;
+                    reloadFailed: string;
+                    versionRequired: string;
+                };
+                delete: {
+                    description: string;
+                    deleting: string;
+                    deleted: string;
+                    failed: string;
+                    confirm: string;
+                    cancelled: string;
+                };
+                deploy: {
+                    description: string;
+                    deploying: string;
+                    noCodeVersion: string;
+                    noActiveVersion: string;
+                    summary: string;
+                    reloaded: string;
+                    failed: string;
+                };
+                watch: {
+                    description: string;
+                    starting: string;
+                    target: string;
+                    codeVersion: string;
+                    watching: string;
+                    pressCtrlC: string;
+                    stopping: string;
+                    uploaded: string;
+                    deleted: string;
+                    error: string;
+                    failed: string;
+                };
+            };
+            sandbox: {
+                create: {
+                    description: string;
+                    creating: string;
+                    profile: string;
+                    ttl: string;
+                    stub: string;
+                    wouldCreate: string;
+                };
+            };
+            mrt: {
+                envVar: {
+                    set: {
+                        description: string;
+                        setting: string;
+                        stub: string;
+                        wouldSet: string;
+                        project: string;
+                        environment: string;
+                    };
+                };
+            };
+        };
+    };
+};
+export type SupportedLocale = keyof typeof locales;

package/dist/i18n/locales/index.js

@@ -0,0 +1,26 @@
+/*
+ * 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
+ */
+/**
+ * Locale resources for b2c-cli commands.
+ *
+ * Each locale file exports a translation object matching the structure
+ * of keys used in t() calls. English is included for documentation
+ * but defaults are defined inline at point of use.
+ *
+ * To add a new language:
+ * 1. Create a new file (e.g., fr.ts) with translations
+ * 2. Import and add to the locales object below
+ */
+import { de } from './de.js';
+import { en } from './en.js';
+/**
+ * All locale resources for the 'cli' namespace.
+ */
+export const locales = {
+    de,
+    en,
+};
+//# sourceMappingURL=index.js.map

package/dist/i18n/locales/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/i18n/locales/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;GAUG;AAEH,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAC;AAE3B;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,EAAE;IACF,EAAE;CACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { run } from '@oclif/core';
+export { BaseCommand, OAuthCommand, InstanceCommand, MrtCommand, loadConfig, findDwJson, } from '@salesforce/b2c-tooling-sdk/cli';
+export type { LoadConfigOptions } from '@salesforce/b2c-tooling-sdk/cli';

package/dist/index.js

@@ -0,0 +1,13 @@
+/*
+ * 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
+ */
+export { run } from '@oclif/core';
+// Re-export CLI utilities from b2c-tooling for convenience
+export { 
+// Command base classes
+BaseCommand, OAuthCommand, InstanceCommand, MrtCommand, 
+// Config utilities
+loadConfig, findDwJson, } from '@salesforce/b2c-tooling-sdk/cli';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAEhC,2DAA2D;AAC3D,OAAO;AACL,uBAAuB;AACvB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,UAAU;AACV,mBAAmB;AACnB,UAAU,EACV,UAAU,GACX,MAAM,iCAAiC,CAAC"}

package/dist/utils/slas/client.d.ts

@@ -0,0 +1,65 @@
+import { Command } from '@oclif/core';
+import { OAuthCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { type SlasClient, type SlasComponents } from '@salesforce/b2c-tooling-sdk';
+export type Client = SlasComponents['schemas']['Client'];
+export type ClientRequest = SlasComponents['schemas']['ClientRequest'];
+/**
+ * JSON output structure for SLAS client commands
+ */
+export interface ClientOutput {
+    clientId: string;
+    name: string;
+    secret?: string;
+    scopes: string[];
+    channels: string[];
+    redirectUri: string;
+    callbackUri?: string;
+    isPrivateClient: boolean;
+}
+/**
+ * Normalize a client response from the API.
+ * Handles scopes being returned as space-separated string.
+ */
+export declare function normalizeClientResponse(client: Client): ClientOutput;
+/**
+ * Print client details in a formatted table.
+ */
+export declare function printClientDetails(output: ClientOutput, showSecret?: boolean): void;
+/**
+ * Format API error for display.
+ */
+export declare function formatApiError(error: unknown): string;
+/**
+ * Base command for SLAS client operations.
+ * Provides common flags and helper methods.
+ */
+export declare abstract class SlasClientCommand<T extends typeof Command> extends OAuthCommand<T> {
+    static baseFlags: {
+        'tenant-id': import("@oclif/core/interfaces").OptionFlag<string, 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>;
+        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>;
+        'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        '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>;
+        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>;
+    };
+    /**
+     * Ensure tenant exists, creating it if necessary.
+     * This is required before creating SLAS clients.
+     */
+    protected ensureTenantExists(slasClient: SlasClient, tenantId: string): Promise<void>;
+    /**
+     * Get the SLAS client, ensuring short code is configured.
+     */
+    protected getSlasClient(): SlasClient;
+}

package/dist/utils/slas/client.js

@@ -0,0 +1,146 @@
+/*
+ * 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 { Command, Flags, ux } from '@oclif/core';
+import cliui from 'cliui';
+import { OAuthCommand } from '@salesforce/b2c-tooling-sdk/cli';
+import { createSlasClient } from '@salesforce/b2c-tooling-sdk';
+import { t } from '../../i18n/index.js';
+/**
+ * Normalize a client response from the API.
+ * Handles scopes being returned as space-separated string.
+ */
+export function normalizeClientResponse(client) {
+    // Normalize scopes - API returns space-separated string
+    const scopes = typeof client.scopes === 'string'
+        ? client.scopes.split(' ')
+        : Array.isArray(client.scopes)
+            ? client.scopes
+            : [];
+    const channels = Array.isArray(client.channels) ? client.channels : [];
+    // redirectUri can be returned as string or array from the API
+    const redirectUri = Array.isArray(client.redirectUri) ? client.redirectUri.join(', ') : (client.redirectUri ?? '');
+    return {
+        clientId: client.clientId ?? '',
+        name: client.name ?? '',
+        secret: client.secret,
+        scopes,
+        channels,
+        redirectUri,
+        callbackUri: client.callbackUri,
+        isPrivateClient: client.isPrivateClient ?? true,
+    };
+}
+/**
+ * Print client details in a formatted table.
+ */
+export function printClientDetails(output, showSecret = true) {
+    const ui = cliui({ width: process.stdout.columns || 80 });
+    const labelWidth = 14;
+    ui.div('');
+    ui.div({ text: 'Client ID:', width: labelWidth }, { text: output.clientId });
+    ui.div({ text: 'Name:', width: labelWidth }, { text: output.name });
+    ui.div({ text: 'Private:', width: labelWidth }, { text: String(output.isPrivateClient) });
+    ui.div({ text: 'Channels:', width: labelWidth }, { text: output.channels.join(', ') });
+    ui.div({ text: 'Scopes:', width: labelWidth }, { text: output.scopes.join('\n' + ' '.repeat(labelWidth)) });
+    ui.div({ text: 'Redirect URI:', width: labelWidth }, { text: output.redirectUri });
+    if (output.callbackUri) {
+        ui.div({ text: 'Callback URI:', width: labelWidth }, { text: output.callbackUri });
+    }
+    if (showSecret && output.secret) {
+        ui.div('');
+        ui.div({
+            text: t('commands.slas.client.create.secretWarning', 'IMPORTANT: Save the client secret - it will not be shown again:'),
+        });
+        ui.div({ text: 'Secret:', width: labelWidth }, { text: output.secret });
+    }
+    ux.stdout(ui.toString());
+}
+/**
+ * Format API error for display.
+ */
+export function formatApiError(error) {
+    return typeof error === 'object' ? JSON.stringify(error) : String(error);
+}
+/**
+ * Base command for SLAS client operations.
+ * Provides common flags and helper methods.
+ */
+export class SlasClientCommand extends OAuthCommand {
+    static baseFlags = {
+        ...OAuthCommand.baseFlags,
+        'tenant-id': Flags.string({
+            description: 'SLAS tenant ID (organization ID)',
+            env: 'SFCC_TENANT_ID',
+            required: true,
+        }),
+    };
+    /**
+     * Ensure tenant exists, creating it if necessary.
+     * This is required before creating SLAS clients.
+     */
+    async ensureTenantExists(slasClient, tenantId) {
+        // Try to get the tenant first
+        const { error, response } = await slasClient.GET('/tenants/{tenantId}', {
+            params: {
+                path: { tenantId },
+            },
+        });
+        // If tenant exists, we're done
+        if (!error) {
+            return;
+        }
+        // Check if this is a "tenant not found" error (SLAS returns 400 with TenantNotFoundException)
+        const isTenantNotFound = response.status === 404 ||
+            (response.status === 400 &&
+                typeof error === 'object' &&
+                error !== null &&
+                'exception_name' in error &&
+                error.exception_name === 'TenantNotFoundException');
+        // If it's not a tenant-not-found error, something else went wrong
+        if (!isTenantNotFound) {
+            this.error(t('commands.slas.client.create.tenantError', 'Failed to check tenant: {{message}}', {
+                message: formatApiError(error),
+            }));
+        }
+        // Tenant doesn't exist, create it with placeholder values
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.slas.client.create.creatingTenant', 'Creating SLAS tenant {{tenantId}}...', { tenantId }));
+        }
+        const { error: createError } = await slasClient.PUT('/tenants/{tenantId}', {
+            params: {
+                path: { tenantId },
+            },
+            body: {
+                tenantId,
+                merchantName: 'B2C CLI Tenant',
+                description: 'Auto-created by b2c-cli',
+                contact: 'B2C CLI',
+                emailAddress: 'noreply@example.com',
+                phoneNo: '+1 000-000-0000',
+            },
+        });
+        if (createError) {
+            this.error(t('commands.slas.client.create.tenantCreateError', 'Failed to create tenant: {{message}}', {
+                message: formatApiError(createError),
+            }));
+        }
+        if (!this.jsonEnabled()) {
+            this.log(t('commands.slas.client.create.tenantCreated', 'SLAS tenant created successfully.'));
+        }
+    }
+    /**
+     * Get the SLAS client, ensuring short code is configured.
+     */
+    getSlasClient() {
+        const { shortCode } = this.resolvedConfig.values;
+        if (!shortCode) {
+            this.error(t('error.shortCodeRequired', 'SCAPI short code required. Provide --short-code, set SFCC_SHORTCODE, or configure short-code in dw.json.'));
+        }
+        const oauthStrategy = this.getOAuthStrategy();
+        return createSlasClient({ shortCode }, oauthStrategy);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/utils/slas/client.js.map

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

package/node_modules/@salesforce/b2c-tooling-sdk/README.md

@@ -0,0 +1,174 @@
+# Salesforce Commerce Cloud B2C Tooling SDK
+
+> [!NOTE]
+> This project is currently in **Developer Preview**. Not all features are implemented, and the API may change in future releases.
+
+A TypeScript SDK for programmatic access to Salesforce Commerce Cloud B2C APIs including OCAPI, WebDAV, SLAS, ODS, and MRT.
+
+[![Version](https://img.shields.io/npm/v/@salesforce/b2c-tooling-sdk.svg)](https://npmjs.org/package/@salesforce/b2c-tooling-sdk)
+
+## Installation
+
+```bash
+npm install @salesforce/b2c-tooling-sdk
+```
+
+## Quick Start
+
+### From Configuration (Recommended)
+
+Use `resolveConfig()` to load configuration from project files (dw.json) and create a B2C instance:
+
+```typescript
+import {resolveConfig} from '@salesforce/b2c-tooling-sdk/config';
+
+// Load configuration, override secrets from environment
+const config = resolveConfig({
+  clientId: process.env.SFCC_CLIENT_ID,
+  clientSecret: process.env.SFCC_CLIENT_SECRET,
+});
+
+// Create instance from validated config
+const instance = config.createB2CInstance();
+
+// Use typed WebDAV client
+await instance.webdav.mkcol('Cartridges/v1');
+await instance.webdav.put('Cartridges/v1/app.zip', zipBuffer);
+
+// Use typed OCAPI client (openapi-fetch)
+const {data, error} = await instance.ocapi.GET('/sites', {
+  params: {query: {select: '(**)'}},
+});
+```
+
+### Direct Construction
+
+For advanced use cases, you can construct a B2CInstance directly:
+
+```typescript
+import {B2CInstance} from '@salesforce/b2c-tooling-sdk';
+
+const instance = new B2CInstance(
+  {hostname: 'your-sandbox.demandware.net', codeVersion: 'v1'},
+  {
+    oauth: {
+      clientId: 'your-client-id',
+      clientSecret: 'your-client-secret',
+    },
+  },
+);
+```
+
+## Features
+
+### WebDAV Operations
+
+```typescript
+// Create directories
+await instance.webdav.mkcol('Cartridges/v1');
+
+// Upload files
+await instance.webdav.put('Cartridges/v1/app.zip', buffer, 'application/zip');
+
+// Download files
+const content = await instance.webdav.get('Cartridges/v1/app.zip');
+
+// List directory
+const entries = await instance.webdav.propfind('Cartridges');
+
+// Check existence
+const exists = await instance.webdav.exists('Cartridges/v1');
+
+// Delete
+await instance.webdav.delete('Cartridges/v1/old-file.zip');
+```
+
+### OCAPI Client
+
+The OCAPI client uses [openapi-fetch](https://openapi-ts.dev/openapi-fetch/) with full TypeScript support:
+
+```typescript
+// List sites
+const {data, error} = await instance.ocapi.GET('/sites', {
+  params: {query: {select: '(**)'}},
+});
+
+// Activate a code version
+const {data, error} = await instance.ocapi.PATCH('/code_versions/{code_version_id}', {
+  params: {path: {code_version_id: 'v1'}},
+  body: {active: true},
+});
+```
+
+### Code Deployment
+
+```typescript
+import {findAndDeployCartridges, activateCodeVersion} from '@salesforce/b2c-tooling-sdk/operations/code';
+
+// Deploy cartridges
+await findAndDeployCartridges(instance, './cartridges', {reload: true});
+
+// Activate code version
+await activateCodeVersion(instance, 'v1');
+```
+
+### Job Execution
+
+```typescript
+import {executeJob, waitForJob, siteArchiveImport} from '@salesforce/b2c-tooling-sdk/operations/jobs';
+
+// Run a job and wait for completion
+const execution = await executeJob(instance, 'my-job-id');
+const result = await waitForJob(instance, 'my-job-id', execution.id);
+
+// Import a site archive
+await siteArchiveImport(instance, './site-data.zip');
+```
+
+## Module Exports
+
+The SDK provides subpath exports for tree-shaking and organization:
+
+| Export                                         | Description                                           |
+| ---------------------------------------------- | ----------------------------------------------------- |
+| `@salesforce/b2c-tooling-sdk`                  | Main entry point with all exports                     |
+| `@salesforce/b2c-tooling-sdk/config`           | Configuration resolution (resolveConfig)              |
+| `@salesforce/b2c-tooling-sdk/auth`             | Authentication strategies (OAuth, Basic, API Key)     |
+| `@salesforce/b2c-tooling-sdk/instance`         | B2CInstance class                                     |
+| `@salesforce/b2c-tooling-sdk/clients`          | Low-level API clients (WebDAV, OCAPI, SLAS, ODS, MRT) |
+| `@salesforce/b2c-tooling-sdk/operations/code`  | Code deployment operations                            |
+| `@salesforce/b2c-tooling-sdk/operations/jobs`  | Job execution and site import/export                  |
+| `@salesforce/b2c-tooling-sdk/operations/sites` | Site management                                       |
+| `@salesforce/b2c-tooling-sdk/discovery`        | Workspace type detection (PWA Kit, SFRA, etc.)        |
+| `@salesforce/b2c-tooling-sdk/cli`              | CLI utilities (BaseCommand, table rendering)          |
+| `@salesforce/b2c-tooling-sdk/logging`          | Structured logging utilities                          |
+
+## Logging
+
+Configure logging for debugging HTTP requests:
+
+```typescript
+import {configureLogger} from '@salesforce/b2c-tooling-sdk/logging';
+
+// Enable debug logging (shows HTTP request summaries)
+configureLogger({level: 'debug'});
+
+// Enable trace logging (shows full request/response with headers and bodies)
+configureLogger({level: 'trace'});
+```
+
+## Documentation
+
+Full documentation is available at: https://salesforcecommercecloud.github.io/b2c-developer-tooling/
+
+## Requirements
+
+- Node.js >= 22.16.0
+
+## License
+
+This project is licensed under the Apache License 2.0. See [LICENSE.txt](../../LICENSE.txt) for full details.
+
+## Disclaimer
+
+This project is currently in **Developer Preview** and is provided "as-is" without warranty of any kind. It is not yet generally available (GA) and should not be used in production environments. Features, APIs, and functionality may change without notice in future releases.