@salesforce/b2c-tooling-sdk 1.9.0 → 1.11.0

package/dist/cjs/scaffold/sources.d.ts

@@ -1,83 +0,0 @@
-import type { B2CInstance } from '../instance/index.js';
-import type { ScaffoldChoice, ScaffoldParameter, DynamicParameterSource, SourceResult } from './types.js';
-/**
- * SCAPI/OCAPI hook extension points.
- */
-export declare const SCAPI_OCAPI_HOOK_POINTS: ScaffoldChoice[];
-/**
- * System hook extension points.
- * Verified against Script API: CalculateHooks, PaymentHooks, OrderHooks,
- * BasketMergeHooks, CheckoutHooks, ReturnHooks, ShippingOrderHooks, RequestHooks
- */
-export declare const SYSTEM_HOOK_POINTS: ScaffoldChoice[];
-/**
- * All hook extension points (combined).
- */
-export declare const HOOK_POINTS: ScaffoldChoice[];
-/**
- * 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 declare function resolveLocalSource(source: DynamicParameterSource, projectRoot: string): SourceResult;
-/**
- * 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 declare function resolveRemoteSource(source: DynamicParameterSource, instance: B2CInstance): Promise<ScaffoldChoice[]>;
-/**
- * Check if a source requires remote API access.
- *
- * @param source - The source type to check
- * @returns True if the source requires remote access
- */
-export declare function isRemoteSource(source: DynamicParameterSource): boolean;
-/**
- * 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 declare function validateAgainstSource(source: DynamicParameterSource, value: string, projectRoot: string): {
-    valid: boolean;
-    availableChoices?: string[];
-};
-/**
- * Path to use for scaffold destination so files are generated under outputDir (e.g. working directory).
- * Returns a path relative to projectRoot when the cartridge is under projectRoot, so the executor
- * joins with outputDir instead of ignoring it. Otherwise returns the absolute path.
- */
-export declare function cartridgePathForDestination(absolutePath: string, projectRoot: string): string;
-/**
- * Result of detecting a source parameter value from a filesystem path.
- */
-export interface SourceDetectionResult {
-    /** The resolved parameter value (e.g., cartridge name) */
-    value: string;
-    /** Companion variables to set (e.g., { cartridgeNamePath: "cartridges/app_custom" }) */
-    companionVariables: Record<string, string>;
-}
-/**
- * Detect a parameter's source value from a filesystem context path.
- *
- * For `cartridges` source: walks up from `contextPath` looking for a `.project` file
- * (cartridge marker), stopping at projectRoot. On match returns the cartridge name and
- * companion path variable.
- *
- * @param param - The scaffold parameter with a `source` field
- * @param contextPath - Filesystem path providing context (e.g., right-clicked folder)
- * @param projectRoot - Project root directory
- * @returns Detection result, or undefined if the source could not be detected
- */
-export declare function detectSourceFromPath(param: ScaffoldParameter, contextPath: string, projectRoot: string): SourceDetectionResult | undefined;

package/dist/cjs/scaffold/sources.js

@@ -1,236 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { findCartridges } from '../operations/code/cartridges.js';
-/**
- * SCAPI/OCAPI hook extension points.
- */
-export const SCAPI_OCAPI_HOOK_POINTS = [
-    // Basket
-    { value: 'dw.ocapi.shop.basket.beforePOST_v2', label: 'Basket beforePOST' },
-    { value: 'dw.ocapi.shop.basket.afterPOST', label: 'Basket afterPOST' },
-    { value: 'dw.ocapi.shop.basket.modifyPOSTResponse', label: 'Basket modifyPOSTResponse' },
-    { value: 'dw.ocapi.shop.basket.beforePATCH', label: 'Basket beforePATCH' },
-    { value: 'dw.ocapi.shop.basket.afterPATCH', label: 'Basket afterPATCH' },
-    { value: 'dw.ocapi.shop.basket.modifyPATCHResponse', label: 'Basket modifyPATCHResponse' },
-    { value: 'dw.ocapi.shop.basket.modifyGETResponse', label: 'Basket modifyGETResponse' },
-    { value: 'dw.ocapi.shop.basket.validateBasket', label: 'Basket validateBasket' },
-    // Basket sub-resources
-    { value: 'dw.ocapi.shop.basket.billing_address.beforePUT', label: 'Basket Billing Address beforePUT' },
-    { value: 'dw.ocapi.shop.basket.billing_address.afterPUT', label: 'Basket Billing Address afterPUT' },
-    { value: 'dw.ocapi.shop.basket.items.beforePOST', label: 'Basket Items beforePOST' },
-    { value: 'dw.ocapi.shop.basket.items.afterPOST', label: 'Basket Items afterPOST' },
-    { value: 'dw.ocapi.shop.basket.item.beforePATCH', label: 'Basket Item beforePATCH' },
-    { value: 'dw.ocapi.shop.basket.item.afterPATCH', label: 'Basket Item afterPATCH' },
-    { value: 'dw.ocapi.shop.basket.item.beforeDELETE', label: 'Basket Item beforeDELETE' },
-    { value: 'dw.ocapi.shop.basket.item.afterDELETE', label: 'Basket Item afterDELETE' },
-    { value: 'dw.ocapi.shop.basket.coupon.beforePOST', label: 'Basket Coupon beforePOST' },
-    { value: 'dw.ocapi.shop.basket.coupon.afterPOST', label: 'Basket Coupon afterPOST' },
-    { value: 'dw.ocapi.shop.basket.payment_instrument.beforePOST', label: 'Basket Payment Instrument beforePOST' },
-    { value: 'dw.ocapi.shop.basket.payment_instrument.afterPOST', label: 'Basket Payment Instrument afterPOST' },
-    { value: 'dw.ocapi.shop.basket.shipment.beforePATCH', label: 'Basket Shipment beforePATCH' },
-    { value: 'dw.ocapi.shop.basket.shipment.afterPATCH', label: 'Basket Shipment afterPATCH' },
-    { value: 'dw.ocapi.shop.basket.shipment.shipping_address.beforePUT', label: 'Basket Shipping Address beforePUT' },
-    { value: 'dw.ocapi.shop.basket.shipment.shipping_address.afterPUT', label: 'Basket Shipping Address afterPUT' },
-    { value: 'dw.ocapi.shop.basket.shipment.shipping_method.beforePUT', label: 'Basket Shipping Method beforePUT' },
-    { value: 'dw.ocapi.shop.basket.shipment.shipping_method.afterPUT', label: 'Basket Shipping Method afterPUT' },
-    // Order
-    { value: 'dw.ocapi.shop.order.beforePOST', label: 'Shop Order beforePOST' },
-    { value: 'dw.ocapi.shop.order.afterPOST', label: 'Shop Order afterPOST' },
-    { value: 'dw.ocapi.shop.order.modifyPOSTResponse', label: 'Shop Order modifyPOSTResponse' },
-    { value: 'dw.ocapi.shop.order.modifyGETResponse', label: 'Shop Order modifyGETResponse' },
-    { value: 'dw.ocapi.shop.order.validateOrder', label: 'Shop Order validateOrder' },
-    { value: 'dw.ocapi.shop.order.payment_instrument.beforePOST', label: 'Order Payment Instrument beforePOST' },
-    { value: 'dw.ocapi.shop.order.payment_instrument.afterPOST', label: 'Order Payment Instrument afterPOST' },
-    // Customer
-    { value: 'dw.ocapi.shop.customer.beforePOST', label: 'Customer beforePOST' },
-    { value: 'dw.ocapi.shop.customer.afterPOST', label: 'Customer afterPOST' },
-    { value: 'dw.ocapi.shop.customer.modifyGETResponse', label: 'Customer modifyGETResponse' },
-    { value: 'dw.ocapi.shop.customer.modifyPOSTResponse', label: 'Customer modifyPOSTResponse' },
-    // Auth
-    { value: 'dw.ocapi.shop.auth.beforePOST', label: 'Auth beforePOST' },
-    { value: 'dw.ocapi.shop.auth.afterPOST', label: 'Auth afterPOST' },
-    { value: 'dw.ocapi.shop.auth.modifyPOSTResponse', label: 'Auth modifyPOSTResponse' },
-    // Product
-    { value: 'dw.ocapi.shop.product.modifyGETResponse', label: 'Product modifyGETResponse' },
-    { value: 'dw.ocapi.shop.product_search.modifyGETResponse', label: 'Product Search modifyGETResponse' },
-];
-/**
- * System hook extension points.
- * Verified against Script API: CalculateHooks, PaymentHooks, OrderHooks,
- * BasketMergeHooks, CheckoutHooks, ReturnHooks, ShippingOrderHooks, RequestHooks
- */
-export const SYSTEM_HOOK_POINTS = [
-    // CalculateHooks
-    { value: 'dw.order.calculate', label: 'Order Calculate' },
-    { value: 'dw.order.calculateShipping', label: 'Calculate Shipping' },
-    { value: 'dw.order.calculateTax', label: 'Calculate Tax' },
-    // PaymentHooks
-    { value: 'dw.order.payment.authorize', label: 'Payment Authorize' },
-    { value: 'dw.order.payment.authorizeCreditCard', label: 'Payment Authorize Credit Card' },
-    { value: 'dw.order.payment.capture', label: 'Payment Capture' },
-    { value: 'dw.order.payment.refund', label: 'Payment Refund' },
-    { value: 'dw.order.payment.validateAuthorization', label: 'Payment Validate Authorization' },
-    { value: 'dw.order.payment.reauthorize', label: 'Payment Reauthorize' },
-    { value: 'dw.order.payment.releaseAuthorization', label: 'Payment Release Authorization' },
-    // OrderHooks
-    { value: 'dw.order.createOrderNo', label: 'Create Order Number' },
-    // BasketMergeHooks
-    { value: 'dw.order.mergeBasket', label: 'Merge Basket' },
-    // CheckoutHooks
-    { value: 'dw.order.populateCustomerDetails', label: 'Populate Customer Details' },
-    // RequestHooks
-    { value: 'dw.system.request.onRequest', label: 'On Request' },
-    { value: 'dw.system.request.onSession', label: 'On Session' },
-];
-/**
- * All hook extension points (combined).
- */
-export const HOOK_POINTS = [...SCAPI_OCAPI_HOOK_POINTS, ...SYSTEM_HOOK_POINTS];
-/**
- * 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 };
-        }
-        case 'scapi-ocapi-hook-points': {
-            return { choices: SCAPI_OCAPI_HOOK_POINTS };
-        }
-        case 'system-hook-points': {
-            return { choices: SYSTEM_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 };
-}
-/**
- * Path to use for scaffold destination so files are generated under outputDir (e.g. working directory).
- * Returns a path relative to projectRoot when the cartridge is under projectRoot, so the executor
- * joins with outputDir instead of ignoring it. Otherwise returns the absolute path.
- */
-export function cartridgePathForDestination(absolutePath, projectRoot) {
-    const normalizedRoot = path.resolve(projectRoot);
-    const normalizedPath = path.resolve(absolutePath);
-    const relative = path.relative(normalizedRoot, normalizedPath);
-    // Use relative path only when cartridge is under projectRoot (no leading '..')
-    if (relative && !relative.startsWith('..') && !path.isAbsolute(relative)) {
-        return relative;
-    }
-    return absolutePath;
-}
-/**
- * Detect a parameter's source value from a filesystem context path.
- *
- * For `cartridges` source: walks up from `contextPath` looking for a `.project` file
- * (cartridge marker), stopping at projectRoot. On match returns the cartridge name and
- * companion path variable.
- *
- * @param param - The scaffold parameter with a `source` field
- * @param contextPath - Filesystem path providing context (e.g., right-clicked folder)
- * @param projectRoot - Project root directory
- * @returns Detection result, or undefined if the source could not be detected
- */
-export function detectSourceFromPath(param, contextPath, projectRoot) {
-    if (param.source !== 'cartridges') {
-        return undefined;
-    }
-    const normalizedRoot = path.resolve(projectRoot);
-    let current = path.resolve(contextPath);
-    // Walk up from contextPath, checking for .project at each level
-    while (current.length >= normalizedRoot.length) {
-        const projectFile = path.join(current, '.project');
-        if (fs.existsSync(projectFile)) {
-            const cartridgeName = path.basename(current);
-            const destPath = cartridgePathForDestination(current, projectRoot);
-            return {
-                value: cartridgeName,
-                companionVariables: { [`${param.name}Path`]: destPath },
-            };
-        }
-        const parent = path.dirname(current);
-        if (parent === current)
-            break; // filesystem root
-        current = parent;
-    }
-    return undefined;
-}
-//# sourceMappingURL=sources.js.map

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

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

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

@@ -1,282 +0,0 @@
-/**
- * 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 (all types)
- * - `scapi-ocapi-hook-points`: SCAPI/OCAPI API extension hook points
- * - `system-hook-points`: System hook extension points (order, payment, request)
- * - `sites`: Remote - fetches sites from connected B2C instance
- */
-export type DynamicParameterSource = 'cartridges' | 'hook-points' | 'scapi-ocapi-hook-points' | 'system-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/cjs/scaffold/types.js

@@ -1,14 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-import 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/cjs/scaffold/types.js.map

@@ -1 +0,0 @@
-{"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"}