@incodetech/core 2.1.0-rc.1 → 2.1.0-rc.2

package/dist/ekyb.esm.js

@@ -1,19 +1,20 @@
-import "./BrowserTimerProvider-DhNc_x02.esm.js";
-import "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./stats-BMNUG1AU.esm.js";
-import "./IpifyProvider-D4LWD15E.esm.js";
-import "./browserSimulation-B1dWiXp7.esm.js";
-import "./sessionInitializer-DRB-hgbV.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import "./getBrowser-C8DP7oTB.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import "./apiError-B-j-gyDx.esm.js";
-import { a as SUPPORTED_COUNTRIES, i as DEV_ONLY_COUNTRIES, n as toEkybConfig, o as isSupportedCountry, r as ALL_COUNTRIES, t as ekybMachine } from "./ekybStateMachine-klc-AImJ.esm.js";
-import "./addressSearch-DvmWXKZg.esm.js";
-import "./session-DoVb-OcB.esm.js";
-import "./flowServices-ChgTNggJ.esm.js";
+import "./BrowserTimerProvider-BVgutW_b.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./stats-DntyIiGr.esm.js";
+import "./IpifyProvider-oZf7Ke1O.esm.js";
+import "./browserSimulation-CGjpdNA1.esm.js";
+import "./sessionInitializer-CaiGA8GP.esm.js";
+import "./platform-BfoqeM61.esm.js";
+import "./getBrowser-Dv8LZyHE.esm.js";
+import "./tri-CtxWthxz.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import "./apiError-D-GTvFrH.esm.js";
+import { a as SUPPORTED_COUNTRIES, i as DEV_ONLY_COUNTRIES, n as toEkybConfig, o as isSupportedCountry, r as ALL_COUNTRIES, t as ekybMachine } from "./ekybStateMachine-nsuPOw3f.esm.js";
+import "./addressSearch-BH96a3fq.esm.js";
+import "./session-Be_IA1e0.esm.js";
+import "./flowServices-ar5DXv71.esm.js";
 
 //#region src/modules/ekyb/ekybActor.ts
 /**
@@ -26,6 +27,47 @@ function createEkybActor(options) {
 
 //#endregion
 //#region src/modules/ekyb/ekybManager.ts
+/**
+* Maps an eKYB state-machine snapshot to the exact Figma "Tracked
+* Events" screen name. Source: eKYC / eKYB Figma file → Tracked Events
+* canvas
+* (`https://www.figma.com/design/TWgYZVhurQCizfC4tfLEut/eKYC---eKYB---Ready-for-Dev?node-id=2977-10474`).
+* Family is `eKYB.*` and section names are returned verbatim, emitted as-is
+* on `event.screen` by `createManagerInstrumentation` (e.g. `eKYB.default`,
+* `eKYB.processing`). See `docs/patterns/INSTRUMENTATION.md`.
+*
+* Figma sub-states not currently surfaced by the state machine (the form
+* state machine collapses country selection, business details, and UBO
+* entry into a single `form` compound state):
+*
+* - `eKYB.bdetails` (business details, empty) — UI step after country
+*   selection.
+* - `eKYB.filled` (business details filled) — UI sub-state when required
+*   fields have values.
+* - `eKYB.UBO` (empty / filled — the Figma canvas duplicates the section
+*   name for both variants) — UBO entry step.
+*
+* All three collapse onto `eKYB.default` (the country selection / form
+* entry surface). Promoting them requires the state machine to surface
+* step-based sub-states; tracked for a follow-up.
+*
+* `closed` is intentionally unmapped (terminal user-dismissed state —
+* handled by `moduleClosed`).
+*/
+function getEkybScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	switch (stateName) {
+		case "idle":
+		case "loading":
+		case "form": return "eKYB.default";
+		case "submitting": return "eKYB.processing";
+		case "success":
+		case "finished": return "eKYB.success";
+		case "error": return "eKYB.error";
+		default: return;
+	}
+}
 function mapState(snapshot) {
 	const typedSnapshot = snapshot;
 	const { context } = typedSnapshot;
@@ -129,7 +171,7 @@ function createEkybManager(options) {
 		actor: createEkybActor(options),
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.ekyb)
+		instrumentation: createManagerInstrumentation(eventModuleNames.ekyb, { getEventScreenName: getEkybScreenName })
 	});
 }
 

package/dist/{ekybStateMachine-klc-AImJ.esm.js → ekybStateMachine-nsuPOw3f.esm.js}

@@ -1,8 +1,8 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { a as getPostalCodeMaxLength, c as STREET_LEVEL_REQUIRED_ERROR, d as usStateOptions, i as getPostalCodeErrorKey, l as fillFromSuggestion, n as FIXED_DIGIT_POSTAL_CODE_LENGTH, o as validatePostalCode, r as formatPostalCode, s as DYNAMIC_REQUIRED_KEY, t as debounceSearchActor, u as getStreetLevelErrorForSuggestion } from "./addressSearch-DvmWXKZg.esm.js";
-import { t as getFlow } from "./flowServices-ChgTNggJ.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { a as getPostalCodeMaxLength, c as STREET_LEVEL_REQUIRED_ERROR, d as usStateOptions, i as getPostalCodeErrorKey, l as fillFromSuggestion, n as FIXED_DIGIT_POSTAL_CODE_LENGTH, o as validatePostalCode, r as formatPostalCode, s as DYNAMIC_REQUIRED_KEY, t as debounceSearchActor, u as getStreetLevelErrorForSuggestion } from "./addressSearch-BH96a3fq.esm.js";
+import { t as getFlow } from "./flowServices-ar5DXv71.esm.js";
 
 //#region src/modules/ekyb/ekybConstants.ts
 const UBO_INPUT_LIMIT = 8;

package/dist/ekyc.d.ts

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import { a as EkycValidationError, c as AddressSuggestion, i as EkycModuleConfig, n as EkycFieldDef, o as EkycValidationErrors, r as EkycFormValues, t as EkycConfig } from "./types-DvGZI7BF.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { a as EkycValidationError, c as AddressSuggestion, i as EkycModuleConfig, n as EkycFieldDef, o as EkycValidationErrors, r as EkycFormValues, t as EkycConfig } from "./types-DYZja-k9.js";
 
 //#region src/modules/ekyc/ekycStateMachine.d.ts
 declare const ekycMachine: any;
@@ -11,6 +11,7 @@ type CreateEkycActorOptions = {
 };
 //#endregion
 //#region src/modules/ekyc/ekycManager.d.ts
+
 type EkycLoadingState = {
   status: 'loading';
 };

package/dist/ekyc.esm.js

@@ -1,11 +1,11 @@
-import "./BrowserTimerProvider-DhNc_x02.esm.js";
-import "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import "./cpf-BRzggV8G.esm.js";
-import "./addressSearch-DvmWXKZg.esm.js";
-import { n as toEkycConfig, t as ekycMachine } from "./ekycStateMachine-CXbpaJJn.esm.js";
+import "./BrowserTimerProvider-BVgutW_b.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import "./cpf-xBg-DFNn.esm.js";
+import "./addressSearch-BH96a3fq.esm.js";
+import { n as toEkycConfig, t as ekycMachine } from "./ekycStateMachine-DcynX0rj.esm.js";
 
 //#region src/modules/ekyc/ekycActor.ts
 /**
@@ -18,6 +18,51 @@ function createEkycActor(options) {
 
 //#endregion
 //#region src/modules/ekyc/ekycManager.ts
+/**
+* Maps an eKYC state-machine snapshot to the exact Figma "Tracked Events"
+* screen name. Source: eKYC Figma file → Tracked Events canvas
+* (`https://www.figma.com/design/TWgYZVhurQCizfC4tfLEut/eKYC---eKYB---Ready-for-Dev?node-id=2977-10474`).
+* Family is `eKYC.*` and section names are returned verbatim, emitted as-is
+* on `event.screen` by `createManagerInstrumentation` (e.g. `eKYC.filled`,
+* `eKYC.verify`). See `docs/patterns/INSTRUMENTATION.md`.
+*
+* Note the canvas uses `eKYC.filled` for the entry surface (not
+* `eKYC.default`) and `eKYC.verify` for the submit-in-flight surface (the
+* success instance lives inside the verify section).
+*
+* State → screen mapping rationale:
+*
+* - `idle` / `loading` / `prefilling` collapse onto `eKYC.filled` — the
+*   prefill round-trip happens before the user sees the form, but Figma does
+*   not define a dedicated loading/prefill surface (the per-country
+*   `eKYC-empty *` instances in the `eKYC-States` section are visual
+*   references, not analytics screens). Keeping the family on `eKYC.filled`
+*   avoids falling back to a generic `eKYC.loading` default and mixing
+*   taxonomies in dashboards.
+* - `submitting` → `eKYC.verify` (verifying surface).
+* - `success`/`finished` → `eKYC.success` so the terminal `finished` state
+*   stays on the visible success canvas.
+* - `misconfigured` is intentionally unmapped — Figma does not define a
+*   misconfiguration surface, and the misconfigured state is an SDK
+*   configuration error rather than a user-visible journey screen.
+* - `closed` is intentionally unmapped (terminal user-dismissed state —
+*   handled by `moduleClosed`).
+*/
+function getEkycScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	switch (stateName) {
+		case "idle":
+		case "loading":
+		case "prefilling":
+		case "form": return "eKYC.filled";
+		case "submitting": return "eKYC.verify";
+		case "success":
+		case "finished": return "eKYC.success";
+		case "error": return "eKYC.error";
+		default: return;
+	}
+}
 function mapState(snapshot) {
 	const typedSnapshot = snapshot;
 	const { context } = typedSnapshot;
@@ -101,7 +146,7 @@ function createEkycManager(options) {
 		actor: createEkycActor(options),
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.ekyc)
+		instrumentation: createManagerInstrumentation(eventModuleNames.ekyc, { getEventScreenName: getEkycScreenName })
 	});
 }
 

package/dist/{ekycStateMachine-CXbpaJJn.esm.js → ekycStateMachine-DcynX0rj.esm.js}

@@ -1,8 +1,8 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { t as validateCPF } from "./cpf-BRzggV8G.esm.js";
-import { a as getPostalCodeMaxLength, c as STREET_LEVEL_REQUIRED_ERROR, d as usStateOptions, i as getPostalCodeErrorKey, l as fillFromSuggestion, n as FIXED_DIGIT_POSTAL_CODE_LENGTH, o as validatePostalCode, r as formatPostalCode, s as DYNAMIC_REQUIRED_KEY, t as debounceSearchActor, u as getStreetLevelErrorForSuggestion } from "./addressSearch-DvmWXKZg.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as validateCPF } from "./cpf-xBg-DFNn.esm.js";
+import { a as getPostalCodeMaxLength, c as STREET_LEVEL_REQUIRED_ERROR, d as usStateOptions, i as getPostalCodeErrorKey, l as fillFromSuggestion, n as FIXED_DIGIT_POSTAL_CODE_LENGTH, o as validatePostalCode, r as formatPostalCode, s as DYNAMIC_REQUIRED_KEY, t as debounceSearchActor, u as getStreetLevelErrorForSuggestion } from "./addressSearch-BH96a3fq.esm.js";
 
 //#region src/modules/ekyc/ekycConsts.ts
 const COUNTRY_SELECTOR_DISABLED_SOURCES = ["UK_VOTER_REGISTER"];

package/dist/electronic-signature.d.ts

@@ -1,4 +1,4 @@
-import "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import { a as AE_CONSENT_KEYS, c as ConsentKey, d as ElectronicSignatureVariant, f as QE_CONSENT_KEYS, g as getDefaultConsentChecks, h as getConsentKeys, i as electronicSignatureMachine, l as ElectronicSignatureConfig, m as areAllConsented, n as ElectronicSignatureState, o as AeConsentKey, p as QeConsentKey, r as createElectronicSignatureManager, s as ConsentChecks, t as ElectronicSignatureManager, u as ElectronicSignatureDocument } from "./index-B9NysVDB.js";
+import "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { a as AE_CONSENT_KEYS, c as ConsentKey, d as ElectronicSignatureVariant, f as QE_CONSENT_KEYS, g as getDefaultConsentChecks, h as getConsentKeys, i as electronicSignatureMachine, l as ElectronicSignatureConfig, m as areAllConsented, n as ElectronicSignatureState, o as AeConsentKey, p as QeConsentKey, r as createElectronicSignatureManager, s as ConsentChecks, t as ElectronicSignatureManager, u as ElectronicSignatureDocument } from "./index-DV134v62.js";
 export { AE_CONSENT_KEYS, AeConsentKey, ConsentChecks, ConsentKey, ElectronicSignatureConfig, ElectronicSignatureDocument, ElectronicSignatureManager, ElectronicSignatureState, ElectronicSignatureVariant, QE_CONSENT_KEYS, QeConsentKey, areAllConsented, createElectronicSignatureManager, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };

package/dist/electronic-signature.esm.js

@@ -1,8 +1,10 @@
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./xstate.esm-C9wncMQa.esm.js";
-import "./apiError-B-j-gyDx.esm.js";
-import { a as areAllConsented, i as QE_CONSENT_KEYS, n as electronicSignatureMachine, o as getConsentKeys, r as AE_CONSENT_KEYS, s as getDefaultConsentChecks, t as createElectronicSignatureManager } from "./electronicSignatureManager-BaECdJ1u.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./xstate.esm-Dkm1jy5u.esm.js";
+import "./apiError-D-GTvFrH.esm.js";
+import "./urlUtils-8RNHyW3x.esm.js";
+import "./externalFetch-crimxkN9.esm.js";
+import { a as areAllConsented, i as QE_CONSENT_KEYS, n as electronicSignatureMachine, o as getConsentKeys, r as AE_CONSENT_KEYS, s as getDefaultConsentChecks, t as createElectronicSignatureManager } from "./electronicSignatureManager-B63aAuI5.esm.js";
 
 export { AE_CONSENT_KEYS, QE_CONSENT_KEYS, areAllConsented, createElectronicSignatureManager, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };

package/dist/{electronicSignatureManager-BaECdJ1u.esm.js → electronicSignatureManager-B63aAuI5.esm.js}

@@ -1,22 +1,10 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { n as toIncodeApiError, t as IncodeApiError } from "./apiError-B-j-gyDx.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as toIncodeApiError, t as IncodeApiError } from "./apiError-D-GTvFrH.esm.js";
+import { t as externalFetch } from "./externalFetch-crimxkN9.esm.js";
 
-//#region ../infra/src/http/externalFetch.ts
-async function externalFetch(config) {
-	const res = await fetch(config.url, {
-		method: config.method,
-		headers: config.headers,
-		body: config.body,
-		signal: config.signal
-	});
-	if (!res.ok) throw new Error(`${config.method} ${config.url} failed: ${res.status} ${res.statusText}`);
-	return res;
-}
-
-//#endregion
 //#region src/modules/electronic-signature/electronicSignatureServices.ts
 async function fetchUnsignedDocuments(signal) {
 	const res = await api.get(endpoints.aesUnsignedDocuments, { signal });
@@ -381,6 +369,96 @@ function createElectronicSignatureActor(options) {
 
 //#endregion
 //#region src/modules/electronic-signature/electronicSignatureManager.ts
+/**
+* Maps an Advanced Electronic Signature (AE) state-machine snapshot to the
+* exact Figma "Tracked Events" screen name from the AES canvas
+* (`https://www.figma.com/design/XHmDxd98n66Rg5OyPJMP93/Signature--QES-AES-?node-id=6359-51995`).
+* Family is `AdSign.*`. The mapper returns Figma-verbatim section names
+* which the adapter emits as-is on `event.screen` (e.g.
+* `AdSign.AcceptSign.default`, `AdSign.uploadDocument.default`). See
+* `docs/patterns/INSTRUMENTATION.md`.
+*
+* Figma sub-states the state machine does not surface as discrete states and
+* therefore not part of this mapping (they collapse into the section's
+* primary screen until the SM surfaces them):
+*
+* - `AdSign.AcceptSign.selectedCheckox` — UI sub-state of `signing` (all
+*   consents checked). Context-driven via `context.consentChecks`.
+* - `AdSign.AcceptSign.loadingsign` — visual loading variant of `signing`
+*   right after the user taps Sign; the SM transitions straight to
+*   `processing` so this surface collapses into `AdSign.AcceptSign.default`.
+* - `AdSign.AcceptSign.viewdoc` — UI sub-state of `signing` while
+*   `context.viewingDocumentUrl` is set.
+*
+* `failed` is mapped to `AdSign.AcceptSign.error` — the host owns recovery
+* for terminal failures, but the last visible analytics surface stays on the
+* accept-and-sign error screen to keep dashboards consistent with `error`.
+* `closed` is intentionally unmapped (terminal user-dismissed state —
+* handled by `moduleClosed`).
+*/
+function getAdSignatureScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	switch (stateName) {
+		case "idle":
+		case "uploading": return "AdSign.uploadDocument.default";
+		case "reviewing":
+		case "generatingUploadUrl":
+		case "uploadingFile": return "AdSign.reviewDoc.default";
+		case "fetchingDocs":
+		case "signing": return "AdSign.AcceptSign.default";
+		case "processing": return "AdSign.AcceptSign.processing";
+		case "success":
+		case "successDownload":
+		case "finished": return "AdSign.success";
+		case "error":
+		case "failed": return "AdSign.AcceptSign.error";
+		default: return;
+	}
+}
+/**
+* Maps a Qualified Electronic Signature (QE) state-machine snapshot to the
+* exact Figma screen name. Source canvas spans two pages of the QES file
+* (`https://www.figma.com/design/XO9YGKlEsGUyag8CGbSUsi/Qualified-Signature---latest-design?node-id=6086-28669`).
+* Family is `QSign.*`. The mapper returns Figma-verbatim section names
+* which the adapter emits as-is on `event.screen` (e.g.
+* `QSign.AcceptSign.default`, `QSign.review.default`). See
+* `docs/patterns/INSTRUMENTATION.md`. Note QES uses `QSign.review.*` (vs
+* AES's `AdSign.reviewDoc.*`) for the review surface.
+*
+* Figma sub-states the state machine does not surface as discrete states and
+* therefore not part of this mapping:
+*
+* - `QSign.uploadDocument.select` — visual variant of `uploading` shown
+*   while a file is being picked. The SM stays in `uploading` until
+*   `SELECT_FILE` lands; this sub-state collapses into the default.
+* - `QSign.AcceptSign.{selectedCheckox,loadingsign,viewdoc}` — same UI
+*   sub-states as AES (consent checked / signing in flight / viewing doc).
+*
+* `failed` is mapped to `QSign.AcceptSign.error` for the same reason as AES
+* (host owns recovery, but the last visible surface stays on the error
+* screen). `closed` is intentionally unmapped.
+*/
+function getQSignatureScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	switch (stateName) {
+		case "idle":
+		case "uploading": return "QSign.uploadDocument.default";
+		case "reviewing":
+		case "generatingUploadUrl":
+		case "uploadingFile": return "QSign.review.default";
+		case "fetchingDocs":
+		case "signing": return "QSign.AcceptSign.default";
+		case "processing": return "QSign.AcceptSign.processing";
+		case "success":
+		case "successDownload":
+		case "finished": return "QSign.success";
+		case "error":
+		case "failed": return "QSign.AcceptSign.error";
+		default: return;
+	}
+}
 function mapState(snapshot) {
 	const { context } = snapshot;
 	if (snapshot.matches("idle") || snapshot.matches("fetchingDocs") || snapshot.matches("generatingUploadUrl") || snapshot.matches("uploadingFile")) return { status: "loading" };
@@ -478,17 +556,19 @@ function createApi({ actor, trackElementClicked, fileDataRef }) {
 }
 function createElectronicSignatureManager(options) {
 	const fileDataRef = { current: null };
+	const actor = createElectronicSignatureActor({
+		config: options.config,
+		getFileData: () => fileDataRef.current
+	});
+	const isQualified = options.config.variant === "qe";
 	return createManager({
-		actor: createElectronicSignatureActor({
-			config: options.config,
-			getFileData: () => fileDataRef.current
-		}),
+		actor,
 		mapState,
 		createApi: (apiOptions) => createApi({
 			...apiOptions,
 			fileDataRef
 		}),
-		instrumentation: createManagerInstrumentation(options.config.variant === "qe" ? eventModuleNames.qeSignature : eventModuleNames.aeSignature)
+		instrumentation: createManagerInstrumentation(isQualified ? eventModuleNames.qeSignature : eventModuleNames.aeSignature, { getEventScreenName: isQualified ? getQSignatureScreenName : getAdSignatureScreenName })
 	});
 }
 

package/dist/email.d.ts

@@ -1,5 +1,5 @@
-import "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import { n as EmailState, o as emailMachine, r as createEmailManager, s as EmailConfig, t as EmailManager } from "./emailManager-lAzDoQOs.js";
-import "./otp-DF5A0sFx.js";
+import "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { n as EmailState, o as emailMachine, r as createEmailManager, s as EmailConfig, t as EmailManager } from "./emailManager-C6D2u4mQ.js";
+import "./otp-BHJnjEEc.js";
 export { type EmailConfig, type EmailManager, type EmailState, createEmailManager, emailMachine };

package/dist/email.esm.js

@@ -1,10 +1,10 @@
-import "./BrowserTimerProvider-DhNc_x02.esm.js";
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./xstate.esm-C9wncMQa.esm.js";
-import { t as emailMachine } from "./emailStateMachine-CxTOMAjC.esm.js";
-import "./otp-CGMdUzBC.esm.js";
-import { t as createEmailManager } from "./emailManager--D5G3ChB.esm.js";
+import "./BrowserTimerProvider-BVgutW_b.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as emailMachine } from "./emailStateMachine-758f34gg.esm.js";
+import "./otp-D87RTwrx.esm.js";
+import { t as createEmailManager } from "./emailManager-DxHjAe5u.esm.js";
 
 export { createEmailManager, emailMachine };

package/dist/{emailManager-lAzDoQOs.d.ts → emailManager-C6D2u4mQ.d.ts}

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import { t as ActorRefFrom } from "./Actor-Y0_Fj-KL.js";
-import { t as OtpValidationErrors } from "./otp-DF5A0sFx.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import { t as ActorRefFrom } from "./Actor-fIPLXfoi.js";
+import { t as OtpValidationErrors } from "./otp-BHJnjEEc.js";
 
 //#region src/modules/email/types.d.ts
 
@@ -66,6 +66,7 @@ type CreateEmailActorOptions = {
 type EmailActor = ActorRefFrom<EmailMachine>;
 //#endregion
 //#region src/modules/email/emailManager.d.ts
+
 /** Email manager is in initial state, waiting for `load()` to be called */
 type EmailIdleState = {
   status: 'idle';

package/dist/{emailManager--D5G3ChB.esm.js → emailManager-DxHjAe5u.esm.js}

@@ -1,7 +1,7 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import { t as emailMachine } from "./emailStateMachine-CxTOMAjC.esm.js";
-import { t as OTP_CODE_LENGTH } from "./otp-CGMdUzBC.esm.js";
+import { n as eventModuleNames, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as emailMachine } from "./emailStateMachine-758f34gg.esm.js";
+import { t as OTP_CODE_LENGTH } from "./otp-D87RTwrx.esm.js";
 
 //#region src/modules/email/emailActor.ts
 function createEmailActor(options) {
@@ -97,6 +97,46 @@ function createEmailActor(options) {
 * }, 100);
 * ```
 */
+/**
+* Maps an Email state-machine snapshot to the exact Figma "Tracked Events"
+* screen name. Returned strings are the absolute analytics screen (module
+* prefix included) and are emitted verbatim by
+* `createManagerInstrumentation`'s `getEventScreenName` short-circuit.
+*
+* Source of truth: Email Input Module Figma file → Tracked Events canvas
+* (`https://www.figma.com/design/IovIhDAPjR7zxjC4NKZzfq/Email-Input-Module?node-id=3031-82920`).
+*
+* Figma screens that have no dedicated state-machine counterpart yet
+* (intentionally not mapped here — they collapse into the section's primary
+* screen until the SM surfaces them):
+*
+* - `email.verifyEmail.typing` / `email.verifyEmail.filled` — UI sub-states of `inputting`.
+* - `email.verifyEmail.error` — UI surface of inline validation error on `inputting`.
+* - `email.OTP.filled` — UI sub-state of `awaitingOtp`.
+*
+* Terminal SM `error` is mapped to `email.error.somethingWentWrong`, and
+* `finished` is mapped to `email.success` so the adapter never falls back to
+* the generic `<module>.finished` / `<module>.error` defaults.
+*/
+function getEmailScreenName(snapshot) {
+	const { value } = snapshot;
+	if (typeof value !== "string") return void 0;
+	switch (value) {
+		case "idle":
+		case "inputting":
+		case "validatingSubmit": return "email.verifyEmail.default";
+		case "loadingPrefill":
+		case "submitting": return "email.verifyEmail.loading";
+		case "sendingInitialOtp":
+		case "resendingOtp": return "email.OTP.loading";
+		case "awaitingOtp": return "email.OTP.typing";
+		case "verifyingOtp": return "email.OTP.processing";
+		case "otpError": return "email.OTP.error";
+		case "finished": return "email.success";
+		case "error": return "email.error.somethingWentWrong";
+		default: return;
+	}
+}
 function mapState(snapshot) {
 	const typedSnapshot = snapshot;
 	const { context } = typedSnapshot;
@@ -245,7 +285,7 @@ function createEmailManager(options) {
 		actor: createEmailActor(options),
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.email)
+		instrumentation: createManagerInstrumentation(eventModuleNames.email, { getEventScreenName: getEmailScreenName })
 	});
 }
 function createEmailManagerFromActor(actor) {
@@ -253,7 +293,7 @@ function createEmailManagerFromActor(actor) {
 		actor,
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.email)
+		instrumentation: createManagerInstrumentation(eventModuleNames.email, { getEventScreenName: getEmailScreenName })
 	});
 }
 

package/dist/{emailStateMachine-CxTOMAjC.esm.js → emailStateMachine-758f34gg.esm.js}

@@ -1,8 +1,8 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-DhNc_x02.esm.js";
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, i as fromCallback, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { n as computeOtpValidationErrors, r as isOtpComplete } from "./otp-CGMdUzBC.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BVgutW_b.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, i as fromCallback, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as computeOtpValidationErrors, r as isOtpComplete } from "./otp-D87RTwrx.esm.js";
 
 //#region src/modules/email/emailServices.ts
 function getEmailServerFailureReason(error, invalidStatus) {

package/dist/{endpoints-BeTK0Mlt.esm.js → endpoints-BM2_j_IE.esm.js}

@@ -60,6 +60,7 @@ const endpoints = {
 	documentLegacy: "/omni/add/document",
 	cfdi: "/omni/process/cfdi",
 	finishStatus: "/omni/finish-status",
+	sessionTotalScoreStatus: "/omni/session/total-score-status",
 	updateSession: "/omni/update",
 	onboardingUrl: "/omni/onboarding-url",
 	sendRedirectSms: "/omni/notify/send-sms",
@@ -83,6 +84,7 @@ const endpoints = {
 	customModuleExecution: "/omni/custom-module/execution",
 	processCrossDocumentDataMatch: "/omni/cross-doc-data-check/process",
 	dynamicFormsSubmitAnswer: "/omni/form-answer/submit",
+	certificateIssuanceIssue: "/omni/es/process/issueCertificate",
 	addFiscalQrLink: "/omni/add/fiscal-qr-url"
 };