@walkeros/cli 3.1.1 → 3.2.0

package/dist/examples/README.md

@@ -135,8 +135,9 @@ export META_PIXEL_ID="123456789"
 walkeros bundle examples/web-tracking.json --stats
 
 # Simulate events
-walkeros simulate examples/web-tracking.json \
-  --event '{"name":"product view","data":{"id":"P123","name":"Laptop","price":999}}'
+walkeros push examples/web-tracking.json \
+  --event '{"name":"product view","data":{"id":"P123","name":"Laptop","price":999}}' \
+  --simulate destination.demo
 ```
 
 ## Server Examples
@@ -382,7 +383,7 @@ The event name is parsed as: `const [entity, action] = event.split(' ')`
 
 ## Next Steps
 
-1. Try each example with `walkeros bundle` and `walkeros simulate`
+1. Try each example with `walkeros bundle` and `walkeros push --simulate`
 2. Modify examples to match your tracking requirements
 3. Create custom flow files for your use case
 4. Deploy to production

package/dist/examples/flow-complete.json

@@ -540,9 +540,6 @@
         "@walkeros/destination-demo": {},
         "@walkeros/transformer-validator": {},
         "@walkeros/server-transformer-fingerprint": {},
-        "@walkeros/server-transformer-cache": {
-          "path": "../../server/transformers/cache"
-        },
         "@walkeros/store-memory": {
           "path": "../../stores/memory"
         }
@@ -562,6 +559,23 @@
         "http": {
           "package": "@walkeros/server-source-express",
           "primary": true,
+          "cache": {
+            "store": "cache",
+            "rules": [
+              {
+                "match": {
+                  "key": "ingest.method",
+                  "operator": "eq",
+                  "value": "GET"
+                },
+                "key": ["ingest.method", "ingest.path"],
+                "ttl": 300,
+                "update": {
+                  "headers.X-Cache": { "key": "cache.status" }
+                }
+              }
+            ]
+          },
           "config": {
             "settings": {
               "path": "/collect",
@@ -598,26 +612,6 @@
         }
       },
       "transformers": {
-        "cache": {
-          "package": "@walkeros/server-transformer-cache",
-          "next": "filter",
-          "config": {
-            "settings": {
-              "rules": [
-                {
-                  "match": {
-                    "key": "method",
-                    "operator": "equals",
-                    "value": "GET"
-                  },
-                  "key": ["method", "path"],
-                  "ttl": 300
-                }
-              ]
-            }
-          },
-          "env": { "store": "$store:cache" }
-        },
         "filter": {
           "code": {
             "type": "filter",
@@ -682,7 +676,7 @@
       "destinations": {
         "meta": {
           "package": "@walkeros/server-destination-meta",
-          "before": "cache",
+          "before": "fingerprint",
           "config": {
             "settings": {
               "pixelId": "$var.metaPixelId",

package/dist/examples/flow-order-complete.json

@@ -14,7 +14,7 @@
       },
       "destinations": {
         "demo": {
-          "code": "destinationDemo",
+          "package": "@walkeros/destination-demo",
           "config": {
             "consent": {
               "marketing": true

package/dist/examples/flow-simple.json

@@ -14,7 +14,7 @@
       },
       "destinations": {
         "demo": {
-          "code": "destinationDemo",
+          "package": "@walkeros/destination-demo",
           "config": {
             "settings": {
               "name": "Simple Demo",

package/dist/index.d.ts

@@ -97,6 +97,12 @@ interface BuildOptions extends CLIBuildOptions {
      * @default "elb"
      */
     windowElb?: string;
+    /**
+     * Skip platform wrapper (Step 2) and output raw ESM.
+     * Used by CLI push for direct import of the bundled module.
+     * @default false
+     */
+    skipWrapper?: boolean;
     /**
      * Folders to include in the output directory.
      * These folders are copied alongside the bundle for runtime access.
@@ -218,66 +224,6 @@ declare function bundleRemote(options: {
     stats: any;
 }>;
 
-/** Tracked API call from destination simulation */
-interface ApiCall {
-    type: 'call';
-    path: string;
-    args: unknown[];
-    timestamp: number;
-}
-interface SimulateCommandOptions {
-    config?: string;
-    output?: string;
-    event?: string;
-    flow?: string;
-    json?: boolean;
-    verbose?: boolean;
-    silent?: boolean;
-    platform?: 'web' | 'server';
-    step?: string;
-}
-interface SimulationResult {
-    success: boolean;
-    error?: string;
-    collector?: unknown;
-    elbResult?: Elb.PushResult;
-    logs?: unknown[];
-    usage?: Record<string, ApiCall[]>;
-    duration?: number;
-    /** Events captured by source simulation */
-    capturedEvents?: WalkerOS.DeepPartialEvent[];
-}
-
-/**
- * Simulate Command Schemas
- *
- * Zod schemas for simulate command parameter validation.
- */
-
-/**
- * Platform schema.
- *
- * @remarks
- * Validates platform type for event simulation.
- */
-declare const PlatformSchema: z.ZodEnum<{
-    web: "web";
-    server: "server";
-}>;
-type Platform$1 = z.infer<typeof PlatformSchema>;
-/**
- * Simulate options schema.
- *
- * @remarks
- * Options for the programmatic simulate() API.
- */
-declare const SimulateOptionsSchema: z.ZodObject<{
-    silent: z.ZodOptional<z.ZodBoolean>;
-    verbose: z.ZodOptional<z.ZodBoolean>;
-    json: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;
-
 /**
  * Input Detector
  *
@@ -321,57 +267,15 @@ interface SSEParseResult {
 }
 declare function parseSSEEvents(buffer: string): SSEParseResult;
 
-type StepType = 'source' | 'transformer' | 'destination';
-interface ExampleLookupResult {
-    stepType: StepType;
-    stepName: string;
-    exampleName: string;
-    example: {
-        in?: unknown;
-        mapping?: unknown;
-        out?: unknown;
-    };
+/** Captured network call from polyfilled fetch/sendBeacon during simulation */
+interface NetworkCall {
+    type: 'fetch' | 'beacon';
+    url: string;
+    method?: string;
+    body?: string | null;
+    headers?: Record<string, string>;
+    timestamp: number;
 }
-/**
- * Find a named example in a flow config.
- *
- * Searches sources, transformers, and destinations for a matching example.
- * If --step is provided (e.g. "destination.gtag"), looks only in that step.
- * If not, searches all steps and errors if ambiguous.
- *
- * @param config - Raw (unresolved) flow config with examples intact
- * @param exampleName - Name of the example to find
- * @param stepTarget - Optional step target in "type.name" format
- * @returns The found example with its location
- */
-declare function findExample(config: Flow.Settings, exampleName: string, stepTarget?: string): ExampleLookupResult;
-
-/**
- * Compare simulation output against expected example output.
- */
-declare function compareOutput(expected: unknown, actual: unknown): {
-    expected: unknown;
-    actual: unknown;
-    match: boolean;
-    diff?: string;
-};
-
-/**
- * CLI command handler for simulate command
- */
-declare function simulateCommand(options: SimulateCommandOptions): Promise<void>;
-/**
- * High-level simulate function for programmatic usage.
- *
- * For destinations/transformers: event is a walkerOS event { name, data }.
- * For sources (--step source.*): event is a SourceInput { content, trigger?, env? }.
- */
-declare function simulate(configOrPath: string | unknown, event: unknown, options?: SimulateOptions & {
-    flow?: string;
-    platform?: Platform$1;
-    step?: string;
-}): Promise<SimulationResult>;
-
 /**
  * Push command options
  */
@@ -384,6 +288,9 @@ interface PushCommandOptions {
     verbose?: boolean;
     silent?: boolean;
     platform?: 'web' | 'server';
+    simulate?: string[];
+    mock?: string[];
+    snapshot?: string;
 }
 /**
  * Push execution result
@@ -391,6 +298,18 @@ interface PushCommandOptions {
 interface PushResult {
     success: boolean;
     elbResult?: Elb.PushResult;
+    captured?: Array<{
+        event: unknown;
+        timestamp: number;
+    }>;
+    /** Tracked destination API calls keyed by destination ID */
+    usage?: Record<string, Array<{
+        fn: string;
+        args: unknown[];
+        ts: number;
+    }>>;
+    /** Network calls captured during web simulation (fetch + sendBeacon) */
+    networkCalls?: NetworkCall[];
     duration: number;
     error?: string;
 }
@@ -443,7 +362,64 @@ declare function pushCommand(options: PushCommandOptions): Promise<void>;
 declare function push(configOrPath: string | unknown, event: unknown, options?: PushOptions & {
     flow?: string;
     platform?: Platform;
+    mock?: string[];
+    snapshot?: string;
 }): Promise<PushResult>;
+interface SimulateSourceOptions {
+    sourceId: string;
+    flow?: string;
+    silent?: boolean;
+    verbose?: boolean;
+    snapshot?: string;
+}
+/**
+ * Self-contained source simulation.
+ *
+ * Loads the flow config, bundles it, resolves the source package's /dev export
+ * to get createTrigger, then invokes the trigger inside a flow context with a
+ * prePush hook that captures events before they reach destinations.
+ *
+ * The `input` parameter is `unknown` — the CLI is agnostic to source-specific
+ * content shapes. The source's createTrigger defines what it expects.
+ */
+declare function simulateSource(configPath: string, input: unknown, options: SimulateSourceOptions): Promise<PushResult>;
+interface SimulateTransformerOptions {
+    transformerId: string;
+    flow?: string;
+    mock?: string[];
+    silent?: boolean;
+    verbose?: boolean;
+    snapshot?: string;
+}
+/**
+ * Self-contained transformer simulation.
+ *
+ * Takes a DeepPartialEvent, validates it with Zod, loads the flow config,
+ * bundles it, starts the flow to get initialized transformers, then runs
+ * the event through the target transformer (with optional before chain).
+ *
+ * Captured array: first entry = input event, subsequent entries = output event(s).
+ * If the transformer drops the event (returns false), output event is null.
+ */
+declare function simulateTransformer(configPath: string, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<PushResult>;
+interface SimulateDestinationOptions {
+    destinationId: string;
+    flow?: string;
+    mock?: string[];
+    silent?: boolean;
+    verbose?: boolean;
+    snapshot?: string;
+}
+/**
+ * Self-contained destination simulation.
+ *
+ * Takes a DeepPartialEvent, validates it with Zod, loads the flow config,
+ * bundles it, starts the flow, then pushes via collector.push with an include
+ * filter so only the target destination receives the event. This gives full
+ * pipeline support — consent checks, event mapping, createEvent enrichment,
+ * before chains — without manual wiring.
+ */
+declare function simulateDestination(configPath: string, event: WalkerOS.DeepPartialEvent, options: SimulateDestinationOptions): Promise<PushResult>;
 
 /**
  * Run Command Types
@@ -5109,9 +5085,43 @@ declare function readConfig(): WalkerOSConfig | null;
  */
 declare function writeConfig(config: WalkerOSConfig): void;
 
+/**
+ * Load configuration from a file path, URL, or inline string.
+ *
+ * Supports two modes:
+ * - `json: true` (default) — resolves content and parses as JSON
+ * - `json: false` — resolves content and returns raw string
+ *
+ * Detection priority:
+ * 1. URL (http://, https://) — download content
+ * 2. Existing file path — read file content
+ * 3. Inline string (starting with { or [) — use directly
+ *
+ * @param input - Path to file, HTTP/HTTPS URL, or inline string
+ * @param options - Optional settings
+ * @param options.json - Parse as JSON (default: true)
+ * @returns Parsed object (json: true) or raw string (json: false)
+ * @throws Error if file not found, download fails, or invalid JSON
+ *
+ * @example
+ * ```typescript
+ * // JSON mode (default) — same as loadJsonConfig
+ * const config = await loadConfig('./config.json')
+ * const config = await loadConfig('https://example.com/config.json')
+ * const config = await loadConfig('{"version":3,"flows":{}}')
+ *
+ * // Raw string mode — returns file/URL content as string
+ * const code = await loadConfig('./bundle.js', { json: false })
+ * ```
+ */
+declare function loadConfig<T = unknown>(input: string, options?: {
+    json?: boolean;
+}): Promise<T | string>;
 /**
  * Load and parse JSON configuration from a file path, URL, or inline JSON string.
  *
+ * Thin wrapper around `loadConfig` with `json: true` (default).
+ *
  * Detection priority:
  * 1. URL (http://, https://) — download and parse
  * 2. Existing file path — read and parse
@@ -5135,4 +5145,39 @@ declare function writeConfig(config: WalkerOSConfig): void;
  */
 declare function loadJsonConfig<T>(configPath: string): Promise<T>;
 
-export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type DeployOptions, type ExampleLookupResult, type FeedbackOptions, type GlobalOptions, type ListDeploymentsOptions, type ListFlowsOptions, type MinifyOptions, type PushResult, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulationResult, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, apiFetch, bundle, bundleCommand, bundleRemote, compareOutput, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createProject, createProjectCommand, deleteDeployment, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deleteProject, deleteProjectCommand, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, findExample, getAuthHeaders, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFlow, getFlowCommand, getProject, getProjectCommand, getToken, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listProjects, listProjectsCommand, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, publicFetch, push, pushCommand, readConfig, requireProjectId, run, runCommand, simulate, simulateCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, validate, validateCommand, whoami, whoamiCommand, writeConfig };
+type StepType = 'source' | 'transformer' | 'destination';
+interface ExampleLookupResult {
+    stepType: StepType;
+    stepName: string;
+    exampleName: string;
+    example: {
+        in?: unknown;
+        mapping?: unknown;
+        out?: unknown;
+    };
+}
+/**
+ * Find a named example in a flow config.
+ *
+ * Searches sources, transformers, and destinations for a matching example.
+ * If --step is provided (e.g. "destination.gtag"), looks only in that step.
+ * If not, searches all steps and errors if ambiguous.
+ *
+ * @param config - Raw (unresolved) flow config with examples intact
+ * @param exampleName - Name of the example to find
+ * @param stepTarget - Optional step target in "type.name" format
+ * @returns The found example with its location
+ */
+declare function findExample(config: Flow.Settings, exampleName: string, stepTarget?: string): ExampleLookupResult;
+
+/**
+ * Compare simulation output against expected example output.
+ */
+declare function compareOutput(expected: unknown, actual: unknown): {
+    expected: unknown;
+    actual: unknown;
+    match: boolean;
+    diff?: string;
+};
+
+export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type DeployOptions, type ExampleLookupResult, type FeedbackOptions, type GlobalOptions, type ListDeploymentsOptions, type ListFlowsOptions, type MinifyOptions, type PushResult, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, apiFetch, bundle, bundleCommand, bundleRemote, compareOutput, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createProject, createProjectCommand, deleteDeployment, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deleteProject, deleteProjectCommand, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, findExample, getAuthHeaders, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFlow, getFlowCommand, getProject, getProjectCommand, getToken, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listProjects, listProjectsCommand, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, publicFetch, push, pushCommand, readConfig, requireProjectId, run, runCommand, simulateDestination, simulateSource, simulateTransformer, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, validate, validateCommand, whoami, whoamiCommand, writeConfig };