@celsoft/create-platform-app 0.10.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celsoft/create-platform-app",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Create an app deployed by @celsoft/platform: npm create @celsoft/platform-app",
   "license": "MIT",
   "repository": { "type": "git", "url": "git+https://github.com/celsoft-com/platform.git", "directory": "packages/create-platform-app" },

package/template/README.md

@@ -13,7 +13,8 @@ Deployed to Cloudflare Workers with a Neon database by [@celsoft/platform](https
 
 ## Your code
 
-1. **API:** `src/worker.ts`, where `defineApp` hands each request `db`, a Drizzle client typed with your tables.
-2. **Pages:** `public/`, served as static files.
-3. **Tables:** `src/schema.ts`; after changing it, run `npx @celsoft/platform db generate`, read the SQL it writes, and commit it. Each deploy applies new migrations.
-4. **Local:** `npx @celsoft/platform dev` runs the app against its own copy of the database, generating migrations as you go.
+1. **API:** `src/worker.ts`, where each `endpoint` is a typed function with Zod schemas for its input and output, given `db`, a Drizzle client typed with your tables.
+2. **Calling endpoints:** a bundled frontend imports `call` from `.platform/client.ts`, which the platform generates on install, and calls `call("listItems", {})`; never edit or commit `.platform/`.
+3. **Pages:** `public/`, served as static files.
+4. **Tables:** `src/schema.ts`; after changing it, run `npx @celsoft/platform db generate`, read the SQL it writes, and commit it. Each deploy applies new migrations.
+5. **Local:** `npx @celsoft/platform dev` runs the app against its own copy of the database, generating migrations as you go.

package/template/gitignore

@@ -1,5 +1,6 @@
 node_modules
 .env.secrets
+.platform/
 .platform-*
 .dev.vars
 .wrangler

package/template/package.json

@@ -2,9 +2,13 @@
   "name": "{{name}}",
   "private": true,
   "type": "module",
+  "scripts": {
+    "postinstall": "platform generate"
+  },
   "dependencies": {
     "@celsoft/platform": "^{{platformVersion}}",
-    "drizzle-orm": "^0"
+    "drizzle-orm": "^0",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^5.20261023.1",

package/template/src/worker.ts

@@ -1,18 +1,20 @@
-import { defineApp } from "@celsoft/platform";
+import { defineApp, endpoint } from "@celsoft/platform";
 import { desc } from "drizzle-orm";
+import { z } from "zod";
 import * as schema from "./schema";
 
 const { items } = schema;
 
-export default defineApp(
-  async (request, { db }) => {
-    const url = new URL(request.url);
+const Item = z.object({ id: z.uuid(), name: z.string(), createdAt: z.date(), updatedAt: z.date() });
 
-    if (url.pathname === "/api/items" && request.method === "GET") {
-      return Response.json(await db.select().from(items).orderBy(desc(items.createdAt)).limit(100));
-    }
-
-    return new Response("not found", { status: 404 });
+// Each endpoint is one typed function; its Zod schemas are its only types. Every /api/ path
+// needs a signed-in user except those under /api/public/.
+export default defineApp(undefined, {
+  schema,
+  endpoints: {
+    listItems: endpoint(
+      { method: "GET", path: "/api/public/items", description: "The newest 100 items", input: z.object({}), output: z.array(Item) },
+      async (_, { db }) => db.select().from(items).orderBy(desc(items.createdAt)).limit(100),
+    ),
   },
-  { schema },
-);
+});