@tiledev/sdk-app-monitoring 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# @tiledev/sdk-app-monitoring
+
+Crash reporting (Sentry), session replay (LogRocket), one `captureError` / `captureWarning` seam
+and a root `ErrorBoundary` for TilePacket apps.
+
+- **iOS/Android release builds:** Sentry and LogRocket, each on when its config is present.
+- **Development builds and web** (including the Tile preview): the console only. A dev build shows
+  the error on screen already, and neither native module has a web build.
+- **Never takes the app down.** A missing module, an empty DSN or a throwing SDK is a warning and
+  that tool stays off. Every call is safe before init, and callers never guard.
+
+## Install
+
+```sh
+npm i @tiledev/sdk-app-monitoring
+# optional, native only: install the tools you use
+npx expo install @sentry/react-native @logrocket/react-native
+```
+
+Both are optional peers. Without them the calls still work, as console logging. Sentry's Expo
+config plugin (`@sentry/react-native/expo` in `app.json`) is still the app's to add for source maps.
+
+## Use
+
+```tsx
+import { initMonitoring, withMonitoring, ErrorBoundary } from '@tiledev/sdk-app-monitoring';
+
+// At module scope in App.tsx, before any provider's module runs: Sentry only sees what happens after.
+initMonitoring({
+  sentry: { dsn, environment: 'ambermarie-production', tags: { app: 'ambermarie' } },
+  logRocket: { appId: 'org/project' },
+});
+
+function App() {
+  return (
+    <ErrorBoundary colors={{ background, text, muted, primary, onPrimary }}>
+      {/* providers, navigation */}
+    </ErrorBoundary>
+  );
+}
+
+// OUTERMOST wrap, outside an OTA updater: a crash in anything it doesn't wrap isn't reported.
+export default withMonitoring(TileUpdater.wrap(options)(App));
+```
+
+## API
+
+| Call | What it does |
+| --- | --- |
+| `initMonitoring(config)` | Starts what the config turns on. Once; later calls are ignored. Returns `{ sentry, logRocket }`. |
+| `withMonitoring(App)` | Sentry's touch and navigation instrumentation around the root. `App` itself when Sentry is off. |
+| `captureError(error, context?)` | Something failed: `console.error`, and Sentry. A non-`Error` is wrapped in one. |
+| `captureWarning(warning, context?)` | Something the app handled that a developer should know: `console.warn`, and Sentry at warning level (never reads as a crash). |
+| `identifyUser(uid, traits?)` | The signed-in customer: traits on the replay (null/undefined dropped), **only the id** on Sentry. |
+| `resetUser()` | Sign-out: a fresh replay session with the same config, and no Sentry user. |
+| `getMonitoringStatus()` | `{ sentry, logRocket }`: which tools are on. |
+| `<ErrorBoundary>` | The outermost render catch: reports through `captureError`, shows a "Try again" screen. |
+
+### Config
+
+| Field | Default | |
+| --- | --- | --- |
+| `sentry.dsn` | | Empty or absent: Sentry off. |
+| `sentry.environment`, `sentry.tracesSampleRate` | Sentry's | |
+| `sentry.sendDefaultPii` | `false` | On, Sentry attaches IP addresses and request headers to every event. |
+| `sentry.tags` | | On every event. In a project shared by several apps, what a dashboard filters by. |
+| `sentry.options` | | Anything else `Sentry.init` takes. |
+| `logRocket.appId` | | Empty or absent: LogRocket off. |
+| `logRocket.options` | | LogRocket's init options (redaction, network capture). |
+| `*.enabled` | | `false` turns that tool off whatever the key. |
+| `enableInDev` | `false` | Report from development builds too. |
+| `linkReplayToCrashes` | `true` | Put the LogRocket session URL on every Sentry event (context `logrocket`), so a crash links to its replay. |
+
+### ErrorBoundary props
+
+`colors` (`background`, `text`, `muted`, `primary`, `onPrimary`), `title`, `message`, `retryLabel`,
+`showDetails` (default: development builds only), `onError(error, info)` (called after reporting;
+a throwing listener can't break the screen), and `fallback({ error, componentStack, reset })` to
+replace the screen entirely. It usually sits above the app's theme, so colours come in as a prop.
+
+## How the platforms split
+
+`index.ts` imports `./monitoring`. Metro resolves that to `monitoring.native.ts` on iOS/Android,
+which requires Sentry and LogRocket lazily, each inside a `try` so Metro treats them as optional,
+and to `monitoring.ts` everywhere else, which has no tools. `npm test` checks both: the web closure
+must never require either module, and the native requires must stay inside a `try`.
+
+## Develop
+
+```sh
+npm test   # build, the publish gate, the monitoring core against fake tools, ErrorBoundary in jsdom
+```
+
+The dev dependencies match the apps' stack (Expo 54: React Native 0.81.5, React 19.1), so the
+build type-checks against real react-native types. The ErrorBoundary test swaps react-native for
+plain DOM elements at runtime, since React Native itself can't run in Node.

package/dist/ErrorBoundary.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The outermost render catch. A render error a boundary catches never reaches Sentry's global
+ * handler, so this reports it through `captureError` and shows a "Try again" screen instead of a
+ * blank app.
+ *
+ * It usually sits above the app's theme, so it takes its colours as a prop rather than reading a
+ * theme context.
+ */
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+export interface ErrorBoundaryColors {
+    background: string;
+    text: string;
+    muted: string;
+    primary: string;
+    onPrimary: string;
+}
+export interface ErrorBoundaryFallbackProps {
+    error: Error;
+    componentStack: string | null;
+    /** Render the children again. */
+    reset: () => void;
+}
+export interface ErrorBoundaryProps {
+    children: ReactNode;
+    /** Called after the error is reported, e.g. to log an analytics event. */
+    onError?: (error: Error, info: ErrorInfo) => void;
+    /** Replace the default screen entirely. */
+    fallback?: (props: ErrorBoundaryFallbackProps) => ReactNode;
+    colors?: Partial<ErrorBoundaryColors>;
+    title?: string;
+    message?: string;
+    retryLabel?: string;
+    /** Show the error and the top of the component stack. Default: development builds only. */
+    showDetails?: boolean;
+}
+interface State {
+    error: Error | null;
+    componentStack: string | null;
+}
+export declare const DEFAULT_ERROR_BOUNDARY_COLORS: ErrorBoundaryColors;
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): Partial<State>;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    reset: () => void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../src/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOlE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iCAAiC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAC;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,KAAK;IACb,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAEF,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,KAAK,CAAC;IACrE,KAAK,EAAE,KAAK,CAAyC;IAErD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAI7D,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS;IAU/C,KAAK,aAA8D;IAEnE,MAAM;CAwBP"}

package/dist/ErrorBoundary.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorBoundary = exports.DEFAULT_ERROR_BOUNDARY_COLORS = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * The outermost render catch. A render error a boundary catches never reaches Sentry's global
+ * handler, so this reports it through `captureError` and shows a "Try again" screen instead of a
+ * blank app.
+ *
+ * It usually sits above the app's theme, so it takes its colours as a prop rather than reading a
+ * theme context.
+ */
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const monitoring_1 = require("./monitoring");
+exports.DEFAULT_ERROR_BOUNDARY_COLORS = {
+    background: '#FFFFFF',
+    text: '#111111',
+    muted: '#6B6B6B',
+    primary: '#111111',
+    onPrimary: '#FFFFFF',
+};
+class ErrorBoundary extends react_1.Component {
+    constructor() {
+        super(...arguments);
+        this.state = { error: null, componentStack: null };
+        this.reset = () => this.setState({ error: null, componentStack: null });
+    }
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        var _a, _b, _c;
+        monitoring_1.monitoring.captureError(error, { at: 'ErrorBoundary', componentStack: info.componentStack });
+        this.setState({ componentStack: (_a = info.componentStack) !== null && _a !== void 0 ? _a : null });
+        try {
+            (_c = (_b = this.props).onError) === null || _c === void 0 ? void 0 : _c.call(_b, error, info);
+        }
+        catch {
+            // The screen must still render if the host's listener throws.
+        }
+    }
+    render() {
+        var _a, _b, _c, _d;
+        const { error, componentStack } = this.state;
+        if (!error)
+            return this.props.children;
+        if (this.props.fallback)
+            return this.props.fallback({ error, componentStack, reset: this.reset });
+        const c = { ...exports.DEFAULT_ERROR_BOUNDARY_COLORS, ...this.props.colors };
+        const showDetails = (_a = this.props.showDetails) !== null && _a !== void 0 ? _a : (typeof __DEV__ !== 'undefined' && !!__DEV__);
+        const stack = componentStack ? `\n${componentStack.trim().split('\n').slice(0, 6).join('\n')}` : '';
+        return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: [styles.root, { backgroundColor: c.background }], children: [(0, jsx_runtime_1.jsx)(react_native_1.Text, { style: [styles.title, { color: c.text }], children: (_b = this.props.title) !== null && _b !== void 0 ? _b : 'Something went wrong' }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: [styles.message, { color: c.muted }], children: (_c = this.props.message) !== null && _c !== void 0 ? _c : 'Please try again.' }), showDetails ? ((0, jsx_runtime_1.jsxs)(react_native_1.Text, { selectable: true, style: [styles.debug, { color: c.muted }], children: [error.message, stack] })) : null, (0, jsx_runtime_1.jsx)(react_native_1.Pressable, { accessibilityRole: "button", onPress: this.reset, style: [styles.button, { backgroundColor: c.primary }], children: (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: [styles.buttonLabel, { color: c.onPrimary }], children: (_d = this.props.retryLabel) !== null && _d !== void 0 ? _d : 'Try again' }) })] }));
+    }
+}
+exports.ErrorBoundary = ErrorBoundary;
+const styles = react_native_1.StyleSheet.create({
+    root: { flex: 1, alignItems: 'center', justifyContent: 'center', padding: 24 },
+    title: { fontSize: 18, fontWeight: '600', marginBottom: 8 },
+    message: { fontSize: 14, marginBottom: 24 },
+    debug: { fontSize: 11, marginBottom: 24, fontFamily: 'monospace' },
+    button: { paddingHorizontal: 28, paddingVertical: 12, borderRadius: 8 },
+    buttonLabel: { fontSize: 14, fontWeight: '600' },
+});
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../src/ErrorBoundary.tsx"],"names":[],"mappings":"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"}

package/dist/core.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The monitoring state machine, shared by both builds. The native build hands it loaders that
+ * `require` Sentry and LogRocket; the web build hands it none, so there it is the console only.
+ *
+ * Three rules hold everywhere:
+ * - **Loading must never take the app down.** A missing module, a bad DSN or a throwing SDK is a
+ *   `console.warn` and that tool stays off.
+ * - **Callers never guard.** Every export is safe to call before `initMonitoring`, twice, or with
+ *   the tools off: it then only logs to the console.
+ * - **Reporting must never be why something else fails.** Every call into a tool is wrapped.
+ */
+import type { ComponentType } from 'react';
+import type { CaptureContext, MonitoringConfig, MonitoringStatus, UserTraits } from './types';
+/** The part of `@sentry/react-native` this uses. */
+export interface SentryLike {
+    init(options: Record<string, unknown>): void;
+    wrap<P extends Record<string, unknown>>(component: ComponentType<P>): ComponentType<P>;
+    captureException(error: unknown, hint?: {
+        extra?: CaptureContext;
+    }): unknown;
+    captureMessage(message: string, hint?: {
+        level?: string;
+        extra?: CaptureContext;
+    }): unknown;
+    setUser(user: {
+        id: string;
+    } | null): void;
+    setContext?(name: string, context: Record<string, unknown> | null): void;
+}
+/** The part of `@logrocket/react-native` this uses. */
+export interface LogRocketLike {
+    init(appId: string, options?: Record<string, unknown>): void;
+    identify(uid: string, traits?: Record<string, string | number | boolean>): void;
+    startNewSession?(): unknown;
+    startNewSessionSameConfig?(): unknown;
+    getSessionURL?(callback: (url: string) => void): void;
+}
+export interface Loaders {
+    sentry?: () => SentryLike;
+    logRocket?: () => LogRocketLike;
+}
+export interface Monitoring {
+    initMonitoring(config: MonitoringConfig): MonitoringStatus;
+    withMonitoring<C extends ComponentType<any>>(App: C): C;
+    captureError(error: unknown, context?: CaptureContext): void;
+    captureWarning(warning: unknown, context?: CaptureContext): void;
+    identifyUser(uid: string, traits?: UserTraits): void;
+    resetUser(): void;
+    getMonitoringStatus(): MonitoringStatus;
+}
+export interface CreateOptions {
+    /** Whether this is a development build. Default: the global `__DEV__`. */
+    isDev?: () => boolean;
+    console?: Pick<Console, 'error' | 'warn'>;
+}
+export declare function createMonitoring(loaders: Loaders, opts?: CreateOptions): Monitoring;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,cAAc,EAEd,gBAAgB,EAChB,gBAAgB,EAEhB,UAAU,EACX,MAAM,SAAS,CAAC;AAIjB,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACvF,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7E,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC;IAC5F,OAAO,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAC1E;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IAChF,eAAe,CAAC,IAAI,OAAO,CAAC;IAC5B,yBAAyB,CAAC,IAAI,OAAO,CAAC;IACtC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,UAAU,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IAC3D,cAAc,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACxD,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7D,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACrD,SAAS,IAAI,IAAI,CAAC;IAClB,mBAAmB,IAAI,gBAAgB,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,UAAU,CAgJvF"}

package/dist/core.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMonitoring = createMonitoring;
+function createMonitoring(loaders, opts = {}) {
+    var _a, _b;
+    const isDev = (_a = opts.isDev) !== null && _a !== void 0 ? _a : (() => typeof __DEV__ !== 'undefined' && !!__DEV__);
+    const log = (_b = opts.console) !== null && _b !== void 0 ? _b : console;
+    let initialised = false;
+    let sentry = null;
+    let logRocket = null;
+    const status = () => ({ sentry: !!sentry, logRocket: !!logRocket });
+    const safely = (what, fn) => {
+        try {
+            fn();
+        }
+        catch (error) {
+            log.warn(`[monitoring] ${what} failed`, error);
+        }
+    };
+    function startSentry(config) {
+        var _a;
+        if (!config || config.enabled === false || !config.dsn || !loaders.sentry)
+            return;
+        try {
+            const mod = loaders.sentry();
+            mod.init({
+                ...config.options,
+                dsn: config.dsn,
+                ...(config.environment ? { environment: config.environment } : {}),
+                ...(typeof config.tracesSampleRate === 'number' ? { tracesSampleRate: config.tracesSampleRate } : {}),
+                sendDefaultPii: (_a = config.sendDefaultPii) !== null && _a !== void 0 ? _a : false,
+                ...(config.tags ? { initialScope: { tags: config.tags } } : {}),
+            });
+            sentry = mod;
+        }
+        catch (error) {
+            log.warn('[monitoring] Sentry init failed; continuing without crash reporting', error);
+            sentry = null;
+        }
+    }
+    function startLogRocket(config) {
+        if (!config || config.enabled === false || !config.appId || !loaders.logRocket)
+            return;
+        try {
+            const mod = loaders.logRocket();
+            mod.init(config.appId, config.options);
+            logRocket = mod;
+        }
+        catch (error) {
+            log.warn('[monitoring] LogRocket init failed; continuing without session replay', error);
+            logRocket = null;
+        }
+    }
+    return {
+        /**
+         * Call once, at module scope in App.tsx, before any provider's module runs: Sentry only sees
+         * what happens after this. Later calls are ignored. Returns which tools came up.
+         */
+        initMonitoring(config) {
+            if (initialised)
+                return status();
+            initialised = true;
+            if (isDev() && !config.enableInDev)
+                return status();
+            startSentry(config.sentry);
+            startLogRocket(config.logRocket);
+            if (sentry && logRocket && config.linkReplayToCrashes !== false) {
+                const s = sentry;
+                safely('linking the replay', () => { var _a; return (_a = logRocket === null || logRocket === void 0 ? void 0 : logRocket.getSessionURL) === null || _a === void 0 ? void 0 : _a.call(logRocket, (url) => safely('linking the replay', () => { var _a; return (_a = s.setContext) === null || _a === void 0 ? void 0 : _a.call(s, 'logrocket', { sessionURL: url }); })); });
+            }
+            return status();
+        },
+        /**
+         * Sentry's touch and navigation instrumentation around the root. Make it the OUTERMOST wrap
+         * (outside an OTA updater), or a crash in what it wraps is not reported. The app itself when
+         * Sentry is off.
+         */
+        withMonitoring(App) {
+            if (!sentry)
+                return App;
+            try {
+                return sentry.wrap(App);
+            }
+            catch (error) {
+                log.warn('[monitoring] Sentry wrap failed', error);
+                return App;
+            }
+        },
+        /** Something failed. The console for the developer, Sentry in release builds. */
+        captureError(error, context) {
+            log.error(error, context);
+            if (!sentry)
+                return;
+            const s = sentry;
+            safely('captureError', () => s.captureException(error instanceof Error ? error : new Error(String(error)), { extra: context }));
+        },
+        /**
+         * Something a developer should know that the app already handled. Warning level, so a
+         * recovered condition never reads as a crash in the feed, and no red box in development.
+         */
+        captureWarning(warning, context) {
+            log.warn(warning, context);
+            if (!sentry)
+                return;
+            const s = sentry;
+            safely('captureWarning', () => s.captureMessage(warning instanceof Error ? warning.message : String(warning), { level: 'warning', extra: context }));
+        },
+        /**
+         * The signed-in customer: their traits on the replay, so it is searchable by who it was, and
+         * their id (only the id) on Sentry events.
+         */
+        identifyUser(uid, traits = {}) {
+            if (logRocket) {
+                const lr = logRocket;
+                const clean = {};
+                for (const [key, value] of Object.entries(traits)) {
+                    if (value !== null && value !== undefined)
+                        clean[key] = value;
+                }
+                safely('LogRocket identify', () => lr.identify(uid, clean));
+            }
+            if (sentry) {
+                const s = sentry;
+                safely('Sentry setUser', () => s.setUser({ id: uid }));
+            }
+        },
+        /** Sign-out: a fresh replay session, so a following guest isn't recorded as the last customer. */
+        resetUser() {
+            if (logRocket) {
+                const lr = logRocket;
+                // `startNewSession()` with no app id isn't documented to keep the config; SameConfig is.
+                safely('LogRocket new session', () => {
+                    var _a;
+                    const started = lr.startNewSessionSameConfig ? lr.startNewSessionSameConfig() : (_a = lr.startNewSession) === null || _a === void 0 ? void 0 : _a.call(lr);
+                    Promise.resolve(started).catch((error) => log.warn('[monitoring] LogRocket new session failed', error));
+                });
+            }
+            if (sentry) {
+                const s = sentry;
+                safely('Sentry setUser', () => s.setUser(null));
+            }
+        },
+        getMonitoringStatus: status,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export declare const initMonitoring: (config: import("./types").MonitoringConfig) => import("./types").MonitoringStatus;
+export declare const withMonitoring: <C extends import("react").ComponentType<any>>(App: C) => C;
+export declare const captureError: (error: unknown, context?: import("./types").CaptureContext) => void;
+export declare const captureWarning: (warning: unknown, context?: import("./types").CaptureContext) => void;
+export declare const identifyUser: (uid: string, traits?: import("./types").UserTraits) => void;
+export declare const resetUser: () => void;
+export declare const getMonitoringStatus: () => import("./types").MonitoringStatus;
+export { ErrorBoundary, DEFAULT_ERROR_BOUNDARY_COLORS, type ErrorBoundaryProps, type ErrorBoundaryColors, type ErrorBoundaryFallbackProps, } from './ErrorBoundary';
+export { createMonitoring, type Monitoring, type SentryLike, type LogRocketLike, type Loaders } from './core';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,cAAc,oFAA4B,CAAC;AACxD,eAAO,MAAM,cAAc,6DAA4B,CAAC;AACxD,eAAO,MAAM,YAAY,sEAA0B,CAAC;AACpD,eAAO,MAAM,cAAc,wEAA4B,CAAC;AACxD,eAAO,MAAM,YAAY,8DAA0B,CAAC;AACpD,eAAO,MAAM,SAAS,YAAuB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,0CAAiC,CAAC;AAElE,OAAO,EACL,aAAa,EACb,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC9G,mBAAmB,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMonitoring = exports.DEFAULT_ERROR_BOUNDARY_COLORS = exports.ErrorBoundary = exports.getMonitoringStatus = exports.resetUser = exports.identifyUser = exports.captureWarning = exports.captureError = exports.withMonitoring = exports.initMonitoring = void 0;
+/**
+ * `@tiledev/sdk-app-monitoring`: crash reporting, session replay and the app's error seam.
+ *
+ * Single entry point for both platforms. Metro resolves `./monitoring` to `monitoring.native.ts`
+ * on iOS/Android (Sentry + LogRocket, lazily required) and `monitoring.ts` everywhere else (the
+ * console only), because neither module has a web build and must never enter a web bundle.
+ *
+ * ```tsx
+ * import { initMonitoring, withMonitoring, ErrorBoundary, captureError } from '@tiledev/sdk-app-monitoring';
+ *
+ * initMonitoring({ sentry: { dsn, environment, tags: { app: 'ambermarie' } }, logRocket: { appId } });
+ * export default withMonitoring(App);   // outermost, outside the OTA wrap
+ * // <ErrorBoundary colors={…}> at the root of the tree
+ * captureError(error, { at: 'checkout' });
+ * ```
+ *
+ * Off in development builds and on web unless `enableInDev` is set; every call is then the
+ * console only, so callers never guard.
+ */
+const monitoring_1 = require("./monitoring");
+exports.initMonitoring = monitoring_1.monitoring.initMonitoring;
+exports.withMonitoring = monitoring_1.monitoring.withMonitoring;
+exports.captureError = monitoring_1.monitoring.captureError;
+exports.captureWarning = monitoring_1.monitoring.captureWarning;
+exports.identifyUser = monitoring_1.monitoring.identifyUser;
+exports.resetUser = monitoring_1.monitoring.resetUser;
+exports.getMonitoringStatus = monitoring_1.monitoring.getMonitoringStatus;
+var ErrorBoundary_1 = require("./ErrorBoundary");
+Object.defineProperty(exports, "ErrorBoundary", { enumerable: true, get: function () { return ErrorBoundary_1.ErrorBoundary; } });
+Object.defineProperty(exports, "DEFAULT_ERROR_BOUNDARY_COLORS", { enumerable: true, get: function () { return ErrorBoundary_1.DEFAULT_ERROR_BOUNDARY_COLORS; } });
+var core_1 = require("./core");
+Object.defineProperty(exports, "createMonitoring", { enumerable: true, get: function () { return core_1.createMonitoring; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,6CAA0C;AAE7B,QAAA,cAAc,GAAG,uBAAU,CAAC,cAAc,CAAC;AAC3C,QAAA,cAAc,GAAG,uBAAU,CAAC,cAAc,CAAC;AAC3C,QAAA,YAAY,GAAG,uBAAU,CAAC,YAAY,CAAC;AACvC,QAAA,cAAc,GAAG,uBAAU,CAAC,cAAc,CAAC;AAC3C,QAAA,YAAY,GAAG,uBAAU,CAAC,YAAY,CAAC;AACvC,QAAA,SAAS,GAAG,uBAAU,CAAC,SAAS,CAAC;AACjC,QAAA,mBAAmB,GAAG,uBAAU,CAAC,mBAAmB,CAAC;AAElE,iDAMyB;AALvB,8GAAA,aAAa,OAAA;AACb,8HAAA,6BAA6B,OAAA;AAK/B,+BAA8G;AAArG,wGAAA,gBAAgB,OAAA"}

package/dist/monitoring.d.ts

@@ -0,0 +1,2 @@
+export declare const monitoring: import("./core").Monitoring;
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../src/monitoring.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU,6BAAuB,CAAC"}

package/dist/monitoring.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.monitoring = void 0;
+/**
+ * Web (the Tile preview and web builds): neither Sentry's nor LogRocket's React Native module has
+ * a web build, so they must never enter a web bundle. Every call is the console only.
+ */
+const core_1 = require("./core");
+exports.monitoring = (0, core_1.createMonitoring)({});
+//# sourceMappingURL=monitoring.js.map

package/dist/monitoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.js","sourceRoot":"","sources":["../src/monitoring.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,iCAA0C;AAE7B,QAAA,UAAU,GAAG,IAAA,uBAAgB,EAAC,EAAE,CAAC,CAAC"}

package/dist/monitoring.native.d.ts

@@ -0,0 +1,2 @@
+export declare const monitoring: import("./core").Monitoring;
+//# sourceMappingURL=monitoring.native.d.ts.map

package/dist/monitoring.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.native.d.ts","sourceRoot":"","sources":["../src/monitoring.native.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,UAAU,6BAgBrB,CAAC"}

package/dist/monitoring.native.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.monitoring = void 0;
+/**
+ * iOS/Android: Sentry and LogRocket, each required only when its config turns it on, so an app
+ * that installs neither still builds and runs.
+ *
+ * Each `require` sits lexically inside a `try`: that is what makes Metro treat the module as
+ * optional (`allowOptionalDependencies`) instead of failing the build when it isn't installed. The
+ * error is rethrown, and `createMonitoring` turns it into a warning with that tool off.
+ */
+const core_1 = require("./core");
+exports.monitoring = (0, core_1.createMonitoring)({
+    sentry: () => {
+        try {
+            return require('@sentry/react-native');
+        }
+        catch (error) {
+            throw error;
+        }
+    },
+    logRocket: () => {
+        var _a;
+        try {
+            const mod = require('@logrocket/react-native');
+            return ((_a = mod === null || mod === void 0 ? void 0 : mod.default) !== null && _a !== void 0 ? _a : mod);
+        }
+        catch (error) {
+            throw error;
+        }
+    },
+});
+//# sourceMappingURL=monitoring.native.js.map

package/dist/monitoring.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.native.js","sourceRoot":"","sources":["../src/monitoring.native.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,iCAA+E;AAIlE,QAAA,UAAU,GAAG,IAAA,uBAAgB,EAAC;IACzC,MAAM,EAAE,GAAG,EAAE;QACX,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,sBAAsB,CAAe,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,SAAS,EAAE,GAAG,EAAE;;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;YAC/C,OAAO,CAAC,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,mCAAI,GAAG,CAAkB,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+export interface SentryConfig {
+    /** The project's DSN. Empty or absent: Sentry stays off. */
+    dsn?: string;
+    /** e.g. `ambermarie-production`. */
+    environment?: string;
+    /** 0–1. Absent: Sentry's default (no performance traces). */
+    tracesSampleRate?: number;
+    /** Off by default: on, Sentry attaches IP addresses and request headers to every event. */
+    sendDefaultPii?: boolean;
+    /**
+     * Tags on every event. In a project shared by several apps, `{ app: 'ambermarie' }` is what a
+     * dashboard filters by (Sentry still groups by stack trace across apps).
+     */
+    tags?: Record<string, string>;
+    /** Anything else `Sentry.init` takes, passed through as is. */
+    options?: Record<string, unknown>;
+    /** `false` turns Sentry off whatever the DSN. */
+    enabled?: boolean;
+}
+export interface LogRocketConfig {
+    /** `org/project`. Empty or absent: LogRocket stays off. */
+    appId?: string;
+    /** LogRocket's init options (redaction, network capture…), passed through as is. */
+    options?: Record<string, unknown>;
+    /** `false` turns LogRocket off whatever the app id. */
+    enabled?: boolean;
+}
+export interface MonitoringConfig {
+    sentry?: SentryConfig;
+    logRocket?: LogRocketConfig;
+    /**
+     * Report from development builds too. Off by default: a dev build (and the Tile preview) shows
+     * the error on screen already, and dev noise would bury real crashes.
+     */
+    enableInDev?: boolean;
+    /**
+     * Put the LogRocket session URL on every Sentry event (context `logrocket`), so a crash links
+     * to its replay. Default true; only applies when both are on.
+     */
+    linkReplayToCrashes?: boolean;
+}
+export interface MonitoringStatus {
+    sentry: boolean;
+    logRocket: boolean;
+}
+/** Customer traits for the replay. `null`/`undefined` values are dropped, never written as blanks. */
+export type UserTraits = Record<string, string | number | boolean | null | undefined>;
+/** Free-form detail sent with an error or warning. Keep it JSON-safe. */
+export type CaptureContext = Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,sGAAsG;AACtG,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEtF,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@tiledev/sdk-app-monitoring",
+  "version": "0.1.0",
+  "description": "Crash reporting (Sentry), session replay (LogRocket), one captureError/captureWarning seam and a root ErrorBoundary for TilePacket apps. Real on iOS/Android release builds, console-only on web and in development.",
+  "license": "UNLICENSED",
+  "private": false,
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "lint": "tsc --noEmit",
+    "test": "npm run build && node test/verify.js && node test/monitoring.test.js && node test/errorBoundary.test.js",
+    "prepublishOnly": "npm test"
+  },
+  "keywords": [
+    "tile",
+    "tilepacket",
+    "sentry",
+    "logrocket",
+    "crash-reporting",
+    "session-replay",
+    "error-boundary",
+    "react-native",
+    "expo"
+  ],
+  "peerDependencies": {
+    "@logrocket/react-native": ">=3.0.0",
+    "@sentry/react-native": ">=6.0.0",
+    "react": ">=17",
+    "react-native": ">=0.70"
+  },
+  "peerDependenciesMeta": {
+    "@logrocket/react-native": {
+      "optional": true
+    },
+    "@sentry/react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "~19.1.10",
+    "jsdom": "^24.1.3",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-native": "0.81.5",
+    "typescript": "^5.0.0"
+  }
+}