@walkeros/cli 0.4.2 → 0.5.1-next.0

package/dist/config/loader.js

@@ -1,155 +0,0 @@
-/**
- * Configuration Loader
- *
- * Loads and parses Flow.Setup configurations using core getFlowConfig().
- * Build options are determined by static platform defaults.
- */
-import path from 'path';
-import fs from 'fs-extra';
-import { getFlowConfig, getPlatform } from '@walkeros/core';
-import { validateFlowSetup, isFlowSetup, getAvailableFlows as getFlowNames, } from './validators.js';
-import { getBuildDefaults, getDefaultOutput } from './build-defaults.js';
-/** Default folder for includes if it exists */
-const DEFAULT_INCLUDE_FOLDER = './shared';
-/**
- * Load and parse bundle configuration.
- *
- * @remarks
- * Uses Flow.Setup from @walkeros/core as the only config format.
- * - Validates config structure
- * - Uses core getFlowConfig() for variable/definition resolution
- * - Determines platform from resolved config
- * - Applies static build defaults based on platform
- *
- * @param rawConfig - Raw configuration object from JSON file
- * @param options - Loading options
- * @returns Parsed configuration with flow and build separated
- *
- * @example
- * ```typescript
- * const config = loadBundleConfig(rawConfig, {
- *   configPath: './walkeros.config.json',
- *   flowName: 'production',
- * });
- * ```
- */
-export function loadBundleConfig(rawConfig, options) {
-    // Validate as Flow.Setup
-    const setup = validateFlowSetup(rawConfig);
-    const availableFlows = getFlowNames(setup);
-    // Determine which flow to use
-    const flowName = resolveFlow(setup, options.flowName, availableFlows);
-    // Use core getFlowConfig() for resolution (variables, $refs, cascading)
-    const flowConfig = getFlowConfig(setup, flowName);
-    // Detect platform from resolved config
-    const platform = getPlatform(flowConfig);
-    if (!platform) {
-        throw new Error(`Invalid configuration: flow "${flowName}" must have a "web" or "server" key.`);
-    }
-    // Get static build defaults based on platform
-    const buildDefaults = getBuildDefaults(platform);
-    // Extract packages from flowConfig (if present)
-    const packages = flowConfig.packages || {};
-    // Resolve output path relative to config directory
-    let output = getDefaultOutput(platform);
-    if (options.buildOverrides?.output) {
-        output = options.buildOverrides.output;
-    }
-    // Get config directory for relative path resolution
-    const configDir = path.dirname(options.configPath);
-    // Make output path absolute relative to config file
-    if (!path.isAbsolute(output)) {
-        output = path.resolve(configDir, output);
-    }
-    // Get includes from config or use default if ./shared exists
-    let includes = setup.include;
-    if (!includes) {
-        const defaultIncludePath = path.resolve(configDir, DEFAULT_INCLUDE_FOLDER);
-        if (fs.pathExistsSync(defaultIncludePath)) {
-            includes = [DEFAULT_INCLUDE_FOLDER];
-        }
-    }
-    // Merge build options: defaults + CLI overrides
-    const buildOptions = {
-        ...buildDefaults,
-        packages,
-        output,
-        include: includes,
-        configDir,
-        ...options.buildOverrides,
-    };
-    // Log flow selection
-    const isMultiFlow = availableFlows.length > 1;
-    if (isMultiFlow && options.logger) {
-        options.logger.info(`📦 Using flow: ${flowName} (${availableFlows.length} total)`);
-    }
-    return {
-        flowConfig,
-        buildOptions,
-        flowName,
-        isMultiFlow,
-        availableFlows,
-    };
-}
-/**
- * Resolve which flow to use.
- *
- * @param setup - Flow.Setup configuration
- * @param requestedFlow - Flow name from CLI (optional)
- * @param available - Available flow names
- * @returns Flow name to use
- * @throws Error if flow selection is invalid
- */
-function resolveFlow(setup, requestedFlow, available) {
-    // If only one flow, use it automatically
-    if (available.length === 1) {
-        return available[0];
-    }
-    // Multiple flows require explicit selection
-    if (!requestedFlow) {
-        throw new Error(`Multiple flows found. Please specify a flow using --flow flag.\n` +
-            `Available flows: ${available.join(', ')}`);
-    }
-    // Validate the requested flow exists
-    if (!available.includes(requestedFlow)) {
-        throw new Error(`Flow "${requestedFlow}" not found in configuration.\n` +
-            `Available flows: ${available.join(', ')}`);
-    }
-    return requestedFlow;
-}
-/**
- * Load all flows from a configuration.
- *
- * @remarks
- * Used by the --all flag to build all flows.
- *
- * @param rawConfig - Raw configuration object
- * @param options - Loading options (without flowName)
- * @returns Array of loaded configurations for all flows
- */
-export function loadAllFlows(rawConfig, options) {
-    // Validate as Flow.Setup
-    const setup = validateFlowSetup(rawConfig);
-    const flows = getFlowNames(setup);
-    if (options.logger) {
-        options.logger.info(`📦 Loading all ${flows.length} flows: ${flows.join(', ')}`);
-    }
-    // Load each flow
-    return flows.map((name) => loadBundleConfig(rawConfig, {
-        ...options,
-        flowName: name,
-    }));
-}
-/**
- * Get list of available flows from configuration.
- *
- * @param rawConfig - Raw configuration object
- * @returns Array of flow names
- */
-export function getAvailableFlows(rawConfig) {
-    if (isFlowSetup(rawConfig)) {
-        return getFlowNames(rawConfig);
-    }
-    return [];
-}
-//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/utils.d.ts

@@ -1,114 +0,0 @@
-/**
- * Configuration Utility Functions
- */
-/**
- * Check if a string is a valid URL
- *
- * @param str - String to check
- * @returns True if string is a valid HTTP/HTTPS URL
- */
-export declare function isUrl(str: string): boolean;
-/**
- * Download a file from a URL to a temporary location
- *
- * @param url - HTTP/HTTPS URL to download
- * @returns Path to downloaded temporary file
- * @throws Error if download fails or response is not OK
- *
- * @example
- * ```typescript
- * const tempPath = await downloadFromUrl('https://example.com/config.json')
- * // Returns: "/tmp/walkeros-download-1647261462000-abc123.json"
- * ```
- */
-export declare function downloadFromUrl(url: string): Promise<string>;
-/**
- * Substitute environment variables in a string.
- *
- * @param value - String with ${VAR} placeholders
- * @returns String with environment variables substituted
- * @throws Error if environment variable is not found
- *
- * @example
- * ```typescript
- * substituteEnvVariables('${HOME}/config') // "/Users/name/config"
- * ```
- */
-export declare function substituteEnvVariables(value: string): string;
-/**
- * Load and parse JSON configuration file from local path or URL.
- *
- * @param configPath - Path to JSON file or HTTP/HTTPS URL
- * @returns Parsed configuration object and cleanup function
- * @throws Error if file not found, download fails, or invalid JSON
- *
- * @example
- * ```typescript
- * // Local file
- * const config = await loadJsonConfig('./config.json')
- *
- * // Remote URL
- * const config = await loadJsonConfig('https://example.com/config.json')
- * ```
- */
-export declare function loadJsonConfig<T>(configPath: string): Promise<T>;
-/**
- * Generate a unique temporary directory path.
- *
- * @param tempDir - Base temporary directory (default: ".tmp")
- * @returns Absolute path to unique temp directory
- *
- * @example
- * ```typescript
- * getTempDir() // "/workspaces/project/.tmp/cli-1647261462000-abc123"
- * getTempDir('/tmp') // "/tmp/cli-1647261462000-abc123"
- * ```
- */
-export declare function getTempDir(tempDir?: string): string;
-/**
- * Load JSON from inline string, file path, or URL.
- *
- * Supports three input formats:
- * 1. Inline JSON string - parsed directly
- * 2. Local file path - read and parsed
- * 3. HTTP/HTTPS URL - downloaded and parsed
- *
- * Detection priority:
- * 1. URL (http://, https://) → download and parse
- * 2. Existing file path → read and parse
- * 3. Valid JSON string → parse directly
- * 4. Simple string → treat as {name: string} for backward compatibility
- *
- * @param source - JSON string, file path, or URL
- * @param options - Optional configuration
- * @param options.name - Parameter name for error messages (e.g., "event", "config")
- * @param options.required - Throw error if source is empty (default: false)
- * @param options.fallback - Default value if source is empty
- * @returns Parsed JSON object
- * @throws Error if source is required but empty, or if loading/parsing fails
- *
- * @example
- * ```typescript
- * // Inline JSON
- * await loadJsonFromSource('{"name":"order complete","data":{}}')
- *
- * // File path
- * await loadJsonFromSource('./examples/event.json')
- *
- * // URL
- * await loadJsonFromSource('https://example.com/event.json')
- *
- * // With options
- * await loadJsonFromSource(input, {
- *   name: 'event',
- *   required: true,
- *   fallback: { name: 'default' }
- * })
- * ```
- */
-export declare function loadJsonFromSource<T = unknown>(source: string | undefined, options?: {
-    name?: string;
-    required?: boolean;
-    fallback?: T;
-}): Promise<T>;
-//# sourceMappingURL=utils.d.ts.map

package/dist/config/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/config/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO1C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkClE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAmCtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,GAAG,MAAM,CAMnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAClD,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd,GACA,OAAO,CAAC,CAAC,CAAC,CAmEZ"}

package/dist/config/utils.js

@@ -1,257 +0,0 @@
-/**
- * Configuration Utility Functions
- */
-import fs from 'fs-extra';
-import path from 'path';
-import os from 'os';
-import { getErrorMessage } from '../core/index.js';
-/**
- * Check if a string is a valid URL
- *
- * @param str - String to check
- * @returns True if string is a valid HTTP/HTTPS URL
- */
-export function isUrl(str) {
-    try {
-        const url = new URL(str);
-        return url.protocol === 'http:' || url.protocol === 'https:';
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Download a file from a URL to a temporary location
- *
- * @param url - HTTP/HTTPS URL to download
- * @returns Path to downloaded temporary file
- * @throws Error if download fails or response is not OK
- *
- * @example
- * ```typescript
- * const tempPath = await downloadFromUrl('https://example.com/config.json')
- * // Returns: "/tmp/walkeros-download-1647261462000-abc123.json"
- * ```
- */
-export async function downloadFromUrl(url) {
-    if (!isUrl(url)) {
-        throw new Error(`Invalid URL: ${url}`);
-    }
-    try {
-        const response = await fetch(url);
-        if (!response.ok) {
-            throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
-        }
-        const content = await response.text();
-        // Extract filename from URL or generate one
-        const urlObj = new URL(url);
-        const urlFilename = path.basename(urlObj.pathname);
-        const extension = path.extname(urlFilename) || '.json';
-        const randomId = Math.random().toString(36).substring(2, 11);
-        const filename = `walkeros-download-${Date.now()}-${randomId}${extension}`;
-        // Write to system temp directory
-        const tempPath = path.join(os.tmpdir(), filename);
-        await fs.writeFile(tempPath, content, 'utf-8');
-        return tempPath;
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            throw new Error(`Failed to download from URL: ${error.message}`);
-        }
-        throw error;
-    }
-}
-/**
- * Substitute environment variables in a string.
- *
- * @param value - String with ${VAR} placeholders
- * @returns String with environment variables substituted
- * @throws Error if environment variable is not found
- *
- * @example
- * ```typescript
- * substituteEnvVariables('${HOME}/config') // "/Users/name/config"
- * ```
- */
-export function substituteEnvVariables(value) {
-    return value.replace(/\${([^}]+)}/g, (_, envVar) => {
-        const envValue = process.env[envVar];
-        if (!envValue) {
-            throw new Error(`Environment variable ${envVar} not found`);
-        }
-        return envValue;
-    });
-}
-/**
- * Load and parse JSON configuration file from local path or URL.
- *
- * @param configPath - Path to JSON file or HTTP/HTTPS URL
- * @returns Parsed configuration object and cleanup function
- * @throws Error if file not found, download fails, or invalid JSON
- *
- * @example
- * ```typescript
- * // Local file
- * const config = await loadJsonConfig('./config.json')
- *
- * // Remote URL
- * const config = await loadJsonConfig('https://example.com/config.json')
- * ```
- */
-export async function loadJsonConfig(configPath) {
-    let absolutePath;
-    let isTemporary = false;
-    // Check if input is a URL
-    if (isUrl(configPath)) {
-        // Download from URL to temp location
-        absolutePath = await downloadFromUrl(configPath);
-        isTemporary = true;
-    }
-    else {
-        // Local file path
-        absolutePath = path.resolve(configPath);
-        if (!(await fs.pathExists(absolutePath))) {
-            throw new Error(`Configuration file not found: ${absolutePath}`);
-        }
-    }
-    try {
-        const rawConfig = await fs.readJson(absolutePath);
-        return rawConfig;
-    }
-    catch (error) {
-        throw new Error(`Invalid JSON in config file: ${configPath}. ${error instanceof Error ? error.message : error}`);
-    }
-    finally {
-        // Clean up temporary downloaded file
-        if (isTemporary) {
-            try {
-                await fs.remove(absolutePath);
-            }
-            catch {
-                // Ignore cleanup errors
-            }
-        }
-    }
-}
-/**
- * Generate a unique temporary directory path.
- *
- * @param tempDir - Base temporary directory (default: ".tmp")
- * @returns Absolute path to unique temp directory
- *
- * @example
- * ```typescript
- * getTempDir() // "/workspaces/project/.tmp/cli-1647261462000-abc123"
- * getTempDir('/tmp') // "/tmp/cli-1647261462000-abc123"
- * ```
- */
-export function getTempDir(tempDir = '.tmp') {
-    const randomId = Math.random().toString(36).substring(2, 11);
-    const basePath = path.isAbsolute(tempDir)
-        ? tempDir
-        : path.join(process.cwd(), tempDir);
-    return path.join(basePath, `cli-${Date.now()}-${randomId}`);
-}
-/**
- * Load JSON from inline string, file path, or URL.
- *
- * Supports three input formats:
- * 1. Inline JSON string - parsed directly
- * 2. Local file path - read and parsed
- * 3. HTTP/HTTPS URL - downloaded and parsed
- *
- * Detection priority:
- * 1. URL (http://, https://) → download and parse
- * 2. Existing file path → read and parse
- * 3. Valid JSON string → parse directly
- * 4. Simple string → treat as {name: string} for backward compatibility
- *
- * @param source - JSON string, file path, or URL
- * @param options - Optional configuration
- * @param options.name - Parameter name for error messages (e.g., "event", "config")
- * @param options.required - Throw error if source is empty (default: false)
- * @param options.fallback - Default value if source is empty
- * @returns Parsed JSON object
- * @throws Error if source is required but empty, or if loading/parsing fails
- *
- * @example
- * ```typescript
- * // Inline JSON
- * await loadJsonFromSource('{"name":"order complete","data":{}}')
- *
- * // File path
- * await loadJsonFromSource('./examples/event.json')
- *
- * // URL
- * await loadJsonFromSource('https://example.com/event.json')
- *
- * // With options
- * await loadJsonFromSource(input, {
- *   name: 'event',
- *   required: true,
- *   fallback: { name: 'default' }
- * })
- * ```
- */
-export async function loadJsonFromSource(source, options) {
-    const paramName = options?.name || 'input';
-    // Handle empty/undefined input
-    if (!source || source.trim() === '') {
-        if (options?.required) {
-            throw new Error(`${paramName} is required`);
-        }
-        if (options?.fallback !== undefined) {
-            return options.fallback;
-        }
-        return {};
-    }
-    const trimmedSource = source.trim();
-    // 1. Check if URL
-    if (isUrl(trimmedSource)) {
-        try {
-            const tempPath = await downloadFromUrl(trimmedSource);
-            try {
-                const data = await fs.readJson(tempPath);
-                return data;
-            }
-            finally {
-                // Clean up temp file
-                try {
-                    await fs.remove(tempPath);
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-            }
-        }
-        catch (error) {
-            throw new Error(`Failed to load ${paramName} from URL ${trimmedSource}: ${getErrorMessage(error)}`);
-        }
-    }
-    // 2. Check if file path exists
-    const resolvedPath = path.resolve(trimmedSource);
-    if (await fs.pathExists(resolvedPath)) {
-        try {
-            const data = await fs.readJson(resolvedPath);
-            return data;
-        }
-        catch (error) {
-            throw new Error(`Failed to parse ${paramName} from file ${trimmedSource}: ${getErrorMessage(error)}`);
-        }
-    }
-    // 3. Try to parse as inline JSON
-    try {
-        const parsed = JSON.parse(trimmedSource);
-        return parsed;
-    }
-    catch (jsonError) {
-        // 4. Fallback: treat as event name string for backward compatibility
-        // This allows simple strings like "page view" to work
-        if (!trimmedSource.startsWith('{') && !trimmedSource.startsWith('[')) {
-            return { name: trimmedSource };
-        }
-        // If it looks like JSON but failed to parse, throw helpful error
-        throw new Error(`Failed to parse ${paramName}. Input appears to be JSON but contains errors: ${jsonError instanceof Error ? jsonError.message : String(jsonError)}`);
-    }
-}
-//# sourceMappingURL=utils.js.map

package/dist/config/utils.js.map

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

package/dist/config/validators.d.ts

@@ -1,52 +0,0 @@
-/**
- * Configuration Type Guards and Validators
- *
- * Type checking utilities for configuration validation.
- * Uses Zod schemas from @walkeros/core for Flow.Setup validation.
- */
-import type { Flow } from '@walkeros/core';
-/**
- * Type guard: Check if value is a plain object.
- */
-export declare function isObject(value: unknown): value is Record<string, unknown>;
-/**
- * Detect platform from flow config.
- *
- * Platform is determined by the presence of `web` or `server` key.
- */
-export declare function detectPlatform(flowConfig: Record<string, unknown>): 'web' | 'server' | undefined;
-/**
- * Type guard: Check if config is a valid Flow.Setup structure.
- *
- * @remarks
- * Uses Zod validation from @walkeros/core.
- * Returns false instead of throwing on invalid input.
- *
- * @example
- * ```typescript
- * if (isFlowSetup(config)) {
- *   const flowConfig = getFlowConfig(config, 'production');
- * }
- * ```
- */
-export declare function isFlowSetup(data: unknown): data is Flow.Setup;
-/**
- * Validate Flow.Setup and throw descriptive error if invalid.
- *
- * @remarks
- * Uses Zod validation from @walkeros/core.
- * Provides detailed error messages from Zod.
- *
- * @param data - Raw configuration data
- * @returns Validated Flow.Setup
- * @throws Error with descriptive message if validation fails
- */
-export declare function validateFlowSetup(data: unknown): Flow.Setup;
-/**
- * Get available flow names from a Flow.Setup.
- *
- * @param setup - Flow.Setup configuration
- * @returns Array of flow names
- */
-export declare function getAvailableFlows(setup: Flow.Setup): string[];
-//# sourceMappingURL=validators.d.ts.map

package/dist/config/validators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/config/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAK3C;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,KAAK,GAAG,QAAQ,GAAG,SAAS,CAQ9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAG7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAkB3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,CAE7D"}

package/dist/config/validators.js

@@ -1,85 +0,0 @@
-/**
- * Configuration Type Guards and Validators
- *
- * Type checking utilities for configuration validation.
- * Uses Zod schemas from @walkeros/core for Flow.Setup validation.
- */
-import { schemas } from '@walkeros/core/dev';
-const { safeParseSetup } = schemas;
-/**
- * Type guard: Check if value is a plain object.
- */
-export function isObject(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        !Array.isArray(value) &&
-        Object.prototype.toString.call(value) === '[object Object]');
-}
-/**
- * Detect platform from flow config.
- *
- * Platform is determined by the presence of `web` or `server` key.
- */
-export function detectPlatform(flowConfig) {
-    if ('web' in flowConfig && flowConfig.web !== undefined) {
-        return 'web';
-    }
-    if ('server' in flowConfig && flowConfig.server !== undefined) {
-        return 'server';
-    }
-    return undefined;
-}
-/**
- * Type guard: Check if config is a valid Flow.Setup structure.
- *
- * @remarks
- * Uses Zod validation from @walkeros/core.
- * Returns false instead of throwing on invalid input.
- *
- * @example
- * ```typescript
- * if (isFlowSetup(config)) {
- *   const flowConfig = getFlowConfig(config, 'production');
- * }
- * ```
- */
-export function isFlowSetup(data) {
-    const result = safeParseSetup(data);
-    return result.success;
-}
-/**
- * Validate Flow.Setup and throw descriptive error if invalid.
- *
- * @remarks
- * Uses Zod validation from @walkeros/core.
- * Provides detailed error messages from Zod.
- *
- * @param data - Raw configuration data
- * @returns Validated Flow.Setup
- * @throws Error with descriptive message if validation fails
- */
-export function validateFlowSetup(data) {
-    const result = safeParseSetup(data);
-    if (!result.success) {
-        // Format Zod errors for CLI display
-        const errors = result.error.issues
-            .map((issue) => {
-            const path = issue.path.length > 0 ? issue.path.map(String).join('.') : 'root';
-            return `  - ${path}: ${issue.message}`;
-        })
-            .join('\n');
-        throw new Error(`Invalid configuration:\n${errors}`);
-    }
-    // Cast to Flow.Setup since Zod's inferred type is compatible but not identical
-    return result.data;
-}
-/**
- * Get available flow names from a Flow.Setup.
- *
- * @param setup - Flow.Setup configuration
- * @returns Array of flow names
- */
-export function getAvailableFlows(setup) {
-    return Object.keys(setup.flows);
-}
-//# sourceMappingURL=validators.js.map