@incodetech/core 0.0.0-dev-20260313-486e658 → 0.0.0-dev-20260313-bc2dab4

package/dist/selfieManager-Czysy-lv.d.ts

@@ -0,0 +1,68 @@
+import { i as SelfieActor, n as FaceCaptureManagerState, r as CreateSelfieActorOptions, t as FaceCaptureManager } from "./faceCaptureManagerFactory-CiQWYHp2.js";
+import { t as Manager } from "./Manager-CXnC-tN_.js";
+
+//#region src/modules/selfie/selfieUploadService.d.ts
+type ProcessFaceImageType = 'selfie' | 'videoSelfie';
+type ProcessFaceResponse = {
+  faceMatch: boolean;
+  confidence: number;
+  existingUser: boolean;
+};
+declare function processFace(imageType?: ProcessFaceImageType, signal?: AbortSignal): Promise<ProcessFaceResponse>;
+//#endregion
+//#region src/modules/selfie/selfieManager.d.ts
+type SelfieState = FaceCaptureManagerState;
+declare function createSelfieManagerFromActor(actor: SelfieActor): Manager<FaceCaptureManagerState> & {
+  load(): void;
+  nextStep(): void;
+  requestPermission(): void;
+  goToLearnMore(): void;
+  back(): void;
+  close(): void;
+  reset(): void;
+  retryCapture(): void;
+  capture(): void;
+};
+/**
+ * Creates a selfie manager instance for handling selfie capture flow.
+ *
+ * The selfie manager provides:
+ * - State management with statuses: `idle`, `loading`, `tutorial`, `permissions`, `capture`, `finished`, `closed`, `error`
+ * - Permission handling with nested states: `idle`, `requesting`, `denied`, `learnMore`
+ * - Capture handling with nested states: `initializing`, `startingRecorder`, `recordingActive`, `detecting`, `capturing`, `uploading`, `uploadError`, `success`
+ * - Camera stream access when in `capture` state
+ * - Detection status feedback during face detection
+ * - Attempt tracking with `attemptsRemaining`
+ *
+ * @param options - Configuration for the selfie actor
+ * @param options.config - The selfie module configuration from the flow
+ * @returns A manager instance with state subscription, API methods, and lifecycle controls
+ *
+ * @example
+ * ```ts
+ * const selfieManager = createSelfieManager({ config: selfieConfig });
+ *
+ * selfieManager.subscribe((state) => {
+ *   if (state.status === 'capture') {
+ *     console.log('Camera ready:', state.stream);
+ *     console.log('Detection status:', state.detectionStatus);
+ *   }
+ * });
+ *
+ * selfieManager.load();
+ * ```
+ */
+declare function createSelfieManager(options: CreateSelfieActorOptions): Manager<FaceCaptureManagerState> & {
+  load(): void;
+  nextStep(): void;
+  requestPermission(): void;
+  goToLearnMore(): void;
+  back(): void;
+  close(): void;
+  reset(): void;
+  retryCapture(): void;
+  capture(): void;
+};
+type SelfieManager = FaceCaptureManager;
+//#endregion
+export { ProcessFaceResponse as a, createSelfieManagerFromActor as i, SelfieState as n, processFace as o, createSelfieManager as r, SelfieManager as t };

package/dist/session.d.ts

@@ -1,2 +1,2 @@
-import { n as GetFinishStatusFn, r as getFinishStatus, t as FinishStatus } from "./flowCompletionService-DeWKduBI.js";
+import { n as GetFinishStatusFn, r as getFinishStatus, t as FinishStatus } from "./flowCompletionService-D4YDcHQR.js";
 export { type FinishStatus, type GetFinishStatusFn, getFinishStatus };

package/dist/session.esm.js

@@ -1,5 +1,5 @@
-import "./api-3fZO5bmj.esm.js";
-import "./endpoints-5sPFFmaB.esm.js";
-import { t as getFinishStatus } from "./flowCompletionService-DHXqHOAk.esm.js";
+import "./api-C2uzxrpN.esm.js";
+import "./endpoints-IAlXA1zN.esm.js";
+import { t as getFinishStatus } from "./flowCompletionService-CV8Ywiut.esm.js";
 
 export { getFinishStatus };

package/dist/{src-D3v6I2la.esm.js → src-BmVrWkLJ.esm.js}

@@ -1,4 +1,4 @@
-import { a as __toDynamicImportESM } from "./chunk-B1Ox1Owh.esm.js";
+import { a as __toDynamicImportESM } from "./chunk-C4_ANvih.esm.js";
 
 //#region ../infra/src/capabilities/platform.ts
 /**
@@ -4419,7 +4419,7 @@ var MotionSensorProvider = class {
 let openViduImport;
 async function loadOpenVidu() {
 	if (openViduImport) return openViduImport;
-	openViduImport = import("./lib-V3Lo-Jit.esm.js").then(__toDynamicImportESM(1));
+	openViduImport = import("./lib-COh1FH9n.esm.js").then(__toDynamicImportESM(1));
 	return openViduImport;
 }
 

package/dist/{stats-D76Thmqp.esm.js → stats-kLtQIgsA.esm.js}

@@ -1,4 +1,4 @@
-import { t as api } from "./api-3fZO5bmj.esm.js";
+import { t as api } from "./api-C2uzxrpN.esm.js";
 
 //#region src/modules/stats/statsServices.ts
 /**

package/dist/stats.esm.js

@@ -1,4 +1,4 @@
-import "./api-3fZO5bmj.esm.js";
-import { t as addDeviceStats } from "./stats-D76Thmqp.esm.js";
+import "./api-C2uzxrpN.esm.js";
+import { t as addDeviceStats } from "./stats-kLtQIgsA.esm.js";
 
 export { addDeviceStats };

package/dist/{streamingEvents-CQq5fJCL.esm.js → streamingEvents-Cw6kqXEh.esm.js}

@@ -1,6 +1,6 @@
-import { C as queryCameraPermission, M as getDeviceInfo, O as requestCameraAccess, P as getUserAgent, R as isIPad, f as MotionSensorProvider, k as stopCameraStream } from "./src-D3v6I2la.esm.js";
-import { t as api } from "./api-3fZO5bmj.esm.js";
-import { t as endpoints } from "./endpoints-5sPFFmaB.esm.js";
+import { C as queryCameraPermission, M as getDeviceInfo, O as requestCameraAccess, P as getUserAgent, R as isIPad, f as MotionSensorProvider, k as stopCameraStream } from "./src-BmVrWkLJ.esm.js";
+import { t as api } from "./api-C2uzxrpN.esm.js";
+import { t as endpoints } from "./endpoints-IAlXA1zN.esm.js";
 
 //#region src/internal/device/getBrowser.ts
 function getBrowser() {

package/dist/{types-DnrAr9fb.d.ts → types-BugcSDaO.d.ts}

@@ -1,4 +1,4 @@
-import { t as CameraStream } from "./camera-D7zu0Mls.js";
+import { t as CameraStream } from "./camera-DDn9ILon.js";
 
 //#region src/modules/document-upload/types.d.ts
 

package/dist/{types-Bn54lmeM.d.ts → types-C9Jo2XOb.d.ts}

@@ -1,4 +1,4 @@
-import { t as DocumentUploadConfig } from "./types-DnrAr9fb.js";
+import { t as DocumentUploadConfig } from "./types-BugcSDaO.js";
 
 //#region src/modules/flow/types.d.ts
 type EmptyConfig = Record<string, never>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/core",
-  "version": "0.0.0-dev-20260313-486e658",
+  "version": "0.0.0-dev-20260313-bc2dab4",
   "type": "module",
   "main": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
@@ -73,6 +73,10 @@
       "types": "./dist/session.d.ts",
       "import": "./dist/session.esm.js"
     },
+    "./extensibility": {
+      "types": "./dist/extensibility.d.ts",
+      "import": "./dist/extensibility.esm.js"
+    },
     "./redirect-to-mobile": {
       "types": "./dist/redirect-to-mobile.d.ts",
       "import": "./dist/redirect-to-mobile.esm.js"

package/dist/Actor-B6Lr-x6S.d.ts

@@ -1,2 +0,0 @@
-import { ActorRefFrom } from "xstate";
-export { ActorRefFrom as t };

package/dist/StateMachine-WHeQE3lC.d.ts

@@ -1,2 +0,0 @@
-import { AnyStateMachine, StateMachine } from "xstate";
-export { StateMachine as n, AnyStateMachine as t };

package/dist/faceCaptureManagerFactory-D1NUo68Z.d.ts

@@ -1,231 +0,0 @@
-import { i as IRecordingCapability, n as PermissionStatus, r as IStorageCapability, s as MLProviderConfig } from "./types-B4KNFqC4.js";
-import { n as WasmPipeline } from "./warmup-Da5qDIWZ.js";
-import { t as Manager } from "./Manager-CG5CQ1kY.js";
-import { t as CameraStream } from "./camera-D7zu0Mls.js";
-import { t as Flow } from "./types-Bn54lmeM.js";
-
-//#region ../infra/src/capabilities/IWasmUtilCapability.d.ts
-type WasmUtilConfig = MLProviderConfig & {
-  pipelines?: WasmPipeline[];
-};
-type VirtualCameraCheckOutput = {
-  canvas: HTMLCanvasElement | null;
-  itr: boolean | null;
-  skipped: boolean | null;
-};
-type IWasmUtilCapability = {
-  /**
-   * Whether the provider has been initialized and is ready to be used.
-   */
-  readonly initialized: boolean;
-  /**
-   * Initializes the provider with the given configuration.
-   * If WASM was already warmed up via `warmupWasm()`, this returns almost instantly.
-   * @param config - Provider configuration including WASM paths
-   */
-  initialize(config: WasmUtilConfig): Promise<void>;
-  /**
-   * Encrypts a base64 image using the WASM utility API.
-   * @param image - Base64 image string (no data URL prefix)
-   * @returns Encrypted string
-   */
-  encryptImage(image: string): string;
-  setSdkVersion(version: string): void;
-  setSdkPlatform(platform: string): void;
-  setDeviceInfo(deviceInfo: object, overrideExisting?: boolean): void;
-  setBrowserInfo(browserInfo: object, overrideExisting?: boolean): void;
-  setCameraInfo(cameraInfo: object, overrideExisting?: boolean): void;
-  setMotionStatus(status: string): void;
-  setBackgroundMode(backgroundMode: boolean): void;
-  setZc(zc: string): void;
-  setInspectorOpened(opened: boolean): void;
-  getMetadata(): string;
-  analyzeFrame(image: ImageData): Promise<void>;
-  getCheck(): string;
-  /**
-   * Gets the current pipeline state. Must be called before setMotionStatus(),
-   * getCheck(), setBackgroundMode(), and getMetadata() for proper metadata generation.
-   */
-  getPipelineState(): string;
-  estimatePerformance(): string;
-  isVirtualCamera(label: string | null): boolean;
-  prc(): Promise<void>;
-  poc(output: VirtualCameraCheckOutput): Promise<void>;
-  ckvcks(data: ArrayBuffer): void;
-  getVersions(): Promise<unknown>;
-  /**
-   * Disposes of resources and resets initialization state.
-   */
-  dispose(): Promise<void>;
-};
-//#endregion
-//#region src/internal/faceCapture/types.d.ts
-type BaseFaceCaptureConfig = {
-  showTutorial: boolean;
-  showPreview?: boolean;
-  assistedOnboarding?: boolean;
-  enableFaceRecording?: boolean;
-  autoCaptureTimeout: number;
-  captureAttempts?: number;
-  numberOfAttempts?: number;
-  validateLenses?: boolean;
-  validateFaceMask?: boolean;
-  validateHeadCover?: boolean;
-  validateClosedEyes?: boolean;
-  validateBrightness?: boolean;
-  deepsightLiveness?: 'SINGLE_FRAME' | 'MULTIMODAL' | 'VIDEOLIVENESS';
-  recording?: {
-    capability?: IRecordingCapability;
-  };
-  ds?: Flow['ds'];
-};
-type FaceCaptureDependencies = {
-  storage: IStorageCapability;
-  getWasmUtil: () => Promise<IWasmUtilCapability>;
-};
-type DetectionStatus = 'idle' | 'detecting' | 'noFace' | 'tooManyFaces' | 'tooClose' | 'tooFar' | 'blur' | 'dark' | 'faceAngle' | 'headWear' | 'lenses' | 'eyesClosed' | 'faceMask' | 'centerFace' | 'manualCapture' | 'success' | 'error' | 'capturing' | 'getReady' | 'getReadyFinished' | 'offline';
-declare const FACE_ERROR_CODES: {
-  readonly FACE_OCCLUDED: "FACE_OCCLUDED";
-  readonly LIVENESS: "LIVENESS_ERROR";
-  readonly BRIGHTNESS: "BRIGHTNESS_ERROR";
-  readonly LENSES: "LENSES_ERROR";
-  readonly MASK: "MASK_ERROR";
-  readonly CLOSED_EYES: "CLOSED_EYES_ERROR";
-  readonly HEAD_COVER: "HEAD_COVER_ERROR";
-  readonly SERVER: "SERVER_ERROR";
-  readonly FACE_NOT_FOUND: "FACE_NOT_FOUND";
-  readonly MULTIPLE_FACES: "MULTIPLE_FACES";
-  readonly TOO_BLURRY: "TOO_BLURRY_ERROR";
-  readonly TOO_DARK: "TOO_DARK_ERROR";
-  readonly USER_IS_NOT_RECOGNIZED: "USER_IS_NOT_RECOGNIZED";
-  readonly SPOOF_ATTEMPT_DETECTED: "SPOOF_ATTEMPT_DETECTED";
-  readonly FACE_TOO_DARK: "FACE_TOO_DARK";
-  readonly LENSES_DETECTED: "LENSES_DETECTED";
-  readonly FACE_MASK_DETECTED: "FACE_MASK_DETECTED";
-  readonly CLOSED_EYES_DETECTED: "CLOSED_EYES_DETECTED";
-  readonly HEAD_COVER_DETECTED: "HEAD_COVER_DETECTED";
-  readonly FACE_CROPPING_FAILED: "FACE_CROPPING_FAILED";
-  readonly FACE_TOO_SMALL: "FACE_TOO_SMALL";
-  readonly FACE_TOO_BLURRY: "FACE_TOO_BLURRY";
-  readonly BAD_PHOTO_QUALITY: "BAD_PHOTO_QUALITY";
-  readonly PROCESSING_ERROR: "PROCESSING_ERROR";
-  readonly BAD_REQUEST: "BAD_REQUEST";
-  readonly NONEXISTENT_CUSTOMER: "NONEXISTENT_CUSTOMER";
-  readonly HINT_NOT_PROVIDED: "HINT_NOT_PROVIDED";
-  readonly SELFIE_IMAGE_LOW_QUALITY: "SELFIE_IMAGE_LOW_QUALITY";
-};
-type FaceErrorCode = (typeof FACE_ERROR_CODES)[keyof typeof FACE_ERROR_CODES];
-//#endregion
-//#region src/internal/faceCapture/faceCaptureManagerFactory.d.ts
-type CaptureStatus = 'initializing' | 'detecting' | 'capturing' | 'uploading' | 'uploadError' | 'success';
-/** Face capture manager is waiting to be started */
-type FaceCaptureIdleState = {
-  status: 'idle';
-};
-/** Checking camera permissions (when no tutorial) */
-type FaceCaptureLoadingState = {
-  status: 'loading';
-};
-/** Showing face capture tutorial */
-type FaceCaptureTutorialState = {
-  status: 'tutorial';
-};
-/** Handling camera permissions */
-type FaceCapturePermissionsState = {
-  status: 'permissions';
-  /** Current permission sub-state: initial, requesting, denied, or learnMore */
-  permissionStatus: PermissionStatus;
-};
-/** Camera is ready for face capture */
-type FaceCaptureCaptureState = {
-  status: 'capture';
-  /** Current capture sub-state */
-  captureStatus: CaptureStatus;
-  /** The active camera stream */
-  stream: CameraStream | undefined;
-  /** Current face detection status */
-  detectionStatus: DetectionStatus;
-  /** Latest frame processed in the detection loop (for UI debug rendering) */
-  debugFrame: ImageData | undefined;
-  /** Number of capture attempts remaining */
-  attemptsRemaining: number;
-  /** Error message from failed upload */
-  uploadError: string | undefined;
-  /** Whether assisted onboarding mode is active (back camera, no mirror) */
-  assistedOnboarding: boolean;
-};
-/** Processing the captured face */
-type FaceCaptureProcessingState = {
-  status: 'processing';
-};
-/** Face capture completed successfully */
-type FaceCaptureFinishedState = {
-  status: 'finished';
-  /** Face processing result (face match, confidence, existing user) */
-  processResponse: Record<string, unknown> | undefined;
-};
-/** User closed the face capture flow */
-type FaceCaptureClosedState = {
-  status: 'closed';
-};
-/** An error occurred during the flow */
-type FaceCaptureErrorState = {
-  status: 'error';
-  /** The error message */
-  error: string;
-};
-/** Union of all possible face capture states */
-type FaceCaptureManagerState = FaceCaptureIdleState | FaceCaptureLoadingState | FaceCaptureTutorialState | FaceCapturePermissionsState | FaceCaptureCaptureState | FaceCaptureProcessingState | FaceCaptureFinishedState | FaceCaptureClosedState | FaceCaptureErrorState;
-declare function createFaceCaptureManager(actor: unknown): Manager<FaceCaptureManagerState> & {
-  /**
-   * Starts the face capture flow.
-   * Goes to `tutorial` if showTutorial is true, otherwise to `loading`.
-   * Requires setup() to have been called with a token first.
-   */
-  load(): void;
-  /**
-   * Advances to the next step.
-   * From `tutorial` → permissions or capture (based on permission status).
-   * From `capture` → finished.
-   */
-  nextStep(): void;
-  /**
-   * Requests camera permission via getUserMedia.
-   * Only effective when in `permissions.idle` or `permissions.learnMore` state.
-   */
-  requestPermission(): void;
-  /**
-   * Navigates to the "learn more" permission screen.
-   * Only effective when in `permissions.idle` state.
-   */
-  goToLearnMore(): void;
-  /**
-   * Goes back from "learn more" to the initial permission screen.
-   * Only effective when in `permissions.learnMore` state.
-   */
-  back(): void;
-  /**
-   * Closes the face capture flow and transitions to `closed` state.
-   * Can be called from any state.
-   */
-  close(): void;
-  /**
-   * Resets the face capture manager to its initial `idle` state.
-   * Can be called from `error` state. Not available from `finished` (final state).
-   */
-  reset(): void;
-  /**
-   * Retries the capture after an upload error.
-   * Only effective when in `capture.uploadError` state and `attemptsRemaining > 0`.
-   * If no attempts remaining, the transition is blocked.
-   */
-  retryCapture(): void;
-  /**
-   * Captures a face in manual capture mode.
-   * Only effective when in `capture.detecting` state and `detectionStatus === 'manualCapture'`.
-   */
-  capture(): void;
-};
-type FaceCaptureManager = ReturnType<typeof createFaceCaptureManager>;
-//#endregion
-export { FaceCaptureDependencies as a, DetectionStatus as i, FaceCaptureManagerState as n, FaceErrorCode as o, BaseFaceCaptureConfig as r, FaceCaptureManager as t };

package/dist/types-B4KNFqC4.d.ts

@@ -1,130 +0,0 @@
-//#region ../infra/src/capabilities/IMLProviderCapability.d.ts
-/**
- * Base configuration shared by all ML provider capabilities.
- */
-interface MLProviderConfig {
-  /** Path to the WASM binary */
-  wasmPath?: string;
-  /** Path to the SIMD-optimized WASM binary (optional) */
-  wasmSimdPath?: string;
-  /** Path to the WASM glue code */
-  glueCodePath?: string;
-  /** Whether to use SIMD optimizations (default: true) */
-  useSimd?: boolean;
-  /**
-   * Base path for ML model files. Models will be loaded from `${modelsBasePath}/${modelFileName}`.
-   * If not provided, models are expected in a 'models' subdirectory relative to the WASM binary.
-   */
-  modelsBasePath?: string;
-}
-/**
- * Base interface for ML provider capabilities.
- * Provides common lifecycle and frame processing methods shared by
- * FaceDetectionCapability and IdCaptureCapability.
- */
-interface IMLProviderCapability<TConfig extends MLProviderConfig> {
-  /**
-   * Whether the provider has been initialized and is ready to process frames.
-   */
-  readonly initialized: boolean;
-  /**
-   * Initializes the provider with the given configuration.
-   * If WASM was already warmed up via `setup()` or `warmupWasm()`, this returns almost instantly.
-   * @param config - Provider configuration including WASM paths
-   */
-  initialize(config: TConfig): Promise<void>;
-  /**
-   * Processes a frame through the ML pipeline.
-   * Callbacks set via `setCallbacks()` will be invoked based on the analysis results.
-   * @param image - Image data to process
-   * @throws Error if provider is not initialized
-   */
-  processFrame(image: ImageData): Promise<void>;
-  /**
-   * Resets the pipeline to its initial state.
-   * Safe to call even if not initialized (no-op in that case).
-   */
-  reset(): void;
-  /**
-   * Disposes of resources and resets initialization state.
-   * Safe to call even if not initialized.
-   */
-  dispose(): Promise<void>;
-}
-//#endregion
-//#region ../infra/src/capabilities/IRecordingCapability.d.ts
-type RecordingPublisher = {
-  getStreamId: () => string | undefined;
-  replaceVideoTrack: (track: MediaStreamTrack) => Promise<void>;
-  destroy: () => void;
-};
-type RecordingConnection = {
-  sessionId: string | undefined;
-  publisher: RecordingPublisher;
-  disconnect: () => Promise<void>;
-};
-type RecordingConnectionEvents = {
-  onSessionConnected?: (sessionId: string | undefined) => void;
-  onSessionDisconnected?: (sessionId: string | undefined) => void;
-  onSessionException?: (params: {
-    name?: string;
-    message?: string;
-    sessionId?: string;
-  }) => void;
-  onPublisherCreated?: (params: {
-    streamId?: string;
-    sessionId?: string;
-  }) => void;
-  onPublisherError?: (params: {
-    message?: string;
-    sessionId?: string;
-    streamId?: string;
-  }) => void;
-};
-type ConnectRecordingParams = {
-  sessionToken: string;
-  stream: MediaStream;
-  events?: RecordingConnectionEvents;
-};
-type IRecordingCapability = {
-  /**
-   * Connects to a recording session and publishes the provided media stream.
-   * Returns a connection handle that can be disconnected and used to manage the publisher.
-   */
-  connect: (params: ConnectRecordingParams) => Promise<RecordingConnection>;
-};
-//#endregion
-//#region ../infra/src/capabilities/IStorageCapability.d.ts
-/**
- * Storage capability interface for abstracting storage operations.
- * Enables swapping between browser localStorage and future WASM-based storage.
- */
-interface IStorageCapability {
-  /**
-   * Retrieves a value from storage.
-   * @param key - The storage key
-   * @returns The stored value or null if not found
-   */
-  get<T>(key: string): Promise<T | null>;
-  /**
-   * Stores a value in storage.
-   * @param key - The storage key
-   * @param value - The value to store (will be serialized)
-   */
-  set<T>(key: string, value: T): Promise<void>;
-  /**
-   * Removes a value from storage.
-   * @param key - The storage key to remove
-   */
-  remove(key: string): Promise<void>;
-  /**
-   * Clears all values from storage.
-   */
-  clear(): Promise<void>;
-}
-//#endregion
-//#region src/internal/permissions/types.d.ts
-type PermissionResult = 'granted' | 'denied' | 'prompt';
-type PermissionStatus = 'idle' | 'requesting' | 'denied' | 'learnMore';
-//#endregion
-export { RecordingConnection as a, IRecordingCapability as i, PermissionStatus as n, IMLProviderCapability as o, IStorageCapability as r, MLProviderConfig as s, PermissionResult as t };