@polishd/next 0.2.2 → 0.2.3-dev.1

package/dist/server/telemetry.js

@@ -19,6 +19,7 @@
  * the host site's analytics, never its visitors' events.
  */
 import { getMeta, setMeta, storeReady } from "./store";
+import { resolveSettings } from "../ai/settings";
 /** Where telemetry lands: the polishd site's own installation. */
 export const DEFAULT_TELEMETRY_ENDPOINT = "https://polishd.muskanvaswan.xyz/api/polishd-telemetry";
 const CONSENT_KEY = "telemetry_consent";
@@ -47,28 +48,48 @@ export function resolveTelemetryEndpoint() {
 export async function saveTelemetryConsent(granted) {
     await setMeta(CONSENT_KEY, JSON.stringify({ status: granted ? "granted" : "denied", at: Date.now() }));
 }
+/** The install-state snapshot the emitter reports. Never includes secrets. */
+async function loadInstallState() {
+    try {
+        const { settings } = await resolveSettings();
+        return {
+            hasModel: settings.apiKey.length > 0,
+            provider: settings.provider,
+            model: settings.model,
+        };
+    }
+    catch {
+        return { hasModel: false, provider: "", model: "" };
+    }
+}
 /** What the dashboard should do about telemetry on this render. */
 export async function loadPolishdTelemetryState() {
     const endpoint = resolveTelemetryEndpoint();
+    const off = (status) => ({
+        status,
+        endpoint,
+        installState: null,
+    });
     if (telemetryDisabledByEnv())
-        return { status: "disabled", endpoint };
+        return off("disabled");
     // Without a writable store there is nowhere to keep the answer, so asking
     // would mean asking on every single render. Stay quiet instead.
     if (!(await storeReady()))
-        return { status: "disabled", endpoint };
+        return off("disabled");
     const raw = await getMeta(CONSENT_KEY);
     if (!raw)
-        return { status: "unset", endpoint };
+        return off("unset");
     try {
         const parsed = JSON.parse(raw);
-        if (parsed.status === "granted")
-            return { status: "granted", endpoint };
+        if (parsed.status === "granted") {
+            return { status: "granted", endpoint, installState: await loadInstallState() };
+        }
         if (parsed.status === "denied")
-            return { status: "denied", endpoint };
+            return off("denied");
     }
     catch {
         // Unreadable record — treat as never asked rather than silently sending.
     }
-    return { status: "unset", endpoint };
+    return off("unset");
 }
 //# sourceMappingURL=telemetry.js.map

package/dist/server/telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/server/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD,kEAAkE;AAClE,MAAM,CAAC,MAAM,0BAA0B,GACrC,wDAAwD,CAAC;AAE3D,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAiBxC,MAAM,UAAU,sBAAsB;IACpC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACxC,OAAO,CAAC,KAAK,SAAS,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAMD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,0BAA0B,CAAC;AAC9E,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAgB;IACzD,MAAM,OAAO,CACX,WAAW,EACX,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAC5C,IAAI,sBAAsB,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IACtE,0EAA0E;IAC1E,gEAAgE;IAChE,IAAI,CAAC,CAAC,MAAM,UAAU,EAAE,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAEnE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACxE,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/server/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/shared/capture-status.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Polishd — capture health (shared: no server, no React).
+ *
+ * Two things live here, and they are the same subject seen from both ends:
+ * the on-disk shape ingest writes when it drops a cookie-less batch, and the
+ * rule the dashboard applies to decide whether that means "your proxy isn't
+ * running" or "some bots posted to a public endpoint".
+ *
+ * They are together, and pure, because the rule is the part that has been
+ * wrong: it compared an all-time drop total against an all-time event total
+ * gated on a one-hour recency check, so a single fresh drop re-armed every
+ * drop the site had ever recorded. Anything that can be tested without a
+ * database or a renderer belongs in one file that a test can import.
+ */
+/** Granularity drops are bucketed at. One hour. */
+export declare const NO_SESSION_BUCKET_MS = 3600000;
+/** How far back *both* sides of the comparison look. */
+export declare const CAPTURE_WINDOW_MS: number;
+/** One hour's worth of drops. */
+export interface NoSessionBucket {
+    /** Hour index — `Math.floor(ms / NO_SESSION_BUCKET_MS)`. */
+    h: number;
+    /** Drops recorded in that hour. */
+    n: number;
+}
+/** What ingest stores under its `polishd_meta` key. */
+export interface NoSessionRecord {
+    /** All-time drops. Never decays — a lifetime total, not an alert input. */
+    count: number;
+    /** Most recent drop (ms epoch). */
+    lastAt: number;
+    /** Per-hour drops, oldest first, trimmed to {@link MAX_BUCKETS}. */
+    buckets: NoSessionBucket[];
+}
+/**
+ * Read a stored record, tolerating both junk and the pre-0.2.3 `{count,
+ * lastAt}` shape. A legacy record parses with no buckets, which is the honest
+ * answer: those drops happened, but nothing recorded *when*, so none of them
+ * can count toward a window. That is the whole point — history stops voting.
+ */
+export declare function parseNoSessionRecord(raw: string | null | undefined): NoSessionRecord | null;
+/** Add `batch` drops observed at `now` to `prev` (null for a first drop). */
+export declare function foldNoSessionDrop(prev: NoSessionRecord | null, now: number, batch: number): NoSessionRecord;
+/**
+ * Drops recorded at or after `since`.
+ *
+ * Hour-granular, so the bucket straddling `since` contributes in full and the
+ * count leans high by up to an hour of drops. That bias is the safe direction
+ * for a diagnostic and it costs nothing to store.
+ */
+export declare function noSessionCountSince(rec: NoSessionRecord | null, since: number): number;
+/** Whether capture itself is wired up, as opposed to what it captured. */
+export interface CaptureHealth {
+    /** All-time beacons dropped for want of a session cookie. */
+    noSessionCount: number;
+    /** Of those, the ones inside {@link windowMs}. */
+    recentNoSessionCount: number;
+    /** When the most recent drop happened (ms epoch), or null for none. */
+    lastNoSessionAt: number | null;
+    /** When an event was last *stored*, by the server's clock, or null. */
+    lastStoredAt: number | null;
+    /** Events stored inside the window. */
+    recentEvents: number;
+    /** Batches stored inside the window (distinct arrival stamps — approximate). */
+    recentBatches: number;
+    /** The window both recent counts were measured over. */
+    windowMs: number;
+}
+export type CaptureStatusLevel = "ok" | "notice" | "broken";
+export interface CaptureStatus {
+    /**
+     * `broken` — nothing is being stored, say so in red.
+     * `notice`  — real capture plus some cookie-less batches; neutral and true.
+     * `ok`      — nothing worth a word.
+     */
+    level: CaptureStatusLevel;
+    /** Drops this status is talking about: the window's, or all-time when empty. */
+    droppedBatches: number;
+    /** Batches stored alongside them, over the same window. */
+    storedBatches: number;
+    /** Dropped share of all batches seen in the window, or null if unknowable. */
+    sharePct: number | null;
+    /** A store landed *after* the last drop — proof the proxy is minting now. */
+    storedSinceDrop: boolean;
+    /** Nothing has ever been stored. Gates the "nothing is being stored" copy. */
+    nothingStored: boolean;
+}
+/**
+ * Decide what, if anything, the dashboard should say about cookie-less
+ * batches.
+ *
+ * The load-bearing signal is `storedSinceDrop`. Every event is attributed to
+ * the cookie the proxy mints, so a proxy that isn't running drops *every*
+ * batch — one successful store after the most recent drop is proof it is
+ * running, and no threshold can argue with it. Everything else here only
+ * decides how loudly to describe traffic that is already known to be flowing.
+ */
+export declare function captureStatus(health: CaptureHealth, totalEvents: number, now?: number): CaptureStatus;
+//# sourceMappingURL=capture-status.d.ts.map

package/dist/shared/capture-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-status.d.ts","sourceRoot":"","sources":["../../src/shared/capture-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAE9C,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,QAA4B,CAAC;AAoB3D,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAC;IACV,mCAAmC;IACnC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI,CAgB3F;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,GAAG,IAAI,EAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,eAAe,CAYjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uEAAuE;IACvE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,EAAE,kBAAkB,CAAC;IAC1B,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAC;IACzB,8EAA8E;IAC9E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAmB,GACvB,aAAa,CAqCf"}

package/dist/shared/capture-status.js

@@ -0,0 +1,133 @@
+/**
+ * Polishd — capture health (shared: no server, no React).
+ *
+ * Two things live here, and they are the same subject seen from both ends:
+ * the on-disk shape ingest writes when it drops a cookie-less batch, and the
+ * rule the dashboard applies to decide whether that means "your proxy isn't
+ * running" or "some bots posted to a public endpoint".
+ *
+ * They are together, and pure, because the rule is the part that has been
+ * wrong: it compared an all-time drop total against an all-time event total
+ * gated on a one-hour recency check, so a single fresh drop re-armed every
+ * drop the site had ever recorded. Anything that can be tested without a
+ * database or a renderer belongs in one file that a test can import.
+ */
+/** Granularity drops are bucketed at. One hour. */
+export const NO_SESSION_BUCKET_MS = 3_600_000;
+/** How far back *both* sides of the comparison look. */
+export const CAPTURE_WINDOW_MS = 24 * NO_SESSION_BUCKET_MS;
+/** Buckets retained: the window plus slack, so the oldest ages out cleanly. */
+const MAX_BUCKETS = 26;
+/**
+ * Drops in the window before a *neutral* note is worth showing. Below this,
+ * cookie-less batches are ordinary background on a public endpoint and saying
+ * so is clutter.
+ */
+const MIN_NOTICE_DROPS = 3;
+/**
+ * Drops in the window before "nothing stored in the window" is allowed to
+ * read as a broken proxy. A real proxy failure drops *every* batch, so on any
+ * site with traffic the count climbs fast; the floor is what keeps a dormant
+ * site poked twice by a crawler from accusing a working install.
+ */
+const MIN_BROKEN_DROPS = 5;
+/**
+ * Read a stored record, tolerating both junk and the pre-0.2.3 `{count,
+ * lastAt}` shape. A legacy record parses with no buckets, which is the honest
+ * answer: those drops happened, but nothing recorded *when*, so none of them
+ * can count toward a window. That is the whole point — history stops voting.
+ */
+export function parseNoSessionRecord(raw) {
+    if (!raw)
+        return null;
+    try {
+        const rec = JSON.parse(raw);
+        if (!rec || typeof rec !== "object")
+            return null;
+        const count = numOr(rec.count, 0);
+        const lastAt = numOr(rec.lastAt, 0);
+        const buckets = Array.isArray(rec.buckets)
+            ? rec.buckets
+                .filter((b) => !!b && Number.isFinite(b.h) && Number.isFinite(b.n))
+                .map((b) => ({ h: Math.floor(b.h), n: Math.max(0, Math.floor(b.n)) }))
+            : [];
+        return { count, lastAt, buckets };
+    }
+    catch {
+        return null;
+    }
+}
+/** Add `batch` drops observed at `now` to `prev` (null for a first drop). */
+export function foldNoSessionDrop(prev, now, batch) {
+    const h = Math.floor(now / NO_SESSION_BUCKET_MS);
+    const buckets = (prev?.buckets ?? []).filter((b) => b.h > h - MAX_BUCKETS);
+    const current = buckets.find((b) => b.h === h);
+    if (current)
+        current.n += batch;
+    else
+        buckets.push({ h, n: batch });
+    buckets.sort((a, b) => a.h - b.h);
+    return {
+        count: (prev?.count ?? 0) + batch,
+        lastAt: Math.max(now, prev?.lastAt ?? 0),
+        buckets: buckets.slice(-MAX_BUCKETS),
+    };
+}
+/**
+ * Drops recorded at or after `since`.
+ *
+ * Hour-granular, so the bucket straddling `since` contributes in full and the
+ * count leans high by up to an hour of drops. That bias is the safe direction
+ * for a diagnostic and it costs nothing to store.
+ */
+export function noSessionCountSince(rec, since) {
+    if (!rec)
+        return 0;
+    const first = Math.floor(since / NO_SESSION_BUCKET_MS);
+    return rec.buckets.reduce((sum, b) => (b.h >= first ? sum + b.n : sum), 0);
+}
+/**
+ * Decide what, if anything, the dashboard should say about cookie-less
+ * batches.
+ *
+ * The load-bearing signal is `storedSinceDrop`. Every event is attributed to
+ * the cookie the proxy mints, so a proxy that isn't running drops *every*
+ * batch — one successful store after the most recent drop is proof it is
+ * running, and no threshold can argue with it. Everything else here only
+ * decides how loudly to describe traffic that is already known to be flowing.
+ */
+export function captureStatus(health, totalEvents, now = Date.now()) {
+    const storedSinceDrop = health.lastStoredAt !== null &&
+        health.lastNoSessionAt !== null &&
+        health.lastStoredAt > health.lastNoSessionAt;
+    const nothingStored = totalEvents === 0;
+    const dropsInWindow = health.lastNoSessionAt !== null &&
+        health.lastNoSessionAt >= now - health.windowMs &&
+        health.recentNoSessionCount > 0;
+    const droppedBatches = dropsInWindow ? health.recentNoSessionCount : health.noSessionCount;
+    const storedBatches = health.recentBatches;
+    const totalBatches = droppedBatches + storedBatches;
+    const sharePct = totalBatches > 0 ? (droppedBatches * 100) / totalBatches : null;
+    const base = { droppedBatches, storedBatches, sharePct, storedSinceDrop, nothingStored };
+    // Never stored anything, and beacons are arriving: the drop *is* the whole
+    // story, whenever it happened. This is the case the banner was written for.
+    if (health.lastNoSessionAt !== null && nothingStored)
+        return { ...base, level: "broken" };
+    // Storing has happened at some point, so judge only the window: drops in it,
+    // nothing stored in it, and no store since the last drop. Enough drops to
+    // rule out a dormant site being poked by a crawler.
+    if (dropsInWindow &&
+        !storedSinceDrop &&
+        health.recentEvents === 0 &&
+        health.recentNoSessionCount >= MIN_BROKEN_DROPS) {
+        return { ...base, level: "broken" };
+    }
+    if (dropsInWindow && health.recentNoSessionCount >= MIN_NOTICE_DROPS) {
+        return { ...base, level: "notice" };
+    }
+    return { ...base, level: "ok" };
+}
+function numOr(v, fallback) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+//# sourceMappingURL=capture-status.js.map

package/dist/shared/capture-status.js.map

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

package/dist/shared/error-noise.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Polishd — browser-extension error noise.
+ *
+ * A page's `error` and `unhandledrejection` handlers hear everything that
+ * throws in the tab, not just the site's own code. Extensions inject scripts
+ * into the page context, and when they fail — a wallet that can't reach its
+ * background worker, a content script whose port closed on navigation — the
+ * throw surfaces on `window` exactly like a real bug would. "Failed to connect
+ * to MetaMask" is the canonical one: nothing on the site can cause it, nothing
+ * on the site can fix it, and left unfiltered it can be the loudest error the
+ * dashboard shows.
+ *
+ * These are pure predicates, shared rather than client-local, so the browser
+ * capture layer and the ingest endpoint apply the same rule — a cached bundle
+ * can lag a config change by a full session, so the server keeps its own copy
+ * of the decision (the same reasoning as the dashboard-path exclusion).
+ */
+/** True when `url` was served by an extension or the browser, not the site. */
+export declare function isExtensionUrl(url: string): boolean;
+/** The shape of an error, reduced to what both the client and ingest can see. */
+export interface ErrorSignature {
+    /** The thrown message, already stringified. */
+    message: string;
+    /** The failing script's URL, if the browser gave one. */
+    source?: string;
+    /** The stack, when available. Only the client has this. */
+    stack?: string;
+    /** Extra ignore patterns from the host app's config. */
+    ignore?: readonly (string | RegExp)[];
+}
+/**
+ * True when this error is noise the site's owner cannot act on.
+ *
+ * Checked in order of confidence: where the script came from, then what the
+ * stack blames, then the small set of messages extension messaging emits, then
+ * the opaque cross-origin case, then whatever the host app chose to ignore.
+ */
+export declare function isIgnorableError({ message, source, stack, ignore }: ErrorSignature): boolean;
+//# sourceMappingURL=error-noise.d.ts.map

package/dist/shared/error-noise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-noise.d.ts","sourceRoot":"","sources":["../../src/shared/error-noise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8CH,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAW,EAAE,KAAU,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,OAAO,CAiBtG"}

package/dist/shared/error-noise.js

@@ -0,0 +1,101 @@
+/**
+ * Polishd — browser-extension error noise.
+ *
+ * A page's `error` and `unhandledrejection` handlers hear everything that
+ * throws in the tab, not just the site's own code. Extensions inject scripts
+ * into the page context, and when they fail — a wallet that can't reach its
+ * background worker, a content script whose port closed on navigation — the
+ * throw surfaces on `window` exactly like a real bug would. "Failed to connect
+ * to MetaMask" is the canonical one: nothing on the site can cause it, nothing
+ * on the site can fix it, and left unfiltered it can be the loudest error the
+ * dashboard shows.
+ *
+ * These are pure predicates, shared rather than client-local, so the browser
+ * capture layer and the ingest endpoint apply the same rule — a cached bundle
+ * can lag a config change by a full session, so the server keeps its own copy
+ * of the decision (the same reasoning as the dashboard-path exclusion).
+ */
+/**
+ * URL schemes that only ever belong to an extension or the browser itself.
+ * If the failing script came from one of these, the site did not load it.
+ */
+const EXTENSION_SCHEMES = [
+    "chrome-extension://",
+    "moz-extension://",
+    "safari-extension://",
+    "safari-web-extension://",
+    "ms-browser-extension://",
+    "extension://", // unknown vendors, and the bare form some builds report
+    "webkit-masked-url://", // Safari's opaque stand-in for injected scripts
+    "resource://", // Firefox internals and legacy add-ons
+    "chrome://", // browser-internal pages and resources
+];
+/**
+ * Messages produced by extension plumbing running *in page context*, where the
+ * filename is the page's own URL and the scheme check above can't help.
+ *
+ * Deliberately narrow: each of these is a string the extension messaging layer
+ * itself emits, not something a site's code would produce. Broad matching here
+ * (say, anything mentioning MetaMask) would swallow a dapp's genuine wallet
+ * errors, which are real bugs worth seeing.
+ */
+const EXTENSION_MESSAGE_PATTERNS = [
+    /failed to connect to metamask/i,
+    /could not establish connection\.\s*receiving end does not exist/i,
+    /the message port closed before a response was received/i,
+    /extension context invalidated/i,
+    /^chrome\.runtime\b/i,
+];
+/**
+ * The browser's placeholder for an error thrown by a cross-origin script it
+ * won't describe: no message, no file, no line. Extensions and third-party
+ * embeds are the usual sources, and either way there is nothing here to act
+ * on — the event is a report that *something* failed, with every detail
+ * stripped.
+ */
+function isOpaqueError(message, source) {
+    return /^script error\.?$/i.test(message.trim()) && !source;
+}
+/** True when `url` was served by an extension or the browser, not the site. */
+export function isExtensionUrl(url) {
+    // `blob:` and `filesystem:` wrap the origin that minted them, so an
+    // extension's blob reads as `blob:chrome-extension://…` — unwrap before
+    // testing the scheme, or code an extension generated at runtime slips past.
+    const u = url.trim().toLowerCase().replace(/^(?:blob|filesystem):/, "");
+    if (!u)
+        return false;
+    return EXTENSION_SCHEMES.some((scheme) => u.startsWith(scheme));
+}
+/**
+ * True when this error is noise the site's owner cannot act on.
+ *
+ * Checked in order of confidence: where the script came from, then what the
+ * stack blames, then the small set of messages extension messaging emits, then
+ * the opaque cross-origin case, then whatever the host app chose to ignore.
+ */
+export function isIgnorableError({ message, source = "", stack = "", ignore }) {
+    if (isExtensionUrl(source))
+        return true;
+    // A stack is a list of frames, not a single URL, so this looks anywhere in
+    // it: injected code often has the page as its top frame and the extension
+    // further down.
+    const lowerStack = stack.toLowerCase();
+    if (lowerStack && EXTENSION_SCHEMES.some((scheme) => lowerStack.includes(scheme)))
+        return true;
+    if (EXTENSION_MESSAGE_PATTERNS.some((re) => re.test(message)))
+        return true;
+    if (isOpaqueError(message, source))
+        return true;
+    if (ignore?.length) {
+        for (const pattern of ignore) {
+            if (typeof pattern === "string") {
+                if (pattern && message.toLowerCase().includes(pattern.toLowerCase()))
+                    return true;
+            }
+            else if (pattern.test(message))
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=error-noise.js.map

package/dist/shared/error-noise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-noise.js","sourceRoot":"","sources":["../../src/shared/error-noise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,MAAM,iBAAiB,GAAG;IACxB,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,yBAAyB;IACzB,cAAc,EAAE,wDAAwD;IACxE,sBAAsB,EAAE,gDAAgD;IACxE,aAAa,EAAE,uCAAuC;IACtD,WAAW,EAAE,uCAAuC;CACrD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,0BAA0B,GAAa;IAC3C,gCAAgC;IAChC,kEAAkE;IAClE,yDAAyD;IACzD,gCAAgC;IAChC,qBAAqB;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,OAAe,EAAE,MAAc;IACpD,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;AAC9D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,oEAAoE;IACpE,wEAAwE;IACxE,4EAA4E;IAC5E,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAClE,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,EAAkB;IAC3F,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,2EAA2E;IAC3E,0EAA0E;IAC1E,gBAAgB;IAChB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,UAAU,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/F,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,IAAI,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBAAE,OAAO,IAAI,CAAC;YACpF,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/metric-buckets.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Polishd — which time buckets a trend chart should draw.
+ *
+ * Pure: no database, no React, no clock of its own. The counting happens in
+ * SQL (see `getMetricTrends`); this decides the *shape* of the series that
+ * comes out of it, which is where the edge cases live:
+ *
+ *   • **Gap filling.** An hour with no events is a measured zero, not a
+ *     missing point. Without this a quiet night would render as one wide bar
+ *     next to another, silently compressing the axis.
+ *   • **A cap.** A site running for two years has 17,000 hourly buckets. Only
+ *     the most recent `maxBuckets` are drawn.
+ *   • **Anchoring on data, not on now.** The window ends at the newest bucket
+ *     that has something in it, so an install last browsed three days ago
+ *     still gets a chart instead of an empty one.
+ *   • **Clock skew.** `ts` is the visitor's clock. One machine set to next
+ *     year would otherwise anchor the window there and blank the chart for
+ *     everyone, so buckets past the present are discarded.
+ */
+/**
+ * The contiguous run of bucket indexes to render, oldest → newest.
+ *
+ * @param buckets     Bucket indexes that hold data, in any order.
+ * @param maxBuckets  How many to draw at most; the newest win.
+ * @param nowBucket   The bucket the present falls in. Anything later is
+ *                    discarded as clock skew.
+ * @returns Every index from the window's start to its end inclusive — callers
+ *          fill the ones with no data with zeros. Empty when nothing qualifies.
+ */
+export declare function trendWindow(buckets: Iterable<number>, maxBuckets: number, nowBucket: number): number[];
+//# sourceMappingURL=metric-buckets.d.ts.map

package/dist/shared/metric-buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-buckets.d.ts","sourceRoot":"","sources":["../../src/shared/metric-buckets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAcV"}

package/dist/shared/metric-buckets.js

@@ -0,0 +1,49 @@
+/**
+ * Polishd — which time buckets a trend chart should draw.
+ *
+ * Pure: no database, no React, no clock of its own. The counting happens in
+ * SQL (see `getMetricTrends`); this decides the *shape* of the series that
+ * comes out of it, which is where the edge cases live:
+ *
+ *   • **Gap filling.** An hour with no events is a measured zero, not a
+ *     missing point. Without this a quiet night would render as one wide bar
+ *     next to another, silently compressing the axis.
+ *   • **A cap.** A site running for two years has 17,000 hourly buckets. Only
+ *     the most recent `maxBuckets` are drawn.
+ *   • **Anchoring on data, not on now.** The window ends at the newest bucket
+ *     that has something in it, so an install last browsed three days ago
+ *     still gets a chart instead of an empty one.
+ *   • **Clock skew.** `ts` is the visitor's clock. One machine set to next
+ *     year would otherwise anchor the window there and blank the chart for
+ *     everyone, so buckets past the present are discarded.
+ */
+/**
+ * The contiguous run of bucket indexes to render, oldest → newest.
+ *
+ * @param buckets     Bucket indexes that hold data, in any order.
+ * @param maxBuckets  How many to draw at most; the newest win.
+ * @param nowBucket   The bucket the present falls in. Anything later is
+ *                    discarded as clock skew.
+ * @returns Every index from the window's start to its end inclusive — callers
+ *          fill the ones with no data with zeros. Empty when nothing qualifies.
+ */
+export function trendWindow(buckets, maxBuckets, nowBucket) {
+    let first = null;
+    let last = null;
+    for (const b of buckets) {
+        if (b > nowBucket)
+            continue;
+        if (first === null || b < first)
+            first = b;
+        if (last === null || b > last)
+            last = b;
+    }
+    if (first === null || last === null)
+        return [];
+    const start = Math.max(first, last - (Math.max(1, maxBuckets) - 1));
+    const out = [];
+    for (let b = start; b <= last; b++)
+        out.push(b);
+    return out;
+}
+//# sourceMappingURL=metric-buckets.js.map

package/dist/shared/metric-buckets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-buckets.js","sourceRoot":"","sources":["../../src/shared/metric-buckets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,OAAyB,EACzB,UAAkB,EAClB,SAAiB;IAEjB,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,SAAS;YAAE,SAAS;QAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK;YAAE,KAAK,GAAG,CAAC,CAAC;QAC3C,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shared/text-signals.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Polishd — shared "was this click about text?" heuristics.
+ *
+ * One source of truth used from two sides that must never drift:
+ *
+ *   • Live, in the browser (`src/client/dom.ts`) — deciding whether a click
+ *     records as dead/rage or is just reading.
+ *   • Retroactively, on the server (`src/server/reclassify.ts`) — applying the
+ *     same decision to rows stored by older clients, using the stored
+ *     `selector` (which keeps the same 4-level tag path the live ancestor walk
+ *     sees) and `text` label in place of the DOM.
+ *
+ * Dependency-free and runtime-agnostic, like the rest of `shared/`.
+ */
+/**
+ * Block-level prose containers. A click anywhere inside one — including on a
+ * bold word or code span nested in it — is reading, never a dead control.
+ */
+export declare const PROSE_TAGS: ReadonlySet<string>;
+/**
+ * Inline / cell-level text elements. These carry text but are also the exact
+ * shape of a mis-wired fake control (`<span class="link">Click here</span>`),
+ * so on their own they only read as prose past the length threshold below.
+ */
+export declare const INLINE_TEXT_TAGS: ReadonlySet<string>;
+/** Tags the capture layer treats as interactive (see `isInteractive`). */
+export declare const INTERACTIVE_TAGS: ReadonlySet<string>;
+/**
+ * The length heuristic: standalone text this long reads as content; anything
+ * shorter could be a label on something the user believed was clickable.
+ * Stored `text` labels are capped at 80 chars, so the threshold must stay
+ * under that cap for the retro classifier to see it.
+ */
+export declare const PROSE_MIN_CHARS = 40;
+/** Tag names of a stored selector path: "div.card>p.intro>span" → ["div","p","span"]. */
+export declare const selectorTags: (selector: string) => string[];
+/**
+ * The retro mirror of the client's `isTextTarget`, over stored columns:
+ * a prose tag anywhere in the selector path stands in for the ancestor walk,
+ * and the stored label's length stands in for the target's own text. The label
+ * is `innerText`, which includes children — so a layout container wrapping
+ * prose can classify as textual here where the live check would not. For
+ * history that's the right bias: these rows were recorded under rules known to
+ * overcount, and reclassifying reading as reading is the point.
+ */
+export declare const isTextualClickRow: (selector: string | undefined, text: string | undefined) => boolean;
+/**
+ * The single server-side retype decision, shared by the one-time history sweep
+ * and the ingest backstop: a dead/rage click that landed on text becomes a
+ * `text_click` (kept, counted by nothing); everything else keeps its type. A
+ * rage row may have hammered a real control — the selector keeps its tag path,
+ * so anything interactive in it stays rage. (Dead clicks were only ever
+ * recorded on non-interactive targets — no guard needed.)
+ */
+export declare const reclassifiedClickType: (type: string, selector: string | undefined, text: string | undefined) => string;
+//# sourceMappingURL=text-signals.d.ts.map

package/dist/shared/text-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-signals.d.ts","sourceRoot":"","sources":["../../src/shared/text-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,CAGzC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAG/C,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAE/C,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,yFAAyF;AACzF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,MAAM,EAIlC,CAAC;AAErB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,GAAG,SAAS,EAC5B,MAAM,MAAM,GAAG,SAAS,KACvB,OAGF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,UAAU,MAAM,GAAG,SAAS,EAC5B,MAAM,MAAM,GAAG,SAAS,KACvB,MAUF,CAAC"}