@easygov/react-components 0.2.5 → 0.2.7

package/README.md

@@ -49,6 +49,7 @@ On any other host (localhost, adesso dev cluster review apps, CI), set these
 | `NEXT_PUBLIC_CORE_ORIGIN` | Yes | Core frontend base URL, used for dashboard links. |
 | `NEXT_PUBLIC_CORE_API_ORIGIN` | No | Core API base URL. Defaults to `NEXT_PUBLIC_CORE_ORIGIN`; only needed when the API runs on a different origin (e.g. a different port on localhost). |
 | `NEXT_PUBLIC_OIDC_AUTHORITY` | Yes | **Full** Keycloak authority URL including the realm path, e.g. `https://keycloak.example.com/auth/realms/easygov`. |
+| `NEXT_PUBLIC_INFO_ORIGIN` | No | Info module base URL, used as the post-logout redirect target. Only needed on hosts where the `info` subdomain label can't be auto-derived (e.g. the adesso dev cluster, localhost); defaults to the current page URL when unset and undetectable. |
 
 If `NEXT_PUBLIC_CORE_ORIGIN` or `NEXT_PUBLIC_OIDC_AUTHORITY` is missing on a
 non-`easygov.swiss` host, the header degrades gracefully (auth disabled, no API

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 };