@the-portland-company/shell 0.76.0 → 0.76.1

package/dist/native.d.cts

@@ -113,6 +113,31 @@ type ChromeMe = {
     email?: string | null;
     phone?: string | null;
 };
+/**
+ * A shared read cache scoped to one `<NavChromeProvider>` (one fetcher, one
+ * page boot). Every consumer of a given (path, orgId) pair within the TTL
+ * window awaits the SAME promise instead of firing its own request — this is
+ * what collapsed `/orgs` (2-4x), `/me` (2-3x) and `/notifications` (2-3x) per
+ * page load, 1-3.5s each, down to one call apiece (nav-latency-report.md
+ * Table 2). Keying by orgId means switching the active org is itself the
+ * invalidation: the new org gets a fresh key, never the previous org's cached
+ * value. A failed request is evicted immediately so the next consumer retries
+ * rather than replaying the same rejection for the rest of the TTL.
+ */
+declare function createChromeFetchCache(getFetchJson: () => NavChromeFetcher): {
+    dedupedFetch: (path: string, init: Parameters<NavChromeFetcher>[1] | undefined, opts?: {
+        orgId?: string | null;
+        ttlMs?: number;
+    }) => Promise<unknown>;
+    invalidate: (path: string) => void;
+};
+type NavChromeContextValue = {
+    fetchJson: NavChromeFetcher;
+    dedupedFetch: ReturnType<typeof createChromeFetchCache>['dedupedFetch'];
+    invalidateChromeCache: ReturnType<typeof createChromeFetchCache>['invalidate'];
+    me: ChromeMe | null;
+    meLoaded: boolean;
+};
 declare function NavChromeProvider({ fetchJson, children, }: {
     fetchJson: NavChromeFetcher;
     children: ReactNode;
@@ -122,6 +147,8 @@ declare function useChromeMe(): {
     me: ChromeMe | null;
     loaded: boolean;
 };
+/** The provider's de-duped chrome read (null outside <NavChromeProvider>). */
+declare function useNavChromeDedupedFetch(): NavChromeContextValue['dedupedFetch'] | null;
 /** The injected chrome fetcher (null outside <NavChromeProvider>). */
 declare function useNavChromeFetcher(): NavChromeFetcher | null;
 type FuelChannelStatus = {
@@ -899,4 +926,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { BETA_BANNER_DISMISS_KEY, CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FormColumn, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, SPECS_ORIGIN, SpecOverlayAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, clearBetaBannerDismissal, envChipClasses, isNavItemActive, modeIdFromLabel, resolveOrgLogoUrl, shortEnvLabel, shortUserName, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference };
+export { BETA_BANNER_DISMISS_KEY, CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FormColumn, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, SPECS_ORIGIN, SpecOverlayAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, clearBetaBannerDismissal, envChipClasses, isNavItemActive, modeIdFromLabel, resolveOrgLogoUrl, shortEnvLabel, shortUserName, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeDedupedFetch, useNavChromeFetcher, useThemePreference };

package/dist/native.d.ts

@@ -113,6 +113,31 @@ type ChromeMe = {
     email?: string | null;
     phone?: string | null;
 };
+/**
+ * A shared read cache scoped to one `<NavChromeProvider>` (one fetcher, one
+ * page boot). Every consumer of a given (path, orgId) pair within the TTL
+ * window awaits the SAME promise instead of firing its own request — this is
+ * what collapsed `/orgs` (2-4x), `/me` (2-3x) and `/notifications` (2-3x) per
+ * page load, 1-3.5s each, down to one call apiece (nav-latency-report.md
+ * Table 2). Keying by orgId means switching the active org is itself the
+ * invalidation: the new org gets a fresh key, never the previous org's cached
+ * value. A failed request is evicted immediately so the next consumer retries
+ * rather than replaying the same rejection for the rest of the TTL.
+ */
+declare function createChromeFetchCache(getFetchJson: () => NavChromeFetcher): {
+    dedupedFetch: (path: string, init: Parameters<NavChromeFetcher>[1] | undefined, opts?: {
+        orgId?: string | null;
+        ttlMs?: number;
+    }) => Promise<unknown>;
+    invalidate: (path: string) => void;
+};
+type NavChromeContextValue = {
+    fetchJson: NavChromeFetcher;
+    dedupedFetch: ReturnType<typeof createChromeFetchCache>['dedupedFetch'];
+    invalidateChromeCache: ReturnType<typeof createChromeFetchCache>['invalidate'];
+    me: ChromeMe | null;
+    meLoaded: boolean;
+};
 declare function NavChromeProvider({ fetchJson, children, }: {
     fetchJson: NavChromeFetcher;
     children: ReactNode;
@@ -122,6 +147,8 @@ declare function useChromeMe(): {
     me: ChromeMe | null;
     loaded: boolean;
 };
+/** The provider's de-duped chrome read (null outside <NavChromeProvider>). */
+declare function useNavChromeDedupedFetch(): NavChromeContextValue['dedupedFetch'] | null;
 /** The injected chrome fetcher (null outside <NavChromeProvider>). */
 declare function useNavChromeFetcher(): NavChromeFetcher | null;
 type FuelChannelStatus = {
@@ -899,4 +926,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { BETA_BANNER_DISMISS_KEY, CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FormColumn, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, SPECS_ORIGIN, SpecOverlayAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, clearBetaBannerDismissal, envChipClasses, isNavItemActive, modeIdFromLabel, resolveOrgLogoUrl, shortEnvLabel, shortUserName, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference };
+export { BETA_BANNER_DISMISS_KEY, CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FormColumn, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, SPECS_ORIGIN, SpecOverlayAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, clearBetaBannerDismissal, envChipClasses, isNavItemActive, modeIdFromLabel, resolveOrgLogoUrl, shortEnvLabel, shortUserName, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeDedupedFetch, useNavChromeFetcher, useThemePreference };

package/dist/native.js

@@ -1,5 +1,5 @@
 "use client";
-export { BETA_BANNER_DISMISS_KEY, CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, FuelAction, NavAppShell, NavBetaBanner, NavChromeProvider, NavDisplayAction, NavSidebar, NavTabStrip, NavThemeControl, NavTopBar, NotificationsAction, SPECS_ORIGIN, SpecOverlayAction, SupportAction, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, clearBetaBannerDismissal, envChipClasses, isNavItemActive, modeIdFromLabel, resolveOrgLogoUrl, shortEnvLabel, shortUserName, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference } from './chunk-WHF6YW27.js';
+export { BETA_BANNER_DISMISS_KEY, CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, FuelAction, NavAppShell, NavBetaBanner, NavChromeProvider, NavDisplayAction, NavSidebar, NavTabStrip, NavThemeControl, NavTopBar, NotificationsAction, SPECS_ORIGIN, SpecOverlayAction, SupportAction, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, clearBetaBannerDismissal, envChipClasses, isNavItemActive, modeIdFromLabel, resolveOrgLogoUrl, shortEnvLabel, shortUserName, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeDedupedFetch, useNavChromeFetcher, useThemePreference } from './chunk-6KX3DWBC.js';
 export { FormColumn } from './chunk-MY6G3LMN.js';
 import './chunk-BHRVZPZ7.js';
 import './chunk-7YVJ7HQG.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-portland-company/shell",
-  "version": "0.76.0",
+  "version": "0.76.1",
   "description": "Shared chrome (header, sidebar, footer, theme, auth) for politogy apps. Drop into any Vite SPA to inherit the politogy look and signed-in user.",
   "license": "UNLICENSED",
   "private": false,