@lunora/testing 1.0.0-alpha.4 → 1.0.0-alpha.40

package/dist/index.d.mts

@@ -141,6 +141,19 @@ type FunctionRegistry = Record<string, RegisteredAction<any, any> | RegisteredMu
 * clearly-throwing stubs for unsupported surfaces.
 */
 interface LunoraTestOptions {
+  /**
+  * Injectable `ctx.env` for every context (query / mutation / action). When
+  * provided, handlers that read `ctx.env.SOME_KEY` (the validated `defineEnv`
+  * surface) see this object. Left unset it stays `undefined` — matching the
+  * optional `ctx.env?` field, so graceful `ctx.env?.KEY` access still yields
+  * `undefined` rather than throwing. Not a throwing stub for exactly that
+  * reason: `env` is designed to be legitimately absent.
+  * @example
+  * ```ts
+  * const t = lunoraTest(schema, { env: { STRIPE_KEY: "sk_test_…" } });
+  * ```
+  */
+  env?: Record<string, unknown>;
   /**
   * Injectable `fetch` implementation for action contexts. When provided,
   * `ctx.fetch` in every `action` (and `withIdentity` views) resolves to this
@@ -171,6 +184,16 @@ interface LunoraTestOptions {
   * ```
   */
   functions?: FunctionRegistry;
+  /**
+  * Fixed value for `ctx.now` (epoch ms) in every context. Production captures
+  * `Date.now()` once per execution; in tests a fixed `now` makes time-dependent
+  * handlers deterministic. Defaults to the wall clock at harness creation.
+  * @example
+  * ```ts
+  * const t = lunoraTest(schema, { now: 1_700_000_000_000 });
+  * ```
+  */
+  now?: number;
 }
 /**
 * The in-memory test harness returned by {@link lunoraTest}. Mirrors the first
@@ -253,6 +276,8 @@ interface TestHarness {
 *
 * **v1 surfaces now supported:**
 *
+* - `ctx.env` (all contexts): inject the validated env via `options.env`; unset it
+* stays `undefined`, matching the optional `ctx.env?` field.
 * - `ctx.fetch` (actions): inject a custom `fetch` via `options.fetch`.
 * - `ctx.scheduler` (mutations + actions): fully functional fake with virtual clock;
 * control via `harness.scheduler.advance(ms)` / `runPending()` / `list()`.

package/dist/index.d.ts

@@ -141,6 +141,19 @@ type FunctionRegistry = Record<string, RegisteredAction<any, any> | RegisteredMu
 * clearly-throwing stubs for unsupported surfaces.
 */
 interface LunoraTestOptions {
+  /**
+  * Injectable `ctx.env` for every context (query / mutation / action). When
+  * provided, handlers that read `ctx.env.SOME_KEY` (the validated `defineEnv`
+  * surface) see this object. Left unset it stays `undefined` — matching the
+  * optional `ctx.env?` field, so graceful `ctx.env?.KEY` access still yields
+  * `undefined` rather than throwing. Not a throwing stub for exactly that
+  * reason: `env` is designed to be legitimately absent.
+  * @example
+  * ```ts
+  * const t = lunoraTest(schema, { env: { STRIPE_KEY: "sk_test_…" } });
+  * ```
+  */
+  env?: Record<string, unknown>;
   /**
   * Injectable `fetch` implementation for action contexts. When provided,
   * `ctx.fetch` in every `action` (and `withIdentity` views) resolves to this
@@ -171,6 +184,16 @@ interface LunoraTestOptions {
   * ```
   */
   functions?: FunctionRegistry;
+  /**
+  * Fixed value for `ctx.now` (epoch ms) in every context. Production captures
+  * `Date.now()` once per execution; in tests a fixed `now` makes time-dependent
+  * handlers deterministic. Defaults to the wall clock at harness creation.
+  * @example
+  * ```ts
+  * const t = lunoraTest(schema, { now: 1_700_000_000_000 });
+  * ```
+  */
+  now?: number;
 }
 /**
 * The in-memory test harness returned by {@link lunoraTest}. Mirrors the first
@@ -253,6 +276,8 @@ interface TestHarness {
 *
 * **v1 surfaces now supported:**
 *
+* - `ctx.env` (all contexts): inject the validated env via `options.env`; unset it
+* stays `undefined`, matching the optional `ctx.env?` field.
 * - `ctx.fetch` (actions): inject a custom `fetch` via `options.fetch`.
 * - `ctx.scheduler` (mutations + actions): fully functional fake with virtual clock;
 * control via `harness.scheduler.advance(ms)` / `runPending()` / `list()`.

package/dist/index.mjs

@@ -1,2 +1,2 @@
-export { lunoraTest } from './packem_shared/lunoraTest-BUg4Ebv8.mjs';
+export { lunoraTest } from './packem_shared/lunoraTest-C0DZz2W9.mjs';
 export { extractLink, listCapturedMail, waitForMail } from '@lunora/mail/testing';

package/dist/packem_shared/{lunoraTest-BUg4Ebv8.mjs → lunoraTest-C0DZz2W9.mjs}

@@ -1,8 +1,9 @@
 import { runShardMigrations, createShardCtxDb } from '@lunora/do';
+import { LunoraError } from '@lunora/errors';
 import { DatabaseSync } from 'node:sqlite';
 
-const createFakeScheduler = (getDispatch, getMutationContext, getFunctionRegistry) => {
-  let nowMs = Date.now();
+const createFakeScheduler = (getDispatch, getMutationContext, getFunctionRegistry, now) => {
+  let nowMs = now;
   let nextId = 1;
   const pending = /* @__PURE__ */ new Map();
   const recordedFailures = [];
@@ -57,7 +58,12 @@ const createFakeScheduler = (getDispatch, getMutationContext, getFunctionRegistr
   const executeDue = async (cutoff) => {
     const due = [...pending.values()].filter((j) => j.scheduledFor <= cutoff).toSorted((a, b) => a.scheduledFor - b.scheduledFor);
     const failed = [];
+    let executed = 0;
     for (const job of due) {
+      if (!pending.has(job.id)) {
+        continue;
+      }
+      executed += 1;
       try {
         await dispatchJob(job);
       } catch (error) {
@@ -66,7 +72,7 @@ const createFakeScheduler = (getDispatch, getMutationContext, getFunctionRegistr
         recordedFailures.push(failure);
       }
     }
-    return { executed: due.length, failed };
+    return { executed, failed };
   };
   const runSweep = async (cutoff, options) => {
     const { executed, failed } = await executeDue(cutoff);
@@ -100,7 +106,7 @@ const createSqlExec = () => {
     return {
       one() {
         if (rows.length !== 1) {
-          throw new Error(`expected exactly one row, received ${String(rows.length)}`);
+          throw new LunoraError("INTERNAL", `expected exactly one row, received ${String(rows.length)}`);
         }
         const [only] = rows;
         return only;
@@ -138,7 +144,7 @@ const registeredFunctionKind = (value) => {
 };
 const registeredFunctionVisibility = (value) => typeof value === "object" && value !== null && value.visibility === "internal" ? "internal" : "public";
 const unavailable = (surface) => {
-  throw new Error(`ctx.${surface} is not available in the in-memory @lunora/testing harness (v1)`);
+  throw new LunoraError("INTERNAL", `ctx.${surface} is not available in the in-memory @lunora/testing harness (v1)`);
 };
 const stubProxy = (surface) => /* @__PURE__ */ new Proxy((..._args) => unavailable(surface), {
   apply: () => unavailable(surface),
@@ -154,8 +160,9 @@ const noopLog = {
 const buildSubscribe = (runRegistered, queryContext, mutationListeners) => {
   const factory = (referenceOrInline, args) => {
     let done = false;
-    let pendingResolve;
+    const pendingWaiters = [];
     let pendingResult;
+    let pendingError;
     let latestSeq = 0;
     let appliedSeq = 0;
     const runQuery = () => {
@@ -170,25 +177,46 @@ const buildSubscribe = (runRegistered, queryContext, mutationListeners) => {
       }
       appliedSeq = seq;
       const iterResult = { done: false, value };
-      if (pendingResolve === void 0) {
+      if (pendingWaiters.length === 0) {
         pendingResult = iterResult;
+        pendingError = void 0;
       } else {
-        const resolve = pendingResolve;
-        pendingResolve = void 0;
         pendingResult = void 0;
-        resolve(iterResult);
+        pendingError = void 0;
+        for (const waiter of pendingWaiters.splice(0)) {
+          waiter.resolve(iterResult);
+        }
+      }
+    };
+    const emitError = (seq, error) => {
+      if (seq < appliedSeq) {
+        return;
+      }
+      appliedSeq = seq;
+      if (pendingWaiters.length === 0) {
+        pendingError = { error };
+        pendingResult = void 0;
+      } else {
+        pendingResult = void 0;
+        pendingError = void 0;
+        for (const waiter of pendingWaiters.splice(0)) {
+          waiter.reject(error);
+        }
       }
     };
     const emitAt = (seq) => (value) => {
       emit(seq, value);
     };
+    const emitErrorAt = (seq) => (error) => {
+      emitError(seq, error);
+    };
     const listener = () => {
       if (done) {
         return;
       }
       latestSeq += 1;
       const seq = latestSeq;
-      runQuery().then(emitAt(seq)).catch(() => void 0);
+      runQuery().then(emitAt(seq)).catch(emitErrorAt(seq));
     };
     mutationListeners.add(listener);
     const iterator = {
@@ -199,17 +227,29 @@ const buildSubscribe = (runRegistered, queryContext, mutationListeners) => {
         if (done) {
           return Promise.resolve({ done: true, value: void 0 });
         }
-        if (pendingResult !== void 0 && appliedSeq === latestSeq) {
-          const result = pendingResult;
-          pendingResult = void 0;
-          return Promise.resolve(result);
+        if (appliedSeq === latestSeq) {
+          if (pendingError !== void 0) {
+            const { error } = pendingError;
+            pendingError = void 0;
+            return Promise.reject(error);
+          }
+          if (pendingResult !== void 0) {
+            const result = pendingResult;
+            pendingResult = void 0;
+            return Promise.resolve(result);
+          }
         }
         if (appliedSeq < latestSeq) {
-          return new Promise((resolve) => {
-            pendingResolve = resolve;
+          return new Promise((resolve, reject) => {
+            pendingWaiters.push({ reject, resolve });
           });
         }
         return runQuery().then((value) => {
+          if (pendingError !== void 0) {
+            const { error } = pendingError;
+            pendingError = void 0;
+            throw error;
+          }
           if (pendingResult !== void 0) {
             const result = pendingResult;
             pendingResult = void 0;
@@ -221,15 +261,13 @@ const buildSubscribe = (runRegistered, queryContext, mutationListeners) => {
       return: () => {
         done = true;
         mutationListeners.delete(listener);
-        if (pendingResolve !== void 0) {
-          const resolve = pendingResolve;
-          pendingResolve = void 0;
-          resolve({ done: true, value: void 0 });
+        for (const waiter of pendingWaiters.splice(0)) {
+          waiter.resolve({ done: true, value: void 0 });
         }
         return Promise.resolve({ done: true, value: void 0 });
       }
     };
-    runQuery().then(emitAt(0)).catch(() => void 0);
+    runQuery().then(emitAt(0)).catch(emitErrorAt(0));
     return iterator;
   };
   return factory;
@@ -243,26 +281,28 @@ const lunoraTest = (schema, options) => {
     const runner = sql.exec;
     runner.call(sql, statement);
   };
-  let transactionDepth = 0;
-  const runInMutationTransaction = async (function_) => {
-    if (transactionDepth > 0) {
-      return function_();
-    }
-    transactionDepth = 1;
-    execStatement("BEGIN");
-    try {
-      const result = await function_();
-      execStatement("COMMIT");
-      return result;
-    } catch (error) {
+  let mutationQueue = Promise.resolve();
+  const runInMutationTransaction = (function_) => {
+    const runTransaction = async () => {
+      execStatement("BEGIN");
       try {
-        execStatement("ROLLBACK");
-      } catch {
+        const result2 = await function_();
+        execStatement("COMMIT");
+        return result2;
+      } catch (error) {
+        try {
+          execStatement("ROLLBACK");
+        } catch {
+        }
+        throw error;
       }
-      throw error;
-    } finally {
-      transactionDepth = 0;
-    }
+    };
+    const result = mutationQueue.then(runTransaction);
+    mutationQueue = result.then(
+      () => void 0,
+      () => void 0
+    );
+    return result;
   };
   let closed = false;
   const closeDatabase = () => {
@@ -283,20 +323,28 @@ const lunoraTest = (schema, options) => {
   };
   let scheduledDispatchRef;
   let mutationContextRef;
+  const harnessNow = options?.now ?? Date.now();
   const { controls: schedulerControls, scheduler: fakeScheduler } = createFakeScheduler(
     () => {
       if (scheduledDispatchRef === void 0) {
-        throw new Error("[fake-scheduler] dispatch not yet available — scheduler.advance called before harness construction completed");
+        throw new LunoraError(
+          "INTERNAL",
+          "[fake-scheduler] dispatch not yet available — scheduler.advance called before harness construction completed"
+        );
       }
       return scheduledDispatchRef;
     },
     () => {
       if (mutationContextRef === void 0) {
-        throw new Error("[fake-scheduler] mutationContext not yet available — scheduler.advance called before harness construction completed");
+        throw new LunoraError(
+          "INTERNAL",
+          "[fake-scheduler] mutationContext not yet available — scheduler.advance called before harness construction completed"
+        );
       }
       return mutationContextRef;
     },
-    () => functionRegistryMap
+    () => functionRegistryMap,
+    harnessNow
   );
   const makeHarness = (identity) => {
     const auth = {
@@ -308,21 +356,27 @@ const lunoraTest = (schema, options) => {
     const queryContext = {
       auth,
       db: database,
+      env: options?.env,
       log: noopLog,
+      now: harnessNow,
       // eslint-disable-next-line @typescript-eslint/no-use-before-define -- lazy closure: `runInternal` is invoked only when a handler calls ctx.runQuery, after construction completes
       runQuery: (reference, args) => runInternal("query", reference, queryContext, args),
+      secrets: stubProxy("secrets"),
       storage: stubProxy("storage"),
       vectors: stubProxy("vectors")
     };
     const mutationContext = {
       auth,
       db: database,
+      env: options?.env,
       log: noopLog,
+      now: harnessNow,
       // eslint-disable-next-line @typescript-eslint/no-use-before-define -- lazy closure: `runInternal` is invoked only when a handler calls ctx.runMutation, after construction completes
       runMutation: (reference, args) => runInternal("mutation", reference, mutationContext, args),
       // eslint-disable-next-line @typescript-eslint/no-use-before-define -- lazy closure: `runInternal` is invoked only when a handler calls ctx.runQuery, after construction completes
       runQuery: (reference, args) => runInternal("query", reference, queryContext, args),
       scheduler: fakeScheduler,
+      secrets: stubProxy("secrets"),
       storage: stubProxy("storage"),
       vectors: stubProxy("vectors"),
       workflows: stubProxy("workflows")
@@ -331,9 +385,11 @@ const lunoraTest = (schema, options) => {
     const actionContext = {
       auth,
       db: database,
+      env: options?.env,
       // Use the injected fetch when provided; fall back to the v1 stub otherwise.
       fetch: options?.fetch ?? stubProxy("fetch"),
       log: noopLog,
+      now: harnessNow,
       // eslint-disable-next-line @typescript-eslint/no-use-before-define -- lazy closure: `runInternal` is invoked only when a handler calls ctx.runAction, after construction completes
       runAction: (reference, args) => runInternal("action", reference, actionContext, args),
       // eslint-disable-next-line @typescript-eslint/no-use-before-define -- lazy closure: `runInternal` is invoked only when a handler calls ctx.runMutation, after construction completes
@@ -341,6 +397,7 @@ const lunoraTest = (schema, options) => {
       // eslint-disable-next-line @typescript-eslint/no-use-before-define -- lazy closure: `runInternal` is invoked only when a handler calls ctx.runQuery, after construction completes
       runQuery: (reference, args) => runInternal("query", reference, queryContext, args),
       scheduler: fakeScheduler,
+      secrets: stubProxy("secrets"),
       storage: stubProxy("storage"),
       vectors: stubProxy("vectors"),
       workflows: stubProxy("workflows")
@@ -348,11 +405,12 @@ const lunoraTest = (schema, options) => {
     const runRegistered = (expected, reference, context, args, allowInternal) => {
       const kind = registeredFunctionKind(reference);
       if (kind !== expected) {
-        throw new Error(`expected a registered ${expected}, received a ${kind ?? "non-function"} reference`);
+        throw new LunoraError("INTERNAL", `expected a registered ${expected}, received a ${kind ?? "non-function"} reference`);
       }
       if (!allowInternal && registeredFunctionVisibility(reference) === "internal") {
-        throw new Error(
-          `"${expected}" is an internal function — it is unreachable from the external RPC boundary in production. Call it through ctx.run${expected.charAt(0).toUpperCase()}${expected.slice(1)} from another function instead.`
+        throw new LunoraError(
+          "INTERNAL",
+          `This ${expected} is an internal function — it is unreachable from the external RPC boundary in production. Call it through ctx.run${expected.charAt(0).toUpperCase()}${expected.slice(1)} from another function instead.`
         );
       }
       return Promise.resolve(reference.handler(context, args ?? {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/testing",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.40",
   "description": "Testing toolkit for Lunora: an in-memory harness for queries, mutations, and actions",
   "keywords": [
     "cloudflare",
@@ -25,7 +25,7 @@
     "directory": "packages/testing"
   },
   "files": [
-    "dist",
+    "./dist",
     "README.md",
     "LICENSE.md",
     "__assets__"
@@ -46,9 +46,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/do": "1.0.0-alpha.4",
-    "@lunora/mail": "1.0.0-alpha.1",
-    "@lunora/server": "1.0.0-alpha.1"
+    "@lunora/do": "1.0.0-alpha.28",
+    "@lunora/errors": "1.0.0-alpha.4",
+    "@lunora/mail": "1.0.0-alpha.14",
+    "@lunora/server": "1.0.0-alpha.23"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"