@dreamdata_io/verify-tracking 0.1.0

package/dist/analysis/diagnosis/diagnose.js

@@ -0,0 +1,172 @@
+import { EN_CAUSE_COPY } from "./copy.en.js";
+import { CMP_VENDORS_IN_DOCS, docTitle, docUrl } from "./docs.js";
+import { CAUSE_RULES } from "./rules.js";
+/**
+ * Ranking order. "not-a-verdict" is first because it pre-empts rather than
+ * outranks — nothing else is reported at all once one of those fires.
+ */
+const KIND_RANK = {
+    "not-a-verdict": 0,
+    blocking: 1,
+    leaking: 2,
+    "duplicate-counting": 3,
+    hardening: 4,
+};
+/**
+ * Three is a reader's limit, not an evidence limit. Across the 25-report
+ * corpus the cap never actually binds (the worst sites resolve to three), so
+ * it is a safety net rather than the mechanism — and anything it does trim is
+ * still named in `alsoFired`, so a count stays complete.
+ */
+const MAX_CAUSES = 3;
+/**
+ * Checks the diagnosis layer does not speak for at all.
+ *
+ * console-clean is the only one. Its warn says the install printed a
+ * Dreamdata message to the console — which turned out to be a false positive
+ * as a *finding*: blackline.com's "Plugin loaded - YOU SHOULD SEE THIS IN
+ * PRODUCTION" and qa.com's third-party destination note both ran clean
+ * otherwise, and neither is something to tell a customer about. It had a
+ * "hardening" cause of its own, and that cause was the whole of the headline
+ * on runs where nothing else was wrong — "Nothing is broken, one thing to
+ * harden" over a line of text no visitor sees.
+ *
+ * So the check stays exactly as it is in the per-check list, warn and all,
+ * for whoever is actually debugging an install. It just never enters the
+ * ledger: no cause may trigger on it, and it can never land in
+ * `unexplainedChecks` either, which is the other way a check reaches the
+ * summary. A run whose only unhealthy check is this one diagnoses as clean.
+ */
+const NOT_DIAGNOSED = new Set(["console-clean"]);
+/** A check that is "fail" or "warn" is claimable; nothing else is. */
+function isUnhealthy(status) {
+    return status === "fail" || status === "warn";
+}
+function buildFacts(analysis, extras) {
+    const byId = new Map(analysis.checks.map((check) => [check.id, check]));
+    const byPhase = new Map(analysis.matrix.map((phase) => [phase.phase, phase]));
+    const vendor = analysis.cmpVendor;
+    return {
+        analysis,
+        check: (id) => byId.get(id),
+        statusOf: (id) => byId.get(id)?.status ?? "absent",
+        // A check's own `phases` field already means "the phases this status is
+        // about" — for a failure, only the ones that actually failed. Re-deriving
+        // that here is how a cause ends up attributing a one-phase failure to
+        // three phases.
+        failingPhases: (id) => byId.get(id)?.phases ?? [],
+        phase: (name) => byPhase.get(name),
+        observed: analysis.matrix,
+        unhealthy: analysis.checks
+            .filter((check) => isUnhealthy(check.status) && !NOT_DIAGNOSED.has(check.id))
+            .map((check) => check.id),
+        duplicates: extras.duplicates,
+        vars: {
+            cmpVendor: vendor,
+            cmpInDocs: vendor !== null && CMP_VENDORS_IN_DOCS.has(vendor),
+            installMethod: analysis.install.method,
+            phases: analysis.phasesObserved,
+        },
+    };
+}
+/**
+ * Only a "hardening" cause may be triggered by a "warn".
+ *
+ * A warn means the configuration is wrong AND this run proved something else
+ * held the line — nothing actually leaked (see CrossPhaseCheck). So a warn
+ * must never fire a blocking or leaking cause: sciex_com's Consent Mode
+ * defaults to granted and only a GTM blocking trigger keeps identified
+ * tracking off an unanswered page, which is worth reporting as a single point
+ * of failure and is emphatically NOT "this site tracks people who refused".
+ * Without this split, `consent-default-not-denied` matched that shape and
+ * reported a healthy site as leaking.
+ *
+ * A warn is still claimable: a cause that legitimately accounts for one may
+ * name it in `claims`. This governs triggering only.
+ */
+function triggerStatusHolds(rule, facts) {
+    // An empty trigger belongs to a not-a-verdict rule, which gates on
+    // pageReadability/shape in `match` instead of on any check.
+    if (rule.trigger.length === 0)
+        return true;
+    const wantsUnhealthy = rule.triggerOn === "unhealthy" || rule.kind === "hardening";
+    const triggers = (id) => {
+        const status = facts.statusOf(id);
+        return wantsUnhealthy ? isUnhealthy(status) : status === "fail";
+    };
+    return rule.triggerMode === "all" ? rule.trigger.every(triggers) : rule.trigger.some(triggers);
+}
+function toDiagnosedCause(fired, copy) {
+    const entry = copy[fired.rule.id];
+    const doc = entry.doc(fired.vars);
+    // The phases a cause is about are the union of the phases its claimed
+    // checks were about, deduped in PhaseName order rather than discovery order
+    // so the field is stable across runs.
+    const claimed = new Set(fired.vars.phases);
+    return {
+        id: fired.rule.id,
+        kind: fired.rule.kind,
+        problem: entry.problem(fired.vars),
+        fix: entry.fix(fired.vars),
+        docUrl: docUrl(doc),
+        docTitle: docTitle(doc),
+        explains: fired.claims,
+        phases: ["clean", "grant", "reject"].filter((phase) => claimed.has(phase)),
+    };
+}
+/**
+ * Diagnose one run.
+ *
+ * `copy` is the i18n seam: another table over the same CauseIds and CauseVars
+ * swaps the language without touching a single predicate.
+ */
+export function diagnose(analysis, extras, copy = EN_CAUSE_COPY) {
+    const facts = buildFacts(analysis, extras);
+    const hadFailures = analysis.checks.some((check) => check.status === "fail");
+    const open = new Set(facts.unhealthy);
+    const fired = [];
+    for (const rule of CAUSE_RULES) {
+        if (!triggerStatusHolds(rule, facts))
+            continue;
+        // Subsumption. If a check this rule exists for is unhealthy but no longer
+        // open, an earlier cause already accounted for it and this rule would be
+        // re-reporting the same problem one level down.
+        if (rule.trigger.some((id) => facts.unhealthy.includes(id) && !open.has(id)))
+            continue;
+        const match = rule.match(facts);
+        if (match === null)
+            continue;
+        // Filtering against `open` before recording is what makes double-claiming
+        // structurally impossible rather than merely unlikely.
+        const claims = [...new Set([...rule.trigger, ...match.claims])].filter((id) => open.has(id));
+        const phases = [...new Set(claims.flatMap((id) => facts.failingPhases(id)))];
+        fired.push({
+            rule,
+            claims,
+            vars: { ...facts.vars, ...match.vars, phases: phases.length > 0 ? phases : facts.vars.phases },
+        });
+        for (const id of claims)
+            open.delete(id);
+        if (match.preempt) {
+            // This run measured something other than the site. Anything else we
+            // could say about it would be a statement about a bot wall's challenge
+            // document, or about someone else's analytics.
+            return {
+                causes: fired.map((f) => toDiagnosedCause(f, copy)),
+                alsoFired: [],
+                unexplainedChecks: [],
+                hadFailures,
+            };
+        }
+    }
+    // Stable sort on a total-ordered key, so equal kinds keep rule order and
+    // the same evidence always produces the same ranking.
+    const ranked = [...fired].sort((a, b) => KIND_RANK[a.rule.kind] - KIND_RANK[b.rule.kind]);
+    return {
+        causes: ranked.slice(0, MAX_CAUSES).map((f) => toDiagnosedCause(f, copy)),
+        alsoFired: ranked.slice(MAX_CAUSES).map((f) => f.rule.id),
+        unexplainedChecks: [...open],
+        hadFailures,
+    };
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/analysis/diagnosis/diagnose.js.map

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

package/dist/analysis/diagnosis/docs.js

@@ -0,0 +1,118 @@
+export const DOCS_BASE_URL = "https://developer.dreamdata.io";
+export const DOC_LINKS = {
+    /** Carries the per-vendor outbound list, which is why a CMP fix links here. */
+    "consent-mode-turn-on": {
+        path: "client-side/google-consent-mode",
+        anchor: "how-to-turn-on-google-consent-mode-v2",
+        title: "How to turn on Google Consent Mode v2",
+    },
+    "consent-mode-verify": {
+        path: "client-side/google-consent-mode",
+        anchor: "how-to-check-that-google-consent-mode-v2-is-enabled",
+        title: "How to check Google Consent Mode v2 is enabled",
+    },
+    /** The recipe for firing a tag off a CMP's own dataLayer event. */
+    "gtm-custom-trigger": {
+        path: "client-side/troubleshooting",
+        anchor: "adding-a-custom-trigger-in-google-tag-manager",
+        title: "Adding a custom trigger in Google Tag Manager",
+    },
+    spa: {
+        path: "client-side/how-to-track-spas",
+        title: "Single-Page App SDK",
+    },
+    "script-installation": {
+        path: "client-side/script-installation",
+        title: "Website Script",
+    },
+    "script-installation-gtm": {
+        path: "client-side/script-installation",
+        anchor: "option-b-install-with-google-tag-manager",
+        title: "Install with Google Tag Manager",
+    },
+    "script-installation-troubleshooting": {
+        path: "client-side/script-installation",
+        anchor: "troubleshooting-common-issues",
+        title: "Troubleshooting common issues",
+    },
+    cookieless: {
+        path: "client-side/cookieless",
+        title: "Cookieless Account Analytics",
+    },
+    debugging: {
+        path: "client-side/debugging-dreamdata-analytics",
+        title: "Test your tracking",
+    },
+    csp: {
+        path: "client-side/csp",
+        title: "Content Security Policy",
+    },
+    cookies: {
+        path: "faq/cookies",
+        title: "Cookies",
+    },
+};
+/** Composed in one place, so there is one thing for a test to assert about. */
+export function docUrl(id) {
+    const link = DOC_LINKS[id];
+    return `${DOCS_BASE_URL}/${link.path}${link.anchor ? `#${link.anchor}` : ""}`;
+}
+export function docTitle(id) {
+    return DOC_LINKS[id].title;
+}
+/**
+ * The CMP vendors the Consent Mode page actually has setup instructions for.
+ *
+ * The intersection of two lists: the vendors named in
+ * `docs/client-side/google-consent-mode.md` (CookieBot, CookieYes, OneTrust,
+ * Osano, HubSpot, Cookie Information, Framer, Klaro) and the vendor ids this
+ * harness can detect (CMP_VENDORS and DOM_ONLY_CMP_VENDORS in
+ * src/evidence/constants.ts). Cookie Information, Framer and Klaro are in the
+ * docs but undetectable, so they cannot appear here; usercentrics, pardot,
+ * termly, complianz, trustarc, ketch, cookiescript and the two IAB shims are
+ * detectable but absent from the docs, so a fix sentence for them has to
+ * degrade — see CMP_DISPLAY_NAMES and the copy table.
+ *
+ * Real reports currently detect usercentrics (2 sites) and pardot (1), so
+ * that degrade path is live, not theoretical. docs.test.ts asserts this set
+ * in BOTH directions, so adding Usercentrics to the docs without adding it
+ * here fails the build rather than leaving the sentence needlessly vague.
+ */
+export const CMP_VENDORS_IN_DOCS = new Set([
+    "cookiebot",
+    "cookieyes",
+    "onetrust",
+    "osano",
+    "hubspot",
+]);
+/**
+ * How a vendor id is spelled in a sentence a human reads.
+ *
+ * Only ids that can actually reach a sentence need an entry; anything missing
+ * falls back to the raw id, which is still readable ("ketch"). "unknown-custom"
+ * is deliberately absent: a bespoke banner has no name to print, and the copy
+ * table branches on that rather than printing a placeholder.
+ */
+export const CMP_DISPLAY_NAMES = {
+    cookiebot: "Cookiebot",
+    cookieyes: "CookieYes",
+    onetrust: "OneTrust",
+    osano: "Osano",
+    hubspot: "HubSpot",
+    usercentrics: "Usercentrics",
+    pardot: "Pardot",
+    termly: "Termly",
+    complianz: "Complianz",
+    trustarc: "TrustArc",
+    ketch: "Ketch",
+    cookiescript: "CookieScript",
+    "iab-tcf": "the IAB TCF CMP",
+    "iab-cmp": "the IAB CMP",
+    "generic-cookieconsent": "the CookieConsent banner",
+};
+export function cmpDisplayName(vendor) {
+    if (vendor === null || vendor === "unknown-custom")
+        return "the cookie banner";
+    return CMP_DISPLAY_NAMES[vendor] ?? vendor;
+}
+//# sourceMappingURL=docs.js.map

package/dist/analysis/diagnosis/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/analysis/diagnosis/docs.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAE9D,MAAM,CAAC,MAAM,SAAS,GAA+B;IACnD,+EAA+E;IAC/E,sBAAsB,EAAE;QACtB,IAAI,EAAE,iCAAiC;QACvC,MAAM,EAAE,uCAAuC;QAC/C,KAAK,EAAE,uCAAuC;KAC/C;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,iCAAiC;QACvC,MAAM,EAAE,qDAAqD;QAC7D,KAAK,EAAE,gDAAgD;KACxD;IACD,mEAAmE;IACnE,oBAAoB,EAAE;QACpB,IAAI,EAAE,6BAA6B;QACnC,MAAM,EAAE,+CAA+C;QACvD,KAAK,EAAE,+CAA+C;KACvD;IACD,GAAG,EAAE;QACH,IAAI,EAAE,+BAA+B;QACrC,KAAK,EAAE,qBAAqB;KAC7B;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,iCAAiC;QACvC,KAAK,EAAE,gBAAgB;KACxB;IACD,yBAAyB,EAAE;QACzB,IAAI,EAAE,iCAAiC;QACvC,MAAM,EAAE,0CAA0C;QAClD,KAAK,EAAE,iCAAiC;KACzC;IACD,qCAAqC,EAAE;QACrC,IAAI,EAAE,iCAAiC;QACvC,MAAM,EAAE,+BAA+B;QACvC,KAAK,EAAE,+BAA+B;KACvC;IACD,UAAU,EAAE;QACV,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,8BAA8B;KACtC;IACD,SAAS,EAAE;QACT,IAAI,EAAE,2CAA2C;QACjD,KAAK,EAAE,oBAAoB;KAC5B;IACD,GAAG,EAAE;QACH,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,yBAAyB;KACjC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,SAAS;KACjB;CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,MAAM,CAAC,EAAa;IAClC,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,GAAG,aAAa,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAa;IACpC,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IAC9D,WAAW;IACX,WAAW;IACX,UAAU;IACV,OAAO;IACP,SAAS;CACV,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,aAAa;IACxB,uBAAuB,EAAE,0BAA0B;CACpD,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,mBAAmB,CAAC;IAC/E,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AAC7C,CAAC"}

package/dist/analysis/diagnosis/index.js

@@ -0,0 +1,5 @@
+export { diagnose } from "./diagnose.js";
+export { CMP_VENDORS_IN_DOCS, DOCS_BASE_URL, DOC_LINKS, cmpDisplayName, docTitle, docUrl } from "./docs.js";
+export { EN_CAUSE_COPY, EN_CAUSE_LABELS, causeLabel } from "./copy.en.js";
+export { CAUSE_RULES } from "./rules.js";
+//# sourceMappingURL=index.js.map

package/dist/analysis/diagnosis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysis/diagnosis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}