@tanstack/offline-transactions 1.0.9 → 1.0.11

package/dist/esm/react-native/OfflineExecutor.d.ts

@@ -0,0 +1,14 @@
+import { OfflineExecutor as BaseOfflineExecutor } from '../OfflineExecutor.js';
+import { OfflineConfig } from '../types.js';
+/**
+ * OfflineExecutor configured for React Native environments.
+ * Uses ReactNativeOnlineDetector by default instead of WebOnlineDetector.
+ */
+export declare class OfflineExecutor extends BaseOfflineExecutor {
+    constructor(config: OfflineConfig);
+}
+/**
+ * Start an offline executor configured for React Native environments.
+ * Uses ReactNativeOnlineDetector by default instead of WebOnlineDetector.
+ */
+export declare function startOfflineExecutor(config: OfflineConfig): OfflineExecutor;

package/dist/esm/react-native/OfflineExecutor.js

@@ -0,0 +1,18 @@
+import { OfflineExecutor as OfflineExecutor$1 } from "../OfflineExecutor.js";
+import { ReactNativeOnlineDetector } from "../connectivity/ReactNativeOnlineDetector.js";
+class OfflineExecutor extends OfflineExecutor$1 {
+  constructor(config) {
+    super({
+      ...config,
+      onlineDetector: config.onlineDetector ?? new ReactNativeOnlineDetector()
+    });
+  }
+}
+function startOfflineExecutor(config) {
+  return new OfflineExecutor(config);
+}
+export {
+  OfflineExecutor,
+  startOfflineExecutor
+};
+//# sourceMappingURL=OfflineExecutor.js.map

package/dist/esm/react-native/OfflineExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineExecutor.js","sources":["../../../src/react-native/OfflineExecutor.ts"],"sourcesContent":["import { OfflineExecutor as BaseOfflineExecutor } from '../OfflineExecutor'\nimport { ReactNativeOnlineDetector } from '../connectivity/ReactNativeOnlineDetector'\nimport type { OfflineConfig } from '../types'\n\n/**\n * OfflineExecutor configured for React Native environments.\n * Uses ReactNativeOnlineDetector by default instead of WebOnlineDetector.\n */\nexport class OfflineExecutor extends BaseOfflineExecutor {\n  constructor(config: OfflineConfig) {\n    super({\n      ...config,\n      onlineDetector: config.onlineDetector ?? new ReactNativeOnlineDetector(),\n    })\n  }\n}\n\n/**\n * Start an offline executor configured for React Native environments.\n * Uses ReactNativeOnlineDetector by default instead of WebOnlineDetector.\n */\nexport function startOfflineExecutor(config: OfflineConfig): OfflineExecutor {\n  return new OfflineExecutor(config)\n}\n"],"names":["BaseOfflineExecutor"],"mappings":";;AAQO,MAAM,wBAAwBA,kBAAoB;AAAA,EACvD,YAAY,QAAuB;AACjC,UAAM;AAAA,MACJ,GAAG;AAAA,MACH,gBAAgB,OAAO,kBAAkB,IAAI,0BAAA;AAAA,IAA0B,CACxE;AAAA,EACH;AACF;AAMO,SAAS,qBAAqB,QAAwC;AAC3E,SAAO,IAAI,gBAAgB,MAAM;AACnC;"}

package/dist/esm/react-native/index.d.ts

@@ -0,0 +1,3 @@
+export { type OfflineTransaction, type OfflineConfig, type OfflineMode, type StorageAdapter, type StorageDiagnostic, type StorageDiagnosticCode, type RetryPolicy, type LeaderElection, type OnlineDetector, type CreateOfflineTransactionOptions, type CreateOfflineActionOptions, type SerializedError, type SerializedMutation, NonRetriableError, IndexedDBAdapter, LocalStorageAdapter, DefaultRetryPolicy, BackoffCalculator, WebLocksLeader, BroadcastChannelLeader, WebOnlineDetector, DefaultOnlineDetector, OfflineTransactionAPI, createOfflineAction, OutboxManager, TransactionSerializer, KeyScheduler, TransactionExecutor, } from '../index.js';
+export { ReactNativeOnlineDetector } from '../connectivity/ReactNativeOnlineDetector.js';
+export { OfflineExecutor, startOfflineExecutor } from './OfflineExecutor.js';

package/dist/esm/react-native/index.js

@@ -0,0 +1,37 @@
+import { NonRetriableError } from "../types.js";
+import { IndexedDBAdapter } from "../storage/IndexedDBAdapter.js";
+import { LocalStorageAdapter } from "../storage/LocalStorageAdapter.js";
+import { DefaultRetryPolicy } from "../retry/RetryPolicy.js";
+import { BackoffCalculator } from "../retry/BackoffCalculator.js";
+import { WebLocksLeader } from "../coordination/WebLocksLeader.js";
+import { BroadcastChannelLeader } from "../coordination/BroadcastChannelLeader.js";
+import { DefaultOnlineDetector, WebOnlineDetector } from "../connectivity/OnlineDetector.js";
+import { OfflineTransaction } from "../api/OfflineTransaction.js";
+import { createOfflineAction } from "../api/OfflineAction.js";
+import { OutboxManager } from "../outbox/OutboxManager.js";
+import { TransactionSerializer } from "../outbox/TransactionSerializer.js";
+import { KeyScheduler } from "../executor/KeyScheduler.js";
+import { TransactionExecutor } from "../executor/TransactionExecutor.js";
+import { ReactNativeOnlineDetector } from "../connectivity/ReactNativeOnlineDetector.js";
+import { OfflineExecutor, startOfflineExecutor } from "./OfflineExecutor.js";
+export {
+  BackoffCalculator,
+  BroadcastChannelLeader,
+  DefaultOnlineDetector,
+  DefaultRetryPolicy,
+  IndexedDBAdapter,
+  KeyScheduler,
+  LocalStorageAdapter,
+  NonRetriableError,
+  OfflineExecutor,
+  OfflineTransaction as OfflineTransactionAPI,
+  OutboxManager,
+  ReactNativeOnlineDetector,
+  TransactionExecutor,
+  TransactionSerializer,
+  WebLocksLeader,
+  WebOnlineDetector,
+  createOfflineAction,
+  startOfflineExecutor
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/react-native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/dist/esm/types.d.ts

@@ -8,6 +8,7 @@ export interface SerializedMutation {
     type: string;
     modified: any;
     original: any;
+    changes: any;
     collectionId: string;
 }
 export interface SerializedError {
@@ -41,7 +42,7 @@ export interface SerializedOfflineTransaction {
     mutations: Array<SerializedMutation>;
     keys: Array<string>;
     idempotencyKey: string;
-    createdAt: Date;
+    createdAt: string;
     retryCount: number;
     nextAttemptAt: number;
     lastError?: SerializedError;
@@ -68,6 +69,12 @@ export interface OfflineConfig {
     onLeadershipChange?: (isLeader: boolean) => void;
     onStorageFailure?: (diagnostic: StorageDiagnostic) => void;
     leaderElection?: LeaderElection;
+    /**
+     * Custom online detector implementation.
+     * Defaults to WebOnlineDetector for browser environments.
+     * Use ReactNativeOnlineDetector from '@tanstack/offline-transactions/react-native' for RN/Expo.
+     */
+    onlineDetector?: OnlineDetector;
 }
 export interface StorageAdapter {
     get: (key: string) => Promise<string | null>;
@@ -89,6 +96,7 @@ export interface LeaderElection {
 export interface OnlineDetector {
     subscribe: (callback: () => void) => () => void;
     notifyOnline: () => void;
+    dispose: () => void;
 }
 export interface CreateOfflineTransactionOptions {
     id?: string;

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["import type {\n  Collection,\n  MutationFnParams,\n  PendingMutation,\n} from '@tanstack/db'\n\n// Extended mutation function that includes idempotency key\nexport type OfflineMutationFnParams<\n  T extends object = Record<string, unknown>,\n> = MutationFnParams<T> & {\n  idempotencyKey: string\n}\n\nexport type OfflineMutationFn<T extends object = Record<string, unknown>> = (\n  params: OfflineMutationFnParams<T>,\n) => Promise<any>\n\n// Simplified mutation structure for serialization\nexport interface SerializedMutation {\n  globalKey: string\n  type: string\n  modified: any\n  original: any\n  collectionId: string\n}\n\nexport interface SerializedError {\n  name: string\n  message: string\n  stack?: string\n}\n\nexport interface SerializedSpanContext {\n  traceId: string\n  spanId: string\n  traceFlags: number\n  traceState?: string\n}\n\n// In-memory representation with full PendingMutation objects\nexport interface OfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<PendingMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Serialized representation for storage\nexport interface SerializedOfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<SerializedMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Storage diagnostics and mode\nexport type OfflineMode = `offline` | `online-only`\n\nexport type StorageDiagnosticCode =\n  | `STORAGE_AVAILABLE`\n  | `INDEXEDDB_UNAVAILABLE`\n  | `LOCALSTORAGE_UNAVAILABLE`\n  | `STORAGE_BLOCKED`\n  | `QUOTA_EXCEEDED`\n  | `UNKNOWN_ERROR`\n\nexport interface StorageDiagnostic {\n  code: StorageDiagnosticCode\n  mode: OfflineMode\n  message: string\n  error?: Error\n}\n\nexport interface OfflineConfig {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  collections: Record<string, Collection<any, any, any, any, any>>\n  mutationFns: Record<string, OfflineMutationFn>\n  storage?: StorageAdapter\n  maxConcurrency?: number\n  jitter?: boolean\n  beforeRetry?: (\n    transactions: Array<OfflineTransaction>,\n  ) => Array<OfflineTransaction>\n  onUnknownMutationFn?: (name: string, tx: OfflineTransaction) => void\n  onLeadershipChange?: (isLeader: boolean) => void\n  onStorageFailure?: (diagnostic: StorageDiagnostic) => void\n  leaderElection?: LeaderElection\n}\n\nexport interface StorageAdapter {\n  get: (key: string) => Promise<string | null>\n  set: (key: string, value: string) => Promise<void>\n  delete: (key: string) => Promise<void>\n  keys: () => Promise<Array<string>>\n  clear: () => Promise<void>\n}\n\nexport interface RetryPolicy {\n  calculateDelay: (retryCount: number) => number\n  shouldRetry: (error: Error, retryCount: number) => boolean\n}\n\nexport interface LeaderElection {\n  requestLeadership: () => Promise<boolean>\n  releaseLeadership: () => void\n  isLeader: () => boolean\n  onLeadershipChange: (callback: (isLeader: boolean) => void) => () => void\n}\n\nexport interface OnlineDetector {\n  subscribe: (callback: () => void) => () => void\n  notifyOnline: () => void\n}\n\nexport interface CreateOfflineTransactionOptions {\n  id?: string\n  mutationFnName: string\n  autoCommit?: boolean\n  idempotencyKey?: string\n  metadata?: Record<string, any>\n}\n\nexport interface CreateOfflineActionOptions<T> {\n  mutationFnName: string\n  onMutate: (variables: T) => void\n}\n\nexport class NonRetriableError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = `NonRetriableError`\n  }\n}\n"],"names":[],"mappings":"AA+IO,MAAM,0BAA0B,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["import type {\n  Collection,\n  MutationFnParams,\n  PendingMutation,\n} from '@tanstack/db'\n\n// Extended mutation function that includes idempotency key\nexport type OfflineMutationFnParams<\n  T extends object = Record<string, unknown>,\n> = MutationFnParams<T> & {\n  idempotencyKey: string\n}\n\nexport type OfflineMutationFn<T extends object = Record<string, unknown>> = (\n  params: OfflineMutationFnParams<T>,\n) => Promise<any>\n\n// Simplified mutation structure for serialization\nexport interface SerializedMutation {\n  globalKey: string\n  type: string\n  modified: any\n  original: any\n  changes: any\n  collectionId: string\n}\n\nexport interface SerializedError {\n  name: string\n  message: string\n  stack?: string\n}\n\nexport interface SerializedSpanContext {\n  traceId: string\n  spanId: string\n  traceFlags: number\n  traceState?: string\n}\n\n// In-memory representation with full PendingMutation objects\nexport interface OfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<PendingMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: Date\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Serialized representation for storage\nexport interface SerializedOfflineTransaction {\n  id: string\n  mutationFnName: string\n  mutations: Array<SerializedMutation>\n  keys: Array<string>\n  idempotencyKey: string\n  createdAt: string\n  retryCount: number\n  nextAttemptAt: number\n  lastError?: SerializedError\n  metadata?: Record<string, any>\n  spanContext?: SerializedSpanContext\n  version: 1\n}\n\n// Storage diagnostics and mode\nexport type OfflineMode = `offline` | `online-only`\n\nexport type StorageDiagnosticCode =\n  | `STORAGE_AVAILABLE`\n  | `INDEXEDDB_UNAVAILABLE`\n  | `LOCALSTORAGE_UNAVAILABLE`\n  | `STORAGE_BLOCKED`\n  | `QUOTA_EXCEEDED`\n  | `UNKNOWN_ERROR`\n\nexport interface StorageDiagnostic {\n  code: StorageDiagnosticCode\n  mode: OfflineMode\n  message: string\n  error?: Error\n}\n\nexport interface OfflineConfig {\n  collections: Record<string, Collection<any, any, any, any, any>>\n  mutationFns: Record<string, OfflineMutationFn>\n  storage?: StorageAdapter\n  maxConcurrency?: number\n  jitter?: boolean\n  beforeRetry?: (\n    transactions: Array<OfflineTransaction>,\n  ) => Array<OfflineTransaction>\n  onUnknownMutationFn?: (name: string, tx: OfflineTransaction) => void\n  onLeadershipChange?: (isLeader: boolean) => void\n  onStorageFailure?: (diagnostic: StorageDiagnostic) => void\n  leaderElection?: LeaderElection\n  /**\n   * Custom online detector implementation.\n   * Defaults to WebOnlineDetector for browser environments.\n   * Use ReactNativeOnlineDetector from '@tanstack/offline-transactions/react-native' for RN/Expo.\n   */\n  onlineDetector?: OnlineDetector\n}\n\nexport interface StorageAdapter {\n  get: (key: string) => Promise<string | null>\n  set: (key: string, value: string) => Promise<void>\n  delete: (key: string) => Promise<void>\n  keys: () => Promise<Array<string>>\n  clear: () => Promise<void>\n}\n\nexport interface RetryPolicy {\n  calculateDelay: (retryCount: number) => number\n  shouldRetry: (error: Error, retryCount: number) => boolean\n}\n\nexport interface LeaderElection {\n  requestLeadership: () => Promise<boolean>\n  releaseLeadership: () => void\n  isLeader: () => boolean\n  onLeadershipChange: (callback: (isLeader: boolean) => void) => () => void\n}\n\nexport interface OnlineDetector {\n  subscribe: (callback: () => void) => () => void\n  notifyOnline: () => void\n  dispose: () => void\n}\n\nexport interface CreateOfflineTransactionOptions {\n  id?: string\n  mutationFnName: string\n  autoCommit?: boolean\n  idempotencyKey?: string\n  metadata?: Record<string, any>\n}\n\nexport interface CreateOfflineActionOptions<T> {\n  mutationFnName: string\n  onMutate: (variables: T) => void\n}\n\nexport class NonRetriableError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = `NonRetriableError`\n  }\n}\n"],"names":[],"mappings":"AAsJO,MAAM,0BAA0B,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/offline-transactions",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Offline-first transaction capabilities for TanStack DB",
   "author": "TanStack",
   "license": "MIT",
@@ -32,6 +32,16 @@
         "default": "./dist/cjs/index.cjs"
       }
     },
+    "./react-native": {
+      "import": {
+        "types": "./dist/esm/react-native/index.d.ts",
+        "default": "./dist/esm/react-native/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/react-native/index.d.cts",
+        "default": "./dist/cjs/react-native/index.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -40,11 +50,25 @@
     "src"
   ],
   "dependencies": {
-    "@tanstack/db": "0.5.19"
+    "@tanstack/db": "0.5.21"
+  },
+  "peerDependencies": {
+    "@react-native-community/netinfo": ">=11.0.0",
+    "react-native": ">=0.70.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-community/netinfo": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@react-native-community/netinfo": "11.4.1",
     "@types/node": "^24.6.2",
     "eslint": "^9.39.2",
+    "react-native": "0.79.6",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },

package/src/OfflineExecutor.ts

@@ -13,7 +13,7 @@ import { WebLocksLeader } from './coordination/WebLocksLeader'
 import { BroadcastChannelLeader } from './coordination/BroadcastChannelLeader'
 
 // Connectivity
-import { DefaultOnlineDetector } from './connectivity/OnlineDetector'
+import { WebOnlineDetector } from './connectivity/OnlineDetector'
 
 // API
 import { OfflineTransaction as OfflineTransactionAPI } from './api/OfflineTransaction'
@@ -30,6 +30,7 @@ import type {
   OfflineConfig,
   OfflineMode,
   OfflineTransaction,
+  OnlineDetector,
   StorageAdapter,
   StorageDiagnostic,
 } from './types'
@@ -44,7 +45,7 @@ export class OfflineExecutor {
   private scheduler: KeyScheduler
   private executor: TransactionExecutor | null
   private leaderElection: LeaderElection | null
-  private onlineDetector: DefaultOnlineDetector
+  private onlineDetector: OnlineDetector
   private isLeaderState = false
   private unsubscribeOnline: (() => void) | null = null
   private unsubscribeLeadership: (() => void) | null = null
@@ -71,7 +72,7 @@ export class OfflineExecutor {
   constructor(config: OfflineConfig) {
     this.config = config
     this.scheduler = new KeyScheduler()
-    this.onlineDetector = new DefaultOnlineDetector()
+    this.onlineDetector = config.onlineDetector ?? new WebOnlineDetector()
 
     // Initialize as pending - will be set by async initialization
     this.storage = null
@@ -491,7 +492,7 @@ export class OfflineExecutor {
     return this.executor.getRunningCount()
   }
 
-  getOnlineDetector(): DefaultOnlineDetector {
+  getOnlineDetector(): OnlineDetector {
     return this.onlineDetector
   }
 

package/src/connectivity/OnlineDetector.ts

@@ -1,6 +1,12 @@
 import type { OnlineDetector } from '../types'
 
-export class DefaultOnlineDetector implements OnlineDetector {
+/**
+ * Web-based online detector that uses browser APIs.
+ * Listens for:
+ * - `window.online` event for network connectivity changes
+ * - `document.visibilitychange` event for tab/window focus changes
+ */
+export class WebOnlineDetector implements OnlineDetector {
   private listeners: Set<() => void> = new Set()
   private isListening = false
 
@@ -85,3 +91,8 @@ export class DefaultOnlineDetector implements OnlineDetector {
     this.listeners.clear()
   }
 }
+
+/**
+ * @deprecated Use `WebOnlineDetector` instead. This alias is kept for backwards compatibility.
+ */
+export const DefaultOnlineDetector = WebOnlineDetector

package/src/connectivity/ReactNativeOnlineDetector.ts

@@ -0,0 +1,105 @@
+import NetInfo from '@react-native-community/netinfo'
+import { AppState } from 'react-native'
+import type { AppStateStatus, NativeEventSubscription } from 'react-native'
+import type { OnlineDetector } from '../types'
+
+/**
+ * React Native online detector that uses RN APIs.
+ * Listens for:
+ * - Network connectivity changes via `@react-native-community/netinfo`
+ * - App state changes (foreground/background) via `AppState`
+ */
+export class ReactNativeOnlineDetector implements OnlineDetector {
+  private listeners: Set<() => void> = new Set()
+  private netInfoUnsubscribe: (() => void) | null = null
+  private appStateSubscription: NativeEventSubscription | null = null
+  private isListening = false
+  private wasConnected = true
+
+  constructor() {
+    this.startListening()
+  }
+
+  private startListening(): void {
+    if (this.isListening) {
+      return
+    }
+
+    this.isListening = true
+
+    // Subscribe to network state changes
+    this.netInfoUnsubscribe = NetInfo.addEventListener((state) => {
+      const isConnected =
+        state.isConnected === true && state.isInternetReachable !== false
+
+      // Only notify when transitioning to online
+      if (isConnected && !this.wasConnected) {
+        this.notifyListeners()
+      }
+
+      this.wasConnected = isConnected
+    })
+
+    // Subscribe to app state changes (foreground/background)
+    this.appStateSubscription = AppState.addEventListener(
+      `change`,
+      this.handleAppStateChange,
+    )
+  }
+
+  private handleAppStateChange = (nextState: AppStateStatus): void => {
+    // Notify when app becomes active (foreground)
+    if (nextState === `active`) {
+      this.notifyListeners()
+    }
+  }
+
+  private stopListening(): void {
+    if (!this.isListening) {
+      return
+    }
+
+    this.isListening = false
+
+    if (this.netInfoUnsubscribe) {
+      this.netInfoUnsubscribe()
+      this.netInfoUnsubscribe = null
+    }
+
+    if (this.appStateSubscription) {
+      this.appStateSubscription.remove()
+      this.appStateSubscription = null
+    }
+  }
+
+  private notifyListeners(): void {
+    for (const listener of this.listeners) {
+      try {
+        listener()
+      } catch (error) {
+        console.warn(`ReactNativeOnlineDetector listener error:`, error)
+      }
+    }
+  }
+
+  subscribe(callback: () => void): () => void {
+    this.listeners.add(callback)
+
+    return () => {
+      this.listeners.delete(callback)
+
+      if (this.listeners.size === 0) {
+        this.stopListening()
+      }
+    }
+  }
+
+  notifyOnline(): void {
+    this.notifyListeners()
+  }
+
+  dispose(): void {
+    this.stopListening()
+    this.listeners.clear()
+  }
+}

package/src/index.ts

@@ -33,7 +33,10 @@ export { WebLocksLeader } from './coordination/WebLocksLeader'
 export { BroadcastChannelLeader } from './coordination/BroadcastChannelLeader'
 
 // Connectivity
-export { DefaultOnlineDetector } from './connectivity/OnlineDetector'
+export {
+  WebOnlineDetector,
+  DefaultOnlineDetector,
+} from './connectivity/OnlineDetector'
 
 // API components
 export { OfflineTransaction as OfflineTransactionAPI } from './api/OfflineTransaction'

package/src/outbox/TransactionSerializer.ts

@@ -7,11 +7,9 @@ import type {
 import type { Collection, PendingMutation } from '@tanstack/db'
 
 export class TransactionSerializer {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   private collections: Record<string, Collection<any, any, any, any, any>>
   private collectionIdToKey: Map<string, string>
 
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   constructor(
     collections: Record<string, Collection<any, any, any, any, any>>,
   ) {
@@ -26,37 +24,29 @@ export class TransactionSerializer {
   serialize(transaction: OfflineTransaction): string {
     const serialized: SerializedOfflineTransaction = {
       ...transaction,
-      createdAt: transaction.createdAt,
+      createdAt: transaction.createdAt.toISOString(),
       mutations: transaction.mutations.map((mutation) =>
         this.serializeMutation(mutation),
       ),
     }
-    // Convert the whole object to JSON, handling dates
-    return JSON.stringify(serialized, (key, value) => {
-      if (value instanceof Date) {
-        return value.toISOString()
-      }
-      return value
-    })
+    return JSON.stringify(serialized)
   }
 
   deserialize(data: string): OfflineTransaction {
-    const parsed: SerializedOfflineTransaction = JSON.parse(
-      data,
-      (key, value) => {
-        // Parse ISO date strings back to Date objects
-        if (
-          typeof value === `string` &&
-          /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)
-        ) {
-          return new Date(value)
-        }
-        return value
-      },
-    )
+    // Parse without a reviver - let deserializeValue handle dates in mutation data
+    // using the { __type: 'Date' } marker system
+    const parsed: SerializedOfflineTransaction = JSON.parse(data)
+
+    const createdAt = new Date(parsed.createdAt)
+    if (isNaN(createdAt.getTime())) {
+      throw new Error(
+        `Failed to deserialize transaction: invalid createdAt value "${parsed.createdAt}"`,
+      )
+    }
 
     return {
       ...parsed,
+      createdAt,
       mutations: parsed.mutations.map((mutationData) =>
         this.deserializeMutation(mutationData),
       ),
@@ -76,6 +66,7 @@ export class TransactionSerializer {
       type: mutation.type,
       modified: this.serializeValue(mutation.modified),
       original: this.serializeValue(mutation.original),
+      changes: this.serializeValue(mutation.changes),
       collectionId: registryKey, // Store registry key instead of collection.id
     }
   }
@@ -93,11 +84,11 @@ export class TransactionSerializer {
       type: data.type as any,
       modified: this.deserializeValue(data.modified),
       original: this.deserializeValue(data.original),
+      changes: this.deserializeValue(data.changes) ?? {},
       collection,
       // These fields would need to be reconstructed by the executor
       mutationId: ``, // Will be regenerated
       key: null, // Will be extracted from the data
-      changes: {}, // Will be recalculated
       metadata: undefined,
       syncMetadata: {},
       optimistic: true,
@@ -118,7 +109,7 @@ export class TransactionSerializer {
     if (typeof value === `object`) {
       const result: any = Array.isArray(value) ? [] : {}
       for (const key in value) {
-        if (value.hasOwnProperty(key)) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
           result[key] = this.serializeValue(value[key])
         }
       }
@@ -134,13 +125,22 @@ export class TransactionSerializer {
     }
 
     if (typeof value === `object` && value.__type === `Date`) {
-      return new Date(value.value)
+      if (value.value === undefined || value.value === null) {
+        throw new Error(`Corrupted Date marker: missing value field`)
+      }
+      const date = new Date(value.value)
+      if (isNaN(date.getTime())) {
+        throw new Error(
+          `Failed to deserialize Date marker: invalid date value "${value.value}"`,
+        )
+      }
+      return date
     }
 
     if (typeof value === `object`) {
       const result: any = Array.isArray(value) ? [] : {}
       for (const key in value) {
-        if (value.hasOwnProperty(key)) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
           result[key] = this.deserializeValue(value[key])
         }
       }

package/src/react-native/OfflineExecutor.ts

@@ -0,0 +1,24 @@
+import { OfflineExecutor as BaseOfflineExecutor } from '../OfflineExecutor'
+import { ReactNativeOnlineDetector } from '../connectivity/ReactNativeOnlineDetector'
+import type { OfflineConfig } from '../types'
+
+/**
+ * OfflineExecutor configured for React Native environments.
+ * Uses ReactNativeOnlineDetector by default instead of WebOnlineDetector.
+ */
+export class OfflineExecutor extends BaseOfflineExecutor {
+  constructor(config: OfflineConfig) {
+    super({
+      ...config,
+      onlineDetector: config.onlineDetector ?? new ReactNativeOnlineDetector(),
+    })
+  }
+}
+
+/**
+ * Start an offline executor configured for React Native environments.
+ * Uses ReactNativeOnlineDetector by default instead of WebOnlineDetector.
+ */
+export function startOfflineExecutor(config: OfflineConfig): OfflineExecutor {
+  return new OfflineExecutor(config)
+}

package/src/react-native/index.ts

@@ -0,0 +1,45 @@
+// Re-export from main entry (types, utilities, etc.)
+export {
+  // Types
+  type OfflineTransaction,
+  type OfflineConfig,
+  type OfflineMode,
+  type StorageAdapter,
+  type StorageDiagnostic,
+  type StorageDiagnosticCode,
+  type RetryPolicy,
+  type LeaderElection,
+  type OnlineDetector,
+  type CreateOfflineTransactionOptions,
+  type CreateOfflineActionOptions,
+  type SerializedError,
+  type SerializedMutation,
+  NonRetriableError,
+  // Storage adapters
+  IndexedDBAdapter,
+  LocalStorageAdapter,
+  // Retry policies
+  DefaultRetryPolicy,
+  BackoffCalculator,
+  // Coordination
+  WebLocksLeader,
+  BroadcastChannelLeader,
+  // Connectivity - export web detector too for flexibility
+  WebOnlineDetector,
+  DefaultOnlineDetector,
+  // API components
+  OfflineTransactionAPI,
+  createOfflineAction,
+  // Outbox management
+  OutboxManager,
+  TransactionSerializer,
+  // Execution engine
+  KeyScheduler,
+  TransactionExecutor,
+} from '../index'
+
+// Export RN-specific detector
+export { ReactNativeOnlineDetector } from '../connectivity/ReactNativeOnlineDetector'
+
+// Export RN-configured executor
+export { OfflineExecutor, startOfflineExecutor } from './OfflineExecutor'

package/src/types.ts

@@ -21,6 +21,7 @@ export interface SerializedMutation {
   type: string
   modified: any
   original: any
+  changes: any
   collectionId: string
 }
 
@@ -60,7 +61,7 @@ export interface SerializedOfflineTransaction {
   mutations: Array<SerializedMutation>
   keys: Array<string>
   idempotencyKey: string
-  createdAt: Date
+  createdAt: string
   retryCount: number
   nextAttemptAt: number
   lastError?: SerializedError
@@ -88,7 +89,6 @@ export interface StorageDiagnostic {
 }
 
 export interface OfflineConfig {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   collections: Record<string, Collection<any, any, any, any, any>>
   mutationFns: Record<string, OfflineMutationFn>
   storage?: StorageAdapter
@@ -101,6 +101,12 @@ export interface OfflineConfig {
   onLeadershipChange?: (isLeader: boolean) => void
   onStorageFailure?: (diagnostic: StorageDiagnostic) => void
   leaderElection?: LeaderElection
+  /**
+   * Custom online detector implementation.
+   * Defaults to WebOnlineDetector for browser environments.
+   * Use ReactNativeOnlineDetector from '@tanstack/offline-transactions/react-native' for RN/Expo.
+   */
+  onlineDetector?: OnlineDetector
 }
 
 export interface StorageAdapter {
@@ -126,6 +132,7 @@ export interface LeaderElection {
 export interface OnlineDetector {
   subscribe: (callback: () => void) => () => void
   notifyOnline: () => void
+  dispose: () => void
 }
 
 export interface CreateOfflineTransactionOptions {