The Complete Production SOP: How to Deploy and Run Cloudflare Workers & Hono.js Edge in Autonomous AI Agents

---
name: "cloudflare-worker"
description: "Deploy ultra-low latency edge APIs with Cloudflare Workers, Hono.js, KV, and D1 SQL database."
category: "fullstack"
tags: ["cloudflare", "hono", "workers", "d1", "kv", "edge"]
---

# Rules for Cloudflare Workers & Hono.js
1. Target the workerd edge runtime. Do NOT use Node.js core modules (fs, path, child_process).
2. Bindings (KV, D1, Secrets) must be typed via Hono's generic: `new Hono<{ Bindings: Env }>()`.
3. Access environment variables only via `c.env.VARIABLE_NAME`, never `process.env`.
4. Always test locally with `wrangler dev` or Miniflare before emitting deployment PRs.

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "edge-api",
  "main": "src/index.ts",
  "compatibility_date": "2024-04-01",
  "compatibility_flags": ["nodejs_compat"],
  "kv_namespaces": [
    {
      "binding": "CACHE_KV",
      "id": "local-kv-id"
    }
  ],
  "d1_databases": [
    {
      "binding": "DB",
      "database_name": "prod-db",
      "database_id": "local-d1-id"
    }
  ]
}

import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { prettyJSON } from 'hono/pretty-json';

type Bindings = {
  CACHE_KV: KVNamespace;
  DB: D1Database;
  API_SECRET: string;
};

const app = new Hono<{ Bindings: Bindings }>();

app.use('*', cors());
app.use('*', prettyJSON());

app.get('/health', (c) => {
  return c.json({ status: 'ok', timestamp: Date.now() });
});

app.get('/users/:id', async (c) => {
  const id = c.req.param('id');
  const cached = await c.env.CACHE_KV.get(`user:${id}`);
  if (cached) return c.json(JSON.parse(cached));

  const user = await c.env.DB.prepare('SELECT id, name, email FROM users WHERE id = ?')
    .bind(id)
    .first();

  if (!user) return c.json({ error: 'User not found' }, 404);
  await c.env.CACHE_KV.put(`user:${id}`, JSON.stringify(user), { expirationTtl: 300 });
  return c.json(user);
});

export default app;