@loopbacktools/app 0.4.0 → 0.4.1

package/README.md

@@ -28,6 +28,9 @@ const App = createLoopbackApp({
 		},
 		// Shown at /sign-in; once someone is signed in, the app sends them on to `next`.
 		SignIn: ({ next }) => <YourSignIn returnTo={next} />,
+		// Optional: a page of the server's that signing in continues to, loaded in full.
+		continueAt: (search) =>
+			search.has("client_id") ? `/api/auth/oauth2/authorize?${search}` : undefined,
 	},
 	workspaces: {
 		useList: () => useYourWorkspaces(), // [{ id, name }], or undefined while loading
@@ -63,7 +66,9 @@ it keeps them. The app imports no sign-in library; a test keeps it that way.
   `useClient` gives for it. The server's links to asks are of this form.
 - `/w/:workspace/connect`: how to connect an agent. Whether agents sign in with OAuth or send a token
   comes from the server itself.
-- `/sign-in`: the deployment's own sign-in page.
+- `/sign-in`: the deployment's own sign-in page. Once someone is signed in, it sends them on to
+  `next`, a path in the app, or to the page `continueAt` names, loaded in full: an OAuth
+  authorization an agent started, say.
 - `/`: the workspace the person prefers (`usePreferred`), or their first. An old link, `/#/<id>`, is
   followed to that ask.
 - The deployment's pages. They stand alone, without the inbox's header; `Page` and `Section` give

package/dist/src/app.js

@@ -4,9 +4,10 @@ import { useAtomValue } from "@effect/atom-react";
 import { Inbox, InboxProvider } from "@loopbacktools/inbox";
 import { Plus, Tray } from "@phosphor-icons/react";
 import { AsyncResult, Atom } from "effect/reactivity";
-import { createContext, forwardRef, use, useCallback, } from "react";
+import { createContext, forwardRef, use, useCallback, useEffect, } from "react";
 import { BrowserRouter, Link, Navigate, Route, Routes, useLocation, useNavigate, useParams, useSearchParams, } from "react-router";
 import { Header } from "./header.js";
+import { loadPage } from "./location.js";
 import { Page, Section } from "./page.js";
 import { askInOldLink, safeNext, workspacePath } from "./paths.js";
 function Waiting() {
@@ -52,7 +53,7 @@ const noPreference = () => undefined;
  * The deployment's hooks are bound here, once: the app's pages call the same ones on every render.
  */
 export const createLoopbackApp = (options) => {
-    const { SignIn } = options.session;
+    const { SignIn, continueAt } = options.session;
     const useSignedIn = options.session.useSignedIn;
     const useList = options.workspaces.useList;
     const usePreferred = options.workspaces.usePreferred ?? noPreference;
@@ -71,12 +72,20 @@ export const createLoopbackApp = (options) => {
         }
         return _jsx(SignedInContext, { value: signedIn, children: children });
     }
-    /** The deployment's sign-in page, until the person is signed in; then where they were going. */
+    /**
+     * The deployment's sign-in page, until the person is signed in; then where they were going: a
+     * page of the server's the deployment names, loaded in full, or else `next`.
+     */
     function SignInPage() {
         const signedIn = useSignedIn();
         const [search] = useSearchParams();
         const next = safeNext(search.get("next"));
-        if (signedIn === undefined)
+        const onward = signedIn == null ? undefined : continueAt?.(search);
+        useEffect(() => {
+            if (onward !== undefined)
+                loadPage(onward);
+        }, [onward]);
+        if (signedIn === undefined || onward !== undefined)
             return _jsx(Waiting, {});
         if (signedIn !== null)
             return _jsx(Navigate, { to: next, replace: true });

package/dist/src/location.d.ts

@@ -0,0 +1,2 @@
+/** Loads a page in full, as one of the server's own pages needs, rather than routing to it. */
+export declare const loadPage: (url: string) => void;

package/dist/src/location.js

@@ -0,0 +1,2 @@
+/** Loads a page in full, as one of the server's own pages needs, rather than routing to it. */
+export const loadPage = (url) => window.location.assign(url);

package/dist/src/ports.d.ts

@@ -21,6 +21,12 @@ export interface Session {
     readonly SignIn: ComponentType<{
         readonly next: string;
     }>;
+    /**
+     * Where someone at the sign-in page goes once signed in, when it is a page of the server's
+     * rather than the app's, as an authorization an agent started is. The app loads it in full, in
+     * place of routing to `next`. Given the sign-in page's query; `undefined` for no such page.
+     */
+    readonly continueAt?: (search: URLSearchParams) => string | undefined;
 }
 /** A workspace someone can open: one Loopback space. */
 export interface WorkspaceSummary {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loopbacktools/app",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "The Loopback app: the inbox, routed, with its header and pages, for a deployment to compose with its own sign-in and workspaces.",
   "homepage": "https://github.com/LoopBackTools/loopback/tree/main/packages/app#readme",
   "license": "MIT",
@@ -49,8 +49,8 @@
     "typescript": "7.0.2",
     "vite": "8.3.5",
     "vitest": "5.0.5",
-    "@loopbacktools/inbox": "0.4.0",
-    "@loopbacktools/sdk": "0.4.0"
+    "@loopbacktools/inbox": "0.4.1",
+    "@loopbacktools/sdk": "0.4.1"
   },
   "peerDependencies": {
     "@cloudflare/kumo": "^2.15.0",
@@ -59,8 +59,8 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-router": "^8.3.0",
-    "@loopbacktools/inbox": "^0.4.0",
-    "@loopbacktools/sdk": "^0.4.0"
+    "@loopbacktools/inbox": "^0.4.1",
+    "@loopbacktools/sdk": "^0.4.1"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/app.tsx

@@ -20,6 +20,7 @@ import {
 	type ReactNode,
 	use,
 	useCallback,
+	useEffect,
 } from "react";
 import {
 	BrowserRouter,
@@ -33,6 +34,7 @@ import {
 	useSearchParams,
 } from "react-router";
 import { Header } from "./header.tsx";
+import { loadPage } from "./location.ts";
 import { Page, Section } from "./page.tsx";
 import { askInOldLink, safeNext, workspacePath } from "./paths.ts";
 import type { LoopbackAppOptions, SignedIn as Signed } from "./ports.ts";
@@ -136,7 +138,7 @@ const noPreference = (): string | undefined => undefined;
  * The deployment's hooks are bound here, once: the app's pages call the same ones on every render.
  */
 export const createLoopbackApp = (options: LoopbackAppOptions): ComponentType => {
-	const { SignIn } = options.session;
+	const { SignIn, continueAt } = options.session;
 	const useSignedIn = options.session.useSignedIn;
 	const useList = options.workspaces.useList;
 	const usePreferred = options.workspaces.usePreferred ?? noPreference;
@@ -156,12 +158,19 @@ export const createLoopbackApp = (options: LoopbackAppOptions): ComponentType =>
 		return <SignedInContext value={signedIn}>{children}</SignedInContext>;
 	}
 
-	/** The deployment's sign-in page, until the person is signed in; then where they were going. */
+	/**
+	 * The deployment's sign-in page, until the person is signed in; then where they were going: a
+	 * page of the server's the deployment names, loaded in full, or else `next`.
+	 */
 	function SignInPage() {
 		const signedIn = useSignedIn();
 		const [search] = useSearchParams();
 		const next = safeNext(search.get("next"));
-		if (signedIn === undefined) return <Waiting />;
+		const onward = signedIn == null ? undefined : continueAt?.(search);
+		useEffect(() => {
+			if (onward !== undefined) loadPage(onward);
+		}, [onward]);
+		if (signedIn === undefined || onward !== undefined) return <Waiting />;
 		if (signedIn !== null) return <Navigate to={next} replace />;
 		return <SignIn next={next} />;
 	}

package/src/location.ts

@@ -0,0 +1,2 @@
+/** Loads a page in full, as one of the server's own pages needs, rather than routing to it. */
+export const loadPage = (url: string): void => window.location.assign(url);

package/src/ports.ts

@@ -25,6 +25,12 @@ export interface Session {
 	 * `next`, the path they were going to.
 	 */
 	readonly SignIn: ComponentType<{ readonly next: string }>;
+	/**
+	 * Where someone at the sign-in page goes once signed in, when it is a page of the server's
+	 * rather than the app's, as an authorization an agent started is. The app loads it in full, in
+	 * place of routing to `next`. Given the sign-in page's query; `undefined` for no such page.
+	 */
+	readonly continueAt?: (search: URLSearchParams) => string | undefined;
 }
 
 /** A workspace someone can open: one Loopback space. */