@salesforce/b2c-tooling-sdk 1.9.0 → 1.11.0

package/dist/cjs/index.js.map

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

package/dist/cjs/instance/index.d.ts

@@ -1,136 +0,0 @@
-/**
- * B2C Instance management.
- *
- * This module provides the {@link B2CInstance} class which represents a connection
- * to a specific B2C Commerce instance. It combines instance configuration with
- * authentication to provide typed API clients.
- *
- * ## Usage
- *
- * ### From configuration (recommended)
- *
- * Use {@link resolveConfig} to load configuration from dw.json and create an instance:
- *
- * ```typescript
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig({
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   clientSecret: process.env.SFCC_CLIENT_SECRET,
- * });
- *
- * const instance = config.createB2CInstance();
- *
- * // Use typed clients
- * await instance.webdav.put('Cartridges/v1/app.zip', content);
- * const { data } = await instance.ocapi.GET('/sites', {});
- * ```
- *
- * ### Direct construction
- *
- * ```typescript
- * const instance = new B2CInstance(
- *   { hostname: 'your-sandbox.demandware.net', codeVersion: 'v1' },
- *   { oauth: { clientId: '...', clientSecret: '...' } }
- * );
- * ```
- *
- * @module instance
- */
-import type { AuthConfig } from '../auth/types.js';
-import { WebDavClient } from '../clients/webdav.js';
-import { type OcapiClient } from '../clients/ocapi.js';
-import { type TlsOptions } from '../clients/tls-dispatcher.js';
-/**
- * Instance configuration (hostname, code version, etc.)
- */
-export interface InstanceConfig {
-    /** B2C instance hostname */
-    hostname: string;
-    /** Code version for deployments */
-    codeVersion?: string;
-    /** Separate hostname for WebDAV (if different from main hostname) */
-    webdavHostname?: string;
-    /** TLS options for mTLS/self-signed certificate support */
-    tlsOptions?: TlsOptions;
-}
-/**
- * Represents a connection to a B2C Commerce instance.
- *
- * Provides lazy-loaded, typed API clients for WebDAV and OCAPI operations.
- * Authentication is handled automatically based on the configured credentials.
- *
- * @example
- * // From configuration (recommended)
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig({
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   clientSecret: process.env.SFCC_CLIENT_SECRET,
- * });
- * const instance = config.createB2CInstance();
- *
- * // WebDAV uses Basic auth if available, falls back to OAuth
- * await instance.webdav.mkcol('Cartridges/v1');
- *
- * // OCAPI always uses OAuth
- * const { data } = await instance.ocapi.GET('/sites', {});
- */
-export declare class B2CInstance {
-    readonly config: InstanceConfig;
-    readonly auth: AuthConfig;
-    private _webdav?;
-    private _ocapi?;
-    /**
-     * Creates a new B2CInstance.
-     *
-     * @param config - Instance configuration (hostname, code version)
-     * @param auth - Authentication configuration
-     */
-    constructor(config: InstanceConfig, auth: AuthConfig);
-    /**
-     * The hostname to use for WebDAV operations.
-     * Falls back to main hostname if not specified.
-     */
-    get webdavHostname(): string;
-    /**
-     * WebDAV client for file operations.
-     *
-     * Uses Basic auth if username/password are configured,
-     * otherwise falls back to OAuth.
-     *
-     * @example
-     * await instance.webdav.mkcol('Cartridges/v1');
-     * await instance.webdav.put('Cartridges/v1/app.zip', content);
-     * const entries = await instance.webdav.propfind('Cartridges');
-     */
-    get webdav(): WebDavClient;
-    /**
-     * OCAPI Data API client.
-     *
-     * Returns the openapi-fetch client directly with full type safety.
-     * Always uses OAuth authentication.
-     *
-     * @example
-     * const { data, error } = await instance.ocapi.GET('/sites', {});
-     * const { data, error } = await instance.ocapi.PATCH('/code_versions/{code_version_id}', {
-     *   params: { path: { code_version_id: 'v1' } },
-     *   body: { active: true }
-     * });
-     */
-    get ocapi(): OcapiClient;
-    /**
-     * Gets the auth strategy for WebDAV operations.
-     * Uses authMethods to determine priority, defaulting to basic then OAuth methods.
-     */
-    private getWebDavAuthStrategy;
-    /**
-     * Gets the OAuth auth strategy based on allowed methods and available credentials.
-     * Uses resolveAuthStrategy to automatically select the best OAuth method.
-     *
-     * @throws Error if no valid OAuth method is available
-     */
-    private getOAuthStrategy;
-}
-export type { AuthConfig };
-export type { TlsOptions };

package/dist/cjs/instance/index.js

@@ -1,131 +0,0 @@
-import { BasicAuthStrategy } from '../auth/basic.js';
-import { resolveAuthStrategy } from '../auth/resolve.js';
-import { WebDavClient } from '../clients/webdav.js';
-import { createOcapiClient } from '../clients/ocapi.js';
-import { createTlsDispatcher } from '../clients/tls-dispatcher.js';
-/**
- * Represents a connection to a B2C Commerce instance.
- *
- * Provides lazy-loaded, typed API clients for WebDAV and OCAPI operations.
- * Authentication is handled automatically based on the configured credentials.
- *
- * @example
- * // From configuration (recommended)
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig({
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   clientSecret: process.env.SFCC_CLIENT_SECRET,
- * });
- * const instance = config.createB2CInstance();
- *
- * // WebDAV uses Basic auth if available, falls back to OAuth
- * await instance.webdav.mkcol('Cartridges/v1');
- *
- * // OCAPI always uses OAuth
- * const { data } = await instance.ocapi.GET('/sites', {});
- */
-export class B2CInstance {
-    config;
-    auth;
-    _webdav;
-    _ocapi;
-    /**
-     * Creates a new B2CInstance.
-     *
-     * @param config - Instance configuration (hostname, code version)
-     * @param auth - Authentication configuration
-     */
-    constructor(config, auth) {
-        this.config = config;
-        this.auth = auth;
-    }
-    /**
-     * The hostname to use for WebDAV operations.
-     * Falls back to main hostname if not specified.
-     */
-    get webdavHostname() {
-        return this.config.webdavHostname || this.config.hostname;
-    }
-    /**
-     * WebDAV client for file operations.
-     *
-     * Uses Basic auth if username/password are configured,
-     * otherwise falls back to OAuth.
-     *
-     * @example
-     * await instance.webdav.mkcol('Cartridges/v1');
-     * await instance.webdav.put('Cartridges/v1/app.zip', content);
-     * const entries = await instance.webdav.propfind('Cartridges');
-     */
-    get webdav() {
-        if (!this._webdav) {
-            // Create TLS dispatcher if TLS options are configured
-            const dispatcher = this.config.tlsOptions ? createTlsDispatcher(this.config.tlsOptions) : undefined;
-            this._webdav = new WebDavClient(this.webdavHostname, this.getWebDavAuthStrategy(), {
-                dispatcher,
-            });
-        }
-        return this._webdav;
-    }
-    /**
-     * OCAPI Data API client.
-     *
-     * Returns the openapi-fetch client directly with full type safety.
-     * Always uses OAuth authentication.
-     *
-     * @example
-     * const { data, error } = await instance.ocapi.GET('/sites', {});
-     * const { data, error } = await instance.ocapi.PATCH('/code_versions/{code_version_id}', {
-     *   params: { path: { code_version_id: 'v1' } },
-     *   body: { active: true }
-     * });
-     */
-    get ocapi() {
-        if (!this._ocapi) {
-            this._ocapi = createOcapiClient(this.config.hostname, this.getOAuthStrategy());
-        }
-        return this._ocapi;
-    }
-    /**
-     * Gets the auth strategy for WebDAV operations.
-     * Uses authMethods to determine priority, defaulting to basic then OAuth methods.
-     */
-    getWebDavAuthStrategy() {
-        // For WebDAV, default priority is basic first, then OAuth methods
-        const webdavMethods = this.auth.authMethods || ['basic', 'client-credentials', 'implicit'];
-        // If basic auth is allowed and configured, use it directly
-        if (webdavMethods.includes('basic') && this.auth.basic) {
-            return new BasicAuthStrategy(this.auth.basic.username, this.auth.basic.password);
-        }
-        // Otherwise try OAuth methods
-        return this.getOAuthStrategy();
-    }
-    /**
-     * Gets the OAuth auth strategy based on allowed methods and available credentials.
-     * Uses resolveAuthStrategy to automatically select the best OAuth method.
-     *
-     * @throws Error if no valid OAuth method is available
-     */
-    getOAuthStrategy() {
-        if (!this.auth.oauth) {
-            throw new Error('OAuth credentials required. Provide at least clientId.');
-        }
-        // Build credentials for resolution
-        const credentials = {
-            clientId: this.auth.oauth.clientId,
-            clientSecret: this.auth.oauth.clientSecret,
-            scopes: this.auth.oauth.scopes,
-            accountManagerHost: this.auth.oauth.accountManagerHost,
-            redirectUri: this.auth.oauth.redirectUri,
-            openBrowser: this.auth.oauth.openBrowser,
-        };
-        // Filter to only OAuth methods (client-credentials, implicit)
-        const oauthMethods = (this.auth.authMethods || ['client-credentials', 'implicit']).filter((m) => m === 'client-credentials' || m === 'implicit');
-        if (oauthMethods.length === 0) {
-            throw new Error('No OAuth methods allowed. Check authMethods configuration.');
-        }
-        return resolveAuthStrategy(credentials, { allowedMethods: oauthMethods });
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/cjs/instance/index.js.map

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

package/dist/cjs/logging/index.d.ts

@@ -1,116 +0,0 @@
-/**
- * Structured logging module using [pino](https://github.com/pinojs/pino).
- *
- * This module provides a logging interface for library consumers. It does **not**
- * read environment variables directly—that is the responsibility of the CLI layer
- * or the consuming application.
- *
- * ## Basic Usage
- *
- * ```typescript
- * import { createLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * const logger = createLogger({ level: 'debug' });
- * logger.info('Hello world');
- * logger.debug({ file: 'data.json' }, 'Processing file');
- * ```
- *
- * ## Configuration Options
- *
- * | Option | Type | Default | Description |
- * |--------|------|---------|-------------|
- * | `level` | `LogLevel` | `'info'` | Minimum log level |
- * | `fd` | `number` | `2` | File descriptor (1=stdout, 2=stderr) |
- * | `json` | `boolean` | `false` | Output JSON lines instead of pretty print |
- * | `colorize` | `boolean` | `true` | Enable colors in pretty print mode |
- * | `redact` | `boolean` | `true` | Redact sensitive fields |
- * | `baseContext` | `object` | `{}` | Context included in all log entries |
- *
- * ## Output Modes
- *
- * **Pretty print** (default): Human-readable with colors
- * ```
- * [18:31:58] INFO: Hello world
- * ```
- *
- * **JSON lines** (`json: true`): Machine-readable for log aggregation
- * ```json
- * {"level":"info","time":1764113529411,"msg":"Hello world"}
- * ```
- *
- * ## Log Levels
- *
- * From most to least verbose: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent`
- *
- * ## Context and Child Loggers
- *
- * Add structured context to log entries:
- *
- * ```typescript
- * // Inline context
- * logger.info({ operation: 'deploy', file: 'app.zip' }, 'Starting deployment');
- *
- * // Child logger with bound context
- * const deployLogger = logger.child({ operation: 'deploy' });
- * deployLogger.info('Step 1 complete');  // Includes operation: 'deploy'
- * deployLogger.info('Step 2 complete');
- * ```
- *
- * ## Secret Redaction
- *
- * Sensitive fields are automatically redacted:
- *
- * ```typescript
- * logger.info({ username: 'admin', password: 'secret' }, 'Auth attempt');
- * // Output: { username: 'admin', password: '[REDACTED]' }
- * ```
- *
- * Redacted fields: `password`, `secret`, `token`, `client_secret`, `access_token`,
- * `refresh_token`, `api_key`, `authorization`
- *
- * ## Global Logger
- *
- * For CLI applications, use the global logger pattern:
- *
- * ```typescript
- * import { configureLogger, getLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * // Configure once at startup
- * configureLogger({
- *   level: 'debug',
- *   json: process.env.SFCC_JSON_LOGS === 'true',
- *   colorize: process.stdout.isTTY,
- * });
- *
- * // Get anywhere in your app
- * const logger = getLogger();
- * logger.info('Ready');
- * ```
- *
- * ## Library vs CLI Usage
- *
- * **Library code** should accept a logger as a parameter:
- *
- * ```typescript
- * import type { Logger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * export function myOperation(options: { logger?: Logger }) {
- *   const log = options.logger ?? console;
- *   log.info('Starting operation');
- * }
- * ```
- *
- * **CLI code** reads environment variables and passes the configured logger:
- *
- * ```typescript
- * const logger = createLogger({
- *   level: process.env.LOG_LEVEL ?? 'info',
- *   json: process.env.LOG_JSON === 'true',
- * });
- * myOperation({ logger });
- * ```
- *
- * @module logging
- */
-export type { Logger, LoggerOptions, LogLevel, LogContext, LogDestination } from './types.js';
-export { createLogger, configureLogger, getLogger, resetLogger, createSilentLogger } from './logger.js';

package/dist/cjs/logging/index.js

@@ -1,121 +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
- */
-/**
- * Structured logging module using [pino](https://github.com/pinojs/pino).
- *
- * This module provides a logging interface for library consumers. It does **not**
- * read environment variables directly—that is the responsibility of the CLI layer
- * or the consuming application.
- *
- * ## Basic Usage
- *
- * ```typescript
- * import { createLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * const logger = createLogger({ level: 'debug' });
- * logger.info('Hello world');
- * logger.debug({ file: 'data.json' }, 'Processing file');
- * ```
- *
- * ## Configuration Options
- *
- * | Option | Type | Default | Description |
- * |--------|------|---------|-------------|
- * | `level` | `LogLevel` | `'info'` | Minimum log level |
- * | `fd` | `number` | `2` | File descriptor (1=stdout, 2=stderr) |
- * | `json` | `boolean` | `false` | Output JSON lines instead of pretty print |
- * | `colorize` | `boolean` | `true` | Enable colors in pretty print mode |
- * | `redact` | `boolean` | `true` | Redact sensitive fields |
- * | `baseContext` | `object` | `{}` | Context included in all log entries |
- *
- * ## Output Modes
- *
- * **Pretty print** (default): Human-readable with colors
- * ```
- * [18:31:58] INFO: Hello world
- * ```
- *
- * **JSON lines** (`json: true`): Machine-readable for log aggregation
- * ```json
- * {"level":"info","time":1764113529411,"msg":"Hello world"}
- * ```
- *
- * ## Log Levels
- *
- * From most to least verbose: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent`
- *
- * ## Context and Child Loggers
- *
- * Add structured context to log entries:
- *
- * ```typescript
- * // Inline context
- * logger.info({ operation: 'deploy', file: 'app.zip' }, 'Starting deployment');
- *
- * // Child logger with bound context
- * const deployLogger = logger.child({ operation: 'deploy' });
- * deployLogger.info('Step 1 complete');  // Includes operation: 'deploy'
- * deployLogger.info('Step 2 complete');
- * ```
- *
- * ## Secret Redaction
- *
- * Sensitive fields are automatically redacted:
- *
- * ```typescript
- * logger.info({ username: 'admin', password: 'secret' }, 'Auth attempt');
- * // Output: { username: 'admin', password: '[REDACTED]' }
- * ```
- *
- * Redacted fields: `password`, `secret`, `token`, `client_secret`, `access_token`,
- * `refresh_token`, `api_key`, `authorization`
- *
- * ## Global Logger
- *
- * For CLI applications, use the global logger pattern:
- *
- * ```typescript
- * import { configureLogger, getLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * // Configure once at startup
- * configureLogger({
- *   level: 'debug',
- *   json: process.env.SFCC_JSON_LOGS === 'true',
- *   colorize: process.stdout.isTTY,
- * });
- *
- * // Get anywhere in your app
- * const logger = getLogger();
- * logger.info('Ready');
- * ```
- *
- * ## Library vs CLI Usage
- *
- * **Library code** should accept a logger as a parameter:
- *
- * ```typescript
- * import type { Logger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * export function myOperation(options: { logger?: Logger }) {
- *   const log = options.logger ?? console;
- *   log.info('Starting operation');
- * }
- * ```
- *
- * **CLI code** reads environment variables and passes the configured logger:
- *
- * ```typescript
- * const logger = createLogger({
- *   level: process.env.LOG_LEVEL ?? 'info',
- *   json: process.env.LOG_JSON === 'true',
- * });
- * myOperation({ logger });
- * ```
- *
- * @module logging
- */
-export { createLogger, configureLogger, getLogger, resetLogger, createSilentLogger } from './logger.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/logging/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiHG;AAGH,OAAO,EAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,aAAa,CAAC"}

package/dist/cjs/logging/logger.d.ts

@@ -1,9 +0,0 @@
-/**
- * Logger using pino with pretty printing by default.
- */
-import type { Logger, LoggerOptions } from './types.js';
-export declare function createLogger(options?: LoggerOptions): Logger;
-export declare function configureLogger(options: LoggerOptions): void;
-export declare function getLogger(): Logger;
-export declare function resetLogger(): void;
-export declare function createSilentLogger(): Logger;

package/dist/cjs/logging/logger.js

@@ -1,138 +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
- */
-/**
- * Logger using pino with pretty printing by default.
- */
-import { Writable } from 'node:stream';
-import pino from 'pino';
-import pretty from 'pino-pretty';
-const REDACT_FIELDS = [
-    'password',
-    'client_secret',
-    'clientSecret',
-    'access_token',
-    'accessToken',
-    'refresh_token',
-    'refreshToken',
-    'api_key',
-    'apiKey',
-    'token',
-    'secret',
-    'authorization',
-    'Authorization',
-];
-const REDACT_PATHS = REDACT_FIELDS.flatMap((field) => [field, `*.${field}`]);
-function censor(value, path) {
-    // Special handling for authorization headers
-    if (path[path.length - 1].toLowerCase() === 'authorization' && typeof value === 'string') {
-        const parts = value.split(' ');
-        if (parts.length === 2) {
-            const [scheme, credentials] = parts;
-            // For Basic auth, decode, redact password, and re-encode
-            if (scheme.toLowerCase() === 'basic') {
-                try {
-                    const decoded = Buffer.from(credentials, 'base64').toString('utf-8');
-                    const colonIndex = decoded.indexOf(':');
-                    if (colonIndex !== -1) {
-                        const username = decoded.slice(0, colonIndex);
-                        const redacted = Buffer.from(`${username}:REDACTED`).toString('base64');
-                        return `Basic ${redacted}`;
-                    }
-                }
-                catch {
-                    // If decoding fails, fall through to default behavior
-                }
-            }
-            // For other schemes (Bearer, etc.), show scheme and partial token
-            return `${scheme} ${credentials.slice(0, 6)}...REDACTED`;
-        }
-    }
-    if (typeof value === 'string' && value.length > 10) {
-        return `${value.slice(0, 4)}...REDACTED`;
-    }
-    return 'REDACTED';
-}
-/** Wrap a minimal LogDestination in a Node.js Writable so pino-pretty's transport pipeline works. */
-function toWritable(dest) {
-    if (dest instanceof Writable)
-        return dest;
-    return new Writable({
-        write(chunk, _encoding, callback) {
-            dest.write(chunk);
-            callback();
-        },
-    });
-}
-let globalLogger = null;
-let globalOptions = { level: 'silent' };
-function createPinoLogger(options) {
-    const level = options.level ?? 'info';
-    const fd = options.fd ?? 2; // Default to stderr
-    const colorize = options.colorize ?? true;
-    const pinoOptions = {
-        level,
-        base: options.baseContext ?? {},
-        formatters: {
-            level: (label) => ({ level: label }),
-        },
-    };
-    if (options.redact !== false) {
-        pinoOptions.redact = {
-            paths: REDACT_PATHS,
-            censor,
-        };
-    }
-    // Custom destination stream (for testing)
-    if (options.destination) {
-        if (options.json) {
-            return pino(pinoOptions, options.destination);
-        }
-        const isVerbose = level === 'debug' || level === 'trace';
-        const prettyStream = pretty({
-            destination: toWritable(options.destination),
-            sync: true,
-            colorize,
-            ignore: 'pid,hostname' + (isVerbose ? '' : ',time'),
-            hideObject: !isVerbose,
-        });
-        return pino(pinoOptions, prettyStream);
-    }
-    // JSON output
-    if (options.json) {
-        return pino(pinoOptions, pino.destination({ fd, sync: true }));
-    }
-    // Pretty print (default)
-    const isVerbose = level === 'debug' || level === 'trace';
-    const prettyStream = pretty({
-        destination: fd,
-        sync: true,
-        colorize,
-        ignore: 'pid,hostname' + (isVerbose ? '' : ',time'),
-        hideObject: !isVerbose,
-    });
-    return pino(pinoOptions, prettyStream);
-}
-export function createLogger(options = {}) {
-    return createPinoLogger({ ...globalOptions, ...options });
-}
-export function configureLogger(options) {
-    globalOptions = { ...globalOptions, ...options };
-    globalLogger = createPinoLogger(globalOptions);
-}
-export function getLogger() {
-    if (!globalLogger) {
-        globalLogger = createPinoLogger(globalOptions);
-    }
-    return globalLogger;
-}
-export function resetLogger() {
-    globalLogger = null;
-    globalOptions = { level: 'silent' };
-}
-export function createSilentLogger() {
-    return createLogger({ level: 'silent' });
-}
-//# sourceMappingURL=logger.js.map

package/dist/cjs/logging/logger.js.map

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