@juangadm/pre-post 0.3.0 → 1.1.0

package/dist/diff.js

@@ -0,0 +1,281 @@
+/**
+ * Pixel diff between two PNG screenshots.
+ *
+ * Pure JS (pixelmatch + pngjs): no native build step, works everywhere the
+ * CLI runs. Produces a change ratio, the bounding box of the change, a
+ * highlight image, and tight crops of before/after around the change.
+ */
+import pixelmatch from 'pixelmatch';
+import { PNG } from 'pngjs';
+import { alignBefore, detectShift, insertedBand } from './shift.js';
+const DIFF_COLOR = [255, 0, 0];
+const AA_COLOR = [255, 200, 0];
+/** Background used to pad images of different sizes. */
+const PAD_COLOR = [255, 255, 255];
+/**
+ * pixelmatch per-pixel colour distance (0..1).
+ *
+ * Calibrated, not chosen. At the old 0.1 a 600x320 card recoloured from #ffffff
+ * to #e6e6e6 — plainly visible, a sixth of the viewport — reported *zero*
+ * changed pixels, and `rung-6-section` measured 1649 CSS px² instead of 67539.
+ * The ladder never caught it because every rung varies painted *area* while the
+ * threshold governs *contrast*, so nothing in the suite moved along that axis.
+ * `contrast-*` is that missing axis.
+ *
+ * Measured across the fixtures, changed CSS px² by threshold:
+ *
+ *              0.1    0.05    0.03    0.02    0.01
+ *   contrast-25  0  191754  191754  191754  191754
+ *   contrast-15  0  191758  191758  191758  191758
+ *   contrast-10  0       0  191758  191758  191758
+ *   contrast-05  0       0       0       0  191762
+ *   rung-6    1649    1649   67539   67539   67539
+ *   noise-*      0       0       0       0       0
+ *
+ * Every no-op stays at zero the whole way down, and so does the strongest
+ * real-world check available: the same page captured from two different
+ * deployments, which reports 0 at every value above, desktop and mobile.
+ *
+ * 0.02 catches every delta a reader would call visible and keeps a margin above
+ * the floor for sites noisier than the ones measured. 0.01 was also clean here;
+ * the margin is deliberate, since the alternative to a marginal false positive
+ * is silently publishing "No visual changes" about a page that changed.
+ */
+const PIXEL_THRESHOLD = 0.02;
+/** No crop when the change covers more than this fraction of the canvas. */
+const CROP_MAX_RATIO = 0.5;
+/**
+ * A shift is only worth reporting when putting the two sides back in register
+ * accounts for most of the difference. This is the whole test: an offset that
+ * does not remove the pixels it claims to explain is not the story.
+ *
+ * Judged over the rows Pre and Post share. Content Post gained is excluded
+ * from both sides of the comparison, because an insertion is the reason for
+ * the move rather than evidence against it: a page pushed down by a banner
+ * would otherwise be refused for the size of the banner.
+ *
+ * Measured on the shift ladder, as a share of the changed pixels over those
+ * shared rows: every true shift leaves 0.23 or less, and the horizontal
+ * reflow — the one case no vertical offset explains — leaves 0.45. This sits
+ * in the empty band between, nearer the real changes so a genuine shift
+ * carrying a larger change still reads as one. Erring low is deliberate:
+ * rejecting a shift falls back to the old behaviour, while claiming one that
+ * isn't there tells a reviewer something untrue.
+ */
+const MAX_ALIGNED_SHARE = 0.3;
+function padTo(src, width, height, bg) {
+    if (src.width === width && src.height === height)
+        return src;
+    const out = new PNG({ width, height });
+    for (let i = 0; i < out.data.length; i += 4) {
+        out.data[i] = bg[0];
+        out.data[i + 1] = bg[1];
+        out.data[i + 2] = bg[2];
+        out.data[i + 3] = 255;
+    }
+    PNG.bitblt(src, out, 0, 0, src.width, src.height, 0, 0);
+    return out;
+}
+function crop(src, region) {
+    const out = new PNG({ width: region.width, height: region.height });
+    PNG.bitblt(src, out, region.x, region.y, region.width, region.height, 0, 0);
+    return encode(out);
+}
+function encode(png) {
+    return PNG.sync.write(png, { deflateLevel: 4, filterType: 4 });
+}
+/** Box-filter downscale by an integer factor. */
+export function downscale(src, factor) {
+    if (factor <= 1)
+        return src;
+    const w = Math.max(1, Math.floor(src.width / factor));
+    const h = Math.max(1, Math.floor(src.height / factor));
+    const out = new PNG({ width: w, height: h });
+    const n = factor * factor;
+    for (let y = 0; y < h; y++) {
+        for (let x = 0; x < w; x++) {
+            let r = 0, g = 0, b = 0, a = 0;
+            for (let dy = 0; dy < factor; dy++) {
+                let i = ((y * factor + dy) * src.width + x * factor) * 4;
+                for (let dx = 0; dx < factor; dx++, i += 4) {
+                    r += src.data[i];
+                    g += src.data[i + 1];
+                    b += src.data[i + 2];
+                    a += src.data[i + 3];
+                }
+            }
+            const o = (y * w + x) * 4;
+            out.data[o] = r / n;
+            out.data[o + 1] = g / n;
+            out.data[o + 2] = b / n;
+            out.data[o + 3] = a / n;
+        }
+    }
+    return out;
+}
+export function decodePng(buffer) {
+    return PNG.sync.read(buffer);
+}
+/** Diff-coloured pixels within a row range, for weighing one band against another. */
+function countChangedRows(diff, y0, y1) {
+    const { width, data } = diff;
+    let count = 0;
+    for (let y = Math.max(0, y0); y < Math.min(diff.height, y1); y++) {
+        const row = y * width * 4;
+        for (let x = 0; x < width; x++) {
+            const i = row + x * 4;
+            if (data[i] === DIFF_COLOR[0] && data[i + 1] === DIFF_COLOR[1] && data[i + 2] === DIFF_COLOR[2])
+                count++;
+        }
+    }
+    return count;
+}
+/** Bounding box of pixels painted with the diff color. */
+function boundingBox(diff) {
+    const { width, height, data } = diff;
+    let minX = width, minY = height, maxX = -1, maxY = -1;
+    for (let y = 0; y < height; y++) {
+        const row = y * width * 4;
+        for (let x = 0; x < width; x++) {
+            const i = row + x * 4;
+            if (data[i] === DIFF_COLOR[0] && data[i + 1] === DIFF_COLOR[1] && data[i + 2] === DIFF_COLOR[2]) {
+                if (x < minX)
+                    minX = x;
+                if (x > maxX)
+                    maxX = x;
+                if (y < minY)
+                    minY = y;
+                if (y > maxY)
+                    maxY = y;
+            }
+        }
+    }
+    if (maxX < 0)
+        return null;
+    return { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 };
+}
+/** Expand a region by padding and to a minimum size, clamped to the canvas. */
+export function expandRegion(region, canvas, padding, min) {
+    let x0 = region.x - padding;
+    let y0 = region.y - padding;
+    let x1 = region.x + region.width + padding;
+    let y1 = region.y + region.height + padding;
+    const grow = (lo, hi, target, limit) => {
+        const size = hi - lo;
+        if (size < target) {
+            const extra = target - size;
+            lo -= Math.floor(extra / 2);
+            hi += Math.ceil(extra / 2);
+        }
+        if (lo < 0) {
+            hi -= lo;
+            lo = 0;
+        }
+        if (hi > limit) {
+            lo -= hi - limit;
+            hi = limit;
+        }
+        return [Math.max(0, lo), Math.min(limit, hi)];
+    };
+    [x0, x1] = grow(x0, x1, Math.min(min.width, canvas.width), canvas.width);
+    [y0, y1] = grow(y0, y1, Math.min(min.height, canvas.height), canvas.height);
+    return { x: x0, y: y0, width: x1 - x0, height: y1 - y0 };
+}
+/**
+ * Compare two PNG buffers. Images of different sizes are padded onto a shared
+ * canvas so a height change shows up as a change rather than an error.
+ */
+export function diffImages(beforePng, afterPng, options = {}) {
+    const bg = PAD_COLOR;
+    const a = decodePng(beforePng);
+    const b = decodePng(afterPng);
+    const width = Math.max(a.width, b.width);
+    const height = Math.max(a.height, b.height);
+    const sizeChanged = a.width !== b.width || a.height !== b.height;
+    const before = padTo(a, width, height, bg);
+    const after = padTo(b, width, height, bg);
+    const diff = new PNG({ width, height });
+    const changedPixels = pixelmatch(before.data, after.data, diff.data, width, height, {
+        threshold: PIXEL_THRESHOLD,
+        includeAA: false,
+        alpha: 0.5,
+        diffColor: DIFF_COLOR,
+        aaColor: AA_COLOR,
+        diffMask: false,
+    });
+    // A vertical shift repaints everything below where it starts, so the raw
+    // bounding box covers most of the page and the crop guards below refuse to
+    // zoom in. Comparing Post put back in register with Pre isolates the change
+    // the branch actually made, which is small enough to crop and to describe.
+    let shift;
+    let alignedBefore;
+    let alignedDiff;
+    if (changedPixels > 0) {
+        const candidate = detectShift(before, after);
+        if (candidate) {
+            const aligned = alignBefore(before, candidate, bg);
+            const diffOfAligned = new PNG({ width, height });
+            const alignedChangedPixels = pixelmatch(aligned.data, after.data, diffOfAligned.data, width, height, {
+                threshold: PIXEL_THRESHOLD,
+                includeAA: false,
+                alpha: 0.5,
+                diffColor: DIFF_COLOR,
+                aaColor: AA_COLOR,
+                diffMask: false,
+            });
+            // Weigh the offset only on rows both sides have. Whatever Post put in
+            // the gap is new content, and it still counts as a change -- it just
+            // does not get a vote on whether the move happened.
+            const gap = insertedBand(candidate);
+            const insertedChanged = gap ? countChangedRows(diffOfAligned, gap.y, gap.y + gap.height) : 0;
+            const rawInGap = gap ? countChangedRows(diff, gap.y, gap.y + gap.height) : 0;
+            const mappedChanged = alignedChangedPixels - insertedChanged;
+            const rawMapped = changedPixels - rawInGap;
+            if (mappedChanged <= rawMapped * MAX_ALIGNED_SHARE) {
+                shift = {
+                    dy: candidate.dy,
+                    from: candidate.from,
+                    alignedChangedPixels,
+                    alignedChangedRatio: alignedChangedPixels / (width * height),
+                };
+                alignedBefore = aligned;
+                alignedDiff = diffOfAligned;
+            }
+        }
+    }
+    const region = changedPixels > 0 ? boundingBox(diff) : null;
+    const result = {
+        changedRatio: changedPixels / (width * height),
+        changedPixels,
+        width,
+        height,
+        region,
+        sizeChanged,
+        // Identical pages need no highlight; skip the downscale + deflate.
+        highlight: region && options.highlight !== false
+            ? encode(downscale(diff, options.highlightDownscale ?? 1))
+            : undefined,
+        shift,
+    };
+    // With a shift, crop what is left once the move is undone; without one, crop
+    // the change itself. A pure shift leaves nothing over and gets no crop: the
+    // sentence is the report, and the full pages are already published.
+    const cropFrom = alignedBefore ?? before;
+    const cropRegion = alignedDiff ? boundingBox(alignedDiff) : region;
+    if (cropRegion) {
+        const area = cropRegion.width * cropRegion.height;
+        if (area / (width * height) <= CROP_MAX_RATIO) {
+            const expanded = expandRegion(cropRegion, { width, height }, options.padding ?? 80, options.minCrop ?? { width: 800, height: 400 });
+            // Only crop when it meaningfully zooms in.
+            if (expanded.width * expanded.height < width * height * 0.8) {
+                result.crop = {
+                    before: crop(cropFrom, expanded),
+                    after: crop(after, expanded),
+                    region: expanded,
+                };
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"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"}

package/dist/doctor.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Preflight: browser present, GitHub auth, dev server, target reachability.
+ * Fixes what it can (installs the headless shell) and otherwise stops with
+ * exactly one sentence telling the human what to do.
+ */
+import { HttpStatusError } from './errors.js';
+export { NeedsHumanError } from './errors.js';
+/**
+ * Launch (and install if needed) the shared headless browser. The instance
+ * stays open for the captures that follow, so this is the launch, not a probe.
+ */
+export declare function ensureBrowser(): Promise<void>;
+/** Headed browser for `pre-post login`; caller owns and closes it. */
+export declare function launchHeadedBrowser(): Promise<import("playwright-core").Browser>;
+/**
+ * Is this a dev server, or just something listening?
+ *
+ * A reachable socket used to be enough, and it is not: on macOS, AirPlay
+ * Receiver holds port 5000 and answers every request 403 with no body. The
+ * probe adopted it, the 403 was read as access control, and the run advised
+ * signing in to a system service — in place of "no dev server is running",
+ * which is the one thing that was true. It bit precisely when nothing else was
+ * listening, the case the message exists to describe.
+ *
+ * So the bar is a plausible *app* response, not a reachable port:
+ *
+ * - 401/403 never qualifies. That is a wall or a stranger; either way there is
+ *   no site behind it to capture, and inferring a dev server from one is how
+ *   the above happened.
+ * - A redirect does. Locale prefixes and trailing slashes make it ordinary, and
+ *   there is no body to inspect, so the status is all there is to go on. If it
+ *   leads somewhere sign-in shaped, `landing.ts` catches that at capture time
+ *   with a message about the wall rather than about ports.
+ * - Anything else has to have served an HTML document. This deliberately keeps
+ *   a 404 or a 500 that renders a page: a dev server with no `/` route, or one
+ *   with a compile error, is still the dev server, and refusing it would send
+ *   someone hunting for a server they are already running.
+ */
+export declare function looksLikeDevServer(result: ProbeResult): boolean;
+export interface DevServerScan {
+    /** Base URL of the dev server, or null when none of the ports had one. */
+    url: string | null;
+    /** Ports that answered but are not serving a site — worth naming, not using. */
+    ignored: Array<{
+        port: number;
+        status: number;
+    }>;
+}
+/**
+ * Probe the usual ports and say what was found *and* what was passed over.
+ *
+ * `doctor` reports the ignored ports because "nothing on the usual ports" is
+ * confusing when something is plainly listening on one of them.
+ */
+export declare function scanDevServers(ports?: number[]): Promise<DevServerScan>;
+/** Find a running local dev server. Returns its base URL or null. */
+export declare function detectDevServer(ports?: number[]): Promise<string | null>;
+export interface ProbeResult {
+    /** HTTP status, or null when the host could not be reached at all */
+    status: number | null;
+    vercel: boolean;
+    /** Response Content-Type, lowercased and without parameters. */
+    contentType?: string;
+}
+/**
+ * Probe a base URL with the headers we will use for capture.
+ */
+export declare function probeUrl(url: string, headers?: Record<string, string>, options?: {
+    timeoutMs?: number;
+    redirect?: RequestRedirect;
+}): Promise<ProbeResult>;
+/**
+ * Explain a 401/403 in one actionable sentence. Accepts a probe result or the typed capture error.
+ */
+export declare function authHint(target: HttpStatusError | {
+    url: string;
+    vercel: boolean;
+}): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAwB,eAAe,EAAqC,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAe9C;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAED,sEAAsE;AACtE,wBAAsB,mBAAmB,+CAMxC;AAoBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAM/D;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,gFAAgF;IAChF,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,KAAK,GAAE,MAAM,EAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAWxF;AAED,qEAAqE;AACrE,wBAAsB,eAAe,CAAC,KAAK,GAAE,MAAM,EAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEzF;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAO,GAC/D,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAO3F"}

package/dist/doctor.js

@@ -0,0 +1,138 @@
+/**
+ * Preflight: browser present, GitHub auth, dev server, target reachability.
+ * Fixes what it can (installs the headless shell) and otherwise stops with
+ * exactly one sentence telling the human what to do.
+ */
+import { getBrowser, launchBrowserOrInstall } from './browser.js';
+import { hostOf } from './url.js';
+import { BrowserNotFoundError, NeedsHumanError, isVercelResponse } from './errors.js';
+export { NeedsHumanError } from './errors.js';
+const INSTALL_HINT = 'Run: npx playwright-core install chromium-headless-shell   (or set PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH), then re-run.';
+function explainBrowserFailure(err) {
+    if (err instanceof BrowserNotFoundError) {
+        throw new NeedsHumanError(err.installed
+            ? `Chromium was installed but cannot launch. ${INSTALL_HINT}`
+            : `Chromium could not be installed automatically. ${INSTALL_HINT}`);
+    }
+    throw err;
+}
+/**
+ * Launch (and install if needed) the shared headless browser. The instance
+ * stays open for the captures that follow, so this is the launch, not a probe.
+ */
+export async function ensureBrowser() {
+    try {
+        await getBrowser();
+    }
+    catch (err) {
+        explainBrowserFailure(err);
+    }
+}
+/** Headed browser for `pre-post login`; caller owns and closes it. */
+export async function launchHeadedBrowser() {
+    try {
+        return await launchBrowserOrInstall({ headless: false });
+    }
+    catch (err) {
+        explainBrowserFailure(err);
+    }
+}
+/**
+ * Ports worth asking, most likely first: the winner is the earliest that
+ * answers, so order is only ever a tie-break between two live servers.
+ *
+ * Order is not what keeps AirPlay out — `looksLikeDevServer` is, on every
+ * platform and at any position. 5000 sits last because on macOS it usually
+ * belongs to AirPlay Receiver rather than to a dev server, so it is the
+ * weakest guess in the list, not because being last protects anything. 7000,
+ * its sibling, is left out entirely: no framework defaults to it, so it has
+ * nothing to weigh against the noise.
+ */
+const DEV_PORTS = [3000, 3001, 3002, 5173, 5174, 4173, 4321, 8080, 8000, 4200, 5000];
+/** An HTML document. `probeUrl` has already lowercased and dropped parameters. */
+function isHtml(contentType) {
+    return contentType === 'text/html' || contentType === 'application/xhtml+xml';
+}
+/**
+ * Is this a dev server, or just something listening?
+ *
+ * A reachable socket used to be enough, and it is not: on macOS, AirPlay
+ * Receiver holds port 5000 and answers every request 403 with no body. The
+ * probe adopted it, the 403 was read as access control, and the run advised
+ * signing in to a system service — in place of "no dev server is running",
+ * which is the one thing that was true. It bit precisely when nothing else was
+ * listening, the case the message exists to describe.
+ *
+ * So the bar is a plausible *app* response, not a reachable port:
+ *
+ * - 401/403 never qualifies. That is a wall or a stranger; either way there is
+ *   no site behind it to capture, and inferring a dev server from one is how
+ *   the above happened.
+ * - A redirect does. Locale prefixes and trailing slashes make it ordinary, and
+ *   there is no body to inspect, so the status is all there is to go on. If it
+ *   leads somewhere sign-in shaped, `landing.ts` catches that at capture time
+ *   with a message about the wall rather than about ports.
+ * - Anything else has to have served an HTML document. This deliberately keeps
+ *   a 404 or a 500 that renders a page: a dev server with no `/` route, or one
+ *   with a compile error, is still the dev server, and refusing it would send
+ *   someone hunting for a server they are already running.
+ */
+export function looksLikeDevServer(result) {
+    const { status, contentType } = result;
+    if (status === null)
+        return false;
+    if (status === 401 || status === 403)
+        return false;
+    if (status >= 300 && status < 400)
+        return true;
+    return isHtml(contentType);
+}
+/**
+ * Probe the usual ports and say what was found *and* what was passed over.
+ *
+ * `doctor` reports the ignored ports because "nothing on the usual ports" is
+ * confusing when something is plainly listening on one of them.
+ */
+export async function scanDevServers(ports = DEV_PORTS) {
+    const results = await Promise.all(ports.map(async (port) => ({
+        port,
+        ...(await probeUrl(`http://localhost:${port}/`, {}, { timeoutMs: 1500, redirect: 'manual' })),
+    })));
+    const scan = { url: null, ignored: [] };
+    for (const result of results) {
+        if (looksLikeDevServer(result))
+            scan.url ??= `http://localhost:${result.port}`;
+        else if (result.status !== null)
+            scan.ignored.push({ port: result.port, status: result.status });
+    }
+    return scan;
+}
+/** Find a running local dev server. Returns its base URL or null. */
+export async function detectDevServer(ports = DEV_PORTS) {
+    return (await scanDevServers(ports)).url;
+}
+/**
+ * Probe a base URL with the headers we will use for capture.
+ */
+export async function probeUrl(url, headers = {}, options = {}) {
+    try {
+        const res = await fetch(url, { method: 'GET', headers, redirect: options.redirect ?? 'follow', signal: AbortSignal.timeout(options.timeoutMs ?? 10_000) });
+        const contentType = res.headers.get('content-type')?.split(';')[0].trim().toLowerCase();
+        return { status: res.status, vercel: isVercelResponse(res.headers), contentType: contentType || undefined };
+    }
+    catch {
+        return { status: null, vercel: false };
+    }
+}
+/**
+ * Explain a 401/403 in one actionable sentence. Accepts a probe result or the typed capture error.
+ */
+export function authHint(target) {
+    const { url, vercel } = target;
+    const host = hostOf(url);
+    if (vercel || host.endsWith('.vercel.app')) {
+        return `${host} is protected by Vercel Deployment Protection. Either set VERCEL_AUTOMATION_BYPASS_SECRET (Project → Settings → Deployment Protection → Protection Bypass for Automation) or run: npx pre-post login ${url}`;
+    }
+    return `${host} requires a login. Run: npx pre-post login ${url}  (opens a browser once, saves the session locally)`;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Typed errors shared across modules. Thrown at the source, mapped once in the CLI.
+ */
+/** A human must do exactly one thing; the message is that one sentence. Exit code 3. */
+export declare class NeedsHumanError extends Error {
+    constructor(message: string);
+}
+/** The main document answered with an HTTP status that means "not for you" (401/403). */
+export declare class HttpStatusError extends Error {
+    readonly status: number;
+    readonly url: string;
+    /** Response looked like it came from Vercel (deployment protection). */
+    readonly vercel: boolean;
+    constructor(status: number, url: string, 
+    /** Response looked like it came from Vercel (deployment protection). */
+    vercel?: boolean);
+}
+export type NavigationFailure = 'refused' | 'timeout' | 'dns' | 'other';
+/** page.goto failed before any document arrived. */
+export declare class NavigationError extends Error {
+    readonly kind: NavigationFailure;
+    readonly url: string;
+    constructor(kind: NavigationFailure, url: string, cause: Error);
+}
+export declare class BrowserNotFoundError extends Error {
+    readonly cause?: (Error | null) | undefined;
+    readonly installed: boolean;
+    constructor(cause?: (Error | null) | undefined, /** true when an install just ran and launch still failed */ installed?: boolean);
+}
+export declare class GitHubError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare const GH_LOGIN_HINT = "Run: gh auth login   (or set GH_TOKEN with repo access), then re-run.";
+export declare function isVercelResponse(headers: {
+    get(name: string): string | null;
+}): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wFAAwF;AACxF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,yFAAyF;AACzF,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,MAAM;IAC3B,wEAAwE;aACxD,MAAM;gBAHN,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;IAC3B,wEAAwE;IACxD,MAAM,UAAQ;CAKjC;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAExE,oDAAoD;AACpD,qBAAa,eAAgB,SAAQ,KAAK;aACZ,IAAI,EAAE,iBAAiB;aAAkB,GAAG,EAAE,MAAM;gBAApD,IAAI,EAAE,iBAAiB,EAAkB,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAI/F;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,KAAK,CAAC,GAAE,KAAK,GAAG,IAAI;aAA+E,SAAS;gBAA5G,KAAK,CAAC,GAAE,KAAK,GAAG,IAAI,aAAA,EAAE,4DAA4D,CAAiB,SAAS,UAAQ;CAIjJ;AAED,qBAAa,WAAY,SAAQ,KAAK;aACR,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5D;AAED,eAAO,MAAM,aAAa,0EAA0E,CAAC;AAErG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAEvF"}

package/dist/errors.js

@@ -0,0 +1,59 @@
+/**
+ * Typed errors shared across modules. Thrown at the source, mapped once in the CLI.
+ */
+/** A human must do exactly one thing; the message is that one sentence. Exit code 3. */
+export class NeedsHumanError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NeedsHumanError';
+    }
+}
+/** The main document answered with an HTTP status that means "not for you" (401/403). */
+export class HttpStatusError extends Error {
+    status;
+    url;
+    vercel;
+    constructor(status, url, 
+    /** Response looked like it came from Vercel (deployment protection). */
+    vercel = false) {
+        super(`${status} for ${url}`);
+        this.status = status;
+        this.url = url;
+        this.vercel = vercel;
+        this.name = 'HttpStatusError';
+    }
+}
+/** page.goto failed before any document arrived. */
+export class NavigationError extends Error {
+    kind;
+    url;
+    constructor(kind, url, cause) {
+        super(cause.message.split('\n')[0]);
+        this.kind = kind;
+        this.url = url;
+        this.name = 'NavigationError';
+    }
+}
+export class BrowserNotFoundError extends Error {
+    cause;
+    installed;
+    constructor(cause, /** true when an install just ran and launch still failed */ installed = false) {
+        super('No usable Chromium found');
+        this.cause = cause;
+        this.installed = installed;
+        this.name = 'BrowserNotFoundError';
+    }
+}
+export class GitHubError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'GitHubError';
+    }
+}
+export const GH_LOGIN_HINT = 'Run: gh auth login   (or set GH_TOKEN with repo access), then re-run.';
+export function isVercelResponse(headers) {
+    return Boolean(headers.get('x-vercel-id') || headers.get('server')?.toLowerCase().includes('vercel'));
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wFAAwF;AACxF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,yFAAyF;AACzF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEtB;IACA;IAEA;IAJlB,YACkB,MAAc,EACd,GAAW;IAC3B,wEAAwE;IACxD,SAAS,KAAK;QAE9B,KAAK,CAAC,GAAG,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC;QALd,WAAM,GAAN,MAAM,CAAQ;QACd,QAAG,GAAH,GAAG,CAAQ;QAEX,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAID,oDAAoD;AACpD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACZ;IAAyC;IAArE,YAA4B,IAAuB,EAAkB,GAAW,EAAE,KAAY;QAC5F,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QADV,SAAI,GAAJ,IAAI,CAAmB;QAAkB,QAAG,GAAH,GAAG,CAAQ;QAE9E,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACjB;IAAmG;IAA/H,YAA4B,KAAoB,EAAE,4DAA4D,CAAiB,YAAY,KAAK;QAC9I,KAAK,CAAC,0BAA0B,CAAC,CAAC;QADR,UAAK,GAAL,KAAK,CAAe;QAA+E,cAAS,GAAT,SAAS,CAAQ;QAE9I,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACR;IAA5B,YAA4B,MAAc,EAAE,OAAe;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,uEAAuE,CAAC;AAErG,MAAM,UAAU,gBAAgB,CAAC,OAA6C;IAC5E,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxG,CAAC"}