nervoscan-js-sdk 1.0.4-0 → 1.0.4

package/README.md

@@ -1,23 +1,25 @@
 ![nervotec.png](nervotec.png)
 
+# NervoScan JS SDK
+
 [![npm version](https://img.shields.io/npm/v/nervoscan-js-sdk)](https://www.npmjs.com/package/nervoscan-js-sdk)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
 
 ## Overview
 
-The **NervoScan JS SDK** is a lightweight JavaScript library that enables seamless integration with the NervoScan backend services. This SDK handles authentication, video scan submission, and structured error handling — allowing developers to build React or other web-based clients effortlessly on top of NervoScan's contactless health analysis platform.
-
-It provides a singleton `Client` interface and a full suite of custom error classes for advanced control and debugging.
+The **NervoScan JS SDK** is a comprehensive JavaScript/TypeScript library that enables seamless integration with the NervoScan contactless health analysis platform. This SDK provides real-time video streaming capabilities, live health metric results, and robust error handling for building sophisticated health monitoring applications.
 
----
+### Key Features
 
-## Features
-
-- Authenticated communication with the NervoScan backend
-- Video scan submission and result retrieval
-- Fully type-safe implementation (written in TypeScript)
-- Structured custom error classes for robust error handling
-- Easy integration into any React, Vite, or JS-based frontend
-- Singleton pattern for consistent client state management
+- 🎥 **Real-time Video Streaming** - Stream video directly from webcam using WebRTC
+- 📊 **Live Results** - Receive health metrics in real-time via Firebase
+- 🔄 **Dual Processing Modes** - Support for both batch video upload and live streaming
+- 🏗️ **Multiple Backend Types** - Server and serverless deployment options
+- 🛡️ **Type-Safe** - Full TypeScript support with comprehensive type definitions
+- 🎯 **Smart Error Handling** - Detailed error classes for face positioning and scan quality
+- ⚡ **Framework Agnostic** - Works with React, Vue, Angular, or vanilla JS
+- 📦 **Multiple Module Formats** - ESM, CommonJS, and UMD builds included
 
 ---
 
@@ -27,35 +29,71 @@ It provides a singleton `Client` interface and a full suite of custom error clas
 npm install nervoscan-js-sdk
 ```
 
+Or with yarn:
+```bash
+yarn add nervoscan-js-sdk
+```
+
 ---
 
-## Usage
+## Quick Start
 
-```ts
-import { Client, Errors } from 'nervoscan-js-sdk';
+### Basic Video Upload
+
+```typescript
+import { Client } from 'nervoscan-js-sdk';
 
-// Get the singleton instance
 const client = Client.getInstance();
 
-async function submitScan(videoBlob: Blob) {
-  try {
-    // Initialize with credentials
-    await client.initialize('username', 'password');
-    
-    // Upload video and get job ID
-    const jobID = await client.uploadVideo(videoBlob);
-    console.log('Scan submitted. Job ID:', jobID);
-    
-    // Check results
-    const results = await client.getResults(jobID);
-    console.log('Scan results:', results);
-  } catch (error) {
-    if (error instanceof Errors.InvalidPasswordError) {
-      console.error('Password incorrect.');
-    } else {
-      console.error('Unexpected error:', error);
-    }
-  }
+// Initialize with credentials
+await client.initialize('username', 'password');
+
+// Upload a video file
+const videoBlob = new Blob([videoData], { type: 'video/mp4' });
+const jobId = await client.uploadVideo(videoBlob);
+
+console.log('Video uploaded! Job ID:', jobId);
+```
+
+### Real-time Streaming with Live Results
+
+```typescript
+import { Client } from 'nervoscan-js-sdk';
+
+const client = Client.getInstance();
+
+async function startHealthMonitoring() {
+  // Initialize client
+  await client.initialize('username', 'password');
+  
+  // Set up result callbacks
+  client.setOnWindowResults((results) => {
+    console.log('New window results:', results);
+    // Update UI with real-time metrics
+  });
+  
+  client.setOnFinalResults((results) => {
+    console.log('Final averaged results:', results);
+    // Display final health report
+  });
+  
+  client.setOnError((error) => {
+    console.error('Scan error:', error);
+    // Handle scanning errors
+  });
+  
+  // Get webcam stream
+  const stream = await navigator.mediaDevices.getUserMedia({ 
+    video: { width: 1280, height: 720 } 
+  });
+  
+  // Initialize streaming
+  const videoElement = document.getElementById('video') as HTMLVideoElement;
+  client.initializeStreaming(stream, videoElement);
+  
+  // Start streaming
+  const jobId = await client.startStreaming();
+  console.log('Streaming started! Job ID:', jobId);
 }
 ```
 
@@ -63,73 +101,260 @@ async function submitScan(videoBlob: Blob) {
 
 ## API Reference
 
-### `Client` Class
+### Client Class
+
+The `Client` class follows a singleton pattern to ensure consistent state management across your application.
 
-#### Singleton Access
-```ts
-Client.getInstance(): Client
+#### Getting the Instance
+
+```typescript
+const client = Client.getInstance();
 ```
-Returns the singleton instance of the Client class.
 
-#### Methods
+#### Core Methods
+
+##### `initialize(username: string, password: string, serverType?: string): void`
+Initializes the client with authentication credentials.
+
+- `username` - Your NervoScan account username
+- `password` - Your NervoScan account password  
+- `serverType` - Backend type: `'server'` (default) or `'serverless'`
+
+##### `uploadVideo(videoBlob: Blob): Promise<string>`
+Uploads a video for processing and returns the job ID.
+
+- `videoBlob` - Video file as a Blob object
+- Returns: Promise resolving to the job ID string
+
+##### `initializeStreaming(videoStream: MediaStream, videoElement: HTMLVideoElement): void`
+Sets up real-time video streaming.
+
+- `videoStream` - MediaStream from getUserMedia
+- `videoElement` - HTML video element for preview
+
+##### `startStreaming(): Promise<string>`
+Begins streaming video to the server for real-time analysis.
+
+- Returns: Promise resolving to the job ID string
+
+##### `stopStreaming(): void`
+Stops the active streaming session.
+
+#### Callback Methods
 
-- `initialize(username: string, password: string): void`  
-  Initializes the client with user credentials.
+##### `setOnWindowResults(callback: (results: any) => void): void`
+Sets callback for receiving real-time window-based results.
 
-- `uploadVideo(videoBlob: Blob): Promise<string>`  
-  Uploads a video scan and returns the job ID.
+##### `setOnFinalResults(callback: (results: any) => void): void`
+Sets callback for receiving final averaged results.
 
-- `checkResults(jobID: string): Promise<string>`  
-  Checks if results are available for the given job ID.
+##### `setOnError(callback: (error: any) => void): void`
+Sets callback for handling scan errors.
 
-- `getResults(jobID: string): Promise<any>`  
-  Fetches scan results for the given job ID.
+##### `setOnDisconnection(callback: () => void): void`
+Sets callback for handling connection loss.
+
+#### Deprecated Methods
+
+⚠️ The following methods are deprecated and will be removed in future versions:
+
+- `checkResults(jobID: string)` - Use callback methods instead
+- `getResults(jobID: string)` - Use callback methods instead
 
 ---
 
 ## Error Handling
 
-The SDK provides custom error classes for granular error control:
-
-```ts
-import { Errors } from 'nervoscan-js-sdk';
+The SDK provides comprehensive error classes for granular error control:
 
+### Authentication Errors
+```typescript
 try {
   await client.initialize('username', 'password');
-} catch (err) {
-  if (err instanceof Errors.NotInitializedError) {
-    console.error('Client not initialized.');
+} catch (error) {
+  if (error instanceof Errors.InvalidUsernameError) {
+    console.error('Invalid username');
+  } else if (error instanceof Errors.InvalidPasswordError) {
+    console.error('Invalid password');
   }
 }
 ```
 
-### Available Errors
+### Scan Quality Errors
+```typescript
+client.setOnError((error) => {
+  if (error instanceof Errors.FaceTooFarError) {
+    showMessage('Please move closer to the camera');
+  } else if (error instanceof Errors.FaceTooCloseError) {
+    showMessage('Please move further from the camera');
+  } else if (error instanceof Errors.FaceNotCenteredError) {
+    showMessage('Please center your face in the frame');
+  } else if (error instanceof Errors.LowFPSError) {
+    showMessage('Poor video quality - check your lighting');
+  }
+});
+```
 
-- `NotInitializedError` - Client not properly initialized
-- `EmptyVideoError` - Video blob is empty
-- `VideoTypeError` - Invalid video type, not a blob
-- `InvalidUsernameError` - Invalid username provided
-- `InvalidPasswordError` - Invalid password provided
-- `InvalidAccessTokenError` - Invalid or expired access token
-- `NoScansAvailableError` - No scans available in current plan
-- `NoScanDataError` - No scan data available for the job ID
+### Complete Error Reference
+
+| Error Class | Description |
+|-------------|-------------|
+| `NotInitializedError` | Client not initialized |
+| `EmptyVideoError` | Video blob is empty |
+| `VideoTypeError` | Invalid video type |
+| `InvalidUsernameError` | Invalid username |
+| `InvalidPasswordError` | Invalid password |
+| `InvalidAccessTokenError` | Invalid or expired token |
+| `NoScansAvailableError` | No scans left in plan |
+| `NoScanDataError` | No data for job ID |
+| `InvalidServerTypeError` | Invalid server type |
+| `LowFPSError` | Video FPS too low |
+| `FaceNotCenteredError` | Face not centered |
+| `FaceTooFarError` | Face too far away |
+| `FaceTooCloseError` | Face too close |
+| `FaceLookingLeftError` | Face turned left |
+| `FaceLookingRightError` | Face turned right |
+| `UnhandledScanError` | Other scan errors |
 
 ---
 
-## Requirements
+## Real-World Examples
+
+### React Component with Live Monitoring
+
+```typescript
+import React, { useEffect, useRef, useState } from 'react';
+import { Client, Errors } from 'nervoscan-js-sdk';
+
+function HealthMonitor() {
+  const videoRef = useRef<HTMLVideoElement>(null);
+  const [isScanning, setIsScanning] = useState(false);
+  const [heartRate, setHeartRate] = useState<number | null>(null);
+  const [message, setMessage] = useState('');
+  
+  const client = Client.getInstance();
+  
+  useEffect(() => {
+    // Setup callbacks
+    client.setOnWindowResults((results) => {
+      setHeartRate(results.heartRate);
+    });
+    
+    client.setOnError((error) => {
+      if (error instanceof Errors.FaceNotCenteredError) {
+        setMessage('Center your face in the frame');
+      }
+    });
+    
+    return () => {
+      client.stopStreaming();
+    };
+  }, []);
+  
+  const startScan = async () => {
+    try {
+      await client.initialize('user@example.com', 'password');
+      
+      const stream = await navigator.mediaDevices.getUserMedia({ 
+        video: { facingMode: 'user' } 
+      });
+      
+      if (videoRef.current) {
+        client.initializeStreaming(stream, videoRef.current);
+        await client.startStreaming();
+        setIsScanning(true);
+      }
+    } catch (error) {
+      console.error('Failed to start scan:', error);
+    }
+  };
+  
+  return (
+    <div>
+      <video ref={videoRef} autoPlay playsInline />
+      {heartRate && <p>Heart Rate: {heartRate} BPM</p>}
+      <p>{message}</p>
+      <button onClick={startScan} disabled={isScanning}>
+        {isScanning ? 'Scanning...' : 'Start Scan'}
+      </button>
+    </div>
+  );
+}
+```
+
+### Vue 3 Composition API Example
+
+```typescript
+<template>
+  <div>
+    <video ref="videoEl" autoplay playsinline></video>
+    <div v-if="metrics">
+      <p>Heart Rate: {{ metrics.heartRate }} BPM</p>
+      <p>Stress Level: {{ metrics.stressLevel }}</p>
+    </div>
+  </div>
+</template>
 
-- Node.js v14 or higher
-- Modern browser (Chrome/Safari) for webcam support
-- NervoScan backend access (credentials required)
+<script setup lang="ts">
+import { ref, onMounted, onUnmounted } from 'vue';
+import { Client } from 'nervoscan-js-sdk';
+
+const videoEl = ref<HTMLVideoElement>();
+const metrics = ref(null);
+
+const client = Client.getInstance();
+
+onMounted(async () => {
+  await client.initialize(import.meta.env.VITE_NERVO_USER, 
+                         import.meta.env.VITE_NERVO_PASS);
+  
+  client.setOnFinalResults((results) => {
+    metrics.value = results;
+  });
+  
+  const stream = await navigator.mediaDevices.getUserMedia({ video: true });
+  if (videoEl.value) {
+    client.initializeStreaming(stream, videoEl.value);
+    await client.startStreaming();
+  }
+});
+
+onUnmounted(() => {
+  client.stopStreaming();
+});
+</script>
+```
 
 ---
 
-## License
+## Requirements
 
-MIT License
+- **Node.js**: v14 or higher
+- **Browser Support**: Chrome 80+, Safari 14+, Firefox 78+, Edge 80+
+- **Network**: Stable internet connection for streaming
+- **Camera**: HD webcam (720p or higher recommended)
+- **NervoScan Account**: Valid credentials with active subscription
 
 ---
 
-## Maintainers
+## TypeScript Support
+
+The SDK is written in TypeScript and includes comprehensive type definitions:
+
+```typescript
+import { Client, Errors, NervoscanError } from 'nervoscan-js-sdk';
+
+// All methods are fully typed
+const client: Client = Client.getInstance();
+
+// Error types are available
+function handleError(error: unknown) {
+  if (error instanceof NervoscanError) {
+    // Handle NervoScan specific errors
+  }
+}
+```
+
+---
 
-Built and maintained by the NervoScan development team.
+Built and maintained by the NervoScan team

package/dist/nervoscan-js-sdk.js

@@ -1581,7 +1581,7 @@ FIREBASE: `))}restoreState_(){this.tryAuth(),this.tryAppCheck();for(const e of t
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */function R_(n){Ed(ad),rn(new yt("database",(e,{instanceIdentifier:t})=>{const s=e.getProvider("app").getImmediate(),r=e.getProvider("auth-internal"),i=e.getProvider("app-check-internal");return v_(s,r,i,t)},"PUBLIC").setMultipleInstances(!0)),$e(Qr,Jr,n),$e(Qr,Jr,"esm2017")}fe.prototype.simpleListen=function(n,e){this.sendRequest("q",{p:n},e)};fe.prototype.echo=function(n,e){this.sendRequest("echo",{d:n},e)};R_();const Mn=n=>n==="server"?"https://backend.nervoscan.com":"https://backendv2-dev.nervoscan.com",Ne=class Ne{constructor(){k(this,"socket");k(this,"backendUrl",Mn("server"));k(this,"videoStream");k(this,"videoElement");k(this,"isConnected",!1);k(this,"isStreaming",!1);k(this,"jobId");k(this,"onDisconnection");k(this,"playHandler",()=>{if(!this.videoElement)return;const e=document.createElement("canvas");e.width=this.videoElement.videoWidth,e.height=this.videoElement.videoHeight,this.captureAndSendFrame(e,this.videoElement)});k(this,"stopStreaming",()=>{this.isStreaming=!1,this.removePlayEventListener()})}static getInstance(){return Ne.instance||(Ne.instance=new Ne),Ne.instance}setupWebSocketConnection(){this.socket||(this.socket=Gt(this.backendUrl,{transports:["websocket","polling"]}),this.socket.on("connect",()=>{this.isConnected=!0}),this.socket.on("connect_error",e=>this.handleSocketError(e)),this.socket.on("disconnect",e=>this.handleSocketDisconnection(e)))}handleSocketError(e){console.error("Connection error:",e)}handleSocketDisconnection(e){console.warn("Disconnected from WebSocket server:",e)}initializeStreaming(e,t){this.setupWebSocketConnection(),this.videoStream=e,this.videoElement=t,this.videoElement.srcObject=e}startStreaming(e){var t;this.jobId=e,(t=this.socket)==null||t.emit("register",e),this.sendInitialRequest(e),this.isStreaming=!0,this.startVideoStream(),this.addDisconnectionListener()}async sendInitialRequest(e){await I.post(`${this.backendUrl}/react`,{username:e,uuid:e,device_id:"1234567",face_detector:"BlazefaceFacemesh",motion_tracking:!0,skin_segmentor:"HSVandYCrCbSkinSegmentation",extreme_pixel_removal:!1,gamma_value:1,eularian_color_magnification:!1},{headers:{"Content-Type":"application/json"}})}startVideoStream(){this.videoElement?(this.videoElement.addEventListener("play",this.playHandler),!this.videoElement.paused&&!this.videoElement.ended&&this.playHandler(),this.videoElement.play().then(()=>{}).catch(e=>console.error("Error starting video stream:",e))):console.error("Video stream not found when trying to start streaming")}captureAndSendFrame(e,t){const s=e.getContext("2d");if(!s)return;const r=()=>{this.isStreaming&&(!t.paused&&!t.ended&&(s.drawImage(t,0,0,640,480),this.sendFrameToBackend(e)),setTimeout(r,33))};r()}sendFrameToBackend(e){e.toBlob(t=>{if(!t)return;const s=new FileReader;s.onloadend=()=>{var r;if(this.isConnected&&this.isStreaming){const i=s.result;(r=this.socket)==null||r.emit("frame",i)}},s.readAsArrayBuffer(t)},"image/jpeg",.7)}removePlayEventListener(){this.videoElement&&this.videoElement.removeEventListener("play",this.playHandler)}setOnDisconnection(e){this.onDisconnection=e}addDisconnectionListener(){const e=Jt(),t=Qt(e,`${this.jobId}/disconnect`),s=ks(t,r=>{r.val()!=null&&(this.stopStreaming(),this.onDisconnection&&this.onDisconnection(),s())})}};k(Ne,"instance");let En=Ne;class uc{constructor(e,t){k(this,"backendUrl",Mn("server"));k(this,"username");k(this,"password");k(this,"streamingManager",En.getInstance());this.username=e,this.password=t}}class I_ extends uc{constructor(t,s){super(t,s);k(this,"streamingManager",En.getInstance());this.backendUrl=Mn("server")}async getToken(){try{return(await I.post(this.backendUrl.concat("/clientlogin"),{username:this.username,password:this.password})).data.access_token}catch(t){T.handleErrorResponse(t)}}async getAPIKey(t){t||T.throwKnownError(R.InvalidAccessTokenError);try{return(await I.post(this.backendUrl.concat("/clientgeturl"),{host_name:"www.nervoscan.com"},{headers:{Authorization:`Bearer ${t}`}})).data.url.split("?api_key=")[1]}catch(s){T.handleErrorResponse(s)}}async uploadVideoToServer(t,s,r){(!s||!r)&&T.throwKnownError(R.InvalidAccessTokenError);try{const i=new FormData;return i.append("file",t,"recording.webm"),i.append("data",JSON.stringify({uuid:r,meta_data:{}})),(await I.post(this.backendUrl.concat("/submitscan"),i,{headers:{"Content-Type":"multipart/form-data",Authorization:`Bearer ${s}`}})).data}catch(i){throw console.error("Error uploading video:",i),i.response?(console.error("Error response:",i.response.data),console.error("Error status:",i.response.status),console.error("Error headers:",i.response.headers)):i.request?console.error("Error request:",i.request):console.error("Error message:",i.message),i}}async getResults(t,s){var r;s||T.throwKnownError(R.InvalidAccessTokenError);try{const i=await I.post(this.backendUrl.concat("/getcustomerinfo"),{mode:"selection",api_keys:[t]},{headers:{Authorization:`Bearer ${s}`}});return((r=i.data)==null?void 0:r.success)===!1&&T.throwKnownError(R.NoScanDataError),i.data}catch(i){console.error("Error getting results:",i),T.handleErrorResponse(i)}}async checkResults(t,s){try{s||T.throwKnownError(R.InvalidAccessTokenError);const o=(await I.post(this.backendUrl.concat("/check"),{api_key:t},{headers:{Authorization:`Bearer ${s}`}})).data.job_status;return o==="Completed"||o==="Failed"?o:"Pending"}catch(r){T.handleErrorResponse(r)}}}class N_ extends uc{constructor(e,t){super(e,t),this.backendUrl=Mn("serverless")}async getToken(){try{const e=await I.post(this.backendUrl.concat("/user/login"),{username:this.username,password:this.password});if(e.data.success===!1)T.throwKnownError(R.InvalidUsernameError);else return JSON.parse(e.data.body).idToken}catch(e){console.error("error printed in serverless repository",e),T.handleErrorResponse(e)}}async getAPIKey(e){e||T.throwKnownError(R.InvalidAccessTokenError);try{return(await I.post(this.backendUrl.concat("/get-redirection-url"),{host_name:"www.nervoscan.com",username:this.username},{headers:{Authorization:`Bearer ${e}`}})).data.url.split("?api_key=")[1]}catch(t){T.handleErrorResponse(t)}}async uploadVideoToServer(e,t,s){(!t||!s)&&T.throwKnownError(R.InvalidAccessTokenError);try{const r=await this.generatePreSignedUrl(s);return r||T.throwKnownError(R.InvalidAccessTokenError),await this.uploadVideoToS3(e,r)}catch(r){throw console.error("Error uploading video:",r),r.response?(console.error("Error response:",r.response.data),console.error("Error status:",r.response.status),console.error("Error headers:",r.response.headers)):r.request?console.error("Error request:",r.request):console.error("Error message:",r.message),r}}getResults(e,t){return console.log("not implemented"),Promise.resolve(void 0)}async checkResults(e,t){try{t||T.throwKnownError(R.InvalidAccessTokenError);const i=(await I.post(this.backendUrl.concat("/check"),{api_key:e},{headers:{Authorization:`Bearer ${t}`}})).data.job_status;return i==="Completed"||i==="Failed"?i:"Pending"}catch(s){T.handleErrorResponse(s)}}async generatePreSignedUrl(e){try{return(await I.get(this.backendUrl.concat("/generate-presigned-url?job_id="+e))).data.upload_url}catch(t){T.handleErrorResponse(t)}}async uploadVideoToS3(e,t){try{return(await I.put(t,e,{headers:{"Content-Type":"video/mp4"}})).data}catch(s){T.handleErrorResponse(s)}}}var A_="firebase",k_="11.6.1";/**
+ */function R_(n){Ed(ad),rn(new yt("database",(e,{instanceIdentifier:t})=>{const s=e.getProvider("app").getImmediate(),r=e.getProvider("auth-internal"),i=e.getProvider("app-check-internal");return v_(s,r,i,t)},"PUBLIC").setMultipleInstances(!0)),$e(Qr,Jr,n),$e(Qr,Jr,"esm2017")}fe.prototype.simpleListen=function(n,e){this.sendRequest("q",{p:n},e)};fe.prototype.echo=function(n,e){this.sendRequest("echo",{d:n},e)};R_();const Mn=n=>n==="server"?"https://backend.nervoscan.com":"https://backendv2-dev.nervoscan.com",Ne=class Ne{constructor(){k(this,"socket");k(this,"backendUrl",Mn("server"));k(this,"videoStream");k(this,"videoElement");k(this,"isConnected",!1);k(this,"isStreaming",!1);k(this,"jobId");k(this,"onDisconnection");k(this,"playHandler",()=>{if(!this.videoElement)return;const e=document.createElement("canvas");e.width=this.videoElement.videoWidth,e.height=this.videoElement.videoHeight,this.captureAndSendFrame(e,this.videoElement)});k(this,"stopStreaming",()=>{this.isStreaming=!1,this.removePlayEventListener()})}static getInstance(){return Ne.instance||(Ne.instance=new Ne),Ne.instance}setupWebSocketConnection(){this.socket||(console.log("Setting up WebSocket connection:",this.backendUrl),this.socket=Gt(this.backendUrl,{transports:["websocket","polling"]}),this.socket.on("connect",()=>{this.isConnected=!0}),this.socket.on("connect_error",e=>this.handleSocketError(e)),this.socket.on("disconnect",e=>this.handleSocketDisconnection(e)))}handleSocketError(e){console.error("Connection error:",e)}handleSocketDisconnection(e){console.warn("Disconnected from WebSocket server:",e)}initializeStreaming(e,t){console.log("Initializing streaming"),this.setupWebSocketConnection(),this.videoStream=e,this.videoElement=t,this.videoElement.srcObject=e}startStreaming(e){var t;this.jobId=e,(t=this.socket)==null||t.emit("register",e),this.sendInitialRequest(e),this.isStreaming=!0,this.startVideoStream(),this.addDisconnectionListener()}async sendInitialRequest(e){await I.post(`${this.backendUrl}/react`,{username:e,uuid:e,device_id:"1234567",face_detector:"BlazefaceFacemesh",motion_tracking:!0,skin_segmentor:"HSVandYCrCbSkinSegmentation",extreme_pixel_removal:!1,gamma_value:1,eularian_color_magnification:!1},{headers:{"Content-Type":"application/json"}})}startVideoStream(){this.videoElement?(this.videoElement.addEventListener("play",this.playHandler),!this.videoElement.paused&&!this.videoElement.ended&&this.playHandler(),this.videoElement.play().then(()=>{}).catch(e=>console.error("Error starting video stream:",e))):console.error("Video stream not found when trying to start streaming")}captureAndSendFrame(e,t){const s=e.getContext("2d");if(!s)return;const r=()=>{this.isStreaming&&(!t.paused&&!t.ended&&(s.drawImage(t,0,0,640,480),this.sendFrameToBackend(e)),setTimeout(r,33))};r()}sendFrameToBackend(e){e.toBlob(t=>{if(!t)return;const s=new FileReader;s.onloadend=()=>{var r;if(this.isConnected&&this.isStreaming){const i=s.result;(r=this.socket)==null||r.emit("frame",i)}},s.readAsArrayBuffer(t)},"image/jpeg",.7)}removePlayEventListener(){this.videoElement&&this.videoElement.removeEventListener("play",this.playHandler)}setOnDisconnection(e){this.onDisconnection=e}addDisconnectionListener(){const e=Jt(),t=Qt(e,`${this.jobId}/disconnect`),s=ks(t,r=>{r.val()!=null&&(this.stopStreaming(),this.onDisconnection&&this.onDisconnection(),s())})}};k(Ne,"instance");let En=Ne;class uc{constructor(e,t){k(this,"backendUrl",Mn("server"));k(this,"username");k(this,"password");k(this,"streamingManager",En.getInstance());this.username=e,this.password=t}}class I_ extends uc{constructor(t,s){super(t,s);k(this,"streamingManager",En.getInstance());this.backendUrl=Mn("server")}async getToken(){try{return(await I.post(this.backendUrl.concat("/clientlogin"),{username:this.username,password:this.password})).data.access_token}catch(t){T.handleErrorResponse(t)}}async getAPIKey(t){t||T.throwKnownError(R.InvalidAccessTokenError);try{return(await I.post(this.backendUrl.concat("/clientgeturl"),{host_name:"www.nervoscan.com"},{headers:{Authorization:`Bearer ${t}`}})).data.url.split("?api_key=")[1]}catch(s){T.handleErrorResponse(s)}}async uploadVideoToServer(t,s,r){(!s||!r)&&T.throwKnownError(R.InvalidAccessTokenError);try{const i=new FormData;return i.append("file",t,"recording.webm"),i.append("data",JSON.stringify({uuid:r,meta_data:{}})),(await I.post(this.backendUrl.concat("/submitscan"),i,{headers:{"Content-Type":"multipart/form-data",Authorization:`Bearer ${s}`}})).data}catch(i){throw console.error("Error uploading video:",i),i.response?(console.error("Error response:",i.response.data),console.error("Error status:",i.response.status),console.error("Error headers:",i.response.headers)):i.request?console.error("Error request:",i.request):console.error("Error message:",i.message),i}}async getResults(t,s){var r;s||T.throwKnownError(R.InvalidAccessTokenError);try{const i=await I.post(this.backendUrl.concat("/getcustomerinfo"),{mode:"selection",api_keys:[t]},{headers:{Authorization:`Bearer ${s}`}});return((r=i.data)==null?void 0:r.success)===!1&&T.throwKnownError(R.NoScanDataError),i.data}catch(i){console.error("Error getting results:",i),T.handleErrorResponse(i)}}async checkResults(t,s){try{s||T.throwKnownError(R.InvalidAccessTokenError);const o=(await I.post(this.backendUrl.concat("/check"),{api_key:t},{headers:{Authorization:`Bearer ${s}`}})).data.job_status;return o==="Completed"||o==="Failed"?o:"Pending"}catch(r){T.handleErrorResponse(r)}}}class N_ extends uc{constructor(e,t){super(e,t),this.backendUrl=Mn("serverless")}async getToken(){try{const e=await I.post(this.backendUrl.concat("/user/login"),{username:this.username,password:this.password});if(e.data.success===!1)T.throwKnownError(R.InvalidUsernameError);else return JSON.parse(e.data.body).idToken}catch(e){console.error("error printed in serverless repository",e),T.handleErrorResponse(e)}}async getAPIKey(e){e||T.throwKnownError(R.InvalidAccessTokenError);try{return(await I.post(this.backendUrl.concat("/get-redirection-url"),{host_name:"www.nervoscan.com",username:this.username},{headers:{Authorization:`Bearer ${e}`}})).data.url.split("?api_key=")[1]}catch(t){T.handleErrorResponse(t)}}async uploadVideoToServer(e,t,s){(!t||!s)&&T.throwKnownError(R.InvalidAccessTokenError);try{const r=await this.generatePreSignedUrl(s);return r||T.throwKnownError(R.InvalidAccessTokenError),await this.uploadVideoToS3(e,r)}catch(r){throw console.error("Error uploading video:",r),r.response?(console.error("Error response:",r.response.data),console.error("Error status:",r.response.status),console.error("Error headers:",r.response.headers)):r.request?console.error("Error request:",r.request):console.error("Error message:",r.message),r}}getResults(e,t){return console.log("not implemented"),Promise.resolve(void 0)}async checkResults(e,t){try{t||T.throwKnownError(R.InvalidAccessTokenError);const i=(await I.post(this.backendUrl.concat("/check"),{api_key:e},{headers:{Authorization:`Bearer ${t}`}})).data.job_status;return i==="Completed"||i==="Failed"?i:"Pending"}catch(s){T.handleErrorResponse(s)}}async generatePreSignedUrl(e){try{return(await I.get(this.backendUrl.concat("/generate-presigned-url?job_id="+e))).data.upload_url}catch(t){T.handleErrorResponse(t)}}async uploadVideoToS3(e,t){try{return(await I.put(t,e,{headers:{"Content-Type":"video/mp4"}})).data}catch(s){T.handleErrorResponse(s)}}}var A_="firebase",k_="11.6.1";/**
  * @license
  * Copyright 2020 Google LLC
  *
@@ -1596,4 +1596,4 @@ FIREBASE: `))}restoreState_(){this.tryAuth(),this.tryAppCheck();for(const e of t
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */$e(A_,k_,"app");const Ae=class Ae{constructor(){k(this,"initialized",!1);k(this,"accessToken");k(this,"backendRepository");k(this,"onWindowResults");k(this,"onFinalResults");k(this,"onError");k(this,"firebaseHandlers",[]);zo({apiKey:"AIzaSyAoOpQqLrc6wQLJI5KRE2Vt7QV1cplsZv8",authDomain:"nervowebreact.firebaseapp.com",databaseURL:"https://nervowebreact-default-rtdb.asia-southeast1.firebasedatabase.app",projectId:"nervowebreact",storageBucket:"nervowebreact.firebasestorage.app",messagingSenderId:"1025695568936",appId:"1:1025695568936:web:36f269a1eb74e1fdda511d",measurementId:"G-L3105FG92S"})}static getInstance(){return Ae.instance||(Ae.instance=new Ae),Ae.instance}initialize(e,t,s="server"){this.initialized=!0,s==="server"?this.backendRepository=new I_(e,t):s==="serverless"?this.backendRepository=new N_(e,t):T.throwKnownError(R.InvalidServerTypeError)}async uploadVideo(e){var r,i,o;this.initialized||T.throwKnownError(R.NotInitializedError),e instanceof Blob||T.throwKnownError(R.VideoTypeError),(e===null||e.size===0)&&T.throwKnownError(R.EmptyVideoError);const t=await((r=this.backendRepository)==null?void 0:r.getToken()),s=await((i=this.backendRepository)==null?void 0:i.getAPIKey(t));return(o=this.backendRepository)==null||o.uploadVideoToServer(e,t,s),s&&this.addfirebaseListeners(s),s}async checkResults(e){var t,s;console.warn("Warning: checkResults() is deprecated and will be removed in a future version. Use setOnWindowResults() and setOnFinalResults() instead!"),this.initialized||T.throwKnownError(R.NotInitializedError);try{return this.accessToken||(this.accessToken=await((t=this.backendRepository)==null?void 0:t.getToken())),await((s=this.backendRepository)==null?void 0:s.checkResults(e,this.accessToken))}catch(r){T.handleErrorResponse(r)}}async getResults(e){var s,r;return console.warn("Warning: getResults() is deprecated and will be removed in a future version. Use setOnWindowResults() and setOnFinalResults() instead!"),this.initialized||T.throwKnownError(R.NotInitializedError),this.accessToken||(this.accessToken=await((s=this.backendRepository)==null?void 0:s.getToken())),await((r=this.backendRepository)==null?void 0:r.getResults(e,this.accessToken))}setOnWindowResults(e){this.onWindowResults=e}setOnFinalResults(e){this.onFinalResults=e}setOnError(e){this.onError=e}setOnDisconnection(e){var t;(t=this.backendRepository)==null||t.streamingManager.setOnDisconnection(e)}async addfirebaseListeners(e){this.addWindowListener(e),this.addFinalListener(e),this.addErrorListener(e)}addWindowListener(e){const t=Jt(),s=Qt(t,`${e}`),r=g_(s,i=>{i.val()!==null&&i.key&&/^\d+$/.test(i.key)&&this.onWindowResults&&this.onWindowResults(i.val())});this.firebaseHandlers.push(r)}removefirebaseListeners(){this.firebaseHandlers.forEach(e=>{e()}),this.firebaseHandlers=[]}addFinalListener(e){const t=Jt(),s=Qt(t,`/${e}/averaged_results/`),r=ks(s,i=>{i.val()!==null&&(this.onFinalResults&&this.onFinalResults(i.val()),this.removefirebaseListeners())});this.firebaseHandlers.push(r)}addErrorListener(e){const t=Jt(),s=Qt(t,`/${e}/error/`),r=ks(s,i=>{if(i.val()===null)return;const o=T.handleScanError(i.val());this.onError?this.onError(o):T.throwKnownError(R.ErrorCallbackNotSetError),this.removefirebaseListeners()});this.firebaseHandlers.push(r)}initializeStreaming(e,t){var s;(s=this.backendRepository)==null||s.streamingManager.initializeStreaming(e,t)}async startStreaming(){var s,r,i;this.initialized||T.throwKnownError(R.NotInitializedError);const e=await((s=this.backendRepository)==null?void 0:s.getToken()),t=await((r=this.backendRepository)==null?void 0:r.getAPIKey(e));if(t)return(i=this.backendRepository)==null||i.streamingManager.startStreaming(t),this.addfirebaseListeners(t),t;T.throwKnownError(R.InvalidAccessTokenError)}stopStreaming(){var e;(e=this.backendRepository)==null||e.streamingManager.stopStreaming()}};k(Ae,"instance");let xs=Ae;exports.Client=xs;exports.EmptyVideoError=Oi;exports.ErrorCallbackNotSetError=Ki;exports.Errors=q;exports.FPSCalculationError=Wi;exports.FaceLookingLeftError=zi;exports.FaceLookingRightError=ji;exports.FaceNotCenteredError=Hi;exports.FaceTooCloseError=$i;exports.FaceTooFarError=Vi;exports.InvalidAccessTokenError=Fi;exports.InvalidPasswordError=Di;exports.InvalidServerTypeError=Bi;exports.InvalidUsernameError=Pi;exports.LowFPSError=qi;exports.NervoscanError=U;exports.NoScanDataError=Mi;exports.NoScansAvailableError=Li;exports.NotImplementedError=Ui;exports.NotInitializedError=ki;exports.UnhandledScanError=Ps;exports.VideoTypeError=xi;
+ */$e(A_,k_,"app");const Ae=class Ae{constructor(){k(this,"initialized",!1);k(this,"accessToken");k(this,"backendRepository");k(this,"onWindowResults");k(this,"onFinalResults");k(this,"onError");k(this,"firebaseHandlers",[]);console.log("Initializing Client"),zo({apiKey:"AIzaSyAoOpQqLrc6wQLJI5KRE2Vt7QV1cplsZv8",authDomain:"nervowebreact.firebaseapp.com",databaseURL:"https://nervowebreact-default-rtdb.asia-southeast1.firebasedatabase.app",projectId:"nervowebreact",storageBucket:"nervowebreact.firebasestorage.app",messagingSenderId:"1025695568936",appId:"1:1025695568936:web:36f269a1eb74e1fdda511d",measurementId:"G-L3105FG92S"})}static getInstance(){return Ae.instance||(Ae.instance=new Ae),Ae.instance}initialize(e,t,s="server"){this.initialized=!0,s==="server"?this.backendRepository=new I_(e,t):s==="serverless"?this.backendRepository=new N_(e,t):T.throwKnownError(R.InvalidServerTypeError)}async uploadVideo(e){var r,i,o;this.initialized||T.throwKnownError(R.NotInitializedError),e instanceof Blob||T.throwKnownError(R.VideoTypeError),(e===null||e.size===0)&&T.throwKnownError(R.EmptyVideoError);const t=await((r=this.backendRepository)==null?void 0:r.getToken()),s=await((i=this.backendRepository)==null?void 0:i.getAPIKey(t));return(o=this.backendRepository)==null||o.uploadVideoToServer(e,t,s),s&&this.addfirebaseListeners(s),s}async checkResults(e){var t,s;console.warn("Warning: checkResults() is deprecated and will be removed in a future version. Use setOnWindowResults() and setOnFinalResults() instead!"),this.initialized||T.throwKnownError(R.NotInitializedError);try{return this.accessToken||(this.accessToken=await((t=this.backendRepository)==null?void 0:t.getToken())),await((s=this.backendRepository)==null?void 0:s.checkResults(e,this.accessToken))}catch(r){T.handleErrorResponse(r)}}async getResults(e){var s,r;return console.warn("Warning: getResults() is deprecated and will be removed in a future version. Use setOnWindowResults() and setOnFinalResults() instead!"),this.initialized||T.throwKnownError(R.NotInitializedError),this.accessToken||(this.accessToken=await((s=this.backendRepository)==null?void 0:s.getToken())),await((r=this.backendRepository)==null?void 0:r.getResults(e,this.accessToken))}setOnWindowResults(e){this.onWindowResults=e}setOnFinalResults(e){this.onFinalResults=e}setOnError(e){this.onError=e}setOnDisconnection(e){var t;(t=this.backendRepository)==null||t.streamingManager.setOnDisconnection(e)}initializeStreaming(e,t){var s;(s=this.backendRepository)==null||s.streamingManager.initializeStreaming(e,t)}async startStreaming(){var s,r,i;this.initialized||T.throwKnownError(R.NotInitializedError);const e=await((s=this.backendRepository)==null?void 0:s.getToken()),t=await((r=this.backendRepository)==null?void 0:r.getAPIKey(e));if(t)return(i=this.backendRepository)==null||i.streamingManager.startStreaming(t),this.addfirebaseListeners(t),t;T.throwKnownError(R.InvalidAccessTokenError)}stopStreaming(){var e;(e=this.backendRepository)==null||e.streamingManager.stopStreaming()}async addfirebaseListeners(e){this.addWindowListener(e),this.addFinalListener(e),this.addErrorListener(e)}addWindowListener(e){const t=Jt(),s=Qt(t,`${e}`),r=g_(s,i=>{i.val()!==null&&i.key&&/^\d+$/.test(i.key)&&this.onWindowResults&&this.onWindowResults(i.val())});this.firebaseHandlers.push(r)}removefirebaseListeners(){this.firebaseHandlers.forEach(e=>{e()}),this.firebaseHandlers=[]}addFinalListener(e){const t=Jt(),s=Qt(t,`/${e}/averaged_results/`),r=ks(s,i=>{i.val()!==null&&(this.onFinalResults&&this.onFinalResults(i.val()),this.removefirebaseListeners())});this.firebaseHandlers.push(r)}addErrorListener(e){const t=Jt(),s=Qt(t,`/${e}/error/`),r=ks(s,i=>{if(i.val()===null)return;const o=T.handleScanError(i.val());this.onError?this.onError(o):T.throwKnownError(R.ErrorCallbackNotSetError),this.removefirebaseListeners()});this.firebaseHandlers.push(r)}};k(Ae,"instance");let xs=Ae;exports.Client=xs;exports.EmptyVideoError=Oi;exports.ErrorCallbackNotSetError=Ki;exports.Errors=q;exports.FPSCalculationError=Wi;exports.FaceLookingLeftError=zi;exports.FaceLookingRightError=ji;exports.FaceNotCenteredError=Hi;exports.FaceTooCloseError=$i;exports.FaceTooFarError=Vi;exports.InvalidAccessTokenError=Fi;exports.InvalidPasswordError=Di;exports.InvalidServerTypeError=Bi;exports.InvalidUsernameError=Pi;exports.LowFPSError=qi;exports.NervoscanError=U;exports.NoScanDataError=Mi;exports.NoScansAvailableError=Li;exports.NotImplementedError=Ui;exports.NotInitializedError=ki;exports.UnhandledScanError=Ps;exports.VideoTypeError=xi;

package/dist/nervoscan-js-sdk.mjs

@@ -12710,7 +12710,7 @@ const Mn = (n) => n === "server" ? "https://backend.nervoscan.com" : "https://ba
     return Ne.instance || (Ne.instance = new Ne()), Ne.instance;
   }
   setupWebSocketConnection() {
-    this.socket || (this.socket = Gt(this.backendUrl, { transports: ["websocket", "polling"] }), this.socket.on("connect", () => {
+    this.socket || (console.log("Setting up WebSocket connection:", this.backendUrl), this.socket = Gt(this.backendUrl, { transports: ["websocket", "polling"] }), this.socket.on("connect", () => {
       this.isConnected = !0;
     }), this.socket.on("connect_error", (e) => this.handleSocketError(e)), this.socket.on("disconnect", (e) => this.handleSocketDisconnection(e)));
   }
@@ -12721,7 +12721,7 @@ const Mn = (n) => n === "server" ? "https://backend.nervoscan.com" : "https://ba
     console.warn("Disconnected from WebSocket server:", e);
   }
   initializeStreaming(e, t) {
-    this.setupWebSocketConnection(), this.videoStream = e, this.videoElement = t, this.videoElement.srcObject = e;
+    console.log("Initializing streaming"), this.setupWebSocketConnection(), this.videoStream = e, this.videoElement = t, this.videoElement.srcObject = e;
   }
   startStreaming(e) {
     var t;
@@ -12971,7 +12971,7 @@ const Ae = class Ae {
     k(this, "onFinalResults");
     k(this, "onError");
     k(this, "firebaseHandlers", []);
-    Io({
+    console.log("Initializing Client"), Io({
       apiKey: "AIzaSyAoOpQqLrc6wQLJI5KRE2Vt7QV1cplsZv8",
       authDomain: "nervowebreact.firebaseapp.com",
       databaseURL: "https://nervowebreact-default-rtdb.asia-southeast1.firebasedatabase.app",
@@ -13073,39 +13073,14 @@ const Ae = class Ae {
   setOnError(e) {
     this.onError = e;
   }
+  /**
+   * Sets a callback function to handle disconnection.
+   * @param callback - Function to be called when the connection is lost. Takes no parameters.
+   */
   setOnDisconnection(e) {
     var t;
     (t = this.backendRepository) == null || t.streamingManager.setOnDisconnection(e);
   }
-  async addfirebaseListeners(e) {
-    this.addWindowListener(e), this.addFinalListener(e), this.addErrorListener(e);
-  }
-  addWindowListener(e) {
-    const t = Jt(), s = Qt(t, `${e}`), i = g_(s, (r) => {
-      r.val() !== null && r.key && /^\d+$/.test(r.key) && this.onWindowResults && this.onWindowResults(r.val());
-    });
-    this.firebaseHandlers.push(i);
-  }
-  removefirebaseListeners() {
-    this.firebaseHandlers.forEach((e) => {
-      e();
-    }), this.firebaseHandlers = [];
-  }
-  addFinalListener(e) {
-    const t = Jt(), s = Qt(t, `/${e}/averaged_results/`), i = ks(s, (r) => {
-      r.val() !== null && (this.onFinalResults && this.onFinalResults(r.val()), this.removefirebaseListeners());
-    });
-    this.firebaseHandlers.push(i);
-  }
-  addErrorListener(e) {
-    const t = Jt(), s = Qt(t, `/${e}/error/`), i = ks(s, (r) => {
-      if (r.val() === null)
-        return;
-      const o = T.handleScanError(r.val());
-      this.onError ? this.onError(o) : T.throwKnownError(R.ErrorCallbackNotSetError), this.removefirebaseListeners();
-    });
-    this.firebaseHandlers.push(i);
-  }
   /**
    * Initializes the streaming manager.
    * @param videoStream - The video stream to stream
@@ -13138,6 +13113,35 @@ const Ae = class Ae {
     var e;
     (e = this.backendRepository) == null || e.streamingManager.stopStreaming();
   }
+  async addfirebaseListeners(e) {
+    this.addWindowListener(e), this.addFinalListener(e), this.addErrorListener(e);
+  }
+  addWindowListener(e) {
+    const t = Jt(), s = Qt(t, `${e}`), i = g_(s, (r) => {
+      r.val() !== null && r.key && /^\d+$/.test(r.key) && this.onWindowResults && this.onWindowResults(r.val());
+    });
+    this.firebaseHandlers.push(i);
+  }
+  removefirebaseListeners() {
+    this.firebaseHandlers.forEach((e) => {
+      e();
+    }), this.firebaseHandlers = [];
+  }
+  addFinalListener(e) {
+    const t = Jt(), s = Qt(t, `/${e}/averaged_results/`), i = ks(s, (r) => {
+      r.val() !== null && (this.onFinalResults && this.onFinalResults(r.val()), this.removefirebaseListeners());
+    });
+    this.firebaseHandlers.push(i);
+  }
+  addErrorListener(e) {
+    const t = Jt(), s = Qt(t, `/${e}/error/`), i = ks(s, (r) => {
+      if (r.val() === null)
+        return;
+      const o = T.handleScanError(r.val());
+      this.onError ? this.onError(o) : T.throwKnownError(R.ErrorCallbackNotSetError), this.removefirebaseListeners();
+    });
+    this.firebaseHandlers.push(i);
+  }
 };
 k(Ae, "instance");
 let Nr = Ae;