locallytics 0.1.8 → 0.2.0

package/dist/server/validator.d.ts

@@ -1,32 +0,0 @@
-import type { PageviewEvent } from "../types/index.js";
-/**
- * Sanitize a URL by extracting pathname and search, removing credentials
- *
- * @param url - Raw URL string
- * @returns Sanitized URL (pathname + search only)
- */
-export declare function sanitizeUrl(url: string): string;
-/**
- * Check if Do Not Track is enabled in the request
- *
- * @param request - Incoming request
- * @returns true if DNT is enabled
- */
-export declare function checkDNT(request: Request): boolean;
-/**
- * Validate a single pageview event
- *
- * @param data - Unknown input data
- * @returns Validated PageviewEvent
- * @throws LocallyticsError if validation fails
- */
-export declare function validatePageviewEvent(data: unknown): PageviewEvent;
-/**
- * Validate a batch of pageview events
- *
- * @param data - Unknown input data
- * @returns Array of validated PageviewEvents
- * @throws LocallyticsError if validation fails
- */
-export declare function validatePageviewBatch(data: unknown): PageviewEvent[];
-//# sourceMappingURL=validator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/server/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkB/C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAUlD;AASD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CA6ElE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,CA2BpE"}

package/dist/server/validator.js

@@ -1,144 +0,0 @@
-import { LocallyticsError } from "../types/index.js";
-const MAX_SESSION_ID_LENGTH = 255;
-const MAX_USER_AGENT_LENGTH = 512;
-const MAX_URL_LENGTH = 2048;
-const MAX_BATCH_SIZE = 100;
-/**
- * Sanitize a URL by extracting pathname and search, removing credentials
- *
- * @param url - Raw URL string
- * @returns Sanitized URL (pathname + search only)
- */
-export function sanitizeUrl(url) {
-    try {
-        // Handle relative URLs by adding a base
-        const parsed = new URL(url, "http://localhost");
-        // Extract pathname and search only (no origin, hash, credentials)
-        let sanitized = parsed.pathname + parsed.search;
-        // Limit length
-        if (sanitized.length > MAX_URL_LENGTH) {
-            sanitized = sanitized.slice(0, MAX_URL_LENGTH);
-        }
-        return sanitized;
-    }
-    catch {
-        // On parse error, return root
-        return "/";
-    }
-}
-/**
- * Check if Do Not Track is enabled in the request
- *
- * @param request - Incoming request
- * @returns true if DNT is enabled
- */
-export function checkDNT(request) {
-    const headers = request.headers;
-    // Check DNT header
-    const dnt = headers.get("dnt");
-    if (dnt === "1") {
-        return true;
-    }
-    return false;
-}
-/**
- * Type guard to check if value is a record
- */
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Validate a single pageview event
- *
- * @param data - Unknown input data
- * @returns Validated PageviewEvent
- * @throws LocallyticsError if validation fails
- */
-export function validatePageviewEvent(data) {
-    if (!isRecord(data)) {
-        throw LocallyticsError.validation("Event must be an object");
-    }
-    // sessionId
-    if (typeof data["sessionId"] !== "string" || data["sessionId"].length === 0) {
-        throw LocallyticsError.validation("sessionId must be a non-empty string");
-    }
-    if (data["sessionId"].length > MAX_SESSION_ID_LENGTH) {
-        throw LocallyticsError.validation(`sessionId must be at most ${MAX_SESSION_ID_LENGTH} characters`);
-    }
-    // pageUrl
-    if (typeof data["pageUrl"] !== "string" || data["pageUrl"].length === 0) {
-        throw LocallyticsError.validation("pageUrl must be a non-empty string");
-    }
-    // referrer (nullable)
-    if (data["referrer"] !== null &&
-        data["referrer"] !== undefined &&
-        typeof data["referrer"] !== "string") {
-        throw LocallyticsError.validation("referrer must be a string or null");
-    }
-    // userAgent
-    if (typeof data["userAgent"] !== "string") {
-        throw LocallyticsError.validation("userAgent must be a string");
-    }
-    // screenWidth
-    if (typeof data["screenWidth"] !== "number" ||
-        data["screenWidth"] <= 0 ||
-        !Number.isFinite(data["screenWidth"])) {
-        throw LocallyticsError.validation("screenWidth must be a positive number");
-    }
-    // screenHeight
-    if (typeof data["screenHeight"] !== "number" ||
-        data["screenHeight"] <= 0 ||
-        !Number.isFinite(data["screenHeight"])) {
-        throw LocallyticsError.validation("screenHeight must be a positive number");
-    }
-    // timestamp
-    if (typeof data["timestamp"] !== "string") {
-        throw LocallyticsError.validation("timestamp must be a string");
-    }
-    // Validate ISO 8601 format
-    const timestampDate = new Date(data["timestamp"]);
-    if (isNaN(timestampDate.getTime())) {
-        throw LocallyticsError.validation("timestamp must be a valid ISO 8601 date");
-    }
-    return {
-        sessionId: data["sessionId"],
-        pageUrl: sanitizeUrl(data["pageUrl"]),
-        referrer: typeof data["referrer"] === "string"
-            ? sanitizeUrl(data["referrer"])
-            : null,
-        userAgent: data["userAgent"].slice(0, MAX_USER_AGENT_LENGTH),
-        screenWidth: Math.round(data["screenWidth"]),
-        screenHeight: Math.round(data["screenHeight"]),
-        timestamp: data["timestamp"],
-    };
-}
-/**
- * Validate a batch of pageview events
- *
- * @param data - Unknown input data
- * @returns Array of validated PageviewEvents
- * @throws LocallyticsError if validation fails
- */
-export function validatePageviewBatch(data) {
-    if (!Array.isArray(data)) {
-        throw LocallyticsError.validation("Batch must be an array");
-    }
-    if (data.length === 0) {
-        throw LocallyticsError.validation("Batch cannot be empty");
-    }
-    if (data.length > MAX_BATCH_SIZE) {
-        throw LocallyticsError.validation(`Batch cannot exceed ${MAX_BATCH_SIZE} events`);
-    }
-    return data.map((event, index) => {
-        try {
-            return validatePageviewEvent(event);
-        }
-        catch (error) {
-            if (error instanceof LocallyticsError) {
-                throw LocallyticsError.validation(`Event at index ${index}: ${error.message}`);
-            }
-            throw error;
-        }
-    });
-}
-//# sourceMappingURL=validator.js.map

package/dist/server/validator.js.map

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

package/dist/types/index.d.ts

@@ -1,135 +0,0 @@
-/**
- * Database type supported by locallytics
- */
-export type DatabaseType = "postgres" | "mysql" | "sqlite";
-/**
- * Configuration for the locallytics() function
- */
-export interface LocallyticsConfig {
-    /** Database connection string or file path (for SQLite) */
-    database: string;
-    /** Database type - auto-detected from connection string if omitted */
-    type?: DatabaseType;
-    /** 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[];
-    /** Error message if fetch failed */
-    error?: string;
-}
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,QAAQ,GACR,SAAS,GACT;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,sCAAsC;IACtC,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,+BAA+B;IAC/B,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,mDAAmD;IACnD,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,sCAAsC;IACtC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvE,0CAA0C;IAC1C,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3E,gCAAgC;IAChC,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3D,gCAAgC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY;IAM1C,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAIpD,MAAM,CAAC,SAAS,IAAI,gBAAgB;IAQpC,MAAM,CAAC,YAAY,IAAI,gBAAgB;IAIvC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;CAGnD"}

package/dist/types/index.js

@@ -1,24 +0,0 @@
-/**
- * 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

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

@@ -1,16 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,36 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,32 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,73 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/src/db/schema-mysql.sql

@@ -1,17 +0,0 @@
--- Locallytics MySQL Schema
-
-CREATE TABLE IF NOT EXISTS locallytics_pageviews (
-    id INT AUTO_INCREMENT PRIMARY KEY,
-    session_id VARCHAR(255) NOT NULL,
-    page_url TEXT NOT NULL,
-    referrer TEXT,
-    user_agent VARCHAR(512) NOT NULL,
-    screen_width INT NOT NULL,
-    screen_height INT NOT NULL,
-    ip_hash VARCHAR(64),
-    timestamp DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_pageviews_timestamp (timestamp DESC),
-    INDEX idx_pageviews_session (session_id),
-    INDEX idx_pageviews_page_url (page_url(255)),
-    INDEX idx_pageviews_referrer (referrer(255))
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/src/db/schema-sqlite.sql

@@ -1,29 +0,0 @@
--- Locallytics SQLite Schema
-
-CREATE TABLE IF NOT EXISTS locallytics_pageviews (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    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 TEXT NOT NULL DEFAULT (datetime('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);
-
--- Index for referrer grouping
-CREATE INDEX IF NOT EXISTS idx_pageviews_referrer 
-    ON locallytics_pageviews(referrer);

package/src/db/schema.sql

@@ -1,35 +0,0 @@
--- 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);