@plan2net/typo3-playwright-toolkit 0.15.0 → 0.17.0

package/dist/checks/screenshot.js

@@ -42,12 +42,93 @@ export async function loadLazyElements(page) {
         .querySelectorAll('[loading="lazy"]')
         .forEach((element) => (element.loading = 'eager')));
 }
-async function waitForImagesDecoded(page, timeout = 15000) {
-    await page.evaluate(async (timeout) => {
+// A capture reaching past the viewport collapses it to 1x1 first, and a width-based
+// `media` on a `<source>` flips while it is collapsed, dropping the decoded image.
+export async function freezeResponsiveImages(page) {
+    await page.evaluate(() => {
+        document.querySelectorAll('img').forEach((image) => {
+            const resolved = image.currentSrc;
+            if (!resolved) {
+                return;
+            }
+            image.dataset.toolkitFrozen = JSON.stringify({
+                src: image.getAttribute('src'),
+                srcset: image.getAttribute('srcset'),
+                sizes: image.getAttribute('sizes'),
+                width: image.getAttribute('width'),
+                height: image.getAttribute('height'),
+            });
+            const sources = Array.from(image.closest('picture')?.querySelectorAll('source') ?? []);
+            // width and height on the chosen source lay the img out, and disabling it
+            // would drop them.
+            const chosen = sources.find((source) => !source.media || matchMedia(source.media).matches);
+            for (const dimension of ['width', 'height']) {
+                const value = chosen?.getAttribute(dimension);
+                if (null != value) {
+                    image.setAttribute(dimension, value);
+                }
+            }
+            sources.forEach((source) => {
+                source.dataset.toolkitFrozen = JSON.stringify({ media: source.getAttribute('media') });
+                // Never matches, so selection falls through to the img below.
+                source.media = 'not all';
+            });
+            image.removeAttribute('srcset');
+            image.removeAttribute('sizes');
+            if (image.src !== resolved) {
+                image.src = resolved;
+            }
+        });
+    });
+}
+// Settle first, or a loading image has no currentSrc to pin it to; settle again,
+// because pinning a <picture> starts a load of its own.
+export async function prepareImagesForCapture(page) {
+    const stalled = await waitForImagesDecoded(page);
+    await freezeResponsiveImages(page);
+    await waitForImagesDecoded(page);
+    return stalled;
+}
+export async function restoreResponsiveImages(page) {
+    await page.evaluate(() => {
+        const put = (element, name, value) => null === value ? element.removeAttribute(name) : element.setAttribute(name, value);
+        document.querySelectorAll('img[data-toolkit-frozen]').forEach((image) => {
+            image
+                .closest('picture')
+                ?.querySelectorAll('source[data-toolkit-frozen]')
+                .forEach((source) => {
+                const { media } = JSON.parse(source.dataset.toolkitFrozen ?? '{}');
+                put(source, 'media', media);
+                delete source.dataset.toolkitFrozen;
+            });
+            const frozen = JSON.parse(image.dataset.toolkitFrozen ?? '{}');
+            Object.entries(frozen).forEach(([name, value]) => put(image, name, value));
+            delete image.dataset.toolkitFrozen;
+        });
+    });
+}
+const DECODE_TIMEOUT = 15000;
+/** @returns the sources of the images that never decoded, empty when all did */
+export async function waitForImagesDecoded(page, timeout = DECODE_TIMEOUT) {
+    const deadline = Date.now() + timeout;
+    const stalled = await settleImages(page, timeout);
+    const left = deadline - Date.now();
+    // Out of budget, so a second round would settle nothing and report every image.
+    if (left <= 0) {
+        return stalled;
+    }
+    // A load that starts during a round is not waited for by it, which is how
+    // applyDeferredStylesheets re-selects a source after the image read as complete.
+    return settleImages(page, left);
+}
+function settleImages(page, timeout) {
+    return page.evaluate(async (timeout) => {
         const images = Array.from(document.querySelectorAll('img'));
+        const stalled = new Set(images);
         const settle = (image) => new Promise((resolve) => {
             const finish = async () => {
                 await image.decode().catch(() => { });
+                stalled.delete(image);
                 resolve();
             };
             if (image.complete) {
@@ -55,13 +136,29 @@ async function waitForImagesDecoded(page, timeout = 15000) {
                 return;
             }
             image.addEventListener('load', () => void finish(), { once: true });
-            image.addEventListener('error', () => resolve(), { once: true });
+            image.addEventListener('error', () => {
+                stalled.delete(image);
+                resolve();
+            }, { once: true });
         });
         const timeoutPromise = new Promise((resolve) => setTimeout(resolve, timeout));
         await Promise.race([Promise.all(images.map(settle)), timeoutPromise]);
         await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
+        // The snapshot above predates anything that started loading since.
+        document.querySelectorAll('img').forEach((image) => {
+            if (!image.complete) {
+                stalled.add(image);
+            }
+        });
+        return Array.from(stalled, (image) => image.currentSrc || image.src);
     }, timeout);
 }
+/** An undecoded image is blank, and a first run writes that blank as the baseline. */
+export function warnAboutUndecodedImages(stalled, timeout) {
+    console.warn(`[typo3-playwright-toolkit] ${stalled.length} ${1 === stalled.length ? 'image' : 'images'} ` +
+        `did not decode within ${timeout}ms and will be blank in the screenshot:\n  ` +
+        stalled.join('\n  '));
+}
 /**
  * Finishes the `media="print"` async-CSS trick by hand. A stylesheet loaded as
  * print and swapped to `all` on load is not applied while it is still print, so
@@ -113,11 +210,19 @@ export async function expectScreenshot(target, name, options = {}) {
     await page.evaluate(() => document.fonts.ready);
     await waitForAnimations(page, undefined, 3000);
     await loadLazyElements(page);
-    await waitForImagesDecoded(page);
-    // Playwright creates a missing reference itself and has --update-snapshots
-    // for the rest; hand-building the snapshot path got the platform suffix
-    // wrong off Linux.
-    await expect(shot).toHaveScreenshot(`${name}.png`, comparisonOptions(wholePage, screenshotOptions));
+    const stalled = await prepareImagesForCapture(page);
+    if (stalled.length > 0) {
+        warnAboutUndecodedImages(stalled, DECODE_TIMEOUT);
+    }
+    try {
+        // Playwright creates a missing reference itself and has --update-snapshots
+        // for the rest; hand-building the snapshot path got the platform suffix
+        // wrong off Linux.
+        await expect(shot).toHaveScreenshot(`${name}.png`, comparisonOptions(wholePage, screenshotOptions));
+    }
+    finally {
+        await restoreResponsiveImages(page);
+    }
 }
 export function comparisonOptions(wholePage, perCall) {
     return {

package/dist/checks/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/checks/screenshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/checks/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAoB/C,MAAM,aAAa,GAAG;;;;;;EAMpB,CAAA;AAEF,MAAM,UAAU,eAAe,CAAC,SAAmB;IAC/C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAA;IACb,CAAC;IAED,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,qCAAqC,CAAA;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,QAAiB,EAAE,OAAO,GAAG,IAAI;IACjF,MAAM,IAAI,CAAC,QAAQ,CACf,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QACnF,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAA;QAExE,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;YAC1B,MAAM,UAAU,GAAG,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;YAC/D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,OAAO,CAAC,IAAI,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;oBAC9E,cAAc;iBACjB,CAAC,CAAA;YACN,CAAC;QACL,CAAC,CAAA;QAED,6EAA6E;QAC7E,MAAM,UAAU,EAAE,CAAA;QAClB,MAAM,UAAU,EAAE,CAAA;IACtB,CAAC,EACD,EAAE,QAAQ,EAAE,OAAO,EAAE,CACxB,CAAA;AACL,CAAC;AAED,4EAA4E;AAC5E,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU;IAC7C,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CACrB,QAAQ;SACH,gBAAgB,CAAuC,kBAAkB,CAAC;SAC1E,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CACzD,CAAA;AACL,CAAC;AAED,oFAAoF;AACpF,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAU;IACnD,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QACrB,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAA;YACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,OAAM;YACV,CAAC;YAED,KAAK,CAAC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;gBACzC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC;gBAC9B,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC;gBACpC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC;gBAClC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC;gBAClC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC;aACvC,CAAC,CAAA;YACF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;YACtF,0EAA0E;YAC1E,mBAAmB;YACnB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAA;YAC1F,KAAK,MAAM,SAAS,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC1C,MAAM,KAAK,GAAG,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,CAAA;gBAC7C,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;oBAChB,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;gBACxC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACvB,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;gBACtF,8DAA8D;gBAC9D,MAAM,CAAC,KAAK,GAAG,SAAS,CAAA;YAC5B,CAAC,CAAC,CAAA;YAEF,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;YAC/B,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;YAC9B,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACzB,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAA;YACxB,CAAC;QACL,CAAC,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;AACN,CAAC;AAED,iFAAiF;AACjF,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAU;IACpD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAEhC,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAU;IACpD,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QACrB,MAAM,GAAG,GAAG,CAAC,OAAgB,EAAE,IAAY,EAAE,KAAoB,EAAE,EAAE,CACjE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAEtF,QAAQ,CAAC,gBAAgB,CAAmB,0BAA0B,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACtF,KAAK;iBACA,OAAO,CAAC,SAAS,CAAC;gBACnB,EAAE,gBAAgB,CAAoB,6BAA6B,CAAC;iBACnE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAChB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAEhE,CAAA;gBACD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;gBAC3B,OAAO,MAAM,CAAC,OAAO,CAAC,aAAa,CAAA;YACvC,CAAC,CAAC,CAAA;YAEN,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAAkC,CAAA;YAC/F,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;YAC1E,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,CAAA;QACtC,CAAC,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;AACN,CAAC;AAED,MAAM,cAAc,GAAG,KAAK,CAAA;AAE5B,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAU,EAAE,OAAO,GAAG,cAAc;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;IAErC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAClC,gFAAgF;IAChF,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACZ,OAAO,OAAO,CAAA;IAClB,CAAC;IAED,0EAA0E;IAC1E,iFAAiF;IACjF,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,IAAU,EAAE,OAAe;IAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,MAAM,GAAG,CAAC,KAAuB,EAAE,EAAE,CACvC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;gBACtB,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACrB,OAAO,EAAE,CAAA;YACb,CAAC,CAAA;YACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjB,KAAK,MAAM,EAAE,CAAA;gBACb,OAAM;YACV,CAAC;YACD,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACnE,KAAK,CAAC,gBAAgB,CAClB,OAAO,EACP,GAAG,EAAE;gBACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACrB,OAAO,EAAE,CAAA;YACb,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACjB,CAAA;QACL,CAAC,CAAC,CAAA;QACN,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QACnF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAA;QACrE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;QAEzG,mEAAmE;QACnE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC;QACL,CAAC,CAAC,CAAA;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;IACxE,CAAC,EAAE,OAAO,CAAC,CAAA;AACf,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CAAC,OAAiB,EAAE,OAAe;IACvE,OAAO,CAAC,IAAI,CACR,8BAA8B,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG;QACxF,yBAAyB,OAAO,6CAA6C;QAC7E,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAC3B,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,wBAAwB,CAAC,IAAU;IAC9C,MAAM,IAAI,CAAC,QAAQ,CACf,GAAG,EAAE,CACD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC3F,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAkB,qBAAqB,CAAC,CAAC,CAAA;QAC3F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,SAAS,EAAE,CAAA;YACX,OAAM;QACV,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CACrB,CAAC,IAAI,EAAE,EAAE,CACL,IAAI,OAAO,CAAO,CAAC,IAAI,EAAE,EAAE;YACvB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;gBAClB,IAAI,EAAE,CAAA;gBACN,OAAM;YACV,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC5D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACtB,CAAC,CAAC,CACT,CAAA;QAED,mEAAmE;QACnE,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC,CAAC,CACT,CAAA;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACnC,MAAsB,EACtB,OAAgB;IAEhB,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC9D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAA;AAC3D,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,UAAgC,EAAE,OAA6B;IAC3F,OAAO,OAAO,IAAI,UAAU,IAAI,EAAE,CAAA;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAsB,EACtB,IAAY,EACZ,UAA6B,EAAE;IAE/B,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;IACjC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,CAAA;IACvD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpE,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAEtD,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAA;IAElD,MAAM,UAAU,GAAG,eAAe,CAAC,eAAe,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC,CAAA;IACtF,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;IAC9C,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAA;IACnD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,wBAAwB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IACrD,CAAC;IAED,IAAI,CAAC;QACD,2EAA2E;QAC3E,wEAAwE;QACxE,mBAAmB;QACnB,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,GAAG,IAAI,MAAM,EAAE,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAA;IACvG,CAAC;YAAS,CAAC;QACP,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,SAAkB,EAClB,OAAoC;IAEpC,OAAO;QACH,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE,KAAK;QACd,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,GAAG,OAAO;KACb,CAAA;AACL,CAAC"}

package/dist/clean/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/clean/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/clean/cli.ts"],"names":[],"mappings":""}

package/dist/clean/cli.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import * as path from 'path';
+import { sweepOrphans } from '../global-teardown.js';
+import { httpCleanup } from '../http/cleanup-client.js';
+import { findStateDir, recordedTestingUrl } from '../inspect/links.js';
+import { OWNER_ACTIVE_MS } from '../state/run-namespace.js';
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log('Usage: typo3-playwright-clean');
+    console.log('Drops the test databases and run state a stopped run left behind.');
+    process.exit(0);
+}
+const stateDir = findStateDir(process.cwd());
+if (undefined === stateDir) {
+    console.log('Nothing to clean: no .test-state directory here.');
+    process.exit(0);
+}
+const testingURL = recordedTestingUrl(stateDir);
+if (undefined === testingURL) {
+    console.log('Nothing to clean: no run recorded a testing URL.');
+    process.exit(0);
+}
+const consumerRoot = path.dirname(stateDir);
+const config = {
+    testingURL,
+    paths: { consumerRoot, stateDir, sessionDir: path.join(consumerRoot, 'var/session') },
+    // The window prepareRun uses to decide another process owns a run, so a run
+    // younger than it keeps its databases and state.
+    cleanup: { orphanAgeMs: OWNER_ACTIVE_MS },
+};
+const reclaimed = await sweepOrphans(config, httpCleanup(config));
+console.log(`Dropped ${reclaimed} test database${1 === reclaimed ? '' : 's'}.`);
+//# sourceMappingURL=cli.js.map

package/dist/clean/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/clean/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAA;IAC5C,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAA;IAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AAC5C,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAA;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;AAC/C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAA;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAC3C,MAAM,MAAM,GAAkB;IAC1B,UAAU;IACV,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,EAAE;IACrF,4EAA4E;IAC5E,iDAAiD;IACjD,OAAO,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE;CAC5C,CAAA;AAED,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;AAEjE,OAAO,CAAC,GAAG,CAAC,WAAW,SAAS,iBAAiB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA"}

package/dist/doctor/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/doctor/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/doctor/cli.ts"],"names":[],"mappings":""}

package/dist/doctor/cli.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { mkdtempSync, rmSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { parseArgs } from 'node:util';
+try {
+    const { values } = parseArgs({ options: {
+            help: { type: 'boolean', short: 'h' },
+            config: { type: 'string', short: 'c' },
+            project: { type: 'string', multiple: true },
+        } });
+    if (values.help) {
+        console.log('Usage: typo3-playwright-doctor [--project name] [--config file]');
+        console.log('Checks browsers and TYPO3 without running tests, builds, or repairs.');
+    }
+    else {
+        const require = createRequire(import.meta.url);
+        // Playwright 1.44 writes .last-run.json even in list mode, into an output
+        // directory it creates first, so the project's own test-results survives
+        // only if that directory is a throwaway.
+        const outputDir = mkdtempSync(join(tmpdir(), 'typo3-playwright-doctor-'));
+        process.on('exit', () => rmSync(outputDir, { recursive: true, force: true }));
+        const args = ['test', '--list', '--pass-with-no-tests', '--output', outputDir,
+            '--reporter', fileURLToPath(new URL('./reporter.js', import.meta.url))];
+        if (values.config)
+            args.push('--config', values.config);
+        for (const project of values.project ?? [])
+            args.push('--project', project);
+        const playwrightCli = require.resolve('@playwright/test/cli');
+        process.env.PW_DOCTOR_PROJECTS = JSON.stringify(values.project ?? []);
+        process.argv = [process.execPath, playwrightCli, ...args];
+        await import(pathToFileURL(playwrightCli).href);
+    }
+}
+catch (error) {
+    console.error(`✗ ${error.message}`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/doctor/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/doctor/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,IAAI,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE;YACpC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACtC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC9C,EAAE,CAAC,CAAA;IACJ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAA;QAC9E,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAA;IACvF,CAAC;SAAM,CAAC;QACJ,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE9C,0EAA0E;QAC1E,yEAAyE;QACzE,yCAAyC;QACzC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAA;QACzE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAE7E,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,SAAS;YACzE,YAAY,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC3E,IAAI,MAAM,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACvD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QAC3E,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;QAC7D,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACrE,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,CAAA;QACzD,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAA;IACnD,CAAC;AACL,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;IAC9C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACxB,CAAC"}

package/dist/doctor/reporter.d.ts

@@ -0,0 +1,22 @@
+import type { FullConfig, FullResult, Reporter, TestError } from '@playwright/test/reporter';
+export default class DoctorReporter implements Reporter {
+    private config?;
+    private failed;
+    printsToStdio(): boolean;
+    onBegin(config: FullConfig): void;
+    onError(error: TestError): void;
+    onEnd(result: FullResult): Promise<{
+        status: FullResult['status'];
+    }>;
+    /**
+     * A reporter's config lists every project whatever --project selected, and the
+     * run's suites hold only projects that already have a test file. So the
+     * selection is applied here, with Playwright's wildcard and case rules.
+     */
+    private selectedProjects;
+    private checkBrowser;
+    private checkApi;
+    private fail;
+    private skip;
+}
+//# sourceMappingURL=reporter.d.ts.map

package/dist/doctor/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/doctor/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAe,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAWzG,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,QAAQ;IACnD,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,MAAM,CAAI;IAElB,aAAa,IAAI,OAAO;IAIxB,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIjC,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIzB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC;IAyB1E;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;YAWV,YAAY;YA8BZ,QAAQ;IA+FtB,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,IAAI;CAGf"}

package/dist/doctor/reporter.js

@@ -0,0 +1,224 @@
+import { chromium, firefox, webkit } from '@playwright/test';
+import { getToolkitConfig } from '../config.js';
+import { generateTestId, TEST_ID_HEADER } from '../contract.js';
+import { resolveApiSecret, SECRET_HEADER } from '../http/api-secret.js';
+import { httpCleanup } from '../http/cleanup-client.js';
+import { isTestingContext, MINIMUM_API_VERSION, readHealth } from '../global-setup.js';
+const BROWSERS = { chromium, firefox, webkit };
+const BROWSER_TIMEOUT_MS = 10000;
+export default class DoctorReporter {
+    config;
+    failed = 0;
+    printsToStdio() {
+        return true;
+    }
+    onBegin(config) {
+        this.config = config;
+    }
+    onError(error) {
+        console.error(`✗ Playwright config: ${error.message ?? error.value}`);
+    }
+    async onEnd(result) {
+        if (!this.config || result.status !== 'passed') {
+            return { status: 'failed' };
+        }
+        console.log(`✓ Playwright config loaded: ${this.config.configFile}`);
+        let toolkit;
+        try {
+            toolkit = getToolkitConfig();
+        }
+        catch (error) {
+            this.fail('Toolkit configuration', error.message);
+            return { status: 'failed' };
+        }
+        for (const project of this.selectedProjects(this.config)) {
+            await this.checkBrowser(project, toolkit);
+        }
+        await this.checkApi(toolkit);
+        console.log(this.failed ? `Not ready: ${this.failed} check(s) failed.` : 'Ready to run tests.');
+        return { status: this.failed ? 'failed' : 'passed' };
+    }
+    /**
+     * A reporter's config lists every project whatever --project selected, and the
+     * run's suites hold only projects that already have a test file. So the
+     * selection is applied here, with Playwright's wildcard and case rules.
+     */
+    selectedProjects(config) {
+        const names = JSON.parse(process.env.PW_DOCTOR_PROJECTS ?? '[]');
+        if (!names.length) {
+            return config.projects;
+        }
+        const patterns = names.map((name) => new RegExp(`^${name.split('*')
+            .map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('.*')}$`, 'i'));
+        return config.projects.filter((project) => patterns.some((pattern) => pattern.test(project.name)));
+    }
+    async checkBrowser(project, toolkit) {
+        const browserName = project.use.browserName ?? 'chromium';
+        const label = project.name || browserName;
+        const connect = connectOptions(project);
+        let browser;
+        try {
+            const launch = { ...project.use.launchOptions };
+            if (project.use.headless !== undefined)
+                launch.headless = project.use.headless;
+            if (project.use.channel !== undefined)
+                launch.channel = project.use.channel;
+            browser = connect
+                ? await BROWSERS[browserName].connect(connect.wsEndpoint, { timeout: BROWSER_TIMEOUT_MS, ...connect })
+                : await BROWSERS[browserName].launch({ timeout: BROWSER_TIMEOUT_MS, ...launch });
+        }
+        catch (error) {
+            this.fail(`Browser [${label}]`, error.message);
+            return;
+        }
+        console.log(`✓ Browser [${label}] ${connect ? 'connected' : 'launched'}`);
+        try {
+            const page = await browser.newPage(pageOptions(project));
+            await page.goto(toolkit.testingURL, { timeout: BROWSER_TIMEOUT_MS, waitUntil: 'domcontentloaded' });
+            console.log(`✓ Browser access [${label}]: testing URL reachable`);
+        }
+        catch (error) {
+            this.fail(`Browser access [${label}]`, error.message);
+        }
+        finally {
+            await browser.close();
+        }
+    }
+    async checkApi(config) {
+        let secret;
+        try {
+            secret = resolveApiSecret(config);
+        }
+        catch (error) {
+            this.fail('API secret', error.message);
+            this.skip('API authentication', 'API compatibility', 'Database and session checks');
+            return;
+        }
+        const url = `${config.testingURL}/typo3/test-api/health`;
+        const headers = { [SECRET_HEADER]: secret };
+        let preflight;
+        try {
+            preflight = await readHealth(url, headers, fetch, (reason) => `Unreachable: ${reason}. Check the testing hostname and web server.`);
+        }
+        catch (error) {
+            this.fail('Testing URL', error.message);
+            this.skip('API authentication', 'API compatibility', 'Database and session checks');
+            return;
+        }
+        console.log(`✓ Testing URL reachable: ${config.testingURL}`);
+        if (preflight.status === 401 || preflight.status === 403) {
+            this.fail('API secret', 'Request refused. Check PLAYWRIGHT_TOOLKIT_SECRET or run ddev playwright prepare.');
+            this.skip('API compatibility', 'Database and session checks');
+            return;
+        }
+        if (!answered(preflight.status)) {
+            this.fail('Test API', `HTTP ${preflight.status}. Check the Testing site's PHP and web-server logs.`);
+            this.skip('API compatibility', 'Database and session checks');
+            return;
+        }
+        console.log('✓ API secret accepted');
+        if (typeof preflight.body?.api !== 'number' || !Number.isInteger(preflight.body.api) || preflight.body.api < MINIMUM_API_VERSION) {
+            this.fail('Toolkit API version', 'Run composer update plan2net/playwright-toolkit.');
+            this.skip('Database and session checks');
+            return;
+        }
+        console.log('✓ Toolkit API versions compatible');
+        if (!confirmsTestingContext(preflight.body.checks?.context)) {
+            this.fail('Testing context', 'Point testingURL at the hostname configured with TYPO3_CONTEXT=Testing.');
+            this.skip('Database and session checks');
+            return;
+        }
+        const testId = generateTestId();
+        try {
+            const health = await readHealth(url, { ...headers, [TEST_ID_HEADER]: testId }, fetch, (reason) => `Diagnostic request failed: ${reason}`);
+            if (!answered(health.status)) {
+                this.fail('Test API', `HTTP ${health.status}. Check the Testing site's PHP and web-server logs.`);
+                this.skip('Database and session checks');
+                return;
+            }
+            if (!confirmsTestingContext(health.body?.checks?.context)) {
+                this.fail('Testing context', 'The diagnostic response did not confirm a Testing context.');
+                this.skip('Database and session checks');
+                return;
+            }
+            const failuresBefore = this.failed;
+            for (const [name, label, remedy] of [
+                ['database', 'Test database created from template', 'Run ddev playwright prepare --force.'],
+                ['session', 'Backend session usable', 'Run ddev playwright prepare --force.'],
+                ['media', 'Media fixtures seeded', 'Check mediaPath and mediaStorage, then run ddev playwright prepare.'],
+            ]) {
+                const check = health.body.checks?.[name];
+                if (check?.ok === true) {
+                    console.log(`✓ ${label}`);
+                }
+                else {
+                    this.fail(label, `${check?.detail ?? 'No check result returned'}. ${remedy}`);
+                    if (name === 'database')
+                        this.skip('Backend session check');
+                    break;
+                }
+            }
+            if (this.failed === failuresBefore && (!health.ok || health.body.ok !== true)) {
+                this.fail('Test API', 'The health response reports failure without a failed check. Check the PHP logs.');
+            }
+        }
+        catch (error) {
+            this.fail('Test database', error.message);
+        }
+        finally {
+            const [cleanup] = await httpCleanup(config).drop([testId]);
+            if (cleanup?.outcome === 'dropped' || cleanup?.outcome === 'absent') {
+                console.log('✓ Diagnostic database removed');
+            }
+            else {
+                this.fail('Diagnostic database cleanup', `db${testId}: ${cleanup?.outcome ?? 'no result'}`);
+            }
+        }
+    }
+    fail(check, detail) {
+        console.error(`✗ ${check}: ${detail}`);
+        this.failed++;
+    }
+    skip(...checks) {
+        for (const check of checks)
+            console.log(`– ${check} skipped`);
+    }
+}
+/** Playwright's own environment override wins, the way it does for a test run. */
+function connectOptions(project) {
+    if (!process.env.PW_TEST_CONNECT_WS_ENDPOINT) {
+        return project.use.connectOptions;
+    }
+    return {
+        wsEndpoint: process.env.PW_TEST_CONNECT_WS_ENDPOINT,
+        headers: process.env.PW_TEST_CONNECT_HEADERS
+            ? JSON.parse(process.env.PW_TEST_CONNECT_HEADERS)
+            : undefined,
+        exposeNetwork: process.env.PW_TEST_CONNECT_EXPOSE_NETWORK,
+    };
+}
+/** A toolkit header a consumer configured context-wide must not ride along on a browser request. */
+function pageOptions(project) {
+    const options = { ...project.use.contextOptions };
+    options.extraHTTPHeaders = { ...(project.use.extraHTTPHeaders ?? options.extraHTTPHeaders) };
+    for (const header of Object.keys(options.extraHTTPHeaders)) {
+        if ([SECRET_HEADER.toLowerCase(), TEST_ID_HEADER.toLowerCase()].includes(header.toLowerCase())) {
+            delete options.extraHTTPHeaders[header];
+        }
+    }
+    if (project.use.ignoreHTTPSErrors !== undefined)
+        options.ignoreHTTPSErrors = project.use.ignoreHTTPSErrors;
+    if (project.use.httpCredentials !== undefined)
+        options.httpCredentials = project.use.httpCredentials;
+    if (project.use.proxy !== undefined)
+        options.proxy = project.use.proxy;
+    return options;
+}
+/** 200 is healthy and 503 is a reported check failure; anything else is the site breaking. */
+function answered(status) {
+    return status === 200 || status === 503;
+}
+function confirmsTestingContext(check) {
+    return check?.ok === true && isTestingContext(check.detail);
+}
+//# sourceMappingURL=reporter.js.map

package/dist/doctor/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/doctor/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAA4C,MAAM,kBAAkB,CAAA;AAEtG,OAAO,EAAE,gBAAgB,EAAsB,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEtF,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AAE9C,MAAM,kBAAkB,GAAG,KAAK,CAAA;AAEhC,MAAM,CAAC,OAAO,OAAO,cAAc;IACvB,MAAM,CAAa;IACnB,MAAM,GAAG,CAAC,CAAA;IAElB,aAAa;QACT,OAAO,IAAI,CAAA;IACf,CAAC;IAED,OAAO,CAAC,MAAkB;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC;IAED,OAAO,CAAC,KAAgB;QACpB,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAkB;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;QAC/B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;QAEpE,IAAI,OAAsB,CAAA;QAC1B,IAAI,CAAC;YACD,OAAO,GAAG,gBAAgB,EAAE,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAG,KAAe,CAAC,OAAO,CAAC,CAAA;YAE5D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;QAC/B,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC7C,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAE5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAA;QAE/F,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACxD,CAAC;IAED;;;;OAIG;IACK,gBAAgB,CAAC,MAAkB;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAa,CAAA;QAC5E,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,MAAM,CAAC,QAAQ,CAAA;QAC1B,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;aAC9D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QAEpF,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACtG,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,OAAoB,EAAE,OAAsB;QACnE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,UAAU,CAAA;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAA;QACzC,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,OAAgB,CAAA;QACpB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAA;YAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;gBAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAA;YAC9E,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;YAC3E,OAAO,GAAG,OAAO;gBACb,CAAC,CAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE,CAAC;gBACtG,CAAC,CAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAA;YAEzD,OAAM;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;QAEzE,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;YACxD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAA;YACnG,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,0BAA0B,CAAC,CAAA;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,mBAAmB,KAAK,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAA;QACpE,CAAC;gBAAS,CAAC;YACP,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACzB,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,MAAqB;QACxC,IAAI,MAAc,CAAA;QAClB,IAAI,CAAC;YACD,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,YAAY,EAAG,KAAe,CAAC,OAAO,CAAC,CAAA;YACjD,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,6BAA6B,CAAC,CAAA;YAEnF,OAAM;QACV,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,UAAU,wBAAwB,CAAA;QACxD,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;QAC3C,IAAI,SAAiD,CAAA;QACrD,IAAI,CAAC;YACD,SAAS,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,MAAM,8CAA8C,CAAC,CAAA;QACvI,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,aAAa,EAAG,KAAe,CAAC,OAAO,CAAC,CAAA;YAClD,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,6BAA6B,CAAC,CAAA;YAEnF,OAAM;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;QAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,kFAAkF,CAAC,CAAA;YAC3G,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,6BAA6B,CAAC,CAAA;YAE7D,OAAM;QACV,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,SAAS,CAAC,MAAM,qDAAqD,CAAC,CAAA;YACpG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,6BAA6B,CAAC,CAAA;YAE7D,OAAM;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QACpC,IAAI,OAAO,SAAS,CAAC,IAAI,EAAE,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,mBAAmB,EAAE,CAAC;YAC/H,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,kDAAkD,CAAC,CAAA;YACpF,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;YAExC,OAAM;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAA;QAChD,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,yEAAyE,CAAC,CAAA;YACvG,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;YAExC,OAAM;QACV,CAAC;QAED,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAChF,CAAC,MAAM,EAAE,EAAE,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAA;YACvD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,MAAM,CAAC,MAAM,qDAAqD,CAAC,CAAA;gBACjG,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;gBAExC,OAAM;YACV,CAAC;YACD,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,4DAA4D,CAAC,CAAA;gBAC1F,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;gBAExC,OAAM;YACV,CAAC;YACD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAA;YAClC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI;gBAChC,CAAC,UAAU,EAAE,qCAAqC,EAAE,sCAAsC,CAAC;gBAC3F,CAAC,SAAS,EAAE,wBAAwB,EAAE,sCAAsC,CAAC;gBAC7E,CAAC,OAAO,EAAE,uBAAuB,EAAE,qEAAqE,CAAC;aAC5G,EAAE,CAAC;gBACA,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;gBACxC,IAAI,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;gBAC7B,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,MAAM,IAAI,0BAA0B,KAAK,MAAM,EAAE,CAAC,CAAA;oBAC7E,IAAI,IAAI,KAAK,UAAU;wBAAE,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;oBAC3D,MAAK;gBACT,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC5E,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iFAAiF,CAAC,CAAA;YAC5G,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,eAAe,EAAG,KAAe,CAAC,OAAO,CAAC,CAAA;QACxD,CAAC;gBAAS,CAAC;YACP,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;YAC1D,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAClE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAA;YAChD,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,IAAI,CAAC,6BAA6B,EAAE,KAAK,MAAM,KAAK,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,CAAC,CAAA;YAC/F,CAAC;QACL,CAAC;IACL,CAAC;IAEO,IAAI,CAAC,KAAa,EAAE,MAAc;QACtC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,MAAM,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC,MAAM,EAAE,CAAA;IACjB,CAAC;IAEO,IAAI,CAAC,GAAG,MAAgB;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,UAAU,CAAC,CAAA;IACjE,CAAC;CACJ;AAED,kFAAkF;AAClF,SAAS,cAAc,CAAC,OAAoB;IACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IACrC,CAAC;IAED,OAAO;QACH,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B;QACnD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB;YACxC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAA2B;YAC3E,CAAC,CAAC,SAAS;QACf,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B;KAC5D,CAAA;AACL,CAAC;AAED,oGAAoG;AACpG,SAAS,WAAW,CAAC,OAAoB;IACrC,MAAM,OAAO,GAA0B,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAA;IACxE,OAAO,CAAC,gBAAgB,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAA;IAC5F,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC7F,OAAO,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC3C,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,SAAS;QAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAA;IAC1G,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAA;IACpG,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAA;IAEtE,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,8FAA8F;AAC9F,SAAS,QAAQ,CAAC,MAAc;IAC5B,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAA;AAC3C,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAkD;IAC9E,OAAO,KAAK,EAAE,EAAE,KAAK,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC/D,CAAC"}

package/dist/global-setup.d.ts

@@ -2,6 +2,23 @@ import { type ToolkitConfig } from './config.js';
 export declare function preflightTestId(config: ToolkitConfig): string;
 /** The oldest extension this toolkit can talk to. */
 export declare const MINIMUM_API_VERSION = 1;
+interface HealthResponse {
+    status: number;
+    ok: boolean;
+    body: {
+        ok?: boolean;
+        api?: unknown;
+        checks?: Record<string, {
+            ok: boolean;
+            detail: string;
+        }>;
+    };
+}
+/**
+ * The body is read whatever the status: an unhealthy site still reports its
+ * version, and "too old" is a different problem from "unhealthy".
+ */
+export declare function readHealth(healthUrl: string, headers: Record<string, string>, doFetch: typeof fetch, unreachable: (reason: string) => string): Promise<HealthResponse>;
 /**
  * Sends no test ID, and runs before any test ID exists. A request with one makes
  * the extension create a database, and an extension this old has no endpoint to
@@ -10,6 +27,7 @@ export declare const MINIMUM_API_VERSION = 1;
 export declare function verifyApiVersion(config: ToolkitConfig, options?: {
     fetchImpl?: typeof fetch;
 }): Promise<number>;
+export declare function isTestingContext(reported: string): boolean;
 export declare function runHealthCheck(testingURL: string, options?: {
     testId?: string;
     secret?: string;

package/dist/global-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAOlE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK7D;AAED,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,IAAI,CAAA;AA4DpC;;;;GAIG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC3C,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAiBD,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC7E,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,iBAAe,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB1C;AAED,eAAe,WAAW,CAAA"}
+{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAOlE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK7D;AAED,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,UAAU,cAAc;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAA;CAClG;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,EAAE,OAAO,KAAK,EACrB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GACxC,OAAO,CAAC,cAAc,CAAC,CA2BzB;AAgBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC3C,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAiBD,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC7E,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,iBAAe,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB1C;AAED,eAAe,WAAW,CAAA"}

package/dist/global-setup.js

@@ -15,7 +15,7 @@ export const MINIMUM_API_VERSION = 1;
  * The body is read whatever the status: an unhealthy site still reports its
  * version, and "too old" is a different problem from "unhealthy".
  */
-async function readHealth(healthUrl, headers, doFetch, unreachable) {
+export async function readHealth(healthUrl, headers, doFetch, unreachable) {
     let response;
     try {
         response = await doFetch(healthUrl, {
@@ -69,7 +69,7 @@ export async function verifyApiVersion(config, options = {}) {
             'The toolkit secret does not match the one the extension expects.',
             '',
             'Under DDEV both sides read var/playwright/api-secret, which',
-            '`ddev playwright-prepare` writes. Run it, or set PLAYWRIGHT_TOOLKIT_SECRET',
+            '`ddev playwright prepare` writes. Run it, or set PLAYWRIGHT_TOOLKIT_SECRET',
             'to the same value on both sides when PHP and Node run in separate containers.',
         ].join('\n'));
     }
@@ -87,9 +87,12 @@ export async function verifyApiVersion(config, options = {}) {
     }
     return reported;
 }
+export function isTestingContext(reported) {
+    return /^Testing(\/|$)/.test(reported);
+}
 /** Cannot fail while the endpoint itself is gated: here so a moved gate stops the run. */
 function assertTestingContext(healthUrl, reported) {
-    if (undefined === reported || /^Testing(\/|$)/.test(reported)) {
+    if (undefined === reported || isTestingContext(reported)) {
         return;
     }
     throw new Error([