@burdenoff/fe-libs 2026.510.126

package/dist/shared/utils/gatewayFetchRewrite.js

@@ -0,0 +1,130 @@
+import { ALL_PRODUCT_DOMAINS as e } from "../config/gatewayUrls.js";
+//#region src/shared/utils/gatewayFetchRewrite.ts
+var t = {
+	globalBase: "https://graphql.burdenoff.com",
+	workspaceBase: "https://graphqlworkspaces.burdenoff.com"
+}, n = {
+	globalBase: "https://alphagraphql.burdenoff.com",
+	workspaceBase: "https://alphagraphqlworkspaces.burdenoff.com"
+}, r = e.flatMap((e) => [{
+	hostname: `app.${e}`,
+	bases: t
+}, {
+	hostname: `alphaapp.${e}`,
+	bases: n
+}]), i = {
+	globalBase: "https://gw-global.local.burdenoff.com",
+	workspaceBase: "https://gw-wspace.local.burdenoff.com"
+}, a = 15e3, o = 1e4, s = [
+	"traceparent",
+	"tracestate",
+	"baggage"
+], c = [
+	"authorization",
+	"accept-language",
+	"x-org-id",
+	"x-workspace-id",
+	"x-workspace-authorization",
+	"x-geo-country",
+	"x-geo-currency",
+	"x-geo-timezone"
+];
+function l() {
+	let e = globalThis;
+	return e.__boffGraphQLResponseCache ||= /* @__PURE__ */ new Map(), e.__boffGraphQLResponseCache;
+}
+function u(e) {
+	return typeof e.query == "string" ? /\bquery\b/.test(e.query) && !/\bmutation\b|\bsubscription\b/.test(e.query) : !1;
+}
+function d(e) {
+	return typeof e.operationName == "string" && e.operationName ? e.operationName : typeof e.query == "string" ? e.query.match(/(?:query|mutation|subscription)\s+([A-Za-z0-9_]+)/)?.[1] ?? null : null;
+}
+function f(e) {
+	return Object.fromEntries(c.map((t) => [t, e.get(t) ?? ""]));
+}
+function p(e, t) {
+	let n = d(t);
+	return !n || !u(t) ? null : JSON.stringify({
+		url: e.url,
+		headers: f(e.headers),
+		operationName: n,
+		variables: t.variables ?? null
+	});
+}
+function m(e) {
+	try {
+		let t = JSON.parse(e);
+		return Array.isArray(t) ? t : t && typeof t == "object" ? [t] : null;
+	} catch {
+		return null;
+	}
+}
+function h(e, t) {
+	return new Response(JSON.stringify(t ? e : e[0]), {
+		status: 200,
+		headers: { "content-type": "application/json" }
+	});
+}
+function g() {
+	return typeof performance < "u" && performance.now() < o;
+}
+function _(e) {
+	let t = new Headers(e.headers), n = !1;
+	for (let e of s) t.has(e) && (t.delete(e), n = !0);
+	return n ? new Request(e, { headers: t }) : e;
+}
+function v(e, t) {
+	let n = window.location.hostname.toLowerCase(), a = [...r, ...e ?? []];
+	for (let e of a) if (n === e.hostname) return e.bases;
+	return t ?? i;
+}
+function y(e) {
+	let { globalBase: t, workspaceBase: n } = e;
+	if (!t || !n) return;
+	let r = globalThis.fetch.bind(globalThis), i = window.location.origin, o = new Set([i, "https://gw-global.local.burdenoff.com"]), s = new Set([i, "https://gw-wspace.local.burdenoff.com"]), c = (e) => /(?:^|\/)global\/graphql$/.test(e) ? "/global/graphql" : /(?:^|\/)workspaces\/graphql$/.test(e) ? "/workspaces/graphql" : "", u = (e) => {
+		let r = new URL(e, window.location.origin), i = c(r.pathname);
+		return i === "/global/graphql" && o.has(r.origin) ? `${t}${i}${r.search}${r.hash}` : i === "/workspaces/graphql" && s.has(r.origin) ? `${n}${i}${r.search}${r.hash}` : e;
+	}, d = async (e) => {
+		if (!(e.method.toUpperCase() === "POST" && /(?:^|\/)graphql$/.test(new URL(e.url).pathname))) return r(e);
+		let t = await e.clone().text(), n = _(e.clone()), i = m(t);
+		if (!i?.length) return r(e);
+		let o = t.trimStart().startsWith("["), s = i.map((e) => p(n, e));
+		if (g() && s.every(Boolean)) {
+			let e = l(), t = s.map((t) => e.get(t)), n = Date.now();
+			if (t.every((e) => e && e.expiresAt > n)) return h(t.map((e) => e.value), o);
+		}
+		let c = await r(e);
+		if (!c.ok || !s.some(Boolean) || !g()) return c;
+		try {
+			let e = await c.clone().json(), t = Array.isArray(e) ? e : [e], n = l();
+			t.forEach((e, t) => {
+				let r = s[t];
+				r && (e && typeof e == "object" && "errors" in e && Array.isArray(e.errors) || n.set(r, {
+					value: e,
+					expiresAt: Date.now() + a
+				}));
+			});
+		} catch {}
+		return c;
+	};
+	globalThis.fetch = (e, t) => {
+		if (e == null) return r(e, t);
+		if (e instanceof Request) {
+			let n = u(e.url), r = new Request(n, e);
+			return d(t ? new Request(r, t) : r);
+		}
+		let n = typeof e == "string" ? e : e.toString();
+		return d(new Request(u(n), t));
+	};
+}
+function b(e = "VITE_VERBOSE_CONSOLE") {
+	({
+		BASE_URL: "/",
+		DEV: !1,
+		MODE: "production",
+		PROD: !0,
+		SSR: !1
+	})?.[e] !== "true" && (console.log = () => {}, console.info = () => {}, console.debug = () => {});
+}
+//#endregion
+export { y as installGatewayFetchRewrite, v as resolveGatewayBases, b as suppressConsole };

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,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,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,EACL,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,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/lazyWithRetry.js

@@ -0,0 +1,25 @@
+import { lazy as e } from "react";
+//#region src/shared/utils/lazyWithRetry.ts
+function t(e) {
+	if (!(e instanceof Error)) return !1;
+	let t = e.message.toLowerCase();
+	return t.includes("failed to fetch dynamically imported module") || t.includes("loading chunk") || t.includes("loading css chunk") || t.includes("dynamically imported module") || t.includes("failed to fetch") || e.name === "TypeError" && t.includes("failed to fetch");
+}
+function n(n, r = 2, i = 1500) {
+	return e(async () => {
+		for (let e = 0; e <= r; e++) try {
+			return await n();
+		} catch (n) {
+			if (!t(n)) throw n;
+			if (e < r) {
+				let t = i * (e + 1);
+				console.warn(`[lazyWithRetry] Chunk load failed (attempt ${e + 1}/${r + 1}), retrying in ${t}ms...`, n), await new Promise((e) => setTimeout(e, t));
+				continue;
+			}
+			throw console.error("[lazyWithRetry] All retries exhausted. Showing error UI instead of forcing a page reload."), n;
+		}
+		throw Error("Unreachable");
+	});
+}
+//#endregion
+export { t as isChunkLoadError, n as lazyWithRetry };

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,CAC5B,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,MAAM,QAKrB;AAED,wBAAgB,gBAAgB,SAQ/B"}

package/dist/shared/utils/loggerInit.js

@@ -0,0 +1,44 @@
+import { LogLevel as e } from "../logger/types.js";
+import { logManager as t } from "../logger/LogManager.js";
+import { ConsoleTransport as n } from "../logger/ConsoleTransport.js";
+//#region src/shared/utils/loggerInit.ts
+function r(r) {
+	let { appName: i, debugEnvVar: a = "VITE_LOG_LEVEL_DEBUG" } = r, o = {
+		BASE_URL: "/",
+		DEV: !1,
+		MODE: "production",
+		PROD: !0,
+		SSR: !1
+	}, s = o?.[a] === "true" ? e.DEBUG : e.INFO;
+	t.setGlobalLevel(s), t.addGlobalTransport(new n({
+		level: s,
+		useColors: !0,
+		useIcons: !0,
+		showTimestamp: !0,
+		showLogger: !0,
+		showContext: !0
+	})), t.setGlobalContext({
+		app: i,
+		environment: o?.MODE
+	}), t.getLogger("app").info("Logger initialized", { level: e[s] });
+}
+function i(e, n, r) {
+	t.setGlobalContext({
+		userId: e,
+		organizationId: n,
+		workspaceId: r
+	}), t.getLogger("app").debug("User context updated", {
+		userId: e,
+		organizationId: n,
+		workspaceId: r
+	});
+}
+function a() {
+	t.setGlobalContext({
+		userId: void 0,
+		organizationId: void 0,
+		workspaceId: void 0
+	}), t.getLogger("app").debug("User context cleared");
+}
+//#endregion
+export { a as clearUserContext, r as initializeLogger, i as setUserContext };

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/profileScopedStorage.js

@@ -0,0 +1,55 @@
+import { createJSONStorage as e } from "zustand/middleware";
+//#region src/shared/utils/profileScopedStorage.ts
+var t = "bf-active-profile", n = "bf-profiles", r = "bf-p";
+function i() {
+	try {
+		let e = sessionStorage.getItem(t);
+		if (e) return e;
+		let r = localStorage.getItem(n);
+		if (r) {
+			let e = JSON.parse(r);
+			if (e.length > 0 && e[0]?.id) return e[0].id;
+		}
+		return null;
+	} catch {
+		return null;
+	}
+}
+function a(e, t) {
+	return `${r}-${e}-${t}`;
+}
+function o(e) {
+	let t = i();
+	return t ? a(t, e) : e;
+}
+var s = {
+	getItem(e) {
+		let t = i();
+		if (!t) return localStorage.getItem(e);
+		let n = a(t, e), r = localStorage.getItem(n);
+		if (r !== null) return r;
+		let o = localStorage.getItem(e);
+		return o === null ? null : (localStorage.setItem(n, o), localStorage.removeItem(e), o);
+	},
+	setItem(e, t) {
+		let n = i();
+		if (!n) {
+			localStorage.setItem(e, t);
+			return;
+		}
+		localStorage.setItem(a(n, e), t), localStorage.removeItem(e);
+	},
+	removeItem(e) {
+		let t = i();
+		if (!t) {
+			localStorage.removeItem(e);
+			return;
+		}
+		localStorage.removeItem(a(t, e)), localStorage.removeItem(e);
+	}
+};
+function c() {
+	return e(() => s);
+}
+//#endregion
+export { c as createProfileScopedStorage, o as getProfileScopedKey };

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

@@ -0,0 +1,37 @@
+/**
+ * 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 interface QuotaExhaustedExtensions {
+    code: typeof QUOTA_EXHAUSTED_CODE;
+    field?: string;
+    quotaName?: string;
+    limitLeft?: number;
+    limit?: number;
+    used?: number;
+}
+/**
+ * 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;AAE/D,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;AAyBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,GACX,wBAAwB,GAAG,IAAI,CAqBjC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,wBAAwB,GAAG,IAAI,GACnC,MAAM,CAMR"}

package/dist/shared/utils/quotaErrors.js

@@ -0,0 +1,21 @@
+//#region src/shared/utils/quotaErrors.ts
+var e = "QUOTA_EXHAUSTED";
+function t(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 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 i(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 };

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

@@ -0,0 +1,166 @@
+/**
+ * Semantic Design Tokens Utility
+ *
+ * Provides TypeScript mappings for semantic design tokens.
+ * These map to CSS custom properties defined in fe-libs/tokens.
+ *
+ * Token Reference (from fe-libs/tokens):
+ * - Status: --color-status-{success|warning|error|info}-{bg|bg-subtle|text|border}
+ * - Action: --color-action-{primary|secondary|danger}-{bg|bgHover|text}
+ * - Text: --color-text-{primary|secondary|muted}
+ * - Background: --color-bg-{canvas|surface|elevated|sunken}
+ *
+ * The app shell (e.g., fluidgrids-app) defines the actual CSS variable values,
+ * allowing each product to have its own theme while microfrontends remain consistent.
+ */
+export type SemanticStatus = "success" | "warning" | "error" | "info" | "neutral" | "primary";
+interface StatusTokenClasses {
+    /** Background for subtle/badge usage */
+    bg: string;
+    /** Text color */
+    text: string;
+    /** Border color */
+    border: string;
+    /** Dot/indicator color (solid) */
+    dot: string;
+    /** Icon color */
+    icon: string;
+}
+/**
+ * Semantic status color classes using design tokens
+ * These map to CSS custom properties defined in the app shell
+ */
+export declare const statusTokens: Record<SemanticStatus, StatusTokenClasses>;
+/**
+ * Get status token classes for a given status
+ */
+export declare function getStatusTokens(status: SemanticStatus): StatusTokenClasses;
+/**
+ * Get combined badge classes for a status
+ */
+export declare function getStatusBadgeTokens(status: SemanticStatus): string;
+export declare const trendTokens: {
+    readonly positive: {
+        readonly text: "text-status-success-text";
+        readonly icon: "text-status-success-bg";
+    };
+    readonly negative: {
+        readonly text: "text-status-error-text";
+        readonly icon: "text-status-error-bg";
+    };
+    readonly neutral: {
+        readonly text: "text-status-neutral-text";
+        readonly icon: "text-status-neutral-text";
+    };
+};
+/**
+ * Get trend indicator classes
+ */
+export declare function getTrendTokens(isPositive: boolean | null): {
+    readonly text: "text-status-success-text";
+    readonly icon: "text-status-success-bg";
+} | {
+    readonly text: "text-status-error-text";
+    readonly icon: "text-status-error-bg";
+} | {
+    readonly text: "text-status-neutral-text";
+    readonly icon: "text-status-neutral-text";
+};
+export declare const progressTokens: {
+    healthy: {
+        bar: string;
+        track: string;
+    };
+    warning: {
+        bar: string;
+        track: string;
+    };
+    critical: {
+        bar: string;
+        track: string;
+    };
+};
+/**
+ * Get progress bar colors based on percentage
+ */
+export declare function getProgressTokens(percentage: number): {
+    bar: string;
+    track: string;
+};
+export declare const categoryTokens: {
+    plan: {
+        bg: string;
+        text: string;
+        border: string;
+    };
+    addon: {
+        bg: string;
+        text: string;
+        border: string;
+    };
+    credits: {
+        bg: string;
+        text: string;
+        border: string;
+    };
+};
+/**
+ * Get category badge classes
+ */
+export declare function getCategoryTokens(category: "plan" | "addon" | "credits"): {
+    bg: string;
+    text: string;
+    border: string;
+} | {
+    bg: string;
+    text: string;
+    border: string;
+} | {
+    bg: string;
+    text: string;
+    border: string;
+};
+export declare const alertTokens: {
+    success: {
+        container: string;
+        text: string;
+        icon: string;
+    };
+    warning: {
+        container: string;
+        text: string;
+        icon: string;
+    };
+    error: {
+        container: string;
+        text: string;
+        icon: string;
+    };
+    info: {
+        container: string;
+        text: string;
+        icon: string;
+    };
+};
+/**
+ * Get alert/banner classes
+ */
+export declare function getAlertTokens(type: "success" | "warning" | "error" | "info"): {
+    container: string;
+    text: string;
+    icon: string;
+} | {
+    container: string;
+    text: string;
+    icon: string;
+} | {
+    container: string;
+    text: string;
+    icon: string;
+} | {
+    container: string;
+    text: string;
+    icon: string;
+};
+export {};
+//# sourceMappingURL=tokens.d.ts.map