@seneris/nosework 0.1.0

package/dist/client/errors.js

@@ -0,0 +1,173 @@
+/**
+ * Client-side error capture for nosework
+ *
+ * This is a lightweight (~2KB) script that captures unhandled errors
+ * and sends them to your tracking endpoint.
+ *
+ * Usage:
+ * ```typescript
+ * import { initErrorTracking } from '@seneris/nosework/client/errors'
+ *
+ * initErrorTracking({
+ *   endpoint: '/api/analytics/error',
+ *   siteId: process.env.NEXT_PUBLIC_ANALYTICS_SITE_ID!,
+ * })
+ * ```
+ */
+let config = null;
+let errorCount = 0;
+let lastResetTime = Date.now();
+/**
+ * Reset rate limiter every minute
+ */
+function checkRateLimit() {
+    const now = Date.now();
+    if (now - lastResetTime > 60000) {
+        errorCount = 0;
+        lastResetTime = now;
+    }
+    const limit = config?.rateLimit ?? 10;
+    if (errorCount >= limit) {
+        return false;
+    }
+    errorCount++;
+    return true;
+}
+/**
+ * Send error to the tracking endpoint
+ */
+async function sendError(payload) {
+    if (!config)
+        return;
+    try {
+        await fetch(config.endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+            // Don't wait for response, fire and forget
+            keepalive: true,
+        });
+    }
+    catch {
+        // Silently fail - we don't want error tracking to cause more errors
+    }
+}
+/**
+ * Process and send an error
+ */
+function handleError(captured) {
+    if (!config)
+        return;
+    // Apply filter if provided
+    if (config.filter && !config.filter(captured)) {
+        return;
+    }
+    // Check rate limit
+    if (!checkRateLimit()) {
+        return;
+    }
+    const payload = {
+        siteId: config.siteId,
+        message: captured.message,
+        stack: captured.stack,
+        url: captured.url,
+        metadata: {
+            ...config.metadata,
+            errorType: captured.type,
+        },
+    };
+    sendError(payload);
+}
+/**
+ * Handler for window.onerror events
+ */
+function errorHandler(event) {
+    handleError({
+        message: event.message || "Unknown error",
+        stack: event.error?.stack,
+        url: window.location.href,
+        type: "error",
+    });
+}
+/**
+ * Handler for unhandled promise rejections
+ */
+function rejectionHandler(event) {
+    let message = "Unhandled promise rejection";
+    let stack;
+    if (event.reason instanceof Error) {
+        message = event.reason.message;
+        stack = event.reason.stack;
+    }
+    else if (typeof event.reason === "string") {
+        message = event.reason;
+    }
+    else if (event.reason && typeof event.reason === "object") {
+        message = JSON.stringify(event.reason);
+    }
+    handleError({
+        message,
+        stack,
+        url: window.location.href,
+        type: "unhandledrejection",
+    });
+}
+/**
+ * Initialize error tracking
+ * Call this once when your app starts
+ */
+export function initErrorTracking(options) {
+    if (typeof window === "undefined") {
+        // SSR - do nothing
+        return;
+    }
+    config = options;
+    // Add event listeners
+    window.addEventListener("error", errorHandler);
+    window.addEventListener("unhandledrejection", rejectionHandler);
+}
+/**
+ * Stop error tracking and remove event listeners
+ */
+export function stopErrorTracking() {
+    if (typeof window === "undefined")
+        return;
+    window.removeEventListener("error", errorHandler);
+    window.removeEventListener("unhandledrejection", rejectionHandler);
+    config = null;
+}
+/**
+ * Manually track an error
+ * Useful for caught exceptions you still want to track
+ */
+export function captureError(error, metadata) {
+    if (!config)
+        return;
+    const captured = {
+        message: typeof error === "string" ? error : error.message,
+        stack: typeof error === "string" ? undefined : error.stack,
+        url: typeof window !== "undefined" ? window.location.href : "",
+        type: "error",
+    };
+    // Apply filter
+    if (config.filter && !config.filter(captured)) {
+        return;
+    }
+    // Check rate limit
+    if (!checkRateLimit()) {
+        return;
+    }
+    const payload = {
+        siteId: config.siteId,
+        message: captured.message,
+        stack: captured.stack,
+        url: captured.url,
+        metadata: {
+            ...config.metadata,
+            ...metadata,
+            errorType: "manual",
+        },
+    };
+    sendError(payload);
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8BH,IAAI,MAAM,GAA+B,IAAI,CAAC;AAC9C,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,IAAI,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE/B;;GAEG;AACH,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,aAAa,GAAG,KAAK,EAAE,CAAC;QAChC,UAAU,GAAG,CAAC,CAAC;QACf,aAAa,GAAG,GAAG,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACtC,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU,EAAE,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,OAAqB;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,2CAA2C;YAC3C,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,QAAuB;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,2BAA2B;IAC3B,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAiB;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,QAAQ,EAAE;YACR,GAAG,MAAM,CAAC,QAAQ;YAClB,SAAS,EAAE,QAAQ,CAAC,IAAI;SACzB;KACF,CAAC;IAEF,SAAS,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,KAAiB;IACrC,WAAW,CAAC;QACV,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,eAAe;QACzC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK;QACzB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QACzB,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAA4B;IACpD,IAAI,OAAO,GAAG,6BAA6B,CAAC;IAC5C,IAAI,KAAyB,CAAC;IAE9B,IAAI,KAAK,CAAC,MAAM,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QAC/B,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IACzB,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC;QACV,OAAO;QACP,KAAK;QACL,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QACzB,IAAI,EAAE,oBAAoB;KAC3B,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,mBAAmB;QACnB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,OAAO,CAAC;IAEjB,sBAAsB;IACtB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC/C,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAE1C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClD,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;IACnE,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAqB,EACrB,QAAkC;IAElC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,QAAQ,GAAkB;QAC9B,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;QAC1D,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK;QAC1D,GAAG,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC9D,IAAI,EAAE,OAAO;KACd,CAAC;IAEF,eAAe;IACf,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAiB;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,QAAQ,EAAE;YACR,GAAG,MAAM,CAAC,QAAQ;YAClB,GAAG,QAAQ;YACX,SAAS,EAAE,QAAQ;SACpB;KACF,CAAC;IAEF,SAAS,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,7 @@
+import { PrismaClient } from "@prisma/client";
+declare global {
+    var __noseworkPrisma: PrismaClient | undefined;
+}
+export declare function getClient(): PrismaClient;
+export declare function disconnect(): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,gBAAgB,EAAE,YAAY,GAAG,SAAS,CAAC;CAChD;AAID,wBAAgB,SAAS,IAAI,YAAY,CAoBxC;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD"}

package/dist/client.js

@@ -0,0 +1,29 @@
+import { PrismaClient } from "@prisma/client";
+let prismaClient = null;
+export function getClient() {
+    if (prismaClient) {
+        return prismaClient;
+    }
+    // In development, use global to preserve client across hot reloads
+    if (process.env.NODE_ENV === "development") {
+        if (!global.__noseworkPrisma) {
+            global.__noseworkPrisma = new PrismaClient({
+                datasourceUrl: process.env.ANALYTICS_DATABASE_URL,
+            });
+        }
+        prismaClient = global.__noseworkPrisma;
+    }
+    else {
+        prismaClient = new PrismaClient({
+            datasourceUrl: process.env.ANALYTICS_DATABASE_URL,
+        });
+    }
+    return prismaClient;
+}
+export async function disconnect() {
+    if (prismaClient) {
+        await prismaClient.$disconnect();
+        prismaClient = null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,IAAI,YAAY,GAAwB,IAAI,CAAC;AAE7C,MAAM,UAAU,SAAS;IACvB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC7B,MAAM,CAAC,gBAAgB,GAAG,IAAI,YAAY,CAAC;gBACzC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;aAClD,CAAC,CAAC;QACL,CAAC;QACD,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,IAAI,YAAY,CAAC;YAC9B,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;SAClD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;QACjC,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,40 @@
+import type { TrackErrorOptions, ErrorStats, ErrorGroupData, ErrorInstance, ErrorGroupStatus } from "./types.js";
+/**
+ * Track a JavaScript error
+ */
+export declare function trackError(options: TrackErrorOptions): Promise<void>;
+/**
+ * Get error statistics
+ */
+export declare function getErrorStats(siteId: string, options?: {
+    startDate?: Date;
+    endDate?: Date;
+}): Promise<ErrorStats>;
+/**
+ * Get error groups (aggregated errors by fingerprint)
+ */
+export declare function getErrorGroups(siteId: string, options?: {
+    status?: ErrorGroupStatus;
+    limit?: number;
+    offset?: number;
+}): Promise<ErrorGroupData[]>;
+/**
+ * Get individual error instances for a specific error group
+ */
+export declare function getErrorInstances(siteId: string, fingerprint: string, options?: {
+    limit?: number;
+    offset?: number;
+}): Promise<ErrorInstance[]>;
+/**
+ * Update error group status
+ */
+export declare function updateErrorGroupStatus(siteId: string, fingerprint: string, status: ErrorGroupStatus): Promise<void>;
+/**
+ * Delete errors older than a certain date
+ * Useful for manual cleanup
+ */
+export declare function deleteOldErrors(siteId: string, olderThan: Date): Promise<{
+    deletedErrors: number;
+    deletedGroups: number;
+}>;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAgDpB;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD1E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,GAC7C,OAAO,CAAC,UAAU,CAAC,CA2CrB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,cAAc,EAAE,CAAC,CAyB3B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B1B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,IAAI,GACd,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAwC3D"}

package/dist/error.js

@@ -0,0 +1,248 @@
+import { getClient } from "./client.js";
+import { createHash } from "crypto";
+/**
+ * Create a fingerprint for grouping similar errors
+ * Normalizes variable parts to group similar errors together
+ */
+function createFingerprint(message, stack) {
+    // Normalize message (remove variable parts)
+    const normalizedMessage = message
+        .replace(/\d+/g, "N") // Numbers → N
+        .replace(/'[^']*'/g, "'S'") // Single-quoted strings → 'S'
+        .replace(/"[^"]*"/g, '"S"') // Double-quoted strings → "S"
+        .replace(/`[^`]*`/g, "`S`") // Template strings → `S`
+        .replace(/0x[a-fA-F0-9]+/g, "0xHEX"); // Hex addresses → 0xHEX
+    // Extract top stack frame (most relevant for grouping)
+    let topFrame = "";
+    if (stack) {
+        const lines = stack.split("\n");
+        // Find first line that looks like a stack frame (starts with "at " or similar)
+        for (const line of lines.slice(1)) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("at ") || trimmed.match(/^\w+@/)) {
+                // Normalize file paths and line numbers
+                topFrame = trimmed
+                    .replace(/:\d+:\d+/g, ":L:C") // Line:column → L:C
+                    .replace(/\?.*/g, ""); // Remove query strings
+                break;
+            }
+        }
+    }
+    const hash = createHash("sha256");
+    hash.update(normalizedMessage + topFrame);
+    return hash.digest("hex").slice(0, 16);
+}
+/**
+ * Extract pathname from URL
+ */
+function extractPathname(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Track a JavaScript error
+ */
+export async function trackError(options) {
+    const db = getClient();
+    const fingerprint = createFingerprint(options.message, options.stack);
+    const pathname = extractPathname(options.url);
+    const now = new Date();
+    // Create the error record
+    await db.error.create({
+        data: {
+            siteId: options.siteId,
+            message: options.message,
+            stack: options.stack,
+            fingerprint,
+            url: options.url,
+            pathname,
+            visitorHash: options.visitorHash,
+            sessionId: options.sessionId,
+            userId: options.userId,
+            browser: options.browser,
+            browserVer: options.browserVer,
+            os: options.os,
+            device: options.device,
+            metadata: options.metadata ?? undefined,
+        },
+    });
+    // Upsert the error group
+    await db.errorGroup.upsert({
+        where: {
+            siteId_fingerprint: {
+                siteId: options.siteId,
+                fingerprint,
+            },
+        },
+        create: {
+            siteId: options.siteId,
+            fingerprint,
+            message: options.message,
+            stack: options.stack,
+            count: 1,
+            firstSeen: now,
+            lastSeen: now,
+            status: "open",
+        },
+        update: {
+            count: { increment: 1 },
+            lastSeen: now,
+            // Update message/stack if this is a clearer example
+            ...(options.stack && { stack: options.stack }),
+        },
+    });
+}
+/**
+ * Get error statistics
+ */
+export async function getErrorStats(siteId, options) {
+    const db = getClient();
+    const where = {
+        siteId,
+        ...(options?.startDate || options?.endDate
+            ? {
+                timestamp: {
+                    ...(options?.startDate && { gte: options.startDate }),
+                    ...(options?.endDate && { lte: options.endDate }),
+                },
+            }
+            : {}),
+    };
+    const totalErrors = await db.error.count({ where });
+    const uniqueResult = await db.error.groupBy({
+        by: ["fingerprint"],
+        where,
+    });
+    const uniqueErrors = uniqueResult.length;
+    // Errors in last 24 hours
+    const oneDayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000);
+    const errorsToday = await db.error.count({
+        where: {
+            siteId,
+            timestamp: { gte: oneDayAgo },
+        },
+    });
+    // Open error groups
+    const openGroups = await db.errorGroup.count({
+        where: { siteId, status: "open" },
+    });
+    return {
+        totalErrors,
+        uniqueErrors,
+        errorsToday,
+        openGroups,
+    };
+}
+/**
+ * Get error groups (aggregated errors by fingerprint)
+ */
+export async function getErrorGroups(siteId, options) {
+    const db = getClient();
+    const limit = options?.limit ?? 50;
+    const offset = options?.offset ?? 0;
+    const groups = await db.errorGroup.findMany({
+        where: {
+            siteId,
+            ...(options?.status && { status: options.status }),
+        },
+        orderBy: { lastSeen: "desc" },
+        take: limit,
+        skip: offset,
+    });
+    return groups.map((g) => ({
+        id: g.id,
+        fingerprint: g.fingerprint,
+        message: g.message,
+        stack: g.stack,
+        count: g.count,
+        firstSeen: g.firstSeen,
+        lastSeen: g.lastSeen,
+        status: g.status,
+    }));
+}
+/**
+ * Get individual error instances for a specific error group
+ */
+export async function getErrorInstances(siteId, fingerprint, options) {
+    const db = getClient();
+    const limit = options?.limit ?? 50;
+    const offset = options?.offset ?? 0;
+    const errors = await db.error.findMany({
+        where: { siteId, fingerprint },
+        orderBy: { timestamp: "desc" },
+        take: limit,
+        skip: offset,
+    });
+    return errors.map((e) => ({
+        id: e.id,
+        message: e.message,
+        stack: e.stack,
+        url: e.url,
+        pathname: e.pathname,
+        visitorHash: e.visitorHash,
+        sessionId: e.sessionId,
+        userId: e.userId,
+        browser: e.browser,
+        browserVer: e.browserVer,
+        os: e.os,
+        device: e.device,
+        metadata: e.metadata,
+        timestamp: e.timestamp,
+    }));
+}
+/**
+ * Update error group status
+ */
+export async function updateErrorGroupStatus(siteId, fingerprint, status) {
+    const db = getClient();
+    await db.errorGroup.update({
+        where: {
+            siteId_fingerprint: { siteId, fingerprint },
+        },
+        data: { status },
+    });
+}
+/**
+ * Delete errors older than a certain date
+ * Useful for manual cleanup
+ */
+export async function deleteOldErrors(siteId, olderThan) {
+    const db = getClient();
+    // Delete old error instances
+    const deletedErrors = await db.error.deleteMany({
+        where: {
+            siteId,
+            timestamp: { lt: olderThan },
+        },
+    });
+    // Delete error groups with no remaining errors
+    // First, get fingerprints that still have errors
+    const remainingFingerprints = await db.error.groupBy({
+        by: ["fingerprint"],
+        where: { siteId },
+    });
+    const activeFingerprints = new Set(remainingFingerprints.map((r) => r.fingerprint));
+    // Delete groups not in active fingerprints
+    const allGroups = await db.errorGroup.findMany({
+        where: { siteId },
+        select: { fingerprint: true },
+    });
+    const groupsToDelete = allGroups
+        .filter((g) => !activeFingerprints.has(g.fingerprint))
+        .map((g) => g.fingerprint);
+    const deletedGroups = await db.errorGroup.deleteMany({
+        where: {
+            siteId,
+            fingerprint: { in: groupsToDelete },
+        },
+    });
+    return {
+        deletedErrors: deletedErrors.count,
+        deletedGroups: deletedGroups.count,
+    };
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { trackPageView, trackEvent } from "./track.js";
+export { trackError, getErrorStats, getErrorGroups, getErrorInstances, updateErrorGroupStatus, deleteOldErrors, } from "./error.js";
+export { getStats, getTopPages, getLocations, getReferrers, getDevices, getTimeSeries, getOrCreateSite, listSites, getSessionStats, getEntryPages, getExitPages, getPageFlows, getSessions, } from "./query.js";
+export { getClient, disconnect } from "./client.js";
+export { isBot, cleanupOldSalts } from "./utils.js";
+export { parseUserAgent } from "./ua.js";
+export type { TrackPageViewOptions, TrackEventOptions, DateRange, QueryOptions, PaginatedQueryOptions, Stats, TopPage, LocationData, ReferrerData, DeviceData, GeoLocation, ParsedUserAgent, VisitorInfo, SessionStats, SessionData, EntryExitPage, PageFlow, TrackErrorOptions, ErrorStats, ErrorGroupStatus, ErrorGroupData, ErrorInstance, } from "./types.js";
+export type { TimeSeriesDataPoint } from "./query.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EACf,SAAS,EAET,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EACf,WAAW,EAEX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EAER,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Main exports for nosework analytics package
+// Tracking functions
+export { trackPageView, trackEvent } from "./track.js";
+// Error tracking functions
+export { trackError, getErrorStats, getErrorGroups, getErrorInstances, updateErrorGroupStatus, deleteOldErrors, } from "./error.js";
+// Query functions
+export { getStats, getTopPages, getLocations, getReferrers, getDevices, getTimeSeries, getOrCreateSite, listSites, 
+// Session analytics
+getSessionStats, getEntryPages, getExitPages, getPageFlows, getSessions, } from "./query.js";
+// Client utilities
+export { getClient, disconnect } from "./client.js";
+// Utility functions
+export { isBot, cleanupOldSalts } from "./utils.js";
+// User-Agent parsing (for advanced use cases)
+export { parseUserAgent } from "./ua.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,2BAA2B;AAC3B,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EACf,SAAS;AACT,oBAAoB;AACpB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpD,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,48 @@
+import type { QueryOptions, PaginatedQueryOptions, Stats, TopPage, LocationData, ReferrerData, DeviceData, SessionStats, SessionData, EntryExitPage, PageFlow } from "./types.js";
+export declare function getStats(options: QueryOptions): Promise<Stats>;
+export declare function getTopPages(options: PaginatedQueryOptions): Promise<TopPage[]>;
+export declare function getLocations(options: PaginatedQueryOptions): Promise<LocationData[]>;
+export declare function getReferrers(options: PaginatedQueryOptions): Promise<ReferrerData[]>;
+export declare function getDevices(options: PaginatedQueryOptions): Promise<DeviceData[]>;
+export interface TimeSeriesDataPoint {
+    date: string;
+    pageViews: number;
+    visitors: number;
+}
+export declare function getTimeSeries(options: QueryOptions & {
+    interval?: "hour" | "day" | "week" | "month";
+}): Promise<TimeSeriesDataPoint[]>;
+/**
+ * Get aggregate session statistics
+ */
+export declare function getSessionStats(options: QueryOptions): Promise<SessionStats>;
+/**
+ * Get entry pages (first page of each session)
+ */
+export declare function getEntryPages(options: PaginatedQueryOptions): Promise<EntryExitPage[]>;
+/**
+ * Get exit pages (last page of each session)
+ */
+export declare function getExitPages(options: PaginatedQueryOptions): Promise<EntryExitPage[]>;
+/**
+ * Get common page flow paths (sequence of pages in sessions)
+ */
+export declare function getPageFlows(options: PaginatedQueryOptions & {
+    maxPathLength?: number;
+}): Promise<PageFlow[]>;
+/**
+ * Get individual session data (for debugging/analysis)
+ */
+export declare function getSessions(options: PaginatedQueryOptions): Promise<SessionData[]>;
+export declare function getOrCreateSite(domain: string, name?: string): Promise<{
+    id: string;
+    name: string;
+    domain: string;
+}>;
+export declare function listSites(): Promise<{
+    id: string;
+    name: string;
+    domain: string;
+    createdAt: Date;
+}[]>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,KAAK,EACL,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACT,MAAM,YAAY,CAAC;AAmBpB,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAuCpE;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,OAAO,EAAE,CAAC,CA+BpB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAqCzB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CA+BzB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,UAAU,EAAE,CAAC,CAsCvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACvE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA6BhC;AA4BD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,CAAC,CA0DvB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAqC1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAqC1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2CrB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,WAAW,EAAE,CAAC,CAoFxB;AAGD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAevD;AAGD,wBAAsB,SAAS,IAAI,OAAO,CACxC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,EAAE,CAChE,CAGA"}