@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.
Files changed (165) hide show
  1. package/README.md +16 -1
  2. package/dist/index.min.js +6 -1
  3. package/dist/index.min.js.map +4 -4
  4. package/dist/src/abstract-message-stream.d.ts +129 -0
  5. package/dist/src/abstract-message-stream.d.ts.map +1 -0
  6. package/dist/src/abstract-message-stream.js +389 -0
  7. package/dist/src/abstract-message-stream.js.map +1 -0
  8. package/dist/src/abstract-multiaddr-connection.d.ts +26 -0
  9. package/dist/src/abstract-multiaddr-connection.d.ts.map +1 -0
  10. package/dist/src/abstract-multiaddr-connection.js +66 -0
  11. package/dist/src/abstract-multiaddr-connection.js.map +1 -0
  12. package/dist/src/abstract-stream-muxer.d.ts +53 -0
  13. package/dist/src/abstract-stream-muxer.d.ts.map +1 -0
  14. package/dist/src/abstract-stream-muxer.js +169 -0
  15. package/dist/src/abstract-stream-muxer.js.map +1 -0
  16. package/dist/src/abstract-stream.d.ts +14 -130
  17. package/dist/src/abstract-stream.d.ts.map +1 -1
  18. package/dist/src/abstract-stream.js +39 -321
  19. package/dist/src/abstract-stream.js.map +1 -1
  20. package/dist/src/errors.d.ts +8 -0
  21. package/dist/src/errors.d.ts.map +1 -1
  22. package/dist/src/errors.js +8 -0
  23. package/dist/src/errors.js.map +1 -1
  24. package/dist/src/get-thin-waist-addresses.browser.d.ts +1 -1
  25. package/dist/src/get-thin-waist-addresses.browser.d.ts.map +1 -1
  26. package/dist/src/get-thin-waist-addresses.browser.js +4 -3
  27. package/dist/src/get-thin-waist-addresses.browser.js.map +1 -1
  28. package/dist/src/get-thin-waist-addresses.d.ts +1 -1
  29. package/dist/src/get-thin-waist-addresses.d.ts.map +1 -1
  30. package/dist/src/get-thin-waist-addresses.js +7 -9
  31. package/dist/src/get-thin-waist-addresses.js.map +1 -1
  32. package/dist/src/index.d.ts +33 -1
  33. package/dist/src/index.d.ts.map +1 -1
  34. package/dist/src/index.js +33 -1
  35. package/dist/src/index.js.map +1 -1
  36. package/dist/src/length-prefixed-decoder.d.ts +37 -0
  37. package/dist/src/length-prefixed-decoder.d.ts.map +1 -0
  38. package/dist/src/length-prefixed-decoder.js +64 -0
  39. package/dist/src/length-prefixed-decoder.js.map +1 -0
  40. package/dist/src/message-queue.d.ts +61 -0
  41. package/dist/src/message-queue.d.ts.map +1 -0
  42. package/dist/src/message-queue.js +93 -0
  43. package/dist/src/message-queue.js.map +1 -0
  44. package/dist/src/mock-muxer.d.ts +57 -0
  45. package/dist/src/mock-muxer.d.ts.map +1 -0
  46. package/dist/src/mock-muxer.js +204 -0
  47. package/dist/src/mock-muxer.js.map +1 -0
  48. package/dist/src/mock-stream.d.ts +31 -0
  49. package/dist/src/mock-stream.d.ts.map +1 -0
  50. package/dist/src/mock-stream.js +69 -0
  51. package/dist/src/mock-stream.js.map +1 -0
  52. package/dist/src/multiaddr/get-net-config.d.ts +55 -0
  53. package/dist/src/multiaddr/get-net-config.d.ts.map +1 -0
  54. package/dist/src/multiaddr/get-net-config.js +54 -0
  55. package/dist/src/multiaddr/get-net-config.js.map +1 -0
  56. package/dist/src/multiaddr/index.d.ts +7 -0
  57. package/dist/src/multiaddr/index.d.ts.map +1 -0
  58. package/dist/src/multiaddr/index.js +7 -0
  59. package/dist/src/multiaddr/index.js.map +1 -0
  60. package/dist/src/multiaddr/is-global-unicast.d.ts.map +1 -1
  61. package/dist/src/multiaddr/is-global-unicast.js +8 -9
  62. package/dist/src/multiaddr/is-global-unicast.js.map +1 -1
  63. package/dist/src/multiaddr/is-link-local.d.ts.map +1 -1
  64. package/dist/src/multiaddr/is-link-local.js +11 -16
  65. package/dist/src/multiaddr/is-link-local.js.map +1 -1
  66. package/dist/src/multiaddr/is-loopback.d.ts.map +1 -1
  67. package/dist/src/multiaddr/is-loopback.js +12 -5
  68. package/dist/src/multiaddr/is-loopback.js.map +1 -1
  69. package/dist/src/multiaddr/is-network-address.d.ts.map +1 -1
  70. package/dist/src/multiaddr/is-network-address.js +4 -16
  71. package/dist/src/multiaddr/is-network-address.js.map +1 -1
  72. package/dist/src/multiaddr/is-private.d.ts.map +1 -1
  73. package/dist/src/multiaddr/is-private.js +9 -10
  74. package/dist/src/multiaddr/is-private.js.map +1 -1
  75. package/dist/src/multiaddr/utils.d.ts +5 -0
  76. package/dist/src/multiaddr/utils.d.ts.map +1 -0
  77. package/dist/src/multiaddr/utils.js +32 -0
  78. package/dist/src/multiaddr/utils.js.map +1 -0
  79. package/dist/src/multiaddr-connection-pair.d.ts +25 -0
  80. package/dist/src/multiaddr-connection-pair.d.ts.map +1 -0
  81. package/dist/src/multiaddr-connection-pair.js +103 -0
  82. package/dist/src/multiaddr-connection-pair.js.map +1 -0
  83. package/dist/src/queue/index.d.ts +5 -0
  84. package/dist/src/queue/index.d.ts.map +1 -1
  85. package/dist/src/queue/index.js +24 -9
  86. package/dist/src/queue/index.js.map +1 -1
  87. package/dist/src/rate-limiter.d.ts +1 -15
  88. package/dist/src/rate-limiter.d.ts.map +1 -1
  89. package/dist/src/rate-limiter.js +1 -14
  90. package/dist/src/rate-limiter.js.map +1 -1
  91. package/dist/src/socket-writer.browser.d.ts +2 -0
  92. package/dist/src/socket-writer.browser.d.ts.map +1 -0
  93. package/dist/src/socket-writer.browser.js +4 -0
  94. package/dist/src/socket-writer.browser.js.map +1 -0
  95. package/dist/src/socket-writer.d.ts +19 -0
  96. package/dist/src/socket-writer.d.ts.map +1 -0
  97. package/dist/src/socket-writer.js +43 -0
  98. package/dist/src/socket-writer.js.map +1 -0
  99. package/dist/src/stream-pair.d.ts +42 -0
  100. package/dist/src/stream-pair.d.ts.map +1 -0
  101. package/dist/src/stream-pair.js +40 -0
  102. package/dist/src/stream-pair.js.map +1 -0
  103. package/dist/src/stream-utils.d.ts +198 -0
  104. package/dist/src/stream-utils.d.ts.map +1 -0
  105. package/dist/src/stream-utils.js +369 -0
  106. package/dist/src/stream-utils.js.map +1 -0
  107. package/package.json +19 -163
  108. package/src/abstract-message-stream.ts +549 -0
  109. package/src/abstract-multiaddr-connection.ts +93 -0
  110. package/src/abstract-stream-muxer.ts +239 -0
  111. package/src/abstract-stream.ts +51 -464
  112. package/src/errors.ts +10 -0
  113. package/src/get-thin-waist-addresses.browser.ts +5 -4
  114. package/src/get-thin-waist-addresses.ts +8 -12
  115. package/src/index.ts +33 -1
  116. package/src/length-prefixed-decoder.ts +98 -0
  117. package/src/message-queue.ts +156 -0
  118. package/src/mock-muxer.ts +304 -0
  119. package/src/mock-stream.ts +101 -0
  120. package/src/multiaddr/get-net-config.ts +112 -0
  121. package/src/multiaddr/index.ts +6 -0
  122. package/src/multiaddr/is-global-unicast.ts +8 -11
  123. package/src/multiaddr/is-link-local.ts +11 -20
  124. package/src/multiaddr/is-loopback.ts +12 -7
  125. package/src/multiaddr/is-network-address.ts +4 -19
  126. package/src/multiaddr/is-private.ts +9 -14
  127. package/src/multiaddr/utils.ts +46 -0
  128. package/src/multiaddr-connection-pair.ts +147 -0
  129. package/src/queue/index.ts +30 -9
  130. package/src/rate-limiter.ts +3 -30
  131. package/src/socket-writer.browser.ts +3 -0
  132. package/src/socket-writer.ts +64 -0
  133. package/src/stream-pair.ts +90 -0
  134. package/src/stream-utils.ts +873 -0
  135. package/dist/src/abort-options.d.ts +0 -7
  136. package/dist/src/abort-options.d.ts.map +0 -1
  137. package/dist/src/abort-options.js +0 -14
  138. package/dist/src/abort-options.js.map +0 -1
  139. package/dist/src/array-equals.d.ts +0 -24
  140. package/dist/src/array-equals.d.ts.map +0 -1
  141. package/dist/src/array-equals.js +0 -31
  142. package/dist/src/array-equals.js.map +0 -1
  143. package/dist/src/close-source.d.ts +0 -4
  144. package/dist/src/close-source.d.ts.map +0 -1
  145. package/dist/src/close-source.js +0 -11
  146. package/dist/src/close-source.js.map +0 -1
  147. package/dist/src/close.d.ts +0 -21
  148. package/dist/src/close.d.ts.map +0 -1
  149. package/dist/src/close.js +0 -49
  150. package/dist/src/close.js.map +0 -1
  151. package/dist/src/multiaddr/is-ip-based.d.ts +0 -6
  152. package/dist/src/multiaddr/is-ip-based.d.ts.map +0 -1
  153. package/dist/src/multiaddr/is-ip-based.js +0 -18
  154. package/dist/src/multiaddr/is-ip-based.js.map +0 -1
  155. package/dist/src/stream-to-ma-conn.d.ts +0 -23
  156. package/dist/src/stream-to-ma-conn.d.ts.map +0 -1
  157. package/dist/src/stream-to-ma-conn.js +0 -75
  158. package/dist/src/stream-to-ma-conn.js.map +0 -1
  159. package/dist/typedoc-urls.json +0 -147
  160. package/src/abort-options.ts +0 -20
  161. package/src/array-equals.ts +0 -34
  162. package/src/close-source.ts +0 -14
  163. package/src/close.ts +0 -65
  164. package/src/multiaddr/is-ip-based.ts +0 -21
  165. 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
- }
@@ -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
- }