@korso/shepherd-ui 0.9.1 → 0.10.0

package/dist/JoinWorkspace.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceSummaryT } from "@shepherd/shared";
+export interface JoinWorkspaceProps {
+    /** The raw invite code from the URL segment, forwarded opaquely to the hub. */
+    code: string;
+    /**
+     * Invoked once the redeem succeeds, with the workspace just joined. The host
+     * navigates to its board surface; the component keeps showing the success
+     * state until that navigation lands.
+     */
+    onJoined: (workspace: WorkspaceSummaryT) => void;
+}
+export declare function JoinWorkspace({ code, onJoined }: JoinWorkspaceProps): import("react").JSX.Element;

package/dist/JoinWorkspace.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useId, useRef, useState } from "react";
+import { useShepherdClient } from "./context.js";
+import { describeError } from "./client.js";
+export function JoinWorkspace({ code, onJoined }) {
+    const client = useShepherdClient();
+    const headingId = useId();
+    const [state, setState] = useState({ status: "joining" });
+    // Keep the latest onJoined without re-triggering the mount redeem when a
+    // host passes a fresh callback identity each render.
+    const onJoinedRef = useRef(onJoined);
+    onJoinedRef.current = onJoined;
+    const redeem = useCallback(async () => {
+        setState({ status: "joining" });
+        try {
+            const res = await client.redeemInvite(code);
+            setState({ status: "joined", workspace: res.workspace });
+            onJoinedRef.current(res.workspace);
+        }
+        catch (err) {
+            setState({ status: "error", message: describeError(err) });
+        }
+    }, [client, code]);
+    // Redeem once on mount. The ref guard keeps StrictMode's dev double-mount
+    // (which preserves refs across the simulated remount) from firing twice.
+    const started = useRef(false);
+    useEffect(() => {
+        if (started.current)
+            return;
+        started.current = true;
+        void redeem();
+    }, [redeem]);
+    return (_jsx("section", { className: "shepherd-join", "aria-labelledby": headingId, children: _jsxs("div", { className: "shepherd-join__card", children: [_jsx("p", { className: "shepherd-join__brand", children: "Shepherd" }), state.status === "joining" && (_jsxs(_Fragment, { children: [_jsx("h1", { id: headingId, children: "Joining workspace\u2026" }), _jsx("p", { className: "shepherd-join__copy", role: "status", children: "Hold on while we add you to the team." }), _jsx("div", { className: "shepherd-join__spinner", "aria-hidden": "true" })] })), state.status === "joined" && (_jsxs(_Fragment, { children: [_jsx("h1", { id: headingId, children: "You\u2019re in" }), _jsxs("p", { className: "shepherd-join__copy", role: "status", children: ["Joined ", _jsx("strong", { children: state.workspace.name }), ". Taking you to the board\u2026"] })] })), state.status === "error" && (_jsxs(_Fragment, { children: [_jsx("h1", { id: headingId, children: "Couldn\u2019t join the workspace" }), _jsx("p", { className: "shepherd-join__error", role: "alert", children: state.message }), _jsx("button", { type: "button", className: "shepherd-join__retry", onClick: () => void redeem(), children: "Try again" })] }))] }) }));
+}

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export type { ShepherdClient, ShepherdClientConfig } from "./client.js";
 export { ShepherdClientProvider, useShepherdClient, } from "./context.js";
 export { ShepherdRoot } from "./ShepherdRoot.js";
 export type { ShepherdRootProps } from "./ShepherdRoot.js";
+export { JoinWorkspace } from "./JoinWorkspace.js";
+export type { JoinWorkspaceProps } from "./JoinWorkspace.js";
 export { Dashboard } from "./components/Dashboard.js";
 export type { DashboardProps } from "./components/Dashboard.js";
 export { ConfigPanel, WorkspaceSwitcher, GeneralSettings, Members, Invites, ConnectAgent, EmptyState, } from "./config/index.js";

package/dist/index.js

@@ -9,6 +9,9 @@
 export { createShepherdClient, ShepherdClientError, describeError, } from "./client.js";
 export { ShepherdClientProvider, useShepherdClient, } from "./context.js";
 export { ShepherdRoot } from "./ShepherdRoot.js";
+// The invite-link landing surface — auto-redeems a code and reports the joined
+// workspace so the host can navigate to the board.
+export { JoinWorkspace } from "./JoinWorkspace.js";
 export { Dashboard } from "./components/Dashboard.js";
 // Config screens — re-exported so consumers can compose the management surface
 // directly without the full ShepherdRoot shell.

package/dist/lib/index.d.ts

@@ -254,6 +254,19 @@ export declare interface InvitesProps {
     onMembersChanged?: () => void;
 }
 
+export declare function JoinWorkspace({ code, onJoined }: JoinWorkspaceProps): JSX_2.Element;
+
+export declare interface JoinWorkspaceProps {
+    /** The raw invite code from the URL segment, forwarded opaquely to the hub. */
+    code: string;
+    /**
+     * Invoked once the redeem succeeds, with the workspace just joined. The host
+     * navigates to its board surface; the component keeps showing the success
+     * state until that navigation lands.
+     */
+    onJoined: (workspace: WorkspaceSummaryT) => void;
+}
+
 declare const ListMembersResponse: z.ZodObject<{
     members: z.ZodArray<z.ZodObject<{
         accountId: z.ZodString;