@ezychat/web 0.1.45 → 0.1.47

package/dist-lib/types/admin/AdminLayout.d.ts

@@ -1,6 +1,9 @@
 import { type LucideIcon } from 'lucide-react';
 import { type WebExtension, type WebExtensionAdminSection } from '../extensions';
-/** `labelKey` is a translation key in the `admin` namespace. */
+/**
+ * Every core admin section. `labelKey` is a translation key in the `admin` namespace. WhatsApp and
+ * Inboxes never show together: see `visibleAdminNav`.
+ */
 export declare const ADMIN_NAV: readonly [{
     readonly to: "members";
     readonly labelKey: "nav.members";
@@ -13,6 +16,10 @@ export declare const ADMIN_NAV: readonly [{
     readonly to: "whatsapp";
     readonly labelKey: "nav.whatsapp";
     readonly icon: LucideIcon;
+}, {
+    readonly to: "inboxes";
+    readonly labelKey: "inboxes.title";
+    readonly icon: LucideIcon;
 }, {
     readonly to: "tunnel";
     readonly labelKey: "nav.tunnel";
@@ -26,6 +33,12 @@ export declare const ADMIN_NAV: readonly [{
     readonly labelKey: "nav.audit";
     readonly icon: LucideIcon;
 }];
+export type AdminNavItem = (typeof ADMIN_NAV)[number];
+/**
+ * The sections in the nav: **Inboxes** replaces **WhatsApp** only in an edition that allows more than
+ * one WhatsApp number (Lite allows one, so it keeps WhatsApp).
+ */
+export declare function visibleAdminNav(multiInbox: boolean): AdminNavItem[];
 /** The core section an extension admin route declares for this path (e.g. `members`). */
 export declare function extensionSectionOf(extensions: readonly WebExtension[], pathname: string): WebExtensionAdminSection | undefined;
 /**

package/dist-lib/types/admin/InboxAccess.d.ts

@@ -0,0 +1,9 @@
+import type { Inbox, User } from '@ezychat/shared';
+/**
+ * Members → Inbox access: which inboxes a member may open. Admins always see every inbox; an agent
+ * sees only the chats (and notifications) of the inboxes ticked here. `inboxes` are the active ones.
+ */
+export declare function InboxAccessCell({ user, inboxes }: Readonly<{
+    user: User;
+    inboxes: Inbox[];
+}>): import("react").JSX.Element;

package/dist-lib/types/admin/InboxesPage.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+/** Every linked WhatsApp number (inbox), with who may open it. Admin only; shown when maxInboxes > 1. */
+export declare function InboxesPage(): React.JSX.Element;

package/dist-lib/types/admin/inbox-status.d.ts

@@ -0,0 +1,16 @@
+import type { WaState } from '@ezychat/shared';
+import type { StatusTone } from '../components/app';
+/** What the inbox card says next to its status: scan the QR code, or the phone is offline. */
+export type InboxNotice = 'scan' | 'offline' | 'replaced' | null;
+export interface InboxCardStatus {
+    tone: StatusTone;
+    /** Translation key in the `admin` namespace. */
+    labelKey: string;
+    notice: InboxNotice;
+    /** The phone must scan a QR code (or enter a pairing code) before the inbox works. */
+    needsLink: boolean;
+}
+/** WhatsApp connection state of one inbox → the status its card shows. */
+export declare function inboxCardStatus(state: WaState): InboxCardStatus;
+/** Phone-number digits from WhatsApp (`60112233445`) → `+60112233445`; anything else as it is. */
+export declare function formatInboxNumber(number: string | null): string | null;

package/dist-lib/types/api/ai.d.ts

@@ -12,6 +12,7 @@ export declare function useAiMember(): import("@tanstack/react-query").UseQueryR
         locale: "en" | "ms" | "zh-CN" | null;
         kind?: "human" | "ai" | undefined;
         aiRole?: "sales" | undefined;
+        inboxIds?: number[] | undefined;
     } | null;
     settings: {
         displayName: string;
@@ -146,6 +147,7 @@ export declare function useAiMemberAction(): import("@tanstack/react-query").Use
         locale: "en" | "ms" | "zh-CN" | null;
         kind?: "human" | "ai" | undefined;
         aiRole?: "sales" | undefined;
+        inboxIds?: number[] | undefined;
     } | null;
     settings: {
         displayName: string;

package/dist-lib/types/api/inbox-mutations.d.ts

@@ -0,0 +1,65 @@
+import type { UpdateInboxBody } from '@ezychat/shared';
+import { type WaAction } from './queries';
+export declare function useCreateInbox(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    name: string;
+    tone: "success" | "primary" | "warning" | "info";
+    number: string | null;
+    status: {
+        state: "open" | "qr" | "disconnected" | "connecting" | "logged_out" | "replaced" | "blocked";
+        me: {
+            jid: string;
+            name: string | null;
+            lid?: string | null | undefined;
+        } | null;
+        qr: string | null;
+        lastError: string | null;
+    };
+    removed: boolean;
+    memberIds?: number[] | undefined;
+}, Error, {
+    name: string;
+    memberIds?: number[] | undefined;
+}, unknown>;
+export declare function useUpdateInbox(): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    name: string;
+    tone: "success" | "primary" | "warning" | "info";
+    number: string | null;
+    status: {
+        state: "open" | "qr" | "disconnected" | "connecting" | "logged_out" | "replaced" | "blocked";
+        me: {
+            jid: string;
+            name: string | null;
+            lid?: string | null | undefined;
+        } | null;
+        qr: string | null;
+        lastError: string | null;
+    };
+    removed: boolean;
+    memberIds?: number[] | undefined;
+}, Error, {
+    id: number;
+    body: UpdateInboxBody;
+}, unknown>;
+export declare function useRemoveInbox(): import("@tanstack/react-query").UseMutationResult<unknown, Error, number, unknown>;
+/** Log out, link again or take over the phone of one inbox. */
+export declare function useInboxWaAction(inboxId: number): import("@tanstack/react-query").UseMutationResult<unknown, Error, WaAction, unknown>;
+/** Link one inbox by phone number: the 8-character code to enter in WhatsApp → Linked devices. */
+export declare function useInboxPairingCode(inboxId: number): import("@tanstack/react-query").UseMutationResult<{
+    code: string;
+}, Error, string, unknown>;
+/** Members → Inbox access: the inboxes one agent may open. */
+export declare function useSetUserInboxes(userId: number): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
+}, Error, number[], unknown>;

package/dist-lib/types/api/queries.d.ts

@@ -1,11 +1,13 @@
 import { type InfiniteData, type QueryClient } from '@tanstack/react-query';
-import { type CreateApiTokenBodyInput, type UpdateApiTokenBody, type Chat, type ChatListResponse, type ChatStatus, type Message, type MessageListResponse, type PatchUserBody, type Settings, type User } from '@ezychat/shared';
+import { type CreateApiTokenBodyInput, type UpdateApiTokenBody, type Chat, type ChatListResponse, type ChatStatus, type DirectoryUser, type InboxStatusPayload, type Message, type MessageListResponse, type PatchUserBody, type Settings, type WaStatus } from '@ezychat/shared';
 export interface ChatFilters {
     status?: ChatStatus;
     assigned: 'me' | 'none' | 'any';
     q?: string;
     /** customer tag filter */
     tag?: string;
+    /** One inbox (multi-inbox); unset = every inbox the user may open. */
+    inbox?: number;
 }
 export declare const qk: {
     me: readonly ["me"];
@@ -24,6 +26,7 @@ export declare const qk: {
     users: readonly ["users"];
     directory: readonly ["users", "directory"];
     wa: readonly ["wa"];
+    inboxes: readonly ["inboxes"];
     tunnel: readonly ["tunnel"];
     cloudflareSetup: readonly ["cloudflare-setup"];
     settings: readonly ["settings"];
@@ -65,6 +68,7 @@ export declare function useMe(): import("@tanstack/react-query").UseQueryResult<
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
 } | null, Error>;
 export declare function useSetupStatus(): import("@tanstack/react-query").UseQueryResult<{
     needsSetup: boolean;
@@ -86,6 +90,7 @@ export declare function useLogin(): import("@tanstack/react-query").UseMutationR
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
 } | null, Error, {
     username: string;
     password: string;
@@ -108,6 +113,7 @@ export declare function useSetMyLocale(): import("@tanstack/react-query").UseMut
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
 }, Error, "en" | "ms" | "zh-CN" | null, unknown>;
 export declare function useChangePassword(): import("@tanstack/react-query").UseMutationResult<unknown, Error, {
     currentPassword: string;
@@ -116,6 +122,8 @@ export declare function useChangePassword(): import("@tanstack/react-query").Use
 export declare function useChats(filters: ChatFilters): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<{
     chats: {
         jid: string;
+        inboxId: number;
+        waJid: string;
         type: "dm" | "group";
         name: string;
         avatarUrl: string | null;
@@ -134,6 +142,8 @@ export declare function useChats(filters: ChatFilters): import("@tanstack/react-
 export declare function useChat(jid: string | null | undefined): import("@tanstack/react-query").UseQueryResult<{
     chat: {
         jid: string;
+        inboxId: number;
+        waJid: string;
         type: "dm" | "group";
         name: string;
         avatarUrl: string | null;
@@ -300,6 +310,8 @@ export declare function useRetryMessage(): import("@tanstack/react-query").UseMu
 }, Error, string, unknown>;
 export declare function usePatchChat(jid: string): import("@tanstack/react-query").UseMutationResult<{
     jid: string;
+    inboxId: number;
+    waJid: string;
     type: "dm" | "group";
     name: string;
     avatarUrl: string | null;
@@ -448,9 +460,10 @@ export declare function useUsers(opts?: {
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
 }[], Error>;
 /** Public team-member fields every logged-in user may see (`GET /api/users/directory`). */
-export type DirectoryUser = Pick<User, 'id' | 'displayName' | 'role' | 'disabled' | 'kind' | 'aiRole'>;
+export type { DirectoryUser };
 /**
  * Team directory for every role (agents included). Needs the server route
  * `GET /api/users/directory`; when it is missing (404) or forbidden, resolves to an empty list
@@ -458,7 +471,15 @@ export type DirectoryUser = Pick<User, 'id' | 'displayName' | 'role' | 'disabled
  */
 export declare function useUserDirectory(opts?: {
     enabled?: boolean;
-}): import("@tanstack/react-query").UseQueryResult<DirectoryUser[], Error>;
+}): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    displayName: string;
+    role: "admin" | "agent";
+    disabled: boolean;
+    inboxIds: "all" | number[];
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+}[], Error>;
 export declare function useCreateUser(): import("@tanstack/react-query").UseMutationResult<{
     id: number;
     username: string;
@@ -470,6 +491,7 @@ export declare function useCreateUser(): import("@tanstack/react-query").UseMuta
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
 }, Error, {
     username: string;
     displayName: string;
@@ -487,6 +509,7 @@ export declare function usePatchUser(): import("@tanstack/react-query").UseMutat
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    inboxIds?: number[] | undefined;
 }, Error, {
     id: number;
     patch: PatchUserBody;
@@ -507,6 +530,43 @@ export declare function useWaStatus(opts?: {
     qr: string | null;
     lastError: string | null;
 }, Error>;
+/** The inbox 1 number (the number linked before multi-inbox). */
+export declare const PRIMARY_INBOX_ID = 1;
+/**
+ * The inboxes the signed-in user may open (`GET /api/inboxes`; the server filters them). A server
+ * without the route (404) counts as one inbox, so no inbox UI shows.
+ */
+export declare function useInboxes(opts?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<{
+    inboxes: {
+        id: number;
+        name: string;
+        tone: "success" | "primary" | "warning" | "info";
+        number: string | null;
+        status: {
+            state: "open" | "qr" | "disconnected" | "connecting" | "logged_out" | "replaced" | "blocked";
+            me: {
+                jid: string;
+                name: string | null;
+                lid?: string | null | undefined;
+            } | null;
+            qr: string | null;
+            lastError: string | null;
+        };
+        removed: boolean;
+        memberIds?: number[] | undefined;
+    }[];
+    maxInboxes: number;
+    canAdd: boolean;
+}, Error>;
+/** Applies a socket `inbox:status` to the cached inbox list. */
+export declare function patchInboxStatusInCache(qc: QueryClient, p: InboxStatusPayload): void;
+/**
+ * Connection status of one inbox. Inbox 1 reads `GET /api/wa/status` as before (Lite unchanged);
+ * other inboxes read the inbox list, which `inbox:status` keeps current.
+ */
+export declare function useInboxStatus(inboxId: number | undefined): WaStatus | undefined;
 export type WaAction = 'logout' | 'relink' | 'takeover';
 export declare function useWaAction(): import("@tanstack/react-query").UseMutationResult<unknown, Error, WaAction, unknown>;
 /** Link by phone number: returns the 8-character code to enter in WhatsApp → Linked devices. */

package/dist-lib/types/extensions/types.d.ts

@@ -36,7 +36,7 @@ export interface WebExtensionRoute {
     section?: WebExtensionAdminSection;
 }
 /** Core admin sections an extension admin route may sit under (the `ADMIN_NAV` paths). */
-export declare const WEB_EXTENSION_ADMIN_SECTIONS: readonly ["members", "quick-replies", "whatsapp", "tunnel", "settings", "audit"];
+export declare const WEB_EXTENSION_ADMIN_SECTIONS: readonly ["members", "quick-replies", "whatsapp", "inboxes", "tunnel", "settings", "audit"];
 export type WebExtensionAdminSection = (typeof WEB_EXTENSION_ADMIN_SECTIONS)[number];
 /** A small badge on an admin nav link: a count, or a dot that asks for attention. */
 export interface WebExtensionNavBadge {

package/dist-lib/types/i18n/resources.d.ts

@@ -149,6 +149,8 @@ export declare const enResources: {
             noInstallerFeed: string;
             unverifiedFeed: string;
             releaseNotes: string;
+            whatsNew: string;
+            updatedTo: string;
         };
         share: {
             title: string;
@@ -628,6 +630,7 @@ export declare const enResources: {
         waBanner: {
             settingsShort: string;
             openSettings: string;
+            openInboxes: string;
             connecting: {
                 title: string;
                 body: string;
@@ -652,6 +655,19 @@ export declare const enResources: {
                 title: string;
                 body: string;
             };
+            inbox: {
+                connecting: string;
+                disconnected: string;
+                qr: string;
+                loggedOut: string;
+                replaced: string;
+                blocked: string;
+            };
+        };
+        inboxFilter: {
+            label: string;
+            all: string;
+            option: string;
         };
         phoneLink: {
             label: string;
@@ -994,6 +1010,10 @@ export declare const enResources: {
                 apiTokenAuthFailed: string;
                 mcpEnable: string;
                 mcpDisable: string;
+                inboxCreate: string;
+                inboxUpdate: string;
+                inboxRemove: string;
+                inboxAccessUpdate: string;
             };
             fields: {
                 chat: string;
@@ -1033,6 +1053,9 @@ export declare const enResources: {
                 lanEnabled: string;
                 historyDays: string;
                 expires: string;
+                inbox: string;
+                inboxes: string;
+                members: string;
             };
             reasons: {
                 rateLimited: string;
@@ -1694,6 +1717,59 @@ export declare const enResources: {
                 correction: string;
             };
         };
+        inboxes: {
+            title: string;
+            add: string;
+            emptyTitle: string;
+            emptyBody: string;
+            description: string;
+            edit: string;
+            remove: string;
+            status: string;
+            whoCanOpen: string;
+            admin: string;
+            accessHint: string;
+            typeLinkedPhone: string;
+            numberAfterScan: string;
+            limitReached: string;
+            membersField: string;
+            membersFieldHint: string;
+            membersFieldNoAgents: string;
+            membersFieldNone: string;
+            removeTitle: string;
+            removeConfirm: string;
+            removeBodyPhone: string;
+            removed: string;
+            required: string;
+            saved: string;
+            createdPhone: string;
+            addTitle: string;
+            editTitle: string;
+            dialogDescription: string;
+            save: string;
+            name: string;
+            nameHint: string;
+            scanTitle: string;
+            scanBody: string;
+            scanSteps: string;
+            linkedAs: string;
+            relink: string;
+            offlineTitle: string;
+            offlineBody: string;
+            state: {
+                connected: string;
+                waiting_scan: string;
+                phone_offline: string;
+            };
+            membersAccess: string;
+            membersAccessAll: string;
+            membersAccessNone: string;
+            membersAccessTitle: string;
+            membersAccessDescription: string;
+            membersAccessNoInboxes: string;
+            membersAccessSave: string;
+            membersAccessSaved: string;
+        };
     };
     errors: {
         generic: string;

package/dist-lib/types/inbox/ChatFilters.d.ts

@@ -1,6 +1,9 @@
+import type { Inbox } from '@ezychat/shared';
 import { type ChatFilters as Filters } from '../api/queries';
 export interface ChatFiltersProps {
     value: Filters;
     onChange(next: Filters): void;
+    /** The active inboxes the user may open; the inbox filter shows with two or more. */
+    inboxes?: readonly Inbox[];
 }
-export declare function ChatFilters({ value, onChange }: ChatFiltersProps): import("react").JSX.Element;
+export declare function ChatFilters({ value, onChange, inboxes }: ChatFiltersProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ChatListItem.d.ts

@@ -1,4 +1,4 @@
-import type { Chat } from '@ezychat/shared';
+import type { Chat, Inbox } from '@ezychat/shared';
 export interface ChatListItemProps {
     chat: Chat;
     active: boolean;
@@ -6,8 +6,10 @@ export interface ChatListItemProps {
     assigneeName: string | null;
     /** The current user owns this chat: the chip gets the accent outline. */
     assignedToMe?: boolean;
+    /** The chat's inbox, only while the user sees two or more inboxes. */
+    inbox?: Pick<Inbox, 'name' | 'tone'>;
 }
 export declare function GroupIcon({ className }: {
     className?: string;
 }): import("react").JSX.Element;
-export declare function ChatListItem({ chat, active, assigneeName, assignedToMe, }: ChatListItemProps): import("react").JSX.Element;
+export declare function ChatListItem({ chat, active, assigneeName, assignedToMe, inbox, }: ChatListItemProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ConversationHeader.d.ts

@@ -1,4 +1,4 @@
-import type { Chat } from '@ezychat/shared';
+import type { Chat, Inbox } from '@ezychat/shared';
 import type { Directory } from './useDirectory';
 export interface ConversationHeaderProps {
     chat: Chat;
@@ -20,6 +20,8 @@ export interface ConversationHeaderProps {
     onOpenInfo?(): void;
     /** Group chats: WhatsApp's member count, shown under the name once known. */
     memberCount?: number | null;
+    /** The chat's inbox, only while the user sees two or more inboxes (replies leave from it). */
+    inbox?: Pick<Inbox, 'name' | 'tone'>;
     busy?: boolean;
 }
-export declare function ConversationHeader({ chat, directory, onBack, onAssign, onToggleStatus, notesOpen, notesCount, onToggleNotes, showCustomer, customerOpen, onToggleCustomer, onOpenInfo, memberCount, busy, }: ConversationHeaderProps): import("react").JSX.Element;
+export declare function ConversationHeader({ chat, directory, onBack, onAssign, onToggleStatus, notesOpen, notesCount, onToggleNotes, showCustomer, customerOpen, onToggleCustomer, onOpenInfo, memberCount, inbox, busy, }: ConversationHeaderProps): import("react").JSX.Element;

package/dist-lib/types/inbox/InboxChip.d.ts

@@ -0,0 +1,6 @@
+import type { Inbox } from '@ezychat/shared';
+/** The inbox a chat belongs to, in that inbox's colour (shown only with two or more inboxes). */
+export declare function InboxChip({ inbox, className, }: Readonly<{
+    inbox: Pick<Inbox, 'name' | 'tone'>;
+    className?: string;
+}>): import("react").JSX.Element;

package/dist-lib/types/inbox/WaBanner.d.ts

@@ -4,6 +4,11 @@ type WaStateName = WaStatus['state'];
 export declare function waQueuesMessages(state: WaStateName | undefined): boolean;
 /** States where sending is pointless until an admin acts (composer disabled). */
 export declare function waSendingBlocked(state: WaStateName | undefined): boolean;
-/** Top-of-inbox banner shown whenever the WhatsApp connection isn't open. */
+/**
+ * Top-of-inbox banner shown whenever a WhatsApp connection isn't open. With one inbox (Lite) it is
+ * today's single banner; with two or more visible inboxes there is one per inbox that is not open,
+ * titled with that inbox's name. A user who sees one inbox other than inbox 1 gets that inbox's
+ * banner (named, never inbox 1's state); with several inboxes and none visible there is no banner.
+ */
 export declare function WaBanner(): import("react").JSX.Element | null;
 export {};

package/dist-lib/types/inbox/useDirectory.d.ts

@@ -1,18 +1,35 @@
 import type { User } from '@ezychat/shared';
 import { type DirectoryUser } from '../api/queries';
+/**
+ * A team member as the inbox knows them: the directory row (agents), or the full user (admins read
+ * `GET /api/users`, where `inboxIds` is set for agents only). No `inboxIds` means every inbox only
+ * in a single-inbox install; with several inboxes it means no inbox (fail closed).
+ */
+export type DirectoryEntry = Omit<DirectoryUser, 'inboxIds'> & {
+    inboxIds?: DirectoryUser['inboxIds'];
+};
+/**
+ * The member may open chats of this inbox (admins and the AI member open every inbox). A row without
+ * `inboxIds` opens every inbox only when `multiInbox` is false (one inbox, no inbox UI).
+ */
+export declare function canOpenInbox(u: DirectoryEntry, inboxId: number, multiInbox?: boolean): boolean;
 export interface Directory {
     me: User | null;
     isAdmin: boolean;
-    byId: Map<number, DirectoryUser>;
+    byId: Map<number, DirectoryEntry>;
     /** Users that can be picked as assignee (active only). */
-    assignable: DirectoryUser[];
+    assignable: DirectoryEntry[];
+    /** Active users who may open chats of this inbox: the assign dropdown of such a chat. */
+    assignableFor(inboxId: number): DirectoryEntry[];
     /** Display name for a user id ("You" for the current user when `youLabel`). */
     nameOf(id: number | null | undefined, opts?: {
         youLabel?: boolean;
     }): string | null;
 }
 /** Pure builder (exported for tests). */
-export declare function buildDirectory(me: User | null, isAdmin: boolean, list: readonly DirectoryUser[] | undefined): Directory;
+export declare function buildDirectory(me: User | null, isAdmin: boolean, list: readonly DirectoryEntry[] | undefined, opts?: {
+    multiInbox?: boolean;
+}): Directory;
 /**
  * Team member lookup for the inbox. Admins use the full `GET /api/users`; every other role
  * uses the public `GET /api/users/directory` ({id, displayName, role, disabled}). Ids that are

package/dist-lib/types/inbox/useVisibleInboxes.d.ts

@@ -0,0 +1,12 @@
+import type { Inbox } from '@ezychat/shared';
+export { useInboxStatus } from '../api/queries';
+/**
+ * The active inboxes the signed-in user may open. The server already filters `GET /api/inboxes` by
+ * access, so there is no access logic here; removed inboxes (admins only) are left out.
+ */
+export declare function useVisibleInboxes(): Inbox[];
+/**
+ * The inbox chip of a chat: the chat's inbox while the user sees two or more inboxes, otherwise
+ * undefined (one inbox and Lite show no chip). Removed inboxes still name their read-only chats.
+ */
+export declare function useInboxOfChat(): (inboxId: number) => Inbox | undefined;

package/dist-lib/types/lib/whatsapp-format.d.ts

@@ -0,0 +1,5 @@
+import type React from 'react';
+/** A message body as WhatsApp shows it (React nodes for a `whitespace-pre-wrap` element). */
+export declare function formatWhatsApp(text: string): React.ReactNode[];
+/** The same text without the marks WhatsApp hides, for one-line previews (quotes, chat list). */
+export declare function plainWhatsApp(text: string): string;

package/dist-lib/types/wa/PhoneLink.d.ts

@@ -1,4 +1,9 @@
 /** "ABCD1234" → "ABCD-1234", the way WhatsApp displays pairing codes. */
 export declare function formatPairingCode(code: string): string;
-/** Link WhatsApp with a phone number + 8-character pairing code instead of scanning a QR. */
-export declare function PhoneLink(): import("react").JSX.Element;
+/**
+ * Link WhatsApp with a phone number + 8-character pairing code instead of scanning a QR. Without
+ * `inboxId` it links the first number (`/wa/pairing-code`, as before multi-inbox).
+ */
+export declare function PhoneLink({ inboxId }?: Readonly<{
+    inboxId?: number;
+}>): import("react").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezychat/web",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "type": "module",
   "description": "EzyChat core: the team inbox web app (React) as a library, with createInboxApp and its extension API.",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "build:lib": "node ../../scripts/build-web-lib.mjs"
   },
   "dependencies": {
-    "@ezychat/shared": "0.1.45",
+    "@ezychat/shared": "0.1.47",
     "@fontsource-variable/inter": "^5.3.0",
     "@tanstack/react-query": "^5.104.4",
     "@types/react": "^19.3.0",