@powercred/liveness-web 0.0.0-stage → 0.1.1

package/dist/liveness.js

@@ -0,0 +1,645 @@
+const oe = { gettingReady: "Getting ready…", center: "Center your face in the oval", moveCloser: "Move a little closer", moveBack: "Move a little back", lookStraight: "Look straight at the camera", noFace: "We can't see your face", multipleFaces: "Only one person, please", turnLeft: "Turn your head to your LEFT", turnRight: "Turn your head to your RIGHT", lookUp: "Look UP", lookDown: "Look DOWN", smile: "Smile", blink: "Blink once", openMouth: "Open your mouth", holdStill: "Hold still", great: "Great!", wrongDirection: "That was the other way — let's try again", faceLost: "We lost your face — let's try again", interrupted: "The check was interrupted — let's try again", timeUp: "Time's up — let's try again", tooSlow: "That took a while — let's try again", flashIntro: "Hold still — the screen will flash colours", checking: "Checking…", passedTitle: "Done", passedDetail: "Thank you, your liveness check is complete.", submittedTitle: "Thank you", failedTitle: "We couldn't confirm that", failedDetail: "Please try again in good light, facing the camera.", noAttemptsDetail: "Please contact the company that asked you to do this check.", tryAgain: "Try again", cameraDenied: "Camera access is needed. Allow it in your browser settings and try again.", cameraUnavailable: "We couldn't start your camera.", unsupportedBrowser: "This browser can't run the check. Please use an up-to-date Chrome, Safari, Edge or Firefox.", insecureContext: "This page must be opened over https.", network: "Connection problem. Please check your internet and try again.", sessionExpired: "This check has expired. Please start again.", serviceUnavailable: "The check is temporarily unavailable. Please try again shortly.", genericError: "Something went wrong. Please try again." }, le = `
+:host { all: initial; display: block; }
+.pcl { --primary: var(--pcl-primary, #4b45a1); --ok: #1f9d55; --warn: #e3a008; --bad: #d64545;
+  font-family: var(--pcl-font, system-ui, -apple-system, "Segoe UI", sans-serif); color: #fff;
+  position: relative; width: 100%; max-width: 560px; margin: 0 auto; }
+.stage { position: relative; width: 100%; aspect-ratio: 3 / 4; background: #000; border-radius: 16px; overflow: hidden; }
+@media (min-aspect-ratio: 4/3) and (min-width: 700px) { .stage { aspect-ratio: 4 / 3; } }
+video { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; transform: scaleX(-1); }
+.oval { position: absolute; left: 50%; top: 45%; width: 62%; aspect-ratio: 3 / 4; max-height: 76%; transform: translate(-50%, -50%);
+  border-radius: 50%; border: 3px solid rgba(255,255,255,.85); box-shadow: 0 0 0 9999px rgba(0,0,0,.5);
+  transition: border-color .2s; }
+.oval[data-state="ok"] { border-color: var(--ok); }
+.oval[data-state="warn"] { border-color: var(--warn); }
+.prompt { position: absolute; left: 0; right: 0; bottom: 6%; padding: 0 16px; text-align: center;
+  font-size: clamp(18px, 5vw, 26px); font-weight: 650; line-height: 1.25; text-shadow: 0 2px 8px rgba(0,0,0,.8); }
+.progress { position: absolute; top: 14px; left: 0; right: 0; display: flex; gap: 8px; justify-content: center; }
+.dot { width: 10px; height: 10px; border-radius: 50%; background: rgba(255,255,255,.35); }
+.dot[data-state="current"] { background: #fff; }
+.dot[data-state="done"] { background: var(--ok); }
+.countdown { position: absolute; top: 10px; right: 12px; font: 600 14px/1 inherit; background: rgba(0,0,0,.5);
+  padding: 6px 10px; border-radius: 99px; font-family: inherit; }
+.debug { position: absolute; left: 8px; top: 34px; font: 12px/1.35 ui-monospace, monospace; background: rgba(0,0,0,.6);
+  padding: 6px 8px; border-radius: 6px; white-space: pre; }
+.pcl.flashing .stage { position: fixed; inset: 0; z-index: 2147483647; border-radius: 0; aspect-ratio: auto;
+  background: var(--flash, #000); max-width: none; }
+.pcl.flashing video { left: 50%; top: 50%; width: auto; height: 45vh; aspect-ratio: 3 / 4; transform: translate(-50%, -50%) scaleX(-1);
+  border-radius: 50%; inset: auto; }
+.pcl.flashing .oval, .pcl.flashing .progress, .pcl.flashing .countdown { display: none; }
+.pcl.flashing .prompt { bottom: 10%; }
+.panel { position: absolute; inset: 0; display: flex; flex-direction: column; align-items: center; justify-content: center;
+  gap: 12px; padding: 24px; text-align: center; background: rgba(15,17,21,.92); border-radius: 16px; }
+.panel[hidden] { display: none; }
+.icon { width: 56px; height: 56px; border-radius: 50%; display: grid; place-items: center; font-size: 30px; font-weight: 700; }
+.icon.ok { background: var(--ok); } .icon.bad { background: var(--bad); }
+.spinner { width: 44px; height: 44px; border-radius: 50%; border: 4px solid rgba(255,255,255,.25); border-top-color: #fff;
+  animation: spin 0.9s linear infinite; }
+@keyframes spin { to { transform: rotate(360deg); } }
+@media (prefers-reduced-motion: reduce) { .spinner { animation-duration: 3s; } }
+.title { font-size: 20px; font-weight: 650; margin: 0; }
+.detail { font-size: 15px; margin: 0; color: #d0d4dc; max-width: 34ch; }
+button { font: inherit; font-size: 16px; font-weight: 600; color: #fff; background: var(--primary); border: 0; border-radius: 10px;
+  padding: 12px 22px; cursor: pointer; }
+button:focus-visible { outline: 3px solid #fff; outline-offset: 2px; }
+.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); }
+`;
+class ce {
+  constructor(e = {}) {
+    this.host = document.createElement("div");
+    const s = this.host.attachShadow({ mode: "open" });
+    s.innerHTML = `<style>${le}</style>
+      <div class="pcl">
+        <div class="stage">
+          <video playsinline muted autoplay></video>
+          <div class="oval" data-state="idle"></div>
+          <div class="progress"></div>
+          <div class="countdown" hidden></div>
+          <div class="debug" hidden></div>
+          <div class="prompt" role="status" aria-live="polite"></div>
+        </div>
+        <div class="panel" hidden role="dialog" aria-live="assertive"></div>
+      </div>`;
+    const i = (n) => s.querySelector(n);
+    this.root = i(".pcl"), this.video = i("video"), this.prompt = i(".prompt"), this.countdownEl = i(".countdown"), this.progressEl = i(".progress"), this.oval = i(".oval"), this.debugEl = i(".debug"), this.panel = i(".panel"), e.primaryColor && this.root.style.setProperty("--pcl-primary", e.primaryColor), e.fontFamily && this.root.style.setProperty("--pcl-font", e.fontFamily);
+  }
+  mount(e) {
+    e.appendChild(this.host);
+  }
+  unmount() {
+    this.host.remove();
+  }
+  async attach(e) {
+    this.video.srcObject = e, await this.video.play().catch(() => {
+    }), this.video.videoWidth || await new Promise((s) => this.video.addEventListener("loadedmetadata", () => s(), { once: !0 }));
+  }
+  setPrompt(e) {
+    this.prompt.textContent !== e && (this.prompt.textContent = e);
+  }
+  setCountdown(e) {
+    this.countdownEl.hidden = e === null, e !== null && (this.countdownEl.textContent = `${e}s`);
+  }
+  setProgress(e, s, i) {
+    this.progressEl.childElementCount !== e && (this.progressEl.innerHTML = Array.from({ length: e }, () => '<span class="dot"></span>').join("")), Array.from(this.progressEl.children).forEach((n, a) => {
+      n.setAttribute("data-state", a < s ? "done" : a === i ? "current" : "todo");
+    });
+  }
+  setOval(e) {
+    this.oval.setAttribute("data-state", e);
+  }
+  setFlash(e) {
+    this.root.classList.toggle("flashing", e !== null), e ? this.root.style.setProperty("--flash", e) : this.root.style.removeProperty("--flash");
+  }
+  setDebug(e) {
+    this.debugEl.hidden = e === null, e !== null && (this.debugEl.textContent = e);
+  }
+  showPanel(e, s, i = "", n) {
+    const a = e === "working" ? '<div class="spinner" aria-hidden="true"></div>' : `<div class="icon ${e}" aria-hidden="true">${e === "ok" ? "✓" : "!"}</div>`;
+    if (this.panel.innerHTML = `${a}<p class="title"></p>${i ? '<p class="detail"></p>' : ""}${n ? '<button type="button"></button>' : ""}`, this.panel.querySelector(".title").textContent = s, i && (this.panel.querySelector(".detail").textContent = i), this.panel.hidden = !1, !n) return Promise.resolve();
+    const r = this.panel.querySelector("button");
+    return r.textContent = n, r.focus(), new Promise((o) => r.addEventListener("click", () => o(), { once: !0 }));
+  }
+  hidePanel() {
+    this.panel.hidden = !0, this.panel.innerHTML = "";
+  }
+}
+const de = { runtime: "liveness-runtime", runtimeCompat: "liveness-runtime-compat", model: "liveness-face.bin" }, he = import.meta.url, ue = "assets/";
+function pe(t) {
+  const e = new URL(t || ue, t ? document.baseURI : he).href;
+  return e.endsWith("/") ? e : e + "/";
+}
+class U extends Error {
+}
+class I {
+  constructor(e) {
+    this.engine = e, this.lastTs = 0, this.inferenceMs = [];
+  }
+  static async create(e, s = 2e4) {
+    const i = pe(e), n = import("./liveness-device-C5ygqTPx.js").then((r) => r.createEngine(i, de));
+    let a;
+    try {
+      const r = await Promise.race([n, new Promise((o, l) => {
+        a = setTimeout(() => l(new U("face tracker load timed out")), s);
+      })]);
+      return new I(r);
+    } catch (r) {
+      throw n.then((o) => o.close(), () => {
+      }), r instanceof U ? r : new U(String(r));
+    } finally {
+      clearTimeout(a);
+    }
+  }
+  detect(e, s) {
+    const i = performance.now(), n = Math.max(i, this.lastTs + 1);
+    this.lastTs = n;
+    const a = this.engine.detect(e, n, s);
+    return this.inferenceMs.push(performance.now() - i), this.inferenceMs.length > 60 && this.inferenceMs.shift(), a;
+  }
+  medianInferenceMs() {
+    if (this.inferenceMs.length < 10) return null;
+    const e = [...this.inferenceMs].sort((s, i) => s - i);
+    return e[Math.floor(e.length / 2)];
+  }
+  close() {
+    this.engine.close();
+  }
+}
+function x(t) {
+  return t.faceCount >= 1 && t.yaw !== void 0;
+}
+class me {
+  constructor(e = 0.5) {
+    this.alpha = e;
+  }
+  apply(e) {
+    return x(e) ? (this.yaw = this.yaw === void 0 ? e.yaw : this.alpha * e.yaw + (1 - this.alpha) * this.yaw, this.pitch = this.pitch === void 0 ? e.pitch : this.alpha * e.pitch + (1 - this.alpha) * this.pitch, { ...e, yaw: this.yaw, pitch: this.pitch }) : e;
+  }
+}
+function fe(t) {
+  if (t.length === 0) return;
+  const e = [...t].sort((i, n) => i - n), s = Math.floor(e.length / 2);
+  return e.length % 2 ? e[s] : (e[s - 1] + e[s]) / 2;
+}
+const w = { turnHeadDeg: 20, nodDeg: 15, jawOpen: 0.4, smile: 0.5, blinkClosed: 0.6, blinkOpen: 0.25, blinkMaxMs: 600, poseHoldMs: 150, expressionHoldMs: 300, baselineMs: 300 };
+class R {
+  constructor(e) {
+    this.ms = e, this.since = null, this.misses = 0;
+  }
+  update(e, s) {
+    return s ? (this.since === null && (this.since = e), this.misses = 0, e - this.since >= this.ms) : this.since !== null && this.misses === 0 ? (this.misses = 1, !1) : (this.since = null, this.misses = 0, !1);
+  }
+}
+class G {
+  constructor(e, s, i) {
+    this.axis = e, this.negative = s, this.threshold = i, this.passedAt = null, this.start = null, this.samples = [], this.extreme = 0, this.hold = new R(w.poseHoldMs), this.opposite = new R(w.poseHoldMs);
+  }
+  feed(e) {
+    if (this.passedAt !== null) return "passed";
+    if (this.start === null && (this.start = e.t), !x(e)) return this.hold.update(e.t, !1), this.opposite.update(e.t, !1), "pending";
+    const s = e[this.axis];
+    if (this.baseline === void 0) {
+      if (this.samples.push(s), e.t - this.start < w.baselineMs) return "pending";
+      this.baseline = fe(this.samples);
+    }
+    const i = s - this.baseline;
+    (this.negative ? i < this.extreme : i > this.extreme) && (this.extreme = i);
+    const n = this.negative ? i <= -this.threshold : i >= this.threshold, a = this.negative ? i >= this.threshold : i <= -this.threshold;
+    return this.opposite.update(e.t, a) ? "wrong_direction" : this.hold.update(e.t, n) ? (this.passedAt = e.t, "passed") : "pending";
+  }
+  get peak() {
+    return this.axis === "yaw" ? { yaw: D(this.extreme) } : { pitch: D(this.extreme) };
+  }
+  get confidence() {
+    return j(Math.abs(this.extreme) / (this.threshold * 1.5));
+  }
+}
+class X {
+  constructor(e, s) {
+    this.attr = e, this.threshold = s, this.passedAt = null, this.highest = 0, this.hold = new R(w.expressionHoldMs);
+  }
+  feed(e) {
+    if (this.passedAt !== null) return "passed";
+    const s = x(e) ? e[this.attr] ?? 0 : 0;
+    return this.highest = Math.max(this.highest, s), this.hold.update(e.t, x(e) && s >= this.threshold) ? (this.passedAt = e.t, "passed") : "pending";
+  }
+  get peak() {
+    return { score: D(this.highest, 3) };
+  }
+  get confidence() {
+    return j(this.highest);
+  }
+}
+class we {
+  constructor() {
+    this.passedAt = null, this.closedAt = null, this.highest = 0;
+  }
+  feed(e) {
+    if (this.passedAt !== null) return "passed";
+    if (!x(e)) return "pending";
+    if (this.highest = Math.max(this.highest, e.blink), e.blink >= w.blinkClosed) this.closedAt === null && (this.closedAt = e.t);
+    else if (this.closedAt !== null) {
+      if (e.t - this.closedAt > w.blinkMaxMs) this.closedAt = null;
+      else if (e.blink <= w.blinkOpen) return this.passedAt = this.closedAt, "passed";
+    }
+    return "pending";
+  }
+  get peak() {
+    return { score: D(this.highest, 3) };
+  }
+  get confidence() {
+    return j(this.highest);
+  }
+}
+function J(t, e) {
+  switch (t) {
+    case "turn_head":
+      return new G("yaw", e === "left", w.turnHeadDeg);
+    case "nod":
+      return new G("pitch", e === "up", w.nodDeg);
+    case "smile":
+      return new X("smile", w.smile);
+    case "open_mouth":
+      return new X("jawOpen", w.jawOpen);
+    case "blink":
+      return new we();
+  }
+}
+const k = { holdMs: 800, center: 0.1, minHeight: 0.35, maxHeight: 0.7, maxAngle: 12 };
+function ge(t) {
+  return t.faceCount > 1 ? "multiple_faces" : x(t) ? t.boxHeight < k.minHeight ? "move_closer" : t.boxHeight > k.maxHeight ? "move_back" : Math.abs(t.centerX - 0.5) > k.center || Math.abs(t.centerY - 0.5) > k.center ? "center" : Math.abs(t.yaw) > k.maxAngle || Math.abs(t.pitch) > k.maxAngle ? "look_straight" : "ok" : "no_face";
+}
+class ve {
+  constructor() {
+    this.hold = new R(k.holdMs);
+  }
+  feed(e) {
+    const s = ge(e);
+    return { hint: s, ready: this.hold.update(e.t, s === "ok") };
+  }
+}
+function Y(t) {
+  return x(t) && t.faceCount === 1 && Math.abs(t.yaw) < 10 && Math.abs(t.pitch) < 10 && t.blink < 0.3;
+}
+class be {
+  constructor() {
+    this.multi = 0, this.lostSince = null;
+  }
+  feed(e) {
+    if (this.multi = e.faceCount > 1 ? this.multi + 1 : 0, this.multi >= 5) return "multiple_faces";
+    if (e.faceCount === 0) {
+      if (this.lostSince === null && (this.lostSince = e.t), e.t - this.lostSince >= 1500) return "face_lost";
+    } else this.lostSince = null;
+    return null;
+  }
+}
+function j(t) {
+  return Math.max(0, Math.min(1, t));
+}
+function D(t, e = 1) {
+  const s = 10 ** e;
+  return Math.round(t * s) / s;
+}
+const ye = "liveness-web", ke = "0.1.1";
+function _e(t) {
+  const e = navigator.userAgent, s = navigator.userAgentData;
+  return { schema_version: 1, liveness_session_id: t.session.liveness_session_id, sdk: { name: ye, version: ke }, platform: { os: (s?.platform || navigator.platform || "").slice(0, 64) || null, device: null, browser: e.slice(0, 64) }, camera: { width: t.camera.width ?? null, height: t.camera.height ?? null, fps_measured: t.camera.frameRate ?? null, facing: "user" }, video: { mime: t.video.mime, duration_ms: t.video.durationMs, started_at_epoch_ms: t.video.startedAtEpochMs }, mode: t.session.mode, challenges: t.challenges, flash: t.flash, stills: t.stills, device_result: { passed: !0, aborted_reason: null, mode: t.mode, fallback_reason: t.fallbackReason, frames_total: t.tally.framesTotal, frames_with_face: t.tally.framesWithFace, frames_with_two_faces: t.tally.framesWithTwoFaces } };
+}
+class p extends Error {
+  constructor(e, s) {
+    super(s || e), this.code = e;
+  }
+}
+async function K() {
+  if (!window.isSecureContext) throw new p("insecure_context", "The camera needs an https page");
+  if (!navigator.mediaDevices?.getUserMedia) throw new p("unsupported_browser");
+  if (typeof MediaRecorder > "u") throw new p("unsupported_browser");
+  try {
+    return await navigator.mediaDevices.getUserMedia({ video: { facingMode: "user", width: { ideal: 640 }, height: { ideal: 480 }, frameRate: { ideal: 30 } }, audio: !1 });
+  } catch (t) {
+    const e = t?.name;
+    throw e === "NotAllowedError" || e === "SecurityError" ? new p("camera_denied") : new p("camera_unavailable", e);
+  }
+}
+function Q(t) {
+  t?.getTracks().forEach((e) => e.stop());
+}
+function xe(t = (e) => MediaRecorder.isTypeSupported(e)) {
+  return ["video/mp4;codecs=avc1.42E01E", "video/mp4", "video/webm;codecs=vp9", "video/webm;codecs=vp8", "video/webm"].find((e) => t(e)) || "";
+}
+class Me {
+  constructor(e, s = 12e5) {
+    this.chunks = [], this.t0 = 0, this.epoch = 0;
+    const i = xe();
+    this.recorder = new MediaRecorder(e, i ? { mimeType: i, videoBitsPerSecond: s } : { videoBitsPerSecond: s }), this.recorder.ondataavailable = (n) => {
+      n.data && n.data.size && this.chunks.push(n.data);
+    };
+  }
+  async start() {
+    const e = new Promise((s) => this.recorder.addEventListener("start", () => s(), { once: !0 }));
+    this.stopped = new Promise((s) => this.recorder.addEventListener("stop", () => s(), { once: !0 })), this.recorder.start(1e3), await e, this.t0 = performance.now(), this.epoch = Date.now();
+  }
+  now() {
+    return Math.round(performance.now() - this.t0);
+  }
+  async stop() {
+    this.recorder.state !== "inactive" && this.recorder.stop(), await this.stopped;
+    const e = (this.recorder.mimeType || "video/webm").split(";")[0];
+    return new Blob(this.chunks, { type: e });
+  }
+  abort() {
+    try {
+      this.recorder.state !== "inactive" && this.recorder.stop();
+    } catch {
+    }
+  }
+}
+async function Pe(t, e) {
+  const s = t.videoWidth, i = t.videoHeight, n = Math.min(1, 1280 / Math.max(s, i)), a = document.createElement("canvas");
+  a.width = Math.round(s * n), a.height = Math.round(i * n), a.getContext("2d").drawImage(t, 0, 0, a.width, a.height);
+  let r = 0.9;
+  for (; ; ) {
+    const o = await new Promise((l) => a.toBlob(l, "image/jpeg", r));
+    if (!o) throw new p("capture_failed");
+    if (o.size <= e || r <= 0.45) return o;
+    r -= 0.1;
+  }
+}
+const _ = (t) => new Promise((e) => setTimeout(e, t)), Ce = () => new Promise((t) => requestAnimationFrame(t)), Te = 120, Se = 700, Ee = 400, Ae = 1e3, Re = 5e3, De = 2200;
+class A extends Error {
+}
+class Z extends Error {
+}
+function W(t, e) {
+  switch (t.type) {
+    case "turn_head":
+      return t.direction === "left" ? e.turnLeft : e.turnRight;
+    case "nod":
+      return t.direction === "up" ? e.lookUp : e.lookDown;
+    case "smile":
+      return e.smile;
+    case "blink":
+      return e.blink;
+    case "open_mouth":
+      return e.openMouth;
+  }
+}
+function Fe(t, e) {
+  switch (t) {
+    case "ok":
+      return e.lookStraight;
+    case "no_face":
+      return e.noFace;
+    case "multiple_faces":
+      return e.multipleFaces;
+    case "move_closer":
+      return e.moveCloser;
+    case "move_back":
+      return e.moveBack;
+    case "center":
+      return e.center;
+    case "look_straight":
+      return e.lookStraight;
+  }
+}
+async function Le(t) {
+  const { session: e, view: s, strings: i } = t, n = t.mode === "device" && t.tracker !== null, a = new me(), r = { framesTotal: 0, framesWithFace: 0, framesWithTwoFaces: 0 };
+  let o = null, l = !1, m = () => {
+  };
+  const P = new Promise((d) => {
+    m = d;
+  }), M = () => {
+    document.visibilityState === "hidden" && (l = !0, m());
+  };
+  M(), document.addEventListener("visibilitychange", M);
+  const c = () => {
+    if (t.isCancelled()) throw new A();
+    if (l) throw new Z();
+  }, C = async () => {
+    const d = await Promise.race([Ce(), P.then(() => NaN)]);
+    return c(), d;
+  }, E = () => new Promise((d) => {
+    const f = s.video;
+    f.requestVideoFrameCallback ? f.requestVideoFrameCallback(() => d()) : requestAnimationFrame(() => d()), setTimeout(d, 250);
+  }), u = async (d, f) => {
+    await E(), c();
+    const b = a.apply(t.tracker.detect(s.video, d));
+    return f && (r.framesTotal++, b.faceCount >= 1 && r.framesWithFace++, b.faceCount >= 2 && r.framesWithTwoFaces++), b;
+  };
+  try {
+    let d = null;
+    if (n) {
+      const g = new ve(), v = performance.now();
+      let h = 0;
+      for (; ; ) {
+        d = await u(performance.now() - v, !1), h++;
+        const T = t.tracker.medianInferenceMs();
+        if (h >= 15 && T !== null && T > Te) return { kind: "fallback", reason: "slow_device" };
+        const { hint: y, ready: S } = g.feed(d);
+        if (s.setPrompt(Fe(y, i)), s.setOval(y === "ok" ? "ok" : "warn"), S) break;
+      }
+    }
+    o = new Me(t.stream), await o.start(), t.emit({ type: "recording_started" });
+    const f = e.limits.max_video_seconds * 1e3, b = [], $ = [], F = async (g) => {
+      $.push({ index: b.length, captured_at_ms: o.now(), reason: g }), b.push(await Pe(s.video, e.limits.max_still_bytes));
+    };
+    if (n) {
+      const g = performance.now() + 1e3;
+      for (; d && !Y(d) && performance.now() < g; ) d = await u(o.now(), !0);
+      await F("positioning");
+    } else s.setOval("idle"), s.setPrompt(i.lookStraight), await _(1500), c(), await F("positioning");
+    const L = [], q = [], H = e.challenges.length;
+    if (e.mode === "active") {
+      const g = new be();
+      for (const [v, h] of e.challenges.entries()) {
+        s.setProgress(H, v, v), s.setPrompt(W(h, i)), s.setOval("idle"), t.emit({ type: "challenge_started", challenge: h });
+        const T = o.now();
+        if (n) {
+          let y = J(h.type, h.direction), S = 1, z = performance.now();
+          for (; ; ) {
+            const B = await u(o.now(), !0), N = g.feed(B);
+            if (N) return { kind: "aborted", reason: N };
+            if (o.now() > f - Re) return { kind: "aborted", reason: "too_slow" };
+            const V = y.feed(B);
+            if (V === "wrong_direction") return { kind: "aborted", reason: "wrong_direction" };
+            if (V === "passed") {
+              L.push({ order: h.order, type: h.type, direction: h.direction, start_ms: T, end_ms: o.now(), passed: !0, confidence: Oe(y.confidence), timed_out: S > 1, peak: y.peak }), q.push(h.type), s.setOval("ok"), s.setPrompt(i.great), s.setProgress(H, v + 1, null), t.emit({ type: "challenge_passed", challenge: h }), await _(Ee);
+              break;
+            }
+            if (performance.now() - z > h.timeout_ms) {
+              if (S > 1) return { kind: "aborted", reason: `challenge_timeout:${h.type}` };
+              S = 2, y = J(h.type, h.direction), z = performance.now(), s.setPrompt(W(h, i));
+            }
+          }
+        } else await ee(s, c, t.timedWindowMs, W(h, i)), L.push({ order: h.order, type: h.type, direction: h.direction, start_ms: T, end_ms: o.now(), passed: null, confidence: null, timed_out: !1, peak: null }), s.setProgress(H, v + 1, null), s.setPrompt(i.lookStraight), await _(Se), c();
+      }
+    } else await ee(s, c, De, i.holdStill);
+    const ie = await He(t, o, c, C);
+    if (c(), s.setFlash(null), s.setPrompt(i.lookStraight), n) {
+      const g = performance.now() + 2e3;
+      for (; ; ) {
+        const v = await u(o.now(), !0);
+        if (Y(v) || performance.now() > g) break;
+      }
+    } else await _(1500), c();
+    await F("return_to_centre"), c();
+    const ne = o.now(), ae = o.epoch, O = await o.stop();
+    if (o = null, O.size > e.limits.max_video_bytes) throw new p("recording_too_large");
+    const re = _e({ session: e, mode: t.mode, fallbackReason: t.fallbackReason, camera: t.stream.getVideoTracks()[0]?.getSettings() ?? {}, video: { mime: O.type, durationMs: ne, startedAtEpochMs: ae }, challenges: L, flash: ie, stills: $, tally: r });
+    return { kind: "recorded", video: O, stills: b, metadata: re, passedChallenges: q };
+  } catch (d) {
+    if (d instanceof Z) return { kind: "aborted", reason: "interrupted" };
+    throw d;
+  } finally {
+    document.removeEventListener("visibilitychange", M), o?.abort(), s.setFlash(null), s.setCountdown(null), s.setDebug(null);
+  }
+}
+async function ee(t, e, s, i) {
+  t.setPrompt(i);
+  const n = performance.now() + s;
+  for (; performance.now() < n; ) e(), t.setCountdown(Math.ceil((n - performance.now()) / 1e3)), await _(100);
+  t.setCountdown(null);
+}
+async function He(t, e, s, i) {
+  const n = t.session.flash, a = { enabled: !1, started_at_ms: null, segments: [], screen_brightness: null, exposure_locked: !1, skipped_reason: null };
+  if (!n.enabled) return a;
+  if (!t.allowFlash) return { ...a, skipped_reason: "disabled_by_host" };
+  if (window.matchMedia?.("(prefers-reduced-motion: reduce)").matches) return { ...a, skipped_reason: "reduced_motion" };
+  t.emit({ type: "flash_started" }), t.view.setFlash("#000000"), t.view.setPrompt(t.strings.flashIntro), await _(Ae), s(), t.view.setPrompt(""), a.enabled = !0;
+  for (const r of n.segments) {
+    await i(), t.view.setFlash(r.color);
+    const o = await i(), l = Math.round(o - e.t0);
+    a.started_at_ms === null && (a.started_at_ms = l), await _(Math.max(0, r.duration_ms - (performance.now() - o))), a.segments.push({ color: r.color, start_ms: l, end_ms: e.now() });
+  }
+  return t.view.setFlash(null), t.emit({ type: "flash_ended" }), a;
+}
+function Oe(t) {
+  return Math.round(t * 100) / 100;
+}
+const Ue = 6e4;
+async function We(t, e, s) {
+  const i = new FormData();
+  i.append("video", s.video, s.video.type === "video/mp4" ? "attempt.mp4" : "attempt.webm"), s.stills.forEach((a, r) => i.append("stills", a, `${r}.jpg`)), i.append("metadata", JSON.stringify(s.metadata)), i.append("token", e.token);
+  const n = t.replace(/\/+$/, "") + e.upload_url;
+  for (let a = 1; ; a++) {
+    const r = new AbortController(), o = setTimeout(() => r.abort(), Ue);
+    let l;
+    try {
+      l = await fetch(n, { method: "POST", body: i, signal: r.signal });
+    } catch (P) {
+      if (clearTimeout(o), a < 2) continue;
+      throw new p("network", String(P));
+    }
+    clearTimeout(o);
+    const m = await l.json().catch(() => ({}));
+    if (l.ok) return m;
+    throw new p(Ie(l.status), je(m) || `HTTP ${l.status}`);
+  }
+}
+function Ie(t) {
+  switch (t) {
+    case 401:
+      return "session_invalid";
+    case 409:
+      return "already_passed";
+    case 410:
+      return "session_expired";
+    case 413:
+      return "recording_too_large";
+    case 422:
+      return "recording_rejected";
+    case 429:
+      return "attempts_exhausted";
+    case 503:
+      return "service_unavailable";
+    default:
+      return "server_error";
+  }
+}
+function je(t) {
+  const e = t?.detail;
+  return e && typeof e == "object" && "error" in e ? String(e.error) : typeof e == "string" ? e : null;
+}
+const $e = { interrupted: "interrupted", wrong_direction: "wrongDirection", face_lost: "faceLost", multiple_faces: "multipleFaces", too_slow: "tooSlow" }, qe = { camera_denied: "cameraDenied", camera_unavailable: "cameraUnavailable", unsupported_browser: "unsupportedBrowser", insecure_context: "insecureContext", network: "network", session_expired: "sessionExpired", session_invalid: "sessionExpired", service_unavailable: "serviceUnavailable", attempts_exhausted: "noAttemptsDetail" };
+class ze {
+  constructor(e) {
+    if (this.config = e, this.view = null, this.stream = null, this.tracker = null, this.cancelled = !1, this.running = !1, this.wakeOnCancel = null, !e.baseUrl) throw new Error("PowerCredLiveness: baseUrl is required");
+    if (!e.session && !e.sessionProvider) throw new Error("PowerCredLiveness: pass session or sessionProvider");
+    this.strings = { ...oe, ...e.strings || {} };
+  }
+  async start(e) {
+    if (this.running) throw new Error("PowerCredLiveness: already running");
+    this.running = !0, this.cancelled = !1;
+    const s = this.strings, i = this.view = new ce(this.config.theme);
+    i.mount(e), i.setPrompt(s.gettingReady);
+    let n = null, a = null;
+    try {
+      if (n = this.config.session ?? await this.config.sessionProvider(), Date.parse(n.expires_at) < Date.now()) throw new p("session_expired");
+      const r = n.client_checks === "none" ? "none" : "device", o = r === "device" ? I.create(this.config.assetsUrl).catch(() => null) : Promise.resolve(null);
+      this.stream = await K(), await i.attach(this.stream), this.emit({ type: "camera_ready" }), this.tracker = await o;
+      let l = r === "device" && this.tracker ? "device" : "none", m = r === "device" && !this.tracker ? "model_unavailable" : null;
+      this.emit({ type: "mode", mode: l, fallbackReason: m });
+      const P = this.config.maxLocalRetries ?? 2;
+      let M = 0;
+      for (; ; ) {
+        const c = await Le({ session: n, view: i, strings: s, stream: this.stream, tracker: l === "device" ? this.tracker : null, mode: l, fallbackReason: m, allowFlash: this.config.flash !== !1, timedWindowMs: Math.round((this.config.timedWindowSeconds ?? 3.5) * 1e3), debug: !1, emit: (d) => this.emit(d), isCancelled: () => this.cancelled });
+        if (c.kind === "fallback") {
+          this.tracker?.close(), this.tracker = null, l = "none", m = c.reason, this.emit({ type: "mode", mode: l, fallbackReason: m });
+          continue;
+        }
+        if (a = { mode: l, fallbackReason: m, passedChallenges: c.kind === "recorded" ? c.passedChallenges : [] }, c.kind === "aborted") {
+          this.emit({ type: "attempt_aborted", reason: c.reason }), c.reason !== "interrupted" && M++;
+          const d = s[$e[c.reason] ?? "timeUp"];
+          if (M > P) return this.config.showResult !== !1 && await i.showPanel("bad", s.failedTitle, s.failedDetail), this.finish({ status: "failed", livenessSessionId: n.liveness_session_id, device: a, reason: c.reason });
+          await this.untilCancelled(i.showPanel("bad", d, "", s.tryAgain)), i.hidePanel(), await this.ensureCamera(i);
+          continue;
+        }
+        const C = c.stills[c.stills.length - 1], E = () => We(this.config.baseUrl, n, c);
+        if (this.emit({ type: "uploading", bytes: c.video.size }), this.config.waitForServer === !1) {
+          const d = n.liveness_session_id;
+          return E().then((f) => this.serverResult(f), (f) => this.emit({ type: "error", code: te(f), message: se(f) })), this.config.showResult !== !1 && await i.showPanel("ok", s.submittedTitle), this.finish({ status: "submitted", livenessSessionId: d, device: a, selfie: C });
+        }
+        await i.showPanel("working", s.checking);
+        const u = await E();
+        if (this.serverResult(u), u.status === "passed") return this.config.showResult !== !1 && await i.showPanel("ok", s.passedTitle, s.passedDetail), this.finish({ status: "passed", livenessSessionId: u.liveness_session_id, attempt: u.attempt, device: a, server: u, retryAllowed: !1, selfie: C });
+        if (u.retry_allowed) {
+          await this.untilCancelled(i.showPanel("bad", s.failedTitle, s.failedDetail, s.tryAgain)), i.hidePanel(), await this.ensureCamera(i);
+          continue;
+        }
+        return this.config.showResult !== !1 && await i.showPanel("bad", s.failedTitle, s.noAttemptsDetail), this.finish({ status: u.status === "inconclusive" ? "inconclusive" : "failed", livenessSessionId: u.liveness_session_id, attempt: u.attempt, device: a, server: u, retryAllowed: !1, selfie: C });
+      }
+    } catch (r) {
+      if (r instanceof A) return this.finish({ status: "cancelled", livenessSessionId: n?.liveness_session_id ?? null, device: a, reason: "cancelled" });
+      const o = te(r);
+      this.emit({ type: "error", code: o, message: se(r) });
+      const l = s[qe[o] ?? "genericError"];
+      return this.config.showResult !== !1 && await i.showPanel("bad", l), this.finish({ status: "error", livenessSessionId: n?.liveness_session_id ?? null, device: a, reason: o });
+    }
+  }
+  async ensureCamera(e) {
+    this.stream?.getVideoTracks().some((s) => s.readyState === "live") || (Q(this.stream), this.stream = await K(), await e.attach(this.stream));
+  }
+  cancel() {
+    this.cancelled = !0, this.wakeOnCancel?.();
+  }
+  untilCancelled(e) {
+    return new Promise((s, i) => {
+      if (this.cancelled) return i(new A());
+      this.wakeOnCancel = () => i(new A()), e.then(() => {
+        this.wakeOnCancel = null, s();
+      });
+    });
+  }
+  destroy() {
+    this.cancel(), this.release(), this.view?.unmount(), this.view = null;
+  }
+  finish(e) {
+    return this.release(), this.running = !1, e;
+  }
+  release() {
+    Q(this.stream), this.stream = null, this.tracker?.close(), this.tracker = null;
+  }
+  serverResult(e) {
+    this.emit({ type: "server_result", result: e });
+    try {
+      this.config.onServerResult?.(e);
+    } catch {
+    }
+  }
+  emit(e) {
+    try {
+      this.config.onEvent?.(e);
+    } catch {
+    }
+  }
+}
+function te(t) {
+  return t instanceof p ? t.code : "unexpected";
+}
+function se(t) {
+  return t instanceof p ? t.message : "Unexpected error";
+}
+const Be = "0.1.1";
+export {
+  ze as PowerCredLiveness,
+  Be as VERSION,
+  oe as defaultStrings
+};

package/dist/sdk.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PowerCredLiveness: mounts the check into a container, runs it, uploads, and resolves with the
+ * outcome. The server's verdict is the only one that counts; the device's checks only guide the
+ * user and catch problems early.
+ */
+import type { LivenessConfig, LivenessResult } from './types';
+export declare class PowerCredLiveness {
+    private readonly config;
+    private view;
+    private stream;
+    private tracker;
+    private cancelled;
+    private running;
+    private wakeOnCancel;
+    private readonly strings;
+    constructor(config: LivenessConfig);
+    /** Runs the check inside `container`. Resolves once; never rejects for user-facing problems. */
+    start(container: HTMLElement): Promise<LivenessResult>;
+    /** Phones often stop the camera while the browser is in the background: reopen it if so. */
+    private ensureCamera;
+    /** Stops a running check (also while it waits on a "Try again" button); start() then resolves "cancelled". */
+    cancel(): void;
+    /** Waits for a user action, unless the host cancels first. */
+    private untilCancelled;
+    /** Releases the camera and removes the UI. */
+    destroy(): void;
+    private finish;
+    private release;
+    private serverResult;
+    private emit;
+}