@salesforce/b2c-tooling-sdk 0.0.1 → 0.0.2

package/dist/esm/discovery/patterns/cartridges.js

@@ -0,0 +1,16 @@
+import { findCartridges } from '../../operations/code/cartridges.js';
+/**
+ * Detection pattern for cartridge-based projects.
+ *
+ * Uses the SDK's findCartridges function to detect any cartridges in the workspace.
+ * This covers SFRA, custom APIs, and any other cartridge-based development.
+ */
+export const cartridgesPattern = {
+    name: 'cartridges',
+    projectType: 'cartridges',
+    detect: async (workspacePath) => {
+        const cartridges = findCartridges(workspacePath);
+        return cartridges.length > 0;
+    },
+};
+//# sourceMappingURL=cartridges.js.map

package/dist/esm/discovery/patterns/cartridges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartridges.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/cartridges.ts"],"names":[],"mappings":"AAcA,OAAO,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,MAAM,UAAU,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QACjD,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/esm/discovery/patterns/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Detection patterns for workspace discovery.
+ *
+ * Simplified to 3 workspace types:
+ * - cartridges: Any project with cartridges
+ * - pwa-kit-v3: PWA Kit v3 storefront
+ * - storefront-next: Storefront Next (Odyssey)
+ *
+ * @module discovery/patterns
+ */
+import type { DetectionPattern } from '../types.js';
+/**
+ * Default detection patterns.
+ *
+ * All patterns are checked - multiple can match for hybrid projects.
+ */
+export declare const DEFAULT_PATTERNS: DetectionPattern[];
+export { cartridgesPattern } from './cartridges.js';
+export { pwaKitV3Pattern } from './pwa-kit.js';
+export { storefrontNextPattern } from './storefront-next.js';
+export { sfraPattern } from './sfra.js';

package/dist/esm/discovery/patterns/index.js

@@ -0,0 +1,16 @@
+import { cartridgesPattern } from './cartridges.js';
+import { pwaKitV3Pattern } from './pwa-kit.js';
+import { storefrontNextPattern } from './storefront-next.js';
+/**
+ * Default detection patterns.
+ *
+ * All patterns are checked - multiple can match for hybrid projects.
+ */
+export const DEFAULT_PATTERNS = [pwaKitV3Pattern, storefrontNextPattern, cartridgesPattern];
+// Individual pattern exports for customization
+export { cartridgesPattern } from './cartridges.js';
+export { pwaKitV3Pattern } from './pwa-kit.js';
+export { storefrontNextPattern } from './storefront-next.js';
+// Additional patterns (not in DEFAULT_PATTERNS, available for custom use)
+export { sfraPattern } from './sfra.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/discovery/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,CAAC,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAC;AAEhH,+CAA+C;AAC/C,OAAO,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAE3D,0EAA0E;AAC1E,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC"}

package/dist/esm/discovery/patterns/pwa-kit.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PWA Kit v3 project detection pattern.
+ *
+ * @module discovery/patterns/pwa-kit-v3
+ */
+import type { DetectionPattern } from '../types.js';
+/**
+ * Detection pattern for PWA Kit v3 storefronts.
+ *
+ * Detects projects that have PWA Kit v3 SDK dependencies in package.json.
+ * Supports two flavors:
+ * - Template copy: Has @salesforce/pwa-kit-* packages
+ * - Extensible: Has @salesforce/retail-react-app or ccExtensibility field
+ */
+export declare const pwaKitV3Pattern: DetectionPattern;

package/dist/esm/discovery/patterns/pwa-kit.js

@@ -0,0 +1,26 @@
+import { readPackageJson } from '../utils.js';
+/**
+ * Detection pattern for PWA Kit v3 storefronts.
+ *
+ * Detects projects that have PWA Kit v3 SDK dependencies in package.json.
+ * Supports two flavors:
+ * - Template copy: Has @salesforce/pwa-kit-* packages
+ * - Extensible: Has @salesforce/retail-react-app or ccExtensibility field
+ */
+export const pwaKitV3Pattern = {
+    name: 'pwa-kit-v3',
+    projectType: 'pwa-kit-v3',
+    detect: async (workspacePath) => {
+        const pkg = await readPackageJson(workspacePath);
+        if (!pkg)
+            return false;
+        // Check for ccExtensibility field (extensible flavor marker)
+        if (pkg.ccExtensibility)
+            return true;
+        const deps = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
+        // Template copy flavor: @salesforce/pwa-kit-* packages
+        // Extensible flavor: @salesforce/retail-react-app package
+        return deps.some((dep) => dep.startsWith('@salesforce/pwa-kit') || dep === '@salesforce/retail-react-app');
+    },
+};
+//# sourceMappingURL=pwa-kit.js.map

package/dist/esm/discovery/patterns/pwa-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-kit.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/pwa-kit.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvB,6DAA6D;QAC7D,IAAI,GAAG,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAC,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAC,CAAC,CAAC;QAExE,uDAAuD;QACvD,0DAA0D;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC7G,CAAC;CACF,CAAC"}

package/dist/esm/discovery/patterns/sfra.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SFRA (Storefront Reference Architecture) detection pattern.
+ *
+ * NOTE: This pattern is NOT included in DEFAULT_PATTERNS.
+ * The simpler `cartridgesPattern` is used instead, which detects any cartridge project.
+ * This pattern is exported for custom detection scenarios where SFRA-specific
+ * detection is needed.
+ *
+ * @module discovery/patterns/sfra
+ */
+import type { DetectionPattern } from '../types.js';
+/**
+ * Detection pattern for SFRA projects.
+ *
+ * Detects SFRA workspaces by checking for:
+ * 1. A cartridge named `app_storefront_base` - the core SFRA cartridge that serves as the
+ *    foundation for SFRA-based storefronts. Per Salesforce documentation, this cartridge
+ *    is essential and should not be renamed. (Primary detection method)
+ * 2. A package.json with `paths.base` containing `app_storefront_base` - used in multi-repo
+ *    setups with sgmf-scripts where the SFRA base cartridge is external to the project.
+ *    (Secondary heuristic, less common)
+ *
+ * @see https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-customizing-sfra.html
+ *
+ * @example
+ * ```
+ * // Use in custom detection
+ * import { sfraPattern } from '@salesforce/b2c-tooling-sdk/discovery';
+ *
+ * const customPatterns = [sfraPattern, ...otherPatterns];
+ * const result = await detectWorkspaceType(workspacePath, { patterns: customPatterns });
+ * ```
+ */
+export declare const sfraPattern: DetectionPattern;

package/dist/esm/discovery/patterns/sfra.js

@@ -0,0 +1,50 @@
+import { findCartridges } from '../../operations/code/cartridges.js';
+import { readPackageJson } from '../utils.js';
+/**
+ * Detection pattern for SFRA projects.
+ *
+ * Detects SFRA workspaces by checking for:
+ * 1. A cartridge named `app_storefront_base` - the core SFRA cartridge that serves as the
+ *    foundation for SFRA-based storefronts. Per Salesforce documentation, this cartridge
+ *    is essential and should not be renamed. (Primary detection method)
+ * 2. A package.json with `paths.base` containing `app_storefront_base` - used in multi-repo
+ *    setups with sgmf-scripts where the SFRA base cartridge is external to the project.
+ *    (Secondary heuristic, less common)
+ *
+ * @see https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-customizing-sfra.html
+ *
+ * @example
+ * ```
+ * // Use in custom detection
+ * import { sfraPattern } from '@salesforce/b2c-tooling-sdk/discovery';
+ *
+ * const customPatterns = [sfraPattern, ...otherPatterns];
+ * const result = await detectWorkspaceType(workspacePath, { patterns: customPatterns });
+ * ```
+ */
+export const sfraPattern = {
+    name: 'sfra',
+    projectType: 'cartridges', // Maps to cartridges project type
+    detect: async (workspacePath) => {
+        // Primary check: Look for app_storefront_base cartridge (the core SFRA cartridge)
+        // This is the definitive indicator per Salesforce documentation
+        const cartridges = findCartridges(workspacePath);
+        const hasSfraCartridge = cartridges.some((cartridge) => cartridge.name === 'app_storefront_base');
+        if (hasSfraCartridge) {
+            return true;
+        }
+        // Secondary check: Look for package.json with paths.base pointing to app_storefront_base
+        // Used in multi-repo setups with sgmf-scripts where SFRA base is in a separate repo
+        const packageJson = await readPackageJson(workspacePath);
+        if (packageJson) {
+            const paths = packageJson.paths;
+            if (paths?.base && typeof paths.base === 'string') {
+                if (paths.base.includes('app_storefront_base')) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    },
+};
+//# sourceMappingURL=sfra.js.map

package/dist/esm/discovery/patterns/sfra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfra.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/sfra.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,YAAY,EAAE,kCAAkC;IAC7D,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,kFAAkF;QAClF,gEAAgE;QAChE,MAAM,UAAU,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC;QAClG,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,yFAAyF;QACzF,oFAAoF;QACpF,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,WAAW,CAAC,KAA2C,CAAC;YACtE,IAAI,KAAK,EAAE,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;oBAC/C,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/esm/discovery/patterns/storefront-next.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storefront Next project detection pattern.
+ *
+ * @module discovery/patterns/storefront-next
+ */
+import type { DetectionPattern } from '../types.js';
+/**
+ * Detection pattern for Storefront Next (Odyssey) projects.
+ *
+ * Detects projects that have Storefront Next SDK dependencies.
+ * Matches packages starting with @salesforce/storefront-next
+ * (e.g., @salesforce/storefront-next-dev, @salesforce/storefront-next-runtime).
+ */
+export declare const storefrontNextPattern: DetectionPattern;

package/dist/esm/discovery/patterns/storefront-next.js

@@ -0,0 +1,20 @@
+import { readPackageJson } from '../utils.js';
+/**
+ * Detection pattern for Storefront Next (Odyssey) projects.
+ *
+ * Detects projects that have Storefront Next SDK dependencies.
+ * Matches packages starting with @salesforce/storefront-next
+ * (e.g., @salesforce/storefront-next-dev, @salesforce/storefront-next-runtime).
+ */
+export const storefrontNextPattern = {
+    name: 'storefront-next',
+    projectType: 'storefront-next',
+    detect: async (workspacePath) => {
+        const pkg = await readPackageJson(workspacePath);
+        if (!pkg)
+            return false;
+        const deps = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
+        return deps.some((dep) => dep.startsWith('@salesforce/storefront-next'));
+    },
+};
+//# sourceMappingURL=storefront-next.js.map

package/dist/esm/discovery/patterns/storefront-next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-next.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/storefront-next.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAC,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAC,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF,CAAC"}

package/dist/esm/discovery/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Types for workspace discovery.
+ *
+ * @module discovery/types
+ */
+/**
+ * Identifies the type of B2C Commerce project.
+ *
+ * Simplified to 3 workspace types:
+ * - cartridges: Any project with cartridges (detected via .project files)
+ * - pwa-kit-v3: PWA Kit v3 storefront
+ * - storefront-next: Storefront Next (Odyssey)
+ */
+export type ProjectType = 'cartridges' | 'pwa-kit-v3' | 'storefront-next';
+/**
+ * Detection pattern definition.
+ */
+export interface DetectionPattern {
+    /** Unique pattern identifier */
+    name: string;
+    /** Project type this pattern detects */
+    projectType: ProjectType;
+    /** Detection function */
+    detect: (workspacePath: string) => Promise<boolean>;
+}
+/**
+ * Result of workspace detection.
+ */
+export interface DetectionResult {
+    /** All detected project types (from matched patterns) */
+    projectTypes: ProjectType[];
+    /** All patterns that matched */
+    matchedPatterns: string[];
+    /** Whether auto-discovery was performed */
+    autoDiscovered: boolean;
+}
+/**
+ * Options for workspace detection.
+ */
+export interface DetectOptions {
+    /** Custom patterns to use (replaces defaults) */
+    patterns?: DetectionPattern[];
+    /** Additional patterns to include */
+    additionalPatterns?: DetectionPattern[];
+    /** Patterns to exclude by name */
+    excludePatterns?: string[];
+}

package/dist/esm/discovery/types.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
+ */
+/**
+ * Types for workspace discovery.
+ *
+ * @module discovery/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/discovery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG"}

package/dist/esm/discovery/utils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Package.json structure (partial).
+ */
+export interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Reads and parses a package.json file from a directory.
+ *
+ * @param dirPath - Directory containing package.json
+ * @returns Parsed package.json or undefined if not found/invalid
+ */
+export declare function readPackageJson(dirPath: string): Promise<PackageJson | undefined>;
+/**
+ * Checks if a file or directory exists.
+ *
+ * @param filePath - Path to check
+ * @returns True if exists, false otherwise
+ */
+export declare function exists(filePath: string): Promise<boolean>;
+/**
+ * Finds files matching a glob pattern.
+ *
+ * @param pattern - Glob pattern to match
+ * @param options - Glob options including cwd
+ * @returns Array of matching file paths
+ */
+export declare function glob(pattern: string, options: {
+    cwd: string;
+}): Promise<string[]>;
+/**
+ * Finds directories matching a glob pattern.
+ *
+ * @param pattern - Glob pattern to match
+ * @param options - Glob options including cwd
+ * @returns Array of matching directory paths
+ */
+export declare function globDirs(pattern: string, options: {
+    cwd: string;
+}): Promise<string[]>;

package/dist/esm/discovery/utils.js

@@ -0,0 +1,82 @@
+/*
+ * 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
+ */
+/**
+ * Utility functions for workspace discovery.
+ *
+ * @module discovery/utils
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { glob as globLib } from 'glob';
+/**
+ * Reads and parses a package.json file from a directory.
+ *
+ * @param dirPath - Directory containing package.json
+ * @returns Parsed package.json or undefined if not found/invalid
+ */
+export async function readPackageJson(dirPath) {
+    const pkgPath = path.join(dirPath, 'package.json');
+    try {
+        const content = await fs.readFile(pkgPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Checks if a file or directory exists.
+ *
+ * @param filePath - Path to check
+ * @returns True if exists, false otherwise
+ */
+export async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Finds files matching a glob pattern.
+ *
+ * @param pattern - Glob pattern to match
+ * @param options - Glob options including cwd
+ * @returns Array of matching file paths
+ */
+export async function glob(pattern, options) {
+    try {
+        return await globLib(pattern, {
+            cwd: options.cwd,
+            nodir: true,
+            ignore: ['**/node_modules/**'],
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Finds directories matching a glob pattern.
+ *
+ * @param pattern - Glob pattern to match
+ * @param options - Glob options including cwd
+ * @returns Array of matching directory paths
+ */
+export async function globDirs(pattern, options) {
+    try {
+        return await globLib(pattern, {
+            cwd: options.cwd,
+            ignore: ['**/node_modules/**'],
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/discovery/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/discovery/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,IAAI,IAAI,OAAO,EAAC,MAAM,MAAM,CAAC;AAarC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAe,EAAE,OAAsB;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,CAAC,oBAAoB,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe,EAAE,OAAsB;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,CAAC,oBAAoB,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/esm/errors/http-error.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Custom error class for HTTP errors from API clients.
+ *
+ * Wraps the Response object directly for full access to response details.
+ *
+ * @example
+ * try {
+ *   await webdav.delete('some/path');
+ * } catch (error) {
+ *   if (error instanceof HTTPError && error.response.status === 404) {
+ *     // Handle not found
+ *   }
+ *   throw error;
+ * }
+ *
+ * @module errors/http-error
+ */
+/**
+ * Error thrown when an HTTP request fails.
+ *
+ * Wraps the original Response for access to status, headers, and body.
+ */
+export declare class HTTPError extends Error {
+    /**
+     * The original Response object from the failed request.
+     * Note: Body can only be read once via response.text(), response.json(), etc.
+     */
+    readonly response: Response;
+    /**
+     * HTTP method used for the request (GET, POST, PUT, DELETE, etc.).
+     */
+    readonly method: string;
+    constructor(message: string, response: Response, method: string);
+}

package/dist/esm/errors/http-error.js

@@ -0,0 +1,45 @@
+/*
+ * 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
+ */
+/**
+ * Custom error class for HTTP errors from API clients.
+ *
+ * Wraps the Response object directly for full access to response details.
+ *
+ * @example
+ * try {
+ *   await webdav.delete('some/path');
+ * } catch (error) {
+ *   if (error instanceof HTTPError && error.response.status === 404) {
+ *     // Handle not found
+ *   }
+ *   throw error;
+ * }
+ *
+ * @module errors/http-error
+ */
+/**
+ * Error thrown when an HTTP request fails.
+ *
+ * Wraps the original Response for access to status, headers, and body.
+ */
+export class HTTPError extends Error {
+    /**
+     * The original Response object from the failed request.
+     * Note: Body can only be read once via response.text(), response.json(), etc.
+     */
+    response;
+    /**
+     * HTTP method used for the request (GET, POST, PUT, DELETE, etc.).
+     */
+    method;
+    constructor(message, response, method) {
+        super(message);
+        this.name = 'HTTPError';
+        this.response = response;
+        this.method = method;
+    }
+}
+//# sourceMappingURL=http-error.js.map

package/dist/esm/errors/http-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../../src/errors/http-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;;;OAGG;IACM,QAAQ,CAAW;IAE5B;;OAEG;IACM,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,QAAkB,EAAE,MAAc;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/errors/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Error types for B2C tooling operations.
+ *
+ * @module errors
+ */
+export { HTTPError } from './http-error.js';

package/dist/esm/errors/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
+ */
+/**
+ * Error types for B2C tooling operations.
+ *
+ * @module errors
+ */
+export { HTTPError } from './http-error.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC"}