Skip to content

v0.6.0

Choose a tag to compare

@pplytas pplytas released this 27 Oct 08:46
c0b6b89

good-webhooks 0.6.0

Pure code release on schema 6, no SQL, tracked in #123.

Upgrade

  1. Restart producers, then workers.
  2. Better Auth: no migration is needed.

Added

  • Per-endpoint headers: headers on endpoint create and update, sent on every attempt and test event (docs, #128).
    • Encrypted at rest with the storage key and returned to the owner.
    • At most 20 headers and 2 KiB as JSON.
    • webhook-*, content-type, user-agent, and hop-by-hop names are rejected.
  • deliveries.stats() returns counts by status, the oldest pending age, and the last hour's attempts by outcome (docs, #129).
    • Two table reads per call, with the cost stated in the docs.
  • describeEvents() returns the event names, with a JSON Schema for each validator that implements Standard JSON Schema (docs, #130).
    • Zod 4.2+ and ArkType 2.1.28+ work as is, and Valibot needs @valibot/to-json-schema.
  • Better Auth create and update bodies accept headers, and the endpoint DTO returns them.

Changed

  • Management reads decrypt stored headers, so a rotated standalone storage key needs decryptionKeys for get() and list() too.
  • The worker sends headers a custom EndpointSource returns, and defers a delivery on a reserved name (docs).
  • The comparison page lists per-endpoint headers as shipped.

Docs

  • The pause retry-window reset is qualified as in ADR 0015 (#133).

Next: 0.7.0

  • No new features.
  • Large-history benchmark and multi-worker contention runs.
  • 72-hour Playground soak.
  • Roadmap.
npm install good-webhooks@0.6.0