@walkeros/cli 3.2.0 → 3.3.0-next-1776113011459

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # @walkeros/cli
 
+## 3.3.0-next-1776113011459
+
+### Minor Changes
+
+- 2849acb: **BREAKING CHANGE:** The `packages` block has moved from
+  `flow.<name>.packages` to `flow.<name>.bundle.packages`. Flow files using the
+  old shape fail fast with a migration error pointing to the new location.
+
+  Also adds `flow.<name>.bundle.overrides` — a `Record<string, string>` for
+  pinning transitive dependency versions, matching npm's `overrides` semantics.
+  Use this to resolve version conflicts when a transitive dependency's declared
+  range conflicts with another required version in the same tree (the original
+  motivating case: `@amplitude/engagement-browser` pins
+  `@amplitude/analytics-types@^1.0.0` while `@amplitude/analytics-browser`
+  transitively requires `analytics-types@2.11.1` exact — previously an
+  unresolvable bundler conflict).
+
+  **Migration:** move the existing `packages` block one level deeper into a new
+  `bundle` wrapper.
+
+  ```diff
+    {
+      "version": 3,
+      "flows": {
+        "default": {
+          "web": {},
+  -       "packages": {
+  -         "@walkeros/collector": {}
+  -       },
+  +       "bundle": {
+  +         "packages": {
+  +           "@walkeros/collector": {}
+  +         }
+  +       },
+          "sources": { },
+          "destinations": { }
+        }
+      }
+    }
+  ```
+
+  **Overrides example:**
+
+  ```json
+  {
+    "flows": {
+      "default": {
+        "web": {},
+        "bundle": {
+          "packages": {
+            "@walkeros/web-destination-amplitude": {}
+          },
+          "overrides": {
+            "@amplitude/analytics-types": "2.11.1"
+          }
+        }
+      }
+    }
+  }
+  ```
+
+  Overrides only substitute **transitive** dependencies during resolution —
+  direct package specs declared in `bundle.packages` always win. Overrides
+  targeting a direct local-path package emit a warning and are ignored. Peer
+  constraint mismatches against the chosen override emit a warning but do not
+  error (the override is an explicit user directive).
+
+- 08c365a: Add preview mode preflight to web bundles
+  - `WrapSkeletonOptions` accepts optional `previewOrigin` and `previewScope`
+    fields
+  - `generateWrapEntry` injects a preflight snippet before `startFlow` when both
+    are set: checks `?elbPreview` param / cookie, loads preview bundle from
+    `{previewOrigin}/preview/{previewScope}/walker.{token}.js`, skips production
+    flow. Zero overhead when preview options are absent.
+  - Input validation rejects path-traversal in `previewScope` and special
+    characters in `previewOrigin`.
+
+- 08c365a: Bundle /dev exports into stage 1 skeleton for environment-agnostic
+  simulation
+  - `/dev` exports from packages are included in the skipWrapper bundle as
+    `__devExports`
+  - Stage 2 production bundles tree-shake dev exports (no size impact)
+  - `prepareFlow()` accepts `Flow.Config` object or pre-built `bundlePath`
+  - Simulate functions read env/createTrigger from bundle instead of filesystem
+
+### Patch Changes
+
+- ae02457: Fix bare filename resolution in bundle command —
+  `walkeros bundle flow.json` now resolves relative to cwd instead of CLI
+  examples directory. Add TTY hint when writing to stdout
+- Updated dependencies [2849acb]
+- Updated dependencies [08c365a]
+- Updated dependencies [08c365a]
+- Updated dependencies [08c365a]
+- Updated dependencies [08c365a]
+  - @walkeros/core@3.3.0-next-1776113011459
+  - @walkeros/server-core@3.3.0-next-1776113011459
+
 ## 3.2.0
 
 ### Minor Changes