okengine 0.2.5 → 0.2.8

package/src/drivers/redis.ts

@@ -5,24 +5,15 @@
  */
 
 import { LuaKvStore } from "./kv-lua.ts";
-import type {
-  KvClientLike,
-  KvDriver,
-  KvNamespace,
-  KvOpenOptions,
-} from "./types.ts";
+import type { KvClientLike, KvDriver, KvNamespace, KvOpenOptions } from "./types.ts";
 
 /**
  * Open a KV namespace over the redis protocol.
  *
  * @param options - Name / URL / injected client
  */
-export async function openRedisKv(
-  options: KvOpenOptions,
-): Promise<KvNamespace> {
-  const client: KvClientLike =
-    options.client ??
-    createBunRedisClient(options.url);
+export async function openRedisKv(options: KvOpenOptions): Promise<KvNamespace> {
+  const client: KvClientLike = options.client ?? createBunRedisClient(options.url);
 
   const prefix = `oke:kv:${options.name}:`;
 
@@ -39,8 +30,7 @@ export async function openRedisKv(
     },
     async set(key, value, ttl) {
       const payload = JSON.stringify(value);
-      const ex =
-        ttl !== undefined ? Math.max(1, Math.ceil(ttlToSeconds(ttl))) : undefined;
+      const ex = ttl !== undefined ? Math.max(1, Math.ceil(ttlToSeconds(ttl))) : undefined;
       if (ex !== undefined) {
         await client.set(prefix + key, payload, { ex });
       } else {
@@ -70,11 +60,7 @@ export async function openRedisKv(
         return (await client.eval(script, prefixed.length, ...keysAndArgs)) as T;
       }
       if (client.send) {
-        return (await client.send("EVAL", [
-          script,
-          String(prefixed.length),
-          ...keysAndArgs,
-        ])) as T;
+        return (await client.send("EVAL", [script, String(prefixed.length), ...keysAndArgs])) as T;
       }
       throw new Error("redis kv.eval: client lacks eval/send");
     },
@@ -90,10 +76,7 @@ export async function openRedisKv(
  * @param client - Redis-like client
  * @param match - MATCH pattern
  */
-async function scanAll(
-  client: KvClientLike,
-  match: string,
-): Promise<string[]> {
+async function scanAll(client: KvClientLike, match: string): Promise<string[]> {
   if (client.scan) {
     const out: string[] = [];
     let cursor = "0";
@@ -111,13 +94,10 @@ async function scanAll(
     const out: string[] = [];
     let cursor = "0";
     do {
-      const reply = (await client.send("SCAN", [
-        cursor,
-        "MATCH",
-        match,
-        "COUNT",
-        "100",
-      ])) as [string, string[]];
+      const reply = (await client.send("SCAN", [cursor, "MATCH", match, "COUNT", "100"])) as [
+        string,
+        string[],
+      ];
       const next = String(reply[0]);
       const batch = reply[1] ?? [];
       out.push(...batch);
@@ -125,9 +105,7 @@ async function scanAll(
     } while (cursor !== "0");
     return out;
   }
-  throw new Error(
-    "redis kv.list: client lacks SCAN — key browse refused rather than KEYS *",
-  );
+  throw new Error("redis kv.list: client lacks SCAN — key browse refused rather than KEYS *");
 }
 
 function ttlToSeconds(ttl: string): number {
@@ -159,8 +137,7 @@ function ttlToSeconds(ttl: string): number {
  * @param url - Optional Redis URL
  */
 export function createBunRedisClient(url?: string): KvClientLike {
-  const redis =
-    url !== undefined ? new Bun.RedisClient(url) : Bun.redis;
+  const redis = url !== undefined ? new Bun.RedisClient(url) : Bun.redis;
 
   return {
     get: (key) => redis.get(key),
@@ -224,8 +201,7 @@ export function createRedisFakeClient(nowMs?: () => number): KvClientLike & {
     },
     async scan(cursor, opts) {
       const match = opts?.match ?? "*";
-      const prefix =
-        match.endsWith("*") ? match.slice(0, -1) : match;
+      const prefix = match.endsWith("*") ? match.slice(0, -1) : match;
       const all = [...data.keys()].filter((k) =>
         match.endsWith("*") ? k.startsWith(prefix) : k === match,
       );

package/src/drivers/s3.ts

@@ -4,24 +4,15 @@
  * Protocol-named: AWS S3 · R2 · MinIO · SeaweedFS · Garage · Backblaze.
  */
 
-import type {
-  FilesBucket,
-  FilesDriver,
-  FilesOpenOptions,
-  S3ClientLike,
-} from "./types.ts";
+import type { FilesBucket, FilesDriver, FilesOpenOptions, S3ClientLike } from "./types.ts";
 
 /**
  * Open a files bucket over the S3 protocol.
  *
  * @param options - Bucket name / injected client
  */
-export async function openS3Bucket(
-  options: FilesOpenOptions,
-): Promise<FilesBucket> {
-  const client: S3ClientLike =
-    options.client ??
-    createBunS3Client(options.root ?? options.name);
+export async function openS3Bucket(options: FilesOpenOptions): Promise<FilesBucket> {
+  const client: S3ClientLike = options.client ?? createBunS3Client(options.root ?? options.name);
 
   const prefix = "";
 
@@ -89,8 +80,7 @@ export function createS3FakeClient(): S3ClientLike & {
     file(key: string) {
       return {
         async write(data) {
-          const bytes =
-            typeof data === "string" ? new TextEncoder().encode(data) : data;
+          const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
           objects.set(key, bytes);
           return bytes.byteLength;
         },
@@ -113,9 +103,7 @@ export function createS3FakeClient(): S3ClientLike & {
     async list(options) {
       const prefix = options?.prefix ?? "";
       return {
-        contents: [...objects.keys()]
-          .filter((k) => k.startsWith(prefix))
-          .map((key) => ({ key })),
+        contents: [...objects.keys()].filter((k) => k.startsWith(prefix)).map((key) => ({ key })),
       };
     },
   };

package/src/drivers/signal-engine.ts

@@ -10,11 +10,7 @@ import { dirname } from "node:path";
 
 import type { SignalDecl } from "../elements/signal/declare.ts";
 import type { SignalDelivery } from "../manifest/types.ts";
-import {
-  DryRunWriteIsolationError,
-  setDryRunMessageId,
-  withDryRun,
-} from "../kernel/dry-run.ts";
+import { DryRunWriteIsolationError, setDryRunMessageId, withDryRun } from "../kernel/dry-run.ts";
 import type {
   DeadLetter,
   LiveHandler,
@@ -112,10 +108,7 @@ export async function createSignalEngine(
     while (list.length > 50) list.shift();
   }
 
-  function failureFromError(
-    err: unknown,
-    attempt: number,
-  ): SignalFailureReason {
+  function failureFromError(err: unknown, attempt: number): SignalFailureReason {
     const code =
       err &&
       typeof err === "object" &&
@@ -196,11 +189,7 @@ export async function createSignalEngine(
     return decl;
   }
 
-  function stageEmit(
-    stagedMessages: MutMessage[],
-    name: string,
-    payload: unknown,
-  ): void {
+  function stageEmit(stagedMessages: MutMessage[], name: string, payload: unknown): void {
     const decl = requireDecl(name);
     const t = now();
     stagedMessages.push({
@@ -271,10 +260,7 @@ export async function createSignalEngine(
     };
   }
 
-  async function live(
-    signal: string,
-    handler: LiveHandler,
-  ): Promise<SignalUnsubscribe> {
+  async function live(signal: string, handler: LiveHandler): Promise<SignalUnsubscribe> {
     const decl = requireDecl(signal);
     if (decl.delivery !== "live") {
       throw new Error(`signal "${signal}" is not delivery: "live"`);
@@ -313,10 +299,7 @@ export async function createSignalEngine(
   /**
    * Claim the next `once` message with SKIP LOCKED semantics.
    */
-  function claimOnce(
-    signal: string,
-    consumerId: string,
-  ): MutMessage | null {
+  function claimOnce(signal: string, consumerId: string): MutMessage | null {
     const t = now();
     for (const m of messages) {
       if (m.signal !== signal || m.delivery !== "once") continue;
@@ -391,10 +374,7 @@ export async function createSignalEngine(
           subscriberErrors.set(key, (subscriberErrors.get(key) ?? 0) + 1);
         }
       }
-      if (
-        subs.length > 0 &&
-        subs.every((s) => m.deliveredTo.has(s.subscriberId))
-      ) {
+      if (subs.length > 0 && subs.every((s) => m.deliveredTo.has(s.subscriberId))) {
         m.status = "delivered";
       }
     }
@@ -498,21 +478,14 @@ export async function createSignalEngine(
     return out;
   }
 
-  async function replay(
-    options: SignalReplayOptions,
-  ): Promise<SignalReplayResult> {
+  async function replay(options: SignalReplayOptions): Promise<SignalReplayResult> {
     requireDecl(options.signal);
     const rate = Math.max(1, options.ratePerSec);
     const intervalMs = Math.floor(1_000 / rate);
     const ids =
-      options.messageIds && options.messageIds.length > 0
-        ? new Set(options.messageIds)
-        : null;
+      options.messageIds && options.messageIds.length > 0 ? new Set(options.messageIds) : null;
     const targets = messages.filter(
-      (m) =>
-        m.signal === options.signal &&
-        m.status === "dead" &&
-        (ids === null || ids.has(m.id)),
+      (m) => m.signal === options.signal && m.status === "dead" && (ids === null || ids.has(m.id)),
     );
     const results: SignalReplayResult["results"][number][] = [];
     const wouldHaveFired: SignalReplayResult["wouldHaveFired"][number][] = [];
@@ -525,11 +498,7 @@ export async function createSignalEngine(
       }
       const m = targets[i]!;
       // Never mutate stored payload during dry-run — override is view-only.
-      if (
-        !options.dryRun &&
-        options.payloads &&
-        options.payloads[m.id] !== undefined
-      ) {
+      if (!options.dryRun && options.payloads && options.payloads[m.id] !== undefined) {
         m.payload = options.payloads[m.id];
       }
 
@@ -630,18 +599,12 @@ export async function createSignalEngine(
     };
   }
 
-  async function discard(
-    options: SignalDiscardOptions,
-  ): Promise<{ readonly discarded: number }> {
+  async function discard(options: SignalDiscardOptions): Promise<{ readonly discarded: number }> {
     const ids = new Set(options.messageIds);
     let discarded = 0;
     for (let i = messages.length - 1; i >= 0; i--) {
       const m = messages[i]!;
-      if (
-        m.signal === options.signal &&
-        m.status === "dead" &&
-        ids.has(m.id)
-      ) {
+      if (m.signal === options.signal && m.status === "dead" && ids.has(m.id)) {
         messages.splice(i, 1);
         discarded += 1;
       }

package/src/drivers/signal-memory.ts

@@ -3,20 +3,14 @@
  */
 
 import { createSignalEngine } from "./signal-engine.ts";
-import type {
-  SignalBus,
-  SignalDriver,
-  SignalOpenOptions,
-} from "./signal-types.ts";
+import type { SignalBus, SignalDriver, SignalOpenOptions } from "./signal-types.ts";
 
 /**
  * Open an in-memory signal bus.
  *
  * @param options - Declarations / durable path / clock
  */
-export async function openMemorySignal(
-  options: SignalOpenOptions,
-): Promise<SignalBus> {
+export async function openMemorySignal(options: SignalOpenOptions): Promise<SignalBus> {
   return createSignalEngine("memory", options);
 }
 

package/src/drivers/signal-nats.ts

@@ -31,12 +31,10 @@ export function createSignalNatsFake(): SignalNatsClientLike & {
   return {
     published,
     async publish(subject, data) {
-      const text =
-        typeof data === "string" ? data : new TextDecoder().decode(data);
+      const text = typeof data === "string" ? data : new TextDecoder().decode(data);
       published.push({ subject, data: text });
       const list = subs.get(subject) ?? [];
-      const bytes =
-        typeof data === "string" ? new TextEncoder().encode(data) : data;
+      const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
 
       const queued = list.filter((s) => s.queue);
       const plain = list.filter((s) => !s.queue);
@@ -70,9 +68,7 @@ export function createSignalNatsFake(): SignalNatsClientLike & {
  *
  * @param options - Declarations / nats client / durable outbox path
  */
-export async function openNatsSignal(
-  options: SignalOpenOptions,
-): Promise<SignalBus> {
+export async function openNatsSignal(options: SignalOpenOptions): Promise<SignalBus> {
   const nats = options.nats ?? createSignalNatsFake();
   const outbox = await createSignalEngine("nats", options);
 
@@ -111,8 +107,7 @@ export async function openNatsSignal(
         rollback: () => tx.rollback(),
       };
     },
-    subscribe: (signal, subscriberId, handler) =>
-      outbox.subscribe(signal, subscriberId, handler),
+    subscribe: (signal, subscriberId, handler) => outbox.subscribe(signal, subscriberId, handler),
     live: (signal, handler) => outbox.live(signal, handler),
     drain: () => outbox.drain(),
     deadLetters: (s) => outbox.deadLetters(s),