@libp2p/utils 6.7.2-8484de8a2 → 6.7.2-87bc8d4fb

package/dist/src/abort-options.d.ts

@@ -0,0 +1,7 @@
+import type { AbortOptions } from '@libp2p/interface';
+import type { ClearableSignal } from 'any-signal';
+export declare function createTimeoutOptions(timeout: number): AbortOptions;
+export declare function createTimeoutOptions(timeout: number, ...existingSignals: AbortSignal[]): {
+    signal: ClearableSignal;
+};
+//# sourceMappingURL=abort-options.d.ts.map

package/dist/src/abort-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-options.d.ts","sourceRoot":"","sources":["../../src/abort-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,wBAAgB,oBAAoB,CAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAAA;AACpE,wBAAgB,oBAAoB,CAAE,OAAO,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,WAAW,EAAE,GAAG;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,CAAA"}

package/dist/src/abort-options.js

@@ -0,0 +1,14 @@
+import { anySignal } from 'any-signal';
+import { setMaxListeners } from 'main-event';
+export function createTimeoutOptions(timeout, ...existingSignals) {
+    let signal = AbortSignal.timeout(timeout);
+    setMaxListeners(Infinity, signal);
+    if (existingSignals.length > 0) {
+        signal = anySignal([signal, ...existingSignals]);
+        setMaxListeners(Infinity, signal);
+    }
+    return {
+        signal
+    };
+}
+//# sourceMappingURL=abort-options.js.map

package/dist/src/abort-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-options.js","sourceRoot":"","sources":["../../src/abort-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAM5C,MAAM,UAAU,oBAAoB,CAAE,OAAe,EAAE,GAAG,eAA8B;IACtF,IAAI,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAEjC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,GAAG,SAAS,CAAC,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC,CAAC,CAAA;QAChD,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,OAAO;QACL,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/src/abstract-stream.d.ts

@@ -1,31 +1,147 @@
-import { AbstractMessageStream } from './abstract-message-stream.js';
-import type { MessageStreamInit } from './abstract-message-stream.js';
-import type { AbortOptions, Stream } from '@libp2p/interface';
-export interface AbstractStreamInit extends MessageStreamInit {
+import { Uint8ArrayList } from 'uint8arraylist';
+import type { AbortOptions, Direction, ReadStatus, Stream, StreamStatus, StreamTimeline, WriteStatus } from '@libp2p/interface';
+import type { Logger } from '@libp2p/logger';
+import type { Source } from 'it-stream-types';
+export interface AbstractStreamInit {
     /**
      * A unique identifier for this stream
      */
     id: string;
     /**
-     * The protocol name for the stream, if it is known
+     * The stream direction
      */
-    protocol?: string;
+    direction: Direction;
+    /**
+     * A Logger implementation used to log stream-specific information
+     */
+    log: Logger;
+    /**
+     * User specific stream metadata
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Invoked when the stream ends
+     */
+    onEnd?(err?: Error): void;
+    /**
+     * Invoked when the readable end of the stream is closed
+     */
+    onCloseRead?(): void;
+    /**
+     * Invoked when the writable end of the stream is closed
+     */
+    onCloseWrite?(): void;
+    /**
+     * Invoked when the stream has been reset by the remote
+     */
+    onReset?(): void;
+    /**
+     * Invoked when the stream has errored
+     */
+    onAbort?(err: Error): void;
+    /**
+     * How long to wait in ms for stream data to be written to the underlying
+     * connection when closing the writable end of the stream.
+     *
+     * @default 500
+     */
+    closeTimeout?: number;
+    /**
+     * After the stream sink has closed, a limit on how long it takes to send
+     * a close-write message to the remote peer.
+     */
+    sendCloseWriteTimeout?: number;
 }
-export declare abstract class AbstractStream extends AbstractMessageStream implements Stream {
+export declare abstract class AbstractStream implements Stream {
     id: string;
-    protocol: string;
+    direction: Direction;
+    timeline: StreamTimeline;
+    protocol?: string;
+    metadata: Record<string, unknown>;
+    source: AsyncGenerator<Uint8ArrayList, void, unknown>;
+    status: StreamStatus;
+    readStatus: ReadStatus;
+    writeStatus: WriteStatus;
+    readonly log: Logger;
+    private readonly sinkController;
+    private readonly sinkEnd;
+    private readonly closed;
+    private endErr;
+    private readonly streamSource;
+    private readonly onEnd?;
+    private readonly onCloseRead?;
+    private readonly onCloseWrite?;
+    private readonly onReset?;
+    private readonly onAbort?;
+    private readonly sendCloseWriteTimeout;
+    private sendingData?;
     constructor(init: AbstractStreamInit);
+    sink(source: Source<Uint8ArrayList | Uint8Array>): Promise<void>;
+    protected onSourceEnd(err?: Error): void;
+    protected onSinkEnd(err?: Error): void;
     close(options?: AbortOptions): Promise<void>;
     closeRead(options?: AbortOptions): Promise<void>;
+    closeWrite(options?: AbortOptions): Promise<void>;
+    /**
+     * Close immediately for reading and writing and send a reset message (local
+     * error)
+     */
+    abort(err: Error): void;
+    /**
+     * Receive a reset message - close immediately for reading and writing (remote
+     * error)
+     */
+    reset(): void;
+    _closeSinkAndSource(err?: Error): void;
+    _closeSink(err?: Error): void;
+    _closeSource(err?: Error): void;
+    /**
+     * The remote closed for writing so we should expect to receive no more
+     * messages
+     */
+    remoteCloseWrite(): void;
+    /**
+     * The remote closed for reading so we should not send any more
+     * messages
+     */
+    remoteCloseRead(): void;
+    /**
+     * The underlying muxer has closed, no more messages can be sent or will
+     * be received, close immediately to free up resources
+     */
+    destroy(): void;
+    /**
+     * When an extending class reads data from it's implementation-specific source,
+     * call this method to allow the stream consumer to read the data.
+     */
+    sourcePush(data: Uint8ArrayList): void;
+    /**
+     * Returns the amount of unread data - can be used to prevent large amounts of
+     * data building up when the stream consumer is too slow.
+     */
+    sourceReadableLength(): number;
+    /**
+     * Send a message to the remote muxer informing them a new stream is being
+     * opened
+     */
+    abstract sendNewStream(options?: AbortOptions): void | Promise<void>;
+    /**
+     * Send a data message to the remote muxer
+     */
+    abstract sendData(buf: Uint8ArrayList, options?: AbortOptions): void | Promise<void>;
+    /**
+     * Send a reset message to the remote muxer
+     */
+    abstract sendReset(options?: AbortOptions): void | Promise<void>;
     /**
-     * Send a message to the remote end of the stream, informing them that we will
-     * send no more data messages.
+     * Send a message to the remote muxer, informing them no more data messages
+     * will be sent by this end of the stream
      */
-    abstract sendCloseWrite(options?: AbortOptions): Promise<void>;
+    abstract sendCloseWrite(options?: AbortOptions): void | Promise<void>;
     /**
-     * If supported, send a message to the remote end of the stream, informing
-     * them that we will read no more data messages.
+     * Send a message to the remote muxer, informing them no more data messages
+     * will be read by this end of the stream
      */
-    abstract sendCloseRead(options?: AbortOptions): Promise<void>;
+    abstract sendCloseRead(options?: AbortOptions): void | Promise<void>;
 }
 //# sourceMappingURL=abstract-stream.d.ts.map

package/dist/src/abstract-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-stream.d.ts","sourceRoot":"","sources":["../../src/abstract-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE7D,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,8BAAsB,cAAe,SAAQ,qBAAsB,YAAW,MAAM;IAC3E,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;gBAEV,IAAI,EAAE,kBAAkB;IAO/B,KAAK,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C7C,SAAS,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/D;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/D"}
+{"version":3,"file":"abstract-stream.d.ts","sourceRoot":"","sources":["../../src/abstract-stream.ts"],"names":[],"mappings":"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"}

package/dist/src/abstract-stream.js

@@ -1,60 +1,342 @@
-import { pEvent } from 'p-event';
-import { AbstractMessageStream } from './abstract-message-stream.js';
-export class AbstractStream extends AbstractMessageStream {
+import { StreamResetError, StreamStateError } from '@libp2p/interface';
+import { pushable } from 'it-pushable';
+import defer from 'p-defer';
+import { raceSignal } from 'race-signal';
+import { Uint8ArrayList } from 'uint8arraylist';
+import { closeSource } from './close-source.js';
+const DEFAULT_SEND_CLOSE_WRITE_TIMEOUT = 5000;
+function isPromise(thing) {
+    if (thing == null) {
+        return false;
+    }
+    return typeof thing.then === 'function' &&
+        typeof thing.catch === 'function' &&
+        typeof thing.finally === 'function';
+}
+export class AbstractStream {
     id;
+    direction;
+    timeline;
     protocol;
+    metadata;
+    source;
+    status;
+    readStatus;
+    writeStatus;
+    log;
+    sinkController;
+    sinkEnd;
+    closed;
+    endErr;
+    streamSource;
+    onEnd;
+    onCloseRead;
+    onCloseWrite;
+    onReset;
+    onAbort;
+    sendCloseWriteTimeout;
+    sendingData;
     constructor(init) {
-        super(init);
+        this.sinkController = new AbortController();
+        this.sinkEnd = defer();
+        this.closed = defer();
+        this.log = init.log;
+        // stream status
+        this.status = 'open';
+        this.readStatus = 'ready';
+        this.writeStatus = 'ready';
         this.id = init.id;
-        this.protocol = init.protocol ?? '';
+        this.metadata = init.metadata ?? {};
+        this.direction = init.direction;
+        this.timeline = {
+            open: Date.now()
+        };
+        this.sendCloseWriteTimeout = init.sendCloseWriteTimeout ?? DEFAULT_SEND_CLOSE_WRITE_TIMEOUT;
+        this.onEnd = init.onEnd;
+        this.onCloseRead = init.onCloseRead;
+        this.onCloseWrite = init.onCloseWrite;
+        this.onReset = init.onReset;
+        this.onAbort = init.onAbort;
+        this.source = this.streamSource = pushable({
+            onEnd: (err) => {
+                if (err != null) {
+                    this.log.trace('source ended with error', err);
+                }
+                else {
+                    this.log.trace('source ended');
+                }
+                this.onSourceEnd(err);
+            }
+        });
+        // necessary because the libp2p upgrader wraps the sink function
+        this.sink = this.sink.bind(this);
+    }
+    async sink(source) {
+        if (this.writeStatus !== 'ready') {
+            throw new StreamStateError(`writable end state is "${this.writeStatus}" not "ready"`);
+        }
+        try {
+            this.writeStatus = 'writing';
+            const options = {
+                signal: this.sinkController.signal
+            };
+            if (this.direction === 'outbound') { // If initiator, open a new stream
+                const res = this.sendNewStream(options);
+                if (isPromise(res)) {
+                    await res;
+                }
+            }
+            const abortListener = () => {
+                closeSource(source, this.log);
+            };
+            try {
+                this.sinkController.signal.addEventListener('abort', abortListener);
+                this.log.trace('sink reading from source');
+                for await (let data of source) {
+                    data = data instanceof Uint8Array ? new Uint8ArrayList(data) : data;
+                    const res = this.sendData(data, options);
+                    if (isPromise(res)) {
+                        this.sendingData = defer();
+                        await res;
+                        this.sendingData.resolve();
+                        this.sendingData = undefined;
+                    }
+                }
+            }
+            finally {
+                this.sinkController.signal.removeEventListener('abort', abortListener);
+            }
+            this.log.trace('sink finished reading from source, write status is "%s"', this.writeStatus);
+            if (this.writeStatus === 'writing') {
+                this.writeStatus = 'closing';
+                this.log.trace('send close write to remote');
+                await this.sendCloseWrite({
+                    signal: AbortSignal.timeout(this.sendCloseWriteTimeout)
+                });
+                this.writeStatus = 'closed';
+            }
+            this.onSinkEnd();
+        }
+        catch (err) {
+            this.log.trace('sink ended with error, calling abort with error', err);
+            this.abort(err);
+            throw err;
+        }
+        finally {
+            this.log.trace('resolve sink end');
+            this.sinkEnd.resolve();
+        }
+    }
+    onSourceEnd(err) {
+        if (this.timeline.closeRead != null) {
+            return;
+        }
+        this.timeline.closeRead = Date.now();
+        this.readStatus = 'closed';
+        if (err != null && this.endErr == null) {
+            this.endErr = err;
+        }
+        this.onCloseRead?.();
+        if (this.timeline.closeWrite != null) {
+            this.log.trace('source and sink ended');
+            this.timeline.close = Date.now();
+            if (this.status !== 'aborted' && this.status !== 'reset') {
+                this.status = 'closed';
+            }
+            if (this.onEnd != null) {
+                this.onEnd(this.endErr);
+            }
+            this.closed.resolve();
+        }
+        else {
+            this.log.trace('source ended, waiting for sink to end');
+        }
     }
+    onSinkEnd(err) {
+        if (this.timeline.closeWrite != null) {
+            return;
+        }
+        this.timeline.closeWrite = Date.now();
+        this.writeStatus = 'closed';
+        if (err != null && this.endErr == null) {
+            this.endErr = err;
+        }
+        this.onCloseWrite?.();
+        if (this.timeline.closeRead != null) {
+            this.log.trace('sink and source ended');
+            this.timeline.close = Date.now();
+            if (this.status !== 'aborted' && this.status !== 'reset') {
+                this.status = 'closed';
+            }
+            if (this.onEnd != null) {
+                this.onEnd(this.endErr);
+            }
+            this.closed.resolve();
+        }
+        else {
+            this.log.trace('sink ended, waiting for source to end');
+        }
+    }
+    // Close for both Reading and Writing
     async close(options) {
+        if (this.status !== 'open') {
+            return;
+        }
+        this.log.trace('closing gracefully');
+        this.status = 'closing';
+        // wait for read and write ends to close
+        await raceSignal(Promise.all([
+            this.closeWrite(options),
+            this.closeRead(options),
+            this.closed.promise
+        ]), options?.signal);
+        this.status = 'closed';
+        this.log.trace('closed gracefully');
+    }
+    async closeRead(options = {}) {
+        if (this.readStatus === 'closing' || this.readStatus === 'closed') {
+            return;
+        }
+        this.log.trace('closing readable end of stream with starting read status "%s"', this.readStatus);
+        const readStatus = this.readStatus;
+        this.readStatus = 'closing';
+        if (this.status !== 'reset' && this.status !== 'aborted' && this.timeline.closeRead == null) {
+            this.log.trace('send close read to remote');
+            await this.sendCloseRead(options);
+        }
+        if (readStatus === 'ready') {
+            this.log.trace('ending internal source queue with %d queued bytes', this.streamSource.readableLength);
+            this.streamSource.end();
+        }
+        this.log.trace('closed readable end of stream');
+    }
+    async closeWrite(options = {}) {
         if (this.writeStatus === 'closing' || this.writeStatus === 'closed') {
             return;
         }
-        this.writeStatus = 'closing';
-        // if we are currently sending data, wait for all the data to be written
-        // into the underlying transport
-        if (this.sendingData || this.writeBuffer.byteLength > 0) {
-            this.log('waiting for write queue to become idle before closing writable end of stream, %d unsent bytes', this.writeBuffer.byteLength);
-            await pEvent(this, 'idle', {
-                ...options,
-                rejectionEvents: [
-                    'close'
-                ]
-            });
+        this.log.trace('closing writable end of stream with starting write status "%s"', this.writeStatus);
+        if (this.writeStatus === 'ready') {
+            this.log.trace('sink was never sunk, sink an empty array');
+            await raceSignal(this.sink([]), options.signal);
         }
-        // now that the underlying transport has all the data, if the buffer is full
-        // wait for it to be emptied
-        if (this.writableNeedsDrain) {
-            this.log('waiting for write queue to drain before closing writable end of stream, %d unsent bytes, sending %s', this.writeBuffer.byteLength, this.sendingData);
-            await pEvent(this, 'drain', {
-                ...options,
-                rejectionEvents: [
-                    'close'
-                ]
-            });
-            this.log('write queue drained, closing writable end of stream, %d unsent bytes, sending %s', this.writeBuffer.byteLength, this.sendingData);
+        if (this.writeStatus === 'writing') {
+            // try to let sending outgoing data succeed
+            if (this.sendingData != null) {
+                await raceSignal(this.sendingData.promise, options.signal);
+            }
+            // stop reading from the source passed to `.sink`
+            this.log.trace('aborting source passed to .sink');
+            this.sinkController.abort();
+            await raceSignal(this.sinkEnd.promise, options.signal);
         }
-        await this.sendCloseWrite(options);
         this.writeStatus = 'closed';
-        this.log('closed writable end gracefully');
-        if (this.remoteWriteStatus === 'closed') {
-            this.onTransportClosed();
+        this.log.trace('closed writable end of stream');
+    }
+    /**
+     * Close immediately for reading and writing and send a reset message (local
+     * error)
+     */
+    abort(err) {
+        if (this.status === 'closed' || this.status === 'aborted' || this.status === 'reset') {
+            return;
         }
+        this.log('abort with error', err);
+        // try to send a reset message
+        this.log('try to send reset to remote');
+        const res = this.sendReset();
+        if (isPromise(res)) {
+            res.catch((err) => {
+                this.log.error('error sending reset message', err);
+            });
+        }
+        this.status = 'aborted';
+        this.timeline.abort = Date.now();
+        this._closeSinkAndSource(err);
+        this.onAbort?.(err);
     }
-    async closeRead(options) {
+    /**
+     * Receive a reset message - close immediately for reading and writing (remote
+     * error)
+     */
+    reset() {
+        if (this.status === 'closed' || this.status === 'aborted' || this.status === 'reset') {
+            return;
+        }
+        const err = new StreamResetError('stream reset');
+        this.status = 'reset';
+        this.timeline.reset = Date.now();
+        this._closeSinkAndSource(err);
+        this.onReset?.();
+    }
+    _closeSinkAndSource(err) {
+        this._closeSink(err);
+        this._closeSource(err);
+    }
+    _closeSink(err) {
+        // if the sink function is running, cause it to end
+        if (this.writeStatus === 'writing') {
+            this.log.trace('end sink source');
+            this.sinkController.abort();
+        }
+        this.onSinkEnd(err);
+    }
+    _closeSource(err) {
+        // if the source is not ending, end it
+        if (this.readStatus !== 'closing' && this.readStatus !== 'closed') {
+            this.log.trace('ending source with %d bytes to be read by consumer', this.streamSource.readableLength);
+            this.readStatus = 'closing';
+            this.streamSource.end(err);
+        }
+    }
+    /**
+     * The remote closed for writing so we should expect to receive no more
+     * messages
+     */
+    remoteCloseWrite() {
         if (this.readStatus === 'closing' || this.readStatus === 'closed') {
+            this.log('received remote close write but local source is already closed');
             return;
         }
-        // throw away any unread data
-        if (this.readBuffer.byteLength > 0) {
-            this.readBuffer.consume(this.readBuffer.byteLength);
+        this.log.trace('remote close write');
+        this._closeSource();
+    }
+    /**
+     * The remote closed for reading so we should not send any more
+     * messages
+     */
+    remoteCloseRead() {
+        if (this.writeStatus === 'closing' || this.writeStatus === 'closed') {
+            this.log('received remote close read but local sink is already closed');
+            return;
         }
-        this.readStatus = 'closing';
-        await this.sendCloseRead(options);
-        this.readStatus = 'closed';
-        this.log('closed readable end gracefully');
+        this.log.trace('remote close read');
+        this._closeSink();
+    }
+    /**
+     * The underlying muxer has closed, no more messages can be sent or will
+     * be received, close immediately to free up resources
+     */
+    destroy() {
+        if (this.status === 'closed' || this.status === 'aborted' || this.status === 'reset') {
+            this.log('received destroy but we are already closed');
+            return;
+        }
+        this.log.trace('stream destroyed');
+        this._closeSinkAndSource();
+    }
+    /**
+     * When an extending class reads data from it's implementation-specific source,
+     * call this method to allow the stream consumer to read the data.
+     */
+    sourcePush(data) {
+        this.streamSource.push(data);
+    }
+    /**
+     * Returns the amount of unread data - can be used to prevent large amounts of
+     * data building up when the stream consumer is too slow.
+     */
+    sourceReadableLength() {
+        return this.streamSource.readableLength;
     }
 }
 //# sourceMappingURL=abstract-stream.js.map

package/dist/src/abstract-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-stream.js","sourceRoot":"","sources":["../../src/abstract-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAgBpE,MAAM,OAAgB,cAAe,SAAQ,qBAAqB;IACzD,EAAE,CAAQ;IACV,QAAQ,CAAQ;IAEvB,YAAa,IAAwB;QACnC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEX,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAA;QACjB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,KAAK,CAAE,OAAsB;QACjC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpE,OAAM;QACR,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,SAAS,CAAA;QAE5B,wEAAwE;QACxE,gCAAgC;QAChC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,+FAA+F,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;YACtI,MAAM,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE;gBACzB,GAAG,OAAO;gBACV,eAAe,EAAE;oBACf,OAAO;iBACR;aACF,CAAC,CAAA;QACJ,CAAC;QAED,4EAA4E;QAC5E,4BAA4B;QAC5B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,qGAAqG,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;YAC9J,MAAM,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE;gBAC1B,GAAG,OAAO;gBACV,eAAe,EAAE;oBACf,OAAO;iBACR;aACF,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,CAAC,kFAAkF,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;QAC7I,CAAC;QAED,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAElC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAA;QAE3B,IAAI,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;QAE1C,IAAI,IAAI,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAE,OAAsB;QACrC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAM;QACR,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;QAE3B,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QAEjC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAA;QAE1B,IAAI,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAC5C,CAAC;CAaF"}
+{"version":3,"file":"abstract-stream.js","sourceRoot":"","sources":["../../src/abstract-stream.ts"],"names":[],"mappings":"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"}

package/dist/src/array-equals.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @packageDocumentation
+ *
+ * Provides strategies ensure arrays are equivalent.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { arrayEquals } from '@libp2p/utils/array-equals'
+ * import { multiaddr } from '@multformats/multiaddr'
+ *
+ * const ma1 = multiaddr('/ip4/127.0.0.1/tcp/9000'),
+ * const ma2 = multiaddr('/ip4/82.41.53.1/tcp/9000')
+ *
+ * console.info(arrayEquals([ma1], [ma1])) // true
+ * console.info(arrayEquals([ma1], [ma2])) // false
+ * ```
+ */
+/**
+ * Verify if two arrays of non primitive types with the "equals" function are equal.
+ * Compatible with multiaddr, peer-id and others.
+ */
+export declare function arrayEquals(a: any[], b: any[]): boolean;
+//# sourceMappingURL=array-equals.d.ts.map

package/dist/src/array-equals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-equals.d.ts","sourceRoot":"","sources":["../../src/array-equals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAUxD"}