@walkeros/cli 4.7.2-next-1791147139360 → 4.7.2

package/dist/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/dist/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/dist/examples/index.d.ts

@@ -753,13 +753,16 @@ declare const teaching: {
         note: string;
         docs: never[];
     };
-    'rule-consent': {
+    'user-optout': {
         pointer: string;
         chapter: "consent-privacy";
-        level: "intermediate";
-        useCases: "consent"[];
+        level: "beginner";
+        useCases: ("consent" | "privacy-analytics")[];
         note: string;
-        docs: never[];
+        docs: {
+            page: string;
+            anchor: string;
+        }[];
     };
     'value-consent': {
         pointer: string;
@@ -1638,6 +1641,18 @@ declare const teaching: {
             name: string;
         };
     };
+    'piwik-segment': {
+        pointer: string;
+        chapter: "state-stores";
+        level: "intermediate";
+        useCases: "privacy-analytics"[];
+        note: string;
+        docs: never[];
+        example: {
+            step: string;
+            name: string;
+        };
+    };
     'store-fs': {
         pointer: string;
         chapter: "state-stores";
@@ -2204,7 +2219,9 @@ declare const flowCompleteCoverage: {
     mappingRule: {
         batch: "rule-batch";
         condition: "rule-condition";
-        consent: "rule-consent";
+        consent: {
+            excluded: string;
+        };
         settings: "rule-settings";
         data: "rule-data";
         include: {
@@ -2284,7 +2301,7 @@ declare const flowCompleteCoverage: {
             excluded: string;
         };
         sequence: "route-sequence";
-        id: "source-next";
+        id: "destination-before";
     };
     combinator: {
         and: "match-and";
@@ -2577,7 +2594,9 @@ declare const flowCompleteManifest: {
         mappingRule: {
             batch: "rule-batch";
             condition: "rule-condition";
-            consent: "rule-consent";
+            consent: {
+                excluded: string;
+            };
             settings: "rule-settings";
             data: "rule-data";
             include: {
@@ -2657,7 +2676,7 @@ declare const flowCompleteManifest: {
                 excluded: string;
             };
             sequence: "route-sequence";
-            id: "source-next";
+            id: "destination-before";
         };
         combinator: {
             and: "match-and";

package/dist/examples/index.js

@@ -264,25 +264,25 @@ var flow_complete_default = {
         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: {
@@ -300,7 +300,17 @@ var flow_complete_default = {
         custom: {
           environment: "$env.ENVIRONMENT"
         },
-        next: "pageGroup"
+        next: [
+          {
+            match: {
+              key: "event.user.optout",
+              operator: "eq",
+              value: "true"
+            },
+            stop: true
+          },
+          "pageGroup"
+        ]
       },
       sources: {
         usercentrics: {
@@ -1014,9 +1024,6 @@ var flow_complete_default = {
                         ]
                       }
                     }
-                  },
-                  consent: {
-                    functional: true
                   }
                 }
               }
@@ -1064,9 +1071,6 @@ var flow_complete_default = {
                       ]
                     }
                   }
-                },
-                consent: {
-                  functional: true
                 }
               },
               in: {
@@ -1204,9 +1208,6 @@ var flow_complete_default = {
                       ]
                     }
                   }
-                },
-                consent: {
-                  functional: true
                 }
               },
               in: {
@@ -1787,40 +1788,40 @@ var flow_complete_default = {
         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"
             }
           }
         }
@@ -1955,7 +1956,17 @@ var flow_complete_default = {
               }
             ]
           },
-          next: "dedup",
+          next: [
+            {
+              match: {
+                key: "event.user.optout",
+                operator: "eq",
+                value: "true"
+              },
+              stop: true
+            },
+            "dedup"
+          ],
           examples: {
             postCollect: {
               title: "Event from the web flow",
@@ -4522,7 +4533,10 @@ var flow_complete_default = {
                 "event.user.device",
                 "event.user.session",
                 "event.user.hash"
-              ]
+              ],
+              customDimensions: {
+                "1": "user.segment"
+              }
             },
             mapping: {
               page: {
@@ -4617,7 +4631,7 @@ var flow_complete_default = {
           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",
@@ -4681,7 +4695,8 @@ var flow_complete_default = {
                   hash: "5f1c0a9e7d3b2c41",
                   botScore: 0,
                   botCategory: "human",
-                  ltv: 420
+                  ltv: 420,
+                  segment: "loyal"
                 },
                 source: {
                   type: "express",
@@ -4714,7 +4729,7 @@ var flow_complete_default = {
                 [
                   "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: 5e3
                   }
@@ -4881,13 +4896,13 @@ var flow_complete_default = {
         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"
             }
           }
         }
@@ -5381,7 +5396,7 @@ var teaching = {
     chapter: "chains-routing",
     level: "intermediate",
     useCases: [],
-    note: "On the web collector.next runs the inline pageGroup step once per event.",
+    note: "On the web collector.next stops an opted-out user first, then runs the inline pageGroup step once per event.",
     docs: [{ page: "getting-started/flow/routing" }],
     example: { step: "pageGroup", name: "checkout" }
   },
@@ -5788,13 +5803,13 @@ var teaching = {
     note: "Destination consent: Meta only gets events with marketing consent.",
     docs: []
   },
-  "rule-consent": {
-    pointer: "/flows/web/destinations/ga4/config/mapping/order/complete/consent",
+  "user-optout": {
+    pointer: "/flows/server/sources/express/next/0",
     chapter: "consent-privacy",
-    level: "intermediate",
-    useCases: ["consent"],
-    note: "Rule consent on purchases: not enforced yet; the destination's functional consent gates them. Marketing consent belongs to Meta and Data Manager.",
-    docs: []
+    level: "beginner",
+    useCases: ["consent", "privacy-analytics"],
+    note: "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.",
+    docs: [{ page: "guides/consent/index", anchor: "opt-out" }]
   },
   "value-consent": {
     pointer: "/flows/web/destinations/collect/config/policy/user.email/consent",
@@ -6092,7 +6107,7 @@ var teaching = {
     chapter: "chains-routing",
     level: "beginner",
     useCases: [],
-    note: "source.next names the hop after the source, here dedup.",
+    note: "source.next names the hops after the source: the opt-out stop, then dedup.",
     docs: [{ page: "getting-started/flow/routing" }]
   },
   "collector-next": {
@@ -6492,6 +6507,15 @@ var teaching = {
     docs: [{ page: "collector/state" }],
     example: { step: "loadUser", name: "knownCustomer" }
   },
+  "piwik-segment": {
+    pointer: "/flows/server/destinations/piwikpro/config/settings/customDimensions",
+    chapter: "state-stores",
+    level: "intermediate",
+    useCases: ["privacy-analytics"],
+    note: "Piwik PRO gets the loaded segment as custom dimension 1; the path is relative to the event, so user.segment.",
+    docs: [],
+    example: { step: "piwikpro", name: "orderWithGoal" }
+  },
   "store-fs": {
     pointer: "/flows/server/stores/assets",
     chapter: "state-stores",
@@ -7031,7 +7055,9 @@ var flowCompleteCoverage = {
   mappingRule: {
     batch: "rule-batch",
     condition: "rule-condition",
-    consent: "rule-consent",
+    consent: {
+      excluded: "rule consent is not enforced yet; destination consent is the gate in this file"
+    },
     settings: "rule-settings",
     data: "rule-data",
     include: {
@@ -7101,7 +7127,7 @@ var flowCompleteCoverage = {
     stop: "route-stop",
     gate: { excluded: ROUTE_CASES },
     sequence: "route-sequence",
-    id: "source-next"
+    id: "destination-before"
   },
   combinator: {
     and: "match-and",