@shamilovtim/react-native-nitro-sse 2.3.0

package/nitrogen/generated/shared/c++/SseMockEvent.hpp

@@ -0,0 +1,119 @@
+///
+/// SseMockEvent.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `SseEventType` to properly resolve imports.
+namespace margelo::nitro::nitrosse { enum class SseEventType; }
+
+#include "SseEventType.hpp"
+#include <optional>
+#include <string>
+#include <NitroModules/AnyMap.hpp>
+
+namespace margelo::nitro::nitrosse {
+
+  /**
+   * A struct which can be represented as a JavaScript object (SseMockEvent).
+   */
+  struct SseMockEvent final {
+  public:
+    std::optional<SseEventType> type     SWIFT_PRIVATE;
+    std::optional<std::string> data     SWIFT_PRIVATE;
+    std::optional<std::shared_ptr<AnyMap>> parsedData     SWIFT_PRIVATE;
+    std::optional<std::string> id     SWIFT_PRIVATE;
+    std::optional<std::string> event     SWIFT_PRIVATE;
+    std::optional<std::string> message     SWIFT_PRIVATE;
+    std::optional<double> statusCode     SWIFT_PRIVATE;
+    std::optional<double> retry     SWIFT_PRIVATE;
+    std::optional<double> delayMs     SWIFT_PRIVATE;
+
+  public:
+    SseMockEvent() = default;
+    explicit SseMockEvent(std::optional<SseEventType> type, std::optional<std::string> data, std::optional<std::shared_ptr<AnyMap>> parsedData, std::optional<std::string> id, std::optional<std::string> event, std::optional<std::string> message, std::optional<double> statusCode, std::optional<double> retry, std::optional<double> delayMs): type(type), data(data), parsedData(parsedData), id(id), event(event), message(message), statusCode(statusCode), retry(retry), delayMs(delayMs) {}
+
+  public:
+    friend bool operator==(const SseMockEvent& lhs, const SseMockEvent& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitrosse
+
+namespace margelo::nitro {
+
+  // C++ SseMockEvent <> JS SseMockEvent (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitrosse::SseMockEvent> final {
+    static inline margelo::nitro::nitrosse::SseMockEvent fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitrosse::SseMockEvent(
+        JSIConverter<std::optional<margelo::nitro::nitrosse::SseEventType>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "type"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "data"))),
+        JSIConverter<std::optional<std::shared_ptr<AnyMap>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "parsedData"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "id"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "event"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "message"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "statusCode"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "retry"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "delayMs")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitrosse::SseMockEvent& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "type"), JSIConverter<std::optional<margelo::nitro::nitrosse::SseEventType>>::toJSI(runtime, arg.type));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "data"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.data));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "parsedData"), JSIConverter<std::optional<std::shared_ptr<AnyMap>>>::toJSI(runtime, arg.parsedData));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "id"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.id));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "event"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.event));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "message"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.message));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "statusCode"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.statusCode));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "retry"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.retry));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "delayMs"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.delayMs));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::optional<margelo::nitro::nitrosse::SseEventType>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "type")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "data")))) return false;
+      if (!JSIConverter<std::optional<std::shared_ptr<AnyMap>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "parsedData")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "id")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "event")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "message")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "statusCode")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "retry")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "delayMs")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/SseMockMode.hpp

@@ -0,0 +1,76 @@
+///
+/// SseMockMode.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::nitrosse {
+
+  /**
+   * An enum which can be represented as a JavaScript union (SseMockMode).
+   */
+  enum class SseMockMode {
+    REPLACE      SWIFT_NAME(replace) = 0,
+    INJECT      SWIFT_NAME(inject) = 1,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::nitrosse
+
+namespace margelo::nitro {
+
+  // C++ SseMockMode <> JS SseMockMode (union)
+  template <>
+  struct JSIConverter<margelo::nitro::nitrosse::SseMockMode> final {
+    static inline margelo::nitro::nitrosse::SseMockMode fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("replace"): return margelo::nitro::nitrosse::SseMockMode::REPLACE;
+        case hashString("inject"): return margelo::nitro::nitrosse::SseMockMode::INJECT;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum SseMockMode - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::nitrosse::SseMockMode arg) {
+      switch (arg) {
+        case margelo::nitro::nitrosse::SseMockMode::REPLACE: return JSIConverter<std::string>::toJSI(runtime, "replace");
+        case margelo::nitro::nitrosse::SseMockMode::INJECT: return JSIConverter<std::string>::toJSI(runtime, "inject");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert SseMockMode to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("replace"):
+        case hashString("inject"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/SseStats.hpp

@@ -0,0 +1,96 @@
+///
+/// SseStats.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <optional>
+#include <string>
+
+namespace margelo::nitro::nitrosse {
+
+  /**
+   * A struct which can be represented as a JavaScript object (SseStats).
+   */
+  struct SseStats final {
+  public:
+    double totalBytesReceived     SWIFT_PRIVATE;
+    double reconnectCount     SWIFT_PRIVATE;
+    std::optional<double> lastErrorTime     SWIFT_PRIVATE;
+    std::optional<std::string> lastErrorCode     SWIFT_PRIVATE;
+
+  public:
+    SseStats() = default;
+    explicit SseStats(double totalBytesReceived, double reconnectCount, std::optional<double> lastErrorTime, std::optional<std::string> lastErrorCode): totalBytesReceived(totalBytesReceived), reconnectCount(reconnectCount), lastErrorTime(lastErrorTime), lastErrorCode(lastErrorCode) {}
+
+  public:
+    friend bool operator==(const SseStats& lhs, const SseStats& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitrosse
+
+namespace margelo::nitro {
+
+  // C++ SseStats <> JS SseStats (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitrosse::SseStats> final {
+    static inline margelo::nitro::nitrosse::SseStats fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitrosse::SseStats(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalBytesReceived"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "reconnectCount"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lastErrorTime"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lastErrorCode")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitrosse::SseStats& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "totalBytesReceived"), JSIConverter<double>::toJSI(runtime, arg.totalBytesReceived));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "reconnectCount"), JSIConverter<double>::toJSI(runtime, arg.reconnectCount));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "lastErrorTime"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.lastErrorTime));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "lastErrorCode"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.lastErrorCode));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "totalBytesReceived")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "reconnectCount")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lastErrorTime")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "lastErrorCode")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,186 @@
+{
+  "name": "@shamilovtim/react-native-nitro-sse",
+  "version": "2.3.0",
+  "description": "High-performance Server-Sent Events (SSE) for React Native, powered by Nitro Modules.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!ios/Tests",
+    "!android/build",
+    "!android/src/test",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-nitro-sse-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "test": "jest",
+    "test:android": "cd example/android && ./gradlew :react-native-nitro-sse:testDebugUnitTest",
+    "test:ios": "cd example/ios && xcodebuild test -workspace NitroSseExample.xcworkspace -scheme NitroSse -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 16'",
+    "test:native": "yarn test:android && yarn test:ios",
+    "release": "release-it --only-version",
+    "server": "node example/sse-server.js",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "sse",
+    "server-sent-events",
+    "streaming",
+    "nitro",
+    "jsi"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shamilovtim/react-native-nitro-sse.git"
+  },
+  "author": "IAmTester35 <maithanhnam141@gmail.com> (https://github.com/IAmTester35)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/shamilovtim/react-native-nitro-sse/issues"
+  },
+  "homepage": "https://github.com/shamilovtim/react-native-nitro-sse#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.4",
+    "@react-native/eslint-config": "0.83.4",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "nitrogen": "0.35.6",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.4",
+    "react-native-builder-bob": "^0.40.17",
+    "react-native-nitro-modules": "0.35.6",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": ">= 0.35.6"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "jest",
+      "lefthook",
+      "release-it",
+      "eslint"
+    ],
+    "version": "0.57.0"
+  }
+}

package/src/NitroSse.nitro.ts

@@ -0,0 +1,53 @@
+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;
+  /**
+   * Manually flush the event buffer.
+   * Useful when batching is enabled but you need to process pending events immediately.
+   */
+  flush(): void;
+
+  /**
+   * Force a reconnection.
+   * This resets the connection state and attempts to reconnect immediately.
+   */
+  restart(): void;
+
+  /**
+   * Check if the connection is currently active.
+   */
+  isConnected(): boolean;
+}