@cosmoops/connect-sdk 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -3,6 +3,89 @@
 `@cosmoops/connect-sdk` follows semver, with the 0.x convention that **minor
 versions may carry breaking changes** and patch versions never do.
 
+## 0.20.0
+
+### Changed
+
+- **The app launcher shows the whole catalogue, in two groups.**
+  `<ConnectAppsGrid>` now renders **Your apps** - what this workspace holds a
+  live subscription to - and **Explore**, the rest of the platform's active
+  applications. A tile in the first opens the application's own site; a tile in
+  the second opens that application's page on Connect, where a plan is chosen.
+  Your integration builds neither URL.
+
+  Tiles draw the application's registered icon (its uploaded brand image, or
+  its `lucide-react` icon from Connect's curated set) instead of a generic grid
+  glyph, the grid animates in, and a filter field appears once there are more
+  than eight tiles. The **"Browse all applications"** footer link is **gone**:
+  it pointed at `/applications` on Connect, a route that has never existed, so
+  the one discovery path the launcher offered was a 404. Discovery belongs in
+  the grid.
+
+- **`GET /apps` answers with every active application**, not only the
+  subscribed ones. `WorkspaceApp` gains two fields:
+
+  ```ts
+  interface WorkspaceApp {
+    subscribed: boolean;   // launchable now, vs. an invitation to subscribe
+    category: WorkspaceAppCategory;
+    // …unchanged
+  }
+  ```
+
+  `needsAttention` is always `false` when `subscribed` is `false`, and an
+  application whose subscription was **cancelled** now appears in the explore
+  half rather than disappearing. Applications this workspace's `type` is
+  outside the audience of are omitted entirely unless it already holds a
+  subscription to one - showing a tile whose only outcome is a refusal at
+  checkout is the dead end this change set out to remove.
+
+  **If you render your own grid from `connect.apps.list()`, filter on
+  `subscribed` to get the previous set back.** That is the only migration;
+  nothing was removed from the row.
+
+## 0.19.0
+
+### Added
+
+- **`connect.contacts`** - who a workspace already knows how to reach.
+
+  ```ts
+  const contact = await connect.contacts.lookupByPhone({ workspaceId, phone });
+  if (contact) {
+    // A caller this workspace has met before.
+  }
+  ```
+
+  `lookupByPhone` is one point read, cheap enough for a screen pop on every
+  inbound call, and resolves to `null` for a first-time caller - the ordinary
+  case, not an error. `get(contactId, { workspaceId })` reads the record behind
+  an id you already hold. Needs a key scoped to `contacts:read` and a live
+  subscription in the workspace.
+
+  **This is the telephony identity, not a CRM record.** A contact is keyed by
+  `primaryPhone` - the one fact every inbound call carries - and it is written
+  automatically: a voice agent creates one on the first call from a new number
+  and fills fields in as it learns them. `source` tells you which kind you are
+  holding (`call` means an agent guessed and nobody has confirmed), and
+  `phones[].verified` tells you the same about a single value.
+
+  **Reference it, do not copy it.** If your application keeps its own customer
+  records, store this contact's `id` on yours. Two writable copies of a
+  person's name with no single owner drift, and Connect's is the one an agent
+  keeps updating from calls. Storing the id also makes `Booking.contactId` an
+  **exact** join - so "which of my records is this appointment for" is a lookup
+  rather than a phone-number match, including for appointments a voice agent
+  booked where nobody ever chose one of your records.
+
+  Read-only, deliberately. Writing into a store with a per-field provenance
+  chain means declaring where your facts came from and how they merge with a
+  human's; nothing needs that yet.
+
+- New exported types: `ConnectContact`, `ContactChannelValue`, `ContactSource`,
+  and `ContactsResource` / `LookupContactInput` from
+  `@cosmoops/connect-sdk/server`.
+
 ## 0.18.0
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 Official client for the **CosmoOps Connect application-partner API** (`/api/v1/application/*`).
 
-**Current version: `0.8.0`** · [Release notes](#release-notes) · [Full changelog](./CHANGELOG.md)
+**Current version: `0.20.0`** · [Release notes](#release-notes) · [Full changelog](./CHANGELOG.md)
 — follows semver with the 0.x convention that a **minor** version may carry a
 breaking change (a patch never does). Read the release notes for your target
 version before upgrading past a minor bump.
@@ -342,6 +342,7 @@ try {
 | `entitlements` | `getReadiness` · `getSubscription` · `hasFeature` |
 | `billing` | `listPlans` · `getAddonUsage` · `consumeAddon` |
 | `drive` | `upload` · `getFileUrl` · `getPreviewUrl` |
+| `contacts` | `lookupByPhone` · `get` |
 | `scheduling` | `listEventTypes` · `findSlots` · `listBookings` · `createBooking` · `rescheduleBooking` · `cancelBooking` |
 | `ai` | `chat` · `extract` |
 | `otp` | `send` · `verify` |
@@ -596,7 +597,7 @@ import {
 | `ConnectUserButton` | The account row at the foot of the rail — circular avatar, name over email — opening a modal with identity, sessions and the Connect destinations. Profile, Manage subscription and Open Connect each open Connect in a new tab; Sign out acts in place. Renders nothing when signed out. (Was `ConnectUserMenu`.) |
 | `ConnectProfileModal` | The same modal with no trigger, driven by `isOpen`/`onOpenChange` — for an app keeping its own account control. |
 | `ConnectWorkspaceSwitcher` | Sits in the rail's header. Hides itself for an account with one workspace; shows unusable ones disabled, with the reason. |
-| `ConnectAppsGrid` | Google-style launcher — grid icon opening a modal of every app this workspace can open. |
+| `ConnectAppsGrid` | Google-style launcher — grid icon opening a modal in two groups: **Your apps** (a live subscription, opened at the application's own site) and **Explore** (the rest of the catalogue, opened on Connect). Registered icons, filter field past eight tiles. |
 | `ConnectPlans` | Monthly/annual toggle, features, add-ons, live discount, coupon field, and the subscribe / upgrade / downgrade / cancel flow. |
 | `ConnectPlansPage` | A whole `/plans` page — readiness banner, current subscription, and the grid. What `connect-sdk init` scaffolds. |
 | `ConnectSubscribeDialog` | The review step `ConnectPlans` opens — plan, GST, what happens to the current cycle. Exported so you can drive the flow from your own pricing page. |
@@ -898,6 +899,18 @@ So the hand-off is a URL, and Connect renders it as a modal over the relevant pa
 
 Full history: [CHANGELOG.md](./CHANGELOG.md). Latest first:
 
+### 0.20.0
+
+**The app launcher shows the whole catalogue.** `<ConnectAppsGrid>` renders two
+groups — **Your apps** (a live subscription, opened at the application's own
+site) and **Explore** (the rest of the platform's active applications, opened
+on Connect). `GET /apps` answers accordingly, and `WorkspaceApp` gains
+`subscribed` and `category`.
+
+The "Browse all applications" footer link is gone: it pointed at a Connect
+route that has never existed. **If you render your own grid from
+`connect.apps.list()`, filter on `subscribed` to get the previous set back.**
+
 ### 0.12.0 — breaking
 
 The application shell is one column. **The top bar is gone**; the rail holds

package/dist/cjs/client/components/apps-grid.js

@@ -5,44 +5,133 @@ exports.ConnectAppsGrid = ConnectAppsGrid;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("@heroui/react");
 const lucide_react_1 = require("lucide-react");
+const react_2 = require("react");
 const provider_js_1 = require("../provider.js");
 const motion_js_1 = require("./motion.js");
 const shell_context_js_1 = require("./shell-context.js");
-function AppTile({ app }) {
-    const disabled = app.launchUrl === null;
-    const body = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("span", { className: "relative flex size-12 items-center justify-center overflow-hidden rounded-xl bg-surface-secondary", children: [app.iconUrl ? (
-                    // Deliberately a plain `<img>`: this package ships into any React app
-                    // and cannot assume `next/image` or any other framework loader.
-                    // eslint-disable-next-line @next/next/no-img-element
-                    (0, jsx_runtime_1.jsx)("img", { src: app.iconUrl, alt: "", className: "size-full object-cover" })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.LayoutGrid, { className: "size-6 text-muted", "aria-hidden": "true" })), app.needsAttention && ((0, jsx_runtime_1.jsx)("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-warning text-warning-foreground", children: (0, jsx_runtime_1.jsx)(lucide_react_1.AlertCircle, { className: "size-3", "aria-hidden": "true" }) }))] }), (0, jsx_runtime_1.jsx)("span", { className: "line-clamp-2 text-center text-xs font-medium text-foreground", children: app.name }), app.isCurrent && (0, jsx_runtime_1.jsx)("span", { className: "text-[0.625rem] uppercase tracking-wide text-accent", children: "Current" })] }));
-    const shared = "flex flex-col items-center gap-2 rounded-xl p-3 transition-colors focus-visible:outline-2 focus-visible:outline-focus";
+/**
+ * Connect's curated `Application.icon` set, as components.
+ *
+ * A closed map rather than a dynamic lookup on `lucide-react`: the icon name
+ * arrives over the wire, and resolving an arbitrary string against a module's
+ * exports is how a catalog typo becomes a render crash. Anything unrecognised
+ * - including the older, lowercased names some applications were registered
+ * with - falls through to the neutral tile glyph.
+ */
+const APP_ICONS = {
+    Mail: lucide_react_1.Mail,
+    MessageSquare: lucide_react_1.MessageSquare,
+    Database: lucide_react_1.Database,
+    HardDrive: lucide_react_1.HardDrive,
+    BarChart3: lucide_react_1.BarChart3,
+    LineChart: lucide_react_1.LineChart,
+    ShieldCheck: lucide_react_1.ShieldCheck,
+    Lock: lucide_react_1.Lock,
+    CreditCard: lucide_react_1.CreditCard,
+    Receipt: lucide_react_1.Receipt,
+    ListChecks: lucide_react_1.ListChecks,
+    Calendar: lucide_react_1.Calendar,
+    Server: lucide_react_1.Server,
+    Cloud: lucide_react_1.Cloud,
+    Cpu: lucide_react_1.Cpu,
+    Package: lucide_react_1.Package,
+};
+/** Below this many tiles a filter field is one more thing to look past. */
+const SEARCH_THRESHOLD = 8;
+/**
+ * The tile's own glyph: the uploaded brand icon when there is one, the
+ * curated lucide icon when there is not, and the neutral grid mark when the
+ * name is one this version of the SDK does not know.
+ */
+function AppGlyph({ app }) {
+    if (app.iconUrl) {
+        // Deliberately a plain `<img>`: this package ships into any React app
+        // and cannot assume `next/image` or any other framework loader.
+        // eslint-disable-next-line @next/next/no-img-element
+        return (0, jsx_runtime_1.jsx)("img", { src: app.iconUrl, alt: "", className: "size-full object-cover" });
+    }
+    const Icon = APP_ICONS[app.icon] ?? lucide_react_1.LayoutGrid;
+    return (0, jsx_runtime_1.jsx)(Icon, { className: "size-6", "aria-hidden": "true" });
+}
+function AppTile({ app, onOpen }) {
+    // A subscribed app with no registered site is the one genuinely dead tile:
+    // there is nothing to open and nothing to buy.
+    const disabled = app.subscribed && app.launchUrl === null;
+    const shared = "group/tile flex w-full flex-col items-center gap-2 rounded-2xl p-3 text-center outline-offset-2 transition-colors duration-200 focus-visible:outline-2 focus-visible:outline-focus";
+    const body = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("span", { className: "relative flex size-14 items-center justify-center overflow-hidden rounded-[0.8125rem] bg-surface-secondary text-muted transition-colors duration-200 group-hover/tile:bg-default group-hover/tile:text-foreground", children: [(0, jsx_runtime_1.jsx)(AppGlyph, { app: app }), app.needsAttention && ((0, jsx_runtime_1.jsx)("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-warning text-warning-foreground", children: (0, jsx_runtime_1.jsx)(lucide_react_1.AlertCircle, { className: "size-3", "aria-hidden": "true" }) })), !app.subscribed && ((0, jsx_runtime_1.jsx)("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-default text-muted opacity-0 transition-opacity duration-200 group-hover/tile:opacity-100", children: (0, jsx_runtime_1.jsx)(lucide_react_1.Plus, { className: "size-3", "aria-hidden": "true" }) }))] }), (0, jsx_runtime_1.jsx)("span", { className: "line-clamp-2 text-xs font-medium leading-tight text-foreground", children: app.name }), app.isCurrent ? ((0, jsx_runtime_1.jsx)("span", { className: "text-[0.625rem] uppercase tracking-wide text-accent", children: "Current" })) : (!app.subscribed && ((0, jsx_runtime_1.jsxs)("span", { className: "flex items-center gap-0.5 text-[0.625rem] uppercase tracking-wide text-muted opacity-0 transition-opacity duration-200 group-hover/tile:opacity-100", children: ["Subscribe", (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowUpRight, { className: "size-2.5", "aria-hidden": "true" })] })))] }));
     if (disabled) {
         return ((0, jsx_runtime_1.jsx)("div", { className: `${shared} cursor-default opacity-60`, title: `${app.name} has no launch URL configured`, children: body }));
     }
-    return ((0, jsx_runtime_1.jsx)("a", { href: app.launchUrl, target: "_blank", rel: "noopener noreferrer", className: `${shared} hover:bg-surface-secondary`, title: app.description || app.name, children: body }));
+    return (
+    // A `<button>` rather than an `<a>`: where the tile goes depends on
+    // `subscribed` *and* on Connect's own origin, which only the provider
+    // knows, so one handler resolves it rather than every caller rebuilding
+    // the URL. Both destinations still open in a new tab - a launcher must
+    // not throw away the page you launched it from.
+    (0, jsx_runtime_1.jsx)(motion_js_1.m.button, { type: "button", onClick: () => onOpen(app), className: `${shared} hover:bg-surface-secondary`, title: app.description || app.name, whileHover: { y: -2 }, whileTap: { scale: 0.94 }, transition: { type: "spring", stiffness: 420, damping: 28 }, children: body }));
+}
+function AppsSection({ title, hint, apps, offset, onOpen, }) {
+    if (apps.length === 0)
+        return null;
+    return ((0, jsx_runtime_1.jsxs)("section", { className: "space-y-2", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-baseline justify-between gap-2 px-1", children: [(0, jsx_runtime_1.jsx)("h3", { className: "text-[0.6875rem] font-semibold uppercase tracking-[0.06em] text-muted", children: title }), (0, jsx_runtime_1.jsx)("p", { className: "text-[0.6875rem] text-muted", children: hint })] }), (0, jsx_runtime_1.jsx)("div", { className: "grid grid-cols-3 gap-1 sm:grid-cols-4", children: apps.map((app, index) => ((0, jsx_runtime_1.jsx)(motion_js_1.m.div, { initial: { opacity: 0, scale: 0.9, y: 8 }, animate: { opacity: 1, scale: 1, y: 0 }, transition: {
+                        type: "spring",
+                        stiffness: 420,
+                        damping: 30,
+                        // Capped so a large catalog does not make the last tile wait.
+                        delay: Math.min(offset + index, 14) * 0.018,
+                    }, children: (0, jsx_runtime_1.jsx)(AppTile, { app: app, onOpen: onOpen }) }, app.applicationId))) })] }));
+}
+function GridSkeleton() {
+    return ((0, jsx_runtime_1.jsx)("div", { className: "grid grid-cols-3 gap-1 sm:grid-cols-4", "aria-hidden": "true", children: Array.from({ length: 8 }, (_, index) => ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col items-center gap-2 p-3", children: [(0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "size-14 rounded-[0.8125rem]" }), (0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "h-3 w-14" })] }, index))) }));
 }
 /**
- * The Google-style app launcher: a grid icon in your top bar that opens a
- * modal of every Connect application this workspace can actually open.
+ * The Google-style app launcher: a grid icon that opens every Connect
+ * application this workspace has, and every one it could have.
+ *
+ * Two sections, because they are two different actions. **Your apps** is what
+ * the workspace can open right now - the current application pinned first and
+ * marked, so the grid never has a hole where "you are here" should be, and a
+ * paused subscription still listed but badged, because a dunning cycle should
+ * not make a product look deleted. **Explore** is the rest of the active
+ * catalog, minus anything this workspace's type could never subscribe to, and
+ * a tile there opens that application's page on Connect.
  *
- * Only launchable apps appear, so no tile is a dead end - a paused
- * subscription still shows, badged, because a dunning cycle should not make a
- * product look deleted. The current app is pinned first and marked, rather
- * than filtered out, so the grid never has a hole where "you are here" should
- * be.
+ * It used to show subscriptions only, with a "Browse all applications" link
+ * under the grid pointing at a Connect route that does not exist - so a
+ * workspace with one subscription saw one tile and had no working way to find
+ * anything else. Discovery belongs in the grid.
  *
  * Renders nothing when signed out: a launcher with nothing to launch is just a
  * button that opens an empty box.
  */
 function ConnectAppsGrid({ className, label = "Switch app", variant = "row" }) {
-    const { session, isLoading: sessionLoading } = (0, provider_js_1.useConnect)();
+    const { session, isLoading: sessionLoading, appUrl } = (0, provider_js_1.useConnect)();
     const { data, isLoading, error } = (0, provider_js_1.useConnectApps)();
+    const [query, setQuery] = (0, react_2.useState)("");
+    const apps = (0, react_2.useMemo)(() => data?.apps ?? [], [data]);
+    const { mine, explore } = (0, react_2.useMemo)(() => {
+        const needle = query.trim().toLowerCase();
+        const matches = needle
+            ? apps.filter((app) => app.name.toLowerCase().includes(needle) || app.description.toLowerCase().includes(needle))
+            : apps;
+        return {
+            mine: matches.filter((app) => app.subscribed),
+            explore: matches.filter((app) => !app.subscribed),
+        };
+    }, [apps, query]);
     if (sessionLoading || !session?.user)
         return null;
-    const apps = data?.apps ?? [];
-    return ((0, jsx_runtime_1.jsx)(motion_js_1.MotionProvider, { children: (0, jsx_runtime_1.jsxs)(react_1.Modal, { children: [variant === "row" ? ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", "aria-label": label, className: (0, shell_context_js_1.sidebarRowClass)({ className }), children: [(0, jsx_runtime_1.jsx)("span", { className: "flex size-5 shrink-0 items-center justify-center", children: (0, jsx_runtime_1.jsx)(lucide_react_1.LayoutGrid, { className: "size-5" }) }), (0, jsx_runtime_1.jsx)(shell_context_js_1.SidebarLabel, { children: label })] })) : ((0, jsx_runtime_1.jsx)(react_1.Button, { isIconOnly: true, variant: "primary", "aria-label": label, className: className, children: (0, jsx_runtime_1.jsx)(lucide_react_1.LayoutGrid, { className: "size-5" }) })), (0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { className: "sm:max-w-md", 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: "Your apps" }) }), (0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { children: [isLoading && ((0, jsx_runtime_1.jsx)("div", { className: "grid grid-cols-3 gap-2", children: Array.from({ length: 6 }, (_, index) => ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col items-center gap-2 p-3", children: [(0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "size-12 rounded-xl" }), (0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "h-3 w-14" })] }, index))) })), !isLoading && error && ((0, jsx_runtime_1.jsx)("p", { className: "py-6 text-center text-sm text-danger", children: "Could not load your apps." })), !isLoading && !error && apps.length === 0 && ((0, jsx_runtime_1.jsx)("p", { className: "py-6 text-center text-sm text-muted", children: "No other apps yet. Anything this workspace subscribes to shows up here." })), !isLoading && !error && apps.length > 0 && ((0, jsx_runtime_1.jsx)(motion_js_1.m.div, { className: "grid grid-cols-3 gap-2", variants: { show: { transition: { staggerChildren: 0.04 } } }, initial: "hidden", animate: "show", children: apps.map((app) => ((0, jsx_runtime_1.jsx)(motion_js_1.m.div, { variants: { hidden: { opacity: 0, y: 8 }, show: { opacity: 1, y: 0, transition: motion_js_1.ENTER } }, children: (0, jsx_runtime_1.jsx)(AppTile, { app: app }) }, app.applicationId))) }))] }), (0, jsx_runtime_1.jsx)(react_1.Modal.Footer, { children: (0, jsx_runtime_1.jsx)(ConnectBrowseAllLink, {}) })] }) }) })] }) }));
-}
-function ConnectBrowseAllLink() {
-    const { appUrl } = (0, provider_js_1.useConnect)();
-    return ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", className: "w-full", onPress: () => window.open(`${appUrl}/applications`, "_blank", "noopener,noreferrer"), children: ["Browse all applications", (0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "size-3.5 text-muted" })] }));
+    const openApp = (app) => {
+        // Subscribed goes to the partner's own site; everything else goes to that
+        // application's page on Connect, which is where a plan is actually
+        // chosen. The SDK owns this mapping so no integration has to know either
+        // URL shape.
+        const target = app.subscribed && app.launchUrl ? app.launchUrl : `${appUrl}/apps/${app.applicationId}`;
+        window.open(target, "_blank", "noopener,noreferrer");
+    };
+    const showSearch = apps.length > SEARCH_THRESHOLD;
+    const isEmpty = !isLoading && !error && mine.length === 0 && explore.length === 0;
+    return ((0, jsx_runtime_1.jsx)(motion_js_1.MotionProvider, { children: (0, jsx_runtime_1.jsxs)(react_1.Modal, { children: [variant === "row" ? ((0, jsx_runtime_1.jsxs)(react_1.Button, { variant: "tertiary", "aria-label": label, className: (0, shell_context_js_1.sidebarRowClass)({ className }), children: [(0, jsx_runtime_1.jsx)("span", { className: "flex size-5 shrink-0 items-center justify-center", children: (0, jsx_runtime_1.jsx)(lucide_react_1.LayoutGrid, { className: "size-5" }) }), (0, jsx_runtime_1.jsx)(shell_context_js_1.SidebarLabel, { children: label })] })) : ((0, jsx_runtime_1.jsx)(react_1.Button, { isIconOnly: true, variant: "primary", "aria-label": label, className: className, children: (0, jsx_runtime_1.jsx)(lucide_react_1.LayoutGrid, { className: "size-5" }) })), (0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { className: "sm:max-w-lg", 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: "Your apps" }) }), (0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "space-y-4", children: [showSearch && ((0, jsx_runtime_1.jsxs)(react_1.TextField, { className: "relative", variant: "secondary", value: query, onChange: setQuery, children: [(0, jsx_runtime_1.jsx)(react_1.Label, { className: "sr-only", children: "Filter apps" }), (0, jsx_runtime_1.jsx)(react_1.Input, { className: "pr-9", placeholder: "Filter apps" }), (0, jsx_runtime_1.jsx)(lucide_react_1.Search, { className: "pointer-events-none absolute right-3 top-1/2 size-4 -translate-y-1/2 text-muted", "aria-hidden": "true" })] })), isLoading && (0, jsx_runtime_1.jsx)(GridSkeleton, {}), !isLoading && error && ((0, jsx_runtime_1.jsx)("p", { className: "py-6 text-center text-sm text-danger", children: "Could not load your apps." })), isEmpty && ((0, jsx_runtime_1.jsx)("p", { className: "py-6 text-center text-sm text-muted", children: query
+                                                ? `Nothing matches “${query}”.`
+                                                : "No apps yet. Anything this workspace can open shows up here." })), !isLoading && !error && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(AppsSection, { title: "Your apps", hint: "Open", apps: mine, offset: 0, onOpen: openApp }), (0, jsx_runtime_1.jsx)(AppsSection, { title: "Explore", hint: "Subscribe on Connect", apps: explore, offset: mine.length, onOpen: openApp })] }))] })] }) }) })] }) }));
 }

package/dist/cjs/client/components/plan-pricing.js

@@ -18,6 +18,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ACTION_LABEL = void 0;
+exports.isFreePlan = isFreePlan;
 exports.formatPrice = formatPrice;
 exports.monthlyOf = monthlyOf;
 exports.intervalLabel = intervalLabel;
@@ -27,6 +28,21 @@ exports.resolvePlanGroup = resolvePlanGroup;
 exports.groupPlansByTier = groupPlansByTier;
 exports.annualSaving = annualSaving;
 exports.resolveAction = resolveAction;
+/**
+ * Whether a plan costs nothing - the SDK's copy of Connect's `isFreeSelection`
+ * (`packages/data/src/payments/free-plan.ts`), which is what the server
+ * actually decides the free-activation path with.
+ *
+ * A copy rather than an import for the reason `types.ts` gives: the published
+ * package carries none of Connect's internals. The rule is one line and does
+ * not drift, and `conformance.test.ts` pins the shape either side of it.
+ *
+ * @param addonsTotal Paise of the add-ons *selected*, not of the plan's whole
+ * catalog. A free plan with a paid add-on ticked is not free.
+ */
+function isFreePlan(price, addonsTotal = 0) {
+    return price === 0 && addonsTotal === 0;
+}
 /** Paise are the wire unit everywhere in Connect; rupees are the display unit. */
 function formatPrice(paise) {
     return new Intl.NumberFormat("en-IN", {

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

@@ -126,7 +126,7 @@ function ConnectPlans({ planIds, hideCoupon = false, className }) {
                             (tier.monthly?.id === subscription.plan.id || tier.annual?.id === subscription.plan.id);
                         const isCurrent = action === "current";
                         const cadenceUnavailable = showAnnual ? tier.annual === null : tier.monthly === null;
-                        return ((0, jsx_runtime_1.jsx)(motion_js_1.m.div, { variants: { hidden: { opacity: 0, y: 12 }, show: { opacity: 1, y: 0, transition: motion_js_1.ENTER } }, children: (0, jsx_runtime_1.jsxs)(react_1.Card, { className: isCurrentTier ? "h-full border-accent" : "h-full", children: [(0, jsx_runtime_1.jsxs)(react_1.Card.Header, { children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-start justify-between gap-2", children: [(0, jsx_runtime_1.jsx)(react_1.Card.Title, { children: tier.name }), (0, jsx_runtime_1.jsxs)("div", { className: "flex shrink-0 items-center gap-1.5", children: [tier.annualSavingPercent !== null && showAnnual && ((0, jsx_runtime_1.jsxs)(react_1.Chip, { className: "bg-accent-soft text-accent", children: ["Save ", tier.annualSavingPercent, "%"] })), isCurrentTier && (0, jsx_runtime_1.jsx)(react_1.Chip, { className: "bg-accent-soft text-accent", children: "Current" })] })] }), tier.description && (0, jsx_runtime_1.jsx)(react_1.Card.Description, { children: tier.description })] }), (0, jsx_runtime_1.jsxs)(react_1.Card.Content, { className: "flex flex-col gap-4", children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)(motion_js_1.AnimatePresence, { mode: "popLayout", initial: false, children: (0, jsx_runtime_1.jsxs)(motion_js_1.m.div, { initial: { opacity: 0, y: 6 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -6 }, transition: { duration: 0.15 }, children: [(0, jsx_runtime_1.jsx)("span", { className: "text-2xl font-semibold text-foreground", children: (0, plan_pricing_js_1.formatPrice)(plan.price) }), (0, jsx_runtime_1.jsx)("span", { className: "text-sm text-muted", children: (0, plan_pricing_js_1.pricePerLabel)(plan.billingInterval) })] }, plan.billingInterval) }), (0, jsx_runtime_1.jsxs)("p", { className: "mt-1 text-xs text-muted", children: ["+", plan.gstRate, "% GST"] }), cadenceUnavailable && ((0, jsx_runtime_1.jsxs)("p", { className: "mt-1 text-xs text-muted", children: ["Only sold ", (0, plan_pricing_js_1.intervalLabel)(plan.billingInterval).adverb, "."] }))] }), plan.trialDays ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs font-medium text-accent", children: [plan.trialDays, "-day free trial"] })) : null, plan.features.length > 0 && ((0, jsx_runtime_1.jsx)("ul", { className: "flex flex-col gap-1.5", children: plan.features.map((feature) => (
+                        return ((0, jsx_runtime_1.jsx)(motion_js_1.m.div, { variants: { hidden: { opacity: 0, y: 12 }, show: { opacity: 1, y: 0, transition: motion_js_1.ENTER } }, children: (0, jsx_runtime_1.jsxs)(react_1.Card, { className: isCurrentTier ? "h-full border-accent" : "h-full", children: [(0, jsx_runtime_1.jsxs)(react_1.Card.Header, { children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-start justify-between gap-2", children: [(0, jsx_runtime_1.jsx)(react_1.Card.Title, { children: tier.name }), (0, jsx_runtime_1.jsxs)("div", { className: "flex shrink-0 items-center gap-1.5", children: [tier.annualSavingPercent !== null && showAnnual && ((0, jsx_runtime_1.jsxs)(react_1.Chip, { className: "bg-accent-soft text-accent", children: ["Save ", tier.annualSavingPercent, "%"] })), isCurrentTier && (0, jsx_runtime_1.jsx)(react_1.Chip, { className: "bg-accent-soft text-accent", children: "Current" })] })] }), tier.description && (0, jsx_runtime_1.jsx)(react_1.Card.Description, { children: tier.description })] }), (0, jsx_runtime_1.jsxs)(react_1.Card.Content, { className: "flex flex-col gap-4", children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)(motion_js_1.AnimatePresence, { mode: "popLayout", initial: false, children: (0, jsx_runtime_1.jsx)(motion_js_1.m.div, { initial: { opacity: 0, y: 6 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -6 }, transition: { duration: 0.15 }, children: (0, plan_pricing_js_1.isFreePlan)(plan.price) ? ((0, jsx_runtime_1.jsx)("span", { className: "text-2xl font-semibold text-foreground", children: "Free" })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("span", { className: "text-2xl font-semibold text-foreground", children: (0, plan_pricing_js_1.formatPrice)(plan.price) }), (0, jsx_runtime_1.jsx)("span", { className: "text-sm text-muted", children: (0, plan_pricing_js_1.pricePerLabel)(plan.billingInterval) })] })) }, plan.billingInterval) }), !(0, plan_pricing_js_1.isFreePlan)(plan.price) && ((0, jsx_runtime_1.jsxs)("p", { className: "mt-1 text-xs text-muted", children: ["+", plan.gstRate, "% GST"] })), cadenceUnavailable && ((0, jsx_runtime_1.jsxs)("p", { className: "mt-1 text-xs text-muted", children: ["Only sold ", (0, plan_pricing_js_1.intervalLabel)(plan.billingInterval).adverb, "."] }))] }), plan.trialDays && !(0, plan_pricing_js_1.isFreePlan)(plan.price) ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs font-medium text-accent", children: [plan.trialDays, "-day free trial"] })) : null, plan.features.length > 0 && ((0, jsx_runtime_1.jsx)("ul", { className: "flex flex-col gap-1.5", children: plan.features.map((feature) => (
                                                 // `name`, not `key` - the key is an identifier
                                                 // ("campaign-module"), and printing it here is what this
                                                 // card used to do. The description rides along as a

package/dist/cjs/client/components/subscribe-dialog.js

@@ -50,7 +50,8 @@ function ConnectSubscribeDialog({ plan, action, current, coupon, onClose, onConf
     // member and the one most in need of it: the two prices differ by an order
     // of magnitude, and showing only the new one reads as a price rise.
     const isChange = action === "upgrade" || action === "downgrade" || isIntervalSwitch;
-    return ((0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { isOpen: plan !== null, onOpenChange: (open) => !open && onClose(), children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { size: "sm", children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { children: [(0, jsx_runtime_1.jsx)(react_1.Modal.CloseTrigger, { onPress: onClose }), (0, jsx_runtime_1.jsx)(react_1.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Heading, { children: HEADING[action] }) }), plan && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "flex flex-col gap-4", children: [isChange && currentPlan ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-muted", children: currentPlan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(currentPlan.price), "/", (0, plan_pricing_js_1.intervalLabel)(currentPlan.billingInterval).short] })] }), (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowRight, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate font-medium text-foreground", children: plan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(plan.price), "/", (0, plan_pricing_js_1.intervalLabel)(plan.billingInterval).short] })] })] })) : ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-medium text-foreground", children: plan.name }), plan.description && (0, jsx_runtime_1.jsx)("p", { className: "text-xs text-muted", children: plan.description })] })), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1 border-t border-separator pt-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsx)("span", { children: plan.name }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["GST (", plan.gstRate, "%)"] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate) - plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between border-t border-separator pt-1 font-semibold text-foreground", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["Per ", cadenceOf(plan)] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate)) })] }), plan.billingInterval === "annual" && ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Works out to ", (0, plan_pricing_js_1.formatPrice)((0, plan_pricing_js_1.monthlyOf)(withGst(plan.price, plan.gstRate), "annual")), " a month, billed yearly."] }))] }), plan.trialDays ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-accent", children: [plan.trialDays, "-day free trial, if this workspace has not subscribed to this application before."] })) : null, coupon?.trim() ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Coupon ", (0, jsx_runtime_1.jsx)("span", { className: "font-mono text-foreground", children: coupon.trim() }), " is carried over and validated on Connect."] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "flex gap-2 rounded-lg bg-surface p-3 text-xs text-muted", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Info, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1", children: [action === "subscribe" && ((0, jsx_runtime_1.jsx)("p", { children: "Payment is completed on Connect, where your card or UPI mandate is set up and the tax invoice is issued. This page updates by itself once it is done." })), action === "upgrade" && ((0, jsx_runtime_1.jsxs)("p", { children: ["Connect prices the difference for the days left in your current cycle and collects just that amount now. From the next cycle you are billed the ", plan.name, " rate."] })), action === "downgrade" && ((0, jsx_runtime_1.jsx)("p", { children: "You keep what you have paid for. Connect works out the unused part of this cycle and applies it as credit or a refund, depending on how this application is configured." })), isIntervalSwitch && (
+    return ((0, jsx_runtime_1.jsx)(react_1.Modal.Backdrop, { isOpen: plan !== null, onOpenChange: (open) => !open && onClose(), children: (0, jsx_runtime_1.jsx)(react_1.Modal.Container, { size: "sm", children: (0, jsx_runtime_1.jsxs)(react_1.Modal.Dialog, { children: [(0, jsx_runtime_1.jsx)(react_1.Modal.CloseTrigger, { onPress: onClose }), (0, jsx_runtime_1.jsx)(react_1.Modal.Header, { children: (0, jsx_runtime_1.jsx)(react_1.Modal.Heading, { children: HEADING[action] }) }), plan && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_1.Modal.Body, { className: "flex flex-col gap-4", children: [isChange && currentPlan ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate text-muted", children: currentPlan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(currentPlan.price), "/", (0, plan_pricing_js_1.intervalLabel)(currentPlan.billingInterval).short] })] }), (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowRight, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "min-w-0", children: [(0, jsx_runtime_1.jsx)("p", { className: "truncate font-medium text-foreground", children: plan.name }), (0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: [(0, plan_pricing_js_1.formatPrice)(plan.price), "/", (0, plan_pricing_js_1.intervalLabel)(plan.billingInterval).short] })] })] })) : ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-medium text-foreground", children: plan.name }), plan.description && (0, jsx_runtime_1.jsx)("p", { className: "text-xs text-muted", children: plan.description })] })), (0, plan_pricing_js_1.isFreePlan)(plan.price) ? ((0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between border-t border-separator pt-3 text-sm font-semibold text-foreground", children: [(0, jsx_runtime_1.jsx)("span", { children: plan.name }), (0, jsx_runtime_1.jsx)("span", { children: "Free" })] })) : ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1 border-t border-separator pt-3 text-sm", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsx)("span", { children: plan.name }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between text-muted", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["GST (", plan.gstRate, "%)"] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate) - plan.price) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex justify-between border-t border-separator pt-1 font-semibold text-foreground", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["Per ", cadenceOf(plan)] }), (0, jsx_runtime_1.jsx)("span", { children: (0, plan_pricing_js_1.formatPrice)(withGst(plan.price, plan.gstRate)) })] }), plan.billingInterval === "annual" && ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Works out to ", (0, plan_pricing_js_1.formatPrice)((0, plan_pricing_js_1.monthlyOf)(withGst(plan.price, plan.gstRate), "annual")), " a month, billed yearly."] }))] })), plan.trialDays && !(0, plan_pricing_js_1.isFreePlan)(plan.price) ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-accent", children: [plan.trialDays, "-day free trial, if this workspace has not subscribed to this application before."] })) : null, coupon?.trim() ? ((0, jsx_runtime_1.jsxs)("p", { className: "text-xs text-muted", children: ["Coupon ", (0, jsx_runtime_1.jsx)("span", { className: "font-mono text-foreground", children: coupon.trim() }), " is carried over and validated on Connect."] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "flex gap-2 rounded-lg bg-surface p-3 text-xs text-muted", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Info, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": "true" }), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1", children: [action === "subscribe" &&
+                                                        ((0, plan_pricing_js_1.isFreePlan)(plan.price) ? ((0, jsx_runtime_1.jsx)("p", { children: "This plan is free. Connect activates it straight away - there is no payment to make, no card or UPI mandate to set up, and no invoice to expect. This page updates by itself once it is done." })) : ((0, jsx_runtime_1.jsx)("p", { children: "Payment is completed on Connect, where your card or UPI mandate is set up and the tax invoice is issued. This page updates by itself once it is done." }))), action === "upgrade" && ((0, jsx_runtime_1.jsxs)("p", { children: ["Connect prices the difference for the days left in your current cycle and collects just that amount now. From the next cycle you are billed the ", plan.name, " rate."] })), action === "downgrade" && ((0, jsx_runtime_1.jsx)("p", { children: "You keep what you have paid for. Connect works out the unused part of this cycle and applies it as credit or a refund, depending on how this application is configured." })), isIntervalSwitch && (
                                                     // Not a proration. The cycle you are on ends, so this is
                                                     // the one action where the amount collected can exceed a
                                                     // single cycle's list price - or be nothing at all, with

package/dist/cjs/client/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizePath = exports.flattenNav = exports.normalizeNav = exports.useActivePath = exports.ConnectSideNav = exports.ConnectSidebarNav = exports.RAIL_EXPANDED = exports.RAIL_COLLAPSED = exports.sidebarRowClass = exports.useConnectShell = exports.ConnectShellProvider = exports.ConnectSidebarRow = exports.ConnectSidebarFooter = exports.ConnectSidebarBody = exports.ConnectSidebarHeader = exports.ConnectSidebar = exports.AppShell = exports.ConnectAccountSessions = exports.ConnectSignOutButton = exports.ConnectHomeButton = exports.ConnectProfileButton = exports.ConnectInvoicesButton = exports.ConnectManageSubscriptionButton = exports.ConnectUserMenu = exports.ConnectProfileModal = exports.ConnectUserButton = exports.ConnectRegisterButton = exports.ConnectLoginButton = exports.ConnectLogo = exports.ConnectMark = exports.ConnectGrievanceNotice = exports.isConnectError = exports.ConnectError = exports.normalizePlanFeatures = exports.blockingBlockers = exports.CONNECT_APP_URL = exports.useConnectResource = exports.useConnectIntegrations = exports.useConnectSessions = exports.useConnectAddonUsage = exports.useConnectCompanyProfile = exports.useConnectApps = exports.useConnectPlans = exports.useConnectEntitlements = exports.useConnectPlatformAccess = exports.useConnectAudience = exports.useConnectWorkspaceType = exports.useConnectUser = exports.useConnect = exports.ConnectProvider = void 0;
 exports.annualSaving = exports.resolveAction = exports.monthlyOf = exports.formatPrice = exports.buildCheckoutUrl = exports.useConnectCheckout = exports.ConnectFilterTabs = exports.ConnectCursorPagination = exports.ConnectConfirmDialog = exports.ConnectLinkButton = exports.ConnectPlansPage = exports.ConnectUsageMeter = exports.ConnectPlatformGate = exports.ConnectWorkspaceTypeGate = exports.useConnectFeature = exports.ConnectFeatureGate = exports.useConnectAccessGate = exports.ConnectAccessGate = exports.ConnectReadinessGate = exports.ConnectReadinessBanner = exports.resolveSubscriptionState = exports.ConnectSeatUsage = exports.ConnectTrialBanner = exports.ConnectSubscriptionCard = exports.ConnectNoSubscriptionCard = exports.ConnectSubscriptionGate = exports.ConnectSubscribeDialog = exports.ConnectPlans = exports.ConnectIntegrationsModal = exports.AI_TONE_DOT = exports.AI_TONE_CHIP = exports.AI_EMPTY_VALUE = exports.aiStatusTone = exports.isNumericAiFormat = exports.formatAiValue = exports.AiSources = exports.AiSteps = exports.AiDetails = exports.AiTimeline = exports.AiMetrics = exports.AiChart = exports.AiTable = exports.ConnectAskAi = exports.ConnectAppsGrid = exports.isLinkableConnectScreen = exports.matchConnectScreen = exports.filterNavForAudience = exports.gateExemptPaths = exports.isNavItemActive = exports.resolveActivePath = void 0;
-exports.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.ACTION_LABEL = exports.discountLabel = 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 = void 0;
 /**
  * Browser half of `@cosmoops/connect-sdk` - React components and hooks.
  *
@@ -211,6 +211,12 @@ Object.defineProperty(exports, "resolveAction", { enumerable: true, get: functio
 Object.defineProperty(exports, "annualSaving", { enumerable: true, get: function () { return plan_pricing_js_1.annualSaving; } });
 Object.defineProperty(exports, "discountLabel", { enumerable: true, get: function () { return plan_pricing_js_1.discountLabel; } });
 Object.defineProperty(exports, "ACTION_LABEL", { enumerable: true, get: function () { return plan_pricing_js_1.ACTION_LABEL; } });
+// Exported for the same reason `groupPlansByTier` is: a partner writing its
+// own pricing grid has to draw a ₹0 plan as "Free" rather than as a price
+// with a cadence and a GST rate attached, and re-deriving "is this free"
+// from a raw `price === 0` misses the add-on half of the rule Connect
+// actually applies.
+Object.defineProperty(exports, "isFreePlan", { enumerable: true, get: function () { return plan_pricing_js_1.isFreePlan; } });
 // The tier model, exported because a partner writing its own pricing grid
 // needs the same pairing `ConnectPlans` uses. Grouping a flat plan list by
 // hand means matching on `name`, which Connect neither enforces unique nor

package/dist/cjs/server/client.js

@@ -7,6 +7,7 @@ const ai_js_1 = require("./resources/ai.js");
 const data_js_1 = require("./resources/data.js");
 const workspaces_js_1 = require("./resources/workspaces.js");
 const scheduling_js_1 = require("./resources/scheduling.js");
+const contacts_js_1 = require("./resources/contacts.js");
 const kv_js_1 = require("./resources/kv.js");
 const billing_js_1 = require("./resources/billing.js");
 const drive_js_1 = require("./resources/drive.js");
@@ -82,6 +83,8 @@ class ConnectClient {
     drive;
     /** A subscribing workspace's own calendar - what is bookable, free, and booked. */
     scheduling;
+    /** Who a workspace already knows how to reach, by phone or by id. */
+    contacts;
     /** RAG chat and structured extraction. */
     ai;
     /** Your application's own document store - see `DataResource`. */
@@ -131,6 +134,7 @@ class ConnectClient {
         this.billing = new billing_js_1.BillingResource(transport);
         this.drive = new drive_js_1.DriveResource(transport);
         this.scheduling = new scheduling_js_1.SchedulingResource(transport);
+        this.contacts = new contacts_js_1.ContactsResource(transport);
         this.ai = new ai_js_1.AiResource(transport);
         this.data = new data_js_1.DataResource(transport);
         this.kv = new kv_js_1.KvResource(transport);
@@ -146,4 +150,4 @@ class ConnectClient {
 }
 exports.ConnectClient = ConnectClient;
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-exports.SDK_VERSION = "0.18.0";
+exports.SDK_VERSION = "0.20.0";

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

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactsResource = void 0;
+const http_js_1 = require("../http.js");
+const acting_as_js_1 = require("./acting-as.js");
+/**
+ * Who a workspace already knows how to reach.
+ *
+ * **This is the telephony identity, not a CRM record.** A contact is keyed by
+ * `primaryPhone` - the one fact every inbound call carries - and it is written
+ * automatically: a voice agent creates one on the first call from a new number
+ * and fills fields in as it learns them. `source` says which kind you are
+ * holding, and it is worth rendering: `call` means an agent guessed and nobody
+ * has confirmed, `manual` means a person typed it.
+ *
+ * **Reference it, do not copy it.** If your application keeps its own customer
+ * records, store this contact's `id` on yours rather than duplicating the
+ * fields. Two writable copies of a person's name with no single owner drift,
+ * and Connect's is the one an agent keeps updating from calls. The id is also
+ * an exact join to anything else keyed by it - `Booking.contactId`, most
+ * usefully - so "which of my records is this appointment for" becomes a lookup
+ * instead of a phone match.
+ *
+ * Read-only for now. Writing into a store with a per-field provenance chain
+ * means declaring where your facts came from and how they merge with a
+ * human's, and nothing needs that yet.
+ */
+class ContactsResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * "Do we already know this number?" - one point read, cheap enough for a
+     * screen pop on every inbound call.
+     *
+     * Resolves to `null` for a number nobody has called from before. That is the
+     * ordinary case for a first-time caller, not an error, which is why it is a
+     * null rather than a thrown `ConnectError`.
+     */
+    async lookupByPhone(input) {
+        const result = await (0, http_js_1.request)(this.transport, {
+            method: "GET",
+            path: "/contacts",
+            query: { workspaceId: input.workspaceId, phone: input.phone },
+            headers: (0, acting_as_js_1.actingAs)(input.asUser),
+        });
+        return result.contact ?? null;
+    }
+    /**
+     * The record behind an id you already hold.
+     *
+     * Throws `ConnectError` with `code: "not_found"` for an id that does not
+     * exist *or* belongs to another workspace - deliberately the same answer,
+     * since telling those apart would confirm a contact exists somewhere else.
+     */
+    get(contactId, options) {
+        return (0, http_js_1.request)(this.transport, {
+            method: "GET",
+            path: `/contacts/${encodeURIComponent(contactId)}`,
+            query: { workspaceId: options.workspaceId },
+            headers: (0, acting_as_js_1.actingAs)(options.asUser),
+        });
+    }
+}
+exports.ContactsResource = ContactsResource;

package/dist/esm/client/components/apps-grid.js

@@ -1,45 +1,134 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Button, Modal, Skeleton } from "@heroui/react";
-import { AlertCircle, ExternalLink, LayoutGrid } from "lucide-react";
+import { Button, Input, Label, Modal, Skeleton, TextField } from "@heroui/react";
+import { AlertCircle, ArrowUpRight, BarChart3, Calendar, Cloud, Cpu, CreditCard, Database, HardDrive, LayoutGrid, LineChart, ListChecks, Lock, Mail, MessageSquare, Package, Plus, Receipt, Search, Server, ShieldCheck, } from "lucide-react";
+import { useMemo, useState } from "react";
 import { useConnectApps, useConnect } from "../provider.js";
-import { ENTER, m, MotionProvider } from "./motion.js";
+import { m, MotionProvider } from "./motion.js";
 import { SidebarLabel, sidebarRowClass } from "./shell-context.js";
-function AppTile({ app }) {
-    const disabled = app.launchUrl === null;
-    const body = (_jsxs(_Fragment, { children: [_jsxs("span", { className: "relative flex size-12 items-center justify-center overflow-hidden rounded-xl bg-surface-secondary", children: [app.iconUrl ? (
-                    // Deliberately a plain `<img>`: this package ships into any React app
-                    // and cannot assume `next/image` or any other framework loader.
-                    // eslint-disable-next-line @next/next/no-img-element
-                    _jsx("img", { src: app.iconUrl, alt: "", className: "size-full object-cover" })) : (_jsx(LayoutGrid, { className: "size-6 text-muted", "aria-hidden": "true" })), app.needsAttention && (_jsx("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-warning text-warning-foreground", children: _jsx(AlertCircle, { className: "size-3", "aria-hidden": "true" }) }))] }), _jsx("span", { className: "line-clamp-2 text-center text-xs font-medium text-foreground", children: app.name }), app.isCurrent && _jsx("span", { className: "text-[0.625rem] uppercase tracking-wide text-accent", children: "Current" })] }));
-    const shared = "flex flex-col items-center gap-2 rounded-xl p-3 transition-colors focus-visible:outline-2 focus-visible:outline-focus";
+/**
+ * Connect's curated `Application.icon` set, as components.
+ *
+ * A closed map rather than a dynamic lookup on `lucide-react`: the icon name
+ * arrives over the wire, and resolving an arbitrary string against a module's
+ * exports is how a catalog typo becomes a render crash. Anything unrecognised
+ * - including the older, lowercased names some applications were registered
+ * with - falls through to the neutral tile glyph.
+ */
+const APP_ICONS = {
+    Mail,
+    MessageSquare,
+    Database,
+    HardDrive,
+    BarChart3,
+    LineChart,
+    ShieldCheck,
+    Lock,
+    CreditCard,
+    Receipt,
+    ListChecks,
+    Calendar,
+    Server,
+    Cloud,
+    Cpu,
+    Package,
+};
+/** Below this many tiles a filter field is one more thing to look past. */
+const SEARCH_THRESHOLD = 8;
+/**
+ * The tile's own glyph: the uploaded brand icon when there is one, the
+ * curated lucide icon when there is not, and the neutral grid mark when the
+ * name is one this version of the SDK does not know.
+ */
+function AppGlyph({ app }) {
+    if (app.iconUrl) {
+        // Deliberately a plain `<img>`: this package ships into any React app
+        // and cannot assume `next/image` or any other framework loader.
+        // eslint-disable-next-line @next/next/no-img-element
+        return _jsx("img", { src: app.iconUrl, alt: "", className: "size-full object-cover" });
+    }
+    const Icon = APP_ICONS[app.icon] ?? LayoutGrid;
+    return _jsx(Icon, { className: "size-6", "aria-hidden": "true" });
+}
+function AppTile({ app, onOpen }) {
+    // A subscribed app with no registered site is the one genuinely dead tile:
+    // there is nothing to open and nothing to buy.
+    const disabled = app.subscribed && app.launchUrl === null;
+    const shared = "group/tile flex w-full flex-col items-center gap-2 rounded-2xl p-3 text-center outline-offset-2 transition-colors duration-200 focus-visible:outline-2 focus-visible:outline-focus";
+    const body = (_jsxs(_Fragment, { children: [_jsxs("span", { className: "relative flex size-14 items-center justify-center overflow-hidden rounded-[0.8125rem] bg-surface-secondary text-muted transition-colors duration-200 group-hover/tile:bg-default group-hover/tile:text-foreground", children: [_jsx(AppGlyph, { app: app }), app.needsAttention && (_jsx("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-warning text-warning-foreground", children: _jsx(AlertCircle, { className: "size-3", "aria-hidden": "true" }) })), !app.subscribed && (_jsx("span", { className: "absolute -right-0.5 -top-0.5 flex size-4 items-center justify-center rounded-full bg-default text-muted opacity-0 transition-opacity duration-200 group-hover/tile:opacity-100", children: _jsx(Plus, { className: "size-3", "aria-hidden": "true" }) }))] }), _jsx("span", { className: "line-clamp-2 text-xs font-medium leading-tight text-foreground", children: app.name }), app.isCurrent ? (_jsx("span", { className: "text-[0.625rem] uppercase tracking-wide text-accent", children: "Current" })) : (!app.subscribed && (_jsxs("span", { className: "flex items-center gap-0.5 text-[0.625rem] uppercase tracking-wide text-muted opacity-0 transition-opacity duration-200 group-hover/tile:opacity-100", children: ["Subscribe", _jsx(ArrowUpRight, { className: "size-2.5", "aria-hidden": "true" })] })))] }));
     if (disabled) {
         return (_jsx("div", { className: `${shared} cursor-default opacity-60`, title: `${app.name} has no launch URL configured`, children: body }));
     }
-    return (_jsx("a", { href: app.launchUrl, target: "_blank", rel: "noopener noreferrer", className: `${shared} hover:bg-surface-secondary`, title: app.description || app.name, children: body }));
+    return (
+    // A `<button>` rather than an `<a>`: where the tile goes depends on
+    // `subscribed` *and* on Connect's own origin, which only the provider
+    // knows, so one handler resolves it rather than every caller rebuilding
+    // the URL. Both destinations still open in a new tab - a launcher must
+    // not throw away the page you launched it from.
+    _jsx(m.button, { type: "button", onClick: () => onOpen(app), className: `${shared} hover:bg-surface-secondary`, title: app.description || app.name, whileHover: { y: -2 }, whileTap: { scale: 0.94 }, transition: { type: "spring", stiffness: 420, damping: 28 }, children: body }));
+}
+function AppsSection({ title, hint, apps, offset, onOpen, }) {
+    if (apps.length === 0)
+        return null;
+    return (_jsxs("section", { className: "space-y-2", children: [_jsxs("div", { className: "flex items-baseline justify-between gap-2 px-1", children: [_jsx("h3", { className: "text-[0.6875rem] font-semibold uppercase tracking-[0.06em] text-muted", children: title }), _jsx("p", { className: "text-[0.6875rem] text-muted", children: hint })] }), _jsx("div", { className: "grid grid-cols-3 gap-1 sm:grid-cols-4", children: apps.map((app, index) => (_jsx(m.div, { initial: { opacity: 0, scale: 0.9, y: 8 }, animate: { opacity: 1, scale: 1, y: 0 }, transition: {
+                        type: "spring",
+                        stiffness: 420,
+                        damping: 30,
+                        // Capped so a large catalog does not make the last tile wait.
+                        delay: Math.min(offset + index, 14) * 0.018,
+                    }, children: _jsx(AppTile, { app: app, onOpen: onOpen }) }, app.applicationId))) })] }));
+}
+function GridSkeleton() {
+    return (_jsx("div", { className: "grid grid-cols-3 gap-1 sm:grid-cols-4", "aria-hidden": "true", children: Array.from({ length: 8 }, (_, index) => (_jsxs("div", { className: "flex flex-col items-center gap-2 p-3", children: [_jsx(Skeleton, { className: "size-14 rounded-[0.8125rem]" }), _jsx(Skeleton, { className: "h-3 w-14" })] }, index))) }));
 }
 /**
- * The Google-style app launcher: a grid icon in your top bar that opens a
- * modal of every Connect application this workspace can actually open.
+ * The Google-style app launcher: a grid icon that opens every Connect
+ * application this workspace has, and every one it could have.
+ *
+ * Two sections, because they are two different actions. **Your apps** is what
+ * the workspace can open right now - the current application pinned first and
+ * marked, so the grid never has a hole where "you are here" should be, and a
+ * paused subscription still listed but badged, because a dunning cycle should
+ * not make a product look deleted. **Explore** is the rest of the active
+ * catalog, minus anything this workspace's type could never subscribe to, and
+ * a tile there opens that application's page on Connect.
  *
- * Only launchable apps appear, so no tile is a dead end - a paused
- * subscription still shows, badged, because a dunning cycle should not make a
- * product look deleted. The current app is pinned first and marked, rather
- * than filtered out, so the grid never has a hole where "you are here" should
- * be.
+ * It used to show subscriptions only, with a "Browse all applications" link
+ * under the grid pointing at a Connect route that does not exist - so a
+ * workspace with one subscription saw one tile and had no working way to find
+ * anything else. Discovery belongs in the grid.
  *
  * Renders nothing when signed out: a launcher with nothing to launch is just a
  * button that opens an empty box.
  */
 export function ConnectAppsGrid({ className, label = "Switch app", variant = "row" }) {
-    const { session, isLoading: sessionLoading } = useConnect();
+    const { session, isLoading: sessionLoading, appUrl } = useConnect();
     const { data, isLoading, error } = useConnectApps();
+    const [query, setQuery] = useState("");
+    const apps = useMemo(() => data?.apps ?? [], [data]);
+    const { mine, explore } = useMemo(() => {
+        const needle = query.trim().toLowerCase();
+        const matches = needle
+            ? apps.filter((app) => app.name.toLowerCase().includes(needle) || app.description.toLowerCase().includes(needle))
+            : apps;
+        return {
+            mine: matches.filter((app) => app.subscribed),
+            explore: matches.filter((app) => !app.subscribed),
+        };
+    }, [apps, query]);
     if (sessionLoading || !session?.user)
         return null;
-    const apps = data?.apps ?? [];
-    return (_jsx(MotionProvider, { children: _jsxs(Modal, { children: [variant === "row" ? (_jsxs(Button, { variant: "tertiary", "aria-label": label, className: sidebarRowClass({ className }), children: [_jsx("span", { className: "flex size-5 shrink-0 items-center justify-center", children: _jsx(LayoutGrid, { className: "size-5" }) }), _jsx(SidebarLabel, { children: label })] })) : (_jsx(Button, { isIconOnly: true, variant: "primary", "aria-label": label, className: className, children: _jsx(LayoutGrid, { className: "size-5" }) })), _jsx(Modal.Backdrop, { children: _jsx(Modal.Container, { children: _jsxs(Modal.Dialog, { className: "sm:max-w-md", children: [_jsx(Modal.CloseTrigger, {}), _jsx(Modal.Header, { children: _jsx(Modal.Heading, { children: "Your apps" }) }), _jsxs(Modal.Body, { children: [isLoading && (_jsx("div", { className: "grid grid-cols-3 gap-2", children: Array.from({ length: 6 }, (_, index) => (_jsxs("div", { className: "flex flex-col items-center gap-2 p-3", children: [_jsx(Skeleton, { className: "size-12 rounded-xl" }), _jsx(Skeleton, { className: "h-3 w-14" })] }, index))) })), !isLoading && error && (_jsx("p", { className: "py-6 text-center text-sm text-danger", children: "Could not load your apps." })), !isLoading && !error && apps.length === 0 && (_jsx("p", { className: "py-6 text-center text-sm text-muted", children: "No other apps yet. Anything this workspace subscribes to shows up here." })), !isLoading && !error && apps.length > 0 && (_jsx(m.div, { className: "grid grid-cols-3 gap-2", variants: { show: { transition: { staggerChildren: 0.04 } } }, initial: "hidden", animate: "show", children: apps.map((app) => (_jsx(m.div, { variants: { hidden: { opacity: 0, y: 8 }, show: { opacity: 1, y: 0, transition: ENTER } }, children: _jsx(AppTile, { app: app }) }, app.applicationId))) }))] }), _jsx(Modal.Footer, { children: _jsx(ConnectBrowseAllLink, {}) })] }) }) })] }) }));
-}
-function ConnectBrowseAllLink() {
-    const { appUrl } = useConnect();
-    return (_jsxs(Button, { variant: "tertiary", className: "w-full", onPress: () => window.open(`${appUrl}/applications`, "_blank", "noopener,noreferrer"), children: ["Browse all applications", _jsx(ExternalLink, { className: "size-3.5 text-muted" })] }));
+    const openApp = (app) => {
+        // Subscribed goes to the partner's own site; everything else goes to that
+        // application's page on Connect, which is where a plan is actually
+        // chosen. The SDK owns this mapping so no integration has to know either
+        // URL shape.
+        const target = app.subscribed && app.launchUrl ? app.launchUrl : `${appUrl}/apps/${app.applicationId}`;
+        window.open(target, "_blank", "noopener,noreferrer");
+    };
+    const showSearch = apps.length > SEARCH_THRESHOLD;
+    const isEmpty = !isLoading && !error && mine.length === 0 && explore.length === 0;
+    return (_jsx(MotionProvider, { children: _jsxs(Modal, { children: [variant === "row" ? (_jsxs(Button, { variant: "tertiary", "aria-label": label, className: sidebarRowClass({ className }), children: [_jsx("span", { className: "flex size-5 shrink-0 items-center justify-center", children: _jsx(LayoutGrid, { className: "size-5" }) }), _jsx(SidebarLabel, { children: label })] })) : (_jsx(Button, { isIconOnly: true, variant: "primary", "aria-label": label, className: className, children: _jsx(LayoutGrid, { className: "size-5" }) })), _jsx(Modal.Backdrop, { children: _jsx(Modal.Container, { children: _jsxs(Modal.Dialog, { className: "sm:max-w-lg", children: [_jsx(Modal.CloseTrigger, {}), _jsx(Modal.Header, { children: _jsx(Modal.Heading, { children: "Your apps" }) }), _jsxs(Modal.Body, { className: "space-y-4", children: [showSearch && (_jsxs(TextField, { className: "relative", variant: "secondary", value: query, onChange: setQuery, children: [_jsx(Label, { className: "sr-only", children: "Filter apps" }), _jsx(Input, { className: "pr-9", placeholder: "Filter apps" }), _jsx(Search, { className: "pointer-events-none absolute right-3 top-1/2 size-4 -translate-y-1/2 text-muted", "aria-hidden": "true" })] })), isLoading && _jsx(GridSkeleton, {}), !isLoading && error && (_jsx("p", { className: "py-6 text-center text-sm text-danger", children: "Could not load your apps." })), isEmpty && (_jsx("p", { className: "py-6 text-center text-sm text-muted", children: query
+                                                ? `Nothing matches “${query}”.`
+                                                : "No apps yet. Anything this workspace can open shows up here." })), !isLoading && !error && (_jsxs(_Fragment, { children: [_jsx(AppsSection, { title: "Your apps", hint: "Open", apps: mine, offset: 0, onOpen: openApp }), _jsx(AppsSection, { title: "Explore", hint: "Subscribe on Connect", apps: explore, offset: mine.length, onOpen: openApp })] }))] })] }) }) })] }) }));
 }

package/dist/esm/client/components/plan-pricing.js

@@ -15,6 +15,21 @@
  * No React here - it is imported by both a client component and its dialog,
  * and nothing in it needs to be.
  */
+/**
+ * Whether a plan costs nothing - the SDK's copy of Connect's `isFreeSelection`
+ * (`packages/data/src/payments/free-plan.ts`), which is what the server
+ * actually decides the free-activation path with.
+ *
+ * A copy rather than an import for the reason `types.ts` gives: the published
+ * package carries none of Connect's internals. The rule is one line and does
+ * not drift, and `conformance.test.ts` pins the shape either side of it.
+ *
+ * @param addonsTotal Paise of the add-ons *selected*, not of the plan's whole
+ * catalog. A free plan with a paid add-on ticked is not free.
+ */
+export function isFreePlan(price, addonsTotal = 0) {
+    return price === 0 && addonsTotal === 0;
+}
 /** Paise are the wire unit everywhere in Connect; rupees are the display unit. */
 export function formatPrice(paise) {
     return new Intl.NumberFormat("en-IN", {

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

@@ -1,5 +1,5 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Button, Card, Chip, Input, Skeleton, Switch } from "@heroui/react";
 import { Check, CheckCircle2, ExternalLink, Loader2, Sparkles, Tag } from "lucide-react";
 import { useMemo, useState } from "react";
@@ -7,7 +7,7 @@ import { useConnect, useConnectEntitlements, useConnectPlans } from "../provider
 import { buildCancelUrl, buildCheckoutUrl, useConnectCheckout, } from "../use-checkout.js";
 import { AnimatePresence, ENTER, m, MotionProvider } from "./motion.js";
 import { ConnectSubscribeDialog } from "./subscribe-dialog.js";
-import { ACTION_LABEL, discountLabel, formatPrice, groupPlansByTier, intervalLabel, pricePerLabel, resolveAction, } from "./plan-pricing.js";
+import { ACTION_LABEL, discountLabel, formatPrice, groupPlansByTier, intervalLabel, isFreePlan, pricePerLabel, resolveAction, } from "./plan-pricing.js";
 /**
  * The plan table: monthly/annual toggle, features, add-ons, the discount
  * actually in effect, and the subscribe / upgrade / downgrade flows.
@@ -123,7 +123,7 @@ export function ConnectPlans({ planIds, hideCoupon = false, className }) {
                             (tier.monthly?.id === subscription.plan.id || tier.annual?.id === subscription.plan.id);
                         const isCurrent = action === "current";
                         const cadenceUnavailable = showAnnual ? tier.annual === null : tier.monthly === null;
-                        return (_jsx(m.div, { variants: { hidden: { opacity: 0, y: 12 }, show: { opacity: 1, y: 0, transition: ENTER } }, children: _jsxs(Card, { className: isCurrentTier ? "h-full border-accent" : "h-full", children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx(Card.Title, { children: tier.name }), _jsxs("div", { className: "flex shrink-0 items-center gap-1.5", children: [tier.annualSavingPercent !== null && showAnnual && (_jsxs(Chip, { className: "bg-accent-soft text-accent", children: ["Save ", tier.annualSavingPercent, "%"] })), isCurrentTier && _jsx(Chip, { className: "bg-accent-soft text-accent", children: "Current" })] })] }), tier.description && _jsx(Card.Description, { children: tier.description })] }), _jsxs(Card.Content, { className: "flex flex-col gap-4", children: [_jsxs("div", { children: [_jsx(AnimatePresence, { mode: "popLayout", initial: false, children: _jsxs(m.div, { initial: { opacity: 0, y: 6 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -6 }, transition: { duration: 0.15 }, children: [_jsx("span", { className: "text-2xl font-semibold text-foreground", children: formatPrice(plan.price) }), _jsx("span", { className: "text-sm text-muted", children: pricePerLabel(plan.billingInterval) })] }, plan.billingInterval) }), _jsxs("p", { className: "mt-1 text-xs text-muted", children: ["+", plan.gstRate, "% GST"] }), cadenceUnavailable && (_jsxs("p", { className: "mt-1 text-xs text-muted", children: ["Only sold ", intervalLabel(plan.billingInterval).adverb, "."] }))] }), plan.trialDays ? (_jsxs("p", { className: "text-xs font-medium text-accent", children: [plan.trialDays, "-day free trial"] })) : null, plan.features.length > 0 && (_jsx("ul", { className: "flex flex-col gap-1.5", children: plan.features.map((feature) => (
+                        return (_jsx(m.div, { variants: { hidden: { opacity: 0, y: 12 }, show: { opacity: 1, y: 0, transition: ENTER } }, children: _jsxs(Card, { className: isCurrentTier ? "h-full border-accent" : "h-full", children: [_jsxs(Card.Header, { children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx(Card.Title, { children: tier.name }), _jsxs("div", { className: "flex shrink-0 items-center gap-1.5", children: [tier.annualSavingPercent !== null && showAnnual && (_jsxs(Chip, { className: "bg-accent-soft text-accent", children: ["Save ", tier.annualSavingPercent, "%"] })), isCurrentTier && _jsx(Chip, { className: "bg-accent-soft text-accent", children: "Current" })] })] }), tier.description && _jsx(Card.Description, { children: tier.description })] }), _jsxs(Card.Content, { className: "flex flex-col gap-4", children: [_jsxs("div", { children: [_jsx(AnimatePresence, { mode: "popLayout", initial: false, children: _jsx(m.div, { initial: { opacity: 0, y: 6 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -6 }, transition: { duration: 0.15 }, children: isFreePlan(plan.price) ? (_jsx("span", { className: "text-2xl font-semibold text-foreground", children: "Free" })) : (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-2xl font-semibold text-foreground", children: formatPrice(plan.price) }), _jsx("span", { className: "text-sm text-muted", children: pricePerLabel(plan.billingInterval) })] })) }, plan.billingInterval) }), !isFreePlan(plan.price) && (_jsxs("p", { className: "mt-1 text-xs text-muted", children: ["+", plan.gstRate, "% GST"] })), cadenceUnavailable && (_jsxs("p", { className: "mt-1 text-xs text-muted", children: ["Only sold ", intervalLabel(plan.billingInterval).adverb, "."] }))] }), plan.trialDays && !isFreePlan(plan.price) ? (_jsxs("p", { className: "text-xs font-medium text-accent", children: [plan.trialDays, "-day free trial"] })) : null, plan.features.length > 0 && (_jsx("ul", { className: "flex flex-col gap-1.5", children: plan.features.map((feature) => (
                                                 // `name`, not `key` - the key is an identifier
                                                 // ("campaign-module"), and printing it here is what this
                                                 // card used to do. The description rides along as a

package/dist/esm/client/components/subscribe-dialog.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Button, Modal } from "@heroui/react";
 import { ArrowRight, ExternalLink, Info } from "lucide-react";
-import { formatPrice, intervalLabel, monthlyOf } from "./plan-pricing.js";
+import { formatPrice, intervalLabel, isFreePlan, monthlyOf } from "./plan-pricing.js";
 /** GST is quoted exclusive everywhere in Connect; this is the same arithmetic `calculateGST` does server-side. */
 function withGst(price, gstRate) {
     return price + Math.round(price * (gstRate / 100));
@@ -47,7 +47,8 @@ export function ConnectSubscribeDialog({ plan, action, current, coupon, onClose,
     // member and the one most in need of it: the two prices differ by an order
     // of magnitude, and showing only the new one reads as a price rise.
     const isChange = action === "upgrade" || action === "downgrade" || isIntervalSwitch;
-    return (_jsx(Modal.Backdrop, { isOpen: plan !== null, onOpenChange: (open) => !open && onClose(), children: _jsx(Modal.Container, { size: "sm", children: _jsxs(Modal.Dialog, { children: [_jsx(Modal.CloseTrigger, { onPress: onClose }), _jsx(Modal.Header, { children: _jsx(Modal.Heading, { children: HEADING[action] }) }), plan && (_jsxs(_Fragment, { children: [_jsxs(Modal.Body, { className: "flex flex-col gap-4", children: [isChange && currentPlan ? (_jsxs("div", { className: "flex items-center gap-3 text-sm", children: [_jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "truncate text-muted", children: currentPlan.name }), _jsxs("p", { className: "text-xs text-muted", children: [formatPrice(currentPlan.price), "/", intervalLabel(currentPlan.billingInterval).short] })] }), _jsx(ArrowRight, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "truncate font-medium text-foreground", children: plan.name }), _jsxs("p", { className: "text-xs text-muted", children: [formatPrice(plan.price), "/", intervalLabel(plan.billingInterval).short] })] })] })) : (_jsxs("div", { children: [_jsx("p", { className: "font-medium text-foreground", children: plan.name }), plan.description && _jsx("p", { className: "text-xs text-muted", children: plan.description })] })), _jsxs("div", { className: "flex flex-col gap-1 border-t border-separator pt-3 text-sm", children: [_jsxs("div", { className: "flex justify-between text-muted", children: [_jsx("span", { children: plan.name }), _jsx("span", { children: formatPrice(plan.price) })] }), _jsxs("div", { className: "flex justify-between text-muted", children: [_jsxs("span", { children: ["GST (", plan.gstRate, "%)"] }), _jsx("span", { children: formatPrice(withGst(plan.price, plan.gstRate) - plan.price) })] }), _jsxs("div", { className: "flex justify-between border-t border-separator pt-1 font-semibold text-foreground", children: [_jsxs("span", { children: ["Per ", cadenceOf(plan)] }), _jsx("span", { children: formatPrice(withGst(plan.price, plan.gstRate)) })] }), plan.billingInterval === "annual" && (_jsxs("p", { className: "text-xs text-muted", children: ["Works out to ", formatPrice(monthlyOf(withGst(plan.price, plan.gstRate), "annual")), " a month, billed yearly."] }))] }), plan.trialDays ? (_jsxs("p", { className: "text-xs text-accent", children: [plan.trialDays, "-day free trial, if this workspace has not subscribed to this application before."] })) : null, coupon?.trim() ? (_jsxs("p", { className: "text-xs text-muted", children: ["Coupon ", _jsx("span", { className: "font-mono text-foreground", children: coupon.trim() }), " is carried over and validated on Connect."] })) : null, _jsxs("div", { className: "flex gap-2 rounded-lg bg-surface p-3 text-xs text-muted", children: [_jsx(Info, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": "true" }), _jsxs("div", { className: "flex flex-col gap-1", children: [action === "subscribe" && (_jsx("p", { children: "Payment is completed on Connect, where your card or UPI mandate is set up and the tax invoice is issued. This page updates by itself once it is done." })), action === "upgrade" && (_jsxs("p", { children: ["Connect prices the difference for the days left in your current cycle and collects just that amount now. From the next cycle you are billed the ", plan.name, " rate."] })), action === "downgrade" && (_jsx("p", { children: "You keep what you have paid for. Connect works out the unused part of this cycle and applies it as credit or a refund, depending on how this application is configured." })), isIntervalSwitch && (
+    return (_jsx(Modal.Backdrop, { isOpen: plan !== null, onOpenChange: (open) => !open && onClose(), children: _jsx(Modal.Container, { size: "sm", children: _jsxs(Modal.Dialog, { children: [_jsx(Modal.CloseTrigger, { onPress: onClose }), _jsx(Modal.Header, { children: _jsx(Modal.Heading, { children: HEADING[action] }) }), plan && (_jsxs(_Fragment, { children: [_jsxs(Modal.Body, { className: "flex flex-col gap-4", children: [isChange && currentPlan ? (_jsxs("div", { className: "flex items-center gap-3 text-sm", children: [_jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "truncate text-muted", children: currentPlan.name }), _jsxs("p", { className: "text-xs text-muted", children: [formatPrice(currentPlan.price), "/", intervalLabel(currentPlan.billingInterval).short] })] }), _jsx(ArrowRight, { className: "size-4 shrink-0 text-muted", "aria-hidden": "true" }), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "truncate font-medium text-foreground", children: plan.name }), _jsxs("p", { className: "text-xs text-muted", children: [formatPrice(plan.price), "/", intervalLabel(plan.billingInterval).short] })] })] })) : (_jsxs("div", { children: [_jsx("p", { className: "font-medium text-foreground", children: plan.name }), plan.description && _jsx("p", { className: "text-xs text-muted", children: plan.description })] })), isFreePlan(plan.price) ? (_jsxs("div", { className: "flex justify-between border-t border-separator pt-3 text-sm font-semibold text-foreground", children: [_jsx("span", { children: plan.name }), _jsx("span", { children: "Free" })] })) : (_jsxs("div", { className: "flex flex-col gap-1 border-t border-separator pt-3 text-sm", children: [_jsxs("div", { className: "flex justify-between text-muted", children: [_jsx("span", { children: plan.name }), _jsx("span", { children: formatPrice(plan.price) })] }), _jsxs("div", { className: "flex justify-between text-muted", children: [_jsxs("span", { children: ["GST (", plan.gstRate, "%)"] }), _jsx("span", { children: formatPrice(withGst(plan.price, plan.gstRate) - plan.price) })] }), _jsxs("div", { className: "flex justify-between border-t border-separator pt-1 font-semibold text-foreground", children: [_jsxs("span", { children: ["Per ", cadenceOf(plan)] }), _jsx("span", { children: formatPrice(withGst(plan.price, plan.gstRate)) })] }), plan.billingInterval === "annual" && (_jsxs("p", { className: "text-xs text-muted", children: ["Works out to ", formatPrice(monthlyOf(withGst(plan.price, plan.gstRate), "annual")), " a month, billed yearly."] }))] })), plan.trialDays && !isFreePlan(plan.price) ? (_jsxs("p", { className: "text-xs text-accent", children: [plan.trialDays, "-day free trial, if this workspace has not subscribed to this application before."] })) : null, coupon?.trim() ? (_jsxs("p", { className: "text-xs text-muted", children: ["Coupon ", _jsx("span", { className: "font-mono text-foreground", children: coupon.trim() }), " is carried over and validated on Connect."] })) : null, _jsxs("div", { className: "flex gap-2 rounded-lg bg-surface p-3 text-xs text-muted", children: [_jsx(Info, { className: "mt-0.5 size-4 shrink-0", "aria-hidden": "true" }), _jsxs("div", { className: "flex flex-col gap-1", children: [action === "subscribe" &&
+                                                        (isFreePlan(plan.price) ? (_jsx("p", { children: "This plan is free. Connect activates it straight away - there is no payment to make, no card or UPI mandate to set up, and no invoice to expect. This page updates by itself once it is done." })) : (_jsx("p", { children: "Payment is completed on Connect, where your card or UPI mandate is set up and the tax invoice is issued. This page updates by itself once it is done." }))), action === "upgrade" && (_jsxs("p", { children: ["Connect prices the difference for the days left in your current cycle and collects just that amount now. From the next cycle you are billed the ", plan.name, " rate."] })), action === "downgrade" && (_jsx("p", { children: "You keep what you have paid for. Connect works out the unused part of this cycle and applies it as credit or a refund, depending on how this application is configured." })), isIntervalSwitch && (
                                                     // Not a proration. The cycle you are on ends, so this is
                                                     // the one action where the amount collected can exceed a
                                                     // single cycle's list price - or be nothing at all, with

package/dist/esm/client/index.js

@@ -105,6 +105,12 @@ export { ConnectCursorPagination } from "./components/cursor-pagination.js";
 export { ConnectFilterTabs } from "./components/filter-tabs.js";
 export { useConnectCheckout, buildCheckoutUrl } from "./use-checkout.js";
 export { formatPrice, monthlyOf, resolveAction, annualSaving, discountLabel, ACTION_LABEL, 
+// Exported for the same reason `groupPlansByTier` is: a partner writing its
+// own pricing grid has to draw a ₹0 plan as "Free" rather than as a price
+// with a cadence and a GST rate attached, and re-deriving "is this free"
+// from a raw `price === 0` misses the add-on half of the rule Connect
+// actually applies.
+isFreePlan, 
 // The tier model, exported because a partner writing its own pricing grid
 // needs the same pairing `ConnectPlans` uses. Grouping a flat plan list by
 // hand means matching on `name`, which Connect neither enforces unique nor

package/dist/esm/server/client.js

@@ -4,6 +4,7 @@ import { AiResource } from "./resources/ai.js";
 import { DataResource, storePassthrough } from "./resources/data.js";
 import { WorkspacesResource } from "./resources/workspaces.js";
 import { SchedulingResource } from "./resources/scheduling.js";
+import { ContactsResource } from "./resources/contacts.js";
 import { KvResource } from "./resources/kv.js";
 import { BillingResource } from "./resources/billing.js";
 import { DriveResource } from "./resources/drive.js";
@@ -79,6 +80,8 @@ export class ConnectClient {
     drive;
     /** A subscribing workspace's own calendar - what is bookable, free, and booked. */
     scheduling;
+    /** Who a workspace already knows how to reach, by phone or by id. */
+    contacts;
     /** RAG chat and structured extraction. */
     ai;
     /** Your application's own document store - see `DataResource`. */
@@ -128,6 +131,7 @@ export class ConnectClient {
         this.billing = new BillingResource(transport);
         this.drive = new DriveResource(transport);
         this.scheduling = new SchedulingResource(transport);
+        this.contacts = new ContactsResource(transport);
         this.ai = new AiResource(transport);
         this.data = new DataResource(transport);
         this.kv = new KvResource(transport);
@@ -142,4 +146,4 @@ export class ConnectClient {
     }
 }
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-export const SDK_VERSION = "0.18.0";
+export const SDK_VERSION = "0.20.0";

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

@@ -0,0 +1,62 @@
+import { request } from "../http.js";
+import { actingAs } from "./acting-as.js";
+/**
+ * Who a workspace already knows how to reach.
+ *
+ * **This is the telephony identity, not a CRM record.** A contact is keyed by
+ * `primaryPhone` - the one fact every inbound call carries - and it is written
+ * automatically: a voice agent creates one on the first call from a new number
+ * and fills fields in as it learns them. `source` says which kind you are
+ * holding, and it is worth rendering: `call` means an agent guessed and nobody
+ * has confirmed, `manual` means a person typed it.
+ *
+ * **Reference it, do not copy it.** If your application keeps its own customer
+ * records, store this contact's `id` on yours rather than duplicating the
+ * fields. Two writable copies of a person's name with no single owner drift,
+ * and Connect's is the one an agent keeps updating from calls. The id is also
+ * an exact join to anything else keyed by it - `Booking.contactId`, most
+ * usefully - so "which of my records is this appointment for" becomes a lookup
+ * instead of a phone match.
+ *
+ * Read-only for now. Writing into a store with a per-field provenance chain
+ * means declaring where your facts came from and how they merge with a
+ * human's, and nothing needs that yet.
+ */
+export class ContactsResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * "Do we already know this number?" - one point read, cheap enough for a
+     * screen pop on every inbound call.
+     *
+     * Resolves to `null` for a number nobody has called from before. That is the
+     * ordinary case for a first-time caller, not an error, which is why it is a
+     * null rather than a thrown `ConnectError`.
+     */
+    async lookupByPhone(input) {
+        const result = await request(this.transport, {
+            method: "GET",
+            path: "/contacts",
+            query: { workspaceId: input.workspaceId, phone: input.phone },
+            headers: actingAs(input.asUser),
+        });
+        return result.contact ?? null;
+    }
+    /**
+     * The record behind an id you already hold.
+     *
+     * Throws `ConnectError` with `code: "not_found"` for an id that does not
+     * exist *or* belongs to another workspace - deliberately the same answer,
+     * since telling those apart would confirm a contact exists somewhere else.
+     */
+    get(contactId, options) {
+        return request(this.transport, {
+            method: "GET",
+            path: `/contacts/${encodeURIComponent(contactId)}`,
+            query: { workspaceId: options.workspaceId },
+            headers: actingAs(options.asUser),
+        });
+    }
+}

package/dist/types/client/components/apps-grid.d.ts

@@ -14,14 +14,21 @@ export interface ConnectAppsGridProps {
     variant?: "row" | "icon";
 }
 /**
- * The Google-style app launcher: a grid icon in your top bar that opens a
- * modal of every Connect application this workspace can actually open.
+ * The Google-style app launcher: a grid icon that opens every Connect
+ * application this workspace has, and every one it could have.
  *
- * Only launchable apps appear, so no tile is a dead end - a paused
- * subscription still shows, badged, because a dunning cycle should not make a
- * product look deleted. The current app is pinned first and marked, rather
- * than filtered out, so the grid never has a hole where "you are here" should
- * be.
+ * Two sections, because they are two different actions. **Your apps** is what
+ * the workspace can open right now - the current application pinned first and
+ * marked, so the grid never has a hole where "you are here" should be, and a
+ * paused subscription still listed but badged, because a dunning cycle should
+ * not make a product look deleted. **Explore** is the rest of the active
+ * catalog, minus anything this workspace's type could never subscribe to, and
+ * a tile there opens that application's page on Connect.
+ *
+ * It used to show subscriptions only, with a "Browse all applications" link
+ * under the grid pointing at a Connect route that does not exist - so a
+ * workspace with one subscription saw one tile and had no working way to find
+ * anything else. Discovery belongs in the grid.
  *
  * Renders nothing when signed out: a launcher with nothing to launch is just a
  * button that opens an empty box.

package/dist/types/client/components/plan-pricing.d.ts

@@ -16,6 +16,19 @@
  * and nothing in it needs to be.
  */
 import type { AppliedDiscount, Plan, SubscriptionResponse } from "../../types.js";
+/**
+ * Whether a plan costs nothing - the SDK's copy of Connect's `isFreeSelection`
+ * (`packages/data/src/payments/free-plan.ts`), which is what the server
+ * actually decides the free-activation path with.
+ *
+ * A copy rather than an import for the reason `types.ts` gives: the published
+ * package carries none of Connect's internals. The rule is one line and does
+ * not drift, and `conformance.test.ts` pins the shape either side of it.
+ *
+ * @param addonsTotal Paise of the add-ons *selected*, not of the plan's whole
+ * catalog. A free plan with a paid add-on ticked is not free.
+ */
+export declare function isFreePlan(price: number, addonsTotal?: number): boolean;
 /** Paise are the wire unit everywhere in Connect; rupees are the display unit. */
 export declare function formatPrice(paise: number): string;
 /**

package/dist/types/client/index.d.ts

@@ -82,7 +82,7 @@ export { ConnectFilterTabs } from "./components/filter-tabs.js";
 export type { ConnectFilterTabsProps, ConnectFilterTabsOption } from "./components/filter-tabs.js";
 export { useConnectCheckout, buildCheckoutUrl } from "./use-checkout.js";
 export type { ConnectCheckoutStatus, ConnectCheckoutState, ConnectEntitlements, StartCheckoutOptions, CheckoutUrlOptions, } from "./use-checkout.js";
-export { formatPrice, monthlyOf, resolveAction, annualSaving, discountLabel, ACTION_LABEL, groupPlansByTier, resolvePlanGroup, } from "./components/plan-pricing.js";
+export { formatPrice, monthlyOf, resolveAction, annualSaving, discountLabel, ACTION_LABEL, isFreePlan, groupPlansByTier, resolvePlanGroup, } from "./components/plan-pricing.js";
 export type { PlanAction, PlanTier, ComparablePlan } from "./components/plan-pricing.js";
 export { ConnectWorkspaceSwitcher } from "./components/workspace-switcher.js";
 export type { ConnectWorkspaceSwitcherProps } from "./components/workspace-switcher.js";

package/dist/types/server/client.d.ts

@@ -5,6 +5,7 @@ import { AiResource } from "./resources/ai.js";
 import { DataResource } from "./resources/data.js";
 import { WorkspacesResource } from "./resources/workspaces.js";
 import { SchedulingResource } from "./resources/scheduling.js";
+import { ContactsResource } from "./resources/contacts.js";
 import { KvResource } from "./resources/kv.js";
 import { BillingResource } from "./resources/billing.js";
 import { DriveResource } from "./resources/drive.js";
@@ -78,6 +79,8 @@ export declare class ConnectClient {
     readonly drive: DriveResource;
     /** A subscribing workspace's own calendar - what is bookable, free, and booked. */
     readonly scheduling: SchedulingResource;
+    /** Who a workspace already knows how to reach, by phone or by id. */
+    readonly contacts: ContactsResource;
     /** RAG chat and structured extraction. */
     readonly ai: AiResource;
     /** Your application's own document store - see `DataResource`. */
@@ -112,4 +115,4 @@ export declare class ConnectClient {
     constructor(options: ConnectClientOptions);
 }
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-export declare const SDK_VERSION = "0.18.0";
+export declare const SDK_VERSION = "0.20.0";

package/dist/types/server/index.d.ts

@@ -28,6 +28,7 @@ export type { SessionsResource } from "./resources/sessions.js";
 export type { ExecuteIntegrationActionInput, IntegrationsResource } from "./resources/integrations.js";
 export type { PlatformResource } from "./resources/platform.js";
 export type { SchedulingResource, FindSlotsInput, ListBookingsInput, CreateBookingInput, RescheduleBookingInput, } from "./resources/scheduling.js";
+export type { ContactsResource, LookupContactInput } from "./resources/contacts.js";
 /**
  * Webhook verification and a ready-made POST route. Server-only for the
  * obvious reason: the signing secret must never reach a browser bundle.

package/dist/types/server/resources/contacts.d.ts

@@ -0,0 +1,60 @@
+import { type TransportOptions } from "../http.js";
+import type { ConnectContact } from "../../types.js";
+export interface LookupContactInput {
+    workspaceId: string;
+    /**
+     * Any reasonable spelling. `+919000000001`, `919000000001` and
+     * `+91 90000 00001` all resolve to the same contact - the number is
+     * normalized to E.164 before the lookup, because comparing unnormalized is
+     * how a contact that exists reads as absent.
+     */
+    phone: string;
+    /** See `ActingAsOption` on the scheduling resource - same contract. */
+    asUser?: string;
+}
+/**
+ * Who a workspace already knows how to reach.
+ *
+ * **This is the telephony identity, not a CRM record.** A contact is keyed by
+ * `primaryPhone` - the one fact every inbound call carries - and it is written
+ * automatically: a voice agent creates one on the first call from a new number
+ * and fills fields in as it learns them. `source` says which kind you are
+ * holding, and it is worth rendering: `call` means an agent guessed and nobody
+ * has confirmed, `manual` means a person typed it.
+ *
+ * **Reference it, do not copy it.** If your application keeps its own customer
+ * records, store this contact's `id` on yours rather than duplicating the
+ * fields. Two writable copies of a person's name with no single owner drift,
+ * and Connect's is the one an agent keeps updating from calls. The id is also
+ * an exact join to anything else keyed by it - `Booking.contactId`, most
+ * usefully - so "which of my records is this appointment for" becomes a lookup
+ * instead of a phone match.
+ *
+ * Read-only for now. Writing into a store with a per-field provenance chain
+ * means declaring where your facts came from and how they merge with a
+ * human's, and nothing needs that yet.
+ */
+export declare class ContactsResource {
+    private readonly transport;
+    constructor(transport: TransportOptions);
+    /**
+     * "Do we already know this number?" - one point read, cheap enough for a
+     * screen pop on every inbound call.
+     *
+     * Resolves to `null` for a number nobody has called from before. That is the
+     * ordinary case for a first-time caller, not an error, which is why it is a
+     * null rather than a thrown `ConnectError`.
+     */
+    lookupByPhone(input: LookupContactInput): Promise<ConnectContact | null>;
+    /**
+     * The record behind an id you already hold.
+     *
+     * Throws `ConnectError` with `code: "not_found"` for an id that does not
+     * exist *or* belongs to another workspace - deliberately the same answer,
+     * since telling those apart would confirm a contact exists somewhere else.
+     */
+    get(contactId: string, options: {
+        workspaceId: string;
+        asUser?: string;
+    }): Promise<ConnectContact>;
+}

package/dist/types/types.d.ts

@@ -549,13 +549,26 @@ export interface WorkspaceApp {
     iconUrl: string | null;
     /** A `lucide-react` icon name from Connect's curated set. */
     icon: string;
+    /** Catalog classification, if you want to group or filter the grid by it. */
+    category: WorkspaceAppCategory;
     /** Where a tile navigates. `null` when the application registered no site. */
     launchUrl: string | null;
+    /**
+     * Whether this workspace holds a launchable subscription.
+     *
+     * `/apps` answers with the platform's whole active catalog, not only what
+     * the workspace bought, so this is the split a launcher renders as two
+     * groups: the apps you open, and the apps you could. `false` means the tile
+     * belongs in the second - send it to Connect, not to `launchUrl`.
+     */
+    subscribed: boolean;
     /** True for the application whose API key made the call - render it as the active tile. */
     isCurrent: boolean;
-    /** Launchable but not healthy (paused, or cancelling at period end) - badge it, do not hide it. */
+    /** Launchable but not healthy (paused, or cancelling at period end) - badge it, do not hide it. Always `false` when `subscribed` is `false`. */
     needsAttention: boolean;
 }
+/** Connect's closed set of catalog categories - `WorkspaceApp.category`. */
+export type WorkspaceAppCategory = "communication" | "storage" | "analytics" | "security" | "billing" | "productivity" | "sales" | "operations" | "infrastructure" | "other";
 /**
  * The platform's DPDP grievance channel - `companyProfile.grievance`.
  *
@@ -1224,3 +1237,48 @@ export interface ListBookingsPage {
     hasMore: boolean;
     totalCount: number;
 }
+/**
+ * A phone or email on a contact.
+ *
+ * `verified` means a human confirmed it reaches them - only a manual source
+ * may ever set it. Branch on it: an unverified value is one an extraction
+ * heard on a call and nobody has checked since.
+ */
+export interface ContactChannelValue {
+    value: string;
+    label: string | null;
+    verified: boolean;
+}
+/**
+ * How a contact came to exist. `call` means a voice agent created it from an
+ * inbound call; `manual` and `import` are the two a human stands behind.
+ */
+export type ContactSource = "call" | "manual" | "import" | "api" | "extraction";
+/**
+ * Someone a workspace knows how to reach - **the telephony identity**, not a
+ * CRM record. See `ContactsResource` for why the difference decides whether
+ * you reference this or copy it.
+ */
+export interface ConnectContact {
+    id: string;
+    /** E.164, and immutable - the key this contact is identified by. */
+    primaryPhone: string;
+    phones: ContactChannelValue[];
+    emails: ContactChannelValue[];
+    name: {
+        display: string | null;
+        given: string | null;
+        family: string | null;
+    };
+    business: {
+        company: string | null;
+        role: string | null;
+        gstin: string | null;
+        website: string | null;
+        address: string | null;
+    };
+    tags: string[];
+    source: ContactSource;
+    createdAt: string;
+    updatedAt: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmoops/connect-sdk",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Official server-side SDK for the CosmoOps Connect platform API - Login with Connect, entitlements, billing and metering.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "commonjs",