@goliapkg/sentori-react 0.1.0

package/lib/SentoriErrorBoundary.d.ts

@@ -0,0 +1,20 @@
+import { type ErrorInfo, type ReactNode } from 'react';
+type Props = {
+    children: ReactNode;
+    /** Rendered after an error is caught. Receives the error and a
+     *  `reset` callback that clears the boundary so retries can run. */
+    fallback: (props: {
+        error: Error;
+        reset: () => void;
+    }) => ReactNode;
+    /** Optional additional logging hook. Runs after Sentori capture. */
+    onError?: (error: Error, info: ErrorInfo) => void;
+};
+/**
+ * Wraps `<SentoriErrorBoundaryInner>` so we can grab the capture
+ * function from context — class components can't use hooks directly,
+ * but they CAN receive props from a thin functional wrapper.
+ */
+export declare function SentoriErrorBoundary(props: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SentoriErrorBoundary.d.ts.map

package/lib/SentoriErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentoriErrorBoundary.d.ts","sourceRoot":"","sources":["../src/SentoriErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIjE,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,SAAS,CAAA;IACnB;wEACoE;IACpE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,SAAS,CAAA;IACnE,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;CAClD,CAAA;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,2CAWhD"}

package/lib/SentoriErrorBoundary.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component } from 'react';
+import { useSentoriCtx } from './SentoriProvider.js';
+/**
+ * Wraps `<SentoriErrorBoundaryInner>` so we can grab the capture
+ * function from context — class components can't use hooks directly,
+ * but they CAN receive props from a thin functional wrapper.
+ */
+export function SentoriErrorBoundary(props) {
+    const { captureError } = useSentoriCtx();
+    return (_jsx(SentoriErrorBoundaryInner, { ...props, capture: (err, info) => {
+            captureError(err, { tags: { source: 'react.errorBoundary' } });
+            props.onError?.(err, info);
+        } }));
+}
+class SentoriErrorBoundaryInner extends Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        this.props.capture(error, info);
+    }
+    reset = () => this.setState({ error: null });
+    render() {
+        if (this.state.error) {
+            return this.props.fallback({ error: this.state.error, reset: this.reset });
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=SentoriErrorBoundary.js.map

package/lib/SentoriErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentoriErrorBoundary.js","sourceRoot":"","sources":["../src/SentoriErrorBoundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAA;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAapD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAAA;IACxC,OAAO,CACL,KAAC,yBAAyB,OACpB,KAAK,EACT,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACrB,YAAY,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAA;YAC9D,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC,GACD,CACH,CAAA;AACH,CAAC;AAED,MAAM,yBAA0B,SAAQ,SAGvC;IACC,KAAK,GAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAE9B,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAA;IAClB,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,IAAe;QAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,GAAG,GAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAElD,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAA;IAC5B,CAAC;CACF"}

package/lib/SentoriProvider.d.ts

@@ -0,0 +1,21 @@
+import { type ReactNode } from 'react';
+import type { SentoriContextValue, SentoriReactConfig } from './types.js';
+/**
+ * Initialises the JS SDK once on mount and exposes capture / breadcrumb
+ * helpers via context. Safe to mount multiple times in dev (StrictMode
+ * double-mount): the JS SDK's own idempotency guards take care of it
+ * but we also dedupe here via a ref.
+ *
+ * Drop this near the root of the React tree (above any
+ * `<SentoriErrorBoundary>`):
+ *
+ *     <SentoriProvider config={{ token, release, ingestUrl, environment }}>
+ *       <App />
+ *     </SentoriProvider>
+ */
+export declare function SentoriProvider({ children, config, }: {
+    children: ReactNode;
+    config: SentoriReactConfig;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useSentoriCtx(): SentoriContextValue;
+//# sourceMappingURL=SentoriProvider.d.ts.map

package/lib/SentoriProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentoriProvider.d.ts","sourceRoot":"","sources":["../src/SentoriProvider.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,SAAS,EAAyC,MAAM,OAAO,CAAA;AAE5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAQ,MAAM,YAAY,CAAA;AAM/E;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,SAAS,CAAA;IACnB,MAAM,EAAE,kBAAkB,CAAA;CAC3B,2CAuCA;AAaD,wBAAgB,aAAa,IAAI,mBAAmB,CASnD"}

package/lib/SentoriProvider.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { addBreadcrumb, captureError, captureException, initSentori, setUser, } from '@goliapkg/sentori-javascript';
+import { createContext, useContext, useMemo, useRef, useState } from 'react';
+const Ctx = createContext(null);
+let _tags = null;
+/**
+ * Initialises the JS SDK once on mount and exposes capture / breadcrumb
+ * helpers via context. Safe to mount multiple times in dev (StrictMode
+ * double-mount): the JS SDK's own idempotency guards take care of it
+ * but we also dedupe here via a ref.
+ *
+ * Drop this near the root of the React tree (above any
+ * `<SentoriErrorBoundary>`):
+ *
+ *     <SentoriProvider config={{ token, release, ingestUrl, environment }}>
+ *       <App />
+ *     </SentoriProvider>
+ */
+export function SentoriProvider({ children, config, }) {
+    const initialisedRef = useRef(false);
+    const [initialised, setInitialised] = useState(false);
+    if (!initialisedRef.current) {
+        initialisedRef.current = true;
+        try {
+            initSentori(config);
+            setInitialised(true);
+        }
+        catch (e) {
+            // Misconfiguration (bad token shape, missing fields). Surface to
+            // console but don't crash the app — the rest of the tree should
+            // still render.
+            // eslint-disable-next-line no-console
+            console.error('[sentori-react] init failed', e);
+        }
+    }
+    const value = useMemo(() => ({
+        addBreadcrumb: (type, data) => {
+            addBreadcrumb({ data: data ?? {}, type });
+        },
+        captureError: (err, extras) => {
+            captureError(err, mergeExtras(extras));
+        },
+        captureException: (err, extras) => {
+            captureException(err, mergeExtras(extras));
+        },
+        initialised,
+        setTags: (tags) => {
+            _tags = tags;
+        },
+        setUser,
+    }), [initialised]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+/**
+ * Merge provider-scoped tags into per-call extras. Per-call wins over
+ * provider-scoped on conflict (matches Sentry's semantics).
+ */
+function mergeExtras(extras) {
+    if (!_tags)
+        return extras;
+    return { ...extras, tags: { ..._tags, ...(extras?.tags ?? {}) } };
+}
+export function useSentoriCtx() {
+    const ctx = useContext(Ctx);
+    if (!ctx) {
+        throw new Error('[sentori-react] hook used outside <SentoriProvider>. ' +
+            'Wrap your app at or above the component that calls useSentori / useCaptureError.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=SentoriProvider.js.map

package/lib/SentoriProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentoriProvider.js","sourceRoot":"","sources":["../src/SentoriProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,OAAO,GACR,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAI5F,MAAM,GAAG,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAA;AAE3D,IAAI,KAAK,GAAgB,IAAI,CAAA;AAE7B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,MAAM,GAIP;IACC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACpC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAErD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,cAAc,CAAC,OAAO,GAAG,IAAI,CAAA;QAC7B,IAAI,CAAC;YACH,WAAW,CAAC,MAAM,CAAC,CAAA;YACnB,cAAc,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,iEAAiE;YACjE,gEAAgE;YAChE,gBAAgB;YAChB,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAwB,OAAO,CACxC,GAAG,EAAE,CAAC,CAAC;QACL,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YAC5B,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,CAAC;QACD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAC5B,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;QACxC,CAAC;QACD,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAChC,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5C,CAAC;QACD,WAAW;QACX,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,KAAK,GAAG,IAAI,CAAA;QACd,CAAC;QACD,OAAO;KACR,CAAC,EACF,CAAC,WAAW,CAAC,CACd,CAAA;IAED,OAAO,KAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAgB,CAAA;AAC9D,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAClB,MAAwE;IAExE,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAA;IACzB,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,kFAAkF,CACrF,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/lib/__tests__/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/lib/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":""}

package/lib/__tests__/setup.js

@@ -0,0 +1,12 @@
+import { GlobalRegistrator } from '@happy-dom/global-registrator';
+GlobalRegistrator.register();
+// Phase 21 sub-B: tests run under happy-dom, but the JS SDK's
+// transport tries to POST to ingestUrl. Stub fetch on every layer
+// happy-dom exposes — global, window, and the constructor — so
+// initialisation, hook installs, and capture paths all no-op.
+const stubFetch = async () => new Response('{}', { status: 202 });
+globalThis.fetch = stubFetch;
+window.fetch = stubFetch;
+window.sendBeacon = () => true;
+navigator.sendBeacon = () => true;
+//# sourceMappingURL=setup.js.map

package/lib/__tests__/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEjE,iBAAiB,CAAC,QAAQ,EAAE,CAAA;AAE5B,8DAA8D;AAC9D,kEAAkE;AAClE,+DAA+D;AAC/D,8DAA8D;AAC9D,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAChE;AAAC,UAAiC,CAAC,KAAK,GAAG,SAAS,CACpD;AAAC,MAAwC,CAAC,KAAK,GAAG,SAAS,CAG3D;AAAC,MAA8C,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,CACvE;AAAC,SAAiD,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA"}

package/lib/hooks.d.ts

@@ -0,0 +1,28 @@
+import type { CaptureExtras, SentoriContextValue } from './types.js';
+/**
+ * Imperative access to the SDK from inside a component. Returns the
+ * full context — most code only needs `captureError`, `addBreadcrumb`,
+ * or `setUser`.
+ *
+ *     const { captureError, addBreadcrumb } = useSentori()
+ *     try {
+ *       await api.checkout(order)
+ *     } catch (e) {
+ *       captureError(e as Error, { tags: { stage: 'checkout' } })
+ *     }
+ */
+export declare function useSentori(): SentoriContextValue;
+/**
+ * Wraps an async function so any thrown / rejected error is captured
+ * and rethrown. The wrapper is `useCallback`-stable across renders if
+ * `extras` is stable too — pass it inside `useMemo` if you build it
+ * inline.
+ *
+ *     const checkout = useCaptureError(
+ *       async (order: Order) => api.checkout(order),
+ *       { tags: { stage: 'checkout' } },
+ *     )
+ *     await checkout(order)   // captures + throws on failure
+ */
+export declare function useCaptureError<TArgs extends unknown[], TRet>(fn: (...args: TArgs) => Promise<TRet> | TRet, extras?: CaptureExtras): (...args: TArgs) => Promise<TRet>;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEpE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,mBAAmB,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,IAAI,EAC3D,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAC5C,MAAM,CAAC,EAAE,aAAa,GACrB,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAanC"}

package/lib/hooks.js

@@ -0,0 +1,42 @@
+import { useCallback } from 'react';
+import { useSentoriCtx } from './SentoriProvider.js';
+/**
+ * Imperative access to the SDK from inside a component. Returns the
+ * full context — most code only needs `captureError`, `addBreadcrumb`,
+ * or `setUser`.
+ *
+ *     const { captureError, addBreadcrumb } = useSentori()
+ *     try {
+ *       await api.checkout(order)
+ *     } catch (e) {
+ *       captureError(e as Error, { tags: { stage: 'checkout' } })
+ *     }
+ */
+export function useSentori() {
+    return useSentoriCtx();
+}
+/**
+ * Wraps an async function so any thrown / rejected error is captured
+ * and rethrown. The wrapper is `useCallback`-stable across renders if
+ * `extras` is stable too — pass it inside `useMemo` if you build it
+ * inline.
+ *
+ *     const checkout = useCaptureError(
+ *       async (order: Order) => api.checkout(order),
+ *       { tags: { stage: 'checkout' } },
+ *     )
+ *     await checkout(order)   // captures + throws on failure
+ */
+export function useCaptureError(fn, extras) {
+    const { captureError } = useSentoriCtx();
+    return useCallback(async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (e) {
+            captureError(e instanceof Error ? e : new Error(String(e)), extras);
+            throw e;
+        }
+    }, [captureError, fn, extras]);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,aAAa,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,EAA4C,EAC5C,MAAsB;IAEtB,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,EAAE,CAAA;IACxC,OAAO,WAAW,CAChB,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,YAAY,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;YACnE,MAAM,CAAC,CAAA;QACT,CAAC;IACH,CAAC,EACD,CAAC,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,CAC3B,CAAA;AACH,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+export { SentoriProvider } from './SentoriProvider.js';
+export { SentoriErrorBoundary } from './SentoriErrorBoundary.js';
+export { useSentori, useCaptureError } from './hooks.js';
+export type { Breadcrumb, BreadcrumbType, CaptureExtras, SentoriContextValue, SentoriReactConfig, Tags, User, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAExD,YAAY,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,IAAI,EACJ,IAAI,GACL,MAAM,YAAY,CAAA"}

package/lib/index.js

@@ -0,0 +1,4 @@
+export { SentoriProvider } from './SentoriProvider.js';
+export { SentoriErrorBoundary } from './SentoriErrorBoundary.js';
+export { useSentori, useCaptureError } from './hooks.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/lib/types.d.ts

@@ -0,0 +1,29 @@
+import type { Breadcrumb, BreadcrumbType, CaptureExtras, CommonInitOptions, Tags, User } from '@goliapkg/sentori-core';
+export type SentoriReactConfig = CommonInitOptions & {
+    /**
+     * Disable the JS SDK's automatic window/process error hooks. Default
+     * is to leave them on so non-React errors (network handlers, top-
+     * level promises) still capture. Set to false if you want
+     * SentoriErrorBoundary to be the only entry point.
+     */
+    enableGlobalHooks?: boolean;
+};
+export type SentoriContextValue = {
+    /** Append a breadcrumb to the per-process ring buffer. */
+    addBreadcrumb: (type: BreadcrumbType, data?: Record<string, unknown>) => void;
+    /**
+     * Capture any thrown value. Plain `Error` is the happy path; non-
+     * Error values get wrapped so the dashboard still sees a stack.
+     */
+    captureError: (error: Error, extras?: CaptureExtras) => void;
+    /** Same as captureError. Kept for parity with the JS SDK. */
+    captureException: (error: Error, extras?: CaptureExtras) => void;
+    /** Whether SentoriProvider has finished its one-shot init. */
+    initialised: boolean;
+    /** Attach a stable user identifier to subsequent events. */
+    setUser: (user: null | User) => void;
+    /** Replace the entire tag set on subsequent events. */
+    setTags: (tags: Tags | null) => void;
+};
+export type { Breadcrumb, BreadcrumbType, CaptureExtras, Tags, User };
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,IAAI,EACL,MAAM,wBAAwB,CAAA;AAE/B,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACnD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,0DAA0D;IAC1D,aAAa,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC7E;;;OAGG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IAC5D,6DAA6D;IAC7D,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IAChE,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAA;IACpB,4DAA4D;IAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAA;IACpC,uDAAuD;IACvD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAA;CACrC,CAAA;AAID,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@goliapkg/sentori-react",
+  "version": "0.1.0",
+  "description": "React adapter for Sentori — Provider, ErrorBoundary, and hooks built on @goliapkg/sentori-javascript.",
+  "license": "MIT",
+  "homepage": "https://sentori.golia.jp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/sentori.git",
+    "directory": "sdk/react"
+  },
+  "bugs": {
+    "url": "https://github.com/goliajp/sentori/issues"
+  },
+  "keywords": [
+    "sentori",
+    "error-tracking",
+    "react",
+    "error-boundary"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "dependencies": {
+    "@goliapkg/sentori-core": "0.1.0",
+    "@goliapkg/sentori-javascript": "0.2.0"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^17",
+    "@testing-library/react": "^16",
+    "@types/bun": "latest",
+    "@types/react": "^19",
+    "react": "^19",
+    "react-dom": "^19",
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/SentoriErrorBoundary.tsx

@@ -0,0 +1,56 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react'
+
+import { useSentoriCtx } from './SentoriProvider.js'
+
+type Props = {
+  children: ReactNode
+  /** Rendered after an error is caught. Receives the error and a
+   *  `reset` callback that clears the boundary so retries can run. */
+  fallback: (props: { error: Error; reset: () => void }) => ReactNode
+  /** Optional additional logging hook. Runs after Sentori capture. */
+  onError?: (error: Error, info: ErrorInfo) => void
+}
+
+type State = { error: Error | null }
+
+/**
+ * Wraps `<SentoriErrorBoundaryInner>` so we can grab the capture
+ * function from context — class components can't use hooks directly,
+ * but they CAN receive props from a thin functional wrapper.
+ */
+export function SentoriErrorBoundary(props: Props) {
+  const { captureError } = useSentoriCtx()
+  return (
+    <SentoriErrorBoundaryInner
+      {...props}
+      capture={(err, info) => {
+        captureError(err, { tags: { source: 'react.errorBoundary' } })
+        props.onError?.(err, info)
+      }}
+    />
+  )
+}
+
+class SentoriErrorBoundaryInner extends Component<
+  Props & { capture: (e: Error, info: ErrorInfo) => void },
+  State
+> {
+  state: State = { error: null }
+
+  static getDerivedStateFromError(error: Error): State {
+    return { error }
+  }
+
+  componentDidCatch(error: Error, info: ErrorInfo): void {
+    this.props.capture(error, info)
+  }
+
+  reset = (): void => this.setState({ error: null })
+
+  render(): ReactNode {
+    if (this.state.error) {
+      return this.props.fallback({ error: this.state.error, reset: this.reset })
+    }
+    return this.props.children
+  }
+}

package/src/SentoriProvider.tsx

@@ -0,0 +1,96 @@
+import {
+  addBreadcrumb,
+  captureError,
+  captureException,
+  initSentori,
+  setUser,
+} from '@goliapkg/sentori-javascript'
+import { createContext, type ReactNode, useContext, useMemo, useRef, useState } from 'react'
+
+import type { SentoriContextValue, SentoriReactConfig, Tags } from './types.js'
+
+const Ctx = createContext<null | SentoriContextValue>(null)
+
+let _tags: null | Tags = null
+
+/**
+ * Initialises the JS SDK once on mount and exposes capture / breadcrumb
+ * helpers via context. Safe to mount multiple times in dev (StrictMode
+ * double-mount): the JS SDK's own idempotency guards take care of it
+ * but we also dedupe here via a ref.
+ *
+ * Drop this near the root of the React tree (above any
+ * `<SentoriErrorBoundary>`):
+ *
+ *     <SentoriProvider config={{ token, release, ingestUrl, environment }}>
+ *       <App />
+ *     </SentoriProvider>
+ */
+export function SentoriProvider({
+  children,
+  config,
+}: {
+  children: ReactNode
+  config: SentoriReactConfig
+}) {
+  const initialisedRef = useRef(false)
+  const [initialised, setInitialised] = useState(false)
+
+  if (!initialisedRef.current) {
+    initialisedRef.current = true
+    try {
+      initSentori(config)
+      setInitialised(true)
+    } catch (e) {
+      // Misconfiguration (bad token shape, missing fields). Surface to
+      // console but don't crash the app — the rest of the tree should
+      // still render.
+      // eslint-disable-next-line no-console
+      console.error('[sentori-react] init failed', e)
+    }
+  }
+
+  const value: SentoriContextValue = useMemo(
+    () => ({
+      addBreadcrumb: (type, data) => {
+        addBreadcrumb({ data: data ?? {}, type })
+      },
+      captureError: (err, extras) => {
+        captureError(err, mergeExtras(extras))
+      },
+      captureException: (err, extras) => {
+        captureException(err, mergeExtras(extras))
+      },
+      initialised,
+      setTags: (tags) => {
+        _tags = tags
+      },
+      setUser,
+    }),
+    [initialised],
+  )
+
+  return <Ctx.Provider value={value}>{children}</Ctx.Provider>
+}
+
+/**
+ * Merge provider-scoped tags into per-call extras. Per-call wins over
+ * provider-scoped on conflict (matches Sentry's semantics).
+ */
+function mergeExtras(
+  extras?: { fingerprint?: string[]; tags?: Tags; user?: { id?: string } },
+): typeof extras {
+  if (!_tags) return extras
+  return { ...extras, tags: { ..._tags, ...(extras?.tags ?? {}) } }
+}
+
+export function useSentoriCtx(): SentoriContextValue {
+  const ctx = useContext(Ctx)
+  if (!ctx) {
+    throw new Error(
+      '[sentori-react] hook used outside <SentoriProvider>. ' +
+        'Wrap your app at or above the component that calls useSentori / useCaptureError.',
+    )
+  }
+  return ctx
+}

package/src/__tests__/SentoriErrorBoundary.test.tsx

@@ -0,0 +1,51 @@
+import { render, screen } from '@testing-library/react'
+import { describe, expect, test } from 'bun:test'
+
+import { SentoriErrorBoundary } from '../SentoriErrorBoundary.js'
+import { SentoriProvider } from '../SentoriProvider.js'
+
+const PROVIDER_PROPS = {
+  config: {
+    environment: 'test',
+    ingestUrl: 'http://localhost:0',
+    release: 'test@0.0.0',
+    token: 'st_pk_testtesttesttesttesttesttest',
+  },
+}
+
+const Boom = (): never => {
+  throw new Error('boom-from-render')
+}
+
+describe('SentoriErrorBoundary', () => {
+  test('renders children when nothing throws', () => {
+    render(
+      <SentoriProvider {...PROVIDER_PROPS}>
+        <SentoriErrorBoundary fallback={() => <div>fallback</div>}>
+          <div>ok</div>
+        </SentoriErrorBoundary>
+      </SentoriProvider>,
+    )
+    expect(screen.getByText('ok')).toBeDefined()
+  })
+
+  test('renders fallback when child throws', () => {
+    // Suppress React's noisy "uncaught error" log in the test output.
+    const original = console.error
+    console.error = () => {}
+    try {
+      render(
+        <SentoriProvider {...PROVIDER_PROPS}>
+          <SentoriErrorBoundary
+            fallback={({ error }) => <div>caught: {error.message}</div>}
+          >
+            <Boom />
+          </SentoriErrorBoundary>
+        </SentoriProvider>,
+      )
+    } finally {
+      console.error = original
+    }
+    expect(screen.getByText('caught: boom-from-render')).toBeDefined()
+  })
+})

package/src/__tests__/hooks.test.tsx

@@ -0,0 +1,48 @@
+import { render, screen } from '@testing-library/react'
+import { describe, expect, test } from 'bun:test'
+
+import { SentoriProvider } from '../SentoriProvider.js'
+import { useSentori } from '../hooks.js'
+
+const PROVIDER_PROPS = {
+  config: {
+    environment: 'test',
+    ingestUrl: 'http://localhost:0',
+    release: 'test@0.0.0',
+    token: 'st_pk_testtesttesttesttesttesttest',
+  },
+}
+
+describe('useSentori', () => {
+  test('returns capture / setUser / addBreadcrumb', () => {
+    const Probe = () => {
+      const ctx = useSentori()
+      return (
+        <div>
+          init={String(ctx.initialised)} hasCapture=
+          {String(typeof ctx.captureError === 'function')}
+        </div>
+      )
+    }
+    render(
+      <SentoriProvider {...PROVIDER_PROPS}>
+        <Probe />
+      </SentoriProvider>,
+    )
+    expect(screen.getByText(/init=true hasCapture=true/)).toBeDefined()
+  })
+
+  test('throws when used outside provider', () => {
+    const Probe = () => {
+      useSentori()
+      return null
+    }
+    const original = console.error
+    console.error = () => {}
+    try {
+      expect(() => render(<Probe />)).toThrow(/SentoriProvider/)
+    } finally {
+      console.error = original
+    }
+  })
+})

package/src/__tests__/setup.ts

@@ -0,0 +1,15 @@
+import { GlobalRegistrator } from '@happy-dom/global-registrator'
+
+GlobalRegistrator.register()
+
+// Phase 21 sub-B: tests run under happy-dom, but the JS SDK's
+// transport tries to POST to ingestUrl. Stub fetch on every layer
+// happy-dom exposes — global, window, and the constructor — so
+// initialisation, hook installs, and capture paths all no-op.
+const stubFetch = async () => new Response('{}', { status: 202 })
+;(globalThis as { fetch: unknown }).fetch = stubFetch
+;(window as unknown as { fetch: unknown }).fetch = stubFetch
+// Some happy-dom versions snapshot the original fetch constructor
+// onto window.Window.prototype; overwriting our reference is harmless.
+;(window as unknown as { sendBeacon?: unknown }).sendBeacon = () => true
+;(navigator as unknown as { sendBeacon?: unknown }).sendBeacon = () => true

package/src/hooks.ts

@@ -0,0 +1,51 @@
+import { useCallback } from 'react'
+
+import { useSentoriCtx } from './SentoriProvider.js'
+
+import type { CaptureExtras, SentoriContextValue } from './types.js'
+
+/**
+ * Imperative access to the SDK from inside a component. Returns the
+ * full context — most code only needs `captureError`, `addBreadcrumb`,
+ * or `setUser`.
+ *
+ *     const { captureError, addBreadcrumb } = useSentori()
+ *     try {
+ *       await api.checkout(order)
+ *     } catch (e) {
+ *       captureError(e as Error, { tags: { stage: 'checkout' } })
+ *     }
+ */
+export function useSentori(): SentoriContextValue {
+  return useSentoriCtx()
+}
+
+/**
+ * Wraps an async function so any thrown / rejected error is captured
+ * and rethrown. The wrapper is `useCallback`-stable across renders if
+ * `extras` is stable too — pass it inside `useMemo` if you build it
+ * inline.
+ *
+ *     const checkout = useCaptureError(
+ *       async (order: Order) => api.checkout(order),
+ *       { tags: { stage: 'checkout' } },
+ *     )
+ *     await checkout(order)   // captures + throws on failure
+ */
+export function useCaptureError<TArgs extends unknown[], TRet>(
+  fn: (...args: TArgs) => Promise<TRet> | TRet,
+  extras?: CaptureExtras,
+): (...args: TArgs) => Promise<TRet> {
+  const { captureError } = useSentoriCtx()
+  return useCallback(
+    async (...args: TArgs) => {
+      try {
+        return await fn(...args)
+      } catch (e) {
+        captureError(e instanceof Error ? e : new Error(String(e)), extras)
+        throw e
+      }
+    },
+    [captureError, fn, extras],
+  )
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export { SentoriProvider } from './SentoriProvider.js'
+export { SentoriErrorBoundary } from './SentoriErrorBoundary.js'
+export { useSentori, useCaptureError } from './hooks.js'
+
+export type {
+  Breadcrumb,
+  BreadcrumbType,
+  CaptureExtras,
+  SentoriContextValue,
+  SentoriReactConfig,
+  Tags,
+  User,
+} from './types.js'

package/src/types.ts

@@ -0,0 +1,40 @@
+import type {
+  Breadcrumb,
+  BreadcrumbType,
+  CaptureExtras,
+  CommonInitOptions,
+  Tags,
+  User,
+} from '@goliapkg/sentori-core'
+
+export type SentoriReactConfig = CommonInitOptions & {
+  /**
+   * Disable the JS SDK's automatic window/process error hooks. Default
+   * is to leave them on so non-React errors (network handlers, top-
+   * level promises) still capture. Set to false if you want
+   * SentoriErrorBoundary to be the only entry point.
+   */
+  enableGlobalHooks?: boolean
+}
+
+export type SentoriContextValue = {
+  /** Append a breadcrumb to the per-process ring buffer. */
+  addBreadcrumb: (type: BreadcrumbType, data?: Record<string, unknown>) => void
+  /**
+   * Capture any thrown value. Plain `Error` is the happy path; non-
+   * Error values get wrapped so the dashboard still sees a stack.
+   */
+  captureError: (error: Error, extras?: CaptureExtras) => void
+  /** Same as captureError. Kept for parity with the JS SDK. */
+  captureException: (error: Error, extras?: CaptureExtras) => void
+  /** Whether SentoriProvider has finished its one-shot init. */
+  initialised: boolean
+  /** Attach a stable user identifier to subsequent events. */
+  setUser: (user: null | User) => void
+  /** Replace the entire tag set on subsequent events. */
+  setTags: (tags: Tags | null) => void
+}
+
+// Re-exports so consumers don't have to depend on @goliapkg/sentori-core
+// directly to type-annotate the props they pass in.
+export type { Breadcrumb, BreadcrumbType, CaptureExtras, Tags, User }