wexa-chat 0.2.6 → 0.2.10

package/README.md

@@ -125,6 +125,8 @@ export type InitOptions = {
   - `listMessages({ organizationId, conversationId, limit?, cursor? })`
   - `listMessagesWithSenders({ organizationId, conversationId, limit?, cursor?, populateSenders: true, populateOptions? })`
   - `markRead({ organizationId, conversationId, participantModel, participantId, messageId })`
+  - `receiveWhatsappMessage({ whatsappChatId, message })`
+  - `receiveLinkedinMessage({ linkedinChatId, message })`
 
 DTO types live in `src/types/dto.ts`.
 
@@ -254,6 +256,29 @@ Under the hood (`src/services/messages.service.ts`):
 
 This allows subsequent UI actions to prefill the last known contact handles for LinkedIn and WhatsApp.
 
+### Receiving inbound connector messages
+
+When an external connector delivers a new inbound message, you can persist it directly using the chat ID stored on the conversation:
+
+```ts
+await chat.services.messages.receiveWhatsappMessage({
+  whatsappChatId: 'wa-chat-123',
+  message: 'Hello from WhatsApp',
+});
+
+await chat.services.messages.receiveLinkedinMessage({
+  linkedinChatId: 'li-chat-456',
+  message: 'Hello from LinkedIn',
+});
+```
+
+Both helpers will:
+
+1. Locate the conversation by the given chat ID.
+2. Use the `Application` participant from the conversation as the sender.
+3. Create a new message with `kind: 'text'` and `source` set to the respective connector.
+4. Update the conversation summary fields (`lastMessageAt`, `lastMessagePreview`, `lastMessageSenderId`, `lastMessageSenderModel`).
+
 ## Models
 
 The package exports the following model types which can be imported directly:

package/dist/index.d.cts

@@ -247,6 +247,22 @@ type SearchConversationsArgs = {
     cursor?: string;
 };
 
+/**
+ * Represents a successful chat start response
+ */
+interface ChatStartedResponse {
+    object: 'ChatStarted';
+    chat_id: string;
+    message_id: string;
+}
+/**
+ * Common response type for chat API operations
+ */
+type ChatApiResponse = ChatStartedResponse | {
+    error: string;
+    details?: unknown;
+};
+
 interface IConversation extends Document {
     organizationId: string;
     participants: Array<{
@@ -359,6 +375,14 @@ interface MessagesService {
         populateSenders: true;
     }): Promise<PaginatedResult<MessageWithSender>>;
     markRead(args: MarkReadArgs): Promise<void>;
+    receiveWhatsappMessage(args: {
+        whatsappChatId: string;
+        message: string;
+    }): Promise<IMessage>;
+    receiveLinkedinMessage(args: {
+        linkedinChatId: string;
+        message: string;
+    }): Promise<IMessage>;
 }
 /**
  * Create messages service
@@ -582,4 +606,4 @@ interface ChatServices {
  */
 declare function initChat(mongooseInstance: typeof mongoose, options: InitOptions, server?: Server): Promise<ChatServices>;
 
-export { type Actor, type ChatServices, type ConversationModel, type ConversationReadEvent, type ConversationsService, type CreateConversationArgs, type EnvironmentConfig, type IConversation, type IMessage, type InitOptions, type ListMessagesArgs, type MarkReadArgs, type MessageCreatedEvent, type MessageModel, type MessageServiceHooks, type MessageWithSender, type MessagesService, type PaginatedResult, type PresenceEvent, type RedisConfig, type RuntimeConfig, type SearchConversationsArgs, type SearchMessagesArgs, type SendMessageArgs, type SocketConfig$1 as SocketConfig, type SourceType, type Transport, type TransportConfig, type TypingEvent, createConversationId, createConversationModel, createConversationsService, createCursor, createMessageId, createMessageModel, createMessagesService, createModels, createPaginatedResponse, createThreadId, createTransport, ensureIndexes, generateId, getRedisConfig, getRuntimeConfig, initChat, modelRegistry, parseCursor, searchByParticipantPair, searchConversations, searchMessages, setRuntimeConfig, sourceType, validateCreateConversationArgs, validateInitOptions, validateMarkReadArgs, validatePagination, validateSendMessageArgs };
+export { type Actor, type ChatApiResponse, type ChatServices, type ChatStartedResponse, type ConversationModel, type ConversationReadEvent, type ConversationsService, type CreateConversationArgs, type EnvironmentConfig, type IConversation, type IMessage, type InitOptions, type ListMessagesArgs, type MarkReadArgs, type MessageCreatedEvent, type MessageModel, type MessageServiceHooks, type MessageWithSender, type MessagesService, type PaginatedResult, type PresenceEvent, type RedisConfig, type RuntimeConfig, type SearchConversationsArgs, type SearchMessagesArgs, type SendMessageArgs, type SocketConfig$1 as SocketConfig, type SourceType, type Transport, type TransportConfig, type TypingEvent, createConversationId, createConversationModel, createConversationsService, createCursor, createMessageId, createMessageModel, createMessagesService, createModels, createPaginatedResponse, createThreadId, createTransport, ensureIndexes, generateId, getRedisConfig, getRuntimeConfig, initChat, modelRegistry, parseCursor, searchByParticipantPair, searchConversations, searchMessages, setRuntimeConfig, sourceType, validateCreateConversationArgs, validateInitOptions, validateMarkReadArgs, validatePagination, validateSendMessageArgs };

package/dist/index.d.ts

@@ -247,6 +247,22 @@ type SearchConversationsArgs = {
     cursor?: string;
 };
 
+/**
+ * Represents a successful chat start response
+ */
+interface ChatStartedResponse {
+    object: 'ChatStarted';
+    chat_id: string;
+    message_id: string;
+}
+/**
+ * Common response type for chat API operations
+ */
+type ChatApiResponse = ChatStartedResponse | {
+    error: string;
+    details?: unknown;
+};
+
 interface IConversation extends Document {
     organizationId: string;
     participants: Array<{
@@ -359,6 +375,14 @@ interface MessagesService {
         populateSenders: true;
     }): Promise<PaginatedResult<MessageWithSender>>;
     markRead(args: MarkReadArgs): Promise<void>;
+    receiveWhatsappMessage(args: {
+        whatsappChatId: string;
+        message: string;
+    }): Promise<IMessage>;
+    receiveLinkedinMessage(args: {
+        linkedinChatId: string;
+        message: string;
+    }): Promise<IMessage>;
 }
 /**
  * Create messages service
@@ -582,4 +606,4 @@ interface ChatServices {
  */
 declare function initChat(mongooseInstance: typeof mongoose, options: InitOptions, server?: Server): Promise<ChatServices>;
 
-export { type Actor, type ChatServices, type ConversationModel, type ConversationReadEvent, type ConversationsService, type CreateConversationArgs, type EnvironmentConfig, type IConversation, type IMessage, type InitOptions, type ListMessagesArgs, type MarkReadArgs, type MessageCreatedEvent, type MessageModel, type MessageServiceHooks, type MessageWithSender, type MessagesService, type PaginatedResult, type PresenceEvent, type RedisConfig, type RuntimeConfig, type SearchConversationsArgs, type SearchMessagesArgs, type SendMessageArgs, type SocketConfig$1 as SocketConfig, type SourceType, type Transport, type TransportConfig, type TypingEvent, createConversationId, createConversationModel, createConversationsService, createCursor, createMessageId, createMessageModel, createMessagesService, createModels, createPaginatedResponse, createThreadId, createTransport, ensureIndexes, generateId, getRedisConfig, getRuntimeConfig, initChat, modelRegistry, parseCursor, searchByParticipantPair, searchConversations, searchMessages, setRuntimeConfig, sourceType, validateCreateConversationArgs, validateInitOptions, validateMarkReadArgs, validatePagination, validateSendMessageArgs };
+export { type Actor, type ChatApiResponse, type ChatServices, type ChatStartedResponse, type ConversationModel, type ConversationReadEvent, type ConversationsService, type CreateConversationArgs, type EnvironmentConfig, type IConversation, type IMessage, type InitOptions, type ListMessagesArgs, type MarkReadArgs, type MessageCreatedEvent, type MessageModel, type MessageServiceHooks, type MessageWithSender, type MessagesService, type PaginatedResult, type PresenceEvent, type RedisConfig, type RuntimeConfig, type SearchConversationsArgs, type SearchMessagesArgs, type SendMessageArgs, type SocketConfig$1 as SocketConfig, type SourceType, type Transport, type TransportConfig, type TypingEvent, createConversationId, createConversationModel, createConversationsService, createCursor, createMessageId, createMessageModel, createMessagesService, createModels, createPaginatedResponse, createThreadId, createTransport, ensureIndexes, generateId, getRedisConfig, getRuntimeConfig, initChat, modelRegistry, parseCursor, searchByParticipantPair, searchConversations, searchMessages, setRuntimeConfig, sourceType, validateCreateConversationArgs, validateInitOptions, validateMarkReadArgs, validatePagination, validateSendMessageArgs };

package/dist/index.js

@@ -78,6 +78,8 @@ function createConversationModel(options, conn) {
     },
     { timestamps: true }
   );
+  ConversationSchema.index({ linkedinChatId: 1 }, { unique: false, sparse: true });
+  ConversationSchema.index({ whatsappChatId: 1 }, { unique: false, sparse: true });
   const model = conn.model(name, ConversationSchema);
   modelRegistry.set(registryKey, model);
   return model;
@@ -555,6 +557,8 @@ function createMessagesService(models, hooks = {}) {
       const tasks = [];
       let lastLinkedInId;
       let lastWhatsAppId;
+      let linkedinChatId;
+      let whatsappChatId;
       if (Array.isArray(source) && source.includes("linkedin")) {
         const LinkedinConnector = connectorIds && connectorIds.linkedin;
         lastLinkedInId = LinkedinConnector == null ? void 0 : LinkedinConnector.connectorId;
@@ -563,10 +567,18 @@ function createMessagesService(models, hooks = {}) {
             name: "linkedin",
             run: async () => {
               const path = paths.linkedin.startChat(String(LinkedinConnector.connectorId));
-              await getAxios().post(path, {
-                linkedin_url: LinkedinConnector.contactId,
-                text
-              });
+              try {
+                const res = await getAxios().post(path, {
+                  linkedin_url: LinkedinConnector.contactId,
+                  text
+                });
+                const data = res.data;
+                console.log("linkedinChatId", data);
+                linkedinChatId = data.chat_data.chat_id;
+                return { status: "fulfilled", value: data };
+              } catch (error) {
+                return { status: "rejected", reason: error };
+              }
             }
           });
         } else {
@@ -587,7 +599,14 @@ function createMessagesService(models, hooks = {}) {
                 phone_numbers: sanitize(raw),
                 text
               };
-              await getAxios().post(path, body);
+              try {
+                const res = await getAxios().post(path, body);
+                const data = res.data;
+                whatsappChatId = data.chat_id;
+                return { status: "fulfilled", value: data };
+              } catch (error) {
+                return { status: "rejected", reason: error };
+              }
             }
           });
         } else {
@@ -596,22 +615,21 @@ function createMessagesService(models, hooks = {}) {
       }
       if (tasks.length > 0) {
         const results = await Promise.allSettled(tasks.map((t) => t.run()));
-        results.forEach((res, idx) => {
+        results.forEach((result, idx) => {
+          var _a, _b, _c, _d, _e, _f;
           const name = tasks[idx].name;
-          if (res.status === "fulfilled") {
+          if (result.status === "fulfilled") {
             success_source.push(name);
           } else {
-            const err = success_source;
-            res.reason.response.data.detail || res.reason.response.data || "Unknown error";
+            const error = ((_c = (_b = (_a = result.reason) == null ? void 0 : _a.response) == null ? void 0 : _b.data) == null ? void 0 : _c.detail) || ((_e = (_d = result.reason) == null ? void 0 : _d.response) == null ? void 0 : _e.data) || ((_f = result.reason) == null ? void 0 : _f.message) || "Unknown error";
             failed_source.push({
               source: name,
-              message: typeof err === "string" ? err : JSON.stringify(err)
+              message: typeof error === "string" ? error : JSON.stringify(error)
             });
+            console.error(`${name} failed:`, error);
           }
         });
-        console.log("results", results);
       }
-      console.log("success_source", success_source);
       const message = new Message({
         organizationId,
         conversationId,
@@ -632,6 +650,8 @@ function createMessagesService(models, hooks = {}) {
       };
       if (lastLinkedInId) conversationUpdate.lastLinkedInId = lastLinkedInId;
       if (lastWhatsAppId) conversationUpdate.lastWhatsAppId = lastWhatsAppId;
+      if (linkedinChatId) conversationUpdate.linkedinChatId = linkedinChatId;
+      if (whatsappChatId) conversationUpdate.whatsappChatId = whatsappChatId;
       await Conversation.findByIdAndUpdate(conversationId, {
         $set: conversationUpdate
       });
@@ -641,6 +661,86 @@ function createMessagesService(models, hooks = {}) {
       message.failed_source = failed_source;
       return message;
     },
+    /**
+     * Receive a new message by whatsappChatId
+     */
+    async receiveWhatsappMessage({ whatsappChatId, message }) {
+      const conversation = await Conversation.findOne({ whatsappChatId }).lean();
+      if (!conversation) {
+        throw new Error("Conversation not found for given whatsappChatId");
+      }
+      const applicationParticipant = conversation.participants.find(
+        (p) => p.entityModel === "Application"
+      );
+      if (!applicationParticipant) {
+        throw new Error("Application participant not found in conversation");
+      }
+      const orgId = conversation.organizationId;
+      const senderModel = "Application";
+      const senderId = applicationParticipant.entityId;
+      const msgDoc = new Message({
+        organizationId: orgId,
+        conversationId: String(conversation._id),
+        senderModel,
+        senderId,
+        text: message,
+        kind: "text",
+        source: ["whatsapp"],
+        parentMessageId: void 0,
+        rootThreadId: void 0
+      });
+      await msgDoc.save();
+      await Conversation.findByIdAndUpdate(conversation._id, {
+        $set: {
+          lastMessageAt: msgDoc.createdAt,
+          lastMessagePreview: message.substring(0, 100),
+          lastMessageSenderId: senderId,
+          lastMessageSenderModel: senderModel
+        }
+      });
+      if (onMessageCreated) onMessageCreated(msgDoc);
+      return msgDoc;
+    },
+    /**
+     * Receive a new message by linkedinChatId
+     */
+    async receiveLinkedinMessage({ linkedinChatId, message }) {
+      const conversation = await Conversation.findOne({ linkedinChatId }).lean();
+      if (!conversation) {
+        throw new Error("Conversation not found for given linkedinChatId");
+      }
+      const applicationParticipant = conversation.participants.find(
+        (p) => p.entityModel === "Application"
+      );
+      if (!applicationParticipant) {
+        throw new Error("Application participant not found in conversation");
+      }
+      const orgId = conversation.organizationId;
+      const senderModel = "Application";
+      const senderId = applicationParticipant.entityId;
+      const msgDoc = new Message({
+        organizationId: orgId,
+        conversationId: String(conversation._id),
+        senderModel,
+        senderId,
+        text: message,
+        kind: "text",
+        source: ["linkedin"],
+        parentMessageId: void 0,
+        rootThreadId: void 0
+      });
+      await msgDoc.save();
+      await Conversation.findByIdAndUpdate(conversation._id, {
+        $set: {
+          lastMessageAt: msgDoc.createdAt,
+          lastMessagePreview: message.substring(0, 100),
+          lastMessageSenderId: senderId,
+          lastMessageSenderModel: senderModel
+        }
+      });
+      if (onMessageCreated) onMessageCreated(msgDoc);
+      return msgDoc;
+    },
     /**
      * List messages for a conversation with pagination
      * @param args Message listing arguments