cloudflare / cloudflare/developer-platform

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

Abierto
#57 3 comentarios 0 reacciones 0 asignados Ver en GitHub
product:queues
Lenguaje dominante
Sin datos de lenguaje
Estrellas
1
Forks
0
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

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/

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Empieza por la documentación de Cloudflare Queues sobre dead-letter y batching/retries enlazada en el issue; después inspecciona la API existente de ack y retry de push-consumer. Define cómo deben comportarse una operación de dead-letter específica para un mensaje y un motivo opcional; se considera terminado cuando los fallos terminales llegan inmediatamente a la DLQ configurada sin consumir intentos de retry.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
typescript
Área
api, cloud
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
45/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.