@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/clients/slas-admin.generated.js

@@ -1,6 +0,0 @@
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-export {};
-//# sourceMappingURL=slas-admin.generated.js.map

package/dist/cjs/clients/slas-admin.generated.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"slas-admin.generated.js","sourceRoot":"","sources":["../../../src/clients/slas-admin.generated.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/cjs/clients/slas-admin.js

@@ -1,79 +0,0 @@
-/*
- * 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
- */
-/**
- * SLAS Admin API client for B2C Commerce.
- *
- * Provides a fully typed client for SLAS Admin API operations using
- * openapi-fetch with OAuth authentication middleware. Used for
- * administration tasks like managing tenants and SLAS clients.
- *
- * @module clients/slas-admin
- */
-import createClient from 'openapi-fetch';
-import { createAuthMiddleware, createLoggingMiddleware } from './middleware.js';
-import { globalMiddlewareRegistry } from './middleware-registry.js';
-/**
- * Creates a typed SLAS Admin API client.
- *
- * Returns the openapi-fetch client directly, with authentication
- * handled via middleware. This gives full access to all openapi-fetch
- * features with type-safe paths, parameters, and responses.
- *
- * @param config - SLAS client configuration
- * @param auth - Authentication strategy (typically OAuth)
- * @returns Typed openapi-fetch client
- *
- * @example
- * // Create SLAS client with OAuth auth
- * const oauthStrategy = new OAuthStrategy({
- *   clientId: 'your-client-id',
- *   clientSecret: 'your-client-secret',
- *   scopes: ['SLAS_ORGANIZATION_ADMIN']
- * });
- *
- * const client = createSlasClient(
- *   { shortCode: 'kv7kzm78' },
- *   oauthStrategy
- * );
- *
- * // Create or update a SLAS client
- * const { data, error } = await client.PUT('/tenants/{tenantId}/clients/{clientId}', {
- *   params: {
- *     path: { tenantId: 'your-tenant', clientId: 'new-client-id' }
- *   },
- *   body: {
- *     clientId: 'new-client-id',
- *     name: 'My SLAS Client',
- *     channels: ['RefArch'],
- *     scopes: ['sfcc.products', 'sfcc.catalogs'],
- *     redirectUri: ['http://localhost:3000/callback'],
- *     secret: '',
- *     isPrivateClient: true
- *   }
- * });
- *
- * @example
- * // List all clients for a tenant
- * const { data, error } = await client.GET('/tenants/{tenantId}/clients', {
- *   params: { path: { tenantId: 'your-tenant' } }
- * });
- */
-export function createSlasClient(config, auth) {
-    const registry = config.middlewareRegistry ?? globalMiddlewareRegistry;
-    const client = createClient({
-        baseUrl: `https://${config.shortCode}.api.commercecloud.salesforce.com/shopper/auth-admin/v1`,
-    });
-    // Core middleware: auth first
-    client.use(createAuthMiddleware(auth));
-    // Plugin middleware from registry
-    for (const middleware of registry.getMiddleware('slas')) {
-        client.use(middleware);
-    }
-    // Logging middleware last (sees complete request with all modifications)
-    client.use(createLoggingMiddleware('SLAS'));
-    return client;
-}
-//# sourceMappingURL=slas-admin.js.map

package/dist/cjs/clients/slas-admin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"slas-admin.js","sourceRoot":"","sources":["../../../src/clients/slas-admin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;GAQG;AACH,OAAO,YAA2B,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAC,oBAAoB,EAAE,uBAAuB,EAAC,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAC,wBAAwB,EAA0B,MAAM,0BAA0B,CAAC;AA4E3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB,EAAE,IAAkB;IAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,IAAI,wBAAwB,CAAC;IAEvE,MAAM,MAAM,GAAG,YAAY,CAAQ;QACjC,OAAO,EAAE,WAAW,MAAM,CAAC,SAAS,yDAAyD;KAC9F,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvC,kCAAkC;IAClC,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,yEAAyE;IACzE,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/clients/tls-dispatcher.d.ts

@@ -1,42 +0,0 @@
-/**
- * TLS/mTLS dispatcher utilities for client certificate authentication.
- *
- * This module provides utilities for creating undici Agents with custom
- * TLS options, enabling two-factor authentication via client certificates.
- *
- * @module clients/tls-dispatcher
- */
-import { Agent } from 'undici';
-/**
- * TLS options for creating a dispatcher.
- */
-export interface TlsOptions {
-    /** Path to PKCS12 (.p12/.pfx) certificate file */
-    certificate?: string;
-    /** Passphrase for the certificate */
-    passphrase?: string;
-    /** Whether to reject unauthorized (invalid/self-signed) certificates */
-    rejectUnauthorized?: boolean;
-}
-/**
- * Creates an undici Agent with custom TLS options for mTLS/self-signed cert support.
- *
- * Returns undefined if no TLS options are needed (default fetch behavior).
- *
- * @param options - TLS configuration options
- * @returns An undici Agent configured for TLS, or undefined if not needed
- *
- * @example
- * // Client certificate authentication
- * const dispatcher = createTlsDispatcher({
- *   certificate: './my-cert.p12',
- *   passphrase: 'secret',
- * });
- *
- * @example
- * // Self-signed certificate support
- * const dispatcher = createTlsDispatcher({
- *   rejectUnauthorized: false,
- * });
- */
-export declare function createTlsDispatcher(options: TlsOptions): Agent | undefined;

package/dist/cjs/clients/tls-dispatcher.js

@@ -1,107 +0,0 @@
-/*
- * 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
- */
-/**
- * TLS/mTLS dispatcher utilities for client certificate authentication.
- *
- * This module provides utilities for creating undici Agents with custom
- * TLS options, enabling two-factor authentication via client certificates.
- *
- * @module clients/tls-dispatcher
- */
-import { Agent } from 'undici';
-import * as fs from 'node:fs';
-import * as tls from 'node:tls';
-import { getLogger } from '../logging/logger.js';
-/**
- * Validates a PKCS12 certificate file by attempting to create a secure context.
- * This catches errors like missing/wrong passphrase early with a clear message.
- *
- * @param pfxData - The raw PKCS12 file data
- * @param passphrase - Optional passphrase for the certificate
- * @param certificatePath - Path to the certificate (for error messages)
- * @throws Error with a user-friendly message if validation fails
- */
-function validatePkcs12(pfxData, passphrase, certificatePath) {
-    try {
-        tls.createSecureContext({
-            pfx: pfxData,
-            passphrase: passphrase,
-        });
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        // Detect common PKCS12 errors and provide helpful messages
-        if (message.includes('mac verify failure') || message.includes('bad decrypt')) {
-            if (passphrase) {
-                throw new Error(`Invalid passphrase for certificate "${certificatePath}". ` + `The provided passphrase is incorrect.`);
-            }
-            else {
-                throw new Error(`Certificate "${certificatePath}" requires a passphrase. ` +
-                    `Use --passphrase to provide it, or set SFCC_CERTIFICATE_PASSPHRASE.`);
-            }
-        }
-        if (message.includes('not enough data') || message.includes('wrong tag')) {
-            throw new Error(`Invalid certificate file "${certificatePath}". ` +
-                `The file does not appear to be a valid PKCS12 (.p12/.pfx) certificate.`);
-        }
-        // Re-throw with context for other errors
-        throw new Error(`Failed to load certificate "${certificatePath}": ${message}`);
-    }
-}
-/**
- * Creates an undici Agent with custom TLS options for mTLS/self-signed cert support.
- *
- * Returns undefined if no TLS options are needed (default fetch behavior).
- *
- * @param options - TLS configuration options
- * @returns An undici Agent configured for TLS, or undefined if not needed
- *
- * @example
- * // Client certificate authentication
- * const dispatcher = createTlsDispatcher({
- *   certificate: './my-cert.p12',
- *   passphrase: 'secret',
- * });
- *
- * @example
- * // Self-signed certificate support
- * const dispatcher = createTlsDispatcher({
- *   rejectUnauthorized: false,
- * });
- */
-export function createTlsDispatcher(options) {
-    const logger = getLogger();
-    const { certificate, passphrase, rejectUnauthorized } = options;
-    // If no TLS customization needed, return undefined to use default fetch
-    if (!certificate && rejectUnauthorized !== false) {
-        return undefined;
-    }
-    const connect = {};
-    if (rejectUnauthorized === false) {
-        logger.debug('[TLS] Disabling SSL certificate verification (self-signed mode)');
-        connect.rejectUnauthorized = false;
-    }
-    if (certificate) {
-        logger.debug({ certificate }, `[TLS] Loading client certificate from: ${certificate}`);
-        // Read the certificate file
-        let pfxData;
-        try {
-            pfxData = fs.readFileSync(certificate);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            throw new Error(`Failed to read certificate file "${certificate}": ${message}`);
-        }
-        // Validate the certificate upfront to catch passphrase issues early
-        validatePkcs12(pfxData, passphrase, certificate);
-        connect.pfx = pfxData;
-        if (passphrase) {
-            connect.passphrase = passphrase;
-        }
-    }
-    return new Agent({ connect });
-}
-//# sourceMappingURL=tls-dispatcher.js.map

package/dist/cjs/clients/tls-dispatcher.js.map

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

package/dist/cjs/clients/user-agent.d.ts

@@ -1,43 +0,0 @@
-import type { HttpMiddlewareProvider } from './middleware-registry.js';
-import type { AuthMiddlewareProvider } from '../auth/middleware.js';
-/**
- * Sets the User-Agent string for all HTTP requests.
- *
- * Call this early in your application to override the default SDK User-Agent.
- * The CLI uses this to set a combined CLI+SDK User-Agent.
- *
- * @param userAgent - The User-Agent string to use
- *
- * @example
- * ```typescript
- * // CLI usage:
- * setUserAgent('b2c-cli/1.0.0');
- * ```
- */
-export declare function setUserAgent(userAgent: string): void;
-/**
- * Gets the current User-Agent string.
- *
- * @returns The current User-Agent string
- */
-export declare function getUserAgent(): string;
-/**
- * Resets the User-Agent to the default SDK value.
- *
- * Primarily useful for testing.
- */
-export declare function resetUserAgent(): void;
-/**
- * User-Agent middleware provider for HTTP clients.
- *
- * This provider is automatically registered with the global middleware registry
- * when this module is imported.
- */
-export declare const userAgentProvider: HttpMiddlewareProvider;
-/**
- * User-Agent middleware provider for auth requests.
- *
- * This provider is automatically registered with the global auth middleware registry
- * when this module is imported. It ensures OAuth token requests include User-Agent headers.
- */
-export declare const userAgentAuthProvider: AuthMiddlewareProvider;

package/dist/cjs/clients/user-agent.js

@@ -1,87 +0,0 @@
-/*
- * 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
- */
-/**
- * User-Agent middleware provider for HTTP clients.
- *
- * This module provides a global User-Agent that is applied to all HTTP requests.
- * The SDK sets a default User-Agent, which can be overridden by the CLI to include
- * both CLI and SDK version information.
- *
- * @module clients/user-agent
- */
-import { SDK_USER_AGENT } from '../version.js';
-import { createUserAgentMiddleware } from './middleware.js';
-import { globalMiddlewareRegistry } from './middleware-registry.js';
-import { globalAuthMiddlewareRegistry } from '../auth/middleware.js';
-// Current User-Agent string - defaults to SDK User-Agent
-let currentUserAgent = SDK_USER_AGENT;
-/**
- * Sets the User-Agent string for all HTTP requests.
- *
- * Call this early in your application to override the default SDK User-Agent.
- * The CLI uses this to set a combined CLI+SDK User-Agent.
- *
- * @param userAgent - The User-Agent string to use
- *
- * @example
- * ```typescript
- * // CLI usage:
- * setUserAgent('b2c-cli/1.0.0');
- * ```
- */
-export function setUserAgent(userAgent) {
-    currentUserAgent = userAgent;
-}
-/**
- * Gets the current User-Agent string.
- *
- * @returns The current User-Agent string
- */
-export function getUserAgent() {
-    return currentUserAgent;
-}
-/**
- * Resets the User-Agent to the default SDK value.
- *
- * Primarily useful for testing.
- */
-export function resetUserAgent() {
-    currentUserAgent = SDK_USER_AGENT;
-}
-/**
- * User-Agent middleware provider for HTTP clients.
- *
- * This provider is automatically registered with the global middleware registry
- * when this module is imported.
- */
-export const userAgentProvider = {
-    name: 'user-agent',
-    getMiddleware() {
-        return createUserAgentMiddleware({ userAgent: currentUserAgent });
-    },
-};
-/**
- * User-Agent middleware provider for auth requests.
- *
- * This provider is automatically registered with the global auth middleware registry
- * when this module is imported. It ensures OAuth token requests include User-Agent headers.
- */
-export const userAgentAuthProvider = {
-    name: 'user-agent',
-    getMiddleware() {
-        return {
-            async onRequest({ request }) {
-                request.headers.set('User-Agent', currentUserAgent);
-                request.headers.set('sfdc_user_agent', currentUserAgent);
-                return request;
-            },
-        };
-    },
-};
-// Auto-register with global middleware registries on module import
-globalMiddlewareRegistry.register(userAgentProvider);
-globalAuthMiddlewareRegistry.register(userAgentAuthProvider);
-//# sourceMappingURL=user-agent.js.map

package/dist/cjs/clients/user-agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-agent.js","sourceRoot":"","sources":["../../../src/clients/user-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;GAQG;AACH,OAAO,EAAC,cAAc,EAAC,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAC,yBAAyB,EAAC,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAC,4BAA4B,EAAC,MAAM,uBAAuB,CAAC;AAGnE,yDAAyD;AACzD,IAAI,gBAAgB,GAAG,cAAc,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,gBAAgB,GAAG,SAAS,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,gBAAgB,GAAG,cAAc,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,IAAI,EAAE,YAAY;IAClB,aAAa;QACX,OAAO,yBAAyB,CAAC,EAAC,SAAS,EAAE,gBAAgB,EAAC,CAAC,CAAC;IAClE,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,IAAI,EAAE,YAAY;IAClB,aAAa;QACX,OAAO;YACL,KAAK,CAAC,SAAS,CAAC,EAAC,OAAO,EAAC;gBACvB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;gBACpD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;gBACzD,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,mEAAmE;AACnE,wBAAwB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACrD,4BAA4B,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/cjs/clients/webdav.d.ts

@@ -1,186 +0,0 @@
-import type { Dispatcher } from 'undici';
-import type { AuthStrategy } from '../auth/types.js';
-import { type MiddlewareRegistry } from './middleware-registry.js';
-/**
- * Result of a PROPFIND operation.
- */
-export interface PropfindEntry {
-    href: string;
-    displayName?: string;
-    isCollection: boolean;
-    contentLength?: number;
-    lastModified?: Date;
-    contentType?: string;
-}
-/**
- * WebDAV client for B2C Commerce instance file operations.
- *
- * Handles WebDAV requests with proper authentication and provides
- * typed methods for common operations.
- *
- * **Note:** This client is typically accessed via `B2CInstance.webdav` rather
- * than instantiated directly. The `B2CInstance` class handles authentication setup.
- *
- * @example
- * // Via B2CInstance (recommended)
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- * const config = resolveConfig();
- * const instance = config.createB2CInstance();
- * await instance.webdav.mkcol('Cartridges/v1');
- * await instance.webdav.put('Cartridges/v1/app.zip', zipBuffer);
- *
- * @example
- * // Direct instantiation (advanced)
- * const client = new WebDavClient('sandbox.demandware.net', authStrategy);
- * await client.mkcol('Cartridges/v1');
- * await client.put('Cartridges/v1/app_storefront/cartridge.zip', zipBuffer);
- */
-/**
- * Options for creating a WebDAV client.
- */
-export interface WebDavClientOptions {
-    /**
-     * Middleware registry to use for this client.
-     * If not specified, uses the global middleware registry.
-     */
-    middlewareRegistry?: MiddlewareRegistry;
-    /**
-     * undici dispatcher for custom TLS options (mTLS, self-signed certs).
-     * Use createTlsDispatcher() to create one with client certificates.
-     */
-    dispatcher?: Dispatcher;
-}
-export declare class WebDavClient {
-    private auth;
-    private baseUrl;
-    private middlewareRegistry;
-    private dispatcher?;
-    /**
-     * Creates a new WebDAV client.
-     *
-     * @param hostname - WebDAV hostname (may differ from API hostname)
-     * @param auth - Authentication strategy to use for requests
-     * @param options - Optional configuration including middleware registry and TLS dispatcher
-     */
-    constructor(hostname: string, auth: AuthStrategy, options?: WebDavClientOptions);
-    /**
-     * Builds the full URL for a WebDAV path.
-     *
-     * @param path - Path relative to /webdav/Sites/
-     * @returns Full URL
-     */
-    buildUrl(path: string): string;
-    /**
-     * Collects middleware from the registry for WebDAV client.
-     */
-    private getMiddleware;
-    /**
-     * Makes a raw WebDAV request.
-     *
-     * @param path - Path relative to /webdav/Sites/
-     * @param init - Fetch init options
-     * @returns Response from the server
-     */
-    request(path: string, init?: RequestInit): Promise<Response>;
-    /**
-     * Converts Headers to a plain object for logging.
-     */
-    private headersToObject;
-    /**
-     * Formats body for logging, describing binary data.
-     */
-    private formatBody;
-    /**
-     * Creates a directory (collection).
-     *
-     * @param path - Path to create
-     * @throws Error if creation fails (except 405 which means already exists)
-     *
-     * @example
-     * await client.mkcol('Cartridges/v1');
-     */
-    mkcol(path: string): Promise<void>;
-    /**
-     * Uploads a file.
-     *
-     * @param path - Destination path
-     * @param content - File content as Buffer, Blob, or string
-     * @param contentType - Optional content type header
-     *
-     * @example
-     * await client.put('Cartridges/v1/app.zip', zipBuffer, 'application/zip');
-     */
-    put(path: string, content: Buffer | Blob | string, contentType?: string): Promise<void>;
-    /**
-     * Downloads a file.
-     *
-     * @param path - Path to download
-     * @returns File content as ArrayBuffer
-     *
-     * @example
-     * const content = await client.get('Cartridges/v1/app.zip');
-     */
-    get(path: string): Promise<ArrayBuffer>;
-    /**
-     * Deletes a file or directory.
-     *
-     * @param path - Path to delete
-     * @throws Error if the path doesn't exist (404) or deletion fails
-     *
-     * @example
-     * await client.delete('Cartridges/v1/old-cartridge');
-     */
-    delete(path: string): Promise<void>;
-    /**
-     * Lists directory contents.
-     *
-     * @param path - Directory path
-     * @param depth - PROPFIND depth (0, 1, or 'infinity')
-     * @returns Array of entries in the directory
-     *
-     * @example
-     * const entries = await client.propfind('Cartridges');
-     * for (const entry of entries) {
-     *   console.log(entry.displayName, entry.isCollection);
-     * }
-     */
-    propfind(path: string, depth?: '0' | '1' | 'infinity'): Promise<PropfindEntry[]>;
-    /**
-     * Copies a file or directory.
-     *
-     * @param source - Source path relative to /webdav/Sites/
-     * @param destination - Destination path relative to /webdav/Sites/
-     * @param overwrite - Whether to overwrite if destination exists (default: true)
-     *
-     * @example
-     * await client.copy('Cartridges/v1/cartridge', 'Cartridges/v2/cartridge');
-     */
-    copy(source: string, destination: string, overwrite?: boolean): Promise<void>;
-    /**
-     * Moves (renames) a file or directory.
-     *
-     * @param source - Source path relative to /webdav/Sites/
-     * @param destination - Destination path relative to /webdav/Sites/
-     * @param overwrite - Whether to overwrite if destination exists (default: true)
-     *
-     * @example
-     * await client.move('Cartridges/v1/old-name', 'Cartridges/v1/new-name');
-     */
-    move(source: string, destination: string, overwrite?: boolean): Promise<void>;
-    /**
-     * Checks if a path exists.
-     *
-     * @param path - Path to check
-     * @returns true if exists, false otherwise
-     */
-    exists(path: string): Promise<boolean>;
-    /**
-     * Parses PROPFIND XML response into structured entries using xml2js.
-     */
-    private parsePropfindResponse;
-    /**
-     * Extracts text content from an xml2js parsed value.
-     * Handles both string values and objects with '_' text content.
-     */
-    private getXmlText;
-}