@walkeros/cli 4.9.0-next-1793283841805 → 4.9.0

package/dist/examples/shared/README.md

@@ -6,6 +6,9 @@ Files the server flow of `flow-complete.json` serves first party.
 - The `assets` store (`@walkeros/server-store-fs`,
   `basePath: "$env.ASSETS_DIR:./shared"`) reads from it, and the `file`
   transformer answers `GET /walker.js` with it.
+- `products/SKU-1` and `products/SKU-2` are the demo products of the order
+  example as JSON (name and price, no personal data); the `productApi`
+  transformer answers `GET /demo/products/SKU-1` with them.
 - `walker.js` is generated, not committed. Build the web flow straight into this
   folder (web builds ignore root `include`):
 

package/dist/examples/shared/products/SKU-1

@@ -0,0 +1 @@
+{"name":"Trail Runner","price":129.9}

package/dist/examples/shared/products/SKU-2

@@ -0,0 +1 @@
+{"name":"Running Socks","price":9.95}

package/dist/index.js

@@ -6515,7 +6515,7 @@ async function readStepPackageInfo(resolved, options) {
 }
 
 // src/commands/validate/validators/settings.ts
-var CLIENT_HEADER = "walkeros-cli/4.9.0-next-1793283841805";
+var CLIENT_HEADER = "walkeros-cli/4.9.0";
 var LOGGER = createLogger();
 function createSettingsContext(configDir) {
   return { configDir, cache: /* @__PURE__ */ new Map(), compiled: /* @__PURE__ */ new Map() };

package/dist/validate.js

@@ -870,7 +870,7 @@ async function readStepPackageInfo(resolved, options) {
 }
 
 // src/commands/validate/validators/settings.ts
-var CLIENT_HEADER = "walkeros-cli/4.9.0-next-1793283841805";
+var CLIENT_HEADER = "walkeros-cli/4.9.0";
 var LOGGER = createLogger();
 function createSettingsContext(configDir) {
   return { configDir, cache: /* @__PURE__ */ new Map(), compiled: /* @__PURE__ */ new Map() };

package/examples/customers/README.md

@@ -17,5 +17,5 @@ needs the variables the setup in `flow-complete.md` exports (`GCP_SA`,
 `FINGERPRINT_SALT`, `EMAIL_SALT`, `META_ACCESS_TOKEN`).
 
 In production the store is swapped for a real one, e.g.
-`@walkeros/server-store-sheets` or a GCS store; the `loadUser` step does not
-change.
+`@walkeros/server-store-sheets`, a GCS store, or `@walkeros/server-store-api`
+for your CRM's API; the `loadUser` step does not change.

package/examples/flow-complete.json

@@ -241,25 +241,25 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/web-source-cmp-usercentrics": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/web-source-session": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/web-source-datalayer": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/web-source-browser": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/web-destination-gtag": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/web-destination-api": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             }
           },
           "env": {
@@ -1778,40 +1778,40 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-source-express": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/transformer-ga4": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/transformer-validate": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-transformer-bot": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-transformer-fingerprint": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-transformer-file": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-store-fs": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-destination-gcp": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-destination-meta": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-destination-piwikpro": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-destination-datamanager": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             }
           }
         }
@@ -1881,6 +1881,10 @@
                 {
                   "path": "/walker.js",
                   "methods": ["GET"]
+                },
+                {
+                  "path": "/demo/products/:id",
+                  "methods": ["GET"]
                 }
               ],
               "cors": {
@@ -1942,6 +1946,14 @@
                   "value": "/g/collect"
                 },
                 "stop": true
+              },
+              {
+                "match": {
+                  "key": "ingest.path",
+                  "operator": "prefix",
+                  "value": "/demo/products/"
+                },
+                "next": "productApi"
               }
             ]
           },
@@ -2412,6 +2424,7 @@
           },
           "config": {
             "settings": {
+              "prefix": "/",
               "headers": {
                 "Cache-Control": "public, max-age=300",
                 "Cross-Origin-Resource-Policy": "same-site"
@@ -2422,6 +2435,23 @@
             "stop": true
           }
         },
+        "productApi": {
+          "package": "@walkeros/server-transformer-file",
+          "env": {
+            "store": "$store.assets"
+          },
+          "config": {
+            "settings": {
+              "prefix": "/demo/",
+              "headers": {
+                "Content-Type": "application/json; charset=utf-8"
+              }
+            }
+          },
+          "next": {
+            "stop": true
+          }
+        },
         "dedup": {
           "cache": {
             "stop": true,
@@ -4852,13 +4882,13 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-source-gcp": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             },
             "@walkeros/server-destination-gcp": {
-              "version": "4.9.0-next-1793283841805"
+              "version": "4.9.0"
             }
           }
         }

package/examples/flow-complete.md

@@ -39,8 +39,8 @@ web      usercentrics, session, dataLayer, browser
            -> 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) ]
+server   express /collect  /g/collect  /walker.js  /demo/products/:id
+           before: one [ G-SUBSITE hit -> ga4Decode -> ga4Consent | *.js -> file (stop) | other /g/collect (stop) | /demo/products/ -> productApi (stop) ]
            next: opt-out stop, dedup
            -> collector.next: fingerprint, bot, not impression -> enrich [ loadUser, sessionSave, sessionLoad, validate ]
            -> pubsub (every event, email pseudonymized)
@@ -140,13 +140,14 @@ walkeros push packages/cli/examples/flow-complete.json -f web -e '{"name":"page
 ## server-entry: A first-party endpoint, and a GA4 migration path
 
 - **Purpose:** one express source answers the browser (`/collect`), GA4 hits of
-  a sub-site (`/g/collect`) and script requests (`/walker.js`).
+  a sub-site (`/g/collect`), script requests (`/walker.js`) and product lookups
+  (`/demo/products/:id`).
 - **Features:**
   - `server-url` at `/flows/server/config/url`: The full collect endpoint, local
     by default, SERVER_URL in production.
   - `express-paths` at `/flows/server/sources/express/config/settings/paths`:
     One route per job, each with its own methods: /collect, /g/collect,
-    /walker.js.
+    /walker.js, /demo/products/:id.
   - `express-cors` at `/flows/server/sources/express/config/settings/cors`: CORS
     response headers for the shop origin; express adds X-Content-Type-Options
     itself.
@@ -740,6 +741,15 @@ walkeros push packages/cli/examples/flow-complete.json -f server -e '{"name":"pa
     first party from the server flow.
   - `file-headers` at `/flows/server/transformers/file/config/settings/headers`:
     Default response headers for served files: caching and resource policy.
+  - `file-prefix` at `/flows/server/transformers/file/config/settings/prefix`:
+    prefix / makes the step own every script request: a missing walker.js
+    answers 404 instead of the tracking pixel.
+  - `products-case` at `/flows/server/sources/express/before/one/3`: The last
+    case sends product lookups (/demo/products/<id>) to productApi.
+  - `product-api` at `/flows/server/transformers/productApi`: A lookup route:
+    GET /demo/products/<id> answers the product as JSON from the assets store
+    (prefix /demo/ is stripped to the key products/<id>; headers sets the JSON
+    Content-Type), 404 for an unknown id, and never becomes an event.
   - `gclid-to-ads` at
     `/flows/server/destinations/datamanager/config/mapping/order/complete/data/map/gclid`:
     The gclid saved at session start reaches Google Ads with the purchase.
@@ -752,12 +762,27 @@ walkeros push packages/cli/examples/flow-complete.json -f server -e '{"name":"pa
   (`packages/cli/examples/customers`, one JSON record per customer id), outside
   root `include`, so no customer data ships in a bundle. `basePath` is relative
   to the working directory, so `CUSTOMERS_DIR` holds it as an absolute path (the
-  setup block at the top exports it). In production a Sheets or GCS store takes
-  its place; `loadUser` does not change.
+  setup block at the top exports it). In production a Sheets or GCS store, or
+  `@walkeros/server-store-api` for your CRM's API, takes its place; `loadUser`
+  does not change.
 - **walker.js first party:** the `file` transformer answers `GET /walker.js`
   from the `assets` store with `settings.headers` (`Cache-Control`,
   `Cross-Origin-Resource-Policy`) and ends with `next: { stop: true }`. Express
-  `settings.cors` adds the CORS headers.
+  `settings.cors` adds the CORS headers. With `prefix: "/"` the step owns every
+  script request: a missing `walker.js` answers 404 with
+  `Cache-Control: no-store` instead of the tracking pixel.
+- **A lookup route:** `productApi` is a second `file` step on the same `assets`
+  store. `GET /demo/products/SKU-1` answers 200 with the product as JSON
+  (`shared/products/SKU-1`; `settings.headers` sets the JSON `Content-Type`,
+  since the step serves bytes as stored), an unknown id answers 404 with
+  `Cache-Control: no-store`, and `next: { stop: true }` keeps every lookup from
+  becoming an event. A failing store read answers 503 and is logged at ERROR.
+
+```bash
+curl -i http://localhost:8080/demo/products/SKU-1
+curl -i http://localhost:8080/demo/products/SKU-9
+```
+
 - **Why `X-Content-Type-Options: nosniff` is not in the file:** express sets it
   on every response itself.
 - The `file` example is proven over HTTP in the integration test; its simulation

package/examples/shared/README.md

@@ -6,6 +6,9 @@ Files the server flow of `flow-complete.json` serves first party.
 - The `assets` store (`@walkeros/server-store-fs`,
   `basePath: "$env.ASSETS_DIR:./shared"`) reads from it, and the `file`
   transformer answers `GET /walker.js` with it.
+- `products/SKU-1` and `products/SKU-2` are the demo products of the order
+  example as JSON (name and price, no personal data); the `productApi`
+  transformer answers `GET /demo/products/SKU-1` with them.
 - `walker.js` is generated, not committed. Build the web flow straight into this
   folder (web builds ignore root `include`):
 

package/examples/shared/products/SKU-1

@@ -0,0 +1 @@
+{"name":"Trail Runner","price":129.9}

package/examples/shared/products/SKU-2

@@ -0,0 +1 @@
+{"name":"Running Socks","price":9.95}

package/package.json

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