@salesforce/b2c-tooling-sdk 1.9.0 → 1.11.0

package/dist/cjs/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/dist/cjs/operations/code/versions.js

@@ -1,156 +0,0 @@
-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/dist/cjs/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/dist/cjs/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>;

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

@@ -1,175 +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 { watch } from 'chokidar';
-import { getLogger } from '../../logging/logger.js';
-import { findCartridges } from './cartridges.js';
-import { fileToCartridgePath, uploadFiles } from './upload-files.js';
-import { getActiveCodeVersion } from './versions.js';
-/** Default debounce time in ms for batching file uploads */
-const DEFAULT_DEBOUNCE_TIME = parseInt(process.env.SFCC_UPLOAD_DEBOUNCE_TIME ?? '100', 10);
-/**
- * Creates a debounced function that batches calls.
- */
-function debounce(fn, delay) {
-    let timer = null;
-    return (() => {
-        if (timer) {
-            clearTimeout(timer);
-        }
-        timer = setTimeout(() => {
-            timer = null;
-            fn();
-        }, delay);
-    });
-}
-/**
- * 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 async function watchCartridges(instance, directory, options = {}) {
-    const logger = getLogger();
-    let codeVersion = instance.config.codeVersion;
-    const debounceTime = options.debounceTime ?? DEFAULT_DEBOUNCE_TIME;
-    // If no code version specified, get the active one
-    if (!codeVersion) {
-        logger.debug('No code version specified, getting active version...');
-        const active = await getActiveCodeVersion(instance);
-        if (!active?.id) {
-            throw new Error('No code version specified and no active code version found');
-        }
-        codeVersion = active.id;
-        instance.config.codeVersion = codeVersion;
-    }
-    logger.debug({ directory }, 'Finding cartridges to watch...');
-    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 }, `Watching ${cartridges.length} cartridge(s)`);
-    for (const c of cartridges) {
-        logger.info({ cartridgeName: c.name, path: c.src }, `  ${c.name}`);
-    }
-    // Re-bind as const so TypeScript knows it's a string inside closures
-    const resolvedCodeVersion = codeVersion;
-    const cwd = process.cwd();
-    // Sets for batching file changes
-    const filesToUpload = new Set();
-    const filesToDelete = new Set();
-    let lastErrorTime = 0;
-    let isProcessing = false;
-    /**
-     * Processes all pending file changes, serializing WebDAV operations.
-     * Only one instance runs at a time — if new changes accumulate during
-     * processing, the while loop picks them up in the next iteration.
-     */
-    async function runProcessing() {
-        if (isProcessing)
-            return;
-        isProcessing = true;
-        try {
-            while (filesToUpload.size > 0 || filesToDelete.size > 0) {
-                // Rate limit on errors — wait instead of dropping items
-                const timeSinceError = Date.now() - lastErrorTime;
-                if (timeSinceError < 5000) {
-                    const waitTime = 5000 - timeSinceError;
-                    logger.debug({ waitTime }, 'Rate limiting after recent error, waiting...');
-                    await new Promise((resolve) => setTimeout(resolve, waitTime));
-                }
-                const uploadChanges = Array.from(filesToUpload)
-                    .map((f) => fileToCartridgePath(f, cartridges))
-                    .filter((f) => f !== undefined);
-                const deleteChanges = Array.from(filesToDelete)
-                    .map((f) => fileToCartridgePath(f, cartridges))
-                    .filter((f) => f !== undefined);
-                filesToUpload.clear();
-                filesToDelete.clear();
-                try {
-                    await uploadFiles(instance, resolvedCodeVersion, uploadChanges, deleteChanges, {
-                        onUpload: options.onUpload,
-                        onDelete: options.onDelete,
-                        onError: options.onError,
-                    });
-                }
-                catch {
-                    lastErrorTime = Date.now();
-                    // Re-queue so the while loop retries after rate-limit wait
-                    for (const f of uploadChanges) {
-                        filesToUpload.add(f.src);
-                    }
-                }
-            }
-        }
-        finally {
-            isProcessing = false;
-        }
-    }
-    const scheduleProcessing = debounce(() => {
-        void runProcessing();
-    }, debounceTime);
-    // Set up file watcher
-    const watcher = watch(cartridges.map((c) => c.src), {
-        ignoreInitial: true,
-        cwd,
-    });
-    watcher.on('all', (event, p) => {
-        const fullPath = path.resolve(cwd, p);
-        logger.info({ event, path: fullPath }, `File event: ${event} ${fullPath}`);
-        if (event === 'change' || event === 'add') {
-            filesToUpload.add(fullPath);
-            filesToDelete.delete(fullPath);
-            scheduleProcessing();
-        }
-        else if (event === 'unlink') {
-            filesToDelete.add(fullPath);
-            filesToUpload.delete(fullPath);
-            scheduleProcessing();
-        }
-    });
-    watcher.on('error', (err) => {
-        const error = err instanceof Error ? err : new Error(String(err));
-        logger.error({ error }, 'Watcher error');
-        options.onError?.(error);
-    });
-    logger.debug({ server: instance.config.hostname, codeVersion: resolvedCodeVersion }, 'Watching for changes...');
-    return {
-        watcher,
-        cartridges,
-        codeVersion: resolvedCodeVersion,
-        stop: async () => {
-            await watcher.close();
-            logger.debug('Watcher stopped');
-        },
-    };
-}
-//# sourceMappingURL=watch.js.map

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

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

package/dist/cjs/operations/content/asset-query.d.ts

@@ -1,22 +0,0 @@
-/**
- * Extract static asset paths from component JSON data using dot-notation queries.
- *
- * Supports `*` as a wildcard segment to traverse arrays, allowing extraction
- * from repeated structures like `banners.*.image.src`.
- *
- * @param data - Parsed JSON data from a component's `<data>` element
- * @param queries - Dot-notation paths to extract (e.g. `['image.path', 'slides.*.image.src']`)
- * @returns Array of extracted asset path strings
- *
- * @example
- * ```typescript
- * const data = { image: { path: '/images/hero.jpg' } };
- * extractAssetPaths(data, ['image.path']);
- * // => ['/images/hero.jpg']
- *
- * const data2 = { slides: [{ image: { src: '/a.jpg' } }, { image: { src: '/b.jpg' } }] };
- * extractAssetPaths(data2, ['slides.*.image.src']);
- * // => ['/a.jpg', '/b.jpg']
- * ```
- */
-export declare function extractAssetPaths(data: Record<string, unknown>, queries: string[]): string[];

package/dist/cjs/operations/content/asset-query.js

@@ -1,77 +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
- */
-/**
- * Extract static asset paths from component JSON data using dot-notation queries.
- *
- * Supports `*` as a wildcard segment to traverse arrays, allowing extraction
- * from repeated structures like `banners.*.image.src`.
- *
- * @param data - Parsed JSON data from a component's `<data>` element
- * @param queries - Dot-notation paths to extract (e.g. `['image.path', 'slides.*.image.src']`)
- * @returns Array of extracted asset path strings
- *
- * @example
- * ```typescript
- * const data = { image: { path: '/images/hero.jpg' } };
- * extractAssetPaths(data, ['image.path']);
- * // => ['/images/hero.jpg']
- *
- * const data2 = { slides: [{ image: { src: '/a.jpg' } }, { image: { src: '/b.jpg' } }] };
- * extractAssetPaths(data2, ['slides.*.image.src']);
- * // => ['/a.jpg', '/b.jpg']
- * ```
- */
-export function extractAssetPaths(data, queries) {
-    const results = [];
-    for (const query of queries) {
-        const segments = query.split('.');
-        collectPaths(data, segments, 0, results);
-    }
-    return results;
-}
-/**
- * Recursively walks the data object following the query segments.
- * Wildcard `*` segments iterate over array elements.
- */
-function collectPaths(current, segments, index, results) {
-    if (current == null || typeof current !== 'object') {
-        return;
-    }
-    if (index >= segments.length) {
-        return;
-    }
-    const segment = segments[index];
-    const isLast = index === segments.length - 1;
-    if (segment === '*') {
-        // Wildcard: iterate over array elements (or object values)
-        const items = Array.isArray(current) ? current : Object.values(current);
-        for (const item of items) {
-            if (isLast) {
-                if (typeof item === 'string' && item.length > 0) {
-                    results.push(item);
-                }
-            }
-            else {
-                collectPaths(item, segments, index + 1, results);
-            }
-        }
-    }
-    else {
-        const value = current[segment];
-        if (value === undefined || value === null) {
-            return;
-        }
-        if (isLast) {
-            if (typeof value === 'string' && value.length > 0) {
-                results.push(value);
-            }
-        }
-        else {
-            collectPaths(value, segments, index + 1, results);
-        }
-    }
-}
-//# sourceMappingURL=asset-query.js.map

package/dist/cjs/operations/content/asset-query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset-query.js","sourceRoot":"","sources":["../../../../src/operations/content/asset-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA6B,EAAE,OAAiB;IAChF,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,OAAgB,EAAE,QAAkB,EAAE,KAAa,EAAE,OAAiB;IAC1F,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE7C,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,2DAA2D;QAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAkC,CAAC,CAAC;QACnG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/operations/content/export.d.ts

@@ -1,57 +0,0 @@
-import type { B2CInstance } from '../../instance/index.js';
-import type { FetchContentLibraryOptions, FetchContentLibraryResult, ContentExportOptions, ContentExportResult } from './types.js';
-/**
- * Fetch and parse a content library from an instance (or local file).
- *
- * Returns the parsed Library and optionally the raw archive data.
- * No filesystem side effects.
- *
- * @param instance - B2C instance to fetch from
- * @param libraryId - Library ID (or site ID if isSiteLibrary is true)
- * @param options - Fetch options
- * @returns Parsed library and optional archive data
- *
- * @example
- * ```typescript
- * // Fetch from instance
- * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
- *
- * // Filter and traverse
- * library.filter(n => n.id === 'homepage');
- * const xml = await library.toXMLString({ traverseHidden: false });
- *
- * // Use local file instead
- * const { library } = await fetchContentLibrary(instance, 'SharedLibrary', {
- *   libraryFile: './library.xml'
- * });
- * ```
- */
-export declare function fetchContentLibrary(instance: B2CInstance, libraryId: string, options?: FetchContentLibraryOptions): Promise<FetchContentLibraryResult>;
-/**
- * Export specific pages (with component trees and assets) to a local directory.
- *
- * This is a convenience function that:
- * 1. Fetches/parses the library via {@link fetchContentLibrary}
- * 2. Filters by page ID (exact or regex), optionally by folder
- * 3. Downloads static assets via WebDAV (concurrent, with progress)
- * 4. Writes filtered XML and assets to the output directory
- *
- * @param instance - B2C instance
- * @param pageIds - Page content IDs to export
- * @param libraryId - Library ID (or site ID if isSiteLibrary)
- * @param outputPath - Output directory path
- * @param options - Export options
- * @returns Export result with statistics
- *
- * @example
- * ```typescript
- * const result = await exportContent(
- *   instance,
- *   ['homepage', 'about-us'],
- *   'SharedLibrary',
- *   './export',
- * );
- * console.log(`Exported ${result.pageCount} pages, ${result.componentCount} components`);
- * ```
- */
-export declare function exportContent(instance: B2CInstance, pageIds: string[], libraryId: string, outputPath: string, options?: ContentExportOptions): Promise<ContentExportResult>;