@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/clients/webdav.js

@@ -1,395 +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
- */
-/**
- * WebDAV client for B2C Commerce file operations.
- *
- * Provides typed methods for common WebDAV operations like file upload,
- * download, directory creation, and listing.
- *
- * @module clients/webdav
- */
-import { parseStringPromise } from 'xml2js';
-import { HTTPError } from '../errors/http-error.js';
-import { getLogger } from '../logging/logger.js';
-import { globalMiddlewareRegistry } from './middleware-registry.js';
-export class WebDavClient {
-    auth;
-    baseUrl;
-    middlewareRegistry;
-    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, auth, options) {
-        this.auth = auth;
-        this.baseUrl = `https://${hostname}/on/demandware.servlet/webdav/Sites`;
-        this.middlewareRegistry = options?.middlewareRegistry ?? globalMiddlewareRegistry;
-        this.dispatcher = options?.dispatcher;
-    }
-    /**
-     * Builds the full URL for a WebDAV path.
-     *
-     * @param path - Path relative to /webdav/Sites/
-     * @returns Full URL
-     */
-    buildUrl(path) {
-        const cleanPath = path.startsWith('/') ? path.slice(1) : path;
-        return `${this.baseUrl}/${cleanPath}`;
-    }
-    /**
-     * Collects middleware from the registry for WebDAV client.
-     */
-    getMiddleware() {
-        return this.middlewareRegistry.getMiddleware('webdav');
-    }
-    /**
-     * Makes a raw WebDAV request.
-     *
-     * @param path - Path relative to /webdav/Sites/
-     * @param init - Fetch init options
-     * @returns Response from the server
-     */
-    async request(path, init) {
-        const logger = getLogger();
-        const url = this.buildUrl(path);
-        // Build initial request object
-        let request = new Request(url, init);
-        // Apply onRequest middleware (in registration order)
-        // We construct a compatible params object for openapi-fetch middleware
-        const middleware = this.getMiddleware();
-        const middlewareParams = {
-            request,
-            schemaPath: path,
-            // Minimal compatibility fields for openapi-fetch middleware
-            options: { baseUrl: this.baseUrl },
-            params: {},
-            id: 'webdav',
-        };
-        for (const m of middleware) {
-            if (m.onRequest) {
-                // openapi-fetch's MiddlewareCallbackParams has many internal fields we
-                // don't reproduce here; the cast is intentional and tightening the type
-                // would require pulling those into our own contract.
-                // @ts-expect-error — see comment above
-                const result = await m.onRequest(middlewareParams);
-                if (result instanceof Request) {
-                    request = result;
-                    middlewareParams.request = request;
-                }
-            }
-        }
-        // Debug: Log request start
-        logger.debug({ method: request.method, url: request.url }, `[WebDAV REQ] ${request.method} ${request.url}`);
-        // Trace: Log request details
-        logger.trace({
-            method: request.method,
-            url: request.url,
-            headers: this.headersToObject(request.headers),
-            body: this.formatBody(init?.body),
-        }, `[WebDAV REQ BODY] ${request.method} ${request.url}`);
-        const startTime = Date.now();
-        // Use auth.fetch with the (potentially modified) request
-        // Pass dispatcher for TLS/mTLS support
-        let response = await this.auth.fetch(request.url, {
-            method: request.method,
-            headers: request.headers,
-            body: init?.body, // Use original body since Request body may have been consumed
-            dispatcher: this.dispatcher,
-        });
-        const duration = Date.now() - startTime;
-        // Apply onResponse middleware (in registration order)
-        const responseParams = {
-            ...middlewareParams,
-            request,
-            response,
-        };
-        for (const m of middleware) {
-            if (m.onResponse) {
-                // See note on the onRequest cast above; same rationale applies.
-                // @ts-expect-error — partial reimplementation of openapi-fetch's MiddlewareCallbackParams
-                const result = await m.onResponse(responseParams);
-                if (result instanceof Response) {
-                    response = result;
-                    responseParams.response = response;
-                }
-            }
-        }
-        // Debug: Log response summary
-        logger.debug({ method: request.method, url: request.url, status: response.status, duration }, `[WebDAV RESP] ${request.method} ${request.url} ${response.status} ${duration}ms`);
-        // Trace: Log response details
-        const responseHeaders = this.headersToObject(response.headers);
-        let responseBody;
-        if (response.headers.get('content-type')?.includes('xml')) {
-            const clonedResponse = response.clone();
-            responseBody = await clonedResponse.text();
-        }
-        logger.trace({ method: request.method, url: request.url, headers: responseHeaders, body: responseBody }, `[WebDAV RESP BODY] ${request.method} ${request.url}`);
-        return response;
-    }
-    /**
-     * Converts Headers to a plain object for logging.
-     */
-    headersToObject(headers) {
-        if (!headers)
-            return undefined;
-        const result = {};
-        if (headers instanceof Headers) {
-            headers.forEach((value, key) => {
-                result[key] = value;
-            });
-        }
-        else if (Array.isArray(headers)) {
-            for (const [key, value] of headers) {
-                result[key] = value;
-            }
-        }
-        else {
-            Object.assign(result, headers);
-        }
-        return result;
-    }
-    /**
-     * Formats body for logging, describing binary data.
-     */
-    formatBody(body) {
-        if (!body)
-            return undefined;
-        if (typeof body === 'string') {
-            return body;
-        }
-        if (body instanceof Buffer || body instanceof ArrayBuffer) {
-            return `[Binary: ${body instanceof Buffer ? body.length : body.byteLength} bytes]`;
-        }
-        if (body instanceof Blob) {
-            return `[Blob: ${body.size} bytes]`;
-        }
-        return '[Body]';
-    }
-    /**
-     * 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');
-     */
-    async mkcol(path) {
-        const response = await this.request(path, { method: 'MKCOL' });
-        // 201 = created, 405 = already exists (acceptable)
-        if (!response.ok && response.status !== 405) {
-            throw new HTTPError(`MKCOL failed: ${response.status} ${response.statusText}`, response, 'MKCOL');
-        }
-    }
-    /**
-     * 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');
-     */
-    async put(path, content, contentType) {
-        const headers = {};
-        if (contentType) {
-            headers['Content-Type'] = contentType;
-        }
-        const response = await this.request(path, { method: 'PUT', headers, body: content });
-        if (!response.ok) {
-            const hints = {
-                413: '(sandbox may be stopped or unavailable)',
-            };
-            const hint = hints[response.status];
-            throw new HTTPError(`PUT failed: ${response.status} ${response.statusText}${hint ? ` ${hint}` : ''}`, response, 'PUT');
-        }
-    }
-    /**
-     * Downloads a file.
-     *
-     * @param path - Path to download
-     * @returns File content as ArrayBuffer
-     *
-     * @example
-     * const content = await client.get('Cartridges/v1/app.zip');
-     */
-    async get(path) {
-        const response = await this.request(path, { method: 'GET' });
-        if (!response.ok) {
-            throw new HTTPError(`GET failed: ${response.status} ${response.statusText}`, response, 'GET');
-        }
-        return response.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');
-     */
-    async delete(path) {
-        const response = await this.request(path, { method: 'DELETE' });
-        if (!response.ok) {
-            throw new HTTPError(`DELETE failed: ${response.status} ${response.statusText}`, response, 'DELETE');
-        }
-    }
-    /**
-     * 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);
-     * }
-     */
-    async propfind(path, depth = '1') {
-        const response = await this.request(path, {
-            method: 'PROPFIND',
-            headers: {
-                Depth: depth,
-                'Content-Type': 'application/xml',
-            },
-            body: `<?xml version="1.0" encoding="utf-8"?>
-<D:propfind xmlns:D="DAV:">
-  <D:prop>
-    <D:displayname/>
-    <D:resourcetype/>
-    <D:getcontentlength/>
-    <D:getlastmodified/>
-    <D:getcontenttype/>
-  </D:prop>
-</D:propfind>`,
-        });
-        if (!response.ok) {
-            throw new HTTPError(`PROPFIND failed: ${response.status} ${response.statusText}`, response, 'PROPFIND');
-        }
-        const xml = await response.text();
-        return await this.parsePropfindResponse(xml);
-    }
-    /**
-     * 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');
-     */
-    async copy(source, destination, overwrite = true) {
-        const destUrl = this.buildUrl(destination);
-        const response = await this.request(source, {
-            method: 'COPY',
-            headers: {
-                Destination: new URL(destUrl).pathname,
-                Overwrite: overwrite ? 'T' : 'F',
-            },
-        });
-        if (!response.ok) {
-            throw new HTTPError(`COPY failed: ${response.status} ${response.statusText}`, response, 'COPY');
-        }
-    }
-    /**
-     * 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');
-     */
-    async move(source, destination, overwrite = true) {
-        const destUrl = this.buildUrl(destination);
-        const response = await this.request(source, {
-            method: 'MOVE',
-            headers: {
-                Destination: new URL(destUrl).pathname,
-                Overwrite: overwrite ? 'T' : 'F',
-            },
-        });
-        if (!response.ok) {
-            throw new HTTPError(`MOVE failed: ${response.status} ${response.statusText}`, response, 'MOVE');
-        }
-    }
-    /**
-     * Checks if a path exists.
-     *
-     * @param path - Path to check
-     * @returns true if exists, false otherwise
-     */
-    async exists(path) {
-        const response = await this.request(path, { method: 'HEAD' });
-        return response.ok;
-    }
-    /**
-     * Parses PROPFIND XML response into structured entries using xml2js.
-     */
-    async parsePropfindResponse(xml) {
-        const entries = [];
-        // Parse with xml2js, stripping namespace prefixes for easier access
-        const result = await parseStringPromise(xml, {
-            tagNameProcessors: [(name) => name.replace(/^[^:]+:/, '')], // Strip namespace prefix
-            explicitArray: false,
-        });
-        // Get the multistatus root - may be 'multistatus' or 'D:multistatus' after processing
-        const multistatus = result.multistatus;
-        if (!multistatus) {
-            return entries;
-        }
-        // Get response array - may be single object or array
-        const responses = Array.isArray(multistatus.response) ? multistatus.response : [multistatus.response];
-        for (const response of responses) {
-            if (!response)
-                continue;
-            const href = this.getXmlText(response.href) || '';
-            const propstat = response.propstat;
-            const prop = propstat?.prop;
-            if (!prop)
-                continue;
-            const displayName = this.getXmlText(prop.displayname);
-            const isCollection = prop.resourcetype?.collection !== undefined;
-            const contentLength = this.getXmlText(prop.getcontentlength);
-            const lastModified = this.getXmlText(prop.getlastmodified);
-            const contentType = this.getXmlText(prop.getcontenttype);
-            entries.push({
-                href,
-                displayName,
-                isCollection,
-                contentLength: contentLength ? parseInt(contentLength, 10) : undefined,
-                lastModified: lastModified ? new Date(lastModified) : undefined,
-                contentType: contentType && contentType !== 'null' ? contentType : undefined,
-            });
-        }
-        return entries;
-    }
-    /**
-     * Extracts text content from an xml2js parsed value.
-     * Handles both string values and objects with '_' text content.
-     */
-    getXmlText(value) {
-        if (value === undefined || value === null)
-            return undefined;
-        if (typeof value === 'string')
-            return value || undefined;
-        if (typeof value === 'object' && '_' in value) {
-            return value._ || undefined;
-        }
-        return undefined;
-    }
-}
-//# sourceMappingURL=webdav.js.map

package/dist/cjs/clients/webdav.js.map

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

package/dist/cjs/config/config-source-registry.d.ts

@@ -1,115 +0,0 @@
-/**
- * Config Source Registry for B2C SDK.
- *
- * Provides a global registry for {@link ConfigSource} instances that are
- * automatically included in configuration resolution via {@link resolveConfig}.
- *
- * ## SDK Usage
- *
- * ```typescript
- * import { globalConfigSourceRegistry, type ConfigSource } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const envSource: ConfigSource = {
- *   name: 'env-vars',
- *   load() {
- *     return {
- *       config: { hostname: process.env.SFCC_SERVER },
- *       location: 'environment',
- *     };
- *   },
- * };
- *
- * globalConfigSourceRegistry.register(envSource);
- * ```
- *
- * ## CLI Plugin Usage
- *
- * Plugins can provide config sources via the `b2c:config-sources` hook.
- * Sources are registered with this registry during command initialization.
- *
- * @module config/config-source-registry
- */
-import type { ConfigSource } from './types.js';
-/**
- * Registry for configuration sources.
- *
- * The registry collects {@link ConfigSource} instances and makes them available
- * to {@link resolveConfig}, which automatically includes globally registered
- * sources in every resolution. Sources are sorted by priority alongside
- * default and explicitly-passed sources.
- *
- * ## Usage Modes
- *
- * **SDK Mode**: Register sources directly via `register()`:
- * ```typescript
- * globalConfigSourceRegistry.register(mySource);
- * ```
- *
- * **CLI Mode**: Sources are collected via the `b2c:config-sources` hook
- * and registered during command initialization.
- */
-export declare class ConfigSourceRegistry {
-    private sources;
-    /**
-     * Registers a config source.
-     *
-     * Sources participate in priority sorting alongside default sources
-     * when {@link resolveConfig} is called. Set the source's `priority`
-     * property to control ordering (lower number = higher priority).
-     *
-     * @param source - The config source to register
-     */
-    register(source: ConfigSource): void;
-    /**
-     * Unregisters a config source by name.
-     *
-     * @param name - The name of the source to remove
-     * @returns true if a source was removed, false if not found
-     */
-    unregister(name: string): boolean;
-    /**
-     * Returns all registered sources.
-     *
-     * Returns a shallow copy to prevent external mutation of the registry.
-     *
-     * @returns Array of registered config sources
-     */
-    getSources(): ConfigSource[];
-    /**
-     * Clears all registered sources.
-     *
-     * Primarily useful for testing.
-     */
-    clear(): void;
-    /**
-     * Returns the number of registered sources.
-     */
-    get size(): number;
-    /**
-     * Returns the names of all registered sources.
-     */
-    getSourceNames(): string[];
-}
-/**
- * Global config source registry instance.
- *
- * This is the default registry used by {@link resolveConfig}. Register
- * config sources here to have them automatically included in configuration
- * resolution.
- *
- * @example
- * ```typescript
- * import { globalConfigSourceRegistry } from '@salesforce/b2c-tooling-sdk/config';
- *
- * globalConfigSourceRegistry.register({
- *   name: 'my-source',
- *   load(options) {
- *     return {
- *       config: { hostname: 'example.com' },
- *       location: 'my-source',
- *     };
- *   },
- * });
- * ```
- */
-export declare const globalConfigSourceRegistry: ConfigSourceRegistry;

package/dist/cjs/config/config-source-registry.js

@@ -1,103 +0,0 @@
-/**
- * Registry for configuration sources.
- *
- * The registry collects {@link ConfigSource} instances and makes them available
- * to {@link resolveConfig}, which automatically includes globally registered
- * sources in every resolution. Sources are sorted by priority alongside
- * default and explicitly-passed sources.
- *
- * ## Usage Modes
- *
- * **SDK Mode**: Register sources directly via `register()`:
- * ```typescript
- * globalConfigSourceRegistry.register(mySource);
- * ```
- *
- * **CLI Mode**: Sources are collected via the `b2c:config-sources` hook
- * and registered during command initialization.
- */
-export class ConfigSourceRegistry {
-    sources = [];
-    /**
-     * Registers a config source.
-     *
-     * Sources participate in priority sorting alongside default sources
-     * when {@link resolveConfig} is called. Set the source's `priority`
-     * property to control ordering (lower number = higher priority).
-     *
-     * @param source - The config source to register
-     */
-    register(source) {
-        if (this.sources.some((s) => s.name === source.name))
-            return;
-        this.sources.push(source);
-    }
-    /**
-     * Unregisters a config source by name.
-     *
-     * @param name - The name of the source to remove
-     * @returns true if a source was removed, false if not found
-     */
-    unregister(name) {
-        const index = this.sources.findIndex((s) => s.name === name);
-        if (index >= 0) {
-            this.sources.splice(index, 1);
-            return true;
-        }
-        return false;
-    }
-    /**
-     * Returns all registered sources.
-     *
-     * Returns a shallow copy to prevent external mutation of the registry.
-     *
-     * @returns Array of registered config sources
-     */
-    getSources() {
-        return [...this.sources];
-    }
-    /**
-     * Clears all registered sources.
-     *
-     * Primarily useful for testing.
-     */
-    clear() {
-        this.sources = [];
-    }
-    /**
-     * Returns the number of registered sources.
-     */
-    get size() {
-        return this.sources.length;
-    }
-    /**
-     * Returns the names of all registered sources.
-     */
-    getSourceNames() {
-        return this.sources.map((s) => s.name);
-    }
-}
-/**
- * Global config source registry instance.
- *
- * This is the default registry used by {@link resolveConfig}. Register
- * config sources here to have them automatically included in configuration
- * resolution.
- *
- * @example
- * ```typescript
- * import { globalConfigSourceRegistry } from '@salesforce/b2c-tooling-sdk/config';
- *
- * globalConfigSourceRegistry.register({
- *   name: 'my-source',
- *   load(options) {
- *     return {
- *       config: { hostname: 'example.com' },
- *       location: 'my-source',
- *     };
- *   },
- * });
- * ```
- */
-export const globalConfigSourceRegistry = new ConfigSourceRegistry();
-//# sourceMappingURL=config-source-registry.js.map

package/dist/cjs/config/config-source-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-source-registry.js","sourceRoot":"","sources":["../../../src/config/config-source-registry.ts"],"names":[],"mappings":"AAsCA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,oBAAoB;IACvB,OAAO,GAAmB,EAAE,CAAC;IAErC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAoB;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO;QAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC7D,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,oBAAoB,EAAE,CAAC"}