@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.1

package/dist/cjs/operations/code/deploy.d.ts

@@ -1,121 +0,0 @@
-import type { B2CInstance } from '../../instance/index.js';
-import { type CartridgeMapping, type FindCartridgesOptions } from './cartridges.js';
-/**
- * Options for deploying cartridges.
- */
-/** Progress info passed to the upload onProgress callback. */
-export interface UploadProgressInfo {
-    /** Current operation phase */
-    phase: 'archiving' | 'uploading' | 'unzipping' | 'cleanup';
-    /** Seconds elapsed since the current phase started */
-    elapsedSeconds: number;
-}
-/**
- * Options for upload progress reporting.
- */
-export interface UploadOptions {
-    /** Callback for progress updates. Called when a phase starts (elapsedSeconds=0) and periodically thereafter. */
-    onProgress?: (info: UploadProgressInfo) => void;
-}
-export interface DeployOptions extends FindCartridgesOptions {
-    /** Activate the code version after deploy */
-    activate?: boolean;
-    /** Reload (toggle activation to force reload) the code version after deploy */
-    reload?: boolean;
-    /** Delete existing cartridges before uploading */
-    delete?: boolean;
-    /** Callback for progress updates during long-running operations */
-    onProgress?: UploadOptions['onProgress'];
-}
-/**
- * Result of a cartridge deployment.
- */
-export interface DeployResult {
-    /** Cartridges that were deployed */
-    cartridges: CartridgeMapping[];
-    /** Code version deployed to */
-    codeVersion: string;
-    /** Whether the code version was activated after deploy */
-    activated: boolean;
-    /** Whether the code version was reloaded after deploy */
-    reloaded: boolean;
-}
-/**
- * Deletes cartridges from an instance via WebDAV.
- *
- * This is a low-level function that deletes cartridge directories
- * from the specified code version. Errors are silently ignored for
- * cartridges that don't exist.
- *
- * Requires `instance.config.codeVersion` to be set.
- *
- * @param instance - B2C instance to delete from
- * @param cartridges - Cartridge mappings to delete
- * @throws Error if code version not set
- *
- * @example
- * ```typescript
- * const cartridges = findCartridges('./cartridges');
- * await deleteCartridges(instance, cartridges);
- * ```
- */
-export declare function deleteCartridges(instance: B2CInstance, cartridges: CartridgeMapping[]): Promise<void>;
-/**
- * Uploads cartridges to an instance via WebDAV.
- *
- * This is a low-level upload function that:
- * 1. Creates a zip archive of the cartridges
- * 2. Uploads it to WebDAV
- * 3. Unzips on the server
- * 4. Cleans up the temporary zip file
- *
- * Requires `instance.config.codeVersion` to be set.
- *
- * @param instance - B2C instance to upload to
- * @param cartridges - Cartridge mappings to upload
- * @throws Error if code version not set or upload fails
- *
- * @example
- * ```typescript
- * const cartridges = findCartridges('./cartridges');
- * await uploadCartridges(instance, cartridges);
- * ```
- */
-export declare function uploadCartridges(instance: B2CInstance, cartridges: CartridgeMapping[], options?: UploadOptions): Promise<void>;
-/**
- * Finds and deploys cartridges from a directory to an instance.
- *
- * This is a high-level function that orchestrates the deployment process:
- * 1. Finds cartridges in the specified directory (by .project files)
- * 2. Applies include/exclude filters
- * 3. Optionally deletes existing cartridges first
- * 4. Creates a zip archive and uploads via WebDAV
- * 5. Optionally reloads the code version
- *
- * Requires `instance.config.codeVersion` to be set.
- *
- * @param instance - B2C instance to deploy to (must have codeVersion set)
- * @param directory - Directory to search for cartridges
- * @param options - Deploy options (filters, reload, delete)
- * @returns Deploy result with cartridges and status
- * @throws Error if code version not set, no cartridges found, or deployment fails
- *
- * @example
- * ```typescript
- * // Simple deploy
- * const result = await findAndDeployCartridges(instance, './cartridges');
- *
- * // Deploy specific cartridges with reload
- * const result = await findAndDeployCartridges(instance, '.', {
- *   include: ['app_storefront_base'],
- *   reload: true,
- * });
- *
- * // Delete existing cartridges before upload
- * const result = await findAndDeployCartridges(instance, './cartridges', {
- *   delete: true,
- *   reload: true,
- * });
- * ```
- */
-export declare function findAndDeployCartridges(instance: B2CInstance, directory: string, options?: DeployOptions): Promise<DeployResult>;

package/dist/cjs/operations/code/deploy.js

@@ -1,255 +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
- */
-import path from 'node:path';
-import fs from 'node:fs';
-import JSZip from 'jszip';
-import { getLogger } from '../../logging/logger.js';
-import { findCartridges } from './cartridges.js';
-import { activateCodeVersion, reloadCodeVersion } from './versions.js';
-const UNZIP_BODY = new URLSearchParams({ method: 'UNZIP' }).toString();
-/**
- * Recursively adds a directory to a JSZip instance.
- */
-async function addDirectoryToZip(zip, dirPath, zipPath) {
-    const entries = await fs.promises.readdir(dirPath, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path.join(dirPath, entry.name);
-        const entryZipPath = path.join(zipPath, entry.name);
-        if (entry.isDirectory()) {
-            await addDirectoryToZip(zip, fullPath, entryZipPath);
-        }
-        else if (entry.isFile()) {
-            const content = await fs.promises.readFile(fullPath);
-            zip.file(entryZipPath, content);
-        }
-    }
-}
-/**
- * Deletes cartridges from an instance via WebDAV.
- *
- * This is a low-level function that deletes cartridge directories
- * from the specified code version. Errors are silently ignored for
- * cartridges that don't exist.
- *
- * Requires `instance.config.codeVersion` to be set.
- *
- * @param instance - B2C instance to delete from
- * @param cartridges - Cartridge mappings to delete
- * @throws Error if code version not set
- *
- * @example
- * ```typescript
- * const cartridges = findCartridges('./cartridges');
- * await deleteCartridges(instance, cartridges);
- * ```
- */
-export async function deleteCartridges(instance, cartridges) {
-    const logger = getLogger();
-    const codeVersion = instance.config.codeVersion;
-    if (!codeVersion) {
-        throw new Error('Code version required for cartridge deletion');
-    }
-    if (cartridges.length === 0) {
-        return;
-    }
-    const webdav = instance.webdav;
-    logger.debug({ count: cartridges.length }, `Deleting ${cartridges.length} cartridge(s)...`);
-    for (const c of cartridges) {
-        const cartridgePath = `Cartridges/${codeVersion}/${c.dest}`;
-        try {
-            await webdav.delete(cartridgePath);
-            logger.debug({ cartridgeName: c.dest, path: cartridgePath }, `Deleted ${cartridgePath}`);
-        }
-        catch {
-            // Ignore errors - cartridge may not exist
-            logger.debug({ cartridgeName: c.dest, path: cartridgePath }, `Could not delete ${cartridgePath} (may not exist)`);
-        }
-    }
-}
-/**
- * Uploads cartridges to an instance via WebDAV.
- *
- * This is a low-level upload function that:
- * 1. Creates a zip archive of the cartridges
- * 2. Uploads it to WebDAV
- * 3. Unzips on the server
- * 4. Cleans up the temporary zip file
- *
- * Requires `instance.config.codeVersion` to be set.
- *
- * @param instance - B2C instance to upload to
- * @param cartridges - Cartridge mappings to upload
- * @throws Error if code version not set or upload fails
- *
- * @example
- * ```typescript
- * const cartridges = findCartridges('./cartridges');
- * await uploadCartridges(instance, cartridges);
- * ```
- */
-export async function uploadCartridges(instance, cartridges, options) {
-    const logger = getLogger();
-    const codeVersion = instance.config.codeVersion;
-    if (!codeVersion) {
-        throw new Error('Code version required for cartridge upload');
-    }
-    if (cartridges.length === 0) {
-        throw new Error('No cartridges to upload');
-    }
-    const webdav = instance.webdav;
-    const now = Date.now();
-    const uploadPath = `Cartridges/_sync-${now}.zip`;
-    const onProgress = options?.onProgress;
-    // Progress helper: fires immediately (0s) then every 5s until stopped
-    const PROGRESS_INTERVAL_MS = 5_000;
-    function startProgress(phase) {
-        const start = Date.now();
-        onProgress?.({ phase, elapsedSeconds: 0 });
-        if (!onProgress)
-            return () => { };
-        const interval = setInterval(() => {
-            onProgress({ phase, elapsedSeconds: Math.round((Date.now() - start) / 1000) });
-        }, PROGRESS_INTERVAL_MS);
-        return () => clearInterval(interval);
-    }
-    // Create zip archive
-    onProgress?.({ phase: 'archiving', elapsedSeconds: 0 });
-    logger.debug('Creating cartridge archive...');
-    const zip = new JSZip();
-    for (const c of cartridges) {
-        await addDirectoryToZip(zip, c.src, path.join(codeVersion, c.dest));
-    }
-    const buffer = await zip.generateAsync({
-        type: 'nodebuffer',
-        compression: 'DEFLATE',
-        compressionOptions: { level: 9 },
-    });
-    logger.debug({ size: buffer.length }, `Archive created: ${buffer.length} bytes`);
-    // Upload archive
-    let stopProgress = startProgress('uploading');
-    logger.debug({ uploadPath }, 'Uploading archive...');
-    try {
-        await webdav.put(uploadPath, buffer, 'application/zip');
-    }
-    finally {
-        stopProgress();
-    }
-    logger.debug('Archive uploaded');
-    // Unzip on server
-    stopProgress = startProgress('unzipping');
-    logger.debug('Unzipping archive on server...');
-    let response;
-    try {
-        response = await webdav.request(uploadPath, {
-            method: 'POST',
-            body: UNZIP_BODY,
-            headers: {
-                'Content-Type': 'application/x-www-form-urlencoded',
-            },
-        });
-    }
-    finally {
-        stopProgress();
-    }
-    if (!response.ok) {
-        const text = await response.text();
-        throw new Error(`Failed to unzip archive: ${response.status} ${response.statusText} - ${text}`);
-    }
-    logger.debug('Archive unzipped');
-    // Delete temporary archive (best-effort cleanup)
-    onProgress?.({ phase: 'cleanup', elapsedSeconds: 0 });
-    try {
-        await webdav.delete(uploadPath);
-        logger.debug('Temporary archive deleted');
-    }
-    catch (error) {
-        // Log warning but don't fail deployment - the code is already deployed
-        logger.warn({ error, uploadPath }, 'Failed to clean up temporary archive (non-fatal)');
-    }
-    logger.debug({ server: instance.config.hostname, codeVersion, cartridgeCount: cartridges.length }, `Uploaded ${cartridges.length} cartridges to ${instance.config.hostname}`);
-}
-/**
- * Finds and deploys cartridges from a directory to an instance.
- *
- * This is a high-level function that orchestrates the deployment process:
- * 1. Finds cartridges in the specified directory (by .project files)
- * 2. Applies include/exclude filters
- * 3. Optionally deletes existing cartridges first
- * 4. Creates a zip archive and uploads via WebDAV
- * 5. Optionally reloads the code version
- *
- * Requires `instance.config.codeVersion` to be set.
- *
- * @param instance - B2C instance to deploy to (must have codeVersion set)
- * @param directory - Directory to search for cartridges
- * @param options - Deploy options (filters, reload, delete)
- * @returns Deploy result with cartridges and status
- * @throws Error if code version not set, no cartridges found, or deployment fails
- *
- * @example
- * ```typescript
- * // Simple deploy
- * const result = await findAndDeployCartridges(instance, './cartridges');
- *
- * // Deploy specific cartridges with reload
- * const result = await findAndDeployCartridges(instance, '.', {
- *   include: ['app_storefront_base'],
- *   reload: true,
- * });
- *
- * // Delete existing cartridges before upload
- * const result = await findAndDeployCartridges(instance, './cartridges', {
- *   delete: true,
- *   reload: true,
- * });
- * ```
- */
-export async function findAndDeployCartridges(instance, directory, options = {}) {
-    const logger = getLogger();
-    const codeVersion = instance.config.codeVersion;
-    if (!codeVersion) {
-        throw new Error('Code version required for deployment');
-    }
-    logger.debug({ directory }, 'Finding cartridges...');
-    const cartridges = findCartridges(directory, {
-        include: options.include,
-        exclude: options.exclude,
-    });
-    if (cartridges.length === 0) {
-        throw new Error(`No cartridges found in ${directory}`);
-    }
-    logger.debug({ count: cartridges.length }, `Found ${cartridges.length} cartridge(s)`);
-    for (const c of cartridges) {
-        logger.debug({ cartridgeName: c.name, path: c.src }, `  ${c.name}`);
-    }
-    // Optionally delete existing cartridges first
-    if (options.delete) {
-        await deleteCartridges(instance, cartridges);
-    }
-    // Upload cartridges
-    await uploadCartridges(instance, cartridges, { onProgress: options.onProgress });
-    // Optionally activate or reload
-    let activated = false;
-    let reloaded = false;
-    if (options.activate) {
-        logger.debug('Activating code version...');
-        await activateCodeVersion(instance, codeVersion);
-        activated = true;
-    }
-    else if (options.reload) {
-        logger.debug('Reloading code version...');
-        await reloadCodeVersion(instance, codeVersion);
-        activated = true;
-        reloaded = true;
-    }
-    return {
-        cartridges,
-        codeVersion,
-        activated,
-        reloaded,
-    };
-}
-//# sourceMappingURL=deploy.js.map

package/dist/cjs/operations/code/deploy.js.map

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

package/dist/cjs/operations/code/download.d.ts

@@ -1,77 +0,0 @@
-import type { B2CInstance } from '../../instance/index.js';
-/** Progress info passed to the onProgress callback. */
-export interface DownloadProgressInfo {
-    /** Current operation phase */
-    phase: 'zipping' | 'downloading' | 'cleanup' | 'extracting';
-    /** Seconds elapsed since the current phase started */
-    elapsedSeconds: number;
-}
-/**
- * Options for downloading cartridges.
- */
-export interface DownloadOptions {
-    /** Cartridge names to include (if empty/undefined, all are included) */
-    include?: string[];
-    /** Cartridge names to exclude */
-    exclude?: string[];
-    /** When provided, maps cartridge names to local paths for mirror extraction */
-    mirror?: Map<string, string>;
-    /** Callback for progress updates. Called when a phase starts (elapsedSeconds=0) and periodically thereafter. */
-    onProgress?: (info: DownloadProgressInfo) => void;
-}
-/**
- * Result of a cartridge download.
- */
-export interface DownloadResult {
-    /** Cartridge names that were extracted */
-    cartridges: string[];
-    /** Code version downloaded from */
-    codeVersion: string;
-    /** Output directory where cartridges were extracted (empty string if mirror-only) */
-    outputDirectory: string;
-}
-/**
- * Downloads a single cartridge from an instance via WebDAV.
- *
- * This is more efficient than downloading the entire code version when only
- * one cartridge is needed, as it ZIPs only the cartridge subdirectory on the server.
- *
- * @param instance - B2C instance to download from
- * @param codeVersion - Code version containing the cartridge
- * @param cartridgeName - Name of the cartridge to download
- * @param outputPath - Local path to extract the cartridge into
- * @param onProgress - Optional progress callback
- */
-export declare function downloadSingleCartridge(instance: B2CInstance, codeVersion: string, cartridgeName: string, outputPath: string, onProgress?: (info: DownloadProgressInfo) => void): Promise<void>;
-/**
- * Downloads cartridges from an instance via WebDAV.
- *
- * When `include` specifies cartridges, each is downloaded individually using
- * per-cartridge server-side zipping for efficiency. When downloading all
- * cartridges (no include filter), the entire code version is zipped at once.
- *
- * If `instance.config.codeVersion` is not set, attempts to discover the active
- * code version via OCAPI. If that also fails, throws an error.
- *
- * @param instance - B2C instance to download from
- * @param outputDirectory - Directory to extract cartridges into
- * @param options - Download options (filters, mirror)
- * @returns Download result with cartridge names and metadata
- * @throws Error if code version cannot be determined or download fails
- *
- * @example
- * ```typescript
- * // Download all cartridges
- * const result = await downloadCartridges(instance, './output');
- *
- * // Download specific cartridges (efficient per-cartridge download)
- * const result = await downloadCartridges(instance, './output', {
- *   include: ['app_storefront_base'],
- * });
- *
- * // Mirror to local project locations
- * const mirror = new Map([['app_storefront_base', '/project/cartridges/app_storefront_base']]);
- * const result = await downloadCartridges(instance, '.', { mirror });
- * ```
- */
-export declare function downloadCartridges(instance: B2CInstance, outputDirectory: string, options?: DownloadOptions): Promise<DownloadResult>;