heimdall-react-native 0.1.0

package/README.md

@@ -0,0 +1,157 @@
+# heimdall-react-native
+
+Lightweight, fault-tolerant crash tracking for React Native iOS apps. Catches JS errors, unhandled promise rejections, and native iOS crashes (via KSCrash). Reports everything to Firebase Firestore.
+
+## Installation
+
+```bash
+npm install heimdall-react-native
+# or
+yarn add heimdall-react-native
+```
+
+### iOS Setup
+
+```bash
+cd ios && pod install
+```
+
+The KSCrash dependency is automatically linked via the podspec.
+
+### Peer Dependencies
+
+Make sure you have these installed:
+
+```bash
+npm install @react-native-async-storage/async-storage
+```
+
+## How It Works
+
+Heimdall uses **global-level hooks** built into React Native and iOS. You do NOT need to wrap your components or modify your code beyond a single `init()` call.
+
+| What's caught | How | Wrapping needed? |
+|---|---|---|
+| JS errors (crashes, thrown exceptions) | `ErrorUtils.setGlobalHandler()` -- RN routes ALL unhandled JS errors through this | No |
+| Unhandled promise rejections | Hermes `enablePromiseRejectionTracker` / JSC fallback | No |
+| Native iOS crashes (SIGSEGV, SIGABRT, OOM) | KSCrash signal handlers at OS level. Written to disk, sent on next launch | No |
+| React component render errors | Optional `<HeimdallErrorBoundary>` for custom fallback UI | Optional |
+
+## Usage
+
+### Minimal Setup (this is all you need)
+
+```typescript
+// App.tsx -- add this at the very top, before anything else
+import Heimdall from 'heimdall-react-native';
+
+Heimdall.init({
+  apiKey: 'hm_live_your-key-here',  // from the Heimdall dashboard
+  firebaseConfig: {                  // your Firebase project config
+    apiKey: '...',
+    authDomain: '...',
+    projectId: '...',
+    storageBucket: '...',
+    messagingSenderId: '...',
+    appId: '...',
+  },
+});
+
+export default function App() {
+  return <YourApp />;
+}
+```
+
+That's it. Every JS crash, unhandled promise rejection, and native iOS crash is now automatically captured and sent to your dashboard.
+
+### All Options
+
+```typescript
+Heimdall.init({
+  apiKey: 'hm_live_...',
+  firebaseConfig: { ... },          // required: your Firebase config
+  enableNativeCrashHandling: true,  // default: true
+  enableJsErrorHandler: true,       // default: true
+  enablePromiseRejectionHandler: true, // default: true
+  maxBreadcrumbs: 100,              // default: 100
+  debug: false,                     // default: false
+  beforeSend: (event) => {
+    // Modify or filter events before sending
+    // Return null to drop the event
+    return event;
+  },
+});
+```
+
+### Manual Error Capture
+
+```typescript
+try {
+  riskyOperation();
+} catch (error) {
+  Heimdall.captureException(error);
+}
+
+Heimdall.captureMessage('User did something unexpected', 'warning');
+```
+
+### Breadcrumbs
+
+```typescript
+Heimdall.addBreadcrumb({
+  category: 'navigation',
+  message: 'Navigated to Settings',
+});
+
+Heimdall.addBreadcrumb({
+  category: 'api',
+  message: 'POST /api/checkout failed',
+  level: 'error',
+  data: { statusCode: 500 },
+});
+```
+
+### User Context
+
+```typescript
+Heimdall.setUser({
+  id: 'user-123',
+  email: 'user@example.com',
+});
+
+// Clear on logout
+Heimdall.clearUser();
+```
+
+### Error Boundary (optional)
+
+This is **optional**. Without it, component crashes are still caught by the global JS handler above. The boundary only adds a custom fallback UI instead of a white/red screen.
+
+```tsx
+import { HeimdallErrorBoundary } from 'heimdall-react-native';
+
+function App() {
+  return (
+    <HeimdallErrorBoundary fallback={<Text>Something went wrong</Text>}>
+      <MyApp />
+    </HeimdallErrorBoundary>
+  );
+}
+```
+
+## Fault Tolerance
+
+Heimdall is designed to **never** affect your app:
+
+- All operations are wrapped in try-catch
+- `init()` failure = silent no-op
+- Network failures queue events for retry on next launch
+- Original error handlers are always chained (red screen still works in dev)
+- All Firestore writes are async and non-blocking
+- Init is deferred via `setTimeout(0)` to never block app startup
+
+## Architecture
+
+- **JS Layer**: Catches unhandled JS errors via `ErrorUtils.setGlobalHandler()`, promise rejections (Hermes & JSC aware), and React component errors via Error Boundary
+- **Native Layer**: Uses KSCrash to catch native iOS crashes (signals, Mach exceptions, ObjC exceptions). Crash reports are written to disk and sent on next launch
+- **Transport**: Events go to Firebase Firestore. Failed sends are queued to AsyncStorage and retried

package/heimdall-react-native.podspec

@@ -0,0 +1,18 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = "heimdall-react-native"
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.homepage     = "https://github.com/heimdall-rn/heimdall-react-native"
+  s.license      = package['license']
+  s.author       = "Heimdall"
+  s.platform     = :ios, "13.0"
+  s.source       = { :git => "https://github.com/heimdall-rn/heimdall-react-native.git", :tag => s.version }
+  s.source_files = "ios/**/*.{h,m}"
+
+  s.dependency "React-Core"
+  s.dependency "KSCrash", "~> 2.0"
+end

package/ios/HeimdallNative.h

@@ -0,0 +1,4 @@
+#import <React/RCTBridgeModule.h>
+
+@interface HeimdallNative : NSObject <RCTBridgeModule>
+@end

package/ios/HeimdallNative.m

@@ -0,0 +1,151 @@
+#import "HeimdallNative.h"
+#import <React/RCTLog.h>
+#import <sys/utsname.h>
+#import <mach/mach.h>
+#import <KSCrash/KSCrash.h>
+#import <KSCrash/KSCrashReportFilterBasic.h>
+
+@implementation HeimdallNative
+
+RCT_EXPORT_MODULE();
+
++ (BOOL)requiresMainQueueSetup {
+    return NO;
+}
+
+RCT_EXPORT_METHOD(startNativeHandler) {
+    dispatch_async(dispatch_get_main_queue(), ^{
+        @try {
+            KSCrash *handler = [KSCrash sharedInstance];
+            [handler install];
+            RCTLogInfo(@"[Heimdall] Native crash handler installed");
+        } @catch (NSException *exception) {
+            RCTLogWarn(@"[Heimdall] Failed to install native crash handler: %@", exception.reason);
+        }
+    });
+}
+
+RCT_EXPORT_METHOD(getPendingCrashReports:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    @try {
+        KSCrash *handler = [KSCrash sharedInstance];
+        
+        [handler reportCount];
+        
+        [handler allReports:^(NSArray *reports) {
+            if (!reports || reports.count == 0) {
+                resolve(@[]);
+                return;
+            }
+            
+            NSMutableArray *parsed = [NSMutableArray array];
+            
+            for (NSDictionary *report in reports) {
+                @try {
+                    NSDictionary *crash = report[@"crash"];
+                    NSDictionary *error = crash[@"error"];
+                    NSArray *threads = crash[@"threads"];
+                    
+                    NSString *type = error[@"type"] ?: @"Unknown";
+                    NSString *reason = error[@"reason"] ?: @"Native crash";
+                    
+                    if ([type isEqualToString:@"nsexception"]) {
+                        NSDictionary *nsException = error[@"nsexception"];
+                        if (nsException) {
+                            type = nsException[@"name"] ?: type;
+                            reason = nsException[@"reason"] ?: reason;
+                        }
+                    } else if ([type isEqualToString:@"signal"]) {
+                        NSDictionary *signal = error[@"signal"];
+                        if (signal) {
+                            type = signal[@"name"] ?: type;
+                        }
+                    } else if ([type isEqualToString:@"mach"]) {
+                        NSDictionary *mach = error[@"mach"];
+                        if (mach) {
+                            type = mach[@"exception_name"] ?: type;
+                        }
+                    }
+                    
+                    NSMutableArray *stacktrace = [NSMutableArray array];
+                    
+                    NSDictionary *crashedThread = nil;
+                    for (NSDictionary *thread in threads) {
+                        if ([thread[@"crashed"] boolValue]) {
+                            crashedThread = thread;
+                            break;
+                        }
+                    }
+                    
+                    NSArray *backtrace = crashedThread[@"backtrace"][@"contents"];
+                    if (backtrace) {
+                        for (NSDictionary *frame in backtrace) {
+                            [stacktrace addObject:@{
+                                @"filename": frame[@"object_name"] ?: @"<unknown>",
+                                @"function": frame[@"symbol_name"] ?: @"<unknown>",
+                                @"lineno": frame[@"instruction_addr"] ?: @0,
+                                @"colno": @0,
+                                @"in_app": @(![frame[@"object_name"] hasPrefix:@"/usr"])
+                            }];
+                        }
+                    }
+                    
+                    [parsed addObject:@{
+                        @"type": type,
+                        @"value": reason,
+                        @"stacktrace": stacktrace
+                    }];
+                } @catch (NSException *exception) {
+                    RCTLogWarn(@"[Heimdall] Failed to parse crash report: %@", exception.reason);
+                }
+            }
+            
+            // Delete the reports after reading
+            [handler deleteAllReports];
+            
+            resolve(parsed);
+        }];
+    } @catch (NSException *exception) {
+        resolve(@[]);
+    }
+}
+
+RCT_EXPORT_METHOD(getDeviceInfo:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    @try {
+        struct utsname systemInfo;
+        uname(&systemInfo);
+        NSString *model = [NSString stringWithCString:systemInfo.machine encoding:NSUTF8StringEncoding];
+        
+        NSString *osVersion = [[UIDevice currentDevice] systemVersion];
+        
+        mach_port_t hostPort = mach_host_self();
+        vm_size_t pageSize;
+        host_page_size(hostPort, &pageSize);
+        
+        vm_statistics64_data_t vmStats;
+        mach_msg_type_number_t infoCount = HOST_VM_INFO64_COUNT;
+        host_statistics64(hostPort, HOST_VM_INFO64, (host_info64_t)&vmStats, &infoCount);
+        
+        unsigned long long freeMemory = (unsigned long long)vmStats.free_count * (unsigned long long)pageSize;
+        
+        NSDictionary *attrs = [[NSFileManager defaultManager] attributesOfFileSystemForPath:NSHomeDirectory() error:nil];
+        unsigned long long freeDisk = [attrs[NSFileSystemFreeSize] unsignedLongLongValue];
+        
+        resolve(@{
+            @"model": model ?: @"Unknown",
+            @"osVersion": osVersion ?: @"Unknown",
+            @"freeMemory": @(freeMemory),
+            @"freeDisk": @(freeDisk)
+        });
+    } @catch (NSException *exception) {
+        resolve(@{
+            @"model": @"Unknown",
+            @"osVersion": @"Unknown",
+            @"freeMemory": @0,
+            @"freeDisk": @0
+        });
+    }
+}
+
+@end

package/lib/breadcrumbs.d.ts

@@ -0,0 +1,12 @@
+import { Breadcrumb } from './types';
+export declare class BreadcrumbTracker {
+    private buffer;
+    private maxSize;
+    constructor(maxSize?: number);
+    add(crumb: Omit<Breadcrumb, 'timestamp'> & {
+        timestamp?: number;
+    }): void;
+    getAll(): Breadcrumb[];
+    clear(): void;
+}
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/lib/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAY;IAIjC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBxE,MAAM,IAAI,UAAU,EAAE;IAItB,KAAK,IAAI,IAAI;CAGd"}

package/lib/breadcrumbs.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BreadcrumbTracker = void 0;
+class BreadcrumbTracker {
+    constructor(maxSize = 100) {
+        this.buffer = [];
+        this.maxSize = maxSize;
+    }
+    add(crumb) {
+        const breadcrumb = {
+            timestamp: crumb.timestamp ?? Date.now(),
+            category: crumb.category,
+            message: crumb.message,
+            level: crumb.level,
+            data: crumb.data,
+        };
+        this.buffer.push(breadcrumb);
+        if (this.buffer.length > this.maxSize) {
+            this.buffer = this.buffer.slice(-this.maxSize);
+        }
+    }
+    getAll() {
+        return [...this.buffer];
+    }
+    clear() {
+        this.buffer = [];
+    }
+}
+exports.BreadcrumbTracker = BreadcrumbTracker;
+//# sourceMappingURL=breadcrumbs.js.map

package/lib/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAI5B,YAAY,UAAkB,GAAG;QAHzB,WAAM,GAAiB,EAAE,CAAC;QAIhC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,KAA6D;QAC/D,MAAM,UAAU,GAAe;YAC7B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE7B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AA/BD,8CA+BC"}

package/lib/client.d.ts

@@ -0,0 +1,26 @@
+import { HeimdallConfig, EventLevel, UserContext, Breadcrumb } from './types';
+declare class HeimdallClient {
+    private config;
+    private breadcrumbs;
+    private user;
+    private tags;
+    private initialized;
+    private appId;
+    init(config: HeimdallConfig): void;
+    private setupHandlers;
+    private setupFirebase;
+    private checkPendingNativeCrashes;
+    captureException(error: Error, level?: EventLevel): void;
+    captureMessage(message: string, level?: EventLevel): void;
+    addBreadcrumb(crumb: Omit<Breadcrumb, 'timestamp'>): void;
+    setUser(user: UserContext): void;
+    setTag(key: string, value: string): void;
+    clearUser(): void;
+    private captureError;
+    private buildEvent;
+    private dispatchEvent;
+    destroy(): void;
+}
+export declare const heimdallClient: HeimdallClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EAId,UAAU,EAEV,WAAW,EACX,UAAU,EACX,MAAM,SAAS,CAAC;AAyDjB,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAc;IAE3B,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IA6BlC,OAAO,CAAC,aAAa;YA6BP,aAAa;YAQb,yBAAyB;IAiCvC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI;IAMxD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI;IAczD,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI;IAMzD,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAMhC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMxC,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,YAAY;YAeN,UAAU;YAkCV,aAAa;IAY3B,OAAO,IAAI,IAAI;CAUhB;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/lib/client.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.heimdallClient = void 0;
+const react_native_1 = require("react-native");
+const safeExec_1 = require("./safeExec");
+const breadcrumbs_1 = require("./breadcrumbs");
+const context_1 = require("./context");
+const fingerprint_1 = require("./fingerprint");
+const transport_1 = require("./transport");
+const jsErrorHandler_1 = require("./handlers/jsErrorHandler");
+const promiseHandler_1 = require("./handlers/promiseHandler");
+function generateId() {
+    return 'hm_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
+}
+function parseStackTrace(stack) {
+    if (!stack)
+        return [];
+    const frames = [];
+    const lines = stack.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // RN format: "at functionName (filename:line:col)" or "functionName@filename:line:col"
+        const atMatch = trimmed.match(/^at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)$/);
+        const atAnonMatch = trimmed.match(/^at\s+(.+?):(\d+):(\d+)$/);
+        const hermeMatch = trimmed.match(/^(.+?)@(.+?):(\d+):(\d+)$/);
+        if (atMatch) {
+            frames.push({
+                function: atMatch[1],
+                filename: atMatch[2],
+                lineno: parseInt(atMatch[3], 10),
+                colno: parseInt(atMatch[4], 10),
+                in_app: !atMatch[2].includes('node_modules'),
+            });
+        }
+        else if (hermeMatch) {
+            frames.push({
+                function: hermeMatch[1],
+                filename: hermeMatch[2],
+                lineno: parseInt(hermeMatch[3], 10),
+                colno: parseInt(hermeMatch[4], 10),
+                in_app: !hermeMatch[2].includes('node_modules'),
+            });
+        }
+        else if (atAnonMatch) {
+            frames.push({
+                function: '<anonymous>',
+                filename: atAnonMatch[1],
+                lineno: parseInt(atAnonMatch[2], 10),
+                colno: parseInt(atAnonMatch[3], 10),
+                in_app: !atAnonMatch[1].includes('node_modules'),
+            });
+        }
+    }
+    return frames;
+}
+class HeimdallClient {
+    constructor() {
+        this.config = null;
+        this.breadcrumbs = new breadcrumbs_1.BreadcrumbTracker();
+        this.tags = {};
+        this.initialized = false;
+        this.appId = '';
+    }
+    init(config) {
+        (0, safeExec_1.safeExec)(() => {
+            if (this.initialized)
+                return;
+            this.config = {
+                enableNativeCrashHandling: true,
+                enableJsErrorHandler: true,
+                enablePromiseRejectionHandler: true,
+                maxBreadcrumbs: 100,
+                debug: false,
+                ...config,
+            };
+            if (this.config.debug) {
+                (0, safeExec_1.setDebugMode)(true);
+            }
+            this.breadcrumbs = new breadcrumbs_1.BreadcrumbTracker(this.config.maxBreadcrumbs);
+            // Defer all setup so it never blocks app startup
+            setTimeout(() => {
+                (0, safeExec_1.safeExec)(() => this.setupHandlers());
+                (0, safeExec_1.safeExecAsync)(() => this.setupFirebase());
+            }, 0);
+            this.initialized = true;
+        });
+    }
+    setupHandlers() {
+        if (!this.config)
+            return;
+        if (this.config.enableJsErrorHandler) {
+            (0, jsErrorHandler_1.installJsErrorHandler)((error, isFatal) => {
+                this.captureError(error, isFatal ? 'fatal' : 'error', 'jsHandler');
+            });
+        }
+        if (this.config.enablePromiseRejectionHandler) {
+            (0, promiseHandler_1.installPromiseHandler)((reason) => {
+                const error = reason instanceof Error ? reason : new Error(String(reason));
+                this.captureError(error, 'error', 'promiseRejection');
+            });
+        }
+        if (this.config.enableNativeCrashHandling) {
+            (0, safeExec_1.safeExec)(() => {
+                const HeimdallNative = react_native_1.NativeModules.HeimdallNative;
+                if (HeimdallNative) {
+                    (0, context_1.setNativeModule)(HeimdallNative);
+                    HeimdallNative.startNativeHandler?.();
+                    (0, safeExec_1.safeExecAsync)(() => this.checkPendingNativeCrashes());
+                }
+            });
+        }
+    }
+    async setupFirebase() {
+        await (0, safeExec_1.safeExecAsync)(async () => {
+            if (!this.config?.firebaseConfig)
+                return;
+            (0, transport_1.initFirebase)(this.config.firebaseConfig);
+            await (0, transport_1.sendPendingEvents)();
+        });
+    }
+    async checkPendingNativeCrashes() {
+        const HeimdallNative = react_native_1.NativeModules.HeimdallNative;
+        if (!HeimdallNative?.getPendingCrashReports)
+            return;
+        const reports = await HeimdallNative.getPendingCrashReports();
+        if (!reports || !Array.isArray(reports))
+            return;
+        for (const report of reports) {
+            await (0, safeExec_1.safeExecAsync)(async () => {
+                const stacktrace = (report.stacktrace ?? []).map((f) => ({
+                    filename: f.filename ?? '<unknown>',
+                    function: f.function ?? '<unknown>',
+                    lineno: f.lineno ?? 0,
+                    colno: f.colno ?? 0,
+                    in_app: f.in_app ?? false,
+                }));
+                const event = await this.buildEvent(report.type ?? 'SIGABRT', report.value ?? 'Native crash', stacktrace, 'nativeCrash', 'fatal', 'crash');
+                await this.dispatchEvent(event);
+            });
+        }
+    }
+    captureException(error, level) {
+        (0, safeExec_1.safeExec)(() => {
+            this.captureError(error, level ?? 'error', 'manual');
+        });
+    }
+    captureMessage(message, level) {
+        (0, safeExec_1.safeExecAsync)(async () => {
+            const event = await this.buildEvent('Message', message, [], 'manual', level ?? 'info', 'message');
+            await this.dispatchEvent(event);
+        });
+    }
+    addBreadcrumb(crumb) {
+        (0, safeExec_1.safeExec)(() => {
+            this.breadcrumbs.add(crumb);
+        });
+    }
+    setUser(user) {
+        (0, safeExec_1.safeExec)(() => {
+            this.user = user;
+        });
+    }
+    setTag(key, value) {
+        (0, safeExec_1.safeExec)(() => {
+            this.tags[key] = value;
+        });
+    }
+    clearUser() {
+        this.user = undefined;
+    }
+    captureError(error, level, mechanism) {
+        (0, safeExec_1.safeExecAsync)(async () => {
+            const stacktrace = parseStackTrace(error.stack);
+            const event = await this.buildEvent(error.name || 'Error', error.message || 'Unknown error', stacktrace, mechanism, level, level === 'fatal' ? 'crash' : 'error');
+            await this.dispatchEvent(event);
+        });
+    }
+    async buildEvent(errorType, errorValue, stacktrace, mechanism, level, type) {
+        const device = await (0, context_1.getDeviceContext)(this.config?.apiKey ? undefined : undefined);
+        const fingerprint = (0, fingerprint_1.generateFingerprint)(errorType, errorValue, stacktrace);
+        return {
+            id: generateId(),
+            apiKey: this.config?.apiKey ?? '',
+            appId: this.appId,
+            type,
+            level,
+            timestamp: Date.now(),
+            fingerprint,
+            exception: {
+                type: errorType,
+                value: errorValue,
+                stacktrace,
+                mechanism,
+            },
+            device,
+            breadcrumbs: this.breadcrumbs.getAll(),
+            user: this.user,
+            tags: Object.keys(this.tags).length > 0 ? { ...this.tags } : undefined,
+        };
+    }
+    async dispatchEvent(event) {
+        if (!this.config)
+            return;
+        if (this.config.beforeSend) {
+            const modified = this.config.beforeSend(event);
+            if (!modified)
+                return;
+            event = modified;
+        }
+        await (0, safeExec_1.safeExecAsync)(() => (0, transport_1.sendEvent)(event));
+    }
+    destroy() {
+        (0, safeExec_1.safeExec)(() => {
+            (0, jsErrorHandler_1.uninstallJsErrorHandler)();
+            (0, promiseHandler_1.uninstallPromiseHandler)();
+            (0, context_1.clearContextCache)();
+            this.breadcrumbs.clear();
+            this.initialized = false;
+            this.config = null;
+        });
+    }
+}
+exports.heimdallClient = new HeimdallClient();
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

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

package/lib/context.d.ts

@@ -0,0 +1,5 @@
+import { DeviceContext } from './types';
+export declare function setNativeModule(mod: any): void;
+export declare function getDeviceContext(appVersion?: string, buildNumber?: string): Promise<DeviceContext>;
+export declare function clearContextCache(): void;
+//# sourceMappingURL=context.d.ts.map

package/lib/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMxC,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE9C;AAED,wBAAsB,gBAAgB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CAkCxB;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}