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

package/lib/module/utils/osGeocoder.js

@@ -0,0 +1,65 @@
+"use strict";
+
+/**
+ * Reverse geocoding via the OS-native geocoder, bypassing Google's REST API
+ * entirely.
+ *
+ * Why this exists:
+ *   - The Google Geocoding Web Service is HTTP REST. It does not honour
+ *     iOS/Android application restrictions on the API key, so a key tightly
+ *     locked to a bundle ID still fails with REQUEST_DENIED when called from
+ *     fetch().
+ *   - The OS geocoder (CLGeocoder on iOS / android.location.Geocoder on
+ *     Android) needs no Google key and respects the platform conventions
+ *     users expect. Coverage in urban LATAM is excellent; rural coverage on
+ *     iOS uses Apple Maps (lower than Google in remote zones) but the
+ *     downstream OCR step normally recovers the printed address either way.
+ *   - Keeps the SDK to one Google Maps key whose only purpose is rendering
+ *     the map via the native Maps SDK — that one IS protected by the iOS /
+ *     Android app restriction.
+ *
+ * Returns the same `ParsedAddressFields` shape that the previous Google
+ * Geocoding caller produced, so downstream code (`AddressDetailsForm`,
+ * payload assembly) doesn't change.
+ */
+
+import * as Location from 'expo-location';
+import { log } from './log';
+/**
+ * Returns parsed structured address fields, or `null` when the OS geocoder
+ * has no match.
+ */
+export async function reverseGeocode(args) {
+  let results;
+  try {
+    results = await Location.reverseGeocodeAsync({
+      latitude: args.latitude,
+      longitude: args.longitude
+    });
+  } catch (err) {
+    log.warn('[os-geocoder] reverse failed', err);
+    return null;
+  }
+  if (!results || results.length === 0) {
+    log.info('[os-geocoder] no results');
+    return null;
+  }
+  const top = results[0];
+  const isoCc = top.isoCountryCode ?? '';
+  return {
+    country: isoCc.toUpperCase(),
+    state: top.region ?? '',
+    city: top.city ?? '',
+    // OS reports neighborhoods inconsistently across platforms; map `district`
+    // (Apple) / `subregion` (Android fallback) to our `district` field and
+    // leave `neighborhood` empty so the user can fill it manually.
+    district: top.district ?? top.subregion ?? '',
+    neighborhood: '',
+    street: top.street ?? '',
+    number: top.streetNumber ?? '',
+    zip_code: top.postalCode ?? '',
+    latitude: args.latitude,
+    longitude: args.longitude
+  };
+}
+//# sourceMappingURL=osGeocoder.js.map

package/lib/module/utils/osGeocoder.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Location","log","reverseGeocode","args","results","reverseGeocodeAsync","latitude","longitude","err","warn","length","info","top","isoCc","isoCountryCode","country","toUpperCase","state","region","city","district","subregion","neighborhood","street","number","streetNumber","zip_code","postalCode"],"sourceRoot":"../../../src","sources":["utils/osGeocoder.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,KAAKA,QAAQ,MAAM,eAAe;AAIzC,SAASC,GAAG,QAAQ,OAAO;AAS3B;AACA;AACA;AACA;AACA,OAAO,eAAeC,cAAcA,CAClCC,IAAwB,EACyD;EACjF,IAAIC,OAA2C;EAC/C,IAAI;IACFA,OAAO,GAAG,MAAMJ,QAAQ,CAACK,mBAAmB,CAAC;MAC3CC,QAAQ,EAAEH,IAAI,CAACG,QAAQ;MACvBC,SAAS,EAAEJ,IAAI,CAACI;IAClB,CAAC,CAAC;EACJ,CAAC,CAAC,OAAOC,GAAG,EAAE;IACZP,GAAG,CAACQ,IAAI,CAAC,8BAA8B,EAAED,GAAG,CAAC;IAC7C,OAAO,IAAI;EACb;EACA,IAAI,CAACJ,OAAO,IAAIA,OAAO,CAACM,MAAM,KAAK,CAAC,EAAE;IACpCT,GAAG,CAACU,IAAI,CAAC,0BAA0B,CAAC;IACpC,OAAO,IAAI;EACb;EACA,MAAMC,GAAG,GAAGR,OAAO,CAAC,CAAC,CAAE;EACvB,MAAMS,KAAK,GAAGD,GAAG,CAACE,cAAc,IAAI,EAAE;EACtC,OAAO;IACLC,OAAO,EAAEF,KAAK,CAACG,WAAW,CAAC,CAAC;IAC5BC,KAAK,EAAEL,GAAG,CAACM,MAAM,IAAI,EAAE;IACvBC,IAAI,EAAEP,GAAG,CAACO,IAAI,IAAI,EAAE;IACpB;IACA;IACA;IACAC,QAAQ,EAAER,GAAG,CAACQ,QAAQ,IAAIR,GAAG,CAACS,SAAS,IAAI,EAAE;IAC7CC,YAAY,EAAE,EAAE;IAChBC,MAAM,EAAEX,GAAG,CAACW,MAAM,IAAI,EAAE;IACxBC,MAAM,EAAEZ,GAAG,CAACa,YAAY,IAAI,EAAE;IAC9BC,QAAQ,EAAEd,GAAG,CAACe,UAAU,IAAI,EAAE;IAC9BrB,QAAQ,EAAEH,IAAI,CAACG,QAAQ;IACvBC,SAAS,EAAEJ,IAAI,CAACI;EAClB,CAAC;AACH","ignoreList":[]}

package/lib/module/utils/parseGoogleAddressComponents.js

@@ -0,0 +1,69 @@
+"use strict";
+
+/**
+ * Maps Google Geocoder / Places `address_components` into
+ * `AddressInfoPayload` fields.
+ *
+ * The wire shape used here is whatever the Google Geocoding REST API
+ * returns: `{ long_name, short_name, types: string[] }`.
+ */
+
+function pick(components, type, useShort) {
+  const c = components.find(x => x.types.includes(type));
+  if (!c) return '';
+  return useShort ? c.short_name : c.long_name;
+}
+
+/**
+ * Parses `address_components` from a Geocoder result or Place result.
+ * Applies fallbacks so required API fields are usually non-empty when Google
+ * returns a result.
+ */
+export function parseGoogleAddressComponents(components, formattedAddress, lat, lng) {
+  const list = components ?? [];
+  const firstLine = formattedAddress?.split(',')[0]?.trim() ?? '';
+  const country = pick(list, 'country', true).toUpperCase();
+  const state = pick(list, 'administrative_area_level_1', false) || pick(list, 'administrative_area_level_2', false);
+  const city = pick(list, 'locality', false) || pick(list, 'administrative_area_level_2', false) || pick(list, 'administrative_area_level_3', false) || pick(list, 'sublocality_level_1', false);
+  const district = pick(list, 'sublocality_level_1', false) || pick(list, 'sublocality', false) || pick(list, 'administrative_area_level_3', false) || undefined;
+  const neighborhood = pick(list, 'neighborhood', false) || undefined;
+  const route = pick(list, 'route', false);
+  const streetNumber = pick(list, 'street_number', false);
+  const postal = pick(list, 'postal_code', false);
+  let street = route;
+  if (!street && firstLine) street = firstLine;
+  if (!street) street = '—';
+  const number = streetNumber || 'S/N';
+  const zip_code = postal || '0000';
+  let cityOut = city;
+  if (!cityOut) cityOut = state || '—';
+  let stateOut = state;
+  if (!stateOut) stateOut = cityOut;
+  const out = {
+    country: country || 'XX',
+    state: stateOut,
+    city: cityOut,
+    street,
+    number,
+    zip_code,
+    latitude: lat,
+    longitude: lng
+  };
+  if (district) out.district = district;
+  if (neighborhood) out.neighborhood = neighborhood;
+  return out;
+}
+
+/**
+ * True when the parsed address has enough required fields to send to the
+ * backend.
+ */
+export function isAddressSelectionComplete(parsed, required = {}) {
+  const reqState = required.state !== false;
+  const reqCity = required.city !== false;
+  const reqStreet = required.street !== false;
+  const reqNumber = required.number !== false;
+  const reqPostal = required.postal !== false;
+  return parsed.country.length === 2 && (!reqState || parsed.state.length > 0) && (!reqCity || parsed.city.length > 0) && (!reqStreet || parsed.street.length > 0) && (!reqNumber || parsed.number.length > 0) && (!reqPostal || parsed.zip_code.length > 0);
+}
+//# sourceMappingURL=parseGoogleAddressComponents.js.map

package/lib/module/utils/parseGoogleAddressComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["pick","components","type","useShort","c","find","x","types","includes","short_name","long_name","parseGoogleAddressComponents","formattedAddress","lat","lng","list","firstLine","split","trim","country","toUpperCase","state","city","district","undefined","neighborhood","route","streetNumber","postal","street","number","zip_code","cityOut","stateOut","out","latitude","longitude","isAddressSelectionComplete","parsed","required","reqState","reqCity","reqStreet","reqNumber","reqPostal","length"],"sourceRoot":"../../../src","sources":["utils/parseGoogleAddressComponents.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/personNameNormalize.js

@@ -0,0 +1,20 @@
+"use strict";
+
+/**
+ * Normalizes a single name field (given names or surnames) for API submission.
+ *
+ * - Trims leading/trailing whitespace
+ * - Applies Unicode NFC (composed form) for consistent encoding
+ * - Splits on any run of whitespace and rejoins with a single ASCII space,
+ *   so multiple internal spaces or line breaks become one separator between words
+ */
+export function normalizePersonNameSegment(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) {
+    return '';
+  }
+  const nfc = trimmed.normalize('NFC');
+  const words = nfc.split(/\s+/).filter(w => w.length > 0);
+  return words.join(' ');
+}
+//# sourceMappingURL=personNameNormalize.js.map

package/lib/module/utils/personNameNormalize.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["normalizePersonNameSegment","raw","trimmed","trim","length","nfc","normalize","words","split","filter","w","join"],"sourceRoot":"../../../src","sources":["utils/personNameNormalize.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,0BAA0BA,CAACC,GAAW,EAAU;EAC9D,MAAMC,OAAO,GAAGD,GAAG,CAACE,IAAI,CAAC,CAAC;EAC1B,IAAID,OAAO,CAACE,MAAM,KAAK,CAAC,EAAE;IACxB,OAAO,EAAE;EACX;EACA,MAAMC,GAAG,GAAGH,OAAO,CAACI,SAAS,CAAC,KAAK,CAAC;EACpC,MAAMC,KAAK,GAAGF,GAAG,CAACG,KAAK,CAAC,KAAK,CAAC,CAACC,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACN,MAAM,GAAG,CAAC,CAAC;EAC1D,OAAOG,KAAK,CAACI,IAAI,CAAC,GAAG,CAAC;AACxB","ignoreList":[]}

package/lib/module/utils/sdkError.js

@@ -0,0 +1,29 @@
+"use strict";
+
+/**
+ * @fileoverview Helpers to normalize thrown values into SdkError for consistent onError delivery.
+ */
+
+/**
+ * Returns true if the value looks like an SdkError (has code and message).
+ */
+export function isSdkError(value) {
+  return value != null && typeof value === 'object' && 'code' in value && typeof value.code === 'string' && 'message' in value && typeof value.message === 'string';
+}
+
+/**
+ * Normalizes any thrown value to an SdkError so it can be passed to rejectStep/onError.
+ * Use when catching in a flow that must always end with an event to the implementer.
+ */
+export function toSdkError(err, defaultCode, defaultMessage) {
+  if (isSdkError(err)) {
+    return err;
+  }
+  const message = err instanceof Error ? err.message : typeof err === 'string' ? err : defaultMessage;
+  return {
+    code: defaultCode,
+    message: message || defaultMessage,
+    cause: err
+  };
+}
+//# sourceMappingURL=sdkError.js.map

package/lib/module/utils/sdkError.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isSdkError","value","code","message","toSdkError","err","defaultCode","defaultMessage","Error","cause"],"sourceRoot":"../../../src","sources":["utils/sdkError.ts"],"mappings":";;AAAA;AACA;AACA;;AAIA;AACA;AACA;AACA,OAAO,SAASA,UAAUA,CAACC,KAAc,EAAqB;EAC5D,OACEA,KAAK,IAAI,IAAI,IACb,OAAOA,KAAK,KAAK,QAAQ,IACzB,MAAM,IAAIA,KAAK,IACf,OAAQA,KAAK,CAAcC,IAAI,KAAK,QAAQ,IAC5C,SAAS,IAAID,KAAK,IAClB,OAAQA,KAAK,CAAcE,OAAO,KAAK,QAAQ;AAEnD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CACxBC,GAAY,EACZC,WAAyB,EACzBC,cAAsB,EACZ;EACV,IAAIP,UAAU,CAACK,GAAG,CAAC,EAAE;IACnB,OAAOA,GAAG;EACZ;EACA,MAAMF,OAAO,GACXE,GAAG,YAAYG,KAAK,GAAGH,GAAG,CAACF,OAAO,GAAG,OAAOE,GAAG,KAAK,QAAQ,GAAGA,GAAG,GAAGE,cAAc;EACrF,OAAO;IACLL,IAAI,EAAEI,WAAW;IACjBH,OAAO,EAAEA,OAAO,IAAII,cAAc;IAClCE,KAAK,EAAEJ;EACT,CAAC;AACH","ignoreList":[]}

package/lib/module/utils/sdkVersion.js

@@ -0,0 +1,9 @@
+"use strict";
+
+/**
+ * Compile-time SDK version string sent on every authenticated request as
+ * `X-Velion-SDK-Version`. Bump it together with `sdk/package.json#version`
+ * on every release.
+ */
+export const SDK_VERSION = '0.1.0';
+//# sourceMappingURL=sdkVersion.js.map

package/lib/module/utils/sdkVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SDK_VERSION"],"sourceRoot":"../../../src","sources":["utils/sdkVersion.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,WAAW,GAAG,OAAgB","ignoreList":[]}

package/lib/module/utils/stepConfig.js

@@ -0,0 +1,59 @@
+"use strict";
+
+export function resolveDocumentOptionsFromStepConfig(cfg) {
+  const rows = cfg?.accepted_country_documents;
+  if (!Array.isArray(rows)) return undefined;
+  const out = [];
+  for (const country of rows) {
+    const docs = country?.document_types;
+    if (!Array.isArray(docs)) continue;
+    for (const d of docs) {
+      const id = d?.id;
+      if (!id || typeof id !== 'string') continue;
+      out.push({
+        value: id,
+        label: typeof d.display_value === 'string' && d.display_value.trim().length > 0 ? d.display_value : id
+      });
+    }
+  }
+  return out.length > 0 ? dedupeByValue(out) : undefined;
+}
+export function resolveCaptureModeFromStepConfig(cfg) {
+  const methods = cfg?.capture_methods;
+  if (!methods) return undefined;
+  const camera = methods.camera_scan !== false;
+  const upload = methods.upload !== false;
+  if (camera && upload) return 'both';
+  if (camera) return 'camera';
+  if (upload) return 'file';
+  return 'both';
+}
+export function resolveTermsFromStepConfig(cfg) {
+  const terms = cfg?.terms;
+  if (!Array.isArray(terms)) return undefined;
+  const parsed = [];
+  for (const [index, term] of terms.entries()) {
+    const title = typeof term?.title === 'string' ? term.title.trim() : '';
+    const url = typeof term?.url === 'string' ? term.url.trim() : '';
+    if (!title && !url) continue;
+    parsed.push({
+      id: `term-${index + 1}`,
+      description: title || url,
+      ...(url && {
+        link: url
+      })
+    });
+  }
+  return parsed.length > 0 ? parsed : undefined;
+}
+function dedupeByValue(options) {
+  const seen = new Set();
+  const out = [];
+  for (const opt of options) {
+    if (seen.has(opt.value)) continue;
+    seen.add(opt.value);
+    out.push(opt);
+  }
+  return out;
+}
+//# sourceMappingURL=stepConfig.js.map

package/lib/module/utils/stepConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resolveDocumentOptionsFromStepConfig","cfg","rows","accepted_country_documents","Array","isArray","undefined","out","country","docs","document_types","d","id","push","value","label","display_value","trim","length","dedupeByValue","resolveCaptureModeFromStepConfig","methods","capture_methods","camera","camera_scan","upload","resolveTermsFromStepConfig","terms","parsed","index","term","entries","title","url","description","link","options","seen","Set","opt","has","add"],"sourceRoot":"../../../src","sources":["utils/stepConfig.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/taxInfoConfig.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/**
+ * Normalizes selectable lists for TAX_INFO. Options come only from the backend
+ * `current_step.config.accepted_tax_information` (see TaxInfoModule); there are no SDK defaults.
+ */
+export function resolveTaxInfoConfig(config) {
+  const categories = config?.taxpayerCategories;
+  const fiscal = config?.fiscalIdentifierTypes;
+  return {
+    taxpayerCategories: Array.isArray(categories) ? categories : [],
+    fiscalIdentifierTypes: Array.isArray(fiscal) ? fiscal : []
+  };
+}
+//# sourceMappingURL=taxInfoConfig.js.map

package/lib/module/utils/taxInfoConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resolveTaxInfoConfig","config","categories","taxpayerCategories","fiscal","fiscalIdentifierTypes","Array","isArray"],"sourceRoot":"../../../src","sources":["utils/taxInfoConfig.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASA,oBAAoBA,CAACC,MAA0C,EAAiB;EAC9F,MAAMC,UAAU,GAAGD,MAAM,EAAEE,kBAAkB;EAC7C,MAAMC,MAAM,GAAGH,MAAM,EAAEI,qBAAqB;EAC5C,OAAO;IACLF,kBAAkB,EAAEG,KAAK,CAACC,OAAO,CAACL,UAAU,CAAC,GAAGA,UAAU,GAAG,EAAE;IAC/DG,qBAAqB,EAAEC,KAAK,CAACC,OAAO,CAACH,MAAM,CAAC,GAAGA,MAAM,GAAG;EAC1D,CAAC;AACH","ignoreList":[]}

package/lib/typescript/camera/AddressSearchBar.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Address search bar for the assisted ADDRESS_INFO flow.
+ *
+ * Uses the OS-native forward geocoder (`expo-location.geocodeAsync`) with a
+ * debounced TextInput. No Google REST calls, no API key, no native bridges.
+ *
+ * `geocodeAsync` returns coordinates only, so for each candidate we run a
+ * reverse geocode in parallel to produce a human-readable label (and the
+ * parsed address structure used by the rest of the flow). Limited to the
+ * top 5 candidates to bound the work per query.
+ *
+ * Trade-off vs Google Places autocomplete: this suggests when the user
+ * pauses typing (~400ms), not on every keystroke. Quality on Apple Maps
+ * (iOS) and Google Play Services geocoder (Android) is enough for urban
+ * LATAM addresses — for KYC the user usually knows their full address.
+ */
+import type { ParsedAddressFields } from '../utils/parseGoogleAddressComponents';
+export interface AddressSuggestion {
+    label: string;
+    latitude: number;
+    longitude: number;
+    parsed: ParsedAddressFields & {
+        latitude: number;
+        longitude: number;
+    };
+}
+export interface AddressSearchBarProps {
+    placeholder: string;
+    searchingLabel: string;
+    noResultsLabel: string;
+    /** Called when the user picks a suggestion. */
+    onSelect: (suggestion: AddressSuggestion) => void;
+    /** Restrict matches to these ISO 3166-1 alpha-2 codes (best-effort filter). */
+    countryAllow?: ReadonlyArray<string> | undefined;
+}
+export declare function AddressSearchBar({ placeholder, searchingLabel, noResultsLabel, onSelect, countryAllow, }: AddressSearchBarProps): import("react").JSX.Element;
+//# sourceMappingURL=AddressSearchBar.d.ts.map

package/lib/typescript/camera/AddressSearchBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressSearchBar.d.ts","sourceRoot":"","sources":["../../../src/camera/AddressSearchBar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsBH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,+EAA+E;IAC/E,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,WAAW,EACX,cAAc,EACd,cAAc,EACd,QAAQ,EACR,YAAY,GACb,EAAE,qBAAqB,+BAwNvB"}

package/lib/typescript/camera/DocumentCapture.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Full-screen document camera with an ID-1 frame guide.
+ *
+ * Uses `react-native-vision-camera` v4 in `photo` mode. Tapping the shutter
+ * triggers `takePhoto()` with `qualityPrioritization: 'balanced'`; the file
+ * URI is returned to the caller via `onCaptured`.
+ *
+ * Visual: dark scrim with a transparent rectangular cutout (ID-1 16:10 ratio
+ * by default). The cutout is the visible-only guide — we do NOT crop the
+ * image client-side because the server's OCR pipeline rejects soft crops.
+ * The user is asked to fill the frame; the backend handles edge detection.
+ *
+ * No edge detection / OpenCV port (intentional MVP scope per the brief).
+ */
+import { type PhotoFile } from 'react-native-vision-camera';
+import type { DocumentOrientation, DocumentSide } from '../types';
+export interface DocumentCaptureProps {
+    side: DocumentSide;
+    orientation: DocumentOrientation;
+    /** Localized instruction shown above the cutout. */
+    instructions: string;
+    /** Localized "Take photo" label for the shutter button. */
+    captureLabel: string;
+    /** Localized error string when permission is denied. */
+    permissionDeniedLabel: string;
+    /** Localized "Try again" label. */
+    retryLabel: string;
+    /** Localized "Cancel" / back label. */
+    cancelLabel: string;
+    onCaptured: (photo: PhotoFile, side: DocumentSide) => void;
+    onCancel: () => void;
+}
+export declare function DocumentCapture({ side, orientation, instructions, captureLabel, permissionDeniedLabel, retryLabel, cancelLabel, onCaptured, onCancel, }: DocumentCaptureProps): import("react").JSX.Element;
+//# sourceMappingURL=DocumentCapture.d.ts.map

package/lib/typescript/camera/DocumentCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentCapture.d.ts","sourceRoot":"","sources":["../../../src/camera/DocumentCapture.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIlE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,mBAAmB,CAAC;IACjC,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3D,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,GACT,EAAE,oBAAoB,+BA0NtB"}

package/lib/typescript/camera/LivenessCamera.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Liveness camera surface — front-facing vision-camera with an
+ * oval mask, status pill, and capture loop driven by the parent step.
+ *
+ * Capture strategy: vision-camera v4 frame processors run on a worklet thread
+ * and don't expose the JPEG bytes back to JS without a custom native plugin.
+ * We avoid that complication by using `takePhoto({ qualityPrioritization:
+ * 'speed' })` on a JS-level interval (matches the `setInterval` pattern in
+ * `web/LivenessModule.ts`). Real-world FPS lands around 3–8 fps which is
+ * sufficient for Iris's challenge cadence.
+ *
+ * The parent owns the loop and the WebSocket — this component just exposes a
+ * `captureFrame` ref so the step can drive the timing while the camera stays
+ * mounted across challenges.
+ */
+import { type PhotoFile } from 'react-native-vision-camera';
+export interface LivenessCameraHandle {
+    takeFrame: () => Promise<PhotoFile | null>;
+}
+/**
+ * Visual cue applied to the oval guide. The parent maps the current Iris
+ * challenge to one of these so the oval animates in a way that reinforces
+ * the instruction (oval grows for MOVE_CLOSER, shrinks back for MOVE_FARTHER,
+ * stays neutral otherwise).
+ */
+export type LivenessOvalCue = 'NEUTRAL' | 'MOVE_CLOSER' | 'MOVE_FARTHER';
+export interface LivenessCameraProps {
+    /** Status text rendered in the centred pill. Pass `null` to hide it. */
+    statusText: string | null;
+    /** Active challenge instruction (rendered above the oval). Optional. */
+    challengeText?: string | null | undefined;
+    /** Visual cue for the oval shape (size animation). Defaults to NEUTRAL. */
+    ovalCue?: LivenessOvalCue | undefined;
+    /** Toast text — passed in as a `{ kind, message }` so the parent owns timing. */
+    toast?: {
+        kind: 'success' | 'warning';
+        message: string;
+    } | null | undefined;
+    /** Linear progress 0–1 shown under the oval (CHALLENGE_PROGRESS). */
+    progress?: number | null | undefined;
+    /** Localized permission denied copy. */
+    permissionDeniedLabel: string;
+    /** Localized retry label for the permission CTA. */
+    retryLabel: string;
+    /** Localized cancel / back label. */
+    cancelLabel: string;
+    onCancel?: (() => void) | undefined;
+}
+export declare const LivenessCamera: import("react").ForwardRefExoticComponent<LivenessCameraProps & import("react").RefAttributes<LivenessCameraHandle>>;
+//# sourceMappingURL=LivenessCamera.d.ts.map

package/lib/typescript/camera/LivenessCamera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LivenessCamera.d.ts","sourceRoot":"","sources":["../../../src/camera/LivenessCamera.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,4BAA4B,CAAC;AAIpC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,2EAA2E;IAC3E,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,iFAAiF;IACjF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5E,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACrC;AAED,eAAO,MAAM,cAAc,sHAgK1B,CAAC"}

package/lib/typescript/camera/MapAddressPicker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Full-screen map picker for the assisted ADDRESS_INFO flow.
+ *
+ *   - Draggable marker on a `MapView`. Provider per platform:
+ *       * Android → Google Maps (requires the integrator's API key in the
+ *         AndroidManifest, restricted by package name + SHA-1).
+ *       * iOS → Apple Maps (system map, no API key, no AirGoogleMaps
+ *         Xcode sub-target). Picked deliberately so the iOS build stays
+ *         lean and signing-only — Google on iOS would add ~5 MB and a
+ *         custom Expo plugin.
+ *   - Reverse geocoding via the OS-native geocoder (`utils/osGeocoder`) on
+ *     every marker move. We DO NOT use Google's REST Geocoding API because
+ *     it cannot be locked to a bundle ID — see osGeocoder.ts for the
+ *     rationale.
+ *   - Location permission is best-effort: if denied, the map centres on
+ *     Argentina and the user moves the pin to their address by hand.
+ *
+ * `react-native-maps` is an **optional peer dep** declared in
+ * `sdk/package.json`; this file imports it dynamically so hosts that never
+ * reach `ADDRESS_INFO` (or omit `googleMapsApiKey`) don't have to install
+ * it. The Google Places autocomplete search box has been removed — that
+ * library uses Google's Web Service REST API which also cannot be locked
+ * to a bundle ID. Users navigate the map by drag instead.
+ */
+import React from 'react';
+import { type ParsedAddressFields } from '../utils/parseGoogleAddressComponents';
+export interface MapAddressPickerProps {
+    locale: string;
+    /** Required for the "Next" button. */
+    nextLabel: string;
+    backLabel: string;
+    searchPlaceholder: string;
+    searchingLabel: string;
+    noResultsLabel: string;
+    geocodeError: string;
+    locationDenied: string;
+    /**
+     * Field-level required map — decides whether the "Next" button is enabled.
+     * Defaults to all fields required.
+     */
+    requiredFields?: {
+        state?: boolean | undefined;
+        city?: boolean | undefined;
+        street?: boolean | undefined;
+        number?: boolean | undefined;
+        postal?: boolean | undefined;
+    } | undefined;
+    /** Restrict autocomplete predictions to these alpha-2 country codes. */
+    countryAllow?: ReadonlyArray<string> | undefined;
+    onConfirm: (parsed: ParsedAddressFields & {
+        latitude: number;
+        longitude: number;
+    }) => void;
+    onBack: () => void;
+}
+export declare function MapAddressPicker(props: MapAddressPickerProps): React.JSX.Element;
+//# sourceMappingURL=MapAddressPicker.d.ts.map

package/lib/typescript/camera/MapAddressPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapAddressPicker.d.ts","sourceRoot":"","sources":["../../../src/camera/MapAddressPicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAKN,MAAM,OAAO,CAAC;AAcf,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,uCAAuC,CAAC;AAsE/C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC7B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC7B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAC9B,GAAG,SAAS,CAAC;IACd,wEAAwE;IACxE,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,SAAS,EAAE,CACT,MAAM,EAAE,mBAAmB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAClE,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,qBAgN7B"}

package/lib/typescript/core/VelionOnboarding.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview VelionOnboarding — orchestrator for the React Native SDK.
+ *
+ * Platform-agnostic dynamic state machine: deals with HTTP, SSE, dedupe and
+ * step-module orchestration. UI mounting is delegated to a React component
+ * (`VelionOnboardingScreen`) instead of direct DOM manipulation.
+ *
+ * Invariants:
+ *   - SSE dedupe by `event_id` (monotonic)
+ *   - Suppress duplicate `NEXT_STEP` for the just-completed step
+ *   - 45 s watchdog for terminal SSE event after final step → fallback GET
+ *   - SESSION_DECLINED handling races with module.run()
+ */
+import { type VelionConfig as WebVelionConfig, type SdkStatus, type SdkEventMap, type SdkError, type OnboardingResult } from '../types';
+import type { ReactNode } from 'react';
+/**
+ * RN-specific config. Drops web-only fields (`containerId`, `allowEmbedded`,
+ * `iframeParentOrigin`) and keeps everything else identical to
+ * `WebVelionConfig`, including `fingerprintEndpoint` and `fingerprintApiKey`
+ * — both are honoured by the native Fingerprint Pro SDK on mobile too.
+ */
+export type VelionConfig = Omit<WebVelionConfig, 'containerId' | 'allowEmbedded' | 'iframeParentOrigin'>;
+/**
+ * Optional view bridge given to the orchestrator by `VelionOnboardingScreen`.
+ *
+ * The orchestrator never reads from this — it only writes:
+ *   - `setLoading(text)` to display a status message between steps
+ *   - `setStepNode(node)` to mount the active step's UI
+ *   - `setError(err)` to surface a fatal error
+ *   - `setResult(result)` on flow completion (host may show their own result)
+ */
+export interface OrchestratorView {
+    setLoading?: (text: string | null) => void;
+    setStepNode?: (node: ReactNode | null) => void;
+    setError?: (err: SdkError) => void;
+    setResult?: (result: OnboardingResult) => void;
+}
+/**
+ * Top-level entry point. Instantiate once per session, call `start()`, and
+ * `destroy()` from the host's unmount path.
+ */
+export declare class VelionOnboarding {
+    private readonly config;
+    private readonly emitter;
+    private readonly api;
+    private readonly constructionError;
+    private status;
+    private activeModule;
+    private view;
+    private readonly uiHandle;
+    private initAbortController;
+    private sseAbortController;
+    private sseCleanup;
+    private sseTerminalResolve;
+    private sseNextStepResolve;
+    private queuedNextStepCommand;
+    private lastSseEventId;
+    private sessionDeclineHandler;
+    private pendingSessionDeclined;
+    private pendingTerminalEvent;
+    private sessionEnded;
+    constructor(config: VelionConfig);
+    /** Connects an `OrchestratorView` (typically `VelionOnboardingScreen`). */
+    attachView(view: OrchestratorView): void;
+    /** Detaches the active view (called from screen unmount). */
+    detachView(): void;
+    on<K extends keyof SdkEventMap>(event: K, listener: (payload: SdkEventMap[K]) => void): () => void;
+    getStatus(): SdkStatus;
+    /**
+     * Hot-rotate the bearer token used by every subsequent backend call. The SSE
+     * stream is also reopened so the new token reaches the server-side authenticator.
+     */
+    refreshSessionToken(token: string, expiresAt?: string): void;
+    start(): Promise<void>;
+    destroy(): void;
+    private initialize;
+    private validateSessionState;
+    private runStepMachine;
+    private createModule;
+    private finalizeSessionWithTerminalEvent;
+    private finalizeSessionSingleGet;
+    private completeFlow;
+    private endFlowWithSessionDeclined;
+    private openSseStream;
+    private handleSseEvent;
+    private extractNextStepCommand;
+    /**
+     * Wait for the next ROUTING_COMMAND. The orchestrator races this with a 30 s
+     * timeout that, on fire, falls back to a fresh GET /sessions/:id to recover
+     * if SSE was missed.
+     */
+    private resolveNextStepAfterCompletion;
+    private waitForRoutingAfterBackendOnlyStep;
+    private waitForTerminalSseEvent;
+    /**
+     * Drain a pending terminal event (e.g. SESSION_APPROVED arrived while the
+     * orchestrator was busy mid-step). Returns true when the flow has been ended
+     * by the consumed event.
+     */
+    private consumePendingTerminalEvent;
+    /**
+     * Race a step's promise against SESSION_DECLINED. If decline arrives first,
+     * `declined` is true so the caller can short-circuit cleanup.
+     */
+    private withSessionDeclineRace;
+    private wireExternalCallbacks;
+    private setStatus;
+    private emitError;
+    private isEnglish;
+    private localizedLoadingMsg;
+    private localizedProcessingMsg;
+    private localizedFinalizingMsg;
+    private showLoading;
+}
+//# sourceMappingURL=VelionOnboarding.d.ts.map

package/lib/typescript/core/VelionOnboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VelionOnboarding.d.ts","sourceRoot":"","sources":["../../../src/core/VelionOnboarding.ts"],"names":[],"mappings":"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"}