@cosmoops/connect-sdk 0.37.0 → 0.38.0

package/dist/cjs/client/components/availability-form.js

@@ -0,0 +1,75 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectAvailabilityFormModal = ConnectAvailabilityFormModal;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@heroui/react");
+const use_scheduling_js_1 = require("../use-scheduling.js");
+const WEEKDAY_LABELS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+const WEEKDAY_KEYS = [0, 1, 2, 3, 4, 5, 6];
+/** Monday-Friday, 9am-5pm - the same starting point Connect's own Console form offers. */
+function defaultWeeklyHours() {
+    const open = [{ startMinute: 9 * 60, endMinute: 17 * 60 }];
+    return { 0: [], 1: open, 2: open, 3: open, 4: open, 5: open, 6: [] };
+}
+function minutesToTimeInput(minutes) {
+    const hours = Math.floor(minutes / 60);
+    const mins = minutes % 60;
+    return `${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}`;
+}
+function timeInputToMinutes(value) {
+    const [hours, minutes] = value.split(":").map(Number);
+    return (hours ?? 0) * 60 + (minutes ?? 0);
+}
+/**
+ * Gives a workspace its first working hours, from inside a host application
+ * rather than a link-out to Connect.
+ *
+ * Deliberately narrower than Connect's own Calendar settings form: one
+ * interval per day (no split shifts), no date overrides, and the timezone
+ * defaults to the browser's own rather than asking. This is a first-run
+ * setup step, not a second copy of the Console editor - "Manage in Connect"
+ * is still where the rest of what a schedule can do lives.
+ *
+ * **Not optimistic.** `useCreateAvailabilitySchedule` settles the write
+ * against the server before this closes, the same posture every write in
+ * this package takes - see `ConnectBookingDialog`.
+ */
+function ConnectAvailabilityFormModal({ isOpen, onOpenChange, onCreated, }) {
+    const [name, setName] = (0, react_1.useState)("Working hours");
+    const [timezone] = (0, react_1.useState)(() => Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC");
+    const [weeklyHours, setWeeklyHours] = (0, react_1.useState)(defaultWeeklyHours);
+    const { createSchedule, isPending, error, clearError } = (0, use_scheduling_js_1.useCreateAvailabilitySchedule)();
+    const toggleDay = (day, open) => {
+        setWeeklyHours((prev) => ({
+            ...prev,
+            [day]: open ? [{ startMinute: 9 * 60, endMinute: 17 * 60 }] : [],
+        }));
+    };
+    const setDayTime = (day, edge, value) => {
+        setWeeklyHours((prev) => {
+            const interval = prev[day][0];
+            if (!interval)
+                return prev;
+            return { ...prev, [day]: [{ ...interval, [edge]: timeInputToMinutes(value) }] };
+        });
+    };
+    const isFormValid = name.trim().length > 0 && !isPending;
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        if (!isFormValid)
+            return;
+        clearError();
+        const schedule = await createSchedule({ name: name.trim(), timezone, weeklyHours });
+        if (schedule) {
+            onCreated?.(schedule);
+            onOpenChange(false);
+        }
+    };
+    return ((0, jsx_runtime_1.jsx)(react_2.Modal, { isOpen: isOpen, onOpenChange: onOpenChange, children: (0, jsx_runtime_1.jsx)(react_2.Modal.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_2.Modal.Container, { children: (0, jsx_runtime_1.jsxs)(react_2.Modal.Dialog, { className: "sm:max-w-120", children: [(0, jsx_runtime_1.jsx)(react_2.Modal.CloseTrigger, {}), (0, jsx_runtime_1.jsx)(react_2.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_2.Modal.Heading, { children: "Set your availability" }) }), (0, jsx_runtime_1.jsx)(react_2.Modal.Body, { children: (0, jsx_runtime_1.jsxs)("form", { onSubmit: handleSubmit, className: "flex flex-col gap-4", children: [(0, jsx_runtime_1.jsxs)(react_2.TextField, { isRequired: true, variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Name" }), (0, jsx_runtime_1.jsx)(react_2.Input, { value: name, onChange: (e) => setName(e.currentTarget.value), disabled: isPending, autoFocus: true })] }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Timezone: ", timezone] }), (0, jsx_runtime_1.jsx)("div", { className: "flex flex-col gap-2", children: WEEKDAY_KEYS.map((day) => {
+                                            const interval = weeklyHours[day][0];
+                                            const isOpenDay = interval !== undefined;
+                                            return ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3", children: [(0, jsx_runtime_1.jsx)(react_2.Switch, { isSelected: isOpenDay, onChange: (open) => toggleDay(day, open), isDisabled: isPending, children: (0, jsx_runtime_1.jsxs)(react_2.Switch.Content, { children: [(0, jsx_runtime_1.jsx)(react_2.Switch.Control, { children: (0, jsx_runtime_1.jsx)(react_2.Switch.Thumb, {}) }), (0, jsx_runtime_1.jsx)("span", { className: "w-24 shrink-0 text-sm", children: WEEKDAY_LABELS[day] })] }) }), isOpenDay && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2", children: [(0, jsx_runtime_1.jsx)(react_2.Input, { type: "time", value: minutesToTimeInput(interval.startMinute), onChange: (e) => setDayTime(day, "startMinute", e.currentTarget.value), disabled: isPending }), (0, jsx_runtime_1.jsx)("span", { className: "text-xs text-muted", children: "to" }), (0, jsx_runtime_1.jsx)(react_2.Input, { type: "time", value: minutesToTimeInput(interval.endMinute), onChange: (e) => setDayTime(day, "endMinute", e.currentTarget.value), disabled: isPending })] }))] }, day));
+                                        }) }), error && (0, jsx_runtime_1.jsx)("p", { className: "text-sm text-danger", children: error }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-end gap-2", children: [(0, jsx_runtime_1.jsx)(react_2.Button, { type: "button", variant: "secondary", onPress: () => onOpenChange(false), isDisabled: isPending, children: "Cancel" }), (0, jsx_runtime_1.jsx)(react_2.Button, { type: "submit", variant: "primary", isDisabled: !isFormValid, children: isPending ? "Saving..." : "Save" })] })] }) })] }) }) }) }));
+}

package/dist/cjs/client/components/event-type-form.js

@@ -0,0 +1,82 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectEventTypeFormModal = ConnectEventTypeFormModal;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@heroui/react");
+const provider_js_1 = require("../provider.js");
+const use_scheduling_js_1 = require("../use-scheduling.js");
+const LOCATION_LABELS = {
+    phone: "Phone call",
+    address: "In person",
+    link: "Video link",
+};
+const LOCATION_KINDS = ["phone", "address", "link"];
+/**
+ * Creates the first thing a workspace can be booked for, from inside a host
+ * application rather than a link-out to Connect.
+ *
+ * **Needs a schedule to exist first** - the picker reads `useAvailabilitySchedules`
+ * and renders "Set up availability first" with nothing to submit if none
+ * exists yet. Pair this with `ConnectAvailabilityFormModal` in a setup flow
+ * rather than assuming one.
+ *
+ * **Host is a specific member, never a team.** There is no groups read in
+ * this bridge, so a round-robin team host stays a Console-only capability -
+ * defaults to whoever is signed in, with an optional picker from the
+ * workspace's own roster.
+ */
+function ConnectEventTypeFormModal({ isOpen, onOpenChange, onCreated, }) {
+    const { session } = (0, provider_js_1.useConnect)();
+    const { data: membersData } = (0, provider_js_1.useConnectWorkspaceMembers)();
+    const { schedules } = (0, use_scheduling_js_1.useAvailabilitySchedules)();
+    const members = (0, react_1.useMemo)(() => membersData?.members ?? [], [membersData]);
+    const defaultHostId = (0, react_1.useMemo)(() => {
+        const self = members.find((member) => member.userId === session?.user?.userId);
+        return self?.memberId ?? members[0]?.memberId ?? "";
+    }, [members, session?.user?.userId]);
+    const [name, setName] = (0, react_1.useState)("");
+    const [description, setDescription] = (0, react_1.useState)("");
+    const [durationMinutes, setDurationMinutes] = (0, react_1.useState)(30);
+    const [bufferBefore, setBufferBefore] = (0, react_1.useState)(5);
+    const [bufferAfter, setBufferAfter] = (0, react_1.useState)(5);
+    const [scheduleId, setScheduleId] = (0, react_1.useState)("");
+    const [hostMemberId, setHostMemberId] = (0, react_1.useState)("");
+    const [locationKind, setLocationKind] = (0, react_1.useState)("phone");
+    const [locationValue, setLocationValue] = (0, react_1.useState)("");
+    const effectiveScheduleId = scheduleId || schedules[0]?.id || "";
+    const effectiveHostMemberId = hostMemberId || defaultHostId;
+    const { createEventType, isPending, error, clearError } = (0, use_scheduling_js_1.useCreateEventType)();
+    const isFormValid = name.trim().length > 0 &&
+        durationMinutes >= 5 &&
+        durationMinutes <= 480 &&
+        effectiveScheduleId.length > 0 &&
+        effectiveHostMemberId.length > 0 &&
+        !isPending;
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        if (!isFormValid)
+            return;
+        clearError();
+        const trimmedDescription = description.trim();
+        const created = await createEventType({
+            name: name.trim(),
+            description: trimmedDescription.length > 0 ? trimmedDescription : null,
+            durationMinutes,
+            bufferBeforeMinutes: bufferBefore,
+            bufferAfterMinutes: bufferAfter,
+            hostMemberId: effectiveHostMemberId,
+            scheduleId: effectiveScheduleId,
+            location: {
+                kind: locationKind,
+                value: locationValue.trim().length > 0 ? locationValue.trim() : null,
+            },
+        });
+        if (created) {
+            onCreated?.(created);
+            onOpenChange(false);
+        }
+    };
+    return ((0, jsx_runtime_1.jsx)(react_2.Modal, { isOpen: isOpen, onOpenChange: onOpenChange, children: (0, jsx_runtime_1.jsx)(react_2.Modal.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_2.Modal.Container, { children: (0, jsx_runtime_1.jsxs)(react_2.Modal.Dialog, { className: "sm:max-w-140", children: [(0, jsx_runtime_1.jsx)(react_2.Modal.CloseTrigger, {}), (0, jsx_runtime_1.jsx)(react_2.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_2.Modal.Heading, { children: "New appointment type" }) }), (0, jsx_runtime_1.jsx)(react_2.Modal.Body, { children: schedules.length === 0 ? ((0, jsx_runtime_1.jsx)("p", { className: "text-sm text-muted", children: "Set up availability first - an appointment type needs working hours to book against." })) : ((0, jsx_runtime_1.jsxs)("form", { onSubmit: handleSubmit, className: "flex flex-col gap-4", children: [(0, jsx_runtime_1.jsxs)(react_2.TextField, { isRequired: true, variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Name" }), (0, jsx_runtime_1.jsx)(react_2.Input, { placeholder: "Consultation", value: name, onChange: (e) => setName(e.currentTarget.value), disabled: isPending, autoFocus: true })] }), (0, jsx_runtime_1.jsxs)(react_2.TextField, { variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Description" }), (0, jsx_runtime_1.jsx)(react_2.TextArea, { placeholder: "What this appointment is for", value: description, onChange: (e) => setDescription(e.currentTarget.value), disabled: isPending, rows: 2 })] }), (0, jsx_runtime_1.jsxs)("div", { className: "grid gap-4 sm:grid-cols-3", children: [(0, jsx_runtime_1.jsxs)(react_2.TextField, { isRequired: true, variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Length (min)" }), (0, jsx_runtime_1.jsx)(react_2.Input, { type: "number", value: String(durationMinutes), onChange: (e) => setDurationMinutes(Number(e.currentTarget.value)), disabled: isPending })] }), (0, jsx_runtime_1.jsxs)(react_2.TextField, { variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Gap before" }), (0, jsx_runtime_1.jsx)(react_2.Input, { type: "number", value: String(bufferBefore), onChange: (e) => setBufferBefore(Number(e.currentTarget.value)), disabled: isPending })] }), (0, jsx_runtime_1.jsxs)(react_2.TextField, { variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Gap after" }), (0, jsx_runtime_1.jsx)(react_2.Input, { type: "number", value: String(bufferAfter), onChange: (e) => setBufferAfter(Number(e.currentTarget.value)), disabled: isPending })] })] }), schedules.length > 1 && ((0, jsx_runtime_1.jsxs)(react_2.Select, { variant: "secondary", value: effectiveScheduleId, onChange: (value) => setScheduleId(String(value)), isDisabled: isPending, children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Availability" }), (0, jsx_runtime_1.jsxs)(react_2.Select.Trigger, { children: [(0, jsx_runtime_1.jsx)(react_2.Select.Value, {}), (0, jsx_runtime_1.jsx)(react_2.Select.Indicator, {})] }), (0, jsx_runtime_1.jsx)(react_2.Select.Popover, { children: (0, jsx_runtime_1.jsx)(react_2.ListBox, { children: schedules.map((schedule) => ((0, jsx_runtime_1.jsxs)(react_2.ListBox.Item, { id: schedule.id, textValue: schedule.name, children: [schedule.name, (0, jsx_runtime_1.jsx)(react_2.ListBox.ItemIndicator, {})] }, schedule.id))) }) })] })), members.length > 1 && ((0, jsx_runtime_1.jsxs)(react_2.Select, { variant: "secondary", value: effectiveHostMemberId, onChange: (value) => setHostMemberId(String(value)), isDisabled: isPending, children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Who hosts it" }), (0, jsx_runtime_1.jsxs)(react_2.Select.Trigger, { children: [(0, jsx_runtime_1.jsx)(react_2.Select.Value, {}), (0, jsx_runtime_1.jsx)(react_2.Select.Indicator, {})] }), (0, jsx_runtime_1.jsx)(react_2.Select.Popover, { children: (0, jsx_runtime_1.jsx)(react_2.ListBox, { children: members.map((member) => ((0, jsx_runtime_1.jsxs)(react_2.ListBox.Item, { id: member.memberId, textValue: member.displayName ?? member.email, children: [member.displayName ?? member.email, (0, jsx_runtime_1.jsx)(react_2.ListBox.ItemIndicator, {})] }, member.memberId))) }) })] })), (0, jsx_runtime_1.jsxs)("div", { className: "grid gap-4 sm:grid-cols-2", children: [(0, jsx_runtime_1.jsxs)(react_2.Select, { variant: "secondary", value: locationKind, onChange: (value) => setLocationKind(value), isDisabled: isPending, children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Where" }), (0, jsx_runtime_1.jsxs)(react_2.Select.Trigger, { children: [(0, jsx_runtime_1.jsx)(react_2.Select.Value, {}), (0, jsx_runtime_1.jsx)(react_2.Select.Indicator, {})] }), (0, jsx_runtime_1.jsx)(react_2.Select.Popover, { children: (0, jsx_runtime_1.jsx)(react_2.ListBox, { children: LOCATION_KINDS.map((kind) => ((0, jsx_runtime_1.jsxs)(react_2.ListBox.Item, { id: kind, textValue: LOCATION_LABELS[kind], children: [LOCATION_LABELS[kind], (0, jsx_runtime_1.jsx)(react_2.ListBox.ItemIndicator, {})] }, kind))) }) })] }), (0, jsx_runtime_1.jsxs)(react_2.TextField, { variant: "secondary", children: [(0, jsx_runtime_1.jsx)(react_2.Label, { children: "Details" }), (0, jsx_runtime_1.jsx)(react_2.TextArea, { placeholder: locationKind === "address" ? "Where to come" : "Left blank is fine", value: locationValue, onChange: (e) => setLocationValue(e.currentTarget.value), disabled: isPending, rows: 2 })] })] }), error && (0, jsx_runtime_1.jsx)("p", { className: "text-sm text-danger", children: error }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-end gap-2", children: [(0, jsx_runtime_1.jsx)(react_2.Button, { type: "button", variant: "secondary", onPress: () => onOpenChange(false), isDisabled: isPending, children: "Cancel" }), (0, jsx_runtime_1.jsx)(react_2.Button, { type: "submit", variant: "primary", isDisabled: !isFormValid, children: isPending ? "Saving..." : "Create" })] })] })) })] }) }) }) }));
+}

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

@@ -13,6 +13,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("@heroui/react");
 const lucide_react_1 = require("lucide-react");
 const provider_js_1 = require("../provider.js");
+const portal_links_js_1 = require("../portal-links.js");
 const mark_js_1 = require("../mark.js");
 const identity_js_1 = require("./identity.js");
 const account_sessions_js_1 = require("./account-sessions.js");
@@ -28,28 +29,6 @@ const THEME_OPTIONS = [
 function openExternal(url) {
     window.open(url, "_blank", "noopener,noreferrer");
 }
-/**
- * Connect's profile page, with the context it needs to offer a way back here.
- *
- * Connect answers `/profile` for any signed-in user, so the bare URL works on
- * its own - these two params only add the "Back to <your app>" banner. It
- * validates `return_to` against this `client_id`'s registered redirect
- * origins and silently drops the banner if they don't match, so a wrong or
- * stale `appUrl`/`clientId` pairing degrades to what it did before rather
- * than erroring.
- *
- * `window.location.href` rather than a configured home URL: the point is to
- * come back to the page they left, and only the browser knows which one that
- * is.
- */
-function profileUrl(appUrl, clientId) {
-    const url = new URL("/profile", appUrl);
-    url.searchParams.set("client_id", clientId);
-    if (typeof window !== "undefined") {
-        url.searchParams.set("return_to", window.location.href);
-    }
-    return url.toString();
-}
 /**
  * The member's photo, with their initials underneath it.
  *
@@ -150,7 +129,7 @@ function ProfileSurface({ onSignOut, theme, onThemeChange, }) {
     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) => {
+    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: (0, portal_links_js_1.connectPortalUrl)(appUrl, clientId, "/profile") }), (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);
@@ -260,7 +239,7 @@ function ConnectProfileButton({ className }) {
     const { session, appUrl, clientId } = (0, provider_js_1.useConnect)();
     if (!session?.user)
         return null;
-    return ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", className: className, onPress: () => openExternal(profileUrl(appUrl, clientId)), children: [(0, jsx_runtime_1.jsx)(lucide_react_1.UserRound, { className: "size-4 shrink-0" }), "Profile", (0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "size-3.5 shrink-0 text-muted" })] }));
+    return ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", className: className, onPress: () => openExternal((0, portal_links_js_1.connectPortalUrl)(appUrl, clientId, "/profile")), children: [(0, jsx_runtime_1.jsx)(lucide_react_1.UserRound, { className: "size-4 shrink-0" }), "Profile", (0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "size-3.5 shrink-0 text-muted" })] }));
 }
 /** A plain "Open Connect" button, for a footer or a help menu. */
 function ConnectHomeButton({ className }) {

package/dist/cjs/client/index.js

@@ -1,9 +1,9 @@
 "use client";
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useConnectPush = 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.ConnectOneTap = 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.useConnectOptional = exports.useConnect = exports.ConnectProvider = void 0;
-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.visitorSlotOfferFrom = exports.readVisitorStream = exports.ConnectVisitorChat = exports.isLinkableConnectScreen = exports.matchConnectScreen = exports.filterNavForAudience = exports.gateExemptPaths = exports.isNavItemActive = exports.resolveActivePath = exports.normalizePath = exports.flattenNav = exports.normalizeNav = void 0;
-exports.zonedInstant = exports.dayColumns = exports.layoutBookings = exports.useBookingActions = exports.useBookings = exports.useAvailableSlots = exports.useBookableEventTypes = exports.ConnectBookingDetail = exports.ConnectBookingDialog = exports.ConnectBookingCalendar = exports.useConnectWorkspaceMembers = exports.useConnectWorkspaces = exports.ConnectWorkspaceSwitcher = exports.resolvePlanGroup = exports.groupPlansByTier = exports.isFreePlan = exports.ACTION_LABEL = exports.discountLabel = exports.annualSaving = exports.checkoutSubscriptionId = exports.resolveAction = exports.monthlyOf = exports.formatPrice = exports.buildCheckoutUrl = exports.useConnectCheckout = void 0;
+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.useConnectPortalUrl = exports.connectPortalUrl = exports.ConnectAccountSessions = exports.ConnectSignOutButton = exports.ConnectHomeButton = exports.ConnectProfileButton = exports.ConnectInvoicesButton = exports.ConnectManageSubscriptionButton = exports.ConnectUserMenu = exports.ConnectProfileModal = exports.ConnectUserButton = exports.ConnectOneTap = 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.useConnectOptional = exports.useConnect = exports.ConnectProvider = void 0;
+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.visitorSlotOfferFrom = exports.readVisitorStream = exports.ConnectVisitorChat = exports.isLinkableConnectScreen = exports.matchConnectScreen = exports.filterNavForAudience = exports.gateExemptPaths = exports.isNavItemActive = exports.resolveActivePath = exports.normalizePath = exports.flattenNav = exports.normalizeNav = exports.useConnectPush = exports.useActivePath = void 0;
+exports.zonedInstant = exports.dayColumns = exports.layoutBookings = exports.useBookingActions = exports.useBookings = exports.useAvailableSlots = exports.useCreateEventType = exports.useCreateAvailabilitySchedule = exports.useAvailabilitySchedules = exports.useBookableEventTypes = exports.ConnectEventTypeFormModal = exports.ConnectAvailabilityFormModal = exports.ConnectBookingDetail = exports.ConnectBookingDialog = exports.ConnectBookingCalendar = exports.useConnectWorkspaceMembers = exports.useConnectWorkspaces = exports.ConnectWorkspaceSwitcher = exports.resolvePlanGroup = exports.groupPlansByTier = exports.isFreePlan = exports.ACTION_LABEL = exports.discountLabel = exports.annualSaving = exports.checkoutSubscriptionId = exports.resolveAction = exports.monthlyOf = exports.formatPrice = exports.buildCheckoutUrl = exports.useConnectCheckout = exports.ConnectFilterTabs = exports.ConnectCursorPagination = void 0;
 /**
  * Browser half of `@cosmoops/connect-sdk` - React components and hooks.
  *
@@ -69,6 +69,13 @@ Object.defineProperty(exports, "ConnectSignOutButton", { enumerable: true, get:
 // `ConnectUserMenu` was the only thing that could render it.
 var account_sessions_js_1 = require("./components/account-sessions.js");
 Object.defineProperty(exports, "ConnectAccountSessions", { enumerable: true, get: function () { return account_sessions_js_1.ConnectAccountSessions; } });
+// A link to *any* Connect portal page that offers a "Back to <your app>" way
+// home - what `ConnectProfileButton` builds for `/profile` internally, made
+// reusable for a host linking out to a different Connect page (e.g.
+// `/calendar/settings`) on its own.
+var portal_links_js_1 = require("./portal-links.js");
+Object.defineProperty(exports, "connectPortalUrl", { enumerable: true, get: function () { return portal_links_js_1.connectPortalUrl; } });
+Object.defineProperty(exports, "useConnectPortalUrl", { enumerable: true, get: function () { return portal_links_js_1.useConnectPortalUrl; } });
 // The frame the rest of these components live inside. Exported next to the
 // 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
@@ -262,8 +269,19 @@ Object.defineProperty(exports, "ConnectBookingCalendar", { enumerable: true, get
 var booking_dialogs_js_1 = require("./components/booking-dialogs.js");
 Object.defineProperty(exports, "ConnectBookingDialog", { enumerable: true, get: function () { return booking_dialogs_js_1.ConnectBookingDialog; } });
 Object.defineProperty(exports, "ConnectBookingDetail", { enumerable: true, get: function () { return booking_dialogs_js_1.ConnectBookingDetail; } });
+// The write half of scheduling - a workspace's own first-time setup, not a
+// partner integration's booking flow. `ConnectAvailabilityFormModal` and
+// `ConnectEventTypeFormModal` give a host application a real inline setup
+// step instead of a link-out to Connect's own Calendar settings.
+var availability_form_js_1 = require("./components/availability-form.js");
+Object.defineProperty(exports, "ConnectAvailabilityFormModal", { enumerable: true, get: function () { return availability_form_js_1.ConnectAvailabilityFormModal; } });
+var event_type_form_js_1 = require("./components/event-type-form.js");
+Object.defineProperty(exports, "ConnectEventTypeFormModal", { enumerable: true, get: function () { return event_type_form_js_1.ConnectEventTypeFormModal; } });
 var use_scheduling_js_1 = require("./use-scheduling.js");
 Object.defineProperty(exports, "useBookableEventTypes", { enumerable: true, get: function () { return use_scheduling_js_1.useBookableEventTypes; } });
+Object.defineProperty(exports, "useAvailabilitySchedules", { enumerable: true, get: function () { return use_scheduling_js_1.useAvailabilitySchedules; } });
+Object.defineProperty(exports, "useCreateAvailabilitySchedule", { enumerable: true, get: function () { return use_scheduling_js_1.useCreateAvailabilitySchedule; } });
+Object.defineProperty(exports, "useCreateEventType", { enumerable: true, get: function () { return use_scheduling_js_1.useCreateEventType; } });
 Object.defineProperty(exports, "useAvailableSlots", { enumerable: true, get: function () { return use_scheduling_js_1.useAvailableSlots; } });
 Object.defineProperty(exports, "useBookings", { enumerable: true, get: function () { return use_scheduling_js_1.useBookings; } });
 Object.defineProperty(exports, "useBookingActions", { enumerable: true, get: function () { return use_scheduling_js_1.useBookingActions; } });

package/dist/cjs/client/portal-links.js

@@ -0,0 +1,38 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectPortalUrl = connectPortalUrl;
+exports.useConnectPortalUrl = useConnectPortalUrl;
+const provider_js_1 = require("./provider.js");
+/**
+ * Any Connect portal page, with the context it needs to offer a way back
+ * here - `connectPortalUrl(appUrl, clientId, "/profile")`,
+ * `connectPortalUrl(appUrl, clientId, "/calendar/settings")`, and so on.
+ *
+ * Connect answers any of these paths for a signed-in user on the bare URL -
+ * these two params only add the "Back to <your app>" banner
+ * (`ApplicationReturnBar` on Connect's side). It validates `return_to`
+ * against this `client_id`'s registered redirect origins and silently drops
+ * the banner if they don't match, so a wrong or stale `appUrl`/`clientId`
+ * pairing degrades to what linking there did before rather than erroring.
+ *
+ * `window.location.href` rather than a configured home URL: the point is to
+ * come back to the page they left, and only the browser knows which one that
+ * is.
+ */
+function connectPortalUrl(appUrl, clientId, path) {
+    const url = new URL(path, appUrl);
+    url.searchParams.set("client_id", clientId);
+    if (typeof window !== "undefined") {
+        url.searchParams.set("return_to", window.location.href);
+    }
+    return url.toString();
+}
+/**
+ * `connectPortalUrl`, with `appUrl`/`clientId` read from the provider instead
+ * of threaded through by every caller.
+ */
+function useConnectPortalUrl(path) {
+    const { appUrl, clientId } = (0, provider_js_1.useConnect)();
+    return connectPortalUrl(appUrl, clientId, path);
+}

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

@@ -2,6 +2,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useBookableEventTypes = useBookableEventTypes;
+exports.useAvailabilitySchedules = useAvailabilitySchedules;
+exports.useCreateAvailabilitySchedule = useCreateAvailabilitySchedule;
+exports.useCreateEventType = useCreateEventType;
 exports.useAvailableSlots = useAvailableSlots;
 exports.useBookings = useBookings;
 exports.useBookingActions = useBookingActions;
@@ -21,6 +24,48 @@ function useBookableEventTypes() {
     const { data, isLoading, error } = (0, provider_js_1.useConnectResource)("/scheduling/event-types");
     return { eventTypes: data?.eventTypes ?? [], isLoading, error };
 }
+/**
+ * The working-hours templates an appointment type can point at.
+ *
+ * Read this before offering a "set up availability" step - a workspace that
+ * already has one does not need a second "Working hours" from your UI.
+ */
+function useAvailabilitySchedules() {
+    const { data, isLoading, error } = (0, provider_js_1.useConnectResource)("/scheduling/schedules");
+    return { schedules: data?.schedules ?? [], isLoading, error };
+}
+/**
+ * Gives a workspace its first working hours.
+ *
+ * **Not optimistic** - same posture as `useBookingActions`: this is one of
+ * the two writes a host's first-run setup makes, and a modal that closes on
+ * a failed create is worse than one that stays open with the reason shown.
+ */
+function useCreateAvailabilitySchedule() {
+    const { run, isPending, error, clearError } = useResourceAction();
+    return {
+        isPending,
+        error,
+        clearError,
+        createSchedule: (input) => run("/scheduling/schedules", input),
+    };
+}
+/**
+ * Creates the first thing a workspace can be booked for.
+ *
+ * Host is a specific member, never a team - there is no groups read in this
+ * bridge, so a round-robin team host stays a Console-only capability
+ * reachable by following "Manage in Connect".
+ */
+function useCreateEventType() {
+    const { run, isPending, error, clearError } = useResourceAction();
+    return {
+        isPending,
+        error,
+        clearError,
+        createEventType: (input) => run("/scheduling/event-types", input),
+    };
+}
 /**
  * Free times for one appointment type.
  *
@@ -74,15 +119,16 @@ function useBookings(query) {
     };
 }
 /**
- * Book, move and cancel.
+ * The isPending/error bookkeeping every write in this file shares, factored
+ * out once `useCreateAvailabilitySchedule` and `useCreateEventType` needed
+ * the identical shape `useBookingActions` already had.
  *
- * **None of these is optimistic**, and that is not an oversight. Whether a
- * slot is still free is a question only the server can answer, inside the
- * transaction that decides it - two people can be holding the same minute
- * right now. Painting a booking as made and withdrawing it is exactly the lie
- * the two-phase hold exists to prevent.
+ * **Never optimistic**, and that is not an oversight for any caller of this:
+ * whether a slot is free, or a schedule name collides, is a question only the
+ * server can answer. Painting the result before it comes back is exactly the
+ * lie a two-phase hold (or a modal that closes early) would tell.
  */
-function useBookingActions() {
+function useResourceAction() {
     const { mutateResource } = (0, provider_js_1.useConnect)();
     const [isPending, setPending] = (0, react_1.useState)(false);
     const [error, setError] = (0, react_1.useState)(null);
@@ -102,10 +148,23 @@ function useBookingActions() {
             setPending(false);
         }
     }, [mutateResource]);
+    return { isPending, error, clearError: () => setError(null), run };
+}
+/**
+ * Book, move and cancel.
+ *
+ * **None of these is optimistic**, and that is not an oversight. Whether a
+ * slot is still free is a question only the server can answer, inside the
+ * transaction that decides it - two people can be holding the same minute
+ * right now. Painting a booking as made and withdrawing it is exactly the lie
+ * the two-phase hold exists to prevent.
+ */
+function useBookingActions() {
+    const { run, isPending, error, clearError } = useResourceAction();
     return {
         isPending,
         error,
-        clearError: () => setError(null),
+        clearError,
         createBooking: (input) => run("/scheduling/bookings", input),
         rescheduleBooking: (input) => run("/scheduling/bookings/reschedule", input).then((result) => result?.booking ?? null),
         cancelBooking: (input) => run("/scheduling/bookings/cancel", input),

package/dist/cjs/server/client.js

@@ -179,4 +179,4 @@ class ConnectClient {
 }
 exports.ConnectClient = ConnectClient;
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-exports.SDK_VERSION = "0.37.0";
+exports.SDK_VERSION = "0.38.0";

package/dist/cjs/server/handler.js

@@ -853,6 +853,84 @@ function createConnectHandler(options) {
             const asUser = await requireToken(request);
             return json({ eventTypes: await client.scheduling.listEventTypes(workspaceId, { asUser }) });
         },
+        /*
+         * Creates the first thing a workspace can be booked for - a browser-side
+         * counterpart to `POST /scheduling/event-types` above, for a host's own
+         * inline setup UI (`ConnectEventTypeFormModal`). Host is a specific
+         * member, never a team - there is no groups read in this bridge, so a
+         * round-robin team host stays a Console-only capability.
+         */
+        "POST /scheduling/event-types": async (request) => {
+            const { workspaceId } = await requireWorkspace(request);
+            const asUser = await requireToken(request);
+            const body = (await request.json().catch(() => null));
+            if (typeof body?.name !== "string" ||
+                typeof body.durationMinutes !== "number" ||
+                typeof body.hostMemberId !== "string" ||
+                typeof body.scheduleId !== "string" ||
+                typeof body.location?.kind !== "string") {
+                throw new errors_js_1.ConnectError({
+                    status: 400,
+                    code: "validation_error",
+                    message: "name, durationMinutes, hostMemberId, scheduleId and location are required",
+                    endpoint: "/scheduling/event-types",
+                });
+            }
+            return json(await client.scheduling.createEventType({
+                workspaceId,
+                name: body.name,
+                description: typeof body.description === "string" ? body.description : null,
+                durationMinutes: body.durationMinutes,
+                bufferBeforeMinutes: typeof body.bufferBeforeMinutes === "number" ? body.bufferBeforeMinutes : undefined,
+                bufferAfterMinutes: typeof body.bufferAfterMinutes === "number" ? body.bufferAfterMinutes : undefined,
+                hostMemberId: body.hostMemberId,
+                scheduleId: body.scheduleId,
+                location: {
+                    kind: body.location.kind,
+                    value: typeof body.location.value === "string" ? body.location.value : null,
+                },
+                publicBookingEnabled: typeof body.publicBookingEnabled === "boolean" ? body.publicBookingEnabled : undefined,
+                asUser,
+            }), 201);
+        },
+        /*
+         * The working-hours templates an appointment type can point at - read
+         * before a setup UI offers to create one, so it can tell "none yet" from
+         * "already set up".
+         */
+        "GET /scheduling/schedules": async (request) => {
+            const { workspaceId } = await requireWorkspace(request);
+            const asUser = await requireToken(request);
+            return json({ schedules: await client.scheduling.listSchedules(workspaceId, { asUser }) });
+        },
+        /**
+         * Gives a workspace its first working hours - the browser-side
+         * counterpart to `POST /scheduling/schedules` above, for
+         * `ConnectAvailabilityFormModal`.
+         */
+        "POST /scheduling/schedules": async (request) => {
+            const { workspaceId } = await requireWorkspace(request);
+            const asUser = await requireToken(request);
+            const body = (await request.json().catch(() => null));
+            if (typeof body?.name !== "string" ||
+                typeof body.timezone !== "string" ||
+                typeof body.weeklyHours !== "object" ||
+                body.weeklyHours === null) {
+                throw new errors_js_1.ConnectError({
+                    status: 400,
+                    code: "validation_error",
+                    message: "name, timezone and weeklyHours are required",
+                    endpoint: "/scheduling/schedules",
+                });
+            }
+            return json(await client.scheduling.createSchedule({
+                workspaceId,
+                name: body.name,
+                timezone: body.timezone,
+                weeklyHours: body.weeklyHours,
+                asUser,
+            }), 201);
+        },
         "GET /scheduling/slots": async (request) => {
             const { workspaceId } = await requireWorkspace(request);
             const asUser = await requireToken(request);

package/dist/cjs/server/http.js

@@ -1,8 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERATION_TIMEOUT_MS = void 0;
 exports.pathSegment = pathSegment;
 exports.request = request;
 const errors_js_1 = require("../errors.js");
+/**
+ * How long a *generating* endpoint may take to send its headers.
+ *
+ * One number, named once, and it is not a guess: it is what
+ * `POST /visitor/chat` and `POST /ai/chat` declare as their `maxDuration` on
+ * the far side. A client bound shorter than the route's own ceiling cannot be
+ * right - it can only abort work Connect is still allowed to be doing - and
+ * the two numbers drifting apart is exactly how a 20s client came to be
+ * fronting a 60s route.
+ */
+exports.GENERATION_TIMEOUT_MS = 60_000;
 const RETRYABLE_STATUS = new Set([408, 429, 500, 502, 503, 504]);
 /**
  * One id, safe to interpolate into a request path.
@@ -149,7 +161,7 @@ async function request(options, spec) {
         // that has actually started to run as long as it needs. A caller that
         // wants to bound the stream itself passes `spec.signal`.
         const timeoutController = new AbortController();
-        const timer = setTimeout(() => timeoutController.abort(), options.timeoutMs);
+        const timer = setTimeout(() => timeoutController.abort(), spec.timeoutMs ?? options.timeoutMs);
         const signal = spec.signal
             ? AbortSignal.any([spec.signal, timeoutController.signal])
             : timeoutController.signal;

package/dist/cjs/server/resources/ai.js

@@ -43,6 +43,12 @@ class AiResource {
                 ...(input.screenContext ? { screenContext: input.screenContext } : {}),
             },
             headers: (0, acting_as_js_1.actingAs)(input.asUser),
+            /*
+             * Matches the route's own `maxDuration`. This endpoint does not send
+             * headers until the model's first token, so the default 20s bound was
+             * aborting any turn that opened with a tool call - see `RequestSpec.timeoutMs`.
+             */
+            timeoutMs: http_js_1.GENERATION_TIMEOUT_MS,
             raw: true,
             signal: options.signal,
         });