@drakkar.software/sunglasses-core 0.11.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
@@ -1230,10 +1243,15 @@ interface ConsoleCaptureOptions {
  */
 interface AutoCaptureErrorsOptions extends CaptureExceptionOptions {
     /**
-     * Install the platform global error handlers (web `window` `error` /
-     * `unhandledrejection`, React Native `ErrorUtils`). Default: `true`.
+     * 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.
@@ -1268,6 +1286,43 @@ interface AutoCaptureErrorsOptions extends CaptureExceptionOptions {
  */
 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.
  *
@@ -1340,4 +1395,4 @@ declare function sha256Hex(input: string): Promise<string>;
  */
 declare function nowISO(): string;
 
-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 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, 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
@@ -1230,10 +1243,15 @@ interface ConsoleCaptureOptions {
  */
 interface AutoCaptureErrorsOptions extends CaptureExceptionOptions {
     /**
-     * Install the platform global error handlers (web `window` `error` /
-     * `unhandledrejection`, React Native `ErrorUtils`). Default: `true`.
+     * 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.
@@ -1268,6 +1286,43 @@ interface AutoCaptureErrorsOptions extends CaptureExceptionOptions {
  */
 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.
  *
@@ -1340,4 +1395,4 @@ declare function sha256Hex(input: string): Promise<string>;
  */
 declare function nowISO(): string;
 
-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 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, 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

@@ -39,7 +39,9 @@ __export(index_exports, {
   generateUUID: () => generateUUID,
   nowISO: () => nowISO,
   patchConsole: () => patchConsole,
-  sha256Hex: () => sha256Hex
+  publishGlobalError: () => publishGlobalError,
+  sha256Hex: () => sha256Hex,
+  subscribeGlobalError: () => subscribeGlobalError
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1612,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,
@@ -1621,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),
@@ -1705,6 +1730,23 @@ function patchConsole(client, options = {}) {
   };
 }
 
+// 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;
@@ -1843,5 +1885,7 @@ function createLazyClient() {
   generateUUID,
   nowISO,
   patchConsole,
-  sha256Hex
+  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),
@@ -1660,6 +1683,23 @@ function patchConsole(client, options = {}) {
   };
 }
 
+// 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;
@@ -1797,5 +1837,7 @@ export {
   generateUUID,
   nowISO,
   patchConsole,
-  sha256Hex
+  publishGlobalError,
+  sha256Hex,
+  subscribeGlobalError
 };

package/package.json

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