@the-portland-company/shell 0.55.0 → 0.57.0

package/dist/app-chrome.d.cts

@@ -119,6 +119,19 @@ declare const POLITOGY_APPS: Record<PolitogyAppKey, {
     origin: string;
     storagePrefix: string;
     mode?: PolitogyAppMode;
+    /**
+     * DUAL-MODE apps (today: a2p — Specs/A2P: "the SMS/MMS delivery engine
+     * for Relationship Mode and Campaign Mode") have no single fixed mode.
+     * `mode` above stays the fallback/default identity for any code that
+     * still reads `meta.mode` directly; FrameBody instead resolves the
+     * EFFECTIVE mode via `resolveActiveMode` (?mode= query → the
+     * `politogy_active_mode` cookie → `defaultMode`) and uses that for the
+     * nav tree, the Mode pill, and the brand lockup.
+     */
+    dual?: {
+        modes: readonly StandardNavMode[];
+        defaultMode: StandardNavMode;
+    };
     /** See PolitogyFrameGrant. Omitted => the app may pass no frame input. */
     grants?: readonly PolitogyFrameGrant[];
     /**

package/dist/app-chrome.d.ts

@@ -119,6 +119,19 @@ declare const POLITOGY_APPS: Record<PolitogyAppKey, {
     origin: string;
     storagePrefix: string;
     mode?: PolitogyAppMode;
+    /**
+     * DUAL-MODE apps (today: a2p — Specs/A2P: "the SMS/MMS delivery engine
+     * for Relationship Mode and Campaign Mode") have no single fixed mode.
+     * `mode` above stays the fallback/default identity for any code that
+     * still reads `meta.mode` directly; FrameBody instead resolves the
+     * EFFECTIVE mode via `resolveActiveMode` (?mode= query → the
+     * `politogy_active_mode` cookie → `defaultMode`) and uses that for the
+     * nav tree, the Mode pill, and the brand lockup.
+     */
+    dual?: {
+        modes: readonly StandardNavMode[];
+        defaultMode: StandardNavMode;
+    };
     /** See PolitogyFrameGrant. Omitted => the app may pass no frame input. */
     grants?: readonly PolitogyFrameGrant[];
     /**

package/dist/app-chrome.js

@@ -1,6 +1,6 @@
 "use client";
 import { broadcastLogout, watchLogout } from './chunk-LL6LSJAH.js';
-import { clearBetaBannerDismissal, standardPolitogyNav, NavAppShell, NavChromeProvider, FuelAction, NavDisplayAction, TopBarWidgetSlot, SupportAction, NotificationsAction, useChromeMe, useThemePreference, useNavChromeFetcher, useChromeOrgs } from './chunk-K5GWJSHE.js';
+import { clearBetaBannerDismissal, standardPolitogyNav, NavAppShell, NavChromeProvider, FuelAction, NavDisplayAction, TopBarWidgetSlot, SpecOverlayAction, SupportAction, NotificationsAction, useChromeMe, useThemePreference, useNavChromeFetcher, useChromeOrgs } from './chunk-TMOZTLUZ.js';
 import './chunk-U4RZPZET.js';
 import { NAV_DISPLAY_DEFAULT, resolveNavDisplay, isNavDisplayPreference, writeNavDisplayCookie, writeNavDisplayLocal, NAV_DISPLAY_STORAGE_KEY, readNavDisplayCookie } from './chunk-6UHJV2FH.js';
 import { resolveActiveOrg, isOrgId, writeActiveOrgCookie, ACTIVE_ORG_QUERY_PARAM, readActiveOrgCookie } from './chunk-W2HITMV5.js';
@@ -78,6 +78,58 @@ function resolveIdentity(input) {
     loaded: input.loaded ?? false
   };
 }
+
+// src/mode-preference.ts
+var ACTIVE_MODE_COOKIE = "politogy_active_mode";
+var VALID_MODES = ["relationship", "campaign", "petition"];
+function isStandardNavMode(v) {
+  return typeof v === "string" && VALID_MODES.includes(v);
+}
+function readActiveModeCookie() {
+  if (typeof document === "undefined") return null;
+  try {
+    const m = document.cookie.match(
+      new RegExp(`(?:^|;\\s*)${ACTIVE_MODE_COOKIE}=([^;]+)`)
+    );
+    const v = m ? decodeURIComponent(m[1]) : null;
+    return isStandardNavMode(v) ? v : null;
+  } catch {
+    return null;
+  }
+}
+function writeActiveModeCookie(mode) {
+  if (typeof document === "undefined" || typeof window === "undefined") return;
+  const host = window.location.hostname;
+  const domainAttr = /(^|\.)politogyvrm\.com$/i.test(host) ? "; Domain=.politogyvrm.com" : "";
+  const secure = window.location.protocol === "https:" ? "; Secure" : "";
+  document.cookie = `${ACTIVE_MODE_COOKIE}=${encodeURIComponent(
+    mode
+  )}; Path=/; Max-Age=31536000; SameSite=Lax${domainAttr}${secure}`;
+}
+function modeFromSearch(search) {
+  if (!search) return null;
+  try {
+    const params = new URLSearchParams(search.startsWith("?") ? search.slice(1) : search);
+    return params.get("mode");
+  } catch {
+    return null;
+  }
+}
+function resolveActiveMode({
+  search,
+  modes,
+  defaultMode
+}) {
+  const fromQuery = modeFromSearch(search);
+  if (fromQuery && isStandardNavMode(fromQuery) && modes.includes(fromQuery)) {
+    return fromQuery;
+  }
+  const fromCookie = readActiveModeCookie();
+  if (fromCookie && modes.includes(fromCookie)) {
+    return fromCookie;
+  }
+  return defaultMode;
+}
 var BOOT_STAGE_TABLE = [
   { id: "s0_session", weight: 5, critical: true, waitsOn: "Politogy ID session resolution" },
   { id: "s1_org", weight: 10, critical: true, waitsOn: "Chrome API /api/chrome/me + orgs" },
@@ -447,7 +499,17 @@ var POLITOGY_APPS = {
   // Campaign Mode apps — each scoped to Campaign, so they render the Campaign
   // tree and a static Campaign pill. Not yet deployed; hidden from the Campaign
   // nav by CAMPAIGN_FEATURE_AVAILABILITY until their launch flips the flag.
-  a2p: { title: "A2P Messaging", origin: "https://a2p.politogyvrm.com", storagePrefix: "a2p", mode: "campaign" },
+  // Dual-mode: a2p is the SMS/MMS delivery engine for BOTH Relationship Mode
+  // and Campaign Mode (Specs/A2P). `mode: 'campaign'` stays the fallback for
+  // anything reading `meta.mode` directly; the effective mode a user sees is
+  // resolved per-visit (see `dual`, resolveActiveMode).
+  a2p: {
+    title: "A2P Messaging",
+    origin: "https://a2p.politogyvrm.com",
+    storagePrefix: "a2p",
+    mode: "campaign",
+    dual: { modes: ["relationship", "campaign"], defaultMode: "campaign" }
+  },
   phonebank: { title: "Phone Banking", origin: "https://phonebank.politogyvrm.com", storagePrefix: "phonebank", mode: "campaign" },
   canvass: { title: "Field Canvassing", origin: "https://canvass.politogyvrm.com", storagePrefix: "canvass", mode: "campaign" },
   signs: { title: "Sign Mapping", origin: "https://signs.politogyvrm.com", storagePrefix: "signs", mode: "campaign" }
@@ -584,9 +646,19 @@ function FrameBody({
   });
   const userMenu = core?.userMenu ?? derivedUserMenu;
   const footer = useChromeFooter(buildMeta ?? {});
-  const appMode = meta.mode;
+  const resolvedDualMode = meta.dual ? resolveActiveMode({
+    search: search ?? (typeof window !== "undefined" ? window.location.search : void 0),
+    modes: meta.dual.modes,
+    defaultMode: meta.dual.defaultMode
+  }) : void 0;
+  const appMode = resolvedDualMode ?? meta.mode;
   const derivedMode = useChromeMode(appMode ? { pinnedModeId: appMode } : void 0);
   const mode = core?.mode ?? derivedMode;
+  const coreLiveMode = app === CORE_APP ? pathname.startsWith("/campaign") ? "campaign" : pathname.startsWith("/relationship") ? "relationship" : void 0 : void 0;
+  const cookieMode = coreLiveMode ?? (meta.dual ? void 0 : meta.mode);
+  useEffect(() => {
+    if (cookieMode) writeActiveModeCookie(cookieMode);
+  }, [cookieMode]);
   const coreOrgs = chrome?.orgs ?? [];
   const activeCoreOrg = coreOrgs.find((o) => o.id === chrome?.orgId) ?? null;
   const navDisplay = chrome?.navDisplay ?? "both";
@@ -959,18 +1031,71 @@ function AppDevNotes({
     }),
     [storagePrefix, identity.role]
   );
-  if (devNotes?.providedByApp) return /* @__PURE__ */ jsx(DevNotesSurface, { children });
-  return /* @__PURE__ */ jsx(DevNotesProvider, { adapter, user, config, children: /* @__PURE__ */ jsx(DevNotesSurface, { children }) });
+  const activatedRef = useRef(false);
+  const activationWaitersRef = useRef([]);
+  const activate = useCallback(() => {
+    if (activatedRef.current) return;
+    activatedRef.current = true;
+    const waiters = activationWaitersRef.current;
+    activationWaitersRef.current = [];
+    waiters.forEach((resolve) => resolve());
+  }, []);
+  const waitForActivation = useCallback(() => {
+    if (activatedRef.current) return Promise.resolve();
+    return new Promise((resolve) => {
+      activationWaitersRef.current.push(resolve);
+    });
+  }, []);
+  const lazyAdapter = useMemo(() => {
+    const GATED_METHODS = [
+      "fetchTasks",
+      "fetchTaskTypes",
+      "fetchTaskLists",
+      "fetchCollaborators",
+      "fetchCapabilities",
+      "getAppLinkStatus",
+      "fetchBugReports",
+      "fetchBugReportTypes"
+    ];
+    const wrapped = { ...adapter };
+    for (const method of GATED_METHODS) {
+      const original = adapter[method].bind(adapter);
+      wrapped[method] = (...args) => waitForActivation().then(() => original(...args));
+    }
+    let idleScheduled = false;
+    const originalUnreadCounts = adapter.fetchUnreadCounts.bind(adapter);
+    wrapped.fetchUnreadCounts = () => {
+      if (idleScheduled || typeof window === "undefined") return originalUnreadCounts();
+      idleScheduled = true;
+      return new Promise((resolve, reject) => {
+        const run = () => originalUnreadCounts().then(resolve, reject);
+        const ric = window.requestIdleCallback;
+        if (ric) ric(run);
+        else setTimeout(run, 0);
+      });
+    };
+    return wrapped;
+  }, [adapter, waitForActivation]);
+  if (devNotes?.providedByApp) return /* @__PURE__ */ jsx(DevNotesSurface, { activate, children });
+  return /* @__PURE__ */ jsx(DevNotesProvider, { adapter: lazyAdapter, user, config, children: /* @__PURE__ */ jsx(DevNotesSurface, { activate, children }) });
 }
 var DevNotesTasksContext = createContext({
   ready: false,
   openTasks: () => {
+  },
+  activate: () => {
   }
 });
-function DevNotesSurface({ children }) {
+function DevNotesSurface({
+  activate,
+  children
+}) {
   const [tasksOpen, setTasksOpen] = useState(false);
-  const openTasks = useCallback(() => setTasksOpen(true), []);
-  const tasksCtx = useMemo(() => ({ ready: true, openTasks }), [openTasks]);
+  const openTasks = useCallback(() => {
+    activate();
+    setTasksOpen(true);
+  }, [activate]);
+  const tasksCtx = useMemo(() => ({ ready: true, openTasks, activate }), [openTasks, activate]);
   return /* @__PURE__ */ jsxs(DevNotesTasksContext.Provider, { value: tasksCtx, children: [
     children,
     tasksOpen ? /* @__PURE__ */ jsx(DevNotesTaskListModal, { open: true, onClose: () => setTasksOpen(false) }) : null,
@@ -1026,14 +1151,15 @@ function ChromeTopBarActions() {
         children: /* @__PURE__ */ jsx(ChromeDevNotesMenu, {})
       }
     ),
+    /* @__PURE__ */ jsx(SpecOverlayAction, { orgId: state.orgId }),
     /* @__PURE__ */ jsx(SupportAction, { orgId: state.orgId }),
     /* @__PURE__ */ jsx(NotificationsAction, { orgId: state.orgId })
   ] });
 }
 function ChromeDevNotesMenu() {
-  const { ready, openTasks } = useContext(DevNotesTasksContext);
+  const { ready, openTasks, activate } = useContext(DevNotesTasksContext);
   if (!ready) return null;
-  return /* @__PURE__ */ jsx(DevNotesMenu, { position: "top-right", onViewTasks: openTasks });
+  return /* @__PURE__ */ jsx("span", { style: { display: "contents" }, onPointerDownCapture: activate, onFocusCapture: activate, onKeyDownCapture: activate, children: /* @__PURE__ */ jsx(DevNotesMenu, { position: "top-right", onViewTasks: openTasks }) });
 }
 function useIsSuperAdmin() {
   const state = useChromeState();