@rovela-ai/sdk 0.4.3 → 0.5.2

package/dist/analytics/components/AnalyticsPeriodContext.js

@@ -0,0 +1,28 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @rovela-ai/sdk/analytics/components/AnalyticsPeriodContext
+ *
+ * Period state shared across the three Insights tabs. Mounted at the
+ * Insights layout level so navigating Dashboards → Events → Visitors
+ * preserves the selected window (Next.js App Router preserves layout
+ * instances across child route changes — the context lives as long as
+ * the user is on /admin/analytics/*).
+ *
+ * Defaults to '30d' on first mount.
+ */
+import { createContext, useContext, useState } from 'react';
+const AnalyticsPeriodContext = createContext(null);
+export function AnalyticsPeriodProvider({ children, defaultPeriod = '30d', }) {
+    const [period, setPeriod] = useState(defaultPeriod);
+    return (_jsx(AnalyticsPeriodContext.Provider, { value: { period, setPeriod }, children: children }));
+}
+export function useAnalyticsPeriod() {
+    const ctx = useContext(AnalyticsPeriodContext);
+    if (!ctx) {
+        throw new Error('useAnalyticsPeriod must be used inside <AnalyticsPeriodProvider>. ' +
+            'Mount the provider at the /admin/analytics layout level.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=AnalyticsPeriodContext.js.map

package/dist/analytics/components/AnalyticsPeriodContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPeriodContext.js","sourceRoot":"","sources":["../../../src/analytics/components/AnalyticsPeriodContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAQ3D,MAAM,sBAAsB,GAAG,aAAa,CAC1C,IAAI,CACL,CAAA;AAOD,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,aAAa,GAAG,KAAK,GACQ;IAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAkB,aAAa,CAAC,CAAA;IACpE,OAAO,CACL,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAC1D,QAAQ,GACuB,CACnC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAA;IAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,0DAA0D,CAC7D,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/analytics/components/AnalyticsProvider.d.ts

@@ -0,0 +1,22 @@
+import type { AnalyticsPayload } from '../types';
+interface AnalyticsContextValue {
+    /** True when events will actually fire (consent granted + not an admin). */
+    enabled: boolean;
+    /** Fire a single typed event. No-op if disabled. Path / utm / identity are
+     *  derived automatically by emitEvent. */
+    track: (payload: AnalyticsPayload) => void;
+}
+export interface AnalyticsProviderProps {
+    children: React.ReactNode;
+    /** Override the consent gate (e.g. for testing). Default: respect cookie consent. */
+    forceEnabled?: boolean;
+}
+export declare function AnalyticsProvider({ children, forceEnabled, }: AnalyticsProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Storefront-component hook. Returns a track() that no-ops when consent is
+ * denied or an admin is browsing — so call sites can fire unconditionally
+ * without manual guards.
+ */
+export declare function useAnalytics(): AnalyticsContextValue;
+export {};
+//# sourceMappingURL=AnalyticsProvider.d.ts.map

package/dist/analytics/components/AnalyticsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.d.ts","sourceRoot":"","sources":["../../../src/analytics/components/AnalyticsProvider.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAMhD,UAAU,qBAAqB;IAC7B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAA;IAChB;8CAC0C;IAC1C,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAC3C;AAWD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,YAAY,GACb,EAAE,sBAAsB,2CAoHxB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAEpD"}

package/dist/analytics/components/AnalyticsProvider.js

@@ -0,0 +1,152 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @rovela-ai/sdk/analytics/components/AnalyticsProvider
+ *
+ * Storefront analytics provider. Mounts ONCE inside the customer branch of
+ * LayoutContent.tsx (NEVER inside the admin branch). Responsibilities:
+ *
+ *  1. Auto-fire `session_start` once per session (per-tab, 30-min idle).
+ *  2. Auto-fire `page_view` on every route change.
+ *  3. Gate everything on cookie consent (§26 useCookieConsent().analytics).
+ *  4. Stay silent when an admin is signed in (no merchant self-bias).
+ *  5. Stay silent during SSR (typeof window guard).
+ *  6. Provide a useAnalytics() hook so SDK + storefront components can fire
+ *     manual events (add_to_cart, begin_checkout, etc.).
+ *
+ * Order of evaluation per render:
+ *   admin? → skip everything
+ *   consent denied? → skip everything
+ *   otherwise → fire (debounced page_view for rapid client-nav)
+ *
+ * SSR-safe: every effect short-circuits if `pathname` is undefined or window
+ * is missing.
+ */
+import { createContext, useContext, useEffect, useRef, useState } from 'react';
+import { usePathname } from 'next/navigation';
+import { useCookieConsent } from '../../core/cookie-consent';
+import { useAdminSession } from '../../admin/hooks/useAdminSession';
+import { emitEvent, getSessionId } from '../client/tracker';
+const AnalyticsContext = createContext({
+    enabled: false,
+    track: () => undefined,
+});
+export function AnalyticsProvider({ children, forceEnabled, }) {
+    const pathname = usePathname();
+    const { analytics: analyticsConsent } = useCookieConsent();
+    const { data: adminSession } = useAdminSession();
+    // Hydrate the gate post-mount so SSR + first paint don't fire (window not
+    // yet ready; consent provider value may flip after hydration).
+    // Pattern B — post-mount hydration to avoid SSR mismatch.
+    const [mounted, setMounted] = useState(false);
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        setMounted(true);
+    }, []);
+    const isAdmin = Boolean(adminSession?.user?.id);
+    const enabled = mounted && !isAdmin && (forceEnabled || analyticsConsent);
+    // Auto-fire page_view on route change (debounced for rapid client-nav).
+    // sessionStorage check inside getSessionId() handles session_start.
+    const lastPathRef = useRef(null);
+    useEffect(() => {
+        if (!enabled || !pathname)
+            return;
+        if (lastPathRef.current === pathname)
+            return;
+        const prev = lastPathRef.current;
+        lastPathRef.current = pathname;
+        // Tiny debounce — Next.js can rapid-fire usePathname() during transitions.
+        const t = setTimeout(() => {
+            // session_start fires automatically when the session ID is fresh,
+            // BEFORE the first page_view of a new session. This keeps the order
+            // session_start → page_view consistent in dashboard reads.
+            const { isNew } = getSessionId();
+            if (isNew) {
+                emitEvent({ event: 'session_start', path: pathname });
+            }
+            emitEvent({
+                event: 'page_view',
+                path: pathname,
+                referrer: prev ? `${window.location.origin}${prev}` : document.referrer || null,
+            });
+        }, 50);
+        return () => clearTimeout(t);
+    }, [enabled, pathname]);
+    // Session lifecycle: heartbeat + end. Mounted once at the provider level
+    // (NOT per-route) so the cadence is stable across client-nav. Pauses on
+    // tab-hidden; resumes on tab-visible. Fires `session_end` on pagehide
+    // (more reliable than beforeunload on mobile Safari).
+    //
+    // 30s cadence — matches what Plausible/Fathom use. Tight enough to give
+    // good session-duration resolution (±15s), loose enough that a 10-min
+    // session generates only 20 events.
+    const HEARTBEAT_MS = 30_000;
+    useEffect(() => {
+        if (!enabled)
+            return;
+        if (typeof document === 'undefined')
+            return;
+        let interval = null;
+        const start = () => {
+            if (interval !== null)
+                return;
+            interval = setInterval(() => {
+                // Use the live pathname via window — pathname from React closure may
+                // be stale if a client-nav happened between heartbeats.
+                emitEvent({
+                    event: 'session_heartbeat',
+                    path: window.location.pathname,
+                });
+            }, HEARTBEAT_MS);
+        };
+        const stop = () => {
+            if (interval === null)
+                return;
+            clearInterval(interval);
+            interval = null;
+        };
+        const onVisibilityChange = () => {
+            if (document.visibilityState === 'visible')
+                start();
+            else
+                stop();
+        };
+        const onPageHide = () => {
+            // sendBeacon is the only reliable transport during unload — emitEvent
+            // already prefers it. Fire-and-forget; no await.
+            emitEvent({
+                event: 'session_end',
+                path: window.location.pathname,
+            });
+            stop();
+        };
+        // Initial state — start immediately if the tab is visible.
+        if (document.visibilityState === 'visible')
+            start();
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        window.addEventListener('pagehide', onPageHide);
+        return () => {
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            window.removeEventListener('pagehide', onPageHide);
+            stop();
+        };
+    }, [enabled]);
+    const track = (payload) => {
+        if (!enabled)
+            return;
+        emitEvent(payload);
+    };
+    return (_jsx(AnalyticsContext.Provider, { value: { enabled, track }, children: children }));
+}
+// =============================================================================
+// Hook
+// =============================================================================
+/**
+ * Storefront-component hook. Returns a track() that no-ops when consent is
+ * denied or an admin is browsing — so call sites can fire unconditionally
+ * without manual guards.
+ */
+export function useAnalytics() {
+    return useContext(AnalyticsContext);
+}
+//# sourceMappingURL=AnalyticsProvider.js.map

package/dist/analytics/components/AnalyticsProvider.js.map

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

package/dist/analytics/components/AnalyticsTabNav.d.ts

@@ -0,0 +1,14 @@
+export interface AnalyticsTabNavProps {
+    /** Header above the tab strip (default: 'Insights'). */
+    title?: string;
+    /** Subtitle under the header (optional). */
+    subtitle?: string;
+    /** Base href for the three tab routes. Defaults to the admin path so the
+     *  SDK admin pages don't have to pass it explicitly. The platform side
+     *  passes `/projects/<id>/insights` to reuse the same shell. */
+    baseHref?: string;
+    /** Optional right-aligned controls (period selector, etc.). */
+    trailing?: React.ReactNode;
+}
+export declare function AnalyticsTabNav({ title, subtitle, baseHref, trailing, }: AnalyticsTabNavProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AnalyticsTabNav.d.ts.map

package/dist/analytics/components/AnalyticsTabNav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsTabNav.d.ts","sourceRoot":"","sources":["../../../src/analytics/components/AnalyticsTabNav.tsx"],"names":[],"mappings":"AAkBA,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;oEAEgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAwBD,wBAAgB,eAAe,CAAC,EAC9B,KAAkB,EAClB,QAAQ,EACR,QAA6B,EAC7B,QAAQ,GACT,EAAE,oBAAoB,2CA4CtB"}

package/dist/analytics/components/AnalyticsTabNav.js

@@ -0,0 +1,42 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @rovela-ai/sdk/analytics/components/AnalyticsTabNav
+ *
+ * Underline-style tab nav for the Insights surface. Three links — Dashboards
+ * / Events / Visitors — wired to route-per-tab URLs. Active tab is derived
+ * from pathname (no controlled state needed).
+ *
+ * Matches the Ploy aesthetic: underline beneath the active tab, muted labels
+ * for the inactive ones, no background fills. Also renders the "Default"
+ * pill (single dashboard, no creation affordance) when the active tab is
+ * Dashboards — reserves the slot for a future multi-dashboard system.
+ */
+import Link from 'next/link';
+import { usePathname } from 'next/navigation';
+const TABS = [
+    { id: 'dashboards', label: 'Dashboards', sub: '' },
+    { id: 'events', label: 'Events', sub: '/events' },
+    { id: 'visitors', label: 'Visitors', sub: '/visitors' },
+];
+function resolveActiveTab(pathname, baseHref) {
+    if (!pathname)
+        return 'dashboards';
+    if (pathname.endsWith('/events') || pathname.includes('/events/'))
+        return 'events';
+    if (pathname.endsWith('/visitors') || pathname.includes('/visitors/'))
+        return 'visitors';
+    // Default — the baseHref itself or anything else under it
+    return pathname.startsWith(baseHref) ? 'dashboards' : 'dashboards';
+}
+export function AnalyticsTabNav({ title = 'Insights', subtitle, baseHref = '/admin/analytics', trailing, }) {
+    const pathname = usePathname();
+    const active = resolveActiveTab(pathname, baseHref);
+    return (_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-2xl font-bold text-foreground sm:text-3xl", children: title }), subtitle && (_jsx("p", { className: "mt-1 text-muted-foreground", children: subtitle }))] }), trailing && _jsx("div", { className: "flex items-center gap-2", children: trailing })] }), _jsx("div", { className: "border-b border-border", children: _jsx("nav", { className: "-mb-px flex gap-6", children: TABS.map((tab) => {
+                        const isActive = active === tab.id;
+                        return (_jsx(Link, { href: `${baseHref}${tab.sub}`, "aria-current": isActive ? 'page' : undefined, className: isActive
+                                ? 'border-b-2 border-foreground px-1 pb-3 pt-1 text-sm font-semibold text-foreground'
+                                : 'border-b-2 border-transparent px-1 pb-3 pt-1 text-sm font-medium text-muted-foreground transition-colors hover:text-foreground', children: tab.label }, tab.id));
+                    }) }) })] }));
+}
+//# sourceMappingURL=AnalyticsTabNav.js.map

package/dist/analytics/components/AnalyticsTabNav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsTabNav.js","sourceRoot":"","sources":["../../../src/analytics/components/AnalyticsTabNav.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;GAWG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAsB7C,MAAM,IAAI,GAAU;IAClB,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,EAAE;IAClD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;IACjD,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE;CACxD,CAAA;AAED,SAAS,gBAAgB,CAAC,QAAuB,EAAE,QAAgB;IACjE,IAAI,CAAC,QAAQ;QAAE,OAAO,YAAY,CAAA;IAClC,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAA;IAClF,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;QACnE,OAAO,UAAU,CAAA;IACnB,0DAA0D;IAC1D,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,GAAG,UAAU,EAClB,QAAQ,EACR,QAAQ,GAAG,kBAAkB,EAC7B,QAAQ,GACa;IACrB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAEnD,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aAExB,eAAK,SAAS,EAAC,oEAAoE,aACjF,0BACE,aAAI,SAAS,EAAC,gDAAgD,YAC3D,KAAK,GACH,EACJ,QAAQ,IAAI,CACX,YAAG,SAAS,EAAC,4BAA4B,YAAE,QAAQ,GAAK,CACzD,IACG,EACL,QAAQ,IAAI,cAAK,SAAS,EAAC,yBAAyB,YAAE,QAAQ,GAAO,IAClE,EAGN,cAAK,SAAS,EAAC,wBAAwB,YACrC,cAAK,SAAS,EAAC,mBAAmB,YAC/B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;wBAChB,MAAM,QAAQ,GAAG,MAAM,KAAK,GAAG,CAAC,EAAE,CAAA;wBAClC,OAAO,CACL,KAAC,IAAI,IAEH,IAAI,EAAE,GAAG,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,kBACf,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAC3C,SAAS,EACP,QAAQ;gCACN,CAAC,CAAC,mFAAmF;gCACrF,CAAC,CAAC,gIAAgI,YAGrI,GAAG,CAAC,KAAK,IATL,GAAG,CAAC,EAAE,CAUN,CACR,CAAA;oBACH,CAAC,CAAC,GACE,GACF,IAEF,CACP,CAAA;AACH,CAAC"}

package/dist/analytics/hooks/useAnalytics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @rovela-ai/sdk/analytics/hooks/useAnalytics
+ *
+ * Re-export of the useAnalytics hook from the provider module. Lives here
+ * so the import path matches every other SDK hook (`../hooks/useFoo`).
+ */
+export { useAnalytics, AnalyticsProvider } from '../components/AnalyticsProvider';
+export type { AnalyticsProviderProps } from '../components/AnalyticsProvider';
+//# sourceMappingURL=useAnalytics.d.ts.map

package/dist/analytics/hooks/useAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../../src/analytics/hooks/useAnalytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACjF,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA"}

package/dist/analytics/hooks/useAnalytics.js

@@ -0,0 +1,8 @@
+/**
+ * @rovela-ai/sdk/analytics/hooks/useAnalytics
+ *
+ * Re-export of the useAnalytics hook from the provider module. Lives here
+ * so the import path matches every other SDK hook (`../hooks/useFoo`).
+ */
+export { useAnalytics, AnalyticsProvider } from '../components/AnalyticsProvider';
+//# sourceMappingURL=useAnalytics.js.map

package/dist/analytics/hooks/useAnalytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.js","sourceRoot":"","sources":["../../../src/analytics/hooks/useAnalytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA"}

package/dist/analytics/hooks/useAnalyticsDashboard.d.ts

@@ -0,0 +1,9 @@
+import type { AnalyticsDashboardPayload, AnalyticsPeriod } from '../types';
+export interface UseAnalyticsDashboardReturn {
+    data: AnalyticsDashboardPayload | null;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+}
+export declare function useAnalyticsDashboard(period: AnalyticsPeriod): UseAnalyticsDashboardReturn;
+//# sourceMappingURL=useAnalyticsDashboard.d.ts.map

package/dist/analytics/hooks/useAnalyticsDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalyticsDashboard.d.ts","sourceRoot":"","sources":["../../../src/analytics/hooks/useAnalyticsDashboard.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EAChB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAA;IACtC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,GACtB,2BAA2B,CAyC7B"}

package/dist/analytics/hooks/useAnalyticsDashboard.js

@@ -0,0 +1,45 @@
+'use client';
+/**
+ * @rovela-ai/sdk/analytics/hooks/useAnalyticsDashboard
+ *
+ * Admin dashboard hook — fetches /api/admin/analytics scoped to a period.
+ * Mirrors the shape of `useAdminStats` so callers get the same {data,
+ * isLoading, error, refresh} ergonomics.
+ *
+ * AbortController-managed: rapid period flips cancel the prior request.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { fetchAdminApi } from '../../admin/hooks/fetchAdminApi';
+export function useAnalyticsDashboard(period) {
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const abortRef = useRef(null);
+    const fetchDashboard = useCallback(async (p) => {
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        setIsLoading(true);
+        const res = await fetchAdminApi(`/api/admin/analytics?period=${p}`, { signal: controller.signal });
+        if (controller.signal.aborted)
+            return;
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setError(null);
+        setData(res.data);
+    }, []);
+    // Pattern C — populate state from async-loaded data.
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        fetchDashboard(period);
+        return () => {
+            abortRef.current?.abort();
+        };
+    }, [period, fetchDashboard]);
+    const refresh = useCallback(() => fetchDashboard(period), [period, fetchDashboard]);
+    return { data, isLoading, error, refresh };
+}
+//# sourceMappingURL=useAnalyticsDashboard.js.map

package/dist/analytics/hooks/useAnalyticsDashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalyticsDashboard.js","sourceRoot":"","sources":["../../../src/analytics/hooks/useAnalyticsDashboard.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAa/D,MAAM,UAAU,qBAAqB,CACnC,MAAuB;IAEvB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAmC,IAAI,CAAC,CAAA;IACxE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAA;IAErD,MAAM,cAAc,GAAG,WAAW,CAChC,KAAK,EAAE,CAAkB,EAAiB,EAAE;QAC1C,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;QACzB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAA;QAE7B,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,+BAA+B,CAAC,EAAE,EAClC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAC9B,CAAA;QACD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;YAAE,OAAM;QACrC,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAA;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC,EACD,EAAE,CACH,CAAA;IAED,qDAAqD;IACrD,SAAS,CAAC,GAAG,EAAE;QACb,2DAA2D;QAC3D,cAAc,CAAC,MAAM,CAAC,CAAA;QACtB,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;QAC3B,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;IAE5B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;IAEnF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC5C,CAAC"}

package/dist/analytics/hooks/useEventsLog.d.ts

@@ -0,0 +1,24 @@
+import type { AnalyticsEventsLogPage, AnalyticsPeriod, AnalyticsSortDir } from '../types';
+type SortColumn = 'ts' | 'event' | 'path' | 'referrer' | 'country';
+export interface UseEventsLogOptions {
+    period: AnalyticsPeriod;
+    sortBy?: SortColumn;
+    sortDir?: AnalyticsSortDir;
+    hideHeartbeats?: boolean;
+    limit?: number;
+}
+export interface UseEventsLogReturn {
+    page: AnalyticsEventsLogPage | null;
+    isLoading: boolean;
+    error: string | null;
+    /** Cursor for the page currently displayed. null = first page. */
+    cursor: string | null;
+    /** Advance to next page (does nothing when nextCursor is null). */
+    nextPage: () => void;
+    /** Reset to first page. */
+    firstPage: () => void;
+    refresh: () => Promise<void>;
+}
+export declare function useEventsLog(options: UseEventsLogOptions): UseEventsLogReturn;
+export {};
+//# sourceMappingURL=useEventsLog.d.ts.map

package/dist/analytics/hooks/useEventsLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventsLog.d.ts","sourceRoot":"","sources":["../../../src/analytics/hooks/useEventsLog.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAEjB,KAAK,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;AAElE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACnC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,kEAAkE;IAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAyFpB"}

package/dist/analytics/hooks/useEventsLog.js

@@ -0,0 +1,85 @@
+'use client';
+/**
+ * @rovela-ai/sdk/analytics/hooks/useEventsLog
+ *
+ * Admin Events tab hook — cursor-paginated event log with sort + heartbeat
+ * toggle. AbortController-managed: param changes cancel the prior request.
+ *
+ * Shape mirrors useAnalyticsDashboard for consistency. Returns the page +
+ * helpers to advance pagination and replace filters.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { fetchAdminApi } from '../../admin/hooks/fetchAdminApi';
+export function useEventsLog(options) {
+    const [page, setPage] = useState(null);
+    const [error, setError] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [cursor, setCursor] = useState(null);
+    const abortRef = useRef(null);
+    const fetchPage = useCallback(async (opts, c) => {
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        setIsLoading(true);
+        const params = new URLSearchParams();
+        params.set('period', opts.period);
+        if (opts.sortBy)
+            params.set('sortBy', opts.sortBy);
+        if (opts.sortDir)
+            params.set('sortDir', opts.sortDir);
+        params.set('hideHeartbeats', opts.hideHeartbeats === false ? 'false' : 'true');
+        if (opts.limit)
+            params.set('limit', String(opts.limit));
+        if (c)
+            params.set('cursor', c);
+        const res = await fetchAdminApi(`/api/admin/analytics/events?${params.toString()}`, { signal: controller.signal });
+        if (controller.signal.aborted)
+            return;
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setError(null);
+        setPage(res.data);
+    }, []);
+    // Reset cursor when filters change (any options change → back to page 1).
+    // Pattern C — populate state from async-loaded data.
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        setCursor(null);
+    }, [
+        options.period,
+        options.sortBy,
+        options.sortDir,
+        options.hideHeartbeats,
+        options.limit,
+    ]);
+    // Effect deps intentionally list each scalar prop instead of `options`
+    // itself — the parent passes a fresh `options` object reference every
+    // render, which would otherwise re-fire this effect on every parent
+    // re-render and stack up aborted in-flight requests.
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        fetchPage(options, cursor);
+        return () => abortRef.current?.abort();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        options.period,
+        options.sortBy,
+        options.sortDir,
+        options.hideHeartbeats,
+        options.limit,
+        cursor,
+        fetchPage,
+    ]);
+    const nextCursorVal = page?.nextCursor ?? null;
+    const nextPage = useCallback(() => {
+        if (nextCursorVal)
+            setCursor(nextCursorVal);
+    }, [nextCursorVal]);
+    const firstPage = useCallback(() => setCursor(null), []);
+    const refresh = useCallback(() => fetchPage(options, cursor), [options, cursor, fetchPage]);
+    return { page, isLoading, error, cursor, nextPage, firstPage, refresh };
+}
+//# sourceMappingURL=useEventsLog.js.map

package/dist/analytics/hooks/useEventsLog.js.map

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

package/dist/analytics/hooks/useVisitorsList.d.ts

@@ -0,0 +1,20 @@
+import type { AnalyticsPeriod, AnalyticsSortDir, AnalyticsVisitorsPage } from '../types';
+type SortColumn = 'last_seen' | 'first_seen' | 'sessions' | 'pageviews' | 'country';
+export interface UseVisitorsListOptions {
+    period: AnalyticsPeriod;
+    sortBy?: SortColumn;
+    sortDir?: AnalyticsSortDir;
+    limit?: number;
+}
+export interface UseVisitorsListReturn {
+    page: AnalyticsVisitorsPage | null;
+    isLoading: boolean;
+    error: string | null;
+    cursor: string | null;
+    nextPage: () => void;
+    firstPage: () => void;
+    refresh: () => Promise<void>;
+}
+export declare function useVisitorsList(options: UseVisitorsListOptions): UseVisitorsListReturn;
+export {};
+//# sourceMappingURL=useVisitorsList.d.ts.map

package/dist/analytics/hooks/useVisitorsList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVisitorsList.d.ts","sourceRoot":"","sources":["../../../src/analytics/hooks/useVisitorsList.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAA;AAEjB,KAAK,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;AAEnF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA0EvB"}

package/dist/analytics/hooks/useVisitorsList.js

@@ -0,0 +1,73 @@
+'use client';
+/**
+ * @rovela-ai/sdk/analytics/hooks/useVisitorsList
+ *
+ * Admin Visitors tab hook — offset-paginated per-visitor aggregate with sort.
+ * Mirrors useEventsLog shape.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { fetchAdminApi } from '../../admin/hooks/fetchAdminApi';
+export function useVisitorsList(options) {
+    const [page, setPage] = useState(null);
+    const [error, setError] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [cursor, setCursor] = useState(null);
+    const abortRef = useRef(null);
+    const fetchPage = useCallback(async (opts, c) => {
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        setIsLoading(true);
+        const params = new URLSearchParams();
+        params.set('period', opts.period);
+        if (opts.sortBy)
+            params.set('sortBy', opts.sortBy);
+        if (opts.sortDir)
+            params.set('sortDir', opts.sortDir);
+        if (opts.limit)
+            params.set('limit', String(opts.limit));
+        if (c)
+            params.set('cursor', c);
+        const res = await fetchAdminApi(`/api/admin/analytics/visitors?${params.toString()}`, { signal: controller.signal });
+        if (controller.signal.aborted)
+            return;
+        setIsLoading(false);
+        if (!res.ok) {
+            setError(res.error);
+            return;
+        }
+        setError(null);
+        setPage(res.data);
+    }, []);
+    // Pattern C — populate state from async-loaded data.
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        setCursor(null);
+    }, [options.period, options.sortBy, options.sortDir, options.limit]);
+    // Effect deps intentionally list each scalar prop instead of `options`
+    // itself — the parent passes a fresh `options` object reference every
+    // render, which would otherwise re-fire this effect on every parent
+    // re-render and stack up aborted in-flight requests.
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        fetchPage(options, cursor);
+        return () => abortRef.current?.abort();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        options.period,
+        options.sortBy,
+        options.sortDir,
+        options.limit,
+        cursor,
+        fetchPage,
+    ]);
+    const nextCursorVal = page?.nextCursor ?? null;
+    const nextPage = useCallback(() => {
+        if (nextCursorVal)
+            setCursor(nextCursorVal);
+    }, [nextCursorVal]);
+    const firstPage = useCallback(() => setCursor(null), []);
+    const refresh = useCallback(() => fetchPage(options, cursor), [options, cursor, fetchPage]);
+    return { page, isLoading, error, cursor, nextPage, firstPage, refresh };
+}
+//# sourceMappingURL=useVisitorsList.js.map

package/dist/analytics/hooks/useVisitorsList.js.map

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