@salesforce/b2c-tooling-sdk 0.2.1 → 0.4.0

package/dist/esm/scaffold/sources.js

@@ -0,0 +1,113 @@
+/*
+ * 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 { findCartridges } from '../operations/code/cartridges.js';
+/**
+ * Common B2C Commerce hook extension points.
+ */
+export const HOOK_POINTS = [
+    { value: 'dw.order.calculate', label: 'Order Calculate' },
+    { value: 'dw.order.calculateShipping', label: 'Calculate Shipping' },
+    { value: 'dw.order.createOrder', label: 'Create Order' },
+    { value: 'dw.order.afterPOST', label: 'OCAPI Order afterPOST' },
+    { value: 'dw.order.beforePOST', label: 'OCAPI Order beforePOST' },
+    { value: 'dw.ocapi.shop.basket.afterPOST', label: 'OCAPI Basket afterPOST' },
+    { value: 'dw.ocapi.shop.basket.modifyGETResponse', label: 'OCAPI Basket modifyGET' },
+    { value: 'dw.ocapi.shop.order.afterPOST', label: 'OCAPI Shop Order afterPOST' },
+    { value: 'dw.ocapi.shop.order.beforePOST', label: 'OCAPI Shop Order beforePOST' },
+    { value: 'dw.ocapi.data.order.afterPATCH', label: 'OCAPI Data Order afterPATCH' },
+    { value: 'dw.customer.registration', label: 'Customer Registration' },
+    { value: 'dw.customer.afterCreate', label: 'Customer afterCreate' },
+    { value: 'app.payment.processor', label: 'Payment Processor' },
+    { value: 'app.payment.form.processor', label: 'Payment Form Processor' },
+    { value: 'dw.system.request.onSession', label: 'On Session' },
+    { value: 'dw.extensions.csv.onFileProcess', label: 'CSV File Process' },
+];
+/**
+ * Resolve a local (non-remote) parameter source.
+ * Does not require authentication.
+ *
+ * @param source - The source type to resolve
+ * @param projectRoot - Project root directory for cartridge discovery
+ * @returns Resolved choices and optional path mapping
+ */
+export function resolveLocalSource(source, projectRoot) {
+    switch (source) {
+        case 'cartridges': {
+            const cartridges = findCartridges(projectRoot);
+            const pathMap = new Map(cartridges.map((c) => [c.name, c.src]));
+            return {
+                choices: cartridges.map((c) => ({ value: c.name, label: c.name })),
+                pathMap,
+            };
+        }
+        case 'hook-points': {
+            return { choices: HOOK_POINTS };
+        }
+        default: {
+            return { choices: [] };
+        }
+    }
+}
+/**
+ * Resolve a remote parameter source.
+ * Requires authenticated B2CInstance (follows SDK operation pattern).
+ *
+ * @param source - The source type
+ * @param instance - Authenticated B2C instance
+ * @returns Promise resolving to choices array
+ * @throws Error if API call fails
+ */
+export async function resolveRemoteSource(source, instance) {
+    switch (source) {
+        case 'sites': {
+            const { data, error } = await instance.ocapi.GET('/sites', {
+                params: { query: { select: '(**)' } },
+            });
+            if (error) {
+                throw new Error('Failed to fetch sites from B2C instance');
+            }
+            const sites = data;
+            return (sites.data ?? []).map((s) => ({
+                value: s.id ?? '',
+                label: s.display_name?.default || s.id || '',
+            }));
+        }
+        default: {
+            return [];
+        }
+    }
+}
+/**
+ * Check if a source requires remote API access.
+ *
+ * @param source - The source type to check
+ * @returns True if the source requires remote access
+ */
+export function isRemoteSource(source) {
+    return source === 'sites';
+}
+/**
+ * Validate a value against a dynamic source (local only).
+ * Used for non-interactive validation of provided values.
+ *
+ * @param source - The source type
+ * @param value - The value to validate
+ * @param projectRoot - Project root for local sources
+ * @returns Object with valid status and available choices if invalid
+ */
+export function validateAgainstSource(source, value, projectRoot) {
+    if (source === 'cartridges') {
+        const { choices } = resolveLocalSource(source, projectRoot);
+        const valid = choices.some((c) => c.value === value);
+        return {
+            valid,
+            availableChoices: valid ? undefined : choices.map((c) => c.value),
+        };
+    }
+    // For hook-points and other sources, no validation (allow any value)
+    return { valid: true };
+}
+//# sourceMappingURL=sources.js.map

package/dist/esm/scaffold/sources.js.map

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

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

@@ -0,0 +1,280 @@
+/**
+ * Path to the built-in scaffolds data directory
+ */
+export declare const SCAFFOLDS_DATA_DIR: string;
+/**
+ * Scaffold category. Built-in scaffolds use 'cartridge', but custom scaffolds
+ * can define their own categories.
+ */
+export type ScaffoldCategory = string;
+/**
+ * Parameter types supported by scaffold parameters
+ */
+export type ScaffoldParameterType = 'string' | 'boolean' | 'choice' | 'multi-choice';
+/**
+ * Dynamic sources for populating parameter choices at runtime.
+ *
+ * - `cartridges`: Discovers cartridges in project via .project files
+ * - `hook-points`: Static list of common hook extension points
+ * - `sites`: Remote - fetches sites from connected B2C instance
+ */
+export type DynamicParameterSource = 'cartridges' | 'hook-points' | 'sites';
+/**
+ * Overwrite behavior for generated files
+ */
+export type OverwriteBehavior = 'never' | 'always' | 'prompt' | 'merge';
+/**
+ * Choice option for choice/multi-choice parameters
+ */
+export interface ScaffoldChoice {
+    /** The value to use when this choice is selected */
+    value: string;
+    /** Human-readable label for this choice */
+    label: string;
+}
+/**
+ * Parameter definition for scaffold prompts and flags
+ */
+export interface ScaffoldParameter {
+    /** Parameter name (camelCase), used in templates as variable name */
+    name: string;
+    /** Prompt message shown in interactive mode */
+    prompt: string;
+    /** Type of the parameter */
+    type: ScaffoldParameterType;
+    /** Whether this parameter is required */
+    required: boolean;
+    /** Default value if not provided */
+    default?: string | boolean | string[];
+    /** Regex pattern for validation (string types only) */
+    pattern?: string;
+    /** Error message shown when validation fails */
+    validationMessage?: string;
+    /** Available choices for choice/multi-choice types */
+    choices?: ScaffoldChoice[];
+    /** CLI flag name override (e.g., "--name"). If not set, uses --{paramName} */
+    flag?: string;
+    /** Conditional expression: only prompt if condition is met (e.g., "otherParam=value") */
+    when?: string;
+    /** Dynamic source for populating choices at runtime */
+    source?: DynamicParameterSource;
+}
+/**
+ * File mapping from template to destination
+ */
+export interface FileMapping {
+    /** Template file path relative to the scaffold's files/ directory */
+    template: string;
+    /** Destination path (supports {{variable}} substitution) */
+    destination: string;
+    /** Conditional expression: only generate if truthy */
+    condition?: string;
+    /** Overwrite behavior for existing files */
+    overwrite?: OverwriteBehavior;
+}
+/**
+ * File modification definition for modifying existing files
+ */
+export interface FileModification {
+    /** Target file path (supports {{variable}} substitution) */
+    target: string;
+    /** Type of modification */
+    type: 'json-merge' | 'insert-after' | 'insert-before' | 'append' | 'prepend';
+    /** Content to insert/merge (for text modifications) */
+    content?: string;
+    /** Template file for the content */
+    contentTemplate?: string;
+    /** Marker string to find (for insert-after/insert-before) */
+    marker?: string;
+    /** JSON path for json-merge operations (e.g., "scripts") */
+    jsonPath?: string;
+    /** Conditional expression */
+    condition?: string;
+}
+/**
+ * Scaffold manifest (scaffold.json)
+ */
+export interface ScaffoldManifest {
+    /** Unique identifier (kebab-case) */
+    name: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Description of what this scaffold creates */
+    description: string;
+    /** Category for filtering and organization */
+    category: ScaffoldCategory;
+    /** Parameters for user input (prompts/flags) */
+    parameters: ScaffoldParameter[];
+    /** File mappings (optional - defaults to all files in files/ directory) */
+    files?: FileMapping[];
+    /** Modifications to existing files (optional) */
+    modifications?: FileModification[];
+    /** Instructions to show after generation */
+    postInstructions?: string;
+    /** Default output directory relative to cwd (created if needed) */
+    defaultOutputDir?: string;
+}
+/**
+ * Resolved scaffold with full paths and source information
+ */
+export interface Scaffold {
+    /** Unique identifier */
+    id: string;
+    /** The manifest definition */
+    manifest: ScaffoldManifest;
+    /** Full path to the scaffold directory */
+    path: string;
+    /** Full path to the files/ directory within the scaffold */
+    filesPath: string;
+    /** Source of this scaffold */
+    source: ScaffoldSource;
+}
+/**
+ * Source/origin of a scaffold
+ */
+export type ScaffoldSource = 'built-in' | 'user' | 'project' | 'plugin';
+/**
+ * Priority ordering for scaffold providers
+ */
+export type ScaffoldProviderPriority = 'before' | 'after';
+/**
+ * Options for scaffold discovery
+ */
+export interface ScaffoldDiscoveryOptions {
+    /** Filter by category */
+    category?: ScaffoldCategory;
+    /** Search query for name/description */
+    query?: string;
+    /** Include only scaffolds from specific sources */
+    sources?: ScaffoldSource[];
+    /** Project root directory (for project-local scaffolds) */
+    projectRoot?: string;
+}
+/**
+ * Scaffold provider interface for extensibility
+ */
+export interface ScaffoldProvider {
+    /** Provider name for identification */
+    readonly name: string;
+    /** Priority: 'before' runs before built-in, 'after' runs after */
+    readonly priority: ScaffoldProviderPriority;
+    /** Get scaffolds from this provider */
+    getScaffolds(options: ScaffoldDiscoveryOptions): Promise<Scaffold[]>;
+}
+/**
+ * Scaffold transformer interface for modifying scaffolds
+ */
+export interface ScaffoldTransformer {
+    /** Transformer name for identification */
+    readonly name: string;
+    /** Transform a scaffold definition */
+    transform(scaffold: Scaffold, context: ScaffoldContext): Promise<Scaffold>;
+}
+/**
+ * Context passed during scaffold operations
+ */
+export interface ScaffoldContext {
+    /** Output directory for generated files */
+    outputDir: string;
+    /** Resolved parameter values */
+    variables: Record<string, string | boolean | string[]>;
+    /** Whether running in dry-run mode */
+    dryRun: boolean;
+    /** Whether to force overwrite existing files */
+    force: boolean;
+    /** Whether running in interactive mode */
+    interactive: boolean;
+}
+/**
+ * Options for scaffold generation
+ */
+export interface ScaffoldGenerateOptions {
+    /** Output directory (defaults to cwd) */
+    outputDir?: string;
+    /** Pre-supplied variable values (from flags/env) */
+    variables?: Record<string, string | boolean | string[]>;
+    /** Preview without writing files */
+    dryRun?: boolean;
+    /** Skip prompts and overwrite existing files */
+    force?: boolean;
+    /** Enable interactive prompts (defaults to true if TTY) */
+    interactive?: boolean;
+}
+/**
+ * Result of a file generation operation
+ */
+export interface GeneratedFile {
+    /** Relative path from output directory */
+    path: string;
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Action taken */
+    action: 'created' | 'skipped' | 'overwritten' | 'merged';
+    /** Reason for skip (if action is 'skipped') */
+    skipReason?: string;
+}
+/**
+ * Result of scaffold generation
+ */
+export interface ScaffoldGenerateResult {
+    /** The scaffold that was used */
+    scaffold: Scaffold;
+    /** Files that were generated */
+    files: GeneratedFile[];
+    /** Post-generation instructions */
+    postInstructions?: string;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** Output directory */
+    outputDir: string;
+}
+/**
+ * Validation error for scaffold parameters
+ */
+export interface ParameterValidationError {
+    /** Parameter name */
+    parameter: string;
+    /** Error message */
+    message: string;
+    /** The invalid value */
+    value?: unknown;
+}
+/**
+ * Result of parameter validation
+ */
+export interface ParameterValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation errors (if any) */
+    errors: ParameterValidationError[];
+    /** Resolved parameter values */
+    values: Record<string, string | boolean | string[]>;
+}
+/**
+ * Template rendering helpers available in EJS templates
+ */
+export interface TemplateHelpers {
+    /** Convert to kebab-case */
+    kebabCase: (str: string) => string;
+    /** Convert to camelCase */
+    camelCase: (str: string) => string;
+    /** Convert to PascalCase */
+    pascalCase: (str: string) => string;
+    /** Convert to snake_case */
+    snakeCase: (str: string) => string;
+    /** Current year */
+    year: number;
+    /** Current date (YYYY-MM-DD) */
+    date: string;
+    /** Generate a UUID v4 */
+    uuid: () => string;
+}
+/**
+ * Result of resolving a dynamic parameter source.
+ */
+export interface SourceResult {
+    /** Available choices */
+    choices: ScaffoldChoice[];
+    /** For cartridges: map of name to absolute path */
+    pathMap?: Map<string, string>;
+}

package/dist/esm/scaffold/types.js

@@ -0,0 +1,14 @@
+/*
+ * 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 { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const packageRoot = path.dirname(require.resolve('@salesforce/b2c-tooling-sdk/package.json'));
+/**
+ * Path to the built-in scaffolds data directory
+ */
+export const SCAFFOLDS_DATA_DIR = path.join(packageRoot, 'data/scaffolds');
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/scaffold/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,CAAC;AAE9F;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/esm/scaffold/validation.d.ts

@@ -0,0 +1,81 @@
+import type { ScaffoldManifest } from './types.js';
+/**
+ * Severity of a validation issue.
+ */
+export type ValidationIssueSeverity = 'error' | 'warning';
+/**
+ * A validation issue found during scaffold validation.
+ */
+export interface ValidationIssue {
+    /** Severity of the issue */
+    severity: ValidationIssueSeverity;
+    /** Human-readable message describing the issue */
+    message: string;
+    /** File path where the issue was found, if applicable */
+    file?: string;
+}
+/**
+ * Result of validating a scaffold directory.
+ */
+export interface ValidationResult {
+    /** Whether the scaffold is valid (no errors) */
+    valid: boolean;
+    /** Number of errors found */
+    errors: number;
+    /** Number of warnings found */
+    warnings: number;
+    /** All issues found during validation */
+    issues: ValidationIssue[];
+}
+/**
+ * Validate EJS syntax in template content.
+ *
+ * Checks for:
+ * - Mismatched opening/closing EJS tags
+ * - Invalid EJS tag patterns
+ * - Empty output tags
+ *
+ * @param content - Template content to validate
+ * @param filename - Optional filename for error reporting
+ * @returns Array of validation issues found
+ */
+export declare function validateEjsSyntax(content: string, filename?: string): ValidationIssue[];
+/**
+ * Check that all referenced template files exist.
+ *
+ * @param filesDir - Path to the files/ directory
+ * @param manifest - Scaffold manifest
+ * @returns Array of validation issues for missing files
+ */
+export declare function checkTemplateFiles(filesDir: string, manifest: ScaffoldManifest): Promise<ValidationIssue[]>;
+/**
+ * Check for orphaned template files not referenced in manifest.
+ *
+ * @param allTemplates - All template file paths in files/ directory
+ * @param manifest - Scaffold manifest
+ * @returns Array of validation issues for orphaned files
+ */
+export declare function checkOrphanedFiles(allTemplates: string[], manifest: ScaffoldManifest): ValidationIssue[];
+/**
+ * Options for scaffold directory validation.
+ */
+export interface ValidateScaffoldOptions {
+    /** Treat warnings as errors */
+    strict?: boolean;
+}
+/**
+ * Validate a complete scaffold directory.
+ *
+ * Performs comprehensive validation including:
+ * - Checking scaffold.json exists and is valid JSON
+ * - Validating manifest structure against schema
+ * - Verifying files/ directory exists
+ * - Checking all referenced template files exist
+ * - Finding orphaned template files
+ * - Validating EJS syntax in templates
+ *
+ * @param scaffoldPath - Path to the scaffold directory
+ * @param options - Validation options
+ * @returns Validation result with issues found
+ */
+export declare function validateScaffoldDirectory(scaffoldPath: string, options?: ValidateScaffoldOptions): Promise<ValidationResult>;