@the-portland-company/shell 0.75.2 → 0.76.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.76.0
+
+Auth-owned active org, shell phase (Global-Rules v38, UI-Platform v46; plan `specs/docs/auth-owned-active-org-plan.md` §3.2). Opt-in: no change for apps that do not pass `tokenOrg`.
+
+- **`tokenOrg` on `PolitogyAppChrome` / frame data.** The org comes from the app's verified token claims (`org_id`, `org_role`). The pill switch calls `POST {auth}/api/active-org`, then the app's `onReexchange(orgId, { perTab: false })`. A refused switch rolls back and calls `onSwitchError`.
+- **Per-tab override.** `?org_id=` (or legacy `?org=`) scopes this tab only: the chrome calls `onReexchange(orgId, { perTab: true })` and never changes the shared org or the cookie. A non-member selector is ignored.
+- **URL = 7-char tail.** Token mode writes `org_id=<last 7>` and drops `?org=` with a replace. Full uuid and the 6-char tail are accepted.
+- **No per-request chrome `/api/orgs`** when the app passes `tokenOrg.orgs`; `useChromeOrgs({ enabled })` and `SupportAction` reuse the chrome list.
+- **`active-org` helpers:** `switchActiveOrg`, `ActiveOrgSwitchError`, `orgClaimsFromToken`, `orgClaimsFrom`, `orgIdTail`, `isOrgSelector`, `matchOrgSelector`, `readOrgSelectorFromUrl`, `withOrgIdParam`, `authBaseUrl`. `readActiveOrgCookie` / `resolveActiveOrg` are deprecated; the legacy cookie is still written for apps not yet on v2.
+
 ## 0.75.2
 
 Two fixes found on top of 0.75.1:

package/dist/active-org.cjs

@@ -60,15 +60,134 @@ function withActiveOrgParam(url, orgId) {
     return url;
   }
 }
+var ORG_ID_QUERY_PARAM = "org_id";
+var ORG_ID_TAIL_LENGTH = 7;
+var LEGACY_ORG_TAIL_LENGTH = 6;
+var TAIL_RE = /^[0-9a-f]{6,7}$/i;
+var AUTH_BASE_URL = "https://auth.politogyvrm.com";
+var AUTH_BASE_URL_STAGING = "https://auth-staging.politogyvrm.com";
+function orgIdTail(orgId) {
+  return isOrgId(orgId) ? orgId.trim().toLowerCase().slice(-ORG_ID_TAIL_LENGTH) : null;
+}
+function isOrgSelector(v) {
+  return typeof v === "string" && (UUID_RE.test(v.trim()) || TAIL_RE.test(v.trim()));
+}
+function matchOrgSelector(selector, orgs) {
+  if (!isOrgSelector(selector)) return null;
+  const sel = selector.trim().toLowerCase();
+  if (UUID_RE.test(sel)) return orgs.find((o) => o.id.toLowerCase() === sel) ?? null;
+  if (sel.length !== ORG_ID_TAIL_LENGTH && sel.length !== LEGACY_ORG_TAIL_LENGTH) return null;
+  const hits = orgs.filter((o) => o.id.toLowerCase().endsWith(sel));
+  return hits.length === 1 ? hits[0] : null;
+}
+function readOrgSelectorFromUrl(search) {
+  if (!search) return null;
+  try {
+    const qs = search.includes("?") ? search.slice(search.indexOf("?") + 1) : search;
+    const params = new URLSearchParams(qs);
+    for (const key of [ORG_ID_QUERY_PARAM, ACTIVE_ORG_QUERY_PARAM]) {
+      const v = params.get(key);
+      if (isOrgSelector(v)) return v.trim().toLowerCase();
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function withOrgIdParam(url, orgId) {
+  const tail = orgIdTail(orgId);
+  if (!tail) return url;
+  try {
+    const base = typeof window !== "undefined" ? window.location.origin : "https://politogyvrm.com";
+    const u = new URL(url, base);
+    u.searchParams.delete(ACTIVE_ORG_QUERY_PARAM);
+    u.searchParams.set(ORG_ID_QUERY_PARAM, tail);
+    return /^https?:\/\//i.test(url) ? u.toString() : `${u.pathname}${u.search}${u.hash}`;
+  } catch {
+    return url;
+  }
+}
+function orgClaimsFrom(claims) {
+  if (!claims || typeof claims !== "object") return null;
+  const c = claims;
+  if (!isOrgId(c.org_id)) return null;
+  return {
+    orgId: c.org_id.trim().toLowerCase(),
+    orgRole: typeof c.org_role === "string" ? c.org_role : null
+  };
+}
+function orgClaimsFromToken(token) {
+  if (typeof token !== "string") return null;
+  const part = token.split(".")[1];
+  if (!part) return null;
+  try {
+    const b64 = part.replace(/-/g, "+").replace(/_/g, "/");
+    const padded = b64 + "=".repeat((4 - b64.length % 4) % 4);
+    const json = typeof atob === "function" ? decodeURIComponent(
+      Array.from(atob(padded), (ch) => "%" + ch.charCodeAt(0).toString(16).padStart(2, "0")).join("")
+    ) : "";
+    return orgClaimsFrom(JSON.parse(json));
+  } catch {
+    return null;
+  }
+}
+function authBaseUrl() {
+  if (typeof window !== "undefined" && window.location.hostname.toLowerCase().includes("staging")) {
+    return AUTH_BASE_URL_STAGING;
+  }
+  return AUTH_BASE_URL;
+}
+var ActiveOrgSwitchError = class extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "ActiveOrgSwitchError";
+  }
+};
+async function switchActiveOrg(orgId, opts = {}) {
+  if (!isOrgId(orgId)) throw new ActiveOrgSwitchError(400, "org_id must be a full uuid");
+  const doFetch = opts.fetch ?? fetch;
+  const res = await doFetch(`${opts.authBaseUrl ?? authBaseUrl()}/api/active-org`, {
+    method: "POST",
+    credentials: "include",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ org_id: orgId })
+  });
+  if (!res.ok) {
+    let msg = `active-org switch failed (${res.status})`;
+    try {
+      const body = await res.json();
+      if (body?.error) msg = body.error;
+    } catch {
+    }
+    throw new ActiveOrgSwitchError(res.status, msg);
+  }
+  const claims = orgClaimsFrom(await res.json().catch(() => null));
+  if (!claims) throw new ActiveOrgSwitchError(502, "active-org switch returned no org_id");
+  writeActiveOrgCookie(claims.orgId);
+  return claims;
+}
 
 exports.ACTIVE_ORG_COOKIE = ACTIVE_ORG_COOKIE;
 exports.ACTIVE_ORG_QUERY_PARAM = ACTIVE_ORG_QUERY_PARAM;
+exports.ActiveOrgSwitchError = ActiveOrgSwitchError;
+exports.ORG_ID_QUERY_PARAM = ORG_ID_QUERY_PARAM;
+exports.ORG_ID_TAIL_LENGTH = ORG_ID_TAIL_LENGTH;
 exports.activeOrgParam = activeOrgParam;
+exports.authBaseUrl = authBaseUrl;
 exports.isOrgId = isOrgId;
+exports.isOrgSelector = isOrgSelector;
+exports.matchOrgSelector = matchOrgSelector;
+exports.orgClaimsFrom = orgClaimsFrom;
+exports.orgClaimsFromToken = orgClaimsFromToken;
+exports.orgIdTail = orgIdTail;
 exports.readActiveOrgCookie = readActiveOrgCookie;
 exports.readActiveOrgFromUrl = readActiveOrgFromUrl;
+exports.readOrgSelectorFromUrl = readOrgSelectorFromUrl;
 exports.resolveActiveOrg = resolveActiveOrg;
+exports.switchActiveOrg = switchActiveOrg;
 exports.withActiveOrgParam = withActiveOrgParam;
+exports.withOrgIdParam = withOrgIdParam;
 exports.writeActiveOrgCookie = writeActiveOrgCookie;
 //# sourceMappingURL=active-org.cjs.map
 //# sourceMappingURL=active-org.cjs.map

package/dist/active-org.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/active-org.ts"],"names":[],"mappings":"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","file":"active-org.cjs","sourcesContent":["// Universal active-organization selection — the ONE cross-app contract.\n//\n// A user belongs to many orgs; ONE active-org choice must follow them across\n// every Politogy app + subdomain so all apps resolve the SAME org (and campaign\n// apps don't land on a rel-only org and lock themselves). Layers cooperate,\n// mirroring the theme-preference contract:\n//   1. URL `?org=<uuid>` — the authoritative per-request selector. The shared\n//      chrome stamps it onto every route so it is bookmarkable + shareable, and\n//      each app forwards it to the chrome API as `x-contacts-org`.\n//   2. `.politogyvrm.com` cookie `politogy_active_org` — cross-subdomain vehicle\n//      (auth session cookies are host-only) that remembers the LAST USED org so\n//      a bare URL in the next app opens on the same org.\n//\n// The stored/most-authoritative value is the FULL org UUID: contacts-api\n// (auth/vrmMembership.selectRequestedMembership) matches the selector by EXACT\n// id first, then falls back to a short suffix that can COLLIDE across a user's\n// orgs — so the full UUID is the only collision-free selector.\n//\n// Server-safe (no 'use client'): constants/resolve helpers are importable from\n// server layouts; the cookie read/write helpers no-op on the server.\n\nexport const ACTIVE_ORG_COOKIE = 'politogy_active_org'\nexport const ACTIVE_ORG_QUERY_PARAM = 'org'\n\n// Loose UUID shape check — we only ever store ids that came from the user's own\n// authoritative membership list, so this just rejects obvious garbage.\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nexport function isOrgId(v: unknown): v is string {\n  return typeof v === 'string' && UUID_RE.test(v.trim())\n}\n\n/** Read the shared active-org cookie (browser only; null on server or unset). */\nexport function readActiveOrgCookie(): string | null {\n  if (typeof document === 'undefined') return null\n  try {\n    const m = document.cookie.match(\n      new RegExp(`(?:^|;\\\\s*)${ACTIVE_ORG_COOKIE}=([^;]+)`),\n    )\n    const v = m ? decodeURIComponent(m[1]) : null\n    return isOrgId(v) ? v : null\n  } catch {\n    return null\n  }\n}\n\n// Write the cross-subdomain cookie with the SAME scoping rules as the theme\n// cookie: on a *.politogyvrm.com host scope to the parent domain so every app\n// subdomain reads it; on any other host (localhost, *.pages.dev preview) fall\n// back to a host-only cookie. 1-year, SameSite=Lax, Secure on https.\nexport function writeActiveOrgCookie(orgId: string): void {\n  if (typeof document === 'undefined' || typeof window === 'undefined') return\n  if (!isOrgId(orgId)) return\n  const host = window.location.hostname\n  const domainAttr = /(^|\\.)politogyvrm\\.com$/i.test(host) ? '; Domain=.politogyvrm.com' : ''\n  const secure = window.location.protocol === 'https:' ? '; Secure' : ''\n  document.cookie = `${ACTIVE_ORG_COOKIE}=${encodeURIComponent(\n    orgId,\n  )}; Path=/; Max-Age=31536000; SameSite=Lax${domainAttr}${secure}`\n}\n\n/**\n * Read the `?org=` selector from a URL search string (full UUID only). Accepts a\n * `location.search`-style string or a full URL.\n */\nexport function readActiveOrgFromUrl(search: string | null | undefined): string | null {\n  if (!search) return null\n  try {\n    const qs = search.includes('?') ? search.slice(search.indexOf('?') + 1) : search\n    const v = new URLSearchParams(qs).get(ACTIVE_ORG_QUERY_PARAM)\n    return isOrgId(v) ? v : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Resolve the active org with the cross-app precedence:\n *   1. `?org=<uuid>` in the current URL (explicit per-request selector)\n *   2. the `.politogyvrm.com` cookie (last used, cross-subdomain)\n *   3. null  → let the app fall back to the chrome-API default (earliest-joined)\n * Pass `search` on the server (from the request URL); it defaults to\n * `window.location.search` in the browser.\n */\nexport function resolveActiveOrg(search?: string | null): string | null {\n  const fromUrl = readActiveOrgFromUrl(\n    search ?? (typeof window !== 'undefined' ? window.location.search : null),\n  )\n  if (fromUrl) return fromUrl\n  return readActiveOrgCookie()\n}\n\n/** The canonical `?org=` query fragment for a full org id (no leading `?`/`&`). */\nexport function activeOrgParam(orgId: string | null | undefined): string {\n  return isOrgId(orgId) ? `${ACTIVE_ORG_QUERY_PARAM}=${orgId}` : ''\n}\n\n/**\n * Return `url` with `?org=<uuid>` set/replaced. Used by the shared chrome to\n * stamp the active org onto every route so it is always present in the address\n * bar. Leaves the URL unchanged when `orgId` is not a valid id.\n */\nexport function withActiveOrgParam(url: string, orgId: string | null | undefined): string {\n  if (!isOrgId(orgId)) return url\n  try {\n    // Support both absolute and relative URLs.\n    const base = typeof window !== 'undefined' ? window.location.origin : 'https://politogyvrm.com'\n    const u = new URL(url, base)\n    u.searchParams.set(ACTIVE_ORG_QUERY_PARAM, orgId as string)\n    // Preserve relative form when the input was relative.\n    return /^https?:\\/\\//i.test(url) ? u.toString() : `${u.pathname}${u.search}${u.hash}`\n  } catch {\n    return url\n  }\n}\n"]}
+{"version":3,"sources":["../src/active-org.ts"],"names":[],"mappings":"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","file":"active-org.cjs","sourcesContent":["// Universal active-organization selection — the ONE cross-app contract.\n//\n// A user belongs to many orgs; ONE active-org choice must follow them across\n// every Politogy app + subdomain so all apps resolve the SAME org (and campaign\n// apps don't land on a rel-only org and lock themselves). Layers cooperate,\n// mirroring the theme-preference contract:\n//   1. URL `?org=<uuid>` — the authoritative per-request selector. The shared\n//      chrome stamps it onto every route so it is bookmarkable + shareable, and\n//      each app forwards it to the chrome API as `x-contacts-org`.\n//   2. `.politogyvrm.com` cookie `politogy_active_org` — cross-subdomain vehicle\n//      (auth session cookies are host-only) that remembers the LAST USED org so\n//      a bare URL in the next app opens on the same org.\n//\n// The stored/most-authoritative value is the FULL org UUID: contacts-api\n// (auth/vrmMembership.selectRequestedMembership) matches the selector by EXACT\n// id first, then falls back to a short suffix that can COLLIDE across a user's\n// orgs — so the full UUID is the only collision-free selector.\n//\n// Server-safe (no 'use client'): constants/resolve helpers are importable from\n// server layouts; the cookie read/write helpers no-op on the server.\n\nexport const ACTIVE_ORG_COOKIE = 'politogy_active_org'\nexport const ACTIVE_ORG_QUERY_PARAM = 'org'\n\n// Loose UUID shape check — we only ever store ids that came from the user's own\n// authoritative membership list, so this just rejects obvious garbage.\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nexport function isOrgId(v: unknown): v is string {\n  return typeof v === 'string' && UUID_RE.test(v.trim())\n}\n\n/**\n * Read the shared active-org cookie (browser only; null on server or unset).\n * @deprecated v2 apps read the org from the token claims (`orgClaimsFromToken`).\n * The cookie stays written during rollout for apps not yet on the token path.\n */\nexport function readActiveOrgCookie(): string | null {\n  if (typeof document === 'undefined') return null\n  try {\n    const m = document.cookie.match(\n      new RegExp(`(?:^|;\\\\s*)${ACTIVE_ORG_COOKIE}=([^;]+)`),\n    )\n    const v = m ? decodeURIComponent(m[1]) : null\n    return isOrgId(v) ? v : null\n  } catch {\n    return null\n  }\n}\n\n// Write the cross-subdomain cookie with the SAME scoping rules as the theme\n// cookie: on a *.politogyvrm.com host scope to the parent domain so every app\n// subdomain reads it; on any other host (localhost, *.pages.dev preview) fall\n// back to a host-only cookie. 1-year, SameSite=Lax, Secure on https.\nexport function writeActiveOrgCookie(orgId: string): void {\n  if (typeof document === 'undefined' || typeof window === 'undefined') return\n  if (!isOrgId(orgId)) return\n  const host = window.location.hostname\n  const domainAttr = /(^|\\.)politogyvrm\\.com$/i.test(host) ? '; Domain=.politogyvrm.com' : ''\n  const secure = window.location.protocol === 'https:' ? '; Secure' : ''\n  document.cookie = `${ACTIVE_ORG_COOKIE}=${encodeURIComponent(\n    orgId,\n  )}; Path=/; Max-Age=31536000; SameSite=Lax${domainAttr}${secure}`\n}\n\n/**\n * Read the `?org=` selector from a URL search string (full UUID only). Accepts a\n * `location.search`-style string or a full URL.\n */\nexport function readActiveOrgFromUrl(search: string | null | undefined): string | null {\n  if (!search) return null\n  try {\n    const qs = search.includes('?') ? search.slice(search.indexOf('?') + 1) : search\n    const v = new URLSearchParams(qs).get(ACTIVE_ORG_QUERY_PARAM)\n    return isOrgId(v) ? v : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Resolve the active org with the cross-app precedence:\n *   1. `?org=<uuid>` in the current URL (explicit per-request selector)\n *   2. the `.politogyvrm.com` cookie (last used, cross-subdomain)\n *   3. null  → let the app fall back to the chrome-API default (earliest-joined)\n * Pass `search` on the server (from the request URL); it defaults to\n * `window.location.search` in the browser.\n * @deprecated v2 apps use the token `org_id` claim plus `readOrgSelectorFromUrl`\n * as a per-tab override only.\n */\nexport function resolveActiveOrg(search?: string | null): string | null {\n  const fromUrl = readActiveOrgFromUrl(\n    search ?? (typeof window !== 'undefined' ? window.location.search : null),\n  )\n  if (fromUrl) return fromUrl\n  return readActiveOrgCookie()\n}\n\n/** The canonical `?org=` query fragment for a full org id (no leading `?`/`&`). */\nexport function activeOrgParam(orgId: string | null | undefined): string {\n  return isOrgId(orgId) ? `${ACTIVE_ORG_QUERY_PARAM}=${orgId}` : ''\n}\n\n/**\n * Return `url` with `?org=<uuid>` set/replaced. Used by the shared chrome to\n * stamp the active org onto every route so it is always present in the address\n * bar. Leaves the URL unchanged when `orgId` is not a valid id.\n */\nexport function withActiveOrgParam(url: string, orgId: string | null | undefined): string {\n  if (!isOrgId(orgId)) return url\n  try {\n    // Support both absolute and relative URLs.\n    const base = typeof window !== 'undefined' ? window.location.origin : 'https://politogyvrm.com'\n    const u = new URL(url, base)\n    u.searchParams.set(ACTIVE_ORG_QUERY_PARAM, orgId as string)\n    // Preserve relative form when the input was relative.\n    return /^https?:\\/\\//i.test(url) ? u.toString() : `${u.pathname}${u.search}${u.hash}`\n  } catch {\n    return url\n  }\n}\n\n// ---------------------------------------------------------------------------\n// v2: auth-owned active org (Global-Rules v38 \"Auth / Active Organization\",\n// UI-Platform v46 \"URL state\"). The IdP owns the shared active org on the SSO\n// session; tokens carry `org_id` (full uuid) + `org_role`. The URL carries the\n// 7-char `org_id` tail as a PER-TAB override only: it never changes the shared\n// active org. Full uuids and the legacy 6-char tail are accepted during rollout.\n// ---------------------------------------------------------------------------\n\nexport const ORG_ID_QUERY_PARAM = 'org_id'\nexport const ORG_ID_TAIL_LENGTH = 7\nconst LEGACY_ORG_TAIL_LENGTH = 6\nconst TAIL_RE = /^[0-9a-f]{6,7}$/i\n\nconst AUTH_BASE_URL = 'https://auth.politogyvrm.com'\nconst AUTH_BASE_URL_STAGING = 'https://auth-staging.politogyvrm.com'\n\n/** The URL form of an org id: the last 7 chars of the uuid, lower case. */\nexport function orgIdTail(orgId: string | null | undefined): string | null {\n  return isOrgId(orgId) ? (orgId as string).trim().toLowerCase().slice(-ORG_ID_TAIL_LENGTH) : null\n}\n\n/** A full uuid, the 7-char tail, or the legacy 6-char tail. */\nexport function isOrgSelector(v: unknown): v is string {\n  return typeof v === 'string' && (UUID_RE.test(v.trim()) || TAIL_RE.test(v.trim()))\n}\n\n/**\n * Resolve a selector against the user's own org list: exact uuid first, then a\n * unique 7-char tail, then a unique 6-char tail. Ambiguous or no match → null\n * (the IdP selector rules, so the shell never picks an org the IdP would not).\n */\nexport function matchOrgSelector<T extends { id: string }>(\n  selector: string | null | undefined,\n  orgs: readonly T[],\n): T | null {\n  if (!isOrgSelector(selector)) return null\n  const sel = selector.trim().toLowerCase()\n  if (UUID_RE.test(sel)) return orgs.find((o) => o.id.toLowerCase() === sel) ?? null\n  if (sel.length !== ORG_ID_TAIL_LENGTH && sel.length !== LEGACY_ORG_TAIL_LENGTH) return null\n  const hits = orgs.filter((o) => o.id.toLowerCase().endsWith(sel))\n  return hits.length === 1 ? hits[0] : null\n}\n\n/**\n * Read the per-tab org override from a URL: `org_id` (spec), else the legacy\n * `org`. Returns the raw selector (uuid or tail), or null. Never a source for\n * the shared active org.\n */\nexport function readOrgSelectorFromUrl(search: string | null | undefined): string | null {\n  if (!search) return null\n  try {\n    const qs = search.includes('?') ? search.slice(search.indexOf('?') + 1) : search\n    const params = new URLSearchParams(qs)\n    for (const key of [ORG_ID_QUERY_PARAM, ACTIVE_ORG_QUERY_PARAM]) {\n      const v = params.get(key)\n      if (isOrgSelector(v)) return v.trim().toLowerCase()\n    }\n    return null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Return `url` with `org_id=<7-char tail>` set and any legacy `org=` removed.\n * Leaves the URL unchanged when `orgId` is not a full uuid.\n */\nexport function withOrgIdParam(url: string, orgId: string | null | undefined): string {\n  const tail = orgIdTail(orgId)\n  if (!tail) return url\n  try {\n    const base = typeof window !== 'undefined' ? window.location.origin : 'https://politogyvrm.com'\n    const u = new URL(url, base)\n    u.searchParams.delete(ACTIVE_ORG_QUERY_PARAM)\n    u.searchParams.set(ORG_ID_QUERY_PARAM, tail)\n    return /^https?:\\/\\//i.test(url) ? u.toString() : `${u.pathname}${u.search}${u.hash}`\n  } catch {\n    return url\n  }\n}\n\nexport type OrgClaims = { orgId: string; orgRole: string | null }\n\n/** Pick `org_id` / `org_role` out of a token claim set. */\nexport function orgClaimsFrom(claims: unknown): OrgClaims | null {\n  if (!claims || typeof claims !== 'object') return null\n  const c = claims as { org_id?: unknown; org_role?: unknown }\n  if (!isOrgId(c.org_id)) return null\n  return {\n    orgId: (c.org_id as string).trim().toLowerCase(),\n    orgRole: typeof c.org_role === 'string' ? c.org_role : null,\n  }\n}\n\n/**\n * Read `org_id` / `org_role` from a JWT payload WITHOUT verifying it. For\n * display and routing only: the app server verifies the token (JWKS) and every\n * authorization decision keys on the verified claim, never on this.\n */\nexport function orgClaimsFromToken(token: string | null | undefined): OrgClaims | null {\n  if (typeof token !== 'string') return null\n  const part = token.split('.')[1]\n  if (!part) return null\n  try {\n    const b64 = part.replace(/-/g, '+').replace(/_/g, '/')\n    const padded = b64 + '='.repeat((4 - (b64.length % 4)) % 4)\n    const json =\n      typeof atob === 'function'\n        ? decodeURIComponent(\n            Array.from(atob(padded), (ch) => '%' + ch.charCodeAt(0).toString(16).padStart(2, '0')).join(''),\n          )\n        : ''\n    return orgClaimsFrom(JSON.parse(json))\n  } catch {\n    return null\n  }\n}\n\n/** The IdP base for the current environment (staging host → staging IdP). */\nexport function authBaseUrl(): string {\n  if (typeof window !== 'undefined' && window.location.hostname.toLowerCase().includes('staging')) {\n    return AUTH_BASE_URL_STAGING\n  }\n  return AUTH_BASE_URL\n}\n\nexport class ActiveOrgSwitchError extends Error {\n  constructor(\n    readonly status: number,\n    message: string,\n  ) {\n    super(message)\n    this.name = 'ActiveOrgSwitchError'\n  }\n}\n\n/**\n * Switch the SHARED active org on the IdP: `POST {auth}/api/active-org`. The\n * IdP checks membership against VRM Core and updates the SSO session; the\n * caller then re-exchanges (server) for tokens carrying the new `org_id`.\n * Also mirrors the legacy cookie so apps not yet on v2 follow the switch.\n * Throws `ActiveOrgSwitchError` (403 = not a member, 401 = no SSO session).\n */\nexport async function switchActiveOrg(\n  orgId: string,\n  opts: { authBaseUrl?: string; fetch?: typeof fetch } = {},\n): Promise<OrgClaims> {\n  if (!isOrgId(orgId)) throw new ActiveOrgSwitchError(400, 'org_id must be a full uuid')\n  const doFetch = opts.fetch ?? fetch\n  const res = await doFetch(`${opts.authBaseUrl ?? authBaseUrl()}/api/active-org`, {\n    method: 'POST',\n    credentials: 'include',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ org_id: orgId }),\n  })\n  if (!res.ok) {\n    let msg = `active-org switch failed (${res.status})`\n    try {\n      const body = (await res.json()) as { error?: string }\n      if (body?.error) msg = body.error\n    } catch {\n      /* no body */\n    }\n    throw new ActiveOrgSwitchError(res.status, msg)\n  }\n  const claims = orgClaimsFrom(await res.json().catch(() => null))\n  if (!claims) throw new ActiveOrgSwitchError(502, 'active-org switch returned no org_id')\n  writeActiveOrgCookie(claims.orgId)\n  return claims\n}\n"]}

package/dist/active-org.d.cts

@@ -1,7 +1,11 @@
 declare const ACTIVE_ORG_COOKIE = "politogy_active_org";
 declare const ACTIVE_ORG_QUERY_PARAM = "org";
 declare function isOrgId(v: unknown): v is string;
-/** Read the shared active-org cookie (browser only; null on server or unset). */
+/**
+ * Read the shared active-org cookie (browser only; null on server or unset).
+ * @deprecated v2 apps read the org from the token claims (`orgClaimsFromToken`).
+ * The cookie stays written during rollout for apps not yet on the token path.
+ */
 declare function readActiveOrgCookie(): string | null;
 declare function writeActiveOrgCookie(orgId: string): void;
 /**
@@ -16,6 +20,8 @@ declare function readActiveOrgFromUrl(search: string | null | undefined): string
  *   3. null  → let the app fall back to the chrome-API default (earliest-joined)
  * Pass `search` on the server (from the request URL); it defaults to
  * `window.location.search` in the browser.
+ * @deprecated v2 apps use the token `org_id` claim plus `readOrgSelectorFromUrl`
+ * as a per-tab override only.
  */
 declare function resolveActiveOrg(search?: string | null): string | null;
 /** The canonical `?org=` query fragment for a full org id (no leading `?`/`&`). */
@@ -26,5 +32,59 @@ declare function activeOrgParam(orgId: string | null | undefined): string;
  * bar. Leaves the URL unchanged when `orgId` is not a valid id.
  */
 declare function withActiveOrgParam(url: string, orgId: string | null | undefined): string;
+declare const ORG_ID_QUERY_PARAM = "org_id";
+declare const ORG_ID_TAIL_LENGTH = 7;
+/** The URL form of an org id: the last 7 chars of the uuid, lower case. */
+declare function orgIdTail(orgId: string | null | undefined): string | null;
+/** A full uuid, the 7-char tail, or the legacy 6-char tail. */
+declare function isOrgSelector(v: unknown): v is string;
+/**
+ * Resolve a selector against the user's own org list: exact uuid first, then a
+ * unique 7-char tail, then a unique 6-char tail. Ambiguous or no match → null
+ * (the IdP selector rules, so the shell never picks an org the IdP would not).
+ */
+declare function matchOrgSelector<T extends {
+    id: string;
+}>(selector: string | null | undefined, orgs: readonly T[]): T | null;
+/**
+ * Read the per-tab org override from a URL: `org_id` (spec), else the legacy
+ * `org`. Returns the raw selector (uuid or tail), or null. Never a source for
+ * the shared active org.
+ */
+declare function readOrgSelectorFromUrl(search: string | null | undefined): string | null;
+/**
+ * Return `url` with `org_id=<7-char tail>` set and any legacy `org=` removed.
+ * Leaves the URL unchanged when `orgId` is not a full uuid.
+ */
+declare function withOrgIdParam(url: string, orgId: string | null | undefined): string;
+type OrgClaims = {
+    orgId: string;
+    orgRole: string | null;
+};
+/** Pick `org_id` / `org_role` out of a token claim set. */
+declare function orgClaimsFrom(claims: unknown): OrgClaims | null;
+/**
+ * Read `org_id` / `org_role` from a JWT payload WITHOUT verifying it. For
+ * display and routing only: the app server verifies the token (JWKS) and every
+ * authorization decision keys on the verified claim, never on this.
+ */
+declare function orgClaimsFromToken(token: string | null | undefined): OrgClaims | null;
+/** The IdP base for the current environment (staging host → staging IdP). */
+declare function authBaseUrl(): string;
+declare class ActiveOrgSwitchError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Switch the SHARED active org on the IdP: `POST {auth}/api/active-org`. The
+ * IdP checks membership against VRM Core and updates the SSO session; the
+ * caller then re-exchanges (server) for tokens carrying the new `org_id`.
+ * Also mirrors the legacy cookie so apps not yet on v2 follow the switch.
+ * Throws `ActiveOrgSwitchError` (403 = not a member, 401 = no SSO session).
+ */
+declare function switchActiveOrg(orgId: string, opts?: {
+    authBaseUrl?: string;
+    fetch?: typeof fetch;
+}): Promise<OrgClaims>;
 
-export { ACTIVE_ORG_COOKIE, ACTIVE_ORG_QUERY_PARAM, activeOrgParam, isOrgId, readActiveOrgCookie, readActiveOrgFromUrl, resolveActiveOrg, withActiveOrgParam, writeActiveOrgCookie };
+export { ACTIVE_ORG_COOKIE, ACTIVE_ORG_QUERY_PARAM, ActiveOrgSwitchError, ORG_ID_QUERY_PARAM, ORG_ID_TAIL_LENGTH, type OrgClaims, activeOrgParam, authBaseUrl, isOrgId, isOrgSelector, matchOrgSelector, orgClaimsFrom, orgClaimsFromToken, orgIdTail, readActiveOrgCookie, readActiveOrgFromUrl, readOrgSelectorFromUrl, resolveActiveOrg, switchActiveOrg, withActiveOrgParam, withOrgIdParam, writeActiveOrgCookie };

package/dist/active-org.d.ts

@@ -1,7 +1,11 @@
 declare const ACTIVE_ORG_COOKIE = "politogy_active_org";
 declare const ACTIVE_ORG_QUERY_PARAM = "org";
 declare function isOrgId(v: unknown): v is string;
-/** Read the shared active-org cookie (browser only; null on server or unset). */
+/**
+ * Read the shared active-org cookie (browser only; null on server or unset).
+ * @deprecated v2 apps read the org from the token claims (`orgClaimsFromToken`).
+ * The cookie stays written during rollout for apps not yet on the token path.
+ */
 declare function readActiveOrgCookie(): string | null;
 declare function writeActiveOrgCookie(orgId: string): void;
 /**
@@ -16,6 +20,8 @@ declare function readActiveOrgFromUrl(search: string | null | undefined): string
  *   3. null  → let the app fall back to the chrome-API default (earliest-joined)
  * Pass `search` on the server (from the request URL); it defaults to
  * `window.location.search` in the browser.
+ * @deprecated v2 apps use the token `org_id` claim plus `readOrgSelectorFromUrl`
+ * as a per-tab override only.
  */
 declare function resolveActiveOrg(search?: string | null): string | null;
 /** The canonical `?org=` query fragment for a full org id (no leading `?`/`&`). */
@@ -26,5 +32,59 @@ declare function activeOrgParam(orgId: string | null | undefined): string;
  * bar. Leaves the URL unchanged when `orgId` is not a valid id.
  */
 declare function withActiveOrgParam(url: string, orgId: string | null | undefined): string;
+declare const ORG_ID_QUERY_PARAM = "org_id";
+declare const ORG_ID_TAIL_LENGTH = 7;
+/** The URL form of an org id: the last 7 chars of the uuid, lower case. */
+declare function orgIdTail(orgId: string | null | undefined): string | null;
+/** A full uuid, the 7-char tail, or the legacy 6-char tail. */
+declare function isOrgSelector(v: unknown): v is string;
+/**
+ * Resolve a selector against the user's own org list: exact uuid first, then a
+ * unique 7-char tail, then a unique 6-char tail. Ambiguous or no match → null
+ * (the IdP selector rules, so the shell never picks an org the IdP would not).
+ */
+declare function matchOrgSelector<T extends {
+    id: string;
+}>(selector: string | null | undefined, orgs: readonly T[]): T | null;
+/**
+ * Read the per-tab org override from a URL: `org_id` (spec), else the legacy
+ * `org`. Returns the raw selector (uuid or tail), or null. Never a source for
+ * the shared active org.
+ */
+declare function readOrgSelectorFromUrl(search: string | null | undefined): string | null;
+/**
+ * Return `url` with `org_id=<7-char tail>` set and any legacy `org=` removed.
+ * Leaves the URL unchanged when `orgId` is not a full uuid.
+ */
+declare function withOrgIdParam(url: string, orgId: string | null | undefined): string;
+type OrgClaims = {
+    orgId: string;
+    orgRole: string | null;
+};
+/** Pick `org_id` / `org_role` out of a token claim set. */
+declare function orgClaimsFrom(claims: unknown): OrgClaims | null;
+/**
+ * Read `org_id` / `org_role` from a JWT payload WITHOUT verifying it. For
+ * display and routing only: the app server verifies the token (JWKS) and every
+ * authorization decision keys on the verified claim, never on this.
+ */
+declare function orgClaimsFromToken(token: string | null | undefined): OrgClaims | null;
+/** The IdP base for the current environment (staging host → staging IdP). */
+declare function authBaseUrl(): string;
+declare class ActiveOrgSwitchError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Switch the SHARED active org on the IdP: `POST {auth}/api/active-org`. The
+ * IdP checks membership against VRM Core and updates the SSO session; the
+ * caller then re-exchanges (server) for tokens carrying the new `org_id`.
+ * Also mirrors the legacy cookie so apps not yet on v2 follow the switch.
+ * Throws `ActiveOrgSwitchError` (403 = not a member, 401 = no SSO session).
+ */
+declare function switchActiveOrg(orgId: string, opts?: {
+    authBaseUrl?: string;
+    fetch?: typeof fetch;
+}): Promise<OrgClaims>;
 
-export { ACTIVE_ORG_COOKIE, ACTIVE_ORG_QUERY_PARAM, activeOrgParam, isOrgId, readActiveOrgCookie, readActiveOrgFromUrl, resolveActiveOrg, withActiveOrgParam, writeActiveOrgCookie };
+export { ACTIVE_ORG_COOKIE, ACTIVE_ORG_QUERY_PARAM, ActiveOrgSwitchError, ORG_ID_QUERY_PARAM, ORG_ID_TAIL_LENGTH, type OrgClaims, activeOrgParam, authBaseUrl, isOrgId, isOrgSelector, matchOrgSelector, orgClaimsFrom, orgClaimsFromToken, orgIdTail, readActiveOrgCookie, readActiveOrgFromUrl, readOrgSelectorFromUrl, resolveActiveOrg, switchActiveOrg, withActiveOrgParam, withOrgIdParam, writeActiveOrgCookie };

package/dist/active-org.js

@@ -1,3 +1,3 @@
-export { ACTIVE_ORG_COOKIE, ACTIVE_ORG_QUERY_PARAM, activeOrgParam, isOrgId, readActiveOrgCookie, readActiveOrgFromUrl, resolveActiveOrg, withActiveOrgParam, writeActiveOrgCookie } from './chunk-W2HITMV5.js';
+export { ACTIVE_ORG_COOKIE, ACTIVE_ORG_QUERY_PARAM, ActiveOrgSwitchError, ORG_ID_QUERY_PARAM, ORG_ID_TAIL_LENGTH, activeOrgParam, authBaseUrl, isOrgId, isOrgSelector, matchOrgSelector, orgClaimsFrom, orgClaimsFromToken, orgIdTail, readActiveOrgCookie, readActiveOrgFromUrl, readOrgSelectorFromUrl, resolveActiveOrg, switchActiveOrg, withActiveOrgParam, withOrgIdParam, writeActiveOrgCookie } from './chunk-BWV52AT6.js';
 //# sourceMappingURL=active-org.js.map
 //# sourceMappingURL=active-org.js.map

package/dist/app-chrome.cjs

@@ -550,12 +550,16 @@ function useNavChrome(component) {
   }
   return ctx;
 }
-function useChromeOrgs() {
+function useChromeOrgs({ enabled = true } = {}) {
   const { dedupedFetch } = useNavChrome("useChromeOrgs");
   const [orgs, setOrgs] = react.useState(null);
-  const [loading, setLoading] = react.useState(true);
+  const [loading, setLoading] = react.useState(enabled);
   const [error, setError] = react.useState(false);
   react.useEffect(() => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
     let cancelled = false;
     setLoading(true);
     setError(false);
@@ -571,7 +575,7 @@ function useChromeOrgs() {
     return () => {
       cancelled = true;
     };
-  }, [dedupedFetch]);
+  }, [dedupedFetch, enabled]);
   return { orgs, loading, error };
 }
 function ValueSkeleton({ className }) {
@@ -1335,10 +1339,14 @@ function composeSupportMessage(input) {
 ---
 ${ctx.join("\n")}`;
 }
-function SupportAction({ orgId } = {}) {
+function SupportAction({
+  orgId,
+  orgs: knownOrgs
+} = {}) {
   const { fetchJson } = useNavChrome("SupportAction");
   const { me, loaded } = useChromeMe();
-  const { orgs } = useChromeOrgs();
+  const { orgs: fetchedOrgs } = useChromeOrgs({ enabled: !knownOrgs });
+  const orgs = knownOrgs ?? fetchedOrgs;
   const [open, setOpen] = react.useState(false);
   const [message, setMessage] = react.useState("");
   const [email, setEmail] = react.useState("");
@@ -3855,6 +3863,85 @@ function resolveActiveOrg(search) {
   if (fromUrl) return fromUrl;
   return readActiveOrgCookie();
 }
+var ORG_ID_QUERY_PARAM = "org_id";
+var ORG_ID_TAIL_LENGTH = 7;
+var LEGACY_ORG_TAIL_LENGTH = 6;
+var TAIL_RE = /^[0-9a-f]{6,7}$/i;
+var AUTH_BASE_URL = "https://auth.politogyvrm.com";
+var AUTH_BASE_URL_STAGING = "https://auth-staging.politogyvrm.com";
+function orgIdTail(orgId) {
+  return isOrgId(orgId) ? orgId.trim().toLowerCase().slice(-ORG_ID_TAIL_LENGTH) : null;
+}
+function isOrgSelector(v) {
+  return typeof v === "string" && (UUID_RE.test(v.trim()) || TAIL_RE.test(v.trim()));
+}
+function matchOrgSelector(selector, orgs) {
+  if (!isOrgSelector(selector)) return null;
+  const sel = selector.trim().toLowerCase();
+  if (UUID_RE.test(sel)) return orgs.find((o) => o.id.toLowerCase() === sel) ?? null;
+  if (sel.length !== ORG_ID_TAIL_LENGTH && sel.length !== LEGACY_ORG_TAIL_LENGTH) return null;
+  const hits = orgs.filter((o) => o.id.toLowerCase().endsWith(sel));
+  return hits.length === 1 ? hits[0] : null;
+}
+function readOrgSelectorFromUrl(search) {
+  if (!search) return null;
+  try {
+    const qs = search.includes("?") ? search.slice(search.indexOf("?") + 1) : search;
+    const params = new URLSearchParams(qs);
+    for (const key of [ORG_ID_QUERY_PARAM, ACTIVE_ORG_QUERY_PARAM]) {
+      const v = params.get(key);
+      if (isOrgSelector(v)) return v.trim().toLowerCase();
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function orgClaimsFrom(claims) {
+  if (!claims || typeof claims !== "object") return null;
+  const c = claims;
+  if (!isOrgId(c.org_id)) return null;
+  return {
+    orgId: c.org_id.trim().toLowerCase(),
+    orgRole: typeof c.org_role === "string" ? c.org_role : null
+  };
+}
+function authBaseUrl() {
+  if (typeof window !== "undefined" && window.location.hostname.toLowerCase().includes("staging")) {
+    return AUTH_BASE_URL_STAGING;
+  }
+  return AUTH_BASE_URL;
+}
+var ActiveOrgSwitchError = class extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "ActiveOrgSwitchError";
+  }
+};
+async function switchActiveOrg(orgId, opts = {}) {
+  if (!isOrgId(orgId)) throw new ActiveOrgSwitchError(400, "org_id must be a full uuid");
+  const doFetch = opts.fetch ?? fetch;
+  const res = await doFetch(`${opts.authBaseUrl ?? authBaseUrl()}/api/active-org`, {
+    method: "POST",
+    credentials: "include",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ org_id: orgId })
+  });
+  if (!res.ok) {
+    let msg = `active-org switch failed (${res.status})`;
+    try {
+      const body = await res.json();
+      if (body?.error) msg = body.error;
+    } catch {
+    }
+    throw new ActiveOrgSwitchError(res.status, msg);
+  }
+  const claims = orgClaimsFrom(await res.json().catch(() => null));
+  if (!claims) throw new ActiveOrgSwitchError(502, "active-org switch returned no org_id");
+  writeActiveOrgCookie(claims.orgId);
+  return claims;
+}
 
 // src/lib/breadcrumbs.ts
 function deriveBreadcrumbs(items, pathname, opts) {
@@ -4533,6 +4620,7 @@ function PolitogyAppFrame({
       fetchJson: data?.fetchJson,
       devNotes: data?.devNotes,
       org: data?.org,
+      tokenOrg: data?.tokenOrg,
       identity: {
         userId: session.userId,
         userName: session.userName ?? null,
@@ -4813,6 +4901,107 @@ var ChromeStateContext = react.createContext(null);
 function useChromeState() {
   return react.useContext(ChromeStateContext);
 }
+function TokenChromeStateProvider({
+  tokenOrg,
+  children
+}) {
+  const { orgs: fetchedOrgs, loading: orgsFetching, error: orgsError } = useChromeOrgs({
+    enabled: !tokenOrg.orgs
+  });
+  const [navDisplay, setNavDisplayState] = react.useState(NAV_DISPLAY_DEFAULT);
+  const [pendingOrg, setPendingOrg] = react.useState(null);
+  const tokenOrgRef = react.useRef(tokenOrg);
+  tokenOrgRef.current = tokenOrg;
+  react.useEffect(() => {
+    setNavDisplayState(resolveNavDisplay());
+  }, []);
+  const orgs = react.useMemo(
+    () => tokenOrg.orgs ?? (fetchedOrgs ?? []).map((o) => ({
+      id: o.id,
+      name: o.name,
+      logoUrl: o.logoUrl,
+      brandColor: o.brandColor,
+      role: o.role,
+      rawRole: o.rawRole ?? null
+    })),
+    [tokenOrg.orgs, fetchedOrgs]
+  );
+  const [urlSelector] = react.useState(
+    () => typeof window === "undefined" ? null : readOrgSelectorFromUrl(window.location.search)
+  );
+  const overrideOrg = react.useMemo(
+    () => urlSelector ? matchOrgSelector(urlSelector, orgs)?.id ?? null : null,
+    [urlSelector, orgs]
+  );
+  const orgId = pendingOrg ?? (tokenOrg.orgId && overrideOrg ? overrideOrg : tokenOrg.orgId);
+  const reexchangedFor = react.useRef(null);
+  react.useEffect(() => {
+    if (!overrideOrg || !tokenOrg.orgId || overrideOrg === tokenOrg.orgId) return;
+    if (reexchangedFor.current === overrideOrg) return;
+    reexchangedFor.current = overrideOrg;
+    void Promise.resolve(tokenOrgRef.current.onReexchange(overrideOrg, { perTab: true })).catch(
+      () => {
+      }
+    );
+  }, [overrideOrg, tokenOrg.orgId]);
+  react.useEffect(() => {
+    if (pendingOrg && tokenOrg.orgId === pendingOrg) setPendingOrg(null);
+  }, [pendingOrg, tokenOrg.orgId]);
+  const setOrgId = react.useCallback((id) => {
+    const current = tokenOrgRef.current;
+    if (!isOrgId(id) || id === (current.orgId ?? null)) return;
+    setPendingOrg(id);
+    void (async () => {
+      try {
+        const claims = await switchActiveOrg(id, { authBaseUrl: current.authBaseUrl });
+        try {
+          const url = new URL(window.location.href);
+          url.searchParams.delete(ACTIVE_ORG_QUERY_PARAM);
+          url.searchParams.set(ORG_ID_QUERY_PARAM, orgIdTail(claims.orgId));
+          window.history.replaceState(window.history.state, "", url.toString());
+        } catch {
+        }
+        await tokenOrgRef.current.onReexchange(claims.orgId, { perTab: false });
+      } catch (err) {
+        setPendingOrg(null);
+        tokenOrgRef.current.onSwitchError?.(err);
+      }
+    })();
+  }, []);
+  const setNavDisplay = react.useCallback((m) => {
+    setNavDisplayState(m);
+    writeNavDisplayLocal(m);
+    writeNavDisplayCookie(m);
+  }, []);
+  react.useEffect(() => {
+    if (!isOrgId(orgId)) return;
+    try {
+      const url = new URL(window.location.href);
+      const tail = orgIdTail(orgId);
+      if (url.searchParams.has(ACTIVE_ORG_QUERY_PARAM) || url.searchParams.get(ORG_ID_QUERY_PARAM) !== tail) {
+        url.searchParams.delete(ACTIVE_ORG_QUERY_PARAM);
+        url.searchParams.set(ORG_ID_QUERY_PARAM, tail);
+        window.history.replaceState(window.history.state, "", url.toString());
+      }
+    } catch {
+    }
+  }, [orgId]);
+  react.useEffect(() => {
+    if (isOrgId(tokenOrg.orgId) && !pendingOrg) writeActiveOrgCookie(tokenOrg.orgId);
+  }, [tokenOrg.orgId, pendingOrg]);
+  const value = react.useMemo(
+    () => ({
+      orgId,
+      setOrgId,
+      orgs,
+      orgsLoading: !tokenOrg.orgs && orgsFetching && !orgsError && !fetchedOrgs,
+      navDisplay,
+      setNavDisplay
+    }),
+    [orgId, setOrgId, orgs, tokenOrg.orgs, orgsFetching, orgsError, fetchedOrgs, navDisplay, setNavDisplay]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(ChromeStateContext.Provider, { value, children });
+}
 function ChromeStateProvider({
   controlledOrg,
   children
@@ -5116,6 +5305,7 @@ function PolitogyAppChrome({
   fetchJson: fetchJsonOverride,
   devNotes,
   org,
+  tokenOrg,
   identity,
   children
 }) {
@@ -5134,7 +5324,7 @@ function PolitogyAppChrome({
     [proxyBasePath]
   );
   const fetchJson = fetchJsonOverride ?? proxyFetchJson;
-  return /* @__PURE__ */ jsxRuntime.jsx(NavChromeProvider, { fetchJson, children: /* @__PURE__ */ jsxRuntime.jsx(ChromeStateProvider, { controlledOrg: org, children: /* @__PURE__ */ jsxRuntime.jsx(
+  const devNotesTree = /* @__PURE__ */ jsxRuntime.jsx(
     AppDevNotes,
     {
       storagePrefix,
@@ -5143,7 +5333,8 @@ function PolitogyAppChrome({
       identity,
       children
     }
-  ) }) });
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(NavChromeProvider, { fetchJson, children: tokenOrg ? /* @__PURE__ */ jsxRuntime.jsx(TokenChromeStateProvider, { tokenOrg, children: devNotesTree }) : /* @__PURE__ */ jsxRuntime.jsx(ChromeStateProvider, { controlledOrg: org, children: devNotesTree }) });
 }
 function ChromeTopBarActions() {
   const state = useChromeState();
@@ -5160,7 +5351,7 @@ function ChromeTopBarActions() {
     /* @__PURE__ */ jsxRuntime.jsx(FuelAction, { orgId: state.orgId }),
     /* @__PURE__ */ jsxRuntime.jsx(SpecOverlayAction, { orgId: state.orgId, orgName: state.orgs.find((o) => o.id === state.orgId)?.name ?? null }),
     /* @__PURE__ */ jsxRuntime.jsx(NotificationsAction, { orgId: state.orgId }),
-    /* @__PURE__ */ jsxRuntime.jsx(SupportAction, { orgId: state.orgId })
+    /* @__PURE__ */ jsxRuntime.jsx(SupportAction, { orgId: state.orgId, orgs: state.orgs.length ? state.orgs : void 0 })
   ] });
 }
 function ChromeDevNotesMenu() {