@lunora/testing 1.0.0-alpha.54 → 1.0.0-alpha.56

package/dist/index.mjs

@@ -1,5 +1 @@
-export { agentHarness, finalTurn, toolCallTurn } from './packem_shared/agentHarness-GTPhWdQ8.mjs';
-export { evaluationAttributes, recordEvaluation } from './packem_shared/evaluationAttributes-C08Q5MOX.mjs';
-export { lunoraTest } from './packem_shared/lunoraTest-Dv_w_v9z.mjs';
-export { containsScorer, evaluate, exactMatchScorer, keywordScorer, llmScorer, regexScorer, scoreSample } from './packem_shared/containsScorer-DGwtvUNp.mjs';
-export { extractLink, listCapturedMail, waitForMail } from '@lunora/mail/testing';
+import{agentHarness as o,finalTurn as t,toolCallTurn as a}from"./packem_shared/agentHarness-0b923YYC.mjs";import{evaluationAttributes as c,recordEvaluation as n}from"./packem_shared/evaluationAttributes-GZvtFa1N.mjs";import{lunoraTest as u}from"./packem_shared/lunoraTest-BAkd1qwt.mjs";import{containsScorer as m,evaluate as p,exactMatchScorer as s,keywordScorer as f,llmScorer as S,regexScorer as d,scoreSample as v}from"./packem_shared/containsScorer-Dr5tjL-M.mjs";import{extractLink as T,listCapturedMail as g,waitForMail as k}from"@lunora/mail/testing";export{o as agentHarness,m as containsScorer,p as evaluate,c as evaluationAttributes,s as exactMatchScorer,T as extractLink,t as finalTurn,f as keywordScorer,g as listCapturedMail,S as llmScorer,u as lunoraTest,n as recordEvaluation,d as regexScorer,v as scoreSample,a as toolCallTurn,k as waitForMail};

package/dist/packem_shared/agentHarness-0b923YYC.mjs

@@ -0,0 +1 @@
+import{runAgentLoop as w,DEFAULT_AGENT_FUNCTION_PATHS as g}from"@lunora/agent";const y=o=>{const e=[...o];return()=>{const a=e.shift();if(!a)throw new Error("agentHarness: scripted generate exhausted — the run took more turns than the script provided.");return Promise.resolve(a)}};class v{invoked=[];entries=new Map;async do(e,a){const i=this.entries.get(e);if(i)return i.output;this.invoked.push(e);const u=await a();return this.entries.set(e,{output:u}),u}async waitForEvent(e,a){return new Promise(()=>{})}}const T=o=>{const e=new Map,a=new Map,i=[],u=t=>{const s=t?.key,r=t?.instanceId,n=e.get(s);return n?(n.status="running",delete n.error,r!==void 0&&(n.instanceId=r),{created:!1}):(e.set(s,{agent:t?.agent,instanceId:r,key:s,messageCount:0,owner:t?.owner,status:"running",title:t?.title}),{created:!0})},p=t=>{const s=t?.threadKey,r=t?.messageKey,n=`${s}:${r}`,f=a.get(n);if(f)return{seq:f.seq};const l=e.get(s);if(!l)throw new Error(`agentHarness: append to unknown thread "${s}".`);const m=l.messageCount;return l.messageCount+=1,a.set(n,{...t,seq:m}),{seq:m}},h=t=>{const s=t?.key;return[...a.values()].filter(r=>r.threadKey===s).toSorted((r,n)=>r.seq-n.seq)},d=t=>{const s=e.get(t?.key);if(s)for(const[r,n]of Object.entries(t??{}))r!=="key"&&n!==void 0&&(s[r]=n)},c=new Map([[g.appendMessage,p],[g.ensureThread,u],[g.listMessages,h],[g.patchThread,d],...Object.entries(o)]);return{dispatches:i,messages:a,run:(t,s)=>{const r=t.__lunoraRef;i.push({args:s,path:r});const n=c.get(r);if(!n)throw new Error(`agentHarness: unstubbed dispatch "${r}" — pass a \`functions\` handler for it.`);return Promise.resolve(n(s))},threads:e}},q=(o,e)=>{const a=e.exportName??"agent",i=e.env??{LUNORA_TEST:!0},u=T(e.functions??{});let p=0;const h=(d,c)=>{p+=1;const t=c?.instanceId??`wf-${String(p)}`,s=c?.script??e.script;return w({agent:o,env:i,exportName:a,generate:y(s),instanceId:t,params:d,paths:g,run:u.run,step:new v})};return{dispatches:u.dispatches,messages:d=>[...u.messages.values()].filter(c=>c.threadKey===d).toSorted((c,t)=>c.seq-t.seq).map(({messageKey:c,threadKey:t,...s})=>s),run:h,thread:d=>u.threads.get(d)}},C=(o,e)=>({text:o,toolCalls:[],...e}),E=(o,e,a,i="")=>({text:i,toolCalls:[{id:o,input:a,name:e}]});export{q as agentHarness,C as finalTurn,E as toolCallTurn};

package/dist/packem_shared/containsScorer-Dr5tjL-M.mjs

@@ -0,0 +1,2 @@
+import{LunoraError as p}from"@lunora/errors";const d=/^\s*(-?\d+(?:\.\d+)?)/u,i=e=>Number.isFinite(e)?Math.min(1,Math.max(0,e)):0,l=e=>typeof e=="number"?{score:i(e)}:{score:i(e.score),...e.reason===void 0?{}:{reason:e.reason}},u=e=>e.length===0?0:e.reduce((t,r)=>t+r,0)/e.length,v=(e,t={})=>({name:`contains:${e}`,score:({output:r})=>{const s=t.caseSensitive?r:r.toLowerCase(),a=t.caseSensitive?e:e.toLowerCase();return s.includes(a)?1:0}}),x=(e,t="regex")=>({name:t,score:({output:r})=>e.test(r)?1:0}),y=()=>({name:"exact-match",score:({expected:e,output:t})=>t.trim()===e?.trim()?1:0}),f=e=>{if(e.length===0)throw new p("BAD_REQUEST","@lunora/testing: keywordScorer requires at least one keyword");return{name:"keyword-coverage",score:({output:t})=>{const r=t.toLowerCase(),s=e.filter(a=>r.includes(a.toLowerCase())).length;return{reason:`${String(s)}/${String(e.length)} keywords present`,score:s/e.length}}}},g=(e,t)=>[`Rate the ASSISTANT OUTPUT against this criterion: ${e}`,"Respond with a single number from 0 (fails) to 1 (fully meets), then a dash and a one-line reason.",...t.input===void 0?[]:["",`Input: ${t.input}`],...t.expected===void 0?[]:["",`Reference answer: ${t.expected}`],"",`Assistant output: ${t.output}`].join(`
+`),w=e=>{const t=d.exec(e);return{reason:e.trim(),score:t?i(Number(t[1])):0}},$=e=>({name:e.name??"llm-judge",score:async t=>w(await e.judge(g(e.criteria,t)))}),h=async(e,t)=>{const r=await Promise.all(t.map(async o=>({name:o.name,result:l(await o.score(e))}))),s={},a=new Map;for(const{name:o,result:c}of r){const n=a.get(o)??0;a.set(o,n+1),s[n===0?o:`${o}#${String(n+1)}`]=c}return{average:u(r.map(({result:o})=>o.score)),scores:s}},b=async(e,t,r)=>{const s=await Promise.all(e.map(async a=>{const o=await t(a.input),c={input:a.input,output:o,...a.expected===void 0?{}:{expected:a.expected},...a.metadata===void 0?{}:{metadata:a.metadata}},{average:n,scores:m}=await h(c,r);return{average:n,input:a.input,output:o,scores:m}}));return{average:u(s.map(a=>a.average)),items:s}};export{v as containsScorer,b as evaluate,y as exactMatchScorer,f as keywordScorer,$ as llmScorer,x as regexScorer,h as scoreSample};

package/dist/packem_shared/evaluationAttributes-GZvtFa1N.mjs

@@ -0,0 +1 @@
+import{LunoraError as o}from"@lunora/errors";const a=/[\w.-]/u,t=e=>{let r="";for(const n of e)r+=a.test(n)?n:"_";return r},i=e=>{if(typeof e.name!="string"||e.name.length===0)throw new o("BAD_REQUEST","@lunora/testing: recordEvaluation requires a non-empty `name`");if(typeof e.score!="number"||!Number.isFinite(e.score))throw new o("BAD_REQUEST","@lunora/testing: recordEvaluation `score` must be a finite number");const r=t(e.name),n={[`gen_ai.evaluation.${r}.score`]:e.score};return e.label!==void 0&&(n[`gen_ai.evaluation.${r}.label`]=e.label),n},u=e=>{const r=i(e);return e.span?.setAttributes(r),r};export{i as evaluationAttributes,u as recordEvaluation};

package/dist/packem_shared/lunoraTest-BAkd1qwt.mjs

@@ -0,0 +1 @@
+import{runShardMigrations as z,createShardCtxDb as G}from"@lunora/do";import{LunoraError as j}from"@lunora/errors";import{DatabaseSync as H}from"node:sqlite";const K=(c,a,f,v,I)=>{let w=I,m=1;const i=new Map,u=[],p=(t,o,l={})=>{const e=`fake-job-${String(m)}`;return m+=1,i.set(e,{args:l,enqueuedAt:w,functionPath:o,id:e,scheduledFor:t}),e},y=t=>typeof t=="string"?t:t.name??t.binding??"",x={cancel:t=>{const o=i.has(t);return i.delete(t),Promise.resolve({cancelled:o})},get:t=>Promise.resolve(i.get(t)??null),list:()=>Promise.resolve([...i.values()]),runAfter:(t,o,l)=>{const e=p(w+t,y(o),l);return Promise.resolve(e)},runAt:(t,o,l)=>{const e=p(t,y(o),l);return Promise.resolve(e)}},q=async t=>{i.delete(t.id);const o=v().get(t.functionPath);if(o===void 0){console.warn(`[fake-scheduler] unknown functionPath "${t.functionPath}" — job ${t.id} dropped`);return}if(o.kind==="mutation"||o.kind==="action"){const l=c(),e=o.kind==="action"?f():a();await l(o.kind,o,e,t.args)}else console.warn(`[fake-scheduler] functionPath "${t.functionPath}" is a ${o.kind} — only mutations and actions can be scheduled; job ${t.id} dropped`)},N=async t=>{const o=[...i.values()].filter(n=>n.scheduledFor<=t).toSorted((n,d)=>n.scheduledFor-d.scheduledFor),l=[];let e=0;for(const n of o)if(i.has(n.id)){e+=1;try{await q(n)}catch(d){const h={args:n.args,error:d,functionPath:n.functionPath,id:n.id};l.push(h),u.push(h)}}return{executed:e,failed:l}},k=async(t,o)=>{const{executed:l,failed:e}=await N(t);if(e.length>0&&(o?.throwOnError??!0)){const[n]=e;throw e.length===1&&n!==void 0?n.error:new AggregateError(e.map(d=>d.error),`${String(e.length)} scheduled jobs failed: ${e.map(d=>d.functionPath).join(", ")}`)}return l};return{controls:{advance:(t,o)=>(w+=t,k(w,o)),failures:()=>[...u],list:()=>[...i.values()],runPending:t=>k(Number.POSITIVE_INFINITY,t)},scheduler:x}},U=()=>{const c=new H(":memory:"),a=f=>({one(){if(f.length!==1)throw new j("INTERNAL",`expected exactly one row, received ${String(f.length)}`);const[v]=f;return v},[Symbol.iterator](){return f[Symbol.iterator]()},toArray(){return f}});return{close:()=>{c.close()},sql:{exec:(f,...v)=>{const I=c.prepare(f).all(...v);return a(I)}}}},R=c=>{if(typeof c!="object"||c===null)return;const{kind:a}=c;if(a==="query"||a==="mutation"||a==="action")return a},W=c=>typeof c=="object"&&c!==null&&c.visibility==="internal"?"internal":"public",O=c=>{throw new j("INTERNAL",`ctx.${c} is not available in the in-memory @lunora/testing harness (v1)`)},g=c=>new Proxy((...a)=>O(c),{apply:()=>O(c),get:()=>O(c)}),X={setAttribute:()=>{},setAttributes:()=>{}},C=async(c,a)=>await a(C,X),Q={count:()=>{},gauge:()=>{},record:()=>{}},M={debug:()=>{},error:()=>{},fatal:()=>{},info:()=>{},log:()=>{},trace:()=>{},warn:()=>{},with:()=>M},Z=(c,a,f)=>(v,I)=>{let w=!1;const m=[];let i,u,p=0,y=0;const x=()=>R(v)?c("query",v,a,I,!1):Promise.resolve(v(a)),q=(e,n)=>{if(e<y)return;y=e;const d={done:!1,value:n};if(m.length===0)i=d,u=void 0;else{i=void 0,u=void 0;for(const h of m.splice(0))h.resolve(d)}},N=(e,n)=>{if(!(e<y))if(y=e,m.length===0)u={error:n},i=void 0;else{i=void 0,u=void 0;for(const d of m.splice(0))d.reject(n)}},k=e=>n=>{q(e,n)},t=e=>n=>{N(e,n)},o=()=>{if(w)return;p+=1;const e=p;x().then(k(e)).catch(t(e))};f.add(o);const l={[Symbol.asyncIterator](){return l},next:()=>{if(w)return Promise.resolve({done:!0,value:void 0});if(y===p){if(u!==void 0){const{error:e}=u;return u=void 0,Promise.reject(e)}if(i!==void 0){const e=i;return i=void 0,Promise.resolve(e)}}return y<p?new Promise((e,n)=>{m.push({reject:n,resolve:e})}):x().then(e=>{if(u!==void 0){const{error:n}=u;throw u=void 0,n}if(i!==void 0){const n=i;return i=void 0,n}return{done:!1,value:e}})},return:()=>{w=!0,f.delete(o);for(const e of m.splice(0))e.resolve({done:!0,value:void 0});return Promise.resolve({done:!0,value:void 0})}};return x().then(k(0)).catch(t(0)),l},re=(c,a)=>{const{close:f,sql:v}=U(),I=c;z(v,I);const w=G({schema:I,sql:v}),m=h=>{v.exec.call(v,h)};let i=Promise.resolve();const u=h=>{const $=async()=>{m("BEGIN");try{const b=await h();return m("COMMIT"),b}catch(b){try{m("ROLLBACK")}catch{}throw b}},A=i.then($);return i=A.then(()=>{},()=>{}),A};let p=!1;const y=()=>{p||(p=!0,f())},x=new Map(Object.entries(a?.functions??{}).map(([h,$])=>[h,$])),q=new Set,N=()=>{for(const h of q)h()};let k,t,o;const l=a?.now??Date.now(),{controls:e,scheduler:n}=K(()=>{if(k===void 0)throw new j("INTERNAL","[fake-scheduler] dispatch not yet available — scheduler.advance called before harness construction completed");return k},()=>{if(t===void 0)throw new j("INTERNAL","[fake-scheduler] mutationContext not yet available — scheduler.advance called before harness construction completed");return t},()=>{if(o===void 0)throw new j("INTERNAL","[fake-scheduler] actionContext not yet available — scheduler.advance called before harness construction completed");return o},()=>x,l),d=h=>{const $={getIdentity:()=>Promise.resolve(h??null),userId:h?.userId??null},A={auth:$,db:w,env:a?.env,log:M,metrics:Q,now:l,trace:C,runQuery:(r,s)=>S("query",r,A,s),secrets:g("secrets"),storage:g("storage"),vectors:g("vectors")},b={auth:$,db:w,env:a?.env,log:M,metrics:Q,now:l,trace:C,runMutation:(r,s)=>S("mutation",r,b,s),runQuery:(r,s)=>S("query",r,A,s),scheduler:n,secrets:g("secrets"),storage:g("storage"),vectors:g("vectors"),workflows:g("workflows")};t??=b;const T={auth:$,db:w,env:a?.env,fetch:a?.fetch??g("fetch"),log:M,metrics:Q,now:l,trace:C,runAction:(r,s)=>S("action",r,T,s),runMutation:(r,s)=>S("mutation",r,b,s),runQuery:(r,s)=>S("query",r,A,s),scheduler:n,secrets:g("secrets"),storage:g("storage"),vectors:g("vectors"),workflows:g("workflows")};o??=T;const E=(r,s,P,L,F)=>{const D=R(s);if(D!==r)throw new j("INTERNAL",`expected a registered ${r}, received a ${D??"non-function"} reference`);if(!F&&W(s)==="internal")throw new j("INTERNAL",`This ${r} is an internal function — it is unreachable from the external RPC boundary in production. Call it through ctx.run${r.charAt(0).toUpperCase()}${r.slice(1)} from another function instead.`);return Promise.resolve(s.handler(P,L??{}))},S=(r,s,P,L)=>E(r,s,P,L,!0);k??=(r,s,P,L)=>r==="mutation"?u(()=>E("mutation",s,P,L,!0)).then(F=>(N(),F)):S("action",s,P,L);const B=((r,s)=>R(r)?E("query",r,A,s,!1):Promise.resolve(r(A))),V=((r,s)=>R(r)?u(()=>E("mutation",r,b,s,!1)).then(P=>(N(),P)):u(()=>r(b)).then(P=>(N(),P))),Y=((r,s)=>R(r)?E("action",r,T,s,!1):Promise.resolve(r(T))),_=Z(E,A,q);return{action:Y,close:y,mutation:V,query:B,run:r=>u(()=>r(b)).then(s=>(N(),s)),scheduler:e,subscribe:_,withIdentity:r=>d(r)}};return d(null)};export{re as lunoraTest};

package/dist/playwright.d.mts

@@ -0,0 +1,126 @@
+/**
+ * A Playwright test double for Lunora's browser wire protocol.
+ *
+ * An e2e suite for a Lunora app needs the app's data layer to behave — live
+ * queries resolve, shapes replicate, mutations ack and echo a watermark — without
+ * standing up a worker and a Durable Object per test. Doing that by hand means
+ * reimplementing the protocol from the outside: `page.route` on `/_lunora/rpc`, a
+ * `page.routeWebSocket` server that answers `subscribe` with `data` frames and
+ * `shape_subscribe` with a `pokeStart`/`pokePart`/`pokeEnd` triple, per-client
+ * watermark bookkeeping so optimistic overlays clear, and re-entrancy cleanup so a
+ * stacked handler from a previous `page.reload()` doesn't keep an old row store
+ * alive. Every adopter needs it, and every adopter gets the watermark bookkeeping
+ * subtly wrong — which then looks like a bug in Lunora.
+ *
+ * So it ships here, and doubles as an executable spec of the protocol.
+ *
+ * ```ts
+ * const lunora = await mockLunora(page, {
+ *     rows: { nodes: [{ _id: "n1", text: "hello", userId: "u1" }] },
+ *     shapes: { wholeOutline: { tables: ["nodes"] } },
+ * });
+ *
+ * await page.goto("/");
+ * await expect(page.getByText("hello")).toBeVisible();
+ *
+ * // Drive the server side from the test.
+ * await lunora.insert("nodes", { _id: "n2", text: "world", userId: "u1" });
+ * await expect(page.getByText("world")).toBeVisible();
+ *
+ * // Reproduce the failure modes that are otherwise impossible to hit on purpose.
+ * lunora.suppressPokes();          // a dropped poke → the client's checkpoint fallback
+ * lunora.failWrites("CONFLICT");   // a rejected mutation → rollback + error UI
+ * ```
+ *
+ * `@playwright/test` is a peer dependency and is imported **type-only**, so this
+ * module adds no runtime dependency for a project that never uses it.
+ */
+/** The Playwright surface this double drives — declared structurally so the import stays type-only. */
+interface MockablePage {
+  route: (url: string, handler: (route: MockRoute) => Promise<void> | void) => Promise<void>;
+  routeWebSocket: (url: RegExp | string, handler: (ws: MockWebSocketRoute) => void) => Promise<void>;
+  unroute: (url: string) => Promise<void>;
+  unrouteAll?: () => Promise<void>;
+}
+/** The slice of Playwright's `Route` used to answer an RPC POST. */
+interface MockRoute {
+  fulfill: (response: {
+    body?: string;
+    contentType?: string;
+    status?: number;
+  }) => Promise<void>;
+  request: () => {
+    headers: () => Record<string, string>;
+    postData: () => null | string;
+  };
+}
+/** The slice of Playwright's `WebSocketRoute` used to serve frames. */
+interface MockWebSocketRoute {
+  onMessage: (handler: (message: string) => void) => void;
+  send: (message: string) => void;
+}
+/** A replicated row. `_id` is the key the client indexes by. */
+type MockRow = Record<string, unknown> & {
+  _id: string;
+};
+/** How a mocked shape selects rows from the seeded store. */
+interface MockShape {
+  /** Tables whose rows this shape replicates. */
+  tables: ReadonlyArray<string>;
+  /**
+   * Narrow the shape to rows matching every entry. Values are compared with
+   * `===`, which covers the partition-selector case (`{ userId: "u1" }`).
+   */
+  where?: Record<string, unknown>;
+}
+/** Options for {@link mockLunora}. */
+interface MockLunoraOptions {
+  /**
+   * Answers for non-mutator RPC calls, keyed by `namespace:fn`. A value may be a
+   * function of the call's args. Unlisted paths resolve to `undefined` — enough for a
+   * fire-and-forget mutation, and loud enough in a test that reads the result.
+   */
+  functions?: Record<string, unknown>;
+  /** Base path the app talks to. Defaults to `/_lunora`. */
+  path?: string;
+  /** Seeded rows per table. */
+  rows?: Record<string, ReadonlyArray<MockRow>>;
+  /** Shapes the app subscribes to, keyed by `defineShape` export name. */
+  shapes?: Record<string, MockShape>;
+}
+/** The handle {@link mockLunora} returns — drive the server side from the test. */
+interface MockLunora {
+  /** Stop answering `/_lunora/*`. Also called implicitly by a later `mockLunora` on the same page. */
+  dispose: () => Promise<void>;
+  /** Reject every subsequent mutation/mutator call with `code`. Pass `false` to stop. */
+  failWrites: (code: false | string) => void;
+  /** Insert (or replace) a row and poke every shape that now matches it. */
+  insert: (table: string, row: MockRow) => Promise<void>;
+  /** Patch a row and poke the shapes replicating it. */
+  patch: (table: string, id: string, patch: Record<string, unknown>) => Promise<void>;
+  /** Delete a row and poke the shapes replicating it. */
+  remove: (table: string, id: string) => Promise<void>;
+  /** Re-send every subscribed shape's full rowset — what a reconnect would do. */
+  resync: () => Promise<void>;
+  /** Current server-side rows for `table`. */
+  rows: (table: string) => MockRow[];
+  /**
+   * Stop sending pokes while still accepting writes — the dropped-poke failure
+   * mode. Writes still ack and advance the watermark, so this exercises the
+   * client's checkpoint fallback rather than a dead connection. Pass `false` to
+   * resume (which does NOT replay the missed pokes; call `resync()` for that).
+   */
+  suppressPokes: (suppressed?: boolean) => void;
+  /** Highest `clientSeq` acked, per client id — the watermark the client is gating overlays on. */
+  watermarks: () => Record<string, number>;
+}
+/**
+ * Install the double on `page`. Returns a handle for driving the server side.
+ *
+ * Idempotent per page: calling it again disposes the previous installation first.
+ * That matters more than it sounds — a stacked `routeWebSocket` handler from before
+ * a `page.reload()` keeps serving from its own closed-over row store, so the app
+ * silently reads stale data and the test fails somewhere unrelated.
+ */
+declare const mockLunora: (page: MockablePage, options?: MockLunoraOptions) => Promise<MockLunora>;
+export { type MockLunora, type MockLunoraOptions, type MockRoute, type MockRow, type MockShape, type MockWebSocketRoute, type MockablePage, mockLunora };

package/dist/playwright.d.ts

@@ -0,0 +1,126 @@
+/**
+ * A Playwright test double for Lunora's browser wire protocol.
+ *
+ * An e2e suite for a Lunora app needs the app's data layer to behave — live
+ * queries resolve, shapes replicate, mutations ack and echo a watermark — without
+ * standing up a worker and a Durable Object per test. Doing that by hand means
+ * reimplementing the protocol from the outside: `page.route` on `/_lunora/rpc`, a
+ * `page.routeWebSocket` server that answers `subscribe` with `data` frames and
+ * `shape_subscribe` with a `pokeStart`/`pokePart`/`pokeEnd` triple, per-client
+ * watermark bookkeeping so optimistic overlays clear, and re-entrancy cleanup so a
+ * stacked handler from a previous `page.reload()` doesn't keep an old row store
+ * alive. Every adopter needs it, and every adopter gets the watermark bookkeeping
+ * subtly wrong — which then looks like a bug in Lunora.
+ *
+ * So it ships here, and doubles as an executable spec of the protocol.
+ *
+ * ```ts
+ * const lunora = await mockLunora(page, {
+ *     rows: { nodes: [{ _id: "n1", text: "hello", userId: "u1" }] },
+ *     shapes: { wholeOutline: { tables: ["nodes"] } },
+ * });
+ *
+ * await page.goto("/");
+ * await expect(page.getByText("hello")).toBeVisible();
+ *
+ * // Drive the server side from the test.
+ * await lunora.insert("nodes", { _id: "n2", text: "world", userId: "u1" });
+ * await expect(page.getByText("world")).toBeVisible();
+ *
+ * // Reproduce the failure modes that are otherwise impossible to hit on purpose.
+ * lunora.suppressPokes();          // a dropped poke → the client's checkpoint fallback
+ * lunora.failWrites("CONFLICT");   // a rejected mutation → rollback + error UI
+ * ```
+ *
+ * `@playwright/test` is a peer dependency and is imported **type-only**, so this
+ * module adds no runtime dependency for a project that never uses it.
+ */
+/** The Playwright surface this double drives — declared structurally so the import stays type-only. */
+interface MockablePage {
+  route: (url: string, handler: (route: MockRoute) => Promise<void> | void) => Promise<void>;
+  routeWebSocket: (url: RegExp | string, handler: (ws: MockWebSocketRoute) => void) => Promise<void>;
+  unroute: (url: string) => Promise<void>;
+  unrouteAll?: () => Promise<void>;
+}
+/** The slice of Playwright's `Route` used to answer an RPC POST. */
+interface MockRoute {
+  fulfill: (response: {
+    body?: string;
+    contentType?: string;
+    status?: number;
+  }) => Promise<void>;
+  request: () => {
+    headers: () => Record<string, string>;
+    postData: () => null | string;
+  };
+}
+/** The slice of Playwright's `WebSocketRoute` used to serve frames. */
+interface MockWebSocketRoute {
+  onMessage: (handler: (message: string) => void) => void;
+  send: (message: string) => void;
+}
+/** A replicated row. `_id` is the key the client indexes by. */
+type MockRow = Record<string, unknown> & {
+  _id: string;
+};
+/** How a mocked shape selects rows from the seeded store. */
+interface MockShape {
+  /** Tables whose rows this shape replicates. */
+  tables: ReadonlyArray<string>;
+  /**
+   * Narrow the shape to rows matching every entry. Values are compared with
+   * `===`, which covers the partition-selector case (`{ userId: "u1" }`).
+   */
+  where?: Record<string, unknown>;
+}
+/** Options for {@link mockLunora}. */
+interface MockLunoraOptions {
+  /**
+   * Answers for non-mutator RPC calls, keyed by `namespace:fn`. A value may be a
+   * function of the call's args. Unlisted paths resolve to `undefined` — enough for a
+   * fire-and-forget mutation, and loud enough in a test that reads the result.
+   */
+  functions?: Record<string, unknown>;
+  /** Base path the app talks to. Defaults to `/_lunora`. */
+  path?: string;
+  /** Seeded rows per table. */
+  rows?: Record<string, ReadonlyArray<MockRow>>;
+  /** Shapes the app subscribes to, keyed by `defineShape` export name. */
+  shapes?: Record<string, MockShape>;
+}
+/** The handle {@link mockLunora} returns — drive the server side from the test. */
+interface MockLunora {
+  /** Stop answering `/_lunora/*`. Also called implicitly by a later `mockLunora` on the same page. */
+  dispose: () => Promise<void>;
+  /** Reject every subsequent mutation/mutator call with `code`. Pass `false` to stop. */
+  failWrites: (code: false | string) => void;
+  /** Insert (or replace) a row and poke every shape that now matches it. */
+  insert: (table: string, row: MockRow) => Promise<void>;
+  /** Patch a row and poke the shapes replicating it. */
+  patch: (table: string, id: string, patch: Record<string, unknown>) => Promise<void>;
+  /** Delete a row and poke the shapes replicating it. */
+  remove: (table: string, id: string) => Promise<void>;
+  /** Re-send every subscribed shape's full rowset — what a reconnect would do. */
+  resync: () => Promise<void>;
+  /** Current server-side rows for `table`. */
+  rows: (table: string) => MockRow[];
+  /**
+   * Stop sending pokes while still accepting writes — the dropped-poke failure
+   * mode. Writes still ack and advance the watermark, so this exercises the
+   * client's checkpoint fallback rather than a dead connection. Pass `false` to
+   * resume (which does NOT replay the missed pokes; call `resync()` for that).
+   */
+  suppressPokes: (suppressed?: boolean) => void;
+  /** Highest `clientSeq` acked, per client id — the watermark the client is gating overlays on. */
+  watermarks: () => Record<string, number>;
+}
+/**
+ * Install the double on `page`. Returns a handle for driving the server side.
+ *
+ * Idempotent per page: calling it again disposes the previous installation first.
+ * That matters more than it sounds — a stacked `routeWebSocket` handler from before
+ * a `page.reload()` keeps serving from its own closed-over row store, so the app
+ * silently reads stale data and the test fails somewhere unrelated.
+ */
+declare const mockLunora: (page: MockablePage, options?: MockLunoraOptions) => Promise<MockLunora>;
+export { type MockLunora, type MockLunoraOptions, type MockRoute, type MockRow, type MockShape, type MockWebSocketRoute, type MockablePage, mockLunora };

package/dist/playwright.mjs

@@ -0,0 +1 @@
+const E=(c,p)=>p?Object.entries(p).every(([l,w])=>c[l]===w):!0,D=async(c,p={})=>{const l=p.path??"/_lunora",w=`${l}/rpc`,J=`${l}/rpc-batch`,d=p.shapes??{},M=p.functions??{},m=new Map;for(const[e,t]of Object.entries(p.rows??{}))m.set(e,new Map(t.map(a=>[a._id,{...a}])));const f=new Map,i=new Map,b=new Map;let u=0,_=0,O=!1,g=!1,j=!1;const $=new Set,P=async()=>{await c.unroute(w),await c.unroute(J)};await P();const y=e=>{const t=m.get(e);if(t)return t;const a=new Map;return m.set(e,a),a},T=e=>{const t=d[e];if(!t)return[];const a=[];for(const n of t.tables)for(const s of y(n).values())E(s,t.where)&&a.push({row:s,table:n});return a},S=()=>Math.max(0,...f.values()),x=e=>{if(O||e.length===0)return;_+=1,u+=1;const t=`poke_${String(_)}`,a=S();for(const{shapeId:n}of e){const s=i.get(n);s&&s.send(JSON.stringify({baseCheckpoint:u-1,pokeId:t,type:"pokeStart"}))}for(const{ops:n,shapeId:s}of e){const o=i.get(s);o&&o.send(JSON.stringify({lastMutationId:a,pokeId:t,rowsPatch:n,shapeId:s,type:"pokePart"}))}for(const{shapeId:n}of e){const s=i.get(n);s&&s.send(JSON.stringify({checkpoint:u,pokeId:t,type:"pokeEnd"}))}},N=(e,t,a,n)=>{const s=[];for(const o of i.values()){const r=d[o.name];if(!r?.tables.includes(e))continue;const h=t!=="delete"&&n!==void 0&&!E(n,r.where)?"delete":t;s.push({ops:[{key:a,op:h,table:e,...h==="delete"?{}:{value:n}}],shapeId:o.id})}x(s)},L=e=>{const t=T(e.name).map(({row:a,table:n})=>({key:a._id,op:"insert",table:n,value:a}));x([{ops:t,shapeId:e.id}])},k=()=>{if(O)return;const e=S();for(const t of b.values())t.send(JSON.stringify({cursor:u,id:t.id,lastMutationId:e,type:"settled"}))},q=async e=>{const t=e.request(),a=t.postData();let n={};if(typeof a=="string")try{n=JSON.parse(a)}catch{await e.fulfill({body:JSON.stringify({error:{code:"BAD_REQUEST",message:"mockLunora: unparseable RPC body"}}),contentType:"application/json",status:400});return}const s=n.functionPath??"",o=t.headers(),r=o["x-lunora-client-id"]??"",h=Number.parseInt(o["x-lunora-client-seq"]??"",10),v=r!==""&&Number.isFinite(h);if(g!==!1&&v){await e.fulfill({body:JSON.stringify({error:{code:g,message:`mockLunora: writes are failing with ${g}`}}),contentType:"application/json",status:400});return}v&&f.set(r,Math.max(f.get(r)??0,h));const I=M[s],C=typeof I=="function"?I(n.args??{}):I;await e.fulfill({body:JSON.stringify({commitCursor:u,lastMutationId:v?f.get(r)??0:S(),result:C}),contentType:"application/json",status:200})};return await c.route(w,q),await c.route(J,q),await c.routeWebSocket(`${l}/ws`,e=>{const t=a=>{j||e.send(a)};e.onMessage(a=>{let n;try{n=JSON.parse(a)}catch{return}const s=n.id??"";switch(n.type){case"shape_subscribe":{const o=n.shape?.name??"",r={id:s,name:o,send:t};d[o]===void 0&&!$.has(o)&&($.add(o),console.warn(`[mockLunora] the app subscribed to shape "${o}", which is not in \`shapes\` — it will replicate nothing and never poke. Declared: ${Object.keys(d).length===0?"(none)":Object.keys(d).join(", ")}.`)),i.set(s,r),t(JSON.stringify({id:s,type:"ack"})),L(r);return}case"shape_unsubscribe":{i.delete(s);return}case"subscribe":{b.set(s,{functionPath:n.query?.functionPath??"",id:s,send:t}),t(JSON.stringify({id:s,type:"ack"}));const o=M[n.query?.functionPath??""],r=typeof o=="function"?o({}):o??[];t(JSON.stringify({cursor:u,data:r,id:s,type:"data"}));return}case"unsubscribe":{b.delete(s);break}}})}),{dispose:async()=>{j=!0,i.clear(),b.clear(),await P()},failWrites:e=>{g=e},insert:async(e,t)=>{y(e).set(t._id,{...t}),N(e,"insert",t._id,{...t}),k()},patch:async(e,t,a)=>{const n=y(e),s=n.get(t);if(!s)throw new Error(`mockLunora.patch: no row "${t}" in table "${e}"`);const o={...s,...a,_id:t};n.set(t,o),N(e,"update",t,o),k()},remove:async(e,t)=>{y(e).delete(t),N(e,"delete",t),k()},resync:async()=>{for(const e of i.values())L(e);k()},rows:e=>[...y(e).values()].map(t=>({...t})),suppressPokes:(e=!0)=>{O=e},watermarks:()=>Object.fromEntries(f)}};export{D as mockLunora};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/testing",
-  "version": "1.0.0-alpha.54",
+  "version": "1.0.0-alpha.56",
   "description": "Testing toolkit for Lunora: an in-memory harness for queries, mutations, and actions",
   "keywords": [
     "cloudflare",
@@ -40,17 +40,29 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs"
     },
+    "./playwright": {
+      "types": "./dist/playwright.d.ts",
+      "import": "./dist/playwright.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@lunora/agent": "1.0.0-alpha.9",
-    "@lunora/do": "1.0.0-alpha.43",
-    "@lunora/errors": "1.0.0-alpha.7",
-    "@lunora/mail": "1.0.0-alpha.17",
-    "@lunora/server": "1.0.0-alpha.30"
+    "@lunora/agent": "1.0.0-alpha.11",
+    "@lunora/do": "1.0.0-alpha.45",
+    "@lunora/errors": "1.0.0-alpha.8",
+    "@lunora/mail": "1.0.0-alpha.18",
+    "@lunora/server": "1.0.0-alpha.32"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.61.1"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"

package/dist/packem_shared/agentHarness-GTPhWdQ8.mjs

@@ -1,144 +0,0 @@
-import { runAgentLoop, DEFAULT_AGENT_FUNCTION_PATHS } from '@lunora/agent';
-
-const scriptedGenerate = (script) => {
-  const remaining = [...script];
-  return () => {
-    const next = remaining.shift();
-    if (!next) {
-      throw new Error("agentHarness: scripted generate exhausted — the run took more turns than the script provided.");
-    }
-    return Promise.resolve(next);
-  };
-};
-class DurableStepJournal {
-  invoked = [];
-  entries = /* @__PURE__ */ new Map();
-  async do(name, callback) {
-    const existing = this.entries.get(name);
-    if (existing) {
-      return existing.output;
-    }
-    this.invoked.push(name);
-    const output = await callback();
-    this.entries.set(name, { output });
-    return output;
-  }
-  // eslint-disable-next-line class-methods-use-this -- mirrors AgentStepLike.waitForEvent's host signature so the mock stays assignable
-  async waitForEvent(_name, _options) {
-    return new Promise(() => {
-    });
-  }
-}
-const createRuntime = (extra) => {
-  const threads = /* @__PURE__ */ new Map();
-  const messages = /* @__PURE__ */ new Map();
-  const dispatches = [];
-  const ensureThread = (args) => {
-    const key = args?.["key"];
-    const instanceId = args?.["instanceId"];
-    const existing = threads.get(key);
-    if (existing) {
-      existing.status = "running";
-      delete existing.error;
-      if (instanceId !== void 0) {
-        existing.instanceId = instanceId;
-      }
-      return { created: false };
-    }
-    threads.set(key, {
-      agent: args?.["agent"],
-      instanceId,
-      key,
-      messageCount: 0,
-      owner: args?.["owner"],
-      status: "running",
-      title: args?.["title"]
-    });
-    return { created: true };
-  };
-  const appendMessage = (args) => {
-    const threadKey = args?.["threadKey"];
-    const messageKey = args?.["messageKey"];
-    const id = `${threadKey}:${messageKey}`;
-    const existing = messages.get(id);
-    if (existing) {
-      return { seq: existing.seq };
-    }
-    const thread = threads.get(threadKey);
-    if (!thread) {
-      throw new Error(`agentHarness: append to unknown thread "${threadKey}".`);
-    }
-    const seq = thread.messageCount;
-    thread.messageCount += 1;
-    messages.set(id, { ...args, seq });
-    return { seq };
-  };
-  const listMessages = (args) => {
-    const key = args?.["key"];
-    return [...messages.values()].filter((message) => message.threadKey === key).toSorted((a, b) => a.seq - b.seq);
-  };
-  const patchThread = (args) => {
-    const thread = threads.get(args?.["key"]);
-    if (thread) {
-      for (const [field, value] of Object.entries(args ?? {})) {
-        if (field !== "key" && value !== void 0) {
-          thread[field] = value;
-        }
-      }
-    }
-    return void 0;
-  };
-  const handlers = new Map([
-    [DEFAULT_AGENT_FUNCTION_PATHS.appendMessage, appendMessage],
-    [DEFAULT_AGENT_FUNCTION_PATHS.ensureThread, ensureThread],
-    [DEFAULT_AGENT_FUNCTION_PATHS.listMessages, listMessages],
-    [DEFAULT_AGENT_FUNCTION_PATHS.patchThread, patchThread],
-    ...Object.entries(extra)
-  ]);
-  const run = (reference, args) => {
-    const path = reference["__lunoraRef"];
-    dispatches.push({ args, path });
-    const handler = handlers.get(path);
-    if (!handler) {
-      throw new Error(`agentHarness: unstubbed dispatch "${path}" — pass a \`functions\` handler for it.`);
-    }
-    return Promise.resolve(handler(args));
-  };
-  return { dispatches, messages, run, threads };
-};
-const agentHarness = (agent, options) => {
-  const exportName = options.exportName ?? "agent";
-  const env = options.env ?? { LUNORA_TEST: true };
-  const runtime = createRuntime(options.functions ?? {});
-  let runCount = 0;
-  const run = (params, overrides) => {
-    runCount += 1;
-    const instanceId = overrides?.instanceId ?? `wf-${String(runCount)}`;
-    const script = overrides?.script ?? options.script;
-    return runAgentLoop({
-      agent,
-      env,
-      exportName,
-      generate: scriptedGenerate(script),
-      instanceId,
-      params,
-      paths: DEFAULT_AGENT_FUNCTION_PATHS,
-      run: runtime.run,
-      step: new DurableStepJournal()
-    });
-  };
-  return {
-    dispatches: runtime.dispatches,
-    messages: (threadKey) => [...runtime.messages.values()].filter((message) => message.threadKey === threadKey).toSorted((a, b) => a.seq - b.seq).map(({ messageKey: _messageKey, threadKey: _threadKey, ...row }) => row),
-    run,
-    thread: (threadKey) => runtime.threads.get(threadKey)
-  };
-};
-const finalTurn = (text, extra) => {
-  return { text, toolCalls: [], ...extra };
-};
-const toolCallTurn = (id, name, input, text = "") => {
-  return { text, toolCalls: [{ id, input, name }] };
-};
-
-export { agentHarness, finalTurn, toolCallTurn };

package/dist/packem_shared/containsScorer-DGwtvUNp.mjs

@@ -1,94 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-
-const LEADING_SCORE = /^\s*(-?\d+(?:\.\d+)?)/u;
-const clamp01 = (value) => Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0;
-const normalizeScore = (result) => {
-  if (typeof result === "number") {
-    return { score: clamp01(result) };
-  }
-  return { score: clamp01(result.score), ...result.reason === void 0 ? {} : { reason: result.reason } };
-};
-const mean = (values) => values.length === 0 ? 0 : values.reduce((sum, value) => sum + value, 0) / values.length;
-const containsScorer = (needle, options = {}) => {
-  return {
-    name: `contains:${needle}`,
-    score: ({ output }) => {
-      const haystack = options.caseSensitive ? output : output.toLowerCase();
-      const target = options.caseSensitive ? needle : needle.toLowerCase();
-      return haystack.includes(target) ? 1 : 0;
-    }
-  };
-};
-const regexScorer = (pattern, name = "regex") => {
-  return { name, score: ({ output }) => pattern.test(output) ? 1 : 0 };
-};
-const exactMatchScorer = () => {
-  return {
-    name: "exact-match",
-    score: ({ expected, output }) => output.trim() === expected?.trim() ? 1 : 0
-  };
-};
-const keywordScorer = (keywords) => {
-  if (keywords.length === 0) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/testing: keywordScorer requires at least one keyword");
-  }
-  return {
-    name: "keyword-coverage",
-    score: ({ output }) => {
-      const lower = output.toLowerCase();
-      const hits = keywords.filter((keyword) => lower.includes(keyword.toLowerCase())).length;
-      return { reason: `${String(hits)}/${String(keywords.length)} keywords present`, score: hits / keywords.length };
-    }
-  };
-};
-const buildJudgePrompt = (criteria, sample) => [
-  `Rate the ASSISTANT OUTPUT against this criterion: ${criteria}`,
-  "Respond with a single number from 0 (fails) to 1 (fully meets), then a dash and a one-line reason.",
-  ...sample.input === void 0 ? [] : ["", `Input: ${sample.input}`],
-  ...sample.expected === void 0 ? [] : ["", `Reference answer: ${sample.expected}`],
-  "",
-  `Assistant output: ${sample.output}`
-].join("\n");
-const parseJudgeScore = (raw) => {
-  const match = LEADING_SCORE.exec(raw);
-  return { reason: raw.trim(), score: match ? clamp01(Number(match[1])) : 0 };
-};
-const llmScorer = (options) => {
-  return {
-    name: options.name ?? "llm-judge",
-    score: async (sample) => parseJudgeScore(await options.judge(buildJudgePrompt(options.criteria, sample)))
-  };
-};
-const scoreSample = async (sample, scorers) => {
-  const results = await Promise.all(
-    scorers.map(async (scorer) => {
-      return { name: scorer.name, result: normalizeScore(await scorer.score(sample)) };
-    })
-  );
-  const scores = {};
-  const seen = /* @__PURE__ */ new Map();
-  for (const { name, result } of results) {
-    const priorCount = seen.get(name) ?? 0;
-    seen.set(name, priorCount + 1);
-    scores[priorCount === 0 ? name : `${name}#${String(priorCount + 1)}`] = result;
-  }
-  return { average: mean(results.map(({ result }) => result.score)), scores };
-};
-const evaluate = async (cases, produce, scorers) => {
-  const items = await Promise.all(
-    cases.map(async (testCase) => {
-      const output = await produce(testCase.input);
-      const sample = {
-        input: testCase.input,
-        output,
-        ...testCase.expected === void 0 ? {} : { expected: testCase.expected },
-        ...testCase.metadata === void 0 ? {} : { metadata: testCase.metadata }
-      };
-      const { average, scores } = await scoreSample(sample, scorers);
-      return { average, input: testCase.input, output, scores };
-    })
-  );
-  return { average: mean(items.map((item) => item.average)), items };
-};
-
-export { containsScorer, evaluate, exactMatchScorer, keywordScorer, llmScorer, regexScorer, scoreSample };

package/dist/packem_shared/evaluationAttributes-C08Q5MOX.mjs

@@ -1,31 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-
-const SAFE_NAME_CHAR = /[\w.-]/u;
-const sanitizeName = (name) => {
-  let out = "";
-  for (const char of name) {
-    out += SAFE_NAME_CHAR.test(char) ? char : "_";
-  }
-  return out;
-};
-const evaluationAttributes = (input) => {
-  if (typeof input.name !== "string" || input.name.length === 0) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/testing: recordEvaluation requires a non-empty `name`");
-  }
-  if (typeof input.score !== "number" || !Number.isFinite(input.score)) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/testing: recordEvaluation `score` must be a finite number");
-  }
-  const key = sanitizeName(input.name);
-  const attributes = { [`gen_ai.evaluation.${key}.score`]: input.score };
-  if (input.label !== void 0) {
-    attributes[`gen_ai.evaluation.${key}.label`] = input.label;
-  }
-  return attributes;
-};
-const recordEvaluation = (input) => {
-  const attributes = evaluationAttributes(input);
-  input.span?.setAttributes(attributes);
-  return attributes;
-};
-
-export { evaluationAttributes, recordEvaluation };

package/dist/packem_shared/lunoraTest-Dv_w_v9z.mjs

@@ -1,504 +0,0 @@
-import { runShardMigrations, createShardCtxDb } from '@lunora/do';
-import { LunoraError } from '@lunora/errors';
-import { DatabaseSync } from 'node:sqlite';
-
-const createFakeScheduler = (getDispatch, getMutationContext, getActionContext, getFunctionRegistry, now) => {
-  let nowMs = now;
-  let nextId = 1;
-  const pending = /* @__PURE__ */ new Map();
-  const recordedFailures = [];
-  const enqueue = (scheduledFor, functionPath, args = {}) => {
-    const id = `fake-job-${String(nextId)}`;
-    nextId += 1;
-    pending.set(id, {
-      args,
-      enqueuedAt: nowMs,
-      functionPath,
-      id,
-      scheduledFor
-    });
-    return id;
-  };
-  const targetPath = (target) => typeof target === "string" ? target : target.name ?? target.binding ?? "";
-  const scheduler = {
-    cancel: (id) => {
-      const existed = pending.has(id);
-      pending.delete(id);
-      return Promise.resolve({ cancelled: existed });
-    },
-    // eslint-disable-next-line unicorn/no-null -- Scheduler.get returns null when absent (public API contract)
-    get: (id) => Promise.resolve(pending.get(id) ?? null),
-    list: () => Promise.resolve([...pending.values()]),
-    runAfter: (delayMs, target, args) => {
-      const id = enqueue(nowMs + delayMs, targetPath(target), args);
-      return Promise.resolve(id);
-    },
-    runAt: (timestampMs, target, args) => {
-      const id = enqueue(timestampMs, targetPath(target), args);
-      return Promise.resolve(id);
-    }
-  };
-  const dispatchJob = async (job) => {
-    pending.delete(job.id);
-    const registry = getFunctionRegistry();
-    const entry = registry.get(job.functionPath);
-    if (entry === void 0) {
-      console.warn(`[fake-scheduler] unknown functionPath "${job.functionPath}" — job ${job.id} dropped`);
-      return;
-    }
-    if (entry.kind === "mutation" || entry.kind === "action") {
-      const dispatch = getDispatch();
-      const context = entry.kind === "action" ? getActionContext() : getMutationContext();
-      await dispatch(entry.kind, entry, context, job.args);
-    } else {
-      console.warn(
-        `[fake-scheduler] functionPath "${job.functionPath}" is a ${entry.kind} — only mutations and actions can be scheduled; job ${job.id} dropped`
-      );
-    }
-  };
-  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) {
-        const failure = { args: job.args, error, functionPath: job.functionPath, id: job.id };
-        failed.push(failure);
-        recordedFailures.push(failure);
-      }
-    }
-    return { executed, failed };
-  };
-  const runSweep = async (cutoff, options) => {
-    const { executed, failed } = await executeDue(cutoff);
-    if (failed.length > 0 && (options?.throwOnError ?? true)) {
-      const [first] = failed;
-      if (failed.length === 1 && first !== void 0) {
-        throw first.error;
-      }
-      throw new AggregateError(
-        failed.map((f) => f.error),
-        `${String(failed.length)} scheduled jobs failed: ${failed.map((f) => f.functionPath).join(", ")}`
-      );
-    }
-    return executed;
-  };
-  const controls = {
-    advance: (ms, options) => {
-      nowMs += ms;
-      return runSweep(nowMs, options);
-    },
-    failures: () => [...recordedFailures],
-    list: () => [...pending.values()],
-    runPending: (options) => runSweep(Number.POSITIVE_INFINITY, options)
-  };
-  return { controls, scheduler };
-};
-
-const createSqlExec = () => {
-  const database = new DatabaseSync(":memory:");
-  const cursor = (rows) => {
-    return {
-      one() {
-        if (rows.length !== 1) {
-          throw new LunoraError("INTERNAL", `expected exactly one row, received ${String(rows.length)}`);
-        }
-        const [only] = rows;
-        return only;
-      },
-      [Symbol.iterator]() {
-        return rows[Symbol.iterator]();
-      },
-      toArray() {
-        return rows;
-      }
-    };
-  };
-  const run = (query, ...params) => {
-    const statement = database.prepare(query);
-    const rows = statement.all(...params);
-    return cursor(rows);
-  };
-  return {
-    close: () => {
-      database.close();
-    },
-    sql: { exec: run }
-  };
-};
-
-const registeredFunctionKind = (value) => {
-  if (typeof value !== "object" || value === null) {
-    return void 0;
-  }
-  const { kind } = value;
-  if (kind === "query" || kind === "mutation" || kind === "action") {
-    return kind;
-  }
-  return void 0;
-};
-const registeredFunctionVisibility = (value) => typeof value === "object" && value !== null && value.visibility === "internal" ? "internal" : "public";
-const unavailable = (surface) => {
-  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),
-  get: () => unavailable(surface)
-});
-const noopSpan = {
-  setAttribute: () => void 0,
-  setAttributes: () => void 0
-};
-const passthroughTrace = async (_name, function_) => await function_(passthroughTrace, noopSpan);
-const noopMetrics = {
-  count: () => void 0,
-  gauge: () => void 0,
-  record: () => void 0
-};
-const noopLog = {
-  debug: () => void 0,
-  error: () => void 0,
-  fatal: () => void 0,
-  info: () => void 0,
-  log: () => void 0,
-  trace: () => void 0,
-  warn: () => void 0,
-  with: () => noopLog
-};
-const buildSubscribe = (runRegistered, queryContext, mutationListeners) => {
-  const factory = (referenceOrInline, args) => {
-    let done = false;
-    const pendingWaiters = [];
-    let pendingResult;
-    let pendingError;
-    let latestSeq = 0;
-    let appliedSeq = 0;
-    const runQuery = () => {
-      if (registeredFunctionKind(referenceOrInline)) {
-        return runRegistered("query", referenceOrInline, queryContext, args, false);
-      }
-      return Promise.resolve(referenceOrInline(queryContext));
-    };
-    const emit = (seq, value) => {
-      if (seq < appliedSeq) {
-        return;
-      }
-      appliedSeq = seq;
-      const iterResult = { done: false, value };
-      if (pendingWaiters.length === 0) {
-        pendingResult = iterResult;
-        pendingError = void 0;
-      } else {
-        pendingResult = void 0;
-        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(emitErrorAt(seq));
-    };
-    mutationListeners.add(listener);
-    const iterator = {
-      [Symbol.asyncIterator]() {
-        return iterator;
-      },
-      next: () => {
-        if (done) {
-          return Promise.resolve({ done: true, value: void 0 });
-        }
-        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, 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;
-            return result;
-          }
-          return { done: false, value };
-        });
-      },
-      return: () => {
-        done = true;
-        mutationListeners.delete(listener);
-        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(emitErrorAt(0));
-    return iterator;
-  };
-  return factory;
-};
-const lunoraTest = (schema, options) => {
-  const { close, sql } = createSqlExec();
-  const ddlSchema = schema;
-  runShardMigrations(sql, ddlSchema);
-  const database = createShardCtxDb({ schema: ddlSchema, sql });
-  const execStatement = (statement) => {
-    const runner = sql.exec;
-    runner.call(sql, statement);
-  };
-  let mutationQueue = Promise.resolve();
-  const runInMutationTransaction = (function_) => {
-    const runTransaction = async () => {
-      execStatement("BEGIN");
-      try {
-        const result2 = await function_();
-        execStatement("COMMIT");
-        return result2;
-      } catch (error) {
-        try {
-          execStatement("ROLLBACK");
-        } catch {
-        }
-        throw error;
-      }
-    };
-    const result = mutationQueue.then(runTransaction);
-    mutationQueue = result.then(
-      () => void 0,
-      () => void 0
-    );
-    return result;
-  };
-  let closed = false;
-  const closeDatabase = () => {
-    if (closed) {
-      return;
-    }
-    closed = true;
-    close();
-  };
-  const functionRegistryMap = new Map(
-    Object.entries(options?.functions ?? {}).map(([path, function_]) => [path, function_])
-  );
-  const mutationListeners = /* @__PURE__ */ new Set();
-  const notifyMutationListeners = () => {
-    for (const listener of mutationListeners) {
-      listener();
-    }
-  };
-  let scheduledDispatchRef;
-  let mutationContextRef;
-  let actionContextRef;
-  const harnessNow = options?.now ?? Date.now();
-  const { controls: schedulerControls, scheduler: fakeScheduler } = createFakeScheduler(
-    () => {
-      if (scheduledDispatchRef === void 0) {
-        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 LunoraError(
-          "INTERNAL",
-          "[fake-scheduler] mutationContext not yet available — scheduler.advance called before harness construction completed"
-        );
-      }
-      return mutationContextRef;
-    },
-    () => {
-      if (actionContextRef === void 0) {
-        throw new LunoraError(
-          "INTERNAL",
-          "[fake-scheduler] actionContext not yet available — scheduler.advance called before harness construction completed"
-        );
-      }
-      return actionContextRef;
-    },
-    () => functionRegistryMap,
-    harnessNow
-  );
-  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)
-      getIdentity: () => Promise.resolve(identity ?? null),
-      // eslint-disable-next-line unicorn/no-null -- AuthState.userId's anonymous sentinel is `null`
-      userId: identity?.userId ?? null
-    };
-    const queryContext = {
-      auth,
-      db: database,
-      env: options?.env,
-      log: noopLog,
-      metrics: noopMetrics,
-      now: harnessNow,
-      trace: passthroughTrace,
-      // 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,
-      metrics: noopMetrics,
-      now: harnessNow,
-      trace: passthroughTrace,
-      // 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")
-    };
-    mutationContextRef ??= mutationContext;
-    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,
-      metrics: noopMetrics,
-      now: harnessNow,
-      trace: passthroughTrace,
-      // 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
-      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")
-    };
-    actionContextRef ??= actionContext;
-    const runRegistered = (expected, reference, context, args, allowInternal) => {
-      const kind = registeredFunctionKind(reference);
-      if (kind !== expected) {
-        throw new LunoraError("INTERNAL", `expected a registered ${expected}, received a ${kind ?? "non-function"} reference`);
-      }
-      if (!allowInternal && registeredFunctionVisibility(reference) === "internal") {
-        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 ?? {}));
-    };
-    const runInternal = (expected, reference, context, args) => runRegistered(expected, reference, context, args, true);
-    scheduledDispatchRef ??= (kind, reference, context, args) => {
-      if (kind === "mutation") {
-        return runInMutationTransaction(() => runRegistered("mutation", reference, context, args, true)).then((result) => {
-          notifyMutationListeners();
-          return result;
-        });
-      }
-      return runInternal("action", reference, context, args);
-    };
-    const query = ((referenceOrInline, args) => {
-      if (registeredFunctionKind(referenceOrInline)) {
-        return runRegistered("query", referenceOrInline, queryContext, args, false);
-      }
-      return Promise.resolve(referenceOrInline(queryContext));
-    });
-    const mutation = ((referenceOrInline, args) => {
-      if (registeredFunctionKind(referenceOrInline)) {
-        return runInMutationTransaction(() => runRegistered("mutation", referenceOrInline, mutationContext, args, false)).then((result) => {
-          notifyMutationListeners();
-          return result;
-        });
-      }
-      return runInMutationTransaction(() => referenceOrInline(mutationContext)).then((result) => {
-        notifyMutationListeners();
-        return result;
-      });
-    });
-    const action = ((referenceOrInline, args) => {
-      if (registeredFunctionKind(referenceOrInline)) {
-        return runRegistered("action", referenceOrInline, actionContext, args, false);
-      }
-      return Promise.resolve(referenceOrInline(actionContext));
-    });
-    const subscribe = buildSubscribe(runRegistered, queryContext, mutationListeners);
-    const harness = {
-      action,
-      close: closeDatabase,
-      mutation,
-      query,
-      run: (function_) => runInMutationTransaction(() => function_(mutationContext)).then((result) => {
-        notifyMutationListeners();
-        return result;
-      }),
-      scheduler: schedulerControls,
-      subscribe,
-      // A scoped view shares the SAME sql/db handle (created once above), so
-      // writes performed under an identity persist for every accessor.
-      withIdentity: (next) => makeHarness(next)
-    };
-    return harness;
-  };
-  return makeHarness(null);
-};
-
-export { lunoraTest };