@rebyteai/agent-sdk 0.2.0

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"}

package/lib/webrtc/data-channel.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataChannel = void 0;
+const errors_1 = require("./errors.js");
+const subscriptions_1 = require("./subscriptions.js");
+/** Typed protocol messages on an application-owned native RTCDataChannel. */
+class DataChannel {
+    /** Attaches listeners without negotiating, opening, or taking ownership of the channel. */
+    constructor(channel) {
+        this.events = new subscriptions_1.Subscriptions();
+        this.connectionEvents = new subscriptions_1.Subscriptions();
+        this.disposed = false;
+        this.onMessage = (message) => {
+            if (this.disposed) {
+                return;
+            }
+            let event;
+            try {
+                const { data } = message;
+                if (typeof data !== 'string') {
+                    throw new TypeError('Invalid protocol message.');
+                }
+                event = JSON.parse(data);
+                if (typeof event !== 'object' ||
+                    event === null ||
+                    Array.isArray(event) ||
+                    typeof Object.getOwnPropertyDescriptor(event, 'type')?.value !== 'string') {
+                    throw new TypeError('Invalid protocol message.');
+                }
+            }
+            catch {
+                // JSON SyntaxErrors can contain the payload. Do not retain their cause.
+                this.connectionEvents.emit({
+                    type: 'error',
+                    fatal: false,
+                    error: new errors_1.WebRTCError('invalid_message', 'message', 'Received an invalid WebRTC protocol message.'),
+                });
+                return;
+            }
+            // Like the generated SDK, accept future event types without a runtime schema registry.
+            this.events.emit(event);
+        };
+        this.onError = (cause) => {
+            if (this.disposed) {
+                return;
+            }
+            this.connectionEvents.emit({
+                type: 'error',
+                fatal: false,
+                error: new errors_1.WebRTCError('transport_failed', 'transport', 'The WebRTC data channel reported an error.', cause),
+            });
+        };
+        this.onOpen = () => {
+            if (!this.disposed) {
+                this.connectionEvents.emit({ type: 'state.changed', state: 'connected' });
+            }
+        };
+        this.onClose = () => {
+            if (this.disposed) {
+                return;
+            }
+            this.connectionEvents.emit({ type: 'closed', reason: 'remote' });
+            this.dispose();
+        };
+        this.channel = channel;
+        this.dataChannel = channel;
+        channel.addEventListener('message', this.onMessage);
+        channel.addEventListener('error', this.onError);
+        channel.addEventListener('open', this.onOpen);
+        channel.addEventListener('close', this.onClose);
+    }
+    /** Subscribes to one server event type with its generated payload; returns an independent unsubscribe function. */
+    on(type, handler) {
+        this.assertActive();
+        // The shared dispatcher matches the original discriminator before invoking this callback.
+        return this.events.add((event) => handler(event), type);
+    }
+    /** Subscribes to future server events, including raw API errors; returns an unsubscribe function. */
+    onEvent(handler) {
+        this.assertActive();
+        return this.events.add(handler);
+    }
+    /** Observes only this channel's local errors and lifecycle, not its owning peer connection. */
+    onConnectionEvent(handler) {
+        this.assertActive();
+        return this.connectionEvents.add(handler);
+    }
+    /** Sends immediately on an open channel. Throws on local failure; API acceptance is reported by server events. */
+    send(event) {
+        this.assertActive();
+        if (this.channel.readyState !== 'open') {
+            throw new errors_1.WebRTCError('not_open', 'send', 'The WebRTC data channel is not open.');
+        }
+        try {
+            const data = JSON.stringify(event);
+            if (data === undefined) {
+                throw new TypeError('The event is not JSON serializable.');
+            }
+            this.channel.send(data);
+        }
+        catch (error) {
+            throw new errors_1.WebRTCError('send_failed', 'send', 'Could not send the WebRTC event.', error);
+        }
+    }
+    /** Detaches all SDK listeners and subscriptions, without closing the channel or stopping tracks. */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.channel.removeEventListener('message', this.onMessage);
+        this.channel.removeEventListener('error', this.onError);
+        this.channel.removeEventListener('open', this.onOpen);
+        this.channel.removeEventListener('close', this.onClose);
+        this.events.clear();
+        this.connectionEvents.clear();
+    }
+    assertActive() {
+        if (this.disposed) {
+            throw new errors_1.WebRTCError('invalid_state', 'transport', 'The WebRTC data-channel adapter is disposed.');
+        }
+    }
+}
+exports.DataChannel = DataChannel;
+//# sourceMappingURL=data-channel.js.map

package/lib/webrtc/data-channel.js.map

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

package/lib/webrtc/data-channel.mjs

@@ -0,0 +1,121 @@
+import { WebRTCError } from "./errors.mjs";
+import { Subscriptions } from "./subscriptions.mjs";
+/** Typed protocol messages on an application-owned native RTCDataChannel. */
+export class DataChannel {
+    /** Attaches listeners without negotiating, opening, or taking ownership of the channel. */
+    constructor(channel) {
+        this.events = new Subscriptions();
+        this.connectionEvents = new Subscriptions();
+        this.disposed = false;
+        this.onMessage = (message) => {
+            if (this.disposed) {
+                return;
+            }
+            let event;
+            try {
+                const { data } = message;
+                if (typeof data !== 'string') {
+                    throw new TypeError('Invalid protocol message.');
+                }
+                event = JSON.parse(data);
+                if (typeof event !== 'object' ||
+                    event === null ||
+                    Array.isArray(event) ||
+                    typeof Object.getOwnPropertyDescriptor(event, 'type')?.value !== 'string') {
+                    throw new TypeError('Invalid protocol message.');
+                }
+            }
+            catch {
+                // JSON SyntaxErrors can contain the payload. Do not retain their cause.
+                this.connectionEvents.emit({
+                    type: 'error',
+                    fatal: false,
+                    error: new WebRTCError('invalid_message', 'message', 'Received an invalid WebRTC protocol message.'),
+                });
+                return;
+            }
+            // Like the generated SDK, accept future event types without a runtime schema registry.
+            this.events.emit(event);
+        };
+        this.onError = (cause) => {
+            if (this.disposed) {
+                return;
+            }
+            this.connectionEvents.emit({
+                type: 'error',
+                fatal: false,
+                error: new WebRTCError('transport_failed', 'transport', 'The WebRTC data channel reported an error.', cause),
+            });
+        };
+        this.onOpen = () => {
+            if (!this.disposed) {
+                this.connectionEvents.emit({ type: 'state.changed', state: 'connected' });
+            }
+        };
+        this.onClose = () => {
+            if (this.disposed) {
+                return;
+            }
+            this.connectionEvents.emit({ type: 'closed', reason: 'remote' });
+            this.dispose();
+        };
+        this.channel = channel;
+        this.dataChannel = channel;
+        channel.addEventListener('message', this.onMessage);
+        channel.addEventListener('error', this.onError);
+        channel.addEventListener('open', this.onOpen);
+        channel.addEventListener('close', this.onClose);
+    }
+    /** Subscribes to one server event type with its generated payload; returns an independent unsubscribe function. */
+    on(type, handler) {
+        this.assertActive();
+        // The shared dispatcher matches the original discriminator before invoking this callback.
+        return this.events.add((event) => handler(event), type);
+    }
+    /** Subscribes to future server events, including raw API errors; returns an unsubscribe function. */
+    onEvent(handler) {
+        this.assertActive();
+        return this.events.add(handler);
+    }
+    /** Observes only this channel's local errors and lifecycle, not its owning peer connection. */
+    onConnectionEvent(handler) {
+        this.assertActive();
+        return this.connectionEvents.add(handler);
+    }
+    /** Sends immediately on an open channel. Throws on local failure; API acceptance is reported by server events. */
+    send(event) {
+        this.assertActive();
+        if (this.channel.readyState !== 'open') {
+            throw new WebRTCError('not_open', 'send', 'The WebRTC data channel is not open.');
+        }
+        try {
+            const data = JSON.stringify(event);
+            if (data === undefined) {
+                throw new TypeError('The event is not JSON serializable.');
+            }
+            this.channel.send(data);
+        }
+        catch (error) {
+            throw new WebRTCError('send_failed', 'send', 'Could not send the WebRTC event.', error);
+        }
+    }
+    /** Detaches all SDK listeners and subscriptions, without closing the channel or stopping tracks. */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.channel.removeEventListener('message', this.onMessage);
+        this.channel.removeEventListener('error', this.onError);
+        this.channel.removeEventListener('open', this.onOpen);
+        this.channel.removeEventListener('close', this.onClose);
+        this.events.clear();
+        this.connectionEvents.clear();
+    }
+    assertActive() {
+        if (this.disposed) {
+            throw new WebRTCError('invalid_state', 'transport', 'The WebRTC data-channel adapter is disposed.');
+        }
+    }
+}
+//# sourceMappingURL=data-channel.mjs.map

package/lib/webrtc/data-channel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-channel.mjs","sourceRoot":"","sources":["../../src/lib/webrtc/data-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAiB;AACvC,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAGhD,6EAA6E;AAC7E,MAAM,OAAO,WAAW;IAQtB,2FAA2F;IAC3F,YAAY,OAA0B;QALrB,WAAM,GAAG,IAAI,aAAa,EAAe,CAAC;QAC1C,qBAAgB,GAAG,IAAI,aAAa,EAAyB,CAAC;QACvE,aAAQ,GAAG,KAAK,CAAC;QAuER,cAAS,GAAG,CAAC,OAAgB,EAAQ,EAAE;YACtD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,KAAc,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,GAAG,OAA6B,CAAC;gBAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC7B,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;gBACnD,CAAC;gBACD,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,IACE,OAAO,KAAK,KAAK,QAAQ;oBACzB,KAAK,KAAK,IAAI;oBACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBACpB,OAAO,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,KAAK,QAAQ,EACzE,CAAC;oBACD,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;gBACxE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;oBACzB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,IAAI,WAAW,CAAC,iBAAiB,EAAE,SAAS,EAAE,8CAA8C,CAAC;iBACrG,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,uFAAuF;YACvF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAoB,CAAC,CAAC;QACzC,CAAC,CAAC;QAEe,YAAO,GAAG,CAAC,KAAc,EAAQ,EAAE;YAClD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBACzB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,IAAI,WAAW,CACpB,kBAAkB,EAClB,WAAW,EACX,4CAA4C,EAC5C,KAAK,CACN;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEe,WAAM,GAAG,GAAS,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC;QAEe,YAAO,GAAG,GAAS,EAAE;YACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC;QA/HA,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,OAA6B,CAAC;QACjD,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,mHAAmH;IACnH,EAAE,CACA,IAAU,EACV,OAAiE;QAEjE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,0FAA0F;QAC1F,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAA6C,CAAC,EAAE,IAAI,CAAC,CAAC;IAClG,CAAC;IAED,qGAAqG;IACrG,OAAO,CAAC,OAAwC;QAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,+FAA+F;IAC/F,iBAAiB,CAAC,OAAkD;QAClE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,kHAAkH;IAClH,IAAI,CAAC,KAAkB;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YACvC,MAAM,IAAI,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,sCAAsC,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,kCAAkC,EAAE,KAAK,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,oGAAoG;IACpG,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,WAAW,CAAC,eAAe,EAAE,WAAW,EAAE,8CAA8C,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;CA+DF"}

package/lib/webrtc/errors.d.mts

@@ -0,0 +1,19 @@
+import { OpenAIError } from "../../core/error.mjs";
+/** Stable classifications of local WebRTC failures, independent of API error codes. */
+export type WebRTCErrorCode = 'invalid_state' | 'not_open' | 'send_failed' | 'invalid_message' | 'signaling_failed' | 'negotiation_failed' | 'transport_failed' | 'connection_closed' | 'timeout' | 'aborted' | 'unsupported_environment';
+/** The operation in which a local error originated. */
+export type WebRTCErrorPhase = 'offer' | 'signaling' | 'answer' | 'transport' | 'message' | 'send';
+/** A local SDK/transport failure. Server error events remain unchanged in onEvent(). */
+export declare class WebRTCError extends OpenAIError {
+    /** Distinguishes this error from API errors and application callback exceptions. */
+    readonly name = "WebRTCError";
+    /** Stable failure classification, suitable for detecting expected cancellation. */
+    readonly code: WebRTCErrorCode;
+    /** The failing setup, transport, or message operation. */
+    readonly phase: WebRTCErrorPhase;
+    /** Original exception or abort reason. It may contain application-sensitive details; do not log blindly. */
+    readonly cause: unknown;
+    /** Creates a safe diagnostic while retaining the original cause separately. */
+    constructor(code: WebRTCErrorCode, phase: WebRTCErrorPhase, message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.mts.map

package/lib/webrtc/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../../src/lib/webrtc/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,uFAAuF;AACvF,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,SAAS,GACT,SAAS,GACT,yBAAyB,CAAC;AAE9B,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnG,wFAAwF;AACxF,qBAAa,WAAY,SAAQ,WAAW;IAC1C,oFAAoF;IACpF,SAAkB,IAAI,iBAAiB;IACvC,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,+EAA+E;gBACnE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7F"}

package/lib/webrtc/errors.d.ts

@@ -0,0 +1,19 @@
+import { OpenAIError } from "../../core/error.js";
+/** Stable classifications of local WebRTC failures, independent of API error codes. */
+export type WebRTCErrorCode = 'invalid_state' | 'not_open' | 'send_failed' | 'invalid_message' | 'signaling_failed' | 'negotiation_failed' | 'transport_failed' | 'connection_closed' | 'timeout' | 'aborted' | 'unsupported_environment';
+/** The operation in which a local error originated. */
+export type WebRTCErrorPhase = 'offer' | 'signaling' | 'answer' | 'transport' | 'message' | 'send';
+/** A local SDK/transport failure. Server error events remain unchanged in onEvent(). */
+export declare class WebRTCError extends OpenAIError {
+    /** Distinguishes this error from API errors and application callback exceptions. */
+    readonly name = "WebRTCError";
+    /** Stable failure classification, suitable for detecting expected cancellation. */
+    readonly code: WebRTCErrorCode;
+    /** The failing setup, transport, or message operation. */
+    readonly phase: WebRTCErrorPhase;
+    /** Original exception or abort reason. It may contain application-sensitive details; do not log blindly. */
+    readonly cause: unknown;
+    /** Creates a safe diagnostic while retaining the original cause separately. */
+    constructor(code: WebRTCErrorCode, phase: WebRTCErrorPhase, message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/webrtc/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/webrtc/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAE/C,uFAAuF;AACvF,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,SAAS,GACT,SAAS,GACT,yBAAyB,CAAC;AAE9B,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnG,wFAAwF;AACxF,qBAAa,WAAY,SAAQ,WAAW;IAC1C,oFAAoF;IACpF,SAAkB,IAAI,iBAAiB;IACvC,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,+EAA+E;gBACnE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7F"}