@libp2p/utils 6.7.2 → 7.0.0-049bfa0fa

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

@@ -0,0 +1,129 @@
+import { TypedEventEmitter } from '@libp2p/interface';
+import { Uint8ArrayList } from 'uint8arraylist';
+import type { MessageStreamEvents, MessageStreamStatus, MessageStream, AbortOptions, MessageStreamTimeline, MessageStreamDirection, EventHandler, StreamOptions, MessageStreamReadStatus, MessageStreamWriteStatus } from '@libp2p/interface';
+import type { Logger } from '@libp2p/logger';
+export interface MessageStreamInit extends StreamOptions {
+    /**
+     * A Logger implementation used to log stream-specific information
+     */
+    log: Logger;
+    /**
+     * The stream direction
+     */
+    direction?: MessageStreamDirection;
+    /**
+     * By default all available bytes are passed to the `sendData` method of
+     * extending classes, if smaller chunks are required, pass a value here.
+     */
+    maxMessageSize?: number;
+}
+export interface SendResult {
+    /**
+     * The number of bytes from the passed buffer that were sent
+     */
+    sentBytes: number;
+    /**
+     * If the underlying resource can accept more data immediately. If `true`,
+     * `sent` must equal the `.byteLength` of the buffer passed to `sendData`.
+     */
+    canSendMore: boolean;
+}
+export declare abstract class AbstractMessageStream<Timeline extends MessageStreamTimeline = MessageStreamTimeline> extends TypedEventEmitter<MessageStreamEvents> implements MessageStream {
+    status: MessageStreamStatus;
+    readonly timeline: Timeline;
+    inactivityTimeout: number;
+    maxReadBufferLength: number;
+    maxWriteBufferLength?: number;
+    readonly log: Logger;
+    direction: MessageStreamDirection;
+    maxMessageSize?: number;
+    readStatus: MessageStreamReadStatus;
+    writeStatus: MessageStreamWriteStatus;
+    remoteReadStatus: MessageStreamReadStatus;
+    remoteWriteStatus: MessageStreamWriteStatus;
+    writableNeedsDrain: boolean;
+    /**
+     * Any data stored here is emitted before any new incoming data.
+     *
+     * This is used when the stream is paused or if data is pushed onto the stream
+     */
+    protected readonly readBuffer: Uint8ArrayList;
+    protected readonly writeBuffer: Uint8ArrayList;
+    protected sendingData: boolean;
+    constructor(init: MessageStreamInit);
+    [Symbol.asyncIterator](): AsyncGenerator<Uint8Array | Uint8ArrayList>;
+    isReadable(): boolean;
+    send(data: Uint8Array | Uint8ArrayList): boolean;
+    /**
+     * Close immediately for reading and writing and send a reset message (local
+     * error)
+     */
+    abort(err: Error): void;
+    pause(): void;
+    resume(): void;
+    push(data: Uint8Array | Uint8ArrayList): 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.
+     */
+    onData(data: Uint8Array | Uint8ArrayList): void;
+    addEventListener<K extends keyof MessageStreamEvents>(type: K, listener: EventHandler<MessageStreamEvents[K]> | null, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventHandler<Event>, options?: boolean | AddEventListenerOptions): void;
+    /**
+     * Receive a reset message - close immediately for reading and writing (remote
+     * error)
+     */
+    onRemoteReset(): void;
+    /**
+     * The underlying resource or transport this stream uses has closed - it is
+     * not possible to send any more messages though any data still in the read
+     * buffer may still be read
+     */
+    onTransportClosed(err?: Error): void;
+    /**
+     * Called by extending classes when the remote closes its writable end
+     */
+    onRemoteCloseWrite(): void;
+    /**
+     * Called by extending classes when the remote closes its readable end
+     */
+    onRemoteCloseRead(): void;
+    protected processSendQueue(): boolean;
+    protected dispatchReadBuffer(): void;
+    private checkReadBufferLength;
+    private checkWriteBufferLength;
+    onMuxerNeedsDrain(): void;
+    onMuxerDrain(): void;
+    /**
+     * Send a data message to the remote end of the stream. Implementations of
+     * this method should return the number of bytes from the passed buffer that
+     * were sent successfully and if the underlying resource can accept more data.
+     *
+     * The implementation should always attempt to send the maximum amount of data
+     * possible.
+     *
+     * Returning a result that means the data was only partially sent but that the
+     * underlying resource can accept more data is invalid.
+     */
+    abstract sendData(data: Uint8ArrayList): SendResult;
+    /**
+     * Send a reset message to the remote end of the stream
+     */
+    abstract sendReset(err: Error): void;
+    /**
+     * If supported, instruct the remote end of the stream to temporarily stop
+     * sending data messages
+     */
+    abstract sendPause(): void;
+    /**
+     * If supported, inform the remote end of the stream they may resume sending
+     * data messages
+     */
+    abstract sendResume(): void;
+    /**
+     * Stop accepting new data to send and return a promise that resolves when any
+     * unsent data has been written into the underlying resource.
+     */
+    abstract close(options?: AbortOptions): Promise<void>;
+}
+//# sourceMappingURL=abstract-message-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-message-stream.d.ts","sourceRoot":"","sources":["../../src/abstract-message-stream.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,393 @@
+import { StreamResetError, TypedEventEmitter, StreamMessageEvent, StreamBufferError, StreamResetEvent, StreamAbortEvent, StreamCloseEvent, StreamStateError } from '@libp2p/interface';
+import { pushable } from 'it-pushable';
+import { Uint8ArrayList } from 'uint8arraylist';
+const DEFAULT_MAX_READ_BUFFER_LENGTH = Math.pow(2, 20) * 4; // 4MB
+export class AbstractMessageStream extends TypedEventEmitter {
+    status;
+    timeline;
+    inactivityTimeout;
+    maxReadBufferLength;
+    maxWriteBufferLength;
+    log;
+    direction;
+    maxMessageSize;
+    readStatus;
+    writeStatus;
+    remoteReadStatus;
+    remoteWriteStatus;
+    writableNeedsDrain;
+    /**
+     * Any data stored here is emitted before any new incoming data.
+     *
+     * This is used when the stream is paused or if data is pushed onto the stream
+     */
+    readBuffer;
+    writeBuffer;
+    sendingData;
+    constructor(init) {
+        super();
+        this.status = 'open';
+        this.log = init.log;
+        this.direction = init.direction ?? 'outbound';
+        this.inactivityTimeout = init.inactivityTimeout ?? 120_000;
+        this.maxReadBufferLength = init.maxReadBufferLength ?? DEFAULT_MAX_READ_BUFFER_LENGTH;
+        this.maxWriteBufferLength = init.maxWriteBufferLength;
+        this.maxMessageSize = init.maxMessageSize;
+        this.readBuffer = new Uint8ArrayList();
+        this.writeBuffer = new Uint8ArrayList();
+        this.readStatus = 'readable';
+        this.remoteReadStatus = 'readable';
+        this.writeStatus = 'writable';
+        this.remoteWriteStatus = 'writable';
+        this.sendingData = false;
+        this.writableNeedsDrain = false;
+        // @ts-expect-error type could have required fields other than 'open'
+        this.timeline = {
+            open: Date.now()
+        };
+        this.processSendQueue = this.processSendQueue.bind(this);
+        const continueSendingOnDrain = () => {
+            if (this.writableNeedsDrain) {
+                this.log.trace('drain event received, continue sending data');
+                this.writableNeedsDrain = false;
+                this.processSendQueue();
+            }
+        };
+        this.addEventListener('drain', continueSendingOnDrain);
+    }
+    async *[Symbol.asyncIterator]() {
+        if (this.readStatus !== 'readable' && this.readStatus !== 'paused') {
+            return;
+        }
+        const output = pushable();
+        const streamAsyncIterableOnMessageListener = (evt) => {
+            output.push(evt.data);
+        };
+        this.addEventListener('message', streamAsyncIterableOnMessageListener);
+        const streamAsyncIterableOnCloseListener = (evt) => {
+            output.end(evt.error);
+        };
+        this.addEventListener('close', streamAsyncIterableOnCloseListener);
+        const streamAsyncIterableOnRemoteCloseWriteListener = () => {
+            output.end();
+        };
+        this.addEventListener('remoteCloseWrite', streamAsyncIterableOnRemoteCloseWriteListener);
+        try {
+            yield* output;
+        }
+        finally {
+            this.removeEventListener('message', streamAsyncIterableOnMessageListener);
+            this.removeEventListener('close', streamAsyncIterableOnCloseListener);
+            this.removeEventListener('remoteCloseWrite', streamAsyncIterableOnRemoteCloseWriteListener);
+        }
+    }
+    isReadable() {
+        return this.status === 'open';
+    }
+    send(data) {
+        if (this.writeStatus === 'closed' || this.writeStatus === 'closing') {
+            throw new StreamStateError(`Cannot write to a stream that is ${this.writeStatus}`);
+        }
+        this.log.trace('append %d bytes to write buffer', data.byteLength);
+        this.writeBuffer.append(data);
+        return this.processSendQueue();
+    }
+    /**
+     * Close immediately for reading and writing and send a reset message (local
+     * error)
+     */
+    abort(err) {
+        if (this.status === 'aborted' || this.status === 'reset' || this.status === 'closed') {
+            return;
+        }
+        this.log.error('abort with error - %e', err);
+        this.status = 'aborted';
+        // throw away unread data
+        if (this.readBuffer.byteLength > 0) {
+            this.readBuffer.consume(this.readBuffer.byteLength);
+        }
+        // throw away unsent data
+        if (this.writeBuffer.byteLength > 0) {
+            this.writeBuffer.consume(this.writeBuffer.byteLength);
+            this.safeDispatchEvent('idle');
+        }
+        this.writeStatus = 'closed';
+        this.remoteWriteStatus = 'closed';
+        this.readStatus = 'closed';
+        this.remoteReadStatus = 'closed';
+        this.timeline.close = Date.now();
+        try {
+            this.sendReset(err);
+        }
+        catch (err) {
+            this.log('failed to send reset to remote - %e', err);
+        }
+        this.dispatchEvent(new StreamAbortEvent(err));
+    }
+    pause() {
+        if (this.readStatus === 'closed' || this.readStatus === 'closing') {
+            throw new StreamStateError('Cannot pause a stream that is closing/closed');
+        }
+        if (this.readStatus === 'paused') {
+            return;
+        }
+        this.readStatus = 'paused';
+        this.sendPause();
+    }
+    resume() {
+        if (this.readStatus === 'closed' || this.readStatus === 'closing') {
+            throw new StreamStateError('Cannot resume a stream that is closing/closed');
+        }
+        if (this.readStatus === 'readable') {
+            return;
+        }
+        this.readStatus = 'readable';
+        // emit any data that accumulated while we were paused
+        this.dispatchReadBuffer();
+        this.sendResume();
+    }
+    push(data) {
+        if (this.readStatus === 'closed' || this.readStatus === 'closing') {
+            throw new StreamStateError(`Cannot push data onto a stream that is ${this.readStatus}`);
+        }
+        if (data.byteLength === 0) {
+            return;
+        }
+        this.readBuffer.append(data);
+        if (this.readStatus === 'paused' || this.listenerCount('message') === 0) {
+            // abort if the read buffer is too large
+            this.checkReadBufferLength();
+            return;
+        }
+        // TODO: use a microtask instead?
+        setTimeout(() => {
+            this.dispatchReadBuffer();
+        }, 0);
+    }
+    /**
+     * When an extending class reads data from it's implementation-specific source,
+     * call this method to allow the stream consumer to read the data.
+     */
+    onData(data) {
+        if (data.byteLength === 0) {
+            // this.log('ignoring empty data')
+            return;
+        }
+        // discard the data if our readable end is closed
+        if (this.readStatus === 'closing' || this.readStatus === 'closed') {
+            this.log('ignoring data - read status %s', this.readStatus);
+            return;
+        }
+        this.readBuffer.append(data);
+        this.dispatchReadBuffer();
+    }
+    addEventListener(...args) {
+        // @ts-expect-error cannot ensure args has enough members
+        super.addEventListener.apply(this, args);
+        // if a 'message' listener is being added and we have queued data, dispatch
+        // the data
+        if (args[0] === 'message' && this.readBuffer.byteLength > 0) {
+            // event listeners can be added in constructors and often use object
+            // properties - if this the case we can access a class member before it
+            // has been initialized so dispatch the message in the microtask queue
+            queueMicrotask(() => {
+                this.dispatchReadBuffer();
+            });
+        }
+    }
+    /**
+     * Receive a reset message - close immediately for reading and writing (remote
+     * error)
+     */
+    onRemoteReset() {
+        this.log('remote reset');
+        this.status = 'reset';
+        this.writeStatus = 'closed';
+        this.remoteWriteStatus = 'closed';
+        this.remoteReadStatus = 'closed';
+        this.timeline.close = Date.now();
+        if (this.readBuffer.byteLength === 0) {
+            this.readStatus = 'closed';
+        }
+        const err = new StreamResetError();
+        this.dispatchEvent(new StreamResetEvent(err));
+    }
+    /**
+     * The underlying resource or transport this stream uses has closed - it is
+     * not possible to send any more messages though any data still in the read
+     * buffer may still be read
+     */
+    onTransportClosed(err) {
+        this.log('transport closed');
+        if (this.readStatus === 'readable' && this.readBuffer.byteLength === 0) {
+            this.log('close readable end after transport closed and read buffer is empty');
+            this.readStatus = 'closed';
+        }
+        if (this.remoteReadStatus !== 'closed') {
+            this.remoteReadStatus = 'closed';
+        }
+        if (this.remoteWriteStatus !== 'closed') {
+            this.remoteWriteStatus = 'closed';
+        }
+        if (this.writeStatus !== 'closed') {
+            this.writeStatus = 'closed';
+        }
+        if (err != null) {
+            this.abort(err);
+        }
+        else {
+            if (this.status === 'open' || this.status === 'closing') {
+                this.timeline.close = Date.now();
+                this.status = 'closed';
+                this.writeStatus = 'closed';
+                this.remoteWriteStatus = 'closed';
+                this.remoteReadStatus = 'closed';
+                this.dispatchEvent(new StreamCloseEvent());
+            }
+        }
+    }
+    /**
+     * Called by extending classes when the remote closes its writable end
+     */
+    onRemoteCloseWrite() {
+        if (this.remoteWriteStatus === 'closed') {
+            return;
+        }
+        this.log.trace('on remote close write');
+        this.remoteWriteStatus = 'closed';
+        this.safeDispatchEvent('remoteCloseWrite');
+        if (this.writeStatus === 'closed') {
+            this.onTransportClosed();
+        }
+    }
+    /**
+     * Called by extending classes when the remote closes its readable end
+     */
+    onRemoteCloseRead() {
+        this.log.trace('on remote close read');
+        this.remoteReadStatus = 'closed';
+        // throw away any unsent bytes if the remote closes it's readable end
+        if (this.writeBuffer.byteLength > 0) {
+            this.writeBuffer.consume(this.writeBuffer.byteLength);
+            this.safeDispatchEvent('idle');
+        }
+    }
+    processSendQueue() {
+        // bail if the underlying transport is full
+        if (this.writableNeedsDrain) {
+            this.log.trace('not processing send queue as drain is required');
+            this.checkWriteBufferLength();
+            return false;
+        }
+        // bail if there is no data to send
+        if (this.writeBuffer.byteLength === 0) {
+            this.log.trace('not processing send queue as no bytes to send');
+            return true;
+        }
+        // bail if we are already sending data
+        if (this.sendingData) {
+            this.log.trace('not processing send queue as already sending data');
+            return true;
+        }
+        this.sendingData = true;
+        this.log.trace('processing send queue with %d queued bytes', this.writeBuffer.byteLength);
+        try {
+            let canSendMore = true;
+            const totalBytes = this.writeBuffer.byteLength;
+            let sentBytes = 0;
+            // send as much data as possible while we have data to send and the
+            // underlying muxer can still accept data
+            while (this.writeBuffer.byteLength > 0) {
+                const end = Math.min(this.maxMessageSize ?? this.writeBuffer.byteLength, this.writeBuffer.byteLength);
+                // this can happen if a subclass changes the max message size dynamically
+                if (end === 0) {
+                    canSendMore = false;
+                    break;
+                }
+                // chunk to send to the remote end
+                const toSend = this.writeBuffer.sublist(0, end);
+                // copy toSend in case the extending class modifies the list
+                const willSend = new Uint8ArrayList(toSend);
+                this.writeBuffer.consume(toSend.byteLength);
+                // sending data can cause buffers to fill up, events to be emitted and
+                // this method to be invoked again
+                const sendResult = this.sendData(toSend);
+                canSendMore = sendResult.canSendMore;
+                sentBytes += sendResult.sentBytes;
+                if (sendResult.sentBytes !== willSend.byteLength) {
+                    willSend.consume(sendResult.sentBytes);
+                    this.writeBuffer.prepend(willSend);
+                }
+                if (!canSendMore) {
+                    break;
+                }
+            }
+            if (!canSendMore) {
+                this.log.trace('sent %d/%d bytes, pausing sending because underlying stream is full, %d bytes left in the write buffer', sentBytes, totalBytes, this.writeBuffer.byteLength);
+                this.writableNeedsDrain = true;
+                this.checkWriteBufferLength();
+            }
+            // we processed all bytes in the queue, resolve the write queue idle promise
+            if (this.writeBuffer.byteLength === 0) {
+                this.safeDispatchEvent('idle');
+            }
+            return canSendMore;
+        }
+        finally {
+            this.sendingData = false;
+        }
+    }
+    dispatchReadBuffer() {
+        try {
+            if (this.listenerCount('message') === 0) {
+                this.log.trace('not dispatching pause buffer as there are no listeners for the message event');
+                return;
+            }
+            if (this.readBuffer.byteLength === 0) {
+                this.log.trace('not dispatching pause buffer as there is no data to dispatch');
+                return;
+            }
+            if (this.readStatus === 'paused') {
+                this.log.trace('not dispatching pause buffer we are paused');
+                return;
+            }
+            // discard the pause buffer if our readable end is closed
+            if (this.readStatus === 'closing' || this.readStatus === 'closed') {
+                this.log('dropping %d bytes because the readable end is %s', this.readBuffer.byteLength, this.readStatus);
+                this.readBuffer.consume(this.readBuffer.byteLength);
+                return;
+            }
+            const buf = this.readBuffer.sublist();
+            this.readBuffer.consume(buf.byteLength);
+            this.dispatchEvent(new StreamMessageEvent(buf));
+        }
+        finally {
+            if (this.readBuffer.byteLength === 0 && this.remoteWriteStatus === 'closed') {
+                this.log('close readable end after dispatching read buffer and remote writable end is closed');
+                this.readStatus = 'closed';
+            }
+            // abort if we failed to consume the read buffer and it is too large
+            this.checkReadBufferLength();
+        }
+    }
+    checkReadBufferLength() {
+        if (this.readBuffer.byteLength > this.maxReadBufferLength) {
+            this.abort(new StreamBufferError(`Read buffer length of ${this.readBuffer.byteLength} exceeded limit of ${this.maxReadBufferLength}, read status is ${this.readStatus}`));
+        }
+    }
+    checkWriteBufferLength() {
+        if (this.maxWriteBufferLength == null) {
+            return;
+        }
+        if (this.writeBuffer.byteLength > this.maxWriteBufferLength) {
+            this.abort(new StreamBufferError(`Write buffer length of ${this.writeBuffer.byteLength} exceeded limit of ${this.maxWriteBufferLength}, write status is ${this.writeStatus}`));
+        }
+    }
+    onMuxerNeedsDrain() {
+        this.writableNeedsDrain = true;
+    }
+    onMuxerDrain() {
+        this.safeDispatchEvent('drain');
+    }
+}
+//# sourceMappingURL=abstract-message-stream.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-message-stream.js","sourceRoot":"","sources":["../../src/abstract-message-stream.ts"],"names":[],"mappings":"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"}

package/dist/src/abstract-multiaddr-connection.d.ts

@@ -0,0 +1,26 @@
+import { AbstractMessageStream } from './abstract-message-stream.ts';
+import type { MessageStreamInit } from './abstract-message-stream.ts';
+import type { CounterGroup, Logger, MultiaddrConnection, MessageStreamDirection, AbortOptions } from '@libp2p/interface';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export interface AbstractMultiaddrConnectionInit extends Omit<MessageStreamInit, 'log'> {
+    remoteAddr: Multiaddr;
+    direction: MessageStreamDirection;
+    log: Logger;
+    inactivityTimeout?: number;
+    localAddr?: Multiaddr;
+    metricPrefix?: string;
+    metrics?: CounterGroup;
+}
+export declare abstract class AbstractMultiaddrConnection extends AbstractMessageStream implements MultiaddrConnection {
+    remoteAddr: Multiaddr;
+    private metricPrefix;
+    private metrics?;
+    constructor(init: AbstractMultiaddrConnectionInit);
+    close(options?: AbortOptions): Promise<void>;
+    /**
+     * Wait for any unsent data to be written to the underlying resource, then
+     * close the resource and resolve the returned promise
+     */
+    abstract sendClose(options?: AbortOptions): Promise<void>;
+}
+//# sourceMappingURL=abstract-multiaddr-connection.d.ts.map

package/dist/src/abstract-multiaddr-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-multiaddr-connection.d.ts","sourceRoot":"","sources":["../../src/abstract-multiaddr-connection.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,mBAAmB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACxH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC;IACrF,UAAU,EAAE,SAAS,CAAA;IACrB,SAAS,EAAE,sBAAsB,CAAA;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,8BAAsB,2BAA4B,SAAQ,qBAAsB,YAAW,mBAAmB;IACrG,UAAU,EAAE,SAAS,CAAA;IAE5B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAc;gBAEjB,IAAI,EAAE,+BAA+B;IA0B5C,KAAK,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCnD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAC3D"}

package/dist/src/abstract-multiaddr-connection.js

@@ -0,0 +1,66 @@
+import { pEvent } from 'p-event';
+import { AbstractMessageStream } from "./abstract-message-stream.js";
+export class AbstractMultiaddrConnection extends AbstractMessageStream {
+    remoteAddr;
+    metricPrefix;
+    metrics;
+    constructor(init) {
+        super(init);
+        this.metricPrefix = init.metricPrefix ?? '';
+        this.metrics = init.metrics;
+        this.remoteAddr = init.remoteAddr;
+        this.addEventListener('close', (evt) => {
+            this.metrics?.increment({ [`${this.metricPrefix}end`]: true });
+            if (evt.error != null) {
+                if (evt.local) {
+                    this.metrics?.increment({ [`${this.metricPrefix}abort`]: true });
+                }
+                else {
+                    this.metrics?.increment({ [`${this.metricPrefix}reset`]: true });
+                }
+            }
+            else {
+                if (evt.local) {
+                    this.metrics?.increment({ [`${this.metricPrefix}_local_close`]: true });
+                }
+                else {
+                    this.metrics?.increment({ [`${this.metricPrefix}_remote_close`]: true });
+                }
+            }
+        });
+    }
+    async close(options) {
+        if (this.status !== 'open') {
+            return;
+        }
+        this.status = 'closing';
+        this.writeStatus = 'closing';
+        this.remoteWriteStatus = 'closing';
+        this.remoteReadStatus = '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'
+                ]
+            });
+        }
+        // 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', this.writeBuffer.byteLength);
+            await pEvent(this, 'drain', {
+                ...options,
+                rejectionEvents: [
+                    'close'
+                ]
+            });
+        }
+        await this.sendClose(options);
+        this.onTransportClosed();
+    }
+}
+//# sourceMappingURL=abstract-multiaddr-connection.js.map

package/dist/src/abstract-multiaddr-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-multiaddr-connection.js","sourceRoot":"","sources":["../../src/abstract-multiaddr-connection.ts"],"names":[],"mappings":"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"}