@walkeros/cli 4.7.2-next-1791147139360 → 4.7.2

package/examples/flow-complete.json

@@ -241,25 +241,25 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/web-source-cmp-usercentrics": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/web-source-session": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/web-source-datalayer": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/web-source-browser": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/web-destination-gtag": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/web-destination-api": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             }
           },
           "env": {
@@ -277,7 +277,17 @@
         "custom": {
           "environment": "$env.ENVIRONMENT"
         },
-        "next": "pageGroup"
+        "next": [
+          {
+            "match": {
+              "key": "event.user.optout",
+              "operator": "eq",
+              "value": "true"
+            },
+            "stop": true
+          },
+          "pageGroup"
+        ]
       },
       "sources": {
         "usercentrics": {
@@ -991,9 +1001,6 @@
                         ]
                       }
                     }
-                  },
-                  "consent": {
-                    "functional": true
                   }
                 }
               }
@@ -1041,9 +1048,6 @@
                       ]
                     }
                   }
-                },
-                "consent": {
-                  "functional": true
                 }
               },
               "in": {
@@ -1181,9 +1185,6 @@
                       ]
                     }
                   }
-                },
-                "consent": {
-                  "functional": true
                 }
               },
               "in": {
@@ -1764,40 +1765,40 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-source-express": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/transformer-ga4": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/transformer-validate": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-transformer-bot": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-transformer-fingerprint": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-transformer-file": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-store-fs": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-destination-gcp": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-destination-meta": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-destination-piwikpro": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-destination-datamanager": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             }
           }
         }
@@ -1932,7 +1933,17 @@
               }
             ]
           },
-          "next": "dedup",
+          "next": [
+            {
+              "match": {
+                "key": "event.user.optout",
+                "operator": "eq",
+                "value": "true"
+              },
+              "stop": true
+            },
+            "dedup"
+          ],
           "examples": {
             "postCollect": {
               "title": "Event from the web flow",
@@ -4499,7 +4510,10 @@
                 "event.user.device",
                 "event.user.session",
                 "event.user.hash"
-              ]
+              ],
+              "customDimensions": {
+                "1": "user.segment"
+              }
             },
             "mapping": {
               "page": {
@@ -4594,7 +4608,7 @@
           "examples": {
             "orderWithGoal": {
               "title": "Order with goal",
-              "description": "order complete becomes an ecommerce order plus a goal hit with the order value; the visitor id falls back to the cookieless hash.",
+              "description": "order complete becomes an ecommerce order plus a goal hit with the order value; the visitor id falls back to the cookieless hash, and both hits carry the customer segment as custom dimension 1.",
               "public": true,
               "mapping": {
                 "name": "ecommerceOrder",
@@ -4658,7 +4672,8 @@
                   "hash": "5f1c0a9e7d3b2c41",
                   "botScore": 0,
                   "botCategory": "human",
-                  "ltv": 420
+                  "ltv": 420,
+                  "segment": "loyal"
                 },
                 "source": {
                   "type": "express",
@@ -4691,7 +4706,7 @@
                 [
                   "sendServer",
                   "https://example.piwik.pro/ppms.php",
-                  "{\"requests\":[\"?idsite=e8f3a1c2-0b4d-4e5f-9a6b-7c8d9e0f1a2b&rec=1&send_image=0&ts_n=walkerOS&ts_v=4.6.1&e_t=order&ec_id=ORD-100&revenue=149.8&ec_products=%5B%5B%22SKU-1%22%2C%22Trail+Runner%22%2Cnull%2C129.9%2C1%2Cnull%2Cnull%2Cnull%5D%2C%5B%22SKU-2%22%2C%22Running+Socks%22%2Cnull%2C9.95%2C2%2Cnull%2Cnull%2Cnull%5D%5D&url=https%3A%2F%2Fwww.example.com%2Fcheckout%2Fthanks&cip=203.0.113.42&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_15_7%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F128.0.0.0+Safari%2F537.36&_id=174c88fbd5a4b357&uid=cust-42&cdt=1700000000\",\"?idsite=e8f3a1c2-0b4d-4e5f-9a6b-7c8d9e0f1a2b&rec=1&send_image=0&ts_n=walkerOS&ts_v=4.6.1&idgoal=6a0f4c1e-3b2d-4e8f-a7c9-1d2e3f4a5b6c&revenue=149.8&url=https%3A%2F%2Fwww.example.com%2Fcheckout%2Fthanks&cip=203.0.113.42&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_15_7%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F128.0.0.0+Safari%2F537.36&_id=174c88fbd5a4b357&uid=cust-42&cdt=1700000000\"]}",
+                  "{\"requests\":[\"?idsite=e8f3a1c2-0b4d-4e5f-9a6b-7c8d9e0f1a2b&rec=1&send_image=0&ts_n=walkerOS&ts_v=4.6.1&e_t=order&ec_id=ORD-100&revenue=149.8&ec_products=%5B%5B%22SKU-1%22%2C%22Trail+Runner%22%2Cnull%2C129.9%2C1%2Cnull%2Cnull%2Cnull%5D%2C%5B%22SKU-2%22%2C%22Running+Socks%22%2Cnull%2C9.95%2C2%2Cnull%2Cnull%2Cnull%5D%5D&dimension1=loyal&url=https%3A%2F%2Fwww.example.com%2Fcheckout%2Fthanks&cip=203.0.113.42&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_15_7%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F128.0.0.0+Safari%2F537.36&_id=174c88fbd5a4b357&uid=cust-42&cdt=1700000000\",\"?idsite=e8f3a1c2-0b4d-4e5f-9a6b-7c8d9e0f1a2b&rec=1&send_image=0&ts_n=walkerOS&ts_v=4.6.1&idgoal=6a0f4c1e-3b2d-4e8f-a7c9-1d2e3f4a5b6c&revenue=149.8&dimension1=loyal&url=https%3A%2F%2Fwww.example.com%2Fcheckout%2Fthanks&cip=203.0.113.42&ua=Mozilla%2F5.0+%28Macintosh%3B+Intel+Mac+OS+X+10_15_7%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F128.0.0.0+Safari%2F537.36&_id=174c88fbd5a4b357&uid=cust-42&cdt=1700000000\"]}",
                   {
                     "timeout": 5000
                   }
@@ -4858,13 +4873,13 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-source-gcp": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             },
             "@walkeros/server-destination-gcp": {
-              "version": "4.7.2-next-1791147139360"
+              "version": "4.7.2"
             }
           }
         }

package/examples/flow-complete.md

@@ -36,12 +36,12 @@ export GCP_SA="$(node -e "const { generateKeyPairSync } = require('crypto'); con
 
 ```text
 web      usercentrics, session, dataLayer, browser
-           -> collector.next: pageGroup
+           -> collector.next: opt-out stop, pageGroup
            -> ga4 (to Google, main property)  gtm (dataLayer)  collect (to server)
 
 server   express /collect  /g/collect  /walker.js
            before: one [ G-SUBSITE hit -> ga4Decode -> ga4Consent | *.js -> file (stop) | other /g/collect (stop) ]
-           next: dedup
+           next: opt-out stop, dedup
            -> collector.next: fingerprint, bot, not impression -> enrich [ loadUser, sessionSave, sessionLoad, validate ]
            -> pubsub (every event, email pseudonymized)
            -> meta, piwikpro, datamanager (each behind eventFilter)
@@ -365,10 +365,10 @@ walkeros push packages/cli/examples/flow-complete.json -f web -e '{"name":"order
     refused pings stay functional false and fail the contract.
   - `destination-consent` at `/flows/server/destinations/meta/config/consent`:
     Destination consent: Meta only gets events with marketing consent.
-  - `rule-consent` at
-    `/flows/web/destinations/ga4/config/mapping/order/complete/consent`: Rule
-    consent on purchases: not enforced yet; the destination's functional consent
-    gates them. Marketing consent belongs to Meta and Data Manager.
+  - `user-optout` at `/flows/server/sources/express/next/0`: An opted-out user
+    (user.optout true) is stopped first: on the server before dedup, so no dedup
+    entry, hash or delivery; on the web first in collector.next, so the browser
+    sends nothing.
   - `value-consent` at
     `/flows/web/destinations/collect/config/policy/user.email/consent`: Field
     consent: the email is only kept with marketing consent.
@@ -397,6 +397,12 @@ walkeros push packages/cli/examples/flow-complete.json -f web -e '{"name":"order
 - **Consent keys:** there are no collector consent defaults, only granted keys
   travel. `consent.functional` is set only by Usercentrics with `explicitOnly`,
   so its presence means the user decided.
+- **Opt-out beats consent:** the site sets the flag before the first event. With
+  `elbLayer.push(['walker user', { optout: true }])` before walker.js loads, the
+  browser sends nothing. `data-elbuser="optout:true"` holds back the page view
+  and every later event, but events queued in `elbLayer` before walker.js loads
+  are still sent. An opted-out event that reaches the server from another client
+  stops before dedup.
 - **Meta hashes `user_data` itself:** `em` is the raw email; the Meta package
   normalizes and hashes it before sending, the flow never builds a hash for
   Meta.
@@ -514,7 +520,8 @@ runneros start dist/server.mjs -p 8080 --env-file .env
   per destination (London prompt 3).
 - **Features:**
   - `web-collector-next` at `/flows/web/collector/next`: On the web
-    collector.next runs the inline pageGroup step once per event.
+    collector.next stops an opted-out user first, then runs the inline pageGroup
+    step once per event.
   - `ga4-other-dropped` at `/flows/server/sources/express/before/one/2`: GA4
     hits for any other property stop at the route instead of reaching the
     collector undecoded.
@@ -533,7 +540,7 @@ runneros start dist/server.mjs -p 8080 --env-file .env
   - `op-suffix` at `/flows/server/sources/express/before/one/1/match/operator`:
     suffix matches the end of a value: script requests end in .js.
   - `source-next` at `/flows/server/sources/express/next`: source.next names the
-    hop after the source, here dedup.
+    hops after the source: the opt-out stop, then dedup.
   - `collector-next` at `/flows/server/collector/next`: collector.next runs once
     per event before the fan-out: fingerprint and bot for all, enrich for all
     but impressions.
@@ -713,6 +720,10 @@ walkeros push packages/cli/examples/flow-complete.json -f server -e '{"name":"pa
     mapping picks fields from the stored row and merges them into the target.
   - `load-user` at `/flows/server/transformers/loadUser`: loadUser puts the
     customer lifetime value and segment on logged-in events.
+  - `piwik-segment` at
+    `/flows/server/destinations/piwikpro/config/settings/customDimensions`:
+    Piwik PRO gets the loaded segment as custom dimension 1; the path is
+    relative to the event, so user.segment.
   - `store-fs` at `/flows/server/stores/assets`: An fs store serves files from a
     folder.
   - `store-file` at `/flows/server/stores/assets/config/file`: file: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkeros/cli",
-  "version": "4.7.2-next-1791147139360",
+  "version": "4.7.2",
   "description": "walkerOS CLI - Bundle and deploy walkerOS components",
   "license": "MIT",
   "type": "module",
@@ -55,11 +55,11 @@
   },
   "dependencies": {
     "@vercel/nft": "^1.10.2",
-    "@walkeros/collector": "4.7.2-next-1791147139360",
-    "@walkeros/core": "4.7.2-next-1791147139360",
-    "@walkeros/server-core": "4.7.2-next-1791147139360",
-    "@walkeros/server-destination-api": "4.7.2-next-1791147139360",
-    "@walkeros/transformer-validate": "4.7.2-next-1791147139360",
+    "@walkeros/collector": "4.7.2",
+    "@walkeros/core": "4.7.2",
+    "@walkeros/server-core": "4.7.2",
+    "@walkeros/server-destination-api": "4.7.2",
+    "@walkeros/transformer-validate": "4.7.2",
     "ajv": "^8.17.1",
     "chalk": "^5.6.2",
     "ci-info": "^4.4.0",
@@ -83,29 +83,29 @@
     "@types/pacote": "^11.1.8",
     "@types/picomatch": "4.0.3",
     "@types/semver": "^7.7.1",
-    "@walkeros/config": "4.7.2-next-1791147139360",
-    "@walkeros/core": "4.7.2-next-1791147139360",
-    "@walkeros/destination-demo": "4.7.2-next-1791147139360",
-    "@walkeros/server-destination-aws": "4.7.2-next-1791147139360",
-    "@walkeros/server-destination-datamanager": "4.7.2-next-1791147139360",
-    "@walkeros/server-destination-gcp": "4.7.2-next-1791147139360",
-    "@walkeros/server-destination-meta": "4.7.2-next-1791147139360",
-    "@walkeros/server-destination-piwikpro": "4.7.2-next-1791147139360",
-    "@walkeros/server-source-aws": "4.7.2-next-1791147139360",
-    "@walkeros/server-source-express": "4.7.2-next-1791147139360",
-    "@walkeros/server-source-gcp": "4.7.2-next-1791147139360",
-    "@walkeros/server-store-fs": "4.7.2-next-1791147139360",
-    "@walkeros/server-transformer-bot": "4.7.2-next-1791147139360",
-    "@walkeros/server-transformer-file": "4.7.2-next-1791147139360",
-    "@walkeros/server-transformer-fingerprint": "4.7.2-next-1791147139360",
-    "@walkeros/transformer-ga4": "4.7.2-next-1791147139360",
-    "@walkeros/web-destination-api": "4.7.2-next-1791147139360",
-    "@walkeros/web-destination-gtag": "4.7.2-next-1791147139360",
-    "@walkeros/web-source-browser": "4.7.2-next-1791147139360",
-    "@walkeros/web-source-cmp-cookiefirst": "4.7.2-next-1791147139360",
-    "@walkeros/web-source-cmp-usercentrics": "4.7.2-next-1791147139360",
-    "@walkeros/web-source-datalayer": "4.7.2-next-1791147139360",
-    "@walkeros/web-source-session": "4.7.2-next-1791147139360",
+    "@walkeros/config": "4.7.2",
+    "@walkeros/core": "4.7.2",
+    "@walkeros/destination-demo": "4.7.2",
+    "@walkeros/server-destination-aws": "4.7.2",
+    "@walkeros/server-destination-datamanager": "4.7.2",
+    "@walkeros/server-destination-gcp": "4.7.2",
+    "@walkeros/server-destination-meta": "4.7.2",
+    "@walkeros/server-destination-piwikpro": "4.7.2",
+    "@walkeros/server-source-aws": "4.7.2",
+    "@walkeros/server-source-express": "4.7.2",
+    "@walkeros/server-source-gcp": "4.7.2",
+    "@walkeros/server-store-fs": "4.7.2",
+    "@walkeros/server-transformer-bot": "4.7.2",
+    "@walkeros/server-transformer-file": "4.7.2",
+    "@walkeros/server-transformer-fingerprint": "4.7.2",
+    "@walkeros/transformer-ga4": "4.7.2",
+    "@walkeros/web-destination-api": "4.7.2",
+    "@walkeros/web-destination-gtag": "4.7.2",
+    "@walkeros/web-source-browser": "4.7.2",
+    "@walkeros/web-source-cmp-cookiefirst": "4.7.2",
+    "@walkeros/web-source-cmp-usercentrics": "4.7.2",
+    "@walkeros/web-source-datalayer": "4.7.2",
+    "@walkeros/web-source-session": "4.7.2",
     "msw": "^2.12.10",
     "openapi-typescript": "^7.13.0",
     "tsx": "^4.21.0"