@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/enquiry/t11-licence-classes.js

@@ -0,0 +1,275 @@
+/**
+ * T11: no page for work outside the licence classes the business holds, and the licence conditions carried
+ * (Site System v2 §8.1, §13.2).
+ *
+ * Two things are read from the project:
+ * - the licences in the evidence data (`src/data/businessEvidence.ts`, then `src/data/business.ts`), read as plain
+ *   data without running the site: `BrandlabLicence` classes, conditions and expiry;
+ * - `docs/service-classes.json`, the service-to-class map: for each service the site publishes a page for, the
+ *   licence classes that cover it and the value above which the work needs a licence.
+ *
+ * A service whose work needs a licence is covered when a current licence holds one of its classes. An expired
+ * licence covers nothing. A class condition that caps the job value (the Home Building Compensation limit of
+ * $20,000, or any "up to $N") caps the price bands the service page may show. The rule is not applicable only when
+ * it genuinely does not apply: the evidence is readable and records no licence (and there is no map), or no service
+ * on the map needs a licence. When it cannot tell (licences on record but no map, or licence data it cannot read)
+ * it returns no finding, so the check shows as not run rather than guess.
+ *
+ * `readLicences` is also the licence reader for T3, so the two checks always agree on what the business holds.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { licenceRenderState } from "@brandlab-digital/site-core/business";
+import { fail, normalisePath, notApplicable, plural, resultOf } from "./common.js";
+import { priceFigures } from "./e9-cost-guides.js";
+import { attr, descendants } from "./html.js";
+import { LiteralReader, isFullyResolved, isLiteralObject } from "./literal.js";
+export const T11_SERVICE_CLASS_MAP = "docs/service-classes.json";
+export const T11_LICENCE_FILES = ["src/data/businessEvidence.ts", "src/data/business.ts"];
+/** The Home Building Compensation threshold: a condition that names HBC without an amount caps the job at this. */
+export const T11_HBC_CAP = 20_000;
+function readStringArray(value) {
+    if (value === undefined)
+        return [];
+    return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : null;
+}
+function toHeldLicence(value) {
+    if (!isLiteralObject(value) || typeof value["name"] !== "string" || typeof value["identifier"] !== "string")
+        return null;
+    const rawClasses = value["classes"];
+    let classes;
+    if (rawClasses === undefined) {
+        // A licence recorded before 3.8.0 names its work in `name`.
+        classes = [{ name: value["name"], conditions: [] }];
+    }
+    else if (Array.isArray(rawClasses)) {
+        classes = [];
+        for (const item of rawClasses) {
+            if (!isLiteralObject(item) || typeof item["name"] !== "string")
+                return null;
+            const conditions = readStringArray(item["conditions"]);
+            if (conditions === null)
+                return null;
+            classes.push({ name: item["name"], conditions });
+        }
+    }
+    else {
+        return null;
+    }
+    const optional = (key) => (typeof value[key] === "string" && value[key] !== "" ? value[key] : undefined);
+    const jurisdiction = optional("jurisdiction");
+    const licensee = optional("licensee") ?? optional("holder");
+    const expiresOn = optional("expiresOn");
+    const checkedOn = optional("checkedOn");
+    return {
+        name: value["name"],
+        identifier: value["identifier"],
+        ...(jurisdiction ? { jurisdiction } : {}),
+        ...(licensee ? { licensee } : {}),
+        classes,
+        ...(expiresOn ? { expiresOn } : {}),
+        ...(checkedOn ? { checkedOn } : {}),
+    };
+}
+/** Reads the licences from the evidence data files without running them. */
+export function readLicences(projectRoot) {
+    let unreadable = null;
+    for (const file of T11_LICENCE_FILES) {
+        const path = join(projectRoot, file);
+        if (!existsSync(path))
+            continue;
+        const reader = new LiteralReader(readFileSync(path, "utf8"), file);
+        for (const expression of reader.propertyValues("licences")) {
+            let value = reader.evaluate(expression);
+            if (isLiteralObject(value) && typeof value["status"] === "string") {
+                if (value["status"] === "unknown" || value["status"] === "not-applicable")
+                    return { status: "none", file };
+                value = (value["value"] ?? null);
+            }
+            if (!Array.isArray(value))
+                continue;
+            if (!isFullyResolved(value)) {
+                unreadable = `${file} lists licences that are not plain data.`;
+                continue;
+            }
+            const licences = value.map(toHeldLicence);
+            if (licences.some((licence) => licence === null)) {
+                unreadable = `${file} lists a licence without a name and number.`;
+                continue;
+            }
+            return licences.length === 0 ? { status: "none", file } : { status: "found", licences: licences, file };
+        }
+    }
+    return { status: "unreadable", reason: unreadable ?? "No licence data was found in the evidence files." };
+}
+/** Reads the service-to-class map. Returns null when it does not exist and a string when it cannot be read. */
+export function readServiceClassMap(projectRoot) {
+    const file = join(projectRoot, T11_SERVICE_CLASS_MAP);
+    if (!existsSync(file))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        return `${T11_SERVICE_CLASS_MAP} is not valid JSON.`;
+    }
+    const services = parsed?.services;
+    if (!Array.isArray(services))
+        return `${T11_SERVICE_CLASS_MAP} must be an object with a "services" list.`;
+    const entries = [];
+    for (const [index, service] of services.entries()) {
+        const entry = service;
+        const where = `${T11_SERVICE_CLASS_MAP} services[${index}]`;
+        if (!entry || typeof entry !== "object")
+            return `${where} must be an object.`;
+        if (typeof entry["path"] !== "string" || !entry["path"].startsWith("/"))
+            return `${where} needs a "path" that starts with "/".`;
+        if (typeof entry["name"] !== "string" || !entry["name"].trim())
+            return `${where} needs a "name".`;
+        const classes = entry["classes"];
+        if (!Array.isArray(classes) || !classes.every((item) => typeof item === "string" && item.trim())) {
+            return `${where} needs "classes": a list of licence class names, empty when the work needs no licence.`;
+        }
+        for (const key of ["licenceAbove", "jobValueMax"]) {
+            const value = entry[key];
+            if (value !== undefined && (typeof value !== "number" || !Number.isFinite(value) || value < 0)) {
+                return `${where} has a "${key}" that is not a dollar amount.`;
+            }
+        }
+        entries.push({
+            path: normalisePath(entry["path"]),
+            name: entry["name"],
+            classes: classes,
+            licenceAbove: entry["licenceAbove"] ?? 0,
+            ...(typeof entry["jobValueMax"] === "number" ? { jobValueMax: entry["jobValueMax"] } : {}),
+        });
+    }
+    return entries;
+}
+/** Whether a licence has expired on `asOf` (today in Sydney is after its expiry date), by site-core's licenceRenderState. */
+export function isExpired(licence, asOf) {
+    return licenceRenderState(licence.expiresOn === undefined ? {} : { expiresOn: licence.expiresOn }, asOf).state === "expired";
+}
+const CAP_PHRASE = /(?:up\s+to|under|below|less\s+than|not\s+(?:exceeding|more\s+than|over)|no\s+more\s+than|(?:work|jobs?)\s+(?:valued\s+)?(?:over|above|exceeding)|limit(?:ed)?(?:\s+(?:to|of))?|cap(?:ped)?(?:\s+(?:at|of))?|maximum(?:\s+(?:of|value))?|max\.?)[^$\d]{0,60}\$\s?(\d{1,3}(?:,\d{3})+|\d+)/gi;
+/**
+ * The job value a class's conditions cap the work at, or null when they set no cap. A condition that says "up to",
+ * "limited to", "not exceeding" and the like before a dollar amount sets that cap. One that names Home Building
+ * Compensation (HBC) without an amount sets the HBC threshold.
+ */
+export function licenceConditionCap(conditions) {
+    const caps = [];
+    for (const condition of conditions) {
+        const amounts = [...condition.matchAll(CAP_PHRASE)].map((match) => Number(match[1].replace(/,/g, "")));
+        if (amounts.length > 0)
+            caps.push(...amounts);
+        else if (/\bhbc\b|home\s+building\s+compensation/i.test(condition))
+            caps.push(T11_HBC_CAP);
+    }
+    return caps.length > 0 ? Math.min(...caps) : null;
+}
+export function serviceNeedsLicence(service) {
+    if (service.classes.length === 0)
+        return false;
+    return !(service.jobValueMax !== undefined && service.jobValueMax <= service.licenceAbove);
+}
+function sameClass(left, right) {
+    return left.trim().toLowerCase() === right.trim().toLowerCase();
+}
+/** Judges each service that needs a licence against the licences held on `asOf`. Pure. */
+export function evaluateServiceClassGate(services, licences, asOf) {
+    return services.filter(serviceNeedsLicence).map((service) => {
+        const covering = licences.flatMap((licence) => licence.classes
+            .filter((heldClass) => service.classes.some((required) => sameClass(required, heldClass.name)))
+            .map((heldClass) => ({ licence, heldClass })));
+        const current = covering.filter(({ licence }) => !isExpired(licence, asOf));
+        if (current.length === 0) {
+            const lapsed = covering[0];
+            const problem = lapsed
+                ? `its licence ${lapsed.licence.identifier} (${lapsed.heldClass.name}) expired on ${lapsed.licence.expiresOn}`
+                : `no licence on record holds ${service.classes.length === 1 ? "the class" : "any of the classes"} ${service.classes.map((name) => `"${name}"`).join(" or ")}`;
+            return { service, cap: null, problem };
+        }
+        const caps = current.map(({ heldClass }) => licenceConditionCap(heldClass.conditions));
+        // One covering class with no cap means the service is not capped.
+        const cap = caps.some((value) => value === null) ? null : Math.max(...caps);
+        const first = current[0];
+        return { service, coveredBy: { licence: first.licence, className: first.heldClass.name }, cap };
+    });
+}
+/** `price`, `lowPrice` and `highPrice` values in a page's JSON-LD (the Offer data), as numbers. */
+export function structuredDataPrices(root) {
+    const prices = [];
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            value.forEach(visit);
+        }
+        else if (value && typeof value === "object") {
+            for (const [key, child] of Object.entries(value)) {
+                if (["price", "lowPrice", "highPrice"].includes(key)) {
+                    const amount = Number(String(child).replace(/[$,\s]/g, ""));
+                    if (Number.isFinite(amount))
+                        prices.push(amount);
+                }
+                else {
+                    visit(child);
+                }
+            }
+        }
+    };
+    for (const script of descendants(root).filter((element) => element.tag === "script" && attr(element, "type") === "application/ld+json")) {
+        try {
+            visit(JSON.parse(script.children.map((child) => (child.type === "text" ? child.text : "")).join("")));
+        }
+        catch {
+            // A block that is not valid JSON has no prices to read.
+        }
+    }
+    return prices;
+}
+function dollars(amount) {
+    return `$${amount.toLocaleString("en-AU")}`;
+}
+export function checkT11(pages, projectRoot, asOf) {
+    const map = readServiceClassMap(projectRoot);
+    if (typeof map === "string")
+        return [fail("T11", T11_SERVICE_CLASS_MAP, map)];
+    const read = readLicences(projectRoot);
+    if (map === null) {
+        if (read.status === "none") {
+            return [notApplicable("T11", `${read.file} records no licence and the site has no ${T11_SERVICE_CLASS_MAP}, so no page advertises licensed work.`)];
+        }
+        // Licences on record (or licence data that cannot be read) without the map: the check cannot run.
+        return [];
+    }
+    const gated = map.filter(serviceNeedsLicence);
+    if (gated.length === 0)
+        return [notApplicable("T11", "None of the services on the service-to-class map needs a licence.")];
+    // Licence data that exists but cannot be read is not a pass: no finding, so the check shows as not run.
+    if (read.status === "unreadable")
+        return [];
+    const licences = read.status === "found" ? read.licences : [];
+    const failures = [];
+    for (const result of evaluateServiceClassGate(map, licences, asOf)) {
+        const { service } = result;
+        if (result.problem) {
+            failures.push(fail("T11", service.path, `${service.path} has a page for ${service.name}, but ${result.problem}; the page is held until the class is held.`));
+            continue;
+        }
+        if (result.cap === null)
+            continue;
+        const via = `the "${result.coveredBy.className}" licence ${result.coveredBy.licence.identifier}`;
+        if (service.jobValueMax !== undefined && service.jobValueMax > result.cap) {
+            failures.push(fail("T11", service.path, `${service.path} advertises ${service.name} jobs up to ${dollars(service.jobValueMax)}, above the ${dollars(result.cap)} limit on ${via}.`));
+        }
+        const page = pages.find((candidate) => candidate.path === service.path);
+        if (page) {
+            const shown = [...priceFigures(page.root), ...structuredDataPrices(page.root)].filter((amount) => amount > result.cap);
+            if (shown.length > 0) {
+                failures.push(fail("T11", service.path, `${service.path} shows a price of ${dollars(Math.max(...shown))}, above the ${dollars(result.cap)} limit on ${via}.`));
+            }
+        }
+    }
+    return resultOf("T11", failures, `Checked ${plural(gated.length, "service")} that need a licence: each is covered by a current class, and no price is above a licence limit.`);
+}
+//# sourceMappingURL=t11-licence-classes.js.map

package/dist/site-system/rules/enquiry/t11-licence-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t11-licence-classes.js","sourceRoot":"","sources":["../../../../src/site-system/rules/enquiry/t11-licence-classes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * T11: no page for work outside the licence classes the business holds, and the licence conditions carried\n * (Site System v2 §8.1, §13.2).\n *\n * Two things are read from the project:\n * - the licences in the evidence data (`src/data/businessEvidence.ts`, then `src/data/business.ts`), read as plain\n *   data without running the site: `BrandlabLicence` classes, conditions and expiry;\n * - `docs/service-classes.json`, the service-to-class map: for each service the site publishes a page for, the\n *   licence classes that cover it and the value above which the work needs a licence.\n *\n * A service whose work needs a licence is covered when a current licence holds one of its classes. An expired\n * licence covers nothing. A class condition that caps the job value (the Home Building Compensation limit of\n * $20,000, or any \"up to $N\") caps the price bands the service page may show. The rule is not applicable only when\n * it genuinely does not apply: the evidence is readable and records no licence (and there is no map), or no service\n * on the map needs a licence. When it cannot tell (licences on record but no map, or licence data it cannot read)\n * it returns no finding, so the check shows as not run rather than guess.\n *\n * `readLicences` is also the licence reader for T3, so the two checks always agree on what the business holds.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { licenceRenderState } from \"@brandlab-digital/site-core/business\";\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, normalisePath, notApplicable, plural, resultOf, type ParsedPage } from \"./common.js\";\nimport { priceFigures } from \"./e9-cost-guides.js\";\nimport { attr, descendants, type HtmlElement } from \"./html.js\";\nimport { LiteralReader, isFullyResolved, isLiteralObject, type Literal } from \"./literal.js\";\n\nexport const T11_SERVICE_CLASS_MAP = \"docs/service-classes.json\";\nexport const T11_LICENCE_FILES = [\"src/data/businessEvidence.ts\", \"src/data/business.ts\"] as const;\n\n/** The Home Building Compensation threshold: a condition that names HBC without an amount caps the job at this. */\nexport const T11_HBC_CAP = 20_000;\n\nexport interface HeldLicenceClass {\n  name: string;\n  conditions: readonly string[];\n}\n\nexport interface HeldLicence {\n  name: string;\n  identifier: string;\n  jurisdiction?: string;\n  /** The licensee (`licensee`, or a legacy `holder`), shown beside the number when it differs from the trading name. */\n  licensee?: string;\n  classes: readonly HeldLicenceClass[];\n  expiresOn?: string;\n  checkedOn?: string;\n}\n\nexport interface ServiceClassEntry {\n  path: string;\n  name: string;\n  /** Licence classes that cover the service. Any one is enough. Empty when the work needs no licence. */\n  classes: readonly string[];\n  /** The job value above which the work needs a licence. 0 (the default) means any value. */\n  licenceAbove: number;\n  /** The largest job the page advertises, when the site records it. */\n  jobValueMax?: number;\n}\n\nexport type LicenceRead =\n  | { status: \"found\"; licences: HeldLicence[]; file: string }\n  | { status: \"none\"; file: string }\n  | { status: \"unreadable\"; reason: string };\n\nfunction readStringArray(value: Literal | undefined): string[] | null {\n  if (value === undefined) return [];\n  return Array.isArray(value) && value.every((item): item is string => typeof item === \"string\") ? value : null;\n}\n\nfunction toHeldLicence(value: Literal): HeldLicence | null {\n  if (!isLiteralObject(value) || typeof value[\"name\"] !== \"string\" || typeof value[\"identifier\"] !== \"string\") return null;\n  const rawClasses = value[\"classes\"];\n  let classes: HeldLicenceClass[];\n  if (rawClasses === undefined) {\n    // A licence recorded before 3.8.0 names its work in `name`.\n    classes = [{ name: value[\"name\"], conditions: [] }];\n  } else if (Array.isArray(rawClasses)) {\n    classes = [];\n    for (const item of rawClasses) {\n      if (!isLiteralObject(item) || typeof item[\"name\"] !== \"string\") return null;\n      const conditions = readStringArray(item[\"conditions\"]);\n      if (conditions === null) return null;\n      classes.push({ name: item[\"name\"], conditions });\n    }\n  } else {\n    return null;\n  }\n  const optional = (key: string): string | undefined => (typeof value[key] === \"string\" && value[key] !== \"\" ? (value[key] as string) : undefined);\n  const jurisdiction = optional(\"jurisdiction\");\n  const licensee = optional(\"licensee\") ?? optional(\"holder\");\n  const expiresOn = optional(\"expiresOn\");\n  const checkedOn = optional(\"checkedOn\");\n  return {\n    name: value[\"name\"],\n    identifier: value[\"identifier\"],\n    ...(jurisdiction ? { jurisdiction } : {}),\n    ...(licensee ? { licensee } : {}),\n    classes,\n    ...(expiresOn ? { expiresOn } : {}),\n    ...(checkedOn ? { checkedOn } : {}),\n  };\n}\n\n/** Reads the licences from the evidence data files without running them. */\nexport function readLicences(projectRoot: string): LicenceRead {\n  let unreadable: string | null = null;\n  for (const file of T11_LICENCE_FILES) {\n    const path = join(projectRoot, file);\n    if (!existsSync(path)) continue;\n    const reader = new LiteralReader(readFileSync(path, \"utf8\"), file);\n    for (const expression of reader.propertyValues(\"licences\")) {\n      let value = reader.evaluate(expression);\n      if (isLiteralObject(value) && typeof value[\"status\"] === \"string\") {\n        if (value[\"status\"] === \"unknown\" || value[\"status\"] === \"not-applicable\") return { status: \"none\", file };\n        value = (value[\"value\"] ?? null) as Literal;\n      }\n      if (!Array.isArray(value)) continue;\n      if (!isFullyResolved(value)) {\n        unreadable = `${file} lists licences that are not plain data.`;\n        continue;\n      }\n      const licences = value.map(toHeldLicence);\n      if (licences.some((licence) => licence === null)) {\n        unreadable = `${file} lists a licence without a name and number.`;\n        continue;\n      }\n      return licences.length === 0 ? { status: \"none\", file } : { status: \"found\", licences: licences as HeldLicence[], file };\n    }\n  }\n  return { status: \"unreadable\", reason: unreadable ?? \"No licence data was found in the evidence files.\" };\n}\n\n/** Reads the service-to-class map. Returns null when it does not exist and a string when it cannot be read. */\nexport function readServiceClassMap(projectRoot: string): ServiceClassEntry[] | string | null {\n  const file = join(projectRoot, T11_SERVICE_CLASS_MAP);\n  if (!existsSync(file)) return null;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(readFileSync(file, \"utf8\"));\n  } catch {\n    return `${T11_SERVICE_CLASS_MAP} is not valid JSON.`;\n  }\n  const services = (parsed as { services?: unknown } | null)?.services;\n  if (!Array.isArray(services)) return `${T11_SERVICE_CLASS_MAP} must be an object with a \"services\" list.`;\n  const entries: ServiceClassEntry[] = [];\n  for (const [index, service] of services.entries()) {\n    const entry = service as Record<string, unknown> | null;\n    const where = `${T11_SERVICE_CLASS_MAP} services[${index}]`;\n    if (!entry || typeof entry !== \"object\") return `${where} must be an object.`;\n    if (typeof entry[\"path\"] !== \"string\" || !entry[\"path\"].startsWith(\"/\")) return `${where} needs a \"path\" that starts with \"/\".`;\n    if (typeof entry[\"name\"] !== \"string\" || !entry[\"name\"].trim()) return `${where} needs a \"name\".`;\n    const classes = entry[\"classes\"];\n    if (!Array.isArray(classes) || !classes.every((item) => typeof item === \"string\" && item.trim())) {\n      return `${where} needs \"classes\": a list of licence class names, empty when the work needs no licence.`;\n    }\n    for (const key of [\"licenceAbove\", \"jobValueMax\"] as const) {\n      const value = entry[key];\n      if (value !== undefined && (typeof value !== \"number\" || !Number.isFinite(value) || value < 0)) {\n        return `${where} has a \"${key}\" that is not a dollar amount.`;\n      }\n    }\n    entries.push({\n      path: normalisePath(entry[\"path\"]),\n      name: entry[\"name\"],\n      classes: classes as string[],\n      licenceAbove: (entry[\"licenceAbove\"] as number | undefined) ?? 0,\n      ...(typeof entry[\"jobValueMax\"] === \"number\" ? { jobValueMax: entry[\"jobValueMax\"] } : {}),\n    });\n  }\n  return entries;\n}\n\n/** Whether a licence has expired on `asOf` (today in Sydney is after its expiry date), by site-core's licenceRenderState. */\nexport function isExpired(licence: Pick<HeldLicence, \"expiresOn\">, asOf: Date): boolean {\n  return licenceRenderState(licence.expiresOn === undefined ? {} : { expiresOn: licence.expiresOn }, asOf).state === \"expired\";\n}\n\nconst CAP_PHRASE =\n  /(?:up\\s+to|under|below|less\\s+than|not\\s+(?:exceeding|more\\s+than|over)|no\\s+more\\s+than|(?:work|jobs?)\\s+(?:valued\\s+)?(?:over|above|exceeding)|limit(?:ed)?(?:\\s+(?:to|of))?|cap(?:ped)?(?:\\s+(?:at|of))?|maximum(?:\\s+(?:of|value))?|max\\.?)[^$\\d]{0,60}\\$\\s?(\\d{1,3}(?:,\\d{3})+|\\d+)/gi;\n\n/**\n * The job value a class's conditions cap the work at, or null when they set no cap. A condition that says \"up to\",\n * \"limited to\", \"not exceeding\" and the like before a dollar amount sets that cap. One that names Home Building\n * Compensation (HBC) without an amount sets the HBC threshold.\n */\nexport function licenceConditionCap(conditions: readonly string[]): number | null {\n  const caps: number[] = [];\n  for (const condition of conditions) {\n    const amounts = [...condition.matchAll(CAP_PHRASE)].map((match) => Number(match[1]!.replace(/,/g, \"\")));\n    if (amounts.length > 0) caps.push(...amounts);\n    else if (/\\bhbc\\b|home\\s+building\\s+compensation/i.test(condition)) caps.push(T11_HBC_CAP);\n  }\n  return caps.length > 0 ? Math.min(...caps) : null;\n}\n\nexport function serviceNeedsLicence(service: ServiceClassEntry): boolean {\n  if (service.classes.length === 0) return false;\n  return !(service.jobValueMax !== undefined && service.jobValueMax <= service.licenceAbove);\n}\n\nfunction sameClass(left: string, right: string): boolean {\n  return left.trim().toLowerCase() === right.trim().toLowerCase();\n}\n\nexport interface ServiceGateResult {\n  service: ServiceClassEntry;\n  /** Set when the service is covered by a current licence class. */\n  coveredBy?: { licence: HeldLicence; className: string };\n  /** The dollar cap the covering class's conditions set, when they set one. */\n  cap: number | null;\n  /** Why the service is not covered, in plain words. */\n  problem?: string;\n}\n\n/** Judges each service that needs a licence against the licences held on `asOf`. Pure. */\nexport function evaluateServiceClassGate(\n  services: readonly ServiceClassEntry[],\n  licences: readonly HeldLicence[],\n  asOf: Date,\n): ServiceGateResult[] {\n  return services.filter(serviceNeedsLicence).map((service): ServiceGateResult => {\n    const covering = licences.flatMap((licence) =>\n      licence.classes\n        .filter((heldClass) => service.classes.some((required) => sameClass(required, heldClass.name)))\n        .map((heldClass) => ({ licence, heldClass })),\n    );\n    const current = covering.filter(({ licence }) => !isExpired(licence, asOf));\n    if (current.length === 0) {\n      const lapsed = covering[0];\n      const problem = lapsed\n        ? `its licence ${lapsed.licence.identifier} (${lapsed.heldClass.name}) expired on ${lapsed.licence.expiresOn}`\n        : `no licence on record holds ${service.classes.length === 1 ? \"the class\" : \"any of the classes\"} ${service.classes.map((name) => `\"${name}\"`).join(\" or \")}`;\n      return { service, cap: null, problem };\n    }\n    const caps = current.map(({ heldClass }) => licenceConditionCap(heldClass.conditions));\n    // One covering class with no cap means the service is not capped.\n    const cap = caps.some((value) => value === null) ? null : Math.max(...(caps as number[]));\n    const first = current[0]!;\n    return { service, coveredBy: { licence: first.licence, className: first.heldClass.name }, cap };\n  });\n}\n\n/** `price`, `lowPrice` and `highPrice` values in a page's JSON-LD (the Offer data), as numbers. */\nexport function structuredDataPrices(root: HtmlElement): number[] {\n  const prices: number[] = [];\n  const visit = (value: unknown) => {\n    if (Array.isArray(value)) {\n      value.forEach(visit);\n    } else if (value && typeof value === \"object\") {\n      for (const [key, child] of Object.entries(value)) {\n        if ([\"price\", \"lowPrice\", \"highPrice\"].includes(key)) {\n          const amount = Number(String(child).replace(/[$,\\s]/g, \"\"));\n          if (Number.isFinite(amount)) prices.push(amount);\n        } else {\n          visit(child);\n        }\n      }\n    }\n  };\n  for (const script of descendants(root).filter((element) => element.tag === \"script\" && attr(element, \"type\") === \"application/ld+json\")) {\n    try {\n      visit(JSON.parse(script.children.map((child) => (child.type === \"text\" ? child.text : \"\")).join(\"\")));\n    } catch {\n      // A block that is not valid JSON has no prices to read.\n    }\n  }\n  return prices;\n}\n\nfunction dollars(amount: number): string {\n  return `$${amount.toLocaleString(\"en-AU\")}`;\n}\n\nexport function checkT11(pages: readonly ParsedPage[], projectRoot: string, asOf: Date): SiteSystemFinding[] {\n  const map = readServiceClassMap(projectRoot);\n  if (typeof map === \"string\") return [fail(\"T11\", T11_SERVICE_CLASS_MAP, map)];\n  const read = readLicences(projectRoot);\n  if (map === null) {\n    if (read.status === \"none\") {\n      return [notApplicable(\"T11\", `${read.file} records no licence and the site has no ${T11_SERVICE_CLASS_MAP}, so no page advertises licensed work.`)];\n    }\n    // Licences on record (or licence data that cannot be read) without the map: the check cannot run.\n    return [];\n  }\n\n  const gated = map.filter(serviceNeedsLicence);\n  if (gated.length === 0) return [notApplicable(\"T11\", \"None of the services on the service-to-class map needs a licence.\")];\n  // Licence data that exists but cannot be read is not a pass: no finding, so the check shows as not run.\n  if (read.status === \"unreadable\") return [];\n  const licences = read.status === \"found\" ? read.licences : [];\n\n  const failures: SiteSystemFinding[] = [];\n  for (const result of evaluateServiceClassGate(map, licences, asOf)) {\n    const { service } = result;\n    if (result.problem) {\n      failures.push(fail(\"T11\", service.path, `${service.path} has a page for ${service.name}, but ${result.problem}; the page is held until the class is held.`));\n      continue;\n    }\n    if (result.cap === null) continue;\n    const via = `the \"${result.coveredBy!.className}\" licence ${result.coveredBy!.licence.identifier}`;\n    if (service.jobValueMax !== undefined && service.jobValueMax > result.cap) {\n      failures.push(fail(\"T11\", service.path, `${service.path} advertises ${service.name} jobs up to ${dollars(service.jobValueMax)}, above the ${dollars(result.cap)} limit on ${via}.`));\n    }\n    const page = pages.find((candidate) => candidate.path === service.path);\n    if (page) {\n      const shown = [...priceFigures(page.root), ...structuredDataPrices(page.root)].filter((amount) => amount > result.cap!);\n      if (shown.length > 0) {\n        failures.push(fail(\"T11\", service.path, `${service.path} shows a price of ${dollars(Math.max(...shown))}, above the ${dollars(result.cap)} limit on ${via}.`));\n      }\n    }\n  }\n  return resultOf(\n    \"T11\",\n    failures,\n    `Checked ${plural(gated.length, \"service\")} that need a licence: each is covered by a current class, and no price is above a licence limit.`,\n  );\n}\n"]}

package/dist/site-system/rules/enquiry/t5-reviews.d.ts

@@ -0,0 +1,23 @@
+/**
+ * T5: reviews come from the Google feed, with Google's rating, count and link beside any list (Site System v2 §13.2).
+ *
+ * A reviews section (`data-bl-section="reviews"`) shows the feed's summary rating, its review count and a link to
+ * Google beside any reviews it lists. There is no reviews section on the contact page, and no empty one. The rule has
+ * no exclusion clause: it judges what the feed rendered, and the library does not hide or tag reviews (D6).
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "./common.js";
+import { type HtmlElement } from "./html.js";
+export declare const T5_SECTION_ID = "reviews";
+export declare function isContactPath(path: string): boolean;
+export declare function isGoogleLink(href: string): boolean;
+export interface ReviewsSectionReport {
+    entries: number;
+    hasRating: boolean;
+    hasCount: boolean;
+    hasGoogleLink: boolean;
+    source: string | undefined;
+}
+export declare function inspectReviewsSection(section: HtmlElement): ReviewsSectionReport;
+export declare function checkT5(pages: readonly ParsedPage[]): SiteSystemFinding[];
+//# sourceMappingURL=t5-reviews.d.ts.map

package/dist/site-system/rules/enquiry/t5-reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t5-reviews.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/enquiry/t5-reviews.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAoD,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAExE,eAAO,MAAM,aAAa,YAAY,CAAC;AAMvC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMlD;AAkCD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,oBAAoB,CAWhF;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,iBAAiB,EAAE,CA+BzE"}

package/dist/site-system/rules/enquiry/t5-reviews.js

@@ -0,0 +1,91 @@
+import { fail, notApplicable, plural, resultOf, sectionId } from "./common.js";
+import { attr, descendants, textOf } from "./html.js";
+export const T5_SECTION_ID = "reviews";
+/** Pages that never carry reviews: the contact page, and any thank-you page (`/thank-you`, `/contact/thank-you`). */
+const CONTACT_PATH = /^\/(?:contact|contact-us|get-in-touch)(?:\/|$)/;
+const THANK_YOU_PATH = /(?:^|\/)(?:thank-you|thankyou|thanks)(?:\/|$)/;
+export function isContactPath(path) {
+    return CONTACT_PATH.test(path) || THANK_YOU_PATH.test(path);
+}
+const GOOGLE_HOST = /^(?:[a-z0-9-]+\.)*(?:google\.(?:com(?:\.au)?|co\.[a-z]{2})|g\.page|g\.co|goo\.gl|share\.google)$/i;
+export function isGoogleLink(href) {
+    try {
+        return GOOGLE_HOST.test(new URL(href, "https://page.invalid").hostname);
+    }
+    catch {
+        return false;
+    }
+}
+const RATING = /(?:\b[1-5](?:\.\d)?\s*(?:\/\s*5\b|out\s+of\s+5\b|stars?\b|★)|\brated\s+[1-5](?:\.\d)?\b|\b[1-5]\.\d\b|★\s*[1-5](?:\.\d)?\b)/i;
+const COUNT = /\b\d[\d,]*\s*(?:google\s+)?reviews?\b|\bbased\s+on\s+\d[\d,]*\b|\b\d[\d,]*\s+ratings?\b/i;
+function isReviewBody(element) {
+    return (attr(element, "data-slot") ?? "").split(/\s+/).includes("review") || element.tag === "blockquote" || element.tag === "article";
+}
+/** The reviews listed in a section: review slots, quotes and articles. */
+function listedReviews(section) {
+    return descendants(section).filter(isReviewBody);
+}
+function insideReviewBody(element, section) {
+    for (let parent = element; parent && parent !== section; parent = parent.parent) {
+        if (isReviewBody(parent))
+            return true;
+    }
+    return false;
+}
+/**
+ * The section's text plus the accessible names in it, where a star rating often keeps its number, leaving out the
+ * listed reviews themselves: a review that says "5 stars" or "after 20 reviews" is not Google's rating or count.
+ */
+function summaryText(section) {
+    const names = descendants(section)
+        .filter((element) => !insideReviewBody(element, section))
+        .map((element) => attr(element, "aria-label") ?? attr(element, "title") ?? "")
+        .filter(Boolean);
+    return `${textOf(section, true, isReviewBody)} ${names.join(" ")}`;
+}
+export function inspectReviewsSection(section) {
+    const text = summaryText(section);
+    const outside = descendants(section).filter((element) => !insideReviewBody(element, section));
+    const countSlot = outside.find((element) => attr(element, "data-slot") === "count");
+    return {
+        entries: listedReviews(section).length,
+        hasRating: RATING.test(text),
+        hasCount: COUNT.test(text) || (countSlot !== undefined && /\d/.test(textOf(countSlot, true))),
+        hasGoogleLink: outside.some((element) => element.tag === "a" && isGoogleLink(attr(element, "href") ?? "")),
+        source: attr(section, "data-bl-source"),
+    };
+}
+export function checkT5(pages) {
+    const failures = [];
+    let sections = 0;
+    for (const page of pages) {
+        // Every reviews section counts, including one nested inside another section.
+        for (const section of descendants(page.root).filter((candidate) => sectionId(candidate) === T5_SECTION_ID)) {
+            sections += 1;
+            if (isContactPath(page.path)) {
+                failures.push(fail("T5", page.path, `${page.path} is a contact or thank-you page with a reviews section; reviews do not belong on it.`));
+                continue;
+            }
+            const report = inspectReviewsSection(section);
+            if (report.source !== undefined && report.source !== "feed") {
+                failures.push(fail("T5", page.path, `The reviews section on ${page.path} is from "${report.source}"; reviews come only from the Google feed.`));
+            }
+            if (report.entries === 0 && !report.hasRating && !report.hasCount && !report.hasGoogleLink) {
+                failures.push(fail("T5", page.path, `The reviews section on ${page.path} is empty; a page with no reviews to show has no reviews section.`));
+                continue;
+            }
+            const missing = [
+                report.hasRating ? null : "Google's rating",
+                report.hasCount ? null : "the review count",
+                report.hasGoogleLink ? null : "the link to Google",
+            ].filter((part) => part !== null);
+            if (missing.length > 0) {
+                failures.push(fail("T5", page.path, `The reviews section on ${page.path} is missing ${missing.join(", ")}; the feed's summary sits beside any list of reviews.`));
+            }
+        }
+    }
+    if (sections === 0)
+        return [notApplicable("T5", "None of the sampled pages has a reviews section.")];
+    return resultOf("T5", failures, `Checked ${plural(sections, "reviews section")}: each shows the feed's rating, count and Google link, and none is on the contact page or empty.`);
+}
+//# sourceMappingURL=t5-reviews.js.map

package/dist/site-system/rules/enquiry/t5-reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t5-reviews.js","sourceRoot":"","sources":["../../../../src/site-system/rules/enquiry/t5-reviews.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * T5: reviews come from the Google feed, with Google's rating, count and link beside any list (Site System v2 §13.2).\n *\n * A reviews section (`data-bl-section=\"reviews\"`) shows the feed's summary rating, its review count and a link to\n * Google beside any reviews it lists. There is no reviews section on the contact page, and no empty one. The rule has\n * no exclusion clause: it judges what the feed rendered, and the library does not hide or tag reviews (D6).\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { fail, notApplicable, plural, resultOf, sectionId, type ParsedPage } from \"./common.js\";\nimport { attr, descendants, textOf, type HtmlElement } from \"./html.js\";\n\nexport const T5_SECTION_ID = \"reviews\";\n\n/** Pages that never carry reviews: the contact page, and any thank-you page (`/thank-you`, `/contact/thank-you`). */\nconst CONTACT_PATH = /^\\/(?:contact|contact-us|get-in-touch)(?:\\/|$)/;\nconst THANK_YOU_PATH = /(?:^|\\/)(?:thank-you|thankyou|thanks)(?:\\/|$)/;\n\nexport function isContactPath(path: string): boolean {\n  return CONTACT_PATH.test(path) || THANK_YOU_PATH.test(path);\n}\n\nconst GOOGLE_HOST = /^(?:[a-z0-9-]+\\.)*(?:google\\.(?:com(?:\\.au)?|co\\.[a-z]{2})|g\\.page|g\\.co|goo\\.gl|share\\.google)$/i;\n\nexport function isGoogleLink(href: string): boolean {\n  try {\n    return GOOGLE_HOST.test(new URL(href, \"https://page.invalid\").hostname);\n  } catch {\n    return false;\n  }\n}\n\nconst RATING =\n  /(?:\\b[1-5](?:\\.\\d)?\\s*(?:\\/\\s*5\\b|out\\s+of\\s+5\\b|stars?\\b|★)|\\brated\\s+[1-5](?:\\.\\d)?\\b|\\b[1-5]\\.\\d\\b|★\\s*[1-5](?:\\.\\d)?\\b)/i;\nconst COUNT = /\\b\\d[\\d,]*\\s*(?:google\\s+)?reviews?\\b|\\bbased\\s+on\\s+\\d[\\d,]*\\b|\\b\\d[\\d,]*\\s+ratings?\\b/i;\n\nfunction isReviewBody(element: HtmlElement): boolean {\n  return (attr(element, \"data-slot\") ?? \"\").split(/\\s+/).includes(\"review\") || element.tag === \"blockquote\" || element.tag === \"article\";\n}\n\n/** The reviews listed in a section: review slots, quotes and articles. */\nfunction listedReviews(section: HtmlElement): HtmlElement[] {\n  return descendants(section).filter(isReviewBody);\n}\n\nfunction insideReviewBody(element: HtmlElement, section: HtmlElement): boolean {\n  for (let parent: HtmlElement | null = element; parent && parent !== section; parent = parent.parent) {\n    if (isReviewBody(parent)) return true;\n  }\n  return false;\n}\n\n/**\n * The section's text plus the accessible names in it, where a star rating often keeps its number, leaving out the\n * listed reviews themselves: a review that says \"5 stars\" or \"after 20 reviews\" is not Google's rating or count.\n */\nfunction summaryText(section: HtmlElement): string {\n  const names = descendants(section)\n    .filter((element) => !insideReviewBody(element, section))\n    .map((element) => attr(element, \"aria-label\") ?? attr(element, \"title\") ?? \"\")\n    .filter(Boolean);\n  return `${textOf(section, true, isReviewBody)} ${names.join(\" \")}`;\n}\n\nexport interface ReviewsSectionReport {\n  entries: number;\n  hasRating: boolean;\n  hasCount: boolean;\n  hasGoogleLink: boolean;\n  source: string | undefined;\n}\n\nexport function inspectReviewsSection(section: HtmlElement): ReviewsSectionReport {\n  const text = summaryText(section);\n  const outside = descendants(section).filter((element) => !insideReviewBody(element, section));\n  const countSlot = outside.find((element) => attr(element, \"data-slot\") === \"count\");\n  return {\n    entries: listedReviews(section).length,\n    hasRating: RATING.test(text),\n    hasCount: COUNT.test(text) || (countSlot !== undefined && /\\d/.test(textOf(countSlot, true))),\n    hasGoogleLink: outside.some((element) => element.tag === \"a\" && isGoogleLink(attr(element, \"href\") ?? \"\")),\n    source: attr(section, \"data-bl-source\"),\n  };\n}\n\nexport function checkT5(pages: readonly ParsedPage[]): SiteSystemFinding[] {\n  const failures: SiteSystemFinding[] = [];\n  let sections = 0;\n  for (const page of pages) {\n    // Every reviews section counts, including one nested inside another section.\n    for (const section of descendants(page.root).filter((candidate) => sectionId(candidate) === T5_SECTION_ID)) {\n      sections += 1;\n      if (isContactPath(page.path)) {\n        failures.push(fail(\"T5\", page.path, `${page.path} is a contact or thank-you page with a reviews section; reviews do not belong on it.`));\n        continue;\n      }\n      const report = inspectReviewsSection(section);\n      if (report.source !== undefined && report.source !== \"feed\") {\n        failures.push(fail(\"T5\", page.path, `The reviews section on ${page.path} is from \"${report.source}\"; reviews come only from the Google feed.`));\n      }\n      if (report.entries === 0 && !report.hasRating && !report.hasCount && !report.hasGoogleLink) {\n        failures.push(fail(\"T5\", page.path, `The reviews section on ${page.path} is empty; a page with no reviews to show has no reviews section.`));\n        continue;\n      }\n      const missing = [\n        report.hasRating ? null : \"Google's rating\",\n        report.hasCount ? null : \"the review count\",\n        report.hasGoogleLink ? null : \"the link to Google\",\n      ].filter((part): part is string => part !== null);\n      if (missing.length > 0) {\n        failures.push(fail(\"T5\", page.path, `The reviews section on ${page.path} is missing ${missing.join(\", \")}; the feed's summary sits beside any list of reviews.`));\n      }\n    }\n  }\n  if (sections === 0) return [notApplicable(\"T5\", \"None of the sampled pages has a reviews section.\")];\n  return resultOf(\"T5\", failures, `Checked ${plural(sections, \"reviews section\")}: each shows the feed's rating, count and Google link, and none is on the contact page or empty.`);\n}\n"]}

package/dist/site-system/rules/form/c11-contact-route.d.ts

@@ -0,0 +1,5 @@
+import type { SiteSystemFinding } from "../../checks.js";
+import { type ParsedPage } from "../enquiry/common.js";
+export declare const C11_ROUTE_CANDIDATES: readonly ["src/app/api/contact/route", "app/api/contact/route"];
+export declare function checkC11(projectRoot: string, pages?: readonly ParsedPage[]): SiteSystemFinding[];
+//# sourceMappingURL=c11-contact-route.d.ts.map

package/dist/site-system/rules/form/c11-contact-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"c11-contact-route.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/form/c11-contact-route.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKlF,eAAO,MAAM,oBAAoB,iEAGvB,CAAC;AAiFX,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,UAAU,EAAO,GAAG,iBAAiB,EAAE,CAsBpG"}

package/dist/site-system/rules/form/c11-contact-route.js

@@ -0,0 +1,132 @@
+/**
+ * C11 (static half): the contact route keeps the shared handler's protections (Site System v2 §13.2).
+ *
+ * `POST /api/contact` must come from the shared handler (`createBrandlabContactRouteHandler`, or
+ * `createBrandlabContactRuntime` during the transition, the same evidence as brandlab-verify's
+ * contact-provider-route rule). The shared handler strips the `bl_test` marker before delivery and reporting, so a test
+ * enquiry is never delivered as a real one, and it rate-limits abuse per IP and per email address. A route that
+ * writes its own handler has neither, and a route that passes `rateLimit: false` (or turns off both the per-IP and
+ * per-address limits) has switched the second one off.
+ *
+ * The route file is read from the syntax tree, never run; one hop of local imports is followed because the handler is
+ * often created in a `src/config/contact.ts` the route re-exports.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import ts from "typescript";
+import { fail, notApplicable, pass } from "../enquiry/common.js";
+import { isQuoteForm } from "../enquiry/c2-quote-form.js";
+import { descendants } from "../enquiry/html.js";
+import { LiteralReader, isLiteralObject } from "../enquiry/literal.js";
+export const C11_ROUTE_CANDIDATES = [
+    "src/app/api/contact/route",
+    "app/api/contact/route",
+];
+const EXTENSIONS = [".ts", ".tsx", ".mts", ".js", ".mjs"];
+const SHARED_HANDLERS = new Set(["createBrandlabContactRouteHandler", "createBrandlabContactRuntime"]);
+const SHARED_MODULE = /^@brandlab-digital\/site-next\/contact(?:\/|$)/;
+function fileWithExtension(base) {
+    for (const extension of EXTENSIONS)
+        if (existsSync(base + extension))
+            return base + extension;
+    for (const extension of EXTENSIONS)
+        if (existsSync(join(base, `index${extension}`)))
+            return join(base, `index${extension}`);
+    return existsSync(base) && /\.[a-z]+$/.test(base) ? base : undefined;
+}
+function readModule(file) {
+    try {
+        const text = readFileSync(file, "utf8");
+        return { file, text, source: ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX) };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The names a module imports from the shared contact entry points, by local name. */
+function sharedImports(module) {
+    const names = new Map();
+    for (const statement of module.source.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier))
+            continue;
+        if (!SHARED_MODULE.test(statement.moduleSpecifier.text))
+            continue;
+        const bindings = statement.importClause?.namedBindings;
+        if (bindings && ts.isNamedImports(bindings)) {
+            for (const element of bindings.elements)
+                names.set(element.name.text, (element.propertyName ?? element.name).text);
+        }
+    }
+    return names;
+}
+function usesSharedHandler(module) {
+    const imported = sharedImports(module);
+    let used = false;
+    const visit = (node) => {
+        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression)) {
+            const original = imported.get(node.expression.text);
+            if (original !== undefined && SHARED_HANDLERS.has(original))
+                used = true;
+        }
+        if (!used)
+            ts.forEachChild(node, visit);
+    };
+    visit(module.source);
+    return used;
+}
+function localImports(module, projectRoot) {
+    const found = [];
+    for (const statement of module.source.statements) {
+        if (!(ts.isImportDeclaration(statement) || ts.isExportDeclaration(statement)) || !statement.moduleSpecifier || !ts.isStringLiteral(statement.moduleSpecifier))
+            continue;
+        const specifier = statement.moduleSpecifier.text;
+        let base;
+        if (specifier.startsWith("."))
+            base = resolve(dirname(module.file), specifier);
+        else if (specifier.startsWith("@/"))
+            base = join(projectRoot, "src", specifier.slice(2));
+        else
+            continue;
+        const file = fileWithExtension(base);
+        const imported = file ? readModule(file) : undefined;
+        if (imported)
+            found.push(imported);
+    }
+    return found;
+}
+/** What a `rateLimit` option turns off: "all" for `false` (or both limits off), null when the limits stay on. */
+function rateLimitOff(module) {
+    const reader = new LiteralReader(module.text, module.file);
+    for (const expression of reader.propertyValues("rateLimit")) {
+        const value = reader.evaluate(expression);
+        if (value === false)
+            return "rateLimit: false";
+        if (isLiteralObject(value) && value.perIp === false && value.perAddress === false)
+            return "both the per-IP and per-address limits set to false";
+    }
+    return null;
+}
+export function checkC11(projectRoot, pages = []) {
+    const routeBase = C11_ROUTE_CANDIDATES.map((base) => join(projectRoot, base)).map(fileWithExtension).find((file) => file !== undefined);
+    if (!routeBase) {
+        const hasForm = pages.some((page) => descendants(page.root).some((element) => element.tag === "form" && isQuoteForm(element)));
+        return hasForm
+            ? [fail("C11", C11_ROUTE_CANDIDATES[0] + ".ts", "The site has a quote form but no /api/contact route, so enquiries have no shared handler, test-marker handling or rate limits.")]
+            : [notApplicable("C11", "None of the sampled pages has a quote form and the project has no /api/contact route.")];
+    }
+    const route = readModule(routeBase);
+    if (!route)
+        return [];
+    const shown = routeBase.slice(projectRoot.length).replace(/^\/+/, "");
+    const modules = [route, ...localImports(route, projectRoot)];
+    const off = modules.map((module) => ({ module, off: rateLimitOff(module) })).find((entry) => entry.off !== null);
+    if (off) {
+        const where = off.module.file === routeBase ? shown : off.module.file.slice(projectRoot.length).replace(/^\/+/, "");
+        return [fail("C11", where, `The contact route turns the rate limits off (${off.off} in ${where}); /api/contact must stay rate-limited per IP and per email address.`)];
+    }
+    if (!modules.some(usesSharedHandler)) {
+        return [fail("C11", shown, `${shown} does not create its handler with the shared contact handler, so the bl_test marker is not stripped before delivery and /api/contact is not rate-limited.`)];
+    }
+    return [pass("C11", `${shown} uses the shared contact handler: the bl_test marker is stripped before delivery and reporting, and /api/contact keeps its rate limits.`, shown)];
+}
+//# sourceMappingURL=c11-contact-route.js.map