locallytics 0.1.0 → 0.1.2

package/README.md

@@ -1,14 +1,6 @@
 # Locallytics
 
-Self-hosted, privacy-first analytics SDK for Next.js applications.
-
-## Features
-
-- 🔒 **Privacy-first** - No cookies, no localStorage, hashed IPs only
-- 🚀 **Lightweight** - < 5KB client bundle
-- 📊 **PostgreSQL only** - Simple, reliable, self-hosted
-- ⚡ **Fast** - Event batching, parallel queries
-- 🎯 **Next.js optimized** - Works with App Router
+Self-hosted, privacy-first analytics SDK for Next.js.
 
 ## Installation
 
@@ -18,26 +10,15 @@ npm install locallytics
 
 ## Quick Start
 
-### 1. Set up the database
-
-Run the schema in your PostgreSQL database:
-
-```sql
--- See src/db/schema.sql for the full schema
-CREATE TABLE IF NOT EXISTS locallytics_pageviews (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    session_id TEXT NOT NULL,
-    page_url TEXT NOT NULL,
-    referrer TEXT,
-    user_agent TEXT NOT NULL,
-    screen_width INTEGER NOT NULL,
-    screen_height INTEGER NOT NULL,
-    ip_hash TEXT,
-    timestamp TIMESTAMPTZ NOT NULL DEFAULT NOW()
-);
+### 1. Setup Database
+
+Use our CLI to set up your PostgreSQL database automatically:
+
+```bash
+npx locallytics-cli migrate
 ```
 
-### 2. Create the API route
+### 2. Add API Route
 
 ```typescript
 // app/api/analytics/route.ts
@@ -45,13 +26,12 @@ import { locallytics } from "locallytics";
 
 const analytics = await locallytics({
   database: process.env.DATABASE_URL!,
-  apiKey: process.env.ANALYTICS_API_KEY, // optional
 });
 
 export const { GET, POST } = analytics;
 ```
 
-### 3. Add the tracker
+### 3. Add Tracker
 
 ```tsx
 // app/layout.tsx
@@ -69,67 +49,24 @@ export default function RootLayout({ children }) {
 }
 ```
 
-### 4. Fetch analytics data
+### 4. Fetch Data
 
 ```tsx
-// app/dashboard/page.tsx
-import { AnalyticsJSON } from "locallytics";
-import { headers } from "next/headers";
+// app/page.tsx
+import { AnalyticsData } from "locallytics";
 
-export default async function Dashboard() {
-  const data = await AnalyticsJSON({
-    headersReader: headers,
-    dateRange: "last7d",
-  });
+export default async function Home() {
+  const data = await AnalyticsData(); // Simple! No arguments.
 
-  return (
-    <div>
-      <h1>Analytics</h1>
-      <p>{data.pageviews} pageviews</p>
-      <p>{data.uniqueVisitors} unique visitors</p>
-    </div>
-  );
+  return <pre>{JSON.stringify(data, null, 2)}</pre>;
 }
 ```
 
-## Configuration
-
-### `locallytics(config)`
-
-| Option     | Type     | Required | Description                   |
-| ---------- | -------- | -------- | ----------------------------- |
-| `database` | `string` | Yes      | PostgreSQL connection string  |
-| `apiKey`   | `string` | No       | API key for GET endpoint auth |
-
-### `AnalyticsGrabber` props
-
-| Prop       | Type     | Default          | Description      |
-| ---------- | -------- | ---------------- | ---------------- |
-| `endpoint` | `string` | `/api/analytics` | API endpoint URL |
-
-### `AnalyticsJSON(options)`
-
-| Option          | Type            | Required | Description                              |
-| --------------- | --------------- | -------- | ---------------------------------------- |
-| `headersReader` | `() => Headers` | Yes      | Headers reader from `next/headers`       |
-| `dateRange`     | `DateRange`     | No       | Date range (default: `'last7d'`)         |
-| `endpoint`      | `string`        | No       | API endpoint (default: `/api/analytics`) |
-
-## Date Ranges
-
-- `'last24h'` - Last 24 hours
-- `'last7d'` - Last 7 days (default)
-- `'last30d'` - Last 30 days
-- `{ start: Date, end: Date }` - Custom range
-
-## Privacy
-
-Locallytics respects user privacy:
+## Features
 
-- **No cookies** - Session IDs are generated client-side and ephemeral
-- **No localStorage** - Nothing stored in the browser
-- **IP hashing** - IPs are SHA-256 hashed before storage
-- **DNT respected** - Honors Do Not Track header
+- **Privacy**: No cookies, hashed IPs, supports Do Not Track.
+- **Simplicity**: Zero-config data fetching.
+- **Speed**: Lightweight (< 5KB) and fast.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locallytics",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Self-hosted, privacy-first analytics SDK for Next.js",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,8 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./schema.sql": "./src/db/schema.sql"
   },
   "files": [
     "dist",

package/dist/client/AnalyticsGrabber.d.ts

@@ -1,28 +0,0 @@
-interface AnalyticsGrabberProps {
-    /** API endpoint URL (defaults to /api/analytics) */
-    endpoint?: string;
-}
-/**
- * React component for tracking pageviews
- * Drop this into your layout to automatically track pageviews
- *
- * @example
- * ```tsx
- * // app/layout.tsx
- * import { AnalyticsGrabber } from 'locallytics';
- *
- * export default function RootLayout({ children }) {
- *   return (
- *     <html>
- *       <body>
- *         {children}
- *         <AnalyticsGrabber />
- *       </body>
- *     </html>
- *   );
- * }
- * ```
- */
-export declare function AnalyticsGrabber({ endpoint, }: AnalyticsGrabberProps): null;
-export {};
-//# sourceMappingURL=AnalyticsGrabber.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AnalyticsGrabber.d.ts","sourceRoot":"","sources":["../../src/client/AnalyticsGrabber.tsx"],"names":[],"mappings":"AAKA,UAAU,qBAAqB;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAA2B,GAC5B,EAAE,qBAAqB,GAAG,IAAI,CAuD9B"}

package/dist/client/AnalyticsGrabber.js

@@ -1,71 +0,0 @@
-"use client";
-import { useEffect, useRef } from "react";
-import { Tracker } from "./tracker.js";
-/**
- * React component for tracking pageviews
- * Drop this into your layout to automatically track pageviews
- *
- * @example
- * ```tsx
- * // app/layout.tsx
- * import { AnalyticsGrabber } from 'locallytics';
- *
- * export default function RootLayout({ children }) {
- *   return (
- *     <html>
- *       <body>
- *         {children}
- *         <AnalyticsGrabber />
- *       </body>
- *     </html>
- *   );
- * }
- * ```
- */
-export function AnalyticsGrabber({ endpoint = "/api/analytics", }) {
-    const trackerRef = useRef(null);
-    const lastPathRef = useRef("");
-    useEffect(() => {
-        // Initialize tracker
-        const tracker = new Tracker(endpoint);
-        trackerRef.current = tracker;
-        // Track initial pageview
-        tracker.trackPageview();
-        lastPathRef.current = window.location.pathname;
-        // Handle browser back/forward navigation
-        const handlePopstate = () => {
-            if (window.location.pathname !== lastPathRef.current) {
-                lastPathRef.current = window.location.pathname;
-                tracker.trackPageview();
-            }
-        };
-        window.addEventListener("popstate", handlePopstate);
-        // Handle client-side navigation (Next.js App Router)
-        // Use MutationObserver to detect URL changes
-        let observer = null;
-        const checkForNavigation = () => {
-            if (window.location.pathname !== lastPathRef.current) {
-                lastPathRef.current = window.location.pathname;
-                tracker.trackPageview();
-            }
-        };
-        // Observe changes to the document that might indicate navigation
-        observer = new MutationObserver(() => {
-            // Use requestAnimationFrame to batch checks
-            requestAnimationFrame(checkForNavigation);
-        });
-        observer.observe(document, {
-            subtree: true,
-            childList: true,
-        });
-        // Cleanup
-        return () => {
-            window.removeEventListener("popstate", handlePopstate);
-            observer?.disconnect();
-            tracker.destroy();
-        };
-    }, [endpoint]);
-    // This component renders nothing
-    return null;
-}
-//# sourceMappingURL=AnalyticsGrabber.js.map

package/dist/client/AnalyticsGrabber.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnalyticsGrabber.js","sourceRoot":"","sources":["../../src/client/AnalyticsGrabber.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAOvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,QAAQ,GAAG,gBAAgB,GACL;IACtB,MAAM,UAAU,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,qBAAqB;QACrB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAE7B,yBAAyB;QACzB,OAAO,CAAC,aAAa,EAAE,CAAC;QACxB,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAE/C,yCAAyC;QACzC,MAAM,cAAc,GAAG,GAAS,EAAE;YAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;gBACrD,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/C,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAEpD,qDAAqD;QACrD,6CAA6C;QAC7C,IAAI,QAAQ,GAA4B,IAAI,CAAC;QAE7C,MAAM,kBAAkB,GAAG,GAAS,EAAE;YACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;gBACrD,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/C,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;QAEF,iEAAiE;QACjE,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;YACnC,4CAA4C;YAC5C,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE;YACzB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,UAAU;QACV,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YACvD,QAAQ,EAAE,UAAU,EAAE,CAAC;YACvB,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,iCAAiC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/client/batcher.d.ts

@@ -1,48 +0,0 @@
-import type { PageviewEvent } from "../types/index.js";
-/**
- * Batches events and sends them to the server
- * Uses sendBeacon for reliable delivery on page unload
- */
-export declare class EventBatcher {
-    private readonly endpoint;
-    private readonly maxSize;
-    private readonly maxWaitMs;
-    private events;
-    private flushTimeout;
-    private isFlushing;
-    constructor(endpoint: string, maxSize?: number, maxWaitMs?: number);
-    /**
-     * Add an event to the batch queue
-     */
-    add(event: PageviewEvent): void;
-    /**
-     * Flush events to the server using fetch
-     */
-    flush(): Promise<void>;
-    /**
-     * Flush events synchronously using sendBeacon
-     * Used for beforeunload when async requests may not complete
-     */
-    private flushSync;
-    /**
-     * Start the flush timer
-     */
-    private startTimer;
-    /**
-     * Clear the flush timer
-     */
-    private clearTimer;
-    /**
-     * Handle page unload - use sendBeacon for reliable delivery
-     */
-    private handleUnload;
-    /**
-     * Handle visibility change - flush when page becomes hidden
-     */
-    private handleVisibilityChange;
-    /**
-     * Clean up event listeners and timers
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=batcher.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../../src/client/batcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,UAAU,CAAkB;gBAGlC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAyB,EAClC,SAAS,GAAE,MAA4B;IAazC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAc/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC5B;;;OAGG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,YAAY,CAElB;IAEF;;OAEG;IACH,OAAO,CAAC,sBAAsB,CAI5B;IAEF;;OAEG;IACH,OAAO,IAAI,IAAI;CAWhB"}

package/dist/client/batcher.js

@@ -1,139 +0,0 @@
-const DEFAULT_MAX_SIZE = 10;
-const DEFAULT_MAX_WAIT_MS = 30000;
-/**
- * Batches events and sends them to the server
- * Uses sendBeacon for reliable delivery on page unload
- */
-export class EventBatcher {
-    constructor(endpoint, maxSize = DEFAULT_MAX_SIZE, maxWaitMs = DEFAULT_MAX_WAIT_MS) {
-        this.events = [];
-        this.flushTimeout = null;
-        this.isFlushing = false;
-        /**
-         * Handle page unload - use sendBeacon for reliable delivery
-         */
-        this.handleUnload = () => {
-            this.flushSync();
-        };
-        /**
-         * Handle visibility change - flush when page becomes hidden
-         */
-        this.handleVisibilityChange = () => {
-            if (document.visibilityState === "hidden") {
-                this.flushSync();
-            }
-        };
-        this.endpoint = endpoint;
-        this.maxSize = maxSize;
-        this.maxWaitMs = maxWaitMs;
-        // Set up unload handlers for reliable delivery
-        if (typeof window !== "undefined") {
-            window.addEventListener("beforeunload", this.handleUnload);
-            window.addEventListener("visibilitychange", this.handleVisibilityChange);
-        }
-    }
-    /**
-     * Add an event to the batch queue
-     */
-    add(event) {
-        this.events.push(event);
-        // Start the timer if this is the first event
-        if (this.events.length === 1) {
-            this.startTimer();
-        }
-        // Flush immediately if we've reached max size
-        if (this.events.length >= this.maxSize) {
-            void this.flush();
-        }
-    }
-    /**
-     * Flush events to the server using fetch
-     */
-    async flush() {
-        if (this.events.length === 0 || this.isFlushing) {
-            return;
-        }
-        this.isFlushing = true;
-        this.clearTimer();
-        const eventsToSend = [...this.events];
-        this.events = [];
-        try {
-            const response = await fetch(this.endpoint, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                },
-                body: JSON.stringify(eventsToSend),
-            });
-            if (!response.ok) {
-                // On failure, add events back to queue for retry
-                console.error("[Locallytics] Failed to send events:", response.status);
-                this.events = [...eventsToSend, ...this.events];
-            }
-        }
-        catch (error) {
-            // On error, add events back to queue for retry
-            console.error("[Locallytics] Error sending events:", error);
-            this.events = [...eventsToSend, ...this.events];
-        }
-        finally {
-            this.isFlushing = false;
-            // Restart timer if there are pending events
-            if (this.events.length > 0) {
-                this.startTimer();
-            }
-        }
-    }
-    /**
-     * Flush events synchronously using sendBeacon
-     * Used for beforeunload when async requests may not complete
-     */
-    flushSync() {
-        if (this.events.length === 0) {
-            return;
-        }
-        const eventsToSend = [...this.events];
-        this.events = [];
-        this.clearTimer();
-        try {
-            const blob = new Blob([JSON.stringify(eventsToSend)], {
-                type: "application/json",
-            });
-            navigator.sendBeacon(this.endpoint, blob);
-        }
-        catch (error) {
-            console.error("[Locallytics] sendBeacon failed:", error);
-        }
-    }
-    /**
-     * Start the flush timer
-     */
-    startTimer() {
-        if (this.flushTimeout) {
-            return;
-        }
-        this.flushTimeout = setTimeout(() => {
-            void this.flush();
-        }, this.maxWaitMs);
-    }
-    /**
-     * Clear the flush timer
-     */
-    clearTimer() {
-        if (this.flushTimeout) {
-            clearTimeout(this.flushTimeout);
-            this.flushTimeout = null;
-        }
-    }
-    /**
-     * Clean up event listeners and timers
-     */
-    destroy() {
-        this.clearTimer();
-        if (typeof window !== "undefined") {
-            window.removeEventListener("beforeunload", this.handleUnload);
-            window.removeEventListener("visibilitychange", this.handleVisibilityChange);
-        }
-    }
-}
-//# sourceMappingURL=batcher.js.map

package/dist/client/batcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"batcher.js","sourceRoot":"","sources":["../../src/client/batcher.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,YAAY;IAQvB,YACE,QAAgB,EAChB,UAAkB,gBAAgB,EAClC,YAAoB,mBAAmB;QAPjC,WAAM,GAAoB,EAAE,CAAC;QAC7B,iBAAY,GAAyC,IAAI,CAAC;QAC1D,eAAU,GAAY,KAAK,CAAC;QA2HpC;;WAEG;QACK,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC,CAAC;QAEF;;WAEG;QACK,2BAAsB,GAAG,GAAS,EAAE;YAC1C,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;gBAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;QAlIA,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,+CAA+C;QAC/C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3D,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAoB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,6CAA6C;QAC7C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;QAED,8CAA8C;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;aACnC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,iDAAiD;gBACjD,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YAExB,4CAA4C;YAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,SAAS;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE;gBACpD,IAAI,EAAE,kBAAkB;aACzB,CAAC,CAAC;YACH,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAkBD;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9D,MAAM,CAAC,mBAAmB,CACxB,kBAAkB,EAClB,IAAI,CAAC,sBAAsB,CAC5B,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/client/tracker.d.ts

@@ -1,18 +0,0 @@
-/**
- * Client-side tracker for pageviews
- */
-export declare class Tracker {
-    private readonly batcher;
-    private readonly sessionId;
-    private dntEnabled;
-    constructor(endpoint?: string);
-    /**
-     * Track the current pageview
-     */
-    trackPageview(): void;
-    /**
-     * Clean up the tracker
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=tracker.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/client/tracker.ts"],"names":[],"mappings":"AAiGA;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAAU;gBAEhB,QAAQ,GAAE,MAAyB;IAO/C;;OAEG;IACH,aAAa,IAAI,IAAI;IAwBrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/client/tracker.js

@@ -1,121 +0,0 @@
-import { EventBatcher } from "./batcher.js";
-const DEFAULT_ENDPOINT = "/api/analytics";
-const STORAGE_KEY = "locallytics_sid";
-/**
- * Generate a unique session ID
- */
-function generateSessionId() {
-    // Use crypto.randomUUID if available (modern browsers)
-    if (typeof crypto !== "undefined" && crypto.randomUUID) {
-        return crypto.randomUUID();
-    }
-    // Fallback: timestamp + random
-    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
-}
-/**
- * Get or create a persistent session ID
- */
-function getPersistentSessionId(dntEnabled) {
-    // If DNT is enabled, do not use storage and return a temporary ID
-    if (dntEnabled) {
-        return generateSessionId();
-    }
-    if (typeof window === "undefined") {
-        return generateSessionId();
-    }
-    try {
-        // Check localStorage
-        const stored = localStorage.getItem(STORAGE_KEY);
-        if (stored) {
-            return stored;
-        }
-        // Create new and store
-        const newId = generateSessionId();
-        localStorage.setItem(STORAGE_KEY, newId);
-        return newId;
-    }
-    catch {
-        // Use ephemeral ID if storage access is denied
-        return generateSessionId();
-    }
-}
-/**
- * Check if Do Not Track is enabled in the browser
- */
-function isDNTEnabled() {
-    if (typeof navigator === "undefined") {
-        return false;
-    }
-    // Check navigator.doNotTrack
-    const dnt = navigator.doNotTrack;
-    if (dnt === "1" || dnt === "yes") {
-        return true;
-    }
-    // Check window.doNotTrack (non-standard but used by some browsers)
-    if (typeof window !== "undefined" &&
-        "doNotTrack" in window &&
-        window.doNotTrack === "1") {
-        return true;
-    }
-    // Check Global Privacy Control
-    if (typeof navigator !== "undefined" &&
-        "globalPrivacyControl" in navigator &&
-        navigator
-            .globalPrivacyControl === true) {
-        return true;
-    }
-    return false;
-}
-/**
- * Sanitize URL for tracking (extract pathname + search)
- */
-function sanitizeUrl(url) {
-    try {
-        const parsed = new URL(url);
-        return parsed.pathname + parsed.search;
-    }
-    catch {
-        return "/";
-    }
-}
-/**
- * Client-side tracker for pageviews
- */
-export class Tracker {
-    constructor(endpoint = DEFAULT_ENDPOINT) {
-        this.batcher = new EventBatcher(endpoint);
-        this.dntEnabled = isDNTEnabled();
-        // Get persistent ID (returns ephemeral if DNT is on)
-        this.sessionId = getPersistentSessionId(this.dntEnabled);
-    }
-    /**
-     * Track the current pageview
-     */
-    trackPageview() {
-        // Respect DNT - don't track if enabled
-        if (this.dntEnabled) {
-            return;
-        }
-        // Skip if not in browser
-        if (typeof window === "undefined") {
-            return;
-        }
-        const event = {
-            sessionId: this.sessionId,
-            pageUrl: sanitizeUrl(window.location.href),
-            referrer: document.referrer ? sanitizeUrl(document.referrer) : null,
-            userAgent: navigator.userAgent.slice(0, 512),
-            screenWidth: window.screen.width,
-            screenHeight: window.screen.height,
-            timestamp: new Date().toISOString(),
-        };
-        this.batcher.add(event);
-    }
-    /**
-     * Clean up the tracker
-     */
-    destroy() {
-        this.batcher.destroy();
-    }
-}
-//# sourceMappingURL=tracker.js.map

package/dist/client/tracker.js.map

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

package/dist/db/postgres.d.ts

@@ -1,16 +0,0 @@
-import type { AnalyticsDB, PageviewEvent, DateRange, PageStats, DailyStats } from "../types/index.js";
-/**
- * PostgreSQL implementation of the analytics database
- */
-export declare class PostgresDB implements AnalyticsDB {
-    private readonly pool;
-    constructor(connectionString: string);
-    insertPageview(event: PageviewEvent, ipHash: string | null): Promise<void>;
-    getPageviews(dateRange: DateRange): Promise<number>;
-    getUniqueVisitors(dateRange: DateRange): Promise<number>;
-    getTopPages(dateRange: DateRange, limit: number): Promise<PageStats[]>;
-    getTopReferrers(dateRange: DateRange, limit: number): Promise<PageStats[]>;
-    getDailyStats(dateRange: DateRange): Promise<DailyStats[]>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=postgres.d.ts.map

package/dist/db/postgres.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/db/postgres.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACX,MAAM,mBAAmB,CAAC;AA+C3B;;GAEG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;gBAEhB,gBAAgB,EAAE,MAAM;IAS9B,cAAc,CAClB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC;IAoBV,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAanD,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxD,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAuBtE,eAAe,CACnB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC;IAuBjB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA2B1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}