@logbrew/react-native 0.1.2 → 0.1.4

package/global-errors.d.cts

@@ -10,7 +10,14 @@ export type ReactNativeErrorUtilsLike = {
 export type ReactNativeGlobalErrorDiagnosticCode =
   | "capture_failed"
   | "duplicate_capture_suppressed"
+  | "fatal_acknowledge_failed"
   | "fatal_capture_requires_sync_store"
+  | "fatal_corrupt_record_discarded"
+  | "fatal_discard_failed"
+  | "fatal_record_dropped"
+  | "fatal_replay_failed"
+  | "fatal_replay_not_admitted"
+  | "fatal_store_failed"
   | "handler_unavailable"
   | "recursive_capture_suppressed";
 
@@ -25,6 +32,8 @@ export type ReactNativeGlobalErrorHealth = Readonly<{
     | "capture_failed"
     | "captured"
     | "duplicate_suppressed"
+    | "fatal_stored"
+    | "fatal_store_failed"
     | "fatal_unsupported"
     | "handler_replaced"
     | "idle"
@@ -35,22 +44,81 @@ export type ReactNativeGlobalErrorHealth = Readonly<{
   suppressedEvents: number;
 }>;
 
+export type ReactNativeFatalRecord = Readonly<{
+  corruptRecords: number;
+  droppedRecords: number;
+  errorName: string;
+  id: string;
+  schemaVersion: 1;
+  stackFrames: ReadonlyArray<Readonly<{
+    column: number;
+    filename: string;
+    line: number;
+  }>>;
+  timestamp: string;
+}>;
+
+export type ReactNativeFatalStoreResult = Readonly<{
+  corruptRecords?: number;
+  droppedRecords?: number;
+  record?: ReactNativeFatalRecord;
+  recordId?: string;
+  status: string;
+}>;
+
+export type ReactNativeFatalStoreLike = {
+  writeFatalRecord(record: ReactNativeFatalRecord): ReactNativeFatalStoreResult;
+  readFatalRecord(): ReactNativeFatalStoreResult;
+  acknowledgeFatalRecord(recordId: string): ReactNativeFatalStoreResult;
+  discardFatalRecord(): ReactNativeFatalStoreResult;
+};
+
+export type ReactNativeFatalReplayHealth = Readonly<{
+  acknowledgedRecords: number;
+  available: boolean;
+  corruptRecords: number;
+  droppedRecords: number;
+  lastOutcome:
+    | "acknowledge_failed"
+    | "acknowledged"
+    | "corrupt_discarded"
+    | "discard_failed"
+    | "discarded"
+    | "dropped_pending"
+    | "empty"
+    | "idle"
+    | "replay_failed"
+    | "replay_not_admitted"
+    | "storage_error"
+    | "stored"
+    | "stored_after_corruption"
+    | "unavailable";
+  replayedRecords: number;
+  storedRecords: number;
+}>;
+
 export type InstallLogBrewReactNativeGlobalErrorHandlerOptions = {
-  client: Pick<LogBrewClient, "issue">;
+  client: Pick<LogBrewClient, "issue">
+    & Partial<Pick<LogBrewClient, "droppedEvents" | "pendingEvents">>;
   errorUtils?: ReactNativeErrorUtilsLike;
+  fatalStore?: ReactNativeFatalStoreLike;
   onDiagnostic?: (diagnostic: ReactNativeGlobalErrorDiagnostic) => void;
 };
 
 export type LogBrewReactNativeGlobalErrorHandlerInstallation = Readonly<{
+  discardPendingFatalRecord(): boolean;
+  fatalHealth(): ReactNativeFatalReplayHealth;
   health(): ReactNativeGlobalErrorHealth;
   remove(): boolean;
 }>;
 
 /**
- * Install reversible automatic capture for nonfatal React Native global JavaScript errors.
+ * Install reversible automatic capture for React Native global JavaScript errors.
  *
- * Fatal errors are chained without capture until a synchronous native durable handoff is
- * available. This helper does not install Promise rejection handling.
+ * The React Native conditional export injects its synchronous native fatal store by default.
+ * Direct Node ESM/CJS callers can inject a compatible store explicitly. Fatal replay is
+ * stable-ID at-least-once and acknowledges only after observable local queue admission.
+ * This helper does not claim local exactly-once delivery or install Promise rejection handling.
  */
 export declare function installLogBrewReactNativeGlobalErrorHandler(
   options: InstallLogBrewReactNativeGlobalErrorHandlerOptions

package/global-errors.d.ts

@@ -10,7 +10,14 @@ export type ReactNativeErrorUtilsLike = {
 export type ReactNativeGlobalErrorDiagnosticCode =
   | "capture_failed"
   | "duplicate_capture_suppressed"
+  | "fatal_acknowledge_failed"
   | "fatal_capture_requires_sync_store"
+  | "fatal_corrupt_record_discarded"
+  | "fatal_discard_failed"
+  | "fatal_record_dropped"
+  | "fatal_replay_failed"
+  | "fatal_replay_not_admitted"
+  | "fatal_store_failed"
   | "handler_unavailable"
   | "recursive_capture_suppressed";
 
@@ -25,6 +32,8 @@ export type ReactNativeGlobalErrorHealth = Readonly<{
     | "capture_failed"
     | "captured"
     | "duplicate_suppressed"
+    | "fatal_stored"
+    | "fatal_store_failed"
     | "fatal_unsupported"
     | "handler_replaced"
     | "idle"
@@ -35,22 +44,81 @@ export type ReactNativeGlobalErrorHealth = Readonly<{
   suppressedEvents: number;
 }>;
 
+export type ReactNativeFatalRecord = Readonly<{
+  corruptRecords: number;
+  droppedRecords: number;
+  errorName: string;
+  id: string;
+  schemaVersion: 1;
+  stackFrames: ReadonlyArray<Readonly<{
+    column: number;
+    filename: string;
+    line: number;
+  }>>;
+  timestamp: string;
+}>;
+
+export type ReactNativeFatalStoreResult = Readonly<{
+  corruptRecords?: number;
+  droppedRecords?: number;
+  record?: ReactNativeFatalRecord;
+  recordId?: string;
+  status: string;
+}>;
+
+export type ReactNativeFatalStoreLike = {
+  writeFatalRecord(record: ReactNativeFatalRecord): ReactNativeFatalStoreResult;
+  readFatalRecord(): ReactNativeFatalStoreResult;
+  acknowledgeFatalRecord(recordId: string): ReactNativeFatalStoreResult;
+  discardFatalRecord(): ReactNativeFatalStoreResult;
+};
+
+export type ReactNativeFatalReplayHealth = Readonly<{
+  acknowledgedRecords: number;
+  available: boolean;
+  corruptRecords: number;
+  droppedRecords: number;
+  lastOutcome:
+    | "acknowledge_failed"
+    | "acknowledged"
+    | "corrupt_discarded"
+    | "discard_failed"
+    | "discarded"
+    | "dropped_pending"
+    | "empty"
+    | "idle"
+    | "replay_failed"
+    | "replay_not_admitted"
+    | "storage_error"
+    | "stored"
+    | "stored_after_corruption"
+    | "unavailable";
+  replayedRecords: number;
+  storedRecords: number;
+}>;
+
 export type InstallLogBrewReactNativeGlobalErrorHandlerOptions = {
-  client: Pick<LogBrewClient, "issue">;
+  client: Pick<LogBrewClient, "issue">
+    & Partial<Pick<LogBrewClient, "droppedEvents" | "pendingEvents">>;
   errorUtils?: ReactNativeErrorUtilsLike;
+  fatalStore?: ReactNativeFatalStoreLike;
   onDiagnostic?: (diagnostic: ReactNativeGlobalErrorDiagnostic) => void;
 };
 
 export type LogBrewReactNativeGlobalErrorHandlerInstallation = Readonly<{
+  discardPendingFatalRecord(): boolean;
+  fatalHealth(): ReactNativeFatalReplayHealth;
   health(): ReactNativeGlobalErrorHealth;
   remove(): boolean;
 }>;
 
 /**
- * Install reversible automatic capture for nonfatal React Native global JavaScript errors.
+ * Install reversible automatic capture for React Native global JavaScript errors.
  *
- * Fatal errors are chained without capture until a synchronous native durable handoff is
- * available. This helper does not install Promise rejection handling.
+ * The React Native conditional export injects its synchronous native fatal store by default.
+ * Direct Node ESM/CJS callers can inject a compatible store explicitly. Fatal replay is
+ * stable-ID at-least-once and acknowledges only after observable local queue admission.
+ * This helper does not claim local exactly-once delivery or install Promise rejection handling.
  */
 export declare function installLogBrewReactNativeGlobalErrorHandler(
   options: InstallLogBrewReactNativeGlobalErrorHandlerOptions

package/global-errors.native.js

@@ -0,0 +1,39 @@
+import { NativeModules, TurboModuleRegistry } from "react-native";
+
+import {
+  installLogBrewReactNativeGlobalErrorHandler as installPlatformNeutralHandler
+} from "./global-errors.js";
+
+function defaultFatalStore() {
+  try {
+    return TurboModuleRegistry?.get?.("LogBrewFatalStore")
+      ?? NativeModules?.LogBrewFatalStore;
+  } catch {
+    return undefined;
+  }
+}
+
+export function installLogBrewReactNativeGlobalErrorHandler(options = {}) {
+  let forwarded;
+  let hasInjectedStore = false;
+  try {
+    const input = options !== null
+      && (typeof options === "object" || typeof options === "function")
+      ? options
+      : {};
+    hasInjectedStore = Object.prototype.hasOwnProperty.call(input, "fatalStore");
+    forwarded = { ...input };
+  } catch {
+    forwarded = {};
+  }
+  return installPlatformNeutralHandler({
+    ...forwarded,
+    fatalStore: hasInjectedStore ? forwarded.fatalStore : defaultFatalStore()
+  });
+}
+
+const logBrewReactNativeGlobalErrors = {
+  installLogBrewReactNativeGlobalErrorHandler
+};
+
+export default logBrewReactNativeGlobalErrors;

package/index.native.d.ts

@@ -0,0 +1,2 @@
+export * from "./index";
+export { installLogBrewReactNativeGlobalErrorHandler } from "./global-errors";

package/index.native.js

@@ -9,6 +9,9 @@ import {
   createLogBrewReactNativeClient,
   getReactNativeContext
 } from "./index.js";
+export {
+  installLogBrewReactNativeGlobalErrorHandler
+} from "./global-errors.native.js";
 
 export * from "./index.js";
 

package/ios/LBRNFatalRecordStore.h

@@ -0,0 +1,25 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+FOUNDATION_EXPORT NSString *const LBRNFatalRecordFileName;
+FOUNDATION_EXPORT NSString *const LBRNFatalRecordTemporaryFileName;
+
+typedef BOOL (^LBRNFatalDirectoryPreparation)(NSURL *directoryURL);
+
+@interface LBRNFatalRecordStore : NSObject
+
+- (instancetype)initWithDirectoryURL:(NSURL *)directoryURL;
+- (instancetype)initWithDirectoryURL:(NSURL *)directoryURL
+                directoryPreparation:(LBRNFatalDirectoryPreparation)directoryPreparation
+    NS_DESIGNATED_INITIALIZER;
+- (instancetype)init NS_UNAVAILABLE;
+
+- (NSDictionary *)writeRecord:(NSDictionary *)record;
+- (NSDictionary *)readRecord;
+- (NSDictionary *)acknowledgeRecordId:(NSString *)recordId;
+- (NSDictionary *)discardRecord;
+
+@end
+
+NS_ASSUME_NONNULL_END