@libp2p/utils 6.7.1 → 6.7.2-8484de8a2
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 -1
- package/dist/index.min.js +6 -1
- package/dist/index.min.js.map +4 -4
- package/dist/src/abstract-message-stream.d.ts +129 -0
- package/dist/src/abstract-message-stream.d.ts.map +1 -0
- package/dist/src/abstract-message-stream.js +389 -0
- package/dist/src/abstract-message-stream.js.map +1 -0
- package/dist/src/abstract-multiaddr-connection.d.ts +26 -0
- package/dist/src/abstract-multiaddr-connection.d.ts.map +1 -0
- package/dist/src/abstract-multiaddr-connection.js +66 -0
- package/dist/src/abstract-multiaddr-connection.js.map +1 -0
- package/dist/src/abstract-stream-muxer.d.ts +53 -0
- package/dist/src/abstract-stream-muxer.d.ts.map +1 -0
- package/dist/src/abstract-stream-muxer.js +169 -0
- package/dist/src/abstract-stream-muxer.js.map +1 -0
- package/dist/src/abstract-stream.d.ts +14 -130
- package/dist/src/abstract-stream.d.ts.map +1 -1
- package/dist/src/abstract-stream.js +39 -321
- package/dist/src/abstract-stream.js.map +1 -1
- package/dist/src/errors.d.ts +8 -0
- package/dist/src/errors.d.ts.map +1 -1
- package/dist/src/errors.js +8 -0
- package/dist/src/errors.js.map +1 -1
- package/dist/src/get-thin-waist-addresses.browser.d.ts +1 -1
- package/dist/src/get-thin-waist-addresses.browser.d.ts.map +1 -1
- package/dist/src/get-thin-waist-addresses.browser.js +4 -3
- package/dist/src/get-thin-waist-addresses.browser.js.map +1 -1
- package/dist/src/get-thin-waist-addresses.d.ts +1 -1
- package/dist/src/get-thin-waist-addresses.d.ts.map +1 -1
- package/dist/src/get-thin-waist-addresses.js +7 -9
- package/dist/src/get-thin-waist-addresses.js.map +1 -1
- package/dist/src/index.d.ts +33 -1
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +33 -1
- package/dist/src/index.js.map +1 -1
- package/dist/src/length-prefixed-decoder.d.ts +37 -0
- package/dist/src/length-prefixed-decoder.d.ts.map +1 -0
- package/dist/src/length-prefixed-decoder.js +64 -0
- package/dist/src/length-prefixed-decoder.js.map +1 -0
- package/dist/src/message-queue.d.ts +61 -0
- package/dist/src/message-queue.d.ts.map +1 -0
- package/dist/src/message-queue.js +93 -0
- package/dist/src/message-queue.js.map +1 -0
- package/dist/src/mock-muxer.d.ts +57 -0
- package/dist/src/mock-muxer.d.ts.map +1 -0
- package/dist/src/mock-muxer.js +204 -0
- package/dist/src/mock-muxer.js.map +1 -0
- package/dist/src/mock-stream.d.ts +31 -0
- package/dist/src/mock-stream.d.ts.map +1 -0
- package/dist/src/mock-stream.js +69 -0
- package/dist/src/mock-stream.js.map +1 -0
- package/dist/src/multiaddr/get-net-config.d.ts +55 -0
- package/dist/src/multiaddr/get-net-config.d.ts.map +1 -0
- package/dist/src/multiaddr/get-net-config.js +54 -0
- package/dist/src/multiaddr/get-net-config.js.map +1 -0
- package/dist/src/multiaddr/index.d.ts +7 -0
- package/dist/src/multiaddr/index.d.ts.map +1 -0
- package/dist/src/multiaddr/index.js +7 -0
- package/dist/src/multiaddr/index.js.map +1 -0
- package/dist/src/multiaddr/is-global-unicast.d.ts.map +1 -1
- package/dist/src/multiaddr/is-global-unicast.js +8 -9
- package/dist/src/multiaddr/is-global-unicast.js.map +1 -1
- package/dist/src/multiaddr/is-link-local.d.ts.map +1 -1
- package/dist/src/multiaddr/is-link-local.js +11 -16
- package/dist/src/multiaddr/is-link-local.js.map +1 -1
- package/dist/src/multiaddr/is-loopback.d.ts.map +1 -1
- package/dist/src/multiaddr/is-loopback.js +12 -5
- package/dist/src/multiaddr/is-loopback.js.map +1 -1
- package/dist/src/multiaddr/is-network-address.d.ts.map +1 -1
- package/dist/src/multiaddr/is-network-address.js +4 -16
- package/dist/src/multiaddr/is-network-address.js.map +1 -1
- package/dist/src/multiaddr/is-private.d.ts.map +1 -1
- package/dist/src/multiaddr/is-private.js +9 -10
- package/dist/src/multiaddr/is-private.js.map +1 -1
- package/dist/src/multiaddr/utils.d.ts +5 -0
- package/dist/src/multiaddr/utils.d.ts.map +1 -0
- package/dist/src/multiaddr/utils.js +32 -0
- package/dist/src/multiaddr/utils.js.map +1 -0
- package/dist/src/multiaddr-connection-pair.d.ts +25 -0
- package/dist/src/multiaddr-connection-pair.d.ts.map +1 -0
- package/dist/src/multiaddr-connection-pair.js +103 -0
- package/dist/src/multiaddr-connection-pair.js.map +1 -0
- package/dist/src/queue/index.d.ts +5 -0
- package/dist/src/queue/index.d.ts.map +1 -1
- package/dist/src/queue/index.js +24 -9
- package/dist/src/queue/index.js.map +1 -1
- package/dist/src/rate-limiter.d.ts +1 -15
- package/dist/src/rate-limiter.d.ts.map +1 -1
- package/dist/src/rate-limiter.js +1 -14
- package/dist/src/rate-limiter.js.map +1 -1
- package/dist/src/socket-writer.browser.d.ts +2 -0
- package/dist/src/socket-writer.browser.d.ts.map +1 -0
- package/dist/src/socket-writer.browser.js +4 -0
- package/dist/src/socket-writer.browser.js.map +1 -0
- package/dist/src/socket-writer.d.ts +19 -0
- package/dist/src/socket-writer.d.ts.map +1 -0
- package/dist/src/socket-writer.js +43 -0
- package/dist/src/socket-writer.js.map +1 -0
- package/dist/src/stream-pair.d.ts +42 -0
- package/dist/src/stream-pair.d.ts.map +1 -0
- package/dist/src/stream-pair.js +40 -0
- package/dist/src/stream-pair.js.map +1 -0
- package/dist/src/stream-utils.d.ts +198 -0
- package/dist/src/stream-utils.d.ts.map +1 -0
- package/dist/src/stream-utils.js +369 -0
- package/dist/src/stream-utils.js.map +1 -0
- package/package.json +19 -163
- package/src/abstract-message-stream.ts +549 -0
- package/src/abstract-multiaddr-connection.ts +93 -0
- package/src/abstract-stream-muxer.ts +239 -0
- package/src/abstract-stream.ts +51 -464
- package/src/errors.ts +10 -0
- package/src/get-thin-waist-addresses.browser.ts +5 -4
- package/src/get-thin-waist-addresses.ts +8 -12
- package/src/index.ts +33 -1
- package/src/length-prefixed-decoder.ts +98 -0
- package/src/message-queue.ts +156 -0
- package/src/mock-muxer.ts +304 -0
- package/src/mock-stream.ts +101 -0
- package/src/multiaddr/get-net-config.ts +112 -0
- package/src/multiaddr/index.ts +6 -0
- package/src/multiaddr/is-global-unicast.ts +8 -11
- package/src/multiaddr/is-link-local.ts +11 -20
- package/src/multiaddr/is-loopback.ts +12 -7
- package/src/multiaddr/is-network-address.ts +4 -19
- package/src/multiaddr/is-private.ts +9 -14
- package/src/multiaddr/utils.ts +46 -0
- package/src/multiaddr-connection-pair.ts +147 -0
- package/src/queue/index.ts +30 -9
- package/src/rate-limiter.ts +3 -30
- package/src/socket-writer.browser.ts +3 -0
- package/src/socket-writer.ts +64 -0
- package/src/stream-pair.ts +90 -0
- package/src/stream-utils.ts +873 -0
- package/dist/src/abort-options.d.ts +0 -7
- package/dist/src/abort-options.d.ts.map +0 -1
- package/dist/src/abort-options.js +0 -14
- package/dist/src/abort-options.js.map +0 -1
- package/dist/src/array-equals.d.ts +0 -24
- package/dist/src/array-equals.d.ts.map +0 -1
- package/dist/src/array-equals.js +0 -31
- package/dist/src/array-equals.js.map +0 -1
- package/dist/src/close-source.d.ts +0 -4
- package/dist/src/close-source.d.ts.map +0 -1
- package/dist/src/close-source.js +0 -11
- package/dist/src/close-source.js.map +0 -1
- package/dist/src/close.d.ts +0 -21
- package/dist/src/close.d.ts.map +0 -1
- package/dist/src/close.js +0 -49
- package/dist/src/close.js.map +0 -1
- package/dist/src/multiaddr/is-ip-based.d.ts +0 -6
- package/dist/src/multiaddr/is-ip-based.d.ts.map +0 -1
- package/dist/src/multiaddr/is-ip-based.js +0 -18
- package/dist/src/multiaddr/is-ip-based.js.map +0 -1
- package/dist/src/stream-to-ma-conn.d.ts +0 -23
- package/dist/src/stream-to-ma-conn.d.ts.map +0 -1
- package/dist/src/stream-to-ma-conn.js +0 -75
- package/dist/src/stream-to-ma-conn.js.map +0 -1
- package/dist/typedoc-urls.json +0 -147
- package/src/abort-options.ts +0 -20
- package/src/array-equals.ts +0 -34
- package/src/close-source.ts +0 -14
- package/src/close.ts +0 -65
- package/src/multiaddr/is-ip-based.ts +0 -21
- package/src/stream-to-ma-conn.ts +0 -105
package/src/close.ts
DELETED
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
import type { Connection, Stream, AbortOptions } from '@libp2p/interface'
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Close the passed stream, falling back to aborting the stream if closing
|
|
5
|
-
* cleanly fails.
|
|
6
|
-
*/
|
|
7
|
-
export async function safelyCloseStream (stream?: Stream, options?: AbortOptions): Promise<void> {
|
|
8
|
-
try {
|
|
9
|
-
await stream?.close(options)
|
|
10
|
-
} catch (err: any) {
|
|
11
|
-
stream?.abort(err)
|
|
12
|
-
}
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* These are speculative protocols that are run automatically on connection open
|
|
17
|
-
* so are usually not the reason the connection was opened.
|
|
18
|
-
*
|
|
19
|
-
* Consequently when requested it should be safe to close connections that only
|
|
20
|
-
* have these protocol streams open.
|
|
21
|
-
*/
|
|
22
|
-
const DEFAULT_CLOSABLE_PROTOCOLS = [
|
|
23
|
-
// identify
|
|
24
|
-
'/ipfs/id/1.0.0',
|
|
25
|
-
|
|
26
|
-
// identify-push
|
|
27
|
-
'/ipfs/id/push/1.0.0',
|
|
28
|
-
|
|
29
|
-
// autonat
|
|
30
|
-
'/libp2p/autonat/1.0.0',
|
|
31
|
-
|
|
32
|
-
// dcutr
|
|
33
|
-
'/libp2p/dcutr'
|
|
34
|
-
]
|
|
35
|
-
|
|
36
|
-
export interface SafelyCloseConnectionOptions extends AbortOptions {
|
|
37
|
-
/**
|
|
38
|
-
* Only close the stream if it either has no protocol streams open or only
|
|
39
|
-
* ones in this list.
|
|
40
|
-
*
|
|
41
|
-
* @default ['/ipfs/id/1.0.0']
|
|
42
|
-
*/
|
|
43
|
-
closableProtocols?: string[]
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
/**
|
|
47
|
-
* Close the passed connection if it has no streams, or only closable protocol
|
|
48
|
-
* streams, falling back to aborting the connection if closing it cleanly fails.
|
|
49
|
-
*/
|
|
50
|
-
export async function safelyCloseConnectionIfUnused (connection?: Connection, options?: SafelyCloseConnectionOptions): Promise<void> {
|
|
51
|
-
const streamProtocols = connection?.streams?.map(stream => stream.protocol) ?? []
|
|
52
|
-
const closableProtocols = options?.closableProtocols ?? DEFAULT_CLOSABLE_PROTOCOLS
|
|
53
|
-
|
|
54
|
-
// if the connection has protocols not in the closable protocols list, do not
|
|
55
|
-
// close the connection
|
|
56
|
-
if (streamProtocols.filter(proto => proto != null && !closableProtocols.includes(proto)).length > 0) {
|
|
57
|
-
return
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
try {
|
|
61
|
-
await connection?.close(options)
|
|
62
|
-
} catch (err: any) {
|
|
63
|
-
connection?.abort(err)
|
|
64
|
-
}
|
|
65
|
-
}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
import { CODE_IP4, CODE_IP6, CODE_IP6ZONE } from '@multiformats/multiaddr'
|
|
2
|
-
import type { Multiaddr } from '@multiformats/multiaddr'
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* Check if a given multiaddr is IP-based
|
|
6
|
-
*/
|
|
7
|
-
export function isIpBased (ma: Multiaddr): boolean {
|
|
8
|
-
try {
|
|
9
|
-
for (const { code } of ma.getComponents()) {
|
|
10
|
-
if (code === CODE_IP6ZONE) {
|
|
11
|
-
continue
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
return code === CODE_IP4 || code === CODE_IP6
|
|
15
|
-
}
|
|
16
|
-
} catch {
|
|
17
|
-
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
return false
|
|
21
|
-
}
|
package/src/stream-to-ma-conn.ts
DELETED
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
import forEach from 'it-foreach'
|
|
2
|
-
import { pipe } from 'it-pipe'
|
|
3
|
-
import type { ComponentLogger, MultiaddrConnection, Stream } from '@libp2p/interface'
|
|
4
|
-
import type { Multiaddr } from '@multiformats/multiaddr'
|
|
5
|
-
import type { Uint8ArrayList } from 'uint8arraylist'
|
|
6
|
-
|
|
7
|
-
export interface StreamProperties {
|
|
8
|
-
stream: Stream
|
|
9
|
-
remoteAddr: Multiaddr
|
|
10
|
-
localAddr: Multiaddr
|
|
11
|
-
logger: ComponentLogger
|
|
12
|
-
|
|
13
|
-
/**
|
|
14
|
-
* A callback invoked when data is read from the stream
|
|
15
|
-
*/
|
|
16
|
-
onDataRead?(buf: Uint8ArrayList | Uint8Array): void
|
|
17
|
-
|
|
18
|
-
/**
|
|
19
|
-
* A callback invoked when data is written to the stream
|
|
20
|
-
*/
|
|
21
|
-
onDataWrite?(buf: Uint8ArrayList | Uint8Array): void
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
/**
|
|
25
|
-
* Convert a duplex iterable into a MultiaddrConnection.
|
|
26
|
-
* https://github.com/libp2p/interface-transport#multiaddrconnection
|
|
27
|
-
*/
|
|
28
|
-
export function streamToMaConnection (props: StreamProperties): MultiaddrConnection {
|
|
29
|
-
const { stream, remoteAddr, logger, onDataRead, onDataWrite } = props
|
|
30
|
-
const log = logger.forComponent('libp2p:stream:converter')
|
|
31
|
-
|
|
32
|
-
let closedRead = false
|
|
33
|
-
let closedWrite = false
|
|
34
|
-
|
|
35
|
-
// piggyback on `stream.close` invocations to close multiaddr connection
|
|
36
|
-
const streamClose = stream.close.bind(stream)
|
|
37
|
-
stream.close = async (options): Promise<void> => {
|
|
38
|
-
await streamClose(options)
|
|
39
|
-
close(true)
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
// piggyback on `stream.abort` invocations to close multiaddr connection
|
|
43
|
-
const streamAbort = stream.abort.bind(stream)
|
|
44
|
-
stream.abort = (err): void => {
|
|
45
|
-
streamAbort(err)
|
|
46
|
-
close(true)
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
// piggyback on `stream.sink` invocations to close multiaddr connection
|
|
50
|
-
const streamSink = stream.sink.bind(stream)
|
|
51
|
-
stream.sink = async (source): Promise<void> => {
|
|
52
|
-
try {
|
|
53
|
-
await streamSink(
|
|
54
|
-
pipe(
|
|
55
|
-
source,
|
|
56
|
-
(source) => forEach(source, buf => onDataWrite?.(buf))
|
|
57
|
-
)
|
|
58
|
-
)
|
|
59
|
-
} catch (err: any) {
|
|
60
|
-
// If aborted we can safely ignore
|
|
61
|
-
if (err.type !== 'aborted') {
|
|
62
|
-
// If the source errored the socket will already have been destroyed by
|
|
63
|
-
// toIterable.duplex(). If the socket errored it will already be
|
|
64
|
-
// destroyed. There's nothing to do here except log the error & return.
|
|
65
|
-
log.error('%s error in sink', remoteAddr, err)
|
|
66
|
-
}
|
|
67
|
-
} finally {
|
|
68
|
-
closedWrite = true
|
|
69
|
-
close()
|
|
70
|
-
}
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
const maConn: MultiaddrConnection = {
|
|
74
|
-
log,
|
|
75
|
-
sink: stream.sink,
|
|
76
|
-
source: (async function * (): AsyncGenerator<Uint8ArrayList> {
|
|
77
|
-
try {
|
|
78
|
-
for await (const buf of stream.source) {
|
|
79
|
-
onDataRead?.(buf)
|
|
80
|
-
yield buf
|
|
81
|
-
}
|
|
82
|
-
} finally {
|
|
83
|
-
closedRead = true
|
|
84
|
-
close()
|
|
85
|
-
}
|
|
86
|
-
}()),
|
|
87
|
-
remoteAddr,
|
|
88
|
-
timeline: { open: Date.now(), close: undefined },
|
|
89
|
-
close: stream.close,
|
|
90
|
-
abort: stream.abort
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
function close (force?: boolean): void {
|
|
94
|
-
if (force === true) {
|
|
95
|
-
closedRead = true
|
|
96
|
-
closedWrite = true
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
if (closedRead && closedWrite && maConn.timeline.close == null) {
|
|
100
|
-
maConn.timeline.close = Date.now()
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
return maConn
|
|
105
|
-
}
|