@builderai/sentinel-browser 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,57 @@
+interface SentinelConfig {
+    dsn: string;
+    environment?: string;
+    release?: string;
+    debug?: boolean;
+    sampleRate?: number;
+    maxBreadcrumbs?: number;
+}
+interface SentinelEvent {
+    dsn: string;
+    events: ErrorEventPayload[];
+}
+interface ErrorEventPayload {
+    title: string;
+    location?: string;
+    type?: 'Error' | 'Exception' | 'Performance' | 'Security';
+    severity?: 'critical' | 'error' | 'warning' | 'info';
+    stackTrace?: string;
+    tags?: Record<string, string>;
+    breadcrumbs?: Breadcrumb[];
+    usersAffected?: number;
+    fingerprint?: string;
+}
+interface Breadcrumb {
+    timestamp: string;
+    category: string;
+    message: string;
+    level: string;
+    data?: any;
+}
+declare class Sentinel {
+    private static instance;
+    private config;
+    private breadcrumbs;
+    private user;
+    private tags;
+    private initialized;
+    private constructor();
+    static getInstance(): Sentinel;
+    init(config: SentinelConfig): void;
+    setUser(user: any): void;
+    setTag(key: string, value: string): void;
+    addBreadcrumb(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void;
+    captureException(error: Error | string, context?: any): void;
+    captureMessage(message: string, level?: 'info' | 'warning' | 'error' | 'critical'): void;
+    private sendEvent;
+    private setupGlobalHandlers;
+    private setupBreadcrumbs;
+}
+declare const sentinel: Sentinel;
+declare const init: (config: SentinelConfig) => void;
+declare const captureException: (error: Error | string, context?: any) => void;
+declare const captureMessage: (msg: string, level?: any) => void;
+declare const setUser: (user: any) => void;
+declare const setTag: (key: string, value: string) => void;
+
+export { type Breadcrumb, type ErrorEventPayload, Sentinel, type SentinelConfig, type SentinelEvent, captureException, captureMessage, init, sentinel, setTag, setUser };

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+interface SentinelConfig {
+    dsn: string;
+    environment?: string;
+    release?: string;
+    debug?: boolean;
+    sampleRate?: number;
+    maxBreadcrumbs?: number;
+}
+interface SentinelEvent {
+    dsn: string;
+    events: ErrorEventPayload[];
+}
+interface ErrorEventPayload {
+    title: string;
+    location?: string;
+    type?: 'Error' | 'Exception' | 'Performance' | 'Security';
+    severity?: 'critical' | 'error' | 'warning' | 'info';
+    stackTrace?: string;
+    tags?: Record<string, string>;
+    breadcrumbs?: Breadcrumb[];
+    usersAffected?: number;
+    fingerprint?: string;
+}
+interface Breadcrumb {
+    timestamp: string;
+    category: string;
+    message: string;
+    level: string;
+    data?: any;
+}
+declare class Sentinel {
+    private static instance;
+    private config;
+    private breadcrumbs;
+    private user;
+    private tags;
+    private initialized;
+    private constructor();
+    static getInstance(): Sentinel;
+    init(config: SentinelConfig): void;
+    setUser(user: any): void;
+    setTag(key: string, value: string): void;
+    addBreadcrumb(breadcrumb: Omit<Breadcrumb, 'timestamp'>): void;
+    captureException(error: Error | string, context?: any): void;
+    captureMessage(message: string, level?: 'info' | 'warning' | 'error' | 'critical'): void;
+    private sendEvent;
+    private setupGlobalHandlers;
+    private setupBreadcrumbs;
+}
+declare const sentinel: Sentinel;
+declare const init: (config: SentinelConfig) => void;
+declare const captureException: (error: Error | string, context?: any) => void;
+declare const captureMessage: (msg: string, level?: any) => void;
+declare const setUser: (user: any) => void;
+declare const setTag: (key: string, value: string) => void;
+
+export { type Breadcrumb, type ErrorEventPayload, Sentinel, type SentinelConfig, type SentinelEvent, captureException, captureMessage, init, sentinel, setTag, setUser };

package/dist/index.js

@@ -0,0 +1,227 @@
+"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, {
+  Sentinel: () => Sentinel,
+  captureException: () => captureException,
+  captureMessage: () => captureMessage,
+  init: () => init,
+  sentinel: () => sentinel,
+  setTag: () => setTag,
+  setUser: () => setUser
+});
+module.exports = __toCommonJS(index_exports);
+var Sentinel = class _Sentinel {
+  constructor() {
+    this.config = {
+      dsn: "",
+      environment: "production",
+      maxBreadcrumbs: 20
+    };
+    this.breadcrumbs = [];
+    this.user = {};
+    this.tags = {};
+    this.initialized = false;
+  }
+  static getInstance() {
+    if (!_Sentinel.instance) {
+      _Sentinel.instance = new _Sentinel();
+    }
+    return _Sentinel.instance;
+  }
+  init(config) {
+    if (this.initialized) {
+      console.warn("[Sentinel] Already initialized");
+      return;
+    }
+    this.config = { ...this.config, ...config };
+    this.initialized = true;
+    if (this.config.debug) {
+      console.log("[Sentinel] Initialized with DSN:", this.config.dsn);
+    }
+    this.setupGlobalHandlers();
+    this.setupBreadcrumbs();
+  }
+  setUser(user) {
+    this.user = user;
+  }
+  setTag(key, value) {
+    this.tags[key] = value;
+  }
+  addBreadcrumb(breadcrumb) {
+    const crumb = {
+      ...breadcrumb,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.breadcrumbs.push(crumb);
+    if (this.breadcrumbs.length > (this.config.maxBreadcrumbs || 20)) {
+      this.breadcrumbs.shift();
+    }
+  }
+  captureException(error, context) {
+    const stackTrace = error instanceof Error ? error.stack : "No stack trace available";
+    const title = error instanceof Error ? error.message : String(error);
+    const type = error instanceof Error ? error.name : "Error";
+    this.sendEvent({
+      title,
+      location: window.location.href,
+      // Simplified location
+      type: "Exception",
+      severity: "error",
+      stackTrace,
+      tags: { ...this.tags, ...context?.tags },
+      breadcrumbs: [...this.breadcrumbs],
+      usersAffected: 1
+      // Client side always 1 user context usually
+    });
+  }
+  captureMessage(message, level = "info") {
+    this.sendEvent({
+      title: message,
+      location: window.location.href,
+      type: "Error",
+      severity: level,
+      stackTrace: new Error().stack,
+      // Capture stack for context
+      tags: this.tags,
+      breadcrumbs: [...this.breadcrumbs]
+    });
+  }
+  sendEvent(payload) {
+    if (!this.initialized || !this.config.dsn) return;
+    if (this.config.environment) payload.tags = { ...payload.tags, environment: this.config.environment };
+    if (this.config.release) payload.tags = { ...payload.tags, release: this.config.release };
+    if (this.user.id) payload.tags = { ...payload.tags, userId: this.user.id };
+    const envelope = {
+      dsn: this.config.dsn,
+      events: [payload]
+    };
+    if (this.config.debug) {
+      console.log("[Sentinel] Sending event:", envelope);
+    }
+    let endpoint = "/api/ingest/events";
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5e3);
+    let ingestUrl = window.SENTINEL_API_URL || "http://localhost:3001/api/ingest/events";
+    if (window.location.hostname === "localhost") {
+      ingestUrl = "/api/ingest/events";
+    }
+    fetch(ingestUrl, {
+      method: "POST",
+      body: JSON.stringify(envelope),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      keepalive: true,
+      signal: controller.signal
+    }).catch((err) => {
+      if (this.config.debug) console.error("[Sentinel] Failed to send event:", err);
+    }).finally(() => clearTimeout(timeoutId));
+  }
+  setupGlobalHandlers() {
+    const self = this;
+    const oldOnError = window.onerror;
+    window.onerror = function(msg, url, line, col, error) {
+      self.captureException(error || String(msg));
+      if (oldOnError) return oldOnError.apply(this, arguments);
+    };
+    window.onunhandledrejection = function(e) {
+      self.captureException(e.reason || "Unhandled Promise Rejection");
+    };
+  }
+  setupBreadcrumbs() {
+    const self = this;
+    document.addEventListener("click", (e) => {
+      let target = e.target;
+      while (target && target !== document.body && !target.id && !target.className) {
+        target = target.parentElement;
+      }
+      if (!target) return;
+      const safeSummary = (target.id ? "#" + target.id : "") + (target.className ? "." + target.className.split(" ").join(".") : "") || target.tagName;
+      self.addBreadcrumb({
+        category: "ui.click",
+        message: safeSummary,
+        level: "info"
+      });
+    }, true);
+    const levels = ["log", "info", "warn", "error", "debug"];
+    levels.forEach((level) => {
+      const original = console[level];
+      console[level] = function(...args) {
+        self.addBreadcrumb({
+          category: "console",
+          message: args.map((a) => String(a)).join(" "),
+          level: level === "error" ? "error" : level === "warn" ? "warning" : "info"
+        });
+        original.apply(console, args);
+      };
+    });
+    const originalFetch = window.fetch;
+    window.fetch = async function(...args) {
+      const [resource, config] = args;
+      const method = (config?.method || "GET").toUpperCase();
+      const url = String(resource);
+      self.addBreadcrumb({
+        category: "http",
+        message: `${method} ${url}`,
+        level: "info",
+        data: {
+          method,
+          url
+        }
+      });
+      try {
+        const response = await originalFetch.apply(this, args);
+        self.addBreadcrumb({
+          category: "http.response",
+          message: `${method} ${url} [${response.status}]`,
+          level: response.status >= 400 ? "error" : "info",
+          data: { status: response.status }
+        });
+        return response;
+      } catch (err) {
+        self.addBreadcrumb({
+          category: "http.error",
+          message: `${method} ${url} FAILED`,
+          level: "error",
+          data: { error: String(err) }
+        });
+        throw err;
+      }
+    };
+  }
+};
+var sentinel = Sentinel.getInstance();
+var init = (config) => sentinel.init(config);
+var captureException = (error, context) => sentinel.captureException(error, context);
+var captureMessage = (msg, level) => sentinel.captureMessage(msg, level);
+var setUser = (user) => sentinel.setUser(user);
+var setTag = (key, value) => sentinel.setTag(key, value);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Sentinel,
+  captureException,
+  captureMessage,
+  init,
+  sentinel,
+  setTag,
+  setUser
+});

package/dist/index.mjs

@@ -0,0 +1,196 @@
+// src/index.ts
+var Sentinel = class _Sentinel {
+  constructor() {
+    this.config = {
+      dsn: "",
+      environment: "production",
+      maxBreadcrumbs: 20
+    };
+    this.breadcrumbs = [];
+    this.user = {};
+    this.tags = {};
+    this.initialized = false;
+  }
+  static getInstance() {
+    if (!_Sentinel.instance) {
+      _Sentinel.instance = new _Sentinel();
+    }
+    return _Sentinel.instance;
+  }
+  init(config) {
+    if (this.initialized) {
+      console.warn("[Sentinel] Already initialized");
+      return;
+    }
+    this.config = { ...this.config, ...config };
+    this.initialized = true;
+    if (this.config.debug) {
+      console.log("[Sentinel] Initialized with DSN:", this.config.dsn);
+    }
+    this.setupGlobalHandlers();
+    this.setupBreadcrumbs();
+  }
+  setUser(user) {
+    this.user = user;
+  }
+  setTag(key, value) {
+    this.tags[key] = value;
+  }
+  addBreadcrumb(breadcrumb) {
+    const crumb = {
+      ...breadcrumb,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.breadcrumbs.push(crumb);
+    if (this.breadcrumbs.length > (this.config.maxBreadcrumbs || 20)) {
+      this.breadcrumbs.shift();
+    }
+  }
+  captureException(error, context) {
+    const stackTrace = error instanceof Error ? error.stack : "No stack trace available";
+    const title = error instanceof Error ? error.message : String(error);
+    const type = error instanceof Error ? error.name : "Error";
+    this.sendEvent({
+      title,
+      location: window.location.href,
+      // Simplified location
+      type: "Exception",
+      severity: "error",
+      stackTrace,
+      tags: { ...this.tags, ...context?.tags },
+      breadcrumbs: [...this.breadcrumbs],
+      usersAffected: 1
+      // Client side always 1 user context usually
+    });
+  }
+  captureMessage(message, level = "info") {
+    this.sendEvent({
+      title: message,
+      location: window.location.href,
+      type: "Error",
+      severity: level,
+      stackTrace: new Error().stack,
+      // Capture stack for context
+      tags: this.tags,
+      breadcrumbs: [...this.breadcrumbs]
+    });
+  }
+  sendEvent(payload) {
+    if (!this.initialized || !this.config.dsn) return;
+    if (this.config.environment) payload.tags = { ...payload.tags, environment: this.config.environment };
+    if (this.config.release) payload.tags = { ...payload.tags, release: this.config.release };
+    if (this.user.id) payload.tags = { ...payload.tags, userId: this.user.id };
+    const envelope = {
+      dsn: this.config.dsn,
+      events: [payload]
+    };
+    if (this.config.debug) {
+      console.log("[Sentinel] Sending event:", envelope);
+    }
+    let endpoint = "/api/ingest/events";
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5e3);
+    let ingestUrl = window.SENTINEL_API_URL || "http://localhost:3001/api/ingest/events";
+    if (window.location.hostname === "localhost") {
+      ingestUrl = "/api/ingest/events";
+    }
+    fetch(ingestUrl, {
+      method: "POST",
+      body: JSON.stringify(envelope),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      keepalive: true,
+      signal: controller.signal
+    }).catch((err) => {
+      if (this.config.debug) console.error("[Sentinel] Failed to send event:", err);
+    }).finally(() => clearTimeout(timeoutId));
+  }
+  setupGlobalHandlers() {
+    const self = this;
+    const oldOnError = window.onerror;
+    window.onerror = function(msg, url, line, col, error) {
+      self.captureException(error || String(msg));
+      if (oldOnError) return oldOnError.apply(this, arguments);
+    };
+    window.onunhandledrejection = function(e) {
+      self.captureException(e.reason || "Unhandled Promise Rejection");
+    };
+  }
+  setupBreadcrumbs() {
+    const self = this;
+    document.addEventListener("click", (e) => {
+      let target = e.target;
+      while (target && target !== document.body && !target.id && !target.className) {
+        target = target.parentElement;
+      }
+      if (!target) return;
+      const safeSummary = (target.id ? "#" + target.id : "") + (target.className ? "." + target.className.split(" ").join(".") : "") || target.tagName;
+      self.addBreadcrumb({
+        category: "ui.click",
+        message: safeSummary,
+        level: "info"
+      });
+    }, true);
+    const levels = ["log", "info", "warn", "error", "debug"];
+    levels.forEach((level) => {
+      const original = console[level];
+      console[level] = function(...args) {
+        self.addBreadcrumb({
+          category: "console",
+          message: args.map((a) => String(a)).join(" "),
+          level: level === "error" ? "error" : level === "warn" ? "warning" : "info"
+        });
+        original.apply(console, args);
+      };
+    });
+    const originalFetch = window.fetch;
+    window.fetch = async function(...args) {
+      const [resource, config] = args;
+      const method = (config?.method || "GET").toUpperCase();
+      const url = String(resource);
+      self.addBreadcrumb({
+        category: "http",
+        message: `${method} ${url}`,
+        level: "info",
+        data: {
+          method,
+          url
+        }
+      });
+      try {
+        const response = await originalFetch.apply(this, args);
+        self.addBreadcrumb({
+          category: "http.response",
+          message: `${method} ${url} [${response.status}]`,
+          level: response.status >= 400 ? "error" : "info",
+          data: { status: response.status }
+        });
+        return response;
+      } catch (err) {
+        self.addBreadcrumb({
+          category: "http.error",
+          message: `${method} ${url} FAILED`,
+          level: "error",
+          data: { error: String(err) }
+        });
+        throw err;
+      }
+    };
+  }
+};
+var sentinel = Sentinel.getInstance();
+var init = (config) => sentinel.init(config);
+var captureException = (error, context) => sentinel.captureException(error, context);
+var captureMessage = (msg, level) => sentinel.captureMessage(msg, level);
+var setUser = (user) => sentinel.setUser(user);
+var setTag = (key, value) => sentinel.setTag(key, value);
+export {
+  Sentinel,
+  captureException,
+  captureMessage,
+  init,
+  sentinel,
+  setTag,
+  setUser
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "@builderai/sentinel-browser",
+    "version": "0.1.0",
+    "description": "Official browser SDK for Sentinel AI error tracking",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts",
+        "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+        "lint": "eslint src/**/*.ts",
+        "test": "vitest run"
+    },
+    "files": [
+        "dist"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "keywords": [
+        "error-tracking",
+        "logging",
+        "monitoring",
+        "sentinel-ai"
+    ],
+    "author": "Sentinel AI",
+    "license": "MIT",
+    "devDependencies": {
+        "happy-dom": "^20.5.3",
+        "tsup": "^8.0.2",
+        "typescript": "^5.3.3",
+        "vitest": "^1.3.1"
+    }
+}