create-daloy 0.1.24 → 0.2.0

package/README.md

@@ -83,6 +83,7 @@ A Vercel Edge API bootstrap using `@daloyjs/core/vercel` with:
 
 - `api/[...path].ts` catch-all routing so DaloyJS owns the API surface.
 - `export const config = { runtime: "edge" }` ready for Vercel Edge.
+- Node.js migration notes using Vercel's default `{ fetch }` export shape.
 - `vercel dev` / `vercel deploy` scripts.
 - `secureHeaders` and `requestId` enabled by default, with smaller edge-friendly body and timeout limits.
 - A health route and bookstore route mirroring the Node starter.

package/bin/create-daloy.mjs

@@ -25,7 +25,7 @@ const TEMPLATE_OPTIONS = [
   {
     value: "vercel-edge",
     title: "Vercel Edge",
-    description: "Catch-all Edge API route using @daloyjs/core/vercel",
+    description: "Catch-all Vercel Edge route with Node.js migration notes",
   },
   {
     value: "cloudflare-worker",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-daloy",
-  "version": "0.1.24",
+  "version": "0.2.0",
   "description": "Scaffold a new DaloyJS project. Run with `pnpm create daloy`, `npm create daloy@latest`, `yarn create daloy`, or `bun create daloy`.",
   "type": "module",
   "license": "MIT",

package/templates/bun-basic/package.json

@@ -16,7 +16,7 @@
     "gen": "pnpm gen:openapi && pnpm gen:client"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.7.5",
+    "@daloyjs/core": "^0.8.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/templates/bun-basic/src/index.ts

@@ -4,8 +4,12 @@ import { buildApp } from "./build-app.ts";
 const app = buildApp();
 const port = Number(process.env.PORT ?? 3000);
 
-serve(app, { port });
-console.log(`DaloyJS (Bun) listening on http://localhost:${port}`);
+const handle = serve(app, {
+  port,
+  // Bun closes idle keep-alive connections after this many seconds.
+  idleTimeout: 30,
+});
+console.log(`DaloyJS (Bun) listening on ${handle.url ?? `http://localhost:${port}`}`);
 // daloy-minimal:strip-start docs
 console.log(`  Swagger UI:   http://localhost:${port}/docs`);
 console.log(`  OpenAPI JSON: http://localhost:${port}/openapi.json`);

package/templates/cloudflare-worker/AGENTS.md

@@ -15,7 +15,7 @@ A [DaloyJS](https://daloyjs.dev) REST API deployed to **Cloudflare Workers**. **
 
 ## Project shape
 
-- `src/index.ts` — Worker entrypoint. Builds the `App`, registers routes/middleware, and exports `default { fetch: toFetchHandler(app) }` from `@daloyjs/core/cloudflare`.
+- `src/index.ts` — Worker entrypoint. Builds the `App`, registers routes/middleware, and exports `default toFetchHandler(app)` from `@daloyjs/core/cloudflare`. Do NOT wrap the result in another `{ fetch }` object — `toFetchHandler` already returns the shape Workers expect.
 - `wrangler.toml` — Worker configuration (name, compatibility date, bindings, routes).
 - `tests/` — test files.
 
@@ -26,7 +26,7 @@ A [DaloyJS](https://daloyjs.dev) REST API deployed to **Cloudflare Workers**. **
 3. Preserve literal types in responses: `status: 200 as const`, `z.literal(...)` on discriminator fields.
 4. Throw typed errors (`NotFoundError`, `BadRequestError`, etc.) from `@daloyjs/core`.
 5. Keep `requestId()`, `secureHeaders()`, and `rateLimit()` enabled. For high-traffic routes, attach Cloudflare's native rate-limit binding (the in-memory limiter resets per isolate).
-6. Stay on the Workers runtime: only Web Standards APIs + Cloudflare bindings. No `node:` modules unless `nodejs_compat` is enabled and required.
+6. Stay on the Workers runtime: only Web Standards APIs + Cloudflare bindings. No `node:` modules unless you explicitly add `nodejs_compat` and require it.
 7. Bindings flow through `env`. Read KV/D1/R2/secrets from the `env` argument; never read them via globals.
 8. Long-running work belongs in `ctx.waitUntil(...)`, not blocking the response.
 9. Every new route ships with a test that covers a happy path and at least one unhappy path.

package/templates/cloudflare-worker/_agents/skills/daloyjs-best-practices/SKILL.md

@@ -23,9 +23,8 @@ Do **not** use this skill for tasks unrelated to the API itself.
 DaloyJS is a **contract-first** framework. On Workers, additionally:
 
 1. **Stay on the Workers runtime.** Only Web Standards APIs and
-   Cloudflare-specific bindings. No `node:` modules unless
-   `nodejs_compat` is enabled in `wrangler.toml` and the user explicitly
-   opts in.
+  Cloudflare-specific bindings. No `node:` modules unless the user
+  explicitly adds `nodejs_compat` to `wrangler.toml` and opts in.
 2. **The route definition is the contract.** Method, path, request
    schemas, and response schemas live in one place (`app.route({...})`).
 3. **Zod schemas validate at every boundary.**
@@ -40,8 +39,8 @@ DaloyJS is a **contract-first** framework. On Workers, additionally:
 ## Project shape
 
 - `src/index.ts` — the Worker entrypoint. Builds the `App`, registers
-  routes/middleware, and exports `default { fetch: toFetchHandler(app) }`
-  from `@daloyjs/core/cloudflare`.
+  routes/middleware, and exports `default toFetchHandler(app)` from
+  `@daloyjs/core/cloudflare`. Do not wrap the result in another `{ fetch }`.
 - `wrangler.toml` — Worker config (name, compatibility date, bindings,
   routes).
 - `tests/` — test files using Workers-compatible test runners (e.g.
@@ -115,7 +114,7 @@ function buildApp(env: Env) {
 
 export default {
   fetch: (req: Request, env: Env, ctx: ExecutionContext) =>
-    toFetchHandler(buildApp(env))(req, env, ctx),
+    toFetchHandler<Env>(buildApp(env)).fetch(req, env, ctx),
 };
 ```
 

package/templates/cloudflare-worker/package.json

@@ -10,7 +10,7 @@
     "test": "node --import tsx/esm --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.7.5",
+    "@daloyjs/core": "^0.8.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/templates/cloudflare-worker/src/index.ts

@@ -35,4 +35,4 @@ app.route({
 });
 // daloy-minimal:strip-end books
 
-export default { fetch: toFetchHandler(app) };
+export default toFetchHandler(app);

package/templates/cloudflare-worker/wrangler.toml

@@ -1,3 +1,3 @@
 name = "my-daloy-worker"
 main = "src/index.ts"
-compatibility_date = "2025-01-01"
+compatibility_date = "2026-05-01"

package/templates/deno-basic/deno.json

@@ -8,8 +8,8 @@
     "gen:openapi": "deno run --allow-net --allow-env --allow-read --allow-write scripts/dump-openapi.ts"
   },
   "imports": {
-    "@daloyjs/core": "npm:@daloyjs/core@^0.7.5",
-    "@daloyjs/core/": "npm:@daloyjs/core@^0.7.5/",
+    "@daloyjs/core": "npm:@daloyjs/core@^0.8.0",
+    "@daloyjs/core/": "npm:@daloyjs/core@^0.8.0/",
     "zod": "npm:zod@^4.4.3"
   },
   "compilerOptions": {

package/templates/deno-basic/src/main.ts

@@ -4,10 +4,14 @@ import { buildApp } from "./build-app.ts";
 const app = buildApp();
 const port = Number(Deno.env.get("PORT") ?? 3000);
 
-serve(app, { port });
-console.log(`DaloyJS (Deno) listening on http://localhost:${port}`);
-// daloy-minimal:strip-start docs
-console.log(`  Swagger UI:   http://localhost:${port}/docs`);
-console.log(`  OpenAPI JSON: http://localhost:${port}/openapi.json`);
-// daloy-minimal:strip-end docs
-console.log(`  Health:       http://localhost:${port}/healthz`);
+serve(app, {
+  port,
+  onListen: ({ hostname, port: actualPort }) => {
+    console.log(`DaloyJS (Deno) listening on http://${hostname}:${actualPort}`);
+    // daloy-minimal:strip-start docs
+    console.log(`  Swagger UI:   http://${hostname}:${actualPort}/docs`);
+    console.log(`  OpenAPI JSON: http://${hostname}:${actualPort}/openapi.json`);
+    // daloy-minimal:strip-end docs
+    console.log(`  Health:       http://${hostname}:${actualPort}/healthz`);
+  },
+});

package/templates/node-basic/package.json

@@ -18,7 +18,7 @@
     "audit": "pnpm audit --prod"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.7.5",
+    "@daloyjs/core": "^0.8.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/templates/vercel-edge/AGENTS.md

@@ -15,7 +15,7 @@ A [DaloyJS](https://daloyjs.dev) REST API deployed to **Vercel Edge**. **Contrac
 
 ## Project shape
 
-- `api/[...path].ts` — Edge entrypoint. Builds the `App`, registers routes/middleware, and exports `default toEdgeHandler(app)` plus `export const config = { runtime: "edge" }`. **Keep it a catch-all** so DaloyJS owns routing.
+- `api/[...path].ts` — Vercel Edge entrypoint. Builds the `App`, registers routes/middleware, and exports `default toWebHandler(app)` plus `export const config = { runtime: "edge" }`. **Keep it a catch-all** so DaloyJS owns routing. For Vercel's recommended Node.js runtime, remove the Edge config and export `default toFetchHandler(app)` from `@daloyjs/core/vercel`.
 - `vercel.json` — Vercel build/runtime configuration.
 - `tests/` — test files.
 

package/templates/vercel-edge/README.md

@@ -37,10 +37,21 @@ The API entry lives at `api/[...path].ts` and uses `@daloyjs/core/vercel`:
 
 ```ts
 export const config = { runtime: "edge" };
-export default toEdgeHandler(app);
+export default toWebHandler(app);
 ```
 
-That catch-all API route lets DaloyJS own routing while Vercel handles the Edge runtime.
+This starter defaults to Vercel's Edge runtime for compatibility with the
+`vercel-edge` template name. Vercel now recommends Node.js for new projects;
+for Node.js Functions, remove the `config` export and use the official default
+`{ fetch }` shape instead:
+
+```ts
+import { toFetchHandler } from "@daloyjs/core/vercel";
+
+export default toFetchHandler(app);
+```
+
+That catch-all API route lets DaloyJS own routing while Vercel handles the runtime.
 
 ## What's included
 

package/templates/vercel-edge/_agents/skills/daloyjs-best-practices/SKILL.md

@@ -39,7 +39,7 @@ DaloyJS is a **contract-first** framework. On Vercel Edge, additionally:
 ## Project shape
 
 - `api/[...path].ts` — the Edge entrypoint. Builds the `App`, registers
-  routes/middleware, and exports `default toEdgeHandler(app)` plus
+  routes/middleware, and exports `default toWebHandler(app)` plus
   `export const config = { runtime: "edge" }`.
 - `vercel.json` — Vercel build/runtime configuration.
 - `tests/` — test files (`*.test.ts`).
@@ -179,8 +179,9 @@ Aim for **100% line and function coverage** on the routes you add.
   handles routing. Do not split routes into multiple Vercel API files
   unless the user explicitly asks (it disables shared middleware and a
   unified OpenAPI).
-- Use `toEdgeHandler(app)` from `@daloyjs/core/vercel` — never hand-roll
-  a `fetch(req)` adapter.
+- Use `toWebHandler(app)` from `@daloyjs/core/vercel` for Edge — never
+  hand-roll a `fetch(req)` adapter. For Vercel's recommended Node.js
+  runtime, remove the Edge config and export `default toFetchHandler(app)`.
 - Do not import `@daloyjs/core/node`, `@daloyjs/core/bun`, etc. — only
   `@daloyjs/core` and `@daloyjs/core/vercel`.
 - Avoid Node-only APIs (`Buffer`, `fs`, full `process` API). If a

package/templates/vercel-edge/api/[...path].ts

@@ -1,11 +1,14 @@
 import { z } from "zod";
 import { App, NotFoundError, requestId, secureHeaders } from "@daloyjs/core";
-import { toEdgeHandler } from "@daloyjs/core/vercel";
+import { toWebHandler } from "@daloyjs/core/vercel";
 // daloy-minimal:strip-start docs
 import { generateOpenAPI } from "@daloyjs/core/openapi";
 import { htmlResponse, swaggerUiHtml } from "@daloyjs/core/docs";
 // daloy-minimal:strip-end docs
 
+// This template defaults to Vercel's Edge runtime for compatibility with the
+// existing `vercel-edge` starter. For Vercel's recommended Node.js runtime,
+// remove this config and export `toFetchHandler(app)` from @daloyjs/core/vercel.
 export const config = { runtime: "edge" };
 
 const app = new App({
@@ -95,4 +98,4 @@ app.route({
 });
 // daloy-minimal:strip-end docs
 
-export default toEdgeHandler(app);
+export default toWebHandler(app);

package/templates/vercel-edge/package.json

@@ -10,7 +10,7 @@
     "test": "node --import tsx/esm --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@daloyjs/core": "^0.7.5",
+    "@daloyjs/core": "^0.8.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {