Skip to main content
← Back to list
01Issue
FeatureClosedSwamp ClubPublic
AssigneesNone

Relationships

#2219 docs: webhook extension kind and Telegram webhook how-to

Opened by stack72 · 9/16/2026

What changed

swamp-club lab #2204 adds a new `webhook` extension kind for `swamp serve`:

  • `export const webhook = { type, name, description, configSchema?, createHandler(config) }`; the handler provides `signatureHeader`, `requiredHeaders`, `verify(body, headers, secret)`, and optional `transform(body, redactedHeaders)` / `respond(payload) → { status, headers?, body?, enqueue }`.
  • Webhook schemes of the form `@collective/name` are resolved from extensions (auto-pulled for trusted collectives); built-in schemes unchanged.
  • `serve.yaml` webhook entries accept `scheme: "@collective/name"` plus an optional `config:` object; `--webhook` accepts an extension scheme in the 4th field (no config).
  • Manifest gains a `webhooks:` array; extension dir `extensions/webhooks/`.
  • First published extension: `@swamp/telegram` (static secret token in `X-Telegram-Bot-Api-Secret-Token`, constant-time compare; weaker than HMAC — TLS only).

Pages to update (swamp-club `content/manual/`)

  • reference: serve/webhooks reference — extension schemes, `config:` field, hook ordering (hooks only after successful verify), fail-closed semantics, no handler timeout, response headers not filtered.
  • reference: extensions reference — new `webhook` kind, `webhooks:` manifest field.
  • how-to: new "Receive Telegram bot updates with swamp serve" (`setWebhook` with `secret_token`, `serve.yaml` example, security caveats).
  • how-to: creating a custom webhook extension (transform/respond example, e.g. challenge echo).

Automoved by swampadmin from https://github.com/swamp-club/swamp/issues/2478

02Bog Flow
OPENTRIAGEDIN PROGRESSCLOSED

Closed

9/18/2026, 4:22:26 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 9/18/2026, 4:22:24 PM

Documented the webhook extension kind (manifest, extensions reference, webhooks reference with extension schemes and @swamp/telegram), plus Telegram and extension scheme how-to sections. Fixed in #1234.

Sign in to post a ripple.