@incodetech/core 2.3.0-rc.1 → 2.3.0-rc.3

package/dist/idCaptureDefaults-Cd-qOMUt.esm.js

@@ -0,0 +1,282 @@
+import { b as resolveWasmSource, p as WASM_MODEL_FILES } from "./wasmWebClient-B7baE-Wf.esm.js";
+import { p as getBarcodeEnhanceModelUrl } from "./setup-B-qr0dC6.esm.js";
+import { s as wasmRuntime, t as getResolvedModelSource } from "./warmup-CUUnwYxe.esm.js";
+import { i as BaseWasmProvider } from "./safeStorage-B-trhxg6.esm.js";
+import { t as IncodeCanvas } from "./canvas-BxFzWTt-.esm.js";
+//#region ../infra/src/wasm/idCaptureWasmApi.ts
+var IdCaptureWasmApi = class {
+	constructor(runtime = wasmRuntime) {
+		this.runtime = runtime;
+	}
+	async setIdCaptureThresholds(type, blurThreshold, blurChangeThreshold, glareThreshold, clsThreshold, sideThreshold, iouThreshold, idDetectedTimeout, autocaptureTimeout, framesAggregationInterval) {
+		this.runtime.requireIdCaptureApi("Unable to set thresholds, cpp API hasn't been initialized").setIdCaptureThresholds(this.runtime.pipelineTypeToWasmEnum(type), blurThreshold, blurChangeThreshold, glareThreshold, clsThreshold, sideThreshold, iouThreshold, idDetectedTimeout, autocaptureTimeout, framesAggregationInterval);
+	}
+	async setIdCaptureCallbacks(type, onFarAway, onDetectionStarted, onMaskChange, onBlur, onGlare, onCapturing, onCapture, onBestFrame, onIDNotDetected, onSwitchToManualCapture, onIDTypeChange, onIDSideChange, onCapturingCounterValueChange) {
+		this.runtime.requireIdCaptureApi("Unable to set callbacks, cpp API hasn't been initialized").setIdCaptureCallbacks(this.runtime.pipelineTypeToWasmEnum(type), onFarAway, onDetectionStarted, onMaskChange, onBlur, onGlare, onCapturing, onCapture, onBestFrame, onIDNotDetected, onSwitchToManualCapture, onIDTypeChange, onIDSideChange, onCapturingCounterValueChange);
+	}
+	async setIdCaptureGeometryParams(type, areaDown, areaUp, areaIOSPassportUp, areaIOSPassportDown, widthIOSUp, widthIOSDown, widthDown, widthUp, windowOuterWidth, windowOuterHeight, windowInnerWidth, windowInnerHeight) {
+		this.runtime.requireIdCaptureApi("Unable to set geometry params, cpp API hasn't been initialized").setIdCaptureGeometryParams(this.runtime.pipelineTypeToWasmEnum(type), areaDown, areaUp, areaIOSPassportUp, areaIOSPassportDown, widthIOSUp, widthIOSDown, widthDown, widthUp, windowOuterWidth, windowOuterHeight, windowInnerWidth, windowInnerHeight);
+	}
+	async setIdCaptureConfigParams(type, isFixedMask, isIPhone14OrHigher, idType, isBlurCheckEnabled, isGlareCheckEnabled, _isIdFaceQualityCheckEnabled, isIouCheckEnabled, _isFPSLimitEnabled) {
+		this.runtime.requireIdCaptureApi("Unable to set config params, cpp API hasn't been initialized").setIdCaptureConfigParams(this.runtime.pipelineTypeToWasmEnum(type), isFixedMask, isIPhone14OrHigher, idType, isBlurCheckEnabled, isGlareCheckEnabled, isIouCheckEnabled);
+	}
+	setIdCaptureModelType(pipelineType, modelType) {
+		this.runtime.requireIdCaptureApi("Unable to set model type, cpp API hasn't been initialized").setIdCaptureModelType(this.runtime.pipelineTypeToWasmEnum(pipelineType), this.runtime.IdCaptureModelTypeToWasmEnum(modelType));
+	}
+	setIdBarcodeCaptureEnabled(pipelineType, enabled) {
+		this.runtime.requireIdCaptureApi("Unable to set barcode capture enabled, cpp API hasn't been initialized").setIdBarcodeCaptureEnabled(this.runtime.pipelineTypeToWasmEnum(pipelineType), enabled);
+	}
+	setIdBarcodeAutoCaptureOnDecode(pipelineType, enabled) {
+		this.runtime.requireIdCaptureApi("Unable to set barcode auto-capture-on-decode, cpp API hasn't been initialized").setIdBarcodeAutoCaptureOnDecode(this.runtime.pipelineTypeToWasmEnum(pipelineType), enabled);
+	}
+	setIdBarcodeDecodedCallback(pipelineType, onBarcodeDecoded) {
+		this.runtime.requireIdCaptureApi("Unable to set barcode decoded callback, cpp API hasn't been initialized").setIdBarcodeDecodedCallback(this.runtime.pipelineTypeToWasmEnum(pipelineType), onBarcodeDecoded);
+	}
+	async setIdBarcodeEnhancementModel(pipelineType, modelPath) {
+		const message = "Unable to set barcode enhancement model, cpp API hasn't been initialized";
+		this.runtime.requireIdCaptureApi(message);
+		const buffer = await resolveWasmSource(modelPath, "barcode model");
+		return this.runtime.requireIdCaptureApi(message).setBarcodeEnhancementModel(this.runtime.pipelineTypeToWasmEnum(pipelineType), buffer);
+	}
+	IdPerspectiveTransform(image, frameRect) {
+		return this.runtime.requireIdCaptureApi("Unable to perform perspective transform, cpp API hasn't been initialized").IdPerspectiveTransform(image, frameRect);
+	}
+	/**
+	* Kept-dead: mirrors upstream `wasmApi.runIdCapture`. Nothing in the SDK calls
+	* it; it exists so the mirror stays 1:1 with upstream at the pinned tag.
+	*/
+	async runIdCapture(image) {
+		const idCaptureWasmApi = this.runtime.requireIdCaptureApi("Unable to run Id Capture, cpp API hasn't been initialized");
+		if (image) {
+			await this.runtime.allocateImageBuffers(image.width, image.height);
+			this.runtime.writeFrame(image);
+		}
+		return idCaptureWasmApi.runIdCapture();
+	}
+};
+const idCaptureWasmApi = new IdCaptureWasmApi();
+//#endregion
+//#region ../infra/src/providers/wasm/IdCaptureProvider.ts
+var IdCaptureProvider = class extends BaseWasmProvider {
+	constructor(protectedWorkflow) {
+		super(protectedWorkflow ?? 0);
+		this.lastProcessResult = null;
+		this.capturedCanvas = null;
+		this.originalCapturedCanvas = null;
+		this.lastDecodedBarcode = null;
+		this.barcodeEnhancementModelLoaded = false;
+	}
+	async initialize(config) {
+		if (config.videoSelfie === true) {
+			if (this.pipelineType !== 0) throw new Error("[Incode SDK] Protected ID workflows are unavailable for video selfie.");
+			this.pipelineType = 2;
+			await this.initializeBase(config, "videoSelfieId");
+		} else await this.initializeBase(config, "idCapture");
+	}
+	setCallbacks(callbacks) {
+		this.ensureInitialized();
+		const onCaptureWrapper = (canvas) => {
+			callbacks.onCapture?.(canvas);
+		};
+		idCaptureWasmApi.setIdCaptureCallbacks(this.getPipelineType(), callbacks.onFarAway ?? (() => {}), callbacks.onDetectionStarted ?? (() => {}), callbacks.onMaskChange ? (show, mask, top, orientation) => callbacks.onMaskChange?.(show, mask, top, orientation) : () => {}, callbacks.onBlur ?? (() => {}), callbacks.onGlare ?? (() => {}), callbacks.onCapturing ?? (() => {}), callbacks.onCapture ? onCaptureWrapper : () => {}, callbacks.onBestFrame ? (blur, glare, orientation) => callbacks.onBestFrame?.(blur, glare, orientation) : () => {}, callbacks.onIdNotDetected ?? (() => {}), callbacks.onSwitchToManualCapture ?? (() => {}), callbacks.onIdTypeChange ? (idType) => callbacks.onIdTypeChange?.(idType) : () => {}, callbacks.onIdSideChange ? (side) => callbacks.onIdSideChange?.(side) : () => {}, callbacks.onCapturingCounterValueChange ? (value) => callbacks.onCapturingCounterValueChange?.(value) : () => {});
+		if (callbacks.onBarcodeDecoded) {
+			const onBarcodeDecoded = callbacks.onBarcodeDecoded;
+			idCaptureWasmApi.setIdBarcodeDecodedCallback(this.getPipelineType(), (decoded) => {
+				this.lastDecodedBarcode = decoded;
+				onBarcodeDecoded(decoded);
+			});
+		} else idCaptureWasmApi.setIdBarcodeDecodedCallback(this.getPipelineType(), () => {});
+	}
+	setThresholds(thresholds) {
+		this.ensureInitialized();
+		idCaptureWasmApi.setIdCaptureThresholds(this.getPipelineType(), thresholds.blurThreshold, thresholds.blurChangeThreshold, thresholds.glareThreshold, thresholds.clsThreshold, thresholds.sideThreshold, thresholds.iouThreshold, thresholds.idDetectedTimeout, thresholds.autocaptureTimeout, thresholds.framesAggregationInterval);
+	}
+	setGeometry(geometry) {
+		this.ensureInitialized();
+		idCaptureWasmApi.setIdCaptureGeometryParams(this.getPipelineType(), geometry.areaDown, geometry.areaUp, geometry.areaIOSPassportUp, geometry.areaIOSPassportDown, geometry.widthIOSUp, geometry.widthIOSDown, geometry.widthDown, geometry.widthUp, geometry.windowOuterWidth, geometry.windowOuterHeight, geometry.windowInnerWidth, geometry.windowInnerHeight);
+	}
+	setSettings(settings) {
+		this.ensureInitialized();
+		idCaptureWasmApi.setIdCaptureConfigParams(this.getPipelineType(), settings.isFixedMask, settings.isIPhone14OrHigher, settings.idType, settings.blurCheckEnabled, settings.glareCheckEnabled, settings.faceQualityCheckEnabled, settings.iouCheckEnabled, settings.fpsLimitEnabled);
+	}
+	setModelType(modelType) {
+		this.ensureInitialized();
+		let wasmModelType;
+		switch (modelType) {
+			case "v1":
+				wasmModelType = 0;
+				break;
+			case "v2":
+				wasmModelType = 1;
+				break;
+			case "v3":
+				wasmModelType = 2;
+				break;
+			default: throw new Error(`Unknown model type: ${modelType}`);
+		}
+		idCaptureWasmApi.setIdCaptureModelType(this.getPipelineType(), wasmModelType);
+	}
+	setBarcodeCaptureEnabled(enabled) {
+		this.ensureInitialized();
+		idCaptureWasmApi.setIdBarcodeCaptureEnabled(this.getPipelineType(), enabled);
+	}
+	setBarcodeAutoCaptureOnDecode(enabled) {
+		this.ensureInitialized();
+		idCaptureWasmApi.setIdBarcodeAutoCaptureOnDecode(this.getPipelineType(), enabled);
+	}
+	async setBarcodeEnhancementModel() {
+		this.ensureInitialized();
+		if (this.barcodeEnhancementModelLoaded) return true;
+		const modelUrl = getResolvedModelSource(WASM_MODEL_FILES.barcode, "idCapture") ?? getBarcodeEnhanceModelUrl();
+		const applied = await idCaptureWasmApi.setIdBarcodeEnhancementModel(this.getPipelineType(), modelUrl);
+		this.barcodeEnhancementModelLoaded = applied;
+		return applied;
+	}
+	getLastDecodedBarcode() {
+		return this.lastDecodedBarcode;
+	}
+	/**
+	* Processes a frame through the WASM pipeline and stores the result.
+	*/
+	async processFrame(image) {
+		const result = await this.processFrameWasm(image);
+		const pipelineType = this.getPipelineType();
+		if (result && (pipelineType === 0 || pipelineType === 2)) this.lastProcessResult = result;
+		else this.lastProcessResult = null;
+	}
+	/**
+	* Gets the last process result from the most recent frame processing.
+	* @returns The last process result with quad coordinates, or null if not available
+	*/
+	getLastProcessResult() {
+		return this.lastProcessResult;
+	}
+	transformPerspective(canvas, frameRect) {
+		this.ensureInitialized();
+		const originalWidth = canvas.width();
+		const originalHeight = canvas.height();
+		try {
+			const imageData = canvas.getImageData();
+			if (!imageData) return canvas;
+			const transformedCanvas = idCaptureWasmApi.IdPerspectiveTransform(imageData, frameRect);
+			if (transformedCanvas) {
+				const wrappedCanvas = new IncodeCanvas(transformedCanvas);
+				const wrappedWidth = wrappedCanvas.width();
+				const wrappedHeight = wrappedCanvas.height();
+				if (wrappedWidth === originalWidth && wrappedHeight === originalHeight) {
+					const croppedCanvas = this.cropCanvasToRect(wrappedCanvas, {
+						x: Math.round(frameRect.x),
+						y: Math.round(frameRect.y),
+						w: Math.round(frameRect.w),
+						h: Math.round(frameRect.h)
+					});
+					if (croppedCanvas) return croppedCanvas;
+				}
+				return wrappedCanvas;
+			}
+			return canvas;
+		} catch (_error) {
+			return canvas;
+		}
+	}
+	/**
+	* Crops a canvas to the specified rectangle region.
+	* @param canvas - The canvas to crop
+	* @param rect - The rectangle to crop to (x, y, w, h)
+	* @returns A new IncodeCanvas with the cropped region, or null if cropping fails
+	*/
+	cropCanvasToRect(canvas, rect) {
+		const canvasWidth = canvas.width();
+		const canvasHeight = canvas.height();
+		if (!canvasWidth || !canvasHeight) return null;
+		const x = Math.max(0, Math.min(rect.x, canvasWidth));
+		const y = Math.max(0, Math.min(rect.y, canvasHeight));
+		const w = Math.max(1, Math.min(rect.w, canvasWidth - x));
+		const h = Math.max(1, Math.min(rect.h, canvasHeight - y));
+		const croppedCanvasElement = document.createElement("canvas");
+		croppedCanvasElement.width = w;
+		croppedCanvasElement.height = h;
+		const ctx = croppedCanvasElement.getContext("2d");
+		if (!ctx) return null;
+		ctx.drawImage(canvas.canvas, x, y, w, h, 0, 0, w, h);
+		return new IncodeCanvas(croppedCanvasElement);
+	}
+	/**
+	* Gets the captured canvas (transformed for preview).
+	* @returns The captured canvas, or null if not available
+	*/
+	getCapturedCanvas() {
+		return this.capturedCanvas;
+	}
+	/**
+	* Gets the original captured canvas (full frame for upload).
+	* @returns The original captured canvas, or null if not available
+	*/
+	getOriginalCapturedCanvas() {
+		return this.originalCapturedCanvas;
+	}
+	/**
+	* Sets the captured canvases (original and transformed).
+	* @param original - The original full-frame canvas (for upload)
+	* @param transformed - The transformed canvas (for preview)
+	*/
+	setCapturedCanvases(original, transformed) {
+		this.originalCapturedCanvas = original;
+		this.capturedCanvas = transformed;
+	}
+	/**
+	* Re-arms WASM detection without discarding the captured result.
+	*
+	* Detection-session teardown runs immediately after a successful capture.
+	* The captured canvases must remain available for the subsequent upload and
+	* are only replaced by `setCapturedCanvases()` or cleared by a full reset.
+	*/
+	resetDetectionState() {
+		super.reset();
+		this.lastProcessResult = null;
+		this.lastDecodedBarcode = null;
+	}
+	reset() {
+		this.resetDetectionState();
+		this.capturedCanvas = null;
+		this.originalCapturedCanvas = null;
+	}
+	async dispose() {
+		await super.dispose();
+		this.barcodeEnhancementModelLoaded = false;
+	}
+};
+//#endregion
+//#region ../infra/src/wasm/idCaptureDefaults.ts
+/**
+* Default WASM thresholds for ID capture quality checks.
+* Matches SDK 1's `wasmWorkflowsConfig.ts` production ID profile. Explicit
+* consumer and experiment overrides still take precedence in Core.
+*/
+const DEFAULT_ID_CAPTURE_THRESHOLDS = {
+	blurThreshold: .2,
+	blurChangeThreshold: .2,
+	glareThreshold: .3,
+	clsThreshold: .98,
+	sideThreshold: .8,
+	iouThreshold: .8,
+	idDetectedTimeout: 1e4,
+	autocaptureTimeout: 5e3,
+	framesAggregationInterval: 1700
+};
+/**
+* Default geometry parameters for ID detection.
+* Window dimensions must be provided at runtime.
+*/
+const DEFAULT_ID_CAPTURE_GEOMETRY = {
+	areaDown: 25e3,
+	areaUp: 55e3,
+	areaIOSPassportUp: 3e4,
+	areaIOSPassportDown: 2e4,
+	widthIOSUp: 160,
+	widthIOSDown: 85,
+	widthDown: 110,
+	widthUp: 205
+};
+//#endregion
+export { DEFAULT_ID_CAPTURE_THRESHOLDS as n, IdCaptureProvider as r, DEFAULT_ID_CAPTURE_GEOMETRY as t };

package/dist/{idCaptureManager-rfV9dIXy.esm.js → idCaptureManager-CO4WBQQN.esm.js}

@@ -1,12 +1,12 @@
-import { l as BrowserStorageProvider } from "./setup-BWG-hivt.esm.js";
+import { l as BrowserStorageProvider } from "./setup-B-qr0dC6.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-B2e8p268.esm.js";
 import { t as BrowserVisibilityObserverProvider } from "./BrowserVisibilityObserverProvider-BrJN1B8A.esm.js";
 import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-Bj_fyWtv.esm.js";
-import { a as createIdProtectedCaptureController, n as provideIdProtectedCaptureController, o as findIdProtectedCaptureController, s as getManualUploadTabs, t as idCaptureMachine } from "./idCaptureStateMachine-Ne_PXth_.esm.js";
-import { _ as resolveCaptureOptimizingTreatment, v as resolveIdCaptureThresholds } from "./idCaptureServices-i1KxugN7.esm.js";
+import { a as createIdProtectedCaptureController, n as provideIdProtectedCaptureController, o as findIdProtectedCaptureController, s as getManualUploadTabs, t as idCaptureMachine } from "./idCaptureStateMachine-CzyZ_21z.esm.js";
+import { b as resolveIdCaptureThresholds, y as resolveCaptureOptimizingTreatment } from "./idCaptureServices-CFuKdAW7.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) {

package/dist/{idCaptureManager-DKESug0R.d.ts → idCaptureManager-De7O0TOD.d.ts}

@@ -126,15 +126,34 @@ type StartRecordingParams = {
 declare function startRecordingSession(params: StartRecordingParams): Promise<object | undefined>;
 declare function pauseRecordingForAttempt(session: object): void;
 declare function prepareRecordingForCameraRetry(session: object): void;
+/**
+ * Resumes a recording paused with `pauseRecordingForAttempt` while its camera
+ * clone is still attached (no source replacement pending). Returns whether the
+ * recorder is recording again.
+ */
+declare function resumeRecordingAfterPause(session: object): boolean;
+/**
+ * True only for a live SDK-managed multipart session. A session that has
+ * already been finalized or disposed is no longer in the registry, so callers
+ * use this to avoid resuming or re-pausing a torn-down recording.
+ */
+declare function isSuspendableRecordingSession(session: object): boolean;
 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.
+ * Completes an ID recording: drains the multipart upload and releases the
+ * compositor. The camera clone ends synchronously, before this function
+ * returns its promise, so a step that ends mid-attempt never pins the camera
+ * while the upload finishes (ENG-56648). The composite canvas stays alive until
+ * the recorder has emitted its final chunk.
  */
 declare function finalizeRecordingSession(session: object): Promise<FinalizedIdRecording>;
-/** Synchronous teardown used when an attempt is cancelled before finalization. */
+/**
+ * Teardown for an attempt released before finalization. The camera clone ends
+ * synchronously, before this function returns; the upload completes in the
+ * background with whatever was recorded.
+ */
 declare function disposeRecordingSession(session: object): void;
 declare function stopRecording(session: object): void;
 declare function processId(isSecondId?: boolean, queueName?: string, signal?: AbortSignal): Promise<{
@@ -623,4 +642,4 @@ declare function createIdCaptureManager(options: CreateIdCaptureActorOptions): M
   deviceWalletUseAnotherMethod(): void;
 };
 //#endregion
-export { prepareRecordingForCameraRetry as A, addBarcode as C, getRealQualityValue as D, finalizeRecordingSession as E, uploadIdImage as F, uploadManualIdFile as I, validateUploadResponse as L, startRecordingSession as M, stopRecording as N, initializeIdCapture as O, stopStream as P, WasmUtilProvider 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, processId 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 };
+export { pauseRecordingForAttempt as A, WasmUtilProvider as B, addBarcode as C, getRealQualityValue as D, finalizeRecordingSession as E, stopRecording as F, stopStream as I, uploadIdImage as L, processId as M, resumeRecordingAfterPause as N, initializeIdCapture as O, startRecordingSession as P, uploadManualIdFile 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, isSuspendableRecordingSession 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, validateUploadResponse as z };

package/dist/{idCaptureServices-i1KxugN7.esm.js → idCaptureServices-CFuKdAW7.esm.js}

@@ -1,5 +1,5 @@
-import { t as ensureWasmPipelines } from "./setup-BWG-hivt.esm.js";
-import { i as numberParam, n as defineExperimentParams, t as booleanParam, u as resolveExperimentOnce } from "./feature-management-E0mq0pMs.esm.js";
+import { t as ensureWasmPipelines } from "./setup-B-qr0dC6.esm.js";
+import { i as numberParam, n as defineExperimentParams, t as booleanParam, u as resolveExperimentOnce } from "./feature-management-Bzr9uaS4.esm.js";
 import { t as api } from "./api-Bx3gKW_y.esm.js";
 import { t as endpoints } from "./endpoints-B-3Q-LUw.esm.js";
 import { i as isDesktop } from "./platform-DkcRc9JV.esm.js";
@@ -8,8 +8,8 @@ import { n as fromPromise } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
 import { s as queryCameraPermission } from "./permissionServices-Bj_fyWtv.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-OEgIRvqC.esm.js";
-import { i as CameraCompositor, n as DEFAULT_ID_CAPTURE_THRESHOLDS, r as IdCaptureProvider } from "./idCaptureDefaults-CbPA-Auz.esm.js";
+import { n as CameraCompositor, t as MultipartRecordingService } from "./multipartRecordingService-CuXLH4tK.esm.js";
+import { n as DEFAULT_ID_CAPTURE_THRESHOLDS, r as IdCaptureProvider } from "./idCaptureDefaults-Cd-qOMUt.esm.js";
 //#region src/internal/camera/cameraServices.ts
 function createCameraServices(camera) {
 	return {
@@ -577,6 +577,7 @@ function createMultipartSessionHandle(service, compositor, recordingSource) {
 		needsVideoSourceReplacement: false,
 		recorderPaused: false,
 		recordingSource,
+		audioSource: recordingSource.getAudioTracks(),
 		service
 	});
 	return session;
@@ -620,21 +621,62 @@ function prepareRecordingForCameraRetry(session) {
 	const multipartSession = multipartIdSessions.get(session);
 	if (!multipartSession) return;
 	if (!multipartSession.recorderPaused) multipartSession.recorderPaused = multipartSession.service.pause();
-	multipartSession.compositor.pause();
-	multipartSession.recordingSource.getVideoTracks().forEach((track) => track.stop());
+	releaseCameraClone(multipartSession, { keepAudio: true });
 	multipartSession.needsVideoSourceReplacement = true;
 }
 /**
-* Fully drains an ID recording before the protected camera cycle runs POC.
-* Every recorder clone is stopped before this promise settles.
+* Resumes a recording paused with `pauseRecordingForAttempt` while its camera
+* clone is still attached (no source replacement pending). Returns whether the
+* recorder is recording again.
+*/
+function resumeRecordingAfterPause(session) {
+	const multipartSession = multipartIdSessions.get(session);
+	if (!multipartSession || multipartSession.needsVideoSourceReplacement) return false;
+	if (!multipartSession.recorderPaused) return true;
+	if (!multipartSession.service.resume()) return false;
+	multipartSession.recorderPaused = false;
+	return true;
+}
+/**
+* True only for a live SDK-managed multipart session. A session that has
+* already been finalized or disposed is no longer in the registry, so callers
+* use this to avoid resuming or re-pausing a torn-down recording.
+*/
+function isSuspendableRecordingSession(session) {
+	return multipartIdSessions.has(session);
+}
+/**
+* Ends the compositor's camera clone on the calling thread. The composite
+* stream and its upload stay alive; only the tracks that pin the physical
+* camera end. `keepAudio` preserves the compositor's audio track across a
+* video-source swap. Every release path must call this before any async work
+* so no camera clone can overlap a PRC or POC camera switch (ENG-47407) or pin
+* the device for the next module (ENG-56648).
+*/
+function releaseCameraClone(multipartSession, options) {
+	try {
+		multipartSession.compositor.pause();
+	} catch {}
+	const tracks = options.keepAudio ? multipartSession.recordingSource.getVideoTracks() : /* @__PURE__ */ new Set([...multipartSession.recordingSource.getTracks(), ...multipartSession.audioSource]);
+	for (const track of tracks) try {
+		track.stop();
+	} catch {}
+}
+/**
+* Completes an ID recording: drains the multipart upload and releases the
+* compositor. The camera clone ends synchronously, before this function
+* returns its promise, so a step that ends mid-attempt never pins the camera
+* while the upload finishes (ENG-56648). The composite canvas stays alive until
+* the recorder has emitted its final chunk.
 */
 async function finalizeRecordingSession(session) {
 	const existing = idRecordingFinalizations.get(session);
 	if (existing) return existing;
 	const multipartSession = multipartIdSessions.get(session);
 	if (!multipartSession) return {};
+	multipartIdSessions.delete(session);
+	releaseCameraClone(multipartSession, { keepAudio: false });
 	const finalization = (async () => {
-		multipartIdSessions.delete(session);
 		try {
 			return await multipartSession.service.stop();
 		} finally {
@@ -644,11 +686,16 @@ async function finalizeRecordingSession(session) {
 	idRecordingFinalizations.set(session, finalization);
 	return finalization;
 }
-/** Synchronous teardown used when an attempt is cancelled before finalization. */
+/**
+* Teardown for an attempt released before finalization. The camera clone ends
+* synchronously, before this function returns; the upload completes in the
+* background with whatever was recorded.
+*/
 function disposeRecordingSession(session) {
 	const multipartSession = multipartIdSessions.get(session);
 	if (multipartSession) {
 		multipartIdSessions.delete(session);
+		releaseCameraClone(multipartSession, { keepAudio: false });
 		const finalization = multipartSession.service.stop().finally(() => multipartSession.compositor.stop());
 		idRecordingFinalizations.set(session, finalization);
 		finalization.catch(() => {});
@@ -732,4 +779,4 @@ async function addBarcode(params) {
 	return res.data;
 }
 //#endregion
-export { resolveCaptureOptimizingTreatment as _, getRealQualityValue as a, OPTIMIZING_WATCHDOG_MARGIN_MS as b, prepareRecordingForCameraRetry as c, stopRecording as d, stopStream as f, ID_ERROR_CODES as g, validateUploadResponse as h, finalizeRecordingSession as i, processId as l, uploadManualIdFile as m, barcodeToBase64 as n, initializeIdCapture as o, uploadIdImage as p, disposeRecordingSession as r, pauseRecordingForAttempt as s, addBarcode as t, startRecordingSession as u, resolveIdCaptureThresholds as v, getIdCameraStream as x, CAPTURE_OPTIMIZING as y };
+export { getIdCameraStream as C, OPTIMIZING_WATCHDOG_MARGIN_MS as S, validateUploadResponse as _, getRealQualityValue as a, resolveIdCaptureThresholds as b, pauseRecordingForAttempt as c, resumeRecordingAfterPause as d, startRecordingSession as f, uploadManualIdFile as g, uploadIdImage as h, finalizeRecordingSession as i, prepareRecordingForCameraRetry as l, stopStream as m, barcodeToBase64 as n, initializeIdCapture as o, stopRecording as p, disposeRecordingSession as r, isSuspendableRecordingSession as s, addBarcode as t, processId as u, ID_ERROR_CODES as v, CAPTURE_OPTIMIZING as x, resolveCaptureOptimizingTreatment as y };