wexa-chat 0.2.9 → 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

@@ -375,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

package/dist/index.d.ts

@@ -375,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

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;
@@ -659,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