insert-affiliate-js-sdk 1.4.0 → 1.5.0

package/dist/index.js

@@ -73,6 +73,786 @@ if (!String.prototype.hasOwnProperty("hashCode")) {
   };
 }
 
+// src/referrals/referrerTokenStore.ts
+var KEY_PREFIX = "insertAffiliateReferrerToken_";
+var memoryTokens = {};
+var keyFor = (companyId) => `${KEY_PREFIX}${companyId}`;
+var readReferrerToken = (companyId) => {
+  let stored = null;
+  try {
+    stored = localStorage.getItem(keyFor(companyId));
+  } catch (e) {
+  }
+  return stored || memoryTokens[companyId] || null;
+};
+var saveReferrerToken = (companyId, token) => {
+  try {
+    localStorage.setItem(keyFor(companyId), token);
+    delete memoryTokens[companyId];
+    return true;
+  } catch (e) {
+    memoryTokens[companyId] = token;
+    return false;
+  }
+};
+var clearReferrerToken = (companyId) => {
+  delete memoryTokens[companyId];
+  try {
+    localStorage.removeItem(keyFor(companyId));
+  } catch (e) {
+  }
+};
+
+// src/referrals/referralApi.ts
+var BASE_URL = "https://api.insertaffiliate.com/V1/sdk/affiliate";
+var TOKEN_HEADER = "X-Insert-Affiliate-Token";
+var PLATFORM = "web";
+var TRIGGERS = ["install", "event", "purchase"];
+var str = (value) => typeof value === "string" ? value : "";
+var num = (value) => {
+  const n = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(n) ? n : 0;
+};
+var trigger = (value) => TRIGGERS.includes(value) ? value : "purchase";
+var isObject = (value) => typeof value === "object" && value !== null;
+var parseReferrerAffiliate = (raw) => {
+  const data = isObject(raw) ? raw : {};
+  return {
+    affiliateName: str(data.affiliateName),
+    affiliateShortCode: str(data.affiliateShortCode),
+    deeplinkurl: str(data.deeplinkurl)
+  };
+};
+var parseRewardCodes = (value) => (Array.isArray(value) ? value : []).filter(isObject).map((item) => ({
+  code: str(item.code),
+  redeemUrl: str(item.redeemUrl),
+  store: str(item.store) || "app_store",
+  grantedAt: str(item.grantedAt)
+})).filter((item) => item.code);
+var parseMyAffiliateDetails = (raw) => {
+  const data = isObject(raw) ? raw : {};
+  return __spreadProps(__spreadValues({}, parseReferrerAffiliate(data)), {
+    referralTrigger: trigger(data.referralTrigger),
+    referralCount: num(data.referralCount),
+    installCount: num(data.installCount),
+    eventCount: num(data.eventCount),
+    purchaseCount: num(data.purchaseCount),
+    totalEarned: num(data.totalEarned),
+    totalPaid: num(data.totalPaid),
+    totalUnpaid: num(data.totalUnpaid),
+    currency: str(data.currency) || "USD",
+    dashboardUrl: str(data.dashboardUrl),
+    rewardsGranted: num(data.rewardsGranted),
+    premiumUntil: str(data.premiumUntil) || null,
+    rewardCodes: parseRewardCodes(data.rewardCodes)
+  });
+};
+var parseReferralProgramConfig = (raw) => {
+  const data = isObject(raw) ? raw : {};
+  const color = str(data.primaryColor);
+  return {
+    enabled: data.enabled === true,
+    companyName: str(data.companyName),
+    referralTrigger: trigger(data.referralTrigger),
+    headline: str(data.headline),
+    rewardText: str(data.rewardText),
+    primaryColor: /^#[0-9a-fA-F]{6}$/.test(color) ? color : ""
+  };
+};
+var errorResult = (code, message) => ({
+  status: "error",
+  errorCode: code,
+  errorMessage: message
+});
+var parseEnrolmentResponse = (httpStatus, body) => {
+  const data = isObject(body) ? body : {};
+  if (httpStatus < 200 || httpStatus >= 300) {
+    return {
+      result: errorResult(
+        str(data.code) || `HTTP_${httpStatus}`,
+        str(data.error) || `Request failed with status ${httpStatus}.`
+      ),
+      token: null
+    };
+  }
+  if (data.status === "verificationRequired") {
+    return { result: { status: "verificationRequired" }, token: null };
+  }
+  const token = str(data.token);
+  if ((data.status === "created" || data.status === "connected") && token) {
+    return {
+      result: { status: data.status, affiliate: parseReferrerAffiliate(data.affiliate) },
+      token
+    };
+  }
+  return { result: errorResult("NETWORK_ERROR", "Unexpected response from the server."), token: null };
+};
+var DECIMAL_DIGIT = new RegExp("\\p{Nd}", "u");
+var normalizeVerificationCode = (value) => {
+  let out = "";
+  Array.from(String(value == null ? "" : value)).forEach((char) => {
+    if (char >= "0" && char <= "9") {
+      out += char;
+      return;
+    }
+    if (!DECIMAL_DIGIT.test(char)) return;
+    const point = char.codePointAt(0);
+    let start = point;
+    while (start > 0 && DECIMAL_DIGIT.test(String.fromCodePoint(start - 1))) start -= 1;
+    out += String((point - start) % 10);
+  });
+  return out;
+};
+var buildReferralShareText = (affiliate, companyName, message) => {
+  const code = affiliate.affiliateShortCode || "";
+  const hasLink = /^http/i.test(affiliate.deeplinkurl || "");
+  const link = hasLink ? affiliate.deeplinkurl : code;
+  const appName = companyName || "the app";
+  const custom = (message || "").trim();
+  if (!link) return "";
+  if (custom && /\{link\}|\{code\}/.test(custom)) {
+    return custom.replace(/\{link\}/g, link).replace(/\{code\}/g, code);
+  }
+  if (hasLink) {
+    return `${custom || `Try ${companyName || "this app"}:`} ${link}`;
+  }
+  return custom ? `${custom} ${code}` : `Use my code ${code} in ${appName}`;
+};
+var readJson = async (response) => {
+  try {
+    return await response.json();
+  } catch (e) {
+    return null;
+  }
+};
+var withoutEmpty = (payload) => {
+  const out = {};
+  Object.keys(payload).forEach((key) => {
+    const value = payload[key];
+    if (typeof value === "string" && value.trim()) out[key] = value.trim();
+  });
+  return out;
+};
+var networkError = () => errorResult("NETWORK_ERROR", "Could not reach Insert Affiliate. Check the connection and try again.");
+var fetchReferralProgramConfig = async (companyId, log) => {
+  const url = `${BASE_URL}/config/${encodeURIComponent(companyId)}`;
+  log(`Making API call to: ${url}`);
+  try {
+    const response = await fetch(url);
+    log(`Referral config response status: ${response.status}`);
+    if (!response.ok) return null;
+    return parseReferralProgramConfig(await readJson(response));
+  } catch (error) {
+    log(`Error fetching referral config: ${error}`);
+    return null;
+  }
+};
+var postEnrolment = async (path, companyId, payload, log) => {
+  const url = `${BASE_URL}/${path}`;
+  log(`Making API call to: ${url}`);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(__spreadValues({ companyId, platform: PLATFORM }, withoutEmpty(payload)))
+    });
+    log(`Referral ${path} response status: ${response.status}`);
+    const { result, token } = parseEnrolmentResponse(response.status, await readJson(response));
+    if (token && !saveReferrerToken(companyId, token)) {
+      log("localStorage unavailable; referrer token kept for this page load only");
+    }
+    log(`Referral ${path} result: ${result.status}${result.errorCode ? ` (${result.errorCode})` : ""}`);
+    return result;
+  } catch (error) {
+    log(`Network error during referral ${path}: ${error}`);
+    return networkError();
+  }
+};
+var isRevokedTokenResponse = (httpStatus, body) => {
+  const code = isObject(body) ? str(body.code) : "";
+  return httpStatus === 401 && code === "INVALID_TOKEN" || httpStatus === 404 && code === "AFFILIATE_NOT_FOUND";
+};
+var clearRevokedToken = (companyId, sentToken, log) => {
+  if (readReferrerToken(companyId) !== sentToken) {
+    log("Referrer token no longer valid; a newer token is stored, keeping it");
+    return;
+  }
+  clearReferrerToken(companyId);
+  log("Referrer token no longer valid; cleared");
+};
+var fetchMyAffiliateDetails = async (companyId, token, log) => {
+  const url = `${BASE_URL}/me`;
+  log(`Making API call to: ${url}`);
+  try {
+    const response = await fetch(url, { headers: { [TOKEN_HEADER]: token } });
+    log(`Referral details response status: ${response.status}`);
+    const body = await readJson(response);
+    if (isRevokedTokenResponse(response.status, body)) {
+      clearRevokedToken(companyId, token, log);
+      return { kind: "signedOut" };
+    }
+    if (!response.ok || !isObject(body)) return { kind: "failed" };
+    return { kind: "ok", details: parseMyAffiliateDetails(body) };
+  } catch (error) {
+    log(`Error fetching referral details: ${error}`);
+    return { kind: "failed" };
+  }
+};
+var postReferrerIdentity = async (companyId, token, payload, log) => {
+  const url = `${BASE_URL}/me/identity`;
+  log(`Making API call to: ${url}`);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", [TOKEN_HEADER]: token },
+      body: JSON.stringify(withoutEmpty(payload))
+    });
+    log(`Referrer identity response status: ${response.status}`);
+    const body = await readJson(response);
+    if (isRevokedTokenResponse(response.status, body)) {
+      clearRevokedToken(companyId, token, log);
+      return false;
+    }
+    return response.ok && isObject(body) && body.saved === true;
+  } catch (error) {
+    log(`Error saving referrer identity: ${error}`);
+    return false;
+  }
+};
+var copyText = async (text) => {
+  try {
+    if (typeof navigator !== "undefined" && navigator.clipboard && navigator.clipboard.writeText) {
+      await navigator.clipboard.writeText(text);
+      return true;
+    }
+  } catch (e) {
+  }
+  return false;
+};
+var shareText = async (text) => {
+  if (!text) return "failed";
+  if (typeof navigator !== "undefined" && typeof navigator.share === "function") {
+    try {
+      await navigator.share({ text });
+      return "shared";
+    } catch (error) {
+      if (error && error.name === "AbortError") return "cancelled";
+    }
+  }
+  return await copyText(text) ? "copied" : "failed";
+};
+
+// src/referrals/referralStrings.ts
+var DEFAULT_REFERRAL_STRINGS = {
+  // Joining
+  emailLabel: "Email",
+  nameLabel: "Name",
+  joinButton: "Get my link",
+  joiningButton: "Please wait...",
+  // Email code step
+  codeLabel: "Code",
+  codeSentNotice: "We sent a 6-digit code to {email}. Enter it below to connect this device.",
+  verifyButton: "Verify",
+  verifyingButton: "Verifying...",
+  resendButton: "Send a new code",
+  sendingNotice: "Sending...",
+  codeResentNotice: "We sent a new code.",
+  differentEmailButton: "Use a different email",
+  errorCodeLength: "Enter the 6-digit code from the email.",
+  // Joined
+  copyCodeButton: "Copy code",
+  copyLinkButton: "Copy link",
+  copiedNotice: "Copied",
+  copyFailedNotice: "Could not copy. Select the text to copy it.",
+  shareButton: "Share",
+  shareFailedNotice: "Could not share. Copy your code instead.",
+  referralsLabel: "Referrals",
+  earnedLabel: "Earned",
+  premiumUntil: "Free premium until {date}",
+  rewardsHeading: "Your rewards",
+  redeemButton: "Redeem",
+  dashboardLink: "Open my dashboard",
+  // Frame and states
+  closeButton: "Close",
+  loading: "Loading...",
+  tryAgainButton: "Try again",
+  // Errors, by the server's error code
+  errorProgramDisabled: "Referrals are not available in this app right now.",
+  errorAffiliateLimitReached: "The referral program is full right now. Please try again later.",
+  errorInvalidCode: "That code is wrong or has expired. Check it or send a new code.",
+  errorTooManyCodes: "Too many codes have been sent. Please wait a while and try again.",
+  errorRateLimited: "Too many attempts. Please try again later.",
+  errorInvalidEmail: "Please enter a valid email address.",
+  errorNetwork: "Could not connect. Check your connection and try again.",
+  errorServer: "Something went wrong. Please try again."
+};
+var ERROR_STRING_KEYS = {
+  PROGRAM_DISABLED: "errorProgramDisabled",
+  AFFILIATE_LIMIT_REACHED: "errorAffiliateLimitReached",
+  INVALID_CODE: "errorInvalidCode",
+  TOO_MANY_CODES: "errorTooManyCodes",
+  RATE_LIMITED: "errorRateLimited",
+  INVALID_EMAIL: "errorInvalidEmail",
+  NETWORK_ERROR: "errorNetwork"
+};
+var resolveReferralStrings = (overrides) => {
+  const resolved = __spreadValues({}, DEFAULT_REFERRAL_STRINGS);
+  if (!overrides) return resolved;
+  Object.keys(DEFAULT_REFERRAL_STRINGS).forEach((key) => {
+    const value = overrides[key];
+    if (typeof value === "string" && value.trim()) resolved[key] = value;
+  });
+  return resolved;
+};
+var fillPlaceholders = (text, values) => Object.keys(values).reduce(
+  (out, name) => out.split(`{${name}}`).join(values[name]),
+  text
+);
+
+// src/referrals/referAFriendModal.ts
+var DEFAULT_COLOR = "#6A0DAD";
+var DEFAULT_HEADLINE = "Refer a friend";
+var DEFAULT_FONT = '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif';
+var STYLE = `
+.ia-raf-overlay{position:fixed;inset:0;z-index:2147483000;background:rgba(0,0,0,.5);display:flex;align-items:center;justify-content:center;padding:16px;box-sizing:border-box}
+.ia-raf-dialog{position:relative;width:100%;max-width:420px;max-height:calc(100vh - 32px);overflow:auto;background:#fff;color:#1a1a1a;border-radius:var(--ia-raf-radius);box-shadow:0 12px 40px rgba(0,0,0,.25);padding:24px;box-sizing:border-box;font-family:var(--ia-raf-font);font-size:15px;line-height:1.45;text-align:left}
+.ia-raf-dialog *{box-sizing:border-box}
+.ia-raf-title{margin:0 36px 8px 0;font-size:20px;font-weight:700;line-height:1.3}
+.ia-raf-reward{margin:0 0 16px;color:#444}
+.ia-raf-close{position:absolute;margin:0;top:19px;right:14px;width:36px;height:36px;display:flex;align-items:center;justify-content:center;padding:0 0 2px;border:0;border-radius:50%;background:transparent;color:#555;font-size:26px;line-height:1;cursor:pointer}
+.ia-raf-close:hover{background:#f0f0f3}
+.ia-raf-label{display:block;margin:0 0 4px;font-size:13px;font-weight:600}
+.ia-raf-input{display:block;width:100%;margin:0 0 12px;padding:10px 12px;border:1px solid #c8c8cc;border-radius:calc(var(--ia-raf-radius) * .66);background:#fff;color:#1a1a1a;font:inherit}
+.ia-raf-dialog :focus-visible{outline:2px solid var(--ia-raf-primary);outline-offset:2px}
+.ia-raf-btn{display:block;width:100%;margin:8px 0 0;padding:12px;border:1px solid var(--ia-raf-primary);border-radius:calc(var(--ia-raf-radius) * .66);background:var(--ia-raf-primary);color:#fff;font:inherit;font-weight:600;cursor:pointer}
+.ia-raf-btn[disabled]{opacity:.6;cursor:default}
+.ia-raf-btn-secondary{background:transparent;color:var(--ia-raf-primary)}
+.ia-raf-textbtn{display:inline-block;margin:8px 16px 0 0;padding:4px 0;border:0;background:none;color:var(--ia-raf-primary);font:inherit;font-size:14px;text-decoration:underline;cursor:pointer}
+.ia-raf-error{margin:0 0 12px;padding:8px 12px;border-radius:calc(var(--ia-raf-radius) * .5);background:#fdecee;color:#b00020;font-size:14px}
+.ia-raf-error:empty{display:none}
+.ia-raf-muted{margin:0 0 12px;color:#555;font-size:14px}
+.ia-raf-row{display:flex;align-items:center;gap:8px;margin:0 0 8px;padding:10px 12px;border:1px dashed var(--ia-raf-primary);border-radius:calc(var(--ia-raf-radius) * .66)}
+.ia-raf-code{flex:1;min-width:0;font-size:20px;font-weight:700;letter-spacing:1px;word-break:break-all}
+.ia-raf-url{flex:1;min-width:0;font-size:13px;color:#444;word-break:break-all}
+.ia-raf-copy{flex:none;margin:0;padding:6px 10px;border:1px solid var(--ia-raf-primary);border-radius:calc(var(--ia-raf-radius) * .5);background:transparent;color:var(--ia-raf-primary);font:inherit;font-size:13px;font-weight:600;cursor:pointer}
+.ia-raf-stats{display:flex;gap:12px;margin:16px 0 8px}
+.ia-raf-stat{flex:1;padding:12px;border-radius:calc(var(--ia-raf-radius) * .66);background:#f4f4f7;text-align:center}
+.ia-raf-stat-value{display:block;font-size:20px;font-weight:700}
+.ia-raf-stat-label{display:block;color:#666;font-size:12px}
+.ia-raf-premium{margin:8px 0;padding:10px 12px;border-radius:calc(var(--ia-raf-radius) * .66);background:#eef7ef;color:#1b5e20;font-size:14px;font-weight:600;text-align:center}
+.ia-raf-rewards-title{margin:16px 0 8px;font-size:15px;font-weight:700}
+.ia-raf-rewards{margin:0;padding:0;list-style:none}
+.ia-raf-reward-code{flex:1;min-width:0;font-size:15px;font-weight:600;letter-spacing:.5px;word-break:break-all}
+.ia-raf-status{min-height:20px;margin:8px 0 0;color:#2e7d32;font-size:13px;text-align:center}
+`;
+var instanceCount = 0;
+var openModal = null;
+function el(tag, props = {}, children = []) {
+  const node = document.createElement(tag);
+  if (props.className) node.className = props.className;
+  if (props.text !== void 0) node.textContent = props.text;
+  if (props.attrs) {
+    Object.keys(props.attrs).forEach((name) => node.setAttribute(name, props.attrs[name]));
+  }
+  children.forEach((child) => {
+    if (child === null || child === void 0 || child === false) return;
+    node.appendChild(typeof child === "string" ? document.createTextNode(child) : child);
+  });
+  return node;
+}
+function button(text, className, onClick) {
+  const node = el("button", { className, text, attrs: { type: "button" } });
+  node.addEventListener("click", onClick);
+  return node;
+}
+function formatMoney(amount, currency) {
+  try {
+    return new Intl.NumberFormat(void 0, { style: "currency", currency: currency || "USD" }).format(amount);
+  } catch (e) {
+    return `${amount.toFixed(2)} ${currency}`;
+  }
+}
+var isHttpsUrl = (value) => /^https:\/\//i.test(value);
+function futureDateLabel(iso, now = Date.now()) {
+  if (!iso) return null;
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime()) || date.getTime() <= now) return null;
+  try {
+    return date.toLocaleDateString(void 0, { year: "numeric", month: "long", day: "numeric" });
+  } catch (e) {
+    return date.toDateString();
+  }
+}
+function presentReferAFriend(options, deps) {
+  if (openModal) {
+    openModal.focus();
+    return openModal.handle;
+  }
+  instanceCount += 1;
+  const titleId = `ia-raf-title-${instanceCount}`;
+  let closed = false;
+  let email = (options.email || "").trim();
+  let name = (options.name || "").trim();
+  let companyName = "";
+  let busy = false;
+  let accountSaved = false;
+  const text = resolveReferralStrings(options.strings);
+  const messageFor = (code) => text[code && ERROR_STRING_KEYS[code] || "errorServer"];
+  const previousFocus = document.activeElement;
+  const previousOverflow = document.body.style.overflow;
+  const style = el("style", { text: STYLE });
+  const title = el("h2", { className: "ia-raf-title", text: options.headline || DEFAULT_HEADLINE, attrs: { id: titleId } });
+  const reward = el("p", { className: "ia-raf-reward", text: options.rewardText || "" });
+  reward.hidden = !options.rewardText;
+  const body = el("div");
+  const closeButton = button("\xD7", "ia-raf-close", () => close());
+  closeButton.setAttribute("aria-label", text.closeButton);
+  const dialog = el("div", {
+    className: "ia-raf-dialog",
+    attrs: { role: "dialog", "aria-modal": "true", "aria-labelledby": titleId }
+  }, [closeButton, title, reward, body]);
+  dialog.style.setProperty("--ia-raf-font", options.fontFamily || DEFAULT_FONT);
+  dialog.style.setProperty("--ia-raf-radius", `${typeof options.cornerRadius === "number" ? Math.max(0, options.cornerRadius) : 12}px`);
+  setColor(options.primaryColor || DEFAULT_COLOR);
+  const overlay = el("div", { className: "ia-raf-overlay" }, [dialog]);
+  overlay.addEventListener("mousedown", (event) => {
+    if (event.target === overlay) close();
+  });
+  document.addEventListener("keydown", onKeyDown, true);
+  document.head.appendChild(style);
+  document.body.appendChild(overlay);
+  document.body.style.overflow = "hidden";
+  function setColor(color) {
+    dialog.style.setProperty("--ia-raf-primary", color);
+  }
+  function close() {
+    if (closed) return;
+    closed = true;
+    if (openModal && openModal.handle === handle) openModal = null;
+    document.removeEventListener("keydown", onKeyDown, true);
+    overlay.remove();
+    style.remove();
+    document.body.style.overflow = previousOverflow;
+    if (previousFocus && typeof previousFocus.focus === "function") {
+      try {
+        previousFocus.focus();
+      } catch (e) {
+      }
+    }
+    if (options.onClose) options.onClose();
+  }
+  function focusables() {
+    const selector = 'button:not([disabled]), input:not([disabled]), [href], [tabindex]:not([tabindex="-1"])';
+    return Array.prototype.slice.call(dialog.querySelectorAll(selector));
+  }
+  function onKeyDown(event) {
+    if (event.key === "Escape") {
+      event.preventDefault();
+      event.stopPropagation();
+      close();
+      return;
+    }
+    if (event.key !== "Tab") return;
+    const items = focusables();
+    if (!items.length) return;
+    const first = items[0];
+    const last = items[items.length - 1];
+    if (!dialog.contains(document.activeElement)) {
+      event.preventDefault();
+      first.focus();
+    } else if (event.shiftKey && document.activeElement === first) {
+      event.preventDefault();
+      last.focus();
+    } else if (!event.shiftKey && document.activeElement === last) {
+      event.preventDefault();
+      first.focus();
+    }
+  }
+  function render(children, focusTarget) {
+    if (closed) return;
+    body.textContent = "";
+    children.forEach((child) => {
+      if (child) body.appendChild(typeof child === "string" ? document.createTextNode(child) : child);
+    });
+    const target = focusTarget || body.querySelector("input, button") || closeButton;
+    target.focus();
+  }
+  function renderLoading() {
+    render([el("p", { className: "ia-raf-muted", text: text.loading, attrs: { role: "status" } })], closeButton);
+  }
+  function renderMessage(message, retry) {
+    render([
+      el("p", { className: "ia-raf-error", text: message, attrs: { role: "alert" } }),
+      retry ? button(text.tryAgainButton, "ia-raf-btn", retry) : null
+    ]);
+  }
+  function errorBox() {
+    return el("p", { className: "ia-raf-error", attrs: { role: "alert" } });
+  }
+  function field(label, input) {
+    input.className = "ia-raf-input";
+    input.id = `${titleId}-${input.name}`;
+    return [el("label", { className: "ia-raf-label", text: label, attrs: { for: input.id } }), input];
+  }
+  async function runBusy(submit, busyText, task) {
+    if (busy) return;
+    busy = true;
+    const idleText = submit.textContent || "";
+    submit.disabled = true;
+    submit.textContent = busyText;
+    try {
+      await task();
+    } finally {
+      busy = false;
+      if (!closed && submit.isConnected) {
+        submit.disabled = false;
+        submit.textContent = idleText;
+      }
+    }
+  }
+  function renderEnrolForm() {
+    const error = errorBox();
+    const emailInput = el("input", {
+      attrs: { type: "email", name: "email", autocomplete: "email", required: "true" }
+    });
+    emailInput.value = email;
+    const nameInput = el("input", { attrs: { type: "text", name: "name", autocomplete: "name" } });
+    nameInput.value = name;
+    const submit = el("button", { className: "ia-raf-btn", text: text.joinButton, attrs: { type: "submit" } });
+    const form = el("form", { attrs: { novalidate: "true" } }, [
+      error,
+      ...field(text.emailLabel, emailInput),
+      ...field(text.nameLabel, nameInput),
+      submit
+    ]);
+    form.addEventListener("submit", (event) => {
+      event.preventDefault();
+      email = emailInput.value.trim();
+      name = nameInput.value.trim();
+      if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+        error.textContent = text.errorInvalidEmail;
+        emailInput.focus();
+        return;
+      }
+      error.textContent = "";
+      void runBusy(submit, text.joiningButton, async () => {
+        const result = await deps.enrol(email, name);
+        if (!closed) await handleEnrolment(result, error);
+      });
+    });
+    render([form], email ? submit : emailInput);
+  }
+  function renderCodeStep(notice) {
+    const error = errorBox();
+    const status = el("p", { className: "ia-raf-status", attrs: { role: "status", "aria-live": "polite" } });
+    const codeInput = el("input", {
+      attrs: {
+        type: "text",
+        name: "code",
+        inputmode: "numeric",
+        autocomplete: "one-time-code"
+      }
+    });
+    const submit = el("button", { className: "ia-raf-btn", text: text.verifyButton, attrs: { type: "submit" } });
+    let verifying = false;
+    const syncSubmit = () => {
+      if (!verifying) submit.disabled = normalizeVerificationCode(codeInput.value).length !== 6;
+    };
+    codeInput.addEventListener("input", syncSubmit);
+    syncSubmit();
+    const resend = button(text.resendButton, "ia-raf-textbtn", () => {
+      if (busy) return;
+      error.textContent = "";
+      status.textContent = text.sendingNotice;
+      busy = true;
+      void deps.enrol(email, name).then((result) => {
+        busy = false;
+        if (closed) return;
+        status.textContent = "";
+        if (result.status === "verificationRequired") {
+          status.textContent = text.codeResentNotice;
+        } else {
+          void handleEnrolment(result, error);
+        }
+      });
+    });
+    const changeEmail = button(text.differentEmailButton, "ia-raf-textbtn", () => {
+      if (!busy) renderEnrolForm();
+    });
+    const form = el("form", { attrs: { novalidate: "true" } }, [
+      el("p", { className: "ia-raf-muted", text: fillPlaceholders(text.codeSentNotice, { email }) }),
+      error,
+      ...field(text.codeLabel, codeInput),
+      submit,
+      el("div", {}, [resend, changeEmail]),
+      status
+    ]);
+    form.addEventListener("submit", (event) => {
+      event.preventDefault();
+      const code = normalizeVerificationCode(codeInput.value);
+      if (code.length !== 6) {
+        error.textContent = text.errorCodeLength;
+        codeInput.focus();
+        return;
+      }
+      error.textContent = "";
+      verifying = true;
+      void runBusy(submit, text.verifyingButton, async () => {
+        const result = await deps.verify(email, code, name);
+        if (!closed) await handleEnrolment(result, error);
+      }).then(() => {
+        verifying = false;
+        if (!closed && submit.isConnected) syncSubmit();
+      });
+    });
+    render([form], codeInput);
+    if (notice) status.textContent = notice;
+  }
+  async function handleEnrolment(result, error) {
+    if (result.status === "verificationRequired") {
+      renderCodeStep();
+      return;
+    }
+    if (result.status === "error") {
+      error.textContent = messageFor(result.errorCode);
+      return;
+    }
+    renderLoading();
+    const loaded = await deps.loadDetails();
+    if (loaded.kind === "ok") {
+      renderEnrolled(loaded.details, loaded.details);
+    } else if (result.affiliate) {
+      renderEnrolled(result.affiliate, null);
+    } else {
+      renderMessage(messageFor("NETWORK_ERROR"), () => void start());
+    }
+  }
+  function renderEnrolled(affiliate, stats) {
+    const status = el("p", { className: "ia-raf-status", attrs: { role: "status", "aria-live": "polite" } });
+    const hasLink = /^http/i.test(affiliate.deeplinkurl);
+    const messageToShare = buildReferralShareText(affiliate, companyName, options.shareMessage);
+    const copyButton = (label, value) => {
+      const node = button(label, "ia-raf-copy", () => {
+        void copyText(value).then((ok) => {
+          if (closed) return;
+          status.textContent = ok ? text.copiedNotice : text.copyFailedNotice;
+        });
+      });
+      node.setAttribute("aria-label", `${label}: ${value}`);
+      return node;
+    };
+    const children = [];
+    if (affiliate.affiliateShortCode) {
+      children.push(el("div", { className: "ia-raf-row" }, [
+        el("span", { className: "ia-raf-code", text: affiliate.affiliateShortCode }),
+        copyButton(text.copyCodeButton, affiliate.affiliateShortCode)
+      ]));
+    }
+    if (hasLink) {
+      children.push(el("div", { className: "ia-raf-row" }, [
+        el("span", { className: "ia-raf-url", text: affiliate.deeplinkurl }),
+        copyButton(text.copyLinkButton, affiliate.deeplinkurl)
+      ]));
+    }
+    if (messageToShare) {
+      children.push(button(text.shareButton, "ia-raf-btn", () => {
+        void shareText(messageToShare).then((outcome) => {
+          if (closed) return;
+          if (outcome === "copied") status.textContent = text.copiedNotice;
+          else if (outcome === "failed") status.textContent = text.shareFailedNotice;
+          else status.textContent = "";
+        });
+      }));
+    }
+    if (stats) {
+      children.push(el("div", { className: "ia-raf-stats" }, [
+        el("div", { className: "ia-raf-stat" }, [
+          el("span", { className: "ia-raf-stat-value", text: String(stats.referralCount) }),
+          el("span", { className: "ia-raf-stat-label", text: text.referralsLabel })
+        ]),
+        el("div", { className: "ia-raf-stat" }, [
+          el("span", { className: "ia-raf-stat-value", text: formatMoney(stats.totalEarned, stats.currency) }),
+          el("span", { className: "ia-raf-stat-label", text: text.earnedLabel })
+        ])
+      ]));
+      const premiumUntil = futureDateLabel(stats.premiumUntil);
+      if (premiumUntil) {
+        children.push(el("p", {
+          className: "ia-raf-premium",
+          text: fillPlaceholders(text.premiumUntil, { date: premiumUntil })
+        }));
+      }
+      if (stats.rewardCodes.length) {
+        const rewardsTitleId = `${titleId}-rewards`;
+        children.push(
+          el("h3", { className: "ia-raf-rewards-title", text: text.rewardsHeading, attrs: { id: rewardsTitleId } }),
+          el("ul", { className: "ia-raf-rewards", attrs: { "aria-labelledby": rewardsTitleId } }, stats.rewardCodes.map((reward2) => {
+            const redeemUrl = reward2.redeemUrl;
+            let redeem = null;
+            if (isHttpsUrl(redeemUrl)) {
+              redeem = button(text.redeemButton, "ia-raf-copy", () => {
+                window.open(redeemUrl, "_blank", "noopener,noreferrer");
+              });
+              redeem.setAttribute("aria-label", `${text.redeemButton} ${reward2.code}`);
+            }
+            return el("li", { className: "ia-raf-row" }, [
+              el("span", { className: "ia-raf-reward-code", text: reward2.code }),
+              redeem
+            ]);
+          }))
+        );
+      }
+      if (isHttpsUrl(stats.dashboardUrl)) {
+        const dashboardUrl = stats.dashboardUrl;
+        children.push(button(text.dashboardLink, "ia-raf-btn ia-raf-btn-secondary", () => {
+          window.open(dashboardUrl, "_blank", "noopener,noreferrer");
+        }));
+      }
+    }
+    children.push(status);
+    render(children);
+  }
+  async function start() {
+    renderLoading();
+    const [config, loaded] = await Promise.all([
+      deps.loadConfig(),
+      deps.hasToken().then((has) => has ? deps.loadDetails() : { kind: "signedOut" })
+    ]);
+    if (closed) return;
+    if (config) {
+      companyName = config.companyName;
+      if (!options.primaryColor && config.primaryColor) setColor(config.primaryColor);
+      if (!options.headline && config.headline) title.textContent = config.headline;
+      if (!options.rewardText && config.rewardText) {
+        reward.textContent = config.rewardText;
+        reward.hidden = false;
+      }
+    }
+    if (loaded.kind === "ok") {
+      if (!accountSaved && (options.appUserId || options.playPurchaseToken)) {
+        accountSaved = true;
+        void deps.saveAccount();
+      }
+      renderEnrolled(loaded.details, loaded.details);
+    } else if (loaded.kind === "failed") {
+      renderMessage(messageFor("NETWORK_ERROR"), () => void start());
+    } else if (config && !config.enabled) {
+      renderMessage(messageFor("PROGRAM_DISABLED"));
+    } else {
+      renderEnrolForm();
+    }
+  }
+  const handle = { close };
+  openModal = {
+    handle,
+    focus: () => {
+      if (!dialog.contains(document.activeElement)) (focusables()[0] || closeButton).focus();
+    }
+  };
+  void start();
+  return handle;
+}
+
 // src/sdk/InsertAffiliate.ts
 var InsertAffiliate = class {
   static verboseLog(message) {
@@ -641,6 +1421,214 @@ var InsertAffiliate = class {
       this.verboseLog(`Error fetching/opening offer code: ${err}`);
     }
   }
+  // ---------------------------------------------------------------------------
+  // In-app referrals: make the app's own user an affiliate and read their stats
+  // ---------------------------------------------------------------------------
+  static async referralCompanyId() {
+    try {
+      return this.companyCode || await getValue("companyCode");
+    } catch (e) {
+      return this.companyCode;
+    }
+  }
+  /**
+   * The device id in this browser's "{shortCode}-{deviceId}" identifier, so the
+   * server can tell a referrer apart from the friends they refer.
+   * Null when storage is unavailable.
+   */
+  static async referralDeviceId() {
+    try {
+      return await this.getOrCreateUserID();
+    } catch (e) {
+      return null;
+    }
+  }
+  static notInitializedResult() {
+    this.verboseLog("Cannot use referrals: no company code available. Call initialize first.");
+    return {
+      status: "error",
+      errorCode: "NOT_INITIALIZED",
+      errorMessage: "The Insert Affiliate SDK is not initialized with a company code."
+    };
+  }
+  /**
+   * Makes the app's user an affiliate (a referrer) of this company.
+   * A new email is created straight away and this device is connected.
+   * An email that is already an affiliate is sent a 6-digit code instead:
+   * the result is `verificationRequired`; finish with verifyAffiliateCode.
+   * @param email The user's email (usually the app's logged-in user)
+   * @param name The user's display name
+   * @param options The user's own accounts (RevenueCat / Adapty app user id,
+   *   Google Play purchase token), used to grant their referral rewards
+   */
+  static async createAffiliateForUser(email, name, options) {
+    this.verboseLog("Creating affiliate for app user...");
+    const companyId = await this.referralCompanyId();
+    if (!companyId) return this.notInitializedResult();
+    const result = await postEnrolment("enrol", companyId, __spreadValues({
+      email: (email || "").trim(),
+      name: (name || "").trim()
+    }, await this.referrerAccountFields(options)), (message) => this.verboseLog(message));
+    if (result.status !== "error") this.lastReferralDetails = null;
+    return result;
+  }
+  /**
+   * Finishes connecting this device with the 6-digit code emailed by
+   * createAffiliateForUser. On success the device is connected.
+   * @param email The same email passed to createAffiliateForUser
+   * @param code The 6-digit code from the email
+   * @param name Optional display name, used if the affiliate is created now
+   * @param options The user's own accounts, as for createAffiliateForUser
+   */
+  static async verifyAffiliateCode(email, code, name, options) {
+    this.verboseLog("Verifying affiliate code...");
+    const companyId = await this.referralCompanyId();
+    if (!companyId) return this.notInitializedResult();
+    const result = await postEnrolment("verify", companyId, __spreadValues({
+      email: (email || "").trim(),
+      code: normalizeVerificationCode(code),
+      name: (name || "").trim()
+    }, await this.referrerAccountFields(options)), (message) => this.verboseLog(message));
+    if (result.status !== "error") this.lastReferralDetails = null;
+    return result;
+  }
+  static async referrerAccountFields(options) {
+    return {
+      deviceId: await this.referralDeviceId() || void 0,
+      appUserId: options && options.appUserId,
+      playPurchaseToken: options && options.playPurchaseToken
+    };
+  }
+  /**
+   * Saves the connected referrer's own accounts, for apps whose user
+   * subscribes or logs in after joining. The server then grants any
+   * rewards that were waiting for them.
+   * @param options The RevenueCat / Adapty app user id and/or the Google Play purchase token
+   * @returns True when saved; false when no referrer is connected on this device
+   *   or the request failed. A revoked connection is cleared.
+   */
+  static async setReferrerAccount(options) {
+    this.verboseLog("Saving referrer account...");
+    const companyId = await this.referralCompanyId();
+    const token = companyId ? readReferrerToken(companyId) : null;
+    if (!companyId || !token) {
+      this.verboseLog("Cannot save referrer account: no referrer connected on this device");
+      return false;
+    }
+    const saved = await postReferrerIdentity(
+      companyId,
+      token,
+      await this.referrerAccountFields(options),
+      (message) => this.verboseLog(message)
+    );
+    if (!readReferrerToken(companyId)) this.lastReferralDetails = null;
+    this.verboseLog(`Referrer account saved: ${saved}`);
+    return saved;
+  }
+  static async loadMyAffiliateDetails() {
+    const companyId = await this.referralCompanyId();
+    const token = companyId ? readReferrerToken(companyId) : null;
+    if (!companyId || !token) {
+      this.verboseLog("No referrer connected on this device");
+      this.lastReferralDetails = null;
+      return { kind: "signedOut" };
+    }
+    const loaded = await fetchMyAffiliateDetails(companyId, token, (message) => this.verboseLog(message));
+    if (loaded.kind === "ok") this.lastReferralDetails = loaded.details;
+    if (loaded.kind === "signedOut") this.lastReferralDetails = null;
+    return loaded;
+  }
+  /**
+   * The connected user's affiliate details and referral stats.
+   * Values are for display: grant anything valuable from your server.
+   * @returns The details, or null when this device has no referrer connected
+   *   (or the request failed). A revoked connection is cleared.
+   */
+  static async getMyAffiliateDetails() {
+    this.verboseLog("Getting my affiliate details...");
+    const loaded = await this.loadMyAffiliateDetails();
+    return loaded.kind === "ok" ? loaded.details : null;
+  }
+  /**
+   * Whether this device has a referrer connected for this company.
+   * Local check only, no network.
+   */
+  static async isUserAnAffiliate() {
+    const companyId = await this.referralCompanyId();
+    return !!companyId && !!readReferrerToken(companyId);
+  }
+  /** Disconnects the referrer from this device (call on app logout). The affiliate account is kept. */
+  static async signOutAffiliate() {
+    this.verboseLog("Signing out referrer on this device");
+    const companyId = await this.referralCompanyId();
+    if (companyId) clearReferrerToken(companyId);
+    this.lastReferralDetails = null;
+  }
+  /** The company's in-app referral settings (program on/off, copy, colour), or null if unavailable. */
+  static async getReferralProgramConfig() {
+    this.verboseLog("Getting referral program config...");
+    const companyId = await this.referralCompanyId();
+    if (!companyId) {
+      this.verboseLog("Cannot get referral config: no company code available");
+      return null;
+    }
+    const config = await fetchReferralProgramConfig(companyId, (message) => this.verboseLog(message));
+    if (config) this.lastReferralConfig = config;
+    return config;
+  }
+  /**
+   * Shares the connected user's referral link with the system share sheet,
+   * or copies it to the clipboard where sharing is unavailable.
+   * Call from a click handler. Browsers only allow sharing and copying
+   * shortly after the tap, so this never waits on the network: it uses the
+   * details from the last getMyAffiliateDetails call and the app name from
+   * the last getReferralProgramConfig call. Load both before the user taps.
+   * Without loaded details it returns 'failed' and starts loading them, so a
+   * later tap can share.
+   * @param message Optional message. May use {link} and {code} placeholders.
+   */
+  static async shareReferralLink(message) {
+    this.verboseLog("Sharing referral link...");
+    const details = this.lastReferralDetails;
+    const config = this.lastReferralConfig;
+    if (!config) void this.getReferralProgramConfig();
+    if (!details) {
+      this.verboseLog("Cannot share: referrer details not loaded. Call getMyAffiliateDetails before the tap");
+      void this.getMyAffiliateDetails();
+      return "failed";
+    }
+    const text = buildReferralShareText(details, config ? config.companyName : "", message);
+    const outcome = await shareText(text);
+    this.verboseLog(`Share outcome: ${outcome}`);
+    return outcome;
+  }
+  /**
+   * Presents the drop-in "Refer a friend" modal. Handles enrolment, the
+   * email code step, sharing and stats. Browser only. Only one modal is
+   * shown at a time: calling this while it is open focuses the open one.
+   * @returns A handle whose close() dismisses the modal
+   */
+  static showReferAFriend(options = {}) {
+    if (typeof document === "undefined" || !document.body) {
+      console.error("[Insert Affiliate] showReferAFriend needs a browser document.");
+      return { close: () => void 0 };
+    }
+    if (!this.companyCode) {
+      this.verboseLog("showReferAFriend called before initialize; using the stored company code if any");
+    }
+    const account = {
+      appUserId: options.appUserId,
+      playPurchaseToken: options.playPurchaseToken
+    };
+    return presentReferAFriend(options, {
+      hasToken: () => this.isUserAnAffiliate(),
+      loadConfig: () => this.getReferralProgramConfig(),
+      loadDetails: () => this.loadMyAffiliateDetails(),
+      enrol: (email, name) => this.createAffiliateForUser(email, name, account),
+      verify: (email, code, name) => this.verifyAffiliateCode(email, code, name, account),
+      saveAccount: () => this.setReferrerAccount(account)
+    });
+  }
   static async getOrCreateUserID() {
     this.verboseLog("Getting or creating user ID...");
     let id = await getValue("userId");
@@ -685,6 +1673,11 @@ InsertAffiliate.affiliateAttributionActiveTime = null;
 // in milliseconds
 InsertAffiliate.preventAffiliateTransfer = false;
 InsertAffiliate.offerCode = null;
+// Last referral details and config seen. shareReferralLink uses only these,
+// so the share sheet opens without a network round trip (browsers require
+// the share to follow the user's tap closely).
+InsertAffiliate.lastReferralDetails = null;
+InsertAffiliate.lastReferralConfig = null;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   InsertAffiliate