@incodetech/web 0.0.0-dev-20260622-1afbb270 → 0.0.0-dev-20260623-132ddef6

package/dist/face-match/face-match.es.js

@@ -1,2 +1,2 @@
-import { t as FaceMatch } from "../faceMatch-Dez_bq3n.js";
+import { t as FaceMatch } from "../faceMatch-BSrFwS4c.js";
 export { FaceMatch };

package/dist/{faceMatch-Dez_bq3n.js → faceMatch-BSrFwS4c.js}

@@ -291,7 +291,7 @@ var FaceMatchContent = ({ config, onFinish, onError }) => {
 						className: "IncodeFaceMatchLivenessContainer IncodeFaceMatchLivenessVisible",
 						children: /* @__PURE__ */ u(Snackbar, {
 							variant: liveness ? "positive" : "negative",
-							children: t(liveness ? "faceMatch.livenessSuccess" : "faceMatch.livenessFailed")
+							children: t(liveness ? "matchUser.livenessSuccess" : "matchUser.livenessFailed")
 						})
 					}),
 					showResult && /* @__PURE__ */ u("div", {

package/dist/faceMatch-D_uyeaBt.js

@@ -0,0 +1,2 @@
+import { t as FaceMatch } from "./faceMatch-BSrFwS4c.js";
+export { FaceMatch };

package/dist/flow/flow.es.js

@@ -5,7 +5,7 @@ import { c as useManager } from "../hooks-Da_yP_Dr.js";
 import { t as IncodeComponent } from "../incodeComponent-Cmi1rlWs.js";
 import { t as TransitionSpinner } from "../transitionSpinner-4rPkt-KM.js";
 import { t as registerIncodeModuleElement } from "../incodeModule-M8DszCee.js";
-import { _ as warmupWasmIfNeeded, a as resolveApiKey, c as HEADLESS_FLOW_MODULE_KEYS, d as fetchTheme, f as initializeFlowManager, h as preloadRedirectToMobile, l as LAZY_UI_MODULES, m as preloadHomeScreen, n as useModulePreloader, o as extractIncodeStatus, p as preloadFirstModule, r as usePrefetchNextModule, s as UnsupportedModule, t as useModuleLoader, u as createFlowManager, y as TerminalErrorPage } from "../useModuleLoader-Kt78XfNR.js";
+import { _ as warmupWasmIfNeeded, a as resolveApiKey, c as HEADLESS_FLOW_MODULE_KEYS, d as fetchTheme, f as initializeFlowManager, h as preloadRedirectToMobile, l as LAZY_UI_MODULES, m as preloadHomeScreen, n as useModulePreloader, o as extractIncodeStatus, p as preloadFirstModule, r as usePrefetchNextModule, s as UnsupportedModule, t as useModuleLoader, u as createFlowManager, y as TerminalErrorPage } from "../useModuleLoader-BNE_xKwo.js";
 import { getDeviceClass } from "@incodetech/core/device";
 import { getRequiredWasmPipelines } from "@incodetech/core/flow";
 import { bootstrapSession, refreshQrUrlUuid } from "@incodetech/core/session";

package/dist/types/ae-signature.d.ts

@@ -5,6 +5,26 @@ export declare const AeSignature: FC<AeSignatureModuleProps>;
 
 declare type AeSignatureModuleProps = IncodeModuleProps<AeSignatureConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/antifraud.d.ts

@@ -6,6 +6,26 @@ export declare const Antifraud: FC<AntifraudProps>;
 
 declare type AntifraudProps = IncodeModuleProps<AntifraudConfig, void, AntifraudManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/authentication.d.ts

@@ -8,6 +8,26 @@ declare type AuthenticationProps = IncodeModuleProps<AuthenticationConfig & {
     authHint?: string;
 }, void, AuthenticationManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -21,8 +41,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/certificate-issuance.d.ts

@@ -8,6 +8,26 @@ declare type CertificateIssuanceProps = IncodeModuleProps<CertificateIssuanceCon
     manager?: CertificateIssuanceManager;
 };
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -21,8 +41,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/consent.d.ts

@@ -6,6 +6,26 @@ export declare const Consent: FC<ConsentProps>;
 
 declare type ConsentProps = IncodeModuleProps<ConsentConfig, void, ConsentManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/cross-document-data-match.d.ts

@@ -5,6 +5,26 @@ export declare const CrossDocumentDataMatch: FC<CrossDocumentDataMatchProps>;
 
 declare type CrossDocumentDataMatchProps = IncodeModuleProps<CrossDocumentDataMatchConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/curp-validation.d.ts

@@ -6,6 +6,26 @@ export declare const CurpValidation: FC<CurpValidationProps>;
 
 declare type CurpValidationProps = IncodeModuleProps<CurpValidationConfig, void, CurpValidationManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/document-capture.d.ts

@@ -5,6 +5,26 @@ export declare const DocumentCapture: FC<DocumentCaptureProps>;
 
 declare type DocumentCaptureProps = IncodeModuleProps<DocumentCaptureConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/ekyb.d.ts

@@ -5,6 +5,26 @@ export declare const EkybModule: FC<EkybModuleProps>;
 
 declare type EkybModuleProps = IncodeModuleProps<EkybConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/ekyc.d.ts

@@ -5,6 +5,26 @@ export declare const EkycModule: FC<EkycModuleProps>;
 
 declare type EkycModuleProps = IncodeModuleProps<EkycConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/electronic-signature.d.ts

@@ -8,6 +8,26 @@ export declare const ElectronicSignature: FC<ElectronicSignatureModuleProps>;
 
 declare type ElectronicSignatureModuleProps = IncodeModuleProps<ElectronicSignatureConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -21,8 +41,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/email.d.ts

@@ -32,6 +32,26 @@ export declare const Email: FC<EmailProps>;
  */
 declare type EmailProps = IncodeModuleProps<EmailConfig, void, EmailManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -45,8 +65,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/extensibility.d.ts

@@ -428,6 +428,26 @@ declare type IncodeComponentProps = {
     children?: ComponentChildren;
 };
 
+/**
+ * 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;
+};
+
 export declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * Module configuration required to render the flow.
@@ -441,8 +461,10 @@ export declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknow
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/face-match.d.ts

@@ -30,6 +30,26 @@ export declare const FaceMatch: FC<FaceMatchProps>;
  */
 declare type FaceMatchProps = IncodeModuleProps<FaceMatchConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -43,8 +63,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/field-comparison.d.ts

@@ -6,6 +6,26 @@ export declare const FieldComparison: FC<FieldComparisonProps>;
 
 declare type FieldComparisonProps = IncodeModuleProps<FieldComparisonConfig, void, FieldComparisonManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/fiscal-qr.d.ts

@@ -5,6 +5,26 @@ export declare const FiscalQr: FC<FiscalQrProps>;
 
 declare type FiscalQrProps = IncodeModuleProps<FiscalQrConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/flow.d.ts

@@ -45,6 +45,26 @@ declare type FlowUiConfig = {
     spinnerConfig?: SpinnerConfig;
 };
 
+/**
+ * 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;
+};
+
 export declare const IncodeFlow: FC<IncodeFlowProps>;
 
 declare type IncodeFlowProps = IncodeModuleProps<FlowConfig, FinishStatus>;
@@ -62,8 +82,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/geolocation.d.ts

@@ -6,6 +6,26 @@ export { Geolocation_2 as Geolocation }
 
 declare type GeolocationProps = IncodeModuleProps<GeolocationConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/governmentValidation.d.ts

@@ -5,6 +5,26 @@ export declare const GovernmentValidation: FC<GovernmentValidationProps>;
 
 declare type GovernmentValidationProps = IncodeModuleProps<GovernmentValidationConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/id-verification.d.ts

@@ -5,6 +5,26 @@ export declare const IdVerification: FC<IdVerificationProps>;
 
 declare type IdVerificationProps = IncodeModuleProps<IdVerificationConfig>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -18,8 +38,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/id.d.ts

@@ -6,6 +6,26 @@ export declare const Id: FC<IdProps>;
 
 declare type IdProps = IncodeModuleProps<IdCaptureConfig, void, IdCaptureManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/identity-reuse.d.ts

@@ -6,6 +6,26 @@ export declare const IdentityReuse: FC<IdentityReuseProps>;
 
 declare type IdentityReuseProps = IncodeModuleProps<IdentityReuseConfig, void, IdentityReuseManager>;
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -19,8 +39,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/phone.d.ts

@@ -2,6 +2,26 @@ import { FC } from 'preact/compat';
 import { PhoneConfig } from '@incodetech/core/phone';
 import { PhoneManager } from '@incodetech/core/phone';
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -15,8 +35,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/qe-signature.d.ts

@@ -1,6 +1,26 @@
 import { FC } from 'preact/compat';
 import { QeSignatureConfig } from '@incodetech/core/qe-signature';
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -14,8 +34,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/selfie.d.ts

@@ -2,6 +2,26 @@ import { FC } from 'preact/compat';
 import { SelfieConfig } from '@incodetech/core/selfie';
 import { SelfieManager } from '@incodetech/core/selfie';
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -15,8 +35,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/signature.d.ts

@@ -1,6 +1,26 @@
 import { FC } from 'preact/compat';
 import { SignatureConfig } from '@incodetech/core/signature';
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -14,8 +34,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/watchlist.d.ts

@@ -1,6 +1,26 @@
 import { FC } from 'preact/compat';
 import { WatchlistConfig } from '@incodetech/core/watchlist';
 
+/**
+ * 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> = {
     /**
      * Module configuration required to render the flow.
@@ -14,8 +34,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/types/workflow.d.ts

@@ -14,6 +14,26 @@ declare type ClientIdSessionBootstrap = {
     clientId: string;
 };
 
+/**
+ * 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.
+ */
+export 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> = {
     /**
      * Module configuration required to render the flow.
@@ -27,8 +47,10 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
      * 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) => void;
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
     /**
      * Callback invoked when a fatal module error occurs.
      *

package/dist/{useModuleLoader-Kt78XfNR.js → useModuleLoader-BNE_xKwo.js}

@@ -289,7 +289,7 @@ var LAZY_UI_MODULES = {
 	ID_CAPTURE: lazyIdModule,
 	TUTORIAL_ID: lazyIdModule,
 	SECOND_ID: lazyIdModule,
-	FACE_MATCH: () => import("./faceMatch-C0-RPzrc.js").then((m) => m.FaceMatch),
+	FACE_MATCH: () => import("./faceMatch-D_uyeaBt.js").then((m) => m.FaceMatch),
 	CURP_VALIDATION: () => import("./curp-validation/curp-validation.es.js").then((m) => m.CurpValidation),
 	GOVT_VALIDATION_PROVISIONING: () => import("./governmentValidation/governmentValidation.es.js").then((m) => m.GovernmentValidation),
 	INE_VALIDATION: () => import("./governmentValidation/governmentValidation.es.js").then((m) => m.GovernmentValidation),

package/dist/workflow/workflow.es.js

@@ -7,7 +7,7 @@ import { t as Page } from "../page-DidH_RkX.js";
 import { t as TransitionSpinner } from "../transitionSpinner-4rPkt-KM.js";
 import { t as AutoFocusTitle } from "../autoFocusTitle-CuRu2lPg.js";
 import { t as registerIncodeModuleElement } from "../incodeModule-M8DszCee.js";
-import { a as resolveApiKey, g as setupSDK, i as HEADLESS_WORKFLOW_MODULE_KEYS, l as LAZY_UI_MODULES, o as extractIncodeStatus, s as UnsupportedModule, t as useModuleLoader, v as fetchAndApplyTheme, y as TerminalErrorPage } from "../useModuleLoader-Kt78XfNR.js";
+import { a as resolveApiKey, g as setupSDK, i as HEADLESS_WORKFLOW_MODULE_KEYS, l as LAZY_UI_MODULES, o as extractIncodeStatus, s as UnsupportedModule, t as useModuleLoader, v as fetchAndApplyTheme, y as TerminalErrorPage } from "../useModuleLoader-BNE_xKwo.js";
 import { resolveWasmConfig, upgradeToWasmHttpClient, warmupWasm } from "@incodetech/core/wasm";
 import { getDeviceClass } from "@incodetech/core/device";
 import { classifyScoreStatus, getTotalScoreStatus } from "@incodetech/core/flow";
@@ -321,8 +321,10 @@ var IncodeWorkflowReady = ({ config, workflowManager: initialManager, onFinish,
 		autoLoad: false,
 		manageLifecycle: false
 	});
+	const moduleKey = workflowState?.status === "ready" ? workflowState.currentNode.moduleKey : void 0;
+	const showFinishScreen = workflowState?.status === "finished" && workflowState.workflowConfig.showFinishScreenBySessionStatus === true;
 	const moduleLoaderState = useModuleLoader({
-		moduleKey: workflowState?.status === "ready" ? workflowState.currentNode.moduleKey : void 0,
+		moduleKey,
 		modules: LAZY_WORKFLOW_MODULES,
 		headlessModuleKeys: HEADLESS_WORKFLOW_MODULE_KEYS,
 		onModuleLoading: config.onModuleLoading,
@@ -335,7 +337,7 @@ var IncodeWorkflowReady = ({ config, workflowManager: initialManager, onFinish,
 		if (workflowState?.status === "finished") {
 			terminalFiredRef.current = true;
 			const finishStatus = workflowState.finishStatus;
-			queueMicrotask(() => onFinish?.(finishStatus));
+			queueMicrotask(() => onFinish?.(finishStatus, { sdkOwnsTerminalScreen: showFinishScreen }));
 			return;
 		}
 		if (workflowState?.status === "asyncResolution") {
@@ -349,10 +351,10 @@ var IncodeWorkflowReady = ({ config, workflowManager: initialManager, onFinish,
 			queueMicrotask(() => onError(error, errorCode, moduleErrorCode));
 		}
 	}, [
-		workflowState?.status,
+		workflowState,
 		onFinish,
 		onError,
-		workflowState
+		showFinishScreen
 	]);
 	const hideSpinnerText = !(config.spinnerConfig?.title || config.spinnerConfig?.subtitle);
 	const renderSpinner = () => /* @__PURE__ */ u("div", {
@@ -381,7 +383,7 @@ var IncodeWorkflowReady = ({ config, workflowManager: initialManager, onFinish,
 		children: /* @__PURE__ */ u(TerminalErrorPage, { message: workflowState.error })
 	});
 	if (workflowState.status === "finished") {
-		if (workflowState.workflowConfig.showFinishScreenBySessionStatus) return /* @__PURE__ */ u("div", {
+		if (showFinishScreen) return /* @__PURE__ */ u("div", {
 			class: "IncodeWorkflow",
 			children: /* @__PURE__ */ u(FinishScreenBySessionStatus, {
 				scoreStatus: workflowState.finishStatus.scoreStatus,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/web",
-  "version": "0.0.0-dev-20260622-1afbb270",
+  "version": "0.0.0-dev-20260623-132ddef6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/IncodeTechnologies/incode-web-sdk.git"
@@ -264,7 +264,7 @@
     "qrcode": "^1.5.4",
     "signature_pad": "^5.1.3",
     "tailwindcss": "^4.1.17",
-    "@incodetech/core": "0.0.0-dev-20260622-1afbb270"
+    "@incodetech/core": "0.0.0-dev-20260623-132ddef6"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.53.3",

package/dist/faceMatch-C0-RPzrc.js

@@ -1,2 +0,0 @@
-import { t as FaceMatch } from "./faceMatch-Dez_bq3n.js";
-export { FaceMatch };