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

package/lib/module/types/index.js

@@ -0,0 +1,457 @@
+"use strict";
+
+/**
+ * @fileoverview Public TypeScript contracts for the Velion Onboarding SDK.
+ *
+ * Design principle: All types exported from this file constitute the public API.
+ * Internal implementation types should live alongside their respective modules.
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// STEP & FLOW TYPES
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * The complete set of onboarding steps the backend can require.
+ * The SDK dynamically receives the active subset for each session.
+ *
+ * @remarks
+ * - `DEVICE_FINGERPRINT`: Silently collects device entropy via FingerprintJS.
+ * - `DOCUMENTS_OCR`: Renders a UI for ID document image capture and upload.
+ * - `LIVENESS_MATCH`: Drives the Velion Iris active-liveness flow over WebSocket (HUMAN only).
+ * - `EMAIL_OTP` / `PHONE_OTP`: Contact verification via one-time passwords.
+ * - `HUMAN_BASIC_INFO`: Natural-person identification data (HUMAN only).
+ * - `LEGAL_BASIC_INFO`: Legal-entity identification data (LEGAL only).
+ * - `EMAIL_CONTACT` / `PHONE_CONTACT`: contact collection without OTP.
+ * - `TAX_INFO`, `HUMAN_EXTENDED_INFO`, `LEGAL_EXTENDED_INFO`, `ADDRESS_INFO`, `SWORN_DECLARATION`: form steps.
+ * - `TERMS_AND_CONDITIONS`: accept configured T&C items.
+ * - `FACE_MATCH`: server-side face comparison after liveness (no user input; SDK waits).
+ */
+
+/**
+ * Status of an individual onboarding step (matches backend OnboardingStepStatus).
+ */
+
+/**
+ * Type of onboarding session (matches backend OnboardingType).
+ * Constrains which steps are valid: HUMAN allows biometric steps, LEGAL uses entity data.
+ */
+
+/** Which face of the ID document is being captured. */
+
+/**
+ * How the user can provide document images in the DOCUMENTS_OCR step.
+ * - `'camera'`: Only "Take photo" (opens camera on supported devices).
+ * - `'file'`: Only "Choose file" (file picker).
+ * - `'both'`: Both options; implementer can style via theme.
+ *
+ * @default 'both'
+ */
+
+/**
+ * Orientation of the document capture cutout / crop frame.
+ * - `'landscape'`: Horizontal card (default — standard ID-1 cards).
+ * - `'portrait'`: Vertical card (e.g. some passports, residence permits).
+ *
+ * @default 'landscape'
+ */
+
+/** Generic visible/required field toggle used by workflow step configs. */
+
+/** Select option used by configurable step fields (e.g. HUMAN_EXTENDED_INFO gender/civil_status). */
+
+/** Field rule with optional selectable options. */
+
+/** STEP config for HUMAN_BASIC_INFO. */
+
+/**
+ * One selectable option row from TAX_INFO `accepted_tax_information` (backend GET session).
+ * Prefer `code` as the value sent in POST tax-info; `id` is supported for older payloads.
+ */
+
+/** One country block in TAX_INFO step config (GET session `current_step.config`). */
+
+/** STEP config for TAX_INFO. */
+
+/** STEP config for HUMAN_EXTENDED_INFO. */
+
+/** STEP config for ADDRESS_INFO. */
+
+/** STEP config for SWORN_DECLARATION. */
+
+/** STEP config for DOCUMENTS_OCR. */
+
+/** STEP config for TERMS_AND_CONDITIONS. */
+
+/** Generic per-step runtime config map carried by session state and SSE. */
+
+/**
+ * Request body for POST /sessions/:sessionId/documents-init.
+ * Allowed values are defined by the backend; the SDK currently sends a fixed type until
+ * the session exposes selectable document types.
+ */
+
+/**
+ * Response from POST /sessions/:sessionId/documents-init.
+ * Backend returns signed upload URLs so the SDK can PUT each document side
+ * directly to storage (e.g. GCS) without routing bytes through the backend.
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ERROR TYPES
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Granular error codes for camera/hardware failures.
+ * Allows consumers to display localized, actionable messages to end-users.
+ */
+export let CameraErrorCode = /*#__PURE__*/function (CameraErrorCode) {
+  /** User explicitly denied camera access in the browser permission dialog. */
+  CameraErrorCode["PERMISSION_DENIED"] = "CAMERA_PERMISSION_DENIED";
+  /** No camera device was detected on the system. */
+  CameraErrorCode["DEVICE_NOT_FOUND"] = "CAMERA_DEVICE_NOT_FOUND";
+  /**
+   * The camera could not be opened for reading (often in use by another app,
+   * or blocked at the OS level). Maps to `NotReadableError` / `TrackStartError`.
+   */
+  CameraErrorCode["DEVICE_NOT_READABLE"] = "CAMERA_DEVICE_NOT_READABLE";
+  /**
+   * The page is served over HTTP (not HTTPS) in a production environment.
+   * `getUserMedia` is blocked by the browser's Secure Context policy.
+   */
+  CameraErrorCode["INSECURE_CONTEXT"] = "CAMERA_INSECURE_CONTEXT";
+  /**
+   * Browser policy blocked camera (e.g. cross-origin iframe without permission,
+   * or `Permissions-Policy` / Feature-Policy denying camera). Maps to `SecurityError`
+   * from `getUserMedia` — distinct from {@link INSECURE_CONTEXT} (non-HTTPS).
+   */
+  CameraErrorCode["POLICY_BLOCKED"] = "CAMERA_POLICY_BLOCKED";
+  /** The browser or WebView does not support the `getUserMedia` API. */
+  CameraErrorCode["NOT_SUPPORTED"] = "CAMERA_NOT_SUPPORTED";
+  /**
+   * Camera access is blocked by a WebView policy (common in in-app browsers
+   * on iOS/Android that restrict hardware access).
+   */
+  CameraErrorCode["WEBVIEW_BLOCKED"] = "CAMERA_WEBVIEW_BLOCKED";
+  /** The requested video constraints (resolution, facing mode) are not satisfiable. */
+  CameraErrorCode["CONSTRAINT_ERROR"] = "CAMERA_CONSTRAINT_ERROR";
+  /** An unclassified camera error occurred. Check `cause` for details. */
+  CameraErrorCode["UNKNOWN"] = "CAMERA_UNKNOWN_ERROR";
+  return CameraErrorCode;
+}({});
+
+/**
+ * Top-level SDK error codes covering all failure scenarios in the onboarding flow.
+ */
+export let SdkErrorCode = /*#__PURE__*/function (SdkErrorCode) {
+  // ── Session ──────────────────────────────────────────────────────────────
+  /** The sessionToken was rejected by the backend (401/403). */
+  SdkErrorCode["SESSION_INVALID"] = "SESSION_INVALID";
+  /** The sessionToken has expired (typically a 401 after initial validation). */
+  SdkErrorCode["SESSION_EXPIRED"] = "SESSION_EXPIRED";
+  /** Could not fetch the initial session state from the backend. */
+  SdkErrorCode["SESSION_FETCH_FAILED"] = "SESSION_FETCH_FAILED";
+  /** Backend sent SESSION_DECLINED over SSE; session ended before completion. */
+  SdkErrorCode["SESSION_DECLINED"] = "SESSION_DECLINED";
+  // ── Modules ──────────────────────────────────────────────────────────────
+  /** FingerprintJS failed to generate the visitor ID. */
+  SdkErrorCode["FINGERPRINT_FAILED"] = "FINGERPRINT_FAILED";
+  /** One or more document images failed to upload successfully. */
+  SdkErrorCode["DOCUMENT_UPLOAD_FAILED"] = "DOCUMENT_UPLOAD_FAILED";
+  /** The liveness check did not pass or returned an unexpected result. */
+  SdkErrorCode["LIVENESS_FAILED"] = "LIVENESS_FAILED";
+  /** The Liveness module failed to initialize (e.g., could not create the Iris session). */
+  SdkErrorCode["LIVENESS_INIT_FAILED"] = "LIVENESS_INIT_FAILED";
+  // ── Camera ───────────────────────────────────────────────────────────────
+  /**
+   * A camera-related error occurred. Inspect `cameraCode` for the specific reason.
+   * @see CameraErrorCode
+   */
+  SdkErrorCode["CAMERA_ERROR"] = "CAMERA_ERROR";
+  // ── Network & API ────────────────────────────────────────────────────────
+  /** A network-level failure (no internet, CORS, DNS). */
+  SdkErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+  /** The backend returned a non-2xx HTTP status. */
+  SdkErrorCode["API_ERROR"] = "API_ERROR";
+  // ── Configuration ────────────────────────────────────────────────────────
+  /** The `containerId` provided in the config does not exist in the DOM. */
+  SdkErrorCode["CONTAINER_NOT_FOUND"] = "CONTAINER_NOT_FOUND";
+  /** `start()` was called on an SDK instance that is already running. */
+  SdkErrorCode["ALREADY_STARTED"] = "ALREADY_STARTED";
+  /** `start()` was called after `destroy()`. The instance is no longer usable. */
+  SdkErrorCode["INSTANCE_DESTROYED"] = "INSTANCE_DESTROYED";
+  /**
+   * The page is running inside an iframe and embedding was not explicitly allowed.
+   * Configure Content-Security-Policy: frame-ancestors or X-Frame-Options on the
+   * page that hosts the SDK, or set allowEmbedded: true if embedding is intentional.
+   */
+  SdkErrorCode["INSECURE_EMBED"] = "INSECURE_EMBED";
+  /**
+   * The CDN-served manifest could not be downloaded or its Ed25519 signature did
+   * not verify against the loader's embedded public key. The loader refuses to
+   * mount the iframe to prevent execution of tampered/unsigned bundles.
+   */
+  SdkErrorCode["INTEGRITY_FAILED"] = "INTEGRITY_FAILED";
+  SdkErrorCode["UNKNOWN"] = "UNKNOWN";
+  return SdkErrorCode;
+}({});
+
+/**
+ * A structured, machine-readable error object emitted by the SDK.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new VelionOnboarding({
+ *   onError: (err) => {
+ *     if (err.code === SdkErrorCode.CAMERA_ERROR &&
+ *         err.cameraCode === CameraErrorCode.PERMISSION_DENIED) {
+ *       showCameraPermissionDialog();
+ *     }
+ *   }
+ * });
+ * ```
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// THEMING
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * White-labeling theme configuration.
+ * Each property maps to a CSS custom property injected on the SDK container,
+ * making all SDK UI elements styleable via `--vl-*` variables.
+ *
+ * @example
+ * ```typescript
+ * const theme: VelionTheme = {
+ *   primaryColor: '#0052CC',      // → --vl-primary-color
+ *   borderRadius: '12px',          // → --vl-border-radius
+ *   fontFamily: 'Inter, sans-serif'// → --vl-font-family
+ * };
+ * ```
+ */
+
+/**
+ * Optional title and body for one terminal verdict on the final result screen.
+ */
+
+/**
+ * Configurable copy for the built-in final result screen (`showFinalResultScreen`).
+ * Omitted fields fall back to SDK defaults for the active `locale`.
+ */
+
+/**
+ * Localized title/body for one `reason` on the SESSION_DECLINED screen.
+ * Keys match backend `reason` (e.g. `TAX_INFO_FAILED`).
+ */
+
+/**
+ * Per-reason overrides for the built-in SESSION_DECLINED screen (`showFinalResultScreen` not false).
+ * Unspecified reasons fall back to SDK defaults when available, then generic copy.
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CALLBACKS
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * The complete set of lifecycle callbacks the host application can subscribe to.
+ * All callbacks are optional. The SDK is still functional without any of them,
+ * but `onError` and `onSuccess` are strongly recommended for production.
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// MAIN CONFIGURATION
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Root configuration object for the `VelionOnboarding` class.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new VelionOnboarding({
+ *   containerId: 'velion-root',
+ *   sessionId: 'ses_abc123',
+ *   sessionToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+ *   apiUrl: 'https://api.velion.la/v1',
+ *   theme: { primaryColor: '#0052CC' },
+ *   onSuccess: (result) => console.log('Done!', result),
+ *   onError: (err) => console.error('SDK Error:', err),
+ * });
+ *
+ * await sdk.start();
+ * ```
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// BACKEND RESPONSE SHAPES
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Backend step DTO (OnboardingStepDto). GET session returns an array of these.
+ */
+
+/**
+ * Backend session/onboarding DTO (OnboardingDto). Returned by GET /sessions/:sessionId.
+ * The SDK maps this to SessionState for the step machine.
+ */
+
+/**
+ * Session state used by the SDK step machine. Derived from GET /sessions/:sessionId
+ * (OnboardingDto): steps sorted by order → requiredSteps, first non-completed index → currentStepIndex.
+ */
+
+/**
+ * A single T&C line item (matches backend TermsAndConditionsItemDto / domain record).
+ */
+
+/**
+ * Response from session creation (POST from your backend). Use sessionId and
+ * sessionToken when instantiating VelionOnboarding; pass expiresAt for optional
+ * client-side expiration checks.
+ */
+
+/**
+ * Shape of the final result returned by `GET /sessions/:sessionId/result`
+ * once all steps are complete.
+ */
+
+/**
+ * Response from `POST /sessions/:sessionId/liveness-init`.
+ * The backend returns the Iris session details the SDK needs to open the WebSocket
+ * and stream frames. Credentials are not used: Iris owns the session lifecycle.
+ */
+
+/**
+ * Payload for POST /sessions/:sessionId/basic-info/human (HUMAN_BASIC_INFO step).
+ * Matches backend SubmitHumanBasicInfoRequestDto (snake_case in JSON).
+ */
+
+/**
+ * Payload for POST /sessions/:sessionId/basic-info/legal (LEGAL_BASIC_INFO step).
+ * Matches backend SubmitLegalBasicInfoRequestDto (snake_case in JSON).
+ */
+
+/**
+ * Single selectable option for tax category or fiscal identifier type (TAX_INFO step).
+ * `id` is submitted to the API; `description` is the user-visible label.
+ */
+
+/**
+ * Resolved selectable lists for the TAX_INFO step UI (from `accepted_tax_information` only; no SDK defaults).
+ */
+
+/** POST /sessions/:id/tax-info — SubmitTaxInfoRequestDto. */
+
+/** POST /sessions/:id/extended-info/human — SubmitHumanExtendedInfoRequestDto. */
+
+/** POST /sessions/:id/extended-info/legal — SubmitLegalExtendedInfoRequestDto. */
+
+/** POST /sessions/:id/address-info — SubmitAddressInfoRequestDto. */
+
+/** POST /sessions/:id/sworn-declaration — SubmitSwornDeclarationRequestDto. */
+
+/** POST /sessions/:id/contact/email — SubmitEmailContactRequestDto. */
+
+/** POST /sessions/:id/contact/phone — SubmitPhoneContactRequestDto. */
+
+/** POST /sessions/:id/terms-and-conditions — SubmitTermsAndConditionsRequestDto. */
+
+/**
+ * SSE event payload (OnboardingSessionEvent). Matches the backend record
+ * la.velion.onboarding.api...sdk.OnboardingSessionEventDto (snake_case in JSON).
+ *
+ * Received on GET /public/sdk/sessions/:sessionId/events. The backend sends
+ * ServerSentEvent with id = event_id (epoch millis) for Last-Event-ID replay.
+ *
+ * Event types (event_type):
+ * - STEP_UPDATED — a workflow step changed status (step_code, step_status)
+ * - ROUTING_COMMAND — next/retry/terminate instruction (action: NEXT_STEP | RETRY_STEP | TERMINATE)
+ * - SESSION_APPROVED — all checks passed; session_status = APPROVED
+ * - SESSION_MANUAL_REVIEW — manual review required; session_status = MANUAL_REVIEW
+ * - SESSION_DECLINED — session ended with decline (step_code, session_status DECLINED, reason)
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// BACKEND COMMANDS (Listen & Obey)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Backend command: advance to a specific step. The SDK must render that step's
+ * screen without evaluating business rules locally.
+ */
+
+/**
+ * Backend command: show an error message to the user. The SDK displays the
+ * message and does not advance (backend owns the decision).
+ */
+
+/**
+ * Backend command: flow is complete. SDK should fetch final result and fire onSuccess.
+ */
+
+/**
+ * Backend command: retry the current step (e.g. after transient failure).
+ */
+
+/**
+ * Strict command payload the backend may return in a synchronous HTTP response
+ * or send via SSE. The SDK never makes routing decisions; it only obeys these commands.
+ */
+
+/**
+ * Raw response body that may contain a backend command (e.g. POST submit response).
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// INTERNAL STATE MACHINE TYPES (exported for module authors)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * All possible states of the SDK's internal lifecycle.
+ * Transitions are strictly unidirectional (no going back to IDLE once started).
+ *
+ * @internal
+ */
+
+// destroy() was called, instance is a no-op
+
+/**
+ * Internal event bus event names. Typed via `SdkEventMap`.
+ * @internal
+ */
+
+/**
+ * Maps each internal event name to its payload type.
+ * Used by the `TypedEventEmitter` for compile-time safety.
+ * @internal
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// LOADER ↔ CDN APP POSTMESSAGE PROTOCOL (Sumsub-style)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Message type: parent (loader) sends config to iframe (CDN app). */
+export const VELION_MSG_INIT = 'VELION_INIT';
+
+/** Message types: iframe (CDN app) sends to parent (loader). */
+export const VELION_MSG_READY = 'VELION_READY';
+export const VELION_MSG_SUCCESS = 'VELION_SUCCESS';
+export const VELION_MSG_ERROR = 'VELION_ERROR';
+export const VELION_MSG_STEP_CHANGE = 'VELION_STEP_CHANGE';
+export const VELION_MSG_STEP_COMPLETE = 'VELION_STEP_COMPLETE';
+export const VELION_MSG_TOKEN_EXPIRED = 'VELION_TOKEN_EXPIRED';
+
+/** Message type: parent sends new token to iframe after VELION_TOKEN_EXPIRED. */
+export const VELION_MSG_TOKEN = 'VELION_TOKEN';
+
+/** Envelope for all loader ↔ iframe messages. Both sides must validate origin. */
+
+/** Payload for VELION_INIT: full config (iframe runs with containerId overwritten to root id). */
+
+/** Payload for VELION_STEP_CHANGE. */
+
+/** Payload for VELION_STEP_COMPLETE. */
+
+/** Payload for VELION_TOKEN (token refresh response from parent to iframe). */
+//# sourceMappingURL=index.js.map

package/lib/module/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CameraErrorCode","SdkErrorCode","VELION_MSG_INIT","VELION_MSG_READY","VELION_MSG_SUCCESS","VELION_MSG_ERROR","VELION_MSG_STEP_CHANGE","VELION_MSG_STEP_COMPLETE","VELION_MSG_TOKEN_EXPIRED","VELION_MSG_TOKEN"],"sourceRoot":"../../../src","sources":["types/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;;AAQA;AACA;AACA;AACA;;AAGA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAMA;;AAMA;;AAKA;;AAQA;AACA;AACA;AACA;;AAQA;;AAQA;;AAMA;;AAaA;;AAiBA;;AAYA;;AAaA;;AAKA;;AAGA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,WAAYA,eAAe,0BAAfA,eAAe;EACzB;EADUA,eAAe;EAGzB;EAHUA,eAAe;EAKzB;AACF;AACA;AACA;EARYA,eAAe;EAUzB;AACF;AACA;AACA;EAbYA,eAAe;EAezB;AACF;AACA;AACA;AACA;EAnBYA,eAAe;EAqBzB;EArBUA,eAAe;EAuBzB;AACF;AACA;AACA;EA1BYA,eAAe;EA4BzB;EA5BUA,eAAe;EA8BzB;EA9BUA,eAAe;EAAA,OAAfA,eAAe;AAAA;;AAkC3B;AACA;AACA;AACA,WAAYC,YAAY,0BAAZA,YAAY;EACtB;EACA;EAFUA,YAAY;EAItB;EAJUA,YAAY;EAMtB;EANUA,YAAY;EAQtB;EARUA,YAAY;EAWtB;EACA;EAZUA,YAAY;EActB;EAdUA,YAAY;EAgBtB;EAhBUA,YAAY;EAkBtB;EAlBUA,YAAY;EAqBtB;EACA;AACF;AACA;AACA;EAzBYA,YAAY;EA4BtB;EACA;EA7BUA,YAAY;EA+BtB;EA/BUA,YAAY;EAkCtB;EACA;EAnCUA,YAAY;EAqCtB;EArCUA,YAAY;EAuCtB;EAvCUA,YAAY;EA0CtB;AACF;AACA;AACA;AACA;EA9CYA,YAAY;EAiDtB;AACF;AACA;AACA;AACA;EArDYA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA;;AA2DxB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgCA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA6CA;AACA;AACA;;AAMA;AACA;AACA;AACA;;AAWA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;;AAMA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAwDA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAoMA;AACA;AACA;;AAEA;AACA;AACA;;AAYA;AACA;AACA;AACA;;AAyBA;AACA;AACA;AACA;;AAmBA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;;AAuBA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;;AAMA;AACA;AACA;;AAYA;;AAUA;;AAUA;;AAMA;;AAkBA;;AAQA;;AAKA;;AAKA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsBA;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;;AAMA;AACA;AACA;;AAKA;AACA;AACA;;AAKA;AACA;AACA;AACA;;AAOA;AACA;AACA;;AAOA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAQqB;;AAErB;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;;AAEA;AACA,OAAO,MAAMC,eAAe,GAAG,aAAsB;;AAErD;AACA,OAAO,MAAMC,gBAAgB,GAAG,cAAuB;AACvD,OAAO,MAAMC,kBAAkB,GAAG,gBAAyB;AAC3D,OAAO,MAAMC,gBAAgB,GAAG,cAAuB;AACvD,OAAO,MAAMC,sBAAsB,GAAG,oBAA6B;AACnE,OAAO,MAAMC,wBAAwB,GAAG,sBAA+B;AACvE,OAAO,MAAMC,wBAAwB,GAAG,sBAA+B;;AAEvE;AACA,OAAO,MAAMC,gBAAgB,GAAG,cAAuB;;AAYvD;;AAMA;;AAGA;;AAMA;;AAKA","ignoreList":[]}

package/lib/module/ui/MapFallbackBoundary.js

@@ -0,0 +1,37 @@
+"use strict";
+
+/**
+ * Error boundary that catches render failures from `react-native-maps` and
+ * lets the parent fall back to the manual address form.
+ *
+ * Specifically the `AirGoogleMaps` runtime error (`AirGoogleMaps dir must be
+ * added to your xCode project to support GoogleMaps on iOS`) only surfaces
+ * when the MapView mounts. The preflight check cannot detect it because the
+ * native module exists — it's just missing its iOS sub-target.
+ */
+
+import { Component } from 'react';
+import { log } from '../utils/log';
+export class MapFallbackBoundary extends Component {
+  state = {
+    hasError: false
+  };
+  static getDerivedStateFromError() {
+    return {
+      hasError: true
+    };
+  }
+  componentDidCatch(error) {
+    log.warn('[MapFallbackBoundary] map render failed, switching to manual', {
+      message: error.message
+    });
+    this.props.onError(error);
+  }
+  render() {
+    if (this.state.hasError) {
+      return this.props.fallback ?? null;
+    }
+    return this.props.children;
+  }
+}
+//# sourceMappingURL=MapFallbackBoundary.js.map

package/lib/module/ui/MapFallbackBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Component","log","MapFallbackBoundary","state","hasError","getDerivedStateFromError","componentDidCatch","error","warn","message","props","onError","render","fallback","children"],"sourceRoot":"../../../src","sources":["ui/MapFallbackBoundary.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,SAAS,QAAwB,OAAO;AACjD,SAASC,GAAG,QAAQ,cAAc;AAclC,OAAO,MAAMC,mBAAmB,SAASF,SAAS,CAAe;EAC/DG,KAAK,GAAU;IAAEC,QAAQ,EAAE;EAAM,CAAC;EAElC,OAAOC,wBAAwBA,CAAA,EAAU;IACvC,OAAO;MAAED,QAAQ,EAAE;IAAK,CAAC;EAC3B;EAEAE,iBAAiBA,CAACC,KAAY,EAAQ;IACpCN,GAAG,CAACO,IAAI,CAAC,8DAA8D,EAAE;MACvEC,OAAO,EAAEF,KAAK,CAACE;IACjB,CAAC,CAAC;IACF,IAAI,CAACC,KAAK,CAACC,OAAO,CAACJ,KAAK,CAAC;EAC3B;EAEAK,MAAMA,CAAA,EAAG;IACP,IAAI,IAAI,CAACT,KAAK,CAACC,QAAQ,EAAE;MACvB,OAAO,IAAI,CAACM,KAAK,CAACG,QAAQ,IAAI,IAAI;IACpC;IACA,OAAO,IAAI,CAACH,KAAK,CAACI,QAAQ;EAC5B;AACF","ignoreList":[]}

package/lib/module/ui/StepShell.js

@@ -0,0 +1,114 @@
+"use strict";
+
+/**
+ * @fileoverview Step shell — header + scrollable body.
+ *
+ * Rounded header icon, title, subtitle, then a centered column with the
+ * step's form. Used by every form-style step (HUMAN_BASIC_INFO, TAX_INFO, …)
+ * so they read as a single visual family.
+ */
+
+import { KeyboardAvoidingView, Platform, ScrollView, StyleSheet, Text, View } from 'react-native';
+import { useTheme, withAlpha } from './theme';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function StepShell({
+  title,
+  subtitle,
+  iconNode,
+  children,
+  avoidKeyboard = true
+}) {
+  const theme = useTheme();
+  const showIconCircle = !theme.hideStepIcons && iconNode != null;
+  const body = /*#__PURE__*/_jsxs(ScrollView, {
+    style: styles.scroll,
+    contentContainerStyle: styles.scrollBody,
+    keyboardShouldPersistTaps: "handled",
+    children: [/*#__PURE__*/_jsxs(View, {
+      style: styles.header,
+      children: [showIconCircle ? /*#__PURE__*/_jsx(View, {
+        style: [styles.iconCircle, {
+          backgroundColor: theme.primaryColor,
+          shadowColor: withAlpha(theme.primaryColor, 0.5)
+        }],
+        accessibilityElementsHidden: true,
+        importantForAccessibility: "no",
+        children: iconNode
+      }) : null, /*#__PURE__*/_jsx(Text, {
+        style: [styles.title, {
+          color: theme.textColor
+        }],
+        children: title
+      }), subtitle ? /*#__PURE__*/_jsx(Text, {
+        style: [styles.subtitle, {
+          color: theme.textSecondaryColor
+        }],
+        children: subtitle
+      }) : null]
+    }), /*#__PURE__*/_jsx(View, {
+      style: styles.column,
+      children: children
+    })]
+  });
+  if (avoidKeyboard) {
+    return /*#__PURE__*/_jsx(KeyboardAvoidingView, {
+      style: styles.flex,
+      behavior: Platform.OS === 'ios' ? 'padding' : undefined,
+      children: body
+    });
+  }
+  return body;
+}
+const styles = StyleSheet.create({
+  flex: {
+    flex: 1
+  },
+  scroll: {
+    flex: 1
+  },
+  scrollBody: {
+    paddingHorizontal: 18,
+    paddingTop: 12,
+    paddingBottom: 28
+  },
+  header: {
+    alignItems: 'center',
+    marginBottom: 14
+  },
+  iconCircle: {
+    width: 56,
+    height: 56,
+    borderRadius: 28,
+    marginBottom: 10,
+    alignItems: 'center',
+    justifyContent: 'center',
+    shadowOpacity: 0.25,
+    shadowRadius: 8,
+    shadowOffset: {
+      width: 0,
+      height: 3
+    },
+    elevation: 3
+  },
+  title: {
+    fontSize: 20,
+    fontWeight: '700',
+    letterSpacing: -0.3,
+    textAlign: 'center'
+  },
+  subtitle: {
+    marginTop: 6,
+    fontSize: 14,
+    fontWeight: '400',
+    textAlign: 'center',
+    lineHeight: 20,
+    maxWidth: 320
+  },
+  column: {
+    width: '100%',
+    maxWidth: 360,
+    alignSelf: 'center',
+    gap: 10
+  }
+});
+//# sourceMappingURL=StepShell.js.map

package/lib/module/ui/StepShell.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["KeyboardAvoidingView","Platform","ScrollView","StyleSheet","Text","View","useTheme","withAlpha","jsx","_jsx","jsxs","_jsxs","StepShell","title","subtitle","iconNode","children","avoidKeyboard","theme","showIconCircle","hideStepIcons","body","style","styles","scroll","contentContainerStyle","scrollBody","keyboardShouldPersistTaps","header","iconCircle","backgroundColor","primaryColor","shadowColor","accessibilityElementsHidden","importantForAccessibility","color","textColor","textSecondaryColor","column","flex","behavior","OS","undefined","create","paddingHorizontal","paddingTop","paddingBottom","alignItems","marginBottom","width","height","borderRadius","justifyContent","shadowOpacity","shadowRadius","shadowOffset","elevation","fontSize","fontWeight","letterSpacing","textAlign","marginTop","lineHeight","maxWidth","alignSelf","gap"],"sourceRoot":"../../../src","sources":["ui/StepShell.tsx"],"mappings":"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","ignoreList":[]}