@walkeros/web-destination-segment 3.4.0 → 3.4.1

package/dist/examples/index.js

@@ -106,7 +106,7 @@ function L(e2, t = {}, n = {}) {
 }
 function fe(e2 = {}) {
   var _a;
-  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.0", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
+  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.1", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
   if (e2.name) {
     const [t2, n2] = (_a = e2.name.split(" ")) != null ? _a : [];
     t2 && n2 && (r.entity = t2, r.action = n2);
@@ -120,6 +120,8 @@ function le(e2 = "entity action", t = {}) {
 
 // src/examples/step.ts
 var init2 = {
+  title: "Initialization",
+  description: "Destination bootstrap calls analytics.load with the Segment writeKey and walker default options.",
   in: {
     settings: {
       apiKey: "test-project"
@@ -134,15 +136,20 @@ var init2 = {
   ]
 };
 var defaultEventForwarding = {
+  title: "Default track",
+  description: "A walker event becomes a Segment analytics.track call with the event name and empty properties.",
   in: le("product view", { timestamp: 1700000100 }),
   out: [["analytics.track", "product view", {}]]
 };
 var wildcardIgnored = {
+  public: false,
   in: le("debug noise", { timestamp: 1700000101 }),
   mapping: { ignore: true },
   out: []
 };
 var destinationLevelInclude = {
+  title: "Include data",
+  description: "Destination-level include flattens the event data section into prefixed Segment track properties.",
   in: le("product view", { timestamp: 1700000102 }),
   configInclude: ["data"],
   out: [
@@ -160,6 +167,8 @@ var destinationLevelInclude = {
   ]
 };
 var ruleIncludeReplaces = {
+  title: "Rule include overrides",
+  description: "A per-rule include replaces the destination-level include so this event forwards only globals.",
   in: le("order complete", { timestamp: 1700000103 }),
   configInclude: ["data"],
   mapping: {
@@ -176,6 +185,8 @@ var ruleIncludeReplaces = {
   ]
 };
 var destinationLevelIdentify = {
+  title: "Destination identify",
+  description: "Destination-level identify calls analytics.identify with the resolved userId before firing the default track.",
   in: le("page view", { timestamp: 1700000104 }),
   settings: {
     identify: {
@@ -190,6 +201,8 @@ var destinationLevelIdentify = {
   ]
 };
 var userLoginIdentify = {
+  title: "User login identify",
+  description: "A user login fires Segment analytics.identify with userId and reserved traits such as email, name, and plan.",
   in: le("user login", {
     timestamp: 1700000105,
     data: {
@@ -238,6 +251,8 @@ var userLoginIdentify = {
   ]
 };
 var profileUpdateTraitsOnly = {
+  title: "Profile update",
+  description: "A profile update calls Segment analytics.identify with traits and no userId to merge traits into the current profile.",
   in: le("profile update", {
     timestamp: 1700000106,
     data: {
@@ -275,6 +290,8 @@ var profileUpdateTraitsOnly = {
   ]
 };
 var userLogoutReset = {
+  title: "User logout reset",
+  description: "A user logout calls analytics.reset to clear userId, anonymousId, and traits then generate a new anonymous id.",
   in: le("user logout", { timestamp: 1700000107 }),
   mapping: {
     skip: true,
@@ -285,6 +302,8 @@ var userLogoutReset = {
   out: [["analytics.reset"]]
 };
 var companyUpdateGroup = {
+  title: "Group company",
+  description: "A company update fires Segment analytics.group with a groupId and traits for account-level tracking.",
   in: le("company update", {
     timestamp: 1700000108,
     data: {
@@ -327,6 +346,8 @@ var companyUpdateGroup = {
   ]
 };
 var pageViewAsPage = {
+  title: "Page view",
+  description: "A page view fires Segment analytics.page with category, name, and properties instead of a generic track.",
   in: le("page view", {
     timestamp: 1700000109,
     data: {
@@ -363,6 +384,8 @@ var pageViewAsPage = {
   ]
 };
 var pageViewMinimal = {
+  title: "Page view minimal",
+  description: "A mapping with page: true fires an empty analytics.page call relying on Segments auto-collection.",
   in: le("page view", { timestamp: 1700000110 }),
   mapping: {
     skip: true,
@@ -373,6 +396,8 @@ var pageViewMinimal = {
   out: [["analytics.page"]]
 };
 var orderCompletedEcommerce = {
+  title: "Order completed",
+  description: "A completed order is mapped to the Segment Spec Order Completed event with a nested products array.",
   in: le("order complete", { timestamp: 1700000111 }),
   mapping: {
     name: "Order Completed",
@@ -436,6 +461,8 @@ var orderCompletedEcommerce = {
   ]
 };
 var consentContextForwarded = {
+  title: "Consent context",
+  description: "Walker consent is stamped on every Segment call via context.consent.categoryPreferences for downstream filtering.",
   in: le("product view", {
     timestamp: 1700000112,
     consent: { analytics: true, marketing: true }
@@ -465,6 +492,8 @@ var consentContextForwarded = {
   ]
 };
 var consentGrantDeferredLoad = {
+  title: "Consent deferred load",
+  description: "A walker consent grant triggers the deferred Segment analytics.load with the configured writeKey.",
   command: "consent",
   in: { analytics: true },
   out: [
@@ -476,6 +505,7 @@ var consentGrantDeferredLoad = {
   ]
 };
 var consentRevokeNoOp = {
+  public: false,
   command: "consent",
   in: { analytics: false },
   out: []

package/dist/examples/index.mjs

@@ -85,7 +85,7 @@ function L(e2, t = {}, n = {}) {
 }
 function fe(e2 = {}) {
   var _a;
-  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.0", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
+  const t = e2.timestamp || (/* @__PURE__ */ new Date()).setHours(0, 13, 37, 0), n = e2.group || "gr0up", o = e2.count || 1, r = L({ name: "entity action", data: { string: "foo", number: 1, boolean: true, array: [0, "text", false], not: void 0 }, context: { dev: ["test", 1] }, globals: { lang: "elb" }, custom: { completely: "random" }, user: { id: "us3r", device: "c00k13", session: "s3ss10n" }, nested: [{ entity: "child", data: { is: "subordinated" }, nested: [], context: { element: ["child", 0] } }], consent: { functional: true }, id: `${t}-${n}-${o}`, trigger: "test", entity: "entity", action: "action", timestamp: t, timing: 3.14, group: n, count: o, version: { source: "3.4.1", tagging: 1 }, source: { type: "web", id: "https://localhost:80", previous_id: "http://remotehost:9001" } }, e2, { merge: false });
   if (e2.name) {
     const [t2, n2] = (_a = e2.name.split(" ")) != null ? _a : [];
     t2 && n2 && (r.entity = t2, r.action = n2);
@@ -99,6 +99,8 @@ function le(e2 = "entity action", t = {}) {
 
 // src/examples/step.ts
 var init2 = {
+  title: "Initialization",
+  description: "Destination bootstrap calls analytics.load with the Segment writeKey and walker default options.",
   in: {
     settings: {
       apiKey: "test-project"
@@ -113,15 +115,20 @@ var init2 = {
   ]
 };
 var defaultEventForwarding = {
+  title: "Default track",
+  description: "A walker event becomes a Segment analytics.track call with the event name and empty properties.",
   in: le("product view", { timestamp: 1700000100 }),
   out: [["analytics.track", "product view", {}]]
 };
 var wildcardIgnored = {
+  public: false,
   in: le("debug noise", { timestamp: 1700000101 }),
   mapping: { ignore: true },
   out: []
 };
 var destinationLevelInclude = {
+  title: "Include data",
+  description: "Destination-level include flattens the event data section into prefixed Segment track properties.",
   in: le("product view", { timestamp: 1700000102 }),
   configInclude: ["data"],
   out: [
@@ -139,6 +146,8 @@ var destinationLevelInclude = {
   ]
 };
 var ruleIncludeReplaces = {
+  title: "Rule include overrides",
+  description: "A per-rule include replaces the destination-level include so this event forwards only globals.",
   in: le("order complete", { timestamp: 1700000103 }),
   configInclude: ["data"],
   mapping: {
@@ -155,6 +164,8 @@ var ruleIncludeReplaces = {
   ]
 };
 var destinationLevelIdentify = {
+  title: "Destination identify",
+  description: "Destination-level identify calls analytics.identify with the resolved userId before firing the default track.",
   in: le("page view", { timestamp: 1700000104 }),
   settings: {
     identify: {
@@ -169,6 +180,8 @@ var destinationLevelIdentify = {
   ]
 };
 var userLoginIdentify = {
+  title: "User login identify",
+  description: "A user login fires Segment analytics.identify with userId and reserved traits such as email, name, and plan.",
   in: le("user login", {
     timestamp: 1700000105,
     data: {
@@ -217,6 +230,8 @@ var userLoginIdentify = {
   ]
 };
 var profileUpdateTraitsOnly = {
+  title: "Profile update",
+  description: "A profile update calls Segment analytics.identify with traits and no userId to merge traits into the current profile.",
   in: le("profile update", {
     timestamp: 1700000106,
     data: {
@@ -254,6 +269,8 @@ var profileUpdateTraitsOnly = {
   ]
 };
 var userLogoutReset = {
+  title: "User logout reset",
+  description: "A user logout calls analytics.reset to clear userId, anonymousId, and traits then generate a new anonymous id.",
   in: le("user logout", { timestamp: 1700000107 }),
   mapping: {
     skip: true,
@@ -264,6 +281,8 @@ var userLogoutReset = {
   out: [["analytics.reset"]]
 };
 var companyUpdateGroup = {
+  title: "Group company",
+  description: "A company update fires Segment analytics.group with a groupId and traits for account-level tracking.",
   in: le("company update", {
     timestamp: 1700000108,
     data: {
@@ -306,6 +325,8 @@ var companyUpdateGroup = {
   ]
 };
 var pageViewAsPage = {
+  title: "Page view",
+  description: "A page view fires Segment analytics.page with category, name, and properties instead of a generic track.",
   in: le("page view", {
     timestamp: 1700000109,
     data: {
@@ -342,6 +363,8 @@ var pageViewAsPage = {
   ]
 };
 var pageViewMinimal = {
+  title: "Page view minimal",
+  description: "A mapping with page: true fires an empty analytics.page call relying on Segments auto-collection.",
   in: le("page view", { timestamp: 1700000110 }),
   mapping: {
     skip: true,
@@ -352,6 +375,8 @@ var pageViewMinimal = {
   out: [["analytics.page"]]
 };
 var orderCompletedEcommerce = {
+  title: "Order completed",
+  description: "A completed order is mapped to the Segment Spec Order Completed event with a nested products array.",
   in: le("order complete", { timestamp: 1700000111 }),
   mapping: {
     name: "Order Completed",
@@ -415,6 +440,8 @@ var orderCompletedEcommerce = {
   ]
 };
 var consentContextForwarded = {
+  title: "Consent context",
+  description: "Walker consent is stamped on every Segment call via context.consent.categoryPreferences for downstream filtering.",
   in: le("product view", {
     timestamp: 1700000112,
     consent: { analytics: true, marketing: true }
@@ -444,6 +471,8 @@ var consentContextForwarded = {
   ]
 };
 var consentGrantDeferredLoad = {
+  title: "Consent deferred load",
+  description: "A walker consent grant triggers the deferred Segment analytics.load with the configured writeKey.",
   command: "consent",
   in: { analytics: true },
   out: [
@@ -455,6 +484,7 @@ var consentGrantDeferredLoad = {
   ]
 };
 var consentRevokeNoOp = {
+  public: false,
   command: "consent",
   in: { analytics: false },
   out: []

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/web-destination-segment",
-    "version": "3.4.0",
+    "version": "3.4.1",
     "type": "destination",
     "platform": [
       "web"
@@ -122,6 +122,8 @@
     },
     "step": {
       "companyUpdateGroup": {
+        "title": "Group company",
+        "description": "A company update fires Segment analytics.group with a groupId and traits for account-level tracking.",
         "in": {
           "name": "company update",
           "data": {
@@ -175,7 +177,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -216,6 +218,8 @@
         ]
       },
       "consentContextForwarded": {
+        "title": "Consent context",
+        "description": "Walker consent is stamped on every Segment call via context.consent.categoryPreferences for downstream filtering.",
         "in": {
           "name": "product view",
           "data": {
@@ -256,7 +260,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -290,6 +294,8 @@
         ]
       },
       "consentGrantDeferredLoad": {
+        "title": "Consent deferred load",
+        "description": "A walker consent grant triggers the deferred Segment analytics.load with the configured writeKey.",
         "command": "consent",
         "in": {
           "analytics": true
@@ -307,6 +313,7 @@
         ]
       },
       "consentRevokeNoOp": {
+        "public": false,
         "command": "consent",
         "in": {
           "analytics": false
@@ -314,6 +321,8 @@
         "out": []
       },
       "defaultEventForwarding": {
+        "title": "Default track",
+        "description": "A walker event becomes a Segment analytics.track call with the event name and empty properties.",
         "in": {
           "name": "product view",
           "data": {
@@ -353,7 +362,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -371,6 +380,8 @@
         ]
       },
       "destinationLevelIdentify": {
+        "title": "Destination identify",
+        "description": "Destination-level identify calls analytics.identify with the resolved userId before firing the default track.",
         "in": {
           "name": "page view",
           "data": {
@@ -425,7 +436,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -455,6 +466,8 @@
         ]
       },
       "destinationLevelInclude": {
+        "title": "Include data",
+        "description": "Destination-level include flattens the event data section into prefixed Segment track properties.",
         "in": {
           "name": "product view",
           "data": {
@@ -494,7 +507,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -521,6 +534,8 @@
         ]
       },
       "init": {
+        "title": "Initialization",
+        "description": "Destination bootstrap calls analytics.load with the Segment writeKey and walker default options.",
         "in": {
           "settings": {
             "apiKey": "test-project"
@@ -539,6 +554,8 @@
         ]
       },
       "orderCompletedEcommerce": {
+        "title": "Order completed",
+        "description": "A completed order is mapped to the Segment Spec Order Completed event with a nested products array.",
         "in": {
           "name": "order complete",
           "data": {
@@ -625,7 +642,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -703,6 +720,8 @@
         ]
       },
       "pageViewAsPage": {
+        "title": "Page view",
+        "description": "A page view fires Segment analytics.page with category, name, and properties instead of a generic track.",
         "in": {
           "name": "page view",
           "data": {
@@ -754,7 +773,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -791,6 +810,8 @@
         ]
       },
       "pageViewMinimal": {
+        "title": "Page view minimal",
+        "description": "A mapping with page: true fires an empty analytics.page call relying on Segments auto-collection.",
         "in": {
           "name": "page view",
           "data": {
@@ -845,7 +866,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -867,6 +888,8 @@
         ]
       },
       "profileUpdateTraitsOnly": {
+        "title": "Profile update",
+        "description": "A profile update calls Segment analytics.identify with traits and no userId to merge traits into the current profile.",
         "in": {
           "name": "profile update",
           "data": {
@@ -918,7 +941,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -956,6 +979,8 @@
         ]
       },
       "ruleIncludeReplaces": {
+        "title": "Rule include overrides",
+        "description": "A per-rule include replaces the destination-level include so this event forwards only globals.",
         "in": {
           "name": "order complete",
           "data": {
@@ -1042,7 +1067,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -1070,6 +1095,8 @@
         ]
       },
       "userLoginIdentify": {
+        "title": "User login identify",
+        "description": "A user login fires Segment analytics.identify with userId and reserved traits such as email, name, and plan.",
         "in": {
           "name": "user login",
           "data": {
@@ -1124,7 +1151,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -1173,6 +1200,8 @@
         ]
       },
       "userLogoutReset": {
+        "title": "User logout reset",
+        "description": "A user logout calls analytics.reset to clear userId, anonymousId, and traits then generate a new anonymous id.",
         "in": {
           "name": "user logout",
           "data": {
@@ -1229,7 +1258,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -1251,6 +1280,7 @@
         ]
       },
       "wildcardIgnored": {
+        "public": false,
         "in": {
           "name": "debug noise",
           "data": {
@@ -1307,7 +1337,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/web-destination-segment",
   "description": "Segment CDP web destination for walkerOS (@segment/analytics-next, full Segment Spec)",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -38,10 +38,10 @@
   },
   "dependencies": {
     "@segment/analytics-next": "^1.82.0",
-    "@walkeros/web-core": "3.4.0"
+    "@walkeros/web-core": "3.4.1"
   },
   "devDependencies": {
-    "@walkeros/collector": "3.4.0"
+    "@walkeros/collector": "3.4.1"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",