create-oke 0.2.6 → 0.3.2

package/examples/skyport/src/plugins/audit-schema.ts

@@ -1,7 +0,0 @@
-import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
-
-export const auditLog = sqliteTable("audit_log", {
-  id: text("id").primaryKey(),
-  at: integer("at").notNull(),
-  payload: text("payload"),
-});

package/examples/skyport/src/plugins/audit.ts

@@ -1,14 +0,0 @@
-import { plugin, store } from "okengine";
-import { z } from "zod";
-
-export const audit = plugin("audit", { version: "1.0.0" })
-  .config(z.object({ retain: z.string().default("2y") }))
-  .element(store.sql("audit", { schema: () => import("./audit-schema") }))
-  .needs("store.kv")
-  .decorate("audit", { enabled: true })
-  .hook("afterHandle", async (ctx, fx) => {
-    if (ctx.trigger.meta?.audit) await fx.store("audit").log(ctx);
-  })
-  .errors({ AuditWriteFailed: z.object({ reason: z.string() }) })
-  .consolePanel({ id: "audit", title: "Audit Trail", entry: "./panel.tsx" })
-  .cli("audit:export", ({ fx }) => fx.store("audit").exportCsv());

package/examples/skyport/src/plugins/panel.tsx

@@ -1,4 +0,0 @@
-/** Audit Console panel stub (Skyport tree). */
-export default function AuditPanel() {
-  return null;
-}

package/examples/skyport/src/schema.ts

@@ -1,22 +0,0 @@
-import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
-import { id } from "okengine/store";
-
-export const bookings = sqliteTable("bookings", {
-  id:        text("id").primaryKey().$defaultFn(id),
-  userId:    text("user_id").notNull(),
-  flightId:  text("flight_id").notNull(),
-  seats:     integer("seats").notNull(),
-  status:    text("status").notNull().default("pending"),
-  createdAt: integer("created_at").notNull(),
-});
-
-export const flights = sqliteTable("flights", {
-  id:    text("id").primaryKey(),
-  seatsAvailable: integer("seats_available").notNull(),
-});
-
-export const tickets = sqliteTable("tickets", {
-  id: text("id").primaryKey(), subject: text("subject").notNull(),
-  body: text("body").notNull(), urgency: text("urgency"), team: text("team"),
-  summary: text("summary"),
-});

package/examples/skyport/src/vault.ts

@@ -1,24 +0,0 @@
-import { vault } from "okengine";
-import { z } from "zod";
-
-export const dbUrl = vault.secret("DATABASE_URL", {
-  schema: z.string().url(),
-  dev: vault.fromStack("store.sql"),
-});
-
-export const dbReplica1 = vault.secret("DATABASE_REPLICA_1", {
-  schema: z.string().url(),
-  dev: "postgres://localhost/oke-replica",
-});
-
-export const anthropicKey = vault.secret("ANTHROPIC_KEY", {
-  schema: z.string().min(1),
-  dev: "sk-ant-test",
-});
-
-export const stripeKey = vault.secret("STRIPE_KEY", {
-  schema: z.string().startsWith("sk_"),
-  description: "Payments gateway key",
-  rotate: "90d",
-  dev: "sk_test_local",
-});

package/examples/skyport/tests/support.test.ts

@@ -1,16 +0,0 @@
-import { test, expect } from "bun:test";
-import { createTestApp } from "okengine/test";
-import { app } from "../src/app";
-import { triage } from "../src/ai";
-
-test("AI triage is mockable and cost-bounded", async () => {
-const t = await createTestApp(app);
-t.ai.mock(triage, { urgency: "high", team: "ops", summary: "seat dispute" });
-
-const u = await t.auth.loginAs({});
-const { data } = await t.api.support.createTicket({ subject: "…", body: "…" }, { as: u });
-
-expect(data!.urgency).toBe("high");
-expect(t.ai.cost()).toBeLessThan(0.02);        // budgets are assertable
-  await t.close();
-});

package/src/sync-templates.ts

@@ -1,86 +0,0 @@
-#!/usr/bin/env bun
-/**
- * prepack: copy repo-root `templates/` and `examples/` into this package so the
- * published npm package can scaffold without the monorepo checkout.
- *
- * Applies the same skip rules as runtime scaffold (no node_modules, no
- * monorepo-only docker.test.ts).
- */
-
-import {
-  cpSync,
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  rmSync,
-  statSync,
-} from "node:fs";
-import { join, relative, resolve } from "node:path";
-import { EXAMPLES, packageRoot, TEMPLATES } from "./templates.ts";
-import { shouldSkipTemplatePath } from "./transform.ts";
-
-const pkg = packageRoot();
-const templatesRoot = resolve(pkg, "../../templates");
-const examplesRoot = resolve(pkg, "../../examples");
-const outTemplates = join(pkg, "templates");
-const outExamples = join(pkg, "examples");
-
-if (!existsSync(templatesRoot)) {
-  console.error(
-    `create-oke prepack: templates/ not found at ${templatesRoot}`,
-  );
-  process.exit(1);
-}
-if (!existsSync(examplesRoot)) {
-  console.error(`create-oke prepack: examples/ not found at ${examplesRoot}`);
-  process.exit(1);
-}
-
-rmSync(outTemplates, { recursive: true, force: true });
-rmSync(outExamples, { recursive: true, force: true });
-mkdirSync(outTemplates, { recursive: true });
-mkdirSync(outExamples, { recursive: true });
-
-for (const id of TEMPLATES) {
-  const src = join(templatesRoot, id);
-  const dst = join(outTemplates, id);
-  if (!existsSync(src)) {
-    console.error(`create-oke prepack: missing template ${src}`);
-    process.exit(1);
-  }
-  copyFiltered(src, dst, src);
-  console.log(`create-oke prepack: template ${id}`);
-}
-
-for (const id of EXAMPLES) {
-  const src = join(examplesRoot, id);
-  const dst = join(outExamples, id);
-  if (!existsSync(src)) {
-    console.error(`create-oke prepack: missing example ${src}`);
-    process.exit(1);
-  }
-  copyFiltered(src, dst, src);
-  console.log(`create-oke prepack: example ${id}`);
-}
-
-/**
- * @param src - Source file or directory
- * @param dst - Destination path
- * @param root - Template root for relative skip paths
- */
-function copyFiltered(src: string, dst: string, root: string): void {
-  const st = statSync(src);
-  const rel = relative(root, src).split(/[/\\]/).join("/");
-  if (rel && shouldSkipTemplatePath(rel)) return;
-  if (st.isDirectory()) {
-    mkdirSync(dst, { recursive: true });
-    for (const entry of readdirSync(src)) {
-      copyFiltered(join(src, entry), join(dst, entry), root);
-    }
-    return;
-  }
-  if (st.isFile()) {
-    mkdirSync(join(dst, ".."), { recursive: true });
-    cpSync(src, dst);
-  }
-}

package/templates/full/README.md

@@ -1,49 +0,0 @@
-# full
-
-**Every element present and wired** — no business logic. Use when you want the
-complete surface ready to fill in.
-
-## Run
-
-```bash
-bun install
-oke dev          # app :6530 · Console :6533 · MCP :6535
-```
-
-| Port | Try |
-|---|---|
-| `:6530` | `GET /` · `GET /health` |
-| `:6533` | Console |
-| `:6535` | MCP |
-
-## What’s in this template
-
-```text
-full/
-├── oke.config.ts
-├── src/
-│   ├── app.ts                 # gates, secrets, signals, stores, channel, ai
-│   ├── core.ts / schema.ts    # Store
-│   ├── gates.ts               # open gate (used on HTTP)
-│   ├── vault.ts               # appSecret
-│   ├── channels.ts            # welcome template
-│   ├── ai.ts                  # stub model + echo prompt
-│   ├── locales/en.ts · ar.ts
-│   └── flows/main/
-│       ├── index.ts           # GET / · GET /health · every("1d")
-│       ├── shapes.ts
-│       └── signals.ts         # pinged
-└── tests/full.test.ts
-```
-
-- **Elements wired:** Flow · Store · Signal · Clock (`every`) · Gate · Vault · Channel · AI
-- **Unit:** `main`
-- **App `$options`:** `gates`, `secrets`, `signals`, `stores`, `channel`, `ai`
-- **Flows:** `root`, `health` (emits `pinged`), plus a trivial daily cron
-
-Replace stubs with real models, prompts, channels, and domain flows. Prefer
-`standard` if you do not need AI / clock / vault on day one.
-
-## Agent contract
-
-See [`AGENTS.md`](./AGENTS.md). Handbook: [okengine.vercel.app/docs](https://okengine.vercel.app/docs)

package/templates/full/oke.config.ts

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

package/templates/full/package.json

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

package/templates/full/src/ai.ts

@@ -1,11 +0,0 @@
-import { ai } from "okengine";
-import { z } from "zod";
-
-export const stub = ai.model("stub", { provider: "anthropic", tier: "haiku" });
-
-/** Stub prompt — replace with real versioned prompts. */
-export const echo = stub.prompt("echo", {
-  in: z.object({ text: z.string() }),
-  out: z.object({ text: z.string() }),
-  version: 1,
-});

package/templates/full/src/app.ts

@@ -1,34 +0,0 @@
-import { db } from "./core";
-import { open } from "./gates";
-import { appSecret } from "./vault";
-import { welcome } from "./channels";
-import { stub, echo } from "./ai";
-import { pinged } from "./flows/main/signals";
-import "./channels";
-import "./gates";
-import "./ai";
-import "./locales/en";
-import "./locales/ar";
-
-import { oke } from "okengine";
-import * as main from "./flows/main";
-
-export const app = oke({ name: "full" }).adopt({ main });
-
-export type App = typeof app;
-
-Object.assign(app.$options, {
-  env: "test",
-  gates: [open],
-  secrets: [appSecret],
-  signals: [pinged],
-  stores: [db],
-  channel: {
-    templates: [welcome],
-    defaultLocale: "en",
-  },
-  ai: {
-    models: [stub],
-    prompts: [echo],
-  },
-});

package/templates/full/src/channels.ts

@@ -1,9 +0,0 @@
-import { channel } from "okengine";
-import { z } from "zod";
-
-export const mail = channel.email({ from: "App <no-reply@example.com>" });
-
-/** Stub channel template — replace with real copy. */
-export const welcome = mail.template("welcome", {
-  schema: z.object({ name: z.string() }),
-});

package/templates/full/src/core.ts

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

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

@@ -1,45 +0,0 @@
-import { on, flow, http, every } from "okengine";
-import { z } from "zod";
-import { open } from "../../gates";
-import { Health } from "./shapes";
-import { pinged } from "./signals";
-
-/** First-run welcome — visit :6530/ after `oke dev`. */
-export const root = on(
-  http.get("/").gate(open),
-  flow({
-    out: z.object({
-      ok: z.literal(true),
-      console: z.string(),
-      try: z.string(),
-    }),
-    do: () => ({
-      ok: true as const,
-      console: "http://127.0.0.1:6533",
-      try: "/health",
-    }),
-  }),
-);
-
-export const health = on(
-  http.get("/health").gate(open),
-  flow({
-    out: Health,
-    do: async (_input, fx) => {
-      await fx.emit(pinged, { at: Date.now() });
-      return { ok: true as const };
-    },
-  }),
-);
-
-on(pinged, flow({
-  do: async () => {},
-}));
-
-/** Trivial cron — replace with real schedules. */
-on(
-  every("1d"),
-  flow({
-    do: async () => {},
-  }),
-);

package/templates/full/src/flows/main/shapes.ts

@@ -1,3 +0,0 @@
-import { z } from "zod";
-
-export const Health = z.object({ ok: z.literal(true) });

package/templates/full/src/flows/main/signals.ts

@@ -1,8 +0,0 @@
-import { signal } from "okengine";
-import { z } from "zod";
-
-/** Trivial signal — replace with real events. */
-export const pinged = signal("pinged", {
-  schema: z.object({ at: z.number() }),
-  delivery: "once",
-});

package/templates/full/src/gates.ts

@@ -1,4 +0,0 @@
-import { gate } from "okengine";
-
-/** Trivial shared gate — replace with real policies. */
-export const open = gate.policy("open", () => true);

package/templates/full/src/locales/ar.ts

@@ -1,3 +0,0 @@
-export default {
-  "welcome.subject": "أهلاً",
-};

package/templates/full/src/locales/en.ts

@@ -1,3 +0,0 @@
-export default {
-  "welcome.subject": "Welcome",
-};

package/templates/full/src/schema.ts

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

package/templates/full/src/vault.ts

@@ -1,9 +0,0 @@
-import { vault } from "okengine";
-import { z } from "zod";
-
-/** Stub secret contract — replace with your secrets. */
-export const appSecret = vault.secret("APP_SECRET", {
-  schema: z.string().min(1),
-  description: "Application secret",
-  dev: "dev-only-secret",
-});

package/templates/full/tests/full.test.ts

@@ -1,11 +0,0 @@
-import { test, expect } from "bun:test";
-import { createTestApp } from "okengine/test";
-import { app } from "../src/app";
-
-test("boots — health flow with wired elements", async () => {
-  const t = await createTestApp(app);
-  const { data, error } = await t.api.main.health({});
-  expect(error).toBeNull();
-  expect(data).toEqual({ ok: true });
-  await t.signals.drain();
-});

package/templates/hello/README.md

@@ -1,38 +0,0 @@
-# hello
-
-Fastest possible “it works” — one unit, two HTTP flows, **no Store**.
-
-## Run
-
-```bash
-bun install
-oke dev          # app :6530 · Console :6533 · MCP :6535
-```
-
-| Port | Try |
-|---|---|
-| `:6530` | `GET /` · `GET /hello` |
-| `:6533` | Console |
-| `:6535` | MCP |
-
-## What’s in this template
-
-```text
-hello/
-├── oke.config.ts
-├── src/
-│   ├── app.ts                 # oke({ name: "hello" }).adopt({ hello })
-│   └── flows/hello/index.ts   # GET / · GET /hello
-└── tests/hello.test.ts
-```
-
-- **Elements:** Flow only (no `store`, `gate`, `vault`, `channel`, or `ai`)
-- **Unit:** `hello`
-- **Flows:** `root` (`GET /`), `hello` (`GET /hello` → `{ message: "ok" }`)
-
-Replace `/hello` with your first real route. When you need persistence, move up to
-`minimal` or `standard` — or keep growing this tree.
-
-## Agent contract
-
-See [`AGENTS.md`](./AGENTS.md). Handbook: [okengine.vercel.app/docs](https://okengine.vercel.app/docs)

package/templates/hello/oke.config.ts

@@ -1,3 +0,0 @@
-import { defineConfig } from "okengine/config";
-
-export default defineConfig({});

package/templates/hello/package.json

@@ -1,14 +0,0 @@
-{
-  "name": "@oke/template-hello",
-  "version": "0.0.1",
-  "private": true,
-  "type": "module",
-  "dependencies": {
-    "okengine": "file:../..",
-    "zod": "^4.4.3"
-  },
-  "scripts": {
-    "test": "bun test",
-    "dev": "oke dev"
-  }
-}

package/templates/hello/src/app.ts

@@ -1,10 +0,0 @@
-import { oke } from "okengine";
-import * as hello from "./flows/hello";
-
-export const app = oke({ name: "hello" }).adopt({ hello });
-
-export type App = typeof app;
-
-Object.assign(app.$options, {
-  env: "test",
-});

package/templates/hello/src/flows/hello/index.ts

@@ -1,27 +0,0 @@
-import { on, flow, http } from "okengine";
-import { z } from "zod";
-
-/** First-run welcome — visit :6530/ after `oke dev`. */
-export const root = on(
-  http.get("/"),
-  flow({
-    out: z.object({
-      ok: z.literal(true),
-      console: z.string(),
-      try: z.string(),
-    }),
-    do: () => ({
-      ok: true as const,
-      console: "http://127.0.0.1:6533",
-      try: "/hello",
-    }),
-  }),
-);
-
-export const hello = on(
-  http.get("/hello"),
-  flow({
-    out: z.object({ message: z.string() }),
-    do: () => ({ message: "ok" }),
-  }),
-);

package/templates/hello/tests/hello.test.ts

@@ -1,10 +0,0 @@
-import { test, expect } from "bun:test";
-import { createTestApp } from "okengine/test";
-import { app } from "../src/app";
-
-test("boots and answers /hello", async () => {
-  const t = await createTestApp(app);
-  const { data, error } = await t.api.hello.hello({});
-  expect(error).toBeNull();
-  expect(data?.message).toBe("ok");
-});

package/templates/minimal/README.md

@@ -1,41 +0,0 @@
-# minimal
-
-Smallest shape you’d actually ship — **Store + HTTP flows** over a single table.
-
-## Run
-
-```bash
-bun install
-oke dev          # app :6530 · Console :6533 · MCP :6535
-```
-
-| Port | Try |
-|---|---|
-| `:6530` | `GET /` · `GET /entries` · `POST /entries` |
-| `:6533` | Console |
-| `:6535` | MCP |
-
-## What’s in this template
-
-```text
-minimal/
-├── oke.config.ts
-├── src/
-│   ├── app.ts                 # adopt({ main }), stores: [db]
-│   ├── core.ts                # store.sql("…")
-│   ├── schema.ts              # entries table (Drizzle)
-│   └── flows/main/index.ts    # GET / · GET|POST /entries
-└── tests/minimal.test.ts
-```
-
-- **Elements:** Flow · Store (`sql`)
-- **Unit:** `main`
-- **Flows:** `root`, `list` (`GET /entries`), `create` (`POST /entries` with `{ body }`)
-- **Schema:** `entries` — `id`, `body`, `createdAt`
-
-Swap `entries` for your domain table and grow flows beside it. Need gates,
-channels, or locales? Use `standard`.
-
-## Agent contract
-
-See [`AGENTS.md`](./AGENTS.md). Handbook: [okengine.vercel.app/docs](https://okengine.vercel.app/docs)

package/templates/minimal/oke.config.ts

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