@minip2p/core 0.11.2 → 0.11.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -39,7 +39,7 @@ for await (const event of endpoint.events({ signal })) {
39
39
  }
40
40
  ```
41
41
 
42
- A peer holds one connection at a time. `connectionEstablished` and `connectionClosed` mark the peer connecting and disconnecting, and `connectionClosed` carries a `reason` (`ConnectionCloseReason`: `local`, `remote` with the peer's `code`, `timedOut`, `stalled`, or `error` with a `message`); when a newer connection takes the peer's slot, a single `connectionReplaced` (`{ peerId, oldConnId, newConnId }`) stands in for both, the peer stays connected, and streams and pending opens on `oldConnId` end with `StreamClosedError`. `peerReady` carries the `connId` that completed Identify and fires once per connection. `waitPeerReady` follows the peer's current connection, so a stale `peerReady` for a replaced connection never resolves it; it resolves at once when `connectionInfo(peerId).readyProtocols` shows the current connection is already ready, and rejects with `PeerDisconnectedError` when that connection closes.
42
+ A peer holds one connection at a time. `connectionEstablished` and `connectionClosed` mark the peer connecting and disconnecting, and `connectionClosed` carries a `reason` (`ConnectionCloseReason`: `local`, `remote` with the peer's `code`, `timedOut`, `stalled`, or `error` with a `message`); when a newer connection takes the peer's slot, a single `connectionReplaced` (`{ peerId, oldConnId, newConnId }`) stands in for both, the peer stays connected, and streams and pending opens on `oldConnId` end with `StreamClosedError`. `peerReady` carries the `connId` that completed Identify and fires once per connection. `waitPeerReady` follows the peer's current connection, so a stale `peerReady` for a replaced connection never resolves it; it resolves at once when `connectionInfo(peerId).readyProtocols` shows the current connection is already ready, and rejects with `PeerDisconnectedError` when that connection closes. When the connection's first Identify failed, the rejection is `IdentifyFailedError`, a `PeerDisconnectedError` with `connId` and `kind` (the `IdentifyFailure`). `identifyFailed` (`{ peerId, connId, cause }`, `cause` from `IdentifyFailure`: `TimedOut`, `OpenFailed`, `Rejected`, `ClosedEarly`, or `Malformed`) reports that failure; the connection never becomes ready, its `connectionClosed` follows, and Identify is not retried, so redial to try again.
43
43
 
44
44
  `connect` accepts a Connection target: a peer ID, one complete peer multiaddress, or a list of complete addresses naming one peer. For a Connection attempt, a timeout ends only the local wait (`cancelOnTimeout: true` opts into cancelling), an aborted `signal` cancels the attempt (the wait settles from its terminal), and a terminal lost to event overflow rejects with `ConnectResultLostError`. Waits never stop unrelated events from reaching other subscribers.
45
45
 
@@ -62,12 +62,12 @@ const endpoint = Minip2p.create({
62
62
  });
63
63
  ```
64
64
 
65
- `timeouts` overrides the protocol deadlines, in milliseconds: `negotiationMs` (one outbound stream's protocol negotiation), `identifyMs` (the time a connection's first Identify may take; the connection is closed if it fails or runs out) and `pingMs` (one ping's echo). Each defaults to 10 s; omitted fields keep it. Keep `identifyMs` at least `negotiationMs`, and raise both on links whose loaded RTT exceeds a few seconds. A zero throws `InvalidConfigError` with capability `Options`. Unlike `limits`, `timeouts` applies in `@minip2p/web` too. The `minip2p-rs` README's Deadlines table lists every deadline and how they relate.
65
+ `timeouts` overrides the protocol deadlines, in milliseconds: `negotiationMs` (one outbound stream's protocol negotiation), `identifyMs` (the time a connection's first Identify may take, its negotiation included; the connection is closed if it fails or runs out) and `pingMs` (one ping, from opening its stream to the echo). `negotiationMs` and `identifyMs` default to 30 s and `pingMs` to 10 s; omitted fields keep their default. On a slow or loaded link, size them from how long each exchange actually takes there, plus slack for a retransmission. `waitPeerReady`'s default timeout allows a connect plus `identifyMs`. A zero throws `InvalidConfigError` with capability `Options`. Unlike `limits`, `timeouts` applies in `@minip2p/web` too. The `minip2p-rs` README's Deadlines table lists every deadline and how they relate.
66
66
 
67
67
  ```ts
68
68
  const endpoint = Minip2p.create({
69
69
  secretKey,
70
- timeouts: { negotiationMs: 30_000, identifyMs: 45_000 },
70
+ timeouts: { negotiationMs: 45_000, identifyMs: 45_000 },
71
71
  });
72
72
  ```
73
73
 
package/dist/errors.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { ConfigCapability, DriverFailureKind, EndpointErrorKind, NatErrorKind } from "./types.js";
1
+ import type { ConfigCapability, DriverFailureKind, EndpointErrorKind, IdentifyFailure, NatErrorKind, PingFailure } from "./types.js";
2
2
  /** Pubsub rejected a publish because its bounded native queue is full. */
3
3
  export declare class BackpressureError extends Error {
4
4
  constructor();
@@ -81,7 +81,32 @@ export declare class ConnectResultUnavailableError extends Error {
81
81
  export declare class PeerDisconnectedError extends Error {
82
82
  readonly peerId: string;
83
83
  readonly operation?: string;
84
- constructor(peerId: string, operation?: string);
84
+ /** `reason`, when given, is appended to the message. */
85
+ constructor(peerId: string, operation?: string, reason?: string);
86
+ }
87
+ /** A ping attempt failed natively; `kind` (the `pingFailed` event's `cause`) says why. */
88
+ export declare class PingFailedError extends Error {
89
+ readonly peerId: string;
90
+ /** The connection the ping was sent on. */
91
+ readonly connId: number;
92
+ /** Why the ping failed. */
93
+ readonly kind: PingFailure;
94
+ constructor(options: {
95
+ peerId: string;
96
+ connId: number;
97
+ cause: PingFailure;
98
+ });
99
+ }
100
+ /**
101
+ * The peer's connection failed its first Identify, so it never became ready
102
+ * and was closed. `kind` is the `identifyFailed` event's `cause`. Rejects `waitPeerReady`; redial to try again.
103
+ */
104
+ export declare class IdentifyFailedError extends PeerDisconnectedError {
105
+ /** The connection whose first Identify failed. */
106
+ readonly connId: number;
107
+ /** Why Identify failed. */
108
+ readonly kind: IdentifyFailure;
109
+ constructor(peerId: string, connId: number, kind: IdentifyFailure);
85
110
  }
86
111
  /** Outbound stream opening or protocol negotiation failed. */
87
112
  export declare class OpenStreamError extends Error {
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/errors.js CHANGED
@@ -130,15 +130,48 @@ export class ConnectResultUnavailableError extends Error {
130
130
  export class PeerDisconnectedError extends Error {
131
131
  peerId;
132
132
  operation;
133
- constructor(peerId, operation) {
134
- super(operation === undefined
133
+ /** `reason`, when given, is appended to the message. */
134
+ constructor(peerId, operation, reason) {
135
+ const base = operation === undefined
135
136
  ? `Peer ${peerId} disconnected`
136
- : `Peer ${peerId} disconnected during ${operation}`);
137
+ : `Peer ${peerId} disconnected during ${operation}`;
138
+ super(reason === undefined ? base : `${base}: ${reason}`);
137
139
  this.name = "PeerDisconnectedError";
138
140
  this.peerId = peerId;
139
141
  this.operation = operation;
140
142
  }
141
143
  }
144
+ /** A ping attempt failed natively; `kind` (the `pingFailed` event's `cause`) says why. */
145
+ export class PingFailedError extends Error {
146
+ peerId;
147
+ /** The connection the ping was sent on. */
148
+ connId;
149
+ /** Why the ping failed. */
150
+ kind;
151
+ constructor(options) {
152
+ super(`Ping to ${options.peerId} failed: ${options.cause}`);
153
+ this.name = "PingFailedError";
154
+ this.peerId = options.peerId;
155
+ this.connId = options.connId;
156
+ this.kind = options.cause;
157
+ }
158
+ }
159
+ /**
160
+ * The peer's connection failed its first Identify, so it never became ready
161
+ * and was closed. `kind` is the `identifyFailed` event's `cause`. Rejects `waitPeerReady`; redial to try again.
162
+ */
163
+ export class IdentifyFailedError extends PeerDisconnectedError {
164
+ /** The connection whose first Identify failed. */
165
+ connId;
166
+ /** Why Identify failed. */
167
+ kind;
168
+ constructor(peerId, connId, kind) {
169
+ super(peerId, "waitPeerReady", `Identify failed (${kind})`);
170
+ this.name = "IdentifyFailedError";
171
+ this.connId = connId;
172
+ this.kind = kind;
173
+ }
174
+ }
142
175
  /** Outbound stream opening or protocol negotiation failed. */
143
176
  export class OpenStreamError extends Error {
144
177
  /** Machine-readable native error category, or a synchronous adapter error. */
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { AbortError, BackpressureError, ClosedError, ConnectCancelledError, ConnectFailedError, ConnectResultLostError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, InvalidConfigError, MessageTooLargeError, NotPermittedError, OpenStreamError, PeerDisconnectedError, StreamClosedError, TimeoutError, WriteBufferFullError, } from "./errors.js";
1
+ export { AbortError, BackpressureError, ClosedError, ConnectCancelledError, ConnectFailedError, ConnectResultLostError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, IdentifyFailedError, InvalidConfigError, MessageTooLargeError, NotPermittedError, OpenStreamError, PeerDisconnectedError, PingFailedError, StreamClosedError, TimeoutError, WriteBufferFullError, } from "./errors.js";
2
2
  export { Minip2pBase, Stream, type StreamEventMap } from "./sdk.js";
3
- export { CloseOutcome, ConfigCapability, DiscoverySource, DriverFailureKind, EndpointErrorKind, MdnsFailureKind, NatErrorKind, Reachability, type Bytes, type ConnectionCloseReason, type ConnectionInfo, type ConnectOptions, type ConnectResult, type ConnectTarget, type EndpointCloseReason, type EndpointCloseReport, type EventsOptions, type IdentifyInfo, type InboundStreamMeta, type KnownPeerInfo, type Minip2pCatchAllEventMap, type Minip2pCongestionController, type Minip2pConfig, type Minip2pDiscoveryOptions, type Minip2pEvent, type Minip2pLimits, type Minip2pMdnsOptions, type Minip2pNamedEventMap, type Minip2pQuicLimits, type Minip2pTcpLimits, type Minip2pTimeouts, type Minip2pYamuxLimits, type OnceOptions, type OpOptions, type Path, type RelayReservationInfo, type Unsubscribe, type WaitForOptions, } from "./types.js";
3
+ export { CloseOutcome, ConfigCapability, DiscoverySource, DriverFailureKind, EndpointErrorKind, IdentifyFailure, MdnsFailureKind, NatErrorKind, PingFailure, Reachability, type Bytes, type ConnectionCloseReason, type ConnectionInfo, type ConnectOptions, type ConnectResult, type ConnectTarget, type EndpointCloseReason, type EndpointCloseReport, type EventsOptions, type IdentifyInfo, type InboundStreamMeta, type KnownPeerInfo, type Minip2pCatchAllEventMap, type Minip2pCongestionController, type Minip2pConfig, type Minip2pDiscoveryOptions, type Minip2pEvent, type Minip2pLimits, type Minip2pMdnsOptions, type Minip2pNamedEventMap, type Minip2pQuicLimits, type Minip2pTcpLimits, type Minip2pTimeouts, type Minip2pYamuxLimits, type OnceOptions, type OpOptions, type Path, type RelayReservationInfo, type Unsubscribe, type WaitForOptions, } from "./types.js";
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { AbortError, BackpressureError, ClosedError, ConnectCancelledError, ConnectFailedError, ConnectResultLostError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, InvalidConfigError, MessageTooLargeError, NotPermittedError, OpenStreamError, PeerDisconnectedError, StreamClosedError, TimeoutError, WriteBufferFullError, } from "./errors.js";
1
+ export { AbortError, BackpressureError, ClosedError, ConnectCancelledError, ConnectFailedError, ConnectResultLostError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, IdentifyFailedError, InvalidConfigError, MessageTooLargeError, NotPermittedError, OpenStreamError, PeerDisconnectedError, PingFailedError, StreamClosedError, TimeoutError, WriteBufferFullError, } from "./errors.js";
2
2
  export { Minip2pBase, Stream } from "./sdk.js";
3
- export { CloseOutcome, ConfigCapability, DiscoverySource, DriverFailureKind, EndpointErrorKind, MdnsFailureKind, NatErrorKind, Reachability, } from "./types.js";
3
+ export { CloseOutcome, ConfigCapability, DiscoverySource, DriverFailureKind, EndpointErrorKind, IdentifyFailure, MdnsFailureKind, NatErrorKind, PingFailure, Reachability, } from "./types.js";
4
4
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAuB,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,GA+Bb,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAuB,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,GA+Bb,MAAM,YAAY,CAAC"}
package/dist/sdk.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import type { Minip2pBackend } from "./backend.js";
2
- import type { Bytes, ConnectionInfo, ConnectOptions, ConnectResult, ConnectTarget, EndpointCloseReport, EventsOptions, IdentifyInfo, InboundStreamMeta, KnownPeerInfo, Minip2pEvent, Minip2pNamedEventMap, OnceOptions, OpOptions, Path, Reachability, RelayReservationInfo, Unsubscribe, WaitForOptions } from "./types.js";
2
+ import type { Bytes, ConnectionInfo, ConnectOptions, ConnectResult, ConnectTarget, EndpointCloseReport, EventsOptions, IdentifyInfo, InboundStreamMeta, KnownPeerInfo, Minip2pConfig, Minip2pEvent, Minip2pNamedEventMap, OnceOptions, OpOptions, Path, Reachability, RelayReservationInfo, Unsubscribe, WaitForOptions } from "./types.js";
3
3
  type EventKind = keyof Minip2pNamedEventMap;
4
4
  type NamedHandler<Kind extends EventKind> = (payload: Minip2pNamedEventMap[Kind]) => void;
5
5
  type CatchAllHandler = (event: Minip2pEvent) => void;
@@ -124,7 +124,7 @@ export interface StreamEventMap {
124
124
  */
125
125
  export declare class Minip2pBase {
126
126
  #private;
127
- protected constructor(backend: Minip2pBackend, relayAddresses: readonly string[]);
127
+ protected constructor(backend: Minip2pBackend, config: Pick<Minip2pConfig, "relays" | "timeouts">);
128
128
  /** Subscribes to one named event and returns an idempotent unsubscribe. */
129
129
  on<Kind extends EventKind>(type: Kind, handler: NamedHandler<Kind>): Unsubscribe;
130
130
  /** Subscribes to the catch-all metadata event stream. */
@@ -214,16 +214,27 @@ export declare class Minip2pBase {
214
214
  addProtocol(protocolId: string): void;
215
215
  /**
216
216
  * Waits until the peer's current connection is ready, or rejects if the
217
- * peer disconnects.
217
+ * peer disconnects: with `IdentifyFailedError` (a `PeerDisconnectedError`
218
+ * whose `kind` is the cause) when that connection's first Identify failed.
218
219
  *
219
220
  * A `peerReady` resolves it only while its connection is still the peer's
220
221
  * current one, so a stale `peerReady` for a replaced connection does not.
222
+ * The default timeout outlasts a connect plus the first-Identify deadline
223
+ * (`timeouts.identifyMs`), so the native side settles readiness first.
221
224
  */
222
225
  waitPeerReady(peerId: string, options?: OpOptions): Promise<{
223
226
  readonly peerId: string;
224
227
  readonly protocols: readonly string[];
225
228
  }>;
226
- /** Measures round-trip latency in milliseconds, coalescing concurrent calls. */
229
+ /**
230
+ * Measures round-trip latency in milliseconds. Calls join the peer's
231
+ * running attempt, including one whose earlier callers timed out or
232
+ * aborted, until it ends. Rejects with {@link PingFailedError} when the native ping fails (its
233
+ * `pingMs` deadline covers the open, negotiation and echo), and with
234
+ * {@link PeerDisconnectedError} when the connection closes first, or with
235
+ * {@link EventQueueOverflowError} when events are lost and its result may
236
+ * be among them.
237
+ */
227
238
  ping(peerId: string, options?: OpOptions): Promise<number>;
228
239
  /** Opens and negotiates an application-protocol stream. */
229
240
  openStream(peerId: string, protocolId: string, options?: OpOptions): Promise<Stream>;
package/dist/sdk.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}
package/dist/sdk.js CHANGED
@@ -1,7 +1,14 @@
1
1
  /* oxlint-disable default-case, func-style, max-classes-per-file, no-await-in-loop, no-empty-function, no-loop-func, no-use-before-define, promise/avoid-new, promise/prefer-await-to-callbacks, promise/prefer-await-to-then, typescript/no-invalid-void-type, unicorn/consistent-function-scoping, unicorn/no-new-array, unicorn/no-useless-spread, unicorn/no-useless-undefined -- Promise adapters, sequential async iterators, void event payloads, snapshot fan-out, and bounded queues are deliberate SDK internals. */
2
- import { AbortError, ClosedError, ConnectCancelledError, ConnectFailedError, ConnectResultLostError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, OpenStreamError, PeerDisconnectedError, StreamClosedError, TimeoutError, WriteBufferFullError, } from "./errors.js";
2
+ import { AbortError, ClosedError, ConnectCancelledError, ConnectFailedError, ConnectResultLostError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, IdentifyFailedError, OpenStreamError, PeerDisconnectedError, PingFailedError, StreamClosedError, TimeoutError, WriteBufferFullError, } from "./errors.js";
3
3
  import { CloseOutcome, ConnectionCloseReason_Tags, P2pEvent_Tags, PathKind_Tags, } from "./types.js";
4
4
  const DEFAULT_TIMEOUT_MS = 65_000;
5
+ /** The native connect deadline and default first-Identify deadline. */
6
+ const CONNECT_DEADLINE_MS = 30_000;
7
+ const IDENTIFY_DEADLINE_MS = 30_000;
8
+ /** Margin a readiness wait keeps past the native deadlines. */
9
+ const READY_SLACK_MS = 5000;
10
+ /** The longest delay `setTimeout` honours; longer ones fire at once. */
11
+ const MAX_TIMER_MS = 2_147_483_647;
5
12
  /**
6
13
  * Default close drain: the Rust `minip2p::DEFAULT_CLOSE_TIMEOUT` (500 ms)
7
14
  * that `Endpoint::close` and native's `DEFAULT_STOP_TIMEOUT_MS` use.
@@ -189,6 +196,7 @@ const connectionsOf = (event) => {
189
196
  const UNSEEN_CONNECTION_TAGS = new Set([
190
197
  P2pEvent_Tags.PeerReady,
191
198
  P2pEvent_Tags.IdentifyReceived,
199
+ P2pEvent_Tags.IdentifyFailed,
192
200
  P2pEvent_Tags.EndpointError,
193
201
  P2pEvent_Tags.StreamRemoteWriteClosed,
194
202
  P2pEvent_Tags.StreamWriteStopped,
@@ -863,6 +871,8 @@ const consumeUntracked = (backend, inner) => {
863
871
  export class Minip2pBase {
864
872
  #backend;
865
873
  #relayAddrs;
874
+ /** `waitPeerReady`'s default timeout: connect + Identify + slack. */
875
+ #readyTimeoutMs;
866
876
  #named = new Map();
867
877
  #catchAll = new Set();
868
878
  #closeHandlers = new Set();
@@ -881,9 +891,12 @@ export class Minip2pBase {
881
891
  /** Settles once the native drain finished and close observers ran. */
882
892
  #closing;
883
893
  #closeReported = false;
884
- constructor(backend, relayAddresses) {
894
+ constructor(backend, config) {
885
895
  this.#backend = backend;
886
- this.#relayAddrs = relayAddresses;
896
+ this.#relayAddrs = config.relays ?? [];
897
+ this.#readyTimeoutMs = Math.min(CONNECT_DEADLINE_MS +
898
+ (config.timeouts?.identifyMs ?? IDENTIFY_DEADLINE_MS) +
899
+ READY_SLACK_MS, MAX_TIMER_MS);
887
900
  try {
888
901
  backend.start((event) => {
889
902
  this.#enqueueNative(event);
@@ -1158,10 +1171,13 @@ export class Minip2pBase {
1158
1171
  }
1159
1172
  /**
1160
1173
  * Waits until the peer's current connection is ready, or rejects if the
1161
- * peer disconnects.
1174
+ * peer disconnects: with `IdentifyFailedError` (a `PeerDisconnectedError`
1175
+ * whose `kind` is the cause) when that connection's first Identify failed.
1162
1176
  *
1163
1177
  * A `peerReady` resolves it only while its connection is still the peer's
1164
1178
  * current one, so a stale `peerReady` for a replaced connection does not.
1179
+ * The default timeout outlasts a connect plus the first-Identify deadline
1180
+ * (`timeouts.identifyMs`), so the native side settles readiness first.
1165
1181
  */
1166
1182
  waitPeerReady(peerId, options = {}) {
1167
1183
  // One snapshot, so readiness, connection and protocols agree.
@@ -1176,6 +1192,7 @@ export class Minip2pBase {
1176
1192
  const removeExternalAbort = listenAbort(options.signal, () => {
1177
1193
  controller.abort();
1178
1194
  });
1195
+ const timeoutMs = options.timeoutMs ?? this.#readyTimeoutMs;
1179
1196
  // Events trail the native state, so a queued `peerReady` counts only if
1180
1197
  // its connection is still the peer's current one; a replaced
1181
1198
  // connection's readiness never resolves the wait.
@@ -1184,40 +1201,66 @@ export class Minip2pBase {
1184
1201
  predicate: (event) => event.peerId === peerId &&
1185
1202
  this.#backend.connectionInfo(peerId)?.connId === event.connId,
1186
1203
  signal: controller.signal,
1204
+ timeoutMs,
1187
1205
  }).then(({ protocols }) => ({ peerId, protocols }));
1206
+ // The failed connection may already be gone natively, so a failure
1207
+ // counts if it names the peer's current connection or, once native has
1208
+ // none, the last one this wait knew.
1209
+ let knownConnId = info?.connId;
1210
+ const identifyFailed = this.waitFor("identifyFailed", {
1211
+ ...options,
1212
+ predicate: (event) => {
1213
+ if (event.peerId !== peerId) {
1214
+ return false;
1215
+ }
1216
+ knownConnId =
1217
+ this.#backend.connectionInfo(peerId)?.connId ?? knownConnId;
1218
+ return (knownConnId ?? event.connId) === event.connId;
1219
+ },
1220
+ signal: controller.signal,
1221
+ timeoutMs,
1222
+ }).then(({ connId, cause }) => {
1223
+ throw new IdentifyFailedError(peerId, connId, cause);
1224
+ });
1188
1225
  const disconnected = this.waitFor("connectionClosed", {
1189
1226
  ...options,
1190
1227
  predicate: (event) => event.peerId === peerId &&
1191
1228
  !this.#backend.connectedPeers().includes(peerId),
1192
1229
  signal: controller.signal,
1230
+ timeoutMs,
1193
1231
  }).then(() => {
1194
1232
  throw new PeerDisconnectedError(peerId, "waitPeerReady");
1195
1233
  });
1196
- return Promise.race([ready, disconnected]).finally(() => {
1234
+ return Promise.race([ready, identifyFailed, disconnected]).finally(() => {
1197
1235
  removeExternalAbort?.();
1198
1236
  controller.abort();
1199
1237
  });
1200
1238
  }
1201
- /** Measures round-trip latency in milliseconds, coalescing concurrent calls. */
1239
+ /**
1240
+ * Measures round-trip latency in milliseconds. Calls join the peer's
1241
+ * running attempt, including one whose earlier callers timed out or
1242
+ * aborted, until it ends. Rejects with {@link PingFailedError} when the native ping fails (its
1243
+ * `pingMs` deadline covers the open, negotiation and echo), and with
1244
+ * {@link PeerDisconnectedError} when the connection closes first, or with
1245
+ * {@link EventQueueOverflowError} when events are lost and its result may
1246
+ * be among them.
1247
+ */
1202
1248
  ping(peerId, options = {}) {
1203
1249
  this.#assertOpen();
1204
1250
  let operation = this.#pings.get(peerId);
1205
1251
  if (operation === undefined) {
1252
+ // Native events are flushed asynchronously, so none can arrive before
1253
+ // the operation below listens.
1254
+ this.#backend.ping(peerId);
1206
1255
  operation = this.#runPing(peerId);
1256
+ // Kept until its terminal event, even after every caller stops
1257
+ // waiting: a later call joins the native attempt still running, so an
1258
+ // older attempt's result never settles a newer one.
1207
1259
  this.#pings.set(peerId, operation);
1208
1260
  const current = operation;
1209
1261
  void operation.promise.then(() => this.#removePing(peerId, current), () => this.#removePing(peerId, current));
1210
- this.#backend.ping(peerId);
1211
1262
  }
1212
- operation.callers += 1;
1213
- const current = operation;
1214
- return withOptions(operation.promise, options).finally(() => {
1215
- current.callers -= 1;
1216
- if (current.callers === 0 && this.#pings.get(peerId) === current) {
1217
- current.cancel(new AbortError("No ping callers remain"));
1218
- this.#pings.delete(peerId);
1219
- }
1220
- });
1263
+ return withOptions(operation.promise, options);
1221
1264
  }
1222
1265
  /** Opens and negotiates an application-protocol stream. */
1223
1266
  openStream(peerId, protocolId, options = {}) {
@@ -1397,10 +1440,10 @@ export class Minip2pBase {
1397
1440
  resolve(event.rttMs);
1398
1441
  }
1399
1442
  });
1400
- const offTimeout = this.on("pingTimeout", (event) => {
1443
+ const offFailed = this.on("pingFailed", (event) => {
1401
1444
  if (event.peerId === peerId) {
1402
1445
  finish();
1403
- reject(new TimeoutError());
1446
+ reject(new PingFailedError(event));
1404
1447
  }
1405
1448
  });
1406
1449
  const offClosed = this.on("connectionClosed", (event) => {
@@ -1412,7 +1455,7 @@ export class Minip2pBase {
1412
1455
  });
1413
1456
  cleanup = () => {
1414
1457
  offRtt();
1415
- offTimeout();
1458
+ offFailed();
1416
1459
  offClosed();
1417
1460
  };
1418
1461
  const finish = () => {
@@ -1423,7 +1466,6 @@ export class Minip2pBase {
1423
1466
  };
1424
1467
  });
1425
1468
  return {
1426
- callers: 0,
1427
1469
  cancel: (error) => {
1428
1470
  if (!settled) {
1429
1471
  settled = true;
@@ -1578,6 +1620,12 @@ export class Minip2pBase {
1578
1620
  }
1579
1621
  if (event.tag === P2pEvent_Tags.EventsDropped) {
1580
1622
  this.#connectResultsLost(event.inner.terminalConnectIds);
1623
+ // A ping's result may be among the lost events, and a ping kept
1624
+ // without it would never settle, so end every pending ping.
1625
+ for (const ping of this.#pings.values()) {
1626
+ ping.cancel(new EventQueueOverflowError());
1627
+ }
1628
+ this.#pings.clear();
1581
1629
  }
1582
1630
  const normalized = normalizeEvent(event);
1583
1631
  this.#dispatch(normalized.type, normalized.payload, normalized.payload);
@@ -1956,8 +2004,9 @@ const SDK_EVENT_NAMES = {
1956
2004
  [P2pEvent_Tags.ConnectionReplaced]: "connectionReplaced",
1957
2005
  [P2pEvent_Tags.PeerReady]: "peerReady",
1958
2006
  [P2pEvent_Tags.IdentifyReceived]: "identifyReceived",
2007
+ [P2pEvent_Tags.IdentifyFailed]: "identifyFailed",
1959
2008
  [P2pEvent_Tags.PingRttMeasured]: "pingRttMeasured",
1960
- [P2pEvent_Tags.PingTimeout]: "pingTimeout",
2009
+ [P2pEvent_Tags.PingFailed]: "pingFailed",
1961
2010
  [P2pEvent_Tags.EndpointError]: "endpointError",
1962
2011
  [P2pEvent_Tags.ReachabilityChanged]: "reachabilityChanged",
1963
2012
  [P2pEvent_Tags.ListenAddressesChanged]: "listenAddressesChanged",