@gjsify/webrtc 0.4.0 → 0.4.3

package/src/rtc-dtmf-sender.ts

@@ -1,146 +0,0 @@
-// W3C RTCDTMFSender for GJS.
-//
-// Implements tone insertion, validation, and tonechange event dispatch.
-// Actual DTMF RTP packet generation requires GStreamer dtmfsrc integration
-// (Phase 4.6+); the timer-based event loop is spec-compliant regardless.
-//
-// Reference: W3C WebRTC spec § 7
-// Reference: refs/wpt/webrtc/RTCDTMFSender-insertDTMF.https.html
-// Reference: refs/wpt/webrtc/RTCDTMFSender-helper.js
-
-import '@gjsify/dom-events/register/event-target';
-
-const VALID_DTMF_CHARS = new Set('0123456789ABCDabcd#*,');
-const MIN_DURATION = 40;
-const MAX_DURATION = 6000;
-const DEFAULT_DURATION = 100;
-const MIN_INTER_TONE_GAP = 30;
-const DEFAULT_INTER_TONE_GAP = 70;
-const COMMA_DELAY = 2000;
-
-type EventHandler = ((ev: Event) => void) | null;
-
-export interface RTCDTMFToneChangeEventInit extends EventInit {
-    tone?: string;
-}
-
-export class RTCDTMFToneChangeEvent extends Event {
-    readonly tone: string;
-
-    constructor(type: string, init: RTCDTMFToneChangeEventInit = {}) {
-        super(type, init);
-        this.tone = init.tone ?? '';
-    }
-}
-
-export class RTCDTMFSender extends EventTarget {
-    private _toneBuffer = '';
-    private _duration = DEFAULT_DURATION;
-    private _interToneGap = DEFAULT_INTER_TONE_GAP;
-    private _timerId: ReturnType<typeof setTimeout> | null = null;
-    private _canInsert = true;
-    private _ontonechange: EventHandler = null;
-
-    /** @internal — back-references set by RTCRtpSender */
-    _isStopped: () => boolean = () => false;
-    _getCurrentDirection: () => string | null = () => null;
-
-    get toneBuffer(): string { return this._toneBuffer; }
-    get canInsertDTMF(): boolean { return this._canInsert; }
-
-    get ontonechange(): EventHandler { return this._ontonechange; }
-    set ontonechange(v: EventHandler) { this._ontonechange = v; }
-
-    insertDTMF(tones: string, duration?: number, interToneGap?: number): void {
-        // Step 3: If transceiver.stopped is true, throw InvalidStateError
-        if (this._isStopped()) {
-            throw new DOMException(
-                "Failed to execute 'insertDTMF': The associated transceiver is stopped",
-                'InvalidStateError',
-            );
-        }
-
-        // Step 4: If currentDirection is recvonly or inactive, throw InvalidStateError
-        const dir = this._getCurrentDirection();
-        if (dir === 'recvonly' || dir === 'inactive') {
-            throw new DOMException(
-                "Failed to execute 'insertDTMF': The associated transceiver direction does not allow sending",
-                'InvalidStateError',
-            );
-        }
-
-        // Step 6: If tones contains invalid characters, throw InvalidCharacterError
-        for (const ch of tones) {
-            if (!VALID_DTMF_CHARS.has(ch)) {
-                throw new DOMException(
-                    `Failed to execute 'insertDTMF': Invalid DTMF character '${ch}'`,
-                    'InvalidCharacterError',
-                );
-            }
-        }
-
-        // Normalize a-d to uppercase
-        tones = tones.replace(/[a-d]/g, c => c.toUpperCase());
-
-        // Clamp duration to [40, 6000]
-        const d = duration ?? DEFAULT_DURATION;
-        this._duration = Math.max(MIN_DURATION, Math.min(MAX_DURATION, d));
-
-        // Clamp interToneGap to [30, ...]
-        const g = interToneGap ?? DEFAULT_INTER_TONE_GAP;
-        this._interToneGap = Math.max(MIN_INTER_TONE_GAP, g);
-
-        // Step 9: Set the object's toneBuffer to tones
-        this._toneBuffer = tones;
-
-        // Step 10: If toneBuffer was empty before, start the playout task
-        if (this._timerId !== null) {
-            clearTimeout(this._timerId);
-            this._timerId = null;
-        }
-        if (tones.length > 0) {
-            this._scheduleNextTone(0);
-        }
-    }
-
-    private _scheduleNextTone(delay: number): void {
-        this._timerId = setTimeout(() => {
-            this._timerId = null;
-            this._playNextTone();
-        }, delay);
-    }
-
-    private _playNextTone(): void {
-        if (this._toneBuffer.length === 0) {
-            // Spec: fire one final tonechange with empty tone
-            this._fireToneChange('');
-            return;
-        }
-
-        const tone = this._toneBuffer[0];
-        this._toneBuffer = this._toneBuffer.slice(1);
-
-        // Fire tonechange event for this tone
-        this._fireToneChange(tone);
-
-        // Schedule next tone after duration + interToneGap (comma = 2s delay)
-        const delay = tone === ',' ? COMMA_DELAY : (this._duration + this._interToneGap);
-        this._scheduleNextTone(delay);
-    }
-
-    private _fireToneChange(tone: string): void {
-        const ev = new RTCDTMFToneChangeEvent('tonechange', { tone });
-        this._ontonechange?.call(this, ev);
-        this.dispatchEvent(ev);
-    }
-
-    /** @internal — called by RTCRtpSender on cleanup */
-    _stop(): void {
-        if (this._timerId !== null) {
-            clearTimeout(this._timerId);
-            this._timerId = null;
-        }
-        this._toneBuffer = '';
-        this._canInsert = false;
-    }
-}

package/src/rtc-error.ts

@@ -1,49 +0,0 @@
-// RTCError extends DOMException per W3C WebRTC spec §7.
-//
-// Reference: refs/node-datachannel/src/polyfill/RTCError.ts (MIT) +
-//            https://www.w3.org/TR/webrtc/#rtcerror-interface
-//
-// CLAUDE.md Rule 8 exception: the class below extends `DOMException`
-// (a global). Seed the global before the class body is evaluated.
-
-import '@gjsify/dom-exception/register';
-
-export type RTCErrorDetailType =
-    | 'data-channel-failure'
-    | 'dtls-failure'
-    | 'fingerprint-failure'
-    | 'sctp-failure'
-    | 'sdp-syntax-error'
-    | 'hardware-encoder-not-available'
-    | 'hardware-encoder-error';
-
-export interface RTCErrorInit {
-    errorDetail: RTCErrorDetailType;
-    sdpLineNumber?: number | null;
-    sctpCauseCode?: number | null;
-    receivedAlert?: number | null;
-    sentAlert?: number | null;
-    httpRequestStatusCode?: number | null;
-}
-
-export class RTCError extends DOMException {
-    readonly errorDetail: RTCErrorDetailType;
-    readonly sdpLineNumber: number | null;
-    readonly sctpCauseCode: number | null;
-    readonly receivedAlert: number | null;
-    readonly sentAlert: number | null;
-    readonly httpRequestStatusCode: number | null;
-
-    constructor(init: RTCErrorInit, message?: string) {
-        super(message ?? init.errorDetail, 'OperationError');
-        if (!init || !init.errorDetail) {
-            throw new TypeError('RTCError: errorDetail is required');
-        }
-        this.errorDetail = init.errorDetail;
-        this.sdpLineNumber = init.sdpLineNumber ?? null;
-        this.sctpCauseCode = init.sctpCauseCode ?? null;
-        this.receivedAlert = init.receivedAlert ?? null;
-        this.sentAlert = init.sentAlert ?? null;
-        this.httpRequestStatusCode = init.httpRequestStatusCode ?? null;
-    }
-}

package/src/rtc-events.ts

@@ -1,64 +0,0 @@
-// W3C WebRTC event classes.
-//
-// Reference: refs/node-gst-webrtc/src/webrtc/events.ts (ISC) +
-//            https://www.w3.org/TR/webrtc/#rtcpeerconnectioniceevent-interface
-//            https://www.w3.org/TR/webrtc/#rtcdatachannelevent-interface
-//            https://www.w3.org/TR/webrtc/#rtcerrorevent-interface
-//
-// CLAUDE.md Rule 8 exception: the class declarations below extend the
-// global `Event` constructor, which runs at module load. Seed the global
-// before the class bodies are evaluated.
-
-import '@gjsify/dom-events/register/event-target';
-
-import type { RTCIceCandidate } from './rtc-ice-candidate.js';
-import type { RTCDataChannel } from './rtc-data-channel.js';
-import type { RTCError } from './rtc-error.js';
-
-export interface RTCPeerConnectionIceEventInit extends EventInit {
-    candidate?: RTCIceCandidate | null;
-    url?: string | null;
-}
-
-export class RTCPeerConnectionIceEvent extends Event {
-    readonly candidate: RTCIceCandidate | null;
-    readonly url: string | null;
-
-    constructor(type: string, init: RTCPeerConnectionIceEventInit = {}) {
-        super(type, init);
-        this.candidate = init.candidate ?? null;
-        this.url = init.url ?? null;
-    }
-}
-
-export interface RTCDataChannelEventInit extends EventInit {
-    channel: RTCDataChannel;
-}
-
-export class RTCDataChannelEvent extends Event {
-    readonly channel: RTCDataChannel;
-
-    constructor(type: string, init: RTCDataChannelEventInit) {
-        super(type, init);
-        if (!init || !init.channel) {
-            throw new TypeError('RTCDataChannelEvent requires a `channel` member');
-        }
-        this.channel = init.channel;
-    }
-}
-
-export interface RTCErrorEventInit extends EventInit {
-    error: RTCError;
-}
-
-export class RTCErrorEvent extends Event {
-    readonly error: RTCError;
-
-    constructor(type: string, init: RTCErrorEventInit) {
-        super(type, init);
-        if (!init || !init.error) {
-            throw new TypeError('RTCErrorEvent requires an `error` member');
-        }
-        this.error = init.error;
-    }
-}

package/src/rtc-ice-candidate.ts

@@ -1,115 +0,0 @@
-// RTCIceCandidate — W3C WebRTC ICE candidate descriptor.
-//
-// Reference: refs/node-gst-webrtc/src/webrtc/RTCIceCandidate.ts (ISC)
-//
-// Field extraction (type/protocol/port/...) uses a minimal SDP candidate-line
-// parser per RFC 5245 §15.1.
-
-export interface RTCIceCandidateInit {
-    candidate?: string;
-    sdpMid?: string | null;
-    sdpMLineIndex?: number | null;
-    usernameFragment?: string | null;
-}
-
-export type RTCIceComponent = 'rtp' | 'rtcp';
-export type RTCIceProtocol = 'udp' | 'tcp';
-export type RTCIceCandidateType = 'host' | 'srflx' | 'prflx' | 'relay';
-export type RTCIceTcpCandidateType = 'active' | 'passive' | 'so';
-
-interface ParsedCandidate {
-    foundation: string;
-    component: RTCIceComponent | null;
-    priority: number | null;
-    protocol: RTCIceProtocol | null;
-    address: string | null;
-    port: number | null;
-    type: RTCIceCandidateType | null;
-    relatedAddress: string | null;
-    relatedPort: number | null;
-    tcpType: RTCIceTcpCandidateType | null;
-}
-
-function parseCandidate(line: string): Partial<ParsedCandidate> {
-    // Accepts both `candidate:...` and raw `a=candidate:...` forms.
-    let s = line.trim();
-    if (s.startsWith('a=')) s = s.slice(2);
-    if (s.startsWith('candidate:')) s = s.slice('candidate:'.length);
-
-    const parts = s.split(/\s+/);
-    if (parts.length < 8) return {};
-
-    const protocolRaw = parts[2]?.toLowerCase();
-    const typeIdx = parts.indexOf('typ');
-    const typeRaw = typeIdx >= 0 ? parts[typeIdx + 1] : undefined;
-
-    const raddrIdx = parts.indexOf('raddr');
-    const rportIdx = parts.indexOf('rport');
-    const tcpTypeIdx = parts.indexOf('tcptype');
-
-    const componentId = Number(parts[1]);
-    return {
-        foundation: parts[0],
-        component: componentId === 1 ? 'rtp' : componentId === 2 ? 'rtcp' : null,
-        priority: Number(parts[3]) || null,
-        protocol: (protocolRaw === 'udp' || protocolRaw === 'tcp') ? protocolRaw : null,
-        address: parts[4] ?? null,
-        port: Number(parts[5]) || null,
-        type: (typeRaw === 'host' || typeRaw === 'srflx' || typeRaw === 'prflx' || typeRaw === 'relay') ? typeRaw : null,
-        relatedAddress: raddrIdx >= 0 ? parts[raddrIdx + 1] ?? null : null,
-        relatedPort: rportIdx >= 0 ? Number(parts[rportIdx + 1]) || null : null,
-        tcpType: tcpTypeIdx >= 0
-            ? (parts[tcpTypeIdx + 1] as RTCIceTcpCandidateType)
-            : null,
-    };
-}
-
-export class RTCIceCandidate {
-    readonly candidate: string;
-    readonly sdpMid: string | null;
-    readonly sdpMLineIndex: number | null;
-    readonly usernameFragment: string | null;
-    readonly foundation: string | null;
-    readonly component: RTCIceComponent | null;
-    readonly priority: number | null;
-    readonly protocol: RTCIceProtocol | null;
-    readonly address: string | null;
-    readonly port: number | null;
-    readonly type: RTCIceCandidateType | null;
-    readonly tcpType: RTCIceTcpCandidateType | null;
-    readonly relatedAddress: string | null;
-    readonly relatedPort: number | null;
-
-    constructor(init: RTCIceCandidateInit = {}) {
-        if (init.sdpMid == null && init.sdpMLineIndex == null) {
-            throw new TypeError(
-                'RTCIceCandidate requires either sdpMid or sdpMLineIndex',
-            );
-        }
-        this.candidate = init.candidate ?? '';
-        this.sdpMid = init.sdpMid ?? null;
-        this.sdpMLineIndex = init.sdpMLineIndex ?? null;
-        this.usernameFragment = init.usernameFragment ?? null;
-
-        const parsed = parseCandidate(this.candidate);
-        this.foundation = parsed.foundation ?? null;
-        this.component = parsed.component ?? null;
-        this.priority = parsed.priority ?? null;
-        this.protocol = parsed.protocol ?? null;
-        this.address = parsed.address ?? null;
-        this.port = parsed.port ?? null;
-        this.type = parsed.type ?? null;
-        this.tcpType = parsed.tcpType ?? null;
-        this.relatedAddress = parsed.relatedAddress ?? null;
-        this.relatedPort = parsed.relatedPort ?? null;
-    }
-
-    toJSON(): RTCIceCandidateInit {
-        return {
-            candidate: this.candidate,
-            sdpMid: this.sdpMid,
-            sdpMLineIndex: this.sdpMLineIndex,
-            usernameFragment: this.usernameFragment,
-        };
-    }
-}

package/src/rtc-ice-transport.ts

@@ -1,104 +0,0 @@
-// W3C RTCIceTransport for GJS.
-//
-// Thin wrapper that reflects webrtcbin's ICE state. The RTCPeerConnection
-// updates state/gatheringState via the WebrtcbinBridge signal handlers.
-//
-// Reference: W3C WebRTC spec § 5.6
-// Reference: refs/wpt/webrtc/RTCIceTransport.html
-
-import '@gjsify/dom-events/register/event-target';
-
-import { RTCIceCandidate, type RTCIceCandidateInit } from './rtc-ice-candidate.js';
-
-export type RTCIceRole = 'unknown' | 'controlling' | 'controlled';
-export type RTCIceComponent = 'rtp' | 'rtcp';
-export type RTCIceTransportState =
-    | 'new' | 'checking' | 'connected' | 'completed'
-    | 'disconnected' | 'failed' | 'closed';
-
-export interface RTCIceParameters {
-    usernameFragment?: string;
-    password?: string;
-}
-
-export interface RTCIceCandidatePair {
-    local: RTCIceCandidate;
-    remote: RTCIceCandidate;
-}
-
-type EventHandler = ((ev: Event) => void) | null;
-
-export class RTCIceTransport extends EventTarget {
-    private _state: RTCIceTransportState = 'new';
-    private _gatheringState: RTCIceGatheringState = 'new';
-    private _role: RTCIceRole = 'unknown';
-    private _component: RTCIceComponent = 'rtp';
-    private _localCandidates: RTCIceCandidate[] = [];
-    private _remoteCandidates: RTCIceCandidate[] = [];
-    private _localParams: RTCIceParameters | null = null;
-    private _remoteParams: RTCIceParameters | null = null;
-
-    private _onstatechange: EventHandler = null;
-    private _ongatheringstatechange: EventHandler = null;
-    private _onselectedcandidatepairchange: EventHandler = null;
-
-    get state(): RTCIceTransportState { return this._state; }
-    get gatheringState(): RTCIceGatheringState { return this._gatheringState; }
-    get role(): RTCIceRole { return this._role; }
-    get component(): RTCIceComponent { return this._component; }
-
-    get onstatechange(): EventHandler { return this._onstatechange; }
-    set onstatechange(v: EventHandler) { this._onstatechange = v; }
-    get ongatheringstatechange(): EventHandler { return this._ongatheringstatechange; }
-    set ongatheringstatechange(v: EventHandler) { this._ongatheringstatechange = v; }
-    get onselectedcandidatepairchange(): EventHandler { return this._onselectedcandidatepairchange; }
-    set onselectedcandidatepairchange(v: EventHandler) { this._onselectedcandidatepairchange = v; }
-
-    getLocalCandidates(): RTCIceCandidate[] { return [...this._localCandidates]; }
-    getRemoteCandidates(): RTCIceCandidate[] { return [...this._remoteCandidates]; }
-    getSelectedCandidatePair(): RTCIceCandidatePair | null { return null; }
-    getLocalParameters(): RTCIceParameters | null { return this._localParams; }
-    getRemoteParameters(): RTCIceParameters | null { return this._remoteParams; }
-
-    // ---- Internal setters (called by RTCPeerConnection) ---------------------
-
-    /** @internal */
-    _setState(state: RTCIceTransportState): void {
-        if (this._state === state) return;
-        this._state = state;
-        const ev = new Event('statechange');
-        this._onstatechange?.call(this, ev);
-        this.dispatchEvent(ev);
-    }
-
-    /** @internal */
-    _setGatheringState(state: RTCIceGatheringState): void {
-        if (this._gatheringState === state) return;
-        this._gatheringState = state;
-        const ev = new Event('gatheringstatechange');
-        this._ongatheringstatechange?.call(this, ev);
-        this.dispatchEvent(ev);
-    }
-
-    /** @internal */
-    _addLocalCandidate(init: RTCIceCandidateInit): void {
-        this._localCandidates.push(new RTCIceCandidate(init));
-    }
-
-    /** @internal */
-    _addRemoteCandidate(init: RTCIceCandidateInit): void {
-        this._remoteCandidates.push(new RTCIceCandidate(init));
-    }
-
-    /** @internal */
-    _setLocalParameters(params: RTCIceParameters): void {
-        this._localParams = params;
-    }
-
-    /** @internal */
-    _setRemoteParameters(params: RTCIceParameters): void {
-        this._remoteParams = params;
-    }
-}
-
-type RTCIceGatheringState = 'new' | 'gathering' | 'complete';