@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/discovery/detector.js

@@ -1,108 +0,0 @@
-import { DEFAULT_PATTERNS } from './patterns/index.js';
-/**
- * Detects the type of B2C Commerce project in a workspace.
- *
- * WorkspaceTypeDetector analyzes a directory to determine what kind of
- * Commerce project it contains. Returns ALL matched project types to enable
- * union toolset selection for hybrid projects.
- *
- * @example
- * ```typescript
- * import { WorkspaceTypeDetector } from '@salesforce/b2c-tooling-sdk/discovery';
- *
- * const detector = new WorkspaceTypeDetector('/path/to/project');
- * const result = await detector.detect();
- *
- * console.log(`Project types: ${result.projectTypes.join(', ')}`);
- * console.log(`Matched patterns: ${result.matchedPatterns.join(', ')}`);
- * ```
- *
- * @example Custom patterns
- * ```typescript
- * const detector = new WorkspaceTypeDetector('/path/to/project', {
- *   additionalPatterns: [myCustomPattern],
- *   excludePatterns: ['sfra-cartridge'],
- * });
- * ```
- */
-export class WorkspaceTypeDetector {
-    workspacePath;
-    patterns;
-    /**
-     * Creates a new WorkspaceTypeDetector.
-     *
-     * @param workspacePath - Path to the workspace directory to analyze
-     * @param options - Detection options for customizing behavior
-     */
-    constructor(workspacePath, options = {}) {
-        this.workspacePath = workspacePath;
-        this.patterns = this.resolvePatterns(options);
-    }
-    /**
-     * Performs workspace detection.
-     *
-     * Runs all configured patterns against the workspace and returns
-     * a consolidated result with all detected project types.
-     *
-     * @returns Detection result with all project types and matched patterns
-     */
-    async detect() {
-        const matchedPatterns = [];
-        const projectTypes = [];
-        for (const pattern of this.patterns) {
-            try {
-                if (await pattern.detect(this.workspacePath)) {
-                    matchedPatterns.push(pattern.name);
-                    // Add project type if not already present
-                    if (!projectTypes.includes(pattern.projectType)) {
-                        projectTypes.push(pattern.projectType);
-                    }
-                }
-            }
-            catch {
-                // Skip patterns that fail to detect - could log in debug mode
-            }
-        }
-        return {
-            projectTypes,
-            matchedPatterns,
-            autoDiscovered: true,
-        };
-    }
-    /**
-     * Resolves patterns based on options.
-     */
-    resolvePatterns(options) {
-        let patterns = options.patterns ?? DEFAULT_PATTERNS;
-        if (options.additionalPatterns) {
-            patterns = [...patterns, ...options.additionalPatterns];
-        }
-        if (options.excludePatterns) {
-            patterns = patterns.filter((p) => !options.excludePatterns.includes(p.name));
-        }
-        return patterns;
-    }
-}
-/**
- * Creates a WorkspaceTypeDetector and performs detection in one call.
- *
- * This is a convenience function for simple detection use cases.
- *
- * @param workspacePath - Path to the workspace directory
- * @param options - Detection options
- * @returns Detection result with all matched project types
- *
- * @example
- * ```typescript
- * import { detectWorkspaceType } from '@salesforce/b2c-tooling-sdk/discovery';
- *
- * const result = await detectWorkspaceType(process.cwd());
- * console.log(`Detected types: ${result.projectTypes.join(', ')}`);
- * console.log(`Patterns: ${result.matchedPatterns.join(', ')}`);
- * ```
- */
-export async function detectWorkspaceType(workspacePath, options) {
-    const detector = new WorkspaceTypeDetector(workspacePath, options);
-    return detector.detect();
-}
-//# sourceMappingURL=detector.js.map

package/dist/cjs/discovery/detector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/discovery/detector.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,qBAAqB;IACxB,aAAa,CAAS;IACtB,QAAQ,CAAqB;IAErC;;;;;OAKG;IACH,YAAY,aAAqB,EAAE,UAAyB,EAAE;QAC5D,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,MAAM,YAAY,GAAkB,EAAE,CAAC;QAEvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC7C,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBACnC,0CAA0C;oBAC1C,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;wBAChD,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY;YACZ,eAAe;YACf,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAsB;QAC5C,IAAI,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAEpD,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,eAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,aAAqB,EAAE,OAAuB;IACtF,MAAM,QAAQ,GAAG,IAAI,qBAAqB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/cjs/discovery/index.d.ts

@@ -1,63 +0,0 @@
-/**
- * Workspace discovery for B2C Commerce projects.
- *
- * This module provides utilities for detecting the type of B2C Commerce
- * project in a workspace. Returns ALL matched project types to enable
- * union toolset selection for hybrid projects.
- *
- * ## Quick Start
- *
- * ```typescript
- * import { detectWorkspaceType } from '@salesforce/b2c-tooling-sdk/discovery';
- *
- * const result = await detectWorkspaceType(process.cwd());
- *
- * console.log(`Project types: ${result.projectTypes.join(', ')}`);
- * console.log(`Matched patterns: ${result.matchedPatterns.join(', ')}`);
- * ```
- *
- * ## Project Types
- *
- * The detector recognizes 3 workspace types:
- *
- * - `cartridges` - Any cartridge-based project (detected via .project files)
- * - `pwa-kit-v3` - PWA Kit v3 storefront
- * - `storefront-next` - Storefront Next/Odyssey project
- *
- * ## Toolset Mapping
- *
- * - base (fallback): SCAPI
- * - cartridges: CARTRIDGES + SCAPI
- * - pwa-kit-v3: PWAV3 + MRT + SCAPI
- * - storefront-next: STOREFRONTNEXT + MRT + SCAPI
- *
- * ## Custom Patterns
- *
- * You can extend detection with custom patterns:
- *
- * ```typescript
- * import { WorkspaceTypeDetector, type DetectionPattern } from '@salesforce/b2c-tooling-sdk/discovery';
- *
- * const myPattern: DetectionPattern = {
- *   name: 'my-framework',
- *   projectType: 'cartridges',
- *   detect: async (path) => {
- *     // Custom detection logic
- *     return false;
- *   },
- * };
- *
- * const detector = new WorkspaceTypeDetector('/path/to/project', {
- *   additionalPatterns: [myPattern],
- * });
- *
- * const result = await detector.detect();
- * ```
- *
- * @module discovery
- */
-export { WorkspaceTypeDetector, detectWorkspaceType } from './detector.js';
-export type { ProjectType, DetectionPattern, DetectionResult, DetectOptions } from './types.js';
-export { DEFAULT_PATTERNS, cartridgesPattern, pwaKitV3Pattern, storefrontNextPattern, sfraPattern, } from './patterns/index.js';
-export { readPackageJson, exists, glob, globDirs } from './utils.js';
-export type { PackageJson } from './utils.js';

package/dist/cjs/discovery/index.js

@@ -1,70 +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
- */
-/**
- * Workspace discovery for B2C Commerce projects.
- *
- * This module provides utilities for detecting the type of B2C Commerce
- * project in a workspace. Returns ALL matched project types to enable
- * union toolset selection for hybrid projects.
- *
- * ## Quick Start
- *
- * ```typescript
- * import { detectWorkspaceType } from '@salesforce/b2c-tooling-sdk/discovery';
- *
- * const result = await detectWorkspaceType(process.cwd());
- *
- * console.log(`Project types: ${result.projectTypes.join(', ')}`);
- * console.log(`Matched patterns: ${result.matchedPatterns.join(', ')}`);
- * ```
- *
- * ## Project Types
- *
- * The detector recognizes 3 workspace types:
- *
- * - `cartridges` - Any cartridge-based project (detected via .project files)
- * - `pwa-kit-v3` - PWA Kit v3 storefront
- * - `storefront-next` - Storefront Next/Odyssey project
- *
- * ## Toolset Mapping
- *
- * - base (fallback): SCAPI
- * - cartridges: CARTRIDGES + SCAPI
- * - pwa-kit-v3: PWAV3 + MRT + SCAPI
- * - storefront-next: STOREFRONTNEXT + MRT + SCAPI
- *
- * ## Custom Patterns
- *
- * You can extend detection with custom patterns:
- *
- * ```typescript
- * import { WorkspaceTypeDetector, type DetectionPattern } from '@salesforce/b2c-tooling-sdk/discovery';
- *
- * const myPattern: DetectionPattern = {
- *   name: 'my-framework',
- *   projectType: 'cartridges',
- *   detect: async (path) => {
- *     // Custom detection logic
- *     return false;
- *   },
- * };
- *
- * const detector = new WorkspaceTypeDetector('/path/to/project', {
- *   additionalPatterns: [myPattern],
- * });
- *
- * const result = await detector.detect();
- * ```
- *
- * @module discovery
- */
-// Main API
-export { WorkspaceTypeDetector, detectWorkspaceType } from './detector.js';
-// Patterns (for customization)
-export { DEFAULT_PATTERNS, cartridgesPattern, pwaKitV3Pattern, storefrontNextPattern, sfraPattern, } from './patterns/index.js';
-// Utilities (for building custom patterns)
-export { readPackageJson, exists, glob, globDirs } from './utils.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/discovery/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,WAAW;AACX,OAAO,EAAC,qBAAqB,EAAE,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAKzE,+BAA+B;AAC/B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,2CAA2C;AAC3C,OAAO,EAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC"}

package/dist/cjs/discovery/patterns/cartridges.d.ts

@@ -1,16 +0,0 @@
-/**
- * Cartridge project detection pattern.
- *
- * Detects any project containing cartridges by looking for .project files
- * (Eclipse project markers used in SFCC development).
- *
- * @module discovery/patterns/cartridges
- */
-import type { DetectionPattern } from '../types.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 declare const cartridgesPattern: DetectionPattern;

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

@@ -1,16 +0,0 @@
-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/cjs/discovery/patterns/cartridges.js.map

@@ -1 +0,0 @@
-{"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/cjs/discovery/patterns/index.d.ts

@@ -1,21 +0,0 @@
-/**
- * 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/cjs/discovery/patterns/index.js

@@ -1,16 +0,0 @@
-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/cjs/discovery/patterns/index.js.map

@@ -1 +0,0 @@
-{"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/cjs/discovery/patterns/pwa-kit.d.ts

@@ -1,15 +0,0 @@
-/**
- * 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/cjs/discovery/patterns/pwa-kit.js

@@ -1,26 +0,0 @@
-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/cjs/discovery/patterns/pwa-kit.js.map

@@ -1 +0,0 @@
-{"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/cjs/discovery/patterns/sfra.d.ts

@@ -1,34 +0,0 @@
-/**
- * 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/cjs/discovery/patterns/sfra.js

@@ -1,50 +0,0 @@
-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/cjs/discovery/patterns/sfra.js.map

@@ -1 +0,0 @@
-{"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/cjs/discovery/patterns/storefront-next.d.ts

@@ -1,10 +0,0 @@
-import type { DetectionPattern } from '../types.js';
-/**
- * Detection pattern for Storefront Next (Odyssey) projects.
- *
- * Detects (1) storefront-next-template and similar: root package.json has
- * @salesforce/storefront-next* dependency or name starting with "storefront-next".
- * (2) storefront-next monorepo: root has no signal but a workspace package has
- * the dependency or name (e.g. https://github.com/SalesforceCommerceCloud/storefront-next).
- */
-export declare const storefrontNextPattern: DetectionPattern;

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

@@ -1,65 +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
- */
-/**
- * Storefront Next project detection pattern.
- *
- * @module discovery/patterns/storefront-next
- */
-import path from 'node:path';
-import { readPackageJson, globDirs } from '../utils.js';
-/**
- * Returns true if this package.json (deps or name) indicates a Storefront Next project.
- * Relies on @salesforce/storefront-next* dependency or package name starting with "storefront-next" only.
- */
-function packageIndicatesStorefrontNext(pkg) {
-    const deps = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
-    if (deps.some((dep) => dep.startsWith('@salesforce/storefront-next'))) {
-        return true;
-    }
-    const name = pkg.name;
-    if (typeof name !== 'string' || !name.trim())
-        return false;
-    const nameWithoutScope = name.includes('/') ? name.split('/').pop()?.trim() : name.trim();
-    if (!nameWithoutScope)
-        return false;
-    return nameWithoutScope.startsWith('storefront-next');
-}
-/**
- * Detection pattern for Storefront Next (Odyssey) projects.
- *
- * Detects (1) storefront-next-template and similar: root package.json has
- * @salesforce/storefront-next* dependency or name starting with "storefront-next".
- * (2) storefront-next monorepo: root has no signal but a workspace package has
- * the dependency or name (e.g. https://github.com/SalesforceCommerceCloud/storefront-next).
- */
-export const storefrontNextPattern = {
-    name: 'storefront-next',
-    projectType: 'storefront-next',
-    detect: async (workspacePath) => {
-        const rootPkg = await readPackageJson(workspacePath);
-        if (!rootPkg)
-            return false;
-        if (packageIndicatesStorefrontNext(rootPkg))
-            return true;
-        const workspaces = rootPkg.workspaces;
-        if (!workspaces)
-            return false;
-        const patterns = Array.isArray(workspaces) ? workspaces : [workspaces];
-        for (const pattern of patterns) {
-            if (typeof pattern !== 'string' || !pattern.trim())
-                continue;
-            const dirs = await globDirs(pattern, { cwd: workspacePath });
-            for (const dir of dirs) {
-                const pkgPath = path.join(workspacePath, dir);
-                const pkg = await readPackageJson(pkgPath);
-                if (pkg && packageIndicatesStorefrontNext(pkg))
-                    return true;
-            }
-        }
-        return false;
-    },
-};
-//# sourceMappingURL=storefront-next.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"storefront-next.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/storefront-next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,aAAa,CAAC;AAEtD;;;GAGG;AACH,SAAS,8BAA8B,CAAC,GAAgB;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAC,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAC,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1F,IAAI,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,gBAAgB,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,IAAI,8BAA8B,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAC,GAAG,EAAE,aAAa,EAAC,CAAC,CAAC;YAC3D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;gBAC9C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,GAAG,IAAI,8BAA8B,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

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

@@ -1,47 +0,0 @@
-/**
- * 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/cjs/discovery/types.js

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

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

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