@walkeros/cli 0.5.1-next.0 → 0.6.0

package/dist/commands/run/index.js

@@ -0,0 +1,154 @@
+/**
+ * Run Command
+ *
+ * Runs walkerOS flows using local runtime
+ */
+import path from 'path';
+import { createCommandLogger, createTimer, getErrorMessage, } 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);
+                logger.debug(`Using pre-built flow: ${path.basename(flowPath)}`);
+            }
+            else {
+                // Bundle JSON config first
+                logger.debug('Building flow bundle');
+                flowPath = await prepareBundleForRun(configPath, {
+                    verbose: options.verbose,
+                    silent: options.json || options.silent,
+                });
+                logger.debug('Bundle ready');
+            }
+        }
+        // Step 3: Execute locally
+        // Handle dry-run
+        if (options.dryRun) {
+            logger.log(`[DRY-RUN] Would execute locally: run ${mode}`);
+            return;
+        }
+        // Execute locally using runtime module
+        const modeLabel = mode === 'collect' ? 'Collector' : 'Server';
+        logger.log(`Starting ${modeLabel}...`);
+        await executeRunLocal(mode, flowPath, {
+            port: options.port,
+            host: options.host,
+            serveName: options.serveName,
+            servePath: options.servePath,
+        });
+        // Note: Server runs forever, so we won't reach here unless it fails
+    }
+    catch (error) {
+        const duration = timer.getElapsed() / 1000;
+        const errorMessage = getErrorMessage(error);
+        if (options.json) {
+            logger.json({
+                success: false,
+                mode,
+                error: errorMessage,
+                duration,
+            });
+        }
+        else {
+            logger.error(`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 local runtime
+        await executeRunLocal(mode, flowPath, {
+            port: options.port,
+            host: options.host,
+            serveName: options.serveName,
+            servePath: options.servePath,
+        });
+        // Success (though server 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":"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"}

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

@@ -0,0 +1,65 @@
+/**
+ * Run Command Types
+ *
+ * Types for running walkerOS flows via CLI using local runtime
+ */
+/**
+ * Run mode - determines which execution mode to use
+ */
+export type RunMode = 'collect' | 'serve';
+/**
+ * CLI command options for `walkeros run`
+ */
+export interface RunCommandOptions {
+    /** 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;
+    /** Verbose logging */
+    verbose?: boolean;
+    /** Dry-run mode */
+    dryRun?: boolean;
+    /** Suppress output */
+    silent?: 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;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,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;IAEf,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;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 local runtime
+ */
+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,CAqCzC"}

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

@@ -0,0 +1,44 @@
+/**
+ * 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 {
+            // Silently skip destinations without env or invalid packages
+        }
+    }
+    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,MAAM,CAAC;YACP,6DAA6D;QAC/D,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":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Df;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"}