@antzsoft/chat-core 1.0.7 → 1.0.9

package/dist/index.d.ts

@@ -232,6 +232,12 @@ interface CursorPaginatedResponse<T> {
     data: T[];
     meta: CursorPaginationMeta;
 }
+type CompressionAlgorithm = 'webp' | 'jpeg' | 'gzip' | 'none';
+interface CompressedFile extends UploadableFile {
+    originalSize: number;
+    compressed: boolean;
+    compressionAlgorithm: CompressionAlgorithm;
+}
 interface PresignedUrlRequest {
     filename: string;
     mimeType: string;
@@ -348,6 +354,7 @@ interface SendMessageAttachment {
     filename: string;
     mimeType: string;
     size: number;
+    duration?: number;
 }
 interface OptimisticAttachment extends SendMessageAttachment {
     id: string;
@@ -425,6 +432,29 @@ interface PersistStorage {
     setItem(key: string, value: string): void | Promise<void>;
     removeItem(key: string): void | Promise<void>;
 }
+/**
+ * Platform-provided compression function. Optional — if omitted, files are uploaded as-is.
+ * - Web: uses canvas (images) + CompressionStream (text/docs) — both browser-native
+ * - RN: uses expo-image-manipulator (images) + pako (text/docs)
+ * - Node: uses sharp (images) + zlib (text/docs)
+ */
+type PlatformCompressFn = (file: UploadableFile, options: ResolvedCompressionConfig) => Promise<CompressedFile>;
+interface CompressionConfig {
+    /** Master switch. Default: true when platformCompressFn is provided, false otherwise */
+    enabled?: boolean;
+    /** WebP quality for images, 0–1. Default: 0.85 */
+    imageQuality?: number;
+    /** Longest side cap in px before encoding. Default: 1920 */
+    imageMaxDimension?: number;
+    /** Gzip text-based documents (plain, csv, json, xml, yaml, svg). Default: true */
+    compressDocuments?: boolean;
+}
+interface ResolvedCompressionConfig {
+    enabled: boolean;
+    imageQuality: number;
+    imageMaxDimension: number;
+    compressDocuments: boolean;
+}
 interface UploadConfig {
     /**
      * Per-type file size limits in MB. Can also pass a single number for all types.
@@ -479,6 +509,15 @@ interface AntzChatConfig {
     /** Must match server ENCRYPTION_MODE env var. Default: 'none' */
     encryptionMode?: 'none' | 'server';
     upload?: UploadConfig;
+    /**
+     * Optional compression config. Compression is disabled if platformCompressFn is not provided.
+     */
+    compression?: CompressionConfig;
+    /**
+     * Platform-specific compression implementation. Optional — omit to disable compression.
+     * Each SDK (web, RN) provides its own default; Node.js users wire in their own.
+     */
+    platformCompressFn?: PlatformCompressFn;
     /**
      * Number of messages fetched per page when loading chat history.
      * Default: 40
@@ -534,6 +573,8 @@ interface ResolvedConfig {
         onProgress?: (progress: number) => void;
     };
     platformUploadFn: PlatformUploadFn;
+    platformCompressFn?: PlatformCompressFn;
+    compression: ResolvedCompressionConfig;
     persistStorage: PersistStorage;
     messagePageSize: number;
     starredMessagePageSize: number;
@@ -541,6 +582,9 @@ interface ResolvedConfig {
 }
 declare function resolveConfig(config: AntzChatConfig): ResolvedConfig;
 
+type CompressionStrategy = 'image' | 'gzip' | 'skip';
+declare function getCompressionStrategy(mimeType: string, config: ResolvedCompressionConfig): CompressionStrategy;
+
 declare const authApi: {
     login(credentials: LoginCredentials): Promise<AuthResponse>;
     register(payload: RegisterData): Promise<AuthResponse>;
@@ -683,8 +727,11 @@ declare const storageApi: {
  * High-level batch upload.
  * The actual binary transfer is delegated to platformUploadFn so this
  * function is platform-agnostic (works on web and React Native).
+ * If platformCompressFn + compressionConfig are provided, each file is
+ * compressed before the presigned URL is requested (so the server receives
+ * the correct compressed size and MIME type).
  */
-declare function uploadBatch(files: UploadableFile[], platformUploadFn: PlatformUploadFn, conversationId?: string, onProgress?: (pct: number) => void): Promise<BatchUploadResult>;
+declare function uploadBatch(files: UploadableFile[], platformUploadFn: PlatformUploadFn, conversationId?: string, onProgress?: (pct: number) => void, platformCompressFn?: PlatformCompressFn, compressionConfig?: ResolvedCompressionConfig): Promise<BatchUploadResult>;
 
 /** Shared fields for every device registration. */
 interface DeviceTokenBase {
@@ -1068,4 +1115,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, type AntzChatConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, 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 PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, 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, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };
+export { AntzChatClient, type AntzChatConfig, 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, 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 };

package/dist/index.js

@@ -47,6 +47,13 @@ function resolveConfig(config) {
       onProgress: config.upload?.onProgress
     },
     platformUploadFn: config.platformUploadFn,
+    platformCompressFn: config.platformCompressFn,
+    compression: {
+      enabled: config.compression?.enabled ?? config.platformCompressFn != null,
+      imageQuality: config.compression?.imageQuality ?? 0.85,
+      imageMaxDimension: config.compression?.imageMaxDimension ?? 1920,
+      compressDocuments: config.compression?.compressDocuments ?? true
+    },
     persistStorage: config.persistStorage,
     messagePageSize: config.messagePageSize ?? 40,
     starredMessagePageSize: config.starredMessagePageSize ?? 30,
@@ -54,6 +61,68 @@ function resolveConfig(config) {
   };
 }
 
+// src/compression/compress.ts
+var GZIP_MIME_TYPES = /* @__PURE__ */ new Set([
+  "text/plain",
+  "text/csv",
+  "text/markdown",
+  "text/x-markdown",
+  "text/xml",
+  "application/xml",
+  "text/yaml",
+  "text/x-yaml",
+  "application/x-yaml",
+  "application/rtf",
+  "text/rtf",
+  "application/json",
+  "image/svg+xml"
+]);
+var IMAGE_MIME_TYPES = /* @__PURE__ */ new Set([
+  "image/jpeg",
+  "image/png",
+  "image/gif",
+  "image/webp",
+  "image/bmp",
+  "image/tiff"
+]);
+var SKIP_MIME_TYPES = /* @__PURE__ */ new Set([
+  "video/mp4",
+  "video/webm",
+  "video/quicktime",
+  "audio/mpeg",
+  "audio/wav",
+  "audio/ogg",
+  "audio/webm",
+  "audio/mp4",
+  "application/zip",
+  "application/pdf",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+]);
+function getCompressionStrategy(mimeType, config) {
+  if (SKIP_MIME_TYPES.has(mimeType)) return "skip";
+  if (IMAGE_MIME_TYPES.has(mimeType)) return "image";
+  if (config.compressDocuments && GZIP_MIME_TYPES.has(mimeType)) return "gzip";
+  return "skip";
+}
+async function compressFile(file, platformCompressFn, config) {
+  const noop = {
+    ...file,
+    originalSize: file.size,
+    compressed: false,
+    compressionAlgorithm: "none"
+  };
+  if (!config.enabled || !platformCompressFn) return noop;
+  const strategy = getCompressionStrategy(file.type, config);
+  if (strategy === "skip") return noop;
+  try {
+    return await platformCompressFn(file, config);
+  } catch {
+    return noop;
+  }
+}
+
 // src/api/client.ts
 import axios from "axios";
 var _tokenStore = null;
@@ -450,12 +519,22 @@ var storageApi = {
     return data;
   }
 };
-async function uploadBatch(files, platformUploadFn, conversationId, onProgress) {
-  const requests = files.map((f) => ({
+async function uploadBatch(files, platformUploadFn, conversationId, onProgress, platformCompressFn, compressionConfig) {
+  const compressedFiles = await Promise.all(
+    files.map((f) => compressFile(f, platformCompressFn, compressionConfig ?? { enabled: false, imageQuality: 0.85, imageMaxDimension: 1920, compressDocuments: true }))
+  );
+  const requests = compressedFiles.map((f) => ({
     filename: f.name,
     mimeType: f.type,
     size: f.size,
-    conversationId
+    conversationId,
+    ...f.compressed && {
+      metadata: {
+        compressed: true,
+        originalSize: f.originalSize,
+        compressionAlgorithm: f.compressionAlgorithm
+      }
+    }
   }));
   const { urls, errors: requestErrors } = await storageApi.requestPresignedUrlBatch(requests);
   const progressMap = {};
@@ -469,7 +548,7 @@ async function uploadBatch(files, platformUploadFn, conversationId, onProgress)
   const failed = [...requestErrors];
   await Promise.all(
     urls.map(async (presigned, idx) => {
-      const file = files[idx];
+      const file = compressedFiles[idx];
       progressMap[idx] = 0;
       try {
         await platformUploadFn(presigned, file, (pct) => {
@@ -664,8 +743,32 @@ function refreshSocketAuth() {
 
 // src/socket/emitters.ts
 var ACK_TIMEOUT = 5e3;
-function withAck(event, payload) {
-  const socket = tryGetSocket();
+var RECONNECT_WAIT_TIMEOUT = 15e3;
+function waitForReconnect() {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      unsubscribe();
+      reject(new Error("[AntzChat] Socket reconnect timeout"));
+    }, RECONNECT_WAIT_TIMEOUT);
+    const unsubscribe = onSocketStatus((status) => {
+      if (status === "connected") {
+        clearTimeout(timer);
+        unsubscribe();
+        resolve();
+      } else if (status === "error") {
+        clearTimeout(timer);
+        unsubscribe();
+        reject(new Error("[AntzChat] Socket reconnect failed"));
+      }
+    });
+  });
+}
+async function withAck(event, payload) {
+  let socket = tryGetSocket();
+  if (!socket) {
+    await waitForReconnect();
+    socket = tryGetSocket();
+  }
   if (!socket) return Promise.reject(new Error(`[AntzChat] Socket not connected (event: ${event})`));
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => reject(new Error(`Socket ack timeout: ${event}`)), ACK_TIMEOUT);
@@ -861,7 +964,14 @@ var AntzChatClient = class {
     disconnectSocket();
   }
   uploadFiles(files, conversationId) {
-    return uploadBatch(files, this._config.platformUploadFn, conversationId, this._config.upload.onProgress);
+    return uploadBatch(
+      files,
+      this._config.platformUploadFn,
+      conversationId,
+      this._config.upload.onProgress,
+      this._config.platformCompressFn,
+      this._config.compression
+    );
   }
   async uploadIcon(conversationId, file) {
     const result = await this.uploadFiles([file], conversationId);
@@ -880,6 +990,7 @@ export {
   disconnectSocket,
   getApiClient,
   getAuthStore,
+  getCompressionStrategy,
   getSocket,
   getSocketStatus,
   initApiClient,