@zeltjs/adapter-cloudflare-workers 0.9.1-canary.5 → 0.10.0

package/README.md

@@ -15,7 +15,7 @@ pnpm add @zeltjs/adapter-cloudflare-workers
 ## Usage
 
 ```typescript
-import { createApp, Controller, Get } from '@zeltjs/core';
+import { createApp, http, Controller, Get } from '@zeltjs/core';
 import { onCloudflareWorkers } from '@zeltjs/adapter-cloudflare-workers';
 
 @Controller('/hello')
@@ -26,7 +26,7 @@ class HelloController {
   }
 }
 
-const app = createApp({ controllers: [HelloController] });
+const app = createApp([http({ controllers: [HelloController] })]);
 
 const workers = await onCloudflareWorkers(app);
 
@@ -49,7 +49,7 @@ onCloudflareWorkers(app, {
 `onCloudflareWorkers()` automatically registers `CloudflareWorkersEnvAdaptor`, which reads from the `cloudflare:workers` env. Use `inject(Env)` to access environment variables:
 
 ```typescript
-import { createApp, Controller, Get, Env, inject } from '@zeltjs/core';
+import { createApp, http, Controller, Get, Env, inject } from '@zeltjs/core';
 import { onCloudflareWorkers } from '@zeltjs/adapter-cloudflare-workers';
 
 @Controller('/config')
@@ -62,11 +62,47 @@ class ConfigController {
   }
 }
 
-const app = createApp({
-  http: { controllers: [ConfigController] },
-});
+const app = createApp([http({ controllers: [ConfigController] })]);
 
 const workers = await onCloudflareWorkers(app);
 
 export default { fetch: workers.fetch };
 ```
+
+## Cloudflare Bindings
+
+Wrangler bindings (D1, KV, R2, Durable Objects, etc.) are passed to `fetch(request, env, ctx)` as `env`, separate from the string-only environment variables exposed through `Env`. Use `CloudflareBindings` to access them with types generated by `wrangler types`:
+
+```typescript
+import { createApp, http, Controller, Get, inject } from '@zeltjs/core';
+import { CloudflareBindings, onCloudflareWorkers } from '@zeltjs/adapter-cloudflare-workers';
+
+// `wrangler types` augments the global `Env` with the bindings declared
+// in wrangler.toml, e.g.:
+// declare global {
+//   interface Env {
+//     DB: D1Database;
+//   }
+// }
+
+@Controller('/data')
+class DataController {
+  constructor(private bindings = inject(CloudflareBindings)) {}
+
+  @Get('/')
+  async list() {
+    const db = this.bindings.get('DB');
+    return { rows: await db.prepare('SELECT * FROM items').all() };
+  }
+}
+
+const app = createApp([http({ controllers: [DataController] })]);
+
+const workers = await onCloudflareWorkers(app);
+
+export default { fetch: workers.fetch };
+```
+
+`bindings.get('DB')` is typed from the augmented global `Env`, so no manual typing is needed.
+
+**Important:** `CloudflareBindings.get()` reads from request-scoped storage populated by `onCloudflareWorkers()`, so it only works during request handling — calling it outside a request (e.g. at module load time) throws.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeltjs/adapter-cloudflare-workers",
-  "version": "0.9.1-canary.5",
+  "version": "0.10.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "dist"
   ],
   "dependencies": {
-    "@zeltjs/core": "0.9.1-canary.5"
+    "@zeltjs/core": "0.10.0"
   },
   "devDependencies": {
     "@types/node": "22.19.17",