@cellarnode/ui 0.169.4 → 0.170.0

package/dist/chat-ably/chat-room-reauth.d.ts

@@ -0,0 +1,98 @@
+import * as React from "react";
+import type * as Ably from "ably";
+import type { ConnectionBannerState } from "../chat/connection-banner.js";
+/**
+ * True when `error` is an `Ably.ErrorInfo`-shaped rejection in the
+ * token-capability class. Duck-typed on purpose: `@ably/chat` rewraps the
+ * underlying `ErrorInfo` (`failed to attach room: …`) preserving
+ * `code` / `statusCode`, and test doubles only need to carry those fields.
+ */
+export declare function isRoomCapabilityDeniedError(error: unknown): boolean;
+/**
+ * Room-level access status for CEL-1919 degradation surfaces.
+ *
+ * - `"available"` — the room is live (attached, or in a normal pre-attach
+ *   state). This is the status for the overwhelming majority of rooms.
+ * - `"recovering"` — a capability-denied attach was observed and the lib is
+ *   mid `authorize()` + re-attach cycle. Map to your "reconnecting" banner.
+ * - `"denied"` — the retry budget for this failure signal is exhausted; the
+ *   live subscription is not coming back on this token. Map to your
+ *   read-only/offline surface: disable the composer (REST history + REST
+ *   sends still work) and show the connection notice.
+ */
+export type ChatRoomAccessStatus = "available" | "recovering" | "denied";
+/** Value returned by {@link useChatRoomAccess}. */
+export interface ChatRoomAccess {
+    /** Coarse room-level access status; see {@link ChatRoomAccessStatus}. */
+    status: ChatRoomAccessStatus;
+    /**
+     * The `Ably.ErrorInfo`-shaped error behind a `"recovering"` / `"denied"`
+     * status, when the SDK surfaced one. Useful for diagnostics surfaces.
+     */
+    error?: Ably.ErrorInfo;
+    /**
+     * Manually re-run the `authorize()` + re-attach cycle, bypassing the
+     * once-per-failure automatic budget (the human clicking is the rate
+     * limiter; the backend mint limiter is 10/min per user, CEL-1916).
+     * No-op while a recovery is already in flight.
+     */
+    retry: () => void;
+}
+/**
+ * Map the room-level access status onto the lib's existing 3-state
+ * `ConnectionBannerState` contract, mirroring
+ * `ablyConnectionStatusToBannerState()`'s role for connection states. Feed
+ * the result to the same `<ConnectionBanner>` consumers already mount:
+ *
+ * ```tsx
+ * const access = useChatRoomAccess();
+ * const bannerState = chatRoomAccessToBannerState(access.status);
+ * return <ConnectionBanner state={bannerState} onRetry={access.retry} />;
+ * ```
+ */
+export declare function chatRoomAccessToBannerState(status: ChatRoomAccessStatus): ConnectionBannerState;
+/**
+ * Default English copy for the degraded notice `<ChatRoom>` renders when a
+ * room is capability-denied. Truthful about what still works on a capped
+ * room (REST history + REST sends; only the live subscription is dead).
+ * Exposed for consumer test fixtures / i18n alignment, matching the
+ * `CONNECTION_BANNER_DEFAULT_LABELS` convention.
+ */
+export declare const CHAT_ROOM_DEGRADED_NOTICE = "Live updates are unavailable for this conversation. Messages still send, but new replies appear after reloading.";
+/**
+ * Read the room-level access status injected by the nearest `<ChatRoom>`.
+ *
+ * Outside `<ChatRoom>` (or before the room resolves) this returns
+ * `{ status: "available" }` — descendant hooks tolerate missing providers
+ * with safe defaults, matching the Phase 5 pre-mount tolerance pattern.
+ *
+ * Consumer wiring for CEL-1919 (composer lock + localised banner):
+ *
+ * ```tsx
+ * const access = useChatRoomAccess();
+ * const canSend = access.status !== "denied" && roomIsActive;
+ * // …disable / replace the composer when !canSend, and render your own
+ * // <ConnectionBanner state={chatRoomAccessToBannerState(access.status)}
+ * // onRetry={access.retry} /> with localised copy.
+ * ```
+ */
+export declare function useChatRoomAccess(): ChatRoomAccess;
+export interface ChatRoomReauthProps {
+    /** Bare V2 `chat_rooms.id` UUID, as passed to `<ChatRoom roomId>`. */
+    roomId: string;
+    /**
+     * When `true`, render NO default degraded notice — for consumers that
+     * surface capability-denied rooms through their own (localised)
+     * `<ConnectionBanner>` via `useChatRoomAccess()`. Default `false`.
+     */
+    hideDegradedNotice?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * CEL-1919 public wrapper: mounts the recovery controller keyed on `roomId`
+ * (each room pivot resets the retry budget) inside the caller's
+ * `<ChatRoomProvider>` tree. Rendered by `<ChatRoom>` itself; exported only
+ * so `<ChatRoom>`'s own file stays focused on provider wiring.
+ */
+export declare function ChatRoomReauth({ roomId, hideDegradedNotice, children, }: ChatRoomReauthProps): React.ReactElement;
+//# sourceMappingURL=chat-room-reauth.d.ts.map

package/dist/chat-ably/chat-room-reauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-room-reauth.d.ts","sourceRoot":"","sources":["../../src/chat-ably/chat-room-reauth.tsx"],"names":[],"mappings":"AAwEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,KAAK,IAAI,MAAM,MAAM,CAAC;AAGlC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAsB1E;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBnE;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEzE,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,MAAM,EAAE,oBAAoB,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;IACvB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,qBAAqB,CAS/F;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,qHAC8E,CAAC;AAWrH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AA+ND,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,kBAA0B,EAC1B,QAAQ,GACT,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAM1C"}

package/dist/chat-ably/chat-room-reauth.js

@@ -0,0 +1,356 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// CEL-1919 — per-room re-auth for orgs beyond the 50-room token capability cap.
+//
+// Backend context (cellarnode-backend-v2, `features/ably/service.ts`): org-user
+// tokens carry explicit `chat:{chatRoomId}::$chat` capabilities for only the
+// `ABLY_CHAT_ROOM_CAPABILITY_CAP` (50) most-recent ACTIVE chat rooms, ordered
+// by `last_message_at DESC`. Older-but-active rooms are silently cut from the
+// JWT (WARN-only server-side), so attaching to one fails with an Ably
+// token-capability error (40160 / 40161 class, HTTP 401). The backend's own
+// comment names this module's behaviour as the documented mitigation.
+//
+// What this module adds inside `<ChatRoom>`:
+//
+//   1. DETECT — watch the SDK room status; a `failed` room whose error is in
+//      the token-capability class (not a network drop, not a disposed client)
+//      is a capability-denied attach.
+//   2. RETRY ONCE — call `realtime.auth.authorize()` (the same escape hatch
+//      `useAblyAuthorize()` wraps in `@cellarnode/ui/realtime`) to mint a
+//      fresh token, then re-attach the room with it. Bounded to ONE automatic
+//      attempt per failure signal: a second capability denial after the retry
+//      means the fresh token still omits the room, and hammering the mint
+//      endpoint would only trip the per-user rate limiter (CEL-1916, 10/min).
+//   3. DEGRADE — once denied, surface a visible (dismissible) notice through
+//      the existing `<ConnectionBanner>` machinery and expose
+//      `useChatRoomAccess()` so consumers can disable their composer /
+//      localise the copy. REST history (`historyFetch`) and REST sends
+//      (`sendMessageRest`) keep working on a capped room — only the live
+//      channel subscription is dead — so the room degrades to
+//      "stored history, delayed replies", never a broken shell.
+//
+// ── Why the current retry usually fails, and the backend follow-up ──────────
+//
+// `POST /ably-token` today takes an EMPTY body (`AblyTokenRequest = t.Void()`)
+// and always mints the same org-wide map (top-50 recency window). An
+// `authorize()` therefore returns a token with the SAME capability set unless
+// the room's recency moved it into the window between mints. The retry still
+// lands for those genuine recency races (new message lands on the older room,
+// user re-opens it seconds later) and costs one mint; for a truly capped room
+// it fails again and we degrade. The COMPLETE fix needs the mint endpoint to
+// accept a room hint so a re-auth can return a token scoped for the attempted
+// room. Precisely (backend change, NOT in this PR):
+//
+//   - Accept an optional body/query param on `POST /ably-token`, e.g.
+//     `{ roomId?: string }` (TypeBox: extend `AblyTokenRequest` from
+//     `t.Void()` to `t.Optional(t.Object({ roomId: t.String({ format: "uuid" }) }))`
+//     — Elysia must keep tolerating an absent body).
+//   - In `resolveCapabilities`'s org-user branch, when `roomId` is present and
+//     the org participates in that room (same producer/importer-org SQL guard
+//     as `chatCapabilitiesForOrgUser`), UNION the per-room capability
+//     `chat:{roomId}::$chat` into the minted map on top of the top-50 window.
+//   - Once shipped, this client can pass the hint: `authorize()` accepts
+//     `TokenParams` (`realtime.auth.authorize({ capability })` is too coarse —
+//     the clean wire shape is the authCallback reading a room hint, i.e. the
+//     `<AblyProvider>` `authCallback` gaining an optional `tokenParams.roomId`
+//     passthrough). Until then the client-side retry + graceful degrade below
+//     is the mitigation.
+//
+// ── Module placement ─────────────────────────────────────────────────────────
+//
+// The controller mounts INSIDE `<ChatRoomProvider>` (it needs `useRoom()`) and
+// reads the `Ably.Realtime` from `ably/react`'s context defensively — the same
+// CEL-260 pattern as `realtime/use-connection-state.ts` — rather than calling
+// `useAbly()`, which throws outside `<AblyProvider>`. `<ChatRoom>`'s
+// documented mount contract already requires both providers, but the
+// defensive read keeps unit harnesses (and mis-wired consumers) degrading to
+// "no auto-retry" instead of crashing the tree. That covers a missing
+// provider VALUE; the context object itself is ALSO resolved defensively
+// (see `ablyReactContext` below) so harnesses that stub `ably/react` at the
+// module boundary without exporting `AblyContext` — e.g. the messenger-screen
+// composite tests — render through an inert controller instead of throwing
+// mid-render. It also avoids a runtime
+// dependency from the `chat-ably` subpath onto the `realtime` subpath.
+import * as React from "react";
+import * as AblyReact from "ably/react";
+import { useRoom } from "@ably/chat/react";
+import { ConnectionBanner } from "../chat/connection-banner.js";
+// ────────────────────────────────────────────────────────────────────────────
+// Capability-denied classification.
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Ably error codes that mean "your token does not grant this channel":
+ *
+ * - `40160` — ability denied to participate in channel (capability check
+ *   failed on ATTACH). This is what a room beyond the top-50 recency window
+ *   fails with.
+ * - `40161` — ability denied to participate in channel (capability in token
+ *   invalid / unparsable). Same remedy: a fresh, well-formed token.
+ *
+ * Deliberately NOT included: `40142` (token expired) — the SDK renews expired
+ * tokens itself and retries, long before this room-level recovery runs; and
+ * the 40300-range request-size / connection caps, which have nothing to do
+ * with per-room capabilities.
+ */
+const ROOM_CAPABILITY_DENIED_CODES = new Set([40160, 40161]);
+/**
+ * True when `error` is an `Ably.ErrorInfo`-shaped rejection in the
+ * token-capability class. Duck-typed on purpose: `@ably/chat` rewraps the
+ * underlying `ErrorInfo` (`failed to attach room: …`) preserving
+ * `code` / `statusCode`, and test doubles only need to carry those fields.
+ */
+export function isRoomCapabilityDeniedError(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    const { code, statusCode, message } = error;
+    if (typeof code === "number" && ROOM_CAPABILITY_DENIED_CODES.has(code)) {
+        return true;
+    }
+    // Defensive net: some transport layers rewrap the ErrorInfo and lose the
+    // numeric code while keeping Ably's HTTP 401 + the capability wording.
+    // Kept narrow ("expired" must NOT match) so token-expiry stays out.
+    return (statusCode === 401 &&
+        typeof message === "string" &&
+        /capabilit|denied|permission/i.test(message));
+}
+/**
+ * Map the room-level access status onto the lib's existing 3-state
+ * `ConnectionBannerState` contract, mirroring
+ * `ablyConnectionStatusToBannerState()`'s role for connection states. Feed
+ * the result to the same `<ConnectionBanner>` consumers already mount:
+ *
+ * ```tsx
+ * const access = useChatRoomAccess();
+ * const bannerState = chatRoomAccessToBannerState(access.status);
+ * return <ConnectionBanner state={bannerState} onRetry={access.retry} />;
+ * ```
+ */
+export function chatRoomAccessToBannerState(status) {
+    switch (status) {
+        case "denied":
+            return "offline";
+        case "recovering":
+            return "reconnecting";
+        case "available":
+            return "connected";
+    }
+}
+/**
+ * Default English copy for the degraded notice `<ChatRoom>` renders when a
+ * room is capability-denied. Truthful about what still works on a capped
+ * room (REST history + REST sends; only the live subscription is dead).
+ * Exposed for consumer test fixtures / i18n alignment, matching the
+ * `CONNECTION_BANNER_DEFAULT_LABELS` convention.
+ */
+export const CHAT_ROOM_DEGRADED_NOTICE = "Live updates are unavailable for this conversation. Messages still send, but new replies appear after reloading.";
+// ────────────────────────────────────────────────────────────────────────────
+// Internal context.
+// ────────────────────────────────────────────────────────────────────────────
+const ChatRoomAccessContext = React.createContext({
+    status: "available",
+    retry: () => { },
+});
+/**
+ * Read the room-level access status injected by the nearest `<ChatRoom>`.
+ *
+ * Outside `<ChatRoom>` (or before the room resolves) this returns
+ * `{ status: "available" }` — descendant hooks tolerate missing providers
+ * with safe defaults, matching the Phase 5 pre-mount tolerance pattern.
+ *
+ * Consumer wiring for CEL-1919 (composer lock + localised banner):
+ *
+ * ```tsx
+ * const access = useChatRoomAccess();
+ * const canSend = access.status !== "denied" && roomIsActive;
+ * // …disable / replace the composer when !canSend, and render your own
+ * // <ConnectionBanner state={chatRoomAccessToBannerState(access.status)}
+ * // onRetry={access.retry} /> with localised copy.
+ * ```
+ */
+export function useChatRoomAccess() {
+    return React.use(ChatRoomAccessContext);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Controller component.
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Resolve `ably/react`'s `AblyContext` ONCE at module scope, defensively.
+ *
+ * Two distinct "no authorize surface" conditions must not crash the tree:
+ *
+ * 1. No `<AblyProvider>` mounted — the real `AblyContext`'s VALUE is `{}`,
+ *    handled by `realtimeFromContext` below (same CEL-260 pattern as
+ *    `realtime/ably-react-context.ts`).
+ * 2. The ambient `ably/react` module surface doesn't EXPOSE a context
+ *    object at all. Unit harnesses that stub `ably/react` at the module
+ *    boundary (the messenger-screen composite tests define only `useAbly`)
+ *    throw on the missing-export access — under Vitest that throw happens
+ *    on the import-binding read itself, i.e. mid-render, taking the whole
+ *    messenger tree down. Resolve through a namespace access inside
+ *    try/catch so this degrades to "context unavailable" instead.
+ *
+ * In production `ably/react` always exports `AblyContext`, so the try/catch
+ * is unreachable and the resolved value is the real context.
+ */
+const ablyReactContext = (() => {
+    try {
+        const ctx = AblyReact.AblyContext;
+        return ctx !== null && typeof ctx === "object" ? ctx : null;
+    }
+    catch {
+        return null;
+    }
+})();
+/**
+ * Inert stand-in read when `ably/react` exposes no usable context, so the
+ * `use()` call in the controller stays unconditional (rules of hooks). Its
+ * value is always `null`, which `realtimeFromContext` maps to "no recovery
+ * surface" — recovery disabled, children unaffected.
+ */
+const NoAblySurfaceContext = React.createContext(null);
+/**
+ * Read the `Ably.Realtime` from `ably/react`'s context WITHOUT `useAbly()`,
+ * which throws when no `<AblyProvider>` is mounted. Same CEL-260 defensive
+ * pattern as `realtime/ably-react-context.ts`, inlined here so the `chat-ably`
+ * subpath carries no runtime dependency on the `realtime` subpath.
+ */
+function realtimeFromContext(ctx) {
+    if (!ctx || typeof ctx !== "object")
+        return null;
+    const slot = ctx["default"];
+    if (!slot || typeof slot !== "object")
+        return null;
+    const client = slot.client;
+    if (!client || typeof client !== "object")
+        return null;
+    return client;
+}
+/**
+ * Mounts inside `<ChatRoomProvider>`. Owns the CEL-1919 recovery cycle:
+ * detect capability-denied attach → one `authorize()` + re-attach → degrade.
+ *
+ * The status surfaced through {@link useChatRoomAccess} is DERIVED (failure
+ * signal + retry outcome), not mirrored SDK state:
+ *
+ *   room failed + capability-denied + not yet re-denied → `"recovering"`
+ *   room failed + capability-denied + retry exhausted    → `"denied"`
+ *   anything else                                        → `"available"`
+ *
+ * Because "recovering" is derived from the failure itself, no setState has
+ * to happen synchronously inside the detection effect (the repo's
+ * `set-state-in-effect` discipline); the only committed state is the retry
+ * outcome, written from async continuations after `await` boundaries.
+ */
+function ChatRoomReauthController({ roomId, hideDegradedNotice, children, }) {
+    const { roomStatus, roomError, attach } = useRoom();
+    // CEL-260 defensive read — see ablyReactContext above. When no
+    // `<AblyProvider>` is mounted the context VALUE is `{}` (the exact
+    // condition that crashes `useAbly()`); when the ambient `ably/react`
+    // surface is partial (module-boundary test doubles) `ablyReactContext`
+    // itself is null and we read the inert stand-in instead. Either way the
+    // helper yields null and recovery stays disabled rather than crashing the
+    // messenger tree.
+    const realtime = realtimeFromContext(React.use(ablyReactContext ?? NoAblySurfaceContext));
+    // Retry outcome for the CURRENT failure signal. "pending" = no exhausted
+    // retry yet (the automatic budget is unspent / recovery never needed).
+    // Reset by remount (roomId key), never written synchronously in an effect.
+    const [outcome, setOutcome] = React.useState("pending");
+    // Re-entry guard: true while an authorize+attach cycle is in flight.
+    // Lives in a ref because it only needs to be read by effect continuations
+    // and event handlers, never by render.
+    const inFlightRef = React.useRef(false);
+    const capabilityDenied = roomStatus === "failed" && isRoomCapabilityDeniedError(roomError);
+    const accessStatus = capabilityDenied
+        ? outcome === "denied"
+            ? "denied"
+            : "recovering"
+        : "available";
+    /**
+     * One authorize + re-attach cycle. Resolves true only when the room
+     * ended up attached. Never throws: every failure path resolves false so
+     * both the automatic effect and the manual `retry()` share it safely.
+     */
+    const runRecovery = React.useCallback(async () => {
+        if (!realtime)
+            return false;
+        try {
+            // The same escape hatch `useAblyAuthorize()` wraps: force the SDK to
+            // re-call its authCallback (→ POST /ably-token) and upgrade the
+            // connection to the fresh token before we re-attach.
+            await realtime.auth.authorize();
+        }
+        catch (err) {
+            console.warn(`[ChatRoom] per-room re-authorize failed (CEL-1919, roomId=${roomId})`, err);
+            return false;
+        }
+        try {
+            // `attach()` no-ops when already attached and rejects when the retry
+            // is denied again — exactly the signal we branch on.
+            await attach();
+            return true;
+        }
+        catch (err) {
+            console.warn(`[ChatRoom] room re-attach still denied after re-authorize (CEL-1919, roomId=${roomId})`, err);
+            return false;
+        }
+    }, [realtime, attach, roomId]);
+    // Automatic retry — fires at most once per failure signal:
+    //   - `inFlightRef` blocks re-entry while a cycle runs;
+    //   - `outcome === "denied"` blocks a second automatic attempt after the
+    //     retry failed (a second identical mint would only trip CEL-1916's
+    //     limiter);
+    //   - a room pivot remounts the controller (keyed on roomId), which
+    //     resets both, giving each room its own budget;
+    //   - a LATER capability failure after a SUCCESSFUL retry (only possible
+    //     under a newer token generation — attaching proves the active token
+    //     included the room) sees `outcome` still "pending" and gets its own
+    //     attempt. That is the "max one retry per roomId per token
+    //     generation" contract, implemented against observable signals only.
+    React.useEffect(() => {
+        if (!capabilityDenied || outcome !== "pending" || inFlightRef.current) {
+            return;
+        }
+        inFlightRef.current = true;
+        void (async () => {
+            const attached = await runRecovery();
+            inFlightRef.current = false;
+            if (!attached) {
+                // Written from an async continuation (post-`await`), not
+                // synchronously in the effect body — keeps the repo's
+                // set-state-in-effect discipline intact.
+                setOutcome("denied");
+            }
+            // On success the SDK flips roomStatus to "attached"; the derived
+            // access status follows on the next render. No state to write.
+        })();
+    }, [capabilityDenied, outcome, runRecovery]);
+    /** Manual retry (banner Retry button / consumer surfaces). */
+    const retry = React.useCallback(() => {
+        if (inFlightRef.current)
+            return;
+        inFlightRef.current = true;
+        void (async () => {
+            const attached = await runRecovery();
+            inFlightRef.current = false;
+            // Reset the outcome so a successful retry clears "denied" (the SDK
+            // status change drives the derived status), and a failed retry
+            // re-marks it.
+            setOutcome(attached ? "pending" : "denied");
+        })();
+    }, [runRecovery]);
+    const access = React.useMemo(() => ({
+        status: accessStatus,
+        error: capabilityDenied ? roomError : undefined,
+        retry,
+    }), [accessStatus, capabilityDenied, roomError, retry]);
+    return (_jsxs(ChatRoomAccessContext, { value: access, children: [!hideDegradedNotice && accessStatus !== "available" ? (_jsx(ConnectionBanner, { state: chatRoomAccessToBannerState(accessStatus), onRetry: accessStatus === "denied" ? retry : undefined, offlineMessage: CHAT_ROOM_DEGRADED_NOTICE })) : null, children] }));
+}
+/**
+ * CEL-1919 public wrapper: mounts the recovery controller keyed on `roomId`
+ * (each room pivot resets the retry budget) inside the caller's
+ * `<ChatRoomProvider>` tree. Rendered by `<ChatRoom>` itself; exported only
+ * so `<ChatRoom>`'s own file stays focused on provider wiring.
+ */
+export function ChatRoomReauth({ roomId, hideDegradedNotice = false, children, }) {
+    return (_jsx(ChatRoomReauthController, { roomId: roomId, hideDegradedNotice: hideDegradedNotice, children: children }, roomId));
+}
+//# sourceMappingURL=chat-room-reauth.js.map

package/dist/chat-ably/chat-room-reauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-room-reauth.js","sourceRoot":"","sources":["../../src/chat-ably/chat-room-reauth.tsx"],"names":[],"mappings":"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"}

package/dist/chat-ably/chat-room.d.ts

@@ -57,6 +57,16 @@ export interface ChatRoomProps {
      * `<ChatMessageList>` virtualization story.
      */
     historyPageSize?: number;
+    /**
+     * CEL-1919 — suppress the default degraded notice `<ChatRoom>` renders
+     * when the room is capability-denied (org beyond the backend's 50-room
+     * token cap). Pass `true` when the consumer surfaces denial through its
+     * own localised `<ConnectionBanner>` driven by `useChatRoomAccess()` +
+     * `chatRoomAccessToBannerState()`. The detect → authorize → re-attach →
+     * degrade cycle itself always runs; this prop only hides the default
+     * (English) notice. Default `false`.
+     */
+    hideDegradedNotice?: boolean;
 }
 /**
  * `<ChatRoom>` mounts the SDK's `<ChatRoomProvider>` for a given room.
@@ -67,7 +77,7 @@ export interface ChatRoomProps {
  *
  * @see Spec §4.2, Arch §2.5
  */
-export declare function ChatRoom({ roomId, currentUser, children, sendMessageRest, historyFetch, historyPageSize, }: ChatRoomProps): React.ReactElement;
+export declare function ChatRoom({ roomId, currentUser, children, sendMessageRest, historyFetch, historyPageSize, hideDegradedNotice, }: ChatRoomProps): React.ReactElement;
 /**
  * Reads the current user injected by the nearest `<ChatRoom>` ancestor.
  * Returns `undefined` when called outside `<ChatRoom>` — descendant

package/dist/chat-ably/chat-room.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-room.d.ts","sourceRoot":"","sources":["../../src/chat-ably/chat-room.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,EAAE;QACX;;;WAGG;QACH,EAAE,EAAE,MAAM,CAAC;QACX,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,2BAA2B;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,WAAW,EACX,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAyEpC;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,SAAS,CAE1E"}
+{"version":3,"file":"chat-room.d.ts","sourceRoot":"","sources":["../../src/chat-ably/chat-room.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAO7B,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,EAAE;QACX;;;WAGG;QACH,EAAE,EAAE,MAAM,CAAC;QACX,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,2BAA2B;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,WAAW,EACX,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CA+EpC;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,SAAS,CAE1E"}

package/dist/chat-ably/chat-room.js

@@ -37,6 +37,7 @@ import * as React from "react";
 import { ChatRoomProvider } from "@ably/chat/react";
 import { MessageReactionType } from "@ably/chat";
 import { ChatRestCallbacksProvider, } from "./use-chat-messages.js";
+import { ChatRoomReauth } from "./chat-room-reauth.js";
 // ────────────────────────────────────────────────────────────────────────────
 // Component implementation.
 // ────────────────────────────────────────────────────────────────────────────
@@ -49,7 +50,7 @@ import { ChatRestCallbacksProvider, } from "./use-chat-messages.js";
  *
  * @see Spec §4.2, Arch §2.5
  */
-export function ChatRoom({ roomId, currentUser, children, sendMessageRest, historyFetch, historyPageSize, }) {
+export function ChatRoom({ roomId, currentUser, children, sendMessageRest, historyFetch, historyPageSize, hideDegradedNotice, }) {
     // RoomOptions MUST be memoized — a fresh reference on every render
     // causes the SDK to release+recreate the Room. Empty deps array keeps
     // the reference stable across the lifetime of the wrapper. If a future
@@ -101,7 +102,7 @@ export function ChatRoom({ roomId, currentUser, children, sendMessageRest, histo
     // `chat:chat:{roomId}::$chat` attach, which Ably correctly rejects because
     // the JWT only grants `chat:{roomId}::$chat`.
     const sdkRoomName = roomId.startsWith("chat:") ? roomId : `chat:${roomId}`;
-    return (_jsx(ChatRoomProvider, { name: sdkRoomName, options: roomOptions, children: _jsx(ChatRestCallbacksProvider, { value: restCallbacks, children: _jsx(ChatRoomUserContext, { value: userContextValue, children: children }) }) }));
+    return (_jsx(ChatRoomProvider, { name: sdkRoomName, options: roomOptions, children: _jsx(ChatRoomReauth, { roomId: roomId, hideDegradedNotice: hideDegradedNotice ?? false, children: _jsx(ChatRestCallbacksProvider, { value: restCallbacks, children: _jsx(ChatRoomUserContext, { value: userContextValue, children: children }) }) }) }));
 }
 // ────────────────────────────────────────────────────────────────────────────
 // Internal context — exposes `currentUser` to descendant hooks.

package/dist/chat-ably/chat-room.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-room.js","sourceRoot":"","sources":["../../src/chat-ably/chat-room.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-room.js","sourceRoot":"","sources":["../../src/chat-ably/chat-room.tsx"],"names":[],"mappings":"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"}

package/dist/chat-ably/index.d.ts

@@ -1,5 +1,7 @@
 export { ChatRoom, useChatRoomUser } from "./chat-room.js";
 export type { ChatRoomProps } from "./chat-room.js";
+export { isRoomCapabilityDeniedError, useChatRoomAccess, chatRoomAccessToBannerState, CHAT_ROOM_DEGRADED_NOTICE, } from "./chat-room-reauth.js";
+export type { ChatRoomAccess, ChatRoomAccessStatus } from "./chat-room-reauth.js";
 export { ManagedChatClientProvider } from "./managed-chat-client.js";
 export type { ManagedChatClientProviderProps } from "./managed-chat-client.js";
 export { useChatMessages } from "./use-chat-messages.js";

package/dist/chat-ably/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-ably/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAMpF,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhG,OAAO,EACL,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-ably/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAMpF,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhG,OAAO,EACL,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/chat-ably/index.js

@@ -9,6 +9,11 @@
 // (`createChatWs`, `useChat`) is `@deprecated` in
 // `@cellarnode/ui/chat` and will be removed in a future major.
 export { ChatRoom, useChatRoomUser } from "./chat-room.js";
+// CEL-1919 — per-room re-auth + graceful degradation for orgs beyond the
+// backend's 50-room token capability cap. The recovery cycle itself is
+// internal to <ChatRoom>; consumers read the outcome via useChatRoomAccess()
+// and can map it straight onto their existing <ConnectionBanner>.
+export { isRoomCapabilityDeniedError, useChatRoomAccess, chatRoomAccessToBannerState, CHAT_ROOM_DEGRADED_NOTICE, } from "./chat-room-reauth.js";
 // CEL-978 — StrictMode-safe managed `ChatClient` provider. Replaces the
 // hand-rolled `useMemo(new ChatClient) + dispose()` wiring both dashboards
 // duplicated, which disposed the client on a StrictMode remount and left the

package/dist/chat-ably/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat-ably/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,yEAAyE;AACzE,gEAAgE;AAChE,mEAAmE;AACnE,+DAA+D;AAC/D,0DAA0D;AAC1D,wDAAwD;AACxD,kDAAkD;AAClD,+DAA+D;AAE/D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGxD,wEAAwE;AACxE,2EAA2E;AAC3E,6EAA6E;AAC7E,iEAAiE;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAWtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,oEAAoE;AACpE,qEAAqE;AACrE,uEAAuE;AACvE,oBAAoB;AACpB,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhG,OAAO,EACL,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat-ably/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,yEAAyE;AACzE,gEAAgE;AAChE,mEAAmE;AACnE,+DAA+D;AAC/D,0DAA0D;AAC1D,wDAAwD;AACxD,kDAAkD;AAClD,+DAA+D;AAE/D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGxD,yEAAyE;AACzE,uEAAuE;AACvE,6EAA6E;AAC7E,kEAAkE;AAClE,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,wEAAwE;AACxE,2EAA2E;AAC3E,6EAA6E;AAC7E,iEAAiE;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAWtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,oEAAoE;AACpE,qEAAqE;AACrE,uEAAuE;AACvE,oBAAoB;AACpB,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhG,OAAO,EACL,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cellarnode/ui",
-  "version": "0.169.4",
+  "version": "0.170.0",
   "type": "module",
   "private": false,
   "packageManager": "pnpm@10.28.2+sha512.41872f037ad22f7348e3b1debbaf7e867cfd448f2726d9cf74c08f19507c31d2c8e7a11525b983febc2df640b5438dee6023ebb1f84ed43cc2d654d2bc326264",