@incodetech/core 2.2.0 → 2.3.0-rc.0

package/dist/types-DgDvvzg0.d.ts

@@ -0,0 +1,10 @@
+import { a as RegulationTypes } from "./types-Do5rEXij.js";
+//#region src/internal/fingerprint/types.d.ts
+type DeviceFingerprintResult = {
+  success: boolean;
+  sessionStatus: string;
+  showMandatoryConsent?: boolean;
+  regulationType?: RegulationTypes;
+};
+//#endregion
+export { DeviceFingerprintResult as t };

package/dist/{types-KPvmag_B.d.ts → types-Do5rEXij.d.ts}

@@ -1,5 +1,5 @@
-import { t as DocumentUploadConfig } from "./types-Vb4P9ovf.js";
 import { s as RiskAddon } from "./types-Bk_6dmDa.js";
+import "./createFaceAvatar-BlcTYgJv.js";
 //#region src/internal/avatar/concealment.d.ts
 /**
  * Backend-aligned selfie/auth face-concealment options. The backend returns a
@@ -182,7 +182,6 @@ type FlowModuleConfig = {
     scrapingV3: boolean;
     failUnsupportedId: boolean;
     dataValidation: boolean;
-    backgroundExecution: boolean;
     mockConnectionError: boolean;
     mockUserNotFoundError: boolean;
     mockOK: boolean;
@@ -193,7 +192,6 @@ type FlowModuleConfig = {
     dataValidation: boolean;
     faceAndDataValidation: boolean;
     addressValidation: boolean;
-    backgroundExecution: boolean;
     faceMatchOverrideDataScore: boolean;
     useCroppedIdFacePhoto: boolean;
   };
@@ -201,7 +199,9 @@ type FlowModuleConfig = {
   ID: TutorialIdConfig;
   SECOND_ID: TutorialIdConfig;
   /** @deprecated Third ID step is deprecated; SDK skips this step and continues flow */
-  THIRD_ID: DocumentUploadConfig;
+  THIRD_ID: {
+    documentType: string;
+  };
   ID_OCR: {
     editableOcr: boolean;
     cpfOnly?: boolean;
@@ -248,6 +248,7 @@ type FlowModuleConfig = {
     validateClosedEyes: boolean;
     validateBrightness: boolean;
     deepsightLiveness: 'SINGLE_FRAME' | 'MULTIMODAL' | 'VIDEOLIVENESS';
+    manualUploadSelfieCapture?: boolean;
     /**
      * When true, the SELFIE module runs face analysis on-device via the
      * OnDevice WASM workflow and POSTs only the results JSON to
@@ -290,6 +291,7 @@ type FlowModuleConfig = {
     /** Whether the consent audio is validated by backend speech-to-text. Default true. */
     speechToTextCheck?: boolean;
     selfieQualityAffectsScore: boolean;
+    /** Maximum active Video Selfie recording duration, in seconds. */
     maxWaitingVideoSelfieFile: number;
     lastSecondsVideoQualityCheck: boolean;
     lastSecondsVideoQualityCheckDuration: number;
@@ -322,6 +324,7 @@ type FlowModuleConfig = {
   QE_SIGNATURE: {
     uploadDocument: boolean;
     downloadDocument: boolean;
+    providerCode?: string;
   };
   CERTIFICATE_ISSUANCE: {
     region: string;

package/dist/types-ZT1XFIJ8.d.ts

@@ -0,0 +1,6 @@
+import { i as FlowModuleConfig } from "./types-Do5rEXij.js";
+import { t as BaseFaceCaptureConfig } from "./types-CM-jtjJ2.js";
+//#region src/modules/authentication/types.d.ts
+type AuthenticationConfig = FlowModuleConfig['AUTHENTICATION'] & BaseFaceCaptureConfig;
+//#endregion
+export { AuthenticationConfig as t };

package/dist/video-selfie.d.ts

@@ -1,10 +1,24 @@
-import { n as WasmPipeline } from "./warmup-Dv2alr2-.js";
+import { c as WasmPipeline } from "./warmup-Cis2p6O0.js";
 import { A as StateMachine, _ as MachineContext, c as AnyEventObject, p as EventObject, v as MetaObject, y as NonReducibleUnknown } from "./spawn-D9jgw9pW.js";
 import "./StateMachine-EDpYWy0i.js";
 import "./Actor-iTq7YY48.js";
+import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-D4tvIB5v.js";
 import { t as CameraStream } from "./camera-9wWD-pwg.js";
-import { t as DetectionOrientation } from "./IIdCaptureCapability-DHTT3FC2.js";
-import { a as FacingMode, i as CameraCompositor, n as VideoSelfieDetectionStatus, o as VideoSelfieConfig, r as VideoSelfieValidationFailure, s as VideoSelfieStep, t as StepDetector } from "./videoSelfieStepDetector-D3oo2ofo.js";
+import { t as DetectionOrientation } from "./IIdCaptureCapability-RNiFhvXR.js";
+import { a as FacingMode, i as CameraCompositor, n as VideoSelfieDetectionStatus, o as VideoSelfieConfig, r as VideoSelfieValidationFailure, s as VideoSelfieStep, t as StepDetector } from "./videoSelfieStepDetector-5YHFe0Mq.js";
+//#region ../infra/src/capabilities/ITimerCapability.d.ts
+type TimerHandle = ReturnType<typeof setTimeout>;
+type ITimerCapability = {
+  setTimeout(callback: () => void, delayMs: number): TimerHandle;
+  setInterval(callback: () => void, delayMs: number): TimerHandle;
+  clearTimeout(handle: TimerHandle): void;
+  clearInterval(handle: TimerHandle): void;
+};
+//#endregion
+//#region src/internal/recordings/videoSelfieUploadService.d.ts
+/** What the multipart upload records. Must be sent on every protocol call. */
+type VideoUploadScope = 'videoselfie' | 'selfie' | 'frontId' | 'backId';
+//#endregion
 //#region src/internal/recordings/multipartRecordingService.d.ts
 type MultipartRecordingResult = {
   /**
@@ -19,12 +33,10 @@ type MultipartRecordingResult = {
  * captured, using the video-selfie-service multipart upload protocol
  * (`/v1/video-upload/*`).
  *
- * This is the Video Selfie module's client-side recorder and is deliberately
- * independent of the face-capture recording services (`LocalRecordingService`
- * / `OpenViduRecordingService`) — it is the replacement for server-side
- * (OpenVidu) recording, not a sibling of it.
+ * This is the client-side recorder for Video Selfie and for scoped regular
+ * Selfie and ID recordings. It replaces the former server-side recording path.
  *
- * Every ~1 s recorder blob uploads as its own chunk, concurrently with
+ * Every ~0.5 s recorder blob uploads as its own chunk, concurrently with
  * recording, through {@link VideoSelfieChunkUploader} (keep-until-ack +
  * retry with backoff — see its doc for the full policy). The service stages
  * sub-5 MiB chunks and combines them server-side, so `stop()` only drains
@@ -33,14 +45,23 @@ type MultipartRecordingResult = {
  * (S3 SSE-AES-256).
  */
 declare class MultipartRecordingService {
+  private readonly scope;
   private recorder;
   private timer;
   private session;
   private uploader;
   private chunksEmitted;
+  private stopPromise;
+  private abandonRequested;
+  constructor(scope?: VideoUploadScope);
   get isRecording(): boolean;
   start(stream: MediaStream): Promise<void>;
+  /** Pause the current media container without finalizing its upload. */
+  pause(): boolean;
+  /** Resume the same media container after its video source has recovered. */
+  resume(): boolean;
   stop(): Promise<MultipartRecordingResult>;
+  private finalizeRecording;
   cleanup(): void;
   /**
    * `complete` is idempotent server-side ("safe to repeat if the response
@@ -66,21 +87,31 @@ type VideoSelfieRecordingDependencies = {
   acquireCamera?: (facingMode: FacingMode, withAudio: boolean) => Promise<CameraStream>;
   /** Runs WASM detection + backend validation per step; resolves to advance. */
   detect?: StepDetector;
+  /** Timer used by the whole-session maximum recording duration. */
+  timer?: ITimerCapability;
+  /**
+   * Overrides the page-visibility source used to pause capture. The manager
+   * promotes this dependency to the machine's required top-level input.
+   */
+  visibilityObserver?: IVisibilityObserverCapability;
   /** Minimum time to hold the switching-camera screen before resuming capture. */
   switchingCameraMinDwellMs?: number;
 };
 /**
  * Why the module errored: `connection` means a transport-level failure the
  * user can fix by getting back online (the UI shows the connection-error
- * copy); `technical` is everything else (raw detail stays in `error` for
- * diagnostics/hosts, the UI shows its generic fallback).
+ * copy); `technical` is every other recoverable failure (raw detail stays in
+ * `error` for diagnostics/hosts, the UI shows its generic fallback);
+ * `maxVideoLengthReached` is the configured recording limit; and
+ * `validationAttemptsExhausted` terminates the module after the last allowed
+ * ID or selfie validation failure.
  */
-type VideoSelfieErrorKind = 'connection' | 'technical';
+type VideoSelfieErrorKind = 'connection' | 'technical' | 'maxVideoLengthReached' | 'validationAttemptsExhausted';
 //#endregion
 //#region src/modules/video-selfie/videoSelfieRecordingActor.d.ts
 type CreateVideoSelfieRecordingActorOptions = {
-  /** Module config; its flags determine the active capture steps + validations. */
   config?: VideoSelfieConfig;
+  steps?: VideoSelfieStep[];
   dependencies?: VideoSelfieRecordingDependencies;
 };
 //#endregion
@@ -116,12 +147,19 @@ type VideoSelfieRecordingState = {
   attemptsRemaining: number;
   /** The completed upload id, available during `success` and `finished`. */
   recordingId: string | null;
-  /** Failure detail, set when `status === 'error'`. */
+  /**
+   * Failure detail for diagnostics, or the stable
+   * `maxVideoLengthReached` reason when the configured limit expires.
+   * Set when `status === 'error'`.
+   */
   error: string | undefined;
   /**
    * Why the module errored: `connection` (transport failure — the UI shows
    * the connection-error copy; raw detail stays in `error` for diagnostics)
-   * or `technical` (everything else). Set when `status === 'error'`.
+   * or `technical` (recoverable technical failures), or
+   * `maxVideoLengthReached` (the configured recording limit), or
+   * `validationAttemptsExhausted` (terminal ID/selfie validation failure).
+   * Set when `status === 'error'`.
    */
   errorKind: VideoSelfieErrorKind | undefined;
 };
@@ -172,27 +210,10 @@ declare function facingModeForStep(step: VideoSelfieStep): 'user' | 'environment
  * the first well-framed frame.
  */
 declare function resolveVideoSelfieSteps(config: VideoSelfieConfig): VideoSelfieStep[];
-/**
- * The WASM pipelines a Video Selfie session loads. The selfie step always runs
- * face detection (`videoSelfie`); the ID steps run the simplified ID-capture
- * pipeline (`videoSelfieId`), gated by `checkIdScan`. Used both for the
- * flow-level eager warmup ({@link getRequiredWasmPipelines}) and the
- * tutorial-time lazy warmup (`warmupVideoSelfieWasm`).
- */
-declare function videoSelfieWasmPipelines(config: VideoSelfieConfig): WasmPipeline[];
+declare function videoSelfieWasmPipelines(config: VideoSelfieConfig, steps?: VideoSelfieStep[]): WasmPipeline[];
 //#endregion
 //#region src/modules/video-selfie/videoSelfieWasm.d.ts
-/**
- * Warms the WASM pipelines the Video Selfie flow needs (face detection, plus the
- * ID-capture pipeline when `checkIdScan` is on), reusing the WASM config stored
- * by `setup({ wasm })`.
- *
- * Idempotent and safe to call eagerly — the UI invokes it when the tutorial
- * mounts so the models finish loading while the user reads the instructions, and
- * detection is ready the instant recording starts (mirrors how the selfie and ID
- * modules warm up during their tutorials). No-op when WASM was not configured.
- */
-declare function warmupVideoSelfieWasm(config: VideoSelfieConfig): Promise<void>;
+declare function warmupVideoSelfieWasm(config: VideoSelfieConfig, steps?: VideoSelfieStep[]): Promise<void>;
 //#endregion
 //#region src/modules/video-selfie/videoSelfieCameraWarmer.d.ts
 /**
@@ -230,7 +251,7 @@ type VideoSelfieCameraWarmer = {
  * camera (and whether it needs audio) is derived from the resolved step order —
  * the same first acquire the recording machine performs on `START`.
  */
-declare function createVideoSelfieCameraWarmer(config: VideoSelfieConfig): VideoSelfieCameraWarmer;
+declare function createVideoSelfieCameraWarmer(config: VideoSelfieConfig, steps?: VideoSelfieStep[]): VideoSelfieCameraWarmer;
 //#endregion
 //#region src/modules/video-selfie/videoSelfieSpeechService.d.ts
 /** A single random question (and its expected answer) for the challenge step. */
@@ -304,4 +325,7 @@ declare const videoSelfieFlowModuleMachine: StateMachine<MachineContext, AnyEven
   };
 }>;
 //#endregion
-export { type ConsentRecorder, type CreateVideoSelfieRecordingActorOptions, type VideoSelfieCameraWarmer, type VideoSelfieConfig, type VideoSelfieQuestion, type VideoSelfieRecordingManager, type VideoSelfieRecordingState, type VideoSelfieRecordingStatus, type VideoSelfieStep, createConsentRecorder, createVideoSelfieCameraWarmer, createVideoSelfieRecordingManager, facingModeForStep, getVideoSelfieQuestions, getVoiceConsentPhrase, resolveVideoSelfieSteps, videoSelfieFlowModuleMachine, videoSelfieWasmPipelines, warmupVideoSelfieWasm };
+//#region src/internal/orchestration/advanceableErrors.d.ts
+declare const VIDEO_SELFIE_VALIDATION_ATTEMPTS_EXHAUSTED_CODE = "VIDEO_SELFIE_VALIDATION_ATTEMPTS_EXHAUSTED";
+//#endregion
+export { type ConsentRecorder, type CreateVideoSelfieRecordingActorOptions, VIDEO_SELFIE_VALIDATION_ATTEMPTS_EXHAUSTED_CODE, type VideoSelfieCameraWarmer, type VideoSelfieConfig, type VideoSelfieQuestion, type VideoSelfieRecordingManager, type VideoSelfieRecordingState, type VideoSelfieRecordingStatus, type VideoSelfieStep, createConsentRecorder, createVideoSelfieCameraWarmer, createVideoSelfieRecordingManager, facingModeForStep, getVideoSelfieQuestions, getVoiceConsentPhrase, resolveVideoSelfieSteps, videoSelfieFlowModuleMachine, videoSelfieWasmPipelines, warmupVideoSelfieWasm };