@empoweredvote/ev-ui 0.6.1 → 0.6.3

package/dist/index.mjs

@@ -2890,6 +2890,94 @@ var evContext = {
   async clear() {
     return send({ type: "ev-context:clear" });
   },
+  /**
+   * Read the userId-stamped authed slice for the given user.
+   *
+   * Stored shape:
+   *   { compass?, address?, verdicts?, authed?: { userId, compass?, address?, verdicts? } }
+   *
+   * - Returns null if there is no stored value, no `authed` body, or the stored
+   *   `authed.userId` does not match the requested `userId` (mismatch = inert).
+   * - Otherwise returns `{ compass, address, verdicts }` with undefined keys
+   *   omitted.
+   *
+   * Used by logged-in consumers to do SWR-style hydration: render this slice
+   * synchronously on mount, then replace silently when the API responds.
+   */
+  async getAuthedSlice(userId) {
+    if (!userId) return null;
+    const current = await this.get();
+    if (!current || !current.authed || typeof current.authed !== "object") return null;
+    if (current.authed.userId !== userId) return null;
+    const out = {};
+    if (current.authed.compass !== void 0) out.compass = current.authed.compass;
+    if (current.authed.address !== void 0) out.address = current.authed.address;
+    if (current.authed.verdicts !== void 0) out.verdicts = current.authed.verdicts;
+    if (current.authed.promotionDismissed !== void 0) {
+      out.promotionDismissed = current.authed.promotionDismissed;
+    }
+    return out;
+  },
+  /**
+   * Mirror an authed write into the userId-stamped `authed` slice.
+   *
+   * - `patch` may contain any subset of `{ compass, address, verdicts }`.
+   *   Unrecognized keys are dropped.
+   * - If the existing `authed.userId` matches `userId`, the patch is merged
+   *   with the prior authed body (per-domain shallow merge — the patch's
+   *   compass/address/verdicts replace the prior values).
+   * - If it does not match (user switch), the prior authed body is stomped.
+   * - Guest top-level keys (compass, address, verdicts at the root) are
+   *   preserved untouched.
+   *
+   * Returns false on falsy `userId` or empty patch; otherwise returns the
+   * underlying `set()` result.
+   */
+  async setAuthedSlice(userId, patch) {
+    if (!userId) return false;
+    if (!patch || typeof patch !== "object") return false;
+    const allowed = {};
+    if (patch.compass !== void 0) allowed.compass = patch.compass;
+    if (patch.address !== void 0) allowed.address = patch.address;
+    if (patch.verdicts !== void 0) allowed.verdicts = patch.verdicts;
+    if (patch.promotionDismissed !== void 0) {
+      allowed.promotionDismissed = patch.promotionDismissed;
+    }
+    if (Object.keys(allowed).length === 0) return false;
+    const current = await this.get() || {};
+    const priorAuthed = current.authed && current.authed.userId === userId ? current.authed : null;
+    const nextAuthed = { userId };
+    if (priorAuthed) {
+      if (priorAuthed.compass !== void 0) nextAuthed.compass = priorAuthed.compass;
+      if (priorAuthed.address !== void 0) nextAuthed.address = priorAuthed.address;
+      if (priorAuthed.verdicts !== void 0) nextAuthed.verdicts = priorAuthed.verdicts;
+      if (priorAuthed.promotionDismissed !== void 0) {
+        nextAuthed.promotionDismissed = priorAuthed.promotionDismissed;
+      }
+    }
+    if (allowed.compass !== void 0) nextAuthed.compass = allowed.compass;
+    if (allowed.address !== void 0) nextAuthed.address = allowed.address;
+    if (allowed.verdicts !== void 0) nextAuthed.verdicts = allowed.verdicts;
+    if (allowed.promotionDismissed !== void 0 && allowed.promotionDismissed !== null && typeof allowed.promotionDismissed === "object") {
+      const prior = priorAuthed && priorAuthed.promotionDismissed && typeof priorAuthed.promotionDismissed === "object" ? priorAuthed.promotionDismissed : {};
+      nextAuthed.promotionDismissed = { ...prior, ...allowed.promotionDismissed };
+    }
+    return this.set({ ...current, authed: nextAuthed });
+  },
+  /**
+   * Remove the `authed` slice entirely (preserving guest top-level keys).
+   *
+   * Provided for completeness — consumers in the v2026.4.5 wiring plan must
+   * NOT call this on logout. The slice is intended to go inert via userId
+   * mismatch, so a re-login as the same user can rehydrate from cache.
+   */
+  async clearAuthedSlice() {
+    const current = await this.get();
+    if (!current || typeof current !== "object") return true;
+    if (!("authed" in current)) return true;
+    const { authed: _omit, ...rest } = current;
+    return this.set(rest);
+  },
   /**
    * Subscribe to live updates. Fires when this tab or any other tab
    * (any subdomain) writes to the store. Returns an unsubscribe function.
@@ -5642,8 +5730,167 @@ function computeTierCoverage(topics) {
   return counts;
 }
 
+// src/useEvContextPromotion.js
+import { useEffect as useEffect9, useState as useState15, useCallback, useRef as useRef3 } from "react";
+function useEvContextPromotion({
+  domain,
+  isLoggedIn,
+  userId,
+  apiData,
+  apiWriter,
+  enabled = true
+}) {
+  const [shouldPrompt, setShouldPrompt] = useState15(false);
+  const [payload, setPayload] = useState15(null);
+  const [status, setStatus] = useState15("idle");
+  const [error, setError] = useState15(null);
+  const apiDataRef = useRef3(apiData);
+  apiDataRef.current = apiData;
+  const userIdRef = useRef3(userId);
+  userIdRef.current = userId;
+  const isLoggedInRef = useRef3(isLoggedIn);
+  isLoggedInRef.current = isLoggedIn;
+  const enabledRef = useRef3(enabled);
+  enabledRef.current = enabled;
+  const domainRef = useRef3(domain);
+  domainRef.current = domain;
+  const apiWriterRef = useRef3(apiWriter);
+  apiWriterRef.current = apiWriter;
+  const detect = useCallback(async () => {
+    const _enabled = enabledRef.current;
+    const _isLoggedIn = isLoggedInRef.current;
+    const _userId = userIdRef.current;
+    const _apiData = apiDataRef.current;
+    const _domain = domainRef.current;
+    if (!_enabled || !_isLoggedIn || !_userId) {
+      setShouldPrompt(false);
+      setPayload(null);
+      return;
+    }
+    if (!isApiEmpty(_domain, _apiData)) {
+      setShouldPrompt(false);
+      setPayload(null);
+      return;
+    }
+    try {
+      const slice = await evContext.getAuthedSlice(_userId);
+      if (slice && slice.promotionDismissed && slice.promotionDismissed[_domain] === true) {
+        setShouldPrompt(false);
+        setPayload(null);
+        return;
+      }
+    } catch {
+    }
+    let guest = null;
+    try {
+      guest = await evContext.get();
+    } catch {
+      guest = null;
+    }
+    if (isGuestPopulated(_domain, guest)) {
+      setShouldPrompt(true);
+      setPayload(guest[_domain]);
+    } else {
+      setShouldPrompt(false);
+      setPayload(null);
+    }
+  }, []);
+  useEffect9(() => {
+    detect();
+  }, [detect, isLoggedIn, userId, apiData, enabled, domain]);
+  useEffect9(() => {
+    const unsub = evContext.subscribe(() => {
+      detect();
+    });
+    return unsub;
+  }, [detect]);
+  const promote = useCallback(async () => {
+    const _userId = userIdRef.current;
+    const _domain = domainRef.current;
+    const _writer = apiWriterRef.current;
+    const _payload = payload;
+    if (!_userId || !_payload || typeof _writer !== "function") return;
+    setStatus("saving");
+    setError(null);
+    try {
+      await _writer(_payload);
+      try {
+        await evContext.setAuthedSlice(_userId, { [_domain]: _payload });
+      } catch {
+      }
+      try {
+        await evContext.setAuthedSlice(_userId, {
+          promotionDismissed: { [_domain]: false }
+        });
+      } catch {
+      }
+      setStatus("saved");
+      setShouldPrompt(false);
+    } catch (err) {
+      setStatus("error");
+      setError(err instanceof Error ? err : new Error(String(err)));
+    }
+  }, [payload]);
+  const dismiss = useCallback(async () => {
+    const _userId = userIdRef.current;
+    const _domain = domainRef.current;
+    if (!_userId) return;
+    try {
+      await evContext.setAuthedSlice(_userId, {
+        promotionDismissed: { [_domain]: true }
+      });
+    } catch {
+    }
+    setShouldPrompt(false);
+  }, []);
+  return { shouldPrompt, payload, promote, dismiss, status, error };
+}
+function isApiEmpty(domain, apiData) {
+  if (apiData === null || apiData === void 0) return true;
+  if (domain === "compass") {
+    if (typeof apiData !== "object") return false;
+    if (Array.isArray(apiData)) return apiData.length === 0;
+    if (apiData.answers && typeof apiData.answers === "object") {
+      return Object.keys(apiData.answers).length === 0;
+    }
+    return Object.keys(apiData).length === 0;
+  }
+  if (domain === "address") {
+    if (typeof apiData === "string") return apiData.trim().length === 0;
+    if (typeof apiData !== "object") return false;
+    const a = apiData;
+    const hasAddr = typeof a.formatted === "string" && a.formatted.length > 0;
+    const hasAddrAlt = typeof a.addr === "string" && a.addr.length > 0;
+    const hasLat = typeof a.lat === "number" || typeof a.latitude === "number";
+    return !(hasAddr || hasAddrAlt || hasLat);
+  }
+  if (domain === "verdicts") {
+    if (typeof apiData !== "object") return false;
+    if (Array.isArray(apiData)) return apiData.length === 0;
+    return Object.keys(apiData).length === 0;
+  }
+  return false;
+}
+function isGuestPopulated(domain, fullEvContext) {
+  if (!fullEvContext || typeof fullEvContext !== "object") return false;
+  const slice = fullEvContext[domain];
+  if (!slice || typeof slice !== "object") return false;
+  if (domain === "compass") {
+    const ans = slice.answers || slice.a;
+    if (ans && typeof ans === "object") return Object.keys(ans).length > 0;
+    return false;
+  }
+  if (domain === "address") {
+    return typeof slice.formatted === "string" && slice.formatted.length > 0 || typeof slice.addr === "string" && slice.addr.length > 0;
+  }
+  if (domain === "verdicts") {
+    return Object.keys(slice).length > 0;
+  }
+  return false;
+}
+
 // src/StanceAccordion.jsx
-import React29, { useState as useState15, useRef as useRef3, useCallback, useEffect as useEffect9 } from "react";
+import React29, { useState as useState16, useRef as useRef4, useCallback as useCallback2, useEffect as useEffect10 } from "react";
 
 // src/Favicon.jsx
 import React28 from "react";
@@ -5704,11 +5951,11 @@ function StanceAccordion({
   apiUrl = "https://api.empowered.vote"
 }) {
   var _a;
-  const [expandedTopicId, setExpandedTopicId] = useState15(null);
-  const [loadingId, setLoadingId] = useState15(null);
-  const [showAll, setShowAll] = useState15(false);
-  const contextCache = useRef3(/* @__PURE__ */ new Map());
-  const quotesCache = useRef3(null);
+  const [expandedTopicId, setExpandedTopicId] = useState16(null);
+  const [loadingId, setLoadingId] = useState16(null);
+  const [showAll, setShowAll] = useState16(false);
+  const contextCache = useRef4(/* @__PURE__ */ new Map());
+  const quotesCache = useRef4(null);
   const polAnswerMap = {};
   if (polAnswers) {
     polAnswers.forEach((a) => {
@@ -5767,7 +6014,7 @@ function StanceAccordion({
       quotesCache.current = [];
     }
   }
-  const handleToggle = useCallback(
+  const handleToggle = useCallback2(
     async (topicId) => {
       if (expandedTopicId === topicId) {
         setExpandedTopicId(null);
@@ -5784,7 +6031,7 @@ function StanceAccordion({
     },
     [expandedTopicId, politicianId, apiUrl]
   );
-  useEffect9(() => {
+  useEffect10(() => {
     if (initialExpandedTopicId && topics && topics.length > 0) {
       handleToggle(String(initialExpandedTopicId));
     }
@@ -6061,6 +6308,7 @@ export {
   spacing,
   textStyles,
   tierColors,
+  useEvContextPromotion,
   useMediaQuery,
   zIndex
 };