openai 7.13.0 → 7.15.0

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

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

package/lib/webrtc/errors.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebRTCError = void 0;
+const error_1 = require("../../core/error.js");
+/** A local SDK/transport failure. Server error events remain unchanged in onEvent(). */
+class WebRTCError extends error_1.OpenAIError {
+    /** Creates a safe diagnostic while retaining the original cause separately. */
+    constructor(code, phase, message, cause) {
+        super(message);
+        /** Distinguishes this error from API errors and application callback exceptions. */
+        this.name = 'WebRTCError';
+        this.code = code;
+        this.phase = phase;
+        this.cause = cause;
+    }
+}
+exports.WebRTCError = WebRTCError;
+//# sourceMappingURL=errors.js.map

package/lib/webrtc/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/webrtc/errors.ts"],"names":[],"mappings":";;;AAAA,+CAA+C;AAmB/C,wFAAwF;AACxF,MAAa,WAAY,SAAQ,mBAAW;IAU1C,+EAA+E;IAC/E,YAAY,IAAqB,EAAE,KAAuB,EAAE,OAAe,EAAE,KAAe;QAC1F,KAAK,CAAC,OAAO,CAAC,CAAC;QAXjB,oFAAoF;QAClE,SAAI,GAAG,aAAa,CAAC;QAWrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAjBD,kCAiBC"}

package/lib/webrtc/errors.mjs

@@ -0,0 +1,14 @@
+import { OpenAIError } from "../../core/error.mjs";
+/** A local SDK/transport failure. Server error events remain unchanged in onEvent(). */
+export class WebRTCError extends OpenAIError {
+    /** Creates a safe diagnostic while retaining the original cause separately. */
+    constructor(code, phase, message, cause) {
+        super(message);
+        /** Distinguishes this error from API errors and application callback exceptions. */
+        this.name = 'WebRTCError';
+        this.code = code;
+        this.phase = phase;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=errors.mjs.map

package/lib/webrtc/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../../src/lib/webrtc/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAmB/C,wFAAwF;AACxF,MAAM,OAAO,WAAY,SAAQ,WAAW;IAU1C,+EAA+E;IAC/E,YAAY,IAAqB,EAAE,KAAuB,EAAE,OAAe,EAAE,KAAe;QAC1F,KAAK,CAAC,OAAO,CAAC,CAAC;QAXjB,oFAAoF;QAClE,SAAI,GAAG,aAAa,CAAC;QAWrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/lib/webrtc/subscriptions.d.mts

@@ -0,0 +1,13 @@
+/** Internal callback subscriptions with optional discriminator filters; no buffering or replay. */
+export declare class Subscriptions<Event extends {
+    type: string;
+}> {
+    private readonly listeners;
+    /** Registers independently, including when the same function is supplied twice. */
+    add(listener: (event: Event) => unknown, type?: Event['type']): () => void;
+    /** Delivers in registration order, isolating application exceptions from the transport. */
+    emit(event: Event): void;
+    /** Releases all subscriber references. Existing unsubscribe functions remain safe. */
+    clear(): void;
+}
+//# sourceMappingURL=subscriptions.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.mts","sourceRoot":"","sources":["../../src/lib/webrtc/subscriptions.ts"],"names":[],"mappings":"AAmBA,mGAAmG;AACnG,qBAAa,aAAa,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGrB;IAEL,mFAAmF;IACnF,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI;IAQ1E,2FAA2F;IAC3F,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAqBxB,sFAAsF;IACtF,KAAK,IAAI,IAAI;CAGd"}

package/lib/webrtc/subscriptions.d.ts

@@ -0,0 +1,13 @@
+/** Internal callback subscriptions with optional discriminator filters; no buffering or replay. */
+export declare class Subscriptions<Event extends {
+    type: string;
+}> {
+    private readonly listeners;
+    /** Registers independently, including when the same function is supplied twice. */
+    add(listener: (event: Event) => unknown, type?: Event['type']): () => void;
+    /** Delivers in registration order, isolating application exceptions from the transport. */
+    emit(event: Event): void;
+    /** Releases all subscriber references. Existing unsubscribe functions remain safe. */
+    clear(): void;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/lib/webrtc/subscriptions.ts"],"names":[],"mappings":"AAmBA,mGAAmG;AACnG,qBAAa,aAAa,CAAC,KAAK,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGrB;IAEL,mFAAmF;IACnF,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI;IAQ1E,2FAA2F;IAC3F,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAqBxB,sFAAsF;IACtF,KAAK,IAAI,IAAI;CAGd"}

package/lib/webrtc/subscriptions.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subscriptions = void 0;
+function reportApplicationError(error) {
+    const host = globalThis;
+    if (typeof host.reportError === 'function') {
+        host.reportError(error);
+    }
+    else {
+        setTimeout(() => {
+            throw error;
+        }, 0);
+    }
+}
+async function observeResult(result) {
+    try {
+        await result;
+    }
+    catch (error) {
+        reportApplicationError(error);
+    }
+}
+/** Internal callback subscriptions with optional discriminator filters; no buffering or replay. */
+class Subscriptions {
+    constructor() {
+        this.listeners = new Set();
+    }
+    /** Registers independently, including when the same function is supplied twice. */
+    add(listener, type) {
+        const registration = { listener, type };
+        this.listeners.add(registration);
+        return () => {
+            this.listeners.delete(registration);
+        };
+    }
+    /** Delivers in registration order, isolating application exceptions from the transport. */
+    emit(event) {
+        const { type } = event;
+        const snapshot = [...this.listeners];
+        for (const registration of snapshot) {
+            if (!this.listeners.has(registration) ||
+                (registration.type !== undefined && registration.type !== type)) {
+                continue;
+            }
+            try {
+                const result = registration.listener(event);
+                if (result !== null && (typeof result === 'object' || typeof result === 'function')) {
+                    void observeResult(result);
+                }
+            }
+            catch (error) {
+                reportApplicationError(error);
+            }
+        }
+    }
+    /** Releases all subscriber references. Existing unsubscribe functions remain safe. */
+    clear() {
+        this.listeners.clear();
+    }
+}
+exports.Subscriptions = Subscriptions;
+//# sourceMappingURL=subscriptions.js.map

package/lib/webrtc/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/lib/webrtc/subscriptions.ts"],"names":[],"mappings":";;;AAAA,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,IAAI,GAAG,UAA4E,CAAC;IAC1F,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,KAAK,CAAC;QACd,CAAC,EAAE,CAAC,CAAC,CAAC;IACR,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAa,aAAa;IAA1B;QACmB,cAAS,GAAG,IAAI,GAAG,EAGhC,CAAC;IAqCP,CAAC;IAnCC,mFAAmF;IACnF,GAAG,CAAC,QAAmC,EAAE,IAAoB;QAC3D,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC,CAAC;IACJ,CAAC;IAED,2FAA2F;IAC3F,IAAI,CAAC,KAAY;QACf,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,KAAK,MAAM,YAAY,IAAI,QAAQ,EAAE,CAAC;YACpC,IACE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;gBACjC,CAAC,YAAY,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,KAAK,IAAI,CAAC,EAC/D,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;oBACpF,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAzCD,sCAyCC"}

package/lib/webrtc/subscriptions.mjs

@@ -0,0 +1,58 @@
+function reportApplicationError(error) {
+    const host = globalThis;
+    if (typeof host.reportError === 'function') {
+        host.reportError(error);
+    }
+    else {
+        setTimeout(() => {
+            throw error;
+        }, 0);
+    }
+}
+async function observeResult(result) {
+    try {
+        await result;
+    }
+    catch (error) {
+        reportApplicationError(error);
+    }
+}
+/** Internal callback subscriptions with optional discriminator filters; no buffering or replay. */
+export class Subscriptions {
+    constructor() {
+        this.listeners = new Set();
+    }
+    /** Registers independently, including when the same function is supplied twice. */
+    add(listener, type) {
+        const registration = { listener, type };
+        this.listeners.add(registration);
+        return () => {
+            this.listeners.delete(registration);
+        };
+    }
+    /** Delivers in registration order, isolating application exceptions from the transport. */
+    emit(event) {
+        const { type } = event;
+        const snapshot = [...this.listeners];
+        for (const registration of snapshot) {
+            if (!this.listeners.has(registration) ||
+                (registration.type !== undefined && registration.type !== type)) {
+                continue;
+            }
+            try {
+                const result = registration.listener(event);
+                if (result !== null && (typeof result === 'object' || typeof result === 'function')) {
+                    void observeResult(result);
+                }
+            }
+            catch (error) {
+                reportApplicationError(error);
+            }
+        }
+    }
+    /** Releases all subscriber references. Existing unsubscribe functions remain safe. */
+    clear() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=subscriptions.mjs.map

package/lib/webrtc/subscriptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.mjs","sourceRoot":"","sources":["../../src/lib/webrtc/subscriptions.ts"],"names":[],"mappings":"AAAA,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,IAAI,GAAG,UAA4E,CAAC;IAC1F,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,KAAK,CAAC;QACd,CAAC,EAAE,CAAC,CAAC,CAAC;IACR,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAe;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,OAAO,aAAa;IAA1B;QACmB,cAAS,GAAG,IAAI,GAAG,EAGhC,CAAC;IAqCP,CAAC;IAnCC,mFAAmF;IACnF,GAAG,CAAC,QAAmC,EAAE,IAAoB;QAC3D,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC,CAAC;IACJ,CAAC;IAED,2FAA2F;IAC3F,IAAI,CAAC,KAAY;QACf,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,KAAK,MAAM,YAAY,IAAI,QAAQ,EAAE,CAAC;YACpC,IACE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;gBACjC,CAAC,YAAY,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,KAAK,IAAI,CAAC,EAC/D,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;oBACpF,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/lib/webrtc/types.d.mts

@@ -0,0 +1,99 @@
+import type { WebRTCError } from "./errors.mjs";
+/** A native event source, without requiring DOM declarations in server projects. */
+export interface WebRTCEventTarget {
+    /** Registers a native event listener. */
+    addEventListener: (type: string, listener: (event: unknown) => void) => void;
+    /** Removes a previously registered native event listener. */
+    removeEventListener: (type: string, listener: (event: unknown) => void) => void;
+}
+/** The subset of a native data channel used by the SDK. */
+export interface WebRTCDataChannel extends WebRTCEventTarget {
+    /** Native channel readiness; sending requires `open`. */
+    readonly readyState: string;
+    /** Sends one serialized protocol message. */
+    send: (data: string) => void;
+    /** Closes this channel. Borrowed adapters never call this method. */
+    close: () => void;
+}
+/** The subset of a native peer connection used by negotiation. */
+export interface WebRTCPeerConnection extends WebRTCEventTarget {
+    /** Native connection state, including transient `disconnected` states. */
+    readonly connectionState: string;
+    /** The local description after `setLocalDescription`. */
+    readonly localDescription: {
+        readonly sdp: string;
+    } | null;
+    /** Creates the protocol data channel before generating an SDP offer. */
+    createDataChannel: (label: string) => WebRTCDataChannel;
+    /** Generates the local SDP offer. */
+    createOffer: () => Promise<{
+        type: 'answer' | 'offer' | 'pranswer' | 'rollback';
+        sdp?: string;
+    }>;
+    /** Applies the offer to the local peer. */
+    setLocalDescription: (description: {
+        type?: 'answer' | 'offer' | 'pranswer' | 'rollback';
+        sdp?: string;
+    }) => Promise<void>;
+    /** Applies the application's SDP answer. */
+    setRemoteDescription: (description: {
+        type: 'answer';
+        sdp: string;
+    }) => Promise<void>;
+    /** Releases the peer connection, without stopping application-owned tracks. */
+    close: () => void;
+}
+/** Native browser peer type when DOM types are available; otherwise the SDK's minimal view. */
+export type BrowserPeerConnection = typeof globalThis extends {
+    RTCPeerConnection: {
+        prototype: infer Peer;
+    };
+} ? Peer : WebRTCPeerConnection;
+/** Native browser channel type when DOM types are available. */
+export type BrowserDataChannel = typeof globalThis extends {
+    RTCDataChannel: {
+        prototype: infer Channel;
+    };
+} ? Channel : WebRTCDataChannel;
+/** Standard RTCConfiguration in a browser project; no runtime polyfill is installed. */
+export type WebRTCConfiguration = typeof globalThis extends {
+    RTCPeerConnection: new (configuration?: infer Configuration) => unknown;
+} ? Configuration : object;
+/** Exchanges a local SDP offer for an SDP answer using application-owned signaling. */
+export type ExchangeSdp = (offer: string, options: {
+    /** Aborted when setup is cancelled, times out, or fails; pass it to fetch. */
+    signal: AbortSignal;
+}) => Promise<string>;
+/** Options for one connection attempt. No retries or reconnection are performed. */
+export interface WebRTCConnectOptions {
+    /** Application callback that submits the offer and returns the SDP answer. */
+    exchangeSdp: ExchangeSdp;
+    /** Cancels setup only. After connection succeeds, use close() to end the connection. */
+    signal?: AbortSignal;
+    /** Total setup deadline in milliseconds; defaults to 30,000. Must be positive and finite. */
+    timeoutMs?: number;
+}
+/** SDK connection state. A closed instance cannot be connected again. */
+export type WebRTCState = 'new' | 'connecting' | 'connected' | 'closed';
+/** Why a connection ended. Setup failures are also returned by connect(). */
+export type WebRTCCloseReason = 'local' | 'remote' | 'failed' | 'aborted' | 'timeout';
+/** Local lifecycle and diagnostics, separate from server protocol events. */
+export type WebRTCConnectionEvent = {
+    /** A connection became usable or began setup. */
+    type: 'state.changed';
+    /** The new state. There is no replay on subscription. */
+    state: 'connecting' | 'connected';
+} | {
+    /** An unsolicited local failure, not an API error event. */
+    type: 'error';
+    /** The local diagnostic. Messages never contain raw protocol payloads. */
+    error: WebRTCError;
+    /** Whether the managed helper is ending this connection. */
+    fatal: boolean;
+} | {
+    /** The connection ended; emitted at most once. */
+    type: 'closed';
+    /** Whether closure was requested, observed, or caused by a setup/transport failure. */
+    reason: WebRTCCloseReason;
+};
+//# sourceMappingURL=types.d.mts.map

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

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