react-native-nitro-sse 0.1.0-beta.0

package/src/NitroSse.nitro.ts

@@ -0,0 +1,37 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+import type { SseConfig, SseEvent, SseStats } from './SseInterface';
+
+export interface NitroSse
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  /**
+   * Configure SSE and setup event callback.
+   */
+  setup(config: SseConfig, onEvent: (events: SseEvent[]) => void): void;
+
+  /**
+   * Start the SSE connection.
+   */
+  start(): void;
+
+  /**
+   * Stop the SSE connection.
+   */
+  stop(): void;
+
+  /**
+   * Set the last processed event ID.
+   * Native will use this ID to resume connection if interrupted.
+   */
+  setLastProcessedId(id: string): void;
+
+  /**
+   * Update HTTP headers dynamically (e.g., when token expires).
+   * These headers will be used for subsequent connection/reconnection attempts.
+   */
+  updateHeaders(headers: Record<string, string>): void;
+
+  /**
+   * Get connection statistics.
+   */
+  getStats(): SseStats;
+}

package/src/SseInterface.ts

@@ -0,0 +1,28 @@
+export type HttpMethod = 'get' | 'post';
+
+export type SseEventType = 'open' | 'message' | 'error' | 'close' | 'heartbeat';
+
+export interface SseConfig {
+  url: string;
+  method?: HttpMethod;
+  headers?: Record<string, string>;
+  body?: string;
+  backgroundExecution?: boolean;
+  batchingIntervalMs?: number;
+  maxBufferSize?: number;
+}
+
+export interface SseEvent {
+  type: SseEventType;
+  data?: string;
+  id?: string;
+  event?: string;
+  message?: string;
+}
+
+export interface SseStats {
+  totalBytesReceived: number;
+  reconnectCount: number;
+  lastErrorTime?: number;
+  lastErrorCode?: string;
+}

package/src/index.tsx

@@ -0,0 +1,26 @@
+import { NitroModules } from 'react-native-nitro-modules';
+import type { NitroSse } from './NitroSse.nitro';
+
+export * from './SseInterface';
+export * from './NitroSse.nitro';
+
+// Load the Hybrid Object from Native
+let realNitroSse: NitroSse | undefined;
+try {
+  realNitroSse = NitroModules.createHybridObject<NitroSse>('NitroSse');
+} catch {
+  console.debug(
+    'Native NitroSse not found. This might be a test environment or web.'
+  );
+}
+
+/**
+ * Public interface to use SSE.
+ */
+if (!realNitroSse || !(realNitroSse as any).setup) {
+  throw new Error(
+    'NitroSse: Native module not found. Ensure you have linked the library and built the app for iOS/Android.'
+  );
+}
+
+export const NitroSseModule: NitroSse = realNitroSse;