create-oke 0.2.8 → 0.3.2

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/.env.example

@@ -1,9 +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
-#
-# This template has no Vault declarations and no pinned infrastructure drivers.
-# Add variables here when you introduce `vault.secret(...)` in src/vault.ts or
-# pin postgres/redis/s3/smtp drivers in oke.config.ts.

package/templates/hello/README.md

@@ -1,40 +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
-# or: oke mode docker && oke dev   # compose infra on host Bun
-```
-
-| Port    | Try                    |
-| ------- | ---------------------- |
-| `:6530` | `GET /` · `GET /hello` |
-| `:6533` | Console                |
-| `:6535` | MCP                    |
-
-## What’s in this template
-
-```text
-hello/
-├── .env.example               # copied to .env.local by create-oke
-├── 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/.env.example

@@ -1,13 +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 docker/prod SQL in oke.config.ts.
-# Local dev uses sqlite by default; uncomment only when overriding postgres URLs.
-# Run `oke dev --docker` to write role-accurate keys into `docker/.env.docker`.
-
-# DATABASE_URL — primary Postgres connection; from your host (Neon, RDS, …) or `docker/.env.docker` after `oke dev --docker`
-# DATABASE_URL=postgres://user:password@127.0.0.1:5432/oke

package/templates/minimal/README.md

@@ -1,49 +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
-# or: oke mode docker && oke dev   # postgres via compose
-```
-
-Local `oke dev` auto-runs `oke db push` when `schema.ts` changes (opt out:
-`--no-db-push`). Docker/prod never auto-apply DDL — use `oke db migrate`.
-
-| Port    | Try                                         |
-| ------- | ------------------------------------------- |
-| `:6530` | `GET /` · `GET /entries` · `POST /entries` |
-| `:6533` | Console                                     |
-| `:6535` | MCP                                         |
-
-## What’s in this template
-
-```text
-minimal/
-├── .env.example               # copied to .env.local by create-oke
-├── drizzle.config.ts          # oke db push|generate|migrate
-├── oke.config.ts              # local: sqlite · docker/prod: postgres
-├── src/
-│   ├── app.ts                 # adopt({ main }), stores: [db]
-│   ├── core.ts                # store.sql("…")
-│   ├── schema.ts              # entries table (Drizzle escape hatch)
-│   └── 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. Prefer
-`store.schema.table` + `field.*` in `schema.decl.ts` when you want ORM-agnostic
-declare (Linkly); hand-written `schema.ts` remains the escape hatch. 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/drizzle.config.ts

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

package/templates/minimal/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/templates/minimal/package.json

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

package/templates/minimal/src/app.ts

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

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

@@ -1,49 +0,0 @@
-import { on, flow, http } from "okengine";
-import { z } from "zod";
-import { db } from "../../core";
-import { entries } from "../../schema";
-
-const NewEntry = z.object({ body: z.string().min(1) });
-const EntryId = z.object({ id: z.string() });
-const Entry = z.object({
-  id: z.string(),
-  body: z.string(),
-  createdAt: z.number(),
-});
-
-/** 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: "GET /entries",
-    }),
-  }),
-);
-
-export const create = on(
-  http.post("/entries"),
-  flow({
-    in: NewEntry,
-    out: EntryId,
-    do: async (input, fx) => {
-      const [row] = await fx.store(db).insert(entries).values(input).returning();
-      return { id: row.id };
-    },
-  }),
-);
-
-export const list = on(
-  http.get("/entries"),
-  flow({
-    out: Entry.array(),
-    do: (_, fx) => fx.store(db).select().from(entries),
-  }),
-);

package/templates/minimal/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/minimal/tests/minimal.test.ts

@@ -1,13 +0,0 @@
-import { test, expect } from "bun:test";
-import { createTestApp } from "okengine/test";
-import { app } from "../src/app";
-
-test("boots — create then list", async () => {
-  const t = await createTestApp(app);
-  const { data, error } = await t.api.main.create({ body: "hello" });
-  expect(error).toBeNull();
-  expect(data?.id).toBeTruthy();
-  const { data: rows } = await t.api.main.list({});
-  expect(rows?.length).toBe(1);
-  expect(rows?.[0]?.body).toBe("hello");
-});

package/templates/standard/.env.example

@@ -1,21 +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) ---
-# Declare secrets in src/vault.ts with `vault.secret(...)`, then uncomment lines here.
-
-# --- Infrastructure (optional) ---
-# Commented — this app pins postgres, redis, and smtp (Mailpit) in oke.config.ts.
-# Run `oke dev --docker` to write role-accurate keys into `docker/.env.docker`.
-
-# DATABASE_URL — primary Postgres connection; from your host or `docker/.env.docker` after `oke dev --docker`
-# DATABASE_URL=postgres://user:password@127.0.0.1:5432/oke
-
-# REDIS_URL — Redis/Valkey connection for store.kv; from your host or `docker/.env.docker` after `oke dev --docker`
-# REDIS_URL=redis://:password@127.0.0.1:6379
-
-# SMTP_URL — outbound email (Mailpit in docker dev); from your provider or `docker/.env.docker` after `oke dev --docker`
-# SMTP_URL=smtp://127.0.0.1:1025

package/templates/standard/drizzle.config.ts

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

package/templates/standard/oke.config.ts

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

package/templates/standard/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/standard/src/schema.ts

@@ -1,9 +0,0 @@
-import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
-import { id, now } from "okengine/store";
-
-/** Replace with your tables — keep defaults on the schema. */
-export const entries = sqliteTable("entries", {
-  id: text("id").primaryKey().$defaultFn(id),
-  body: text("body").notNull(),
-  createdAt: integer("created_at").notNull().$defaultFn(now),
-});