@walkeros/cli 2.0.1 → 2.1.0

package/examples/README.md

@@ -60,14 +60,14 @@ Feature Inventory and usage examples.
 
 ```bash
 # Web flow (opens browser with demo events)
-walkeros serve examples/flow-complete.json --flow web
+walkeros run examples/flow-complete.json --flow web
 
 # Server flow (HTTP collection endpoint)
 walkeros run examples/flow-complete.json --flow server
 
 # Both (full pipeline)
 # Terminal 1: walkeros run examples/flow-complete.json --flow server
-# Terminal 2: walkeros serve examples/flow-complete.json --flow web
+# Terminal 2: walkeros run examples/flow-complete.json --flow web
 ```
 
 ---
@@ -92,7 +92,7 @@ event flow testing
 
 ```bash
 walkeros bundle examples/web-serve.json
-walkeros run serve examples/web-serve.js -p 3000
+walkeros run examples/web-serve.js -p 3000
 # Open http://localhost:3000 in browser
 ```
 
@@ -159,7 +159,7 @@ web-serve.json
 
 ```bash
 walkeros bundle examples/server-collect.json
-walkeros run collect examples/server-collect.mjs -p 8080
+walkeros run examples/server-collect.mjs -p 8080
 
 # In another terminal, send test event:
 curl -X POST http://localhost:8080/collect \
@@ -199,7 +199,7 @@ export GTM_CONTAINER_ID="GTM-XXXXX"
 export GTM_SERVER_URL="https://your-gtm-server.com"
 
 # Run in Docker
-walkeros run collect examples/server-collection.json -p 8080
+walkeros run examples/server-collection.json -p 8080
 
 # Send test event (in another terminal)
 curl -X POST http://localhost:8080/collect \
@@ -228,14 +228,14 @@ The simplest way to see the complete event flow:
 
 ```bash
 walkeros bundle examples/server-collect.json
-walkeros run collect examples/server-collect.mjs -p 8080
+walkeros run examples/server-collect.mjs -p 8080
 ```
 
 **Terminal 2 - Start web server**:
 
 ```bash
 walkeros bundle examples/web-serve.json
-walkeros run serve examples/web-serve.js -p 3000
+walkeros run examples/web-serve.js -p 3000
 ```
 
 **Browser**: Open http://localhost:3000
@@ -253,7 +253,7 @@ For production with real analytics platforms:
 **1. Start collection server**:
 
 ```bash
-walkeros run collect examples/server-collection.json -p 8080
+walkeros run examples/server-collection.json -p 8080
 ```
 
 **2. Bundle web tracking** (configured to send to localhost:8080):

package/examples/flow-complete.json

@@ -318,6 +318,89 @@
                 }
               }
             }
+          },
+          "examples": {
+            "page-view": {
+              "in": {
+                "name": "page view",
+                "data": { "title": "Home", "path": "/" },
+                "entity": "page",
+                "action": "view"
+              },
+              "mapping": {
+                "name": "page_view",
+                "data": {
+                  "map": {
+                    "page_title": "data.title",
+                    "page_location": "data.path"
+                  }
+                }
+              },
+              "out": [
+                "event",
+                "page_view",
+                { "page_title": "Home", "page_location": "/" }
+              ]
+            },
+            "product-add": {
+              "in": {
+                "name": "product add",
+                "data": {
+                  "id": "SKU-001",
+                  "name": "Blue Shirt",
+                  "price": 49.99,
+                  "currency": "EUR",
+                  "quantity": 2
+                },
+                "entity": "product",
+                "action": "add"
+              },
+              "mapping": {
+                "name": "add_to_cart",
+                "data": {
+                  "map": {
+                    "currency": { "key": "data.currency", "value": "EUR" },
+                    "value": "data.price",
+                    "items": {
+                      "loop": [
+                        "this",
+                        {
+                          "map": {
+                            "item_id": "data.id",
+                            "item_name": "data.name",
+                            "quantity": { "key": "data.quantity", "value": 1 }
+                          }
+                        }
+                      ]
+                    }
+                  }
+                }
+              },
+              "out": [
+                "event",
+                "add_to_cart",
+                {
+                  "currency": "EUR",
+                  "value": 49.99,
+                  "items": [
+                    {
+                      "item_id": "SKU-001",
+                      "item_name": "Blue Shirt",
+                      "quantity": 2
+                    }
+                  ]
+                }
+              ]
+            },
+            "test-ignored": {
+              "in": {
+                "name": "test debug",
+                "data": { "message": "This should be ignored" },
+                "entity": "test",
+                "action": "debug"
+              },
+              "out": false
+            }
           }
         },
         "api": {
@@ -417,6 +500,25 @@
               "context.language": "headers.accept-language",
               "context.referer": "headers.referer"
             }
+          },
+          "examples": {
+            "post-event": {
+              "in": {
+                "method": "POST",
+                "path": "/collect",
+                "headers": { "content-type": "application/json" },
+                "body": {
+                  "name": "page view",
+                  "data": { "title": "Home", "url": "https://example.com" }
+                }
+              },
+              "out": {
+                "name": "page view",
+                "data": { "title": "Home", "url": "https://example.com" },
+                "entity": "page",
+                "action": "view"
+              }
+            }
           }
         }
       },
@@ -427,7 +529,32 @@
             "push": "$code:(event) => event.name.startsWith('internal_') || event.name.startsWith('debug_') ? false : event"
           },
           "next": "fingerprint",
-          "config": {}
+          "config": {},
+          "examples": {
+            "passes-normal": {
+              "in": {
+                "name": "page view",
+                "data": { "title": "Home" },
+                "entity": "page",
+                "action": "view"
+              },
+              "out": {
+                "name": "page view",
+                "data": { "title": "Home" },
+                "entity": "page",
+                "action": "view"
+              }
+            },
+            "filters-internal": {
+              "in": {
+                "name": "internal_heartbeat",
+                "data": {},
+                "entity": "internal",
+                "action": "heartbeat"
+              },
+              "out": false
+            }
+          }
         },
         "fingerprint": {
           "package": "@walkeros/server-transformer-fingerprint",
@@ -610,6 +737,42 @@
                 }
               }
             }
+          },
+          "examples": {
+            "purchase": {
+              "in": {
+                "name": "order complete",
+                "data": {
+                  "id": "ORD-123",
+                  "total": 149.97,
+                  "currency": "EUR"
+                },
+                "entity": "order",
+                "action": "complete"
+              },
+              "mapping": {
+                "name": "Purchase",
+                "data": {
+                  "map": {
+                    "value": "data.total",
+                    "currency": { "key": "data.currency", "value": "EUR" },
+                    "order_id": "data.id"
+                  }
+                }
+              },
+              "out": {
+                "data": [
+                  {
+                    "event_name": "Purchase",
+                    "custom_data": {
+                      "value": 149.97,
+                      "currency": "EUR",
+                      "order_id": "ORD-123"
+                    }
+                  }
+                ]
+              }
+            }
           }
         },
         "demo": {

package/examples/flow-complete.md

@@ -33,7 +33,7 @@ complete event tracking architecture.
 
 ```bash
 cd walkerOS
-npx walkeros serve packages/cli/examples/flow-complete.json --flow web
+npx walkeros run packages/cli/examples/flow-complete.json --flow web
 # Open http://localhost:3000 - demo events fire automatically
 ```
 
@@ -64,7 +64,7 @@ curl -X POST http://localhost:8080/collect \
 npx walkeros run packages/cli/examples/flow-complete.json --flow server
 
 # Terminal 2: Start web (sends to server via API destination)
-npx walkeros serve packages/cli/examples/flow-complete.json --flow web
+npx walkeros run packages/cli/examples/flow-complete.json --flow web
 ```
 
 ---

package/examples/flow-selfhost-test.json

@@ -0,0 +1,24 @@
+{
+  "version": 1,
+  "flows": {
+    "default": {
+      "server": {},
+      "packages": {
+        "@walkeros/collector": {}
+      },
+      "sources": {
+        "http": {
+          "package": "@walkeros/server-source-express",
+          "primary": true,
+          "config": {
+            "settings": {
+              "port": 8080,
+              "cors": true
+            }
+          }
+        }
+      },
+      "destinations": {}
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkeros/cli",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "walkerOS CLI - Bundle and deploy walkerOS components",
   "license": "MIT",
   "type": "module",
@@ -29,8 +29,9 @@
     "build": "tsup",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
-    "test": "jest --colors",
-    "test:integration": "jest --colors --testPathPatterns='(cli\\.test|cli-e2e\\.test)'",
+    "test": "jest --colors --testPathIgnorePatterns '__tests__/e2e/'",
+    "test:debug": "jest --colors --detectOpenHandles --testPathIgnorePatterns '__tests__/e2e/'",
+    "test:integration": "jest --colors --testPathPatterns='__tests__/e2e/'",
     "generate:types": "openapi-typescript ${OPENAPI_SPEC:-./openapi/spec.json} -o src/types/api.gen.d.ts",
     "generate:types:local": "OPENAPI_SPEC=${WALKEROS_APP_URL:-http://localhost:3000}/api/openapi.json npm run generate:types",
     "typecheck": "tsc --noEmit",
@@ -42,7 +43,7 @@
     "docker:publish": "bash scripts/publish-docker.sh"
   },
   "dependencies": {
-    "@walkeros/server-core": "^2.0.0",
+    "@walkeros/server-core": "^2.1.0",
     "ajv": "^8.17.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
@@ -54,7 +55,7 @@
     "open": "^11.0.0",
     "openapi-fetch": "^0.17.0",
     "pacote": "^21.0.4",
-    "@walkeros/core": "^2.0.0"
+    "@walkeros/core": "^2.1.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",