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

package/lib/commonjs/utils/jpegFromUri.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.readJpegFromUri = readJpegFromUri;
+var _expoFileSystem = require("expo-file-system");
+var _base = require("./base64");
+/**
+ * Helpers for reading a captured photo into JPEG bytes.
+ *
+ * Vision-Camera writes captures to a `file://` path; consumers convert that
+ * path into either base64 (for the Iris HMAC envelope) or raw bytes (for
+ * binary WebSocket frames + direct PUT to signed URLs).
+ *
+ * Why not `fetch(uri).then(r => r.blob()).then(b => b.arrayBuffer())`?
+ *
+ * React Native's Blob polyfill does NOT implement `Blob.arrayBuffer()`
+ * (it's web-only). Calling it crashes with
+ * `TypeError: blob.arrayBuffer is not a function`. The reliable path on
+ * iOS + Android is the native `File.arrayBuffer()` from
+ * `expo-file-system` v19+, which reads directly from disk into an
+ * ArrayBuffer without going through the JS Blob bridge.
+ */
+
+/**
+ * Reads a `file://` URI into JPEG bytes + base64 representation.
+ *
+ * Accepts both forms vision-camera returns (`/var/mobile/...` without a
+ * scheme on iOS; `file:///data/...` on Android). Normalises to `file://`.
+ */
+async function readJpegFromUri(uri) {
+  const normalised = uri.startsWith('file://') || uri.startsWith('http') ? uri : `file://${uri}`;
+  const file = new _expoFileSystem.File(normalised);
+  const buf = await file.arrayBuffer();
+  const bytes = new Uint8Array(buf);
+  const base64 = (0, _base.bytesToBase64)(bytes);
+  return {
+    bytes,
+    base64,
+    byteLength: bytes.byteLength
+  };
+}
+//# sourceMappingURL=jpegFromUri.js.map

package/lib/commonjs/utils/jpegFromUri.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_expoFileSystem","require","_base","readJpegFromUri","uri","normalised","startsWith","file","File","buf","arrayBuffer","bytes","Uint8Array","base64","bytesToBase64","byteLength"],"sourceRoot":"../../../src","sources":["utils/jpegFromUri.ts"],"mappings":";;;;;;AAiBA,IAAAA,eAAA,GAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AAlBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeE,eAAeA,CAACC,GAAW,EAAwB;EACvE,MAAMC,UAAU,GAAGD,GAAG,CAACE,UAAU,CAAC,SAAS,CAAC,IAAIF,GAAG,CAACE,UAAU,CAAC,MAAM,CAAC,GAClEF,GAAG,GACH,UAAUA,GAAG,EAAE;EACnB,MAAMG,IAAI,GAAG,IAAIC,oBAAI,CAACH,UAAU,CAAC;EACjC,MAAMI,GAAG,GAAG,MAAMF,IAAI,CAACG,WAAW,CAAC,CAAC;EACpC,MAAMC,KAAK,GAAG,IAAIC,UAAU,CAACH,GAAG,CAAC;EACjC,MAAMI,MAAM,GAAG,IAAAC,mBAAa,EAACH,KAAK,CAAC;EACnC,OAAO;IAAEA,KAAK;IAAEE,MAAM;IAAEE,UAAU,EAAEJ,KAAK,CAACI;EAAW,CAAC;AACxD","ignoreList":[]}

package/lib/commonjs/utils/keepAwake.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.activateScreenKeepAwake = activateScreenKeepAwake;
+exports.deactivateScreenKeepAwake = deactivateScreenKeepAwake;
+var _log = require("./log");
+/**
+ * Thin wrapper around `expo-keep-awake` that prevents the device from
+ * locking the screen while the SDK is in the foreground. Without this,
+ * Android's screen-timeout policy kicks in during camera-heavy steps
+ * (LIVENESS_MATCH, DOCUMENTS_OCR) where the user is holding still and
+ * not interacting with the touchscreen — the screen dims, then locks,
+ * and the session is interrupted.
+ *
+ * Implementation is `require`-based so the SDK keeps working in bare
+ * React Native setups where `expo-keep-awake` may not be installed —
+ * in that case both calls degrade to no-ops and the host is expected to
+ * manage the wake lock itself.
+ */
+
+const TAG = 'velion-onboarding-sdk';
+let activated = false;
+function loadModule() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const mod = require('expo-keep-awake');
+    return mod?.default ?? mod;
+  } catch {
+    return null;
+  }
+}
+function activateScreenKeepAwake() {
+  if (activated) return;
+  const mod = loadModule();
+  if (!mod?.activateKeepAwakeAsync) {
+    _log.log.info('[keep-awake] expo-keep-awake unavailable; host should manage the wake lock if screen-lock is unwanted during the flow');
+    return;
+  }
+  activated = true;
+  void mod.activateKeepAwakeAsync(TAG).catch(err => {
+    activated = false;
+    _log.log.warn('[keep-awake] activate failed', err);
+  });
+}
+function deactivateScreenKeepAwake() {
+  if (!activated) return;
+  const mod = loadModule();
+  activated = false;
+  if (!mod?.deactivateKeepAwake) return;
+  try {
+    void mod.deactivateKeepAwake(TAG);
+  } catch (err) {
+    _log.log.warn('[keep-awake] deactivate failed', err);
+  }
+}
+//# sourceMappingURL=keepAwake.js.map

package/lib/commonjs/utils/keepAwake.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_log","require","TAG","activated","loadModule","mod","default","activateScreenKeepAwake","activateKeepAwakeAsync","log","info","catch","err","warn","deactivateScreenKeepAwake","deactivateKeepAwake"],"sourceRoot":"../../../src","sources":["utils/keepAwake.ts"],"mappings":";;;;;;;AAcA,IAAAA,IAAA,GAAAC,OAAA;AAdA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMC,GAAG,GAAG,uBAAuB;AAEnC,IAAIC,SAAS,GAAG,KAAK;AAOrB,SAASC,UAAUA,CAAA,EAA+B;EAChD,IAAI;IACF;IACA,MAAMC,GAAG,GAAGJ,OAAO,CAAC,iBAAiB,CAAC;IACtC,OAAQI,GAAG,EAAEC,OAAO,IAAID,GAAG;EAC7B,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;AAEO,SAASE,uBAAuBA,CAAA,EAAS;EAC9C,IAAIJ,SAAS,EAAE;EACf,MAAME,GAAG,GAAGD,UAAU,CAAC,CAAC;EACxB,IAAI,CAACC,GAAG,EAAEG,sBAAsB,EAAE;IAChCC,QAAG,CAACC,IAAI,CACN,uHACF,CAAC;IACD;EACF;EACAP,SAAS,GAAG,IAAI;EAChB,KAAKE,GAAG,CAACG,sBAAsB,CAACN,GAAG,CAAC,CAACS,KAAK,CAAEC,GAAY,IAAK;IAC3DT,SAAS,GAAG,KAAK;IACjBM,QAAG,CAACI,IAAI,CAAC,8BAA8B,EAAED,GAAG,CAAC;EAC/C,CAAC,CAAC;AACJ;AAEO,SAASE,yBAAyBA,CAAA,EAAS;EAChD,IAAI,CAACX,SAAS,EAAE;EAChB,MAAME,GAAG,GAAGD,UAAU,CAAC,CAAC;EACxBD,SAAS,GAAG,KAAK;EACjB,IAAI,CAACE,GAAG,EAAEU,mBAAmB,EAAE;EAC/B,IAAI;IACF,KAAKV,GAAG,CAACU,mBAAmB,CAACb,GAAG,CAAC;EACnC,CAAC,CAAC,OAAOU,GAAG,EAAE;IACZH,QAAG,CAACI,IAAI,CAAC,gCAAgC,EAAED,GAAG,CAAC;EACjD;AACF","ignoreList":[]}

package/lib/commonjs/utils/log.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.log = void 0;
+exports.setDebugEnabled = setDebugEnabled;
+/**
+ * @fileoverview Lightweight log gate.
+ *
+ * `log.info()` is silent unless either:
+ *   - `__DEV__` is true (Metro bundler injects this in development), or
+ *   - the host explicitly opted in via `VelionConfig.debug = true`.
+ *
+ * `log.warn()` / `log.error()` always go through. They sit on top of `console.*`
+ * so the host's logging pipeline (Sentry, Datadog, …) keeps capturing them.
+ */
+
+let runtimeDebugEnabled = false;
+
+/** Enables verbose logging at runtime. Called from VelionOnboarding when `config.debug === true`. */
+function setDebugEnabled(enabled) {
+  runtimeDebugEnabled = enabled;
+}
+
+/** Internal — true when `log.info` should produce output. */
+function infoEnabled() {
+  return typeof __DEV__ !== 'undefined' && __DEV__ === true || runtimeDebugEnabled;
+}
+const log = exports.log = {
+  info(...args) {
+    if (!infoEnabled()) return;
+    console.info('[VelionSDK]', ...args);
+  },
+  warn(...args) {
+    console.warn('[VelionSDK]', ...args);
+  },
+  error(...args) {
+    console.error('[VelionSDK]', ...args);
+  }
+};
+//# sourceMappingURL=log.js.map

package/lib/commonjs/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["runtimeDebugEnabled","setDebugEnabled","enabled","infoEnabled","__DEV__","log","exports","info","args","console","warn","error"],"sourceRoot":"../../../src","sources":["utils/log.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,IAAIA,mBAAmB,GAAG,KAAK;;AAE/B;AACO,SAASC,eAAeA,CAACC,OAAgB,EAAQ;EACtDF,mBAAmB,GAAGE,OAAO;AAC/B;;AAEA;AACA,SAASC,WAAWA,CAAA,EAAY;EAC9B,OAAQ,OAAOC,OAAO,KAAK,WAAW,IAAIA,OAAO,KAAK,IAAI,IAAKJ,mBAAmB;AACpF;AAEO,MAAMK,GAAG,GAAAC,OAAA,CAAAD,GAAA,GAAG;EACjBE,IAAIA,CAAC,GAAGC,IAAe,EAAQ;IAC7B,IAAI,CAACL,WAAW,CAAC,CAAC,EAAE;IACpBM,OAAO,CAACF,IAAI,CAAC,aAAa,EAAE,GAAGC,IAAI,CAAC;EACtC,CAAC;EACDE,IAAIA,CAAC,GAAGF,IAAe,EAAQ;IAC7BC,OAAO,CAACC,IAAI,CAAC,aAAa,EAAE,GAAGF,IAAI,CAAC;EACtC,CAAC;EACDG,KAAKA,CAAC,GAAGH,IAAe,EAAQ;IAC9BC,OAAO,CAACE,KAAK,CAAC,aAAa,EAAE,GAAGH,IAAI,CAAC;EACvC;AACF,CAAC","ignoreList":[]}

package/lib/commonjs/utils/osGeocoder.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.reverseGeocode = reverseGeocode;
+var Location = _interopRequireWildcard(require("expo-location"));
+var _log = require("./log");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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.
+ */
+
+/**
+ * Returns parsed structured address fields, or `null` when the OS geocoder
+ * has no match.
+ */
+async function reverseGeocode(args) {
+  let results;
+  try {
+    results = await Location.reverseGeocodeAsync({
+      latitude: args.latitude,
+      longitude: args.longitude
+    });
+  } catch (err) {
+    _log.log.warn('[os-geocoder] reverse failed', err);
+    return null;
+  }
+  if (!results || results.length === 0) {
+    _log.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/commonjs/utils/osGeocoder.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Location","_interopRequireWildcard","require","_log","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","reverseGeocode","args","results","reverseGeocodeAsync","latitude","longitude","err","log","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":";;;;;;AAuBA,IAAAA,QAAA,GAAAC,uBAAA,CAAAC,OAAA;AAIA,IAAAC,IAAA,GAAAD,OAAA;AAA4B,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AA3B5B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACO,eAAekB,cAAcA,CAClCC,IAAwB,EACyD;EACjF,IAAIC,OAA2C;EAC/C,IAAI;IACFA,OAAO,GAAG,MAAMzB,QAAQ,CAAC0B,mBAAmB,CAAC;MAC3CC,QAAQ,EAAEH,IAAI,CAACG,QAAQ;MACvBC,SAAS,EAAEJ,IAAI,CAACI;IAClB,CAAC,CAAC;EACJ,CAAC,CAAC,OAAOC,GAAG,EAAE;IACZC,QAAG,CAACC,IAAI,CAAC,8BAA8B,EAAEF,GAAG,CAAC;IAC7C,OAAO,IAAI;EACb;EACA,IAAI,CAACJ,OAAO,IAAIA,OAAO,CAACO,MAAM,KAAK,CAAC,EAAE;IACpCF,QAAG,CAACG,IAAI,CAAC,0BAA0B,CAAC;IACpC,OAAO,IAAI;EACb;EACA,MAAMC,GAAG,GAAGT,OAAO,CAAC,CAAC,CAAE;EACvB,MAAMU,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;IAC9BtB,QAAQ,EAAEH,IAAI,CAACG,QAAQ;IACvBC,SAAS,EAAEJ,IAAI,CAACI;EAClB,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/utils/parseGoogleAddressComponents.js

@@ -0,0 +1,74 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isAddressSelectionComplete = isAddressSelectionComplete;
+exports.parseGoogleAddressComponents = parseGoogleAddressComponents;
+/**
+ * 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.
+ */
+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.
+ */
+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/commonjs/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/commonjs/utils/personNameNormalize.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.normalizePersonNameSegment = normalizePersonNameSegment;
+/**
+ * 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
+ */
+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/commonjs/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;AACO,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/commonjs/utils/sdkError.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isSdkError = isSdkError;
+exports.toSdkError = toSdkError;
+/**
+ * @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).
+ */
+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.
+ */
+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/commonjs/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;AACO,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;AACO,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/commonjs/utils/sdkVersion.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SDK_VERSION = void 0;
+/**
+ * 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.
+ */
+const SDK_VERSION = exports.SDK_VERSION = '0.1.0';
+//# sourceMappingURL=sdkVersion.js.map

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

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

package/lib/commonjs/utils/stepConfig.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveCaptureModeFromStepConfig = resolveCaptureModeFromStepConfig;
+exports.resolveDocumentOptionsFromStepConfig = resolveDocumentOptionsFromStepConfig;
+exports.resolveTermsFromStepConfig = resolveTermsFromStepConfig;
+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;
+}
+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';
+}
+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/commonjs/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/commonjs/utils/taxInfoConfig.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveTaxInfoConfig = resolveTaxInfoConfig;
+/**
+ * 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.
+ */
+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/commonjs/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;AACO,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":[]}