@flamingo-stack/openframe-frontend-core 0.0.671 → 0.0.672-snapshot.20260928032919

package/dist/{chunk-3PVOF3IB.js → chunk-EVB3EO5S.js}

@@ -2,7 +2,7 @@
 import {
   useEndpointsRuntime,
   useRequiredEndpointsRuntime
-} from "./chunk-ZRIVCLPR.js";
+} from "./chunk-JD5TKRCU.js";
 import {
   contentFetch,
   createSearchParams,
@@ -3059,6 +3059,319 @@ function useHumanitySignals() {
   return { honeypotInputProps: { ref, name: HONEYPOT_FIELD }, getSignals, resetSignals };
 }
 
+// src/hooks/use-form-rescue.ts
+import { useCallback as useCallback14, useEffect as useEffect20, useMemo as useMemo7, useRef as useRef14 } from "react";
+
+// src/utils/form-rescue.ts
+var FORM_RESCUE_FORM_IDS = [
+  "contact",
+  "case_study_pitch",
+  "data_room_request",
+  "trust_center_request",
+  "tmcg_join",
+  "meeting_booking",
+  "waitlist"
+];
+function isFormRescueFormId(value) {
+  return typeof value === "string" && FORM_RESCUE_FORM_IDS.includes(value);
+}
+var FORM_RESCUE_VALUE_FIELDS = [
+  "email",
+  "name",
+  "firstName",
+  "lastName",
+  "company",
+  "jobtitle",
+  "companySize",
+  "linkedin_url"
+];
+var EXCLUDED_FIELD_PATTERN = /pass(word|code)?|card|cvv|cvc|ssn|social.?security|iban|bank|routing|token|secret|otp|pin$/i;
+function isExcludedRescueField(name) {
+  return EXCLUDED_FIELD_PATTERN.test(name);
+}
+var FORM_RESCUE_MAX_VALUE_CHARS = 200;
+var FORM_RESCUE_DEBOUNCE_MS = 1500;
+var FORM_RESCUE_MAX_FIELDS = 40;
+var FORM_RESCUE_ATTEMPT_FIELD = "form_attempt_id";
+var FORM_RESCUE_RESUME_FIELD = "form_resume_token";
+var FORM_RESCUE_SUBMIT_KEYS = [FORM_RESCUE_ATTEMPT_FIELD, FORM_RESCUE_RESUME_FIELD];
+var FORM_RESCUE_RESUME_PARAM = "resume";
+var FORM_DRAFT_STATUSES = ["started", "rescuable", "rescued", "submitted"];
+var EMAIL_PATTERN = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/;
+function isRescueEmail(value) {
+  return typeof value === "string" && value.length <= FORM_RESCUE_MAX_VALUE_CHARS && EMAIL_PATTERN.test(value.trim());
+}
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isFormAttemptId(value) {
+  return typeof value === "string" && UUID_PATTERN.test(value);
+}
+function isFilled(value) {
+  if (value == null) return false;
+  if (typeof value === "string") return value.trim().length > 0;
+  if (typeof value === "boolean") return value;
+  if (Array.isArray(value)) return value.length > 0;
+  if (typeof value === "object") return Object.values(value).some(isFilled);
+  return true;
+}
+function sanitizeRescueValues(values) {
+  const out = {};
+  if (!values || typeof values !== "object") return out;
+  for (const key of FORM_RESCUE_VALUE_FIELDS) {
+    if (isExcludedRescueField(key)) continue;
+    const raw = values[key];
+    if (typeof raw !== "string") continue;
+    const trimmed = raw.trim().slice(0, FORM_RESCUE_MAX_VALUE_CHARS);
+    if (trimmed) out[key] = trimmed;
+  }
+  return out;
+}
+function filledRescueFields(values, fieldNames) {
+  return fieldNames.filter((name) => !isExcludedRescueField(name) && isFilled(values[name])).slice(0, FORM_RESCUE_MAX_FIELDS);
+}
+function rescueCompletionPct(filledCount, totalCount) {
+  if (totalCount <= 0) return 0;
+  return Math.max(0, Math.min(100, Math.round(filledCount / totalCount * 100)));
+}
+function sanitizeRescueFieldName(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return /^[A-Za-z0-9_.-]{1,64}$/.test(trimmed) && !isExcludedRescueField(trimmed) ? trimmed : null;
+}
+var FORM_RESCUE_EVENTS = {
+  started: "form_started",
+  progress: "form_progress",
+  leadCaptured: "form_lead_captured",
+  abandoned: "form_abandoned",
+  submitted: "form_submitted",
+  rescued: "form_rescued",
+  resumed: "form_resumed"
+};
+function captureFormRescueEvent(event, properties) {
+  try {
+    if (typeof window === "undefined") return;
+    const ph = window.posthog;
+    if (typeof ph?.capture === "function") ph.capture(event, properties);
+  } catch {
+  }
+}
+
+// src/hooks/use-form-rescue.ts
+var LOCAL_DRAFT_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+var STORAGE_PREFIX = "form-rescue:v1:";
+var UTM_KEYS = ["source", "medium", "campaign", "content", "term"];
+function newAttemptId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+  const bytes = new Uint8Array(16);
+  crypto.getRandomValues(bytes);
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function readLocalDraft(formId) {
+  try {
+    const raw = window.localStorage.getItem(STORAGE_PREFIX + formId);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!isFormAttemptId(parsed.attemptId) || typeof parsed.savedAt !== "number") return null;
+    if (Date.now() - parsed.savedAt > LOCAL_DRAFT_TTL_MS) return null;
+    return { attemptId: parsed.attemptId, values: sanitizeRescueValues(parsed.values), savedAt: parsed.savedAt };
+  } catch {
+    return null;
+  }
+}
+function writeLocalDraft(formId, draft) {
+  try {
+    window.localStorage.setItem(STORAGE_PREFIX + formId, JSON.stringify(draft));
+  } catch {
+  }
+}
+function clearLocalDraft(formId) {
+  try {
+    window.localStorage.removeItem(STORAGE_PREFIX + formId);
+  } catch {
+  }
+}
+function readUtm() {
+  try {
+    const params = new URLSearchParams(window.location.search);
+    const utm = {};
+    for (const key of UTM_KEYS) {
+      const value = params.get(`utm_${key}`);
+      if (value) utm[key] = value.slice(0, 200);
+    }
+    return Object.keys(utm).length ? utm : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function useFormRescue({ formId, fieldNames, onRestore, getSignals }) {
+  const draftsUrl = useEndpointsRuntime()?.formDraftsUrl;
+  const attemptIdRef = useRef14(null);
+  const resumeTokenRef = useRef14(null);
+  const latestRef = useRef14(null);
+  const dirtyRef = useRef14(false);
+  const startedRef = useRef14(false);
+  const leadCapturedRef = useRef14(false);
+  const completedRef = useRef14(false);
+  const timerRef = useRef14(null);
+  const fieldNamesRef = useRef14(fieldNames);
+  const onRestoreRef = useRef14(onRestore);
+  const getSignalsRef = useRef14(getSignals);
+  useEffect20(() => {
+    fieldNamesRef.current = fieldNames;
+    onRestoreRef.current = onRestore;
+    getSignalsRef.current = getSignals;
+  });
+  const attemptId = useCallback14(() => {
+    if (!attemptIdRef.current) attemptIdRef.current = newAttemptId();
+    return attemptIdRef.current;
+  }, []);
+  const send = useCallback14(
+    (keepalive) => {
+      if (!formId || !draftsUrl || !dirtyRef.current || completedRef.current || !latestRef.current) return;
+      dirtyRef.current = false;
+      const body = {
+        attempt_id: attemptId(),
+        form_id: formId,
+        ...latestRef.current,
+        source_path: typeof window !== "undefined" ? window.location.pathname : "/",
+        utm: readUtm()
+      };
+      try {
+        void contentFetch(draftsUrl, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ ...body, ...getSignalsRef.current?.() ?? {} }),
+          keepalive
+        }).catch(() => void 0);
+      } catch {
+      }
+      captureFormRescueEvent(FORM_RESCUE_EVENTS.progress, {
+        form_id: formId,
+        attempt_id: attemptId(),
+        fields_filled: body.fields_filled,
+        last_field: body.last_field,
+        completion_pct: body.completion_pct
+      });
+    },
+    [attemptId, draftsUrl, formId]
+  );
+  useEffect20(() => {
+    if (!formId || typeof window === "undefined") return void 0;
+    let cancelled = false;
+    const token = new URLSearchParams(window.location.search).get(FORM_RESCUE_RESUME_PARAM);
+    const restoreLocal = () => {
+      const local = readLocalDraft(formId);
+      if (!local) return;
+      attemptIdRef.current = local.attemptId;
+      if (Object.keys(local.values).length) onRestoreRef.current?.(local.values);
+    };
+    if (token && draftsUrl && /^[A-Za-z0-9_-]{16,128}$/.test(token)) {
+      contentFetch(`${draftsUrl}/resume/${encodeURIComponent(token)}`).then(async (res) => res.ok ? await res.json() : null).then((data) => {
+        if (cancelled) return;
+        if (!data || data.form_id !== formId) {
+          restoreLocal();
+          return;
+        }
+        resumeTokenRef.current = token;
+        onRestoreRef.current?.(sanitizeRescueValues(data.values));
+        captureFormRescueEvent(FORM_RESCUE_EVENTS.resumed, { form_id: formId, attempt_id: attemptId() });
+      }).catch(() => {
+        if (!cancelled) restoreLocal();
+      });
+    } else {
+      restoreLocal();
+    }
+    return () => {
+      cancelled = true;
+    };
+  }, [attemptId, draftsUrl, formId]);
+  useEffect20(() => {
+    if (!formId || typeof document === "undefined") return void 0;
+    const onHide = () => {
+      if (completedRef.current || !startedRef.current) return;
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+      send(true);
+      captureFormRescueEvent(FORM_RESCUE_EVENTS.abandoned, {
+        form_id: formId,
+        attempt_id: attemptId(),
+        last_field: latestRef.current?.last_field ?? null,
+        completion_pct: latestRef.current?.completion_pct ?? 0
+      });
+    };
+    const onVisibility = () => {
+      if (document.visibilityState === "hidden") onHide();
+    };
+    document.addEventListener("visibilitychange", onVisibility);
+    window.addEventListener("pagehide", onHide);
+    return () => {
+      document.removeEventListener("visibilitychange", onVisibility);
+      window.removeEventListener("pagehide", onHide);
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, [attemptId, formId, send]);
+  const track = useCallback14(
+    (values, lastField) => {
+      if (!formId || completedRef.current) return;
+      const names = fieldNamesRef.current;
+      const visible = {};
+      for (const name of names) visible[name] = values[name];
+      const filled = filledRescueFields(visible, names);
+      if (!filled.length) return;
+      if (!startedRef.current) {
+        startedRef.current = true;
+        captureFormRescueEvent(FORM_RESCUE_EVENTS.started, { form_id: formId, attempt_id: attemptId() });
+      }
+      const clean = sanitizeRescueValues(visible);
+      if (!leadCapturedRef.current && isRescueEmail(clean.email)) {
+        leadCapturedRef.current = true;
+        captureFormRescueEvent(FORM_RESCUE_EVENTS.leadCaptured, { form_id: formId, attempt_id: attemptId() });
+      }
+      latestRef.current = {
+        values: clean,
+        fields_filled: filled,
+        last_field: sanitizeRescueFieldName(lastField),
+        completion_pct: rescueCompletionPct(filled.length, names.length)
+      };
+      dirtyRef.current = true;
+      writeLocalDraft(formId, { attemptId: attemptId(), values: clean, savedAt: Date.now() });
+      if (timerRef.current) clearTimeout(timerRef.current);
+      timerRef.current = setTimeout(() => {
+        timerRef.current = null;
+        send(false);
+      }, FORM_RESCUE_DEBOUNCE_MS);
+    },
+    [attemptId, formId, send]
+  );
+  const submitFields = useCallback14(() => {
+    if (!formId) return {};
+    return {
+      [FORM_RESCUE_ATTEMPT_FIELD]: attemptId(),
+      ...resumeTokenRef.current ? { [FORM_RESCUE_RESUME_FIELD]: resumeTokenRef.current } : {}
+    };
+  }, [attemptId, formId]);
+  const complete = useCallback14(() => {
+    if (!formId) return;
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    captureFormRescueEvent(FORM_RESCUE_EVENTS.submitted, { form_id: formId, attempt_id: attemptId() });
+    clearLocalDraft(formId);
+    attemptIdRef.current = null;
+    resumeTokenRef.current = null;
+    latestRef.current = null;
+    dirtyRef.current = false;
+    startedRef.current = false;
+    leadCapturedRef.current = false;
+  }, [attemptId, formId]);
+  return useMemo7(() => ({ track, submitFields, complete }), [track, submitFields, complete]);
+}
+
 export {
   useAutoLimitTags,
   useKeyboardCollisionPadding,
@@ -3144,6 +3457,27 @@ export {
   findHoneypotCopySource,
   evaluateHumanitySignals,
   splitCsvEnv,
-  useHumanitySignals
+  useHumanitySignals,
+  FORM_RESCUE_FORM_IDS,
+  isFormRescueFormId,
+  FORM_RESCUE_VALUE_FIELDS,
+  isExcludedRescueField,
+  FORM_RESCUE_MAX_VALUE_CHARS,
+  FORM_RESCUE_DEBOUNCE_MS,
+  FORM_RESCUE_MAX_FIELDS,
+  FORM_RESCUE_ATTEMPT_FIELD,
+  FORM_RESCUE_RESUME_FIELD,
+  FORM_RESCUE_SUBMIT_KEYS,
+  FORM_RESCUE_RESUME_PARAM,
+  FORM_DRAFT_STATUSES,
+  isRescueEmail,
+  isFormAttemptId,
+  sanitizeRescueValues,
+  filledRescueFields,
+  rescueCompletionPct,
+  sanitizeRescueFieldName,
+  FORM_RESCUE_EVENTS,
+  captureFormRescueEvent,
+  useFormRescue
 };
-//# sourceMappingURL=chunk-3PVOF3IB.js.map
+//# sourceMappingURL=chunk-EVB3EO5S.js.map