create-daloy 0.1.24 → 0.3.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",
@@ -248,13 +248,15 @@ function renderBox(lines, options = {}) {
   return out.join("\n");
 }
 
-// Block-letter "DALOY" banner with a left-to-right cyan→magenta gradient when
-// the terminal supports truecolor. Falls back to a single bold-cyan line on
-// non-truecolor TTYs and to plain text in dumb terminals. The shape is built
-// from half-block characters so it stays compact (2 lines tall).
+// Block-letter "DALOYJS" banner rendered with a left-to-right golden
+// gradient (dark goldenrod → bright gold) on truecolor terminals. Falls back
+// to a single bold-yellow line on 256-color TTYs and to plain text in dumb
+// terminals. The shape is built from half-block characters so it stays
+// compact (2 lines tall) and each glyph is 3 columns wide with a single
+// space between letters, keeping the top and bottom rows perfectly aligned.
 const LOGO_LINES = [
-  " \u2588\u2580\u2584    \u2584\u2580\u2588    \u2588      \u2588\u2580\u2588   \u2588   \u2588 ",
-  " \u2588\u2584\u2580    \u2588\u2580\u2588    \u2588\u2584\u2584   \u2588\u2584\u2588    \u2580\u2584\u2580 ",
+  " \u2588\u2580\u2584 \u2584\u2580\u2588 \u2588   \u2588\u2580\u2588 \u2588 \u2588   \u2588 \u2584\u2580\u2580 ",
+  " \u2588\u2584\u2580 \u2588\u2580\u2588 \u2588\u2584\u2584 \u2588\u2584\u2588  \u2588  \u2584\u2584\u2588 \u2584\u2584\u2580 ",
 ];
 
 function gradientLine(line, startRgb, endRgb) {
@@ -274,23 +276,25 @@ function gradientLine(line, startRgb, endRgb) {
 
 function printBanner(version) {
   if (!SUPPORTS_UNICODE) {
-    console.log(`\n${color(COLORS.bold, "create-daloy")}  ${color(COLORS.dim, `v${version}`)}`);
+    console.log(`\n${color(COLORS.bold + COLORS.yellow, "create-daloy")}  ${color(COLORS.dim, `v${version}`)}`);
     console.log(color(COLORS.dim, "Contract-first REST APIs for Node, Bun, Deno, Vercel Edge, and Workers"));
     console.log(color(COLORS.dim, "https://daloyjs.dev\n"));
     return;
   }
-  const start = [56, 189, 248]; // sky-400
-  const end = [217, 70, 239]; // fuchsia-500
+  // Golden gradient: DarkGoldenrod → Gold. Evokes the DaloyJS "flow of gold"
+  // brand and stays legible on both light and dark terminal backgrounds.
+  const start = [184, 134, 11]; // DarkGoldenrod
+  const end = [255, 215, 0]; // Gold
   console.log("");
   for (const line of LOGO_LINES) {
     console.log(` ${gradientLine(line, start, end)}`);
   }
   // Build the welcome content lines (each contains its own ANSI color codes).
-  const headline = `${color(COLORS.bold, "Welcome to DaloyJS")}  ${color(COLORS.gray, `\u2014 v${version}`)}`;
+  const headline = `${color(COLORS.bold + COLORS.yellow, "Welcome to DaloyJS")}  ${color(COLORS.gray, `\u2014 v${version}`)}`;
   const subline = color(COLORS.dim, "Contract-first REST APIs for Node, Bun, Deno, Vercel Edge, and Workers.");
   const docs = `${color(COLORS.gray, "docs:")} ${color(COLORS.cyan, "https://daloyjs.dev/docs")}`;
   console.log("");
-  console.log(renderBox([headline, subline, "", docs]));
+  console.log(renderBox([headline, subline, "", docs], { accent: COLORS.yellow }));
   console.log("");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-daloy",
-  "version": "0.1.24",
+  "version": "0.3.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.2",
     "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.2",
     "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.2",
+    "@daloyjs/core/": "npm:@daloyjs/core@^0.8.2/",
     "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.2",
     "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.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {