@walkeros/server-destination-mparticle 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 ADDED
@@ -0,0 +1,125 @@
1
+ # @walkeros/server-destination-mparticle
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 mParticle CDP destination. Events are packaged into
104
+ batches and POSTed to the regional mParticle pod via the HTTP Events API using
105
+ Basic auth (apiKey / apiSecret). Supports user identities, user attributes,
106
+ consent state, pod selection, and environment targeting.
107
+ - 724f97e: Migrate every step example in every walkerOS package to the
108
+ standardized `[callable, ...args][]` shape introduced in `@walkeros/core`.
109
+ Every step example's `out` is now an array of effect tuples whose first
110
+ element is the callable's public SDK name (`'gtag'`, `'analytics.track'`,
111
+ `'fbq'`, `'dataLayer.push'`, `'sendServer'`, `'fetch'`, `'trackClient.track'`,
112
+ `'amplitude.track'`, `'fs.writeFile'`, `'producer.send'`, `'client.xadd'`,
113
+ `'client.send'`, `'dataset.table.insert'`, etc.). Source examples use `'elb'`
114
+ as the callable; transformer examples use the reserved `'return'` keyword;
115
+ store examples use store-operation callables (`'get'`, `'set'`). Tests capture
116
+ real calls on each component's spy and assert against `example.out` directly —
117
+ the hardcoded `PACKAGE_CALLS` registry in the app is no longer consulted
118
+ (emptied; plan #3 removes it structurally).
119
+
120
+ ### Patch Changes
121
+
122
+ - Updated dependencies [74940cc]
123
+ - Updated dependencies [525f5d9]
124
+ - @walkeros/core@3.4.0
125
+ - @walkeros/server-core@3.4.0
package/README.md CHANGED
@@ -4,58 +4,46 @@
4
4
  </a>
5
5
  </p>
6
6
 
7
- # Meta (CAPI) Destination for walkerOS
7
+ # @walkeros/server-destination-mparticle
8
8
 
9
- [Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/meta)
10
- &bull;
11
- [NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-meta)
9
+ Server-side event delivery to mParticle via the HTTP Events API, with support
10
+ for user identities, attributes, consent state, and environment targeting.
12
11
 
13
- walkerOS follows a **source → collector → destination** architecture. This Meta
14
- CAPI destination receives processed events from the walkerOS collector and sends
15
- them server-to-server to Meta's Conversions API, providing enhanced data
16
- accuracy and attribution for Meta advertising campaigns while bypassing browser
17
- limitations.
12
+ [Documentation](https://www.walkeros.io/docs/destinations/server/mparticle)
13
+ &bull;
14
+ [NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-mparticle)
15
+ &bull;
16
+ [Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/mparticle)
18
17
 
19
18
  ## Installation
20
19
 
21
- ```sh
22
- npm install @walkeros/server-destination-meta
20
+ ```bash
21
+ npm install @walkeros/server-destination-mparticle
23
22
  ```
24
23
 
25
- ## Usage
26
-
27
- Here's a basic example of how to use the Meta CAPI destination:
28
-
29
- ```typescript
30
- import { startFlow } from '@walkeros/collector';
31
- import { destinationMeta } from '@walkeros/server-destination-meta';
32
-
33
- await startFlow({
34
- destinations: {
35
- meta: {
36
- code: destinationMeta,
37
- config: {
38
- settings: {
39
- accessToken: 'YOUR_ACCESS_TOKEN',
40
- pixelId: 'YOUR_PIXEL_ID',
41
- },
42
- },
43
- },
44
- },
45
- });
24
+ ## Quick start
25
+
26
+ ```json
27
+ {
28
+ "version": 4,
29
+ "flows": {
30
+ "default": {
31
+ "config": { "platform": "server" },
32
+ "destinations": {
33
+ "mparticle": {
34
+ "package": "@walkeros/server-destination-mparticle",
35
+ "config": {}
36
+ }
37
+ }
38
+ }
39
+ }
40
+ }
46
41
  ```
47
42
 
48
- ## Configuration
43
+ ## Documentation
49
44
 
50
- | Name | Type | Description | Required | Example |
51
- | ----------------- | --------------------- | --------------------------------------------------------- | -------- | ---------------------------------------------- |
52
- | `accessToken` | `string` | Meta access token for Conversions API authentication | Yes | `'your_access_token'` |
53
- | `pixelId` | `string` | Meta Pixel ID from your Facebook Business account | Yes | `'1234567890'` |
54
- | `action_source` | `ActionSource` | Source of the event (website, app, phone_call, etc.) | No | `'website'` |
55
- | `doNotHash` | `string[]` | Array of user_data fields that should not be hashed | No | `['client_ip_address', 'client_user_agent']` |
56
- | `test_event_code` | `string` | Test event code for debugging Meta Conversions API events | No | `'TEST12345'` |
57
- | `url` | `string` | Custom URL for Meta Conversions API endpoint | No | `'https://graph.facebook.com/v17.0'` |
58
- | `user_data` | `WalkerOSMapping.Map` | Mapping configuration for user data fields | No | `{ email: 'user.email', phone: 'user.phone' }` |
45
+ Full configuration, mapping, and examples live in the docs:
46
+ **https://www.walkeros.io/docs/destinations/server/mparticle**
59
47
 
60
48
  ## Contribute
61
49
 
@@ -66,4 +54,4 @@ Feel free to contribute by submitting an
66
54
 
67
55
  ## License
68
56
 
69
- This project is licensed under the MIT License.
57
+ MIT
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$meta": {
3
3
  "package": "@walkeros/server-destination-mparticle",
4
- "version": "4.1.0-next-1778668930820",
4
+ "version": "4.1.0",
5
5
  "type": "destination",
6
6
  "platform": [
7
7
  "server"
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@walkeros/server-destination-mparticle",
3
3
  "description": "mParticle server destination for walkerOS",
4
- "version": "4.1.0-next-1778668930820",
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",
@@ -34,11 +35,11 @@
34
35
  "update": "npx npm-check-updates -u && npm update"
35
36
  },
36
37
  "dependencies": {
37
- "@walkeros/core": "4.1.0-next-1778668930820",
38
- "@walkeros/server-core": "4.1.0-next-1778668930820"
38
+ "@walkeros/core": "4.1.0",
39
+ "@walkeros/server-core": "4.1.0"
39
40
  },
40
41
  "devDependencies": {
41
- "@walkeros/collector": "4.1.0-next-1778668930820"
42
+ "@walkeros/collector": "4.1.0"
42
43
  },
43
44
  "repository": {
44
45
  "url": "git+https://github.com/elbwalker/walkerOS.git",