okengine 0.2.5 → 0.2.8

package/src/kernel/app.ts

@@ -32,10 +32,7 @@ import {
   type CreateAppAuthBindingOptions,
 } from "./auth-resolve.ts";
 import { runDurable } from "../elements/clock/durable.ts";
-import {
-  isFlow,
-  type AnyFlowDef,
-} from "./flow.ts";
+import { isFlow, type AnyFlowDef } from "./flow.ts";
 import {
   createFxContext,
   resolveName,
@@ -80,16 +77,8 @@ import {
   type AccumulateDecorations,
 } from "./plug.ts";
 import type { PluginCapabilities, PluginDef } from "./plugin.ts";
-import {
-  createPluginRegistry,
-  type PluginRegistry,
-} from "./registry.ts";
-import {
-  createRouter,
-  type Router,
-  type RouterPreset,
-  type SmartRouter,
-} from "./router.ts";
+import { createPluginRegistry, type PluginRegistry } from "./registry.ts";
+import { createRouter, type Router, type RouterPreset, type SmartRouter } from "./router.ts";
 import type {
   CdcTrigger,
   EveryTrigger,
@@ -129,13 +118,13 @@ export interface OkeOptions {
    * subject key.
    */
   readonly archiveInputFields?: readonly string[];
-  /** Active environment for {@link OkeApp.boot} (defaults to `dev`). */
+  /** Active environment for {@link OkeApp.boot} (defaults to `local`). */
   readonly env?: BootOptions["env"];
   /**
-   * Local-server mode (`oke dev -s` / `OKE_STACK=1`) — force the `stack`
+   * Docker mode (`oke dev -d` / `OKE_DOCKER=1`) — force the `docker`
    * driver profile at boot.
    */
-  readonly stack?: BootOptions["stack"];
+  readonly docker?: BootOptions["docker"];
   /** Optional `oke.config.ts` document consumed at boot. */
   readonly config?: BootOptions["config"];
   /** Pre-built element runtimes (skip construction at boot when present). */
@@ -209,9 +198,7 @@ export interface UnitHooks<D extends Record<string, unknown> = {}> {
    *
    * @param pluginDef - Plugin from {@link plugin}
    */
-  plug<P extends PluginDef>(
-    pluginDef: P,
-  ): UnitHooks<AccumulateDecorations<D, P>>;
+  plug<P extends PluginDef>(pluginDef: P): UnitHooks<AccumulateDecorations<D, P>>;
 }
 
 /**
@@ -220,10 +207,7 @@ export interface UnitHooks<D extends Record<string, unknown> = {}> {
  * @typeParam D - Accumulated decoration types from app `.plug()`
  * @typeParam R - Accumulated client route map from `.adopt({ unit })`
  */
-export interface OkeApp<
-  D extends Record<string, unknown> = {},
-  R extends AppRouteMap = {},
-> {
+export interface OkeApp<D extends Record<string, unknown> = {}, R extends AppRouteMap = {}> {
   /** App name. */
   readonly name: string;
   /** Whether AoT compilation is enabled. */
@@ -269,9 +253,7 @@ export interface OkeApp<
    *
    * @param pluginDef - Plugin from {@link plugin}
    */
-  plug<P extends PluginDef>(
-    pluginDef: P,
-  ): OkeApp<AccumulateDecorations<D, P>, R>;
+  plug<P extends PluginDef>(pluginDef: P): OkeApp<AccumulateDecorations<D, P>, R>;
   /**
    * Captured plugin capabilities for the Manifest.
    */
@@ -357,10 +339,7 @@ export interface OkeApp<
    * @param signal - Signal name or handle
    * @param payload - Payload
    */
-  dispatchSignal(
-    signal: NamedRef,
-    payload?: unknown,
-  ): Promise<ExecuteResult[]>;
+  dispatchSignal(signal: NamedRef, payload?: unknown): Promise<ExecuteResult[]>;
   /**
    * Invoke all flows bound to an `every` interval.
    *
@@ -374,11 +353,7 @@ export interface OkeApp<
    * @param payload - before/after
    * @param column - Optional column filter
    */
-  dispatchCdc(
-    tableName: string,
-    payload: CdcPayload,
-    column?: string,
-  ): Promise<ExecuteResult[]>;
+  dispatchCdc(tableName: string, payload: CdcPayload, column?: string): Promise<ExecuteResult[]>;
   /**
    * Call a flow by name/handle (same path as `fx.call`).
    *
@@ -408,10 +383,7 @@ export interface OkeApp<
  */
 export function oke(options: OkeOptions): OkeApp {
   const aot = options.aot !== false;
-  const adopted: Binding[] = [
-    ...listBindings(),
-    ...(options.bindings ?? []),
-  ];
+  const adopted: Binding[] = [...listBindings(), ...(options.bindings ?? [])];
   /** Retained for test harness / boot merges. */
   const $options = options;
 
@@ -459,7 +431,7 @@ export function oke(options: OkeOptions): OkeApp {
   // --- boot (vault → store → signal → clock → channel → AI → runs → caps) ---
   let bootResult: BootResult | undefined;
   let bootPromise: Promise<BootResult> | undefined;
-  let bootEnv: BootOptions["env"] = options.env ?? "dev";
+  let bootEnv: BootOptions["env"] = options.env ?? "local";
   let authBinding: AppAuthBinding | undefined =
     options.auth !== undefined
       ? createAppAuthBinding({
@@ -490,10 +462,10 @@ export function oke(options: OkeOptions): OkeApp {
 
   async function doBoot(overrides?: Partial<BootOptions>): Promise<BootResult> {
     const { bootApplication } = await import("./boot.ts");
-    bootEnv = overrides?.env ?? options.env ?? "dev";
+    bootEnv = overrides?.env ?? options.env ?? "local";
     const merged: BootOptions = {
       env: bootEnv,
-      stack: overrides?.stack ?? options.stack,
+      docker: overrides?.docker ?? options.docker,
       config: overrides?.config ?? options.config,
       elements: overrides?.elements ?? options.elements,
       secrets: overrides?.secrets ?? options.secrets,
@@ -508,8 +480,7 @@ export function oke(options: OkeOptions): OkeApp {
       now: overrides?.now ?? options.fx?.now,
       instanceId: overrides?.instanceId,
       startScheduler: overrides?.startScheduler ?? options.startScheduler,
-      schedulerIntervalMs:
-        overrides?.schedulerIntervalMs ?? options.schedulerIntervalMs,
+      schedulerIntervalMs: overrides?.schedulerIntervalMs ?? options.schedulerIntervalMs,
       bindings: adopted,
       flows: [...flowsByName.values()],
       onCronFire: overrides?.onCronFire ?? handleCronFire,
@@ -542,9 +513,7 @@ export function oke(options: OkeOptions): OkeApp {
     return bootPromise;
   }
 
-  function isRunsRuntimeLike(
-    value: OkeOptions["runs"],
-  ): value is RunsRuntime {
+  function isRunsRuntimeLike(value: OkeOptions["runs"]): value is RunsRuntime {
     return (
       typeof value === "object" &&
       value !== null &&
@@ -570,20 +539,11 @@ export function oke(options: OkeOptions): OkeApp {
 
     const booted = await ensureBoot();
 
-    const unitBag =
-      flowDef.unit !== undefined ? unitHooks.get(flowDef.unit) : undefined;
+    const unitBag = flowDef.unit !== undefined ? unitHooks.get(flowDef.unit) : undefined;
     // app (hooks + plugs) → unit (hooks + plugs) → flow (hooks + plugs)
     const composedHooks = mergeHooks(
-      mergeHooks(
-        appHooks,
-        pluginRegistry.hooksAt("app", flowDef.unit, flowDef.name),
-        undefined,
-      ),
-      mergeHooks(
-        unitBag,
-        pluginRegistry.hooksAt("unit", flowDef.unit, flowDef.name),
-        undefined,
-      ),
+      mergeHooks(appHooks, pluginRegistry.hooksAt("app", flowDef.unit, flowDef.name), undefined),
+      mergeHooks(unitBag, pluginRegistry.hooksAt("unit", flowDef.unit, flowDef.name), undefined),
       mergeHooks(
         flowDef.hooks as HookMap,
         pluginRegistry.hooksAt("flow", flowDef.unit, flowDef.name),
@@ -591,10 +551,7 @@ export function oke(options: OkeOptions): OkeApp {
       ),
     );
 
-    const decorations = pluginRegistry.decorationsFor(
-      flowDef.unit,
-      flowDef.name,
-    );
+    const decorations = pluginRegistry.decorationsFor(flowDef.unit, flowDef.name);
 
     const ctx: InvocationContext = {
       trigger,
@@ -631,10 +588,7 @@ export function oke(options: OkeOptions): OkeApp {
       // a real HTTP request in production mode.
       const testMode = bootEnv === "test";
       if (testMode) {
-        applyPrincipal(
-          principals,
-          extras?.auth as ResolvedPrincipal | undefined,
-        );
+        applyPrincipal(principals, extras?.auth as ResolvedPrincipal | undefined);
         applyPrincipal(principals, extras?.principal);
         if (extras?.operator) principals.operator.id = extras.operator.id;
       }
@@ -645,9 +599,7 @@ export function oke(options: OkeOptions): OkeApp {
         principals,
         telemetry,
         allowTestPrincipals: testMode,
-        verifyBearer: binding
-          ? (token) => verifyBearerToken(binding, token)
-          : undefined,
+        verifyBearer: binding ? (token) => verifyBearerToken(binding, token) : undefined,
       });
 
       // Element hooks run first in the app-level onAuth/beforeHandle chain —
@@ -675,9 +627,7 @@ export function oke(options: OkeOptions): OkeApp {
       effects: flowDef.effects,
       runTelemetry: telemetry,
       now,
-      ...(principals
-        ? { auth: principals.auth as FxAuth, operator: principals.operator }
-        : {}),
+      ...(principals ? { auth: principals.auth as FxAuth, operator: principals.operator } : {}),
       ...(capability ? { capability } : {}),
       ...(booted
         ? {
@@ -750,13 +700,9 @@ export function oke(options: OkeOptions): OkeApp {
     }
 
     const runsRuntime =
-      booted?.runs ??
-      (isRunsRuntimeLike(options.runs) ? options.runs : undefined);
+      booted?.runs ?? (isRunsRuntimeLike(options.runs) ? options.runs : undefined);
     if (runsRuntime) {
-      const archiveCleartext = archiveFromInput(
-        ctx.input,
-        options.archiveInputFields,
-      );
+      const archiveCleartext = archiveFromInput(ctx.input, options.archiveInputFields);
       await runsRuntime.record(
         {
           flow: flowDef,
@@ -936,8 +882,7 @@ export function oke(options: OkeOptions): OkeApp {
         if (parts.length >= 2) {
           const [unit, ...flowParts] = parts;
           const flowName = flowParts.join("/");
-          const target =
-            flowsByName.get(`${unit}.${flowName}`) ?? flowsByName.get(flowName);
+          const target = flowsByName.get(`${unit}.${flowName}`) ?? flowsByName.get(flowName);
           if (!target) {
             return respond(new Response("Not Found", { status: 404 }));
           }
@@ -986,12 +931,11 @@ export function oke(options: OkeOptions): OkeApp {
         input = undefined;
       }
 
-      const result = await execute(
-        binding.flow,
-        input,
-        binding.trigger,
-        { request, params, validated },
-      );
+      const result = await execute(binding.flow, input, binding.trigger, {
+        request,
+        params,
+        validated,
+      });
 
       return respond(encodeExecuteResult(result));
     },
@@ -1000,9 +944,7 @@ export function oke(options: OkeOptions): OkeApp {
       const results: ExecuteResult[] = [];
       for (const b of adopted) {
         if (b.trigger.kind === "signal" && b.trigger.name === name) {
-          results.push(
-            await execute(b.flow, payload, b.trigger as SignalAsTrigger),
-          );
+          results.push(await execute(b.flow, payload, b.trigger as SignalAsTrigger));
         }
       }
       return results;
@@ -1011,9 +953,7 @@ export function oke(options: OkeOptions): OkeApp {
       const results: ExecuteResult[] = [];
       for (const b of adopted) {
         if (b.trigger.kind === "every" && b.trigger.interval === interval) {
-          results.push(
-            await execute(b.flow, undefined, b.trigger as EveryTrigger),
-          );
+          results.push(await execute(b.flow, undefined, b.trigger as EveryTrigger));
         }
       }
       return results;

package/src/kernel/auth-resolve.ts

@@ -36,9 +36,7 @@ export interface CreateAppAuthBindingOptions {
  *
  * @param options - Secret + optional session store / clock
  */
-export function createAppAuthBinding(
-  options: CreateAppAuthBindingOptions,
-): AppAuthBinding {
+export function createAppAuthBinding(options: CreateAppAuthBindingOptions): AppAuthBinding {
   return {
     secret: options.secret,
     sessions: options.sessions ?? createSessionStore(),
@@ -57,12 +55,7 @@ export async function verifyBearerToken(
   auth: AppAuthBinding,
   token: string,
 ): Promise<ResolvedPrincipal> {
-  const claims = await verifyAccess(
-    auth.sessions,
-    auth.secret,
-    token,
-    auth.now,
-  );
+  const claims = await verifyAccess(auth.sessions, auth.secret, token, auth.now);
   return claimsToPrincipal(claims);
 }
 

package/src/kernel/boot-bind/ai.ts

@@ -3,10 +3,7 @@
  */
 
 import { mockAiDriver } from "../../drivers/ai-mock.ts";
-import {
-  createAiRuntime,
-  type AiRuntime,
-} from "../../elements/ai.ts";
+import { createAiRuntime, type AiRuntime } from "../../elements/ai.ts";
 import type { GateRuntime } from "../../elements/gate.ts";
 import type { BootOptions } from "../boot.ts";
 

package/src/kernel/boot-bind/channel.ts

@@ -3,10 +3,7 @@
  */
 
 import { openConsoleChannel } from "../../drivers/channel-console.ts";
-import {
-  createChannelRuntime,
-  type ChannelRuntime,
-} from "../../elements/channel.ts";
+import { createChannelRuntime, type ChannelRuntime } from "../../elements/channel.ts";
 import type { BootOptions } from "../boot.ts";
 
 /**
@@ -15,10 +12,7 @@ import type { BootOptions } from "../boot.ts";
  * @param options - Boot options
  * @param now - Clock
  */
-export function bindChannel(
-  options: BootOptions,
-  now: () => number,
-): ChannelRuntime {
+export function bindChannel(options: BootOptions, now: () => number): ChannelRuntime {
   return createChannelRuntime({
     ...(options.channel ?? {}),
     drivers: options.channel?.drivers ?? [openConsoleChannel()],

package/src/kernel/boot-bind/clock.ts

@@ -9,10 +9,7 @@ import {
   type ClockDecl,
   type ClockRuntime,
 } from "../../elements/clock.ts";
-import {
-  resolveDriverId,
-  type ConfigEnv,
-} from "../../config/index.ts";
+import { resolveDriverId, type ConfigEnv } from "../../config/index.ts";
 import type { BootOptions } from "../boot.ts";
 
 /** Result of binding a clock runtime. */
@@ -36,8 +33,7 @@ export async function bindClock(
   prebuilt?: ClockRuntime,
 ): Promise<BindClockResult> {
   const clockDriver =
-    resolveDriverId(options.config?.drivers?.clock, env) ??
-    (env === "test" ? "frozen" : "memory");
+    resolveDriverId(options.config?.drivers?.clock, env) ?? (env === "test" ? "frozen" : "memory");
   const clock =
     prebuilt ??
     (clockDriver === "frozen" || env === "test"

package/src/kernel/boot-bind/gate.ts

@@ -3,10 +3,7 @@
  */
 
 import { memoryDrivers } from "../../drivers/memory.ts";
-import {
-  createGateRuntime,
-  type GateRuntime,
-} from "../../elements/gate.ts";
+import { createGateRuntime, type GateRuntime } from "../../elements/gate.ts";
 import type { BootOptions } from "../boot.ts";
 
 /**
@@ -15,10 +12,7 @@ import type { BootOptions } from "../boot.ts";
  * @param options - Boot options
  * @param now - Clock
  */
-export async function bindGate(
-  options: BootOptions,
-  now: () => number,
-): Promise<GateRuntime> {
+export async function bindGate(options: BootOptions, now: () => number): Promise<GateRuntime> {
   const kvNs = await memoryDrivers.kv.open({ name: "oke:gates" });
   return createGateRuntime({
     gates: options.gates ?? [],

package/src/kernel/boot-bind/runs.ts

@@ -14,9 +14,7 @@ import {
  *
  * @param options - Create options (when not already a runtime)
  */
-export async function bindRuns(
-  options?: CreateRunsRuntimeOptions,
-): Promise<RunsRuntime> {
+export async function bindRuns(options?: CreateRunsRuntimeOptions): Promise<RunsRuntime> {
   const runs = createRunsRuntime({
     driver: options?.driver ?? memoryRunsDriver,
     ...(options ?? {}),

package/src/kernel/boot-bind/signal.ts

@@ -3,14 +3,8 @@
  */
 
 import { memorySignalDriver } from "../../drivers/signal-memory.ts";
-import {
-  createSignalRuntime,
-  type SignalRuntime,
-} from "../../elements/signal.ts";
-import {
-  resolveDriverId,
-  type ConfigEnv,
-} from "../../config/index.ts";
+import { createSignalRuntime, type SignalRuntime } from "../../elements/signal.ts";
+import { resolveDriverId, type ConfigEnv } from "../../config/index.ts";
 import type { BootOptions } from "../boot.ts";
 
 /**
@@ -25,8 +19,7 @@ export async function bindSignal(
   env: ConfigEnv,
   now: () => number,
 ): Promise<SignalRuntime> {
-  const signalId =
-    resolveDriverId(options.config?.drivers?.signal, env) ?? "memory";
+  const signalId = resolveDriverId(options.config?.drivers?.signal, env) ?? "memory";
   void signalId;
   const signal = createSignalRuntime({
     driver: memorySignalDriver,

package/src/kernel/boot-bind/store.test.ts

@@ -1,5 +1,5 @@
 /**
- * Store binder — stack profile (+ env overrides).
+ * Store binder — docker profile (+ env overrides).
  */
 
 import { afterEach, describe, expect, test } from "bun:test";
@@ -7,54 +7,54 @@ import { resolveKvDriverId, resolveSqlDriverId } from "./store.ts";
 
 describe("bindStore driver resolution", () => {
   const prev = {
-    stack: process.env.OKE_STACK,
+    docker: process.env.OKE_DOCKER,
     sql: process.env.OKE_SQL_DRIVER,
     kv: process.env.OKE_KV_DRIVER,
   };
 
   afterEach(() => {
-    if (prev.stack === undefined) delete process.env.OKE_STACK;
-    else process.env.OKE_STACK = prev.stack;
+    if (prev.docker === undefined) delete process.env.OKE_DOCKER;
+    else process.env.OKE_DOCKER = prev.docker;
     if (prev.sql === undefined) delete process.env.OKE_SQL_DRIVER;
     else process.env.OKE_SQL_DRIVER = prev.sql;
     if (prev.kv === undefined) delete process.env.OKE_KV_DRIVER;
     else process.env.OKE_KV_DRIVER = prev.kv;
   });
 
-  test("dev env keeps sqlite / memory from config", () => {
+  test("local env keeps sqlite / memory from config", () => {
     const options = {
       config: {
         drivers: {
           store: {
-            sql: { dev: "sqlite", stack: "postgres", prod: "postgres" },
-            kv: { dev: "memory", stack: "redis", prod: "redis" },
+            sql: { local: "sqlite", docker: "postgres", prod: "postgres" },
+            kv: { local: "memory", docker: "redis", prod: "redis" },
           },
         },
       },
     };
-    expect(resolveSqlDriverId(options, "dev", false)).toBe("sqlite");
-    expect(resolveKvDriverId(options, "dev", false)).toBe("memory");
+    expect(resolveSqlDriverId(options, "local", false)).toBe("sqlite");
+    expect(resolveKvDriverId(options, "local", false)).toBe("memory");
   });
 
-  test("stack env uses stack profile (falls back to prod)", () => {
+  test("docker env uses docker profile (falls back to prod)", () => {
     const options = {
       config: {
         drivers: {
           store: {
-            sql: { dev: "sqlite", stack: "postgres", prod: "postgres" },
-            kv: { dev: "memory", prod: "redis" },
+            sql: { local: "sqlite", docker: "postgres", prod: "postgres" },
+            kv: { local: "memory", prod: "redis" },
           },
         },
       },
     };
-    expect(resolveSqlDriverId(options, "stack", true)).toBe("postgres");
-    expect(resolveKvDriverId(options, "stack", true)).toBe("redis");
+    expect(resolveSqlDriverId(options, "docker", true)).toBe("postgres");
+    expect(resolveKvDriverId(options, "docker", true)).toBe("redis");
   });
 
-  test("stack mode honours OKE_*_DRIVER overrides", () => {
+  test("docker mode honours OKE_*_DRIVER overrides", () => {
     process.env.OKE_SQL_DRIVER = "postgres";
     process.env.OKE_KV_DRIVER = "redis";
-    expect(resolveSqlDriverId({}, "stack", true)).toBe("postgres");
-    expect(resolveKvDriverId({}, "stack", true)).toBe("redis");
+    expect(resolveSqlDriverId({}, "docker", true)).toBe("postgres");
+    expect(resolveKvDriverId({}, "docker", true)).toBe("redis");
   });
 });