fix: harden web tracking and skip native polling on web

Prevent unhandled rejections from fire-and-forget web sends, only run
batch flush polling for the native dispatcher, and document appVersion
for React Native Web in the README.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: Robert27

README.md

@@ -28,7 +28,10 @@ This SDK also supports React Native Web!
 > This feature is disabled by default. To enable it, you need to pass the `enableWeb` option when initializing the SDK.
 
 ```js
-Aptabase.init("<YOUR_APP_KEY>", { enableWeb: true });
+Aptabase.init("<YOUR_APP_KEY>", {
+  enableWeb: true,
+  appVersion: "1.0.0", // required on web — no native module provides it
+});
 ```
 
 When enabled, the SDK will track events in web environments using the same behavior as the web SDKs. Which means that events will be sent immediately to the `/event` endpoint instead of grouped to the `/events` endpoint.
@@ -78,7 +81,7 @@ export function Counter() {
 }
 ```
 
-To disable tracking events, you can call the `dispose` function. This will stop and deinitalize the SDK.
+To disable tracking events, you can call the `dispose` function. This will stop and deinitialize the SDK.
 
 ```js
 import Aptabase from "@aptabase/react-native";

src/client.ts

@@ -62,6 +62,10 @@ export class AptabaseClient {
   }
 
   public startPolling(flushInterval: number) {
+    if (!(this._dispatcher instanceof NativeEventDispatcher)) {
+      return;
+    }
+
     this.stopPolling();
 
     this._flushTimer = setInterval(this.flush.bind(this), flushInterval);

src/dispatcher.ts

@@ -110,11 +110,15 @@ export class WebEventDispatcher extends EventDispatcher {
 
   public enqueue(evt: Event | Event[]): void {
     if (Array.isArray(evt)) {
-      evt.forEach((event) => this._sendEvent(event));
+      evt.forEach((event) => this.dispatchEvent(event));
     } else {
-      this._sendEvent(evt);
+      this.dispatchEvent(evt);
     }
   }
+
+  private dispatchEvent(event: Event): void {
+    void this._sendEvent(event).catch(() => undefined);
+  }
 }
 
 export class NativeEventDispatcher extends EventDispatcher {