alabjs 0.2.0 → 0.2.1

package/dist/analytics/handler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * H3 route handlers for the AlabJS analytics endpoints.
+ *
+ * POST /_alabjs/vitals  — receives Core Web Vitals beacons from the browser.
+ * GET  /_alabjs/analytics — returns aggregated per-route stats (requires auth).
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+/**
+ * POST /_alabjs/vitals
+ *
+ * Accepts a JSON beacon: { name, value, route }
+ * Called by the browser via navigator.sendBeacon — no auth required.
+ * Always responds 204 so the browser doesn't wait.
+ */
+export declare function handleVitalsBeacon(req: IncomingMessage, res: ServerResponse): Promise<void>;
+/**
+ * GET /_alabjs/analytics
+ *
+ * Returns a JSON snapshot of all collected metrics.
+ * Protected by Authorization: Bearer <ALAB_ANALYTICS_SECRET>.
+ * Falls back to ALAB_REVALIDATE_SECRET if ALAB_ANALYTICS_SECRET is unset.
+ */
+export declare function handleAnalyticsDashboard(req: IncomingMessage, res: ServerResponse): void;
+//# sourceMappingURL=handler.d.ts.map

package/dist/analytics/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/analytics/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAejE;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,IAAI,CAoBN"}

package/dist/analytics/handler.js

@@ -0,0 +1,87 @@
+/**
+ * H3 route handlers for the AlabJS analytics endpoints.
+ *
+ * POST /_alabjs/vitals  — receives Core Web Vitals beacons from the browser.
+ * GET  /_alabjs/analytics — returns aggregated per-route stats (requires auth).
+ */
+import { recordMetric, getSnapshot } from "./store.js";
+const METRIC_NAMES = new Set(["LCP", "CLS", "INP", "TTFB", "FCP"]);
+/** Read the raw request body as a UTF-8 string. */
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+/**
+ * POST /_alabjs/vitals
+ *
+ * Accepts a JSON beacon: { name, value, route }
+ * Called by the browser via navigator.sendBeacon — no auth required.
+ * Always responds 204 so the browser doesn't wait.
+ */
+export async function handleVitalsBeacon(req, res) {
+    res.setHeader("access-control-allow-origin", "*");
+    if (req.method === "OPTIONS") {
+        res.setHeader("access-control-allow-methods", "POST, OPTIONS");
+        res.setHeader("access-control-allow-headers", "content-type");
+        res.statusCode = 204;
+        res.end();
+        return;
+    }
+    if (req.method !== "POST") {
+        res.statusCode = 405;
+        res.end();
+        return;
+    }
+    try {
+        const raw = await readBody(req);
+        // sendBeacon may batch multiple events as a JSON array or single object.
+        const parsed = JSON.parse(raw);
+        const events = Array.isArray(parsed) ? parsed : [parsed];
+        for (const ev of events) {
+            if (ev !== null &&
+                typeof ev === "object" &&
+                "name" in ev && typeof ev.name === "string" &&
+                "value" in ev && typeof ev.value === "number" &&
+                "route" in ev && typeof ev.route === "string" &&
+                METRIC_NAMES.has(ev.name)) {
+                recordMetric(ev.route.slice(0, 256), // cap length for safety
+                ev.name, ev.value);
+            }
+        }
+    }
+    catch {
+        // Malformed beacon — swallow silently, still return 204.
+    }
+    res.statusCode = 204;
+    res.end();
+}
+/**
+ * GET /_alabjs/analytics
+ *
+ * Returns a JSON snapshot of all collected metrics.
+ * Protected by Authorization: Bearer <ALAB_ANALYTICS_SECRET>.
+ * Falls back to ALAB_REVALIDATE_SECRET if ALAB_ANALYTICS_SECRET is unset.
+ */
+export function handleAnalyticsDashboard(req, res) {
+    const secret = process.env["ALAB_ANALYTICS_SECRET"] ??
+        process.env["ALAB_REVALIDATE_SECRET"];
+    if (secret) {
+        const auth = req.headers["authorization"] ?? "";
+        const token = auth.startsWith("Bearer ") ? auth.slice(7) : "";
+        if (token !== secret) {
+            res.statusCode = 401;
+            res.setHeader("content-type", "application/json");
+            res.end(JSON.stringify({ error: "Unauthorized. Set Authorization: Bearer <ALAB_ANALYTICS_SECRET>." }));
+            return;
+        }
+    }
+    res.statusCode = 200;
+    res.setHeader("content-type", "application/json; charset=utf-8");
+    res.setHeader("cache-control", "no-store");
+    res.end(JSON.stringify(getSnapshot(), null, 2));
+}
+//# sourceMappingURL=handler.js.map

package/dist/analytics/handler.js.map

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

package/dist/analytics/store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * In-memory analytics store.
+ *
+ * Keeps a ring buffer of the last RING_SIZE samples for each
+ * (route, metric) pair and exposes p75 aggregates.
+ *
+ * All writes are synchronous and happen in the same Node.js event-loop
+ * turn as the beacon POST — no blocking, no external I/O.
+ */
+export type MetricName = "LCP" | "CLS" | "INP" | "TTFB" | "FCP";
+/**
+ * Record one metric sample for a route.
+ * If the ring buffer is full, the oldest sample is evicted.
+ */
+export declare function recordMetric(route: string, name: MetricName, value: number): void;
+export interface RouteStats {
+    pageviews: number;
+    lcp_p75: number | null;
+    cls_p75: number | null;
+    inp_p75: number | null;
+    ttfb_p75: number | null;
+    fcp_p75: number | null;
+}
+export interface AnalyticsSnapshot {
+    routes: Record<string, RouteStats>;
+    /** ISO timestamp of when the snapshot was taken. */
+    asOf: string;
+}
+/** Return an aggregated snapshot of all collected metrics. */
+export declare function getSnapshot(): AnalyticsSnapshot;
+/** Clear all stored data (useful in tests). */
+export declare function clearStore(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/analytics/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/analytics/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAyBhE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOjF;AAUD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,IAAI,iBAAiB,CAa/C;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/analytics/store.js

@@ -0,0 +1,68 @@
+/**
+ * In-memory analytics store.
+ *
+ * Keeps a ring buffer of the last RING_SIZE samples for each
+ * (route, metric) pair and exposes p75 aggregates.
+ *
+ * All writes are synchronous and happen in the same Node.js event-loop
+ * turn as the beacon POST — no blocking, no external I/O.
+ */
+/** Maximum samples retained per (route, metric) bucket. */
+const RING_SIZE = 500;
+const METRIC_NAMES = ["LCP", "CLS", "INP", "TTFB", "FCP"];
+/** route path → bucket */
+const store = new Map();
+function getBucket(route) {
+    let bucket = store.get(route);
+    if (!bucket) {
+        const samples = {};
+        for (const m of METRIC_NAMES)
+            samples[m] = [];
+        bucket = { samples, pageviews: 0 };
+        store.set(route, bucket);
+    }
+    return bucket;
+}
+/**
+ * Record one metric sample for a route.
+ * If the ring buffer is full, the oldest sample is evicted.
+ */
+export function recordMetric(route, name, value) {
+    if (!METRIC_NAMES.includes(name))
+        return;
+    const bucket = getBucket(route);
+    const buf = bucket.samples[name];
+    buf.push(value);
+    if (buf.length > RING_SIZE)
+        buf.shift();
+    if (name === "LCP")
+        bucket.pageviews++;
+}
+/** Compute the p75 of an array of numbers, or null if empty. */
+function p75(values) {
+    if (values.length === 0)
+        return null;
+    const sorted = [...values].sort((a, b) => a - b);
+    const idx = Math.floor(sorted.length * 0.75);
+    return Math.round((sorted[idx] ?? sorted[sorted.length - 1]) * 100) / 100;
+}
+/** Return an aggregated snapshot of all collected metrics. */
+export function getSnapshot() {
+    const routes = {};
+    for (const [route, bucket] of store.entries()) {
+        routes[route] = {
+            pageviews: bucket.pageviews,
+            lcp_p75: p75(bucket.samples.LCP),
+            cls_p75: p75(bucket.samples.CLS),
+            inp_p75: p75(bucket.samples.INP),
+            ttfb_p75: p75(bucket.samples.TTFB),
+            fcp_p75: p75(bucket.samples.FCP),
+        };
+    }
+    return { routes, asOf: new Date().toISOString() };
+}
+/** Clear all stored data (useful in tests). */
+export function clearStore() {
+    store.clear();
+}
+//# sourceMappingURL=store.js.map

package/dist/analytics/store.js.map

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

package/dist/analytics/store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.test.d.ts.map

package/dist/analytics/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../../src/analytics/store.test.ts"],"names":[],"mappings":""}

package/dist/analytics/store.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { recordMetric, getSnapshot, clearStore } from "./store.js";
+beforeEach(() => clearStore());
+describe("recordMetric / getSnapshot", () => {
+    it("records a single LCP and counts it as a pageview", () => {
+        recordMetric("/blog", "LCP", 1200);
+        const snap = getSnapshot();
+        expect(snap.routes["/blog"]?.pageviews).toBe(1);
+        expect(snap.routes["/blog"]?.lcp_p75).toBe(1200);
+    });
+    it("computes p75 correctly across multiple samples", () => {
+        // 4 samples: [100, 200, 300, 400] → sorted → index floor(4*0.75)=3 → 400
+        for (const v of [300, 100, 400, 200])
+            recordMetric("/", "LCP", v);
+        const snap = getSnapshot();
+        expect(snap.routes["/"]?.lcp_p75).toBe(400);
+    });
+    it("evicts oldest sample when ring buffer is full", () => {
+        // Fill 500 samples with value 1, then add one with value 9999
+        for (let i = 0; i < 500; i++)
+            recordMetric("/test", "FCP", 1);
+        recordMetric("/test", "FCP", 9999);
+        const snap = getSnapshot();
+        // Ring should still have exactly 500 entries (oldest 1 evicted, 9999 added)
+        // p75 of 499×1 + 1×9999 = index 374 → 1
+        expect(snap.routes["/test"]?.fcp_p75).toBe(1);
+    });
+    it("ignores unknown metric names", () => {
+        // @ts-expect-error intentionally invalid
+        recordMetric("/x", "UNKNOWN", 100);
+        const snap = getSnapshot();
+        expect(snap.routes["/x"]).toBeUndefined();
+    });
+    it("tracks multiple routes independently", () => {
+        recordMetric("/a", "CLS", 0.05);
+        recordMetric("/b", "CLS", 0.2);
+        const snap = getSnapshot();
+        expect(snap.routes["/a"]?.cls_p75).toBe(0.05);
+        expect(snap.routes["/b"]?.cls_p75).toBe(0.2);
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/analytics/store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.js","sourceRoot":"","sources":["../../src/analytics/store.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnE,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;AAE/B,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,yEAAyE;QACzE,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YAAE,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,8DAA8D;QAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;YAAE,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9D,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,4EAA4E;QAC5E,wCAAwC;QACxC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,yCAAyC;QACzC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAChC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/components/Analytics.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Alab Analytics — Core Web Vitals collection component.
+ *
+ * Drop `<Analytics />` into your root layout to start collecting
+ * LCP, CLS, INP, TTFB, and FCP from real users. Metrics are sent
+ * to `/_alabjs/vitals` via `navigator.sendBeacon` and aggregated
+ * in memory on the server.
+ *
+ * ## Usage
+ *
+ * ```tsx
+ * // app/layout.tsx
+ * import { Analytics } from "alabjs/components";
+ *
+ * export default function RootLayout({ children }: { children: React.ReactNode }) {
+ *   return (
+ *     <>
+ *       {children}
+ *       <Analytics />
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * ## Viewing metrics
+ *
+ * ```sh
+ * curl -H "Authorization: Bearer $ALAB_ANALYTICS_SECRET" \
+ *      http://localhost:3000/_alabjs/analytics
+ * ```
+ */
+export interface AnalyticsProps {
+    /**
+     * Override the beacon endpoint.
+     * @default "/_alabjs/vitals"
+     */
+    endpoint?: string;
+}
+/**
+ * Collects Core Web Vitals (LCP, CLS, INP, TTFB, FCP) using the browser's
+ * `PerformanceObserver` API and sends them to the AlabJS vitals endpoint.
+ *
+ * Uses `navigator.sendBeacon` so beacons are fire-and-forget and survive
+ * page unloads. Implements `buffered: true` so metrics already emitted
+ * before the observer attached are still captured.
+ */
+export declare function Analytics({ endpoint }: AnalyticsProps): null;
+//# sourceMappingURL=Analytics.d.ts.map

package/dist/components/Analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Analytics.d.ts","sourceRoot":"","sources":["../../src/components/Analytics.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,QAA4B,EAAE,EAAE,cAAc,QAiHzE"}

package/dist/components/Analytics.js

@@ -0,0 +1,154 @@
+/**
+ * Alab Analytics — Core Web Vitals collection component.
+ *
+ * Drop `<Analytics />` into your root layout to start collecting
+ * LCP, CLS, INP, TTFB, and FCP from real users. Metrics are sent
+ * to `/_alabjs/vitals` via `navigator.sendBeacon` and aggregated
+ * in memory on the server.
+ *
+ * ## Usage
+ *
+ * ```tsx
+ * // app/layout.tsx
+ * import { Analytics } from "alabjs/components";
+ *
+ * export default function RootLayout({ children }: { children: React.ReactNode }) {
+ *   return (
+ *     <>
+ *       {children}
+ *       <Analytics />
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * ## Viewing metrics
+ *
+ * ```sh
+ * curl -H "Authorization: Bearer $ALAB_ANALYTICS_SECRET" \
+ *      http://localhost:3000/_alabjs/analytics
+ * ```
+ */
+import { useEffect } from "react";
+/**
+ * Collects Core Web Vitals (LCP, CLS, INP, TTFB, FCP) using the browser's
+ * `PerformanceObserver` API and sends them to the AlabJS vitals endpoint.
+ *
+ * Uses `navigator.sendBeacon` so beacons are fire-and-forget and survive
+ * page unloads. Implements `buffered: true` so metrics already emitted
+ * before the observer attached are still captured.
+ */
+export function Analytics({ endpoint = "/_alabjs/vitals" }) {
+    useEffect(() => {
+        if (typeof window === "undefined" || typeof PerformanceObserver === "undefined")
+            return;
+        const route = window.location.pathname;
+        function send(name, value) {
+            const payload = JSON.stringify({ name, value, route });
+            if (navigator.sendBeacon) {
+                navigator.sendBeacon(endpoint, new Blob([payload], { type: "application/json" }));
+            }
+            else {
+                // Fallback for environments without sendBeacon (rare).
+                void fetch(endpoint, {
+                    method: "POST",
+                    body: payload,
+                    headers: { "content-type": "application/json" },
+                    keepalive: true,
+                }).catch(() => { });
+            }
+        }
+        const observers = [];
+        function observe(type, cb) {
+            try {
+                const po = new PerformanceObserver(cb);
+                po.observe({ type, buffered: true });
+                observers.push(po);
+            }
+            catch {
+                // Entry type not supported in this browser — skip silently.
+            }
+        }
+        // ── LCP — Largest Contentful Paint ─────────────────────────────────────
+        // We report the last entry since LCP can be updated multiple times.
+        let lcpValue = 0;
+        observe("largest-contentful-paint", (list) => {
+            const entries = list.getEntries();
+            const last = entries[entries.length - 1];
+            if (last)
+                lcpValue = last.startTime;
+        });
+        // ── CLS — Cumulative Layout Shift ───────────────────────────────────────
+        // Accumulate shift values across all layout-shift entries.
+        let clsValue = 0;
+        let clsSessionGap = 0;
+        let clsSessionValue = 0;
+        let clsLastTime = 0;
+        observe("layout-shift", (list) => {
+            for (const entry of list.getEntries()) {
+                const ls = entry;
+                if (ls.hadRecentInput)
+                    continue;
+                const gap = ls.startTime - clsLastTime;
+                if (gap > 1000 || ls.startTime - clsSessionGap > 5000) {
+                    clsSessionValue = ls.value;
+                    clsSessionGap = ls.startTime;
+                }
+                else {
+                    clsSessionValue += ls.value;
+                }
+                clsLastTime = ls.startTime;
+                if (clsSessionValue > clsValue)
+                    clsValue = clsSessionValue;
+            }
+        });
+        // ── INP — Interaction to Next Paint ────────────────────────────────────
+        // Track the worst interaction duration (p98 heuristic: worst of all events).
+        let inpValue = 0;
+        observe("event", (list) => {
+            for (const entry of list.getEntries()) {
+                const e = entry;
+                if (e.duration > inpValue)
+                    inpValue = e.duration;
+            }
+        });
+        // ── TTFB — Time to First Byte ───────────────────────────────────────────
+        // Read directly from navigation timing — available immediately after load.
+        const sendTtfb = () => {
+            const nav = performance.getEntriesByType("navigation")[0];
+            if (nav)
+                send("TTFB", nav.responseStart);
+        };
+        // ── FCP — First Contentful Paint ───────────────────────────────────────
+        observe("paint", (list) => {
+            for (const entry of list.getEntries()) {
+                if (entry.name === "first-contentful-paint") {
+                    send("FCP", entry.startTime);
+                }
+            }
+        });
+        // Flush LCP, CLS, and INP on page hide (navigating away / tab close).
+        // This gives us the most accurate final values.
+        const flush = () => {
+            if (lcpValue > 0)
+                send("LCP", lcpValue);
+            if (clsValue > 0)
+                send("CLS", Math.round(clsValue * 10000) / 10000);
+            if (inpValue > 0)
+                send("INP", inpValue);
+        };
+        sendTtfb();
+        window.addEventListener("visibilitychange", () => {
+            if (document.visibilityState === "hidden")
+                flush();
+        }, { once: true });
+        return () => {
+            for (const po of observers)
+                po.disconnect();
+        };
+        // endpoint is intentionally captured once on mount only.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return null;
+}
+//# sourceMappingURL=Analytics.js.map

package/dist/components/Analytics.js.map

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

package/dist/components/index.d.ts

@@ -9,4 +9,6 @@ export { Font } from "./Font.js";
 export type { FontProps } from "./Font.js";
 export { Dynamic, PPRShellProvider } from "./Dynamic.js";
 export type { DynamicProps } from "./Dynamic.js";
+export { Analytics } from "./Analytics.js";
+export type { AnalyticsProps } from "./Analytics.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/index.js

@@ -4,4 +4,5 @@ export { ErrorBoundary } from "./ErrorBoundary.js";
 export { Script } from "./Script.js";
 export { Font } from "./Font.js";
 export { Dynamic, PPRShellProvider } from "./Dynamic.js";
+export { Analytics } from "./Analytics.js";
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA0D3D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA8b3E"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA2D3D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CA+c3E"}

package/dist/server/app.js

@@ -11,6 +11,7 @@ import { runMiddleware } from "./middleware.js";
 import { checkRevalidateAuth, applyRevalidate } from "./revalidate.js";
 import { applyCdnHeaders } from "./cdn.js";
 import { getPPRShell, injectBuildIdIntoPPRShell, PPR_CACHE_SUBDIR } from "../ssr/ppr.js";
+import { handleVitalsBeacon, handleAnalyticsDashboard } from "../analytics/handler.js";
 /**
  * Find layout file paths (relative to cwd root) for a given route.file, ordered outermost→innermost.
  * Checks the compiled dist directory for the existence of each layout.
@@ -220,6 +221,15 @@ export function createApp(manifest, distDir) {
         }
         return JSON.stringify(result);
     }));
+    // Core Web Vitals beacon — receives POST from <Analytics> component
+    router.post("/_alabjs/vitals", defineEventHandler((event) => {
+        return handleVitalsBeacon(event.node.req, event.node.res);
+    }));
+    // Analytics dashboard — GET aggregated per-route stats
+    router.get("/_alabjs/analytics", defineEventHandler((event) => {
+        handleAnalyticsDashboard(event.node.req, event.node.res);
+        return null;
+    }));
     // Auto sitemap.xml from route manifest
     router.get("/sitemap.xml", defineEventHandler((event) => {
         const baseUrl = process.env["PUBLIC_URL"] ??