@walkeros/server-destination-rudderstack 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 +126 -0
- package/README.md +34 -52
- package/dist/walkerOS.json +11 -11
- package/package.json +6 -5
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# @walkeros/server-destination-rudderstack
|
|
2
|
+
|
|
3
|
+
## 4.1.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [e155ff8]
|
|
8
|
+
- Updated dependencies [e800974]
|
|
9
|
+
- Updated dependencies [e155ff8]
|
|
10
|
+
- Updated dependencies [1a8f2d7]
|
|
11
|
+
- Updated dependencies [1a8f2d7]
|
|
12
|
+
- Updated dependencies [b276173]
|
|
13
|
+
- Updated dependencies [dd9f5ad]
|
|
14
|
+
- Updated dependencies [c60ef35]
|
|
15
|
+
- Updated dependencies [adeebea]
|
|
16
|
+
- Updated dependencies [13aaeaa]
|
|
17
|
+
- Updated dependencies [e800974]
|
|
18
|
+
- Updated dependencies [adeebea]
|
|
19
|
+
- Updated dependencies [e800974]
|
|
20
|
+
- Updated dependencies [e800974]
|
|
21
|
+
- Updated dependencies [058f7ed]
|
|
22
|
+
- Updated dependencies [28a8ac2]
|
|
23
|
+
- Updated dependencies [fd6076e]
|
|
24
|
+
- @walkeros/core@4.1.0
|
|
25
|
+
- @walkeros/server-core@4.1.0
|
|
26
|
+
|
|
27
|
+
## 4.0.2
|
|
28
|
+
|
|
29
|
+
### Patch Changes
|
|
30
|
+
|
|
31
|
+
- Updated dependencies [a6a0ea7]
|
|
32
|
+
- @walkeros/core@4.0.2
|
|
33
|
+
- @walkeros/server-core@4.0.2
|
|
34
|
+
|
|
35
|
+
## 4.0.1
|
|
36
|
+
|
|
37
|
+
### Patch Changes
|
|
38
|
+
|
|
39
|
+
- Updated dependencies [381dfe7]
|
|
40
|
+
- Updated dependencies [1524275]
|
|
41
|
+
- Updated dependencies [03d7055]
|
|
42
|
+
- @walkeros/core@4.0.1
|
|
43
|
+
- @walkeros/server-core@4.0.1
|
|
44
|
+
|
|
45
|
+
## 4.0.0
|
|
46
|
+
|
|
47
|
+
### Major Changes
|
|
48
|
+
|
|
49
|
+
- 93ea9c4: Event model v4: breaking changes to the `Event`, `Source`, and
|
|
50
|
+
`Entity` shapes.
|
|
51
|
+
- `event.id` is now a W3C span_id (16 lowercase hex chars), generated by the
|
|
52
|
+
collector. Reference: W3C Trace Context (W3C Recommendation, January 2020).
|
|
53
|
+
- `event.version`, `event.group`, `event.count` are removed.
|
|
54
|
+
- `source.type` is now the source kind (e.g. `browser`, `gtag`, `mcp`, `cli`).
|
|
55
|
+
New `source.platform` holds the runtime (`web` | `server` | `app` | ...).
|
|
56
|
+
- `source.id` and `source.previous_id` are removed.
|
|
57
|
+
- Browser source now sets `source.url` and `source.referrer`.
|
|
58
|
+
- MCP source sets `source.tool` per emission. CLI source sets
|
|
59
|
+
`source.command`.
|
|
60
|
+
- `Entity.nested` and `Entity.context` are now optional. Root `event.nested`
|
|
61
|
+
and `event.context` remain required.
|
|
62
|
+
- Each source self-registers via TypeScript module augmentation of `SourceMap`
|
|
63
|
+
in `@walkeros/core`.
|
|
64
|
+
- App-side coordination (`/workspaces/developer/app`) is a follow-up plan, not
|
|
65
|
+
part of this release. Telemetry from v4 CLI/MCP will not validate against
|
|
66
|
+
the existing app schema until that follow-up ships.
|
|
67
|
+
- `Mapping.Rule.skip` is renamed to `Mapping.Rule.silent`. Customer flow.json
|
|
68
|
+
configs using `skip: true` in mapping rules must rename to `silent: true`.
|
|
69
|
+
Hard cut: no legacy alias, the field is gone.
|
|
70
|
+
|
|
71
|
+
### Patch Changes
|
|
72
|
+
|
|
73
|
+
- Updated dependencies [93ea9c4]
|
|
74
|
+
- Updated dependencies [465775c]
|
|
75
|
+
- Updated dependencies [942a7fe]
|
|
76
|
+
- Updated dependencies [cfc7469]
|
|
77
|
+
- Updated dependencies [8e06b1f]
|
|
78
|
+
- Updated dependencies [3d50dd6]
|
|
79
|
+
- Updated dependencies [1ef33d9]
|
|
80
|
+
- @walkeros/core@4.0.0
|
|
81
|
+
- @walkeros/server-core@4.0.0
|
|
82
|
+
|
|
83
|
+
## 3.4.2
|
|
84
|
+
|
|
85
|
+
### Patch Changes
|
|
86
|
+
|
|
87
|
+
- @walkeros/core@3.4.2
|
|
88
|
+
- @walkeros/server-core@3.4.2
|
|
89
|
+
|
|
90
|
+
## 3.4.1
|
|
91
|
+
|
|
92
|
+
### Patch Changes
|
|
93
|
+
|
|
94
|
+
- Updated dependencies [12adf24]
|
|
95
|
+
- Updated dependencies [75aa26b]
|
|
96
|
+
- @walkeros/core@3.4.1
|
|
97
|
+
- @walkeros/server-core@3.4.1
|
|
98
|
+
|
|
99
|
+
## 3.4.0
|
|
100
|
+
|
|
101
|
+
### Minor Changes
|
|
102
|
+
|
|
103
|
+
- 74940cc: Add server-side RudderStack CDP destination with full Segment Spec
|
|
104
|
+
support (Track, Identify, Group, Page, Screen, Alias) via
|
|
105
|
+
@rudderstack/rudder-sdk-node SDK. Includes graceful shutdown via flush(),
|
|
106
|
+
identity resolution per-call, alias support for identity merging, and state
|
|
107
|
+
diffing for identify/group.
|
|
108
|
+
- 724f97e: Migrate every step example in every walkerOS package to the
|
|
109
|
+
standardized `[callable, ...args][]` shape introduced in `@walkeros/core`.
|
|
110
|
+
Every step example's `out` is now an array of effect tuples whose first
|
|
111
|
+
element is the callable's public SDK name (`'gtag'`, `'analytics.track'`,
|
|
112
|
+
`'fbq'`, `'dataLayer.push'`, `'sendServer'`, `'fetch'`, `'trackClient.track'`,
|
|
113
|
+
`'amplitude.track'`, `'fs.writeFile'`, `'producer.send'`, `'client.xadd'`,
|
|
114
|
+
`'client.send'`, `'dataset.table.insert'`, etc.). Source examples use `'elb'`
|
|
115
|
+
as the callable; transformer examples use the reserved `'return'` keyword;
|
|
116
|
+
store examples use store-operation callables (`'get'`, `'set'`). Tests capture
|
|
117
|
+
real calls on each component's spy and assert against `example.out` directly —
|
|
118
|
+
the hardcoded `PACKAGE_CALLS` registry in the app is no longer consulted
|
|
119
|
+
(emptied; plan #3 removes it structurally).
|
|
120
|
+
|
|
121
|
+
### Patch Changes
|
|
122
|
+
|
|
123
|
+
- Updated dependencies [74940cc]
|
|
124
|
+
- Updated dependencies [525f5d9]
|
|
125
|
+
- @walkeros/core@3.4.0
|
|
126
|
+
- @walkeros/server-core@3.4.0
|
package/README.md
CHANGED
|
@@ -1,9 +1,20 @@
|
|
|
1
|
+
<p align="left">
|
|
2
|
+
<a href="https://www.walkeros.io">
|
|
3
|
+
<img alt="walkerOS" title="walkerOS" src="https://www.walkeros.io/img/walkerOS_logo.svg" width="256px"/>
|
|
4
|
+
</a>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
1
7
|
# @walkeros/server-destination-rudderstack
|
|
2
8
|
|
|
3
|
-
Server-side RudderStack
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
9
|
+
Server-side event delivery to RudderStack via the official rudder-sdk-node SDK,
|
|
10
|
+
implementing the full Segment Spec surface with automatic identity
|
|
11
|
+
deduplication.
|
|
12
|
+
|
|
13
|
+
[Documentation](https://www.walkeros.io/docs/destinations/server/rudderstack)
|
|
14
|
+
•
|
|
15
|
+
[NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-rudderstack)
|
|
16
|
+
•
|
|
17
|
+
[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/rudderstack)
|
|
7
18
|
|
|
8
19
|
## Installation
|
|
9
20
|
|
|
@@ -11,19 +22,18 @@ Segment Spec support (Track, Identify, Group, Page, Screen, Alias).
|
|
|
11
22
|
npm install @walkeros/server-destination-rudderstack
|
|
12
23
|
```
|
|
13
24
|
|
|
14
|
-
## Quick
|
|
25
|
+
## Quick start
|
|
15
26
|
|
|
16
27
|
```json
|
|
17
28
|
{
|
|
18
|
-
"
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
"config": {
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
"anonymousId": "user.session"
|
|
29
|
+
"version": 4,
|
|
30
|
+
"flows": {
|
|
31
|
+
"default": {
|
|
32
|
+
"config": { "platform": "server" },
|
|
33
|
+
"destinations": {
|
|
34
|
+
"rudderstack": {
|
|
35
|
+
"package": "@walkeros/server-destination-rudderstack",
|
|
36
|
+
"config": {}
|
|
27
37
|
}
|
|
28
38
|
}
|
|
29
39
|
}
|
|
@@ -31,46 +41,18 @@ npm install @walkeros/server-destination-rudderstack
|
|
|
31
41
|
}
|
|
32
42
|
```
|
|
33
43
|
|
|
34
|
-
##
|
|
35
|
-
|
|
36
|
-
| Setting | Type | Required | Default | Description |
|
|
37
|
-
| --------------- | ------------ | -------- | ---------------- | ----------------------------------------------- |
|
|
38
|
-
| `writeKey` | string | Yes | -- | RudderStack source write key |
|
|
39
|
-
| `dataPlaneUrl` | string | Yes | -- | RudderStack data plane URL |
|
|
40
|
-
| `userId` | string | No | `'user.id'` | Mapping path to resolve userId from events |
|
|
41
|
-
| `anonymousId` | string | No | `'user.session'` | Mapping path to resolve anonymousId from events |
|
|
42
|
-
| `identify` | MappingValue | No | -- | Destination-level identity mapping |
|
|
43
|
-
| `group` | MappingValue | No | -- | Destination-level group mapping |
|
|
44
|
-
| `flushAt` | number | No | `20` | Events to enqueue before flushing |
|
|
45
|
-
| `flushInterval` | number | No | `10000` | Max ms before auto-flush |
|
|
46
|
-
| `retryCount` | number | No | `3` | Retry attempts for failed batches |
|
|
47
|
-
| `gzip` | boolean | No | `true` | Enable gzip compression |
|
|
48
|
-
| `integrations` | Record | No | -- | Downstream destination filtering |
|
|
49
|
-
|
|
50
|
-
## Mapping Settings
|
|
51
|
-
|
|
52
|
-
Per-event mapping settings control which RudderStack methods are called:
|
|
53
|
-
|
|
54
|
-
| Setting | Effect | Use with `silent: true` |
|
|
55
|
-
| ---------- | ---------------------------- | ------------------------ |
|
|
56
|
-
| `identify` | Calls `analytics.identify()` | Yes, for login events |
|
|
57
|
-
| `group` | Calls `analytics.group()` | Yes, for company events |
|
|
58
|
-
| `page` | Calls `analytics.page()` | Yes, for page views |
|
|
59
|
-
| `screen` | Calls `analytics.screen()` | Yes, for mobile screens |
|
|
60
|
-
| `alias` | Calls `analytics.alias()` | Yes, for identity merges |
|
|
61
|
-
|
|
62
|
-
## Identity
|
|
44
|
+
## Documentation
|
|
63
45
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
paths and attaches them to every SDK call.
|
|
46
|
+
Full configuration, mapping, and examples live in the docs:
|
|
47
|
+
**https://www.walkeros.io/docs/destinations/server/rudderstack**
|
|
67
48
|
|
|
68
|
-
##
|
|
49
|
+
## Contribute
|
|
69
50
|
|
|
70
|
-
|
|
71
|
-
|
|
51
|
+
Feel free to contribute by submitting an
|
|
52
|
+
[issue](https://github.com/elbwalker/walkerOS/issues), starting a
|
|
53
|
+
[discussion](https://github.com/elbwalker/walkerOS/discussions), or getting in
|
|
54
|
+
[contact](https://calendly.com/elb-alexander/30min).
|
|
72
55
|
|
|
73
|
-
##
|
|
56
|
+
## License
|
|
74
57
|
|
|
75
|
-
|
|
76
|
-
buffered events are sent before process exit.
|
|
58
|
+
MIT
|
package/dist/walkerOS.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$meta": {
|
|
3
3
|
"package": "@walkeros/server-destination-rudderstack",
|
|
4
|
-
"version": "4.1.0
|
|
4
|
+
"version": "4.1.0",
|
|
5
5
|
"type": "destination",
|
|
6
6
|
"platform": [
|
|
7
7
|
"server"
|
|
@@ -194,7 +194,7 @@
|
|
|
194
194
|
"consent": {
|
|
195
195
|
"functional": true
|
|
196
196
|
},
|
|
197
|
-
"id": "
|
|
197
|
+
"id": "cf6d1cd86f3c937f",
|
|
198
198
|
"trigger": "test",
|
|
199
199
|
"entity": "identity",
|
|
200
200
|
"action": "merge",
|
|
@@ -257,7 +257,7 @@
|
|
|
257
257
|
"consent": {
|
|
258
258
|
"functional": true
|
|
259
259
|
},
|
|
260
|
-
"id": "
|
|
260
|
+
"id": "43b7812eb2c71e3e",
|
|
261
261
|
"trigger": "load",
|
|
262
262
|
"entity": "product",
|
|
263
263
|
"action": "view",
|
|
@@ -319,7 +319,7 @@
|
|
|
319
319
|
"consent": {
|
|
320
320
|
"functional": true
|
|
321
321
|
},
|
|
322
|
-
"id": "
|
|
322
|
+
"id": "6a0968c09043cd7c",
|
|
323
323
|
"trigger": "test",
|
|
324
324
|
"entity": "company",
|
|
325
325
|
"action": "update",
|
|
@@ -396,7 +396,7 @@
|
|
|
396
396
|
"consent": {
|
|
397
397
|
"functional": true
|
|
398
398
|
},
|
|
399
|
-
"id": "
|
|
399
|
+
"id": "28bf395560ed835d",
|
|
400
400
|
"trigger": "load",
|
|
401
401
|
"entity": "product",
|
|
402
402
|
"action": "view",
|
|
@@ -461,7 +461,7 @@
|
|
|
461
461
|
"consent": {
|
|
462
462
|
"functional": true
|
|
463
463
|
},
|
|
464
|
-
"id": "
|
|
464
|
+
"id": "902850aa39552aba",
|
|
465
465
|
"trigger": "load",
|
|
466
466
|
"entity": "page",
|
|
467
467
|
"action": "view",
|
|
@@ -586,7 +586,7 @@
|
|
|
586
586
|
"consent": {
|
|
587
587
|
"functional": true
|
|
588
588
|
},
|
|
589
|
-
"id": "
|
|
589
|
+
"id": "c767df9380f7b361",
|
|
590
590
|
"trigger": "load",
|
|
591
591
|
"entity": "order",
|
|
592
592
|
"action": "complete",
|
|
@@ -649,7 +649,7 @@
|
|
|
649
649
|
"consent": {
|
|
650
650
|
"functional": true
|
|
651
651
|
},
|
|
652
|
-
"id": "
|
|
652
|
+
"id": "b4f3b9c328401dee",
|
|
653
653
|
"trigger": "load",
|
|
654
654
|
"entity": "page",
|
|
655
655
|
"action": "view",
|
|
@@ -727,7 +727,7 @@
|
|
|
727
727
|
"consent": {
|
|
728
728
|
"functional": true
|
|
729
729
|
},
|
|
730
|
-
"id": "
|
|
730
|
+
"id": "7a87384877a7cfe6",
|
|
731
731
|
"trigger": "test",
|
|
732
732
|
"entity": "screen",
|
|
733
733
|
"action": "view",
|
|
@@ -806,7 +806,7 @@
|
|
|
806
806
|
"consent": {
|
|
807
807
|
"functional": true
|
|
808
808
|
},
|
|
809
|
-
"id": "
|
|
809
|
+
"id": "86135833a7ee1e71",
|
|
810
810
|
"trigger": "test",
|
|
811
811
|
"entity": "user",
|
|
812
812
|
"action": "login",
|
|
@@ -891,7 +891,7 @@
|
|
|
891
891
|
"consent": {
|
|
892
892
|
"functional": true
|
|
893
893
|
},
|
|
894
|
-
"id": "
|
|
894
|
+
"id": "cd4f5ae6f22bea34",
|
|
895
895
|
"trigger": "test",
|
|
896
896
|
"entity": "debug",
|
|
897
897
|
"action": "noise",
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@walkeros/server-destination-rudderstack",
|
|
3
3
|
"description": "RudderStack CDP server destination for walkerOS (@rudderstack/rudder-sdk-node, full Segment Spec)",
|
|
4
|
-
"version": "4.1.0
|
|
4
|
+
"version": "4.1.0",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"exports": {
|
|
7
7
|
".": {
|
|
@@ -22,7 +22,8 @@
|
|
|
22
22
|
}
|
|
23
23
|
},
|
|
24
24
|
"files": [
|
|
25
|
-
"dist/**"
|
|
25
|
+
"dist/**",
|
|
26
|
+
"CHANGELOG.md"
|
|
26
27
|
],
|
|
27
28
|
"scripts": {
|
|
28
29
|
"build": "tsup --silent",
|
|
@@ -35,11 +36,11 @@
|
|
|
35
36
|
},
|
|
36
37
|
"dependencies": {
|
|
37
38
|
"@rudderstack/rudder-sdk-node": "^3.0.0",
|
|
38
|
-
"@walkeros/core": "4.1.0
|
|
39
|
-
"@walkeros/server-core": "4.1.0
|
|
39
|
+
"@walkeros/core": "4.1.0",
|
|
40
|
+
"@walkeros/server-core": "4.1.0"
|
|
40
41
|
},
|
|
41
42
|
"devDependencies": {
|
|
42
|
-
"@walkeros/collector": "4.1.0
|
|
43
|
+
"@walkeros/collector": "4.1.0"
|
|
43
44
|
},
|
|
44
45
|
"repository": {
|
|
45
46
|
"url": "git+https://github.com/elbwalker/walkerOS.git",
|