@libp2p/interface 0.0.1-05abd49f

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

@@ -0,0 +1,85 @@
+import { Uint8ArrayList } from 'uint8arraylist';
+import type { Direction, Stream, StreamStat } from '../connection/index.js';
+import type { Source } from 'it-stream-types';
+export interface AbstractStreamInit {
+    /**
+     * A unique identifier for this stream
+     */
+    id: string;
+    /**
+     * The stream direction
+     */
+    direction: Direction;
+    /**
+     * The maximum allowable data size, any data larger than this will be
+     * chunked and sent in multiple data messages
+     */
+    maxDataSize: number;
+    /**
+     * User specific stream metadata
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Invoked when the stream ends
+     */
+    onEnd?: (err?: Error | undefined) => void;
+}
+export declare abstract class AbstractStream implements Stream {
+    id: string;
+    stat: StreamStat;
+    metadata: Record<string, unknown>;
+    source: AsyncGenerator<Uint8ArrayList, void, unknown>;
+    private readonly abortController;
+    private readonly resetController;
+    private readonly closeController;
+    private sourceEnded;
+    private sinkEnded;
+    private sinkSunk;
+    private endErr;
+    private readonly streamSource;
+    private readonly onEnd?;
+    private readonly maxDataSize;
+    constructor(init: AbstractStreamInit);
+    protected onSourceEnd(err?: Error): void;
+    protected onSinkEnd(err?: Error): void;
+    close(): void;
+    closeRead(): void;
+    closeWrite(): void;
+    abort(err: Error): void;
+    reset(): void;
+    sink(source: Source<Uint8ArrayList | Uint8Array>): Promise<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(): void | Promise<void>;
+    /**
+     * Send a data message to the remote muxer
+     */
+    abstract sendData(buf: Uint8ArrayList): void | Promise<void>;
+    /**
+     * Send a reset message to the remote muxer
+     */
+    abstract sendReset(): void | Promise<void>;
+    /**
+     * Send a message to the remote muxer, informing them no more data messages
+     * will be sent by this end of the stream
+     */
+    abstract sendCloseWrite(): void | Promise<void>;
+    /**
+     * Send a message to the remote muxer, informing them no more data messages
+     * will be read by this end of the stream
+     */
+    abstract sendCloseRead(): void | Promise<void>;
+}
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/stream-muxer/stream.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAa7C,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,SAAS,EAAE,SAAS,CAAA;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,KAAK,IAAI,CAAA;CAC1C;AAMD,8BAAsB,cAAe,YAAW,MAAM;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,MAAM,EAAE,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAE5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAEvB,IAAI,EAAE,kBAAkB;IAwCrC,SAAS,CAAC,WAAW,CAAE,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI;IAsBzC,SAAS,CAAC,SAAS,CAAE,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI;IAuBvC,KAAK,IAAK,IAAI;IAQd,SAAS,IAAK,IAAI;IAWlB,UAAU,IAAK,IAAI;IA2BnB,KAAK,CAAE,GAAG,EAAE,KAAK,GAAG,IAAI;IASxB,KAAK,IAAK,IAAI;IAOR,IAAI,CAAE,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyGvE;;;OAGG;IACH,UAAU,CAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAIvC;;;OAGG;IACH,oBAAoB,IAAK,MAAM;IAI/B;;;OAGG;IACH,QAAQ,CAAC,aAAa,IAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAE,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7D;;OAEG;IACH,QAAQ,CAAC,SAAS,IAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;;OAGG;IACH,QAAQ,CAAC,cAAc,IAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,aAAa,IAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD"}

package/dist/src/stream-muxer/stream.js

@@ -0,0 +1,255 @@
+// import { logger } from '@libp2p/logger'
+import { abortableSource } from 'abortable-iterator';
+import { anySignal } from 'any-signal';
+import { pushable } from 'it-pushable';
+import { Uint8ArrayList } from 'uint8arraylist';
+import { CodeError } from '../errors.js';
+// const log = logger('libp2p:stream')
+const log = () => { };
+log.trace = () => { };
+log.error = () => { };
+const ERR_STREAM_RESET = 'ERR_STREAM_RESET';
+const ERR_STREAM_ABORT = 'ERR_STREAM_ABORT';
+const ERR_SINK_ENDED = 'ERR_SINK_ENDED';
+const ERR_DOUBLE_SINK = 'ERR_DOUBLE_SINK';
+function isPromise(res) {
+    return res != null && typeof res.then === 'function';
+}
+export class AbstractStream {
+    id;
+    stat;
+    metadata;
+    source;
+    abortController;
+    resetController;
+    closeController;
+    sourceEnded;
+    sinkEnded;
+    sinkSunk;
+    endErr;
+    streamSource;
+    onEnd;
+    maxDataSize;
+    constructor(init) {
+        this.abortController = new AbortController();
+        this.resetController = new AbortController();
+        this.closeController = new AbortController();
+        this.sourceEnded = false;
+        this.sinkEnded = false;
+        this.sinkSunk = false;
+        this.id = init.id;
+        this.metadata = init.metadata ?? {};
+        this.stat = {
+            direction: init.direction,
+            timeline: {
+                open: Date.now()
+            }
+        };
+        this.maxDataSize = init.maxDataSize;
+        this.onEnd = init.onEnd;
+        this.source = this.streamSource = pushable({
+            onEnd: () => {
+                // already sent a reset message
+                if (this.stat.timeline.reset !== null) {
+                    const res = this.sendCloseRead();
+                    if (isPromise(res)) {
+                        res.catch(err => {
+                            log.error('error while sending close read', err);
+                        });
+                    }
+                }
+                this.onSourceEnd();
+            }
+        });
+        // necessary because the libp2p upgrader wraps the sink function
+        this.sink = this.sink.bind(this);
+    }
+    onSourceEnd(err) {
+        if (this.sourceEnded) {
+            return;
+        }
+        this.stat.timeline.closeRead = Date.now();
+        this.sourceEnded = true;
+        log.trace('%s stream %s source end - err: %o', this.stat.direction, this.id, err);
+        if (err != null && this.endErr == null) {
+            this.endErr = err;
+        }
+        if (this.sinkEnded) {
+            this.stat.timeline.close = Date.now();
+            if (this.onEnd != null) {
+                this.onEnd(this.endErr);
+            }
+        }
+    }
+    onSinkEnd(err) {
+        if (this.sinkEnded) {
+            return;
+        }
+        this.stat.timeline.closeWrite = Date.now();
+        this.sinkEnded = true;
+        log.trace('%s stream %s sink end - err: %o', this.stat.direction, this.id, err);
+        if (err != null && this.endErr == null) {
+            this.endErr = err;
+        }
+        if (this.sourceEnded) {
+            this.stat.timeline.close = Date.now();
+            if (this.onEnd != null) {
+                this.onEnd(this.endErr);
+            }
+        }
+    }
+    // Close for both Reading and Writing
+    close() {
+        log.trace('%s stream %s close', this.stat.direction, this.id);
+        this.closeRead();
+        this.closeWrite();
+    }
+    // Close for reading
+    closeRead() {
+        log.trace('%s stream %s closeRead', this.stat.direction, this.id);
+        if (this.sourceEnded) {
+            return;
+        }
+        this.streamSource.end();
+    }
+    // Close for writing
+    closeWrite() {
+        log.trace('%s stream %s closeWrite', this.stat.direction, this.id);
+        if (this.sinkEnded) {
+            return;
+        }
+        this.closeController.abort();
+        try {
+            // need to call this here as the sink method returns in the catch block
+            // when the close controller is aborted
+            const res = this.sendCloseWrite();
+            if (isPromise(res)) {
+                res.catch(err => {
+                    log.error('error while sending close write', err);
+                });
+            }
+        }
+        catch (err) {
+            log.trace('%s stream %s error sending close', this.stat.direction, this.id, err);
+        }
+        this.onSinkEnd();
+    }
+    // Close for reading and writing (local error)
+    abort(err) {
+        log.trace('%s stream %s abort', this.stat.direction, this.id, err);
+        // End the source with the passed error
+        this.streamSource.end(err);
+        this.abortController.abort();
+        this.onSinkEnd(err);
+    }
+    // Close immediately for reading and writing (remote error)
+    reset() {
+        const err = new CodeError('stream reset', ERR_STREAM_RESET);
+        this.resetController.abort();
+        this.streamSource.end(err);
+        this.onSinkEnd(err);
+    }
+    async sink(source) {
+        if (this.sinkSunk) {
+            throw new CodeError('sink already called on stream', ERR_DOUBLE_SINK);
+        }
+        this.sinkSunk = true;
+        if (this.sinkEnded) {
+            throw new CodeError('stream closed for writing', ERR_SINK_ENDED);
+        }
+        const signal = anySignal([
+            this.abortController.signal,
+            this.resetController.signal,
+            this.closeController.signal
+        ]);
+        try {
+            source = abortableSource(source, signal);
+            if (this.stat.direction === 'outbound') { // If initiator, open a new stream
+                const res = this.sendNewStream();
+                if (isPromise(res)) {
+                    await res;
+                }
+            }
+            for await (let data of source) {
+                while (data.length > 0) {
+                    if (data.length <= this.maxDataSize) {
+                        const res = this.sendData(data instanceof Uint8Array ? new Uint8ArrayList(data) : data);
+                        if (isPromise(res)) { // eslint-disable-line max-depth
+                            await res;
+                        }
+                        break;
+                    }
+                    data = data instanceof Uint8Array ? new Uint8ArrayList(data) : data;
+                    const res = this.sendData(data.sublist(0, this.maxDataSize));
+                    if (isPromise(res)) {
+                        await res;
+                    }
+                    data.consume(this.maxDataSize);
+                }
+            }
+        }
+        catch (err) {
+            if (err.type === 'aborted' && err.message === 'The operation was aborted') {
+                if (this.closeController.signal.aborted) {
+                    return;
+                }
+                if (this.resetController.signal.aborted) {
+                    err.message = 'stream reset';
+                    err.code = ERR_STREAM_RESET;
+                }
+                if (this.abortController.signal.aborted) {
+                    err.message = 'stream aborted';
+                    err.code = ERR_STREAM_ABORT;
+                }
+            }
+            // Send no more data if this stream was remotely reset
+            if (err.code === ERR_STREAM_RESET) {
+                log.trace('%s stream %s reset', this.stat.direction, this.id);
+            }
+            else {
+                log.trace('%s stream %s error', this.stat.direction, this.id, err);
+                try {
+                    const res = this.sendReset();
+                    if (isPromise(res)) {
+                        await res;
+                    }
+                    this.stat.timeline.reset = Date.now();
+                }
+                catch (err) {
+                    log.trace('%s stream %s error sending reset', this.stat.direction, this.id, err);
+                }
+            }
+            this.streamSource.end(err);
+            this.onSinkEnd(err);
+            throw err;
+        }
+        finally {
+            signal.clear();
+        }
+        try {
+            const res = this.sendCloseWrite();
+            if (isPromise(res)) {
+                await res;
+            }
+        }
+        catch (err) {
+            log.trace('%s stream %s error sending close', this.stat.direction, this.id, err);
+        }
+        this.onSinkEnd();
+    }
+    /**
+     * 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=stream.js.map

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

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

package/dist/src/topology/index.d.ts

@@ -0,0 +1,9 @@
+import type { Connection } from '../connection/index.js';
+import type { PeerId } from '../peer-id/index.js';
+export interface Topology {
+    min?: number;
+    max?: number;
+    onConnect?: (peerId: PeerId, conn: Connection) => void;
+    onDisconnect?: (peerId: PeerId) => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/topology/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/topology/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IACtD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC"}

package/dist/src/topology/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/topology/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/topology/index.ts"],"names":[],"mappings":""}

package/dist/src/transport/index.d.ts

@@ -0,0 +1,96 @@
+import type { Connection, MultiaddrConnection } from '../connection/index.js';
+import type { EventEmitter } from '../events.js';
+import type { AbortOptions } from '../index.js';
+import type { StreamMuxerFactory } from '../stream-muxer/index.js';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export interface ListenerEvents {
+    'connection': CustomEvent<Connection>;
+    'listening': CustomEvent;
+    'error': CustomEvent<Error>;
+    'close': CustomEvent;
+}
+export interface Listener extends EventEmitter<ListenerEvents> {
+    /**
+     * Start a listener
+     */
+    listen: (multiaddr: Multiaddr) => Promise<void>;
+    /**
+     * Get listen addresses
+     */
+    getAddrs: () => Multiaddr[];
+    /**
+     * Close listener
+     *
+     * @returns {Promise<void>}
+     */
+    close: () => Promise<void>;
+}
+export declare const symbol: unique symbol;
+export interface ConnectionHandler {
+    (connection: Connection): void;
+}
+export interface MultiaddrFilter {
+    (multiaddrs: Multiaddr[]): Multiaddr[];
+}
+export interface CreateListenerOptions {
+    handler?: ConnectionHandler;
+    upgrader: Upgrader;
+}
+export interface DialOptions extends AbortOptions {
+    upgrader: Upgrader;
+}
+/**
+ * A libp2p transport is understood as something that offers a dial and listen interface to establish connections.
+ */
+export interface Transport {
+    /**
+     * Used to identify the transport
+     */
+    [Symbol.toStringTag]: string;
+    /**
+     * Used by the isTransport function
+     */
+    [symbol]: true;
+    /**
+     * Dial a given multiaddr.
+     */
+    dial: (ma: Multiaddr, options: DialOptions) => Promise<Connection>;
+    /**
+     * Create transport listeners.
+     */
+    createListener: (options: CreateListenerOptions) => Listener;
+    /**
+     * Takes a list of `Multiaddr`s and returns only valid addresses for the transport
+     */
+    filter: MultiaddrFilter;
+}
+export declare function isTransport(other: any): other is Transport;
+/**
+ * Enum Transport Manager Fault Tolerance values
+ */
+export declare enum FaultTolerance {
+    /**
+     * should be used for failing in any listen circumstance
+     */
+    FATAL_ALL = 0,
+    /**
+     * should be used for not failing when not listening
+     */
+    NO_FATAL = 1
+}
+export interface UpgraderOptions {
+    skipEncryption?: boolean;
+    skipProtection?: boolean;
+    muxerFactory?: StreamMuxerFactory;
+}
+export interface Upgrader {
+    /**
+     * Upgrades an outbound connection on `transport.dial`.
+     */
+    upgradeOutbound: (maConn: MultiaddrConnection, opts?: UpgraderOptions) => Promise<Connection>;
+    /**
+     * Upgrades an inbound connection on transport listener.
+     */
+    upgradeInbound: (maConn: MultiaddrConnection, opts?: UpgraderOptions) => Promise<Connection>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IACrC,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,QAAS,SAAQ,YAAY,CAAC,cAAc,CAAC;IAC5D;;OAEG;IACH,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C;;OAEG;IACH,QAAQ,EAAE,MAAM,SAAS,EAAE,CAAA;IAC3B;;;;OAIG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,eAAO,MAAM,MAAM,eAAkC,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE;AAErE,MAAM,WAAW,eAAe;IAAG,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAA;CAAE;AAE3E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE5B;;OAEG;IACH,CAAC,MAAM,CAAC,EAAE,IAAI,CAAA;IAEd;;OAEG;IACH,IAAI,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAElE;;OAEG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,QAAQ,CAAA;IAE5D;;OAEG;IACH,MAAM,EAAE,eAAe,CAAA;CACxB;AAED,wBAAgB,WAAW,CAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,SAAS,CAE3D;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,QAAQ,IAAA;CACT;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAE7F;;OAEG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CAC7F"}

package/dist/src/transport/index.js

@@ -0,0 +1,19 @@
+export const symbol = Symbol.for('@libp2p/transport');
+export function isTransport(other) {
+    return other != null && Boolean(other[symbol]);
+}
+/**
+ * Enum Transport Manager Fault Tolerance values
+ */
+export var FaultTolerance;
+(function (FaultTolerance) {
+    /**
+     * should be used for failing in any listen circumstance
+     */
+    FaultTolerance[FaultTolerance["FATAL_ALL"] = 0] = "FATAL_ALL";
+    /**
+     * should be used for not failing when not listening
+     */
+    FaultTolerance[FaultTolerance["NO_FATAL"] = 1] = "NO_FATAL";
+})(FaultTolerance || (FaultTolerance = {}));
+//# sourceMappingURL=index.js.map

package/dist/src/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;AA6CrD,MAAM,UAAU,WAAW,CAAE,KAAU;IACrC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB;;OAEG;IACH,6DAAa,CAAA;IAEb;;OAEG;IACH,2DAAQ,CAAA;AACV,CAAC,EAVW,cAAc,KAAd,cAAc,QAUzB"}