videomail-client 16.0.2 → 16.1.0

package/dist/esm/types/events/index.d.ts

@@ -1,11 +1,13 @@
 import { FormReadyParams } from "../../wrappers/container.js";
-import { VideomailErrorParams, VideomailInvalidParams, VideomailPreviewParams, VideomailProgressParams, VideomailRecordingParams, VideomailStoppedParams, VideomailStoppingParams, VideomailSubmittedParams, VideomailUserMediaReadyParams, VideomailValidatingParams } from "./params.js";
+import { VideomailCameraRecoveryFailedParams, VideomailErrorParams, VideomailInvalidParams, VideomailPreviewParams, VideomailProgressParams, VideomailRecordingParams, VideomailStoppedParams, VideomailStoppingParams, VideomailSubmittedParams, VideomailUserMediaReadyParams, VideomailValidatingParams } from "./params.js";
 export interface VideomailEvents {
     ASKING_WEBCAM_PERMISSION: () => void;
     BEGIN_AUDIO_ENCODING: () => void;
     BEGIN_VIDEO_ENCODING: () => void;
     BLOCKING: () => void;
     BUILT: () => void;
+    CAMERA_RECOVERING: () => void;
+    CAMERA_RECOVERY_FAILED: (params: VideomailCameraRecoveryFailedParams) => void;
     CONNECTED: () => void;
     CONNECTING: () => void;
     COUNTDOWN: () => void;

package/dist/esm/types/events/params.d.ts

@@ -4,9 +4,13 @@ import { RecordingStats } from "../RecordingStats.js";
 import { Videomail } from "../Videomail.js";
 export interface VideomailUserMediaReadyParams {
     switchingFacingMode?: ConstrainDOMString | undefined;
+    recovering?: boolean | undefined;
     recordWhenReady?: boolean | undefined;
     paused?: boolean | undefined;
 }
+export interface VideomailCameraRecoveryFailedParams {
+    err: VideomailError;
+}
 export interface VideomailErrorParams {
     exc?: unknown;
     err?: VideomailError;

package/dist/esm/util/Despot.d.ts

@@ -15,6 +15,8 @@ declare class Despot {
         BEGIN_VIDEO_ENCODING: (() => void)[];
         BLOCKING: (() => void)[];
         BUILT: (() => void)[];
+        CAMERA_RECOVERING: (() => void)[];
+        CAMERA_RECOVERY_FAILED: ((params: import("../index.js").VideomailCameraRecoveryFailedParams) => void)[];
         CONNECTED: (() => void)[];
         CONNECTING: (() => void)[];
         COUNTDOWN: (() => void)[];

package/dist/esm/util/html/media/AudioRecorder.d.ts

@@ -5,6 +5,7 @@ export type AudioProcessCB = (audioSample: AudioSample) => void;
 declare class AudioRecorder {
     private scriptProcessor?;
     private audioInput?;
+    private volume?;
     private vcAudioContext?;
     private readonly userMedia;
     private readonly options;
@@ -12,8 +13,10 @@ declare class AudioRecorder {
     private hasAudioContext;
     private getAudioContext;
     private onAudioProcess;
+    private disconnect;
     init(localMediaStream: MediaStream): void;
     record(cb: AudioProcessCB): void;
+    resume(): Promise<void>;
     stop(): void;
     getSampleRate(): number;
 }

package/dist/esm/wrappers/container.d.ts

@@ -67,6 +67,8 @@ declare class Container extends Despot {
     pause(params?: {
         event: MouseEvent;
     }): void;
+    suspend(): void;
+    recoverCamera(): Promise<boolean>;
     validate(event?: any, force?: boolean): boolean;
     disableForm(buttonsToo: boolean): void;
     enableForm(buttonsToo: boolean): void;

package/dist/esm/wrappers/form.d.ts

@@ -10,12 +10,18 @@ export declare const FormMethod: {
 };
 export type FormMethodType = (typeof FormMethod)[keyof typeof FormMethod];
 declare class Form extends Despot {
+    private static nextFormId;
     private readonly container;
     private readonly formElement;
-    private readonly validate;
     private keyInput?;
+    private submitButton;
+    private submitButtonFormAttribute;
+    private generatedFormId;
+    private isSubmitting;
     private readonly FORM_FIELDS;
     constructor(container: Container, formElement: HTMLFormElement, options: VideomailClientOptions);
+    private readonly validate;
+    private readonly handleSubmit;
     private getData;
     transformFormData(formInputs: FormInputs): {
         url?: string;
@@ -405,9 +411,10 @@ declare class Form extends Despot {
     private hideSubmitButton;
     unload(): void;
     private resetForm;
+    private connectSubmitButton;
     private startListeningToSubmitEvents;
     private stopListeningToSubmitEvents;
-    doTheSubmit(e?: any): Promise<boolean>;
+    doTheSubmit(e?: Event): Promise<boolean>;
     getInvalidElement(): Element | null;
     findSubmitButton(): HTMLButtonElement | null;
     hide(): void;

package/dist/esm/wrappers/visuals/recorder.d.ts

@@ -19,6 +19,7 @@ declare class Recorder extends Despot {
     private originalAnimationFrameObject;
     private samplesCount;
     private framesCount;
+    private recordingAudioSampleRate?;
     private recordingStats?;
     private confirmedFrameNumber;
     private confirmedSampleNumber;
@@ -37,6 +38,10 @@ declare class Recorder extends Despot {
     private ctx?;
     private userMediaLoaded?;
     private userMediaLoading;
+    private mediaRequestId;
+    private cameraRecovery?;
+    private resolveCameraRecovery?;
+    private resumeAfterCameraRecovery;
     private submitting;
     private unloaded?;
     private stopTime?;
@@ -134,6 +139,10 @@ declare class Recorder extends Despot {
     private clearStopTimeout;
     validate(): boolean;
     isReady(): boolean | undefined;
+    private finishCameraRecovery;
+    private cancelCameraRecovery;
+    private failCameraRecovery;
+    recoverCamera(): Promise<boolean>;
     pause(params?: PauseParams): void;
     resume(): void;
     private onFlushed;

package/dist/esm/wrappers/visuals/userMedia.d.ts

@@ -1,11 +1,12 @@
 import { Dimension } from "../../types/dimension.js";
+import type { VideomailUserMediaReadyParams } from "../../types/events/params.js";
 import { VideomailClientOptions } from "../../types/options.js";
 import Despot from "../../util/Despot.js";
 import { AudioProcessCB } from "../../util/html/media/AudioRecorder.js";
 import Recorder from "./recorder.js";
 interface StopParams {
-    aboutToInitialize: boolean;
-    switchingFacingMode: any;
+    aboutToInitialize?: boolean;
+    preserveRecordingState?: boolean;
 }
 declare class UserMedia extends Despot {
     private readonly recorder;
@@ -18,17 +19,21 @@ declare class UserMedia extends Despot {
     private onLoadedMetaDataReached;
     private playingPromiseReached;
     private videoTrackLabel?;
+    private clearInitializationListeners?;
+    private initializationId;
     private readonly outputEvent;
     private readonly handleMediaError;
     constructor(recorder: Recorder, options: VideomailClientOptions);
     private attachMediaStream;
     private setVisualStream;
+    restorePlayback(): Promise<void>;
+    hasLiveStream(): boolean;
     private hasEnded;
     private hasInvalidDimensions;
     private logEvent;
     unloadRemainingEventListeners(): void;
     private audioRecord;
-    init(localMediaStream: MediaStream, videoCallback: () => void, audioCallback: AudioProcessCB, endedEarlyCallback: (err: any) => void, switchingFacingMode?: ConstrainDOMString): void;
+    init(localMediaStream: MediaStream, videoCallback: () => void, audioCallback: AudioProcessCB, endedEarlyCallback: (err: unknown) => void, params?: Pick<VideomailUserMediaReadyParams, "switchingFacingMode" | "recovering">): void;
     getVideoTrackLabel(): string | undefined;
     isReady(): boolean;
     stop(visualStream?: MediaStream, params?: StopParams): void;

package/dist/esm/wrappers/visuals.d.ts

@@ -14,6 +14,7 @@ declare class Visuals extends Despot {
     private readonly notifier;
     private visualsElement?;
     private built;
+    private cameraRecoveryFailed;
     constructor(container: Container, options: VideomailClientOptions);
     private buildNoScriptTag;
     private buildChildren;
@@ -37,6 +38,8 @@ declare class Visuals extends Despot {
     pause(params?: {
         event: MouseEvent;
     }): void;
+    private clearCameraRecoveryNotice;
+    recoverCamera(): Promise<boolean>;
     resume(): void;
     pauseOrResume(): void;
     recordOrStop(): void;