@polishd/next 0.1.0 → 0.2.1-dev.0

package/dist/proxy.d.ts

@@ -9,7 +9,7 @@
  * To compose with your own proxy logic, import `withPolishdSession` and
  * `polishdMatcher` instead and thread the same NextResponse through.
  */
-import type { NextRequest } from "next/server";
+import { NextResponse, type NextRequest } from "next/server";
 import type { PolishdConfig } from "./config";
 import { withPolishdSession } from "./session";
 export { withPolishdSession };
@@ -21,7 +21,7 @@ export { withPolishdSession };
  * routes don't need it. This is Next's officially recommended matcher shape.
  */
 export declare const polishdMatcher: string[];
-export declare function proxy(request: NextRequest): import("next/server").NextResponse<unknown>;
+export declare function proxy(request: NextRequest): NextResponse<unknown>;
 export declare const config: {
     matcher: string[];
 };
@@ -29,12 +29,60 @@ export declare const config: {
  * Build a configured proxy — use when you need a non-default cookie name (e.g.
  * preserving a legacy `session` cookie across a migration):
  *
- *   const { proxy, matcher } = createPolishdProxy({ sessionCookie: "polish_session" });
+ *   const { proxy } = createPolishdProxy({ sessionCookie: "polish_session" });
  *   export { proxy };
- *   export const config = { matcher };
+ *   export const config = {
+ *     matcher: ["/((?!api|_next/static|_next/image|favicon|assets).*)"],
+ *   };
  */
 export declare function createPolishdProxy(config?: Partial<PolishdConfig>): {
-    proxy: (request: NextRequest) => import("next/server").NextResponse<unknown>;
+    proxy: (request: NextRequest) => NextResponse<unknown>;
     matcher: string[];
 };
+/** A host's own proxy handler. May be sync or async, and may return nothing. */
+export type PolishdComposableHandler = (request: NextRequest) => NextResponse | undefined | void | Promise<NextResponse | undefined | void>;
+export interface ComposePolishdOptions {
+    /**
+     * The paths your own handler ran on *before* Polishd was added.
+     *
+     * This is the part of merging that goes wrong quietly. Next allows exactly
+     * one proxy module per app, so adding Polishd means widening
+     * `config.matcher` to the union of both — and Polishd's matcher is
+     * near-total. Your handler, which you deliberately scoped to two routes,
+     * silently starts running on every request in the app. Nothing errors; your
+     * redirects and rewrites just begin firing where they never did before.
+     *
+     * Declare the original scope here and it is re-applied as an internal guard,
+     * so the widened matcher feeds Polishd everything while your handler keeps
+     * seeing exactly what it saw before.
+     *
+     * Accepts Next's matcher strings (`"/admin/:path*"`, `"/((?!api).*)"`) or a
+     * `RegExp` when you want to be exact. Omit it only if your handler genuinely
+     * did run on everything.
+     */
+    matcher?: string | RegExp | Array<string | RegExp>;
+    /** Non-default cookie name, matching your route and client config. */
+    config?: Partial<PolishdConfig>;
+}
+/**
+ * Wrap an existing proxy handler so Polishd's session cookie is minted
+ * alongside it:
+ *
+ *   // proxy.ts  (middleware.ts on Next 15)
+ *   export const proxy = composePolishd(myProxy, { matcher: "/admin/:path*" });
+ *   export const config = {
+ *     // Still written by hand: Next statically parses this and it must be an
+ *     // inline literal. The union of your paths and Polishd's.
+ *     matcher: ["/((?!api|_next/static|_next/image|favicon|assets).*)"],
+ *   };
+ *
+ * Your handler runs first and its response is threaded through, so a redirect
+ * or rewrite you return carries the analytics cookie rather than losing it.
+ * Returning nothing is fine — Polishd continues with a default response.
+ *
+ * Widening the matcher is safe from Polishd's side: `withPolishdSession`
+ * returns early once the cookie is present (see session.ts), so the extra
+ * paths cost a cookie lookup and nothing else.
+ */
+export declare function composePolishd(handler: PolishdComposableHandler, opts?: ComposePolishdOptions): (request: NextRequest) => Promise<NextResponse>;
 //# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAA2D,CAAC;AAEvF,wBAAgB,KAAK,CAAC,OAAO,EAAE,WAAW,+CAEzC;AAED,eAAO,MAAM,MAAM;;CAA8B,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;qBAEjD,WAAW;;EAG/B"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAA2D,CAAC;AAEvF,wBAAgB,KAAK,CAAC,OAAO,EAAE,WAAW,yBAEzC;AAED,eAAO,MAAM,MAAM;;CAElB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;qBAEjD,WAAW;;EAG/B;AAID,gFAAgF;AAChF,MAAM,MAAM,wBAAwB,GAAG,CACrC,OAAO,EAAE,WAAW,KACjB,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACjC;AAyBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,wBAAwB,EACjC,IAAI,GAAE,qBAA0B,IAKJ,SAAS,WAAW,KAAG,OAAO,CAAC,YAAY,CAAC,CAMzE"}

package/dist/proxy.js

@@ -1,3 +1,15 @@
+/**
+ * @polishd/next/proxy — anonymous session assignment.
+ *
+ * Consumers wire this up with a one-line re-export:
+ *
+ *   // src/proxy.ts   (Next 16; `middleware.ts` on Next 15)
+ *   export { proxy, config } from "@polishd/next/proxy";
+ *
+ * To compose with your own proxy logic, import `withPolishdSession` and
+ * `polishdMatcher` instead and thread the same NextResponse through.
+ */
+import { NextResponse } from "next/server";
 import { withPolishdSession } from "./session";
 export { withPolishdSession };
 /**
@@ -11,14 +23,18 @@ export const polishdMatcher = ["/((?!api|_next/static|_next/image|favicon|assets
 export function proxy(request) {
     return withPolishdSession(request);
 }
-export const config = { matcher: polishdMatcher };
+export const config = {
+    matcher: ["/((?!api|_next/static|_next/image|favicon|assets).*)"],
+};
 /**
  * Build a configured proxy — use when you need a non-default cookie name (e.g.
  * preserving a legacy `session` cookie across a migration):
  *
- *   const { proxy, matcher } = createPolishdProxy({ sessionCookie: "polish_session" });
+ *   const { proxy } = createPolishdProxy({ sessionCookie: "polish_session" });
  *   export { proxy };
- *   export const config = { matcher };
+ *   export const config = {
+ *     matcher: ["/((?!api|_next/static|_next/image|favicon|assets).*)"],
+ *   };
  */
 export function createPolishdProxy(config = {}) {
     return {
@@ -26,4 +42,58 @@ export function createPolishdProxy(config = {}) {
         matcher: polishdMatcher,
     };
 }
+/**
+ * Translate one Next matcher entry into a testable RegExp.
+ *
+ * Next's own matcher syntax is a subset of path-to-regexp: literal paths,
+ * `:param` and `:param*` segments, and raw regex bodies in parentheses. Those
+ * are handled here; anything more exotic can be passed as a `RegExp` directly.
+ */
+function toRegExp(pattern) {
+    if (pattern instanceof RegExp)
+        return pattern;
+    // Already regex-shaped, as in the near-total matcher Polishd itself uses.
+    if (pattern.includes("("))
+        return new RegExp(`^${pattern}$`);
+    let out = "";
+    for (const seg of pattern.split("/").slice(1)) {
+        if (seg.startsWith(":")) {
+            // `:path*` matches zero or more segments, so the slash goes with it.
+            out += seg.endsWith("*") ? "(?:/.*)?" : "/[^/]+";
+        }
+        else {
+            out += `/${seg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`;
+        }
+    }
+    return new RegExp(`^${out || "/"}$`);
+}
+/**
+ * Wrap an existing proxy handler so Polishd's session cookie is minted
+ * alongside it:
+ *
+ *   // proxy.ts  (middleware.ts on Next 15)
+ *   export const proxy = composePolishd(myProxy, { matcher: "/admin/:path*" });
+ *   export const config = {
+ *     // Still written by hand: Next statically parses this and it must be an
+ *     // inline literal. The union of your paths and Polishd's.
+ *     matcher: ["/((?!api|_next/static|_next/image|favicon|assets).*)"],
+ *   };
+ *
+ * Your handler runs first and its response is threaded through, so a redirect
+ * or rewrite you return carries the analytics cookie rather than losing it.
+ * Returning nothing is fine — Polishd continues with a default response.
+ *
+ * Widening the matcher is safe from Polishd's side: `withPolishdSession`
+ * returns early once the cookie is present (see session.ts), so the extra
+ * paths cost a cookie lookup and nothing else.
+ */
+export function composePolishd(handler, opts = {}) {
+    const declared = opts.matcher === undefined ? [] : [opts.matcher].flat();
+    const guards = declared.map(toRegExp);
+    return async function proxy(request) {
+        const inScope = guards.length === 0 || guards.some((re) => re.test(request.nextUrl.pathname));
+        const response = inScope ? await handler(request) : undefined;
+        return withPolishdSession(request, response ?? NextResponse.next(), opts.config);
+    };
+}
 //# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,sDAAsD,CAAC,CAAC;AAEvF,MAAM,UAAU,KAAK,CAAC,OAAoB;IACxC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiC,EAAE;IACpE,OAAO;QACL,KAAK,EAAE,CAAC,OAAoB,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;QAC/E,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,sDAAsD,CAAC,CAAC;AAEvF,MAAM,UAAU,KAAK,CAAC,OAAoB;IACxC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,CAAC,sDAAsD,CAAC;CAClE,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiC,EAAE;IACpE,OAAO;QACL,KAAK,EAAE,CAAC,OAAoB,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;QAC/E,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC;AAiCD;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,OAAwB;IACxC,IAAI,OAAO,YAAY,MAAM;QAAE,OAAO,OAAO,CAAC;IAC9C,0EAA0E;IAC1E,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;IAC7D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,qEAAqE;YACrE,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,GAAG,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAiC,EACjC,OAA8B,EAAE;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEtC,OAAO,KAAK,UAAU,KAAK,CAAC,OAAoB;QAC9C,MAAM,OAAO,GACX,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,OAAO,kBAAkB,CAAC,OAAO,EAAE,QAAQ,IAAI,YAAY,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC"}

package/dist/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAIpE,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAEvC,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,IAGzC,KAAK,WAAW;;;oDAe5C;AAED,wDAAwD;AACxD,eAAO,MAAM,IAAI,QAlBiB,WAAW;;;mDAkBL,CAAC"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAI1F,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAEvC,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,IAWzC,KAAK,WAAW;;;oDAe5C;AAED,wDAAwD;AACxD,eAAO,MAAM,IAAI,QAlBiB,WAAW;;;mDAkBL,CAAC"}

package/dist/route.js

@@ -9,14 +9,22 @@
  * Or build a configured handler with `createPolishdRoute({ sessionCookie })`.
  */
 import { NextResponse } from "next/server";
-import { defaultPolishdConfig } from "./config";
+import { defaultPolishdConfig, resolveSessionCookie } from "./config";
 import { ingest } from "./server/ingest";
 // node:sqlite / pg need the Node runtime — never the Edge runtime.
 export const runtime = "nodejs";
 // This route mutates per-request; it must never be statically cached.
 export const dynamic = "force-dynamic";
 export function createPolishdRoute(config = {}) {
-    const cfg = { ...defaultPolishdConfig, ...config };
+    // The cookie name is resolved the way the proxy resolves it, so a
+    // `POLISHD_SESSION_COOKIE` set once reaches both sides rather than half of
+    // them — and it is folded into `cfg` so everything downstream, ingest
+    // included, sees the same name this handler reads.
+    const cfg = {
+        ...defaultPolishdConfig,
+        ...config,
+        sessionCookie: resolveSessionCookie(config.sessionCookie),
+    };
     return async function POST(req) {
         let body;
         try {
@@ -26,7 +34,7 @@ export function createPolishdRoute(config = {}) {
             return NextResponse.json({ ok: false, reason: "bad_json" }, { status: 400 });
         }
         const cookieValue = req.cookies.get(cfg.sessionCookie)?.value;
-        const result = await ingest(body, cookieValue);
+        const result = await ingest(body, cookieValue, cfg);
         // Always succeed for valid requests so the beacon never retries on the
         // client; real failures (bad payloads) return 4xx above.
         return NextResponse.json(result, { status: result.ok ? 200 : 400 });

package/dist/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAsB,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,mEAAmE;AACnE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAChC,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC;AAEvC,MAAM,UAAU,kBAAkB,CAAC,SAAiC,EAAE;IACpE,MAAM,GAAG,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAAC;IAEnD,OAAO,KAAK,UAAU,IAAI,CAAC,GAAgB;QACzC,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAE/C,uEAAuE;QACvE,yDAAyD;QACzD,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAsB,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,mEAAmE;AACnE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAChC,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC;AAEvC,MAAM,UAAU,kBAAkB,CAAC,SAAiC,EAAE;IACpE,kEAAkE;IAClE,2EAA2E;IAC3E,sEAAsE;IACtE,mDAAmD;IACnD,MAAM,GAAG,GAAG;QACV,GAAG,oBAAoB;QACvB,GAAG,MAAM;QACT,aAAa,EAAE,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC;KAC1D,CAAC;IAEF,OAAO,KAAK,UAAU,IAAI,CAAC,GAAgB;QACzC,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAEpD,uEAAuE;QACvE,yDAAyD;QACzD,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/server/design.d.ts

@@ -0,0 +1,93 @@
+export interface DesignFontUsage {
+    family: string;
+    sizePx: number;
+    weight: number;
+    /** Elements across all pages rendering this exact combination. */
+    count: number;
+    /** Real text sampled from the site in this style. */
+    sample: string | null;
+    /** Tag names seen carrying it (h1, p, button…). */
+    tags: string[];
+    pages: string[];
+    /** True when this looks like a one-off rather than part of the type scale. */
+    outlier: boolean;
+}
+export type DesignColorRole = "text" | "background" | "border";
+export interface DesignColorUsage {
+    hex: string;
+    /** Total tallies across roles. */
+    count: number;
+    roles: Record<DesignColorRole, number>;
+    pages: string[];
+    /** Share of all color tallies, 0–100. */
+    pct: number;
+    outlier: boolean;
+}
+export interface DesignContrastPair {
+    fg: string;
+    bg: string;
+    count: number;
+    /** Smallest font size this pair was seen at, px. */
+    minSizePx: number;
+    /** WCAG 2.x contrast ratio, e.g. 4.53. */
+    ratio: number;
+    /** The AA threshold that applies at `minSizePx` (3 for large text, else 4.5). */
+    required: number;
+    passes: boolean;
+    pages: string[];
+}
+export interface DesignRadiusUsage {
+    /** "8px", "9999px (full)" style label. */
+    value: string;
+    count: number;
+    pages: string[];
+    outlier: boolean;
+}
+export interface DesignSpacingUsage {
+    px: number;
+    count: number;
+    pages: string[];
+    /** True when the value sits off the site's dominant spacing grid. */
+    offGrid: boolean;
+}
+export type DesignFlagSection = "typography" | "color" | "contrast" | "radius" | "spacing";
+export interface DesignFlag {
+    section: DesignFlagSection;
+    severity: "warn" | "info";
+    message: string;
+}
+export interface DesignPageScan {
+    path: string;
+    scannedAt: number;
+    elements: number;
+}
+export interface PolishdDesignData {
+    ready: boolean;
+    /** Pages with a scan, newest first. */
+    pages: DesignPageScan[];
+    fonts: DesignFontUsage[];
+    /** Distinct font families, most used first. */
+    families: {
+        family: string;
+        count: number;
+    }[];
+    colors: DesignColorUsage[];
+    contrast: DesignContrastPair[];
+    radii: DesignRadiusUsage[];
+    spacing: DesignSpacingUsage[];
+    flags: DesignFlag[];
+}
+export declare const EMPTY_DESIGN_DATA: PolishdDesignData;
+/** WCAG 2.x contrast ratio between two hex colors, or null if unparseable. */
+export declare function contrastRatio(a: string, b: string): number | null;
+/**
+ * Build the full design dataset: merge per-page tallies site-wide, then run
+ * the deterministic checks. Read-only; degrades to `EMPTY_DESIGN_DATA`.
+ */
+export declare function getDesignData(): Promise<PolishdDesignData>;
+/**
+ * Rule-based checks over the aggregated data. Pure function of its input so
+ * it's easy to test and the AI layer can quote the same findings verbatim.
+ */
+export declare function buildDesignFlags(data: PolishdDesignData): DesignFlag[];
+//# sourceMappingURL=design.d.ts.map

package/dist/server/design.d.ts.map

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