@walkeros/cli 4.1.0-next-1778668930820 → 4.1.0
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 +33 -5
- package/README.md +21 -712
- package/dist/cli.js +2263 -1811
- package/dist/examples/README.md +6 -8
- package/dist/examples/flow-complete.json +1 -19
- package/dist/examples/flow-complete.md +10 -13
- package/dist/examples/index.js +1 -19
- package/dist/examples/index.js.map +1 -1
- package/dist/examples/server-collect.json +2 -2
- package/dist/index.js +191 -115
- package/dist/index.js.map +1 -1
- package/examples/README.md +6 -8
- package/examples/flow-complete.json +1 -19
- package/examples/flow-complete.md +10 -13
- package/examples/server-collect.json +2 -2
- package/package.json +7 -7
package/examples/README.md
CHANGED
|
@@ -279,16 +279,13 @@ Flow configs use the `Flow.Config` format:
|
|
|
279
279
|
|
|
280
280
|
```json
|
|
281
281
|
{
|
|
282
|
-
"version":
|
|
282
|
+
"version": 4,
|
|
283
283
|
"flows": {
|
|
284
284
|
"default": {
|
|
285
|
-
"
|
|
286
|
-
"packages": {
|
|
287
|
-
"<package_name>": { "imports": ["<function_name>"] }
|
|
288
|
-
},
|
|
285
|
+
"config": { "platform": "web" },
|
|
289
286
|
"sources": {
|
|
290
287
|
"<source_name>": {
|
|
291
|
-
"
|
|
288
|
+
"package": "@walkeros/<package-name>",
|
|
292
289
|
"config": {
|
|
293
290
|
"settings": {
|
|
294
291
|
/* source config */
|
|
@@ -298,7 +295,7 @@ Flow configs use the `Flow.Config` format:
|
|
|
298
295
|
},
|
|
299
296
|
"destinations": {
|
|
300
297
|
"<destination_name>": {
|
|
301
|
-
"
|
|
298
|
+
"package": "@walkeros/<package-name>",
|
|
302
299
|
"config": {
|
|
303
300
|
"settings": {
|
|
304
301
|
/* destination config */
|
|
@@ -322,7 +319,8 @@ Flow configs use the `Flow.Config` format:
|
|
|
322
319
|
|
|
323
320
|
**Key points:**
|
|
324
321
|
|
|
325
|
-
- Platform via `
|
|
322
|
+
- Platform is set via `config: { "platform": "web" }` (or `"server"`)
|
|
323
|
+
- Each step references its npm package directly via `package`
|
|
326
324
|
- Output path is convention-based: `./dist/walker.js` (web) or
|
|
327
325
|
`./dist/bundle.mjs` (server)
|
|
328
326
|
|
|
@@ -600,24 +600,12 @@
|
|
|
600
600
|
"metaPixelId": "$env.META_PIXEL_ID:123456789012345",
|
|
601
601
|
"metaAccessToken": "$env.META_ACCESS_TOKEN:demo_token"
|
|
602
602
|
},
|
|
603
|
-
"stores": {
|
|
604
|
-
"cache": {
|
|
605
|
-
"package": "@walkeros/store-memory",
|
|
606
|
-
"config": {
|
|
607
|
-
"settings": {
|
|
608
|
-
"maxSize": 10485760,
|
|
609
|
-
"maxEntries": 1000
|
|
610
|
-
}
|
|
611
|
-
}
|
|
612
|
-
}
|
|
613
|
-
},
|
|
614
603
|
"sources": {
|
|
615
604
|
"http": {
|
|
616
605
|
"package": "@walkeros/server-source-express",
|
|
617
606
|
"primary": true,
|
|
618
607
|
"next": ["filter"],
|
|
619
608
|
"cache": {
|
|
620
|
-
"store": "cache",
|
|
621
609
|
"rules": [
|
|
622
610
|
{
|
|
623
611
|
"match": {
|
|
@@ -689,9 +677,6 @@
|
|
|
689
677
|
"push": "$code:(event) => event.name.startsWith('internal_') || event.name.startsWith('debug_') ? false : event"
|
|
690
678
|
},
|
|
691
679
|
"next": "fingerprint",
|
|
692
|
-
"env": {
|
|
693
|
-
"store": "$store.cache"
|
|
694
|
-
},
|
|
695
680
|
"config": {},
|
|
696
681
|
"examples": {
|
|
697
682
|
"passes-normal": {
|
|
@@ -932,10 +917,7 @@
|
|
|
932
917
|
"@walkeros/server-source-express": {},
|
|
933
918
|
"@walkeros/server-destination-meta": {},
|
|
934
919
|
"@walkeros/destination-demo": {},
|
|
935
|
-
"@walkeros/server-transformer-fingerprint": {}
|
|
936
|
-
"@walkeros/store-memory": {
|
|
937
|
-
"path": "../../stores/memory"
|
|
938
|
-
}
|
|
920
|
+
"@walkeros/server-transformer-fingerprint": {}
|
|
939
921
|
}
|
|
940
922
|
}
|
|
941
923
|
}
|
|
@@ -22,12 +22,12 @@ complete event tracking architecture.
|
|
|
22
22
|
│ HTTP Source ──▶ [Filter] ──▶ [Fingerprint] ──▶ Collector │
|
|
23
23
|
│ │ │ │ │
|
|
24
24
|
│ │ ingest: │ env: ▼ │
|
|
25
|
-
│ │ IP, UA, │
|
|
25
|
+
│ │ IP, UA, │ filter rules Meta Destination │
|
|
26
26
|
│ │ lang, ref, │ Demo Destination │
|
|
27
27
|
│ │ anon-IP(fn) │ │
|
|
28
28
|
│ └──────────────┘ │
|
|
29
29
|
│ │
|
|
30
|
-
│
|
|
30
|
+
│ Source cache: built-in tier (ttl 300s, on GET ingest.method+path) │
|
|
31
31
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
32
32
|
```
|
|
33
33
|
|
|
@@ -110,14 +110,13 @@ npx walkeros run packages/cli/examples/flow-complete.json --flow web
|
|
|
110
110
|
|
|
111
111
|
#### Variables
|
|
112
112
|
|
|
113
|
-
| Feature | Location
|
|
114
|
-
| -------------------- |
|
|
115
|
-
| Root-level variables | Root
|
|
116
|
-
| Flow-level variables | server.variables
|
|
117
|
-
| Environment variable | Variables
|
|
118
|
-
| Env with default | Variables
|
|
119
|
-
| $var reference | GA4 settings
|
|
120
|
-
| $store reference | filter transformer | `"env": { "store": "$store.cache" }` |
|
|
113
|
+
| Feature | Location | Example |
|
|
114
|
+
| -------------------- | ---------------- | ---------------------------------------------- |
|
|
115
|
+
| Root-level variables | Root | `"currency": "EUR"` |
|
|
116
|
+
| Flow-level variables | server.variables | `"metaPixelId": "$env.META_PIXEL_ID:..."` |
|
|
117
|
+
| Environment variable | Variables | `"$env.GA4_MEASUREMENT_ID:G-DEMO123456"` |
|
|
118
|
+
| Env with default | Variables | `"$env.API_URL:http://localhost:8080/collect"` |
|
|
119
|
+
| $var reference | GA4 settings | `"$var.ga4MeasurementId"` |
|
|
121
120
|
|
|
122
121
|
#### Sources
|
|
123
122
|
|
|
@@ -174,12 +173,10 @@ npx walkeros run packages/cli/examples/flow-complete.json --flow web
|
|
|
174
173
|
| Policy consent-gated | Meta | `"user_data.em"` with consent |
|
|
175
174
|
| Policy nested map | Meta | `"custom_data.request_meta": { "map": {...} }` |
|
|
176
175
|
| Local package path | server packages | `"path": "../../core"` (resolve from filesystem) |
|
|
177
|
-
| Source cache | http source | `"cache": { "
|
|
176
|
+
| Source cache | http source | `"cache": { "rules": [...] }` (built-in tier) |
|
|
178
177
|
| Cache match rule | http source | `"match": { "key": "ingest.method", "operator": "eq", "value": "GET" }` |
|
|
179
178
|
| Cache TTL | http source | `"ttl": 300` (seconds) |
|
|
180
179
|
| Cache response update | http source | `"update": { "headers.X-Cache": { "key": "cache.status" } }` |
|
|
181
|
-
| Store definition | server stores | `"cache": { "package": "@walkeros/store-memory", ... }` |
|
|
182
|
-
| Store settings | cache store | `"maxSize": 10485760, "maxEntries": 1000` |
|
|
183
180
|
|
|
184
181
|
#### Browser Source
|
|
185
182
|
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"sources": {
|
|
6
6
|
"http": {
|
|
7
7
|
"package": "@walkeros/server-source-express",
|
|
8
|
-
"
|
|
8
|
+
"import": "sourceExpress",
|
|
9
9
|
"config": {
|
|
10
10
|
"settings": {
|
|
11
11
|
"path": "/collect",
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"destinations": {
|
|
20
20
|
"demo": {
|
|
21
21
|
"package": "@walkeros/destination-demo",
|
|
22
|
-
"
|
|
22
|
+
"import": "destinationDemo",
|
|
23
23
|
"config": {
|
|
24
24
|
"settings": {
|
|
25
25
|
"name": "Server Collection Demo",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@walkeros/cli",
|
|
3
|
-
"version": "4.1.0
|
|
3
|
+
"version": "4.1.0",
|
|
4
4
|
"description": "walkerOS CLI - Bundle and deploy walkerOS components",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -50,10 +50,10 @@
|
|
|
50
50
|
},
|
|
51
51
|
"dependencies": {
|
|
52
52
|
"@vercel/nft": "1.5.0",
|
|
53
|
-
"@walkeros/collector": "4.1.0
|
|
54
|
-
"@walkeros/core": "4.1.0
|
|
55
|
-
"@walkeros/server-core": "4.1.0
|
|
56
|
-
"@walkeros/server-destination-api": "4.1.0
|
|
53
|
+
"@walkeros/collector": "4.1.0",
|
|
54
|
+
"@walkeros/core": "4.1.0",
|
|
55
|
+
"@walkeros/server-core": "4.1.0",
|
|
56
|
+
"@walkeros/server-destination-api": "4.1.0",
|
|
57
57
|
"ajv": "^8.17.1",
|
|
58
58
|
"chalk": "^5.6.2",
|
|
59
59
|
"ci-info": "^4.4.0",
|
|
@@ -79,8 +79,8 @@
|
|
|
79
79
|
"@types/pacote": "^11.1.8",
|
|
80
80
|
"@types/picomatch": "4.0.3",
|
|
81
81
|
"@types/semver": "^7.7.1",
|
|
82
|
-
"@walkeros/config": "4.1.0
|
|
83
|
-
"@walkeros/core": "4.1.0
|
|
82
|
+
"@walkeros/config": "4.1.0",
|
|
83
|
+
"@walkeros/core": "4.1.0",
|
|
84
84
|
"msw": "^2.12.10",
|
|
85
85
|
"openapi-typescript": "^7.13.0",
|
|
86
86
|
"tsx": "^4.21.0"
|