@synergenius/flow-weaver 0.33.1 → 0.44.0

package/dist/cli/utils/logger.js

@@ -1,126 +0,0 @@
-/* eslint-disable no-console */
-/**
- * CLI logging utility with colors and formatting
- */
-import pc from 'picocolors';
-const isTTY = process.stdout.isTTY === true;
-// Spinner frames
-const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-export const logger = {
-    info(message) {
-        console.log(`${pc.blue('ℹ')} ${message}`);
-    },
-    success(message) {
-        console.log(`${pc.green('✓')} ${message}`);
-    },
-    error(message) {
-        console.error(`${pc.red('✗')} ${message}`);
-    },
-    warn(message) {
-        console.warn(`${pc.yellow('⚠')} ${message}`);
-    },
-    debug(message) {
-        if (process.env.DEBUG) {
-            console.log(`${pc.dim('🔍')} ${pc.dim(message)}`);
-        }
-    },
-    log(message) {
-        console.log(message);
-    },
-    newline() {
-        console.log();
-    },
-    section(title) {
-        console.log();
-        console.log(`  ${pc.bold(title)}`);
-        console.log();
-    },
-    progress(current, total, item) {
-        console.log(`${pc.dim(`[${current}/${total}]`)} ${item}`);
-    },
-    // --- Formatting helpers ---
-    dim(message) {
-        return pc.dim(message);
-    },
-    bold(message) {
-        return pc.bold(message);
-    },
-    highlight(value) {
-        return pc.cyan(value);
-    },
-    // --- Branded output ---
-    banner(version) {
-        console.log(`  ${pc.bold(pc.cyan('flow-weaver'))} ${pc.dim(`v${version}`)}`);
-    },
-    // --- Table output ---
-    table(rows) {
-        if (rows.length === 0)
-            return;
-        const col0 = Math.max(...rows.map((r) => r[0].length)) + 2;
-        const col1 = Math.max(...rows.map((r) => r[1].length)) + 2;
-        for (const [label, value, status] of rows) {
-            const line = `  ${label.padEnd(col0)}${value.padEnd(col1)}${status ?? ''}`;
-            console.log(line);
-        }
-    },
-    // --- Spinner ---
-    spinner(message) {
-        if (!isTTY) {
-            // Non-TTY: print a static line
-            process.stderr.write(`  ${message}\n`);
-            return {
-                stop(msg) { if (msg)
-                    process.stderr.write(`  ${pc.green('✓')} ${msg}\n`); },
-                fail(msg) { if (msg)
-                    process.stderr.write(`  ${pc.red('✗')} ${msg}\n`); },
-                update() { },
-            };
-        }
-        let frame = 0;
-        let text = message;
-        const interval = setInterval(() => {
-            const spinner = pc.cyan(SPINNER_FRAMES[frame % SPINNER_FRAMES.length]);
-            process.stderr.write(`\r\x1b[K  ${spinner} ${text}`);
-            frame++;
-        }, 80);
-        const clear = () => {
-            clearInterval(interval);
-            process.stderr.write('\r\x1b[K');
-        };
-        return {
-            stop(msg) {
-                clear();
-                if (msg)
-                    process.stderr.write(`  ${pc.green('✓')} ${msg}\n`);
-            },
-            fail(msg) {
-                clear();
-                if (msg)
-                    process.stderr.write(`  ${pc.red('✗')} ${msg}\n`);
-            },
-            update(msg) {
-                text = msg;
-            },
-        };
-    },
-    // --- Timer ---
-    timer() {
-        const start = performance.now();
-        return {
-            elapsed() {
-                const ms = performance.now() - start;
-                if (ms < 1000)
-                    return `${Math.round(ms)}ms`;
-                if (ms < 60_000)
-                    return `${(ms / 1000).toFixed(1)}s`;
-                const mins = Math.floor(ms / 60_000);
-                const secs = Math.round((ms % 60_000) / 1000);
-                return `${mins}m ${secs}s`;
-            },
-            ms() {
-                return Math.round(performance.now() - start);
-            },
-        };
-    },
-};
-//# sourceMappingURL=logger.js.map

package/dist/cli/utils/parse-int-strict.js

@@ -1,17 +0,0 @@
-/**
- * Strict integer parser for CLI options.
- * Unlike parseInt, rejects partial matches ("12abc") and non-numeric values.
- * Throws a clear error instead of silently returning NaN.
- */
-export function parseIntStrict(value) {
-    const trimmed = value.trim();
-    if (trimmed === '') {
-        throw new Error(`"${value}" is not a valid number`);
-    }
-    const n = Number(trimmed);
-    if (!Number.isFinite(n) || !Number.isInteger(n)) {
-        throw new Error(`"${value}" is not a valid number`);
-    }
-    return n;
-}
-//# sourceMappingURL=parse-int-strict.js.map

package/dist/cli/utils/safe-write.js

@@ -1,54 +0,0 @@
-/**
- * Cross-platform safe file writing utilities.
- *
- * - Creates parent directories automatically
- * - Provides clear error messages for permission issues
- * - Works on Windows, macOS, and Linux
- */
-import * as fs from 'fs';
-import * as path from 'path';
-function ensureDir(dirPath) {
-    if (!fs.existsSync(dirPath)) {
-        fs.mkdirSync(dirPath, { recursive: true });
-    }
-}
-function wrapIOError(filePath, error) {
-    if (error instanceof Error) {
-        const code = error.code;
-        if (code === 'EACCES' || code === 'EPERM') {
-            throw new Error(`Permission denied: cannot write to ${filePath}. Check file/directory permissions.`);
-        }
-        if (code === 'EROFS') {
-            throw new Error(`Read-only file system: cannot write to ${filePath}.`);
-        }
-        throw error;
-    }
-    throw error;
-}
-/**
- * Write content to a file, creating parent directories as needed.
- * Throws a clear error on permission issues.
- */
-export function safeWriteFile(filePath, content, encoding = 'utf8') {
-    try {
-        ensureDir(path.dirname(filePath));
-        fs.writeFileSync(filePath, content, encoding);
-    }
-    catch (error) {
-        wrapIOError(filePath, error);
-    }
-}
-/**
- * Append content to a file, creating the file and parent directories as needed.
- * Throws a clear error on permission issues.
- */
-export function safeAppendFile(filePath, content, encoding = 'utf8') {
-    try {
-        ensureDir(path.dirname(filePath));
-        fs.appendFileSync(filePath, content, encoding);
-    }
-    catch (error) {
-        wrapIOError(filePath, error);
-    }
-}
-//# sourceMappingURL=safe-write.js.map

package/dist/deployment/config/defaults.d.ts

@@ -1,29 +0,0 @@
-/**
- * Default configuration values for the deployment system
- */
-import type { DeploymentConfig, ServerConfig, ExecutionConfig, SecretsConfig } from './types.js';
-/**
- * Default server configuration
- */
-export declare const DEFAULT_SERVER_CONFIG: ServerConfig;
-/**
- * Default execution configuration
- */
-export declare const DEFAULT_EXECUTION_CONFIG: ExecutionConfig;
-/**
- * Default secrets configuration
- */
-export declare const DEFAULT_SECRETS_CONFIG: SecretsConfig;
-/**
- * Default deployment configuration
- */
-export declare const DEFAULT_CONFIG: DeploymentConfig;
-/**
- * Production configuration overrides
- */
-export declare const PRODUCTION_OVERRIDES: Partial<DeploymentConfig>;
-/**
- * Get default configuration for a given environment
- */
-export declare function getDefaultConfig(environment: 'development' | 'staging' | 'production'): DeploymentConfig;
-//# sourceMappingURL=defaults.d.ts.map

package/dist/deployment/config/defaults.js

@@ -1,98 +0,0 @@
-/**
- * Default configuration values for the deployment system
- */
-/**
- * Default server configuration
- */
-export const DEFAULT_SERVER_CONFIG = {
-    port: 3000,
-    host: '0.0.0.0',
-    cors: {
-        origin: '*',
-        methods: ['GET', 'POST', 'OPTIONS'],
-        headers: ['Content-Type', 'Authorization', 'X-Request-Id'],
-        credentials: false,
-    },
-    swagger: false,
-    watch: true,
-};
-/**
- * Default execution configuration
- */
-export const DEFAULT_EXECUTION_CONFIG = {
-    timeout: 30000,
-    includeTrace: true,
-    maxConcurrent: 10,
-    retry: {
-        maxRetries: 0,
-        initialDelay: 100,
-        maxDelay: 5000,
-        backoffMultiplier: 2,
-    },
-};
-/**
- * Default secrets configuration
- */
-export const DEFAULT_SECRETS_CONFIG = {
-    fromEnv: [],
-    files: ['.env', '.env.local'],
-};
-/**
- * Default deployment configuration
- */
-export const DEFAULT_CONFIG = {
-    environment: 'development',
-    server: DEFAULT_SERVER_CONFIG,
-    execution: DEFAULT_EXECUTION_CONFIG,
-    secrets: DEFAULT_SECRETS_CONFIG,
-};
-/**
- * Production configuration overrides
- */
-export const PRODUCTION_OVERRIDES = {
-    environment: 'production',
-    server: {
-        ...DEFAULT_SERVER_CONFIG,
-        watch: false,
-        cors: {
-            ...DEFAULT_SERVER_CONFIG.cors,
-            origin: [], // Must be explicitly configured in production
-        },
-    },
-    execution: {
-        ...DEFAULT_EXECUTION_CONFIG,
-        includeTrace: false,
-        timeout: 60000,
-    },
-};
-/**
- * Get default configuration for a given environment
- */
-export function getDefaultConfig(environment) {
-    if (environment === 'production') {
-        return {
-            ...DEFAULT_CONFIG,
-            ...PRODUCTION_OVERRIDES,
-            server: {
-                ...DEFAULT_CONFIG.server,
-                ...PRODUCTION_OVERRIDES.server,
-            },
-            execution: {
-                ...DEFAULT_CONFIG.execution,
-                ...PRODUCTION_OVERRIDES.execution,
-            },
-        };
-    }
-    if (environment === 'staging') {
-        return {
-            ...DEFAULT_CONFIG,
-            environment: 'staging',
-            execution: {
-                ...DEFAULT_CONFIG.execution,
-                includeTrace: true, // Keep traces in staging for debugging
-            },
-        };
-    }
-    return DEFAULT_CONFIG;
-}
-//# sourceMappingURL=defaults.js.map

package/dist/deployment/config/loader.d.ts

@@ -1,24 +0,0 @@
-/**
- * Configuration loader
- *
- * Loads configuration from files, environment variables, and CLI arguments,
- * merging them in order of precedence.
- */
-import type { DeploymentConfig, CliConfigOverrides } from './types.js';
-/**
- * Load configuration with the following precedence (highest to lowest):
- * 1. CLI arguments
- * 2. Environment variables
- * 3. Config file
- * 4. Default values
- */
-export declare function loadConfig(cliOverrides?: CliConfigOverrides, configPath?: string): Promise<DeploymentConfig>;
-/**
- * Synchronous config loading (for simpler use cases)
- */
-export declare function loadConfigSync(cliOverrides?: CliConfigOverrides): DeploymentConfig;
-/**
- * Get a specific config value with fallback to default
- */
-export declare function getConfigValue<K extends keyof DeploymentConfig>(key: K, config?: Partial<DeploymentConfig>): DeploymentConfig[K];
-//# sourceMappingURL=loader.d.ts.map

package/dist/deployment/config/loader.js

@@ -1,237 +0,0 @@
-/**
- * Configuration loader
- *
- * Loads configuration from files, environment variables, and CLI arguments,
- * merging them in order of precedence.
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { pathToFileURL } from 'url';
-import * as YAML from 'js-yaml';
-import { DEFAULT_CONFIG, getDefaultConfig } from './defaults.js';
-/**
- * Configuration file names to search for
- */
-const CONFIG_FILE_NAMES = ['flow-weaver.config.ts', 'flow-weaver.config.yaml'];
-/**
- * Environment variable prefix
- */
-const ENV_PREFIX = 'FW_';
-/**
- * Load configuration with the following precedence (highest to lowest):
- * 1. CLI arguments
- * 2. Environment variables
- * 3. Config file
- * 4. Default values
- */
-export async function loadConfig(cliOverrides, configPath) {
-    // Start with environment-specific defaults
-    const environment = detectEnvironment(cliOverrides);
-    let config = getDefaultConfig(environment);
-    // Load config file if it exists
-    const fileConfig = await loadConfigFile(configPath);
-    if (fileConfig) {
-        config = mergeConfig(config, fileConfig);
-    }
-    // Apply environment variable overrides
-    const envConfig = loadEnvConfig();
-    config = mergeConfig(config, envConfig);
-    // Apply CLI overrides (highest precedence)
-    if (cliOverrides) {
-        const cliConfig = convertCliOverrides(cliOverrides);
-        config = mergeConfig(config, cliConfig);
-    }
-    return config;
-}
-/**
- * Detect environment from CLI, env vars, or defaults
- */
-function detectEnvironment(cliOverrides) {
-    // CLI override takes precedence
-    if (cliOverrides?.env) {
-        return cliOverrides.env;
-    }
-    // Check environment variables
-    const envValue = process.env[`${ENV_PREFIX}ENV`] || process.env.NODE_ENV;
-    if (envValue) {
-        if (envValue === 'production' || envValue === 'prod') {
-            return 'production';
-        }
-        if (envValue === 'staging' || envValue === 'stage') {
-            return 'staging';
-        }
-    }
-    return 'development';
-}
-/**
- * Load configuration from file
- */
-async function loadConfigFile(configPath) {
-    // If a specific path is provided, try to load it
-    if (configPath) {
-        return loadConfigFromPath(configPath);
-    }
-    // Search for config file in current directory
-    const cwd = process.cwd();
-    for (const fileName of CONFIG_FILE_NAMES) {
-        const configFilePath = path.join(cwd, fileName);
-        if (fs.existsSync(configFilePath)) {
-            return loadConfigFromPath(configFilePath);
-        }
-    }
-    return null;
-}
-/**
- * Load configuration from a specific file path
- */
-async function loadConfigFromPath(filePath) {
-    const absolutePath = path.resolve(filePath);
-    if (!fs.existsSync(absolutePath)) {
-        return null;
-    }
-    const ext = path.extname(absolutePath);
-    // YAML files
-    if (ext === '.yaml' || ext === '.yml') {
-        try {
-            const content = fs.readFileSync(absolutePath, 'utf8');
-            return YAML.load(content);
-        }
-        catch {
-            return null;
-        }
-    }
-    // TypeScript files - dynamic import
-    if (ext === '.ts') {
-        try {
-            const module = await import(pathToFileURL(absolutePath).href);
-            return (module.default || module);
-        }
-        catch {
-            // Config file loading failed, skip it
-            return null;
-        }
-    }
-    return null;
-}
-/**
- * Load configuration from environment variables
- */
-function loadEnvConfig() {
-    const config = {};
-    // Server config
-    const port = process.env[`${ENV_PREFIX}PORT`];
-    const host = process.env[`${ENV_PREFIX}HOST`];
-    const cors = process.env[`${ENV_PREFIX}CORS_ORIGIN`];
-    if (port || host || cors) {
-        config.server = {};
-        if (port)
-            config.server.port = parseInt(port, 10);
-        if (host)
-            config.server.host = host;
-        if (cors)
-            config.server.cors = { origin: cors };
-    }
-    // Execution config
-    const timeout = process.env[`${ENV_PREFIX}TIMEOUT`];
-    const trace = process.env[`${ENV_PREFIX}TRACE`];
-    if (timeout || trace) {
-        config.execution = {};
-        if (timeout)
-            config.execution.timeout = parseInt(timeout, 10);
-        if (trace)
-            config.execution.includeTrace = trace === 'true' || trace === '1';
-    }
-    return config;
-}
-/**
- * Convert CLI overrides to partial config
- */
-function convertCliOverrides(overrides) {
-    const config = {};
-    if (overrides.env) {
-        config.environment = overrides.env;
-    }
-    // Server overrides
-    if (overrides.port ||
-        overrides.host ||
-        overrides.cors ||
-        overrides.watch !== undefined ||
-        overrides.swagger !== undefined) {
-        config.server = {};
-        if (overrides.port)
-            config.server.port = overrides.port;
-        if (overrides.host)
-            config.server.host = overrides.host;
-        if (overrides.cors)
-            config.server.cors = { origin: overrides.cors };
-        if (overrides.watch !== undefined)
-            config.server.watch = overrides.watch;
-        if (overrides.swagger !== undefined)
-            config.server.swagger = overrides.swagger;
-    }
-    // Execution overrides
-    if (overrides.timeout || overrides.trace !== undefined || overrides.production !== undefined) {
-        config.execution = {};
-        if (overrides.timeout)
-            config.execution.timeout = overrides.timeout;
-        if (overrides.trace !== undefined)
-            config.execution.includeTrace = overrides.trace;
-        if (overrides.production)
-            config.execution.includeTrace = false;
-    }
-    return config;
-}
-/**
- * Deep merge two configuration objects
- */
-function mergeConfig(base, override) {
-    return {
-        environment: override.environment ?? base.environment,
-        server: {
-            ...base.server,
-            ...override.server,
-            cors: {
-                ...base.server.cors,
-                ...(override.server?.cors || {}),
-            },
-        },
-        execution: {
-            ...base.execution,
-            ...override.execution,
-            retry: {
-                ...(base.execution.retry || {}),
-                ...(override.execution?.retry || {}),
-            },
-        },
-        secrets: {
-            ...base.secrets,
-            ...override.secrets,
-        },
-    };
-}
-/**
- * Synchronous config loading (for simpler use cases)
- */
-export function loadConfigSync(cliOverrides) {
-    const environment = detectEnvironment(cliOverrides);
-    let config = getDefaultConfig(environment);
-    // Apply environment variable overrides
-    const envConfig = loadEnvConfig();
-    config = mergeConfig(config, envConfig);
-    // Apply CLI overrides
-    if (cliOverrides) {
-        const cliConfig = convertCliOverrides(cliOverrides);
-        config = mergeConfig(config, cliConfig);
-    }
-    return config;
-}
-/**
- * Get a specific config value with fallback to default
- */
-export function getConfigValue(key, config) {
-    if (config && config[key] !== undefined) {
-        return config[key];
-    }
-    return DEFAULT_CONFIG[key];
-}
-//# sourceMappingURL=loader.js.map

package/dist/deployment/config/types.d.ts

@@ -1,117 +0,0 @@
-/**
- * Configuration types for the deployment system
- */
-import type { Environment } from '../types.js';
-/**
- * Complete deployment configuration
- */
-export interface DeploymentConfig {
-    /** Runtime environment */
-    environment: Environment;
-    /** Server configuration */
-    server: ServerConfig;
-    /** Execution configuration */
-    execution: ExecutionConfig;
-    /** Secrets and environment variable configuration */
-    secrets: SecretsConfig;
-}
-/**
- * Server configuration options
- */
-export interface ServerConfig {
-    /** Port to listen on */
-    port: number;
-    /** Host to bind to */
-    host: string;
-    /** CORS configuration */
-    cors: CorsConfig;
-    /** Enable Swagger UI */
-    swagger: boolean;
-    /** Enable file watching for hot reload */
-    watch: boolean;
-}
-/**
- * CORS configuration
- */
-export interface CorsConfig {
-    /** Allowed origins (string or array of strings) */
-    origin: string | string[];
-    /** Allowed methods */
-    methods?: string[];
-    /** Allowed headers */
-    headers?: string[];
-    /** Expose headers */
-    exposeHeaders?: string[];
-    /** Allow credentials */
-    credentials?: boolean;
-    /** Max age for preflight cache */
-    maxAge?: number;
-}
-/**
- * Execution configuration
- */
-export interface ExecutionConfig {
-    /** Default timeout in milliseconds */
-    timeout: number;
-    /** Include execution trace by default */
-    includeTrace: boolean;
-    /** Maximum concurrent executions */
-    maxConcurrent?: number;
-    /** Retry configuration */
-    retry?: RetryConfig;
-}
-/**
- * Retry configuration
- */
-export interface RetryConfig {
-    /** Maximum number of retries */
-    maxRetries: number;
-    /** Initial delay in milliseconds */
-    initialDelay: number;
-    /** Maximum delay in milliseconds */
-    maxDelay: number;
-    /** Backoff multiplier */
-    backoffMultiplier: number;
-}
-/**
- * Secrets and environment variable configuration
- */
-export interface SecretsConfig {
-    /** Environment variables to inject into execution context */
-    fromEnv: string[];
-    /** .env files to load */
-    files: string[];
-}
-/**
- * Partial configuration for merging
- */
-export type PartialDeploymentConfig = {
-    environment?: Environment;
-    server?: Partial<ServerConfig>;
-    execution?: Partial<ExecutionConfig>;
-    secrets?: Partial<SecretsConfig>;
-};
-/**
- * CLI argument overrides
- */
-export interface CliConfigOverrides {
-    /** Override port */
-    port?: number;
-    /** Override host */
-    host?: string;
-    /** Override environment */
-    env?: Environment;
-    /** Override CORS origin */
-    cors?: string;
-    /** Override timeout */
-    timeout?: number;
-    /** Override trace inclusion */
-    trace?: boolean;
-    /** Override file watching */
-    watch?: boolean;
-    /** Enable swagger */
-    swagger?: boolean;
-    /** Production mode */
-    production?: boolean;
-}
-//# sourceMappingURL=types.d.ts.map