@drakkar.software/sunglasses-react-native 0.8.0 → 0.10.0

package/dist/index.d.mts

@@ -1,10 +1,18 @@
 import React$1 from 'react';
-import { ISunglassesClient, ScreenTrackingOptions } from '@drakkar.software/sunglasses-core';
-export { ConsentStatus, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent } from '@drakkar.software/sunglasses-core';
+import { ISunglassesClient, CaptureExceptionOptions, ScreenTrackingOptions } from '@drakkar.software/sunglasses-core';
+export { CaptureExceptionOptions, ConsentStatus, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent, captureException } from '@drakkar.software/sunglasses-core';
 
 interface SunglassesProviderProps {
     /** An initialized ISunglassesClient (from SunglassesCore.create()). */
     client: ISunglassesClient;
+    /**
+     * Automatically capture unhandled JS errors as `$error` events
+     * (`$error_handled: false`) via React Native's global `ErrorUtils` handler.
+     * Pass `true` for defaults, or an options object to configure truncation /
+     * stack inclusion. The previous global handler is preserved and still
+     * invoked. Default: off.
+     */
+    autoCaptureErrors?: boolean | CaptureExceptionOptions;
     children: React$1.ReactNode;
 }
 /**
@@ -42,7 +50,7 @@ interface SunglassesProviderProps {
  * }
  * ```
  */
-declare function SunglassesProvider({ client, children, }: SunglassesProviderProps): React$1.ReactElement;
+declare function SunglassesProvider({ client, autoCaptureErrors, children, }: SunglassesProviderProps): React$1.ReactElement;
 
 /**
  * Access the SunGlasses client from React context (React Native).
@@ -184,4 +192,34 @@ declare function useLinkingUtmCapture(client: ISunglassesClient): void;
  */
 declare function useExpoRouterUtmCapture(client: ISunglassesClient): void;
 
-export { SunglassesProvider, type SunglassesProviderProps, captureDeepLinkUtmParams, useExpoRouterScreenTracking, useExpoRouterUtmCapture, useLinkingUtmCapture, useNavigationScreenTracking, useSunglasses };
+interface SunglassesErrorBoundaryProps {
+    /**
+     * SunGlasses client. Optional — defaults to the client provided by the
+     * nearest `<SunglassesProvider>`.
+     */
+    client?: ISunglassesClient;
+    /** Rendered when an error is caught. Defaults to rendering nothing. */
+    fallback?: React$1.ReactNode;
+    /** Error capture configuration forwarded to `captureException`. */
+    config?: CaptureExceptionOptions;
+    children: React$1.ReactNode;
+}
+/**
+ * React Native error boundary that captures render-phase errors as SunGlasses
+ * `$error` events (`$error_handled: true`).
+ *
+ * The client is read from the nearest `<SunglassesProvider>` by default; pass
+ * an explicit `client` prop to override.
+ *
+ * @example
+ * ```tsx
+ * <SunglassesProvider client={client}>
+ *   <SunglassesErrorBoundary fallback={<ErrorScreen />}>
+ *     <App />
+ *   </SunglassesErrorBoundary>
+ * </SunglassesProvider>
+ * ```
+ */
+declare function SunglassesErrorBoundary(props: SunglassesErrorBoundaryProps): React$1.ReactElement;
+
+export { SunglassesErrorBoundary, type SunglassesErrorBoundaryProps, SunglassesProvider, type SunglassesProviderProps, captureDeepLinkUtmParams, useExpoRouterScreenTracking, useExpoRouterUtmCapture, useLinkingUtmCapture, useNavigationScreenTracking, useSunglasses };

package/dist/index.d.ts

@@ -1,10 +1,18 @@
 import React$1 from 'react';
-import { ISunglassesClient, ScreenTrackingOptions } from '@drakkar.software/sunglasses-core';
-export { ConsentStatus, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent } from '@drakkar.software/sunglasses-core';
+import { ISunglassesClient, CaptureExceptionOptions, ScreenTrackingOptions } from '@drakkar.software/sunglasses-core';
+export { CaptureExceptionOptions, ConsentStatus, ISunglassesClient, ScreenTrackingOptions, SunglassesConfig, SunglassesCore, SunglassesEvent, captureException } from '@drakkar.software/sunglasses-core';
 
 interface SunglassesProviderProps {
     /** An initialized ISunglassesClient (from SunglassesCore.create()). */
     client: ISunglassesClient;
+    /**
+     * Automatically capture unhandled JS errors as `$error` events
+     * (`$error_handled: false`) via React Native's global `ErrorUtils` handler.
+     * Pass `true` for defaults, or an options object to configure truncation /
+     * stack inclusion. The previous global handler is preserved and still
+     * invoked. Default: off.
+     */
+    autoCaptureErrors?: boolean | CaptureExceptionOptions;
     children: React$1.ReactNode;
 }
 /**
@@ -42,7 +50,7 @@ interface SunglassesProviderProps {
  * }
  * ```
  */
-declare function SunglassesProvider({ client, children, }: SunglassesProviderProps): React$1.ReactElement;
+declare function SunglassesProvider({ client, autoCaptureErrors, children, }: SunglassesProviderProps): React$1.ReactElement;
 
 /**
  * Access the SunGlasses client from React context (React Native).
@@ -184,4 +192,34 @@ declare function useLinkingUtmCapture(client: ISunglassesClient): void;
  */
 declare function useExpoRouterUtmCapture(client: ISunglassesClient): void;
 
-export { SunglassesProvider, type SunglassesProviderProps, captureDeepLinkUtmParams, useExpoRouterScreenTracking, useExpoRouterUtmCapture, useLinkingUtmCapture, useNavigationScreenTracking, useSunglasses };
+interface SunglassesErrorBoundaryProps {
+    /**
+     * SunGlasses client. Optional — defaults to the client provided by the
+     * nearest `<SunglassesProvider>`.
+     */
+    client?: ISunglassesClient;
+    /** Rendered when an error is caught. Defaults to rendering nothing. */
+    fallback?: React$1.ReactNode;
+    /** Error capture configuration forwarded to `captureException`. */
+    config?: CaptureExceptionOptions;
+    children: React$1.ReactNode;
+}
+/**
+ * React Native error boundary that captures render-phase errors as SunGlasses
+ * `$error` events (`$error_handled: true`).
+ *
+ * The client is read from the nearest `<SunglassesProvider>` by default; pass
+ * an explicit `client` prop to override.
+ *
+ * @example
+ * ```tsx
+ * <SunglassesProvider client={client}>
+ *   <SunglassesErrorBoundary fallback={<ErrorScreen />}>
+ *     <App />
+ *   </SunglassesErrorBoundary>
+ * </SunglassesProvider>
+ * ```
+ */
+declare function SunglassesErrorBoundary(props: SunglassesErrorBoundaryProps): React$1.ReactElement;
+
+export { SunglassesErrorBoundary, type SunglassesErrorBoundaryProps, SunglassesProvider, type SunglassesProviderProps, captureDeepLinkUtmParams, useExpoRouterScreenTracking, useExpoRouterUtmCapture, useLinkingUtmCapture, useNavigationScreenTracking, useSunglasses };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,14 +17,24 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  SunglassesCore: () => import_sunglasses_core.SunglassesCore,
+  SunglassesCore: () => import_sunglasses_core3.SunglassesCore,
+  SunglassesErrorBoundary: () => SunglassesErrorBoundary,
   SunglassesProvider: () => SunglassesProvider,
   captureDeepLinkUtmParams: () => captureDeepLinkUtmParams,
+  captureException: () => import_sunglasses_core3.captureException,
   useExpoRouterScreenTracking: () => useExpoRouterScreenTracking,
   useExpoRouterUtmCapture: () => useExpoRouterUtmCapture,
   useLinkingUtmCapture: () => useLinkingUtmCapture,
@@ -34,6 +46,7 @@ module.exports = __toCommonJS(index_exports);
 // src/SunglassesProvider.tsx
 var import_react2 = require("react");
 var import_react_native = require("react-native");
+var import_sunglasses_core = require("@drakkar.software/sunglasses-core");
 
 // src/context.ts
 var import_react = require("react");
@@ -52,6 +65,7 @@ function useSunglasses() {
 var import_jsx_runtime = require("react/jsx-runtime");
 function SunglassesProvider({
   client,
+  autoCaptureErrors,
   children
 }) {
   (0, import_react2.useEffect)(() => {
@@ -60,6 +74,19 @@ function SunglassesProvider({
       });
     };
   }, [client]);
+  (0, import_react2.useEffect)(() => {
+    if (!autoCaptureErrors) return;
+    if (typeof ErrorUtils === "undefined" || !ErrorUtils.setGlobalHandler) return;
+    const options = typeof autoCaptureErrors === "object" ? autoCaptureErrors : {};
+    const previous = ErrorUtils.getGlobalHandler?.();
+    ErrorUtils.setGlobalHandler((error, isFatal) => {
+      (0, import_sunglasses_core.captureException)(client, error, { handled: false, ...options });
+      previous?.(error, isFatal);
+    });
+    return () => {
+      if (previous) ErrorUtils.setGlobalHandler?.(previous);
+    };
+  }, [client, autoCaptureErrors]);
   (0, import_react2.useEffect)(() => {
     const subscription = import_react_native.AppState.addEventListener("change", (nextState) => {
       if (nextState === "background") {
@@ -198,13 +225,47 @@ function useExpoRouterUtmCapture(client) {
   }, [params, client]);
 }
 
+// src/SunglassesErrorBoundary.tsx
+var import_react7 = __toESM(require("react"));
+var import_sunglasses_core2 = require("@drakkar.software/sunglasses-core");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var ErrorBoundaryInner = class extends import_react7.default.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    const { client, config } = this.props;
+    (0, import_sunglasses_core2.captureException)(client, error, { handled: true, ...config });
+  }
+  render() {
+    if (this.state.hasError) return this.props.fallback ?? null;
+    return this.props.children;
+  }
+};
+function SunglassesErrorBoundary(props) {
+  const contextClient = (0, import_react7.useContext)(SunglassesContext);
+  const client = props.client ?? contextClient;
+  if (client === null) {
+    throw new Error(
+      "[SunGlasses] <SunglassesErrorBoundary> must be inside a <SunglassesProvider> or receive a `client` prop."
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ErrorBoundaryInner, { ...props, client });
+}
+
 // src/index.ts
-var import_sunglasses_core = require("@drakkar.software/sunglasses-core");
+var import_sunglasses_core3 = require("@drakkar.software/sunglasses-core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SunglassesCore,
+  SunglassesErrorBoundary,
   SunglassesProvider,
   captureDeepLinkUtmParams,
+  captureException,
   useExpoRouterScreenTracking,
   useExpoRouterUtmCapture,
   useLinkingUtmCapture,

package/dist/index.mjs

@@ -8,6 +8,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/SunglassesProvider.tsx
 import { useEffect } from "react";
 import { AppState } from "react-native";
+import { captureException } from "@drakkar.software/sunglasses-core";
 
 // src/context.ts
 import { createContext, useContext } from "react";
@@ -26,6 +27,7 @@ function useSunglasses() {
 import { jsx } from "react/jsx-runtime";
 function SunglassesProvider({
   client,
+  autoCaptureErrors,
   children
 }) {
   useEffect(() => {
@@ -34,6 +36,19 @@ function SunglassesProvider({
       });
     };
   }, [client]);
+  useEffect(() => {
+    if (!autoCaptureErrors) return;
+    if (typeof ErrorUtils === "undefined" || !ErrorUtils.setGlobalHandler) return;
+    const options = typeof autoCaptureErrors === "object" ? autoCaptureErrors : {};
+    const previous = ErrorUtils.getGlobalHandler?.();
+    ErrorUtils.setGlobalHandler((error, isFatal) => {
+      captureException(client, error, { handled: false, ...options });
+      previous?.(error, isFatal);
+    });
+    return () => {
+      if (previous) ErrorUtils.setGlobalHandler?.(previous);
+    };
+  }, [client, autoCaptureErrors]);
   useEffect(() => {
     const subscription = AppState.addEventListener("change", (nextState) => {
       if (nextState === "background") {
@@ -172,12 +187,46 @@ function useExpoRouterUtmCapture(client) {
   }, [params, client]);
 }
 
+// src/SunglassesErrorBoundary.tsx
+import React2, { useContext as useContext2 } from "react";
+import { captureException as captureException2 } from "@drakkar.software/sunglasses-core";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var ErrorBoundaryInner = class extends React2.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    const { client, config } = this.props;
+    captureException2(client, error, { handled: true, ...config });
+  }
+  render() {
+    if (this.state.hasError) return this.props.fallback ?? null;
+    return this.props.children;
+  }
+};
+function SunglassesErrorBoundary(props) {
+  const contextClient = useContext2(SunglassesContext);
+  const client = props.client ?? contextClient;
+  if (client === null) {
+    throw new Error(
+      "[SunGlasses] <SunglassesErrorBoundary> must be inside a <SunglassesProvider> or receive a `client` prop."
+    );
+  }
+  return /* @__PURE__ */ jsx2(ErrorBoundaryInner, { ...props, client });
+}
+
 // src/index.ts
-import { SunglassesCore } from "@drakkar.software/sunglasses-core";
+import { SunglassesCore, captureException as captureException3 } from "@drakkar.software/sunglasses-core";
 export {
   SunglassesCore,
+  SunglassesErrorBoundary,
   SunglassesProvider,
   captureDeepLinkUtmParams,
+  captureException3 as captureException,
   useExpoRouterScreenTracking,
   useExpoRouterUtmCapture,
   useLinkingUtmCapture,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakkar.software/sunglasses-react-native",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "React Native / Expo 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.8.0"
+    "@drakkar.software/sunglasses-core": "0.10.0"
   },
   "peerDependencies": {
     "expo-router": ">=3.0.0",