@copilotkit/web-inspector 1.68.3 → 1.69.0

package/dist/lib/inspector-nav.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-nav.cjs","names":[],"sources":["../../src/lib/inspector-nav.ts"],"sourcesContent":["import type { InspectorLeafKey } from \"./telemetry.js\";\n\nexport type ShellGroupKey = \"home\" | \"workbench\" | \"inspect\";\n\nexport const INSPECTOR_GROUPS = {\n  home: [\"home\", \"whats-new\"],\n  workbench: [\"playground\", \"threads\", \"memories\"],\n  inspect: [\n    \"agents\",\n    \"ag-ui-events\",\n    \"frontend-tools\",\n    \"capabilities\",\n    \"agent-context\",\n  ],\n} as const satisfies Record<ShellGroupKey, readonly InspectorLeafKey[]>;\n\nexport type InspectorNavGroupKey = keyof typeof INSPECTOR_GROUPS;\nexport type MenuKey = (typeof INSPECTOR_GROUPS)[InspectorNavGroupKey][number];\n\nexport const INSPECTOR_MENU_KEYS: ReadonlyArray<MenuKey> = [\n  ...INSPECTOR_GROUPS.home,\n  ...INSPECTOR_GROUPS.workbench,\n  ...INSPECTOR_GROUPS.inspect,\n];\n\nexport const INSPECTOR_NAV_SECTIONS: ReadonlyArray<{\n  group: InspectorNavGroupKey;\n  label: string | null;\n}> = [\n  { group: \"home\", label: null },\n  { group: \"workbench\", label: \"Workbench\" },\n  { group: \"inspect\", label: \"Inspect\" },\n];\n\nexport const ICON_RAIL_MAX_WIDTH_PX = 720;\n\n/** Return whether persisted state names a known Inspector leaf. */\nexport function isInspectorMenuKey(value: unknown): value is MenuKey {\n  return (\n    typeof value === \"string\" &&\n    INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value)\n  );\n}\n\n/** Return the sidebar group that owns a leaf. */\nexport function getGroupForMenu(key: MenuKey): InspectorNavGroupKey {\n  for (const group of Object.keys(INSPECTOR_GROUPS) as InspectorNavGroupKey[]) {\n    if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) {\n      return group;\n    }\n  }\n\n  return \"workbench\";\n}\n\n/** Return whether the sidebar should collapse to an icon rail. */\nexport function shouldUseIconRail(args: {\n  dockedLeft: boolean;\n  width: number;\n}): boolean {\n  return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;\n}\n"],"mappings":";;AAIA,MAAa,mBAAmB;CAC9B,MAAM,CAAC,QAAQ,YAAY;CAC3B,WAAW;EAAC;EAAc;EAAW;EAAW;CAChD,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACF;AAKD,MAAa,sBAA8C;CACzD,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACrB;AAED,MAAa,yBAGR;CACH;EAAE,OAAO;EAAQ,OAAO;EAAM;CAC9B;EAAE,OAAO;EAAa,OAAO;EAAa;CAC1C;EAAE,OAAO;EAAW,OAAO;EAAW;CACvC;AAED,MAAa,yBAAyB;;AAGtC,SAAgB,mBAAmB,OAAkC;AACnE,QACE,OAAO,UAAU,YACjB,oBAAoB,MAAM,YAAY,YAAY,MAAM;;;AAK5D,SAAgB,gBAAgB,KAAoC;AAClE,MAAK,MAAM,SAAS,OAAO,KAAK,iBAAiB,CAC/C,KAAI,iBAAiB,OAAO,MAAM,YAAY,YAAY,IAAI,CAC5D,QAAO;AAIX,QAAO;;;AAIT,SAAgB,kBAAkB,MAGtB;AACV,QAAO,KAAK,cAAc,KAAK,QAAQ"}

package/dist/lib/inspector-nav.mjs

@@ -0,0 +1,53 @@
+//#region src/lib/inspector-nav.ts
+const INSPECTOR_GROUPS = {
+	home: ["home", "whats-new"],
+	workbench: [
+		"playground",
+		"threads",
+		"memories"
+	],
+	inspect: [
+		"agents",
+		"ag-ui-events",
+		"frontend-tools",
+		"capabilities",
+		"agent-context"
+	]
+};
+const INSPECTOR_MENU_KEYS = [
+	...INSPECTOR_GROUPS.home,
+	...INSPECTOR_GROUPS.workbench,
+	...INSPECTOR_GROUPS.inspect
+];
+const INSPECTOR_NAV_SECTIONS = [
+	{
+		group: "home",
+		label: null
+	},
+	{
+		group: "workbench",
+		label: "Workbench"
+	},
+	{
+		group: "inspect",
+		label: "Inspect"
+	}
+];
+const ICON_RAIL_MAX_WIDTH_PX = 720;
+/** Return whether persisted state names a known Inspector leaf. */
+function isInspectorMenuKey(value) {
+	return typeof value === "string" && INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value);
+}
+/** Return the sidebar group that owns a leaf. */
+function getGroupForMenu(key) {
+	for (const group of Object.keys(INSPECTOR_GROUPS)) if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) return group;
+	return "workbench";
+}
+/** Return whether the sidebar should collapse to an icon rail. */
+function shouldUseIconRail(args) {
+	return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;
+}
+
+//#endregion
+export { INSPECTOR_GROUPS, INSPECTOR_NAV_SECTIONS, getGroupForMenu, isInspectorMenuKey, shouldUseIconRail };
+//# sourceMappingURL=inspector-nav.mjs.map

package/dist/lib/inspector-nav.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-nav.mjs","names":[],"sources":["../../src/lib/inspector-nav.ts"],"sourcesContent":["import type { InspectorLeafKey } from \"./telemetry.js\";\n\nexport type ShellGroupKey = \"home\" | \"workbench\" | \"inspect\";\n\nexport const INSPECTOR_GROUPS = {\n  home: [\"home\", \"whats-new\"],\n  workbench: [\"playground\", \"threads\", \"memories\"],\n  inspect: [\n    \"agents\",\n    \"ag-ui-events\",\n    \"frontend-tools\",\n    \"capabilities\",\n    \"agent-context\",\n  ],\n} as const satisfies Record<ShellGroupKey, readonly InspectorLeafKey[]>;\n\nexport type InspectorNavGroupKey = keyof typeof INSPECTOR_GROUPS;\nexport type MenuKey = (typeof INSPECTOR_GROUPS)[InspectorNavGroupKey][number];\n\nexport const INSPECTOR_MENU_KEYS: ReadonlyArray<MenuKey> = [\n  ...INSPECTOR_GROUPS.home,\n  ...INSPECTOR_GROUPS.workbench,\n  ...INSPECTOR_GROUPS.inspect,\n];\n\nexport const INSPECTOR_NAV_SECTIONS: ReadonlyArray<{\n  group: InspectorNavGroupKey;\n  label: string | null;\n}> = [\n  { group: \"home\", label: null },\n  { group: \"workbench\", label: \"Workbench\" },\n  { group: \"inspect\", label: \"Inspect\" },\n];\n\nexport const ICON_RAIL_MAX_WIDTH_PX = 720;\n\n/** Return whether persisted state names a known Inspector leaf. */\nexport function isInspectorMenuKey(value: unknown): value is MenuKey {\n  return (\n    typeof value === \"string\" &&\n    INSPECTOR_MENU_KEYS.some((menuKey) => menuKey === value)\n  );\n}\n\n/** Return the sidebar group that owns a leaf. */\nexport function getGroupForMenu(key: MenuKey): InspectorNavGroupKey {\n  for (const group of Object.keys(INSPECTOR_GROUPS) as InspectorNavGroupKey[]) {\n    if (INSPECTOR_GROUPS[group].some((menuKey) => menuKey === key)) {\n      return group;\n    }\n  }\n\n  return \"workbench\";\n}\n\n/** Return whether the sidebar should collapse to an icon rail. */\nexport function shouldUseIconRail(args: {\n  dockedLeft: boolean;\n  width: number;\n}): boolean {\n  return args.dockedLeft || args.width < ICON_RAIL_MAX_WIDTH_PX;\n}\n"],"mappings":";AAIA,MAAa,mBAAmB;CAC9B,MAAM,CAAC,QAAQ,YAAY;CAC3B,WAAW;EAAC;EAAc;EAAW;EAAW;CAChD,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACF;AAKD,MAAa,sBAA8C;CACzD,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACpB,GAAG,iBAAiB;CACrB;AAED,MAAa,yBAGR;CACH;EAAE,OAAO;EAAQ,OAAO;EAAM;CAC9B;EAAE,OAAO;EAAa,OAAO;EAAa;CAC1C;EAAE,OAAO;EAAW,OAAO;EAAW;CACvC;AAED,MAAa,yBAAyB;;AAGtC,SAAgB,mBAAmB,OAAkC;AACnE,QACE,OAAO,UAAU,YACjB,oBAAoB,MAAM,YAAY,YAAY,MAAM;;;AAK5D,SAAgB,gBAAgB,KAAoC;AAClE,MAAK,MAAM,SAAS,OAAO,KAAK,iBAAiB,CAC/C,KAAI,iBAAiB,OAAO,MAAM,YAAY,YAAY,IAAI,CAC5D,QAAO;AAIX,QAAO;;;AAIT,SAAgB,kBAAkB,MAGtB;AACV,QAAO,KAAK,cAAc,KAAK,QAAQ"}

package/dist/lib/persistence.cjs

@@ -51,6 +51,103 @@ function isFiniteNumber(value) {
 function isValidDockMode(value) {
 	return value === "floating" || value === "docked-left";
 }
+const ANNOUNCEMENT_READ_COOKIE_NAME = "cpk_inspector_announcements";
+const ANNOUNCEMENT_READ_MIRROR_KEY = "cpk:inspector:announcement_read";
+const LEGACY_ANNOUNCEMENT_READ_KEY = "cpk:inspector:announcements";
+const ANNOUNCEMENT_PULSED_SESSION_KEY = "cpk:inspector:pulsed";
+const ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 3600 * 24 * 365;
+/**
+* The announcement timestamp the user has already read, or `null` when
+* nothing has been read yet. Prefers the host-scoped cookie and falls back to
+* the origin-scoped mirror, so cookie-blocking browsers still remember the
+* read within the port they are on.
+*/
+function loadAnnouncementReadTimestamp() {
+	return parseTimestampPayload(readAnnouncementCookie()) ?? parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY));
+}
+/**
+* Records an announcement as read in both the host-scoped cookie and the
+* origin-scoped mirror. The stored value is `{"timestamp":"…"}` — the same
+* shape the announcement state has always used.
+*/
+function saveAnnouncementReadTimestamp(timestamp) {
+	const payload = JSON.stringify({ timestamp });
+	writeAnnouncementCookie(payload);
+	writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);
+}
+/**
+* Deletes the superseded origin-scoped read state. Safe to call on every
+* startup: nothing writes that key any more, so the value cannot come back.
+*/
+function clearLegacyAnnouncementReadState() {
+	removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);
+}
+/**
+* The announcement timestamp this browser tab has already pulsed for, or
+* `null` when it hasn't pulsed yet.
+*/
+function loadAnnouncementPulsedTimestamp() {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);
+	} catch {
+		return null;
+	}
+}
+/** Suppresses further pulses for this announcement in this browser tab. */
+function saveAnnouncementPulsedTimestamp(timestamp) {
+	if (typeof window === "undefined") return;
+	try {
+		window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);
+	} catch {}
+}
+function parseTimestampPayload(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return typeof parsed?.timestamp === "string" ? parsed.timestamp : null;
+	} catch {
+		return null;
+	}
+}
+function readAnnouncementCookie() {
+	if (typeof document === "undefined") return null;
+	try {
+		for (const entry of document.cookie.split(";")) {
+			const separator = entry.indexOf("=");
+			if (separator === -1) continue;
+			if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) continue;
+			return decodeURIComponent(entry.slice(separator + 1).trim());
+		}
+	} catch {}
+	return null;
+}
+function writeAnnouncementCookie(value) {
+	if (typeof document === "undefined") return;
+	try {
+		document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(value)}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;
+	} catch {}
+}
+function readLocalStorageItem(key) {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage.getItem(key);
+	} catch {
+		return null;
+	}
+}
+function writeLocalStorageItem(key, value) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.setItem(key, value);
+	} catch {}
+}
+function removeLocalStorageItem(key) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.removeItem(key);
+	} catch {}
+}
 const TELEMETRY_DISTINCT_ID_KEY = "cpk:inspector:telemetry:distinct_id";
 const TELEMETRY_OPT_OUT_KEY = "cpk:inspector:telemetry:opt_out";
 const TELEMETRY_DISCLOSURE_SHOWN_KEY = "cpk:inspector:telemetry:disclosure_shown";
@@ -98,6 +195,7 @@ function generateUuidV4() {
 }
 
 //#endregion
+exports.clearLegacyAnnouncementReadState = clearLegacyAnnouncementReadState;
 exports.getOrCreateTelemetryDistinctId = getOrCreateTelemetryDistinctId;
 exports.hasTelemetryDisclosureBeenShown = hasTelemetryDisclosureBeenShown;
 exports.isTelemetryOptedOut = isTelemetryOptedOut;
@@ -105,7 +203,11 @@ exports.isValidAnchor = isValidAnchor;
 exports.isValidDockMode = isValidDockMode;
 exports.isValidPosition = isValidPosition;
 exports.isValidSize = isValidSize;
+exports.loadAnnouncementPulsedTimestamp = loadAnnouncementPulsedTimestamp;
+exports.loadAnnouncementReadTimestamp = loadAnnouncementReadTimestamp;
 exports.loadInspectorState = loadInspectorState;
 exports.markTelemetryDisclosureShown = markTelemetryDisclosureShown;
+exports.saveAnnouncementPulsedTimestamp = saveAnnouncementPulsedTimestamp;
+exports.saveAnnouncementReadTimestamp = saveAnnouncementReadTimestamp;
 exports.saveInspectorState = saveInspectorState;
 //# sourceMappingURL=persistence.cjs.map

package/dist/lib/persistence.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.cjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n};\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that banner_viewed and banner_clicked from\n// the same page-load share one distinct_id even without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"persistence.cjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n  hasOpenedInspector?: boolean;\n  sidebarCollapsed?: boolean;\n  /** @deprecated Replaced by colorSchemePreference to distinguish a user choice from the old light default. */\n  colorScheme?: \"light\" | \"dark\";\n  colorSchemePreference?: \"light\" | \"dark\";\n};\n\nexport const HOME_NEWS_READ_STORAGE_KEY = \"cpk:inspector:home-news-read\";\n\n/** Return story ids the user has already opened or hovered on Home. */\nexport function loadHomeNewsReadIds(storageKey: string): string[] {\n  if (typeof window === \"undefined\") {\n    return [];\n  }\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (!raw) {\n      return [];\n    }\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter((id): id is string => typeof id === \"string\");\n  } catch {\n    return [];\n  }\n}\n\n/** Persist Home news story ids that the user has already seen. */\nexport function saveHomeNewsReadIds(storageKey: string, ids: string[]): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(ids));\n  } catch (error) {\n    console.warn(\"Failed to persist Home news read state\", error);\n  }\n}\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Announcement read state — \"have I read this announcement\" is a property of\n// the person, not of the project, so it must survive a change of localhost\n// port. localStorage cannot express that: it is partitioned by origin and\n// origin includes the port, so :3000 and :5173 are separate stores. Cookies\n// are partitioned by host, so a cookie set on `localhost` without a `domain`\n// attribute is shared by every port on that host.\n//\n// Underscores, not colons: `:` is a separator in RFC 6265 and is not valid in\n// a cookie name. Browsers are lenient about it; we don't rely on that.\nconst ANNOUNCEMENT_READ_COOKIE_NAME = \"cpk_inspector_announcements\";\n\n// localStorage mirror of the cookie, so a browser that blocks cookies\n// degrades to per-port behaviour instead of losing the read state entirely.\n// A NEW key on purpose — the legacy one is abandoned, not migrated.\nconst ANNOUNCEMENT_READ_MIRROR_KEY = \"cpk:inspector:announcement_read\";\n\n// The superseded key. Every existing user is re-armed exactly once so they\n// discover the surface that replaced the announcement bubble, and the key is\n// deleted rather than left in place so nothing can fall back to it later.\nconst LEGACY_ANNOUNCEMENT_READ_KEY = \"cpk:inspector:announcements\";\n\n// Pulse suppression is per browser tab, and stores the announcement timestamp\n// rather than a boolean: a boolean would swallow a newly published\n// announcement for the rest of that tab's life, and the feed is fetched once\n// per mount with no polling.\nconst ANNOUNCEMENT_PULSED_SESSION_KEY = \"cpk:inspector:pulsed\";\n\n// Roughly one year. No `Secure` — local development is served over plain\n// HTTP — and no `HttpOnly`, because the component reads the value from\n// script. `Path=/` and `SameSite=Lax` keep it host-wide and same-site only.\nconst ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 60 * 60 * 24 * 365;\n\n/**\n * The announcement timestamp the user has already read, or `null` when\n * nothing has been read yet. Prefers the host-scoped cookie and falls back to\n * the origin-scoped mirror, so cookie-blocking browsers still remember the\n * read within the port they are on.\n */\nexport function loadAnnouncementReadTimestamp(): string | null {\n  return (\n    parseTimestampPayload(readAnnouncementCookie()) ??\n    parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY))\n  );\n}\n\n/**\n * Records an announcement as read in both the host-scoped cookie and the\n * origin-scoped mirror. The stored value is `{\"timestamp\":\"…\"}` — the same\n * shape the announcement state has always used.\n */\nexport function saveAnnouncementReadTimestamp(timestamp: string): void {\n  const payload = JSON.stringify({ timestamp });\n  writeAnnouncementCookie(payload);\n  writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);\n}\n\n/**\n * Deletes the superseded origin-scoped read state. Safe to call on every\n * startup: nothing writes that key any more, so the value cannot come back.\n */\nexport function clearLegacyAnnouncementReadState(): void {\n  removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);\n}\n\n/**\n * The announcement timestamp this browser tab has already pulsed for, or\n * `null` when it hasn't pulsed yet.\n */\nexport function loadAnnouncementPulsedTimestamp(): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);\n  } catch {\n    return null;\n  }\n}\n\n/** Suppresses further pulses for this announcement in this browser tab. */\nexport function saveAnnouncementPulsedTimestamp(timestamp: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);\n  } catch {\n    // No-op — a lost suppression costs one extra pulse, never correctness.\n  }\n}\n\nfunction parseTimestampPayload(raw: string | null): string | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as { timestamp?: unknown };\n    return typeof parsed?.timestamp === \"string\" ? parsed.timestamp : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction readAnnouncementCookie(): string | null {\n  if (typeof document === \"undefined\") return null;\n  try {\n    for (const entry of document.cookie.split(\";\")) {\n      const separator = entry.indexOf(\"=\");\n      if (separator === -1) continue;\n      if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) {\n        continue;\n      }\n      return decodeURIComponent(entry.slice(separator + 1).trim());\n    }\n  } catch {\n    // Cookie access throws in sandboxed documents — fall through to the\n    // mirror rather than breaking the host app.\n  }\n  return null;\n}\n\nfunction writeAnnouncementCookie(value: string): void {\n  if (typeof document === \"undefined\") return;\n  try {\n    document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(\n      value,\n    )}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;\n  } catch {\n    // No-op — the mirror below is what a cookie-blocking browser falls back\n    // to, and neither may break the host app.\n  }\n}\n\nfunction readLocalStorageItem(key: string): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeLocalStorageItem(key: string, value: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nfunction removeLocalStorageItem(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // No-op.\n  }\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that whats_new_viewed and\n// whats_new_clicked from the same page-load share one distinct_id even\n// without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}

package/dist/lib/persistence.mjs

@@ -50,6 +50,103 @@ function isFiniteNumber(value) {
 function isValidDockMode(value) {
 	return value === "floating" || value === "docked-left";
 }
+const ANNOUNCEMENT_READ_COOKIE_NAME = "cpk_inspector_announcements";
+const ANNOUNCEMENT_READ_MIRROR_KEY = "cpk:inspector:announcement_read";
+const LEGACY_ANNOUNCEMENT_READ_KEY = "cpk:inspector:announcements";
+const ANNOUNCEMENT_PULSED_SESSION_KEY = "cpk:inspector:pulsed";
+const ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 3600 * 24 * 365;
+/**
+* The announcement timestamp the user has already read, or `null` when
+* nothing has been read yet. Prefers the host-scoped cookie and falls back to
+* the origin-scoped mirror, so cookie-blocking browsers still remember the
+* read within the port they are on.
+*/
+function loadAnnouncementReadTimestamp() {
+	return parseTimestampPayload(readAnnouncementCookie()) ?? parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY));
+}
+/**
+* Records an announcement as read in both the host-scoped cookie and the
+* origin-scoped mirror. The stored value is `{"timestamp":"…"}` — the same
+* shape the announcement state has always used.
+*/
+function saveAnnouncementReadTimestamp(timestamp) {
+	const payload = JSON.stringify({ timestamp });
+	writeAnnouncementCookie(payload);
+	writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);
+}
+/**
+* Deletes the superseded origin-scoped read state. Safe to call on every
+* startup: nothing writes that key any more, so the value cannot come back.
+*/
+function clearLegacyAnnouncementReadState() {
+	removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);
+}
+/**
+* The announcement timestamp this browser tab has already pulsed for, or
+* `null` when it hasn't pulsed yet.
+*/
+function loadAnnouncementPulsedTimestamp() {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);
+	} catch {
+		return null;
+	}
+}
+/** Suppresses further pulses for this announcement in this browser tab. */
+function saveAnnouncementPulsedTimestamp(timestamp) {
+	if (typeof window === "undefined") return;
+	try {
+		window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);
+	} catch {}
+}
+function parseTimestampPayload(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return typeof parsed?.timestamp === "string" ? parsed.timestamp : null;
+	} catch {
+		return null;
+	}
+}
+function readAnnouncementCookie() {
+	if (typeof document === "undefined") return null;
+	try {
+		for (const entry of document.cookie.split(";")) {
+			const separator = entry.indexOf("=");
+			if (separator === -1) continue;
+			if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) continue;
+			return decodeURIComponent(entry.slice(separator + 1).trim());
+		}
+	} catch {}
+	return null;
+}
+function writeAnnouncementCookie(value) {
+	if (typeof document === "undefined") return;
+	try {
+		document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(value)}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;
+	} catch {}
+}
+function readLocalStorageItem(key) {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage.getItem(key);
+	} catch {
+		return null;
+	}
+}
+function writeLocalStorageItem(key, value) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.setItem(key, value);
+	} catch {}
+}
+function removeLocalStorageItem(key) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.removeItem(key);
+	} catch {}
+}
 const TELEMETRY_DISTINCT_ID_KEY = "cpk:inspector:telemetry:distinct_id";
 const TELEMETRY_OPT_OUT_KEY = "cpk:inspector:telemetry:opt_out";
 const TELEMETRY_DISCLOSURE_SHOWN_KEY = "cpk:inspector:telemetry:disclosure_shown";
@@ -97,5 +194,5 @@ function generateUuidV4() {
 }
 
 //#endregion
-export { getOrCreateTelemetryDistinctId, hasTelemetryDisclosureBeenShown, isTelemetryOptedOut, isValidAnchor, isValidDockMode, isValidPosition, isValidSize, loadInspectorState, markTelemetryDisclosureShown, saveInspectorState };
+export { clearLegacyAnnouncementReadState, getOrCreateTelemetryDistinctId, hasTelemetryDisclosureBeenShown, isTelemetryOptedOut, isValidAnchor, isValidDockMode, isValidPosition, isValidSize, loadAnnouncementPulsedTimestamp, loadAnnouncementReadTimestamp, loadInspectorState, markTelemetryDisclosureShown, saveAnnouncementPulsedTimestamp, saveAnnouncementReadTimestamp, saveInspectorState };
 //# sourceMappingURL=persistence.mjs.map

package/dist/lib/persistence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n};\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that banner_viewed and banner_clicked from\n// the same page-load share one distinct_id even without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/lib/persistence.ts"],"sourcesContent":["import type { Anchor, DockMode, Position, Size } from \"./types.js\";\n\nexport type PersistedContextState = {\n  anchor?: Anchor;\n  anchorOffset?: Position;\n  size?: Size;\n  hasCustomPosition?: boolean;\n};\n\nexport type PersistedState = {\n  button?: Omit<PersistedContextState, \"size\">;\n  window?: PersistedContextState;\n  isOpen?: boolean;\n  dockMode?: DockMode;\n  selectedMenu?: string;\n  selectedContext?: string;\n  hasOpenedInspector?: boolean;\n  sidebarCollapsed?: boolean;\n  /** @deprecated Replaced by colorSchemePreference to distinguish a user choice from the old light default. */\n  colorScheme?: \"light\" | \"dark\";\n  colorSchemePreference?: \"light\" | \"dark\";\n};\n\nexport const HOME_NEWS_READ_STORAGE_KEY = \"cpk:inspector:home-news-read\";\n\n/** Return story ids the user has already opened or hovered on Home. */\nexport function loadHomeNewsReadIds(storageKey: string): string[] {\n  if (typeof window === \"undefined\") {\n    return [];\n  }\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n    if (!raw) {\n      return [];\n    }\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter((id): id is string => typeof id === \"string\");\n  } catch {\n    return [];\n  }\n}\n\n/** Persist Home news story ids that the user has already seen. */\nexport function saveHomeNewsReadIds(storageKey: string, ids: string[]): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(ids));\n  } catch (error) {\n    console.warn(\"Failed to persist Home news read state\", error);\n  }\n}\n\nexport function loadInspectorState(storageKey: string): PersistedState | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  const raw = window.localStorage.getItem(storageKey);\n  if (raw) {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        return parsed as PersistedState;\n      }\n    } catch {\n      // Fall through to cookie migration path\n    }\n  }\n\n  // Backwards compatibility: try to read the legacy cookie and migrate it\n  if (typeof document !== \"undefined\") {\n    const prefix = `${storageKey}=`;\n    const entry = document.cookie\n      .split(\"; \")\n      .find((cookie) => cookie.startsWith(prefix));\n    if (entry) {\n      const legacyRaw = entry.substring(prefix.length);\n      try {\n        const parsed = JSON.parse(decodeURIComponent(legacyRaw));\n        if (parsed && typeof parsed === \"object\") {\n          return parsed as PersistedState;\n        }\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function saveInspectorState(\n  storageKey: string,\n  state: PersistedState,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(storageKey, JSON.stringify(state));\n  } catch (error) {\n    console.warn(\"Failed to persist inspector state\", error);\n  }\n}\n\nexport function isValidAnchor(value: unknown): value is Anchor {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Anchor;\n  return (\n    (candidate.horizontal === \"left\" || candidate.horizontal === \"right\") &&\n    (candidate.vertical === \"top\" || candidate.vertical === \"bottom\")\n  );\n}\n\nexport function isValidPosition(value: unknown): value is Position {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Position;\n  return isFiniteNumber(candidate.x) && isFiniteNumber(candidate.y);\n}\n\nexport function isValidSize(value: unknown): value is Size {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Size;\n  return isFiniteNumber(candidate.width) && isFiniteNumber(candidate.height);\n}\n\nexport function isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nexport function isValidDockMode(value: unknown): value is DockMode {\n  return value === \"floating\" || value === \"docked-left\";\n}\n\n// Announcement read state — \"have I read this announcement\" is a property of\n// the person, not of the project, so it must survive a change of localhost\n// port. localStorage cannot express that: it is partitioned by origin and\n// origin includes the port, so :3000 and :5173 are separate stores. Cookies\n// are partitioned by host, so a cookie set on `localhost` without a `domain`\n// attribute is shared by every port on that host.\n//\n// Underscores, not colons: `:` is a separator in RFC 6265 and is not valid in\n// a cookie name. Browsers are lenient about it; we don't rely on that.\nconst ANNOUNCEMENT_READ_COOKIE_NAME = \"cpk_inspector_announcements\";\n\n// localStorage mirror of the cookie, so a browser that blocks cookies\n// degrades to per-port behaviour instead of losing the read state entirely.\n// A NEW key on purpose — the legacy one is abandoned, not migrated.\nconst ANNOUNCEMENT_READ_MIRROR_KEY = \"cpk:inspector:announcement_read\";\n\n// The superseded key. Every existing user is re-armed exactly once so they\n// discover the surface that replaced the announcement bubble, and the key is\n// deleted rather than left in place so nothing can fall back to it later.\nconst LEGACY_ANNOUNCEMENT_READ_KEY = \"cpk:inspector:announcements\";\n\n// Pulse suppression is per browser tab, and stores the announcement timestamp\n// rather than a boolean: a boolean would swallow a newly published\n// announcement for the rest of that tab's life, and the feed is fetched once\n// per mount with no polling.\nconst ANNOUNCEMENT_PULSED_SESSION_KEY = \"cpk:inspector:pulsed\";\n\n// Roughly one year. No `Secure` — local development is served over plain\n// HTTP — and no `HttpOnly`, because the component reads the value from\n// script. `Path=/` and `SameSite=Lax` keep it host-wide and same-site only.\nconst ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS = 60 * 60 * 24 * 365;\n\n/**\n * The announcement timestamp the user has already read, or `null` when\n * nothing has been read yet. Prefers the host-scoped cookie and falls back to\n * the origin-scoped mirror, so cookie-blocking browsers still remember the\n * read within the port they are on.\n */\nexport function loadAnnouncementReadTimestamp(): string | null {\n  return (\n    parseTimestampPayload(readAnnouncementCookie()) ??\n    parseTimestampPayload(readLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY))\n  );\n}\n\n/**\n * Records an announcement as read in both the host-scoped cookie and the\n * origin-scoped mirror. The stored value is `{\"timestamp\":\"…\"}` — the same\n * shape the announcement state has always used.\n */\nexport function saveAnnouncementReadTimestamp(timestamp: string): void {\n  const payload = JSON.stringify({ timestamp });\n  writeAnnouncementCookie(payload);\n  writeLocalStorageItem(ANNOUNCEMENT_READ_MIRROR_KEY, payload);\n}\n\n/**\n * Deletes the superseded origin-scoped read state. Safe to call on every\n * startup: nothing writes that key any more, so the value cannot come back.\n */\nexport function clearLegacyAnnouncementReadState(): void {\n  removeLocalStorageItem(LEGACY_ANNOUNCEMENT_READ_KEY);\n}\n\n/**\n * The announcement timestamp this browser tab has already pulsed for, or\n * `null` when it hasn't pulsed yet.\n */\nexport function loadAnnouncementPulsedTimestamp(): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.sessionStorage.getItem(ANNOUNCEMENT_PULSED_SESSION_KEY);\n  } catch {\n    return null;\n  }\n}\n\n/** Suppresses further pulses for this announcement in this browser tab. */\nexport function saveAnnouncementPulsedTimestamp(timestamp: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.sessionStorage.setItem(ANNOUNCEMENT_PULSED_SESSION_KEY, timestamp);\n  } catch {\n    // No-op — a lost suppression costs one extra pulse, never correctness.\n  }\n}\n\nfunction parseTimestampPayload(raw: string | null): string | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as { timestamp?: unknown };\n    return typeof parsed?.timestamp === \"string\" ? parsed.timestamp : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction readAnnouncementCookie(): string | null {\n  if (typeof document === \"undefined\") return null;\n  try {\n    for (const entry of document.cookie.split(\";\")) {\n      const separator = entry.indexOf(\"=\");\n      if (separator === -1) continue;\n      if (entry.slice(0, separator).trim() !== ANNOUNCEMENT_READ_COOKIE_NAME) {\n        continue;\n      }\n      return decodeURIComponent(entry.slice(separator + 1).trim());\n    }\n  } catch {\n    // Cookie access throws in sandboxed documents — fall through to the\n    // mirror rather than breaking the host app.\n  }\n  return null;\n}\n\nfunction writeAnnouncementCookie(value: string): void {\n  if (typeof document === \"undefined\") return;\n  try {\n    document.cookie = `${ANNOUNCEMENT_READ_COOKIE_NAME}=${encodeURIComponent(\n      value,\n    )}; Path=/; Max-Age=${ANNOUNCEMENT_READ_COOKIE_MAX_AGE_SECONDS}; SameSite=Lax`;\n  } catch {\n    // No-op — the mirror below is what a cookie-blocking browser falls back\n    // to, and neither may break the host app.\n  }\n}\n\nfunction readLocalStorageItem(key: string): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeLocalStorageItem(key: string, value: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(key, value);\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nfunction removeLocalStorageItem(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // No-op.\n  }\n}\n\n// Telemetry persistence — flat per-key localStorage rather than the\n// JSON-blob shape used for window/dock state, because each value is\n// independent and we want to read/write them without round-tripping\n// the whole inspector state object.\nconst TELEMETRY_DISTINCT_ID_KEY = \"cpk:inspector:telemetry:distinct_id\";\nconst TELEMETRY_OPT_OUT_KEY = \"cpk:inspector:telemetry:opt_out\";\nconst TELEMETRY_DISCLOSURE_SHOWN_KEY =\n  \"cpk:inspector:telemetry:disclosure_shown\";\n\n// Module-level fallback for when localStorage is unavailable (private mode,\n// quota exceeded, etc.). Cached so that whats_new_viewed and\n// whats_new_clicked from the same page-load share one distinct_id even\n// without persistent storage —\n// funnel coherence within a session is preserved even when storage fails.\nlet inMemoryFallbackId: string | null = null;\n\nexport function getOrCreateTelemetryDistinctId(): string {\n  if (typeof window === \"undefined\") {\n    // SSR / test fallback. A non-persistent ID is preferable to throwing\n    // because telemetry must never break the host application.\n    return generateUuidV4();\n  }\n\n  try {\n    const existing = window.localStorage.getItem(TELEMETRY_DISTINCT_ID_KEY);\n    if (existing && existing.length > 0) return existing;\n    const fresh = generateUuidV4();\n    window.localStorage.setItem(TELEMETRY_DISTINCT_ID_KEY, fresh);\n    return fresh;\n  } catch {\n    return (inMemoryFallbackId ??= generateUuidV4());\n  }\n}\n\n// Test-only reset so the in-memory fallback doesn't leak between test cases.\nexport function _resetTelemetryPersistenceForTesting(): void {\n  inMemoryFallbackId = null;\n}\n\nexport function isTelemetryOptedOut(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return window.localStorage.getItem(TELEMETRY_OPT_OUT_KEY) === \"true\";\n  } catch {\n    return false;\n  }\n}\n\nexport function setTelemetryOptOut(optedOut: boolean): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (optedOut) {\n      window.localStorage.setItem(TELEMETRY_OPT_OUT_KEY, \"true\");\n    } else {\n      window.localStorage.removeItem(TELEMETRY_OPT_OUT_KEY);\n    }\n  } catch {\n    // No-op — see getOrCreateTelemetryDistinctId.\n  }\n}\n\nexport function hasTelemetryDisclosureBeenShown(): boolean {\n  if (typeof window === \"undefined\") return false;\n  try {\n    return (\n      window.localStorage.getItem(TELEMETRY_DISCLOSURE_SHOWN_KEY) === \"true\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function markTelemetryDisclosureShown(): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(TELEMETRY_DISCLOSURE_SHOWN_KEY, \"true\");\n  } catch {\n    // No-op.\n  }\n}\n\nfunction generateUuidV4(): string {\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    typeof globalThis.crypto.randomUUID === \"function\"\n  ) {\n    return globalThis.crypto.randomUUID();\n  }\n  // Fallback for environments without crypto.randomUUID (older browsers,\n  // some test runners). Not cryptographically strong; acceptable because\n  // the value is just an anonymous correlation ID.\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n"],"mappings":";AA2DA,SAAgB,mBAAmB,YAA2C;AAC5E,KAAI,OAAO,WAAW,YACpB,QAAO;CAGT,MAAM,MAAM,OAAO,aAAa,QAAQ,WAAW;AACnD,KAAI,IACF,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,SAC9B,QAAO;SAEH;AAMV,KAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAS,GAAG,WAAW;EAC7B,MAAM,QAAQ,SAAS,OACpB,MAAM,KAAK,CACX,MAAM,WAAW,OAAO,WAAW,OAAO,CAAC;AAC9C,MAAI,OAAO;GACT,MAAM,YAAY,MAAM,UAAU,OAAO,OAAO;AAChD,OAAI;IACF,MAAM,SAAS,KAAK,MAAM,mBAAmB,UAAU,CAAC;AACxD,QAAI,UAAU,OAAO,WAAW,SAC9B,QAAO;WAEH;AACN,WAAO;;;;AAKb,QAAO;;AAGT,SAAgB,mBACd,YACA,OACM;AACN,KAAI,OAAO,WAAW,YACpB;AAGF,KAAI;AACF,SAAO,aAAa,QAAQ,YAAY,KAAK,UAAU,MAAM,CAAC;UACvD,OAAO;AACd,UAAQ,KAAK,qCAAqC,MAAM;;;AAI5D,SAAgB,cAAc,OAAiC;AAC7D,KAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO;CAGT,MAAM,YAAY;AAClB,SACG,UAAU,eAAe,UAAU,UAAU,eAAe,aAC5D,UAAU,aAAa,SAAS,UAAU,aAAa;;AAI5D,SAAgB,gBAAgB,OAAmC;AACjE,KAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO;CAGT,MAAM,YAAY;AAClB,QAAO,eAAe,UAAU,EAAE,IAAI,eAAe,UAAU,EAAE;;AAGnE,SAAgB,YAAY,OAA+B;AACzD,KAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO;CAGT,MAAM,YAAY;AAClB,QAAO,eAAe,UAAU,MAAM,IAAI,eAAe,UAAU,OAAO;;AAG5E,SAAgB,eAAe,OAAiC;AAC9D,QAAO,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM;;AAG5D,SAAgB,gBAAgB,OAAmC;AACjE,QAAO,UAAU,cAAc,UAAU;;AAY3C,MAAM,gCAAgC;AAKtC,MAAM,+BAA+B;AAKrC,MAAM,+BAA+B;AAMrC,MAAM,kCAAkC;AAKxC,MAAM,2CAA2C,OAAU,KAAK;;;;;;;AAQhE,SAAgB,gCAA+C;AAC7D,QACE,sBAAsB,wBAAwB,CAAC,IAC/C,sBAAsB,qBAAqB,6BAA6B,CAAC;;;;;;;AAS7E,SAAgB,8BAA8B,WAAyB;CACrE,MAAM,UAAU,KAAK,UAAU,EAAE,WAAW,CAAC;AAC7C,yBAAwB,QAAQ;AAChC,uBAAsB,8BAA8B,QAAQ;;;;;;AAO9D,SAAgB,mCAAyC;AACvD,wBAAuB,6BAA6B;;;;;;AAOtD,SAAgB,kCAAiD;AAC/D,KAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,KAAI;AACF,SAAO,OAAO,eAAe,QAAQ,gCAAgC;SAC/D;AACN,SAAO;;;;AAKX,SAAgB,gCAAgC,WAAyB;AACvE,KAAI,OAAO,WAAW,YAAa;AACnC,KAAI;AACF,SAAO,eAAe,QAAQ,iCAAiC,UAAU;SACnE;;AAKV,SAAS,sBAAsB,KAAmC;AAChE,KAAI,CAAC,IAAK,QAAO;AACjB,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,SAAO,OAAO,QAAQ,cAAc,WAAW,OAAO,YAAY;SAC5D;AACN,SAAO;;;AAIX,SAAS,yBAAwC;AAC/C,KAAI,OAAO,aAAa,YAAa,QAAO;AAC5C,KAAI;AACF,OAAK,MAAM,SAAS,SAAS,OAAO,MAAM,IAAI,EAAE;GAC9C,MAAM,YAAY,MAAM,QAAQ,IAAI;AACpC,OAAI,cAAc,GAAI;AACtB,OAAI,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,KAAK,8BACvC;AAEF,UAAO,mBAAmB,MAAM,MAAM,YAAY,EAAE,CAAC,MAAM,CAAC;;SAExD;AAIR,QAAO;;AAGT,SAAS,wBAAwB,OAAqB;AACpD,KAAI,OAAO,aAAa,YAAa;AACrC,KAAI;AACF,WAAS,SAAS,GAAG,8BAA8B,GAAG,mBACpD,MACD,CAAC,oBAAoB,yCAAyC;SACzD;;AAMV,SAAS,qBAAqB,KAA4B;AACxD,KAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,KAAI;AACF,SAAO,OAAO,aAAa,QAAQ,IAAI;SACjC;AACN,SAAO;;;AAIX,SAAS,sBAAsB,KAAa,OAAqB;AAC/D,KAAI,OAAO,WAAW,YAAa;AACnC,KAAI;AACF,SAAO,aAAa,QAAQ,KAAK,MAAM;SACjC;;AAKV,SAAS,uBAAuB,KAAmB;AACjD,KAAI,OAAO,WAAW,YAAa;AACnC,KAAI;AACF,SAAO,aAAa,WAAW,IAAI;SAC7B;;AASV,MAAM,4BAA4B;AAClC,MAAM,wBAAwB;AAC9B,MAAM,iCACJ;AAOF,IAAI,qBAAoC;AAExC,SAAgB,iCAAyC;AACvD,KAAI,OAAO,WAAW,YAGpB,QAAO,gBAAgB;AAGzB,KAAI;EACF,MAAM,WAAW,OAAO,aAAa,QAAQ,0BAA0B;AACvE,MAAI,YAAY,SAAS,SAAS,EAAG,QAAO;EAC5C,MAAM,QAAQ,gBAAgB;AAC9B,SAAO,aAAa,QAAQ,2BAA2B,MAAM;AAC7D,SAAO;SACD;AACN,SAAQ,uBAAuB,gBAAgB;;;AASnD,SAAgB,sBAA+B;AAC7C,KAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,KAAI;AACF,SAAO,OAAO,aAAa,QAAQ,sBAAsB,KAAK;SACxD;AACN,SAAO;;;AAiBX,SAAgB,kCAA2C;AACzD,KAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,KAAI;AACF,SACE,OAAO,aAAa,QAAQ,+BAA+B,KAAK;SAE5D;AACN,SAAO;;;AAIX,SAAgB,+BAAqC;AACnD,KAAI,OAAO,WAAW,YAAa;AACnC,KAAI;AACF,SAAO,aAAa,QAAQ,gCAAgC,OAAO;SAC7D;;AAKV,SAAS,iBAAyB;AAChC,KACE,OAAO,WAAW,WAAW,eAC7B,OAAO,WAAW,OAAO,eAAe,WAExC,QAAO,WAAW,OAAO,YAAY;AAKvC,QAAO,uCAAuC,QAAQ,UAAU,MAAM;EACpE,MAAM,IAAK,KAAK,QAAQ,GAAG,KAAM;AAEjC,UADU,MAAM,MAAM,IAAK,IAAI,IAAO,GAC7B,SAAS,GAAG;GACrB"}

package/dist/lib/telemetry.cjs

@@ -4,9 +4,9 @@ const require_package = require('../package.cjs');
 //#region src/lib/telemetry.ts
 const TELEMETRY_EVENTS = {
 	opened: "oss.inspector.opened",
-	bannerViewed: "oss.inspector.banner_viewed",
-	bannerClicked: "oss.inspector.banner_clicked",
-	bannerDismissed: "oss.inspector.banner_dismissed",
+	whatsNewViewed: "oss.inspector.whats_new_viewed",
+	whatsNewSignalViewed: "oss.inspector.whats_new_signal_viewed",
+	whatsNewClicked: "oss.inspector.whats_new_clicked",
 	threadsTabClicked: "oss.inspector.threads_tab_clicked",
 	threadsLockedViewed: "oss.inspector.threads_locked_viewed",
 	threadsIntelligenceSignupClicked: "oss.inspector.threads_intelligence_signup_clicked",
@@ -22,6 +22,8 @@ const TELEMETRY_EVENTS = {
 	threadsExampleTourCompleted: "oss.inspector.threads_example_tour_completed",
 	threadsExampleTourReopened: "oss.inspector.threads_example_tour_reopened",
 	memoriesTabClicked: "oss.inspector.memories_tab_clicked",
+	homeViewed: "oss.inspector.home_viewed",
+	homeCtaClicked: "oss.inspector.home_cta_clicked",
 	metadataModuleViewed: "oss.inspector.metadata_module_viewed",
 	metadataActionClicked: "oss.inspector.metadata_action_clicked"
 };
@@ -30,9 +32,6 @@ const TELEMETRY_DOCS_URL = "https://docs.copilotkit.ai/telemetry";
 const PACKAGE_NAME = "@copilotkit/web-inspector";
 const PACKAGE_VERSION = require_package.version;
 const FETCH_TIMEOUT_MS = 3e3;
-function isEnrichedTelemetryEvent(event) {
-	return event === TELEMETRY_EVENTS.opened || event === TELEMETRY_EVENTS.threadsTabClicked || event === TELEMETRY_EVENTS.threadsLockedViewed || event === TELEMETRY_EVENTS.threadsIntelligenceSignupClicked || event === TELEMETRY_EVENTS.threadsTalkToEngineerClicked || event === TELEMETRY_EVENTS.talkToEngineerClicked || event === TELEMETRY_EVENTS.threadsEmptyEnabledViewed || event === TELEMETRY_EVENTS.threadsEnabledViewed || event === TELEMETRY_EVENTS.threadsExampleViewed || event === TELEMETRY_EVENTS.threadsExampleSelected || event === TELEMETRY_EVENTS.threadsExampleTourStarted || event === TELEMETRY_EVENTS.threadsExampleTourStepViewed || event === TELEMETRY_EVENTS.threadsExampleTourDismissed || event === TELEMETRY_EVENTS.threadsExampleTourCompleted || event === TELEMETRY_EVENTS.threadsExampleTourReopened || event === TELEMETRY_EVENTS.memoriesTabClicked || event === TELEMETRY_EVENTS.metadataModuleViewed || event === TELEMETRY_EVENTS.metadataActionClicked;
-}
 function getRuntimeUrlType(runtimeUrl) {
 	if (!runtimeUrl) return "missing";
 	if (runtimeUrl.startsWith("/") && !runtimeUrl.startsWith("//")) return "relative";
@@ -59,47 +58,47 @@ function track(event, properties = {}) {
 	if (require_persistence.isTelemetryOptedOut()) return;
 	try {
 		const distinctId = require_persistence.getOrCreateTelemetryDistinctId();
-		const enrichedProperties = isEnrichedTelemetryEvent(event) ? {
-			package_name: PACKAGE_NAME,
-			package_version: PACKAGE_VERSION,
-			inspector_distinct_id: distinctId
-		} : {};
 		postBestEffort(TELEMETRY_INGEST_URL, JSON.stringify({
 			event,
 			properties: {
 				...properties,
-				...enrichedProperties,
+				package_name: PACKAGE_NAME,
+				package_version: PACKAGE_VERSION,
+				inspector_distinct_id: distinctId,
 				distinct_id: distinctId
 			},
 			package: {
 				name: PACKAGE_NAME,
-				...isEnrichedTelemetryEvent(event) ? { version: PACKAGE_VERSION } : {}
+				version: PACKAGE_VERSION
 			},
 			ts: Math.floor(Date.now() / 1e3)
 		}), distinctId);
 	} catch {}
 }
-function trackBannerViewed(props) {
-	track(TELEMETRY_EVENTS.bannerViewed, props);
+/**
+* Fires when What's new has rendered *with content*. A loading state is not
+* an impression, so the metric cannot inflate itself by counting readers who
+* arrived before the feed resolved.
+*/
+function trackWhatsNewViewed(props) {
+	track(TELEMETRY_EVENTS.whatsNewViewed, props);
 }
-function trackBannerClicked(props) {
-	track(TELEMETRY_EVENTS.bannerClicked, props);
+/** Fires when the unread launcher signal is presented in a visible tab. */
+function trackWhatsNewSignalViewed(props) {
+	track(TELEMETRY_EVENTS.whatsNewSignalViewed, props);
 }
 /**
-* First-class dismissal signal. Emitted *in addition to*
-* `banner_clicked { cta: "dismiss" }` rather than replacing it — the
-* existing dashboards read the `cta` value, so removing it would silently
-* zero them out. New reporting should prefer this event, whose `surface`
-* says whether the user swatted the bubble away or dismissed the card
-* after opening the panel.
+* Fires for links followed inside the announcement body. `body` is the only
+* call-to-action left: dismissal no longer exists, so there is nothing else a
+* click on this surface can mean.
 */
-function trackBannerDismissed(props) {
-	track(TELEMETRY_EVENTS.bannerDismissed, props);
+function trackWhatsNewClicked(props) {
+	track(TELEMETRY_EVENTS.whatsNewClicked, props);
 }
 /**
 * Panel-open signal (OSS-566). Before this event, opens could only be
-* inferred from in-panel activity (a floor) or from `banner_clicked`
-* cta=`body` (which misses the floating-button path entirely).
+* inferred from in-panel activity (a floor) or from the announcement's own
+* click event (which misses the floating-button path entirely).
 */
 function trackInspectorOpened(props) {
 	track(TELEMETRY_EVENTS.opened, props);
@@ -196,6 +195,19 @@ function trackThreadsExampleTourReopened(props) {
 function trackMemoriesTabClicked(props = {}) {
 	track(TELEMETRY_EVENTS.memoriesTabClicked, props);
 }
+function trackHomeViewed(props = {}) {
+	track(TELEMETRY_EVENTS.homeViewed, {
+		group_key: props.group_key ?? "home",
+		leaf_key: props.leaf_key ?? "home"
+	});
+}
+function trackHomeCtaClicked(props) {
+	track(TELEMETRY_EVENTS.homeCtaClicked, {
+		action_kind: props.action_kind,
+		group_key: props.group_key ?? "home",
+		leaf_key: props.leaf_key ?? "home"
+	});
+}
 function metadataCoarseProperties(props) {
 	const navigation = props.group_key === void 0 || props.leaf_key === void 0 ? {} : {
 		group_key: props.group_key,
@@ -235,13 +247,13 @@ function trackMetadataActionClicked(props) {
 }
 /**
 * Returns the inspector's anonymous distinct-ID for cross-domain
-* propagation onto outbound banner-CTA links, or `null` when the user
+* propagation onto outbound announcement-CTA links, or `null` when the user
 * is opted out.
 *
 * The website / Ops API reads this query param on signup-flow landing
 * pages and calls `posthog.alias(...)` to merge the inspector's anon
 * ID with the website's anon ID, enabling the
-* `banner_viewed → banner_clicked → signup_attributed` funnel.
+* `whats_new_viewed → whats_new_clicked → signup_attributed` funnel.
 * `identify()` itself is out of scope here (it happens on signup, in
 * the website / Ops API).
 *
@@ -254,7 +266,7 @@ function getTelemetryDistinctIdForUrl() {
 }
 /**
 * Seeds the anonymous distinct-ID into localStorage on inspector mount
-* so it is ready for cross-domain propagation onto banner-CTA links
+* so it is ready for cross-domain propagation onto announcement-CTA links
 * even before the first event fires. No-op when the user has opted out.
 */
 function ensureTelemetryDistinctId() {
@@ -302,9 +314,8 @@ exports.ensureTelemetryDistinctId = ensureTelemetryDistinctId;
 exports.getRuntimeUrlType = getRuntimeUrlType;
 exports.getTelemetryDistinctIdForUrl = getTelemetryDistinctIdForUrl;
 exports.maybeShowDisclosure = maybeShowDisclosure;
-exports.trackBannerClicked = trackBannerClicked;
-exports.trackBannerDismissed = trackBannerDismissed;
-exports.trackBannerViewed = trackBannerViewed;
+exports.trackHomeCtaClicked = trackHomeCtaClicked;
+exports.trackHomeViewed = trackHomeViewed;
 exports.trackInspectorOpened = trackInspectorOpened;
 exports.trackMemoriesTabClicked = trackMemoriesTabClicked;
 exports.trackMetadataActionClicked = trackMetadataActionClicked;
@@ -323,4 +334,7 @@ exports.trackThreadsIntelligenceSignupClicked = trackThreadsIntelligenceSignupCl
 exports.trackThreadsLockedViewed = trackThreadsLockedViewed;
 exports.trackThreadsTabClicked = trackThreadsTabClicked;
 exports.trackThreadsTalkToEngineerClicked = trackThreadsTalkToEngineerClicked;
+exports.trackWhatsNewClicked = trackWhatsNewClicked;
+exports.trackWhatsNewSignalViewed = trackWhatsNewSignalViewed;
+exports.trackWhatsNewViewed = trackWhatsNewViewed;
 //# sourceMappingURL=telemetry.cjs.map