5xx-sdk 1.0.0

package/README.md

@@ -0,0 +1,139 @@
+# @5xx/sdk
+
+Lightweight error tracking SDK for JavaScript/TypeScript applications.
+
+## Installation
+
+```bash
+npm install @5xx/sdk
+```
+
+Or copy the SDK files directly into your project.
+
+## Quick Start
+
+### Browser
+
+```typescript
+import { FiveXXBrowser } from '@5xx/sdk/browser';
+
+const fivexx = new FiveXXBrowser({
+  apiKey: 'your-api-key',
+  endpoint: 'https://your-5xx-instance.com',
+});
+
+// Enable automatic capture of unhandled errors
+fivexx.enableAutoCapture();
+
+// Set user context (optional)
+fivexx.setUser({
+  id: 'user-123',
+  email: 'user@example.com',
+});
+
+// Manual error capture
+try {
+  riskyOperation();
+} catch (error) {
+  fivexx.captureError(error, { context: 'checkout' });
+}
+```
+
+### Node.js
+
+```typescript
+import { FiveXXNode } from '@5xx/sdk/node';
+
+const fivexx = new FiveXXNode({
+  apiKey: 'your-api-key',
+  endpoint: 'https://your-5xx-instance.com',
+  exitOnFatalError: true, // Exit process after capturing fatal errors
+});
+
+// Enable automatic capture of uncaught exceptions
+fivexx.enableAutoCapture();
+
+// Wrap async functions
+const wrappedFn = fivexx.wrapAsync(async () => {
+  await someAsyncOperation();
+});
+
+// Manual capture
+fivexx.captureError(new Error('Something went wrong'), {
+  userId: '123',
+  requestId: 'abc',
+});
+```
+
+### Universal (works in both environments)
+
+```typescript
+import { FiveXX } from '@5xx/sdk';
+
+const fivexx = new FiveXX({
+  apiKey: 'your-api-key',
+  endpoint: 'https://your-5xx-instance.com',
+  environment: 'production',
+});
+
+// Manual capture only
+fivexx.captureError(new Error('Something went wrong'));
+fivexx.captureMessage('User performed invalid action');
+```
+
+## API
+
+### FiveXX (Base Client)
+
+```typescript
+new FiveXX(options: FiveXXOptions)
+
+interface FiveXXOptions {
+  apiKey: string;      // Your project's API key
+  endpoint: string;    // Your 5xx instance URL
+  environment?: string; // e.g., "production", "staging"
+}
+```
+
+**Methods:**
+- `setEnvironment(env: string)` - Set the environment
+- `setUser(user: User | null)` - Set user context for errors
+- `captureError(error: Error, metadata?: object)` - Capture an error
+- `captureMessage(message: string, metadata?: object)` - Capture a message
+
+### FiveXXBrowser
+
+Extends FiveXX with browser-specific features.
+
+**Additional Methods:**
+- `enableAutoCapture()` - Auto-capture window.onerror and unhandledrejection
+- `disableAutoCapture()` - Disable auto-capture
+
+### FiveXXNode
+
+Extends FiveXX with Node.js-specific features.
+
+**Constructor Options:**
+- `exitOnFatalError?: boolean` - Exit process after fatal errors (default: true)
+
+**Additional Methods:**
+- `enableAutoCapture()` - Auto-capture uncaughtException and unhandledRejection
+- `wrapAsync(fn, metadata?)` - Wrap async function to capture errors
+
+## Metadata
+
+You can attach any metadata to errors:
+
+```typescript
+fivexx.captureError(error, {
+  userId: 'user-123',
+  requestId: 'req-456',
+  action: 'checkout',
+  cart: { items: 3, total: 99.99 },
+});
+```
+
+The SDK automatically includes:
+- User context (if set via `setUser()`)
+- Browser: URL, user agent
+- Node.js: Node version, platform, PID

package/dist/browser.d.mts

@@ -0,0 +1,21 @@
+import { F as FiveXX, a as FiveXXOptions } from './client-BhKj28Zi.mjs';
+
+/**
+ * Browser-specific FiveXX client with automatic error capture
+ */
+declare class FiveXXBrowser extends FiveXX {
+    private autoCapture;
+    private originalOnError;
+    private originalOnUnhandledRejection;
+    constructor(options: FiveXXOptions);
+    /**
+     * Enable automatic capture of unhandled errors and promise rejections
+     */
+    enableAutoCapture(): void;
+    /**
+     * Disable automatic capture
+     */
+    disableAutoCapture(): void;
+}
+
+export { FiveXXBrowser };

package/dist/browser.d.ts

@@ -0,0 +1,21 @@
+import { F as FiveXX, a as FiveXXOptions } from './client-BhKj28Zi.js';
+
+/**
+ * Browser-specific FiveXX client with automatic error capture
+ */
+declare class FiveXXBrowser extends FiveXX {
+    private autoCapture;
+    private originalOnError;
+    private originalOnUnhandledRejection;
+    constructor(options: FiveXXOptions);
+    /**
+     * Enable automatic capture of unhandled errors and promise rejections
+     */
+    enableAutoCapture(): void;
+    /**
+     * Disable automatic capture
+     */
+    disableAutoCapture(): void;
+}
+
+export { FiveXXBrowser };

package/dist/browser.js

@@ -0,0 +1,181 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/browser.ts
+var browser_exports = {};
+__export(browser_exports, {
+  FiveXXBrowser: () => FiveXXBrowser
+});
+module.exports = __toCommonJS(browser_exports);
+
+// src/client.ts
+var FiveXX = class {
+  constructor(options) {
+    this.user = null;
+    this.apiKey = options.apiKey;
+    this.endpoint = options.endpoint.replace(/\/$/, "");
+    this.environment = options.environment || "production";
+  }
+  /**
+   * Set the environment (e.g., "production", "development", "staging")
+   */
+  setEnvironment(env) {
+    this.environment = env;
+  }
+  /**
+   * Set user context for errors
+   */
+  setUser(user) {
+    this.user = user;
+  }
+  /**
+   * Capture an error and send it to the 5xx server
+   */
+  async captureError(error, metadata) {
+    const payload = {
+      message: error.message || String(error),
+      stack: error.stack,
+      environment: this.environment,
+      metadata: {
+        ...metadata,
+        ...this.user && { user: this.user }
+      }
+    };
+    return this.send(payload);
+  }
+  /**
+   * Capture a message as an error
+   */
+  async captureMessage(message, metadata) {
+    const payload = {
+      message,
+      environment: this.environment,
+      metadata: {
+        ...metadata,
+        ...this.user && { user: this.user }
+      }
+    };
+    return this.send(payload);
+  }
+  /**
+   * Send error payload to the server
+   */
+  async send(payload) {
+    try {
+      const response = await fetch(`${this.endpoint}/api/errors`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.apiKey
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        console.error(`5xx: Failed to send error (${response.status})`);
+        return null;
+      }
+      const data = await response.json();
+      return data.id;
+    } catch (err) {
+      console.error("5xx: Failed to send error", err);
+      return null;
+    }
+  }
+};
+
+// src/browser.ts
+var FiveXXBrowser = class extends FiveXX {
+  constructor(options) {
+    super(options);
+    this.autoCapture = false;
+    this.originalOnError = null;
+    this.originalOnUnhandledRejection = null;
+    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;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FiveXXBrowser
+});
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +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":[]}

package/dist/browser.mjs

@@ -0,0 +1,8 @@
+import {
+  FiveXXBrowser
+} from "./chunk-LD3XNYST.mjs";
+import "./chunk-5YY5E33R.mjs";
+export {
+  FiveXXBrowser
+};
+//# sourceMappingURL=browser.mjs.map

package/dist/browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-5YY5E33R.mjs

@@ -0,0 +1,79 @@
+// src/client.ts
+var FiveXX = class {
+  constructor(options) {
+    this.user = null;
+    this.apiKey = options.apiKey;
+    this.endpoint = options.endpoint.replace(/\/$/, "");
+    this.environment = options.environment || "production";
+  }
+  /**
+   * Set the environment (e.g., "production", "development", "staging")
+   */
+  setEnvironment(env) {
+    this.environment = env;
+  }
+  /**
+   * Set user context for errors
+   */
+  setUser(user) {
+    this.user = user;
+  }
+  /**
+   * Capture an error and send it to the 5xx server
+   */
+  async captureError(error, metadata) {
+    const payload = {
+      message: error.message || String(error),
+      stack: error.stack,
+      environment: this.environment,
+      metadata: {
+        ...metadata,
+        ...this.user && { user: this.user }
+      }
+    };
+    return this.send(payload);
+  }
+  /**
+   * Capture a message as an error
+   */
+  async captureMessage(message, metadata) {
+    const payload = {
+      message,
+      environment: this.environment,
+      metadata: {
+        ...metadata,
+        ...this.user && { user: this.user }
+      }
+    };
+    return this.send(payload);
+  }
+  /**
+   * Send error payload to the server
+   */
+  async send(payload) {
+    try {
+      const response = await fetch(`${this.endpoint}/api/errors`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.apiKey
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        console.error(`5xx: Failed to send error (${response.status})`);
+        return null;
+      }
+      const data = await response.json();
+      return data.id;
+    } catch (err) {
+      console.error("5xx: Failed to send error", err);
+      return null;
+    }
+  }
+};
+
+export {
+  FiveXX
+};
+//# sourceMappingURL=chunk-5YY5E33R.mjs.map

package/dist/chunk-5YY5E33R.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  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,EAMlB,YAAY,SAAwB;AAFpC,SAAQ,OAAoB;AAG1B,SAAK,SAAS,QAAQ;AACtB,SAAK,WAAW,QAAQ,SAAS,QAAQ,OAAO,EAAE;AAClD,SAAK,cAAc,QAAQ,eAAe;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,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-LD3XNYST.mjs

@@ -0,0 +1,84 @@
+import {
+  FiveXX
+} from "./chunk-5YY5E33R.mjs";
+
+// src/browser.ts
+var FiveXXBrowser = class extends FiveXX {
+  constructor(options) {
+    super(options);
+    this.autoCapture = false;
+    this.originalOnError = null;
+    this.originalOnUnhandledRejection = null;
+    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;
+  }
+};
+
+export {
+  FiveXXBrowser
+};
+//# sourceMappingURL=chunk-LD3XNYST.mjs.map

package/dist/chunk-LD3XNYST.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser.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"],"mappings":";;;;;AAMO,IAAM,gBAAN,cAA4B,OAAO;AAAA,EAKxC,YAAY,SAAwB;AAClC,UAAM,OAAO;AALf,SAAQ,cAAc;AACtB,SAAQ,kBAA8C;AACtD,SAAQ,+BAAgF;AAMtF,QAAI,OAAO,WAAW,eAAe,CAAC,QAAQ,aAAa;AACzD,YAAM,WAAW,OAAO,SAAS;AACjC,UAAI,aAAa,eAAe,aAAa,aAAa;AACxD,aAAK,eAAe,aAAa;AAAA,MACnC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,oBAA0B;AACxB,QAAI,KAAK,eAAe,OAAO,WAAW,YAAa;AAEvD,SAAK,cAAc;AAGnB,SAAK,kBAAkB,OAAO;AAC9B,WAAO,UAAU,CAAC,SAAS,QAAQ,QAAQ,OAAO,UAAU;AAC1D,UAAI,OAAO;AACT,aAAK,aAAa,OAAO;AAAA,UACvB;AAAA,UACA;AAAA,UACA;AAAA,UACA,KAAK,OAAO,SAAS;AAAA,UACrB,WAAW,UAAU;AAAA,QACvB,CAAC;AAAA,MACH,OAAO;AACL,aAAK,eAAe,OAAO,OAAO,GAAG;AAAA,UACnC;AAAA,UACA;AAAA,UACA;AAAA,UACA,KAAK,OAAO,SAAS;AAAA,UACrB,WAAW,UAAU;AAAA,QACvB,CAAC;AAAA,MACH;AAGA,UAAI,KAAK,iBAAiB;AACxB,eAAO,KAAK,gBAAgB,SAAS,QAAQ,QAAQ,OAAO,KAAK;AAAA,MACnE;AACA,aAAO;AAAA,IACT;AAGA,SAAK,+BAA+B,OAAO;AAC3C,WAAO,uBAAuB,CAAC,UAAU;AACvC,YAAM,QAAQ,MAAM;AACpB,UAAI,iBAAiB,OAAO;AAC1B,aAAK,aAAa,OAAO;AAAA,UACvB,MAAM;AAAA,UACN,KAAK,OAAO,SAAS;AAAA,UACrB,WAAW,UAAU;AAAA,QACvB,CAAC;AAAA,MACH,OAAO;AACL,aAAK,eAAe,OAAO,KAAK,GAAG;AAAA,UACjC,MAAM;AAAA,UACN,KAAK,OAAO,SAAS;AAAA,UACrB,WAAW,UAAU;AAAA,QACvB,CAAC;AAAA,MACH;AAEA,UAAI,KAAK,8BAA8B;AACrC,aAAK,6BAA6B,KAAK;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,qBAA2B;AACzB,QAAI,CAAC,KAAK,eAAe,OAAO,WAAW,YAAa;AAExD,SAAK,cAAc;AACnB,WAAO,UAAU,KAAK;AACtB,WAAO,uBAAuB,KAAK;AAAA,EACrC;AACF;","names":[]}

package/dist/chunk-MOWJJPVU.mjs

@@ -0,0 +1,72 @@
+import {
+  FiveXX
+} from "./chunk-5YY5E33R.mjs";
+
+// src/node.ts
+var FiveXXNode = class extends FiveXX {
+  constructor(options) {
+    super(options);
+    this.autoCapture = false;
+    this.exitOnFatalError = options.exitOnFatalError ?? true;
+    if (!options.environment && process.env.NODE_ENV) {
+      this.setEnvironment(process.env.NODE_ENV);
+    }
+  }
+  /**
+   * Enable automatic capture of uncaught exceptions and unhandled rejections
+   */
+  enableAutoCapture() {
+    if (this.autoCapture) return;
+    this.autoCapture = true;
+    process.on("uncaughtException", async (error) => {
+      console.error("5xx: Uncaught exception:", error);
+      await this.captureError(error, {
+        type: "uncaughtException",
+        nodeVersion: process.version,
+        platform: process.platform,
+        pid: process.pid
+      });
+      if (this.exitOnFatalError) {
+        process.exit(1);
+      }
+    });
+    process.on("unhandledRejection", async (reason) => {
+      console.error("5xx: Unhandled rejection:", reason);
+      if (reason instanceof Error) {
+        await this.captureError(reason, {
+          type: "unhandledRejection",
+          nodeVersion: process.version,
+          platform: process.platform,
+          pid: process.pid
+        });
+      } else {
+        await this.captureMessage(String(reason), {
+          type: "unhandledRejection",
+          nodeVersion: process.version,
+          platform: process.platform,
+          pid: process.pid
+        });
+      }
+    });
+  }
+  /**
+   * Wrap an async function to capture errors
+   */
+  wrapAsync(fn, metadata) {
+    return (async (...args) => {
+      try {
+        return await fn(...args);
+      } catch (error) {
+        if (error instanceof Error) {
+          await this.captureError(error, metadata);
+        }
+        throw error;
+      }
+    });
+  }
+};
+
+export {
+  FiveXXNode
+};
+//# sourceMappingURL=chunk-MOWJJPVU.mjs.map

package/dist/chunk-MOWJJPVU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts"],"sourcesContent":["import { FiveXX } from \"./client\";\nimport type { FiveXXOptions } from \"./types\";\n\ninterface NodeOptions extends FiveXXOptions {\n  exitOnFatalError?: boolean;\n}\n\n/**\n * Node.js-specific FiveXX client with automatic error capture\n */\nexport class FiveXXNode extends FiveXX {\n  private autoCapture = false;\n  private exitOnFatalError: boolean;\n\n  constructor(options: NodeOptions) {\n    super(options);\n    this.exitOnFatalError = options.exitOnFatalError ?? true;\n\n    // Auto-detect environment from NODE_ENV\n    if (!options.environment && process.env.NODE_ENV) {\n      this.setEnvironment(process.env.NODE_ENV);\n    }\n  }\n\n  /**\n   * Enable automatic capture of uncaught exceptions and unhandled rejections\n   */\n  enableAutoCapture(): void {\n    if (this.autoCapture) return;\n\n    this.autoCapture = true;\n\n    // Capture uncaught exceptions\n    process.on(\"uncaughtException\", async (error) => {\n      console.error(\"5xx: Uncaught exception:\", error);\n      await this.captureError(error, {\n        type: \"uncaughtException\",\n        nodeVersion: process.version,\n        platform: process.platform,\n        pid: process.pid,\n      });\n\n      if (this.exitOnFatalError) {\n        process.exit(1);\n      }\n    });\n\n    // Capture unhandled promise rejections\n    process.on(\"unhandledRejection\", async (reason) => {\n      console.error(\"5xx: Unhandled rejection:\", reason);\n      if (reason instanceof Error) {\n        await this.captureError(reason, {\n          type: \"unhandledRejection\",\n          nodeVersion: process.version,\n          platform: process.platform,\n          pid: process.pid,\n        });\n      } else {\n        await this.captureMessage(String(reason), {\n          type: \"unhandledRejection\",\n          nodeVersion: process.version,\n          platform: process.platform,\n          pid: process.pid,\n        });\n      }\n    });\n  }\n\n  /**\n   * Wrap an async function to capture errors\n   */\n  wrapAsync<T extends (...args: unknown[]) => Promise<unknown>>(\n    fn: T,\n    metadata?: Record<string, unknown>\n  ): T {\n    return (async (...args: Parameters<T>) => {\n      try {\n        return await fn(...args);\n      } catch (error) {\n        if (error instanceof Error) {\n          await this.captureError(error, metadata);\n        }\n        throw error;\n      }\n    }) as T;\n  }\n}\n"],"mappings":";;;;;AAUO,IAAM,aAAN,cAAyB,OAAO;AAAA,EAIrC,YAAY,SAAsB;AAChC,UAAM,OAAO;AAJf,SAAQ,cAAc;AAKpB,SAAK,mBAAmB,QAAQ,oBAAoB;AAGpD,QAAI,CAAC,QAAQ,eAAe,QAAQ,IAAI,UAAU;AAChD,WAAK,eAAe,QAAQ,IAAI,QAAQ;AAAA,IAC1C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,oBAA0B;AACxB,QAAI,KAAK,YAAa;AAEtB,SAAK,cAAc;AAGnB,YAAQ,GAAG,qBAAqB,OAAO,UAAU;AAC/C,cAAQ,MAAM,4BAA4B,KAAK;AAC/C,YAAM,KAAK,aAAa,OAAO;AAAA,QAC7B,MAAM;AAAA,QACN,aAAa,QAAQ;AAAA,QACrB,UAAU,QAAQ;AAAA,QAClB,KAAK,QAAQ;AAAA,MACf,CAAC;AAED,UAAI,KAAK,kBAAkB;AACzB,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,IACF,CAAC;AAGD,YAAQ,GAAG,sBAAsB,OAAO,WAAW;AACjD,cAAQ,MAAM,6BAA6B,MAAM;AACjD,UAAI,kBAAkB,OAAO;AAC3B,cAAM,KAAK,aAAa,QAAQ;AAAA,UAC9B,MAAM;AAAA,UACN,aAAa,QAAQ;AAAA,UACrB,UAAU,QAAQ;AAAA,UAClB,KAAK,QAAQ;AAAA,QACf,CAAC;AAAA,MACH,OAAO;AACL,cAAM,KAAK,eAAe,OAAO,MAAM,GAAG;AAAA,UACxC,MAAM;AAAA,UACN,aAAa,QAAQ;AAAA,UACrB,UAAU,QAAQ;AAAA,UAClB,KAAK,QAAQ;AAAA,QACf,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,UACE,IACA,UACG;AACH,YAAQ,UAAU,SAAwB;AACxC,UAAI;AACF,eAAO,MAAM,GAAG,GAAG,IAAI;AAAA,MACzB,SAAS,OAAO;AACd,YAAI,iBAAiB,OAAO;AAC1B,gBAAM,KAAK,aAAa,OAAO,QAAQ;AAAA,QACzC;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;","names":[]}