@walkeros/cli 0.5.1-next.0 → 0.7.0-next.0

package/dist/commands/run/index.js

@@ -0,0 +1,191 @@
+/**
+ * Run Command
+ *
+ * Runs walkerOS flows using @walkeros/docker as a library
+ * No Docker daemon required - runs directly in Node.js
+ */
+import path from 'path';
+import { createCommandLogger, createTimer, getExecutionMode, getErrorMessage, executeRunInDocker, isDockerAvailable, } from '../../core/index.js';
+import { validateMode, validateFlowFile, validatePort } from './validators.js';
+import { prepareBundleForRun, isPreBuiltConfig } from './utils.js';
+import { executeRunLocal } from './execution.js';
+/**
+ * CLI command function for `walkeros run`
+ *
+ * @param mode - Run mode (collect | serve)
+ * @param options - Command options
+ */
+export async function runCommand(mode, options) {
+    const timer = createTimer();
+    timer.start();
+    const logger = createCommandLogger(options);
+    try {
+        // Step 1: Validate inputs
+        validateMode(mode);
+        const configPath = validateFlowFile(options.config);
+        if (options.port !== undefined) {
+            validatePort(options.port);
+        }
+        // Step 2: Determine if config is pre-built or needs bundling
+        const isPreBuilt = isPreBuiltConfig(configPath);
+        let flowPath = null;
+        if (mode === 'collect') {
+            if (isPreBuilt) {
+                // Use pre-built bundle directly
+                flowPath = path.resolve(configPath);
+                if (!options.json && !options.silent) {
+                    logger.info(`📦 Using pre-built flow: ${path.basename(flowPath)}`);
+                }
+            }
+            else {
+                // Bundle JSON config first
+                if (!options.json && !options.silent) {
+                    logger.info('🔨 Building flow bundle...');
+                }
+                flowPath = await prepareBundleForRun(configPath, {
+                    verbose: options.verbose,
+                    silent: options.json || options.silent,
+                });
+                if (!options.json && !options.silent) {
+                    logger.success('✅ Bundle ready');
+                }
+            }
+        }
+        // Step 3: Execute based on mode
+        const executionMode = getExecutionMode(options);
+        // Handle dry-run
+        if (options.dryRun) {
+            if (executionMode === 'docker') {
+                logger.info(`[DRY-RUN] Would execute in Docker: run ${mode} with runtime image`);
+            }
+            else {
+                logger.info(`[DRY-RUN] Would execute locally: run ${mode}`);
+            }
+            return;
+        }
+        if (executionMode === 'docker') {
+            // Docker mode: Use production runtime image
+            const dockerAvailable = await isDockerAvailable();
+            if (!dockerAvailable) {
+                throw new Error('Docker is not available. Please install Docker or use --local flag to execute locally.');
+            }
+            if (!options.json && !options.silent) {
+                logger.info('🐳 Executing in production runtime container...');
+            }
+            await executeRunInDocker(mode, flowPath, {
+                port: options.port,
+                host: options.host,
+                serveName: options.serveName,
+                servePath: options.servePath,
+                silent: options.silent,
+            });
+        }
+        else {
+            // Local mode: Use library functions
+            if (!options.json && !options.silent) {
+                const modeLabel = mode === 'collect' ? 'Collector' : 'Server';
+                logger.info(`🖥️  Starting ${modeLabel} locally...`);
+            }
+            await executeRunLocal(mode, flowPath, {
+                port: options.port,
+                host: options.host,
+                serveName: options.serveName,
+                servePath: options.servePath,
+            });
+        }
+        // Note: Both Docker and local modes run forever, so we won't reach here unless they fail
+    }
+    catch (error) {
+        const duration = timer.getElapsed() / 1000;
+        const errorMessage = getErrorMessage(error);
+        if (options.json) {
+            const output = {
+                success: false,
+                mode,
+                error: errorMessage,
+                duration,
+            };
+            // eslint-disable-next-line no-console
+            console.log(JSON.stringify(output, null, 2));
+        }
+        else {
+            logger.error('❌ Run failed:');
+            logger.error(errorMessage);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Programmatic run function
+ *
+ * @param mode - Run mode (collect | serve)
+ * @param options - Run options
+ * @returns Run result
+ *
+ * @example
+ * ```typescript
+ * // Run with JSON config (bundles automatically)
+ * await run('collect', {
+ *   config: './flow.json',
+ *   port: 8080
+ * });
+ *
+ * // Run with pre-built bundle
+ * await run('collect', {
+ *   config: './flow.mjs',
+ *   port: 8080
+ * });
+ * ```
+ */
+export async function run(mode, options) {
+    const startTime = Date.now();
+    try {
+        // Validate inputs
+        validateMode(mode);
+        let flowFile;
+        if (typeof options.config === 'string') {
+            flowFile = validateFlowFile(options.config);
+        }
+        else {
+            throw new Error('Programmatic run() requires config file path');
+        }
+        if (options.port !== undefined) {
+            validatePort(options.port);
+        }
+        // Determine if config is pre-built or needs bundling
+        const isPreBuilt = isPreBuiltConfig(flowFile);
+        let flowPath;
+        if (isPreBuilt) {
+            flowPath = path.resolve(flowFile);
+        }
+        else {
+            // Bundle JSON config
+            flowPath = await prepareBundleForRun(flowFile, {
+                verbose: options.verbose,
+                silent: true,
+            });
+        }
+        // Run the flow using Docker package
+        await executeRunLocal(mode, flowPath, {
+            port: options.port,
+            host: options.host,
+            serveName: options.serveName,
+            servePath: options.servePath,
+        });
+        // Success (though runFlow runs forever, so we typically don't reach here)
+        return {
+            success: true,
+            exitCode: 0,
+            duration: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            exitCode: 1,
+            duration: Date.now() - startTime,
+            error: getErrorMessage(error),
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/run/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,OAA0B;IAE1B,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,0BAA0B;QAC1B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,6DAA6D;QAC7D,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,QAAQ,GAAkB,IAAI,CAAC;QAEnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,UAAU,EAAE,CAAC;gBACf,gCAAgC;gBAChC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACrC,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,2BAA2B;gBAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACrC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;gBAC5C,CAAC;gBAED,QAAQ,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE;oBAC/C,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM;iBACvC,CAAC,CAAC;gBAEH,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACrC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEhD,iBAAiB;QACjB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CACT,0CAA0C,IAAI,qBAAqB,CACpE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC/B,4CAA4C;YAC5C,MAAM,eAAe,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAClD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,kBAAkB,CAAC,IAA2B,EAAE,QAAQ,EAAE;gBAC9D,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,SAAS,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,aAAa,CAAC,CAAC;YACvD,CAAC;YAED,MAAM,eAAe,CAAC,IAA2B,EAAE,QAAQ,EAAE;gBAC3D,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,yFAAyF;IAC3F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAE5C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG;gBACb,OAAO,EAAE,KAAK;gBACd,IAAI;gBACJ,KAAK,EAAE,YAAY;gBACnB,QAAQ;aACT,CAAC;YACF,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,IAAa,EACb,OAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,kBAAkB;QAClB,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,IAAI,QAAgB,CAAC;QACrB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvC,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,qDAAqD;QACrD,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,QAAgB,CAAC;QAErB,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,qBAAqB;YACrB,QAAQ,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE;gBAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE;YACpC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,0EAA0E;QAC1E,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;SAC9B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/run/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Run Command Types
+ *
+ * Types for running walkerOS flows via CLI using @walkeros/docker as a library
+ */
+import type { GlobalOptions } from '../../types/index.js';
+/**
+ * Run mode - determines which execution mode to use
+ */
+export type RunMode = 'collect' | 'serve';
+/**
+ * CLI command options for `walkeros run`
+ */
+export interface RunCommandOptions extends GlobalOptions {
+    /** Flow configuration file path (.json or pre-built .mjs) */
+    config: string;
+    /** Server port (overrides flow config) */
+    port?: number;
+    /** Server host (default: 0.0.0.0) */
+    host?: string;
+    /** Serve path (URL directory path, e.g., 'libs/v1') */
+    servePath?: string;
+    /** Serve name (filename in URL, default: walker.js) */
+    serveName?: string;
+    /** Enable JSON output */
+    json?: boolean;
+}
+/**
+ * Programmatic run options (subset of CLI options)
+ */
+export interface RunOptions {
+    /** Flow configuration file path (.json or pre-built .mjs) */
+    config: string | unknown;
+    /** Server port */
+    port?: number;
+    /** Server host */
+    host?: string;
+    /** Serve path (URL directory path, e.g., 'libs/v1') */
+    servePath?: string;
+    /** Serve name (filename in URL, default: walker.js) */
+    serveName?: string;
+    /** Suppress output */
+    silent?: boolean;
+    /** Verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Result from running a flow
+ */
+export interface RunResult {
+    /** Whether the flow ran successfully */
+    success: boolean;
+    /** Exit code */
+    exitCode: number;
+    /** Error message if failed */
+    error?: string;
+    /** Execution duration in milliseconds */
+    duration: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/run/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/run/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IAEjB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/commands/run/types.js

@@ -0,0 +1,7 @@
+/**
+ * Run Command Types
+ *
+ * Types for running walkerOS flows via CLI using @walkeros/docker as a library
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/run/types.js.map

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

package/dist/commands/run/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Run Command Utilities
+ *
+ * Shared utilities for the run command
+ */
+/**
+ * Prepares a JSON config file for execution by bundling it to a temporary location.
+ *
+ * Creates bundle in .tmp/ directory relative to config file (not /tmp)
+ * so Node.js module resolution finds node_modules.
+ *
+ * @param configPath - Path to the JSON configuration file
+ * @param options - Bundle options
+ * @param options.verbose - Enable verbose logging
+ * @param options.silent - Suppress output
+ * @returns Path to the bundled output file
+ */
+export declare function prepareBundleForRun(configPath: string, options: {
+    verbose?: boolean;
+    silent?: boolean;
+}): Promise<string>;
+/**
+ * Checks if a config file is pre-built or needs bundling
+ *
+ * @param configPath - Path to configuration file
+ * @returns True if file is pre-built (js/mjs/cjs), false if needs bundling (json)
+ */
+export declare function isPreBuiltConfig(configPath: string): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commands/run/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/commands/run/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAM5D"}

package/dist/commands/run/utils.js

@@ -0,0 +1,52 @@
+/**
+ * Run Command Utilities
+ *
+ * Shared utilities for the run command
+ */
+import path from 'path';
+import fs from 'fs-extra';
+import { bundle } from '../bundle/index.js';
+/**
+ * Prepares a JSON config file for execution by bundling it to a temporary location.
+ *
+ * Creates bundle in .tmp/ directory relative to config file (not /tmp)
+ * so Node.js module resolution finds node_modules.
+ *
+ * @param configPath - Path to the JSON configuration file
+ * @param options - Bundle options
+ * @param options.verbose - Enable verbose logging
+ * @param options.silent - Suppress output
+ * @returns Path to the bundled output file
+ */
+export async function prepareBundleForRun(configPath, options) {
+    // Create temp directory relative to config (ensures node_modules is findable)
+    const configDir = path.dirname(path.resolve(configPath));
+    const tempDir = path.join(configDir, '.tmp', `run-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`);
+    await fs.ensureDir(tempDir);
+    // Generate output path in temp directory
+    const tempPath = path.join(tempDir, 'bundle.mjs');
+    // Bundle with proper output override
+    await bundle(configPath, {
+        cache: true,
+        verbose: options.verbose,
+        silent: options.silent,
+        buildOverrides: {
+            output: tempPath,
+            format: 'esm',
+            platform: 'node',
+        },
+    });
+    return tempPath;
+}
+/**
+ * Checks if a config file is pre-built or needs bundling
+ *
+ * @param configPath - Path to configuration file
+ * @returns True if file is pre-built (js/mjs/cjs), false if needs bundling (json)
+ */
+export function isPreBuiltConfig(configPath) {
+    return (configPath.endsWith('.mjs') ||
+        configPath.endsWith('.js') ||
+        configPath.endsWith('.cjs'));
+}
+//# sourceMappingURL=utils.js.map

package/dist/commands/run/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/commands/run/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,OAGC;IAED,8EAA8E;IAC9E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,SAAS,EACT,MAAM,EACN,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAC9D,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE5B,yCAAyC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAElD,qCAAqC;IACrC,MAAM,MAAM,CAAC,UAAU,EAAE;QACvB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,cAAc,EAAE;YACd,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,MAAM;SACjB;KACF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC5B,CAAC;AACJ,CAAC"}

package/dist/commands/run/validators.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Run Command Validators
+ *
+ * Validation logic for run command inputs.
+ * Uses Zod schemas for type-safe validation.
+ */
+import { type RunMode } from '../../schemas/index.js';
+/**
+ * Validates run mode using Zod schema.
+ *
+ * @param mode - Mode to validate
+ * @throws Error if mode is invalid
+ */
+export declare function validateMode(mode: string): asserts mode is RunMode;
+/**
+ * Validates flow file exists.
+ *
+ * @remarks
+ * File existence cannot be validated by Zod, so this remains a custom check.
+ *
+ * @param filePath - Path to flow configuration file (bare name, relative, or absolute)
+ * @returns Absolute path to flow file
+ * @throws Error if file doesn't exist
+ */
+export declare function validateFlowFile(filePath: string): string;
+/**
+ * Validates port number using Zod schema.
+ *
+ * @param port - Port number to validate
+ * @throws Error if port is invalid
+ */
+export declare function validatePort(port: number): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/commands/run/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/commands/run/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CASlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAazD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAS/C"}

package/dist/commands/run/validators.js

@@ -0,0 +1,58 @@
+/**
+ * Run Command Validators
+ *
+ * Validation logic for run command inputs.
+ * Uses Zod schemas for type-safe validation.
+ */
+import { existsSync } from 'fs';
+import { resolveAsset } from '../../core/asset-resolver.js';
+import { RunModeSchema, PortSchema, } from '../../schemas/index.js';
+/**
+ * Validates run mode using Zod schema.
+ *
+ * @param mode - Mode to validate
+ * @throws Error if mode is invalid
+ */
+export function validateMode(mode) {
+    const result = RunModeSchema.safeParse(mode);
+    if (!result.success) {
+        throw new Error(`Invalid mode: "${mode}"\n` +
+            `   Valid modes: collect, serve\n` +
+            `   Example: walkeros run collect ./flow.json`);
+    }
+}
+/**
+ * Validates flow file exists.
+ *
+ * @remarks
+ * File existence cannot be validated by Zod, so this remains a custom check.
+ *
+ * @param filePath - Path to flow configuration file (bare name, relative, or absolute)
+ * @returns Absolute path to flow file
+ * @throws Error if file doesn't exist
+ */
+export function validateFlowFile(filePath) {
+    // Use asset resolver to handle bare names, relative paths, and absolute paths
+    const absolutePath = resolveAsset(filePath, 'bundle');
+    if (!existsSync(absolutePath)) {
+        throw new Error(`Flow file not found: ${filePath}\n` +
+            `   Resolved path: ${absolutePath}\n` +
+            `   Make sure the file exists and the path is correct`);
+    }
+    return absolutePath;
+}
+/**
+ * Validates port number using Zod schema.
+ *
+ * @param port - Port number to validate
+ * @throws Error if port is invalid
+ */
+export function validatePort(port) {
+    const result = PortSchema.safeParse(port);
+    if (!result.success) {
+        throw new Error(`Invalid port: ${port}\n` +
+            `   Port must be an integer between 1 and 65535\n` +
+            `   Example: --port 8080`);
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/commands/run/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../../src/commands/run/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,UAAU,GAEX,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,KAAK;YACzB,kCAAkC;YAClC,8CAA8C,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,8EAA8E;IAC9E,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,IAAI;YAClC,qBAAqB,YAAY,IAAI;YACrC,sDAAsD,CACzD,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,IAAI;YACvB,kDAAkD;YAClD,yBAAyB,CAC5B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/simulate/env-loader.d.ts

@@ -0,0 +1,19 @@
+interface DestinationEnv {
+    init?: Record<string, unknown>;
+    push: Record<string, unknown>;
+    simulation?: string[];
+}
+/**
+ * Dynamically loads env examples from destination packages.
+ *
+ * Imports from `/dev` subpath (e.g., '@walkeros/web-destination-gtag/dev')
+ * and extracts the `env` object which contains:
+ * - push: Mock environment with API functions (gtag, fbq, etc.)
+ * - simulation: Array of tracking paths for call verification
+ *
+ * @param destinations - Destination configuration from flow config
+ * @returns Map of destination key to env object
+ */
+export declare function loadDestinationEnvs(destinations: Record<string, unknown>): Promise<Record<string, DestinationEnv>>;
+export {};
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/commands/simulate/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../../src/commands/simulate/env-loader.ts"],"names":[],"mappings":"AAAA,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAyCzC"}

package/dist/commands/simulate/env-loader.js

@@ -0,0 +1,46 @@
+/**
+ * Dynamically loads env examples from destination packages.
+ *
+ * Imports from `/dev` subpath (e.g., '@walkeros/web-destination-gtag/dev')
+ * and extracts the `env` object which contains:
+ * - push: Mock environment with API functions (gtag, fbq, etc.)
+ * - simulation: Array of tracking paths for call verification
+ *
+ * @param destinations - Destination configuration from flow config
+ * @returns Map of destination key to env object
+ */
+export async function loadDestinationEnvs(destinations) {
+    const envs = {};
+    for (const [destKey, destConfig] of Object.entries(destinations)) {
+        const typedConfig = destConfig;
+        // Skip if no package field
+        if (!typedConfig.package) {
+            continue;
+        }
+        try {
+            // Determine import path
+            const packageName = typedConfig.package;
+            const isDemoPackage = packageName.includes('-demo');
+            const importPath = isDemoPackage ? packageName : `${packageName}/dev`;
+            // Dynamic import
+            const module = await import(importPath);
+            // Extract env from examples
+            const examplesModule = module.examples || module.default?.examples;
+            const envModule = examplesModule?.env;
+            if (envModule?.push) {
+                envs[destKey] = {
+                    init: envModule.init,
+                    push: envModule.push,
+                    simulation: envModule.simulation || [],
+                };
+            }
+        }
+        catch (error) {
+            // Silently skip destinations without env or invalid packages
+            // eslint-disable-next-line no-console
+            console.warn(`Warning: Could not load env for destination "${destKey}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return envs;
+}
+//# sourceMappingURL=env-loader.js.map

package/dist/commands/simulate/env-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.js","sourceRoot":"","sources":["../../../src/commands/simulate/env-loader.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAAqC;IAErC,MAAM,IAAI,GAAmC,EAAE,CAAC;IAEhD,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACjE,MAAM,WAAW,GAAG,UAA+B,CAAC;QAEpD,2BAA2B;QAC3B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,wBAAwB;YACxB,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC;YACxC,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,MAAM,CAAC;YAEtE,iBAAiB;YACjB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YAExC,4BAA4B;YAC5B,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;YACnE,MAAM,SAAS,GAAG,cAAc,EAAE,GAAG,CAAC;YAEtC,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,GAAG;oBACd,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,EAAE;iBACvC,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6DAA6D;YAC7D,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACV,gDAAgD,OAAO,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/simulate/index.d.ts

@@ -0,0 +1,48 @@
+import type { SimulateCommandOptions } from './types.js';
+/**
+ * CLI command handler for simulate command
+ */
+export declare function simulateCommand(options: SimulateCommandOptions): Promise<void>;
+/**
+ * High-level simulate function for programmatic usage.
+ *
+ * Handles configuration loading internally and returns structured results.
+ *
+ * @param configOrPath - Bundle configuration object or path to config file
+ * @param event - Event object to simulate
+ * @param options - Simulation options
+ * @param options.silent - Suppress all output (default: false)
+ * @param options.verbose - Enable verbose logging (default: false)
+ * @param options.json - Format output as JSON (default: false)
+ * @returns Simulation result with success status, elb result, and usage data
+ *
+ * @example
+ * ```typescript
+ * // With config file
+ * const result = await simulate('./walker.config.json', {
+ *   name: 'page view',
+ *   data: { title: 'Home Page', path: '/', url: 'https://example.com' }
+ * });
+ *
+ * // With config object
+ * const result = await simulate(
+ *   {
+ *     platform: 'web',
+ *     packages: { '@walkeros/collector': { imports: ['startFlow'] } },
+ *     code: '...',
+ *     output: './bundle.js'
+ *   },
+ *   { name: 'page view' },
+ *   { silent: true }
+ * );
+ * ```
+ */
+export declare function simulate(configOrPath: string | unknown, event: unknown, options?: {
+    silent?: boolean;
+    verbose?: boolean;
+    json?: boolean;
+}): Promise<import('./types').SimulationResult>;
+export * from './types.js';
+export * from './simulator.js';
+export { executeInNode } from './node-executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/simulate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/simulate/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,QAAQ,CAC5B,YAAY,EAAE,MAAM,GAAG,OAAO,EAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CACX,GACL,OAAO,CAAC,OAAO,SAAS,EAAE,gBAAgB,CAAC,CAgB7C;AAGD,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}