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

package/dist/core/ports/outbound/provider-adapter.port.d.ts

@@ -0,0 +1,130 @@
+import type { MediaOptions, SwitchDeviceOptions, DeviceKind } from '../../types/media.types';
+import type { SessionEventName, EventHandlers, NetworkQuality } from '../../types/events.types';
+import type { Track } from '../../types/track.types';
+import type { Participant } from '../../types/participant.types';
+import type { User } from '../../types/user.types';
+import type { ServiceAdapters } from '../../types/service-adapters.types';
+import type { SessionPermissions } from '../../types/token.types';
+/**
+ * Capability reported by adapter
+ */
+export interface Capability {
+    /** Feature name */
+    feature: string;
+    /** Whether feature is supported */
+    supported: boolean;
+    /** Optional limitations */
+    limitations?: Record<string, unknown>;
+}
+/**
+ * Options for adapter connection
+ */
+export interface AdapterConnectOptions {
+    /** Room name */
+    roomName: string;
+    /** Provider token (from backend) */
+    token: string;
+    /** Provider endpoint */
+    endpoint: string;
+    /** Initial media options */
+    media?: MediaOptions;
+    /** User info (displayName, role) for provider metadata */
+    user: User;
+}
+/**
+ * Provider adapter interface.
+ *
+ * All RTC providers (LiveKit, Banuba, custom) must implement this interface.
+ * This allows Vroom SDK to be provider-agnostic.
+ */
+export interface ProviderAdapter {
+    /**
+     * Connect to the provider
+     */
+    connect(options: AdapterConnectOptions): Promise<void>;
+    /**
+     * Disconnect from the provider
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Publish a track (audio/video/screen)
+     */
+    publishTrack(track: MediaStreamTrack): Promise<Track>;
+    /**
+     * Unpublish a track
+     */
+    unpublishTrack(trackId: string): Promise<void>;
+    /**
+     * Mute a track kind (audio/video)
+     * @throws VroomError if operation fails (e.g., device disconnected)
+     */
+    muteTrack(kind: 'audio' | 'video'): Promise<void>;
+    /**
+     * Unmute a track kind (audio/video)
+     * @throws VroomError if operation fails (e.g., permission denied)
+     */
+    unmuteTrack(kind: 'audio' | 'video'): Promise<void>;
+    /**
+     * Switch active device for audio/video input or output.
+     *
+     * Each device kind is switched independently in sequence (fail-fast).
+     * Successfully switched devices remain changed even if a subsequent switch fails.
+     *
+     * @param options - Device IDs to switch to (only specified devices are switched)
+     * @throws VroomError(E_MEDIA) if device switch fails
+     * @throws VroomError(E_UNSUPPORTED_FEATURE) if audioOutputId used on unsupported browser
+     */
+    switchDevice(options: SwitchDeviceOptions): Promise<void>;
+    /**
+     * Get currently active device ID for a given kind.
+     *
+     * @param kind - Device kind to query
+     * @returns Device ID or undefined if not set/connected
+     */
+    getActiveDevice(kind: DeviceKind): string | undefined;
+    /**
+     * Register event handler
+     */
+    on<E extends SessionEventName>(event: E, handler: NonNullable<EventHandlers[E]>): void;
+    /**
+     * Remove event handler
+     */
+    off<E extends SessionEventName>(event: E, handler?: NonNullable<EventHandlers[E]>): void;
+    /**
+     * Get native RTC stats report.
+     *
+     * Returns raw RTCStatsReport from RTCPeerConnection for user to parse.
+     *
+     * @returns Native RTCStatsReport containing all WebRTC statistics
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/RTCStatsReport
+     */
+    getStats(): Promise<RTCStatsReport>;
+    /**
+     * Get current network quality
+     */
+    getNetworkQuality(): NetworkQuality;
+    /**
+     * Get supported capabilities
+     */
+    getCapabilities(): Capability[];
+    /**
+     * Get all participants
+     */
+    getParticipants(): Participant[];
+    /**
+     * Get all tracks in the session
+     */
+    getTracks(): Track[];
+    /**
+     * Create all service adapters at once.
+     *
+     * Different API keys/plans may have access to different services.
+     * The adapter should check permissions and only return adapters for
+     * services the user has access to.
+     *
+     * @param permissions - Session permissions from decoded sessionToken
+     * @returns ServiceAdapters object with required and optional service adapters
+     */
+    createServiceAdapters(permissions: SessionPermissions): ServiceAdapters;
+}
+//# sourceMappingURL=provider-adapter.port.d.ts.map

package/dist/core/ports/outbound/provider-adapter.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.port.d.ts","sourceRoot":"","sources":["../../../../src/core/ports/outbound/provider-adapter.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC/F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAA;IAClB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,0DAA0D;IAC1D,IAAI,EAAE,IAAI,CAAA;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAErD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnD;;;;;;;;;OASG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAA;IAErD;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,gBAAgB,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GACrC,IAAI,CAAA;IAEP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,gBAAgB,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GACtC,IAAI,CAAA;IAEP;;;;;;;OAOG;IACH,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAEnC;;OAEG;IACH,iBAAiB,IAAI,cAAc,CAAA;IAEnC;;OAEG;IACH,eAAe,IAAI,UAAU,EAAE,CAAA;IAE/B;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE,CAAA;IAEhC;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE,CAAA;IAEpB;;;;;;;;;OASG;IACH,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,eAAe,CAAA;CACxE"}

package/dist/core/ports/outbound/provider-adapter.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-adapter.port.js.map

package/dist/core/ports/outbound/provider-adapter.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.port.js","sourceRoot":"","sources":["../../../../src/core/ports/outbound/provider-adapter.port.ts"],"names":[],"mappings":""}

package/dist/core/ports/outbound/recording-adapter.port.d.ts

@@ -0,0 +1,40 @@
+import type { RecordingStartOptions, RecordingStatus, RecordingStatusEvent } from '../../types/recording.types';
+/**
+ * Recording adapter interface.
+ *
+ * Provider-specific implementations must implement this interface
+ * to provide recording functionality to RecordingService.
+ *
+ * Unlike StatsAdapter which uses local RTC events, RecordingAdapter
+ * makes HTTP calls to Vroom backend for recording operations.
+ */
+export interface RecordingAdapter {
+    /**
+     * Start recording
+     * @param options - Recording options (layout, audioOnly, resolution)
+     * @returns Recording ID
+     */
+    start(options?: RecordingStartOptions): Promise<string>;
+    /**
+     * Stop recording
+     * @param recordingId - ID of the recording to stop
+     */
+    stop(recordingId: string): Promise<void>;
+    /**
+     * Get recording status
+     * @param recordingId - ID of the recording
+     * @returns Recording status
+     */
+    getStatus(recordingId: string): Promise<RecordingStatus>;
+    /**
+     * Subscribe to recording status changes
+     * @param callback - Called when recording status changes
+     * @returns Unsubscribe function
+     */
+    onStatusChanged(callback: (event: RecordingStatusEvent) => void): () => void;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=recording-adapter.port.d.ts.map

package/dist/core/ports/outbound/recording-adapter.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-adapter.port.d.ts","sourceRoot":"","sources":["../../../../src/core/ports/outbound/recording-adapter.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAE/G;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEvD;;;OAGG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAExD;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAE5E;;OAEG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB"}

package/dist/core/ports/outbound/recording-adapter.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recording-adapter.port.js.map

package/dist/core/ports/outbound/recording-adapter.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-adapter.port.js","sourceRoot":"","sources":["../../../../src/core/ports/outbound/recording-adapter.port.ts"],"names":[],"mappings":""}

package/dist/core/ports/outbound/stats-adapter.port.d.ts

@@ -0,0 +1,31 @@
+import type { NetworkQuality, NetworkQualityEvent } from '../../types/events.types';
+/**
+ * Stats adapter interface.
+ *
+ * Provider-specific implementations (LiveKit, etc.) must implement this interface
+ * to provide stats functionality to StatsService.
+ *
+ * This allows StatsService to be completely independent from ProviderAdapter
+ * and have its own event system.
+ */
+export interface StatsAdapter {
+    /**
+     * Get current network quality
+     */
+    getNetworkQuality(): NetworkQuality;
+    /**
+     * Get native RTC stats report
+     */
+    getStats(): Promise<RTCStatsReport>;
+    /**
+     * Subscribe to network quality changes
+     * @param callback - Called when network quality changes
+     * @returns Unsubscribe function
+     */
+    onNetworkQualityChanged(callback: (event: NetworkQualityEvent) => void): () => void;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=stats-adapter.port.d.ts.map

package/dist/core/ports/outbound/stats-adapter.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-adapter.port.d.ts","sourceRoot":"","sources":["../../../../src/core/ports/outbound/stats-adapter.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnF;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,iBAAiB,IAAI,cAAc,CAAA;IAEnC;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAEnC;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAEnF;;OAEG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB"}

package/dist/core/ports/outbound/stats-adapter.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stats-adapter.port.js.map

package/dist/core/ports/outbound/stats-adapter.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-adapter.port.js","sourceRoot":"","sources":["../../../../src/core/ports/outbound/stats-adapter.port.ts"],"names":[],"mappings":""}

package/dist/core/ports/outbound/track-attachment-adapter.port.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Track attachment adapter interface.
+ *
+ * Provider-specific implementations (LiveKit, etc.) must implement this interface
+ * to provide track attachment functionality.
+ *
+ * This is necessary because some providers (like LiveKit) use adaptive streaming
+ * that requires knowing which elements are displaying tracks. Using srcObject
+ * directly bypasses this and may result in frozen frames after mute/unmute cycles.
+ *
+ * ## Platform Support
+ *
+ * - **Web:** Use `attach()` / `detach()` with HTMLMediaElement
+ * - **Mobile:** Use `registerTrackView()` / `unregisterTrackView()` with view IDs
+ *   (React Native, NativeScript, Capacitor, etc.)
+ */
+export interface TrackAttachmentAdapter {
+    /**
+     * Attach a track to a media element.
+     * This notifies the provider that this element is displaying the track,
+     * enabling proper frame delivery and adaptive streaming.
+     *
+     * @param trackId - The track ID to attach
+     * @param element - The HTMLMediaElement (video or audio) to attach to
+     */
+    attach(trackId: string, element: HTMLMediaElement): void;
+    /**
+     * Detach a track from a media element.
+     * This notifies the provider that this element is no longer displaying the track.
+     *
+     * @param trackId - The track ID to detach
+     * @param element - Optional specific element to detach from. If not provided, detaches from all elements.
+     */
+    detach(trackId: string, element?: HTMLMediaElement): void;
+    /**
+     * Register a track view for mobile platforms.
+     * This notifies the provider for adaptive streaming optimization and returns the stream URL.
+     *
+     * @param trackId - The track ID being displayed
+     * @param viewId - Unique identifier for the view/component displaying this track
+     * @param options - Optional view configuration for adaptive streaming
+     * @param options.width - Initial view width in pixels
+     * @param options.height - Initial view height in pixels
+     * @param options.visible - Initial visibility state (default: true)
+     * @param options.onReady - Callback invoked when track becomes ready (if not immediately available)
+     * @returns Stream URL for the video view, or null if track not ready yet
+     */
+    registerTrackView(trackId: string, viewId: string, options?: {
+        width?: number;
+        height?: number;
+        visible?: boolean;
+        onReady?: (streamUrl: string) => void;
+    }): string | null;
+    /**
+     * Unregister a track view.
+     * Call this when the component unmounts or stops displaying the track.
+     *
+     * @param trackId - The track ID
+     * @param viewId - The view identifier (optional, unregisters all views for this track if not provided)
+     */
+    unregisterTrackView(trackId: string, viewId?: string): void;
+    /**
+     * Update the dimensions of a registered track view.
+     * Call this when the view layout changes (e.g., onLayout in React Native).
+     *
+     * @param trackId - The track ID
+     * @param viewId - The view identifier
+     * @param width - New width in pixels
+     * @param height - New height in pixels
+     */
+    updateTrackViewLayout(trackId: string, viewId: string, width: number, height: number): void;
+    /**
+     * Update the visibility of a registered track view.
+     * Call this when the view visibility changes (e.g., scrolled off screen).
+     *
+     * @param trackId - The track ID
+     * @param viewId - The view identifier
+     * @param visible - Whether the view is visible
+     */
+    updateTrackViewVisibility(trackId: string, viewId: string, visible: boolean): void;
+    /**
+     * Cleanup all resources and pending callbacks.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=track-attachment-adapter.port.d.ts.map

package/dist/core/ports/outbound/track-attachment-adapter.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-attachment-adapter.port.d.ts","sourceRoot":"","sources":["../../../../src/core/ports/outbound/track-attachment-adapter.port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,sBAAsB;IAKrC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAExD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAMzD;;;;;;;;;;;;OAYG;IACH,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,CAAA;IAEhB;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3D;;;;;;;;OAQG;IACH,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAAA;IAEP;;;;;;;OAOG;IACH,yBAAyB,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,IAAI,CAAA;IAMP;;OAEG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB"}

package/dist/core/ports/outbound/track-attachment-adapter.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=track-attachment-adapter.port.js.map

package/dist/core/ports/outbound/track-attachment-adapter.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-attachment-adapter.port.js","sourceRoot":"","sources":["../../../../src/core/ports/outbound/track-attachment-adapter.port.ts"],"names":[],"mappings":""}

package/dist/core/provider-registry.d.ts

@@ -0,0 +1,29 @@
+import type { ProviderType } from './types/vroom.types';
+import type { ProviderAdapterFactory } from './ports/outbound/provider-adapter-factory.port';
+/**
+ * Register a provider adapter factory.
+ *
+ * Call this before using Vroom.connect() with that provider.
+ */
+export declare function registerProvider(provider: ProviderType, factory: ProviderAdapterFactory): void;
+/**
+ * Get a registered provider adapter factory.
+ *
+ * @internal Used by Vroom class to create adapters
+ */
+export declare function getProviderFactory(provider: ProviderType): ProviderAdapterFactory | undefined;
+/**
+ * Check if a provider is registered.
+ */
+export declare function isProviderRegistered(provider: ProviderType): boolean;
+/**
+ * Get all registered provider types.
+ */
+export declare function getRegisteredProviders(): ProviderType[];
+/**
+ * Clear all registered providers.
+ *
+ * @internal Used for testing
+ */
+export declare function clearProviderRegistry(): void;
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/core/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/core/provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAA;AAY5F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,GACrB,sBAAsB,GAAG,SAAS,CAEpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,EAAE,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/core/provider-registry.js

@@ -0,0 +1,45 @@
+/**
+ * Registry for provider adapter factories.
+ *
+ * Maintains mapping between provider names and their factory implementations.
+ * Allows the core to create adapters without importing concrete implementations,
+ * following Hexagonal Architecture (dependency inversion).
+ */
+const providerRegistry = new Map();
+/**
+ * Register a provider adapter factory.
+ *
+ * Call this before using Vroom.connect() with that provider.
+ */
+export function registerProvider(provider, factory) {
+    providerRegistry.set(provider, factory);
+}
+/**
+ * Get a registered provider adapter factory.
+ *
+ * @internal Used by Vroom class to create adapters
+ */
+export function getProviderFactory(provider) {
+    return providerRegistry.get(provider);
+}
+/**
+ * Check if a provider is registered.
+ */
+export function isProviderRegistered(provider) {
+    return providerRegistry.has(provider);
+}
+/**
+ * Get all registered provider types.
+ */
+export function getRegisteredProviders() {
+    return Array.from(providerRegistry.keys());
+}
+/**
+ * Clear all registered providers.
+ *
+ * @internal Used for testing
+ */
+export function clearProviderRegistry() {
+    providerRegistry.clear();
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/core/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/core/provider-registry.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAwC,CAAA;AAExE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAsB,EACtB,OAA+B;IAE/B,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAsB;IAEtB,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,CAAC,KAAK,EAAE,CAAA;AAC1B,CAAC"}

package/dist/core/services/base.service.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Base service class that all services extend.
+ *
+ * Provides:
+ * - Lifecycle management (destroy)
+ * - Common interface for Session to manage services
+ */
+export declare abstract class BaseService {
+    /**
+     * Cleanup resources when service is destroyed.
+     * Called automatically by Session.disconnect()
+     */
+    abstract destroy(): void;
+}
+//# sourceMappingURL=base.service.d.ts.map

package/dist/core/services/base.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/base.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,8BAAsB,WAAW;IAC/B;;;OAGG;IACH,QAAQ,CAAC,OAAO,IAAI,IAAI;CACzB"}

package/dist/core/services/base.service.js

@@ -0,0 +1,10 @@
+/**
+ * Base service class that all services extend.
+ *
+ * Provides:
+ * - Lifecycle management (destroy)
+ * - Common interface for Session to manage services
+ */
+export class BaseService {
+}
+//# sourceMappingURL=base.service.js.map

package/dist/core/services/base.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.service.js","sourceRoot":"","sources":["../../../src/core/services/base.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAgB,WAAW;CAMhC"}

package/dist/core/services/recording.service.d.ts

@@ -0,0 +1,50 @@
+import type { RecordingAdapter } from '../ports/outbound/recording-adapter.port';
+import type { RecordingStartOptions, RecordingStatus } from '../types/recording.types';
+import { type RecordingEventName, type RecordingEventMap } from '../types/recording.types';
+import { BaseService } from './base.service';
+/**
+ * Recording service for session recording control.
+ *
+ * This service has its own event system completely separate from Session events.
+ * Use `session.recording.on(RecordingEvent.Status, ...)` to listen to recording events.
+ *
+ * Recording requires:
+ * - "recording" feature in sessionToken feat[]
+ * - "host" or "moderator" role for start/stop operations
+ */
+export declare class RecordingService extends BaseService {
+    private recordingAdapter;
+    private eventHandlers;
+    private unsubscribes;
+    constructor(recordingAdapter: RecordingAdapter);
+    /**
+     * Start recording the session.
+     * @param options - Recording options (layout, audioOnly, resolution)
+     * @returns Recording ID
+     * @throws RecordingStartError if recording fails to start
+     */
+    start(options?: RecordingStartOptions): Promise<string>;
+    /**
+     * Stop recording.
+     * @param recordingId - ID of the recording to stop
+     */
+    stop(recordingId: string): Promise<void>;
+    /**
+     * Get recording status.
+     * @param recordingId - ID of the recording
+     * @returns Recording status
+     */
+    getStatus(recordingId: string): Promise<RecordingStatus>;
+    /** Register an event handler for recording events. */
+    on<E extends RecordingEventName>(event: E, handler: RecordingEventMap[E]): void;
+    /** Remove an event handler for recording events. */
+    off<E extends RecordingEventName>(event?: E, handler?: RecordingEventMap[E]): void;
+    /**
+     * Cleanup resources
+     * @internal
+     */
+    destroy(): void;
+    private setupEventListeners;
+    private emit;
+}
+//# sourceMappingURL=recording.service.d.ts.map

package/dist/core/services/recording.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/recording.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AACtF,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,YAAY,CAAqB;gBAE7B,gBAAgB,EAAE,gBAAgB;IAM9C;;;;;OAKG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7D;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;;OAIG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI9D,sDAAsD;IACtD,EAAE,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAO/E,oDAAoD;IACpD,GAAG,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAclF;;;OAGG;IACH,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,IAAI;CAMb"}

package/dist/core/services/recording.service.js

@@ -0,0 +1,89 @@
+import { RecordingEvent, } from '../types/recording.types';
+import { BaseService } from './base.service';
+/**
+ * Recording service for session recording control.
+ *
+ * This service has its own event system completely separate from Session events.
+ * Use `session.recording.on(RecordingEvent.Status, ...)` to listen to recording events.
+ *
+ * Recording requires:
+ * - "recording" feature in sessionToken feat[]
+ * - "host" or "moderator" role for start/stop operations
+ */
+export class RecordingService extends BaseService {
+    constructor(recordingAdapter) {
+        super();
+        this.eventHandlers = new Map();
+        this.unsubscribes = [];
+        this.recordingAdapter = recordingAdapter;
+        this.setupEventListeners();
+    }
+    /**
+     * Start recording the session.
+     * @param options - Recording options (layout, audioOnly, resolution)
+     * @returns Recording ID
+     * @throws RecordingStartError if recording fails to start
+     */
+    async start(options) {
+        return this.recordingAdapter.start(options);
+    }
+    /**
+     * Stop recording.
+     * @param recordingId - ID of the recording to stop
+     */
+    async stop(recordingId) {
+        return this.recordingAdapter.stop(recordingId);
+    }
+    /**
+     * Get recording status.
+     * @param recordingId - ID of the recording
+     * @returns Recording status
+     */
+    async getStatus(recordingId) {
+        return this.recordingAdapter.getStatus(recordingId);
+    }
+    /** Register an event handler for recording events. */
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Set());
+        }
+        this.eventHandlers.get(event).add(handler);
+    }
+    /** Remove an event handler for recording events. */
+    off(event, handler) {
+        if (!event) {
+            this.eventHandlers.clear();
+            return;
+        }
+        if (!handler) {
+            this.eventHandlers.delete(event);
+            return;
+        }
+        this.eventHandlers.get(event)?.delete(handler);
+    }
+    /**
+     * Cleanup resources
+     * @internal
+     */
+    destroy() {
+        this.unsubscribes.forEach(unsubscribe => unsubscribe());
+        this.unsubscribes = [];
+        this.eventHandlers.clear();
+        this.recordingAdapter.destroy();
+    }
+    setupEventListeners() {
+        // Subscribe to recording status changes from adapter
+        const unsubscribe = this.recordingAdapter.onStatusChanged((event) => {
+            // Emit through service's own event emitter
+            this.emit(RecordingEvent.Status, event);
+        });
+        this.unsubscribes.push(unsubscribe);
+    }
+    emit(event, payload) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.forEach((handler) => handler(payload));
+        }
+    }
+}
+//# sourceMappingURL=recording.service.js.map

package/dist/core/services/recording.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.service.js","sourceRoot":"","sources":["../../../src/core/services/recording.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,GAGf,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAK/C,YAAY,gBAAkC;QAC5C,KAAK,EAAE,CAAA;QAJD,kBAAa,GAA2C,IAAI,GAAG,EAAE,CAAA;QACjE,iBAAY,GAAmB,EAAE,CAAA;QAIvC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAA;QACxC,IAAI,CAAC,mBAAmB,EAAE,CAAA;IAC5B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,OAA+B;QACzC,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAChD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACrD,CAAC;IAED,sDAAsD;IACtD,EAAE,CAA+B,KAAQ,EAAE,OAA6B;QACtE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAC1C,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,oDAAoD;IACpD,GAAG,CAA+B,KAAS,EAAE,OAA8B;QACzE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;YAC1B,OAAM;QACR,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAChC,OAAM;QACR,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;QACvD,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAA;IACjC,CAAC;IAEO,mBAAmB;QACzB,qDAAqD;QACrD,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,EAAE;YAClE,2CAA2C;YAC3C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACrC,CAAC;IAEO,IAAI,CAA+B,KAAQ,EAAE,OAA4C;QAC/F,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;CACF"}

package/dist/core/services/stats.service.d.ts

@@ -0,0 +1,32 @@
+import type { StatsAdapter } from '../ports/outbound/stats-adapter.port';
+import type { NetworkQuality } from '../types/events.types';
+import { type StatsEventName, type StatsEventMap } from '../types/stats.types';
+import { BaseService } from './base.service';
+/**
+ * Stats service for network quality and RTC statistics.
+ *
+ * This service has its own event system completely separate from Session events.
+ * Use `session.stats.on(StatsEvent.NetworkQuality, ...)` to listen to stats events.
+ */
+export declare class StatsService extends BaseService {
+    private statsAdapter;
+    private eventHandlers;
+    private unsubscribes;
+    constructor(statsAdapter: StatsAdapter);
+    /** Get current network quality. */
+    getNetworkQuality(): NetworkQuality;
+    /** Get native RTC stats report. */
+    getStats(): Promise<RTCStatsReport>;
+    /** Register an event handler for stats events. */
+    on<E extends StatsEventName>(event: E, handler: StatsEventMap[E]): void;
+    /** Remove an event handler for stats events. */
+    off<E extends StatsEventName>(event?: E, handler?: StatsEventMap[E]): void;
+    /**
+     * Cleanup resources
+     * @internal
+     */
+    destroy(): void;
+    private setupEventListeners;
+    private emit;
+}
+//# sourceMappingURL=stats.service.d.ts.map

package/dist/core/services/stats.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/stats.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,YAAY,CAAqB;gBAE7B,YAAY,EAAE,YAAY;IAMtC,mCAAmC;IACnC,iBAAiB,IAAI,cAAc;IAInC,mCAAmC;IAC7B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAIzC,kDAAkD;IAClD,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAOvE,gDAAgD;IAChD,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAc1E;;;OAGG;IACH,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,IAAI;CAMb"}