Event Format

The JSONL structure written for each captured webhook event.

Storage Model

Each matched request is persisted as one JSON object per line.

Typical file layout:

.wsignal/events.jsonl
.wsignal/events.2026-03-29T12-00-00-000Z.jsonl
.wsignal/github.jsonl

Example Record

{
  "id": "evt_20260329044812_ab12cd",
  "endpoint": "github",
  "receivedAt": "2026-03-29T04:48:12.074Z",
  "method": "POST",
  "url": "http://localhost:8787/github?delivery=123",
  "path": "/github",
  "statusCode": 200,
  "logFile": "/absolute/path/to/.wsignal/github.jsonl",
  "headers": {
    "content-type": "application/json"
  },
  "query": {
    "delivery": "123"
  },
  "rawBody": "{\"ok\":true}",
  "bodySize": 11,
  "jsonBody": {
    "ok": true
  }
}

Field Reference

id

Generated event ID in the form evt_<timestamp>_<random>.

endpoint

Configured endpoint name that handled the request.

receivedAt

UTC timestamp for when the request was processed.

method

Incoming HTTP method.

url

Fully resolved request URL, including query string.

path

Matched request pathname.

statusCode

HTTP status that wsignal returned. For proxy endpoints, this is the upstream status or 502 if the upstream request failed.

logFile

Resolved destination log file path at capture time.

headers

Normalized incoming request headers.

query

Query parameters extracted from the request URL.

rawBody

UTF-8 body string as received.

bodySize

Captured body size in bytes.

jsonBody

Parsed JSON body, only present when rawBody is valid JSON.

In-Memory Read Model

When wsignal loads events for logs, inspect, or replay, it adds a sourceFile field in memory so commands can identify which file a record came from.

sourceFile is not written to disk.