@salesforce/b2c-cli 0.0.5 → 0.0.8

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/index.d.ts

@@ -1,66 +0,0 @@
-/**
- * Code deployment operations for B2C Commerce.
- *
- * This module provides functions for managing cartridge code versions
- * on B2C Commerce instances via WebDAV and OCAPI.
- *
- * ## Cartridge Discovery
- *
- * - {@link findCartridges} - Find cartridges by .project files
- *
- * ## Code Versions
- *
- * - {@link listCodeVersions} - List all code versions on an instance
- * - {@link getActiveCodeVersion} - Get the currently active code version
- * - {@link activateCodeVersion} - Activate a code version
- * - {@link reloadCodeVersion} - Reload (re-activate) a code version
- * - {@link deleteCodeVersion} - Delete a code version
- * - {@link createCodeVersion} - Create a new code version
- *
- * ## Deployment
- *
- * - {@link findAndDeployCartridges} - Find and deploy cartridges to an instance
- * - {@link uploadCartridges} - Low-level cartridge upload
- * - {@link deleteCartridges} - Low-level cartridge deletion
- * - {@link watchCartridges} - Watch and sync file changes
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   findCartridges,
- *   findAndDeployCartridges,
- *   listCodeVersions,
- *   activateCodeVersion,
- *   watchCartridges,
- * } from '@salesforce/b2c-tooling-sdk/operations/code';
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig();
- * const instance = config.createB2CInstance();
- *
- * // Deploy cartridges (requires instance.config.codeVersion to be set)
- * await findAndDeployCartridges(instance, './cartridges', { reload: true });
- *
- * // List code versions
- * const versions = await listCodeVersions(instance);
- *
- * // Watch for changes
- * const watcher = await watchCartridges(instance, './cartridges');
- * ```
- *
- * ## Authentication
- *
- * - WebDAV operations support both Basic Auth and OAuth
- * - OCAPI operations (code versions) require OAuth
- *
- * @module operations/code
- */
-export { findCartridges } from './cartridges.js';
-export type { CartridgeMapping, FindCartridgesOptions } from './cartridges.js';
-export { listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, } from './versions.js';
-export type { CodeVersion, CodeVersionResult } from './versions.js';
-export { findAndDeployCartridges, uploadCartridges, deleteCartridges } from './deploy.js';
-export type { DeployOptions, DeployResult } from './deploy.js';
-export { watchCartridges } from './watch.js';
-export type { WatchOptions, WatchResult } from './watch.js';

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/index.js

@@ -1,72 +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
- */
-/**
- * Code deployment operations for B2C Commerce.
- *
- * This module provides functions for managing cartridge code versions
- * on B2C Commerce instances via WebDAV and OCAPI.
- *
- * ## Cartridge Discovery
- *
- * - {@link findCartridges} - Find cartridges by .project files
- *
- * ## Code Versions
- *
- * - {@link listCodeVersions} - List all code versions on an instance
- * - {@link getActiveCodeVersion} - Get the currently active code version
- * - {@link activateCodeVersion} - Activate a code version
- * - {@link reloadCodeVersion} - Reload (re-activate) a code version
- * - {@link deleteCodeVersion} - Delete a code version
- * - {@link createCodeVersion} - Create a new code version
- *
- * ## Deployment
- *
- * - {@link findAndDeployCartridges} - Find and deploy cartridges to an instance
- * - {@link uploadCartridges} - Low-level cartridge upload
- * - {@link deleteCartridges} - Low-level cartridge deletion
- * - {@link watchCartridges} - Watch and sync file changes
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   findCartridges,
- *   findAndDeployCartridges,
- *   listCodeVersions,
- *   activateCodeVersion,
- *   watchCartridges,
- * } from '@salesforce/b2c-tooling-sdk/operations/code';
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig();
- * const instance = config.createB2CInstance();
- *
- * // Deploy cartridges (requires instance.config.codeVersion to be set)
- * await findAndDeployCartridges(instance, './cartridges', { reload: true });
- *
- * // List code versions
- * const versions = await listCodeVersions(instance);
- *
- * // Watch for changes
- * const watcher = await watchCartridges(instance, './cartridges');
- * ```
- *
- * ## Authentication
- *
- * - WebDAV operations support both Basic Auth and OAuth
- * - OCAPI operations (code versions) require OAuth
- *
- * @module operations/code
- */
-// Cartridge discovery
-export { findCartridges } from './cartridges.js';
-// Code version management
-export { listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, } from './versions.js';
-// Deployment
-export { findAndDeployCartridges, uploadCartridges, deleteCartridges } from './deploy.js';
-// Watch
-export { watchCartridges } from './watch.js';
-//# sourceMappingURL=index.js.map

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/code/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,sBAAsB;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAG/C,0BAA0B;AAC1B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,aAAa;AACb,OAAO,EAAC,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAGxF,QAAQ;AACR,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC"}

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/versions.d.ts

@@ -1,99 +0,0 @@
-import type { B2CInstance } from '../../instance/index.js';
-import { type OcapiComponents } from '../../clients/index.js';
-/** Code version type from OCAPI */
-export type CodeVersion = OcapiComponents['schemas']['code_version'];
-/** Result of listing code versions */
-export type CodeVersionResult = OcapiComponents['schemas']['code_version_result'];
-/**
- * Lists all code versions on an instance.
- *
- * @param instance - B2C instance to query
- * @returns Array of code versions
- * @throws Error if the request fails
- *
- * @example
- * ```typescript
- * const versions = await listCodeVersions(instance);
- * for (const v of versions) {
- *   console.log(v.id, v.active ? '(active)' : '');
- * }
- * ```
- */
-export declare function listCodeVersions(instance: B2CInstance): Promise<CodeVersion[]>;
-/**
- * Gets the currently active code version.
- *
- * @param instance - B2C instance to query
- * @returns The active code version, or undefined if none is active
- *
- * @example
- * ```typescript
- * const active = await getActiveCodeVersion(instance);
- * if (active) {
- *   console.log(`Active version: ${active.id}`);
- * }
- * ```
- */
-export declare function getActiveCodeVersion(instance: B2CInstance): Promise<CodeVersion | undefined>;
-/**
- * Activates a code version on an instance.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version ID to activate
- * @throws Error if activation fails
- *
- * @example
- * ```typescript
- * await activateCodeVersion(instance, 'v2');
- * console.log('Code version v2 is now active');
- * ```
- */
-export declare function activateCodeVersion(instance: B2CInstance, codeVersionId: string): Promise<void>;
-/**
- * Reloads (re-activates) the current code version.
- *
- * This performs a "toggle" activation - first activating a different code version,
- * then re-activating the target version. This forces the instance to reload the code.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version to reload (defaults to current active)
- * @throws Error if reload fails or no alternate version is available
- *
- * @example
- * ```typescript
- * // Reload the currently active code version
- * await reloadCodeVersion(instance);
- *
- * // Reload a specific code version
- * await reloadCodeVersion(instance, 'v1');
- * ```
- */
-export declare function reloadCodeVersion(instance: B2CInstance, codeVersionId?: string): Promise<void>;
-/**
- * Deletes a code version from an instance.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version ID to delete
- * @throws Error if deletion fails (e.g., trying to delete active version)
- *
- * @example
- * ```typescript
- * await deleteCodeVersion(instance, 'old-version');
- * console.log('Code version deleted');
- * ```
- */
-export declare function deleteCodeVersion(instance: B2CInstance, codeVersionId: string): Promise<void>;
-/**
- * Creates a new code version on an instance.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version ID to create
- * @throws Error if creation fails
- *
- * @example
- * ```typescript
- * await createCodeVersion(instance, 'v3');
- * console.log('Code version v3 created');
- * ```
- */
-export declare function createCodeVersion(instance: B2CInstance, codeVersionId: string): Promise<void>;

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/versions.js

@@ -1,157 +0,0 @@
-import {} from '../../clients/index.js';
-import { getLogger } from '../../logging/logger.js';
-/**
- * Lists all code versions on an instance.
- *
- * @param instance - B2C instance to query
- * @returns Array of code versions
- * @throws Error if the request fails
- *
- * @example
- * ```typescript
- * const versions = await listCodeVersions(instance);
- * for (const v of versions) {
- *   console.log(v.id, v.active ? '(active)' : '');
- * }
- * ```
- */
-export async function listCodeVersions(instance) {
-    const { data, error } = await instance.ocapi.GET('/code_versions', {});
-    if (error) {
-        throw new Error('Failed to list code versions', { cause: error });
-    }
-    return data.data ?? [];
-}
-/**
- * Gets the currently active code version.
- *
- * @param instance - B2C instance to query
- * @returns The active code version, or undefined if none is active
- *
- * @example
- * ```typescript
- * const active = await getActiveCodeVersion(instance);
- * if (active) {
- *   console.log(`Active version: ${active.id}`);
- * }
- * ```
- */
-export async function getActiveCodeVersion(instance) {
-    const versions = await listCodeVersions(instance);
-    return versions.find((v) => v.active);
-}
-/**
- * Activates a code version on an instance.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version ID to activate
- * @throws Error if activation fails
- *
- * @example
- * ```typescript
- * await activateCodeVersion(instance, 'v2');
- * console.log('Code version v2 is now active');
- * ```
- */
-export async function activateCodeVersion(instance, codeVersionId) {
-    const logger = getLogger();
-    logger.debug({ codeVersionId }, `Activating code version ${codeVersionId}`);
-    const { error } = await instance.ocapi.PATCH('/code_versions/{code_version_id}', {
-        params: { path: { code_version_id: codeVersionId } },
-        body: { active: true },
-    });
-    if (error) {
-        throw new Error('Failed to activate code version', { cause: error });
-    }
-    logger.debug({ codeVersionId }, `Code version ${codeVersionId} activated`);
-}
-/**
- * Reloads (re-activates) the current code version.
- *
- * This performs a "toggle" activation - first activating a different code version,
- * then re-activating the target version. This forces the instance to reload the code.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version to reload (defaults to current active)
- * @throws Error if reload fails or no alternate version is available
- *
- * @example
- * ```typescript
- * // Reload the currently active code version
- * await reloadCodeVersion(instance);
- *
- * // Reload a specific code version
- * await reloadCodeVersion(instance, 'v1');
- * ```
- */
-export async function reloadCodeVersion(instance, codeVersionId) {
-    const logger = getLogger();
-    const versions = await listCodeVersions(instance);
-    const activeVersion = versions.find((v) => v.active);
-    const targetVersion = codeVersionId ?? activeVersion?.id;
-    if (!targetVersion) {
-        throw new Error('No code version specified and no active version found');
-    }
-    logger.debug({ codeVersionId: targetVersion }, `Reloading code version ${targetVersion}`);
-    // If the target is already active, we need to toggle to another version first
-    if (activeVersion?.id === targetVersion) {
-        const alternateVersion = versions.find((v) => v.id !== targetVersion);
-        if (!alternateVersion) {
-            throw new Error('Cannot reload: no alternate code version available for toggle');
-        }
-        logger.debug({ codeVersionId: alternateVersion.id }, `Temporarily activating ${alternateVersion.id}`);
-        await activateCodeVersion(instance, alternateVersion.id);
-    }
-    // Now activate the target version
-    await activateCodeVersion(instance, targetVersion);
-    logger.debug({ codeVersionId: targetVersion }, `Code version ${targetVersion} reloaded`);
-}
-/**
- * Deletes a code version from an instance.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version ID to delete
- * @throws Error if deletion fails (e.g., trying to delete active version)
- *
- * @example
- * ```typescript
- * await deleteCodeVersion(instance, 'old-version');
- * console.log('Code version deleted');
- * ```
- */
-export async function deleteCodeVersion(instance, codeVersionId) {
-    const logger = getLogger();
-    logger.debug({ codeVersionId }, `Deleting code version ${codeVersionId}`);
-    const { error } = await instance.ocapi.DELETE('/code_versions/{code_version_id}', {
-        params: { path: { code_version_id: codeVersionId } },
-    });
-    if (error) {
-        throw new Error('Failed to delete code version', { cause: error });
-    }
-    logger.debug({ codeVersionId }, `Code version ${codeVersionId} deleted`);
-}
-/**
- * Creates a new code version on an instance.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version ID to create
- * @throws Error if creation fails
- *
- * @example
- * ```typescript
- * await createCodeVersion(instance, 'v3');
- * console.log('Code version v3 created');
- * ```
- */
-export async function createCodeVersion(instance, codeVersionId) {
-    const logger = getLogger();
-    logger.debug({ codeVersionId }, `Creating code version ${codeVersionId}`);
-    const { error } = await instance.ocapi.PUT('/code_versions/{code_version_id}', {
-        params: { path: { code_version_id: codeVersionId } },
-    });
-    if (error) {
-        throw new Error('Failed to create code version', { cause: error });
-    }
-    logger.debug({ codeVersionId }, `Code version ${codeVersionId} created`);
-}
-//# sourceMappingURL=versions.js.map

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/versions.js.map

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

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/code/watch.d.ts

@@ -1,58 +0,0 @@
-import { type FSWatcher } from 'chokidar';
-import type { B2CInstance } from '../../instance/index.js';
-import { type CartridgeMapping, type FindCartridgesOptions } from './cartridges.js';
-/**
- * Options for watching cartridges.
- */
-export interface WatchOptions extends FindCartridgesOptions {
-    /** Debounce time in ms for batching file changes */
-    debounceTime?: number;
-    /** Callback when files are uploaded */
-    onUpload?: (files: string[]) => void;
-    /** Callback when files are deleted */
-    onDelete?: (files: string[]) => void;
-    /** Callback on error */
-    onError?: (error: Error) => void;
-}
-/**
- * Result of starting a watcher.
- */
-export interface WatchResult {
-    /** The chokidar watcher instance */
-    watcher: FSWatcher;
-    /** Cartridges being watched */
-    cartridges: CartridgeMapping[];
-    /** Code version being deployed to */
-    codeVersion: string;
-    /** Stop watching */
-    stop: () => Promise<void>;
-}
-/**
- * Watches cartridge directories and syncs changes to an instance.
- *
- * This function:
- * 1. Finds cartridges in the specified directory
- * 2. Sets up file watchers on those directories
- * 3. Batches file changes and uploads them via WebDAV
- * 4. Handles file deletions
- *
- * The watcher uses debouncing to batch rapid changes into single uploads.
- *
- * @param instance - B2C instance to sync to
- * @param directory - Directory containing cartridges
- * @param options - Watch options (filters, callbacks, debounce)
- * @returns Watch result with control methods
- * @throws Error if no cartridges found or watch setup fails
- *
- * @example
- * ```typescript
- * const result = await watchCartridges(instance, './cartridges', {
- *   onUpload: (files) => console.log('Uploaded:', files),
- *   onError: (error) => console.error('Error:', error),
- * });
- *
- * // Later, to stop watching:
- * await result.stop();
- * ```
- */
-export declare function watchCartridges(instance: B2CInstance, directory: string, options?: WatchOptions): Promise<WatchResult>;