@idscan/idvc2 3.8.0 → 3.9.1

package/dist/types/defaultConfig.d.ts

@@ -3,6 +3,7 @@ import { DocumentTypeName } from './environment/documentTypes';
 import { StepType } from './environment/stepsDescription';
 import { AllLabels, supportedLanguages } from './environment/langs';
 import { ModalPositionKeys } from './environment/modalPosition';
+import { MessageAfterDelay } from './types/core/MessageAfterDelay';
 import { DeepPartial } from './types/helpers/DeepPartial';
 export type ValidationFn = 'validateElement' | 'validateString' | 'validateDocumentTypes' | 'validateDistinctStringInArray' | 'validateNumber' | 'validateFunction' | 'ValidateDictionaryLangMatch' | 'validateBool' | 'validateAllowCameraSelection';
 type DefaultValueFunction = () => boolean;
@@ -25,6 +26,7 @@ export type StepConfig = {
     enableFourCornerCapture?: boolean;
     shouldRecordMultiImages?: boolean;
     delayUntilCaptureButtonVisible?: number;
+    messageAfterDelay?: MessageAfterDelay;
 };
 export type DocumentType = {
     type: DocumentTypeName;
@@ -39,7 +41,7 @@ export type DefaultConfigName = 'el' | 'licenseKey' | 'networkUrl' | 'language'
  * @param {string} name,
  * @param {'String' | 'Array' | 'Number' | 'Boolean' | 'Function' | 'Object'}  type,
  * @param {string} description,
- * @param {string | boolean | DefaultValueFunction | number | DocumentType[]} defaultValue,
+ * @param {string | boolean | DefaultValueFunction | number | DocumentType[] | MessageAfterDelay} defaultValue,
  * @param {ValidationFn}  validationFn,
  * @parma {boolean} hidden?,
  * @param {RealFaceMode[]} values?,
@@ -50,7 +52,7 @@ export interface IDefaultConfig {
     name: DefaultConfigName;
     type: 'String' | 'Array' | 'Number' | 'Boolean' | 'Function' | 'Object';
     description: string;
-    defaultValue: StepMode | string | boolean | DefaultValueFunction | number | DocumentType[];
+    defaultValue: StepMode | string | boolean | DefaultValueFunction | number | DocumentType[] | MessageAfterDelay;
     validationFn: ValidationFn;
     hidden?: boolean;
     values?: ModalPositionKeys[] | RealFaceMode[] | typeof supportedLanguages[number][] | ImageURI[] | DeepPartial<AllLabels>;

package/dist/types/helpers/base64.d.ts

@@ -0,0 +1,6 @@
+export type Base64 = string;
+export type Base64DataUrl = string;
+export declare const base64ToUint8Array: (base64: string) => Uint8Array;
+export declare const isBase64DataUrl: (value: string) => value is string;
+export declare const extractBase64: (input?: string | null) => Base64;
+export declare const blobToBase64DataUrl: (blob: Blob) => Promise<Base64DataUrl>;

package/dist/types/helpers/cancelableTimeout.d.ts

@@ -0,0 +1,4 @@
+export declare const createCancelableTimeout: () => {
+    start: (cb: () => void, delay: number) => void;
+    cancel: () => void;
+};

package/dist/types/helpers/image.d.ts

@@ -1,6 +1,5 @@
 import { ICrop } from './ts/common';
 import { Bbox } from '../types/geometry';
-export type Base64Image = string;
 export type RGBAColor = string;
 export type RGBColor8 = Uint8ClampedArray;
 export type RGBColor32 = Float32Array;

package/dist/types/helpers/strings.d.ts

@@ -1,8 +1,3 @@
-import { Base64Image } from './image';
-export declare const encodeMeta: (metadata: any) => string;
-export declare const decodeMeta: (str: string) => any;
-export declare const base64ToArrayBuffer: (base64: string) => Uint8Array;
-export declare const getDataFromBase64Img: (imgString: Base64Image) => string;
 export declare const splitWordByUpperLetters: (word: string) => string[];
 export declare const normalizeCamelCase: (word: string) => string;
 export declare const removeHtmlEntities: (str: string) => string;

package/dist/types/helpers/validators.d.ts

@@ -1,3 +1,4 @@
+import { MessageAfterDelay } from '../types/core/MessageAfterDelay';
 /**
  * check value to be boolean
  * @param val
@@ -42,6 +43,7 @@ type ValidationResult = {
     invalidPathsWithReason: Record<string, string>;
 };
 export declare const isValidDeepPartial: <T extends Record<string, unknown>>(original: T, candidate: unknown) => ValidationResult;
+export declare const validateMessageAfterDelay: (value: unknown, name: string, type: string) => MessageAfterDelay | undefined;
 declare const _default: {
     isValidBool: (val: any) => boolean;
     isValidFunction: (val: any) => boolean;

package/dist/types/idvc.d.ts

@@ -1,6 +1,8 @@
 import { IConfig } from './modules/Config';
 import type { SupportedLanguage } from './environment/langs';
 import type { IDocumentTypeConfig } from './modules/validator';
+export { prepareRequestDataForDiveApi, } from './integrations/prepareRequestDataForDiveApi';
+export type { IPrepareRequestDataForDiveApiParams } from './integrations/prepareRequestDataForDiveApi';
 export default class VideoCapturing {
     constructor(config: IConfig);
     get version(): string;

package/dist/types/integrations/prepareRequestDataForDiveApi.d.ts

@@ -0,0 +1,59 @@
+import { IDataForSubmit } from '../util';
+import { Base64 } from '../helpers/base64';
+import { DocumentTypeIndex } from '../environment/documentTypes';
+interface IRequestBase {
+    frontImageBase64: Base64;
+    backOrSecondImageBase64: Base64;
+    faceImageBase64: Base64;
+    ssn: string;
+    frontMultiImagesBase64: Base64;
+    faceMultiImagesBase64: Base64;
+    documentType: DocumentTypeIndex | 0;
+}
+interface IRequestV3 extends IRequestBase {
+    trackString: string;
+    verifyFace: boolean;
+    captureMethod: string;
+    userAgent: string;
+    frontEndMetadata: string;
+    metadata?: string;
+}
+interface IRequestV4 extends IRequestBase {
+    trackString: {
+        data: string;
+        barcodeParams: string;
+    };
+    metadata: {
+        captureMethod: string;
+        userAgent: string;
+        frontEndMetadata: string;
+        otherMetadata?: string;
+    };
+}
+export interface IPrepareRequestDataForDiveApiParams<P = Record<string, unknown>> {
+    data?: IDataForSubmit;
+    payload?: P;
+    versionAPI?: '3' | '3.1' | '4';
+}
+type IRequestPayload = Record<string, unknown>;
+/**
+ * Prepares request payload for Dive API (v3 / v3.1 / v4) based on submitted capture data.
+ *
+ * Builds a normalized request object:
+ * - extracts base64 images (front, back/second, face)
+ * - prepares multi-capture images if available
+ * - parses metadata
+ * - adjusts payload structure depending on API version
+ *
+ * @template P - Additional custom payload fields to be merged into the request
+ *
+ * @param params - Parameters object
+ * @param params.data - Raw data collected from the results of the IDVC capture flow
+ * @param params.payload - Optional custom fields to extend the request payload
+ * @param params.versionAPI - Target Dive API version (`'3' | '3.1' | '4'`)
+ *
+ * @returns Promise resolving to a prepared Dive API request object
+ * compatible with the specified API version and extended with custom payload fields
+ */
+export declare const prepareRequestDataForDiveApi: <P extends IRequestPayload>({ data, versionAPI, payload, }: IPrepareRequestDataForDiveApiParams<P>) => Promise<(IRequestV3 | IRequestV4) & P>;
+export {};

package/dist/types/loop.d.ts

@@ -3,8 +3,6 @@ export interface IMrzCoords {
     locations: MRZLocation;
     color: 'green' | 'yellow';
 }
-export declare const loopTimeout: (ms: number) => Promise<void>;
-export declare const demandCapturingTimeout: (ms: number) => Promise<void>;
 export declare const unmountIDVC: () => void;
 export declare const loop: () => Promise<false>;
 declare const _default: {

package/dist/types/manualUpload.d.ts

@@ -1,6 +1,6 @@
-import { Base64Image } from './helpers/image';
+import { Base64 } from './helpers/base64';
 type Base64Object = {
-    data: ImageData | Base64Image | null;
+    data: ImageData | Base64 | null;
     err: boolean;
 };
 declare const dropFile: (base64Obj: Base64Object) => Promise<void>;

package/dist/types/modules/Step.d.ts

@@ -1,8 +1,9 @@
-import { Base64Image } from '../helpers/image';
 import { StepType, StepTypeImageName } from '../environment/stepsDescription';
 import { StepMode } from '../defaultConfig';
 import { ErrorCodes } from '../environment/langs';
 import { DocumentTypeName } from '../environment/documentTypes';
+import { Base64 } from '../helpers/base64';
+import { MessageAfterDelay } from '../types/core/MessageAfterDelay';
 export interface IStepConfigMode {
     name: 'mode';
     value: StepMode;
@@ -14,7 +15,7 @@ export interface IStepObj {
     name: string;
     type: StepType;
     camera: VideoFacingModeEnum;
-    img: Base64Image | null;
+    img: Base64 | null;
     err?: string | null;
     text?: string;
     time?: number;
@@ -22,10 +23,11 @@ export interface IStepObj {
     stepTypeImageName: StepTypeImageName;
     shouldRecordMultiImages?: boolean;
     delayUntilCaptureButtonVisible?: number;
+    messageAfterDelay?: MessageAfterDelay;
 }
 export interface IStepCallback {
     /** base64 encoded step image */
-    img: Base64Image | null;
+    img: Base64 | null;
     /** blob step image */
     blob: Blob | null;
     /** blob step MultiImages */
@@ -43,7 +45,7 @@ export interface IStepCallback {
     /** mrz recognized text */
     mrzText?: string;
     /** cropped base64 encoded mrz image */
-    mrzImg?: Base64Image | null;
+    mrzImg?: Base64 | null;
     /** cropped blob mrz image */
     mrzBlob?: Blob | null;
     /** recognized text */
@@ -54,7 +56,7 @@ export default class Step implements IStepCallback, IStepObj {
     multiImagesBlob: Blob | null;
     errorCode: ErrorCodes | null | undefined;
     mrzText?: string;
-    mrzImg?: Base64Image | null;
+    mrzImg?: Base64 | null;
     mrzBlob?: Blob | null;
     trackString?: string;
     err?: string | null;
@@ -65,11 +67,12 @@ export default class Step implements IStepCallback, IStepObj {
     name: string;
     type: StepType;
     camera: VideoFacingModeEnum;
-    img: Base64Image | null;
+    img: Base64 | null;
     cameraInfo: Record<string, any>;
     stepTypeImageName: StepTypeImageName;
     shouldRecordMultiImages: boolean;
     delayUntilCaptureButtonVisible?: number;
+    messageAfterDelay?: MessageAfterDelay;
     constructor(nameOrObj: string | IStepObj);
     get isShowManualSwitchButton(): boolean;
     get capturingMode(): StepMode;

package/dist/types/modules/manualUploadProcessing.d.ts

@@ -1,5 +1,5 @@
-import type { Base64Image } from '../helpers/image';
 import type { ErrorCodeNames } from '../environment/langs';
+import { Base64 } from '../helpers/base64';
 type ProcessingErrorCode = ErrorCodeNames | '';
 type Coordinate = {
     x: number;
@@ -22,9 +22,9 @@ export declare const pdfProcess: (smallImage: any, { perimeter }: {
 }) => Promise<boolean>;
 /**
  *
- * @param {Base64Image} data - base64 image
+ * @param {Base64} data - base64 image
  */
-export declare const barCodeProcess: (data: Base64Image) => Promise<boolean>;
+export declare const barCodeProcess: (data: Base64) => Promise<boolean>;
 export declare const frontProcess: ({ side, perimeter, isHasFace }: {
     side: any;
     perimeter: any;

package/dist/types/modules/ui/VideoWrapper/CanvasWrapper.d.ts

@@ -13,6 +13,7 @@ export declare class CanvasWrapper {
     generalTypeCanvas: HTMLCanvasElement;
     blazeFaceCanvas: HTMLCanvasElement;
     meshFaceCanvas: HTMLCanvasElement;
+    multiImagesSourceCanvas: HTMLCanvasElement;
     mrzCtx: CanvasRenderingContext2D;
     scaledCtx: CanvasRenderingContext2D;
     videoCtx: CanvasRenderingContext2D;
@@ -21,8 +22,10 @@ export declare class CanvasWrapper {
     faceCtx: CanvasRenderingContext2D;
     blazeFaceCtx: CanvasRenderingContext2D;
     meshFaceCtx: CanvasRenderingContext2D;
+    multiImagesSourceCtx: CanvasRenderingContext2D;
+    isStartedRecord: boolean;
     private readonly video;
-    private readonly faceOffset;
+    private readonly faceCrop;
     private readonly canvasNames;
     private readonly canvasCtxNames;
     private multiImagesRecorder;
@@ -31,6 +34,10 @@ export declare class CanvasWrapper {
     restoreCanvas(): void;
     toggleBorderCanvas(currentStepType: StepType, isStarted: boolean): void;
     toggleRecordMultiImages(currentStepObj: Step, isStarted: boolean): void;
+    private getCenteredSquareCrop;
+    private getCenteredCropForRatio;
+    private getMultiImageDrawParams;
+    private prepareMultiImageSourceCanvas;
     clearBorderCtx(): void;
     setVideoCanvasSizes({ width, height }: Size): void;
     getBaseSizes(coefficient?: number): {
@@ -42,7 +49,7 @@ export declare class CanvasWrapper {
     prepareFaceCanvas(width: number, height: number): void;
     drawVideo(): void;
     recreateWorkingCanvas(browser: BrowserInfo, browserMajorVersion: number): void;
-    drawResizedVideo(currentStepType: StepType, isRealFaceAvailable: boolean): void;
+    drawResizedVideo(currentStepType: StepType, isRealFaceAvailable: boolean, sizeK: number): void;
     private drawResized;
     private drawFace;
     private recreateCanvas;

package/dist/types/modules/ui/VideoWrapper/CaptureButton.d.ts

@@ -7,8 +7,8 @@ export declare class CaptureButton implements ICaptureButton {
     private controlButton;
     private readonly checkIsCameraErrorVisible;
     constructor(element: HTMLElement, onClick: ControlButtonEvents, checkIsCameraErrorVisible: () => boolean);
-    private timeout;
-    private showCaptureButtonTimeout;
+    private captureButtonTimeout;
+    private showCaptureButton;
     private setVisible;
     setStart: () => void;
     setStop: () => void;

package/dist/types/modules/ui/VideoWrapper/MultiImagesRecorderService.d.ts

@@ -1,8 +1,10 @@
 export declare class MultiImagesRecorderService {
+    private canvas;
     private mediaRecorder;
     private recordedBlobs;
     private multiImagesType;
-    startRecording(canvas: HTMLCanvasElement): void;
+    constructor(canvas: HTMLCanvasElement);
+    startRecording(): void;
     stopRecording(): void;
     private handleDataAvailable;
     private handleStop;

package/dist/types/types/context.d.ts

@@ -7,7 +7,8 @@ import LoggerController from '../controllers/LoggerController';
 import Step from '../modules/Step';
 import { AllLabels } from '../environment/langs';
 import { StepType } from '../environment/stepsDescription';
-import { Base64Image, Offset, Size } from '../helpers/image';
+import { Base64 } from '../helpers/base64';
+import { Offset, Size } from '../helpers/image';
 import { RealFaceTurnSide } from './enums/realFace';
 import { StepConfig, StepMode } from '../defaultConfig';
 import { DeepPartial } from './helpers/DeepPartial';
@@ -45,7 +46,7 @@ export type Context = {
     steps: Step[];
     currentStepType: StepType;
     currentStepCamera: VideoFacingModeEnum;
-    currentStepImg: Base64Image | null;
+    currentStepImg: Base64 | null;
     currentStepBlob: Blob | null;
     curStep: number;
     currentStep: number;

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

@@ -0,0 +1,4 @@
+export interface MessageAfterDelay {
+    delay?: number;
+    text?: string;
+}

package/dist/types/util.d.ts

@@ -1,4 +1,4 @@
-import { Base64Image } from './helpers/image';
+import { Base64 } from './helpers/base64';
 import { IStepCallback } from './modules/Step';
 import { DocumentTypeIndex, DocumentTypeName } from './environment/documentTypes';
 import { Context } from './types/context';
@@ -22,5 +22,5 @@ export declare const filterWithForbiddenKeysValues: (obj: any, forbiddenKeys: an
 export declare const prepareCameraErr: (err: IError) => IError;
 export declare const formDataForSubmit: (steps: IStepCallback[], c: Context, payload?: {}) => IDataForSubmit;
 export declare const imageToImageData: (img: HTMLImageElement) => ImageData;
-export declare const base64ToImageData: (base64: Base64Image) => Promise<ImageData>;
+export declare const base64ToImageData: (base64: Base64) => Promise<ImageData>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idscan/idvc2",
-  "version": "3.8.0",
+  "version": "3.9.1",
   "description": "component for the capturing documents",
   "main": "dist/idvc.js",
   "types": "dist/types/idvc.d.ts",