@cosmoops/connect-sdk 0.9.0 → 0.16.0

package/dist/cjs/client/components/user-menu.js

@@ -1,6 +1,8 @@
 "use client";
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectProfileModal = ConnectProfileModal;
+exports.ConnectUserButton = ConnectUserButton;
 exports.ConnectUserMenu = ConnectUserMenu;
 exports.ConnectManageSubscriptionButton = ConnectManageSubscriptionButton;
 exports.ConnectInvoicesButton = ConnectInvoicesButton;
@@ -13,6 +15,8 @@ const lucide_react_1 = require("lucide-react");
 const provider_js_1 = require("../provider.js");
 const mark_js_1 = require("../mark.js");
 const account_sessions_js_1 = require("./account-sessions.js");
+const motion_js_1 = require("./motion.js");
+const shell_context_js_1 = require("./shell-context.js");
 const surfaces_js_1 = require("./surfaces.js");
 const THEME_OPTIONS = [
     { value: "light", label: "Light", icon: lucide_react_1.Sun },
@@ -61,7 +65,15 @@ function profileUrl(appUrl, clientId) {
  * had set on their profile.
  */
 function UserAvatar({ user, size, }) {
-    return ((0, jsx_runtime_1.jsxs)(react_1.Avatar, { size: size, color: "accent", variant: "soft", children: [user.photoUrl && (0, jsx_runtime_1.jsx)(react_1.Avatar.Image, { alt: "", src: user.photoUrl }), (0, jsx_runtime_1.jsx)(react_1.Avatar.Fallback, { children: initials(user.displayName, user.email) })] }));
+    return (
+    // `rounded-full` is an override, not decoration. HeroUI's `.avatar` is a
+    // squircle - `rounded-2xl` at `sm`, `rounded-3xl` at `lg` - which is right
+    // for the media component in general and wrong for a *person*: every other
+    // product a customer uses draws an account avatar as a circle, and a
+    // squircle sitting beside circular status dots reads as a rendering fault
+    // rather than a choice. The root is `overflow-hidden`, so rounding it here
+    // rounds the image and the fallback with it.
+    (0, jsx_runtime_1.jsxs)(react_1.Avatar, { size: size, color: "accent", variant: "soft", className: "rounded-full", children: [user.photoUrl && (0, jsx_runtime_1.jsx)(react_1.Avatar.Image, { alt: "", src: user.photoUrl }), (0, jsx_runtime_1.jsx)(react_1.Avatar.Fallback, { children: initials(user.displayName, user.email) })] }));
 }
 /** `dispatch_admin` / `billing-viewer` -> `Dispatch admin`. */
 function humanizeRole(role) {
@@ -116,55 +128,102 @@ function DestinationTile({ icon, label, url, }) {
     return ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", "aria-label": `${label} (opens in a new tab)`, className: `relative h-auto w-full flex-col items-center justify-center gap-2 rounded-xl border border-border ${surfaces_js_1.PANEL_FILL} p-3 hover:border-accent hover:bg-surface-secondary`, onPress: () => openExternal(url), children: [(0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "absolute end-2 top-2 size-3.5 text-muted", "aria-hidden": "true" }), (0, jsx_runtime_1.jsx)("span", { className: `flex ${surfaces_js_1.MEDALLION} items-center justify-center rounded-xl bg-surface text-muted`, children: icon }), (0, jsx_runtime_1.jsx)("span", { className: "text-xs font-medium text-foreground", children: label })] }));
 }
 /**
- * Avatar and name in the trigger; an identity card, the three Connect
- * destinations (Profile, Billing, Connect), an optional appearance control,
- * this account's active sessions, and sign-out in the modal it opens.
+ * The account modal's contents - identity card, the three Connect
+ * destinations, an optional appearance control, this account's sessions, and
+ * sign-out.
+ *
+ * Extracted from the trigger it used to be welded to, so the same surface can
+ * be opened from the sidebar's account row (`ConnectUserButton`) *or* from a
+ * host's own control (`ConnectProfileModal`) without a second copy of it. It
+ * renders the `Modal.Backdrop` downwards only; whoever renders it supplies the
+ * `<Modal>` and decides how it opens.
  *
  * Profile/Billing/Connect open in a **new tab**, each marked with an
- * external-link icon. They are a different application at a different
- * origin, and navigating the host app away to reach them would lose
- * whatever the user was doing here. Sign out is the only action that acts
- * in place, which is why it sits alone in the footer rather than as a fourth
- * item in the same list as three navigations.
+ * external-link icon. They are a different application at a different origin,
+ * and navigating the host app away to reach them would lose whatever the user
+ * was doing here. Sign out is the only action that acts in place, which is why
+ * it sits alone in the footer rather than as a fourth item in the same list as
+ * three navigations.
+ */
+function ProfileSurface({ onSignOut, theme, onThemeChange, }) {
+    const { session, signOut, appUrl, clientId } = (0, provider_js_1.useConnect)();
+    const user = session?.user;
+    if (!user)
+        return null;
+    const label = user.displayName ?? user.email ?? "Account";
+    const role = session?.role ?? null;
+    const planChip = subscriptionChip(session?.subscription ?? null);
+    return ((0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { size: "md", scroll: "inside", children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { children: [(0, jsx_runtime_1.jsx)(react_1.Modal.CloseTrigger, {}), (0, jsx_runtime_1.jsx)(react_1.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Heading, { children: "Account" }) }), (0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "flex flex-col gap-5", children: [(0, jsx_runtime_1.jsxs)("div", { className: `flex items-start gap-3 rounded-xl border border-border ${surfaces_js_1.PANEL_FILL} p-4`, children: [(0, jsx_runtime_1.jsx)(UserAvatar, { user: user, size: "lg" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-sm font-semibold text-foreground", children: label }), user.email && (0, jsx_runtime_1.jsx)("p", { className: "truncate text-xs text-muted", children: user.email }), (0, jsx_runtime_1.jsx)("p", { className: "truncate text-xs text-muted", children: user.workspaceName }), (role || planChip || !user.emailVerified) && ((0, jsx_runtime_1.jsxs)("div", { className: "mt-1.5 flex flex-wrap items-center gap-1.5", children: [role && ((0, jsx_runtime_1.jsx)(react_1.Chip, { size: "sm", variant: "soft", color: "accent", children: humanizeRole(role) })), planChip, !user.emailVerified && ((0, jsx_runtime_1.jsx)(react_1.Chip, { size: "sm", variant: "soft", color: "warning", children: "Email unverified" }))] }))] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "grid grid-cols-3 gap-2", children: [(0, jsx_runtime_1.jsx)(DestinationTile, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.UserRound, { className: surfaces_js_1.ICON, "aria-hidden": "true" }), label: "Profile", url: profileUrl(appUrl, clientId) }), (0, jsx_runtime_1.jsx)(DestinationTile, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.CreditCard, { className: surfaces_js_1.ICON, "aria-hidden": "true" }), label: "Billing", url: `${appUrl}/billing` }), (0, jsx_runtime_1.jsx)(DestinationTile, { icon: (0, jsx_runtime_1.jsx)(mark_js_1.ConnectMark, { className: surfaces_js_1.ICON }), label: "Connect", url: appUrl })] }), theme && onThemeChange && ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-2", children: [(0, jsx_runtime_1.jsx)("p", { className: "text-sm font-medium text-foreground", children: "Appearance" }), (0, jsx_runtime_1.jsx)(react_1.ToggleButtonGroup, { fullWidth: true, "aria-label": "Theme", selectionMode: "single", disallowEmptySelection: true, selectedKeys: [theme], onSelectionChange: (keys) => {
+                                            const [next] = [...keys];
+                                            if (typeof next === "string")
+                                                onThemeChange(next);
+                                        }, children: THEME_OPTIONS.map(({ value, label: optionLabel, icon: Icon }, index) => ((0, jsx_runtime_1.jsxs)(react_1.ToggleButton, { id: value, children: [index > 0 && (0, jsx_runtime_1.jsx)(react_1.ToggleButtonGroup.Separator, {}), (0, jsx_runtime_1.jsx)(Icon, { className: "size-4", "aria-hidden": "true" }), optionLabel] }, value))) })] })), (0, jsx_runtime_1.jsx)(account_sessions_js_1.ConnectAccountSessions, {})] }), (0, jsx_runtime_1.jsx)(react_1.Modal.Footer, { children: (0, jsx_runtime_1.jsxs)(react_1.Button, { slot: "close", fullWidth: true, variant: "tertiary", className: "text-danger", onPress: () => {
+                                void signOut().then(onSignOut);
+                            }, children: [(0, jsx_runtime_1.jsx)(lucide_react_1.LogOut, { className: "size-4 shrink-0" }), "Sign out"] }) })] }) }) }));
+}
+/**
+ * The account modal with **no trigger of its own**, driven by the host.
+ *
+ * For an application that already has an account control it wants to keep -
+ * an avatar in its own chrome, a "Manage account" row in its own settings
+ * page - and wants Connect's modal behind it rather than rebuilding identity,
+ * sessions and sign-out. `ConnectUserButton` is the same modal with the
+ * trigger supplied; reach for this one only when that trigger is in the way.
  *
- * The session list is account-wide, not scoped to this application - see
- * `ConnectUserSession`'s doc comment in `types.ts`. Appearance only renders
- * when both `theme` and `onThemeChange` are supplied.
+ * Renders nothing when signed out, open or not - there is no account to show.
+ */
+function ConnectProfileModal({ isOpen, onOpenChange, onSignOut, theme, onThemeChange, }) {
+    const { session } = (0, provider_js_1.useConnect)();
+    if (!session?.user)
+        return null;
+    return ((0, jsx_runtime_1.jsx)(react_1.Modal, { isOpen: isOpen, onOpenChange: onOpenChange, children: (0, jsx_runtime_1.jsx)(ProfileSurface, { onSignOut: onSignOut, theme: theme, onThemeChange: onThemeChange }) }));
+}
+/**
+ * The signed-in account, as a control that opens the account modal.
  *
- * Renders nothing when signed out - pair it with `<ConnectLoginButton>`, which
- * renders nothing when signed *in*, and the two swap cleanly with no branch in
- * your own layout.
+ * In `"row"` form this is the last thing in the sidebar, which is where an
+ * account control belongs: it is the one item in the rail that is about *you*
+ * rather than about the product, and the foot of a column is where every
+ * application a customer already uses puts that. It collapses with the rail -
+ * the avatar holds its position and the name fades - because the avatar alone
+ * is still a complete account control, which is exactly what an icon rail
+ * needs.
+ *
+ * Renders nothing when signed out. Pair it with `<ConnectLoginButton>`, which
+ * renders nothing when signed *in*, and the two swap with no branch in your
+ * own layout.
  *
  * On the HeroUI shape: the trigger is a plain `<Button>` as a **direct child**
- * of `<Modal>`, not wrapped in `<Modal.Trigger>`. `Dropdown.Trigger` (and by
- * the same construction, `Modal.Trigger`) is itself a React Aria `Button`, so
- * wrapping one produces a button inside a button - invalid markup, and press
- * handling stops working. Kept uncontrolled (no `isOpen`/`onOpenChange`),
- * matching `<ConnectAppsGrid>`'s own `<Modal>` - nothing here needs to close
- * the modal programmatically; sign-out uses `slot="close"` instead.
+ * of `<Modal>`, not wrapped in `<Modal.Trigger>`. `Dropdown.Trigger` - and by
+ * the same construction `Modal.Trigger` - is itself a React Aria `Button`, so
+ * wrapping one produces a button inside a button: invalid markup, and press
+ * handling stops working.
  */
-function ConnectUserMenu({ compact = false, onSignOut, className, theme, onThemeChange, }) {
-    const { session, isLoading, signOut, appUrl, clientId } = (0, provider_js_1.useConnect)();
+function ConnectUserButton({ variant = "row", onSignOut, className, theme, onThemeChange, }) {
+    const { session, isLoading } = (0, provider_js_1.useConnect)();
+    const { collapsed } = (0, shell_context_js_1.useConnectShell)();
     if (isLoading) {
-        return ((0, jsx_runtime_1.jsxs)("div", { className: `flex items-center gap-2 ${className ?? ""}`, children: [(0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "size-8 shrink-0 rounded-full" }), !compact && (0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "h-4 w-24" })] }));
+        return ((0, jsx_runtime_1.jsxs)("div", { className: `flex h-10 items-center gap-3 ${variant === "row" ? "ps-[4px]" : ""} ${className ?? ""}`, children: [(0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "size-8 shrink-0 rounded-full" }), variant !== "compact" && !collapsed && (0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "h-4 w-24" })] }));
     }
     const user = session?.user;
     if (!user)
         return null;
     const label = user.displayName ?? user.email ?? "Account";
-    const role = session?.applicationRole?.role;
-    const planChip = subscriptionChip(session?.subscription ?? null);
-    return ((0, jsx_runtime_1.jsxs)(react_1.Modal, { children: [(0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", "aria-label": `Account: ${label}`, 
-                // `pl-1` against the default right padding is optical, not sloppy: a
-                // circular avatar needs less inset than a text label to look evenly
-                // seated in the button.
-                className: `gap-2 pl-1 ${className ?? ""}`, children: [(0, jsx_runtime_1.jsx)(UserAvatar, { user: user, size: "sm" }), !compact && (0, jsx_runtime_1.jsx)("span", { className: "text-sm font-medium text-foreground", children: label })] }), (0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { size: "md", scroll: "inside", children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { children: [(0, jsx_runtime_1.jsx)(react_1.Modal.CloseTrigger, {}), (0, jsx_runtime_1.jsx)(react_1.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Heading, { children: "Account" }) }), (0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "flex flex-col gap-5", children: [(0, jsx_runtime_1.jsxs)("div", { className: `flex items-start gap-3 rounded-xl border border-border ${surfaces_js_1.PANEL_FILL} p-4`, children: [(0, jsx_runtime_1.jsx)(UserAvatar, { user: user, size: "lg" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-sm font-semibold text-foreground", children: label }), user.email && (0, jsx_runtime_1.jsx)("p", { className: "truncate text-xs text-muted", children: user.email }), (0, jsx_runtime_1.jsx)("p", { className: "truncate text-xs text-muted", children: user.workspaceName }), (role || planChip || !user.emailVerified) && ((0, jsx_runtime_1.jsxs)("div", { className: "mt-1.5 flex flex-wrap items-center gap-1.5", children: [role && ((0, jsx_runtime_1.jsx)(react_1.Chip, { size: "sm", variant: "soft", color: "accent", children: humanizeRole(role) })), planChip, !user.emailVerified && ((0, jsx_runtime_1.jsx)(react_1.Chip, { size: "sm", variant: "soft", color: "warning", children: "Email unverified" }))] }))] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "grid grid-cols-3 gap-2", children: [(0, jsx_runtime_1.jsx)(DestinationTile, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.UserRound, { className: surfaces_js_1.ICON, "aria-hidden": "true" }), label: "Profile", url: profileUrl(appUrl, clientId) }), (0, jsx_runtime_1.jsx)(DestinationTile, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.CreditCard, { className: surfaces_js_1.ICON, "aria-hidden": "true" }), label: "Billing", url: `${appUrl}/billing` }), (0, jsx_runtime_1.jsx)(DestinationTile, { icon: (0, jsx_runtime_1.jsx)(mark_js_1.ConnectMark, { className: surfaces_js_1.ICON }), label: "Connect", url: appUrl })] }), theme && onThemeChange && ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-2", children: [(0, jsx_runtime_1.jsx)("p", { className: "text-sm font-medium text-foreground", children: "Appearance" }), (0, jsx_runtime_1.jsx)(react_1.ToggleButtonGroup, { fullWidth: true, "aria-label": "Theme", selectionMode: "single", disallowEmptySelection: true, selectedKeys: [theme], onSelectionChange: (keys) => {
-                                                    const [next] = [...keys];
-                                                    if (typeof next === "string")
-                                                        onThemeChange(next);
-                                                }, children: THEME_OPTIONS.map(({ value, label: optionLabel, icon: Icon }, index) => ((0, jsx_runtime_1.jsxs)(react_1.ToggleButton, { id: value, children: [index > 0 && (0, jsx_runtime_1.jsx)(react_1.ToggleButtonGroup.Separator, {}), (0, jsx_runtime_1.jsx)(Icon, { className: "size-4", "aria-hidden": "true" }), optionLabel] }, value))) })] })), (0, jsx_runtime_1.jsx)(account_sessions_js_1.ConnectAccountSessions, {})] }), (0, jsx_runtime_1.jsx)(react_1.Modal.Footer, { children: (0, jsx_runtime_1.jsxs)(react_1.Button, { slot: "close", fullWidth: true, variant: "tertiary", className: "text-danger", onPress: () => {
-                                        void signOut().then(onSignOut);
-                                    }, children: [(0, jsx_runtime_1.jsx)(lucide_react_1.LogOut, { className: "size-4 shrink-0" }), "Sign out"] }) })] }) }) })] }));
+    return ((0, jsx_runtime_1.jsxs)(react_1.Modal, { children: [variant === "row" ? ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", "aria-label": `Account: ${label}`, className: (0, shell_context_js_1.sidebarRowClass)({ tile: true, className }), children: [(0, jsx_runtime_1.jsx)(UserAvatar, { user: user, size: "sm" }), (0, jsx_runtime_1.jsx)(shell_context_js_1.SidebarLabel, { children: (0, jsx_runtime_1.jsxs)("span", { className: "flex min-w-0 flex-col text-start leading-tight", children: [(0, jsx_runtime_1.jsx)("span", { className: "truncate text-sm font-medium text-foreground", children: label }), user.email && user.email !== label && ((0, jsx_runtime_1.jsx)("span", { className: "truncate text-xs font-normal text-muted", children: user.email }))] }) }), (0, jsx_runtime_1.jsx)(motion_js_1.m.span, { className: "shrink-0 text-muted", animate: { opacity: collapsed ? 0 : 1 }, transition: collapsed ? { duration: 0.1 } : { duration: 0.18, delay: 0.1 }, "aria-hidden": true, children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronsUpDown, { className: "size-4" }) })] })) : ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", "aria-label": `Account: ${label}`, 
+                // `ps-1` against the default trailing padding is optical, not
+                // sloppy: a circular avatar needs less inset than a text label to
+                // look evenly seated in the button.
+                className: `gap-2 ps-1 ${className ?? ""}`, children: [(0, jsx_runtime_1.jsx)(UserAvatar, { user: user, size: "sm" }), variant === "inline" && (0, jsx_runtime_1.jsx)("span", { className: "text-sm font-medium text-foreground", children: label })] })), (0, jsx_runtime_1.jsx)(ProfileSurface, { onSignOut: onSignOut, theme: theme, onThemeChange: onThemeChange })] }));
+}
+/**
+ * @deprecated Renamed to `ConnectUserButton` in 0.12 - it is one button that
+ * opens a modal, and calling it a "menu" had people looking for a dropdown
+ * that never existed. `compact` maps to `variant="compact"`, and the old
+ * default (avatar plus name) to `variant="inline"`. This alias will be removed
+ * in a later minor.
+ */
+function ConnectUserMenu({ compact = false, ...rest }) {
+    return (0, jsx_runtime_1.jsx)(ConnectUserButton, { variant: compact ? "compact" : "inline", ...rest });
 }
 /**
  * The "Manage subscription" action on its own, for layouts that want it

package/dist/cjs/client/components/workspace-switcher.js

@@ -0,0 +1,100 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectWorkspaceSwitcher = ConnectWorkspaceSwitcher;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@heroui/react");
+const lucide_react_1 = require("lucide-react");
+const provider_js_1 = require("../provider.js");
+const motion_js_1 = require("./motion.js");
+const shell_context_js_1 = require("./shell-context.js");
+/** `Acme Logistics` -> `AL`. The collapsed rail's whole label for a workspace. */
+function workspaceInitials(name) {
+    const parts = name.trim().split(/\s+/).filter(Boolean);
+    return (parts.slice(0, 2).map((part) => part[0]).join("") || "?").toUpperCase();
+}
+/**
+ * Switches which workspace this application is looking at.
+ *
+ * **Rendered in the `AppShell` sidebar header by default**, directly
+ * under the brand - which workspace you are in scopes everything below it, so
+ * it reads as a heading for the nav rather than as one more destination.
+ *
+ * It decides for itself whether to appear: an account with one workspace is
+ * shown nothing, because a switcher offering one option teaches the user
+ * nothing and costs a row of chrome on every screen. That is the opposite of
+ * Connect's own switcher, which always renders - Connect is where a workspace
+ * is *created*, so hiding it at one workspace would guarantee nobody ever
+ * reached two. A partner application creates nothing, so it has no such duty.
+ *
+ * **Authorization is the data, not a prop.** The list comes from the caller's
+ * own session (`GET /workspaces` takes no user id), so a workspace the user
+ * may not reach is simply not in it. There is deliberately no `roles` prop to
+ * pass or forget - the only way to render a row is for Connect to have
+ * returned it.
+ *
+ * Rows the user *belongs to* but cannot use here - a workspace outside the
+ * application's audience, or one with no subscription - are shown **disabled
+ * with the reason** rather than hidden. Hiding them reads as data loss to the
+ * person who owns the workspace; `switch` refuses the same two cases, so the
+ * label and the outcome always agree.
+ *
+ * A switch rotates the session token. The bridge persists the new one in the
+ * host application's own session store and the token never reaches this
+ * component - so the only thing to do afterwards is reload, which is what
+ * `onSwitched` defaults to.
+ */
+function ConnectWorkspaceSwitcher({ onSwitched, row = true, className, }) {
+    const { mutateResource } = (0, provider_js_1.useConnect)();
+    const { collapsed } = (0, shell_context_js_1.useConnectShell)();
+    const user = (0, provider_js_1.useConnectUser)();
+    const { data, isLoading } = (0, provider_js_1.useConnectWorkspaces)();
+    const [switching, setSwitching] = (0, react_1.useState)(null);
+    const [error, setError] = (0, react_1.useState)(null);
+    const workspaces = data?.workspaces ?? [];
+    // Nothing to switch between, or nothing loaded yet. Deliberately renders
+    // `null` rather than a skeleton: this sits in persistent chrome, and a
+    // placeholder that resolves to nothing for most accounts is worse than
+    // appearing a moment late for the few who have two.
+    if (isLoading || workspaces.length < 2)
+        return null;
+    const active = workspaces.find((workspace) => workspace.isActive);
+    const label = active?.name ?? user?.workspaceName ?? "Workspace";
+    const handleSwitch = async (workspace) => {
+        if (workspace.isActive || !selectable(workspace))
+            return;
+        setSwitching(workspace.workspaceId);
+        setError(null);
+        try {
+            // Through the provider's own bridge caller rather than a bare `fetch`,
+            // so this inherits the configured `basePath`, the credentials mode and
+            // the error shape every other call in the SDK uses.
+            await mutateResource("/workspaces/switch", { workspaceId: workspace.workspaceId });
+            if (onSwitched) {
+                onSwitched(workspace);
+            }
+            else {
+                window.location.reload();
+            }
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : "Could not switch workspace");
+            setSwitching(null);
+        }
+    };
+    return ((0, jsx_runtime_1.jsxs)("div", { className: row ? "" : className, children: [(0, jsx_runtime_1.jsxs)(react_2.Dropdown, { children: [row ? (
+                    // A 32px tile rather than a 20px glyph, so the initials land on the
+                    // same optical centre the avatar below them uses - see
+                    // `SIDEBAR_ROW_TILE`. Collapsed, this tile *is* the switcher.
+                    (0, jsx_runtime_1.jsxs)(react_2.Button, { variant: "tertiary", "aria-label": `Workspace: ${label}. Switch workspace`, className: (0, shell_context_js_1.sidebarRowClass)({ tile: true, className }), children: [(0, jsx_runtime_1.jsx)("span", { className: "flex size-8 shrink-0 items-center justify-center rounded-lg bg-accent-soft text-xs font-semibold text-accent", children: workspaceInitials(label) }), (0, jsx_runtime_1.jsx)(shell_context_js_1.SidebarLabel, { className: "text-sm font-medium text-foreground", children: label }), (0, jsx_runtime_1.jsx)(motion_js_1.m.span, { className: "shrink-0 text-muted", animate: { opacity: collapsed ? 0 : 1 }, transition: collapsed ? { duration: 0.1 } : { duration: 0.18, delay: 0.1 }, "aria-hidden": true, children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronsUpDown, { className: "size-4" }) })] })) : ((0, jsx_runtime_1.jsxs)(react_2.Button, { variant: "secondary", size: "sm", className: "w-full justify-between", children: [(0, jsx_runtime_1.jsx)("span", { className: "truncate", children: label }), (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronsUpDown, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" })] })), (0, jsx_runtime_1.jsx)(react_2.Dropdown.Popover, { children: (0, jsx_runtime_1.jsx)(react_2.ListBox, { children: workspaces.map((workspace) => ((0, jsx_runtime_1.jsxs)(react_2.ListBox.Item, { id: workspace.workspaceId, textValue: workspace.name, isDisabled: !selectable(workspace) || switching !== null, onAction: () => void handleSwitch(workspace), children: [(0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-sm", children: workspace.name }), selectable(workspace) ? null : ((0, jsx_runtime_1.jsx)("p", { className: "truncate text-xs text-muted", children: reasonUnavailable(workspace) }))] }), (0, jsx_runtime_1.jsx)(react_2.ListBox.ItemIndicator, {})] }, workspace.workspaceId))) }) })] }), error && !collapsed ? (0, jsx_runtime_1.jsx)("p", { className: "mt-1 px-2 text-xs text-danger", children: error }) : null] }));
+}
+/** Belongs to the user, and usable here. The same two facts `switch` enforces. */
+function selectable(workspace) {
+    return workspace.inAudience && workspace.subscribed;
+}
+function reasonUnavailable(workspace) {
+    if (!workspace.inAudience)
+        return "Not available for this kind of workspace";
+    return "No active subscription";
+}

package/dist/cjs/client/index.js

@@ -1,8 +1,9 @@
 "use client";
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_EMPTY_VALUE = exports.aiStatusTone = exports.isNumericAiFormat = exports.formatAiValue = exports.AiSources = exports.AiSteps = exports.AiDetails = exports.AiTimeline = exports.AiMetrics = exports.AiChart = exports.AiTable = exports.ConnectAskAi = exports.ConnectAppsGrid = exports.gateExemptPaths = exports.isNavItemActive = exports.resolveActivePath = exports.normalizePath = exports.flattenNav = exports.normalizeNav = exports.useActivePath = exports.ConnectSideNav = exports.AppShell = exports.ConnectAccountSessions = exports.ConnectSignOutButton = exports.ConnectHomeButton = exports.ConnectProfileButton = exports.ConnectInvoicesButton = exports.ConnectManageSubscriptionButton = exports.ConnectUserMenu = exports.ConnectRegisterButton = exports.ConnectLoginButton = exports.ConnectLogo = exports.ConnectMark = exports.isConnectError = exports.ConnectError = exports.normalizePlanFeatures = exports.blockingBlockers = exports.CONNECT_APP_URL = exports.useConnectResource = exports.useConnectIntegrations = exports.useConnectSessions = exports.useConnectAddonUsage = exports.useConnectApps = exports.useConnectPlans = exports.useConnectEntitlements = exports.useConnectAudience = exports.useConnectWorkspaceType = exports.useConnectUser = exports.useConnect = exports.ConnectProvider = void 0;
-exports.resolvePlanGroup = exports.groupPlansByTier = exports.ACTION_LABEL = exports.discountLabel = exports.annualSaving = exports.resolveAction = exports.monthlyOf = exports.formatPrice = exports.buildCheckoutUrl = exports.useConnectCheckout = exports.ConnectPlansPage = exports.ConnectUsageMeter = exports.ConnectWorkspaceTypeGate = exports.useConnectFeature = exports.ConnectFeatureGate = exports.useConnectAccessGate = exports.ConnectAccessGate = exports.ConnectReadinessGate = exports.ConnectReadinessBanner = exports.resolveSubscriptionState = exports.ConnectSeatUsage = exports.ConnectTrialBanner = exports.ConnectSubscriptionCard = exports.ConnectNoSubscriptionCard = exports.ConnectSubscriptionGate = exports.ConnectSubscribeDialog = exports.ConnectPlans = exports.ConnectIntegrationsModal = exports.AI_TONE_DOT = exports.AI_TONE_CHIP = void 0;
+exports.normalizePath = exports.flattenNav = exports.normalizeNav = exports.useActivePath = exports.ConnectSideNav = exports.ConnectSidebarNav = exports.RAIL_EXPANDED = exports.RAIL_COLLAPSED = exports.sidebarRowClass = exports.useConnectShell = exports.ConnectShellProvider = exports.ConnectSidebarRow = exports.ConnectSidebarFooter = exports.ConnectSidebarBody = exports.ConnectSidebarHeader = exports.ConnectSidebar = exports.AppShell = exports.ConnectAccountSessions = exports.ConnectSignOutButton = exports.ConnectHomeButton = exports.ConnectProfileButton = exports.ConnectInvoicesButton = exports.ConnectManageSubscriptionButton = exports.ConnectUserMenu = exports.ConnectProfileModal = exports.ConnectUserButton = exports.ConnectRegisterButton = exports.ConnectLoginButton = exports.ConnectLogo = exports.ConnectMark = exports.ConnectGrievanceNotice = exports.isConnectError = exports.ConnectError = exports.normalizePlanFeatures = exports.blockingBlockers = exports.CONNECT_APP_URL = exports.useConnectResource = exports.useConnectIntegrations = exports.useConnectSessions = exports.useConnectAddonUsage = exports.useConnectCompanyProfile = exports.useConnectApps = exports.useConnectPlans = exports.useConnectEntitlements = exports.useConnectPlatformAccess = exports.useConnectAudience = exports.useConnectWorkspaceType = exports.useConnectUser = exports.useConnect = exports.ConnectProvider = void 0;
+exports.annualSaving = exports.resolveAction = exports.monthlyOf = exports.formatPrice = exports.buildCheckoutUrl = exports.useConnectCheckout = exports.ConnectFilterTabs = exports.ConnectCursorPagination = exports.ConnectConfirmDialog = exports.ConnectLinkButton = exports.ConnectPlansPage = exports.ConnectUsageMeter = exports.ConnectPlatformGate = exports.ConnectWorkspaceTypeGate = exports.useConnectFeature = exports.ConnectFeatureGate = exports.useConnectAccessGate = exports.ConnectAccessGate = exports.ConnectReadinessGate = exports.ConnectReadinessBanner = exports.resolveSubscriptionState = exports.ConnectSeatUsage = exports.ConnectTrialBanner = exports.ConnectSubscriptionCard = exports.ConnectNoSubscriptionCard = exports.ConnectSubscriptionGate = exports.ConnectSubscribeDialog = exports.ConnectPlans = exports.ConnectIntegrationsModal = exports.AI_TONE_DOT = exports.AI_TONE_CHIP = exports.AI_EMPTY_VALUE = exports.aiStatusTone = exports.isNumericAiFormat = exports.formatAiValue = exports.AiSources = exports.AiSteps = exports.AiDetails = exports.AiTimeline = exports.AiMetrics = exports.AiChart = exports.AiTable = exports.ConnectAskAi = exports.ConnectAppsGrid = exports.isLinkableConnectScreen = exports.matchConnectScreen = exports.filterNavForAudience = exports.gateExemptPaths = exports.isNavItemActive = exports.resolveActivePath = void 0;
+exports.useConnectWorkspaceMembers = exports.useConnectWorkspaces = exports.ConnectWorkspaceSwitcher = exports.resolvePlanGroup = exports.groupPlansByTier = exports.ACTION_LABEL = exports.discountLabel = void 0;
 /**
  * Browser half of `@cosmoops/connect-sdk` - React components and hooks.
  *
@@ -21,9 +22,11 @@ Object.defineProperty(exports, "useConnect", { enumerable: true, get: function (
 Object.defineProperty(exports, "useConnectUser", { enumerable: true, get: function () { return provider_js_1.useConnectUser; } });
 Object.defineProperty(exports, "useConnectWorkspaceType", { enumerable: true, get: function () { return provider_js_1.useConnectWorkspaceType; } });
 Object.defineProperty(exports, "useConnectAudience", { enumerable: true, get: function () { return provider_js_1.useConnectAudience; } });
+Object.defineProperty(exports, "useConnectPlatformAccess", { enumerable: true, get: function () { return provider_js_1.useConnectPlatformAccess; } });
 Object.defineProperty(exports, "useConnectEntitlements", { enumerable: true, get: function () { return provider_js_1.useConnectEntitlements; } });
 Object.defineProperty(exports, "useConnectPlans", { enumerable: true, get: function () { return provider_js_1.useConnectPlans; } });
 Object.defineProperty(exports, "useConnectApps", { enumerable: true, get: function () { return provider_js_1.useConnectApps; } });
+Object.defineProperty(exports, "useConnectCompanyProfile", { enumerable: true, get: function () { return provider_js_1.useConnectCompanyProfile; } });
 Object.defineProperty(exports, "useConnectAddonUsage", { enumerable: true, get: function () { return provider_js_1.useConnectAddonUsage; } });
 Object.defineProperty(exports, "useConnectSessions", { enumerable: true, get: function () { return provider_js_1.useConnectSessions; } });
 Object.defineProperty(exports, "useConnectIntegrations", { enumerable: true, get: function () { return provider_js_1.useConnectIntegrations; } });
@@ -38,6 +41,8 @@ Object.defineProperty(exports, "normalizePlanFeatures", { enumerable: true, get:
 var errors_js_1 = require("../errors.js");
 Object.defineProperty(exports, "ConnectError", { enumerable: true, get: function () { return errors_js_1.ConnectError; } });
 Object.defineProperty(exports, "isConnectError", { enumerable: true, get: function () { return errors_js_1.isConnectError; } });
+var grievance_notice_js_1 = require("./components/grievance-notice.js");
+Object.defineProperty(exports, "ConnectGrievanceNotice", { enumerable: true, get: function () { return grievance_notice_js_1.ConnectGrievanceNotice; } });
 var mark_js_1 = require("./mark.js");
 Object.defineProperty(exports, "ConnectMark", { enumerable: true, get: function () { return mark_js_1.ConnectMark; } });
 var logo_js_1 = require("./components/logo.js");
@@ -46,6 +51,9 @@ var auth_buttons_js_1 = require("./components/auth-buttons.js");
 Object.defineProperty(exports, "ConnectLoginButton", { enumerable: true, get: function () { return auth_buttons_js_1.ConnectLoginButton; } });
 Object.defineProperty(exports, "ConnectRegisterButton", { enumerable: true, get: function () { return auth_buttons_js_1.ConnectRegisterButton; } });
 var user_menu_js_1 = require("./components/user-menu.js");
+Object.defineProperty(exports, "ConnectUserButton", { enumerable: true, get: function () { return user_menu_js_1.ConnectUserButton; } });
+Object.defineProperty(exports, "ConnectProfileModal", { enumerable: true, get: function () { return user_menu_js_1.ConnectProfileModal; } });
+/** @deprecated Renamed to `ConnectUserButton`. */
 Object.defineProperty(exports, "ConnectUserMenu", { enumerable: true, get: function () { return user_menu_js_1.ConnectUserMenu; } });
 Object.defineProperty(exports, "ConnectManageSubscriptionButton", { enumerable: true, get: function () { return user_menu_js_1.ConnectManageSubscriptionButton; } });
 Object.defineProperty(exports, "ConnectInvoicesButton", { enumerable: true, get: function () { return user_menu_js_1.ConnectInvoicesButton; } });
@@ -60,9 +68,37 @@ Object.defineProperty(exports, "ConnectAccountSessions", { enumerable: true, get
 // pieces it composes rather than in a section of its own - an integration
 // reaching for a sidebar wants to find the launcher and the account menu in
 // the same breath, since the shell already mounts both.
+/*
+ * `AppShell`, deliberately without the `Connect` prefix every other export
+ * here carries. That exception was decided in 0.8.0 and is kept: a host whose
+ * own layout component is also called `AppShell` aliases it on import
+ * (`import { AppShell as ConnectAppShell }`), which is the documented answer
+ * and what both reference integrations do.
+ */
 var app_shell_js_1 = require("./components/app-shell.js");
 Object.defineProperty(exports, "AppShell", { enumerable: true, get: function () { return app_shell_js_1.AppShell; } });
+/*
+ * The rail, in pieces. `AppShell` composes exactly these and nothing
+ * else, which is the point of exporting them: an application whose chrome the
+ * prop API cannot express rebuilds the same rail from the same parts rather
+ * than forking it, and gets the collapse animation, the 32px glyph centre and
+ * the mobile drawer for free. They coordinate through `ConnectShellProvider`,
+ * so a part dropped in anywhere under one still knows the rail's state.
+ */
+var sidebar_js_1 = require("./components/sidebar.js");
+Object.defineProperty(exports, "ConnectSidebar", { enumerable: true, get: function () { return sidebar_js_1.ConnectSidebar; } });
+Object.defineProperty(exports, "ConnectSidebarHeader", { enumerable: true, get: function () { return sidebar_js_1.ConnectSidebarHeader; } });
+Object.defineProperty(exports, "ConnectSidebarBody", { enumerable: true, get: function () { return sidebar_js_1.ConnectSidebarBody; } });
+Object.defineProperty(exports, "ConnectSidebarFooter", { enumerable: true, get: function () { return sidebar_js_1.ConnectSidebarFooter; } });
+Object.defineProperty(exports, "ConnectSidebarRow", { enumerable: true, get: function () { return sidebar_js_1.ConnectSidebarRow; } });
+var shell_context_js_1 = require("./components/shell-context.js");
+Object.defineProperty(exports, "ConnectShellProvider", { enumerable: true, get: function () { return shell_context_js_1.ConnectShellProvider; } });
+Object.defineProperty(exports, "useConnectShell", { enumerable: true, get: function () { return shell_context_js_1.useConnectShell; } });
+Object.defineProperty(exports, "sidebarRowClass", { enumerable: true, get: function () { return shell_context_js_1.sidebarRowClass; } });
+Object.defineProperty(exports, "RAIL_COLLAPSED", { enumerable: true, get: function () { return shell_context_js_1.RAIL_COLLAPSED; } });
+Object.defineProperty(exports, "RAIL_EXPANDED", { enumerable: true, get: function () { return shell_context_js_1.RAIL_EXPANDED; } });
 var side_nav_js_1 = require("./components/side-nav.js");
+Object.defineProperty(exports, "ConnectSidebarNav", { enumerable: true, get: function () { return side_nav_js_1.ConnectSidebarNav; } });
 Object.defineProperty(exports, "ConnectSideNav", { enumerable: true, get: function () { return side_nav_js_1.ConnectSideNav; } });
 var use_active_path_js_1 = require("./use-active-path.js");
 Object.defineProperty(exports, "useActivePath", { enumerable: true, get: function () { return use_active_path_js_1.useActivePath; } });
@@ -77,6 +113,10 @@ Object.defineProperty(exports, "normalizePath", { enumerable: true, get: functio
 Object.defineProperty(exports, "resolveActivePath", { enumerable: true, get: function () { return nav_js_1.resolveActivePath; } });
 Object.defineProperty(exports, "isNavItemActive", { enumerable: true, get: function () { return nav_js_1.isNavItemActive; } });
 Object.defineProperty(exports, "gateExemptPaths", { enumerable: true, get: function () { return nav_js_1.gateExemptPaths; } });
+Object.defineProperty(exports, "filterNavForAudience", { enumerable: true, get: function () { return nav_js_1.filterNavForAudience; } });
+var ai_screens_js_1 = require("./components/ai-screens.js");
+Object.defineProperty(exports, "matchConnectScreen", { enumerable: true, get: function () { return ai_screens_js_1.matchConnectScreen; } });
+Object.defineProperty(exports, "isLinkableConnectScreen", { enumerable: true, get: function () { return ai_screens_js_1.isLinkableConnectScreen; } });
 var apps_grid_js_1 = require("./components/apps-grid.js");
 Object.defineProperty(exports, "ConnectAppsGrid", { enumerable: true, get: function () { return apps_grid_js_1.ConnectAppsGrid; } });
 // `AppShell askAi` mounts this; exported for an app that wants the panel
@@ -132,10 +172,35 @@ Object.defineProperty(exports, "ConnectFeatureGate", { enumerable: true, get: fu
 Object.defineProperty(exports, "useConnectFeature", { enumerable: true, get: function () { return feature_gate_js_1.useConnectFeature; } });
 var workspace_type_gate_js_1 = require("./components/workspace-type-gate.js");
 Object.defineProperty(exports, "ConnectWorkspaceTypeGate", { enumerable: true, get: function () { return workspace_type_gate_js_1.ConnectWorkspaceTypeGate; } });
+var platform_gate_js_1 = require("./components/platform-gate.js");
+Object.defineProperty(exports, "ConnectPlatformGate", { enumerable: true, get: function () { return platform_gate_js_1.ConnectPlatformGate; } });
 var usage_meter_js_1 = require("./components/usage-meter.js");
 Object.defineProperty(exports, "ConnectUsageMeter", { enumerable: true, get: function () { return usage_meter_js_1.ConnectUsageMeter; } });
 var plans_page_js_1 = require("./components/plans-page.js");
 Object.defineProperty(exports, "ConnectPlansPage", { enumerable: true, get: function () { return plans_page_js_1.ConnectPlansPage; } });
+/*
+ * The interactive half of the page-composition layer. Their presentational
+ * counterparts - `ConnectPageShell`, `ConnectSection`, `ConnectEmptyState`,
+ * `ConnectStatusChip`, `ConnectSettingRow` - live in
+ * `@cosmoops/connect-sdk/ui`, which is deliberately not a `"use client"`
+ * module so a page shell does not become a client boundary. These three hold
+ * state, so they belong here.
+ */
+/*
+ * Built and compiled into `dist/` since 0.8 and reachable from no entry point
+ * until now - the same oversight `ConnectAccountSessions` had. It is the only
+ * supported way to render a link that looks like a button: HeroUI v3's
+ * `Button` has no `as` prop, so `<Button as={Link}>` neither type checks nor
+ * works.
+ */
+var link_button_js_1 = require("./components/link-button.js");
+Object.defineProperty(exports, "ConnectLinkButton", { enumerable: true, get: function () { return link_button_js_1.ConnectLinkButton; } });
+var confirm_dialog_js_1 = require("./components/confirm-dialog.js");
+Object.defineProperty(exports, "ConnectConfirmDialog", { enumerable: true, get: function () { return confirm_dialog_js_1.ConnectConfirmDialog; } });
+var cursor_pagination_js_1 = require("./components/cursor-pagination.js");
+Object.defineProperty(exports, "ConnectCursorPagination", { enumerable: true, get: function () { return cursor_pagination_js_1.ConnectCursorPagination; } });
+var filter_tabs_js_1 = require("./components/filter-tabs.js");
+Object.defineProperty(exports, "ConnectFilterTabs", { enumerable: true, get: function () { return filter_tabs_js_1.ConnectFilterTabs; } });
 var use_checkout_js_1 = require("./use-checkout.js");
 Object.defineProperty(exports, "useConnectCheckout", { enumerable: true, get: function () { return use_checkout_js_1.useConnectCheckout; } });
 Object.defineProperty(exports, "buildCheckoutUrl", { enumerable: true, get: function () { return use_checkout_js_1.buildCheckoutUrl; } });
@@ -153,3 +218,8 @@ Object.defineProperty(exports, "ACTION_LABEL", { enumerable: true, get: function
 // answer this, and `groupPlansByTier` is how to read it.
 Object.defineProperty(exports, "groupPlansByTier", { enumerable: true, get: function () { return plan_pricing_js_1.groupPlansByTier; } });
 Object.defineProperty(exports, "resolvePlanGroup", { enumerable: true, get: function () { return plan_pricing_js_1.resolvePlanGroup; } });
+var workspace_switcher_js_1 = require("./components/workspace-switcher.js");
+Object.defineProperty(exports, "ConnectWorkspaceSwitcher", { enumerable: true, get: function () { return workspace_switcher_js_1.ConnectWorkspaceSwitcher; } });
+var provider_js_2 = require("./provider.js");
+Object.defineProperty(exports, "useConnectWorkspaces", { enumerable: true, get: function () { return provider_js_2.useConnectWorkspaces; } });
+Object.defineProperty(exports, "useConnectWorkspaceMembers", { enumerable: true, get: function () { return provider_js_2.useConnectWorkspaceMembers; } });

package/dist/cjs/client/provider.js

@@ -7,10 +7,14 @@ exports.useConnect = useConnect;
 exports.useConnectUser = useConnectUser;
 exports.useConnectWorkspaceType = useConnectWorkspaceType;
 exports.useConnectAudience = useConnectAudience;
+exports.useConnectPlatformAccess = useConnectPlatformAccess;
 exports.useConnectEntitlements = useConnectEntitlements;
 exports.useConnectAddonUsage = useConnectAddonUsage;
 exports.useConnectPlans = useConnectPlans;
+exports.useConnectCompanyProfile = useConnectCompanyProfile;
 exports.useConnectApps = useConnectApps;
+exports.useConnectWorkspaces = useConnectWorkspaces;
+exports.useConnectWorkspaceMembers = useConnectWorkspaceMembers;
 exports.useConnectIntegrations = useConnectIntegrations;
 exports.useConnectSessions = useConnectSessions;
 exports.useConnectResource = useConnectResource;
@@ -151,7 +155,7 @@ function ConnectProvider({ clientId = "", basePath = "/api/connect", redirectUri
             // error, so a Login button still renders rather than the UI hanging on
             // skeletons forever.
             setResult({
-                session: { user: null, subscription: null, applicationRole: null, audience: null },
+                session: { user: null, subscription: null, role: null, permissions: [], staff: false, audience: null },
                 error: cause instanceof Error ? cause.message : "Could not reach Connect",
             });
         }
@@ -200,7 +204,7 @@ function ConnectProvider({ clientId = "", basePath = "/api/connect", redirectUri
             credentials: "same-origin",
         }).catch(() => { });
         cache.current.clear();
-        setResult({ session: { user: null, subscription: null, applicationRole: null, audience: null }, error: null });
+        setResult({ session: { user: null, subscription: null, role: null, permissions: [], staff: false, audience: null }, error: null });
     }, [basePath, fetchImpl]);
     const value = (0, react_1.useMemo)(() => ({
         clientId,
@@ -267,6 +271,26 @@ function useConnectWorkspaceType() {
 function useConnectAudience() {
     return useConnect().session?.audience ?? null;
 }
+/**
+ * Whether this session is one of Connect's own operators - see
+ * `SessionAccess.staff`.
+ *
+ * `isStaff` is the branch you want; `roles` narrows further when your operator
+ * console has tiers of its own (a `developer` seeing a read-only view of what
+ * a `platform_admin` can edit, say).
+ *
+ * **A rendering decision, not an access decision.** The browser can call this
+ * whatever it likes. Everything an operator console exposes must be re-checked
+ * server-side against `staff` from
+ * `client.identity.getUser(sessionToken)` - see `<ConnectPlatformGate>`, which
+ * says the same thing at more length.
+ */
+function useConnectPlatformAccess() {
+    const { session, isLoading } = useConnect();
+    const staff = session?.staff === true;
+    const role = session?.role ?? null;
+    return { isStaff: staff, roles: staff && role ? [role] : [], isLoading };
+}
 /** Readiness gates and the live subscription, fetched on first use. */
 function useConnectEntitlements() {
     return useConnectResource("/entitlements");
@@ -285,10 +309,41 @@ function useConnectAddonUsage() {
 function useConnectPlans() {
     return useConnectResource("/plans");
 }
+/**
+ * The platform's legal identity and DPDP grievance channel.
+ *
+ * The one read here that does not depend on a session, so it resolves the
+ * same for a signed-out visitor - which is deliberate, because the moment a
+ * grievance channel most needs to be readable is on a public privacy page.
+ *
+ * Read it rather than copying it into your own configuration; see
+ * `CompanyProfile`. `<ConnectGrievanceNotice>` renders it for you.
+ */
+function useConnectCompanyProfile() {
+    return useConnectResource("/company-profile");
+}
 /** The apps this workspace can open. */
 function useConnectApps() {
     return useConnectResource("/apps");
 }
+/**
+ * The workspaces this user belongs to - what `<ConnectWorkspaceSwitcher>`
+ * renders.
+ *
+ * Empty or single-entry results are normal, not errors: most accounts have one
+ * workspace, and the switcher decides for itself whether that is worth
+ * drawing.
+ */
+function useConnectWorkspaces() {
+    return useConnectResource("/workspaces");
+}
+/**
+ * The team of the workspace this session is on, with each member's permissions
+ * already resolved for this application.
+ */
+function useConnectWorkspaceMembers() {
+    return useConnectResource("/workspaces/members");
+}
 /** Enabled Composio-hosted toolkits and this workspace's connection status for each. */
 function useConnectIntegrations() {
     return useConnectResource("/integrations");

package/dist/cjs/client/use-checkout.js

@@ -157,15 +157,19 @@ function buildCancelUrl({ appUrl, subscriptionId }) {
  * The Connect URL that completes a subscribe or a plan change.
  *
  * Both land on a modal Connect renders over the relevant page (an intercepted
- * parallel route - `app/@modal/(.)applications/...` and
- * `app/@modal/(.)billing/...`), so the customer arrives already looking at the
- * confirmation for the plan they picked here, not at a catalogue they have to
- * find it in again.
+ * parallel route - `app/@modal/(.)apps/...` and `app/@modal/(.)billing/...`),
+ * so the customer arrives already looking at the confirmation for the plan
+ * they picked here, not at a catalogue they have to find it in again.
+ *
+ * The subscribe path is `/apps/...`, not `/applications/...`: the portal
+ * route customers see is `/apps`, and `/applications` is a Console-only
+ * prefix that has never served this page. Building the other one is what
+ * sent every first-time subscriber from a partner's pricing page to a 404.
  */
 function buildCheckoutUrl({ appUrl, applicationId, planId, subscriptionId, coupon, }) {
     const path = subscriptionId
         ? `/billing/subscriptions/${encodeURIComponent(subscriptionId)}/change-plan/${encodeURIComponent(planId)}`
-        : `/applications/${encodeURIComponent(applicationId)}/subscribe/${encodeURIComponent(planId)}`;
+        : `/apps/${encodeURIComponent(applicationId)}/subscribe/${encodeURIComponent(planId)}`;
     const url = new URL(path, appUrl);
     if (coupon?.trim())
         url.searchParams.set("coupon", coupon.trim());

package/dist/cjs/errors.js

@@ -59,7 +59,7 @@ class ConnectError extends Error {
      * guessing keys. These two are the exception: reaching them required
      * presenting a key whose hash matched, so you already hold it, and what you
      * need to know is that no retry and no scope change will fix this - the key
-     * has to be reissued from the application's Integration tab.
+     * has to be reissued from the application's Connect client section.
      *
      * Worth alerting on. It is the one failure that will not resolve itself and
      * takes down every call your integration makes.

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizePlanFeatures = exports.blockingBlockers = exports.isConnectError = exports.ConnectError = void 0;
+exports.storeIndexCovers = exports.describeQueryRejection = exports.unchangedSince = exports.storeIndexSignature = exports.storeIndexFor = exports.serverTimestamp = exports.increment = exports.documentExists = exports.deleteField = exports.arrayUnion = exports.arrayRemove = exports.normalizePlanFeatures = exports.blockingBlockers = exports.isConnectError = exports.ConnectError = void 0;
 /**
  * `@cosmoops/connect-sdk` - the official client for the CosmoOps Connect
  * **application-partner API** (`/api/v1/application/*`).
@@ -13,6 +13,8 @@ exports.normalizePlanFeatures = exports.blockingBlockers = exports.isConnectErro
  *   Holds the API key. Never import this from browser code.
  * - `@cosmoops/connect-sdk/client` - React components and hooks. Talks to your
  *   own origin only.
+ * - `@cosmoops/connect-sdk/mcp` - your store's declaration, derived into MCP
+ *   tools. Holds the API key; never import this from browser code.
  */
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "ConnectError", { enumerable: true, get: function () { return errors_js_1.ConnectError; } });
@@ -20,3 +22,16 @@ Object.defineProperty(exports, "isConnectError", { enumerable: true, get: functi
 var helpers_js_1 = require("./helpers.js");
 Object.defineProperty(exports, "blockingBlockers", { enumerable: true, get: function () { return helpers_js_1.blockingBlockers; } });
 Object.defineProperty(exports, "normalizePlanFeatures", { enumerable: true, get: function () { return helpers_js_1.normalizePlanFeatures; } });
+var store_js_1 = require("./store.js");
+Object.defineProperty(exports, "arrayRemove", { enumerable: true, get: function () { return store_js_1.arrayRemove; } });
+Object.defineProperty(exports, "arrayUnion", { enumerable: true, get: function () { return store_js_1.arrayUnion; } });
+Object.defineProperty(exports, "deleteField", { enumerable: true, get: function () { return store_js_1.deleteField; } });
+Object.defineProperty(exports, "documentExists", { enumerable: true, get: function () { return store_js_1.documentExists; } });
+Object.defineProperty(exports, "increment", { enumerable: true, get: function () { return store_js_1.increment; } });
+Object.defineProperty(exports, "serverTimestamp", { enumerable: true, get: function () { return store_js_1.serverTimestamp; } });
+Object.defineProperty(exports, "storeIndexFor", { enumerable: true, get: function () { return store_js_1.storeIndexFor; } });
+Object.defineProperty(exports, "storeIndexSignature", { enumerable: true, get: function () { return store_js_1.storeIndexSignature; } });
+Object.defineProperty(exports, "unchangedSince", { enumerable: true, get: function () { return store_js_1.unchangedSince; } });
+var store_schema_js_1 = require("./store-schema.js");
+Object.defineProperty(exports, "describeQueryRejection", { enumerable: true, get: function () { return store_schema_js_1.describeQueryRejection; } });
+Object.defineProperty(exports, "storeIndexCovers", { enumerable: true, get: function () { return store_schema_js_1.storeIndexCovers; } });