@walkeros/cli 3.2.0 → 3.3.0-next-1776113011459

package/dist/examples/web-serve.json

@@ -6,20 +6,6 @@
         "windowCollector": "collector",
         "windowElb": "elb"
       },
-      "packages": {
-        "@walkeros/collector": {
-          "imports": ["startFlow"]
-        },
-        "@walkeros/source-demo": {
-          "imports": ["sourceDemo"]
-        },
-        "@walkeros/destination-demo": {
-          "imports": ["destinationDemo"]
-        },
-        "@walkeros/web-destination-api": {
-          "imports": ["destinationAPI"]
-        }
-      },
       "sources": {
         "demo": {
           "package": "@walkeros/source-demo",
@@ -28,7 +14,10 @@
               "events": [
                 {
                   "name": "page view",
-                  "data": { "title": "Home", "path": "/" },
+                  "data": {
+                    "title": "Home",
+                    "path": "/"
+                  },
                   "delay": 0
                 },
                 {
@@ -68,6 +57,22 @@
         "globals": {
           "language": "en"
         }
+      },
+      "bundle": {
+        "packages": {
+          "@walkeros/collector": {
+            "imports": ["startFlow"]
+          },
+          "@walkeros/source-demo": {
+            "imports": ["sourceDemo"]
+          },
+          "@walkeros/destination-demo": {
+            "imports": ["destinationDemo"]
+          },
+          "@walkeros/web-destination-api": {
+            "imports": ["destinationAPI"]
+          }
+        }
       }
     }
   }

package/dist/index.d.ts

@@ -61,6 +61,12 @@ interface BuildOptions extends CLIBuildOptions {
      * Packages to include in the bundle.
      */
     packages: Flow.Packages;
+    /**
+     * Transitive dependency version overrides.
+     * Flat `Record<string, string>` matching npm's `overrides` semantics.
+     * Only substitutes transitive specs; direct package specs always win.
+     */
+    overrides?: Flow.Overrides;
     /**
      * Output format.
      */
@@ -367,6 +373,7 @@ declare function push(configOrPath: string | unknown, event: unknown, options?:
 }): Promise<PushResult>;
 interface SimulateSourceOptions {
     sourceId: string;
+    bundlePath?: string;
     flow?: string;
     silent?: boolean;
     verbose?: boolean;
@@ -382,9 +389,10 @@ interface SimulateSourceOptions {
  * 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>;
+declare function simulateSource(configOrPath: string | Flow.Config, input: unknown, options: SimulateSourceOptions): Promise<PushResult>;
 interface SimulateTransformerOptions {
     transformerId: string;
+    bundlePath?: string;
     flow?: string;
     mock?: string[];
     silent?: boolean;
@@ -401,9 +409,10 @@ interface SimulateTransformerOptions {
  * 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>;
+declare function simulateTransformer(configOrPath: string | Flow.Config, event: WalkerOS.DeepPartialEvent, options: SimulateTransformerOptions): Promise<PushResult>;
 interface SimulateDestinationOptions {
     destinationId: string;
+    bundlePath?: string;
     flow?: string;
     mock?: string[];
     silent?: boolean;
@@ -419,7 +428,7 @@ interface SimulateDestinationOptions {
  * 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>;
+declare function simulateDestination(configOrPath: string | Flow.Config, event: WalkerOS.DeepPartialEvent, options: SimulateDestinationOptions): Promise<PushResult>;
 
 /**
  * Run Command Types
@@ -910,6 +919,57 @@ interface FeedbackOptions {
 declare function feedback(text: string, options?: FeedbackOptions): Promise<void>;
 declare function feedbackCommand(text: string): Promise<void>;
 
+/**
+ * Publish-time wrap step.
+ *
+ * Takes a Stage 1 ESM skeleton produced via `bundle({ skipWrapper: true })`
+ * and produces a wrapped output:
+ *  - `browser`: self-executing async IIFE that calls
+ *    `startFlow(wireConfig(__configData))` and optionally assigns the
+ *    resulting collector/elb onto `window`.
+ *  - `node`: ESM module whose default export is an async factory function
+ *    that the runtime container (see `runtime/load-bundle.ts:53-66`) calls
+ *    with a context to get back `{ collector, elb, httpHandler? }`.
+ *
+ * The skeleton must export `wireConfig`, `startFlow`, and `__configData`.
+ * The skipWrapper branch of `bundleCore` already emits exactly that shape.
+ */
+
+interface WrapSkeletonOptions {
+    /**
+     * Absolute path to the Stage 1 skeleton ESM file. Must export
+     * `wireConfig`, `startFlow`, and `__configData`.
+     */
+    skeletonPath: string;
+    /** Target platform — controls which entry generator runs. */
+    platform: 'browser' | 'node';
+    /** Absolute path where the wrapped output will be written. */
+    outputPath: string;
+    /**
+     * Browser-only: window property name for the collector.
+     * When unset, no `window.*` assignment is emitted.
+     */
+    windowCollector?: string;
+    /**
+     * Browser-only: window property name for the elb function.
+     * When unset, no `window.*` assignment is emitted.
+     */
+    windowElb?: string;
+    /** Browser-only: CDN hostname for loading preview bundles. */
+    previewOrigin?: string;
+    /** Browser-only: project scope for preview URL isolation. */
+    previewScope?: string;
+    /**
+     * esbuild target. @default 'es2018' for browser, 'node18' for node.
+     */
+    target?: string;
+    /** Whether to minify the output. @default true */
+    minify?: boolean;
+    /** Fine-grained minification options, forwarded to esbuild. */
+    minifyOptions?: MinifyOptions;
+}
+declare function wrapSkeleton(options: WrapSkeletonOptions): Promise<void>;
+
 /**
  * This file was auto-generated by openapi-typescript.
  * Do not make direct changes to the file.
@@ -5180,4 +5240,55 @@ declare function compareOutput(expected: unknown, actual: unknown): {
     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 };
+/**
+ * Overrides structure for destination config properties.
+ * Shape mirrors Collector.InitConfig.destinations but without requiring `code`.
+ * Used with deepMerge at runtime to overlay mock/disabled flags.
+ */
+interface PushOverrides {
+    destinations?: Record<string, {
+        config?: {
+            mock?: unknown;
+            disabled?: boolean;
+        };
+        simulate?: boolean;
+        env?: Record<string, unknown>;
+        simulation?: string[];
+    }>;
+    sources?: Record<string, {
+        simulate?: boolean;
+    }>;
+    /** Path-specific transformer mocks: chainPath → { transformerId → mockValue } */
+    transformerMocks?: Record<string, Record<string, unknown>>;
+    transformers?: Record<string, {
+        simulate?: boolean;
+    }>;
+}
+
+type PrepareInput = {
+    mode: 'build';
+    config: Flow.Config;
+    flow?: string;
+    simulate?: string[];
+    mock?: string[];
+    silent?: boolean;
+    verbose?: boolean;
+} | {
+    mode: 'prebuilt';
+    bundlePath: string;
+    config: Flow.Config;
+    flow?: string;
+    simulate?: string[];
+    mock?: string[];
+    silent?: boolean;
+    verbose?: boolean;
+};
+interface PreparedFlow {
+    bundlePath: string;
+    platform: 'web' | 'server';
+    overrides: PushOverrides;
+    flowSettings: Flow.Settings;
+    cleanup: () => Promise<void>;
+}
+
+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 PrepareInput, type PreparedFlow, 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, type WrapSkeletonOptions, 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, wrapSkeleton, writeConfig };