biometry-sdk 2.3.1 → 2.3.3

package/README.md

@@ -8,15 +8,19 @@ We also have UI component library for [React](https://www.npmjs.com/package/biom
 ## Table of Contents:
 - [Installation](#installation)
 - [Basic Usage (Direct SDK Methods)](#basic-usage-direct-sdk-methods)
-  - [Consents](#1-consents)
-    - [1.1 Give Authorization Consent](#11-give-authorization-consent)
-    - [1.2 Give Storage Consent](#12-give-storage-consent)
-  - [Face Enrollment](#2-face-enrollment)
-  - [Voice Enrollment](#3-voice-enrollment)
-  - [Process Video](#4-process-video)
+  - [Sessions](#1-sessions)
+  - [Consents](#2-consents)
+    - [1.1 Give Authorization Consent](#21-give-authorization-consent)
+    - [1.2 Give Storage Consent](#22-give-storage-consent)
+  - [Face Enrollment](#3-face-enrollment)
+  - [Voice Enrollment](#4-voice-enrollment)
+  - [Process Video](#5-process-video)
+  - [Face Match](#6-face-match)
+  - [DocAuth](#7-docauth)
 - [Advanced Usage And Best Practices](#advanced-usage-and-best-practices)
   - [Typical FaceMatch Flow](#typical-facematch-flow)
   - [Error Handling](#error-handling)
+  - [Header Retrieval](#header-retrieval)
   - [Security And Privacy Considerations](#security-and-privacy-considerations)
 - [License](#license)
 - [More Information](#more-information)
@@ -40,16 +44,20 @@ const sdk = new BiometrySDK('YOUR_API_KEY');
 ### Example
 You can find an example in the example/ directory. The example demonstrates how you might integrate the BiometrySDK in a React component with the state.
 
-### 1. Sessions
+## 1. Sessions
 Session is a way to group transactions together. It is useful when you want to group transactions that are related to each other. For example, you can start a session and then use the session ID to link transactions within a unified group.
+
+Note: Use sessions generated by Biometry for API calls. Biometry sessions always have `sess_` prefix. Do not use own uuids or any other values. 
+
+Example:
   ```javascript
-  const response = await sdk.startSession();
+  const response = await sdk.startSession(); // returns uuid with `sess_` prefix
   const sessionId = response.data;
 
   const voiceFile = new File([/* voice audio bytes */], 'voice.wav', { type: 'audio/wav' });
   const faceFile = new File([/* face image bytes */], 'face.jpg', { type: 'image/jpeg' });
 
-  // Use the session ID to link transactions within a unified group
+  // Use the session ID in X-Session-Id header to link transactions within a unified group
   await sdk.giveStorageConsent(true, 'John Doe', { sessionId });
   await sdk.enrollFace(faceFile, 'John Doe', { sessionId });
   await sdk.enrollVoice(voiceFile, 'John Doe', { sessionId });
@@ -57,8 +65,8 @@ Session is a way to group transactions together. It is useful when you want to g
   // Go to the Results page in your dashboard and see the transactions grouped by the session ID
   ```
 
-### 2. Consents
-#### 2.1 Give Authorization Consent
+## 2. Consents
+### 2.1 Give Authorization Consent
 You **must** obtain user authorization consent before performing any biometric operations (Face Recognition, Voice Recognition, etc.):
   ```javascript
   await sdk.giveAuthorizationConsent(true, 'John Doe');
@@ -70,7 +78,7 @@ You **must** obtain user authorization consent before performing any biometric o
 - The first argument (`true`) indicates that the user has granted consent.
 - The second argument is the user's full name (used for record-keeping within Biometry).
 
-#### 2.2 Give Storage Consent
+### 2.2 Give Storage Consent
 You **must** obtain user consent before storing biometric data (Face Enrollment, Voice Enrollment):
   ```javascript
   await sdk.giveStorageConsent(true, 'John Doe');
@@ -82,7 +90,7 @@ You **must** obtain user consent before storing biometric data (Face Enrollment,
 - The first argument (`true`) indicates that the user has granted consent.
 - The second argument is the user's full name (used for record-keeping within Biometry).
 
-### 3. Face Enrollment
+## 3. Face Enrollment
 Enroll a user's face for future recognition or matching:
   ```javascript
   const faceFile = new File([/* face image bytes */], 'face.jpg', { type: 'image/jpeg' });
@@ -92,7 +100,7 @@ Enroll a user's face for future recognition or matching:
   console.log('Face Enrollment Response:', faceResponse);
   ```
 
-### 4. Voice Enrollment
+## 4. Voice Enrollment
 Enroll a user's voice for future authentication checks:
   ```javascript
   const voiceFile = new File([/* voice audio bytes */], 'voice.wav', { type: 'audio/wav' });
@@ -101,7 +109,7 @@ Enroll a user's voice for future authentication checks:
   const voiceResponse = await sdk.enrollVoice(voiceFile, 'John Doe');
   console.log('Voice Enrollment Response:', voiceResponse);
   ```
-### 5. Process Video
+## 5. Process Video
 Process a user's video for liveness checks and identity authorization:
   ```javascript
   const videoFile = new File([/* file parts */], 'video.mp4', { type: 'video/mp4' });
@@ -222,6 +230,36 @@ Always wrap calls in try/catch and provide user-friendly messages or fallback lo
     console.error('Face match error:', error);
   }
   ```
+
+### Header Retrieval
+In addition to the response body, all SDK calls also return response headers.  
+This is useful for retrieving metadata such as request IDs, rate limits, or debugging information.
+
+Each API call returns an object of type:
+
+  ```ts
+  export interface ApiResponse<T> {
+    body: T;
+    headers: Record<string, string>;
+  }
+  ```
+  For example, when calling the processVideo method, you can access both the response data and headers:
+  ```ts
+  try {
+    const response = await sdk.processVideo(videoFile, "12345678", "John Doe");
+
+    // Access the response body
+    console.log("Process video result:", response.body);
+
+    // Access headers (e.g., request ID)
+    console.log("Request ID:", response.headers["x-request-id"]);
+  } catch (error) {
+    console.error("Process video failed:", error);
+  }
+  ```
+  This pattern applies to all SDK methods, so you can always extract useful metadata from headers in addition to the main response.
+
+  
 ### Security And Privacy Considerations
 1. **Protect Your API Key:** Avoid storing your API key in client-side code if possible. Use environment variables or server-side proxies.
 2. **Obtain Explicit Consent:** Ensure you have a transparent process for obtaining and storing user consent.

package/dist/sdk.js

@@ -24,12 +24,11 @@ class BiometrySDK {
             const errorMessage = errorData?.error || errorData?.message || 'Unknown error occurred';
             throw new Error(`Error ${response.status}: ${errorMessage}`);
         }
-        // Extract response headers
+        // 🔹 Extract ALL response headers
         const responseHeaders = {};
-        const requestId = response.headers.get("X-Request-Id");
-        if (requestId) {
-            responseHeaders["X-Request-Id"] = requestId;
-        }
+        response.headers.forEach((value, key) => {
+            responseHeaders[key] = value;
+        });
         const responseBody = await response.json();
         return {
             body: responseBody,

package/dist/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sources":["../src/sdk/index.ts"],"sourcesContent":["import { ApiResponse } from \"../types/internal\";\nimport { DocAuthInfo } from \"../types/biometry/doc-auth\";\nimport { ConsentResponse } from \"../types/biometry/consent\";\nimport { FaceEnrollmentResponse, VoiceEnrollmentResponse } from \"../types/biometry/enrollment\";\nimport { FaceMatchResponse } from \"../types/biometry/face-match\";\nimport { ProcessVideoResponse } from \"../types/biometry/process-video\";\nimport { SessionResponse } from \"../types/biometry/session\";\n\nexport class BiometrySDK {\n  private apiKey: string;\n  private static readonly BASE_URL: string = 'https://api.biometrysolutions.com'; //'https://dev-console.biometrysolutions.com';\n\n  constructor(apiKey: string) {\n    if (!apiKey) {\n      throw new Error('API Key is required to initialize the SDK.');\n    }\n\n    this.apiKey = apiKey;\n  }\n\n  private async request<T>(path: string, method: string, body?: any, headers?: Record<string, string>):\n    Promise<ApiResponse<T>> {\n    const defaultHeaders: HeadersInit = {\n      Authorization: `Bearer ${this.apiKey}`,\n    };\n\n    const requestHeaders = { ...defaultHeaders, ...headers };\n\n    if (body && !(body instanceof FormData)) {\n      requestHeaders['Content-Type'] = 'application/json';\n      body = JSON.stringify(body);\n    }\n    const response = await fetch(`${BiometrySDK.BASE_URL}${path}`, {\n      method,\n      headers: requestHeaders,\n      body,\n    });\n\n    if (!response.ok) {\n      const errorData = await response.json().catch(() => ({}));\n      const errorMessage = errorData?.error || errorData?.message || 'Unknown error occurred';\n\n      throw new Error(`Error ${response.status}: ${errorMessage}`);\n    }\n\n    // Extract response headers\n    const responseHeaders: Record<string, string> = {};\n    const requestId = response.headers.get(\"X-Request-Id\");\n    if (requestId) {\n      responseHeaders[\"X-Request-Id\"] = requestId;\n    }\n\n    const responseBody = await response.json();\n\n    return {\n      body: responseBody as T,\n      headers: responseHeaders\n    };\n  }\n\n  /**\n   * Starts a new Session for a user.\n   * \n   * @returns {Promise<ApiResponse<SessionResponse>>} A promise resolving to the session ID.\n   * @throws {Error} - If the request fails.\n   */\n  async startSession(): Promise<ApiResponse<SessionResponse>> {\n    return await this.request<SessionResponse>(\n      '/api-gateway/sessions/start',\n      'POST'\n    );\n  }\n\n  /**\n   * Submits Authorization consent for a user.\n   * Authorization Consent is required to use the services like Face and Voice recognition.\n   * \n   * @param {boolean} isConsentGiven - Indicates whether the user has given consent.\n   * @param {string} userFullName - The full name of the user giving consent.\n   * @param {Object} [props] - Optional properties for the consent request.\n   * @param {string} [props.sessionId] - Session ID to link this consent with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<ConsentResponse>>} A promise resolving to the consent response.\n   * @throws {Error} - If the user's full name is not provided or if the request fails.\n   */\n  async giveAuthorizationConsent(\n    isConsentGiven: boolean,\n    userFullName: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<ConsentResponse>> {\n    if (!userFullName) {\n      throw new Error('User Full Name is required to give consent.');\n    }\n\n    const body = {\n      is_consent_given: isConsentGiven,\n      user_fullname: userFullName,\n    };\n\n    const headers: Record<string, string> = {};\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<ConsentResponse>(\n      '/api-consent/consent',\n      'POST',\n      body,\n      headers\n    );\n  }\n\n  /**\n   * Submits Storage consent for a user.\n   * Storage consent is granted by users, allowing us to store their biometric data for future verification.\n   * \n   * @param {boolean} isStorageConsentGiven - Indicates whether the user has given storage consent.\n   * @param {string} userFullName - The full name of the user giving storage consent.\n   * @param {Object} [props] - Optional properties for the consent request.\n   * @param {string} [props.sessionId] - Session ID to link this consent with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<ConsentResponse>>} A promise resolving to the consent response.\n   * @throws {Error} - If the user's full name is not provided or if the request fails.\n   */\n  async giveStorageConsent(\n    isStorageConsentGiven: boolean,\n    userFullName: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<ConsentResponse>> {\n    if (!userFullName) {\n      throw new Error('User Full Name is required to give storage consent.');\n    }\n\n    const body = {\n      is_consent_given: isStorageConsentGiven,\n      user_fullname: userFullName,\n    };\n\n    const headers: Record<string, string> = {};\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<ConsentResponse>(\n      '/api-consent/strg-consent',\n      'POST',\n      body,\n      headers\n    );\n  }\n\n  /**\n   * Enrolls a user's voice for biometric authentication.\n   * \n   * @param {File} audio - The audio file containing the user's voice.\n   * @param {string} userFullName - The full name of the user being enrolled.\n   * @param {string} uniqueId - A unique identifier for the enrolling process.\n   * @param {string} phrase - The phrase spoken in the audio file.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<VoiceEnrollmentResponse>>} - A promise resolving to the voice enrolling response.\n   * @throws {Error} - If required parameters are missing or the request fails.\n   */\n  async enrollVoice(\n    audio: File,\n    userFullName: string,\n    uniqueId: string,\n    phrase: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<VoiceEnrollmentResponse>> {\n    if (!userFullName) throw new Error('User fullname is required.');\n    if (!uniqueId) throw new Error('Unique ID is required.');\n    if (!phrase) throw new Error('Phrase is required.');\n    if (!audio) throw new Error('Audio file is required.');\n\n    const formData = new FormData();\n    formData.append('unique_id', uniqueId);\n    formData.append('phrase', phrase);\n    formData.append('voice', audio);\n\n    const headers: Record<string, string> = {\n      'X-User-Fullname': userFullName,\n    };\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<VoiceEnrollmentResponse>(\n      '/api-gateway/enroll/voice',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Enrolls a user's face for biometric authentication.\n   * \n   * @param {File} face - Image file that contains user's face.\n   * @param {string} userFullName - The full name of the user being enrolled.\n   * @param {string} isDocument - Indicates whether the image is a document.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<FaceEnrollmentResponse>>} - A promise resolving to the voice enrolling response.\n   * @throws {Error} - If required parameters are missing or the request fails.\n   */\n  async enrollFace(face: File, userFullName: string, isDocument?: boolean, props?: {\n    sessionId?: string,\n    deviceInfo?: object,\n  }):\n    Promise<ApiResponse<FaceEnrollmentResponse>> {\n    if (!userFullName) throw new Error('User fullname is required.');\n    if (!face) throw new Error('Face image is required.');\n\n    const formData = new FormData();\n    formData.append('face', face);\n    if (isDocument) {\n      formData.append('is_document', 'true');\n    }\n\n    const headers: Record<string, string> = {\n      'X-User-Fullname': userFullName,\n    };\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<FaceEnrollmentResponse>(\n      '/api-gateway/enroll/face',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Check the validity of a documents.\n   * \n   * @param {File} document - Document image file.\n   * @param {string} userFullName - The full name of the user being checked.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<DocAuthInfo>>} - A promise resolving to the document authentication information.\n   */\n  async checkDocAuth(\n    document: File,\n    userFullName: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<DocAuthInfo>> {\n    if (!document) throw new Error('Document image is required.');\n    if (!userFullName) throw new Error('User fullname is required.');\n\n    const formData = new FormData();\n    formData.append('document', document);\n\n    const headers: Record<string, string> = {\n      'X-User-Fullname': userFullName,\n    };\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<DocAuthInfo>(\n      '/api-gateway/docauth/check',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Matches a user's face from video against a reference image.\n   * \n   * @param {File} image - Reference image file that contains user's face.\n   * @param {string} video - Video file that contains user's face.\n   * @param {string} userFullName - Pass the full name of end-user to process Voice and Face recognition services.\n   * @param {string} processVideoRequestId - ID from the response header of /process-video endpoint.\n   * @param {boolean} usePrefilledVideo - Pass true to use the video from the process-video endpoint.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<FaceMatchResponse>} - A promise resolving to the voice enrolling response.\n   * @throws {Error} - If required parameters are missing or the request fails.\n   */\n  async matchFaces(\n    image: File,\n    video?: File,\n    userFullName?: string,\n    usePrefilledVideo?: boolean,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<FaceMatchResponse>> {\n    if (!image) throw new Error('Face image is required.');\n    if ((!usePrefilledVideo) && !video) throw new Error('Video is required.');\n    if (usePrefilledVideo && !props?.sessionId) throw new Error('Session ID is required to use a video from the process-video endpoint.');\n\n    const formData = new FormData();\n    if (video) {\n      formData.append('video', video);\n    }\n    formData.append('image', image);\n\n    const headers: Record<string, string> = {};\n\n    if (userFullName) {\n      headers['X-User-Fullname'] = userFullName;\n    }\n\n    if (usePrefilledVideo) {\n      headers['X-Use-Prefilled-Video'] = 'true';\n    }\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<FaceMatchResponse>(\n      '/api-gateway/match-faces',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Process the video through Biometry services to check liveness and authorize user\n   * \n   * @param {File} video - Video file that you want to process.\n   * @param {string} phrase - Set of numbers that user needs to say out loud in the video.\n   * @param {string} userFullName - Pass the full name of end-user to process Voice and Face recognition services.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<ProcessVideoResponse>>} - A promise resolving to the process video response.\n   */\n  async processVideo(\n    video: File,\n    phrase: string,\n    userFullName?: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<ProcessVideoResponse>> {\n    if (!video) throw new Error('Video is required.');\n    if (!phrase) throw new Error('Phrase is required.');\n\n    const formData = new FormData();\n    formData.append('phrase', phrase);\n    formData.append('video', video);\n\n    const headers: Record<string, string> = {};\n\n    if (userFullName) {\n      headers['X-User-Fullname'] = userFullName;\n    }\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<ProcessVideoResponse>(\n      '/api-gateway/process-video',\n      'POST',\n      formData,\n      headers\n    );\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"sdk.js","sources":["../src/sdk/index.ts"],"sourcesContent":["import { ApiResponse } from \"../types/internal\";\nimport { DocAuthInfo } from \"../types/biometry/doc-auth\";\nimport { ConsentResponse } from \"../types/biometry/consent\";\nimport { FaceEnrollmentResponse, VoiceEnrollmentResponse } from \"../types/biometry/enrollment\";\nimport { FaceMatchResponse } from \"../types/biometry/face-match\";\nimport { ProcessVideoResponse } from \"../types/biometry/process-video\";\nimport { SessionResponse } from \"../types/biometry/session\";\n\nexport class BiometrySDK {\n  private apiKey: string;\n  private static readonly BASE_URL: string = 'https://api.biometrysolutions.com'; //'https://dev-console.biometrysolutions.com';\n\n  constructor(apiKey: string) {\n    if (!apiKey) {\n      throw new Error('API Key is required to initialize the SDK.');\n    }\n\n    this.apiKey = apiKey;\n  }\n\n  private async request<T>(path: string, method: string, body?: any, headers?: Record<string, string>):\n    Promise<ApiResponse<T>> {\n    const defaultHeaders: HeadersInit = {\n      Authorization: `Bearer ${this.apiKey}`,\n    };\n\n    const requestHeaders = { ...defaultHeaders, ...headers };\n\n    if (body && !(body instanceof FormData)) {\n      requestHeaders['Content-Type'] = 'application/json';\n      body = JSON.stringify(body);\n    }\n    const response = await fetch(`${BiometrySDK.BASE_URL}${path}`, {\n      method,\n      headers: requestHeaders,\n      body,\n    });\n\n    if (!response.ok) {\n      const errorData = await response.json().catch(() => ({}));\n      const errorMessage = errorData?.error || errorData?.message || 'Unknown error occurred';\n\n      throw new Error(`Error ${response.status}: ${errorMessage}`);\n    }\n\n    // 🔹 Extract ALL response headers\n    const responseHeaders: Record<string, string> = {};\n    response.headers.forEach((value, key) => {\n      responseHeaders[key] = value;\n    });\n\n    const responseBody = await response.json();\n\n    return {\n      body: responseBody as T,\n      headers: responseHeaders\n    };\n  }\n\n  /**\n   * Starts a new Session for a user.\n   * \n   * @returns {Promise<ApiResponse<SessionResponse>>} A promise resolving to the session ID.\n   * @throws {Error} - If the request fails.\n   */\n  async startSession(): Promise<ApiResponse<SessionResponse>> {\n    return await this.request<SessionResponse>(\n      '/api-gateway/sessions/start',\n      'POST'\n    );\n  }\n\n  /**\n   * Submits Authorization consent for a user.\n   * Authorization Consent is required to use the services like Face and Voice recognition.\n   * \n   * @param {boolean} isConsentGiven - Indicates whether the user has given consent.\n   * @param {string} userFullName - The full name of the user giving consent.\n   * @param {Object} [props] - Optional properties for the consent request.\n   * @param {string} [props.sessionId] - Session ID to link this consent with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<ConsentResponse>>} A promise resolving to the consent response.\n   * @throws {Error} - If the user's full name is not provided or if the request fails.\n   */\n  async giveAuthorizationConsent(\n    isConsentGiven: boolean,\n    userFullName: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<ConsentResponse>> {\n    if (!userFullName) {\n      throw new Error('User Full Name is required to give consent.');\n    }\n\n    const body = {\n      is_consent_given: isConsentGiven,\n      user_fullname: userFullName,\n    };\n\n    const headers: Record<string, string> = {};\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<ConsentResponse>(\n      '/api-consent/consent',\n      'POST',\n      body,\n      headers\n    );\n  }\n\n  /**\n   * Submits Storage consent for a user.\n   * Storage consent is granted by users, allowing us to store their biometric data for future verification.\n   * \n   * @param {boolean} isStorageConsentGiven - Indicates whether the user has given storage consent.\n   * @param {string} userFullName - The full name of the user giving storage consent.\n   * @param {Object} [props] - Optional properties for the consent request.\n   * @param {string} [props.sessionId] - Session ID to link this consent with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<ConsentResponse>>} A promise resolving to the consent response.\n   * @throws {Error} - If the user's full name is not provided or if the request fails.\n   */\n  async giveStorageConsent(\n    isStorageConsentGiven: boolean,\n    userFullName: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<ConsentResponse>> {\n    if (!userFullName) {\n      throw new Error('User Full Name is required to give storage consent.');\n    }\n\n    const body = {\n      is_consent_given: isStorageConsentGiven,\n      user_fullname: userFullName,\n    };\n\n    const headers: Record<string, string> = {};\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<ConsentResponse>(\n      '/api-consent/strg-consent',\n      'POST',\n      body,\n      headers\n    );\n  }\n\n  /**\n   * Enrolls a user's voice for biometric authentication.\n   * \n   * @param {File} audio - The audio file containing the user's voice.\n   * @param {string} userFullName - The full name of the user being enrolled.\n   * @param {string} uniqueId - A unique identifier for the enrolling process.\n   * @param {string} phrase - The phrase spoken in the audio file.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<VoiceEnrollmentResponse>>} - A promise resolving to the voice enrolling response.\n   * @throws {Error} - If required parameters are missing or the request fails.\n   */\n  async enrollVoice(\n    audio: File,\n    userFullName: string,\n    uniqueId: string,\n    phrase: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<VoiceEnrollmentResponse>> {\n    if (!userFullName) throw new Error('User fullname is required.');\n    if (!uniqueId) throw new Error('Unique ID is required.');\n    if (!phrase) throw new Error('Phrase is required.');\n    if (!audio) throw new Error('Audio file is required.');\n\n    const formData = new FormData();\n    formData.append('unique_id', uniqueId);\n    formData.append('phrase', phrase);\n    formData.append('voice', audio);\n\n    const headers: Record<string, string> = {\n      'X-User-Fullname': userFullName,\n    };\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<VoiceEnrollmentResponse>(\n      '/api-gateway/enroll/voice',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Enrolls a user's face for biometric authentication.\n   * \n   * @param {File} face - Image file that contains user's face.\n   * @param {string} userFullName - The full name of the user being enrolled.\n   * @param {string} isDocument - Indicates whether the image is a document.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<FaceEnrollmentResponse>>} - A promise resolving to the voice enrolling response.\n   * @throws {Error} - If required parameters are missing or the request fails.\n   */\n  async enrollFace(face: File, userFullName: string, isDocument?: boolean, props?: {\n    sessionId?: string,\n    deviceInfo?: object,\n  }):\n    Promise<ApiResponse<FaceEnrollmentResponse>> {\n    if (!userFullName) throw new Error('User fullname is required.');\n    if (!face) throw new Error('Face image is required.');\n\n    const formData = new FormData();\n    formData.append('face', face);\n    if (isDocument) {\n      formData.append('is_document', 'true');\n    }\n\n    const headers: Record<string, string> = {\n      'X-User-Fullname': userFullName,\n    };\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<FaceEnrollmentResponse>(\n      '/api-gateway/enroll/face',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Check the validity of a documents.\n   * \n   * @param {File} document - Document image file.\n   * @param {string} userFullName - The full name of the user being checked.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<DocAuthInfo>>} - A promise resolving to the document authentication information.\n   */\n  async checkDocAuth(\n    document: File,\n    userFullName: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<DocAuthInfo>> {\n    if (!document) throw new Error('Document image is required.');\n    if (!userFullName) throw new Error('User fullname is required.');\n\n    const formData = new FormData();\n    formData.append('document', document);\n\n    const headers: Record<string, string> = {\n      'X-User-Fullname': userFullName,\n    };\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<DocAuthInfo>(\n      '/api-gateway/docauth/check',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Matches a user's face from video against a reference image.\n   * \n   * @param {File} image - Reference image file that contains user's face.\n   * @param {string} video - Video file that contains user's face.\n   * @param {string} userFullName - Pass the full name of end-user to process Voice and Face recognition services.\n   * @param {string} processVideoRequestId - ID from the response header of /process-video endpoint.\n   * @param {boolean} usePrefilledVideo - Pass true to use the video from the process-video endpoint.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<FaceMatchResponse>} - A promise resolving to the voice enrolling response.\n   * @throws {Error} - If required parameters are missing or the request fails.\n   */\n  async matchFaces(\n    image: File,\n    video?: File,\n    userFullName?: string,\n    usePrefilledVideo?: boolean,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<FaceMatchResponse>> {\n    if (!image) throw new Error('Face image is required.');\n    if ((!usePrefilledVideo) && !video) throw new Error('Video is required.');\n    if (usePrefilledVideo && !props?.sessionId) throw new Error('Session ID is required to use a video from the process-video endpoint.');\n\n    const formData = new FormData();\n    if (video) {\n      formData.append('video', video);\n    }\n    formData.append('image', image);\n\n    const headers: Record<string, string> = {};\n\n    if (userFullName) {\n      headers['X-User-Fullname'] = userFullName;\n    }\n\n    if (usePrefilledVideo) {\n      headers['X-Use-Prefilled-Video'] = 'true';\n    }\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<FaceMatchResponse>(\n      '/api-gateway/match-faces',\n      'POST',\n      formData,\n      headers\n    );\n  }\n\n  /**\n   * Process the video through Biometry services to check liveness and authorize user\n   * \n   * @param {File} video - Video file that you want to process.\n   * @param {string} phrase - Set of numbers that user needs to say out loud in the video.\n   * @param {string} userFullName - Pass the full name of end-user to process Voice and Face recognition services.\n   * @param {Object} [props] - Optional properties for the enrollment request.\n   * @param {string} [props.sessionId] - Session ID to link this enrollment with a specific session group.\n   * @param {object} [props.deviceInfo] - Device information object containing details about the user's device.\n   *                                      This can include properties like operating system, browser, etc.\n   * @returns {Promise<ApiResponse<ProcessVideoResponse>>} - A promise resolving to the process video response.\n   */\n  async processVideo(\n    video: File,\n    phrase: string,\n    userFullName?: string,\n    props?: {\n      sessionId?: string,\n      deviceInfo?: object,\n    }\n  ): Promise<ApiResponse<ProcessVideoResponse>> {\n    if (!video) throw new Error('Video is required.');\n    if (!phrase) throw new Error('Phrase is required.');\n\n    const formData = new FormData();\n    formData.append('phrase', phrase);\n    formData.append('video', video);\n\n    const headers: Record<string, string> = {};\n\n    if (userFullName) {\n      headers['X-User-Fullname'] = userFullName;\n    }\n\n    if (props?.sessionId) {\n      headers['X-Session-ID'] = props.sessionId;\n    }\n\n    if (props?.deviceInfo) {\n      headers['X-Device-Info'] = JSON.stringify(props.deviceInfo);\n    }\n\n    return await this.request<ProcessVideoResponse>(\n      '/api-gateway/process-video',\n      'POST',\n      formData,\n      headers\n    );\n  }\n}"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biometry-sdk",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "type": "module",
   "main": "dist/sdk.js",
   "module": "dist/sdk.js",
@@ -48,4 +48,4 @@
   "dependencies": {
     "fix-webm-duration": "^1.0.6"
   }
-}
+}