create-daloy 0.1.23 → 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

@@ -3,10 +3,11 @@
 // Zero runtime dependencies; uses only Node built-ins.
 
 import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, openSync } from "node:fs";
 import { mkdir, readdir, readFile, writeFile, copyFile, rm } from "node:fs/promises";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
+import { ReadStream as TtyReadStream } from "node:tty";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -24,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",
@@ -794,9 +795,43 @@ function runQuiet(cmd, args, cwd) {
 //
 // `ask`/`askYesNo` use readline for resilience (paste, history, multi-line
 // input). `askChoice` upgrades to raw-mode arrow-key navigation when stdin is
-// a TTY, with a numbered fallback used by the readline-driven tests.
+// a TTY. When package-manager wrappers hide raw mode on process.stdin (pnpm
+// does this on some terminals), we reopen the controlling TTY directly before
+// falling back to the numbered prompt used by the readline-driven tests.
 // ----------------------------------------------------------------------------
 
+function choiceInputMode({ stdinIsTTY, hasRawMode, platform }) {
+  if (stdinIsTTY && hasRawMode) return "stdin";
+  if (platform !== "win32") return "tty";
+  return "numbered";
+}
+
+function openChoiceInputStream() {
+  const mode = choiceInputMode({
+    stdinIsTTY: process.stdin.isTTY,
+    hasRawMode: typeof process.stdin.setRawMode === "function",
+    platform: process.platform,
+  });
+  if (mode === "stdin") {
+    return { stream: process.stdin, dispose: () => {} };
+  }
+  if (mode !== "tty") return null;
+  try {
+    const fd = openSync("/dev/tty", "r");
+    const stream = new TtyReadStream(fd);
+    if (!stream.isTTY || typeof stream.setRawMode !== "function") {
+      stream.destroy();
+      return null;
+    }
+    return {
+      stream,
+      dispose: () => stream.destroy(),
+    };
+  } catch {
+    return null;
+  }
+}
+
 function printPromptHeader(question) {
   console.log(`${color(COLORS.cyan, SYMBOLS.stepActive)}  ${color(COLORS.bold, question)}`);
 }
@@ -842,8 +877,9 @@ function optionDescription(option) {
 // Arrow-key powered choice prompt. Falls back to numbered input whenever raw
 // mode is unavailable (CI, piped stdin, integration tests).
 async function askChoice(rl, question, choices, defaultChoice) {
-  const canRawMode = process.stdin.isTTY && typeof process.stdin.setRawMode === "function";
-  if (!canRawMode) return askChoiceNumbered(rl, question, choices, defaultChoice);
+  const rawInputHandle = openChoiceInputStream();
+  if (!rawInputHandle) return askChoiceNumbered(rl, question, choices, defaultChoice);
+  const rawInput = rawInputHandle.stream;
 
   printPromptHeader(question);
   printRailLine(color(COLORS.dim, `Use \u2191 \u2193 to navigate, Enter to confirm, type a number to jump.`));
@@ -875,9 +911,9 @@ async function askChoice(rl, question, choices, defaultChoice) {
 
   // Pause readline so it doesn't fight us for stdin while we're in raw mode.
   rl.pause();
-  process.stdin.setRawMode(true);
-  process.stdin.resume();
-  process.stdin.setEncoding("utf8");
+  rawInput.setRawMode(true);
+  rawInput.resume();
+  rawInput.setEncoding("utf8");
 
   // Initial render
   process.stdout.write(render(index) + "\n");
@@ -891,9 +927,10 @@ async function askChoice(rl, question, choices, defaultChoice) {
       process.stdout.write(render(newIndex) + "\n");
     }
     function cleanup() {
-      process.stdin.removeListener("data", onData);
-      process.stdin.setRawMode(false);
-      process.stdin.pause();
+      rawInput.removeListener("data", onData);
+      rawInput.setRawMode(false);
+      rawInput.pause();
+      rawInputHandle.dispose();
     }
     function onData(chunk) {
       const data = chunk.toString();
@@ -934,7 +971,7 @@ async function askChoice(rl, question, choices, defaultChoice) {
         rerender(index);
       }
     }
-    process.stdin.on("data", onData);
+    rawInput.on("data", onData);
   });
 
   // Replace the rendered list with a single confirmation line.
@@ -1272,4 +1309,8 @@ async function main() {
   }
 }
 
-await main();
+if (process.env.DALOY_TEST_IMPORT !== "1") {
+  await main();
+}
+
+export { choiceInputMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-daloy",
-  "version": "0.1.23",
+  "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": {