@lark.js/sentry 0.0.7 → 0.0.8

package/dist/package.json.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e="0.0.7",r={version:e};exports.default=r,exports.version=e;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e="0.0.8",r={version:e};exports.default=r,exports.version=e;

package/dist/package.json.js

@@ -1 +1 @@
-var a="0.0.7",e={version:a};export{e as default,a as version};
+var a="0.0.8",e={version:a};export{e as default,a as version};

package/dist/public/react-error-boundary.cjs

@@ -1 +1 @@
-"use strict";var r=require("react"),e=require("../types/enums.cjs"),t=require("./framework-error.cjs");class o extends r.Component{state={error:null,errorInfo:null};componentDidCatch(r,o){this.setState({error:r,errorInfo:o}),t.reportFrameworkError({type:e.EventType.React,error:r,context:o})}render(){const{error:r,errorInfo:e}=this.state;if(r&&e){const{fallback:t}=this.props;return"function"==typeof t?t(r,e):t??null}return this.props.children??null}}exports.ReactErrorBoundary=o;
+"use strict";var r=require("react"),e=require("../types/enums.cjs"),t=require("./framework-error.cjs");class o extends r.Component{state={};static getDerivedStateFromError(r){return{error:r}}componentDidCatch(r,o){this.setState({error:r,errorInfo:o}),t.reportFrameworkError({type:e.EventType.React,error:r,context:o})}render(){const{error:r,errorInfo:e}=this.state;if(r){const{fallback:t}=this.props;return"function"==typeof t?t(r,e):t??null}return this.props.children??null}}exports.ReactErrorBoundary=o;

package/dist/public/react-error-boundary.d.ts

@@ -1,15 +1,100 @@
 import { Component, ReactNode, ErrorInfo } from 'react';
 
+/**
+ * Props for the {@link ReactErrorBoundary} component.
+ *
+ * The boundary renders `children` normally. When a descendant throws during
+ * rendering, it switches to rendering {@link fallback} and reports the error
+ * to the Sentry SDK.
+ */
 interface ReactErrorBoundaryProps {
+    /**
+     * The subtree to render when no error has occurred. When an error is
+     * caught, this is replaced by {@link fallback}.
+     */
     readonly children?: ReactNode;
-    readonly fallback?: ReactNode | ((error: Error, errorInfo: ErrorInfo) => ReactNode);
+    /**
+     * The UI to display when a descendant throws.
+     *
+     * Can be a static `ReactNode` (no access to the error) or a render function
+     * that receives the caught error and React's component-stack info.
+     *
+     * @remarks
+     * The render function may be invoked twice during an error cycle:
+     *   1. First, right after `getDerivedStateFromError` runs in the render
+     *      phase — at this point `errorInfo` is still `undefined` because React
+     *      only delivers {@link ErrorInfo} in `componentDidCatch` (commit phase).
+     *   2. Again after `componentDidCatch` merges `errorInfo` into state.
+     *
+     * Therefore `errorInfo` is typed as optional. Guard against `undefined` if
+     * your fallback relies on `componentStack`.
+     *
+     * @param error - The Error thrown by the descendant component. Always
+     *   defined when the fallback is invoked, because the boundary only enters
+     *   the error state when an Error is present.
+     * @param errorInfo - React's {@link ErrorInfo}, containing `componentStack`.
+     *   `undefined` on the first render after the error is caught.
+     * @returns The fallback React subtree to render.
+     */
+    readonly fallback?: ReactNode | ((error: Error, errorInfo?: ErrorInfo) => ReactNode);
 }
+/** Internal state tracking the caught error and React component-stack info. */
 interface ReactErrorBoundaryState {
-    readonly error: Error | null;
-    readonly errorInfo: ErrorInfo | null;
+    readonly error?: Error;
+    readonly errorInfo?: ErrorInfo;
 }
+/**
+ * A React Error Boundary that reports caught errors to the Sentry SDK.
+ *
+ * @example
+ * ```tsx
+ * <ReactErrorBoundary fallback={<div>Something went wrong</div>}>
+ *   <Page />
+ * </ReactErrorBoundary>
+ * ```
+ */
 declare class ReactErrorBoundary extends Component<ReactErrorBoundaryProps, ReactErrorBoundaryState> {
     state: ReactErrorBoundaryState;
+    /**
+     * Called by React during the **render phase** when a descendant throws.
+     *
+     * This is a pure static method — it must not access `this` or cause side
+     * effects. Its sole responsibility is to return the next state so React can
+     * immediately re-render the boundary and show the fallback UI without
+     * waiting for the commit phase.
+     *
+     * Only `error` is available here; React does not deliver {@link ErrorInfo}
+     * until {@link componentDidCatch} runs (commit phase), so `errorInfo` is
+     * left `undefined` at this point.
+     *
+     * This method is **not redundant** with {@link componentDidCatch}. It
+     * triggers the fallback render synchronously in the render phase; without
+     * it the fallback would not appear until after commit.
+     *
+     * @param error - The Error thrown by the descendant component.
+     * @returns The next state, setting `error` so the boundary renders the
+     *   fallback.
+     */
+    static getDerivedStateFromError(error: Error): ReactErrorBoundaryState;
+    /**
+     * Called by React during the **commit phase** (after the DOM has been
+     * updated) when a descendant throws.
+     *
+     * This is where side effects belong. It performs two duties:
+     *   1. Merges `errorInfo` (React's component-stack trace) into state so the
+     *      fallback render function can access it. `error` is also set again —
+     *      it is already present from
+     *      {@link getDerivedStateFromError | getDerivedStateFromError} but is
+     *      included for a single atomic state update.
+     *   2. Reports the error to the Sentry SDK as a `React` event via
+     *      {@link reportFrameworkError}.
+     *
+     * @param error - The Error thrown by the descendant component.
+     * @param errorInfo - React's {@link ErrorInfo}, containing `componentStack`:
+     *   a string describing the component tree from the throwing component up to
+     *   this boundary. Useful for locating where in the component hierarchy the
+     *   error originated.
+     */
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
     render(): ReactNode;
 }

package/dist/public/react-error-boundary.js

@@ -1 +1 @@
-import{Component as r}from"react";import{EventType as t}from"../types/enums.js";import{reportFrameworkError as e}from"./framework-error.js";class o extends r{state={error:null,errorInfo:null};componentDidCatch(r,o){this.setState({error:r,errorInfo:o}),e({type:t.React,error:r,context:o})}render(){const{error:r,errorInfo:t}=this.state;if(r&&t){const{fallback:e}=this.props;return"function"==typeof e?e(r,t):e??null}return this.props.children??null}}export{o as ReactErrorBoundary};
+import{Component as r}from"react";import{EventType as t}from"../types/enums.js";import{reportFrameworkError as e}from"./framework-error.js";class o extends r{state={};static getDerivedStateFromError(r){return{error:r}}componentDidCatch(r,o){this.setState({error:r,errorInfo:o}),e({type:t.React,error:r,context:o})}render(){const{error:r,errorInfo:t}=this.state;if(r){const{fallback:e}=this.props;return"function"==typeof e?e(r,t):e??null}return this.props.children??null}}export{o as ReactErrorBoundary};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark.js/sentry",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "sentry sdk",
   "keywords": [
     "sdk",
@@ -54,22 +54,26 @@
     "test:coverage": "vitest run --config ./vitest.config.ts --coverage",
     "typecheck": "tsc --noEmit",
     "vite7": "pnpm add -D vite7@npm:vite@7.3.3",
-    "format": "oxfmt --write ./"
+    "format": "oxfmt --write ./",
+    "build": "rollup -c ./rollup.config.ts",
+    "build:tsup": "tsup --config ./tsup.config.ts"
   },
   "dependencies": {
     "@fingerprintjs/fingerprintjs": "^5.2.0",
     "@rrweb/record": "2.0.0-alpha.20",
-    "pako": "^2.1.0",
+    "pako": "^2.2.0",
     "ua-parser-js": "^2.0.10",
     "web-vitals": "^5.3.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.3",
+    "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
     "@rollup/plugin-typescript": "^12.3.0",
     "@rrweb/record": "2.0.0-alpha.20",
-    "@types/node": "^25.9.2",
+    "@types/node": "^25.9.4",
     "@types/pako": "^2.0.4",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
@@ -77,14 +81,16 @@
     "jsdom": "^24.1.3",
     "oxfmt": "^0.54.0",
     "react": "^19.2.7",
-    "rollup": "^4.61.1",
+    "rollup": "^4.62.2",
+    "rollup-plugin-dts": "^6.4.1",
+    "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vite": "^8.0.16",
+    "vite": "^8.1.0",
     "vite7": "npm:vite@7.3.3",
     "vitest": "^1.6.1",
-    "vue": "^3.5.35",
-    "webpack": "^5.107.2",
-    "webpack-dev-server": "^5.2.4"
+    "vue": "^3.5.39",
+    "webpack": "^5.108.1",
+    "webpack-dev-server": "^5.2.5"
   },
   "peerDependencies": {
     "react": "^19.0.0",