@easygov/react-components 0.2.6 → 0.2.7

package/dist/easygov.d.mts

@@ -263,6 +263,25 @@ interface SessionUser {
     sub: string;
     name: string;
 }
+/**
+ * Lifecycle status of the OIDC session, orthogonal to the `current` payload.
+ *
+ * A route guard must key off this — NOT `user === null` — because a null user is
+ * ambiguous: it occurs during logout, token renewal, and a silent-renew blip, none
+ * of which mean "genuinely logged out". Only `unauthenticated` is a settled
+ * logged-out state that is safe to react to with a login redirect.
+ *
+ * - `initializing`   — initSession() has not resolved yet.
+ * - `authenticated`  — a valid session is present.
+ * - `renewing`       — the access token expired / a silent renew is running; the
+ *                      previous session is kept until the renew resolves.
+ * - `signing-in`     — requireSession() issued a login redirect; navigation pending.
+ * - `signing-out`    — signOut() issued a logout redirect; navigation pending.
+ * - `unauthenticated`— settled logged out. THE ONLY state that warrants a login redirect.
+ * - `no-auth`        — no OIDC authority configured / UserManager construction failed.
+ */
+type AuthStatus = 'initializing' | 'authenticated' | 'renewing' | 'signing-in' | 'signing-out' | 'unauthenticated' | 'no-auth';
+declare function getAuthStatus(): AuthStatus;
 declare function requireSession(): void;
 
 declare const dictionaries: {
@@ -310,6 +329,7 @@ interface EasygovSession {
     accessToken: string | null;
 }
 declare function useEasygovSession(): EasygovSession;
+declare function useEasygovAuthStatus(): AuthStatus;
 interface EasygovHeaderProps {
     readonly locale?: Locale;
     readonly onLanguageChange?: (locale: Locale) => void;
@@ -323,4 +343,4 @@ interface RequireSessionProps {
 }
 declare function RequireSession({ children, fallback, loading, }: RequireSessionProps): React__default.JSX.Element;
 
-export { BrandBase, BrandEasygov, BrandFacebook, BrandKdk, BrandLinkedin, type BrandProps, BrandSeg, BrandSgv, BrandSsv, BrandSwiss, BrandXing, BrandYoutube, Button, type ButtonProps, type DesktopSpan, Dropdown, DropdownChip, DropdownChipsOverflow, type DropdownChipsOverflowProps, DropdownChipsTrigger, type DropdownChipsTriggerProps, DropdownCollection, DropdownEmpty, DropdownGroup, DropdownGroupLabel, DropdownHelperText, type DropdownHelperTextProps, DropdownInput, DropdownItem, type DropdownItemProps, DropdownItemText, DropdownLabel, type DropdownLabelProps, DropdownList, DropdownPopup, type DropdownPopupProps, DropdownSeparator, DropdownToggle, DropdownTrigger, type DropdownTriggerProps, DropdownValue, EasygovFooter, EasygovHeader, type EasygovHeaderProps, type EasygovSession, Grid, GridItem, type GridItemProps, type GridProps, Input, type InputProps, type Locale, type MobileSpan, NavigationMenu, NavigationMenuAnchor, type NavigationMenuAnchorProps, NavigationMenuContent, type NavigationMenuContentProps, NavigationMenuItem, type NavigationMenuItemProps, NavigationMenuLink, type NavigationMenuLinkProps, NavigationMenuList, type NavigationMenuListProps, type NavigationMenuProps, NavigationMenuTrigger, type NavigationMenuTriggerProps, RequireSession, type RequireSessionProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectGroupLabel, type SelectGroupLabelProps, SelectHelperText, type SelectHelperTextProps, SelectItem, type SelectItemProps, SelectLabel, type SelectLabelProps, SelectSeparator, type SelectSeparatorProps, SelectTrigger, type SelectTriggerProps, type SessionUser, type TabletSpan, TextLink, type TextLinkProps, buttonVariants, requireSession, textLinkVariants, useEasygovSession };
+export { type AuthStatus, BrandBase, BrandEasygov, BrandFacebook, BrandKdk, BrandLinkedin, type BrandProps, BrandSeg, BrandSgv, BrandSsv, BrandSwiss, BrandXing, BrandYoutube, Button, type ButtonProps, type DesktopSpan, Dropdown, DropdownChip, DropdownChipsOverflow, type DropdownChipsOverflowProps, DropdownChipsTrigger, type DropdownChipsTriggerProps, DropdownCollection, DropdownEmpty, DropdownGroup, DropdownGroupLabel, DropdownHelperText, type DropdownHelperTextProps, DropdownInput, DropdownItem, type DropdownItemProps, DropdownItemText, DropdownLabel, type DropdownLabelProps, DropdownList, DropdownPopup, type DropdownPopupProps, DropdownSeparator, DropdownToggle, DropdownTrigger, type DropdownTriggerProps, DropdownValue, EasygovFooter, EasygovHeader, type EasygovHeaderProps, type EasygovSession, Grid, GridItem, type GridItemProps, type GridProps, Input, type InputProps, type Locale, type MobileSpan, NavigationMenu, NavigationMenuAnchor, type NavigationMenuAnchorProps, NavigationMenuContent, type NavigationMenuContentProps, NavigationMenuItem, type NavigationMenuItemProps, NavigationMenuLink, type NavigationMenuLinkProps, NavigationMenuList, type NavigationMenuListProps, type NavigationMenuProps, NavigationMenuTrigger, type NavigationMenuTriggerProps, RequireSession, type RequireSessionProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectGroupLabel, type SelectGroupLabelProps, SelectHelperText, type SelectHelperTextProps, SelectItem, type SelectItemProps, SelectLabel, type SelectLabelProps, SelectSeparator, type SelectSeparatorProps, SelectTrigger, type SelectTriggerProps, type SessionUser, type TabletSpan, TextLink, type TextLinkProps, buttonVariants, getAuthStatus, requireSession, textLinkVariants, useEasygovAuthStatus, useEasygovSession };