@ethora/chat-component 26.10.1 → 26.10.4

package/dist/main.js

@@ -1,4 +1,4 @@
-import { br as a, bs as r, bt as b, bu as o, bv as t, bw as u, bx as i, by as p, bz as h, bA as n, bB as d, i as l, bC as y, S as I, bD as T, bE as f, bF as m, bG as R, bH as g, bI as c, bJ as C, bK as A, bL as E, aq as F, ar as M, bM as Q, bN as k } from "./main-CUB_w8AZ.js";
+import { br as a, bs as r, bt as b, bu as o, bv as t, bw as u, bx as i, by as p, bz as h, bA as n, bB as d, i as l, bC as y, S as I, bD as T, bE as f, bF as m, bG as R, bH as g, bI as c, bJ as C, bK as A, bL as E, aq as F, ar as M, bM as Q, bN as k } from "./main-DbepSYi_.js";
 export {
   a as AuthTestIds,
   r as Chat,

package/dist/networking/api-requests/auth.api.d.ts

@@ -5,10 +5,16 @@ export declare function loginEmail(email: string, password: string): Promise<imp
     refreshToken: string;
     token: string;
     fileToken?: string;
-}, any, {}>>;
-export declare function loginSocial(idToken: string, accessToken: string, loginType: string, authToken?: string): Promise<import('axios').AxiosResponse<any, any, {}>>;
-export declare function registerSocial(idToken: string, accessToken: string, authToken: string, loginType: string, signUpPlan?: string): Promise<import('axios').AxiosResponse<any, any, {}>>;
-export declare function checkEmailExist(email: string): Promise<import('axios').AxiosResponse<any, any, {}>>;
+}, any, {}, any>>;
+export declare function loginSocial(idToken: string, accessToken: string, loginType: string, authToken?: string): Promise<import('axios').AxiosResponse<any, any, {}, any>>;
+export declare function registerSocial(idToken: string, accessToken: string, authToken: string, loginType: string, signUpPlan?: string): Promise<import('axios').AxiosResponse<any, {
+    idToken: string;
+    accessToken: string;
+    loginType: string;
+    authToken: string;
+    signupPlan: string;
+}, {}, any>>;
+export declare function checkEmailExist(email: string): Promise<import('axios').AxiosResponse<any, any, {}, any>>;
 export declare function loginViaJwt(clientToken: string): Promise<User>;
 export declare const signInWithGoogle: () => Promise<{
     user?: undefined;
@@ -30,5 +36,5 @@ export interface UploadFileOptions {
     /** Upload progress for this request, 0 to 100. */
     onProgress?: (percent: number) => void;
 }
-export declare function uploadFile(formData: FormData, activeRoomJID: string, options?: UploadFileOptions): Promise<import('axios').AxiosResponse<any, any, {}>>;
+export declare function uploadFile(formData: FormData, activeRoomJID: string, options?: UploadFileOptions): Promise<import('axios').AxiosResponse<any, FormData, {}, any>>;
 export declare function ensureUserFromMy(user: User | null | undefined): Promise<User | null>;

package/dist/networking/api-requests/rooms.api.d.ts

@@ -14,6 +14,27 @@ export declare function unmuteRoom(chatName: string): Promise<{
     chatName: string;
     muted: boolean;
 } | undefined>;
+export declare function leaveRoom(chatName: string): Promise<{
+    chatName: string;
+    left: boolean;
+} | undefined>;
+export declare function blockUser(peer: string): Promise<{
+    user: string;
+    blocked: boolean;
+} | undefined>;
+export declare function unblockUser(peer: string): Promise<{
+    user: string;
+    blocked: boolean;
+} | undefined>;
+export interface BlockedUser {
+    _id: string;
+    firstName?: string;
+    lastName?: string;
+    profileImage?: string;
+    xmppUsername?: string;
+    createdAt?: string;
+}
+export declare function getBlockedUsers(): Promise<BlockedUser[]>;
 export declare function postRoom(data: PostRoom): Promise<any>;
 export declare function postPrivateRoom(username: string, e2ee?: boolean): Promise<ApiRoom>;
 export declare function postReportRoom(data: PostReportRoom): Promise<any>;

package/dist/networking/api-requests/user.api.d.ts

@@ -4,10 +4,10 @@ interface GetMyUserOptions {
     endpoint?: string;
     signal?: AbortSignal;
 }
-export declare function getDocuments(walletAddress: string): Promise<import('axios').AxiosResponse<any, any, {}>>;
-export declare function getExportMyData(): Promise<import('axios').AxiosResponse<any, any, {}>>;
-export declare function deleteMe(): Promise<import('axios').AxiosResponse<any, any, {}>>;
-export declare function updateMe(data: any): Promise<import('axios').AxiosResponse<any, any, {}>>;
+export declare function getDocuments(walletAddress: string): Promise<import('axios').AxiosResponse<any, any, {}, any>>;
+export declare function getExportMyData(): Promise<import('axios').AxiosResponse<any, any, {}, any>>;
+export declare function deleteMe(): Promise<import('axios').AxiosResponse<any, any, {}, any>>;
+export declare function updateMe(data: any): Promise<import('axios').AxiosResponse<any, any, {}, any>>;
 export declare function updateProfile(fd: FormData): Promise<{
     user: User;
 }>;

package/dist/networking/deliveryReceiptBatcher.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Coalesces XEP-0184 delivery receipts per room.
+ *
+ * Per room, the first message enqueued while no window is open is acked at
+ * once (leading edge). Everything that arrives during the following
+ * `coalesceMs` window is held, keeping only the newest message by timestamp,
+ * and that one is acked when the window closes (trailing edge). A receipt
+ * for a message implies delivery of everything before it, so one stanza can
+ * stand for a whole burst or a whole history replay.
+ */
+export interface DeliveryReceiptBatcherOptions {
+    /** Sends one `<received/>` for `messageId` in `roomJid`. */
+    send: (roomJid: string, messageId: string) => void;
+    /** Injectable timer for tests. */
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    /** Injectable timer cancel for tests. */
+    clearTimer?: (handle: unknown) => void;
+    /** Injectable clock, used when `enqueue` gets no timestamp. */
+    now?: () => number;
+    /** Bound on remembered acked ids (oldest forgotten first). */
+    maxAckedIds?: number;
+}
+export declare class DeliveryReceiptBatcher {
+    private readonly options;
+    private readonly rooms;
+    private readonly acked;
+    private readonly maxAckedIds;
+    private readonly setTimer;
+    private readonly clearTimer;
+    private readonly now;
+    constructor(options: DeliveryReceiptBatcherOptions);
+    /**
+     * Queues a receipt for `messageId`. `coalesceMs` is the window length used
+     * when a window opens; 0 sends every call straight away.
+     */
+    enqueue(roomJid: string, messageId: string, coalesceMs: number, timestamp?: number): void;
+    /** Cancels the window and drops the held message for one room. */
+    clearRoom(roomJid: string): void;
+    /**
+     * Cancels every window and drops every held message (disconnect). Acked
+     * ids are kept so a reconnect replay does not ack them twice.
+     */
+    clear(): void;
+    /** Full teardown: timers, held messages and the acked-id memory. */
+    destroy(): void;
+    /** Test/inspection helper: number of rooms with an open window. */
+    openWindowCount(): number;
+    private stateFor;
+    private ack;
+    private onWindowEnd;
+    private cancel;
+    private remember;
+}

package/dist/networking/displayedMarkerThrottle.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Rate-limits XEP-0333 `<displayed/>` markers for one room. The first mark
+ * goes out at once; marks inside `minIntervalMs` of the last send are held
+ * and only the newest id is sent when the interval ends (trailing edge), so
+ * the final read watermark is never lost. `dispose()` sends a held mark
+ * immediately, then cancels the timer.
+ */
+export interface DisplayedMarkerThrottleOptions {
+    minIntervalMs: number;
+    send: (messageId: string) => void;
+    now?: () => number;
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (handle: unknown) => void;
+}
+export declare class DisplayedMarkerThrottle {
+    private readonly options;
+    private lastSentAt;
+    private pendingId;
+    private timer;
+    private disposed;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    constructor(options: DisplayedMarkerThrottleOptions);
+    mark(messageId: string): void;
+    dispose(): void;
+    private onTimer;
+    private fire;
+}

package/dist/networking/receiptsPolicy.d.ts

@@ -0,0 +1,32 @@
+import { ReceiptsConfig } from '../types/models/config.model';
+import { IMessage, IRoom } from '../types/types';
+export declare const RECEIPTS_DEFAULTS: {
+    mode: "auto";
+    deliveryMaxRoomSize: number;
+    readMaxRoomSize: number;
+    maxAgeDays: number;
+    coalesceMs: number;
+};
+export interface ResolvedReceiptsConfig {
+    mode: 'auto' | 'all' | 'off';
+    deliveryMaxRoomSize: number;
+    readMaxRoomSize: number;
+    maxAgeDays: number;
+    coalesceMs: number;
+}
+/** Fills every unset or invalid option with its default. */
+export declare const resolveReceiptsConfig: (cfg?: ReceiptsConfig | null) => ResolvedReceiptsConfig;
+/**
+ * Other members of the room (the sender excluded). The larger of the true
+ * `usersCnt` and the loaded `members` list wins. 0 when the size is unknown.
+ */
+export declare const roomOtherMembers: (room?: Pick<IRoom, "usersCnt" | "members"> | null) => number;
+/** Timestamp of a message in ms (date, timestamp, then id), 0 when unreadable. */
+export declare const messageTimestamp: (message: Pick<IMessage, "id" | "date" | "timestamp">) => number;
+/**
+ * Whether this client should send a XEP-0184 `<received/>` for `message`.
+ * The caller has already excluded our own messages and MAM/echo duplicates.
+ */
+export declare const shouldSendDelivery: (room: Pick<IRoom, "type" | "usersCnt" | "members"> | null | undefined, message: Pick<IMessage, "id" | "date" | "timestamp" | "isSystemMessage">, cfg: ResolvedReceiptsConfig, now: number) => boolean;
+/** Whether this client should send a XEP-0333 `<displayed/>` for the room. */
+export declare const shouldSendRead: (room: Pick<IRoom, "type" | "usersCnt" | "members"> | null | undefined, cfg: ResolvedReceiptsConfig) => boolean;

package/dist/networking/xmppClient.d.ts

@@ -64,8 +64,7 @@ export declare class XmppClient implements XmppClientInterface {
     private historyQueueWorkerScheduled;
     private historyQueueWorkerTimer;
     private roomHistoryEpoch;
-    private historyReceiptAckedIds;
-    private readonly maxHistoryReceiptAckedIds;
+    private readonly deliveryBatcher;
     private criticalSendUntil;
     private activeRoomBoostUntil;
     private sendStartedAtById;
@@ -317,7 +316,8 @@ export declare class XmppClient implements XmppClientInterface {
     sendMessageReactionStanza(messageId: string, roomJid: string, reactionsList: string[], reactionSymbol?: any): void;
     sendReceivedReceiptStanza(messageId: string, roomJid: string): void;
     sendDisplayedMarkerStanza(messageId: string, roomJid: string): void;
-    sendHistoryReceivedReceiptStanza(roomJid: string, messageId: string): void;
+    queueDeliveryReceipt(roomJid: string, messageId: string, timestamp?: number, coalesceMs?: number): void;
+    sendHistoryReceivedReceiptStanza(roomJid: string, messageId: string, timestamp?: number, coalesceMs?: number): void;
     sendTypingRequestStanza(chatId: string, fullName: string, start: boolean): void;
     getChatsPrivateStoreRequestStanza: () => Promise<Record<string, string | number> | null>;
     actionSetTimestampToPrivateStoreStanza(chatId: string, timestamp: number, chats?: string[]): Promise<void>;

package/dist/roomStore/roomsSlice.d.ts

@@ -193,7 +193,11 @@ export declare const addRoom: import('@reduxjs/toolkit').ActionCreatorWithOption
     messageId: string;
     fromXmppUsername: string;
     timestamp: number;
-}, "roomMessages/setReceivedReceipt">, setDisplayedMarker: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "roomMessages/setReceivedReceipt">, setReceivedWatermark: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    xmppUsername: string;
+    messageId: string;
+}, "roomMessages/setReceivedWatermark">, setDisplayedMarker: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     roomJID: string;
     xmppUsername: string;
     messageId: string;

package/dist/types/models/config.model.d.ts

@@ -160,6 +160,32 @@ export type ChatErrorFallbackRenderer = (context: ChatErrorInfo & {
     reset: () => void;
 }) => React.ReactNode;
 export type ChatColorScheme = 'light' | 'dark' | 'system';
+/**
+ * Delivery (XEP-0184 `<received/>`) and read (XEP-0333 `<displayed/>`)
+ * receipts. The client always DISPLAYS the receipts it receives; these
+ * options only control what this client SENDS, so large rooms do not turn
+ * every message into a broadcast to every occupant.
+ *
+ * - `mode`: `'auto'` (default) sends delivery receipts only in rooms of up to
+ *   `deliveryMaxRoomSize` other members and read markers only in rooms of up
+ *   to `readMaxRoomSize` other members; `'all'` always sends (still coalesced);
+ *   `'off'` never sends a delivery or read signal.
+ * - `deliveryMaxRoomSize` / `readMaxRoomSize`: room size (other members, the
+ *   sender excluded) above which the signal is skipped in `'auto'`. Private
+ *   1:1 rooms and rooms whose size is unknown always send.
+ * - `maxAgeDays`: in `'auto'`, messages older than this are not acknowledged
+ *   (old history replays do not generate receipts).
+ * - `coalesceMs`: delivery receipts are sent at most once per window per
+ *   room; the first one goes out at once, the rest of the window is collapsed
+ *   into one receipt for the newest message.
+ */
+export interface ReceiptsConfig {
+    mode?: 'auto' | 'all' | 'off';
+    deliveryMaxRoomSize?: number;
+    readMaxRoomSize?: number;
+    maxAgeDays?: number;
+    coalesceMs?: number;
+}
 export interface IConfig {
     appId?: string;
     /**
@@ -335,6 +361,13 @@ export interface IConfig {
      * outright even then, e.g. because it renders its own mute control.
      */
     disableRoomMute?: boolean;
+    /**
+     * Hide the "Block user" action from a 1-1 private chat's header menu. Block
+     * is only ever offered for private rooms with a resolvable peer; this flag
+     * lets a host hide it outright (e.g. it renders its own block control, or
+     * the backend predates the /v1/chats/blocked route).
+     */
+    disableUserBlock?: boolean;
     defaultRooms?: ConfigRoom[];
     /**
      * The "Files" tab shown in the sidebar alongside "Chats". Backed by
@@ -553,6 +586,8 @@ export interface IConfig {
     };
     newArch?: boolean;
     disableLastRead?: boolean;
+    /** Delivery and read receipt sending policy. See ReceiptsConfig. */
+    receipts?: ReceiptsConfig;
     qrUrl?: string;
     secondarySendButton?: {
         enabled: boolean;

package/dist/types/models/room.model.d.ts

@@ -63,6 +63,7 @@ export interface IRoom {
     lastViewedTimestamp?: number;
     unreadBaselineTimestamp?: number;
     lastDisplayedByUser?: Record<string, string>;
+    lastReceivedByUser?: Record<string, string>;
     unreadMessages?: number;
     /**
      * Unread count the server reported for this room in `GET /v1/chats/my`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethora/chat-component",
-  "version": "26.10.1",
+  "version": "26.10.4",
   "type": "module",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
@@ -33,9 +33,13 @@
   "scripts": {
     "dev": "vite",
     "build": "tsc && vite build",
-    "sync:lib": "node ./scripts/sync-lib.mjs",
-    "build:lib": "npm run sync:lib && tsc --p ./tsconfig-build.json && vite build",
-    "prepare": "npm run build && npm run build:lib",
+    "build:lib": "npm run build",
+    "prepare": "node scripts/install-git-hooks.mjs && npm run build",
+    "ci:local": "npm run lint && npm test && npm run test:release && npm run build",
+    "release": "node scripts/release.mjs",
+    "release:ci": "node scripts/release-ci.mjs",
+    "publish:npm": "node scripts/publish-npm.mjs",
+    "test:release": "node --test scripts/lib/version.check.mjs",
     "lint": "eslint . --quiet --report-unused-disable-directives",
     "lint:full": "eslint . --report-unused-disable-directives --max-warnings 0",
     "preview": "vite preview",
@@ -111,9 +115,6 @@
     "csstype": "3.1.3"
   },
   "description": "Open-source React chat and AI-agent UI SDK for Ethora: drop-in messaging, rooms, and AI bots with a self-hosted or cloud backend.",
-  "directories": {
-    "lib": "lib"
-  },
   "author": "Ethora",
   "license": "MIT",
   "homepage": "https://ethora.com",