@polishd/next 0.2.2 → 0.2.3-dev.1

package/dist/shared/text-signals.js

@@ -0,0 +1,80 @@
+/**
+ * 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 const PROSE_TAGS = new Set([
+    "p", "h1", "h2", "h3", "h4", "h5", "h6",
+    "blockquote", "pre", "li", "dt", "dd", "figcaption",
+]);
+/**
+ * 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 const INLINE_TEXT_TAGS = new Set([
+    "span", "em", "strong", "b", "i", "u", "s", "small", "mark", "code",
+    "abbr", "cite", "q", "time", "sup", "sub", "td", "th", "caption",
+]);
+/** Tags the capture layer treats as interactive (see `isInteractive`). */
+export const INTERACTIVE_TAGS = new Set([
+    "a", "button", "input", "select", "textarea", "label", "summary",
+]);
+/**
+ * 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 const PROSE_MIN_CHARS = 40;
+/** Tag names of a stored selector path: "div.card>p.intro>span" → ["div","p","span"]. */
+export const selectorTags = (selector) => selector
+    .split(">")
+    .map((seg) => seg.split(/[.#]/)[0].trim().toLowerCase())
+    .filter(Boolean);
+/**
+ * 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 const isTextualClickRow = (selector, text) => {
+    if (selector && selectorTags(selector).some((t) => PROSE_TAGS.has(t)))
+        return true;
+    return (text ?? "").trim().length >= PROSE_MIN_CHARS;
+};
+/**
+ * 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 const reclassifiedClickType = (type, selector, text) => {
+    if (type !== "dead_click" && type !== "rage_click")
+        return type;
+    if (type === "rage_click" &&
+        selector &&
+        selectorTags(selector).some((t) => INTERACTIVE_TAGS.has(t))) {
+        return type;
+    }
+    return isTextualClickRow(selector, text) ? "text_click" : type;
+};
+//# sourceMappingURL=text-signals.js.map

package/dist/shared/text-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-signals.js","sourceRoot":"","sources":["../../src/shared/text-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC;IACrD,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IACvC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY;CACpD,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IACnE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS;CACjE,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS;CACjE,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAY,EAAE,CACzD,QAAQ;KACL,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;KACvD,MAAM,CAAC,OAAO,CAAC,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAA4B,EAC5B,IAAwB,EACf,EAAE;IACX,IAAI,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnF,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,eAAe,CAAC;AACvD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAY,EACZ,QAA4B,EAC5B,IAAwB,EAChB,EAAE;IACV,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAChE,IACE,IAAI,KAAK,YAAY;QACrB,QAAQ;QACR,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAC3D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC,CAAC"}

package/dist/shared/types.d.ts

@@ -10,7 +10,7 @@
  * the host notes app.
  */
 /** Every kind of signal we capture. Ordered roughly by synthesis value. */
-export type PolishdEventType = "page_view" | "click" | "rage_click" | "dead_click" | "scroll_depth" | "viewport" | "js_error" | "web_vital" | "hover" | "component_view" | "mount" | "session_end" | "design_scan";
+export type PolishdEventType = "page_view" | "click" | "rage_click" | "dead_click" | "scroll_depth" | "viewport" | "js_error" | "web_vital" | "hover" | "component_view" | "mount" | "session_end" | "text_click" | "design_scan" | "install_state";
 /**
  * A single captured event. The client sends these without a session id; the
  * ingest layer attaches `session_id` server-side from the signed cookie, so a

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,gBAAgB,GAChB,OAAO,GACP,aAAa,GACb,aAAa,CAAC;AAElB;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CACzD;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,gBAAgB,CAc3D,CAAC;AASH,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/E,mBAAmB;AACnB,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,yBAAyB;AACzB,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,CAAC,EAAE,CAAC,CAAC;IACL,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,sDAAsD;IACtD,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,kEAAkE;IAClE,EAAE,EAAE,gBAAgB,EAAE,CAAC;IACvB,mDAAmD;IACnD,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,uDAAuD;IACvD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,gEAAgE;IAChE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,kEAAkE;IAClE,GAAG,EAAE,cAAc,EAAE,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,gBAAgB,GAChB,OAAO,GACP,aAAa,GAIb,YAAY,GACZ,aAAa,GACb,eAAe,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CACzD;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,gBAAgB,CAkB3D,CAAC;AASH,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/E,mBAAmB;AACnB,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,yBAAyB;AACzB,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,CAAC,EAAE,CAAC,CAAC;IACL,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,sDAAsD;IACtD,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,kEAAkE;IAClE,EAAE,EAAE,gBAAgB,EAAE,CAAC;IACvB,mDAAmD;IACnD,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,uDAAuD;IACvD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,gEAAgE;IAChE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,kEAAkE;IAClE,GAAG,EAAE,cAAc,EAAE,CAAC;CACvB"}

package/dist/shared/types.js

@@ -24,5 +24,9 @@ export const CLIENT_EVENT_TYPES = new Set([
     "mount",
     "session_end",
     "design_scan",
+    // Sent only by the dashboard telemetry emitter (once per session): whether
+    // the reporting install has a model connected, and which provider/model.
+    // Never carries a key or any secret — see dashboard/telemetry.tsx.
+    "install_state",
 ]);
 //# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgFH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAkC,IAAI,GAAG,CAAmB;IACzF,WAAW;IACX,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,UAAU;IACV,UAAU;IACV,WAAW;IACX,OAAO;IACP,gBAAgB;IAChB,OAAO;IACP,aAAa;IACb,aAAa;CACd,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqFH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAkC,IAAI,GAAG,CAAmB;IACzF,WAAW;IACX,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,UAAU;IACV,UAAU;IACV,WAAW;IACX,OAAO;IACP,gBAAgB;IAChB,OAAO;IACP,aAAa;IACb,aAAa;IACb,2EAA2E;IAC3E,yEAAyE;IACzE,mEAAmE;IACnE,eAAe;CAChB,CAAC,CAAC"}

package/docs/SETUP.md

@@ -476,9 +476,34 @@ export default definePolishdConfig({
   rageClick: { count: 3, windowMs: 500 },     // N clicks on one element
   flushIntervalMs: 10_000,
   dashboardRoute: "/polishd",                 // never captured; see below
+  ignoreErrors: [],                           // extra error messages to drop
 });
 ```
 
+Errors thrown by **browser extensions are dropped automatically**. Your page's
+`error` handler hears every throw in the tab, not just your code's, so a wallet
+extension failing to reach its background worker ("Failed to connect to
+MetaMask") would otherwise land in your dashboard as one of your site's loudest
+bugs.
+
+This isn't a list of known extensions — it's worked out per error. The browser
+records every script your document actually fetched (Resource Timing), and
+extension code is never in it: the browser injects content scripts, your page
+never asked for them. So an error is classified by where its stack points:
+
+| Verdict | Meaning | What happens |
+| --- | --- | --- |
+| `site` | every frame is code you shipped — including third-party scripts your page loads, like Stripe | recorded normally |
+| `extension` | a frame names an extension URL | dropped |
+| `foreign` | a frame names a script your document never loaded | recorded, marked *not your code* |
+| `unknown` | nothing attributable — an opaque cross-origin `Script error.`, an empty stack | recorded, marked *unattributable* |
+
+Only `extension` is dropped, because only it is certain. The other two are
+shown dimmed in Recent errors rather than hidden — a filter that quietly
+discards what it can't identify is how a real bug goes missing. `ignoreErrors`
+is the escape hatch if you want them gone anyway: strings match
+case-insensitively anywhere in the message, regexes are tested as-is.
+
 The dashboard's own traffic is **never captured**. Reading your analytics is
 browsing too, and left alone it would rank "Refresh summary" as your site's
 most-used feature. Nothing on `dashboardRoute` (or below it) is collected, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polishd/next",
-  "version": "0.2.2",
+  "version": "0.2.3-dev.1",
   "description": "Drop-in product analytics for Next.js — capture real user behavioral signals (rage/dead clicks, scroll depth, errors, web vitals) and explore them on a built-in dashboard. What gets measured gets improved.",
   "type": "module",
   "license": "MIT",
@@ -38,7 +38,7 @@
     "CHANGELOG.md"
   ],
   "bin": {
-    "polishd": "./bin/polishd.mjs"
+    "polishd": "bin/polishd.mjs"
   },
   "exports": {
     ".": {
@@ -75,6 +75,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json && npm run build:css",
     "typecheck": "tsc -p tsconfig.json",
+    "test": "node --experimental-strip-types --test \"src/**/*.test.ts\"",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "build:css": "node scripts/build-css.mjs"
@@ -84,7 +85,13 @@
     "react": ">=18",
     "react-dom": ">=18"
   },
+  "dependencies": {
+    "allpages": "^0.3.3",
+    "playwright-core": "^1.62.1"
+  },
   "optionalDependencies": {
+    "@sparticuz/chromium": "^149.0.0",
+    "@vercel/blob": "^2.8.0",
     "pg": "^8.0.0"
   },
   "devDependencies": {