@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/operations/content/export.js

@@ -1,221 +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 * as fs from 'node:fs';
-import * as path from 'node:path';
-import JSZip from 'jszip';
-import { getLogger } from '../../logging/logger.js';
-import { siteArchiveExportToBuffer } from '../jobs/site-archive.js';
-import { Library } from './library.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 async function fetchContentLibrary(instance, libraryId, options = {}) {
-    const logger = getLogger();
-    const { libraryFile, isSiteLibrary = false, assetQuery = ['image.path'], keepOrphans = false, waitOptions } = options;
-    const libraryEntry = isSiteLibrary ? `sites/${libraryId}/library/library.xml` : `libraries/${libraryId}/library.xml`;
-    let libraryXML;
-    let archiveData;
-    if (libraryFile) {
-        logger.info({ libraryFile }, `Reading library from local file: ${libraryFile}`);
-        libraryXML = await fs.promises.readFile(libraryFile, 'utf8');
-    }
-    else {
-        logger.info({ libraryId, isSiteLibrary, hostname: instance.config.hostname }, `Exporting library ${libraryId} from ${instance.config.hostname}...`);
-        const dataUnits = isSiteLibrary ? { sites: { [libraryId]: { content: true } } } : { libraries: { [libraryId]: true } };
-        const result = await siteArchiveExportToBuffer(instance, dataUnits, { waitOptions });
-        archiveData = result.data;
-        const zip = await JSZip.loadAsync(result.data);
-        // Find the library XML in the archive (it's nested under a timestamped directory)
-        let libraryFile_ = null;
-        for (const [filePath, entry] of Object.entries(zip.files)) {
-            if (filePath.endsWith(libraryEntry)) {
-                libraryFile_ = entry;
-                break;
-            }
-        }
-        if (!libraryFile_) {
-            throw new Error(`Library ${libraryId} not found in archive; for non-shared libraries use the --site-library option`);
-        }
-        libraryXML = await libraryFile_.async('string');
-    }
-    logger.debug('Parsing library content...');
-    const library = await Library.parse(libraryXML, { assetQuery, keepOrphans });
-    return { library, archiveData };
-}
-/**
- * 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 async function exportContent(instance, pageIds, libraryId, outputPath, options = {}) {
-    const logger = getLogger();
-    const { isSiteLibrary = false, assetQuery = ['image.path'], libraryFile, offline = false, folders = [], regex = false, keepOrphans = false, waitOptions, onAssetProgress, } = options;
-    // Step 1: Fetch and parse library
-    const { library } = await fetchContentLibrary(instance, libraryId, {
-        libraryFile,
-        isSiteLibrary,
-        assetQuery,
-        keepOrphans,
-        waitOptions,
-    });
-    // Step 2: Build matchers from content IDs
-    const matchers = regex ? pageIds.map((p) => new RegExp(p)) : pageIds;
-    function matchesId(id) {
-        return matchers.some((matcher) => (matcher instanceof RegExp ? matcher.test(id) : id === matcher));
-    }
-    // Step 3: Filter root children (pages/content) by ID and optionally by folder
-    library.filter((node) => {
-        if (node.type !== 'PAGE' && node.type !== 'CONTENT') {
-            return false;
-        }
-        if (!matchesId(node.id)) {
-            return false;
-        }
-        // Optional folder filtering
-        if (folders.length > 0) {
-            const xmlData = node.xml;
-            if (!xmlData)
-                return false;
-            const folderLinks = xmlData['folder-links'];
-            const classificationLink = folderLinks?.find((l) => l['classification-link']?.[0]);
-            const folderId = classificationLink?.['classification-link']?.[0]?.['$']?.['folder-id'];
-            if (!folderId || !folders.includes(folderId)) {
-                return false;
-            }
-        }
-        return true;
-    });
-    // Step 3b: Promote matching components to root level
-    const allNodes = [...library.nodes({ traverseHidden: true, callbackHidden: true })];
-    for (const node of allNodes) {
-        if (node.type === 'COMPONENT' && matchesId(node.id)) {
-            library.promoteToRoot(node);
-        }
-    }
-    // Step 4: Count pages, content, and components
-    let pageCount = 0;
-    let contentCount = 0;
-    let componentCount = 0;
-    library.traverse((node) => {
-        if (node.type === 'PAGE')
-            pageCount++;
-        else if (node.type === 'CONTENT')
-            contentCount++;
-        else if (node.type === 'COMPONENT')
-            componentCount++;
-    }, { traverseHidden: false });
-    // Step 5: Collect static asset paths
-    const filesToDownload = new Set();
-    library.traverse((node) => {
-        if (node.type === 'STATIC') {
-            filesToDownload.add(node.id);
-        }
-    }, { traverseHidden: false });
-    // Step 6: Generate output structure
-    const libraryEntry = isSiteLibrary ? `sites/${libraryId}/library/library.xml` : `libraries/${libraryId}/library.xml`;
-    const downloadedAssets = [];
-    const failedAssets = [];
-    // Step 7: Download assets (unless offline)
-    if (!offline && filesToDownload.size > 0) {
-        logger.info({ count: filesToDownload.size }, `Downloading ${filesToDownload.size} asset(s)...`);
-        const assetArray = [...filesToDownload];
-        const concurrency = 5;
-        // Process assets with limited concurrency
-        for (let i = 0; i < assetArray.length; i += concurrency) {
-            const batch = assetArray.slice(i, i + concurrency);
-            const results = await Promise.allSettled(batch.map(async (filename) => {
-                const cleanFilename = filename.startsWith('/') ? filename.slice(1) : filename;
-                const webdavPath = isSiteLibrary
-                    ? `Libraries/${libraryId}/default/${cleanFilename}`
-                    : `Libraries/${libraryId}/default/${cleanFilename}`;
-                logger.debug({ filename: cleanFilename }, `Downloading ${cleanFilename}`);
-                const data = await instance.webdav.get(webdavPath);
-                // Write to output directory
-                const outputFilePath = isSiteLibrary
-                    ? path.join(outputPath, 'sites', libraryId, 'library', 'static', 'default', cleanFilename)
-                    : path.join(outputPath, 'libraries', libraryId, 'static', 'default', cleanFilename);
-                await fs.promises.mkdir(path.dirname(outputFilePath), { recursive: true });
-                await fs.promises.writeFile(outputFilePath, Buffer.from(data));
-                return cleanFilename;
-            }));
-            for (let j = 0; j < results.length; j++) {
-                const result = results[j];
-                const filename = batch[j];
-                const idx = i + j;
-                if (result.status === 'fulfilled') {
-                    downloadedAssets.push(result.value);
-                    onAssetProgress?.(filename, idx, assetArray.length, true);
-                }
-                else {
-                    const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
-                    logger.warn({ filename, error: errorMessage }, `Failed to download asset: ${filename}`);
-                    failedAssets.push({ path: filename, error: errorMessage });
-                    onAssetProgress?.(filename, idx, assetArray.length, false);
-                }
-            }
-        }
-    }
-    // Step 8: Write filtered library XML
-    const xmlString = await library.toXMLString({ traverseHidden: false });
-    const xmlOutputPath = path.join(outputPath, libraryEntry);
-    await fs.promises.mkdir(path.dirname(xmlOutputPath), { recursive: true });
-    await fs.promises.writeFile(xmlOutputPath, xmlString, 'utf8');
-    return {
-        library,
-        outputPath,
-        downloadedAssets,
-        failedAssets,
-        pageCount,
-        contentCount,
-        componentCount,
-    };
-}
-//# sourceMappingURL=export.js.map

package/dist/cjs/operations/content/export.js.map

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

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

@@ -1,56 +0,0 @@
-/**
- * Content library operations for B2C Commerce.
- *
- * This module provides functions for exporting, manipulating, and validating
- * Page Designer content libraries and metadefinitions.
- *
- * ## Core Classes
- *
- * - {@link Library} - Parse and manipulate content library trees
- * - {@link LibraryNode} - Individual nodes in the library tree
- *
- * ## Operations
- *
- * - {@link fetchContentLibrary} - Fetch and parse a content library
- * - {@link exportContent} - Export filtered pages with assets to disk
- *
- * ## Validation
- *
- * - {@link validateMetaDefinition} - Validate a parsed JSON object against a metadefinition schema
- * - {@link validateMetaDefinitionFile} - Validate a JSON file against a metadefinition schema
- * - {@link detectMetaDefinitionType} - Auto-detect the schema type from file path or data
- *
- * ## Utilities
- *
- * - {@link extractAssetPaths} - Extract asset paths from component JSON data
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   Library,
- *   fetchContentLibrary,
- *   exportContent,
- *   validateMetaDefinitionFile,
- * } from '@salesforce/b2c-tooling-sdk/operations/content';
- *
- * // Fetch and filter a library
- * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
- * library.filter(n => n.id === 'homepage');
- *
- * // Or use the high-level export
- * const result = await exportContent(instance, ['homepage'], 'SharedLibrary', './export');
- *
- * // Validate a metadefinition file
- * const validation = validateMetaDefinitionFile('experience/pages/home.json');
- * console.log(validation.valid, validation.errors);
- * ```
- *
- * @module operations/content
- */
-export { Library, LibraryNode } from './library.js';
-export { extractAssetPaths } from './asset-query.js';
-export { fetchContentLibrary, exportContent } from './export.js';
-export type { ColorizeFn, ContentExportOptions, ContentExportResult, FetchContentLibraryOptions, FetchContentLibraryResult, FilterCallback, LibraryNodeType, LibraryParseOptions, TraverseCallback, TraverseOptions, TreeStringOptions, } from './types.js';
-export { CONTENT_SCHEMA_TYPES, MetaDefinitionDetectionError, detectMetaDefinitionType, detectTypeFromData, detectTypeFromPath, validateMetaDefinition, validateMetaDefinitionFile, } from './validate.js';
-export type { ContentSchemaType, MetaDefinitionValidationError, MetaDefinitionValidationResult, ValidateMetaDefinitionOptions, } from './validate.js';

package/dist/cjs/operations/content/index.js

@@ -1,60 +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
- */
-/**
- * Content library operations for B2C Commerce.
- *
- * This module provides functions for exporting, manipulating, and validating
- * Page Designer content libraries and metadefinitions.
- *
- * ## Core Classes
- *
- * - {@link Library} - Parse and manipulate content library trees
- * - {@link LibraryNode} - Individual nodes in the library tree
- *
- * ## Operations
- *
- * - {@link fetchContentLibrary} - Fetch and parse a content library
- * - {@link exportContent} - Export filtered pages with assets to disk
- *
- * ## Validation
- *
- * - {@link validateMetaDefinition} - Validate a parsed JSON object against a metadefinition schema
- * - {@link validateMetaDefinitionFile} - Validate a JSON file against a metadefinition schema
- * - {@link detectMetaDefinitionType} - Auto-detect the schema type from file path or data
- *
- * ## Utilities
- *
- * - {@link extractAssetPaths} - Extract asset paths from component JSON data
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   Library,
- *   fetchContentLibrary,
- *   exportContent,
- *   validateMetaDefinitionFile,
- * } from '@salesforce/b2c-tooling-sdk/operations/content';
- *
- * // Fetch and filter a library
- * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
- * library.filter(n => n.id === 'homepage');
- *
- * // Or use the high-level export
- * const result = await exportContent(instance, ['homepage'], 'SharedLibrary', './export');
- *
- * // Validate a metadefinition file
- * const validation = validateMetaDefinitionFile('experience/pages/home.json');
- * console.log(validation.valid, validation.errors);
- * ```
- *
- * @module operations/content
- */
-export { Library, LibraryNode } from './library.js';
-export { extractAssetPaths } from './asset-query.js';
-export { fetchContentLibrary, exportContent } from './export.js';
-export { CONTENT_SCHEMA_TYPES, MetaDefinitionDetectionError, detectMetaDefinitionType, detectTypeFromData, detectTypeFromPath, validateMetaDefinition, validateMetaDefinitionFile, } from './validate.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/operations/content/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/content/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAC,OAAO,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAElD,OAAO,EAAC,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,mBAAmB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAgB/D,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC"}

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

@@ -1,137 +0,0 @@
-import type { LibraryNodeType, LibraryParseOptions, TraverseOptions, TraverseCallback, FilterCallback, TreeStringOptions } from './types.js';
-/**
- * A node in the content library tree.
- *
- * Represents a library, page, content asset, component, or static asset reference.
- */
-export declare class LibraryNode {
-    id: string;
-    type: LibraryNodeType;
-    typeId: string | null;
-    data: Record<string, unknown> | null;
-    parent: LibraryNode | null;
-    children: LibraryNode[];
-    hidden: boolean;
-    /** @internal Raw xml2js content object */
-    xml: Record<string, unknown> | null;
-    constructor(values: {
-        id: string;
-        type: LibraryNodeType;
-        typeId: string | null;
-        data: Record<string, unknown> | null;
-        parent: LibraryNode | null;
-        children: LibraryNode[];
-        hidden: boolean;
-        xml: Record<string, unknown> | null;
-    });
-    toJSON(): Record<string, unknown>;
-}
-/**
- * Provides an interface for manipulating B2C Commerce content libraries.
- *
- * Use the static `Library.parse()` factory to create instances from library XML.
- * The library tree supports filtering, traversal, mutation, and serialization
- * back to importable XML.
- *
- * @example
- * ```typescript
- * const library = await Library.parse(xmlString);
- *
- * // Filter to specific pages
- * library.filter(node => node.id === 'homepage');
- *
- * // Traverse visible nodes
- * library.traverse(node => {
- *   console.log(node.id, node.type);
- * });
- *
- * // Serialize back to XML
- * const xml = await library.toXMLString({ traverseHidden: false });
- * ```
- */
-export declare class Library {
-    assetQuery: string[];
-    tree: LibraryNode;
-    /** @internal Raw xml2js parsed object */
-    xml: Record<string, unknown>;
-    /** @internal */
-    constructor(guard: symbol);
-    /**
-     * Parse library XML into a Library tree.
-     *
-     * @param libraryXML - Raw XML string of a content library
-     * @param options - Parse options
-     * @returns Parsed Library instance
-     */
-    static parse(libraryXML: string, { assetQuery, keepOrphans }?: LibraryParseOptions): Promise<Library>;
-    /**
-     * Depth-first traversal of the library tree.
-     *
-     * @param callback - Function called for each visited node
-     * @param options - Traversal options
-     * @returns this (for chaining)
-     */
-    traverse(callback: TraverseCallback, { traverseHidden, callbackHidden }?: TraverseOptions): this;
-    /**
-     * Generator-based depth-first iteration of the library tree.
-     *
-     * @param options - Traversal options
-     * @yields LibraryNode for each visited node
-     *
-     * @example
-     * ```typescript
-     * for (const node of library.nodes()) {
-     *   console.log(node.id, node.type);
-     * }
-     * ```
-     */
-    nodes({ traverseHidden, callbackHidden }?: TraverseOptions): Generator<LibraryNode>;
-    /**
-     * Filter the library tree by setting hidden flags on root children.
-     *
-     * @param predicate - Return true to keep the node visible
-     * @param options - Filter options
-     * @returns this (for chaining)
-     */
-    filter(predicate: FilterCallback, { recursive }?: {
-        recursive?: boolean | undefined;
-    }): this;
-    /**
-     * Move a node from its current parent to the root of the library tree.
-     *
-     * Useful for exporting individual components that are normally nested under pages.
-     * The node is removed from its original parent's children and added as a root child.
-     *
-     * @param node - The node to promote
-     * @returns this (for chaining)
-     */
-    promoteToRoot(node: LibraryNode): this;
-    /**
-     * Reset all hidden flags, making every node visible again.
-     *
-     * @returns this (for chaining)
-     */
-    reset(): this;
-    /**
-     * Serialize the library back to importable XML.
-     *
-     * Only includes visible content unless `traverseHidden` is true.
-     *
-     * @param options - Serialization options
-     * @returns XML string
-     */
-    toXMLString({ traverseHidden }?: {
-        traverseHidden?: boolean;
-    }): Promise<string>;
-    /**
-     * Returns a text tree visualization of the library structure.
-     *
-     * @param options - Tree string options (traversal and optional colorize function)
-     * @returns Multi-line tree string
-     */
-    getTreeString({ traverseHidden, colorize }?: TreeStringOptions): string;
-    /**
-     * Returns a JSON-safe representation of the library tree.
-     */
-    toJSON(): Record<string, unknown>;
-}