@stacksjs/testing 0.75.226 → 0.75.230

package/dist/browser.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Poll `read` until it returns something truthy, and return that. Throws
+ * after `timeoutMs` (default 12 s) with `label` in the message.
+ */
+export declare function waitFor<T>(read: () => Promise<T> | T, timeoutMs?: unknown, options?: { intervalMs?: number, label?: string }): Promise<NonNullable<T>>;
+/** Open a session on a DevTools WebSocket URL (`ws://127.0.0.1:9222/devtools/page/...`). */
+export declare function connect(url: string, options?: CdpOptions): Promise<Cdp>;
+/** The Chrome to drive: `CHROME_PATH`, else the first installed one found. Null when there is none. */
+export declare function findChrome(): string | null;
+/** True when this Chrome would be killed by GoogleUpdater (it still carries the updater's keys). */
+export declare function chromeHasUpdater(executable: string): boolean;
+/**
+ * A private clone of a macOS Chrome that GoogleUpdater leaves alone (see the
+ * module docs): `cp -cR`, the `KS*` keys deleted from `Info.plist`, its own
+ * `CFBundleIdentifier`, `codesign --force --deep --sign -`. Kept in
+ * `directory` (default a per-version folder in the temp directory) and
+ * reused while its version matches the source's.
+ */
+export declare function prepareMacChrome(options?: { source?: string, directory?: string }): PreparedChrome;
+/**
+ * Start a private headless Chrome and open a session on its page, with the
+ * `Page`, `Runtime`, `Network` and `Log` domains enabled.
+ */
+export declare function launch(options?: LaunchOptions): Promise<LaunchedChrome>;
+/**
+ * Wait until the document has loaded and no request has been in flight for
+ * `quietMs` (event streams excluded, see `Cdp`). Resolves true once settled,
+ * false at the timeout (a page that never goes quiet is often the finding);
+ * rejects only if Chrome goes away.
+ */
+export declare function settle(cdp: Cdp, options?: SettleOptions): Promise<boolean>;
+/** Navigate and wait for the page to settle. Resolves with whether it settled. */
+export declare function navigate(cdp: Cdp, url: string, options?: SettleOptions): Promise<boolean>;
+/** Count how often each entry appears, keeping those seen more than once. */
+export declare function duplicateRequests(requests: readonly string[]): Record<string, number>;
+/**
+ * Load `url` once and report what it cost and what went wrong: the same API
+ * request made more than once in one load, failed same-origin requests, and
+ * console errors. Never throws for a page problem: a launch or navigation
+ * failure is reported in `errors`.
+ *
+ * @example
+ * const report = await auditPage('http://localhost:3000/dashboard', {
+ *   beforeNavigate: cdp => cdp.send('Page.addScriptToEvaluateOnNewDocument', { source: `localStorage.setItem('token', ${JSON.stringify(token)})` }),
+ * })
+ * expect(report.duplicates).toEqual({})
+ * expect(report.failed).toEqual([])
+ */
+export declare function auditPage(url: string, options?: PageAuditOptions): Promise<PageAuditReport>;
+/** One line per page: `/path: 12 api | dup 2x GET /api/me | failed 404 /api/x | errors ...`. */
+export declare function formatPageAudit(report: PageAuditReport): string;
+/** True when the report found nothing: no duplicates, failures or errors, and the page settled. */
+export declare function pageAuditClean(report: PageAuditReport): boolean;
+export declare interface CdpOptions {
+  commandTimeoutMs?: number
+}
+export declare interface PreparedChrome {
+  executable: string
+  app: string
+  reused: boolean
+}
+// ---------------------------------------------------------------------------
+// Launching
+// ---------------------------------------------------------------------------
+export declare interface Viewport {
+  width: number
+  height: number
+  deviceScaleFactor?: number
+  mobile?: boolean
+}
+export declare interface LaunchOptions extends CdpOptions {
+  chromePath?: string
+  stableMacChrome?: boolean
+  profile?: string
+  headless?: boolean
+  viewport?: Viewport | false
+  args?: string[]
+  quietLiveReload?: string[] | false
+  acceptDialogs?: boolean
+  userAgent?: boolean | string
+  startTimeoutMs?: number
+}
+export declare interface LaunchedChrome {
+  cdp: Cdp
+  close: () => Promise<void>
+  target: string
+  port: number
+  chromePath: string
+}
+// ---------------------------------------------------------------------------
+// Settling and navigating
+// ---------------------------------------------------------------------------
+export declare interface SettleOptions {
+  quietMs?: number
+  timeoutMs?: number
+}
+// ---------------------------------------------------------------------------
+// Page audit
+// ---------------------------------------------------------------------------
+export declare interface PageAuditOptions extends SettleOptions {
+  cdp?: Cdp
+  launch?: LaunchOptions
+  viewport?: Viewport
+  isApiRequest?: (url: URL, method: string) => boolean
+  beforeNavigate?: (cdp: Cdp) => Promise<void> | void
+}
+export declare interface PageAuditReport {
+  url: string
+  apiRequests: string[]
+  duplicates: Record<string, number>
+  failed: string[]
+  errors: string[]
+  settled: boolean
+  durationMs: number
+}
+// ---------------------------------------------------------------------------
+// The protocol session
+// ---------------------------------------------------------------------------
+declare type Listener = (params: any) => void;
+/**
+ * One DevTools Protocol session.
+ *
+ * Besides commands and events it keeps two things a test usually wants:
+ *
+ * - `errors`: uncaught exceptions, `console.error` calls, error log entries
+ *   (favicon misses excluded) and failed requests (cancellations excluded);
+ * - `inFlight`: the requests still loading, so a stalled page can say what it
+ *   is waiting on. An event stream (`text/event-stream`: messages,
+ *   notifications, live reload) stays open for the life of the page, so it
+ *   leaves `inFlight` as soon as its response starts; counting it would keep
+ *   every wait for a quiet network running to its timeout.
+ *
+ * Enable the `Network`, `Runtime` and `Log` domains for those to fill;
+ * `launch()` does.
+ */
+export declare class Cdp {
+  errors: string[];
+  inFlight: unknown;
+  closed: boolean;
+  constructor(socket: WebSocket, options?: CdpOptions);
+  on(method: string, listener: Listener): () => void;
+  off(method: string, listener: Listener): void;
+  once<T = any>(method: string, match?: (params: T) => boolean, timeoutMs?: unknown): Promise<T>;
+  send<T = any>(method: string, params?: Record<string, unknown>): Promise<T>;
+  evaluate<T = any>(expression: string): Promise<T>;
+  disconnect(): void;
+}

package/dist/browser.js

@@ -0,0 +1,6 @@
+// @bun
+import{existsSync as b,mkdirSync as A,mkdtempSync as T,readFileSync as y,renameSync as q,rmSync as v}from"fs";import{tmpdir as R}from"os";import{join as p}from"path";import m from"process";async function x(e,t=12000,r={}){let n=Date.now(),i=await e();while(!i&&Date.now()-n<t)await Bun.sleep(r.intervalMs??100),i=await e();if(!i)throw Error(`Timed out after ${t}ms${r.label?` waiting for ${r.label}`:""}`);return i}class E{socket;id=0;pending=new Map;listeners=new Map;commandTimeoutMs;errors=[];inFlight=new Map;closed=!1;constructor(e,t={}){this.socket=e;this.commandTimeoutMs=t.commandTimeoutMs??30000,e.addEventListener("close",()=>{this.closed=!0;for(let[r,n]of this.pending)clearTimeout(n.timer),n.reject(Error("Chrome closed the connection")),this.pending.delete(r)}),e.addEventListener("message",(r)=>this.receive(String(r.data)))}receive(e){let t;try{t=JSON.parse(e)}catch{return}if(t.id){let r=this.pending.get(t.id);if(!r)return;if(this.pending.delete(t.id),clearTimeout(r.timer),t.error)r.reject(Error(t.error.message));else r.resolve(t.result);return}this.track(t.method,t.params??{});for(let r of[...this.listeners.get(t.method)??[]])try{r(t.params??{})}catch(n){this.errors.push(`Listener for ${t.method} threw: ${n?.message??String(n)}`)}}track(e,t){if(e==="Network.requestWillBeSent")this.inFlight.set(t.requestId,`${t.request?.method} ${t.request?.url}`);else if(e==="Network.loadingFinished"||e==="Network.loadingFailed")this.inFlight.delete(t.requestId);else if(e==="Network.responseReceived"&&t.response?.mimeType==="text/event-stream")this.inFlight.delete(t.requestId);if(e==="Runtime.exceptionThrown")this.errors.push(t.exceptionDetails?.exception?.description||t.exceptionDetails?.text||"Runtime exception");else if(e==="Runtime.consoleAPICalled"&&t.type==="error")this.errors.push((t.args||[]).map((r)=>r.value??r.description??"").join(" "));else if(e==="Log.entryAdded"&&t.entry?.level==="error"&&!String(t.entry.text).includes("favicon"))this.errors.push(t.entry.text);else if(e==="Network.loadingFailed"&&!t.canceled)this.errors.push(`Network: ${t.errorText||"request failed"}`)}on(e,t){let r=this.listeners.get(e);if(!r)this.listeners.set(e,r=new Set);return r.add(t),()=>this.off(e,t)}off(e,t){this.listeners.get(e)?.delete(t)}once(e,t=()=>!0,r=this.commandTimeoutMs){return new Promise((n,i)=>{if(this.closed)return i(Error("Chrome closed the connection"));let a=setTimeout(()=>{c(),clearInterval(l),i(Error(`Timed out after ${r}ms waiting for ${e}`))},r),l=setInterval(()=>{if(!this.closed)return;clearTimeout(a),clearInterval(l),c(),i(Error("Chrome closed the connection"))},100),c=this.on(e,(u)=>{if(!t(u))return;clearTimeout(a),clearInterval(l),c(),n(u)})})}send(e,t={}){let r=++this.id;return new Promise((n,i)=>{if(this.closed)return i(Error("Chrome closed the connection"));let a=setTimeout(()=>{this.pending.delete(r),i(Error(`Chrome command timed out: ${e}`))},this.commandTimeoutMs);this.pending.set(r,{resolve:n,reject:i,timer:a}),this.socket.send(JSON.stringify({id:r,method:e,params:t}))})}async evaluate(e){let t=await this.send("Runtime.evaluate",{expression:e,awaitPromise:!0,returnByValue:!0});if(t.exceptionDetails)throw Error(t.exceptionDetails.exception?.description||t.exceptionDetails.text);return t.result?.value}disconnect(){try{this.socket.close()}catch{}}}async function D(e,t={}){let r=new WebSocket(e);return await new Promise((n,i)=>{r.addEventListener("open",()=>n(),{once:!0}),r.addEventListener("error",()=>i(Error(`Could not connect to Chrome at ${e}`)),{once:!0})}),new E(r,t)}var M=["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome","/Applications/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing","/Applications/Chromium.app/Contents/MacOS/Chromium","/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"],L=["google-chrome","google-chrome-stable","chromium","chromium-browser","chrome"],k=["KSProductID","KSUpdateURL","KSChannelID","KSVersion"],P="dev.stacks.testing.chrome";function I(){if(m.env.CHROME_PATH)return m.env.CHROME_PATH;if(m.platform==="darwin"){let e=M.find((t)=>b(t));if(e)return e}for(let e of L){let t=Bun.which(e);if(t)return t}return null}function O(e){let t=/^(.*?\.app)\/Contents\/MacOS\/[^/]+$/.exec(e);return t?t[1]:null}function w(e,t){let r=Bun.spawnSync(["/usr/libexec/PlistBuddy","-c",t,e],{stdout:"pipe",stderr:"pipe"});return{ok:r.exitCode===0,out:r.stdout.toString().trim()}}function N(e){let t=O(e);if(!t||m.platform!=="darwin")return!1;let r=p(t,"Contents/Info.plist");return b(r)&&k.some((n)=>w(r,`Print :${n}`).ok)}function F(e={}){if(m.platform!=="darwin")throw Error("prepareMacChrome is for macOS; elsewhere launch Chrome as installed");let t=e.source??M[0],r=O(t);if(!r||!b(r))throw Error(`No Chrome app bundle at ${t}`);let n=p(r,"Contents/Info.plist"),i=w(n,"Print :CFBundleShortVersionString").out||"unknown",a=w(n,"Print :CFBundleExecutable").out||"Google Chrome",l=e.directory??p(R(),`stacks-chrome-${i.replace(/[^\w.-]/g,"_")}`),c=p(l,"Chrome.app"),u=p(c,"Contents/MacOS",a),h=p(c,"Contents/Info.plist");if(b(u)&&w(h,"Print :CFBundleIdentifier").out===P&&w(h,"Print :CFBundleShortVersionString").out===i)return{executable:u,app:c,reused:!0};A(l,{recursive:!0});let g=T(p(l,"staging-")),o=p(g,"Chrome.app"),f=(s,d)=>{let C=Bun.spawnSync(s,{stdout:"pipe",stderr:"pipe"});if(C.exitCode!==0)throw Error(`${d} failed: ${C.stderr.toString().trim()}`)};try{f(["cp","-cR",r,o],"Cloning Chrome");let s=p(o,"Contents/Info.plist");for(let d of k)w(s,`Delete :${d}`);f(["/usr/libexec/PlistBuddy","-c",`Set :CFBundleIdentifier ${P}`,s],"Renaming the Chrome bundle"),f(["codesign","--force","--deep","--sign","-",o],"Re-signing Chrome"),v(c,{recursive:!0,force:!0}),q(o,c)}finally{v(g,{recursive:!0,force:!0})}return{executable:u,app:c,reused:!1}}function B(e){let t=e.chromePath??m.env.CHROME_PATH;if(t)return t;let r=I();if(!r)throw Error("No Chrome found: install Google Chrome or Chromium, or set CHROME_PATH");if((e.stableMacChrome??!0)&&m.platform==="darwin"&&N(r))return F({source:r}).executable;return r}async function _(e={}){let t=B(e);if(!b(t))throw Error(`Chrome was not found at ${t}`);let r=e.profile||T(p(R(),"stacks-browser-"));v(p(r,"DevToolsActivePort"),{force:!0});let n=Bun.spawn([t,...e.headless===!1?[]:["--headless=new"],"--remote-debugging-port=0",`--user-data-dir=${r}`,"--no-first-run","--no-default-browser-check","--disable-background-networking","--disable-component-update","--disable-extensions","--hide-scrollbars","--use-mock-keychain",...e.args??[],"about:blank"],{stdout:"ignore",stderr:"ignore"}),i,a=!1,l=async()=>{if(a)return;if(a=!0,i?.disconnect(),n.kill(),await n.exited,!e.profile)v(r,{recursive:!0,force:!0})};try{let c=p(r,"DevToolsActivePort");await x(()=>b(c)&&y(c,"utf8").includes(`
+`),e.startTimeoutMs??30000,{label:"Chrome to start"});let u=Number(y(c,"utf8").split(`
+`)[0]),h=await x(async()=>{let s=await fetch(`http://127.0.0.1:${u}/json/list`).then((d)=>d.json()).catch(()=>[]);return s.length?s:null},12000,{label:"a page target"}),g=h.find((s)=>s.type==="page"&&s.url==="about:blank")||h.find((s)=>s.type==="page");if(!g)throw Error("Chrome did not expose a page target");i=await D(g.webSocketDebuggerUrl,e);let o=i;if(await Promise.all([o.send("Page.enable"),o.send("Runtime.enable"),o.send("Network.enable"),o.send("Log.enable"),...e.viewport===!1?[]:[o.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,width:1440,height:1000,...e.viewport})]]),e.userAgent!==!1){let s=typeof e.userAgent==="string"?e.userAgent:String((await o.send("Browser.getVersion")).userAgent||"").replace("HeadlessChrome","Chrome");if(s)await o.send("Network.setUserAgentOverride",{userAgent:s})}let f=e.quietLiveReload===!1?[]:e.quietLiveReload??["*/_stx/hmr*"];if(f.length)o.on("Fetch.requestPaused",(s)=>{o.send("Fetch.fulfillRequest",{requestId:s.requestId,responseCode:200,responseHeaders:[{name:"Content-Type",value:"text/event-stream"}],body:Buffer.from(`retry: 86400000
+
+`).toString("base64")}).catch(()=>{})}),await o.send("Fetch.enable",{patterns:f.map((s)=>({urlPattern:s}))});if(e.acceptDialogs!==!1)o.on("Page.javascriptDialogOpening",(s)=>{o.errors.push(`Dialog (${s.type}) on ${s.url}: ${s.message||"(no message)"}`),o.send("Page.handleJavaScriptDialog",{accept:!0}).catch(()=>{})});return{cdp:o,close:l,target:g.webSocketDebuggerUrl,port:u,chromePath:t}}catch(c){throw await l(),c}}async function H(e,t={}){let r=t.quietMs??1000,n=t.timeoutMs??15000,i=Date.now(),a=0;while(Date.now()-i<n){if(e.closed)throw Error("Chrome closed the connection");if(e.inFlight.size>0||await e.evaluate("document.readyState !== 'complete'").catch(()=>!0))a=0;else if(!a)a=Date.now();else if(Date.now()-a>=r)return!0;await Bun.sleep(100)}return!1}async function U(e,t,r={}){let n=await e.send("Page.navigate",{url:t});if(n?.errorText)throw Error(`Could not open ${t}: ${n.errorText}`);return await H(e,r)}var j=(e)=>e.pathname.startsWith("/api/")&&!e.pathname.endsWith("/events");function S(e){let t={};for(let r of e)t[r]=(t[r]||0)+1;return Object.fromEntries(Object.entries(t).filter(([,r])=>r>1))}async function J(e,t={}){let r=Date.now(),n=new URL(e).origin,i=t.isApiRequest??j,a=[],l=[],c=null,u=t.cdp,h=[],g=u?.errors.length??0;try{if(!u)c=await _(t.launch),u=c.cdp;let o=u;if(h.push(o.on("Network.requestWillBeSent",(s)=>{let d=new URL(s.request.url);if(d.origin===n&&i(d,s.request.method))a.push(`${s.request.method} ${d.pathname}${d.search}`)})),h.push(o.on("Network.responseReceived",(s)=>{let d=new URL(s.response.url);if(d.origin===n&&s.response.status>=400)l.push(`${s.response.status} ${d.pathname}`)})),t.viewport)await o.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,...t.viewport});await t.beforeNavigate?.(o);let f=await U(o,e,t);return{url:e,apiRequests:a,duplicates:S(a),failed:l,errors:o.errors.slice(g),settled:f,durationMs:Date.now()-r}}catch(o){return{url:e,apiRequests:a,duplicates:S(a),failed:l,errors:[...u?.errors.slice(g)??[],`audit: ${o?.message??String(o)}`],settled:!1,durationMs:Date.now()-r}}finally{for(let o of h)o();await c?.close().catch(()=>{})}}function z(e){let t=e.url;try{let n=new URL(e.url);t=`${n.pathname}${n.search}`}catch{}let r=Object.entries(e.duplicates).map(([n,i])=>`${i}x ${n}`);return`${t}: ${e.apiRequests.length} api${r.length?` | dup ${r.join(", ")}`:""}${e.failed.length?` | failed ${e.failed.join(", ")}`:""}${e.errors.length?` | errors ${e.errors.slice(0,3).join(" ; ")}`:""}${e.settled?"":" | never settled"}`}function Y(e){return e.settled&&!Object.keys(e.duplicates).length&&!e.failed.length&&!e.errors.length}export{E as Cdp,J as auditPage,N as chromeHasUpdater,D as connect,S as duplicateRequests,I as findChrome,z as formatPageAudit,_ as launch,U as navigate,Y as pageAuditClean,F as prepareMacChrome,H as settle,x as waitFor};

package/dist/disposable-database.d.ts

@@ -0,0 +1,42 @@
+/** The Postgres server URL disposable databases are created on, if one is configured. */
+export declare function disposablePostgresUrl(options?: Pick<DisposableDatabaseOptions, 'url'>): string | undefined;
+/** Throws unless `url` is a Postgres URL for a server on this machine. */
+export declare function assertLocalPostgres(url: string): URL;
+/**
+ * Create a disposable database and return it with a `drop()` (also an
+ * `await using` disposer). Prefer `withDisposableDatabase`, which cannot
+ * forget to drop it.
+ */
+export declare function createDisposableDatabase(dialect: DisposableDialect, options?: DisposableDatabaseOptions): Promise<CreatedDisposableDatabase>;
+/**
+ * Run `fn` against a fresh database, then drop it, even when `fn` throws.
+ * A failure to drop is reported only when `fn` itself succeeded, so the
+ * test's own error is never hidden behind a cleanup error.
+ *
+ * @example
+ * for (const dialect of ['sqlite', 'postgres'] as const) {
+ *   test.skipIf(dialect === 'postgres' && !disposablePostgresUrl())(`${dialect} checkout flow`, async () => {
+ *     await withDisposableDatabase(dialect, async (database) => {
+ *       const result = await runIsolated('tests/fixtures/checkout-flow.ts', { env: { APP_ENV: 'test', ...database.env }, timeoutMs: 45_000 })
+ *       assertIsolatedOk(result, 'checkout flow OK')
+ *     })
+ *   }, 50_000)
+ * }
+ */
+export declare function withDisposableDatabase<T>(dialect: DisposableDialect, fn: (database: DisposableDatabase) => Promise<T> | T, options?: DisposableDatabaseOptions): Promise<T>;
+export declare interface DisposableDatabaseOptions {
+  url?: string
+  prefix?: string
+}
+export declare interface DisposableDatabase {
+  dialect: DisposableDialect
+  name: string
+  directory: string
+  path?: string
+  url?: string
+  env: Record<string, string>
+}
+export declare interface CreatedDisposableDatabase extends DisposableDatabase, AsyncDisposable {
+  drop: () => Promise<void>
+}
+export type DisposableDialect = 'sqlite' | 'postgres';

package/dist/disposable-database.js

@@ -0,0 +1,2 @@
+// @bun
+import{mkdtempSync as u,rmSync as i}from"fs";import{tmpdir as f}from"os";import{join as b}from"path";import m from"process";var{SQL:d}=globalThis.Bun;var g=new Set(["localhost","127.0.0.1","[::1]","::1"]);function S(e={}){return e.url||m.env.STACKS_TEST_POSTGRES_URL||void 0}function w(e){let s;try{s=new URL(e)}catch{throw Error("A disposable Postgres database needs a postgres:// URL")}if(!["postgres:","postgresql:"].includes(s.protocol))throw Error(`A disposable Postgres database needs a postgres:// URL, got ${s.protocol}`);if(!g.has(s.hostname))throw Error(`Disposable databases are only created on a local PostgreSQL server (localhost, 127.0.0.1, ::1), not "${s.hostname}"`);return s}function T(e){return`${(e.toLowerCase().replace(/[^a-z0-9_]/g,"_").replace(/^[^a-z_]+/,"")||"stacks_test").slice(0,38)}_${crypto.randomUUID().replaceAll("-","").slice(0,24)}`}async function h(e,s={}){if(e!=="sqlite"&&e!=="postgres")throw Error(`Disposable databases are sqlite or postgres, not "${String(e)}"`);let r=T(s.prefix??"stacks_test"),t=u(b(f(),`${r.slice(0,20)}-`)),n=!1;if(e==="sqlite"){let o=b(t,`${r}.sqlite`),a=async()=>{if(n)return;n=!0,i(t,{recursive:!0,force:!0})};return{dialect:e,name:r,directory:t,path:o,env:{DB_CONNECTION:"sqlite",DB_DATABASE_PATH:o},drop:a,[Symbol.asyncDispose]:a}}try{let o=S(s);if(!o)throw Error("A disposable Postgres database needs a server: pass options.url or set STACKS_TEST_POSTGRES_URL");let a=w(o),p=new d(a.href);try{await p.unsafe(`CREATE DATABASE "${r}"`)}finally{await p.close()}let c=new URL(a.href);c.pathname=`/${r}`;let l=async()=>{if(n)return;n=!0;let D=new d(a.href);try{await D.unsafe(`DROP DATABASE IF EXISTS "${r}" WITH (FORCE)`)}finally{await D.close(),i(t,{recursive:!0,force:!0})}};return{dialect:e,name:r,directory:t,url:c.href,env:{DB_CONNECTION:"postgres",DB_HOST:a.hostname.replace(/^\[|\]$/g,""),DB_PORT:a.port||"5432",DB_DATABASE:r,DB_USERNAME:decodeURIComponent(a.username),DB_PASSWORD:decodeURIComponent(a.password)},drop:l,[Symbol.asyncDispose]:l}}catch(o){throw i(t,{recursive:!0,force:!0}),o}}async function O(e,s,r={}){let t=await h(e,r),n;try{n=await s(t)}catch(o){throw await t.drop().catch(()=>{}),o}return await t.drop(),n}export{w as assertLocalPostgres,h as createDisposableDatabase,S as disposablePostgresUrl,O as withDisposableDatabase};

package/dist/index.d.ts

@@ -27,4 +27,8 @@ export * from './events';
 // Mail fakes (stacksjs/stacks#2581), on top of the email package's capture driver.
 export * from './mail';
 export * from './time';
+// Child-process isolation and throwaway databases. Bun and node only, no
+// framework import, so both are safe at the root.
+export * from './isolated';
+export * from './disposable-database';
 export * from 'bun:test';

package/dist/index.js

@@ -1,3 +1,12 @@
 // @bun
-import R from"process";function z(){R.env.NODE_ENV="test",R.env.APP_ENV="test"}var b=new Set(["headers","query","body","formData","actingAs"]);function q(e){if(!e)return"";let t=new URLSearchParams;for(let[s,o]of Object.entries(e)){if(o===void 0||o===null)continue;if(Array.isArray(o)){for(let u of o)t.append(s,String(u));continue}t.append(s,String(o))}let n=t.toString();return n?`?${n}`:""}function D(e,t,n){let s=Object.keys(e).filter((o)=>!b.has(o));if(s.length===0)return;throw TypeError(`http.${t.toLowerCase()}('${n}', \u2026) got unknown option(s) ${s.map((o)=>`'${o}'`).join(", ")}. Did you mean to send a body? Wrap it: { body: { ${s[0]}: \u2026 } }. `+`Valid options are ${[...b].join(", ")}.`)}async function S(){let e=await import("@stacksjs/router");return e.serverResponse}function N(e){let t={status:e.status,ok:e.ok,headers:e.headers,text:()=>e.text(),json:async()=>await e.clone().json(),assertStatus(n){if(this.status!==n)throw Error(`Expected status ${n}, got ${this.status}`);return t},async assertJson(n){let s=await e.clone().json();for(let[o,u]of Object.entries(n))if(JSON.stringify(s[o])!==JSON.stringify(u))throw Error(`assertJson: expected ${o}=${JSON.stringify(u)}, got ${JSON.stringify(s[o])}`);return t},assertHeader(n,s){let o=e.headers.get(n);if(o===null)throw Error(`assertHeader: missing header '${n}'`);if(s!==void 0){if(!(typeof s==="string"?o===s:s.test(o)))throw Error(`assertHeader: expected ${n}=${String(s)}, got '${o}'`)}return t}};return t}function k(e="http://localhost"){let t=null,n={},s=null;async function o(){if(!t)return null;if(s)return s;let{Auth:r}=await import("@stacksjs/auth"),i=Number(t.id);if(!Number.isFinite(i))throw TypeError(`actingAs() needs a user with a numeric id; got ${JSON.stringify(t.id)}`);let d=await r.loginUsingId(i);if(!d)throw Error(`actingAs() could not authenticate user ${i}: no such user. Create the row first (e.g. via a factory) so a token can be issued against it.`);return s=String(d.token),s}async function u(r){let i={Accept:"application/json",...n,...r.headers};if(r.body!==void 0&&r.formData===void 0)i["Content-Type"]="application/json";let d=await o();if(d&&!i.Authorization&&!i.authorization)i.Authorization=`Bearer ${d}`;return i}function l(r){if(r.formData!==void 0){if(r.body!==void 0)throw TypeError("A request carries either `body` or `formData`, not both.");let i=new FormData;for(let[d,m]of Object.entries(r.formData))i.append(d,m);return i}if(r.body===void 0)return;return typeof r.body==="string"?r.body:JSON.stringify(r.body)}async function c(r,i,d={}){let m=await S(),w=i.startsWith("http")?i:`${e}${i}`,y=q(d.query),P=y&&w.includes("?")?`${w}&${y.slice(1)}`:`${w}${y}`,C={method:r,headers:await u(d),body:l(d)},A=await m(new Request(P,C));return N(A)}let a={actingAs(r){return t=r,s=null,a},withHeaders(r){return n={...n,...r},a},request:(r,i,d)=>c(r,i,d),get:(r)=>c("GET",r),post:(r,i)=>c("POST",r,{body:i}),put:(r,i)=>c("PUT",r,{body:i}),patch:(r,i)=>c("PATCH",r,{body:i}),delete:(r,i)=>c("DELETE",r,{body:i})};return a}function Q(e,t){return k(t).actingAs(e)}var G=Object.freeze(["GET","POST","PUT","PATCH","DELETE","HEAD","OPTIONS"].reduce((e,t)=>{let n=async(s,o={})=>{D(o,t,s);let{actingAs:u,...l}=o,c=k();if(u)c.actingAs(u);return c.request(t,s,l)};return{...e,[t.toLowerCase()]:n}},{}));import x from"process";var j=60000;function H(e){let t=[],n="",s=null,o=!1,u=!1;for(let l of e){if(o){n+=l,o=!1;continue}if(l==="\\"){o=!0,u=!0;continue}if(s){if(l===s)s=null;else n+=l;continue}if(l==='"'||l==="'"){s=l,u=!0;continue}if(/\s/.test(l)){if(u)t.push(n),n="",u=!1;continue}n+=l,u=!0}if(s)throw Error(`Unterminated ${s} in command: ${e}`);if(u)t.push(n);return t}function Y(e){let t=typeof e==="string"?H(e):[...e],n,s={},o=x.cwd(),u=j;async function l(){if(t.length===0)throw Error("command() needs something to run");let a=Bun.spawn(["./buddy",...t],{cwd:o,env:{...x.env,...s},stdin:n===void 0?"ignore":new TextEncoder().encode(n),stdout:"pipe",stderr:"pipe"}),r=!1,i=setTimeout(()=>{r=!0,a.kill()},u);try{let[d,m,w]=await Promise.all([new Response(a.stdout).text(),new Response(a.stderr).text(),a.exited]);return{exitCode:w,stdout:d,stderr:m,output:d+m,timedOut:r}}finally{clearTimeout(i)}}let c={withInput(a){return n=a.map((r)=>`${r}
-`).join(""),c},withEnv(a){return s={...s,...a},c},withCwd(a){return o=a,c},withTimeout(a){if(!Number.isFinite(a)||a<=0)throw TypeError(`withTimeout expects a positive number of milliseconds, got ${a}`);return u=a,c},then(a,r){return l().then(a,r)}};return c}import{afterEach as B}from"bun:test";import{events as g}from"@stacksjs/events";var p=null,h=[],E=(e,t)=>{h.push({type:String(e),payload:t})};function te(){if(p)return;p=[...g.all.entries()],g.all.clear(),h=[],g.on("*",E)}function ne(){return p!==null}function L(e){if(!p)throw Error('getDispatchedEvents() was called without eventFake(). Nothing is recording, so an empty result would look like "the event did not fire".');return e===void 0?[...h]:h.filter((t)=>t.type===e)}function re(e){return L(e).length>0}function J(){if(!p)return;g.off("*",E),g.all.clear();for(let[e,t]of p)g.all.set(e,t);p=null,h=[]}B(()=>{J()});import{afterEach as I}from"bun:test";import{CaptureEmailDriver as T,mail as v}from"@stacksjs/email";var f=null;function ae(){if(f!==null)return;f=v.fake(),T.clear()}function ue(){return f!==null}function O(){if(f===null)throw Error('sentEmails() was called without mailFake(). Nothing is capturing, so an empty result would look like "no email was sent".');return[...T.all()]}function de(){return O().at(-1)}function le(e){let t=(n)=>{if(n===void 0||n===null)return!1;return(Array.isArray(n)?n:[n]).some((o)=>(typeof o==="string"?o:o?.address)===e)};return O().filter((n)=>t(n.to)||t(n.cc)||t(n.bcc))}function M(){if(f===null)return;v.restoreDriver(f),f=null,T.clear()}I(()=>{M()});import{setSystemTime as F}from"bun:test";function U(e){let t=e instanceof Date?e:new Date(e);if(Number.isNaN(t.getTime()))throw TypeError(`Not a valid time: ${JSON.stringify(e)}`);return t}function _(e=new Date){let t=U(e);return F(t),t}function fe(e){return _(e)}function me(){F()}export*from"bun:test";export{Q as actingAs,D as assertRequestOptions,Y as command,le as emailsTo,te as eventFake,ne as eventsAreFaked,k as featureTest,_ as freezeTime,L as getDispatchedEvents,re as hasDispatchedEvent,G as http,de as lastEmail,ae as mailFake,ue as mailIsFaked,q as queryString,J as restoreEvents,M as restoreMail,O as sentEmails,z as setupTestEnvironment,H as splitCommand,fe as travelTo,me as useRealTime};
+import D from"process";function pe(){D.env.NODE_ENV="test",D.env.APP_ENV="test"}var E=new Set(["headers","query","body","formData","actingAs"]);function L(e){if(!e)return"";let t=new URLSearchParams;for(let[r,o]of Object.entries(e)){if(o===void 0||o===null)continue;if(Array.isArray(o)){for(let a of o)t.append(r,String(a));continue}t.append(r,String(o))}let n=t.toString();return n?`?${n}`:""}function B(e,t,n){let r=Object.keys(e).filter((o)=>!E.has(o));if(r.length===0)return;throw TypeError(`http.${t.toLowerCase()}('${n}', \u2026) got unknown option(s) ${r.map((o)=>`'${o}'`).join(", ")}. Did you mean to send a body? Wrap it: { body: { ${r[0]}: \u2026 } }. `+`Valid options are ${[...E].join(", ")}.`)}async function j(){let e=await import("@stacksjs/router");return e.serverResponse}function U(e){let t={status:e.status,ok:e.ok,headers:e.headers,text:()=>e.text(),json:async()=>await e.clone().json(),assertStatus(n){if(this.status!==n)throw Error(`Expected status ${n}, got ${this.status}`);return t},async assertJson(n){let r=await e.clone().json();for(let[o,a]of Object.entries(n))if(JSON.stringify(r[o])!==JSON.stringify(a))throw Error(`assertJson: expected ${o}=${JSON.stringify(a)}, got ${JSON.stringify(r[o])}`);return t},assertHeader(n,r){let o=e.headers.get(n);if(o===null)throw Error(`assertHeader: missing header '${n}'`);if(r!==void 0){if(!(typeof r==="string"?o===r:r.test(o)))throw Error(`assertHeader: expected ${n}=${String(r)}, got '${o}'`)}return t}};return t}function x(e="http://localhost"){let t=null,n={},r=null;async function o(){if(!t)return null;if(r)return r;let{Auth:s}=await import("@stacksjs/auth"),u=Number(t.id);if(!Number.isFinite(u))throw TypeError(`actingAs() needs a user with a numeric id; got ${JSON.stringify(t.id)}`);let c=await s.loginUsingId(u);if(!c)throw Error(`actingAs() could not authenticate user ${u}: no such user. Create the row first (e.g. via a factory) so a token can be issued against it.`);return r=String(c.token),r}async function a(s){let u={Accept:"application/json",...n,...s.headers};if(s.body!==void 0&&s.formData===void 0)u["Content-Type"]="application/json";let c=await o();if(c&&!u.Authorization&&!u.authorization)u.Authorization=`Bearer ${c}`;return u}function l(s){if(s.formData!==void 0){if(s.body!==void 0)throw TypeError("A request carries either `body` or `formData`, not both.");let u=new FormData;for(let[c,p]of Object.entries(s.formData))u.append(c,p);return u}if(s.body===void 0)return;return typeof s.body==="string"?s.body:JSON.stringify(s.body)}async function d(s,u,c={}){let p=await j(),f=u.startsWith("http")?u:`${e}${u}`,y=L(c.query),I=y&&f.includes("?")?`${f}&${y.slice(1)}`:`${f}${y}`,_={method:s,headers:await a(c),body:l(c)},N=await p(new Request(I,_));return U(N)}let i={actingAs(s){return t=s,r=null,i},withHeaders(s){return n={...n,...s},i},request:(s,u,c)=>d(s,u,c),get:(s)=>d("GET",s),post:(s,u)=>d("POST",s,{body:u}),put:(s,u)=>d("PUT",s,{body:u}),patch:(s,u)=>d("PATCH",s,{body:u}),delete:(s,u)=>d("DELETE",s,{body:u})};return i}function fe(e,t){return x(t).actingAs(e)}var me=Object.freeze(["GET","POST","PUT","PATCH","DELETE","HEAD","OPTIONS"].reduce((e,t)=>{let n=async(r,o={})=>{B(o,t,r);let{actingAs:a,...l}=o,d=x();if(a)d.actingAs(a);return d.request(t,r,l)};return{...e,[t.toLowerCase()]:n}},{}));import v from"process";var H=60000;function M(e){let t=[],n="",r=null,o=!1,a=!1;for(let l of e){if(o){n+=l,o=!1;continue}if(l==="\\"){o=!0,a=!0;continue}if(r){if(l===r)r=null;else n+=l;continue}if(l==='"'||l==="'"){r=l,a=!0;continue}if(/\s/.test(l)){if(a)t.push(n),n="",a=!1;continue}n+=l,a=!0}if(r)throw Error(`Unterminated ${r} in command: ${e}`);if(a)t.push(n);return t}function he(e){let t=typeof e==="string"?M(e):[...e],n,r={},o=v.cwd(),a=H;async function l(){if(t.length===0)throw Error("command() needs something to run");let i=Bun.spawn(["./buddy",...t],{cwd:o,env:{...v.env,...r},stdin:n===void 0?"ignore":new TextEncoder().encode(n),stdout:"pipe",stderr:"pipe"}),s=!1,u=setTimeout(()=>{s=!0,i.kill()},a);try{let[c,p,f]=await Promise.all([new Response(i.stdout).text(),new Response(i.stderr).text(),i.exited]);return{exitCode:f,stdout:c,stderr:p,output:c+p,timedOut:s}}finally{clearTimeout(u)}}let d={withInput(i){return n=i.map((s)=>`${s}
+`).join(""),d},withEnv(i){return r={...r,...i},d},withCwd(i){return o=i,d},withTimeout(i){if(!Number.isFinite(i)||i<=0)throw TypeError(`withTimeout expects a positive number of milliseconds, got ${i}`);return a=i,d},then(i,s){return l().then(i,s)}};return d}import{afterEach as J}from"bun:test";import{events as w}from"@stacksjs/events";var m=null,h=[],k=(e,t)=>{h.push({type:String(e),payload:t})};function Re(){if(m)return;m=[...w.all.entries()],w.all.clear(),h=[],w.on("*",k)}function De(){return m!==null}function G(e){if(!m)throw Error('getDispatchedEvents() was called without eventFake(). Nothing is recording, so an empty result would look like "the event did not fire".');return e===void 0?[...h]:h.filter((t)=>t.type===e)}function Ee(e){return G(e).length>0}function z(){if(!m)return;w.off("*",k),w.all.clear();for(let[e,t]of m)w.all.set(e,t);m=null,h=[]}J(()=>{z()});import{afterEach as Q}from"bun:test";import{CaptureEmailDriver as b,mail as O}from"@stacksjs/email";var g=null;function Oe(){if(g!==null)return;g=O.fake(),b.clear()}function Se(){return g!==null}function S(){if(g===null)throw Error('sentEmails() was called without mailFake(). Nothing is capturing, so an empty result would look like "no email was sent".');return[...b.all()]}function Ae(){return S().at(-1)}function Pe(e){let t=(n)=>{if(n===void 0||n===null)return!1;return(Array.isArray(n)?n:[n]).some((o)=>(typeof o==="string"?o:o?.address)===e)};return S().filter((n)=>t(n.to)||t(n.cc)||t(n.bcc))}function V(){if(g===null)return;O.restoreDriver(g),g=null,b.clear()}Q(()=>{V()});import{setSystemTime as A}from"bun:test";function K(e){let t=e instanceof Date?e:new Date(e);if(Number.isNaN(t.getTime()))throw TypeError(`Not a valid time: ${JSON.stringify(e)}`);return t}function W(e=new Date){let t=K(e);return A(t),t}function Fe(e){return W(e)}function qe(){A()}import{mkdtempSync as X,rmSync as Y,writeFileSync as P}from"fs";import{tmpdir as Z}from"os";import{join as T}from"path";import C from"process";var ee=2000;function te(e,t={}){let n=t.mode&&t.mode!=="auto"?t.mode:/\.(?:test|spec)\.[cm]?[jt]sx?$/.test(e)?"test":"run";return[C.execPath,...t.config?[`--config=${t.config}`]:[],...t.envFile===!1?["--no-env-file"]:[],...n==="test"?["test"]:[],e,...t.args??[]]}function ne(e){let t=e.inheritEnv===!1?{}:{...C.env};for(let[n,r]of Object.entries(e.env??{}))if(r===void 0)delete t[n];else t[n]=r;return Object.fromEntries(Object.entries(t).filter((n)=>n[1]!==void 0))}async function je(e,t={}){if(!e||typeof e!=="string")throw TypeError("runIsolated needs a file to run");let n=t.timeoutMs??60000;if(!Number.isFinite(n)||n<=0)throw RangeError("timeoutMs must be a positive number of milliseconds");let r=null,o;if(t.preload){r=X(T(Z(),"stacks-isolated-"));let i=T(r,"noop-preload.ts");P(i,`export {}
+`);let s=JSON.stringify(t.preload.length?t.preload:[i]);o=T(r,"bunfig.toml"),P(o,`preload = ${s}
+
+[test]
+preload = ${s}
+`)}let a=te(e,{...t,config:o}),l=Date.now(),d=!1;try{let i=Bun.spawn(a,{cwd:t.cwd,env:ne(t),stdin:t.stdin!=null?new Blob([t.stdin]):"ignore",stdout:"pipe",stderr:"pipe"}),s,u=setTimeout(()=>{d=!0,i.kill("SIGTERM"),s=setTimeout(()=>i.kill("SIGKILL"),ee)},n);try{let[c,p,f]=await Promise.all([i.exited,new Response(i.stdout).text(),new Response(i.stderr).text()]);return{code:i.signalCode?null:c,signal:i.signalCode==null?null:String(i.signalCode),stdout:p,stderr:f,timedOut:d,durationMs:Date.now()-l,command:a}}finally{if(clearTimeout(u),clearTimeout(s),i.exitCode===null&&!i.signalCode)i.kill("SIGKILL")}}finally{if(r)Y(r,{recursive:!0,force:!0})}}function Ue(e,t){let n=`
+--- stdout ---
+${e.stdout}
+--- stderr ---
+${e.stderr}`;if(e.timedOut)throw Error(`${e.command.slice(1).join(" ")} timed out after ${e.durationMs}ms${n}`);if(e.code!==0)throw Error(`${e.command.slice(1).join(" ")} exited ${e.code??e.signal}${n}`);if(t!=null&&!(typeof t==="string"?e.stdout.includes(t):t.test(e.stdout)))throw Error(`${e.command.slice(1).join(" ")} did not print ${String(t)}${n}`);return e}import{mkdtempSync as re,rmSync as R}from"fs";import{tmpdir as se}from"os";import{join as F}from"path";import oe from"process";var{SQL:q}=globalThis.Bun;var ie=new Set(["localhost","127.0.0.1","[::1]","::1"]);function ae(e={}){return e.url||oe.env.STACKS_TEST_POSTGRES_URL||void 0}function ue(e){let t;try{t=new URL(e)}catch{throw Error("A disposable Postgres database needs a postgres:// URL")}if(!["postgres:","postgresql:"].includes(t.protocol))throw Error(`A disposable Postgres database needs a postgres:// URL, got ${t.protocol}`);if(!ie.has(t.hostname))throw Error(`Disposable databases are only created on a local PostgreSQL server (localhost, 127.0.0.1, ::1), not "${t.hostname}"`);return t}function le(e){return`${(e.toLowerCase().replace(/[^a-z0-9_]/g,"_").replace(/^[^a-z_]+/,"")||"stacks_test").slice(0,38)}_${crypto.randomUUID().replaceAll("-","").slice(0,24)}`}async function de(e,t={}){if(e!=="sqlite"&&e!=="postgres")throw Error(`Disposable databases are sqlite or postgres, not "${String(e)}"`);let n=le(t.prefix??"stacks_test"),r=re(F(se(),`${n.slice(0,20)}-`)),o=!1;if(e==="sqlite"){let a=F(r,`${n}.sqlite`),l=async()=>{if(o)return;o=!0,R(r,{recursive:!0,force:!0})};return{dialect:e,name:n,directory:r,path:a,env:{DB_CONNECTION:"sqlite",DB_DATABASE_PATH:a},drop:l,[Symbol.asyncDispose]:l}}try{let a=ae(t);if(!a)throw Error("A disposable Postgres database needs a server: pass options.url or set STACKS_TEST_POSTGRES_URL");let l=ue(a),d=new q(l.href);try{await d.unsafe(`CREATE DATABASE "${n}"`)}finally{await d.close()}let i=new URL(l.href);i.pathname=`/${n}`;let s=async()=>{if(o)return;o=!0;let u=new q(l.href);try{await u.unsafe(`DROP DATABASE IF EXISTS "${n}" WITH (FORCE)`)}finally{await u.close(),R(r,{recursive:!0,force:!0})}};return{dialect:e,name:n,directory:r,url:i.href,env:{DB_CONNECTION:"postgres",DB_HOST:l.hostname.replace(/^\[|\]$/g,""),DB_PORT:l.port||"5432",DB_DATABASE:n,DB_USERNAME:decodeURIComponent(l.username),DB_PASSWORD:decodeURIComponent(l.password)},drop:s,[Symbol.asyncDispose]:s}}catch(a){throw R(r,{recursive:!0,force:!0}),a}}async function Ve(e,t,n={}){let r=await de(e,n),o;try{o=await t(r)}catch(a){throw await r.drop().catch(()=>{}),a}return await r.drop(),o}export*from"bun:test";export{fe as actingAs,Ue as assertIsolatedOk,ue as assertLocalPostgres,B as assertRequestOptions,he as command,de as createDisposableDatabase,ae as disposablePostgresUrl,Pe as emailsTo,Re as eventFake,De as eventsAreFaked,x as featureTest,W as freezeTime,G as getDispatchedEvents,Ee as hasDispatchedEvent,me as http,te as isolatedCommand,Ae as lastEmail,Oe as mailFake,Se as mailIsFaked,L as queryString,z as restoreEvents,V as restoreMail,je as runIsolated,S as sentEmails,pe as setupTestEnvironment,M as splitCommand,Fe as travelTo,qe as useRealTime,Ve as withDisposableDatabase};

package/dist/isolated.d.ts

@@ -0,0 +1,41 @@
+/** The full Bun command line `runIsolated` would spawn for these options. */
+export declare function isolatedCommand(file: string, options?: Pick<RunIsolatedOptions, 'mode' | 'args' | 'envFile'> & { config?: string }): string[];
+/**
+ * Run `file` in a fresh Bun process and collect what it printed.
+ *
+ * @example
+ * const result = await runIsolated('tests/fixtures/billing-flow.ts', {
+ *   env: { APP_ENV: 'test', DB_CONNECTION: 'sqlite', DB_DATABASE_PATH: path },
+ *   timeoutMs: 45_000,
+ * })
+ * expect(result.code, result.stdout + result.stderr).toBe(0)
+ */
+export declare function runIsolated(file: string, options?: RunIsolatedOptions): Promise<IsolatedResult>;
+/**
+ * Throw, with everything the child printed, unless it exited 0 (and printed
+ * `expect` to stdout, when given). Returns the result for further checks.
+ *
+ * @example
+ * assertIsolatedOk(await runIsolated('tests/fixtures/flow.ts'), 'flow OK')
+ */
+export declare function assertIsolatedOk(result: IsolatedResult, expect?: string | RegExp): IsolatedResult;
+export declare interface RunIsolatedOptions {
+  env?: Record<string, string | undefined>
+  inheritEnv?: boolean
+  timeoutMs?: number
+  args?: string[]
+  cwd?: string
+  mode?: 'auto' | 'test' | 'run'
+  preload?: string[]
+  envFile?: boolean
+  stdin?: string
+}
+export declare interface IsolatedResult {
+  code: number | null
+  signal: string | null
+  stdout: string
+  stderr: string
+  timedOut: boolean
+  durationMs: number
+  command: string[]
+}

package/dist/isolated.js

@@ -0,0 +1,11 @@
+// @bun
+import{mkdtempSync as R,rmSync as y,writeFileSync as u}from"fs";import{tmpdir as I}from"os";import{join as d}from"path";import c from"process";var v=2000;function b(t,e={}){let n=e.mode&&e.mode!=="auto"?e.mode:/\.(?:test|spec)\.[cm]?[jt]sx?$/.test(t)?"test":"run";return[c.execPath,...e.config?[`--config=${e.config}`]:[],...e.envFile===!1?["--no-env-file"]:[],...n==="test"?["test"]:[],t,...e.args??[]]}function h(t){let e=t.inheritEnv===!1?{}:{...c.env};for(let[n,r]of Object.entries(t.env??{}))if(r===void 0)delete e[n];else e[n]=r;return Object.fromEntries(Object.entries(e).filter((n)=>n[1]!==void 0))}async function k(t,e={}){if(!t||typeof t!=="string")throw TypeError("runIsolated needs a file to run");let n=e.timeoutMs??60000;if(!Number.isFinite(n)||n<=0)throw RangeError("timeoutMs must be a positive number of milliseconds");let r=null,s;if(e.preload){r=R(d(I(),"stacks-isolated-"));let i=d(r,"noop-preload.ts");u(i,`export {}
+`);let o=JSON.stringify(e.preload.length?e.preload:[i]);s=d(r,"bunfig.toml"),u(s,`preload = ${o}
+
+[test]
+preload = ${o}
+`)}let l=b(t,{...e,config:s}),m=Date.now(),a=!1;try{let i=Bun.spawn(l,{cwd:e.cwd,env:h(e),stdin:e.stdin!=null?new Blob([e.stdin]):"ignore",stdout:"pipe",stderr:"pipe"}),o,g=setTimeout(()=>{a=!0,i.kill("SIGTERM"),o=setTimeout(()=>i.kill("SIGKILL"),v)},n);try{let[f,p,w]=await Promise.all([i.exited,new Response(i.stdout).text(),new Response(i.stderr).text()]);return{code:i.signalCode?null:f,signal:i.signalCode==null?null:String(i.signalCode),stdout:p,stderr:w,timedOut:a,durationMs:Date.now()-m,command:l}}finally{if(clearTimeout(g),clearTimeout(o),i.exitCode===null&&!i.signalCode)i.kill("SIGKILL")}}finally{if(r)y(r,{recursive:!0,force:!0})}}function M(t,e){let n=`
+--- stdout ---
+${t.stdout}
+--- stderr ---
+${t.stderr}`;if(t.timedOut)throw Error(`${t.command.slice(1).join(" ")} timed out after ${t.durationMs}ms${n}`);if(t.code!==0)throw Error(`${t.command.slice(1).join(" ")} exited ${t.code??t.signal}${n}`);if(e!=null&&!(typeof e==="string"?t.stdout.includes(e):e.test(t.stdout)))throw Error(`${t.command.slice(1).join(" ")} did not print ${String(e)}${n}`);return t}export{M as assertIsolatedOk,b as isolatedCommand,k as runIsolated};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/testing",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.226",
+  "version": "0.75.230",
   "description": "The Stacks way of testing.",
   "author": "Chris Breuer",
   "contributors": [
@@ -42,6 +42,12 @@
       "import": "./dist/database.js",
       "default": "./dist/database.js"
     },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "bun": "./dist/browser.js",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
     "./dynamodb": {
       "types": "./dist/dynamodb.d.ts",
       "bun": "./dist/dynamodb.js",
@@ -73,16 +79,16 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/auth": "0.75.226",
-    "@stacksjs/cache": "0.75.226",
-    "@stacksjs/config": "0.75.226",
-    "@stacksjs/database": "0.75.226",
-    "@stacksjs/email": "0.75.226",
-    "@stacksjs/events": "0.75.226",
-    "@stacksjs/path": "0.75.226",
-    "@stacksjs/router": "0.75.226",
-    "@stacksjs/storage": "0.75.226",
-    "@stacksjs/strings": "0.75.226",
+    "@stacksjs/auth": "0.75.230",
+    "@stacksjs/cache": "0.75.230",
+    "@stacksjs/config": "0.75.230",
+    "@stacksjs/database": "0.75.230",
+    "@stacksjs/email": "0.75.230",
+    "@stacksjs/events": "0.75.230",
+    "@stacksjs/path": "0.75.230",
+    "@stacksjs/router": "0.75.230",
+    "@stacksjs/storage": "0.75.230",
+    "@stacksjs/strings": "0.75.230",
     "@stacksjs/ts-cloud": "^0.16.58",
     "very-happy-dom": "^0.3.5"
   },