@codeserk/forge-stats-react 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 codeserk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# @codeserk/forge-stats-react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React plugin for [`@codeserk/forge-stats`](../stats/README.md). It re-exports the whole core client, so a React app imports this package alone. The core is a peer dependency, installed with it by npm 7+, so the app always has a single client. Uncaught errors already reach `captureGlobalErrors`; the React tools add their component stack and the errors React error boundaries catch. Every tool is optional, pick the ones you need.
+
+## Installation
+
+```bash
+npm install @codeserk/forge-stats-react
+```
+
+## Usage
+
+Create the plugin, pass it to `init`, then use the tools you need. They report through the client `init` created:
+
+```tsx
+import { captureGlobalErrors, init, reactPlugin } from '@codeserk/forge-stats-react'
+
+export const react = reactPlugin()
+
+init({ sdk: 'YOUR_SDK_KEY', appVersion: '1.2.3', plugins: [react] })
+captureGlobalErrors()
+```
+
+### Error boundary
+
+Any React version. Tracks the errors of its children as handled and renders the fallback:
+
+```tsx
+<react.ErrorBoundary fallback={(error) => <Oops message={error.message} />}>
+  <App />
+</react.ErrorBoundary>
+```
+
+### Root error handlers
+
+React 19. Tracks every uncaught error and every error a boundary caught, logs it with `console.error` as React does, then calls your handler:
+
+```tsx
+createRoot(container, {
+  onUncaughtError: react.errorHandler(),
+  onCaughtError: react.errorHandler(showErrorToast),
+}).render(<App />)
+```
+
+### Your own boundary
+
+```tsx
+componentDidCatch(error: Error, errorInfo: ErrorInfo) {
+  react.captureError(error, errorInfo)
+}
+```
+
+A tool used before the plugin is set up by `init` only warns.

package/dist/index.cjs

@@ -0,0 +1,118 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/capture.const.ts
+const REACT_FRAMEWORK = "react";
+//#endregion
+//#region src/capture.ts
+/**
+* Returns a capture that tracks the error with its component stack, or only warns before the plugin is set up.
+* @param getClient returns undefined until the plugin is set up
+* @returns the capture
+*/
+function createReactCapture(getClient) {
+	return (thrown, errorInfo, handled = true) => {
+		const client = getClient();
+		if (!client) {
+			console.warn("[forge-stats] The react plugin is not set up, add it to the plugins of init");
+			return;
+		}
+		const error = thrown instanceof Error ? thrown : new Error(String(thrown));
+		client.trackError(error, {
+			handled,
+			componentStack: errorInfo.componentStack ?? void 0,
+			framework: REACT_FRAMEWORK
+		});
+	};
+}
+//#endregion
+//#region src/error-boundary.ts
+/**
+* Returns an error boundary that tracks the errors of its children and renders the fallback.
+* @param capture
+* @returns the error boundary component
+*/
+function createErrorBoundary(capture) {
+	return class ForgeErrorBoundary extends react.Component {
+		constructor(..._args) {
+			super(..._args);
+			this.state = {};
+		}
+		/**
+		* Returns the state with what the children threw, as an error.
+		* @param thrown
+		* @returns the state
+		*/
+		static getDerivedStateFromError(thrown) {
+			return { error: thrown instanceof Error ? thrown : new Error(String(thrown)) };
+		}
+		/**
+		* Tracks the error as handled, then calls `onError`.
+		* @param error
+		* @param errorInfo
+		*/
+		componentDidCatch(error, errorInfo) {
+			capture(error, errorInfo);
+			this.props.onError?.(error, errorInfo);
+		}
+		/**
+		* Returns the children, or the fallback once they threw.
+		* @returns the children or the fallback
+		*/
+		render() {
+			const { error } = this.state;
+			if (!error) return this.props.children ?? null;
+			const { fallback } = this.props;
+			return typeof fallback === "function" ? fallback(error) : fallback ?? null;
+		}
+	};
+}
+//#endregion
+//#region src/error-handler.ts
+/**
+* Returns a `createRoot` error handler that tracks the error, logs it as React does, then calls the callback.
+* @param capture
+* @param callback
+* @returns the root error handler
+*/
+function createErrorHandler(capture, callback) {
+	return (error, errorInfo) => {
+		capture(error, errorInfo, errorInfo.errorBoundary !== void 0);
+		console.error(error);
+		callback?.(error, errorInfo);
+	};
+}
+//#endregion
+//#region src/plugin.const.ts
+const REACT_PLUGIN_NAME = "react";
+//#endregion
+//#region src/plugin.ts
+/**
+* Returns the React plugin for `init`; its tools track errors through the client `init` created.
+* @returns the plugin
+*/
+function reactPlugin() {
+	let client;
+	const captureError = createReactCapture(() => client);
+	return {
+		name: REACT_PLUGIN_NAME,
+		setup: (pluginClient) => {
+			client = pluginClient;
+		},
+		ErrorBoundary: createErrorBoundary(captureError),
+		errorHandler: (callback) => createErrorHandler(captureError, callback),
+		captureError
+	};
+}
+//#endregion
+exports.reactPlugin = reactPlugin;
+var _codeserk_forge_stats = require("@codeserk/forge-stats");
+Object.keys(_codeserk_forge_stats).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _codeserk_forge_stats[k];
+		}
+	});
+});
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Component"],"sources":["../src/capture.const.ts","../src/capture.ts","../src/error-boundary.ts","../src/error-handler.ts","../src/plugin.const.ts","../src/plugin.ts"],"sourcesContent":["export const REACT_FRAMEWORK = 'react'\n","import type { Client } from '@codeserk/forge-stats'\n\nimport { REACT_FRAMEWORK } from './capture.const'\nimport type { ReactCapture } from './capture.types'\n\n/**\n * Returns a capture that tracks the error with its component stack, or only warns before the plugin is set up.\n * @param getClient returns undefined until the plugin is set up\n * @returns the capture\n */\nexport function createReactCapture(getClient: () => Client | undefined): ReactCapture {\n  return (thrown, errorInfo, handled = true) => {\n    const client = getClient()\n    if (!client) {\n      console.warn('[forge-stats] The react plugin is not set up, add it to the plugins of init')\n      return\n    }\n\n    const error = thrown instanceof Error ? thrown : new Error(String(thrown))\n    client.trackError(error, {\n      handled,\n      componentStack: errorInfo.componentStack ?? undefined,\n      framework: REACT_FRAMEWORK,\n    })\n  }\n}\n","import { Component, type ComponentClass, type ErrorInfo, type ReactNode } from 'react'\n\nimport type { ReactCapture } from './capture.types'\nimport type { ForgeErrorBoundaryProps, ForgeErrorBoundaryState } from './error-boundary.types'\n\n/**\n * Returns an error boundary that tracks the errors of its children and renders the fallback.\n * @param capture\n * @returns the error boundary component\n */\nexport function createErrorBoundary(\n  capture: ReactCapture,\n): ComponentClass<ForgeErrorBoundaryProps, ForgeErrorBoundaryState> {\n  return class ForgeErrorBoundary extends Component<\n    ForgeErrorBoundaryProps,\n    ForgeErrorBoundaryState\n  > {\n    override state: ForgeErrorBoundaryState = {}\n\n    /**\n     * Returns the state with what the children threw, as an error.\n     * @param thrown\n     * @returns the state\n     */\n    static getDerivedStateFromError(thrown: unknown): ForgeErrorBoundaryState {\n      return { error: thrown instanceof Error ? thrown : new Error(String(thrown)) }\n    }\n\n    /**\n     * Tracks the error as handled, then calls `onError`.\n     * @param error\n     * @param errorInfo\n     */\n    override componentDidCatch(error: Error, errorInfo: ErrorInfo): void {\n      capture(error, errorInfo)\n      this.props.onError?.(error, errorInfo)\n    }\n\n    /**\n     * Returns the children, or the fallback once they threw.\n     * @returns the children or the fallback\n     */\n    override render(): ReactNode {\n      const { error } = this.state\n      if (!error) {\n        return this.props.children ?? null\n      }\n\n      const { fallback } = this.props\n\n      return typeof fallback === 'function' ? fallback(error) : (fallback ?? null)\n    }\n  }\n}\n","import type { ReactCapture } from './capture.types'\nimport type { ForgeErrorHandler } from './error-handler.types'\n\n/**\n * Returns a `createRoot` error handler that tracks the error, logs it as React does, then calls the callback.\n * @param capture\n * @param callback\n * @returns the root error handler\n */\nexport function createErrorHandler(\n  capture: ReactCapture,\n  callback?: ForgeErrorHandler,\n): ForgeErrorHandler {\n  return (error, errorInfo) => {\n    capture(error, errorInfo, errorInfo.errorBoundary !== undefined)\n    console.error(error)\n    callback?.(error, errorInfo)\n  }\n}\n","export const REACT_PLUGIN_NAME = 'react'\n","import type { Client } from '@codeserk/forge-stats'\n\nimport { createReactCapture } from './capture'\nimport { createErrorBoundary } from './error-boundary'\nimport { createErrorHandler } from './error-handler'\nimport { REACT_PLUGIN_NAME } from './plugin.const'\nimport type { ReactPlugin } from './plugin.types'\n\n/**\n * Returns the React plugin for `init`; its tools track errors through the client `init` created.\n * @returns the plugin\n */\nexport function reactPlugin(): ReactPlugin {\n  let client: Client | undefined\n  const captureError = createReactCapture(() => client)\n\n  return {\n    name: REACT_PLUGIN_NAME,\n    setup: (pluginClient) => {\n      client = pluginClient\n    },\n    ErrorBoundary: createErrorBoundary(captureError),\n    errorHandler: (callback) => createErrorHandler(captureError, callback),\n    captureError,\n  }\n}\n"],"mappings":";;;AAAA,MAAa,kBAAkB;;;;;;;;ACU/B,SAAgB,mBAAmB,WAAmD;AACpF,SAAQ,QAAQ,WAAW,UAAU,SAAS;EAC5C,MAAM,SAAS,WAAW;AAC1B,MAAI,CAAC,QAAQ;AACX,WAAQ,KAAK,8EAA8E;AAC3F;;EAGF,MAAM,QAAQ,kBAAkB,QAAQ,SAAS,IAAI,MAAM,OAAO,OAAO,CAAC;AAC1E,SAAO,WAAW,OAAO;GACvB;GACA,gBAAgB,UAAU,kBAAkB,KAAA;GAC5C,WAAW;GACZ,CAAC;;;;;;;;;;ACbN,SAAgB,oBACd,SACkE;AAClE,QAAO,MAAM,2BAA2BA,MAAAA,UAGtC;;;gBAC0C,EAAE;;;;;;;EAO5C,OAAO,yBAAyB,QAA0C;AACxE,UAAO,EAAE,OAAO,kBAAkB,QAAQ,SAAS,IAAI,MAAM,OAAO,OAAO,CAAC,EAAE;;;;;;;EAQhF,kBAA2B,OAAc,WAA4B;AACnE,WAAQ,OAAO,UAAU;AACzB,QAAK,MAAM,UAAU,OAAO,UAAU;;;;;;EAOxC,SAA6B;GAC3B,MAAM,EAAE,UAAU,KAAK;AACvB,OAAI,CAAC,MACH,QAAO,KAAK,MAAM,YAAY;GAGhC,MAAM,EAAE,aAAa,KAAK;AAE1B,UAAO,OAAO,aAAa,aAAa,SAAS,MAAM,GAAI,YAAY;;;;;;;;;;;;ACzC7E,SAAgB,mBACd,SACA,UACmB;AACnB,SAAQ,OAAO,cAAc;AAC3B,UAAQ,OAAO,WAAW,UAAU,kBAAkB,KAAA,EAAU;AAChE,UAAQ,MAAM,MAAM;AACpB,aAAW,OAAO,UAAU;;;;;AChBhC,MAAa,oBAAoB;;;;;;;ACYjC,SAAgB,cAA2B;CACzC,IAAI;CACJ,MAAM,eAAe,yBAAyB,OAAO;AAErD,QAAO;EACL,MAAM;EACN,QAAQ,iBAAiB;AACvB,YAAS;;EAEX,eAAe,oBAAoB,aAAa;EAChD,eAAe,aAAa,mBAAmB,cAAc,SAAS;EACtE;EACD"}

package/dist/index.d.cts

@@ -0,0 +1,43 @@
+import { StatsPlugin } from "@codeserk/forge-stats";
+import { ComponentClass, ErrorInfo, ReactNode } from "react";
+export * from "@codeserk/forge-stats";
+
+//#region src/capture.types.d.ts
+interface ReactErrorInfo {
+  readonly componentStack?: string | null;
+  /** Only set for errors a boundary caught. */
+  readonly errorBoundary?: unknown;
+}
+type ReactCapture = (thrown: unknown, errorInfo: ReactErrorInfo, handled?: boolean) => void;
+//#endregion
+//#region src/error-boundary.types.d.ts
+interface ForgeErrorBoundaryProps {
+  readonly children?: ReactNode;
+  /** Rendered instead of the children once they threw, nothing when absent. */
+  readonly fallback?: ReactNode | ((error: Error) => ReactNode);
+  /** Called after the error is tracked. */
+  readonly onError?: (error: Error, errorInfo: ErrorInfo) => void;
+}
+interface ForgeErrorBoundaryState {
+  readonly error?: Error;
+}
+//#endregion
+//#region src/error-handler.types.d.ts
+type ForgeErrorHandler = (error: unknown, errorInfo: ReactErrorInfo) => void;
+//#endregion
+//#region src/plugin.types.d.ts
+interface ReactPlugin extends StatsPlugin {
+  readonly ErrorBoundary: ComponentClass<ForgeErrorBoundaryProps, ForgeErrorBoundaryState>;
+  errorHandler(callback?: ForgeErrorHandler): ForgeErrorHandler;
+  readonly captureError: ReactCapture;
+}
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * Returns the React plugin for `init`; its tools track errors through the client `init` created.
+ * @returns the plugin
+ */
+declare function reactPlugin(): ReactPlugin;
+//#endregion
+export { type ForgeErrorBoundaryProps, type ForgeErrorBoundaryState, type ForgeErrorHandler, type ReactCapture, type ReactErrorInfo, type ReactPlugin, reactPlugin };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,43 @@
+import { StatsPlugin } from "@codeserk/forge-stats";
+import { ComponentClass, ErrorInfo, ReactNode } from "react";
+export * from "@codeserk/forge-stats";
+
+//#region src/capture.types.d.ts
+interface ReactErrorInfo {
+  readonly componentStack?: string | null;
+  /** Only set for errors a boundary caught. */
+  readonly errorBoundary?: unknown;
+}
+type ReactCapture = (thrown: unknown, errorInfo: ReactErrorInfo, handled?: boolean) => void;
+//#endregion
+//#region src/error-boundary.types.d.ts
+interface ForgeErrorBoundaryProps {
+  readonly children?: ReactNode;
+  /** Rendered instead of the children once they threw, nothing when absent. */
+  readonly fallback?: ReactNode | ((error: Error) => ReactNode);
+  /** Called after the error is tracked. */
+  readonly onError?: (error: Error, errorInfo: ErrorInfo) => void;
+}
+interface ForgeErrorBoundaryState {
+  readonly error?: Error;
+}
+//#endregion
+//#region src/error-handler.types.d.ts
+type ForgeErrorHandler = (error: unknown, errorInfo: ReactErrorInfo) => void;
+//#endregion
+//#region src/plugin.types.d.ts
+interface ReactPlugin extends StatsPlugin {
+  readonly ErrorBoundary: ComponentClass<ForgeErrorBoundaryProps, ForgeErrorBoundaryState>;
+  errorHandler(callback?: ForgeErrorHandler): ForgeErrorHandler;
+  readonly captureError: ReactCapture;
+}
+//#endregion
+//#region src/plugin.d.ts
+/**
+ * Returns the React plugin for `init`; its tools track errors through the client `init` created.
+ * @returns the plugin
+ */
+declare function reactPlugin(): ReactPlugin;
+//#endregion
+export { type ForgeErrorBoundaryProps, type ForgeErrorBoundaryState, type ForgeErrorHandler, type ReactCapture, type ReactErrorInfo, type ReactPlugin, reactPlugin };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,109 @@
+import { Component } from "react";
+export * from "@codeserk/forge-stats";
+//#region src/capture.const.ts
+const REACT_FRAMEWORK = "react";
+//#endregion
+//#region src/capture.ts
+/**
+* Returns a capture that tracks the error with its component stack, or only warns before the plugin is set up.
+* @param getClient returns undefined until the plugin is set up
+* @returns the capture
+*/
+function createReactCapture(getClient) {
+	return (thrown, errorInfo, handled = true) => {
+		const client = getClient();
+		if (!client) {
+			console.warn("[forge-stats] The react plugin is not set up, add it to the plugins of init");
+			return;
+		}
+		const error = thrown instanceof Error ? thrown : new Error(String(thrown));
+		client.trackError(error, {
+			handled,
+			componentStack: errorInfo.componentStack ?? void 0,
+			framework: REACT_FRAMEWORK
+		});
+	};
+}
+//#endregion
+//#region src/error-boundary.ts
+/**
+* Returns an error boundary that tracks the errors of its children and renders the fallback.
+* @param capture
+* @returns the error boundary component
+*/
+function createErrorBoundary(capture) {
+	return class ForgeErrorBoundary extends Component {
+		constructor(..._args) {
+			super(..._args);
+			this.state = {};
+		}
+		/**
+		* Returns the state with what the children threw, as an error.
+		* @param thrown
+		* @returns the state
+		*/
+		static getDerivedStateFromError(thrown) {
+			return { error: thrown instanceof Error ? thrown : new Error(String(thrown)) };
+		}
+		/**
+		* Tracks the error as handled, then calls `onError`.
+		* @param error
+		* @param errorInfo
+		*/
+		componentDidCatch(error, errorInfo) {
+			capture(error, errorInfo);
+			this.props.onError?.(error, errorInfo);
+		}
+		/**
+		* Returns the children, or the fallback once they threw.
+		* @returns the children or the fallback
+		*/
+		render() {
+			const { error } = this.state;
+			if (!error) return this.props.children ?? null;
+			const { fallback } = this.props;
+			return typeof fallback === "function" ? fallback(error) : fallback ?? null;
+		}
+	};
+}
+//#endregion
+//#region src/error-handler.ts
+/**
+* Returns a `createRoot` error handler that tracks the error, logs it as React does, then calls the callback.
+* @param capture
+* @param callback
+* @returns the root error handler
+*/
+function createErrorHandler(capture, callback) {
+	return (error, errorInfo) => {
+		capture(error, errorInfo, errorInfo.errorBoundary !== void 0);
+		console.error(error);
+		callback?.(error, errorInfo);
+	};
+}
+//#endregion
+//#region src/plugin.const.ts
+const REACT_PLUGIN_NAME = "react";
+//#endregion
+//#region src/plugin.ts
+/**
+* Returns the React plugin for `init`; its tools track errors through the client `init` created.
+* @returns the plugin
+*/
+function reactPlugin() {
+	let client;
+	const captureError = createReactCapture(() => client);
+	return {
+		name: REACT_PLUGIN_NAME,
+		setup: (pluginClient) => {
+			client = pluginClient;
+		},
+		ErrorBoundary: createErrorBoundary(captureError),
+		errorHandler: (callback) => createErrorHandler(captureError, callback),
+		captureError
+	};
+}
+//#endregion
+export { reactPlugin };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/capture.const.ts","../src/capture.ts","../src/error-boundary.ts","../src/error-handler.ts","../src/plugin.const.ts","../src/plugin.ts"],"sourcesContent":["export const REACT_FRAMEWORK = 'react'\n","import type { Client } from '@codeserk/forge-stats'\n\nimport { REACT_FRAMEWORK } from './capture.const'\nimport type { ReactCapture } from './capture.types'\n\n/**\n * Returns a capture that tracks the error with its component stack, or only warns before the plugin is set up.\n * @param getClient returns undefined until the plugin is set up\n * @returns the capture\n */\nexport function createReactCapture(getClient: () => Client | undefined): ReactCapture {\n  return (thrown, errorInfo, handled = true) => {\n    const client = getClient()\n    if (!client) {\n      console.warn('[forge-stats] The react plugin is not set up, add it to the plugins of init')\n      return\n    }\n\n    const error = thrown instanceof Error ? thrown : new Error(String(thrown))\n    client.trackError(error, {\n      handled,\n      componentStack: errorInfo.componentStack ?? undefined,\n      framework: REACT_FRAMEWORK,\n    })\n  }\n}\n","import { Component, type ComponentClass, type ErrorInfo, type ReactNode } from 'react'\n\nimport type { ReactCapture } from './capture.types'\nimport type { ForgeErrorBoundaryProps, ForgeErrorBoundaryState } from './error-boundary.types'\n\n/**\n * Returns an error boundary that tracks the errors of its children and renders the fallback.\n * @param capture\n * @returns the error boundary component\n */\nexport function createErrorBoundary(\n  capture: ReactCapture,\n): ComponentClass<ForgeErrorBoundaryProps, ForgeErrorBoundaryState> {\n  return class ForgeErrorBoundary extends Component<\n    ForgeErrorBoundaryProps,\n    ForgeErrorBoundaryState\n  > {\n    override state: ForgeErrorBoundaryState = {}\n\n    /**\n     * Returns the state with what the children threw, as an error.\n     * @param thrown\n     * @returns the state\n     */\n    static getDerivedStateFromError(thrown: unknown): ForgeErrorBoundaryState {\n      return { error: thrown instanceof Error ? thrown : new Error(String(thrown)) }\n    }\n\n    /**\n     * Tracks the error as handled, then calls `onError`.\n     * @param error\n     * @param errorInfo\n     */\n    override componentDidCatch(error: Error, errorInfo: ErrorInfo): void {\n      capture(error, errorInfo)\n      this.props.onError?.(error, errorInfo)\n    }\n\n    /**\n     * Returns the children, or the fallback once they threw.\n     * @returns the children or the fallback\n     */\n    override render(): ReactNode {\n      const { error } = this.state\n      if (!error) {\n        return this.props.children ?? null\n      }\n\n      const { fallback } = this.props\n\n      return typeof fallback === 'function' ? fallback(error) : (fallback ?? null)\n    }\n  }\n}\n","import type { ReactCapture } from './capture.types'\nimport type { ForgeErrorHandler } from './error-handler.types'\n\n/**\n * Returns a `createRoot` error handler that tracks the error, logs it as React does, then calls the callback.\n * @param capture\n * @param callback\n * @returns the root error handler\n */\nexport function createErrorHandler(\n  capture: ReactCapture,\n  callback?: ForgeErrorHandler,\n): ForgeErrorHandler {\n  return (error, errorInfo) => {\n    capture(error, errorInfo, errorInfo.errorBoundary !== undefined)\n    console.error(error)\n    callback?.(error, errorInfo)\n  }\n}\n","export const REACT_PLUGIN_NAME = 'react'\n","import type { Client } from '@codeserk/forge-stats'\n\nimport { createReactCapture } from './capture'\nimport { createErrorBoundary } from './error-boundary'\nimport { createErrorHandler } from './error-handler'\nimport { REACT_PLUGIN_NAME } from './plugin.const'\nimport type { ReactPlugin } from './plugin.types'\n\n/**\n * Returns the React plugin for `init`; its tools track errors through the client `init` created.\n * @returns the plugin\n */\nexport function reactPlugin(): ReactPlugin {\n  let client: Client | undefined\n  const captureError = createReactCapture(() => client)\n\n  return {\n    name: REACT_PLUGIN_NAME,\n    setup: (pluginClient) => {\n      client = pluginClient\n    },\n    ErrorBoundary: createErrorBoundary(captureError),\n    errorHandler: (callback) => createErrorHandler(captureError, callback),\n    captureError,\n  }\n}\n"],"mappings":";;;AAAA,MAAa,kBAAkB;;;;;;;;ACU/B,SAAgB,mBAAmB,WAAmD;AACpF,SAAQ,QAAQ,WAAW,UAAU,SAAS;EAC5C,MAAM,SAAS,WAAW;AAC1B,MAAI,CAAC,QAAQ;AACX,WAAQ,KAAK,8EAA8E;AAC3F;;EAGF,MAAM,QAAQ,kBAAkB,QAAQ,SAAS,IAAI,MAAM,OAAO,OAAO,CAAC;AAC1E,SAAO,WAAW,OAAO;GACvB;GACA,gBAAgB,UAAU,kBAAkB,KAAA;GAC5C,WAAW;GACZ,CAAC;;;;;;;;;;ACbN,SAAgB,oBACd,SACkE;AAClE,QAAO,MAAM,2BAA2B,UAGtC;;;gBAC0C,EAAE;;;;;;;EAO5C,OAAO,yBAAyB,QAA0C;AACxE,UAAO,EAAE,OAAO,kBAAkB,QAAQ,SAAS,IAAI,MAAM,OAAO,OAAO,CAAC,EAAE;;;;;;;EAQhF,kBAA2B,OAAc,WAA4B;AACnE,WAAQ,OAAO,UAAU;AACzB,QAAK,MAAM,UAAU,OAAO,UAAU;;;;;;EAOxC,SAA6B;GAC3B,MAAM,EAAE,UAAU,KAAK;AACvB,OAAI,CAAC,MACH,QAAO,KAAK,MAAM,YAAY;GAGhC,MAAM,EAAE,aAAa,KAAK;AAE1B,UAAO,OAAO,aAAa,aAAa,SAAS,MAAM,GAAI,YAAY;;;;;;;;;;;;ACzC7E,SAAgB,mBACd,SACA,UACmB;AACnB,SAAQ,OAAO,cAAc;AAC3B,UAAQ,OAAO,WAAW,UAAU,kBAAkB,KAAA,EAAU;AAChE,UAAQ,MAAM,MAAM;AACpB,aAAW,OAAO,UAAU;;;;;AChBhC,MAAa,oBAAoB;;;;;;;ACYjC,SAAgB,cAA2B;CACzC,IAAI;CACJ,MAAM,eAAe,yBAAyB,OAAO;AAErD,QAAO;EACL,MAAM;EACN,QAAQ,iBAAiB;AACvB,YAAS;;EAEX,eAAe,oBAAoB,aAAa;EAChD,eAAe,aAAa,mBAAmB,cAAc,SAAS;EACtE;EACD"}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@codeserk/forge-stats-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.0",
+  "description": "React plugin for Forge Stats. Error boundary and root error handlers that track errors with their component stack.",
+  "license": "MIT",
+  "keywords": [
+    "forge",
+    "analytics",
+    "stats",
+    "error-tracking",
+    "react"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "jest",
+    "lint": "eslint src",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "publish:dry": "npm publish --dry-run",
+    "publish:npm": "npm run build && npm publish"
+  },
+  "peerDependencies": {
+    "@codeserk/forge-stats": "^0.4.0",
+    "react": ">=16.8"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jest": "^30.3.0",
+    "jest-environment-jsdom": "^30.3.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "ts-jest": "^29.4.6",
+    "tsdown": "^0.21.4",
+    "typescript": "^5.7.0"
+  }
+}