@brandlab-digital/conformance 2.1.0 → 3.0.0

package/dist/estate.js

@@ -0,0 +1,391 @@
+/**
+ * The shared technical-estate journey for a Brandlab production build:
+ *
+ *   // tests/e2e/estate.spec.ts
+ *   import { defineBrandlabEstateTests } from '@brandlab-digital/conformance/estate'
+ *   import { site } from '../../src/config/site'
+ *   import { routes } from '../../src/data/routes'
+ *   import { redirects } from '../../src/data/redirects'
+ *
+ *   defineBrandlabEstateTests({ site, routes, redirects })
+ *
+ * It asserts the estate and its routes: the sitemap, each route's status,
+ * canonical and indexing, internal links, redirects, unknown slugs and
+ * robots.txt. Page and structured-data quality is reported, never enforced,
+ * by defineBrandlabPageQualityTests: a backend release keeps production's pages
+ * as they are, which the comparison harness proves. Counts are always derived
+ * from the current catalogue, never a historic constant.
+ */
+import { expect, test } from '@playwright/test';
+import { extractSearchCertificationHtmlSnapshot } from './search-certification.js';
+const BUSINESS_TYPES = new Set([
+    'LocalBusiness', 'HomeAndConstructionBusiness', 'GeneralContractor', 'Plumber', 'Electrician',
+    'RoofingContractor', 'HousePainter', 'Locksmith', 'MovingCompany', 'HVACBusiness', 'ProfessionalService',
+]);
+const UNKNOWN_SLUG = 'brandlab-estate-unknown-page';
+const NOT_FOUND_ROUTE = '/404';
+const PATTERN_SAMPLE = 'brandlab-estate-sample';
+const ASSET_PATH = /\.[a-z0-9]{2,5}$/i;
+export function defineBrandlabEstateTests(options) {
+    const origin = new URL(String(options.site.canonicalUrl)).origin;
+    const canonical = (path) => new URL(path, `${origin}/`).href;
+    const routes = options.routes;
+    const knownPaths = new Set(routes.map((route) => normalisePath(route.path)));
+    const redirects = (options.redirects ?? []).filter((rule) => !rule.host);
+    const redirectBySource = new Map(redirects.filter((rule) => !isRedirectPattern(rule.source)).map((rule) => [normalisePath(rule.source), rule]));
+    const patternRedirects = redirects.flatMap((rule) => {
+        const matcher = isRedirectPattern(rule.source) ? redirectSourceMatcher(rule.source) : undefined;
+        return matcher ? [{ rule, matcher }] : [];
+    });
+    const findRedirect = (path) => redirectBySource.get(path) ?? patternRedirects.find(({ matcher }) => matcher.test(path))?.rule;
+    const timeout = options.timeout ?? 240_000;
+    test.describe('Brandlab technical estate', () => {
+        test('the sitemap lists exactly the indexable catalogue routes', async ({ request }) => {
+            test.setTimeout(timeout);
+            const listed = await readSitemap(request, '/sitemap.xml', origin);
+            const expected = routes
+                .filter((route) => route.indexing === 'index')
+                .map((route) => canonical(route.canonicalPath ?? route.path));
+            expect(listed.length, 'the sitemap repeats a URL').toBe(new Set(listed).size);
+            expect([...listed].sort()).toEqual([...new Set(expected)].sort());
+        });
+        test('every catalogue route serves its canonical identity and links only to live pages', async ({ request }, testInfo) => {
+            test.setTimeout(timeout);
+            const failures = [];
+            const internalLinks = new Map();
+            const checked = [];
+            await eachWithConcurrency(routes, options.concurrency ?? 8, async (route) => {
+                const [get, head] = await Promise.all([
+                    request.get(route.path, { maxRedirects: 0 }),
+                    request.head(route.path, { maxRedirects: 0 }),
+                ]);
+                // Next serves its not-found page at /404 with a 404 status.
+                const notFound = normalisePath(route.path) === NOT_FOUND_ROUTE;
+                const expectedStatus = notFound ? 404 : 200;
+                if (get.status() !== expectedStatus || head.status() !== expectedStatus) {
+                    failures.push(`${route.path}: GET ${get.status()}, HEAD ${head.status()} (expected ${expectedStatus})`);
+                    return;
+                }
+                const html = await get.text();
+                const snapshot = extractSearchCertificationHtmlSnapshot(html);
+                const robots = `${snapshot.robots ?? ''} ${get.headers()['x-robots-tag'] ?? ''}`;
+                if (notFound) {
+                    if (!/noindex/i.test(robots))
+                        failures.push(`${route.path}: the not-found page is indexable`);
+                    checked.push({ path: route.path, canonical: snapshot.canonical, jsonLd: snapshot.jsonLd.length });
+                    return;
+                }
+                const expectedCanonical = canonical(route.canonicalPath ?? route.path);
+                const canonicalTags = html.match(/<link\b[^>]*\brel=["']canonical["'][^>]*>/gi) ?? [];
+                if (canonicalTags.length !== 1)
+                    failures.push(`${route.path}: ${canonicalTags.length} canonical links`);
+                if (!snapshot.canonical || new URL(snapshot.canonical, origin).href !== expectedCanonical) {
+                    failures.push(`${route.path}: canonical ${snapshot.canonical ?? 'missing'} (expected ${expectedCanonical})`);
+                }
+                if (route.indexing === 'index' && /noindex/i.test(robots))
+                    failures.push(`${route.path}: indexable route is noindex`);
+                if (route.indexing !== 'index' && !/noindex/i.test(robots))
+                    failures.push(`${route.path}: ${route.indexing} route is indexable`);
+                for (const href of extractLinks(html)) {
+                    const path = internalPath(href, expectedCanonical, origin);
+                    if (path && !internalLinks.has(path))
+                        internalLinks.set(path, route.path);
+                }
+                checked.push({ path: route.path, canonical: snapshot.canonical, jsonLd: snapshot.jsonLd.length });
+            });
+            for (const [path, from] of [...internalLinks].sort()) {
+                if (knownPaths.has(path))
+                    continue;
+                const redirect = findRedirect(path);
+                if (redirect && isExternalDestination(redirect.destination))
+                    continue;
+                failures.push(redirect
+                    ? `${from}: links to ${path}, which redirects; link to ${redirect.destination} directly`
+                    : `${from}: links to ${path}, which is not a catalogue route`);
+            }
+            await testInfo.attach('technical-estate.json', {
+                body: JSON.stringify({ routes: checked.sort((a, b) => a.path.localeCompare(b.path)), internalLinks: [...internalLinks.keys()].sort() }, null, 2),
+                contentType: 'application/json',
+            });
+            expect(failures).toEqual([]);
+        });
+        test('every redirect resolves in one hop and keeps the query string', async ({ request }, testInfo) => {
+            test.setTimeout(timeout);
+            const failures = [];
+            const skipped = [];
+            for (const rule of redirects) {
+                const probe = redirectProbe(rule);
+                if (!probe) {
+                    skipped.push(`${rule.source} → ${rule.destination}`);
+                    continue;
+                }
+                const sources = [probe.source, ...(options.trailingSlashRedirects === false || probe.source === '/' || probe.source.endsWith('/') ? [] : [`${probe.source}/`])];
+                for (const source of sources) {
+                    for (const method of ['GET', 'HEAD']) {
+                        const response = await request.fetch(`${source}?brandlab_estate=1`, { method, maxRedirects: 0 });
+                        const location = response.headers().location;
+                        const expectedStatus = source === probe.source ? [rule.status] : [301, 308];
+                        if (!expectedStatus.includes(response.status()) || !location) {
+                            failures.push(`${method} ${source}: ${response.status()} (expected ${expectedStatus.join(' or ')} to ${probe.destination})`);
+                            continue;
+                        }
+                        const target = new URL(location, origin);
+                        if (isExternalDestination(probe.destination)) {
+                            if (!target.href.startsWith(new URL(probe.destination, origin).href.replace(/\/$/, '')))
+                                failures.push(`${method} ${source}: Location ${location} (expected ${probe.destination})`);
+                            continue;
+                        }
+                        if (target.pathname !== new URL(probe.destination, origin).pathname)
+                            failures.push(`${method} ${source}: Location ${location} (expected ${probe.destination})`);
+                        if (target.searchParams.get('brandlab_estate') !== '1')
+                            failures.push(`${method} ${source}: the query string was dropped`);
+                    }
+                }
+                // A destination with parameters names many pages; the sample fills it with a page that does not exist.
+                if (!isExternalDestination(probe.destination) && !probe.sampled) {
+                    const destination = await request.get(probe.destination, { maxRedirects: 0 });
+                    if (destination.status() !== 200)
+                        failures.push(`${rule.source}: destination ${probe.destination} answers ${destination.status()} (a chain or a missing page)`);
+                }
+            }
+            if (skipped.length > 0) {
+                testInfo.annotations.push({ type: 'skipped-redirects', description: `${skipped.length} redirect(s) with a parameter pattern that cannot be sampled: ${skipped.join('; ')}` });
+            }
+            expect(failures).toEqual([]);
+        });
+        test('unknown slugs answer 404 instead of inventing pages', async ({ request }) => {
+            const paths = options.notFoundPaths ?? defaultNotFoundPaths(routes);
+            const failures = [];
+            for (const path of paths) {
+                const response = await request.get(path, { maxRedirects: 0 });
+                if (response.status() !== 404)
+                    failures.push(`${path}: ${response.status()} (expected 404)`);
+            }
+            expect(failures).toEqual([]);
+        });
+        test('robots.txt allows crawling and names the sitemap', async ({ request }) => {
+            const response = await request.get('/robots.txt');
+            expect(response.status()).toBe(200);
+            const body = await response.text();
+            expect(body).toMatch(new RegExp(`^sitemap:\\s*${escapeRegExp(`${origin}/sitemap.xml`)}\\s*$`, 'im'));
+            expect(body).not.toMatch(/^disallow:\s*\/\s*$/im);
+        });
+    });
+}
+/**
+ * Every `<loc>` in a sitemap, following one level of sitemap index. Nothing is
+ * followed through a redirect, and with `origin` every nested sitemap must be
+ * on that origin (it is then fetched from the build under test).
+ */
+export async function readSitemap(request, path, origin) {
+    const read = async (target) => {
+        const response = await request.get(target, { maxRedirects: 0 });
+        if (response.status() !== 200)
+            throw new Error(`${target} answers ${response.status()}; a sitemap must answer 200 without redirecting.`);
+        return response.text();
+    };
+    const xml = await read(path);
+    const locations = extractSitemapLocations(xml);
+    if (!/<sitemapindex\b/i.test(xml))
+        return locations;
+    const nested = [];
+    for (const location of locations) {
+        const url = new URL(location);
+        if (origin && url.origin !== new URL(origin).origin) {
+            throw new Error(`The sitemap index lists ${location}, which is not on ${new URL(origin).origin}.`);
+        }
+        nested.push(...extractSitemapLocations(await read(`${url.pathname}${url.search}`)));
+    }
+    return nested;
+}
+export function extractSitemapLocations(xml) {
+    return [...xml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/gi)].map((match) => new URL(decodeXml(match[1])).href);
+}
+export function defaultNotFoundPaths(routes) {
+    const parents = new Set(['']);
+    for (const route of routes) {
+        const segments = normalisePath(route.path).split('/').filter(Boolean);
+        if (segments.length > 1)
+            parents.add(`/${segments.slice(0, -1).join('/')}`);
+        if (segments.length === 1)
+            parents.add(`/${segments[0]}`);
+    }
+    return [...parents].sort().map((parent) => `${parent}/${UNKNOWN_SLUG}`);
+}
+/** A Next redirect path with parameters: `:name`, `:name*`, `:name+`, `:name?` or a regular-expression group. */
+export function isRedirectPattern(path) {
+    return /:[A-Za-z_]\w*|\(/.test(path.replace(/^[a-z][a-z0-9+.-]*:\/\//i, ''));
+}
+/**
+ * The request that proves a redirect rule: a pattern gets one sample segment
+ * per parameter, in its source and destination alike. Undefined when a
+ * parameter carries its own regular expression, which no sample can satisfy
+ * with certainty.
+ */
+export function redirectProbe(rule) {
+    const sample = (path) => {
+        if (!isRedirectPattern(path))
+            return path;
+        // Keep an external destination's scheme and host; parameters live in the path.
+        const origin = /^[a-z][a-z0-9+.-]*:\/\/[^/]*/i.exec(path)?.[0] ?? '';
+        const rest = path.slice(origin.length);
+        if (rest.includes('('))
+            return undefined;
+        return `${origin}${rest.replace(/:[A-Za-z_]\w*[*+?]?/g, PATTERN_SAMPLE)}`;
+    };
+    const source = sample(rule.source);
+    const destination = sample(rule.destination);
+    if (source === undefined || destination === undefined)
+        return undefined;
+    return { source, destination, sampled: isRedirectPattern(rule.destination) };
+}
+/** A matcher for paths a pattern source redirects, for internal-link checks. */
+function redirectSourceMatcher(source) {
+    if (source.includes('('))
+        return undefined;
+    const pattern = normalisePath(source).split(/(:[A-Za-z_]\w*[*+?]?)/).map((part) => {
+        const parameter = /^:[A-Za-z_]\w*([*+?]?)$/.exec(part);
+        if (!parameter)
+            return escapeRegExp(part);
+        return parameter[1] === '*' || parameter[1] === '+' ? '.+' : parameter[1] === '?' ? '[^/]*' : '[^/]+';
+    }).join('');
+    return new RegExp(`^${pattern}$`);
+}
+/**
+ * The advisory page-quality journey: headings, title, description, og:url,
+ * implementation wording and structured-data identity for every catalogue
+ * page. It reports what it finds (page-quality.json and an annotation) and
+ * never fails, because a backend release keeps production's pages as they
+ * are; the comparison harness proves them unchanged.
+ *
+ *   // tests/e2e/page-quality.spec.ts
+ *   defineBrandlabPageQualityTests({ site, routes })
+ */
+export function defineBrandlabPageQualityTests(options) {
+    const origin = new URL(String(options.site.canonicalUrl)).origin;
+    const canonical = (path) => new URL(path, `${origin}/`).href;
+    const businessId = options.businessId ?? `${origin}/#business`;
+    const timeout = options.timeout ?? 240_000;
+    const routes = options.routes.filter((route) => normalisePath(route.path) !== NOT_FOUND_ROUTE);
+    test.describe('Brandlab page quality (advisory)', () => {
+        test('reports page and structured-data quality without failing', async ({ request }, testInfo) => {
+            test.setTimeout(timeout);
+            const findings = [];
+            await eachWithConcurrency(routes, options.concurrency ?? 8, async (route) => {
+                const response = await request.get(route.path, { maxRedirects: 0 });
+                // The estate journey owns status codes; quality is read from the pages that load.
+                if (response.status() !== 200)
+                    return;
+                const html = await response.text();
+                const snapshot = extractSearchCertificationHtmlSnapshot(html);
+                const add = (kind, detail) => findings.push({ path: route.path, kind, detail });
+                const headings = html.match(/<h1(?:\s|>)/gi)?.length ?? 0;
+                if (headings !== 1)
+                    add('headings', `${headings} h1 headings`);
+                if (!snapshot.title)
+                    add('title', 'no title');
+                if (!snapshot.description)
+                    add('description', 'no meta description');
+                const expectedCanonical = canonical(route.canonicalPath ?? route.path);
+                const ogUrl = snapshot.openGraph['og:url'];
+                if (ogUrl && new URL(ogUrl, origin).href !== expectedCanonical)
+                    add('og-url', `og:url ${ogUrl} is not the canonical URL`);
+                if (snapshot.implementationCopyMatches.length > 0)
+                    add('implementation-wording', snapshot.implementationCopyMatches.join(', '));
+                for (const failure of inspectStructuredData(route, snapshot.jsonLd, businessId)) {
+                    add('structured-data', failure.slice(route.path.length + 2));
+                }
+            });
+            findings.sort((a, b) => a.path.localeCompare(b.path) || a.kind.localeCompare(b.kind));
+            const byKind = Object.fromEntries([...new Set(findings.map((finding) => finding.kind))].sort().map((kind) => [kind, findings.filter((finding) => finding.kind === kind).length]));
+            await testInfo.attach('page-quality.json', {
+                body: JSON.stringify({ pages: routes.length, findings: findings.length, byKind, details: findings }, null, 2),
+                contentType: 'application/json',
+            });
+            testInfo.annotations.push({
+                type: 'advisory',
+                description: `${findings.length} page-quality finding(s) across ${routes.length} page(s)${findings.length ? `: ${Object.entries(byKind).map(([kind, count]) => `${kind} ${count}`).join(', ')}` : ''}; see page-quality.json.`,
+            });
+        });
+    });
+}
+function inspectStructuredData(route, payloads, businessId) {
+    const failures = [];
+    if (payloads.some((payload) => payload.parseError))
+        failures.push(`${route.path}: invalid JSON-LD`);
+    if (route.indexing === 'index' && payloads.length === 0)
+        failures.push(`${route.path}: no JSON-LD`);
+    const ids = [];
+    let referencesBusiness = false;
+    const visit = (value) => {
+        if (!value || typeof value !== 'object')
+            return;
+        if (Array.isArray(value)) {
+            value.forEach(visit);
+            return;
+        }
+        const node = value;
+        const types = [].concat(node['@type'] ?? []).map(String);
+        if (typeof node['@id'] === 'string') {
+            if (node['@id'] === businessId)
+                referencesBusiness = true;
+            if (types.length > 0)
+                ids.push(node['@id']);
+        }
+        if (businessId && types.some((type) => BUSINESS_TYPES.has(type)) && node['@id'] !== businessId) {
+            failures.push(`${route.path}: business node @id ${String(node['@id'] ?? 'missing')} (expected ${businessId})`);
+        }
+        Object.values(node).forEach(visit);
+    };
+    payloads.forEach(visit);
+    const duplicate = ids.find((id, index) => ids.indexOf(id) !== index);
+    if (duplicate)
+        failures.push(`${route.path}: JSON-LD repeats node ${duplicate}`);
+    if (businessId && route.indexing === 'index' && payloads.length > 0 && !referencesBusiness)
+        failures.push(`${route.path}: JSON-LD does not reference ${businessId}`);
+    return failures;
+}
+function extractLinks(html) {
+    return [...html.matchAll(/<a\b[^>]*\bhref=["']([^"']+)["']/gi)].map((match) => decodeXml(match[1]));
+}
+function internalPath(href, base, origin) {
+    if (/^(?:mailto|tel|sms|javascript):/i.test(href) || href.startsWith('#'))
+        return null;
+    let url;
+    try {
+        url = new URL(href, base);
+    }
+    catch {
+        return null;
+    }
+    if (url.origin !== origin && !['127.0.0.1', 'localhost'].includes(url.hostname))
+        return null;
+    if (ASSET_PATH.test(url.pathname) || url.pathname.startsWith('/api/') || url.pathname.startsWith('/_next/'))
+        return null;
+    return normalisePath(url.pathname);
+}
+function normalisePath(path) {
+    const pathname = path.split(/[?#]/)[0] || '/';
+    return pathname.length > 1 ? pathname.replace(/\/+$/, '') : '/';
+}
+/**
+ * Absolute (`https://host`) and protocol-relative (`//host`) destinations leave
+ * the site; browsers also read `/\host` and `\\host` as protocol-relative.
+ */
+export function isExternalDestination(destination) {
+    return /^(?:[a-z][a-z0-9+.-]*:)?[\\/]{2}/i.test(destination.trim());
+}
+function decodeXml(value) {
+    return value.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+async function eachWithConcurrency(items, limit, task) {
+    const queue = [...items];
+    await Promise.all(Array.from({ length: Math.max(1, Math.min(limit, queue.length)) }, async () => {
+        for (let item = queue.shift(); item !== undefined; item = queue.shift())
+            await task(item);
+    }));
+}
+//# sourceMappingURL=estate.js.map

package/dist/estate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estate.js","sourceRoot":"","sources":["../src/estate.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The shared technical-estate journey for a Brandlab production build:\n *\n *   // tests/e2e/estate.spec.ts\n *   import { defineBrandlabEstateTests } from '@brandlab-digital/conformance/estate'\n *   import { site } from '../../src/config/site'\n *   import { routes } from '../../src/data/routes'\n *   import { redirects } from '../../src/data/redirects'\n *\n *   defineBrandlabEstateTests({ site, routes, redirects })\n *\n * It asserts the estate and its routes: the sitemap, each route's status,\n * canonical and indexing, internal links, redirects, unknown slugs and\n * robots.txt. Page and structured-data quality is reported, never enforced,\n * by defineBrandlabPageQualityTests: a backend release keeps production's pages\n * as they are, which the comparison harness proves. Counts are always derived\n * from the current catalogue, never a historic constant.\n */\nimport { expect, test, type APIRequestContext } from '@playwright/test';\nimport { extractSearchCertificationHtmlSnapshot } from './search-certification.js';\n\nexport interface BrandlabEstateRoute {\n  path: string;\n  canonicalPath?: string;\n  indexing: 'index' | 'noindex-follow' | 'noindex-nofollow';\n}\n\nexport interface BrandlabEstateRedirect {\n  source: string;\n  destination: string;\n  status: 301 | 302 | 303 | 307 | 308;\n  /** Host-scoped alias rules are proved by the comparison harness host probes. */\n  host?: string;\n}\n\nexport interface BrandlabEstateTestOptions {\n  site: { canonicalUrl: string | URL };\n  /** The route catalogue. A `/404` route is Next's not-found page and must answer 404. */\n  routes: readonly BrandlabEstateRoute[];\n  /**\n   * The redirect table. A source with parameters (`/old/:slug`, `:path*`) is\n   * requested with one sample segment per parameter and checked against its\n   * destination filled in the same way; a parameter with its own regular\n   * expression cannot be sampled and is listed as skipped.\n   */\n  redirects?: readonly BrandlabEstateRedirect[];\n  /** Paths that must answer 404; defaults to one unknown slug under every catalogue parent. */\n  notFoundPaths?: readonly string[];\n  /** Also prove `<source>/` redirects straight to the destination (the shared helper emits these). */\n  trailingSlashRedirects?: boolean;\n  concurrency?: number;\n  timeout?: number;\n}\n\nexport interface BrandlabPageQualityTestOptions {\n  site: { canonicalUrl: string | URL };\n  routes: readonly BrandlabEstateRoute[];\n  /** The @id every indexable page's graph references; defaults to `<origin>/#business`, `false` skips it. */\n  businessId?: string | false;\n  concurrency?: number;\n  timeout?: number;\n}\n\nexport interface BrandlabPageQualityFinding {\n  path: string;\n  kind: 'headings' | 'title' | 'description' | 'og-url' | 'implementation-wording' | 'structured-data';\n  detail: string;\n}\n\nconst BUSINESS_TYPES = new Set([\n  'LocalBusiness', 'HomeAndConstructionBusiness', 'GeneralContractor', 'Plumber', 'Electrician',\n  'RoofingContractor', 'HousePainter', 'Locksmith', 'MovingCompany', 'HVACBusiness', 'ProfessionalService',\n]);\nconst UNKNOWN_SLUG = 'brandlab-estate-unknown-page';\nconst NOT_FOUND_ROUTE = '/404';\nconst PATTERN_SAMPLE = 'brandlab-estate-sample';\nconst ASSET_PATH = /\\.[a-z0-9]{2,5}$/i;\n\nexport function defineBrandlabEstateTests(options: BrandlabEstateTestOptions) {\n  const origin = new URL(String(options.site.canonicalUrl)).origin;\n  const canonical = (path: string) => new URL(path, `${origin}/`).href;\n  const routes = options.routes;\n  const knownPaths = new Set(routes.map((route) => normalisePath(route.path)));\n  const redirects = (options.redirects ?? []).filter((rule) => !rule.host);\n  const redirectBySource = new Map(\n    redirects.filter((rule) => !isRedirectPattern(rule.source)).map((rule) => [normalisePath(rule.source), rule]),\n  );\n  const patternRedirects = redirects.flatMap((rule) => {\n    const matcher = isRedirectPattern(rule.source) ? redirectSourceMatcher(rule.source) : undefined;\n    return matcher ? [{ rule, matcher }] : [];\n  });\n  const findRedirect = (path: string) =>\n    redirectBySource.get(path) ?? patternRedirects.find(({ matcher }) => matcher.test(path))?.rule;\n  const timeout = options.timeout ?? 240_000;\n\n  test.describe('Brandlab technical estate', () => {\n    test('the sitemap lists exactly the indexable catalogue routes', async ({ request }) => {\n      test.setTimeout(timeout);\n      const listed = await readSitemap(request, '/sitemap.xml', origin);\n      const expected = routes\n        .filter((route) => route.indexing === 'index')\n        .map((route) => canonical(route.canonicalPath ?? route.path));\n      expect(listed.length, 'the sitemap repeats a URL').toBe(new Set(listed).size);\n      expect([...listed].sort()).toEqual([...new Set(expected)].sort());\n    });\n\n    test('every catalogue route serves its canonical identity and links only to live pages', async ({ request }, testInfo) => {\n      test.setTimeout(timeout);\n      const failures: string[] = [];\n      const internalLinks = new Map<string, string>();\n      const checked: { path: string; canonical: string | null; jsonLd: number }[] = [];\n      await eachWithConcurrency(routes, options.concurrency ?? 8, async (route) => {\n        const [get, head] = await Promise.all([\n          request.get(route.path, { maxRedirects: 0 }),\n          request.head(route.path, { maxRedirects: 0 }),\n        ]);\n        // Next serves its not-found page at /404 with a 404 status.\n        const notFound = normalisePath(route.path) === NOT_FOUND_ROUTE;\n        const expectedStatus = notFound ? 404 : 200;\n        if (get.status() !== expectedStatus || head.status() !== expectedStatus) {\n          failures.push(`${route.path}: GET ${get.status()}, HEAD ${head.status()} (expected ${expectedStatus})`);\n          return;\n        }\n        const html = await get.text();\n        const snapshot = extractSearchCertificationHtmlSnapshot(html);\n        const robots = `${snapshot.robots ?? ''} ${get.headers()['x-robots-tag'] ?? ''}`;\n        if (notFound) {\n          if (!/noindex/i.test(robots)) failures.push(`${route.path}: the not-found page is indexable`);\n          checked.push({ path: route.path, canonical: snapshot.canonical, jsonLd: snapshot.jsonLd.length });\n          return;\n        }\n        const expectedCanonical = canonical(route.canonicalPath ?? route.path);\n        const canonicalTags = html.match(/<link\\b[^>]*\\brel=[\"']canonical[\"'][^>]*>/gi) ?? [];\n        if (canonicalTags.length !== 1) failures.push(`${route.path}: ${canonicalTags.length} canonical links`);\n        if (!snapshot.canonical || new URL(snapshot.canonical, origin).href !== expectedCanonical) {\n          failures.push(`${route.path}: canonical ${snapshot.canonical ?? 'missing'} (expected ${expectedCanonical})`);\n        }\n        if (route.indexing === 'index' && /noindex/i.test(robots)) failures.push(`${route.path}: indexable route is noindex`);\n        if (route.indexing !== 'index' && !/noindex/i.test(robots)) failures.push(`${route.path}: ${route.indexing} route is indexable`);\n        for (const href of extractLinks(html)) {\n          const path = internalPath(href, expectedCanonical, origin);\n          if (path && !internalLinks.has(path)) internalLinks.set(path, route.path);\n        }\n        checked.push({ path: route.path, canonical: snapshot.canonical, jsonLd: snapshot.jsonLd.length });\n      });\n      for (const [path, from] of [...internalLinks].sort()) {\n        if (knownPaths.has(path)) continue;\n        const redirect = findRedirect(path);\n        if (redirect && isExternalDestination(redirect.destination)) continue;\n        failures.push(redirect\n          ? `${from}: links to ${path}, which redirects; link to ${redirect.destination} directly`\n          : `${from}: links to ${path}, which is not a catalogue route`);\n      }\n      await testInfo.attach('technical-estate.json', {\n        body: JSON.stringify({ routes: checked.sort((a, b) => a.path.localeCompare(b.path)), internalLinks: [...internalLinks.keys()].sort() }, null, 2),\n        contentType: 'application/json',\n      });\n      expect(failures).toEqual([]);\n    });\n\n    test('every redirect resolves in one hop and keeps the query string', async ({ request }, testInfo) => {\n      test.setTimeout(timeout);\n      const failures: string[] = [];\n      const skipped: string[] = [];\n      for (const rule of redirects) {\n        const probe = redirectProbe(rule);\n        if (!probe) {\n          skipped.push(`${rule.source} → ${rule.destination}`);\n          continue;\n        }\n        const sources = [probe.source, ...(options.trailingSlashRedirects === false || probe.source === '/' || probe.source.endsWith('/') ? [] : [`${probe.source}/`])];\n        for (const source of sources) {\n          for (const method of ['GET', 'HEAD'] as const) {\n            const response = await request.fetch(`${source}?brandlab_estate=1`, { method, maxRedirects: 0 });\n            const location = response.headers().location;\n            const expectedStatus: number[] = source === probe.source ? [rule.status] : [301, 308];\n            if (!expectedStatus.includes(response.status()) || !location) {\n              failures.push(`${method} ${source}: ${response.status()} (expected ${expectedStatus.join(' or ')} to ${probe.destination})`);\n              continue;\n            }\n            const target = new URL(location, origin);\n            if (isExternalDestination(probe.destination)) {\n              if (!target.href.startsWith(new URL(probe.destination, origin).href.replace(/\\/$/, ''))) failures.push(`${method} ${source}: Location ${location} (expected ${probe.destination})`);\n              continue;\n            }\n            if (target.pathname !== new URL(probe.destination, origin).pathname) failures.push(`${method} ${source}: Location ${location} (expected ${probe.destination})`);\n            if (target.searchParams.get('brandlab_estate') !== '1') failures.push(`${method} ${source}: the query string was dropped`);\n          }\n        }\n        // A destination with parameters names many pages; the sample fills it with a page that does not exist.\n        if (!isExternalDestination(probe.destination) && !probe.sampled) {\n          const destination = await request.get(probe.destination, { maxRedirects: 0 });\n          if (destination.status() !== 200) failures.push(`${rule.source}: destination ${probe.destination} answers ${destination.status()} (a chain or a missing page)`);\n        }\n      }\n      if (skipped.length > 0) {\n        testInfo.annotations.push({ type: 'skipped-redirects', description: `${skipped.length} redirect(s) with a parameter pattern that cannot be sampled: ${skipped.join('; ')}` });\n      }\n      expect(failures).toEqual([]);\n    });\n\n    test('unknown slugs answer 404 instead of inventing pages', async ({ request }) => {\n      const paths = options.notFoundPaths ?? defaultNotFoundPaths(routes);\n      const failures: string[] = [];\n      for (const path of paths) {\n        const response = await request.get(path, { maxRedirects: 0 });\n        if (response.status() !== 404) failures.push(`${path}: ${response.status()} (expected 404)`);\n      }\n      expect(failures).toEqual([]);\n    });\n\n    test('robots.txt allows crawling and names the sitemap', async ({ request }) => {\n      const response = await request.get('/robots.txt');\n      expect(response.status()).toBe(200);\n      const body = await response.text();\n      expect(body).toMatch(new RegExp(`^sitemap:\\\\s*${escapeRegExp(`${origin}/sitemap.xml`)}\\\\s*$`, 'im'));\n      expect(body).not.toMatch(/^disallow:\\s*\\/\\s*$/im);\n    });\n  });\n}\n\n/**\n * Every `<loc>` in a sitemap, following one level of sitemap index. Nothing is\n * followed through a redirect, and with `origin` every nested sitemap must be\n * on that origin (it is then fetched from the build under test).\n */\nexport async function readSitemap(request: APIRequestContext, path: string, origin?: string): Promise<string[]> {\n  const read = async (target: string) => {\n    const response = await request.get(target, { maxRedirects: 0 });\n    if (response.status() !== 200) throw new Error(`${target} answers ${response.status()}; a sitemap must answer 200 without redirecting.`);\n    return response.text();\n  };\n  const xml = await read(path);\n  const locations = extractSitemapLocations(xml);\n  if (!/<sitemapindex\\b/i.test(xml)) return locations;\n  const nested: string[] = [];\n  for (const location of locations) {\n    const url = new URL(location);\n    if (origin && url.origin !== new URL(origin).origin) {\n      throw new Error(`The sitemap index lists ${location}, which is not on ${new URL(origin).origin}.`);\n    }\n    nested.push(...extractSitemapLocations(await read(`${url.pathname}${url.search}`)));\n  }\n  return nested;\n}\n\nexport function extractSitemapLocations(xml: string): string[] {\n  return [...xml.matchAll(/<loc>\\s*([^<\\s]+)\\s*<\\/loc>/gi)].map((match) =>\n    new URL(decodeXml(match[1]!)).href);\n}\n\nexport function defaultNotFoundPaths(routes: readonly BrandlabEstateRoute[]): string[] {\n  const parents = new Set(['']);\n  for (const route of routes) {\n    const segments = normalisePath(route.path).split('/').filter(Boolean);\n    if (segments.length > 1) parents.add(`/${segments.slice(0, -1).join('/')}`);\n    if (segments.length === 1) parents.add(`/${segments[0]}`);\n  }\n  return [...parents].sort().map((parent) => `${parent}/${UNKNOWN_SLUG}`);\n}\n\n/** A Next redirect path with parameters: `:name`, `:name*`, `:name+`, `:name?` or a regular-expression group. */\nexport function isRedirectPattern(path: string): boolean {\n  return /:[A-Za-z_]\\w*|\\(/.test(path.replace(/^[a-z][a-z0-9+.-]*:\\/\\//i, ''));\n}\n\n/**\n * The request that proves a redirect rule: a pattern gets one sample segment\n * per parameter, in its source and destination alike. Undefined when a\n * parameter carries its own regular expression, which no sample can satisfy\n * with certainty.\n */\nexport function redirectProbe(rule: Pick<BrandlabEstateRedirect, 'source' | 'destination'>): { source: string; destination: string; sampled: boolean } | undefined {\n  const sample = (path: string) => {\n    if (!isRedirectPattern(path)) return path;\n    // Keep an external destination's scheme and host; parameters live in the path.\n    const origin = /^[a-z][a-z0-9+.-]*:\\/\\/[^/]*/i.exec(path)?.[0] ?? '';\n    const rest = path.slice(origin.length);\n    if (rest.includes('(')) return undefined;\n    return `${origin}${rest.replace(/:[A-Za-z_]\\w*[*+?]?/g, PATTERN_SAMPLE)}`;\n  };\n  const source = sample(rule.source);\n  const destination = sample(rule.destination);\n  if (source === undefined || destination === undefined) return undefined;\n  return { source, destination, sampled: isRedirectPattern(rule.destination) };\n}\n\n/** A matcher for paths a pattern source redirects, for internal-link checks. */\nfunction redirectSourceMatcher(source: string): RegExp | undefined {\n  if (source.includes('(')) return undefined;\n  const pattern = normalisePath(source).split(/(:[A-Za-z_]\\w*[*+?]?)/).map((part) => {\n    const parameter = /^:[A-Za-z_]\\w*([*+?]?)$/.exec(part);\n    if (!parameter) return escapeRegExp(part);\n    return parameter[1] === '*' || parameter[1] === '+' ? '.+' : parameter[1] === '?' ? '[^/]*' : '[^/]+';\n  }).join('');\n  return new RegExp(`^${pattern}$`);\n}\n\n/**\n * The advisory page-quality journey: headings, title, description, og:url,\n * implementation wording and structured-data identity for every catalogue\n * page. It reports what it finds (page-quality.json and an annotation) and\n * never fails, because a backend release keeps production's pages as they\n * are; the comparison harness proves them unchanged.\n *\n *   // tests/e2e/page-quality.spec.ts\n *   defineBrandlabPageQualityTests({ site, routes })\n */\nexport function defineBrandlabPageQualityTests(options: BrandlabPageQualityTestOptions) {\n  const origin = new URL(String(options.site.canonicalUrl)).origin;\n  const canonical = (path: string) => new URL(path, `${origin}/`).href;\n  const businessId = options.businessId ?? `${origin}/#business`;\n  const timeout = options.timeout ?? 240_000;\n  const routes = options.routes.filter((route) => normalisePath(route.path) !== NOT_FOUND_ROUTE);\n\n  test.describe('Brandlab page quality (advisory)', () => {\n    test('reports page and structured-data quality without failing', async ({ request }, testInfo) => {\n      test.setTimeout(timeout);\n      const findings: BrandlabPageQualityFinding[] = [];\n      await eachWithConcurrency(routes, options.concurrency ?? 8, async (route) => {\n        const response = await request.get(route.path, { maxRedirects: 0 });\n        // The estate journey owns status codes; quality is read from the pages that load.\n        if (response.status() !== 200) return;\n        const html = await response.text();\n        const snapshot = extractSearchCertificationHtmlSnapshot(html);\n        const add = (kind: BrandlabPageQualityFinding['kind'], detail: string) => findings.push({ path: route.path, kind, detail });\n        const headings = html.match(/<h1(?:\\s|>)/gi)?.length ?? 0;\n        if (headings !== 1) add('headings', `${headings} h1 headings`);\n        if (!snapshot.title) add('title', 'no title');\n        if (!snapshot.description) add('description', 'no meta description');\n        const expectedCanonical = canonical(route.canonicalPath ?? route.path);\n        const ogUrl = snapshot.openGraph['og:url'];\n        if (ogUrl && new URL(ogUrl, origin).href !== expectedCanonical) add('og-url', `og:url ${ogUrl} is not the canonical URL`);\n        if (snapshot.implementationCopyMatches.length > 0) add('implementation-wording', snapshot.implementationCopyMatches.join(', '));\n        for (const failure of inspectStructuredData(route, snapshot.jsonLd, businessId)) {\n          add('structured-data', failure.slice(route.path.length + 2));\n        }\n      });\n      findings.sort((a, b) => a.path.localeCompare(b.path) || a.kind.localeCompare(b.kind));\n      const byKind = Object.fromEntries(\n        [...new Set(findings.map((finding) => finding.kind))].sort().map((kind) => [kind, findings.filter((finding) => finding.kind === kind).length]),\n      );\n      await testInfo.attach('page-quality.json', {\n        body: JSON.stringify({ pages: routes.length, findings: findings.length, byKind, details: findings }, null, 2),\n        contentType: 'application/json',\n      });\n      testInfo.annotations.push({\n        type: 'advisory',\n        description: `${findings.length} page-quality finding(s) across ${routes.length} page(s)${findings.length ? `: ${Object.entries(byKind).map(([kind, count]) => `${kind} ${count}`).join(', ')}` : ''}; see page-quality.json.`,\n      });\n    });\n  });\n}\n\nfunction inspectStructuredData(route: BrandlabEstateRoute, payloads: readonly unknown[], businessId: string | false): string[] {\n  const failures: string[] = [];\n  if (payloads.some((payload) => (payload as { parseError?: boolean }).parseError)) failures.push(`${route.path}: invalid JSON-LD`);\n  if (route.indexing === 'index' && payloads.length === 0) failures.push(`${route.path}: no JSON-LD`);\n  const ids: string[] = [];\n  let referencesBusiness = false;\n  const visit = (value: unknown) => {\n    if (!value || typeof value !== 'object') return;\n    if (Array.isArray(value)) { value.forEach(visit); return; }\n    const node = value as Record<string, unknown>;\n    const types = ([] as unknown[]).concat(node['@type'] ?? []).map(String);\n    if (typeof node['@id'] === 'string') {\n      if (node['@id'] === businessId) referencesBusiness = true;\n      if (types.length > 0) ids.push(node['@id']);\n    }\n    if (businessId && types.some((type) => BUSINESS_TYPES.has(type)) && node['@id'] !== businessId) {\n      failures.push(`${route.path}: business node @id ${String(node['@id'] ?? 'missing')} (expected ${businessId})`);\n    }\n    Object.values(node).forEach(visit);\n  };\n  payloads.forEach(visit);\n  const duplicate = ids.find((id, index) => ids.indexOf(id) !== index);\n  if (duplicate) failures.push(`${route.path}: JSON-LD repeats node ${duplicate}`);\n  if (businessId && route.indexing === 'index' && payloads.length > 0 && !referencesBusiness) failures.push(`${route.path}: JSON-LD does not reference ${businessId}`);\n  return failures;\n}\n\nfunction extractLinks(html: string): string[] {\n  return [...html.matchAll(/<a\\b[^>]*\\bhref=[\"']([^\"']+)[\"']/gi)].map((match) => decodeXml(match[1]!));\n}\n\nfunction internalPath(href: string, base: string, origin: string): string | null {\n  if (/^(?:mailto|tel|sms|javascript):/i.test(href) || href.startsWith('#')) return null;\n  let url: URL;\n  try { url = new URL(href, base); } catch { return null; }\n  if (url.origin !== origin && !['127.0.0.1', 'localhost'].includes(url.hostname)) return null;\n  if (ASSET_PATH.test(url.pathname) || url.pathname.startsWith('/api/') || url.pathname.startsWith('/_next/')) return null;\n  return normalisePath(url.pathname);\n}\n\nfunction normalisePath(path: string): string {\n  const pathname = path.split(/[?#]/)[0] || '/';\n  return pathname.length > 1 ? pathname.replace(/\\/+$/, '') : '/';\n}\n\n/**\n * Absolute (`https://host`) and protocol-relative (`//host`) destinations leave\n * the site; browsers also read `/\\host` and `\\\\host` as protocol-relative.\n */\nexport function isExternalDestination(destination: string): boolean {\n  return /^(?:[a-z][a-z0-9+.-]*:)?[\\\\/]{2}/i.test(destination.trim());\n}\n\nfunction decodeXml(value: string): string {\n  return value.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '\"').replace(/&#39;/g, \"'\");\n}\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nasync function eachWithConcurrency<T>(items: readonly T[], limit: number, task: (item: T) => Promise<void>) {\n  const queue = [...items];\n  await Promise.all(Array.from({ length: Math.max(1, Math.min(limit, queue.length)) }, async () => {\n    for (let item = queue.shift(); item !== undefined; item = queue.shift()) await task(item);\n  }));\n}\n"]}

package/dist/families-e2e.d.ts

@@ -0,0 +1,45 @@
+export interface BrandlabFamiliesTestOptions {
+    /** The route catalogue; each app route's page is the first path Next routes to it. */
+    routes: readonly {
+        path: string;
+    }[];
+    /** Pages for app routes the catalogue does not list, keyed by app route (for example `'/quote'`). */
+    samples?: Readonly<Record<string, string>>;
+    /** App routes with no page to check, each with the reason. */
+    skip?: Readonly<Record<string, string>>;
+    /** The production build directory, relative to the working directory (default `.next`). */
+    buildDir?: string;
+    /** Viewport widths (default 390 and 1440). */
+    widths?: readonly number[];
+    /** How long a document may take to load (DOMContentLoaded), default 45 seconds; a timeout is retried once. */
+    navigationTimeoutMs?: number;
+    /** How long to wait for the network to settle before checking, default 10 seconds; a busy network is not a failure. */
+    settleTimeoutMs?: number;
+}
+export interface BrandlabFamilyPage {
+    /** The app route, for example `/services/[slug]`. */
+    appRoute: string;
+    /** The page checked for it. */
+    path: string;
+    /** 200, or 404 for the not-found page. */
+    status: 200 | 404;
+}
+export declare const BRANDLAB_FAMILIES_WIDTHS: readonly number[];
+/** Page app routes from `app-path-routes-manifest.json`, without Next's internal error pages. */
+export declare function appPageRoutes(manifest: Readonly<Record<string, string>>): string[];
+/** The app route Next serves a path from, by Next's precedence: static, then dynamic, then catch-all. */
+export declare function resolveAppRoute(appRoutes: readonly string[], path: string): string | undefined;
+/** One page per app route, and every reason the plan cannot cover the build. */
+export declare function planBrandlabFamilyPages(input: {
+    manifest: Readonly<Record<string, string>>;
+    routes: readonly {
+        path: string;
+    }[];
+    samples?: Readonly<Record<string, string>>;
+    skip?: Readonly<Record<string, string>>;
+}): {
+    pages: BrandlabFamilyPage[];
+    problems: string[];
+};
+export declare function defineBrandlabFamiliesTests(options: BrandlabFamiliesTestOptions): void;
+//# sourceMappingURL=families-e2e.d.ts.map

package/dist/families-e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"families-e2e.d.ts","sourceRoot":"","sources":["../src/families-e2e.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,2BAA2B;IAC1C,sFAAsF;IACtF,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpC,qGAAqG;IACrG,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,8DAA8D;IAC9D,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,8GAA8G;IAC9G,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uHAAuH;IACvH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;CACnB;AAED,eAAO,MAAM,wBAAwB,mBAA6B,CAAC;AA+CnE,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAQlF;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ9F;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACzC,GAAG;IAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsCtD;AA4CD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,2BAA2B,QA4E/E"}