@enterprisestandard/react 0.0.20-beta.20260620.3 → 0.0.20-beta.20260623.1

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "@enterprisestandard/core";
+import { generateULID } from "@enterprisestandard/core";
 import { Customer, Logger } from "@enterprisestandard/core";
 import { ReactNode as ReactNode2 } from "react";
 type StorageType = "local" | "session" | "memory";
@@ -130,4 +131,20 @@ type TenantProviderProps = {
 declare function createTenantUrls(id: string, strategy?: TenantRoutingStrategy): TenantUrls;
 declare function TenantProvider({ id, strategy, children }: TenantProviderProps): React.ReactNode;
 declare function useTenant(): TenantContextValue;
-export { useTenant, useSSOContext, useOptionalSSOContext, useOptionalCIAMContext, useCIAMProviders, useCIAMContext, logoutCustomer, logout, getUser, getCustomer, createTenantUrls, UseCIAMProvidersResult, TenantProvider, SignedOut, SignedIn, SignInLoading, SSOProvider, CIAMProviderListProps, CIAMProviderList, CIAMProvider };
+import { TenantDirectoryResponse, TenantResponse } from "@enterprisestandard/core";
+type UseTenantDirectoryOptions = {
+	tenantManagerBaseUrl?: string;
+	start?: number;
+	limit?: number;
+	order?: string;
+};
+declare function useTenantDirectory<TTenant extends TenantResponse = TenantResponse>(options?: UseTenantDirectoryOptions): {
+	directory: TenantDirectoryResponse<TTenant> | null;
+	tenants: Record<string, TTenant>;
+	ids: string[];
+	items: TTenant[];
+	isLoading: boolean;
+	error: Error | null;
+	refresh: () => Promise<void>;
+};
+export { useTenantDirectory, useTenant, useSSOContext, useOptionalSSOContext, useOptionalCIAMContext, useCIAMProviders, useCIAMContext, logoutCustomer, logout, getUser, getCustomer, generateULID, createTenantUrls, UseTenantDirectoryOptions, UseCIAMProvidersResult, TenantProvider, SignedOut, SignedIn, SignInLoading, SSOProvider, CIAMProviderListProps, CIAMProviderList, CIAMProvider };

package/dist/index.js

@@ -1 +1,712 @@
-export*from"@enterprisestandard/core";import{silentLogger as X}from"@enterprisestandard/core";import{createContext as a,useCallback as w,useContext as L,useEffect as p,useState as F}from"react";import{jsx as Pn}from"react/jsx-runtime";var k=a(void 0),o=/^[a-zA-Z0-9._-]{1,1024}$/;function s(n){if(!n.trim())throw Error("CIAMProvider storageKey must be a non-empty string.");if(!o.test(n))throw Error("CIAMProvider storageKey must be 1-1024 characters and contain only letters, numbers, dots, underscores, and hyphens.")}var b=(n)=>{if(n===void 0||n==="")return"es.ciam.customer";return s(n),n};function E(n,P,A=X){if(typeof window>"u")return null;try{let R=(n==="local"?localStorage:sessionStorage).getItem(P);if(!R)return null;let M=JSON.parse(R);if(M.ciam?.expires)M.ciam.expires=new Date(M.ciam.expires);return M}catch(T){return A.error("Error loading customer from storage:",T),null}}async function c(n,P=X){try{let A=await fetch(n);if(A.status===401)return null;if(!A.ok)throw Error(`Failed to fetch customer: ${A.status} ${A.statusText}`);let T=await A.json();if(T.ciam?.expires&&typeof T.ciam.expires==="string")T.ciam.expires=new Date(T.ciam.expires);return T}catch(A){return P.error("Error fetching customer from URL:",A),null}}function r({storageKey:n,customerUrl:P,storage:A="memory",disableListener:T=!1,log:R=X,children:M}){let[Q,W]=F(null),[J,x]=F(!!P),O=b(n),z=w(()=>{if(A==="memory")return null;return E(A,O,R)},[A,O,R]),H=w((N)=>{if(A==="memory"||typeof window>"u")return;try{let I=A==="local"?localStorage:sessionStorage;if(N===null)I.removeItem(O);else I.setItem(O,JSON.stringify(N))}catch(I){R.error("Error saving customer to storage:",I)}},[A,O,R]),B=w((N)=>{W(N),H(N)},[H]),V=w(async()=>{if(!P)return;x(!0);try{let N=await c(P,R);W(N),H(N)}finally{x(!1)}},[P,H,R]);p(()=>{let N=z();if(N)W(N);if(P)V();else x(!1)},[z,P,V]),p(()=>{if(T||A==="memory")return;let N=(Z)=>{if(Z.key!==O)return;if(Z.newValue===null)W(null);else try{let q=JSON.parse(Z.newValue);if(q.ciam?.expires)q.ciam.expires=new Date(q.ciam.expires);W(q)}catch(q){R.error("Error parsing customer from storage event:",q)}},I=()=>{W(null)};return window.addEventListener("storage",N),window.addEventListener("es-ciam-logout",I),()=>{window.removeEventListener("storage",N),window.removeEventListener("es-ciam-logout",I)}},[T,A,O,R]);let _={customer:Q,setCustomer:B,isLoading:J};return Pn(k.Provider,{value:_,children:M})}function e(){let n=L(k);if(n===void 0)throw Error("useCIAMContext must be used within a CIAMProvider");return n}function $(){return L(k)}async function nn(n,P){let A=b(P),T=E("local",A);if(T)return T;let R=E("session",A);if(R)return R;if(n){let M=await c(n);if(M)return M}return}async function An(n){try{let P=await fetch(n,{headers:{Accept:"application/json"}});if(!P.ok)return{success:!1,error:`HTTP ${P.status}`};let A=await P.json();if(!A.success)return{success:!1,error:A.message||"Logout failed"};if(typeof window<"u")localStorage.removeItem("es.ciam.customer"),sessionStorage.removeItem("es.ciam.customer"),window.dispatchEvent(new CustomEvent("es-ciam-logout"));return{success:!0}}catch(P){return{success:!1,error:P instanceof Error?P.message:"Network error"}}}import{silentLogger as S}from"@enterprisestandard/core";import{useCallback as Tn,useEffect as Rn,useState as Y}from"react";import{jsx as D,jsxs as j}from"react/jsx-runtime";function y(n,P=S){let[A,T]=Y([]),[R,M]=Y(Boolean(n)),[Q,W]=Y(null),J=Tn(()=>{if(!n)return;let x=!1;return M(!0),W(null),fetch(n,{headers:{Accept:"application/json"}}).then(async(O)=>{if(!O.ok)throw Error(`Failed to fetch CIAM providers: ${O.status} ${O.statusText}`);let z=await O.json();if(!x)T(Array.isArray(z.providers)?z.providers:[])}).catch((O)=>{let z=O instanceof Error?O:Error(String(O));if(P.error("Error fetching CIAM providers:",z),!x)W(z)}).finally(()=>{if(!x)M(!1)}),()=>{x=!0}},[n,P]);return Rn(()=>{return J()},[J]),{providers:A,isLoading:R,error:Q,refresh:J}}function Mn(n,P){return{display:"flex",alignItems:"center",gap:"0.5rem",width:"100%",padding:"0.625rem 0.875rem",border:"1px solid rgba(0,0,0,0.15)",borderRadius:"0.5rem",background:(P==="dark"?n.colors?.dark:n.colors?.light)??(P==="dark"?"#1f1f1f":"#ffffff"),color:P==="dark"?"#ffffff":"#111111",textDecoration:"none",font:"inherit",cursor:"pointer"}}function Nn({providersUrl:n,limit:P,theme:A="light",renderProvider:T,loadingFallback:R,emptyFallback:M,moreLabel:Q="Show more",className:W,log:J=S}){let{providers:x,isLoading:O}=y(n,J),[z,H]=Y(!1);if(O)return R??null;if(x.length===0)return M??null;let B=!z&&typeof P==="number"&&P>0?x.slice(0,P):x,V=B.length<x.length;return j("div",{className:W,style:{display:"flex",flexDirection:"column",gap:"0.5rem"},"data-es-ciam-providers":"",children:[B.map((_)=>T?D("span",{children:T(_)},_.name):j("a",{href:_.loginUrl,style:Mn(_,A),"data-es-ciam-provider":_.name,children:[_.iconUrl?D("img",{src:_.iconUrl,alt:"",width:20,height:20,"aria-hidden":"true"}):null,j("span",{children:["Continue with ",_.displayName]})]},_.name)),V?D("button",{type:"button",onClick:()=>H(!0),"data-es-ciam-show-more":"",children:Q}):null]})}import{silentLogger as i}from"@enterprisestandard/core";import{createContext as On,useCallback as G,useContext as v,useEffect as K,useState as u}from"react";import{jsx as Hn}from"react/jsx-runtime";var h=On(void 0),Wn=/^[a-zA-Z0-9._-]{1,1024}$/;function xn(n){if(!n.trim())throw Error("SSOProvider storageKey must be a non-empty string.");if(!Wn.test(n))throw Error("SSOProvider storageKey must be 1-1024 characters and contain only letters, numbers, dots, underscores, and hyphens.")}var U=(n)=>{if(n===void 0||n==="")return"es.sso.user";return xn(n),n};function C(n,P,A=i){if(typeof window>"u")return null;try{let R=(n==="local"?localStorage:sessionStorage).getItem(P);if(!R)return null;let M=JSON.parse(R);if(M.sso?.expires)M.sso.expires=new Date(M.sso.expires);return M}catch(T){return A.error("Error loading user from storage:",T),null}}async function m(n,P=i){try{let A=await fetch(n);if(A.status===401)return null;if(!A.ok)throw Error(`Failed to fetch user: ${A.status} ${A.statusText}`);let T=await A.json();if(T.sso?.expires&&typeof T.sso.expires==="string")T.sso.expires=new Date(T.sso.expires);return T}catch(A){return P.error("Error fetching user from URL:",A),null}}function In({storageKey:n,userUrl:P,storage:A="memory",disableListener:T=!1,log:R=i,children:M}){let[Q,W]=u(null),[J,x]=u(!!P),O=U(n),z=G(()=>{if(A==="memory")return null;return C(A,O,R)},[A,O,R]),H=G((N)=>{if(A==="memory"||typeof window>"u")return;try{let I=A==="local"?localStorage:sessionStorage;if(N===null)I.removeItem(O);else I.setItem(O,JSON.stringify(N))}catch(I){R.error("Error saving user to storage:",I)}},[A,O,R]),B=G((N)=>{W(N),H(N)},[H]),V=G(async()=>{if(!P)return;x(!0);try{let N=await m(P,R);W(N),H(N)}finally{x(!1)}},[P,H,R]);K(()=>{let N=z();if(N)W(N);if(P)V();else x(!1)},[z,P,V]),K(()=>{if(T||A==="memory")return;let N=(Z)=>{if(Z.key!==O)return;if(Z.newValue===null)W(null);else try{let q=JSON.parse(Z.newValue);if(q.sso?.expires)q.sso.expires=new Date(q.sso.expires);W(q)}catch(q){R.error("Error parsing user from storage event:",q)}},I=()=>{W(null)};return window.addEventListener("storage",N),window.addEventListener("es-sso-logout",I),()=>{window.removeEventListener("storage",N),window.removeEventListener("es-sso-logout",I)}},[T,A,O,R]);let _={user:Q,setUser:B,isLoading:J};return Hn(h.Provider,{value:_,children:M})}function zn(){let n=v(h);if(n===void 0)throw Error("useSSOContext must be used within a SSOProvider");return n}function f(){return v(h)}async function _n(n,P){let A=U(P),T=C("local",A);if(T)return T;let R=C("session",A);if(R)return R;if(n){let M=await m(n);if(M)return M}return}async function qn(n){try{let P=await fetch(n,{headers:{Accept:"application/json"}});if(!P.ok)return{success:!1,error:`HTTP ${P.status}`};let A=await P.json();if(!A.success)return{success:!1,error:A.message||"Logout failed"};if(typeof window<"u")localStorage.removeItem("es.sso.user"),sessionStorage.removeItem("es.sso.user"),window.dispatchEvent(new CustomEvent("es-sso-logout"));return{success:!0}}catch(P){return{success:!1,error:P instanceof Error?P.message:"Network error"}}}import{jsx as Vn,Fragment as Qn}from"react/jsx-runtime";function Jn({complete:n=!1,audience:P="workforce",children:A}){let T=f(),R=$();if((P==="customer"?!!R?.isLoading:!!T?.isLoading)&&!n)return Vn(Qn,{children:A});return null}import{jsx as fn,Fragment as $n}from"react/jsx-runtime";function Zn({audience:n="workforce",children:P}){let A=f(),T=$();if(n==="customer"?!!T?.customer:!!A?.user)return fn($n,{children:P});return null}import{jsx as Yn,Fragment as wn}from"react/jsx-runtime";function Bn({audience:n="workforce",children:P}){let A=f(),T=$(),R=n==="customer"?!!T?.customer:!!A?.user,M=n==="customer"?!!T?.isLoading:!!A?.isLoading;if(R||M)return null;return Yn(wn,{children:P})}import{buildTenantPath as d,DEFAULT_TENANT_API_NAMESPACE as Gn,DEFAULT_TENANT_UI_NAMESPACE as En,normalizeTenantRoutingStrategy as l}from"@enterprisestandard/core";import{createContext as Xn,useContext as kn,useMemo as Dn}from"react";import{jsx as hn}from"react/jsx-runtime";var g=Xn(null);function t(n,P){let A=l(P),T=A.ui??En,R=A.api??Gn;return{ui:(M="/")=>d(n,M,T),api:(M="/")=>d(n,M,R)}}function jn({id:n,strategy:P,children:A}){let T=Dn(()=>{let R=l(P);return{id:n,strategy:R,urls:t(n,R)}},[P,n]);return hn(g.Provider,{value:T,children:A})}function Cn(){let n=kn(g);if(!n)throw Error("useTenant() must be used within a TenantProvider");return n}export{Cn as useTenant,zn as useSSOContext,f as useOptionalSSOContext,$ as useOptionalCIAMContext,y as useCIAMProviders,e as useCIAMContext,An as logoutCustomer,qn as logout,_n as getUser,nn as getCustomer,t as createTenantUrls,jn as TenantProvider,Bn as SignedOut,Zn as SignedIn,Jn as SignInLoading,In as SSOProvider,Nn as CIAMProviderList,r as CIAMProvider};
+// packages/react/src/index.ts
+export * from "@enterprisestandard/core";
+import { generateULID } from "@enterprisestandard/core";
+
+// packages/react/src/ciam-provider.tsx
+import { silentLogger } from "@enterprisestandard/core";
+import { createContext, useCallback, useContext, useEffect, useState } from "react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+var CTX = createContext(undefined);
+var VALID_STORAGE_KEY = /^[a-zA-Z0-9._-]{1,1024}$/;
+function validateStorageKey(key) {
+  if (!key.trim()) {
+    throw new Error("CIAMProvider storageKey must be a non-empty string.");
+  }
+  if (!VALID_STORAGE_KEY.test(key)) {
+    throw new Error("CIAMProvider storageKey must be 1-1024 characters and contain only letters, numbers, dots, underscores, and hyphens.");
+  }
+}
+var getStorageKey = (storageKey) => {
+  if (storageKey === undefined || storageKey === "") {
+    return "es.ciam.customer";
+  }
+  validateStorageKey(storageKey);
+  return storageKey;
+};
+function loadCustomerFromStorageForKey(storage, storageKey, log = silentLogger) {
+  if (typeof window === "undefined")
+    return null;
+  try {
+    const storageObject = storage === "local" ? localStorage : sessionStorage;
+    const customerData = storageObject.getItem(storageKey);
+    if (!customerData)
+      return null;
+    const parsedCustomer = JSON.parse(customerData);
+    if (parsedCustomer.ciam?.expires) {
+      parsedCustomer.ciam.expires = new Date(parsedCustomer.ciam.expires);
+    }
+    return parsedCustomer;
+  } catch (error) {
+    log.error("Error loading customer from storage:", error);
+    return null;
+  }
+}
+async function fetchCustomerFromServer(customerUrl, log = silentLogger) {
+  try {
+    const response = await fetch(customerUrl);
+    if (response.status === 401) {
+      return null;
+    }
+    if (!response.ok) {
+      throw new Error(`Failed to fetch customer: ${response.status} ${response.statusText}`);
+    }
+    const customerData = await response.json();
+    if (customerData.ciam?.expires && typeof customerData.ciam.expires === "string") {
+      customerData.ciam.expires = new Date(customerData.ciam.expires);
+    }
+    return customerData;
+  } catch (error) {
+    log.error("Error fetching customer from URL:", error);
+    return null;
+  }
+}
+function CIAMProvider({
+  storageKey: storageKeyProp,
+  customerUrl,
+  storage = "memory",
+  disableListener = false,
+  log = silentLogger,
+  children
+}) {
+  const [customer, setCustomerState] = useState(null);
+  const [isLoading, setIsLoading] = useState(!!customerUrl);
+  const storageKey = getStorageKey(storageKeyProp);
+  const loadCustomerFromStorage = useCallback(() => {
+    if (storage === "memory")
+      return null;
+    return loadCustomerFromStorageForKey(storage, storageKey, log);
+  }, [storage, storageKey, log]);
+  const saveCustomerToStorage = useCallback((customer2) => {
+    if (storage === "memory" || typeof window === "undefined")
+      return;
+    try {
+      const storageObject = storage === "local" ? localStorage : sessionStorage;
+      if (customer2 === null) {
+        storageObject.removeItem(storageKey);
+      } else {
+        storageObject.setItem(storageKey, JSON.stringify(customer2));
+      }
+    } catch (error) {
+      log.error("Error saving customer to storage:", error);
+    }
+  }, [storage, storageKey, log]);
+  const setCustomer = useCallback((newCustomer) => {
+    setCustomerState(newCustomer);
+    saveCustomerToStorage(newCustomer);
+  }, [saveCustomerToStorage]);
+  const fetchCustomerFromUrl = useCallback(async () => {
+    if (!customerUrl)
+      return;
+    setIsLoading(true);
+    try {
+      const customerData = await fetchCustomerFromServer(customerUrl, log);
+      setCustomerState(customerData);
+      saveCustomerToStorage(customerData);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [customerUrl, saveCustomerToStorage, log]);
+  useEffect(() => {
+    const storedCustomer = loadCustomerFromStorage();
+    if (storedCustomer) {
+      setCustomerState(storedCustomer);
+    }
+    if (customerUrl) {
+      fetchCustomerFromUrl();
+    } else {
+      setIsLoading(false);
+    }
+  }, [loadCustomerFromStorage, customerUrl, fetchCustomerFromUrl]);
+  useEffect(() => {
+    if (disableListener || storage === "memory")
+      return;
+    const handleStorageChange = (event) => {
+      if (event.key !== storageKey)
+        return;
+      if (event.newValue === null) {
+        setCustomerState(null);
+      } else {
+        try {
+          const parsedCustomer = JSON.parse(event.newValue);
+          if (parsedCustomer.ciam?.expires) {
+            parsedCustomer.ciam.expires = new Date(parsedCustomer.ciam.expires);
+          }
+          setCustomerState(parsedCustomer);
+        } catch (error) {
+          log.error("Error parsing customer from storage event:", error);
+        }
+      }
+    };
+    const handleLogout = () => {
+      setCustomerState(null);
+    };
+    window.addEventListener("storage", handleStorageChange);
+    window.addEventListener("es-ciam-logout", handleLogout);
+    return () => {
+      window.removeEventListener("storage", handleStorageChange);
+      window.removeEventListener("es-ciam-logout", handleLogout);
+    };
+  }, [disableListener, storage, storageKey, log]);
+  const contextValue = {
+    customer,
+    setCustomer,
+    isLoading
+  };
+  return /* @__PURE__ */ jsxDEV(CTX.Provider, {
+    value: contextValue,
+    children
+  }, undefined, false, undefined, this);
+}
+function useCIAMContext() {
+  const context = useContext(CTX);
+  if (context === undefined) {
+    throw new Error("useCIAMContext must be used within a CIAMProvider");
+  }
+  return context;
+}
+function useOptionalCIAMContext() {
+  return useContext(CTX);
+}
+async function getCustomer(customerUrl, storageKey) {
+  const key = getStorageKey(storageKey);
+  const fromLocal = loadCustomerFromStorageForKey("local", key);
+  if (fromLocal)
+    return fromLocal;
+  const fromSession = loadCustomerFromStorageForKey("session", key);
+  if (fromSession)
+    return fromSession;
+  if (customerUrl) {
+    const fromServer = await fetchCustomerFromServer(customerUrl);
+    if (fromServer)
+      return fromServer;
+  }
+  return;
+}
+async function logoutCustomer(logoutUrl) {
+  try {
+    const response = await fetch(logoutUrl, {
+      headers: { Accept: "application/json" }
+    });
+    if (!response.ok) {
+      return { success: false, error: `HTTP ${response.status}` };
+    }
+    const data = await response.json();
+    if (!data.success) {
+      return { success: false, error: data.message || "Logout failed" };
+    }
+    if (typeof window !== "undefined") {
+      localStorage.removeItem("es.ciam.customer");
+      sessionStorage.removeItem("es.ciam.customer");
+      window.dispatchEvent(new CustomEvent("es-ciam-logout"));
+    }
+    return { success: true };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Network error"
+    };
+  }
+}
+// packages/react/src/ciam-providers.tsx
+import { silentLogger as silentLogger2 } from "@enterprisestandard/core";
+import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+function useCIAMProviders(providersUrl, log = silentLogger2) {
+  const [providers, setProviders] = useState2([]);
+  const [isLoading, setIsLoading] = useState2(Boolean(providersUrl));
+  const [error, setError] = useState2(null);
+  const refresh = useCallback2(() => {
+    if (!providersUrl)
+      return;
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    fetch(providersUrl, { headers: { Accept: "application/json" } }).then(async (response) => {
+      if (!response.ok) {
+        throw new Error(`Failed to fetch CIAM providers: ${response.status} ${response.statusText}`);
+      }
+      const data = await response.json();
+      if (!cancelled)
+        setProviders(Array.isArray(data.providers) ? data.providers : []);
+    }).catch((err) => {
+      const normalized = err instanceof Error ? err : new Error(String(err));
+      log.error("Error fetching CIAM providers:", normalized);
+      if (!cancelled)
+        setError(normalized);
+    }).finally(() => {
+      if (!cancelled)
+        setIsLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [providersUrl, log]);
+  useEffect2(() => {
+    const cleanup = refresh();
+    return cleanup;
+  }, [refresh]);
+  return { providers, isLoading, error, refresh };
+}
+function providerButtonStyle(provider, theme) {
+  const background = theme === "dark" ? provider.colors?.dark : provider.colors?.light;
+  return {
+    display: "flex",
+    alignItems: "center",
+    gap: "0.5rem",
+    width: "100%",
+    padding: "0.625rem 0.875rem",
+    border: "1px solid rgba(0,0,0,0.15)",
+    borderRadius: "0.5rem",
+    background: background ?? (theme === "dark" ? "#1f1f1f" : "#ffffff"),
+    color: theme === "dark" ? "#ffffff" : "#111111",
+    textDecoration: "none",
+    font: "inherit",
+    cursor: "pointer"
+  };
+}
+function CIAMProviderList({
+  providersUrl,
+  limit,
+  theme = "light",
+  renderProvider,
+  loadingFallback,
+  emptyFallback,
+  moreLabel = "Show more",
+  className,
+  log = silentLogger2
+}) {
+  const { providers, isLoading } = useCIAMProviders(providersUrl, log);
+  const [expanded, setExpanded] = useState2(false);
+  if (isLoading) {
+    return loadingFallback ?? null;
+  }
+  if (providers.length === 0) {
+    return emptyFallback ?? null;
+  }
+  const visible = !expanded && typeof limit === "number" && limit > 0 ? providers.slice(0, limit) : providers;
+  const hasMore = visible.length < providers.length;
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className,
+    style: { display: "flex", flexDirection: "column", gap: "0.5rem" },
+    "data-es-ciam-providers": "",
+    children: [
+      visible.map((provider) => renderProvider ? /* @__PURE__ */ jsxDEV2("span", {
+        children: renderProvider(provider)
+      }, provider.name, false, undefined, this) : /* @__PURE__ */ jsxDEV2("a", {
+        href: provider.loginUrl,
+        style: providerButtonStyle(provider, theme),
+        "data-es-ciam-provider": provider.name,
+        children: [
+          provider.iconUrl ? /* @__PURE__ */ jsxDEV2("img", {
+            src: provider.iconUrl,
+            alt: "",
+            width: 20,
+            height: 20,
+            "aria-hidden": "true"
+          }, undefined, false, undefined, this) : null,
+          /* @__PURE__ */ jsxDEV2("span", {
+            children: [
+              "Continue with ",
+              provider.displayName
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, provider.name, true, undefined, this)),
+      hasMore ? /* @__PURE__ */ jsxDEV2("button", {
+        type: "button",
+        onClick: () => setExpanded(true),
+        "data-es-ciam-show-more": "",
+        children: moreLabel
+      }, undefined, false, undefined, this) : null
+    ]
+  }, undefined, true, undefined, this);
+}
+// packages/react/src/sso-provider.tsx
+import { silentLogger as silentLogger3 } from "@enterprisestandard/core";
+import { createContext as createContext2, useCallback as useCallback3, useContext as useContext2, useEffect as useEffect3, useState as useState3 } from "react";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+var CTX2 = createContext2(undefined);
+var VALID_STORAGE_KEY2 = /^[a-zA-Z0-9._-]{1,1024}$/;
+function validateStorageKey2(key) {
+  if (!key.trim()) {
+    throw new Error("SSOProvider storageKey must be a non-empty string.");
+  }
+  if (!VALID_STORAGE_KEY2.test(key)) {
+    throw new Error("SSOProvider storageKey must be 1-1024 characters and contain only letters, numbers, dots, underscores, and hyphens.");
+  }
+}
+var getStorageKey2 = (storageKey) => {
+  if (storageKey === undefined || storageKey === "") {
+    return "es.sso.user";
+  }
+  validateStorageKey2(storageKey);
+  return storageKey;
+};
+function loadUserFromStorageForKey(storage, storageKey, log = silentLogger3) {
+  if (typeof window === "undefined")
+    return null;
+  try {
+    const storageObject = storage === "local" ? localStorage : sessionStorage;
+    const userData = storageObject.getItem(storageKey);
+    if (!userData)
+      return null;
+    const parsedUser = JSON.parse(userData);
+    if (parsedUser.sso?.expires) {
+      parsedUser.sso.expires = new Date(parsedUser.sso.expires);
+    }
+    return parsedUser;
+  } catch (error) {
+    log.error("Error loading user from storage:", error);
+    return null;
+  }
+}
+async function fetchUserFromServer(userUrl, log = silentLogger3) {
+  try {
+    const response = await fetch(userUrl);
+    if (response.status === 401) {
+      return null;
+    }
+    if (!response.ok) {
+      throw new Error(`Failed to fetch user: ${response.status} ${response.statusText}`);
+    }
+    const userData = await response.json();
+    if (userData.sso?.expires && typeof userData.sso.expires === "string") {
+      userData.sso.expires = new Date(userData.sso.expires);
+    }
+    return userData;
+  } catch (error) {
+    log.error("Error fetching user from URL:", error);
+    return null;
+  }
+}
+function SSOProvider({
+  storageKey: storageKeyProp,
+  userUrl,
+  storage = "memory",
+  disableListener = false,
+  log = silentLogger3,
+  children
+}) {
+  const [user, setUserState] = useState3(null);
+  const [isLoading, setIsLoading] = useState3(!!userUrl);
+  const storageKey = getStorageKey2(storageKeyProp);
+  const loadUserFromStorage = useCallback3(() => {
+    if (storage === "memory")
+      return null;
+    return loadUserFromStorageForKey(storage, storageKey, log);
+  }, [storage, storageKey, log]);
+  const saveUserToStorage = useCallback3((user2) => {
+    if (storage === "memory" || typeof window === "undefined")
+      return;
+    try {
+      const storageObject = storage === "local" ? localStorage : sessionStorage;
+      if (user2 === null) {
+        storageObject.removeItem(storageKey);
+      } else {
+        storageObject.setItem(storageKey, JSON.stringify(user2));
+      }
+    } catch (error) {
+      log.error("Error saving user to storage:", error);
+    }
+  }, [storage, storageKey, log]);
+  const setUser = useCallback3((newUser) => {
+    setUserState(newUser);
+    saveUserToStorage(newUser);
+  }, [saveUserToStorage]);
+  const fetchUserFromUrl = useCallback3(async () => {
+    if (!userUrl)
+      return;
+    setIsLoading(true);
+    try {
+      const userData = await fetchUserFromServer(userUrl, log);
+      setUserState(userData);
+      saveUserToStorage(userData);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [userUrl, saveUserToStorage, log]);
+  useEffect3(() => {
+    const storedUser = loadUserFromStorage();
+    if (storedUser) {
+      setUserState(storedUser);
+    }
+    if (userUrl) {
+      fetchUserFromUrl();
+    } else {
+      setIsLoading(false);
+    }
+  }, [loadUserFromStorage, userUrl, fetchUserFromUrl]);
+  useEffect3(() => {
+    if (disableListener || storage === "memory")
+      return;
+    const handleStorageChange = (event) => {
+      if (event.key !== storageKey)
+        return;
+      if (event.newValue === null) {
+        setUserState(null);
+      } else {
+        try {
+          const parsedUser = JSON.parse(event.newValue);
+          if (parsedUser.sso?.expires) {
+            parsedUser.sso.expires = new Date(parsedUser.sso.expires);
+          }
+          setUserState(parsedUser);
+        } catch (error) {
+          log.error("Error parsing user from storage event:", error);
+        }
+      }
+    };
+    const handleLogout = () => {
+      setUserState(null);
+    };
+    window.addEventListener("storage", handleStorageChange);
+    window.addEventListener("es-sso-logout", handleLogout);
+    return () => {
+      window.removeEventListener("storage", handleStorageChange);
+      window.removeEventListener("es-sso-logout", handleLogout);
+    };
+  }, [disableListener, storage, storageKey, log]);
+  const contextValue = {
+    user,
+    setUser,
+    isLoading
+  };
+  return /* @__PURE__ */ jsxDEV3(CTX2.Provider, {
+    value: contextValue,
+    children
+  }, undefined, false, undefined, this);
+}
+function useSSOContext() {
+  const context = useContext2(CTX2);
+  if (context === undefined) {
+    throw new Error("useSSOContext must be used within a SSOProvider");
+  }
+  return context;
+}
+function useOptionalSSOContext() {
+  return useContext2(CTX2);
+}
+async function getUser(userUrl, storageKey) {
+  const key = getStorageKey2(storageKey);
+  const fromLocal = loadUserFromStorageForKey("local", key);
+  if (fromLocal)
+    return fromLocal;
+  const fromSession = loadUserFromStorageForKey("session", key);
+  if (fromSession)
+    return fromSession;
+  if (userUrl) {
+    const fromServer = await fetchUserFromServer(userUrl);
+    if (fromServer)
+      return fromServer;
+  }
+  return;
+}
+async function logout(logoutUrl) {
+  try {
+    const response = await fetch(logoutUrl, {
+      headers: { Accept: "application/json" }
+    });
+    if (!response.ok) {
+      return { success: false, error: `HTTP ${response.status}` };
+    }
+    const data = await response.json();
+    if (!data.success) {
+      return { success: false, error: data.message || "Logout failed" };
+    }
+    if (typeof window !== "undefined") {
+      localStorage.removeItem("es.sso.user");
+      sessionStorage.removeItem("es.sso.user");
+      window.dispatchEvent(new CustomEvent("es-sso-logout"));
+    }
+    return { success: true };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Network error"
+    };
+  }
+}
+
+// packages/react/src/sign-in-loading.tsx
+import { jsxDEV as jsxDEV4, Fragment } from "react/jsx-dev-runtime";
+function SignInLoading({
+  complete = false,
+  audience = "workforce",
+  children
+}) {
+  const sso = useOptionalSSOContext();
+  const ciam = useOptionalCIAMContext();
+  const isLoading = audience === "customer" ? !!ciam?.isLoading : !!sso?.isLoading;
+  if (isLoading && !complete)
+    return /* @__PURE__ */ jsxDEV4(Fragment, {
+      children
+    }, undefined, false, undefined, this);
+  return null;
+}
+// packages/react/src/signed-in.tsx
+import { jsxDEV as jsxDEV5, Fragment as Fragment2 } from "react/jsx-dev-runtime";
+function SignedIn({
+  audience = "workforce",
+  children
+}) {
+  const sso = useOptionalSSOContext();
+  const ciam = useOptionalCIAMContext();
+  const present = audience === "customer" ? !!ciam?.customer : !!sso?.user;
+  if (present)
+    return /* @__PURE__ */ jsxDEV5(Fragment2, {
+      children
+    }, undefined, false, undefined, this);
+  return null;
+}
+// packages/react/src/signed-out.tsx
+import { jsxDEV as jsxDEV6, Fragment as Fragment3 } from "react/jsx-dev-runtime";
+function SignedOut({
+  audience = "workforce",
+  children
+}) {
+  const sso = useOptionalSSOContext();
+  const ciam = useOptionalCIAMContext();
+  const present = audience === "customer" ? !!ciam?.customer : !!sso?.user;
+  const isLoading = audience === "customer" ? !!ciam?.isLoading : !!sso?.isLoading;
+  if (present || isLoading)
+    return null;
+  return /* @__PURE__ */ jsxDEV6(Fragment3, {
+    children
+  }, undefined, false, undefined, this);
+}
+// packages/react/src/tenant-context.tsx
+import {
+  buildTenantPath,
+  DEFAULT_TENANT_API_NAMESPACE,
+  DEFAULT_TENANT_UI_NAMESPACE,
+  normalizeTenantRoutingStrategy
+} from "@enterprisestandard/core";
+import { createContext as createContext3, useContext as useContext3, useMemo } from "react";
+import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
+var TenantContext = createContext3(null);
+function createTenantUrls(id, strategy) {
+  const normalized = normalizeTenantRoutingStrategy(strategy);
+  if (normalized.type === "jwt") {
+    const uiSegments = normalized.ui?.segments ?? [];
+    const apiSegments = normalized.api?.segments ?? ["api"];
+    return {
+      ui: (restPath = "/") => buildStaticPath(uiSegments, restPath),
+      api: (restPath = "/") => buildStaticPath(apiSegments, restPath)
+    };
+  }
+  const uiNamespace = normalized.ui ?? DEFAULT_TENANT_UI_NAMESPACE;
+  const apiNamespace = normalized.api ?? DEFAULT_TENANT_API_NAMESPACE;
+  return {
+    ui: (restPath = "/") => buildTenantPath(id, restPath, uiNamespace),
+    api: (restPath = "/") => buildTenantPath(id, restPath, apiNamespace)
+  };
+}
+function buildStaticPath(prefixSegments, restPath = "/") {
+  const prefix = prefixSegments.join("/");
+  const rest = restPath.trim().replace(/^\/+/, "");
+  if (!prefix && !rest)
+    return "/";
+  if (!prefix)
+    return `/${rest}`;
+  if (!rest)
+    return `/${prefix}`;
+  return `/${prefix}/${rest}`;
+}
+function TenantProvider({ id, strategy, children }) {
+  const value = useMemo(() => {
+    const normalized = normalizeTenantRoutingStrategy(strategy);
+    return {
+      id,
+      strategy: normalized,
+      urls: createTenantUrls(id, normalized)
+    };
+  }, [strategy, id]);
+  return /* @__PURE__ */ jsxDEV7(TenantContext.Provider, {
+    value,
+    children
+  }, undefined, false, undefined, this);
+}
+function useTenant() {
+  const value = useContext3(TenantContext);
+  if (!value) {
+    throw new Error("useTenant() must be used within a TenantProvider");
+  }
+  return value;
+}
+// packages/react/src/use-tenant-directory.ts
+import { useCallback as useCallback4, useEffect as useEffect4, useMemo as useMemo2, useState as useState4 } from "react";
+function useTenantDirectory(options = {}) {
+  const tenantManagerBaseUrl = options.tenantManagerBaseUrl ?? "/api/tenants/mine";
+  const [directory, setDirectory] = useState4(null);
+  const [isLoading, setIsLoading] = useState4(true);
+  const [error, setError] = useState4(null);
+  const requestUrl = useMemo2(() => {
+    const url = new URL(tenantManagerBaseUrl, "http://localhost");
+    if (options.start != null) {
+      url.searchParams.set("start", String(options.start));
+    }
+    if (options.limit != null) {
+      url.searchParams.set("limit", String(options.limit));
+    }
+    if (options.order) {
+      url.searchParams.set("order", options.order);
+    }
+    return `${url.pathname}${url.search}`;
+  }, [options.limit, options.order, options.start, tenantManagerBaseUrl]);
+  const refresh = useCallback4(async () => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const response = await fetch(requestUrl);
+      if (!response.ok) {
+        setDirectory(null);
+        setError(new Error(`Tenant directory request failed with status ${response.status}`));
+        return;
+      }
+      const data = await response.json();
+      setDirectory(data);
+    } catch (cause) {
+      setDirectory(null);
+      setError(cause instanceof Error ? cause : new Error("Failed to load tenant directory"));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [requestUrl]);
+  useEffect4(() => {
+    refresh();
+  }, [refresh]);
+  const tenants = directory?.tenants ?? {};
+  const ids = directory?.ids ?? [];
+  const items = ids.map((id) => tenants[id]).filter((tenant) => !!tenant);
+  return {
+    directory,
+    tenants,
+    ids,
+    items,
+    isLoading,
+    error,
+    refresh
+  };
+}
+export {
+  useTenantDirectory,
+  useTenant,
+  useSSOContext,
+  useOptionalSSOContext,
+  useOptionalCIAMContext,
+  useCIAMProviders,
+  useCIAMContext,
+  logoutCustomer,
+  logout,
+  getUser,
+  getCustomer,
+  generateULID,
+  createTenantUrls,
+  TenantProvider,
+  SignedOut,
+  SignedIn,
+  SignInLoading,
+  SSOProvider,
+  CIAMProviderList,
+  CIAMProvider
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enterprisestandard/react",
-  "version": "0.0.20-beta.20260620.3",
+  "version": "0.0.20-beta.20260623.1",
   "description": "Enterprise Standard React Components",
   "private": false,
   "author": "enterprisestandard",
@@ -22,10 +22,10 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@enterprisestandard/core": "0.0.20-beta.20260620.3"
+    "@enterprisestandard/core": "0.0.20-beta.20260623.1"
   },
   "peerDependencies": {
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   }
 }