@celsoft/create-platform-app 0.4.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celsoft/create-platform-app",
-  "version": "0.4.0",
+  "version": "0.5.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

@@ -5,13 +5,15 @@ Deployed to Cloudflare Workers with a Neon database by [@celsoft/platform](https
 ## First deploy
 
 1. **Repo:** create a GitHub repo for this directory and push it.
-2. **Tokens:** run `npx platform init`; it adds blank token entries to `.env.secrets` and stops.
+2. **Tokens:** run `npx @celsoft/platform init`; it adds blank token entries to `.env.secrets` and stops.
 3. **Fill:** create the tokens described in the platform's [SETUP.md](https://github.com/celsoft-com/platform/blob/main/SETUP.md) and paste them into `.env.secrets`.
-4. **Init:** run `npx platform init` again; it stores the tokens in GitHub and writes the deploy workflow.
-5. **Ship:** commit and push; main deploys to https://{{hostname}}, and every PR gets a preview.
+4. **Init:** run `npx @celsoft/platform init` again; it stores the tokens in GitHub and writes the deploy workflow.
+5. **Migrations:** run `npx @celsoft/platform db generate`; it writes the SQL for `src/schema.ts` to `drizzle/`.
+6. **Ship:** commit and push; main deploys to https://{{hostname}}, and every PR gets a preview.
 
 ## Your code
 
-1. **API:** `src/worker.ts`, where `defineApp` hands each request a ready `sql` client.
+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. **Schema:** add numbered SQL files to `migrations/`; each deploy applies the new ones.
+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.

package/template/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "dependencies": {
     "@celsoft/platform": "^{{platformVersion}}",
-    "postgres": "^3.4.9"
+    "drizzle-orm": "^0"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^5.20261023.1",

package/template/platform.jsonc

@@ -1,13 +1,11 @@
 {
   "$schema": "./node_modules/@celsoft/platform/schema.json",
-  "version": 1,
   "name": "{{name}}",
   "hostname": "{{hostname}}",
   "worker": "src/worker.ts",
   "frontend": "public",
   "compatibilityDate": "{{compatibilityDate}}",
   "database": {
-    "neonProject": "{{neonProject}}",
-    "migrate": "node scripts/migrate.js"
+    "neonProject": "{{neonProject}}"
   }
 }

package/template/src/schema.ts

@@ -0,0 +1,9 @@
+import { id, timestamps } from "@celsoft/platform/schema";
+import { pgTable, text } from "drizzle-orm/pg-core";
+
+// The app's tables. After changing them, run `npx @celsoft/platform db generate` and commit drizzle/.
+export const items = pgTable("items", {
+  id: id(),
+  name: text("name").notNull(),
+  ...timestamps(),
+});

package/template/src/worker.ts

@@ -1,11 +1,18 @@
 import { defineApp } from "@celsoft/platform";
+import { desc } from "drizzle-orm";
+import * as schema from "./schema";
 
-export default defineApp(async (request, { sql }) => {
-  const url = new URL(request.url);
+const { items } = schema;
 
-  if (url.pathname === "/api/items" && request.method === "GET") {
-    return Response.json(await sql`select id, name, created_at from items order by created_at desc limit 100`);
-  }
+export default defineApp(
+  async (request, { db }) => {
+    const url = new URL(request.url);
 
-  return new Response("not found", { status: 404 });
-});
+    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 });
+  },
+  { schema },
+);

package/template/migrations/001_init.sql

@@ -1,5 +0,0 @@
-create table items (
-  id bigint generated always as identity primary key,
-  name text not null,
-  created_at timestamptz not null default now()
-);

package/template/scripts/migrate.js

@@ -1,23 +0,0 @@
-import { readdir, readFile } from "node:fs/promises";
-import postgres from "postgres";
-
-const dir = new URL("../migrations/", import.meta.url);
-const sql = postgres(process.env.DATABASE_URL, { max: 1, onnotice: () => {} });
-
-try {
-  await sql`create table if not exists schema_migrations (name text primary key, applied_at timestamptz not null default now())`;
-  const applied = new Set((await sql`select name from schema_migrations`).map((row) => row.name));
-  const pending = (await readdir(dir)).filter((name) => name.endsWith(".sql") && !applied.has(name)).sort();
-
-  for (const name of pending) {
-    const text = await readFile(new URL(name, dir), "utf8");
-    await sql.begin(async (tx) => {
-      await tx.unsafe(text);
-      await tx`insert into schema_migrations (name) values (${name})`;
-    });
-    console.log(`applied ${name}`);
-  }
-  if (pending.length === 0) console.log("migrations up to date");
-} finally {
-  await sql.end();
-}