@incodetech/core 0.0.0-dev-20260423-427a341 → 0.0.0-dev-20260423-672ea74

package/dist/id-ocr.d.ts

@@ -0,0 +1,627 @@
+import { t as Manager } from "./Manager-BmmucBrC.js";
+import "./Actor-gwS4PQSi.js";
+import * as xstate648 from "xstate";
+
+//#region src/modules/id-ocr/types.d.ts
+type IdOcrConfig = {
+  /** Allows user to edit OCR information @default false */
+  editableOcr?: boolean;
+  /**
+   * When true (from flow/onboarding), after the first ID OCR step completes the
+   * machine loads and optionally edits OCR for the second captured ID.
+   */
+  secondId?: boolean;
+  /**
+   * Session flow id (injected by orchestrated flow UI). When listed in `CPFFlowIds`
+   * (`idOcrConsts`), only the CPF field is shown and validated; it maps to `documentNumber` on OCR.
+   */
+  flowId?: string;
+};
+type NameBean = {
+  fullName?: string;
+  firstName?: string;
+  middleName?: string;
+  givenName?: string;
+  nameSuffix?: string;
+  paternalLastName?: string;
+  maternalLastName?: string;
+  lastNameMrz?: string;
+};
+type AddressBean = {
+  street?: string;
+  colony?: string;
+  postalCode?: string;
+  city?: string;
+  state?: string;
+  label?: string;
+  confidentGeolocation?: boolean;
+};
+type AddressStatements = {
+  _id: string;
+  dateType: string;
+  addressStatementTimestamp: number;
+};
+type OcrData = {
+  name: NameBean;
+  givenName?: string;
+  firstName?: string;
+  middleName?: string;
+  nameSuffix?: string;
+  mothersSurname?: string;
+  fathersSurname?: string;
+  nickName?: string;
+  address?: string;
+  street?: string;
+  colony?: string;
+  postalCode?: string;
+  city?: string;
+  state?: string;
+  stateCode?: string;
+  countryCode?: string;
+  addressFields?: AddressBean;
+  fullAddress?: boolean;
+  invalidAddress?: boolean;
+  checkedAddress?: string;
+  checkedAddressBean?: AddressBean;
+  exteriorNumber?: string;
+  interiorNumber?: string;
+  addressFromStatement?: string;
+  addressFieldsFromStatement?: AddressBean;
+  invalidAddressFromStatement?: boolean;
+  addressStatementEmissionDate?: number;
+  documentType?: string;
+  addressStatementTimestamps?: AddressStatements[];
+  poaName?: string;
+  typeOfId?: string;
+  documentFrontSubtype?: string;
+  documentBackSubtype?: string;
+  birthDate?: number | string;
+  gender?: string;
+  claveDeElector?: string;
+  curp?: string;
+  numeroEmisionCredencial?: string;
+  cic?: string;
+  ocr?: string;
+  documentNumber?: string;
+  personalNumber?: string;
+  refNumber?: string;
+  nue?: string;
+  externalId?: string;
+  issuedAt?: string;
+  expireAt?: string;
+  expirationDate?: number;
+  issueDate?: number;
+  registrationDate?: number;
+  issuingCountry?: string;
+  issuingState?: string;
+  birthPlace?: string;
+  issuingAuthority?: string;
+  height?: string;
+  weight?: string;
+  eyeColor?: string;
+  hairColor?: string;
+  bloodType?: string;
+  maritalStatus?: string;
+  nationality?: string;
+  nationalityMrz?: string;
+  classes?: string;
+  cond?: string;
+  mentions?: string;
+  restrictions?: string;
+  mrz1?: string;
+  mrz2?: string;
+  mrz3?: string;
+  fullNameMrz?: string;
+  documentNumberCheckDigit?: string;
+  dateOfBirthCheckDigit?: string;
+  expirationDateCheckDigit?: string;
+  fathersName?: string;
+  mothersName?: string;
+  federalRevenueNumber?: string;
+  originDocumentId?: string;
+  driversLicenseCategory?: string;
+  controlNumber?: string;
+  renach?: string;
+  ocrReliabilityConfidence?: number;
+  ocrDataConfidence?: unknown;
+};
+type UpdateOcrDataParams = {
+  address?: string;
+  documentNumber?: string;
+  name?: string;
+  firstName?: string;
+  lastName?: string;
+  paternalLastName?: string;
+  maternalLastName?: string;
+  personalNumber?: string;
+  curp?: string;
+  email?: string;
+  birthDate?: string;
+  expireAt?: string;
+  gender?: string;
+  issuingCountry?: string;
+};
+type ValidationRule = {
+  type: 'required';
+} | {
+  type: 'minAge';
+  years: number;
+} | {
+  type: 'cpf';
+};
+type OcrFieldConfig = {
+  key: keyof UpdateOcrDataParams;
+  labelKey: string;
+  type: 'text' | 'date' | 'radio';
+  options?: {
+    label: string;
+    value: string;
+  }[];
+  validation?: ValidationRule[];
+  required: boolean;
+};
+type UpdateOcrResponse = {
+  success: boolean;
+};
+//#endregion
+//#region src/modules/id-ocr/idOcrStateMachine.d.ts
+type IdOcrOcrDocument = 'first' | 'second';
+type IdOcrContext = {
+  config: IdOcrConfig;
+  error?: string;
+  formData: UpdateOcrDataParams;
+  editedFields: UpdateOcrDataParams;
+  activeOcrDocument: IdOcrOcrDocument;
+  validationErrors?: Partial<Record<keyof UpdateOcrDataParams, string>>;
+};
+type IdOcrInput = {
+  config: IdOcrConfig;
+};
+declare const idOcrStateMachine: xstate648.StateMachine<IdOcrContext, {
+  type: "LOAD";
+} | {
+  type: "DATA_CHANGED";
+  field: keyof UpdateOcrDataParams;
+  value: string;
+} | {
+  type: "VALIDATE_FIELD";
+  field: keyof UpdateOcrDataParams;
+} | {
+  type: "CONTINUE";
+} | {
+  type: "RESET";
+}, {
+  [x: string]: xstate648.ActorRefFromLogic<xstate648.PromiseActorLogic<OcrData, {
+    isSecondId: boolean;
+  }, xstate648.EventObject>> | xstate648.ActorRefFromLogic<xstate648.PromiseActorLogic<UpdateOcrResponse, {
+    params: UpdateOcrDataParams;
+    isSecondId: boolean;
+  }, xstate648.EventObject>> | undefined;
+}, xstate648.Values<{
+  getOcrData: {
+    src: "getOcrData";
+    logic: xstate648.PromiseActorLogic<OcrData, {
+      isSecondId: boolean;
+    }, xstate648.EventObject>;
+    id: string | undefined;
+  };
+  updateOcrData: {
+    src: "updateOcrData";
+    logic: xstate648.PromiseActorLogic<UpdateOcrResponse, {
+      params: UpdateOcrDataParams;
+      isSecondId: boolean;
+    }, xstate648.EventObject>;
+    id: string | undefined;
+  };
+}>, xstate648.Values<{
+  setError: {
+    type: "setError";
+    params: xstate648.NonReducibleUnknown;
+  };
+  setInitialData: {
+    type: "setInitialData";
+    params: xstate648.NonReducibleUnknown;
+  };
+  updateField: {
+    type: "updateField";
+    params: xstate648.NonReducibleUnknown;
+  };
+  clearFieldValidationError: {
+    type: "clearFieldValidationError";
+    params: xstate648.NonReducibleUnknown;
+  };
+  setOcrValidationErrors: {
+    type: "setOcrValidationErrors";
+    params: xstate648.NonReducibleUnknown;
+  };
+  validateFormField: {
+    type: "validateFormField";
+    params: xstate648.NonReducibleUnknown;
+  };
+  beginSecondIdOcrPhase: {
+    type: "beginSecondIdOcrPhase";
+    params: xstate648.NonReducibleUnknown;
+  };
+  resetForRetry: {
+    type: "resetForRetry";
+    params: xstate648.NonReducibleUnknown;
+  };
+  computeValidationResult: {
+    type: "computeValidationResult";
+    params: xstate648.NonReducibleUnknown;
+  };
+}>, xstate648.Values<{
+  isOcrEditable: {
+    type: "isOcrEditable";
+    params: unknown;
+  };
+  shouldLoadSecondOcrAfterFirst: {
+    type: "shouldLoadSecondOcrAfterFirst";
+    params: unknown;
+  };
+  isOcrFormValid: {
+    type: "isOcrFormValid";
+    params: unknown;
+  };
+  shouldSubmit: {
+    type: "shouldSubmit";
+    params: unknown;
+  };
+  shouldProceedWithoutSubmitToSecondId: {
+    type: "shouldProceedWithoutSubmitToSecondId";
+    params: unknown;
+  };
+}>, never, "error" | "idle" | "finished" | "loading" | "submitting" | "inputting" | "readonly" | "validatingContinue", string, IdOcrInput, xstate648.NonReducibleUnknown, xstate648.EventObject, xstate648.MetaObject, {
+  readonly id: "idOcr";
+  readonly initial: "idle";
+  readonly context: ({
+    input
+  }: {
+    spawn: {
+      <TSrc extends "getOcrData" | "updateOcrData">(logic: TSrc, ...[options]: ({
+        src: "getOcrData";
+        logic: xstate648.PromiseActorLogic<OcrData, {
+          isSecondId: boolean;
+        }, xstate648.EventObject>;
+        id: string | undefined;
+      } extends infer T ? T extends {
+        src: "getOcrData";
+        logic: xstate648.PromiseActorLogic<OcrData, {
+          isSecondId: boolean;
+        }, xstate648.EventObject>;
+        id: string | undefined;
+      } ? T extends {
+        src: TSrc;
+      } ? xstate648.ConditionalRequired<[options?: ({
+        id?: T["id"] | undefined;
+        systemId?: string;
+        input?: xstate648.InputFrom<T["logic"]> | undefined;
+        syncSnapshot?: boolean;
+      } & { [K in xstate648.RequiredActorOptions<T>]: unknown }) | undefined], xstate648.IsNotNever<xstate648.RequiredActorOptions<T>>> : never : never : never) | ({
+        src: "updateOcrData";
+        logic: xstate648.PromiseActorLogic<UpdateOcrResponse, {
+          params: UpdateOcrDataParams;
+          isSecondId: boolean;
+        }, xstate648.EventObject>;
+        id: string | undefined;
+      } extends infer T_1 ? T_1 extends {
+        src: "updateOcrData";
+        logic: xstate648.PromiseActorLogic<UpdateOcrResponse, {
+          params: UpdateOcrDataParams;
+          isSecondId: boolean;
+        }, xstate648.EventObject>;
+        id: string | undefined;
+      } ? T_1 extends {
+        src: TSrc;
+      } ? xstate648.ConditionalRequired<[options?: ({
+        id?: T_1["id"] | undefined;
+        systemId?: string;
+        input?: xstate648.InputFrom<T_1["logic"]> | undefined;
+        syncSnapshot?: boolean;
+      } & { [K_1 in xstate648.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate648.IsNotNever<xstate648.RequiredActorOptions<T_1>>> : never : never : never)): xstate648.ActorRefFromLogic<xstate648.GetConcreteByKey<xstate648.Values<{
+        getOcrData: {
+          src: "getOcrData";
+          logic: xstate648.PromiseActorLogic<OcrData, {
+            isSecondId: boolean;
+          }, xstate648.EventObject>;
+          id: string | undefined;
+        };
+        updateOcrData: {
+          src: "updateOcrData";
+          logic: xstate648.PromiseActorLogic<UpdateOcrResponse, {
+            params: UpdateOcrDataParams;
+            isSecondId: boolean;
+          }, xstate648.EventObject>;
+          id: string | undefined;
+        };
+      }>, "src", TSrc>["logic"]>;
+      <TLogic extends xstate648.AnyActorLogic>(src: TLogic, ...[options]: xstate648.ConditionalRequired<[options?: ({
+        id?: never;
+        systemId?: string;
+        input?: xstate648.InputFrom<TLogic> | undefined;
+        syncSnapshot?: boolean;
+      } & { [K in xstate648.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate648.IsNotNever<xstate648.RequiredLogicInput<TLogic>>>): xstate648.ActorRefFromLogic<TLogic>;
+    };
+    input: IdOcrInput;
+    self: xstate648.ActorRef<xstate648.MachineSnapshot<IdOcrContext, {
+      type: "LOAD";
+    } | {
+      type: "DATA_CHANGED";
+      field: keyof UpdateOcrDataParams;
+      value: string;
+    } | {
+      type: "VALIDATE_FIELD";
+      field: keyof UpdateOcrDataParams;
+    } | {
+      type: "CONTINUE";
+    } | {
+      type: "RESET";
+    }, Record<string, xstate648.AnyActorRef | undefined>, xstate648.StateValue, string, unknown, any, any>, {
+      type: "LOAD";
+    } | {
+      type: "DATA_CHANGED";
+      field: keyof UpdateOcrDataParams;
+      value: string;
+    } | {
+      type: "VALIDATE_FIELD";
+      field: keyof UpdateOcrDataParams;
+    } | {
+      type: "CONTINUE";
+    } | {
+      type: "RESET";
+    }, xstate648.AnyEventObject>;
+  }) => {
+    config: IdOcrConfig;
+    formData: UpdateOcrDataParams;
+    editedFields: {};
+    activeOcrDocument: IdOcrOcrDocument;
+  };
+  readonly states: {
+    readonly idle: {
+      readonly on: {
+        readonly LOAD: readonly [{
+          readonly target: "loading";
+        }];
+      };
+    };
+    readonly loading: {
+      readonly invoke: {
+        readonly src: "getOcrData";
+        readonly input: ({
+          context
+        }: {
+          context: IdOcrContext;
+          event: {
+            type: "LOAD";
+          } | {
+            type: "DATA_CHANGED";
+            field: keyof UpdateOcrDataParams;
+            value: string;
+          } | {
+            type: "VALIDATE_FIELD";
+            field: keyof UpdateOcrDataParams;
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "RESET";
+          };
+          self: xstate648.ActorRef<xstate648.MachineSnapshot<IdOcrContext, {
+            type: "LOAD";
+          } | {
+            type: "DATA_CHANGED";
+            field: keyof UpdateOcrDataParams;
+            value: string;
+          } | {
+            type: "VALIDATE_FIELD";
+            field: keyof UpdateOcrDataParams;
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "RESET";
+          }, Record<string, xstate648.AnyActorRef>, xstate648.StateValue, string, unknown, any, any>, {
+            type: "LOAD";
+          } | {
+            type: "DATA_CHANGED";
+            field: keyof UpdateOcrDataParams;
+            value: string;
+          } | {
+            type: "VALIDATE_FIELD";
+            field: keyof UpdateOcrDataParams;
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "RESET";
+          }, xstate648.AnyEventObject>;
+        }) => {
+          isSecondId: boolean;
+        };
+        readonly onDone: readonly [{
+          readonly target: "inputting";
+          readonly guard: "isOcrEditable";
+          readonly actions: "setInitialData";
+        }, {
+          readonly target: "readonly";
+          readonly actions: "setInitialData";
+        }];
+        readonly onError: {
+          readonly target: "error";
+          readonly actions: "setError";
+        };
+      };
+    };
+    readonly readonly: {
+      readonly on: {
+        readonly CONTINUE: readonly [{
+          readonly target: "loading";
+          readonly guard: "shouldLoadSecondOcrAfterFirst";
+          readonly actions: "beginSecondIdOcrPhase";
+        }, {
+          readonly target: "finished";
+        }];
+      };
+    };
+    readonly inputting: {
+      readonly on: {
+        readonly DATA_CHANGED: {
+          readonly actions: readonly ["updateField", "clearFieldValidationError"];
+        };
+        readonly VALIDATE_FIELD: {
+          readonly actions: "validateFormField";
+        };
+        readonly CONTINUE: {
+          readonly target: "validatingContinue";
+        };
+      };
+    };
+    readonly validatingContinue: {
+      readonly entry: "computeValidationResult";
+      readonly always: readonly [{
+        readonly guard: "shouldSubmit";
+        readonly target: "submitting";
+      }, {
+        readonly guard: "shouldProceedWithoutSubmitToSecondId";
+        readonly target: "loading";
+        readonly actions: "beginSecondIdOcrPhase";
+      }, {
+        readonly guard: "isOcrFormValid";
+        readonly target: "finished";
+      }, {
+        readonly target: "inputting";
+      }];
+    };
+    readonly submitting: {
+      readonly invoke: {
+        readonly src: "updateOcrData";
+        readonly input: ({
+          context
+        }: {
+          context: IdOcrContext;
+          event: {
+            type: "LOAD";
+          } | {
+            type: "DATA_CHANGED";
+            field: keyof UpdateOcrDataParams;
+            value: string;
+          } | {
+            type: "VALIDATE_FIELD";
+            field: keyof UpdateOcrDataParams;
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "RESET";
+          };
+          self: xstate648.ActorRef<xstate648.MachineSnapshot<IdOcrContext, {
+            type: "LOAD";
+          } | {
+            type: "DATA_CHANGED";
+            field: keyof UpdateOcrDataParams;
+            value: string;
+          } | {
+            type: "VALIDATE_FIELD";
+            field: keyof UpdateOcrDataParams;
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "RESET";
+          }, Record<string, xstate648.AnyActorRef>, xstate648.StateValue, string, unknown, any, any>, {
+            type: "LOAD";
+          } | {
+            type: "DATA_CHANGED";
+            field: keyof UpdateOcrDataParams;
+            value: string;
+          } | {
+            type: "VALIDATE_FIELD";
+            field: keyof UpdateOcrDataParams;
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "RESET";
+          }, xstate648.AnyEventObject>;
+        }) => {
+          params: UpdateOcrDataParams;
+          isSecondId: boolean;
+        };
+        readonly onDone: readonly [{
+          readonly target: "loading";
+          readonly guard: "shouldLoadSecondOcrAfterFirst";
+          readonly actions: "beginSecondIdOcrPhase";
+        }, {
+          readonly target: "finished";
+        }];
+        readonly onError: {
+          readonly target: "error";
+          readonly actions: "setError";
+        };
+      };
+    };
+    readonly finished: {
+      readonly type: "final";
+    };
+    readonly error: {
+      readonly on: {
+        readonly RESET: {
+          readonly target: "idle";
+          readonly actions: "resetForRetry";
+        };
+      };
+    };
+  };
+}>;
+//#endregion
+//#region src/modules/id-ocr/idOcrActor.d.ts
+type CreateIdOcrActorOptions = {
+  config: IdOcrConfig;
+};
+//#endregion
+//#region src/modules/id-ocr/idOcrManager.d.ts
+type IdOcrIdleState = {
+  status: 'idle';
+};
+type IdOcrLoadingState = {
+  status: 'loading';
+  ocrDocument: IdOcrOcrDocument;
+};
+type IdOcrReadonlyState = {
+  status: 'readonly';
+  formData: UpdateOcrDataParams;
+  editableOcr: boolean;
+  ocrDocument: IdOcrOcrDocument;
+};
+type IdOcrInputtingState = {
+  status: 'inputting';
+  formData: UpdateOcrDataParams;
+  diff: UpdateOcrDataParams;
+  editableOcr: boolean;
+  ocrDocument: IdOcrOcrDocument;
+  validationErrors?: Partial<Record<keyof UpdateOcrDataParams, string>>;
+};
+type IdOcrSubmittingState = {
+  status: 'submitting';
+  ocrDocument: IdOcrOcrDocument;
+};
+type IdOcrFinishedState = {
+  status: 'finished';
+};
+type IdOcrErrorState = {
+  status: 'error';
+  error: string;
+};
+type IdOcrState = IdOcrIdleState | IdOcrLoadingState | IdOcrReadonlyState | IdOcrInputtingState | IdOcrSubmittingState | IdOcrFinishedState | IdOcrErrorState;
+declare function createIdOcrManager(options: CreateIdOcrActorOptions): Manager<IdOcrState> & {
+  load(): void;
+  setField(field: keyof UpdateOcrDataParams, value: string): void;
+  validateField(field: keyof UpdateOcrDataParams): void;
+  continue(): void;
+  reset(): void;
+};
+type IdOcrManager = ReturnType<typeof createIdOcrManager>;
+//#endregion
+//#region src/modules/id-ocr/idOcrFields.d.ts
+declare const OCR_FIELDS: OcrFieldConfig[];
+declare const getOcrFields: (config: Pick<IdOcrConfig, "flowId">) => OcrFieldConfig[];
+//#endregion
+//#region src/modules/id-ocr/idOcrConsts.d.ts
+declare const MIN_AGE = 18;
+declare const CPFFlowIds: string[];
+//#endregion
+export { CPFFlowIds, type IdOcrConfig, type IdOcrManager, type IdOcrOcrDocument, type IdOcrState, MIN_AGE, OCR_FIELDS, type OcrData, type OcrFieldConfig, type UpdateOcrDataParams, type ValidationRule, createIdOcrManager, getOcrFields, idOcrStateMachine };