locallytics 0.1.0

package/dist/server/validator.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Configuration for the locallytics() function
+ */
+export interface LocallyticsConfig {
+    /** PostgreSQL connection string */
+    database: string;
+    /** Optional API key for GET endpoint authentication */
+    apiKey?: string;
+}
+/**
+ * Pageview event sent from client
+ */
+export interface PageviewEvent {
+    /** Client-generated session ID (ephemeral) */
+    sessionId: string;
+    /** Sanitized page URL (pathname + search) */
+    pageUrl: string;
+    /** Sanitized referrer URL (nullable) */
+    referrer: string | null;
+    /** User agent string (limited to 512 chars) */
+    userAgent: string;
+    /** Screen width in pixels */
+    screenWidth: number;
+    /** Screen height in pixels */
+    screenHeight: number;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+}
+/**
+ * Pageview as stored in database
+ */
+export interface StoredPageview extends PageviewEvent {
+    /** UUID primary key */
+    id: string;
+    /** SHA-256 hashed IP address (nullable) */
+    ipHash: string | null;
+}
+/**
+ * Date range for analytics queries
+ */
+export type DateRange = "last24h" | "last7d" | "last30d" | {
+    start: Date;
+    end: Date;
+};
+/**
+ * Page statistics
+ */
+export interface PageStats {
+    /** Page URL */
+    pageUrl: string;
+    /** Number of pageviews */
+    count: number;
+}
+/**
+ * Daily statistics
+ */
+export interface DailyStats {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Total pageviews */
+    pageviews: number;
+    /** Unique visitors (distinct sessions) */
+    uniqueVisitors: number;
+}
+/**
+ * Complete analytics data response
+ */
+export interface AnalyticsResult {
+    /** Total pageviews in date range */
+    pageviews: number;
+    /** Unique visitors (distinct sessions) in date range */
+    uniqueVisitors: number;
+    /** Top pages by pageview count */
+    topPages: PageStats[];
+    /** Top referrers by pageview count */
+    topReferrers: PageStats[];
+    /** Daily breakdown of stats */
+    dailyStats: DailyStats[];
+}
+/**
+ * Database interface for analytics operations
+ */
+export interface AnalyticsDB {
+    /** Insert a pageview event */
+    insertPageview(event: PageviewEvent, ipHash: string | null): Promise<void>;
+    /** Get total pageview count */
+    getPageviews(dateRange: DateRange): Promise<number>;
+    /** Get unique visitor count (distinct sessions) */
+    getUniqueVisitors(dateRange: DateRange): Promise<number>;
+    /** Get top pages by pageview count */
+    getTopPages(dateRange: DateRange, limit: number): Promise<PageStats[]>;
+    /** Get top referrers by pageview count */
+    getTopReferrers(dateRange: DateRange, limit: number): Promise<PageStats[]>;
+    /** Get daily stats breakdown */
+    getDailyStats(dateRange: DateRange): Promise<DailyStats[]>;
+    /** Close database connection */
+    close(): Promise<void>;
+}
+/**
+ * Route handler type for Next.js App Router
+ */
+export interface RouteHandler {
+    GET: (request: Request) => Promise<Response>;
+    POST: (request: Request) => Promise<Response>;
+}
+/**
+ * Options for AnalyticsJSON helper
+ */
+export interface AnalyticsDataOptions {
+    /** Optional date range for analytics data (default: last7d) */
+    dateRange?: DateRange;
+    /** API endpoint URL (defaults to /api/analytics) */
+    endpoint?: string;
+}
+/**
+ * Custom error class for Locallytics errors
+ */
+export declare class LocallyticsError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+    static validation(message: string): LocallyticsError;
+    static rateLimit(): LocallyticsError;
+    static unauthorized(): LocallyticsError;
+    static database(message: string): LocallyticsError;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,24 @@
+/**
+ * Custom error class for Locallytics errors
+ */
+export class LocallyticsError extends Error {
+    constructor(message, code, statusCode = 500) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = "LocallyticsError";
+    }
+    static validation(message) {
+        return new LocallyticsError(message, "VALIDATION_ERROR", 400);
+    }
+    static rateLimit() {
+        return new LocallyticsError("Rate limit exceeded", "RATE_LIMIT_EXCEEDED", 429);
+    }
+    static unauthorized() {
+        return new LocallyticsError("Unauthorized", "UNAUTHORIZED", 401);
+    }
+    static database(message) {
+        return new LocallyticsError(message, "DATABASE_ERROR", 500);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AA6HA;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YACE,OAAe,EACC,IAAY,EACZ,aAAqB,GAAG;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QAGxC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,OAAe;QAC/B,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,gBAAgB,CACzB,qBAAqB,EACrB,qBAAqB,EACrB,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,gBAAgB,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAe;QAC7B,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Hash an IP address using SHA-256 for privacy
+ *
+ * @param ip - Raw IP address
+ * @returns SHA-256 hash of the IP address
+ */
+export declare function hashIP(ip: string): string;
+/**
+ * Extract IP address from request headers
+ * Checks x-forwarded-for and x-real-ip headers
+ *
+ * @param request - Incoming request
+ * @returns IP address or null if not found
+ */
+export declare function getIPFromRequest(request: Request): string | null;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAoBhE"}

package/dist/utils/hash.js

@@ -0,0 +1,36 @@
+import { createHash } from "crypto";
+/**
+ * Hash an IP address using SHA-256 for privacy
+ *
+ * @param ip - Raw IP address
+ * @returns SHA-256 hash of the IP address
+ */
+export function hashIP(ip) {
+    return createHash("sha256").update(ip).digest("hex");
+}
+/**
+ * Extract IP address from request headers
+ * Checks x-forwarded-for and x-real-ip headers
+ *
+ * @param request - Incoming request
+ * @returns IP address or null if not found
+ */
+export function getIPFromRequest(request) {
+    const headers = request.headers;
+    // Check x-forwarded-for first (common for proxies/load balancers)
+    const forwardedFor = headers.get("x-forwarded-for");
+    if (forwardedFor) {
+        // Take the first IP in the chain (original client)
+        const firstIP = forwardedFor.split(",")[0];
+        if (firstIP) {
+            return firstIP.trim();
+        }
+    }
+    // Check x-real-ip (nginx)
+    const realIP = headers.get("x-real-ip");
+    if (realIP) {
+        return realIP.trim();
+    }
+    return null;
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,kEAAkE;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACpD,IAAI,YAAY,EAAE,CAAC;QACjB,mDAAmD;QACnD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/rate-limit.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Simple in-memory rate limiter
+ */
+export declare class RateLimiter {
+    private readonly requests;
+    private readonly maxRequests;
+    private readonly windowMs;
+    private cleanupInterval;
+    /**
+     * Create a new rate limiter
+     *
+     * @param maxRequests - Maximum requests allowed in the time window
+     * @param windowMs - Time window in milliseconds
+     */
+    constructor(maxRequests?: number, windowMs?: number);
+    /**
+     * Check if an identifier is within rate limits
+     *
+     * @param identifier - Unique identifier (e.g., IP address)
+     * @returns true if request is allowed, false if rate limited
+     */
+    check(identifier: string): boolean;
+    /**
+     * Clean up expired entries to prevent memory leaks
+     */
+    private cleanup;
+    /**
+     * Stop the cleanup interval (for graceful shutdown)
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/utils/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,eAAe,CAA+C;IAEtE;;;;;OAKG;gBACS,WAAW,GAAE,MAAY,EAAE,QAAQ,GAAE,MAAc;IAe/D;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAsBlC;;OAEG;IACH,OAAO,CAAC,OAAO;IAef;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/utils/rate-limit.js

@@ -0,0 +1,73 @@
+/**
+ * Simple in-memory rate limiter
+ */
+export class RateLimiter {
+    /**
+     * Create a new rate limiter
+     *
+     * @param maxRequests - Maximum requests allowed in the time window
+     * @param windowMs - Time window in milliseconds
+     */
+    constructor(maxRequests = 100, windowMs = 60000) {
+        this.requests = new Map();
+        this.cleanupInterval = null;
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+        // Cleanup expired entries every minute
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 60000);
+        // Prevent the interval from keeping the process alive
+        if (this.cleanupInterval.unref) {
+            this.cleanupInterval.unref();
+        }
+    }
+    /**
+     * Check if an identifier is within rate limits
+     *
+     * @param identifier - Unique identifier (e.g., IP address)
+     * @returns true if request is allowed, false if rate limited
+     */
+    check(identifier) {
+        const now = Date.now();
+        const windowStart = now - this.windowMs;
+        // Get existing requests for this identifier
+        const existing = this.requests.get(identifier) ?? [];
+        // Filter to only requests within the current window
+        const recentRequests = existing.filter((time) => time > windowStart);
+        // Check if limit exceeded
+        if (recentRequests.length >= this.maxRequests) {
+            return false;
+        }
+        // Add current request
+        recentRequests.push(now);
+        this.requests.set(identifier, recentRequests);
+        return true;
+    }
+    /**
+     * Clean up expired entries to prevent memory leaks
+     */
+    cleanup() {
+        const now = Date.now();
+        const windowStart = now - this.windowMs;
+        for (const [identifier, timestamps] of this.requests.entries()) {
+            const recentRequests = timestamps.filter((time) => time > windowStart);
+            if (recentRequests.length === 0) {
+                this.requests.delete(identifier);
+            }
+            else {
+                this.requests.set(identifier, recentRequests);
+            }
+        }
+    }
+    /**
+     * Stop the cleanup interval (for graceful shutdown)
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/utils/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/utils/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAW;IAMtB;;;;;OAKG;IACH,YAAY,cAAsB,GAAG,EAAE,WAAmB,KAAK;QAX9C,aAAQ,GAA0B,IAAI,GAAG,EAAE,CAAC;QAGrD,oBAAe,GAA0C,IAAI,CAAC;QASpE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,uCAAuC;QACvC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,sDAAsD;QACtD,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAkB;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAExC,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAErD,oDAAoD;QACpD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC;QAErE,0BAA0B;QAC1B,IAAI,cAAc,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,sBAAsB;QACtB,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAE9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAExC,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,WAAW,CAAC,CAAC;YAEvE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "locallytics",
+  "version": "0.1.0",
+  "description": "Self-hosted, privacy-first analytics SDK for Next.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/db/schema.sql"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest"
+  },
+  "keywords": [
+    "analytics",
+    "privacy",
+    "nextjs",
+    "postgresql",
+    "self-hosted"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "pg": "^8.11.3"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0",
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/pg": "^8.10.9",
+    "@types/react": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.1.0"
+  }
+}

package/src/db/schema.sql

@@ -0,0 +1,35 @@
+-- Locallytics PostgreSQL Schema
+-- Run this to create the required table and indexes
+
+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()
+);
+
+-- Index for time-based queries (most common)
+CREATE INDEX IF NOT EXISTS idx_pageviews_timestamp 
+    ON locallytics_pageviews(timestamp DESC);
+
+-- Index for session lookups
+CREATE INDEX IF NOT EXISTS idx_pageviews_session 
+    ON locallytics_pageviews(session_id);
+
+-- Index for page URL grouping
+CREATE INDEX IF NOT EXISTS idx_pageviews_page_url 
+    ON locallytics_pageviews(page_url);
+
+-- Partial index for referrer (only non-null values)
+CREATE INDEX IF NOT EXISTS idx_pageviews_referrer 
+    ON locallytics_pageviews(referrer) 
+    WHERE referrer IS NOT NULL;
+
+-- Composite index for time + session queries
+CREATE INDEX IF NOT EXISTS idx_pageviews_timestamp_session 
+    ON locallytics_pageviews(timestamp DESC, session_id);