@salesforce/b2c-cli 0.0.1 → 0.0.7

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

@@ -0,0 +1,226 @@
+/*
+ * 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 { watch } from 'chokidar';
+import JSZip from 'jszip';
+import { getLogger } from '../../logging/logger.js';
+import { findCartridges } from './cartridges.js';
+import { getActiveCodeVersion } from './versions.js';
+const UNZIP_BODY = new URLSearchParams({ method: 'UNZIP' }).toString();
+/** Default debounce time in ms for batching file uploads */
+const DEFAULT_DEBOUNCE_TIME = parseInt(process.env.SFCC_UPLOAD_DEBOUNCE_TIME ?? '100', 10);
+/**
+ * Maps an absolute file path to its cartridge-relative destination.
+ */
+function fileToCartridgePath(absolutePath, cartridges) {
+    const cartridge = cartridges.find((c) => absolutePath.startsWith(c.src));
+    if (!cartridge) {
+        return undefined;
+    }
+    const relativePath = absolutePath.substring(cartridge.src.length);
+    const destPath = path.join(cartridge.dest, relativePath);
+    return {
+        src: absolutePath,
+        dest: destPath,
+    };
+}
+/**
+ * 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}`);
+    }
+    const webdav = instance.webdav;
+    const webdavLocation = `Cartridges/${codeVersion}`;
+    const cwd = process.cwd();
+    // Sets for batching file changes
+    const filesToUpload = new Set();
+    const filesToDelete = new Set();
+    let lastErrorTime = 0;
+    /**
+     * Processes batched file changes.
+     */
+    const processChanges = debounce(async () => {
+        const now = Date.now();
+        // Rate limit on errors
+        if (now - lastErrorTime < 5000) {
+            logger.debug('Rate limiting after recent error, waiting...');
+            return;
+        }
+        const uploadFiles = Array.from(filesToUpload)
+            .map((f) => fileToCartridgePath(f, cartridges))
+            .filter((f) => f !== undefined);
+        const deleteFiles = Array.from(filesToDelete)
+            .map((f) => fileToCartridgePath(f, cartridges))
+            .filter((f) => f !== undefined);
+        filesToUpload.clear();
+        filesToDelete.clear();
+        // Filter out files that no longer exist
+        const validUploadFiles = uploadFiles.filter((f) => {
+            if (!fs.existsSync(f.src)) {
+                logger.debug({ file: f.src }, 'Skipping missing file');
+                return false;
+            }
+            return true;
+        });
+        // Upload files
+        if (validUploadFiles.length > 0) {
+            const uploadPath = `${webdavLocation}/_upload-${now}.zip`;
+            try {
+                const zip = new JSZip();
+                for (const f of validUploadFiles) {
+                    try {
+                        const content = await fs.promises.readFile(f.src);
+                        zip.file(f.dest, content);
+                    }
+                    catch (error) {
+                        logger.warn({ file: f.src, error }, 'Failed to add file to archive');
+                    }
+                }
+                const buffer = await zip.generateAsync({
+                    type: 'nodebuffer',
+                    compression: 'DEFLATE',
+                    compressionOptions: { level: 5 },
+                });
+                await webdav.put(uploadPath, buffer, 'application/zip');
+                logger.debug({ uploadPath }, 'Archive uploaded');
+                const response = await webdav.request(uploadPath, {
+                    method: 'POST',
+                    body: UNZIP_BODY,
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                    },
+                });
+                if (!response.ok) {
+                    throw new Error(`Unzip failed: ${response.status}`);
+                }
+                await webdav.delete(uploadPath);
+                logger.debug({ fileCount: validUploadFiles.length, server: instance.config.hostname }, `Uploaded ${validUploadFiles.length} file(s)`);
+                options.onUpload?.(validUploadFiles.map((f) => f.dest));
+            }
+            catch (error) {
+                lastErrorTime = now;
+                const err = error instanceof Error ? error : new Error(String(error));
+                logger.error({ error: err }, `Upload error: ${err.message}`);
+                options.onError?.(err);
+            }
+        }
+        // Delete files (filter out recently uploaded to prevent conflicts)
+        const recentlyUploadedPaths = new Set(validUploadFiles.map((f) => f.dest));
+        const filesToDeleteFiltered = deleteFiles.filter((f) => !recentlyUploadedPaths.has(f.dest));
+        if (filesToDeleteFiltered.length > 0) {
+            logger.debug({ fileCount: filesToDeleteFiltered.length }, `Deleting ${filesToDeleteFiltered.length} file(s)`);
+            for (const f of filesToDeleteFiltered) {
+                const deletePath = `${webdavLocation}/${f.dest}`;
+                try {
+                    await webdav.delete(deletePath);
+                    logger.info({ path: deletePath }, `Deleted: ${deletePath}`);
+                }
+                catch (error) {
+                    logger.debug({ path: deletePath, error }, `Failed to delete ${deletePath}`);
+                }
+            }
+            options.onDelete?.(filesToDeleteFiltered.map((f) => f.dest));
+        }
+    }, 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);
+            processChanges();
+        }
+        else if (event === 'unlink') {
+            filesToDelete.add(fullPath);
+            processChanges();
+        }
+    });
+    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 }, 'Watching for changes...');
+    return {
+        watcher,
+        cartridges,
+        codeVersion,
+        stop: async () => {
+            await watcher.close();
+            logger.debug('Watcher stopped');
+        },
+    };
+}
+//# sourceMappingURL=watch.js.map

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

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

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/download.d.ts

@@ -0,0 +1,45 @@
+import type { B2CInstance } from '../../instance/index.js';
+/**
+ * Options for downloading documentation.
+ */
+export interface DownloadDocsOptions {
+    /** Output directory for extracted docs */
+    outputDir: string;
+    /** Keep the downloaded archive file (default: false) */
+    keepArchive?: boolean;
+}
+/**
+ * Result of a documentation download.
+ */
+export interface DownloadDocsResult {
+    /** Path where docs were extracted */
+    outputPath: string;
+    /** Number of files extracted */
+    fileCount: number;
+    /** Archive filename if kept */
+    archivePath?: string;
+}
+/**
+ * Downloads documentation archive from a B2C instance.
+ *
+ * The archive is available at a special URL:
+ * `https://{hostname}:443/on/demandware.servlet/WFS/Studio/Sites/mock/demandware-mock.zip`
+ *
+ * The outer zip contains `DWAPP-*.API-doc.zip` which contains `sfdocs/script-api/` with markdown docs.
+ *
+ * @param instance - B2C instance to download from
+ * @param options - Download options
+ * @returns Download result with extraction details
+ * @throws Error if download fails or credentials are missing
+ *
+ * @example
+ * ```typescript
+ * const instance = B2CInstance.fromEnvironment();
+ * const result = await downloadDocs(instance, {
+ *   outputDir: './docs',
+ *   keepArchive: true,
+ * });
+ * console.log(`Downloaded ${result.fileCount} files`);
+ * ```
+ */
+export declare function downloadDocs(instance: B2CInstance, options: DownloadDocsOptions): Promise<DownloadDocsResult>;

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/download.js

@@ -0,0 +1,96 @@
+/*
+ * 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 { BasicAuthStrategy } from '../../auth/basic.js';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Downloads documentation archive from a B2C instance.
+ *
+ * The archive is available at a special URL:
+ * `https://{hostname}:443/on/demandware.servlet/WFS/Studio/Sites/mock/demandware-mock.zip`
+ *
+ * The outer zip contains `DWAPP-*.API-doc.zip` which contains `sfdocs/script-api/` with markdown docs.
+ *
+ * @param instance - B2C instance to download from
+ * @param options - Download options
+ * @returns Download result with extraction details
+ * @throws Error if download fails or credentials are missing
+ *
+ * @example
+ * ```typescript
+ * const instance = B2CInstance.fromEnvironment();
+ * const result = await downloadDocs(instance, {
+ *   outputDir: './docs',
+ *   keepArchive: true,
+ * });
+ * console.log(`Downloaded ${result.fileCount} files`);
+ * ```
+ */
+export async function downloadDocs(instance, options) {
+    const logger = getLogger();
+    const { outputDir, keepArchive = false } = options;
+    // Require basic auth for this endpoint
+    if (!instance.auth.basic) {
+        throw new Error('WebDAV credentials (username/password) required for docs download');
+    }
+    const authStrategy = new BasicAuthStrategy(instance.auth.basic.username, instance.auth.basic.password);
+    // Build the special docs URL (not standard WebDAV path)
+    const hostname = instance.config.webdavHostname || instance.config.hostname;
+    const docsUrl = `https://${hostname}:443/on/demandware.servlet/WFS/Studio/Sites/mock/demandware-mock.zip`;
+    logger.debug({ url: docsUrl }, 'Downloading documentation archive');
+    const response = await authStrategy.fetch(docsUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to download docs: ${response.status} ${response.statusText}`);
+    }
+    const outerZipBuffer = Buffer.from(await response.arrayBuffer());
+    logger.debug({ size: outerZipBuffer.length }, 'Downloaded outer archive');
+    // Extract outer zip to find DWAPP-*.API-doc.zip
+    const outerZip = await JSZip.loadAsync(outerZipBuffer);
+    // Find the API doc zip file
+    const apiDocEntry = Object.keys(outerZip.files).find((name) => name.match(/DWAPP-.*API-doc\.zip$/i));
+    if (!apiDocEntry) {
+        throw new Error('API documentation archive not found in downloaded package');
+    }
+    logger.debug({ entry: apiDocEntry }, 'Found API documentation archive');
+    // Extract inner zip content
+    const innerZipBuffer = await outerZip.files[apiDocEntry].async('nodebuffer');
+    const innerZip = await JSZip.loadAsync(innerZipBuffer);
+    // Create output directory
+    await fs.promises.mkdir(outputDir, { recursive: true });
+    // Extract sfdocs/script-api/*.md files (flat, no subdirectories)
+    let fileCount = 0;
+    const scriptApiPrefix = 'sfdocs/script-api/';
+    for (const [relativePath, zipEntry] of Object.entries(innerZip.files)) {
+        if (!relativePath.startsWith(scriptApiPrefix) || zipEntry.dir) {
+            continue;
+        }
+        // Only extract .md files
+        if (!relativePath.endsWith('.md')) {
+            continue;
+        }
+        // Get just the filename (strip the prefix)
+        const filename = relativePath.slice(scriptApiPrefix.length);
+        const outputPath = path.join(outputDir, filename);
+        const content = await zipEntry.async('nodebuffer');
+        await fs.promises.writeFile(outputPath, content);
+        fileCount++;
+    }
+    logger.debug({ fileCount }, 'Extracted documentation files');
+    const result = {
+        outputPath: outputDir,
+        fileCount,
+    };
+    if (keepArchive) {
+        const archivePath = path.join(outputDir, 'demandware-mock.zip');
+        await fs.promises.writeFile(archivePath, outerZipBuffer);
+        result.archivePath = archivePath;
+        logger.debug({ archivePath }, 'Saved archive');
+    }
+    return result;
+}
+//# sourceMappingURL=download.js.map

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../src/operations/docs/download.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAwBlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAqB,EAAE,OAA4B;IACpF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAC,SAAS,EAAE,WAAW,GAAG,KAAK,EAAC,GAAG,OAAO,CAAC;IAEjD,uCAAuC;IACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvG,wDAAwD;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC5E,MAAM,OAAO,GAAG,WAAW,QAAQ,sEAAsE,CAAC;IAE1G,MAAM,CAAC,KAAK,CAAC,EAAC,GAAG,EAAE,OAAO,EAAC,EAAE,mCAAmC,CAAC,CAAC;IAElE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,CAAC,EAAC,IAAI,EAAE,cAAc,CAAC,MAAM,EAAC,EAAE,0BAA0B,CAAC,CAAC;IAExE,gDAAgD;IAChD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAEvD,4BAA4B;IAC5B,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAErG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAC,KAAK,EAAE,WAAW,EAAC,EAAE,iCAAiC,CAAC,CAAC;IAEtE,4BAA4B;IAC5B,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAEvD,0BAA0B;IAC1B,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IAEtD,iEAAiE;IACjE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,eAAe,GAAG,oBAAoB,CAAC;IAE7C,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC9D,SAAS;QACX,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,SAAS,EAAE,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAC,SAAS,EAAC,EAAE,+BAA+B,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAuB;QACjC,UAAU,EAAE,SAAS;QACrB,SAAS;KACV,CAAC;IAEF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;QAChE,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACzD,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,EAAC,WAAW,EAAC,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Documentation operations for B2C Commerce Script API.
+ *
+ * Provides functions for downloading documentation from B2C instances
+ * and searching bundled documentation locally.
+ *
+ * ## Download Documentation
+ *
+ * Use {@link downloadDocs} to download documentation from a B2C instance:
+ *
+ * ```typescript
+ * import { downloadDocs } from '@salesforce/b2c-tooling-sdk/operations/docs';
+ * import { B2CInstance } from '@salesforce/b2c-tooling-sdk';
+ *
+ * const instance = B2CInstance.fromEnvironment();
+ * const result = await downloadDocs(instance, { outputDir: './docs' });
+ * console.log(`Downloaded ${result.fileCount} files`);
+ * ```
+ *
+ * ## Search Bundled Docs
+ *
+ * Use {@link searchDocs} and {@link readDocByQuery} to search and read bundled documentation:
+ *
+ * ```typescript
+ * import { searchDocs, readDocByQuery } from '@salesforce/b2c-tooling-sdk/operations/docs';
+ *
+ * // Search for documentation
+ * const results = searchDocs('ProductMgr');
+ * results.forEach(r => console.log(r.entry.id, r.score));
+ *
+ * // Read a specific doc by fuzzy query
+ * const doc = readDocByQuery('dw.catalog.ProductMgr');
+ * if (doc) {
+ *   console.log(doc.content);
+ * }
+ * ```
+ *
+ * @module operations/docs
+ */
+export type { DocEntry, SearchIndex, SearchResult, SchemaEntry, SchemaIndex, SchemaSearchResult } from './types.js';
+export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex } from './search.js';
+export { listSchemas, readSchema, readSchemaByQuery, searchSchemas } from './schema.js';
+export { downloadDocs } from './download.js';
+export type { DownloadDocsOptions, DownloadDocsResult } from './download.js';

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

@@ -0,0 +1,12 @@
+/*
+ * 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
+ */
+// Search operations
+export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex } from './search.js';
+// Schema operations
+export { listSchemas, readSchema, readSchemaByQuery, searchSchemas } from './schema.js';
+// Download operation
+export { downloadDocs } from './download.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/docs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6CH,oBAAoB;AACpB,OAAO,EAAC,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAC,MAAM,aAAa,CAAC;AAE3F,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAEtF,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC"}

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/schema.d.ts

@@ -0,0 +1,24 @@
+import { type SchemaEntry, type SchemaSearchResult } from './types.js';
+/**
+ * List all available schema entries.
+ */
+export declare function listSchemas(): SchemaEntry[];
+/**
+ * Read a schema by its exact ID.
+ */
+export declare function readSchema(id: string): {
+    entry: SchemaEntry;
+    content: string;
+} | null;
+/**
+ * Find a schema by fuzzy query and return its content.
+ * Returns the best match or null if no match found.
+ */
+export declare function readSchemaByQuery(query: string): {
+    entry: SchemaEntry;
+    content: string;
+} | null;
+/**
+ * Search schemas by fuzzy query.
+ */
+export declare function searchSchemas(query: string, limit?: number): SchemaSearchResult[];

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/schema.js

@@ -0,0 +1,92 @@
+/*
+ * 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 Fuse from 'fuse.js';
+import { XSD_DATA_DIR } from './types.js';
+// Lazy-loaded index and Fuse instance
+let schemaIndex = null;
+let fuseInstance = null;
+/**
+ * Load the schema index from disk.
+ */
+function loadIndex() {
+    if (schemaIndex) {
+        return schemaIndex;
+    }
+    const indexPath = path.join(XSD_DATA_DIR, 'index.json');
+    const content = fs.readFileSync(indexPath, 'utf-8');
+    schemaIndex = JSON.parse(content);
+    return schemaIndex;
+}
+/**
+ * Get or create the Fuse.js search instance.
+ */
+function getFuse() {
+    if (fuseInstance) {
+        return fuseInstance;
+    }
+    const index = loadIndex();
+    fuseInstance = new Fuse(index.entries, {
+        keys: [{ name: 'id', weight: 1 }],
+        includeScore: true,
+        threshold: 0.4,
+    });
+    return fuseInstance;
+}
+/**
+ * List all available schema entries.
+ */
+export function listSchemas() {
+    const index = loadIndex();
+    return index.entries;
+}
+/**
+ * Read a schema by its exact ID.
+ */
+export function readSchema(id) {
+    const index = loadIndex();
+    const entry = index.entries.find((e) => e.id === id);
+    if (!entry) {
+        return null;
+    }
+    const filePath = path.join(XSD_DATA_DIR, entry.filePath);
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return { entry, content };
+}
+/**
+ * Find a schema by fuzzy query and return its content.
+ * Returns the best match or null if no match found.
+ */
+export function readSchemaByQuery(query) {
+    // First try exact match
+    const exactMatch = readSchema(query);
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // Try fuzzy search
+    const fuse = getFuse();
+    const results = fuse.search(query, { limit: 1 });
+    if (results.length === 0) {
+        return null;
+    }
+    const bestMatch = results[0];
+    const filePath = path.join(XSD_DATA_DIR, bestMatch.item.filePath);
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return { entry: bestMatch.item, content };
+}
+/**
+ * Search schemas by fuzzy query.
+ */
+export function searchSchemas(query, limit = 20) {
+    const fuse = getFuse();
+    const results = fuse.search(query, { limit });
+    return results.map((result) => ({
+        entry: result.item,
+        score: result.score ?? 0,
+    }));
+}
+//# sourceMappingURL=schema.js.map

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/schema.js.map

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

package/node_modules/@salesforce/b2c-tooling-sdk/dist/esm/operations/docs/search.d.ts

@@ -0,0 +1,67 @@
+import { type DocEntry, type SearchIndex, type SearchResult } from './types.js';
+/**
+ * Loads the pre-built search index from the bundled data directory.
+ *
+ * @returns The search index with all documentation entries
+ * @throws Error if the index file cannot be read
+ */
+export declare function loadSearchIndex(): SearchIndex;
+/**
+ * Searches the documentation index with fuzzy matching.
+ *
+ * @param query - The search query string
+ * @param limit - Maximum number of results to return (default: 20)
+ * @returns Array of search results sorted by relevance
+ *
+ * @example
+ * ```typescript
+ * const results = searchDocs('ProductMgr');
+ * results.forEach(r => console.log(r.entry.id, r.score));
+ * ```
+ */
+export declare function searchDocs(query: string, limit?: number): SearchResult[];
+/**
+ * Reads the content of a documentation file by its ID.
+ *
+ * @param id - The documentation ID (filename without .md extension)
+ * @returns The raw markdown content of the document
+ * @throws Error if the document is not found
+ *
+ * @example
+ * ```typescript
+ * const content = readDoc('dw.catalog.ProductMgr');
+ * console.log(content);
+ * ```
+ */
+export declare function readDoc(id: string): string;
+/**
+ * Reads documentation by fuzzy-matching the query and returning the best match.
+ *
+ * @param query - The search query string
+ * @returns The best matching entry and its content, or null if no match
+ *
+ * @example
+ * ```typescript
+ * const doc = readDocByQuery('ProductMgr');
+ * if (doc) {
+ *   console.log(`Found: ${doc.entry.title}`);
+ *   console.log(doc.content);
+ * }
+ * ```
+ */
+export declare function readDocByQuery(query: string): {
+    entry: DocEntry;
+    content: string;
+} | null;
+/**
+ * Lists all available documentation entries.
+ *
+ * @returns Array of all documentation entries in the index
+ *
+ * @example
+ * ```typescript
+ * const docs = listDocs();
+ * console.log(`${docs.length} documentation files available`);
+ * ```
+ */
+export declare function listDocs(): DocEntry[];