@cosmoops/connect-sdk 0.24.1 → 0.26.0

package/dist/esm/client/components/booking-calendar.js

@@ -7,6 +7,7 @@ import { ConnectEmptyState } from "../../ui/empty-state.js";
 import { useBookableEventTypes, useBookings, } from "../use-scheduling.js";
 import { dayColumns, dayStartInstant, hourMarks, layoutBookings, zonedInstant, } from "./booking-grid.js";
 import { ConnectBookingDetail, ConnectBookingDialog } from "./booking-dialogs.js";
+import { cn } from "../../cn.js";
 /**
  * The visible band of the day. Outside it a booking is drawn at the edge and
  * flagged rather than hidden - see `layoutBookings`.
@@ -64,7 +65,7 @@ export function ConnectBookingCalendar({ timeZone, hostMemberId, window: visible
     const marks = useMemo(() => hourMarks(visibleWindow), [visibleWindow]);
     const shiftWeek = (weeks) => setWeekAnchor((anchor) => new Date(anchor.getTime() + weeks * 7 * 24 * 60 * 60_000));
     const eventTypeById = useMemo(() => new Map(eventTypes.map((eventType) => [eventType.id, eventType])), [eventTypes]);
-    return (_jsxs("div", { className: `flex flex-col gap-4 ${className ?? ""}`, children: [_jsxs("header", { className: "flex flex-wrap items-center justify-between gap-3", children: [_jsxs("div", { className: "flex items-center gap-1", children: [_jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Previous week", onPress: () => shiftWeek(-1), children: _jsx(ChevronLeft, { className: "size-4", "aria-hidden": true }) }), _jsx(Button, { size: "sm", variant: "secondary", onPress: () => setWeekAnchor(startOfWeek(new Date(), zone)), children: "Today" }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Next week", onPress: () => shiftWeek(1), children: _jsx(ChevronRight, { className: "size-4", "aria-hidden": true }) }), _jsx("p", { className: "ml-2 text-sm font-medium", children: weekLabel(columns, zone) })] }), canBook && eventTypes.length > 0 && (_jsx(Button, { size: "sm", variant: "primary", onPress: () => setBooking({ startAt: nextHour(now) }), children: "New appointment" }))] }), error && _jsx("p", { className: "text-sm text-danger", children: error }), isLoading ? (_jsx(Skeleton, { className: "h-96 w-full rounded-lg" })) : (_jsxs(_Fragment, { children: [_jsx(Card, { className: "hidden overflow-hidden sm:block", children: _jsx(WeekGrid, { columns: columns, marks: marks, window: visibleWindow, positioned: positioned, eventTypeById: eventTypeById, zone: zone, onSelect: setSelected, onPickEmpty: canBook ? (startAt) => setBooking({ startAt }) : undefined }) }), _jsx("div", { className: "sm:hidden", children: _jsx(AgendaView, { columns: columns, bookings: bookings, eventTypeById: eventTypeById, zone: zone, onSelect: setSelected }) })] })), booking && (_jsx(ConnectBookingDialog, { isOpen: true, onOpenChange: (open) => !open && setBooking(null), eventTypes: eventTypes, initialStartAt: booking.startAt, timeZone: zone, onBooked: () => {
+    return (_jsxs("div", { className: cn("flex flex-col gap-4", className), children: [_jsxs("header", { className: "flex flex-wrap items-center justify-between gap-3", children: [_jsxs("div", { className: "flex items-center gap-1", children: [_jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Previous week", onPress: () => shiftWeek(-1), children: _jsx(ChevronLeft, { className: "size-4", "aria-hidden": true }) }), _jsx(Button, { size: "sm", variant: "secondary", onPress: () => setWeekAnchor(startOfWeek(new Date(), zone)), children: "Today" }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Next week", onPress: () => shiftWeek(1), children: _jsx(ChevronRight, { className: "size-4", "aria-hidden": true }) }), _jsx("p", { className: "ml-2 text-sm font-medium", children: weekLabel(columns, zone) })] }), canBook && eventTypes.length > 0 && (_jsx(Button, { size: "sm", variant: "primary", onPress: () => setBooking({ startAt: nextHour(now) }), children: "New appointment" }))] }), error && _jsx("p", { className: "text-sm text-danger", children: error }), isLoading ? (_jsx(Skeleton, { className: "h-96 w-full rounded-lg" })) : (_jsxs(_Fragment, { children: [_jsx(Card, { className: "hidden overflow-hidden sm:block", children: _jsx(WeekGrid, { columns: columns, marks: marks, window: visibleWindow, positioned: positioned, eventTypeById: eventTypeById, zone: zone, onSelect: setSelected, onPickEmpty: canBook ? (startAt) => setBooking({ startAt }) : undefined }) }), _jsx("div", { className: "sm:hidden", children: _jsx(AgendaView, { columns: columns, bookings: bookings, eventTypeById: eventTypeById, zone: zone, onSelect: setSelected }) })] })), booking && (_jsx(ConnectBookingDialog, { isOpen: true, onOpenChange: (open) => !open && setBooking(null), eventTypes: eventTypes, initialStartAt: booking.startAt, timeZone: zone, onBooked: () => {
                     setBooking(null);
                     refetch();
                 } })), selected && (_jsx(ConnectBookingDetail, { booking: selected, eventType: eventTypeById.get(selected.eventTypeId) ?? null, timeZone: zone, onOpenChange: (open) => !open && setSelected(null), onChanged: () => {

package/dist/esm/client/components/cursor-pagination.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Button } from "@heroui/react";
+import { cn } from "../../cn.js";
 /**
  * Next / previous for a cursor-paginated list.
  *
@@ -14,6 +15,6 @@ import { Button } from "@heroui/react";
  * filtering or paging changed the result set. Without it the table silently
  * swaps its contents.
  */
-export function ConnectCursorPagination({ shown, nextCursor, hasPrevious, onNext, onPrevious, isPending = false, noun = ["row", "rows"], }) {
-    return (_jsxs("div", { className: "flex items-center justify-between gap-3 pt-3", children: [_jsxs("p", { "aria-live": "polite", className: "text-xs text-muted", children: [shown, " ", shown === 1 ? noun[0] : noun[1]] }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Button, { size: "sm", variant: "secondary", isDisabled: !hasPrevious || isPending, onPress: onPrevious, children: "Previous" }), _jsx(Button, { size: "sm", variant: "secondary", isDisabled: nextCursor === null || isPending, onPress: () => nextCursor && onNext(nextCursor), children: "Next" })] })] }));
+export function ConnectCursorPagination({ shown, nextCursor, hasPrevious, onNext, onPrevious, isPending = false, noun = ["row", "rows"], className, }) {
+    return (_jsxs("div", { className: cn("flex items-center justify-between gap-3 pt-3", className), children: [_jsxs("p", { "aria-live": "polite", className: "text-xs text-muted", children: [shown, " ", shown === 1 ? noun[0] : noun[1]] }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Button, { size: "sm", variant: "secondary", isDisabled: !hasPrevious || isPending, onPress: onPrevious, children: "Previous" }), _jsx(Button, { size: "sm", variant: "secondary", isDisabled: nextCursor === null || isPending, onPress: () => nextCursor && onNext(nextCursor), children: "Next" })] })] }));
 }

package/dist/esm/client/components/filter-tabs.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Chip } from "@heroui/react";
+import { cn } from "../../cn.js";
 /**
  * A single-select filter strip - the "All / Open / Won / Lost" row above a
  * list.
@@ -10,12 +11,29 @@ import { Chip } from "@heroui/react";
  * selected one should be announced as selected. A group of `<button>`s gets
  * neither, and that is the usual hand-rolled shape.
  *
- * Scrolls horizontally rather than wrapping on a narrow viewport - a filter
- * strip that wraps to three lines pushes the list itself off the screen.
+ * Wraps rather than scrolling on a narrow viewport. See the note on the
+ * container below: a horizontal scroller nested in a vertically scrolling
+ * page hides its overflow rather than deferring it.
  */
-export function ConnectFilterTabs({ options, value, onChange, label, }) {
-    return (_jsx("div", { role: "radiogroup", "aria-label": label, className: "-mx-1 flex gap-2 overflow-x-auto px-1 pb-1", children: options.map((option) => {
+export function ConnectFilterTabs({ options, value, onChange, label, className, }) {
+    return (
+    /*
+      * Wraps. It does not scroll.
+      *
+      * It used to scroll horizontally, on the reasoning that a filter wrapping
+      * to three lines pushes the list itself off the screen. That trade was
+      * the wrong way round for a mobile-first product: a horizontal scroller
+      * inside a vertically scrolling page is a gesture people do not think to
+      * try, so the options past the fold were not "one swipe away" - they were
+      * invisible. The strip also came to rest mid-option, showing "ll" where
+      * "All" should be.
+      *
+      * Wrapping costs one extra line on a phone and nothing at all above it,
+      * where the row has always fitted. Every option is now on screen and
+      * reachable without a gesture, which is what a filter is for.
+      */
+    _jsx("div", { role: "radiogroup", "aria-label": label, className: cn("-mx-1 flex flex-wrap gap-2 px-1", className), children: options.map((option) => {
             const isSelected = option.value === value;
-            return (_jsx("button", { type: "button", role: "radio", "aria-checked": isSelected, onClick: () => onChange(option.value), className: "shrink-0 rounded-full focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: _jsxs(Chip, { size: "sm", variant: isSelected ? "primary" : "soft", color: isSelected ? "accent" : "default", children: [option.label, option.count !== undefined && _jsx("span", { className: "ml-1 opacity-70", children: option.count })] }) }, option.value ?? "__all"));
+            return (_jsx("button", { type: "button", role: "radio", "aria-checked": isSelected, onClick: () => onChange(option.value), className: "shrink-0 rounded-full focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: _jsxs(Chip, { variant: isSelected ? "primary" : "soft", color: isSelected ? "accent" : "default", className: "min-h-8 px-3.5 py-1.5 text-sm", children: [option.label, option.count !== undefined && _jsx("span", { className: "ml-1 opacity-70", children: option.count })] }) }, option.value ?? "__all"));
         }) }));
 }

package/dist/esm/client/components/grievance-notice.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useConnectCompanyProfile } from "../provider.js";
+import { cn } from "../../cn.js";
 /**
  * The DPDP s.13 grievance channel, rendered.
  *
@@ -23,5 +24,5 @@ export function ConnectGrievanceNotice({ title = "Grievance redressal", applicat
     if (!profile)
         return null;
     const { grievance } = profile;
-    return (_jsxs("section", { className: className ?? "space-y-3", children: [title !== null && _jsx("h3", { className: "text-base font-semibold", children: title }), _jsxs("p", { className: "text-sm text-muted", children: [applicationName ? `${applicationName} is operated on ` : "This service runs on ", "the CosmoOps Connect platform. ", _jsx("strong", { className: "font-medium text-foreground", children: profile.legalName }), " ", "is the Data Fiduciary for personal data processed here, under the Digital Personal Data Protection Act, 2023."] }), _jsxs("dl", { className: "grid grid-cols-1 gap-x-6 gap-y-3 text-sm sm:grid-cols-[auto_1fr]", children: [_jsx("dt", { className: "text-muted", children: "Grievance Officer" }), _jsx("dd", { className: "text-foreground", children: grievance.officerName }), _jsx("dt", { className: "text-muted", children: "Email" }), _jsx("dd", { children: _jsx("a", { className: "text-accent underline underline-offset-2", href: `mailto:${grievance.officerEmail}`, children: grievance.officerEmail }) }), _jsx("dt", { className: "text-muted", children: "Contactable" }), _jsx("dd", { className: "text-foreground", children: grievance.hours }), _jsx("dt", { className: "text-muted", children: "Registered address" }), _jsx("dd", { className: "text-foreground", children: profile.registeredAddress })] }), _jsxs("p", { className: "text-sm text-muted", children: ["Complaints are acknowledged and resolved within ", grievance.responseDays, " days of receipt."] })] }));
+    return (_jsxs("section", { className: cn("space-y-3", className), children: [title !== null && _jsx("h3", { className: "text-base font-semibold", children: title }), _jsxs("p", { className: "text-sm text-muted", children: [applicationName ? `${applicationName} is operated on ` : "This service runs on ", "the CosmoOps Connect platform. ", _jsx("strong", { className: "font-medium text-foreground", children: profile.legalName }), " ", "is the Data Fiduciary for personal data processed here, under the Digital Personal Data Protection Act, 2023."] }), _jsxs("dl", { className: "grid grid-cols-1 gap-x-6 gap-y-3 text-sm sm:grid-cols-[auto_1fr]", children: [_jsx("dt", { className: "text-muted", children: "Grievance Officer" }), _jsx("dd", { className: "text-foreground", children: grievance.officerName }), _jsx("dt", { className: "text-muted", children: "Email" }), _jsx("dd", { children: _jsx("a", { className: "text-accent underline underline-offset-2", href: `mailto:${grievance.officerEmail}`, children: grievance.officerEmail }) }), _jsx("dt", { className: "text-muted", children: "Contactable" }), _jsx("dd", { className: "text-foreground", children: grievance.hours }), _jsx("dt", { className: "text-muted", children: "Registered address" }), _jsx("dd", { className: "text-foreground", children: profile.registeredAddress })] }), _jsxs("p", { className: "text-sm text-muted", children: ["Complaints are acknowledged and resolved within ", grievance.responseDays, " days of receipt."] })] }));
 }

package/dist/esm/client/components/logo.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ConnectMark } from "../mark.js";
+import { cn } from "../../cn.js";
 /**
  * The shared platform lockup: an application's own glyph on the CosmoOps badge,
  * `cosmo·ops` beside it, and the application name underneath.
@@ -19,7 +20,7 @@ export function ConnectLogo({ name, icon, variant, collapsed = false, className
     const resolved = variant ?? (collapsed ? "mark" : "full");
     const badge = (_jsxs("span", { className: "relative inline-flex shrink-0 items-center justify-center overflow-hidden rounded-[0.28em] bg-accent text-accent-foreground", style: { width: "2em", height: "2em" }, "aria-hidden": "true", children: [icon ? _jsx("span", { className: "inline-flex items-center justify-center [&>*]:size-[1.25em]", children: icon }) : null, !icon && _jsx(ConnectMark, { className: "absolute inset-0 size-full" })] }));
     if (resolved === "mark") {
-        return (_jsx("span", { className: `inline-flex text-sm leading-none ${className ?? ""}`, role: "img", "aria-label": name, children: badge }));
+        return (_jsx("span", { className: cn("inline-flex text-sm leading-none", className), role: "img", "aria-label": name, children: badge }));
     }
-    return (_jsxs("span", { className: `inline-flex min-w-0 items-center gap-[0.6em] text-sm leading-none ${className ?? ""}`, role: "img", "aria-label": `cosmoops ${name}`, children: [resolved === "full" && badge, _jsxs("span", { className: "flex min-w-0 flex-col leading-none", children: [_jsxs("span", { className: "inline-flex items-center font-extrabold tracking-tight text-foreground", "aria-hidden": "true", children: [_jsx("span", { children: "cosmo" }), _jsx("span", { className: "mx-[0.12em] inline-block size-[0.19em] shrink-0 rounded-[0.04em] bg-accent" }), _jsx("span", { children: "ops" })] }), _jsx("span", { className: "mt-[0.42em] truncate text-[0.6em] font-semibold uppercase tracking-[0.26em] text-accent", "aria-hidden": "true", children: name })] })] }));
+    return (_jsxs("span", { className: cn("inline-flex min-w-0 items-center gap-[0.6em] text-sm leading-none", className), role: "img", "aria-label": `cosmoops ${name}`, children: [resolved === "full" && badge, _jsxs("span", { className: "flex min-w-0 flex-col leading-none", children: [_jsxs("span", { className: "inline-flex items-center font-extrabold tracking-tight text-foreground", "aria-hidden": "true", children: [_jsx("span", { children: "cosmo" }), _jsx("span", { className: "mx-[0.12em] inline-block size-[0.19em] shrink-0 rounded-[0.04em] bg-accent" }), _jsx("span", { children: "ops" })] }), _jsx("span", { className: "mt-[0.42em] truncate text-[0.6em] font-semibold uppercase tracking-[0.26em] text-accent", "aria-hidden": "true", children: name })] })] }));
 }

package/dist/esm/client/components/one-tap.js

@@ -8,6 +8,7 @@ import { ConnectMark } from "../mark.js";
 import { initials } from "./identity.js";
 import { ENTER, m, MotionProvider } from "./motion.js";
 import { dismissOneTap, oneTapSuppressed } from "./one-tap-state.js";
+import { cn } from "../../cn.js";
 export function ConnectOneTap({ onInteractiveSignIn, className = "" }) {
     const { session, isLoading, signIn, readOneTapHint, oneTapSignIn } = useConnect();
     const [hint, setHint] = useState(null);
@@ -92,7 +93,7 @@ export function ConnectOneTap({ onInteractiveSignIn, className = "" }) {
             // Fixed, above ordinary content but below a modal: this is an offer,
             // and it must never sit on top of something the visitor opened
             // themselves.
-            className: `fixed inset-x-3 bottom-3 z-40 sm:inset-x-auto sm:right-4 sm:bottom-4 sm:w-80 ${className}`, onKeyDown: (event) => {
+            className: cn("fixed inset-x-3 bottom-3 z-40 sm:inset-x-auto sm:right-4 sm:bottom-4 sm:w-80", className), onKeyDown: (event) => {
                 if (event.key === "Escape")
                     dismiss();
             }, children: _jsxs(Card, { className: "p-4 shadow-lg", children: [_jsxs("div", { className: "flex items-start gap-3", children: [hint.consented ? (_jsxs(Avatar, { size: "md", color: "accent", variant: "soft", className: "shrink-0 rounded-full", children: [hint.user?.photoUrl && (_jsx(Avatar.Image, { alt: displayName ?? "Your account", src: hint.user.photoUrl })), _jsx(Avatar.Fallback, { children: initials(hint.user?.displayName ?? null, hint.user?.email ?? null) })] })) : (_jsx(ConnectMark, { className: "mt-0.5 size-8 shrink-0" })), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-sm font-medium text-foreground", children: hint.consented ? `Continue as ${displayName ?? "your account"}` : "You're signed in to CosmoOps" }), _jsx("p", { className: "truncate text-xs text-muted", children: hint.consented

package/dist/esm/client/components/plans.js

@@ -8,6 +8,7 @@ import { buildCancelUrl, buildCheckoutUrl, useConnectCheckout, } from "../use-ch
 import { AnimatePresence, ENTER, m, MotionProvider } from "./motion.js";
 import { ConnectSubscribeDialog } from "./subscribe-dialog.js";
 import { ACTION_LABEL, checkoutSubscriptionId, discountLabel, formatPrice, groupPlansByTier, intervalLabel, isFreePlan, pricePerLabel, resolveAction, } from "./plan-pricing.js";
+import { cn } from "../../cn.js";
 /**
  * The plan table: monthly/annual toggle, features, add-ons, the discount
  * actually in effect, and the subscribe / upgrade / downgrade flows.
@@ -102,7 +103,7 @@ export function ConnectPlans({ planIds, hideCoupon = false, className }) {
         setPending(null);
     }
     if (plansLoading || entitlementsLoading) {
-        return (_jsx("div", { className: `grid gap-4 sm:grid-cols-2 lg:grid-cols-3 ${className ?? ""}`, children: Array.from({ length: 3 }, (_, index) => (_jsx(Skeleton, { className: "h-80 rounded-xl" }, index))) }));
+        return (_jsx("div", { className: cn("grid gap-4 sm:grid-cols-2 lg:grid-cols-3", className), children: Array.from({ length: 3 }, (_, index) => (_jsx(Skeleton, { className: "h-80 rounded-xl" }, index))) }));
     }
     if (!session?.user) {
         return _jsx("p", { className: "text-sm text-muted", children: "Sign in to see your plan options." });
@@ -110,7 +111,7 @@ export function ConnectPlans({ planIds, hideCoupon = false, className }) {
     if (error) {
         return _jsx("p", { className: "text-sm text-danger", children: "Could not load plans." });
     }
-    return (_jsx(MotionProvider, { children: _jsxs("div", { className: `flex flex-col gap-6 ${className ?? ""}`, children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-4", children: [hasAnnual && hasMonthly && (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx("span", { className: showAnnual ? "text-sm text-muted" : "text-sm font-medium text-foreground", children: "Monthly" }), _jsx(Switch, { "aria-label": "Bill annually", isSelected: showAnnual, onChange: setAnnual, children: _jsx(Switch.Content, { children: _jsx(Switch.Control, { children: _jsx(Switch.Thumb, {}) }) }) }), _jsx("span", { className: showAnnual ? "text-sm font-medium text-foreground" : "text-sm text-muted", children: "Annual" }), bestSaving !== null && (_jsxs(Chip, { className: "bg-accent-soft text-accent", children: ["Save up to ", bestSaving, "%"] }))] })), !hideCoupon && (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Tag, { className: "size-4 text-muted", "aria-hidden": "true" }), _jsx(Input, { "aria-label": "Coupon code", placeholder: "Coupon code", value: coupon, onChange: (event) => setCoupon(event.target.value.toUpperCase()), className: "w-40" })] }))] }), subscription?.subscription?.appliedDiscount && (_jsxs("div", { className: "flex items-center gap-2 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", children: [_jsx(Sparkles, { className: "size-4 shrink-0", "aria-hidden": "true" }), _jsxs("span", { children: [discountLabel(subscription.subscription.appliedDiscount), subscription.subscription.appliedDiscount.code
+    return (_jsx(MotionProvider, { children: _jsxs("div", { className: cn("flex flex-col gap-6", className), children: [_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-4", children: [hasAnnual && hasMonthly && (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx("span", { className: showAnnual ? "text-sm text-muted" : "text-sm font-medium text-foreground", children: "Monthly" }), _jsx(Switch, { "aria-label": "Bill annually", isSelected: showAnnual, onChange: setAnnual, children: _jsx(Switch.Content, { children: _jsx(Switch.Control, { children: _jsx(Switch.Thumb, {}) }) }) }), _jsx("span", { className: showAnnual ? "text-sm font-medium text-foreground" : "text-sm text-muted", children: "Annual" }), bestSaving !== null && (_jsxs(Chip, { className: "bg-accent-soft text-accent", children: ["Save up to ", bestSaving, "%"] }))] })), !hideCoupon && (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Tag, { className: "size-4 text-muted", "aria-hidden": "true" }), _jsx(Input, { "aria-label": "Coupon code", placeholder: "Coupon code", value: coupon, onChange: (event) => setCoupon(event.target.value.toUpperCase()), className: "w-40" })] }))] }), subscription?.subscription?.appliedDiscount && (_jsxs("div", { className: "flex items-center gap-2 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", children: [_jsx(Sparkles, { className: "size-4 shrink-0", "aria-hidden": "true" }), _jsxs("span", { children: [discountLabel(subscription.subscription.appliedDiscount), subscription.subscription.appliedDiscount.code
                                     ? ` - code ${subscription.subscription.appliedDiscount.code}`
                                     : ""] })] })), _jsx(ConnectCheckoutStatusRow, { checkout: checkout }), _jsx(m.div, { className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3", variants: { show: { transition: { staggerChildren: 0.06 } } }, initial: "hidden", animate: "show", children: tiers.map((tier) => {
                         // The price point this card is showing. A tier missing the toggled

package/dist/esm/client/components/readiness.js

@@ -5,6 +5,7 @@ import { AlertTriangle, ExternalLink, Info, Loader2 } from "lucide-react";
 import { blockingBlockers } from "../../helpers.js";
 import { useConnect, useConnectEntitlements } from "../provider.js";
 import { ENTER, m, MotionProvider } from "./motion.js";
+import { cn } from "../../cn.js";
 /**
  * Codes that mean "somebody at Connect is looking at it" - there is no action
  * for the customer to take, so these get an informational treatment and no
@@ -57,14 +58,14 @@ export function ConnectReadinessBanner({ includeAdvisory = false, hideWhenReady
     if (!session?.user)
         return null;
     if (isLoading) {
-        return (_jsxs("div", { className: `flex items-center gap-2 text-sm text-muted ${className ?? ""}`, children: [_jsx(Loader2, { className: "size-4 animate-spin", "aria-hidden": "true" }), "Checking your workspace\u2026"] }));
+        return (_jsxs("div", { className: cn("flex items-center gap-2 text-sm text-muted", className), children: [_jsx(Loader2, { className: "size-4 animate-spin", "aria-hidden": "true" }), "Checking your workspace\u2026"] }));
     }
     if (!data)
         return null;
     const blockers = includeAdvisory ? data.readiness.readiness.blockers : blockingBlockers(data.readiness);
     if (blockers.length === 0)
         return hideWhenReady ? null : _jsx(ReadyRow, { className: className });
-    return (_jsx(MotionProvider, { children: _jsx(m.div, { className: `flex flex-col gap-2 ${className ?? ""}`, role: "status", initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: blockers.map((blocker) => (_jsx(BlockerRow, { blocker: blocker }, `${blocker.code}-${blocker.message}`))) }) }));
+    return (_jsx(MotionProvider, { children: _jsx(m.div, { className: cn("flex flex-col gap-2", className), role: "status", initial: { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, transition: ENTER, children: blockers.map((blocker) => (_jsx(BlockerRow, { blocker: blocker }, `${blocker.code}-${blocker.message}`))) }) }));
 }
 function BlockerRow({ blocker }) {
     const inProgress = IN_PROGRESS_CODES.has(blocker.code);
@@ -72,7 +73,7 @@ function BlockerRow({ blocker }) {
     return (_jsxs("div", { className: `flex flex-wrap items-center justify-between gap-3 rounded-lg px-3 py-2 text-sm ${inProgress || !isBlocking ? "bg-surface text-muted" : "bg-danger-soft text-danger"}`, children: [_jsxs("span", { className: "flex items-center gap-2", children: [inProgress || !isBlocking ? (_jsx(Info, { className: "size-4 shrink-0", "aria-hidden": "true" })) : (_jsx(AlertTriangle, { className: "size-4 shrink-0", "aria-hidden": "true" })), blocker.message] }), blocker.resolveUrl && !inProgress && (_jsxs(Button, { variant: "secondary", onPress: () => window.open(blocker.resolveUrl, "_blank", "noopener,noreferrer"), children: [actionLabel(blocker), _jsx(ExternalLink, { className: "size-3.5" })] }))] }));
 }
 function ReadyRow({ className }) {
-    return (_jsx("p", { className: `text-sm text-muted ${className ?? ""}`, children: "This workspace is cleared to use every part of the application." }));
+    return (_jsx("p", { className: cn("text-sm text-muted", className), children: "This workspace is cleared to use every part of the application." }));
 }
 /**
  * Renders `children` only once the workspace clears every blocking gate.

package/dist/esm/client/components/shell-context.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, use } from "react";
 import { m } from "./motion.js";
+import { cn } from "../../cn.js";
 /** A plain anchor - correct anywhere, and a full page load. See `ConnectLinkRenderer`. */
 export const defaultRenderLink = ({ children, ...props }) => _jsx("a", { ...props, children: children });
 /**
@@ -137,5 +138,5 @@ export function useConnectShell() {
  */
 export function SidebarLabel({ children, className, }) {
     const { collapsed } = useConnectShell();
-    return (_jsx(m.span, { className: `min-w-0 flex-1 truncate text-start ${className ?? ""}`, animate: { opacity: collapsed ? 0 : 1 }, transition: collapsed ? { duration: 0.1 } : { duration: 0.18, delay: 0.1 }, "aria-hidden": collapsed, children: children }));
+    return (_jsx(m.span, { className: cn("min-w-0 flex-1 truncate text-start", className), animate: { opacity: collapsed ? 0 : 1 }, transition: collapsed ? { duration: 0.1 } : { duration: 0.18, delay: 0.1 }, "aria-hidden": collapsed, children: children }));
 }

package/dist/esm/client/components/side-nav.js

@@ -5,6 +5,7 @@ import { ArrowUpRight } from "lucide-react";
 import { m } from "./motion.js";
 import { SidebarLabel, defaultRenderLink, sidebarRowClass, useConnectShell } from "./shell-context.js";
 import { useActivePath } from "../use-active-path.js";
+import { cn } from "../../cn.js";
 import { isNavItemActive, normalizeNav, resolveActivePath, } from "./nav.js";
 export { defaultRenderLink };
 function rowClass(isActive, depth) {
@@ -64,7 +65,7 @@ export function ConnectSidebarNav({ nav, activePath, renderLink, collapsed, onNa
     const pathname = useActivePath(activePath ?? shell.activePath);
     const active = resolveActivePath(pathname, nav);
     const sections = normalizeNav(nav);
-    return (_jsx("div", { className: `flex flex-col gap-2 ${className ?? ""}`, children: sections.map((section, index) => (_jsxs("nav", { "aria-label": section.title ?? "Main", className: "flex flex-col gap-1", children: [section.title && _jsx(SectionHeading, { title: section.title, collapsed: isCollapsed }), section.items.map((item) => {
+    return (_jsx("div", { className: cn("flex flex-col gap-2", className), children: sections.map((section, index) => (_jsxs("nav", { "aria-label": section.title ?? "Main", className: "flex flex-col gap-1", children: [section.title && _jsx(SectionHeading, { title: section.title, collapsed: isCollapsed }), section.items.map((item) => {
                     const isActive = isNavItemActive(item, active);
                     const activeChild = (item.items ?? []).some((child) => isNavItemActive(child, active));
                     return (_jsxs("div", { className: "flex w-full flex-col gap-1", children: [_jsx(NavRow, { item: item, isActive: isActive, hasActiveChild: activeChild, collapsed: isCollapsed, depth: 0, renderLink: link, onNavigate: navigate }), !isCollapsed &&

package/dist/esm/client/components/sidebar.js

@@ -5,6 +5,7 @@ import { PanelLeftClose, PanelLeftOpen } from "lucide-react";
 import { ConnectLogo } from "./logo.js";
 import { EASE_OUT_QUART, MotionProvider, m } from "./motion.js";
 import { RAIL_COLLAPSED, RAIL_EXPANDED, SidebarLabel, sidebarRowClass, useConnectShell } from "./shell-context.js";
+import { cn } from "../../cn.js";
 /**
  * The rail's own transition.
  *
@@ -43,7 +44,7 @@ export function ConnectSidebar({ children, label = "Sidebar", className }) {
     // from these parts by hand gets a sidebar that jumps between widths
     // instead of animating - a failure that looks like a styling bug and is
     // really a missing provider.
-    _jsx(MotionProvider, { children: _jsx(m.aside, { "aria-label": label, className: `hidden shrink-0 flex-col overflow-hidden border-e border-border bg-surface md:flex ${className ?? ""}`, 
+    _jsx(MotionProvider, { children: _jsx(m.aside, { "aria-label": label, className: cn("hidden shrink-0 flex-col overflow-hidden border-e border-border bg-surface md:flex", className), 
             // `initial={false}` is what stops the rail sweeping open on first paint
             // for a returning user whose stored preference is "collapsed".
             initial: false, animate: { width: collapsed ? RAIL_COLLAPSED : RAIL_EXPANDED }, transition: RAIL_TRANSITION, children: children }) }));

package/dist/esm/client/components/subscription.js

@@ -6,6 +6,7 @@ import { useConnect, useConnectEntitlements } from "../provider.js";
 import { m, MotionProvider } from "./motion.js";
 import { formatPrice, intervalLabel } from "./plan-pricing.js";
 import { ConnectLinkButton } from "./link-button.js";
+import { cn } from "../../cn.js";
 /** Where the plan catalogue lives in the host app. Overridable, because not every app mounts it at `/plans`. */
 const DEFAULT_PLANS_HREF = "/plans";
 function formatDate(iso) {
@@ -74,7 +75,7 @@ export function ConnectSubscriptionCard({ plansHref, className }) {
     const { appUrl } = useConnect();
     const { isLoading, detail, plan, state } = useSubscriptionState();
     if (isLoading)
-        return _jsx(Skeleton, { className: `h-48 rounded-xl ${className ?? ""}` });
+        return _jsx(Skeleton, { className: cn("h-48 rounded-xl", className) });
     if (!detail || !plan)
         return _jsx(ConnectNoSubscriptionCard, { plansHref: plansHref, className: className });
     return (_jsx(MotionProvider, { children: _jsx(m.div, { initial: { opacity: 0 }, animate: { opacity: 1 }, transition: { duration: 0.2 }, children: _jsxs(Card, { className: className, children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx(Card.Title, { children: plan.name }), _jsx(SubscriptionChip, { state: state })] }), _jsxs(Card.Description, { children: [formatPrice(plan.price), " + ", plan.gstRate, "% GST per", " ", intervalLabel(plan.billingInterval).per] })] }), _jsxs(Card.Content, { className: "flex flex-col gap-2 text-sm", children: [_jsx(NextEvent, { detail: detail, state: state }), _jsx(ConnectSeatUsage, { plan: plan, detail: detail })] }), _jsxs(Card.Footer, { className: "flex flex-wrap gap-2", children: [_jsxs(Button, { variant: "secondary", onPress: () => window.open(`${appUrl}/billing/subscriptions/${detail.id}`, "_blank", "noopener,noreferrer"), children: ["Manage on Connect", _jsx(ExternalLink, { className: "size-3.5" })] }), _jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Change plan" })] })] }) }) }));
@@ -124,7 +125,7 @@ export function ConnectSeatUsage({ plan, detail, className, }) {
         return null;
     const included = plan.seats.included ?? 0;
     const over = detail.seatCount - included;
-    return (_jsxs("span", { className: `flex items-center gap-2 text-muted ${className ?? ""}`, children: [_jsx(Users, { className: "size-4 shrink-0", "aria-hidden": "true" }), detail.seatCount, " of ", included, " seat", included === 1 ? "" : "s", " used", over > 0 &&
+    return (_jsxs("span", { className: cn("flex items-center gap-2 text-muted", className), children: [_jsx(Users, { className: "size-4 shrink-0", "aria-hidden": "true" }), detail.seatCount, " of ", included, " seat", included === 1 ? "" : "s", " used", over > 0 &&
                 (plan.seats.model === "per-seat"
                     ? ` - ${over} extra at ${formatPrice(plan.seats.pricePerExtraSeat ?? 0)} each`
                     : ` - ${over} over the plan's limit`)] }));
@@ -146,7 +147,7 @@ export function ConnectTrialBanner({ plansHref, className }) {
     const { detail, state } = useSubscriptionState();
     if (state !== "trialing" || !detail)
         return null;
-    return (_jsxs("div", { className: `flex flex-wrap items-center justify-between gap-3 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent ${className ?? ""}`, children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx(Clock, { className: "size-4 shrink-0", "aria-hidden": "true" }), "You're on a free trial", detail.nextBillingDate ? `. Your first charge is on ${formatDate(detail.nextBillingDate)}.` : "."] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Compare plans" }), _jsxs(Button, { variant: "secondary", onPress: () => window.open(`${appUrl}/billing/subscriptions/${detail.id}`, "_blank", "noopener,noreferrer"), children: ["Manage", _jsx(ExternalLink, { className: "size-3.5" })] })] })] }));
+    return (_jsxs("div", { className: cn("flex flex-wrap items-center justify-between gap-3 rounded-lg bg-accent-soft px-3 py-2 text-sm text-accent", className), children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx(Clock, { className: "size-4 shrink-0", "aria-hidden": "true" }), "You're on a free trial", detail.nextBillingDate ? `. Your first charge is on ${formatDate(detail.nextBillingDate)}.` : "."] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(ConnectLinkButton, { href: plansHref ?? DEFAULT_PLANS_HREF, variant: "tertiary", children: "Compare plans" }), _jsxs(Button, { variant: "secondary", onPress: () => window.open(`${appUrl}/billing/subscriptions/${detail.id}`, "_blank", "noopener,noreferrer"), children: ["Manage", _jsx(ExternalLink, { className: "size-3.5" })] })] })] }));
 }
 /**
  * Renders `children` for a subscribed workspace, and the "pick a plan" card for
@@ -166,7 +167,7 @@ export function ConnectSubscriptionGate({ children, plansHref, fallback, loading
     const { session, isLoading: sessionLoading } = useConnect();
     const { isLoading, state } = useSubscriptionState();
     if (sessionLoading || (session?.user && isLoading)) {
-        return _jsx(_Fragment, { children: loading ?? _jsx(Skeleton, { className: `h-48 rounded-xl ${className ?? ""}` }) });
+        return _jsx(_Fragment, { children: loading ?? _jsx(Skeleton, { className: cn("h-48 rounded-xl", className) }) });
     }
     if (!session?.user)
         return _jsx(_Fragment, { children: fallback ?? null });

package/dist/esm/client/components/usage-meter.js

@@ -5,6 +5,7 @@ import { AlertTriangle } from "lucide-react";
 import { useConnect, useConnectAddonUsage } from "../provider.js";
 import { m, METER_SPRING, MotionProvider } from "./motion.js";
 import { formatPrice } from "./plan-pricing.js";
+import { cn } from "../../cn.js";
 function formatUnits(value, unit) {
     return `${value.toLocaleString("en-IN")} ${unit}`;
 }
@@ -32,7 +33,7 @@ export function ConnectUsageMeter({ addonIds, hideWhenEmpty = true, title = "Usa
     if (!session?.user)
         return null;
     if (isLoading)
-        return _jsx(Skeleton, { className: `h-40 rounded-xl ${className ?? ""}` });
+        return _jsx(Skeleton, { className: cn("h-40 rounded-xl", className) });
     if (error || !data)
         return null;
     // Defended here as well as in `billing.getAddonUsage`, and deliberately so:

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

@@ -9,6 +9,7 @@ import { ConnectAccountSessions } from "./account-sessions.js";
 import { m } from "./motion.js";
 import { SidebarLabel, sidebarRowClass, useConnectShell } from "./shell-context.js";
 import { ICON, MEDALLION, PANEL_FILL } from "./surfaces.js";
+import { cn } from "../../cn.js";
 const THEME_OPTIONS = [
     { value: "light", label: "Light", icon: Sun },
     { value: "dark", label: "Dark", icon: Moon },
@@ -189,7 +190,7 @@ export function ConnectUserButton({ variant = "row", onSignOut, className, theme
     const { session, isLoading } = useConnect();
     const { collapsed } = useConnectShell();
     if (isLoading) {
-        return (_jsxs("div", { className: `flex h-10 items-center gap-3 ${variant === "row" ? "ps-[4px]" : ""} ${className ?? ""}`, children: [_jsx(Skeleton, { className: "size-8 shrink-0 rounded-full" }), variant !== "compact" && !collapsed && _jsx(Skeleton, { className: "h-4 w-24" })] }));
+        return (_jsxs("div", { className: cn("flex h-10 items-center gap-3", variant === "row" ? "ps-[4px]" : "", className), children: [_jsx(Skeleton, { className: "size-8 shrink-0 rounded-full" }), variant !== "compact" && !collapsed && _jsx(Skeleton, { className: "h-4 w-24" })] }));
     }
     const user = session?.user;
     if (!user)
@@ -199,7 +200,7 @@ export function ConnectUserButton({ variant = "row", onSignOut, className, theme
                 // `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: [_jsx(UserAvatar, { user: user, size: "sm" }), variant === "inline" && _jsx("span", { className: "text-sm font-medium text-foreground", children: label })] })), _jsx(ProfileSurface, { onSignOut: onSignOut, theme: theme, onThemeChange: onThemeChange })] }));
+                className: cn("gap-2 ps-1", className), children: [_jsx(UserAvatar, { user: user, size: "sm" }), variant === "inline" && _jsx("span", { className: "text-sm font-medium text-foreground", children: label })] })), _jsx(ProfileSurface, { onSignOut: onSignOut, theme: theme, onThemeChange: onThemeChange })] }));
 }
 /**
  * @deprecated Renamed to `ConnectUserButton` in 0.12 - it is one button that

package/dist/esm/client/provider.js

@@ -133,13 +133,34 @@ export function ConnectProvider({ clientId = "", basePath = "/api/connect", redi
             setResult({ session, error: null });
         }
         catch (cause) {
-            // A bridge that cannot be reached is reported as signed out *with* an
-            // error, so a Login button still renders rather than the UI hanging on
-            // skeletons forever.
-            setResult({
-                session: { user: null, subscription: null, role: null, permissions: [], staff: false, audience: null },
-                error: cause instanceof Error ? cause.message : "Could not reach Connect",
-            });
+            const message = cause instanceof Error ? cause.message : "Could not reach Connect";
+            /*
+             * **A failed read never downgrades a session we already have.**
+             *
+             * This used to replace whatever was known with a signed-out session on
+             * every failure. On a first load that is right - something has to render
+             * rather than skeletons forever - but on a *refresh* it meant one
+             * throttled or dropped request logged the user out of the UI, and the
+             * host app's own guards then acted on that.
+             *
+             * Keeping the last known session is the honest reading: the bridge could
+             * not answer, so what we knew a moment ago is still the best answer we
+             * have. `error` is set either way, so an app that wants to surface
+             * "we've lost touch with Connect" still can.
+             */
+            setResult((previous) => previous?.session.user
+                ? { session: previous.session, error: message }
+                : {
+                    session: {
+                        user: null,
+                        subscription: null,
+                        role: null,
+                        permissions: [],
+                        staff: false,
+                        audience: null,
+                    },
+                    error: message,
+                });
         }
     }, [fetchResource]);
     useEffect(() => {

package/dist/esm/client/use-active-path.js

@@ -17,6 +17,17 @@ let patched = false;
  * actually mounted without an `activePath`. Pass `activePath` (Next:
  * `usePathname()`) and none of this runs at all - which is the recommended
  * path for any app that has a router to ask.
+ *
+ * The notification is deferred to a microtask, and that is load-bearing
+ * rather than tidiness. Next's App Router commits its history entry from
+ * inside a `useInsertionEffect` (`HistoryUpdater` calls
+ * `history.pushState`/`replaceState` there), so a synchronous
+ * `dispatchEvent` reaches `useSyncExternalStore`'s listener *during* that
+ * phase and the re-render it forces is refused: React logs
+ * "useInsertionEffect must not schedule updates" on every navigation. A
+ * microtask runs once the commit's stack has unwound, by which point
+ * `location.pathname` already holds the new value, so the snapshot the store
+ * reads is the same one - only the scheduling moves.
  */
 function patchHistory() {
     if (patched || typeof window === "undefined" || typeof window.history === "undefined")
@@ -26,7 +37,7 @@ function patchHistory() {
         const original = window.history[method];
         window.history[method] = function patchedHistoryMethod(...args) {
             const result = original.apply(this, args);
-            window.dispatchEvent(new Event(LOCATION_CHANGE));
+            queueMicrotask(() => window.dispatchEvent(new Event(LOCATION_CHANGE)));
             return result;
         };
     }

package/dist/esm/cn.js

@@ -0,0 +1,48 @@
+/**
+ * Merge class names so a caller's Tailwind utility actually wins.
+ *
+ * Every component in this package carries default utilities, and a partner
+ * styling one reaches for `className`. Concatenating the two does not do what
+ * it looks like it does:
+ *
+ * ```tsx
+ * // ConnectBookingCalendar with className="gap-8"
+ * <div className={`flex flex-col gap-4 ${className}`} />
+ * //  -> class="flex flex-col gap-4 gap-8"
+ * ```
+ *
+ * Both rules are now in the stylesheet and both match, so the winner is
+ * decided by **source order in the generated CSS**, not by the order they
+ * appear in the attribute. Tailwind sorts its output by its own internal
+ * ordering, so whether `gap-8` beats `gap-4` depends on which utility Tailwind
+ * happens to emit later - `p-8` over `px-3 py-2` lands one way, `gap-8` over
+ * `gap-4` the other. An override that works on one prop and silently does
+ * nothing on the next is worse than one that never works, because nobody
+ * suspects the mechanism.
+ *
+ * `cn` resolves it by *removing* the conflicting default rather than adding to
+ * it - `cn("flex flex-col gap-4", "gap-8")` is `"flex flex-col gap-8"`, and
+ * `cn("px-3 py-2", "p-8")` is `"p-8"`. That is a real understanding of
+ * Tailwind's shorthand groups, which is why it is `tailwind-merge` and not a
+ * `join(" ")`.
+ *
+ * Re-exported rather than reimplemented. The implementation is
+ * `tailwind-variants`' `cn`, which `@heroui/react` re-exports and which every
+ * HeroUI component uses internally through `tv` - so a partner's override is
+ * resolved by exactly the same rules whether it lands on one of these
+ * components or on a HeroUI one. It is reached through `@heroui/react` rather
+ * than `tailwind-variants` directly because HeroUI is already a declared peer
+ * of both UI entry points, and importing a package this manifest does not name
+ * would be relying on someone else's transitive tree.
+ *
+ * Safe in the server-rendered `./ui` entry: the `@heroui/react` barrel carries
+ * no top-level `"use client"` (only its individual components do), so `cn`
+ * arrives as a real function rather than a client-reference proxy. That
+ * distinction matters for a *function* in a way it does not for a component -
+ * `ui/section.tsx` has always imported `Card` from the same barrel.
+ *
+ * Not exported from the root entry, which is isomorphic and React-free. It is
+ * public from `./ui`, because a partner composing on top of these primitives
+ * needs the same merge the primitives use.
+ */
+export { cn } from "@heroui/react";

package/dist/esm/next/index.js

@@ -1,6 +1,7 @@
 import { cache } from "react";
 import { ConnectClient } from "../server/client.js";
 import { createConnectHandler } from "../server/handler.js";
+import { ConnectError } from "../errors.js";
 /**
  * Plug-and-play wiring for Next.js.
  *
@@ -211,7 +212,34 @@ async function readSession(request, options) {
     try {
         return await (options.client ?? connectClient()).identity.getUser(token);
     }
-    catch {
+    catch (cause) {
+        /*
+         * `null` means **not signed in**, and nothing else.
+         *
+         * This used to be a bare `catch { return null }`, so every failure - a
+         * throttled read, a five-hundred, a network blip - was reported to the
+         * caller as "there is no session here". That is the worst possible lie for
+         * this particular function, because `requireConnectSession` and every
+         * app guard built on it answer "not signed in" by redirecting to sign-in.
+         *
+         * The result was a login loop nobody could escape: a 429 on the session
+         * read bounced a signed-in user to `/signin`, the OAuth round trip spent
+         * *more* calls against the same exhausted bucket, and the app 429'd again
+         * on the way back. It could only clear when the rate-limit window rolled.
+         * Both of the screenshots that reported this show exactly that sequence.
+         *
+         * So only a genuine session failure answers `null`. `isSessionExpired`
+         * covers the whole family the API deliberately collapses into
+         * `invalid_token` - unknown, expired, revoked, or issued to another
+         * application - which are the cases where signing in again is the correct
+         * and only response.
+         *
+         * Everything else throws. A page that cannot reach Connect gets an error
+         * boundary, which is recoverable and truthful; being quietly signed out is
+         * neither.
+         */
+        if (cause instanceof ConnectError && !cause.isSessionExpired)
+            throw cause;
         return null;
     }
 }
@@ -254,8 +282,18 @@ const cachedAmbientSession = cache(async () => {
  * any other request-scoped read - a page that awaits it above every boundary
  * gives up its static shell.
  *
- * Returns `null` for every failure - an expired session and a missing one both
- * mean "not signed in", and a page guard should not need a try/catch.
+ * Returns `null` when there is **no session** - no cookie, or one Connect
+ * reports as expired, revoked or issued to another application. A page guard
+ * needs no try/catch for those, which are the cases where sending someone
+ * back through sign-in is the right answer.
+ *
+ * **It throws on anything else**, and that is deliberate. It previously
+ * swallowed every failure into `null`, so a rate-limited or unreachable
+ * Connect read as "signed out" - and `requireConnectSession` then redirected a
+ * signed-in user to sign-in, whose OAuth round trip spent more of the same
+ * exhausted budget and 429'd again on return. A login loop that could only end
+ * when the rate-limit window rolled. An error boundary is the honest outcome
+ * for "could not ask", and unlike a spurious sign-out it is recoverable.
  *
  * **Memoized per request for the plain, zero-argument call** - the shape
  * every page, layout and Server Action actually uses - via React's `cache()`.

package/dist/esm/server/client.js

@@ -157,4 +157,4 @@ export class ConnectClient {
     }
 }
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-export const SDK_VERSION = "0.24.1";
+export const SDK_VERSION = "0.26.0";

package/dist/esm/server/http.js

@@ -118,7 +118,9 @@ export async function request(options, spec) {
     // `PUT` and `DELETE` are idempotent by definition - replaying one lands the
     // same end state - so they retry like `GET`. `POST` still needs an
     // `Idempotency-Key` to earn it, because a replayed create is a second row.
-    const idempotent = spec.method !== "POST" || headers["idempotency-key"] !== undefined;
+    const idempotent = spec.idempotent === true ||
+        spec.method !== "POST" ||
+        headers["idempotency-key"] !== undefined;
     const attempts = idempotent ? options.maxRetries + 1 : 1;
     let lastError;
     for (let attempt = 0; attempt < attempts; attempt++) {

package/dist/esm/server/resources/identity.js

@@ -174,7 +174,14 @@ export class IdentityResource {
      * `authorizeUrl()`.
      */
     async getUser(sessionToken) {
-        const wire = await this.post("/sso/user", { session_token: sessionToken });
+        /*
+         * `idempotent` because it is: this asks who a session token belongs to and
+         * writes nothing. Without it a 429 here reached the caller on the first
+         * attempt, and the transport's `Retry-After` backoff - which exists
+         * exactly for this - never ran, because the rule keyed on the verb rather
+         * than on the effect.
+         */
+        const wire = await this.post("/sso/user", { session_token: sessionToken }, { idempotent: true });
         return {
             user: wire.user,
             subscription: wire.subscription,
@@ -204,8 +211,11 @@ export class IdentityResource {
             scope: options.scope,
         });
     }
-    post(path, form) {
+    post(path, form, 
+    /** Only `idempotent` today - for the `/sso/*` reads that are POSTs. */
+    extra) {
         const spec = {
+            ...extra,
             method: "POST",
             path,
             auth: "none",