@lunora/testing 1.0.0-alpha.3 → 1.0.0-alpha.30

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-DO9gV_fa.mjs';
 export { extractLink, listCapturedMail, waitForMail } from '@lunora/mail/testing';

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

@@ -1,4 +1,5 @@
 import { runShardMigrations, createShardCtxDb } from '@lunora/do';
+import { LunoraError } from '@lunora/errors';
 import { DatabaseSync } from 'node:sqlite';
 
 const createFakeScheduler = (getDispatch, getMutationContext, getFunctionRegistry) => {
@@ -100,7 +101,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 +139,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),
@@ -286,18 +287,25 @@ const lunoraTest = (schema, options) => {
   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
   );
+  const harnessNow = options?.now ?? Date.now();
   const makeHarness = (identity) => {
     const auth = {
       // eslint-disable-next-line unicorn/no-null -- AuthState.getIdentity's anonymous sentinel is `null` (mirrors a decoded JWT being absent)
@@ -308,21 +316,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 +345,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 +357,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,10 +365,11 @@ 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(
+        throw new LunoraError(
+          "INTERNAL",
           `"${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.`
         );
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/testing",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-alpha.30",
   "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.3",
-    "@lunora/mail": "1.0.0-alpha.1",
-    "@lunora/server": "1.0.0-alpha.1"
+    "@lunora/do": "1.0.0-alpha.23",
+    "@lunora/errors": "1.0.0-alpha.1",
+    "@lunora/mail": "1.0.0-alpha.8",
+    "@lunora/server": "1.0.0-alpha.16"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"