@xrayradar/node 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,92 @@
+import { Scope, ClientOptions, Transport, Level, EventPayload } from '@xrayradar/core';
+
+declare class NodeClient {
+    readonly scope: Scope;
+    readonly options: Required<Pick<ClientOptions, "dsn" | "authToken" | "debug" | "environment" | "release" | "serverName" | "sampleRate" | "maxBreadcrumbs" | "beforeSend">> & {
+        transport: Transport;
+    };
+    private _transport;
+    private _enabled;
+    private _originalUncaughtException;
+    private _originalUnhandledRejection;
+    constructor(options?: ClientOptions);
+    init(options?: ClientOptions): this;
+    captureException(error: Error, options?: {
+        level?: Level;
+        message?: string;
+    }): string | null;
+    captureMessage(message: string, options?: {
+        level?: Level;
+    }): string | null;
+    addBreadcrumb(message: string, options?: {
+        category?: string;
+        level?: Level;
+        data?: Record<string, unknown>;
+        type?: string;
+    }): void;
+    clearBreadcrumbs(): void;
+    setUser(user: {
+        id?: string;
+        username?: string;
+        email?: string;
+        [key: string]: unknown;
+    } | null): void;
+    setTag(key: string, value: string): void;
+    setExtra(key: string, value: unknown): void;
+    setContext(key: string, data: Record<string, unknown>): void;
+    flush(): void;
+    close(): void;
+    private _installGlobalHandlers;
+    private _removeGlobalHandlers;
+}
+declare function init(options?: ClientOptions): NodeClient;
+declare function getClient(): NodeClient | null;
+declare function resetGlobal(): void;
+declare function captureException(error: Error, options?: {
+    level?: Level;
+    message?: string;
+}): string | null;
+declare function captureMessage(message: string, options?: {
+    level?: Level;
+}): string | null;
+declare function addBreadcrumb(message: string, options?: {
+    category?: string;
+    level?: Level;
+    data?: Record<string, unknown>;
+    type?: string;
+}): void;
+declare function setUser(user: {
+    id?: string;
+    username?: string;
+    email?: string;
+    [key: string]: unknown;
+} | null): void;
+declare function setTag(key: string, value: string): void;
+declare function setExtra(key: string, value: unknown): void;
+declare function setContext(key: string, data: Record<string, unknown>): void;
+
+declare class HttpTransport implements Transport {
+    private serverUrl;
+    private projectId;
+    private authToken;
+    private timeout;
+    constructor(dsn: string, options?: {
+        authToken?: string;
+        timeout?: number;
+    });
+    sendEvent(event: EventPayload): Promise<void>;
+    flush(): void;
+    private truncatePayload;
+}
+
+interface DsnParts {
+    serverUrl: string;
+    projectId: string;
+}
+/**
+ * Parse DSN in the form: https://host[:port]/project_id
+ * Same contract as Python SDK and server.
+ */
+declare function parseDsn(dsn: string): DsnParts;
+
+export { type DsnParts, HttpTransport, NodeClient, addBreadcrumb, captureException, captureMessage, getClient, init, parseDsn, resetGlobal, setContext, setExtra, setTag, setUser };

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+import { Scope, ClientOptions, Transport, Level, EventPayload } from '@xrayradar/core';
+
+declare class NodeClient {
+    readonly scope: Scope;
+    readonly options: Required<Pick<ClientOptions, "dsn" | "authToken" | "debug" | "environment" | "release" | "serverName" | "sampleRate" | "maxBreadcrumbs" | "beforeSend">> & {
+        transport: Transport;
+    };
+    private _transport;
+    private _enabled;
+    private _originalUncaughtException;
+    private _originalUnhandledRejection;
+    constructor(options?: ClientOptions);
+    init(options?: ClientOptions): this;
+    captureException(error: Error, options?: {
+        level?: Level;
+        message?: string;
+    }): string | null;
+    captureMessage(message: string, options?: {
+        level?: Level;
+    }): string | null;
+    addBreadcrumb(message: string, options?: {
+        category?: string;
+        level?: Level;
+        data?: Record<string, unknown>;
+        type?: string;
+    }): void;
+    clearBreadcrumbs(): void;
+    setUser(user: {
+        id?: string;
+        username?: string;
+        email?: string;
+        [key: string]: unknown;
+    } | null): void;
+    setTag(key: string, value: string): void;
+    setExtra(key: string, value: unknown): void;
+    setContext(key: string, data: Record<string, unknown>): void;
+    flush(): void;
+    close(): void;
+    private _installGlobalHandlers;
+    private _removeGlobalHandlers;
+}
+declare function init(options?: ClientOptions): NodeClient;
+declare function getClient(): NodeClient | null;
+declare function resetGlobal(): void;
+declare function captureException(error: Error, options?: {
+    level?: Level;
+    message?: string;
+}): string | null;
+declare function captureMessage(message: string, options?: {
+    level?: Level;
+}): string | null;
+declare function addBreadcrumb(message: string, options?: {
+    category?: string;
+    level?: Level;
+    data?: Record<string, unknown>;
+    type?: string;
+}): void;
+declare function setUser(user: {
+    id?: string;
+    username?: string;
+    email?: string;
+    [key: string]: unknown;
+} | null): void;
+declare function setTag(key: string, value: string): void;
+declare function setExtra(key: string, value: unknown): void;
+declare function setContext(key: string, data: Record<string, unknown>): void;
+
+declare class HttpTransport implements Transport {
+    private serverUrl;
+    private projectId;
+    private authToken;
+    private timeout;
+    constructor(dsn: string, options?: {
+        authToken?: string;
+        timeout?: number;
+    });
+    sendEvent(event: EventPayload): Promise<void>;
+    flush(): void;
+    private truncatePayload;
+}
+
+interface DsnParts {
+    serverUrl: string;
+    projectId: string;
+}
+/**
+ * Parse DSN in the form: https://host[:port]/project_id
+ * Same contract as Python SDK and server.
+ */
+declare function parseDsn(dsn: string): DsnParts;
+
+export { type DsnParts, HttpTransport, NodeClient, addBreadcrumb, captureException, captureMessage, getClient, init, parseDsn, resetGlobal, setContext, setExtra, setTag, setUser };

package/dist/index.js

@@ -0,0 +1,355 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  HttpTransport: () => HttpTransport,
+  NodeClient: () => NodeClient,
+  addBreadcrumb: () => addBreadcrumb,
+  captureException: () => captureException,
+  captureMessage: () => captureMessage,
+  getClient: () => getClient,
+  init: () => init,
+  parseDsn: () => parseDsn,
+  resetGlobal: () => resetGlobal,
+  setContext: () => setContext,
+  setExtra: () => setExtra,
+  setTag: () => setTag,
+  setUser: () => setUser
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_core2 = require("@xrayradar/core");
+
+// src/transport.ts
+var import_core = require("@xrayradar/core");
+
+// src/dsn.ts
+function parseDsn(dsn) {
+  let url;
+  try {
+    url = new URL(dsn);
+  } catch {
+    throw new Error(
+      `Invalid DSN format. Expected: https://xrayradar.com/your_project_id`
+    );
+  }
+  if (!url.protocol || !url.host) {
+    throw new Error(
+      `Invalid DSN format. Expected: https://xrayradar.com/your_project_id`
+    );
+  }
+  const pathParts = url.pathname.replace(/^\/+|\/+$/g, "").split("/");
+  const projectId = pathParts[pathParts.length - 1];
+  if (!projectId) {
+    throw new Error(
+      `Missing project ID in DSN. Expected: https://xrayradar.com/your_project_id`
+    );
+  }
+  const serverUrl = `${url.protocol}//${url.host}`;
+  return { serverUrl, projectId };
+}
+
+// src/transport.ts
+var MAX_PAYLOAD_SIZE = 100 * 1024;
+var HttpTransport = class {
+  constructor(dsn, options) {
+    const { serverUrl, projectId } = parseDsn(dsn);
+    this.serverUrl = serverUrl;
+    this.projectId = projectId;
+    this.authToken = options?.authToken ?? process.env["XRAYRADAR_AUTH_TOKEN"] ?? "";
+    this.timeout = options?.timeout ?? 1e4;
+  }
+  async sendEvent(event) {
+    const payload = JSON.stringify(event);
+    if (Buffer.byteLength(payload, "utf8") > MAX_PAYLOAD_SIZE) {
+      event = this.truncatePayload(event);
+    }
+    const url = `${this.serverUrl}/api/${this.projectId}/store/`;
+    const headers = {
+      "Content-Type": "application/json",
+      "User-Agent": `xrayradar/${(0, import_core.getSdkInfo)().version}`
+    };
+    if (this.authToken) {
+      headers["X-Xrayradar-Token"] = this.authToken;
+    }
+    const res = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(event),
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (res.status === 429) {
+      const retryAfter = res.headers.get("Retry-After") ?? "60";
+      throw new Error(
+        `Rate limited by XrayRadar server. Retry after ${retryAfter} seconds.`
+      );
+    }
+    if (!res.ok) {
+      const text = await res.text();
+      const detail = text.slice(0, 200);
+      throw new Error(
+        `Failed to send event to XrayRadar: HTTP ${res.status}${detail ? ` - ${detail}` : ""}`
+      );
+    }
+  }
+  flush() {
+  }
+  truncatePayload(event) {
+    const out = { ...event };
+    if (out.message && out.message.length > 1e3) {
+      out.message = out.message.slice(0, 997) + "...";
+    }
+    if (out.breadcrumbs && out.breadcrumbs.length > 100) {
+      out.breadcrumbs = out.breadcrumbs.slice(-100);
+    }
+    if (out.exception?.values) {
+      for (const v of out.exception.values) {
+        if (v.stacktrace?.frames && v.stacktrace.frames.length > 50) {
+          v.stacktrace.frames = v.stacktrace.frames.slice(0, 50);
+        }
+      }
+    }
+    return out;
+  }
+};
+
+// src/client.ts
+var globalClient = null;
+var NodeClient = class {
+  constructor(options = {}) {
+    this._originalUncaughtException = null;
+    this._originalUnhandledRejection = null;
+    this.scope = new import_core2.Scope();
+    this.scope.maxBreadcrumbs = options.maxBreadcrumbs ?? 100;
+    this._enabled = Boolean(options.dsn || options.transport || options.debug);
+    this._transport = options.transport ?? (options.dsn ? new HttpTransport(options.dsn, { authToken: options.authToken }) : { sendEvent: () => {
+    } });
+    this.options = {
+      dsn: options.dsn ?? "",
+      authToken: options.authToken ?? "",
+      debug: options.debug ?? false,
+      environment: options.environment ?? process.env["XRAYRADAR_ENVIRONMENT"] ?? "development",
+      release: options.release ?? process.env["XRAYRADAR_RELEASE"] ?? "",
+      serverName: options.serverName ?? process.env["XRAYRADAR_SERVER_NAME"] ?? "",
+      sampleRate: Math.max(0, Math.min(1, options.sampleRate ?? 1)),
+      maxBreadcrumbs: options.maxBreadcrumbs ?? 100,
+      beforeSend: options.beforeSend ?? ((e) => e),
+      transport: this._transport
+    };
+    this.scope.applyToContext({
+      environment: this.options.environment,
+      release: this.options.release,
+      server_name: this.options.serverName || void 0
+    });
+    if (this._enabled && this.options.dsn && !options.transport) {
+      this._installGlobalHandlers();
+    }
+  }
+  init(options) {
+    if (options?.dsn) this.options.dsn = options.dsn;
+    if (options?.authToken !== void 0) this.options.authToken = options.authToken;
+    if (options?.environment !== void 0) {
+      this.options.environment = options.environment;
+      this.scope.applyToContext({ environment: options.environment });
+    }
+    if (options?.release !== void 0) {
+      this.options.release = options.release;
+      this.scope.applyToContext({ release: options.release });
+    }
+    if (options?.serverName !== void 0) {
+      this.options.serverName = options.serverName;
+      this.scope.applyToContext({ server_name: options.serverName });
+    }
+    if (options?.sampleRate !== void 0) this.options.sampleRate = Math.max(0, Math.min(1, options.sampleRate));
+    if (options?.maxBreadcrumbs !== void 0) {
+      this.options.maxBreadcrumbs = options.maxBreadcrumbs;
+      this.scope.maxBreadcrumbs = options.maxBreadcrumbs;
+    }
+    if (options?.beforeSend !== void 0) this.options.beforeSend = options.beforeSend;
+    return this;
+  }
+  captureException(error, options) {
+    if (!this._enabled) return null;
+    if (!(0, import_core2.shouldSample)(this.options.sampleRate)) return null;
+    const level = options?.level ?? "error";
+    let payload = (0, import_core2.eventFromException)(
+      error,
+      level,
+      options?.message,
+      this.scope
+    );
+    const after = this.options.beforeSend(payload);
+    if (after === null) return null;
+    const applyAndSend = (resolved) => {
+      if (this.options.debug) console.warn("[XrayRadar]", resolved);
+      const p2 = this._transport.sendEvent(resolved);
+      if (p2 && typeof p2.catch === "function") {
+        p2.catch(() => {
+        });
+      }
+    };
+    if (after instanceof Promise) {
+      after.then((res) => res !== null && applyAndSend(res));
+      return null;
+    }
+    payload = after;
+    if (this.options.debug) console.warn("[XrayRadar]", payload);
+    const p = this._transport.sendEvent(payload);
+    if (p && typeof p.catch === "function") {
+      p.catch(() => {
+      });
+    }
+    return payload.event_id;
+  }
+  captureMessage(message, options) {
+    if (!this._enabled) return null;
+    if (!(0, import_core2.shouldSample)(this.options.sampleRate)) return null;
+    const level = (0, import_core2.normalizeLevel)(options?.level ?? "error");
+    let payload = (0, import_core2.eventFromMessage)(message, level, this.scope);
+    const after = this.options.beforeSend(payload);
+    if (after === null) return null;
+    const applyAndSend = (resolved) => {
+      if (this.options.debug) console.warn("[XrayRadar]", resolved);
+      const p2 = this._transport.sendEvent(resolved);
+      if (p2 && typeof p2.catch === "function") {
+        p2.catch(() => {
+        });
+      }
+    };
+    if (after instanceof Promise) {
+      after.then((res) => res !== null && applyAndSend(res));
+      return null;
+    }
+    payload = after;
+    if (this.options.debug) console.warn("[XrayRadar]", payload);
+    const p = this._transport.sendEvent(payload);
+    if (p && typeof p.catch === "function") {
+      p.catch(() => {
+      });
+    }
+    return payload.event_id;
+  }
+  addBreadcrumb(message, options) {
+    if (!this._enabled) return;
+    this.scope.addBreadcrumb(message, options);
+  }
+  clearBreadcrumbs() {
+    this.scope.clearBreadcrumbs();
+  }
+  setUser(user) {
+    if (!this._enabled) return;
+    this.scope.setUser(user);
+  }
+  setTag(key, value) {
+    if (!this._enabled) return;
+    this.scope.setTag(key, value);
+  }
+  setExtra(key, value) {
+    if (!this._enabled) return;
+    this.scope.setExtra(key, value);
+  }
+  setContext(key, data) {
+    if (!this._enabled) return;
+    this.scope.setContext(key, data);
+  }
+  flush() {
+    if (this._transport.flush) this._transport.flush();
+  }
+  close() {
+    this.flush();
+    if (this._transport.close) this._transport.close();
+    this._removeGlobalHandlers();
+  }
+  _installGlobalHandlers() {
+    this._originalUncaughtException = process.listeners("uncaughtException").pop() ?? null;
+    this._originalUnhandledRejection = process.listeners("unhandledRejection").pop() ?? null;
+    process.on("uncaughtException", (err, origin) => {
+      this.captureException(err);
+      if (this._originalUncaughtException) this._originalUncaughtException(err, origin);
+      else process.exit(1);
+    });
+    process.on("unhandledRejection", (reason, promise) => {
+      const err = reason instanceof Error ? reason : new Error(String(reason));
+      this.captureException(err);
+      if (this._originalUnhandledRejection) this._originalUnhandledRejection(reason, promise);
+    });
+  }
+  _removeGlobalHandlers() {
+    process.removeAllListeners("uncaughtException");
+    process.removeAllListeners("unhandledRejection");
+    if (this._originalUncaughtException) process.on("uncaughtException", this._originalUncaughtException);
+    if (this._originalUnhandledRejection) process.on("unhandledRejection", this._originalUnhandledRejection);
+  }
+};
+function init(options) {
+  const client = new NodeClient(options);
+  globalClient = client;
+  return client;
+}
+function getClient() {
+  return globalClient;
+}
+function resetGlobal() {
+  if (globalClient) {
+    globalClient.close();
+    globalClient = null;
+  }
+}
+function captureException(error, options) {
+  const client = getClient();
+  return client ? client.captureException(error, options) : null;
+}
+function captureMessage(message, options) {
+  const client = getClient();
+  return client ? client.captureMessage(message, options) : null;
+}
+function addBreadcrumb(message, options) {
+  getClient()?.addBreadcrumb(message, options);
+}
+function setUser(user) {
+  getClient()?.setUser(user);
+}
+function setTag(key, value) {
+  getClient()?.setTag(key, value);
+}
+function setExtra(key, value) {
+  getClient()?.setExtra(key, value);
+}
+function setContext(key, data) {
+  getClient()?.setContext(key, data);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HttpTransport,
+  NodeClient,
+  addBreadcrumb,
+  captureException,
+  captureMessage,
+  getClient,
+  init,
+  parseDsn,
+  resetGlobal,
+  setContext,
+  setExtra,
+  setTag,
+  setUser
+});

package/dist/index.mjs

@@ -0,0 +1,322 @@
+// src/client.ts
+import {
+  Scope,
+  eventFromException,
+  eventFromMessage,
+  shouldSample,
+  normalizeLevel
+} from "@xrayradar/core";
+
+// src/transport.ts
+import { getSdkInfo } from "@xrayradar/core";
+
+// src/dsn.ts
+function parseDsn(dsn) {
+  let url;
+  try {
+    url = new URL(dsn);
+  } catch {
+    throw new Error(
+      `Invalid DSN format. Expected: https://xrayradar.com/your_project_id`
+    );
+  }
+  if (!url.protocol || !url.host) {
+    throw new Error(
+      `Invalid DSN format. Expected: https://xrayradar.com/your_project_id`
+    );
+  }
+  const pathParts = url.pathname.replace(/^\/+|\/+$/g, "").split("/");
+  const projectId = pathParts[pathParts.length - 1];
+  if (!projectId) {
+    throw new Error(
+      `Missing project ID in DSN. Expected: https://xrayradar.com/your_project_id`
+    );
+  }
+  const serverUrl = `${url.protocol}//${url.host}`;
+  return { serverUrl, projectId };
+}
+
+// src/transport.ts
+var MAX_PAYLOAD_SIZE = 100 * 1024;
+var HttpTransport = class {
+  constructor(dsn, options) {
+    const { serverUrl, projectId } = parseDsn(dsn);
+    this.serverUrl = serverUrl;
+    this.projectId = projectId;
+    this.authToken = options?.authToken ?? process.env["XRAYRADAR_AUTH_TOKEN"] ?? "";
+    this.timeout = options?.timeout ?? 1e4;
+  }
+  async sendEvent(event) {
+    const payload = JSON.stringify(event);
+    if (Buffer.byteLength(payload, "utf8") > MAX_PAYLOAD_SIZE) {
+      event = this.truncatePayload(event);
+    }
+    const url = `${this.serverUrl}/api/${this.projectId}/store/`;
+    const headers = {
+      "Content-Type": "application/json",
+      "User-Agent": `xrayradar/${getSdkInfo().version}`
+    };
+    if (this.authToken) {
+      headers["X-Xrayradar-Token"] = this.authToken;
+    }
+    const res = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(event),
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (res.status === 429) {
+      const retryAfter = res.headers.get("Retry-After") ?? "60";
+      throw new Error(
+        `Rate limited by XrayRadar server. Retry after ${retryAfter} seconds.`
+      );
+    }
+    if (!res.ok) {
+      const text = await res.text();
+      const detail = text.slice(0, 200);
+      throw new Error(
+        `Failed to send event to XrayRadar: HTTP ${res.status}${detail ? ` - ${detail}` : ""}`
+      );
+    }
+  }
+  flush() {
+  }
+  truncatePayload(event) {
+    const out = { ...event };
+    if (out.message && out.message.length > 1e3) {
+      out.message = out.message.slice(0, 997) + "...";
+    }
+    if (out.breadcrumbs && out.breadcrumbs.length > 100) {
+      out.breadcrumbs = out.breadcrumbs.slice(-100);
+    }
+    if (out.exception?.values) {
+      for (const v of out.exception.values) {
+        if (v.stacktrace?.frames && v.stacktrace.frames.length > 50) {
+          v.stacktrace.frames = v.stacktrace.frames.slice(0, 50);
+        }
+      }
+    }
+    return out;
+  }
+};
+
+// src/client.ts
+var globalClient = null;
+var NodeClient = class {
+  constructor(options = {}) {
+    this._originalUncaughtException = null;
+    this._originalUnhandledRejection = null;
+    this.scope = new Scope();
+    this.scope.maxBreadcrumbs = options.maxBreadcrumbs ?? 100;
+    this._enabled = Boolean(options.dsn || options.transport || options.debug);
+    this._transport = options.transport ?? (options.dsn ? new HttpTransport(options.dsn, { authToken: options.authToken }) : { sendEvent: () => {
+    } });
+    this.options = {
+      dsn: options.dsn ?? "",
+      authToken: options.authToken ?? "",
+      debug: options.debug ?? false,
+      environment: options.environment ?? process.env["XRAYRADAR_ENVIRONMENT"] ?? "development",
+      release: options.release ?? process.env["XRAYRADAR_RELEASE"] ?? "",
+      serverName: options.serverName ?? process.env["XRAYRADAR_SERVER_NAME"] ?? "",
+      sampleRate: Math.max(0, Math.min(1, options.sampleRate ?? 1)),
+      maxBreadcrumbs: options.maxBreadcrumbs ?? 100,
+      beforeSend: options.beforeSend ?? ((e) => e),
+      transport: this._transport
+    };
+    this.scope.applyToContext({
+      environment: this.options.environment,
+      release: this.options.release,
+      server_name: this.options.serverName || void 0
+    });
+    if (this._enabled && this.options.dsn && !options.transport) {
+      this._installGlobalHandlers();
+    }
+  }
+  init(options) {
+    if (options?.dsn) this.options.dsn = options.dsn;
+    if (options?.authToken !== void 0) this.options.authToken = options.authToken;
+    if (options?.environment !== void 0) {
+      this.options.environment = options.environment;
+      this.scope.applyToContext({ environment: options.environment });
+    }
+    if (options?.release !== void 0) {
+      this.options.release = options.release;
+      this.scope.applyToContext({ release: options.release });
+    }
+    if (options?.serverName !== void 0) {
+      this.options.serverName = options.serverName;
+      this.scope.applyToContext({ server_name: options.serverName });
+    }
+    if (options?.sampleRate !== void 0) this.options.sampleRate = Math.max(0, Math.min(1, options.sampleRate));
+    if (options?.maxBreadcrumbs !== void 0) {
+      this.options.maxBreadcrumbs = options.maxBreadcrumbs;
+      this.scope.maxBreadcrumbs = options.maxBreadcrumbs;
+    }
+    if (options?.beforeSend !== void 0) this.options.beforeSend = options.beforeSend;
+    return this;
+  }
+  captureException(error, options) {
+    if (!this._enabled) return null;
+    if (!shouldSample(this.options.sampleRate)) return null;
+    const level = options?.level ?? "error";
+    let payload = eventFromException(
+      error,
+      level,
+      options?.message,
+      this.scope
+    );
+    const after = this.options.beforeSend(payload);
+    if (after === null) return null;
+    const applyAndSend = (resolved) => {
+      if (this.options.debug) console.warn("[XrayRadar]", resolved);
+      const p2 = this._transport.sendEvent(resolved);
+      if (p2 && typeof p2.catch === "function") {
+        p2.catch(() => {
+        });
+      }
+    };
+    if (after instanceof Promise) {
+      after.then((res) => res !== null && applyAndSend(res));
+      return null;
+    }
+    payload = after;
+    if (this.options.debug) console.warn("[XrayRadar]", payload);
+    const p = this._transport.sendEvent(payload);
+    if (p && typeof p.catch === "function") {
+      p.catch(() => {
+      });
+    }
+    return payload.event_id;
+  }
+  captureMessage(message, options) {
+    if (!this._enabled) return null;
+    if (!shouldSample(this.options.sampleRate)) return null;
+    const level = normalizeLevel(options?.level ?? "error");
+    let payload = eventFromMessage(message, level, this.scope);
+    const after = this.options.beforeSend(payload);
+    if (after === null) return null;
+    const applyAndSend = (resolved) => {
+      if (this.options.debug) console.warn("[XrayRadar]", resolved);
+      const p2 = this._transport.sendEvent(resolved);
+      if (p2 && typeof p2.catch === "function") {
+        p2.catch(() => {
+        });
+      }
+    };
+    if (after instanceof Promise) {
+      after.then((res) => res !== null && applyAndSend(res));
+      return null;
+    }
+    payload = after;
+    if (this.options.debug) console.warn("[XrayRadar]", payload);
+    const p = this._transport.sendEvent(payload);
+    if (p && typeof p.catch === "function") {
+      p.catch(() => {
+      });
+    }
+    return payload.event_id;
+  }
+  addBreadcrumb(message, options) {
+    if (!this._enabled) return;
+    this.scope.addBreadcrumb(message, options);
+  }
+  clearBreadcrumbs() {
+    this.scope.clearBreadcrumbs();
+  }
+  setUser(user) {
+    if (!this._enabled) return;
+    this.scope.setUser(user);
+  }
+  setTag(key, value) {
+    if (!this._enabled) return;
+    this.scope.setTag(key, value);
+  }
+  setExtra(key, value) {
+    if (!this._enabled) return;
+    this.scope.setExtra(key, value);
+  }
+  setContext(key, data) {
+    if (!this._enabled) return;
+    this.scope.setContext(key, data);
+  }
+  flush() {
+    if (this._transport.flush) this._transport.flush();
+  }
+  close() {
+    this.flush();
+    if (this._transport.close) this._transport.close();
+    this._removeGlobalHandlers();
+  }
+  _installGlobalHandlers() {
+    this._originalUncaughtException = process.listeners("uncaughtException").pop() ?? null;
+    this._originalUnhandledRejection = process.listeners("unhandledRejection").pop() ?? null;
+    process.on("uncaughtException", (err, origin) => {
+      this.captureException(err);
+      if (this._originalUncaughtException) this._originalUncaughtException(err, origin);
+      else process.exit(1);
+    });
+    process.on("unhandledRejection", (reason, promise) => {
+      const err = reason instanceof Error ? reason : new Error(String(reason));
+      this.captureException(err);
+      if (this._originalUnhandledRejection) this._originalUnhandledRejection(reason, promise);
+    });
+  }
+  _removeGlobalHandlers() {
+    process.removeAllListeners("uncaughtException");
+    process.removeAllListeners("unhandledRejection");
+    if (this._originalUncaughtException) process.on("uncaughtException", this._originalUncaughtException);
+    if (this._originalUnhandledRejection) process.on("unhandledRejection", this._originalUnhandledRejection);
+  }
+};
+function init(options) {
+  const client = new NodeClient(options);
+  globalClient = client;
+  return client;
+}
+function getClient() {
+  return globalClient;
+}
+function resetGlobal() {
+  if (globalClient) {
+    globalClient.close();
+    globalClient = null;
+  }
+}
+function captureException(error, options) {
+  const client = getClient();
+  return client ? client.captureException(error, options) : null;
+}
+function captureMessage(message, options) {
+  const client = getClient();
+  return client ? client.captureMessage(message, options) : null;
+}
+function addBreadcrumb(message, options) {
+  getClient()?.addBreadcrumb(message, options);
+}
+function setUser(user) {
+  getClient()?.setUser(user);
+}
+function setTag(key, value) {
+  getClient()?.setTag(key, value);
+}
+function setExtra(key, value) {
+  getClient()?.setExtra(key, value);
+}
+function setContext(key, data) {
+  getClient()?.setContext(key, data);
+}
+export {
+  HttpTransport,
+  NodeClient,
+  addBreadcrumb,
+  captureException,
+  captureMessage,
+  getClient,
+  init,
+  parseDsn,
+  resetGlobal,
+  setContext,
+  setExtra,
+  setTag,
+  setUser
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@xrayradar/node",
+  "version": "0.1.0",
+  "description": "XrayRadar SDK for Node.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@xrayradar/core": "*"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.0",
+    "@types/node": "^20.10.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}