feedbackkit-web 1.0.37 → 1.0.38

package/dist/feedbackkit.js

@@ -307,9 +307,9 @@ class LogBuffer {
     this.entries = [];
   }
   push(level, message) {
-    let text = redactMessage(message);
-    if (text.length > MAX_MESSAGE_LENGTH) text = `${text.slice(0, MAX_MESSAGE_LENGTH)}… [truncated]`;
-    this.entries.push({ level, message: text, timestamp: (/* @__PURE__ */ new Date()).toISOString() });
+    let text2 = redactMessage(message);
+    if (text2.length > MAX_MESSAGE_LENGTH) text2 = `${text2.slice(0, MAX_MESSAGE_LENGTH)}… [truncated]`;
+    this.entries.push({ level, message: text2, timestamp: (/* @__PURE__ */ new Date()).toISOString() });
     if (this.entries.length > this.maxEntries) this.entries.splice(0, this.entries.length - this.maxEntries);
   }
   snapshot() {
@@ -433,7 +433,7 @@ async function blobToBase64(blob) {
   }
   return btoa(binary);
 }
-async function encodePayload(report, projectKey) {
+async function encodePayload(report, projectKey, identity = {}) {
   const payload = {
     project_key: projectKey,
     id: report.id,
@@ -465,13 +465,15 @@ async function encodePayload(report, projectKey) {
     }));
   }
   if (report.logs.length > 0) payload.logs = report.logs;
+  if (identity.reporterId) payload.reporter_id = identity.reporterId;
+  if (identity.user) payload.reporter = identity.user;
   return payload;
 }
-async function submitReport(report, configuration2) {
+async function submitReport(report, configuration2, identity = {}) {
   if (!configuration2.projectKey) {
     throw new FeedbackSubmissionError("FeedbackKit is not configured with a project key.", "not_configured");
   }
-  const body = JSON.stringify(await encodePayload(report, configuration2.projectKey));
+  const body = JSON.stringify(await encodePayload(report, configuration2.projectKey, identity));
   let response;
   try {
     response = await fetch(configuration2.endpoint ?? DEFAULT_ENDPOINT, {
@@ -510,6 +512,246 @@ async function fetchProducts(configuration2) {
     isDefault: p.is_default ?? false
   }));
 }
+function compareBuilds(a, b) {
+  if (a == null || b == null || a === "" || b === "") return null;
+  if (a === b) return 0;
+  const numeric = /^[0-9]+(\.[0-9]+)*$/;
+  if (!numeric.test(a) || !numeric.test(b)) return null;
+  const pa = a.split(".");
+  const pb = b.split(".");
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = BigInt(pa[i] ?? "0");
+    const nb = BigInt(pb[i] ?? "0");
+    if (na < nb) return -1;
+    if (na > nb) return 1;
+  }
+  return 0;
+}
+const STORAGE_KEY = "feedbackkit.reporterId";
+const VALID_ID = /^[A-Za-z0-9_-]{16,128}$/;
+let memoryId = null;
+let currentUser = null;
+function freshId() {
+  const bytes = new Uint8Array(16);
+  crypto.getRandomValues(bytes);
+  return [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function reporterId() {
+  if (memoryId) return memoryId;
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (stored && VALID_ID.test(stored)) return memoryId = stored;
+    const id = freshId();
+    localStorage.setItem(STORAGE_KEY, id);
+    return memoryId = id;
+  } catch {
+    return memoryId = freshId();
+  }
+}
+function setUser(user) {
+  currentUser = user && (user.id || user.email || user.name) ? { ...user } : null;
+}
+function getUser() {
+  return currentUser;
+}
+function reporterUpdatesEndpoint(configuration2) {
+  if (configuration2.reporterUpdatesEndpoint) return configuration2.reporterUpdatesEndpoint;
+  const url = new URL(configuration2.endpoint ?? DEFAULT_ENDPOINT);
+  url.pathname = url.pathname.replace(/\/[^/]*\/?$/, "/reporter-updates");
+  url.search = "";
+  return url.toString();
+}
+function decodeUpdate(w) {
+  return {
+    feedbackId: w.feedback_id,
+    text: w.text ?? "",
+    createdAt: w.created_at ?? "",
+    screenName: w.screen_name ?? null,
+    fixStage: w.fix_stage ?? null,
+    fixedInBuild: w.fixed_in_build ?? null,
+    fixSummary: w.fix_summary ?? null,
+    needsVerification: w.needs_verification ?? false,
+    openQuestion: w.open_question ? { id: w.open_question.id, body: w.open_question.body, createdAt: w.open_question.created_at } : null,
+    screenshotUrl: w.screenshot_url ?? null,
+    messages: (w.messages ?? []).map((m) => ({ id: m.id, kind: m.kind, body: m.body, author: m.author, createdAt: m.created_at }))
+  };
+}
+async function fetchFixUpdates(configuration2) {
+  const url = new URL(reporterUpdatesEndpoint(configuration2));
+  url.searchParams.set("project_key", configuration2.projectKey);
+  url.searchParams.set("reporter_id", reporterId());
+  if (configuration2.appBuild) url.searchParams.set("build", configuration2.appBuild);
+  let response;
+  try {
+    response = await fetch(url.toString());
+  } catch (error) {
+    throw new FeedbackSubmissionError(`Network error: ${error instanceof Error ? error.message : String(error)}`, "network");
+  }
+  if (!response.ok) throw new FeedbackSubmissionError(`HTTP ${response.status}`, "server", response.status);
+  const json = await response.json();
+  return (json.updates ?? []).map(decodeUpdate);
+}
+async function encodeFixAction(configuration2, feedbackId, action) {
+  const body = {
+    project_key: configuration2.projectKey,
+    reporter_id: reporterId(),
+    feedback_id: feedbackId,
+    action: action.type
+  };
+  if (configuration2.appBuild) body.build = configuration2.appBuild;
+  if (action.type === "reply") body.text = action.text;
+  if (action.type === "reopen") {
+    const report = action.report;
+    const text2 = report?.text ?? action.text;
+    if (text2) body.text = text2;
+    if (report?.screenshotAnnotated) {
+      body.screenshot_annotated_png_base64 = await blobToBase64(report.screenshotAnnotated);
+      if (report.screenshotRaw) body.screenshot_raw_png_base64 = await blobToBase64(report.screenshotRaw);
+      body.annotations = report.annotations;
+    }
+  }
+  return body;
+}
+async function sendFixAction(configuration2, feedbackId, action) {
+  const body = JSON.stringify(await encodeFixAction(configuration2, feedbackId, action));
+  let response;
+  try {
+    response = await fetch(reporterUpdatesEndpoint(configuration2), {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body
+    });
+  } catch (error) {
+    throw new FeedbackSubmissionError(`Network error: ${error instanceof Error ? error.message : String(error)}`, "network");
+  }
+  if (!response.ok) throw new FeedbackSubmissionError(`HTTP ${response.status}`, "server", response.status);
+}
+const svg = (body) => `<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
+const icons = {
+  feedback: svg(
+    '<path d="M21 12a8 8 0 0 1-11.6 7.1L4 20l1-4.6A8 8 0 1 1 21 12Z"/><path d="M8.5 10.5h7M8.5 14h4.5"/>'
+  ),
+  pen: svg('<path d="M4 20l4-1L19 8a2.1 2.1 0 0 0-3-3L5 16l-1 4Z"/><path d="M14.5 6.5l3 3"/>'),
+  rectangle: svg('<rect x="4" y="6" width="16" height="12" rx="1.5"/>'),
+  arrow: svg('<path d="M6 18L18 6"/><path d="M9 6h9v9"/>'),
+  text: svg('<path d="M5 6V5h14v1"/><path d="M12 5v14"/><path d="M9 19h6"/>'),
+  move: svg(
+    '<path d="M12 3v18M3 12h18"/><path d="M9 6l3-3 3 3M9 18l3 3 3-3M6 9l-3 3 3 3M18 9l3 3-3 3"/>'
+  ),
+  undo: svg('<path d="M9 14L4 9l5-5"/><path d="M4 9h10.5a5.5 5.5 0 0 1 0 11H11"/>'),
+  trash: svg('<path d="M4 7h16"/><path d="M10 11v6M14 11v6"/><path d="M6 7l1 13h10l1-13"/><path d="M9 7V4h6v3"/>'),
+  close: svg('<path d="M6 6l12 12M18 6L6 18"/>'),
+  paperclip: svg(
+    '<path d="M21 11.5l-8.6 8.6a5.5 5.5 0 0 1-7.8-7.8l8.6-8.6a3.7 3.7 0 0 1 5.2 5.2l-8.6 8.6a1.8 1.8 0 0 1-2.6-2.6l7.9-7.9"/>'
+  ),
+  send: svg('<path d="M4 12l16-8-6 16-3-7-7-1Z"/>'),
+  check: svg('<path d="M5 12.5l4.5 4.5L19 7.5"/>')
+};
+class FixCard {
+  constructor(shadow, update, onOutcome) {
+    this.shadow = shadow;
+    this.update = update;
+    this.onOutcome = onOutcome;
+    this.root = null;
+    this.settled = false;
+  }
+  show(position) {
+    const u = this.update;
+    const card = el$1("section", "fk-fixcard");
+    card.dataset.position = position;
+    card.setAttribute("role", "dialog");
+    card.setAttribute("aria-labelledby", "fk-fixcard-title");
+    const header = el$1("div", "fk-fixcard-header");
+    const title = el$1("h2", "fk-title");
+    title.id = "fk-fixcard-title";
+    title.textContent = u.needsVerification ? "We fixed something you reported" : "A question about your report";
+    const close = document.createElement("button");
+    close.type = "button";
+    close.className = "fk-close";
+    close.innerHTML = icons.close;
+    close.setAttribute("aria-label", "Remind me later");
+    close.title = "Remind me later";
+    close.addEventListener("click", () => this.settle({ type: "later" }));
+    header.append(title, close);
+    card.append(header);
+    if (u.needsVerification && u.fixedInBuild) {
+      card.append(text("p", "fk-meta", `Fixed in build ${u.fixedInBuild}.`));
+    }
+    if (u.screenshotUrl) {
+      const img = document.createElement("img");
+      img.className = "fk-fixcard-shot";
+      img.alt = "Your screenshot from the original report";
+      img.src = u.screenshotUrl;
+      img.addEventListener("error", () => img.remove());
+      card.append(img);
+    }
+    card.append(text("p", "fk-meta", "You reported"));
+    card.append(text("p", "fk-fixcard-quote", u.text ? `“${u.text}”` : "(no description)"));
+    if (u.needsVerification && u.fixSummary) {
+      card.append(text("p", "fk-fixcard-summary", `What changed: ${u.fixSummary}`));
+    }
+    for (const m of u.messages.filter((m2) => m2.kind === "comment")) {
+      const msg = el$1("div", "fk-fixcard-message");
+      msg.append(text("span", "fk-meta", m.author), text("p", "", m.body));
+      card.append(msg);
+    }
+    const actions = el$1("div", "fk-fixcard-actions");
+    if (u.needsVerification) {
+      const yes = button("fk-btn fk-btn-primary", "Yes, it's fixed");
+      yes.addEventListener("click", () => this.settle({ type: "verified" }));
+      const no = button("fk-btn fk-btn-secondary", "No, still broken");
+      no.addEventListener("click", () => this.settle({ type: "stillBroken" }));
+      actions.append(yes, no);
+    } else if (u.openQuestion) {
+      actions.append(text("p", "fk-fixcard-question", u.openQuestion.body));
+      const input = document.createElement("textarea");
+      input.className = "fk-textarea";
+      input.placeholder = "Your answer";
+      input.setAttribute("aria-label", "Your answer");
+      const send = button("fk-btn fk-btn-primary", "Send");
+      send.disabled = true;
+      input.addEventListener("input", () => send.disabled = input.value.trim() === "");
+      send.addEventListener("click", () => this.settle({ type: "replied", text: input.value.trim() }));
+      actions.append(input, send);
+    }
+    card.append(actions);
+    this.root = card;
+    this.shadow.append(card);
+  }
+  /** Close as "later" (e.g. `FeedbackKit.disableFixVerification()`). */
+  dismiss() {
+    this.settle({ type: "later" });
+  }
+  /** Remove without reporting an outcome (the widget is being destroyed). */
+  remove() {
+    this.settled = true;
+    this.root?.remove();
+    this.root = null;
+  }
+  settle(outcome) {
+    if (this.settled) return;
+    this.settled = true;
+    this.root?.remove();
+    this.root = null;
+    this.onOutcome(outcome);
+  }
+}
+function el$1(tag, className) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  return node;
+}
+function text(tag, className, content) {
+  const node = el$1(tag, className);
+  node.textContent = content;
+  return node;
+}
+function button(className, label) {
+  const b = el$1("button", className);
+  b.type = "button";
+  b.textContent = label;
+  return b;
+}
 const STROKE_WIDTH = 4;
 const HIT_TEST_TOLERANCE = 16;
 const HEAD_LENGTH = 18;
@@ -628,8 +870,8 @@ function arrowGeometry(rawStart, rawEnd, scale = 1, rotation = 0) {
   };
   return { start, end, left, right };
 }
-function drawText(ctx, text, point, color, scale) {
-  const rect = textBubbleRect(ctx, text, point, scale);
+function drawText(ctx, text2, point, color, scale) {
+  const rect = textBubbleRect(ctx, text2, point, scale);
   ctx.save();
   ctx.fillStyle = color;
   ctx.beginPath();
@@ -638,7 +880,7 @@ function drawText(ctx, text, point, color, scale) {
   ctx.font = textFont(scale);
   ctx.fillStyle = "#FFFFFF";
   ctx.textBaseline = "top";
-  ctx.fillText(text, rect.x + TEXT_PADDING, rect.y + TEXT_PADDING + BASE_FONT_SIZE * scale * (LINE_HEIGHT_RATIO - 1) / 2);
+  ctx.fillText(text2, rect.x + TEXT_PADDING, rect.y + TEXT_PADDING + BASE_FONT_SIZE * scale * (LINE_HEIGHT_RATIO - 1) / 2);
   ctx.restore();
 }
 function roundedRectPath(ctx, x, y, w, h, r) {
@@ -650,10 +892,10 @@ function roundedRectPath(ctx, x, y, w, h, r) {
   ctx.arcTo(x, y, x + w, y, radius);
   ctx.closePath();
 }
-function textBubbleRect(measurer, text, point, scale = 1) {
+function textBubbleRect(measurer, text2, point, scale = 1) {
   const previous = measurer.font;
   measurer.font = textFont(scale);
-  const width = measurer.measureText(text).width;
+  const width = measurer.measureText(text2).width;
   measurer.font = previous;
   const height = BASE_FONT_SIZE * scale * LINE_HEIGHT_RATIO;
   const padding = TEXT_PADDING * scale;
@@ -1055,27 +1297,6 @@ function clamp(v, lo, hi) {
 function round4(v) {
   return Math.round(v * 1e4) / 1e4;
 }
-const svg = (body) => `<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
-const icons = {
-  feedback: svg(
-    '<path d="M21 12a8 8 0 0 1-11.6 7.1L4 20l1-4.6A8 8 0 1 1 21 12Z"/><path d="M8.5 10.5h7M8.5 14h4.5"/>'
-  ),
-  pen: svg('<path d="M4 20l4-1L19 8a2.1 2.1 0 0 0-3-3L5 16l-1 4Z"/><path d="M14.5 6.5l3 3"/>'),
-  rectangle: svg('<rect x="4" y="6" width="16" height="12" rx="1.5"/>'),
-  arrow: svg('<path d="M6 18L18 6"/><path d="M9 6h9v9"/>'),
-  text: svg('<path d="M5 6V5h14v1"/><path d="M12 5v14"/><path d="M9 19h6"/>'),
-  move: svg(
-    '<path d="M12 3v18M3 12h18"/><path d="M9 6l3-3 3 3M9 18l3 3 3-3M6 9l-3 3 3 3M18 9l3 3-3 3"/>'
-  ),
-  undo: svg('<path d="M9 14L4 9l5-5"/><path d="M4 9h10.5a5.5 5.5 0 0 1 0 11H11"/>'),
-  trash: svg('<path d="M4 7h16"/><path d="M10 11v6M14 11v6"/><path d="M6 7l1 13h10l1-13"/><path d="M9 7V4h6v3"/>'),
-  close: svg('<path d="M6 6l12 12M18 6L6 18"/>'),
-  paperclip: svg(
-    '<path d="M21 11.5l-8.6 8.6a5.5 5.5 0 0 1-7.8-7.8l8.6-8.6a3.7 3.7 0 0 1 5.2 5.2l-8.6 8.6a1.8 1.8 0 0 1-2.6-2.6l7.9-7.9"/>'
-  ),
-  send: svg('<path d="M4 12l16-8-6 16-3-7-7-1Z"/>'),
-  check: svg('<path d="M5 12.5l4.5 4.5L19 7.5"/>')
-};
 const styles = (
   /* css */
   `
@@ -1332,6 +1553,39 @@ button:disabled { cursor: not-allowed; opacity: 0.45; }
 .fk-done-icon svg { width: 26px; height: 26px; }
 .fk-sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
 
+/* ---------- "is it fixed?" card (fixCard.ts) ---------- */
+.fk-fixcard {
+  position: fixed;
+  z-index: 2147483000;
+  right: 20px;
+  bottom: 76px;
+  width: min(360px, calc(100vw - 32px));
+  max-height: min(640px, calc(100vh - 96px));
+  overflow: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px;
+  border: 1px solid var(--fk-border);
+  border-radius: 16px;
+  background: var(--fk-bg);
+  box-shadow: var(--fk-shadow);
+  animation: fk-rise 0.2s ease-out;
+}
+.fk-fixcard[data-position="bottom-left"] { right: auto; left: 20px; }
+.fk-fixcard > *, .fk-fixcard-actions > * { flex-shrink: 0; }
+.fk-fixcard p { margin: 0; }
+.fk-fixcard-header { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; }
+.fk-fixcard-shot { display: block; width: 100%; max-height: 220px; object-fit: contain; border-radius: 10px; background: var(--fk-surface); }
+.fk-fixcard-quote { font-size: 14px; }
+.fk-fixcard-summary { font-size: 13px; padding: 8px 10px; border-radius: 8px; background: var(--fk-surface); }
+.fk-fixcard-message p { font-size: 13px; }
+.fk-fixcard-question { font-weight: 600; }
+.fk-fixcard-actions { display: flex; flex-direction: column; gap: 8px; margin-top: 4px; }
+.fk-fixcard-actions .fk-btn { flex: none; width: 100%; }
+.fk-fixcard-actions .fk-textarea { min-height: 64px; }
+@keyframes fk-rise { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: none; } }
+
 /* ---------- narrow screens: stack stage over composer ---------- */
 @media (max-width: 760px) {
   .fk-overlay { padding: 0; }
@@ -1341,9 +1595,10 @@ button:disabled { cursor: not-allowed; opacity: 0.45; }
   .fk-canvas-wrap { padding: 10px; }
   .fk-composer { max-height: 55vh; padding: 14px; gap: 10px; }
   .fk-textarea { min-height: 84px; }
+  .fk-fixcard, .fk-fixcard[data-position] { right: 16px; left: 16px; width: auto; bottom: 16px; }
 }
 @media (prefers-reduced-motion: reduce) {
-  .fk-overlay, .fk-dialog { animation: none; }
+  .fk-overlay, .fk-dialog, .fk-fixcard { animation: none; }
 }
 `
 );
@@ -1369,26 +1624,48 @@ class Widget {
     this.shadow = null;
     this.trigger = null;
     this.pending = null;
+    this.fixCard = null;
     this.isOwnNode = (node) => node === this.host;
   }
+  get isShowingFixCard() {
+    return this.fixCard !== null;
+  }
+  /**
+   * The non-modal "is it fixed?" card (bottom corner). Resolves with what
+   * the reporter chose; the card removes itself.
+   */
+  showFixCard(update) {
+    this.fixCard?.remove();
+    const shadow = this.mount();
+    return new Promise((resolve) => {
+      this.fixCard = new FixCard(shadow, update, (outcome) => {
+        this.fixCard = null;
+        resolve(outcome);
+      });
+      this.fixCard.show(this.trigger?.dataset.position === "bottom-left" ? "bottom-left" : "bottom-right");
+    });
+  }
+  hideFixCard() {
+    this.fixCard?.dismiss();
+  }
   get isOpen() {
     return this.pending !== null;
   }
   showTrigger(options, onClick) {
     const shadow = this.mount();
     this.trigger?.remove();
-    const button = document.createElement("button");
-    button.type = "button";
-    button.className = "fk-trigger";
-    button.dataset.position = options.position ?? "bottom-right";
-    button.dataset.compact = String(!!options.compact);
+    const button2 = document.createElement("button");
+    button2.type = "button";
+    button2.className = "fk-trigger";
+    button2.dataset.position = options.position ?? "bottom-right";
+    button2.dataset.compact = String(!!options.compact);
     const label = options.label ?? "Feedback";
-    button.setAttribute("aria-label", label);
-    button.innerHTML = `${icons.feedback}<span class="fk-trigger-label"></span>`;
-    button.querySelector(".fk-trigger-label").textContent = label;
-    button.addEventListener("click", onClick);
-    shadow.append(button);
-    this.trigger = button;
+    button2.setAttribute("aria-label", label);
+    button2.innerHTML = `${icons.feedback}<span class="fk-trigger-label"></span>`;
+    button2.querySelector(".fk-trigger-label").textContent = label;
+    button2.addEventListener("click", onClick);
+    shadow.append(button2);
+    this.trigger = button2;
     this.applyTheme();
   }
   hideTrigger() {
@@ -1397,6 +1674,8 @@ class Widget {
   }
   destroy() {
     this.hideTrigger();
+    this.fixCard?.remove();
+    this.fixCard = null;
     this.host?.remove();
     this.host = null;
     this.shadow = null;
@@ -1580,17 +1859,17 @@ class Dialog {
     const header = el("div", "fk-header");
     const title = el("h2", "fk-title");
     title.id = "fk-title";
-    title.textContent = "Send feedback";
+    title.textContent = this.options.copy?.title ?? "Send feedback";
     const close = iconButton("fk-close", icons.close, "Close");
     close.addEventListener("click", () => this.cancel());
     header.append(title, close);
     const textLabel = el("label", "fk-label");
-    textLabel.textContent = "What's the problem?";
+    textLabel.textContent = this.options.copy?.label ?? "What's the problem?";
     textLabel.setAttribute("for", "fk-text");
     this.textarea = document.createElement("textarea");
     this.textarea.id = "fk-text";
     this.textarea.className = "fk-textarea";
-    this.textarea.placeholder = "Describe what happened and what you expected instead…";
+    this.textarea.placeholder = this.options.copy?.placeholder ?? "Describe what happened and what you expected instead…";
     this.textarea.addEventListener("input", () => this.refreshState());
     const textGroup = el("div");
     textGroup.append(textLabel, this.textarea);
@@ -1816,14 +2095,16 @@ class Dialog {
     this.sendButton.innerHTML = `<span class="fk-spinner" aria-hidden="true"></span><span>Sending…</span>`;
     try {
       const report = await this.buildReport();
-      if (this.options.submit) {
+      if (this.options.deliver) {
+        await this.options.deliver(report);
+      } else if (this.options.submit) {
         const configuration2 = this.deps.configuration();
         if (!configuration2) throw new Error("FeedbackKit.configure() hasn't been called.");
-        await submitReport(report, configuration2);
+        await submitReport(report, configuration2, this.deps.identity());
       }
       await this.options.onReport?.(report);
       this.showThanks();
-      setTimeout(() => this.finish(report), this.options.submit ? 1300 : 0);
+      setTimeout(() => this.finish(report), this.delivers ? 1300 : 0);
     } catch (error) {
       this.sending = false;
       this.sendButton.innerHTML = `${icons.send}<span>Retry</span>`;
@@ -1832,8 +2113,11 @@ class Dialog {
       this.options.onError?.(error);
     }
   }
+  get delivers() {
+    return this.options.submit || !!this.options.deliver;
+  }
   showThanks() {
-    if (!this.options.submit) return;
+    if (!this.delivers) return;
     const composer = this.overlay.querySelector(".fk-composer");
     if (!composer) return;
     const done = el("div", "fk-done");
@@ -1841,9 +2125,9 @@ class Dialog {
     const icon = el("span", "fk-done-icon");
     icon.innerHTML = icons.check;
     const title = el("h2", "fk-title");
-    title.textContent = "Thanks for the feedback!";
+    title.textContent = this.options.copy?.thanksTitle ?? "Thanks for the feedback!";
     const sub = el("p", "fk-meta");
-    sub.textContent = "It's on its way to the team.";
+    sub.textContent = this.options.copy?.thanksBody ?? "It's on its way to the team.";
     done.append(icon, title, sub);
     composer.replaceChildren(done);
   }
@@ -1884,9 +2168,9 @@ function switchControl(label, checked, onChange) {
   input.setAttribute("role", "switch");
   input.addEventListener("change", () => onChange(input.checked));
   const track = el("span", "fk-switch-track");
-  const text = el("span");
-  text.textContent = label;
-  wrap.append(input, track, text);
+  const text2 = el("span");
+  text2.textContent = label;
+  wrap.append(input, track, text2);
   return wrap;
 }
 function validHex(hex) {
@@ -1915,8 +2199,66 @@ const widget = new Widget({
   defaultProductKey: () => configuration?.defaultProductKey,
   logs: () => logCapture?.buffer.snapshot() ?? [],
   captureOptions: () => FeedbackKit.captureOptions,
-  currentScreen: () => FeedbackKit.currentScreen
+  currentScreen: () => FeedbackKit.currentScreen,
+  identity: () => ({ reporterId: reporterId(), user: getUser() })
 });
+const FIX_CHECK_INTERVAL_MS = 6e4;
+let fixVerificationEnabled = false;
+let lastFixCheck = 0;
+let fixCheckInFlight = false;
+const handledThisPage = /* @__PURE__ */ new Set();
+function onVisibilityChange() {
+  if (document.visibilityState === "visible") void checkAndShowFix(false);
+}
+async function checkAndShowFix(force) {
+  const config = configuration;
+  if (!fixVerificationEnabled || !config || fixCheckInFlight || widget.isOpen || widget.isShowingFixCard) return;
+  if (!force && Date.now() - lastFixCheck < FIX_CHECK_INTERVAL_MS) return;
+  fixCheckInFlight = true;
+  lastFixCheck = Date.now();
+  let next;
+  try {
+    next = (await fetchFixUpdates(config)).find((u) => !handledThisPage.has(u.feedbackId));
+  } catch {
+    return;
+  } finally {
+    fixCheckInFlight = false;
+  }
+  if (!next || !fixVerificationEnabled) return;
+  void handleFixCard(config, next);
+}
+async function handleFixCard(config, update) {
+  const outcome = await widget.showFixCard(update);
+  handledThisPage.add(update.feedbackId);
+  const send = (action) => sendFixAction(config, update.feedbackId, action).catch(
+    (error) => console.warn("[FeedbackKit] Couldn't send fix verification.", error)
+  );
+  switch (outcome.type) {
+    case "verified":
+      await send({ type: "verify" });
+      void checkAndShowFix(true);
+      break;
+    case "replied":
+      await send({ type: "reply", text: outcome.text });
+      void checkAndShowFix(true);
+      break;
+    case "stillBroken": {
+      const report = await widget.open({
+        submit: false,
+        deliver: (r) => sendFixAction(config, update.feedbackId, { type: "reopen", report: r }),
+        copy: {
+          title: "Still broken",
+          label: "What's still wrong?",
+          placeholder: "Show us on the screenshot and describe what you still see…",
+          thanksTitle: "Thanks — we're on it",
+          thanksBody: "Your report was reopened and sent back to the team."
+        }
+      });
+      if (!report) await send({ type: "reopen" });
+      break;
+    }
+  }
+}
 function resolveProducts() {
   if (products.length > 0 || !configuration) return Promise.resolve(products);
   if (!productsPromise) {
@@ -1995,7 +2337,7 @@ const FeedbackKit = {
     if (!configuration) {
       return Promise.reject(new Error("FeedbackKit.configure({ projectKey }) must be called before submit()."));
     }
-    return submitReport(report, configuration);
+    return submitReport(report, configuration, { reporterId: reporterId(), user: getUser() });
   },
   get isPresenting() {
     return widget.isOpen;
@@ -2049,8 +2391,69 @@ const FeedbackKit = {
     const shot = await captureViewport({ ...FeedbackKit.captureOptions, ...options, exclude: widget.isOwnNode });
     return canvasToPngBlob(shot.canvas);
   },
+  /**
+   * Optional identity of the person using your site, attached to every
+   * report they submit. Not needed for fix verification (that uses an
+   * anonymous per-browser id, `reporterId`). Pass `null` on sign-out.
+   */
+  setUser(user) {
+    setUser(user);
+  },
+  /** The anonymous per-browser id attached to reports — how a fix finds its way back here. */
+  get reporterId() {
+    return reporterId();
+  },
+  /**
+   * This browser's reports that need the reporter's attention: shipped
+   * fixes to confirm and developer/agent questions. For a custom UI — the
+   * built-in one is `enableFixVerification`.
+   */
+  checkForFixUpdates() {
+    if (!configuration) {
+      return Promise.reject(new Error("FeedbackKit.configure({ projectKey }) must be called before checkForFixUpdates()."));
+    }
+    return fetchFixUpdates(configuration);
+  },
+  /** Answers one update directly (custom UIs): verify, reopen, or reply. */
+  respondToFixUpdate(feedbackId, action) {
+    if (!configuration) {
+      return Promise.reject(new Error("FeedbackKit.configure({ projectKey }) must be called before respondToFixUpdate()."));
+    }
+    return sendFixAction(configuration, feedbackId, action);
+  },
+  /**
+   * Closes the loop with the person who reported a bug: once a fix for one
+   * of their reports ships (announced with `feedbackkit release`), a small
+   * card shows their original screenshot and asks "is it fixed?". "Still
+   * broken" reopens the capture dialog so they can show what's wrong now,
+   * and the report goes straight back to the developer. Also surfaces
+   * questions the developer or their coding agent asked.
+   *
+   * Checks now and whenever the tab becomes visible (at most once a minute).
+   * With `appBuild` configured, only fixes shipped in that build or earlier
+   * are shown; without it, a fix counts as live as soon as it's released.
+   */
+  enableFixVerification() {
+    if (fixVerificationEnabled) return;
+    fixVerificationEnabled = true;
+    document.addEventListener("visibilitychange", onVisibilityChange);
+    whenBodyReady(() => void checkAndShowFix(true));
+  },
+  disableFixVerification() {
+    fixVerificationEnabled = false;
+    document.removeEventListener("visibilitychange", onVisibilityChange);
+    widget.hideFixCard();
+  },
+  /**
+   * Checks right now (ignoring the throttle) and shows the card if there's
+   * something. Resolves once the check is done and any card is on screen.
+   */
+  presentFixUpdatesIfNeeded() {
+    return checkAndShowFix(true);
+  },
   /** Removes every trace of the SDK from the page (trigger, dialog host, listeners, log hooks). */
   destroy() {
+    FeedbackKit.disableFixVerification();
     FeedbackKit.disableKeyboardShortcut();
     logCapture?.uninstall();
     logCapture = null;
@@ -2062,6 +2465,7 @@ export {
   FeedbackKit,
   FeedbackSubmissionError,
   STROKE_WIDTH,
+  compareBuilds,
   FeedbackKit as default,
   drawAnnotation,
   drawAnnotations,
@@ -2070,6 +2474,7 @@ export {
   parseUserAgent,
   readPoint,
   redactUrl,
+  reporterUpdatesEndpoint,
   textBubbleRect
 };
 //# sourceMappingURL=feedbackkit.js.map