openai 7.13.0 → 7.14.0

package/lib/live/webrtc.mjs

@@ -0,0 +1,10 @@
+import { WebRTCConnection } from "../webrtc/connection.mjs";
+import { DataChannel } from "../webrtc/data-channel.mjs";
+export { WebRTCError } from "../webrtc/errors.mjs";
+/** Browser Live connection with application-owned SDP exchange and typed server-event subscriptions. */
+export class OpenAILiveWebRTC extends WebRTCConnection {
+}
+/** Typed Live events on a borrowed data channel; dispose() never closes application resources. */
+export class LiveDataChannel extends DataChannel {
+}
+//# sourceMappingURL=webrtc.mjs.map

package/lib/live/webrtc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.mjs","sourceRoot":"","sources":["../../src/lib/live/webrtc.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,iCAA6B;AACxD,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAU/C,wGAAwG;AACxG,MAAM,OAAO,gBAAiB,SAAQ,gBAA0C;CAAG;AAEnF,kGAAkG;AAClG,MAAM,OAAO,eAAgB,SAAQ,WAAqC;CAAG"}

package/lib/realtime/webrtc.d.mts

@@ -0,0 +1,13 @@
+import type { RealtimeClientEvent, RealtimeServerEvent } from "../../resources/realtime/realtime.mjs";
+import { WebRTCConnection } from "../webrtc/connection.mjs";
+import { DataChannel } from "../webrtc/data-channel.mjs";
+export { WebRTCError } from "../webrtc/errors.mjs";
+export type { WebRTCErrorCode, WebRTCErrorPhase } from "../webrtc/errors.mjs";
+export type { ExchangeSdp, WebRTCConnectOptions, WebRTCConnectionEvent, WebRTCConfiguration, WebRTCState, } from "../webrtc/types.mjs";
+/** Browser Realtime connection with application-owned SDP exchange and typed server-event subscriptions. */
+export declare class OpenAIRealtimeWebRTC extends WebRTCConnection<RealtimeClientEvent, RealtimeServerEvent> {
+}
+/** Typed Realtime events on a borrowed data channel; dispose() never closes application resources. */
+export declare class RealtimeDataChannel extends DataChannel<RealtimeClientEvent, RealtimeServerEvent> {
+}
+//# sourceMappingURL=webrtc.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.d.mts","sourceRoot":"","sources":["../../src/lib/realtime/webrtc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,8CAA0C;AAClG,OAAO,EAAE,gBAAgB,EAAE,iCAA6B;AACxD,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,6BAAyB;AAC1E,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,GACZ,4BAAwB;AAEzB,4GAA4G;AAC5G,qBAAa,oBAAqB,SAAQ,gBAAgB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CAAG;AAEvG,sGAAsG;AACtG,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CAAG"}

package/lib/realtime/webrtc.d.ts

@@ -0,0 +1,13 @@
+import type { RealtimeClientEvent, RealtimeServerEvent } from "../../resources/realtime/realtime.js";
+import { WebRTCConnection } from "../webrtc/connection.js";
+import { DataChannel } from "../webrtc/data-channel.js";
+export { WebRTCError } from "../webrtc/errors.js";
+export type { WebRTCErrorCode, WebRTCErrorPhase } from "../webrtc/errors.js";
+export type { ExchangeSdp, WebRTCConnectOptions, WebRTCConnectionEvent, WebRTCConfiguration, WebRTCState, } from "../webrtc/types.js";
+/** Browser Realtime connection with application-owned SDP exchange and typed server-event subscriptions. */
+export declare class OpenAIRealtimeWebRTC extends WebRTCConnection<RealtimeClientEvent, RealtimeServerEvent> {
+}
+/** Typed Realtime events on a borrowed data channel; dispose() never closes application resources. */
+export declare class RealtimeDataChannel extends DataChannel<RealtimeClientEvent, RealtimeServerEvent> {
+}
+//# sourceMappingURL=webrtc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.d.ts","sourceRoot":"","sources":["../../src/lib/realtime/webrtc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,6CAA0C;AAClG,OAAO,EAAE,gBAAgB,EAAE,gCAA6B;AACxD,OAAO,EAAE,WAAW,EAAE,kCAA+B;AAErD,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,4BAAyB;AAC1E,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,GACZ,2BAAwB;AAEzB,4GAA4G;AAC5G,qBAAa,oBAAqB,SAAQ,gBAAgB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CAAG;AAEvG,sGAAsG;AACtG,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CAAG"}

package/lib/realtime/webrtc.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeDataChannel = exports.OpenAIRealtimeWebRTC = exports.WebRTCError = void 0;
+const connection_1 = require("../webrtc/connection.js");
+const data_channel_1 = require("../webrtc/data-channel.js");
+var errors_1 = require("../webrtc/errors.js");
+Object.defineProperty(exports, "WebRTCError", { enumerable: true, get: function () { return errors_1.WebRTCError; } });
+/** Browser Realtime connection with application-owned SDP exchange and typed server-event subscriptions. */
+class OpenAIRealtimeWebRTC extends connection_1.WebRTCConnection {
+}
+exports.OpenAIRealtimeWebRTC = OpenAIRealtimeWebRTC;
+/** Typed Realtime events on a borrowed data channel; dispose() never closes application resources. */
+class RealtimeDataChannel extends data_channel_1.DataChannel {
+}
+exports.RealtimeDataChannel = RealtimeDataChannel;
+//# sourceMappingURL=webrtc.js.map

package/lib/realtime/webrtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.js","sourceRoot":"","sources":["../../src/lib/realtime/webrtc.ts"],"names":[],"mappings":";;;AAEA,wDAAwD;AACxD,4DAAqD;AAErD,8CAA+C;AAAtC,qGAAA,WAAW,OAAA;AAUpB,4GAA4G;AAC5G,MAAa,oBAAqB,SAAQ,6BAA0D;CAAG;AAAvG,oDAAuG;AAEvG,sGAAsG;AACtG,MAAa,mBAAoB,SAAQ,0BAAqD;CAAG;AAAjG,kDAAiG"}

package/lib/realtime/webrtc.mjs

@@ -0,0 +1,10 @@
+import { WebRTCConnection } from "../webrtc/connection.mjs";
+import { DataChannel } from "../webrtc/data-channel.mjs";
+export { WebRTCError } from "../webrtc/errors.mjs";
+/** Browser Realtime connection with application-owned SDP exchange and typed server-event subscriptions. */
+export class OpenAIRealtimeWebRTC extends WebRTCConnection {
+}
+/** Typed Realtime events on a borrowed data channel; dispose() never closes application resources. */
+export class RealtimeDataChannel extends DataChannel {
+}
+//# sourceMappingURL=webrtc.mjs.map

package/lib/realtime/webrtc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.mjs","sourceRoot":"","sources":["../../src/lib/realtime/webrtc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,iCAA6B;AACxD,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAU/C,4GAA4G;AAC5G,MAAM,OAAO,oBAAqB,SAAQ,gBAA0D;CAAG;AAEvG,sGAAsG;AACtG,MAAM,OAAO,mBAAoB,SAAQ,WAAqD;CAAG"}

package/lib/webrtc/connection.d.mts

@@ -0,0 +1,40 @@
+import type { BrowserDataChannel, BrowserPeerConnection, WebRTCConfiguration, WebRTCConnectOptions, WebRTCConnectionEvent, WebRTCState } from "./types.mjs";
+/** Browser-native WebRTC negotiation with application-owned SDP signaling. */
+export declare class WebRTCConnection<ClientEvent, ServerEvent extends {
+    type: string;
+}> {
+    /** Native peer connection; configure application-owned media before connect(). */
+    readonly peerConnection: BrowserPeerConnection;
+    /** Native ordered, reliable channel carrying protocol events. */
+    readonly dataChannel: BrowserDataChannel;
+    private readonly peer;
+    private readonly adapter;
+    private readonly connectionEvents;
+    private currentState;
+    private attempt;
+    /** Creates native resources, but does not request media, contact a server, or begin negotiation. */
+    constructor(configuration?: WebRTCConfiguration);
+    /** Current state, including before subscriptions are registered; notifications are not replayed. */
+    get state(): WebRTCState;
+    /** 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 before connecting so initial server events are observable. API errors remain protocol data. */
+    onEvent(handler: (event: ServerEvent) => unknown): () => void;
+    /** Subscribes to local diagnostics and lifecycle. Setup failures reject connect() instead of emitting errors here. */
+    onConnectionEvent(handler: (event: WebRTCConnectionEvent) => unknown): () => void;
+    /** Sends without buffering; returning means local submission, not server acceptance. */
+    send(event: ClientEvent): void;
+    /** Negotiates once and waits for both native connection and data-channel readiness. Defaults to a 30-second deadline. */
+    connect(options: WebRTCConnectOptions): Promise<void>;
+    /** Idempotently closes owned native resources. It never stops application-supplied media tracks. */
+    close(): void;
+    private negotiate;
+    private checkReady;
+    private failSetup;
+    private finish;
+    private readonly onPeerState;
+    private readonly onChannelEvent;
+}
+//# sourceMappingURL=connection.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.mts","sourceRoot":"","sources":["../../src/lib/webrtc/connection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EAGrB,WAAW,EACZ,oBAAgB;AAWjB,8EAA8E;AAC9E,qBAAa,gBAAgB,CAAC,WAAW,EAAE,WAAW,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IAC7E,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8C;IAC/E,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,OAAO,CAAsB;IAErC,oGAAoG;gBACxF,aAAa,CAAC,EAAE,mBAAmB;IA8B/C,oGAAoG;IACpG,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,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;IAIb,6GAA6G;IAC7G,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM,IAAI;IAI7D,sHAAsH;IACtH,iBAAiB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,GAAG,MAAM,IAAI;IAOjF,wFAAwF;IACxF,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAI9B,yHAAyH;IACzH,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DrD,oGAAoG;IACpG,KAAK,IAAI,IAAI;YAWC,SAAS;IA8CvB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,QAAQ,CAAC,WAAW,CAmB1B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CA0B7B;CACH"}

package/lib/webrtc/connection.d.ts

@@ -0,0 +1,40 @@
+import type { BrowserDataChannel, BrowserPeerConnection, WebRTCConfiguration, WebRTCConnectOptions, WebRTCConnectionEvent, WebRTCState } from "./types.js";
+/** Browser-native WebRTC negotiation with application-owned SDP signaling. */
+export declare class WebRTCConnection<ClientEvent, ServerEvent extends {
+    type: string;
+}> {
+    /** Native peer connection; configure application-owned media before connect(). */
+    readonly peerConnection: BrowserPeerConnection;
+    /** Native ordered, reliable channel carrying protocol events. */
+    readonly dataChannel: BrowserDataChannel;
+    private readonly peer;
+    private readonly adapter;
+    private readonly connectionEvents;
+    private currentState;
+    private attempt;
+    /** Creates native resources, but does not request media, contact a server, or begin negotiation. */
+    constructor(configuration?: WebRTCConfiguration);
+    /** Current state, including before subscriptions are registered; notifications are not replayed. */
+    get state(): WebRTCState;
+    /** 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 before connecting so initial server events are observable. API errors remain protocol data. */
+    onEvent(handler: (event: ServerEvent) => unknown): () => void;
+    /** Subscribes to local diagnostics and lifecycle. Setup failures reject connect() instead of emitting errors here. */
+    onConnectionEvent(handler: (event: WebRTCConnectionEvent) => unknown): () => void;
+    /** Sends without buffering; returning means local submission, not server acceptance. */
+    send(event: ClientEvent): void;
+    /** Negotiates once and waits for both native connection and data-channel readiness. Defaults to a 30-second deadline. */
+    connect(options: WebRTCConnectOptions): Promise<void>;
+    /** Idempotently closes owned native resources. It never stops application-supplied media tracks. */
+    close(): void;
+    private negotiate;
+    private checkReady;
+    private failSetup;
+    private finish;
+    private readonly onPeerState;
+    private readonly onChannelEvent;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/lib/webrtc/connection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EAGrB,WAAW,EACZ,mBAAgB;AAWjB,8EAA8E;AAC9E,qBAAa,gBAAgB,CAAC,WAAW,EAAE,WAAW,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IAC7E,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8C;IAC/E,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,OAAO,CAAsB;IAErC,oGAAoG;gBACxF,aAAa,CAAC,EAAE,mBAAmB;IA8B/C,oGAAoG;IACpG,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,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;IAIb,6GAA6G;IAC7G,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM,IAAI;IAI7D,sHAAsH;IACtH,iBAAiB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,GAAG,MAAM,IAAI;IAOjF,wFAAwF;IACxF,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAI9B,yHAAyH;IACzH,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DrD,oGAAoG;IACpG,KAAK,IAAI,IAAI;YAWC,SAAS;IA8CvB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,QAAQ,CAAC,WAAW,CAmB1B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CA0B7B;CACH"}

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