@libp2p/yamux 7.0.4-0f07e3df5

package/dist/src/muxer.d.ts

@@ -0,0 +1,91 @@
+import { serviceCapabilities } from '@libp2p/interface';
+import { AbstractStreamMuxer } from '@libp2p/utils';
+import { Uint8ArrayList } from 'uint8arraylist';
+import { GoAwayCode } from './frame.js';
+import { YamuxStream } from './stream.js';
+import type { Config } from './config.js';
+import type { AbortOptions, MessageStream, StreamMuxerFactory } from '@libp2p/interface';
+export interface YamuxMuxerInit extends Partial<Config> {
+}
+export declare class Yamux implements StreamMuxerFactory {
+    protocol: string;
+    private readonly _init;
+    constructor(init?: Partial<Config>);
+    readonly [Symbol.toStringTag] = "@libp2p/yamux";
+    readonly [serviceCapabilities]: string[];
+    createStreamMuxer(maConn: MessageStream): YamuxMuxer;
+}
+export interface CloseOptions extends AbortOptions {
+    reason?: GoAwayCode;
+}
+export interface ActivePing extends PromiseWithResolvers<number> {
+    id: number;
+    start: number;
+}
+export declare class YamuxMuxer extends AbstractStreamMuxer<YamuxStream> {
+    /** The next stream id to be used when initiating a new stream */
+    private nextStreamID;
+    /** The next ping id to be used when pinging */
+    private nextPingID;
+    /** Tracking info for the currently active ping */
+    private activePing?;
+    /** Round trip time */
+    private rtt;
+    /** True if client, false if server */
+    private client;
+    private localGoAway?;
+    private remoteGoAway?;
+    /** Number of tracked inbound streams */
+    private numInboundStreams;
+    /** Number of tracked outbound streams */
+    private numOutboundStreams;
+    private decoder;
+    private keepAlive?;
+    private enableKeepAlive;
+    private keepAliveInterval;
+    private maxInboundStreams;
+    private maxOutboundStreams;
+    constructor(maConn: MessageStream, init?: YamuxMuxerInit);
+    onData(buf: Uint8Array | Uint8ArrayList): void;
+    onCreateStream(): YamuxStream;
+    /**
+     * Initiate a ping and wait for a response
+     *
+     * Note: only a single ping will be initiated at a time.
+     * If a ping is already in progress, a new ping will not be initiated.
+     *
+     * @returns the round-trip-time in milliseconds
+     */
+    ping(options?: AbortOptions): Promise<number>;
+    /**
+     * Get the ping round trip time
+     *
+     * Note: Will return 0 if no successful ping has yet been completed
+     *
+     * @returns the round-trip-time in milliseconds
+     */
+    getRTT(): number;
+    /**
+     * Close the muxer
+     */
+    close(options?: CloseOptions): Promise<void>;
+    abort(err: Error): void;
+    onTransportClosed(): void;
+    /** Create a new stream */
+    private _newStream;
+    /**
+     * closeStream is used to close a stream once both sides have
+     * issued a close.
+     */
+    private closeStream;
+    private handleFrame;
+    private handlePing;
+    private handlePingResponse;
+    private handleGoAway;
+    private handleStreamMessage;
+    private incomingStream;
+    private sendFrame;
+    private sendPing;
+    private sendGoAway;
+}
+//# sourceMappingURL=muxer.d.ts.map

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

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

package/dist/src/muxer.js

@@ -0,0 +1,428 @@
+import { InvalidParametersError, MuxerClosedError, TooManyOutboundProtocolStreamsError, serviceCapabilities } from '@libp2p/interface';
+import { AbstractStreamMuxer, repeatingTask } from '@libp2p/utils';
+import { raceSignal } from 'race-signal';
+import { Uint8ArrayList } from 'uint8arraylist';
+import { defaultConfig, verifyConfig } from './config.js';
+import { Decoder } from './decode.js';
+import { encodeHeader } from './encode.js';
+import { InvalidFrameError, isProtocolError, NotMatchingPingError, UnRequestedPingError } from './errors.js';
+import { Flag, FrameType, GoAwayCode } from './frame.js';
+import { StreamState, YamuxStream } from './stream.js';
+function debugFrame(header) {
+    return {
+        type: FrameType[header.type],
+        flags: [
+            (header.flag & Flag.SYN) === Flag.SYN ? 'SYN' : undefined,
+            (header.flag & Flag.ACK) === Flag.ACK ? 'ACK' : undefined,
+            (header.flag & Flag.FIN) === Flag.FIN ? 'FIN' : undefined,
+            (header.flag & Flag.RST) === Flag.RST ? 'RST' : undefined
+        ].filter(Boolean),
+        streamID: header.streamID,
+        length: header.length
+    };
+}
+const YAMUX_PROTOCOL_ID = '/yamux/1.0.0';
+export class Yamux {
+    protocol = YAMUX_PROTOCOL_ID;
+    _init;
+    constructor(init = {}) {
+        this._init = init;
+    }
+    [Symbol.toStringTag] = '@libp2p/yamux';
+    [serviceCapabilities] = [
+        '@libp2p/stream-multiplexing'
+    ];
+    createStreamMuxer(maConn) {
+        return new YamuxMuxer(maConn, {
+            ...this._init
+        });
+    }
+}
+export class YamuxMuxer extends AbstractStreamMuxer {
+    /** The next stream id to be used when initiating a new stream */
+    nextStreamID;
+    /** The next ping id to be used when pinging */
+    nextPingID;
+    /** Tracking info for the currently active ping */
+    activePing;
+    /** Round trip time */
+    rtt;
+    /** True if client, false if server */
+    client;
+    localGoAway;
+    remoteGoAway;
+    /** Number of tracked inbound streams */
+    numInboundStreams;
+    /** Number of tracked outbound streams */
+    numOutboundStreams;
+    decoder;
+    keepAlive;
+    enableKeepAlive;
+    keepAliveInterval;
+    maxInboundStreams;
+    maxOutboundStreams;
+    constructor(maConn, init = {}) {
+        super(maConn, {
+            ...init,
+            protocol: YAMUX_PROTOCOL_ID,
+            name: 'yamux'
+        });
+        this.client = maConn.direction === 'outbound';
+        verifyConfig(init);
+        this.enableKeepAlive = init.enableKeepAlive ?? defaultConfig.enableKeepAlive;
+        this.keepAliveInterval = init.keepAliveInterval ?? defaultConfig.keepAliveInterval;
+        this.maxInboundStreams = init.maxInboundStreams ?? defaultConfig.maxInboundStreams;
+        this.maxOutboundStreams = init.maxOutboundStreams ?? defaultConfig.maxOutboundStreams;
+        this.decoder = new Decoder();
+        this.numInboundStreams = 0;
+        this.numOutboundStreams = 0;
+        // client uses odd streamIDs, server uses even streamIDs
+        this.nextStreamID = this.client ? 1 : 2;
+        this.nextPingID = 0;
+        this.rtt = -1;
+        this.log.trace('muxer created');
+        if (this.enableKeepAlive) {
+            this.log.trace('muxer keepalive enabled interval=%s', this.keepAliveInterval);
+            this.keepAlive = repeatingTask(async (options) => {
+                try {
+                    await this.ping(options);
+                }
+                catch (err) {
+                    // TODO: should abort here?
+                    this.log.error('ping error: %s', err);
+                }
+            }, this.keepAliveInterval, {
+                // send an initial ping to establish RTT
+                runImmediately: true
+            });
+            this.keepAlive.start();
+        }
+    }
+    onData(buf) {
+        for (const frame of this.decoder.emitFrames(buf)) {
+            this.handleFrame(frame);
+        }
+    }
+    onCreateStream() {
+        if (this.remoteGoAway !== undefined) {
+            throw new MuxerClosedError('Muxer closed remotely');
+        }
+        if (this.localGoAway !== undefined) {
+            throw new MuxerClosedError('Muxer closed locally');
+        }
+        const id = this.nextStreamID;
+        this.nextStreamID += 2;
+        // check against our configured maximum number of outbound streams
+        if (this.numOutboundStreams >= this.maxOutboundStreams) {
+            throw new TooManyOutboundProtocolStreamsError('max outbound streams exceeded');
+        }
+        this.log.trace('new outgoing stream id=%s', id);
+        const stream = this._newStream(id, StreamState.Init, 'outbound');
+        this.numOutboundStreams++;
+        // send a window update to open the stream on the receiver end. do this in a
+        // microtask so the stream gets added to the streams array by the superclass
+        // before we send the SYN flag, otherwise we create a race condition whereby
+        // we can receive the ACK before the stream is added to the streams list
+        queueMicrotask(() => {
+            stream.sendWindowUpdate();
+        });
+        return stream;
+    }
+    /**
+     * Initiate a ping and wait for a response
+     *
+     * Note: only a single ping will be initiated at a time.
+     * If a ping is already in progress, a new ping will not be initiated.
+     *
+     * @returns the round-trip-time in milliseconds
+     */
+    async ping(options) {
+        if (this.remoteGoAway !== undefined) {
+            throw new MuxerClosedError('Muxer closed remotely');
+        }
+        if (this.localGoAway !== undefined) {
+            throw new MuxerClosedError('Muxer closed locally');
+        }
+        if (this.activePing != null) {
+            // an active ping is already in progress, piggyback off that
+            return raceSignal(this.activePing.promise, options?.signal);
+        }
+        // An active ping does not yet exist, handle the process here
+        // create active ping
+        this.activePing = Object.assign(Promise.withResolvers(), {
+            id: this.nextPingID++,
+            start: Date.now()
+        });
+        // send ping
+        this.sendPing(this.activePing.id);
+        // await pong
+        try {
+            this.rtt = await raceSignal(this.activePing.promise, options?.signal);
+        }
+        finally {
+            // clean-up active ping
+            this.activePing = undefined;
+        }
+        return this.rtt;
+    }
+    /**
+     * Get the ping round trip time
+     *
+     * Note: Will return 0 if no successful ping has yet been completed
+     *
+     * @returns the round-trip-time in milliseconds
+     */
+    getRTT() {
+        return this.rtt;
+    }
+    /**
+     * Close the muxer
+     */
+    async close(options = {}) {
+        if (this.status !== 'open') {
+            // already closed
+            return;
+        }
+        try {
+            const reason = options?.reason ?? GoAwayCode.NormalTermination;
+            this.log.trace('muxer close reason=%s', GoAwayCode[reason]);
+            await super.close(options);
+            // send reason to the other side, allow the other side to close gracefully
+            this.sendGoAway(reason);
+        }
+        finally {
+            this.keepAlive?.stop();
+        }
+    }
+    abort(err) {
+        if (this.status !== 'open') {
+            // already closed
+            return;
+        }
+        try {
+            super.abort(err);
+            let reason = GoAwayCode.InternalError;
+            if (isProtocolError(err)) {
+                reason = err.reason;
+            }
+            // If reason was provided, use that, otherwise use the presence of `err` to determine the reason
+            this.log.error('muxer abort reason=%s error=%s', reason, err);
+            // send reason to the other side, allow the other side to close gracefully
+            this.sendGoAway(reason);
+        }
+        finally {
+            this.keepAlive?.stop();
+        }
+    }
+    onTransportClosed() {
+        try {
+            super.onTransportClosed();
+        }
+        finally {
+            this.keepAlive?.stop();
+        }
+    }
+    /** Create a new stream */
+    _newStream(streamId, state, direction) {
+        if (this.streams.find(s => s.streamId === streamId) != null) {
+            throw new InvalidParametersError('Stream already exists with that id');
+        }
+        const stream = new YamuxStream({
+            ...this.streamOptions,
+            id: `${streamId}`,
+            streamId,
+            state,
+            direction,
+            sendFrame: this.sendFrame.bind(this),
+            log: this.log.newScope(`${direction}:${streamId}`),
+            getRTT: this.getRTT.bind(this)
+        });
+        stream.addEventListener('close', () => {
+            this.closeStream(streamId);
+        }, {
+            once: true
+        });
+        return stream;
+    }
+    /**
+     * closeStream is used to close a stream once both sides have
+     * issued a close.
+     */
+    closeStream(id) {
+        if (this.client === (id % 2 === 0)) {
+            this.numInboundStreams--;
+        }
+        else {
+            this.numOutboundStreams--;
+        }
+    }
+    handleFrame(frame) {
+        const { streamID, type, length } = frame.header;
+        this.log.trace('received frame %o', debugFrame(frame.header));
+        if (streamID === 0) {
+            switch (type) {
+                case FrameType.Ping:
+                    {
+                        this.handlePing(frame.header);
+                        return;
+                    }
+                case FrameType.GoAway:
+                    {
+                        this.handleGoAway(length);
+                        return;
+                    }
+                default:
+                    // Invalid state
+                    throw new InvalidFrameError('Invalid frame type');
+            }
+        }
+        else {
+            switch (frame.header.type) {
+                case FrameType.Data:
+                case FrameType.WindowUpdate:
+                    {
+                        this.handleStreamMessage(frame);
+                        return;
+                    }
+                default:
+                    // Invalid state
+                    throw new InvalidFrameError('Invalid frame type');
+            }
+        }
+    }
+    handlePing(header) {
+        // If the ping  is initiated by the sender, send a response
+        if (header.flag === Flag.SYN) {
+            this.log.trace('received ping request pingId=%s', header.length);
+            this.sendPing(header.length, Flag.ACK);
+        }
+        else if (header.flag === Flag.ACK) {
+            this.log.trace('received ping response pingId=%s', header.length);
+            this.handlePingResponse(header.length);
+        }
+        else {
+            // Invalid state
+            throw new InvalidFrameError('Invalid frame flag');
+        }
+    }
+    handlePingResponse(pingId) {
+        if (this.activePing === undefined) {
+            // this ping was not requested
+            throw new UnRequestedPingError('ping not requested');
+        }
+        if (this.activePing.id !== pingId) {
+            // this ping doesn't match our active ping request
+            throw new NotMatchingPingError('ping doesn\'t match our id');
+        }
+        // valid ping response
+        this.activePing.resolve(Date.now() - this.activePing.start);
+    }
+    handleGoAway(reason) {
+        this.log.trace('received GoAway reason=%s', GoAwayCode[reason] ?? 'unknown');
+        this.remoteGoAway = reason;
+        if (reason === GoAwayCode.NormalTermination) {
+            this.onTransportClosed();
+        }
+        else {
+            // reset any streams that are still open and close the muxer
+            this.abort(new Error('Remote sent GoAway'));
+        }
+    }
+    handleStreamMessage(frame) {
+        const { streamID, flag, type } = frame.header;
+        if ((flag & Flag.SYN) === Flag.SYN) {
+            this.incomingStream(streamID);
+        }
+        const stream = this.streams.find(s => s.streamId === streamID);
+        if (stream === undefined) {
+            this.log.trace('frame for missing stream id=%s', streamID);
+            return;
+        }
+        switch (type) {
+            case FrameType.WindowUpdate: {
+                stream.handleWindowUpdate(frame);
+                return;
+            }
+            case FrameType.Data: {
+                stream.handleData(frame);
+                return;
+            }
+            default:
+                throw new Error('unreachable');
+        }
+    }
+    incomingStream(id) {
+        if (this.client !== (id % 2 === 0)) {
+            throw new InvalidParametersError('Both endpoints are clients');
+        }
+        if (this.streams.find(s => s.streamId === id)) {
+            return;
+        }
+        this.log.trace('new incoming stream id=%s', id);
+        if (this.localGoAway !== undefined) {
+            // reject (reset) immediately if we are doing a go away
+            this.sendFrame({
+                type: FrameType.WindowUpdate,
+                flag: Flag.RST,
+                streamID: id,
+                length: 0
+            });
+            return;
+        }
+        // check against our configured maximum number of inbound streams
+        if (this.numInboundStreams >= this.maxInboundStreams) {
+            this.log('maxIncomingStreams exceeded, forcing stream reset');
+            this.sendFrame({
+                type: FrameType.WindowUpdate,
+                flag: Flag.RST,
+                streamID: id,
+                length: 0
+            });
+            return;
+        }
+        // allocate a new stream
+        const stream = this._newStream(id, StreamState.SYNReceived, 'inbound');
+        this.numInboundStreams++;
+        // the stream should now be tracked
+        this.onRemoteStream(stream);
+    }
+    sendFrame(header, data) {
+        let encoded;
+        if (header.type === FrameType.Data) {
+            if (data == null) {
+                throw new InvalidFrameError('Invalid frame');
+            }
+            encoded = new Uint8ArrayList(encodeHeader(header), data);
+        }
+        else {
+            encoded = encodeHeader(header);
+        }
+        this.log.trace('sending frame %o', debugFrame(header));
+        return this.send(encoded);
+    }
+    sendPing(pingId, flag = Flag.SYN) {
+        if (flag === Flag.SYN) {
+            this.log.trace('sending ping request pingId=%s', pingId);
+        }
+        else {
+            this.log.trace('sending ping response pingId=%s', pingId);
+        }
+        this.sendFrame({
+            type: FrameType.Ping,
+            flag,
+            streamID: 0,
+            length: pingId
+        });
+    }
+    sendGoAway(reason = GoAwayCode.NormalTermination) {
+        this.log('sending GoAway reason=%s', GoAwayCode[reason]);
+        this.localGoAway = reason;
+        this.sendFrame({
+            type: FrameType.GoAway,
+            flag: 0,
+            streamID: 0,
+            length: reason
+        });
+    }
+}
+//# sourceMappingURL=muxer.js.map

package/dist/src/muxer.js.map

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

package/dist/src/stream.d.ts

@@ -0,0 +1,96 @@
+import { AbstractStream } from '@libp2p/utils';
+import { Uint8ArrayList } from 'uint8arraylist';
+import type { Frame } from './decode.ts';
+import type { FrameHeader } from './frame.js';
+import type { AbortOptions } from '@libp2p/interface';
+import type { AbstractStreamInit, SendResult } from '@libp2p/utils';
+export declare enum StreamState {
+    Init = 0,
+    SYNSent = 1,
+    SYNReceived = 2,
+    Established = 3,
+    Finished = 4,
+    Paused = 5
+}
+export interface YamuxStreamInit extends AbstractStreamInit {
+    streamId: number;
+    sendFrame(header: FrameHeader, body?: Uint8ArrayList): boolean;
+    getRTT(): number;
+    initialStreamWindowSize?: number;
+    maxMessageSize?: number;
+    maxStreamWindowSize?: number;
+    state: StreamState;
+}
+/** YamuxStream is used to represent a logical stream within a session */
+export declare class YamuxStream extends AbstractStream {
+    streamId: number;
+    state: StreamState;
+    /** The number of available bytes to send */
+    private sendWindowCapacity;
+    /** The number of bytes available to receive in a full window */
+    private recvWindow;
+    /** The number of available bytes to receive */
+    private recvWindowCapacity;
+    private maxStreamWindowSize;
+    /**
+     * An 'epoch' is the time it takes to process and read data
+     *
+     * Used in conjunction with RTT to determine whether to increase the recvWindow
+     */
+    private epochStart;
+    private readonly getRTT;
+    private readonly sendFrame;
+    constructor(init: YamuxStreamInit);
+    /**
+     * Send a data message to the remote muxer
+     */
+    sendData(buf: Uint8ArrayList): SendResult;
+    /**
+     * Send a reset message to the remote muxer
+     */
+    sendReset(): Promise<void>;
+    /**
+     * Send a message to the remote muxer, informing them no more data messages
+     * will be sent by this end of the stream
+     */
+    sendCloseWrite(): Promise<void>;
+    /**
+     * Send a message to the remote muxer, informing them no more data messages
+     * will be read by this end of the stream - this is a no-op on Yamux streams
+     */
+    sendCloseRead(options?: AbortOptions): Promise<void>;
+    /**
+     * Stop sending window updates temporarily - in the interim the the remote
+     * send window will exhaust and the remote will stop sending data
+     */
+    sendPause(): void;
+    /**
+     * Start sending window updates as normal
+     */
+    sendResume(): void;
+    /**
+     * handleWindowUpdate is called when the stream receives a window update frame
+     */
+    handleWindowUpdate(frame: Frame): void;
+    /**
+     * handleData is called when the stream receives a data frame
+     */
+    handleData(frame: Frame): void;
+    /**
+     * processFlags is used to update the state of the stream based on set flags, if any.
+     */
+    private processFlags;
+    /**
+     * getSendFlags determines any flags that are appropriate
+     * based on the current stream state.
+     *
+     * The state is updated as a side-effect.
+     */
+    private getSendFlags;
+    /**
+     * Potentially sends a window update enabling further remote writes to take
+     * place.
+     */
+    sendWindowUpdate(): void;
+}
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAK/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAEnE,oBAAY,WAAW;IACrB,IAAI,IAAA;IACJ,OAAO,IAAA;IACP,WAAW,IAAA;IACX,WAAW,IAAA;IACX,QAAQ,IAAA;IACR,MAAM,IAAA;CACP;AAED,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAA;IAC9D,MAAM,IAAI,MAAM,CAAA;IAChB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,yEAAyE;AACzE,qBAAa,WAAY,SAAQ,cAAc;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;IAElB,4CAA4C;IAC5C,OAAO,CAAC,kBAAkB,CAAQ;IAClC,gEAAgE;IAChE,OAAO,CAAC,UAAU,CAAQ;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,mBAAmB,CAAQ;IAEnC;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyD;gBAEtE,IAAI,EAAE,eAAe;IAwBlC;;OAEG;IACH,QAAQ,CAAE,GAAG,EAAE,cAAc,GAAG,UAAU;IA8C1C;;OAEG;IACG,SAAS,IAAK,OAAO,CAAC,IAAI,CAAC;IASjC;;;OAGG;IACG,cAAc,IAAK,OAAO,CAAC,IAAI,CAAC;IAUtC;;;OAGG;IACG,aAAa,CAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;;OAGG;IACH,SAAS,IAAK,IAAI;IAIlB;;OAEG;IACH,UAAU,IAAK,IAAI;IAKnB;;OAEG;IACH,kBAAkB,CAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAyBvC;;OAEG;IACH,UAAU,CAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAmB/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;OAGG;IACH,gBAAgB,IAAK,IAAI;CA4C1B"}