ObjectStackEvents Dlq
Events Dlq protocol schemas
Dead Letter Queue Entry Schema
Represents a failed event in the dead letter queue
Source: packages/spec/src/kernel/events/dlq.zod.ts
TypeScript Usage
import { DeadLetterQueueEntrySchema, EventLogEntrySchema } from '@objectstack/spec/kernel';
import type { DeadLetterQueueEntry, EventLogEntry } from '@objectstack/spec/kernel';
// Validate data
const result = DeadLetterQueueEntrySchema.parse(data);DeadLetterQueueEntry
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | ✅ | Unique entry identifier |
| event | { id?: string; name: string; payload: any; metadata: object } | ✅ | Original event |
| error | { message: string; stack?: string; code?: string } | ✅ | Failure details |
| retries | integer | ✅ | Number of retry attempts |
| firstFailedAt | string | ✅ | When event first failed |
| lastFailedAt | string | ✅ | When event last failed |
| failedHandler | string | optional | Handler ID that failed |
EventLogEntry
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | ✅ | Unique log entry identifier |
| event | { id?: string; name: string; payload: any; metadata: object } | ✅ | The event |
| status | Enum<'pending' | 'processing' | 'completed' | 'failed'> | ✅ | Processing status |
| handlersExecuted | { handlerId: string; status: Enum<'success' | 'failed' | 'timeout'>; durationMs?: integer; error?: string }[] | optional | Handlers that processed this event |
| receivedAt | string | ✅ | When event was received |
| processedAt | string | optional | When event was processed |
| totalDurationMs | integer | optional | Total processing time |