oidc-spa 7.1.10 → 7.2.0-rc.2

package/{src/mock/oidc.ts → esm/mock/oidc.js}

@@ -1,98 +1,49 @@
-import type { Oidc } from "../core";
 import { createObjectThatThrowsIfAccessed } from "../tools/createObjectThatThrowsIfAccessed";
 import { id } from "../vendor/frontend/tsafe";
 import { toFullyQualifiedUrl } from "../tools/toFullyQualifiedUrl";
 import { getSearchParam, addOrUpdateSearchParam } from "../tools/urlSearchParams";
 import { initialLocationHref } from "../core/initialLocationHref";
-
-export type ParamsOfCreateMockOidc<
-    DecodedIdToken extends Record<string, unknown> = Record<string, unknown>,
-    AutoLogin extends boolean = false
-> = {
-    mockedParams?: Partial<Oidc["params"]>;
-    mockedTokens?: Partial<Oidc.Tokens<DecodedIdToken>>;
-    /**
-     * The URL of the home page of your app.
-     * We need to know this so we know where to redirect when you call `logout({ redirectTo: "home"})`.
-     * In the majority of cases it should be `homeUrl: "/"` but it could aso be something like `homeUrl: "/dashboard"`
-     * if your web app isn't hosted at the root of the domain.
-     */
-    homeUrl: string;
-    autoLogin?: AutoLogin;
-    postLoginRedirectUrl?: string;
-} & (AutoLogin extends true
-    ? { isUserInitiallyLoggedIn?: true }
-    : {
-          isUserInitiallyLoggedIn: boolean;
-      });
-
 const URL_SEARCH_PARAM_NAME = "isUserLoggedIn";
-
-export async function createMockOidc<
-    DecodedIdToken extends Record<string, unknown> = Oidc.Tokens.DecodedIdToken_base,
-    AutoLogin extends boolean = false
->(
-    params: ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin>
-): Promise<AutoLogin extends true ? Oidc.LoggedIn<DecodedIdToken> : Oidc<DecodedIdToken>> {
-    const {
-        isUserInitiallyLoggedIn = true,
-        mockedParams = {},
-        mockedTokens = {},
-        homeUrl: homeUrl_params,
-        autoLogin = false,
-        postLoginRedirectUrl
-    } = params;
-
+export async function createMockOidc(params) {
+    const { isUserInitiallyLoggedIn = true, mockedParams = {}, mockedTokens = {}, homeUrl: homeUrl_params, autoLogin = false, postLoginRedirectUrl } = params;
     const isUserLoggedIn = (() => {
         const { wasPresent, value } = getSearchParam({
             url: initialLocationHref,
             name: URL_SEARCH_PARAM_NAME
         });
-
         if (!wasPresent) {
             return isUserInitiallyLoggedIn;
         }
-
         remove_from_url: {
             const { wasPresent, url_withoutTheParam } = getSearchParam({
                 url: window.location.href,
                 name: URL_SEARCH_PARAM_NAME
             });
-
             if (!wasPresent) {
                 break remove_from_url;
             }
-
             window.history.replaceState({}, "", url_withoutTheParam);
         }
-
         return value === "true";
     })();
-
     const homeUrl = toFullyQualifiedUrl({
         urlish: homeUrl_params,
         doAssertNoQueryParams: true,
         doOutputWithTrailingSlash: true
     });
-
-    const common: Oidc.Common = {
+    const common = {
         params: {
             clientId: mockedParams.clientId ?? "mymockclient",
             issuerUri: mockedParams.issuerUri ?? "https://my-mock-oidc-server.net/realms/mymockrealm"
         }
     };
-
-    const loginOrGoToAuthServer = async (params: {
-        redirectUrl: string | undefined;
-    }): Promise<never> => {
+    const loginOrGoToAuthServer = async (params) => {
         const { redirectUrl: redirectUrl_params } = params;
-
         const redirectUrl = addOrUpdateSearchParam({
             url: (() => {
                 if (redirectUrl_params === undefined) {
                     return window.location.href;
                 }
-
                 return toFullyQualifiedUrl({
                     urlish: redirectUrl_params,
                     doAssertNoQueryParams: false
@@ -102,14 +53,11 @@ export async function createMockOidc<
             value: "true",
             encodeMethod: "www-form"
         });
-
         window.location.href = redirectUrl;
-
-        return new Promise<never>(() => {});
+        return new Promise(() => { });
     };
-
     if (!isUserLoggedIn) {
-        const oidc = id<Oidc.NotLoggedIn>({
+        const oidc = id({
             ...common,
             isUserLoggedIn: false,
             login: ({ redirectUrl }) => loginOrGoToAuthServer({ redirectUrl }),
@@ -125,27 +73,24 @@ export async function createMockOidc<
         // @ts-expect-error: We know what we are doing
         return oidc;
     }
-
-    const oidc: Oidc.LoggedIn<DecodedIdToken> = {
+    const oidc = {
         ...common,
         isUserLoggedIn: true,
-        renewTokens: async () => {},
+        renewTokens: async () => { },
         ...(() => {
-            const tokens_common: Oidc.Tokens.Common<DecodedIdToken> = {
+            const tokens_common = {
                 accessToken: mockedTokens.accessToken ?? "mocked-access-token",
                 accessTokenExpirationTime: mockedTokens.accessTokenExpirationTime ?? Infinity,
                 idToken: mockedTokens.idToken ?? "mocked-id-token",
-                decodedIdToken:
-                    mockedTokens.decodedIdToken ??
-                    createObjectThatThrowsIfAccessed<DecodedIdToken>({
+                decodedIdToken: mockedTokens.decodedIdToken ??
+                    createObjectThatThrowsIfAccessed({
                         debugMessage: [
                             "You haven't provided a mocked decodedIdToken",
                             "See https://docs.oidc-spa.dev/v/v7/mock"
                         ].join("\n")
                     }),
-                decodedIdToken_original:
-                    mockedTokens.decodedIdToken_original ??
-                    createObjectThatThrowsIfAccessed<Oidc.Tokens.DecodedIdToken_base>({
+                decodedIdToken_original: mockedTokens.decodedIdToken_original ??
+                    createObjectThatThrowsIfAccessed({
                         debugMessage: [
                             "You haven't provided a mocked decodedIdToken_original",
                             "See https://docs.oidc-spa.dev/v/v7/mock"
@@ -153,27 +98,24 @@ export async function createMockOidc<
                     }),
                 issuedAtTime: Date.now()
             };
-
-            const tokens: Oidc.Tokens<DecodedIdToken> =
-                mockedTokens.refreshToken !== undefined || mockedTokens.hasRefreshToken === true
-                    ? id<Oidc.Tokens.WithRefreshToken<DecodedIdToken>>({
-                          ...tokens_common,
-                          hasRefreshToken: true,
-                          refreshToken: mockedTokens.refreshToken ?? "mocked-refresh-token",
-                          refreshTokenExpirationTime: mockedTokens.refreshTokenExpirationTime
-                      })
-                    : id<Oidc.Tokens.WithoutRefreshToken<DecodedIdToken>>({
-                          ...tokens_common,
-                          hasRefreshToken: false
-                      });
-
+            const tokens = mockedTokens.refreshToken !== undefined || mockedTokens.hasRefreshToken === true
+                ? id({
+                    ...tokens_common,
+                    hasRefreshToken: true,
+                    refreshToken: mockedTokens.refreshToken ?? "mocked-refresh-token",
+                    refreshTokenExpirationTime: mockedTokens.refreshTokenExpirationTime
+                })
+                : id({
+                    ...tokens_common,
+                    hasRefreshToken: false
+                });
             return {
                 getTokens: () => Promise.resolve(tokens),
                 getDecodedIdToken: () => tokens_common.decodedIdToken
             };
         })(),
         subscribeToTokensChange: () => ({
-            unsubscribe: () => {}
+            unsubscribe: () => { }
         }),
         logout: params => {
             const redirectUrl = addOrUpdateSearchParam({
@@ -194,18 +136,16 @@ export async function createMockOidc<
                 value: "false",
                 encodeMethod: "www-form"
             });
-
             window.location.href = redirectUrl;
-
-            return new Promise<never>(() => {});
+            return new Promise(() => { });
         },
         subscribeToAutoLogoutCountdown: () => ({
-            unsubscribeFromAutoLogoutCountdown: () => {}
+            unsubscribeFromAutoLogoutCountdown: () => { }
         }),
         goToAuthServer: async ({ redirectUrl }) => loginOrGoToAuthServer({ redirectUrl }),
         isNewBrowserSession: false,
         backFromAuthServer: undefined
     };
-
     return oidc;
 }
+//# sourceMappingURL=oidc.js.map

package/esm/mock/oidc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oidc.js","sourceRoot":"","sources":["../../../src/mock/oidc.ts"],"names":[],"mappings":"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"}

package/esm/mock/react.d.ts

@@ -0,0 +1,58 @@
+import { type ParamsOfCreateMockOidc } from "./oidc";
+import type { ValueOrAsyncGetter } from "../tools/ValueOrAsyncGetter";
+/** @see: https://docs.oidc-spa.dev/v/v7/mock */
+export declare function createMockReactOidc<DecodedIdToken extends Record<string, unknown> = Record<string, unknown>, AutoLogin extends boolean = false>(params: ValueOrAsyncGetter<ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin>>): {
+    OidcProvider: (ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T ? T extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T extends {
+        autoLogin?: true | undefined;
+    } ? true : false : never : never) extends infer T_1 ? T_1 extends (ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_2 ? T_2 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_2 extends {
+        autoLogin?: true | undefined;
+    } ? true : false : never : never) ? T_1 extends true ? (props: {
+        fallback?: import("react").ReactNode;
+        ErrorFallback?: (props: {
+            initializationError: import("..").OidcInitializationError;
+        }) => import("react").ReactNode;
+        children: import("react").ReactNode;
+    }) => import("react").JSX.Element : (props: {
+        fallback?: import("react").ReactNode;
+        children: import("react").ReactNode;
+    }) => import("react").JSX.Element : never : never;
+    useOidc: (ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_3 ? T_3 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_3 extends {
+        autoLogin?: true | undefined;
+    } ? true : false : never : never) extends infer T_4 ? T_4 extends (ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_5 ? T_5 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_5 extends {
+        autoLogin?: true | undefined;
+    } ? true : false : never : never) ? T_4 extends true ? (params?: {
+        assert: "user logged in";
+    }) => import("../react/react").OidcReact.LoggedIn<DecodedIdToken> : {
+        (params?: {
+            assert?: undefined;
+        }): import("../react/react").OidcReact<DecodedIdToken>;
+        (params: {
+            assert: "user logged in";
+        }): import("../react/react").OidcReact.LoggedIn<DecodedIdToken>;
+        (params: {
+            assert: "user not logged in";
+        }): import("../react/react").OidcReact.NotLoggedIn;
+    } : never : never;
+    getOidc: () => Promise<(ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_6 ? T_6 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_6 extends {
+        autoLogin?: true | undefined;
+    } ? true : false : never : never) extends infer T_7 ? T_7 extends (ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_8 ? T_8 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_8 extends {
+        autoLogin?: true | undefined;
+    } ? true : false : never : never) ? T_7 extends true ? import("..").Oidc.LoggedIn<DecodedIdToken> : import("..").Oidc<DecodedIdToken> : never : never>;
+} & ((ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_6 ? T_6 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_6 extends {
+    autoLogin?: true | undefined;
+} ? true : false : never : never) extends infer T_7 ? T_7 extends (ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> extends infer T_8 ? T_8 extends ParamsOfCreateMockOidc<DecodedIdToken, AutoLogin> ? T_8 extends {
+    autoLogin?: true | undefined;
+} ? true : false : never : never) ? T_7 extends true ? {} : {
+    withLoginEnforced: <Props extends Record<string, unknown>>(Component: import("react").ComponentType<Props>, params?: {
+        onRedirecting: () => import("react").JSX.Element | null;
+    }) => import("react").FC<Props>;
+    enforceLogin: (loaderParams: {
+        request?: {
+            url?: string;
+        };
+        cause?: "preload" | string;
+        location?: {
+            href?: string;
+        };
+    }) => Promise<void | never>;
+} : never : never);

package/esm/mock/react.js

@@ -0,0 +1,7 @@
+import { createOidcReactApi_dependencyInjection } from "../react/react";
+import { createMockOidc } from "./oidc";
+/** @see: https://docs.oidc-spa.dev/v/v7/mock */
+export function createMockReactOidc(params) {
+    return createOidcReactApi_dependencyInjection(params, createMockOidc);
+}
+//# sourceMappingURL=react.js.map

package/esm/mock/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/mock/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,cAAc,EAA+B,MAAM,QAAQ,CAAC;AAGrE,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CAGjC,MAA6E;IAC3E,OAAO,sCAAsC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAC1E,CAAC"}

package/esm/react/index.js

@@ -0,0 +1,2 @@
+export { createReactOidc } from "./react";
+//# sourceMappingURL=index.js.map

package/esm/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/esm/react/react.d.ts

@@ -0,0 +1,102 @@
+import { type ReactNode, type ComponentType, type FC, type JSX } from "react";
+import { type Oidc, type ParamsOfCreateOidc, OidcInitializationError } from "../core";
+import type { ValueOrAsyncGetter } from "../tools/ValueOrAsyncGetter";
+export type OidcReact<DecodedIdToken extends Record<string, unknown>> = OidcReact.NotLoggedIn | OidcReact.LoggedIn<DecodedIdToken>;
+export declare namespace OidcReact {
+    type Common = Oidc.Common & {
+        useAutoLogoutWarningCountdown: (params: {
+            warningDurationSeconds: number;
+        }) => {
+            secondsLeft: number | undefined;
+        };
+    };
+    type NotLoggedIn = Common & {
+        isUserLoggedIn: false;
+        login: (params?: {
+            extraQueryParams?: Record<string, string | undefined>;
+            redirectUrl?: string;
+            transformUrlBeforeRedirect?: (url: string) => string;
+            doesCurrentHrefRequiresAuth?: boolean;
+        }) => Promise<never>;
+        initializationError: OidcInitializationError | undefined;
+        decodedIdToken?: never;
+        logout?: never;
+        renewTokens?: never;
+        goToAuthServer?: never;
+        backFromAuthServer?: never;
+        isNewBrowserSession?: never;
+    };
+    type LoggedIn<DecodedIdToken extends Record<string, unknown>> = Common & {
+        isUserLoggedIn: true;
+        decodedIdToken: DecodedIdToken;
+        logout: Oidc.LoggedIn["logout"];
+        renewTokens: Oidc.LoggedIn["renewTokens"];
+        login?: never;
+        initializationError?: never;
+        goToAuthServer: (params: {
+            extraQueryParams?: Record<string, string>;
+            redirectUrl?: string;
+            transformUrlBeforeRedirect?: (url: string) => string;
+        }) => Promise<never>;
+        backFromAuthServer: {
+            extraQueryParams: Record<string, string>;
+            result: Record<string, string>;
+        } | undefined;
+        isNewBrowserSession: boolean;
+    };
+}
+type OidcReactApi<DecodedIdToken extends Record<string, unknown>, AutoLogin extends boolean> = {
+    OidcProvider: AutoLogin extends true ? (props: {
+        fallback?: ReactNode;
+        ErrorFallback?: (props: {
+            initializationError: OidcInitializationError;
+        }) => ReactNode;
+        children: ReactNode;
+    }) => JSX.Element : (props: {
+        fallback?: ReactNode;
+        children: ReactNode;
+    }) => JSX.Element;
+    useOidc: AutoLogin extends true ? {
+        (params?: {
+            assert: "user logged in";
+        }): OidcReact.LoggedIn<DecodedIdToken>;
+    } : {
+        (params?: {
+            assert?: undefined;
+        }): OidcReact<DecodedIdToken>;
+        (params: {
+            assert: "user logged in";
+        }): OidcReact.LoggedIn<DecodedIdToken>;
+        (params: {
+            assert: "user not logged in";
+        }): OidcReact.NotLoggedIn;
+    };
+    getOidc: () => Promise<AutoLogin extends true ? Oidc.LoggedIn<DecodedIdToken> : Oidc<DecodedIdToken>>;
+} & (AutoLogin extends true ? {} : {
+    withLoginEnforced: <Props extends Record<string, unknown>>(Component: ComponentType<Props>, params?: {
+        onRedirecting: () => JSX.Element | null;
+    }) => FC<Props>;
+    enforceLogin: (loaderParams: {
+        request?: {
+            url?: string;
+        };
+        cause?: "preload" | string;
+        location?: {
+            href?: string;
+        };
+    }) => Promise<void | never>;
+});
+export declare function createOidcReactApi_dependencyInjection<DecodedIdToken extends Record<string, unknown>, ParamsOfCreateOidc extends {
+    autoLogin?: boolean;
+} & ({
+    decodedIdTokenSchema: {
+        parse: (data: unknown) => DecodedIdToken;
+    } | undefined;
+} | {})>(paramsOrGetParams: ValueOrAsyncGetter<ParamsOfCreateOidc>, createOidc: (params: ParamsOfCreateOidc) => Promise<Oidc<DecodedIdToken>>): OidcReactApi<DecodedIdToken, ParamsOfCreateOidc extends {
+    autoLogin?: true | undefined;
+} ? true : false>;
+/** @see: https://docs.oidc-spa.dev/v/v7/usage#react-api */
+export declare function createReactOidc<DecodedIdToken extends Record<string, unknown> = Oidc.Tokens.DecodedIdToken_base, AutoLogin extends boolean = false>(params: ValueOrAsyncGetter<ParamsOfCreateOidc<DecodedIdToken, AutoLogin>>): OidcReactApi<DecodedIdToken, ParamsOfCreateOidc<DecodedIdToken, AutoLogin> extends infer T ? T extends ParamsOfCreateOidc<DecodedIdToken, AutoLogin> ? T extends {
+    autoLogin?: true | undefined;
+} ? true : false : never : never>;
+export {};

package/esm/react/react.js

@@ -0,0 +1,221 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, createContext, useContext } from "react";
+import { createOidc, OidcInitializationError, handleOidcCallback } from "../core";
+import { assert } from "../vendor/frontend/tsafe";
+import { id } from "../vendor/frontend/tsafe";
+import { Deferred } from "../tools/Deferred";
+import { toFullyQualifiedUrl } from "../tools/toFullyQualifiedUrl";
+{
+    assert();
+}
+export function createOidcReactApi_dependencyInjection(paramsOrGetParams, createOidc) {
+    const dReadyToCreate = new Deferred();
+    const oidcContext = createContext(undefined);
+    // NOTE: It can be InitializationError only if autoLogin is true
+    const prOidcOrInitializationError = (async () => {
+        // We're doing this here just for people that wouldn't have
+        // configured the early init in entrypoint.
+        {
+            const { isHandled } = handleOidcCallback();
+            if (isHandled) {
+                return new Promise(() => { });
+            }
+        }
+        const params = await (async () => {
+            if (typeof paramsOrGetParams === "function") {
+                const getParams = paramsOrGetParams;
+                await dReadyToCreate.pr;
+                const params = await getParams();
+                return params;
+            }
+            const params = paramsOrGetParams;
+            return params;
+        })();
+        let oidc;
+        try {
+            oidc = await createOidc(params);
+        }
+        catch (error) {
+            if (!(error instanceof OidcInitializationError)) {
+                throw error;
+            }
+            return error;
+        }
+        return oidc;
+    })();
+    let prOidcOrInitializationError_resolvedValue = undefined;
+    prOidcOrInitializationError.then(value => (prOidcOrInitializationError_resolvedValue = value));
+    function OidcProvider(props) {
+        const { fallback, ErrorFallback, children } = props;
+        const [oidcOrInitializationError, setOidcOrInitializationError] = useState(prOidcOrInitializationError_resolvedValue);
+        useEffect(() => {
+            if (oidcOrInitializationError !== undefined) {
+                return;
+            }
+            dReadyToCreate.resolve();
+            prOidcOrInitializationError.then(setOidcOrInitializationError);
+        }, []);
+        if (oidcOrInitializationError === undefined) {
+            return _jsx(_Fragment, { children: fallback === undefined ? null : fallback });
+        }
+        if (oidcOrInitializationError instanceof OidcInitializationError) {
+            const initializationError = oidcOrInitializationError;
+            return (_jsx(_Fragment, { children: ErrorFallback === undefined ? (_jsxs("h1", { style: { color: "red" }, children: ["An error occurred while initializing the OIDC client:\u00A0", initializationError.message] })) : (_jsx(ErrorFallback, { initializationError: initializationError })) }));
+        }
+        const oidc = oidcOrInitializationError;
+        return (_jsx(oidcContext.Provider, { value: { oidc, fallback: fallback ?? null }, children: children }));
+    }
+    const useAutoLogoutWarningCountdown = ({ warningDurationSeconds }) => {
+        const contextValue = useContext(oidcContext);
+        assert(contextValue !== undefined);
+        const { oidc } = contextValue;
+        const [secondsLeft, setSecondsLeft] = useState(undefined);
+        useEffect(() => {
+            if (!oidc.isUserLoggedIn) {
+                return;
+            }
+            const { unsubscribeFromAutoLogoutCountdown } = oidc.subscribeToAutoLogoutCountdown(({ secondsLeft }) => setSecondsLeft(secondsLeft === undefined || secondsLeft > warningDurationSeconds
+                ? undefined
+                : secondsLeft));
+            return () => {
+                unsubscribeFromAutoLogoutCountdown();
+            };
+        }, [warningDurationSeconds]);
+        return { secondsLeft };
+    };
+    function useOidc(params) {
+        const { assert: assert_params } = params ?? {};
+        const contextValue = useContext(oidcContext);
+        assert(contextValue !== undefined, "You must use useOidc inside the corresponding OidcProvider");
+        const { oidc } = contextValue;
+        check_assertion: {
+            if (assert_params === undefined) {
+                break check_assertion;
+            }
+            const getMessage = (v) => [
+                "There is a logic error in the application.",
+                `If this component is mounted the user is supposed ${v}.`,
+                "An explicit assertion was made in this sense."
+            ].join(" ");
+            switch (assert_params) {
+                case "user logged in":
+                    if (!oidc.isUserLoggedIn) {
+                        throw new Error(getMessage("to be logged in but currently they arn't"));
+                    }
+                    break;
+                case "user not logged in":
+                    if (oidc.isUserLoggedIn) {
+                        throw new Error(getMessage("not to be logged in but currently they are"));
+                    }
+                    break;
+                default:
+                    assert(false);
+            }
+        }
+        const [, reRenderIfDecodedIdTokenChanged] = useState(!oidc.isUserLoggedIn ? undefined : oidc.getDecodedIdToken());
+        useEffect(() => {
+            if (!oidc.isUserLoggedIn) {
+                return;
+            }
+            const { unsubscribe } = oidc.subscribeToTokensChange(() => reRenderIfDecodedIdTokenChanged(oidc.getDecodedIdToken()));
+            reRenderIfDecodedIdTokenChanged(oidc.getDecodedIdToken());
+            return unsubscribe;
+        }, []);
+        const common = {
+            params: oidc.params,
+            useAutoLogoutWarningCountdown
+        };
+        if (!oidc.isUserLoggedIn) {
+            return id({
+                ...common,
+                isUserLoggedIn: false,
+                login: ({ doesCurrentHrefRequiresAuth = false, ...rest } = {}) => oidc.login({ doesCurrentHrefRequiresAuth, ...rest }),
+                initializationError: oidc.initializationError
+            });
+        }
+        const oidcReact = {
+            ...common,
+            isUserLoggedIn: true,
+            decodedIdToken: oidc.getDecodedIdToken(),
+            logout: oidc.logout,
+            renewTokens: oidc.renewTokens,
+            goToAuthServer: oidc.goToAuthServer,
+            isNewBrowserSession: oidc.isNewBrowserSession,
+            backFromAuthServer: oidc.backFromAuthServer
+        };
+        return oidcReact;
+    }
+    function withLoginEnforced(Component, params) {
+        const { onRedirecting } = params ?? {};
+        function ComponentWithLoginEnforced(props) {
+            const contextValue = useContext(oidcContext);
+            assert(contextValue !== undefined, "094283");
+            const { oidc, fallback } = contextValue;
+            useEffect(() => {
+                if (oidc.isUserLoggedIn) {
+                    return;
+                }
+                oidc.login({ doesCurrentHrefRequiresAuth: true });
+            }, []);
+            if (!oidc.isUserLoggedIn) {
+                return onRedirecting === undefined ? fallback : onRedirecting();
+            }
+            return _jsx(Component, { ...props });
+        }
+        ComponentWithLoginEnforced.displayName = `${Component.displayName ?? Component.name ?? "Component"}WithLoginEnforced`;
+        return ComponentWithLoginEnforced;
+    }
+    async function enforceLogin(loaderParams) {
+        const { cause } = loaderParams;
+        const redirectUrl = (() => {
+            if (loaderParams.request?.url !== undefined) {
+                return toFullyQualifiedUrl({
+                    urlish: loaderParams.request.url,
+                    doAssertNoQueryParams: false
+                });
+            }
+            if (loaderParams.location?.href !== undefined) {
+                return toFullyQualifiedUrl({
+                    urlish: loaderParams.location.href,
+                    doAssertNoQueryParams: false
+                });
+            }
+            return location.href;
+        })();
+        const oidc = await getOidc();
+        if (!oidc.isUserLoggedIn) {
+            if (cause === "preload") {
+                throw new Error("oidc-spa: User is not yet logged in. This is an expected error, nothing to be addressed.");
+            }
+            const doesCurrentHrefRequiresAuth = location.href.replace(/\/$/, "") === redirectUrl.replace(/\/$/, "");
+            await oidc.login({
+                redirectUrl,
+                doesCurrentHrefRequiresAuth
+            });
+        }
+    }
+    async function getOidc() {
+        dReadyToCreate.resolve();
+        const oidcOrInitializationError = await prOidcOrInitializationError;
+        if (oidcOrInitializationError instanceof OidcInitializationError) {
+            const error = oidcOrInitializationError;
+            throw error;
+        }
+        const oidc = oidcOrInitializationError;
+        return oidc;
+    }
+    const oidcReact = {
+        OidcProvider,
+        useOidc: useOidc,
+        getOidc,
+        withLoginEnforced,
+        enforceLogin
+    };
+    // @ts-expect-error: We know what we are doing
+    return oidcReact;
+}
+/** @see: https://docs.oidc-spa.dev/v/v7/usage#react-api */
+export function createReactOidc(params) {
+    return createOidcReactApi_dependencyInjection(params, createOidc);
+}
+//# sourceMappingURL=react.js.map

package/esm/react/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/react/react.tsx"],"names":[],"mappings":"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"}

package/esm/tools/Deferred.d.ts

@@ -0,0 +1,14 @@
+export declare class Deferred<T> {
+    readonly pr: Promise<T>;
+    /** NOTE: Does not need to be called bound to instance*/
+    readonly resolve: (value: T) => void;
+    readonly reject: (error: any) => void;
+    constructor();
+    readonly isPending: boolean;
+}
+export declare namespace Deferred {
+    type Unpack<T extends Deferred<any>> = T extends Deferred<infer U> ? U : never;
+}
+export declare class VoidDeferred extends Deferred<undefined> {
+    readonly resolve: () => void;
+}