@walkeros/cli 0.3.1

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

@@ -0,0 +1,29 @@
+/**
+ * Run Command Validators
+ *
+ * Validation logic for run command inputs
+ */
+import type { RunMode } from './types';
+/**
+ * Validates run mode
+ *
+ * @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
+ *
+ * @param filePath - Path to flow configuration file
+ * @returns Absolute path to flow file
+ * @throws Error if file doesn't exist
+ */
+export declare function validateFlowFile(filePath: string): string;
+/**
+ * Validates port number
+ *
+ * @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;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAOvC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAQlE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ/C"}

package/dist/commands/run/validators.js

@@ -0,0 +1,54 @@
+/**
+ * Run Command Validators
+ *
+ * Validation logic for run command inputs
+ */
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Valid run modes
+ */
+const VALID_MODES = ['collect', 'serve'];
+/**
+ * Validates run mode
+ *
+ * @param mode - Mode to validate
+ * @throws Error if mode is invalid
+ */
+export function validateMode(mode) {
+    if (!VALID_MODES.includes(mode)) {
+        throw new Error(`Invalid mode: "${mode}"\n` +
+            `   Valid modes: ${VALID_MODES.join(', ')}\n` +
+            `   Example: walkeros run collect ./flow.json`);
+    }
+}
+/**
+ * Validates flow file exists
+ *
+ * @param filePath - Path to flow configuration file
+ * @returns Absolute path to flow file
+ * @throws Error if file doesn't exist
+ */
+export function validateFlowFile(filePath) {
+    const absolutePath = resolve(filePath);
+    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
+ *
+ * @param port - Port number to validate
+ * @throws Error if port is invalid
+ */
+export function validatePort(port) {
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        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;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,GAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAe,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,KAAK;YACzB,mBAAmB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC7C,8CAA8C,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,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,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,IAAI;YACvB,kDAAkD;YAClD,yBAAyB,CAC5B,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { SimulateCommandOptions } from './types';
+/**
+ * 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';
+export * from './simulator';
+//# 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":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Ef;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,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/commands/simulate/index.js

@@ -0,0 +1,121 @@
+import { simulateCore, parseEventInput, formatSimulationResult, } from './simulator';
+import { createLogger, executeCommand } from '../../core';
+/**
+ * CLI command handler for simulate command
+ */
+export async function simulateCommand(options) {
+    const logger = createLogger({
+        verbose: options.verbose,
+        silent: options.silent ?? false,
+        json: options.json,
+    });
+    // Build Docker args
+    const dockerArgs = [options.config];
+    if (options.event)
+        dockerArgs.push('--event', options.event);
+    if (options.json)
+        dockerArgs.push('--json');
+    if (options.verbose)
+        dockerArgs.push('--verbose');
+    if (options.silent)
+        dockerArgs.push('--silent');
+    await executeCommand(async () => {
+        const startTime = Date.now();
+        try {
+            // Parse event input
+            const event = parseEventInput(options.event);
+            // Execute simulation
+            const result = await simulateCore(options.config, event, {
+                json: options.json,
+                verbose: options.verbose,
+                silent: options.silent,
+            });
+            // Add duration to result
+            const resultWithDuration = {
+                ...result,
+                duration: (Date.now() - startTime) / 1000,
+            };
+            // Output results - create output logger that always logs
+            const outputLogger = createLogger({ silent: false, json: false });
+            const output = formatSimulationResult(resultWithDuration, {
+                json: options.json,
+            });
+            outputLogger.log('white', output);
+            // Exit with error code if simulation failed
+            if (!result.success) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (options.json) {
+                // JSON error output - create output logger that always logs
+                const outputLogger = createLogger({ silent: false, json: false });
+                const errorOutput = JSON.stringify({
+                    success: false,
+                    error: errorMessage,
+                    duration: (Date.now() - startTime) / 1000,
+                }, null, 2);
+                outputLogger.log('white', errorOutput);
+            }
+            else {
+                // Error output - create error logger that always logs
+                const errorLogger = createLogger({ silent: false, json: false });
+                errorLogger.error(`❌ Simulate command failed: ${errorMessage}`);
+            }
+            process.exit(1);
+        }
+    }, 'simulate', dockerArgs, options, logger);
+}
+/**
+ * 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 async function simulate(configOrPath, event, options = {}) {
+    // simulateCore currently only accepts file paths, so we need to handle that
+    // For now, if configOrPath is not a string, throw an error with guidance
+    if (typeof configOrPath !== 'string') {
+        throw new Error('simulate() currently only supports config file paths. ' +
+            'Config object support will be added in a future version. ' +
+            'Please provide a path to a configuration file.');
+    }
+    // Call core simulator
+    return await simulateCore(configOrPath, event, {
+        json: options.json ?? false,
+        verbose: options.verbose ?? false,
+    });
+}
+// Re-export types and utilities for testing
+export * from './types';
+export * from './simulator';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/simulate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B;IAE/B,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,IAAI;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM;QAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,cAAc,CAClB,KAAK,IAAI,EAAE;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAE7C,qBAAqB;YACrB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE;gBACvD,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YAEH,yBAAyB;YACzB,MAAM,kBAAkB,GAAG;gBACzB,GAAG,MAAM;gBACT,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI;aAC1C,CAAC;YAEF,yDAAyD;YACzD,MAAM,YAAY,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,sBAAsB,CAAC,kBAAkB,EAAE;gBACxD,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAElC,4CAA4C;YAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,4DAA4D;gBAC5D,MAAM,YAAY,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAChC;oBACE,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,YAAY;oBACnB,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI;iBAC1C,EACD,IAAI,EACJ,CAAC,CACF,CAAC;gBACF,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,sDAAsD;gBACtD,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjE,WAAW,CAAC,KAAK,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,EACD,UAAU,EACV,UAAU,EACV,OAAO,EACP,MAAM,CACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,YAA8B,EAC9B,KAAc,EACd,UAII,EAAE;IAEN,4EAA4E;IAC5E,yEAAyE;IACzE,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,wDAAwD;YACtD,2DAA2D;YAC3D,gDAAgD,CACnD,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,OAAO,MAAM,YAAY,CAAC,YAAY,EAAE,KAAK,EAAE;QAC7C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;KAClC,CAAC,CAAC;AACL,CAAC;AAED,4CAA4C;AAC5C,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { SimulateCommandOptions, SimulationResult } from './types';
+/**
+ * Main simulation orchestrator
+ */
+export declare function simulateCore(configPath: string, event: unknown, options?: Pick<SimulateCommandOptions, 'json' | 'verbose' | 'silent'>): Promise<SimulationResult>;
+/**
+ * Parse event input - handles both strings and JSON objects
+ */
+export declare function parseEventInput(eventString?: string): unknown;
+/**
+ * Simple result formatting
+ */
+export declare function formatSimulationResult(result: SimulationResult, options?: Pick<SimulateCommandOptions, 'json'>): string;
+/**
+ * Execute simulation using destination-provided mock environments
+ */
+export declare function executeSimulation(event: unknown, configPath: string): Promise<SimulationResult>;
+//# sourceMappingURL=simulator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simulator.d.ts","sourceRoot":"","sources":["../../../src/commands/simulate/simulator.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AASxE;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAM,GACxE,OAAO,CAAC,gBAAgB,CAAC,CAqC3B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,GAAE,MAAW,GAAG,OAAO,CAajE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAM,GACjD,MAAM,CAeR;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA4L3B"}

package/dist/commands/simulate/simulator.js

@@ -0,0 +1,236 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { createLogger } from '../../core';
+import { loadJsonConfig, getTempDir, isObject, parseBundleConfig, } from '../../config';
+import { bundleCore } from '../bundle/bundler';
+import { downloadPackages } from '../bundle/package-manager';
+import { CallTracker } from './tracker';
+/**
+ * Generate a unique ID for temp files
+ */
+function generateId() {
+    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+}
+/**
+ * Main simulation orchestrator
+ */
+export async function simulateCore(configPath, event, options = {}) {
+    const logger = createLogger({
+        verbose: options.verbose || false,
+        silent: options.silent || false,
+        json: options.json || false,
+    });
+    try {
+        logger.info('🎯 Starting walkerOS simulation...');
+        // Load and validate configuration
+        logger.info('📦 Loading bundle configuration...');
+        const fullConfigPath = path.resolve(configPath);
+        const rawConfig = await loadJsonConfig(fullConfigPath);
+        parseBundleConfig(rawConfig); // Validate config format
+        // Execute simulation
+        logger.info(`🚀 Executing simulation with event: ${JSON.stringify(event)}`);
+        const result = await executeSimulation(event, fullConfigPath);
+        // Report results
+        if (result.success) {
+            logger.info(`✅ Simulation completed successfully`);
+        }
+        else {
+            logger.error(`❌ Simulation failed: ${result.error}`);
+        }
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`💥 Simulation error: ${errorMessage}`);
+        return {
+            success: false,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Parse event input - handles both strings and JSON objects
+ */
+export function parseEventInput(eventString = '') {
+    if (!eventString) {
+        return {};
+    }
+    // Try to parse as JSON first
+    try {
+        const parsed = JSON.parse(eventString);
+        return isObject(parsed) ? parsed : {};
+    }
+    catch {
+        // If JSON parsing fails, treat as event name string
+        return { name: eventString };
+    }
+}
+/**
+ * Simple result formatting
+ */
+export function formatSimulationResult(result, options = {}) {
+    if (options.json) {
+        const output = {
+            result: result.elbResult,
+            usage: result.usage,
+            duration: result.duration,
+        };
+        return JSON.stringify(output, null, 2);
+    }
+    if (result.success) {
+        return '✅ Simulation completed successfully';
+    }
+    else {
+        return `❌ Simulation failed: ${result.error}`;
+    }
+}
+/**
+ * Execute simulation using destination-provided mock environments
+ */
+export async function executeSimulation(event, configPath) {
+    const startTime = Date.now();
+    let bundlePath;
+    const tempDir = getTempDir();
+    try {
+        // Ensure temp directory exists
+        await fs.ensureDir(tempDir);
+        // 1. Load config
+        const rawConfig = await loadJsonConfig(configPath);
+        const { flowConfig, buildOptions } = parseBundleConfig(rawConfig);
+        // 2. Download packages to temp directory
+        // This ensures we use clean npm packages, not workspace packages
+        const packagesArray = Object.entries(buildOptions.packages).map(([name, packageConfig]) => ({
+            name,
+            version: (typeof packageConfig === 'object' &&
+                packageConfig !== null &&
+                'version' in packageConfig &&
+                typeof packageConfig.version === 'string'
+                ? packageConfig.version
+                : undefined) || 'latest',
+        }));
+        const packagePaths = await downloadPackages(packagesArray, tempDir, // downloadPackages will add 'node_modules' subdirectory itself
+        createLogger({ silent: true }), buildOptions.cache);
+        // 3. Create tracker
+        const tracker = new CallTracker();
+        // 4. Prepare env setup code to inject into bundle
+        // The bundle will import examples, so we can reference them directly in the injected code
+        const envSetupCode = [];
+        const destinations = flowConfig.destinations;
+        if (destinations) {
+            for (const [key, dest] of Object.entries(destinations)) {
+                // Generate code to wrap env using examples imported IN THE BUNDLE
+                const destName = key.replace(/-/g, '_');
+                envSetupCode.push(`
+  // Inject tracked env for destination '${key}' using examples from bundle
+  if (examples && examples['${key}'] && examples['${key}'].env) {
+    const mockEnv = examples['${key}'].env.push;
+    const trackPaths = examples['${key}'].env.simulation || [];
+    if (mockEnv) {
+      const wrappedPaths = trackPaths.map((p) => '${key}:' + p);
+      const trackedEnv = __simulationTracker.wrapEnv(mockEnv, wrappedPaths);
+      if (config.destinations && config.destinations['${key}']) {
+        config.destinations['${key}'].env = trackedEnv;
+      }
+    }
+  }
+`);
+            }
+        }
+        // 5. Inject env setup code BEFORE startFlow
+        // Note: __simulationTracker will be provided via factory function parameter
+        const modifiedCode = `
+// Inject tracked envs into destination configs
+${envSetupCode.join('\n')}
+
+${buildOptions.code || ''}
+`;
+        // 7. Create temporary bundle with downloaded packages
+        const tempOutput = path.join(tempDir, `simulation-bundle-${generateId()}.mjs`);
+        // Create modified build options for simulation
+        const simulationBuildOptions = {
+            ...buildOptions,
+            code: modifiedCode,
+            output: tempOutput,
+            tempDir, // Use same temp dir for bundle
+            format: 'esm',
+            // Force node platform for simulation since we're running in Node.js
+            platform: 'node',
+        };
+        // 8. Bundle with downloaded packages (they're already in tempDir/node_modules)
+        await bundleCore(flowConfig, simulationBuildOptions, createLogger({ silent: true }), false);
+        bundlePath = tempOutput;
+        // 9. Inject minimal globals for Node simulation environment
+        // This allows destinations to reference window/document without errors
+        const globalWithSim = globalThis;
+        if (!globalWithSim.window) {
+            globalWithSim.window = {};
+        }
+        if (!globalWithSim.document) {
+            globalWithSim.document = {};
+        }
+        // 10. Dynamic import the bundle
+        const timestamp = Date.now();
+        const moduleUrl = `file://${bundlePath}?t=${timestamp}`;
+        const module = await import(moduleUrl);
+        // 11. Populate globals with destination-specific mocks from examples
+        // This happens AFTER import so we can access the exported examples
+        const importedExamples = module.examples;
+        const destinations2 = flowConfig.destinations;
+        if (importedExamples && destinations2) {
+            for (const [key, dest] of Object.entries(destinations2)) {
+                const destEnv = importedExamples[key]?.env?.push;
+                if (destEnv) {
+                    if (destEnv.window &&
+                        typeof globalWithSim.window === 'object' &&
+                        globalWithSim.window !== null) {
+                        Object.assign(globalWithSim.window, destEnv.window);
+                    }
+                    if (destEnv.document &&
+                        typeof globalWithSim.document === 'object' &&
+                        globalWithSim.document !== null) {
+                        Object.assign(globalWithSim.document, destEnv.document);
+                    }
+                }
+            }
+        }
+        // 12. Call bundle factory function with tracker
+        const flowResult = await module.default({ tracker });
+        if (!flowResult || typeof flowResult.elb !== 'function') {
+            throw new Error('Bundle did not export valid flow object with elb function');
+        }
+        const { elb } = flowResult;
+        // 13. Execute the event
+        const elbResult = await elb(event);
+        // 14. Retrieve tracked calls from tracker instance
+        const usage = tracker.getCalls();
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            elbResult,
+            usage,
+            duration,
+            logs: [],
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            duration,
+        };
+    }
+    finally {
+        // Cleanup temp directory and all its contents
+        if (tempDir) {
+            await fs.remove(tempDir).catch(() => {
+                // Ignore cleanup errors - temp dirs will be cleaned eventually
+            });
+        }
+        // Cleanup injected globals
+        const globalWithSim = globalThis;
+        delete globalWithSim.window;
+        delete globalWithSim.document;
+    }
+}
+//# sourceMappingURL=simulator.js.map

package/dist/commands/simulate/simulator.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * Call Tracker for Simulation
+ *
+ * Wraps mock environment functions to track API calls.
+ * Used with destination-provided examples/env.ts mocks.
+ */
+export interface ApiCall {
+    type: 'call';
+    path: string;
+    args: unknown[];
+    timestamp: number;
+}
+export declare class CallTracker {
+    private calls;
+    /**
+     * Wrap a function to track its calls
+     */
+    wrapFunction(name: string, fn?: (...args: unknown[]) => unknown): (...args: unknown[]) => unknown;
+    /**
+     * Wrap an environment object, tracking specified paths
+     *
+     * @param env - Environment object (from destination's examples/env.ts)
+     * @param paths - Paths to track (e.g., ['gtag:window.gtag', 'gtag:window.dataLayer.push'])
+     */
+    wrapEnv<T extends Record<string, unknown>>(env: T, paths: string[]): T;
+    private logCall;
+    getCalls(): Record<string, ApiCall[]>;
+    reset(): void;
+}
+//# sourceMappingURL=tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/commands/simulate/tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAqC;IAElD;;OAEG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACnC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO;IAYlC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC;IA4DtE,OAAO,CAAC,OAAO;IAiBf,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAIrC,KAAK,IAAI,IAAI;CAGd"}