@minip2p/react-native 0.6.0 → 0.7.0

package/lib/typescript/src/generated/minip2p_ffi.d.ts

@@ -11,6 +11,27 @@ export declare function generateSecretKey(): ArrayBuffer;
  * Derives a base58 peer ID from raw Ed25519 secret key material.
  */
 export declare function peerIdFromSecretKey(secretKey: ArrayBuffer): string;
+/**
+ * State snapshot of the transport connection selected for a peer.
+ */
+export type ConnectionInfo = {
+    /**
+     * Endpoint-local transport connection id.
+     */
+    connId: bigint;
+    /**
+     * Remote transport address, when recorded.
+     */
+    remoteAddr?: string;
+};
+/**
+ * Generated factory for {@link ConnectionInfo} record objects.
+ */
+export declare const ConnectionInfo: Readonly<{
+    create: (partial: Partial<ConnectionInfo> & Required<Omit<ConnectionInfo, "remoteAddr">>) => ConnectionInfo;
+    new: (partial: Partial<ConnectionInfo> & Required<Omit<ConnectionInfo, "remoteAddr">>) => ConnectionInfo;
+    defaults: () => Partial<ConnectionInfo>;
+}>;
 /**
  * Signed-discovery configuration.
  */
@@ -40,26 +61,6 @@ export declare const DiscoveryOptions: Readonly<{
     new: (partial: Partial<DiscoveryOptions> & Required<Omit<DiscoveryOptions, never>>) => DiscoveryOptions;
     defaults: () => Partial<DiscoveryOptions>;
 }>;
-/**
- * One enabled transport and the addresses it should listen on.
- */
-export type TransportOptions = {
-    /**
-     * Exact listen multiaddresses, or transport defaults when absent.
-     *
-     * An explicitly empty list is rejected: omit this field for defaults or
-     * disable the transport by omitting it from [`EndpointConfig`].
-     */
-    listenAddrs?: Array<string>;
-};
-/**
- * Generated factory for {@link TransportOptions} record objects.
- */
-export declare const TransportOptions: Readonly<{
-    create: (partial: Partial<TransportOptions> & Required<Omit<TransportOptions, "listenAddrs">>) => TransportOptions;
-    new: (partial: Partial<TransportOptions> & Required<Omit<TransportOptions, "listenAddrs">>) => TransportOptions;
-    defaults: () => Partial<TransportOptions>;
-}>;
 /**
  * Local-link mDNS discovery configuration.
  */
@@ -122,13 +123,10 @@ export type EndpointConfig = {
      */
     autonatServers: Array<string>;
     /**
-     * QUIC configuration, or no QUIC transport when absent.
+     * Listen multiaddresses; each address's shape selects its transport.
+     * Absent binds the QUIC dual-stack defaults; an empty list is rejected.
      */
-    quic?: TransportOptions;
-    /**
-     * TCP configuration, or no TCP transport when absent.
-     */
-    tcp?: TransportOptions;
+    listen?: Array<string>;
     /**
      * Whether connection attempts must remain relayed.
      */
@@ -154,8 +152,8 @@ export type EndpointConfig = {
  * Generated factory for {@link EndpointConfig} record objects.
  */
 export declare const EndpointConfig: Readonly<{
-    create: (partial: Partial<EndpointConfig> & Required<Omit<EndpointConfig, "agentVersion" | "discovery" | "mdns" | "quic" | "tcp">>) => EndpointConfig;
-    new: (partial: Partial<EndpointConfig> & Required<Omit<EndpointConfig, "agentVersion" | "discovery" | "mdns" | "quic" | "tcp">>) => EndpointConfig;
+    create: (partial: Partial<EndpointConfig> & Required<Omit<EndpointConfig, "agentVersion" | "discovery" | "listen" | "mdns">>) => EndpointConfig;
+    new: (partial: Partial<EndpointConfig> & Required<Omit<EndpointConfig, "agentVersion" | "discovery" | "listen" | "mdns">>) => EndpointConfig;
     defaults: () => Partial<EndpointConfig>;
 }>;
 /**
@@ -278,6 +276,102 @@ export declare const RelayReservationInfo: Readonly<{
     new: (partial: Partial<RelayReservationInfo> & Required<Omit<RelayReservationInfo, "expiresUnixSecs">>) => RelayReservationInfo;
     defaults: () => Partial<RelayReservationInfo>;
 }>;
+export declare enum ConnectTarget_Tags {
+    Peer = "Peer",
+    Addresses = "Addresses"
+}
+/**
+ * What a foreign runtime supplies to start one Connection attempt.
+ *
+ * Validation lives in `minip2p-ffi-core`; this mirror only declares the shape.
+ */
+export declare const ConnectTarget: Readonly<{
+    instanceOf: (obj: any) => obj is ConnectTarget;
+    Peer: {
+        new (inner: {
+            peerId: string;
+        }): {
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ConnectTarget";
+            readonly tag: ConnectTarget_Tags.Peer;
+            readonly inner: Readonly<{
+                peerId: string;
+            }>;
+        };
+        "new"(inner: {
+            peerId: string;
+        }): {
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ConnectTarget";
+            readonly tag: ConnectTarget_Tags.Peer;
+            readonly inner: Readonly<{
+                peerId: string;
+            }>;
+        };
+        instanceOf(obj: any): obj is {
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ConnectTarget";
+            readonly tag: ConnectTarget_Tags.Peer;
+            readonly inner: Readonly<{
+                peerId: string;
+            }>;
+        };
+    };
+    Addresses: {
+        new (inner: {
+            addresses: Array<string>;
+        }): {
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ConnectTarget";
+            readonly tag: ConnectTarget_Tags.Addresses;
+            readonly inner: Readonly<{
+                addresses: Array<string>;
+            }>;
+        };
+        "new"(inner: {
+            addresses: Array<string>;
+        }): {
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ConnectTarget";
+            readonly tag: ConnectTarget_Tags.Addresses;
+            readonly inner: Readonly<{
+                addresses: Array<string>;
+            }>;
+        };
+        instanceOf(obj: any): obj is {
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ConnectTarget";
+            readonly tag: ConnectTarget_Tags.Addresses;
+            readonly inner: Readonly<{
+                addresses: Array<string>;
+            }>;
+        };
+    };
+}>;
+/**
+ * What a foreign runtime supplies to start one Connection attempt.
+ *
+ * Validation lives in `minip2p-ffi-core`; this mirror only declares the shape.
+ */
+export type ConnectTarget = InstanceType<typeof ConnectTarget['Peer' | 'Addresses']>;
 /**
  * Source that contributed a discovery observation.
  */
@@ -811,6 +905,9 @@ export declare const FfiError: Readonly<{
         new (inner: {
             detail: string;
         }): {
+            name: string;
+            message: string;
+            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -820,14 +917,14 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            name: string;
-            message: string;
-            stack?: string;
             cause?: unknown;
         };
         "new"(inner: {
             detail: string;
         }): {
+            name: string;
+            message: string;
+            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -837,12 +934,12 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            name: string;
-            message: string;
-            stack?: string;
             cause?: unknown;
         };
         instanceOf(obj: any): obj is {
+            name: string;
+            message: string;
+            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -852,12 +949,12 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            name: string;
-            message: string;
-            stack?: string;
             cause?: unknown;
         };
         hasInner(obj: any): obj is {
+            name: string;
+            message: string;
+            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -867,12 +964,12 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            name: string;
-            message: string;
-            stack?: string;
             cause?: unknown;
         };
         getInner(obj: {
+            name: string;
+            message: string;
+            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -882,9 +979,6 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            name: string;
-            message: string;
-            stack?: string;
             cause?: unknown;
         }): Readonly<{
             detail: string;
@@ -1081,9 +1175,6 @@ export declare const FfiError: Readonly<{
         new (inner: {
             detail: string;
         }): {
-            name: string;
-            message: string;
-            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -1093,14 +1184,14 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
+            name: string;
+            message: string;
+            stack?: string;
             cause?: unknown;
         };
         "new"(inner: {
             detail: string;
         }): {
-            name: string;
-            message: string;
-            stack?: string;
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -1110,12 +1201,12 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            cause?: unknown;
-        };
-        instanceOf(obj: any): obj is {
             name: string;
             message: string;
             stack?: string;
+            cause?: unknown;
+        };
+        instanceOf(obj: any): obj is {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -1125,12 +1216,12 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            cause?: unknown;
-        };
-        hasInner(obj: any): obj is {
             name: string;
             message: string;
             stack?: string;
+            cause?: unknown;
+        };
+        hasInner(obj: any): obj is {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -1140,12 +1231,12 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
-            cause?: unknown;
-        };
-        getInner(obj: {
             name: string;
             message: string;
             stack?: string;
+            cause?: unknown;
+        };
+        getInner(obj: {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
@@ -1155,6 +1246,9 @@ export declare const FfiError: Readonly<{
             readonly inner: Readonly<{
                 detail: string;
             }>;
+            name: string;
+            message: string;
+            stack?: string;
             cause?: unknown;
         }): Readonly<{
             detail: string;
@@ -1504,8 +1598,8 @@ export declare enum P2pEvent_Tags {
     InboundPathEstablished = "InboundPathEstablished",
     PathUpgraded = "PathUpgraded",
     HolePunchFailed = "HolePunchFailed",
-    FellBackToRelay = "FellBackToRelay",
     ConnectFailed = "ConnectFailed",
+    ConnectCancelled = "ConnectCancelled",
     InboundDirectUpgrade = "InboundDirectUpgrade",
     Message = "Message",
     PeerSubscribed = "PeerSubscribed",
@@ -1527,6 +1621,7 @@ export declare const P2pEvent: Readonly<{
         new (inner: {
             dropped: bigint;
             totalDropped: bigint;
+            terminalConnectIds: Array<bigint>;
         }): {
             /**
              * @private
@@ -1537,11 +1632,13 @@ export declare const P2pEvent: Readonly<{
             readonly inner: Readonly<{
                 dropped: bigint;
                 totalDropped: bigint;
+                terminalConnectIds: Array<bigint>;
             }>;
         };
         "new"(inner: {
             dropped: bigint;
             totalDropped: bigint;
+            terminalConnectIds: Array<bigint>;
         }): {
             /**
              * @private
@@ -1552,6 +1649,7 @@ export declare const P2pEvent: Readonly<{
             readonly inner: Readonly<{
                 dropped: bigint;
                 totalDropped: bigint;
+                terminalConnectIds: Array<bigint>;
             }>;
         };
         instanceOf(obj: any): obj is {
@@ -1564,6 +1662,7 @@ export declare const P2pEvent: Readonly<{
             readonly inner: Readonly<{
                 dropped: bigint;
                 totalDropped: bigint;
+                terminalConnectIds: Array<bigint>;
             }>;
         };
     };
@@ -2315,6 +2414,7 @@ export declare const P2pEvent: Readonly<{
         new (inner: {
             connectId: bigint;
             peerId: string;
+            connId: bigint;
             path: PathKind;
         }): {
             /**
@@ -2326,12 +2426,14 @@ export declare const P2pEvent: Readonly<{
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
+                connId: bigint;
                 path: PathKind;
             }>;
         };
         "new"(inner: {
             connectId: bigint;
             peerId: string;
+            connId: bigint;
             path: PathKind;
         }): {
             /**
@@ -2343,6 +2445,7 @@ export declare const P2pEvent: Readonly<{
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
+                connId: bigint;
                 path: PathKind;
             }>;
         };
@@ -2356,6 +2459,7 @@ export declare const P2pEvent: Readonly<{
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
+                connId: bigint;
                 path: PathKind;
             }>;
         };
@@ -2507,35 +2611,43 @@ export declare const P2pEvent: Readonly<{
             }>;
         };
     };
-    FellBackToRelay: {
+    ConnectFailed: {
         new (inner: {
             connectId: bigint;
             peerId: string;
+            kind: NatErrorKind;
+            detail: string;
         }): {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
              */
             readonly [uniffiTypeNameSymbol]: "P2pEvent";
-            readonly tag: P2pEvent_Tags.FellBackToRelay;
+            readonly tag: P2pEvent_Tags.ConnectFailed;
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
+                kind: NatErrorKind;
+                detail: string;
             }>;
         };
         "new"(inner: {
             connectId: bigint;
             peerId: string;
+            kind: NatErrorKind;
+            detail: string;
         }): {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
              */
             readonly [uniffiTypeNameSymbol]: "P2pEvent";
-            readonly tag: P2pEvent_Tags.FellBackToRelay;
+            readonly tag: P2pEvent_Tags.ConnectFailed;
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
+                kind: NatErrorKind;
+                detail: string;
             }>;
         };
         instanceOf(obj: any): obj is {
@@ -2544,50 +2656,44 @@ export declare const P2pEvent: Readonly<{
              * This field is private and should not be used, use `tag` instead.
              */
             readonly [uniffiTypeNameSymbol]: "P2pEvent";
-            readonly tag: P2pEvent_Tags.FellBackToRelay;
+            readonly tag: P2pEvent_Tags.ConnectFailed;
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
+                kind: NatErrorKind;
+                detail: string;
             }>;
         };
     };
-    ConnectFailed: {
+    ConnectCancelled: {
         new (inner: {
             connectId: bigint;
             peerId: string;
-            kind: NatErrorKind;
-            detail: string;
         }): {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
              */
             readonly [uniffiTypeNameSymbol]: "P2pEvent";
-            readonly tag: P2pEvent_Tags.ConnectFailed;
+            readonly tag: P2pEvent_Tags.ConnectCancelled;
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
-                kind: NatErrorKind;
-                detail: string;
             }>;
         };
         "new"(inner: {
             connectId: bigint;
             peerId: string;
-            kind: NatErrorKind;
-            detail: string;
         }): {
             /**
              * @private
              * This field is private and should not be used, use `tag` instead.
              */
             readonly [uniffiTypeNameSymbol]: "P2pEvent";
-            readonly tag: P2pEvent_Tags.ConnectFailed;
+            readonly tag: P2pEvent_Tags.ConnectCancelled;
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
-                kind: NatErrorKind;
-                detail: string;
             }>;
         };
         instanceOf(obj: any): obj is {
@@ -2596,12 +2702,10 @@ export declare const P2pEvent: Readonly<{
              * This field is private and should not be used, use `tag` instead.
              */
             readonly [uniffiTypeNameSymbol]: "P2pEvent";
-            readonly tag: P2pEvent_Tags.ConnectFailed;
+            readonly tag: P2pEvent_Tags.ConnectCancelled;
             readonly inner: Readonly<{
                 connectId: bigint;
                 peerId: string;
-                kind: NatErrorKind;
-                detail: string;
             }>;
         };
     };
@@ -3118,7 +3222,7 @@ export declare const P2pEvent: Readonly<{
 /**
  * Event delivered by the native endpoint driver.
  */
-export type P2pEvent = InstanceType<typeof P2pEvent['EventsDropped' | 'DriverFailed' | 'ConnectionEstablished' | 'ConnectionClosed' | 'PeerReady' | 'IdentifyReceived' | 'PingRttMeasured' | 'PingTimeout' | 'StreamReady' | 'StreamData' | 'StreamRemoteWriteClosed' | 'StreamClosed' | 'EndpointError' | 'ReachabilityChanged' | 'PublicAddressesChanged' | 'RelayReserved' | 'RelayReservationLost' | 'PathEstablished' | 'InboundPathEstablished' | 'PathUpgraded' | 'HolePunchFailed' | 'FellBackToRelay' | 'ConnectFailed' | 'InboundDirectUpgrade' | 'Message' | 'PeerSubscribed' | 'PeerUnsubscribed' | 'GossipsubOutboundFailure' | 'GossipsubProtocolViolation' | 'PeerDiscovered' | 'PeerUpdated' | 'PeerExpired' | 'DiscoveryDialFailed' | 'DiscoveryProtocolViolation']>;
+export type P2pEvent = InstanceType<typeof P2pEvent['EventsDropped' | 'DriverFailed' | 'ConnectionEstablished' | 'ConnectionClosed' | 'PeerReady' | 'IdentifyReceived' | 'PingRttMeasured' | 'PingTimeout' | 'StreamReady' | 'StreamData' | 'StreamRemoteWriteClosed' | 'StreamClosed' | 'EndpointError' | 'ReachabilityChanged' | 'PublicAddressesChanged' | 'RelayReserved' | 'RelayReservationLost' | 'PathEstablished' | 'InboundPathEstablished' | 'PathUpgraded' | 'HolePunchFailed' | 'ConnectFailed' | 'ConnectCancelled' | 'InboundDirectUpgrade' | 'Message' | 'PeerSubscribed' | 'PeerUnsubscribed' | 'GossipsubOutboundFailure' | 'GossipsubProtocolViolation' | 'PeerDiscovered' | 'PeerUpdated' | 'PeerExpired' | 'DiscoveryDialFailed' | 'DiscoveryProtocolViolation']>;
 /**
  * Doorbell implemented by the embedding runtime.
  */
@@ -3168,33 +3272,17 @@ export interface P2pEndpointLike {
      */
     closeStreamWrite(peerId: string, streamId: bigint): void;
     /**
-     * Starts a connection attempt.
+     * Starts one Connection attempt and returns its Connect ID.
      */
-    connect(peerId: string): bigint;
-    /**
-     * Starts a direct-address connection attempt.
-     */
-    connectAddr(address: string): bigint;
-    /**
-     * Starts a connection attempt with explicit addresses.
-     */
-    connectWithAddrs(peerId: string, addresses: Array<string>): bigint;
+    connect(target: ConnectTarget): bigint;
     /**
      * Returns connected peers.
      */
     connectedPeers(): Array<string>;
     /**
-     * Dials on all applicable address families.
-     */
-    dial(address: string): Array<bigint>;
-    /**
-     * Dials using IPv4.
+     * Returns the transport connection selected for a peer.
      */
-    dialIp4(address: string): bigint;
-    /**
-     * Dials using IPv6.
-     */
-    dialIp6(address: string): bigint;
+    connectionInfo(peerId: string): ConnectionInfo | undefined;
     /**
      * Disconnects a peer.
      */
@@ -3320,33 +3408,17 @@ export declare class P2pEndpoint extends UniffiAbstractObject implements P2pEndp
      */
     closeStreamWrite(peerId: string, streamId: bigint): void;
     /**
-     * Starts a connection attempt.
-     */
-    connect(peerId: string): bigint;
-    /**
-     * Starts a direct-address connection attempt.
-     */
-    connectAddr(address: string): bigint;
-    /**
-     * Starts a connection attempt with explicit addresses.
+     * Starts one Connection attempt and returns its Connect ID.
      */
-    connectWithAddrs(peerId: string, addresses: Array<string>): bigint;
+    connect(target: ConnectTarget): bigint;
     /**
      * Returns connected peers.
      */
     connectedPeers(): Array<string>;
     /**
-     * Dials on all applicable address families.
+     * Returns the transport connection selected for a peer.
      */
-    dial(address: string): Array<bigint>;
-    /**
-     * Dials using IPv4.
-     */
-    dialIp4(address: string): bigint;
-    /**
-     * Dials using IPv6.
-     */
-    dialIp6(address: string): bigint;
+    connectionInfo(peerId: string): ConnectionInfo | undefined;
     /**
      * Disconnects a peer.
      */
@@ -3452,6 +3524,20 @@ declare function uniffiEnsureInitialized(): void;
 declare const _default: Readonly<{
     initialize: typeof uniffiEnsureInitialized;
     converters: {
+        FfiConverterTypeConnectTarget: {
+            readFromCursor(c: Cursor): ConnectTarget;
+            writeIntoCursor(value: ConnectTarget, c: Cursor): void;
+            allocationSize(value: ConnectTarget): number;
+            lift(value: UniffiByteArray): ConnectTarget;
+            lower(value: ConnectTarget, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeConnectionInfo: {
+            readFromCursor(c: Cursor): ConnectionInfo;
+            writeIntoCursor(value: ConnectionInfo, c: Cursor): void;
+            allocationSize(value: ConnectionInfo): number;
+            lift(value: UniffiByteArray): ConnectionInfo;
+            lower(value: ConnectionInfo, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
         FfiConverterTypeDiscoveryOptions: {
             readFromCursor(c: Cursor): DiscoveryOptions;
             writeIntoCursor(value: DiscoveryOptions, c: Cursor): void;
@@ -3559,13 +3645,6 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): RelayReservationInfo;
             lower(value: RelayReservationInfo, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
-        FfiConverterTypeTransportOptions: {
-            readFromCursor(c: Cursor): TransportOptions;
-            writeIntoCursor(value: TransportOptions, c: Cursor): void;
-            allocationSize(value: TransportOptions): number;
-            lift(value: UniffiByteArray): TransportOptions;
-            lower(value: TransportOptions, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
-        };
     };
 }>;
 export default _default;