create-oke 0.10.0 → 0.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-oke",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Scaffold an okengine app — bunx create-oke@latest <name>",
   "license": "MIT",
   "repository": {

package/src/agents-md.ts

@@ -89,7 +89,7 @@ App \`:6530\` · Console \`:6533\` · MCP \`:6535\`.
 - ❌ Inventing a ninth “element” or a parallel handler stack beside Flows
 - ✅ New capability = new **driver** on an existing element, or a new Flow
 - ❌ Untyped HTTP handlers that skip \`on\` / \`flow\` / contracts
-- ✅ \`on(http.get("/…"), flow({ in, out, do }))\`
+- ✅ \`on(http.get("/…"), flow(name, { in, out, do }))\`
 
 ## Learn more
 

package/src/cli.test.ts

@@ -261,8 +261,8 @@ describe("interactive branches", () => {
       expect(code).toBe(0);
       expect(readFileSync(join(dir, ".oke", "mode"), "utf8").trim()).toBe("docker");
       const notes = readFileSync(join(dir, "src", "flows", "notes", "index.ts"), "utf8");
-      expect(notes).toContain('name: "notes.digest"');
-      expect(notes).toContain('name: "notes.attach"');
+      expect(notes).toContain('flow("notes.digest"');
+      expect(notes).toContain('flow("notes.attach"');
     } finally {
       rmSync(dir, { recursive: true, force: true });
     }
@@ -564,8 +564,10 @@ describe("scaffold structure", () => {
         const appTs = readFileSync(join(result.targetDir, "src/app.ts"), "utf8");
         expect(appTs).not.toMatch(/Object\.assign/);
         expect(appTs).not.toMatch(/env:\s*["']test["']/);
-        expect(appTs).toMatch(/stores:\s*\[/);
-        expect(appTs).toMatch(/oke\(\{[\s\S]*stores:/);
+        // stores/secrets/signals/channel.templates auto-register — the
+        // minimal `oke({ name: "notes" })` shape carries no explicit arrays.
+        expect(appTs).not.toMatch(/stores:\s*\[/);
+        expect(appTs).toMatch(/oke\(\{\s*name:\s*["']notes["']\s*\}\)/);
         const pkg = JSON.parse(readFileSync(join(result.targetDir, "package.json"), "utf8")) as {
           name: string;
           dependencies: { okengine: string };
@@ -610,8 +612,8 @@ describe("scaffold structure", () => {
         expect(result.files).toContain(path);
       }
       const notes = readFileSync(join(result.targetDir, "src/flows/notes/index.ts"), "utf8");
-      expect(notes).toContain('name: "notes.create"');
-      expect(notes).not.toContain('name: "notes.digest"');
+      expect(notes).toContain('flow("notes.create"');
+      expect(notes).not.toContain('flow("notes.digest"');
       const all = result.files
         .filter((f) => f.endsWith(".ts") || f.endsWith(".md"))
         .map((f) => readFileSync(join(result.targetDir, f), "utf8"))

package/templates/advanced/oke.config.ts

@@ -29,13 +29,12 @@ export default defineConfig({
         test: "memory",
         prod: "s3",
       },
-      // Opt in via create-oke customize or uncomment:
-      // index: {
-      //   local: "memory",
-      //   docker: "meilisearch",
-      //   test: "memory",
-      //   prod: "meilisearch",
-      // },
+      index: {
+        local: "memory",
+        docker: "meilisearch",
+        test: "memory",
+        prod: "meilisearch",
+      },
     },
     signal: {
       local: "memory",
@@ -49,7 +48,6 @@ export default defineConfig({
       test: "frozen",
       prod: "postgres",
     },
-    // Durable-flow journal (durable: true runs) — shared + leased in docker/prod.
     journal: {
       local: "memory",
       docker: "postgres",

package/templates/advanced/src/app.ts

@@ -1,18 +1,15 @@
-import { db, files, noteCreatedMail, webhookSecret } from "./core";
+import "./core";
 import "./locales/en";
 import "./locales/ar";
 
 import { oke } from "okengine";
-import * as main from "./flows/main";
-import * as notes from "./flows/notes";
-import { noteCreated } from "./flows/notes/signals";
+import * as routes from "./flows/generated";
 
-export const app = oke({
-  name: "notes",
-  stores: [db, files],
-  secrets: [webhookSecret],
-  signals: [noteCreated],
-  channel: { templates: [noteCreatedMail] },
-}).adopt({ main, notes });
+// stores (store.sql/store.files) · secrets (vault.secret) · signals (signal())
+// · channel templates (channel.<medium>().template()) auto-register from
+// `./core` (and `./flows/notes/signals`) — no explicit arrays needed.
+// `./flows/generated` is a real file, regenerated by `oke dev` / `oke build`
+// from every `src/flows/<unit>/index.ts` folder — never edit it by hand.
+export const app = oke({ name: "notes" }).adopt(routes);
 
 export type App = typeof app;

package/templates/advanced/src/flows/generated.ts

@@ -0,0 +1,4 @@
+// AUTO-GENERATED by `oke dev` / `oke build` — do not edit by hand.
+// Regenerated from every `src/flows/<unit>/index.ts` unit folder.
+export * as main from "./main/index.ts";
+export * as notes from "./notes/index.ts";

package/templates/advanced/src/flows/main/index.ts

@@ -4,9 +4,7 @@ import { z } from "zod";
 /** First-run welcome — visit :6530/ after `oke dev`. */
 export const root = on(
   http.get("/").gate(gate.public),
-  flow({
-    name: "main.root",
-    unit: "main",
+  flow("main.root", {
     out: z.object({
       ok: z.literal(true),
       app: z.string(),
@@ -25,9 +23,7 @@ export const root = on(
 /** Liveness for probes and `bun test`. */
 export const health = on(
   http.get("/health").gate(gate.public),
-  flow({
-    name: "main.health",
-    unit: "main",
+  flow("main.health", {
     out: z.object({ ok: z.literal(true) }),
     do: () => ({ ok: true as const }),
   }),

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

@@ -23,9 +23,7 @@ import "./signals";
 /** List active (non-archived) notes, newest first. */
 export const list = on(
   http.get("/notes").gate(gate.public),
-  flow({
-    name: "notes.list",
-    unit: "notes",
+  flow("notes.list", {
     out: NoteListOut,
     effects: { reads: ["sql:app"] },
     do: async (_input, fx) => {
@@ -47,9 +45,7 @@ export const list = on(
 /** Create a note, emit `note-created`, touch vault. */
 export const create = on(
   http.post("/notes").gate(gate.public),
-  flow({
-    name: "notes.create",
-    unit: "notes",
+  flow("notes.create", {
     in: NoteCreateIn,
     out: NoteOut,
     effects: {
@@ -84,9 +80,7 @@ export const create = on(
 /** Fetch one note by id. */
 export const get = on(
   http.get("/notes/:id").gate(gate.public),
-  flow({
-    name: "notes.get",
-    unit: "notes",
+  flow("notes.get", {
     in: NoteIdIn,
     out: NoteOut,
     errors: { NotFound },
@@ -108,9 +102,7 @@ export const get = on(
 /** Soft-archive a note. */
 export const archive = on(
   http.post("/notes/:id/archive").gate(gate.public),
-  flow({
-    name: "notes.archive",
-    unit: "notes",
+  flow("notes.archive", {
     in: NoteIdIn,
     out: NoteOut,
     errors: { NotFound },
@@ -138,9 +130,7 @@ export const archive = on(
 /** On create → send the note-created email template. */
 export const onCreated = on(
   noteCreated,
-  flow({
-    name: "notes.onCreated",
-    unit: "notes",
+  flow("notes.onCreated", {
     effects: { sends: ["note-created"] },
     do: async (payload, fx) => {
       await fx.send(noteCreatedMail, {
@@ -154,9 +144,7 @@ export const onCreated = on(
 /** Store a text attachment next to a note (`files:uploads`). */
 export const attach = on(
   http.post("/notes/:id/attach").gate(gate.public),
-  flow({
-    name: "notes.attach",
-    unit: "notes",
+  flow("notes.attach", {
     in: NoteAttachIn,
     out: NoteAttachOut,
     errors: { NotFound },
@@ -174,9 +162,7 @@ export const attach = on(
 /** Daily count of active notes (frozen under test drivers). */
 export const digest = on(
   every("1d"),
-  flow({
-    name: "notes.digest",
-    unit: "notes",
+  flow("notes.digest", {
     out: NoteDigestOut,
     effects: { reads: ["sql:app"] },
     do: async (_input, fx) => {
@@ -192,9 +178,7 @@ export const digest = on(
  */
 export const summarize = on(
   http.post("/notes/:id/summarize").gate(gate.public),
-  flow({
-    name: "notes.summarize",
-    unit: "notes",
+  flow("notes.summarize", {
     in: NoteSummarizeIn,
     out: NoteSummarizeOut,
     errors: { NotFound },

package/templates/standard/oke.config.ts

@@ -42,7 +42,6 @@ export default defineConfig({
       test: "frozen",
       prod: "postgres",
     },
-    // Durable-flow journal (durable: true runs) — shared + leased in docker/prod.
     journal: {
       local: "memory",
       docker: "postgres",

package/templates/standard/src/app.ts

@@ -1,18 +1,15 @@
-import { db, noteCreatedMail, webhookSecret } from "./core";
+import "./core";
 import "./locales/en";
 import "./locales/ar";
 
 import { oke } from "okengine";
-import * as main from "./flows/main";
-import * as notes from "./flows/notes";
-import { noteCreated } from "./flows/notes/signals";
+import * as routes from "./flows/generated";
 
-export const app = oke({
-  name: "notes",
-  stores: [db],
-  secrets: [webhookSecret],
-  signals: [noteCreated],
-  channel: { templates: [noteCreatedMail] },
-}).adopt({ main, notes });
+// stores (store.sql) · secrets (vault.secret) · signals (signal()) · channel
+// templates (channel.<medium>().template()) auto-register from `./core`
+// (and `./flows/notes/signals`) — no explicit arrays needed.
+// `./flows/generated` is a real file, regenerated by `oke dev` / `oke build`
+// from every `src/flows/<unit>/index.ts` folder — never edit it by hand.
+export const app = oke({ name: "notes" }).adopt(routes);
 
 export type App = typeof app;

package/templates/standard/src/flows/generated.ts

@@ -0,0 +1,4 @@
+// AUTO-GENERATED by `oke dev` / `oke build` — do not edit by hand.
+// Regenerated from every `src/flows/<unit>/index.ts` unit folder.
+export * as main from "./main/index.ts";
+export * as notes from "./notes/index.ts";

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

@@ -4,9 +4,7 @@ import { z } from "zod";
 /** First-run welcome — visit :6530/ after `oke dev`. */
 export const root = on(
   http.get("/").gate(gate.public),
-  flow({
-    name: "main.root",
-    unit: "main",
+  flow("main.root", {
     out: z.object({
       ok: z.literal(true),
       app: z.string(),
@@ -25,9 +23,7 @@ export const root = on(
 /** Liveness for probes and `bun test`. */
 export const health = on(
   http.get("/health").gate(gate.public),
-  flow({
-    name: "main.health",
-    unit: "main",
+  flow("main.health", {
     out: z.object({ ok: z.literal(true) }),
     do: () => ({ ok: true as const }),
   }),

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

@@ -12,9 +12,7 @@ import "./signals";
 /** List active (non-archived) notes, newest first. */
 export const list = on(
   http.get("/notes").gate(gate.public),
-  flow({
-    name: "notes.list",
-    unit: "notes",
+  flow("notes.list", {
     out: NoteListOut,
     effects: { reads: ["sql:app"] },
     do: async (_input, fx) => {
@@ -36,9 +34,7 @@ export const list = on(
 /** Create a note, emit `note-created`, touch vault. */
 export const create = on(
   http.post("/notes").gate(gate.public),
-  flow({
-    name: "notes.create",
-    unit: "notes",
+  flow("notes.create", {
     in: NoteCreateIn,
     out: NoteOut,
     effects: {
@@ -73,9 +69,7 @@ export const create = on(
 /** Fetch one note by id. */
 export const get = on(
   http.get("/notes/:id").gate(gate.public),
-  flow({
-    name: "notes.get",
-    unit: "notes",
+  flow("notes.get", {
     in: NoteIdIn,
     out: NoteOut,
     errors: { NotFound },
@@ -97,9 +91,7 @@ export const get = on(
 /** Soft-archive a note. */
 export const archive = on(
   http.post("/notes/:id/archive").gate(gate.public),
-  flow({
-    name: "notes.archive",
-    unit: "notes",
+  flow("notes.archive", {
     in: NoteIdIn,
     out: NoteOut,
     errors: { NotFound },
@@ -127,9 +119,7 @@ export const archive = on(
 /** On create → send the note-created email template. */
 export const onCreated = on(
   noteCreated,
-  flow({
-    name: "notes.onCreated",
-    unit: "notes",
+  flow("notes.onCreated", {
     effects: { sends: ["note-created"] },
     do: async (payload, fx) => {
       await fx.send(noteCreatedMail, {