5xx-sdk 1.1.0 → 1.2.0

package/README.md

@@ -53,6 +53,13 @@ const fivexx = new FiveXXNode({
 // Enable automatic capture of uncaught exceptions
 fivexx.enableAutoCapture();
 
+// Wrap route handlers for automatic error capture (recommended)
+// Works with Next.js, Express, Fastify, and any framework
+export const GET = fivexx.wrapHandler(async (req: NextRequest) => {
+  const data = await db.user.findMany();
+  return NextResponse.json(data);
+});
+
 // Wrap async functions
 const wrappedFn = fivexx.wrapAsync(async () => {
   await someAsyncOperation();
@@ -118,7 +125,8 @@ Extends FiveXX with Node.js-specific features.
 
 **Additional Methods:**
 - `enableAutoCapture()` - Auto-capture uncaughtException and unhandledRejection
-- `wrapAsync(fn, metadata?)` - Wrap async function to capture errors
+- `wrapHandler(fn)` - Wrap HTTP route handlers to automatically capture errors (recommended for Next.js, Express, Fastify)
+- `wrapAsync(fn, metadata?)` - Wrap any async function to capture errors
 
 ## Metadata
 

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { F as FiveXX, a as FiveXXOptions } from './client-BhKj28Zi.mjs';
+import { F as FiveXX, b as FiveXXOptions } from './client-t5SsLKrz.mjs';
 
 /**
  * Browser-specific FiveXX client with automatic error capture
@@ -7,6 +7,15 @@ declare class FiveXXBrowser extends FiveXX {
     private autoCapture;
     private originalOnError;
     private originalOnUnhandledRejection;
+    private analyticsEnabled;
+    private sessionId;
+    private analyticsBuffer;
+    private flushInterval;
+    private originalPushState;
+    private originalReplaceState;
+    private boundPopstateHandler;
+    private boundVisibilityHandler;
+    private boundBeforeUnloadHandler;
     constructor(options: FiveXXOptions);
     /**
      * Enable automatic capture of unhandled errors and promise rejections
@@ -16,6 +25,31 @@ declare class FiveXXBrowser extends FiveXX {
      * Disable automatic capture
      */
     disableAutoCapture(): void;
+    /**
+     * Enable opt-in analytics tracking.
+     * Tracks page views automatically, including SPA navigations.
+     */
+    enableAnalytics(): void;
+    /**
+     * Track a custom event (stored for future use, logs for now)
+     */
+    trackEvent(name: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Capture a page view and add it to the buffer
+     */
+    private trackPageView;
+    /**
+     * Flush the analytics buffer by POSTing to the server
+     */
+    private flushAnalytics;
+    /**
+     * Flush analytics using navigator.sendBeacon (for beforeunload / visibilitychange)
+     */
+    private flushAnalyticsBeacon;
+    /**
+     * Clean up analytics listeners and intervals
+     */
+    cleanupAnalytics(): void;
 }
 
 export { FiveXXBrowser };

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import { F as FiveXX, a as FiveXXOptions } from './client-BhKj28Zi.js';
+import { F as FiveXX, b as FiveXXOptions } from './client-t5SsLKrz.js';
 
 /**
  * Browser-specific FiveXX client with automatic error capture
@@ -7,6 +7,15 @@ declare class FiveXXBrowser extends FiveXX {
     private autoCapture;
     private originalOnError;
     private originalOnUnhandledRejection;
+    private analyticsEnabled;
+    private sessionId;
+    private analyticsBuffer;
+    private flushInterval;
+    private originalPushState;
+    private originalReplaceState;
+    private boundPopstateHandler;
+    private boundVisibilityHandler;
+    private boundBeforeUnloadHandler;
     constructor(options: FiveXXOptions);
     /**
      * Enable automatic capture of unhandled errors and promise rejections
@@ -16,6 +25,31 @@ declare class FiveXXBrowser extends FiveXX {
      * Disable automatic capture
      */
     disableAutoCapture(): void;
+    /**
+     * Enable opt-in analytics tracking.
+     * Tracks page views automatically, including SPA navigations.
+     */
+    enableAnalytics(): void;
+    /**
+     * Track a custom event (stored for future use, logs for now)
+     */
+    trackEvent(name: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Capture a page view and add it to the buffer
+     */
+    private trackPageView;
+    /**
+     * Flush the analytics buffer by POSTing to the server
+     */
+    private flushAnalytics;
+    /**
+     * Flush analytics using navigator.sendBeacon (for beforeunload / visibilitychange)
+     */
+    private flushAnalyticsBeacon;
+    /**
+     * Clean up analytics listeners and intervals
+     */
+    cleanupAnalytics(): void;
 }
 
 export { FiveXXBrowser };

package/dist/browser.js

@@ -32,6 +32,14 @@ var FiveXX = class {
     this.endpoint = options.endpoint.replace(/\/$/, "");
     this.environment = options.environment || "production";
   }
+  /** @internal */
+  getApiKey() {
+    return this.apiKey;
+  }
+  /** @internal */
+  getEndpoint() {
+    return this.endpoint;
+  }
   /**
    * Set the environment (e.g., "production", "development", "staging")
    */
@@ -106,6 +114,20 @@ var FiveXXBrowser = class extends FiveXX {
     this.autoCapture = false;
     this.originalOnError = null;
     this.originalOnUnhandledRejection = null;
+    // Analytics properties
+    this.analyticsEnabled = false;
+    this.analyticsBuffer = [];
+    this.flushInterval = null;
+    this.originalPushState = null;
+    this.originalReplaceState = null;
+    this.boundPopstateHandler = null;
+    this.boundVisibilityHandler = null;
+    this.boundBeforeUnloadHandler = null;
+    this.sessionId = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.random() * 16 | 0;
+      const v = c === "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
     if (typeof window !== "undefined" && !options.environment) {
       const hostname = window.location.hostname;
       if (hostname === "localhost" || hostname === "127.0.0.1") {
@@ -173,6 +195,144 @@ var FiveXXBrowser = class extends FiveXX {
     window.onerror = this.originalOnError;
     window.onunhandledrejection = this.originalOnUnhandledRejection;
   }
+  // ---------------------------------------------------------------------------
+  // Analytics
+  // ---------------------------------------------------------------------------
+  /**
+   * Enable opt-in analytics tracking.
+   * Tracks page views automatically, including SPA navigations.
+   */
+  enableAnalytics() {
+    if (this.analyticsEnabled || typeof window === "undefined") return;
+    this.analyticsEnabled = true;
+    this.trackPageView();
+    this.originalPushState = history.pushState.bind(history);
+    this.originalReplaceState = history.replaceState.bind(history);
+    const self = this;
+    history.pushState = function(...args) {
+      self.originalPushState(...args);
+      self.trackPageView();
+    };
+    history.replaceState = function(...args) {
+      self.originalReplaceState(...args);
+      self.trackPageView();
+    };
+    this.boundPopstateHandler = () => this.trackPageView();
+    window.addEventListener("popstate", this.boundPopstateHandler);
+    this.flushInterval = setInterval(() => this.flushAnalytics(), 5e3);
+    this.boundVisibilityHandler = () => {
+      if (document.visibilityState === "hidden") {
+        this.flushAnalyticsBeacon();
+      }
+    };
+    document.addEventListener("visibilitychange", this.boundVisibilityHandler);
+    this.boundBeforeUnloadHandler = () => this.flushAnalyticsBeacon();
+    window.addEventListener("beforeunload", this.boundBeforeUnloadHandler);
+  }
+  /**
+   * Track a custom event (stored for future use, logs for now)
+   */
+  trackEvent(name, metadata) {
+    if (!this.analyticsEnabled) return;
+    console.debug("[5xx] trackEvent:", name, metadata);
+  }
+  // ---------------------------------------------------------------------------
+  // Private analytics helpers
+  // ---------------------------------------------------------------------------
+  /**
+   * Capture a page view and add it to the buffer
+   */
+  trackPageView() {
+    if (typeof window === "undefined") return;
+    const url = new URL(window.location.href);
+    const beacon = {
+      path: url.pathname,
+      referrer: document.referrer || void 0,
+      screenWidth: window.innerWidth
+    };
+    const utmSource = url.searchParams.get("utm_source");
+    const utmMedium = url.searchParams.get("utm_medium");
+    const utmCampaign = url.searchParams.get("utm_campaign");
+    if (utmSource) beacon.utmSource = utmSource;
+    if (utmMedium) beacon.utmMedium = utmMedium;
+    if (utmCampaign) beacon.utmCampaign = utmCampaign;
+    this.analyticsBuffer.push(beacon);
+  }
+  /**
+   * Flush the analytics buffer by POSTing to the server
+   */
+  async flushAnalytics() {
+    if (this.analyticsBuffer.length === 0) return;
+    const payload = {
+      events: [...this.analyticsBuffer],
+      sessionId: this.sessionId
+    };
+    const snapshot = this.analyticsBuffer;
+    this.analyticsBuffer = [];
+    try {
+      const response = await fetch(`${this.getEndpoint()}/api/analytics`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.getApiKey()
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        this.analyticsBuffer = snapshot.concat(this.analyticsBuffer);
+      }
+    } catch {
+      this.analyticsBuffer = snapshot.concat(this.analyticsBuffer);
+    }
+  }
+  /**
+   * Flush analytics using navigator.sendBeacon (for beforeunload / visibilitychange)
+   */
+  flushAnalyticsBeacon() {
+    if (this.analyticsBuffer.length === 0) return;
+    const payload = {
+      events: [...this.analyticsBuffer],
+      sessionId: this.sessionId
+    };
+    const blob = new Blob([JSON.stringify(payload)], {
+      type: "application/json"
+    });
+    const sent = navigator.sendBeacon(`${this.getEndpoint()}/api/analytics`, blob);
+    if (sent) {
+      this.analyticsBuffer = [];
+    }
+  }
+  /**
+   * Clean up analytics listeners and intervals
+   */
+  cleanupAnalytics() {
+    if (!this.analyticsEnabled) return;
+    this.analyticsEnabled = false;
+    if (this.flushInterval !== null) {
+      clearInterval(this.flushInterval);
+      this.flushInterval = null;
+    }
+    if (this.originalPushState) {
+      history.pushState = this.originalPushState;
+      this.originalPushState = null;
+    }
+    if (this.originalReplaceState) {
+      history.replaceState = this.originalReplaceState;
+      this.originalReplaceState = null;
+    }
+    if (this.boundPopstateHandler) {
+      window.removeEventListener("popstate", this.boundPopstateHandler);
+      this.boundPopstateHandler = null;
+    }
+    if (this.boundVisibilityHandler) {
+      document.removeEventListener("visibilitychange", this.boundVisibilityHandler);
+      this.boundVisibilityHandler = null;
+    }
+    if (this.boundBeforeUnloadHandler) {
+      window.removeEventListener("beforeunload", this.boundBeforeUnloadHandler);
+      this.boundBeforeUnloadHandler = null;
+    }
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/browser.ts","../src/client.ts"],"sourcesContent":["import { FiveXX } from \"./client\";\nimport type { FiveXXOptions } from \"./types\";\n\n/**\n * Browser-specific FiveXX client with automatic error capture\n */\nexport class FiveXXBrowser extends FiveXX {\n  private autoCapture = false;\n  private originalOnError: OnErrorEventHandler | null = null;\n  private originalOnUnhandledRejection: ((event: PromiseRejectionEvent) => void) | null = null;\n\n  constructor(options: FiveXXOptions) {\n    super(options);\n\n    // Auto-detect environment from URL\n    if (typeof window !== \"undefined\" && !options.environment) {\n      const hostname = window.location.hostname;\n      if (hostname === \"localhost\" || hostname === \"127.0.0.1\") {\n        this.setEnvironment(\"development\");\n      }\n    }\n  }\n\n  /**\n   * Enable automatic capture of unhandled errors and promise rejections\n   */\n  enableAutoCapture(): void {\n    if (this.autoCapture || typeof window === \"undefined\") return;\n\n    this.autoCapture = true;\n\n    // Capture unhandled errors\n    this.originalOnError = window.onerror;\n    window.onerror = (message, source, lineno, colno, error) => {\n      if (error) {\n        this.captureError(error, {\n          source,\n          lineno,\n          colno,\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      } else {\n        this.captureMessage(String(message), {\n          source,\n          lineno,\n          colno,\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      }\n\n      // Call original handler if it exists\n      if (this.originalOnError) {\n        return this.originalOnError(message, source, lineno, colno, error);\n      }\n      return false;\n    };\n\n    // Capture unhandled promise rejections\n    this.originalOnUnhandledRejection = window.onunhandledrejection;\n    window.onunhandledrejection = (event) => {\n      const error = event.reason;\n      if (error instanceof Error) {\n        this.captureError(error, {\n          type: \"unhandledRejection\",\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      } else {\n        this.captureMessage(String(error), {\n          type: \"unhandledRejection\",\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      }\n\n      if (this.originalOnUnhandledRejection) {\n        this.originalOnUnhandledRejection(event);\n      }\n    };\n  }\n\n  /**\n   * Disable automatic capture\n   */\n  disableAutoCapture(): void {\n    if (!this.autoCapture || typeof window === \"undefined\") return;\n\n    this.autoCapture = false;\n    window.onerror = this.originalOnError;\n    window.onunhandledrejection = this.originalOnUnhandledRejection;\n  }\n}\n","import type { FiveXXOptions, ErrorPayload, User } from \"./types\";\n\nexport class FiveXX {\n  private apiKey: string;\n  private endpoint: string;\n  private environment: string;\n  private user: User | null = null;\n\n  constructor(options: FiveXXOptions) {\n    this.apiKey = options.apiKey;\n    this.endpoint = options.endpoint.replace(/\\/$/, \"\"); // Remove trailing slash\n    this.environment = options.environment || \"production\";\n  }\n\n  /**\n   * Set the environment (e.g., \"production\", \"development\", \"staging\")\n   */\n  setEnvironment(env: string): void {\n    this.environment = env;\n  }\n\n  /**\n   * Set user context for errors\n   */\n  setUser(user: User | null): void {\n    this.user = user;\n  }\n\n  /**\n   * Capture an error and send it to the 5xx server\n   */\n  async captureError(\n    error: Error,\n    metadata?: Record<string, unknown>\n  ): Promise<string | null> {\n    const payload: ErrorPayload = {\n      message: error.message || String(error),\n      stack: error.stack,\n      environment: this.environment,\n      metadata: {\n        ...metadata,\n        ...(this.user && { user: this.user }),\n      },\n    };\n\n    return this.send(payload);\n  }\n\n  /**\n   * Capture a message as an error\n   */\n  async captureMessage(\n    message: string,\n    metadata?: Record<string, unknown>\n  ): Promise<string | null> {\n    const payload: ErrorPayload = {\n      message,\n      environment: this.environment,\n      metadata: {\n        ...metadata,\n        ...(this.user && { user: this.user }),\n      },\n    };\n\n    return this.send(payload);\n  }\n\n  /**\n   * Send error payload to the server\n   */\n  private async send(payload: ErrorPayload): Promise<string | null> {\n    try {\n      const response = await fetch(`${this.endpoint}/api/errors`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.apiKey,\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (!response.ok) {\n        console.error(`5xx: Failed to send error (${response.status})`);\n        return null;\n      }\n\n      const data = await response.json();\n      return data.id;\n    } catch (err) {\n      console.error(\"5xx: Failed to send error\", err);\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/browser.ts","../src/client.ts"],"sourcesContent":["import { FiveXX } from \"./client\";\nimport type { FiveXXOptions, AnalyticsBeacon, AnalyticsBatchPayload } from \"./types\";\n\n/** UTM and tracking params we keep when sanitizing URLs */\nconst ALLOWED_QUERY_PARAMS = new Set([\n  \"utm_source\",\n  \"utm_medium\",\n  \"utm_campaign\",\n  \"utm_term\",\n  \"utm_content\",\n  \"ref\",\n]);\n\n/**\n * Browser-specific FiveXX client with automatic error capture\n */\nexport class FiveXXBrowser extends FiveXX {\n  private autoCapture = false;\n  private originalOnError: OnErrorEventHandler | null = null;\n  private originalOnUnhandledRejection: ((event: PromiseRejectionEvent) => void) | null = null;\n\n  // Analytics properties\n  private analyticsEnabled = false;\n  private sessionId: string;\n  private analyticsBuffer: AnalyticsBeacon[] = [];\n  private flushInterval: ReturnType<typeof setInterval> | null = null;\n  private originalPushState: typeof history.pushState | null = null;\n  private originalReplaceState: typeof history.replaceState | null = null;\n  private boundPopstateHandler: (() => void) | null = null;\n  private boundVisibilityHandler: (() => void) | null = null;\n  private boundBeforeUnloadHandler: (() => void) | null = null;\n\n  constructor(options: FiveXXOptions) {\n    super(options);\n\n    // Generate session ID\n    this.sessionId =\n      typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\"\n        ? crypto.randomUUID()\n        : \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n            const r = (Math.random() * 16) | 0;\n            const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n            return v.toString(16);\n          });\n\n    // Auto-detect environment from URL\n    if (typeof window !== \"undefined\" && !options.environment) {\n      const hostname = window.location.hostname;\n      if (hostname === \"localhost\" || hostname === \"127.0.0.1\") {\n        this.setEnvironment(\"development\");\n      }\n    }\n  }\n\n  /**\n   * Enable automatic capture of unhandled errors and promise rejections\n   */\n  enableAutoCapture(): void {\n    if (this.autoCapture || typeof window === \"undefined\") return;\n\n    this.autoCapture = true;\n\n    // Capture unhandled errors\n    this.originalOnError = window.onerror;\n    window.onerror = (message, source, lineno, colno, error) => {\n      if (error) {\n        this.captureError(error, {\n          source,\n          lineno,\n          colno,\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      } else {\n        this.captureMessage(String(message), {\n          source,\n          lineno,\n          colno,\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      }\n\n      // Call original handler if it exists\n      if (this.originalOnError) {\n        return this.originalOnError(message, source, lineno, colno, error);\n      }\n      return false;\n    };\n\n    // Capture unhandled promise rejections\n    this.originalOnUnhandledRejection = window.onunhandledrejection;\n    window.onunhandledrejection = (event) => {\n      const error = event.reason;\n      if (error instanceof Error) {\n        this.captureError(error, {\n          type: \"unhandledRejection\",\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      } else {\n        this.captureMessage(String(error), {\n          type: \"unhandledRejection\",\n          url: window.location.href,\n          userAgent: navigator.userAgent,\n        });\n      }\n\n      if (this.originalOnUnhandledRejection) {\n        this.originalOnUnhandledRejection(event);\n      }\n    };\n  }\n\n  /**\n   * Disable automatic capture\n   */\n  disableAutoCapture(): void {\n    if (!this.autoCapture || typeof window === \"undefined\") return;\n\n    this.autoCapture = false;\n    window.onerror = this.originalOnError;\n    window.onunhandledrejection = this.originalOnUnhandledRejection;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Analytics\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Enable opt-in analytics tracking.\n   * Tracks page views automatically, including SPA navigations.\n   */\n  enableAnalytics(): void {\n    if (this.analyticsEnabled || typeof window === \"undefined\") return;\n\n    this.analyticsEnabled = true;\n\n    // Track the current page immediately\n    this.trackPageView();\n\n    // Monkey-patch history methods for SPA navigation tracking\n    this.originalPushState = history.pushState.bind(history);\n    this.originalReplaceState = history.replaceState.bind(history);\n\n    const self = this;\n\n    history.pushState = function (...args: Parameters<typeof history.pushState>) {\n      self.originalPushState!(...args);\n      self.trackPageView();\n    };\n\n    history.replaceState = function (...args: Parameters<typeof history.replaceState>) {\n      self.originalReplaceState!(...args);\n      self.trackPageView();\n    };\n\n    // Listen for popstate (browser back/forward)\n    this.boundPopstateHandler = () => this.trackPageView();\n    window.addEventListener(\"popstate\", this.boundPopstateHandler);\n\n    // Start flush interval (every 5 seconds)\n    this.flushInterval = setInterval(() => this.flushAnalytics(), 5000);\n\n    // Flush on visibility change (tab hidden) and before unload\n    this.boundVisibilityHandler = () => {\n      if (document.visibilityState === \"hidden\") {\n        this.flushAnalyticsBeacon();\n      }\n    };\n    document.addEventListener(\"visibilitychange\", this.boundVisibilityHandler);\n\n    this.boundBeforeUnloadHandler = () => this.flushAnalyticsBeacon();\n    window.addEventListener(\"beforeunload\", this.boundBeforeUnloadHandler);\n  }\n\n  /**\n   * Track a custom event (stored for future use, logs for now)\n   */\n  trackEvent(name: string, metadata?: Record<string, unknown>): void {\n    if (!this.analyticsEnabled) return;\n    console.debug(\"[5xx] trackEvent:\", name, metadata);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private analytics helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Capture a page view and add it to the buffer\n   */\n  private trackPageView(): void {\n    if (typeof window === \"undefined\") return;\n\n    const url = new URL(window.location.href);\n\n    const beacon: AnalyticsBeacon = {\n      path: url.pathname,\n      referrer: document.referrer || undefined,\n      screenWidth: window.innerWidth,\n    };\n\n    // Extract UTM params\n    const utmSource = url.searchParams.get(\"utm_source\");\n    const utmMedium = url.searchParams.get(\"utm_medium\");\n    const utmCampaign = url.searchParams.get(\"utm_campaign\");\n\n    if (utmSource) beacon.utmSource = utmSource;\n    if (utmMedium) beacon.utmMedium = utmMedium;\n    if (utmCampaign) beacon.utmCampaign = utmCampaign;\n\n    this.analyticsBuffer.push(beacon);\n  }\n\n  /**\n   * Flush the analytics buffer by POSTing to the server\n   */\n  private async flushAnalytics(): Promise<void> {\n    if (this.analyticsBuffer.length === 0) return;\n\n    const payload: AnalyticsBatchPayload = {\n      events: [...this.analyticsBuffer],\n      sessionId: this.sessionId,\n    };\n\n    // Optimistically clear the buffer; we will restore on failure\n    const snapshot = this.analyticsBuffer;\n    this.analyticsBuffer = [];\n\n    try {\n      const response = await fetch(`${this.getEndpoint()}/api/analytics`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.getApiKey(),\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (!response.ok) {\n        // Put events back for retry\n        this.analyticsBuffer = snapshot.concat(this.analyticsBuffer);\n      }\n    } catch {\n      // Network error - put events back for retry\n      this.analyticsBuffer = snapshot.concat(this.analyticsBuffer);\n    }\n  }\n\n  /**\n   * Flush analytics using navigator.sendBeacon (for beforeunload / visibilitychange)\n   */\n  private flushAnalyticsBeacon(): void {\n    if (this.analyticsBuffer.length === 0) return;\n\n    const payload: AnalyticsBatchPayload = {\n      events: [...this.analyticsBuffer],\n      sessionId: this.sessionId,\n    };\n\n    const blob = new Blob([JSON.stringify(payload)], {\n      type: \"application/json\",\n    });\n\n    const sent = navigator.sendBeacon(`${this.getEndpoint()}/api/analytics`, blob);\n\n    if (sent) {\n      this.analyticsBuffer = [];\n    }\n    // If sendBeacon fails, keep buffer for next flush attempt\n  }\n\n  /**\n   * Clean up analytics listeners and intervals\n   */\n  cleanupAnalytics(): void {\n    if (!this.analyticsEnabled) return;\n\n    this.analyticsEnabled = false;\n\n    // Clear flush interval\n    if (this.flushInterval !== null) {\n      clearInterval(this.flushInterval);\n      this.flushInterval = null;\n    }\n\n    // Restore original pushState / replaceState\n    if (this.originalPushState) {\n      history.pushState = this.originalPushState;\n      this.originalPushState = null;\n    }\n    if (this.originalReplaceState) {\n      history.replaceState = this.originalReplaceState;\n      this.originalReplaceState = null;\n    }\n\n    // Remove popstate listener\n    if (this.boundPopstateHandler) {\n      window.removeEventListener(\"popstate\", this.boundPopstateHandler);\n      this.boundPopstateHandler = null;\n    }\n\n    // Remove visibility change listener\n    if (this.boundVisibilityHandler) {\n      document.removeEventListener(\"visibilitychange\", this.boundVisibilityHandler);\n      this.boundVisibilityHandler = null;\n    }\n\n    // Remove beforeunload listener\n    if (this.boundBeforeUnloadHandler) {\n      window.removeEventListener(\"beforeunload\", this.boundBeforeUnloadHandler);\n      this.boundBeforeUnloadHandler = null;\n    }\n  }\n}\n","import type { FiveXXOptions, ErrorPayload, User } from \"./types\";\n\nexport class FiveXX {\n  private apiKey: string;\n  private endpoint: string;\n  private environment: string;\n  private user: User | null = null;\n\n  /** @internal */\n  protected getApiKey(): string {\n    return this.apiKey;\n  }\n\n  /** @internal */\n  protected getEndpoint(): string {\n    return this.endpoint;\n  }\n\n  constructor(options: FiveXXOptions) {\n    this.apiKey = options.apiKey;\n    this.endpoint = options.endpoint.replace(/\\/$/, \"\"); // Remove trailing slash\n    this.environment = options.environment || \"production\";\n  }\n\n  /**\n   * Set the environment (e.g., \"production\", \"development\", \"staging\")\n   */\n  setEnvironment(env: string): void {\n    this.environment = env;\n  }\n\n  /**\n   * Set user context for errors\n   */\n  setUser(user: User | null): void {\n    this.user = user;\n  }\n\n  /**\n   * Capture an error and send it to the 5xx server\n   */\n  async captureError(\n    error: Error,\n    metadata?: Record<string, unknown>\n  ): Promise<string | null> {\n    const payload: ErrorPayload = {\n      message: error.message || String(error),\n      stack: error.stack,\n      environment: this.environment,\n      metadata: {\n        ...metadata,\n        ...(this.user && { user: this.user }),\n      },\n    };\n\n    return this.send(payload);\n  }\n\n  /**\n   * Capture a message as an error\n   */\n  async captureMessage(\n    message: string,\n    metadata?: Record<string, unknown>\n  ): Promise<string | null> {\n    const payload: ErrorPayload = {\n      message,\n      environment: this.environment,\n      metadata: {\n        ...metadata,\n        ...(this.user && { user: this.user }),\n      },\n    };\n\n    return this.send(payload);\n  }\n\n  /**\n   * Send error payload to the server\n   */\n  private async send(payload: ErrorPayload): Promise<string | null> {\n    try {\n      const response = await fetch(`${this.endpoint}/api/errors`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.apiKey,\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (!response.ok) {\n        console.error(`5xx: Failed to send error (${response.status})`);\n        return null;\n      }\n\n      const data = await response.json();\n      return data.id;\n    } catch (err) {\n      console.error(\"5xx: Failed to send error\", err);\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/browser.mjs

@@ -1,7 +1,7 @@
 import {
   FiveXXBrowser
-} from "./chunk-LD3XNYST.mjs";
-import "./chunk-5YY5E33R.mjs";
+} from "./chunk-IAF5CKNL.mjs";
+import "./chunk-G4LKAXG5.mjs";
 export {
   FiveXXBrowser
 };

package/dist/{chunk-JCBAF7DF.mjs → chunk-762E5RVI.mjs}

@@ -1,6 +1,6 @@
 import {
   FiveXX
-} from "./chunk-5YY5E33R.mjs";
+} from "./chunk-G4LKAXG5.mjs";
 
 // src/node.ts
 var FiveXXNode = class extends FiveXX {
@@ -112,4 +112,4 @@ var FiveXXNode = class extends FiveXX {
 export {
   FiveXXNode
 };
-//# sourceMappingURL=chunk-JCBAF7DF.mjs.map
+//# sourceMappingURL=chunk-762E5RVI.mjs.map

package/dist/{chunk-5YY5E33R.mjs → chunk-G4LKAXG5.mjs}

@@ -6,6 +6,14 @@ var FiveXX = class {
     this.endpoint = options.endpoint.replace(/\/$/, "");
     this.environment = options.environment || "production";
   }
+  /** @internal */
+  getApiKey() {
+    return this.apiKey;
+  }
+  /** @internal */
+  getEndpoint() {
+    return this.endpoint;
+  }
   /**
    * Set the environment (e.g., "production", "development", "staging")
    */
@@ -76,4 +84,4 @@ var FiveXX = class {
 export {
   FiveXX
 };
-//# sourceMappingURL=chunk-5YY5E33R.mjs.map
+//# sourceMappingURL=chunk-G4LKAXG5.mjs.map

package/dist/chunk-G4LKAXG5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { FiveXXOptions, ErrorPayload, User } from \"./types\";\n\nexport class FiveXX {\n  private apiKey: string;\n  private endpoint: string;\n  private environment: string;\n  private user: User | null = null;\n\n  /** @internal */\n  protected getApiKey(): string {\n    return this.apiKey;\n  }\n\n  /** @internal */\n  protected getEndpoint(): string {\n    return this.endpoint;\n  }\n\n  constructor(options: FiveXXOptions) {\n    this.apiKey = options.apiKey;\n    this.endpoint = options.endpoint.replace(/\\/$/, \"\"); // Remove trailing slash\n    this.environment = options.environment || \"production\";\n  }\n\n  /**\n   * Set the environment (e.g., \"production\", \"development\", \"staging\")\n   */\n  setEnvironment(env: string): void {\n    this.environment = env;\n  }\n\n  /**\n   * Set user context for errors\n   */\n  setUser(user: User | null): void {\n    this.user = user;\n  }\n\n  /**\n   * Capture an error and send it to the 5xx server\n   */\n  async captureError(\n    error: Error,\n    metadata?: Record<string, unknown>\n  ): Promise<string | null> {\n    const payload: ErrorPayload = {\n      message: error.message || String(error),\n      stack: error.stack,\n      environment: this.environment,\n      metadata: {\n        ...metadata,\n        ...(this.user && { user: this.user }),\n      },\n    };\n\n    return this.send(payload);\n  }\n\n  /**\n   * Capture a message as an error\n   */\n  async captureMessage(\n    message: string,\n    metadata?: Record<string, unknown>\n  ): Promise<string | null> {\n    const payload: ErrorPayload = {\n      message,\n      environment: this.environment,\n      metadata: {\n        ...metadata,\n        ...(this.user && { user: this.user }),\n      },\n    };\n\n    return this.send(payload);\n  }\n\n  /**\n   * Send error payload to the server\n   */\n  private async send(payload: ErrorPayload): Promise<string | null> {\n    try {\n      const response = await fetch(`${this.endpoint}/api/errors`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.apiKey,\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (!response.ok) {\n        console.error(`5xx: Failed to send error (${response.status})`);\n        return null;\n      }\n\n      const data = await response.json();\n      return data.id;\n    } catch (err) {\n      console.error(\"5xx: Failed to send error\", err);\n      return null;\n    }\n  }\n}\n"],"mappings":";AAEO,IAAM,SAAN,MAAa;AAAA,EAgBlB,YAAY,SAAwB;AAZpC,SAAQ,OAAoB;AAa1B,SAAK,SAAS,QAAQ;AACtB,SAAK,WAAW,QAAQ,SAAS,QAAQ,OAAO,EAAE;AAClD,SAAK,cAAc,QAAQ,eAAe;AAAA,EAC5C;AAAA;AAAA,EAbU,YAAoB;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGU,cAAsB;AAC9B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAWA,eAAe,KAAmB;AAChC,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,MAAyB;AAC/B,SAAK,OAAO;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aACJ,OACA,UACwB;AACxB,UAAM,UAAwB;AAAA,MAC5B,SAAS,MAAM,WAAW,OAAO,KAAK;AAAA,MACtC,OAAO,MAAM;AAAA,MACb,aAAa,KAAK;AAAA,MAClB,UAAU;AAAA,QACR,GAAG;AAAA,QACH,GAAI,KAAK,QAAQ,EAAE,MAAM,KAAK,KAAK;AAAA,MACrC;AAAA,IACF;AAEA,WAAO,KAAK,KAAK,OAAO;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eACJ,SACA,UACwB;AACxB,UAAM,UAAwB;AAAA,MAC5B;AAAA,MACA,aAAa,KAAK;AAAA,MAClB,UAAU;AAAA,QACR,GAAG;AAAA,QACH,GAAI,KAAK,QAAQ,EAAE,MAAM,KAAK,KAAK;AAAA,MACrC;AAAA,IACF;AAEA,WAAO,KAAK,KAAK,OAAO;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,KAAK,SAA+C;AAChE,QAAI;AACF,YAAM,WAAW,MAAM,MAAM,GAAG,KAAK,QAAQ,eAAe;AAAA,QAC1D,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,aAAa,KAAK;AAAA,QACpB;AAAA,QACA,MAAM,KAAK,UAAU,OAAO;AAAA,MAC9B,CAAC;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,gBAAQ,MAAM,8BAA8B,SAAS,MAAM,GAAG;AAC9D,eAAO;AAAA,MACT;AAEA,YAAM,OAAO,MAAM,SAAS,KAAK;AACjC,aAAO,KAAK;AAAA,IACd,SAAS,KAAK;AACZ,cAAQ,MAAM,6BAA6B,GAAG;AAC9C,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-IAF5CKNL.mjs

@@ -0,0 +1,236 @@
+import {
+  FiveXX
+} from "./chunk-G4LKAXG5.mjs";
+
+// src/browser.ts
+var FiveXXBrowser = class extends FiveXX {
+  constructor(options) {
+    super(options);
+    this.autoCapture = false;
+    this.originalOnError = null;
+    this.originalOnUnhandledRejection = null;
+    // Analytics properties
+    this.analyticsEnabled = false;
+    this.analyticsBuffer = [];
+    this.flushInterval = null;
+    this.originalPushState = null;
+    this.originalReplaceState = null;
+    this.boundPopstateHandler = null;
+    this.boundVisibilityHandler = null;
+    this.boundBeforeUnloadHandler = null;
+    this.sessionId = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.random() * 16 | 0;
+      const v = c === "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
+    if (typeof window !== "undefined" && !options.environment) {
+      const hostname = window.location.hostname;
+      if (hostname === "localhost" || hostname === "127.0.0.1") {
+        this.setEnvironment("development");
+      }
+    }
+  }
+  /**
+   * Enable automatic capture of unhandled errors and promise rejections
+   */
+  enableAutoCapture() {
+    if (this.autoCapture || typeof window === "undefined") return;
+    this.autoCapture = true;
+    this.originalOnError = window.onerror;
+    window.onerror = (message, source, lineno, colno, error) => {
+      if (error) {
+        this.captureError(error, {
+          source,
+          lineno,
+          colno,
+          url: window.location.href,
+          userAgent: navigator.userAgent
+        });
+      } else {
+        this.captureMessage(String(message), {
+          source,
+          lineno,
+          colno,
+          url: window.location.href,
+          userAgent: navigator.userAgent
+        });
+      }
+      if (this.originalOnError) {
+        return this.originalOnError(message, source, lineno, colno, error);
+      }
+      return false;
+    };
+    this.originalOnUnhandledRejection = window.onunhandledrejection;
+    window.onunhandledrejection = (event) => {
+      const error = event.reason;
+      if (error instanceof Error) {
+        this.captureError(error, {
+          type: "unhandledRejection",
+          url: window.location.href,
+          userAgent: navigator.userAgent
+        });
+      } else {
+        this.captureMessage(String(error), {
+          type: "unhandledRejection",
+          url: window.location.href,
+          userAgent: navigator.userAgent
+        });
+      }
+      if (this.originalOnUnhandledRejection) {
+        this.originalOnUnhandledRejection(event);
+      }
+    };
+  }
+  /**
+   * Disable automatic capture
+   */
+  disableAutoCapture() {
+    if (!this.autoCapture || typeof window === "undefined") return;
+    this.autoCapture = false;
+    window.onerror = this.originalOnError;
+    window.onunhandledrejection = this.originalOnUnhandledRejection;
+  }
+  // ---------------------------------------------------------------------------
+  // Analytics
+  // ---------------------------------------------------------------------------
+  /**
+   * Enable opt-in analytics tracking.
+   * Tracks page views automatically, including SPA navigations.
+   */
+  enableAnalytics() {
+    if (this.analyticsEnabled || typeof window === "undefined") return;
+    this.analyticsEnabled = true;
+    this.trackPageView();
+    this.originalPushState = history.pushState.bind(history);
+    this.originalReplaceState = history.replaceState.bind(history);
+    const self = this;
+    history.pushState = function(...args) {
+      self.originalPushState(...args);
+      self.trackPageView();
+    };
+    history.replaceState = function(...args) {
+      self.originalReplaceState(...args);
+      self.trackPageView();
+    };
+    this.boundPopstateHandler = () => this.trackPageView();
+    window.addEventListener("popstate", this.boundPopstateHandler);
+    this.flushInterval = setInterval(() => this.flushAnalytics(), 5e3);
+    this.boundVisibilityHandler = () => {
+      if (document.visibilityState === "hidden") {
+        this.flushAnalyticsBeacon();
+      }
+    };
+    document.addEventListener("visibilitychange", this.boundVisibilityHandler);
+    this.boundBeforeUnloadHandler = () => this.flushAnalyticsBeacon();
+    window.addEventListener("beforeunload", this.boundBeforeUnloadHandler);
+  }
+  /**
+   * Track a custom event (stored for future use, logs for now)
+   */
+  trackEvent(name, metadata) {
+    if (!this.analyticsEnabled) return;
+    console.debug("[5xx] trackEvent:", name, metadata);
+  }
+  // ---------------------------------------------------------------------------
+  // Private analytics helpers
+  // ---------------------------------------------------------------------------
+  /**
+   * Capture a page view and add it to the buffer
+   */
+  trackPageView() {
+    if (typeof window === "undefined") return;
+    const url = new URL(window.location.href);
+    const beacon = {
+      path: url.pathname,
+      referrer: document.referrer || void 0,
+      screenWidth: window.innerWidth
+    };
+    const utmSource = url.searchParams.get("utm_source");
+    const utmMedium = url.searchParams.get("utm_medium");
+    const utmCampaign = url.searchParams.get("utm_campaign");
+    if (utmSource) beacon.utmSource = utmSource;
+    if (utmMedium) beacon.utmMedium = utmMedium;
+    if (utmCampaign) beacon.utmCampaign = utmCampaign;
+    this.analyticsBuffer.push(beacon);
+  }
+  /**
+   * Flush the analytics buffer by POSTing to the server
+   */
+  async flushAnalytics() {
+    if (this.analyticsBuffer.length === 0) return;
+    const payload = {
+      events: [...this.analyticsBuffer],
+      sessionId: this.sessionId
+    };
+    const snapshot = this.analyticsBuffer;
+    this.analyticsBuffer = [];
+    try {
+      const response = await fetch(`${this.getEndpoint()}/api/analytics`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.getApiKey()
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        this.analyticsBuffer = snapshot.concat(this.analyticsBuffer);
+      }
+    } catch {
+      this.analyticsBuffer = snapshot.concat(this.analyticsBuffer);
+    }
+  }
+  /**
+   * Flush analytics using navigator.sendBeacon (for beforeunload / visibilitychange)
+   */
+  flushAnalyticsBeacon() {
+    if (this.analyticsBuffer.length === 0) return;
+    const payload = {
+      events: [...this.analyticsBuffer],
+      sessionId: this.sessionId
+    };
+    const blob = new Blob([JSON.stringify(payload)], {
+      type: "application/json"
+    });
+    const sent = navigator.sendBeacon(`${this.getEndpoint()}/api/analytics`, blob);
+    if (sent) {
+      this.analyticsBuffer = [];
+    }
+  }
+  /**
+   * Clean up analytics listeners and intervals
+   */
+  cleanupAnalytics() {
+    if (!this.analyticsEnabled) return;
+    this.analyticsEnabled = false;
+    if (this.flushInterval !== null) {
+      clearInterval(this.flushInterval);
+      this.flushInterval = null;
+    }
+    if (this.originalPushState) {
+      history.pushState = this.originalPushState;
+      this.originalPushState = null;
+    }
+    if (this.originalReplaceState) {
+      history.replaceState = this.originalReplaceState;
+      this.originalReplaceState = null;
+    }
+    if (this.boundPopstateHandler) {
+      window.removeEventListener("popstate", this.boundPopstateHandler);
+      this.boundPopstateHandler = null;
+    }
+    if (this.boundVisibilityHandler) {
+      document.removeEventListener("visibilitychange", this.boundVisibilityHandler);
+      this.boundVisibilityHandler = null;
+    }
+    if (this.boundBeforeUnloadHandler) {
+      window.removeEventListener("beforeunload", this.boundBeforeUnloadHandler);
+      this.boundBeforeUnloadHandler = null;
+    }
+  }
+};
+
+export {
+  FiveXXBrowser
+};
+//# sourceMappingURL=chunk-IAF5CKNL.mjs.map