@incodetech/core 0.0.0-dev-20260911-aec162f0 → 0.0.0-dev-20260914-8aef7789

package/dist/{idCaptureManager-DW1GeEUk.d.ts → idCaptureManager-DE_jyr5X.d.ts}

@@ -4,44 +4,61 @@ import { t as Manager } from "./Manager-CQQ99QOI.js";
 import "./Actor-iTq7YY48.js";
 import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-D4tvIB5v.js";
 import "./index-B8weJxmL.js";
-import { a as RegulationTypes } from "./types-DzmqFoCH.js";
+import "./createFaceAvatar-CTM9aj9Q.js";
+import { a as RegulationTypes } from "./types-CBctcPeF.js";
+import { n as VirtualCameraCheckOutput, r as WasmUtilConfig, t as IWasmUtilCapability } from "./IWasmUtilCapability-DaP6pfHq.js";
 import { n as PermissionStatus } from "./types-BEwVKkLJ.js";
+import { t as BaseWasmProvider } from "./BaseWasmProvider-CO0GfaHM.js";
+import "./types-Ds928RiU.js";
+import { n as DeepsightService } from "./StreamCanvasCapture-D9Dz8kqB.js";
 import { t as CameraStream } from "./camera-9wWD-pwg.js";
-import { t as DeepsightService } from "./deepsightService-MZOpj7Vp.js";
-import { i as Pdf417DecodeResult, n as IIdCaptureCapability, t as DetectionOrientation } from "./IIdCaptureCapability-DDWlQzhi.js";
-import { B as DeviceWalletPlatform, C as IdDocumentType, D as RecordingSession, F as ManualUploadTab, O as UploadIdResponse, P as ManualUploadSide, R as DeviceWalletFailReason, T as IdErrorCode, X as DigitalIdProviderId, Z as FailureReason, _ as IdCaptureInput, b as IdCaptureOutput, c as DetectionStatus, d as IdCaptureContext, f as IdCaptureDependencies, h as IdCaptureEvent, i as CaptureIdResponse, k as IAnalyticsCapability, r as AddBarcodeV3Response, s as DetectionArea, t as AcceptedDocument, u as IdCaptureConfig, v as IdCaptureMode, y as IdCaptureOnlyConfig } from "./types-BBI4-s9u2.js";
-//#region src/modules/id/idCaptureStateMachine.d.ts
-declare const idCaptureMachine: AnyStateMachine;
-type IdCaptureMachine = StateMachine<IdCaptureContext, IdCaptureEvent, any, any, any, any, any, any, any, IdCaptureInput, any, any, any, any>;
-//#endregion
-//#region src/modules/id/idCaptureActor.d.ts
-type CreateIdCaptureActorOptions = {
-  config: IdCaptureConfig;
-  dependencies?: IdCaptureDependencies;
-};
-type IdCaptureActor = ActorRefFrom<IdCaptureMachine>;
-declare function createIdCaptureActor(options: CreateIdCaptureActorOptions): IdCaptureActor;
-//#endregion
-//#region src/modules/id/idCaptureOnlyStateMachine.d.ts
-type IdCaptureOnlyContext = IdCaptureContext;
-type IdCaptureOnlyEvent = IdCaptureEvent;
-type IdCaptureOnlyInput = IdCaptureInput;
-/**
- * ID capture state machine variant for the captureOnly flow. Shares the full
- * base ID-capture state tree (chooser, tutorial, permissions, capture,
- * front/back finished, processing, finished); only the upload, process, and
- * recording steps are local instead of remote.
- */
-declare const idCaptureOnlyMachine: AnyStateMachine;
-type IdCaptureOnlyMachine = StateMachine<IdCaptureOnlyContext, IdCaptureOnlyEvent, any, any, any, any, any, any, any, IdCaptureOnlyInput, any, any, any, any>;
-//#endregion
-//#region src/modules/id/idCaptureOnlyActor.d.ts
-type CreateIdCaptureOnlyActorOptions = {
-  config: IdCaptureOnlyConfig;
-  dependencies?: IdCaptureDependencies;
-};
-type IdCaptureOnlyActor = ActorRefFrom<IdCaptureOnlyMachine>;
-declare function createIdCaptureOnlyActor(options: CreateIdCaptureOnlyActorOptions): IdCaptureOnlyActor;
+import { i as Pdf417DecodeResult, n as IIdCaptureCapability, t as DetectionOrientation } from "./IIdCaptureCapability-nfpic2z2.js";
+import { B as DeviceWalletPlatform, C as IdDocumentType, D as RecordingSession, F as ManualUploadTab, O as UploadIdResponse, P as ManualUploadSide, R as DeviceWalletFailReason, T as IdErrorCode, X as DigitalIdProviderId, Z as FailureReason, _ as IdCaptureInput, b as IdCaptureOutput, c as DetectionStatus, d as IdCaptureContext, f as IdCaptureDependencies, h as IdCaptureEvent, i as CaptureIdResponse, k as IAnalyticsCapability, r as AddBarcodeV3Response, s as DetectionArea, t as AcceptedDocument, u as IdCaptureConfig, v as IdCaptureMode, y as IdCaptureOnlyConfig } from "./types-CoOlCUp82.js";
+//#region ../infra/src/providers/wasm/WasmUtilProvider.d.ts
+declare class WasmUtilProvider extends BaseWasmProvider implements IWasmUtilCapability {
+  private static instance;
+  private static initPromise;
+  static getInstance(): Promise<WasmUtilProvider>;
+  static resetInstance(): void;
+  constructor();
+  initialize(config: WasmUtilConfig): Promise<void>;
+  processFrame(_image: ImageData): Promise<void>;
+  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;
+  setOnDeviceMode(enabled: boolean): void;
+  setZc(zc: string): void;
+  setInspectorOpened(opened: boolean): void;
+  getInspectorOpened(): boolean;
+  /**
+   * Toggles the WASM module's production mode. When `true`, the native module
+   * suppresses its verbose debug logging/console output; when `false`, those
+   * logs are emitted. The SDK forces this to `true` by default and only flips
+   * it off when the caller opts in via `setup({ wasm: { showLogs: true } })`.
+   *
+   * @param productionMode - `true` to silence WASM logs, `false` to emit them.
+   */
+  setProductionMode(productionMode: boolean): Promise<void>;
+  getMetadata(): string;
+  analyzeFrame(image: ImageData): Promise<void>;
+  getCheck(): string;
+  getPipelineState(): string;
+  estimatePerformance(): string;
+  isVirtualCamera(label: string | null): boolean;
+  prc(): Promise<void>;
+  poc(output: VirtualCameraCheckOutput): Promise<void>;
+  rsp(): Promise<void>;
+  ssl(): void;
+  stl(): void;
+  osv(): void;
+  oev(): void;
+  ckvcks(data: ArrayBuffer): void;
+}
 //#endregion
 //#region src/modules/id/idCaptureServices.d.ts
 type IdCaptureInitResult = {
@@ -98,6 +115,7 @@ declare function validateUploadResponse(response: UploadIdResponse & {
   skipGlareFront?: boolean;
   skipGlareBack?: boolean;
 }): ValidationError | undefined;
+declare const getRealQualityValue: (value: number) => number;
 declare function uploadIdImage(params: UploadIdImageParams): Promise<CaptureIdResponse>;
 type StartRecordingParams = {
   config: IdCaptureConfig;
@@ -109,6 +127,16 @@ declare function preloadIdRecordingProvider(config: IdCaptureConfig): void;
 declare function startRecordingSession(params: StartRecordingParams): Promise<RecordingSession | undefined>;
 declare function pauseRecordingForAttempt(session: RecordingSession): void;
 declare function prepareRecordingForCameraRetry(session: RecordingSession): void;
+type FinalizedIdRecording = Readonly<{
+  recordingId?: string | null;
+}>;
+/**
+ * Fully drains an ID recording before the protected camera cycle runs POC.
+ * Every recorder clone is stopped before this promise settles.
+ */
+declare function finalizeRecordingSession(session: RecordingSession): Promise<FinalizedIdRecording>;
+/** Synchronous teardown used when an attempt is cancelled before finalization. */
+declare function disposeRecordingSession(session: RecordingSession): void;
 declare function stopRecording(session: RecordingSession): void;
 declare function processId(isSecondId?: boolean, queueName?: string, signal?: AbortSignal): Promise<{
   isDocumentExpired: boolean;
@@ -171,6 +199,39 @@ type AddBarcodeParams = {
  */
 declare function addBarcode(params: AddBarcodeParams): Promise<AddBarcodeV3Response>;
 //#endregion
+//#region src/modules/id/idCaptureStateMachine.d.ts
+declare const idCaptureMachine: AnyStateMachine;
+type IdCaptureMachine = StateMachine<IdCaptureContext, IdCaptureEvent, any, any, any, any, any, any, any, IdCaptureInput, any, any, any, any>;
+//#endregion
+//#region src/modules/id/idCaptureActor.d.ts
+type CreateIdCaptureActorOptions = {
+  config: IdCaptureConfig;
+  dependencies?: IdCaptureDependencies;
+};
+type IdCaptureActor = ActorRefFrom<IdCaptureMachine>;
+declare function createIdCaptureActor(options: CreateIdCaptureActorOptions): IdCaptureActor;
+//#endregion
+//#region src/modules/id/idCaptureOnlyStateMachine.d.ts
+type IdCaptureOnlyContext = IdCaptureContext;
+type IdCaptureOnlyEvent = IdCaptureEvent;
+type IdCaptureOnlyInput = IdCaptureInput;
+/**
+ * ID capture state machine variant for the captureOnly flow. Shares the full
+ * base ID-capture state tree (chooser, tutorial, permissions, capture,
+ * front/back finished, processing, finished); only the upload, process, and
+ * recording steps are local instead of remote.
+ */
+declare const idCaptureOnlyMachine: AnyStateMachine;
+type IdCaptureOnlyMachine = StateMachine<IdCaptureOnlyContext, IdCaptureOnlyEvent, any, any, any, any, any, any, any, IdCaptureOnlyInput, any, any, any, any>;
+//#endregion
+//#region src/modules/id/idCaptureOnlyActor.d.ts
+type CreateIdCaptureOnlyActorOptions = {
+  config: IdCaptureOnlyConfig;
+  dependencies?: IdCaptureDependencies;
+};
+type IdCaptureOnlyActor = ActorRefFrom<IdCaptureOnlyMachine>;
+declare function createIdCaptureOnlyActor(options: CreateIdCaptureOnlyActorOptions): IdCaptureOnlyActor;
+//#endregion
 //#region src/modules/id/digitalUpload/types.d.ts
 type DigitalUploadFailReason = 'DIGITAL_ID_REQUESTED_BUT_OTHER_PROVIDED' | 'ID_TYPE_UNACCEPTABLE' | 'FILE_CHANGED_ERROR' | 'INVALID_FILE_TYPE' | 'NETWORK_ERROR' | 'GENERIC';
 //#endregion
@@ -563,4 +624,4 @@ declare function createIdCaptureManager(options: CreateIdCaptureActorOptions): M
   deviceWalletUseAnotherMethod(): void;
 };
 //#endregion
-export { CreateIdCaptureActorOptions as A, uploadManualIdFile as C, createIdCaptureOnlyActor as D, IdCaptureOnlyActor as E, createIdCaptureActor as M, IdCaptureMachine as N, IdCaptureOnlyMachine as O, idCaptureMachine as P, uploadIdImage as S, CreateIdCaptureOnlyActorOptions as T, prepareRecordingForCameraRetry as _, AddBarcodeParams as a, stopRecording as b, StartRecordingParams as c, ValidationError as d, addBarcode as f, preloadIdRecordingProvider as g, pauseRecordingForAttempt as h, createIdCaptureManagerFromActor as i, IdCaptureActor as j, idCaptureOnlyMachine as k, UploadIdImageParams as l, initializeIdCapture as m, IdCaptureManager as n, IdCaptureInitResult as o, barcodeToBase64 as p, IdCaptureState as r, InitializeIdCaptureParams as s, createIdCaptureManager as t, UploadManualIdFileParams as u, processId as v, validateUploadResponse as w, stopStream as x, startRecordingSession as y };
+export { preloadIdRecordingProvider as A, addBarcode as C, getRealQualityValue as D, finalizeRecordingSession as E, stopStream as F, uploadIdImage as I, uploadManualIdFile as L, processId as M, startRecordingSession as N, initializeIdCapture as O, stopRecording as P, validateUploadResponse as R, ValidationError as S, disposeRecordingSession as T, IdCaptureInitResult as _, CreateIdCaptureOnlyActorOptions as a, UploadIdImageParams as b, IdCaptureOnlyMachine as c, IdCaptureActor as d, createIdCaptureActor as f, FinalizedIdRecording as g, AddBarcodeParams as h, createIdCaptureManagerFromActor as i, prepareRecordingForCameraRetry as j, pauseRecordingForAttempt as k, idCaptureOnlyMachine as l, idCaptureMachine as m, IdCaptureManager as n, IdCaptureOnlyActor as o, IdCaptureMachine as p, IdCaptureState as r, createIdCaptureOnlyActor as s, createIdCaptureManager as t, CreateIdCaptureActorOptions as u, InitializeIdCaptureParams as v, barcodeToBase64 as w, UploadManualIdFileParams as x, StartRecordingParams as y, WasmUtilProvider as z };

package/dist/{idCaptureManager-BUTdcmaD.esm.js → idCaptureManager-zjul9YdZ.esm.js}

@@ -1,12 +1,12 @@
-import { l as BrowserStorageProvider } from "./setup-BHJ3-fhX.esm.js";
+import { l as BrowserStorageProvider } from "./setup-CfNAVG-d.esm.js";
 import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ijlbX_Wx.esm.js";
 import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
 import { s as createActor, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
-import { t as setWasmDsFlagSync } from "./wasmDsFlagSync-C3k_VK9o.esm.js";
+import { t as setWasmDsFlagSync } from "./wasmDsFlagSync-BJtLh2XK.esm.js";
 import { t as BrowserVisibilityObserverProvider } from "./BrowserVisibilityObserverProvider-BrJN1B8A.esm.js";
-import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-f7nBnW5P.esm.js";
-import { n as getManualUploadTabs, t as idCaptureMachine } from "./idCaptureStateMachine-Cp2_revF.esm.js";
-import { g as resolveIdCaptureThresholds, h as resolveCaptureOptimizingTreatment } from "./idCaptureServices-fzIhBqAK.esm.js";
+import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-7lzEiOsO.esm.js";
+import { a as createIdProtectedCaptureController, n as provideIdProtectedCaptureController, o as findIdProtectedCaptureController, s as getManualUploadTabs, t as idCaptureMachine } from "./idCaptureStateMachine-D3pqfK2Z.esm.js";
+import { v as resolveCaptureOptimizingTreatment, y as resolveIdCaptureThresholds } from "./idCaptureServices-UXYCBZPK.esm.js";
 //#region src/modules/id/digitalUpload/instrumentation.ts
 const TERMINAL_REASONS = /* @__PURE__ */ new Set(["DIGITAL_ID_REQUESTED_BUT_OTHER_PROVIDED", "ID_TYPE_UNACCEPTABLE"]);
 function isHoldingState(value) {
@@ -276,13 +276,13 @@ function getEffectiveSelectedDocumentType(context) {
 	if (isIdAvailable) return "id";
 	if (isPassportAvailable) return "passport";
 }
-function mapCaptureState(snapshot, context) {
+function mapCaptureState(snapshot, context, presentationStream) {
 	const captureStatus = getCaptureStatus(snapshot) ?? "initializing";
 	const { uploadError, uploadResponse } = context;
 	return {
 		status: "capture",
 		captureStatus,
-		stream: context.stream,
+		stream: presentationStream,
 		usingBackCamera: context.usingBackCamera ?? true,
 		detectionStatus: context.detectionStatus,
 		attemptsRemaining: context.attemptsRemaining,
@@ -459,7 +459,7 @@ function mapDeviceWalletState(snapshot) {
 		platform: childCtx?.platform
 	};
 }
-function mapState(snapshot) {
+function mapState(snapshot, presentationStream) {
 	const { context } = snapshot;
 	if (snapshot.matches("idle")) return { status: "idle" };
 	const loadingPhase = getLoadingPhase(snapshot);
@@ -473,7 +473,7 @@ function mapState(snapshot) {
 	if (snapshot.matches("ageVerification")) return { status: "ageVerification" };
 	if (snapshot.matches("closed")) return { status: "closed" };
 	if (snapshot.matches("permissions")) return mapPermissionsState(snapshot, context);
-	if (snapshot.matches("capture")) return mapCaptureState(snapshot, context);
+	if (snapshot.matches("capture")) return mapCaptureState(snapshot, context, presentationStream);
 	if (snapshot.matches("mandatoryConsent")) return {
 		status: "mandatoryConsent",
 		regulationType: context.uploadResponse?.regulationType ?? "Other"
@@ -521,7 +521,7 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 	return {
 		load() {
 			const { config } = actor.getSnapshot().context;
-			if (config.ds === true) setWasmDsFlagSync(true);
+			setWasmDsFlagSync(config.ds === true);
 			resetWasmMotionPrimedForModule();
 			actor.send({ type: "LOAD" });
 		},
@@ -955,15 +955,24 @@ function getIdCaptureErrorPayload(snapshot) {
 * `docs/patterns/CAPABILITY.md`). Pass a fake/no-op to override (tests do).
 */
 function createIdCaptureManagerFromActor(actor, visibilityObserver = new BrowserVisibilityObserverProvider()) {
+	const protectedCaptureController = findIdProtectedCaptureController(actor);
+	protectedCaptureController?.setVisible(visibilityObserver.isVisible());
 	return createManager({
 		actor,
-		mapState,
+		mapState: (snapshot) => mapState(snapshot, protectedCaptureController?.getProjection().stream),
 		createApi,
 		instrumentation: createManagerInstrumentation(eventModuleNames.idCapture, {
 			getEventScreenName: mapIdCaptureScreenName,
 			getErrorName: getIdCaptureErrorName,
 			getErrorPayload: getIdCaptureErrorPayload,
-			visibilityObserver
+			visibilityObserver: {
+				isVisible: () => visibilityObserver.isVisible(),
+				onVisibilityChange: (listener) => visibilityObserver.onVisibilityChange((visible) => {
+					protectedCaptureController?.setVisible(visible);
+					actor.send({ type: visible ? "FOREGROUND" : "BACKGROUND" });
+					listener(visible);
+				})
+			}
 		})
 	});
 }
@@ -990,11 +999,12 @@ function createIdCaptureActor(options) {
 		credentials: options.dependencies?.credentials ?? new BrowserDigitalCredentialsProvider()
 	};
 	const treatment = resolveCaptureOptimizingTreatment(options.config);
-	return createActor(idCaptureMachine, { input: {
-		config: {
-			...options.config,
-			thresholds: resolveIdCaptureThresholds(options.config, treatment?.framesAggregationInterval)
-		},
+	const config = {
+		...options.config,
+		thresholds: resolveIdCaptureThresholds(options.config, treatment?.framesAggregationInterval)
+	};
+	return createActor(provideIdProtectedCaptureController(idCaptureMachine, createIdProtectedCaptureController()), { input: {
+		config,
 		dependencies,
 		captureFeedbackMode: treatment?.mode ?? "countdown",
 		captureWindowMs: treatment?.captureWindowMs,

package/dist/{idCaptureServices-fzIhBqAK.esm.js → idCaptureServices-UXYCBZPK.esm.js}

@@ -1,16 +1,16 @@
-import { t as ensureWasmPipelines } from "./setup-BHJ3-fhX.esm.js";
-import { i as numberParam, n as defineExperimentParams, t as booleanParam, u as resolveExperimentOnce } from "./feature-management-B6CtmH1O.esm.js";
+import { t as ensureWasmPipelines } from "./setup-CfNAVG-d.esm.js";
+import { i as numberParam, n as defineExperimentParams, t as booleanParam, u as resolveExperimentOnce } from "./feature-management-BEqf3Sr3.esm.js";
 import { t as api } from "./api-Bx3gKW_y.esm.js";
 import { t as endpoints } from "./endpoints-D3B9mUHh.esm.js";
 import { i as isDesktop } from "./platform-DkcRc9JV.esm.js";
 import { i as assign, t as setup } from "./xstate.esm-BuFLFuzz.esm.js";
 import { n as fromPromise } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
-import { s as queryCameraPermission } from "./permissionServices-f7nBnW5P.esm.js";
+import { s as queryCameraPermission } from "./permissionServices-7lzEiOsO.esm.js";
 import { n as startRecording, r as stopRecording$1, t as createRecordingSession } from "./recordingsRepository-CCWy13M-.esm.js";
-import { a as isBackFacingTrack, n as getBackCameraStream } from "./backCameraStream-DE_5qY04.esm.js";
+import { a as isBackFacingTrack, n as getBackCameraStream } from "./backCameraStream-BOtyQowf.esm.js";
 import { t as getDeviceClass } from "./getDeviceClass-5NYZg9s6.esm.js";
 import { t as MultipartRecordingService } from "./multipartRecordingService-B3C_zlev.esm.js";
-import { i as CameraCompositor, n as DEFAULT_ID_CAPTURE_THRESHOLDS, r as IdCaptureProvider } from "./idCaptureDefaults-BLsd7shz.esm.js";
+import { i as CameraCompositor, n as DEFAULT_ID_CAPTURE_THRESHOLDS, r as IdCaptureProvider } from "./idCaptureDefaults-C66YvkgN.esm.js";
 //#region src/internal/camera/cameraServices.ts
 function createCameraServices(camera) {
 	return {
@@ -214,9 +214,9 @@ async function getIdCameraStream(deviceId) {
 * payload whose halves exceed it is halved to fit rather than rejected, and a
 * session whose budget cannot fit a meaningful split runs the countdown arm.
 * Note this means the console payload decides total capture duration — a
-* treatment payload that leaves `framesAggregationIntervalMs` at its 3000
-* default produces a 4500ms window against the 5s default budget, i.e. longer
-* than the countdown arm's 3000ms. Set both halves explicitly.
+* treatment payload that leaves `framesAggregationIntervalMs` at its 1700
+* default produces a 3200ms window against the 5s default budget, i.e. longer
+* than the countdown arm's 1700ms. Set both halves explicitly.
 */
 const MAX_OPTIMIZING_DWELL_MS = 2500;
 const DEFAULT_OPTIMIZING_DWELL_MS = 1500;
@@ -247,7 +247,8 @@ const OPTIMIZING_WATCHDOG_MARGIN_MS = 1e3;
 * the countdown arm, only the pre-boundary half in the treatment arm. Bounding it
 * for one would break the other, so the arm-aware handling lives in
 * `resolveCaptureOptimizingTreatment`. Its code default stays at the
-* canonical 3000 so an unallocated session keeps shipped control behavior.
+* canonical SDK 1-compatible 1700 so an unallocated session keeps production
+* parity.
 */
 const CAPTURE_OPTIMIZING = {
 	storeParam: "idcExp05ShowResult",
@@ -342,8 +343,8 @@ function resolveCaptureOptimizingTreatment(config) {
 /**
 * Single source of truth for the WASM ID-capture thresholds passed to
 * `IIdCaptureCapability.setThresholds`. Resolves `framesAggregationInterval`
-* — the countdown / best-frame aggregation window (canonical default
-* 3000ms) — with precedence:
+* — the countdown / best-frame aggregation window (SDK 1-compatible canonical
+* default 1700ms) — with precedence:
 *
 * 1. An explicit `config.thresholds.framesAggregationInterval` (host/headless
 *    override) always wins. Such a session never runs the IDC-05 treatment
@@ -476,6 +477,12 @@ function validateUploadResponse(response, sessionState) {
 		messageDescription: response.side === "back" ? "Please show the back side of your ID" : "Please show the front side of your ID",
 		errorKey: ID_ERROR_CODES.WRONG_DOCUMENT_SIDE
 	};
+	if (response.failReason === "DOCUMENT_NOT_READABLE") return {
+		error: true,
+		message: "Info is not readable",
+		messageDescription: "Minimize camera shake by holding your phone steady",
+		errorKey: ID_ERROR_CODES.READABILITY_ISSUE
+	};
 	if (!response.classification) return {
 		error: true,
 		message: "ID classification failed",
@@ -585,6 +592,10 @@ function buildResolutionFromStream(stream) {
 }
 function preloadIdRecordingProvider(config) {}
 const multipartIdSessions = /* @__PURE__ */ new WeakMap();
+const legacyIdRecordingStreams = /* @__PURE__ */ new WeakMap();
+const idRecordingFinalizations = /* @__PURE__ */ new WeakMap();
+const releasedLegacyIdRecordings = /* @__PURE__ */ new WeakSet();
+const legacyIdDisconnects = /* @__PURE__ */ new WeakMap();
 function createMultipartSessionHandle(service, compositor, recordingSource, resolution, hasAudio) {
 	const session = {
 		token: "",
@@ -658,7 +669,7 @@ async function startRecordingSession(params) {
 		resolution,
 		hasAudio
 	});
-	return {
+	const recordingSession = {
 		token: session.token,
 		sessionId: session.sessionId,
 		videoRecordingId: session.videoRecordingId,
@@ -666,6 +677,8 @@ async function startRecordingSession(params) {
 		resolution,
 		hasAudio
 	};
+	legacyIdRecordingStreams.set(recordingSession, clonedStream);
+	return recordingSession;
 }
 function pauseRecordingForAttempt(session) {
 	const multipartSession = multipartIdSessions.get(session);
@@ -680,20 +693,67 @@ function prepareRecordingForCameraRetry(session) {
 	multipartSession.recordingSource.getVideoTracks().forEach((track) => track.stop());
 	multipartSession.needsVideoSourceReplacement = true;
 }
-function stopRecording(session) {
+function releaseLegacyRecordingResources(session) {
+	if (releasedLegacyIdRecordings.has(session)) return;
+	releasedLegacyIdRecordings.add(session);
+	try {
+		session.connection.publisher.destroy();
+	} catch {}
+	const clonedStream = legacyIdRecordingStreams.get(session);
+	legacyIdRecordingStreams.delete(session);
+	for (const track of clonedStream?.getTracks() ?? []) try {
+		track.stop();
+	} catch {}
+}
+function disconnectLegacyRecording(session) {
+	const existing = legacyIdDisconnects.get(session);
+	if (existing) return existing;
+	const disconnect = session.connection.disconnect();
+	legacyIdDisconnects.set(session, disconnect);
+	return disconnect;
+}
+/**
+* Fully drains an ID recording before the protected camera cycle runs POC.
+* Every recorder clone is stopped before this promise settles.
+*/
+async function finalizeRecordingSession(session) {
+	const existing = idRecordingFinalizations.get(session);
+	if (existing) return existing;
 	const multipartSession = multipartIdSessions.get(session);
-	if (multipartSession) {
+	const finalization = multipartSession ? (async () => {
 		multipartIdSessions.delete(session);
-		multipartSession.service.stop().catch(() => {}).finally(() => multipartSession.compositor.stop());
-		return;
-	}
-	(async () => {
+		try {
+			return await multipartSession.service.stop();
+		} finally {
+			multipartSession.compositor.stop();
+		}
+	})() : (async () => {
 		try {
 			await stopRecording$1(session.videoRecordingId);
+			return { recordingId: session.videoRecordingId || null };
 		} finally {
-			await session.connection.disconnect();
+			releaseLegacyRecordingResources(session);
+			await disconnectLegacyRecording(session);
 		}
 	})();
+	idRecordingFinalizations.set(session, finalization);
+	return finalization;
+}
+/** Synchronous teardown used when an attempt is cancelled before finalization. */
+function disposeRecordingSession(session) {
+	const multipartSession = multipartIdSessions.get(session);
+	if (multipartSession) {
+		multipartIdSessions.delete(session);
+		const finalization = multipartSession.service.stop().finally(() => multipartSession.compositor.stop());
+		idRecordingFinalizations.set(session, finalization);
+		finalization.catch(() => {});
+		return;
+	}
+	releaseLegacyRecordingResources(session);
+	disconnectLegacyRecording(session).catch(() => {});
+}
+function stopRecording(session) {
+	finalizeRecordingSession(session).catch(() => {});
 }
 async function processId(isSecondId = false, queueName = "", signal) {
 	const endpoint = isSecondId ? endpoints.processSecondId : endpoints.processId;
@@ -770,4 +830,4 @@ async function addBarcode(params) {
 	return res.data;
 }
 //#endregion
-export { CAPTURE_OPTIMIZING as _, preloadIdRecordingProvider as a, startRecordingSession as c, uploadIdImage as d, uploadManualIdFile as f, resolveIdCaptureThresholds as g, resolveCaptureOptimizingTreatment as h, pauseRecordingForAttempt as i, stopRecording as l, ID_ERROR_CODES as m, barcodeToBase64 as n, prepareRecordingForCameraRetry as o, validateUploadResponse as p, initializeIdCapture as r, processId as s, addBarcode as t, stopStream as u, OPTIMIZING_WATCHDOG_MARGIN_MS as v, getIdCameraStream as y };
+export { getIdCameraStream as S, ID_ERROR_CODES as _, getRealQualityValue as a, CAPTURE_OPTIMIZING as b, preloadIdRecordingProvider as c, startRecordingSession as d, stopRecording as f, validateUploadResponse as g, uploadManualIdFile as h, finalizeRecordingSession as i, prepareRecordingForCameraRetry as l, uploadIdImage as m, barcodeToBase64 as n, initializeIdCapture as o, stopStream as p, disposeRecordingSession as r, pauseRecordingForAttempt as s, addBarcode as t, processId as u, resolveCaptureOptimizingTreatment as v, OPTIMIZING_WATCHDOG_MARGIN_MS as x, resolveIdCaptureThresholds as y };