react-component-error-boundary 1.0.3

package/README.md

@@ -0,0 +1,51 @@
+# react-component-boundary
+
+A lightweight, reusable Error Boundary for React components that follows clean component design principles.
+
+## Installation
+
+```bash
+npm install react-component-error-boundary
+```
+
+## Basic Usage
+
+```jsx
+import { ErrorBoundary } from "react-component-boundary";
+
+<ErrorBoundary customErrorMessage="Something went wrong">
+  <YourComponent />
+</ErrorBoundary>;
+```
+
+## Custom Error UI
+
+```jsx
+<ErrorBoundary fallback={<div>Custom Error UI</div>}>
+  <YourComponent />
+</ErrorBoundary>
+```
+
+## Props API
+
+```ts
+interface ErrorBoundaryProps {
+  children: React.ReactNode;
+  customErrorMessage?: string;
+  fallback?: React.ReactNode;
+}
+```
+
+# Why this package?
+
+React Error Boundaries often become:
+
+- tightly coupled
+- hard to reuse
+- mixed with UI logic
+
+This package keeps it simple and flexible:
+
+- Parent owns state
+- Child only renders
+- Error UI is fully customizable

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+
+interface ErrorBoundaryProps {
+    children: React.ReactNode;
+    customErrorMessage?: string;
+    className?: string;
+    fallback: React.ReactNode;
+    onError?: (hasError: boolean) => void;
+    resetKey?: number;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    componentDidUpdate(prevProps: Readonly<ErrorBoundaryProps>, prevState: Readonly<ErrorBoundaryState>): void;
+    private logErrorToMyService;
+    render(): React.ReactNode;
+}
+
+export { ErrorBoundary, type ErrorBoundaryProps };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+
+interface ErrorBoundaryProps {
+    children: React.ReactNode;
+    customErrorMessage?: string;
+    className?: string;
+    fallback: React.ReactNode;
+    onError?: (hasError: boolean) => void;
+    resetKey?: number;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    componentDidUpdate(prevProps: Readonly<ErrorBoundaryProps>, prevState: Readonly<ErrorBoundaryState>): void;
+    private logErrorToMyService;
+    render(): React.ReactNode;
+}
+
+export { ErrorBoundary, type ErrorBoundaryProps };

package/dist/index.js

@@ -0,0 +1,88 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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, {
+  ErrorBoundary: () => ErrorBoundary
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/ErrorBoundary.tsx
+var React = __toESM(require("react"));
+var import_jsx_runtime = require("react/jsx-runtime");
+var ErrorBoundary = class extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = { hasError: false, error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  componentDidCatch(error, errorInfo) {
+    var _a, _b, _c;
+    this.logErrorToMyService(
+      error,
+      (_a = errorInfo.componentStack) != null ? _a : void 0
+      // Note: React.captureOwnerStack() may not be available in all React versions
+      // Remove or conditionally use based on your React version
+    );
+    (_c = (_b = this.props).onError) == null ? void 0 : _c.call(_b, true);
+  }
+  componentDidUpdate(prevProps, prevState) {
+    var _a, _b;
+    if (this.props.resetKey !== void 0 && this.props.resetKey !== prevProps.resetKey && this.state.hasError) {
+      this.setState({ hasError: false, error: null });
+    }
+    if (prevState.hasError !== this.state.hasError) {
+      (_b = (_a = this.props).onError) == null ? void 0 : _b.call(_a, this.state.hasError);
+    }
+  }
+  logErrorToMyService(error, componentStack) {
+    console.error("Error caught by ErrorBoundary:");
+    console.error("Message:", error.message);
+    console.error("Stack:", error.stack);
+    console.error("Name:", error.name);
+    if (componentStack) {
+      console.error("Component stack:", componentStack);
+    }
+    console.error("Full error object:", error);
+  }
+  render() {
+    var _a;
+    if (this.state.hasError) {
+      return this.props.fallback || /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: this.props.className, children: (_a = this.props.customErrorMessage) != null ? _a : "Something went wrong." });
+    }
+    return this.props.children;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorBoundary
+});

package/dist/index.mjs

@@ -0,0 +1,51 @@
+// src/ErrorBoundary.tsx
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+var ErrorBoundary = class extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = { hasError: false, error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  componentDidCatch(error, errorInfo) {
+    var _a, _b, _c;
+    this.logErrorToMyService(
+      error,
+      (_a = errorInfo.componentStack) != null ? _a : void 0
+      // Note: React.captureOwnerStack() may not be available in all React versions
+      // Remove or conditionally use based on your React version
+    );
+    (_c = (_b = this.props).onError) == null ? void 0 : _c.call(_b, true);
+  }
+  componentDidUpdate(prevProps, prevState) {
+    var _a, _b;
+    if (this.props.resetKey !== void 0 && this.props.resetKey !== prevProps.resetKey && this.state.hasError) {
+      this.setState({ hasError: false, error: null });
+    }
+    if (prevState.hasError !== this.state.hasError) {
+      (_b = (_a = this.props).onError) == null ? void 0 : _b.call(_a, this.state.hasError);
+    }
+  }
+  logErrorToMyService(error, componentStack) {
+    console.error("Error caught by ErrorBoundary:");
+    console.error("Message:", error.message);
+    console.error("Stack:", error.stack);
+    console.error("Name:", error.name);
+    if (componentStack) {
+      console.error("Component stack:", componentStack);
+    }
+    console.error("Full error object:", error);
+  }
+  render() {
+    var _a;
+    if (this.state.hasError) {
+      return this.props.fallback || /* @__PURE__ */ jsx("div", { className: this.props.className, children: (_a = this.props.customErrorMessage) != null ? _a : "Something went wrong." });
+    }
+    return this.props.children;
+  }
+};
+export {
+  ErrorBoundary
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "react-component-error-boundary",
+  "version": "1.0.3",
+  "access": "public",
+  "description": "A reusable React Error Boundary",
+  "keywords": [
+    "react",
+    "error-boundary",
+    "next"
+  ],
+  "license": "ISC",
+  "author": "Ajay Yadav",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8",
+    "react-dom": ">=16.8"
+  },
+  "dependencies": {
+    "react": ">=16.8",
+    "react-dom": ">=16.8"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}