@incodetech/core 2.0.0-alpha.8 → 2.0.0-rc.0

package/dist/ekyc.d.ts

@@ -0,0 +1,164 @@
+import { t as Manager } from "./Manager-C8PrhBOx.js";
+import "./Actor-CI32dTbG.js";
+import { n as AddressSuggestion, r as FieldDef, t as DisplayErrorsResult } from "./displayErrors-DqJ_IbsG.js";
+
+//#region src/modules/ekyc/types.d.ts
+type EkycFieldSource = 'user_input' | 'document_scan' | 'poa_document' | 'phone_module_input' | 'email_module_input' | false;
+type EkycVerificationFields = {
+  name?: EkycFieldSource;
+  address?: EkycFieldSource;
+  phone?: EkycFieldSource;
+  email?: EkycFieldSource;
+  SSN?: EkycFieldSource;
+  taxId?: EkycFieldSource;
+  nationality?: EkycFieldSource;
+  'date of birth'?: EkycFieldSource;
+  dlNumber?: EkycFieldSource;
+  dlState?: EkycFieldSource;
+  dlExpireAt?: EkycFieldSource;
+  last4SSN?: EkycFieldSource;
+  idNum?: EkycFieldSource;
+  idNum1?: EkycFieldSource;
+  gender?: EkycFieldSource;
+  panNumber?: EkycFieldSource;
+};
+type EkycModuleConfig = {
+  source: string;
+  enablePhoneRisk?: boolean;
+  checkName?: boolean;
+  nameSource?: string;
+  checkEmail?: boolean;
+  emailSource?: string;
+  checkAddress?: boolean;
+  addressSource?: string;
+  checkPhone?: boolean;
+  phoneSource?: string;
+  checkSsn?: boolean;
+  ssnSource?: string;
+  checkDob?: boolean;
+  dobSource?: string;
+  checkNationality?: boolean;
+  nationalitySource?: string;
+  checkDlNumber?: boolean;
+  dlNumberSource?: string;
+  checkDlState?: boolean;
+  dlStateSource?: string;
+  checkDlExpireAt?: boolean;
+  dlExpireAtSource?: string;
+  checkLast4SSN?: boolean;
+  last4SSNSource?: string;
+  checkIdNum?: boolean;
+  idNumSource?: string;
+  checkIdNum1?: boolean;
+  idNum1Source?: string;
+  checkGender?: boolean;
+  genderSource?: string;
+  checkPanNumber?: boolean;
+  panNumberSource?: string;
+};
+type EkycFormValues = Record<string, string | undefined>;
+/** Manager creation config */
+type EkycConfig = {
+  flowId?: string;
+  verificationFields?: EkycVerificationFields;
+  source?: string;
+  fieldsCountry?: string;
+  enablePhoneRisk?: boolean;
+};
+type EkycFieldDef = FieldDef & {
+  source: EkycFieldSource;
+};
+//#endregion
+//#region src/modules/ekyc/ekycStateMachine.d.ts
+declare const ekycMachine: any;
+//#endregion
+//#region src/modules/ekyc/ekycActor.d.ts
+type CreateEkycActorOptions = {
+  config: EkycConfig;
+};
+//#endregion
+//#region src/modules/ekyc/ekycManager.d.ts
+type EkycLoadingState = {
+  status: 'loading';
+};
+type EkycFormState = {
+  status: 'form';
+  fields: EkycFieldDef[];
+  values: EkycFormValues;
+  errors: Record<string, string>;
+  isValid: boolean;
+  addressSuggestions: AddressSuggestion[];
+  prefilled: Record<string, boolean>;
+  hideEmail: boolean;
+  fieldsCountry: string;
+  submitError: string;
+  submitAttempted: boolean;
+};
+type EkycSubmittingState = {
+  status: 'submitting';
+};
+type EkycSuccessState = {
+  status: 'success';
+};
+type EkycErrorState = {
+  status: 'error';
+  errorMessage: string;
+};
+type EkycMisconfiguredState = {
+  status: 'misconfigured';
+};
+type EkycFinishedState = {
+  status: 'finished';
+};
+type EkycClosedState = {
+  status: 'closed';
+};
+/**
+ * Discriminated union of all possible eKYC manager states.
+ */
+type EkycState = EkycLoadingState | EkycFormState | EkycSubmittingState | EkycSuccessState | EkycErrorState | EkycMisconfiguredState | EkycFinishedState | EkycClosedState;
+/**
+ * Creates an eKYC manager for headless or UI-driven usage.
+ */
+declare function createEkycManager(options: CreateEkycActorOptions): Manager<EkycState> & {
+  /** Initializes the eKYC flow — fetches config and pre-fill data */
+  load(): void;
+  /** Sets a form field value and triggers revalidation */
+  setField(name: string, value: string): void;
+  /** Initiates a debounced address autocomplete search */
+  searchAddress(query: string): void;
+  /** Selects an address suggestion and populates address fields */
+  selectAddress(suggestion: AddressSuggestion): void;
+  /** Submits the form (requires isValid to be true) */
+  submit(): void;
+  /** Retries from failure state, returning to the form */
+  retry(): void;
+  /** Skips verification from failure state */
+  skip(): void;
+  /** Closes/dismisses the module */
+  close(): void;
+};
+type EkycManager = ReturnType<typeof createEkycManager>;
+//#endregion
+//#region src/modules/ekyc/ekycActions.d.ts
+declare function computeDisplayErrors(errors: Record<string, string>, touched: Record<string, boolean>, submitAttempted: boolean, country: string, fields?: EkycFieldDef[]): DisplayErrorsResult;
+//#endregion
+//#region src/modules/ekyc/ekycUtils.d.ts
+/**
+ * Normalizes any supported eKYC config input into a manager-ready `EkycConfig`.
+ *
+ * Accepts either:
+ *  - A manager-ready `EkycConfig` (with `flowId` or `verificationFields`) →
+ *    returned unchanged.
+ *  - A raw backend `EkycModuleConfig` (with `source` + `check*` / `*Source`
+ *    fields, as embedded in a workflow node or returned by
+ *    `/omni/flow/onboarding/configuration`) → derived into an `EkycConfig`.
+ *  - A config with no recognizable signal (e.g. `{}`) → returned unchanged,
+ *    so the machine still lands in `misconfigured` instead of a silent
+ *    empty form.
+ *
+ * Idempotent: `toEkycConfig(toEkycConfig(x))` equals `toEkycConfig(x)`.
+ */
+declare function toEkycConfig(config: Partial<EkycModuleConfig> & Partial<EkycConfig>): EkycConfig;
+//#endregion
+export { type AddressSuggestion, type EkycConfig, type EkycManager, type EkycModuleConfig, type EkycState, computeDisplayErrors as computeEkycDisplayErrors, createEkycManager, ekycMachine, toEkycConfig };

package/dist/ekyc.esm.js

@@ -0,0 +1,104 @@
+import "./BrowserTimerProvider-DhNc_x02.esm.js";
+import "./api-CESGtpbH.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-D6-e4vok.esm.js";
+import "./endpoints-CnN3SyDa.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-B70JrNqo.esm.js";
+import "./cpf-PPz2Njto.esm.js";
+import "./addressSearch-BpTbTWCa.esm.js";
+import { n as computeDisplayErrors, r as toEkycConfig, t as ekycMachine } from "./ekycStateMachine-oeO0Iekd.esm.js";
+
+//#region src/modules/ekyc/ekycActor.ts
+/**
+* Creates and starts an eKYC actor.
+* The actor begins in 'idle' state, ready to receive LOAD.
+*/
+function createEkycActor(options) {
+	return createActor(ekycMachine, { input: { config: options.config } }).start();
+}
+
+//#endregion
+//#region src/modules/ekyc/ekycManager.ts
+function mapState(snapshot) {
+	const typedSnapshot = snapshot;
+	const { context } = typedSnapshot;
+	if (typedSnapshot.matches("idle") || typedSnapshot.matches("loading") || typedSnapshot.matches("prefilling")) return { status: "loading" };
+	if (typedSnapshot.matches("form")) return {
+		status: "form",
+		fields: context.fields,
+		values: context.values,
+		errors: context.errors,
+		isValid: context.isValid,
+		addressSuggestions: context.addressSuggestions,
+		prefilled: context.prefilled,
+		hideEmail: context.hideEmail,
+		fieldsCountry: context.fieldsCountry,
+		submitError: context.submitError,
+		submitAttempted: context.submitAttempted
+	};
+	if (typedSnapshot.matches("submitting")) return { status: "submitting" };
+	if (typedSnapshot.matches("success")) return { status: "success" };
+	if (typedSnapshot.matches("error")) return {
+		status: "error",
+		errorMessage: context.errorMessage
+	};
+	if (typedSnapshot.matches("misconfigured")) return { status: "misconfigured" };
+	if (typedSnapshot.matches("finished")) return { status: "finished" };
+	if (typedSnapshot.matches("closed")) return { status: "closed" };
+	return { status: "loading" };
+}
+function createApi({ actor, trackElementClicked }) {
+	return {
+		load() {
+			actor.send({ type: "LOAD" });
+		},
+		setField(name, value) {
+			actor.send({
+				type: "SET_FIELD",
+				name,
+				value
+			});
+		},
+		searchAddress(query) {
+			actor.send({
+				type: "SEARCH_ADDRESS",
+				query
+			});
+		},
+		selectAddress(suggestion) {
+			actor.send({
+				type: "SELECT_ADDRESS",
+				suggestion
+			});
+		},
+		submit() {
+			trackElementClicked?.("submit");
+			actor.send({ type: "SUBMIT" });
+		},
+		retry() {
+			trackElementClicked?.("retry");
+			actor.send({ type: "RETRY" });
+		},
+		skip() {
+			trackElementClicked?.("skip");
+			actor.send({ type: "SKIP" });
+		},
+		close() {
+			trackElementClicked?.("close");
+			actor.send({ type: "CLOSE" });
+		}
+	};
+}
+/**
+* Creates an eKYC manager for headless or UI-driven usage.
+*/
+function createEkycManager(options) {
+	return createManager({
+		actor: createEkycActor(options),
+		mapState,
+		createApi,
+		instrumentation: createManagerInstrumentation(eventModuleNames.ekyc)
+	});
+}
+
+//#endregion
+export { computeDisplayErrors as computeEkycDisplayErrors, createEkycManager, ekycMachine, toEkycConfig };