try-works/role-model / .agents/skills/cloudflare
cloudflare
UnverifiedComprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
references/queues/patterns.md
View on GitHub# Queues Patterns & Best Practices
## Async Task Processing
```typescript
// Producer: Accept request, queue work
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const { userId, reportType } = await request.json();
await env.REPORT_QUEUE.send({ userId, reportType, requestedAt: Date.now() });
return Response.json({ message: 'Report queued', status: 'pending' });
}
};
// Consumer: Process reports
export default {
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
const { userId, reportType } = msg.body;
const report = await generateReport(userId, reportType, env);
await env.REPORTS_BUCKET.put(`${userId}/${reportType}.pdf`, report);
msg.ack();
}
}
};
```
## Buffering API Calls
```typescript
// Producer: Queue log entries
ctx.waitUntil(env.LOGS_QUEUE.send({
method: request.method,
url: request.url,
timestamp: Date.now()
}));
// Consumer: Batch write to external API
async queue(batch: MessageBatch, env: Env): Promise<void> {
const logs = batch.messages.map(m => m.body);
await fetch(env.LOG_ENDPOINT, { method: 'POST', body: JSON.stringify({ logs }) });
batch.ackAll();
}
```
## Rate Limiting Upstream
```typescript
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
try {
await callRateLimitedAPI(msg.body);
msg.ack();
} catch (error) {
if (error.status === 429) {
const retryAfter = parseInt(error.headers.get('Retry-After') || '60');
msg.retry({ delaySeconds: retryAfter });
} else throw error;
}
}
}
```
## Event-Driven Workflows
```typescript
// R2 event → Queue → Worker
export default {
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
const event = msg.body;
if (event.action === 'PutObject') {
await processNewFile(event.object.key, env);
} else if (event.action === 'DeleteObject') {
await cleanupReferences(event.object.key, env);
}
msg.ack();
}
}
};
```
## Dead Letter Queue Pattern
```typescript
// Main queue: After max_retries, goes to DLQ automatically
export default {
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
try {
await riskyOperation(msg.body);
msg.ack();
} catch (error) {
console.error(`Failed after ${msg.attempts} attempts:`, error);
}
}
}
};
// DLQ consumer: Log and store failed messages
export default {
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
await env.FAILED_KV.put(msg.id, JSON.stringify(msg.body));
msg.ack();
}
}
};
```
## Priority Queues
High priority: `max_batch_size: 5, max_batch_timeout: 1`. Low priority: `max_batch_size: 100, max_batch_timeout: 30`.
## Delayed Job Processing
```typescript
await env.EMAIL_QUEUE.send({ to, template, userId }, { delaySeconds: 3600 });
```
## Fan-out Pattern
```typescript
async fetch(request: Request, env: Env): Promise<Response> {
const event = await request.json();
// Send to multiple queues for parallel processing
await Promise.all([
env.ANALYTICS_QUEUE.send(event),
env.NOTIFICATIONS_QUEUE.send(event),
env.AUDIT_LOG_QUEUE.send(event)
]);
return Response.json({ status: 'processed' });
}
```
## Idempotency Pattern
```typescript
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
// Check if already processed
const processed = await env.PROCESSED_KV.get(msg.id);
if (processed) {
msg.ack();
continue;
}
await processMessage(msg.body);
await env.PROCESSED_KV.put(msg.id, '1', { expirationTtl: 86400 });
msg.ack();
}
}
```
## Integration: D1 Batch Writes
```typescript
async queue(batch: MessageBatch, env: Env): Promise<void> {
// Collect all inserts for single D1 batch
const statements = batch.messages.map(msg =>
env.DB.prepare('INSERT INTO events (id, data, created) VALUES (?, ?, ?)')
.bind(msg.id, JSON.stringify(msg.body), Date.now())
);
try {
await env.DB.batch(statements);
batch.ackAll();
} catch (error) {
console.error('D1 batch failed:', error);
batch.retryAll({ delaySeconds: 60 });
}
}
```
## Integration: Workflows
```typescript
// Queue triggers Workflow for long-running tasks
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
try {
const instance = await env.MY_WORKFLOW.create({
id: msg.id,
params: msg.body
});
console.log('Workflow started:', instance.id);
msg.ack();
} catch (error) {
msg.retry({ delaySeconds: 30 });
}
}
}
```
## Integration: Durable Objects
```typescript
// Queue distributes work to Durable Objects by ID
async queue(batch: MessageBatch, env: Env): Promise<void> {
for (const msg of batch.messages) {
const { userId, action } = msg.body;
// Route to user-specific DO
const id = env.USER_DO.idFromName(userId);
const stub = env.USER_DO.get(id);
try {
await stub.fetch(new Request('https://do/process', {
method: 'POST',
body: JSON.stringify({ action, messageId: msg.id })
}));
msg.ack();
} catch (error) {
msg.retry({ delaySeconds: 60 });
}
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |