@burdenoff/fe-libs 2026.527.5 → 2026.527.7

package/dist/shared/utils/format.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Common formatting utilities for the microfrontend architecture
+ *
+ * These utilities provide consistent formatting across all microfrontends
+ * for dates, currencies, numbers, and text.
+ */
+/**
+ * Format a number as currency
+ * @param amount - The amount to format
+ * @param currency - The currency code (default: 'USD')
+ * @param locale - The locale for formatting (default: 'en-US')
+ */
+export declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+/**
+ * Format currency in compact notation (e.g., $1.5M, $500K)
+ */
+export declare function formatCurrencyCompact(amount: number, currency?: string): string;
+type DateFormat = 'short' | 'medium' | 'long';
+/**
+ * Format a date string or Date object
+ * @param date - The date to format
+ * @param format - The format style: 'short', 'medium', or 'long'
+ * @param locale - The locale for formatting (default: 'en-US')
+ */
+export declare function formatDate(date: string | Date, format?: DateFormat, locale?: string): string;
+/**
+ * Format a date with time
+ * @param date - The date to format
+ * @param includeSeconds - Whether to include seconds
+ * @param locale - The locale for formatting
+ */
+export declare function formatDateTime(date: string | Date, includeSeconds?: boolean, locale?: string): string;
+/**
+ * Format a date as relative time (e.g., "5 minutes ago")
+ */
+export declare function formatRelativeTime(date: string | Date): string;
+/**
+ * Format duration between two dates
+ */
+export declare function formatDuration(startDate: string | Date, endDate: string | Date): string;
+/**
+ * Format time only (e.g., "3:45 PM")
+ */
+export declare function formatTime(date: string | Date, locale?: string): string;
+/**
+ * Format a number with optional decimal places
+ */
+export declare function formatNumber(value: number, decimals?: number, locale?: string): string;
+/**
+ * Format a number as a percentage
+ */
+export declare function formatPercentage(value: number, decimals?: number): string;
+/**
+ * Format bytes to human readable format
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+/**
+ * Format a number in compact notation (e.g., 1.5K, 2.3M)
+ */
+export declare function formatCompactNumber(value: number, locale?: string): string;
+/**
+ * Format a number with ordinal suffix (e.g., 1st, 2nd, 3rd)
+ */
+export declare function formatOrdinal(n: number): string;
+/**
+ * Truncate text to a maximum length with ellipsis
+ */
+export declare function truncateText(text: string, maxLength: number, ellipsis?: string): string;
+/**
+ * Capitalize the first letter of a string
+ */
+export declare function capitalizeFirst(text: string): string;
+/**
+ * Capitalize the first letter of each word
+ */
+export declare function capitalizeWords(text: string): string;
+/**
+ * Convert a string to slug format
+ */
+export declare function slugify(text: string): string;
+/**
+ * Convert a string to camelCase
+ */
+export declare function toCamelCase(text: string): string;
+/**
+ * Convert a string to PascalCase
+ */
+export declare function toPascalCase(text: string): string;
+/**
+ * Pluralize a word based on count
+ */
+export declare function pluralize(word: string, count: number, plural?: string): string;
+/**
+ * Format a list of items with Oxford comma
+ */
+export declare function formatList(items: string[], conjunction?: string): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/dist/shared/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,EAAE,MAAM,SAAU,GAAG,MAAM,CAOzF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAQ9E;AAMD,KAAK,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,GAAE,UAAqB,EAC7B,MAAM,SAAU,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,cAAc,UAAQ,EACtB,MAAM,SAAU,GACf,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAmB9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAevF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,SAAU,GAAG,MAAM,CAGxE;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,MAAM,SAAU,GAAG,MAAM,CAKlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAM/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAK3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/C;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,SAAQ,GAAG,MAAM,CAKvE"}

package/dist/shared/utils/gatewayFetchRewrite.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Gateway fetch rewrite — patches global fetch to route GraphQL requests
+ * to the correct gateway domain based on the current hostname.
+ *
+ * This is necessary because the app shell serves from one domain (e.g., app.burdenoff.com)
+ * but GraphQL requests need to go to separate gateway domains
+ * (e.g., graphql.burdenoff.com, graphqlworkspaces.burdenoff.com).
+ *
+ * @module @burdenoff/fe-libs/shared/utils/gatewayFetchRewrite
+ *
+ * @example
+ * ```ts
+ * // In main.tsx, before React renders:
+ * import { installGatewayFetchRewrite, resolveGatewayBases } from "@burdenoff/fe-libs/shared/utils";
+ *
+ * const bases = resolveGatewayBases();
+ * installGatewayFetchRewrite(bases);
+ * ```
+ */
+export interface GatewayBases {
+    globalBase: string;
+    workspaceBase: string;
+}
+export interface GatewayBaseMapping {
+    /** Hostname (lowercase) */
+    hostname: string;
+    /** Gateway bases for this hostname */
+    bases: GatewayBases;
+}
+/**
+ * Resolve gateway base URLs from the current hostname.
+ *
+ * @param extraMappings - Additional hostname → gateway base mappings (e.g., for product-specific domains)
+ * @param localDefaults - Override defaults for local development
+ */
+export declare function resolveGatewayBases(extraMappings?: GatewayBaseMapping[], localDefaults?: GatewayBases): GatewayBases;
+/**
+ * Install a global fetch interceptor that rewrites GraphQL request URLs
+ * to the correct gateway domain based on the URL path.
+ *
+ * - `/global/graphql` → globalBase
+ * - `/workspaces/graphql` → workspaceBase
+ *
+ * @param bases - Gateway base URLs to rewrite to
+ */
+export declare function installGatewayFetchRewrite(bases: GatewayBases): void;
+/**
+ * Suppress verbose console output in production/non-debug environments.
+ *
+ * @param envFlag - Environment variable name to check for verbose mode (default: "VITE_VERBOSE_CONSOLE")
+ */
+export declare function suppressConsole(envFlag?: string): void;
+//# sourceMappingURL=gatewayFetchRewrite.d.ts.map

package/dist/shared/utils/gatewayFetchRewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayFetchRewrite.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/gatewayFetchRewrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,YAAY,CAAC;CACrB;AAmID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,kBAAkB,EAAE,EACpC,aAAa,CAAC,EAAE,YAAY,GAC3B,YAAY,CAad;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAqHpE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAyB,GAAG,IAAI,CAQtE"}

package/dist/shared/utils/index.d.ts

@@ -0,0 +1,26 @@
+import { ClassValue } from 'clsx';
+/**
+ * Utility function to merge Tailwind CSS classes
+ * Combines clsx for conditional classes and tailwind-merge for deduplication
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+export { createApolloClient } from './apollo';
+export type { CreateApolloClientOptions } from './apollo';
+export { statusTokens, trendTokens, progressTokens, categoryTokens, alertTokens, getStatusTokens, getStatusBadgeTokens, getTrendTokens, getProgressTokens, getCategoryTokens, getAlertTokens, } from './tokens';
+export type { SemanticStatus } from './tokens';
+export { formatCurrency, formatCurrencyCompact, formatDate, formatDateTime, formatRelativeTime, formatDuration, formatTime, formatNumber, formatPercentage, formatBytes, formatCompactNumber, formatOrdinal, truncateText, capitalizeFirst, capitalizeWords, slugify, toCamelCase, toPascalCase, pluralize, formatList, } from './format';
+export { lazyWithRetry, isChunkLoadError } from './lazyWithRetry';
+export { resolveGatewayBases, installGatewayFetchRewrite, suppressConsole, } from './gatewayFetchRewrite';
+export type { GatewayBases, GatewayBaseMapping } from './gatewayFetchRewrite';
+export { clearAuthSessionStorage, hasAuthGraphQLErrors, isAuthGraphQLError, isAuthNetworkError, attemptTokenRefresh, redirectToLogin, } from './authErrorHandling';
+export type { GraphQLErrorLike, TokenRefreshConfig } from './authErrorHandling';
+export { AppInitializer, useShellNavigate, useRegistryHelpers } from './appHelpers';
+export type { AppInitializerProps } from './appHelpers';
+export { initializeLogger, setUserContext, clearUserContext } from './loggerInit';
+export type { InitLoggerOptions } from './loggerInit';
+export { setSSoCookie, getSSoCookie, clearSSoCookie, setShellSsoCookies, readShellSsoCookie, clearShellSsoCookies, isSharedSsoCookieDomain, isTrustedSsoOrigin, } from './authCookie';
+export type { ShellSsoCookieData } from './authCookie';
+export { createProfileScopedStorage, getProfileScopedKey } from './profileScopedStorage';
+export { QUOTA_EXHAUSTED_CODE, isQuotaExhaustedError, extractQuotaExhaustedExtensions, buildQuotaExhaustedMessage, } from './quotaErrors';
+export type { QuotaExhaustedExtensions } from './quotaErrors';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAG1D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,eAAe,EACf,OAAO,EACP,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/shared/utils/lazyWithRetry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lazy import wrapper with automatic retry for failed dynamic imports.
+ *
+ * When Vite's dev server restarts or dependency optimizer re-optimizes,
+ * cached module URLs become stale. This wrapper:
+ * 1. Catches the failed import
+ * 2. Retries with increasing delays (gives Vite time to rebuild/re-optimize)
+ * 3. On final failure, surfaces the error to the nearest boundary so the user
+ *    can choose whether to reload.
+ *
+ * @module @burdenoff/fe-libs/shared/utils/lazyWithRetry
+ *
+ * @example
+ * ```tsx
+ * import { lazyWithRetry } from "@burdenoff/fe-libs/shared/utils";
+ *
+ * const MyComponent = lazyWithRetry(() =>
+ *   import("./MyComponent").then(m => ({ default: m.MyComponent }))
+ * );
+ * ```
+ */
+/**
+ * Check if an error is a chunk/module load failure.
+ * Covers both production chunk errors and Vite dev server 504 errors.
+ */
+export declare function isChunkLoadError(error: unknown): boolean;
+/**
+ * Wrap React.lazy() with automatic retry for chunk load failures.
+ *
+ * Retry strategy:
+ * - Attempt 1: immediate
+ * - Attempt 2: after retryDelay (1.5s default)
+ * - Attempt 3: after retryDelay * 2 (3s default)
+ * - If all fail: throw so the error boundary can offer an explicit reload action
+ *
+ * @param factory - The dynamic import factory function
+ * @param maxRetries - Maximum number of retries before page reload (default: 2)
+ * @param retryDelay - Base delay in ms between retries (default: 1500)
+ */
+export declare function lazyWithRetry<T extends React.ComponentType<any>>(factory: () => Promise<{
+    default: T;
+}>, maxRetries?: number, retryDelay?: number): import('react').LazyExoticComponent<T>;
+//# sourceMappingURL=lazyWithRetry.d.ts.map

package/dist/shared/utils/lazyWithRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazyWithRetry.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/lazyWithRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYxD;AAED;;;;;;;;;;;;GAYG;AAEH,wBAAgB,aAAa,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAC9D,OAAO,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,EACtC,UAAU,SAAI,EACd,UAAU,SAAO,0CA8BlB"}

package/dist/shared/utils/loggerInit.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Logger initialization utility for app shells.
+ *
+ * @module @burdenoff/fe-libs/shared/utils/loggerInit
+ */
+export interface InitLoggerOptions {
+    /** App name for global context (e.g., "workspaces", "fluidgrids") */
+    appName: string;
+    /** Environment variable name for debug flag (default: "VITE_LOG_LEVEL_DEBUG") */
+    debugEnvVar?: string;
+}
+export declare function initializeLogger(options: InitLoggerOptions): void;
+export declare function setUserContext(userId: string, organizationId?: string, workspaceId?: string): void;
+export declare function clearUserContext(): void;
+//# sourceMappingURL=loggerInit.d.ts.map

package/dist/shared/utils/loggerInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerInit.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/loggerInit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,QA4B1D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,QAI3F;AAED,wBAAgB,gBAAgB,SAQ/B"}

package/dist/shared/utils/mockData.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Mock data for development and testing.
+ *
+ * Provides realistic mock entities (organizations, workspaces, projects, products, languages)
+ * that can be used in dev harnesses and storybook.
+ *
+ * @module @burdenoff/fe-libs/shared/utils/mockData
+ */
+export declare const mockProducts: {
+    id: string;
+    name: string;
+    icon: string;
+    color: string;
+    url: string;
+}[];
+export declare const mockLanguages: {
+    code: string;
+    name: string;
+    nativeName: string;
+    flag: string;
+}[];
+export declare const mockOrganizations: {
+    id: string;
+    name: string;
+    slug: string;
+    tenantId: string;
+}[];
+export declare const mockWorkspaces: {
+    id: string;
+    name: string;
+    organizationId: string;
+    slug: string;
+}[];
+export declare const mockProjects: {
+    id: string;
+    name: string;
+    workspaceId: string;
+    slug: string;
+}[];
+//# sourceMappingURL=mockData.d.ts.map

package/dist/shared/utils/mockData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockData.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/mockData.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,YAAY;;;;;;GAoCxB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;GAuDzB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;GAmB7B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;GA2B1B,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;GAwDxB,CAAC"}

package/dist/shared/utils/profileScopedStorage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Profile-Scoped Storage — Zustand persist adapter + helpers
+ *
+ * Dynamically prefixes localStorage keys with the active profile ID
+ * so that persisted UI state (tabs, filters, selections, etc.) is
+ * isolated per user account.
+ *
+ * Key format: bf-p-{profileId}-{baseName}
+ *
+ * Includes one-time migration: on first read, if the scoped key is
+ * missing but the legacy (un-prefixed) key exists, the value is
+ * copied to the scoped key and the legacy key is removed.
+ */
+/**
+ * Returns the profile-scoped localStorage key for the given base key.
+ * Falls back to the bare key if no profile is active.
+ *
+ * Use this for raw `localStorage.getItem` / `localStorage.setItem` calls
+ * outside of zustand stores.
+ */
+export declare function getProfileScopedKey(key: string): string;
+/**
+ * Creates a zustand persist-compatible storage that scopes localStorage
+ * keys by the active user profile.
+ *
+ * Usage:
+ * ```ts
+ * import { createProfileScopedStorage } from '@burdenoff/fe-libs/shared/utils';
+ *
+ * const useMyStore = create(
+ *   persist(
+ *     (set) => ({ ... }),
+ *     {
+ *       name: 'my-store-key',
+ *       storage: createProfileScopedStorage(),
+ *     }
+ *   )
+ * );
+ * ```
+ */
+export declare function createProfileScopedStorage(): import('zustand/middleware').PersistStorage<unknown, unknown> | undefined;
+//# sourceMappingURL=profileScopedStorage.d.ts.map

package/dist/shared/utils/profileScopedStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profileScopedStorage.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/profileScopedStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuCH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD;AA+CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,8EAEzC"}

package/dist/shared/utils/quotaErrors.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Quota error detection utilities.
+ *
+ * Backend services return HTTP 429 with GraphQL error code `QUOTA_EXHAUSTED`
+ * (and extension fields like `field`, `quotaName`, `limitLeft`) when an
+ * `@usage`-annotated mutation exceeds its quota. Apollo Client surfaces this
+ * shape through one of three paths depending on whether the response was
+ * parsed as a network error or as GraphQL errors.
+ *
+ * See: ~/products/dev/platform/context/usage/HOW_TO_INTEGRATE_USAGE_MICROFE.md
+ */
+export declare const QUOTA_EXHAUSTED_CODE: "QUOTA_EXHAUSTED";
+export declare const STORAGE_QUOTA_EXCEEDED_CODE: "STORAGE_QUOTA_EXCEEDED";
+export declare const RESOURCE_CAP_EXCEEDED_CODE: "RESOURCE_CAP_EXCEEDED";
+/**
+ * All upgrade-eligible error codes the gateway/subgraphs may emit when a
+ * plan limit is hit. Any error with one of these codes should surface the
+ * shared `UpgradePromptModal` via `dispatchUpgradePrompt`.
+ */
+export declare const UPGRADE_ERROR_CODES: readonly ["QUOTA_EXHAUSTED", "STORAGE_QUOTA_EXCEEDED", "RESOURCE_CAP_EXCEEDED"];
+export type UpgradeErrorCode = (typeof UPGRADE_ERROR_CODES)[number];
+export interface QuotaExhaustedExtensions {
+    code: typeof QUOTA_EXHAUSTED_CODE;
+    field?: string;
+    quotaName?: string;
+    limitLeft?: number;
+    limit?: number;
+    used?: number;
+}
+/**
+ * Extensions emitted by storage / resource cap errors. Storage backends set
+ * `currentBytes/limitBytes`; resource-cap backends set `currentCount/limit`.
+ * Both carry `planName` and `resource`.
+ */
+export interface UpgradeErrorExtensions {
+    code: UpgradeErrorCode;
+    resource?: string;
+    planName?: string;
+    currentBytes?: number;
+    limitBytes?: number;
+    currentCount?: number;
+    limit?: number;
+    field?: string;
+    quotaName?: string;
+    used?: number;
+    limitLeft?: number;
+}
+/**
+ * Returns true if the error matches any upgrade-eligible code
+ * (QUOTA_EXHAUSTED, STORAGE_QUOTA_EXCEEDED, RESOURCE_CAP_EXCEEDED).
+ */
+export declare function isUpgradeError(err: unknown): boolean;
+/**
+ * Extract upgrade-eligible error extensions from any Apollo error shape.
+ */
+export declare function extractUpgradeErrorExtensions(err: unknown): UpgradeErrorExtensions | null;
+/**
+ * Resolve current/limit numerics for display, abstracting over storage-vs-count.
+ */
+export declare function resolveUpgradeUsage(ext: UpgradeErrorExtensions | null): {
+    current: number | null;
+    limit: number | null;
+    unit: 'bytes' | 'count';
+};
+/**
+ * Returns true if the given error is a `QUOTA_EXHAUSTED` response from any
+ * gateway path Apollo may surface it through.
+ */
+export declare function isQuotaExhaustedError(err: unknown): boolean;
+/**
+ * Extracts the QUOTA_EXHAUSTED extensions object from any Apollo error shape,
+ * or returns `null` if the error is not a quota-exhausted error.
+ */
+export declare function extractQuotaExhaustedExtensions(err: unknown): QuotaExhaustedExtensions | null;
+/**
+ * Build a user-facing toast message for a quota-exhausted error. Uses
+ * `quotaName` (preferred) or `field` from the extensions when available, and
+ * falls back to a generic message otherwise.
+ */
+export declare function buildQuotaExhaustedMessage(ext: QuotaExhaustedExtensions | null): string;
+//# sourceMappingURL=quotaErrors.d.ts.map

package/dist/shared/utils/quotaErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotaErrors.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/quotaErrors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAC/D,eAAO,MAAM,2BAA2B,EAAG,wBAAiC,CAAC;AAC7E,eAAO,MAAM,0BAA0B,EAAG,uBAAgC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iFAItB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,oBAAoB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAeD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CAmBzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,GAAG;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CACzB,CAcA;AAyBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,GAAG,wBAAwB,GAAG,IAAI,CAqB7F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,wBAAwB,GAAG,IAAI,GAAG,MAAM,CAMvF"}

package/dist/shared/utils/quotaErrors.js

@@ -1,21 +1,59 @@
 //#region src/shared/utils/quotaErrors.ts
-var e = "QUOTA_EXHAUSTED";
-function t(e) {
+var e = "QUOTA_EXHAUSTED", t = "STORAGE_QUOTA_EXCEEDED", n = "RESOURCE_CAP_EXCEEDED", r = [
+	e,
+	t,
+	n
+];
+function i(e) {
+	if (!e) return null;
+	for (let t of e) {
+		let e = t?.extensions?.code;
+		if (e && r.includes(e)) return t.extensions;
+	}
+	return null;
+}
+function a(e) {
+	if (typeof e != "object" || !e) return null;
+	let t = e, n = i(t.graphQLErrors);
+	if (n) return n;
+	let a = i(t.networkError?.result?.errors);
+	if (a) return a;
+	if (e instanceof Error && typeof e.message == "string") {
+		for (let t of r) if (e.message.includes(t)) return { code: t };
+	}
+	return null;
+}
+function o(e) {
+	return e ? e.code === "STORAGE_QUOTA_EXCEEDED" || typeof e.limitBytes == "number" ? {
+		current: e.currentBytes ?? null,
+		limit: e.limitBytes ?? null,
+		unit: "bytes"
+	} : {
+		current: e.currentCount ?? e.used ?? null,
+		limit: e.limit ?? null,
+		unit: "count"
+	} : {
+		current: null,
+		limit: null,
+		unit: "count"
+	};
+}
+function s(e) {
 	if (!e) return null;
 	for (let t of e) if (t?.extensions?.code === "QUOTA_EXHAUSTED") return t.extensions;
 	return null;
 }
-function n(e) {
-	return r(e) !== null;
+function c(e) {
+	return l(e) !== null;
 }
-function r(n) {
-	if (typeof n != "object" || !n) return null;
-	let r = n;
-	return t(r.graphQLErrors) || t(r.networkError?.result?.errors) || (n instanceof Error && typeof n.message == "string" && n.message.includes("QUOTA_EXHAUSTED") ? { code: e } : null);
+function l(t) {
+	if (typeof t != "object" || !t) return null;
+	let n = t;
+	return s(n.graphQLErrors) || s(n.networkError?.result?.errors) || (t instanceof Error && typeof t.message == "string" && t.message.includes("QUOTA_EXHAUSTED") ? { code: e } : null);
 }
-function i(e) {
+function u(e) {
 	let t = e?.quotaName ?? e?.field;
 	return t ? `You've reached your ${t} limit. Upgrade your plan.` : "You've reached your usage limit. Upgrade your plan.";
 }
 //#endregion
-export { e as QUOTA_EXHAUSTED_CODE, i as buildQuotaExhaustedMessage, r as extractQuotaExhaustedExtensions, n as isQuotaExhaustedError };
+export { e as QUOTA_EXHAUSTED_CODE, n as RESOURCE_CAP_EXCEEDED_CODE, t as STORAGE_QUOTA_EXCEEDED_CODE, u as buildQuotaExhaustedMessage, l as extractQuotaExhaustedExtensions, a as extractUpgradeErrorExtensions, c as isQuotaExhaustedError, o as resolveUpgradeUsage };