@minip2p/core 0.1.0 → 0.3.0
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 +16 -3
- package/dist/backend.d.ts +53 -6
- package/dist/backend.d.ts.map +1 -1
- package/dist/backend.js +1 -1
- package/dist/backend.js.map +1 -1
- package/dist/errors.d.ts +61 -10
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +89 -11
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/dist/sdk.d.ts +124 -60
- package/dist/sdk.d.ts.map +1 -1
- package/dist/sdk.js +1018 -280
- package/dist/sdk.js.map +1 -1
- package/dist/types.d.ts +368 -231
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +84 -92
- package/dist/types.js.map +1 -1
- package/package.json +3 -2
- package/src/backend.ts +62 -6
- package/src/errors.ts +120 -13
- package/src/index.ts +20 -11
- package/src/sdk.ts +1332 -345
- package/src/types.ts +413 -249
package/README.md
CHANGED
|
@@ -1,9 +1,22 @@
|
|
|
1
1
|
# @minip2p/core
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Promise-first, platform-neutral TypeScript SDK behavior for minip2p.
|
|
4
4
|
|
|
5
|
-
Applications normally install a platform package such as
|
|
5
|
+
Applications normally install a platform package such as `@minip2p/react-native` or `@minip2p/node`; those packages bind the SDK to a native backend and re-export the public core types.
|
|
6
6
|
|
|
7
7
|
Adapter authors implement the deliberately small contract exported from `@minip2p/core/backend`. The core package never imports React Native, Node.js, UniFFI, napi-rs, or generated native code.
|
|
8
8
|
|
|
9
|
-
The
|
|
9
|
+
The public API uses named typed events, cancellable Promise operations, and `Stream` handles:
|
|
10
|
+
|
|
11
|
+
```ts
|
|
12
|
+
const path = await endpoint.connectAddr(remoteAddress);
|
|
13
|
+
await endpoint.waitPeerReady(path.peerId);
|
|
14
|
+
const rttMs = await endpoint.ping(path.peerId);
|
|
15
|
+
const stream = await endpoint.openStream(path.peerId, "/example/files/1");
|
|
16
|
+
stream.write(new Uint8Array([1, 2, 3]));
|
|
17
|
+
stream.closeWrite();
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Use `endpoint.on("stream", handler)` to claim inbound streams. Catch-all event handlers receive only safe `inboundStream` metadata, never a live handle. Operations accept `{ timeoutMs, signal }`; the default timeout is 65 seconds and `timeoutMs: 0` disables it.
|
|
21
|
+
|
|
22
|
+
Raw native `{ tag, inner }` unions and the `Minip2pBackend` adapter contract are available only from `@minip2p/core/backend`.
|
package/dist/backend.d.ts
CHANGED
|
@@ -1,42 +1,89 @@
|
|
|
1
|
-
import type { Bytes, IdentifyInfo, KnownPeerInfo,
|
|
2
|
-
/**
|
|
3
|
-
export interface
|
|
1
|
+
import type { Bytes, IdentifyInfo, KnownPeerInfo, Minip2pConfig, PathKind, P2pEvent, Reachability, RelayReservationInfo } from "./types.js";
|
|
2
|
+
/** Full native identity allocated for an outbound stream. */
|
|
3
|
+
export interface BackendOpenStream {
|
|
4
|
+
/** Endpoint-local connection carrying the stream. */
|
|
5
|
+
readonly connId: number;
|
|
6
|
+
/** Endpoint-local transport stream identifier. */
|
|
7
|
+
readonly streamId: number;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Native endpoint contract consumed by {@link Minip2pBase}.
|
|
11
|
+
*
|
|
12
|
+
* Platform packages implement this interface; application code normally uses
|
|
13
|
+
* the high-level endpoint instead.
|
|
14
|
+
*/
|
|
15
|
+
export interface Minip2pBackend {
|
|
16
|
+
/** Starts native event delivery exactly once. */
|
|
4
17
|
start: (listener: (event: P2pEvent) => void) => void;
|
|
18
|
+
/** Idempotently releases the native endpoint. */
|
|
5
19
|
close: () => void;
|
|
20
|
+
/** Returns the local peer ID. */
|
|
6
21
|
peerId: () => string;
|
|
22
|
+
/** Returns bound peer multiaddresses. */
|
|
7
23
|
listenAddrs: () => string[];
|
|
24
|
+
/** Returns currently connected peer IDs. */
|
|
8
25
|
connectedPeers: () => string[];
|
|
26
|
+
/** Returns whether Identify completed for a peer. */
|
|
9
27
|
isPeerReady: (peerId: string) => boolean;
|
|
28
|
+
/** Returns the latest Identify snapshot. */
|
|
10
29
|
peerInfo: (peerId: string) => IdentifyInfo | undefined;
|
|
30
|
+
/** Returns the merged discovery address book. */
|
|
11
31
|
knownPeers: () => KnownPeerInfo[];
|
|
32
|
+
/** Returns the discovery clock when enabled. */
|
|
12
33
|
discoveryNowMs: () => number | undefined;
|
|
34
|
+
/** Returns the active relay reservation. */
|
|
13
35
|
activeReservation: () => RelayReservationInfo | undefined;
|
|
36
|
+
/** Returns the authoritative native path to a peer. */
|
|
37
|
+
path: (peerId: string) => PathKind | undefined;
|
|
38
|
+
/** Builds a circuit address through a relay. */
|
|
14
39
|
circuitAddress: (relayAddress: string, peerId: string) => string;
|
|
40
|
+
/** Returns the native reachability state. */
|
|
15
41
|
reachability: () => Reachability;
|
|
42
|
+
/** Returns whether the driver accepts work. */
|
|
16
43
|
isRunning: () => boolean;
|
|
44
|
+
/** Selects foreground or idle polling. */
|
|
17
45
|
setActive: (active: boolean) => void;
|
|
46
|
+
/** Subscribes to a pubsub topic. */
|
|
18
47
|
subscribe: (topic: string) => boolean;
|
|
48
|
+
/** Unsubscribes from a pubsub topic. */
|
|
19
49
|
unsubscribe: (topic: string) => boolean;
|
|
50
|
+
/** Publishes one binary pubsub message. */
|
|
20
51
|
publish: (topic: string, data: Uint8Array) => void;
|
|
52
|
+
/** Starts one native ping operation. */
|
|
21
53
|
ping: (peerId: string) => void;
|
|
54
|
+
/** Registers an application protocol. */
|
|
22
55
|
addProtocol: (protocolId: string) => void;
|
|
23
|
-
|
|
56
|
+
/** Starts opening and negotiating an application stream. */
|
|
57
|
+
openStream: (peerId: string, protocolId: string) => BackendOpenStream;
|
|
58
|
+
/** Sends bytes on an application stream. */
|
|
24
59
|
sendStream: (peerId: string, streamId: number, data: Uint8Array) => void;
|
|
60
|
+
/** Half-closes the local stream write side. */
|
|
25
61
|
closeStreamWrite: (peerId: string, streamId: number) => void;
|
|
62
|
+
/** Abruptly resets a stream. */
|
|
26
63
|
resetStream: (peerId: string, streamId: number) => void;
|
|
64
|
+
/** Resets and relinquishes a stream. */
|
|
27
65
|
abandonStream: (peerId: string, streamId: number) => void;
|
|
66
|
+
/** Starts a NAT-orchestrated connection attempt. */
|
|
28
67
|
connect: (peerId: string) => number;
|
|
68
|
+
/** Starts a connection attempt with explicit addresses. */
|
|
29
69
|
connectWithAddrs: (peerId: string, addresses: readonly string[]) => number;
|
|
70
|
+
/** Starts a connection attempt from one full peer address. */
|
|
30
71
|
connectAddr: (address: string) => number;
|
|
72
|
+
/** Starts direct dials for applicable address families. */
|
|
31
73
|
dial: (address: string) => number[];
|
|
74
|
+
/** Starts one direct IPv4 dial. */
|
|
32
75
|
dialIp4: (address: string) => number;
|
|
76
|
+
/** Starts one direct IPv6 dial. */
|
|
33
77
|
dialIp6: (address: string) => number;
|
|
78
|
+
/** Cancels a connection attempt. */
|
|
34
79
|
cancelConnect: (id: number) => void;
|
|
80
|
+
/** Closes the active connection to a peer. */
|
|
35
81
|
disconnect: (peerId: string) => void;
|
|
36
82
|
}
|
|
83
|
+
export { P2pEvent_Tags, PathKind_Tags, type P2pEvent, type P2pEventByTag, type PathKind, } from "./types.js";
|
|
37
84
|
/** Platform implementation used to construct endpoints and identity helpers. */
|
|
38
|
-
export interface
|
|
39
|
-
create: (config:
|
|
85
|
+
export interface Minip2pBackendFactory {
|
|
86
|
+
create: (config: Minip2pConfig) => Minip2pBackend;
|
|
40
87
|
generateSecretKey: () => Uint8Array;
|
|
41
88
|
peerIdFromSecretKey: (secretKey: Bytes) => string;
|
|
42
89
|
circuitAddress: (relayAddress: string, peerId: string) => string;
|
package/dist/backend.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,
|
|
1
|
+
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}
|
package/dist/backend.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export {};
|
|
1
|
+
export { P2pEvent_Tags, PathKind_Tags, } from "./types.js";
|
|
2
2
|
//# sourceMappingURL=backend.js.map
|
package/dist/backend.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":""}
|
|
1
|
+
{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AA8FA,OAAO,EACL,aAAa,EACb,aAAa,GAId,MAAM,YAAY,CAAC"}
|
package/dist/errors.d.ts
CHANGED
|
@@ -1,32 +1,83 @@
|
|
|
1
|
-
import type { DriverFailureKind } from "./types.js";
|
|
2
|
-
/**
|
|
1
|
+
import type { DriverFailureKind, EndpointErrorKind, NatErrorKind } from "./types.js";
|
|
2
|
+
/** Pubsub rejected a publish because its bounded native queue is full. */
|
|
3
3
|
export declare class BackpressureError extends Error {
|
|
4
4
|
constructor();
|
|
5
5
|
}
|
|
6
|
-
/**
|
|
6
|
+
/** A payload exceeds the native protocol size limit. */
|
|
7
7
|
export declare class MessageTooLargeError extends Error {
|
|
8
8
|
constructor();
|
|
9
9
|
}
|
|
10
|
-
/**
|
|
10
|
+
/** Native policy rejected an otherwise valid operation. */
|
|
11
11
|
export declare class NotPermittedError extends Error {
|
|
12
12
|
constructor(message?: string);
|
|
13
13
|
}
|
|
14
|
-
/**
|
|
14
|
+
/** Platform-neutral operation cancellation error. */
|
|
15
|
+
export declare class AbortError extends Error {
|
|
16
|
+
constructor(message?: string);
|
|
17
|
+
}
|
|
18
|
+
/** A Promise-based SDK operation exceeded its configured timeout. */
|
|
15
19
|
export declare class TimeoutError extends Error {
|
|
16
|
-
|
|
20
|
+
/** Configured timeout in milliseconds, when known. */
|
|
21
|
+
readonly timeoutMs?: number;
|
|
22
|
+
constructor(timeoutMs?: number);
|
|
17
23
|
}
|
|
18
|
-
/** The
|
|
24
|
+
/** The endpoint or stream is already closed. */
|
|
19
25
|
export declare class ClosedError extends Error {
|
|
20
26
|
constructor();
|
|
21
27
|
}
|
|
22
|
-
/** The native background driver
|
|
28
|
+
/** The native background driver stopped unexpectedly. */
|
|
23
29
|
export declare class DriverFailedError extends Error {
|
|
30
|
+
/** Native subsystem that caused the terminal failure. */
|
|
24
31
|
readonly kind: DriverFailureKind;
|
|
25
32
|
constructor(kind: DriverFailureKind, detail: string);
|
|
26
33
|
}
|
|
27
|
-
/** A
|
|
34
|
+
/** A NAT-orchestrated connection attempt ended without a usable path. */
|
|
35
|
+
export declare class ConnectFailedError extends Error {
|
|
36
|
+
/** Endpoint-local connection-attempt identifier. */
|
|
37
|
+
readonly connectId: number;
|
|
38
|
+
/** Target peer ID. */
|
|
39
|
+
readonly peerId: string;
|
|
40
|
+
/** Machine-readable terminal failure category. */
|
|
41
|
+
readonly kind: NatErrorKind;
|
|
42
|
+
constructor(connectId: number, peerId: string, kind: NatErrorKind, detail: string);
|
|
43
|
+
}
|
|
44
|
+
/** A connection result is unknown, already awaited, or already consumed. */
|
|
45
|
+
export declare class ConnectResultUnavailableError extends Error {
|
|
46
|
+
readonly connectId: number;
|
|
47
|
+
constructor(connectId: number);
|
|
48
|
+
}
|
|
49
|
+
/** A peer disconnected before an operation could complete. */
|
|
28
50
|
export declare class PeerDisconnectedError extends Error {
|
|
29
51
|
readonly peerId: string;
|
|
30
|
-
|
|
52
|
+
readonly operation?: string;
|
|
53
|
+
constructor(peerId: string, operation?: string);
|
|
54
|
+
}
|
|
55
|
+
/** Outbound stream opening or protocol negotiation failed. */
|
|
56
|
+
export declare class OpenStreamError extends Error {
|
|
57
|
+
/** Machine-readable native error category, or a synchronous adapter error. */
|
|
58
|
+
readonly kind: EndpointErrorKind | "synchronous";
|
|
59
|
+
/** Target peer ID. */
|
|
60
|
+
readonly peerId: string;
|
|
61
|
+
/** Connection carrying the attempted stream, when allocated. */
|
|
62
|
+
readonly connId?: number;
|
|
63
|
+
/** Native stream identifier, when allocated. */
|
|
64
|
+
readonly streamId?: number;
|
|
65
|
+
/** Human-readable native or adapter diagnostic. */
|
|
66
|
+
readonly detail: string;
|
|
67
|
+
constructor(options: {
|
|
68
|
+
kind: EndpointErrorKind | "synchronous";
|
|
69
|
+
peerId: string;
|
|
70
|
+
connId?: number;
|
|
71
|
+
streamId?: number;
|
|
72
|
+
detail: string;
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
/** A stream closed before outbound negotiation completed. */
|
|
76
|
+
export declare class StreamClosedError extends Error {
|
|
77
|
+
constructor(message?: string);
|
|
78
|
+
}
|
|
79
|
+
/** Native event loss made an in-flight operation's result unknowable. */
|
|
80
|
+
export declare class EventQueueOverflowError extends Error {
|
|
81
|
+
constructor();
|
|
31
82
|
}
|
|
32
83
|
//# sourceMappingURL=errors.d.ts.map
|
package/dist/errors.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,qBAAa,iBAAkB,SAAQ,KAAK;;CAK3C;AAED,wDAAwD;AACxD,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED,2DAA2D;AAC3D,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAmC;CAIvD;AAED,qDAAqD;AACrD,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,SAA8B;CAIlD;AAED,qEAAqE;AACrE,qBAAa,YAAa,SAAQ,KAAK;IACrC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,SAAS,CAAC,EAAE,MAAM;CAS/B;AAED,gDAAgD;AAChD,qBAAa,WAAY,SAAQ,KAAK;;CAKrC;AAED,yDAAyD;AACzD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM;CAKpD;AAED,yEAAyE;AACzE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAG1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM;CAQjB;AAED,4EAA4E;AAC5E,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B;AAED,8DAA8D;AAC9D,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAU/C;AAED,8DAA8D;AAC9D,qBAAa,eAAgB,SAAQ,KAAK;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IACjD,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE;QACnB,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;QACxC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;CASF;AAED,6DAA6D;AAC7D,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAA6C;CAIjE;AAED,yEAAyE;AACzE,qBAAa,uBAAwB,SAAQ,KAAK;;CAKjD"}
|
package/dist/errors.js
CHANGED
|
@@ -1,41 +1,54 @@
|
|
|
1
|
-
/* oxlint-disable max-classes-per-file --
|
|
2
|
-
/**
|
|
1
|
+
/* oxlint-disable max-classes-per-file -- Public error types are intentionally colocated. */
|
|
2
|
+
/** Pubsub rejected a publish because its bounded native queue is full. */
|
|
3
3
|
export class BackpressureError extends Error {
|
|
4
4
|
constructor() {
|
|
5
5
|
super("The native pubsub queue is full");
|
|
6
6
|
this.name = "BackpressureError";
|
|
7
7
|
}
|
|
8
8
|
}
|
|
9
|
-
/**
|
|
9
|
+
/** A payload exceeds the native protocol size limit. */
|
|
10
10
|
export class MessageTooLargeError extends Error {
|
|
11
11
|
constructor() {
|
|
12
12
|
super("The message exceeds the native pubsub size limit");
|
|
13
13
|
this.name = "MessageTooLargeError";
|
|
14
14
|
}
|
|
15
15
|
}
|
|
16
|
-
/**
|
|
16
|
+
/** Native policy rejected an otherwise valid operation. */
|
|
17
17
|
export class NotPermittedError extends Error {
|
|
18
18
|
constructor(message = "The operation is not permitted") {
|
|
19
19
|
super(message);
|
|
20
20
|
this.name = "NotPermittedError";
|
|
21
21
|
}
|
|
22
22
|
}
|
|
23
|
-
/**
|
|
23
|
+
/** Platform-neutral operation cancellation error. */
|
|
24
|
+
export class AbortError extends Error {
|
|
25
|
+
constructor(message = "The operation was aborted") {
|
|
26
|
+
super(message);
|
|
27
|
+
this.name = "AbortError";
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
/** A Promise-based SDK operation exceeded its configured timeout. */
|
|
24
31
|
export class TimeoutError extends Error {
|
|
32
|
+
/** Configured timeout in milliseconds, when known. */
|
|
33
|
+
timeoutMs;
|
|
25
34
|
constructor(timeoutMs) {
|
|
26
|
-
super(
|
|
35
|
+
super(timeoutMs === undefined
|
|
36
|
+
? "The operation timed out"
|
|
37
|
+
: `Timed out after ${timeoutMs} ms`);
|
|
27
38
|
this.name = "TimeoutError";
|
|
39
|
+
this.timeoutMs = timeoutMs;
|
|
28
40
|
}
|
|
29
41
|
}
|
|
30
|
-
/** The
|
|
42
|
+
/** The endpoint or stream is already closed. */
|
|
31
43
|
export class ClosedError extends Error {
|
|
32
44
|
constructor() {
|
|
33
45
|
super("The minip2p endpoint is closed");
|
|
34
46
|
this.name = "ClosedError";
|
|
35
47
|
}
|
|
36
48
|
}
|
|
37
|
-
/** The native background driver
|
|
49
|
+
/** The native background driver stopped unexpectedly. */
|
|
38
50
|
export class DriverFailedError extends Error {
|
|
51
|
+
/** Native subsystem that caused the terminal failure. */
|
|
39
52
|
kind;
|
|
40
53
|
constructor(kind, detail) {
|
|
41
54
|
super(detail.length > 0 ? detail : "The minip2p driver failed");
|
|
@@ -43,13 +56,78 @@ export class DriverFailedError extends Error {
|
|
|
43
56
|
this.kind = kind;
|
|
44
57
|
}
|
|
45
58
|
}
|
|
46
|
-
/** A
|
|
59
|
+
/** A NAT-orchestrated connection attempt ended without a usable path. */
|
|
60
|
+
export class ConnectFailedError extends Error {
|
|
61
|
+
/** Endpoint-local connection-attempt identifier. */
|
|
62
|
+
connectId;
|
|
63
|
+
/** Target peer ID. */
|
|
64
|
+
peerId;
|
|
65
|
+
/** Machine-readable terminal failure category. */
|
|
66
|
+
kind;
|
|
67
|
+
constructor(connectId, peerId, kind, detail) {
|
|
68
|
+
super(detail.length > 0 ? detail : `Connection to ${peerId} failed`);
|
|
69
|
+
this.name = "ConnectFailedError";
|
|
70
|
+
this.connectId = connectId;
|
|
71
|
+
this.peerId = peerId;
|
|
72
|
+
this.kind = kind;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
/** A connection result is unknown, already awaited, or already consumed. */
|
|
76
|
+
export class ConnectResultUnavailableError extends Error {
|
|
77
|
+
connectId;
|
|
78
|
+
constructor(connectId) {
|
|
79
|
+
super(`Connection result ${connectId} is unknown or already consumed`);
|
|
80
|
+
this.name = "ConnectResultUnavailableError";
|
|
81
|
+
this.connectId = connectId;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
/** A peer disconnected before an operation could complete. */
|
|
47
85
|
export class PeerDisconnectedError extends Error {
|
|
48
86
|
peerId;
|
|
49
|
-
|
|
50
|
-
|
|
87
|
+
operation;
|
|
88
|
+
constructor(peerId, operation) {
|
|
89
|
+
super(operation === undefined
|
|
90
|
+
? `Peer ${peerId} disconnected`
|
|
91
|
+
: `Peer ${peerId} disconnected during ${operation}`);
|
|
51
92
|
this.name = "PeerDisconnectedError";
|
|
52
93
|
this.peerId = peerId;
|
|
94
|
+
this.operation = operation;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
/** Outbound stream opening or protocol negotiation failed. */
|
|
98
|
+
export class OpenStreamError extends Error {
|
|
99
|
+
/** Machine-readable native error category, or a synchronous adapter error. */
|
|
100
|
+
kind;
|
|
101
|
+
/** Target peer ID. */
|
|
102
|
+
peerId;
|
|
103
|
+
/** Connection carrying the attempted stream, when allocated. */
|
|
104
|
+
connId;
|
|
105
|
+
/** Native stream identifier, when allocated. */
|
|
106
|
+
streamId;
|
|
107
|
+
/** Human-readable native or adapter diagnostic. */
|
|
108
|
+
detail;
|
|
109
|
+
constructor(options) {
|
|
110
|
+
super(options.detail || `Opening a stream to ${options.peerId} failed`);
|
|
111
|
+
this.name = "OpenStreamError";
|
|
112
|
+
this.kind = options.kind;
|
|
113
|
+
this.peerId = options.peerId;
|
|
114
|
+
this.connId = options.connId;
|
|
115
|
+
this.streamId = options.streamId;
|
|
116
|
+
this.detail = options.detail;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
/** A stream closed before outbound negotiation completed. */
|
|
120
|
+
export class StreamClosedError extends Error {
|
|
121
|
+
constructor(message = "The stream closed before it became ready") {
|
|
122
|
+
super(message);
|
|
123
|
+
this.name = "StreamClosedError";
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
/** Native event loss made an in-flight operation's result unknowable. */
|
|
127
|
+
export class EventQueueOverflowError extends Error {
|
|
128
|
+
constructor() {
|
|
129
|
+
super("The native event queue overflowed before the operation completed");
|
|
130
|
+
this.name = "EventQueueOverflowError";
|
|
53
131
|
}
|
|
54
132
|
}
|
|
55
133
|
//# sourceMappingURL=errors.js.map
|
package/dist/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,
|
|
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 { BackpressureError, ClosedError, DriverFailedError, MessageTooLargeError, NotPermittedError, PeerDisconnectedError, TimeoutError, } from "./errors.js";
|
|
2
|
-
export {
|
|
3
|
-
export { DiscoverySource, DriverFailureKind, EndpointErrorKind, NatErrorKind,
|
|
1
|
+
export { AbortError, BackpressureError, ClosedError, ConnectFailedError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, MessageTooLargeError, NotPermittedError, OpenStreamError, PeerDisconnectedError, StreamClosedError, TimeoutError, } from "./errors.js";
|
|
2
|
+
export { Minip2pBase, Stream, type StreamEventMap } from "./sdk.js";
|
|
3
|
+
export { DiscoverySource, DriverFailureKind, EndpointErrorKind, NatErrorKind, PubsubRouter, Reachability, type Bytes, type CloseReason, type ConnectResult, type IdentifyInfo, type InboundStreamMeta, type KnownPeerInfo, type Minip2pCatchAllEventMap, type Minip2pConfig, type Minip2pDiscoveryOptions, type Minip2pEvent, type Minip2pMdnsOptions, type Minip2pNamedEventMap, type OnceOptions, type OpOptions, type Path, type RelayReservationInfo, type Unsubscribe, type WaitForOptions, } from "./types.js";
|
|
4
4
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,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 { BackpressureError, ClosedError, DriverFailedError, MessageTooLargeError, NotPermittedError, PeerDisconnectedError, TimeoutError, } from "./errors.js";
|
|
2
|
-
export {
|
|
3
|
-
export { DiscoverySource, DriverFailureKind, EndpointErrorKind, NatErrorKind,
|
|
1
|
+
export { AbortError, BackpressureError, ClosedError, ConnectFailedError, ConnectResultUnavailableError, DriverFailedError, EventQueueOverflowError, MessageTooLargeError, NotPermittedError, OpenStreamError, PeerDisconnectedError, StreamClosedError, TimeoutError, } from "./errors.js";
|
|
2
|
+
export { Minip2pBase, Stream } from "./sdk.js";
|
|
3
|
+
export { DiscoverySource, DriverFailureKind, EndpointErrorKind, NatErrorKind, PubsubRouter, 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,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAuB,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,YAAY,GAmBb,MAAM,YAAY,CAAC"}
|