@drakkar.software/sunglasses-core 0.10.0 → 0.12.0

package/dist/index.d.mts

@@ -523,9 +523,8 @@ interface ISunglassesTypedClient<T extends EventMap> extends ISunglassesClient {
     capture<K extends keyof T & string>(eventName: K, ...args: T[K] extends undefined ? [properties?: Record<string, unknown>] : [properties: T[K]]): void;
 }
 /**
- * Standard properties emitted by error-capturing adapters as `$error` events.
- * Shared by `@drakkar.software/sunglasses-adapter-sentry`,
- * `@drakkar.software/sunglasses-adapter-posthog`, and `SunglassesErrorBoundary`.
+ * Standard properties emitted by error-capturing code as `$error` events.
+ * Used by `captureException`, `SunglassesErrorBoundary`, and `autoCaptureErrors`.
  */
 interface ErrorEventProperties {
     $error_message: string;
@@ -1179,6 +1178,20 @@ interface CaptureExceptionOptions {
      * object to capture, or `null` to skip capture entirely.
      */
     beforeCapture?: (props: ErrorEventProperties) => Record<string, unknown> | null;
+    /**
+     * Drop errors with the same fingerprint (name + message + first stack frame)
+     * captured within {@link dedupeWindowMs}. This collapses the common
+     * double-capture cases — e.g. an error boundary plus `console.error` capture
+     * reporting the same render error, or a global handler firing repeatedly for
+     * the same throw. The fingerprint deliberately ignores the `handled` flag and
+     * `$error_source`, so the first capture wins. Default: `true`.
+     */
+    dedupe?: boolean;
+    /**
+     * Time window (ms) used by {@link dedupe}. Identical errors within this window
+     * are dropped. Default: `1000`.
+     */
+    dedupeWindowMs?: number;
 }
 /**
  * Normalize any thrown value into a SunGlasses `$error` event and capture it
@@ -1203,6 +1216,113 @@ interface CaptureExceptionOptions {
  */
 declare function captureException(client: ISunglassesClient, error: unknown, options?: CaptureExceptionOptions): void;
 
+/** Console methods that can be captured. */
+type ConsoleLevel = 'error' | 'warn';
+/**
+ * Options for {@link patchConsole}.
+ */
+interface ConsoleCaptureOptions {
+    /** Console methods to capture. Default: `['error']`. */
+    levels?: ConsoleLevel[];
+    /**
+     * Skip console output whose composed message matches any of these patterns.
+     * Pattern is tested against the raw (pre-truncation) message.
+     */
+    ignorePatterns?: RegExp[];
+    /** Truncate the composed message to this many characters. Default: `200`. */
+    maxMessageLength?: number;
+    /** Include a stack trace in `$error_stack`. Default: `false` (privacy-safe). */
+    includeStack?: boolean;
+    /** Extra properties merged into every captured `$error` event. */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Configuration for the providers' `autoCaptureErrors` option. Extends
+ * {@link CaptureExceptionOptions} (applied to unhandled global errors) with
+ * toggles for the global handlers and console capture.
+ */
+interface AutoCaptureErrorsOptions extends CaptureExceptionOptions {
+    /**
+     * Install the platform uncaught-error handlers (web `window` `'error'`,
+     * React Native `ErrorUtils`). Default: `true`.
+     */
+    globalHandlers?: boolean;
+    /**
+     * Capture unhandled promise rejections (web `window` `'unhandledrejection'`,
+     * React Native engine-specific rejection tracking). Default: `true`.
+     */
+    unhandledRejections?: boolean;
+    /**
+     * Also capture console output as `$error` events. `true` captures
+     * `console.error`; pass {@link ConsoleCaptureOptions} to configure levels.
+     * Default: off.
+     */
+    console?: boolean | ConsoleCaptureOptions;
+}
+/**
+ * Patch the global `console` so that `console.error` / `console.warn` (per
+ * `levels`) are also captured as SunGlasses `$error` events
+ * (`$error_handled: false`, `$error_source: 'console'`).
+ *
+ * Works identically on web and React Native — both expose a global `console`.
+ * The original method is always called first, so logs still appear in the
+ * console. Returns an unpatch function that restores the original methods.
+ *
+ * Guards against infinite recursion: SunGlasses' own logger writes to
+ * `console.error`/`console.warn` (prefixed with `[SunGlasses]`), and
+ * `client.capture()` may log on failure. A re-entrancy flag plus a prefix skip
+ * prevent a capture -> log -> capture loop.
+ *
+ * @param client - SunGlasses client instance.
+ * @param options - Optional capture configuration.
+ * @returns A function that restores the original console methods.
+ *
+ * @example
+ * ```ts
+ * const unpatch = patchConsole(client, { levels: ['error', 'warn'] });
+ * // ... later
+ * unpatch();
+ * ```
+ */
+declare function patchConsole(client: ISunglassesClient, options?: ConsoleCaptureOptions): () => void;
+
+/**
+ * Describes a global (non-render) error surfaced by a platform global handler.
+ * Published by the providers' auto-capture handlers and consumed by
+ * `SunglassesGlobalErrorBoundary` to decide whether to render its fallback UI.
+ *
+ * The raw `error` reference is forwarded only to in-process subscribers; nothing
+ * is persisted, logged, or sent anywhere by the bus itself.
+ */
+interface GlobalErrorInfo {
+    /** The thrown value (an `Error`, string, or arbitrary object). */
+    error: unknown;
+    /**
+     * Whether the runtime considered the error fatal. Uncaught errors are fatal
+     * unless the platform reports otherwise; unhandled promise rejections are
+     * non-fatal.
+     */
+    fatal: boolean;
+    /** Whether the error came from an uncaught error or an unhandled rejection. */
+    kind: 'error' | 'rejection';
+}
+/** A subscriber notified for every published {@link GlobalErrorInfo}. */
+type GlobalErrorListener = (info: GlobalErrorInfo) => void;
+/**
+ * Publish a global error to all current subscribers. Subscriber errors are
+ * swallowed so one faulty listener cannot break others or the caller.
+ *
+ * @param info - The global error descriptor.
+ */
+declare function publishGlobalError(info: GlobalErrorInfo): void;
+/**
+ * Subscribe to global errors published via {@link publishGlobalError}.
+ *
+ * @param listener - Called for each published error.
+ * @returns An unsubscribe function.
+ */
+declare function subscribeGlobalError(listener: GlobalErrorListener): () => void;
+
 /**
  * A typed analytics stub that is safe to use before the SDK initialises.
  *
@@ -1275,4 +1395,4 @@ declare function sha256Hex(input: string): Promise<string>;
  */
 declare function nowISO(): string;
 
-export { type AppMetadata, type AppUpdateInfo, type CaptureExceptionOptions, type CleanupConfig, type ConsentHistoryEntry, ConsentManager, type ConsentState, type ConsentStatus, type ErrorEventProperties, type EventContext, type EventCountPeriod, EventCounter, type EventMap, EventQueue, type EventType, FrequencyMiddleware, type FrequencyMiddlewareOptions, type HttpAdapterConfig, type IAnalyticsAdapter, type IEventCounter, type IMiddleware, type IStorageAdapter, type ISunglassesClient, type ISunglassesTypedClient, IdentityManager, type IdentityState, LocalEventArchive, type Logger, type MiddlewareNext, MiddlewarePipeline, PiiSanitizer, SamplingMiddleware, type SamplingMiddlewareOptions, type ScreenTrackingOptions, SessionManager, type SessionState, type SunglassesConfig, SunglassesCore, type SunglassesEvent, TraitManager, type UserDataExport, asTyped, captureException, createLazyClient, createLogger, generateUUID, nowISO, sha256Hex };
+export { type AppMetadata, type AppUpdateInfo, type AutoCaptureErrorsOptions, type CaptureExceptionOptions, type CleanupConfig, type ConsentHistoryEntry, ConsentManager, type ConsentState, type ConsentStatus, type ConsoleCaptureOptions, type ConsoleLevel, type ErrorEventProperties, type EventContext, type EventCountPeriod, EventCounter, type EventMap, EventQueue, type EventType, FrequencyMiddleware, type FrequencyMiddlewareOptions, type GlobalErrorInfo, type GlobalErrorListener, type HttpAdapterConfig, type IAnalyticsAdapter, type IEventCounter, type IMiddleware, type IStorageAdapter, type ISunglassesClient, type ISunglassesTypedClient, IdentityManager, type IdentityState, LocalEventArchive, type Logger, type MiddlewareNext, MiddlewarePipeline, PiiSanitizer, SamplingMiddleware, type SamplingMiddlewareOptions, type ScreenTrackingOptions, SessionManager, type SessionState, type SunglassesConfig, SunglassesCore, type SunglassesEvent, TraitManager, type UserDataExport, asTyped, captureException, createLazyClient, createLogger, generateUUID, nowISO, patchConsole, publishGlobalError, sha256Hex, subscribeGlobalError };

package/dist/index.d.ts

@@ -523,9 +523,8 @@ interface ISunglassesTypedClient<T extends EventMap> extends ISunglassesClient {
     capture<K extends keyof T & string>(eventName: K, ...args: T[K] extends undefined ? [properties?: Record<string, unknown>] : [properties: T[K]]): void;
 }
 /**
- * Standard properties emitted by error-capturing adapters as `$error` events.
- * Shared by `@drakkar.software/sunglasses-adapter-sentry`,
- * `@drakkar.software/sunglasses-adapter-posthog`, and `SunglassesErrorBoundary`.
+ * Standard properties emitted by error-capturing code as `$error` events.
+ * Used by `captureException`, `SunglassesErrorBoundary`, and `autoCaptureErrors`.
  */
 interface ErrorEventProperties {
     $error_message: string;
@@ -1179,6 +1178,20 @@ interface CaptureExceptionOptions {
      * object to capture, or `null` to skip capture entirely.
      */
     beforeCapture?: (props: ErrorEventProperties) => Record<string, unknown> | null;
+    /**
+     * Drop errors with the same fingerprint (name + message + first stack frame)
+     * captured within {@link dedupeWindowMs}. This collapses the common
+     * double-capture cases — e.g. an error boundary plus `console.error` capture
+     * reporting the same render error, or a global handler firing repeatedly for
+     * the same throw. The fingerprint deliberately ignores the `handled` flag and
+     * `$error_source`, so the first capture wins. Default: `true`.
+     */
+    dedupe?: boolean;
+    /**
+     * Time window (ms) used by {@link dedupe}. Identical errors within this window
+     * are dropped. Default: `1000`.
+     */
+    dedupeWindowMs?: number;
 }
 /**
  * Normalize any thrown value into a SunGlasses `$error` event and capture it
@@ -1203,6 +1216,113 @@ interface CaptureExceptionOptions {
  */
 declare function captureException(client: ISunglassesClient, error: unknown, options?: CaptureExceptionOptions): void;
 
+/** Console methods that can be captured. */
+type ConsoleLevel = 'error' | 'warn';
+/**
+ * Options for {@link patchConsole}.
+ */
+interface ConsoleCaptureOptions {
+    /** Console methods to capture. Default: `['error']`. */
+    levels?: ConsoleLevel[];
+    /**
+     * Skip console output whose composed message matches any of these patterns.
+     * Pattern is tested against the raw (pre-truncation) message.
+     */
+    ignorePatterns?: RegExp[];
+    /** Truncate the composed message to this many characters. Default: `200`. */
+    maxMessageLength?: number;
+    /** Include a stack trace in `$error_stack`. Default: `false` (privacy-safe). */
+    includeStack?: boolean;
+    /** Extra properties merged into every captured `$error` event. */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Configuration for the providers' `autoCaptureErrors` option. Extends
+ * {@link CaptureExceptionOptions} (applied to unhandled global errors) with
+ * toggles for the global handlers and console capture.
+ */
+interface AutoCaptureErrorsOptions extends CaptureExceptionOptions {
+    /**
+     * Install the platform uncaught-error handlers (web `window` `'error'`,
+     * React Native `ErrorUtils`). Default: `true`.
+     */
+    globalHandlers?: boolean;
+    /**
+     * Capture unhandled promise rejections (web `window` `'unhandledrejection'`,
+     * React Native engine-specific rejection tracking). Default: `true`.
+     */
+    unhandledRejections?: boolean;
+    /**
+     * Also capture console output as `$error` events. `true` captures
+     * `console.error`; pass {@link ConsoleCaptureOptions} to configure levels.
+     * Default: off.
+     */
+    console?: boolean | ConsoleCaptureOptions;
+}
+/**
+ * Patch the global `console` so that `console.error` / `console.warn` (per
+ * `levels`) are also captured as SunGlasses `$error` events
+ * (`$error_handled: false`, `$error_source: 'console'`).
+ *
+ * Works identically on web and React Native — both expose a global `console`.
+ * The original method is always called first, so logs still appear in the
+ * console. Returns an unpatch function that restores the original methods.
+ *
+ * Guards against infinite recursion: SunGlasses' own logger writes to
+ * `console.error`/`console.warn` (prefixed with `[SunGlasses]`), and
+ * `client.capture()` may log on failure. A re-entrancy flag plus a prefix skip
+ * prevent a capture -> log -> capture loop.
+ *
+ * @param client - SunGlasses client instance.
+ * @param options - Optional capture configuration.
+ * @returns A function that restores the original console methods.
+ *
+ * @example
+ * ```ts
+ * const unpatch = patchConsole(client, { levels: ['error', 'warn'] });
+ * // ... later
+ * unpatch();
+ * ```
+ */
+declare function patchConsole(client: ISunglassesClient, options?: ConsoleCaptureOptions): () => void;
+
+/**
+ * Describes a global (non-render) error surfaced by a platform global handler.
+ * Published by the providers' auto-capture handlers and consumed by
+ * `SunglassesGlobalErrorBoundary` to decide whether to render its fallback UI.
+ *
+ * The raw `error` reference is forwarded only to in-process subscribers; nothing
+ * is persisted, logged, or sent anywhere by the bus itself.
+ */
+interface GlobalErrorInfo {
+    /** The thrown value (an `Error`, string, or arbitrary object). */
+    error: unknown;
+    /**
+     * Whether the runtime considered the error fatal. Uncaught errors are fatal
+     * unless the platform reports otherwise; unhandled promise rejections are
+     * non-fatal.
+     */
+    fatal: boolean;
+    /** Whether the error came from an uncaught error or an unhandled rejection. */
+    kind: 'error' | 'rejection';
+}
+/** A subscriber notified for every published {@link GlobalErrorInfo}. */
+type GlobalErrorListener = (info: GlobalErrorInfo) => void;
+/**
+ * Publish a global error to all current subscribers. Subscriber errors are
+ * swallowed so one faulty listener cannot break others or the caller.
+ *
+ * @param info - The global error descriptor.
+ */
+declare function publishGlobalError(info: GlobalErrorInfo): void;
+/**
+ * Subscribe to global errors published via {@link publishGlobalError}.
+ *
+ * @param listener - Called for each published error.
+ * @returns An unsubscribe function.
+ */
+declare function subscribeGlobalError(listener: GlobalErrorListener): () => void;
+
 /**
  * A typed analytics stub that is safe to use before the SDK initialises.
  *
@@ -1275,4 +1395,4 @@ declare function sha256Hex(input: string): Promise<string>;
  */
 declare function nowISO(): string;
 
-export { type AppMetadata, type AppUpdateInfo, type CaptureExceptionOptions, type CleanupConfig, type ConsentHistoryEntry, ConsentManager, type ConsentState, type ConsentStatus, type ErrorEventProperties, type EventContext, type EventCountPeriod, EventCounter, type EventMap, EventQueue, type EventType, FrequencyMiddleware, type FrequencyMiddlewareOptions, type HttpAdapterConfig, type IAnalyticsAdapter, type IEventCounter, type IMiddleware, type IStorageAdapter, type ISunglassesClient, type ISunglassesTypedClient, IdentityManager, type IdentityState, LocalEventArchive, type Logger, type MiddlewareNext, MiddlewarePipeline, PiiSanitizer, SamplingMiddleware, type SamplingMiddlewareOptions, type ScreenTrackingOptions, SessionManager, type SessionState, type SunglassesConfig, SunglassesCore, type SunglassesEvent, TraitManager, type UserDataExport, asTyped, captureException, createLazyClient, createLogger, generateUUID, nowISO, sha256Hex };
+export { type AppMetadata, type AppUpdateInfo, type AutoCaptureErrorsOptions, type CaptureExceptionOptions, type CleanupConfig, type ConsentHistoryEntry, ConsentManager, type ConsentState, type ConsentStatus, type ConsoleCaptureOptions, type ConsoleLevel, type ErrorEventProperties, type EventContext, type EventCountPeriod, EventCounter, type EventMap, EventQueue, type EventType, FrequencyMiddleware, type FrequencyMiddlewareOptions, type GlobalErrorInfo, type GlobalErrorListener, type HttpAdapterConfig, type IAnalyticsAdapter, type IEventCounter, type IMiddleware, type IStorageAdapter, type ISunglassesClient, type ISunglassesTypedClient, IdentityManager, type IdentityState, LocalEventArchive, type Logger, type MiddlewareNext, MiddlewarePipeline, PiiSanitizer, SamplingMiddleware, type SamplingMiddlewareOptions, type ScreenTrackingOptions, SessionManager, type SessionState, type SunglassesConfig, SunglassesCore, type SunglassesEvent, TraitManager, type UserDataExport, asTyped, captureException, createLazyClient, createLogger, generateUUID, nowISO, patchConsole, publishGlobalError, sha256Hex, subscribeGlobalError };

package/dist/index.js

@@ -38,7 +38,10 @@ __export(index_exports, {
   createLogger: () => createLogger,
   generateUUID: () => generateUUID,
   nowISO: () => nowISO,
-  sha256Hex: () => sha256Hex
+  patchConsole: () => patchConsole,
+  publishGlobalError: () => publishGlobalError,
+  sha256Hex: () => sha256Hex,
+  subscribeGlobalError: () => subscribeGlobalError
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1611,6 +1614,22 @@ function extractStack(stack, maxFrames) {
   }
   return void 0;
 }
+var dedupeStore = /* @__PURE__ */ new WeakMap();
+function isDuplicate(client, fingerprint, windowMs) {
+  const now = Date.now();
+  let seen = dedupeStore.get(client);
+  if (!seen) {
+    seen = /* @__PURE__ */ new Map();
+    dedupeStore.set(client, seen);
+  }
+  for (const [fp, ts] of seen) {
+    if (now - ts > windowMs) seen.delete(fp);
+  }
+  const last = seen.get(fingerprint);
+  if (last !== void 0 && now - last <= windowMs) return true;
+  seen.set(fingerprint, now);
+  return false;
+}
 function captureException(client, error, options = {}) {
   const {
     handled = true,
@@ -1620,11 +1639,18 @@ function captureException(client, error, options = {}) {
     maxMessageLength = 200,
     ignorePatterns = [],
     properties,
-    beforeCapture
+    beforeCapture,
+    dedupe = true,
+    dedupeWindowMs = 1e3
   } = options;
   const normalized = normalizeError(error);
   const rawMessage = normalized.message;
   if (ignorePatterns.some((p) => p.test(rawMessage))) return;
+  if (dedupe) {
+    const firstFrame = extractStack(normalized.stack, 1) ?? "";
+    const fingerprint = `${normalized.name}|${rawMessage}|${firstFrame}`;
+    if (isDuplicate(client, fingerprint, dedupeWindowMs)) return;
+  }
   let props = {
     ...properties,
     $error_message: rawMessage.slice(0, maxMessageLength),
@@ -1645,6 +1671,82 @@ function captureException(client, error, options = {}) {
   }
 }
 
+// src/patchConsole.ts
+var SELF_LOG_PREFIX = "[SunGlasses]";
+var LEVEL_TO_SEVERITY = {
+  error: "error",
+  warn: "warning"
+};
+function composeMessage(args) {
+  return args.map((arg) => {
+    if (typeof arg === "string") return arg;
+    if (arg instanceof Error) return arg.message;
+    try {
+      return typeof arg === "object" && arg !== null ? JSON.stringify(arg) : String(arg);
+    } catch {
+      return "[object]";
+    }
+  }).join(" ");
+}
+function patchConsole(client, options = {}) {
+  const {
+    levels = ["error"],
+    ignorePatterns = [],
+    maxMessageLength = 200,
+    includeStack = false,
+    properties
+  } = options;
+  const uniqueLevels = Array.from(new Set(levels));
+  const originals = /* @__PURE__ */ new Map();
+  let isCapturing = false;
+  for (const level of uniqueLevels) {
+    const original = console[level];
+    originals.set(level, original);
+    console[level] = (...args) => {
+      original.apply(console, args);
+      if (isCapturing) return;
+      if (typeof args[0] === "string" && args[0].startsWith(SELF_LOG_PREFIX)) return;
+      const rawMessage = composeMessage(args);
+      if (ignorePatterns.some((p) => p.test(rawMessage))) return;
+      const errorArg = args.find((a) => a instanceof Error);
+      isCapturing = true;
+      try {
+        captureException(client, errorArg ?? rawMessage, {
+          handled: false,
+          level: LEVEL_TO_SEVERITY[level],
+          includeStack,
+          maxMessageLength,
+          properties: { ...properties, $error_source: "console" }
+        });
+      } finally {
+        isCapturing = false;
+      }
+    };
+  }
+  return () => {
+    for (const [level, original] of originals) {
+      console[level] = original;
+    }
+  };
+}
+
+// src/errorBus.ts
+var listeners = /* @__PURE__ */ new Set();
+function publishGlobalError(info) {
+  for (const listener of listeners) {
+    try {
+      listener(info);
+    } catch {
+    }
+  }
+}
+function subscribeGlobalError(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
 // src/LazyClient.ts
 function createLazyClient() {
   let _inner = null;
@@ -1782,5 +1884,8 @@ function createLazyClient() {
   createLogger,
   generateUUID,
   nowISO,
-  sha256Hex
+  patchConsole,
+  publishGlobalError,
+  sha256Hex,
+  subscribeGlobalError
 });

package/dist/index.mjs

@@ -1567,6 +1567,22 @@ function extractStack(stack, maxFrames) {
   }
   return void 0;
 }
+var dedupeStore = /* @__PURE__ */ new WeakMap();
+function isDuplicate(client, fingerprint, windowMs) {
+  const now = Date.now();
+  let seen = dedupeStore.get(client);
+  if (!seen) {
+    seen = /* @__PURE__ */ new Map();
+    dedupeStore.set(client, seen);
+  }
+  for (const [fp, ts] of seen) {
+    if (now - ts > windowMs) seen.delete(fp);
+  }
+  const last = seen.get(fingerprint);
+  if (last !== void 0 && now - last <= windowMs) return true;
+  seen.set(fingerprint, now);
+  return false;
+}
 function captureException(client, error, options = {}) {
   const {
     handled = true,
@@ -1576,11 +1592,18 @@ function captureException(client, error, options = {}) {
     maxMessageLength = 200,
     ignorePatterns = [],
     properties,
-    beforeCapture
+    beforeCapture,
+    dedupe = true,
+    dedupeWindowMs = 1e3
   } = options;
   const normalized = normalizeError(error);
   const rawMessage = normalized.message;
   if (ignorePatterns.some((p) => p.test(rawMessage))) return;
+  if (dedupe) {
+    const firstFrame = extractStack(normalized.stack, 1) ?? "";
+    const fingerprint = `${normalized.name}|${rawMessage}|${firstFrame}`;
+    if (isDuplicate(client, fingerprint, dedupeWindowMs)) return;
+  }
   let props = {
     ...properties,
     $error_message: rawMessage.slice(0, maxMessageLength),
@@ -1601,6 +1624,82 @@ function captureException(client, error, options = {}) {
   }
 }
 
+// src/patchConsole.ts
+var SELF_LOG_PREFIX = "[SunGlasses]";
+var LEVEL_TO_SEVERITY = {
+  error: "error",
+  warn: "warning"
+};
+function composeMessage(args) {
+  return args.map((arg) => {
+    if (typeof arg === "string") return arg;
+    if (arg instanceof Error) return arg.message;
+    try {
+      return typeof arg === "object" && arg !== null ? JSON.stringify(arg) : String(arg);
+    } catch {
+      return "[object]";
+    }
+  }).join(" ");
+}
+function patchConsole(client, options = {}) {
+  const {
+    levels = ["error"],
+    ignorePatterns = [],
+    maxMessageLength = 200,
+    includeStack = false,
+    properties
+  } = options;
+  const uniqueLevels = Array.from(new Set(levels));
+  const originals = /* @__PURE__ */ new Map();
+  let isCapturing = false;
+  for (const level of uniqueLevels) {
+    const original = console[level];
+    originals.set(level, original);
+    console[level] = (...args) => {
+      original.apply(console, args);
+      if (isCapturing) return;
+      if (typeof args[0] === "string" && args[0].startsWith(SELF_LOG_PREFIX)) return;
+      const rawMessage = composeMessage(args);
+      if (ignorePatterns.some((p) => p.test(rawMessage))) return;
+      const errorArg = args.find((a) => a instanceof Error);
+      isCapturing = true;
+      try {
+        captureException(client, errorArg ?? rawMessage, {
+          handled: false,
+          level: LEVEL_TO_SEVERITY[level],
+          includeStack,
+          maxMessageLength,
+          properties: { ...properties, $error_source: "console" }
+        });
+      } finally {
+        isCapturing = false;
+      }
+    };
+  }
+  return () => {
+    for (const [level, original] of originals) {
+      console[level] = original;
+    }
+  };
+}
+
+// src/errorBus.ts
+var listeners = /* @__PURE__ */ new Set();
+function publishGlobalError(info) {
+  for (const listener of listeners) {
+    try {
+      listener(info);
+    } catch {
+    }
+  }
+}
+function subscribeGlobalError(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
 // src/LazyClient.ts
 function createLazyClient() {
   let _inner = null;
@@ -1737,5 +1836,8 @@ export {
   createLogger,
   generateUUID,
   nowISO,
-  sha256Hex
+  patchConsole,
+  publishGlobalError,
+  sha256Hex,
+  subscribeGlobalError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakkar.software/sunglasses-core",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Platform-agnostic event tracking engine for SunGlasses",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",