create-oke 0.7.0 → 0.9.0

package/package.json

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

package/src/drivers-catalog.ts

@@ -1,8 +1,9 @@
 /**
  * Boot-implemented driver choices offered by the create-oke customize wizard.
  *
- * Never lists ids that fail loud at boot (signal postgres/nats, clock postgres,
- * ai bedrock/vertex).
+ * Never lists ids that fail loud at boot (signal postgres/nats,
+ * ai bedrock/vertex). Clock + journal `postgres` are real (SKIP LOCKED
+ * CronStore / durable-run journal).
  */
 
 import type { CreateDefaults, CreateProfile, EnvDriverPins } from "./create-defaults.ts";
@@ -20,7 +21,7 @@ export const TEMPLATE_DOCKER_PROD = {
   kv: "redis",
   files: "s3",
   signal: "redis",
-  clock: "file",
+  clock: "postgres",
   vault: "openbao",
   email: "smtp",
 } as const;
@@ -81,9 +82,16 @@ export const SIGNAL_CHOICES: readonly DriverChoice[] = [
 export const CLOCK_CHOICES: readonly DriverChoice[] = [
   { value: "memory", label: "memory" },
   { value: "file", label: "file" },
+  { value: "postgres", label: "postgres" },
   { value: "frozen", label: "frozen" },
 ];
 
+export const JOURNAL_CHOICES: readonly DriverChoice[] = [
+  { value: "memory", label: "memory" },
+  { value: "file", label: "file" },
+  { value: "postgres", label: "postgres" },
+];
+
 export const VAULT_CHOICES: readonly DriverChoice[] = [
   { value: "env", label: "env" },
   { value: "openbao", label: "openbao" },
@@ -96,6 +104,7 @@ export const EMAIL_CHOICES: readonly DriverChoice[] = [
   { value: "smtp", label: "smtp" },
   { value: "resend", label: "resend" },
   { value: "sndr", label: "sndr" },
+  { value: "taqnyat-mail", label: "taqnyat-mail" },
 ];
 
 /** AI menu providers → protocol driver. */
@@ -208,6 +217,7 @@ export function aiDriverForProvider(provider: string): string {
 /** Default image pins keyed by role (standard template). */
 export const DEFAULT_IMAGES: Readonly<Record<string, string>> = {
   "store.sql": "postgres:18-alpine",
+  pgdog: "ghcr.io/pgdogdev/pgdog:v0.1.51",
   "store.kv": "redis:8-alpine",
   "store.files": "rustfs/rustfs:1.0.0-beta.11",
   "channel.email": "axllent/mailpit:v1.22.3",

package/src/transform.ts

@@ -286,7 +286,7 @@ ${close}}`;
 const IMAGE_ENV_COLUMNS = new Set(["local", "docker", "test", "prod"]);
 
 /** Known compose role keys written into `images`. */
-const IMAGE_ROLE_KEY = /^(?:store\.(?:sql|kv|files|index)|channel\.email|vault|ai)$/;
+const IMAGE_ROLE_KEY = /^(?:store\.(?:sql|kv|files|index)|channel\.email|vault|ai|pgdog)$/;
 
 /**
  * Keep `images` in sync with chosen docker drivers.
@@ -312,6 +312,7 @@ function syncImages(source: string, defaults: CreateDefaults): string {
     d.store.sql.prod === "pgvector"
   ) {
     pin("store.sql", DEFAULT_IMAGES["store.sql"]!);
+    pin("pgdog", DEFAULT_IMAGES.pgdog!);
   }
   if (d.store.kv.docker === "redis" || d.signal.docker === "redis") {
     pin("store.kv", DEFAULT_IMAGES["store.kv"]!);

package/templates/advanced/README.md

@@ -7,6 +7,7 @@ Docker-ready [okengine](https://oke.omqkhafi.dev) **Notes** starter — same dom
 bun install
 oke mode docker   # seeded by create-oke recommended path
 oke dev
+oke db seed       # essential welcome note + local/docker sample notes
 ```
 
 | Surface | URL |
@@ -26,6 +27,12 @@ oke dev
 Configure AI with `oke ai setup` or `create-oke --ai` (writes `src/ai.ts` + `drivers.ai`).
 Without AI, summarize returns a local excerpt (`via: "fallback"`).
 
+## Layout extras
+
+| Path | Role |
+| ---- | ---- |
+| `src/seed/` | `oke db seed` — essential + dev sample notes |
+
 ## Drivers
 
 See `oke.config.ts`: local sqlite/memory/fs · docker postgres/redis/s3/openbao/smtp.

package/templates/advanced/oke.config.ts

@@ -41,9 +41,16 @@ export default defineConfig({
     },
     clock: {
       local: "memory",
-      docker: "file",
+      docker: "postgres",
       test: "frozen",
-      prod: "file",
+      prod: "postgres",
+    },
+    // Durable-flow journal (durable: true runs) — shared + leased in docker/prod.
+    journal: {
+      local: "memory",
+      docker: "postgres",
+      test: "memory",
+      prod: "postgres",
     },
     vault: {
       local: "env",
@@ -63,6 +70,7 @@ export default defineConfig({
   },
   images: {
     "store.sql": "postgres:18-alpine",
+    pgdog: "ghcr.io/pgdogdev/pgdog:v0.1.51",
     "store.kv": "redis:8-alpine",
     "store.files": "rustfs/rustfs:1.0.0-beta.11",
     "channel.email": "axllent/mailpit:v1.22.3",

package/templates/advanced/src/seed/index.ts

@@ -0,0 +1,67 @@
+import { defineSeed, type Fx } from "okengine";
+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
+ * Store docs → Seeding.
+ */
+
+async function welcomeNote(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "welcome" },
+    {
+      id: "welcome",
+      title: "Welcome",
+      body: "Advanced Notes starter — attach files, summarize with AI, daily digest clock.",
+      archivedAt: null,
+      createdAt: 1,
+    },
+  );
+}
+
+async function sampleNotes(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-shipping" },
+    {
+      id: "sample-shipping",
+      title: "Shipping checklist",
+      body: "Confirm schema with oke db push (or migrate in docker), then oke db seed.",
+      archivedAt: null,
+      createdAt: 2,
+    },
+  );
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-attach" },
+    {
+      id: "sample-attach",
+      title: "Try attach",
+      body: "POST /notes/:id/attach stores a text blob on files:uploads.",
+      archivedAt: null,
+      createdAt: 3,
+    },
+  );
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-summarize" },
+    {
+      id: "sample-summarize",
+      title: "Try summarize",
+      body: "POST /notes/:id/summarize uses fx.ask when AI is configured, else a local excerpt.",
+      archivedAt: null,
+      createdAt: 4,
+    },
+  );
+}
+
+export default defineSeed({
+  essential: welcomeNote,
+  dev: sampleNotes,
+  // prod: async (fx) => { /* real production-only data, e.g. register a webhook */ },
+});

package/templates/standard/README.md

@@ -6,6 +6,7 @@ named Flows, Store, Signal → email, and Vault.
 ```bash
 bun install
 oke dev
+oke db seed   # essential welcome note + local/docker sample notes
 ```
 
 | Surface | URL |
@@ -32,6 +33,7 @@ never anonymous `flow_1`.
 | Path | Role |
 | ---- | ---- |
 | `src/schema.decl.ts` | `notes` table |
+| `src/seed/` | `oke db seed` — essential + dev sample notes |
 | `src/flows/notes/` | list · create · get · archive · onCreated |
 | `src/flows/main/` | root · health |
 | `src/channels.ts` | `note-created` email template |

package/templates/standard/oke.config.ts

@@ -34,9 +34,16 @@ export default defineConfig({
     },
     clock: {
       local: "memory",
-      docker: "file",
+      docker: "postgres",
       test: "frozen",
-      prod: "file",
+      prod: "postgres",
+    },
+    // Durable-flow journal (durable: true runs) — shared + leased in docker/prod.
+    journal: {
+      local: "memory",
+      docker: "postgres",
+      test: "memory",
+      prod: "postgres",
     },
     vault: {
       local: "env",
@@ -55,6 +62,7 @@ export default defineConfig({
   },
   images: {
     "store.sql": "postgres:18-alpine",
+    pgdog: "ghcr.io/pgdogdev/pgdog:v0.1.51",
     "store.kv": "redis:8-alpine",
     "store.files": "rustfs/rustfs:1.0.0-beta.11",
     "channel.email": "axllent/mailpit:v1.22.3",

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

@@ -0,0 +1,56 @@
+import { defineSeed, type Fx } from "okengine";
+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
+ * Store docs → Seeding.
+ */
+
+async function welcomeNote(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "welcome" },
+    {
+      id: "welcome",
+      title: "Welcome",
+      body: "Your Notes API is ready. Create, list, and archive notes over HTTP.",
+      archivedAt: null,
+      createdAt: 1,
+    },
+  );
+}
+
+async function sampleNotes(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-shipping" },
+    {
+      id: "sample-shipping",
+      title: "Shipping checklist",
+      body: "Confirm schema with oke db push, then seed with oke db seed.",
+      archivedAt: null,
+      createdAt: 2,
+    },
+  );
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-ideas" },
+    {
+      id: "sample-ideas",
+      title: "Ideas",
+      body: "Replace these seed rows with your own domain data.",
+      archivedAt: null,
+      createdAt: 3,
+    },
+  );
+}
+
+export default defineSeed({
+  essential: welcomeNote,
+  dev: sampleNotes,
+  // prod: async (fx) => { /* real production-only data, e.g. register a webhook */ },
+});