@incodetech/web 2.0.1 → 2.1.0-rc.0

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

@@ -27,8 +27,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/antifraud.d.ts

@@ -1,9 +1,10 @@
 import { AntifraudConfig } from '@incodetech/core/antifraud';
+import { AntifraudManager } from '@incodetech/core/antifraud';
 import { FC } from 'preact/compat';
 
 export declare const Antifraud: FC<AntifraudProps>;
 
-declare type AntifraudProps = IncodeModuleProps<AntifraudConfig>;
+declare type AntifraudProps = IncodeModuleProps<AntifraudConfig, void, AntifraudManager>;
 
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
@@ -27,14 +28,19 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }
 
 declare global {
     interface HTMLElementTagNameMap {
-        'incode-antifraud': HTMLElement & IncodeModuleProps<AntifraudConfig>;
+        'incode-antifraud': HTMLElement & IncodeModuleProps<AntifraudConfig,
+  void,
+  AntifraudManager>;
     }
 }

package/dist/types/authentication.d.ts

@@ -30,8 +30,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/consent.d.ts

@@ -28,8 +28,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/cpf-ocr.d.ts

@@ -0,0 +1,12 @@
+import { CpfOcrManager } from '@incodetech/core/cpf-ocr';
+import { FC } from 'preact/compat';
+
+export declare const CpfOcr: FC<CpfOcrProps>;
+
+declare type CpfOcrProps = {
+    manager?: CpfOcrManager;
+    onFinish?: () => void;
+    onError?: (error: string | undefined) => void;
+};
+
+export { }

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

@@ -27,8 +27,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

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

@@ -1,9 +1,10 @@
 import { CurpValidationConfig } from '@incodetech/core/curp-validation';
+import { CurpValidationManager } from '@incodetech/core/curp-validation';
 import { FC } from 'preact/compat';
 
 export declare const CurpValidation: FC<CurpValidationProps>;
 
-declare type CurpValidationProps = IncodeModuleProps<CurpValidationConfig>;
+declare type CurpValidationProps = IncodeModuleProps<CurpValidationConfig, void, CurpValidationManager>;
 
 declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     /**
@@ -27,14 +28,19 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }
 
 declare global {
     interface HTMLElementTagNameMap {
-        'incode-curp-validation': HTMLElement & IncodeModuleProps<CurpValidationConfig>;
+        'incode-curp-validation': HTMLElement & IncodeModuleProps<CurpValidationConfig,
+  void,
+  CurpValidationManager>;
     }
 }

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

@@ -0,0 +1,37 @@
+import { DocumentCaptureConfig } from '@incodetech/core/document-capture';
+import { FC } from 'preact/compat';
+
+export declare const DocumentCapture: FC<DocumentCaptureProps>;
+
+declare type DocumentCaptureProps = IncodeModuleProps<DocumentCaptureConfig>;
+
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * 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
+     */
+    onFinish?: (result?: TResult) => 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.
+     */
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
+};
+
+export { }

package/dist/types/ekyb.d.ts

@@ -27,8 +27,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/ekyc.d.ts

@@ -27,8 +27,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

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

@@ -30,8 +30,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/email.d.ts

@@ -54,8 +54,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/extensibility.d.ts

@@ -273,6 +273,7 @@ ref?: Ref<HTMLInputElement> | undefined;
 declare type DateInputComposedProps = Omit<InputComposedProps, 'type' | 'closeButton' | 'rightIcon'> & {
     value: string;
     onInput: (e: Event) => void;
+    onBlur?: (e: FocusEvent) => void;
 };
 
 export declare const DropdownComposed: FC<DropdownComposedProps>;
@@ -450,8 +451,11 @@ export declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknow
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 declare type InferState<T> = T extends {
@@ -496,7 +500,7 @@ declare type LockIconProps = {
     className?: string;
 };
 
-export declare function Lottie({ animationData, loop, autoplay, reverse, style, className, onComplete, onControlsReady, }: LottieProps): JSX.Element;
+export declare function Lottie({ animationData, loop, autoplay, reverse, style, className, onComplete, autoStop, stopFramePosition, }: LottieProps): JSX.Element;
 
 declare type LottieAnimationData = {
     fr: number;
@@ -507,16 +511,6 @@ declare type LottieAnimationData = {
     h: number;
 };
 
-declare type LottieControls = {
-    setSpeed: (speed: number) => void;
-    play: () => void;
-    pause: () => void;
-    stop: () => void;
-    goToAndPlay: (value: number, isFrame?: boolean) => void;
-    goToAndStop: (value: number, isFrame?: boolean) => void;
-    getTotalFrames: () => number | null;
-};
-
 declare type LottieProps = {
     animationData: LottieAnimationData;
     loop?: boolean;
@@ -525,9 +519,19 @@ declare type LottieProps = {
     style?: CSSProperties;
     className?: string;
     onComplete?: () => void;
-    onControlsReady?: (controls: LottieControls | null) => void;
+    /** Auto-stop the animation after 5s (WCAG 2.2 AA 2.2.2). */
+    autoStop?: boolean;
+    /**
+     * Where to freeze the animation when `autoStop` fires. When omitted the
+     * animation is paused at its current frame; otherwise it jumps to and stops
+     * at the resolved frame (falling back to a full stop when the frame count is
+     * unknown).
+     */
+    stopFramePosition?: LottieStopFramePosition;
 };
 
+declare type LottieStopFramePosition = 'first' | 'middle' | 'last';
+
 export declare const ManualCapture: FC<ManualCaptureProps>;
 
 declare type ManualCaptureProps = {
@@ -590,7 +594,7 @@ declare type ModalRootProps = {
     portalContainer?: HTMLElement | null;
     class?: string;
     hasBackdrop?: boolean;
-    /** When false, Modal won't auto-focus the first interactive element on open. Defaults to true. */
+    /** When false, Modal won't move focus to the title (or dialog) on open. Defaults to true. */
     manageInitialFocus?: boolean;
     returnFocusRef?: RefObject<HTMLElement | null>;
 };
@@ -621,10 +625,16 @@ declare type ModalTitleSectionProps = {
 export declare const OtpInput: FC<OtpInputProps>;
 
 declare type OtpInputProps = {
+    value: string;
+    otpLength: number;
     resendTimer: number;
     canResend: boolean;
     error?: string;
+    validationError?: string;
+    isValid?: boolean;
     onSubmit: (code: string) => void;
+    onChange: (code: string) => void;
+    onValidate?: () => void;
     onResend: () => void;
     onBack: () => void;
     /**
@@ -646,7 +656,7 @@ declare type OverlayProps = {
     class?: string;
 };
 
-export declare const Page: ({ title, titleId, subtitle, titleTopSlot, className, logo, children, hideHeader, hideFooterBranding, "data-testid": dataTestId, "data-permission-status": dataPermissionStatus, }: PageProps) => JSX.Element;
+export declare const Page: ({ title, titleId, subtitle, titleTopSlot, className, logo, children, hideHeader, hideFooterBranding, footerBrandingSlot, "data-testid": dataTestId, "data-permission-status": dataPermissionStatus, }: PageProps) => JSX.Element;
 
 declare type PageProps = {
     children?: ComponentChildren;
@@ -663,6 +673,7 @@ declare type PageProps = {
     hideFooterBranding?: boolean;
     hideHeader?: boolean;
     closeButton?: CloseButtonOptions;
+    footerBrandingSlot?: ComponentChildren;
     'data-testid'?: string;
     'data-permission-status'?: string;
 };
@@ -695,6 +706,13 @@ declare type PhoneInputOwnProps = {
     value?: string;
     placeholder?: string;
     error?: string;
+    /**
+     * When `true` and an `error` is present, the country-specific format example
+     * is appended to the error (unspaced for sighted users, digit-spaced for
+     * screen readers) so the `role="alert"` suggests the expected format
+     * (WCAG 2.2 SC 3.3.3). Requires `formatHintBuilder` to be set.
+     */
+    showFormatHintInError?: boolean;
     helper?: string;
     showErrorIcon?: boolean;
     showHelperIcon?: boolean;
@@ -702,6 +720,11 @@ declare type PhoneInputOwnProps = {
     disableCountrySelector?: boolean;
     required?: boolean;
     onChange?: (fullNumber: string, isValid: boolean) => void;
+    formatHintBuilder?: (example: string) => string | undefined;
+    countryAriaLabelBuilder?: (args: {
+        callingCode: string;
+        countryName: string;
+    }) => string | undefined;
     'aria-labelledby'?: string;
     'data-testid'?: string;
 };
@@ -714,6 +737,7 @@ declare type ProgressBarProps = {
     progress: number;
     label?: string;
     className?: string;
+    labelledById?: string;
 };
 
 export declare const RadioButtonComposed: FunctionalComponent<PropsWithoutRef<RadioButtonComposedProps> & {
@@ -970,6 +994,7 @@ declare type VerificationResultProps = {
     retryLabel?: string;
     skipLabel?: string;
     hideFooterBranding?: boolean;
+    footerBrandingSlot?: ComponentChildren;
 };
 
 export declare const WarningIcon: FC<WarningIconProps>;

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

@@ -52,8 +52,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

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

@@ -0,0 +1,38 @@
+import { FC } from 'preact/compat';
+import { FieldComparisonConfig } from '@incodetech/core/field-comparison';
+import { FieldComparisonManager } from '@incodetech/core/field-comparison';
+
+export declare const FieldComparison: FC<FieldComparisonProps>;
+
+declare type FieldComparisonProps = IncodeModuleProps<FieldComparisonConfig, void, FieldComparisonManager>;
+
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * 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
+     */
+    onFinish?: (result?: TResult) => 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.
+     */
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
+};
+
+export { }

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

@@ -0,0 +1,43 @@
+import { FC } from 'preact/compat';
+import { FiscalQrConfig } from '@incodetech/core/fiscal-qr';
+
+export declare const FiscalQr: FC<FiscalQrProps>;
+
+declare type FiscalQrProps = IncodeModuleProps<FiscalQrConfig>;
+
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * 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
+     */
+    onFinish?: (result?: TResult) => 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.
+     */
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
+};
+
+export { }
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'incode-fiscal-qr': HTMLElement & IncodeModuleProps<FiscalQrConfig>;
+    }
+}

package/dist/types/flow.d.ts

@@ -71,8 +71,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 /**
@@ -100,7 +103,7 @@ declare type SelfLoadingFlowRuntimeConfig = FlowBaseConfig & SelfLoadingSessionO
     token?: never;
 };
 
-declare type SelfLoadingSessionOptions = Pick<CreateSessionOptions, 'configurationId' | 'externalId' | 'externalCustomerId' | 'customFields' | 'uuid' | 'urlUuid' | 'interviewId'>;
+declare type SelfLoadingSessionOptions = Pick<CreateSessionOptions, 'configurationId' | 'externalId' | 'externalCustomerId' | 'customFields' | 'uuid' | 'urlUuid' | 'interviewId' | 'loginHint'>;
 
 declare type SpinnerConfig = {
     title?: string;

package/dist/types/geolocation.d.ts

@@ -28,8 +28,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/governmentValidation.d.ts

@@ -27,8 +27,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

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

@@ -27,8 +27,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/id.d.ts

@@ -28,8 +28,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

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

@@ -28,8 +28,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export { }

package/dist/types/index.d.ts

@@ -1,15 +1,28 @@
 import { DEFAULT_WASM_VERSION } from '@incodetech/core/wasm';
-import { I18nOptions } from './setup';
+import { i18n } from 'i18next';
 import { WasmConfig } from '@incodetech/core/wasm';
 
+export declare function createI18n(options?: I18nOptions): i18n;
+
 export { DEFAULT_WASM_VERSION }
 
+export declare type I18nOptions = {
+    lang?: string;
+    loadPath?: string;
+    skipRemoteLoad?: boolean;
+    translations?: Translations;
+};
+
+declare type LanguageTranslations = Record<string, TranslationValue>;
+
+export declare function setI18nInstance(instance: i18n): void;
+
 /**
  * Sets global UI configuration defaults for `@incodetech/ui`.
  */
 export declare function setUiConfig(next: UiConfig): void;
 
-export declare function setup({ apiURL, token, customHeaders, timeout, wasm, i18n, uiConfig, }: SetupOptions): Promise<void>;
+export declare function setup({ apiURL, token, customHeaders, timeout, wasm, ipLookup, i18n, uiConfig, }: SetupOptions): Promise<void>;
 
 declare type SetupOptions = {
     apiURL: string;
@@ -17,10 +30,15 @@ declare type SetupOptions = {
     customHeaders?: Record<string, string>;
     timeout?: number;
     wasm?: WasmConfig | false;
+    ipLookup?: boolean;
     i18n?: I18nOptions;
     uiConfig?: UiConfig;
 };
 
+declare type Translations = Partial<Record<string, LanguageTranslations>>;
+
+declare type TranslationValue = string | Record<string, unknown>;
+
 export declare type UiConfig = {
     logoSrc?: string;
     logoHeight?: string;

package/dist/types/phone.d.ts

@@ -24,8 +24,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 /**

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

@@ -23,8 +23,11 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
      * @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.
      */
-    onError?: (error: string | undefined, errorCode?: number) => void;
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
 export declare const QeSignature: FC<QeSignatureModuleProps>;