@waitaya.buc/client-js 0.1.0-alpha.0

package/dist/adapters/livekit/service-adapters/track-attachment.adapter.js

@@ -0,0 +1,348 @@
+import { RoomEvent, RemoteVideoTrack, } from 'livekit-client';
+/**
+ * ElementInfo implementation for mobile platforms (React Native, etc.).
+ *
+ * This class implements LiveKit's ElementInfo interface to enable adaptive streaming
+ * on mobile platforms where there's no DOM element to observe.
+ *
+ * @see https://github.com/livekit/client-sdk-react-native
+ */
+class MobileViewElementInfo {
+    constructor(width = 0, height = 0, visible = true) {
+        this.element = {};
+        this._observing = false;
+        this.pictureInPicture = false;
+        this.width = () => this._width;
+        this.height = () => this._height;
+        this._width = width;
+        this._height = height;
+        this.visible = visible;
+    }
+    observe() {
+        this._observing = true;
+    }
+    stopObserving() {
+        this._observing = false;
+    }
+    /**
+     * Update dimensions when layout changes
+     */
+    setDimensions(width, height) {
+        this._width = width;
+        this._height = height;
+        if (this._observing) {
+            this.handleResize?.();
+        }
+    }
+    /**
+     * Update visibility state
+     */
+    setVisible(visible) {
+        if (this.visible !== visible) {
+            this.visible = visible;
+            this.visibilityChangedAt = Date.now();
+            if (this._observing) {
+                this.handleVisibilityChanged?.();
+            }
+        }
+    }
+}
+/**
+ * LiveKit implementation of TrackAttachmentAdapter.
+ *
+ * Uses LiveKit's track.attach() method to properly attach tracks to elements.
+ * This is necessary because LiveKit uses adaptive streaming that requires
+ * knowing which elements are displaying tracks for proper frame delivery.
+ *
+ * Features:
+ * - Automatic pending queue: If attach() is called before track is subscribed,
+ *   the request is queued and automatically fulfilled when track becomes available.
+ * - Handles race conditions between TrackAdded event and actual track subscription.
+ * - React Native support via registerTrackView/unregisterTrackView methods.
+ */
+export class LiveKitTrackAttachmentAdapter {
+    constructor(room) {
+        /** Pending attachments waiting for tracks to be subscribed (Web) */
+        this.pendingAttachments = new Map();
+        /** Pending view registrations waiting for tracks to be subscribed (Mobile) */
+        this.pendingViews = new Map();
+        /** Active view registrations (Mobile) */
+        this.activeViews = new Map();
+        /** ElementInfo instances for each view (Mobile) - Map<trackId, Map<viewId, ElementInfo>> */
+        this.elementInfos = new Map();
+        /** Cleanup functions for event listeners */
+        this.cleanupFns = [];
+        this.room = room;
+        this.setupEventListeners();
+    }
+    attach(trackId, element) {
+        const lkTrack = this.findLiveKitTrack(trackId);
+        if (lkTrack) {
+            lkTrack.attach(element);
+        }
+        else {
+            // Queue for later when track becomes available
+            if (!this.pendingAttachments.has(trackId)) {
+                this.pendingAttachments.set(trackId, new Set());
+            }
+            this.pendingAttachments.get(trackId).add(element);
+        }
+    }
+    detach(trackId, element) {
+        // Remove from pending queue first
+        if (element) {
+            const pendingSet = this.pendingAttachments.get(trackId);
+            if (pendingSet) {
+                pendingSet.delete(element);
+                // Cleanup empty entry to prevent memory buildup
+                if (pendingSet.size === 0) {
+                    this.pendingAttachments.delete(trackId);
+                }
+            }
+        }
+        else {
+            this.pendingAttachments.delete(trackId);
+        }
+        // Then detach from actual track if available
+        const lkTrack = this.findLiveKitTrack(trackId);
+        if (lkTrack) {
+            if (element) {
+                lkTrack.detach(element);
+            }
+            else {
+                lkTrack.detach();
+            }
+        }
+    }
+    registerTrackView(trackId, viewId, options) {
+        const lkTrack = this.findLiveKitTrack(trackId);
+        if (lkTrack) {
+            // Track is available - register view and setup adaptive streaming
+            this.addActiveView(trackId, viewId);
+            this.observeTrackIfNeeded(trackId, viewId, lkTrack, options);
+            return this.getStreamUrl(lkTrack);
+        }
+        // Track not ready yet - queue for later with options
+        if (!this.pendingViews.has(trackId)) {
+            this.pendingViews.set(trackId, new Map());
+        }
+        this.pendingViews.get(trackId).set(viewId, {
+            viewId,
+            width: options?.width,
+            height: options?.height,
+            visible: options?.visible,
+            onReady: options?.onReady,
+        });
+        return null;
+    }
+    unregisterTrackView(trackId, viewId) {
+        if (viewId) {
+            // Remove specific view
+            this.pendingViews.get(trackId)?.delete(viewId);
+            if (this.pendingViews.get(trackId)?.size === 0) {
+                this.pendingViews.delete(trackId);
+            }
+            // Stop observing and cleanup ElementInfo
+            this.stopObservingTrack(trackId, viewId);
+            this.activeViews.get(trackId)?.delete(viewId);
+            if (this.activeViews.get(trackId)?.size === 0) {
+                this.activeViews.delete(trackId);
+            }
+        }
+        else {
+            // Remove all views for this track
+            this.pendingViews.delete(trackId);
+            // Stop observing all ElementInfos for this track
+            const viewInfos = this.elementInfos.get(trackId);
+            if (viewInfos) {
+                for (const vid of viewInfos.keys()) {
+                    this.stopObservingTrack(trackId, vid);
+                }
+            }
+            this.activeViews.delete(trackId);
+        }
+    }
+    updateTrackViewLayout(trackId, viewId, width, height) {
+        const elementInfo = this.elementInfos.get(trackId)?.get(viewId);
+        if (elementInfo) {
+            elementInfo.setDimensions(width, height);
+        }
+    }
+    updateTrackViewVisibility(trackId, viewId, visible) {
+        const elementInfo = this.elementInfos.get(trackId)?.get(viewId);
+        if (elementInfo) {
+            elementInfo.setVisible(visible);
+        }
+    }
+    destroy() {
+        // Cleanup all event listeners
+        this.cleanupFns.forEach((fn) => fn());
+        this.cleanupFns = [];
+        // Stop observing all ElementInfos
+        for (const [trackId, viewInfos] of this.elementInfos) {
+            const lkTrack = this.findLiveKitTrack(trackId);
+            if (lkTrack instanceof RemoteVideoTrack) {
+                for (const elementInfo of viewInfos.values()) {
+                    lkTrack.stopObservingElementInfo(elementInfo);
+                }
+            }
+        }
+        // Clear pending queues
+        this.pendingAttachments.clear();
+        this.pendingViews.clear();
+        this.activeViews.clear();
+        this.elementInfos.clear();
+    }
+    /**
+     * Setup event listeners for track lifecycle management.
+     * - TrackSubscribed: Fulfill pending attachment requests (Web) and pending view registrations (Mobile)
+     * - TrackUnsubscribed: Cleanup pending requests that will never arrive
+     */
+    setupEventListeners() {
+        // Handle track subscribed - fulfill pending attachments and views
+        const onTrackSubscribed = (track) => {
+            const trackId = track.sid;
+            if (!trackId)
+                return;
+            // Fulfill pending Web attachments
+            if (this.pendingAttachments.has(trackId)) {
+                const elements = this.pendingAttachments.get(trackId);
+                elements.forEach((el) => track.attach(el));
+                this.pendingAttachments.delete(trackId);
+            }
+            // Fulfill pending mobile view registrations
+            if (this.pendingViews.has(trackId)) {
+                const views = this.pendingViews.get(trackId);
+                const streamUrl = this.getStreamUrl(track);
+                views.forEach((pendingView) => {
+                    this.addActiveView(trackId, pendingView.viewId);
+                    // Setup adaptive streaming observation with pending options
+                    this.observeTrackIfNeeded(trackId, pendingView.viewId, track, {
+                        width: pendingView.width,
+                        height: pendingView.height,
+                        visible: pendingView.visible,
+                    });
+                    pendingView.onReady?.(streamUrl);
+                });
+                this.pendingViews.delete(trackId);
+            }
+        };
+        // Handle track unsubscribed - cleanup pending requests that will never be fulfilled
+        const onTrackUnsubscribed = (track) => {
+            const trackId = track.sid;
+            if (trackId) {
+                this.pendingAttachments.delete(trackId);
+                this.pendingViews.delete(trackId);
+                this.activeViews.delete(trackId);
+                // Cleanup all ElementInfos for this track
+                const viewInfos = this.elementInfos.get(trackId);
+                if (viewInfos) {
+                    for (const elementInfo of viewInfos.values()) {
+                        if (track instanceof RemoteVideoTrack) {
+                            track.stopObservingElementInfo(elementInfo);
+                        }
+                    }
+                    this.elementInfos.delete(trackId);
+                }
+            }
+        };
+        this.room.on(RoomEvent.TrackSubscribed, onTrackSubscribed);
+        this.room.on(RoomEvent.TrackUnsubscribed, onTrackUnsubscribed);
+        this.cleanupFns.push(() => this.room.off(RoomEvent.TrackSubscribed, onTrackSubscribed), () => this.room.off(RoomEvent.TrackUnsubscribed, onTrackUnsubscribed));
+    }
+    /**
+     * Find LiveKit Track by track SID from all participants
+     */
+    findLiveKitTrack(trackId) {
+        // Search in local participant
+        for (const pub of this.room.localParticipant.trackPublications.values()) {
+            if (pub.trackSid === trackId && pub.track) {
+                return pub.track;
+            }
+        }
+        // Search in remote participants
+        for (const participant of this.room.remoteParticipants.values()) {
+            for (const pub of participant.trackPublications.values()) {
+                if (pub.trackSid === trackId && pub.track) {
+                    return pub.track;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Add a view to the active views set for a track
+     */
+    addActiveView(trackId, viewId) {
+        if (!this.activeViews.has(trackId)) {
+            this.activeViews.set(trackId, new Set());
+        }
+        this.activeViews.get(trackId).add(viewId);
+    }
+    /**
+     * Setup adaptive streaming observation for a track view.
+     *
+     * For RemoteVideoTrack with adaptive streaming enabled, this creates an ElementInfo
+     * and calls observeElementInfo() to tell LiveKit that a view is displaying the track.
+     * This is critical for adaptive streaming to work on mobile platforms.
+     *
+     * @see https://github.com/livekit/client-sdk-react-native
+     */
+    observeTrackIfNeeded(trackId, viewId, lkTrack, options) {
+        // Only observe RemoteVideoTrack with adaptive streaming
+        if (!(lkTrack instanceof RemoteVideoTrack)) {
+            return;
+        }
+        // Check if adaptive streaming is enabled
+        if (!lkTrack.isAdaptiveStream) {
+            return;
+        }
+        // Create ElementInfo for this view
+        const elementInfo = new MobileViewElementInfo(options?.width ?? 0, options?.height ?? 0, options?.visible ?? true);
+        // Store the ElementInfo
+        if (!this.elementInfos.has(trackId)) {
+            this.elementInfos.set(trackId, new Map());
+        }
+        this.elementInfos.get(trackId).set(viewId, elementInfo);
+        // Tell LiveKit to observe this ElementInfo for adaptive streaming
+        lkTrack.observeElementInfo(elementInfo);
+    }
+    /**
+     * Stop observing a track view for adaptive streaming.
+     */
+    stopObservingTrack(trackId, viewId) {
+        const elementInfo = this.elementInfos.get(trackId)?.get(viewId);
+        if (!elementInfo) {
+            return;
+        }
+        // Find the LiveKit track and stop observing
+        const lkTrack = this.findLiveKitTrack(trackId);
+        if (lkTrack instanceof RemoteVideoTrack) {
+            lkTrack.stopObservingElementInfo(elementInfo);
+        }
+        // Cleanup ElementInfo
+        this.elementInfos.get(trackId)?.delete(viewId);
+        if (this.elementInfos.get(trackId)?.size === 0) {
+            this.elementInfos.delete(trackId);
+        }
+    }
+    /**
+     * Get stream URL from a LiveKit track for mobile video views.
+     *
+     * Uses MediaStream.toURL() which is the correct approach for React Native.
+     * LiveKit's official @livekit/react-native also uses this method.
+     *
+     * @see https://github.com/livekit/client-sdk-react-native
+     */
+    getStreamUrl(track) {
+        // Use mediaStream.toURL() - this is the correct approach for React Native
+        // LiveKit's track.mediaStream is a MediaStream that wraps the MediaStreamTrack
+        const mediaStream = track.mediaStream;
+        if (mediaStream && 'toURL' in mediaStream) {
+            return mediaStream.toURL();
+        }
+        // Fallback: return stream id (for web or unsupported platforms)
+        return mediaStream?.id ?? '';
+    }
+}
+//# sourceMappingURL=track-attachment.adapter.js.map

package/dist/adapters/livekit/service-adapters/track-attachment.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-attachment.adapter.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/track-attachment.adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/livekit/services/index.d.ts

@@ -0,0 +1,3 @@
+export * as StatsService from './stats.service';
+export * as RecordingService from './recording.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/livekit/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,gBAAgB,MAAM,qBAAqB,CAAA"}

package/dist/adapters/livekit/services/index.js

@@ -0,0 +1,3 @@
+export * as StatsService from './stats.service';
+export * as RecordingService from './recording.service';
+//# sourceMappingURL=index.js.map

package/dist/adapters/livekit/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,gBAAgB,MAAM,qBAAqB,CAAA"}

package/dist/adapters/livekit/services/recording.service.d.ts

@@ -0,0 +1,29 @@
+import type { ServiceContext } from '../../../core/types/service-adapters.types';
+import type { RecordingStartOptions, RecordingStatus } from '../../../core/types/recording.types';
+/**
+ * Start recording for the session.
+ *
+ * @param context - Service context with sessionToken and apiEndpoint
+ * @param options - Recording options (layout, audioOnly, resolution)
+ * @returns Recording ID
+ * @throws RecordingStartError if recording fails to start (e.g., already recording)
+ * @throws PermissionDeniedError if no recording permission or insufficient role
+ */
+export declare function startRecording(context: ServiceContext, options?: RecordingStartOptions): Promise<string>;
+/**
+ * Stop recording.
+ *
+ * @param context - Service context with sessionToken and apiEndpoint
+ * @param recordingId - ID of the recording to stop
+ * @throws PermissionDeniedError if insufficient role
+ */
+export declare function stopRecording(context: ServiceContext, recordingId: string): Promise<void>;
+/**
+ * Get recording status.
+ *
+ * @param context - Service context with sessionToken and apiEndpoint
+ * @param recordingId - ID of the recording
+ * @returns Recording status
+ */
+export declare function getRecordingStatus(context: ServiceContext, recordingId: string): Promise<RecordingStatus>;
+//# sourceMappingURL=recording.service.d.ts.map

package/dist/adapters/livekit/services/recording.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.service.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/services/recording.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAA;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAChB,MAAM,qCAAqC,CAAA;AAO5C;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAE1B"}

package/dist/adapters/livekit/services/recording.service.js

@@ -0,0 +1,34 @@
+import { postStartRecording, postStopRecording, getRecordingStatus as getRecordingStatusApi, } from '../api/recording.api';
+/**
+ * Start recording for the session.
+ *
+ * @param context - Service context with sessionToken and apiEndpoint
+ * @param options - Recording options (layout, audioOnly, resolution)
+ * @returns Recording ID
+ * @throws RecordingStartError if recording fails to start (e.g., already recording)
+ * @throws PermissionDeniedError if no recording permission or insufficient role
+ */
+export async function startRecording(context, options) {
+    return postStartRecording(context, options);
+}
+/**
+ * Stop recording.
+ *
+ * @param context - Service context with sessionToken and apiEndpoint
+ * @param recordingId - ID of the recording to stop
+ * @throws PermissionDeniedError if insufficient role
+ */
+export async function stopRecording(context, recordingId) {
+    return postStopRecording(context, recordingId);
+}
+/**
+ * Get recording status.
+ *
+ * @param context - Service context with sessionToken and apiEndpoint
+ * @param recordingId - ID of the recording
+ * @returns Recording status
+ */
+export async function getRecordingStatus(context, recordingId) {
+    return getRecordingStatusApi(context, recordingId);
+}
+//# sourceMappingURL=recording.service.js.map

package/dist/adapters/livekit/services/recording.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.service.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/services/recording.service.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,IAAI,qBAAqB,GAC5C,MAAM,sBAAsB,CAAA;AAE7B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,OAA+B;IAE/B,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAuB,EACvB,WAAmB;IAEnB,OAAO,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAuB,EACvB,WAAmB;IAEnB,OAAO,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;AACpD,CAAC"}

package/dist/adapters/livekit/services/stats.service.d.ts

@@ -0,0 +1,24 @@
+import type { Room } from 'livekit-client';
+import type { NetworkQuality } from '../../../core/types/events.types';
+/**
+ * Get native RTC stats report from peer connection(s).
+ *
+ * LiveKit supports multiple PC modes:
+ * - publisher-only: single PC for both outbound and inbound
+ * - subscriber-primary / publisher-primary: separate PCs
+ *
+ * This method handles both cases by checking if subscriber PC exists.
+ *
+ * Note: This uses LiveKit's internal API (room.engine.pcManager) which may
+ * change in future versions. If this breaks, update the path or fallback
+ * to track-based stats collection.
+ *
+ * @returns RTCStatsReport containing stats for all tracks
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RTCStatsReport
+ */
+export declare function getStats(room: Room | null): Promise<RTCStatsReport>;
+/**
+ * Get current network quality based on local participant's connection quality.
+ */
+export declare function getNetworkQuality(room: Room | null): NetworkQuality;
+//# sourceMappingURL=stats.service.d.ts.map

package/dist/adapters/livekit/services/stats.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.service.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/services/stats.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAGtE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CAiCzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,cAAc,CAOnE"}

package/dist/adapters/livekit/services/stats.service.js

@@ -0,0 +1,56 @@
+import { LiveKitMapper } from '../livekit.mapper';
+/**
+ * Get native RTC stats report from peer connection(s).
+ *
+ * LiveKit supports multiple PC modes:
+ * - publisher-only: single PC for both outbound and inbound
+ * - subscriber-primary / publisher-primary: separate PCs
+ *
+ * This method handles both cases by checking if subscriber PC exists.
+ *
+ * Note: This uses LiveKit's internal API (room.engine.pcManager) which may
+ * change in future versions. If this breaks, update the path or fallback
+ * to track-based stats collection.
+ *
+ * @returns RTCStatsReport containing stats for all tracks
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RTCStatsReport
+ */
+export async function getStats(room) {
+    if (!room) {
+        return new Map();
+    }
+    // Access peer connections via internal API
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const pcManager = room.engine?.pcManager;
+    const publisherPC = pcManager?.publisher?.pc;
+    const subscriberPC = pcManager?.subscriber?.pc;
+    // If no publisher PC, return empty stats
+    if (!publisherPC) {
+        return new Map();
+    }
+    // If no subscriber PC (publisher-only mode), publisher has all stats
+    if (!subscriberPC) {
+        return publisherPC.getStats();
+    }
+    // If both PCs exist, merge stats from both
+    const mergedStats = new Map();
+    const publisherStats = await publisherPC.getStats();
+    publisherStats.forEach((value, key) => mergedStats.set(key, value));
+    const subscriberStats = await subscriberPC.getStats();
+    subscriberStats.forEach((value, key) => {
+        if (!mergedStats.has(key))
+            mergedStats.set(key, value);
+    });
+    return mergedStats;
+}
+/**
+ * Get current network quality based on local participant's connection quality.
+ */
+export function getNetworkQuality(room) {
+    if (!room) {
+        return 'unknown';
+    }
+    const quality = room.localParticipant.connectionQuality;
+    return LiveKitMapper.toNetworkQuality(quality);
+}
+//# sourceMappingURL=stats.service.js.map

package/dist/adapters/livekit/services/stats.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.service.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/services/stats.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAiB;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,GAAG,EAAoB,CAAA;IACpC,CAAC;IAED,2CAA2C;IAC3C,8DAA8D;IAC9D,MAAM,SAAS,GAAI,IAAI,CAAC,MAAc,EAAE,SAAS,CAAA;IACjD,MAAM,WAAW,GAAG,SAAS,EAAE,SAAS,EAAE,EAAmC,CAAA;IAC7E,MAAM,YAAY,GAAG,SAAS,EAAE,UAAU,EAAE,EAAmC,CAAA;IAE/E,yCAAyC;IACzC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,GAAG,EAAoB,CAAA;IACpC,CAAC;IAED,qEAAqE;IACrE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAA;IAC/B,CAAC;IAED,2CAA2C;IAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAA;IAE/C,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAA;IACnD,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;IAEnE,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAA;IACrD,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,OAAO,WAA6B,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAA;IACvD,OAAO,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;AAChD,CAAC"}

package/dist/core/api/auth.api.d.ts

@@ -0,0 +1,52 @@
+import { type VroomInitConfig, type VroomInitConfigInternal, type ProviderType } from '../types/vroom.types';
+/**
+ * Auth init response from POST /v1/auth/init
+ */
+export interface AuthInitResponse {
+    authToken: string;
+    expiresAt: number;
+}
+/**
+ * RTC token response from POST /v1/rtc/token
+ */
+export interface RtcTokenResponse {
+    /** Provider-specific token (e.g., LiveKit JWT) */
+    token: string;
+    /** Vroom session token (JWT with feat[], role, etc.) */
+    sessionToken: string;
+    /** RTC provider type */
+    provider: ProviderType;
+    /** Provider endpoint URL */
+    endpoint: string;
+    /** User role in the room */
+    role: string;
+    /** Token expiration time (Unix timestamp) */
+    expiresAt: number;
+}
+/**
+ * RTC token request params
+ */
+export interface RtcTokenRequest {
+    authToken: string;
+    userId: string;
+    roomName: string;
+    role: string;
+}
+/**
+ * Vroom API Client
+ *
+ * Handles all HTTP communication with Vroom backend.
+ */
+export declare class VroomApiClient {
+    private readonly endpoint;
+    constructor(config: VroomInitConfig);
+    /**
+     * POST /v1/auth/init - Validate API key and get authToken
+     */
+    authInit(config: VroomInitConfigInternal): Promise<AuthInitResponse>;
+    /**
+     * POST /v1/rtc/token - Get provider-specific token for room
+     */
+    getRtcToken(params: RtcTokenRequest): Promise<RtcTokenResponse>;
+}
+//# sourceMappingURL=auth.api.d.ts.map

package/dist/core/api/auth.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.api.d.ts","sourceRoot":"","sources":["../../../src/core/api/auth.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAQ7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAA;IACtB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAiBD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,MAAM,EAAE,eAAe;IAInC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW1E;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CActE"}

package/dist/core/api/auth.api.js

@@ -0,0 +1,59 @@
+import { DEFAULT_VROOM_ENDPOINT, } from '../types/vroom.types';
+import { InvalidApiKeyError, UnauthorizedError, } from '../errors/vroom.error';
+import { ErrorCodes } from '../errors/error-codes';
+import { request } from './http';
+/**
+ * Custom error handler for auth endpoints.
+ * Handles auth-specific errors: InvalidApiKey, Unauthorized
+ */
+const authErrorHandler = ({ code, message }) => {
+    switch (code) {
+        case ErrorCodes.E_INVALID_API_KEY:
+            return new InvalidApiKeyError(message);
+        case ErrorCodes.E_UNAUTHORIZED:
+            return new UnauthorizedError(message);
+        default:
+            return null; // Fallback to common error handling
+    }
+};
+/**
+ * Vroom API Client
+ *
+ * Handles all HTTP communication with Vroom backend.
+ */
+export class VroomApiClient {
+    constructor(config) {
+        this.endpoint = config.endpoint ?? DEFAULT_VROOM_ENDPOINT;
+    }
+    /**
+     * POST /v1/auth/init - Validate API key and get authToken
+     */
+    async authInit(config) {
+        return request({
+            method: 'POST',
+            url: `${this.endpoint}/v1/auth/init`,
+            headers: { 'X-API-Key': config.apiKey },
+            body: { platformInfo: config.platformInfo },
+            customErrorHandler: authErrorHandler,
+            errorMessage: 'Failed to connect to Vroom API',
+        });
+    }
+    /**
+     * POST /v1/rtc/token - Get provider-specific token for room
+     */
+    async getRtcToken(params) {
+        return request({
+            method: 'POST',
+            url: `${this.endpoint}/v1/rtc/token`,
+            headers: { Authorization: `Bearer ${params.authToken}` },
+            body: {
+                userId: params.userId,
+                roomName: params.roomName,
+                role: params.role,
+            },
+            customErrorHandler: authErrorHandler,
+            errorMessage: 'Failed to get RTC token',
+        });
+    }
+}
+//# sourceMappingURL=auth.api.js.map