@antzsoft/chat-core 1.3.7 → 1.3.8

package/README.md

@@ -2656,6 +2656,7 @@ Returned by `messagesApi.getReceipts()`. Use as the initial load for a "Read by
 ```typescript
 interface MessageReceiptEntry {
   userId: string;
+  externalId?: string;    // external system user ID (non-builtin modes)
   displayName: string;
   avatarUrl?: string;
 }
@@ -2685,6 +2686,7 @@ Returned by `messagesApi.getReactions()`. Use as the data source for a reactions
 ```typescript
 interface ReactionUser {
   userId: string;
+  externalId?: string;    // external system user ID (non-builtin modes)
   displayName: string;
   avatarUrl?: string;
 }
@@ -2801,6 +2803,7 @@ interface MessageConfig {
 ```typescript
 interface Participant {
   userId: string;
+  externalId?: string;    // external system user ID (non-builtin modes); mirrored on user.externalId
   role: 'admin' | 'member';
   joinedAt: string;
   isActive?: boolean;
@@ -2893,6 +2896,7 @@ interface ReactionUpdatedEvent {
 interface TypingIndicatorEvent {
   conversationId: string;
   userId: string;
+  externalId?: string;    // external system user ID (non-builtin modes); absent in builtin mode
   username: string;
   displayName: string;
   avatarUrl?: string;
@@ -3056,6 +3060,18 @@ document.querySelectorAll('[data-conv-id]').forEach((el) => {
 
 ## Changelog
 
+### v1.3.8
+
+- **`externalId` now surfaced on every embedded user shape, not just the standalone user profile.** Previously `externalId` (the user's ID in your external system, non-builtin modes) was only present on `User` returned from `usersApi.list/getById/updateProfile`. Every *denormalized* place a user appeared — conversation participants, message sender, reaction users, and read/delivery receipts — dropped it, forcing a separate `usersApi.getById()` call to map a chat user back to your own system. Those shapes now carry `externalId`:
+
+  - **`Participant`** — new top-level `externalId?` field, also mirrored onto `Participant.user.externalId`. (`conversationsApi` + conversation socket events.)
+  - **`Message.sender`** — now includes `externalId` (it is a `User`, so the field was always in the type; the server now populates it on the embed).
+  - **`ReactionUser`** (`messagesApi.getReactions`) — new `externalId?`.
+  - **`MessageReceiptEntry`** (`messagesApi.getReceipts`) — new `externalId?`.
+  - **`TypingIndicatorEvent`** (socket) — new `externalId?`. Present in non-builtin modes; **absent in builtin mode**, where no external identity exists.
+
+  **Backward compatible, additive-only.** Every field is optional (`externalId?`). An older SDK against this server simply ignores the extra field; this SDK against an older server sees `externalId` as `undefined`. Note `externalId` (a string, the chat user's external identity) is distinct from the pre-existing `Participant`-level `externalUserId` (a number) — both are sent; do not confuse them. Requires server v-with-this-change or newer to be populated; safe to upgrade regardless. **No integration changes required** — read `externalId` where you previously had to look it up separately.
+
 ### v1.3.7
 
 - **Docs only — no code changes.** Brought the docs fully up to date: added the missing

package/dist/index.cjs

@@ -1105,11 +1105,13 @@ function normalizeParticipant(p) {
   const hasUserDetails = p.displayName || p.username || p.avatarUrl;
   return {
     userId: p.userId,
+    externalId: p.externalId ?? p.user?.externalId,
     role: p.role,
     joinedAt: p.joinedAt,
     isActive: p.isActive,
     user: hasUserDetails ? {
       id: p.userId,
+      externalId: p.externalId,
       tenantId: "",
       email: "",
       username: p.username ?? "",