@antzsoft/chat-core 1.1.0 → 1.1.2

package/dist/index.d.cts

@@ -3,7 +3,6 @@ import { Socket } from 'socket.io-client';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
 
-type EncryptionMode = 'none' | 'server' | 'e2ee';
 type FileType = 'image' | 'video' | 'audio' | 'document';
 type ConversationType = 'direct' | 'group';
 type MessageStatus = 'sent' | 'delivered' | 'read' | 'failed' | 'deleted';
@@ -79,17 +78,6 @@ interface Attachment {
     isUploading?: boolean;
     uploadProgress?: number;
 }
-interface EncryptedContent {
-    ciphertext: string;
-    iv: string;
-    tag: string;
-    algorithm: 'aes-256-gcm';
-}
-interface EncryptionKeyInfo {
-    key: string;
-    enabled: boolean;
-    mode: EncryptionMode;
-}
 interface MessageReaction {
     emoji: string;
     userIds: string[];
@@ -100,10 +88,23 @@ interface MessageContent {
     type: 'text' | 'attachment' | 'system';
     attachments?: Attachment[];
 }
+interface ReplyAttachmentSnapshot {
+    type: FileType;
+    filename: string;
+    mimeType: string;
+    size: number;
+    duration?: number;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    url: string;
+}
 interface MessageReplyReference {
     messageId?: string;
     contentPreview?: string;
     senderName?: string;
+    attachmentSnapshot?: ReplyAttachmentSnapshot;
     id?: string;
     content?: MessageContent;
     sender?: Pick<User, 'displayName' | 'avatarUrl'>;
@@ -136,9 +137,6 @@ interface Message {
         userId: string;
         deliveredAt: string;
     }>;
-    isEncrypted?: boolean;
-    encryptionMode?: EncryptionMode;
-    encryptedContent?: EncryptedContent;
 }
 interface Participant {
     userId: string;
@@ -175,9 +173,6 @@ interface Conversation {
     isPinned?: boolean;
     isMuted?: boolean;
     mutedUntil?: string;
-    encryptionMode?: EncryptionMode;
-    isEncryptionEnabled?: boolean;
-    encryptionKey?: string;
 }
 interface AppConfig {
     maxPinnedConversations: number;
@@ -247,6 +242,7 @@ interface PresignedUrlRequest {
     size: number;
     conversationId?: string;
     folder?: string;
+    metadata?: Record<string, unknown>;
 }
 interface PresignedUrlResponse {
     fileId: string;
@@ -375,8 +371,6 @@ interface SendMessagePayload {
     attachments?: SendMessageAttachment[];
     replyTo?: string;
     tempId: string;
-    encryptedContent?: EncryptedContent;
-    isEncrypted?: boolean;
 }
 interface QuietHours {
     enabled: boolean;
@@ -509,8 +503,14 @@ interface AntzChatConfig {
     };
     /** Required for multi-tenant backends. Sent as X-Tenant-ID header. */
     tenantId?: string;
-    /** Must match server ENCRYPTION_MODE env var. Default: 'none' */
-    encryptionMode?: 'none' | 'server';
+    /**
+     * Enable payload-level transit encryption (ECDH key exchange + AES-256-GCM).
+     * Encrypts every HTTP request/response body and every socket event payload.
+     * Server must have TRANSIT_ENCRYPTION_ENABLED=true to match.
+     * Default: true — set false only for local development/debugging.
+     * Safe to toggle anytime — no data migration needed (wire-only, never affects storage).
+     */
+    transitEncryption?: boolean;
     upload?: UploadConfig;
     /**
      * Optional compression config. Compression is disabled if platformCompressFn is not provided.
@@ -567,7 +567,7 @@ interface ResolvedConfig {
         url?: string;
         base64?: string;
     };
-    encryptionMode: 'none' | 'server';
+    transitEncryption: boolean;
     upload: {
         maxFileSizeMB: ResolvedFileSizeLimits;
         maxFilesPerMessage: number;
@@ -626,7 +626,6 @@ interface SendData {
     attachments?: SendMessagePayload['attachments'];
     replyTo?: string;
     tempId?: string;
-    isEncrypted?: boolean;
 }
 declare const messagesApi: {
     list(conversationId: string, params?: ListMessagesParams): Promise<CursorPaginatedResponse<Message>>;
@@ -675,7 +674,7 @@ declare const conversationsApi: {
     createDirect(payload: CreateDirectData): Promise<Conversation>;
     update(conversationId: string, payload: UpdateConversationData): Promise<Conversation>;
     delete(conversationId: string): Promise<void>;
-    addParticipants(conversationId: string, userIds: string[]): Promise<Conversation>;
+    addParticipants(conversationId: string, userIds: string[], role?: "admin" | "member"): Promise<Conversation>;
     removeParticipant(conversationId: string, userId: string): Promise<Conversation>;
     updateParticipantRole(conversationId: string, userId: string, role: "admin" | "member"): Promise<Conversation>;
     mute(conversationId: string, mutedUntil?: string): Promise<void>;
@@ -839,10 +838,7 @@ declare function disconnectSocket(): void;
 declare function reconnectSocket(token: string, userId?: string, tenantId?: string): void;
 /**
  * Updates the socket auth token from the stored getToken function and reconnects.
- * Called by SocketProvider on connect_error to handle expired-token scenarios:
- *   1. Token expired while disconnected → server rejects the reconnect handshake
- *   2. authProvider returns a fresh token → we update socket auth and retry
- *
+ * Called by SocketProvider on connect_error to handle expired-token scenarios.
  * Returns true if the token was updated, false if no token source is available.
  */
 declare function refreshSocketAuth(): boolean;
@@ -864,6 +860,16 @@ declare const socketEmit: {
     getTypingUsers(conversationId: string): Promise<unknown>;
 };
 
+type TransitAlgo = 'x25519' | 'p256';
+
+interface TransitSession {
+    sessionKey: CryptoKey;
+    algo: TransitAlgo;
+    sessionId: string;
+    enabled: boolean;
+}
+declare function setTransitSession(session: TransitSession): void;
+
 interface AuthState {
     user: User | null;
     tokens: AuthTokens | null;
@@ -1062,7 +1068,7 @@ declare class AntzChatClient {
         createDirect(payload: CreateDirectData): Promise<Conversation>;
         update(conversationId: string, payload: UpdateConversationData): Promise<Conversation>;
         delete(conversationId: string): Promise<void>;
-        addParticipants(conversationId: string, userIds: string[]): Promise<Conversation>;
+        addParticipants(conversationId: string, userIds: string[], role?: "admin" | "member"): Promise<Conversation>;
         removeParticipant(conversationId: string, userId: string): Promise<Conversation>;
         updateParticipantRole(conversationId: string, userId: string, role: "admin" | "member"): Promise<Conversation>;
         mute(conversationId: string, mutedUntil?: string): Promise<void>;
@@ -1122,4 +1128,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type EncryptedContent, type EncryptionKeyInfo, type EncryptionMode, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };
+export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ReplyAttachmentSnapshot, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, setTransitSession, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };

package/dist/index.d.ts

@@ -3,7 +3,6 @@ import { Socket } from 'socket.io-client';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
 
-type EncryptionMode = 'none' | 'server' | 'e2ee';
 type FileType = 'image' | 'video' | 'audio' | 'document';
 type ConversationType = 'direct' | 'group';
 type MessageStatus = 'sent' | 'delivered' | 'read' | 'failed' | 'deleted';
@@ -79,17 +78,6 @@ interface Attachment {
     isUploading?: boolean;
     uploadProgress?: number;
 }
-interface EncryptedContent {
-    ciphertext: string;
-    iv: string;
-    tag: string;
-    algorithm: 'aes-256-gcm';
-}
-interface EncryptionKeyInfo {
-    key: string;
-    enabled: boolean;
-    mode: EncryptionMode;
-}
 interface MessageReaction {
     emoji: string;
     userIds: string[];
@@ -100,10 +88,23 @@ interface MessageContent {
     type: 'text' | 'attachment' | 'system';
     attachments?: Attachment[];
 }
+interface ReplyAttachmentSnapshot {
+    type: FileType;
+    filename: string;
+    mimeType: string;
+    size: number;
+    duration?: number;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    url: string;
+}
 interface MessageReplyReference {
     messageId?: string;
     contentPreview?: string;
     senderName?: string;
+    attachmentSnapshot?: ReplyAttachmentSnapshot;
     id?: string;
     content?: MessageContent;
     sender?: Pick<User, 'displayName' | 'avatarUrl'>;
@@ -136,9 +137,6 @@ interface Message {
         userId: string;
         deliveredAt: string;
     }>;
-    isEncrypted?: boolean;
-    encryptionMode?: EncryptionMode;
-    encryptedContent?: EncryptedContent;
 }
 interface Participant {
     userId: string;
@@ -175,9 +173,6 @@ interface Conversation {
     isPinned?: boolean;
     isMuted?: boolean;
     mutedUntil?: string;
-    encryptionMode?: EncryptionMode;
-    isEncryptionEnabled?: boolean;
-    encryptionKey?: string;
 }
 interface AppConfig {
     maxPinnedConversations: number;
@@ -247,6 +242,7 @@ interface PresignedUrlRequest {
     size: number;
     conversationId?: string;
     folder?: string;
+    metadata?: Record<string, unknown>;
 }
 interface PresignedUrlResponse {
     fileId: string;
@@ -375,8 +371,6 @@ interface SendMessagePayload {
     attachments?: SendMessageAttachment[];
     replyTo?: string;
     tempId: string;
-    encryptedContent?: EncryptedContent;
-    isEncrypted?: boolean;
 }
 interface QuietHours {
     enabled: boolean;
@@ -509,8 +503,14 @@ interface AntzChatConfig {
     };
     /** Required for multi-tenant backends. Sent as X-Tenant-ID header. */
     tenantId?: string;
-    /** Must match server ENCRYPTION_MODE env var. Default: 'none' */
-    encryptionMode?: 'none' | 'server';
+    /**
+     * Enable payload-level transit encryption (ECDH key exchange + AES-256-GCM).
+     * Encrypts every HTTP request/response body and every socket event payload.
+     * Server must have TRANSIT_ENCRYPTION_ENABLED=true to match.
+     * Default: true — set false only for local development/debugging.
+     * Safe to toggle anytime — no data migration needed (wire-only, never affects storage).
+     */
+    transitEncryption?: boolean;
     upload?: UploadConfig;
     /**
      * Optional compression config. Compression is disabled if platformCompressFn is not provided.
@@ -567,7 +567,7 @@ interface ResolvedConfig {
         url?: string;
         base64?: string;
     };
-    encryptionMode: 'none' | 'server';
+    transitEncryption: boolean;
     upload: {
         maxFileSizeMB: ResolvedFileSizeLimits;
         maxFilesPerMessage: number;
@@ -626,7 +626,6 @@ interface SendData {
     attachments?: SendMessagePayload['attachments'];
     replyTo?: string;
     tempId?: string;
-    isEncrypted?: boolean;
 }
 declare const messagesApi: {
     list(conversationId: string, params?: ListMessagesParams): Promise<CursorPaginatedResponse<Message>>;
@@ -675,7 +674,7 @@ declare const conversationsApi: {
     createDirect(payload: CreateDirectData): Promise<Conversation>;
     update(conversationId: string, payload: UpdateConversationData): Promise<Conversation>;
     delete(conversationId: string): Promise<void>;
-    addParticipants(conversationId: string, userIds: string[]): Promise<Conversation>;
+    addParticipants(conversationId: string, userIds: string[], role?: "admin" | "member"): Promise<Conversation>;
     removeParticipant(conversationId: string, userId: string): Promise<Conversation>;
     updateParticipantRole(conversationId: string, userId: string, role: "admin" | "member"): Promise<Conversation>;
     mute(conversationId: string, mutedUntil?: string): Promise<void>;
@@ -839,10 +838,7 @@ declare function disconnectSocket(): void;
 declare function reconnectSocket(token: string, userId?: string, tenantId?: string): void;
 /**
  * Updates the socket auth token from the stored getToken function and reconnects.
- * Called by SocketProvider on connect_error to handle expired-token scenarios:
- *   1. Token expired while disconnected → server rejects the reconnect handshake
- *   2. authProvider returns a fresh token → we update socket auth and retry
- *
+ * Called by SocketProvider on connect_error to handle expired-token scenarios.
  * Returns true if the token was updated, false if no token source is available.
  */
 declare function refreshSocketAuth(): boolean;
@@ -864,6 +860,16 @@ declare const socketEmit: {
     getTypingUsers(conversationId: string): Promise<unknown>;
 };
 
+type TransitAlgo = 'x25519' | 'p256';
+
+interface TransitSession {
+    sessionKey: CryptoKey;
+    algo: TransitAlgo;
+    sessionId: string;
+    enabled: boolean;
+}
+declare function setTransitSession(session: TransitSession): void;
+
 interface AuthState {
     user: User | null;
     tokens: AuthTokens | null;
@@ -1062,7 +1068,7 @@ declare class AntzChatClient {
         createDirect(payload: CreateDirectData): Promise<Conversation>;
         update(conversationId: string, payload: UpdateConversationData): Promise<Conversation>;
         delete(conversationId: string): Promise<void>;
-        addParticipants(conversationId: string, userIds: string[]): Promise<Conversation>;
+        addParticipants(conversationId: string, userIds: string[], role?: "admin" | "member"): Promise<Conversation>;
         removeParticipant(conversationId: string, userId: string): Promise<Conversation>;
         updateParticipantRole(conversationId: string, userId: string, role: "admin" | "member"): Promise<Conversation>;
         mute(conversationId: string, mutedUntil?: string): Promise<void>;
@@ -1122,4 +1128,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type EncryptedContent, type EncryptionKeyInfo, type EncryptionMode, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };
+export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ReplyAttachmentSnapshot, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, setTransitSession, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };