@burdenoff/fe-libs 2026.723.5 → 2026.725.2

package/dist/shared/providers/shell/ActiveContextProvider.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { ActiveContextUrlParams, AuthStoreContextSnapshot } from './ActiveContextStorage';
 /**
  * Context value interface for organization/workspace/project selection
  */
@@ -53,6 +54,57 @@ export interface ActiveContextProviderProps {
         tenant?: string;
     };
 }
+export declare const CONTEXT_THRASH_WINDOW_MS = 500;
+export declare const CONTEXT_THRASH_MAX_FLIPS = 3;
+export interface ContextFieldThrashState {
+    current: string | null;
+    previous: string | null;
+    flips: number;
+    windowStart: number;
+    suppressUntil: number;
+}
+export declare function createContextFieldThrashState(initial: string | null): ContextFieldThrashState;
+/**
+ * Decides whether `nextValue` should be applied to a context field, mutating
+ * `state` to reflect the decision. Returns `false` for a true no-op (value
+ * unchanged), while an active suppression window is in effect, or when this
+ * write is detected as the Nth rapid alternation back to the field's prior
+ * value — the ping-pong signature described above.
+ */
+export declare function shouldApplyContextFieldWrite(fieldName: string, state: ContextFieldThrashState, nextValue: string | null, now: number): boolean;
+export interface ActiveContextBootstrapFields {
+    organizationId: string | null;
+    workspaceId: string | null;
+    projectId: string | null;
+}
+/**
+ * Fill-only merge of the persisted auth-store context into the values already
+ * resolved from the URL / ActiveContext's own storage.
+ *
+ * Fill rules (mirroring microfe-auth's `useActiveContextBootstrapMirror`):
+ * - a value already resolved from the URL or own storage always wins;
+ * - a child axis is filled from the store only when its parent axis provably
+ *   matches the parent the stored child belongs to — the workspace only when
+ *   the resolved organization IS the store's organization, the project only
+ *   when the resolved workspace IS the store's workspace. Without that guard a
+ *   stale `?org=` deep link would be paired with a workspace from a different
+ *   organization, which is worse than no workspace at all.
+ * - a child is never filled under an empty parent, for the same reason.
+ *
+ * Exported so this can be unit-tested directly: it is pure, while the provider
+ * around it needs a DOM.
+ */
+export declare function applyAuthStoreContextFallback(resolved: ActiveContextBootstrapFields, authStore: AuthStoreContextSnapshot): ActiveContextBootstrapFields;
+/**
+ * Resolve the organization / workspace / project the provider should start
+ * from: URL (when synced) > ActiveContext's own storage > persisted auth store.
+ * Defaults are applied by the caller, after this.
+ */
+export declare function resolveInitialActiveContext(options: {
+    storageKey: string;
+    syncToUrl: boolean;
+    urlParams: ActiveContextUrlParams;
+}): ActiveContextBootstrapFields;
 /**
  * ActiveContextProvider
  *

package/dist/shared/providers/shell/ActiveContextProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActiveContextProvider.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ActiveContextProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAiBf;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sCAAsC;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oCAAoC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,kCAAkC;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,+BAA+B;IAC/B,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,6BAA6B;IAC7B,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,4BAA4B;IAC5B,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAE7C,qCAAqC;IACrC,UAAU,EAAE,CACV,OAAO,EAAE,OAAO,CAAC;QACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC,KACC,IAAI,CAAC;IAEV,+BAA+B;IAC/B,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;CACzB;AAID,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,CAAC;IACpB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,SAAS,CAAC,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAiCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,qBAA4B,EAC5B,kBAAyB,EACzB,gBAAuB,EACvB,eAAsB,EACtB,UAAuC,EACvC,SAAiB,EACjB,SAA6C,GAC9C,EAAE,0BAA0B,2CAkS5B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,uBAM/B"}
+{"version":3,"file":"ActiveContextProvider.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ActiveContextProvider.tsx"],"names":[],"mappings":"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"}

package/dist/shared/providers/shell/ActiveContextProvider.js

@@ -1,32 +1,81 @@
 import { getProfileContext as e, resolveActiveProfileId as t, setProfileContext as n } from "./ProfileStorageManager.js";
-import { ACTIVE_CONTEXT_STORAGE_KEY as r, DEFAULT_ACTIVE_CONTEXT_URL_PARAMS as i, clearActiveContextStorage as a, getUrlParam as o, readActiveContextStorageValue as s, writeActiveContextFallback as c, writeActiveContextStorageValue as l } from "./ActiveContextStorage.js";
-import { isSsoNavigationPending as u } from "../../utils/ssoDeposit.js";
-import { createContext as d, use as f, useCallback as p, useEffect as m, useMemo as h, useState as g } from "react";
-import { jsx as _ } from "react/jsx-runtime";
+import { ACTIVE_CONTEXT_STORAGE_KEY as r, DEFAULT_ACTIVE_CONTEXT_URL_PARAMS as i, clearActiveContextStorage as a, getUrlParam as o, readActiveContextStorageValue as s, readAuthStoreContext as c, writeActiveContextFallback as l, writeActiveContextStorageValue as u } from "./ActiveContextStorage.js";
+import { isSsoNavigationPending as d } from "../../utils/ssoDeposit.js";
+import { createContext as f, use as p, useCallback as m, useEffect as h, useMemo as g, useRef as _, useState as v } from "react";
+import { jsx as y } from "react/jsx-runtime";
 //#region src/shared/providers/shell/ActiveContextProvider.tsx
-var v = d(null);
-function y(e) {
-	if (typeof window > "u" || u() || window.location.pathname.startsWith("/auth/")) return;
+var b = f(null);
+function x(e) {
+	return {
+		current: e,
+		previous: null,
+		flips: 0,
+		windowStart: 0,
+		suppressUntil: 0
+	};
+}
+function S() {
+	try {
+		return !!{
+			BASE_URL: "/",
+			DEV: !1,
+			MODE: "production",
+			PROD: !0,
+			SSR: !1
+		}?.DEV;
+	} catch {
+		return !1;
+	}
+}
+function C(e, t, n, r) {
+	if (t.current === n) return !1;
+	if (r < t.suppressUntil) return S() && console.warn(`[ActiveContext] Suppressing rapid ${e} change to avoid a render loop (BOFF-5395): holding at ${JSON.stringify(t.current)}, refused ${JSON.stringify(n)}.`), !1;
+	let i = n === t.previous, a = r - t.windowStart < 500;
+	return i && a ? t.flips += 1 : (t.flips = 1, t.windowStart = r), t.flips >= 3 ? (t.suppressUntil = r + 500, t.flips = 0, S() && console.warn(`[ActiveContext] Detected ${e} ping-pong between ${JSON.stringify(t.current)} and ${JSON.stringify(n)} (BOFF-5395) — holding at the current value instead of looping.`), !1) : (t.previous = t.current, t.current = n, !0);
+}
+function w(e, t) {
+	let n = e.organizationId ?? t.organizationId, r = n !== null && n === t.organizationId, i = e.workspaceId ?? (r ? t.workspaceId : null), a = i !== null && i === t.workspaceId;
+	return {
+		organizationId: n,
+		workspaceId: i,
+		projectId: e.projectId ?? (a ? t.projectId : null)
+	};
+}
+function T(e, t, n, r) {
+	if (n) {
+		let e = o(t);
+		if (e) return e;
+	}
+	return s(e, r) || null;
+}
+function E(e) {
+	if (typeof window > "u") return {
+		organizationId: null,
+		workspaceId: null,
+		projectId: null
+	};
+	let { storageKey: t, syncToUrl: n, urlParams: r } = e, a = {
+		organizationId: T("organization", r.organization ?? i.organization, n, t),
+		workspaceId: T("workspace", r.workspace ?? i.workspace, n, t),
+		projectId: T("project", r.project ?? i.project, n, t)
+	};
+	return a.organizationId !== null && a.workspaceId !== null && a.projectId !== null ? a : w(a, c());
+}
+function D(e) {
+	if (typeof window > "u" || d() || window.location.pathname.startsWith("/auth/")) return;
 	let t = new URL(window.location.href);
 	Object.entries(e).forEach(([e, n]) => {
 		n ? t.searchParams.set(e, n) : t.searchParams.delete(e);
 	}), window.history.replaceState({}, "", t.toString());
 }
-function b({ children: u, defaultOrganizationId: d = null, defaultWorkspaceId: f = null, defaultProjectId: b = null, defaultTenantId: x = null, storageKey: S = r, syncToUrl: C = !1, urlParams: w = i }) {
-	let [T, E] = g(() => {
-		if (typeof window > "u") return d;
-		if (C) {
-			let e = o(w.organization);
-			if (e) return e;
-		}
-		return s("organization", S) || d;
-	}), [D, O] = g(() => {
+function O({ children: c, defaultOrganizationId: d = null, defaultWorkspaceId: f = null, defaultProjectId: p = null, defaultTenantId: S = null, storageKey: w = r, syncToUrl: T = !1, urlParams: O = i }) {
+	let [k] = v(() => E({
+		storageKey: w,
+		syncToUrl: T,
+		urlParams: O
+	})), [A, j] = v(() => typeof window > "u" ? d : k.organizationId ?? d), [M, N] = v(() => {
 		if (typeof window > "u") return f;
-		if (C) {
-			let e = o(w.workspace);
-			if (e) return e;
-		}
-		let r = s("workspace", S) || f;
+		let r = k.workspaceId ?? f;
 		if (r) {
 			let i = t();
 			if (i) {
@@ -38,145 +87,145 @@ function b({ children: u, defaultOrganizationId: d = null, defaultWorkspaceId: f
 			}
 		}
 		return r;
-	}), [k, A] = g(() => {
-		if (typeof window > "u") return b;
-		if (C) {
-			let e = o(w.project);
+	}), [P, F] = v(() => typeof window > "u" ? p : k.projectId ?? p), [I, L] = v(() => {
+		if (typeof window > "u") return S;
+		if (T) {
+			let e = o(O.tenant);
 			if (e) return e;
 		}
-		return s("project", S) || b;
-	}), [j, M] = g(() => {
-		if (typeof window > "u") return x;
-		if (C) {
-			let e = o(w.tenant);
-			if (e) return e;
-		}
-		return s("tenant", S) || x;
-	});
-	m(() => {
-		l("organization", T, S), l("workspace", D, S), l("project", k, S), l("tenant", j, S);
+		return s("tenant", w) || S;
+	}), R = _(null);
+	R.current === null && (R.current = x(A));
+	let z = _(null);
+	z.current === null && (z.current = x(M));
+	let B = _(null);
+	B.current === null && (B.current = x(P));
+	let V = _(null);
+	V.current === null && (V.current = x(I)), h(() => {
+		u("organization", A, w), u("workspace", M, w), u("project", P, w), u("tenant", I, w);
 	}, [
-		T,
-		D,
-		k,
-		j,
-		S
-	]), m(() => {
+		A,
+		M,
+		P,
+		I,
+		w
+	]), h(() => {
 		let r = t();
 		if (!r) return;
 		let i = e(r), a = {
 			...i,
-			organizationId: T,
-			workspaceId: D,
-			projectId: k,
-			tenantId: j
+			organizationId: A,
+			workspaceId: M,
+			projectId: P,
+			tenantId: I
 		};
 		i?.organizationId === a.organizationId && i?.workspaceId === a.workspaceId && i?.projectId === a.projectId && i?.tenantId === a.tenantId || n(r, a);
 	}, [
-		T,
-		D,
-		k,
-		j
-	]), m(() => {
-		C && y({
-			[w.organization]: T,
-			[w.workspace]: D,
-			[w.project]: k,
-			[w.tenant]: j
+		A,
+		M,
+		P,
+		I
+	]), h(() => {
+		T && D({
+			[O.organization]: A,
+			[O.workspace]: M,
+			[O.project]: P,
+			[O.tenant]: I
 		});
 	}, [
+		A,
+		M,
+		P,
+		I,
 		T,
-		D,
-		k,
-		j,
-		C,
-		w
-	]), m(() => {
-		if (!C) return;
+		O
+	]), h(() => {
+		if (!T) return;
 		let e = () => {
-			let e = o(w.organization), t = o(w.workspace), n = o(w.project), r = o(w.tenant);
-			e !== T && E(e), t !== D && O(t), n !== k && A(n), r !== j && M(r);
+			let e = o(O.organization), t = o(O.workspace), n = o(O.project), r = o(O.tenant);
+			e !== A && (j(e), R.current.previous = R.current.current, R.current.current = e), t !== M && (N(t), z.current.previous = z.current.current, z.current.current = t), n !== P && (F(n), B.current.previous = B.current.current, B.current.current = n), r !== I && (L(r), V.current.previous = V.current.current, V.current.current = r);
 		};
 		return window.addEventListener("popstate", e), () => window.removeEventListener("popstate", e);
 	}, [
-		C,
-		w,
 		T,
-		D,
-		k,
-		j
+		O,
+		A,
+		M,
+		P,
+		I
 	]);
-	let N = p((r) => {
-		E(r);
+	let H = m((r) => {
+		if (!C("organizationId", R.current, r, Date.now())) return;
+		j(r);
 		let i = t();
 		i && n(i, {
 			...e(i),
 			organizationId: r
 		}), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:organization-changed", { detail: { organizationId: r } }));
-	}, []), P = p((r, i) => {
+	}, []), U = m((r, i) => {
 		let a = {
 			organization: "organizationId",
 			workspace: "workspaceId",
 			project: "projectId",
 			tenant: "tenantId"
 		};
-		l(r, i, S);
+		u(r, i, w);
 		let o = t();
 		o ? n(o, {
 			...e(o),
 			[a[r]]: i
-		}) : typeof window < "u" && c(r, i, S);
-	}, [S]), F = p((e) => {
-		O(e), P("workspace", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:workspace-changed", { detail: { workspaceId: e } }));
-	}, [P]), I = p((e) => {
-		A(e), P("project", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:project-changed", { detail: { projectId: e } }));
-	}, [P]), L = p((e) => {
-		M(e), P("tenant", e);
-	}, [P]), R = p((e) => {
-		e.organizationId !== void 0 && N(e.organizationId), e.workspaceId !== void 0 && F(e.workspaceId), e.projectId !== void 0 && I(e.projectId), e.tenantId !== void 0 && L(e.tenantId);
+		}) : typeof window < "u" && l(r, i, w);
+	}, [w]), W = m((e) => {
+		C("workspaceId", z.current, e, Date.now()) && (N(e), U("workspace", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:workspace-changed", { detail: { workspaceId: e } })));
+	}, [U]), G = m((e) => {
+		C("projectId", B.current, e, Date.now()) && (F(e), U("project", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:project-changed", { detail: { projectId: e } })));
+	}, [U]), K = m((e) => {
+		C("tenantId", V.current, e, Date.now()) && (L(e), U("tenant", e));
+	}, [U]), q = m((e) => {
+		e.organizationId !== void 0 && H(e.organizationId), e.workspaceId !== void 0 && W(e.workspaceId), e.projectId !== void 0 && G(e.projectId), e.tenantId !== void 0 && K(e.tenantId);
 	}, [
-		N,
-		F,
-		I,
-		L
-	]), z = p(() => {
-		E(null), O(null), A(null), M(null), a(S);
+		H,
+		W,
+		G,
+		K
+	]), J = m(() => {
+		j(null), N(null), F(null), L(null), R.current = x(null), z.current = x(null), B.current = x(null), V.current = x(null), a(w);
 		let e = t();
 		e && n(e, {});
-	}, [S]), B = h(() => ({
-		organizationId: T,
-		workspaceId: D,
-		projectId: k,
-		tenantId: j,
-		setOrganization: N,
-		setWorkspace: F,
-		setProject: I,
-		setTenant: L,
-		setContext: R,
-		clearContext: z,
-		urlSyncEnabled: C
+	}, [w]), Y = g(() => ({
+		organizationId: A,
+		workspaceId: M,
+		projectId: P,
+		tenantId: I,
+		setOrganization: H,
+		setWorkspace: W,
+		setProject: G,
+		setTenant: K,
+		setContext: q,
+		clearContext: J,
+		urlSyncEnabled: T
 	}), [
-		T,
-		D,
-		k,
-		j,
-		N,
-		F,
+		A,
+		M,
+		P,
 		I,
-		L,
-		R,
-		z,
-		C
+		H,
+		W,
+		G,
+		K,
+		q,
+		J,
+		T
 	]);
-	return /* @__PURE__ */ _(v.Provider, {
-		value: B,
-		children: u
+	return /* @__PURE__ */ y(b.Provider, {
+		value: Y,
+		children: c
 	});
 }
-function x() {
-	let e = f(v);
+function k() {
+	let e = p(b);
 	if (!e) throw Error("useActiveContext must be used within an ActiveContextProvider");
 	return e;
 }
 //#endregion
-export { b as ActiveContextProvider, x as useActiveContext };
+export { O as ActiveContextProvider, k as useActiveContext };

package/dist/shared/providers/shell/ActiveContextStorage.d.ts

@@ -37,6 +37,31 @@ export declare function writeActiveContextStorageValue(field: ActiveContextStora
  */
 export declare function writeActiveContextFallback(field: ActiveContextStorageField, value: string | null, storageKey?: string): void;
 export declare function clearActiveContextStorage(storageKey?: string): void;
+/** zustand `persist` name used by the microfe-auth store. */
+export declare const AUTH_STORE_PERSIST_NAME = "auth-storage";
+/** The subset of the persisted auth store usable as an ActiveContext fallback. */
+export interface AuthStoreContextSnapshot {
+    organizationId: string | null;
+    workspaceId: string | null;
+    projectId: string | null;
+}
+/** localStorage key the microfe-auth store persists to for a given profile. */
+export declare function getAuthStoreStorageKey(profileId: string): string;
+/**
+ * Tolerantly parse a persisted auth-store payload. Any shape this does not
+ * recognise yields an all-null snapshot ("no fallback available"); it never
+ * throws.
+ */
+export declare function parseAuthStoreContext(raw: string | null): AuthStoreContextSnapshot;
+/**
+ * Read the persisted auth-store context for the active profile.
+ *
+ * Purely a read: unlike `readActiveContextStorageValue`, this never seeds
+ * sessionStorage or the profile context with what it finds. Profile
+ * resolution uses `resolveActiveProfileId()` — the same scheme the rest of
+ * this module uses — so the fallback can never come from another account.
+ */
+export declare function readAuthStoreContext(): AuthStoreContextSnapshot;
 export declare function readActiveContextValueWithUrlPrecedence(field: ActiveContextStorageField, options?: {
     storageKey?: string;
     urlParam?: string;

package/dist/shared/providers/shell/ActiveContextStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActiveContextStorage.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ActiveContextStorage.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,sBAAsB,CAK9E,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA6BD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,yBAAyB,EAChC,UAAU,SAA6B,GACtC,MAAM,GAAG,IAAI,CAyBf;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,yBAAyB,EAChC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,UAAU,SAA6B,GACtC,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,yBAAyB,EAChC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,UAAU,SAA6B,GACtC,IAAI,CAWN;AAED,wBAAgB,yBAAyB,CAAC,UAAU,SAA6B,GAAG,IAAI,CAUvF;AAED,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,yBAAyB,EAChC,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,yBAAyB,CACvC,UAAU,SAA6B,EACvC,SAAS,GAAE,sBAA0D,GACpE,qBAAqB,CAmBvB"}
+{"version":3,"file":"ActiveContextStorage.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ActiveContextStorage.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,sBAAsB,CAK9E,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA6BD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,yBAAyB,EAChC,UAAU,SAA6B,GACtC,MAAM,GAAG,IAAI,CAyBf;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,yBAAyB,EAChC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,UAAU,SAA6B,GACtC,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,yBAAyB,EAChC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,UAAU,SAA6B,GACtC,IAAI,CAWN;AAED,wBAAgB,yBAAyB,CAAC,UAAU,SAA6B,GAAG,IAAI,CAUvF;AAsBD,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAItD,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAeD,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,wBAAwB,CAqBlF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,wBAAwB,CAe/D;AAED,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,yBAAyB,EAChC,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,yBAAyB,CACvC,UAAU,SAA6B,EACvC,SAAS,GAAE,sBAA0D,GACpE,qBAAqB,CAmBvB"}

package/dist/shared/providers/shell/ActiveContextStorage.js

@@ -54,8 +54,49 @@ function u(e = n) {
 		sessionStorage.removeItem(n), localStorage.removeItem(n);
 	}
 }
-function d(e, t) {
+var d = "auth-storage", f = "bf-p";
+function p() {
+	return {
+		organizationId: null,
+		workspaceId: null,
+		projectId: null
+	};
+}
+function m(e) {
+	return typeof e == "object" && !!e;
+}
+function h(e, t) {
+	let n = e[t];
+	return typeof n == "string" && n.length > 0 ? n : null;
+}
+function g(e) {
+	return `${f}-${e}-${d}`;
+}
+function _(e) {
+	if (!e) return p();
+	let t;
+	try {
+		t = JSON.parse(e);
+	} catch {
+		return p();
+	}
+	return !m(t) || !m(t.state) ? p() : {
+		organizationId: h(t.state, "currentOrganizationId"),
+		workspaceId: h(t.state, "currentWorkspaceId"),
+		projectId: h(t.state, "currentProjectId")
+	};
+}
+function v() {
+	if (typeof window > "u") return p();
+	try {
+		let e = t();
+		return e ? _(localStorage.getItem(g(e))) : p();
+	} catch {
+		return p();
+	}
+}
+function y(e, t) {
 	return o(t?.urlParam ?? r[e]) || s(e, t?.storageKey ?? "burdenoff-active-context");
 }
 //#endregion
-export { n as ACTIVE_CONTEXT_STORAGE_KEY, r as DEFAULT_ACTIVE_CONTEXT_URL_PARAMS, u as clearActiveContextStorage, o as getUrlParam, s as readActiveContextStorageValue, d as readActiveContextValueWithUrlPrecedence, l as writeActiveContextFallback, c as writeActiveContextStorageValue };
+export { n as ACTIVE_CONTEXT_STORAGE_KEY, r as DEFAULT_ACTIVE_CONTEXT_URL_PARAMS, u as clearActiveContextStorage, o as getUrlParam, s as readActiveContextStorageValue, y as readActiveContextValueWithUrlPrecedence, v as readAuthStoreContext, l as writeActiveContextFallback, c as writeActiveContextStorageValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.723.5",
+  "version": "2026.725.2",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "imports": {