@minip2p/react-native 0.1.1 → 0.3.1

package/lib/typescript/src/hook-lifecycle.d.ts

@@ -0,0 +1,38 @@
+import type { CloseReason, Unsubscribe } from "@minip2p/core";
+export interface HookEndpoint {
+    close: () => void;
+    listenAddrs: () => readonly string[];
+    onClose: (handler: (reason: CloseReason) => void) => Unsubscribe;
+    peerId: () => string;
+    setActive: (active: boolean) => void;
+}
+export interface AppStateSource {
+    readonly currentState: string | null | undefined;
+    addEventListener: (type: "change", handler: (state: string) => void) => {
+        remove: () => void;
+    };
+}
+/** @internal */
+export declare const bindAppStateSource: (endpoint: Pick<HookEndpoint, "setActive">, source: AppStateSource) => Unsubscribe;
+export type LifecycleState<Endpoint extends HookEndpoint> = {
+    readonly status: "running";
+    readonly endpoint: Endpoint;
+    readonly peerId: string;
+    readonly listenAddrs: readonly string[];
+} | {
+    readonly status: "closed";
+} | {
+    readonly status: "failed";
+    readonly error: unknown;
+};
+/** @internal */
+export declare const mountEndpointLifecycle: <Endpoint extends HookEndpoint>(options: {
+    readonly bindAppState: (endpoint: Endpoint) => Unsubscribe;
+    readonly create: () => Endpoint;
+    readonly notify: (state: LifecycleState<Endpoint>) => void;
+    readonly schedule?: (callback: () => void) => void;
+}) => {
+    readonly close: () => void;
+    readonly cleanup: () => void;
+};
+//# sourceMappingURL=hook-lifecycle.d.ts.map

package/lib/typescript/src/hook-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/hook-lifecycle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,KAAK,WAAW,CAAC;IACjE,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,gBAAgB,EAAE,CAChB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KAC7B;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CAC7B;AAED,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,GAC7B,UAAU,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACzC,QAAQ,cAAc,KACrB,WA8BF,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,YAAY,IACpD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3D,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,YAAY,EAAE,SAAS;IAC7E,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,WAAW,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACpD,KAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CA8E7D,CAAC"}

package/lib/typescript/src/hooks.d.ts

@@ -0,0 +1,49 @@
+import type { DriverFailedError, Minip2pConfig, Unsubscribe } from "@minip2p/core";
+import { Minip2p } from "./adapter.js";
+/** Lifecycle state returned by {@link useMinip2p}. */
+export type Minip2pHookState = {
+    readonly status: "starting";
+    readonly endpoint?: undefined;
+    readonly peerId?: undefined;
+    readonly listenAddrs?: undefined;
+    readonly error?: undefined;
+} | {
+    readonly status: "running";
+    readonly endpoint: Minip2p;
+    readonly peerId: string;
+    readonly listenAddrs: readonly string[];
+    readonly error?: undefined;
+} | {
+    readonly status: "closed";
+    readonly endpoint?: undefined;
+    readonly peerId?: undefined;
+    readonly listenAddrs?: undefined;
+    readonly error?: undefined;
+} | {
+    readonly status: "failed";
+    readonly endpoint?: undefined;
+    readonly peerId?: undefined;
+    readonly listenAddrs?: undefined;
+    readonly error: unknown;
+};
+/** Hook lifecycle state plus an idempotent endpoint shutdown callback. */
+export type UseMinip2pResult = Minip2pHookState & {
+    /** Closes the currently owned endpoint, if one exists. */
+    readonly close: () => void;
+};
+/** Mirrors the current and future React Native AppState into an endpoint. */
+export declare const bindAppState: (endpoint: Pick<Minip2p, "setActive">) => Unsubscribe;
+/**
+ * Owns a native endpoint for a committed component lifetime.
+ *
+ * Keep `createConfig` pure and stable for the component lifetime. Endpoint
+ * construction happens only in the committed effect.
+ */
+export declare const useMinip2p: (createConfig: () => Minip2pConfig) => UseMinip2pResult;
+/** Narrows the failed hook state for consumers that want a native failure. */
+export declare const isDriverFailure: (state: Minip2pHookState) => state is Extract<Minip2pHookState, {
+    status: "failed";
+}> & {
+    error: DriverFailedError;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/src/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACZ,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAW,CAAC;AAGpC,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEN,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG;IAChD,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,KACnC,WAAqD,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,aAAa,KAChC,gBA8BF,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,eAAe,GAC1B,OAAO,gBAAgB,KACtB,KAAK,IAAI,OAAO,CAAC,gBAAgB,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG;IAC5D,KAAK,EAAE,iBAAiB,CAAC;CAIe,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,3 +1,4 @@
 export * from "@minip2p/core";
-export { MiniP2p, circuitAddress, generateSecretKey, peerIdFromSecretKey, } from "./adapter.js";
+export { Minip2p, circuitAddress, generateSecretKey, peerIdFromSecretKey, } from "./adapter.js";
+export { bindAppState, isDriverFailure, useMinip2p, type Minip2pHookState, type UseMinip2pResult, } from "./hooks.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,YAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minip2p/react-native",
-  "version": "0.1.1",
+  "version": "0.3.1",
   "description": "React Native bindings for minip2p",
   "keywords": [
     "android",
@@ -67,7 +67,7 @@
   "dependencies": {
     "@ubjs/core": "0.31.0-3",
     "uniffi-bindgen-react-native": "0.31.0-3",
-    "@minip2p/core": "0.1.0"
+    "@minip2p/core": "0.3.1"
   },
   "devDependencies": {
     "@react-native-community/cli": "20.1.0",
@@ -129,6 +129,7 @@
     "ubrn:android": "env -u LIBCLANG_PATH ANDROID_HOME=${ANDROID_HOME:-$HOME/Library/Android/sdk} ANDROID_NDK_HOME=${ANDROID_NDK_HOME:-$HOME/Library/Android/sdk/ndk/28.2.13676358} ubrn build android --release --config ubrn.config.yaml --and-generate && node scripts/normalize-generated.mjs && node scripts/generate-codegen.mjs && node scripts/normalize-generated.mjs",
     "clean": "del-cli android/.cxx android/build example/android/build example/android/app/build example/ios/build lib",
     "build": "bob build && node scripts/normalize-generated.mjs",
+    "test": "pnpm build && node --test tests/*.test.mjs",
     "typecheck": "tsc",
     "lint": "ultracite check",
     "format": "ultracite fix"

package/src/adapter.ts

@@ -1,9 +1,9 @@
-/* oxlint-disable class-methods-use-this, func-style, max-classes-per-file, no-use-before-define -- The adapter keeps its contract-complete native endpoint and public SDK subclass together, and uses hoisted conversion helpers. */
+/* oxlint-disable class-methods-use-this, complexity, func-style, max-classes-per-file, no-use-before-define -- The adapter keeps its contract-complete native endpoint and public SDK subclass together, and uses hoisted conversion helpers. */
 
 import {
   BackpressureError,
   MessageTooLargeError,
-  MiniP2pBase,
+  Minip2pBase,
   NotPermittedError,
   PubsubRouter,
 } from "@minip2p/core";
@@ -11,16 +11,18 @@ import type {
   Bytes,
   IdentifyInfo,
   KnownPeerInfo,
-  MiniP2pConfig,
-  MiniP2pDiscoveryOptions,
-  MiniP2pMdnsOptions,
-  P2pEvent,
+  Minip2pConfig,
+  Minip2pDiscoveryOptions,
+  Minip2pMdnsOptions,
   Reachability,
   RelayReservationInfo,
 } from "@minip2p/core";
 import type {
-  MiniP2pBackend,
-  MiniP2pBackendFactory,
+  Minip2pBackend,
+  Minip2pBackendFactory,
+  BackendOpenStream,
+  P2pEvent,
+  PathKind,
 } from "@minip2p/core/backend";
 
 import {
@@ -42,12 +44,12 @@ import type {
 } from "./native";
 import nativeModule from "./NativeMinip2p";
 
-class ReactNativeBackend implements MiniP2pBackend {
+class ReactNativeBackend implements Minip2pBackend {
   readonly #endpoint: P2pEndpoint;
   readonly #mdnsEnabled: boolean;
   #listener: P2pEventListener | undefined;
 
-  constructor(config: MiniP2pConfig) {
+  constructor(config: Minip2pConfig) {
     this.#mdnsEnabled = config.mdns !== undefined && config.mdns !== false;
     if (this.#mdnsEnabled) {
       nativeModule.setMdnsEnabled(true);
@@ -136,6 +138,13 @@ class ReactNativeBackend implements MiniP2pBackend {
       : normalizeReservation(reservation);
   }
 
+  path(peerId: string): PathKind | undefined {
+    const path = translateErrors(() => this.#endpoint.path(peerId));
+    return path === undefined
+      ? undefined
+      : (normalizeBigInts(path) as PathKind);
+  }
+
   circuitAddress(relayAddress: string, peerId: string): string {
     return translateErrors(() => nativeCircuitAddress(relayAddress, peerId));
   }
@@ -178,11 +187,14 @@ class ReactNativeBackend implements MiniP2pBackend {
     });
   }
 
-  openStream(peerId: string, protocolId: string): number {
-    return u64ToNumber(
-      translateErrors(() => this.#endpoint.openStream(peerId, protocolId)),
-      "streamId"
+  openStream(peerId: string, protocolId: string): BackendOpenStream {
+    const result = translateErrors(() =>
+      this.#endpoint.openStream(peerId, protocolId)
     );
+    return {
+      connId: u64ToNumber(result.connId, "connId"),
+      streamId: u64ToNumber(result.streamId, "streamId"),
+    };
   }
 
   sendStream(peerId: string, streamId: number, data: Uint8Array): void {
@@ -272,7 +284,7 @@ class ReactNativeBackend implements MiniP2pBackend {
   }
 }
 
-const backendFactory: MiniP2pBackendFactory = {
+const backendFactory: Minip2pBackendFactory = {
   circuitAddress: (relayAddress, peerId) =>
     translateErrors(() => nativeCircuitAddress(relayAddress, peerId)),
   create: (config) => new ReactNativeBackend(config),
@@ -282,14 +294,14 @@ const backendFactory: MiniP2pBackendFactory = {
 };
 
 /** High-level React Native owner for one native minip2p endpoint. */
-export class MiniP2p extends MiniP2pBase {
-  private constructor(backend: MiniP2pBackend, relays: readonly string[]) {
+export class Minip2p extends Minip2pBase {
+  private constructor(backend: Minip2pBackend, relays: readonly string[]) {
     super(backend, relays);
   }
 
   /** Constructs and starts a React Native endpoint. */
-  static create(config: MiniP2pConfig): MiniP2p {
-    return new MiniP2p(backendFactory.create(config), config.relays ?? []);
+  static create(config: Minip2pConfig): Minip2p {
+    return new Minip2p(backendFactory.create(config), config.relays ?? []);
   }
 }
 
@@ -308,17 +320,20 @@ export function circuitAddress(relayAddress: string, peerId: string): string {
   return backendFactory.circuitAddress(relayAddress, peerId);
 }
 
-function toNativeConfig(config: MiniP2pConfig): NativeEndpointConfig {
+function toNativeConfig(config: Minip2pConfig): NativeEndpointConfig {
   const discovery: NativeDiscoveryOptions | undefined =
     config.discovery === undefined
       ? undefined
       : {
-          autoDial: config.discovery.autoDial,
+          autoDial: config.discovery.autoDial ?? true,
           beaconIntervalMs: numberToU64(
-            config.discovery.beaconIntervalMs,
+            config.discovery.beaconIntervalMs ?? 10_000,
             "beaconIntervalMs"
           ),
-          peerTtlMs: numberToU64(config.discovery.peerTtlMs, "peerTtlMs"),
+          peerTtlMs: numberToU64(
+            config.discovery.peerTtlMs ?? 35_000,
+            "peerTtlMs"
+          ),
           topic: config.discovery.topic,
         };
   const mdnsOptions = config.mdns === true ? {} : config.mdns;
@@ -366,8 +381,8 @@ function toNativeConfig(config: MiniP2pConfig): NativeEndpointConfig {
 }
 
 function resolveMdnsAutoDial(
-  mdns: MiniP2pMdnsOptions,
-  discovery: MiniP2pDiscoveryOptions | undefined
+  mdns: Minip2pMdnsOptions,
+  discovery: Minip2pDiscoveryOptions | undefined
 ): boolean {
   return mdns.autoDial ?? discovery?.autoDial ?? true;
 }

package/src/generated/minip2p_ffi-ffi.ts

@@ -94,7 +94,8 @@ interface NativeModuleInterface {
     ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_is_running(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): number;
     ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_known_peers(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_listen_addrs(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
-    ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_open_stream(uniffiSelf: bigint, peerId: Uint8Array, protocolId: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
+    ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_open_stream(uniffiSelf: bigint, peerId: Uint8Array, protocolId: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_path(uniffiSelf: bigint, peerId: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_peer_id(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_peer_info(uniffiSelf: bigint, peerId: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     ubrn_uniffi_minip2p_ffi_fn_method_p2pendpoint_ping(uniffiSelf: bigint, peerId: Uint8Array, uniffi_out_err: UniffiRustCallStatus): void;
@@ -133,6 +134,7 @@ interface NativeModuleInterface {
     ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_known_peers(): number;
     ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_listen_addrs(): number;
     ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_open_stream(): number;
+    ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_path(): number;
     ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_peer_id(): number;
     ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_peer_info(): number;
     ubrn_uniffi_minip2p_ffi_checksum_method_p2pendpoint_ping(): number;