@ttt-productions/monitoring-core 0.2.16 → 0.3.1

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { MonitoringInitOptions, MonitoringUser, MonitoringProvider, ScopeLike } from "./types.js";
-export { initMonitoring } from "./init.js";
+export type { MonitoringAdapter } from "./adapter.js";
+export { initMonitoring, getMonitoringAdapter, setMonitoringAdapter, resetMonitoringAdapter } from "./init.js";
 export { captureException, captureMessage, setUser, setTag, withScope, addBreadcrumb } from "./api.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvG,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvG,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { initMonitoring } from "./init.js";
+export { initMonitoring, getMonitoringAdapter, setMonitoringAdapter, resetMonitoringAdapter } from "./init.js";
 export { captureException, captureMessage, setUser, setTag, withScope, addBreadcrumb } from "./api.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/init.d.ts

@@ -2,4 +2,22 @@ import type { MonitoringAdapter } from "./adapter.js";
 import type { MonitoringInitOptions } from "./types.js";
 export declare function getMonitoringAdapter(): MonitoringAdapter;
 export declare function initMonitoring(options: MonitoringInitOptions, force?: boolean): Promise<void>;
+/**
+ * Test seam — install a specific adapter without going through `initMonitoring`.
+ *
+ * Intended for unit tests in `monitoring-core` and in any consuming package
+ * that wants to install a recording fake. Not for production code.
+ *
+ * Marking the module as initialized prevents a subsequent `initMonitoring`
+ * call with the same options from being short-circuited by the dedup check.
+ */
+export declare function setMonitoringAdapter(next: MonitoringAdapter): void;
+/**
+ * Test seam — restore the default `NoopAdapter` and clear init state.
+ *
+ * After calling this, `getMonitoringAdapter()` returns the `NoopAdapter`
+ * singleton and the next `initMonitoring` call runs end-to-end without
+ * being deduped against any previous options.
+ */
+export declare function resetMonitoringAdapter(): void;
 //# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASxD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAkEf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASxD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAIlE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C"}

package/dist/init.js

@@ -59,4 +59,30 @@ export async function initMonitoring(options, force = false) {
     adapter = NoopAdapter;
     initialized = true;
 }
+/**
+ * Test seam — install a specific adapter without going through `initMonitoring`.
+ *
+ * Intended for unit tests in `monitoring-core` and in any consuming package
+ * that wants to install a recording fake. Not for production code.
+ *
+ * Marking the module as initialized prevents a subsequent `initMonitoring`
+ * call with the same options from being short-circuited by the dedup check.
+ */
+export function setMonitoringAdapter(next) {
+    adapter = next;
+    initialized = true;
+    currentOptions = null;
+}
+/**
+ * Test seam — restore the default `NoopAdapter` and clear init state.
+ *
+ * After calling this, `getMonitoringAdapter()` returns the `NoopAdapter`
+ * singleton and the next `initMonitoring` call runs end-to-end without
+ * being deduped against any previous options.
+ */
+export function resetMonitoringAdapter() {
+    adapter = NoopAdapter;
+    initialized = false;
+    currentOptions = null;
+}
 //# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,IAAI,OAAO,GAAsB,WAAW,CAAC;AAC7C,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,cAAc,GAAiC,IAAI,CAAC;AAExD,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;AAEhD,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B,EAC9B,KAAK,GAAG,KAAK;IAEb,8BAA8B;IAC9B,IACE,WAAW;QACX,CAAC,KAAK;QACN,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAC1D,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC/E,CAAC;IAED,cAAc,GAAG,OAAO,CAAC;IAEzB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAExC,0EAA0E;IAC1E,sEAAsE;IACtE,qEAAqE;IACrE,kEAAkE;IAClE,mDAAmD;IACnD,MAAM,UAAU,GACd,CAAC,OAAO,OAAO,KAAK,WAAW;QAC7B,CAAC,OAAO,CAAC,GAAG,EAAE,yBAAyB,KAAK,MAAM;YAChD,OAAO,CAAC,GAAG,EAAE,kBAAkB,KAAK,MAAM;YAC1C,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,qBAAqB;YACpC,OAAO,CAAC,GAAG,EAAE,0BAA0B,KAAK,OAAO,CAAC,CAAC,CAAC;IAE5D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,IAAI,UAAU,EAAE,CAAC;QAC1D,OAAO,GAAG,WAAW,CAAC;QACtB,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO;IACT,CAAC;IAED,kDAAkD;IAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC/D,OAAO,GAAG,aAAa,CAAC;QACxB,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO;IACT,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACV,oEAAoE,CACrE,CAAC;YACF,OAAO,GAAG,WAAW,CAAC;YACtB,WAAW,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACxE,OAAO,GAAG,iBAAiB,CAAC;QAC5B,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO;IACT,CAAC;IAED,WAAW;IACX,OAAO,GAAG,WAAW,CAAC;IACtB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,25 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+export interface ErrorBoundaryProps {
+    children: ReactNode;
+    /** Rendered when an error has been caught. */
+    fallback: ReactNode;
+    /** Identifier sent to monitoring (e.g. "checkout-page"). */
+    context: string;
+    /** Optional callback invoked alongside captureException. */
+    onError?: (error: Error, info: ErrorInfo) => void;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+}
+/**
+ * Generic React Error Boundary that reports to the configured monitoring
+ * provider via `captureException`. The fallback UI is fully consumer-owned.
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/react/error-boundary.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAClF,KAAK,EAAE,kBAAkB,CAAuB;IAEhD,MAAM,CAAC,wBAAwB,IAAI,kBAAkB;IAIrD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS;IAQpD,MAAM;CAIP"}

package/dist/react/error-boundary.js

@@ -0,0 +1,26 @@
+"use client";
+import { Component } from "react";
+import { captureException } from "../api.js";
+/**
+ * Generic React Error Boundary that reports to the configured monitoring
+ * provider via `captureException`. The fallback UI is fully consumer-owned.
+ */
+export class ErrorBoundary extends Component {
+    state = { hasError: false };
+    static getDerivedStateFromError() {
+        return { hasError: true };
+    }
+    componentDidCatch(error, errorInfo) {
+        captureException(error, {
+            componentStack: errorInfo.componentStack,
+            context: this.props.context,
+        });
+        this.props.onError?.(error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError)
+            return this.props.fallback;
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=error-boundary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","sourceRoot":"","sources":["../../src/react/error-boundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAgB7C;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAiD;IAClF,KAAK,GAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEhD,MAAM,CAAC,wBAAwB;QAC7B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,SAAoB;QAClD,gBAAgB,CAAC,KAAK,EAAE;YACtB,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { ErrorBoundary } from "./error-boundary.js";
+export type { ErrorBoundaryProps } from "./error-boundary.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,3 @@
+"use client";
+export { ErrorBoundary } from "./error-boundary.js";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ttt-productions/monitoring-core",
-    "version": "0.2.16",
+    "version": "0.3.1",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -21,6 +21,10 @@
         ".": {
             "types": "./dist/index.d.ts",
             "default": "./dist/index.js"
+        },
+        "./react": {
+            "types": "./dist/react/index.d.ts",
+            "default": "./dist/react/index.js"
         }
     },
     "scripts": {
@@ -31,7 +35,9 @@
     },
     "peerDependencies": {
         "@sentry/nextjs": "^10.32.1",
-        "@sentry/node": "^10.32.1"
+        "@sentry/node": "^10.32.1",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
     },
     "peerDependenciesMeta": {
         "@sentry/nextjs": {
@@ -39,12 +45,22 @@
         },
         "@sentry/node": {
             "optional": true
+        },
+        "react": {
+            "optional": true
+        },
+        "react-dom": {
+            "optional": true
         }
     },
     "devDependencies": {
         "typescript": "^5.8.3",
         "@sentry/nextjs": "^10.32.1",
-        "@sentry/node": "^10.32.1"
+        "@sentry/node": "^10.32.1",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0",
+        "@types/react": "^19.0.0",
+        "@types/react-dom": "^19.0.0"
     },
     "author": "DJ (TTT Productions)",
     "license": "MIT"