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

package/dist/core/types/events.types.d.ts

@@ -0,0 +1,263 @@
+import type { Participant } from './participant.types';
+import type { Track } from './track.types';
+import type { SessionState } from './session.types';
+import type { DeviceKind } from './media.types';
+import type { VroomError } from '../errors/vroom.error';
+/**
+ * Network quality level.
+ *
+ * - `excellent` - Strong connection, high quality
+ * - `good` - Stable connection
+ * - `poor` - May experience lag or quality drops
+ * - `bad` - Unstable, consider showing warning to user
+ * - `unknown` - Quality cannot be determined
+ */
+export type NetworkQuality = 'excellent' | 'good' | 'poor' | 'bad' | 'unknown';
+/**
+ * Disconnect reason
+ */
+export type DisconnectReason = 'client-initiated' | 'server-initiated' | 'network-error' | 'duplicate-identity' | 'room-deleted' | 'participant-removed' | 'unknown';
+/**
+ * Participant event payload
+ */
+export interface ParticipantEvent {
+    /** Participant info */
+    participant: Participant;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Track event payload
+ */
+export interface TrackEvent {
+    /** Track info */
+    track: Track;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Track enabled/disabled event payload
+ */
+export interface TrackEnabledEvent {
+    /** Track ID */
+    trackId: string;
+    /** Whether the track is enabled */
+    enabled: boolean;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Active speaker changed event payload
+ */
+export interface ActiveSpeakerEvent {
+    /** Active speaker's participant ID, null when no one is speaking */
+    participantId: string | null;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Network quality event payload
+ */
+export interface NetworkQualityEvent {
+    /** Network quality level */
+    quality: NetworkQuality;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Session state changed event payload
+ * @deprecated Use specific events like Connected, Disconnected, Reconnecting, Reconnected instead
+ */
+export interface StateChangedEvent {
+    /** Current state */
+    state: SessionState;
+    /** Previous state */
+    previousState?: SessionState;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Connected event payload - fired when successfully connected to the room
+ */
+export interface ConnectedEvent {
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Disconnected event payload - fired when disconnected from the room
+ */
+export interface DisconnectedEvent {
+    /** Reason for disconnection */
+    reason: DisconnectReason;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Reconnecting event payload - fired when attempting to reconnect
+ */
+export interface ReconnectingEvent {
+    /** Current retry attempt number */
+    attempt: number;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Reconnected event payload - fired when successfully reconnected
+ */
+export interface ReconnectedEvent {
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Error event payload
+ */
+export interface ErrorEvent {
+    /** Error info */
+    error: VroomError;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Screen share started event payload
+ */
+export interface ScreenShareStartedEvent {
+    /** Screen track */
+    track: Track;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Screen share stopped event payload
+ */
+export interface ScreenShareStoppedEvent {
+    /** Screen track ID */
+    trackId: string;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Active device changed event payload.
+ * Fired when the active audio/video device changes (manual or automatic).
+ */
+export interface ActiveDeviceChangedEvent {
+    /** Device kind that changed */
+    kind: DeviceKind;
+    /** New device ID (or undefined if no device available) */
+    deviceId: string | undefined;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Session event names as const object.
+ *
+ * Use `SessionEvent.ParticipantJoined` instead of `'participant-joined'`
+ * for better autocomplete and refactoring support.
+ *
+ * @example
+ * ```typescript
+ * session.on(SessionEvent.Connected, () => {
+ *   console.log('Connected to room!')
+ * })
+ *
+ * session.on(SessionEvent.ParticipantJoined, (event) => {
+ *   console.log('Joined:', event.participant.displayName)
+ * })
+ *
+ * session.on(SessionEvent.Disconnected, (event) => {
+ *   console.log('Disconnected:', event.reason)
+ * })
+ * ```
+ */
+export declare const SessionEvent: {
+    /** Fired when successfully connected to the room */
+    readonly Connected: "connected";
+    /** Fired when disconnected from the room */
+    readonly Disconnected: "disconnected";
+    /** Fired when attempting to reconnect after connection loss */
+    readonly Reconnecting: "reconnecting";
+    /** Fired when successfully reconnected */
+    readonly Reconnected: "reconnected";
+    /** Fired when a participant joins the session */
+    readonly ParticipantJoined: "participant-joined";
+    /** Fired when a participant leaves the session */
+    readonly ParticipantLeft: "participant-left";
+    /** Fired when a track is added */
+    readonly TrackAdded: "track-added";
+    /** Fired when a track is removed */
+    readonly TrackRemoved: "track-removed";
+    /** Fired when a track is enabled or disabled */
+    readonly TrackEnabled: "track-enabled";
+    /**
+     * Fired when a local track's underlying MediaStreamTrack is replaced.
+     *
+     * This happens when user disables then re-enables camera/microphone:
+     * - disable: MediaStreamTrack.stop() → readyState becomes 'ended'
+     * - enable: getUserMedia() creates new MediaStreamTrack
+     *
+     * Only fires for local tracks. Remote tracks reuse the same MediaStreamTrack.
+     */
+    readonly LocalTrackRestarted: "local-track-restarted";
+    /** Fired when screen sharing starts */
+    readonly ScreenShareStarted: "screen-share-started";
+    /** Fired when screen sharing stops */
+    readonly ScreenShareStopped: "screen-share-stopped";
+    /** Fired when the active speaker changes */
+    readonly ActiveSpeakerChanged: "active-speaker-changed";
+    /** Fired when active audio/video device changes (manual or automatic) */
+    readonly ActiveDeviceChanged: "active-device-changed";
+    /**
+     * Fired when session state changes
+     * @deprecated Use Connected, Disconnected, Reconnecting, Reconnected instead
+     */
+    readonly StateChanged: "state-changed";
+    /** Fired when an error occurs */
+    readonly Error: "error";
+};
+/**
+ * Session event name type.
+ *
+ * Union of all possible event names:
+ * `'connected' | 'disconnected' | 'participant-joined' | ...`
+ */
+export type SessionEventName = (typeof SessionEvent)[keyof typeof SessionEvent];
+/**
+ * Event handlers for session events
+ */
+export interface EventHandlers {
+    /** Fired when successfully connected to the room */
+    [SessionEvent.Connected]?: (event: ConnectedEvent) => void;
+    /** Fired when disconnected from the room */
+    [SessionEvent.Disconnected]?: (event: DisconnectedEvent) => void;
+    /** Fired when attempting to reconnect */
+    [SessionEvent.Reconnecting]?: (event: ReconnectingEvent) => void;
+    /** Fired when successfully reconnected */
+    [SessionEvent.Reconnected]?: (event: ReconnectedEvent) => void;
+    /** Fired when a participant joins the session */
+    [SessionEvent.ParticipantJoined]?: (event: ParticipantEvent) => void;
+    /** Fired when a participant leaves the session */
+    [SessionEvent.ParticipantLeft]?: (event: ParticipantEvent) => void;
+    /** Fired when a track is added */
+    [SessionEvent.TrackAdded]?: (event: TrackEvent) => void;
+    /** Fired when a track is removed */
+    [SessionEvent.TrackRemoved]?: (event: TrackEvent) => void;
+    /** Fired when a track is enabled or disabled */
+    [SessionEvent.TrackEnabled]?: (event: TrackEnabledEvent) => void;
+    /** Fired when a local track's MediaStreamTrack is replaced (on mute→unmute) */
+    [SessionEvent.LocalTrackRestarted]?: (event: TrackEvent) => void;
+    /** Fired when screen sharing starts */
+    [SessionEvent.ScreenShareStarted]?: (event: ScreenShareStartedEvent) => void;
+    /** Fired when screen sharing stops */
+    [SessionEvent.ScreenShareStopped]?: (event: ScreenShareStoppedEvent) => void;
+    /** Fired when the active speaker changes */
+    [SessionEvent.ActiveSpeakerChanged]?: (event: ActiveSpeakerEvent) => void;
+    /** Fired when active audio/video device changes (manual or automatic) */
+    [SessionEvent.ActiveDeviceChanged]?: (event: ActiveDeviceChangedEvent) => void;
+    /**
+     * Fired when session state changes
+     * @deprecated Use Connected, Disconnected, Reconnecting, Reconnected instead
+     */
+    [SessionEvent.StateChanged]?: (event: StateChangedEvent) => void;
+    /** Fired when an error occurs */
+    [SessionEvent.Error]?: (event: ErrorEvent) => void;
+}
+//# sourceMappingURL=events.types.d.ts.map

package/dist/core/types/events.types.d.ts.map

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

package/dist/core/types/events.types.js

@@ -0,0 +1,76 @@
+// ============================================================
+// Session Event Constants
+// ============================================================
+/**
+ * Session event names as const object.
+ *
+ * Use `SessionEvent.ParticipantJoined` instead of `'participant-joined'`
+ * for better autocomplete and refactoring support.
+ *
+ * @example
+ * ```typescript
+ * session.on(SessionEvent.Connected, () => {
+ *   console.log('Connected to room!')
+ * })
+ *
+ * session.on(SessionEvent.ParticipantJoined, (event) => {
+ *   console.log('Joined:', event.participant.displayName)
+ * })
+ *
+ * session.on(SessionEvent.Disconnected, (event) => {
+ *   console.log('Disconnected:', event.reason)
+ * })
+ * ```
+ */
+export const SessionEvent = {
+    // ============ Connection Events ============
+    /** Fired when successfully connected to the room */
+    Connected: 'connected',
+    /** Fired when disconnected from the room */
+    Disconnected: 'disconnected',
+    /** Fired when attempting to reconnect after connection loss */
+    Reconnecting: 'reconnecting',
+    /** Fired when successfully reconnected */
+    Reconnected: 'reconnected',
+    // ============ Participant Events ============
+    /** Fired when a participant joins the session */
+    ParticipantJoined: 'participant-joined',
+    /** Fired when a participant leaves the session */
+    ParticipantLeft: 'participant-left',
+    // ============ Track Events ============
+    /** Fired when a track is added */
+    TrackAdded: 'track-added',
+    /** Fired when a track is removed */
+    TrackRemoved: 'track-removed',
+    /** Fired when a track is enabled or disabled */
+    TrackEnabled: 'track-enabled',
+    /**
+     * Fired when a local track's underlying MediaStreamTrack is replaced.
+     *
+     * This happens when user disables then re-enables camera/microphone:
+     * - disable: MediaStreamTrack.stop() → readyState becomes 'ended'
+     * - enable: getUserMedia() creates new MediaStreamTrack
+     *
+     * Only fires for local tracks. Remote tracks reuse the same MediaStreamTrack.
+     */
+    LocalTrackRestarted: 'local-track-restarted',
+    // ============ Media Events ============
+    /** Fired when screen sharing starts */
+    ScreenShareStarted: 'screen-share-started',
+    /** Fired when screen sharing stops */
+    ScreenShareStopped: 'screen-share-stopped',
+    /** Fired when the active speaker changes */
+    ActiveSpeakerChanged: 'active-speaker-changed',
+    // ============ Device Events ============
+    /** Fired when active audio/video device changes (manual or automatic) */
+    ActiveDeviceChanged: 'active-device-changed',
+    // ============ Other Events ============
+    /**
+     * Fired when session state changes
+     * @deprecated Use Connected, Disconnected, Reconnecting, Reconnected instead
+     */
+    StateChanged: 'state-changed',
+    /** Fired when an error occurs */
+    Error: 'error',
+};
+//# sourceMappingURL=events.types.js.map

package/dist/core/types/events.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.types.js","sourceRoot":"","sources":["../../../src/core/types/events.types.ts"],"names":[],"mappings":"AAiLA,+DAA+D;AAC/D,0BAA0B;AAC1B,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,8CAA8C;IAC9C,oDAAoD;IACpD,SAAS,EAAE,WAAW;IACtB,4CAA4C;IAC5C,YAAY,EAAE,cAAc;IAC5B,+DAA+D;IAC/D,YAAY,EAAE,cAAc;IAC5B,0CAA0C;IAC1C,WAAW,EAAE,aAAa;IAE1B,+CAA+C;IAC/C,iDAAiD;IACjD,iBAAiB,EAAE,oBAAoB;IACvC,kDAAkD;IAClD,eAAe,EAAE,kBAAkB;IAEnC,yCAAyC;IACzC,kCAAkC;IAClC,UAAU,EAAE,aAAa;IACzB,oCAAoC;IACpC,YAAY,EAAE,eAAe;IAC7B,gDAAgD;IAChD,YAAY,EAAE,eAAe;IAC7B;;;;;;;;OAQG;IACH,mBAAmB,EAAE,uBAAuB;IAE5C,yCAAyC;IACzC,uCAAuC;IACvC,kBAAkB,EAAE,sBAAsB;IAC1C,sCAAsC;IACtC,kBAAkB,EAAE,sBAAsB;IAC1C,4CAA4C;IAC5C,oBAAoB,EAAE,wBAAwB;IAE9C,0CAA0C;IAC1C,yEAAyE;IACzE,mBAAmB,EAAE,uBAAuB;IAE5C,yCAAyC;IACzC;;;OAGG;IACH,YAAY,EAAE,eAAe;IAC7B,iCAAiC;IACjC,KAAK,EAAE,OAAO;CACN,CAAA"}

package/dist/core/types/media.types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Audio constraints for media capture
+ */
+export interface AudioConstraints {
+    /** Audio device ID */
+    deviceId?: string;
+    /** Enable echo cancellation */
+    echoCancellation?: boolean;
+    /** Enable noise suppression */
+    noiseSuppression?: boolean;
+    /** Enable auto gain control */
+    autoGainControl?: boolean;
+}
+/**
+ * Video constraints for media capture
+ */
+export interface VideoConstraints {
+    /** Video device ID */
+    deviceId?: string;
+    /** Camera facing mode */
+    facingMode?: 'user' | 'environment';
+    /** Video resolution */
+    resolution?: {
+        width?: number;
+        height?: number;
+    };
+    /** Frame rate */
+    frameRate?: number;
+}
+/**
+ * Media options for session
+ */
+export interface MediaOptions {
+    /** Audio settings */
+    audio?: boolean | AudioConstraints;
+    /** Video settings */
+    video?: boolean | VideoConstraints;
+}
+/**
+ * Device kind for audio/video devices.
+ */
+export declare const DeviceKind: {
+    /** Microphone */
+    readonly AudioInput: "audioinput";
+    /** Camera */
+    readonly VideoInput: "videoinput";
+    /** Speaker (Web only, limited browser support) */
+    readonly AudioOutput: "audiooutput";
+};
+export type DeviceKind = (typeof DeviceKind)[keyof typeof DeviceKind];
+/**
+ * Options for switching audio/video device.
+ *
+ * All fields are optional - only specified devices will be switched.
+ * Each device kind is switched independently in sequence.
+ */
+export interface SwitchDeviceOptions {
+    /** Audio input device ID (microphone) */
+    audioInputId?: string;
+    /** Video input device ID (camera) */
+    videoInputId?: string;
+    /**
+     * Audio output device ID (speaker).
+     *
+     * **Browser Support:** Requires `setSinkId` API.
+     * Not supported on Safari, iOS, or React Native.
+     */
+    audioOutputId?: string;
+}
+/**
+ * Options for screen sharing
+ */
+export interface ScreenShareOptions {
+    /** Show cursor (default: true) */
+    cursor?: boolean;
+    /** Share system audio (default: false) */
+    audio?: boolean;
+    /** Specific surface type */
+    displaySurface?: 'monitor' | 'window' | 'browser';
+}
+//# sourceMappingURL=media.types.d.ts.map

package/dist/core/types/media.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/media.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAA;IACnC,uBAAuB;IACvB,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAA;IAClC,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAA;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,iBAAiB;;IAEjB,aAAa;;IAEb,kDAAkD;;CAE1C,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,4BAA4B;IAC5B,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;CAClD"}

package/dist/core/types/media.types.js

@@ -0,0 +1,12 @@
+/**
+ * Device kind for audio/video devices.
+ */
+export const DeviceKind = {
+    /** Microphone */
+    AudioInput: 'audioinput',
+    /** Camera */
+    VideoInput: 'videoinput',
+    /** Speaker (Web only, limited browser support) */
+    AudioOutput: 'audiooutput',
+};
+//# sourceMappingURL=media.types.js.map

package/dist/core/types/media.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.types.js","sourceRoot":"","sources":["../../../src/core/types/media.types.ts"],"names":[],"mappings":"AAsCA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,iBAAiB;IACjB,UAAU,EAAE,YAAY;IACxB,aAAa;IACb,UAAU,EAAE,YAAY;IACxB,kDAAkD;IAClD,WAAW,EAAE,aAAa;CAClB,CAAA"}

package/dist/core/types/participant.types.d.ts

@@ -0,0 +1,11 @@
+import type { User } from './user.types';
+/**
+ * Participant in a session (extends User with session-specific info)
+ */
+export interface Participant extends User {
+    /** Timestamp when participant joined */
+    joinedAt?: number;
+    /** Whether this is the local user */
+    isLocal?: boolean;
+}
+//# sourceMappingURL=participant.types.d.ts.map

package/dist/core/types/participant.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participant.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/participant.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}

package/dist/core/types/participant.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=participant.types.js.map

package/dist/core/types/participant.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"participant.types.js","sourceRoot":"","sources":["../../../src/core/types/participant.types.ts"],"names":[],"mappings":""}

package/dist/core/types/recording.types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Recording layout options
+ */
+export type RecordingLayout = 'grid' | 'speaker-only' | 'custom';
+/**
+ * Recording state
+ */
+export type RecordingState = 'starting' | 'recording' | 'stopped' | 'failed';
+/**
+ * Options for starting a recording
+ */
+export interface RecordingStartOptions {
+    /** Recording layout (default: "grid") */
+    layout?: RecordingLayout;
+    /** Record audio only without video (default: false) */
+    audioOnly?: boolean;
+    /** Video resolution (default: 720p) */
+    resolution?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Recording status response
+ */
+export interface RecordingStatus {
+    /** Recording ID */
+    recordingId: string;
+    /** Current state */
+    state: RecordingState;
+    /** Duration in seconds */
+    duration: number;
+}
+/**
+ * Recording status change event payload
+ */
+export interface RecordingStatusEvent {
+    /** Recording ID */
+    recordingId: string;
+    /** New state */
+    state: RecordingState;
+}
+/**
+ * Recording service event names
+ */
+export declare const RecordingEvent: {
+    readonly Status: "status";
+};
+export type RecordingEventName = (typeof RecordingEvent)[keyof typeof RecordingEvent];
+/**
+ * Recording event handler types mapped by event name
+ */
+export interface RecordingEventMap {
+    [RecordingEvent.Status]: (event: RecordingStatusEvent) => void;
+}
+/**
+ * Recording event handler type (union of all possible handlers)
+ */
+export type RecordingEventHandler = RecordingEventMap[RecordingEventName];
+//# sourceMappingURL=recording.types.d.ts.map

package/dist/core/types/recording.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/recording.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,uCAAuC;IACvC,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,oBAAoB;IACpB,KAAK,EAAE,cAAc,CAAA;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB;IAChB,KAAK,EAAE,cAAc,CAAA;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;CAEjB,CAAA;AAEV,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;AAErF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;CAC/D;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAA"}

package/dist/core/types/recording.types.js

@@ -0,0 +1,7 @@
+/**
+ * Recording service event names
+ */
+export const RecordingEvent = {
+    Status: 'status',
+};
+//# sourceMappingURL=recording.types.js.map

package/dist/core/types/recording.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.types.js","sourceRoot":"","sources":["../../../src/core/types/recording.types.ts"],"names":[],"mappings":"AA+CA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,QAAQ;CACR,CAAA"}

package/dist/core/types/service-adapters.types.d.ts

@@ -0,0 +1,46 @@
+import type { StatsAdapter } from '../ports/outbound/stats-adapter.port';
+import type { RecordingAdapter } from '../ports/outbound/recording-adapter.port';
+import type { TrackAttachmentAdapter } from '../ports/outbound/track-attachment-adapter.port';
+/**
+ * Context for service adapters that need to call backend APIs.
+ *
+ * Passed to ProviderAdapter during creation so service adapters
+ * can make authenticated API calls (e.g., recording start/stop).
+ */
+export interface ServiceContext {
+    /** Session token for authenticating backend API calls */
+    sessionToken: string;
+    /** Vroom API endpoint base URL */
+    apiEndpoint: string;
+}
+/**
+ * Service adapters provided by ProviderAdapter.
+ *
+ * Different API keys/plans may have access to different services.
+ * Required services are always present, optional services may be undefined
+ * based on user permissions.
+ */
+export interface ServiceAdapters {
+    /**
+     * Stats adapter (required for all plans)
+     */
+    stats: StatsAdapter;
+    /**
+     * Chat adapter (optional - Pro+ plans)
+     */
+    chat?: unknown;
+    /**
+     * Recording adapter (optional - requires "recording" feature + host/moderator role)
+     */
+    recording?: RecordingAdapter;
+    /**
+     * Whiteboard adapter (optional - Enterprise plans)
+     */
+    whiteboard?: unknown;
+    /**
+     * Track attachment adapter (required for all plans)
+     * Used for attaching tracks to media elements with proper provider integration
+     */
+    trackAttachment: TrackAttachmentAdapter;
+}
+//# sourceMappingURL=service-adapters.types.d.ts.map

package/dist/core/types/service-adapters.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-adapters.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/service-adapters.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAA;AAE7F;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,YAAY,CAAA;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;OAGG;IACH,eAAe,EAAE,sBAAsB,CAAA;CACxC"}

package/dist/core/types/service-adapters.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service-adapters.types.js.map

package/dist/core/types/service-adapters.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-adapters.types.js","sourceRoot":"","sources":["../../../src/core/types/service-adapters.types.ts"],"names":[],"mappings":""}