easyproctor-hml 2.5.22 → 2.5.23

package/README.md

@@ -263,46 +263,17 @@ const {
   token: "...",
 });
 ```
+## Release Note V 2.4.0
+- Compatibilidade com dispositivos móveis
 
-## Release Note V 2.5.4
-- Fix: Correção sobre as imagens do realtime
-
-## Release Note V 2.5.4
-- Novos alertas de tela (Clipboard, SplitScreen)
-- Ajustes na detecção de foco da tela
-- Melhorias na analise biométrica
-- Melhorias na analise do uso de dispositivos
-- Correção do uso de câmera externa no ambiente de produção 
-
-## Release Note V 2.5.3
-- Fix: Resolução do video
-- Melhorias no proctoring do tipo REALTIME
-
-## Release Note V 2.5.2
-- Alteração do nome do callback 'onFinish' para 'onResultAvailable'
-- Melhorias no proctoring do tipo REALTIME
-
-## Release Note V 2.5.1
-- Novos atributos no callback de 'onFinish'
- - scoreThreshold: limiar de aprovação da sessão de proctoring
- - justification: em caso de reprovação, esse campo traz o resumo das irregularidades
-
-## Release Note V 2.5.0
-- Callback de 'onFinish' no hook de finish que permite o acesso ao resultado da auditoria de forma imediata
-- Melhorias no proctoring em tempo real
-- Melhorias no monitoramento ativo durante o exame
-  - Novos tipos de alertas do onRealtimeAlerts:
-    - position_detection_on_stream:
-     - wrong_face_size_detected: Face muito perto da câmera, afaste-se um pouco mais
-     - wrong_face_position_edge_detected: Face muito próxima da borda, mova-se para o centro da tela
-     - wrong_face_position_move_right_detected: Face não centralizada, mova-se para a direita
-     - wrong_face_position_move_top_detected: Face não centralizada, mova-se para cima
-     - wrong_face_position_move_left_detected: Face não centralizada, mova-se para a esquerda
-     - wrong_face_position_move_bottom_detected: Face não centralizada, mova-se para baixo
+## Release Note V 2.3.3
+- Correção do reset no startSession
 
+## Release Note V 2.3.2
+- Melhorias no fluxo da câmera externa (reset e goToExternalCameraPositionStep)
 
 ## Release Note V 2.4.0
-- Compatibilidade com dispositivos móveis
+- Compatibilidade com dispositivos móveis implementada
 
 ## Release Note V 2.3.3
 - Correção do reset no startSession

package/esm/index.js

@@ -12267,7 +12267,7 @@ function recorder(stream, buffer, videoOptions, onBufferSizeError = false, onBuf
   let recorderOptions = {
     // eslint-disable-next-line no-useless-escape
     mimeType: "video/webm",
-    videoBitsPerSecond: (videoOptions == null ? void 0 : videoOptions.videoBitsPerSecond) || 128e3,
+    videoBitsPerSecond: 128e3,
     audioBitsPerSecond: 64 * 1e3
   };
   if (MediaRecorder.isTypeSupported("video/webm;codecs=vp9")) {
@@ -12280,6 +12280,9 @@ function recorder(stream, buffer, videoOptions, onBufferSizeError = false, onBuf
   if (videoOptions == null ? void 0 : videoOptions.mimeType) {
     recorderOptions.mimeType = videoOptions == null ? void 0 : videoOptions.mimeType;
   }
+  if ((videoOptions == null ? void 0 : videoOptions.videoBitsPerSecond) != void 0) {
+    recorderOptions.videoBitsPerSecond = videoOptions == null ? void 0 : videoOptions.videoBitsPerSecond;
+  }
   if (audio) {
     recorderOptions = {
       mimeType: "audio/webm",
@@ -12309,6 +12312,7 @@ function recorder(stream, buffer, videoOptions, onBufferSizeError = false, onBuf
           proctoringId,
           `onBufferSizeError: Recorder size equal 0 Mb`
         );
+        console.log("onbuffer size error");
         onBufferSizeErrorCallback && onBufferSizeErrorCallback();
       }
       lastEvent = e3;
@@ -12323,8 +12327,12 @@ function recorder(stream, buffer, videoOptions, onBufferSizeError = false, onBuf
   function startRecording() {
     return new Promise((resolve) => {
       resolvePromise = resolve;
-      console.log("startRecording", videoOptions == null ? void 0 : videoOptions.timeSlice);
-      mediaRecorder.start((videoOptions == null ? void 0 : videoOptions.timeSlice) || 1e4);
+      var timeSlice = 1e4;
+      if ((videoOptions == null ? void 0 : videoOptions.timeSlice) != void 0) {
+        timeSlice = videoOptions == null ? void 0 : videoOptions.timeSlice;
+      }
+      console.log("startRecording", timeSlice);
+      mediaRecorder.start(timeSlice);
       bufferSize = 0;
       stopped = false;
     });
@@ -12335,7 +12343,6 @@ function recorder(stream, buffer, videoOptions, onBufferSizeError = false, onBuf
         resolvePromise = resolve;
         mediaRecorder.stop();
         stopped = true;
-        clearInterval(onBufferSizeInterval);
         stream.getTracks().forEach((el) => {
           el.stop();
         });
@@ -12818,6 +12825,66 @@ var CameraRecorder = class {
       this.options.onBufferSizeErrorCallback && this.options.onBufferSizeErrorCallback();
     }
   }
+  async startStream(options) {
+    var _a2;
+    const { cameraId, microphoneId, onBufferSizeErrorCallback } = this.options;
+    const constraints = {
+      audio: { deviceId: microphoneId },
+      video: {
+        deviceId: cameraId,
+        width: this.videoOptions.width,
+        height: this.videoOptions.height,
+        frameRate: 15
+      }
+    };
+    try {
+      this.hardwareStream = await navigator.mediaDevices.getUserMedia(
+        constraints
+      );
+    } catch (error) {
+      if (error.toString() == "NotReadableError: Could not start video source")
+        throw "N\xE3o foi poss\xEDvel conectar a camera, ela pode estar sendo utilizada por outro programa";
+      throw error;
+    }
+    this.cameraStream = this.hardwareStream;
+    const track = this.cameraStream.getVideoTracks()[0];
+    const settings = track.getSettings();
+    let { width = 0, height = 0 } = settings;
+    const isPortrait = (_a2 = screen.orientation) == null ? void 0 : _a2.type.includes("portrait");
+    if (isPortrait && isMobileDevice()) {
+      if (this.videoOptions.width == height && this.videoOptions.height == width) {
+        [width, height] = [height, width];
+      }
+    }
+    if (this.videoOptions.minWidth > width || this.videoOptions.minHeight > height) {
+      throw STREAM_UNDER_MINIMUM_PERMITTED;
+    } else if (this.videoOptions.width !== width || this.videoOptions.height !== height) {
+      trackers.registerAnotherStream(
+        this.proctoringId,
+        `Maybe have another stream active
+Video Options: ${JSON.stringify(
+          this.videoOptions,
+          null,
+          2
+        )}
+Setting: ${JSON.stringify(settings, null, 2)}`
+      );
+      throw ANOTHER_STREAM_ACTIVE;
+    }
+  }
+  async stopStream() {
+    if (this.cameraStream) {
+      this.cameraStream.getTracks().forEach((track) => track.stop());
+    }
+    if (this.internalClonedStream) {
+      this.internalClonedStream.getTracks().forEach((track) => track.stop());
+      this.internalClonedStream = null;
+    }
+    if (this.hardwareStream) {
+      this.hardwareStream.getTracks().forEach((track) => track.stop());
+      this.hardwareStream = null;
+    }
+  }
   async startRecording(options) {
     var _a2, _b, _c2, _d, _e3, _f, _g, _h;
     if ((((_a2 = this.paramsConfig.videoBehaviourParameters) == null ? void 0 : _a2.detectPerson) || ((_b = this.paramsConfig.videoBehaviourParameters) == null ? void 0 : _b.detectCellPhone) || ((_c2 = this.paramsConfig.videoBehaviourParameters) == null ? void 0 : _c2.detectFace)) && !(options == null ? void 0 : options.retry)) {
@@ -14536,7 +14603,9 @@ var CapturePhoto = class {
     );
     await this.cameraRecorder.startRecording();
     cameraContainer.srcObject = this.cameraRecorder.cameraStream;
-    cameraContainer.play();
+    cameraContainer.play().catch((e3) => {
+      console.warn("Autoplay bloqueado ou erro ao iniciar v\xEDdeo:", e3);
+    });
   }
   shot() {
     const cameraContainer = document.querySelector("#cameraStream");
@@ -14629,6 +14698,9 @@ var CapturePhoto = class {
       const video = document.createElement("video");
       video.setAttribute("id", "cameraStream");
       video.muted = true;
+      video.setAttribute("playsinline", "true");
+      video.setAttribute("webkit-playsinline", "true");
+      video.autoplay = true;
       divCamera.style.position = "fixed";
       divCamera.style.top = "0";
       divCamera.style.left = "0";
@@ -14815,8 +14887,8 @@ var CapturePhoto = class {
   }
 };
 
-// src/extension/extension.ts
-var Extension = class {
+// src/extension/extensionEasyProctor.ts
+var ExtensionEasyProctor = class {
   constructor() {
     this.hasExtension = false;
     this.tryes = 0;
@@ -14861,6 +14933,89 @@ var Extension = class {
   }
 };
 
+// src/extension/extensionEasyCatcher.ts
+var ExtensionEasyCatcher = class {
+  constructor(options) {
+    this.hasExtension = false;
+    this.tryes = 0;
+    this.responseStart = false;
+    this.options = options || {};
+  }
+  /**
+   * Verifica se a extensão está instalada e ativa.
+   * Retorna o número da versão se encontrada, ou lança erro após timeout.
+   */
+  checkExtensionInstalled(timeoutMs = 2e3) {
+    return new Promise((resolve, reject) => {
+      let handled = false;
+      const handler = (event) => {
+        if (event.source === window && event.data.sender === "easyproctor-extension" && event.data.message_name === "version") {
+          handled = true;
+          window.removeEventListener("message", handler);
+          resolve(event.data.message);
+        }
+      };
+      window.addEventListener("message", handler);
+      window.postMessage({
+        type: "easycatcher",
+        func: "verifyExtensionEasycatcher"
+      }, "*");
+      setTimeout(() => {
+        if (!handled) {
+          window.removeEventListener("message", handler);
+          reject(new Error("Extens\xE3o n\xE3o detectada ou n\xE3o respondeu."));
+        }
+      }, timeoutMs);
+    });
+  }
+  /**
+   * Solicita o JSON da sessão atual capturado pela extensão.
+   */
+  getSessionData(timeoutMs = 5e3) {
+    return new Promise((resolve, reject) => {
+      let handled = false;
+      const handler = (event) => {
+        if (event.source === window && event.data.sender === "easyproctor-extension" && event.data.message_name === "data_response") {
+          handled = true;
+          window.removeEventListener("message", handler);
+          resolve(event.data.payload);
+        }
+      };
+      window.addEventListener("message", handler);
+      window.postMessage({
+        type: "easycatcher",
+        func: "getDataExtensionEasycatcher"
+      }, "*");
+      setTimeout(() => {
+        if (!handled) {
+          window.removeEventListener("message", handler);
+          reject(new Error("Timeout ao aguardar dados da extens\xE3o."));
+        }
+      }, timeoutMs);
+    });
+  }
+  start() {
+    return new Promise((resolve, reject) => {
+      let handled = false;
+      const handler = (event) => {
+        if (event.source === window && event.data.sender === "easyproctor-extension" && event.data.message_name === "started_confirmed") {
+          handled = true;
+          window.removeEventListener("message", handler);
+          resolve(true);
+        }
+      };
+      window.addEventListener("message", handler);
+      window.postMessage({ type: "easycatcher", func: "startExtensionEasycatcher" }, "*");
+      setTimeout(() => {
+        if (!handled) {
+          window.removeEventListener("message", handler);
+          reject(new Error("Timeout: Extens\xE3o n\xE3o confirmou o in\xEDcio."));
+        }
+      }, 3e3);
+    });
+  }
+};
+
 // src/modules/onChangeDevices.ts
 var onChangeDevices = class {
   constructor(repositoryDevices, proctoringId2, sessionOptions, allRecorders) {
@@ -20958,6 +21113,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     this.connection = null;
     this.context = context;
     this.onRealtimeAlertsCallback = onRealtimeAlertsCallback;
+    console.log("context -> ", context);
     this.backend = new BackendService({
       type: (context == null ? void 0 : context.type) || "prod",
       token: context.token
@@ -20971,6 +21127,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     try {
       this.transmissionOk = false;
       const response = await this.backend.externalCameraCheckTransmission("" + this.externalSessionId);
+      console.log(response);
       let attempts = 0;
       while (!this.transmissionOk && attempts <= 5) {
         await new Promise((resolve) => setTimeout(resolve, 2e3));
@@ -20987,13 +21144,16 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     try {
       this.proctoringId = proctoringId2;
       const response = await this.backend.externalCameraStartTransmission("" + this.externalSessionId, proctoringId2);
+      console.log(response);
     } catch (error) {
+      console.error("Erro ao iniciar transmiss\xE3o:", error);
       throw new Error("N\xE3o foi poss\xEDvel iniciar a transmiss\xE3o.");
     }
   }
   async goToPositionGuide() {
     try {
       const response = await this.backend.goToExternalCameraPositionStep("" + this.externalSessionId);
+      console.log(response);
     } catch (error) {
       console.error("Erro ao enviar comando de Position:", error);
       throw new Error("N\xE3o foi poss\xEDvel enviar comando de Position Guide.");
@@ -21003,6 +21163,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     if (this.connection) {
       const actionMessage = new ActionMessage();
       actionMessage.command = "Reset";
+      console.log("Enviando comando 'Reset' para o aplicativo...");
       this.connection.invoke(
         "SendAction",
         this.externalSessionId,
@@ -21016,6 +21177,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
       this.onTakePictureCallback = onTakePictureCallback;
       const actionMessage = new ActionMessage();
       actionMessage.command = "Capture";
+      console.log("Enviando comando 'Capture' para o aplicativo...");
       this.connection.invoke(
         "SendAction",
         this.externalSessionId,
@@ -21034,6 +21196,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
       await this.reset();
       const response = await this.backend.externalCameraStartSession();
       this.externalSessionId = response.externalSessionId;
+      console.log(this.externalSessionId);
       this.currentStep = 0 /* STARTED */;
       const pairingObject = {
         externalSessionId: this.externalSessionId,
@@ -21042,6 +21205,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
       };
       const pairingDataString = JSON.stringify(pairingObject);
       this.qrCodeBase64Image = await import_qrcode.default.toDataURL(pairingDataString);
+      console.log(this.qrCodeBase64Image);
       return this.qrCodeBase64Image;
     } catch (error) {
       this.disconnectWebSocket();
@@ -21140,6 +21304,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
         var _a2;
         const actionMessage = new ActionMessage();
         actionMessage.command = "Cancel";
+        console.log("Enviando comando 'Cancel' para o aplicativo...");
         (_a2 = this.connection) == null ? void 0 : _a2.invoke(
           "SendAction",
           this.externalSessionId,
@@ -21479,6 +21644,8 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     this.connection.on(
       "ReceiveMessage",
       (sessionId, messageStr) => {
+        console.log("sessionId: ", sessionId);
+        console.log("Message: ", messageStr);
         if (sessionId !== this.externalSessionId) {
           console.warn("Sess\xE3o diferente!");
           return;
@@ -21486,6 +21653,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
         try {
           const messageKey = messageStr;
           const message = ExternalCameraStatusEnum[messageKey];
+          console.log("Mensagem -> ", message);
           this.handleWebSocketMessage(message);
         } catch (e3) {
           console.error("Erro ao processar mensagem do WebSocket:", e3);
@@ -21495,6 +21663,8 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     this.connection.on(
       "ReceiveAction",
       (sessionId, actionMessage) => {
+        console.log("sessionId: ", sessionId);
+        console.log("Message: ", actionMessage);
         if (sessionId !== this.externalSessionId) {
           console.warn("Sess\xE3o diferente!");
           return;
@@ -21508,6 +21678,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     );
     try {
       await this.connection.start();
+      console.log("Conectado ao Hub SignalR com sucesso!");
     } catch (err) {
       console.error("Falha ao conectar ou entrar no grupo do SignalR: ", err);
       throw new Error("N\xE3o foi poss\xEDvel conectar ao servi\xE7o em tempo real.");
@@ -21634,6 +21805,7 @@ var _ExternalCameraChecker = class _ExternalCameraChecker {
     if (this.connection) {
       try {
         await this.connection.stop();
+        console.log("Desconectado do SignalR.");
       } catch (err) {
         console.error("Erro ao desconectar do SignalR:", err);
       } finally {
@@ -21667,6 +21839,7 @@ var Proctoring = class {
   constructor(context) {
     this.context = context;
     this.deviceData = null;
+    this.sessionStartTime = 0;
     this.paramsConfig = {
       audioBehaviourParameters: {
         recordingBitrate: 128,
@@ -21944,7 +22117,10 @@ var Proctoring = class {
       if (this.context.token === void 0) {
         throw TOKEN_MISSING;
       }
-      this.extension = new Extension();
+      if (options.useChallenge) {
+        this.extensionEasycatcher = new ExtensionEasyCatcher();
+      }
+      this.extension = new ExtensionEasyProctor();
       this.extension.addEventListener();
       const baseURL = this.backend.selectBaseUrl(this.context.type);
       const devices = await enumarateDevices();
@@ -21993,6 +22169,7 @@ var Proctoring = class {
       } catch (error) {
         throw EXTERNAL_CAMERA_NOT_STARTED;
       }
+      this.sessionStartTime = Date.now();
       this.allRecorders.cameraRecorder.setProctoringId(this.proctoringId);
       this.allRecorders.noiseRecorder.setProctoringId(this.proctoringId);
       this.proctoringSession.setProctoringId(this.proctoringId);
@@ -22168,6 +22345,7 @@ Upload Services: ${uploaderServices}`,
       });
       if (this.appChecker) {
         const externalSessionId = this.appChecker.getExternalCameraSessionId();
+        console.log("externalSessionId -> ", externalSessionId);
         if (externalSessionId != "null") {
           await this.backend.externalCameraFinish(externalSessionId);
         }
@@ -22290,6 +22468,59 @@ Error: ` + error
       _screenStream: (_a2 = this.allRecorders.screenRecorder) == null ? void 0 : _a2.screenStream
     };
   }
+  async startChallenge(templateId) {
+    if (!this.sessionOptions.useChallenge) {
+      throw new Error("useChallenge is set as false on start method");
+    }
+    await this.extensionEasycatcher.checkExtensionInstalled().catch((err) => {
+      throw new Error("EasyCatcher Extension is not installed");
+    });
+    this.extensionEasycatcher.start();
+    const start = Date.now() - this.sessionStartTime;
+    await this.backend.startChallenge({
+      proctoringId: this.proctoringId,
+      templateId,
+      start
+    }).then((resp) => {
+      console.log(resp);
+      this.challengeId = resp.id;
+    }).catch((reason) => {
+      trackers.registerError(
+        this.proctoringId,
+        "N\xE3o foi poss\xEDvel iniciar desafio!"
+      );
+      throw reason;
+    });
+    this.isChallengeRunning = true;
+  }
+  async stopChallenge() {
+    if (!this.isChallengeRunning) {
+      throw new Error("Challenge not started");
+    }
+    try {
+      const sessionData = await this.extensionEasycatcher.getSessionData();
+      const end = Date.now() - this.sessionStartTime;
+      await this.backend.stopChallenge(
+        this.challengeId,
+        {
+          end,
+          data: sessionData
+        }
+      ).catch((reason) => {
+        trackers.registerError(
+          this.proctoringId,
+          "N\xE3o foi poss\xEDvel finalizar o desafio no backend!"
+        );
+        return void 0;
+      });
+      this.isChallengeRunning = false;
+    } catch (error) {
+      trackers.registerError(
+        this.proctoringId,
+        "Erro ao recuperar dados da extens\xE3o: " + error.message
+      );
+    }
+  }
 };
 
 // src/proctoring/SignTerm.ts
@@ -22517,6 +22748,8 @@ function useProctoring(proctoringOptions, enviromentConfig = "prod") {
     return originalStart(parameters2, videoOptions);
   };
   const finish = proctoring.finish.bind(proctoring);
+  const startChallenge = proctoring.startChallenge.bind(proctoring);
+  const stopChallenge = proctoring.stopChallenge.bind(proctoring);
   const pause = proctoring.pause.bind(proctoring);
   const resume = proctoring.resume.bind(proctoring);
   const onFocus = proctoring.setOnFocusCallback.bind(proctoring);
@@ -22539,6 +22772,8 @@ function useProctoring(proctoringOptions, enviromentConfig = "prod") {
     login,
     start,
     finish,
+    startChallenge,
+    stopChallenge,
     onFocus,
     onLostFocus,
     onChangeDevices: onChangeDevices2,

package/extension/extensionEasyCatcher.d.ts

@@ -0,0 +1,11 @@
+import { ProctoringFinisherOptions } from "../proctoring/proctoring";
+export declare class ExtensionEasyCatcher {
+    hasExtension: boolean;
+    tryes: number;
+    responseStart: boolean;
+    options: ProctoringFinisherOptions;
+    constructor(options?: ProctoringFinisherOptions);
+    checkExtensionInstalled(timeoutMs?: number): Promise<string>;
+    getSessionData(timeoutMs?: number): Promise<any>;
+    start(): Promise<boolean>;
+}

package/extension/{extension.d.ts → extensionEasyProctor.d.ts}

@@ -1,5 +1,5 @@
 import { ProctoringFinisherOptions } from "../proctoring/proctoring";
-export declare class Extension {
+export declare class ExtensionEasyProctor {
     hasExtension: boolean;
     tryes: number;
     responseStart: boolean;