@arkyc/widget 1.1.0 → 1.2.0

package/dist/client.d.mts

@@ -55,6 +55,25 @@ interface ProviderSignalHints {
   multiple_faces?: boolean;
   face_similarity?: number;
   face_match_passed?: boolean;
+  address_score?: number;
+  address_passed?: boolean;
+}
+/** Input for the address-verification submission (opt-in stage). */
+interface AddressInput {
+  /** The claimed address the user entered. */
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  region?: string | null;
+  postalCode?: string | null;
+  /** ISO 3166-1 alpha-2 country code. */
+  country?: string | null;
+  /** Proof-of-address document image. */
+  poa?: Blob | null;
+  /** Captured device coordinates. */
+  latitude?: number | null;
+  longitude?: number | null;
+  signals?: ProviderSignalHints;
 }
 /** Input for the document-front submission. */
 interface DocumentFrontInput {
@@ -138,6 +157,14 @@ declare class ArkycClient {
    * @returns
    */
   submitLiveness(input: LivenessInput): Promise<ClientSession>;
+  /**
+   * Submit address verification (opt-in stage). Sends the claimed address plus
+   * whichever evidence was gathered (proof-of-address image, device coordinates).
+   *
+   * @param input
+   * @returns
+   */
+  submitAddress(input: AddressInput): Promise<ClientSession>;
   /**
    * Finalise the session (runs face-match + the decision engine).
    *

package/dist/client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;UAWiB,aAAA;EACf,EAAA;EACA,MAAA,EAAQ,kBAAA;EACR,UAAA;EADQ;EAGR,aAAA,GAAgB,YAAA;EAEM;EAAtB,mBAAA,GAAsB,iBAAA;EAIX;EAFX,OAAA,GAAU,aAAA;EAMC;EAJX,QAAA,GAAW,cAAA;EAIc;EAFzB,QAAA,GAAW,eAAA;EAXX;EAaA,QAAA,GAAW,cAAA;AAAA;;;;;;;;UAUI,cAAA;EACf,SAAA;EAbW;EAeX,OAAA;EAbW;EAeX,KAAA;EAAA,CACC,KAAA;AAAA;;UAIc,aAAA;EACf,OAAA;EAVA;EAYA,aAAA;EARA;EAUA,GAAA;AAAA;AATc;AAIhB;;;AAJgB,UAgBC,mBAAA;EACf,aAAA;EACA,cAAA;EACA,OAAA;EACA,cAAA;EACA,eAAA;EACA,cAAA;EACA,eAAA;EACA,iBAAA;AAAA;;UAIe,kBAAA;EACf,KAAA,GAAQ,IAAA;EACR,OAAA;EACA,YAAA,GAAe,YAAA;EACf,OAAA,GAAU,mBAAA;AAAA;;UAIK,iBAAA;EACf,KAAA,GAAQ,IAAA;EACR,OAAA;EACA,YAAA,GAAe,YAAY;AAAA;;UAIZ,aAAA;EACf,MAAA,GAAS,IAAA;EAZoB;EAc7B,KAAA,GAAQ,IAAA;EAjBR;EAmBA,IAAA,GAAO,YAAA;EAlBP;EAoBA,UAAA,GAAa,iBAAA;EACb,OAAA,GAAU,mBAAA;AAAA;;UAIK,aAAA;EACf,OAAA,GAAU,mBAAmB;AAAA;;;;cAMlB,cAAA,SAAuB,KAAK;EAAA,SAC9B,MAAA;EAAA,SACA,IAAA;cAEG,OAAA,UAAiB,MAAA,UAAgB,IAAA;AAAA;;UAS9B,kBAAA;EAhCA;EAkCf,KAAA;;EAEA,OAAA;EAjCQ;EAmCR,KAAA,UAAe,KAAK;AAAA;;;;;;cAkBT,WAAA;EAAA,iBACM,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,SAAA;cAEL,OAAA,EAAS,kBAAA;EAtDR;;;;AACgB;EAmE7B,UAAA,IAAc,OAAA,CAAQ,aAAA;EA/DM;;;AACC;AAM/B;;EAkEE,mBAAA,CAAoB,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,aAAA;EAlEjB;;;;;;EAiFvC,kBAAA,CAAmB,KAAA,EAAO,iBAAA,GAAoB,OAAA,CAAQ,aAAA;EA7ET;;AAAa;AAS5D;;;EAkFE,cAAA,CAAe,KAAA,EAAO,aAAA,GAAgB,OAAA,CAAQ,aAAA;EAhF9C;;;;;AAIoB;EA4FpB,QAAA,CAAS,KAAA,GAAO,aAAA,GAAqB,OAAA,CAAQ,aAAA;EAAA,QAI/B,OAAA;AAAA"}
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;UAWiB,aAAA;EACf,EAAA;EACA,MAAA,EAAQ,kBAAA;EACR,UAAA;EADQ;EAGR,aAAA,GAAgB,YAAA;EAEM;EAAtB,mBAAA,GAAsB,iBAAA;EAIX;EAFX,OAAA,GAAU,aAAA;EAMC;EAJX,QAAA,GAAW,cAAA;EAIc;EAFzB,QAAA,GAAW,eAAA;EAXX;EAaA,QAAA,GAAW,cAAA;AAAA;;;;;;;;UAUI,cAAA;EACf,SAAA;EAbW;EAeX,OAAA;EAbW;EAeX,KAAA;EAAA,CACC,KAAA;AAAA;;UAIc,aAAA;EACf,OAAA;EAVA;EAYA,aAAA;EARA;EAUA,GAAA;AAAA;AATc;AAIhB;;;AAJgB,UAgBC,mBAAA;EACf,aAAA;EACA,cAAA;EACA,OAAA;EACA,cAAA;EACA,eAAA;EACA,cAAA;EACA,eAAA;EACA,iBAAA;EACA,aAAA;EACA,cAAA;AAAA;;UAIe,YAAA;EATf;EAWA,KAAA;EACA,KAAA;EACA,IAAA;EACA,MAAA;EACA,UAAA;EAVc;EAYd,OAAA;EARe;EAUf,GAAA,GAAM,IAAA;;EAEN,QAAA;EACA,SAAA;EACA,OAAA,GAAU,mBAAmB;AAAA;;UAId,kBAAA;EACf,KAAA,GAAQ,IAAA;EACR,OAAA;EACA,YAAA,GAAe,YAAA;EACf,OAAA,GAAU,mBAAA;AAAA;;UAIK,iBAAA;EACf,KAAA,GAAQ,IAAA;EACR,OAAA;EACA,YAAA,GAAe,YAAY;AAAA;;UAIZ,aAAA;EACf,MAAA,GAAS,IAAA;EAZC;EAcV,KAAA,GAAQ,IAAA;EAdqB;EAgB7B,IAAA,GAAO,YAAA;EAnBC;EAqBR,UAAA,GAAa,iBAAA;EACb,OAAA,GAAU,mBAAA;AAAA;;UAIK,aAAA;EACf,OAAA,GAAU,mBAAmB;AAAA;AApB/B;;;AAAA,cA0Ba,cAAA,SAAuB,KAAK;EAAA,SAC9B,MAAA;EAAA,SACA,IAAA;cAEG,OAAA,UAAiB,MAAA,UAAgB,IAAA;AAAA;;UAS9B,kBAAA;EApCY;EAsC3B,KAAA;EAlC4B;EAoC5B,OAAA;EAnCS;EAqCT,KAAA,UAAe,KAAK;AAAA;;;;;;cAkBT,WAAA;EAAA,iBACM,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,SAAA;cAEL,OAAA,EAAS,kBAAA;EAtDrB;;;;;EAoEA,UAAA,IAAc,OAAA,CAAQ,aAAA;EA/DP;;;;AACc;AAM/B;EAkEE,mBAAA,CAAoB,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,aAAA;;;;;;;EAexD,kBAAA,CAAmB,KAAA,EAAO,iBAAA,GAAoB,OAAA,CAAQ,aAAA;EA7EzB;;;AAA6B;AAS5D;;EAkFE,cAAA,CAAe,KAAA,EAAO,aAAA,GAAgB,OAAA,CAAQ,aAAA;EA5E1B;;;;;;AAAA;EA6FpB,aAAA,CAAc,KAAA,EAAO,YAAA,GAAe,OAAA,CAAQ,aAAA;EA3EtB;;;;;;EAqGtB,QAAA,CAAS,KAAA,GAAO,aAAA,GAAqB,OAAA,CAAQ,aAAA;EAAA,QAI/B,OAAA;AAAA"}

package/dist/client.mjs

@@ -87,6 +87,30 @@ var ArkycClient = class {
 		return this.request("POST", "/v1/client/liveness", form);
 	}
 	/**
+	* Submit address verification (opt-in stage). Sends the claimed address plus
+	* whichever evidence was gathered (proof-of-address image, device coordinates).
+	*
+	* @param input
+	* @returns
+	*/
+	submitAddress(input) {
+		const form = new FormData();
+		const fields = {
+			line1: input.line1,
+			line2: input.line2,
+			city: input.city,
+			region: input.region,
+			postal_code: input.postalCode,
+			country: input.country
+		};
+		for (const [key, value] of Object.entries(fields)) if (value) form.append(key, value);
+		if (input.poa) form.append("poa", input.poa, "proof-of-address.jpg");
+		if (input.latitude != null) form.append("latitude", String(input.latitude));
+		if (input.longitude != null) form.append("longitude", String(input.longitude));
+		appendSignals(form, input.signals);
+		return this.request("POST", "/v1/client/address", form);
+	}
+	/**
 	* Finalise the session (runs face-match + the decision engine).
 	*
 	* @param input

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type {\n  CaptureModel,\n  DocumentType,\n  LivenessChallenge,\n  LivenessMode,\n  ProjectBranding,\n  VerificationStatus,\n  WorkflowConfig,\n} from '@arkyc/types'\n\n/** The session view exposed by the Client/Widget API (`GET /v1/client/session`). */\nexport interface ClientSession {\n  id: string\n  status: VerificationStatus\n  expires_at: string\n  /** The capture flow this session runs (Phase 17). */\n  capture_model?: CaptureModel\n  /** The active-liveness challenge sequence to prompt the user through. */\n  liveness_challenges?: LivenessChallenge[]\n  /** Cross-device handoff config resolved from the project setting. */\n  handoff?: ClientHandoff\n  /** How to watch this session live (push transport params or `polling`). */\n  realtime?: ClientRealtime\n  /** Project branding (colours/logo/name) so the widget themes itself at runtime. */\n  branding?: ProjectBranding | null\n  /** The applied workflow (ordered, toggleable stages + skip_ocr), or null for the default flow. */\n  workflow?: WorkflowConfig | null\n}\n\n/**\n * Realtime connection info for this session (Phase 16). `transport` selects how\n * the widget watches the session: `pusher`/`firebase` subscribe to `channel`;\n * `polling` (and `off`/`memory`) mean poll the session endpoint instead. The\n * remaining fields carry the active transport's public connection params; `token`\n * is a per-session Firebase custom token when applicable.\n */\nexport interface ClientRealtime {\n  transport: 'pusher' | 'firebase' | 'polling' | 'off' | 'memory'\n  /** The private channel this session's events publish to. */\n  channel: string\n  /** Per-session Firebase custom token (firebase transport only). */\n  token?: string | null\n  [param: string]: unknown\n}\n\n/** Whether (and where) the widget may offer cross-device handoff. */\nexport interface ClientHandoff {\n  enabled: boolean\n  /** Whether a desktop user may continue on the desktop device instead of handing off. */\n  allow_desktop: boolean\n  /** First-party hosted page the QR points to (the phone resumes the session there). */\n  url: string\n}\n\n/**\n * Mock-driver signal hints. Real provider drivers ignore these; the `mock`\n * drivers use them to make the demo/playground flow deterministic.\n */\nexport interface ProviderSignalHints {\n  quality_score?: number\n  ocr_confidence?: number\n  expired?: boolean\n  liveness_score?: number\n  liveness_passed?: boolean\n  multiple_faces?: boolean\n  face_similarity?: number\n  face_match_passed?: boolean\n}\n\n/** Input for the document-front submission. */\nexport interface DocumentFrontInput {\n  image?: Blob | null\n  country?: string | null\n  documentType?: DocumentType | null\n  signals?: ProviderSignalHints\n}\n\n/** Input for the document-back submission. */\nexport interface DocumentBackInput {\n  image?: Blob | null\n  country?: string | null\n  documentType?: DocumentType | null\n}\n\n/** Input for the liveness submission (passive selfie or active challenge video). */\nexport interface LivenessInput {\n  selfie?: Blob | null\n  /** Recorded challenge video (active mode). */\n  video?: Blob | null\n  /** Passive (selfie) or active (challenge video). Defaults to passive. */\n  mode?: LivenessMode\n  /** The challenge sequence the user performed, in order (active mode). */\n  challenges?: LivenessChallenge[]\n  signals?: ProviderSignalHints\n}\n\n/** Input for completing the session (runs face-match + decision). */\nexport interface CompleteInput {\n  signals?: ProviderSignalHints\n}\n\n/**\n * Raised when the Client API returns a non-2xx response.\n */\nexport class WidgetApiError extends Error {\n  readonly status: number\n  readonly code?: string\n\n  constructor(message: string, status: number, code?: string) {\n    super(message)\n    this.name = 'WidgetApiError'\n    this.status = status\n    this.code = code\n  }\n}\n\n/** Options for {@link ArkycClient}. */\nexport interface ArkycClientOptions {\n  /** Short-lived client token minted for this session. */\n  token: string\n  /** API origin (defaults to the same origin the widget is served from). */\n  baseUrl?: string\n  /** Injectable for testing; defaults to the global `fetch`. */\n  fetch?: typeof fetch\n}\n\ntype EnvelopeNumber = number | boolean\n\nfunction appendSignals(form: FormData, signals?: ProviderSignalHints): void {\n  if (!signals) return\n  for (const [key, value] of Object.entries(signals)) {\n    if (value == null) continue\n    form.append(key, String(value as EnvelopeNumber))\n  }\n}\n\n/**\n * A thin, framework-agnostic client for the Arkyc Client/Widget API. Drives a\n * single verification session with a short-lived client token. All responses\n * are unwrapped from the standard `{ status, message, data }` envelope.\n */\nexport class ArkycClient {\n  private readonly token: string\n  private readonly baseUrl: string\n  private readonly fetchImpl: typeof fetch\n\n  constructor(options: ArkycClientOptions) {\n    if (!options.token) throw new Error('ArkycClient requires a client `token`.')\n    this.token = options.token\n    this.baseUrl = (options.baseUrl ?? '').replace(/\\/$/, '')\n    const f = options.fetch ?? globalThis.fetch\n    if (!f) throw new Error('No `fetch` implementation available.')\n    this.fetchImpl = f.bind(globalThis)\n  }\n\n  /**\n   * Load the current session (marks it `started` on first call).\n   *\n   * @returns\n   */\n  getSession(): Promise<ClientSession> {\n    return this.request('GET', '/v1/client/session')\n  }\n\n  /**\n   * Submit the document front image (triggers OCR + portrait extraction).\n   *\n   * @param input\n   * @returns\n   */\n  submitDocumentFront(input: DocumentFrontInput): Promise<ClientSession> {\n    const form = new FormData()\n    if (input.image) form.append('image', input.image, 'document-front.jpg')\n    if (input.country) form.append('country', input.country)\n    if (input.documentType) form.append('document_type', input.documentType)\n    appendSignals(form, input.signals)\n    return this.request('POST', '/v1/client/document/front', form)\n  }\n\n  /**\n   * Submit the document back image.\n   *\n   * @param input\n   * @returns\n   */\n  submitDocumentBack(input: DocumentBackInput): Promise<ClientSession> {\n    const form = new FormData()\n    if (input.image) form.append('image', input.image, 'document-back.jpg')\n    if (input.country) form.append('country', input.country)\n    if (input.documentType) form.append('document_type', input.documentType)\n    return this.request('POST', '/v1/client/document/back', form)\n  }\n\n  /**\n   * Submit the selfie for the liveness check.\n   *\n   * @param input\n   * @returns\n   */\n  submitLiveness(input: LivenessInput): Promise<ClientSession> {\n    const form = new FormData()\n    if (input.selfie) form.append('selfie', input.selfie, 'selfie.jpg')\n    if (input.video) form.append('video', input.video, 'liveness.webm')\n    if (input.mode) form.append('mode', input.mode)\n    if (input.challenges) form.append('challenges', JSON.stringify(input.challenges))\n    appendSignals(form, input.signals)\n    return this.request('POST', '/v1/client/liveness', form)\n  }\n\n  /**\n   * Finalise the session (runs face-match + the decision engine).\n   *\n   * @param input\n   * @returns\n   */\n  complete(input: CompleteInput = {}): Promise<ClientSession> {\n    return this.request('POST', '/v1/client/complete', input.signals ?? {})\n  }\n\n  private async request(method: string, path: string, body?: FormData | object): Promise<ClientSession> {\n    const headers: Record<string, string> = { 'X-Client-Token': this.token }\n    let payload: BodyInit | undefined\n\n    if (body instanceof FormData) {\n      payload = body\n    } else if (body) {\n      headers['Content-Type'] = 'application/json'\n      payload = JSON.stringify(body)\n    }\n\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, { method, headers, body: payload })\n    const text = await res.text()\n    const json = text ? (JSON.parse(text) as { message?: string; data?: ClientSession }) : {}\n\n    if (!res.ok) {\n      throw new WidgetApiError(json.message ?? `Request failed (${res.status})`, res.status)\n    }\n    return json.data as ClientSession\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type {\n  CaptureModel,\n  DocumentType,\n  LivenessChallenge,\n  LivenessMode,\n  ProjectBranding,\n  VerificationStatus,\n  WorkflowConfig,\n} from '@arkyc/types'\n\n/** The session view exposed by the Client/Widget API (`GET /v1/client/session`). */\nexport interface ClientSession {\n  id: string\n  status: VerificationStatus\n  expires_at: string\n  /** The capture flow this session runs (Phase 17). */\n  capture_model?: CaptureModel\n  /** The active-liveness challenge sequence to prompt the user through. */\n  liveness_challenges?: LivenessChallenge[]\n  /** Cross-device handoff config resolved from the project setting. */\n  handoff?: ClientHandoff\n  /** How to watch this session live (push transport params or `polling`). */\n  realtime?: ClientRealtime\n  /** Project branding (colours/logo/name) so the widget themes itself at runtime. */\n  branding?: ProjectBranding | null\n  /** The applied workflow (ordered, toggleable stages + skip_ocr), or null for the default flow. */\n  workflow?: WorkflowConfig | null\n}\n\n/**\n * Realtime connection info for this session (Phase 16). `transport` selects how\n * the widget watches the session: `pusher`/`firebase` subscribe to `channel`;\n * `polling` (and `off`/`memory`) mean poll the session endpoint instead. The\n * remaining fields carry the active transport's public connection params; `token`\n * is a per-session Firebase custom token when applicable.\n */\nexport interface ClientRealtime {\n  transport: 'pusher' | 'firebase' | 'polling' | 'off' | 'memory'\n  /** The private channel this session's events publish to. */\n  channel: string\n  /** Per-session Firebase custom token (firebase transport only). */\n  token?: string | null\n  [param: string]: unknown\n}\n\n/** Whether (and where) the widget may offer cross-device handoff. */\nexport interface ClientHandoff {\n  enabled: boolean\n  /** Whether a desktop user may continue on the desktop device instead of handing off. */\n  allow_desktop: boolean\n  /** First-party hosted page the QR points to (the phone resumes the session there). */\n  url: string\n}\n\n/**\n * Mock-driver signal hints. Real provider drivers ignore these; the `mock`\n * drivers use them to make the demo/playground flow deterministic.\n */\nexport interface ProviderSignalHints {\n  quality_score?: number\n  ocr_confidence?: number\n  expired?: boolean\n  liveness_score?: number\n  liveness_passed?: boolean\n  multiple_faces?: boolean\n  face_similarity?: number\n  face_match_passed?: boolean\n  address_score?: number\n  address_passed?: boolean\n}\n\n/** Input for the address-verification submission (opt-in stage). */\nexport interface AddressInput {\n  /** The claimed address the user entered. */\n  line1?: string | null\n  line2?: string | null\n  city?: string | null\n  region?: string | null\n  postalCode?: string | null\n  /** ISO 3166-1 alpha-2 country code. */\n  country?: string | null\n  /** Proof-of-address document image. */\n  poa?: Blob | null\n  /** Captured device coordinates. */\n  latitude?: number | null\n  longitude?: number | null\n  signals?: ProviderSignalHints\n}\n\n/** Input for the document-front submission. */\nexport interface DocumentFrontInput {\n  image?: Blob | null\n  country?: string | null\n  documentType?: DocumentType | null\n  signals?: ProviderSignalHints\n}\n\n/** Input for the document-back submission. */\nexport interface DocumentBackInput {\n  image?: Blob | null\n  country?: string | null\n  documentType?: DocumentType | null\n}\n\n/** Input for the liveness submission (passive selfie or active challenge video). */\nexport interface LivenessInput {\n  selfie?: Blob | null\n  /** Recorded challenge video (active mode). */\n  video?: Blob | null\n  /** Passive (selfie) or active (challenge video). Defaults to passive. */\n  mode?: LivenessMode\n  /** The challenge sequence the user performed, in order (active mode). */\n  challenges?: LivenessChallenge[]\n  signals?: ProviderSignalHints\n}\n\n/** Input for completing the session (runs face-match + decision). */\nexport interface CompleteInput {\n  signals?: ProviderSignalHints\n}\n\n/**\n * Raised when the Client API returns a non-2xx response.\n */\nexport class WidgetApiError extends Error {\n  readonly status: number\n  readonly code?: string\n\n  constructor(message: string, status: number, code?: string) {\n    super(message)\n    this.name = 'WidgetApiError'\n    this.status = status\n    this.code = code\n  }\n}\n\n/** Options for {@link ArkycClient}. */\nexport interface ArkycClientOptions {\n  /** Short-lived client token minted for this session. */\n  token: string\n  /** API origin (defaults to the same origin the widget is served from). */\n  baseUrl?: string\n  /** Injectable for testing; defaults to the global `fetch`. */\n  fetch?: typeof fetch\n}\n\ntype EnvelopeNumber = number | boolean\n\nfunction appendSignals(form: FormData, signals?: ProviderSignalHints): void {\n  if (!signals) return\n  for (const [key, value] of Object.entries(signals)) {\n    if (value == null) continue\n    form.append(key, String(value as EnvelopeNumber))\n  }\n}\n\n/**\n * A thin, framework-agnostic client for the Arkyc Client/Widget API. Drives a\n * single verification session with a short-lived client token. All responses\n * are unwrapped from the standard `{ status, message, data }` envelope.\n */\nexport class ArkycClient {\n  private readonly token: string\n  private readonly baseUrl: string\n  private readonly fetchImpl: typeof fetch\n\n  constructor(options: ArkycClientOptions) {\n    if (!options.token) throw new Error('ArkycClient requires a client `token`.')\n    this.token = options.token\n    this.baseUrl = (options.baseUrl ?? '').replace(/\\/$/, '')\n    const f = options.fetch ?? globalThis.fetch\n    if (!f) throw new Error('No `fetch` implementation available.')\n    this.fetchImpl = f.bind(globalThis)\n  }\n\n  /**\n   * Load the current session (marks it `started` on first call).\n   *\n   * @returns\n   */\n  getSession(): Promise<ClientSession> {\n    return this.request('GET', '/v1/client/session')\n  }\n\n  /**\n   * Submit the document front image (triggers OCR + portrait extraction).\n   *\n   * @param input\n   * @returns\n   */\n  submitDocumentFront(input: DocumentFrontInput): Promise<ClientSession> {\n    const form = new FormData()\n    if (input.image) form.append('image', input.image, 'document-front.jpg')\n    if (input.country) form.append('country', input.country)\n    if (input.documentType) form.append('document_type', input.documentType)\n    appendSignals(form, input.signals)\n    return this.request('POST', '/v1/client/document/front', form)\n  }\n\n  /**\n   * Submit the document back image.\n   *\n   * @param input\n   * @returns\n   */\n  submitDocumentBack(input: DocumentBackInput): Promise<ClientSession> {\n    const form = new FormData()\n    if (input.image) form.append('image', input.image, 'document-back.jpg')\n    if (input.country) form.append('country', input.country)\n    if (input.documentType) form.append('document_type', input.documentType)\n    return this.request('POST', '/v1/client/document/back', form)\n  }\n\n  /**\n   * Submit the selfie for the liveness check.\n   *\n   * @param input\n   * @returns\n   */\n  submitLiveness(input: LivenessInput): Promise<ClientSession> {\n    const form = new FormData()\n    if (input.selfie) form.append('selfie', input.selfie, 'selfie.jpg')\n    if (input.video) form.append('video', input.video, 'liveness.webm')\n    if (input.mode) form.append('mode', input.mode)\n    if (input.challenges) form.append('challenges', JSON.stringify(input.challenges))\n    appendSignals(form, input.signals)\n    return this.request('POST', '/v1/client/liveness', form)\n  }\n\n  /**\n   * Submit address verification (opt-in stage). Sends the claimed address plus\n   * whichever evidence was gathered (proof-of-address image, device coordinates).\n   *\n   * @param input\n   * @returns\n   */\n  submitAddress(input: AddressInput): Promise<ClientSession> {\n    const form = new FormData()\n    const fields: Record<string, string | null | undefined> = {\n      line1: input.line1,\n      line2: input.line2,\n      city: input.city,\n      region: input.region,\n      postal_code: input.postalCode,\n      country: input.country,\n    }\n    for (const [key, value] of Object.entries(fields)) {\n      if (value) form.append(key, value)\n    }\n    if (input.poa) form.append('poa', input.poa, 'proof-of-address.jpg')\n    if (input.latitude != null) form.append('latitude', String(input.latitude))\n    if (input.longitude != null) form.append('longitude', String(input.longitude))\n    appendSignals(form, input.signals)\n    return this.request('POST', '/v1/client/address', form)\n  }\n\n  /**\n   * Finalise the session (runs face-match + the decision engine).\n   *\n   * @param input\n   * @returns\n   */\n  complete(input: CompleteInput = {}): Promise<ClientSession> {\n    return this.request('POST', '/v1/client/complete', input.signals ?? {})\n  }\n\n  private async request(method: string, path: string, body?: FormData | object): Promise<ClientSession> {\n    const headers: Record<string, string> = { 'X-Client-Token': this.token }\n    let payload: BodyInit | undefined\n\n    if (body instanceof FormData) {\n      payload = body\n    } else if (body) {\n      headers['Content-Type'] = 'application/json'\n      payload = JSON.stringify(body)\n    }\n\n    const res = await this.fetchImpl(`${this.baseUrl}${path}`, { method, headers, body: payload })\n    const text = await res.text()\n    const json = text ? (JSON.parse(text) as { message?: string; data?: ClientSession }) : {}\n\n    if (!res.ok) {\n      throw new WidgetApiError(json.message ?? `Request failed (${res.status})`, res.status)\n    }\n    return json.data as ClientSession\n  }\n}\n"],"mappings":"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"}

package/dist/controller.d.mts

@@ -36,6 +36,10 @@ declare class WidgetController {
   /** The session's capture model; `active` mandates a live camera (no fallback). */
   private captureModel;
   private livenessChallenges;
+  /** The address-entry form data, captured before the address submission. */
+  private addressData;
+  /** Device coordinates resolved on the address step (when the user opts in). */
+  private addressCoords;
   /** The applied workflow (orders/toggles stages, skip_ocr), or null for the default flow. */
   private workflow;
   private result;
@@ -88,28 +92,81 @@ declare class WidgetController {
   private handoffTarget;
   /** Render the QR for this session and wait for the other device to finish. */
   private startHandoff;
-  /** Build the hosted-page URL the QR encodes (carries the session token). */
+  /** Build the hosted-page URL the QR encodes (carries the session token).
+   *
+   * @param target
+   * @returns
+   */
   private buildHandoffUrl;
-  /** Watch the session while the user verifies on the other device; mirror the result. */
+  /**
+   * Watch the session while the user verifies on the other
+   * device; mirror the result.
+   *
+   * @returns
+   */
   private pollHandoff;
   /**
    * Await a terminal status over the push transport. Resolves to the terminal
    * status, or null if `active()` went false or the tick budget elapsed (push can
    * miss events / disconnect; the budget bounds the wait). An initial fetch
    * catches a session that finished before we subscribed.
+   *
+   * @param rt
+   * @param budget
+   * @param active
+   * @returns
    */
   private pushWatch;
-  /** Resolve which liveness flow to run from the session's capture model. */
+  /**
+   * Resolve which liveness flow to run from the session's capture model.
+   *
+   * @param session
+   */
   private resolveLiveness;
   private onImage;
-  /** Enter a step: render it, and drive any automatic (processing) work. */
+  /**
+   * Enter a step: render it, and drive any automatic (processing) work.
+   *
+   * @param step
+   * @returns
+   */
   private enter;
-  /** Watch the session until it reaches a terminal status (then show the result). */
+  /** Watch the session until it reaches a terminal status (then show the result).
+   *
+   * @returns
+   */
   private poll;
   private showResult;
-  /** A session that was already terminal on load: a notice with only a Close button. */
+  /**
+   * A session that was already terminal on load: a notice with only a Close button.
+   *
+   * @param status
+   */
   private showTerminal;
   private render;
+  /**
+   * Store the entered address, resolve device location if opted in, then verify.
+   *
+   * @param data
+   * @returns
+   */
+  private onAddress;
+  /** Request the device's location (from the address-entry "use my location" opt-in). */
+  private shareLocation;
+  /**
+   * Submit the captured address evidence to the Client API.
+   *
+   * @returns
+   */
+  private submitAddress;
+  /**
+   * Resolve the device's coordinates via the Geolocation API. Resolves to `null`
+   * on denial/unavailability/timeout — the `device_location` method then simply
+   * has no coordinates to check (routing the session to review).
+   *
+   * @returns
+   */
+  private geolocate;
   private next;
   private delay;
   /** Run an async step, routing any failure to the error screen. */

package/dist/controller.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.mts","names":[],"sources":["../src/controller.ts"],"mappings":";;;cAoEa,gBAAA;EAAA,iBA+CkB,MAAA;EAAA,iBA9CZ,MAAA;EAAA,iBACA,IAAA;EAAA,iBACA,GAAA;EAAA,iBACA,GAAA;EAAA,iBACA,YAAA;EAAA,iBACA,SAAA;EAAA,iBACA,WAAA;EAAA,iBACA,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,eAAA;EARA;EAAA,QAWT,aAAA;EAAA,QACA,YAAA;EAAA,QACA,aAAA;EATS;EAAA,QAYT,SAAA;EAAA,QACA,cAAA;EAAA,QACA,QAAA;EAAA,QACA,UAAA;EARA;EAAA,QAUA,UAAA;EARA;EAAA,QAUA,SAAA;EANA;EAAA,QAQA,SAAA;EAAA,QAEA,IAAA;EAAA,QACA,YAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,QACA,YAAA;EAHA;EAAA,QAKA,YAAA;EAAA,QACA,kBAAA;EAHA;EAAA,QAKA,QAAA;EAAA,QACA,MAAA;EADA;EAAA,QAGA,cAAA;EAAA;EAAA,QAEA,gBAAA;EAAA,QACA,YAAA;EAAA,QACA,OAAA;cAEqB,MAAA,EAAQ,sBAAA;EAAA;EAAA,IAkCjC,OAAA,IAAW,WAAA;EAAX;EAKJ,KAAA;EAAA;EAMA,OAAA;EAKA;EAAA,KAAA;EAQG;;;;EAAH,EAAA,CAAG,KAAA,UAAe,QAAA,EAAU,mBAAA;EA6BpB;EAAA,QApBA,WAAA;EAwDM;;;;;EAAA,QA5CN,QAAA;EA2JM;EAAA,QAnJN,IAAA;EAwOA;EAAA,QApNA,OAAA;EAwPM;;;;;EAAA,QAxOA,eAAA;EAAA,QAoBN,QAAA;EAoTM;;;;;EAAA,QA9QA,SAAA;EA0UF;EAAA,QA/SJ,aAAA;;UAKM,YAAA;;UAUN,eAAA;;UAWM,WAAA;;;;;;;UAyCN,SAAA;;UA4CA,eAAA;EAAA,QAWM,OAAA;;UAyBA,KAAA;;UAkCA,IAAA;EAAA,QAkBN,UAAA;;UAOA,YAAA;EAAA,QAOA,MAAA;EAAA,QAiBA,IAAA;EAAA,QAQA,KAAA;;UAKM,GAAA;EAAA,QAQN,IAAA;EAAA,QAcA,YAAA;EAAA,QAmBA,WAAA;;UAaA,gBAAA;EAAA,QAMA,IAAA;AAAA"}
+{"version":3,"file":"controller.d.mts","names":[],"sources":["../src/controller.ts"],"mappings":";;;cAoEa,gBAAA;EAAA,iBAmDkB,MAAA;EAAA,iBAlDZ,MAAA;EAAA,iBACA,IAAA;EAAA,iBACA,GAAA;EAAA,iBACA,GAAA;EAAA,iBACA,YAAA;EAAA,iBACA,SAAA;EAAA,iBACA,WAAA;EAAA,iBACA,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,eAAA;EARA;EAAA,QAWT,aAAA;EAAA,QACA,YAAA;EAAA,QACA,aAAA;EATS;EAAA,QAYT,SAAA;EAAA,QACA,cAAA;EAAA,QACA,QAAA;EAAA,QACA,UAAA;EARA;EAAA,QAUA,UAAA;EARA;EAAA,QAUA,SAAA;EANA;EAAA,QAQA,SAAA;EAAA,QAEA,IAAA;EAAA,QACA,YAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,QACA,YAAA;EAHA;EAAA,QAKA,YAAA;EAAA,QACA,kBAAA;EAHA;EAAA,QAKA,WAAA;EAFA;EAAA,QAIA,aAAA;EAAA;EAAA,QAEA,QAAA;EAAA,QACA,MAAA;EAEA;EAAA,QAAA,cAAA;EAGA;EAAA,QADA,gBAAA;EAAA,QACA,YAAA;EAAA,QACA,OAAA;cAEqB,MAAA,EAAQ,sBAAA;EAkCjC;EAAA,IAAA,OAAA,IAAW,WAAA;EAKf;EAAA,KAAA;EAWA;EALA,OAAA;EAaG;EARH,KAAA;EAQkB;;;;EAAlB,EAAA,CAAG,KAAA,UAAe,QAAA,EAAU,mBAAA;EAiEd;EAAA,QAxDN,WAAA;EAoHM;;;;;EAAA,QAxGN,QAAA;EAoQA;EAAA,QA5PA,IAAA;EAqSM;EAAA,QAjRN,OAAA;EA2UA;;;;;EAAA,QA3TM,eAAA;EAAA,QAoBN,QAAA;EA8YA;;;;;EAAA,QAtWM,SAAA;EAyaN;EAAA,QA9YA,aAAA;EAoZI;EAAA,QA/YE,YAAA;;;;;;UAcN,eAAA;;;;;;;UAgBM,WAAA;;;;;;;;;;;;UA8CN,SAAA;;;;;;UAgDA,eAAA;EAAA,QAWM,OAAA;;;;;;;UA8BA,KAAA;;;;;UAwCA,IAAA;EAAA,QAkBN,UAAA;;;;;;UAWA,YAAA;EAAA,QAOA,MAAA;;;;;;;UAwBM,SAAA;;UAYA,aAAA;;;;;;UAWA,aAAA;;;;;;;;UAyBN,SAAA;EAAA,QAaA,IAAA;EAAA,QAQA,KAAA;;UAKM,GAAA;EAAA,QAQN,IAAA;EAAA,QAcA,YAAA;EAAA,QAmBA,WAAA;;UAaA,gBAAA;EAAA,QAMA,IAAA;AAAA"}

package/dist/controller.mjs

@@ -5,7 +5,7 @@ import { Flow } from "./flow.mjs";
 import { WidgetView } from "./ui.mjs";
 import { isDesktopDevice } from "./device.mjs";
 import { renderQrSvg } from "./qr.mjs";
-import { REALTIME_EVENT } from "@arkyc/types";
+import { REALTIME_EVENT, workflowAddressConfig } from "@arkyc/types";
 //#region src/controller.ts
 /** Per-step lead-in copy shown before each capture/liveness step. */
 const STEP_INSTRUCTIONS = {
@@ -95,6 +95,10 @@ var WidgetController = class {
 	/** The session's capture model; `active` mandates a live camera (no fallback). */
 	captureModel = "passive";
 	livenessChallenges = [];
+	/** The address-entry form data, captured before the address submission. */
+	addressData = null;
+	/** Device coordinates resolved on the address step (when the user opts in). */
+	addressCoords = null;
 	/** The applied workflow (orders/toggles stages, skip_ocr), or null for the default flow. */
 	workflow = null;
 	result = null;
@@ -237,6 +241,8 @@ var WidgetController = class {
 				});
 				await this.enter(this.next());
 			}),
+			onAddress: (data) => void this.run(() => this.onAddress(data)),
+			onShareLocation: () => this.shareLocation(),
 			onAcknowledge: () => this.finishResult(),
 			onUsePhone: () => void this.run(() => this.startHandoff()),
 			onContinueHere: () => {
@@ -284,14 +290,23 @@ var WidgetController = class {
 		this.view.renderHandoff(renderQrSvg(this.buildHandoffUrl(target)), this.handoffConfig.allow_desktop);
 		await this.pollHandoff();
 	}
-	/** Build the hosted-page URL the QR encodes (carries the session token). */
+	/** Build the hosted-page URL the QR encodes (carries the session token).
+	*
+	* @param target
+	* @returns
+	*/
 	buildHandoffUrl(target) {
 		let url = `${target}${target.includes("?") ? "&" : "?"}token=${encodeURIComponent(this.config.token)}`;
 		const apiBase = (this.config.baseUrl ?? "").trim();
 		if (/^https?:\/\//i.test(apiBase)) url += `&baseUrl=${encodeURIComponent(apiBase)}`;
 		return url;
 	}
-	/** Watch the session while the user verifies on the other device; mirror the result. */
+	/**
+	* Watch the session while the user verifies on the other
+	* device; mirror the result.
+	*
+	* @returns
+	*/
 	async pollHandoff() {
 		const rt = await this.resolveRealtime();
 		if (rt) {
@@ -328,6 +343,11 @@ var WidgetController = class {
 	* status, or null if `active()` went false or the tick budget elapsed (push can
 	* miss events / disconnect; the budget bounds the wait). An initial fetch
 	* catches a session that finished before we subscribed.
+	*
+	* @param rt
+	* @param budget
+	* @param active
+	* @returns
 	*/
 	pushWatch(rt, budget, active) {
 		return new Promise((resolve) => {
@@ -362,7 +382,11 @@ var WidgetController = class {
 			countdown(0);
 		});
 	}
-	/** Resolve which liveness flow to run from the session's capture model. */
+	/**
+	* Resolve which liveness flow to run from the session's capture model.
+	*
+	* @param session
+	*/
 	resolveLiveness(session) {
 		this.livenessChallenges = session.liveness_challenges ?? [];
 		const model = session.capture_model ?? "passive";
@@ -393,7 +417,12 @@ var WidgetController = class {
 				return this.enter("passive_liveness");
 		}
 	}
-	/** Enter a step: render it, and drive any automatic (processing) work. */
+	/**
+	* Enter a step: render it, and drive any automatic (processing) work.
+	*
+	* @param step
+	* @returns
+	*/
 	async enter(step) {
 		if (this.settled) return;
 		this.step = step;
@@ -411,6 +440,9 @@ var WidgetController = class {
 			case "ocr_processing":
 				await this.delay(this.transientMs);
 				return this.enter(this.next());
+			case "address_processing":
+				await this.submitAddress();
+				return this.enter(this.next());
 			case "passive_liveness":
 				await this.client.submitLiveness({
 					selfie: this.selfie,
@@ -423,7 +455,10 @@ var WidgetController = class {
 			case "processing": return this.poll();
 		}
 	}
-	/** Watch the session until it reaches a terminal status (then show the result). */
+	/** Watch the session until it reaches a terminal status (then show the result).
+	*
+	* @returns
+	*/
 	async poll() {
 		const rt = await this.resolveRealtime();
 		if (rt) {
@@ -446,7 +481,11 @@ var WidgetController = class {
 		this.step = "result";
 		this.render();
 	}
-	/** A session that was already terminal on load: a notice with only a Close button. */
+	/**
+	* A session that was already terminal on load: a notice with only a Close button.
+	*
+	* @param status
+	*/
 	showTerminal(status) {
 		this.result = {
 			status,
@@ -467,7 +506,67 @@ var WidgetController = class {
 			livenessChallenges: this.livenessChallenges,
 			requireLiveCamera: this.captureModel === "active",
 			strictCapture: this.livenessMode === "active",
-			handoffAvailable: this.handoffReady
+			handoffAvailable: this.handoffReady,
+			addressMethods: workflowAddressConfig(this.workflow)?.methods ?? []
+		});
+	}
+	/**
+	* Store the entered address, resolve device location if opted in, then verify.
+	*
+	* @param data
+	* @returns
+	*/
+	async onAddress(data) {
+		this.addressData = data;
+		if (!data.useLocation) this.addressCoords = null;
+		else if (!this.addressCoords) this.addressCoords = await this.geolocate();
+		return this.enter("address_processing");
+	}
+	/** Request the device's location (from the address-entry "use my location" opt-in). */
+	async shareLocation() {
+		this.addressCoords = await this.geolocate();
+		return !!this.addressCoords;
+	}
+	/**
+	* Submit the captured address evidence to the Client API.
+	*
+	* @returns
+	*/
+	async submitAddress() {
+		const data = this.addressData;
+		if (!data) return;
+		await this.client.submitAddress({
+			line1: data.line1,
+			line2: data.line2,
+			city: data.city,
+			region: data.region,
+			postalCode: data.postalCode,
+			country: data.country,
+			poa: data.poa,
+			latitude: this.addressCoords?.latitude ?? null,
+			longitude: this.addressCoords?.longitude ?? null,
+			signals: this.config.signals
+		});
+	}
+	/**
+	* Resolve the device's coordinates via the Geolocation API. Resolves to `null`
+	* on denial/unavailability/timeout — the `device_location` method then simply
+	* has no coordinates to check (routing the session to review).
+	*
+	* @returns
+	*/
+	geolocate() {
+		const geo = this.nav?.geolocation;
+		if (!geo) return Promise.resolve(null);
+		return new Promise((resolve) => {
+			geo.getCurrentPosition((pos) => resolve({
+				latitude: pos.coords.latitude,
+				longitude: pos.coords.longitude
+			}), () => resolve(null), {
+				enableHighAccuracy: false,
+				timeout: 1e4,
+				maximumAge: 6e4
+			});
 		});
 	}
 	next() {

package/dist/controller.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"controller.mjs","names":[],"sources":["../src/controller.ts"],"sourcesContent":["import type {\n  DocumentType,\n  LivenessChallenge,\n  LivenessMode,\n  SessionTransitionEvent,\n  VerificationStatus,\n  WidgetResult,\n  WidgetStep,\n  WorkflowConfig,\n} from '@arkyc/types'\nimport { REALTIME_EVENT } from '@arkyc/types'\nimport { ArkycClient, type ClientHandoff, type ClientRealtime, type ClientSession, WidgetApiError } from './client'\nimport { Flow } from './flow'\nimport { Theme } from './theme'\nimport { WidgetView, type ViewHandlers } from './ui'\nimport { isDesktopDevice } from './device'\nimport { renderQrSvg } from './qr'\nimport { createWidgetRealtimeClient, type WidgetRealtimeClient } from './realtime'\nimport type { BaseWidgetOptions, WidgetControllerConfig, WidgetEventListener } from './types'\n\n/** Per-step lead-in copy shown before each capture/liveness step. */\nconst STEP_INSTRUCTIONS: Partial<Record<WidgetStep, { title: string; body: string; cta?: string }>> = {\n  front_capture: {\n    title: 'Front of your document',\n    body: 'Place the front of your ID flat and fully inside the frame. We’ll capture it automatically.',\n  },\n  back_capture: {\n    title: 'Back of your document',\n    body: 'Now turn your ID over and show the back, fully inside the frame.',\n  },\n  selfie_capture: {\n    title: 'Take a selfie',\n    body: 'Look straight at the camera in good light and hold still — we’ll capture it automatically.',\n  },\n  active_liveness: {\n    title: 'Quick liveness check',\n    body: 'Follow the on-screen prompts (such as turn your head, blink or smile). This confirms you’re really here.',\n  },\n}\n\n/**\n * Drives the full verification flow: renders each screen via {@link WidgetView},\n * advances through {@link flow}, and calls the Client API at each step. Cosmetic\n * processing screens auto-advance; capture screens wait for an image. On a\n * terminal result it surfaces the outcome and (in hosted mode) posts\n * `arkyc:complete` / `arkyc:error` / `arkyc:close` to the parent window.\n */\n/**\n * Re-base the server-resolved project logo onto the API origin the widget is\n * actually talking to. The stored `logo_url` carries the API's own host, which a\n * handed-off phone cannot reach — it reaches the API through the absolute\n * `baseUrl` passed in the handoff link. Rewriting the origin (keeping the path)\n * makes the logo load on whatever device runs the widget. Only applied when\n * `baseUrl` is absolute; the integrator's own branding is never re-based.\n */\nfunction rebaseBrandingLogo<T extends { logo_url?: string | null }>(branding: T, baseUrl: string | undefined): T {\n  const logo = branding.logo_url\n  if (!logo || !baseUrl || !/^https?:\\/\\//i.test(baseUrl)) return branding\n  try {\n    const base = new URL(baseUrl)\n    const resolved = new URL(logo, base)\n    if (resolved.origin === base.origin) return branding\n    return { ...branding, logo_url: `${base.origin}${resolved.pathname}${resolved.search}${resolved.hash}` }\n  } catch {\n    return branding\n  }\n}\n\nexport class WidgetController {\n  private readonly client: ArkycClient\n  private readonly view: WidgetView\n  private readonly win: Window\n  private readonly nav: Navigator\n  private readonly postToParent: boolean\n  private readonly scheduler: (fn: () => void, ms: number) => void\n  private readonly transientMs: number\n  private readonly pollMs: number\n  private readonly maxPolls: number\n  private readonly maxHandoffPolls: number\n\n  /** Cross-device handoff: project config + whether the offer/QR is showing. */\n  private handoffConfig: ClientHandoff = { enabled: false, allow_desktop: true, url: '' }\n  private handoffReady = false\n  private handoffActive = false\n\n  /** This session's id + how to watch it live (push transport vs. polling). */\n  private sessionId = ''\n  private realtimeConfig: ClientRealtime | null = null\n  private rtClient: WidgetRealtimeClient | null = null\n  private rtResolved = false\n  /** The last status observed, so a transition only emits once per change. */\n  private lastStatus: VerificationStatus | null = null\n  /** Per-name event listeners registered via {@link on}. */\n  private listeners = new Map<string, Set<WidgetEventListener>>()\n  /** Cancels the active session watch (e.g. continue-on-this-device). */\n  private stopWatch: (() => void) | undefined\n\n  private step: WidgetStep = 'welcome'\n  private documentType: DocumentType | null = null\n  private country: string | null = null\n  private selfie: Blob | null = null\n  private livenessMode: LivenessMode = 'passive'\n  /** The session's capture model; `active` mandates a live camera (no fallback). */\n  private captureModel: 'passive' | 'active' | 'both' = 'passive'\n  private livenessChallenges: LivenessChallenge[] = []\n  /** The applied workflow (orders/toggles stages, skip_ocr), or null for the default flow. */\n  private workflow: WorkflowConfig | null = null\n  private result: WidgetResult | null = null\n  /** The session was already terminal when the widget loaded (show a close-only notice). */\n  private terminalOnLoad = false\n  /** Whether the current step's instruction interstitial has been acknowledged. */\n  private instructionAcked = false\n  private pendingError: Error | null = null\n  private settled = false\n\n  constructor(private readonly config: WidgetControllerConfig) {\n    const doc = config.doc ?? globalThis.document\n    const win = config.win ?? globalThis.window\n    if (!doc || !win) throw new Error('The Arkyc widget must run in a browser environment.')\n    this.win = win\n    this.nav = config.nav ?? globalThis.navigator\n\n    this.client = new ArkycClient({\n      token: config.token,\n      baseUrl: config.baseUrl,\n      fetch: config.fetch,\n    })\n    const theme = new Theme(config.branding)\n    this.view = new WidgetView(\n      doc,\n      theme,\n      this.handlers(),\n      config.nav ?? globalThis.navigator,\n      config.faceAnalyzer,\n      config.faceTuning,\n      config.documentAnalyzer,\n      config.documentTuning,\n    )\n\n    this.postToParent = config.postToParent ?? (!!win.parent && win.parent !== win)\n    this.scheduler = config.scheduler ?? ((fn, ms) => setTimeout(fn, ms))\n    this.transientMs = config.transientMs ?? 700\n    this.pollMs = config.pollMs ?? 1500\n    this.maxPolls = config.maxPolls ?? 40\n    // A handed-off session is bounded by its TTL (~15 min); poll generously.\n    this.maxHandoffPolls = config.maxHandoffPolls ?? 600\n  }\n\n  /** The widget's root element — append it to an overlay or inline container. */\n  get element(): HTMLElement {\n    return this.view.element\n  }\n\n  /** Connect to the session, then route to the result, the QR, or the welcome flow. */\n  start(): void {\n    this.view.renderLoading()\n    void this.run(() => this.bootstrap())\n  }\n\n  /** Tear down the view and release the camera (does not fire callbacks). */\n  destroy(): void {\n    this.view.destroy()\n  }\n\n  /** Close the widget as if the user dismissed it (fires `onClose`/`onSettle`). */\n  close(): void {\n    this.finishClose()\n  }\n\n  /**\n   * Subscribe to a named widget event; returns an unsubscribe function. Having a\n   * listener (here or via `onEvent`) is what activates the event stream.\n   */\n  on(event: string, listener: WidgetEventListener): () => void {\n    const set = this.listeners.get(event) ?? new Set<WidgetEventListener>()\n    set.add(listener)\n    this.listeners.set(event, set)\n\n    return () => set.delete(listener)\n  }\n\n  /** Whether anyone is listening for `name` (the firehose or a named listener). */\n  private hasListener(name: string): boolean {\n    if (this.config.onEvent) return true\n    const set = this.listeners.get(name)\n\n    return !!set && set.size > 0\n  }\n\n  /**\n   * Surface an event: to local listeners (firehose + `on`), and — in hosted\n   * iframe mode — to the embedding parent as `arkyc:event` so the SDK's\n   * `handle.on(...)` works across the frame.\n   */\n  private dispatch(name: string, data?: unknown): void {\n    this.emit(name, data)\n    // The parent window is the consumer in iframe mode, so forwarding there isn't\n    // gated on a local listener (post() already no-ops when not embedding).\n    this.post('arkyc:event', { name, data })\n  }\n\n  /** Emit an event to the firehose + named listeners — but only if one is active. */\n  private emit(name: string, data?: unknown): void {\n    if (!this.hasListener(name)) return\n    try {\n      this.config.onEvent?.({ name, data })\n    } catch {\n      // A consumer callback threw — never let it break the flow.\n    }\n    const set = this.listeners.get(name)\n    if (set) {\n      for (const listener of [...set]) {\n        try {\n          listener(data)\n        } catch {\n          // ditto\n        }\n      }\n    }\n  }\n\n  /** Record an observed status, emitting `session.transition` on a real change. */\n  private observe(status: VerificationStatus): void {\n    if (status === this.lastStatus) return\n    const previous = this.lastStatus\n    this.lastStatus = status\n    this.dispatch(REALTIME_EVENT.sessionTransition, {\n      session_id: this.sessionId,\n      status,\n      previous_status: previous,\n    } satisfies Partial<SessionTransitionEvent>)\n  }\n\n  /**\n   * Lazily connect the push transport for this session (once). Returns null for\n   * `polling`/`off`/`memory` or when the transport SDK can't load — the caller\n   * then polls instead.\n   */\n  private async resolveRealtime(): Promise<WidgetRealtimeClient | null> {\n    if (this.rtResolved) return this.rtClient\n    this.rtResolved = true\n    const cfg = this.realtimeConfig\n    if (!cfg || cfg.transport === 'polling' || cfg.transport === 'off' || cfg.transport === 'memory') return null\n\n    const factory = this.config.realtimeFactory ?? createWidgetRealtimeClient\n    const apiBase = (this.config.baseUrl ?? '').replace(/\\/$/, '')\n    try {\n      this.rtClient = await factory(cfg, {\n        authEndpoint: `${apiBase}/v1/client/realtime/auth`,\n        token: this.config.token,\n      })\n    } catch {\n      this.rtClient = null\n    }\n\n    return this.rtClient\n  }\n\n  private handlers(): ViewHandlers {\n    return {\n      onClose: () => this.finishClose(),\n      // The session was already fetched + resolved during bootstrap; just advance.\n      onStart: () => void this.run(() => this.enter(this.next())),\n      onDocumentSelected: (type, country) => {\n        this.documentType = type\n        this.country = country || null\n        void this.run(() => this.enter('front_capture'))\n      },\n      onImage: (blob) => void this.run(() => this.onImage(blob)),\n      onActiveLiveness: (video, performed, selfie) =>\n        void this.run(async () => {\n          await this.client.submitLiveness({\n            selfie,\n            video,\n            mode: 'active',\n            challenges: performed,\n            signals: this.config.signals,\n          })\n          await this.enter(this.next())\n        }),\n      onAcknowledge: () => this.finishResult(),\n      onUsePhone: () => void this.run(() => this.startHandoff()),\n      onContinueHere: () => {\n        this.handoffActive = false\n        this.stopWatch?.()\n        this.step = 'welcome'\n        this.render()\n      },\n    }\n  }\n\n  /**\n   * Fetch the session and route: an already-terminal session (e.g. a stale handoff\n   * link, or one finished on another device) shows a close-only notice; on a\n   * desktop with handoff enabled we lead with the QR; otherwise the welcome flow.\n   */\n  private async bootstrap(): Promise<void> {\n    if (this.settled) return\n    const session = await this.client.getSession()\n    if (this.settled) return\n    this.sessionId = session.id\n    this.realtimeConfig = session.realtime ?? null\n    this.workflow = session.workflow ?? null\n    // Theme from the project's branding (server-resolved) unless the integrator\n    // passed branding explicitly — their value wins.\n    if (this.config.branding == null && session.branding)\n      this.view.applyBranding(rebaseBrandingLogo(session.branding, this.config.baseUrl))\n    this.observe(session.status)\n    if (Flow.isTerminal(session.status)) return this.showTerminal(session.status)\n    this.resolveLiveness(session)\n    if (session.handoff) this.handoffConfig = session.handoff\n    const canHandoff =\n      this.config.handoff !== false && isDesktopDevice(this.nav) && this.handoffConfig.enabled && !!this.handoffTarget()\n    if (canHandoff) {\n      this.handoffReady = true\n      await this.startHandoff()\n    } else {\n      this.step = 'welcome'\n      this.render()\n    }\n  }\n\n  /** The hosted handoff page URL: a consumer override, else the server-provided one. */\n  private handoffTarget(): string {\n    return (this.config.handoffUrl ?? this.handoffConfig.url ?? '').trim()\n  }\n\n  /** Render the QR for this session and wait for the other device to finish. */\n  private async startHandoff(): Promise<void> {\n    const target = this.handoffTarget()\n    if (!target) return\n    this.handoffActive = true\n    // Offer \"continue on this device\" only when the project permits it.\n    this.view.renderHandoff(renderQrSvg(this.buildHandoffUrl(target)), this.handoffConfig.allow_desktop)\n    await this.pollHandoff()\n  }\n\n  /** Build the hosted-page URL the QR encodes (carries the session token). */\n  private buildHandoffUrl(target: string): string {\n    const sep = target.includes('?') ? '&' : '?'\n    let url = `${target}${sep}token=${encodeURIComponent(this.config.token)}`\n    // The hosted page supplies its own API base; only pass one when ours is\n    // absolute, so a custom cross-origin host can still reach the right API.\n    const apiBase = (this.config.baseUrl ?? '').trim()\n    if (/^https?:\\/\\//i.test(apiBase)) url += `&baseUrl=${encodeURIComponent(apiBase)}`\n    return url\n  }\n\n  /** Watch the session while the user verifies on the other device; mirror the result. */\n  private async pollHandoff(): Promise<void> {\n    const rt = await this.resolveRealtime()\n    if (rt) {\n      const status = await this.pushWatch(rt, this.maxHandoffPolls, () => this.handoffActive && !this.settled)\n      if (status) {\n        this.handoffActive = false\n        return this.showResult(status)\n      }\n\n      return // cancelled (continue here) or budget elapsed → the QR persists\n    }\n\n    let errors = 0\n    for (let i = 0; i < this.maxHandoffPolls && this.handoffActive && !this.settled; i++) {\n      await this.delay(this.pollMs)\n      if (!this.handoffActive || this.settled) return\n      try {\n        const session = await this.client.getSession()\n        errors = 0\n        this.observe(session.status)\n        if (Flow.isTerminal(session.status)) {\n          this.handoffActive = false\n          return this.showResult(session.status)\n        }\n      } catch (error) {\n        // The session/token can expire mid-wait (401) — stop and reflect that.\n        if (error instanceof WidgetApiError && error.status === 401) {\n          this.handoffActive = false\n          return this.showResult('expired')\n        }\n        if (++errors >= 5) return\n      }\n    }\n  }\n\n  /**\n   * Await a terminal status over the push transport. Resolves to the terminal\n   * status, or null if `active()` went false or the tick budget elapsed (push can\n   * miss events / disconnect; the budget bounds the wait). An initial fetch\n   * catches a session that finished before we subscribed.\n   */\n  private pushWatch(\n    rt: WidgetRealtimeClient,\n    budget: number,\n    active: () => boolean,\n  ): Promise<VerificationStatus | null> {\n    return new Promise((resolve) => {\n      let done = false\n      const finish = (status: VerificationStatus | null) => {\n        if (done) return\n        done = true\n        this.stopWatch = undefined\n        unsubscribe()\n        resolve(status)\n      }\n      const channel = this.realtimeConfig!.channel\n      const unsubscribe = rt.subscribe(channel, (event, data) => {\n        if (event !== REALTIME_EVENT.sessionTransition) return\n        const status = (data as SessionTransitionEvent).status\n        this.observe(status)\n        if (Flow.isTerminal(status)) finish(status)\n      })\n      this.stopWatch = () => finish(null)\n      // Catch a race where the session already finished before we subscribed.\n      void this.client\n        .getSession()\n        .then((session) => {\n          this.observe(session.status)\n          if (Flow.isTerminal(session.status)) finish(session.status)\n        })\n        .catch((error) => {\n          if (error instanceof WidgetApiError && error.status === 401) finish('expired')\n        })\n      // Bound the wait by the same tick budget the poller would use.\n      const countdown = async (n: number): Promise<void> => {\n        if (done) return\n        if (!active() || n >= budget) return finish(null)\n        await this.delay(this.pollMs)\n        void countdown(n + 1)\n      }\n      void countdown(0)\n    })\n  }\n\n  /** Resolve which liveness flow to run from the session's capture model. */\n  private resolveLiveness(session: ClientSession): void {\n    this.livenessChallenges = session.liveness_challenges ?? []\n    const model = session.capture_model ?? 'passive'\n    this.captureModel = model\n    const wantsActive = model === 'active' || model === 'both'\n    // `active` is honoured even without a live camera — the active-liveness\n    // screen then shows the device as unsupported (no fallback). `both` falls\n    // back to passive when the camera/recorder isn't available.\n    this.livenessMode = wantsActive && (model === 'active' || this.view.cameraSupported) ? 'active' : 'passive'\n  }\n\n  private async onImage(blob: Blob | null): Promise<void> {\n    const signals = this.config.signals\n    switch (this.step) {\n      case 'front_capture':\n        await this.client.submitDocumentFront({\n          image: blob,\n          country: this.country,\n          documentType: this.documentType,\n          signals,\n        })\n        return this.enter(this.next())\n      case 'back_capture':\n        await this.client.submitDocumentBack({\n          image: blob,\n          country: this.country,\n          documentType: this.documentType,\n        })\n        return this.enter('ocr_processing')\n      case 'selfie_capture':\n        this.selfie = blob\n        return this.enter('passive_liveness')\n    }\n  }\n\n  /** Enter a step: render it, and drive any automatic (processing) work. */\n  private async enter(step: WidgetStep): Promise<void> {\n    if (this.settled) return\n    this.step = step\n\n    // Lead each capture/liveness step with an instruction screen so the user\n    // knows what's next and starts it deliberately. The Continue button re-enters\n    // the same step with the instruction acknowledged.\n    const instruction = STEP_INSTRUCTIONS[step]\n    if (instruction && !this.instructionAcked) {\n      this.view.renderInstruction(step, instruction.title, instruction.body, instruction.cta ?? 'Continue', () => {\n        this.instructionAcked = true\n        void this.run(() => this.enter(step))\n      })\n      return\n    }\n    this.instructionAcked = false\n    this.render()\n\n    switch (step) {\n      case 'ocr_processing':\n        await this.delay(this.transientMs)\n        return this.enter(this.next())\n      case 'passive_liveness':\n        await this.client.submitLiveness({ selfie: this.selfie, signals: this.config.signals })\n        return this.enter(this.next())\n      case 'face_match':\n        await this.client.complete({ signals: this.config.signals })\n        return this.enter(this.next())\n      case 'processing':\n        return this.poll()\n    }\n  }\n\n  /** Watch the session until it reaches a terminal status (then show the result). */\n  private async poll(): Promise<void> {\n    const rt = await this.resolveRealtime()\n    if (rt) {\n      const status = await this.pushWatch(rt, this.maxPolls, () => !this.settled)\n\n      return this.showResult(status ?? 'requires_review')\n    }\n\n    for (let i = 0; i < this.maxPolls && !this.settled; i++) {\n      const session = await this.client.getSession()\n      this.observe(session.status)\n      if (Flow.isTerminal(session.status)) return this.showResult(session.status)\n      await this.delay(this.pollMs)\n    }\n    // Still processing after the poll budget — surface as pending review.\n    this.showResult('requires_review')\n  }\n\n  private showResult(status: VerificationStatus): void {\n    this.result = { status, decision: Flow.statusToDecision(status) }\n    this.step = 'result'\n    this.render()\n  }\n\n  /** A session that was already terminal on load: a notice with only a Close button. */\n  private showTerminal(status: VerificationStatus): void {\n    this.result = { status, decision: Flow.statusToDecision(status) }\n    this.step = 'result'\n    this.terminalOnLoad = true\n    this.render()\n  }\n\n  private render(): void {\n    this.view.render({\n      step: this.step,\n      documentType: this.documentType,\n      decision: this.result?.decision,\n      status: this.result?.status,\n      terminalNotice: this.terminalOnLoad,\n      allowSkip: !!this.config.signals,\n      livenessChallenges: this.livenessChallenges,\n      requireLiveCamera: this.captureModel === 'active',\n      // The active flow is strict end-to-end: documents must be detected, not\n      // manually waved through.\n      strictCapture: this.livenessMode === 'active',\n      handoffAvailable: this.handoffReady,\n    })\n  }\n\n  private next(): WidgetStep {\n    return Flow.nextStep(this.step, {\n      documentType: this.documentType,\n      livenessMode: this.livenessMode,\n      workflow: this.workflow,\n    })\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => this.scheduler(resolve, ms))\n  }\n\n  /** Run an async step, routing any failure to the error screen. */\n  private async run(fn: () => Promise<void> | void): Promise<void> {\n    try {\n      await fn()\n    } catch (error) {\n      this.fail(error)\n    }\n  }\n\n  private fail(error: unknown): void {\n    if (this.settled) return\n    const err = error instanceof Error ? error : new Error(String(error))\n    this.step = 'result'\n\n    this.view.render({\n      step: 'result',\n      documentType: this.documentType,\n      errorMessage: err.message,\n    })\n\n    this.pendingError = err\n  }\n\n  private finishResult(): void {\n    if (this.settled) return\n    this.settled = true\n    this.teardownRealtime()\n\n    if (this.pendingError) {\n      this.post('arkyc:error', { error: serializeError(this.pendingError) })\n      this.dispatch('error', { message: this.pendingError.message })\n      this.config.onError?.(this.pendingError)\n    } else if (this.result) {\n      this.post('arkyc:complete', { payload: this.result })\n      this.dispatch('complete', this.result)\n      this.config.onComplete?.(this.result)\n    }\n\n    this.destroy()\n    this.config.onSettle?.()\n  }\n\n  private finishClose(): void {\n    if (this.settled) return\n\n    this.settled = true\n    this.teardownRealtime()\n    this.post('arkyc:close', {})\n    this.dispatch('close')\n    this.config.onClose?.()\n    this.destroy()\n    this.config.onSettle?.()\n  }\n\n  /** Stop any active session watch + disconnect the push transport. */\n  private teardownRealtime(): void {\n    this.stopWatch?.()\n    this.rtClient?.disconnect()\n    this.rtClient = null\n  }\n\n  private post(type: string, extra: Record<string, unknown>): void {\n    if (!this.postToParent) return\n    try {\n      this.win.parent?.postMessage({ type, ...extra }, '*')\n    } catch {\n      // Cross-origin parent without access — nothing more we can do.\n    }\n  }\n}\n\nfunction serializeError(error: Error): { message: string; name: string } {\n  return { message: error.message, name: error.name }\n}\n\nexport const resolveContainer = (container: string | HTMLElement, doc: Document): HTMLElement => {\n  const el = typeof container === 'string' ? doc.querySelector<HTMLElement>(container) : container\n  if (!el) throw new Error(`ArkycWidget.mount: container \"${String(container)}\" not found.`)\n  return el\n}\n\nexport const buildController = (options: BaseWidgetOptions, onSettle: () => void): WidgetController => {\n  if (!options.token) throw new Error('ArkycWidget requires a client `token`.')\n  return new WidgetController({\n    token: options.token,\n    baseUrl: options.baseUrl,\n    handoff: options.handoff,\n    handoffUrl: options.handoffUrl,\n    branding: options.branding,\n    signals: options.signals,\n    onComplete: options.onComplete,\n    onError: options.onError,\n    onClose: options.onClose,\n    onEvent: options.onEvent,\n    onSettle,\n    fetch: options.fetch,\n    doc: options.doc,\n    win: options.win,\n    nav: options.nav,\n    faceAnalyzer: options.faceAnalyzer,\n    faceTuning: options.faceTuning,\n    documentAnalyzer: options.documentAnalyzer,\n    documentTuning: options.documentTuning,\n  })\n}\n"],"mappings":";;;;;;;;;;AAqBA,MAAM,oBAAgG;CACpG,eAAe;EACb,OAAO;EACP,MAAM;CACR;CACA,cAAc;EACZ,OAAO;EACP,MAAM;CACR;CACA,gBAAgB;EACd,OAAO;EACP,MAAM;CACR;CACA,iBAAiB;EACf,OAAO;EACP,MAAM;CACR;AACF;;;;;;;;;;;;;;;;AAiBA,SAAS,mBAA2D,UAAa,SAAgC;CAC/G,MAAM,OAAO,SAAS;CACtB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,gBAAgB,KAAK,OAAO,GAAG,OAAO;CAChE,IAAI;EACF,MAAM,OAAO,IAAI,IAAI,OAAO;EAC5B,MAAM,WAAW,IAAI,IAAI,MAAM,IAAI;EACnC,IAAI,SAAS,WAAW,KAAK,QAAQ,OAAO;EAC5C,OAAO;GAAE,GAAG;GAAU,UAAU,GAAG,KAAK,SAAS,SAAS,WAAW,SAAS,SAAS,SAAS;EAAO;CACzG,QAAQ;EACN,OAAO;CACT;AACF;AAEA,IAAa,mBAAb,MAA8B;CA+CC;CA9C7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;CAGA,gBAAuC;EAAE,SAAS;EAAO,eAAe;EAAM,KAAK;CAAG;CACtF,eAAuB;CACvB,gBAAwB;;CAGxB,YAAoB;CACpB,iBAAgD;CAChD,WAAgD;CAChD,aAAqB;;CAErB,aAAgD;;CAEhD,4BAAoB,IAAI,IAAsC;;CAE9D;CAEA,OAA2B;CAC3B,eAA4C;CAC5C,UAAiC;CACjC,SAA8B;CAC9B,eAAqC;;CAErC,eAAsD;CACtD,qBAAkD,CAAC;;CAEnD,WAA0C;CAC1C,SAAsC;;CAEtC,iBAAyB;;CAEzB,mBAA2B;CAC3B,eAAqC;CACrC,UAAkB;CAElB,YAAY,QAAiD;EAAhC,KAAA,SAAA;EAC3B,MAAM,MAAM,OAAO,OAAO,WAAW;EACrC,MAAM,MAAM,OAAO,OAAO,WAAW;EACrC,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,IAAI,MAAM,qDAAqD;EACvF,KAAK,MAAM;EACX,KAAK,MAAM,OAAO,OAAO,WAAW;EAEpC,KAAK,SAAS,IAAI,YAAY;GAC5B,OAAO,OAAO;GACd,SAAS,OAAO;GAChB,OAAO,OAAO;EAChB,CAAC;EACD,MAAM,QAAQ,IAAI,MAAM,OAAO,QAAQ;EACvC,KAAK,OAAO,IAAI,WACd,KACA,OACA,KAAK,SAAS,GACd,OAAO,OAAO,WAAW,WACzB,OAAO,cACP,OAAO,YACP,OAAO,kBACP,OAAO,cACT;EAEA,KAAK,eAAe,OAAO,iBAAiB,CAAC,CAAC,IAAI,UAAU,IAAI,WAAW;EAC3E,KAAK,YAAY,OAAO,eAAe,IAAI,OAAO,WAAW,IAAI,EAAE;EACnE,KAAK,cAAc,OAAO,eAAe;EACzC,KAAK,SAAS,OAAO,UAAU;EAC/B,KAAK,WAAW,OAAO,YAAY;EAEnC,KAAK,kBAAkB,OAAO,mBAAmB;CACnD;;CAGA,IAAI,UAAuB;EACzB,OAAO,KAAK,KAAK;CACnB;;CAGA,QAAc;EACZ,KAAK,KAAK,cAAc;EACxB,KAAU,UAAU,KAAK,UAAU,CAAC;CACtC;;CAGA,UAAgB;EACd,KAAK,KAAK,QAAQ;CACpB;;CAGA,QAAc;EACZ,KAAK,YAAY;CACnB;;;;;CAMA,GAAG,OAAe,UAA2C;EAC3D,MAAM,MAAM,KAAK,UAAU,IAAI,KAAK,qBAAK,IAAI,IAAyB;EACtE,IAAI,IAAI,QAAQ;EAChB,KAAK,UAAU,IAAI,OAAO,GAAG;EAE7B,aAAa,IAAI,OAAO,QAAQ;CAClC;;CAGA,YAAoB,MAAuB;EACzC,IAAI,KAAK,OAAO,SAAS,OAAO;EAChC,MAAM,MAAM,KAAK,UAAU,IAAI,IAAI;EAEnC,OAAO,CAAC,CAAC,OAAO,IAAI,OAAO;CAC7B;;;;;;CAOA,SAAiB,MAAc,MAAsB;EACnD,KAAK,KAAK,MAAM,IAAI;EAGpB,KAAK,KAAK,eAAe;GAAE;GAAM;EAAK,CAAC;CACzC;;CAGA,KAAa,MAAc,MAAsB;EAC/C,IAAI,CAAC,KAAK,YAAY,IAAI,GAAG;EAC7B,IAAI;GACF,KAAK,OAAO,UAAU;IAAE;IAAM;GAAK,CAAC;EACtC,QAAQ,CAER;EACA,MAAM,MAAM,KAAK,UAAU,IAAI,IAAI;EACnC,IAAI,KACF,KAAK,MAAM,YAAY,CAAC,GAAG,GAAG,GAC5B,IAAI;GACF,SAAS,IAAI;EACf,QAAQ,CAER;CAGN;;CAGA,QAAgB,QAAkC;EAChD,IAAI,WAAW,KAAK,YAAY;EAChC,MAAM,WAAW,KAAK;EACtB,KAAK,aAAa;EAClB,KAAK,SAAS,eAAe,mBAAmB;GAC9C,YAAY,KAAK;GACjB;GACA,iBAAiB;EACnB,CAA2C;CAC7C;;;;;;CAOA,MAAc,kBAAwD;EACpE,IAAI,KAAK,YAAY,OAAO,KAAK;EACjC,KAAK,aAAa;EAClB,MAAM,MAAM,KAAK;EACjB,IAAI,CAAC,OAAO,IAAI,cAAc,aAAa,IAAI,cAAc,SAAS,IAAI,cAAc,UAAU,OAAO;EAEzG,MAAM,UAAU,KAAK,OAAO,mBAAmB;EAC/C,MAAM,WAAW,KAAK,OAAO,WAAW,GAAA,CAAI,QAAQ,OAAO,EAAE;EAC7D,IAAI;GACF,KAAK,WAAW,MAAM,QAAQ,KAAK;IACjC,cAAc,GAAG,QAAQ;IACzB,OAAO,KAAK,OAAO;GACrB,CAAC;EACH,QAAQ;GACN,KAAK,WAAW;EAClB;EAEA,OAAO,KAAK;CACd;CAEA,WAAiC;EAC/B,OAAO;GACL,eAAe,KAAK,YAAY;GAEhC,eAAe,KAAK,KAAK,UAAU,KAAK,MAAM,KAAK,KAAK,CAAC,CAAC;GAC1D,qBAAqB,MAAM,YAAY;IACrC,KAAK,eAAe;IACpB,KAAK,UAAU,WAAW;IAC1B,KAAU,UAAU,KAAK,MAAM,eAAe,CAAC;GACjD;GACA,UAAU,SAAS,KAAK,KAAK,UAAU,KAAK,QAAQ,IAAI,CAAC;GACzD,mBAAmB,OAAO,WAAW,WACnC,KAAK,KAAK,IAAI,YAAY;IACxB,MAAM,KAAK,OAAO,eAAe;KAC/B;KACA;KACA,MAAM;KACN,YAAY;KACZ,SAAS,KAAK,OAAO;IACvB,CAAC;IACD,MAAM,KAAK,MAAM,KAAK,KAAK,CAAC;GAC9B,CAAC;GACH,qBAAqB,KAAK,aAAa;GACvC,kBAAkB,KAAK,KAAK,UAAU,KAAK,aAAa,CAAC;GACzD,sBAAsB;IACpB,KAAK,gBAAgB;IACrB,KAAK,YAAY;IACjB,KAAK,OAAO;IACZ,KAAK,OAAO;GACd;EACF;CACF;;;;;;CAOA,MAAc,YAA2B;EACvC,IAAI,KAAK,SAAS;EAClB,MAAM,UAAU,MAAM,KAAK,OAAO,WAAW;EAC7C,IAAI,KAAK,SAAS;EAClB,KAAK,YAAY,QAAQ;EACzB,KAAK,iBAAiB,QAAQ,YAAY;EAC1C,KAAK,WAAW,QAAQ,YAAY;EAGpC,IAAI,KAAK,OAAO,YAAY,QAAQ,QAAQ,UAC1C,KAAK,KAAK,cAAc,mBAAmB,QAAQ,UAAU,KAAK,OAAO,OAAO,CAAC;EACnF,KAAK,QAAQ,QAAQ,MAAM;EAC3B,IAAI,KAAK,WAAW,QAAQ,MAAM,GAAG,OAAO,KAAK,aAAa,QAAQ,MAAM;EAC5E,KAAK,gBAAgB,OAAO;EAC5B,IAAI,QAAQ,SAAS,KAAK,gBAAgB,QAAQ;EAGlD,IADE,KAAK,OAAO,YAAY,SAAS,gBAAgB,KAAK,GAAG,KAAK,KAAK,cAAc,WAAW,CAAC,CAAC,KAAK,cAAc,GACnG;GACd,KAAK,eAAe;GACpB,MAAM,KAAK,aAAa;EAC1B,OAAO;GACL,KAAK,OAAO;GACZ,KAAK,OAAO;EACd;CACF;;CAGA,gBAAgC;EAC9B,QAAQ,KAAK,OAAO,cAAc,KAAK,cAAc,OAAO,GAAA,CAAI,KAAK;CACvE;;CAGA,MAAc,eAA8B;EAC1C,MAAM,SAAS,KAAK,cAAc;EAClC,IAAI,CAAC,QAAQ;EACb,KAAK,gBAAgB;EAErB,KAAK,KAAK,cAAc,YAAY,KAAK,gBAAgB,MAAM,CAAC,GAAG,KAAK,cAAc,aAAa;EACnG,MAAM,KAAK,YAAY;CACzB;;CAGA,gBAAwB,QAAwB;EAE9C,IAAI,MAAM,GAAG,SADD,OAAO,SAAS,GAAG,IAAI,MAAM,IACf,QAAQ,mBAAmB,KAAK,OAAO,KAAK;EAGtE,MAAM,WAAW,KAAK,OAAO,WAAW,GAAA,CAAI,KAAK;EACjD,IAAI,gBAAgB,KAAK,OAAO,GAAG,OAAO,YAAY,mBAAmB,OAAO;EAChF,OAAO;CACT;;CAGA,MAAc,cAA6B;EACzC,MAAM,KAAK,MAAM,KAAK,gBAAgB;EACtC,IAAI,IAAI;GACN,MAAM,SAAS,MAAM,KAAK,UAAU,IAAI,KAAK,uBAAuB,KAAK,iBAAiB,CAAC,KAAK,OAAO;GACvG,IAAI,QAAQ;IACV,KAAK,gBAAgB;IACrB,OAAO,KAAK,WAAW,MAAM;GAC/B;GAEA;EACF;EAEA,IAAI,SAAS;EACb,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,mBAAmB,KAAK,iBAAiB,CAAC,KAAK,SAAS,KAAK;GACpF,MAAM,KAAK,MAAM,KAAK,MAAM;GAC5B,IAAI,CAAC,KAAK,iBAAiB,KAAK,SAAS;GACzC,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,OAAO,WAAW;IAC7C,SAAS;IACT,KAAK,QAAQ,QAAQ,MAAM;IAC3B,IAAI,KAAK,WAAW,QAAQ,MAAM,GAAG;KACnC,KAAK,gBAAgB;KACrB,OAAO,KAAK,WAAW,QAAQ,MAAM;IACvC;GACF,SAAS,OAAO;IAEd,IAAI,iBAAiB,kBAAkB,MAAM,WAAW,KAAK;KAC3D,KAAK,gBAAgB;KACrB,OAAO,KAAK,WAAW,SAAS;IAClC;IACA,IAAI,EAAE,UAAU,GAAG;GACrB;EACF;CACF;;;;;;;CAQA,UACE,IACA,QACA,QACoC;EACpC,OAAO,IAAI,SAAS,YAAY;GAC9B,IAAI,OAAO;GACX,MAAM,UAAU,WAAsC;IACpD,IAAI,MAAM;IACV,OAAO;IACP,KAAK,YAAY,KAAA;IACjB,YAAY;IACZ,QAAQ,MAAM;GAChB;GACA,MAAM,UAAU,KAAK,eAAgB;GACrC,MAAM,cAAc,GAAG,UAAU,UAAU,OAAO,SAAS;IACzD,IAAI,UAAU,eAAe,mBAAmB;IAChD,MAAM,SAAU,KAAgC;IAChD,KAAK,QAAQ,MAAM;IACnB,IAAI,KAAK,WAAW,MAAM,GAAG,OAAO,MAAM;GAC5C,CAAC;GACD,KAAK,kBAAkB,OAAO,IAAI;GAElC,KAAU,OACP,WAAW,CAAC,CACZ,MAAM,YAAY;IACjB,KAAK,QAAQ,QAAQ,MAAM;IAC3B,IAAI,KAAK,WAAW,QAAQ,MAAM,GAAG,OAAO,QAAQ,MAAM;GAC5D,CAAC,CAAC,CACD,OAAO,UAAU;IAChB,IAAI,iBAAiB,kBAAkB,MAAM,WAAW,KAAK,OAAO,SAAS;GAC/E,CAAC;GAEH,MAAM,YAAY,OAAO,MAA6B;IACpD,IAAI,MAAM;IACV,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,OAAO,OAAO,IAAI;IAChD,MAAM,KAAK,MAAM,KAAK,MAAM;IAC5B,UAAe,IAAI,CAAC;GACtB;GACA,UAAe,CAAC;EAClB,CAAC;CACH;;CAGA,gBAAwB,SAA8B;EACpD,KAAK,qBAAqB,QAAQ,uBAAuB,CAAC;EAC1D,MAAM,QAAQ,QAAQ,iBAAiB;EACvC,KAAK,eAAe;EACpB,MAAM,cAAc,UAAU,YAAY,UAAU;EAIpD,KAAK,eAAe,gBAAgB,UAAU,YAAY,KAAK,KAAK,mBAAmB,WAAW;CACpG;CAEA,MAAc,QAAQ,MAAkC;EACtD,MAAM,UAAU,KAAK,OAAO;EAC5B,QAAQ,KAAK,MAAb;GACE,KAAK;IACH,MAAM,KAAK,OAAO,oBAAoB;KACpC,OAAO;KACP,SAAS,KAAK;KACd,cAAc,KAAK;KACnB;IACF,CAAC;IACD,OAAO,KAAK,MAAM,KAAK,KAAK,CAAC;GAC/B,KAAK;IACH,MAAM,KAAK,OAAO,mBAAmB;KACnC,OAAO;KACP,SAAS,KAAK;KACd,cAAc,KAAK;IACrB,CAAC;IACD,OAAO,KAAK,MAAM,gBAAgB;GACpC,KAAK;IACH,KAAK,SAAS;IACd,OAAO,KAAK,MAAM,kBAAkB;EACxC;CACF;;CAGA,MAAc,MAAM,MAAiC;EACnD,IAAI,KAAK,SAAS;EAClB,KAAK,OAAO;EAKZ,MAAM,cAAc,kBAAkB;EACtC,IAAI,eAAe,CAAC,KAAK,kBAAkB;GACzC,KAAK,KAAK,kBAAkB,MAAM,YAAY,OAAO,YAAY,MAAM,YAAY,OAAO,kBAAkB;IAC1G,KAAK,mBAAmB;IACxB,KAAU,UAAU,KAAK,MAAM,IAAI,CAAC;GACtC,CAAC;GACD;EACF;EACA,KAAK,mBAAmB;EACxB,KAAK,OAAO;EAEZ,QAAQ,MAAR;GACE,KAAK;IACH,MAAM,KAAK,MAAM,KAAK,WAAW;IACjC,OAAO,KAAK,MAAM,KAAK,KAAK,CAAC;GAC/B,KAAK;IACH,MAAM,KAAK,OAAO,eAAe;KAAE,QAAQ,KAAK;KAAQ,SAAS,KAAK,OAAO;IAAQ,CAAC;IACtF,OAAO,KAAK,MAAM,KAAK,KAAK,CAAC;GAC/B,KAAK;IACH,MAAM,KAAK,OAAO,SAAS,EAAE,SAAS,KAAK,OAAO,QAAQ,CAAC;IAC3D,OAAO,KAAK,MAAM,KAAK,KAAK,CAAC;GAC/B,KAAK,cACH,OAAO,KAAK,KAAK;EACrB;CACF;;CAGA,MAAc,OAAsB;EAClC,MAAM,KAAK,MAAM,KAAK,gBAAgB;EACtC,IAAI,IAAI;GACN,MAAM,SAAS,MAAM,KAAK,UAAU,IAAI,KAAK,gBAAgB,CAAC,KAAK,OAAO;GAE1E,OAAO,KAAK,WAAW,UAAU,iBAAiB;EACpD;EAEA,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,YAAY,CAAC,KAAK,SAAS,KAAK;GACvD,MAAM,UAAU,MAAM,KAAK,OAAO,WAAW;GAC7C,KAAK,QAAQ,QAAQ,MAAM;GAC3B,IAAI,KAAK,WAAW,QAAQ,MAAM,GAAG,OAAO,KAAK,WAAW,QAAQ,MAAM;GAC1E,MAAM,KAAK,MAAM,KAAK,MAAM;EAC9B;EAEA,KAAK,WAAW,iBAAiB;CACnC;CAEA,WAAmB,QAAkC;EACnD,KAAK,SAAS;GAAE;GAAQ,UAAU,KAAK,iBAAiB,MAAM;EAAE;EAChE,KAAK,OAAO;EACZ,KAAK,OAAO;CACd;;CAGA,aAAqB,QAAkC;EACrD,KAAK,SAAS;GAAE;GAAQ,UAAU,KAAK,iBAAiB,MAAM;EAAE;EAChE,KAAK,OAAO;EACZ,KAAK,iBAAiB;EACtB,KAAK,OAAO;CACd;CAEA,SAAuB;EACrB,KAAK,KAAK,OAAO;GACf,MAAM,KAAK;GACX,cAAc,KAAK;GACnB,UAAU,KAAK,QAAQ;GACvB,QAAQ,KAAK,QAAQ;GACrB,gBAAgB,KAAK;GACrB,WAAW,CAAC,CAAC,KAAK,OAAO;GACzB,oBAAoB,KAAK;GACzB,mBAAmB,KAAK,iBAAiB;GAGzC,eAAe,KAAK,iBAAiB;GACrC,kBAAkB,KAAK;EACzB,CAAC;CACH;CAEA,OAA2B;EACzB,OAAO,KAAK,SAAS,KAAK,MAAM;GAC9B,cAAc,KAAK;GACnB,cAAc,KAAK;GACnB,UAAU,KAAK;EACjB,CAAC;CACH;CAEA,MAAc,IAA2B;EACvC,OAAO,IAAI,SAAS,YAAY,KAAK,UAAU,SAAS,EAAE,CAAC;CAC7D;;CAGA,MAAc,IAAI,IAA+C;EAC/D,IAAI;GACF,MAAM,GAAG;EACX,SAAS,OAAO;GACd,KAAK,KAAK,KAAK;EACjB;CACF;CAEA,KAAa,OAAsB;EACjC,IAAI,KAAK,SAAS;EAClB,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;EACpE,KAAK,OAAO;EAEZ,KAAK,KAAK,OAAO;GACf,MAAM;GACN,cAAc,KAAK;GACnB,cAAc,IAAI;EACpB,CAAC;EAED,KAAK,eAAe;CACtB;CAEA,eAA6B;EAC3B,IAAI,KAAK,SAAS;EAClB,KAAK,UAAU;EACf,KAAK,iBAAiB;EAEtB,IAAI,KAAK,cAAc;GACrB,KAAK,KAAK,eAAe,EAAE,OAAO,eAAe,KAAK,YAAY,EAAE,CAAC;GACrE,KAAK,SAAS,SAAS,EAAE,SAAS,KAAK,aAAa,QAAQ,CAAC;GAC7D,KAAK,OAAO,UAAU,KAAK,YAAY;EACzC,OAAO,IAAI,KAAK,QAAQ;GACtB,KAAK,KAAK,kBAAkB,EAAE,SAAS,KAAK,OAAO,CAAC;GACpD,KAAK,SAAS,YAAY,KAAK,MAAM;GACrC,KAAK,OAAO,aAAa,KAAK,MAAM;EACtC;EAEA,KAAK,QAAQ;EACb,KAAK,OAAO,WAAW;CACzB;CAEA,cAA4B;EAC1B,IAAI,KAAK,SAAS;EAElB,KAAK,UAAU;EACf,KAAK,iBAAiB;EACtB,KAAK,KAAK,eAAe,CAAC,CAAC;EAC3B,KAAK,SAAS,OAAO;EACrB,KAAK,OAAO,UAAU;EACtB,KAAK,QAAQ;EACb,KAAK,OAAO,WAAW;CACzB;;CAGA,mBAAiC;EAC/B,KAAK,YAAY;EACjB,KAAK,UAAU,WAAW;EAC1B,KAAK,WAAW;CAClB;CAEA,KAAa,MAAc,OAAsC;EAC/D,IAAI,CAAC,KAAK,cAAc;EACxB,IAAI;GACF,KAAK,IAAI,QAAQ,YAAY;IAAE;IAAM,GAAG;GAAM,GAAG,GAAG;EACtD,QAAQ,CAER;CACF;AACF;AAEA,SAAS,eAAe,OAAiD;CACvE,OAAO;EAAE,SAAS,MAAM;EAAS,MAAM,MAAM;CAAK;AACpD;AAEA,MAAa,oBAAoB,WAAiC,QAA+B;CAC/F,MAAM,KAAK,OAAO,cAAc,WAAW,IAAI,cAA2B,SAAS,IAAI;CACvF,IAAI,CAAC,IAAI,MAAM,IAAI,MAAM,iCAAiC,OAAO,SAAS,EAAE,aAAa;CACzF,OAAO;AACT;AAEA,MAAa,mBAAmB,SAA4B,aAA2C;CACrG,IAAI,CAAC,QAAQ,OAAO,MAAM,IAAI,MAAM,wCAAwC;CAC5E,OAAO,IAAI,iBAAiB;EAC1B,OAAO,QAAQ;EACf,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,YAAY,QAAQ;EACpB,UAAU,QAAQ;EAClB,SAAS,QAAQ;EACjB,YAAY,QAAQ;EACpB,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB,SAAS,QAAQ;EACjB;EACA,OAAO,QAAQ;EACf,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,cAAc,QAAQ;EACtB,YAAY,QAAQ;EACpB,kBAAkB,QAAQ;EAC1B,gBAAgB,QAAQ;CAC1B,CAAC;AACH"}
+{"version":3,"file":"controller.mjs","names":[],"sources":["../src/controller.ts"],"sourcesContent":["import type {\n  DocumentType,\n  LivenessChallenge,\n  LivenessMode,\n  SessionTransitionEvent,\n  VerificationStatus,\n  WidgetResult,\n  WidgetStep,\n  WorkflowConfig,\n} from '@arkyc/types'\nimport { REALTIME_EVENT, workflowAddressConfig } from '@arkyc/types'\nimport { ArkycClient, type ClientHandoff, type ClientRealtime, type ClientSession, WidgetApiError } from './client'\nimport { Flow } from './flow'\nimport { Theme } from './theme'\nimport { WidgetView, type AddressFormData } from './ui'\nimport { isDesktopDevice } from './device'\nimport { renderQrSvg } from './qr'\nimport { createWidgetRealtimeClient, type WidgetRealtimeClient } from './realtime'\nimport type { BaseWidgetOptions, ViewHandlers, WidgetControllerConfig, WidgetEventListener } from './types'\n\n/** Per-step lead-in copy shown before each capture/liveness step. */\nconst STEP_INSTRUCTIONS: Partial<Record<WidgetStep, { title: string; body: string; cta?: string }>> = {\n  front_capture: {\n    title: 'Front of your document',\n    body: 'Place the front of your ID flat and fully inside the frame. We’ll capture it automatically.',\n  },\n  back_capture: {\n    title: 'Back of your document',\n    body: 'Now turn your ID over and show the back, fully inside the frame.',\n  },\n  selfie_capture: {\n    title: 'Take a selfie',\n    body: 'Look straight at the camera in good light and hold still — we’ll capture it automatically.',\n  },\n  active_liveness: {\n    title: 'Quick liveness check',\n    body: 'Follow the on-screen prompts (such as turn your head, blink or smile). This confirms you’re really here.',\n  },\n}\n\n/**\n * Drives the full verification flow: renders each screen via {@link WidgetView},\n * advances through {@link flow}, and calls the Client API at each step. Cosmetic\n * processing screens auto-advance; capture screens wait for an image. On a\n * terminal result it surfaces the outcome and (in hosted mode) posts\n * `arkyc:complete` / `arkyc:error` / `arkyc:close` to the parent window.\n */\n/**\n * Re-base the server-resolved project logo onto the API origin the widget is\n * actually talking to. The stored `logo_url` carries the API's own host, which a\n * handed-off phone cannot reach — it reaches the API through the absolute\n * `baseUrl` passed in the handoff link. Rewriting the origin (keeping the path)\n * makes the logo load on whatever device runs the widget. Only applied when\n * `baseUrl` is absolute; the integrator's own branding is never re-based.\n */\nfunction rebaseBrandingLogo<T extends { logo_url?: string | null }>(branding: T, baseUrl: string | undefined): T {\n  const logo = branding.logo_url\n  if (!logo || !baseUrl || !/^https?:\\/\\//i.test(baseUrl)) return branding\n  try {\n    const base = new URL(baseUrl)\n    const resolved = new URL(logo, base)\n    if (resolved.origin === base.origin) return branding\n    return { ...branding, logo_url: `${base.origin}${resolved.pathname}${resolved.search}${resolved.hash}` }\n  } catch {\n    return branding\n  }\n}\n\nexport class WidgetController {\n  private readonly client: ArkycClient\n  private readonly view: WidgetView\n  private readonly win: Window\n  private readonly nav: Navigator\n  private readonly postToParent: boolean\n  private readonly scheduler: (fn: () => void, ms: number) => void\n  private readonly transientMs: number\n  private readonly pollMs: number\n  private readonly maxPolls: number\n  private readonly maxHandoffPolls: number\n\n  /** Cross-device handoff: project config + whether the offer/QR is showing. */\n  private handoffConfig: ClientHandoff = { enabled: false, allow_desktop: true, url: '' }\n  private handoffReady = false\n  private handoffActive = false\n\n  /** This session's id + how to watch it live (push transport vs. polling). */\n  private sessionId = ''\n  private realtimeConfig: ClientRealtime | null = null\n  private rtClient: WidgetRealtimeClient | null = null\n  private rtResolved = false\n  /** The last status observed, so a transition only emits once per change. */\n  private lastStatus: VerificationStatus | null = null\n  /** Per-name event listeners registered via {@link on}. */\n  private listeners = new Map<string, Set<WidgetEventListener>>()\n  /** Cancels the active session watch (e.g. continue-on-this-device). */\n  private stopWatch: (() => void) | undefined\n\n  private step: WidgetStep = 'welcome'\n  private documentType: DocumentType | null = null\n  private country: string | null = null\n  private selfie: Blob | null = null\n  private livenessMode: LivenessMode = 'passive'\n  /** The session's capture model; `active` mandates a live camera (no fallback). */\n  private captureModel: 'passive' | 'active' | 'both' = 'passive'\n  private livenessChallenges: LivenessChallenge[] = []\n  /** The address-entry form data, captured before the address submission. */\n  private addressData: AddressFormData | null = null\n  /** Device coordinates resolved on the address step (when the user opts in). */\n  private addressCoords: { latitude: number; longitude: number } | null = null\n  /** The applied workflow (orders/toggles stages, skip_ocr), or null for the default flow. */\n  private workflow: WorkflowConfig | null = null\n  private result: WidgetResult | null = null\n  /** The session was already terminal when the widget loaded (show a close-only notice). */\n  private terminalOnLoad = false\n  /** Whether the current step's instruction interstitial has been acknowledged. */\n  private instructionAcked = false\n  private pendingError: Error | null = null\n  private settled = false\n\n  constructor(private readonly config: WidgetControllerConfig) {\n    const doc = config.doc ?? globalThis.document\n    const win = config.win ?? globalThis.window\n    if (!doc || !win) throw new Error('The Arkyc widget must run in a browser environment.')\n    this.win = win\n    this.nav = config.nav ?? globalThis.navigator\n\n    this.client = new ArkycClient({\n      token: config.token,\n      baseUrl: config.baseUrl,\n      fetch: config.fetch,\n    })\n    const theme = new Theme(config.branding)\n    this.view = new WidgetView(\n      doc,\n      theme,\n      this.handlers(),\n      config.nav ?? globalThis.navigator,\n      config.faceAnalyzer,\n      config.faceTuning,\n      config.documentAnalyzer,\n      config.documentTuning,\n    )\n\n    this.postToParent = config.postToParent ?? (!!win.parent && win.parent !== win)\n    this.scheduler = config.scheduler ?? ((fn, ms) => setTimeout(fn, ms))\n    this.transientMs = config.transientMs ?? 700\n    this.pollMs = config.pollMs ?? 1500\n    this.maxPolls = config.maxPolls ?? 40\n    // A handed-off session is bounded by its TTL (~15 min); poll generously.\n    this.maxHandoffPolls = config.maxHandoffPolls ?? 600\n  }\n\n  /** The widget's root element — append it to an overlay or inline container. */\n  get element(): HTMLElement {\n    return this.view.element\n  }\n\n  /** Connect to the session, then route to the result, the QR, or the welcome flow. */\n  start(): void {\n    this.view.renderLoading()\n    void this.run(() => this.bootstrap())\n  }\n\n  /** Tear down the view and release the camera (does not fire callbacks). */\n  destroy(): void {\n    this.view.destroy()\n  }\n\n  /** Close the widget as if the user dismissed it (fires `onClose`/`onSettle`). */\n  close(): void {\n    this.finishClose()\n  }\n\n  /**\n   * Subscribe to a named widget event; returns an unsubscribe function. Having a\n   * listener (here or via `onEvent`) is what activates the event stream.\n   */\n  on(event: string, listener: WidgetEventListener): () => void {\n    const set = this.listeners.get(event) ?? new Set<WidgetEventListener>()\n    set.add(listener)\n    this.listeners.set(event, set)\n\n    return () => set.delete(listener)\n  }\n\n  /** Whether anyone is listening for `name` (the firehose or a named listener). */\n  private hasListener(name: string): boolean {\n    if (this.config.onEvent) return true\n    const set = this.listeners.get(name)\n\n    return !!set && set.size > 0\n  }\n\n  /**\n   * Surface an event: to local listeners (firehose + `on`), and — in hosted\n   * iframe mode — to the embedding parent as `arkyc:event` so the SDK's\n   * `handle.on(...)` works across the frame.\n   */\n  private dispatch(name: string, data?: unknown): void {\n    this.emit(name, data)\n    // The parent window is the consumer in iframe mode, so forwarding there isn't\n    // gated on a local listener (post() already no-ops when not embedding).\n    this.post('arkyc:event', { name, data })\n  }\n\n  /** Emit an event to the firehose + named listeners — but only if one is active. */\n  private emit(name: string, data?: unknown): void {\n    if (!this.hasListener(name)) return\n    try {\n      this.config.onEvent?.({ name, data })\n    } catch {\n      // A consumer callback threw — never let it break the flow.\n    }\n    const set = this.listeners.get(name)\n    if (set) {\n      for (const listener of [...set]) {\n        try {\n          listener(data)\n        } catch {\n          // ditto\n        }\n      }\n    }\n  }\n\n  /** Record an observed status, emitting `session.transition` on a real change. */\n  private observe(status: VerificationStatus): void {\n    if (status === this.lastStatus) return\n    const previous = this.lastStatus\n    this.lastStatus = status\n    this.dispatch(REALTIME_EVENT.sessionTransition, {\n      session_id: this.sessionId,\n      status,\n      previous_status: previous,\n    } satisfies Partial<SessionTransitionEvent>)\n  }\n\n  /**\n   * Lazily connect the push transport for this session (once). Returns null for\n   * `polling`/`off`/`memory` or when the transport SDK can't load — the caller\n   * then polls instead.\n   */\n  private async resolveRealtime(): Promise<WidgetRealtimeClient | null> {\n    if (this.rtResolved) return this.rtClient\n    this.rtResolved = true\n    const cfg = this.realtimeConfig\n    if (!cfg || cfg.transport === 'polling' || cfg.transport === 'off' || cfg.transport === 'memory') return null\n\n    const factory = this.config.realtimeFactory ?? createWidgetRealtimeClient\n    const apiBase = (this.config.baseUrl ?? '').replace(/\\/$/, '')\n    try {\n      this.rtClient = await factory(cfg, {\n        authEndpoint: `${apiBase}/v1/client/realtime/auth`,\n        token: this.config.token,\n      })\n    } catch {\n      this.rtClient = null\n    }\n\n    return this.rtClient\n  }\n\n  private handlers(): ViewHandlers {\n    return {\n      onClose: () => this.finishClose(),\n      // The session was already fetched + resolved during bootstrap; just advance.\n      onStart: () => void this.run(() => this.enter(this.next())),\n      onDocumentSelected: (type, country) => {\n        this.documentType = type\n        this.country = country || null\n        void this.run(() => this.enter('front_capture'))\n      },\n      onImage: (blob) => void this.run(() => this.onImage(blob)),\n      onActiveLiveness: (video, performed, selfie) =>\n        void this.run(async () => {\n          await this.client.submitLiveness({\n            selfie,\n            video,\n            mode: 'active',\n            challenges: performed,\n            signals: this.config.signals,\n          })\n          await this.enter(this.next())\n        }),\n      onAddress: (data) => void this.run(() => this.onAddress(data)),\n      onShareLocation: () => this.shareLocation(),\n      onAcknowledge: () => this.finishResult(),\n      onUsePhone: () => void this.run(() => this.startHandoff()),\n      onContinueHere: () => {\n        this.handoffActive = false\n        this.stopWatch?.()\n        this.step = 'welcome'\n        this.render()\n      },\n    }\n  }\n\n  /**\n   * Fetch the session and route: an already-terminal session (e.g. a stale handoff\n   * link, or one finished on another device) shows a close-only notice; on a\n   * desktop with handoff enabled we lead with the QR; otherwise the welcome flow.\n   */\n  private async bootstrap(): Promise<void> {\n    if (this.settled) return\n    const session = await this.client.getSession()\n    if (this.settled) return\n    this.sessionId = session.id\n    this.realtimeConfig = session.realtime ?? null\n    this.workflow = session.workflow ?? null\n    // Theme from the project's branding (server-resolved) unless the integrator\n    // passed branding explicitly — their value wins.\n    if (this.config.branding == null && session.branding)\n      this.view.applyBranding(rebaseBrandingLogo(session.branding, this.config.baseUrl))\n    this.observe(session.status)\n    if (Flow.isTerminal(session.status)) return this.showTerminal(session.status)\n    this.resolveLiveness(session)\n    if (session.handoff) this.handoffConfig = session.handoff\n    const canHandoff =\n      this.config.handoff !== false && isDesktopDevice(this.nav) && this.handoffConfig.enabled && !!this.handoffTarget()\n    if (canHandoff) {\n      this.handoffReady = true\n      await this.startHandoff()\n    } else {\n      this.step = 'welcome'\n      this.render()\n    }\n  }\n\n  /** The hosted handoff page URL: a consumer override, else the server-provided one. */\n  private handoffTarget(): string {\n    return (this.config.handoffUrl ?? this.handoffConfig.url ?? '').trim()\n  }\n\n  /** Render the QR for this session and wait for the other device to finish. */\n  private async startHandoff(): Promise<void> {\n    const target = this.handoffTarget()\n    if (!target) return\n    this.handoffActive = true\n    // Offer \"continue on this device\" only when the project permits it.\n    this.view.renderHandoff(renderQrSvg(this.buildHandoffUrl(target)), this.handoffConfig.allow_desktop)\n    await this.pollHandoff()\n  }\n\n  /** Build the hosted-page URL the QR encodes (carries the session token).\n   *\n   * @param target\n   * @returns\n   */\n  private buildHandoffUrl(target: string): string {\n    const sep = target.includes('?') ? '&' : '?'\n    let url = `${target}${sep}token=${encodeURIComponent(this.config.token)}`\n    // The hosted page supplies its own API base; only pass one when ours is\n    // absolute, so a custom cross-origin host can still reach the right API.\n    const apiBase = (this.config.baseUrl ?? '').trim()\n    if (/^https?:\\/\\//i.test(apiBase)) url += `&baseUrl=${encodeURIComponent(apiBase)}`\n    return url\n  }\n\n  /**\n   * Watch the session while the user verifies on the other\n   * device; mirror the result.\n   *\n   * @returns\n   */\n  private async pollHandoff(): Promise<void> {\n    const rt = await this.resolveRealtime()\n    if (rt) {\n      const status = await this.pushWatch(rt, this.maxHandoffPolls, () => this.handoffActive && !this.settled)\n      if (status) {\n        this.handoffActive = false\n        return this.showResult(status)\n      }\n\n      return // cancelled (continue here) or budget elapsed → the QR persists\n    }\n\n    let errors = 0\n    for (let i = 0; i < this.maxHandoffPolls && this.handoffActive && !this.settled; i++) {\n      await this.delay(this.pollMs)\n      if (!this.handoffActive || this.settled) return\n      try {\n        const session = await this.client.getSession()\n        errors = 0\n        this.observe(session.status)\n        if (Flow.isTerminal(session.status)) {\n          this.handoffActive = false\n          return this.showResult(session.status)\n        }\n      } catch (error) {\n        // The session/token can expire mid-wait (401) — stop and reflect that.\n        if (error instanceof WidgetApiError && error.status === 401) {\n          this.handoffActive = false\n          return this.showResult('expired')\n        }\n        if (++errors >= 5) return\n      }\n    }\n  }\n\n  /**\n   * Await a terminal status over the push transport. Resolves to the terminal\n   * status, or null if `active()` went false or the tick budget elapsed (push can\n   * miss events / disconnect; the budget bounds the wait). An initial fetch\n   * catches a session that finished before we subscribed.\n   *\n   * @param rt\n   * @param budget\n   * @param active\n   * @returns\n   */\n  private pushWatch(\n    rt: WidgetRealtimeClient,\n    budget: number,\n    active: () => boolean,\n  ): Promise<VerificationStatus | null> {\n    return new Promise((resolve) => {\n      let done = false\n      const finish = (status: VerificationStatus | null) => {\n        if (done) return\n        done = true\n        this.stopWatch = undefined\n        unsubscribe()\n        resolve(status)\n      }\n      const channel = this.realtimeConfig!.channel\n      const unsubscribe = rt.subscribe(channel, (event, data) => {\n        if (event !== REALTIME_EVENT.sessionTransition) return\n        const status = (data as SessionTransitionEvent).status\n        this.observe(status)\n        if (Flow.isTerminal(status)) finish(status)\n      })\n      this.stopWatch = () => finish(null)\n      // Catch a race where the session already finished before we subscribed.\n      void this.client\n        .getSession()\n        .then((session) => {\n          this.observe(session.status)\n          if (Flow.isTerminal(session.status)) finish(session.status)\n        })\n        .catch((error) => {\n          if (error instanceof WidgetApiError && error.status === 401) finish('expired')\n        })\n      // Bound the wait by the same tick budget the poller would use.\n      const countdown = async (n: number): Promise<void> => {\n        if (done) return\n        if (!active() || n >= budget) return finish(null)\n        await this.delay(this.pollMs)\n        void countdown(n + 1)\n      }\n      void countdown(0)\n    })\n  }\n\n  /**\n   * Resolve which liveness flow to run from the session's capture model.\n   *\n   * @param session\n   */\n  private resolveLiveness(session: ClientSession): void {\n    this.livenessChallenges = session.liveness_challenges ?? []\n    const model = session.capture_model ?? 'passive'\n    this.captureModel = model\n    const wantsActive = model === 'active' || model === 'both'\n    // `active` is honoured even without a live camera — the active-liveness\n    // screen then shows the device as unsupported (no fallback). `both` falls\n    // back to passive when the camera/recorder isn't available.\n    this.livenessMode = wantsActive && (model === 'active' || this.view.cameraSupported) ? 'active' : 'passive'\n  }\n\n  private async onImage(blob: Blob | null): Promise<void> {\n    const signals = this.config.signals\n    switch (this.step) {\n      case 'front_capture':\n        await this.client.submitDocumentFront({\n          image: blob,\n          country: this.country,\n          documentType: this.documentType,\n          signals,\n        })\n        return this.enter(this.next())\n      case 'back_capture':\n        await this.client.submitDocumentBack({\n          image: blob,\n          country: this.country,\n          documentType: this.documentType,\n        })\n        return this.enter('ocr_processing')\n      case 'selfie_capture':\n        this.selfie = blob\n        return this.enter('passive_liveness')\n    }\n  }\n\n  /**\n   * Enter a step: render it, and drive any automatic (processing) work.\n   *\n   * @param step\n   * @returns\n   */\n  private async enter(step: WidgetStep): Promise<void> {\n    if (this.settled) return\n    this.step = step\n\n    // Lead each capture/liveness step with an instruction screen so the user\n    // knows what's next and starts it deliberately. The Continue button re-enters\n    // the same step with the instruction acknowledged.\n    const instruction = STEP_INSTRUCTIONS[step]\n    if (instruction && !this.instructionAcked) {\n      this.view.renderInstruction(step, instruction.title, instruction.body, instruction.cta ?? 'Continue', () => {\n        this.instructionAcked = true\n        void this.run(() => this.enter(step))\n      })\n      return\n    }\n    this.instructionAcked = false\n    this.render()\n\n    switch (step) {\n      case 'ocr_processing':\n        await this.delay(this.transientMs)\n        return this.enter(this.next())\n      case 'address_processing':\n        await this.submitAddress()\n        return this.enter(this.next())\n      case 'passive_liveness':\n        await this.client.submitLiveness({ selfie: this.selfie, signals: this.config.signals })\n        return this.enter(this.next())\n      case 'face_match':\n        await this.client.complete({ signals: this.config.signals })\n        return this.enter(this.next())\n      case 'processing':\n        return this.poll()\n    }\n  }\n\n  /** Watch the session until it reaches a terminal status (then show the result).\n   *\n   * @returns\n   */\n  private async poll(): Promise<void> {\n    const rt = await this.resolveRealtime()\n    if (rt) {\n      const status = await this.pushWatch(rt, this.maxPolls, () => !this.settled)\n\n      return this.showResult(status ?? 'requires_review')\n    }\n\n    for (let i = 0; i < this.maxPolls && !this.settled; i++) {\n      const session = await this.client.getSession()\n      this.observe(session.status)\n      if (Flow.isTerminal(session.status)) return this.showResult(session.status)\n      await this.delay(this.pollMs)\n    }\n    // Still processing after the poll budget — surface as pending review.\n    this.showResult('requires_review')\n  }\n\n  private showResult(status: VerificationStatus): void {\n    this.result = { status, decision: Flow.statusToDecision(status) }\n    this.step = 'result'\n    this.render()\n  }\n\n  /**\n   * A session that was already terminal on load: a notice with only a Close button.\n   *\n   * @param status\n   */\n  private showTerminal(status: VerificationStatus): void {\n    this.result = { status, decision: Flow.statusToDecision(status) }\n    this.step = 'result'\n    this.terminalOnLoad = true\n    this.render()\n  }\n\n  private render(): void {\n    this.view.render({\n      step: this.step,\n      documentType: this.documentType,\n      decision: this.result?.decision,\n      status: this.result?.status,\n      terminalNotice: this.terminalOnLoad,\n      allowSkip: !!this.config.signals,\n      livenessChallenges: this.livenessChallenges,\n      requireLiveCamera: this.captureModel === 'active',\n      // The active flow is strict end-to-end: documents must be detected, not\n      // manually waved through.\n      strictCapture: this.livenessMode === 'active',\n      handoffAvailable: this.handoffReady,\n      addressMethods: workflowAddressConfig(this.workflow)?.methods ?? [],\n    })\n  }\n\n  /**\n   * Store the entered address, resolve device location if opted in, then verify.\n   *\n   * @param data\n   * @returns\n   */\n  private async onAddress(data: AddressFormData): Promise<void> {\n    this.addressData = data\n    // Coordinates are normally resolved up front by `shareLocation` when the user\n    // ticks \"use my location\" (so the prompt is immediate); geolocate here only as\n    // a fallback, and clear them if they opted out.\n    if (!data.useLocation) this.addressCoords = null\n    else if (!this.addressCoords) this.addressCoords = await this.geolocate()\n\n    return this.enter('address_processing')\n  }\n\n  /** Request the device's location (from the address-entry \"use my location\" opt-in). */\n  private async shareLocation(): Promise<boolean> {\n    this.addressCoords = await this.geolocate()\n\n    return !!this.addressCoords\n  }\n\n  /**\n   * Submit the captured address evidence to the Client API.\n   *\n   * @returns\n   */\n  private async submitAddress(): Promise<void> {\n    const data = this.addressData\n    if (!data) return\n\n    await this.client.submitAddress({\n      line1: data.line1,\n      line2: data.line2,\n      city: data.city,\n      region: data.region,\n      postalCode: data.postalCode,\n      country: data.country,\n      poa: data.poa,\n      latitude: this.addressCoords?.latitude ?? null,\n      longitude: this.addressCoords?.longitude ?? null,\n      signals: this.config.signals,\n    })\n  }\n\n  /**\n   * Resolve the device's coordinates via the Geolocation API. Resolves to `null`\n   * on denial/unavailability/timeout — the `device_location` method then simply\n   * has no coordinates to check (routing the session to review).\n   *\n   * @returns\n   */\n  private geolocate(): Promise<{ latitude: number; longitude: number } | null> {\n    const geo = this.nav?.geolocation\n    if (!geo) return Promise.resolve(null)\n\n    return new Promise((resolve) => {\n      geo.getCurrentPosition(\n        (pos) => resolve({ latitude: pos.coords.latitude, longitude: pos.coords.longitude }),\n        () => resolve(null),\n        { enableHighAccuracy: false, timeout: 10_000, maximumAge: 60_000 },\n      )\n    })\n  }\n\n  private next(): WidgetStep {\n    return Flow.nextStep(this.step, {\n      documentType: this.documentType,\n      livenessMode: this.livenessMode,\n      workflow: this.workflow,\n    })\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => this.scheduler(resolve, ms))\n  }\n\n  /** Run an async step, routing any failure to the error screen. */\n  private async run(fn: () => Promise<void> | void): Promise<void> {\n    try {\n      await fn()\n    } catch (error) {\n      this.fail(error)\n    }\n  }\n\n  private fail(error: unknown): void {\n    if (this.settled) return\n    const err = error instanceof Error ? error : new Error(String(error))\n    this.step = 'result'\n\n    this.view.render({\n      step: 'result',\n      documentType: this.documentType,\n      errorMessage: err.message,\n    })\n\n    this.pendingError = err\n  }\n\n  private finishResult(): void {\n    if (this.settled) return\n    this.settled = true\n    this.teardownRealtime()\n\n    if (this.pendingError) {\n      this.post('arkyc:error', { error: serializeError(this.pendingError) })\n      this.dispatch('error', { message: this.pendingError.message })\n      this.config.onError?.(this.pendingError)\n    } else if (this.result) {\n      this.post('arkyc:complete', { payload: this.result })\n      this.dispatch('complete', this.result)\n      this.config.onComplete?.(this.result)\n    }\n\n    this.destroy()\n    this.config.onSettle?.()\n  }\n\n  private finishClose(): void {\n    if (this.settled) return\n\n    this.settled = true\n    this.teardownRealtime()\n    this.post('arkyc:close', {})\n    this.dispatch('close')\n    this.config.onClose?.()\n    this.destroy()\n    this.config.onSettle?.()\n  }\n\n  /** Stop any active session watch + disconnect the push transport. */\n  private teardownRealtime(): void {\n    this.stopWatch?.()\n    this.rtClient?.disconnect()\n    this.rtClient = null\n  }\n\n  private post(type: string, extra: Record<string, unknown>): void {\n    if (!this.postToParent) return\n    try {\n      this.win.parent?.postMessage({ type, ...extra }, '*')\n    } catch {\n      // Cross-origin parent without access — nothing more we can do.\n    }\n  }\n}\n\nfunction serializeError(error: Error): { message: string; name: string } {\n  return { message: error.message, name: error.name }\n}\n\nexport const resolveContainer = (container: string | HTMLElement, doc: Document): HTMLElement => {\n  const el = typeof container === 'string' ? doc.querySelector<HTMLElement>(container) : container\n  if (!el) throw new Error(`ArkycWidget.mount: container \"${String(container)}\" not found.`)\n  return el\n}\n\nexport const buildController = (options: BaseWidgetOptions, onSettle: () => void): WidgetController => {\n  if (!options.token) throw new Error('ArkycWidget requires a client `token`.')\n  return new WidgetController({\n    token: options.token,\n    baseUrl: options.baseUrl,\n    handoff: options.handoff,\n    handoffUrl: options.handoffUrl,\n    branding: options.branding,\n    signals: options.signals,\n    onComplete: options.onComplete,\n    onError: options.onError,\n    onClose: options.onClose,\n    onEvent: options.onEvent,\n    onSettle,\n    fetch: options.fetch,\n    doc: options.doc,\n    win: options.win,\n    nav: options.nav,\n    faceAnalyzer: options.faceAnalyzer,\n    faceTuning: options.faceTuning,\n    documentAnalyzer: options.documentAnalyzer,\n    documentTuning: options.documentTuning,\n  })\n}\n"],"mappings":"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"}

package/dist/flow.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.d.mts","names":[],"sources":["../src/flow.ts"],"mappings":";;;;UAaiB,WAAA;EACf,YAAA,GAAe,YAAA;EADW;EAG1B,YAAA,GAAe,YAAA;EAFA;EAIf,QAAA,GAAW,cAAA;AAAA;;;;;cAcA,IAAA;EAhBI;;;;EAAA,gBAqBC,UAAA,EAAY,UAAA;EALjB;;;EAAA,gBAsBK,iBAAA,EAAmB,kBAAA;EAAA;;;;;;EAAA,OAc5B,eAAA,CAAgB,IAAA,EAAM,YAAA;EA2Ca;;;;;;EAAA,OAjCnC,SAAA,CAAU,GAAA,GAAK,WAAA,GAAmB,UAAA;EAzCzB;;;;;;;;EAAA,OAwDT,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,GAAA,GAAK,WAAA;EAf3B;;;;;;;;EAAA,OAiCV,QAAA,CAAS,OAAA,EAAS,UAAA,EAAY,GAAA,GAAK,WAAA,GAAmB,UAAA;EAA7C;;;;;;EAAA,OAiBT,UAAA,CAAW,MAAA,EAAQ,kBAAA;EASnB;;;;;EAAA,OAAA,gBAAA,CAAiB,MAAA,EAAQ,kBAAA,GAAqB,oBAAA;AAAA"}
+{"version":3,"file":"flow.d.mts","names":[],"sources":["../src/flow.ts"],"mappings":";;;;UAaiB,WAAA;EACf,YAAA,GAAe,YAAA;EADW;EAG1B,YAAA,GAAe,YAAA;EAFA;EAIf,QAAA,GAAW,cAAA;AAAA;;;;;cAeA,IAAA;EAjBI;;;;EAAA,gBAsBC,UAAA,EAAY,UAAA;EALjB;;;EAAA,gBAsBK,iBAAA,EAAmB,kBAAA;EAAA;;;;;;EAAA,OAc5B,eAAA,CAAgB,IAAA,EAAM,YAAA;EA2Ca;;;;;;EAAA,OAjCnC,SAAA,CAAU,GAAA,GAAK,WAAA,GAAmB,UAAA;EAzCzB;;;;;;;;EAAA,OAwDT,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,GAAA,GAAK,WAAA;EAf3B;;;;;;;;EAAA,OAiCV,QAAA,CAAS,OAAA,EAAS,UAAA,EAAY,GAAA,GAAK,WAAA,GAAmB,UAAA;EAA7C;;;;;;EAAA,OAiBT,UAAA,CAAW,MAAA,EAAQ,kBAAA;EASnB;;;;;EAAA,OAAA,gBAAA,CAAiB,MAAA,EAAQ,kBAAA,GAAqB,oBAAA;AAAA"}