@drakkar.software/sunglasses-react 0.10.0 → 0.11.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { ISunglassesClient, ScreenTrackingOptions, CaptureExceptionOptions, ConsentStatus } from '@drakkar.software/sunglasses-core';
-export { CaptureExceptionOptions, ConsentStatus, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent, captureException } from '@drakkar.software/sunglasses-core';
+import { ISunglassesClient, ScreenTrackingOptions, AutoCaptureErrorsOptions, ConsentStatus, CaptureExceptionOptions } from '@drakkar.software/sunglasses-core';
+export { AutoCaptureErrorsOptions, CaptureExceptionOptions, ConsentStatus, ConsoleCaptureOptions, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent, captureException, patchConsole } from '@drakkar.software/sunglasses-core';
 
 interface SunglassesProviderProps {
     /** An initialized ISunglassesClient (from SunglassesCore.create()). */
@@ -8,12 +8,18 @@ interface SunglassesProviderProps {
     /** Optional screen tracking configuration. */
     screenTracking?: ScreenTrackingOptions;
     /**
-     * Automatically capture unhandled global errors as `$error` events
-     * (`$error_handled: false`). Listens to `window` `'error'` and
-     * `'unhandledrejection'`. Pass `true` for defaults, or an options object to
-     * configure truncation / stack inclusion. Default: off.
+     * Automatically capture unhandled errors as `$error` events
+     * (`$error_handled: false`).
+     *
+     * - `true` installs the global handlers for `window` `'error'` and
+     *   `'unhandledrejection'`.
+     * - An options object additionally lets you toggle `globalHandlers` and opt
+     *   into `console` capture (`console.error` / `console.warn`), plus configure
+     *   truncation / stack inclusion / ignore patterns.
+     *
+     * Default: off.
      */
-    autoCaptureErrors?: boolean | CaptureExceptionOptions;
+    autoCaptureErrors?: boolean | AutoCaptureErrorsOptions;
     children: React.ReactNode;
 }
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { ISunglassesClient, ScreenTrackingOptions, CaptureExceptionOptions, ConsentStatus } from '@drakkar.software/sunglasses-core';
-export { CaptureExceptionOptions, ConsentStatus, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent, captureException } from '@drakkar.software/sunglasses-core';
+import { ISunglassesClient, ScreenTrackingOptions, AutoCaptureErrorsOptions, ConsentStatus, CaptureExceptionOptions } from '@drakkar.software/sunglasses-core';
+export { AutoCaptureErrorsOptions, CaptureExceptionOptions, ConsentStatus, ConsoleCaptureOptions, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent, captureException, patchConsole } from '@drakkar.software/sunglasses-core';
 
 interface SunglassesProviderProps {
     /** An initialized ISunglassesClient (from SunglassesCore.create()). */
@@ -8,12 +8,18 @@ interface SunglassesProviderProps {
     /** Optional screen tracking configuration. */
     screenTracking?: ScreenTrackingOptions;
     /**
-     * Automatically capture unhandled global errors as `$error` events
-     * (`$error_handled: false`). Listens to `window` `'error'` and
-     * `'unhandledrejection'`. Pass `true` for defaults, or an options object to
-     * configure truncation / stack inclusion. Default: off.
+     * Automatically capture unhandled errors as `$error` events
+     * (`$error_handled: false`).
+     *
+     * - `true` installs the global handlers for `window` `'error'` and
+     *   `'unhandledrejection'`.
+     * - An options object additionally lets you toggle `globalHandlers` and opt
+     *   into `console` capture (`console.error` / `console.warn`), plus configure
+     *   truncation / stack inclusion / ignore patterns.
+     *
+     * Default: off.
      */
-    autoCaptureErrors?: boolean | CaptureExceptionOptions;
+    autoCaptureErrors?: boolean | AutoCaptureErrorsOptions;
     children: React.ReactNode;
 }
 /**

package/dist/index.js

@@ -35,6 +35,7 @@ __export(index_exports, {
   SunglassesProvider: () => SunglassesProvider,
   captureException: () => import_sunglasses_core3.captureException,
   captureUtmParams: () => captureUtmParams,
+  patchConsole: () => import_sunglasses_core3.patchConsole,
   useCapture: () => useCapture,
   useConsentStatus: () => useConsentStatus,
   useScreenTracking: () => useScreenTracking,
@@ -132,19 +133,28 @@ function SunglassesProvider({
   }, [client]);
   (0, import_react3.useEffect)(() => {
     if (!autoCaptureErrors) return;
-    if (typeof window === "undefined") return;
     const options = typeof autoCaptureErrors === "object" ? autoCaptureErrors : {};
-    const onError = (event) => {
-      (0, import_sunglasses_core.captureException)(client, event.error ?? event.message, { handled: false, ...options });
-    };
-    const onRejection = (event) => {
-      (0, import_sunglasses_core.captureException)(client, event.reason, { handled: false, ...options });
-    };
-    window.addEventListener("error", onError);
-    window.addEventListener("unhandledrejection", onRejection);
+    const cleanups = [];
+    if (options.globalHandlers !== false && typeof window !== "undefined") {
+      const onError = (event) => {
+        (0, import_sunglasses_core.captureException)(client, event.error ?? event.message, { handled: false, ...options });
+      };
+      const onRejection = (event) => {
+        (0, import_sunglasses_core.captureException)(client, event.reason, { handled: false, ...options });
+      };
+      window.addEventListener("error", onError);
+      window.addEventListener("unhandledrejection", onRejection);
+      cleanups.push(() => {
+        window.removeEventListener("error", onError);
+        window.removeEventListener("unhandledrejection", onRejection);
+      });
+    }
+    if (options.console) {
+      const consoleOptions = typeof options.console === "object" ? options.console : {};
+      cleanups.push((0, import_sunglasses_core.patchConsole)(client, consoleOptions));
+    }
     return () => {
-      window.removeEventListener("error", onError);
-      window.removeEventListener("unhandledrejection", onRejection);
+      for (const cleanup of cleanups) cleanup();
     };
   }, [client, autoCaptureErrors]);
   (0, import_react3.useEffect)(() => {
@@ -249,6 +259,7 @@ var import_sunglasses_core3 = require("@drakkar.software/sunglasses-core");
   SunglassesProvider,
   captureException,
   captureUtmParams,
+  patchConsole,
   useCapture,
   useConsentStatus,
   useScreenTracking,

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // src/SunglassesProvider.tsx
 import { useEffect as useEffect2 } from "react";
-import { captureException } from "@drakkar.software/sunglasses-core";
+import { captureException, patchConsole } from "@drakkar.software/sunglasses-core";
 
 // src/context.ts
 import { createContext, useContext } from "react";
@@ -88,19 +88,28 @@ function SunglassesProvider({
   }, [client]);
   useEffect2(() => {
     if (!autoCaptureErrors) return;
-    if (typeof window === "undefined") return;
     const options = typeof autoCaptureErrors === "object" ? autoCaptureErrors : {};
-    const onError = (event) => {
-      captureException(client, event.error ?? event.message, { handled: false, ...options });
-    };
-    const onRejection = (event) => {
-      captureException(client, event.reason, { handled: false, ...options });
-    };
-    window.addEventListener("error", onError);
-    window.addEventListener("unhandledrejection", onRejection);
+    const cleanups = [];
+    if (options.globalHandlers !== false && typeof window !== "undefined") {
+      const onError = (event) => {
+        captureException(client, event.error ?? event.message, { handled: false, ...options });
+      };
+      const onRejection = (event) => {
+        captureException(client, event.reason, { handled: false, ...options });
+      };
+      window.addEventListener("error", onError);
+      window.addEventListener("unhandledrejection", onRejection);
+      cleanups.push(() => {
+        window.removeEventListener("error", onError);
+        window.removeEventListener("unhandledrejection", onRejection);
+      });
+    }
+    if (options.console) {
+      const consoleOptions = typeof options.console === "object" ? options.console : {};
+      cleanups.push(patchConsole(client, consoleOptions));
+    }
     return () => {
-      window.removeEventListener("error", onError);
-      window.removeEventListener("unhandledrejection", onRejection);
+      for (const cleanup of cleanups) cleanup();
     };
   }, [client, autoCaptureErrors]);
   useEffect2(() => {
@@ -197,13 +206,14 @@ function SunglassesErrorBoundary(props) {
 }
 
 // src/index.ts
-import { SunglassesCore, captureException as captureException3 } from "@drakkar.software/sunglasses-core";
+import { SunglassesCore, captureException as captureException3, patchConsole as patchConsole2 } from "@drakkar.software/sunglasses-core";
 export {
   SunglassesCore,
   SunglassesErrorBoundary,
   SunglassesProvider,
   captureException3 as captureException,
   captureUtmParams,
+  patchConsole2 as patchConsole,
   useCapture,
   useConsentStatus,
   useScreenTracking,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakkar.software/sunglasses-react",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "React (web) provider and hooks for SunGlasses event tracking",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,7 +16,7 @@
     "dist"
   ],
   "dependencies": {
-    "@drakkar.software/sunglasses-core": "0.10.0"
+    "@drakkar.software/sunglasses-core": "0.11.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0"