@walkeros/server-destination-api 4.1.0-next-1778668930820 → 4.1.0

package/CHANGELOG.md

@@ -0,0 +1,305 @@
+# @walkeros/server-destination-api
+
+## 4.1.0
+
+### Patch Changes
+
+- Updated dependencies [e155ff8]
+- Updated dependencies [e800974]
+- Updated dependencies [e155ff8]
+- Updated dependencies [1a8f2d7]
+- Updated dependencies [1a8f2d7]
+- Updated dependencies [b276173]
+- Updated dependencies [dd9f5ad]
+- Updated dependencies [c60ef35]
+- Updated dependencies [adeebea]
+- Updated dependencies [13aaeaa]
+- Updated dependencies [e800974]
+- Updated dependencies [adeebea]
+- Updated dependencies [e800974]
+- Updated dependencies [e800974]
+- Updated dependencies [058f7ed]
+- Updated dependencies [28a8ac2]
+- Updated dependencies [fd6076e]
+  - @walkeros/core@4.1.0
+  - @walkeros/server-core@4.1.0
+
+## 4.0.2
+
+### Patch Changes
+
+- Updated dependencies [a6a0ea7]
+  - @walkeros/core@4.0.2
+  - @walkeros/server-core@4.0.2
+
+## 4.0.1
+
+### Patch Changes
+
+- Updated dependencies [381dfe7]
+- Updated dependencies [1524275]
+- Updated dependencies [03d7055]
+  - @walkeros/core@4.0.1
+  - @walkeros/server-core@4.0.1
+
+## 4.0.0
+
+### Major Changes
+
+- 93ea9c4: Event model v4: breaking changes to the `Event`, `Source`, and
+  `Entity` shapes.
+  - `event.id` is now a W3C span_id (16 lowercase hex chars), generated by the
+    collector. Reference: W3C Trace Context (W3C Recommendation, January 2020).
+  - `event.version`, `event.group`, `event.count` are removed.
+  - `source.type` is now the source kind (e.g. `browser`, `gtag`, `mcp`, `cli`).
+    New `source.platform` holds the runtime (`web` | `server` | `app` | ...).
+  - `source.id` and `source.previous_id` are removed.
+  - Browser source now sets `source.url` and `source.referrer`.
+  - MCP source sets `source.tool` per emission. CLI source sets
+    `source.command`.
+  - `Entity.nested` and `Entity.context` are now optional. Root `event.nested`
+    and `event.context` remain required.
+  - Each source self-registers via TypeScript module augmentation of `SourceMap`
+    in `@walkeros/core`.
+  - App-side coordination (`/workspaces/developer/app`) is a follow-up plan, not
+    part of this release. Telemetry from v4 CLI/MCP will not validate against
+    the existing app schema until that follow-up ships.
+  - `Mapping.Rule.skip` is renamed to `Mapping.Rule.silent`. Customer flow.json
+    configs using `skip: true` in mapping rules must rename to `silent: true`.
+    Hard cut: no legacy alias, the field is gone.
+
+### Patch Changes
+
+- Updated dependencies [93ea9c4]
+- Updated dependencies [465775c]
+- Updated dependencies [942a7fe]
+- Updated dependencies [cfc7469]
+- Updated dependencies [8e06b1f]
+- Updated dependencies [3d50dd6]
+- Updated dependencies [1ef33d9]
+  - @walkeros/core@4.0.0
+  - @walkeros/server-core@4.0.0
+
+## 3.4.2
+
+### Patch Changes
+
+- @walkeros/core@3.4.2
+- @walkeros/server-core@3.4.2
+
+## 3.4.1
+
+### Patch Changes
+
+- Updated dependencies [12adf24]
+- Updated dependencies [75aa26b]
+  - @walkeros/core@3.4.1
+  - @walkeros/server-core@3.4.1
+
+## 3.4.0
+
+### Minor Changes
+
+- 724f97e: Migrate every step example in every walkerOS package to the
+  standardized `[callable, ...args][]` shape introduced in `@walkeros/core`.
+  Every step example's `out` is now an array of effect tuples whose first
+  element is the callable's public SDK name (`'gtag'`, `'analytics.track'`,
+  `'fbq'`, `'dataLayer.push'`, `'sendServer'`, `'fetch'`, `'trackClient.track'`,
+  `'amplitude.track'`, `'fs.writeFile'`, `'producer.send'`, `'client.xadd'`,
+  `'client.send'`, `'dataset.table.insert'`, etc.). Source examples use `'elb'`
+  as the callable; transformer examples use the reserved `'return'` keyword;
+  store examples use store-operation callables (`'get'`, `'set'`). Tests capture
+  real calls on each component's spy and assert against `example.out` directly —
+  the hardcoded `PACKAGE_CALLS` registry in the app is no longer consulted
+  (emptied; plan #3 removes it structurally).
+
+### Patch Changes
+
+- Updated dependencies [74940cc]
+- Updated dependencies [525f5d9]
+  - @walkeros/core@3.4.0
+  - @walkeros/server-core@3.4.0
+
+## 3.3.1
+
+### Patch Changes
+
+- @walkeros/server-core@3.3.1
+- @walkeros/core@3.3.1
+
+## 3.3.0
+
+### Patch Changes
+
+- Updated dependencies [2849acb]
+- Updated dependencies [08c365a]
+- Updated dependencies [08c365a]
+- Updated dependencies [08c365a]
+- Updated dependencies [08c365a]
+  - @walkeros/core@3.3.0
+  - @walkeros/server-core@3.3.0
+
+## 3.2.0
+
+### Patch Changes
+
+- Updated dependencies [eb865e1]
+- Updated dependencies [c0a53f9]
+- Updated dependencies [f007c9f]
+- Updated dependencies [bf2dc5b]
+- Updated dependencies [da0b640]
+  - @walkeros/core@3.2.0
+  - @walkeros/server-core@3.2.0
+
+## 3.1.1
+
+### Patch Changes
+
+- @walkeros/core@3.1.1
+- @walkeros/server-core@3.1.1
+
+## 3.1.0
+
+### Patch Changes
+
+- Updated dependencies [dfc6738]
+- Updated dependencies [966342b]
+- Updated dependencies [bee8ba7]
+- Updated dependencies [966342b]
+- Updated dependencies [df990d4]
+  - @walkeros/core@3.1.0
+  - @walkeros/server-core@3.1.0
+
+## 3.0.2
+
+### Patch Changes
+
+- @walkeros/core@3.0.2
+- @walkeros/server-core@3.0.2
+
+## 3.0.1
+
+### Patch Changes
+
+- @walkeros/core@3.0.1
+- @walkeros/server-core@3.0.1
+
+## 3.0.0
+
+### Patch Changes
+
+- 499e27a: Add sideEffects declarations to all packages for bundler tree-shaking
+  support.
+- Updated dependencies [2b259b6]
+- Updated dependencies [2614014]
+- Updated dependencies [6ae0ee3]
+- Updated dependencies [37299a9]
+- Updated dependencies [499e27a]
+- Updated dependencies [0e5eede]
+- Updated dependencies [d11f574]
+- Updated dependencies [d11f574]
+- Updated dependencies [1fe337a]
+- Updated dependencies [5cb84c1]
+- Updated dependencies [23f218a]
+- Updated dependencies [499e27a]
+- Updated dependencies [c83d909]
+- Updated dependencies [b6c8fa8]
+  - @walkeros/core@3.0.0
+  - @walkeros/server-core@3.0.0
+
+## 2.1.1
+
+### Patch Changes
+
+- Updated dependencies [fab477d]
+  - @walkeros/core@2.1.1
+  - @walkeros/server-core@2.1.1
+
+## 2.1.0
+
+### Minor Changes
+
+- 97df0b2: Step examples: upgrade all packages to blueprint pattern with inline
+  mapping, no intermediate variables, no `all` export
+
+### Patch Changes
+
+- Updated dependencies [7fc4cee]
+- Updated dependencies [7fc4cee]
+- Updated dependencies [cb2da05]
+- Updated dependencies [2bbe8c8]
+- Updated dependencies [3eb6416]
+- Updated dependencies [02a7958]
+- Updated dependencies [97df0b2]
+- Updated dependencies [97df0b2]
+- Updated dependencies [026c412]
+- Updated dependencies [7d38d9d]
+  - @walkeros/core@2.1.0
+  - @walkeros/server-core@2.1.0
+
+## 2.0.1
+
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies [7b2d750]
+  - @walkeros/core@1.4.0
+  - @walkeros/server-core@2.0.0
+
+## 1.0.5
+
+### Patch Changes
+
+- Updated dependencies [a4cc1ea]
+  - @walkeros/core@1.3.0
+  - @walkeros/server-core@1.0.5
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [7ad6cfb]
+  - @walkeros/core@1.2.2
+  - @walkeros/server-core@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- Updated dependencies [6256c12]
+  - @walkeros/core@1.2.1
+  - @walkeros/server-core@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [f39d9fb]
+- Updated dependencies [888bbdf]
+  - @walkeros/core@1.2.0
+  - @walkeros/server-core@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [b65b773]
+- Updated dependencies [20eca6e]
+  - @walkeros/core@1.1.0
+  - @walkeros/server-core@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- 67c9e1d: Hello World! walkerOS v1.0.0
+
+  Open-source event data collection. Collect event data for digital analytics in
+  a unified and privacy-centric way.
+
+### Patch Changes
+
+- Updated dependencies [67c9e1d]
+  - @walkeros/core@1.0.0
+  - @walkeros/server-core@1.0.0

package/README.md

@@ -4,147 +4,41 @@
   </a>
 </p>
 
-# API Destination for walkerOS
+# @walkeros/server-destination-api
 
-[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/api)
-&bull;
-[NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-api)
+Server-side HTTP API destination for Node.js.
 
-walkerOS follows a **source → collector → destination** architecture. This API
-destination receives processed events from the walkerOS collector and sends them
-to any HTTP(S) endpoint, enabling integration with custom APIs, webhooks, and
-third-party services.
+[Documentation](https://www.walkeros.io/docs/destinations/api/server) &bull;
+[NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-api)
+&bull;
+[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/api)
 
 ## Installation
 
-```sh
+```bash
 npm install @walkeros/server-destination-api
 ```
 
-## Quick Start
-
-Configure in your Flow JSON:
+## Quick start
 
 ```json
 {
-  "version": 3,
+  "version": 4,
   "flows": {
     "default": {
-      "server": {},
+      "config": { "platform": "server" },
       "destinations": {
-        "api": {
-          "package": "@walkeros/server-destination-api",
-          "config": {
-            "settings": {
-              "url": "https://api.example.com/events"
-            }
-          }
-        }
+        "api": { "package": "@walkeros/server-destination-api", "config": {} }
       }
     }
   }
 }
 ```
 
-Or programmatically:
-
-```typescript
-import { startFlow } from '@walkeros/collector';
-import { destinationAPI } from '@walkeros/server-destination-api';
-
-const { elb } = await startFlow({
-  destinations: [
-    {
-      destination: destinationAPI,
-      config: {
-        settings: {
-          url: 'https://api.example.com/events',
-          headers: {
-            Authorization: 'Bearer your-api-key',
-            'Content-Type': 'application/json',
-          },
-          method: 'POST',
-          timeout: 5000,
-        },
-      },
-    },
-  ],
-});
-```
-
-## Configuration
-
-| Name        | Type                     | Description                         | Required | Default |
-| ----------- | ------------------------ | ----------------------------------- | -------- | ------- |
-| `url`       | `string`                 | The API endpoint URL to send events | Yes      | -       |
-| `headers`   | `Record<string, string>` | Custom HTTP headers                 | No       | -       |
-| `method`    | `string`                 | HTTP method                         | No       | `POST`  |
-| `timeout`   | `number`                 | Request timeout in milliseconds     | No       | `5000`  |
-| `transform` | `Function`               | Custom data transformation function | No       | -       |
-
-## Features
-
-- **Flexible URL Configuration**: Send events to any HTTP(S) endpoint
-- **Custom Headers**: Add authentication tokens, API keys, or custom headers
-- **HTTP Method Control**: Use POST, PUT, PATCH, or any HTTP method
-- **Request Timeout**: Configure timeout for slow endpoints
-- **Data Transformation**: Transform event data before sending with custom
-  functions
-- **Dependency Injection**: Mock the sendServer function for testing
-
-## Advanced Usage
-
-### Custom Transform Function
-
-Transform event data before sending:
-
-```typescript
-import { destinationAPI } from '@walkeros/server-destination-api';
-
-const config = {
-  settings: {
-    url: 'https://api.example.com/events',
-    transform: (data, config, mapping) => {
-      // Return custom body (string or object)
-      return JSON.stringify({
-        eventType: data.event,
-        properties: data.data,
-        timestamp: Date.now(),
-      });
-    },
-  },
-};
-```
-
-### Using with Mapping
-
-Use walkerOS mapping to transform events:
-
-```typescript
-const config = {
-  settings: { url: 'https://api.example.com/events' },
-  mapping: {
-    page: {
-      view: {
-        data: {
-          map: {
-            pageUrl: 'data.path',
-            pageTitle: 'data.title',
-          },
-        },
-      },
-    },
-  },
-};
-```
-
-## Type Definitions
-
-See [src/types/](./src/types/) for TypeScript interfaces.
-
-## Related
+## Documentation
 
-- [Destination Interface](../../../core/src/types/destination.ts)
+Full configuration, mapping, and examples live in the docs:
+**https://www.walkeros.io/docs/destinations/api/server**
 
 ## Contribute
 
@@ -155,4 +49,4 @@ Feel free to contribute by submitting an
 
 ## License
 
-This project is licensed under the MIT License.
+MIT

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/server-destination-api",
-    "version": "4.1.0-next-1778668930820",
+    "version": "4.1.0",
     "type": "destination",
     "platform": [
       "server"
@@ -95,7 +95,7 @@
           "consent": {
             "functional": true
           },
-          "id": "d3259ac1ee7d6033",
+          "id": "5b006fa2d2b4e79d",
           "trigger": "test",
           "entity": "form",
           "action": "submit",
@@ -198,7 +198,7 @@
           "consent": {
             "functional": true
           },
-          "id": "59dfea2de510e141",
+          "id": "551fbeac8a2d6786",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -266,7 +266,7 @@
           "consent": {
             "functional": true
           },
-          "id": "111e51d4dadd93fe",
+          "id": "5baeeb192e7a3626",
           "trigger": "load",
           "entity": "page",
           "action": "view",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/server-destination-api",
   "description": "API server destination for walkerOS",
-  "version": "4.1.0-next-1778668930820",
+  "version": "4.1.0",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -25,7 +25,8 @@
     }
   },
   "files": [
-    "dist/**"
+    "dist/**",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup --silent",
@@ -37,8 +38,8 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/core": "4.1.0-next-1778668930820",
-    "@walkeros/server-core": "4.1.0-next-1778668930820"
+    "@walkeros/core": "4.1.0",
+    "@walkeros/server-core": "4.1.0"
   },
   "devDependencies": {},
   "repository": {