@manonero/chat-client-sdk 0.0.1-beta.1

package/dist/http/ProxyApi.js

@@ -0,0 +1,86 @@
+// ProxyApi.ts — Dynamic backend proxy endpoints
+import { HttpClient } from './HttpClient.js';
+/**
+ * Proxy API client.
+ * Forwards requests to registered backend services via the gateway.
+ *
+ * Example:
+ *   proxy.get('trading', 'api/stocks/VN30')
+ *   → GET /api/proxy/trading/api/stocks/VN30
+ *
+ * Auth: depends on the target service. Pass JWT when required.
+ * Error format: simple { "detail": "..." } — handled by ChatApiError.fromResponse().
+ */
+export class ProxyApi {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Generic proxy request supporting any HTTP method.
+     *
+     * @param target - The registered backend target name (e.g. "trading")
+     * @param url - The URL path to forward, may include path and query string (e.g. "api/stocks/VN30?page=1")
+     * @param options.method - HTTP method (default: GET)
+     * @param options.body - Request body (for POST/PATCH)
+     * @param options.headers - Additional headers to forward
+     */
+    request(target, url, options) {
+        const method = (options?.method ?? 'GET').toUpperCase();
+        const path = this.buildPath(target, url);
+        switch (method) {
+            case 'POST':
+                return this.http.post(path, options?.body, options?.headers);
+            case 'PUT':
+                return this.http.put(path, options?.body, options?.headers);
+            case 'PATCH':
+                return this.http.patch(path, options?.body, options?.headers);
+            case 'DELETE':
+                return this.http.delete(path, options?.body, options?.headers);
+            default:
+                // GET and any other methods use the GET client
+                return this.http.get(path, options?.headers);
+        }
+    }
+    /**
+     * GET /api/proxy/{target}/{url}
+     * Forward a GET request to the target service.
+     */
+    get(target, url, headers) {
+        return this.http.get(this.buildPath(target, url), headers);
+    }
+    /**
+     * POST /api/proxy/{target}/{url}
+     * Forward a POST request with an optional JSON body to the target service.
+     */
+    post(target, url, body, headers) {
+        return this.http.post(this.buildPath(target, url), body, headers);
+    }
+    /**
+     * PUT /api/proxy/{target}/{url}
+     * Forward a PUT request with an optional JSON body to the target service.
+     */
+    put(target, url, body, headers) {
+        return this.http.put(this.buildPath(target, url), body, headers);
+    }
+    /**
+     * PATCH /api/proxy/{target}/{url}
+     * Forward a PATCH request with an optional JSON body to the target service.
+     */
+    patch(target, url, body, headers) {
+        return this.http.patch(this.buildPath(target, url), body, headers);
+    }
+    /**
+     * DELETE /api/proxy/{target}/{url}
+     * Forward a DELETE request to the target service. An optional JSON body is
+     * forwarded verbatim per spec §10.1 ("Forward HTTP method, query string,
+     * request body, và tất cả request headers").
+     */
+    delete(target, url, body, headers) {
+        return this.http.delete(this.buildPath(target, url), body, headers);
+    }
+    buildPath(target, url) {
+        const trimmed = url.replace(/^\/+/, '');
+        return `/api/proxy/${encodeURIComponent(target)}/${trimmed}`;
+    }
+}
+//# sourceMappingURL=ProxyApi.js.map

package/dist/http/ProxyApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyApi.js","sourceRoot":"","sources":["../../src/http/ProxyApi.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export type { CursorPaginatedResult, PagedResult, MediaReference, ProblemDetails, ProblemError, UploadProgressCallback, } from './types/common.js';
+export type { GoogleLoginRequest, DsAccountLoginRequest, DevLoginRequest, LoginRequest, AuthResponse, AuthUserInfo } from './types/auth.js';
+export type { ParticipantDto, CreateOrUpdateParticipantRequest } from './types/participant.js';
+export type { ConversationParticipantDto, ConversationDto, ConversationListItemDto, ConversationMediaKindFilter, ConversationMediaKind, ConversationMediaBlockType, ConversationMediaItemDto, CreateConversationRequest, UpdateConversationRequest, AddParticipantRequest, } from './types/conversation.js';
+export type { SenderType, SystemEventType, SystemEventInfo, ReactionGroup, ReactionSummary, MessageDto, SendMessageRequest, EditMessageRequest, } from './types/message.js';
+export type { TextFormat, ButtonAction, ButtonStyle, ChoiceMode, QuickReplyAction, MentionType, TextBlock, ImageBlock, VideoBlock, AudioBlock, FileBlock, LinkPreviewBlock, EmbedBlock, LocationBlock, ContactBlock, ChoiceOption, ChoiceBlock, CardField, ActionButton, CardBlock, CarouselBlock, DividerBlock, CustomBlock, Block, QuickReply, Mention, } from './types/block.js';
+export { isTextBlock, isImageBlock, isVideoBlock, isAudioBlock, isFileBlock, isLinkPreviewBlock, isEmbedBlock, isLocationBlock, isContactBlock, isChoiceBlock, isCardBlock, isCarouselBlock, isDividerBlock, isCustomBlock, withTypeFirst, normalizeBlocksForSend, } from './types/block.js';
+export type { CreateUploadUrlRequest, CreateUploadUrlResponse, UploadResponse } from './types/file.js';
+export type { BotDto, CreateBotRequest, UpdateBotRequest } from './types/bot.js';
+export type { SystemEventDto, ReactionGroupDto, ChatMessageDto, MessageUpdatedDto, MessageDeletedDto, ReactionAddedDto, ReactionRemovedDto, TypingDto, MessageThumbnailDto, MessageThumbnailsReadyDto, StreamStartedDto, StreamStatusUpdatedDto, StreamChunkReceivedDto, StreamChunkPart, StreamChunkBatchReceivedDto, StreamCompletedDto, StreamAbortedDto, } from './types/chat-events.js';
+export type { NewMessageNotificationDto, MentionedNotificationDto, ConversationCreatedDto, ConversationUpdatedDto, ParticipantJoinedDto, ParticipantLeftDto, ConversationPinnedDto, ConversationUnpinnedDto, } from './types/notification-events.js';
+export type { ChatSendMessageRequest, ChatEditMessageRequest, ChatDeleteMessageRequest, ChatRecoverMessageRequest, ChatAddReactionRequest, ChatRemoveReactionRequest, SendMessageAck, EditMessageAck, DeleteMessageAck, RecoverMessageAck, ReactionAck, HubErrorDto, } from './types/signalr.js';
+export { ChatApiError } from './errors/ChatApiError.js';
+export { HttpClient } from './http/HttpClient.js';
+export type { HttpClientOptions } from './http/HttpClient.js';
+export { TypedEventEmitter } from './utils/TypedEventEmitter.js';
+export type { Unsubscribe } from './utils/TypedEventEmitter.js';
+export { ChatHubClient } from './realtime/ChatHubClient.js';
+export type { ChatHubClientOptions, ChatHubEventMap } from './realtime/ChatHubClient.js';
+export { NotificationHubClient } from './realtime/NotificationHubClient.js';
+export type { NotificationHubClientOptions, NotificationHubEventMap, } from './realtime/NotificationHubClient.js';
+export { ReconnectionManager } from './realtime/ReconnectionManager.js';
+export type { ReconnectionManagerOptions } from './realtime/ReconnectionManager.js';
+export { ChatClient } from './ChatClient.js';
+export type { ChatClientOptions, ChatClientSignalrOptions, ChatClientRealtime } from './ChatClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG5I,YAAY,EAAE,cAAc,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAG/F,YAAY,EACV,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,KAAK,EACL,UAAU,EACV,OAAO,GACR,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGvG,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGjF,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,2BAA2B,EAC3B,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,YAAY,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAGpF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+// index.ts — Public SDK API — re-exports everything
+// Block type guards + serialization helpers
+export { isTextBlock, isImageBlock, isVideoBlock, isAudioBlock, isFileBlock, isLinkPreviewBlock, isEmbedBlock, isLocationBlock, isContactBlock, isChoiceBlock, isCardBlock, isCarouselBlock, isDividerBlock, isCustomBlock, withTypeFirst, normalizeBlocksForSend, } from './types/block.js';
+// Errors
+export { ChatApiError } from './errors/ChatApiError.js';
+// HTTP client
+export { HttpClient } from './http/HttpClient.js';
+// Utils — TypedEventEmitter
+export { TypedEventEmitter } from './utils/TypedEventEmitter.js';
+// Real-time — ChatHubClient
+export { ChatHubClient } from './realtime/ChatHubClient.js';
+// Real-time — NotificationHubClient
+export { NotificationHubClient } from './realtime/NotificationHubClient.js';
+// Real-time — ReconnectionManager
+export { ReconnectionManager } from './realtime/ReconnectionManager.js';
+// ChatClient — Main SDK facade (Phase 4)
+export { ChatClient } from './ChatClient.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AA0EpD,4CAA4C;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAyD1B,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE,4BAA4B;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,oCAAoC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAM5E,kCAAkC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,yCAAyC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/realtime/ChatHubClient.d.ts

@@ -0,0 +1,143 @@
+import { HubConnectionState, LogLevel } from '@microsoft/signalr';
+import type { Unsubscribe } from '../utils/TypedEventEmitter.js';
+import type { ChatMessageDto, MessageUpdatedDto, MessageDeletedDto, MessageThumbnailsReadyDto, ReactionAddedDto, ReactionRemovedDto, TypingDto, StreamStartedDto, StreamStatusUpdatedDto, StreamChunkReceivedDto, StreamChunkBatchReceivedDto, StreamCompletedDto, StreamAbortedDto } from '../types/chat-events.js';
+import type { ChatSendMessageRequest, ChatEditMessageRequest, ChatDeleteMessageRequest, ChatRecoverMessageRequest, ChatAddReactionRequest, ChatRemoveReactionRequest, SendMessageAck, EditMessageAck, DeleteMessageAck, RecoverMessageAck, ReactionAck, HubErrorDto } from '../types/signalr.js';
+export interface ChatHubEventMap {
+    messageReceived: ChatMessageDto;
+    messageUpdated: MessageUpdatedDto;
+    messageDeleted: MessageDeletedDto;
+    /** Payload is full ChatMessageDto — same shape as messageReceived */
+    messageRecovered: ChatMessageDto;
+    /** Server has finished generating thumbnails for media blocks — patch by blockIndex */
+    messageThumbnailsReady: MessageThumbnailsReadyDto;
+    reactionAdded: ReactionAddedDto;
+    reactionRemoved: ReactionRemovedDto;
+    typingStarted: TypingDto;
+    typingStopped: TypingDto;
+    streamStarted: StreamStartedDto;
+    streamStatusUpdated: StreamStatusUpdatedDto;
+    streamChunkReceived: StreamChunkReceivedDto;
+    streamChunkBatchReceived: StreamChunkBatchReceivedDto;
+    streamCompleted: StreamCompletedDto;
+    streamAborted: StreamAbortedDto;
+    error: HubErrorDto;
+    reconnecting: Error | undefined;
+    reconnected: string | undefined;
+    disconnected: Error | undefined;
+}
+export interface ChatHubClientOptions {
+    /** Full URL of the ChatHub endpoint, e.g. "https://api.example.com/hubs/chat" */
+    hubUrl: string;
+    /** Returns the current JWT token to use as access_token query param */
+    tokenProvider: () => string | null;
+    /** Minimum log level for SignalR internal logging (default: Warning) */
+    logLevel?: LogLevel;
+}
+/**
+ * Typed client for the ChatHub (`/hubs/chat`).
+ *
+ * Responsibilities:
+ * - Manages HubConnection lifecycle (connect / disconnect / auto-reconnect)
+ * - Exposes typed Hub methods (Client → Server)
+ * - Exposes typed event subscription (Server → Client)
+ * - Tracks joined conversations so ReconnectionManager can re-join on reconnect
+ */
+export declare class ChatHubClient {
+    private readonly options;
+    private connection;
+    private readonly emitter;
+    /** In-flight connect Promise, used to dedupe concurrent connect() calls. */
+    private connectingPromise;
+    /**
+     * True after a user-initiated disconnect() until the next connect() begins.
+     * ReconnectionManager uses this to skip auto-reconnect when the close was
+     * intentional rather than caused by a transport failure.
+     */
+    private _intentionallyClosed;
+    /** Set of conversationIds that have been joined in the current session */
+    readonly joinedConversations: Set<string>;
+    /**
+     * Tracks join attempts that resolved successfully but may still be revoked by
+     * a follow-up server `Error` event (FORBIDDEN/UNAUTHORIZED). Entries auto-expire
+     * after PENDING_JOIN_TTL_MS to bound memory.
+     */
+    private readonly pendingJoinAttempts;
+    private static readonly PENDING_JOIN_TTL_MS;
+    /** Server→client method names registered via conn.on() — used for cleanup. */
+    private static readonly HUB_EVENT_NAMES;
+    constructor(options: ChatHubClientOptions);
+    get state(): HubConnectionState;
+    /**
+     * True after a user-initiated disconnect() and until the next connect() starts.
+     * ReconnectionManager honors this to avoid reconnecting after an intentional close.
+     */
+    get intentionallyClosed(): boolean;
+    /** Build a new HubConnection using the latest token from tokenProvider */
+    private buildConnection;
+    /** Attach SignalR server→client event handlers to the connection */
+    private attachHandlers;
+    /**
+     * Connect to ChatHub. If already connected, resolves immediately.
+     * Concurrent calls share a single in-flight Promise — building two
+     * connections at once would leak handlers.
+     * Builds a fresh connection using the current token.
+     *
+     * Throws synchronously when no authentication token is available so the
+     * caller gets a clear error rather than a malformed Authorization header.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from ChatHub and clear joined conversation tracking.
+     * If a connect is in flight, it is awaited first so we always tear down a
+     * fully-formed connection (not a half-built one).
+     *
+     * Sets `intentionallyClosed` so ReconnectionManager skips its reconnect
+     * attempt for the resulting `disconnected` event.
+     */
+    disconnect(): Promise<void>;
+    /** Detach all server→client method handlers registered via attachHandlers(). */
+    private detachHandlers;
+    private safeStop;
+    /**
+     * Re-join all tracked conversations. Called internally after reconnect.
+     * Called by ReconnectionManager as well.
+     *
+     * If a rejoin fails with an access-denied style error (e.g. user was kicked
+     * between disconnect and reconnect), the conversation is purged from
+     * `joinedConversations` so we do not retry it forever on every reconnect.
+     * Other errors keep the entry — the next reconnect will try again.
+     */
+    rejoinConversations(): Promise<void>;
+    private isAccessDeniedError;
+    private invokeHub;
+    joinConversation(conversationId: string): Promise<void>;
+    leaveConversation(conversationId: string): Promise<void>;
+    startTyping(conversationId: string): Promise<void>;
+    stopTyping(conversationId: string): Promise<void>;
+    sendMessage(request: ChatSendMessageRequest): Promise<SendMessageAck>;
+    editMessage(request: ChatEditMessageRequest): Promise<EditMessageAck>;
+    /** Server expects an object { messageId }, not a bare string */
+    deleteMessage(request: ChatDeleteMessageRequest): Promise<DeleteMessageAck>;
+    /** Server expects an object { messageId }, not a bare string */
+    recoverMessage(request: ChatRecoverMessageRequest): Promise<RecoverMessageAck>;
+    addReaction(request: ChatAddReactionRequest): Promise<ReactionAck>;
+    removeReaction(request: ChatRemoveReactionRequest): Promise<ReactionAck>;
+    on<K extends keyof ChatHubEventMap>(event: K, handler: (payload: ChatHubEventMap[K]) => void): Unsubscribe;
+    off<K extends keyof ChatHubEventMap>(event: K, handler: (payload: ChatHubEventMap[K]) => void): void;
+    private markJoinPending;
+    private clearPendingJoinAttempts;
+    private revertJoin;
+    /**
+     * If a server-emitted Error indicates a join was rejected, remove the
+     * conversation from `joinedConversations` to prevent auto-rejoin on reconnect.
+     *
+     * Strategy:
+     *   1. If `error.details.conversationId` is provided AND matches a pending
+     *      join attempt → revert that one (most reliable signal).
+     *   2. Else, if the message matches the spec's documented FORBIDDEN text
+     *      ("not a participant") AND there is exactly one pending join → revert it.
+     *   3. Otherwise do nothing — we cannot safely correlate the error to a join.
+     */
+    private handlePotentialJoinFailure;
+}
+//# sourceMappingURL=ChatHubClient.d.ts.map

package/dist/realtime/ChatHubClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHubClient.d.ts","sourceRoot":"","sources":["../../src/realtime/ChatHubClient.ts"],"names":[],"mappings":"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"}