openai 7.13.0 → 7.15.0

package/lib/webrtc/connection.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebRTCConnection = void 0;
+const data_channel_1 = require("./data-channel.js");
+const errors_1 = require("./errors.js");
+const subscriptions_1 = require("./subscriptions.js");
+/** Browser-native WebRTC negotiation with application-owned SDP signaling. */
+class WebRTCConnection {
+    /** Creates native resources, but does not request media, contact a server, or begin negotiation. */
+    constructor(configuration) {
+        this.connectionEvents = new subscriptions_1.Subscriptions();
+        this.currentState = 'new';
+        this.onPeerState = () => {
+            if (this.currentState === 'closed') {
+                return;
+            }
+            if (this.peer.connectionState === 'failed' || this.peer.connectionState === 'closed') {
+                const failed = this.peer.connectionState === 'failed';
+                const error = new errors_1.WebRTCError(failed ? 'transport_failed' : 'connection_closed', 'transport', 'The WebRTC peer connection ended.');
+                if (this.attempt) {
+                    this.failSetup(error, failed ? 'failed' : 'remote');
+                }
+                else {
+                    this.finish(failed ? 'failed' : 'remote', failed ? error : undefined);
+                }
+            }
+            else {
+                this.checkReady();
+            }
+        };
+        this.onChannelEvent = (event) => {
+            if (this.currentState === 'closed') {
+                return;
+            }
+            if (event.type === 'closed') {
+                if (this.attempt) {
+                    this.failSetup(new errors_1.WebRTCError('connection_closed', 'transport', 'The data channel closed during setup.'), 'remote');
+                }
+                else {
+                    this.finish('remote');
+                }
+            }
+            else if (event.type === 'error') {
+                if (event.error.phase === 'transport') {
+                    if (this.attempt) {
+                        this.failSetup(event.error, 'failed');
+                    }
+                    else {
+                        this.finish('failed', event.error);
+                    }
+                }
+                else {
+                    this.connectionEvents.emit(event);
+                }
+            }
+            else {
+                this.checkReady();
+            }
+        };
+        const host = globalThis;
+        if (!host.RTCPeerConnection) {
+            throw new errors_1.WebRTCError('unsupported_environment', 'transport', 'WebRTC requires a browser with RTCPeerConnection.');
+        }
+        const peer = new host.RTCPeerConnection(configuration);
+        try {
+            this.adapter = new data_channel_1.DataChannel(peer.createDataChannel('oai-events'));
+        }
+        catch (error) {
+            peer.close();
+            throw new errors_1.WebRTCError('negotiation_failed', 'transport', 'Could not create the WebRTC data channel.', error);
+        }
+        this.peer = peer;
+        this.peerConnection = peer;
+        this.dataChannel = this.adapter.dataChannel;
+        peer.addEventListener('connectionstatechange', this.onPeerState);
+        this.adapter.onConnectionEvent(this.onChannelEvent);
+    }
+    /** Current state, including before subscriptions are registered; notifications are not replayed. */
+    get state() {
+        return this.currentState;
+    }
+    /** Subscribes to one server event type with its generated payload; returns an independent unsubscribe function. */
+    on(type, handler) {
+        return this.adapter.on(type, handler);
+    }
+    /** Subscribes before connecting so initial server events are observable. API errors remain protocol data. */
+    onEvent(handler) {
+        return this.adapter.onEvent(handler);
+    }
+    /** Subscribes to local diagnostics and lifecycle. Setup failures reject connect() instead of emitting errors here. */
+    onConnectionEvent(handler) {
+        if (this.currentState === 'closed') {
+            throw new errors_1.WebRTCError('invalid_state', 'transport', 'The WebRTC connection is closed.');
+        }
+        return this.connectionEvents.add(handler);
+    }
+    /** Sends without buffering; returning means local submission, not server acceptance. */
+    send(event) {
+        this.adapter.send(event);
+    }
+    /** Negotiates once and waits for both native connection and data-channel readiness. Defaults to a 30-second deadline. */
+    connect(options) {
+        if (this.currentState !== 'new') {
+            return Promise.reject(new errors_1.WebRTCError('invalid_state', 'transport', 'connect() may only be called once per connection.'));
+        }
+        const timeoutMs = options.timeoutMs ?? 30000;
+        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2147483647) {
+            return Promise.reject(new errors_1.WebRTCError('invalid_state', 'transport', 'timeoutMs must be a positive finite timer duration.'));
+        }
+        const controller = new AbortController();
+        // oxlint-disable-next-line promise/avoid-new -- Native readiness, timeout, and abort events settle one connection attempt.
+        const result = new Promise((resolve, reject) => {
+            const onAbort = () => this.failSetup(new errors_1.WebRTCError('aborted', this.attempt?.phase ?? 'offer', 'WebRTC setup was cancelled.', options.signal?.reason), 'aborted');
+            const timer = setTimeout(() => this.failSetup(new errors_1.WebRTCError('timeout', this.attempt?.phase ?? 'offer', 'WebRTC setup timed out.'), 'timeout'), timeoutMs);
+            this.attempt = {
+                controller,
+                phase: 'offer',
+                answered: false,
+                resolve,
+                reject,
+                cleanup: () => {
+                    clearTimeout(timer);
+                    options.signal?.removeEventListener('abort', onAbort);
+                },
+            };
+            this.currentState = 'connecting';
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+            if (options.signal?.aborted) {
+                onAbort();
+                return;
+            }
+            this.connectionEvents.emit({ type: 'state.changed', state: 'connecting' });
+        });
+        const { attempt } = this;
+        if (attempt) {
+            void this.negotiate(options, attempt);
+        }
+        return result;
+    }
+    /** Idempotently closes owned native resources. It never stops application-supplied media tracks. */
+    close() {
+        if (this.attempt) {
+            this.failSetup(new errors_1.WebRTCError('aborted', this.attempt.phase, 'WebRTC setup was closed by the application.'), 'local');
+        }
+        else {
+            this.finish('local');
+        }
+    }
+    async negotiate(options, attempt) {
+        try {
+            const offer = await this.peer.createOffer();
+            if (this.attempt !== attempt) {
+                return;
+            }
+            await this.peer.setLocalDescription(offer);
+            if (this.attempt !== attempt) {
+                return;
+            }
+            const sdp = this.peer.localDescription?.sdp;
+            if (!sdp) {
+                throw new Error('The local description has no SDP.');
+            }
+            attempt.phase = 'signaling';
+            const answer = await options.exchangeSdp(sdp, { signal: attempt.controller.signal });
+            if (this.attempt !== attempt) {
+                return;
+            }
+            if (typeof answer !== 'string' || answer.length === 0) {
+                throw new TypeError('The SDP callback must return a nonempty string.');
+            }
+            attempt.phase = 'answer';
+            await this.peer.setRemoteDescription({ type: 'answer', sdp: answer });
+            if (this.attempt !== attempt) {
+                return;
+            }
+            attempt.answered = true;
+            attempt.phase = 'transport';
+            this.checkReady();
+        }
+        catch (error) {
+            if (this.attempt !== attempt) {
+                return;
+            }
+            this.failSetup(new errors_1.WebRTCError(attempt.phase === 'signaling' ? 'signaling_failed' : 'negotiation_failed', attempt.phase, 'Could not establish the WebRTC connection.', error), 'failed');
+        }
+    }
+    checkReady() {
+        const { attempt } = this;
+        if (!attempt?.answered ||
+            this.peer.connectionState !== 'connected' ||
+            this.dataChannel.readyState !== 'open') {
+            return;
+        }
+        this.attempt = undefined;
+        attempt.cleanup();
+        this.currentState = 'connected';
+        attempt.resolve();
+        this.connectionEvents.emit({ type: 'state.changed', state: 'connected' });
+    }
+    failSetup(error, reason) {
+        const { attempt } = this;
+        if (!attempt) {
+            return;
+        }
+        this.attempt = undefined;
+        attempt.cleanup();
+        attempt.reject(error);
+        // Change state and detach first: abort callbacks cannot resurrect setup.
+        this.finish(reason);
+        attempt.controller.abort(error);
+    }
+    finish(reason, error) {
+        if (this.currentState === 'closed') {
+            return;
+        }
+        this.currentState = 'closed';
+        this.peer.removeEventListener('connectionstatechange', this.onPeerState);
+        this.adapter.dispose();
+        this.peer.close();
+        if (error) {
+            this.connectionEvents.emit({ type: 'error', error, fatal: true });
+        }
+        this.connectionEvents.emit({ type: 'closed', reason });
+        this.connectionEvents.clear();
+    }
+}
+exports.WebRTCConnection = WebRTCConnection;
+//# sourceMappingURL=connection.js.map

package/lib/webrtc/connection.js.map

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

package/lib/webrtc/connection.mjs

@@ -0,0 +1,224 @@
+import { DataChannel } from "./data-channel.mjs";
+import { WebRTCError } from "./errors.mjs";
+import { Subscriptions } from "./subscriptions.mjs";
+/** Browser-native WebRTC negotiation with application-owned SDP signaling. */
+export class WebRTCConnection {
+    /** Creates native resources, but does not request media, contact a server, or begin negotiation. */
+    constructor(configuration) {
+        this.connectionEvents = new Subscriptions();
+        this.currentState = 'new';
+        this.onPeerState = () => {
+            if (this.currentState === 'closed') {
+                return;
+            }
+            if (this.peer.connectionState === 'failed' || this.peer.connectionState === 'closed') {
+                const failed = this.peer.connectionState === 'failed';
+                const error = new WebRTCError(failed ? 'transport_failed' : 'connection_closed', 'transport', 'The WebRTC peer connection ended.');
+                if (this.attempt) {
+                    this.failSetup(error, failed ? 'failed' : 'remote');
+                }
+                else {
+                    this.finish(failed ? 'failed' : 'remote', failed ? error : undefined);
+                }
+            }
+            else {
+                this.checkReady();
+            }
+        };
+        this.onChannelEvent = (event) => {
+            if (this.currentState === 'closed') {
+                return;
+            }
+            if (event.type === 'closed') {
+                if (this.attempt) {
+                    this.failSetup(new WebRTCError('connection_closed', 'transport', 'The data channel closed during setup.'), 'remote');
+                }
+                else {
+                    this.finish('remote');
+                }
+            }
+            else if (event.type === 'error') {
+                if (event.error.phase === 'transport') {
+                    if (this.attempt) {
+                        this.failSetup(event.error, 'failed');
+                    }
+                    else {
+                        this.finish('failed', event.error);
+                    }
+                }
+                else {
+                    this.connectionEvents.emit(event);
+                }
+            }
+            else {
+                this.checkReady();
+            }
+        };
+        const host = globalThis;
+        if (!host.RTCPeerConnection) {
+            throw new WebRTCError('unsupported_environment', 'transport', 'WebRTC requires a browser with RTCPeerConnection.');
+        }
+        const peer = new host.RTCPeerConnection(configuration);
+        try {
+            this.adapter = new DataChannel(peer.createDataChannel('oai-events'));
+        }
+        catch (error) {
+            peer.close();
+            throw new WebRTCError('negotiation_failed', 'transport', 'Could not create the WebRTC data channel.', error);
+        }
+        this.peer = peer;
+        this.peerConnection = peer;
+        this.dataChannel = this.adapter.dataChannel;
+        peer.addEventListener('connectionstatechange', this.onPeerState);
+        this.adapter.onConnectionEvent(this.onChannelEvent);
+    }
+    /** Current state, including before subscriptions are registered; notifications are not replayed. */
+    get state() {
+        return this.currentState;
+    }
+    /** Subscribes to one server event type with its generated payload; returns an independent unsubscribe function. */
+    on(type, handler) {
+        return this.adapter.on(type, handler);
+    }
+    /** Subscribes before connecting so initial server events are observable. API errors remain protocol data. */
+    onEvent(handler) {
+        return this.adapter.onEvent(handler);
+    }
+    /** Subscribes to local diagnostics and lifecycle. Setup failures reject connect() instead of emitting errors here. */
+    onConnectionEvent(handler) {
+        if (this.currentState === 'closed') {
+            throw new WebRTCError('invalid_state', 'transport', 'The WebRTC connection is closed.');
+        }
+        return this.connectionEvents.add(handler);
+    }
+    /** Sends without buffering; returning means local submission, not server acceptance. */
+    send(event) {
+        this.adapter.send(event);
+    }
+    /** Negotiates once and waits for both native connection and data-channel readiness. Defaults to a 30-second deadline. */
+    connect(options) {
+        if (this.currentState !== 'new') {
+            return Promise.reject(new WebRTCError('invalid_state', 'transport', 'connect() may only be called once per connection.'));
+        }
+        const timeoutMs = options.timeoutMs ?? 30000;
+        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2147483647) {
+            return Promise.reject(new WebRTCError('invalid_state', 'transport', 'timeoutMs must be a positive finite timer duration.'));
+        }
+        const controller = new AbortController();
+        // oxlint-disable-next-line promise/avoid-new -- Native readiness, timeout, and abort events settle one connection attempt.
+        const result = new Promise((resolve, reject) => {
+            const onAbort = () => this.failSetup(new WebRTCError('aborted', this.attempt?.phase ?? 'offer', 'WebRTC setup was cancelled.', options.signal?.reason), 'aborted');
+            const timer = setTimeout(() => this.failSetup(new WebRTCError('timeout', this.attempt?.phase ?? 'offer', 'WebRTC setup timed out.'), 'timeout'), timeoutMs);
+            this.attempt = {
+                controller,
+                phase: 'offer',
+                answered: false,
+                resolve,
+                reject,
+                cleanup: () => {
+                    clearTimeout(timer);
+                    options.signal?.removeEventListener('abort', onAbort);
+                },
+            };
+            this.currentState = 'connecting';
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+            if (options.signal?.aborted) {
+                onAbort();
+                return;
+            }
+            this.connectionEvents.emit({ type: 'state.changed', state: 'connecting' });
+        });
+        const { attempt } = this;
+        if (attempt) {
+            void this.negotiate(options, attempt);
+        }
+        return result;
+    }
+    /** Idempotently closes owned native resources. It never stops application-supplied media tracks. */
+    close() {
+        if (this.attempt) {
+            this.failSetup(new WebRTCError('aborted', this.attempt.phase, 'WebRTC setup was closed by the application.'), 'local');
+        }
+        else {
+            this.finish('local');
+        }
+    }
+    async negotiate(options, attempt) {
+        try {
+            const offer = await this.peer.createOffer();
+            if (this.attempt !== attempt) {
+                return;
+            }
+            await this.peer.setLocalDescription(offer);
+            if (this.attempt !== attempt) {
+                return;
+            }
+            const sdp = this.peer.localDescription?.sdp;
+            if (!sdp) {
+                throw new Error('The local description has no SDP.');
+            }
+            attempt.phase = 'signaling';
+            const answer = await options.exchangeSdp(sdp, { signal: attempt.controller.signal });
+            if (this.attempt !== attempt) {
+                return;
+            }
+            if (typeof answer !== 'string' || answer.length === 0) {
+                throw new TypeError('The SDP callback must return a nonempty string.');
+            }
+            attempt.phase = 'answer';
+            await this.peer.setRemoteDescription({ type: 'answer', sdp: answer });
+            if (this.attempt !== attempt) {
+                return;
+            }
+            attempt.answered = true;
+            attempt.phase = 'transport';
+            this.checkReady();
+        }
+        catch (error) {
+            if (this.attempt !== attempt) {
+                return;
+            }
+            this.failSetup(new WebRTCError(attempt.phase === 'signaling' ? 'signaling_failed' : 'negotiation_failed', attempt.phase, 'Could not establish the WebRTC connection.', error), 'failed');
+        }
+    }
+    checkReady() {
+        const { attempt } = this;
+        if (!attempt?.answered ||
+            this.peer.connectionState !== 'connected' ||
+            this.dataChannel.readyState !== 'open') {
+            return;
+        }
+        this.attempt = undefined;
+        attempt.cleanup();
+        this.currentState = 'connected';
+        attempt.resolve();
+        this.connectionEvents.emit({ type: 'state.changed', state: 'connected' });
+    }
+    failSetup(error, reason) {
+        const { attempt } = this;
+        if (!attempt) {
+            return;
+        }
+        this.attempt = undefined;
+        attempt.cleanup();
+        attempt.reject(error);
+        // Change state and detach first: abort callbacks cannot resurrect setup.
+        this.finish(reason);
+        attempt.controller.abort(error);
+    }
+    finish(reason, error) {
+        if (this.currentState === 'closed') {
+            return;
+        }
+        this.currentState = 'closed';
+        this.peer.removeEventListener('connectionstatechange', this.onPeerState);
+        this.adapter.dispose();
+        this.peer.close();
+        if (error) {
+            this.connectionEvents.emit({ type: 'error', error, fatal: true });
+        }
+        this.connectionEvents.emit({ type: 'closed', reason });
+        this.connectionEvents.clear();
+    }
+}
+//# sourceMappingURL=connection.mjs.map

package/lib/webrtc/connection.mjs.map

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

package/lib/webrtc/data-channel.d.mts

@@ -0,0 +1,32 @@
+import type { BrowserDataChannel, WebRTCConnectionEvent, WebRTCDataChannel } from "./types.mjs";
+/** Typed protocol messages on an application-owned native RTCDataChannel. */
+export declare class DataChannel<ClientEvent, ServerEvent extends {
+    type: string;
+}> {
+    /** The borrowed native channel. dispose() never closes it. */
+    readonly dataChannel: BrowserDataChannel;
+    private readonly channel;
+    private readonly events;
+    private readonly connectionEvents;
+    private disposed;
+    /** Attaches listeners without negotiating, opening, or taking ownership of the channel. */
+    constructor(channel: WebRTCDataChannel);
+    /** Subscribes to one server event type with its generated payload; returns an independent unsubscribe function. */
+    on<Type extends ServerEvent['type']>(type: Type, handler: (event: Extract<ServerEvent, {
+        type: Type;
+    }>) => unknown): () => void;
+    /** Subscribes to future server events, including raw API errors; returns an unsubscribe function. */
+    onEvent(handler: (event: ServerEvent) => unknown): () => void;
+    /** Observes only this channel's local errors and lifecycle, not its owning peer connection. */
+    onConnectionEvent(handler: (event: WebRTCConnectionEvent) => unknown): () => void;
+    /** Sends immediately on an open channel. Throws on local failure; API acceptance is reported by server events. */
+    send(event: ClientEvent): void;
+    /** Detaches all SDK listeners and subscriptions, without closing the channel or stopping tracks. */
+    dispose(): void;
+    private assertActive;
+    private readonly onMessage;
+    private readonly onError;
+    private readonly onOpen;
+    private readonly onClose;
+}
+//# sourceMappingURL=data-channel.d.mts.map

package/lib/webrtc/data-channel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-channel.d.mts","sourceRoot":"","sources":["../../src/lib/webrtc/data-channel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAgB;AAE5F,6EAA6E;AAC7E,qBAAa,WAAW,CAAC,WAAW,EAAE,WAAW,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IACxE,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8C;IAC/E,OAAO,CAAC,QAAQ,CAAS;IAEzB,2FAA2F;gBAC/E,OAAO,EAAE,iBAAiB;IAStC,mHAAmH;IACnH,EAAE,CAAC,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EACjC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,KAAK,OAAO,GAChE,MAAM,IAAI;IAMb,qGAAqG;IACrG,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM,IAAI;IAK7D,+FAA+F;IAC/F,iBAAiB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,GAAG,MAAM,IAAI;IAKjF,kHAAkH;IAClH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAgB9B,oGAAoG;IACpG,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CA8BxB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CActB;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAIrB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAMtB;CACH"}

package/lib/webrtc/data-channel.d.ts

@@ -0,0 +1,32 @@
+import type { BrowserDataChannel, WebRTCConnectionEvent, WebRTCDataChannel } from "./types.js";
+/** Typed protocol messages on an application-owned native RTCDataChannel. */
+export declare class DataChannel<ClientEvent, ServerEvent extends {
+    type: string;
+}> {
+    /** The borrowed native channel. dispose() never closes it. */
+    readonly dataChannel: BrowserDataChannel;
+    private readonly channel;
+    private readonly events;
+    private readonly connectionEvents;
+    private disposed;
+    /** Attaches listeners without negotiating, opening, or taking ownership of the channel. */
+    constructor(channel: WebRTCDataChannel);
+    /** Subscribes to one server event type with its generated payload; returns an independent unsubscribe function. */
+    on<Type extends ServerEvent['type']>(type: Type, handler: (event: Extract<ServerEvent, {
+        type: Type;
+    }>) => unknown): () => void;
+    /** Subscribes to future server events, including raw API errors; returns an unsubscribe function. */
+    onEvent(handler: (event: ServerEvent) => unknown): () => void;
+    /** Observes only this channel's local errors and lifecycle, not its owning peer connection. */
+    onConnectionEvent(handler: (event: WebRTCConnectionEvent) => unknown): () => void;
+    /** Sends immediately on an open channel. Throws on local failure; API acceptance is reported by server events. */
+    send(event: ClientEvent): void;
+    /** Detaches all SDK listeners and subscriptions, without closing the channel or stopping tracks. */
+    dispose(): void;
+    private assertActive;
+    private readonly onMessage;
+    private readonly onError;
+    private readonly onOpen;
+    private readonly onClose;
+}
+//# sourceMappingURL=data-channel.d.ts.map

package/lib/webrtc/data-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-channel.d.ts","sourceRoot":"","sources":["../../src/lib/webrtc/data-channel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,mBAAgB;AAE5F,6EAA6E;AAC7E,qBAAa,WAAW,CAAC,WAAW,EAAE,WAAW,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IACxE,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8C;IAC/E,OAAO,CAAC,QAAQ,CAAS;IAEzB,2FAA2F;gBAC/E,OAAO,EAAE,iBAAiB;IAStC,mHAAmH;IACnH,EAAE,CAAC,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EACjC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,KAAK,OAAO,GAChE,MAAM,IAAI;IAMb,qGAAqG;IACrG,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM,IAAI;IAK7D,+FAA+F;IAC/F,iBAAiB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,GAAG,MAAM,IAAI;IAKjF,kHAAkH;IAClH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAgB9B,oGAAoG;IACpG,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CA8BxB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CActB;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAIrB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAMtB;CACH"}