@checksum-ai/runtime 4.16.2 → 4.16.3

package/index.d.ts

@@ -11,7 +11,6 @@ import {
   Dialog,
 } from "@playwright/test";
 
-// import { ExpectWrapper } from "./index.helpers";
 interface ChecksumAIMethod {
   (title: string): IChecksumPage;
   <T>(
@@ -110,7 +109,6 @@ export interface CompoundSelectionInterface {
    *    target?: (base) => base.locator("<relative selector to target element>")
    * }).first().click();
    * ```
-   * @param selection
    * @returns Locator to the common parent(s) or the target element(s) if specified.
    */
   compoundSelection(selection: {

package/index.js

@@ -416,7 +416,7 @@ ${c}
 })`,{filename:i})(s,(0,joe.createRequire)(i),r,i,(0,Hoe.dirname)(i));let p=r.exports,d=p.default;return d===void 0?p:d}u(Joe,"requireChecksumConfig");var kw=require("fs"),Zoe=require("module"),Xoe=require("node:util");var hc={defaultMerge:Symbol("deepmerge-ts: default merge"),skip:Symbol("deepmerge-ts: skip")},Y_t={defaultMerge:hc.defaultMerge};function QFe(i,n){return n}u(QFe,"defaultMetaDataUpdater");function MFe(i,n){return i.filter(c=>c!==void 0)}u(MFe,"defaultFilterValues");var qoe;(function(i){i[i.NOT=0]="NOT",i[i.RECORD=1]="RECORD",i[i.ARRAY=2]="ARRAY",i[i.SET=3]="SET",i[i.MAP=4]="MAP",i[i.OTHER=5]="OTHER"})(qoe||(qoe={}));function $oe(i){return typeof i!="object"||i===null?0:Array.isArray(i)?2:jFe(i)?1:i instanceof Set?3:i instanceof Map?4:5}u($oe,"getObjectType");function FFe(i){let n=new Set;for(let c of i)for(let s of[...Object.keys(c),...Object.getOwnPropertySymbols(c)])n.add(s);return n}u(FFe,"getKeys");function UFe(i,n){return typeof i=="object"&&Object.prototype.propertyIsEnumerable.call(i,n)}u(UFe,"objectHasProperty");function zoe(i){let n=0,c=i[0]?.[Symbol.iterator]();return{[Symbol.iterator](){return{next(){do{if(c===void 0)return{done:!0,value:void 0};let s=c.next();if(s.done===!0){n+=1,c=i[n]?.[Symbol.iterator]();continue}return{done:!1,value:s.value}}while(!0)}}}}}u(zoe,"getIterableOfIterables");var Voe=["[object Object]","[object Module]"];function jFe(i){if(!Voe.includes(Object.prototype.toString.call(i)))return!1;let{constructor:n}=i;if(n===void 0)return!0;let c=n.prototype;return!(c===null||typeof c!="object"||!Voe.includes(Object.prototype.toString.call(c))||!c.hasOwnProperty("isPrototypeOf"))}u(jFe,"isRecord");function HFe(i,n,c){let s={};for(let r of FFe(i)){let f=[];for(let h of i)UFe(h,r)&&f.push(h[r]);if(f.length===0)continue;let p=n.metaDataUpdater(c,{key:r,parents:i}),d=Koe(f,n,p);d!==hc.skip&&(r==="__proto__"?Object.defineProperty(s,r,{value:d,configurable:!0,enumerable:!0,writable:!0}):s[r]=d)}return s}u(HFe,"mergeRecords$1");function WFe(i){return i.flat()}u(WFe,"mergeArrays$1");function GFe(i){return new Set(zoe(i))}u(GFe,"mergeSets$1");function JFe(i){return new Map(zoe(i))}u(JFe,"mergeMaps$1");function qFe(i){return i.at(-1)}u(qFe,"mergeOthers$1");var Cw={mergeRecords:HFe,mergeArrays:WFe,mergeSets:GFe,mergeMaps:JFe,mergeOthers:qFe};function Yoe(...i){return $Fe({})(...i)}u(Yoe,"deepmerge");function $Fe(i,n){let c=VFe(i,s);function s(...r){return Koe(r,c,n)}return u(s,"customizedDeepmerge"),s}u($Fe,"deepmergeCustom");function VFe(i,n){return{defaultMergeFunctions:Cw,mergeFunctions:{...Cw,...Object.fromEntries(Object.entries(i).filter(([c,s])=>Object.hasOwn(Cw,c)).map(([c,s])=>s===!1?[c,Cw.mergeOthers]:[c,s]))},metaDataUpdater:i.metaDataUpdater??QFe,deepmerge:n,useImplicitDefaultMerging:i.enableImplicitDefaultMerging??!1,filterValues:i.filterValues===!1?void 0:i.filterValues??MFe,actions:hc}}u(VFe,"getUtils");function Koe(i,n,c){let s=n.filterValues?.(i,c)??i;if(s.length===0)return;if(s.length===1)return NM(s,n,c);let r=$oe(s[0]);if(r!==0&&r!==5){for(let f=1;f<s.length;f++)if($oe(s[f])!==r)return NM(s,n,c)}switch(r){case 1:return zFe(s,n,c);case 2:return YFe(s,n,c);case 3:return KFe(s,n,c);case 4:return ZFe(s,n,c);default:return NM(s,n,c)}}u(Koe,"mergeUnknowns");function zFe(i,n,c){let s=n.mergeFunctions.mergeRecords(i,n,c);return s===hc.defaultMerge||n.useImplicitDefaultMerging&&s===void 0&&n.mergeFunctions.mergeRecords!==n.defaultMergeFunctions.mergeRecords?n.defaultMergeFunctions.mergeRecords(i,n,c):s}u(zFe,"mergeRecords");function YFe(i,n,c){let s=n.mergeFunctions.mergeArrays(i,n,c);return s===hc.defaultMerge||n.useImplicitDefaultMerging&&s===void 0&&n.mergeFunctions.mergeArrays!==n.defaultMergeFunctions.mergeArrays?n.defaultMergeFunctions.mergeArrays(i):s}u(YFe,"mergeArrays");function KFe(i,n,c){let s=n.mergeFunctions.mergeSets(i,n,c);return s===hc.defaultMerge||n.useImplicitDefaultMerging&&s===void 0&&n.mergeFunctions.mergeSets!==n.defaultMergeFunctions.mergeSets?n.defaultMergeFunctions.mergeSets(i):s}u(KFe,"mergeSets");function ZFe(i,n,c){let s=n.mergeFunctions.mergeMaps(i,n,c);return s===hc.defaultMerge||n.useImplicitDefaultMerging&&s===void 0&&n.mergeFunctions.mergeMaps!==n.defaultMergeFunctions.mergeMaps?n.defaultMergeFunctions.mergeMaps(i):s}u(ZFe,"mergeMaps");function NM(i,n,c){let s=n.mergeFunctions.mergeOthers(i,n,c);return s===hc.defaultMerge||n.useImplicitDefaultMerging&&s===void 0&&n.mergeFunctions.mergeOthers!==n.defaultMergeFunctions.mergeOthers?n.defaultMergeFunctions.mergeOthers(i):s}u(NM,"mergeOthers");var ere=!1;function Foe(i){ere=i}u(Foe,"setLogToConsole");function ye(...i){ere&&process.stdout.write(`${(0,Xoe.format)(...i)}
 `)}u(ye,"log");function XFe(i,n){return i in n}u(XFe,"isLocatorMethod");async function ZX(i,n,c,s=6e4){if(!XFe(n,i))return i;let r=u(()=>{let f=i[n];return typeof f=="function"?Reflect.apply(f,i,c):f},"executor");return s===null?r():dt(r(),s,"Execution timeout")}u(ZX,"executePlaywrightMethodWithTimeout");function LM({envName:i,role:n}={}){let c=process.env.CHECKSUM_RUNTIME_ENV_OVERRIDE_NAME??i,s=process.env.CHECKSUM_RUNTIME_ENV_OVERRIDE_ROLE??n;return{...c!==void 0?{envName:c}:{},...s!==void 0?{role:s}:{}}}u(LM,"applyRuntimeEnvOverrides");function QM(i,{role:n,environment:c}={},s=!1){let r;if(c&&(r=i.environments?.find(({name:d})=>c===d)),r??=i.environments?.find(({default:d})=>d),!r)throw new Error("Environment not found. Please make sure your environments are properly defined in the checksum.config.ts file.");let f=r.users,p;if(f&&(n!==void 0&&(p=f.find(d=>d.role===n)),p??=f.find(d=>d.default)),!p)throw new Error(`User not found. Please make sure the users array for the "${r.name}" environment is properly defined in the checksum.config.ts file.`);if(c&&r.name!==c){if(s)throw new Error(`Could not find environment with name "${c}" in config file`);console.warn(`Could not find environment with name "${c}" in config file, trying to use default environment`)}if(n&&p.role!==n){if(s)throw new Error(`Could not find user with role "${n}" for environment "${c}" in config file`);console.warn(`Could not find user with role "${n}" for environment "${c}" in config file, trying to login with environment's default user`)}return{environment:r,user:p}}u(QM,"resolveEnvironment");function e3e(i){let n=`${i??Po()}/login.ts`;if(!(0,kw.existsSync)(n))throw console.warn(`Could not locate the login.ts file. Please make sure your login file exists at ${n}`),new Error("Could not find login.ts file");try{return(0,Zoe.createRequire)(__filename)(n).default}catch(c){throw console.warn("Error loading login.ts file",c),c}}u(e3e,"requireLogin");async function t3e(i,n,{environment:c,user:s,config:r}){try{let f=u(()=>n(i,{environment:c,user:s,config:r}),"performLogin");"checksumAI"in i?await i.checksumAI(`Log in${s.role?` using ${s.role} role`:""}${c.name?` in ${c.name} environment`:""}`,f,{skipAutoRecovery:!0}):await f()}catch(f){throw console.warn(`The login method threw an exception, please check the login.ts file for the following error:
 `,f),f}}u(t3e,"proceedWithLogin");function ds(i){let{config:n,folder:c,throwIfAuthFailed:s}=i,r=e3e(c);return async(f,{role:p,environment:d}={})=>{let{envName:h,role:o}=LM({...d!==void 0?{envName:d}:{},...p!==void 0?{role:p}:{}}),{environment:a,user:e}=QM(n,{...o!==void 0?{role:o}:{},...h!==void 0?{environment:h}:{}},i.throwIfEnvInfoInvalid);if(s&&!e)throw new Error("Could not find user credentials matching the provided role and/or environment");await t3e(f,r,{environment:a,user:e,config:n})}}u(ds,"makeUnboundLogin");function tre(i,{environmentName:n,userRole:c}){let s=ds(i);return r=>s(r,{environment:n,role:c})}u(tre,"makeBoundLogin");var or;function AI(){if(or)return or;try{let i=(0,kw.existsSync)(`${Po()}/checksum.config.ts`)?"checksum.config.ts":(0,kw.existsSync)(`${Po()}/checksum.config.tmp.ts`)?"checksum.config.tmp.ts":void 0;if(i)return Tw(Joe(`${Po()}/${i}`))}catch{console.warn("Could not find checksum config file, will run with defaults")}return Tw()}u(AI,"loadChecksumConfig");function Tw(i={}){let n={apiKey:"",runMode:"normal",apiURL:"https://api.checksum.ai",options:{useChecksumSelectors:!0,useChecksumAI:{actions:!0,assertions:!1,skipTestsWithKnownBugs:!0},newAssertionsEnabled:!0,useMockData:!1,printLogs:!1,consecutiveActionDelay:100,hideReports:process.env.AUTHORIZE_REPORTS==="true"}};return i.options?.useChecksumAI?.visualComparison===void 0&&i.options?.useChecksumAI?.assertions&&(i.options.useChecksumAI.visualComparison=!0),or=Yoe(n,i),process.env.CHECKSUM_API_URL&&(or.apiURL=process.env.CHECKSUM_API_URL),Fe.testRun.disableAutoRecovery&&or.options&&(or.options.useChecksumAI={actions:!1,assertions:!1,visualComparison:!1}),Fe.testRun.disableHostReports&&or.options&&(or.options.hostReports=!1),or.options&&(Fe.testRun.disableTimeMachine&&(or.options.disableTimeMachine=!0),Fe.testRun.disableRrwebRecording&&(or.options.disableRrwebRecording=!0)),or}u(Tw,"getChecksumConfig");var sc="Checksum failed connecting to the server";var IBt=require("@playwright/test");async function nre(i){await i.body?.cancel().catch(()=>{})}u(nre,"drainBody");var n3e="http://127.0.0.1";async function MM(i,n){let c=n.fetchImpl??globalThis.fetch;try{let s=await c(`${n3e}:${n.port}/`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(i),signal:AbortSignal.timeout(n.timeoutMs)});return await nre(s),s.ok?!0:(n.onError?.(new Error(`monitor rejected message with status ${s.status}`)),!1)}catch(s){return n.onError?.(s),!1}}u(MM,"postToMonitor");async function FM(i,n){return await MM(i,n)?!0:n.attempts<=1?!1:(await o3e(n.retryDelayMs),FM(i,{...n,attempts:n.attempts-1}))}u(FM,"postToMonitorWithRetry");function o3e(i){return new Promise(n=>{setTimeout(n,i)})}u(o3e,"sleep");var xw={uploadTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_TIMEOUT_MS",fallback:6e5,min:5e3,max:36e5},noProgressAbortMs:{env:"CHECKSUM_RUNTIME_UPLOAD_NO_PROGRESS_MS",fallback:6e4,min:5e3,max:6e5},assetDeadlineMs:{env:"CHECKSUM_RUNTIME_UPLOAD_ASSET_DEADLINE_MS",fallback:12e5,min:3e4,max:54e5},maxAttempts:{env:"CHECKSUM_RUNTIME_UPLOAD_MAX_ATTEMPTS",fallback:6,min:1,max:20},stallTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_STALL_TIMEOUT_MS",fallback:6e5,min:3e4,max:36e5},minProgressBytes:{env:"CHECKSUM_RUNTIME_UPLOAD_MIN_PROGRESS_BYTES",fallback:65536,min:1,max:67108864},finalizeBudgetMs:{env:"CHECKSUM_RUNTIME_UPLOAD_FINALIZE_BUDGET_MS",fallback:18e5,min:6e4,max:54e5},finalizeCeilingMs:{env:"CHECKSUM_RUNTIME_UPLOAD_FINALIZE_CEILING_MS",fallback:24e5,min:12e4,max:72e5},cliHardCapMs:{env:"CHECKSUM_RUNTIME_UPLOAD_CLI_HARD_CAP_MS",fallback:27e5,min:12e4,max:72e5},watchTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_WATCH_TIMEOUT_MS",fallback:12e4,min:5e3,max:18e5},ipcTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_IPC_TIMEOUT_MS",fallback:5e3,min:500,max:6e4},onEndFlushTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_ONEND_FLUSH_TIMEOUT_MS",fallback:5e3,min:500,max:6e4},resumableChunkBytes:{env:"CHECKSUM_RUNTIME_UPLOAD_RESUMABLE_CHUNK_BYTES",fallback:8388608,min:262144,max:268435456},connectTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_CONNECT_TIMEOUT_MS",fallback:1e4,min:1e3,max:6e4},headersTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_HEADERS_TIMEOUT_MS",fallback:3e5,min:5e3,max:18e5},bodyTimeoutMs:{env:"CHECKSUM_RUNTIME_UPLOAD_BODY_TIMEOUT_MS",fallback:3e5,min:5e3,max:18e5},maxConcurrentUploads:{env:"CHECKSUM_RUNTIME_UPLOAD_MAX_CONCURRENT",fallback:15,min:1,max:64}};function r3e(i,n,c,s){if(i===void 0||i.trim()==="")return n;let r=Number(i);return Number.isInteger(r)?Math.min(s,Math.max(c,r)):n}u(r3e,"clampEnvInt");var i3e=[["cliHardCapMs",["finalizeCeilingMs"],.9],["finalizeCeilingMs",["finalizeBudgetMs"],1],["finalizeBudgetMs",["stallTimeoutMs","assetDeadlineMs","watchTimeoutMs"],1],["assetDeadlineMs",["uploadTimeoutMs"],1],["uploadTimeoutMs",["noProgressAbortMs"],.5]];function a3e(i){let n={...i},c=[];for(let[s,r,f]of i3e)for(let p of r){let d=Math.floor(n[s]*f);n[p]>d&&(c.push(`${xw[p].env} (${n[p]}ms) exceeds its bound under ${xw[s].env} (${n[s]}ms); using ${d}ms`),n[p]=d)}return{tunables:n,warnings:c}}u(a3e,"coerceScopeHierarchy");function c3e(i){let n={};for(let c of Object.keys(xw)){let s=xw[c];n[c]=r3e(i[s.env],s.fallback,s.min,s.max)}return n.resumableChunkBytes=Math.max(1,Math.floor(n.resumableChunkBytes/262144))*262144,a3e(n)}u(c3e,"resolveUploadTunablesDetailed");function UM(i){return c3e(i).tunables}u(UM,"resolveUploadTunables");var gBt=UM({});var l3e=4,ore=3,s3e=500,Pw=class i{constructor(n){this.workerInfo=n;this.hasMonitor=!1;i.monitorAgentPort?this.hasMonitor=!0:ye("CHECKSUM_UPLOAD_AGENT_PORT is not defined"),this.sendPlaywrightConfig()}static{u(this,"TestRunMonitorBridge")}static{this.monitorAgentHost="http://localhost"}static{this.monitorAgentPort=process.env.CHECKSUM_UPLOAD_AGENT_PORT}static{this.playwrightConfigSent=!1}static{this.tunables=UM(process.env)}addAsset(n){this.signalUpload(n,["trace","har","rrweb-recording"].includes(n.type))}addChecksumTestMetadata(n){let c={type:"checksumTestMetadata",payload:n};this.sendMessage(c)}addTestInfo(n,c,s=!1){this.sendMessage({type:"testInfo",payload:{checksumTestId:n,pwTestId:c,usingChecksumTestIdPlaceholder:s}})}addSingleTestStats(n,c){this.sendMessage({type:"testStats",payload:{passed:n,healed:c}})}sendPlaywrightConfig(){if(i.playwrightConfigSent)return;let n=this.buildPlaywrightConfig();this.sendMessage({type:"playwrightConfig",payload:n}),i.playwrightConfigSent=!0}buildPlaywrightConfig(){let{use:n,testDir:c,testMatch:s,testIgnore:r,timeout:f,outputDir:p,retries:d}=this.workerInfo.project,{reporter:h,configFile:o,projects:a}=this.workerInfo.config,e=Object.keys(a).filter(t=>[n,c,s,r,f,p,d].includes(t)).reduce((t,l)=>({...t,[l]:a[Number(l)]}),{});return{reporter:h,...o!==void 0?{configFile:o}:{},filteredProjects:e,use:n,testDir:c,testMatch:s,testIgnore:r,timeout:f,outputDir:p,retries:d}}sendMessage(n){return this.hasMonitor&&i.monitorAgentPort?MM(n,{port:i.monitorAgentPort,timeoutMs:i.tunables.ipcTimeoutMs,onError:u(c=>ye("Failed to send message to test run monitor",n,c),"onError")}):void 0}async signalUpload(n,c=!1){let s=i.monitorAgentPort;if(!this.hasMonitor||!s)return;let r={type:"asset",payload:n,watch:c},f;await FM(r,{port:s,timeoutMs:i.tunables.ipcTimeoutMs*l3e,attempts:ore,retryDelayMs:s3e,onError:u(d=>{f=d,ye("Failed to register asset with test run monitor",r,d)},"onError")})||pv("asset_registration_failed",{test_suite_run_id:process.env.CHECKSUM_TEST_SUITE_ID,outcome:"error",asset_type:n.type,asset_path:n.path,attempts:ore,error:vp(f)})}};var rre=require("@playwright/test"),ire=require("puppeteer-extra-plugin"),are=require("module");var _w=(0,are.createRequire)(__filename),Bw=class i{constructor(n){this.options=n;this.importPluginPackages()}static{u(this,"StealthProvider")}importPluginPackages(){i.pw??=_w("playwright-extra"),i.StealthPlugin??=_w("puppeteer-extra-plugin-stealth")}static createFreshInstance(){try{let{addExtra:n}=_w("playwright-extra");return n(i.pw.chromium)}catch(n){throw console.error("[StealthProvider] Error creating fresh instance:",n),n}}buildChromiumWithPlugins(n){let{project:c}=this.options,s=c.use.userAgent,r=c.use.playwrightExtra??[],f=i.StealthPlugin();if(r.push(f),this.isCustomUserAgent(s)){f.enabledEvasions.delete("user-agent-override");let h=_w("puppeteer-extra-plugin-stealth/evasions/user-agent-override")({userAgent:s});r.push(h)}let p=n??i.pw.chromium;return r.forEach((d,h)=>{try{!(d instanceof ire.PuppeteerExtraPlugin)&&d!==f&&console.warn(`Plugin at index ${h} in the project's checksum.config.ts file is not an instance of PuppeteerExtraPlugin.`),p.use(d)}catch(o){console.warn(o)}}),p}isCustomUserAgent(n){return n?!Object.values(rre.devices).some(c=>n===c.userAgent):!1}};function cre(i,n){return{testSuiteRunId:n,appName:"generic-app",commitHash:"generic-commit-hash",envName:"generic-env-name",branch:"generic-branch",checksumRuntimeVersion:i}}u(cre,"createDefaultTestSuiteRunInfo");var ure=require("crypto");var RBt=require("@playwright/test");var UBt=require("@playwright/test");function lre(i,n){return Reflect.get(i,n)}u(lre,"readDynamicProperty");var Rw=class i{constructor(n){this.context=n;this._pages={};this._pagesInProgress=new Map;this._testAssets=null;this.pageGuidMap=new WeakMap;this.instanceId=++i.instanceCounter,this.proxy=this.createContextProxy()}static{u(this,"ChecksumBrowserContext")}static{this.instanceCounter=0}static{this.guidCounter=0}static makeContext(n){return new i(n).proxy}_rawContext(){return this.context}setTestAssets(n){this._testAssets=n,this.setupPageListener()}getTestAssets(){return this._testAssets}cleanup(){this._pagesInProgress.clear(),this._pages={}}async newPage(){let n=await this.context.newPage();return this.makePage(n)}async makePage(n){if(n._isChecksumPage===!0)return n;if(n.isClosed())throw new Error("Cannot initialize closed page");let c=this.getPageGuid(n),s=this.getPageByGuid(c);if(s)return s;let r=this._pagesInProgress.get(c);if(r)return r;let f=this._createPageInstance(n);this._pagesInProgress.set(c,f);try{let p=await f;return this._pagesInProgress.delete(c),this.addPage(p),p}catch(p){throw this._pagesInProgress.delete(c),p}}addPage(n){let c=this.getPageGuid(n);this._pages[c]=n,n.once("close",()=>{this.removePage(c)})}removePage(n){this._pages[n]&&delete this._pages[n]}async _createPageInstance(n){if(n.isClosed())throw new Error("Cannot initialize page: Page has already been closed");if(this._testAssets)try{return await Sw.init(n,this.proxy,this._testAssets.testRunAnalytics,this._testAssets.monitorBridge,this._testAssets.variableStore,this._testAssets.testInfo,this._testAssets.checksumTestId,this._testAssets.test,this._testAssets.config,this._testAssets.isReplMode)}catch(c){throw new Error(`Failed to initialize RuntimePage: ${c instanceof Error?c.message:String(c)}. Test assets must be properly configured.`)}throw new Error("Cannot create page: Test assets not set. Use setTestAssets() before creating pages.")}createContextProxy(){return new Proxy(this,{get:u(function(c,s){return c.getContextMethod(s)},"get")})}setupPageListener(){this.context.on("page",async n=>{try{if(n.isClosed())return;await this.makePage(n)}catch(c){let s=c instanceof Error?c.message:String(c);if(s.includes("Page has already been closed")||s.includes("Target page, context or browser has been closed"))return;throw console.error("[ChecksumBrowserContext] Failed to initialize page created by application:",c),c}})}getPageGuid(n){let c=this.pageGuidMap.get(n);return c||(c=`page@checksumctx_${this.instanceId}_${++i.guidCounter}`,this.pageGuidMap.set(n,c)),c}getPageByGuid(n){return this._pages[n]}getAllPages(){return Object.values(this._pages)}getContextMethod(n){if(n in this){let s=lre(this,n);return typeof s=="function"?s.bind(this):s}let c=lre(this.context,n);return typeof c=="function"?c.bind(this.context):c}pages(){return this.getAllPages()}getPage(n){let c=this.getAllPages(),s=c[n];if(!s)throw new Error(`Page with index ${n} not found. Total pages: ${c.length}`);return s}};var jM={},fre=u((i,n,c={},s=!1)=>{let{environments:r}=n,f=r?.find(d=>d.default),p=i.extend({baseURL:f?.baseURL,bypassCSP:!0,permissions:u(async({},d,h)=>{await d(h.project.use.permissions)},"permissions"),proxy:u(async({proxy:d},h)=>{d?await h({...d,bypass:"127.0.0.1,localhost"}):await h(d)},"proxy"),browser:u(async({browser:d,launchOptions:h},o,a)=>{let e=u(()=>(a.project.use.playwrightExtra||[]).some(g=>g.constructor.name==="StealthPlugin"),"checkIfStealthPluginExists"),t=u(async()=>{let g=await(await new Bw({project:a.project}).buildChromiumWithPlugins()).launch(h);await o(g)},"launchBrowserWithStealthPlugin");Fe.useRemoteDebugging.enabled&&e()?await t():await o(d)},"browser"),launchOptions:u(async({launchOptions:d},h)=>{let o=d.args?[...d.args]:[],a=u(e=>{o.includes(e)||o.push(e)},"pushArg");c.useMockData&&a("--disable-web-security"),Fe.bypassProxyForLocalhost&&a("--proxy-bypass-list=localhost,127.0.0.1"),Fe.useRemoteDebugging.enabled&&a(`--remote-debugging-port=${Fe.useRemoteDebugging.port}`),await h({...d,args:o})},"launchOptions"),variableStore:u(async({},d)=>{let h=new Jf;await d(h)},"variableStore"),vs:u(async({variableStore:d},h)=>{await h(d)},"vs"),variablesStore:u(async({variableStore:d},h)=>{await h(d)},"variablesStore"),testRunAnalytics:u(async({},d,h)=>{let o=(()=>{try{if(process.env.CHECKSUM_TEST_SUITE_INFO)return JSON.parse(process.env.CHECKSUM_TEST_SUITE_INFO);throw new Error("Missing Checksum test suite info")}catch{return console.warn("\u26A0\uFE0F  Warning: It seems like you ran the test suite directly via Playwright. This can lead to degraded functionality and unexpected issues. To ensure a fully supported and stable test run, please use: 'npx checksumai test'."),cre("playwright-run-version-unknown",(0,ure.randomUUID)())}})(),a=sre(h)??"",e=Xo.getTestRunInstance({...o,checksumTestId:a},process.env.CHECKSUM_ISOLATED_MODE==="true",h);await d(e)},"testRunAnalytics"),monitorBridge:[async({},d,h)=>{let o=new Pw(h);await d(o)},{scope:"worker"}],context:u(async({context:d,monitorBridge:h,variableStore:o,testRunAnalytics:a},e,t)=>{let l=Rw.makeContext(d);l.setTestAssets({testRunAnalytics:a,monitorBridge:h,variableStore:o,testInfo:t,checksumTestId:sre(t),test:p,config:n,isReplMode:s}),await e(l),l.cleanup()},"context"),page:u(async({page:d,context:h},o,a)=>{let e=await h.makePage(d);Object.defineProperty(e.constructor,"name",{value:"Page"}),await o(e),e&&typeof e.onTestComplete=="function"&&await e.onTestComplete(a.status==="passed"),e&&typeof e.shutdown=="function"&&await e.shutdown()},"page")});return{test:p,defineChecksumTest:u3e}},"createChecksumTestExtension"),u3e=u((i,n,c)=>{let r=(new Error().stack?.split(`
-`)??[]).find(f=>f.includes(".checksum.spec.ts"));if(!r)throw new Error("Could not locate test location. Make sure test is run from valid checksum test file");return jM[r]=n,i},"defineChecksumTest");function sre(i){let{file:n,line:c}=i,s=Object.keys(jM).filter(f=>f.trim().includes(n.trim()));if(!s.length)return;let r=4;for(let f=0;f<r;f++)for(let p of s){let d;try{d=parseInt(p.split(":").reverse()[1]??"")}catch{continue}if(d-f===c)return jM[p]}}u(sre,"getCurrentTestIdFromMapping");var mRt=require("@playwright/test");var cRt=require("@playwright/test");var f3e=["toMatchSnapshot"],d3e=["toBe","toBeCloseTo","toBeDefined","toBeFalsy","toBeGreaterThan","toBeGreaterThanOrEqual","toBeInstanceOf","toBeLessThan","toBeLessThanOrEqual","toBeNaN","toBeNull","toBeTruthy","toBeUndefined","toContain","toContainEqual","toEqual","toHaveLength","toHaveProperty","toMatch","toMatchObject","toStrictEqual","toThrow","toThrowError"],dre=[...d3e,...f3e];var Dw=class{constructor(n,c,s=!1,r=!1,f={}){this.page=n;this.soft=s;this.skipAutoRecovery=r;this.configuration=f;this.fallbackEnabled=!1;this.withChecksumAI=!1;this.withChecksumAIMatcher=u(()=>(this.withChecksumAI=!0,Promise.reject(new Error)),"withChecksumAIMatcher");this.setThought(c)}static{u(this,"ExpectCallProxyHandler")}setThought(n){n&&(this.checksumAIThought=this.page.addNewThought(n,"assertion"),this.useChecksumAIOptions=this.page.getRuntimeOptions().useChecksumAI,this.useChecksumAIOptions.assertions&&(this.page.setAIFallback(n,"assertion"),this.fallbackEnabled=!0))}get(n,c,s){if(typeof c!="string")return Reflect.get(n,c);if(c==="checksumAI")return f=>(this.setThought(f),s);if(c==="withChecksumAI"||typeof Reflect.get(n,c)=="function"){let f=c==="withChecksumAI"?this.withChecksumAIMatcher:Reflect.get(n,c);return(...p)=>dre.includes(c)?f.call(n,...p):this.checksumAIThought?this.executeMatcherWithinStep(f,n,...p):this.executeMatcher(f,n,...p)}let r=Reflect.get(n,c);return new Proxy(r,this)}findNestedErrors(n,c){n.error&&n.infectParentStepsWithError&&c.push(n.error);for(let s of n.steps)this.findNestedErrors(s,c)}async callMatcher(n,c,...s){this.beforeMatcherCall();let r=n.call(c,...s),f=r instanceof Promise?await r:r;if(this.step){let p=[];if(this.step.error?p.push(this.step.error):this.findNestedErrors(this.step,p),p.length)throw p[0]}return f}executeMatcherWithinStep(n,c,...s){let r=this.checksumAIThought;if(!r)throw new Error("ExpectCallProxyHandler: checksumAIThought is not set");return this.page.step(r.thought,()=>this.callMatcher(n,c,...s).catch(this.onMatcherFailure.bind(this)),!1,{obtainStep:u(f=>this.step=f,"obtainStep")}).catch(f=>{if(!this.soft&&!(this.withChecksumAI&&f.message===sc))throw f}).finally(this.afterMatcherExecute.bind(this))}async executeMatcher(n,c,...s){try{return await this.callMatcher(n,c,...s)}catch(r){await this.onMatcherFailure(r);return}finally{this.afterMatcherExecute()}}beforeMatcherCall(){this.page.setExpectConfiguration(this.configuration)}afterMatcherExecute(){this.checksumAIThought=void 0,this.fallbackEnabled=!1,this.withChecksumAI=!1,this.page.resetFallbacks(),this.page.setExpectConfiguration(void 0)}shouldInitiateFallback(n){return!(!this.fallbackEnabled||Reflect.get(n,"matcherResult")?.name==="toHaveScreenshot"&&!this.useChecksumAIOptions?.visualComparison)}async onMatcherFailure(n){if(!this.shouldInitiateFallback(n))throw ye("[onMatcherFailure] fallback disabled, continuing with error."),this.page.testRunAnalytics.testRunAssertionExecutionFailure({failedThought:this.checksumAIThought?.thought??"",error:n.message,matcher:n.matcherResult?.name}),n;if(Bm()){if(ye("[onMatcherFailure] assertion failed inside a locator handler, skipping fallback"),this.soft)return;throw n}if(ye("[onMatcherFailure] initiating fallback sequence with thought:",this.checksumAIThought?.thought),this.skipAutoRecovery){if(this.soft)return;throw n}try{await this.page.initiateFallbackSequence({type:"assertion",error:n,withChecksumAI:this.withChecksumAI,testInfo:this.page.testInfo})}catch(c){if(this.soft)return;throw c}throw this.soft=!0,n}};var Nw=class i{constructor(n,c={}){this.page=n;this.configuration=c}static{u(this,"ExpectProxyHandler")}get(n,c){if(c==="setPage")return r=>{this.page=r};if(c==="extend")return(...r)=>{let f=n.extend(...r);return new Proxy(f,this)};if(c==="configure")return r=>{let f=n.configure(r);return new Proxy(f,new i(this.page,{...this.configuration,...r}))};if(c==="soft")return(...r)=>{let f=this.manipulateArgsAndExtractThought(r),p=n.soft(...r);return new Proxy(p,this.makeExpectCallProxyHandler(f,!0))};if(c==="poll")return(...r)=>{let f=this.manipulateArgsAndExtractThought(r),p=n.poll(...r);return new Proxy(p,this.makeExpectCallProxyHandler(f))};if(c==="skipAutoRecovery")return new Proxy(()=>{},{apply:u((f,p,d)=>{let h=this.manipulateArgsAndExtractThought(d),o=n.apply(p,d);return new Proxy(o,this.makeExpectCallProxyHandler(h,void 0,!0))},"apply"),get:u((f,p)=>{let d=new Proxy(n,new i(this.page,{...this.configuration,skipAutoRecovery:!0}));return Reflect.get(d,p)},"get")});let s=Reflect.get(n,c);return s instanceof Function?s.bind(n):s}apply(n,c,s){let r=this.manipulateArgsAndExtractThought(s),f=n.apply(c,s);return new Proxy(f,this.makeExpectCallProxyHandler(r))}makeExpectCallProxyHandler(n,c,s){if(!this.page)throw new Error("ExpectProxyHandler: page is not set");return new Dw(this.page,n,c===!0?!0:this.configuration.soft,s===!0?!0:this.configuration.skipAutoRecovery,this.configuration)}manipulateArgsAndExtractThought(n){let c,s=n[1];if(typeof s=="string")c=s,n[1]=void 0;else if(s!==null&&typeof s=="object"){let r=s;if(r.checksumAI===!1){r.checksumAI=void 0;return}r.checksumAI&&typeof r.checksumAI=="string"?(c=r.checksumAI,r.checksumAI=void 0):r.message&&(c=r.message,r.message=void 0)}return c}};var Lw=class i{constructor(n){this.expect=n;this.proxy=new Proxy(this.expect,new Nw)}static{u(this,"ChecksumExpect")}static init(n){return new i(n).proxy}};var pre=require("@playwright/test");function p3e(i,n=AI()){let{options:c,apiKey:s,environments:r,defaultEnvironmentName:f}=n,p=r?.find(g=>g.default);if(f&&(p=r?.find(g=>g.name===f)),!p)throw new Error("No default environment found. Please set the default field to true on one of the environments in the checksum.config.ts file.");if(!p.baseURL)throw new Error("A baseURL is required. Please set the baseURL field in the default environment in the checksum.config.ts file.");if(!p.users?.find(g=>g.default))throw new Error("A default user within the default environment is required. Please set one of the default environment users as default in the checksum.config.ts file.");if(!s)throw new Error("An API key is required. Please set the apiKey field in the checksum.config.ts file.");let h=process.env.CHECKSUM_REPL==="true",{test:o,defineChecksumTest:a}=fre(i??pre.test,n,c,h),e=Lw.init(o.expect),t=h3e();o._checksum={expect:e,checksumAI:t},h&&(o.beforeEach(async()=>{o.setTimeout(0)}),o.afterEach(async()=>{for(;;)await ct(1e3)}));let l=u(({name:g,userRole:A})=>{let{envName:y,role:v}=LM({...g!==void 0?{envName:g}:{},...A!==void 0?{role:A}:{}}),{environment:O,user:m}=QM(n,{...y!==void 0?{environment:y}:{},...v!==void 0?{role:v}:{}},!0),k=tre({config:n,throwIfEnvInfoInvalid:!0},{environmentName:O.name,userRole:m.role});return{environment:O,user:m,login:k}},"getEnvironment");return{test:o,expect:e,login:ds({config:n}),defineChecksumTest:a,getEnvironment:l,checksumAI:t}}u(p3e,"init");var HM=u(i=>new Proxy(i,{apply:u(function(c,s,r){let f={...c.options,...r[2]};return c.page.checksumAI(r[0],r[1],f)},"apply"),get:u(function(c,s){return s==="withDialog"?(c.options.withDialog=!0,HM(i)):s==="skipAutoRecovery"?(c.options.skipAutoRecovery=!0,HM(i)):c[s]},"get"),set:u(function(c,s,r){return s!=="page"?!1:(c[s]=r,!!r)},"set")}),"makeChecksumAIProxy"),h3e=u(()=>{let i=u(function(){},"func");return i.page=void 0,i.options={withDialog:!1,skipAutoRecovery:!1},HM(i)},"makeChecksumAI");0&&(module.exports={AutoRecoveryMode,RunMode,getChecksumConfig,getLogin,init});
+`)??[]).find(f=>f.includes(".checksum.spec.ts"));if(!r)throw new Error("Could not locate test location. Make sure test is run from valid checksum test file");return jM[r]=n,i},"defineChecksumTest");function sre(i){let{file:n,line:c}=i,s=Object.keys(jM).filter(f=>f.trim().includes(n.trim()));if(!s.length)return;let r=4;for(let f=0;f<r;f++)for(let p of s){let d;try{d=parseInt(p.split(":").reverse()[1]??"")}catch{continue}if(d-f===c)return jM[p]}}u(sre,"getCurrentTestIdFromMapping");var mRt=require("@playwright/test");var cRt=require("@playwright/test");var f3e=["toMatchSnapshot"],d3e=["toBe","toBeCloseTo","toBeDefined","toBeFalsy","toBeGreaterThan","toBeGreaterThanOrEqual","toBeInstanceOf","toBeLessThan","toBeLessThanOrEqual","toBeNaN","toBeNull","toBeTruthy","toBeUndefined","toContain","toContainEqual","toEqual","toHaveLength","toHaveProperty","toMatch","toMatchObject","toStrictEqual","toThrow","toThrowError"],dre=[...d3e,...f3e];var Dw=class{constructor(n,c,s=!1,r=!1,f={}){this.page=n;this.soft=s;this.skipAutoRecovery=r;this.configuration=f;this.fallbackEnabled=!1;this.withChecksumAI=!1;this.withChecksumAIMatcher=u(()=>(this.withChecksumAI=!0,Promise.reject(new Error)),"withChecksumAIMatcher");this.setThought(c)}static{u(this,"ExpectCallProxyHandler")}setThought(n){n&&(this.checksumAIThought=this.page.addNewThought(n,"assertion"),this.useChecksumAIOptions=this.page.getRuntimeOptions().useChecksumAI,this.useChecksumAIOptions.assertions&&(this.page.setAIFallback(n,"assertion"),this.fallbackEnabled=!0))}get(n,c,s){if(typeof c!="string")return Reflect.get(n,c);if(c==="checksumAI")return f=>(this.setThought(f),s);if(c==="withChecksumAI"||typeof Reflect.get(n,c)=="function"){let f=c==="withChecksumAI"?this.withChecksumAIMatcher:Reflect.get(n,c);return(...p)=>dre.includes(c)?f.call(n,...p):this.checksumAIThought?this.executeMatcherWithinStep(f,n,...p):this.executeMatcher(f,n,...p)}let r=Reflect.get(n,c);return new Proxy(r,this)}findNestedErrors(n,c){n.error&&n.infectParentStepsWithError&&c.push(n.error);for(let s of n.steps)this.findNestedErrors(s,c)}async callMatcher(n,c,...s){this.beforeMatcherCall();let r=n.call(c,...s),f=r instanceof Promise?await r:r;if(this.step){let p=[];if(this.step.error?p.push(this.step.error):this.findNestedErrors(this.step,p),p.length)throw p[0]}return f}executeMatcherWithinStep(n,c,...s){let r=this.checksumAIThought;if(!r)throw new Error("ExpectCallProxyHandler: checksumAIThought is not set");return this.page.step(r.thought,()=>this.callMatcher(n,c,...s).catch(this.onMatcherFailure.bind(this)),!1,{obtainStep:u(f=>this.step=f,"obtainStep")}).catch(f=>{if(!this.soft&&!(this.withChecksumAI&&f.message===sc))throw f}).finally(this.afterMatcherExecute.bind(this))}async executeMatcher(n,c,...s){try{return await this.callMatcher(n,c,...s)}catch(r){await this.onMatcherFailure(r);return}finally{this.afterMatcherExecute()}}beforeMatcherCall(){this.page.setExpectConfiguration(this.configuration)}afterMatcherExecute(){this.checksumAIThought=void 0,this.fallbackEnabled=!1,this.withChecksumAI=!1,this.page.resetFallbacks(),this.page.setExpectConfiguration(void 0)}shouldInitiateFallback(n){return!(!this.fallbackEnabled||Reflect.get(n,"matcherResult")?.name==="toHaveScreenshot"&&!this.useChecksumAIOptions?.visualComparison)}async onMatcherFailure(n){if(!this.shouldInitiateFallback(n))throw ye("[onMatcherFailure] fallback disabled, continuing with error."),this.page.testRunAnalytics.testRunAssertionExecutionFailure({failedThought:this.checksumAIThought?.thought??"",error:n.message,matcher:n.matcherResult?.name}),n;if(Bm()){if(ye("[onMatcherFailure] assertion failed inside a locator handler, skipping fallback"),this.soft)return;throw n}if(ye("[onMatcherFailure] initiating fallback sequence with thought:",this.checksumAIThought?.thought),this.skipAutoRecovery){if(this.soft)return;throw n}try{await this.page.initiateFallbackSequence({type:"assertion",error:n,withChecksumAI:this.withChecksumAI,testInfo:this.page.testInfo})}catch(c){if(this.soft)return;throw c}throw this.soft=!0,n}};var Nw=class i{constructor(n,c={}){this.page=n;this.configuration=c}static{u(this,"ExpectProxyHandler")}get(n,c){if(c==="setPage")return r=>{this.page=r};if(c==="extend")return(...r)=>{let f=n.extend(...r);return new Proxy(f,this)};if(c==="configure")return r=>{let f=n.configure(r);return new Proxy(f,new i(this.page,{...this.configuration,...r}))};if(c==="soft")return(...r)=>{let f=this.manipulateArgsAndExtractThought(r),p=n.soft(...r);return new Proxy(p,this.makeExpectCallProxyHandler(f,!0))};if(c==="poll")return(...r)=>{let f=this.manipulateArgsAndExtractThought(r),p=n.poll(...r);return new Proxy(p,this.makeExpectCallProxyHandler(f))};if(c==="skipAutoRecovery")return new Proxy(()=>{},{apply:u((f,p,d)=>{let h=this.manipulateArgsAndExtractThought(d),o=n.apply(p,d);return new Proxy(o,this.makeExpectCallProxyHandler(h,void 0,!0))},"apply"),get:u((f,p)=>{let d=new Proxy(n,new i(this.page,{...this.configuration,skipAutoRecovery:!0}));return Reflect.get(d,p)},"get")});let s=Reflect.get(n,c);return s instanceof Function?s.bind(n):s}apply(n,c,s){let r=this.manipulateArgsAndExtractThought(s),f=n.apply(c,s);return new Proxy(f,this.makeExpectCallProxyHandler(r))}makeExpectCallProxyHandler(n,c,s){if(!this.page)throw new Error("ExpectProxyHandler: page is not set");return new Dw(this.page,n,c===!0?!0:this.configuration.soft,s===!0?!0:this.configuration.skipAutoRecovery,this.configuration)}manipulateArgsAndExtractThought(n){let c,s=n[1];if(typeof s=="string")c=s,n[1]=void 0;else if(s!==null&&typeof s=="object"){let r=s;if(r.checksumAI===!1){r.checksumAI=void 0;return}r.checksumAI&&typeof r.checksumAI=="string"?(c=r.checksumAI,r.checksumAI=void 0):r.message&&(c=r.message,r.message=void 0)}return c}};var Lw=class i{constructor(n){this.expect=n;let c=new Proxy(this.expect,new Nw);this.proxy=c}static{u(this,"ChecksumExpect")}static init(n){return new i(n).proxy}};var pre=require("@playwright/test");function p3e(i,n=AI()){let{options:c,apiKey:s,environments:r,defaultEnvironmentName:f}=n,p=r?.find(g=>g.default);if(f&&(p=r?.find(g=>g.name===f)),!p)throw new Error("No default environment found. Please set the default field to true on one of the environments in the checksum.config.ts file.");if(!p.baseURL)throw new Error("A baseURL is required. Please set the baseURL field in the default environment in the checksum.config.ts file.");if(!p.users?.find(g=>g.default))throw new Error("A default user within the default environment is required. Please set one of the default environment users as default in the checksum.config.ts file.");if(!s)throw new Error("An API key is required. Please set the apiKey field in the checksum.config.ts file.");let h=process.env.CHECKSUM_REPL==="true",{test:o,defineChecksumTest:a}=fre(i??pre.test,n,c,h),e=Lw.init(o.expect),t=h3e();o._checksum={expect:e,checksumAI:t},h&&(o.beforeEach(async()=>{o.setTimeout(0)}),o.afterEach(async()=>{for(;;)await ct(1e3)}));let l=u(({name:g,userRole:A})=>{let{envName:y,role:v}=LM({...g!==void 0?{envName:g}:{},...A!==void 0?{role:A}:{}}),{environment:O,user:m}=QM(n,{...y!==void 0?{environment:y}:{},...v!==void 0?{role:v}:{}},!0),k=tre({config:n,throwIfEnvInfoInvalid:!0},{environmentName:O.name,userRole:m.role});return{environment:O,user:m,login:k}},"getEnvironment");return{test:o,expect:e,login:ds({config:n}),defineChecksumTest:a,getEnvironment:l,checksumAI:t}}u(p3e,"init");var HM=u(i=>new Proxy(i,{apply:u(function(c,s,r){let f={...c.options,...r[2]};return c.page.checksumAI(r[0],r[1],f)},"apply"),get:u(function(c,s){return s==="withDialog"?(c.options.withDialog=!0,HM(i)):s==="skipAutoRecovery"?(c.options.skipAutoRecovery=!0,HM(i)):c[s]},"get"),set:u(function(c,s,r){return s!=="page"?!1:(c[s]=r,!!r)},"set")}),"makeChecksumAIProxy"),h3e=u(()=>{let i=u(function(){},"func");return i.page=void 0,i.options={withDialog:!1,skipAutoRecovery:!1},HM(i)},"makeChecksumAI");0&&(module.exports={AutoRecoveryMode,RunMode,getChecksumConfig,getLogin,init});
 /*! Bundled license information:
 
 playwright-extra/dist/index.cjs.js:

package/package.json

@@ -3,7 +3,7 @@
   "description": "Checksum.ai test runtime",
   "main": "index.js",
   "dependencies": {
-    "@playwright/test": "1.60.0",
+    "@playwright/test": "1.62.1",
     "dotenv": "17.4.2",
     "jsdom": "30.0.1",
     "playwright-extra": "4.3.6",
@@ -45,5 +45,5 @@
     "url": "https://github.com/checksum-ai/checksum-ai-monorepo/issues"
   },
   "homepage": "https://github.com/checksum-ai/checksum-ai-monorepo/tree/main/packages/runtime#readme",
-  "version": "4.16.2"
+  "version": "4.16.3"
 }

package/scripts/patch.js

@@ -11,8 +11,6 @@ const availablePatchVersions = fs
   .map((patchFile) => path.basename(patchFile, ".js"))
   .sort();
 
-// console.log("patchVersions", availablePatchVersions);
-
 function findSuitablePatchVersion(version) {
   let suitablePatchVersion = availablePatchVersions[0];
   for (const patchVersion of availablePatchVersions) {
@@ -39,20 +37,12 @@ for (const projectPath of projectPaths) {
       const packageJSON = require(absolutePathToPackageJSON);
       const playwrightVersion = packageJSON.version;
       const patchVersion = findSuitablePatchVersion(playwrightVersion);
-      // console.log(
-      //   "Found installed version",
-      //   playwrightVersion,
-      //   "and will use patch for version",
-      //   patchVersion
-      // );
       const patchPath = resolve(
         join(getPlaywrightPatchesDirectory(), `${patchVersion}.js`)
       );
       require(patchPath)(projectPath);
-    } else {
-      // console.warn("Project path not found", projectPath);
     }
   } catch (e) {
-    // ignore for now although we might want to notify users that patching wasn't successful
+    // Patching is best-effort: a failure here must not block the install.
   }
 }

package/scripts/playwright_patches/1.41.2.js

@@ -1,52 +1,41 @@
 const fs = require("fs");
 const { join } = require("path");
 
-// Args
 const on = process.argv[2] !== "off";
 
-// -------- [Modifiers] -------- //
-
-// Amends the file with the given entry point text and append text
-// When "on" is true, the append text is added to the entry point,
-// otherwise the append text is completely removed from the file
+// When `on`, appendText is spliced in after entryPointText; when off, it is
+// stripped back out. Leaves no marker, so an amend cannot be detected later.
 function amend(filePath, entryPointText, appendText) {
   const data = fs.readFileSync(filePath, "utf8");
   if (!data.includes(entryPointText)) {
     throw new Error("Entry point not found!", entryPointText);
   }
-  // Ignore if the append text is already present
   if (on && data.includes(appendText)) {
     return;
   }
-  // Add or clear according to on state
   const result = on
     ? data.replace(entryPointText, entryPointText + appendText)
     : data.replace(appendText, "");
 
-  // Write
   fs.writeFileSync(filePath, result, "utf8");
 }
 
-// Replaces content.
-// When "on" is true, the new content is written to the file replacing the original content,
-// otherwise the original content is restored.
+// When `on`, newContent replaces originalContent; when off, the original is
+// restored. The `/* checksumai */` prefix is the marker that makes the off
+// direction findable.
 function replaceContent(filePath, originalContent, newContent) {
-  // Read the file content
   const fileContent = fs.readFileSync(filePath, "utf8");
 
-  // add a marker for newContent that can be later recognized for "off" state
   newContent = `/* checksumai */ ${newContent}`;
 
   if (on && fileContent.includes(newContent)) {
     return;
   }
 
-  // Join the lines back into a single string
   const updatedContent = on
     ? fileContent.replace(originalContent, newContent)
     : fileContent.replace(newContent, originalContent);
 
-  // Write the modified content back to the file
   fs.writeFileSync(filePath, updatedContent, "utf8");
 }
 
@@ -58,9 +47,6 @@ function doesFileExist(filePath) {
   return true;
 }
 
-// -------- [Modifications] -------- //
-
-// Remove conditions for injecting Playwright scripts
 function alwaysInjectScripts(projectRoot) {
   const file = join(
     projectRoot,
@@ -78,7 +64,6 @@ function alwaysInjectScripts(projectRoot) {
   replaceContent(file, originalContent, newContent);
 }
 
-// Add implementation for generateSelectorAndLocator and inject to Playwright console API
 function addGenerateSelectorAndLocator(projectRoot) {
   const file = join(
     projectRoot,
@@ -99,8 +84,6 @@ function addGenerateSelectorAndLocator(projectRoot) {
   amend(file, entryPointText2, appendText2);
 }
 
-// -------- [Runtime modifications] -------- //
-
 function expect(projectRoot) {
   const file = join(
     projectRoot,
@@ -216,12 +199,18 @@ function testType(projectRoot) {
 }
 
 function indexContent(projectRoot) {
-  const file = join(projectRoot, "node_modules", "playwright", "lib", "index.js")
+  const file = join(
+    projectRoot,
+    "node_modules",
+    "playwright",
+    "lib",
+    "index.js"
+  );
   if (!doesFileExist) {
     return;
   }
   let originalContent, newContent;
-  originalContent = `const browser = await playwright[browserName].launch();`
+  originalContent = `const browser = await playwright[browserName].launch();`;
   newContent = `
     let browser = playwright[browserName];
     try {
@@ -250,8 +239,8 @@ function indexContent(projectRoot) {
       );
     }
     browser = await browser.launch();
-  `
-  replaceContent(file, originalContent, newContent)
+  `;
+  replaceContent(file, originalContent, newContent);
 }
 
 function channelOwner(projectRoot) {
@@ -283,8 +272,6 @@ function channelOwner(projectRoot) {
   amend(file, entryPointText, appendText);
 }
 
-// -------- [Run] -------- //
-
 const isRuntime = true || process.env.RUNTIME === "true";
 
 function run(projectPath) {
@@ -299,11 +286,9 @@ function run(projectPath) {
         channelOwner(projectPath);
         indexContent(projectPath);
       }
-    } else {
-      // console.warn("Project path not found", projectPath);
     }
   } catch (e) {
-    // ignore
+    // Patching is best-effort: a failure here must not block the install.
   }
 }
 

package/scripts/playwright_patches/1.46.0.js

@@ -1,52 +1,41 @@
 const fs = require("fs");
 const { join } = require("path");
 
-// Args
 const on = process.argv[2] !== "off";
 
-// -------- [Modifiers] -------- //
-
-// Amends the file with the given entry point text and append text
-// When "on" is true, the append text is added to the entry point,
-// otherwise the append text is completely removed from the file
+// When `on`, appendText is spliced in after entryPointText; when off, it is
+// stripped back out. Leaves no marker, so an amend cannot be detected later.
 function amend(filePath, entryPointText, appendText) {
   const data = fs.readFileSync(filePath, "utf8");
   if (!data.includes(entryPointText)) {
     throw new Error("Entry point not found!", entryPointText);
   }
-  // Ignore if the append text is already present
   if (on && data.includes(appendText)) {
     return;
   }
-  // Add or clear according to on state
   const result = on
     ? data.replace(entryPointText, entryPointText + appendText)
     : data.replace(appendText, "");
 
-  // Write
   fs.writeFileSync(filePath, result, "utf8");
 }
 
-// Replaces content.
-// When "on" is true, the new content is written to the file replacing the original content,
-// otherwise the original content is restored.
+// When `on`, newContent replaces originalContent; when off, the original is
+// restored. The `/* checksumai */` prefix is the marker that makes the off
+// direction findable.
 function replaceContent(filePath, originalContent, newContent) {
-  // Read the file content
   const fileContent = fs.readFileSync(filePath, "utf8");
 
-  // add a marker for newContent that can be later recognized for "off" state
   newContent = `/* checksumai */ ${newContent}`;
 
   if (on && fileContent.includes(newContent)) {
     return;
   }
 
-  // Join the lines back into a single string
   const updatedContent = on
     ? fileContent.replace(originalContent, newContent)
     : fileContent.replace(newContent, originalContent);
 
-  // Write the modified content back to the file
   fs.writeFileSync(filePath, updatedContent, "utf8");
 }
 
@@ -58,9 +47,6 @@ function doesFileExist(filePath) {
   return true;
 }
 
-// -------- [Modifications] -------- //
-
-// Remove conditions for injecting Playwright scripts
 function alwaysInjectScripts(projectRoot) {
   const file = join(
     projectRoot,
@@ -78,7 +64,6 @@ function alwaysInjectScripts(projectRoot) {
   replaceContent(file, originalContent, newContent);
 }
 
-// Add implementation for generateSelectorAndLocator and inject to Playwright console API
 function addGenerateSelectorAndLocator(projectRoot) {
   const file = join(
     projectRoot,
@@ -99,8 +84,6 @@ function addGenerateSelectorAndLocator(projectRoot) {
   amend(file, entryPointText2, appendText2);
 }
 
-// -------- [Runtime modifications] -------- //
-
 function expect(projectRoot) {
   const file = join(
     projectRoot,
@@ -110,30 +93,6 @@ function expect(projectRoot) {
     return;
   }
   let originalContent, newContent;
-
-  // originalContent = `return (...args) => {
-  //     const testInfo = (0, _globals.currentTestInfo)();`;
-  // newContent = `return (...args) => {
-  //     let noSoft = false;
-  //     if (args.find(arg=>arg==='no-soft')){
-  //       noSoft = true;
-  //       args.pop();
-  //     }
-  //     const testInfo = (0, _globals.currentTestInfo)();`;
-  // replaceContent(file, originalContent, newContent);
-
-  // originalContent = `step.complete({
-  //         error
-  //       })`;
-  // newContent = `step.complete({
-  //         error,
-  //         noSoft
-  //       })`;
-  // replaceContent(file, originalContent, newContent);
-
-  // originalContent = `if (this._info.isSoft) testInfo._failWithError(error);else throw error;`;
-  // newContent = `if (this._info.isSoft && !noSoft) testInfo._failWithError(error);else throw error;`;
-  // replaceContent(file, originalContent, newContent);
 }
 
 function testInfo(projectRoot) {
@@ -147,10 +106,6 @@ function testInfo(projectRoot) {
   let originalContent, newContent;
   let entryPointText, appendText;
 
-  // originalContent = `const filteredStack = (0, _util.filteredStackTrace)((0, _utils.captureRawStack)());`;
-  // newContent = `const filteredStack = (0, _util.filteredStackTrace)((0, _utils.captureRawStack)().filter(s=>!s.includes('@checksum-ai/runtime')));`;
-  // replaceContent(file, originalContent, newContent);
-
   entryPointText = `data.location = data.location || filteredStack[0];`;
   appendText = `\nif (this._checksumInternal) {
       data.location = undefined;
@@ -256,10 +211,6 @@ function channelOwner(projectRoot) {
     }`;
   amend(file, entryPointText, appendText);
 
-  // originalContent = `const stack = (0, _stackTrace.captureRawStack)();`;
-  // newContent = `const stack = (0, _stackTrace.captureRawStack)().filter(s=>!s.includes('@checksum-ai/runtime'));`;
-  // replaceContent(file, originalContent, newContent);
-
   entryPointText = `let apiName = stackTrace.apiName;`;
   appendText = `\nif (!isInternal && this._checksumTitle){
       apiName = this._checksumTitle;
@@ -289,8 +240,6 @@ function stackTrace(projectRoot) {
   replaceContent(file, originalContent, newContent);
 }
 
-// -------- [Run] -------- //
-
 const isRuntime = true || process.env.RUNTIME === "true";
 
 function run(projectPath) {
@@ -306,11 +255,9 @@ function run(projectPath) {
         stackTrace(projectPath);
         indexContent(projectPath);
       }
-    } else {
-      // console.warn("Project path not found", projectPath);
     }
   } catch (e) {
-    // ignore
+    // Patching is best-effort: a failure here must not block the install.
   }
 }
 

package/scripts/playwright_patches/1.51.0.js

@@ -1,52 +1,41 @@
 const fs = require("fs");
 const { join } = require("path");
 
-// Args
 const on = process.argv[2] !== "off";
 
-// -------- [Modifiers] -------- //
-
-// Amends the file with the given entry point text and append text
-// When "on" is true, the append text is added to the entry point,
-// otherwise the append text is completely removed from the file
+// When `on`, appendText is spliced in after entryPointText; when off, it is
+// stripped back out. Leaves no marker, so an amend cannot be detected later.
 function amend(filePath, entryPointText, appendText) {
   const data = fs.readFileSync(filePath, "utf8");
   if (!data.includes(entryPointText)) {
     throw new Error("Entry point not found!", entryPointText);
   }
-  // Ignore if the append text is already present
   if (on && data.includes(appendText)) {
     return;
   }
-  // Add or clear according to on state
   const result = on
     ? data.replace(entryPointText, entryPointText + appendText)
     : data.replace(appendText, "");
 
-  // Write
   fs.writeFileSync(filePath, result, "utf8");
 }
 
-// Replaces content.
-// When "on" is true, the new content is written to the file replacing the original content,
-// otherwise the original content is restored.
+// When `on`, newContent replaces originalContent; when off, the original is
+// restored. The `/* checksumai */` prefix is the marker that makes the off
+// direction findable.
 function replaceContent(filePath, originalContent, newContent) {
-  // Read the file content
   const fileContent = fs.readFileSync(filePath, "utf8");
 
-  // add a marker for newContent that can be later recognized for "off" state
   newContent = `/* checksumai */ ${newContent}`;
 
   if (on && fileContent.includes(newContent)) {
     return;
   }
 
-  // Join the lines back into a single string
   const updatedContent = on
     ? fileContent.replace(originalContent, newContent)
     : fileContent.replace(newContent, originalContent);
 
-  // Write the modified content back to the file
   fs.writeFileSync(filePath, updatedContent, "utf8");
 }
 
@@ -58,9 +47,6 @@ function doesFileExist(filePath) {
   return true;
 }
 
-// -------- [Modifications] -------- //
-
-// Remove conditions for injecting Playwright scripts
 function alwaysInjectScripts(projectRoot) {
   const file = join(
     projectRoot,
@@ -71,7 +57,6 @@ function alwaysInjectScripts(projectRoot) {
   }
   const originalContent =
     "if ((0, _debug.debugMode)() === 'console') await this.extendInjectedScript(consoleApiSource.source);";
-  // "if ((0, _utils.debugMode)() === 'console') await this.extendInjectedScript(consoleApiSource.source);";
 
   const newContent =
     "await this.extendInjectedScript(consoleApiSource.source);";
@@ -79,7 +64,6 @@ function alwaysInjectScripts(projectRoot) {
   replaceContent(file, originalContent, newContent);
 }
 
-// Add implementation for generateSelectorAndLocator and inject to Playwright console API
 function addGenerateSelectorAndLocator(projectRoot) {
   const file = join(
     projectRoot,
@@ -100,8 +84,6 @@ function addGenerateSelectorAndLocator(projectRoot) {
   amend(file, entryPointText2, appendText2);
 }
 
-// -------- [Runtime modifications] -------- //
-
 function expect(projectRoot) {
   const file = join(
     projectRoot,
@@ -111,30 +93,6 @@ function expect(projectRoot) {
     return;
   }
   let originalContent, newContent;
-
-  // originalContent = `return (...args) => {
-  //     const testInfo = (0, _globals.currentTestInfo)();`;
-  // newContent = `return (...args) => {
-  //     let noSoft = false;
-  //     if (args.find(arg=>arg==='no-soft')){
-  //       noSoft = true;
-  //       args.pop();
-  //     }
-  //     const testInfo = (0, _globals.currentTestInfo)();`;
-  // replaceContent(file, originalContent, newContent);
-
-  // originalContent = `step.complete({
-  //         error
-  //       })`;
-  // newContent = `step.complete({
-  //         error,
-  //         noSoft
-  //       })`;
-  // replaceContent(file, originalContent, newContent);
-
-  // originalContent = `if (this._info.isSoft) testInfo._failWithError(error);else throw error;`;
-  // newContent = `if (this._info.isSoft && !noSoft) testInfo._failWithError(error);else throw error;`;
-  // replaceContent(file, originalContent, newContent);
 }
 
 function testInfo(projectRoot) {
@@ -148,10 +106,6 @@ function testInfo(projectRoot) {
   let originalContent, newContent;
   let entryPointText, appendText;
 
-  // originalContent = `const filteredStack = (0, _util.filteredStackTrace)((0, _utils.captureRawStack)());`;
-  // newContent = `const filteredStack = (0, _util.filteredStackTrace)((0, _utils.captureRawStack)().filter(s=>!s.includes('@checksum-ai/runtime')));`;
-  // replaceContent(file, originalContent, newContent);
-
   entryPointText = `data.location = data.location || filteredStack[0];`;
   appendText = `\nif (this._checksumInternal) {
       data.location = undefined;
@@ -189,7 +143,6 @@ function testType(projectRoot) {
   }
 
   entryPointText = `return await (0, _utils.currentZone)().with('stepZone', step).run(async () => {`;
-  // entryPointText = `return await _utils.zones.run('stepZone', step, async () => {`;
   appendText = `\nif (options.obtainStep){
         options.obtainStep(step);
       }`;
@@ -253,18 +206,12 @@ function channelOwner(projectRoot) {
   let entryPointText, appendText;
 
   entryPointText = `async _wrapApiCall(func, isInternal) {`;
-  // entryPointText = `async _wrapApiCall(func, isInternal = false) {`;
 
   appendText = `\nif (this._checksumInternal){
       isInternal = true;
     }`;
   amend(file, entryPointText, appendText);
 
-  // originalContent = `const stack = (0, _stackTrace.captureRawStack)();`;
-  // newContent = `const stack = (0, _stackTrace.captureRawStack)().filter(s=>!s.includes('@checksum-ai/runtime'));`;
-  // replaceContent(file, originalContent, newContent);
-
-  // entryPointText = `let apiName = stackTrace.apiName;`;
   entryPointText = `const apiZone = {
       apiName: stackTrace.apiName,
       frames: stackTrace.frames,
@@ -287,18 +234,11 @@ function channelOwner(projectRoot) {
       apiZone.apiName = apiZone.apiName.replace('proxy', 'page');
     }`;
   amend(file, entryPointText, appendText);
-
-  // entryPointText = `if (isInternal) apiName = undefined;`;
-  // appendText = `\nif (apiName && apiName.startsWith('proxy')) {
-  //     apiName = apiName.replace('proxy', 'page');
-  //   }`;
-  // amend(file, entryPointText, appendText);
 }
 
 function stackTrace(projectRoot) {
   const file = join(
     projectRoot,
-    // "node_modules/playwright-core/lib/utils/stackTrace.js"
     "node_modules/playwright-core/lib/utils/isomorphic/stackTrace.js"
   );
   if (!doesFileExist(file)) {
@@ -311,8 +251,6 @@ function stackTrace(projectRoot) {
   replaceContent(file, originalContent, newContent);
 }
 
-// -------- [Run] -------- //
-
 const isRuntime = true || process.env.RUNTIME === "true";
 
 function run(projectPath) {
@@ -328,11 +266,9 @@ function run(projectPath) {
         stackTrace(projectPath);
         indexContent(projectPath);
       }
-    } else {
-      // console.warn("Project path not found", projectPath);
     }
   } catch (e) {
-    // ignore
+    // Patching is best-effort: a failure here must not block the install.
   }
 }