@walkeros/server-destination-mixpanel 3.3.0-next-1776098542393

package/README.md

@@ -0,0 +1,145 @@
+# @walkeros/server-destination-mixpanel
+
+Server-side Mixpanel destination for walkerOS. Forwards events via the
+`mixpanel` Node.js SDK, supporting track, import, people operations, group
+analytics, and identity mapping.
+
+## Installation
+
+```bash
+npm install @walkeros/server-destination-mixpanel
+```
+
+## Minimal Config
+
+```json
+{
+  "destinations": {
+    "mixpanel": {
+      "package": "@walkeros/server-destination-mixpanel",
+      "config": {
+        "settings": {
+          "apiKey": "$env:MIXPANEL_TOKEN"
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting     | Type     | Required | Default            | Description                                         |
+| ----------- | -------- | -------- | ------------------ | --------------------------------------------------- |
+| `apiKey`    | string   | Yes      | -                  | Mixpanel project token                              |
+| `secret`    | string   | No       | -                  | API secret for /import endpoint                     |
+| `host`      | string   | No       | `api.mixpanel.com` | API host (EU: `api-eu.mixpanel.com`)                |
+| `protocol`  | string   | No       | `https`            | Request protocol                                    |
+| `keepAlive` | boolean  | No       | `true`             | Reuse HTTP connections                              |
+| `geolocate` | boolean  | No       | `false`            | Parse IP for geolocation                            |
+| `debug`     | boolean  | No       | `false`            | Enable SDK debug logging                            |
+| `verbose`   | boolean  | No       | `false`            | Enable verbose request logging                      |
+| `test`      | boolean  | No       | `false`            | Dry-run mode                                        |
+| `useImport` | boolean  | No       | `false`            | Use /import instead of /track                       |
+| `identify`  | mapping  | No       | -                  | Identity mapping resolving `{ distinctId, alias? }` |
+| `include`   | string[] | No       | -                  | Event sections to flatten into properties           |
+| `group`     | mapping  | No       | -                  | Group association resolving `{ key, id }`           |
+
+## Mapping Settings
+
+Per-event settings configured in `mapping.<entity>.<action>.settings`:
+
+| Key            | Description                                     |
+| -------------- | ----------------------------------------------- |
+| `identify`     | Override destination-level identity             |
+| `people`       | People profile operations (set, set_once, etc.) |
+| `group`        | Group association for this event                |
+| `groupProfile` | Group profile operations (set, set_once, etc.)  |
+| `useImport`    | Use /import for this event                      |
+
+## Track vs Import
+
+By default, events are sent via `/track` (real-time, last 5 days only). Set
+`useImport: true` for historical data (any age, requires `secret`):
+
+```json
+{
+  "settings": {
+    "apiKey": "$env:MIXPANEL_TOKEN",
+    "secret": "$env:MIXPANEL_API_SECRET",
+    "useImport": true
+  }
+}
+```
+
+## People Operations
+
+```json
+{
+  "mapping": {
+    "user": {
+      "login": {
+        "skip": true,
+        "settings": {
+          "identify": { "map": { "distinctId": "data.user_id" } },
+          "people": {
+            "map": {
+              "set": { "map": { "email": "data.email", "plan": "data.plan" } },
+              "set_once": { "map": { "first_login": "timestamp" } },
+              "increment": { "map": { "login_count": { "value": 1 } } }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+Supported operations: `set`, `set_once`, `increment`, `append`, `union`,
+`remove`, `unset`, `delete_user`.
+
+## Group Analytics
+
+Attach group to events:
+
+```json
+{
+  "settings": {
+    "group": {
+      "map": {
+        "key": { "value": "company_id" },
+        "id": "data.company_id"
+      }
+    }
+  }
+}
+```
+
+Update group profiles:
+
+```json
+{
+  "mapping": {
+    "company": {
+      "update": {
+        "skip": true,
+        "settings": {
+          "groupProfile": {
+            "map": {
+              "key": { "value": "company_id" },
+              "id": "data.company_id",
+              "set": {
+                "map": {
+                  "name": "data.company_name",
+                  "plan": "data.plan"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```

package/dist/dev.d.mts

@@ -0,0 +1,197 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { Mapping as Mapping$1, Flow } from '@walkeros/core';
+import { DestinationServer } from '@walkeros/server-core';
+
+declare const SettingsSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    secret: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodString>;
+    keepAlive: z.ZodOptional<z.ZodBoolean>;
+    geolocate: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    test: z.ZodOptional<z.ZodBoolean>;
+    useImport: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    include: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    identify: z.ZodOptional<z.ZodUnknown>;
+    people: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    groupProfile: z.ZodOptional<z.ZodUnknown>;
+    useImport: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+type MixpanelCallback = (err: Error | undefined) => void;
+/**
+ * Subset of the Mixpanel People API used by the destination.
+ * Every method requires `distinct_id` as the first argument (stateless server SDK).
+ */
+interface MixpanelPeople {
+    set(distinctId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    set_once(distinctId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    increment(distinctId: string, properties: Record<string, number>, callback?: MixpanelCallback): void;
+    append(distinctId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    union(distinctId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    remove(distinctId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    unset(distinctId: string, propertyName: string | string[], callback?: MixpanelCallback): void;
+    delete_user(distinctId: string, callback?: MixpanelCallback): void;
+}
+/**
+ * Subset of the Mixpanel Groups API used by the destination.
+ * Every method requires `(groupKey, groupId)` as the first two args.
+ */
+interface MixpanelGroups {
+    set(groupKey: string, groupId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    set_once(groupKey: string, groupId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    union(groupKey: string, groupId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    remove(groupKey: string, groupId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    unset(groupKey: string, groupId: string, propertyName: string | string[], callback?: MixpanelCallback): void;
+    delete_group(groupKey: string, groupId: string, callback?: MixpanelCallback): void;
+}
+/**
+ * Subset of the Mixpanel SDK instance the destination uses.
+ */
+interface MixpanelClient {
+    track(eventName: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    import(eventName: string, time: Date | number, properties?: Record<string, unknown>, callback?: MixpanelCallback): void;
+    alias(distinctId: string, alias: string, callback?: MixpanelCallback): void;
+    people: MixpanelPeople;
+    groups: MixpanelGroups;
+}
+interface Settings {
+    apiKey: string;
+    secret?: string;
+    host?: string;
+    protocol?: string;
+    keepAlive?: boolean;
+    geolocate?: boolean;
+    debug?: boolean;
+    verbose?: boolean;
+    test?: boolean;
+    identify?: Mapping$1.Value;
+    group?: Mapping$1.Value;
+    include?: string[];
+    useImport?: boolean;
+    /** Initialized Mixpanel client instance — set during init(). */
+    client?: MixpanelClient;
+}
+/**
+ * Environment with optional Mixpanel constructor override for testing.
+ * Follows the same pattern as GCP BigQuery's `env.BigQuery`.
+ */
+interface Env extends DestinationServer.Env {
+    Mixpanel?: {
+        init: (...args: unknown[]) => MixpanelClient;
+    };
+}
+
+/**
+ * Standard mock environment for push operations.
+ * The test runner clones this and replaces methods with spies.
+ */
+declare const push: Env;
+/** Simulation tracking paths for CLI --simulate. */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Step examples may carry destination-level settings and configInclude.
+ * The test runner reads these to configure the destination.
+ */
+type MixpanelStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+    configInclude?: string[];
+};
+/**
+ * Default event forwarding — every walkerOS event becomes
+ * mp.track(event.name, { distinct_id, ...properties }).
+ * With default settings.identify resolving user.id.
+ */
+declare const defaultEventForwarding: MixpanelStepExample;
+/**
+ * Track with include — flattens walkerOS `data` section into
+ * prefixed track() properties.
+ */
+declare const trackWithInclude: MixpanelStepExample;
+/**
+ * Per-event identify — mapping-level settings.identify overrides
+ * destination-level default.
+ */
+declare const perEventIdentify: MixpanelStepExample;
+/**
+ * Track with group — group key/id attached as track property.
+ */
+declare const trackWithGroup: MixpanelStepExample;
+/**
+ * User login with people operations — skip: true suppresses track,
+ * only identity + people side effects fire.
+ */
+declare const userLoginPeopleSet: MixpanelStepExample;
+/**
+ * Full people operation vocabulary — exercises set, set_once, increment,
+ * append, union, remove, unset, delete_user.
+ */
+declare const allPeopleOperations: MixpanelStepExample;
+/**
+ * Group profile operations — settings.groupProfile with set and set_once.
+ */
+declare const companyGroupProfile: MixpanelStepExample;
+/**
+ * Historical import — useImport: true uses mp.import() instead of mp.track().
+ */
+declare const historicalImport: MixpanelStepExample;
+/**
+ * Alias — legacy identity merge. Fires mp.alias before track.
+ */
+declare const aliasBeforeTrack: MixpanelStepExample;
+/**
+ * Wildcard ignore — the rule matches but does nothing.
+ */
+declare const wildcardIgnored: MixpanelStepExample;
+
+type step_MixpanelStepExample = MixpanelStepExample;
+declare const step_aliasBeforeTrack: typeof aliasBeforeTrack;
+declare const step_allPeopleOperations: typeof allPeopleOperations;
+declare const step_companyGroupProfile: typeof companyGroupProfile;
+declare const step_defaultEventForwarding: typeof defaultEventForwarding;
+declare const step_historicalImport: typeof historicalImport;
+declare const step_perEventIdentify: typeof perEventIdentify;
+declare const step_trackWithGroup: typeof trackWithGroup;
+declare const step_trackWithInclude: typeof trackWithInclude;
+declare const step_userLoginPeopleSet: typeof userLoginPeopleSet;
+declare const step_wildcardIgnored: typeof wildcardIgnored;
+declare namespace step {
+  export { type step_MixpanelStepExample as MixpanelStepExample, step_aliasBeforeTrack as aliasBeforeTrack, step_allPeopleOperations as allPeopleOperations, step_companyGroupProfile as companyGroupProfile, step_defaultEventForwarding as defaultEventForwarding, step_historicalImport as historicalImport, step_perEventIdentify as perEventIdentify, step_trackWithGroup as trackWithGroup, step_trackWithInclude as trackWithInclude, step_userLoginPeopleSet as userLoginPeopleSet, step_wildcardIgnored as wildcardIgnored };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.d.ts

@@ -0,0 +1,197 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { Mapping as Mapping$1, Flow } from '@walkeros/core';
+import { DestinationServer } from '@walkeros/server-core';
+
+declare const SettingsSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    secret: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodString>;
+    keepAlive: z.ZodOptional<z.ZodBoolean>;
+    geolocate: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    test: z.ZodOptional<z.ZodBoolean>;
+    useImport: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    include: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    identify: z.ZodOptional<z.ZodUnknown>;
+    people: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    groupProfile: z.ZodOptional<z.ZodUnknown>;
+    useImport: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+type MixpanelCallback = (err: Error | undefined) => void;
+/**
+ * Subset of the Mixpanel People API used by the destination.
+ * Every method requires `distinct_id` as the first argument (stateless server SDK).
+ */
+interface MixpanelPeople {
+    set(distinctId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    set_once(distinctId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    increment(distinctId: string, properties: Record<string, number>, callback?: MixpanelCallback): void;
+    append(distinctId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    union(distinctId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    remove(distinctId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    unset(distinctId: string, propertyName: string | string[], callback?: MixpanelCallback): void;
+    delete_user(distinctId: string, callback?: MixpanelCallback): void;
+}
+/**
+ * Subset of the Mixpanel Groups API used by the destination.
+ * Every method requires `(groupKey, groupId)` as the first two args.
+ */
+interface MixpanelGroups {
+    set(groupKey: string, groupId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    set_once(groupKey: string, groupId: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    union(groupKey: string, groupId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    remove(groupKey: string, groupId: string, data: Record<string, unknown>, callback?: MixpanelCallback): void;
+    unset(groupKey: string, groupId: string, propertyName: string | string[], callback?: MixpanelCallback): void;
+    delete_group(groupKey: string, groupId: string, callback?: MixpanelCallback): void;
+}
+/**
+ * Subset of the Mixpanel SDK instance the destination uses.
+ */
+interface MixpanelClient {
+    track(eventName: string, properties: Record<string, unknown>, callback?: MixpanelCallback): void;
+    import(eventName: string, time: Date | number, properties?: Record<string, unknown>, callback?: MixpanelCallback): void;
+    alias(distinctId: string, alias: string, callback?: MixpanelCallback): void;
+    people: MixpanelPeople;
+    groups: MixpanelGroups;
+}
+interface Settings {
+    apiKey: string;
+    secret?: string;
+    host?: string;
+    protocol?: string;
+    keepAlive?: boolean;
+    geolocate?: boolean;
+    debug?: boolean;
+    verbose?: boolean;
+    test?: boolean;
+    identify?: Mapping$1.Value;
+    group?: Mapping$1.Value;
+    include?: string[];
+    useImport?: boolean;
+    /** Initialized Mixpanel client instance — set during init(). */
+    client?: MixpanelClient;
+}
+/**
+ * Environment with optional Mixpanel constructor override for testing.
+ * Follows the same pattern as GCP BigQuery's `env.BigQuery`.
+ */
+interface Env extends DestinationServer.Env {
+    Mixpanel?: {
+        init: (...args: unknown[]) => MixpanelClient;
+    };
+}
+
+/**
+ * Standard mock environment for push operations.
+ * The test runner clones this and replaces methods with spies.
+ */
+declare const push: Env;
+/** Simulation tracking paths for CLI --simulate. */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * Step examples may carry destination-level settings and configInclude.
+ * The test runner reads these to configure the destination.
+ */
+type MixpanelStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+    configInclude?: string[];
+};
+/**
+ * Default event forwarding — every walkerOS event becomes
+ * mp.track(event.name, { distinct_id, ...properties }).
+ * With default settings.identify resolving user.id.
+ */
+declare const defaultEventForwarding: MixpanelStepExample;
+/**
+ * Track with include — flattens walkerOS `data` section into
+ * prefixed track() properties.
+ */
+declare const trackWithInclude: MixpanelStepExample;
+/**
+ * Per-event identify — mapping-level settings.identify overrides
+ * destination-level default.
+ */
+declare const perEventIdentify: MixpanelStepExample;
+/**
+ * Track with group — group key/id attached as track property.
+ */
+declare const trackWithGroup: MixpanelStepExample;
+/**
+ * User login with people operations — skip: true suppresses track,
+ * only identity + people side effects fire.
+ */
+declare const userLoginPeopleSet: MixpanelStepExample;
+/**
+ * Full people operation vocabulary — exercises set, set_once, increment,
+ * append, union, remove, unset, delete_user.
+ */
+declare const allPeopleOperations: MixpanelStepExample;
+/**
+ * Group profile operations — settings.groupProfile with set and set_once.
+ */
+declare const companyGroupProfile: MixpanelStepExample;
+/**
+ * Historical import — useImport: true uses mp.import() instead of mp.track().
+ */
+declare const historicalImport: MixpanelStepExample;
+/**
+ * Alias — legacy identity merge. Fires mp.alias before track.
+ */
+declare const aliasBeforeTrack: MixpanelStepExample;
+/**
+ * Wildcard ignore — the rule matches but does nothing.
+ */
+declare const wildcardIgnored: MixpanelStepExample;
+
+type step_MixpanelStepExample = MixpanelStepExample;
+declare const step_aliasBeforeTrack: typeof aliasBeforeTrack;
+declare const step_allPeopleOperations: typeof allPeopleOperations;
+declare const step_companyGroupProfile: typeof companyGroupProfile;
+declare const step_defaultEventForwarding: typeof defaultEventForwarding;
+declare const step_historicalImport: typeof historicalImport;
+declare const step_perEventIdentify: typeof perEventIdentify;
+declare const step_trackWithGroup: typeof trackWithGroup;
+declare const step_trackWithInclude: typeof trackWithInclude;
+declare const step_userLoginPeopleSet: typeof userLoginPeopleSet;
+declare const step_wildcardIgnored: typeof wildcardIgnored;
+declare namespace step {
+  export { type step_MixpanelStepExample as MixpanelStepExample, step_aliasBeforeTrack as aliasBeforeTrack, step_allPeopleOperations as allPeopleOperations, step_companyGroupProfile as companyGroupProfile, step_defaultEventForwarding as defaultEventForwarding, step_historicalImport as historicalImport, step_perEventIdentify as perEventIdentify, step_trackWithGroup as trackWithGroup, step_trackWithInclude as trackWithInclude, step_userLoginPeopleSet as userLoginPeopleSet, step_wildcardIgnored as wildcardIgnored };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.js

@@ -0,0 +1 @@
+"use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,o=(e,a)=>{for(var i in a)t(e,i,{get:a[i],enumerable:!0})},p={};o(p,{examples:()=>v,schemas:()=>s}),module.exports=(e=p,((e,o,p,s)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let r of i(o))n.call(e,r)||r===p||t(e,r,{get:()=>o[r],enumerable:!(s=a(o,r))||s.enumerable});return e})(t({},"__esModule",{value:!0}),e));var s={};o(s,{MappingSchema:()=>m,SettingsSchema:()=>d,mapping:()=>g,settings:()=>u});var r=require("@walkeros/core/dev"),l=require("@walkeros/core/dev"),d=l.z.object({apiKey:l.z.string().min(1).describe("Your Mixpanel project token. Find it in Project Settings > Access Keys. Passed as the first argument to Mixpanel.init()."),secret:l.z.string().describe("API secret for the /import endpoint (historical data). Required when useImport is true.").optional(),host:l.z.string().describe("Mixpanel API host. Default: 'api.mixpanel.com' (US). Use 'api-eu.mixpanel.com' (EU) or 'api-in.mixpanel.com' (India).").optional(),protocol:l.z.string().describe("Protocol for API requests. Default: 'https'.").optional(),keepAlive:l.z.boolean().describe("Reuse HTTP connections. Default: true.").optional(),geolocate:l.z.boolean().describe("Parse IP for geolocation. Default: false. Server IP caveat: all users map to server location unless $ip is overridden.").optional(),debug:l.z.boolean().describe("Enable SDK debug logging. Default: false.").optional(),verbose:l.z.boolean().describe("Enable verbose request logging. Default: false.").optional(),test:l.z.boolean().describe("Enable dry-run mode. Default: false.").optional(),useImport:l.z.boolean().describe("Use /import endpoint instead of /track. Accepts events of any age (no 5-day limit). Requires secret for authentication.").optional(),identify:l.z.unknown().describe("walkerOS mapping value resolving to { distinctId, alias? }. distinctId is passed as distinct_id on every SDK call.").optional(),include:l.z.unknown().describe("Event data sections to flatten into track() properties. Example: ['data', 'globals']. Sections are prefixed (data_, globals_, etc.).").optional()}),c=require("@walkeros/core/dev"),m=c.z.object({identify:c.z.unknown().describe("Per-event identity mapping. Resolves to { distinctId, alias? }. distinctId is passed as distinct_id to all SDK calls.").optional(),people:c.z.unknown().describe("Per-event people operations. Resolves to an object with any of: set, set_once, increment, append, union, remove, unset, delete_user. Each key fires a separate mp.people.* call with distinct_id as first arg.").optional(),group:c.z.unknown().describe("Per-event group association. Resolves to { key, id }. The group key/id is added as a track() property.").optional(),groupProfile:c.z.unknown().describe("Per-event group profile operations. Resolves to { key, id, set?, set_once?, union?, remove?, unset?, delete? }. Fires mp.groups.* calls.").optional(),useImport:c.z.unknown().describe("Per-event import flag. When truthy, uses mp.import() instead of mp.track() for this rule.").optional()}),u=(0,r.zodToSchema)(d),g=(0,r.zodToSchema)(m),v={};o(v,{env:()=>_,step:()=>I});var _={};o(_,{push:()=>k,simulation:()=>w});var f=()=>{},y={set:f,set_once:f,increment:f,append:f,union:f,remove:f,unset:f,delete_user:f},b={set:f,set_once:f,union:f,remove:f,unset:f,delete_group:f};var k={Mixpanel:{init:function(){return{track:f,import:f,alias:f,people:{...y},groups:{...b}}}}},w=["call:Mixpanel.init","call:mp.track","call:mp.import","call:mp.alias","call:mp.people.set","call:mp.people.set_once","call:mp.people.increment","call:mp.people.append","call:mp.people.union","call:mp.people.remove","call:mp.people.unset","call:mp.people.delete_user","call:mp.groups.set","call:mp.groups.set_once","call:mp.groups.union","call:mp.groups.remove","call:mp.groups.unset","call:mp.groups.delete_group"],I={};o(I,{aliasBeforeTrack:()=>A,allPeopleOperations:()=>j,companyGroupProfile:()=>x,defaultEventForwarding:()=>P,historicalImport:()=>q,perEventIdentify:()=>E,trackWithGroup:()=>S,trackWithInclude:()=>z,userLoginPeopleSet:()=>D,wildcardIgnored:()=>O});var h=require("@walkeros/core"),P={in:(0,h.getEvent)("product view",{timestamp:1700000100}),settings:{identify:{map:{distinctId:"user.id"}}},out:["mp.track","product view",{distinct_id:"us3r"}]},z={in:(0,h.getEvent)("product view",{timestamp:1700000101}),settings:{identify:{map:{distinctId:"user.id"}}},configInclude:["data"],out:["mp.track","product view",{distinct_id:"us3r",data_id:"ers",data_name:"Everyday Ruck Snack",data_color:"black",data_size:"l",data_price:420}]},E={in:(0,h.getEvent)("user login",{timestamp:1700000102,data:{user_id:"resolved-id",plan:"premium"}}),mapping:{settings:{identify:{map:{distinctId:"data.user_id"}}}},out:["mp.track","user login",{distinct_id:"resolved-id"}]},S={in:(0,h.getEvent)("page view",{timestamp:1700000103,data:{company_id:"acme"}}),settings:{identify:{map:{distinctId:"user.id"}}},mapping:{settings:{group:{map:{key:{value:"company_id"},id:"data.company_id"}}}},out:["mp.track","page view",{distinct_id:"us3r",company_id:"acme"}]},D={in:(0,h.getEvent)("user login",{timestamp:1700000104,data:{user_id:"new-user-123",plan:"premium",company:"Acme",email:"user@acme.com"}}),mapping:{skip:!0,settings:{identify:{map:{distinctId:"data.user_id"}},people:{map:{set:{map:{plan:"data.plan",company:"data.company",email:"data.email"}},set_once:{map:{first_login:"timestamp"}},increment:{map:{login_count:{value:1}}}}}}},out:[["mp.people.set","new-user-123",{plan:"premium",company:"Acme",email:"user@acme.com"}],["mp.people.set_once","new-user-123",{first_login:1700000104}],["mp.people.increment","new-user-123",{login_count:1}]]},j={in:(0,h.getEvent)("profile update",{timestamp:1700000105,data:{name:"Jane Doe",email:"jane@acme.com",page:"/docs/getting-started",removed_tag:"trial",source:"referral"}}),mapping:{skip:!0,settings:{identify:{map:{distinctId:"user.id"}},people:{map:{set:{map:{name:"data.name",email:"data.email"}},set_once:{map:{signup_source:"data.source"}},increment:{map:{page_views:{value:1}}},append:{map:{visited_pages:"data.page"}},union:{map:{unique_tags:{value:["active"]}}},remove:{map:{tags:"data.removed_tag"}},unset:{value:["old_plan"]}}}}},out:[["mp.people.set","us3r",{name:"Jane Doe",email:"jane@acme.com"}],["mp.people.set_once","us3r",{signup_source:"referral"}],["mp.people.increment","us3r",{page_views:1}],["mp.people.append","us3r",{visited_pages:"/docs/getting-started"}],["mp.people.union","us3r",{unique_tags:["active"]}],["mp.people.remove","us3r",{tags:"trial"}],["mp.people.unset","us3r",["old_plan"]]]},x={in:(0,h.getEvent)("company update",{timestamp:1700000106,data:{company_id:"acme-inc",company_name:"Acme, Inc.",plan:"enterprise",employee_count:250,founded_year:2010}}),mapping:{skip:!0,settings:{groupProfile:{map:{key:{value:"company_id"},id:"data.company_id",set:{map:{name:"data.company_name",plan:"data.plan",employee_count:"data.employee_count"}},set_once:{map:{founded:"data.founded_year"}}}}}},out:[["mp.groups.set","company_id","acme-inc",{name:"Acme, Inc.",plan:"enterprise",employee_count:250}],["mp.groups.set_once","company_id","acme-inc",{founded:2010}]]},q={in:(0,h.getEvent)("order complete",{timestamp:1700000107,data:{total:99.99}}),settings:{useImport:!0,identify:{map:{distinctId:"user.id"}}},out:["mp.import","order complete",1700000107,{distinct_id:"us3r"}]},A={in:(0,h.getEvent)("user login",{timestamp:1700000108,data:{user_id:"new-user-456",anon_id:"anon-789"}}),mapping:{settings:{identify:{map:{distinctId:"data.user_id",alias:"data.anon_id"}}}},out:[["mp.alias","new-user-456","anon-789"],["mp.track","user login",{distinct_id:"new-user-456"}]]},O={in:(0,h.getEvent)("debug noise",{timestamp:1700000109}),mapping:{ignore:!0},out:[]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Your Mixpanel project token. Find it in Project Settings > Access Keys. Passed as the first argument to Mixpanel.init().',\n    ),\n  secret: z\n    .string()\n    .describe(\n      'API secret for the /import endpoint (historical data). Required when useImport is true.',\n    )\n    .optional(),\n  host: z\n    .string()\n    .describe(\n      \"Mixpanel API host. Default: 'api.mixpanel.com' (US). Use 'api-eu.mixpanel.com' (EU) or 'api-in.mixpanel.com' (India).\",\n    )\n    .optional(),\n  protocol: z\n    .string()\n    .describe(\"Protocol for API requests. Default: 'https'.\")\n    .optional(),\n  keepAlive: z\n    .boolean()\n    .describe('Reuse HTTP connections. Default: true.')\n    .optional(),\n  geolocate: z\n    .boolean()\n    .describe(\n      'Parse IP for geolocation. Default: false. Server IP caveat: all users map to server location unless $ip is overridden.',\n    )\n    .optional(),\n  debug: z\n    .boolean()\n    .describe('Enable SDK debug logging. Default: false.')\n    .optional(),\n  verbose: z\n    .boolean()\n    .describe('Enable verbose request logging. Default: false.')\n    .optional(),\n  test: z.boolean().describe('Enable dry-run mode. Default: false.').optional(),\n  useImport: z\n    .boolean()\n    .describe(\n      'Use /import endpoint instead of /track. Accepts events of any age (no 5-day limit). Requires secret for authentication.',\n    )\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to { distinctId, alias? }. distinctId is passed as distinct_id on every SDK call.',\n    )\n    .optional(),\n  include: z\n    .unknown()\n    .describe(\n      \"Event data sections to flatten into track() properties. Example: ['data', 'globals']. Sections are prefixed (data_, globals_, etc.).\",\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { distinctId, alias? }. distinctId is passed as distinct_id to all SDK calls.',\n    )\n    .optional(),\n  people: z\n    .unknown()\n    .describe(\n      'Per-event people operations. Resolves to an object with any of: set, set_once, increment, append, union, remove, unset, delete_user. Each key fires a separate mp.people.* call with distinct_id as first arg.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Per-event group association. Resolves to { key, id }. The group key/id is added as a track() property.',\n    )\n    .optional(),\n  groupProfile: z\n    .unknown()\n    .describe(\n      'Per-event group profile operations. Resolves to { key, id, set?, set_once?, union?, remove?, unset?, delete? }. Fires mp.groups.* calls.',\n    )\n    .optional(),\n  useImport: z\n    .unknown()\n    .describe(\n      'Per-event import flag. When truthy, uses mp.import() instead of mp.track() for this rule.',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type {\n  Env,\n  MixpanelClient,\n  MixpanelPeople,\n  MixpanelGroups,\n} from '../types';\n\nconst noop = (() => {}) as (...args: unknown[]) => void;\n\nconst noopPeople: MixpanelPeople = {\n  set: noop,\n  set_once: noop,\n  increment: noop,\n  append: noop,\n  union: noop,\n  remove: noop,\n  unset: noop,\n  delete_user: noop,\n};\n\nconst noopGroups: MixpanelGroups = {\n  set: noop,\n  set_once: noop,\n  union: noop,\n  remove: noop,\n  unset: noop,\n  delete_group: noop,\n};\n\n/**\n * Mock Mixpanel factory that returns a no-op client instance.\n * Tests replace individual methods with spies.\n */\nfunction mockInit(): MixpanelClient {\n  return {\n    track: noop,\n    import: noop,\n    alias: noop,\n    people: { ...noopPeople },\n    groups: { ...noopGroups },\n  };\n}\n\n/**\n * Standard mock environment for push operations.\n * The test runner clones this and replaces methods with spies.\n */\nexport const push: Env = {\n  Mixpanel: { init: mockInit as (...args: unknown[]) => MixpanelClient },\n};\n\n/** Simulation tracking paths for CLI --simulate. */\nexport const simulation = [\n  'call:Mixpanel.init',\n  'call:mp.track',\n  'call:mp.import',\n  'call:mp.alias',\n  'call:mp.people.set',\n  'call:mp.people.set_once',\n  'call:mp.people.increment',\n  'call:mp.people.append',\n  'call:mp.people.union',\n  'call:mp.people.remove',\n  'call:mp.people.unset',\n  'call:mp.people.delete_user',\n  'call:mp.groups.set',\n  'call:mp.groups.set_once',\n  'call:mp.groups.union',\n  'call:mp.groups.remove',\n  'call:mp.groups.unset',\n  'call:mp.groups.delete_group',\n];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Step examples may carry destination-level settings and configInclude.\n * The test runner reads these to configure the destination.\n */\nexport type MixpanelStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n};\n\n/**\n * Default event forwarding — every walkerOS event becomes\n * mp.track(event.name, { distinct_id, ...properties }).\n * With default settings.identify resolving user.id.\n */\nexport const defaultEventForwarding: MixpanelStepExample = {\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  settings: {\n    identify: {\n      map: {\n        distinctId: 'user.id',\n      },\n    },\n  },\n  out: ['mp.track', 'product view', { distinct_id: 'us3r' }],\n};\n\n/**\n * Track with include — flattens walkerOS `data` section into\n * prefixed track() properties.\n */\nexport const trackWithInclude: MixpanelStepExample = {\n  in: getEvent('product view', { timestamp: 1700000101 }),\n  settings: {\n    identify: {\n      map: {\n        distinctId: 'user.id',\n      },\n    },\n  },\n  configInclude: ['data'],\n  out: [\n    'mp.track',\n    'product view',\n    {\n      distinct_id: 'us3r',\n      data_id: 'ers',\n      data_name: 'Everyday Ruck Snack',\n      data_color: 'black',\n      data_size: 'l',\n      data_price: 420,\n    },\n  ],\n};\n\n/**\n * Per-event identify — mapping-level settings.identify overrides\n * destination-level default.\n */\nexport const perEventIdentify: MixpanelStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: {\n      user_id: 'resolved-id',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n        },\n      },\n    },\n  },\n  out: [\n    'mp.track',\n    'user login',\n    {\n      distinct_id: 'resolved-id',\n    },\n  ],\n};\n\n/**\n * Track with group — group key/id attached as track property.\n */\nexport const trackWithGroup: MixpanelStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000103,\n    data: {\n      company_id: 'acme',\n    },\n  }),\n  settings: {\n    identify: {\n      map: {\n        distinctId: 'user.id',\n      },\n    },\n  },\n  mapping: {\n    settings: {\n      group: {\n        map: {\n          key: { value: 'company_id' },\n          id: 'data.company_id',\n        },\n      },\n    },\n  },\n  out: [\n    'mp.track',\n    'page view',\n    {\n      distinct_id: 'us3r',\n      company_id: 'acme',\n    },\n  ],\n};\n\n/**\n * User login with people operations — skip: true suppresses track,\n * only identity + people side effects fire.\n */\nexport const userLoginPeopleSet: MixpanelStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000104,\n    data: {\n      user_id: 'new-user-123',\n      plan: 'premium',\n      company: 'Acme',\n      email: 'user@acme.com',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n        },\n      },\n      people: {\n        map: {\n          set: {\n            map: {\n              plan: 'data.plan',\n              company: 'data.company',\n              email: 'data.email',\n            },\n          },\n          set_once: {\n            map: {\n              first_login: 'timestamp',\n            },\n          },\n          increment: {\n            map: {\n              login_count: { value: 1 },\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'mp.people.set',\n      'new-user-123',\n      { plan: 'premium', company: 'Acme', email: 'user@acme.com' },\n    ],\n    ['mp.people.set_once', 'new-user-123', { first_login: 1700000104 }],\n    ['mp.people.increment', 'new-user-123', { login_count: 1 }],\n  ],\n};\n\n/**\n * Full people operation vocabulary — exercises set, set_once, increment,\n * append, union, remove, unset, delete_user.\n */\nexport const allPeopleOperations: MixpanelStepExample = {\n  in: getEvent('profile update', {\n    timestamp: 1700000105,\n    data: {\n      name: 'Jane Doe',\n      email: 'jane@acme.com',\n      page: '/docs/getting-started',\n      removed_tag: 'trial',\n      source: 'referral',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'user.id',\n        },\n      },\n      people: {\n        map: {\n          set: {\n            map: {\n              name: 'data.name',\n              email: 'data.email',\n            },\n          },\n          set_once: {\n            map: {\n              signup_source: 'data.source',\n            },\n          },\n          increment: {\n            map: {\n              page_views: { value: 1 },\n            },\n          },\n          append: {\n            map: {\n              visited_pages: 'data.page',\n            },\n          },\n          union: {\n            map: {\n              unique_tags: { value: ['active'] },\n            },\n          },\n          remove: {\n            map: {\n              tags: 'data.removed_tag',\n            },\n          },\n          unset: { value: ['old_plan'] },\n        },\n      },\n    },\n  },\n  out: [\n    ['mp.people.set', 'us3r', { name: 'Jane Doe', email: 'jane@acme.com' }],\n    ['mp.people.set_once', 'us3r', { signup_source: 'referral' }],\n    ['mp.people.increment', 'us3r', { page_views: 1 }],\n    ['mp.people.append', 'us3r', { visited_pages: '/docs/getting-started' }],\n    ['mp.people.union', 'us3r', { unique_tags: ['active'] }],\n    ['mp.people.remove', 'us3r', { tags: 'trial' }],\n    ['mp.people.unset', 'us3r', ['old_plan']],\n  ],\n};\n\n/**\n * Group profile operations — settings.groupProfile with set and set_once.\n */\nexport const companyGroupProfile: MixpanelStepExample = {\n  in: getEvent('company update', {\n    timestamp: 1700000106,\n    data: {\n      company_id: 'acme-inc',\n      company_name: 'Acme, Inc.',\n      plan: 'enterprise',\n      employee_count: 250,\n      founded_year: 2010,\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      groupProfile: {\n        map: {\n          key: { value: 'company_id' },\n          id: 'data.company_id',\n          set: {\n            map: {\n              name: 'data.company_name',\n              plan: 'data.plan',\n              employee_count: 'data.employee_count',\n            },\n          },\n          set_once: {\n            map: {\n              founded: 'data.founded_year',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'mp.groups.set',\n      'company_id',\n      'acme-inc',\n      { name: 'Acme, Inc.', plan: 'enterprise', employee_count: 250 },\n    ],\n    ['mp.groups.set_once', 'company_id', 'acme-inc', { founded: 2010 }],\n  ],\n};\n\n/**\n * Historical import — useImport: true uses mp.import() instead of mp.track().\n */\nexport const historicalImport: MixpanelStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000107,\n    data: {\n      total: 99.99,\n    },\n  }),\n  settings: {\n    useImport: true,\n    identify: {\n      map: {\n        distinctId: 'user.id',\n      },\n    },\n  },\n  out: ['mp.import', 'order complete', 1700000107, { distinct_id: 'us3r' }],\n};\n\n/**\n * Alias — legacy identity merge. Fires mp.alias before track.\n */\nexport const aliasBeforeTrack: MixpanelStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000108,\n    data: {\n      user_id: 'new-user-456',\n      anon_id: 'anon-789',\n    },\n  }),\n  mapping: {\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n          alias: 'data.anon_id',\n        },\n      },\n    },\n  },\n  out: [\n    ['mp.alias', 'new-user-456', 'anon-789'],\n    ['mp.track', 'user login', { distinct_id: 'new-user-456' }],\n  ],\n};\n\n/**\n * Wildcard ignore — the rule matches but does nothing.\n */\nexport const wildcardIgnored: MixpanelStepExample = {\n  in: getEvent('debug noise', { timestamp: 1700000109 }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":"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","names":["import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,a=(a,t)=>{for(var i in t)e(a,i,{get:t[i],enumerable:!0})},t={};a(t,{MappingSchema:()=>s,SettingsSchema:()=>o,mapping:()=>l,settings:()=>r});import{zodToSchema as i}from"@walkeros/core/dev";import{z as n}from"@walkeros/core/dev";var o=n.object({apiKey:n.string().min(1).describe("Your Mixpanel project token. Find it in Project Settings > Access Keys. Passed as the first argument to Mixpanel.init()."),secret:n.string().describe("API secret for the /import endpoint (historical data). Required when useImport is true.").optional(),host:n.string().describe("Mixpanel API host. Default: 'api.mixpanel.com' (US). Use 'api-eu.mixpanel.com' (EU) or 'api-in.mixpanel.com' (India).").optional(),protocol:n.string().describe("Protocol for API requests. Default: 'https'.").optional(),keepAlive:n.boolean().describe("Reuse HTTP connections. Default: true.").optional(),geolocate:n.boolean().describe("Parse IP for geolocation. Default: false. Server IP caveat: all users map to server location unless $ip is overridden.").optional(),debug:n.boolean().describe("Enable SDK debug logging. Default: false.").optional(),verbose:n.boolean().describe("Enable verbose request logging. Default: false.").optional(),test:n.boolean().describe("Enable dry-run mode. Default: false.").optional(),useImport:n.boolean().describe("Use /import endpoint instead of /track. Accepts events of any age (no 5-day limit). Requires secret for authentication.").optional(),identify:n.unknown().describe("walkerOS mapping value resolving to { distinctId, alias? }. distinctId is passed as distinct_id on every SDK call.").optional(),include:n.unknown().describe("Event data sections to flatten into track() properties. Example: ['data', 'globals']. Sections are prefixed (data_, globals_, etc.).").optional()});import{z as p}from"@walkeros/core/dev";var s=p.object({identify:p.unknown().describe("Per-event identity mapping. Resolves to { distinctId, alias? }. distinctId is passed as distinct_id to all SDK calls.").optional(),people:p.unknown().describe("Per-event people operations. Resolves to an object with any of: set, set_once, increment, append, union, remove, unset, delete_user. Each key fires a separate mp.people.* call with distinct_id as first arg.").optional(),group:p.unknown().describe("Per-event group association. Resolves to { key, id }. The group key/id is added as a track() property.").optional(),groupProfile:p.unknown().describe("Per-event group profile operations. Resolves to { key, id, set?, set_once?, union?, remove?, unset?, delete? }. Fires mp.groups.* calls.").optional(),useImport:p.unknown().describe("Per-event import flag. When truthy, uses mp.import() instead of mp.track() for this rule.").optional()}),r=i(o),l=i(s),m={};a(m,{env:()=>d,step:()=>f});var d={};a(d,{push:()=>_,simulation:()=>v});var c=()=>{},u={set:c,set_once:c,increment:c,append:c,union:c,remove:c,unset:c,delete_user:c},g={set:c,set_once:c,union:c,remove:c,unset:c,delete_group:c};var _={Mixpanel:{init:function(){return{track:c,import:c,alias:c,people:{...u},groups:{...g}}}}},v=["call:Mixpanel.init","call:mp.track","call:mp.import","call:mp.alias","call:mp.people.set","call:mp.people.set_once","call:mp.people.increment","call:mp.people.append","call:mp.people.union","call:mp.people.remove","call:mp.people.unset","call:mp.people.delete_user","call:mp.groups.set","call:mp.groups.set_once","call:mp.groups.union","call:mp.groups.remove","call:mp.groups.unset","call:mp.groups.delete_group"],f={};a(f,{aliasBeforeTrack:()=>D,allPeopleOperations:()=>P,companyGroupProfile:()=>S,defaultEventForwarding:()=>k,historicalImport:()=>x,perEventIdentify:()=>w,trackWithGroup:()=>I,trackWithInclude:()=>b,userLoginPeopleSet:()=>h,wildcardIgnored:()=>A});import{getEvent as y}from"@walkeros/core";var k={in:y("product view",{timestamp:1700000100}),settings:{identify:{map:{distinctId:"user.id"}}},out:["mp.track","product view",{distinct_id:"us3r"}]},b={in:y("product view",{timestamp:1700000101}),settings:{identify:{map:{distinctId:"user.id"}}},configInclude:["data"],out:["mp.track","product view",{distinct_id:"us3r",data_id:"ers",data_name:"Everyday Ruck Snack",data_color:"black",data_size:"l",data_price:420}]},w={in:y("user login",{timestamp:1700000102,data:{user_id:"resolved-id",plan:"premium"}}),mapping:{settings:{identify:{map:{distinctId:"data.user_id"}}}},out:["mp.track","user login",{distinct_id:"resolved-id"}]},I={in:y("page view",{timestamp:1700000103,data:{company_id:"acme"}}),settings:{identify:{map:{distinctId:"user.id"}}},mapping:{settings:{group:{map:{key:{value:"company_id"},id:"data.company_id"}}}},out:["mp.track","page view",{distinct_id:"us3r",company_id:"acme"}]},h={in:y("user login",{timestamp:1700000104,data:{user_id:"new-user-123",plan:"premium",company:"Acme",email:"user@acme.com"}}),mapping:{skip:!0,settings:{identify:{map:{distinctId:"data.user_id"}},people:{map:{set:{map:{plan:"data.plan",company:"data.company",email:"data.email"}},set_once:{map:{first_login:"timestamp"}},increment:{map:{login_count:{value:1}}}}}}},out:[["mp.people.set","new-user-123",{plan:"premium",company:"Acme",email:"user@acme.com"}],["mp.people.set_once","new-user-123",{first_login:1700000104}],["mp.people.increment","new-user-123",{login_count:1}]]},P={in:y("profile update",{timestamp:1700000105,data:{name:"Jane Doe",email:"jane@acme.com",page:"/docs/getting-started",removed_tag:"trial",source:"referral"}}),mapping:{skip:!0,settings:{identify:{map:{distinctId:"user.id"}},people:{map:{set:{map:{name:"data.name",email:"data.email"}},set_once:{map:{signup_source:"data.source"}},increment:{map:{page_views:{value:1}}},append:{map:{visited_pages:"data.page"}},union:{map:{unique_tags:{value:["active"]}}},remove:{map:{tags:"data.removed_tag"}},unset:{value:["old_plan"]}}}}},out:[["mp.people.set","us3r",{name:"Jane Doe",email:"jane@acme.com"}],["mp.people.set_once","us3r",{signup_source:"referral"}],["mp.people.increment","us3r",{page_views:1}],["mp.people.append","us3r",{visited_pages:"/docs/getting-started"}],["mp.people.union","us3r",{unique_tags:["active"]}],["mp.people.remove","us3r",{tags:"trial"}],["mp.people.unset","us3r",["old_plan"]]]},S={in:y("company update",{timestamp:1700000106,data:{company_id:"acme-inc",company_name:"Acme, Inc.",plan:"enterprise",employee_count:250,founded_year:2010}}),mapping:{skip:!0,settings:{groupProfile:{map:{key:{value:"company_id"},id:"data.company_id",set:{map:{name:"data.company_name",plan:"data.plan",employee_count:"data.employee_count"}},set_once:{map:{founded:"data.founded_year"}}}}}},out:[["mp.groups.set","company_id","acme-inc",{name:"Acme, Inc.",plan:"enterprise",employee_count:250}],["mp.groups.set_once","company_id","acme-inc",{founded:2010}]]},x={in:y("order complete",{timestamp:1700000107,data:{total:99.99}}),settings:{useImport:!0,identify:{map:{distinctId:"user.id"}}},out:["mp.import","order complete",1700000107,{distinct_id:"us3r"}]},D={in:y("user login",{timestamp:1700000108,data:{user_id:"new-user-456",anon_id:"anon-789"}}),mapping:{settings:{identify:{map:{distinctId:"data.user_id",alias:"data.anon_id"}}}},out:[["mp.alias","new-user-456","anon-789"],["mp.track","user login",{distinct_id:"new-user-456"}]]},A={in:y("debug noise",{timestamp:1700000109}),mapping:{ignore:!0},out:[]};export{m as examples,t as schemas};//# sourceMappingURL=dev.mjs.map