cloudflare / cloudflare/developer-platform

Queues: add API to immediately dead-letter a specific message

Offen
#57 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
product:queues
Vorherrschende Sprache
Keine Sprachdaten
Sterne
1
Forks
0
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

Cloudflare Queues push consumers currently expose ack/retry controls, and configured DLQs receive messages only after max_retries is exhausted.

**Feature request:** add a push-consumer API to immediately dead-letter a specific message, for example:

```ts
message.deadLetter({ reason?: string })
```

**Use case:** a consumer can classify some failures as terminal/non-retryable, such as programmer bugs, malformed-but-preservable payloads, or invariant failures. Today the choices are either:

- ack the message and lose the payload, or
- retry/fail the message until max_retries so Cloudflare moves it to the configured DLQ, even though retries are known to be useless, or
- manually publish a custom failure envelope to a separate queue and then ack the original.

An immediate dead-letter primitive would let consumers preserve terminal failures in the configured DLQ without wasting retry attempts and without building a parallel application-level DLQ mechanism.

**Relevant docs:**
- https://developers.cloudflare.com/queues/configuration/dead-letter-queues/
- https://developers.cloudflare.com/queues/configuration/batching-retries/

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit der in der Issue verlinkten Dokumentation zu Cloudflare Queues für Dead-Letter und Batching/Retries und untersuche anschließend die bestehende Ack- und Retry-API für Push-Consumer. Lege fest, wie eine nachrichtenspezifische Dead-Letter-Operation und ein optionaler Grund sich verhalten sollen; fertig ist die Arbeit, wenn endgültige Fehler sofort die konfigurierte DLQ erreichen, ohne Retry-Versuche zu verbrauchen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
typescript
Bereich
api, cloud
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.