@walkeros/cli 4.1.0-next-1778161443961 → 4.1.0-next-1778668930820

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,9 +1,120 @@
1
1
  # @walkeros/cli
2
2
 
3
- ## 4.1.0-next-1778161443961
3
+ ## 4.1.0-next-1778668930820
4
4
 
5
5
  ### Minor Changes
6
6
 
7
+ - dd9f5ad: Pass-through transformer steps + closed-schema validation.
8
+
9
+ **Validation:** `validateTransformerEntry` in `@walkeros/core` is now the
10
+ single source of truth. Bundler, `flow_validate`, and collector runtime all
11
+ delegate. Closed schema: unknown top-level keys are errors. `code` + `package`
12
+ together is a `CONFLICT`.
13
+
14
+ **Pass-through steps:** A transformer entry with no `code` and no `package` is
15
+ valid; the collector synthesizes its push. Three variants:
16
+ - before/next chain only (named hop)
17
+ - cache only (e.g. dedup)
18
+ - mapping only (event-to-event transform via `Mapping.Config`)
19
+
20
+ **Mapping at the transformer position:** new `mapping?: Mapping.Config` field
21
+ on `Transformer.Config` / `InitTransformer`. Same shape as
22
+ `Destination.Config.mapping`, event-to-event semantic. `data` / `silent` are
23
+ ignored at the transformer position with a one-time warning.
24
+
25
+ **Engine tag:** synthesized instance now uses `type: 'pass'` (was `'path'`).
26
+ Hard cut.
27
+
28
+ **Runtime fixes:**
29
+ - `compileNext` handles mixed-shape `next` arrays (`["a", { case }]`) via a
30
+ new `'sequence'` variant.
31
+ - A destination's `before` referencing a pass-through transformer now walks
32
+ that transformer's own `before` / `next`.
33
+ - `cache.stop: true` at a pre-collector transformer halts the pipeline
34
+ (matches `cache.mdx`).
35
+
36
+ **Migration:** Typo keys on a step now fail validation.
37
+ `instance.type === 'path'` consumers must read `'pass'`. `runTransformerChain`
38
+ consumers should branch on the new `stopped` flag.
39
+
40
+ ### Patch Changes
41
+
42
+ - 1a8f2d7: Flow v4 routing & cache cleanup.
43
+
44
+ **Cache:**
45
+ - `cache.full` is renamed to `cache.stop`. Search-and-replace.
46
+ - `cacheRule.match` is now optional. Omitted means always-match. The literal
47
+ `'*'` is dropped from the schema and the TypeScript types; `compileMatcher`
48
+ still tolerates the string at runtime for migration.
49
+ - New `cache.namespace?: string` field. Omit to write keys directly to the
50
+ store. Same store + same key + same namespace = same cache entry.
51
+ - Implicit per-step namespace prefixes (`s:`, `t:`, `d:`) are removed. If you
52
+ relied on them to separate same-keyed caches across
53
+ sources/transformers/destinations using the same store, set
54
+ `cache.namespace` explicitly.
55
+
56
+ **Routing:**
57
+ - Unified recursive `Route` type. A Route is `string | Route[] | RouteConfig`.
58
+ - New `case` operator replaces the legacy `Route[]` first-match shape. The
59
+ legacy shape is compiled as an implicit `{ case: [...] }` for runtime
60
+ compatibility, but new configs should use `case` explicitly.
61
+ - `RouteConfig` is a disjoint union enforced at the TypeScript type level via
62
+ `never` fields: a single RouteConfig sets at most one of `next` / `case`. A
63
+ bare `{ match }` is a gate (pass-through when the match fires, fall-through
64
+ when it fails). JSON Schema validation currently emits `anyOf` and does not
65
+ enforce disjointness at runtime — see follow-up notes.
66
+ - Sequence sugar (`next: [A, B, C]`) is preserved.
67
+
68
+ **Path:**
69
+ - A transformer entry with no `code` is a `path` — a code-less passthrough.
70
+ The engine synthesizes `(e) => ({ event: e })`. Use paths to name and share
71
+ `before` chains across destinations. Validation: a path must declare at
72
+ least one of `package`, `before`, `next`, or `cache`.
73
+
74
+ **Schema & tooling:**
75
+ - Updated Zod schemas (cache, route, matcher).
76
+ - Updated MCP tool descriptions and resource references.
77
+ - Updated `flow_validate` to enforce the new constraints (`EMPTY_TRANSFORMER`
78
+ error code added).
79
+
80
+ **Migration:** Hard cut at the schema/type level. Configs using `cache.full`
81
+ will fail validation — rename to `stop`. Configs using `match: "*"` will fail
82
+ validation — omit `match`. Configs using `Route[]` first-match still work at
83
+ runtime (compiled as implicit `case`) but new configs should use `case`
84
+ explicitly.
85
+
86
+ `$schema: "v4"` is preserved. No version bump.
87
+
88
+ - Updated dependencies [1a8f2d7]
89
+ - Updated dependencies [1a8f2d7]
90
+ - Updated dependencies [dd9f5ad]
91
+ - Updated dependencies [6cdc362]
92
+ - Updated dependencies [28a8ac2]
93
+ - @walkeros/core@4.1.0-next-1778668930820
94
+ - @walkeros/collector@4.1.0-next-1778668930820
95
+ - @walkeros/server-core@4.1.0-next-1778668930820
96
+ - @walkeros/server-destination-api@4.1.0-next-1778668930820
97
+
98
+ ## 4.0.2
99
+
100
+ ### Patch Changes
101
+
102
+ - a6a0ea7: Rename routing types: `NextRule` to `Route`, `Next` to `RouteSpec`
103
+ (Zod schemas and `MatcherNext*` IDs renamed in step). Widen
104
+ `Flow.*.before/next` to `RouteSpec` so `Route[]` conditional routing
105
+ type-checks at the JSON layer. Fix the CLI bundler dropping `Route[]` data via
106
+ a narrowing cast on the inline path. Hard cut, no aliases; flow.json shape
107
+ unchanged.
108
+ - Updated dependencies [a6a0ea7]
109
+ - @walkeros/core@4.0.2
110
+ - @walkeros/collector@4.0.2
111
+ - @walkeros/server-core@4.0.2
112
+ - @walkeros/server-destination-api@4.0.2
113
+
114
+ ## 4.0.1
115
+
116
+ ### Patch Changes
117
+
7
118
  - abfb0bb: @walkeros/cli: Server bundles now use @vercel/nft to trace
8
119
  dependencies and copy only files actually used into dist/node_modules/. Pacote
9
120
  remains the install layer (driven by flow.json's config.bundle.packages field;
@@ -22,8 +133,6 @@
22
133
  annotation from package manifest. nft handles externalization automatically.
23
134
  No behavior change for consumers.
24
135
 
25
- ### Patch Changes
26
-
27
136
  - ed304b4: Bundler honors `walkerOS.bundle.external` declared in step-package
28
137
  package.json files. Listed packages are externalized from the ESM bundle and
29
138
  the bundler always installs them (plus their full transitive deps) into
@@ -95,13 +204,14 @@
95
204
  interpolation requires scalars. Deep paths and recursive resolution with cycle
96
205
  detection now supported. `Flow.Definitions`, `Flow.Primitive`, and the `$def.`
97
206
  reference syntax are removed.
207
+ - Updated dependencies [cb265eb]
98
208
  - Updated dependencies [381dfe7]
99
209
  - Updated dependencies [1524275]
100
210
  - Updated dependencies [03d7055]
101
- - @walkeros/core@4.1.0-next-1778161443961
102
- - @walkeros/collector@4.1.0-next-1778161443961
103
- - @walkeros/server-core@4.1.0-next-1778161443961
104
- - @walkeros/server-destination-api@4.1.0-next-1778161443961
211
+ - @walkeros/collector@4.0.1
212
+ - @walkeros/core@4.0.1
213
+ - @walkeros/server-core@4.0.1
214
+ - @walkeros/server-destination-api@4.0.1
105
215
 
106
216
  ## 4.0.0
107
217