create-oke 0.9.1 → 0.10.0

package/templates/standard/README.md

@@ -1,17 +1,17 @@
 # Notes (standard)
 
 Local-first [okengine](https://oke.omqkhafi.dev) starter: a small **Notes** API with
-named Flows, Store, Signal → email, and Vault.
+named Flows, Store, Signal → email, and Vault. This is a scaffold, not a finished
+product — every Flow and table here is real wiring you keep or replace.
 
 ```bash
 bun install
-oke dev
-oke db seed   # essential welcome note + local/docker sample notes
+oke dev           # auto db push; asks once whether to seed
 ```
 
 | Surface | URL |
 | ------- | --- |
-| App | http://127.0.0.1:6530 |
+| Backend | http://127.0.0.1:6530 |
 | Console | http://127.0.0.1:6533 |
 | MCP | http://127.0.0.1:6535 |
 
@@ -28,21 +28,32 @@ curl -s http://127.0.0.1:6530/notes
 Flow names in the `oke dev` log are stable (`main.health`, `notes.create`, …) —
 never anonymous `flow_1`.
 
+## Included vs you build
+
+| Ships ready | You still own |
+| ----------- | ------------- |
+| `main.health` + notes CRUD Flows | your domain Flows and routes |
+| `notes` table + `oke db seed` | schema growth and seed policy |
+| `note-created` Signal → email template | delivery rules, more channels |
+| `APP_WEBHOOK_SECRET` Vault contract | more secrets / `vault.config` as needed |
+| `.github/workflows/ci.yml` (typecheck + test) | lint, docker, deploy when you need them |
+
 ## Layout
 
 | Path | Role |
 | ---- | ---- |
-| `src/schema.decl.ts` | `notes` table |
-| `src/seed/` | `oke db seed` — essential + dev sample notes |
+| `src/core/` | stores · gates · vault · channels (barrel `index.ts`) |
+| `src/db/schema.decl.ts` | `notes` table |
+| `src/db/seed/` | `oke db seed` — essential + dev sample notes |
+| `src/db/migrations/` | versioned drizzle migrations |
 | `src/flows/notes/` | list · create · get · archive · onCreated |
 | `src/flows/main/` | root · health |
-| `src/channels.ts` | `note-created` email template |
-| `src/vault.ts` | `APP_WEBHOOK_SECRET` |
 | `oke.config.ts` | local sqlite · docker postgres (+ redis/s3/openbao/smtp) |
+| `.github/workflows/ci.yml` | `bun run typecheck` + `bun test` on push/PR |
 
 Switch mode anytime: `oke mode docker` then `oke dev` (or `oke dev --docker`).
 
 ## AI
 
 Not baked into this starter. Re-run create-oke with `--ai`, or `oke ai setup`, to
-add `drivers.ai` + `src/ai.ts`.
+add `drivers.ai` + `src/core/ai.ts`.

package/templates/standard/drizzle.config.ts

@@ -5,17 +5,19 @@ import { defineConfig } from "drizzle-kit";
  *
  * Dialect comes from OKE's `store.sql` driver map (resolved by the CLI and
  * injected as `OKE_DRIZZLE_DIALECT`) — never inferred from `DATABASE_URL`
- * presence. `src/schema.generated.ts` is emitted from `src/schema.decl.ts`
+ * presence. `src/db/schema.generated.ts` is emitted from `src/db/schema.decl.ts`
  * for the active dialect as a pre-step of `oke db` / `oke dev`.
  *
- * Versioned prod migrations land in `./drizzle` — never mix with `.oke/`.
+ * Versioned prod migrations land in `./src/db/migrations` — never mix with `.oke/`.
  */
 const dialect = (process.env.OKE_DRIZZLE_DIALECT ?? "sqlite") as "sqlite" | "postgresql";
 
 export default defineConfig({
   dialect,
-  schema: "./src/schema.generated.ts",
-  out: "./drizzle",
+  schema: "./src/db/schema.generated.ts",
+  out: "./src/db/migrations",
+  // Core runtime tables (oke_crons, …) are created by drivers — not domain schema.
+  tablesFilter: ["!oke_*"],
   dbCredentials: {
     url:
       dialect === "postgresql"

package/templates/standard/oke.config.ts

@@ -5,6 +5,10 @@ import { defineConfig } from "okengine/config";
  * Docker/prod pins stay ready when you switch `oke mode docker`.
  */
 export default defineConfig({
+  db: {
+    declare: "src/db/schema.decl.ts",
+    generated: "src/db/schema.generated.ts",
+  },
   drivers: {
     store: {
       sql: {

package/templates/standard/package.json

@@ -5,13 +5,16 @@
   "type": "module",
   "dependencies": {
     "okengine": "file:../../../..",
-    "drizzle-orm": "^1.0.0-rc.4",
+    "drizzle-orm": "1.0.0-rc.4",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "drizzle-kit": "^1.0.0-rc.4"
+    "@types/bun": "latest",
+    "drizzle-kit": "1.0.0-rc.4",
+    "typescript": "^7.0.2"
   },
   "scripts": {
+    "typecheck": "tsc --noEmit",
     "test": "bun test",
     "dev": "oke dev"
   }

package/templates/standard/src/app.ts

@@ -1,7 +1,4 @@
-import { db } from "./core";
-import "./gates";
-import "./vault";
-import "./channels";
+import { db, noteCreatedMail, webhookSecret } from "./core";
 import "./locales/en";
 import "./locales/ar";
 
@@ -9,22 +6,13 @@ import { oke } from "okengine";
 import * as main from "./flows/main";
 import * as notes from "./flows/notes";
 import { noteCreated } from "./flows/notes/signals";
-import { noteCreatedMail } from "./channels";
-import { webhookSecret } from "./vault";
 
 export const app = oke({
   name: "notes",
+  stores: [db],
   secrets: [webhookSecret],
   signals: [noteCreated],
   channel: { templates: [noteCreatedMail] },
 }).adopt({ main, notes });
 
 export type App = typeof app;
-
-Object.assign(app.$options, {
-  env: "test",
-  stores: [db],
-  secrets: [webhookSecret],
-  signals: [noteCreated],
-  channel: { templates: [noteCreatedMail] },
-});

package/templates/standard/src/core/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Core wiring — stores, gates, vault, channels (and AI when configured).
+ */
+
+export { db } from "./store";
+export { notesWrite } from "./gates";
+export { webhookSecret } from "./vault";
+export { noteCreatedMail } from "./channels";
+
+import "./gates";
+import "./vault";
+import "./channels";

package/templates/standard/src/{core.ts → core/store.ts}

@@ -1,5 +1,5 @@
 import { store } from "okengine";
-import * as schema from "./schema.decl";
+import * as schema from "../db/schema.decl";
 
 /** App SQL store — tables from {@link schema}. */
 export const db = store.sql("app", { schema });

package/templates/{advanced/src → standard/src/db}/schema.decl.ts

@@ -2,7 +2,7 @@ import { store, field, id, now } from "okengine";
 
 /**
  * Notes domain — abstract declarations, emitted to
- * `src/schema.generated.ts` for the active dialect by `oke db` / `oke dev`.
+ * `src/db/schema.generated.ts` for the active dialect by `oke db` / `oke dev`.
  */
 export const notes = store.schema.table("notes", {
   id: field.text().primaryKey().defaultFn(id),

package/templates/standard/src/{seed → db/seed}/index.ts

@@ -1,12 +1,12 @@
 import { defineSeed, type Fx } from "okengine";
-import { db } from "../core";
+import { db } from "../../core";
 import { notes } from "../schema.decl";
 
 /**
  * Seed data — run explicitly with `oke db seed` (never at boot).
  *
  * Categories: `essential` (every env) · `dev` (local|docker) · `prod` (prod only).
- * For multi-file composition (`src/seed/essential/*.ts` + arrays here), see
+ * For multi-file composition (`src/db/seed/essential/*.ts` + arrays here), see
  * Store docs → Seeding.
  */
 

package/templates/standard/src/flows/notes/index.ts

@@ -1,10 +1,8 @@
 import { on, flow, http, gate, fail } from "okengine";
 import { eq, isNull } from "drizzle-orm";
 
-import { db } from "../../core";
-import { notes } from "../../schema.decl";
-import { webhookSecret } from "../../vault";
-import { noteCreatedMail } from "../../channels";
+import { db, noteCreatedMail, webhookSecret } from "../../core";
+import { notes } from "../../db/schema.decl";
 import { NoteCreateIn, NoteIdIn, NoteListOut, NoteOut, NotFound } from "./shapes";
 import { noteCreated } from "./signals";
 

package/templates/standard/tests/standard.test.ts

@@ -13,33 +13,36 @@ afterAll(async () => {
 });
 
 test("boots — health flow is named main.health", async () => {
-  const { data, error } = await t.api.main.health({});
+  const { data, error } = await t.api.main!.health!({});
   expect(error).toBeNull();
   expect(data).toEqual({ ok: true });
 });
 
 test("notes create → list → archive", async () => {
-  const created = await t.api.notes.create({
+  const created = await t.api.notes!.create!({
     title: "Hello",
     body: "World from the standard starter",
   });
   expect(created.error).toBeNull();
-  expect(created.data?.title).toBe("Hello");
-  expect(created.data?.id).toBeTruthy();
+  const row = created.data as { id: string; title: string };
+  expect(row.title).toBe("Hello");
+  expect(row.id).toBeTruthy();
 
   await t.signals.drain();
   expect(t.channels.sent().some((s) => s.template === "note-created")).toBe(true);
 
-  const listed = await t.api.notes.list({});
+  const listed = await t.api.notes!.list!({});
   expect(listed.error).toBeNull();
-  expect(listed.data?.notes.some((n) => n.id === created.data!.id)).toBe(true);
+  const notes = (listed.data as { notes: { id: string }[] }).notes;
+  expect(notes.some((n) => n.id === row.id)).toBe(true);
 
-  const archived = await t.api.notes.archive({ id: created.data!.id });
+  const archived = await t.api.notes!.archive!({ id: row.id });
   expect(archived.error).toBeNull();
-  expect(archived.data?.archivedAt).toBeTypeOf("number");
+  expect((archived.data as { archivedAt: number }).archivedAt).toBeTypeOf("number");
 
-  const after = await t.api.notes.list({});
-  expect(after.data?.notes.some((n) => n.id === created.data!.id)).toBe(false);
+  const after = await t.api.notes!.list!({});
+  const afterNotes = (after.data as { notes: { id: string }[] }).notes;
+  expect(afterNotes.some((n) => n.id === row.id)).toBe(false);
 });
 
 /** Flag-free `app.fetch` must auto-boot. */

package/templates/standard/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleDetection": "force",
+    "types": ["bun"],
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "rewriteRelativeImportExtensions": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true
+  },
+  "include": ["src/**/*.ts", "tests/**/*.ts", "oke.config.ts", "drizzle.config.ts"]
+}