@velion-la/onboarding-sdk-react-native 1.0.0-beta.2

package/src/i18n/strings/es.ts

@@ -0,0 +1,291 @@
+/**
+ * Spanish copy. Default locale. Centralized translation table consumed by
+ * every step module via `getStrings('es')`.
+ */
+
+export const ES = {
+  common: {
+    loading: 'Cargando…',
+    submitting: 'Enviando…',
+    processingVerification: 'Procesando tu verificación…',
+    finalizing: 'Procesando tu información…',
+    continue: 'Continuar',
+    cancel: 'Cancelar',
+    retry: 'Reintentar',
+    confirm: 'Confirmar',
+    required: 'Requerido',
+    submissionTitle: 'Hubo un problema',
+    submissionFallback:
+      'Disculpá, hubo un error procesando tu información. Volvé a intentar — tus datos no se perdieron.',
+  },
+  fingerprint: {
+    evaluating: 'Estamos evaluando tu dispositivo. Esto demora unos segundos…',
+  },
+  human_basic_info: {
+    title: 'Datos personales',
+    subtitle:
+      'Ingresá tu nombre y documento tal como figuran en tu identificación oficial.',
+    givenNames: 'Nombre(s)',
+    familyNames: 'Apellido(s)',
+    idType: 'Tipo de documento',
+    idNumber: 'Número de documento',
+    nameRequired: 'Completá nombre y apellido(s).',
+    idTypeRequired: 'Elegí un tipo de documento.',
+    idNumberRequired: 'Ingresá el número de tu documento.',
+  },
+  email_contact: {
+    title: 'Correo electrónico',
+    label: 'Email',
+    hint: 'Ingresá tu correo de contacto.',
+    invalid: 'Ingresá un email válido.',
+    required: 'Ingresá tu email.',
+  },
+  phone_contact: {
+    title: 'Teléfono',
+    label: 'Teléfono (E.164)',
+    hint: 'Ejemplo: +5491112345678',
+    invalid: 'Usá formato E.164 (ej. +5491112345678).',
+    required: 'Ingresá tu teléfono.',
+  },
+  email_otp: {
+    title: 'Verificación de correo',
+    emailLabel: 'Correo electrónico',
+    emailHint: 'Te enviaremos un código de 6 dígitos a este email.',
+    sendCode: 'Enviar código',
+    sendingCode: 'Enviando código…',
+    otpLabel: 'Código de 6 dígitos',
+    otpHint: 'Pegá o escribí el código que recibiste por email.',
+    verify: 'Verificar',
+    verifying: 'Verificando…',
+    resend: 'Reenviar código',
+    emailRequired: 'Ingresá tu email primero.',
+    otpRequired: 'Ingresá el código de 6 dígitos.',
+    otpFormat: 'El código debe tener 6 dígitos numéricos.',
+  },
+  phone_otp: {
+    title: 'Verificación por teléfono',
+    phoneLabel: 'Número (E.164)',
+    phoneHint: 'Te enviaremos un código por SMS. Ej.: +5491112345678',
+    sendCode: 'Enviar código',
+    sendingCode: 'Enviando código…',
+    otpLabel: 'Código de 6 dígitos',
+    otpHint: 'Pegá o escribí el código que recibiste por SMS.',
+    verify: 'Verificar',
+    verifying: 'Verificando…',
+    resend: 'Reenviar código',
+    phoneRequired: 'Ingresá el teléfono en formato E.164.',
+    otpRequired: 'Ingresá el código de 6 dígitos.',
+    otpFormat: 'El código debe tener 6 dígitos numéricos.',
+  },
+  tax_info: {
+    title: 'Información fiscal',
+    subtitle:
+      'Indicá tu categoría e identificación tributaria según conste en ARCA u organismo equivalente.',
+    taxpayerType: 'Categoría fiscal',
+    taxpayerIdType: 'Tipo de identificación fiscal',
+    taxpayerId: 'Número de identificación',
+    requiredCategory: 'Elegí una categoría fiscal.',
+    requiredIdType: 'Elegí un tipo de identificación.',
+    requiredId: 'Ingresá tu número de identificación.',
+  },
+  sworn_declaration: {
+    title: 'Declaración jurada',
+    subtitle: '¿Aplicás a alguna de estas normas?',
+    pep: 'PEP (Persona Expuesta Políticamente)',
+    pepDescription:
+      'Persona que ejerce o ejerció funciones públicas relevantes, o mantiene un vínculo familiar o cercano con alguien en esa condición.',
+    ssoo: 'Sujeto obligado',
+    ssooDescription:
+      'Persona o actividad alcanzada por normas de prevención de lavado de activos y financiación del terrorismo.',
+    fatca: 'Ley FATCA',
+    fatcaDescription:
+      'Persona considerada contribuyente en Estados Unidos bajo la normativa FATCA.',
+    ocde: 'Ley OCDE / CRS',
+    ocdeDescription:
+      'Persona con residencia o obligaciones fiscales fuera de Argentina, alcanzada por estándares de reporte internacional.',
+    none: 'Ninguna de las anteriores',
+    noneDescription: 'No aplico a ninguna de estas normas.',
+  },
+  terms_and_conditions: {
+    title: 'Términos y condiciones',
+    subtitle: 'Revisá cada punto y marcá que aceptás para continuar.',
+    accept: 'Acepto',
+    openLink: 'Ver documento',
+    needAll: 'Debés aceptar todos los ítems para continuar.',
+    noItems:
+      'No hay ítems de términos en esta sesión. Verificá la creación de sesión o actualizá el backend.',
+  },
+  legal_basic_info: {
+    title: 'Datos de la entidad',
+    subtitle: 'Ingresá los datos de la sociedad tal como figuran en el registro fiscal.',
+    legalName: 'Razón social',
+    legalForm: 'Forma jurídica (ej. SA, SRL)',
+    idType: 'Tipo de identificación fiscal',
+    idTypePlaceholder: 'CUIT, NIT, RFC',
+    idNumber: 'Número de identificación',
+    requiredLegalName: 'Ingresá la razón social.',
+    requiredLegalForm: 'Ingresá la forma jurídica.',
+    requiredIdType: 'Ingresá el tipo de identificación fiscal.',
+    requiredIdNumber: 'Ingresá el número de identificación.',
+  },
+  human_extended_info: {
+    title: 'Datos adicionales',
+    subtitle:
+      'Completá tu género, estado civil, fecha y datos de país según tu documentación.',
+    gender: 'Género',
+    civilStatus: 'Estado civil',
+    birthDate: 'Fecha de nacimiento',
+    birthCountry: 'País de nacimiento',
+    citizenship: 'Nacionalidad',
+    residenceCountry: 'País de residencia',
+    countrySearch: 'Buscar por nombre…',
+    requiredGender: 'Elegí un género.',
+    requiredCivil: 'Elegí un estado civil.',
+    requiredBirthDate: 'Ingresá una fecha de nacimiento válida.',
+    requiredCountry: 'Seleccioná el país en el listado.',
+  },
+  legal_extended_info: {
+    title: 'Datos de la sociedad',
+    subtitle: 'Completá la información de constitución de la entidad.',
+    incorporationDate: 'Fecha de constitución',
+    incorporationCountry: 'País de constitución',
+    requiredDate: 'Ingresá una fecha de constitución válida.',
+    requiredCountry: 'Seleccioná el país de constitución.',
+  },
+  address_info: {
+    title: 'Tu domicilio',
+    subtitle: 'Completá los datos de tu domicilio actual.',
+    introTitle: '¿Dónde vivís?',
+    introLine1: 'Ingresá el domicilio donde vivís actualmente.',
+    introLine2: 'No es necesario que coincida con la dirección del documento.',
+    introNext: 'Siguiente',
+    mapSearchPlaceholder: 'Buscá tu dirección o arrastrá el pin',
+    mapSearching: 'Buscando…',
+    mapNoResults: 'Sin resultados. Probá con la calle y la ciudad.',
+    mapNext: 'Siguiente',
+    mapBack: 'Volver',
+    detailsTitle: 'Detalle del domicilio',
+    geocodeError:
+      'No pudimos leer la dirección en este punto. Movete a otra ubicación o completá la dirección a mano en el siguiente paso.',
+    locationDenied:
+      'Activá la ubicación para centrar el mapa, o buscá tu dirección arriba.',
+    country: 'País',
+    countryPlaceholder: 'Buscá el país…',
+    state: 'Provincia / estado',
+    city: 'Ciudad',
+    district: 'Partido / departamento',
+    neighborhood: 'Barrio',
+    street: 'Calle',
+    number: 'Número',
+    floor: 'Piso (opcional)',
+    apartment: 'Departamento (opcional)',
+    zipCode: 'Código postal',
+    references: 'Referencias (opcional)',
+    requiredCountry: 'Seleccioná el país.',
+    requiredState: 'Ingresá la provincia o estado.',
+    requiredCity: 'Ingresá la ciudad.',
+    requiredDistrict: 'Ingresá el partido o departamento.',
+    requiredNeighborhood: 'Ingresá el barrio.',
+    requiredStreet: 'Ingresá la calle.',
+    requiredNumber: 'Ingresá el número.',
+    requiredZip: 'Ingresá el código postal.',
+    fillAllRequired: 'Completá los campos marcados con *.',
+  },
+  documents_ocr: {
+    introTitle: 'Documento de identidad',
+    introSubtitle:
+      'Vamos a pedirte una foto del frente y el dorso de tu documento. Antes, mirá estos consejos:',
+    introTips: [
+      'Asegurate de tener buena luz, sin reflejos ni sombras.',
+      'Apoyá el documento en una superficie plana y de color uniforme.',
+      'Que la información se lea con claridad — datos y foto nítidos.',
+      'Sostené la cámara firme y derecha hasta confirmar la captura.',
+    ],
+    introStart: 'Empezar',
+    frontTitle: 'Parte frontal',
+    backTitle: 'Parte trasera',
+    frontInstruction: 'Colocá el frente de tu documento dentro del recuadro',
+    backInstruction: 'Colocá el dorso de tu documento dentro del recuadro',
+    captureBtn: 'Tomar foto',
+    retakeBtn: 'Tomar de nuevo',
+    confirmBtn: 'Confirmar',
+    confirmFront: 'Confirmar frente',
+    confirmBack: 'Confirmar dorso',
+    initializing: 'Preparando captura…',
+    uploadingFront: 'Subiendo frente…',
+    uploadingBack: 'Subiendo dorso…',
+    verifying: 'Verificando documento…',
+    cameraPermissionDenied:
+      'Necesitamos acceso a la cámara para capturar tu documento. Habilitalo en Ajustes.',
+    cameraTryAgain: 'Reintentar',
+    fileTooLarge: 'La imagen pesa más de 5 MB. Volvé a tomarla con menos calidad.',
+  },
+  liveness: {
+    introTitle: 'Verificá que sos vos',
+    introSubtitle:
+      'Vamos a pedirte una serie de movimientos breves frente a la cámara. Antes, asegurate de que:',
+    introTips: [
+      'Estés en un lugar bien iluminado, sin contraluz.',
+      'Tengas el rostro descubierto, sin lentes ni gorra.',
+      'Sostengas el teléfono firme y a la altura de los ojos.',
+      'Reaccioná rápido cuando aparezca cada instrucción — tenés pocos segundos para cada una.',
+    ],
+    introStart: 'Empezar',
+    introBack: 'Atrás',
+    connecting: 'Conectando…',
+    preparingCamera: 'Preparando cámara…',
+    centerFace: 'Centrá tu rostro dentro del óvalo',
+    positioningReady: 'Listo, ya estás bien posicionado — empezamos',
+    getReady: 'Atento — empezamos',
+    finalizing: 'Procesando tu video…',
+    analyzingHeadline: 'Analizando tu video',
+    analyzingCaption: 'Estamos verificando la prueba de vida. Tardará solo unos segundos.',
+    timeoutTurnLeft: 'No pudimos reconocer el giro hacia la izquierda',
+    timeoutTurnRight: 'No pudimos reconocer el giro hacia la derecha',
+    timeoutBlink: 'No pudimos reconocer el pestañeo',
+    timeoutSmile: 'No pudimos reconocer la sonrisa',
+    timeoutMoveCloser: 'No detectamos que te acercaras',
+    timeoutMoveFarther: 'No detectamos que te alejaras',
+    timeoutGeneric: 'No pudimos reconocer el movimiento',
+    challenge: {
+      FACE_FORWARD: 'Mantené tu rostro de frente',
+      TURN_LEFT: 'Girá la cabeza a la izquierda',
+      TURN_RIGHT: 'Girá la cabeza a la derecha',
+      SMILE: 'Sonreí',
+      BLINK: 'Parpadeá una vez',
+      MOVE_CLOSER: 'Acercá el teléfono a tu cara',
+      MOVE_FARTHER: 'Alejá el teléfono de tu cara',
+    },
+    warningGeneric: 'Acomodá tu rostro y mantené la posición',
+    warningConsecutiveMisses: 'Acomodá tu rostro (intento {n}) — seguí las instrucciones',
+    warningTooFar: 'Acercate al teléfono para que tu rostro llene la guía',
+    warningTooClose: 'Alejá un poco el teléfono para que tu rostro entre completo',
+    warningMoveCloserHint: 'Acercá el teléfono — tu cara debería crecer dentro de la guía',
+    warningMoveFartherHint: 'Alejá el teléfono — tu cara debería achicarse dentro de la guía',
+    terminalRetryTitle: 'No pudimos verificarte',
+    terminalRetryFallback:
+      'No pudimos completar la verificación facial. Probá de nuevo en un lugar bien iluminado y siguiendo las instrucciones.',
+    noProgressMessage:
+      'No detectamos movimiento de tu cara en los últimos 25 segundos. Asegurate de tener buena iluminación y volvé a intentar.',
+    terminalRetryButton: 'Reintentar',
+    terminalCancelButton: 'Cancelar',
+    cameraPermissionDenied:
+      'Necesitamos acceso a la cámara para hacer la prueba de vida. Habilitalo en Ajustes.',
+    cameraTryAgain: 'Reintentar',
+  },
+  months: [
+    'Ene', 'Feb', 'Mar', 'Abr', 'May', 'Jun',
+    'Jul', 'Ago', 'Sep', 'Oct', 'Nov', 'Dic',
+  ],
+  result: {
+    approvedTitle: 'Verificación completada',
+    approvedBody: 'Tu identidad fue verificada con éxito.',
+    manualReviewTitle: 'En revisión manual',
+    manualReviewBody: 'Un especialista revisará tu caso a la brevedad.',
+    rejectedTitle: 'Verificación rechazada',
+    rejectedBody: 'No se pudo completar esta sesión.',
+    declineHeadline: 'No pudimos continuar',
+  },
+};
+
+export type StringsTable = typeof ES;

package/src/index.ts

@@ -0,0 +1,137 @@
+/**
+ * @fileoverview Public API of `@velion-la/onboarding-sdk-react-native`.
+ *
+ * Two integration shapes:
+ *
+ *   1. Component (recommended):
+ *      `<VelionOnboardingScreen config={…} onComplete={…} onFail={…} />`
+ *
+ *   2. Imperative (rare, for hosts that need lifecycle control outside React):
+ *      `const sdk = new VelionOnboarding(config); await sdk.start();`
+ *      Hosts taking this path are responsible for rendering the orchestrator's
+ *      `OrchestratorView` themselves.
+ */
+
+// Orchestrator
+export { VelionOnboarding } from './core/VelionOnboarding';
+export type {
+  VelionConfig,
+  OrchestratorView,
+} from './core/VelionOnboarding';
+
+// React component
+export {
+  VelionOnboardingScreen,
+} from './ui/VelionOnboardingScreen';
+export type {
+  VelionOnboardingScreenProps,
+} from './ui/VelionOnboardingScreen';
+
+// Theme + design primitives — consumers may want to render adjacent UI in
+// the SDK's visual language (e.g. a custom dismiss button on the host screen).
+export {
+  ThemeProvider,
+  useTheme,
+  useReducedMotion,
+  LIGHT_TOKENS,
+  DARK_TOKENS,
+  resolveTheme,
+  mixHex,
+  withAlpha,
+  type ResolvedTheme,
+  type ThemeTokenSet,
+} from './ui/theme';
+
+// Form primitives are intentionally exported so step-level customizations
+// (white-labeling) can extend the same components the SDK uses.
+export {
+  Button,
+  Input,
+  Select,
+  Card,
+  Banner,
+  Spinner,
+  Checkbox,
+  DatePicker,
+  CountrySelect,
+  type ButtonProps,
+  type ButtonVariant,
+  type InputProps,
+  type SelectOption,
+  type SelectProps,
+  type CardProps,
+  type BannerProps,
+  type SpinnerProps,
+  type CheckboxProps,
+  type DatePickerProps,
+  type CountrySelectProps,
+} from './ui/primitives';
+export {
+  LoadingOverlay,
+  RetryDialog,
+  ProgressBar,
+  PROGRESS_BAR,
+} from './ui/overlays';
+export {
+  useInlineValidation,
+  required,
+  minLength,
+  pattern,
+  compose,
+  type FieldRule,
+  type InlineValidationHandle,
+  type FieldValidator,
+} from './ui/forms';
+export { getStrings, resolveLocale, type SupportedLocale } from './i18n';
+
+// Re-export the public types from the shared package so consumers don't have
+// to install `@velion-la/onboarding-sdk-types` directly.
+export {
+  SdkErrorCode,
+  CameraErrorCode,
+} from './types';
+export type {
+  OnboardingStep,
+  OnboardingStepStatus,
+  OnboardingType,
+  OnboardingResult,
+  OnboardingSessionEvent,
+  OnboardingDtoResponse,
+  SessionState,
+  SdkError,
+  SdkStatus,
+  VelionTheme,
+  VelionFinalResultScreenTexts,
+  VelionFinalResultStatusCopy,
+  VelionSessionDeclinedReasonTexts,
+  VelionSessionDeclinedReasonMessages,
+  VelionCallbacks,
+  // Step configs
+  HumanBasicInfoStepConfig,
+  HumanExtendedInfoStepConfig,
+  TaxInfoStepConfig,
+  AddressInfoStepConfig,
+  SwornDeclarationStepConfig,
+  DocumentsOcrStepConfig,
+  TermsAndConditionsStepConfig,
+  // Payloads
+  HumanBasicInfoPayload,
+  LegalBasicInfoPayload,
+  HumanExtendedInfoPayload,
+  LegalExtendedInfoPayload,
+  AddressInfoPayload,
+  SwornDeclarationPayload,
+  EmailContactPayload,
+  PhoneContactPayload,
+  TaxInfoPayload,
+  TaxInfoConfig,
+  TaxInfoOption,
+  TermsAndConditionsItem,
+  TermsAndConditionsAcceptancePayload,
+  TermsAndConditionsSubmitPayload,
+  // Result-screen helpers
+  SessionCreationResponse,
+  LivenessSessionResponse,
+} from './types';
+
+export { SDK_VERSION } from './utils/sdkVersion';