skapi-js 2.2.12 → 2.2.13

package/dist/skapi.d.mts

@@ -20,36 +20,93 @@ type RTCIceOption = string | Array<{
     username?: string;
     credential?: string;
 }>;
+/**
+ * What a local track is. The SDK names the tracks it captures itself ('camera', 'microphone',
+ * 'screen'); a stream or track the app passes is 'custom' unless the app names it in share().
+ * The other side reads the name on its 'track' event, as `source`.
+ */
+type RTCMediaSource = 'camera' | 'microphone' | 'screen' | 'custom' | (string & {});
+/** Screen capture: true, or the options of getDisplayMedia() plus a contentHint for the video track. */
+type RTCScreenOption = boolean | (DisplayMediaStreamOptions & {
+    contentHint?: 'text' | 'detail' | 'motion';
+});
+/**
+ * The media a side sends. A MediaStream is sent as it is. An object names what the SDK should
+ * capture: `audio` and `video` are passed to getUserMedia() (a boolean or track constraints),
+ * `screen` to getDisplayMedia(). Omitted, or everything false, sends no media.
+ */
+type RTCMediaOption = MediaStream | (MediaStreamConstraints & {
+    screen?: RTCScreenOption;
+});
+/** Codec order and sender limits, applied to every track of the kind, now and when one is added later. */
+type RTCEncodingOption = {
+    video?: {
+        codecs?: string[];
+        maxBitrate?: number;
+        maxFramerate?: number;
+        scaleResolutionDownBy?: number;
+    };
+    audio?: {
+        codecs?: string[];
+        maxBitrate?: number;
+    };
+};
+/** A data channel to open: a preset name, or RTCDataChannelInit with `protocol` as its label. */
+type RTCChannelOption = RTCDataChannelInit | 'default' | 'text-chat' | 'file-transfer' | 'video-chat' | 'voice-chat' | 'gaming';
 type RTCReceiverParams = {
     ice?: RTCIceOption;
-    media?: {
-        video: boolean;
-        audio: boolean;
-    } | MediaStream | MediaStreamConstraints;
+    icePolicy?: 'all' | 'relay';
+    media?: RTCMediaOption;
+    receive?: {
+        audio?: boolean;
+        video?: boolean;
+    };
+    encoding?: RTCEncodingOption;
+    channels?: RTCChannelOption[];
 };
-type RTCConnectorParams = {
+type RTCConnectorParams = RTCReceiverParams & {
     cid: string;
-    ice?: RTCIceOption;
-    media?: {
-        video: boolean;
-        audio: boolean;
-    } | MediaStream | MediaStreamConstraints;
-    channels?: Array<RTCDataChannelInit | 'text-chat' | 'file-transfer' | 'video-chat' | 'voice-chat' | 'gaming'>;
+    meta?: Record<string, any>;
+    ringTimeout?: number;
 };
 type RTCConnector = {
     hangup: () => void;
     connection: Promise<RTCResolved>;
 };
+/** Options of share(): for 'screen' the getDisplayMedia() options plus contentHint, for 'camera' and 'microphone' the track constraints, for a stream or track of your own `source`, its name on the other side. */
+type RTCShareOptions = {
+    [key: string]: any;
+    contentHint?: 'text' | 'detail' | 'motion';
+    source?: string;
+};
 type RTCResolved = {
+    cid: string;
     target: RTCPeerConnection;
     channels: {
         [protocol: string]: RTCDataChannel;
     };
     hangup: () => void;
     media: MediaStream;
+    meta: Record<string, any>;
+    /** Local tracks, all of them or those of one source. */
+    tracks: (source?: RTCMediaSource) => MediaStreamTrack[];
+    /** Adds the screen, the camera, the microphone, or a stream or track of your own to the call, and resolves with the tracks added. The other side gets them on its 'track' event. */
+    share: (what: 'screen' | 'camera' | 'microphone' | MediaStream | MediaStreamTrack, options?: RTCShareOptions) => Promise<MediaStreamTrack[]>;
+    /** Takes the tracks of a source, or one track, off the call and stops them. */
+    unshare: (what: RTCMediaSource | MediaStreamTrack) => void;
+    /** Swaps a track for another of the same kind without a new negotiation: a camera switch, a new microphone. The old track is stopped. */
+    replace: (what: RTCMediaSource | MediaStreamTrack, track: MediaStreamTrack) => Promise<void>;
+    /** Pauses or resumes what is sent: `audio` the microphone, `video` the camera and other video, `screen` the screen. true pauses, false resumes, omitted leaves it. */
+    mute: (what: {
+        audio?: boolean;
+        video?: boolean;
+        screen?: boolean;
+    }) => void;
+    /** Opens a data channel during the call. */
+    addChannel: (protocol: string, init?: RTCDataChannelInit) => RTCDataChannel;
 };
 type RTCEvent = {
-    type: 'track' | 'connectionstatechange' | 'close' | 'message' | 'open' | 'bufferedamountlow' | 'error' | 'icecandidate' | 'icecandidateend' | 'icegatheringstatechange' | 'negotiationneeded' | 'signalingstatechange';
+    type: 'track' | 'trackmute' | 'trackunmute' | 'trackended' | 'unshare' | 'connectionstatechange' | 'close' | 'message' | 'open' | 'bufferedamountlow' | 'error' | 'icecandidate' | 'icecandidateend' | 'icecandidateerror' | 'iceconnectionstatechange' | 'icegatheringstatechange' | 'negotiationneeded' | 'signalingstatechange' | 'ringtimeout';
     [key: string]: any;
 };
 type WebSocketMessage = {
@@ -57,6 +114,8 @@ type WebSocketMessage = {
     message?: any;
     connectRTC?: (params: RTCReceiverParams, callback: (e: RTCEvent) => void) => Promise<RTCResolved>;
     hangup?: () => void;
+    meta?: Record<string, any>;
+    sources?: string[];
     sender?: string;
     sender_cid?: string;
     sender_rid?: string;
@@ -1311,12 +1370,18 @@ type Types_PostRecordConfig = PostRecordConfig;
 type Types_PostRecordsItem = PostRecordsItem;
 type Types_PostRecordsResult = PostRecordsResult;
 type Types_ProgressCallback = ProgressCallback;
+type Types_RTCChannelOption = RTCChannelOption;
 type Types_RTCConnector = RTCConnector;
 type Types_RTCConnectorParams = RTCConnectorParams;
+type Types_RTCEncodingOption = RTCEncodingOption;
 type Types_RTCEvent = RTCEvent;
 type Types_RTCIceOption = RTCIceOption;
+type Types_RTCMediaOption = RTCMediaOption;
+type Types_RTCMediaSource = RTCMediaSource;
 type Types_RTCReceiverParams = RTCReceiverParams;
 type Types_RTCResolved = RTCResolved;
+type Types_RTCScreenOption = RTCScreenOption;
+type Types_RTCShareOptions = RTCShareOptions;
 type Types_RealtimeCallback = RealtimeCallback;
 type Types_RecordData = RecordData;
 type Types_RecordEncryptionInfo = RecordEncryptionInfo;
@@ -1343,7 +1408,7 @@ type Types_UserPublic = UserPublic;
 type Types_UserVisibilityFlag = UserVisibilityFlag;
 type Types_WebSocketMessage = WebSocketMessage;
 declare namespace Types {
-  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_FileUploadError as FileUploadError, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_PostRecordsItem as PostRecordsItem, Types_PostRecordsResult as PostRecordsResult, Types_ProgressCallback as ProgressCallback, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEvent as RTCEvent, Types_RTCIceOption as RTCIceOption, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketReceipt as TicketReceipt, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UploadFilesParams as UploadFilesParams, Types_UploadFilesResult as UploadFilesResult, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_UserVisibilityFlag as UserVisibilityFlag, Types_WebSocketMessage as WebSocketMessage };
+  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_FileUploadError as FileUploadError, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_PostRecordsItem as PostRecordsItem, Types_PostRecordsResult as PostRecordsResult, Types_ProgressCallback as ProgressCallback, Types_RTCChannelOption as RTCChannelOption, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEncodingOption as RTCEncodingOption, Types_RTCEvent as RTCEvent, Types_RTCIceOption as RTCIceOption, Types_RTCMediaOption as RTCMediaOption, Types_RTCMediaSource as RTCMediaSource, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RTCScreenOption as RTCScreenOption, Types_RTCShareOptions as RTCShareOptions, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketReceipt as TicketReceipt, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UploadFilesParams as UploadFilesParams, Types_UploadFilesResult as UploadFilesResult, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_UserVisibilityFlag as UserVisibilityFlag, Types_WebSocketMessage as WebSocketMessage };
 }
 
 declare function terminatePendingRequests(): void;
@@ -1436,7 +1501,6 @@ declare class Skapi {
     private __uniqueIdsPersistTimer;
     private userPool;
     private __socket;
-    private __mediaStream;
     private host;
     private hostDomain;
     private target_cdn;
@@ -1554,7 +1618,11 @@ declare class Skapi {
         close_all?: boolean;
     }): Promise<void>;
     /**
-     * Creates or joins a WebRTC session and returns an RTC connector for streaming events and controls.
+     * Calls another user over WebRTC: the camera and microphone, the screen, a stream of your own, data channels, or any mix of them.
+     * `media` names what to send (`{ audio, video, screen }`, or a MediaStream), `receive` what to take without sending, `channels` the data channels to open,
+     * `meta` a small JSON object the other side reads on its `rtc:incoming` message, `ringTimeout` how long to wait for an answer.
+     * Resolves with an RTCConnector whose `connection` resolves, once the other side answers, with the running call: its peer connection, channels, local media,
+     * and the controls `share()`, `unshare()`, `replace()`, `mute()` and `addChannel()`.
      * @param params Request parameters.
      * @param callback Callback invoked for events or updates.
      * @returns A promise that resolves to Promise<RTCConnector>.
@@ -3263,4 +3331,4 @@ declare class Skapi {
     bulkPostRecords(config: PostRecordConfig[]): Promise<RecordData[]>;
 }
 
-export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type FileUploadError, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCConnector, type RTCConnectorParams, type RTCEvent, type RTCReceiverParams, type RTCResolved, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketReceipt, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UploadFilesParams, type UploadFilesResult, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };
+export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type FileUploadError, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCChannelOption, type RTCConnector, type RTCConnectorParams, type RTCEncodingOption, type RTCEvent, type RTCIceOption, type RTCMediaOption, type RTCMediaSource, type RTCReceiverParams, type RTCResolved, type RTCScreenOption, type RTCShareOptions, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketReceipt, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UploadFilesParams, type UploadFilesResult, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };

package/dist/skapi.d.ts

@@ -20,36 +20,93 @@ type RTCIceOption = string | Array<{
     username?: string;
     credential?: string;
 }>;
+/**
+ * What a local track is. The SDK names the tracks it captures itself ('camera', 'microphone',
+ * 'screen'); a stream or track the app passes is 'custom' unless the app names it in share().
+ * The other side reads the name on its 'track' event, as `source`.
+ */
+type RTCMediaSource = 'camera' | 'microphone' | 'screen' | 'custom' | (string & {});
+/** Screen capture: true, or the options of getDisplayMedia() plus a contentHint for the video track. */
+type RTCScreenOption = boolean | (DisplayMediaStreamOptions & {
+    contentHint?: 'text' | 'detail' | 'motion';
+});
+/**
+ * The media a side sends. A MediaStream is sent as it is. An object names what the SDK should
+ * capture: `audio` and `video` are passed to getUserMedia() (a boolean or track constraints),
+ * `screen` to getDisplayMedia(). Omitted, or everything false, sends no media.
+ */
+type RTCMediaOption = MediaStream | (MediaStreamConstraints & {
+    screen?: RTCScreenOption;
+});
+/** Codec order and sender limits, applied to every track of the kind, now and when one is added later. */
+type RTCEncodingOption = {
+    video?: {
+        codecs?: string[];
+        maxBitrate?: number;
+        maxFramerate?: number;
+        scaleResolutionDownBy?: number;
+    };
+    audio?: {
+        codecs?: string[];
+        maxBitrate?: number;
+    };
+};
+/** A data channel to open: a preset name, or RTCDataChannelInit with `protocol` as its label. */
+type RTCChannelOption = RTCDataChannelInit | 'default' | 'text-chat' | 'file-transfer' | 'video-chat' | 'voice-chat' | 'gaming';
 type RTCReceiverParams = {
     ice?: RTCIceOption;
-    media?: {
-        video: boolean;
-        audio: boolean;
-    } | MediaStream | MediaStreamConstraints;
+    icePolicy?: 'all' | 'relay';
+    media?: RTCMediaOption;
+    receive?: {
+        audio?: boolean;
+        video?: boolean;
+    };
+    encoding?: RTCEncodingOption;
+    channels?: RTCChannelOption[];
 };
-type RTCConnectorParams = {
+type RTCConnectorParams = RTCReceiverParams & {
     cid: string;
-    ice?: RTCIceOption;
-    media?: {
-        video: boolean;
-        audio: boolean;
-    } | MediaStream | MediaStreamConstraints;
-    channels?: Array<RTCDataChannelInit | 'text-chat' | 'file-transfer' | 'video-chat' | 'voice-chat' | 'gaming'>;
+    meta?: Record<string, any>;
+    ringTimeout?: number;
 };
 type RTCConnector = {
     hangup: () => void;
     connection: Promise<RTCResolved>;
 };
+/** Options of share(): for 'screen' the getDisplayMedia() options plus contentHint, for 'camera' and 'microphone' the track constraints, for a stream or track of your own `source`, its name on the other side. */
+type RTCShareOptions = {
+    [key: string]: any;
+    contentHint?: 'text' | 'detail' | 'motion';
+    source?: string;
+};
 type RTCResolved = {
+    cid: string;
     target: RTCPeerConnection;
     channels: {
         [protocol: string]: RTCDataChannel;
     };
     hangup: () => void;
     media: MediaStream;
+    meta: Record<string, any>;
+    /** Local tracks, all of them or those of one source. */
+    tracks: (source?: RTCMediaSource) => MediaStreamTrack[];
+    /** Adds the screen, the camera, the microphone, or a stream or track of your own to the call, and resolves with the tracks added. The other side gets them on its 'track' event. */
+    share: (what: 'screen' | 'camera' | 'microphone' | MediaStream | MediaStreamTrack, options?: RTCShareOptions) => Promise<MediaStreamTrack[]>;
+    /** Takes the tracks of a source, or one track, off the call and stops them. */
+    unshare: (what: RTCMediaSource | MediaStreamTrack) => void;
+    /** Swaps a track for another of the same kind without a new negotiation: a camera switch, a new microphone. The old track is stopped. */
+    replace: (what: RTCMediaSource | MediaStreamTrack, track: MediaStreamTrack) => Promise<void>;
+    /** Pauses or resumes what is sent: `audio` the microphone, `video` the camera and other video, `screen` the screen. true pauses, false resumes, omitted leaves it. */
+    mute: (what: {
+        audio?: boolean;
+        video?: boolean;
+        screen?: boolean;
+    }) => void;
+    /** Opens a data channel during the call. */
+    addChannel: (protocol: string, init?: RTCDataChannelInit) => RTCDataChannel;
 };
 type RTCEvent = {
-    type: 'track' | 'connectionstatechange' | 'close' | 'message' | 'open' | 'bufferedamountlow' | 'error' | 'icecandidate' | 'icecandidateend' | 'icegatheringstatechange' | 'negotiationneeded' | 'signalingstatechange';
+    type: 'track' | 'trackmute' | 'trackunmute' | 'trackended' | 'unshare' | 'connectionstatechange' | 'close' | 'message' | 'open' | 'bufferedamountlow' | 'error' | 'icecandidate' | 'icecandidateend' | 'icecandidateerror' | 'iceconnectionstatechange' | 'icegatheringstatechange' | 'negotiationneeded' | 'signalingstatechange' | 'ringtimeout';
     [key: string]: any;
 };
 type WebSocketMessage = {
@@ -57,6 +114,8 @@ type WebSocketMessage = {
     message?: any;
     connectRTC?: (params: RTCReceiverParams, callback: (e: RTCEvent) => void) => Promise<RTCResolved>;
     hangup?: () => void;
+    meta?: Record<string, any>;
+    sources?: string[];
     sender?: string;
     sender_cid?: string;
     sender_rid?: string;
@@ -1311,12 +1370,18 @@ type Types_PostRecordConfig = PostRecordConfig;
 type Types_PostRecordsItem = PostRecordsItem;
 type Types_PostRecordsResult = PostRecordsResult;
 type Types_ProgressCallback = ProgressCallback;
+type Types_RTCChannelOption = RTCChannelOption;
 type Types_RTCConnector = RTCConnector;
 type Types_RTCConnectorParams = RTCConnectorParams;
+type Types_RTCEncodingOption = RTCEncodingOption;
 type Types_RTCEvent = RTCEvent;
 type Types_RTCIceOption = RTCIceOption;
+type Types_RTCMediaOption = RTCMediaOption;
+type Types_RTCMediaSource = RTCMediaSource;
 type Types_RTCReceiverParams = RTCReceiverParams;
 type Types_RTCResolved = RTCResolved;
+type Types_RTCScreenOption = RTCScreenOption;
+type Types_RTCShareOptions = RTCShareOptions;
 type Types_RealtimeCallback = RealtimeCallback;
 type Types_RecordData = RecordData;
 type Types_RecordEncryptionInfo = RecordEncryptionInfo;
@@ -1343,7 +1408,7 @@ type Types_UserPublic = UserPublic;
 type Types_UserVisibilityFlag = UserVisibilityFlag;
 type Types_WebSocketMessage = WebSocketMessage;
 declare namespace Types {
-  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_FileUploadError as FileUploadError, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_PostRecordsItem as PostRecordsItem, Types_PostRecordsResult as PostRecordsResult, Types_ProgressCallback as ProgressCallback, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEvent as RTCEvent, Types_RTCIceOption as RTCIceOption, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketReceipt as TicketReceipt, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UploadFilesParams as UploadFilesParams, Types_UploadFilesResult as UploadFilesResult, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_UserVisibilityFlag as UserVisibilityFlag, Types_WebSocketMessage as WebSocketMessage };
+  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_FileUploadError as FileUploadError, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_PostRecordsItem as PostRecordsItem, Types_PostRecordsResult as PostRecordsResult, Types_ProgressCallback as ProgressCallback, Types_RTCChannelOption as RTCChannelOption, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEncodingOption as RTCEncodingOption, Types_RTCEvent as RTCEvent, Types_RTCIceOption as RTCIceOption, Types_RTCMediaOption as RTCMediaOption, Types_RTCMediaSource as RTCMediaSource, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RTCScreenOption as RTCScreenOption, Types_RTCShareOptions as RTCShareOptions, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketReceipt as TicketReceipt, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UploadFilesParams as UploadFilesParams, Types_UploadFilesResult as UploadFilesResult, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_UserVisibilityFlag as UserVisibilityFlag, Types_WebSocketMessage as WebSocketMessage };
 }
 
 declare function terminatePendingRequests(): void;
@@ -1436,7 +1501,6 @@ declare class Skapi {
     private __uniqueIdsPersistTimer;
     private userPool;
     private __socket;
-    private __mediaStream;
     private host;
     private hostDomain;
     private target_cdn;
@@ -1554,7 +1618,11 @@ declare class Skapi {
         close_all?: boolean;
     }): Promise<void>;
     /**
-     * Creates or joins a WebRTC session and returns an RTC connector for streaming events and controls.
+     * Calls another user over WebRTC: the camera and microphone, the screen, a stream of your own, data channels, or any mix of them.
+     * `media` names what to send (`{ audio, video, screen }`, or a MediaStream), `receive` what to take without sending, `channels` the data channels to open,
+     * `meta` a small JSON object the other side reads on its `rtc:incoming` message, `ringTimeout` how long to wait for an answer.
+     * Resolves with an RTCConnector whose `connection` resolves, once the other side answers, with the running call: its peer connection, channels, local media,
+     * and the controls `share()`, `unshare()`, `replace()`, `mute()` and `addChannel()`.
      * @param params Request parameters.
      * @param callback Callback invoked for events or updates.
      * @returns A promise that resolves to Promise<RTCConnector>.
@@ -3263,4 +3331,4 @@ declare class Skapi {
     bulkPostRecords(config: PostRecordConfig[]): Promise<RecordData[]>;
 }
 
-export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type FileUploadError, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCConnector, type RTCConnectorParams, type RTCEvent, type RTCReceiverParams, type RTCResolved, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketReceipt, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UploadFilesParams, type UploadFilesResult, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };
+export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type FileUploadError, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCChannelOption, type RTCConnector, type RTCConnectorParams, type RTCEncodingOption, type RTCEvent, type RTCIceOption, type RTCMediaOption, type RTCMediaSource, type RTCReceiverParams, type RTCResolved, type RTCScreenOption, type RTCShareOptions, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketReceipt, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UploadFilesParams, type UploadFilesResult, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };