Skip to content

v0.5.0

Choose a tag to compare

@pplytas pplytas released this 26 Oct 08:25
010eea2

good-webhooks 0.5.0

Breaking minor on schema 6, tracked in #89.

Upgrade

  1. Run getPostgresUpgrade({ from: 5 }) or migrations/upgrades/006-all.sql.
    • Older schemas and separate namespaces: see migrations.
    • The step locks the deliveries table while it backfills, so prune first.
  2. Better Auth: run your Better Auth migration for the new encryptedHeaders field.
  3. Restart producers, then workers.
  4. Custom ManagementRepository: create now takes { limit }.
  5. Custom ManagementRepository: store StoredEndpoint.encryptedHeaders as is.

Breaking

  • check() refuses schema 5.
  • A pause resets the retry window (ADR 0015).
    • Paused deliveries keep their full retry.maxAgeMs after resume.
    • A worker must run during the pause.
  • ManagementRepository.create and StoredEndpoint changed shape (upgrade steps 4 and 5).
  • Built-in management needs no change.

Added

  • deliveries.replayMany() replays one page of an endpoint's failed deliveries (docs).
    • Returns { replayed, skipped, nextCursor }.
  • StoredEndpoint.encryptedHeaders and EndpointResolution.headers, stored only until 0.6.0.
  • OpenTelemetry recipe with no new dependency.
  • getPostgresUpgrade({ from: 5 }), rehearsed in CI.

Docs and repository

Next: 0.6.0

  • No SQL.
  • Headers sent on every attempt.
  • deliveries.stats().
  • describeEvents().
  • Roadmap.

Dependencies

  • zod 4.6.7 (audit fix).
npm install good-webhooks@0.5.0