@flamingo-stack/openframe-frontend-core 0.0.234 → 0.0.235-snapshot.20260609090033

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.234",
+  "version": "0.0.235-snapshot.20260609090033",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",
@@ -66,6 +66,12 @@
       "require": "./dist/schemas/contact-schema.cjs",
       "default": "./dist/schemas/contact-schema.js"
     },
+    "./platform-domains": {
+      "types": "./dist/platform-domains.d.ts",
+      "import": "./dist/platform-domains.js",
+      "require": "./dist/platform-domains.cjs",
+      "default": "./dist/platform-domains.js"
+    },
     "./components/ui/file-manager": {
       "types": "./dist/components/ui/file-manager/index.d.ts",
       "import": "./dist/components/ui/file-manager/index.js",

package/src/__tests__/platform-domains.test.ts

@@ -0,0 +1,189 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import {
+  PLATFORM_DOMAINS,
+  byKey,
+  getPlatformProductionUrl,
+  getPlatformByHostname,
+  getAllPlatformBaseDomains,
+  hostOf,
+  expandWwwApex,
+  toRegistrableBaseDomain,
+  aliasHostsOf,
+  ensureScheme,
+  isNonCookieableHost,
+  matchCookieDomain,
+} from '@/platform-domains'
+
+/**
+ * Helper: run a fn with a stubbed `window.location.hostname` (prod, non-localhost,
+ * non-vercel) so getAllPlatformBaseDomains exercises its production branch.
+ */
+function withProdWindow<T>(hostname: string, fn: () => T): T {
+  vi.stubGlobal('window', { location: { hostname } })
+  try {
+    return fn()
+  } finally {
+    vi.unstubAllGlobals()
+  }
+}
+
+afterEach(() => {
+  vi.unstubAllGlobals()
+  vi.unstubAllEnvs()
+})
+
+describe('platform-domains — forward resolution (defaults = byte-identical to the old cn.ts switch)', () => {
+  it('returns each defaultUrl when no env override is set', () => {
+    for (const entry of PLATFORM_DOMAINS) {
+      expect(getPlatformProductionUrl(entry.key)).toBe(entry.defaultUrl)
+    }
+  })
+  it('falls back to flamingo.run for an unknown key (old default case)', () => {
+    expect(getPlatformProductionUrl('not-a-platform')).toBe('https://www.flamingo.run')
+  })
+})
+
+describe('🔒 cross-subdomain cookie sharing (the SSO invariant — must never regress)', () => {
+  // With NO NEXT_PUBLIC_*_URL overrides set (today's production reality), the defaults
+  // alone MUST still produce the registrable base domains that scope the auth cookie
+  // across every hub subdomain. This is exactly what pure-env-only would have broken.
+  it('emits .flamingo.so / .flamingo.run / .openmsp.ai / .tmcg.miami / .openframe.ai from defaults', () => {
+    const bases = withProdWindow('company-hub.flamingo.so', getAllPlatformBaseDomains)
+    for (const must of ['.flamingo.so', '.flamingo.run', '.openmsp.ai', '.tmcg.miami', '.openframe.ai']) {
+      expect(bases).toContain(must)
+    }
+  })
+  it('shares one base domain across all *.flamingo.so hubs (cross-hub SSO)', () => {
+    for (const hub of ['marketing-hub', 'company-hub', 'product-hub', 'revenue-hub', 'people-hub']) {
+      expect(toRegistrableBaseDomain(hostOf(getPlatformProductionUrl(hub))!)).toBe('flamingo.so')
+    }
+  })
+  it('keeps flamingo.cx OUT of the cookie set (alias excluded) but IN the reverse map', () => {
+    const bases = withProdWindow('www.flamingo.run', getAllPlatformBaseDomains)
+    expect(bases).not.toContain('.flamingo.cx')
+    expect(getPlatformByHostname('flamingo.cx')).toBe('flamingo-teaser')
+  })
+  it('returns [] for localhost and .vercel.app (host-only cookies)', () => {
+    expect(withProdWindow('localhost', getAllPlatformBaseDomains)).toEqual([])
+    expect(withProdWindow('foo.vercel.app', getAllPlatformBaseDomains)).toEqual(['.vercel.app', 'vercel.app'])
+  })
+})
+
+describe('reverse resolver (first-wins ordering + aliases)', () => {
+  it.each([
+    ['www.flamingo.run', 'flamingo'],
+    ['flamingo.run', 'flamingo'],
+    ['flamingo.cx', 'flamingo-teaser'],
+    ['www.flamingo.cx', 'flamingo-teaser'],
+    ['openframe.ai', 'openframe'],
+    ['www.openframe.ai', 'openframe'],
+    ['hub.openframe.ai', 'openframe'], // additive fix — was null in the old PLATFORM_DOMAIN_MAP
+    ['marketing-hub.flamingo.so', 'marketing-hub'],
+    ['WWW.OPENMSP.AI', 'openmsp'], // case-insensitive
+    ['evil.com', null],
+  ])('%s → %s', (host, expected) => {
+    expect(getPlatformByHostname(host)).toBe(expected)
+  })
+})
+
+describe('host primitives', () => {
+  it('hostOf strips scheme + port, lowercases, null on garbage', () => {
+    expect(hostOf('https://WWW.Openmsp.ai:8443/x')).toBe('www.openmsp.ai')
+    expect(hostOf('not a url')).toBeNull()
+    expect(hostOf(null)).toBeNull()
+  })
+  it('expandWwwApex handles www / apex / 3-label / 1-label', () => {
+    expect(expandWwwApex('www.openmsp.ai')).toEqual(['www.openmsp.ai', 'openmsp.ai'])
+    expect(expandWwwApex('openmsp.ai')).toEqual(['openmsp.ai', 'www.openmsp.ai'])
+    expect(expandWwwApex('hub.openframe.ai')).toEqual(['hub.openframe.ai'])
+    expect(expandWwwApex('localhost')).toEqual(['localhost'])
+  })
+  it('toRegistrableBaseDomain + aliasHostsOf', () => {
+    expect(toRegistrableBaseDomain('marketing-hub.flamingo.so')).toBe('flamingo.so')
+    expect(toRegistrableBaseDomain('localhost')).toBeUndefined()
+    expect(aliasHostsOf('flamingo-teaser')).toEqual(['flamingo.cx', 'www.flamingo.cx'])
+    expect(aliasHostsOf('openmsp')).toEqual([])
+  })
+})
+
+describe('env override path', () => {
+  // ENV_OVERRIDES captures `process.env.NEXT_PUBLIC_*` at MODULE LOAD — required so the
+  // values are build-inlined (literal keys) in the browser bundle. So an override must be
+  // set BEFORE the module evaluates: stub env → resetModules → dynamic import.
+  afterEach(() => {
+    vi.unstubAllEnvs()
+    vi.resetModules()
+  })
+  it('an override wins over the default (per-distinct-var, no cross-contamination)', async () => {
+    vi.stubEnv('NEXT_PUBLIC_TMCG_URL', 'https://sentinel-tmcg.example')
+    vi.resetModules()
+    const mod = await import('@/platform-domains')
+    expect(mod.getPlatformProductionUrl('tmcg')).toBe('https://sentinel-tmcg.example')
+    // a non-sharing key is unaffected
+    expect(mod.getPlatformProductionUrl('openmsp')).toBe('https://www.openmsp.ai')
+  })
+  it('the shared NEXT_PUBLIC_FLAMINGO_URL drives all three of its keys', async () => {
+    vi.stubEnv('NEXT_PUBLIC_FLAMINGO_URL', 'https://sentinel-flamingo.example')
+    vi.resetModules()
+    const mod = await import('@/platform-domains')
+    for (const k of ['flamingo', 'flamingo-teaser', 'universal']) {
+      expect(mod.getPlatformProductionUrl(k)).toBe('https://sentinel-flamingo.example')
+    }
+  })
+  it('normalizes a SCHEME-LESS override to https:// (Vercel stores bare hosts)', async () => {
+    vi.stubEnv('NEXT_PUBLIC_OPENMSP_URL', 'www.openmsp.ai') // no scheme, as in the shared-env store
+    vi.stubEnv('NEXT_PUBLIC_OPENFRAME_URL', 'hub.openframe.ai')
+    vi.resetModules()
+    const mod = await import('@/platform-domains')
+    expect(mod.getPlatformProductionUrl('openmsp')).toBe('https://www.openmsp.ai')
+    expect(mod.getPlatformProductionUrl('openframe')).toBe('https://hub.openframe.ai')
+  })
+  it('a scheme-less override still parses for hostOf + cookie-base derivation', async () => {
+    vi.stubEnv('NEXT_PUBLIC_OPENMSP_URL', 'www.openmsp.ai')
+    vi.resetModules()
+    const mod = await import('@/platform-domains')
+    // the whole point: hostOf no longer returns null on the (normalized) override
+    expect(mod.hostOf(mod.getPlatformProductionUrl('openmsp'))).toBe('www.openmsp.ai')
+    expect(mod.toRegistrableBaseDomain(mod.hostOf(mod.getPlatformProductionUrl('openmsp'))!)).toBe('openmsp.ai')
+  })
+})
+
+describe('registry integrity', () => {
+  it('byKey resolves every key and openframe-dashboard is pseudo', () => {
+    expect(byKey('openframe-dashboard')?.pseudo).toBe(true)
+    expect(byKey('not-a-platform')).toBeUndefined()
+  })
+})
+
+describe('ensureScheme', () => {
+  it('adds https:// to a bare host, leaves a scheme\'d URL untouched', () => {
+    expect(ensureScheme('www.openmsp.ai')).toBe('https://www.openmsp.ai')
+    expect(ensureScheme('https://www.openmsp.ai')).toBe('https://www.openmsp.ai')
+    expect(ensureScheme('http://localhost:3000')).toBe('http://localhost:3000')
+  })
+  it('normalizes a protocol-relative //host (NOT https:////host → empty-host drop)', () => {
+    expect(ensureScheme('//hub.openframe.ai')).toBe('https://hub.openframe.ai')
+    expect(hostOf(ensureScheme('//hub.openframe.ai'))).toBe('hub.openframe.ai')
+  })
+})
+
+describe('cookie-domain guard + match (shared SSOT primitives)', () => {
+  it('isNonCookieableHost flags localhost / private IPs / *.vercel.app, not real hosts', () => {
+    for (const h of ['localhost', '127.0.0.1', '127.5.5.5', '192.168.1.2', '10.0.0.1', 'x.vercel.app']) {
+      expect(isNonCookieableHost(h)).toBe(true)
+    }
+    for (const h of ['www.openmsp.ai', 'marketing-hub.flamingo.so', 'hub.openframe.ai']) {
+      expect(isNonCookieableHost(h)).toBe(false)
+    }
+  })
+  it('matchCookieDomain returns the dotted base for a contained host (incl. apex), else undefined', () => {
+    const bases = ['.flamingo.so', '.openmsp.ai']
+    expect(matchCookieDomain('marketing-hub.flamingo.so', bases)).toBe('.flamingo.so')
+    expect(matchCookieDomain('flamingo.so', bases)).toBe('.flamingo.so')
+    expect(matchCookieDomain('app.openmsp.ai', bases)).toBe('.openmsp.ai')
+    expect(matchCookieDomain('evil.com', bases)).toBeUndefined()
+  })
+  it('matchCookieDomain accepts dotless bases and still returns the dotted form', () => {
+    expect(matchCookieDomain('foo.tmcg.miami', ['tmcg.miami'])).toBe('.tmcg.miami')
+  })
+})

package/src/components/chat/index.ts

@@ -13,6 +13,7 @@ export * from './slash-command-suggestions'
 export * from './chat-message-enhanced'
 export * from './chat-message-list'
 export * from './chat-message-row'
+export * from './chat-message-skeleton'
 
 export * from './chat-quick-action'
 export * from './chat-ticket-list'

package/src/components/vendor-display-button.tsx

@@ -15,9 +15,10 @@ interface VendorDisplayButtonProps {
 export function VendorDisplayButton({ vendor, onClick, variant = 'default', externalUrl }: VendorDisplayButtonProps) {
   const handleClick = () => {
     if (externalUrl && vendor.slug) {
-      // Use environment variable or fallback to provided URL
-      const baseUrl = process.env.NEXT_PUBLIC_OPENMSP_URL || externalUrl
-      window.open(`${baseUrl}/vendor/${vendor.slug}`, '_blank', 'noopener,noreferrer')
+      // `externalUrl` is the caller-resolved platform base URL (the openmsp SSOT via
+      // getPlatformProductionUrl, scheme-normalized). The old `process.env.NEXT_PUBLIC_OPENMSP_URL`
+      // override is gone — it's stored scheme-less, which made this a relative window.open().
+      window.open(`${externalUrl}/vendor/${vendor.slug}`, '_blank', 'noopener,noreferrer')
     } else if (onClick && vendor.slug) {
       onClick(vendor.slug)
     }

package/src/platform-domains.ts

@@ -0,0 +1,299 @@
+/**
+ * Platform-Domain SSOT (single source of truth) + derivations.
+ *
+ * ONE registry maps each platform → its canonical production URL (`defaultUrl`,
+ * the load-bearing source) with an optional per-deploy `NEXT_PUBLIC_*_URL`
+ * OVERRIDE. Everything else — the reverse host→platform resolver, the cookie
+ * base-domain set (the cross-subdomain SSO mechanism), www/apex expansion, the
+ * URL→host parse, preview detection — derives from this one table.
+ *
+ * EDGE-SAFE + PURE: no React/clsx/tailwind, no `server-only`, no `node:`
+ * builtins, no `'use client'`. So it is legal in the Edge middleware
+ * (`proxy.ts`), in `'use client'` providers, AND in `server-only` modules
+ * (e.g. cookie-domain-server.ts) simultaneously. The ONLY non-pure export is
+ * `getAllPlatformBaseDomains`, which reads `typeof window`/`process.env` to
+ * preserve byte-identical cookie behavior.
+ */
+
+import type { PlatformName } from './types/platform'
+
+export type PlatformDomainKey = PlatformName | 'openframe-dashboard'
+
+export interface PlatformDomainEntry {
+  /** Platform key (matches `PlatformName`, plus the forward-only `openframe-dashboard`). */
+  key: PlatformDomainKey
+  /** Canonical production URL — the LOAD-BEARING source of truth (today's hardcoded fallbacks). */
+  defaultUrl: string
+  /** `NEXT_PUBLIC_*_URL` per-deploy OVERRIDE. The `defaultUrl` covers it when unset. */
+  envVar: string
+  /** Legacy/secondary hosts that REVERSE-map to this key (no env var exists — NOT canonical). */
+  aliasHostnames?: string[]
+  /** Forward-only: no DB row, excluded from the reverse index + cookie set (e.g. the product-CTA dashboard). */
+  pseudo?: boolean
+}
+
+export const PLATFORM_DOMAINS: readonly PlatformDomainEntry[] = [
+  { key: 'marketing-hub', defaultUrl: 'https://marketing-hub.flamingo.so', envVar: 'NEXT_PUBLIC_MARKETING_HUB_URL' },
+  { key: 'company-hub',   defaultUrl: 'https://company-hub.flamingo.so',   envVar: 'NEXT_PUBLIC_COMPANY_HUB_URL' },
+  { key: 'product-hub',   defaultUrl: 'https://product-hub.flamingo.so',   envVar: 'NEXT_PUBLIC_PRODUCT_HUB_URL' },
+  { key: 'revenue-hub',   defaultUrl: 'https://revenue-hub.flamingo.so',   envVar: 'NEXT_PUBLIC_REVENUE_HUB_URL' },
+  { key: 'people-hub',    defaultUrl: 'https://people-hub.flamingo.so',    envVar: 'NEXT_PUBLIC_PEOPLE_HUB_URL' },
+  { key: 'openmsp',       defaultUrl: 'https://www.openmsp.ai',            envVar: 'NEXT_PUBLIC_OPENMSP_URL' },
+  // ORDERING INVARIANT (first-wins, load-bearing): `flamingo` MUST precede `flamingo-teaser` + `universal`.
+  // All three resolve to www.flamingo.run; the reverse index is first-wins → flamingo claims the shared host,
+  // teaser keeps only its unique flamingo.cx aliases, universal contributes no unique host.
+  // ⚠️ DO NOT REORDER — enforced by the module-load self-check at the bottom of this file.
+  { key: 'flamingo',         defaultUrl: 'https://www.flamingo.run',  envVar: 'NEXT_PUBLIC_FLAMINGO_URL' },
+  { key: 'tmcg',             defaultUrl: 'https://www.tmcg.miami',    envVar: 'NEXT_PUBLIC_TMCG_URL' },
+  { key: 'flamingo-teaser',  defaultUrl: 'https://www.flamingo.run',  envVar: 'NEXT_PUBLIC_FLAMINGO_URL', aliasHostnames: ['flamingo.cx', 'www.flamingo.cx'] },
+  { key: 'openframe',        defaultUrl: 'https://openframe.ai',      envVar: 'NEXT_PUBLIC_OPENFRAME_URL', aliasHostnames: ['openframe.ai', 'www.openframe.ai', 'hub.openframe.ai'] },
+  { key: 'openframe-dashboard', defaultUrl: 'https://openframe.ai',   envVar: 'NEXT_PUBLIC_OPENFRAME_DASHBOARD_URL', pseudo: true },
+  { key: 'universal',        defaultUrl: 'https://www.flamingo.run',  envVar: 'NEXT_PUBLIC_FLAMINGO_URL' },
+]
+
+// ── Compile-time key guards (anchor the table on PlatformName, both directions) ──
+// (1) Removal/typo guard: every table key must be a valid PlatformDomainKey.
+const _tableSatisfies = PLATFORM_DOMAINS satisfies readonly PlatformDomainEntry[]
+void _tableSatisfies
+// (2) Addition guard: a NEW PlatformName member that lacks a table row fails the build.
+type _MissingKey = Exclude<PlatformName, (typeof PLATFORM_DOMAINS)[number]['key']>
+const _exhaustive: [_MissingKey] extends [never] ? true : false = true
+void _exhaustive
+
+// ── Env overrides (the ONLY place env URLs enter — literal-key inlined + compile-time-guarded) ──
+// `process.env.NEXT_PUBLIC_X` is build-inlined ONLY with a LITERAL key, so the env-var name is the
+// irreducible two-copy (the registry `envVar` column + the literal access below). The `satisfies` makes
+// `tsc`/`next build` FAIL if this map is missing a registry env var OR carries a stale one (bidirectional).
+type EnvVarKey = (typeof PLATFORM_DOMAINS)[number]['envVar']
+const ENV_OVERRIDES = {
+  NEXT_PUBLIC_MARKETING_HUB_URL: process.env.NEXT_PUBLIC_MARKETING_HUB_URL,
+  NEXT_PUBLIC_COMPANY_HUB_URL: process.env.NEXT_PUBLIC_COMPANY_HUB_URL,
+  NEXT_PUBLIC_PRODUCT_HUB_URL: process.env.NEXT_PUBLIC_PRODUCT_HUB_URL,
+  NEXT_PUBLIC_REVENUE_HUB_URL: process.env.NEXT_PUBLIC_REVENUE_HUB_URL,
+  NEXT_PUBLIC_PEOPLE_HUB_URL: process.env.NEXT_PUBLIC_PEOPLE_HUB_URL,
+  NEXT_PUBLIC_OPENMSP_URL: process.env.NEXT_PUBLIC_OPENMSP_URL,
+  NEXT_PUBLIC_FLAMINGO_URL: process.env.NEXT_PUBLIC_FLAMINGO_URL,
+  NEXT_PUBLIC_TMCG_URL: process.env.NEXT_PUBLIC_TMCG_URL,
+  NEXT_PUBLIC_OPENFRAME_URL: process.env.NEXT_PUBLIC_OPENFRAME_URL,
+  NEXT_PUBLIC_OPENFRAME_DASHBOARD_URL: process.env.NEXT_PUBLIC_OPENFRAME_DASHBOARD_URL,
+} satisfies Record<EnvVarKey, string | undefined>
+
+/** The registry entry for a key (undefined for an unknown key). */
+export function byKey(key: string): PlatformDomainEntry | undefined {
+  return PLATFORM_DOMAINS.find((e) => e.key === key)
+}
+
+/** Read a platform's `NEXT_PUBLIC_*_URL` override (or null). */
+function envOverrideFor(key: string): string | null {
+  const envVar = byKey(key)?.envVar
+  if (!envVar) return null
+  return (ENV_OVERRIDES as Record<string, string | undefined>)[envVar] || null
+}
+
+/**
+ * Ensure a URL string carries a scheme. Per-deploy `NEXT_PUBLIC_*_URL` overrides are
+ * stored SCHEME-LESS (bare host, e.g. `www.openmsp.ai` / `hub.openframe.ai`) — the
+ * canonical convention in the Vercel shared-env store. This normalizes them to a full
+ * `https://` URL so every downstream consumer (`hostOf`/`new URL`, hrefs, the cookie
+ * base-domain derivation, CSP) receives a parseable URL. Full-URL inputs (the registry
+ * `defaultUrl`s, any scheme'd override) pass through unchanged.
+ *
+ * EXPORTED as the single owner of the scheme-normalization rule (next.config.mjs keeps a
+ * byte-identical local copy ONLY because Next evaluates its config outside the TS module
+ * graph and cannot import this — see the comment there).
+ *
+ * Handles a (theoretical) protocol-relative `//host` too: strips the leading slashes so it
+ * doesn't become `https:////host` (empty-host → hostOf null → silent platform drop).
+ */
+export function ensureScheme(url: string): string {
+  const trimmed = url.trim()
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed)) return trimmed // already has a scheme
+  return `https://${trimmed.replace(/^\/+/, '')}` // bare host or protocol-relative `//host`
+}
+
+/**
+ * Canonical production URL for a platform: env override wins, else the `defaultUrl`.
+ * NEVER throws / undefined — the default guarantees a host (this is what keeps the
+ * cookie base-domains, the reverse map, and CSP intact even with every override unset).
+ * The result ALWAYS carries a scheme (`ensureScheme`), so the scheme-less env overrides
+ * resolve to valid URLs. Unknown-key fallback preserves cn.ts's flamingo.run default.
+ */
+export function getPlatformProductionUrl(platform: string): string {
+  const resolved =
+    envOverrideFor(platform) ??
+    byKey(platform)?.defaultUrl ??
+    envOverrideFor('flamingo') ??
+    'https://www.flamingo.run'
+  return ensureScheme(resolved)
+}
+
+// ── Single-owner host primitives ──
+
+/** Canonical URL→host parser: `.hostname` (PORT-STRIPPED, lowercased), null on parse failure. */
+export function hostOf(value: string | null | undefined): string | null {
+  if (!value) return null
+  try {
+    return new URL(value).hostname.toLowerCase()
+  } catch {
+    return null
+  }
+}
+
+/** Expand a host into its `www.`/apex pair. 3+-label and single-label hosts return `[host]`. */
+export function expandWwwApex(host: string): string[] {
+  if (host.startsWith('www.')) return [host, host.slice(4)]
+  if (host.split('.').length === 2) return [host, `www.${host}`]
+  return [host]
+}
+
+/** Registrable base domain (`parts.slice(-2).join('.')`), dotless; undefined for <2-label. */
+export function toRegistrableBaseDomain(host: string): string | undefined {
+  const parts = host.split('.')
+  if (parts.length >= 2) return parts.slice(-2).join('.')
+  return undefined
+}
+
+/** An entry's alias hosts (single-owner reader). */
+export function aliasHostsOf(key: string): string[] {
+  return byKey(key)?.aliasHostnames ?? []
+}
+
+/** All hosts an entry contributes to the reverse index (resolved host + optional aliases). */
+function hostsForEntry(entry: PlatformDomainEntry, opts: { includeAliases: boolean }): string[] {
+  const resolved = hostOf(getPlatformProductionUrl(entry.key))
+  const hosts = resolved ? expandWwwApex(resolved) : []
+  if (opts.includeAliases) hosts.push(...aliasHostsOf(entry.key))
+  return hosts
+}
+
+/**
+ * Reverse resolver: hostname → platform key (first-wins over registry order, non-pseudo only).
+ * Guarantees openframe.ai / www.openframe.ai / hub.openframe.ai → openframe in every env.
+ * Replaces the hub `PLATFORM_DOMAIN_MAP`.
+ */
+export function getPlatformByHostname(hostname: string): PlatformDomainKey | null {
+  const host = hostname.toLowerCase()
+  for (const entry of PLATFORM_DOMAINS) {
+    if (entry.pseudo) continue
+    if (hostsForEntry(entry, { includeAliases: true }).includes(host)) return entry.key
+  }
+  return null
+}
+
+// ── Preview detection (two distinct predicates — env-form vs host-form) ──
+
+/** Env-form preview predicate (Vercel `VERCEL_ENV`). */
+export function isPreviewEnv(): boolean {
+  return process.env.VERCEL_ENV === 'preview'
+}
+
+/** Host-form preview predicate (a `*.vercel.app` host). Dot-bounded suffix so a
+ *  malicious `foo.vercel.app.evil.com` is NOT treated as preview. */
+export function isPreviewHost(hostname: string): boolean {
+  return hostname.endsWith('.vercel.app')
+}
+
+/**
+ * ALL unique cookie base domains (the cross-subdomain SSO mechanism).
+ *
+ * NON-PURE (the sole such export): reads `typeof window` + `process.env` to
+ * preserve byte-identical cookie behavior. Keeps the original three branches:
+ *   1. localhost / private IP → [] (host-only cookies)
+ *   2. Vercel preview (env OR host) → ['.vercel.app','vercel.app']
+ *   3. production → for each non-pseudo platform, registrable base of its resolved
+ *      host, emitted as both `.base` and bare `base`.
+ *
+ * Because `getPlatformProductionUrl` always yields a host (override OR default),
+ * `.flamingo.so` / `.flamingo.run` / `.openmsp.ai` / `.tmcg.miami` / `.openframe.ai`
+ * are ALWAYS present → cross-hub SSO is byte-identical to today.
+ */
+export function getAllPlatformBaseDomains(): string[] {
+  if (typeof window === 'undefined') return []
+
+  const hostname = window.location.hostname
+
+  // Case 1: localhost / private IP — no domains
+  if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname.startsWith('127.')) {
+    return []
+  }
+
+  // Case 2: Vercel preview — vercel.app domain
+  const previewEnv =
+    process.env.VERCEL_ENV === 'preview' ||
+    process.env.NEXT_PUBLIC_VERCEL_ENV === 'preview' ||
+    isPreviewHost(hostname)
+  if (previewEnv) {
+    return ['.vercel.app', 'vercel.app']
+  }
+
+  // Case 3: production — registrable base of every non-pseudo platform's resolved host
+  const baseDomains = new Set<string>()
+  for (const entry of PLATFORM_DOMAINS) {
+    if (entry.pseudo) continue
+    const host = hostOf(getPlatformProductionUrl(entry.key))
+    if (!host) continue
+    const base = toRegistrableBaseDomain(host)
+    if (base) {
+      baseDomains.add(`.${base}`)
+      baseDomains.add(base)
+    }
+  }
+  return Array.from(baseDomains)
+}
+
+// ── Cookie-domain guard + match (single owner; shared by the client cookie-domain.ts +
+//    server-only cookie-domain-server.ts resolvers, which previously hand-rolled both 3×) ──
+
+/**
+ * Hosts that must NOT receive a `Domain=` cookie → the caller returns undefined (host-only):
+ * localhost, loopback/private IPs, and any `*.vercel.app`. `vercel.app` is on the Public Suffix
+ * List, so browsers SILENTLY drop `Set-Cookie: Domain=.vercel.app` — which broke the PKCE verifier
+ * + session cookies on preview deploys. Host-only is sufficient there (the same preview host
+ * round-trips the OAuth chain); production hosts (`.flamingo.so`/`.openmsp.ai`/…) fall through.
+ */
+export function isNonCookieableHost(hostname: string): boolean {
+  return (
+    hostname === 'localhost' ||
+    hostname === '127.0.0.1' ||
+    hostname.startsWith('127.') ||
+    hostname.startsWith('192.168.') ||
+    hostname.startsWith('10.') ||
+    hostname.includes('.vercel.app')
+  )
+}
+
+/**
+ * Match a hostname against a set of registrable base domains → the dotted cookie `Domain`
+ * (`.flamingo.so`), or undefined when none contains the host. Accepts bases with or without a
+ * leading dot and always returns the dotted form. Single owner for the match loop both resolvers ran.
+ */
+export function matchCookieDomain(hostname: string, baseDomains: string[]): string | undefined {
+  for (const domain of baseDomains) {
+    const bare = domain.startsWith('.') ? domain.slice(1) : domain
+    if (hostname === bare || hostname.endsWith(`.${bare}`)) {
+      return domain.startsWith('.') ? domain : `.${domain}`
+    }
+  }
+  return undefined
+}
+
+// ── Module-load ordering self-check (NON-fatal — this module is imported by cn.ts → ~everything,
+// so a hard throw would be a total outage if the assertion were ever over-strict). Checks the REAL
+// invariant — table order — STRUCTURALLY (findIndex), NOT via getPlatformByHostname on a hardcoded
+// host: the latter false-positives when NEXT_PUBLIC_FLAMINGO_URL is overridden to a non-default host
+// (flamingo's resolved host changes, so `www.flamingo.run` no longer reverse-maps to it though the
+// ordering is fine). The alias checks below ARE env-immune (aliasHostnames are unique per key). The
+// authoritative guard is the reverse-map vitest. ⚠️ keep `flamingo` before `flamingo-teaser`/`universal`.
+const _orderIdx = (k: PlatformDomainKey) => PLATFORM_DOMAINS.findIndex((e) => e.key === k)
+if (
+  _orderIdx('flamingo') > _orderIdx('flamingo-teaser') ||
+  _orderIdx('flamingo') > _orderIdx('universal') ||
+  getPlatformByHostname('flamingo.cx') !== 'flamingo-teaser' ||
+  getPlatformByHostname('hub.openframe.ai') !== 'openframe'
+) {
+  // eslint-disable-next-line no-console
+  console.error(
+    '[platform-domains] ⚠️ PLATFORM_DOMAINS ordering invariant violated — `flamingo` must precede ' +
+      '`flamingo-teaser`/`universal`, and the openframe/teaser aliases must be intact. Do not reorder the table.',
+  )
+}