@kwik-id/sdk-react-native 0.0.0-stage → 0.1.0-alpha.0

package/lib/module/i18n/index.js

@@ -0,0 +1,11 @@
+"use strict";
+
+/**
+ * RN KYC-flow i18n (EN + FR). Locale is supplied by the host app via SDK config
+ * and threaded to screens as a `t` prop.
+ */
+export { en } from "./en.js";
+export { fr } from "./fr.js";
+export { getDeviceLocale } from "./locale.js";
+export { createTranslator } from "./translator.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["en","fr","getDeviceLocale","createTranslator"],"sourceRoot":"../../../src","sources":["i18n/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,SAASA,EAAE,QAAQ,SAAM;AACzB,SAASC,EAAE,QAAQ,SAAM;AACzB,SAASC,eAAe,QAAQ,aAAU;AAC1C,SAASC,gBAAgB,QAAQ,iBAAc","ignoreList":[]}

package/lib/module/i18n/locale.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/**
+ * Device-locale detection for the default UI language.
+ */
+import { getLocales } from "expo-localization";
+/** 'fr' when the device's preferred language is French, otherwise 'en'. */
+export function getDeviceLocale() {
+  try {
+    return getLocales()[0]?.languageCode === "fr" ? "fr" : "en";
+  } catch {
+    return "en";
+  }
+}
+//# sourceMappingURL=locale.js.map

package/lib/module/i18n/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getLocales","getDeviceLocale","languageCode"],"sourceRoot":"../../../src","sources":["i18n/locale.ts"],"mappings":";;AAAA;AACA;AACA;AACA,SAASA,UAAU,QAAQ,mBAAmB;AAI9C;AACA,OAAO,SAASC,eAAeA,CAAA,EAAW;EACtC,IAAI;IACA,OAAOD,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAEE,YAAY,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI;EAC/D,CAAC,CAAC,MAAM;IACJ,OAAO,IAAI;EACf;AACJ","ignoreList":[]}

package/lib/module/i18n/translator.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * Tiny dependency-free translator for the RN KYC flow (mirrors the web SDK's).
+ * The host app supplies the locale via SDK config; missing keys fall back to English.
+ */
+
+import { en } from "./en.js";
+import { fr } from "./fr.js";
+
+/** All message keys, derived from the English catalog (the source of truth). */
+
+/** Interpolation values for `{placeholder}` tokens in a message. */
+
+/** Translate a key to the active locale, interpolating any `{param}` tokens. */
+
+const catalogs = {
+  en,
+  fr
+};
+function interpolate(template, params) {
+  if (!params) return template;
+  return template.replace(/\{(\w+)\}/g, (match, name) => name in params ? String(params[name]) : match);
+}
+
+/** Build a translator bound to a locale, falling back to English then the raw key. */
+export function createTranslator(locale = "en") {
+  const table = catalogs[locale] ?? en;
+  return (key, params) => {
+    const template = table[key] ?? en[key] ?? key;
+    return interpolate(template, params);
+  };
+}
+//# sourceMappingURL=translator.js.map

package/lib/module/i18n/translator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["en","fr","catalogs","interpolate","template","params","replace","match","name","String","createTranslator","locale","table","key"],"sourceRoot":"../../../src","sources":["i18n/translator.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,SAASA,EAAE,QAAQ,SAAM;AACzB,SAASC,EAAE,QAAQ,SAAM;;AAEzB;;AAGA;;AAGA;;AAGA,MAAMC,QAA6D,GAAG;EAClEF,EAAE;EACFC;AACJ,CAAC;AAED,SAASE,WAAWA,CAACC,QAAgB,EAAEC,MAAwB,EAAU;EACrE,IAAI,CAACA,MAAM,EAAE,OAAOD,QAAQ;EAC5B,OAAOA,QAAQ,CAACE,OAAO,CAAC,YAAY,EAAE,CAACC,KAAK,EAAEC,IAAY,KACtDA,IAAI,IAAIH,MAAM,GAAGI,MAAM,CAACJ,MAAM,CAACG,IAAI,CAAC,CAAC,GAAGD,KAC5C,CAAC;AACL;;AAEA;AACA,OAAO,SAASG,gBAAgBA,CAACC,MAAc,GAAG,IAAI,EAAa;EAC/D,MAAMC,KAAK,GAAGV,QAAQ,CAACS,MAAM,CAAC,IAAIX,EAAE;EACpC,OAAO,CAACa,GAAG,EAAER,MAAM,KAAK;IACpB,MAAMD,QAAQ,GAAGQ,KAAK,CAACC,GAAG,CAAC,IAAIb,EAAE,CAACa,GAAG,CAAC,IAAIA,GAAG;IAC7C,OAAOV,WAAW,CAACC,QAAQ,EAAEC,MAAM,CAAC;EACxC,CAAC;AACL","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,30 @@
+"use strict";
+
+/**
+ * @kwik-id/sdk-react-native — public API.
+ *
+ * Phase 1: on-device document + selfie capture, upload, and submit, plus the
+ * headless protocol foundation. On-device liveness (passive + active challenges)
+ * lands in Phase 2.
+ *
+ * @packageDocumentation
+ */
+
+// ---- UI (primary integration) ----
+export { useKwikVerification, KwikIDVerificationModal, KwikIDProvider, useKwikID } from "./ui/index.js";
+// ---- Camera ----
+export { CameraView, compressCapture } from "./camera/index.js";
+// ---- Headless orchestrator ----
+export { KwikIdRNSDK } from "./lib/kwik-id-rn-sdk.js";
+// ---- API ----
+export { ApiClient, ApiError, DEFAULT_BASE_URL, uploadMultipart } from "./api/index.js";
+// ---- i18n (EN + FR) ----
+export { createTranslator, getDeviceLocale, en as messagesEn, fr as messagesFr } from "./i18n/index.js";
+// ---- Crypto / session ----
+export { SessionManager, generateFingerprint, hmacSha256Hex, sha256Hex, generateNonce } from "./crypto/index.js";
+
+// ---- Headless orchestration primitives ----
+export { EventEmitter, reducer, initialState, needsBackImage, getStepProgress, computeUploadProgress, isExpoGo, assertSupportedRuntime, isRealDevice } from "./lib/index.js";
+
+// ---- Types ----
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useKwikVerification","KwikIDVerificationModal","KwikIDProvider","useKwikID","CameraView","compressCapture","KwikIdRNSDK","ApiClient","ApiError","DEFAULT_BASE_URL","uploadMultipart","createTranslator","getDeviceLocale","en","messagesEn","fr","messagesFr","SessionManager","generateFingerprint","hmacSha256Hex","sha256Hex","generateNonce","EventEmitter","reducer","initialState","needsBackImage","getStepProgress","computeUploadProgress","isExpoGo","assertSupportedRuntime","isRealDevice"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,mBAAmB,EAAEC,uBAAuB,EAAEC,cAAc,EAAEC,SAAS,QAAQ,eAAM;AAS9F;AACA,SAASC,UAAU,EAAEC,eAAe,QAAQ,mBAAU;AAGtD;AACA,SAASC,WAAW,QAAQ,yBAAsB;AAGlD;AACA,SAASC,SAAS,EAAEC,QAAQ,EAAEC,gBAAgB,EAAEC,eAAe,QAAQ,gBAAO;AAY9E;AACA,SAASC,gBAAgB,EAAEC,eAAe,EAAEC,EAAE,IAAIC,UAAU,EAAEC,EAAE,IAAIC,UAAU,QAAQ,iBAAQ;AAG9F;AACA,SACIC,cAAc,EACdC,mBAAmB,EACnBC,aAAa,EACbC,SAAS,EACTC,aAAa,QACV,mBAAU;;AAEjB;AACA,SACIC,YAAY,EACZC,OAAO,EACPC,YAAY,EACZC,cAAc,EACdC,eAAe,EACfC,qBAAqB,EACrBC,QAAQ,EACRC,sBAAsB,EACtBC,YAAY,QACT,gBAAO;;AAGd","ignoreList":[]}

package/lib/module/lib/device-detector.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/**
+ * Device / runtime environment detection.
+ *
+ * Replaces the web SDK's emulator + automation heuristics. The most important
+ * check is Expo Go detection: vision-camera frame processors are native and
+ * cannot run in Expo Go, so the SDK fails fast with an actionable message.
+ */
+import Constants, { AppOwnership, ExecutionEnvironment } from "expo-constants";
+import * as Device from "expo-device";
+export function isExpoGo() {
+  return Constants.appOwnership === AppOwnership.Expo || Constants.executionEnvironment === ExecutionEnvironment.StoreClient;
+}
+
+/** Throws an actionable error when running in an unsupported runtime. */
+export function assertSupportedRuntime() {
+  if (isExpoGo()) {
+    throw new Error("[KwikID] This SDK requires a custom dev build or EAS build and cannot run in Expo Go. " + "Run `expo prebuild` and build a development client (or `eas build`). " + "See https://docs.expo.dev/develop/development-builds/introduction/");
+  }
+}
+export function isRealDevice() {
+  // false on iOS Simulator / Android emulator.
+  return Device.isDevice === true;
+}
+//# sourceMappingURL=device-detector.js.map

package/lib/module/lib/device-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Constants","AppOwnership","ExecutionEnvironment","Device","isExpoGo","appOwnership","Expo","executionEnvironment","StoreClient","assertSupportedRuntime","Error","isRealDevice","isDevice"],"sourceRoot":"../../../src","sources":["lib/device-detector.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAOA,SAAS,IAAIC,YAAY,EAAEC,oBAAoB,QAAQ,gBAAgB;AAC9E,OAAO,KAAKC,MAAM,MAAM,aAAa;AAErC,OAAO,SAASC,QAAQA,CAAA,EAAY;EAChC,OACIJ,SAAS,CAACK,YAAY,KAAKJ,YAAY,CAACK,IAAI,IAC5CN,SAAS,CAACO,oBAAoB,KAAKL,oBAAoB,CAACM,WAAW;AAE3E;;AAEA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAS;EAC3C,IAAIL,QAAQ,CAAC,CAAC,EAAE;IACZ,MAAM,IAAIM,KAAK,CACX,wFAAwF,GACpF,uEAAuE,GACvE,oEACR,CAAC;EACL;AACJ;AAEA,OAAO,SAASC,YAAYA,CAAA,EAAY;EACpC;EACA,OAAOR,MAAM,CAACS,QAAQ,KAAK,IAAI;AACnC","ignoreList":[]}

package/lib/module/lib/event-emitter.js

@@ -0,0 +1,80 @@
+"use strict";
+
+/**
+ * Type-safe event emitter (ported from @kwik-id/sdk-core, framework-agnostic).
+ */
+
+export class EventEmitter {
+  listeners = new Map();
+  wildcardListeners = new Set();
+  onceListeners = new Map();
+  on(event, handler) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, new Set());
+    }
+    this.listeners.get(event).add(handler);
+    return () => this.off(event, handler);
+  }
+  once(event, handler) {
+    if (!this.onceListeners.has(event)) {
+      this.onceListeners.set(event, new Set());
+    }
+    this.onceListeners.get(event).add(handler);
+    return () => {
+      this.onceListeners.get(event)?.delete(handler);
+    };
+  }
+  onAny(handler) {
+    this.wildcardListeners.add(handler);
+    return () => this.wildcardListeners.delete(handler);
+  }
+  off(event, handler) {
+    this.listeners.get(event)?.delete(handler);
+  }
+  emit(event, data) {
+    const handlers = this.listeners.get(event);
+    if (handlers) {
+      handlers.forEach(handler => {
+        try {
+          handler(data);
+        } catch (error) {
+          console.error(`Error in event handler for ${event}:`, error);
+        }
+      });
+    }
+    const onceHandlers = this.onceListeners.get(event);
+    if (onceHandlers) {
+      onceHandlers.forEach(handler => {
+        try {
+          handler(data);
+        } catch (error) {
+          console.error(`Error in once handler for ${event}:`, error);
+        }
+      });
+      this.onceListeners.delete(event);
+    }
+    this.wildcardListeners.forEach(handler => {
+      try {
+        handler(event, data);
+      } catch (error) {
+        console.error(`Error in wildcard handler for ${event}:`, error);
+      }
+    });
+  }
+  removeAllListeners(event) {
+    if (event) {
+      this.listeners.delete(event);
+      this.onceListeners.delete(event);
+    } else {
+      this.listeners.clear();
+      this.onceListeners.clear();
+      this.wildcardListeners.clear();
+    }
+  }
+  listenerCount(event) {
+    const regularCount = this.listeners.get(event)?.size || 0;
+    const onceCount = this.onceListeners.get(event)?.size || 0;
+    return regularCount + onceCount;
+  }
+}
+//# sourceMappingURL=event-emitter.js.map

package/lib/module/lib/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EventEmitter","listeners","Map","wildcardListeners","Set","onceListeners","on","event","handler","has","set","get","add","off","once","delete","onAny","emit","data","handlers","forEach","error","console","onceHandlers","removeAllListeners","clear","listenerCount","regularCount","size","onceCount"],"sourceRoot":"../../../src","sources":["lib/event-emitter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/lib/index.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export { EventEmitter } from "./event-emitter.js";
+export { reducer, initialState, needsBackImage, getStepProgress, computeUploadProgress } from "./verification-machine.js";
+export { isExpoGo, assertSupportedRuntime, isRealDevice } from "./device-detector.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["EventEmitter","reducer","initialState","needsBackImage","getStepProgress","computeUploadProgress","isExpoGo","assertSupportedRuntime","isRealDevice"],"sourceRoot":"../../../src","sources":["lib/index.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,oBAAiB;AAC9C,SACIC,OAAO,EACPC,YAAY,EACZC,cAAc,EACdC,eAAe,EACfC,qBAAqB,QAClB,2BAAwB;AAO/B,SAASC,QAAQ,EAAEC,sBAAsB,EAAEC,YAAY,QAAQ,sBAAmB","ignoreList":[]}

package/lib/module/lib/kwik-id-rn-sdk.js

@@ -0,0 +1,150 @@
+"use strict";
+
+/**
+ * Headless orchestrator for the RN SDK.
+ *
+ * Wraps SessionManager + ApiClient + EventEmitter so the UI (and advanced
+ * integrators) drive a single object. No camera/UI concerns live here.
+ */
+import { ApiClient } from "../api/api-client.js";
+import { SessionManager } from "../crypto/session-manager.js";
+import { assertSupportedRuntime } from "./device-detector.js";
+import { EventEmitter } from "./event-emitter.js";
+export class KwikIdRNSDK {
+  events = new EventEmitter();
+  sessionInfo = null;
+  initialized = false;
+  constructor(options) {
+    this.options = options;
+    this.sessionManager = new SessionManager();
+    this.api = new ApiClient(this.sessionManager, {
+      baseUrl: options.baseUrl,
+      timeout: options.timeout,
+      debug: options.debug
+    });
+  }
+
+  /** Validate the runtime + session token. Returns the org/session config. */
+  async initialize() {
+    if (!this.options.skipRuntimeCheck) {
+      assertSupportedRuntime();
+    }
+    try {
+      this.sessionInfo = await this.api.validateSession(this.options.clientSecret);
+      this.initialized = true;
+      const session = this.sessionManager.getSession();
+      if (session) this.events.emit("session:created", session);
+      this.events.emit("ready", undefined);
+      return this.sessionInfo;
+    } catch (error) {
+      this.events.emit("error", {
+        code: "INIT_FAILED",
+        message: error.message,
+        recoverable: false
+      });
+      throw error;
+    }
+  }
+
+  /** Redeem a desktop→mobile handoff code, swapping in the mobile session token. */
+  async redeemHandoff(code) {
+    try {
+      const {
+        sessionToken
+      } = await this.api.redeemHandoff(code);
+      this.sessionInfo = await this.api.validateSession(sessionToken);
+      this.initialized = true;
+      const session = this.sessionManager.getSession();
+      this.events.emit("handoff:redeemed", {
+        jobId: session?.jobId ?? ""
+      });
+    } catch (error) {
+      this.events.emit("handoff:error", {
+        error: error
+      });
+      throw error;
+    }
+  }
+  async uploadCapture(type, asset, onProgress) {
+    this.assertReady();
+    this.events.emit("upload:starting", {
+      type
+    });
+    try {
+      const res = await this.api.uploadCapture(type, asset, p => {
+        this.events.emit("upload:progress", {
+          type,
+          progress: p
+        });
+        onProgress?.(p);
+      });
+      this.events.emit("upload:complete", {
+        type,
+        uploadId: res.uploadId
+      });
+      return {
+        uploadId: res.uploadId
+      };
+    } catch (error) {
+      const retryable = typeof error.isRetryable === "function" ? error.isRetryable() : false;
+      this.events.emit("upload:failed", {
+        type,
+        error: error,
+        retryable
+      });
+      throw error;
+    }
+  }
+  async submit(documentType, analysis) {
+    this.assertReady();
+    this.events.emit("verification:submitting", undefined);
+    try {
+      const res = await this.api.submitVerification(documentType, {
+        qualityScores: analysis?.quality,
+        livenessResult: analysis?.liveness
+      });
+      const jobId = res.jobId ?? this.sessionManager.getSession()?.jobId ?? "";
+      this.events.emit("verification:submitted", {
+        jobId
+      });
+      return {
+        jobId
+      };
+    } catch (error) {
+      this.events.emit("verification:failed", {
+        error: error
+      });
+      throw error;
+    }
+  }
+  getStatus() {
+    this.assertReady();
+    return this.api.getStatus();
+  }
+  getSessionInfo() {
+    return this.sessionInfo;
+  }
+
+  /** True when the session token is within ~2 min of expiry. */
+  needsRefresh() {
+    return this.sessionManager.needsRefresh();
+  }
+  on(event, handler) {
+    return this.events.on(event, handler);
+  }
+  reset() {
+    this.sessionManager.clearSession();
+    this.sessionInfo = null;
+    this.initialized = false;
+  }
+  destroy() {
+    this.reset();
+    this.events.removeAllListeners();
+  }
+  assertReady() {
+    if (!this.initialized) {
+      throw new Error("KwikIdRNSDK not initialized — call initialize() first");
+    }
+  }
+}
+//# sourceMappingURL=kwik-id-rn-sdk.js.map

package/lib/module/lib/kwik-id-rn-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ApiClient","SessionManager","assertSupportedRuntime","EventEmitter","KwikIdRNSDK","events","sessionInfo","initialized","constructor","options","sessionManager","api","baseUrl","timeout","debug","initialize","skipRuntimeCheck","validateSession","clientSecret","session","getSession","emit","undefined","error","code","message","recoverable","redeemHandoff","sessionToken","jobId","uploadCapture","type","asset","onProgress","assertReady","res","p","progress","uploadId","retryable","isRetryable","submit","documentType","analysis","submitVerification","qualityScores","quality","livenessResult","liveness","getStatus","getSessionInfo","needsRefresh","on","event","handler","reset","clearSession","destroy","removeAllListeners","Error"],"sourceRoot":"../../../src","sources":["lib/kwik-id-rn-sdk.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/lib/verification-machine.js

@@ -0,0 +1,268 @@
+"use strict";
+
+/**
+ * Pure reducer for the RN verification flow.
+ *
+ * Adapted from the web SDK's KYCModalFlow SubStep machine. No React / no native
+ * dependency, so it is fully unit-testable. The selfie branch folds the web's
+ * `camera-selfie` into a single `liveness` step (align → passive/active → capture).
+ */
+
+export function needsBackImage(doc) {
+  return doc === "id_card" || doc === "drivers_license" || doc === "voters_card";
+}
+export function initialState() {
+  return {
+    step: "intro",
+    context: {
+      documentType: null,
+      uploadProgress: 0,
+      uploadStage: null
+    }
+  };
+}
+
+/** Steps that contribute to the progress bar, in order (mirrors web getProgress). */
+function progressSteps(ctx) {
+  const steps = ["document-type", "prepare-front", "camera-front", "confirm-front"];
+  if (needsBackImage(ctx.documentType)) {
+    steps.push("prepare-back", "camera-back", "confirm-back");
+  }
+  steps.push("prepare-selfie", "liveness", "confirm-selfie");
+  return steps;
+}
+
+/** Progress-bar percentage (0..100) for the current step. */
+export function getStepProgress(state) {
+  const hidden = ["intro", "handoff-redeem", "processing", "result"];
+  if (hidden.includes(state.step)) return 0;
+  const steps = progressSteps(state.context);
+  const idx = steps.indexOf(state.step);
+  if (idx < 0) return 0;
+  return (idx + 1) / steps.length * 100;
+}
+
+/**
+ * Upload/submit progress banding (matches web performVerification):
+ * front 0–30, back 30–45, selfie 45–70 (or 30–55 without back), submit 80, done 100.
+ */
+export function computeUploadProgress(stage, pct, hasBack) {
+  switch (stage) {
+    case "document_front":
+      return Math.round(pct * 0.3);
+    case "document_back":
+      return 30 + Math.round(pct * 0.15);
+    case "selfie":
+      {
+        const base = hasBack ? 45 : 30;
+        return base + Math.round(pct * 0.25);
+      }
+    case "submitting":
+      return Math.max(80, Math.round(pct));
+    default:
+      return 0;
+  }
+}
+const FORWARD_TAP = {
+  "prepare-front": "camera-front",
+  "prepare-back": "camera-back",
+  "prepare-selfie": "liveness",
+  // 'confirm-front' is resolved dynamically (needs back?) in the reducer.
+  "confirm-back": "prepare-selfie",
+  "confirm-selfie": "processing"
+};
+const BACK_FLOW = {
+  "document-type": "intro",
+  "prepare-front": "document-type",
+  "camera-front": "prepare-front",
+  "confirm-front": "camera-front",
+  "prepare-back": "confirm-front",
+  "camera-back": "prepare-back",
+  "confirm-back": "camera-back",
+  "confirm-selfie": "prepare-selfie"
+};
+export function reducer(state, event, options = {}) {
+  const {
+    step,
+    context
+  } = state;
+  switch (event.t) {
+    case "NEXT":
+      {
+        if (step === "intro") {
+          return {
+            ...state,
+            step: options.hasHandoffCode ? "handoff-redeem" : "document-type"
+          };
+        }
+        if (step === "confirm-front") {
+          return {
+            ...state,
+            step: needsBackImage(context.documentType) ? "prepare-back" : "prepare-selfie"
+          };
+        }
+        const next = FORWARD_TAP[step];
+        return next ? {
+          ...state,
+          step: next
+        } : state;
+      }
+    case "BACK":
+      {
+        // Terminal / non-reversible steps.
+        if (step === "processing" || step === "result" || step === "liveness") return state;
+        if (step === "prepare-selfie") {
+          return {
+            ...state,
+            step: needsBackImage(context.documentType) ? "confirm-back" : "confirm-front"
+          };
+        }
+        const prev = BACK_FLOW[step];
+        return prev ? {
+          ...state,
+          step: prev
+        } : state;
+      }
+    case "SELECT_DOC":
+      {
+        if (step !== "document-type") return state;
+        return {
+          step: "prepare-front",
+          context: {
+            ...context,
+            documentType: event.doc
+          }
+        };
+      }
+    case "HANDOFF_REDEEMED":
+      {
+        if (step !== "handoff-redeem") return state;
+        return {
+          ...state,
+          step: "document-type"
+        };
+      }
+    case "CAPTURED":
+      {
+        const ctx = {
+          ...context,
+          [event.slot]: event.asset
+        };
+        if (event.slot === "front" && step === "camera-front") {
+          return {
+            step: "confirm-front",
+            context: ctx
+          };
+        }
+        if (event.slot === "back" && step === "camera-back") {
+          return {
+            step: "confirm-back",
+            context: ctx
+          };
+        }
+        return {
+          ...state,
+          context: ctx
+        };
+      }
+    case "RETAKE":
+      {
+        if (event.slot === "front") {
+          return {
+            step: "camera-front",
+            context: {
+              ...context,
+              front: undefined
+            }
+          };
+        }
+        if (event.slot === "back") {
+          return {
+            step: "camera-back",
+            context: {
+              ...context,
+              back: undefined
+            }
+          };
+        }
+        return {
+          step: "liveness",
+          context: {
+            ...context,
+            selfie: undefined,
+            livenessResult: undefined
+          }
+        };
+      }
+    case "LIVENESS_DONE":
+      {
+        if (step !== "liveness") return state;
+        return {
+          step: "confirm-selfie",
+          context: {
+            ...context,
+            selfie: event.selfie,
+            livenessResult: event.result
+          }
+        };
+      }
+    case "PROGRESS":
+      {
+        const hasBack = !!context.back;
+        return {
+          ...state,
+          context: {
+            ...context,
+            uploadStage: event.stage,
+            uploadProgress: computeUploadProgress(event.stage, event.value, hasBack)
+          }
+        };
+      }
+    case "SUBMITTED":
+      {
+        return {
+          step: "result",
+          context: {
+            ...context,
+            uploadProgress: 100,
+            uploadStage: null,
+            outcome: {
+              status: "submitted",
+              jobId: event.jobId
+            }
+          }
+        };
+      }
+    case "FAILED":
+      {
+        return {
+          step: "result",
+          context: {
+            ...context,
+            error: event.error,
+            outcome: {
+              status: "error",
+              error: new Error(event.error)
+            }
+          }
+        };
+      }
+    case "CANCEL":
+      {
+        return {
+          ...state,
+          context: {
+            ...context,
+            outcome: {
+              status: "cancelled"
+            }
+          }
+        };
+      }
+    case "RESET":
+      return initialState();
+    default:
+      return state;
+  }
+}
+//# sourceMappingURL=verification-machine.js.map