create-daloy 0.1.0 → 0.1.1

package/README.md

@@ -13,7 +13,7 @@ bun  create daloy           my-api
 The CLI is interactive when arguments are missing. It will ask you for:
 
 - A project directory name (defaults to `my-daloy-app`)
-- A template (`node-basic` or `cloudflare-worker`)
+- A template (`node-basic`, `vercel-edge`, or `cloudflare-worker`)
 - Whether to install dependencies
 - Whether to initialize a git repository
 
@@ -31,7 +31,7 @@ pnpm create daloy@latest my-api \
 
 | Flag | Description |
 | --- | --- |
-| `--template <name>` | `node-basic` (default) or `cloudflare-worker`. |
+| `--template <name>` | `node-basic` (default), `vercel-edge`, or `cloudflare-worker`. |
 | `--package-manager <pm>` | `pnpm` (default), `npm`, `yarn`, or `bun`. |
 | `--install` / `--no-install` | Install dependencies after scaffolding. Defaults to interactive. |
 | `--git` / `--no-git` | Initialize a git repository. Defaults to interactive. |
@@ -60,6 +60,15 @@ A minimal Cloudflare Worker bootstrap using `@daloyjs/core/cloudflare` with:
 - Zod-validated route exposed as `fetch`.
 - A sample test that exercises `app.request(...)`.
 
+### `vercel-edge`
+
+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.
+- `vercel dev` / `vercel deploy` scripts.
+- A health route and bookstore route mirroring the Node starter.
+
 ## What the CLI guarantees
 
 - Zero runtime dependencies (uses only Node built-ins) for a clean supply-chain footprint.

package/bin/create-daloy.mjs

@@ -4,7 +4,7 @@
 
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
-import { mkdir, readdir, readFile, stat, writeFile, copyFile, rename } from "node:fs/promises";
+import { mkdir, readdir, readFile, writeFile, copyFile } from "node:fs/promises";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import path from "node:path";
@@ -14,7 +14,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = path.resolve(__dirname, "..");
 const TEMPLATES_DIR = path.join(PKG_ROOT, "templates");
 
-const TEMPLATES = ["node-basic", "cloudflare-worker"];
+const TEMPLATES = ["node-basic", "vercel-edge", "cloudflare-worker"];
 const PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "bun"];
 
 const RENAME_ON_COPY = new Map([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-daloy",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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/vercel-edge/README.md

@@ -0,0 +1,32 @@
+# my-daloy-vercel-api
+
+A [DaloyJS](https://daloyjs.dev) Vercel Edge API starter.
+
+## Develop
+
+```bash
+pnpm install
+pnpm dev          # http://localhost:3000
+```
+
+Try it:
+
+```bash
+curl http://localhost:3000/healthz
+curl http://localhost:3000/books/1
+```
+
+## Deploy
+
+```bash
+pnpm deploy
+```
+
+The API entry lives at `api/[...path].ts` and uses `@daloyjs/core/vercel`:
+
+```ts
+export const config = { runtime: "edge" };
+export default toEdgeHandler(app);
+```
+
+That catch-all API route lets DaloyJS own routing while Vercel handles the Edge runtime.

package/templates/vercel-edge/_env.example

@@ -0,0 +1 @@
+# Add Vercel project env vars here.

package/templates/vercel-edge/_gitignore

@@ -0,0 +1,9 @@
+node_modules/
+.vercel/
+dist/
+coverage/
+.DS_Store
+*.log
+.env
+.env.*
+!.env.example

package/templates/vercel-edge/_npmrc

@@ -0,0 +1,4 @@
+auto-install-peers=true
+strict-peer-dependencies=true
+prefer-frozen-lockfile=true
+verify-store-integrity=true

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

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { App, NotFoundError, requestId, secureHeaders } from "@daloyjs/core";
+import { toEdgeHandler } from "@daloyjs/core/vercel";
+
+export const config = { runtime: "edge" };
+
+const app = new App({
+  bodyLimitBytes: 256 * 1024,
+  requestTimeoutMs: 5_000,
+  production: process.env.NODE_ENV === "production",
+});
+
+app.use(requestId());
+app.use(secureHeaders());
+
+app.route({
+  method: "GET",
+  path: "/healthz",
+  operationId: "healthz",
+  tags: ["Ops"],
+  responses: {
+    200: {
+      description: "Service is healthy",
+      body: z.object({ ok: z.literal(true), runtime: z.literal("vercel-edge") }),
+    },
+  },
+  handler: async () => ({
+    status: 200,
+    body: { ok: true, runtime: "vercel-edge" as const },
+  }),
+});
+
+const Book = z.object({ id: z.string(), title: z.string() });
+const books = new Map<string, z.infer<typeof Book>>([
+  ["1", { id: "1", title: "Noli Me Tangere" }],
+]);
+
+app.route({
+  method: "GET",
+  path: "/books/:id",
+  operationId: "getBookById",
+  tags: ["Books"],
+  request: { params: z.object({ id: z.string() }) },
+  responses: {
+    200: { description: "Found", body: Book },
+    404: { description: "Not found" },
+  },
+  handler: async ({ params }) => {
+    const book = books.get(params.id);
+    if (!book) throw new NotFoundError(`Book ${params.id} not found`);
+    return { status: 200, body: book };
+  },
+});
+
+export default toEdgeHandler(app);

package/templates/vercel-edge/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "my-daloy-vercel-api",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vercel dev",
+    "deploy": "vercel deploy",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test tests/**/*.test.ts"
+  },
+  "dependencies": {
+    "@daloyjs/core": "^0.1.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.7.0",
+    "tsx": "^4.22.0",
+    "typescript": "^6.0.3",
+    "vercel": "^48.0.0"
+  }
+}

package/templates/vercel-edge/tests/app.test.ts

@@ -0,0 +1,9 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import handler from "../api/[...path].js";
+
+test("Vercel Edge handler responds through DaloyJS", async () => {
+  const response = await handler(new Request("https://example.test/healthz"));
+  assert.equal(response.status, 200);
+  assert.equal((await response.json()).runtime, "vercel-edge");
+});

package/templates/vercel-edge/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "types": ["node"],
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "include": ["api/**/*.ts", "tests/**/*.ts"]
+}

package/templates/vercel-edge/vercel.json

@@ -0,0 +1,4 @@
+{
+  "version": 2,
+  "cleanUrls": true
+}