create-oke 0.2.8 → 0.3.2

package/template/drizzle.config.ts

@@ -0,0 +1,25 @@
+import { defineConfig } from "drizzle-kit";
+
+/**
+ * Domain schema sync for `oke db push|generate|migrate`.
+ *
+ * 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`
+ * for the active dialect as a pre-step of `oke db` / `oke dev`.
+ *
+ * Versioned prod migrations land in `./drizzle` — 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",
+  dbCredentials: {
+    url:
+      dialect === "postgresql"
+        ? (process.env.DATABASE_URL ?? process.env.OKE_STORE_SQL_URL!)
+        : (process.env.OKE_SQLITE_URL ?? "file:.oke/app.sqlite"),
+  },
+});

package/{templates/full → template}/oke.config.ts

@@ -15,6 +15,12 @@ export default defineConfig({
         test: "memory",
         prod: "redis",
       },
+      files: {
+        local: "fs",
+        docker: "s3",
+        test: "memory",
+        prod: "s3",
+      },
     },
     signal: {
       local: "memory",
@@ -30,9 +36,9 @@ export default defineConfig({
     },
     vault: {
       local: "dotenv",
-      docker: "dotenv",
+      docker: "openbao",
       test: "memory",
-      prod: "sops",
+      prod: "openbao",
     },
     channel: {
       email: {
@@ -42,15 +48,13 @@ export default defineConfig({
         prod: "smtp",
       },
     },
-    ai: {
-      local: "mock",
-      docker: "mock",
-      test: "mock",
-    },
   },
   images: {
     "store.sql": "postgres:18-alpine",
     "store.kv": "redis:8-alpine",
+    "store.files": "rustfs/rustfs:1.0.0-beta.11",
+    "channel.email": "axllent/mailpit:v1.22.3",
+    vault: "openbao/openbao:2.6.1",
   },
   i18n: { locales: ["en", "ar"], default: "en", dir: { ar: "rtl" } },
 });

package/{templates/minimal → template}/src/core.ts

@@ -1,4 +1,4 @@
 import { store } from "okengine";
-import * as schema from "./schema";
+import * as schema from "./schema.decl";
 
 export const db = store.sql("app", { schema });

package/template/src/schema.decl.ts

@@ -0,0 +1,12 @@
+import { store, field, id, now } from "okengine";
+
+/**
+ * Domain schema — abstract declarations, emitted to
+ * `src/schema.generated.ts` for the active dialect (sqlite in local mode,
+ * postgres in docker) by `oke db` / `oke dev`.
+ */
+export const entries = store.schema.table("entries", {
+  id: field.text().primaryKey().defaultFn(id),
+  body: field.text().notNull(),
+  createdAt: field.integer().notNull().defaultFn(now),
+});

package/examples/linkly/.env.example

@@ -1,15 +0,0 @@
-# Environment template — copy to `.env.local` for local overrides.
-# create-oke copies this file to `.env.local` when you scaffold a new project.
-#
-# Resolution order (first hit wins):
-#   process.env → .env.local → docker/.env.docker → vault driver → dev fallback
-#
-# --- Infrastructure (optional) ---
-# This app pins postgres (store.sql) and redis (store.kv) for prod in oke.config.ts.
-# Local dev uses sqlite + in-memory kv; uncomment only for prod overrides.
-
-# DATABASE_URL — primary Postgres connection; from your host (Neon, RDS, …)
-# DATABASE_URL=postgres://user:password@host:5432/linkly
-
-# REDIS_URL — Redis/Valkey connection for store.kv; from your host (Upstash, ElastiCache, …)
-# REDIS_URL=redis://:password@host:6379

package/examples/linkly/drizzle.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "drizzle-kit";
-
-/** Domain schema sync for `oke db push|generate|migrate`. */
-export default defineConfig({
-  dialect: "sqlite",
-  schema: "./src/schema.generated.ts",
-  out: "./drizzle",
-  dbCredentials: {
-    url: process.env.OKE_SQLITE_URL ?? "file:.oke/app.sqlite",
-  },
-});

package/examples/linkly/oke.config.ts

@@ -1,12 +0,0 @@
-import { defineConfig } from "okengine/config";
-
-export default defineConfig({
-  drivers: {
-    store: {
-      sql: { local: "sqlite", test: "memory", prod: "postgres" },
-      kv: { local: "memory", test: "memory", prod: "redis" },
-    },
-    signal: { local: "memory", test: "memory", prod: "postgres" },
-    clock: { local: "memory", test: "frozen", prod: "postgres" },
-  },
-});

package/examples/linkly/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "@oke/example-linkly",
-  "version": "0.0.1",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "bun test",
-    "dev": "oke dev"
-  },
-  "dependencies": {
-    "drizzle-orm": "^1.0.0-rc.4",
-    "okengine": "file:../..",
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "drizzle-kit": "^1.0.0-rc.4"
-  }
-}

package/examples/linkly/src/app.ts

@@ -1,21 +0,0 @@
-import { db } from "./core";
-import { member, fair } from "./gates";
-import { linkClicked, linkStats } from "./flows/links/signals";
-
-import { oke } from "okengine";
-import * as links from "./flows/links";
-import * as analytics from "./flows/analytics";
-
-export const app = oke({ name: "linkly" }).adopt({ links, analytics });
-
-export type App = typeof app;
-
-// Spec test calls `t.api.links.report` though `report` lives in analytics.
-app.adopt({ links: { report: analytics.report } });
-
-Object.assign(app.$options, {
-  env: "test",
-  gates: [member, fair],
-  signals: [linkClicked, linkStats],
-  stores: [db],
-});

package/examples/linkly/src/core.ts

@@ -1,4 +0,0 @@
-import { store } from "okengine";
-import * as schema from "./schema";
-
-export const db = store.sql("linkly", { schema });

package/examples/linkly/src/flows/analytics/index.ts

@@ -1,39 +0,0 @@
-import { on, flow, http } from "okengine";
-import { z } from "zod";
-import { eq, and } from "drizzle-orm";
-import { linkClicked } from "../links/signals";
-import { db } from "../../core";
-import { member } from "../../gates";
-import { daily } from "../../schema";
-
-on(
-  linkClicked,
-  flow({
-    // a second consumer of the same signal
-    do: async ({ code, at }, fx) => {
-      const day = new Date(at).toISOString().slice(0, 10);
-      const [row] = await fx
-        .store(db)
-        .select()
-        .from(daily)
-        .where(and(eq(daily.code, code), eq(daily.day, day)))
-        .limit(1);
-
-      if (row) await fx.store(db).increment(daily, row.id, "clicks");
-      else await fx.store(db).insert(daily).values({ id: fx.id(), code, day, clicks: 1 });
-    },
-  }),
-);
-
-export const report = on(
-  http.get("/links/:code/report").gate(member),
-  flow({
-    out: z.array(z.object({ day: z.string(), clicks: z.number() })),
-    do: ({ code }, fx) =>
-      fx
-        .store(db)
-        .select({ day: daily.day, clicks: daily.clicks })
-        .from(daily)
-        .where(eq(daily.code, code)),
-  }),
-);

package/examples/linkly/src/flows/links/index.ts

@@ -1,82 +0,0 @@
-import { z } from "zod";
-import { on, flow, http, every } from "okengine";
-import { eq, lt } from "drizzle-orm";
-import { db } from "../../core";
-import { member, fair } from "../../gates";
-import { linkClicked, linkStats } from "./signals";
-import { NewLink, LinkCode, Link, NotFound, Taken } from "./shapes";
-import { links } from "../../schema";
-
-// ① HTTP — "an endpoint"
-export const shorten = on(
-  http.post("/links").gate(member, fair),
-  flow({
-    in: NewLink,
-    out: LinkCode,
-    errors: { Taken },
-    do: async ({ url, code }, fx) => {
-      if (await fx.store(db).exists(links, { code })) return fx.fail("Taken", {});
-      const id = fx.id();
-      await fx
-        .store(db)
-        .insert(links)
-        .values({ id, code, url, userId: fx.auth.userId, clicks: 0, createdAt: Date.now() });
-      return { code };
-    },
-  }),
-);
-
-// ② HTTP — the hot path
-export const redirect = on(
-  http.get("/:code").gate(fair),
-  flow({
-    in: LinkCode,
-    out: Link,
-    errors: { NotFound },
-    do: async ({ code }, fx) => {
-      const [link] = await fx.store(db).select().from(links).where(eq(links.code, code)).limit(1);
-      if (!link) return fx.fail("NotFound", {});
-
-      await fx.emit(linkClicked, { code, at: Date.now() }); // same transaction as any write
-      return link;
-    },
-  }),
-);
-
-// ③ SIGNAL — "a queue consumer", and the same species as ① and ②
-on(
-  linkClicked,
-  flow({
-    do: async ({ code }, fx) => {
-      const [link] = await fx.store(db).select().from(links).where(eq(links.code, code)).limit(1);
-      const clicks = await fx.store(db).increment(links, link.id, "clicks");
-      await fx.emit(linkStats, { code, clicks }); // live: pushed to subscribers
-    },
-  }),
-);
-
-// ④ CLOCK — "a cron job", and still the same species
-on(
-  every("1h"),
-  flow({
-    do: (_, fx) => {
-      const cutoff = Date.now() - 30 * 24 * 60 * 60 * 1000; // 30 days
-      return fx.store(db).delete(links).where(lt(links.createdAt, cutoff));
-    },
-  }),
-);
-
-// ⑤ A plain flow with no trigger — callable, not "private"
-export const stats = flow({
-  in: LinkCode,
-  out: z.object({ clicks: z.number() }),
-  do: async ({ code }, fx) => {
-    const [link] = await fx
-      .store(db)
-      .select({ clicks: links.clicks })
-      .from(links)
-      .where(eq(links.code, code))
-      .limit(1);
-    return link ?? { clicks: 0 };
-  },
-});

package/examples/linkly/src/flows/links/shapes.ts

@@ -1,22 +0,0 @@
-import { z } from "zod";
-
-export const NewLink = z.object({
-  url: z.string().url(),
-  code: z.string().min(1).max(32),
-});
-
-export const LinkCode = z.object({
-  code: z.string(),
-});
-
-export const Link = z.object({
-  id: z.string(),
-  code: z.string(),
-  url: z.string(),
-  userId: z.string(),
-  clicks: z.number(),
-  createdAt: z.number(),
-});
-
-export const Taken = z.object({});
-export const NotFound = z.object({});

package/examples/linkly/src/flows/links/signals.ts

@@ -1,14 +0,0 @@
-import { signal } from "okengine";
-import { z } from "zod";
-
-export const linkClicked = signal("link-clicked", {
-  schema: z.object({ code: z.string(), at: z.number(), referrer: z.string().optional() }),
-  delivery: "once", // queue physics: one consumer, retries, DLQ
-  retries: 3,
-  deadLetter: true,
-});
-
-export const linkStats = signal("link-stats", {
-  schema: z.object({ code: z.string(), clicks: z.number() }),
-  delivery: "live", // stream physics: clients subscribe
-});

package/examples/linkly/src/gates.ts

@@ -1,10 +0,0 @@
-import { gate } from "okengine";
-
-export const member = gate.policy("member", ({ auth }) => !!auth?.verified);
-
-export const fair = gate.rate({
-  strategy: "sliding-window-counter", // near-exact, two keys, no boundary bursts
-  max: 60,
-  per: "1m",
-  keyBy: "ip",
-});

package/examples/linkly/src/schema.decl.ts

@@ -1,39 +0,0 @@
-import { store, field } from "okengine";
-
-/** Short links — `code` is the human-facing unique key. */
-export const links = store.schema.table("links", {
-  id: field.text().primaryKey(), // `increment` targets this column
-  code: field.text().notNull().unique(), // the short, human-facing key
-  url: field.text().notNull(),
-  userId: field.text().notNull(),
-  clicks: field.integer().notNull().default(0),
-  createdAt: field.integer().notNull(),
-});
-
-/** Per-link daily click counts — FK to `links.code`. */
-export const daily = store.schema.table("daily", {
-  id: field.text().primaryKey(),
-  code: field
-    .text()
-    .notNull()
-    .references(() => links.code),
-  day: field.text().notNull(), // "YYYY-MM-DD"
-  clicks: field.integer().notNull().default(0),
-});
-
-/** links ↔ daily — one link has many daily rows. */
-export const relations = store.schema.relations({ links, daily }, (r) => ({
-  links: {
-    daily: r.many.daily({
-      from: r.links.code,
-      to: r.daily.code,
-    }),
-  },
-  daily: {
-    link: r.one.links({
-      from: r.daily.code,
-      to: r.links.code,
-      optional: false,
-    }),
-  },
-}));

package/examples/linkly/src/schema.generated.ts

@@ -1,30 +0,0 @@
-// generated by oke — do not edit
-import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
-import { defineRelations } from "drizzle-orm";
-
-export const links = sqliteTable("links", {
-  id: text("id").primaryKey(),
-  code: text("code").notNull().unique(),
-  url: text("url").notNull(),
-  userId: text("user_id").notNull(),
-  clicks: integer("clicks").notNull().default(0),
-  createdAt: integer("created_at").notNull(),
-});
-
-export const daily = sqliteTable("daily", {
-  id: text("id").primaryKey(),
-  code: text("code")
-    .notNull()
-    .references(() => links.code),
-  day: text("day").notNull(),
-  clicks: integer("clicks").notNull().default(0),
-});
-
-export const relations = defineRelations({ links, daily }, (r) => ({
-  links: {
-    daily: r.many.daily({ from: r.links.code, to: r.daily.code }),
-  },
-  daily: {
-    link: r.one.links({ from: r.daily.code, to: r.links.code, optional: false }),
-  },
-}));

package/examples/linkly/src/schema.ts

@@ -1,2 +0,0 @@
-/** Stable import surface — re-exports generated Drizzle from abstract decls. */
-export { links, daily, relations } from "./schema.generated";

package/examples/linkly/tests/linkly.test.ts

@@ -1,19 +0,0 @@
-import { test, expect } from "bun:test";
-import { createTestApp } from "okengine/test";
-import { app } from "../src/app";
-
-test("shorten → redirect → report · time travel", async () => {
-  const t = await createTestApp(app); // memory drivers, frozen clock
-  const u = await t.auth.loginAs({});
-
-  await t.api.links.shorten({ url: "https://example.com", code: "sa" }, { as: u });
-  await t.api.links.redirect({ code: "sa" });
-  await t.signals.drain(); // run queued work deterministically
-
-  const { data } = await t.api.links.report({ code: "sa" }, { as: u });
-  expect(data![0].clicks).toBe(1);
-
-  await t.clock.advance("31d");
-  await t.cron.run("1h"); // time travel
-  await t.close();
-});

package/examples/notes/.env.example

@@ -1,12 +0,0 @@
-# Environment template — copy to `.env.local` for local overrides.
-# create-oke copies this file to `.env.local` when you scaffold a new project.
-#
-# Resolution order (first hit wins):
-#   process.env → .env.local → docker/.env.docker → vault driver → dev fallback
-#
-# --- Infrastructure (optional) ---
-# This app pins postgres for prod SQL in oke.config.ts (local dev uses sqlite).
-# Uncomment only when overriding the prod connection URL.
-
-# DATABASE_URL — primary Postgres connection; from your host (Neon, RDS, …)
-# DATABASE_URL=postgres://user:password@host:5432/notes

package/examples/notes/drizzle.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "drizzle-kit";
-
-/** Domain schema sync for `oke db push|generate|migrate`. */
-export default defineConfig({
-  dialect: "sqlite",
-  schema: "./src/schema.ts",
-  out: "./drizzle",
-  dbCredentials: {
-    url: process.env.OKE_SQLITE_URL ?? "file:.oke/app.sqlite",
-  },
-});

package/examples/notes/oke.config.ts

@@ -1,14 +0,0 @@
-import { defineConfig } from "okengine/config";
-
-export default defineConfig({
-  drivers: {
-    store: {
-      sql: {
-        local: "sqlite",
-        docker: "postgres",
-        test: "memory",
-        prod: "postgres",
-      },
-    },
-  },
-});

package/examples/notes/package.json

@@ -1,19 +0,0 @@
-{
-  "name": "@oke/example-notes",
-  "version": "0.0.1",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "bun test",
-    "dev": "oke dev"
-  },
-  "dependencies": {
-    "drizzle-orm": "^1.0.0-rc.4",
-    "drizzle-zod": "^0.8.3",
-    "okengine": "file:../..",
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "drizzle-kit": "^1.0.0-rc.4"
-  }
-}

package/examples/notes/src/app.ts

@@ -1,13 +0,0 @@
-import { db } from "./core";
-
-import { oke } from "okengine";
-import * as notes from "./flows/notes";
-
-export const app = oke({ name: "notes" }).adopt({ notes });
-
-export type App = typeof app; // ← the client needs nothing else
-
-Object.assign(app.$options, {
-  env: "test",
-  stores: [db],
-});

package/examples/notes/src/core.ts

@@ -1,4 +0,0 @@
-import { store } from "okengine";
-import * as schema from "./schema";
-
-export const db = store.sql("notes", { schema });

package/examples/notes/src/flows/notes/index.ts

@@ -1,58 +0,0 @@
-import { on, flow, http } from "okengine";
-import { createInsertSchema, createSelectSchema } from "drizzle-zod";
-import { z } from "zod";
-import { db } from "../../core";
-import { notes } from "../../schema";
-
-// Contracts derived from the schema — one source of truth, refined where the API is stricter
-const NewNote = createInsertSchema(notes, { title: (s) => s.min(1).max(120) }).omit({
-  id: true,
-  createdAt: true,
-});
-const Note = createSelectSchema(notes);
-const NoteId = z.object({ id: z.string() });
-const NotFound = z.object({});
-
-export const create = on(
-  http.post("/notes"),
-  flow({
-    in: NewNote,
-    out: NoteId,
-    do: async (input, fx) => {
-      const [note] = await fx.store(db).insert(notes).values(input).returning();
-      return { id: note.id };
-    },
-  }),
-);
-// effects → writes[sql:notes]
-
-export const list = on(
-  http.get("/notes"),
-  flow({
-    out: Note.array(),
-    do: (_, fx) => fx.store(db).select().from(notes),
-  }),
-);
-// effects → reads[sql:notes]
-
-export const get = on(
-  http.get("/notes/:id"),
-  flow({
-    in: NoteId,
-    out: Note,
-    errors: { NotFound },
-    do: async ({ id }, fx) => (await fx.store(db).findById(notes, id)) ?? fx.fail("NotFound", {}),
-  }),
-);
-
-export const remove = on(
-  http.delete("/notes/:id"),
-  flow({
-    in: NoteId,
-    errors: { NotFound },
-    do: async ({ id }, fx) => {
-      const deleted = await fx.store(db).delete(notes, id);
-      if (!deleted) return fx.fail("NotFound", {});
-    },
-  }),
-);

package/examples/notes/src/schema.ts

@@ -1,9 +0,0 @@
-import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
-import { id, now } from "okengine/store";
-
-export const notes = sqliteTable("notes", {
-  id: text("id").primaryKey().$defaultFn(id),
-  title: text("title").notNull(),
-  body: text("body").notNull(),
-  createdAt: integer("created_at").notNull().$defaultFn(now),
-});

package/examples/notes/tests/notes.test.ts

@@ -1,10 +0,0 @@
-import { test, expect } from "bun:test";
-import { createTestApp } from "okengine/test";
-import { app } from "../src/app";
-
-test("create then read", async () => {
-  const t = await createTestApp(app); // memory driver, automatic
-  const { data } = await t.api.notes.create({ title: "First", body: "Hello" });
-  const { data: note } = await t.api.notes.get({ id: data!.id });
-  expect(note!.title).toBe("First");
-});

package/examples/provisions/.env.example

@@ -1,19 +0,0 @@
-# Environment template — copy to `.env.local` for local overrides.
-# create-oke copies this file to `.env.local` when you scaffold a new project.
-#
-# Resolution order (first hit wins):
-#   process.env → .env.local → docker/.env.docker → vault driver → dev fallback
-#
-# --- Vault (app secrets) ---
-
-# STRIPE_KEY — Stripe secret API key for payments; from https://dashboard.stripe.com/apikeys (test keys start with sk_test_)
-STRIPE_KEY=
-
-# DATABASE_URL — primary Postgres URL (vault contract in src/vault.ts); from your host or `docker/.env.docker` after `oke dev --docker`
-DATABASE_URL=
-
-# --- Infrastructure (optional) ---
-# This app pins redis for prod kv in oke.config.ts (local dev uses in-memory kv).
-
-# REDIS_URL — Redis/Valkey connection for store.kv; from your host (Upstash, ElastiCache, …)
-# REDIS_URL=redis://:password@host:6379

package/examples/provisions/drizzle.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "drizzle-kit";
-
-/** Domain schema sync for `oke db push|generate|migrate`. */
-export default defineConfig({
-  dialect: "sqlite",
-  schema: "./src/schema.ts",
-  out: "./drizzle",
-  dbCredentials: {
-    url: process.env.OKE_SQLITE_URL ?? "file:.oke/app.sqlite",
-  },
-});

package/examples/provisions/oke.config.ts

@@ -1,19 +0,0 @@
-import { defineConfig } from "okengine/config";
-
-export default defineConfig({
-  drivers: {
-    store: {
-      sql: { local: "sqlite", test: "memory", prod: "postgres" },
-      kv: { local: "memory", test: "memory", prod: "redis" },
-    },
-    signal: { local: "memory", test: "memory", prod: "postgres" },
-    clock: { local: "memory", test: "frozen", prod: "postgres" },
-    vault: { local: "dotenv", test: "memory", prod: "sops" },
-    channel: {
-      email: { local: "console", test: "console", prod: "smtp" },
-      sms: { local: "console", test: "console", prod: "unifonic" },
-      whatsapp: { local: "console", test: "console", prod: "wa-cloud" },
-    },
-  },
-  i18n: { locales: ["en", "ar"], default: "ar", dir: { ar: "rtl" } },
-});