@karmaniverous/jeeves-server 3.0.0-0

package/guides/deployment.md

@@ -0,0 +1,287 @@
+# Deployment
+
+How to run Jeeves Server in production.
+
+> Jeeves Server runs on **Windows** and **Linux**. Both platforms are tested in CI.
+
+## Prerequisites
+
+- **Node.js** ≥ 18
+- **Chrome or Chromium** — for PDF/DOCX export via Puppeteer
+- **A domain** with HTTPS — required for Google OAuth and secure sharing
+- **A reverse proxy** — nginx, Caddy, or similar (recommended)
+
+### Optional Dependencies
+
+- **Java** (JDK 11+) — required for local PlantUML rendering with `!include` support. Without Java, PlantUML falls back to the community server (no `!include` support).
+- **PlantUML jar** — download from [plantuml.com/download](https://plantuml.com/download). Configure the path in `jeeves.config.ts` under `plantuml.jarPath`.
+- **Mermaid CLI** — for server-side Mermaid diagram rendering. Install with `npm install @mermaid-js/mermaid-cli` and configure `mermaidCliPath` in `jeeves.config.ts`.
+
+## Running the Server
+
+### Direct
+
+```bash
+node dist/server.js
+```
+
+The server listens on the port configured in `jeeves.config.ts` (default: 1934) on all interfaces (`0.0.0.0`).
+
+### As a Windows Service (NSSM)
+
+[NSSM](https://nssm.cc/) (Non-Sucking Service Manager) turns any executable into a Windows service:
+
+```bash
+# Install the service
+nssm install JeevesServer "C:\Program Files\nodejs\node.exe" "E:\jeeves-server\dist\server.js"
+
+# Configure working directory
+nssm set JeevesServer AppDirectory "E:\jeeves-server"
+
+# Configure stdout/stderr logging
+nssm set JeevesServer AppStdout "E:\jeeves-server\logs\service-stdout.log"
+nssm set JeevesServer AppStderr "E:\jeeves-server\logs\service-stderr.log"
+
+# Start the service
+nssm start JeevesServer
+```
+
+**Service management:**
+```bash
+nssm start JeevesServer
+nssm stop JeevesServer
+nssm restart JeevesServer
+nssm status JeevesServer
+nssm remove JeevesServer confirm   # Uninstall
+```
+
+### As a systemd Service (Linux)
+
+```ini
+# /etc/systemd/system/jeeves-server.service
+[Unit]
+Description=Jeeves Server
+After=network.target
+
+[Service]
+Type=simple
+User=jeeves
+WorkingDirectory=/opt/jeeves-server
+ExecStart=/usr/bin/node /opt/jeeves-server/dist/server.js
+Restart=on-failure
+RestartSec=5
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+sudo systemctl enable jeeves-server
+sudo systemctl start jeeves-server
+sudo systemctl status jeeves-server
+```
+
+### Linux Quick Start (Ubuntu/Debian)
+
+```bash
+# System packages
+sudo apt-get update && sudo apt-get install -y curl git build-essential chromium-browser caddy
+
+# Node.js 22
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
+sudo apt-get install -y nodejs
+
+# Clone and build
+cd /opt
+sudo git clone https://github.com/karmaniverous/jeeves-server.git
+cd jeeves-server
+npm ci
+cd client && npm ci && npx vite build --outDir ../dist/client && cd ..
+npx tsc
+
+# Configure
+cp jeeves.config.template.ts jeeves.config.ts
+# Edit jeeves.config.ts — set chromePath, roots, auth, keys, etc.
+echo '{}' > state.json
+```
+
+**Linux-specific config options:**
+
+```typescript
+{
+  // Chromium path (required for PDF/DOCX export)
+  chromePath: '/usr/bin/chromium-browser',
+
+  // Filesystem roots for the file browser (replaces Windows drive letters)
+  roots: {
+    home: '/home',
+    projects: '/opt/projects',
+  },
+
+  // Mermaid CLI path (optional, for .mmd diagram rendering)
+  mermaidCliPath: '/opt/mermaid-cli',
+}
+```
+
+On Windows, `roots` is ignored — the file browser auto-discovers drive letters. On Linux, if `roots` is omitted, it defaults to `{ root: '/' }`.
+
+**Puppeteer config** (for Chromium on Linux):
+
+Create `puppeteer.json` in the server root:
+```json
+{
+  "executablePath": "/usr/bin/chromium-browser",
+  "args": ["--no-sandbox", "--disable-setuid-sandbox"]
+}
+```
+
+## Reverse Proxy
+
+Running behind a reverse proxy is recommended for:
+- **HTTPS termination** — required for Google OAuth and secure key transmission
+- **Domain routing** — serve on a clean domain/subdomain
+- **Rate limiting** and request filtering
+
+### Caddy (simplest)
+
+```
+jeeves.example.com {
+    reverse_proxy localhost:1934
+}
+```
+
+Caddy automatically provisions and renews HTTPS certificates via Let's Encrypt.
+
+### nginx
+
+```nginx
+server {
+    listen 443 ssl http2;
+    server_name jeeves.example.com;
+
+    ssl_certificate /etc/letsencrypt/live/jeeves.example.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/jeeves.example.com/privkey.pem;
+
+    location / {
+        proxy_pass http://localhost:1934;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # Large file uploads (for webhook bodies)
+        client_max_body_size 10M;
+
+        # WebSocket support (if needed in future)
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+    }
+}
+
+server {
+    listen 80;
+    server_name jeeves.example.com;
+    return 301 https://$host$request_uri;
+}
+```
+
+## HTTPS
+
+**HTTPS is required** when using Google OAuth — Google will not redirect to an HTTP callback URL (except `localhost` for development).
+
+**HTTPS is strongly recommended** even with key-only auth, because keys appear in URL parameters. Without HTTPS, keys are visible to network observers.
+
+### Options
+
+| Method | Effort | Best For |
+|--------|--------|----------|
+| **Caddy** | Minimal | Automatic HTTPS, zero config |
+| **Let's Encrypt + nginx** | Moderate | Fine-grained control |
+| **Cloudflare Tunnel** | Moderate | No port forwarding needed |
+
+## Google OAuth Setup for Production
+
+When using Google OAuth in production:
+
+1. **Add your domain** to the Google Cloud Console OAuth consent screen
+2. **Set the redirect URI** to `https://your-domain.com/auth/google/callback`
+3. **Update `jeeves.config.ts`** with the production credentials
+
+> **Dev vs Prod:** You can use different Google OAuth client IDs for development and production. Each `jeeves.config.ts` is gitignored and instance-specific.
+
+### Multiple environments
+
+Run dev and prod on the same machine using different ports:
+
+```typescript
+// Dev: jeeves.config.ts (port 3457)
+port: 3457,
+auth: {
+  google: {
+    clientId: 'dev-client-id.apps.googleusercontent.com',
+    clientSecret: 'dev-secret',
+  },
+},
+
+// Prod: jeeves.config.ts (port 1934)
+port: 1934,
+auth: {
+  google: {
+    clientId: 'prod-client-id.apps.googleusercontent.com',
+    clientSecret: 'prod-secret',
+  },
+},
+```
+
+Each needs its own Google OAuth redirect URI registered.
+
+## Health Checks
+
+The `/health` endpoint requires no authentication:
+
+```bash
+curl http://localhost:1934/health
+# Returns 200 OK
+```
+
+Use this for:
+- Load balancer health checks
+- Service monitoring (Uptime Kuma, Prometheus, etc.)
+- NSSM/systemd restart triggers
+
+## Updating
+
+```bash
+cd /path/to/jeeves-server
+git pull
+
+# Full rebuild
+npm install
+npm run build
+cd client && npx vite build --outDir ../dist/client && cd ..
+
+# Restart the service
+nssm restart JeevesServer           # Windows
+sudo systemctl restart jeeves-server # Linux
+```
+
+> ⚠️ Remember: `npm run build` deletes `dist/` entirely. Always rebuild the client after the server.
+
+## File Permissions
+
+The server needs:
+- **Read access** to any files you want to serve (drives, directories)
+- **Write access** to its own directory for `state.json` and `logs/`
+- **Execute access** to Chrome/Chromium for PDF export
+- **Execute access** to event handler commands
+
+## Backups
+
+Key files to back up:
+- `jeeves.config.ts` — your configuration (secrets!)
+- `state.json` — insider keys and rotation state
+- `logs/event-queue.jsonl` + `logs/event-queue.cursor` — pending events
+
+The server code itself is in git — no need to back up `dist/` or `node_modules/`.

package/guides/event-gateway.md

@@ -0,0 +1,204 @@
+# Event Gateway
+
+Jeeves Server includes a webhook gateway that receives HTTP POST requests, validates them against JSON Schema rules, and dispatches matched events to shell commands via a durable queue.
+
+## Overview
+
+![Event Gateway Flow](event-gateway.svg)
+
+## Configuration
+
+Events are defined in `jeeves.config.ts`:
+
+```typescript
+events: {
+  'notion-page-update': {
+    // JSON Schema matched against the incoming POST body
+    schema: {
+      type: 'object',
+      properties: {
+        type: { const: 'page.content_updated' },
+      },
+      required: ['type'],
+    },
+
+    // Shell command to execute when matched
+    cmd: 'node /path/to/handler.js',
+
+    // Optional: transform the body before passing to the command
+    map: {
+      pageId: {
+        '$': { method: '$.lib._.get', params: ['$.input', 'data.page_id'] },
+      },
+      type: {
+        '$': { method: '$.lib._.get', params: ['$.input', 'type'] },
+      },
+    },
+
+    // Optional: override default timeout (ms)
+    timeoutMs: 60000,
+  },
+},
+```
+
+### Schema matching
+
+Each event has a [JSON Schema](https://json-schema.org/) that's validated against the incoming request body using [ajv](https://ajv.js.org/). The **first matching** event wins — order matters if schemas could overlap.
+
+Common patterns:
+
+```json
+// Match a specific event type
+{ "type": "object", "properties": { "type": { "const": "page.content_updated" } }, "required": ["type"] }
+
+// Match any object with an "action" field
+{ "type": "object", "required": ["action"] }
+
+// Match based on nested field
+{ "type": "object", "properties": { "data": { "type": "object", "properties": { "status": { "const": "completed" } } } } }
+```
+
+### Body mapping with JsonMap
+
+When an event config includes a `map` object, the incoming body is transformed via [@karmaniverous/jsonmap](https://github.com/karmaniverous/jsonmap) before being passed to the command. This extracts only the fields you need from potentially large webhook payloads.
+
+The `lib` object available in mappings includes [`radash`](https://github.com/sodiray/radash) as `_`.
+
+When `map` is omitted, the full webhook body is passed as-is.
+
+**Example — Notion sends a large payload, we extract just two fields:**
+
+```typescript
+map: {
+  pageId: {
+    '$': { method: '$.lib._.get', params: ['$.input', 'data.page_id'] },
+  },
+  type: {
+    '$': { method: '$.lib._.get', params: ['$.input', 'type'] },
+  },
+},
+```
+
+Input: `{ type: "page.content_updated", data: { page_id: "abc123", ... } }`
+Output to command: `{ pageId: "abc123", type: "page.content_updated" }`
+
+## Authentication
+
+Webhook callers must authenticate with a key that has scope access to `/event`:
+
+```typescript
+keys: {
+  'webhook-notion': {
+    key: 'random-seed-string',
+    scopes: ['/event'],
+  },
+},
+```
+
+Your config contains a **seed** — a secret string that never leaves the server. The actual URL key is **derived** from the seed by the server. To get it:
+
+```bash
+curl -s "https://your-domain.com/insider-key" -H "X-API-Key: <your-seed>"
+# Returns: { "key": "a1b2c3d4..." }
+```
+
+Use the returned key in webhook URLs:
+
+```bash
+curl -X POST "https://your-domain.com/event?key=<derived-key>" \
+  -H "Content-Type: application/json" \
+  -d '{"type": "page.content_updated", "data": {"page_id": "abc123"}}'
+```
+
+Insiders with `/event` scope can also copy an authenticated event URL directly from the **Event link button** in the header bar — no command line needed.
+
+See the [Insiders, Outsiders & Sharing](sharing.md) guide for full details on the key model.
+
+## Queue Processing
+
+Events are processed through a **durable JSONL queue**:
+
+1. **Append** — Validated events are appended to `logs/event-queue.jsonl` with metadata
+2. **Drain** — A single-threaded processor reads entries sequentially
+3. **Execute** — For each entry, the `cmd` is spawned with the (optionally mapped) body piped as JSON to stdin
+4. **Timeout** — Commands are killed after `timeoutMs` (per-event or the global `eventTimeoutMs` default)
+5. **Errors logged** — The command is responsible for its own error handling; the queue processor logs and moves on
+6. **Cursor** — A cursor file (`logs/event-queue.cursor`) tracks the byte offset of the last processed entry, surviving restarts
+
+### Queue entry format
+
+```jsonl
+{"ts":"2026-02-15T05:00:00Z","event":"notion-page-update","cmd":"node handler.js","body":{"pageId":"abc123"},"timeoutMs":60000}
+```
+
+### Durability
+
+The queue survives server restarts. On startup, the processor reads the cursor file and resumes from where it left off. If the cursor file is missing, processing starts from the beginning of the queue.
+
+## Event Logging
+
+All events — matched and unmatched — are logged to `logs/event-log.jsonl`:
+
+```jsonl
+{"ts":"2026-02-15T05:00:00Z","event":"notion-page-update","matched":true,"exitCode":0,"durationMs":1234}
+{"ts":"2026-02-15T05:00:01Z","event":null,"matched":false,"bodyPreview":"..."}
+```
+
+### Log purging
+
+Each log write also purges entries older than `eventLogPurgeMs` (default: 30 days). This keeps the log file from growing unbounded.
+
+## Writing Event Handlers
+
+Your command receives the (optionally mapped) body as JSON on **stdin**:
+
+```javascript
+// handler.js
+const chunks = [];
+process.stdin.on('data', (chunk) => chunks.push(chunk));
+process.stdin.on('end', () => {
+  const body = JSON.parse(Buffer.concat(chunks).toString());
+  console.log('Received:', body.pageId);
+  // Do your work here
+});
+```
+
+**Key points:**
+- The command runs in the server's working directory
+- stdout/stderr are captured for logging
+- Exit code 0 = success, anything else = failure (logged but not retried)
+- The command must complete within `timeoutMs` or it's killed
+
+## Global Settings
+
+```typescript
+// Default timeout for all event commands (ms)
+eventTimeoutMs: 30_000,
+
+// Purge log entries older than this (ms). Default: 30 days
+eventLogPurgeMs: 2_592_000_000,
+```
+
+## Monitoring
+
+Check the event log for failures:
+
+```bash
+# Recent failures
+grep '"exitCode":' logs/event-log.jsonl | grep -v '"exitCode":0'
+
+# Unmatched events (potential misconfiguration)
+grep '"matched":false' logs/event-log.jsonl
+```
+
+## Example: Notion Webhook Integration
+
+1. **Configure the event** in `jeeves.config.ts` (see Configuration above)
+2. **Create a scoped key** for the webhook
+3. **Register the webhook URL** in Notion:
+   - Settings → Connections → Add a connection
+   - Webhook URL: `https://your-domain.com/event?key=<webhook-derived-key>`
+4. **Write your handler** to process the mapped body
+5. **Verify** by triggering a page update and checking `logs/event-log.jsonl`
+
+> **Note:** Notion signs webhooks with HMAC. For production use, add signature verification in your handler before processing.

package/guides/event-gateway.mmd

@@ -0,0 +1,17 @@
+flowchart TD
+    A["POST /event?key=‹scoped-key›"] --> B["Authenticate key\n(check scope includes /event)"]
+    B --> C{"For each event\nin config.events"}
+    C --> D["Validate body against\nevent.schema (ajv)"]
+    D --> E{"Match?"}
+    E -- "First match wins" --> F{"event.map\ndefined?"}
+    F -- Yes --> G["Transform body\nvia JsonMap"]
+    F -- No --> H["Use full body"]
+    G --> I["Append to durable\nJSONL queue"]
+    H --> I
+    I --> J["Return 200\n{ matched: ‹event-name› }"]
+    E -- "No match" --> K["Log as unmatched"]
+    K --> L["Return 200\n{ matched: null }"]
+
+    style A fill:#4a9eff,color:#fff,stroke:#2d7dd2
+    style J fill:#22c55e,color:#fff,stroke:#16a34a
+    style L fill:#f59e0b,color:#fff,stroke:#d97706

package/guides/event-gateway.svg

@@ -0,0 +1 @@
+<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 789.625px; background-color: white;" viewBox="0 0 789.625 1542.296875" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:2.0px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape rect,#my-svg .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path d="M394.813,86L394.813,90.167C394.813,94.333,394.813,102.667,394.813,110.333C394.813,118,394.813,125,394.813,128.5L394.813,132" id="L_A_B_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_A_B_0" data-points="W3sieCI6Mzk0LjgxMjUsInkiOjg2fSx7IngiOjM5NC44MTI1LCJ5IjoxMTF9LHsieCI6Mzk0LjgxMjUsInkiOjEzNn1d" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M394.813,214L394.813,218.167C394.813,222.333,394.813,230.667,394.813,238.333C394.813,246,394.813,253,394.813,256.5L394.813,260" id="L_B_C_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_B_C_0" data-points="W3sieCI6Mzk0LjgxMjUsInkiOjIxNH0seyJ4IjozOTQuODEyNSwieSI6MjM5fSx7IngiOjM5NC44MTI1LCJ5IjoyNjR9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M394.813,542L394.813,546.167C394.813,550.333,394.813,558.667,394.813,566.333C394.813,574,394.813,581,394.813,584.5L394.813,588" id="L_C_D_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_C_D_0" data-points="W3sieCI6Mzk0LjgxMjUsInkiOjU0Mn0seyJ4IjozOTQuODEyNSwieSI6NTY3fSx7IngiOjM5NC44MTI1LCJ5Ijo1OTJ9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M394.813,694L394.813,698.167C394.813,702.333,394.813,710.667,394.813,718.333C394.813,726,394.813,733,394.813,736.5L394.813,740" id="L_D_E_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_D_E_0" data-points="W3sieCI6Mzk0LjgxMjUsInkiOjY5NH0seyJ4IjozOTQuODEyNSwieSI6NzE5fSx7IngiOjM5NC44MTI1LCJ5Ijo3NDR9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M364.406,816.234L348.073,827.469C331.74,838.703,299.073,861.172,282.74,877.906C266.406,894.641,266.406,905.641,266.406,911.141L266.406,916.641" id="L_E_F_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_E_F_0" data-points="W3sieCI6MzY0LjQwNjIxODQ1ODIzODcsInkiOjgxNi4yMzQzNDM0NTgyMzg4fSx7IngiOjI2Ni40MDYyNSwieSI6ODgzLjY0MDYyNX0seyJ4IjoyNjYuNDA2MjUsInkiOjkyMC42NDA2MjV9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M217.181,1077.072L203.985,1091.443C190.788,1105.814,164.394,1134.555,151.197,1154.426C138,1174.297,138,1185.297,138,1190.797L138,1196.297" id="L_F_G_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_F_G_0" data-points="W3sieCI6MjE3LjE4MTQ4NTU1MzY3ODU2LCJ5IjoxMDc3LjA3MjExMDU1MzY3ODZ9LHsieCI6MTM4LCJ5IjoxMTYzLjI5Njg3NX0seyJ4IjoxMzgsInkiOjEyMDAuMjk2ODc1fV0=" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M315.631,1077.072L328.828,1091.443C342.025,1105.814,368.419,1134.555,381.616,1156.426C394.813,1178.297,394.813,1193.297,394.813,1200.797L394.813,1208.297" id="L_F_H_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_F_H_0" data-points="W3sieCI6MzE1LjYzMTAxNDQ0NjMyMTQ0LCJ5IjoxMDc3LjA3MjExMDU1MzY3ODZ9LHsieCI6Mzk0LjgxMjUsInkiOjExNjMuMjk2ODc1fSx7IngiOjM5NC44MTI1LCJ5IjoxMjEyLjI5Njg3NX1d" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M138,1278.297L138,1282.464C138,1286.63,138,1294.964,145.763,1302.999C153.526,1311.035,169.052,1318.774,176.816,1322.643L184.579,1326.513" id="L_G_I_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_G_I_0" data-points="W3sieCI6MTM4LCJ5IjoxMjc4LjI5Njg3NX0seyJ4IjoxMzgsInkiOjEzMDMuMjk2ODc1fSx7IngiOjE4OC4xNTg2OTE0MDYyNSwieSI6MTMyOC4yOTY4NzV9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M394.813,1266.297L394.813,1272.464C394.813,1278.63,394.813,1290.964,387.049,1300.999C379.286,1311.035,363.76,1318.774,355.997,1322.643L348.234,1326.513" id="L_H_I_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_H_I_0" data-points="W3sieCI6Mzk0LjgxMjUsInkiOjEyNjYuMjk2ODc1fSx7IngiOjM5NC44MTI1LCJ5IjoxMzAzLjI5Njg3NX0seyJ4IjozNDQuNjUzODA4NTkzNzUsInkiOjEzMjguMjk2ODc1fV0=" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M266.406,1406.297L266.406,1410.464C266.406,1414.63,266.406,1422.964,266.406,1430.63C266.406,1438.297,266.406,1445.297,266.406,1448.797L266.406,1452.297" id="L_I_J_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_I_J_0" data-points="W3sieCI6MjY2LjQwNjI1LCJ5IjoxNDA2LjI5Njg3NX0seyJ4IjoyNjYuNDA2MjUsInkiOjE0MzEuMjk2ODc1fSx7IngiOjI2Ni40MDYyNSwieSI6MTQ1Ni4yOTY4NzV9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M433,808.453L469.437,820.985C505.875,833.516,578.75,858.578,615.187,889.247C651.625,919.917,651.625,956.193,651.625,974.331L651.625,992.469" id="L_E_K_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_E_K_0" data-points="W3sieCI6NDMyLjk5OTgyMTczOTgxOTM3LCJ5Ijo4MDguNDUzMzAzMjYwMTgwNn0seyJ4Ijo2NTEuNjI1LCJ5Ijo4ODMuNjQwNjI1fSx7IngiOjY1MS42MjUsInkiOjk5Ni40Njg3NX1d" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M651.625,1050.469L651.625,1069.273C651.625,1088.078,651.625,1125.688,651.625,1149.992C651.625,1174.297,651.625,1185.297,651.625,1190.797L651.625,1196.297" id="L_K_L_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_K_L_0" data-points="W3sieCI6NjUxLjYyNSwieSI6MTA1MC40Njg3NX0seyJ4Ijo2NTEuNjI1LCJ5IjoxMTYzLjI5Njg3NX0seyJ4Ijo2NTEuNjI1LCJ5IjoxMjAwLjI5Njg3NX1d" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_A_B_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_B_C_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_C_D_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_D_E_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(266.40625, 883.640625)"><g class="label" data-id="L_E_F_0" transform="translate(-59.015625, -12)"><foreignObject width="118.03125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>First match wins</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(138, 1163.296875)"><g class="label" data-id="L_F_G_0" transform="translate(-11.328125, -12)"><foreignObject width="22.65625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>Yes</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(394.8125, 1163.296875)"><g class="label" data-id="L_F_H_0" transform="translate(-9.3984375, -12)"><foreignObject width="18.796875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>No</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_G_I_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_H_I_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_I_J_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(651.625, 883.640625)"><g class="label" data-id="L_E_K_0" transform="translate(-34.15625, -12)"><foreignObject width="68.3125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>No match</p></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_K_L_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="flowchart-A-0" transform="translate(394.8125, 47)"><rect class="basic label-container" style="fill:#4a9eff !important;stroke:#2d7dd2 !important" x="-130" y="-39" width="260" height="78"/><g class="label" style="color:#fff !important" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div style="color: rgb(255, 255, 255) !important; display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#fff !important" class="nodeLabel"><p>POST /event?key=‹scoped-key›</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-B-1" transform="translate(394.8125, 175)"><rect class="basic label-container" style="" x="-130" y="-39" width="260" height="78"/><g class="label" style="" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Authenticate key\n(check scope includes /event)</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-C-3" transform="translate(394.8125, 403)"><polygon points="139,0 278,-139 139,-278 0,-139" class="label-container" transform="translate(-138.5, 139)"/><g class="label" style="" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>For each event\nin config.events</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-D-5" transform="translate(394.8125, 643)"><rect class="basic label-container" style="" x="-130" y="-51" width="260" height="102"/><g class="label" style="" transform="translate(-100, -36)"><rect/><foreignObject width="200" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Validate body against\nevent.schema (ajv)</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-E-7" transform="translate(394.8125, 795.3203125)"><polygon points="51.3203125,0 102.640625,-51.3203125 51.3203125,-102.640625 0,-51.3203125" class="label-container" transform="translate(-50.8203125, 51.3203125)"/><g class="label" style="" transform="translate(-24.3203125, -12)"><rect/><foreignObject width="48.640625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Match?</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-F-9" transform="translate(266.40625, 1023.46875)"><polygon points="102.828125,0 205.65625,-102.828125 102.828125,-205.65625 0,-102.828125" class="label-container" transform="translate(-102.328125, 102.828125)"/><g class="label" style="" transform="translate(-75.828125, -12)"><rect/><foreignObject width="151.65625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>event.map\ndefined?</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-G-11" transform="translate(138, 1239.296875)"><rect class="basic label-container" style="" x="-130" y="-39" width="260" height="78"/><g class="label" style="" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Transform body\nvia JsonMap</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-H-13" transform="translate(394.8125, 1239.296875)"><rect class="basic label-container" style="" x="-76.8125" y="-27" width="153.625" height="54"/><g class="label" style="" transform="translate(-46.8125, -12)"><rect/><foreignObject width="93.625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Use full body</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-I-15" transform="translate(266.40625, 1367.296875)"><rect class="basic label-container" style="" x="-130" y="-39" width="260" height="78"/><g class="label" style="" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;"><span class="nodeLabel"><p>Append to durable\nJSONL queue</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-J-19" transform="translate(266.40625, 1495.296875)"><rect class="basic label-container" style="fill:#22c55e !important;stroke:#16a34a !important" x="-130" y="-39" width="260" height="78"/><g class="label" style="color:#fff !important" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div style="color: rgb(255, 255, 255) !important; display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#fff !important" class="nodeLabel"><p>Return 200\n{ matched: ‹event-name› }</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-K-21" transform="translate(651.625, 1023.46875)"><rect class="basic label-container" style="" x="-94.53125" y="-27" width="189.0625" height="54"/><g class="label" style="" transform="translate(-64.53125, -12)"><rect/><foreignObject width="129.0625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="nodeLabel"><p>Log as unmatched</p></span></div></foreignObject></g></g><g class="node default" id="flowchart-L-23" transform="translate(651.625, 1239.296875)"><rect class="basic label-container" style="fill:#f59e0b !important;stroke:#d97706 !important" x="-130" y="-39" width="260" height="78"/><g class="label" style="color:#fff !important" transform="translate(-100, -24)"><rect/><foreignObject width="200" height="48"><div style="color: rgb(255, 255, 255) !important; display: table; white-space: break-spaces; line-height: 1.5; max-width: 200px; text-align: center; width: 200px;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#fff !important" class="nodeLabel"><p>Return 200\n{ matched: null }</p></span></div></foreignObject></g></g></g></g></g></svg>