@juangadm/pre-post 1.0.0 → 1.2.0

package/dist/comparison.js

@@ -0,0 +1,241 @@
+/**
+ * Choosing what to compare against what.
+ *
+ * Pre and Post used to be resolved independently, which could pair a production
+ * deployment against a local dev server. Different fonts, different data,
+ * different analytics — a diff full of changes the PR did not make. Nobody
+ * reviews the raw images (the skill forbids it), so a noisy diff is believed.
+ *
+ * So a *pair* is resolved, not two URLs. Each strategy either produces both
+ * sides from the same kind of environment or yields to the next one. Mixing
+ * happens only when the caller asked for it by name, and is reported when it
+ * does.
+ */
+import { deploymentUrlForSha, findPreviewForCommit, latestProductionDeployment } from './deployments.js';
+import { serveBaseCommit, serveWorkingTree } from './baseline.js';
+import { NeedsHumanError } from './doctor.js';
+import { isLocalUrl, normalizeUrl } from './url.js';
+import { mergeBase } from './git.js';
+const noop = async () => undefined;
+const side = (url, detail, probe) => ({ url: normalizeUrl(url), detail, probe });
+/**
+ * The one place a Comparison is built, so `mixed` is derived rather than
+ * recomputed — a construction site that forgot it would report a production
+ * page against a dev server as a clean comparison.
+ */
+const pair = (strategy, before, after, stop = noop) => ({ strategy, before, after, mixed: isLocalUrl(before.url) !== isLocalUrl(after.url), stop });
+/** Reachable and not sitting behind a login wall. */
+function isUsable(result) {
+    return result.status !== null && result.status !== 401 && result.status !== 403;
+}
+/**
+ * The preview deployment for the commit being reviewed, if there is a fresh one.
+ *
+ * Keyed on the commit rather than on the PR: a host builds a branch as soon as
+ * it is pushed, so the preview usually exists before anyone opens the PR. The
+ * PR number is passed when there is one only because the bot-comment fallback
+ * needs somewhere to look.
+ */
+async function previewForHead(ctx) {
+    const { gh, ownerRepo, pr } = ctx;
+    const sha = pr?.head.sha ?? ctx.headSha;
+    if (!gh || !sha)
+        return null;
+    const found = await findPreviewForCommit(gh, ownerRepo, { sha, prNumber: pr?.number, appPrefix: ctx.appPrefix });
+    return found ? side(found.url, `${found.environment} deployment for ${sha.slice(0, 7)}`) : null;
+}
+/**
+ * The deployed baseline, most honest answer first.
+ *
+ * Pinning Pre to the base commit is the right question and it is tried first.
+ * The second step exists because production is a branch, not a commit: a
+ * repository that does not deploy every push to its default branch has no
+ * deployment at the fork point, and requiring one left the deployed comparison
+ * with no Pre — a preview would be found, no baseline would be, and the run
+ * fell back to needing a dev server nobody in the target audience has.
+ *
+ * Widening stops at deployments the host actually recorded. Every step names
+ * the commit it answered with, so Pre is never mistaken for the base.
+ */
+async function deployedBaseline(ctx) {
+    if (ctx.before)
+        return side(ctx.before, 'passed with --before');
+    if (ctx.config.before)
+        return side(ctx.config.before, 'from .pre-post.json');
+    if (!ctx.gh)
+        return null;
+    // What this branch forked from, if that exact commit was deployed. Usually it
+    // was — a host that deploys every push to the default branch has one — but a
+    // repository that deploys on a tag, promotes by hand, or whose base commit is
+    // older than its retained deployments will find nothing here.
+    const baseSha = ctx.baseSha ?? ctx.pr?.base.sha;
+    if (baseSha) {
+        const pinned = await deploymentUrlForSha(ctx.gh, ctx.ownerRepo, baseSha, { production: true });
+        if (pinned)
+            return side(pinned.url, `${pinned.environment} deployment for ${baseSha.slice(0, 7)}`);
+    }
+    // Widening is for a fork point this tool worked out on its own. A base the
+    // caller named is a different thing: production is some other commit, so
+    // answering with it would compare against a commit they did not ask for while
+    // route detection still describes the ref they did -- the same Pre/route-list
+    // disagreement that made `--base` worth fixing in the first place. Yield
+    // instead, and let the local strategy build the named commit from source.
+    if (ctx.baseExplicit) {
+        ctx.log(`No deployment for the base you asked for (${baseSha?.slice(0, 7)}); building it locally rather than comparing against a different commit.`);
+        return null;
+    }
+    // Otherwise what is on production now: the same site, possibly a few commits
+    // ahead, so name the commit it was built from instead of implying the base.
+    const latest = await latestProductionDeployment(ctx.gh, ctx.ownerRepo);
+    if (latest) {
+        return side(latest.url, `${latest.environment} deployment${latest.sha ? ` for ${latest.sha.slice(0, 7)}` : ''}`);
+    }
+    // Anything past here would be a guess at the site's address, and a baseline
+    // that is quietly the wrong site reads as 100% changed on every route — a
+    // result that looks exactly like a real one. Better to say so and stop.
+    return null;
+}
+/** Both sides named by the caller: their call, mixed or not. */
+function explicitPair(ctx) {
+    if (!ctx.before || !ctx.after)
+        return null;
+    return pair('explicit', side(ctx.before, 'passed with --before'), side(ctx.after, 'passed with --after'));
+}
+/**
+ * Both sides deployed — same build pipeline, same CDN, same data.
+ *
+ * The preview is looked up first and alone: it is the cheap question, and when
+ * there is no preview there is nothing for a baseline to pair with, so no
+ * baseline requests are spent on a run that will compare locally anyway.
+ */
+async function deployedPair(ctx) {
+    const preview = await previewForHead(ctx);
+    if (!preview)
+        return { comparison: null, preview: null };
+    const [previewProbe, baseline] = await Promise.all([ctx.probe(preview.url), deployedBaseline(ctx)]);
+    if (!isUsable(previewProbe)) {
+        ctx.log(`Preview deployment ${preview.url} is not reachable (it may be behind Deployment Protection); comparing locally instead.`);
+        return { comparison: null, preview: null };
+    }
+    const baselineProbe = baseline && !isLocalUrl(baseline.url) ? await ctx.probe(baseline.url) : null;
+    if (!baseline || !baselineProbe || !isUsable(baselineProbe)) {
+        ctx.log('Preview deployment found but no reachable deployed baseline; comparing locally instead.');
+        return { comparison: null, preview, rejectedBaseline: baseline ? { side: baseline, probe: baselineProbe } : undefined };
+    }
+    return { comparison: pair('deployed', { ...baseline, probe: baselineProbe }, { ...preview, probe: previewProbe }), preview };
+}
+/**
+ * Both sides local — same browser, same machine, no network.
+ *
+ * This is the strategy that always has something to offer, so it owns the dev
+ * servers it starts: every exit below either hands their teardown to the
+ * Comparison or runs it before throwing.
+ */
+async function localPair(ctx, deployed) {
+    const running = await ctx.devServer;
+    let after = ctx.after
+        ? side(ctx.after, 'passed with --after')
+        : running ? side(running, 'local dev server') : null;
+    // Nothing deployed and nothing running is not a reason to stop: this is the
+    // command you hit on the way out of a PR, so it starts the dev server itself
+    // rather than handing back a chore.
+    let postServer = null;
+    if (!after && ctx.allowLocalBaseline !== false) {
+        postServer = await (ctx.servePost ?? serveWorkingTree)({ repoRoot: ctx.repoRoot, appPrefix: ctx.appPrefix, log: ctx.log });
+        if (postServer)
+            after = side(postServer.url, 'working tree, served locally');
+    }
+    if (!after)
+        throw deployed.preview ? new NoDeployedBaselineError(deployed.preview.url, deployed.rejectedBaseline) : new NoPostError();
+    const stopPost = postServer ? postServer.stop : noop;
+    // A baseline the caller named wins even if it is remote; they asked for it.
+    if (ctx.before)
+        return pair('explicit', side(ctx.before, 'passed with --before'), after, stopPost);
+    // git knows what this branch forked from, so a baseline does not depend on a
+    // PR existing yet — this often runs before one is opened.
+    const baseSha = ctx.baseSha ?? ctx.pr?.base.sha ?? mergeBase(ctx.repoRoot) ?? undefined;
+    // Serving the base can now fail loudly rather than yielding — an install
+    // that died is not a "try the next option", it is the answer. The Post
+    // server is already up by then, so it has to come down before the throw
+    // escapes; nothing above this has a handle on it yet.
+    const baseline = ctx.allowLocalBaseline === false || !baseSha
+        ? null
+        : await (ctx.serveBaseline ?? serveBaseCommit)({ repoRoot: ctx.repoRoot, sha: baseSha, appPrefix: ctx.appPrefix, log: ctx.log })
+            .catch(async (err) => { await stopPost(); throw err; });
+    if (baseline) {
+        const before = side(baseline.url, `base commit ${baseSha.slice(0, 7)}, served locally`);
+        return pair('local', before, after, async () => { await baseline.stop(); await stopPost(); });
+    }
+    // Nothing local could be built; a configured URL beats no comparison at all.
+    if (ctx.config.before)
+        return pair('explicit', side(ctx.config.before, 'from .pre-post.json'), after, stopPost);
+    await stopPost();
+    throw new NoBaselineError();
+}
+/**
+ * Resolve both sides together, cheapest strategy first.
+ *
+ * `explicit` when the caller named both; then `deployed`, which needs a preview
+ * for this commit and a deployed baseline; then `local`, which needs nothing but
+ * the repository itself.
+ */
+export async function resolveComparison(ctx) {
+    const explicit = explicitPair(ctx);
+    if (explicit)
+        return explicit;
+    const deployed = await deployedPair(ctx);
+    return deployed.comparison ?? localPair(ctx, deployed);
+}
+export class NoPostError extends NeedsHumanError {
+    constructor() {
+        super('No preview deployment for this commit and no dev server on the usual ports (3000, 5173, ...). Start the dev server (e.g. npm run dev), then re-run — or pass --after http://localhost:PORT.');
+        this.name = 'NoPostError';
+    }
+}
+/**
+ * A preview exists but nothing could stand beside it.
+ *
+ * Worth its own error because the generic one says "no preview deployment for
+ * this commit", which in this case is the opposite of what happened — and the
+ * person hitting it is the one least able to act on advice about dev servers.
+ *
+ * The instruction depends on *why* there was no baseline. Telling someone to
+ * pass `--before` when the baseline was found and turned them away at a login
+ * wall sends them back to the same URL for the same failure; the fix there is
+ * access, not an argument.
+ */
+export class NoDeployedBaselineError extends NeedsHumanError {
+    constructor(previewUrl, rejected) {
+        super(`Found the preview deployment for this commit (${previewUrl}) but nothing to compare it against: ${reasonFor(rejected)} No dev server is running either.`);
+        this.name = 'NoDeployedBaselineError';
+    }
+}
+const PIN_HINT = 'Re-run with --before https://your-production-url (it is saved to .pre-post.json for next time).';
+function reasonFor(rejected) {
+    if (!rejected)
+        return `no production deployment is recorded for this repository. ${PIN_HINT}`;
+    const { side: baseline, probe } = rejected;
+    if (probe && (probe.status === 401 || probe.status === 403)) {
+        return `the baseline (${baseline.url} — ${baseline.detail}) returned ${probe.status}, so it is behind access control.${probe.vercel ? ' Set VERCEL_AUTOMATION_BYPASS_SECRET, or' : ''} run \`pre-post login ${baseline.url}\`, then re-run.`;
+    }
+    return `the baseline (${baseline.url} — ${baseline.detail}) could not be reached. Check it is up, or ${PIN_HINT[0].toLowerCase()}${PIN_HINT.slice(1)}`;
+}
+export class NoBaselineError extends NeedsHumanError {
+    constructor() {
+        super('No baseline to compare against: no deployed baseline, and the base commit could not be served locally. Re-run with --before https://your-production-url (it is saved to .pre-post.json for next time).');
+        this.name = 'NoBaselineError';
+    }
+}
+/** The plan, for the log — an unattended tool has to say what it chose. */
+export function describeComparison(c) {
+    const lines = [
+        `Comparing (${c.strategy}):`,
+        `  Pre   ${c.before.url}  — ${c.before.detail}`,
+        `  Post  ${c.after.url}  — ${c.after.detail}`,
+    ];
+    if (c.mixed) {
+        lines.push('  Note: the two sides run in different environments, so some differences may not come from this branch.');
+    }
+    return lines;
+}
+//# sourceMappingURL=comparison.js.map

package/dist/comparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison.js","sourceRoot":"","sources":["../src/comparison.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,EAAiB,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,eAAe,EAAe,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA0DrC,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE,CAAC,SAAS,CAAC;AAElD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,MAAc,EAAE,KAAmB,EAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAErH;;;;GAIG;AACH,MAAM,IAAI,GAAG,CAAC,QAAsB,EAAE,MAAY,EAAE,KAAW,EAAE,OAA4B,IAAI,EAAc,EAAE,CAC/G,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/F,qDAAqD;AACrD,SAAS,QAAQ,CAAC,MAAmB;IACnC,OAAO,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;AAClF,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,cAAc,CAAC,GAAmB;IAC/C,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC;IAClC,MAAM,GAAG,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC;IACxC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACjH,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,mBAAmB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClG,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAmB;IACjD,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChE,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC7E,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAEzB,8EAA8E;IAC9E,6EAA6E;IAC7E,8EAA8E;IAC9E,8DAA8D;IAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC;IAChD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/F,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,mBAAmB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,8EAA8E;IAC9E,8EAA8E;IAC9E,yEAAyE;IACzE,0EAA0E;IAC1E,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,6CAA6C,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,0EAA0E,CAAC,CAAC;QACrJ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,cAAc,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnH,CAAC;IAED,4EAA4E;IAC5E,0EAA0E;IAC1E,wEAAwE;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY,CAAC,GAAmB;IACvC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC5G,CAAC;AAeD;;;;;;GAMG;AACH,KAAK,UAAU,YAAY,CAAC,GAAmB;IAC7C,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEzD,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,sBAAsB,OAAO,CAAC,GAAG,wFAAwF,CAAC,CAAC;QACnI,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnG,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;QACnG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1H,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAC/H,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,SAAS,CAAC,GAAmB,EAAE,QAAyB;IACrE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC;IACpC,IAAI,KAAK,GAAgB,GAAG,CAAC,KAAK;QAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,qBAAqB,CAAC;QACxC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvD,4EAA4E;IAC5E,6EAA6E;IAC7E,oCAAoC;IACpC,IAAI,UAAU,GAAyB,IAAI,CAAC;IAC5C,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,kBAAkB,KAAK,KAAK,EAAE,CAAC;QAC/C,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3H,IAAI,UAAU;YAAE,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,8BAA8B,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC;IACtI,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAErD,4EAA4E;IAC5E,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAEnG,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;IACxF,yEAAyE;IACzE,uEAAuE;IACvE,wEAAwE;IACxE,sDAAsD;IACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,KAAK,KAAK,IAAI,CAAC,OAAO;QAC3D,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;aAC3H,KAAK,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,eAAe,OAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,CAAC;IAED,6EAA6E;IAC7E,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChH,MAAM,QAAQ,EAAE,CAAC;IACjB,MAAM,IAAI,eAAe,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAmB;IACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,UAAU,IAAI,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC9C;QACE,KAAK,CAAC,6LAA6L,CAAC,CAAC;QACrM,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,UAAkB,EAAE,QAAoD;QAClF,KAAK,CAAC,iDAAiD,UAAU,wCAAwC,SAAS,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC;QACjK,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,iGAAiG,CAAC;AAEnH,SAAS,SAAS,CAAC,QAAoD;IACrE,IAAI,CAAC,QAAQ;QAAE,OAAO,6DAA6D,QAAQ,EAAE,CAAC;IAC9F,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAC3C,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,iBAAiB,QAAQ,CAAC,GAAG,MAAM,QAAQ,CAAC,MAAM,cAAc,KAAK,CAAC,MAAM,oCAAoC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAC,EAAE,yBAAyB,QAAQ,CAAC,GAAG,kBAAkB,CAAC;IAC/O,CAAC;IACD,OAAO,iBAAiB,QAAQ,CAAC,GAAG,MAAM,QAAQ,CAAC,MAAM,8CAA8C,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACzJ,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAClD;QACE,KAAK,CAAC,wMAAwM,CAAC,CAAC;QAChN,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,CAAa;IAC9C,MAAM,KAAK,GAAG;QACZ,cAAc,CAAC,CAAC,QAAQ,IAAI;QAC5B,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QAC/C,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;KAC9C,CAAC;IACF,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,yGAAyG,CAAC,CAAC;IACxH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/config.d.ts

@@ -7,7 +7,17 @@ export declare const CONFIG_FILENAME = ".pre-post.json";
 export declare const CONFIG_DEFAULTS: {
     viewports: string[];
     threshold: number;
-    minChangedPixels: number;
+    /**
+     * Smallest painted change that counts, in CSS pixels².
+     *
+     * Roughly a third of a 16px icon. Against the fixture ladder every real
+     * change measures 242 CSS px² or more while every no-op measures exactly 0,
+     * so this sits in the middle of a wide empty band — low enough that missing
+     * a real change (the worse error by far: the tool would report "no visual
+     * changes" on a PR that changed something) stays implausible, high enough to
+     * absorb antialiasing differences between two machines.
+     */
+    minChangedArea: number;
     maxRoutes: number;
     fullPage: boolean;
     maxHeight: number;
@@ -18,7 +28,7 @@ export declare const CONFIG_DEFAULTS: {
 export interface Settings {
     viewports: string[];
     threshold: number;
-    minChangedPixels: number;
+    minChangedArea: number;
     maxRoutes: number;
     fullPage: boolean;
     maxHeight: number;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,eAAe;eACU,MAAM,EAAE;;;;;;;;;CAS7C,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,GAAE,aAAkB,EAAE,SAAS,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAcvG;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAU1D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAExE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAI3F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,eAAe;eACA,MAAM,EAAE;;IAElC;;;;;;;;;OASG;;;;;;;;CAQJ,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,GAAE,aAAkB,EAAE,SAAS,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CA0BvG;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAU1D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAExE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAI3F"}

package/dist/config.js

@@ -6,9 +6,19 @@ import fs from 'fs';
 import path from 'path';
 export const CONFIG_FILENAME = '.pre-post.json';
 export const CONFIG_DEFAULTS = {
-    viewports: ['desktop', 'mobile'],
+    viewports: ['desktop'],
     threshold: 0.001,
-    minChangedPixels: 40,
+    /**
+     * Smallest painted change that counts, in CSS pixels².
+     *
+     * Roughly a third of a 16px icon. Against the fixture ladder every real
+     * change measures 242 CSS px² or more while every no-op measures exactly 0,
+     * so this sits in the middle of a wide empty band — low enough that missing
+     * a real change (the worse error by far: the tool would report "no visual
+     * changes" on a PR that changed something) stays implausible, high enough to
+     * absorb antialiasing differences between two machines.
+     */
+    minChangedArea: 100,
     maxRoutes: 6,
     fullPage: true,
     maxHeight: 2400,
@@ -19,10 +29,22 @@ export const CONFIG_DEFAULTS = {
 /** Defaults < .pre-post.json < explicit overrides (undefined overrides are ignored). */
 export function resolveSettings(config = {}, overrides = {}) {
     const pick = (key) => (overrides[key] ?? config[key] ?? CONFIG_DEFAULTS[key]);
+    // minChangedPixels was device pixels, and library callers passed it as an
+    // override as well as setting it in the config file, so both levels have to
+    // be honoured rather than silently falling back to the new default. The new
+    // key wins over the legacy one at the same level; overrides win over config.
+    if (overrides.minChangedArea === undefined) {
+        const legacy = overrides.minChangedPixels
+            ?? (config.minChangedArea === undefined ? config.minChangedPixels : undefined);
+        if (legacy !== undefined) {
+            const scale = pick('scale');
+            config = { ...config, minChangedArea: legacy / (scale * scale) };
+        }
+    }
     return {
         viewports: pick('viewports'),
         threshold: pick('threshold'),
-        minChangedPixels: pick('minChangedPixels'),
+        minChangedArea: pick('minChangedArea'),
         maxRoutes: pick('maxRoutes'),
         fullPage: pick('fullPage'),
         maxHeight: pick('maxHeight'),

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAa;IAC5C,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,EAAE;IACpB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,iBAAiB;IAC/B,SAAS,EAAE,EAAE;CACd,CAAC;AAcF,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,SAAwB,EAAE,EAAE,YAA+B,EAAE;IAC3F,MAAM,IAAI,GAAG,CAA2B,GAAM,EAAe,EAAE,CAC7D,CAAC,SAAS,CAAC,GAAG,CAAC,IAAK,MAA4B,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAgB,CAAC;IAChG,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,gBAAgB,EAAE,IAAI,CAAC,kBAAkB,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;QAC1B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;QAClC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAuB,CAAC;QACzE,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,eAAe,uBAAwB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAqB;IAChE,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAA6B;IAC1E,MAAM,IAAI,GAAG,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IACnD,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/deployments.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Deployment URLs from the GitHub Deployments API.
+ *
+ * Vercel, Cloudflare Pages, Netlify and Render all report their deploys to
+ * GitHub against a commit, so one lookup covers every provider: no per-host
+ * API tokens, and nothing to configure per repo.
+ */
+import { GitHub } from './github.js';
+export interface DeploymentUrl {
+    url: string;
+    environment: string;
+    /** The commit the deployment was built from, when the API reported one. */
+    sha?: string;
+}
+/**
+ * The newest successful deployment URL for a commit.
+ *
+ * `production: true` accepts only production environments (the baseline for
+ * "Pre"); `false` accepts only the others, which is where every provider puts
+ * per-PR previews. Neither falls back to the other kind — a preview standing in
+ * for production would silently compare against the wrong thing.
+ *
+ * Returns null whenever the answer is not unambiguous, so callers fall through
+ * to their next option. Never throws: a repo with no deployments, or a token
+ * without `deployments: read`, is a normal outcome, not a failure.
+ */
+export declare function deploymentUrlForSha(gh: GitHub, ownerRepo: string, sha: string, opts: {
+    production: boolean;
+}): Promise<DeploymentUrl | null>;
+/**
+ * What is deployed to production right now, whatever commit it was built from.
+ *
+ * `deploymentUrlForSha` pins Pre to the commit the branch forked from, which is
+ * the most honest baseline there is — but it only exists if production happened
+ * to be deployed at exactly that commit. Production is a moving branch, so on
+ * most repositories it was not, and pinning alone leaves the deployed
+ * comparison with no Pre at all.
+ *
+ * This asks the same question without the pin. It reports the commit it found,
+ * so the caller can name what Pre actually is rather than implying the base.
+ */
+export declare function latestProductionDeployment(gh: GitHub, ownerRepo: string): Promise<DeploymentUrl | null>;
+/**
+ * The preview for a commit, from whichever mechanism the provider uses.
+ *
+ * The freshness rule lives here rather than in the caller: a bot comment is
+ * edited in place and carries no SHA, so mid-deploy it still advertises the
+ * previous commit's preview. Screenshotting that and labelling it as this
+ * branch is the worst failure this tool has, because it looks exactly like a
+ * correct result. Every caller gets that guarantee by construction.
+ */
+export declare function findPreviewForCommit(gh: GitHub, ownerRepo: string, opts: {
+    sha: string;
+    prNumber?: number;
+    appPrefix?: string;
+}): Promise<DeploymentUrl | null>;
+/**
+ * The preview URL a deployment bot posted on the PR.
+ *
+ * Not every provider records a GitHub Deployment — Vercel's GitHub app reports
+ * a commit status and a comment, and the commit status only links to its own
+ * dashboard. The comment is where the deployed URL actually appears, so this is
+ * the fallback when `deploymentUrlForSha` finds nothing.
+ *
+ * `appPrefix` disambiguates a monorepo comment listing several projects, by
+ * matching the project whose root directory is the app being captured.
+ */
+export declare function previewUrlFromComments(gh: GitHub, ownerRepo: string, prNumber: number, opts?: {
+    appPrefix?: string;
+}): Promise<DeploymentUrl | null>;
+//# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA2BrC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA8DD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAE/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAa7G;AAYD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAU/B;AAwBD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmC/B"}

package/dist/deployments.js

@@ -0,0 +1,204 @@
+/**
+ * Deployment URLs from the GitHub Deployments API.
+ *
+ * Vercel, Cloudflare Pages, Netlify and Render all report their deploys to
+ * GitHub against a commit, so one lookup covers every provider: no per-host
+ * API tokens, and nothing to configure per repo.
+ */
+import { normalizeUrl } from './url.js';
+/**
+ * Bots whose PR comments may be read for a preview URL. A comment is only
+ * trusted when GitHub reports its author as one of these apps: anyone can post
+ * a comment that looks like Vercel's, and following it would point a capture at
+ * a URL a stranger chose.
+ */
+const TRUSTED_BOTS = new Set(['vercel[bot]', 'netlify[bot]']);
+/** Commit-status contexts these same providers post under. */
+const PROVIDER_STATUS = /vercel|netlify|cloudflare|render/i;
+const PRODUCTION = /^prod/i;
+/** How many deployments to inspect per page; each costs one status request. */
+const MAX_DEPLOYMENTS = 5;
+/** Deployments per page when scanning for production. */
+const SCAN_PAGE_SIZE = 100;
+/** How far back to scan. A repo can bury production under a wall of previews. */
+const SCAN_PAGES = 3;
+/**
+ * The newest successful deployment URL matching a query.
+ *
+ * Shared by the two questions callers ask — "what was deployed for this
+ * commit?" and "what is deployed to production right now?" — so both apply the
+ * same production/preview split and the same "success with a URL" rule.
+ */
+async function listDeployments(gh, ownerRepo, query) {
+    try {
+        const deployments = await gh.request('GET', `/repos/${ownerRepo}/deployments?${query}`);
+        return Array.isArray(deployments) ? deployments : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The first of these deployments that reported success with a live URL. */
+async function firstReady(gh, ownerRepo, candidates) {
+    const ready = await Promise.all(candidates.map(async (deployment) => {
+        try {
+            const statuses = await gh.request('GET', `/repos/${ownerRepo}/deployments/${deployment.id}/statuses?per_page=20`);
+            if (!Array.isArray(statuses))
+                return null;
+            const ok = statuses.find((s) => s.state === 'success' && !!s.environment_url);
+            return ok ? { url: ok.environment_url, environment: deployment.environment, sha: deployment.sha } : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    // Candidates stay in newest-first order, so the first hit is the newest.
+    return ready.find(Boolean) ?? null;
+}
+/** One page of deployments, narrowed to production or preview. */
+async function newestSuccessful(gh, ownerRepo, query, production) {
+    const deployments = await listDeployments(gh, ownerRepo, query);
+    if (!deployments)
+        return null;
+    return firstReady(gh, ownerRepo, matching(deployments, production));
+}
+/** Production or preview, newest first, capped at what is worth a status call. */
+function matching(deployments, production) {
+    return deployments.filter(d => PRODUCTION.test(d.environment || '') === production).slice(0, MAX_DEPLOYMENTS);
+}
+/**
+ * The newest successful deployment URL for a commit.
+ *
+ * `production: true` accepts only production environments (the baseline for
+ * "Pre"); `false` accepts only the others, which is where every provider puts
+ * per-PR previews. Neither falls back to the other kind — a preview standing in
+ * for production would silently compare against the wrong thing.
+ *
+ * Returns null whenever the answer is not unambiguous, so callers fall through
+ * to their next option. Never throws: a repo with no deployments, or a token
+ * without `deployments: read`, is a normal outcome, not a failure.
+ */
+export async function deploymentUrlForSha(gh, ownerRepo, sha, opts) {
+    return newestSuccessful(gh, ownerRepo, `sha=${encodeURIComponent(sha)}&per_page=20`, opts.production);
+}
+/**
+ * What is deployed to production right now, whatever commit it was built from.
+ *
+ * `deploymentUrlForSha` pins Pre to the commit the branch forked from, which is
+ * the most honest baseline there is — but it only exists if production happened
+ * to be deployed at exactly that commit. Production is a moving branch, so on
+ * most repositories it was not, and pinning alone leaves the deployed
+ * comparison with no Pre at all.
+ *
+ * This asks the same question without the pin. It reports the commit it found,
+ * so the caller can name what Pre actually is rather than implying the base.
+ */
+export async function latestProductionDeployment(gh, ownerRepo) {
+    // Deployments come back newest first, previews and production interleaved.
+    // A busy repository can push its live production deployment well past the
+    // first page, so scan a few pages rather than reading one and giving up —
+    // but stop the moment a page comes back short, which is the end of the list.
+    for (let page = 1; page <= SCAN_PAGES; page++) {
+        const deployments = await listDeployments(gh, ownerRepo, `per_page=${SCAN_PAGE_SIZE}&page=${page}`);
+        if (!deployments)
+            return null;
+        const found = await firstReady(gh, ownerRepo, matching(deployments, true));
+        if (found)
+            return { ...found, url: normalizeUrl(found.url) };
+        if (deployments.length < SCAN_PAGE_SIZE)
+            return null;
+    }
+    return null;
+}
+/** Has a deployment provider reported success against this exact commit? */
+async function providerSucceededFor(gh, ownerRepo, sha) {
+    try {
+        const combined = await gh.request('GET', `/repos/${ownerRepo}/commits/${sha}/status`);
+        return (combined.statuses ?? []).some(s => s.state === 'success' && PROVIDER_STATUS.test(s.context));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The preview for a commit, from whichever mechanism the provider uses.
+ *
+ * The freshness rule lives here rather than in the caller: a bot comment is
+ * edited in place and carries no SHA, so mid-deploy it still advertises the
+ * previous commit's preview. Screenshotting that and labelling it as this
+ * branch is the worst failure this tool has, because it looks exactly like a
+ * correct result. Every caller gets that guarantee by construction.
+ */
+export async function findPreviewForCommit(gh, ownerRepo, opts) {
+    const recorded = await deploymentUrlForSha(gh, ownerRepo, opts.sha, { production: false });
+    if (recorded)
+        return { ...recorded, url: normalizeUrl(recorded.url) };
+    if (opts.prNumber === undefined)
+        return null;
+    const [fresh, commented] = await Promise.all([
+        providerSucceededFor(gh, ownerRepo, opts.sha),
+        previewUrlFromComments(gh, ownerRepo, opts.prNumber, { appPrefix: opts.appPrefix }),
+    ]);
+    return fresh && commented ? { ...commented, url: normalizeUrl(commented.url) } : null;
+}
+function decodeVercelPayload(body) {
+    const marker = /^\[vc\]: #[^:\n]+:(\S+)/m.exec(body);
+    if (!marker)
+        return null;
+    try {
+        const json = JSON.parse(Buffer.from(marker[1], 'base64').toString('utf8'));
+        return json && typeof json === 'object' ? json : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The preview URL a deployment bot posted on the PR.
+ *
+ * Not every provider records a GitHub Deployment — Vercel's GitHub app reports
+ * a commit status and a comment, and the commit status only links to its own
+ * dashboard. The comment is where the deployed URL actually appears, so this is
+ * the fallback when `deploymentUrlForSha` finds nothing.
+ *
+ * `appPrefix` disambiguates a monorepo comment listing several projects, by
+ * matching the project whose root directory is the app being captured.
+ */
+export async function previewUrlFromComments(gh, ownerRepo, prNumber, opts = {}) {
+    let comments;
+    try {
+        comments = await gh.request('GET', `/repos/${ownerRepo}/issues/${prNumber}/comments?per_page=100`);
+    }
+    catch {
+        return null;
+    }
+    if (!Array.isArray(comments))
+        return null;
+    // Newest first: a re-run posts an updated URL.
+    for (const comment of [...comments].reverse()) {
+        const body = comment.body ?? '';
+        if (!comment.user || !TRUSTED_BOTS.has(comment.user.login))
+            continue;
+        const payload = decodeVercelPayload(body);
+        const projects = (payload?.projects ?? []).filter(p => p.previewUrl);
+        if (projects.length) {
+            // Only projects that could be the app being captured. A project that
+            // declares a different root directory is a different app, so falling back
+            // to it would screenshot the wrong site.
+            const norm = (dir) => (dir ?? '').replace(/^\.?\//, '').replace(/\/$/, '');
+            const candidates = projects.filter(p => !opts.appPrefix || !p.rootDirectory || norm(p.rootDirectory) === opts.appPrefix);
+            const chosen = candidates.length === 1 ? candidates[0] : undefined;
+            // A build still running has a URL that does not serve the branch yet.
+            if (chosen && (chosen.nextCommitStatus ?? 'DEPLOYED') === 'DEPLOYED') {
+                return { url: normalizeUrl(chosen.previewUrl), environment: chosen.name ? `Preview (${chosen.name})` : 'Preview' };
+            }
+            continue;
+        }
+        // Providers without a structured payload still link the preview by name.
+        const link = /\[(?:Preview|Deploy Preview)\]\((https?:\/\/[^\s)]+)\)/i.exec(body);
+        if (link)
+            return { url: link[1], environment: 'Preview' };
+    }
+    return null;
+}
+//# sourceMappingURL=deployments.js.map

package/dist/deployments.js.map

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