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

package/dist/adapters/livekit/livekit.mapper.js

@@ -0,0 +1,108 @@
+import { ConnectionQuality, LocalParticipant, Track as LKTrack, } from 'livekit-client';
+/**
+ * Stateless mapper for converting LiveKit types to SDK types.
+ */
+export class LiveKitMapper {
+    /**
+     * Converts a LiveKit Participant to SDK Participant.
+     */
+    static toParticipant(lkParticipant) {
+        const isLocal = lkParticipant instanceof LocalParticipant;
+        const role = LiveKitMapper.extractRole(lkParticipant.metadata);
+        return {
+            id: lkParticipant.identity,
+            displayName: lkParticipant.name?.trim() || lkParticipant.identity,
+            role,
+            isLocal,
+            joinedAt: lkParticipant.joinedAt?.getTime() ?? Date.now(),
+            metadata: LiveKitMapper.parseMetadata(lkParticipant.metadata),
+        };
+    }
+    /**
+     * Converts a LiveKit TrackPublication to SDK Track.
+     */
+    static toTrack(publication, participant) {
+        return {
+            id: publication.trackSid,
+            kind: LiveKitMapper.toTrackKind(publication.source),
+            enabled: !publication.isMuted,
+            muted: publication.isMuted,
+            participant,
+            mediaStreamTrack: publication.track?.mediaStreamTrack,
+        };
+    }
+    /**
+     * Converts a LiveKit Track.Source to SDK TrackKind.
+     */
+    static toTrackKind(source) {
+        switch (source) {
+            case LKTrack.Source.Microphone:
+                return 'audio';
+            case LKTrack.Source.Camera:
+                return 'video';
+            case LKTrack.Source.ScreenShare:
+            case LKTrack.Source.ScreenShareAudio:
+                return 'screen';
+            default:
+                return 'video'; // default fallback
+        }
+    }
+    /**
+     * Converts a LiveKit ConnectionQuality to SDK NetworkQuality.
+     */
+    static toNetworkQuality(quality) {
+        switch (quality) {
+            case ConnectionQuality.Excellent:
+                return 'excellent';
+            case ConnectionQuality.Good:
+                return 'good';
+            case ConnectionQuality.Poor:
+                return 'poor';
+            case ConnectionQuality.Lost:
+                return 'bad';
+            case ConnectionQuality.Unknown:
+            default:
+                return 'unknown';
+        }
+    }
+    static extractRole(metadata) {
+        if (!metadata)
+            return 'member';
+        try {
+            const parsed = JSON.parse(metadata);
+            if (parsed.role &&
+                ['host', 'moderator', 'member', 'viewer'].includes(parsed.role)) {
+                return parsed.role;
+            }
+        }
+        catch {
+            // Invalid JSON, fall through to default
+        }
+        return 'member';
+    }
+    static parseMetadata(metadata) {
+        if (!metadata)
+            return undefined;
+        try {
+            return JSON.parse(metadata);
+        }
+        catch {
+            return { raw: metadata };
+        }
+    }
+    /**
+     * Converts a Web API MediaDeviceKind to SDK DeviceKind.
+     *
+     * @param kind - MediaDeviceKind from LiveKit/Web API
+     * @returns SDK DeviceKind or null if unknown kind
+     */
+    static toDeviceKind(kind) {
+        const mapping = {
+            audioinput: 'audioinput',
+            videoinput: 'videoinput',
+            audiooutput: 'audiooutput',
+        };
+        return mapping[kind] ?? null;
+    }
+}
+//# sourceMappingURL=livekit.mapper.js.map

package/dist/adapters/livekit/livekit.mapper.js.map

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

package/dist/adapters/livekit/livekit.types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * LiveKit adapter configuration options
+ *
+ * Note: We don't re-export LiveKit types (Room, Participant, Track, etc.)
+ * because they're only used internally within this adapter.
+ * Import directly from 'livekit-client' when needed.
+ */
+export interface LiveKitAdapterConfig {
+    /** Enable adaptive streaming (default: true) */
+    adaptiveStream?: boolean;
+    /** Enable dynacast for bandwidth optimization (default: true) */
+    dynacast?: boolean;
+    /** Enable simulcast for video (default: true) */
+    simulcast?: boolean;
+    /** Stop tracks when muted instead of just disabling (default: false) */
+    stopMicTrackOnMute?: boolean;
+}
+/**
+ * Default LiveKit adapter configuration
+ */
+export declare const DEFAULT_LIVEKIT_CONFIG: Required<LiveKitAdapterConfig>;
+//# sourceMappingURL=livekit.types.d.ts.map

package/dist/adapters/livekit/livekit.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.types.d.ts","sourceRoot":"","sources":["../../../src/adapters/livekit/livekit.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,oBAAoB,CAKjE,CAAA"}

package/dist/adapters/livekit/livekit.types.js

@@ -0,0 +1,10 @@
+/**
+ * Default LiveKit adapter configuration
+ */
+export const DEFAULT_LIVEKIT_CONFIG = {
+    adaptiveStream: true,
+    dynacast: true,
+    simulcast: true,
+    stopMicTrackOnMute: false,
+};
+//# sourceMappingURL=livekit.types.js.map

package/dist/adapters/livekit/livekit.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.types.js","sourceRoot":"","sources":["../../../src/adapters/livekit/livekit.types.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,cAAc,EAAE,IAAI;IACpB,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,kBAAkB,EAAE,KAAK;CAC1B,CAAA"}

package/dist/adapters/livekit/service-adapters/index.d.ts

@@ -0,0 +1,4 @@
+export { LiveKitStatsAdapter } from './stats.adapter';
+export { LiveKitRecordingAdapter } from './recording.adapter';
+export { LiveKitTrackAttachmentAdapter } from './track-attachment.adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/livekit/service-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/adapters/livekit/service-adapters/index.js

@@ -0,0 +1,4 @@
+export { LiveKitStatsAdapter } from './stats.adapter';
+export { LiveKitRecordingAdapter } from './recording.adapter';
+export { LiveKitTrackAttachmentAdapter } from './track-attachment.adapter';
+//# sourceMappingURL=index.js.map

package/dist/adapters/livekit/service-adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/adapters/livekit/service-adapters/recording.adapter.d.ts

@@ -0,0 +1,19 @@
+import type { RecordingAdapter } from '../../../core/ports/outbound/recording-adapter.port';
+import type { ServiceContext } from '../../../core/types/service-adapters.types';
+import type { RecordingStartOptions, RecordingStatus, RecordingStatusEvent } from '../../../core/types/recording.types';
+/**
+ * LiveKit implementation of RecordingAdapter.
+ *
+ * Makes HTTP calls to Vroom backend for recording operations.
+ * Recording is a server-side operation, not a LiveKit Room feature.
+ */
+export declare class LiveKitRecordingAdapter implements RecordingAdapter {
+    private serviceContext;
+    constructor(serviceContext: ServiceContext);
+    start(options?: RecordingStartOptions): Promise<string>;
+    stop(recordingId: string): Promise<void>;
+    getStatus(recordingId: string): Promise<RecordingStatus>;
+    onStatusChanged(_callback: (event: RecordingStatusEvent) => void): () => void;
+    destroy(): void;
+}
+//# sourceMappingURL=recording.adapter.d.ts.map

package/dist/adapters/livekit/service-adapters/recording.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/recording.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAA;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAA;AAChF,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACrB,MAAM,qCAAqC,CAAA;AAO5C;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,cAAc,CAAgB;gBAE1B,cAAc,EAAE,cAAc;IAIpC,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9D,eAAe,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI7E,OAAO,IAAI,IAAI;CAGhB"}

package/dist/adapters/livekit/service-adapters/recording.adapter.js

@@ -0,0 +1,30 @@
+import { startRecording, stopRecording, getRecordingStatus, } from '../services/recording.service';
+/**
+ * LiveKit implementation of RecordingAdapter.
+ *
+ * Makes HTTP calls to Vroom backend for recording operations.
+ * Recording is a server-side operation, not a LiveKit Room feature.
+ */
+export class LiveKitRecordingAdapter {
+    constructor(serviceContext) {
+        this.serviceContext = serviceContext;
+    }
+    async start(options) {
+        return startRecording(this.serviceContext, options);
+    }
+    async stop(recordingId) {
+        return stopRecording(this.serviceContext, recordingId);
+    }
+    async getStatus(recordingId) {
+        return getRecordingStatus(this.serviceContext, recordingId);
+    }
+    // TODO: Implement real-time status updates when backend WebSocket is available
+    // Currently not in spec - client should poll getStatus() if needed
+    onStatusChanged(_callback) {
+        return () => { };
+    }
+    destroy() {
+        // No cleanup needed - stateless HTTP calls
+    }
+}
+//# sourceMappingURL=recording.adapter.js.map

package/dist/adapters/livekit/service-adapters/recording.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.adapter.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/recording.adapter.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,+BAA+B,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAGlC,YAAY,cAA8B;QACxC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAA+B;QACzC,OAAO,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,OAAO,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,WAAmB;QACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;IAC7D,CAAC;IAED,+EAA+E;IAC/E,mEAAmE;IACnE,eAAe,CAAC,SAAgD;QAC9D,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;IAED,OAAO;QACL,2CAA2C;IAC7C,CAAC;CACF"}

package/dist/adapters/livekit/service-adapters/stats.adapter.d.ts

@@ -0,0 +1,21 @@
+import type { Room } from 'livekit-client';
+import type { StatsAdapter } from '../../../core/ports/outbound/stats-adapter.port';
+import type { NetworkQuality, NetworkQualityEvent } from '../../../core/types/events.types';
+/**
+ * LiveKit implementation of StatsAdapter.
+ *
+ * Subscribes to LiveKit Room events directly and provides stats functionality
+ * to StatsService without going through ProviderAdapter.
+ */
+export declare class LiveKitStatsAdapter implements StatsAdapter {
+    private room;
+    private callbacks;
+    constructor(room: Room);
+    getNetworkQuality(): NetworkQuality;
+    getStats(): Promise<RTCStatsReport>;
+    onNetworkQualityChanged(callback: (event: NetworkQualityEvent) => void): () => void;
+    destroy(): void;
+    private setupEventListeners;
+    private handleConnectionQualityChanged;
+}
+//# sourceMappingURL=stats.adapter.d.ts.map

package/dist/adapters/livekit/service-adapters/stats.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/stats.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgC,MAAM,gBAAgB,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAA;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAI3F;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,SAAS,CAAuD;gBAE5D,IAAI,EAAE,IAAI;IAKtB,iBAAiB,IAAI,cAAc;IAI7B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAIzC,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IASnF,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,8BAA8B,CAcrC;CACF"}

package/dist/adapters/livekit/service-adapters/stats.adapter.js

@@ -0,0 +1,54 @@
+import { RoomEvent } from 'livekit-client';
+import { LiveKitMapper } from '../livekit.mapper';
+import { getStats, getNetworkQuality } from '../services/stats.service';
+/**
+ * LiveKit implementation of StatsAdapter.
+ *
+ * Subscribes to LiveKit Room events directly and provides stats functionality
+ * to StatsService without going through ProviderAdapter.
+ */
+export class LiveKitStatsAdapter {
+    constructor(room) {
+        this.room = null;
+        this.callbacks = new Set();
+        this.handleConnectionQualityChanged = (quality, participant) => {
+            // Only emit for local participant
+            if (participant === this.room?.localParticipant) {
+                const event = {
+                    quality: LiveKitMapper.toNetworkQuality(quality),
+                    timestamp: Date.now(),
+                };
+                // Notify all callbacks
+                this.callbacks.forEach((callback) => callback(event));
+            }
+        };
+        this.room = room;
+        this.setupEventListeners();
+    }
+    getNetworkQuality() {
+        return getNetworkQuality(this.room);
+    }
+    async getStats() {
+        return getStats(this.room);
+    }
+    onNetworkQualityChanged(callback) {
+        this.callbacks.add(callback);
+        // Return unsubscribe function
+        return () => {
+            this.callbacks.delete(callback);
+        };
+    }
+    destroy() {
+        if (this.room) {
+            this.room.off(RoomEvent.ConnectionQualityChanged, this.handleConnectionQualityChanged);
+        }
+        this.callbacks.clear();
+        this.room = null;
+    }
+    setupEventListeners() {
+        if (!this.room)
+            return;
+        this.room.on(RoomEvent.ConnectionQualityChanged, this.handleConnectionQualityChanged);
+    }
+}
+//# sourceMappingURL=stats.adapter.js.map

package/dist/adapters/livekit/service-adapters/stats.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.adapter.js","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/stats.adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAEvE;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IAI9B,YAAY,IAAU;QAHd,SAAI,GAAgB,IAAI,CAAA;QACxB,cAAS,GAA8C,IAAI,GAAG,EAAE,CAAA;QAsChE,mCAA8B,GAAG,CACvC,OAAmD,EACnD,WAA0B,EACpB,EAAE;YACR,kCAAkC;YAClC,IAAI,WAAW,KAAK,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC;gBAChD,MAAM,KAAK,GAAwB;oBACjC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC;oBAChD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAA;gBAED,uBAAuB;gBACvB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;YACvD,CAAC;QACH,CAAC,CAAA;QAjDC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,mBAAmB,EAAE,CAAA;IAC5B,CAAC;IAED,iBAAiB;QACf,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,uBAAuB,CAAC,QAA8C;QACpE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE5B,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,IAAI,CAAC,8BAA8B,CAAC,CAAA;QACxF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAM;QAEtB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,wBAAwB,EAAE,IAAI,CAAC,8BAA8B,CAAC,CAAA;IACvF,CAAC;CAiBF"}

package/dist/adapters/livekit/service-adapters/track-attachment.adapter.d.ts

@@ -0,0 +1,79 @@
+import { type Room } from 'livekit-client';
+import type { TrackAttachmentAdapter } from '../../../core/ports/outbound/track-attachment-adapter.port';
+/**
+ * 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 declare class LiveKitTrackAttachmentAdapter implements TrackAttachmentAdapter {
+    private room;
+    /** Pending attachments waiting for tracks to be subscribed (Web) */
+    private pendingAttachments;
+    /** Pending view registrations waiting for tracks to be subscribed (Mobile) */
+    private pendingViews;
+    /** Active view registrations (Mobile) */
+    private activeViews;
+    /** ElementInfo instances for each view (Mobile) - Map<trackId, Map<viewId, ElementInfo>> */
+    private elementInfos;
+    /** Cleanup functions for event listeners */
+    private cleanupFns;
+    constructor(room: Room);
+    attach(trackId: string, element: HTMLMediaElement): void;
+    detach(trackId: string, element?: HTMLMediaElement): void;
+    registerTrackView(trackId: string, viewId: string, options?: {
+        width?: number;
+        height?: number;
+        visible?: boolean;
+        onReady?: (streamUrl: string) => void;
+    }): string | null;
+    unregisterTrackView(trackId: string, viewId?: string): void;
+    updateTrackViewLayout(trackId: string, viewId: string, width: number, height: number): void;
+    updateTrackViewVisibility(trackId: string, viewId: string, visible: boolean): void;
+    destroy(): void;
+    /**
+     * 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
+     */
+    private setupEventListeners;
+    /**
+     * Find LiveKit Track by track SID from all participants
+     */
+    private findLiveKitTrack;
+    /**
+     * Add a view to the active views set for a track
+     */
+    private addActiveView;
+    /**
+     * 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
+     */
+    private observeTrackIfNeeded;
+    /**
+     * Stop observing a track view for adaptive streaming.
+     */
+    private stopObservingTrack;
+    /**
+     * 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
+     */
+    private getStreamUrl;
+}
+//# sourceMappingURL=track-attachment.adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"track-attachment.adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/livekit/service-adapters/track-attachment.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,EAKV,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAA;AAwExG;;;;;;;;;;;;GAYG;AACH,qBAAa,6BAA8B,YAAW,sBAAsB;IAC1E,OAAO,CAAC,IAAI,CAAM;IAClB,oEAAoE;IACpE,OAAO,CAAC,kBAAkB,CAAgD;IAC1E,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAAmD;IACvE,yCAAyC;IACzC,OAAO,CAAC,WAAW,CAAsC;IACzD,4FAA4F;IAC5F,OAAO,CAAC,YAAY,CAA6D;IACjF,4CAA4C;IAC5C,OAAO,CAAC,UAAU,CAAwB;gBAE9B,IAAI,EAAE,IAAI;IAKtB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAaxD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IA0BzD,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;KACtC,GACA,MAAM,GAAG,IAAI;IAyBhB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IA+B3D,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI;IAOP,yBAAyB,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,IAAI;IAOP,OAAO,IAAI,IAAI;IAsBf;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA8D3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAWrB"}