@polishd/next 0.1.0

package/dist/ai/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Polishd — AI summary types (shared between server and the dashboard UI).
+ *
+ * The AI layer reads the captured analytics, folds in an owner-supplied
+ * description of the site, and asks a model to narrate "how are people actually
+ * using this — what's working and what isn't" as one short paragraph.
+ *
+ * Bring-your-own-key: the owner picks a provider + model and supplies an API
+ * key. Keys live server-side only (in the polishd_meta store / env) and are never
+ * sent back to the browser — the client only ever sees whether one is set.
+ */
+/** Supported model vendors. `openai-compatible` covers OpenRouter, Groq, etc. */
+export type PolishdAIProvider = "anthropic" | "openai" | "openai-compatible" | "google";
+/**
+ * How often the summary refreshes itself. Evaluated when the dashboard loads
+ * (serverless-friendly — no external cron): if the cadence has elapsed AND the
+ * data actually changed, a regenerate runs in the background after the page is
+ * served. Unchanged data never costs tokens regardless of cadence.
+ */
+export type PolishdRefreshCadence = "manual" | "daily" | "weekly";
+/** The full, server-side settings — includes the secret API key. */
+export interface PolishdAISettings {
+    provider: PolishdAIProvider;
+    /** Model id, e.g. "claude-opus-4-8", "gpt-4o-mini", "gemini-1.5-flash". */
+    model: string;
+    /** Secret. Server-only — never serialized to the client. */
+    apiKey: string;
+    /** Base URL override (required for `openai-compatible`; ignored otherwise). */
+    baseUrl?: string;
+    /** Extra steering appended to the system prompt (tone, focus, length…). */
+    instructions?: string;
+    /** Owner's description of the site — what it is, who it's for, key flows. */
+    context?: string;
+    /** Who the product is for — fed into the project profile. */
+    audience?: string;
+    /** Product ideology / values / what success looks like — fed into the profile. */
+    ideology?: string;
+    /** Comma-separated source folders to scan (relative to project root). */
+    sourceDirs?: string;
+    /** Auto-refresh cadence for the summary. Defaults to "manual". */
+    refreshCadence?: PolishdRefreshCadence;
+    /** GitHub repository this site lives in, as "owner/repo". */
+    githubRepo?: string;
+    /** GitHub access token. Secret. Server-only — never serialized to the client. */
+    githubToken?: string;
+    /** File an issue automatically for each new problem a summary finds. */
+    githubAutoIssues?: boolean;
+}
+/** Client-safe view of the settings: same shape, key replaced by a boolean. */
+export interface PolishdAISettingsPublic {
+    provider: PolishdAIProvider;
+    model: string;
+    /** True when an API key is configured (via the dashboard or env). */
+    hasApiKey: boolean;
+    baseUrl?: string;
+    instructions?: string;
+    context?: string;
+    audience?: string;
+    ideology?: string;
+    sourceDirs?: string;
+    refreshCadence?: PolishdRefreshCadence;
+    /** GitHub repository ("owner/repo"), when connected. */
+    githubRepo?: string;
+    /** True when a GitHub token is configured (via the dashboard or env). */
+    hasGithubToken: boolean;
+    /** File an issue automatically for each new problem a summary finds. */
+    githubAutoIssues?: boolean;
+    /** True when provider settings came from env vars (read-only defaults). */
+    fromEnv: boolean;
+}
+/**
+ * A one-time, model-written understanding of the codebase: its purpose, the
+ * key components and interactive elements, and (optionally) the owner's stated
+ * audience and ideology. Cached and reused as authoritative context for every
+ * summary, so the per-summary call never needs to read source again — only an
+ * explicit re-scan does.
+ */
+export interface PolishdProjectProfile {
+    /** The profile prose. */
+    text: string;
+    provider: PolishdAIProvider;
+    model: string;
+    generatedAt: number;
+    /** Hash of the scanned source (paths + sizes) — detects source drift. */
+    fingerprint: string;
+    /** Component/element identifiers the profile explicitly covers. */
+    coveredIdentifiers: string[];
+    /** How many source files went into the scan, and whether it was capped. */
+    sourceFiles: number;
+    truncated: boolean;
+}
+/** Result of a profile scan attempt. */
+export type GenerateProfileResult = {
+    ok: true;
+    profile: PolishdProjectProfile;
+} | {
+    ok: false;
+    error: GenerateProfileError;
+    message: string;
+};
+export type GenerateProfileError = "no-key" | "no-source" | "provider-error";
+/**
+ * A specific problem the model found in the data. Losses are held to a higher
+ * bar than wins: each must cite evidence (a selector, component name, or page
+ * path) that appears in the digest we sent — uncited losses are dropped as
+ * hallucinations — and the server then tries to locate the cited element in
+ * the codebase (`location`/`verified`).
+ */
+export interface PolishdLossItem {
+    /** The specific problem, in plain English. */
+    issue: string;
+    /** The identifier from the data that shows it (selector / component / path). */
+    evidence: string;
+    /** Source file containing the cited element, when found on disk. */
+    location?: string;
+    /** True when the citation was matched to a file in the codebase. */
+    verified: boolean;
+    /** GitHub issue filed for this problem (manually or automatically). */
+    issueUrl?: string;
+    issueNumber?: number;
+}
+/** A generated narrative summary, cached in the store. */
+export interface PolishdSummary {
+    /** The paragraph(s) of narrative. */
+    text: string;
+    /** What's working — may be general. Absent on summaries from older versions. */
+    wins?: string[];
+    /** Specific, evidence-cited problems. Absent on summaries from older versions. */
+    losses?: PolishdLossItem[];
+    /** Provider + model that produced it. */
+    provider: PolishdAIProvider;
+    model: string;
+    /** When it was generated, ms since epoch. */
+    generatedAt: number;
+    /** Hash of the digest it was generated from — drives the "stale" check. */
+    fingerprint: string;
+    /** Token usage, when the provider reported it. */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+/** Result of a generate attempt, returned to the dashboard. */
+export type GenerateSummaryResult = {
+    ok: true;
+    summary: PolishdSummary;
+    regenerated: boolean;
+} | {
+    ok: false;
+    error: GenerateSummaryError;
+    message: string;
+};
+export type GenerateSummaryError = "no-key" | "no-data" | "provider-error";
+/**
+ * What the configured token can actually do against the configured repo,
+ * checked live during onboarding. `contents` (read) powers source reading;
+ * `issues` and `pullRequests` (write) power filing bugs and opening PRs.
+ */
+export interface PolishdGithubStatus {
+    /** The repo as GitHub reports it, e.g. "muskanvaswan/create". */
+    repo: string;
+    defaultBranch: string;
+    /** True when the token can push (create branches / PRs). */
+    canPush: boolean;
+    /** True when the repo has issues enabled. */
+    issuesEnabled: boolean;
+}
+/** Result of verifying the GitHub connection. */
+export type VerifyGithubResult = {
+    ok: true;
+    status: PolishdGithubStatus;
+} | {
+    ok: false;
+    error: GithubError;
+    message: string;
+};
+/** Result of creating an issue from a loss item. */
+export type CreateIssueResult = {
+    ok: true;
+    url: string;
+    number: number;
+} | {
+    ok: false;
+    error: GithubError;
+    message: string;
+};
+export type GithubError = "not-connected" | "not-a-bug" | "github-error";
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/ai/types.js

@@ -0,0 +1,13 @@
+/**
+ * Polishd — AI summary types (shared between server and the dashboard UI).
+ *
+ * The AI layer reads the captured analytics, folds in an owner-supplied
+ * description of the site, and asks a model to narrate "how are people actually
+ * using this — what's working and what isn't" as one short paragraph.
+ *
+ * Bring-your-own-key: the owner picks a provider + model and supplies an API
+ * key. Keys live server-side only (in the polishd_meta store / env) and are never
+ * sent back to the browser — the client only ever sees whether one is set.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/client/init.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Polishd — client capture layer.
+ *
+ * Vanilla DOM, no framework imports, so it drops cleanly into Next's
+ * `instrumentation-client.ts` (runs before hydration) and is trivially
+ * extractable into `@polishd/next`. It attaches global listeners, derives
+ * behavioral signals (rage/dead clicks, scroll depth, web vitals), batches
+ * events, and flushes on an interval, on soft navigation, and on pagehide.
+ */
+import { type PolishdConfig } from "../config";
+type InitOptions = Partial<PolishdConfig>;
+export declare function initPolishd(options?: InitOptions): void;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/client/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/client/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAGrE,KAAK,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAI1C,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAiR3D"}

package/dist/client/init.js

@@ -0,0 +1,274 @@
+/**
+ * Polishd — client capture layer.
+ *
+ * Vanilla DOM, no framework imports, so it drops cleanly into Next's
+ * `instrumentation-client.ts` (runs before hydration) and is trivially
+ * extractable into `@polishd/next`. It attaches global listeners, derives
+ * behavioral signals (rage/dead clicks, scroll depth, web vitals), batches
+ * events, and flushes on an interval, on soft navigation, and on pagehide.
+ */
+import { defaultPolishdConfig } from "../config";
+let started = false;
+export function initPolishd(options = {}) {
+    // Guard: client-only, run once, respect enable flag and Do Not Track.
+    if (typeof window === "undefined" || started)
+        return;
+    const cfg = { ...defaultPolishdConfig, ...options };
+    if (!cfg.enabled)
+        return;
+    if (navigator.doNotTrack === "1")
+        return;
+    // Per-session sampling decision, stable for the page's lifetime.
+    if (cfg.sampleRate < 1 && Math.random() > cfg.sampleRate)
+        return;
+    started = true;
+    const queue = [];
+    let currentPath = location.pathname;
+    let maxScrollPct = 0;
+    const push = (e) => {
+        queue.push({ ts: Date.now(), path: currentPath, ...e });
+        if (queue.length >= cfg.maxBatchSize)
+            flush();
+    };
+    // Expose a track function so TrackingWrapper components can emit explicit
+    // events (e.g. hover) without coupling to React internals.
+    window.__polishdTrack = push;
+    // ---- transport -----------------------------------------------------------
+    const flush = (useBeacon = false) => {
+        if (queue.length === 0)
+            return;
+        const batch = queue.splice(0, queue.length);
+        const body = JSON.stringify({ events: batch, page: currentPath });
+        // sendBeacon survives unload; fetch is used for periodic flushes.
+        if (useBeacon && navigator.sendBeacon) {
+            const ok = navigator.sendBeacon(cfg.apiRoute, new Blob([body], { type: "application/json" }));
+            if (!ok)
+                queue.unshift(...batch); // re-queue on beacon rejection
+            return;
+        }
+        fetch(cfg.apiRoute, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body,
+            keepalive: true,
+        }).catch(() => {
+            // Network hiccup: put events back so the next flush retries them.
+            queue.unshift(...batch);
+        });
+    };
+    // ---- DOM helpers ---------------------------------------------------------
+    const INTERACTIVE = new Set(["A", "BUTTON", "INPUT", "SELECT", "TEXTAREA", "LABEL", "SUMMARY"]);
+    const isInteractive = (el) => {
+        let node = el;
+        for (let depth = 0; node && depth < 4; depth++) {
+            if (INTERACTIVE.has(node.tagName))
+                return true;
+            const role = node.getAttribute("role");
+            if (role && /button|link|menuitem|tab|checkbox|radio|switch/.test(role))
+                return true;
+            if (node.hasAttribute("onclick") || node.isContentEditable)
+                return true;
+            node = node.parentElement;
+        }
+        return false;
+    };
+    /** True when the click coincided with the user highlighting text. */
+    const hasTextSelection = () => {
+        const sel = typeof window.getSelection === "function" ? window.getSelection() : null;
+        return !!sel && !sel.isCollapsed && sel.toString().trim().length > 0;
+    };
+    /** Walk up for the nearest `data-component`, the key synthesis signal. */
+    const componentOf = (el) => {
+        let node = el;
+        for (let depth = 0; node && depth < 8; depth++) {
+            const c = node.getAttribute("data-component");
+            if (c)
+                return c;
+            node = node.parentElement;
+        }
+        return undefined;
+    };
+    /** Compact, stable-ish selector path (tag + id + first class), capped. */
+    const selectorOf = (el) => {
+        if (!el)
+            return undefined;
+        const parts = [];
+        let node = el;
+        for (let depth = 0; node && depth < 4 && node.tagName !== "BODY"; depth++) {
+            let part = node.tagName.toLowerCase();
+            if (node.id) {
+                parts.unshift(`${part}#${node.id}`);
+                break;
+            }
+            const cls = (node.getAttribute("class") || "").trim().split(/\s+/)[0];
+            if (cls)
+                part += `.${cls}`;
+            parts.unshift(part);
+            node = node.parentElement;
+        }
+        return parts.join(">");
+    };
+    const labelOf = (el) => {
+        const t = el?.innerText || el?.textContent || "";
+        const trimmed = t.replace(/\s+/g, " ").trim();
+        return trimmed ? trimmed.slice(0, 80) : undefined;
+    };
+    // ---- click + rage + dead -------------------------------------------------
+    let lastClick = { selector: "", time: 0, count: 0 };
+    const onClick = (ev) => {
+        const target = ev.target;
+        if (!target)
+            return;
+        const selector = selectorOf(target);
+        const component = componentOf(target);
+        const text = labelOf(target);
+        const now = Date.now();
+        // Rage: same selector clicked `count` times inside `windowMs`.
+        if (selector === lastClick.selector && now - lastClick.time < cfg.rageClick.windowMs) {
+            lastClick.count++;
+            lastClick.time = now;
+            if (lastClick.count === cfg.rageClick.count) {
+                push({ type: "rage_click", selector, component, text });
+            }
+        }
+        else {
+            lastClick = { selector: selector ?? "", time: now, count: 1 };
+        }
+        // Dead: click that hits nothing interactive (likely confusion).
+        if (!isInteractive(target)) {
+            // A drag-to-highlight fires a click on the (non-interactive) text node on
+            // mouse-up. That's intent, not confusion — don't log it as a dead click.
+            if (hasTextSelection())
+                return;
+            push({ type: "dead_click", selector, component, text });
+        }
+        else {
+            push({ type: "click", selector, component, text });
+        }
+    };
+    // ---- page views (incl. soft navigation) ----------------------------------
+    const emitPageView = () => {
+        // Flush the previous page's scroll depth before switching context.
+        if (maxScrollPct > 0)
+            push({ type: "scroll_depth", value: maxScrollPct });
+        currentPath = location.pathname;
+        maxScrollPct = 0;
+        push({ type: "page_view", path: currentPath });
+    };
+    // Patch History API so Next.js soft navigations emit page views.
+    const wrapHistory = (method) => {
+        const original = history[method];
+        history[method] = function (...args) {
+            const ret = original.apply(this, args);
+            if (location.pathname !== currentPath)
+                emitPageView();
+            return ret;
+        };
+    };
+    // ---- viewport / device size ----------------------------------------------
+    // Coarse device buckets keyed off CSS-pixel width. Aligns with common
+    // breakpoints (Tailwind sm/lg) so categories read intuitively on the
+    // dashboard. The category is stored in `text` (a plain, portable column) so
+    // it can be grouped without per-backend JSON querying.
+    const deviceCategory = (w) => w < 640 ? "mobile" : w < 1024 ? "tablet" : "desktop";
+    const emitViewport = () => {
+        const w = window.innerWidth || document.documentElement.clientWidth || 0;
+        const h = window.innerHeight || document.documentElement.clientHeight || 0;
+        if (w <= 0)
+            return;
+        push({
+            type: "viewport",
+            value: w,
+            text: deviceCategory(w),
+            meta: { w, h, dpr: Math.round((window.devicePixelRatio || 1) * 100) / 100 },
+        });
+    };
+    // ---- scroll depth --------------------------------------------------------
+    const onScroll = () => {
+        const doc = document.documentElement;
+        const scrollable = doc.scrollHeight - doc.clientHeight;
+        const pct = scrollable <= 0 ? 100 : Math.round((doc.scrollTop / scrollable) * 100);
+        if (pct > maxScrollPct)
+            maxScrollPct = Math.min(100, pct);
+    };
+    // ---- errors --------------------------------------------------------------
+    const onError = (ev) => {
+        push({
+            type: "js_error",
+            component: componentOf(ev.target),
+            meta: {
+                message: String(ev.message).slice(0, 300),
+                source: ev.filename || "",
+                line: ev.lineno || 0,
+            },
+        });
+    };
+    const onRejection = (ev) => {
+        const reason = ev.reason;
+        push({
+            type: "js_error",
+            meta: { message: String(reason?.message ?? reason).slice(0, 300), kind: "unhandledrejection" },
+        });
+    };
+    // ---- web vitals (LCP, CLS) ----------------------------------------------
+    const observeVitals = () => {
+        if (typeof PerformanceObserver === "undefined")
+            return;
+        try {
+            // Largest Contentful Paint — last entry wins.
+            let lcp = 0;
+            new PerformanceObserver((list) => {
+                for (const entry of list.getEntries())
+                    lcp = entry.startTime;
+            }).observe({ type: "largest-contentful-paint", buffered: true });
+            // Cumulative Layout Shift — sum of non-input shifts.
+            let cls = 0;
+            new PerformanceObserver((list) => {
+                for (const entry of list.getEntries()) {
+                    const e = entry;
+                    if (!e.hadRecentInput)
+                        cls += e.value;
+                }
+            }).observe({ type: "layout-shift", buffered: true });
+            // Report the finalized values when the page is hidden.
+            addEventListener("visibilitychange", () => {
+                if (document.visibilityState !== "hidden")
+                    return;
+                if (lcp > 0)
+                    push({ type: "web_vital", value: Math.round(lcp), meta: { name: "LCP" } });
+                push({ type: "web_vital", value: Math.round(cls * 1000) / 1000, meta: { name: "CLS" } });
+            }, { once: true });
+        }
+        catch {
+            /* unsupported entry types — skip vitals */
+        }
+    };
+    // ---- lifecycle -----------------------------------------------------------
+    document.addEventListener("click", onClick, { capture: true, passive: true });
+    addEventListener("scroll", onScroll, { passive: true });
+    addEventListener("error", onError, true);
+    addEventListener("unhandledrejection", onRejection);
+    wrapHistory("pushState");
+    wrapHistory("replaceState");
+    addEventListener("popstate", () => {
+        if (location.pathname !== currentPath)
+            emitPageView();
+    });
+    // Final flush + session_end as the page goes away.
+    addEventListener("pagehide", () => {
+        if (maxScrollPct > 0)
+            push({ type: "scroll_depth", value: maxScrollPct });
+        push({ type: "session_end" });
+        flush(true);
+    });
+    addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden")
+            flush(true);
+    });
+    observeVitals();
+    setInterval(() => flush(false), cfg.flushIntervalMs);
+    // One device/viewport sample per session, plus the initial page view.
+    emitViewport();
+    push({ type: "page_view", path: currentPath });
+}
+//# sourceMappingURL=init.js.map

package/dist/client/init.js.map

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

package/dist/client/monitor.d.ts

@@ -0,0 +1,23 @@
+import type { PolishdEvent } from "../shared/types";
+type TrackFn = (e: Omit<PolishdEvent, "ts" | "path"> & Partial<Pick<PolishdEvent, "ts" | "path">>) => void;
+declare global {
+    interface Window {
+        __polishdTrack?: TrackFn;
+    }
+}
+type Props = {
+    /** Name shown in the Polishd dashboard — keep it kebab-case and stable. */
+    name: string;
+    children: React.ReactNode;
+    className?: string;
+    /**
+     * Treat this as a content region: emit a `mount` event and track viewport
+     * time, scroll depth, and rendered height (component_view). Leave off
+     * (default) for interactive controls like buttons, where only hover + click
+     * attribution is wanted.
+     */
+    content?: boolean;
+};
+export declare function PolishdMonitor({ name, children, className, content }: Props): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=monitor.d.ts.map

package/dist/client/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/client/monitor.tsx"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,KAAK,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;AAE3G,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;CACF;AAED,KAAK,KAAK,GAAG;IACX,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAaF,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAe,EAAE,EAAE,KAAK,+BA2InF"}