Queue

A Queue represents a message queue for decoupling services and asynchronous processing. On AWS this is SQS, on GCP Pub/Sub. Hetzner and DigitalOcean do not have native managed queue services.

Config

Property	Type	Required	Description
name	string	yes	Unique resource name
id	string	no	Explicit ID (auto-generated UUID if omitted)
provider	string	no	Provider label for multi-provider configs
tags	Record<string, string>	no	Arbitrary key-value metadata
fifo	boolean	no	Enable FIFO (first-in-first-out) ordering (default false)
retentionSeconds	number	no	Message retention period in seconds (default 86400)

Example

import { Queue } from '@kykucloud/types'

const taskQueue = new Queue({
  name: 'task-queue',
  retentionSeconds: 604800,  // 7 days
})

const orderQueue = new Queue({
  name: 'order-queue',
  fifo: true,
})

Provider Support

Provider	Supported	Backend
AWS	✅	SQS (Simple Queue Service)
GCP	✅	Pub/Sub
Hetzner	❌	Not available
DigitalOcean	❌	Not available

Notes

• AWS SQS FIFO queues support exactly-once processing and message grouping. Standard queues offer at-least-once delivery. FIFO queue names must end with .fifo.
• GCP Pub/Sub is a publish-subscribe messaging system. Topics and subscriptions are managed together. The fifo option maps to Pub/Sub ordering keys.
• Retention: AWS SQS supports up to 14 days (1,209,600 seconds). GCP Pub/Sub message retention is configurable per subscription.
• Dead-letter queues: Not yet abstracted in this resource type. Configure through provider-specific settings or CustomResource.