@lunora/testing 1.0.0-alpha.27 → 1.0.0-alpha.28

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

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

@@ -316,6 +316,7 @@ 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
@@ -327,6 +328,7 @@ const lunoraTest = (schema, options) => {
     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
@@ -343,6 +345,7 @@ 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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/testing",
-  "version": "1.0.0-alpha.27",
+  "version": "1.0.0-alpha.28",
   "description": "Testing toolkit for Lunora: an in-memory harness for queries, mutations, and actions",
   "keywords": [
     "cloudflare",
@@ -46,10 +46,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/do": "1.0.0-alpha.22",
+    "@lunora/do": "1.0.0-alpha.23",
     "@lunora/errors": "1.0.0-alpha.1",
     "@lunora/mail": "1.0.0-alpha.6",
-    "@lunora/server": "1.0.0-alpha.15"
+    "@lunora/server": "1.0.0-alpha.16"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"