@setsquare/review-sdk 0.0.1

package/dist/findings.d.ts

@@ -0,0 +1,47 @@
+import type { AxeFinding, RuleInapplicable, RulePass } from '@setsquare/schema';
+import type { AxeRunResults } from './axe.js';
+export declare function toFindings(results: AxeRunResults): AxeFinding[];
+/**
+ * Rule-level pass rows.
+ *
+ * Emitted from the first release because P2 computes "regressed" as a JOIN
+ * against these, so a run ingested without them leaves a permanent hole in
+ * evidence history. `inapplicable` is deliberately excluded: a rule with nothing
+ * to check did not pass, and recording it as one would inflate every conformance
+ * claim built on this data.
+ */
+export declare function toPasses(results: AxeRunResults): RulePass[];
+/**
+ * EARL's `inapplicable`: rules that ran and found nothing to check.
+ *
+ * Rule-level like passes, but never conflated with them — a page with no
+ * `<video>` did not pass the captions rule. Carried because "your pages
+ * contain nothing this criterion regulates" is coverage a ledger must be able
+ * to state; without these rows it can only say "did not run", which
+ * understates what the scan did.
+ */
+export declare function toInapplicable(results: AxeRunResults): RuleInapplicable[];
+export declare function toWcag(tags: string[]): AxeFinding['wcag'] | undefined;
+/**
+ * Bound and clean computed evidence.
+ *
+ * Three filters, narrowest first.
+ *
+ * **By name** (`isPermittedComputedValue`): a rule contributes the keys the
+ * contract says it may, and an unenumerated rule contributes numbers and
+ * booleans only. This is the filter that makes "no page text leaves the
+ * customer's CI" a property of the code rather than a habit of its authors — a
+ * check that starts putting `node.textContent` under a new key emits nothing
+ * until that key is declared in `@setsquare/schema`.
+ *
+ * **By shape**: nested objects and arrays are dropped, because that is where
+ * `relatedNodes` and other page fragments hide, and no rule family needs them
+ * for arithmetic.
+ *
+ * **By size**: strings are stripped of hostile characters and capped, the whole
+ * object is size-capped, and anything that will not serialise is dropped rather
+ * than risked. URL-valued keys lose their query and fragment first — a path is
+ * evidence, a query string is where tokens and addresses live.
+ */
+export declare function sanitiseComputed(data: Record<string, unknown>, ruleId: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=findings.d.ts.map

package/dist/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIhF,OAAO,KAAK,EAA0B,aAAa,EAAE,MAAM,UAAU,CAAC;AAoCtE,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,EAAE,CAK/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,EAAE,CAc3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,EAAE,CASzE;AAiDD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAkCrE;AAwCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAmBrC"}

package/dist/findings.js

@@ -0,0 +1,229 @@
+import { isPermittedComputedValue, isUrlValuedComputedKey, stripUrlTail } from '@setsquare/schema';
+import { MAX_RULE_ID_LENGTH } from '@setsquare/schema/limits';
+import { capLength, sanitiseFailureSummary, sanitiseSelectors, stripHostileCharacters, } from './sanitise.js';
+/**
+ * Map axe's output onto the contract's shapes.
+ *
+ * Everything crossing this boundary is untrusted: selectors and class names come
+ * from customer-page DOM, which routinely contains third-party embeds and
+ * user-generated content. Nothing is copied through without passing the
+ * sanitiser, and the two fields axe offers that we deliberately never carry are
+ * `node.html` (schema v1 has no snippet field, and this is the field that would
+ * otherwise smuggle whole page fragments into evidence) and `relatedNodes`
+ * (which contains the same HTML for other elements).
+ */
+/** Bounded, because computed evidence is page-derived like everything else. */
+const MAX_COMPUTED_BYTES = 2048;
+const IMPACTS = new Set(['minor', 'moderate', 'serious', 'critical']);
+/**
+ * `wcag412` -> `4.1.2`, `wcag1410` -> `1.4.10`.
+ *
+ * The first two digits are always single, the rest is the criterion number —
+ * which is why this cannot be a naive split. 1.4.10 and 1.4.1 would be
+ * indistinguishable under one.
+ */
+const CRITERION_TAG = /^wcag(\d)(\d)(\d+)$/;
+/** `wcag2a`, `wcag21aa`, `wcag22aa` — the version-and-level tags. */
+const VERSION_TAG = /^wcag(\d)(\d)?(a{1,3})$/;
+export function toFindings(results) {
+    return [
+        ...results.violations.map((rule) => toFinding(rule, 'violation')),
+        ...results.incomplete.map((rule) => toFinding(rule, 'incomplete')),
+    ];
+}
+/**
+ * Rule-level pass rows.
+ *
+ * Emitted from the first release because P2 computes "regressed" as a JOIN
+ * against these, so a run ingested without them leaves a permanent hole in
+ * evidence history. `inapplicable` is deliberately excluded: a rule with nothing
+ * to check did not pass, and recording it as one would inflate every conformance
+ * claim built on this data.
+ */
+export function toPasses(results) {
+    return results.passes.map((rule) => {
+        const pass = {
+            ruleId: capLength(stripHostileCharacters(rule.id), MAX_RULE_ID_LENGTH),
+            nodeCount: rule.nodes.length,
+        };
+        // The same WCAG identity findings carry, so the conformance projection can
+        // credit a passing rule to its criteria. Absent on best-practice rules,
+        // exactly as it is on findings — a pass row with no wcag block is advice
+        // that held, not conformance evidence.
+        const wcag = toWcag(rule.tags);
+        if (wcag)
+            pass.wcag = wcag;
+        return pass;
+    });
+}
+/**
+ * EARL's `inapplicable`: rules that ran and found nothing to check.
+ *
+ * Rule-level like passes, but never conflated with them — a page with no
+ * `<video>` did not pass the captions rule. Carried because "your pages
+ * contain nothing this criterion regulates" is coverage a ledger must be able
+ * to state; without these rows it can only say "did not run", which
+ * understates what the scan did.
+ */
+export function toInapplicable(results) {
+    return results.inapplicable.map((rule) => {
+        const row = {
+            ruleId: capLength(stripHostileCharacters(rule.id), MAX_RULE_ID_LENGTH),
+        };
+        const wcag = toWcag(rule.tags);
+        if (wcag)
+            row.wcag = wcag;
+        return row;
+    });
+}
+function toFinding(rule, status) {
+    const selectors = rule.nodes.flatMap((node) => selectorsOf(node));
+    const targets = sanitiseSelectors(selectors);
+    const finding = {
+        ruleId: capLength(stripHostileCharacters(rule.id), MAX_RULE_ID_LENGTH),
+        status,
+        targets: {
+            // The TRUE total, even though `selectors` is capped. An agent needs to know
+            // the shape of the problem and its size; the cap only bounds the former.
+            nodeCount: rule.nodes.length,
+            ...targets,
+        },
+    };
+    // Axe reports no impact on some incompletes. Absent means unknown, and must
+    // not quietly become "minor".
+    if (rule.impact && IMPACTS.has(rule.impact)) {
+        finding.impact = rule.impact;
+    }
+    const wcag = toWcag(rule.tags);
+    if (wcag)
+        finding.wcag = wcag;
+    if (rule.helpUrl) {
+        // Axe appends `?application=axeAPI`, which is telemetry-ish noise on a link a
+        // human is meant to click.
+        const helpUrl = rule.helpUrl.split('?')[0];
+        if (helpUrl && helpUrl.startsWith('https://'))
+            finding.helpUrl = helpUrl;
+    }
+    const evidence = toEvidence(rule.nodes, finding.ruleId);
+    if (evidence)
+        finding.evidence = evidence;
+    return finding;
+}
+/** Axe's targets are strings, or arrays of strings for nested frames. */
+function selectorsOf(node) {
+    return node.target.flatMap((entry) => {
+        if (typeof entry === 'string')
+            return [entry];
+        if (Array.isArray(entry))
+            return entry.filter((part) => typeof part === 'string');
+        return [];
+    });
+}
+export function toWcag(tags) {
+    const criteria = [];
+    const versionTags = [];
+    let level;
+    for (const tag of tags) {
+        const criterion = CRITERION_TAG.exec(tag);
+        if (criterion) {
+            criteria.push(`${criterion[1]}.${criterion[2]}.${criterion[3]}`);
+            continue;
+        }
+        const version = VERSION_TAG.exec(tag);
+        if (version) {
+            versionTags.push(tag);
+            // Keep the STRONGEST level the rule carries. A rule tagged both wcag2a and
+            // wcag2aa is an A-level requirement; reporting AA would overstate what
+            // failing it means.
+            const candidate = version[3]?.toUpperCase();
+            if (!level || candidate.length < level.length)
+                level = candidate;
+        }
+    }
+    if (criteria.length === 0 && versionTags.length === 0)
+        return undefined;
+    const wcag = {
+        // Sorted and deduplicated so two runs produce byte-identical evidence.
+        criteria: [...new Set(criteria)].sort().slice(0, 20),
+        versionTags: [...new Set(versionTags)].sort().slice(0, 20),
+    };
+    if (level)
+        wcag.level = level;
+    return wcag;
+}
+/**
+ * Failure summary plus computed evidence.
+ *
+ * `data` from the failing check is the "agent can do arithmetic" field — for
+ * contrast it holds the measured ratio, the required ratio and both colours,
+ * which is the difference between "fix the contrast" and "this token is 2.51:1
+ * and needs 4.5:1". Taken only from the check that failed, and only `data`:
+ * `relatedNodes` carries HTML for other elements and never crosses this line.
+ */
+function toEvidence(nodes, ruleId) {
+    const first = nodes[0];
+    if (!first)
+        return undefined;
+    const evidence = {};
+    const summary = sanitiseFailureSummary(first.failureSummary);
+    if (summary)
+        evidence.failureSummary = summary;
+    const computed = computedFrom(first, ruleId);
+    if (computed)
+        evidence.computed = computed;
+    return evidence.failureSummary || evidence.computed ? evidence : undefined;
+}
+function computedFrom(node, ruleId) {
+    for (const bucket of [node.any, node.all, node.none]) {
+        for (const check of bucket ?? []) {
+            const data = check.data;
+            if (!data || typeof data !== 'object' || Array.isArray(data))
+                continue;
+            const cleaned = sanitiseComputed(data, ruleId);
+            if (cleaned)
+                return cleaned;
+        }
+    }
+    return undefined;
+}
+/**
+ * Bound and clean computed evidence.
+ *
+ * Three filters, narrowest first.
+ *
+ * **By name** (`isPermittedComputedValue`): a rule contributes the keys the
+ * contract says it may, and an unenumerated rule contributes numbers and
+ * booleans only. This is the filter that makes "no page text leaves the
+ * customer's CI" a property of the code rather than a habit of its authors — a
+ * check that starts putting `node.textContent` under a new key emits nothing
+ * until that key is declared in `@setsquare/schema`.
+ *
+ * **By shape**: nested objects and arrays are dropped, because that is where
+ * `relatedNodes` and other page fragments hide, and no rule family needs them
+ * for arithmetic.
+ *
+ * **By size**: strings are stripped of hostile characters and capped, the whole
+ * object is size-capped, and anything that will not serialise is dropped rather
+ * than risked. URL-valued keys lose their query and fragment first — a path is
+ * evidence, a query string is where tokens and addresses live.
+ */
+export function sanitiseComputed(data, ruleId) {
+    const cleaned = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (!isPermittedComputedValue(ruleId, key, value))
+            continue;
+        if (typeof value === 'string') {
+            const bounded = isUrlValuedComputedKey(ruleId, key) ? stripUrlTail(value) : value;
+            cleaned[stripHostileCharacters(key)] = capLength(stripHostileCharacters(bounded), 256);
+        }
+        else if (typeof value === 'number' || typeof value === 'boolean')
+            cleaned[stripHostileCharacters(key)] = value;
+    }
+    if (Object.keys(cleaned).length === 0)
+        return undefined;
+    const serialised = JSON.stringify(cleaned);
+    if (!serialised || serialised.length > MAX_COMPUTED_BYTES)
+        return undefined;
+    return cleaned;
+}
+//# sourceMappingURL=findings.js.map

package/dist/findings.js.map

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

package/dist/fixture.d.ts

@@ -0,0 +1,7 @@
+import type { BrowserContext, TestInfo } from '@playwright/test';
+import type { ResolvedSetsquareOptions } from './options.js';
+export declare function createContextFixture(options: ResolvedSetsquareOptions): ({ context, browserName }: {
+    context: BrowserContext;
+    browserName: string;
+}, use: (context: BrowserContext) => Promise<void>, testInfo: TestInfo) => Promise<void>;
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAYvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAwE7D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,IAElE,0BAA0B;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAC1E,KAAK,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,UAAU,QAAQ,KACjB,OAAO,CAAC,IAAI,CAAC,CAmFjB"}

package/dist/fixture.js

@@ -0,0 +1,237 @@
+import { SCAN_RECORD_ATTACHMENT, SCAN_RECORD_VERSION, } from './contract.js';
+import { flushAutoScan, installAutoScan } from './autoscan.js';
+import { observePageRuntime } from './observe.js';
+import { unscannableOmitted, unscannableRows } from './unscannable.js';
+/**
+ * The capture half of the SDK: an override of Playwright's `context` fixture
+ * that watches every page and records what it saw.
+ *
+ * It forms no opinions. No dedupe, no inference, no aggregation, no disk — all of
+ * that is the reporter's, because the reporter is the only thing that exists once
+ * per run. This file runs in N worker processes, and anything stateful here is a
+ * cross-process bug in waiting.
+ */
+/**
+ * Records SPA route changes from inside the page.
+ *
+ * `history.pushState` and `replaceState` fire no navigation event that Playwright
+ * can see, so a `framenavigated` listener alone observes ONE url on a
+ * single-page app and misses every route the user actually visited. Patching the
+ * two methods and listening for `popstate` is the only way to see them.
+ *
+ * Deliberately writes to an array on `window` rather than exposing a binding or
+ * dispatching events: a binding installs a function the application can see, and
+ * this is the customer's page, not ours. The array is read back at teardown.
+ *
+ * KNOWN LIMIT, and it is why this is capture-only for now: `addInitScript` runs
+ * fresh on every real navigation, so the log resets with each document. Route
+ * changes made before the last full navigation are not recovered at teardown.
+ * That is fine while nothing depends on the timing, and it stops being fine the
+ * moment auto-scan needs to fire AT the route change rather than learn about it
+ * afterwards. That is the point at which this grows a binding (P1-4.2).
+ */
+const NAV_LOG_SCRIPT = `
+(() => {
+  const log = [];
+  Object.defineProperty(window, '__setsquareNavLog', {
+    value: log,
+    // Non-enumerable so it does not show up in a customer's own iteration over
+    // window, and non-writable so page code cannot clobber it by accident.
+    enumerable: false,
+    writable: false,
+    configurable: true,
+  });
+
+  const record = (kind) => log.push({ kind, url: location.href, at: Date.now() });
+
+  for (const method of ['pushState', 'replaceState']) {
+    const original = history[method];
+    history[method] = function (...args) {
+      const result = original.apply(this, args);
+      try { record(method); } catch {}
+      return result;
+    };
+  }
+
+  window.addEventListener('popstate', () => { try { record('popstate'); } catch {} });
+})();
+`;
+const NAV_KINDS = new Set(['pushState', 'replaceState', 'popstate']);
+export function createContextFixture(options) {
+    return async function setsquareContext({ context, browserName }, use, testInfo) {
+        const startedAt = Date.now();
+        const observers = [];
+        const warnings = [];
+        // Applies to pages that already exist and to every page opened later,
+        // including ones the test opens itself. A test driving two sessions is
+        // ordinary in a real suite, and attributing one page's evidence to another
+        // page's context would be worse than capturing nothing.
+        await context.addInitScript(NAV_LOG_SCRIPT).catch(() => {
+            // A context that refuses init scripts still yields real navigations below.
+            // Partial evidence beats none, provided we do not pretend it is complete.
+        });
+        const observe = (page) => {
+            const observer = { page, navigations: [] };
+            observers.push(observer);
+            /*
+             * What the page itself did: console errors, uncaught throws, failed
+             * requests, responses at or above 400.
+             *
+             * Attached here rather than at the context, so it covers pages the test
+             * opens itself and so a test that opens none pays nothing — which is the
+             * whole reason this is a `context` fixture and not a `page` one.
+             */
+            observePageRuntime(page, startedAt);
+            page.on('framenavigated', (frame) => {
+                // Main frame only. An iframe navigating is not the user changing page,
+                // and treating it as one would file evidence against the wrong surface.
+                if (frame !== page.mainFrame())
+                    return;
+                observer.navigations.push({
+                    url: frame.url(),
+                    atMs: Date.now() - startedAt,
+                    kind: 'navigation',
+                });
+            });
+        };
+        for (const page of context.pages())
+            observe(page);
+        context.on('page', observe);
+        if (options.autoScan && !options.disabled) {
+            // Installed before the test body runs, so the very first navigation is
+            // already being watched. A scanner that starts listening after the page has
+            // loaded has already missed the thing it exists to see.
+            await installAutoScan(context, options, testInfo, (message) => warnings.push(message)).catch((error) => {
+                warnings.push(`Automatic scanning could not be installed: ${error instanceof Error ? error.message : String(error)}. Explicit setsquare.scan() calls are unaffected.`);
+            });
+        }
+        try {
+            await use(context);
+        }
+        finally {
+            // Teardown must never fail the test. The suite's verdict is the customer's,
+            // and our evidence-gathering has no standing to overturn it.
+            try {
+                // Before recording observations: whatever the test left on screen is the
+                // most reliable scan opportunity in the whole run, and for a fast test it
+                // is the only one.
+                if (options.autoScan && !options.disabled) {
+                    await flushAutoScan(context, options, testInfo, (message) => warnings.push(message));
+                }
+                await attachRecords(observers, browserName, startedAt, testInfo);
+                for (const message of warnings) {
+                    // Surfaced through Playwright's own annotations so a problem appears
+                    // next to the test it happened in, not buried in a summary.
+                    testInfo.annotations.push({ type: 'setsquare-warning', description: message });
+                }
+            }
+            catch {
+                // Swallowed on purpose. A capture problem is reported through the run's
+                // warnings, not by reddening someone's suite.
+            }
+        }
+    };
+}
+async function attachRecords(observers, browserName, startedAt, testInfo) {
+    for (const observer of observers) {
+        const observed = await observePage(observer, browserName, startedAt, testInfo.project.name);
+        if (!observed)
+            continue;
+        const record = {
+            recordVersion: SCAN_RECORD_VERSION,
+            kind: 'observation',
+            observed,
+        };
+        /*
+         * Surfaces this page reached and we could not scan.
+         *
+         * Rides the observation record because that is the one thing written per page
+         * at teardown, after every scan attempt has had its chance to fail. Absent
+         * when nothing was recorded — an empty array would be a claim that nothing
+         * went unscanned, which is a different statement.
+         */
+        const unscanned = unscannableRows(observer.page);
+        if (unscanned) {
+            record.unscanned = unscanned;
+            const omitted = unscannableOmitted(observer.page);
+            if (omitted > 0)
+                record.unscannedOmitted = omitted;
+        }
+        await testInfo.attach(SCAN_RECORD_ATTACHMENT, {
+            body: Buffer.from(JSON.stringify(record), 'utf8'),
+            contentType: 'application/json',
+        });
+    }
+}
+async function observePage(observer, browserName, startedAt, project) {
+    const { page } = observer;
+    const navigations = [...observer.navigations];
+    // A page closed by the test is not an error — plenty of specs close their own.
+    // Whatever was observed before it closed is still evidence.
+    if (!page.isClosed()) {
+        const routeChanges = await readRouteChanges(page, startedAt);
+        navigations.push(...routeChanges);
+    }
+    // `about:blank` is Playwright opening a context, not the suite visiting
+    // anything. Recording it would put a surface in the grid that no test asked for.
+    const meaningful = navigations.filter((nav) => nav.url && nav.url !== 'about:blank');
+    if (meaningful.length === 0)
+        return undefined;
+    meaningful.sort((a, b) => a.atMs - b.atMs);
+    const context = {
+        project,
+        engine: normaliseEngine(browserName),
+        navigations: meaningful,
+    };
+    if (!page.isClosed()) {
+        const viewport = page.viewportSize();
+        if (viewport)
+            context.viewport = viewport;
+        const theme = await readTheme(page);
+        if (theme)
+            context.observedTheme = theme;
+    }
+    return context;
+}
+async function readRouteChanges(page, startedAt) {
+    try {
+        const raw = await page.evaluate(() => window.__setsquareNavLog ?? []);
+        return raw
+            .filter((entry) => NAV_KINDS.has(entry.kind))
+            .map((entry) => ({
+            url: entry.url,
+            atMs: entry.at - startedAt,
+            kind: entry.kind,
+        }));
+    }
+    catch {
+        // Navigating away mid-read, a closed page, a CSP that blocked the init
+        // script. None of these is worth a warning on its own.
+        return [];
+    }
+}
+async function readTheme(page) {
+    try {
+        return await page.evaluate(() => {
+            const root = document.documentElement;
+            // Our own attribute first: a customer who has told us explicitly should not
+            // be second-guessed by a heuristic. `data-theme` is the widespread
+            // convention and is what the reference implementation uses.
+            return (root.getAttribute('data-setsquare-theme') ?? root.getAttribute('data-theme') ?? undefined);
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Anything that is not one of Playwright's three engines is treated as chromium.
+ *
+ * Not a guess: `browserName` is a closed set in Playwright, and branded channels
+ * (`chrome`, `msedge`) are chromium. If a fourth engine ever appears this becomes
+ * wrong, which is what the compatibility matrix is for.
+ */
+function normaliseEngine(browserName) {
+    return browserName === 'firefox' || browserName === 'webkit' ? browserName : 'chromium';
+}
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

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