@powercred/liveness-web 0.0.0-stage → 0.1.0

package/dist/liveness.js

@@ -0,0 +1,630 @@
+const ee = { 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", 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." }, te = `
+: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 se {
+  constructor(e = {}) {
+    this.host = document.createElement("div");
+    const s = this.host.attachShadow({ mode: "open" });
+    s.innerHTML = `<style>${te}</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 o = this.panel.querySelector("button");
+    return o.textContent = n, o.focus(), new Promise((r) => o.addEventListener("click", () => r(), { once: !0 }));
+  }
+  hidePanel() {
+    this.panel.hidden = !0, this.panel.innerHTML = "";
+  }
+}
+const ie = { runtime: "liveness-runtime", runtimeCompat: "liveness-runtime-compat", model: "liveness-face.bin" }, ne = import.meta.url, ae = "assets/";
+function oe(t) {
+  const e = new URL(t || ae, t ? document.baseURI : ne).href;
+  return e.endsWith("/") ? e : e + "/";
+}
+class L extends Error {
+}
+class O {
+  constructor(e) {
+    this.engine = e, this.lastTs = 0, this.inferenceMs = [];
+  }
+  static async create(e, s = 2e4) {
+    const i = oe(e), n = import("./liveness-device-C5ygqTPx.js").then((o) => o.createEngine(i, ie));
+    let a;
+    try {
+      const o = await Promise.race([n, new Promise((r, l) => {
+        a = setTimeout(() => l(new L("face tracker load timed out")), s);
+      })]);
+      return new O(o);
+    } catch (o) {
+      throw n.then((r) => r.close(), () => {
+      }), o instanceof L ? o : new L(String(o));
+    } 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 P(t) {
+  return t.faceCount >= 1 && t.yaw !== void 0;
+}
+class re {
+  constructor(e = 0.5) {
+    this.alpha = e;
+  }
+  apply(e) {
+    return P(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 le(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 f = { 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 A {
+  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 z {
+  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 A(f.poseHoldMs), this.opposite = new A(f.poseHoldMs);
+  }
+  feed(e) {
+    if (this.passedAt !== null) return "passed";
+    if (this.start === null && (this.start = e.t), !P(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 < f.baselineMs) return "pending";
+      this.baseline = le(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: R(this.extreme) } : { pitch: R(this.extreme) };
+  }
+  get confidence() {
+    return U(Math.abs(this.extreme) / (this.threshold * 1.5));
+  }
+}
+class q {
+  constructor(e, s) {
+    this.attr = e, this.threshold = s, this.passedAt = null, this.highest = 0, this.hold = new A(f.expressionHoldMs);
+  }
+  feed(e) {
+    if (this.passedAt !== null) return "passed";
+    const s = P(e) ? e[this.attr] ?? 0 : 0;
+    return this.highest = Math.max(this.highest, s), this.hold.update(e.t, P(e) && s >= this.threshold) ? (this.passedAt = e.t, "passed") : "pending";
+  }
+  get peak() {
+    return { score: R(this.highest, 3) };
+  }
+  get confidence() {
+    return U(this.highest);
+  }
+}
+class ce {
+  constructor() {
+    this.passedAt = null, this.closedAt = null, this.highest = 0;
+  }
+  feed(e) {
+    if (this.passedAt !== null) return "passed";
+    if (!P(e)) return "pending";
+    if (this.highest = Math.max(this.highest, e.blink), e.blink >= f.blinkClosed) this.closedAt === null && (this.closedAt = e.t);
+    else if (this.closedAt !== null) {
+      if (e.t - this.closedAt > f.blinkMaxMs) this.closedAt = null;
+      else if (e.blink <= f.blinkOpen) return this.passedAt = this.closedAt, "passed";
+    }
+    return "pending";
+  }
+  get peak() {
+    return { score: R(this.highest, 3) };
+  }
+  get confidence() {
+    return U(this.highest);
+  }
+}
+function B(t, e) {
+  switch (t) {
+    case "turn_head":
+      return new z("yaw", e === "left", f.turnHeadDeg);
+    case "nod":
+      return new z("pitch", e === "up", f.nodDeg);
+    case "smile":
+      return new q("smile", f.smile);
+    case "open_mouth":
+      return new q("jawOpen", f.jawOpen);
+    case "blink":
+      return new ce();
+  }
+}
+const x = { holdMs: 800, center: 0.1, minHeight: 0.35, maxHeight: 0.7, maxAngle: 12 };
+function de(t) {
+  return t.faceCount > 1 ? "multiple_faces" : P(t) ? t.boxHeight < x.minHeight ? "move_closer" : t.boxHeight > x.maxHeight ? "move_back" : Math.abs(t.centerX - 0.5) > x.center || Math.abs(t.centerY - 0.5) > x.center ? "center" : Math.abs(t.yaw) > x.maxAngle || Math.abs(t.pitch) > x.maxAngle ? "look_straight" : "ok" : "no_face";
+}
+class he {
+  constructor() {
+    this.hold = new A(x.holdMs);
+  }
+  feed(e) {
+    const s = de(e);
+    return { hint: s, ready: this.hold.update(e.t, s === "ok") };
+  }
+}
+function N(t) {
+  return P(t) && t.faceCount === 1 && Math.abs(t.yaw) < 10 && Math.abs(t.pitch) < 10 && t.blink < 0.3;
+}
+class ue {
+  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 U(t) {
+  return Math.max(0, Math.min(1, t));
+}
+function R(t, e = 1) {
+  const s = 10 ** e;
+  return Math.round(t * s) / s;
+}
+const pe = "liveness-web", me = "0.1.0";
+function fe(t) {
+  const e = navigator.userAgent, s = navigator.userAgentData;
+  return { schema_version: 1, liveness_session_id: t.session.liveness_session_id, sdk: { name: pe, version: me }, 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 we() {
+  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 ge(t) {
+  t?.getTracks().forEach((e) => e.stop());
+}
+function ve(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 be {
+  constructor(e, s = 12e5) {
+    this.chunks = [], this.t0 = 0, this.epoch = 0;
+    const i = ve();
+    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 ye(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 o = 0.9;
+  for (; ; ) {
+    const r = await new Promise((l) => a.toBlob(l, "image/jpeg", o));
+    if (!r) throw new p("capture_failed");
+    if (r.size <= e || o <= 0.45) return r;
+    o -= 0.1;
+  }
+}
+const M = (t) => new Promise((e) => setTimeout(e, t)), V = () => new Promise((t) => requestAnimationFrame(t)), ke = 120, _e = 700, xe = 400, Me = 1e3, Pe = 5e3, Ce = 2200;
+class C extends Error {
+}
+function H(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 Te(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 Se(t) {
+  const { session: e, view: s, strings: i } = t, n = t.mode === "device" && t.tracker !== null, a = new re(), o = { framesTotal: 0, framesWithFace: 0, framesWithTwoFaces: 0 };
+  let r = null;
+  const l = () => {
+    if (t.isCancelled()) throw new C();
+  }, w = () => new Promise((h) => {
+    const d = s.video;
+    d.requestVideoFrameCallback ? d.requestVideoFrameCallback(() => h()) : requestAnimationFrame(() => h()), setTimeout(h, 250);
+  }), b = async (h, d) => {
+    await w(), l();
+    const m = a.apply(t.tracker.detect(s.video, h));
+    return d && (o.framesTotal++, m.faceCount >= 1 && o.framesWithFace++, m.faceCount >= 2 && o.framesWithTwoFaces++), m;
+  };
+  try {
+    let h = null;
+    if (n) {
+      const v = new he(), y = performance.now();
+      let c = 0;
+      for (; ; ) {
+        h = await b(performance.now() - y, !1), c++;
+        const S = t.tracker.medianInferenceMs();
+        if (c >= 15 && S !== null && S > ke) return { kind: "fallback", reason: "slow_device" };
+        const { hint: _, ready: E } = v.feed(h);
+        if (s.setPrompt(Te(_, i)), s.setOval(_ === "ok" ? "ok" : "warn"), E) break;
+      }
+    }
+    r = new be(t.stream), await r.start(), t.emit({ type: "recording_started" });
+    const d = e.limits.max_video_seconds * 1e3, m = [], T = [], u = async (v) => {
+      T.push({ index: m.length, captured_at_ms: r.now(), reason: v }), m.push(await ye(s.video, e.limits.max_still_bytes));
+    };
+    if (n) {
+      const v = performance.now() + 1e3;
+      for (; h && !N(h) && performance.now() < v; ) h = await b(r.now(), !0);
+      await u("positioning");
+    } else s.setOval("idle"), s.setPrompt(i.lookStraight), await M(1500), l(), await u("positioning");
+    const g = [], k = [], D = e.challenges.length;
+    if (e.mode === "active") {
+      const v = new ue();
+      for (const [y, c] of e.challenges.entries()) {
+        s.setProgress(D, y, y), s.setPrompt(H(c, i)), s.setOval("idle"), t.emit({ type: "challenge_started", challenge: c });
+        const S = r.now();
+        if (n) {
+          let _ = B(c.type, c.direction), E = 1, W = performance.now();
+          for (; ; ) {
+            const I = await b(r.now(), !0), j = v.feed(I);
+            if (j) return { kind: "aborted", reason: j };
+            if (r.now() > d - Pe) return { kind: "aborted", reason: "too_slow" };
+            const $ = _.feed(I);
+            if ($ === "wrong_direction") return { kind: "aborted", reason: "wrong_direction" };
+            if ($ === "passed") {
+              g.push({ order: c.order, type: c.type, direction: c.direction, start_ms: S, end_ms: r.now(), passed: !0, confidence: Ae(_.confidence), timed_out: E > 1, peak: _.peak }), k.push(c.type), s.setOval("ok"), s.setPrompt(i.great), s.setProgress(D, y + 1, null), t.emit({ type: "challenge_passed", challenge: c }), await M(xe);
+              break;
+            }
+            if (performance.now() - W > c.timeout_ms) {
+              if (E > 1) return { kind: "aborted", reason: `challenge_timeout:${c.type}` };
+              E = 2, _ = B(c.type, c.direction), W = performance.now(), s.setPrompt(H(c, i));
+            }
+          }
+        } else await G(s, t, t.timedWindowMs, H(c, i)), g.push({ order: c.order, type: c.type, direction: c.direction, start_ms: S, end_ms: r.now(), passed: null, confidence: null, timed_out: !1, peak: null }), s.setProgress(D, y + 1, null), s.setPrompt(i.lookStraight), await M(_e), l();
+      }
+    } else await G(s, t, Ce, i.holdStill);
+    const Y = await Ee(t, r);
+    if (s.setFlash(null), s.setPrompt(i.lookStraight), n) {
+      const v = performance.now() + 2e3;
+      for (; ; ) {
+        const y = await b(r.now(), !0);
+        if (N(y) || performance.now() > v) break;
+      }
+    } else await M(1500), l();
+    await u("return_to_centre");
+    const K = r.now(), Q = r.epoch, F = await r.stop();
+    if (r = null, F.size > e.limits.max_video_bytes) throw new p("recording_too_large");
+    const Z = fe({ session: e, mode: t.mode, fallbackReason: t.fallbackReason, camera: t.stream.getVideoTracks()[0]?.getSettings() ?? {}, video: { mime: F.type, durationMs: K, startedAtEpochMs: Q }, challenges: g, flash: Y, stills: T, tally: o });
+    return { kind: "recorded", video: F, stills: m, metadata: Z, passedChallenges: k };
+  } finally {
+    r?.abort(), s.setFlash(null), s.setCountdown(null), s.setDebug(null);
+  }
+}
+async function G(t, e, s, i) {
+  t.setPrompt(i);
+  const n = performance.now() + s;
+  for (; performance.now() < n; ) {
+    if (e.isCancelled()) throw new C();
+    t.setCountdown(Math.ceil((n - performance.now()) / 1e3)), await M(100);
+  }
+  t.setCountdown(null);
+}
+async function Ee(t, e) {
+  const s = t.session.flash, i = { enabled: !1, started_at_ms: null, segments: [], screen_brightness: null, exposure_locked: !1, skipped_reason: null };
+  if (!s.enabled) return i;
+  if (!t.allowFlash) return { ...i, skipped_reason: "disabled_by_host" };
+  if (window.matchMedia?.("(prefers-reduced-motion: reduce)").matches) return { ...i, skipped_reason: "reduced_motion" };
+  if (t.emit({ type: "flash_started" }), t.view.setFlash("#000000"), t.view.setPrompt(t.strings.flashIntro), await M(Me), t.isCancelled()) throw new C();
+  t.view.setPrompt(""), i.enabled = !0;
+  for (const n of s.segments) {
+    await V(), t.view.setFlash(n.color);
+    const a = await V(), o = Math.round(a - e.t0);
+    i.started_at_ms === null && (i.started_at_ms = o), await M(Math.max(0, n.duration_ms - (performance.now() - a))), i.segments.push({ color: n.color, start_ms: o, end_ms: e.now() });
+  }
+  return t.view.setFlash(null), t.emit({ type: "flash_ended" }), i;
+}
+function Ae(t) {
+  return Math.round(t * 100) / 100;
+}
+const Re = 6e4;
+async function De(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, o) => i.append("stills", a, `${o}.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 o = new AbortController(), r = setTimeout(() => o.abort(), Re);
+    let l;
+    try {
+      l = await fetch(n, { method: "POST", body: i, signal: o.signal });
+    } catch (b) {
+      if (clearTimeout(r), a < 2) continue;
+      throw new p("network", String(b));
+    }
+    clearTimeout(r);
+    const w = await l.json().catch(() => ({}));
+    if (l.ok) return w;
+    throw new p(Fe(l.status), Le(w) || `HTTP ${l.status}`);
+  }
+}
+function Fe(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 Le(t) {
+  const e = t?.detail;
+  return e && typeof e == "object" && "error" in e ? String(e.error) : typeof e == "string" ? e : null;
+}
+const He = { wrong_direction: "wrongDirection", face_lost: "faceLost", multiple_faces: "multipleFaces", too_slow: "tooSlow" }, Oe = { 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 Ue {
+  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 = { ...ee, ...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 se(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 o = n.client_checks === "none" ? "none" : "device", r = o === "device" ? O.create(this.config.assetsUrl).catch(() => null) : Promise.resolve(null);
+      this.stream = await we(), await i.attach(this.stream), this.emit({ type: "camera_ready" }), this.tracker = await r;
+      let l = o === "device" && this.tracker ? "device" : "none", w = o === "device" && !this.tracker ? "model_unavailable" : null;
+      this.emit({ type: "mode", mode: l, fallbackReason: w });
+      const b = this.config.maxLocalRetries ?? 2;
+      let h = 0;
+      for (; ; ) {
+        const d = await Se({ session: n, view: i, strings: s, stream: this.stream, tracker: l === "device" ? this.tracker : null, mode: l, fallbackReason: w, allowFlash: this.config.flash !== !1, timedWindowMs: Math.round((this.config.timedWindowSeconds ?? 3.5) * 1e3), debug: !1, emit: (g) => this.emit(g), isCancelled: () => this.cancelled });
+        if (d.kind === "fallback") {
+          this.tracker?.close(), this.tracker = null, l = "none", w = d.reason, this.emit({ type: "mode", mode: l, fallbackReason: w });
+          continue;
+        }
+        if (a = { mode: l, fallbackReason: w, passedChallenges: d.kind === "recorded" ? d.passedChallenges : [] }, d.kind === "aborted") {
+          this.emit({ type: "attempt_aborted", reason: d.reason }), h++;
+          const g = s[He[d.reason] ?? "timeUp"];
+          if (h > b) 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: d.reason });
+          await this.untilCancelled(i.showPanel("bad", g, "", s.tryAgain)), i.hidePanel();
+          continue;
+        }
+        const m = d.stills[d.stills.length - 1], T = () => De(this.config.baseUrl, n, d);
+        if (this.emit({ type: "uploading", bytes: d.video.size }), this.config.waitForServer === !1) {
+          const g = n.liveness_session_id;
+          return T().then((k) => this.serverResult(k), (k) => this.emit({ type: "error", code: X(k), message: J(k) })), this.config.showResult !== !1 && await i.showPanel("ok", s.submittedTitle), this.finish({ status: "submitted", livenessSessionId: g, device: a, selfie: m });
+        }
+        await i.showPanel("working", s.checking);
+        const u = await T();
+        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: m });
+        if (u.retry_allowed) {
+          await this.untilCancelled(i.showPanel("bad", s.failedTitle, s.failedDetail, s.tryAgain)), i.hidePanel();
+          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: m });
+      }
+    } catch (o) {
+      if (o instanceof C) return this.finish({ status: "cancelled", livenessSessionId: n?.liveness_session_id ?? null, device: a, reason: "cancelled" });
+      const r = X(o);
+      this.emit({ type: "error", code: r, message: J(o) });
+      const l = s[Oe[r] ?? "genericError"];
+      return this.config.showResult !== !1 && await i.showPanel("bad", l), this.finish({ status: "error", livenessSessionId: n?.liveness_session_id ?? null, device: a, reason: r });
+    }
+  }
+  cancel() {
+    this.cancelled = !0, this.wakeOnCancel?.();
+  }
+  untilCancelled(e) {
+    return new Promise((s, i) => {
+      if (this.cancelled) return i(new C());
+      this.wakeOnCancel = () => i(new C()), 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() {
+    ge(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 X(t) {
+  return t instanceof p ? t.code : "unexpected";
+}
+function J(t) {
+  return t instanceof p ? t.message : "Unexpected error";
+}
+const We = "0.1.0";
+export {
+  Ue as PowerCredLiveness,
+  We as VERSION,
+  ee as defaultStrings
+};

package/dist/sdk.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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>;
+    /** 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;
+}