@burdenoff/fe-libs 2026.813.1 → 2026.813.3

package/dist/shared-events.js

@@ -2,13 +2,13 @@ import { createBrowserTraceContext as e } from "./shared/events/metadata.js";
 import { DevtoolsSink as t } from "./shared/events/sinks/DevtoolsSink.js";
 import { BroadcastChannelSink as n } from "./shared/events/sinks/BroadcastChannelSink.js";
 import { BackendAuditSink as r } from "./shared/events/sinks/BackendAuditSink.js";
-import { RybbitSink as i } from "./shared/events/sinks/RybbitSink.js";
-import { OtelBrowserSink as a } from "./shared/events/sinks/OtelBrowserSink.js";
+import { AnalyticsConsentBanner as i, RybbitSink as a, readAnalyticsConsent as o, setAnalyticsConsent as s } from "./shared/events/sinks/RybbitSink.js";
+import { OtelBrowserSink as c } from "./shared/events/sinks/OtelBrowserSink.js";
 import "./shared/events/sinks/index.js";
-import { createContext as o, use as s, useCallback as c, useEffect as l, useMemo as u } from "react";
-import { jsx as d } from "react/jsx-runtime";
+import { createContext as l, use as u, useCallback as d, useEffect as f, useMemo as p } from "react";
+import { jsx as m } from "react/jsx-runtime";
 //#region src/shared/events/index.tsx
-var f = o({
+var h = l({
 	emit: () => {},
 	emitCustom: () => {},
 	on: () => () => {},
@@ -16,22 +16,22 @@ var f = o({
 	getBuffer: () => [],
 	onAny: () => () => {}
 });
-function p(e, t) {
-	if (!e) return m();
+function g(e, t) {
+	if (!e) return _();
 	let n = e.getItem(t);
 	if (n) return n;
-	let r = m();
+	let r = _();
 	return e.setItem(t, r), r;
 }
-function m() {
+function _() {
 	return typeof crypto < "u" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
-function h() {
+function v() {
 	if (typeof document > "u") return "light";
 	let e = document.documentElement;
 	return e.classList.contains("hc") || e.dataset.theme === "hc" ? "hc" : e.classList.contains("dark") || e.dataset.theme === "dark" ? "dark" : "light";
 }
-function g(t, n, r) {
+function y(t, n, r) {
 	let i = typeof window < "u" ? window.location : void 0, a = e(), o = typeof navigator < "u" ? navigator : {
 		userAgent: "",
 		language: "en"
@@ -41,11 +41,11 @@ function g(t, n, r) {
 			pathname: i?.pathname ?? "",
 			search: i?.search ?? ""
 		},
-		sessionId: p(typeof sessionStorage < "u" ? sessionStorage : void 0, "bf-event-session-id"),
-		deviceId: p(typeof localStorage < "u" ? localStorage : void 0, "bf-event-device-id"),
+		sessionId: g(typeof sessionStorage < "u" ? sessionStorage : void 0, "bf-event-session-id"),
+		deviceId: g(typeof localStorage < "u" ? localStorage : void 0, "bf-event-device-id"),
 		userAgent: o.userAgent,
 		locale: o.language || "en",
-		theme: h(),
+		theme: v(),
 		app: {
 			name: t,
 			version: n,
@@ -55,8 +55,8 @@ function g(t, n, r) {
 		spanId: a.spanId
 	};
 }
-function _({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe: r = e, children: i }) {
-	let a = u(() => v({
+function b({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe: r = e, children: i }) {
+	let a = p(() => x({
 		appName: e,
 		appVersion: t,
 		appEnv: n,
@@ -67,16 +67,16 @@ function _({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe:
 		t,
 		r
 	]);
-	return /* @__PURE__ */ d(f.Provider, {
+	return /* @__PURE__ */ m(h.Provider, {
 		value: a,
 		children: i
 	});
 }
-function v({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe: r = e }) {
+function x({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe: r = e }) {
 	let i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set(), o = [];
 	function s(i, a, o) {
 		return {
-			id: m(),
+			id: _(),
 			name: i,
 			version: 1,
 			source: {
@@ -86,7 +86,7 @@ function v({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe:
 			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
 			monotonic: performance.now(),
 			payload: a,
-			metadata: g(e, t, n)
+			metadata: y(e, t, n)
 		};
 	}
 	function c(e) {
@@ -121,24 +121,24 @@ function v({ appName: e, appVersion: t = "0.0.0", appEnv: n = "dev", sourceMfe:
 		}
 	};
 }
-function y() {
-	return s(f);
+function S() {
+	return u(h);
 }
-function b(e, t) {
-	let n = y();
-	l(() => n.on(e, t), [
+function C(e, t) {
+	let n = S();
+	f(() => n.on(e, t), [
 		n,
 		t,
 		e
 	]);
 }
-function x(e, t) {
-	let n = y();
-	return c((r) => n.emit(e, r, t), [
+function w(e, t) {
+	let n = S();
+	return d((r) => n.emit(e, r, t), [
 		n,
 		e,
 		t
 	]);
 }
 //#endregion
-export { r as BackendAuditSink, n as BroadcastChannelSink, t as DevtoolsSink, _ as EventBusProvider, a as OtelBrowserSink, i as RybbitSink, v as createEventBus, b as useEvent, y as useEventBus, x as useEventEmitter };
+export { i as AnalyticsConsentBanner, r as BackendAuditSink, n as BroadcastChannelSink, t as DevtoolsSink, b as EventBusProvider, c as OtelBrowserSink, a as RybbitSink, x as createEventBus, o as readAnalyticsConsent, s as setAnalyticsConsent, C as useEvent, S as useEventBus, w as useEventEmitter };

package/dist/shared.js

@@ -62,63 +62,63 @@ import "./shared-components.js";
 import { DevtoolsSink as Vn } from "./shared/events/sinks/DevtoolsSink.js";
 import { BroadcastChannelSink as Hn } from "./shared/events/sinks/BroadcastChannelSink.js";
 import { BackendAuditSink as Un } from "./shared/events/sinks/BackendAuditSink.js";
-import { RybbitSink as Wn } from "./shared/events/sinks/RybbitSink.js";
-import { OtelBrowserSink as Gn } from "./shared/events/sinks/OtelBrowserSink.js";
-import { EventBusProvider as Kn, createEventBus as qn, useEvent as Jn, useEventBus as Yn, useEventEmitter as Xn } from "./shared-events.js";
-import { useDebounce as Zn } from "./shared/hooks/useDebounce.js";
-import { useThrottle as Qn } from "./shared/hooks/useThrottle.js";
-import { BREAKPOINTS as $n, useBreakpoint as er, useMobileBreakpoint as tr } from "./shared/hooks/useBreakpoint.js";
-import { useOnClickOutside as nr, useOnClickOutsideWithRef as rr } from "./shared/hooks/useOnClickOutside.js";
-import { useKeyPress as ir, useKeyboardShortcut as ar } from "./shared/hooks/useKeyPress.js";
-import { useExclusiveMenu as or } from "./shared/hooks/useExclusiveMenu.js";
-import { useLocalStorage as sr } from "./shared/hooks/useLocalStorage.js";
-import { useSessionStorage as cr } from "./shared/hooks/useSessionStorage.js";
-import { usePrevious as lr, usePreviousDistinct as ur, usePreviousHistory as dr } from "./shared/hooks/usePrevious.js";
-import { useConditionalToggle as fr, useToggle as pr, useToggleObject as mr } from "./shared/hooks/useToggle.js";
-import { usePagination as hr } from "./shared/hooks/usePagination.js";
-import { useAsync as gr, useAsyncImmediate as _r } from "./shared/hooks/useAsync.js";
-import { MODIFIER_KEYS as vr, PLATFORM_TYPES as yr } from "./shared/keyboard/types.js";
-import { useKeyboardShortcuts as br } from "./shared/keyboard/useKeyboardShortcuts.js";
-import { useHotkeys as xr } from "./shared/keyboard/useHotkeys.js";
-import { useShortcutHelp as Sr } from "./shared/keyboard/useShortcutHelp.js";
-import { GLOBAL_SHORTCUT_CATEGORIES as Cr, createGlobalShortcuts as wr, getGlobalShortcutsByCategory as Tr, mergeShortcuts as Er } from "./shared/keyboard/globalShortcuts.js";
-import { useLogger as Dr } from "./shared/logger/useLogger.js";
-import { useHasAnimated as Or } from "./shared/hooks/useHasAnimated.js";
-import { useReferralAttribution as kr } from "./shared/hooks/useReferralAttribution.js";
-import { useRecordProductVisit as Ar } from "./shared/hooks/useRecordProductVisit.js";
-import { QUOTA_EXHAUSTED_EVENT as jr, dispatchQuotaExhausted as Mr, useQuotaErrorToast as Nr } from "./shared/hooks/useQuotaErrorToast.js";
-import { PLAN_USAGE_SNAPSHOT_EVENT as Pr, publishPlanUsageSnapshot as Fr, useUpgradePrompt as Ir } from "./shared/hooks/useUpgradePrompt.js";
-import { appendContextToPath as Lr, useCurrentContextSearchParams as Rr } from "./shared/hooks/useCurrentContextSearchParams.js";
-import { MicrofrontendContext as zr, useMicrofrontendContext as Br } from "./shared-hooks.js";
-import { detectDeviceType as Vr, getResponsiveSelector as Hr } from "./shared/tours/types.js";
-import { useTourPlayer as Ur } from "./shared/tours/useTourPlayer.js";
-import { TourSpotlight as Wr } from "./shared/tours/TourSpotlight.js";
-import { TourTooltip as Gr } from "./shared/tours/TourTooltip.js";
-import { TourPlayerProvider as Kr, useIsTourPlaying as qr, useStartTour as Jr, useStopTour as Yr, useTourPlayerContext as Xr } from "./shared/tours/TourPlayerProvider.js";
-import { TourPlayer as Zr, TourTriggerButton as Qr, usePlayTour as $r } from "./shared/tours/TourPlayer.js";
-import { getTourContextRank as ei, getTourRouteCatalog as ti, getTourRouteModules as ni, getTourRoutePages as ri, isTourVisibleForContext as ii, normalizeTourPath as ai, registerTourRouteCatalog as oi, resolveTourTargetPath as si } from "./shared/tours/routeCatalog.js";
-import { withTourProgressStatus as ci } from "./shared/tours/progress.js";
-import { ToursProvider as li, useAutoStartTour as ui, useSafeToursContext as di, useTours as fi, useToursContext as pi } from "./shared/tours/ToursContext.js";
-import { TourInitializer as mi } from "./shared/tours/TourInitializer.js";
-import { AppShellProvider as hi, resolveAppShellObservabilityConfig as gi } from "./shared/providers/AppShellProvider.js";
-import { MicrofrontendProvider as _i } from "./shared-providers.js";
-import { TourTrigger as vi } from "./shared/tours/TourTrigger.js";
+import { AnalyticsConsentBanner as Wn, RybbitSink as Gn, readAnalyticsConsent as Kn, setAnalyticsConsent as qn } from "./shared/events/sinks/RybbitSink.js";
+import { OtelBrowserSink as Jn } from "./shared/events/sinks/OtelBrowserSink.js";
+import { EventBusProvider as Yn, createEventBus as Xn, useEvent as Zn, useEventBus as Qn, useEventEmitter as $n } from "./shared-events.js";
+import { useDebounce as er } from "./shared/hooks/useDebounce.js";
+import { useThrottle as tr } from "./shared/hooks/useThrottle.js";
+import { BREAKPOINTS as nr, useBreakpoint as rr, useMobileBreakpoint as ir } from "./shared/hooks/useBreakpoint.js";
+import { useOnClickOutside as ar, useOnClickOutsideWithRef as or } from "./shared/hooks/useOnClickOutside.js";
+import { useKeyPress as sr, useKeyboardShortcut as cr } from "./shared/hooks/useKeyPress.js";
+import { useExclusiveMenu as lr } from "./shared/hooks/useExclusiveMenu.js";
+import { useLocalStorage as ur } from "./shared/hooks/useLocalStorage.js";
+import { useSessionStorage as dr } from "./shared/hooks/useSessionStorage.js";
+import { usePrevious as fr, usePreviousDistinct as pr, usePreviousHistory as mr } from "./shared/hooks/usePrevious.js";
+import { useConditionalToggle as hr, useToggle as gr, useToggleObject as _r } from "./shared/hooks/useToggle.js";
+import { usePagination as vr } from "./shared/hooks/usePagination.js";
+import { useAsync as yr, useAsyncImmediate as br } from "./shared/hooks/useAsync.js";
+import { MODIFIER_KEYS as xr, PLATFORM_TYPES as Sr } from "./shared/keyboard/types.js";
+import { useKeyboardShortcuts as Cr } from "./shared/keyboard/useKeyboardShortcuts.js";
+import { useHotkeys as wr } from "./shared/keyboard/useHotkeys.js";
+import { useShortcutHelp as Tr } from "./shared/keyboard/useShortcutHelp.js";
+import { GLOBAL_SHORTCUT_CATEGORIES as Er, createGlobalShortcuts as Dr, getGlobalShortcutsByCategory as Or, mergeShortcuts as kr } from "./shared/keyboard/globalShortcuts.js";
+import { useLogger as Ar } from "./shared/logger/useLogger.js";
+import { useHasAnimated as jr } from "./shared/hooks/useHasAnimated.js";
+import { useReferralAttribution as Mr } from "./shared/hooks/useReferralAttribution.js";
+import { useRecordProductVisit as Nr } from "./shared/hooks/useRecordProductVisit.js";
+import { QUOTA_EXHAUSTED_EVENT as Pr, dispatchQuotaExhausted as Fr, useQuotaErrorToast as Ir } from "./shared/hooks/useQuotaErrorToast.js";
+import { PLAN_USAGE_SNAPSHOT_EVENT as Lr, publishPlanUsageSnapshot as Rr, useUpgradePrompt as zr } from "./shared/hooks/useUpgradePrompt.js";
+import { appendContextToPath as Br, useCurrentContextSearchParams as Vr } from "./shared/hooks/useCurrentContextSearchParams.js";
+import { MicrofrontendContext as Hr, useMicrofrontendContext as Ur } from "./shared-hooks.js";
+import { detectDeviceType as Wr, getResponsiveSelector as Gr } from "./shared/tours/types.js";
+import { useTourPlayer as Kr } from "./shared/tours/useTourPlayer.js";
+import { TourSpotlight as qr } from "./shared/tours/TourSpotlight.js";
+import { TourTooltip as Jr } from "./shared/tours/TourTooltip.js";
+import { TourPlayerProvider as Yr, useIsTourPlaying as Xr, useStartTour as Zr, useStopTour as Qr, useTourPlayerContext as $r } from "./shared/tours/TourPlayerProvider.js";
+import { TourPlayer as ei, TourTriggerButton as ti, usePlayTour as ni } from "./shared/tours/TourPlayer.js";
+import { getTourContextRank as ri, getTourRouteCatalog as ii, getTourRouteModules as ai, getTourRoutePages as oi, isTourVisibleForContext as si, normalizeTourPath as ci, registerTourRouteCatalog as li, resolveTourTargetPath as ui } from "./shared/tours/routeCatalog.js";
+import { withTourProgressStatus as di } from "./shared/tours/progress.js";
+import { ToursProvider as fi, useAutoStartTour as pi, useSafeToursContext as mi, useTours as hi, useToursContext as gi } from "./shared/tours/ToursContext.js";
+import { TourInitializer as _i } from "./shared/tours/TourInitializer.js";
+import { AppShellProvider as vi, resolveAppShellObservabilityConfig as yi } from "./shared/providers/AppShellProvider.js";
+import { MicrofrontendProvider as bi } from "./shared-providers.js";
+import { TourTrigger as xi } from "./shared/tours/TourTrigger.js";
 import "./shared-tours.js";
-import { getNativeBridge as yi } from "./shared/native/bridge.js";
-import { getPlatform as bi, isAndroid as xi, isElectron as Si, isIOS as Ci, isInstalledApp as wi, isNative as Ti, isStandalonePWA as Ei, isWeb as Di, isWebBrowser as Oi } from "./shared/native/platform.js";
-import { nativeConfirm as ki, nativeCopyText as Ai, nativeImpact as ji, nativeNotify as Mi, nativeOpenUrl as Ni, nativeShare as Pi, nativeToast as Fi } from "./shared/native/consumers.js";
-import { SafeAreaView as Ii } from "./shared/native/SafeAreaView.js";
-import { useNativePlatform as Li } from "./shared/native/hooks/useNativePlatform.js";
-import { useSafeArea as Ri } from "./shared/native/hooks/useSafeArea.js";
-import { useNativeKeyboard as zi } from "./shared/native/hooks/useNativeKeyboard.js";
-import { useAppState as Bi } from "./shared/native/hooks/useAppState.js";
-import { useDeviceInfo as Vi } from "./shared/native/hooks/useDeviceInfo.js";
-import { useHaptics as Hi } from "./shared/native/hooks/useHaptics.js";
-import { useStatusBar as Ui } from "./shared/native/hooks/useStatusBar.js";
-import { acknowledgeNativePurchase as Wi, getNativeProducts as Gi, getNativePurchases as Ki, installNativeIAP as qi, isNativeIAPAvailable as Ji, purchaseNativeProduct as Yi, restoreNativePurchases as Xi } from "./shared/native/purchases.js";
+import { getNativeBridge as Si } from "./shared/native/bridge.js";
+import { getPlatform as Ci, isAndroid as wi, isElectron as Ti, isIOS as Ei, isInstalledApp as Di, isNative as Oi, isStandalonePWA as ki, isWeb as Ai, isWebBrowser as ji } from "./shared/native/platform.js";
+import { nativeConfirm as Mi, nativeCopyText as Ni, nativeImpact as Pi, nativeNotify as Fi, nativeOpenUrl as Ii, nativeShare as Li, nativeToast as Ri } from "./shared/native/consumers.js";
+import { SafeAreaView as zi } from "./shared/native/SafeAreaView.js";
+import { useNativePlatform as Bi } from "./shared/native/hooks/useNativePlatform.js";
+import { useSafeArea as Vi } from "./shared/native/hooks/useSafeArea.js";
+import { useNativeKeyboard as Hi } from "./shared/native/hooks/useNativeKeyboard.js";
+import { useAppState as Ui } from "./shared/native/hooks/useAppState.js";
+import { useDeviceInfo as Wi } from "./shared/native/hooks/useDeviceInfo.js";
+import { useHaptics as Gi } from "./shared/native/hooks/useHaptics.js";
+import { useStatusBar as Ki } from "./shared/native/hooks/useStatusBar.js";
+import { acknowledgeNativePurchase as qi, getNativeProducts as Ji, getNativePurchases as Yi, installNativeIAP as Xi, isNativeIAPAvailable as Zi, purchaseNativeProduct as Qi, restoreNativePurchases as $i } from "./shared/native/purchases.js";
 import "./shared-native.js";
 import "./shared/actors/index.js";
 //#region src/shared/index.ts
-var Zi = "1.0.0";
+var ea = "1.0.0";
 //#endregion
-export { Rn as ASSISTANT_WIDGET_TOGGLE_EVENT, $t as AccessDenied, Wt as ActorIdentity, Fe as ApolloClient, Ie as ApolloProvider, un as AppErrorBoundary, xt as AppInitializer, hi as AppShellProvider, zn as AssistantWidget, ie as BACKEND_ERROR_EVENT, $n as BREAKPOINTS, Un as BackendAuditSink, Hn as BroadcastChannelSink, G as COMMON_SHELL_LESS_ROUTES, ae as CONNECTION_STATUS_EVENT, sn as ConditionalShell, Ot as ConsoleTransport, _n as ContextConversationWidget, Z as DEFAULT_PAGE_SIZE, K as DEFAULT_SHELL_CONFIG, Vn as DevtoolsSink, qt as ErrorBoundary, tn as ErrorFallback, Kn as EventBusProvider, Zi as FE_SHARED_VERSION, dn as FeatureFlagProvider, gn as FeatureGate, Q as GATEWAYS, Cr as GLOBAL_SHORTCUT_CATEGORIES, Oe as GatewayProvider, Le as InMemoryCache, jn as KeyboardHelpDialogWrapper, nn as LoadingFallback, wt as LogLevel, Et as LogManager, Tt as Logger, vr as MODIFIER_KEYS, Bn as Markdown, zr as MicrofrontendContext, on as MicrofrontendErrorBoundary, _i as MicrofrontendProvider, Gn as OtelBrowserSink, Pr as PLAN_USAGE_SNAPSHOT_EVENT, yr as PLATFORM_TYPES, V as PRODUCTS, H as PRODUCT_URLS, ln as PWAInstallBanner, rn as PageLoadingFallback, Xt as PermissionButton, en as PermissionDenied, Zt as PermissionGate, Qt as PermissionLink, Pt as QUOTA_EXHAUSTED_CODE, jr as QUOTA_EXHAUSTED_EVENT, Mn as QuotaMeter, Ft as RESOURCE_CAP_EXCEEDED_CODE, Jt as RequireAuth, Yt as RequireGuest, Wn as RybbitSink, Se as SSELink, it as SSORedirectSpinner, lt as SSO_DEPOSITED_PARAM, It as STORAGE_QUOTA_EXCEEDED_CODE, Ii as SafeAreaView, an as SectionLoadingFallback, mi as TourInitializer, Zr as TourPlayer, Kr as TourPlayerProvider, Wr as TourSpotlight, Gr as TourTooltip, vi as TourTrigger, Qr as TourTriggerButton, li as ToursProvider, Lt as UPGRADE_ERROR_CODES, Nn as UPGRADE_PROMPT_EVENT, In as UpgradeInlineBanner, Pn as UpgradePromptModal, Pe as WsLink, Wi as acknowledgeNativePurchase, r as alertTokens, Lr as appendContextToPath, We as attemptTokenRefresh, ut as beginSsoNavigation, Gt as buildActorFallback, Rt as buildQuotaExhaustedMessage, dt as buildSsoDepositUrl, m as capitalizeFirst, h as capitalizeWords, i as categoryTokens, at as checkRemoteSLO, ot as checkSLO, Ge as clearAuthSessionStorage, pe as clearGraphqlFetchResponseCache, st as clearLocalAuthState, Xe as clearSSoCookie, Ze as clearShellSsoCookies, ft as clearSsoDepositState, pt as clearSsoNavigation, kt as clearUserContext, Ut as cn, mt as consumeSsoDepositMarker, n as createApolloClient, qn as createEventBus, wr as createGlobalShortcuts, Ce as createGraphQLClient, Mt as createProfileScopedStorage, Vr as detectDeviceType, vn as detectPlatform, oe as dispatchBackendErrorEvent, Mr as dispatchQuotaExhausted, Fn as dispatchUpgradePrompt, se as extractBackendError, zt as extractQuotaExhaustedExtensions, Bt as extractUpgradeErrorExtensions, g as formatBytes, _ as formatCompactNumber, v as formatCurrency, y as formatCurrencyCompact, b as formatDate, x as formatDateTime, S as formatDuration, yn as formatKeyCombo, C as formatList, w as formatNumber, T as formatOrdinal, E as formatPercentage, D as formatRelativeTime, O as formatTime, a as getAlertTokens, o as getCategoryTokens, bn as getDisplayKeysForPlatform, $ as getGatewayConfig, ee as getGatewayUrl, we as getGlobalClient, Tr as getGlobalShortcutsByCategory, te as getGraphQLEndpoint, yi as getNativeBridge, Gi as getNativeProducts, Ki as getNativePurchases, bi as getPlatform, U as getProductUrl, W as getProductsWithUrls, Nt as getProfileScopedKey, s as getProgressTokens, Hr as getResponsiveSelector, ct as getSSORedirectUrl, Qe as getSSoCookie, q as getShellConfig, xn as getShortcutLabel, c as getStatusBadgeTokens, l as getStatusTokens, me as getStoredAuthToken, he as getStoredLocale, ge as getStoredOrganizationId, _e as getStoredProjectId, ve as getStoredWorkspaceId, ye as getStoredWorkspaceToken, ei as getTourContextRank, ti as getTourRouteCatalog, ni as getTourRouteModules, ri as getTourRoutePages, u as getTrendTokens, Te as getWorkspaceClient, ne as getWorkspaceTokenPayload, Re as gql, be as graphqlFetch, Ke as hasAuthGraphQLErrors, Ee as initializeAppClients, At as initializeLogger, L as installGatewayFetchRewrite, qi as installNativeIAP, ce as isAbortError, xi as isAndroid, qe as isAuthGraphQLError, Je as isAuthNetworkError, le as isBackendErrorDisplay, P as isChunkLoadError, Si as isElectron, Ci as isIOS, wi as isInstalledApp, Sn as isMac, Cn as isMobileDevice, Ti as isNative, Ji as isNativeIAPAvailable, Vt as isQuotaExhaustedError, $e as isSharedSsoCookieDomain, J as isShellLessRoute, ht as isSsoNavigationPending, Ei as isStandalonePWA, wn as isTabletDevice, ii as isTourVisibleForContext, ue as isTransportError, et as isTrustedSsoOrigin, Ht as isUpgradeError, Di as isWeb, Oi as isWebBrowser, re as isWorkspaceTokenValidForContext, F as lazyWithRetry, Dt as logManager, de as markConnectionHealthy, gt as markSsoDepositDone, _t as markSsoDepositPending, Tn as matchesKeyCombo, Er as mergeShortcuts, vt as mintSsoSessionTokens, ki as nativeConfirm, Ai as nativeCopyText, ji as nativeImpact, Mi as nativeNotify, Ni as nativeOpenUrl, Pi as nativeShare, Fi as nativeToast, En as normalizeKey, Dn as normalizePlatformCombo, ai as normalizeTourPath, On as parseKeyCombo, k as pluralize, d as progressTokens, Fr as publishPlanUsageSnapshot, Yi as purchaseNativeProduct, tt as readShellSsoCookie, yt as readSsoDepositState, Ye as redirectToLogin, oi as registerTourRouteCatalog, De as resetAppClients, gi as resolveAppShellObservabilityConfig, B as resolveAuthBridgeConfig, R as resolveGatewayBases, xe as resolveGatewayUrl, I as resolveGatewayUrls, si as resolveTourTargetPath, Xi as restoreNativePurchases, nt as setSSoCookie, rt as setShellSsoCookies, jt as setUserContext, bt as shouldAttemptSsoDeposit, kn as shouldEnableKeyboardShortcuts, An as shouldIgnoreShortcut, Y as shouldShowBreadcrumb, X as shouldShowSidebar, fe as shouldToastBackendError, A as slugify, f as statusTokens, z as suppressConsole, j as toCamelCase, M as toPascalCase, p as trendTokens, N as truncateText, Kt as useActorProfiles, ze as useApolloClient, Bi as useAppState, gr as useAsync, _r as useAsyncImmediate, ui as useAutoStartTour, er as useBreakpoint, fr as useConditionalToggle, e as useCopyToClipboard, Rr as useCurrentContextSearchParams, Zn as useDebounce, Vi as useDeviceInfo, Jn as useEvent, Yn as useEventBus, Xn as useEventEmitter, or as useExclusiveMenu, pn as useFeatureFlag, mn as useFeatureFlagDetails, hn as useFeatureFlagValue, fn as useFeatureFlags, ke as useGateway, Ae as useGatewayClient, Hi as useHaptics, Or as useHasAnimated, Ne as useHasAuthToken, xr as useHotkeys, qr as useIsTourPlaying, ir as useKeyPress, ar as useKeyboardShortcut, br as useKeyboardShortcuts, Be as useLazyQuery, sr as useLocalStorage, Dr as useLogger, t as useMediaQuery, Br as useMicrofrontendContext, tr as useMobileBreakpoint, Ve as useMutation, zi as useNativeKeyboard, Li as useNativePlatform, nr as useOnClickOutside, rr as useOnClickOutsideWithRef, cn as usePWA, hr as usePagination, $r as usePlayTour, lr as usePrevious, ur as usePreviousDistinct, dr as usePreviousHistory, He as useQuery, Nr as useQuotaErrorToast, Ar as useRecordProductVisit, kr as useReferralAttribution, St as useRegistryHelpers, Ri as useSafeArea, je as useSafeGateway, Me as useSafeGatewayClient, di as useSafeToursContext, cr as useSessionStorage, Ct as useShellNavigate, Sr as useShortcutHelp, Jr as useStartTour, Ui as useStatusBar, Yr as useStopTour, Ue as useSubscription, Qn as useThrottle, pr as useToggle, mr as useToggleObject, Ur as useTourPlayer, Xr as useTourPlayerContext, fi as useTours, pi as useToursContext, Ir as useUpgradePrompt, Ln as useVoiceInput, ci as withTourProgressStatus };
+export { Rn as ASSISTANT_WIDGET_TOGGLE_EVENT, $t as AccessDenied, Wt as ActorIdentity, Wn as AnalyticsConsentBanner, Fe as ApolloClient, Ie as ApolloProvider, un as AppErrorBoundary, xt as AppInitializer, vi as AppShellProvider, zn as AssistantWidget, ie as BACKEND_ERROR_EVENT, nr as BREAKPOINTS, Un as BackendAuditSink, Hn as BroadcastChannelSink, G as COMMON_SHELL_LESS_ROUTES, ae as CONNECTION_STATUS_EVENT, sn as ConditionalShell, Ot as ConsoleTransport, _n as ContextConversationWidget, Z as DEFAULT_PAGE_SIZE, K as DEFAULT_SHELL_CONFIG, Vn as DevtoolsSink, qt as ErrorBoundary, tn as ErrorFallback, Yn as EventBusProvider, ea as FE_SHARED_VERSION, dn as FeatureFlagProvider, gn as FeatureGate, Q as GATEWAYS, Er as GLOBAL_SHORTCUT_CATEGORIES, Oe as GatewayProvider, Le as InMemoryCache, jn as KeyboardHelpDialogWrapper, nn as LoadingFallback, wt as LogLevel, Et as LogManager, Tt as Logger, xr as MODIFIER_KEYS, Bn as Markdown, Hr as MicrofrontendContext, on as MicrofrontendErrorBoundary, bi as MicrofrontendProvider, Jn as OtelBrowserSink, Lr as PLAN_USAGE_SNAPSHOT_EVENT, Sr as PLATFORM_TYPES, V as PRODUCTS, H as PRODUCT_URLS, ln as PWAInstallBanner, rn as PageLoadingFallback, Xt as PermissionButton, en as PermissionDenied, Zt as PermissionGate, Qt as PermissionLink, Pt as QUOTA_EXHAUSTED_CODE, Pr as QUOTA_EXHAUSTED_EVENT, Mn as QuotaMeter, Ft as RESOURCE_CAP_EXCEEDED_CODE, Jt as RequireAuth, Yt as RequireGuest, Gn as RybbitSink, Se as SSELink, it as SSORedirectSpinner, lt as SSO_DEPOSITED_PARAM, It as STORAGE_QUOTA_EXCEEDED_CODE, zi as SafeAreaView, an as SectionLoadingFallback, _i as TourInitializer, ei as TourPlayer, Yr as TourPlayerProvider, qr as TourSpotlight, Jr as TourTooltip, xi as TourTrigger, ti as TourTriggerButton, fi as ToursProvider, Lt as UPGRADE_ERROR_CODES, Nn as UPGRADE_PROMPT_EVENT, In as UpgradeInlineBanner, Pn as UpgradePromptModal, Pe as WsLink, qi as acknowledgeNativePurchase, r as alertTokens, Br as appendContextToPath, We as attemptTokenRefresh, ut as beginSsoNavigation, Gt as buildActorFallback, Rt as buildQuotaExhaustedMessage, dt as buildSsoDepositUrl, m as capitalizeFirst, h as capitalizeWords, i as categoryTokens, at as checkRemoteSLO, ot as checkSLO, Ge as clearAuthSessionStorage, pe as clearGraphqlFetchResponseCache, st as clearLocalAuthState, Xe as clearSSoCookie, Ze as clearShellSsoCookies, ft as clearSsoDepositState, pt as clearSsoNavigation, kt as clearUserContext, Ut as cn, mt as consumeSsoDepositMarker, n as createApolloClient, Xn as createEventBus, Dr as createGlobalShortcuts, Ce as createGraphQLClient, Mt as createProfileScopedStorage, Wr as detectDeviceType, vn as detectPlatform, oe as dispatchBackendErrorEvent, Fr as dispatchQuotaExhausted, Fn as dispatchUpgradePrompt, se as extractBackendError, zt as extractQuotaExhaustedExtensions, Bt as extractUpgradeErrorExtensions, g as formatBytes, _ as formatCompactNumber, v as formatCurrency, y as formatCurrencyCompact, b as formatDate, x as formatDateTime, S as formatDuration, yn as formatKeyCombo, C as formatList, w as formatNumber, T as formatOrdinal, E as formatPercentage, D as formatRelativeTime, O as formatTime, a as getAlertTokens, o as getCategoryTokens, bn as getDisplayKeysForPlatform, $ as getGatewayConfig, ee as getGatewayUrl, we as getGlobalClient, Or as getGlobalShortcutsByCategory, te as getGraphQLEndpoint, Si as getNativeBridge, Ji as getNativeProducts, Yi as getNativePurchases, Ci as getPlatform, U as getProductUrl, W as getProductsWithUrls, Nt as getProfileScopedKey, s as getProgressTokens, Gr as getResponsiveSelector, ct as getSSORedirectUrl, Qe as getSSoCookie, q as getShellConfig, xn as getShortcutLabel, c as getStatusBadgeTokens, l as getStatusTokens, me as getStoredAuthToken, he as getStoredLocale, ge as getStoredOrganizationId, _e as getStoredProjectId, ve as getStoredWorkspaceId, ye as getStoredWorkspaceToken, ri as getTourContextRank, ii as getTourRouteCatalog, ai as getTourRouteModules, oi as getTourRoutePages, u as getTrendTokens, Te as getWorkspaceClient, ne as getWorkspaceTokenPayload, Re as gql, be as graphqlFetch, Ke as hasAuthGraphQLErrors, Ee as initializeAppClients, At as initializeLogger, L as installGatewayFetchRewrite, Xi as installNativeIAP, ce as isAbortError, wi as isAndroid, qe as isAuthGraphQLError, Je as isAuthNetworkError, le as isBackendErrorDisplay, P as isChunkLoadError, Ti as isElectron, Ei as isIOS, Di as isInstalledApp, Sn as isMac, Cn as isMobileDevice, Oi as isNative, Zi as isNativeIAPAvailable, Vt as isQuotaExhaustedError, $e as isSharedSsoCookieDomain, J as isShellLessRoute, ht as isSsoNavigationPending, ki as isStandalonePWA, wn as isTabletDevice, si as isTourVisibleForContext, ue as isTransportError, et as isTrustedSsoOrigin, Ht as isUpgradeError, Ai as isWeb, ji as isWebBrowser, re as isWorkspaceTokenValidForContext, F as lazyWithRetry, Dt as logManager, de as markConnectionHealthy, gt as markSsoDepositDone, _t as markSsoDepositPending, Tn as matchesKeyCombo, kr as mergeShortcuts, vt as mintSsoSessionTokens, Mi as nativeConfirm, Ni as nativeCopyText, Pi as nativeImpact, Fi as nativeNotify, Ii as nativeOpenUrl, Li as nativeShare, Ri as nativeToast, En as normalizeKey, Dn as normalizePlatformCombo, ci as normalizeTourPath, On as parseKeyCombo, k as pluralize, d as progressTokens, Rr as publishPlanUsageSnapshot, Qi as purchaseNativeProduct, Kn as readAnalyticsConsent, tt as readShellSsoCookie, yt as readSsoDepositState, Ye as redirectToLogin, li as registerTourRouteCatalog, De as resetAppClients, yi as resolveAppShellObservabilityConfig, B as resolveAuthBridgeConfig, R as resolveGatewayBases, xe as resolveGatewayUrl, I as resolveGatewayUrls, ui as resolveTourTargetPath, $i as restoreNativePurchases, qn as setAnalyticsConsent, nt as setSSoCookie, rt as setShellSsoCookies, jt as setUserContext, bt as shouldAttemptSsoDeposit, kn as shouldEnableKeyboardShortcuts, An as shouldIgnoreShortcut, Y as shouldShowBreadcrumb, X as shouldShowSidebar, fe as shouldToastBackendError, A as slugify, f as statusTokens, z as suppressConsole, j as toCamelCase, M as toPascalCase, p as trendTokens, N as truncateText, Kt as useActorProfiles, ze as useApolloClient, Ui as useAppState, yr as useAsync, br as useAsyncImmediate, pi as useAutoStartTour, rr as useBreakpoint, hr as useConditionalToggle, e as useCopyToClipboard, Vr as useCurrentContextSearchParams, er as useDebounce, Wi as useDeviceInfo, Zn as useEvent, Qn as useEventBus, $n as useEventEmitter, lr as useExclusiveMenu, pn as useFeatureFlag, mn as useFeatureFlagDetails, hn as useFeatureFlagValue, fn as useFeatureFlags, ke as useGateway, Ae as useGatewayClient, Gi as useHaptics, jr as useHasAnimated, Ne as useHasAuthToken, wr as useHotkeys, Xr as useIsTourPlaying, sr as useKeyPress, cr as useKeyboardShortcut, Cr as useKeyboardShortcuts, Be as useLazyQuery, ur as useLocalStorage, Ar as useLogger, t as useMediaQuery, Ur as useMicrofrontendContext, ir as useMobileBreakpoint, Ve as useMutation, Hi as useNativeKeyboard, Bi as useNativePlatform, ar as useOnClickOutside, or as useOnClickOutsideWithRef, cn as usePWA, vr as usePagination, ni as usePlayTour, fr as usePrevious, pr as usePreviousDistinct, mr as usePreviousHistory, He as useQuery, Ir as useQuotaErrorToast, Nr as useRecordProductVisit, Mr as useReferralAttribution, St as useRegistryHelpers, Vi as useSafeArea, je as useSafeGateway, Me as useSafeGatewayClient, mi as useSafeToursContext, dr as useSessionStorage, Ct as useShellNavigate, Tr as useShortcutHelp, Zr as useStartTour, Ki as useStatusBar, Qr as useStopTour, Ue as useSubscription, tr as useThrottle, gr as useToggle, _r as useToggleObject, Kr as useTourPlayer, $r as useTourPlayerContext, hi as useTours, gi as useToursContext, zr as useUpgradePrompt, Ln as useVoiceInput, di as withTourProgressStatus };

package/dist/storage/SaveToFilesDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SaveToFilesDialog.d.ts","sourceRoot":"","sources":["../../src/storage/SaveToFilesDialog.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElE,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,iBAAiB,EACjB,QAAQ,EACR,OAAO,GACR,EAAE,KAAK,2CAwFP"}
+{"version":3,"file":"SaveToFilesDialog.d.ts","sourceRoot":"","sources":["../../src/storage/SaveToFilesDialog.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElE,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,iBAAiB,EACjB,QAAQ,EACR,OAAO,GACR,EAAE,KAAK,2CA6GP"}

package/dist/storage/SaveToFilesDialog.js

@@ -8,7 +8,7 @@ import { useEffect as d, useState as f } from "react";
 import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
 //#region src/storage/SaveToFilesDialog.tsx
 function g({ open: g, onOpenChange: _, source: v, defaultFolderPath: y, filename: b, onSaved: x }) {
-	let [S, C] = f(y ?? "/Saved"), { save: w, isPending: T, error: E, progress: D } = u();
+	let [S, C] = f(y ?? "/Saved"), { save: w, isPending: T, error: E, progress: D, retry: O } = u();
 	return d(() => {
 		g && C(y ?? "/Saved");
 	}, [g, y]), /* @__PURE__ */ m(e, {
@@ -55,6 +55,21 @@ function g({ open: g, onOpenChange: _, source: v, defaultFolderPath: y, filename
 							style: { width: `${D}%` }
 						})
 					}),
+					T && O && /* @__PURE__ */ h("p", {
+						className: "text-xs text-muted-foreground",
+						role: "status",
+						"aria-live": "polite",
+						"data-testid": "save-to-files-retry",
+						children: [
+							O.kind === "cold-start" ? "The file service is starting up — retrying" : "Hit a hiccup — retrying",
+							" ",
+							"(attempt ",
+							O.attempt,
+							" of ",
+							O.maxAttempts,
+							")…"
+						]
+					}),
 					E && /* @__PURE__ */ m("p", {
 						className: "text-xs text-destructive",
 						"data-testid": "save-to-files-error",

package/dist/storage/index.d.ts

@@ -6,5 +6,8 @@ export { SaveToFilesDialog } from './SaveToFilesDialog';
 export { useSaveToFiles } from './useSaveToFiles';
 export type { SavedFile, UseSaveToFilesResult } from './useSaveToFiles';
 export { uploadBlobToFiles, FILES_AFTER_SAVE_REFETCH } from './uploadBlob';
-export type { UploadBlobParams, UploadedFile } from './uploadBlob';
+export type { UploadBlobParams, UploadedFile, SaveToFilesStep, SaveToFilesRetryNotice, } from './uploadBlob';
+export { classifyFilesError, decideFilesRetry, runWithFilesRetry, COLD_START_MAX_ATTEMPTS, COLD_START_RETRY_DELAYS_MS, COLD_START_RETRY_BUDGET_MS, } from './retryPolicy';
+export type { FilesRetryKind, FilesRetryDecision, FilesRetryNotice, FilesRetryContext, } from './retryPolicy';
+export { warmFilesService, useFilesServiceWarmup, FILES_WARMUP_COOLDOWN_MS, } from './warmFilesService';
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/storage/index.js

@@ -1,6 +1,8 @@
 import { StorageFolderPicker as e } from "./StorageFolderPicker.js";
-import { FILES_AFTER_SAVE_REFETCH as t, uploadBlobToFiles as n } from "./uploadBlob.js";
-import { useSaveToFiles as r } from "./useSaveToFiles.js";
-import { SaveToFilesDialog as i } from "./SaveToFilesDialog.js";
-import { SaveToFilesButton as a } from "./SaveToFilesButton.js";
-export { t as FILES_AFTER_SAVE_REFETCH, a as SaveToFilesButton, i as SaveToFilesDialog, e as StorageFolderPicker, n as uploadBlobToFiles, r as useSaveToFiles };
+import { COLD_START_MAX_ATTEMPTS as t, COLD_START_RETRY_BUDGET_MS as n, COLD_START_RETRY_DELAYS_MS as r, classifyFilesError as i, decideFilesRetry as a, runWithFilesRetry as o } from "./retryPolicy.js";
+import { FILES_AFTER_SAVE_REFETCH as s, uploadBlobToFiles as c } from "./uploadBlob.js";
+import { useSaveToFiles as l } from "./useSaveToFiles.js";
+import { SaveToFilesDialog as u } from "./SaveToFilesDialog.js";
+import { SaveToFilesButton as d } from "./SaveToFilesButton.js";
+import { FILES_WARMUP_COOLDOWN_MS as f, useFilesServiceWarmup as p, warmFilesService as m } from "./warmFilesService.js";
+export { t as COLD_START_MAX_ATTEMPTS, n as COLD_START_RETRY_BUDGET_MS, r as COLD_START_RETRY_DELAYS_MS, s as FILES_AFTER_SAVE_REFETCH, f as FILES_WARMUP_COOLDOWN_MS, d as SaveToFilesButton, u as SaveToFilesDialog, e as StorageFolderPicker, i as classifyFilesError, a as decideFilesRetry, o as runWithFilesRetry, c as uploadBlobToFiles, p as useFilesServiceWarmup, l as useSaveToFiles, m as warmFilesService };

package/dist/storage/retryPolicy.d.ts

@@ -0,0 +1,179 @@
+/**
+ * retryPolicy — when a wspace-files-svc call through the workspace gateway is
+ * worth trying again, and how long to wait before doing so.
+ *
+ * ## Why this exists: a scale-to-zero cold start, measured in production
+ *
+ * `wspace-files-svc` runs at `minReplicas: 0`, 0.25 vCPU / 0.5 GiB, so after an
+ * idle period its revision sits at `replicas: 0, state: "ScaledToZero"`. Timed on
+ * the deployed image at that exact resource envelope:
+ *
+ *   bunx prisma migrate deploy   26.0s
+ *   app boot                    ~25.5s
+ *   ------------------------------------
+ *   >= 51s before the port binds
+ *
+ * The gateway's per-operation budget is `OPERATION_TIMEOUT_MS = 15_000`. The first
+ * request after a quiet period therefore CANNOT succeed: it wakes the container and
+ * is then abandoned ~36s before that container can answer.
+ *
+ * Seven-attempt production reproduction, same 1,305-byte file, idle gaps
+ * 0/5/40/5/40/90/5s:
+ *
+ *   #1  16.2s  FAIL  "Operation timeout"  {"code":"OPERATION_TIMEOUT","timeoutMs":15000}
+ *   #2  16.2s  OK    #3 6.1s OK   #4 6.1s OK   #5 6.1s OK   #6 2.1s OK   #7 2.1s OK
+ *
+ * Only the first attempt fails; everything after it is warm and gets faster. With a
+ * 300s Azure Container Apps cooldown, a real user's first attachment after any quiet
+ * period lands on exactly this. The proper fix is `minReplicas: 1` — that needs Azure
+ * access, so this module is the client-side half that makes the cold start survivable
+ * meanwhile. Several services in this fleet are scale-to-zero, so it is not a
+ * one-off workaround.
+ *
+ * ## Two retry classes, deliberately different
+ *
+ * - `cold-start`  — the gateway gave up waiting (`OPERATION_TIMEOUT` and friends).
+ *                   The container is probably still booting, so the delays are sized
+ *                   in TENS of seconds. A single immediate retry is useless here.
+ * - `transient-blip` — a masked `INTERNAL_SERVER_ERROR` or a bare network error, the
+ *                   pre-existing `completeUpload` case (a brief Azure Managed Redis
+ *                   slowdown). Sub-second delays, unchanged from before this module.
+ *
+ * ## What is NEVER retried
+ *
+ * Classification is an ALLOWLIST: an unrecognised code is not retried. On top of
+ * that, `NEVER_RETRY_CODES` is a hard stop — if a quota rejection, an auth failure
+ * or any other 4xx-class business error appears anywhere in the error, the whole
+ * error is unretryable even if a timeout also appears. Retrying those is pure harm:
+ * the answer will not change and the user waits a minute to be told the same thing.
+ */
+/** How an error should be retried, or `null` for "do not retry this". */
+export type FilesRetryKind = 'cold-start' | 'transient-blip';
+/**
+ * Attempt ceiling for a cold start. Three attempts, and the third one starts at
+ * roughly t+61s:
+ *
+ *   attempt 1  t=0   -> gateway gives up at ~16s
+ *   wait 10s
+ *   attempt 2  t=26  -> gateway gives up at ~41s
+ *   wait 20s
+ *   attempt 3  t=61  -> container bound its port at ~51s, so this is the one that lands
+ *
+ * The container's boot clock starts when attempt 1 reaches the ACA ingress, which is
+ * why the ladder is measured from the FIRST attempt and not from each failure. The
+ * numbers above come from the measurement at the top of this file: >=51s to port
+ * bind, 15s gateway budget. Change them if that measurement changes, not before.
+ */
+export declare const COLD_START_MAX_ATTEMPTS = 3;
+/** Delay before cold-start attempt 2, then before attempt 3. See the ladder above. */
+export declare const COLD_START_RETRY_DELAYS_MS: readonly number[];
+/**
+ * Hard wall-clock ceiling for one operation's cold-start retries, measured from the
+ * first attempt. The ladder above tops out at ~76s of real time; this stops a
+ * pathologically slow gateway from stretching that indefinitely. Past this, we give
+ * up honestly and show the user the real error.
+ */
+export declare const COLD_START_RETRY_BUDGET_MS = 75000;
+/** Attempt ceiling for a transient blip — unchanged from the pre-existing behaviour. */
+export declare const BLIP_MAX_ATTEMPTS = 3;
+/** Delays before blip attempts 2 and 3 — unchanged from the pre-existing behaviour. */
+export declare const BLIP_RETRY_DELAYS_MS: readonly number[];
+/**
+ * Best-effort message extraction, preferring the first GraphQL error's message
+ * (Apollo v4 `CombinedGraphQLErrors.errors`, or v3 `.graphQLErrors`) so callers can
+ * surface the real reason instead of a generic envelope.
+ *
+ * Lives here rather than in `uploadBlob` because both the upload path and the folder
+ * path need it and both now sit on top of this module. `uploadBlob` re-exports it, so
+ * its public name is unchanged.
+ */
+export declare function extractErrorMessage(err: unknown): string | undefined;
+/**
+ * Decide what KIND of failure this is, or `null` if it must not be retried.
+ *
+ * Pure. This is the whole safety argument in one function, so it is unit-tested
+ * directly rather than only through the upload path.
+ */
+export declare function classifyFilesError(err: unknown): FilesRetryKind | null;
+export interface FilesRetryContext {
+    /** 1-based index of the attempt that just failed. */
+    attempt: number;
+    /** Milliseconds since the FIRST attempt started (the container's boot clock). */
+    elapsedMs: number;
+    /** Which classes this call site permits. Defaults to cold-start only. */
+    allow?: readonly FilesRetryKind[];
+}
+export type FilesRetryDecision = {
+    retry: true;
+    kind: FilesRetryKind;
+    /** How long to wait before the next attempt. */
+    delayMs: number;
+    /** 1-based number of the attempt that is about to run. */
+    nextAttempt: number;
+    maxAttempts: number;
+} | {
+    retry: false;
+    reason: 'not-retryable' | 'kind-not-allowed' | 'attempts-exhausted' | 'budget-exhausted';
+};
+/**
+ * The retry policy as a pure function: given the error and where we are, should we go
+ * again and after how long?
+ *
+ * Separated from any I/O so the safety properties can be asserted directly — retries
+ * on a gateway timeout, does NOT retry a quota/auth/4xx rejection, respects the
+ * attempt ceiling and the wall-clock budget, and reports honestly why it stopped.
+ */
+export declare function decideFilesRetry(err: unknown, ctx: FilesRetryContext): FilesRetryDecision;
+/** What one attempt reports back to the runner. */
+export type FilesAttemptResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: unknown;
+};
+/** Handed to `onRetry` just before the runner sleeps. Enough to render honest UI. */
+export interface FilesRetryNotice {
+    kind: FilesRetryKind;
+    /** 1-based number of the attempt about to run (2 means "second try"). */
+    attempt: number;
+    maxAttempts: number;
+    /** How long the runner is about to wait. */
+    delayMs: number;
+    /** The failure that triggered the retry, for logging — never for the user. */
+    error: unknown;
+}
+export interface RunWithFilesRetryOptions {
+    /** Which classes this call site permits. Defaults to cold-start only. */
+    allow?: readonly FilesRetryKind[];
+    /** Fired before each wait, so the UI can say what it is waiting for. */
+    onRetry?: (notice: FilesRetryNotice) => void;
+    /** Injected by tests. */
+    now?: () => number;
+    /** Injected by tests. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface FilesRetryOutcome<T> {
+    /** Present only on success. */
+    value?: T;
+    /** The last in-band error, when `value` is absent. */
+    error?: unknown;
+    /** How many attempts were actually made. */
+    attempts: number;
+    /** Why we stopped, when `value` is absent. */
+    gaveUpBecause?: 'not-retryable' | 'kind-not-allowed' | 'attempts-exhausted' | 'budget-exhausted';
+}
+/**
+ * Run `attempt` until it succeeds, the policy says stop, or the budget runs out.
+ *
+ * Two failure channels, on purpose:
+ *
+ * - A THROWN error is classified and, if unretryable, rethrown **as-is**. Identity
+ *   and stack are preserved, so callers that let network errors through untouched
+ *   keep doing exactly that.
+ * - An IN-BAND error (`{ ok: false, error }` — what `errorPolicy: 'all'` produces on
+ *   `result.error`) is returned in the outcome. The runner never invents a message
+ *   for it; the caller owns the wording, which is what fe-libs #132 established.
+ */
+export declare function runWithFilesRetry<T>(attempt: (attemptNumber: number) => Promise<FilesAttemptResult<T>>, options?: RunWithFilesRetryOptions): Promise<FilesRetryOutcome<T>>;
+//# sourceMappingURL=retryPolicy.d.ts.map

package/dist/storage/retryPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryPolicy.d.ts","sourceRoot":"","sources":["../../src/storage/retryPolicy.ts"],"names":[],"mappings":"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"}