wexa-chat 0.2.1 → 0.2.2

package/README.md

@@ -121,7 +121,7 @@ export type InitOptions = {
   - `searchByParticipantPair({ organizationId, a, b })`
 
 - Messages
-  - `sendMessage({ organizationId, conversationId, senderModel, senderId, text, source, kind?, parentMessageId?, rootThreadId? })`
+  - `sendMessage({ organizationId, conversationId, senderModel, senderId, text, source, kind?, parentMessageId?, rootThreadId?, connectorIds? })`
   - `listMessages({ organizationId, conversationId, limit?, cursor? })`
   - `listMessagesWithSenders({ organizationId, conversationId, limit?, cursor?, populateSenders: true, populateOptions? })`
   - `markRead({ organizationId, conversationId, participantModel, participantId, messageId })`
@@ -209,9 +209,9 @@ The method returns messages sorted by creation time (newest first), making it id
 
 The type `MessageWithSender` is exported from the package for proper TypeScript support.
 
-### Message Source
+### Sending messages and connectors
 
-Messages now include a required `source` field (array) to indicate one or more origins for a message. The model enforces `source` values via an enum of strings:
+Messages include a required `source` field (array) to indicate one or more origins for a message. Valid values are enforced by an enum of strings:
 
 ```ts
 export const sourceType = {
@@ -224,8 +224,35 @@ export const sourceType = {
 export type SourceType = (typeof sourceType)[keyof typeof sourceType];
 ```
 
-When sending a message via `sendMessage`, you must provide `source: SourceType[]`.
-For internal server-generated messages, use `[sourceType.CORE]`.
+When sending a message via `sendMessage`, you must provide `source: SourceType[]`. For internal server‑generated messages, use `[sourceType.CORE]`.
+
+If you include external connectors in the `source` (e.g., `linkedin`, `whatsapp`), you can optionally pass `connectorIds` to perform the external send and to persist identifiers for quick follow‑ups:
+
+```ts
+await chat.services.messages.sendMessage({
+  organizationId: 'org-123',
+  conversationId: 'conv-456',
+  senderModel: 'User',
+  senderId: 'user-1',
+  text: 'Hello from Wexa',
+  source: [sourceType.CORE, sourceType.LINKEDIN, sourceType.WHATSAPP],
+  connectorIds: {
+    linkedin: { connectorId: 'ln-connector-1', contactId: 'https://linkedin.com/in/someone' },
+    whatsapp: { connectorId: 'wa-connector-1', contactId: '+1 234 567 8901' },
+  },
+});
+```
+
+Under the hood (`src/services/messages.service.ts`):
+
+- LinkedIn: posts to the LinkedIn connector with `{ linkedin_url, text }`.
+- WhatsApp: posts to the WhatsApp connector with `{ phone_numbers, text }` (phone is sanitized to remove spaces and a leading `+`).
+- Each external task runs concurrently. A successful task's `source` remains in the stored message. Failures are collected into a `failed_source` array attached to the returned message instance at runtime: `message.failed_source: Array<{ source: string; message: string }>`.
+- The conversation document is updated with last message metadata and, when applicable, with connector identifiers:
+  - `lastLinkedInId: string` — set from `connectorIds.linkedin.contactId` when `source` includes `linkedin`.
+  - `lastWhatsAppId: string` — set from a sanitized `connectorIds.whatsapp.contactId` when `source` includes `whatsapp`.
+
+This allows subsequent UI actions to prefill the last known contact handles for LinkedIn and WhatsApp.
 
 ## Models
 

package/dist/index.d.cts

@@ -259,6 +259,8 @@ interface IConversation extends Document {
     lastMessagePreview?: string;
     lastMessageSenderId?: string;
     lastMessageSenderModel?: string;
+    lastLinkedInId?: string;
+    lastWhatsAppId?: string;
     metadata?: Record<string, any>;
     createdAt: Date;
     updatedAt: Date;

package/dist/index.d.ts

@@ -259,6 +259,8 @@ interface IConversation extends Document {
     lastMessagePreview?: string;
     lastMessageSenderId?: string;
     lastMessageSenderModel?: string;
+    lastLinkedInId?: string;
+    lastWhatsAppId?: string;
     metadata?: Record<string, any>;
     createdAt: Date;
     updatedAt: Date;

package/dist/index.js

@@ -70,6 +70,8 @@ function createConversationModel(options, conn) {
       lastMessagePreview: String,
       lastMessageSenderId: String,
       lastMessageSenderModel: String,
+      lastLinkedInId: String,
+      lastWhatsAppId: String,
       metadata: Schema.Types.Mixed
     },
     { timestamps: true }
@@ -549,8 +551,11 @@ function createMessagesService(models, hooks = {}) {
       const success_source = ["core"];
       const failed_source = [];
       const tasks = [];
+      let lastLinkedInId;
+      let lastWhatsAppId;
       if (Array.isArray(source) && source.includes("linkedin")) {
         const LinkedinConnector = connectorIds && connectorIds.linkedin;
+        lastLinkedInId = LinkedinConnector == null ? void 0 : LinkedinConnector.connectorId;
         if (LinkedinConnector) {
           tasks.push({
             name: "linkedin",
@@ -568,6 +573,7 @@ function createMessagesService(models, hooks = {}) {
       }
       if (Array.isArray(source) && source.includes("whatsapp")) {
         const whatsappConnector = connectorIds && connectorIds.whatsapp;
+        lastWhatsAppId = whatsappConnector == null ? void 0 : whatsappConnector.connectorId;
         if (whatsappConnector) {
           tasks.push({
             name: "whatsapp",
@@ -613,13 +619,16 @@ function createMessagesService(models, hooks = {}) {
         rootThreadId: rootThreadId || parentMessageId
       });
       await message.save();
+      const conversationUpdate = {
+        lastMessageAt: message.createdAt,
+        lastMessagePreview: text.substring(0, 100),
+        lastMessageSenderId: senderId,
+        lastMessageSenderModel: senderModel
+      };
+      if (lastLinkedInId) conversationUpdate.lastLinkedInId = lastLinkedInId;
+      if (lastWhatsAppId) conversationUpdate.lastWhatsAppId = lastWhatsAppId;
       await Conversation.findByIdAndUpdate(conversationId, {
-        $set: {
-          lastMessageAt: message.createdAt,
-          lastMessagePreview: text.substring(0, 100),
-          lastMessageSenderId: senderId,
-          lastMessageSenderModel: senderModel
-        }
+        $set: conversationUpdate
       });
       if (onMessageCreated) {
         onMessageCreated(message);