react-native-nitro-dgram 0.1.4

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

@@ -0,0 +1,74 @@
+///
+/// HybridNitroBufferSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <NitroModules/ArrayBuffer.hpp>
+#include <string>
+
+namespace margelo::nitro::udp {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `NitroBuffer`
+   * Inherit this class to create instances of `HybridNitroBufferSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridNitroBuffer: public HybridNitroBufferSpec {
+   * public:
+   *   HybridNitroBuffer(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridNitroBufferSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridNitroBufferSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridNitroBufferSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<ArrayBuffer> alloc(double size) = 0;
+      virtual std::shared_ptr<ArrayBuffer> allocUnsafe(double size) = 0;
+      virtual double byteLength(const std::string& string, const std::string& encoding) = 0;
+      virtual double write(const std::shared_ptr<ArrayBuffer>& buffer, const std::string& string, double offset, double length, const std::string& encoding) = 0;
+      virtual std::string decode(const std::shared_ptr<ArrayBuffer>& buffer, double offset, double length, const std::string& encoding) = 0;
+      virtual double compare(const std::shared_ptr<ArrayBuffer>& a, double aOffset, double aLength, const std::shared_ptr<ArrayBuffer>& b, double bOffset, double bLength) = 0;
+      virtual void fill(const std::shared_ptr<ArrayBuffer>& buffer, double value, double offset, double length) = 0;
+      virtual double indexOf(const std::shared_ptr<ArrayBuffer>& buffer, double value, double offset, double length) = 0;
+      virtual double indexOfBuffer(const std::shared_ptr<ArrayBuffer>& buffer, const std::shared_ptr<ArrayBuffer>& needle, double offset, double length) = 0;
+      virtual double lastIndexOfByte(const std::shared_ptr<ArrayBuffer>& buffer, double value, double offset, double length) = 0;
+      virtual double lastIndexOfBuffer(const std::shared_ptr<ArrayBuffer>& buffer, const std::shared_ptr<ArrayBuffer>& needle, double offset, double length) = 0;
+      virtual void fillBuffer(const std::shared_ptr<ArrayBuffer>& buffer, const std::shared_ptr<ArrayBuffer>& value, double offset, double length) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "NitroBuffer";
+  };
+
+} // namespace margelo::nitro::udp

package/nitrogen/generated/shared/c++/HybridUdpDriverSpec.cpp

@@ -0,0 +1,21 @@
+///
+/// HybridUdpDriverSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridUdpDriverSpec.hpp"
+
+namespace margelo::nitro::udp {
+
+  void HybridUdpDriverSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("createSocket", &HybridUdpDriverSpec::createSocket);
+    });
+  }
+
+} // namespace margelo::nitro::udp

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

@@ -0,0 +1,66 @@
+///
+/// HybridUdpDriverSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `HybridUdpSocketDriverSpec` to properly resolve imports.
+namespace margelo::nitro::udp { class HybridUdpSocketDriverSpec; }
+
+#include <memory>
+#include "HybridUdpSocketDriverSpec.hpp"
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::udp {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `UdpDriver`
+   * Inherit this class to create instances of `HybridUdpDriverSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridUdpDriver: public HybridUdpDriverSpec {
+   * public:
+   *   HybridUdpDriver(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridUdpDriverSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridUdpDriverSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridUdpDriverSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<HybridUdpSocketDriverSpec> createSocket(const std::optional<std::string>& id) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "UdpDriver";
+  };
+
+} // namespace margelo::nitro::udp

package/nitrogen/generated/shared/c++/HybridUdpSocketDriverSpec.cpp

@@ -0,0 +1,54 @@
+///
+/// HybridUdpSocketDriverSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridUdpSocketDriverSpec.hpp"
+
+namespace margelo::nitro::udp {
+
+  void HybridUdpSocketDriverSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("id", &HybridUdpSocketDriverSpec::getId);
+      prototype.registerHybridGetter("onMessage", &HybridUdpSocketDriverSpec::getOnMessage);
+      prototype.registerHybridSetter("onMessage", &HybridUdpSocketDriverSpec::setOnMessage);
+      prototype.registerHybridGetter("onConnect", &HybridUdpSocketDriverSpec::getOnConnect);
+      prototype.registerHybridSetter("onConnect", &HybridUdpSocketDriverSpec::setOnConnect);
+      prototype.registerHybridGetter("onError", &HybridUdpSocketDriverSpec::getOnError);
+      prototype.registerHybridSetter("onError", &HybridUdpSocketDriverSpec::setOnError);
+      prototype.registerHybridGetter("onClose", &HybridUdpSocketDriverSpec::getOnClose);
+      prototype.registerHybridSetter("onClose", &HybridUdpSocketDriverSpec::setOnClose);
+      prototype.registerHybridMethod("bind", &HybridUdpSocketDriverSpec::bind);
+      prototype.registerHybridMethod("connect", &HybridUdpSocketDriverSpec::connect);
+      prototype.registerHybridMethod("disconnect", &HybridUdpSocketDriverSpec::disconnect);
+      prototype.registerHybridMethod("send", &HybridUdpSocketDriverSpec::send);
+      prototype.registerHybridMethod("sendMultiple", &HybridUdpSocketDriverSpec::sendMultiple);
+      prototype.registerHybridMethod("close", &HybridUdpSocketDriverSpec::close);
+      prototype.registerHybridMethod("setBroadcast", &HybridUdpSocketDriverSpec::setBroadcast);
+      prototype.registerHybridMethod("setTTL", &HybridUdpSocketDriverSpec::setTTL);
+      prototype.registerHybridMethod("setMulticastTTL", &HybridUdpSocketDriverSpec::setMulticastTTL);
+      prototype.registerHybridMethod("setMulticastLoopback", &HybridUdpSocketDriverSpec::setMulticastLoopback);
+      prototype.registerHybridMethod("setMulticastInterface", &HybridUdpSocketDriverSpec::setMulticastInterface);
+      prototype.registerHybridMethod("addMembership", &HybridUdpSocketDriverSpec::addMembership);
+      prototype.registerHybridMethod("dropMembership", &HybridUdpSocketDriverSpec::dropMembership);
+      prototype.registerHybridMethod("addSourceSpecificMembership", &HybridUdpSocketDriverSpec::addSourceSpecificMembership);
+      prototype.registerHybridMethod("dropSourceSpecificMembership", &HybridUdpSocketDriverSpec::dropSourceSpecificMembership);
+      prototype.registerHybridMethod("getLocalAddress", &HybridUdpSocketDriverSpec::getLocalAddress);
+      prototype.registerHybridMethod("getLocalPort", &HybridUdpSocketDriverSpec::getLocalPort);
+      prototype.registerHybridMethod("getRemoteAddress", &HybridUdpSocketDriverSpec::getRemoteAddress);
+      prototype.registerHybridMethod("getRemotePort", &HybridUdpSocketDriverSpec::getRemotePort);
+      prototype.registerHybridMethod("getRecvBufferSize", &HybridUdpSocketDriverSpec::getRecvBufferSize);
+      prototype.registerHybridMethod("setRecvBufferSize", &HybridUdpSocketDriverSpec::setRecvBufferSize);
+      prototype.registerHybridMethod("getSendBufferSize", &HybridUdpSocketDriverSpec::getSendBufferSize);
+      prototype.registerHybridMethod("setSendBufferSize", &HybridUdpSocketDriverSpec::setSendBufferSize);
+      prototype.registerHybridMethod("getSendQueueCount", &HybridUdpSocketDriverSpec::getSendQueueCount);
+      prototype.registerHybridMethod("getSendQueueSize", &HybridUdpSocketDriverSpec::getSendQueueSize);
+    });
+  }
+
+} // namespace margelo::nitro::udp

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

@@ -0,0 +1,98 @@
+///
+/// HybridUdpSocketDriverSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <NitroModules/ArrayBuffer.hpp>
+#include <string>
+#include <functional>
+#include <vector>
+#include <optional>
+
+namespace margelo::nitro::udp {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `UdpSocketDriver`
+   * Inherit this class to create instances of `HybridUdpSocketDriverSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridUdpSocketDriver: public HybridUdpSocketDriverSpec {
+   * public:
+   *   HybridUdpSocketDriver(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridUdpSocketDriverSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridUdpSocketDriverSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridUdpSocketDriverSpec() override = default;
+
+    public:
+      // Properties
+      virtual double getId() = 0;
+      virtual std::function<void(const std::shared_ptr<ArrayBuffer>& /* data */, const std::string& /* address */, double /* port */)> getOnMessage() = 0;
+      virtual void setOnMessage(const std::function<void(const std::shared_ptr<ArrayBuffer>& /* data */, const std::string& /* address */, double /* port */)>& onMessage) = 0;
+      virtual std::function<void()> getOnConnect() = 0;
+      virtual void setOnConnect(const std::function<void()>& onConnect) = 0;
+      virtual std::function<void(const std::string& /* error */)> getOnError() = 0;
+      virtual void setOnError(const std::function<void(const std::string& /* error */)>& onError) = 0;
+      virtual std::function<void()> getOnClose() = 0;
+      virtual void setOnClose(const std::function<void()>& onClose) = 0;
+
+    public:
+      // Methods
+      virtual double bind(double port, const std::string& address, bool ipv6Only) = 0;
+      virtual double connect(double port, const std::string& address) = 0;
+      virtual double disconnect() = 0;
+      virtual double send(const std::shared_ptr<ArrayBuffer>& data, double port, const std::string& address) = 0;
+      virtual double sendMultiple(const std::vector<std::shared_ptr<ArrayBuffer>>& data, double port, const std::string& address) = 0;
+      virtual void close() = 0;
+      virtual double setBroadcast(bool flag) = 0;
+      virtual double setTTL(double ttl) = 0;
+      virtual double setMulticastTTL(double ttl) = 0;
+      virtual double setMulticastLoopback(bool flag) = 0;
+      virtual double setMulticastInterface(const std::string& interfaceAddress) = 0;
+      virtual double addMembership(const std::string& multicastAddress, const std::optional<std::string>& interfaceAddress) = 0;
+      virtual double dropMembership(const std::string& multicastAddress, const std::optional<std::string>& interfaceAddress) = 0;
+      virtual double addSourceSpecificMembership(const std::string& sourceAddress, const std::string& groupAddress, const std::optional<std::string>& interfaceAddress) = 0;
+      virtual double dropSourceSpecificMembership(const std::string& sourceAddress, const std::string& groupAddress, const std::optional<std::string>& interfaceAddress) = 0;
+      virtual std::string getLocalAddress() = 0;
+      virtual double getLocalPort() = 0;
+      virtual std::string getRemoteAddress() = 0;
+      virtual double getRemotePort() = 0;
+      virtual double getRecvBufferSize() = 0;
+      virtual double setRecvBufferSize(double size) = 0;
+      virtual double getSendBufferSize() = 0;
+      virtual double setSendBufferSize(double size) = 0;
+      virtual double getSendQueueCount() = 0;
+      virtual double getSendQueueSize() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "UdpSocketDriver";
+  };
+
+} // namespace margelo::nitro::udp

package/package.json

@@ -0,0 +1,59 @@
+{
+    "name": "react-native-nitro-dgram",
+    "version": "0.1.4",
+    "description": "🚀 Ultra-high-performance Node.js dgram (UDP) implementation for React Native. Powered by Nitro Modules and a robust Rust core for maximum efficiency and low latency.",
+    "main": "./lib/index.js",
+    "module": "./lib/index.js",
+    "types": "./lib/index.d.ts",
+    "react-native": "./src/index.ts",
+    "keywords": [
+        "react-native",
+        "ios",
+        "android",
+        "nitro",
+        "udp",
+        "dgram",
+        "network",
+        "nodejs"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/iwater/react-native-nitro-dgram.git"
+    },
+    "bugs": {
+        "url": "https://github.com/iwater/react-native-nitro-dgram/issues"
+    },
+    "author": "iwater <iwater@gmail.com>",
+    "license": "ISC",
+    "scripts": {
+        "build": "npx nitrogen@0.32.0 && tsc",
+        "prepare": "npm run build",
+        "copy-clib": "rm -rf ios/Frameworks/RustCUdp.xcframework && cp -R ../rust_c_udp/target/xcframework/RustCUdp.xcframework ios/Frameworks/ && mkdir -p android/libs/arm64-v8a android/libs/armeabi-v7a android/libs/x86 android/libs/x86_64 && cp ../rust_c_udp/target/aarch64-linux-android/release/librust_c_udp.so android/libs/arm64-v8a/ && cp ../rust_c_udp/target/armv7-linux-androideabi/release/librust_c_udp.so android/libs/armeabi-v7a/ && cp ../rust_c_udp/target/i686-linux-android/release/librust_c_udp.so android/libs/x86/ && cp ../rust_c_udp/target/x86_64-linux-android/release/librust_c_udp.so android/libs/x86_64/ && cp ../rust_c_udp/include/UdpBindings.hpp cpp/",
+        "copy-clib-android": "cp ../rust_c_udp/target/aarch64-linux-android/release/librust_c_udp.so android/libs/arm64-v8a/ && cp ../rust_c_udp/target/armv7-linux-androideabi/release/librust_c_udp.so android/libs/armeabi-v7a/ && cp ../rust_c_udp/target/i686-linux-android/release/librust_c_udp.so android/libs/x86/ && cp ../rust_c_udp/target/x86_64-linux-android/release/librust_c_udp.so android/libs/x86_64/ && cp ../rust_c_udp/include/UdpBindings.hpp cpp/",
+        "copy-clib-ios": "rm -rf ios/Frameworks/RustCUdp.xcframework && cp -R ../rust_c_udp/target/xcframework/RustCUdp.xcframework ios/Frameworks/"
+    },
+    "dependencies": {
+        "eventemitter3": "^5.0.1",
+        "react-native-nitro-buffer": "^0.0.11"
+    },
+    "devDependencies": {
+        "@types/node": "*",
+        "nitrogen": "^0.32.0",
+        "react-native-nitro-modules": "^0.32.0",
+        "typescript": "^5.3.3"
+    },
+    "peerDependencies": {
+        "react-native": "*",
+        "react-native-nitro-modules": "^0.32.0"
+    },
+    "packageManager": "yarn@4.12.0",
+    "files": [
+        "lib/",
+        "src/",
+        "cpp/",
+        "ios/",
+        "android/",
+        "nitrogen/",
+        "*.podspec"
+    ]
+}

package/react-native-nitro-dgram.podspec

@@ -0,0 +1,45 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-nitro-dgram"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = "https://github.com/iwater/react-native-nitro-dgram"
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  
+  s.platform     = :ios, "13.0"
+  s.source       = { :git => "https://github.com/iwater/react-native-nitro-dgram.git", :tag => "v#{s.version}" }
+  
+  s.module_name  = "RustCUdp"
+
+  s.source_files = [
+    "ios/**/*.{h,m,mm,swift}",
+    "cpp/**/*.{hpp,cpp}"
+  ]
+  
+  s.dependency "React-Core"
+  
+  # Add vendored xcframework (Rust binary)
+  s.vendored_frameworks = "ios/Frameworks/RustCUdp.xcframework"
+  
+  s.pod_target_xcconfig = {
+    "HEADER_SEARCH_PATHS" => [
+      "\"$(PODS_ROOT)/react-native-nitro-modules/ios\"",
+      "\"$(PODS_ROOT)/Headers/Public/react-native-nitro-modules\"",
+      "\"$(PODS_TARGET_SRCROOT)/nitrogen/generated/shared/c++\"",
+      "\"$(PODS_TARGET_SRCROOT)/nitrogen/generated/shared\"",
+      "\"$(PODS_TARGET_SRCROOT)/nitrogen/generated/ios/c++\"",
+      "\"$(PODS_TARGET_SRCROOT)/nitrogen/generated/ios\"",
+      "\"$(PODS_TARGET_SRCROOT)/cpp\"",
+      "\"$(PODS_TARGET_SRCROOT)/ios/Frameworks/RustCUdp.xcframework/ios-arm64/RustCUdp.framework/Headers\"",
+      "\"$(PODS_TARGET_SRCROOT)/ios/Frameworks/RustCUdp.xcframework/ios-arm64_x86_64-simulator/RustCUdp.framework/Headers\""
+    ],
+    "OTHER_SWIFT_FLAGS" => "-cxx-interoperability-mode=default"
+  }
+
+  load 'nitrogen/generated/ios/RustCUdp+autolinking.rb'
+  add_nitrogen_files(s)
+end

package/src/Driver.ts

@@ -0,0 +1,4 @@
+import { NitroModules } from 'react-native-nitro-modules'
+import type { UdpDriver } from './Udp.nitro'
+
+export const Driver = NitroModules.createHybridObject<UdpDriver>('UdpDriver')

package/src/Udp.nitro.ts

@@ -0,0 +1,55 @@
+import { type HybridObject } from 'react-native-nitro-modules'
+
+/**
+ * @specs
+ */
+export interface UdpSocketDriver extends HybridObject<{ ios: 'swift', android: 'kotlin' }> {
+    readonly id: number
+    bind(port: number, address: string, ipv6Only: boolean): number
+    connect(port: number, address: string): number
+    disconnect(): number
+    send(data: ArrayBuffer, port: number, address: string): number
+    sendMultiple(data: ArrayBuffer[], port: number, address: string): number
+    close(): void
+
+    setBroadcast(flag: boolean): number
+    setTTL(ttl: number): number
+    setMulticastTTL(ttl: number): number
+    setMulticastLoopback(flag: boolean): number
+    setMulticastInterface(interfaceAddress: string): number
+    addMembership(multicastAddress: string, interfaceAddress?: string): number
+    dropMembership(multicastAddress: string, interfaceAddress?: string): number
+    addSourceSpecificMembership(sourceAddress: string, groupAddress: string, interfaceAddress?: string): number
+    dropSourceSpecificMembership(sourceAddress: string, groupAddress: string, interfaceAddress?: string): number
+
+    getLocalAddress(): string
+    getLocalPort(): number
+    getRemoteAddress(): string
+    getRemotePort(): number
+
+    getRecvBufferSize(): number
+    setRecvBufferSize(size: number): number
+    getSendBufferSize(): number
+    setSendBufferSize(size: number): number
+    getSendQueueCount(): number
+    getSendQueueSize(): number
+
+    onMessage: (data: ArrayBuffer, address: string, port: number) => void
+    onConnect: () => void
+    onError: (error: string) => void
+    onClose: () => void
+}
+
+export interface RemoteInfo {
+    address: string
+    family: 'IPv4' | 'IPv6'
+    port: number
+    size: number
+}
+
+/**
+ * @specs
+ */
+export interface UdpDriver extends HybridObject<{ ios: 'swift', android: 'kotlin' }> {
+    createSocket(id?: string): UdpSocketDriver
+}