@stacksjs/testing 0.75.305 → 0.75.308

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/browser.d.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import process from 'node:process';
1
2
  /**
2
3
  * Poll `read` until it returns something truthy, and return that. Throws
3
4
  * after `timeoutMs` (default 12 s) with `label` in the message.
@@ -152,6 +153,8 @@ export declare interface ChromeLaunchDiagnostics {
152
153
  profile: string
153
154
  temporaryProfile: boolean
154
155
  elapsedMs: number
156
+ phase?: ChromeStartupPhase
157
+ phaseStartedMs?: Partial<Record<ChromeStartupPhase, number>>
155
158
  exitCodeBeforeCleanup: number | null
156
159
  signalCodeBeforeCleanup: string | number | null
157
160
  exitCode: number | null
@@ -210,6 +213,7 @@ export declare interface PageAuditReport {
210
213
  declare type Listener = (params: any) => void;
211
214
  /** Answers a paused request with `cdp.send('Fetch.continueRequest' | 'Fetch.fulfillRequest' | ...)`. */
212
215
  export type FetchHandler = (request: PausedRequest, cdp: Cdp) => void | Promise<void>;
216
+ export type ChromeStartupPhase = 'process-acquire' | 'process-start' | 'devtools-port' | 'browser-connect' | 'context-create' | 'target-create' | 'target-discovery' | 'page-connect' | 'page-prepare';
213
217
  /** What happened during a visit, in order, for `splitPageLoads`. */
214
218
  export type PageAuditEvent = | { type: 'request', request: string }
215
219
  /** `sameDocument`: a history API or fragment navigation (`Page.navigatedWithinDocument`), not a new document. */
package/dist/browser.js CHANGED
@@ -1,8 +1,8 @@
1
1
  // @bun
2
- import{closeSync as ee,existsSync as S,mkdirSync as te,mkdtempSync as W,openSync as re,readSync as ne,renameSync as se,rmSync as x}from"fs";import{tmpdir as V}from"os";import{join as v}from"path";import P from"process";async function K(t,e=12000,r={}){let s=Date.now(),n=await t();while(!n&&Date.now()-s<e)await Bun.sleep(r.intervalMs??100),n=await t();if(!n)throw Error(`Timed out after ${e}ms${r.label?` waiting for ${r.label}`:""}`);return n}var oe=new Set(["Fetch.continueRequest","Fetch.fulfillRequest","Fetch.failRequest","Fetch.continueResponse"]);function ie(t,e){let r="";for(let s=0;s<t.length;s++){let n=t[s];if(n==="\\"&&s+1<t.length)r+=_(t[++s]);else if(n==="*")r+="[\\s\\S]*";else if(n==="?")r+="[\\s\\S]";else r+=_(n)}return new RegExp(`^${r}$`).test(e)}function _(t){return t.replace(/[.*+?^${}()|[\]\\/]/g,"\\$&")}function B(t,e){let r=e.responseStatusCode!=null||e.responseErrorReason!=null?"Response":"Request";if((t.requestStage??"Request")!==r)return!1;if(t.resourceType&&t.resourceType!==e.resourceType)return!1;return ie(t.urlPattern??"*",e.request?.url??"")}class J{socket;id=0;pending=new Map;listeners=new Map;commandTimeoutMs;interceptors=[];ownFetch=null;answered=new Map;frameLoaders=new Map;requestLoaders=new Map;errors=[];inFlight=new Map;closed=!1;constructor(t,e={}){this.socket=t;this.commandTimeoutMs=e.commandTimeoutMs??30000,t.addEventListener("close",()=>this.markClosed()),t.addEventListener("message",(r)=>this.receive(String(r.data)))}markClosed(){this.closed=!0,this.frameLoaders.clear(),this.requestLoaders.clear();for(let[t,e]of this.pending)clearTimeout(e.timer),e.reject(Error("Chrome closed the connection")),this.pending.delete(t)}receive(t){let e;try{e=JSON.parse(t)}catch{return}if(e.id){let r=this.pending.get(e.id);if(!r)return;if(this.pending.delete(e.id),clearTimeout(r.timer),e.error)r.reject(Error(e.error.message));else r.resolve(e.result);return}if(this.track(e.method,e.params??{}),e.method==="Fetch.requestPaused"&&!this.routePaused(e.params??{}))return;this.dispatch(e.method,e.params??{})}dispatch(t,e){for(let r of[...this.listeners.get(t)??[]])try{r(e)}catch(s){this.errors.push(`Listener for ${t} threw: ${s?.message??String(s)}`)}}routePaused(t){this.remember(t.requestId,!1);let e=this.interceptors.filter((n)=>n.patterns.some((o)=>B(o,t)));for(let n of e)try{let o=n.handler(t,this);if(o&&typeof o.catch==="function")o.catch((a)=>this.errors.push(`Fetch handler threw: ${a?.message??String(a)}`))}catch(o){this.errors.push(`Fetch handler threw: ${o?.message??String(o)}`)}let r=(this.listeners.get("Fetch.requestPaused")?.size??0)>0,s=this.ownFetch?this.ownFetch.patterns.some((n)=>B(n,t)):!1;if(!e.length&&!s&&!r)this.send("Fetch.continueRequest",{requestId:t.requestId}).catch(()=>{});return r&&(s||!e.length)}remember(t,e){if(this.answered.delete(t),this.answered.set(t,e),this.answered.size>2000){for(let[r]of this.answered)if(this.answered.delete(r),this.answered.size<=1000)break}}async applyFetch(){let t=[...this.interceptors.flatMap((e)=>e.patterns),...this.ownFetch?.patterns??[]];if(!t.length)return await this.command("Fetch.disable");return await this.command("Fetch.enable",{...this.ownFetch?.params,patterns:t})}async intercept(t,e){if(!t.length)throw TypeError("intercept needs at least one pattern");let r={patterns:t.map((n)=>({...n})),handler:e};this.interceptors.push(r);try{await this.applyFetch()}catch(n){throw this.interceptors=this.interceptors.filter((o)=>o!==r),n}let s=!1;return async()=>{if(s)return;if(s=!0,this.interceptors=this.interceptors.filter((n)=>n!==r),!this.closed)await this.applyFetch()}}finishRequest(t){this.inFlight.delete(t),this.requestLoaders.delete(t)}retireFrameRequests(t,e){for(let[r,s]of this.requestLoaders)if(s.frameId===t&&(e===void 0||s.loaderId===e))this.finishRequest(r)}track(t,e){if(t==="Network.requestWillBeSent"){let{requestId:r,frameId:s,loaderId:n}=e;if(this.requestLoaders.delete(r),s&&n)this.requestLoaders.set(r,{frameId:s,loaderId:n});this.inFlight.set(e.requestId,`${e.request?.method} ${e.request?.url}`)}else if(t==="Network.loadingFinished"||t==="Network.loadingFailed")this.finishRequest(e.requestId);else if(t==="Network.responseReceived"&&e.response?.mimeType==="text/event-stream")this.finishRequest(e.requestId);else if(t==="Page.frameNavigated"&&e.frame?.id&&e.frame?.loaderId){let{id:r,loaderId:s}=e.frame,n=this.frameLoaders.get(r);if(n&&n!==s)this.retireFrameRequests(r,n);this.frameLoaders.set(r,s)}else if(t==="Page.frameDetached"&&e.reason==="remove")this.frameLoaders.delete(e.frameId),this.retireFrameRequests(e.frameId);if(t==="Runtime.exceptionThrown")this.errors.push(e.exceptionDetails?.exception?.description||e.exceptionDetails?.text||"Runtime exception");else if(t==="Runtime.consoleAPICalled"&&e.type==="error")this.errors.push((e.args||[]).map((r)=>r.value??r.description??"").join(" "));else if(t==="Log.entryAdded"&&e.entry?.level==="error"&&!String(e.entry.text).includes("favicon"))this.errors.push(e.entry.text);else if(t==="Network.loadingFailed"&&!e.canceled)this.errors.push(`Network: ${e.errorText||"request failed"}`)}on(t,e){let r=this.listeners.get(t);if(!r)this.listeners.set(t,r=new Set);return r.add(e),()=>this.off(t,e)}off(t,e){this.listeners.get(t)?.delete(e)}once(t,e=()=>!0,r=this.commandTimeoutMs){return new Promise((s,n)=>{if(this.closed)return n(Error("Chrome closed the connection"));let o=setTimeout(()=>{i(),clearInterval(a),n(Error(`Timed out after ${r}ms waiting for ${t}`))},r),a=setInterval(()=>{if(!this.closed)return;clearTimeout(o),clearInterval(a),i(),n(Error("Chrome closed the connection"))},100),i=this.on(t,(d)=>{if(!e(d))return;clearTimeout(o),clearInterval(a),i(),s(d)})})}send(t,e={}){if(t==="Fetch.enable"){let{patterns:r,...s}=e;return this.ownFetch={patterns:r?.length?r.map((n)=>({...n})):[{urlPattern:"*"}],params:s},this.closed?this.command(t,e):this.applyFetch()}if(t==="Fetch.disable")return this.ownFetch=null,this.closed?this.command(t,e):this.applyFetch();if(oe.has(t)&&typeof e.requestId==="string"){if(this.answered.get(e.requestId)===!0)return Promise.resolve({});if(this.answered.has(e.requestId))this.remember(e.requestId,!0)}return this.command(t,e)}command(t,e={}){let r=++this.id;return new Promise((s,n)=>{if(this.closed)return n(Error("Chrome closed the connection"));let o=setTimeout(()=>{this.pending.delete(r),n(Error(`Chrome command timed out: ${t}`))},this.commandTimeoutMs);this.pending.set(r,{resolve:s,reject:n,timer:o}),this.socket.send(JSON.stringify({id:r,method:t,params:e}))})}async evaluate(t){let e=await this.send("Runtime.evaluate",{expression:t,awaitPromise:!0,returnByValue:!0});if(e.exceptionDetails)throw Error(e.exceptionDetails.exception?.description||e.exceptionDetails.text);return e.result?.value}disconnect(){this.markClosed();try{this.socket.close()}catch{}}}async function O(t,e={}){let r=new WebSocket(t);return await new Promise((s,n)=>{let o=(u)=>{if(clearTimeout(d),r.removeEventListener("open",a),r.removeEventListener("error",i),r.removeEventListener("close",i),u){try{r.close()}catch{}n(u)}else s()},a=()=>o(),i=()=>o(Error(`Could not connect to Chrome at ${t}`)),d=setTimeout(()=>o(Error(`Timed out connecting to Chrome at ${t}`)),e.connectTimeoutMs??30000);r.addEventListener("open",a,{once:!0}),r.addEventListener("error",i,{once:!0}),r.addEventListener("close",i,{once:!0})}),new J(r,e)}var z=["/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"],ae=["google-chrome","google-chrome-stable","chromium","chromium-browser","chrome"],Y=["KSProductID","KSUpdateURL","KSChannelID","KSVersion"],N="dev.stacks.testing.chrome";function ce(){if(P.env.CHROME_PATH)return P.env.CHROME_PATH;if(P.platform==="darwin"){let t=z.find((e)=>S(e));if(t)return t}for(let t of ae){let e=Bun.which(t);if(e)return e}return null}function Q(t){let e=/^(.*?\.app)\/Contents\/MacOS\/[^/]+$/.exec(t);return e?e[1]:null}function T(t,e){let r=Bun.spawnSync(["/usr/libexec/PlistBuddy","-c",e,t],{stdout:"pipe",stderr:"pipe"});return{ok:r.exitCode===0,out:r.stdout.toString().trim()}}function le(t){let e=Q(t);if(!e||P.platform!=="darwin")return!1;let r=v(e,"Contents/Info.plist");return S(r)&&Y.some((s)=>T(r,`Print :${s}`).ok)}function ue(t={}){if(P.platform!=="darwin")throw Error("prepareMacChrome is for macOS; elsewhere launch Chrome as installed");let e=t.source??z[0],r=Q(e);if(!r||!S(r))throw Error(`No Chrome app bundle at ${e}`);let s=v(r,"Contents/Info.plist"),n=T(s,"Print :CFBundleShortVersionString").out||"unknown",o=T(s,"Print :CFBundleExecutable").out||"Google Chrome",a=t.directory??v(V(),`stacks-chrome-${n.replace(/[^\w.-]/g,"_")}`),i=v(a,"Chrome.app"),d=v(i,"Contents/MacOS",o),u=v(i,"Contents/Info.plist");if(S(d)&&T(u,"Print :CFBundleIdentifier").out===N&&T(u,"Print :CFBundleShortVersionString").out===n)return{executable:d,app:i,reused:!0};te(a,{recursive:!0});let h=W(v(a,"staging-")),w=v(h,"Chrome.app"),l=(p,y)=>{let f=Bun.spawnSync(p,{stdout:"pipe",stderr:"pipe"});if(f.exitCode!==0)throw Error(`${y} failed: ${f.stderr.toString().trim()}`)};try{l(["/bin/cp","-cR",r,w],"Cloning Chrome");let p=v(w,"Contents/Info.plist");for(let y of Y)T(p,`Delete :${y}`);l(["/usr/libexec/PlistBuddy","-c",`Set :CFBundleIdentifier ${N}`,p],"Renaming the Chrome bundle"),l(["codesign","--force","--deep","--sign","-",w],"Re-signing Chrome"),x(i,{recursive:!0,force:!0}),se(w,i)}finally{x(h,{recursive:!0,force:!0})}return{executable:d,app:i,reused:!1}}class k extends Error{diagnostics;constructor(t,e){super(`${t instanceof Error?t.message:String(t)}
3
- Chrome startup: ${JSON.stringify(e)}`,{cause:t});this.diagnostics=e;this.name="ChromeLaunchError"}}async function q(t,e){let r;try{return await Promise.race([t.then(()=>!0),new Promise((s)=>{r=setTimeout(()=>s(!1),e)})])}finally{clearTimeout(r)}}function D(t){let e;try{e=re(t,"r");let r=Buffer.alloc(1024);return r.subarray(0,ne(e,r,0,r.length,0)).toString("utf8")}catch{return null}finally{if(e!==void 0)try{ee(e)}catch{}}}var de=["*/_stx/hmr*"];async function he(t,e=de){if(!e.length)return async()=>{};return await t.intercept(e.map((r)=>({urlPattern:r})),(r,s)=>{s.send("Fetch.fulfillRequest",{requestId:r.requestId,responseCode:200,responseHeaders:[{name:"Content-Type",value:"text/event-stream"}],body:Buffer.from(`retry: 86400000
2
+ import{closeSync as oe,existsSync as E,mkdirSync as ie,mkdtempSync as J,openSync as ae,readSync as ce,renameSync as le,rmSync as R}from"fs";import{tmpdir as z}from"os";import{join as v}from"path";import P from"process";async function Y(t,e=12000,r={}){let n=Date.now(),s=await t();while(!s&&Date.now()-n<e)await Bun.sleep(r.intervalMs??100),s=await t();if(!s)throw Error(`Timed out after ${e}ms${r.label?` waiting for ${r.label}`:""}`);return s}var ue=new Set(["Fetch.continueRequest","Fetch.fulfillRequest","Fetch.failRequest","Fetch.continueResponse"]);function de(t,e){let r="";for(let n=0;n<t.length;n++){let s=t[n];if(s==="\\"&&n+1<t.length)r+=U(t[++n]);else if(s==="*")r+="[\\s\\S]*";else if(s==="?")r+="[\\s\\S]";else r+=U(s)}return new RegExp(`^${r}$`).test(e)}function U(t){return t.replace(/[.*+?^${}()|[\]\\/]/g,"\\$&")}function H(t,e){let r=e.responseStatusCode!=null||e.responseErrorReason!=null?"Response":"Request";if((t.requestStage??"Request")!==r)return!1;if(t.resourceType&&t.resourceType!==e.resourceType)return!1;return de(t.urlPattern??"*",e.request?.url??"")}class Q{socket;id=0;pending=new Map;listeners=new Map;commandTimeoutMs;interceptors=[];ownFetch=null;answered=new Map;frameLoaders=new Map;requestLoaders=new Map;errors=[];inFlight=new Map;closed=!1;constructor(t,e={}){this.socket=t;this.commandTimeoutMs=e.commandTimeoutMs??30000,t.addEventListener("close",()=>this.markClosed()),t.addEventListener("message",(r)=>this.receive(String(r.data)))}markClosed(){this.closed=!0,this.frameLoaders.clear(),this.requestLoaders.clear();for(let[t,e]of this.pending)clearTimeout(e.timer),e.reject(Error("Chrome closed the connection")),this.pending.delete(t)}receive(t){let e;try{e=JSON.parse(t)}catch{return}if(e.id){let r=this.pending.get(e.id);if(!r)return;if(this.pending.delete(e.id),clearTimeout(r.timer),e.error)r.reject(Error(e.error.message));else r.resolve(e.result);return}if(this.track(e.method,e.params??{}),e.method==="Fetch.requestPaused"&&!this.routePaused(e.params??{}))return;this.dispatch(e.method,e.params??{})}dispatch(t,e){for(let r of[...this.listeners.get(t)??[]])try{r(e)}catch(n){this.errors.push(`Listener for ${t} threw: ${n?.message??String(n)}`)}}routePaused(t){this.remember(t.requestId,!1);let e=this.interceptors.filter((s)=>s.patterns.some((o)=>H(o,t)));for(let s of e)try{let o=s.handler(t,this);if(o&&typeof o.catch==="function")o.catch((a)=>this.errors.push(`Fetch handler threw: ${a?.message??String(a)}`))}catch(o){this.errors.push(`Fetch handler threw: ${o?.message??String(o)}`)}let r=(this.listeners.get("Fetch.requestPaused")?.size??0)>0,n=this.ownFetch?this.ownFetch.patterns.some((s)=>H(s,t)):!1;if(!e.length&&!n&&!r)this.send("Fetch.continueRequest",{requestId:t.requestId}).catch(()=>{});return r&&(n||!e.length)}remember(t,e){if(this.answered.delete(t),this.answered.set(t,e),this.answered.size>2000){for(let[r]of this.answered)if(this.answered.delete(r),this.answered.size<=1000)break}}async applyFetch(){let t=[...this.interceptors.flatMap((e)=>e.patterns),...this.ownFetch?.patterns??[]];if(!t.length)return await this.command("Fetch.disable");return await this.command("Fetch.enable",{...this.ownFetch?.params,patterns:t})}async intercept(t,e){if(!t.length)throw TypeError("intercept needs at least one pattern");let r={patterns:t.map((s)=>({...s})),handler:e};this.interceptors.push(r);try{await this.applyFetch()}catch(s){throw this.interceptors=this.interceptors.filter((o)=>o!==r),s}let n=!1;return async()=>{if(n)return;if(n=!0,this.interceptors=this.interceptors.filter((s)=>s!==r),!this.closed)await this.applyFetch()}}finishRequest(t){this.inFlight.delete(t),this.requestLoaders.delete(t)}retireFrameRequests(t,e){for(let[r,n]of this.requestLoaders)if(n.frameId===t&&(e===void 0||n.loaderId===e))this.finishRequest(r)}track(t,e){if(t==="Network.requestWillBeSent"){let{requestId:r,frameId:n,loaderId:s}=e;if(this.requestLoaders.delete(r),n&&s)this.requestLoaders.set(r,{frameId:n,loaderId:s});this.inFlight.set(e.requestId,`${e.request?.method} ${e.request?.url}`)}else if(t==="Network.loadingFinished"||t==="Network.loadingFailed")this.finishRequest(e.requestId);else if(t==="Network.responseReceived"&&e.response?.mimeType==="text/event-stream")this.finishRequest(e.requestId);else if(t==="Page.frameNavigated"&&e.frame?.id&&e.frame?.loaderId){let{id:r,loaderId:n}=e.frame,s=this.frameLoaders.get(r);if(s&&s!==n)this.retireFrameRequests(r,s);this.frameLoaders.set(r,n)}else if(t==="Page.frameDetached"&&e.reason==="remove")this.frameLoaders.delete(e.frameId),this.retireFrameRequests(e.frameId);if(t==="Runtime.exceptionThrown")this.errors.push(e.exceptionDetails?.exception?.description||e.exceptionDetails?.text||"Runtime exception");else if(t==="Runtime.consoleAPICalled"&&e.type==="error")this.errors.push((e.args||[]).map((r)=>r.value??r.description??"").join(" "));else if(t==="Log.entryAdded"&&e.entry?.level==="error"&&!String(e.entry.text).includes("favicon"))this.errors.push(e.entry.text);else if(t==="Network.loadingFailed"&&!e.canceled)this.errors.push(`Network: ${e.errorText||"request failed"}`)}on(t,e){let r=this.listeners.get(t);if(!r)this.listeners.set(t,r=new Set);return r.add(e),()=>this.off(t,e)}off(t,e){this.listeners.get(t)?.delete(e)}once(t,e=()=>!0,r=this.commandTimeoutMs){return new Promise((n,s)=>{if(this.closed)return s(Error("Chrome closed the connection"));let o=setTimeout(()=>{i(),clearInterval(a),s(Error(`Timed out after ${r}ms waiting for ${t}`))},r),a=setInterval(()=>{if(!this.closed)return;clearTimeout(o),clearInterval(a),i(),s(Error("Chrome closed the connection"))},100),i=this.on(t,(c)=>{if(!e(c))return;clearTimeout(o),clearInterval(a),i(),n(c)})})}send(t,e={}){if(t==="Fetch.enable"){let{patterns:r,...n}=e;return this.ownFetch={patterns:r?.length?r.map((s)=>({...s})):[{urlPattern:"*"}],params:n},this.closed?this.command(t,e):this.applyFetch()}if(t==="Fetch.disable")return this.ownFetch=null,this.closed?this.command(t,e):this.applyFetch();if(ue.has(t)&&typeof e.requestId==="string"){if(this.answered.get(e.requestId)===!0)return Promise.resolve({});if(this.answered.has(e.requestId))this.remember(e.requestId,!0)}return this.command(t,e)}command(t,e={}){let r=++this.id;return new Promise((n,s)=>{if(this.closed)return s(Error("Chrome closed the connection"));let o=setTimeout(()=>{this.pending.delete(r),s(Error(`Chrome command timed out: ${t}`))},this.commandTimeoutMs);this.pending.set(r,{resolve:n,reject:s,timer:o}),this.socket.send(JSON.stringify({id:r,method:t,params:e}))})}async evaluate(t){let e=await this.send("Runtime.evaluate",{expression:t,awaitPromise:!0,returnByValue:!0});if(e.exceptionDetails)throw Error(e.exceptionDetails.exception?.description||e.exceptionDetails.text);return e.result?.value}disconnect(){this.markClosed();try{this.socket.close()}catch{}}}async function B(t,e={}){let r=new WebSocket(t);return await new Promise((n,s)=>{let o=(u)=>{if(clearTimeout(c),r.removeEventListener("open",a),r.removeEventListener("error",i),r.removeEventListener("close",i),u){try{r.close()}catch{}s(u)}else n()},a=()=>o(),i=()=>o(Error(`Could not connect to Chrome at ${t}`)),c=setTimeout(()=>o(Error(`Timed out connecting to Chrome at ${t}`)),e.connectTimeoutMs??30000);r.addEventListener("open",a,{once:!0}),r.addEventListener("error",i,{once:!0}),r.addEventListener("close",i,{once:!0})}),new Q(r,e)}var X=["/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"],he=["google-chrome","google-chrome-stable","chromium","chromium-browser","chrome"],Z=["KSProductID","KSUpdateURL","KSChannelID","KSVersion"],j="dev.stacks.testing.chrome";function pe(){if(P.env.CHROME_PATH)return P.env.CHROME_PATH;if(P.platform==="darwin"){let t=X.find((e)=>E(e));if(t)return t}for(let t of he){let e=Bun.which(t);if(e)return e}return null}function ee(t){let e=/^(.*?\.app)\/Contents\/MacOS\/[^/]+$/.exec(t);return e?e[1]:null}function x(t,e){let r=Bun.spawnSync(["/usr/libexec/PlistBuddy","-c",e,t],{stdout:"pipe",stderr:"pipe"});return{ok:r.exitCode===0,out:r.stdout.toString().trim()}}function fe(t){let e=ee(t);if(!e||P.platform!=="darwin")return!1;let r=v(e,"Contents/Info.plist");return E(r)&&Z.some((n)=>x(r,`Print :${n}`).ok)}function me(t={}){if(P.platform!=="darwin")throw Error("prepareMacChrome is for macOS; elsewhere launch Chrome as installed");let e=t.source??X[0],r=ee(e);if(!r||!E(r))throw Error(`No Chrome app bundle at ${e}`);let n=v(r,"Contents/Info.plist"),s=x(n,"Print :CFBundleShortVersionString").out||"unknown",o=x(n,"Print :CFBundleExecutable").out||"Google Chrome",a=t.directory??v(z(),`stacks-chrome-${s.replace(/[^\w.-]/g,"_")}`),i=v(a,"Chrome.app"),c=v(i,"Contents/MacOS",o),u=v(i,"Contents/Info.plist");if(E(c)&&x(u,"Print :CFBundleIdentifier").out===j&&x(u,"Print :CFBundleShortVersionString").out===s)return{executable:c,app:i,reused:!0};ie(a,{recursive:!0});let f=J(v(a,"staging-")),g=v(f,"Chrome.app"),w=(d,b)=>{let h=Bun.spawnSync(d,{stdout:"pipe",stderr:"pipe"});if(h.exitCode!==0)throw Error(`${b} failed: ${h.stderr.toString().trim()}`)};try{w(["/bin/cp","-cR",r,g],"Cloning Chrome");let d=v(g,"Contents/Info.plist");for(let b of Z)x(d,`Delete :${b}`);w(["/usr/libexec/PlistBuddy","-c",`Set :CFBundleIdentifier ${j}`,d],"Renaming the Chrome bundle"),w(["codesign","--force","--deep","--sign","-",g],"Re-signing Chrome"),R(i,{recursive:!0,force:!0}),le(g,i)}finally{R(f,{recursive:!0,force:!0})}return{executable:c,app:i,reused:!1}}function C(t,e){t.phase=e,t.phaseStartedMs[e]=Date.now()-t.started}class _ extends Error{diagnostics;constructor(t,e){super(`${t instanceof Error?t.message:String(t)}
3
+ Chrome startup: ${JSON.stringify(e)}`,{cause:t});this.diagnostics=e;this.name="ChromeLaunchError"}}async function L(t,e){let r;try{return await Promise.race([t.then(()=>!0),new Promise((n)=>{r=setTimeout(()=>n(!1),e)})])}finally{clearTimeout(r)}}function O(t){let e;try{e=ae(t,"r");let r=Buffer.alloc(1024);return r.subarray(0,ce(e,r,0,r.length,0)).toString("utf8")}catch{return null}finally{if(e!==void 0)try{oe(e)}catch{}}}var ge=["*/_stx/hmr*"];async function we(t,e=ge){if(!e.length)return async()=>{};return await t.intercept(e.map((r)=>({urlPattern:r})),(r,n)=>{n.send("Fetch.fulfillRequest",{requestId:r.requestId,responseCode:200,responseHeaders:[{name:"Content-Type",value:"text/event-stream"}],body:Buffer.from(`retry: 86400000
4
4
 
5
- `).toString("base64")}).catch(()=>{})})}function fe(t){let e=t.chromePath??P.env.CHROME_PATH;if(e)return e;let r=ce();if(!r)throw Error("No Chrome found: install Google Chrome or Chromium, or set CHROME_PATH");if((t.stableMacChrome??!0)&&P.platform==="darwin"&&le(r))return ue({source:r}).executable;return r}async function X(t,e,r,s){if(!S(e))throw Error(`Chrome was not found at ${e}`);let n=t.profile||W(v(V(),"stacks-browser-"));x(v(n,"DevToolsActivePort"),{force:!0});let o=v(n,"DevToolsActivePort"),a=(()=>{try{return Bun.spawn([e,...t.headless===!1?[]:["--headless=new"],"--remote-debugging-port=0",`--user-data-dir=${n}`,"--no-first-run","--no-default-browser-check","--disable-background-networking","--disable-component-update","--disable-extensions","--hide-scrollbars","--use-mock-keychain",...t.args??[],"about:blank"],{stdin:"ignore",stdout:"ignore",stderr:"pipe"})}catch(g){let c=null;try{if(!t.profile)x(n,{recursive:!0,force:!0})}catch(m){c=String(m)}throw new k(g,{pid:null,chromePath:e,profile:n,temporaryProfile:!t.profile,elapsedMs:Date.now()-r,exitCodeBeforeCleanup:null,signalCodeBeforeCleanup:null,exitCode:null,signalCode:null,portFileExisted:!1,portFileContents:null,stderrTail:"",stderrTruncated:!1,cleanupError:c})}})(),i="",d=!1,u,h=Promise.resolve(),w,l=()=>w??=(async()=>{let g=!1,c=[];try{if(a.exitCode===null&&a.signalCode===null)try{a.kill("SIGTERM")}catch{}if(!await q(a.exited,2000)){try{a.kill("SIGKILL")}catch{}if(!await q(a.exited,2000))throw Error(`Chrome process ${a.pid} did not exit after SIGKILL`)}g=!0}catch(m){c.push(String(m)),g=a.exitCode!==null||a.signalCode!==null}finally{try{if(!await q(h,100)&&u){if(!await q(u.cancel(),100))throw Error("Chrome stderr cancellation did not finish")}if(!await q(h,100))throw Error("Chrome stderr reader did not finish")}catch(m){c.push(String(m))}finally{if(g&&!t.profile)try{x(n,{recursive:!0,force:!0})}catch(m){c.push(String(m))}}}if(c.length)throw Error(`Chrome cleanup failed: ${c.join("; ")}`)})(),p=()=>a.exitCode!==null||a.signalCode!==null,y=()=>{let g=s-(Date.now()-r);if(g<=0)throw Error(`Timed out after ${s}ms starting Chrome`);if(p())throw Error("Chrome exited during startup");return g},f=async(g,c)=>{let m=Date.now()-r,{exitCode:b,signalCode:R}=a,M=S(o),F=D(o),E=null;if(c)try{await l()}catch(I){E=I instanceof Error?I.message:String(I)}return new k(g,{pid:a.pid,chromePath:e,profile:n,temporaryProfile:!t.profile,elapsedMs:m,exitCodeBeforeCleanup:b,signalCodeBeforeCleanup:R,exitCode:a.exitCode,signalCode:a.signalCode,portFileExisted:M,portFileContents:F,stderrTail:i,stderrTruncated:d,cleanupError:E})};try{u=a.stderr.getReader();let g=u;h=(async()=>{let R=new TextDecoder;for(;;){let{value:M,done:F}=await g.read(),E=R.decode(M,{stream:!F});if(d||=i.length+E.length>16384,i=(i+E).slice(-16384),F)return}})().catch((R)=>{i=`${i}
6
- [stderr read failed: ${String(R)}]`.slice(-16384)}),await K(()=>(y(),D(o)?.includes(`
7
- `)),y(),{label:"Chrome to start"});let[c,m=""]=(D(o)??"").split(`
8
- `),b=Number(c);if(!Number.isInteger(b)||b<1||b>65535)throw Error("Chrome wrote an invalid DevToolsActivePort");return{pid:a.pid,chromePath:e,profile:n,port:b,browserPath:m.trim(),remaining:y,close:l,failure:f,exited:p}}catch(g){throw await f(g,!0)}}async function A(t,e,r){let s;try{return await Promise.race([t,new Promise((n,o)=>{s=setTimeout(()=>o(Error(`Timed out after ${e}ms ${r}`)),e)})])}finally{clearTimeout(s)}}async function Z(t,e){if(await Promise.all([t.send("Page.enable"),t.send("Runtime.enable"),t.send("Network.enable"),t.send("Log.enable"),...e.viewport===!1?[]:[t.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,width:1440,height:1000,...e.viewport})]]),e.userAgent!==!1){let r=typeof e.userAgent==="string"?e.userAgent:String((await t.send("Browser.getVersion")).userAgent||"").replace("HeadlessChrome","Chrome");if(r)await t.send("Network.setUserAgentOverride",{userAgent:r})}if(e.quietLiveReload!==!1)await he(t,e.quietLiveReload);if(e.acceptDialogs!==!1)t.on("Page.javascriptDialogOpening",(r)=>{t.errors.push(`Dialog (${r.type}) on ${r.url}: ${r.message||"(no message)"}`),t.send("Page.handleJavaScriptDialog",{accept:!0}).catch(()=>{})})}var me=1500,C=new Map,L=new Map,U=!1;function pe(){if(U)return;U=!0,P.once("exit",()=>{for(let[t,e]of L){try{P.kill(t,"SIGKILL")}catch{}try{if(e)x(e,{recursive:!0,force:!0})}catch{}}})}async function Le(){let t=[...C.values()];C.clear(),await Promise.allSettled(t.map(async(e)=>{let r=await e;if(clearTimeout(r.linger),r.browser.disconnect(),await r.chrome.close(),r.chrome.pid!==null)L.delete(r.chrome.pid)}))}async function ge(t,e,r,s,n){let o=C.get(t);if(o){let i=await o.catch(()=>null);if(i&&!i.browser.closed&&!i.chrome.exited())return clearTimeout(i.linger),i.sessions++,i;if(C.get(t)===o)C.delete(t)}let a=(async()=>{let i=await X(e,r,s,n);if(i.pid!==null)L.set(i.pid,i.profile);try{if(!i.browserPath.startsWith("/devtools/browser/"))throw Error("Chrome wrote no browser endpoint in DevToolsActivePort");let d=await O(`ws://127.0.0.1:${i.port}${i.browserPath}`,{...e,connectTimeoutMs:Math.min(e.connectTimeoutMs??30000,i.remaining())});return{chrome:i,browser:d,sessions:0}}catch(d){if(i.pid!==null)L.delete(i.pid);throw await i.failure(d,!0)}})();C.set(t,a),pe();try{let i=await a;return i.sessions++,i}catch(i){if(C.get(t)===a)C.delete(t);throw i}}function H(t,e,r=!1){if(e.sessions=Math.max(0,e.sessions-1),e.sessions>0)return Promise.resolve();let s=async()=>{if(e.sessions>0)return;let n=C.get(t);if(n&&await n.catch(()=>null)===e)C.delete(t);if(e.browser.disconnect(),await e.chrome.close(),e.chrome.pid!==null)L.delete(e.chrome.pid)};if(r)return s();return clearTimeout(e.linger),e.linger=setTimeout(()=>{s().catch(()=>{})},me),Promise.resolve()}async function we(t,e,r,s){let n=JSON.stringify([e,t.headless!==!1,t.args??[]]),o=await ge(n,t,e,r,s),a=()=>{let h=s-(Date.now()-r);if(h<=0)throw Error(`Timed out after ${s}ms starting Chrome`);return h},i,d,u=async()=>{if(i&&!o.browser.closed)await o.browser.send("Target.disposeBrowserContext",{browserContextId:i}).catch(()=>{})};try{i=(await A(o.browser.send("Target.createBrowserContext",{disposeOnDetach:!1}),a(),"creating a browser context")).browserContextId;let{targetId:h}=await A(o.browser.send("Target.createTarget",{url:"about:blank",browserContextId:i}),a(),"opening a page"),w=`ws://127.0.0.1:${o.chrome.port}/devtools/page/${h}`,l=d=await O(w,{...t,connectTimeoutMs:Math.min(t.connectTimeoutMs??30000,a())});await A(Z(l,t),a(),"preparing the page"),a();let p;return{cdp:l,close:()=>p??=(async()=>{l.disconnect(),await u(),await H(n,o)})(),target:w,port:o.chrome.port,chromePath:e}}catch(h){d?.disconnect(),await u();let w=o.sessions<=1,l=await o.chrome.failure(h,!1);throw await H(n,o,w).catch((p)=>{l.diagnostics.cleanupError=p instanceof Error?p.message:String(p)}),l}}async function be(t,e,r,s){let n=await X(t,e,r,s),o,a,i=()=>a??=(async()=>{o?.disconnect(),await n.close()})(),d=setTimeout(()=>o?.disconnect(),Math.max(1,s-(Date.now()-r)));try{let u=n.port,h=await K(async()=>{let l=await fetch(`http://127.0.0.1:${u}/json/list`,{signal:AbortSignal.timeout(Math.min(1000,n.remaining()))}).then((p)=>p.json()).catch(()=>[]);return Array.isArray(l)&&l.length?l:null},Math.min(12000,n.remaining()),{label:"a page target"}),w=h.find((l)=>l.type==="page"&&l.url==="about:blank")||h.find((l)=>l.type==="page");if(!w)throw Error("Chrome did not expose a page target");return o=await O(w.webSocketDebuggerUrl,{...t,connectTimeoutMs:Math.min(t.connectTimeoutMs??30000,n.remaining())}),n.remaining(),await Z(o,t),n.remaining(),clearTimeout(d),{cdp:o,close:i,target:w.webSocketDebuggerUrl,port:u,chromePath:e}}catch(u){throw clearTimeout(d),o?.disconnect(),await n.failure(u,!0)}}async function ve(t={}){let e=t.startTimeoutMs??30000;if(!Number.isFinite(e)||e<=0)throw RangeError("startTimeoutMs must be positive and finite");let r=fe(t),s=Date.now();return!t.profile&&t.shared!==!1&&P.env.STACKS_BROWSER_SHARED!=="0"?await we(t,r,s,e):await be(t,r,s,e)}async function ye(t,e={}){let r=e.quietMs??1000,s=e.timeoutMs??15000,n=Date.now(),o=0;while(Date.now()-n<s){if(t.closed)throw Error("Chrome closed the connection");if(t.inFlight.size>0||await t.evaluate("document.readyState !== 'complete'").catch(()=>!0))o=0;else if(!o)o=Date.now();else if(Date.now()-o>=r)return!0;await Bun.sleep(100)}return!1}async function Ce(t,e,r={}){let s=await t.send("Page.navigate",{url:e});if(s?.errorText)throw Error(`Could not open ${e}: ${s.errorText}`);return await ye(t,r)}var Pe=(t)=>t.pathname.startsWith("/api/")&&!t.pathname.endsWith("/events");function Te(t){let e={};for(let r of t)e[r]=(e[r]||0)+1;return Object.fromEntries(Object.entries(e).filter(([,r])=>r>1))}function j(t){try{let e=new URL(t);return`${e.origin}${e.pathname}`}catch{return t.replace(/[?#].*$/,"")}}function xe(t,e,r="navigation"){let s=[{url:t,apiRequests:[]}],n=!1;for(let o of e){let a=s.at(-1);if(o.type==="request"){a.apiRequests.push(o.request);continue}let i=r==="navigation"&&n&&(o.sameDocument?j(o.url)!==j(a.url):!0);if(n=!0,i)s.push({url:o.url,apiRequests:[]});else a.url=o.url}return s.map((o)=>({...o,duplicates:Te(o.apiRequests)}))}function Se(t){let e={};for(let r of t)for(let[s,n]of Object.entries(r.duplicates))e[s]=Math.max(e[s]??0,n);return e}async function Fe(t,e={}){let r=Date.now(),s=new URL(t).origin,n=e.isApiRequest??Pe,o=[],a=[],i=[],d=null,u=e.cdp,h=[],w=u?.errors.length??0,l,p=t,y=async(f,g=[])=>{let c=xe(t,a,e.pageLoads),m=p;if(u&&!u.closed){let b=await u.evaluate("location.href").catch(()=>null);if(b&&b!=="about:blank"&&!b.startsWith("chrome-error:"))m=b}return{url:t,finalUrl:m,apiRequests:o,duplicates:Se(c),loads:c,failed:i,errors:[...u?.errors.slice(w)??[],...g],settled:f,durationMs:Date.now()-r}};try{if(!u)d=await ve(e.launch),u=d.cdp;let f=u;if(h.push(f.on("Network.requestWillBeSent",(c)=>{let m=new URL(c.request.url);if(m.origin===s&&n(m,c.request.method)){let b=`${c.request.method} ${m.pathname}${m.search}`;o.push(b),a.push({type:"request",request:b})}})),h.push(f.on("Network.responseReceived",(c)=>{let m=new URL(c.response.url);if(m.origin===s&&c.response.status>=400)i.push(`${c.response.status} ${m.pathname}`)})),h.push(f.on("Page.frameNavigated",(c)=>{if(c.frame?.parentId)return;l=c.frame?.id??l,p=c.frame?.unreachableUrl||`${c.frame?.url??p}${c.frame?.urlFragment??""}`,a.push({type:"navigated",url:p,sameDocument:!1})})),h.push(f.on("Page.navigatedWithinDocument",(c)=>{if(l&&c.frameId!==l)return;p=c.url,a.push({type:"navigated",url:c.url,sameDocument:!0})})),await f.send("Page.enable"),l=(await f.send("Page.getFrameTree").catch(()=>null))?.frameTree?.frame?.id,e.viewport)await f.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,...e.viewport});await e.beforeNavigate?.(f);let g=await Ce(f,t,e);return await y(g)}catch(f){return await y(!1,[`audit: ${f?.message??String(f)}`])}finally{for(let f of h)f();await d?.close().catch(()=>{})}}function G(t){try{let e=new URL(t);return`${e.pathname}${e.search}`}catch{return t}}function Me(t){let e=G(t.url),r=t.finalUrl?G(t.finalUrl):e,s=Object.entries(t.duplicates).map(([n,o])=>`${o}x ${n}`);return`${e}${r!==e?` -> ${r}`:""}: ${t.apiRequests.length} api${s.length?` | dup ${s.join(", ")}`:""}${t.failed.length?` | failed ${t.failed.join(", ")}`:""}${t.errors.length?` | errors ${t.errors.slice(0,3).join(" ; ")}`:""}${t.settled?"":" | never settled"}`}function Ie(t){return t.settled&&!Object.keys(t.duplicates).length&&!t.failed.length&&!t.errors.length}export{J as Cdp,k as ChromeLaunchError,de as LIVE_RELOAD_PATTERNS,me as SHARED_CHROME_LINGER_MS,Fe as auditPage,le as chromeHasUpdater,Le as closeSharedBrowsers,O as connect,Te as duplicateRequests,ce as findChrome,Me as formatPageAudit,ve as launch,Se as loadDuplicates,ie as matchesUrlPattern,Ce as navigate,Ie as pageAuditClean,B as pausedRequestMatches,ue as prepareMacChrome,he as quietLiveReload,ye as settle,xe as splitPageLoads,K as waitFor};
5
+ `).toString("base64")}).catch(()=>{})})}function be(t){let e=t.chromePath??P.env.CHROME_PATH;if(e)return e;let r=pe();if(!r)throw Error("No Chrome found: install Google Chrome or Chromium, or set CHROME_PATH");if((t.stableMacChrome??!0)&&P.platform==="darwin"&&fe(r))return me({source:r}).executable;return r}async function te(t,e,r,n,s){if(C(s,"process-start"),!E(e))throw Error(`Chrome was not found at ${e}`);let o=t.profile||J(v(z(),"stacks-browser-"));R(v(o,"DevToolsActivePort"),{force:!0});let a=v(o,"DevToolsActivePort"),i=(()=>{try{return Bun.spawn([e,...t.headless===!1?[]:["--headless=new"],"--remote-debugging-port=0",`--user-data-dir=${o}`,"--no-first-run","--no-default-browser-check","--disable-background-networking","--disable-component-update","--disable-extensions","--hide-scrollbars","--use-mock-keychain",...t.args??[],"about:blank"],{stdin:"ignore",stdout:"ignore",stderr:"pipe"})}catch(l){let p=null;try{if(!t.profile)R(o,{recursive:!0,force:!0})}catch(m){p=String(m)}throw new _(l,{pid:null,chromePath:e,profile:o,temporaryProfile:!t.profile,elapsedMs:Date.now()-r,phase:s.phase,phaseStartedMs:{...s.phaseStartedMs},exitCodeBeforeCleanup:null,signalCodeBeforeCleanup:null,exitCode:null,signalCode:null,portFileExisted:!1,portFileContents:null,stderrTail:"",stderrTruncated:!1,cleanupError:p})}})(),c="",u=!1,f,g=Promise.resolve(),w,d=()=>w??=(async()=>{let l=!1,p=[];try{if(i.exitCode===null&&i.signalCode===null)try{i.kill("SIGTERM")}catch{}if(!await L(i.exited,2000)){try{i.kill("SIGKILL")}catch{}if(!await L(i.exited,2000))throw Error(`Chrome process ${i.pid} did not exit after SIGKILL`)}l=!0}catch(m){p.push(String(m)),l=i.exitCode!==null||i.signalCode!==null}finally{try{if(!await L(g,100)&&f){if(!await L(f.cancel(),100))throw Error("Chrome stderr cancellation did not finish")}if(!await L(g,100))throw Error("Chrome stderr reader did not finish")}catch(m){p.push(String(m))}finally{if(l&&!t.profile)try{R(o,{recursive:!0,force:!0})}catch(m){p.push(String(m))}}}if(p.length)throw Error(`Chrome cleanup failed: ${p.join("; ")}`)})(),b=()=>i.exitCode!==null||i.signalCode!==null,h=()=>{let l=n-(Date.now()-r);if(l<=0)throw Error(`Timed out after ${n}ms starting Chrome`);if(b())throw Error("Chrome exited during startup");return l},S=async(l,p,m=s)=>{let T=Date.now()-m.started,q=m.phase,A={...m.phaseStartedMs},{exitCode:F,signalCode:I}=i,ne=E(a),se=O(a),N=null;if(p)try{await d()}catch(k){N=k instanceof Error?k.message:String(k)}return new _(l,{pid:i.pid,chromePath:e,profile:o,temporaryProfile:!t.profile,elapsedMs:T,phase:q,phaseStartedMs:A,exitCodeBeforeCleanup:F,signalCodeBeforeCleanup:I,exitCode:i.exitCode,signalCode:i.signalCode,portFileExisted:ne,portFileContents:se,stderrTail:c,stderrTruncated:u,cleanupError:N})};try{f=i.stderr.getReader();let l=f;g=(async()=>{let q=new TextDecoder;for(;;){let{value:A,done:F}=await l.read(),I=q.decode(A,{stream:!F});if(u||=c.length+I.length>16384,c=(c+I).slice(-16384),F)return}})().catch((q)=>{c=`${c}
6
+ [stderr read failed: ${String(q)}]`.slice(-16384)}),C(s,"devtools-port"),await Y(()=>(h(),O(a)?.includes(`
7
+ `)),h(),{label:"Chrome to start"});let[p,m=""]=(O(a)??"").split(`
8
+ `),T=Number(p);if(!Number.isInteger(T)||T<1||T>65535)throw Error("Chrome wrote an invalid DevToolsActivePort");return{pid:i.pid,chromePath:e,profile:o,port:T,browserPath:m.trim(),remaining:h,close:d,failure:S,exited:b}}catch(l){throw await S(l,!0)}}async function D(t,e,r){let n;try{return await Promise.race([t,new Promise((s,o)=>{n=setTimeout(()=>o(Error(`Timed out after ${e}ms ${r}`)),e)})])}finally{clearTimeout(n)}}async function re(t,e){if(await Promise.all([t.send("Page.enable"),t.send("Runtime.enable"),t.send("Network.enable"),t.send("Log.enable"),...e.viewport===!1?[]:[t.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,width:1440,height:1000,...e.viewport})]]),e.userAgent!==!1){let r=typeof e.userAgent==="string"?e.userAgent:String((await t.send("Browser.getVersion")).userAgent||"").replace("HeadlessChrome","Chrome");if(r)await t.send("Network.setUserAgentOverride",{userAgent:r})}if(e.quietLiveReload!==!1)await we(t,e.quietLiveReload);if(e.acceptDialogs!==!1)t.on("Page.javascriptDialogOpening",(r)=>{t.errors.push(`Dialog (${r.type}) on ${r.url}: ${r.message||"(no message)"}`),t.send("Page.handleJavaScriptDialog",{accept:!0}).catch(()=>{})})}var ve=1500,y=new Map,M=new Map,G=!1;function ye(){if(G)return;G=!0,P.once("exit",()=>{for(let[t,e]of M){try{P.kill(t,"SIGKILL")}catch{}try{if(e)R(e,{recursive:!0,force:!0})}catch{}}})}async function Ae(){let t=[...y.values()];y.clear(),await Promise.allSettled(t.map(async(e)=>{let r=await e;if(clearTimeout(r.linger),r.browser.disconnect(),await r.chrome.close(),r.chrome.pid!==null)M.delete(r.chrome.pid)}))}async function Ce(t,e,r,n,s,o){let a=y.get(t);if(a){let c=s-(Date.now()-n);if(c<=0)throw Error(`Timed out after ${s}ms starting Chrome`);let u=await D(a.catch(()=>null),c,"waiting for shared Chrome");if(u&&!u.browser.closed&&!u.chrome.exited())return clearTimeout(u.linger),u.sessions++,u;if(y.get(t)===a)y.delete(t)}let i=(async()=>{let c=await te(e,r,n,s,o);if(c.pid!==null)M.set(c.pid,c.profile);try{if(!c.browserPath.startsWith("/devtools/browser/"))throw Error("Chrome wrote no browser endpoint in DevToolsActivePort");C(o,"browser-connect");let u=await B(`ws://127.0.0.1:${c.port}${c.browserPath}`,{...e,connectTimeoutMs:Math.min(e.connectTimeoutMs??30000,c.remaining())});return{chrome:c,browser:u,sessions:0}}catch(u){if(c.pid!==null)M.delete(c.pid);throw await c.failure(u,!0)}})();y.set(t,i),ye();try{let c=await i;return c.sessions++,c}catch(c){if(y.get(t)===i)y.delete(t);throw c}}function W(t,e,r=!1){if(e.sessions=Math.max(0,e.sessions-1),e.sessions>0)return Promise.resolve();let n=async()=>{if(e.sessions>0)return;let s=y.get(t);if(s&&await s.catch(()=>null)===e)y.delete(t);if(e.browser.disconnect(),await e.chrome.close(),e.chrome.pid!==null)M.delete(e.chrome.pid)};if(r)return n();return clearTimeout(e.linger),e.linger=setTimeout(()=>{n().catch(()=>{})},ve),Promise.resolve()}async function Pe(t,e,r,n,s){let o=JSON.stringify([e,t.headless!==!1,t.args??[]]),a=await Ce(o,t,e,r,n,s),i=()=>{let g=n-(Date.now()-r);if(g<=0)throw Error(`Timed out after ${n}ms starting Chrome`);return g},c,u,f=async()=>{if(c&&!a.browser.closed)await a.browser.send("Target.disposeBrowserContext",{browserContextId:c}).catch(()=>{})};try{C(s,"context-create"),c=(await D(a.browser.send("Target.createBrowserContext",{disposeOnDetach:!1}),i(),"creating a browser context")).browserContextId,C(s,"target-create");let{targetId:g}=await D(a.browser.send("Target.createTarget",{url:"about:blank",browserContextId:c}),i(),"opening a page"),w=`ws://127.0.0.1:${a.chrome.port}/devtools/page/${g}`;C(s,"page-connect");let d=u=await B(w,{...t,connectTimeoutMs:Math.min(t.connectTimeoutMs??30000,i())});C(s,"page-prepare"),await D(re(d,t),i(),"preparing the page"),i();let b;return{cdp:d,close:()=>b??=(async()=>{d.disconnect(),await f(),await W(o,a)})(),target:w,port:a.chrome.port,chromePath:e}}catch(g){u?.disconnect(),await f();let w=a.sessions<=1,d=await a.chrome.failure(g,!1,s);throw await W(o,a,w).catch((b)=>{d.diagnostics.cleanupError=b instanceof Error?b.message:String(b)}),d}}async function Se(t,e,r,n,s){let o=await te(t,e,r,n,s),a,i,c=()=>i??=(async()=>{a?.disconnect(),await o.close()})(),u=setTimeout(()=>a?.disconnect(),Math.max(1,n-(Date.now()-r)));try{let f=o.port;C(s,"target-discovery");let g=await Y(async()=>{let d=await fetch(`http://127.0.0.1:${f}/json/list`,{signal:AbortSignal.timeout(Math.min(1000,o.remaining()))}).then((b)=>b.json()).catch(()=>[]);return Array.isArray(d)&&d.length?d:null},Math.min(12000,o.remaining()),{label:"a page target"}),w=g.find((d)=>d.type==="page"&&d.url==="about:blank")||g.find((d)=>d.type==="page");if(!w)throw Error("Chrome did not expose a page target");return C(s,"page-connect"),a=await B(w.webSocketDebuggerUrl,{...t,connectTimeoutMs:Math.min(t.connectTimeoutMs??30000,o.remaining())}),o.remaining(),C(s,"page-prepare"),await re(a,t),o.remaining(),clearTimeout(u),{cdp:a,close:c,target:w.webSocketDebuggerUrl,port:f,chromePath:e}}catch(f){throw clearTimeout(u),a?.disconnect(),await o.failure(f,!0)}}async function Te(t={}){let e=t.startTimeoutMs??30000;if(!Number.isFinite(e)||e<=0)throw RangeError("startTimeoutMs must be positive and finite");let r=be(t),n=Date.now(),s={started:n,phase:"process-acquire",phaseStartedMs:{"process-acquire":0}};return!t.profile&&t.shared!==!1&&P.env.STACKS_BROWSER_SHARED!=="0"?await Pe(t,r,n,e,s):await Se(t,r,n,e,s)}async function xe(t,e={}){let r=e.quietMs??1000,n=e.timeoutMs??15000,s=Date.now(),o=0;while(Date.now()-s<n){if(t.closed)throw Error("Chrome closed the connection");if(t.inFlight.size>0||await t.evaluate("document.readyState !== 'complete'").catch(()=>!0))o=0;else if(!o)o=Date.now();else if(Date.now()-o>=r)return!0;await Bun.sleep(100)}return!1}async function Re(t,e,r={}){let n=await t.send("Page.navigate",{url:e});if(n?.errorText)throw Error(`Could not open ${e}: ${n.errorText}`);return await xe(t,r)}var Ee=(t)=>t.pathname.startsWith("/api/")&&!t.pathname.endsWith("/events");function qe(t){let e={};for(let r of t)e[r]=(e[r]||0)+1;return Object.fromEntries(Object.entries(e).filter(([,r])=>r>1))}function V(t){try{let e=new URL(t);return`${e.origin}${e.pathname}`}catch{return t.replace(/[?#].*$/,"")}}function $e(t,e,r="navigation"){let n=[{url:t,apiRequests:[]}],s=!1;for(let o of e){let a=n.at(-1);if(o.type==="request"){a.apiRequests.push(o.request);continue}let i=r==="navigation"&&s&&(o.sameDocument?V(o.url)!==V(a.url):!0);if(s=!0,i)n.push({url:o.url,apiRequests:[]});else a.url=o.url}return n.map((o)=>({...o,duplicates:qe(o.apiRequests)}))}function Le(t){let e={};for(let r of t)for(let[n,s]of Object.entries(r.duplicates))e[n]=Math.max(e[n]??0,s);return e}async function ke(t,e={}){let r=Date.now(),n=new URL(t).origin,s=e.isApiRequest??Ee,o=[],a=[],i=[],c=null,u=e.cdp,f=[],g=u?.errors.length??0,w,d=t,b=async(h,S=[])=>{let l=$e(t,a,e.pageLoads),p=d;if(u&&!u.closed){let m=await u.evaluate("location.href").catch(()=>null);if(m&&m!=="about:blank"&&!m.startsWith("chrome-error:"))p=m}return{url:t,finalUrl:p,apiRequests:o,duplicates:Le(l),loads:l,failed:i,errors:[...u?.errors.slice(g)??[],...S],settled:h,durationMs:Date.now()-r}};try{if(!u)c=await Te(e.launch),u=c.cdp;let h=u;if(f.push(h.on("Network.requestWillBeSent",(l)=>{let p=new URL(l.request.url);if(p.origin===n&&s(p,l.request.method)){let m=`${l.request.method} ${p.pathname}${p.search}`;o.push(m),a.push({type:"request",request:m})}})),f.push(h.on("Network.responseReceived",(l)=>{let p=new URL(l.response.url);if(p.origin===n&&l.response.status>=400)i.push(`${l.response.status} ${p.pathname}`)})),f.push(h.on("Page.frameNavigated",(l)=>{if(l.frame?.parentId)return;w=l.frame?.id??w,d=l.frame?.unreachableUrl||`${l.frame?.url??d}${l.frame?.urlFragment??""}`,a.push({type:"navigated",url:d,sameDocument:!1})})),f.push(h.on("Page.navigatedWithinDocument",(l)=>{if(w&&l.frameId!==w)return;d=l.url,a.push({type:"navigated",url:l.url,sameDocument:!0})})),await h.send("Page.enable"),w=(await h.send("Page.getFrameTree").catch(()=>null))?.frameTree?.frame?.id,e.viewport)await h.send("Emulation.setDeviceMetricsOverride",{deviceScaleFactor:1,mobile:!1,...e.viewport});await e.beforeNavigate?.(h);let S=await Re(h,t,e);return await b(S)}catch(h){return await b(!1,[`audit: ${h?.message??String(h)}`])}finally{for(let h of f)h();await c?.close().catch(()=>{})}}function K(t){try{let e=new URL(t);return`${e.pathname}${e.search}`}catch{return t}}function Oe(t){let e=K(t.url),r=t.finalUrl?K(t.finalUrl):e,n=Object.entries(t.duplicates).map(([s,o])=>`${o}x ${s}`);return`${e}${r!==e?` -> ${r}`:""}: ${t.apiRequests.length} api${n.length?` | dup ${n.join(", ")}`:""}${t.failed.length?` | failed ${t.failed.join(", ")}`:""}${t.errors.length?` | errors ${t.errors.slice(0,3).join(" ; ")}`:""}${t.settled?"":" | never settled"}`}function _e(t){return t.settled&&!Object.keys(t.duplicates).length&&!t.failed.length&&!t.errors.length}export{Q as Cdp,_ as ChromeLaunchError,ge as LIVE_RELOAD_PATTERNS,ve as SHARED_CHROME_LINGER_MS,ke as auditPage,fe as chromeHasUpdater,Ae as closeSharedBrowsers,B as connect,qe as duplicateRequests,pe as findChrome,Oe as formatPageAudit,Te as launch,Le as loadDuplicates,de as matchesUrlPattern,Re as navigate,_e as pageAuditClean,H as pausedRequestMatches,me as prepareMacChrome,we as quietLiveReload,xe as settle,$e as splitPageLoads,Y as waitFor};
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@stacksjs/testing",
3
3
  "type": "module",
4
4
  "sideEffects": false,
5
- "version": "0.75.305",
5
+ "version": "0.75.308",
6
6
  "description": "The Stacks way of testing.",
7
7
  "author": "Chris Breuer",
8
8
  "contributors": [
@@ -79,16 +79,16 @@
79
79
  "prepublishOnly": "bun run build"
80
80
  },
81
81
  "dependencies": {
82
- "@stacksjs/auth": "0.75.305",
83
- "@stacksjs/cache": "0.75.305",
84
- "@stacksjs/config": "0.75.305",
85
- "@stacksjs/database": "0.75.305",
86
- "@stacksjs/email": "0.75.305",
87
- "@stacksjs/events": "0.75.305",
88
- "@stacksjs/path": "0.75.305",
89
- "@stacksjs/router": "0.75.305",
90
- "@stacksjs/storage": "0.75.305",
91
- "@stacksjs/strings": "0.75.305",
82
+ "@stacksjs/auth": "0.75.308",
83
+ "@stacksjs/cache": "0.75.308",
84
+ "@stacksjs/config": "0.75.308",
85
+ "@stacksjs/database": "0.75.308",
86
+ "@stacksjs/email": "0.75.308",
87
+ "@stacksjs/events": "0.75.308",
88
+ "@stacksjs/path": "0.75.308",
89
+ "@stacksjs/router": "0.75.308",
90
+ "@stacksjs/storage": "0.75.308",
91
+ "@stacksjs/strings": "0.75.308",
92
92
  "@stacksjs/ts-cloud": "^0.16.69",
93
93
  "very-happy-dom": "^0.3.5"
94
94
  },