@incodetech/web 0.0.0-dev-20260817-941e76d2 → 0.0.0-dev-20260817-ec13a90c

package/dist/types/video-selfie.d.ts

@@ -1,145 +1,16 @@
 import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
-import { FunctionComponent } from 'preact';
-import { SVGProps } from 'preact/compat';
 import { VideoSelfieConfig } from '@incodetech/core/video-selfie';
 
-/**
- * Allowlisted keys for overridable Lottie animations
- */
-declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
-
-/**
- * A customer-supplied replacement for a built-in Lottie animation.
- *
- * - `LottieAnimationData` — a parsed Lottie JSON object.
- * - `{ url }` — fetched and cached at runtime.
- * - `{ animationData }` — explicit object form.
- */
-declare type AnimationOverride = LottieAnimationData | {
-    url: string;
-} | {
-    animationData: LottieAnimationData;
-};
-
-declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
-
-/**
- * Allowlisted keys for overridable branded SVG illustrations
- */
-declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
-
-/**
- * A customer-supplied replacement for a built-in SVG illustration.
- *
- * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
- * - `{ url }` — fetched and rendered via `<img>`; no script execution.
- * - `{ raw }` — inline markup; sanitized before injection.
- * - `{ svg }` — a precompiled component, for build-time integrations.
- */
-declare type AssetOverride = string | {
-    url: string;
-} | {
-    raw: string;
-} | {
-    svg: SvgComponent;
-};
-
-declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
-
-/**
- * A module `config` intersected with the per-instance override maps. Typed at
- * the UI boundary so core config types (e.g. `IdCaptureConfig`) stay untouched;
- * `FlowConfig` also declares the maps directly.
- */
-declare type ConfigWithOverrides<TConfig> = TConfig & InstanceOverrides;
-
-/**
- * Extra context passed to `onFinish` alongside the result. Lets a host decide
- * how to react to the terminal state without inspecting the DOM. Only the
- * workflow module sets these fields today.
- */
-declare type IncodeFinishMeta = {
-    /**
-     * True when the SDK owns the terminal screen — it has already rendered its
-     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
-     * screen), so the host should not render its own completion screen on top.
-     * `onFinish` still fires so the host can run side effects (e.g. notify an
-     * OAuth parent).
-     *
-     * Advisory only: the SDK cannot stop a host from rendering. This works solely
-     * because the host reads this flag — a host that ignores it will still
-     * replace the SDK screen. Not a guarantee.
-     */
-    sdkOwnsTerminalScreen?: boolean;
-};
-
-declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TConfigInput = ConfigWithOverrides<TConfig>> = {
-    /**
-     * Module configuration required to render the flow.
-     * For Web Components, this is typically assigned via `element.config = ...`.
-     *
-     * Also carries optional per-instance `assets`/`animations` override maps;
-     * they override the global `setup({ uiConfig })` values for this
-     * element only and are ignored by the core manager.
-     */
-    config?: TConfigInput;
-    /**
-     * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
-     */
-    manager?: TManager;
-    /**
-     * Callback invoked when the module completes successfully.
-     * @param result - Optional result data from the module completion
-     * @param meta - Optional context about how the module resolved (e.g. whether
-     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
-     */
-    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
-    /**
-     * Callback invoked when a fatal module error occurs.
-     *
-     * @param error - Human-readable error message.
-     * @param errorCode - Optional numeric code (e.g. HTTP status). Populated by
-     *   the workflow and flow modules on QR validation failures —
-     *   `4026` (`expiredUUID`), `4081` (`invalidQRuuid`) or `4083` (`onboardingUrlAlreadyUsed`).
-     * @param moduleErrorCode - Optional machine-readable error code (e.g. a
-     *   `FaceErrorCode` such as `NONEXISTENT_CUSTOMER`). Lets an orchestrator
-     *   branch on the specific terminal error without parsing the message string.
-     */
+export declare const VideoSelfie: FC<Omit<{
+    config?: VideoSelfieConfig | undefined;
+    manager?: unknown;
+    onFinish?: ((result?: void | undefined) => void) | undefined;
     onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
-};
-
-/**
- * Per-instance asset/animation overrides for a single mounted SDK module.
- *
- * These ride on the module's `config` prop and are published once at the
- * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
- * reads them via {@link useInstanceOverrides} without any prop drilling.
- */
-declare type InstanceOverrides = {
-    assets?: AssetOverrides;
-    animations?: AnimationOverrides;
-};
-
-declare type LottieAnimationData = {
-    fr: number;
-    v: string;
-    ip: number;
-    op: number;
-    w: number;
-    h: number;
-};
-
-/** An SVG imported as a Preact component (the `?react` import shape). */
-declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
-
-export declare const VideoSelfie: FC<Omit<VideoSelfieProps, "config"> & {
-    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}, "config"> & {
+    config?: (Omit<VideoSelfieConfig, "validateClosedEyes" | "validateFaceMask" | "validateHeadCover" | "validateLenses" | "speechToTextCheck" | "numberOfTries" | "useAsSelfie" | "showTutorials" | "companyName" | "checkLiveness" | "checkIdScan" | "checkDocumentScan" | "compareIdEnabled" | "compareOcrEnabled" | "compareBackIdEnabled" | "compareBackOcrEnabled" | "checkVoiceConsent" | "voiceConsentQuestions" | "selfieQualityAffectsScore" | "maxWaitingVideoSelfieFile" | "lastSecondsVideoQualityCheck" | "lastSecondsVideoQualityCheckDuration"> & DeepPartial<Pick<VideoSelfieConfig, "validateClosedEyes" | "validateFaceMask" | "validateHeadCover" | "validateLenses" | "speechToTextCheck" | "numberOfTries" | "useAsSelfie" | "showTutorials" | "companyName" | "checkLiveness" | "checkIdScan" | "checkDocumentScan" | "compareIdEnabled" | "compareOcrEnabled" | "compareBackIdEnabled" | "compareBackOcrEnabled" | "checkVoiceConsent" | "voiceConsentQuestions" | "selfieQualityAffectsScore" | "maxWaitingVideoSelfieFile" | "lastSecondsVideoQualityCheck" | "lastSecondsVideoQualityCheckDuration">>) | undefined;
 }>;
 
-/** Props for the {@link VideoSelfie} component. */
-declare type VideoSelfieProps = IncodeModuleProps<VideoSelfieConfig>;
-
 export { }
 
 declare global {

package/dist/video-selfie/video-selfie.es.js

@@ -428,9 +428,11 @@ var getSelfieVariant = (detectionStatus) => {
 };
 var VideoSelfieContent = ({ config, onFinish, onError }) => {
 	const { t } = useTranslation();
-	const cameraWarmer = T(() => config ? createVideoSelfieCameraWarmer(config) : null, [config]);
+	const steps = T(() => config ? resolveVideoSelfieSteps(config) : [], [config]);
+	const cameraWarmer = T(() => config ? createVideoSelfieCameraWarmer(config, steps) : null, [config, steps]);
 	const [state, manager] = useManager(() => createVideoSelfieRecordingManager({
 		config,
+		steps,
 		dependencies: cameraWarmer ? { acquireCamera: cameraWarmer.acquireCamera } : void 0
 	}), { autoLoad: false });
 	const [phase, setPhase] = d(config?.showTutorials ? "tutorial" : "permissions");
@@ -441,8 +443,8 @@ var VideoSelfieContent = ({ config, onFinish, onError }) => {
 	});
 	y(() => {
 		if ((phase === "tutorial" || phase === "permissions") && config) {
-			warmupVideoSelfieWasm(config);
-			if (config.checkIdScan) {
+			warmupVideoSelfieWasm(config, steps);
+			if (steps.some((step) => step === "frontId" || step === "backId")) {
 				preloadCaptureAnimations();
 				preloadIdFlipAnimation();
 			}
@@ -451,6 +453,7 @@ var VideoSelfieContent = ({ config, onFinish, onError }) => {
 	}, [
 		phase,
 		config,
+		steps,
 		cameraWarmer
 	]);
 	y(() => () => cameraWarmer?.dispose(), [cameraWarmer]);
@@ -462,10 +465,9 @@ var VideoSelfieContent = ({ config, onFinish, onError }) => {
 		status: state.status,
 		onFinish
 	});
-	const steps = T(() => config ? resolveVideoSelfieSteps(config) : [], [config]);
 	const step = state.step ?? "selfie";
 	if (phase === "tutorial" && config) return /* @__PURE__ */ u(VideoSelfieTutorial, {
-		config,
+		steps,
 		onStart: () => setPhase("permissions")
 	});
 	if (phase === "permissions") return /* @__PURE__ */ u(Permissions, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/web",
-  "version": "0.0.0-dev-20260817-941e76d2",
+  "version": "0.0.0-dev-20260817-ec13a90c",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -292,7 +292,7 @@
     "qrcode": "^1.5.4",
     "signature_pad": "^5.1.3",
     "tailwindcss": "^4.1.17",
-    "@incodetech/core": "0.0.0-dev-20260817-941e76d2"
+    "@incodetech/core": "0.0.0-dev-20260817-ec13a90c"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.53.3",