@owlmeans/web-client 0.1.18-rc.2 → 0.1.18-rc.20

package/build/login/pump.d.ts

@@ -0,0 +1,20 @@
+import { LoginOutcome } from '@owlmeans/client-auth/login';
+/**
+ * Wait on a surrogate window until it says something, or goes away.
+ *
+ * Extracted so login and logout share one implementation rather than two that agree until one of
+ * them is changed. Every guard here was a real failure at some point:
+ *
+ * - the **origin pin** is not decoration — the message carries a bearer token, and a listener that
+ *   accepted any origin would take one from any page that could reach this window;
+ * - the **`settled` latch** stops a second message, or a close racing a message, resolving twice;
+ * - the **`closed` poll** is the only exit when the user simply closes the window, because a window
+ *   the user closes announces nothing at all;
+ * - the listener and the interval are removed on every path, including the ones that resolve.
+ */
+export declare const awaitSurrogate: (surrogate: Window, messageType: string, onMessage: (data: {
+    type?: string;
+    token?: string;
+    ok?: boolean;
+}) => Promise<LoginOutcome>) => Promise<LoginOutcome>;
+//# sourceMappingURL=pump.d.ts.map

package/build/login/pump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pump.d.ts","sourceRoot":"","sources":["../../src/login/pump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAEhF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,cACd,MAAM,eACJ,MAAM,aACR,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,KAC1F,OAAO,CAAC,YAAY,CAiCrB,CAAA"}

package/build/login/pump.js

@@ -0,0 +1,46 @@
+import { LOGIN_WATCH_INTERVAL, LoginOutcome } from '@owlmeans/client-auth/login';
+/**
+ * Wait on a surrogate window until it says something, or goes away.
+ *
+ * Extracted so login and logout share one implementation rather than two that agree until one of
+ * them is changed. Every guard here was a real failure at some point:
+ *
+ * - the **origin pin** is not decoration — the message carries a bearer token, and a listener that
+ *   accepted any origin would take one from any page that could reach this window;
+ * - the **`settled` latch** stops a second message, or a close racing a message, resolving twice;
+ * - the **`closed` poll** is the only exit when the user simply closes the window, because a window
+ *   the user closes announces nothing at all;
+ * - the listener and the interval are removed on every path, including the ones that resolve.
+ */
+export const awaitSurrogate = async (surrogate, messageType, onMessage) => await new Promise(resolve => {
+    let settled = false;
+    let watch;
+    const finish = (result) => {
+        if (settled) {
+            return;
+        }
+        settled = true;
+        window.removeEventListener('message', handler);
+        if (watch != null) {
+            clearInterval(watch);
+        }
+        resolve(result);
+    };
+    function handler(event) {
+        if (event.origin !== window.location.origin) {
+            return;
+        }
+        const data = event.data;
+        if (data?.type !== messageType) {
+            return;
+        }
+        void onMessage(data).then(finish).catch(() => finish(LoginOutcome.Failed));
+    }
+    window.addEventListener('message', handler);
+    watch = setInterval(() => {
+        if (surrogate.closed) {
+            finish(LoginOutcome.Failed);
+        }
+    }, LOGIN_WATCH_INTERVAL);
+});
+//# sourceMappingURL=pump.js.map

package/build/login/pump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pump.js","sourceRoot":"","sources":["../../src/login/pump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,SAAiB,EACjB,WAAmB,EACnB,SAA2F,EACpE,EAAE,CAAC,MAAM,IAAI,OAAO,CAAe,OAAO,CAAC,EAAE;IACpE,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,KAAiD,CAAA;IAErD,MAAM,MAAM,GAAG,CAAC,MAAoB,EAAQ,EAAE;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAM;QACR,CAAC;QACD,OAAO,GAAG,IAAI,CAAA;QACd,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC9C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,aAAa,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,CAAA;IACjB,CAAC,CAAA;IAED,SAAS,OAAO,CAAC,KAAmB;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC5C,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAA8D,CAAA;QACjF,IAAI,IAAI,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC3C,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QACvB,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC,EAAE,oBAAoB,CAAC,CAAA;AAC1B,CAAC,CAAC,CAAA"}

package/build/login/redirect.d.ts

@@ -0,0 +1,9 @@
+import type { LoginPlugin } from '@owlmeans/client-auth/login';
+/**
+ * The ordinary login flow: this document leaves for the identity provider and comes back.
+ *
+ * The default plugin, matching everything, so any environment that does not need special handling
+ * behaves exactly as it always did.
+ */
+export declare const makeRedirectLoginPlugin: () => LoginPlugin;
+//# sourceMappingURL=redirect.d.ts.map

package/build/login/redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../src/login/redirect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAG5E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAO,WAgDzC,CAAA"}

package/build/login/redirect.js

@@ -0,0 +1,47 @@
+import { revokeToken, LoginOutcome } from '@owlmeans/client-auth/login';
+import { REDIRECT_LOGIN } from './consts.js';
+/**
+ * The ordinary login flow: this document leaves for the identity provider and comes back.
+ *
+ * The default plugin, matching everything, so any environment that does not need special handling
+ * behaves exactly as it always did.
+ */
+export const makeRedirectLoginPlugin = () => ({
+    alias: REDIRECT_LOGIN,
+    priority: 0,
+    mode: 'redirect',
+    match: () => true,
+    begin: async (_ctx, request) => {
+        // Prefer the in-app continuation the caller handed over: a client-side navigation to the
+        // dispatcher keeps the app mounted, where a full page load would tear it down and rebuild it.
+        if (request.navigate != null) {
+            await request.navigate();
+            return LoginOutcome.Handled;
+        }
+        window.location.href = request.url;
+        return LoginOutcome.Redirected;
+    },
+    authorize: async (_ctx, url) => {
+        window.location.href = url;
+        return LoginOutcome.Redirected;
+    },
+    // Nothing to hand anywhere — the token was issued in the document that will use it.
+    complete: async () => LoginOutcome.Passed,
+    // `resume` is deliberately NOT implemented. The host defaults to `Passed`, which is "keep the
+    // session you already have and carry on" — byte for byte what an ordinary tab has always done.
+    // Implementing it here would be the one way to regress every unframed application.
+    logout: (ctx, request) => revokeToken(ctx).then(async () => {
+        if (request.navigate != null) {
+            await request.navigate();
+            return LoginOutcome.Handled;
+        }
+        // A reload rather than a client-side navigation: `useOwlAuth` and its kin read through
+        // cached values, so the honest way to make a whole application forget a session is to
+        // rebuild it. This is what `useLogout` did inline before the mechanic became a plugin.
+        window.location.reload();
+        return LoginOutcome.Handled;
+    }),
+    // Nothing to tell anyone — the session was cleared in the document that owned it.
+    logoutComplete: async () => LoginOutcome.Passed,
+});
+//# sourceMappingURL=redirect.js.map

package/build/login/redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../../src/login/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAgB,EAAE,CAAC,CAAC;IACzD,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;IAEjB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC7B,yFAAyF;QACzF,8FAA8F;QAC9F,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;YAExB,OAAO,YAAY,CAAC,OAAO,CAAA;QAC7B,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAA;QAElC,OAAO,YAAY,CAAC,UAAU,CAAA;IAChC,CAAC;IAED,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAA;QAE1B,OAAO,YAAY,CAAC,UAAU,CAAA;IAChC,CAAC;IAED,oFAAoF;IACpF,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM;IAEzC,8FAA8F;IAC9F,+FAA+F;IAC/F,mFAAmF;IAEnF,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,GAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACzE,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;YAExB,OAAO,YAAY,CAAC,OAAO,CAAA;QAC7B,CAAC;QACD,uFAAuF;QACvF,sFAAsF;QACtF,uFAAuF;QACvF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;QAExB,OAAO,YAAY,CAAC,OAAO,CAAA;IAC7B,CAAC,CAAC;IAEF,kFAAkF;IAClF,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM;CAChD,CAAC,CAAA"}

package/build/login/screen.d.ts

@@ -0,0 +1,15 @@
+import type { FC } from 'react';
+/**
+ * The login window an embedded application opens one level up.
+ *
+ * It is NOT wrapped in `DispatcherHOC`, and that is the point: the HOC's continuation navigates to
+ * `HOME` when it has nothing else to do, which is how a popup ended up rendering the whole
+ * application, with its navigation, inside itself. This screen has no continuation at all — it
+ * either hands something back and closes, or it says what it is waiting for.
+ *
+ * It also never runs the authorization machine. When there is already a session here, that is the
+ * answer, and it goes back to the opener immediately — no provider round trip, no PKCE exchange.
+ * When there is not, it forwards to the dispatcher (`next`), which owns that flow.
+ */
+export declare const SurrogateScreen: FC;
+//# sourceMappingURL=screen.d.ts.map

package/build/login/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../src/login/screen.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAU/B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,EA+F7B,CAAA"}

package/build/login/screen.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { useContext } from '@owlmeans/client';
+import { useI18nLib } from '@owlmeans/client-i18n';
+import { LoginIntent, LoginOutcome, LOGIN_INTENT_QUERY, LOGIN_METHOD_QUERY, LOGIN_NEXT_QUERY, } from '@owlmeans/client-auth/login';
+import { LoginSurrogateView, SurrogateStage } from './view.js';
+/**
+ * The login window an embedded application opens one level up.
+ *
+ * It is NOT wrapped in `DispatcherHOC`, and that is the point: the HOC's continuation navigates to
+ * `HOME` when it has nothing else to do, which is how a popup ended up rendering the whole
+ * application, with its navigation, inside itself. This screen has no continuation at all — it
+ * either hands something back and closes, or it says what it is waiting for.
+ *
+ * It also never runs the authorization machine. When there is already a session here, that is the
+ * answer, and it goes back to the opener immediately — no provider round trip, no PKCE exchange.
+ * When there is not, it forwards to the dispatcher (`next`), which owns that flow.
+ */
+export const SurrogateScreen = () => {
+    const context = useContext();
+    const [query] = context.router().useSearchParams();
+    const t = useI18nLib('auth');
+    const intent = query.get(LOGIN_INTENT_QUERY) === LoginIntent.Logout
+        ? LoginIntent.Logout
+        : LoginIntent.Login;
+    const [stage, setStage] = useState(SurrogateStage.Working);
+    const [error, setError] = useState();
+    const onAction = useCallback(() => {
+        if (stage === SurrogateStage.Standalone) {
+            window.location.href = '/';
+            return;
+        }
+        if (stage === SurrogateStage.Gesture) {
+            const next = query.get(LOGIN_NEXT_QUERY);
+            void context.login().begin({ url: next ?? window.location.href });
+            return;
+        }
+        window.close();
+    }, [context, stage, query]);
+    useEffect(() => {
+        const login = context.service('login-service');
+        // First statement, unconditionally: `markSurrogate` reads `window.name`, and the browser
+        // clears that the moment this window's top-level context goes cross-origin. Recording it
+        // later means recording nothing.
+        login.enter();
+        const env = login.env();
+        if (!env.surrogate) {
+            // Somebody opened this address directly, or the window lost its marker. Never navigate on
+            // its behalf — offer a link and stop.
+            setStage(env.embedded ? SurrogateStage.Gesture : SurrogateStage.Standalone);
+            return;
+        }
+        const run = async () => {
+            const token = await context.auth().authenticated();
+            if (intent === LoginIntent.Logout) {
+                // Revoked FIRST, before anything can be awaited on a channel that may never answer: a
+                // window the user closes half a second later must still have ended the session it opened
+                // to end.
+                await login.revoke();
+                const outcome = await login.logoutComplete();
+                setStage(outcome === LoginOutcome.Handled ? SurrogateStage.Handing
+                    : outcome === LoginOutcome.Orphaned ? SurrogateStage.Orphaned
+                        : SurrogateStage.Failed);
+                return;
+            }
+            if (token != null && token !== '') {
+                // Already signed in here. The framed application is the one that asked, so the session
+                // goes to it rather than being displayed to this window.
+                const outcome = await login.resume(token);
+                setStage(outcome === LoginOutcome.Handled ? SurrogateStage.Handing
+                    : outcome === LoginOutcome.Orphaned ? SurrogateStage.Orphaned
+                        : SurrogateStage.Failed);
+                return;
+            }
+            // Nothing here yet — the dispatcher owns the authorization round trip, and the provider's
+            // callback lands there rather than on this route. The method the user already chose travels
+            // with it, so the dispatcher does not ask a second time in a window with no one to ask.
+            const next = query.get(LOGIN_NEXT_QUERY);
+            if (next == null || next === '') {
+                setStage(SurrogateStage.Gesture);
+                return;
+            }
+            const method = query.get(LOGIN_METHOD_QUERY);
+            const target = method != null && method !== ''
+                ? `${next}${next.includes('?') ? '&' : '?'}${LOGIN_METHOD_QUERY}=${encodeURIComponent(method)}`
+                : next;
+            window.location.href = target;
+        };
+        void run().catch((e) => {
+            console.error(e);
+            setError(e.message);
+            setStage(SurrogateStage.Failed);
+        });
+    }, [context, intent]);
+    return _jsx(LoginSurrogateView, { stage: stage, intent: intent, onAction: onAction, error: error, translate: (key, defaultValue) => t(key, { defaultValue }) });
+};
+//# sourceMappingURL=screen.js.map

package/build/login/screen.js.map

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

package/build/login/service.d.ts

@@ -0,0 +1,10 @@
+import type { BasicConfig, BasicContext } from '@owlmeans/context';
+/**
+ * Register the login host and the two browser flows on a context.
+ *
+ * Called by `makeContext`, so every web app has working login — including a framed one — without
+ * registering anything. An app that needs a different mechanic registers its own plugin at a
+ * higher priority; it does not replace this.
+ */
+export declare const appendWebLogin: <C extends BasicConfig, T extends BasicContext<C>>(ctx: T) => T;
+//# sourceMappingURL=service.d.ts.map

package/build/login/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/login/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIlE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,KAAG,CAMzF,CAAA"}

package/build/login/service.js

@@ -0,0 +1,17 @@
+import { appendLogin } from '@owlmeans/client-auth/login';
+import { makeRedirectLoginPlugin } from './redirect.js';
+import { makeSurrogateLoginPlugin } from './surrogate.js';
+/**
+ * Register the login host and the two browser flows on a context.
+ *
+ * Called by `makeContext`, so every web app has working login — including a framed one — without
+ * registering anything. An app that needs a different mechanic registers its own plugin at a
+ * higher priority; it does not replace this.
+ */
+export const appendWebLogin = (ctx) => {
+    const service = appendLogin(ctx).login();
+    service.registerPlugin(makeRedirectLoginPlugin());
+    service.registerPlugin(makeSurrogateLoginPlugin());
+    return ctx;
+};
+//# sourceMappingURL=service.js.map

package/build/login/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/login/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAmD,GAAM,EAAK,EAAE;IAC5F,MAAM,OAAO,GAAG,WAAW,CAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAA;IAC9C,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,cAAc,CAAC,wBAAwB,EAAE,CAAC,CAAA;IAElD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/build/login/surrogate.d.ts

@@ -0,0 +1,21 @@
+import type { LoginPlugin } from '@owlmeans/client-auth/login';
+/**
+ * Login for a document that cannot complete the flow where it is.
+ *
+ * An app embedded in a frame cannot redirect to an identity provider: the provider refuses to be
+ * embedded (`frame-ancestors`), and its session cookies are third-party there. So the flow runs
+ * one window up, in a surrogate window that is top-level and first-party on this application's own
+ * origin — where the very same flow completes normally — and the token is passed back to the
+ * document that asked for it.
+ *
+ * This plugin is deliberately not OIDC-specific. The mechanic is "run the login route one window
+ * up and hand the token back", and the adoption is the plain auth service, so any relying party
+ * that renders a login route gets it by registering nothing.
+ *
+ * `match` covers BOTH halves of the lifecycle — the framed opener and the surrogate itself, where
+ * `embedded` is false. Inside the surrogate the redirect plugin must not win: that window IS
+ * top-level, so it authorizes by an ordinary redirect and differs only in what it does with the
+ * token at the end.
+ */
+export declare const makeSurrogateLoginPlugin: () => LoginPlugin;
+//# sourceMappingURL=surrogate.d.ts.map

package/build/login/surrogate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surrogate.d.ts","sourceRoot":"","sources":["../../src/login/surrogate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA0B,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAItF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,QAAO,WAoJ3C,CAAA"}

package/build/login/surrogate.js

@@ -0,0 +1,144 @@
+import { adoptToken, clearSurrogate, markSurrogate, revokeToken, surrogatePath, LoginIntent, LoginOutcome, LOGIN_LOGOUT_MESSAGE, LOGIN_SURROGATE_FEATURES, LOGIN_SURROGATE_NAME, LOGIN_TOKEN_MESSAGE, } from '@owlmeans/client-auth/login';
+import { SURROGATE_LOGIN, SURROGATE_LOGIN_PRIORITY } from './consts.js';
+import { awaitSurrogate } from './pump.js';
+/**
+ * Login for a document that cannot complete the flow where it is.
+ *
+ * An app embedded in a frame cannot redirect to an identity provider: the provider refuses to be
+ * embedded (`frame-ancestors`), and its session cookies are third-party there. So the flow runs
+ * one window up, in a surrogate window that is top-level and first-party on this application's own
+ * origin — where the very same flow completes normally — and the token is passed back to the
+ * document that asked for it.
+ *
+ * This plugin is deliberately not OIDC-specific. The mechanic is "run the login route one window
+ * up and hand the token back", and the adoption is the plain auth service, so any relying party
+ * that renders a login route gets it by registering nothing.
+ *
+ * `match` covers BOTH halves of the lifecycle — the framed opener and the surrogate itself, where
+ * `embedded` is false. Inside the surrogate the redirect plugin must not win: that window IS
+ * top-level, so it authorizes by an ordinary redirect and differs only in what it does with the
+ * token at the end.
+ */
+export const makeSurrogateLoginPlugin = () => {
+    /**
+     * Give the token to whoever is entitled to it, and get out of the way.
+     *
+     * Shared by `complete` (a token was just issued here) and `resume` (one was already here),
+     * because what happens to it is the same in both cases and only the question differs.
+     */
+    const handBack = async (token, env) => {
+        if (!env.surrogate) {
+            // This document started the flow and finished it in place — it already has what it needs.
+            return LoginOutcome.Passed;
+        }
+        if (!env.hasOpener) {
+            // Authenticated with nowhere to send it. `Cross-Origin-Opener-Policy: same-origin` from the
+            // provider severs `window.opener` permanently, so this is not a timing problem to retry.
+            return LoginOutcome.Orphaned;
+        }
+        clearSurrogate();
+        // Both windows are the same origin (the surrogate is this application's own login route), so
+        // the origin is pinned rather than passed as `*` — the message carries a bearer token.
+        window.opener.postMessage({ type: LOGIN_TOKEN_MESSAGE, token }, window.location.origin);
+        window.close();
+        return LoginOutcome.Handled;
+    };
+    const plugin = {
+        alias: SURROGATE_LOGIN,
+        priority: SURROGATE_LOGIN_PRIORITY,
+        mode: 'surrogate',
+        match: env => env.hasWindow && (env.embedded || env.surrogate),
+        enter: () => { markSurrogate(); },
+        begin: (ctx, request, env) => {
+            // Already one window up — nothing to open, just run the flow.
+            if (env.surrogate) {
+                window.location.href = request.url;
+                return Promise.resolve(LoginOutcome.Redirected);
+            }
+            // Opened FIRST and synchronously: `window.open` escapes the popup blocker only while the
+            // user gesture is still being handled, so nothing may be awaited before this line. That is
+            // why this function is not `async`.
+            //
+            // The window opens on the surrogate route rather than on the dispatcher, so its very first
+            // paint is a bare "signing you in" panel instead of the application with its navigation. The
+            // dispatcher address travels as `next`, because the provider's callback still lands there and
+            // whatever flow parameters the caller's URL carried must survive the hop.
+            const path = surrogatePath(ctx, {
+                intent: LoginIntent.Login, next: request.url,
+            });
+            const surrogate = window.open(path ?? request.url, LOGIN_SURROGATE_NAME, LOGIN_SURROGATE_FEATURES);
+            if (surrogate == null) {
+                return Promise.resolve(LoginOutcome.Failed);
+            }
+            return awaitSurrogate(surrogate, LOGIN_TOKEN_MESSAGE, async (data) => {
+                if (data.token == null || data.token === '') {
+                    return LoginOutcome.Failed;
+                }
+                await adoptToken(ctx, data.token);
+                // Adopting the token is not the end of the flow — running the caller's continuation is,
+                // exactly as the redirect plugin does before it reports `Handled`. Without it the token
+                // lands in the auth service and nothing else happens: the framed app keeps rendering its
+                // signed-out tree, and the user watches the login window close over a preview that never
+                // changes. `Handled` promises the caller there is nothing left to do.
+                await request.navigate?.();
+                return LoginOutcome.Handled;
+            });
+        },
+        authorize: async (_ctx, url, env) => {
+            // The surrogate is top-level, so it redirects like any ordinary tab.
+            if (env.surrogate) {
+                window.location.href = url;
+                return LoginOutcome.Redirected;
+            }
+            // Framed, and not yet one window up. A redirect from here would land in the frame and be
+            // refused, and the window that would fix it cannot be opened without a user gesture — so the
+            // caller is told to render a control rather than to navigate.
+            return LoginOutcome.Gesture;
+        },
+        complete: async (_ctx, token, env) => await handBack(token, env),
+        // A session that was already here is worth exactly as much as one just issued — to the window
+        // that asked for it. Without this the surrogate would render the signed-in application to
+        // itself and the framed app would stay signed out, which is the whole reported defect.
+        resume: async (_ctx, token, env) => await handBack(token, env),
+        logout: (ctx, request, env) => {
+            // Already one window up — end the session here and tell the opener.
+            if (env.surrogate) {
+                return revokeToken(ctx)
+                    .then(async () => await plugin.logoutComplete(ctx, env));
+            }
+            const path = surrogatePath(ctx, { intent: LoginIntent.Logout });
+            // Opened first and synchronously, for the same reason `begin` does.
+            const surrogate = path != null
+                ? window.open(path, LOGIN_SURROGATE_NAME, LOGIN_SURROGATE_FEATURES)
+                : null;
+            // The local session goes next, and UNCONDITIONALLY. A blocked window, a severed opener or a
+            // user who closes the popup must never leave THIS document signed in: a logout that only
+            // half happened is bad, and one that did not happen at all is worse.
+            const local = revokeToken(ctx);
+            if (surrogate == null) {
+                return local.then(async () => {
+                    await request.navigate?.();
+                    return LoginOutcome.Failed;
+                });
+            }
+            return local.then(async () => await awaitSurrogate(surrogate, LOGIN_LOGOUT_MESSAGE, async () => {
+                await request.navigate?.();
+                return LoginOutcome.Handled;
+            }));
+        },
+        logoutComplete: async (_ctx, env) => {
+            if (!env.surrogate) {
+                return LoginOutcome.Passed;
+            }
+            if (!env.hasOpener) {
+                return LoginOutcome.Orphaned;
+            }
+            clearSurrogate();
+            window.opener.postMessage({ type: LOGIN_LOGOUT_MESSAGE, ok: true }, window.location.origin);
+            window.close();
+            return LoginOutcome.Handled;
+        },
+    };
+    return plugin;
+};
+//# sourceMappingURL=surrogate.js.map

package/build/login/surrogate.js.map

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

package/build/login/view.d.ts

@@ -0,0 +1,26 @@
+import type { FC } from 'react';
+import { LoginIntent } from '@owlmeans/client-auth/login';
+/** What the surrogate window is doing, from the point of view of the person watching it. */
+export declare enum SurrogateStage {
+    /** Working. No control — there is nothing for the user to do but wait. */
+    Working = "working",
+    /** Needs a click: the flow cannot continue without a fresh gesture. */
+    Gesture = "gesture",
+    /** Done here; handing the result back and closing. */
+    Handing = "handing",
+    /** Acted, but with no channel back to the window that asked. */
+    Orphaned = "orphaned",
+    /** Ended with nothing. */
+    Failed = "failed",
+    /** Not a surrogate at all — someone opened this address directly. */
+    Standalone = "standalone"
+}
+export interface SurrogateViewProps {
+    stage: SurrogateStage;
+    intent: LoginIntent;
+    onAction?: () => void;
+    error?: string;
+    translate?: (key: string, defaultValue: string) => string;
+}
+export declare const LoginSurrogateView: FC<SurrogateViewProps>;
+//# sourceMappingURL=view.d.ts.map

package/build/login/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/login/view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,EAAE,EAAE,MAAM,OAAO,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,4FAA4F;AAC5F,oBAAY,cAAc;IACxB,0EAA0E;IAC1E,OAAO,YAAY;IACnB,uEAAuE;IACvE,OAAO,YAAY;IACnB,sDAAsD;IACtD,OAAO,YAAY;IACnB,gEAAgE;IAChE,QAAQ,aAAa;IACrB,0BAA0B;IAC1B,MAAM,WAAW;IACjB,qEAAqE;IACrE,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAA;CAC1D;AAoDD,eAAO,MAAM,kBAAkB,EAAE,EAAE,CAAC,kBAAkB,CAgBrD,CAAA"}

package/build/login/view.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { LoginIntent } from '@owlmeans/client-auth/login';
+/** What the surrogate window is doing, from the point of view of the person watching it. */
+export var SurrogateStage;
+(function (SurrogateStage) {
+    /** Working. No control — there is nothing for the user to do but wait. */
+    SurrogateStage["Working"] = "working";
+    /** Needs a click: the flow cannot continue without a fresh gesture. */
+    SurrogateStage["Gesture"] = "gesture";
+    /** Done here; handing the result back and closing. */
+    SurrogateStage["Handing"] = "handing";
+    /** Acted, but with no channel back to the window that asked. */
+    SurrogateStage["Orphaned"] = "orphaned";
+    /** Ended with nothing. */
+    SurrogateStage["Failed"] = "failed";
+    /** Not a surrogate at all — someone opened this address directly. */
+    SurrogateStage["Standalone"] = "standalone";
+})(SurrogateStage || (SurrogateStage = {}));
+/**
+ * The whole of what a login window shows.
+ *
+ * Plain elements and inline styles on purpose. This renders in a popup opened by a `web-panel` app,
+ * a `mui-panel` app and a generated Tailwind app alike, and none of their stylesheets is loaded
+ * here — a class name would simply do nothing. It is also the reason this component carries no
+ * dependency on a UI family at all.
+ */
+const box = {
+    maxWidth: '22rem', margin: '15vh auto', padding: '1.5rem', textAlign: 'center',
+    fontFamily: 'system-ui, sans-serif', lineHeight: 1.5,
+};
+const action = {
+    marginTop: '1rem', padding: '.625rem 1.25rem', fontSize: '1rem',
+    cursor: 'pointer', borderRadius: '.375rem', border: '1px solid currentColor',
+};
+const COPY = {
+    [SurrogateStage.Working]: { key: 'working', en: 'Signing you in…' },
+    [SurrogateStage.Gesture]: {
+        key: 'gesture.title', en: 'Continue to sign in.', action: ['gesture.action', 'Sign in'],
+    },
+    [SurrogateStage.Handing]: { key: 'handing', en: 'Done. Returning to the application…' },
+    [SurrogateStage.Orphaned]: {
+        key: 'orphaned', en: 'Signed in. You can close this window and continue in the application.',
+        action: ['close', 'Close'],
+    },
+    [SurrogateStage.Failed]: {
+        key: 'failed', en: 'That did not complete. You can close this window and try again.',
+        action: ['close', 'Close'],
+    },
+    [SurrogateStage.Standalone]: {
+        key: 'standalone.title', en: 'This page is used to sign in from another window.',
+        action: ['standalone.action', 'Open the application'],
+    },
+};
+const LOGOUT_COPY = {
+    [SurrogateStage.Working]: { key: 'working', en: 'Signing you out…' },
+    [SurrogateStage.Gesture]: { key: 'gesture.title', en: 'Continue to sign out.' },
+    [SurrogateStage.Handing]: { key: 'handing', en: 'Signed out. Returning to the application…' },
+    [SurrogateStage.Orphaned]: {
+        key: 'orphaned', en: 'Signed out. You can close this window.',
+    },
+    [SurrogateStage.Failed]: {
+        key: 'failed', en: 'Sign-out did not complete here. You can close this window.',
+    },
+};
+export const LoginSurrogateView = ({ stage, intent, onAction, error, translate }) => {
+    const t = translate ?? ((_key, defaultValue) => defaultValue);
+    const scope = intent === LoginIntent.Logout ? 'logout' : 'login';
+    const base = COPY[stage];
+    const copy = (intent === LoginIntent.Logout ? LOGOUT_COPY[stage] : undefined) ?? base;
+    return _jsxs("div", { style: box, "data-surrogate-stage": stage, "data-surrogate-intent": intent, children: [_jsx("p", { children: t(`surrogate.${scope}.${copy.key}`, copy.en) }), error != null && error !== '' &&
+                _jsx("p", { style: { color: '#b00', fontSize: '.875rem' }, role: "alert", children: error }), base.action != null && onAction != null && _jsx("button", { type: "button", style: action, onClick: onAction, children: t(`surrogate.${scope}.${base.action[0]}`, base.action[1]) })] });
+};
+//# sourceMappingURL=view.js.map

package/build/login/view.js.map

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

package/build/main.d.ts

@@ -1,5 +1,13 @@
 import type { ReactNode } from 'react';
 import type { AppConfig, AppContext, RenderOptions } from './types.js';
 export declare const render: (node: ReactNode, opts?: RenderOptions) => void;
-export declare const renderApp: <C extends AppConfig, T extends AppContext<C>>(context: T, opts?: RenderOptions) => void;
+/**
+ * Mount the application.
+ *
+ * `children` are rendered inside the context provider and BEFORE the router, which makes them the
+ * app's global overlay slot: a consent dialog, a toast surface, anything that must exist on every
+ * route and outlive navigation. A component mounted inside a route instead is torn down and
+ * rebuilt on every navigation, which for a dialog means it closes itself.
+ */
+export declare const renderApp: <C extends AppConfig, T extends AppContext<C>>(context: T, opts?: RenderOptions, children?: ReactNode) => void;
 //# sourceMappingURL=main.d.ts.map

package/build/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAGtE,eAAO,MAAM,MAAM,SAAU,SAAS,SAAS,aAAa,SAkB3D,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,aAAa,SAC5D,CAAA"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAGtE,eAAO,MAAM,MAAM,SAAU,SAAS,SAAS,aAAa,SAkB3D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,WAC3D,CAAC,SAAS,aAAa,aAAa,SAAS,SACQ,CAAA"}