easemob-websdk 5.1.2 → 5.2.0

package/managers/user-info/index.js

@@ -1 +1 @@
-import{i as e}from"../../chunks/cache-utils-B99glc0H.js";import{a as t}from"../../chunks/profile-version-DLMz8lqW.js";import{p as r,E as s,V as a,l as n,S as o,h as i,m as d,j as u}from"../../chunks/common-BvlDAw4a.js";import{c,b as l,a as p,d as h,e as f,f as m,g as b,h as y,i as I}from"../../chunks/user-info-AlshAvdy.js";import{a as g}from"../../chunks/event-system-B62vbKqG.js";const U=e=>{const{orgName:t,appName:s}=r(e.appKey);return`/${t}/${s}/user/${encodeURIComponent(e.userId)}/metadata/subscription`},_=(e,t="params.userIds")=>c(e,t),w=e=>{const t=_(e);if(t.length>100)throw((e,t,r,n=s.VALIDATION_INVALID_FORMAT)=>new a(e,{code:n,details:{fields:[{path:t,message:e,rule:r}]}}))("params.userIds must contain at most 100 unique users","params.userIds","range",s.SERVICE_LIMIT_EXCEEDED);return{usernames:t}},v=(e,t)=>{const r=(e=>_(e))(t);return`${U(e)}?usernames=${r.map(e=>encodeURIComponent(e)).join(",")}`},S=(e,t)=>{switch(e){case"nickname":return"string"==typeof t?{nickname:t}:null;case"avatarurl":case"avatarUrl":return"string"==typeof t?{avatarUrl:t}:null;case"mail":return"string"==typeof t?{mail:t}:null;case"phone":return"string"==typeof t?{phone:t}:null;case"gender":return"string"==typeof t||"number"==typeof t||"boolean"==typeof t?{gender:t}:null;case"sign":return"string"==typeof t?{sign:t}:null;case"birth":return"string"==typeof t?{birth:t}:null;case"ext":return"string"==typeof t?{ext:t}:null;default:return null}},C=["nickname","avatarUrl","mail","phone","gender","sign","birth","ext"],x=d(u,{common:{},apis:{updateOwnUserInfo:{range:"4,110,204,303,505,901",localErrors:{updateOwnInfo:{validation_invalid:{code:110,retryable:!1}},updateOwnInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{service_not_enabled:{code:505,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"user metadata service not allow"},data_length_exceed:{code:901,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"exceeds"},concurrent_update_conflict:{code:303,httpStatus:409,retryable:!0,matchField:"desc",matchPattern:"Concurrent"},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},updateOwnInfo:{range:"4,110,204,303,505,901",localErrors:{updateOwnInfo:{validation_invalid:{code:110,retryable:!1}},updateOwnInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{service_not_enabled:{code:505,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"user metadata service not allow"},data_length_exceed:{code:901,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"exceeds"},concurrent_update_conflict:{code:303,httpStatus:409,retryable:!0,matchField:"desc",matchPattern:"Concurrent"},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},updateOwnInfoByAttribute:{range:"4,110,204,303,505,901",localErrors:{updateOwnInfo:{validation_invalid:{code:110,retryable:!1}},updateOwnInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{service_not_enabled:{code:505,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"user metadata service not allow"},data_length_exceed:{code:901,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"exceeds"},concurrent_update_conflict:{code:303,httpStatus:409,retryable:!0,matchField:"desc",matchPattern:"Concurrent"},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},getUserInfoByUserId:{range:"4,110,204,900",localErrors:{getUserInfoByUserId:{validation_invalid:{code:110,retryable:!1}}},errors:{usercount_exceed:{code:900,httpStatus:400,retryable:!1},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},getUserInfoByAttribute:{range:"4,110,204,900",localErrors:{getUserInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{usercount_exceed:{code:900,httpStatus:400,retryable:!1},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},subscribeUsersInfo:{range:"4,202,210,303,1600,1601",errors:{unauthorized:{code:202,httpStatus:401,retryable:!0},forbidden:{code:210,httpStatus:403,aliases:["operation forbidden"],matchField:"error_description",matchPattern:"metadata subscription not allow",retryable:!1},subscriber_limit_exceeded:{code:1600,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscription count exceeds limit",retryable:!1},target_limit_exceeded:{code:1601,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscribed count exceeds limit",retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0},server_unknown_error:{code:303,httpStatus:500,retryable:!0}}},unsubscribeUsersInfo:{range:"4,202,210,303,1600,1601",errors:{unauthorized:{code:202,httpStatus:401,retryable:!0},forbidden:{code:210,httpStatus:403,aliases:["operation forbidden"],matchField:"error_description",matchPattern:"metadata subscription not allow",retryable:!1},subscriber_limit_exceeded:{code:1600,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscription count exceeds limit",retryable:!1},target_limit_exceeded:{code:1601,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscribed count exceeds limit",retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0},server_unknown_error:{code:303,httpStatus:500,retryable:!0}}},getSubscribedUsers:{range:"4,202,210,303,1600,1601",errors:{unauthorized:{code:202,httpStatus:401,retryable:!0},forbidden:{code:210,httpStatus:403,aliases:["operation forbidden"],matchField:"error_description",matchPattern:"metadata subscription not allow",retryable:!1},subscriber_limit_exceeded:{code:1600,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscription count exceeds limit",retryable:!1},target_limit_exceeded:{code:1601,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscribed count exceeds limit",retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0},server_unknown_error:{code:303,httpStatus:500,retryable:!0}}}}}),O=class{constructor(){this.capabilities=["userInfo:read","rawNotify:userInfo"],this.client=null,this.eventContext=null,this.restClient=null,this.restBaseUrl=null,this.restToken=null}bind(e,t){this.client=e,this.eventContext=t??null}addEventHandler(e,t){this.eventContext?.addEventHandler(e,t)}removeEventHandler(e){this.eventContext?.removeEventHandler(e)}handleRawNotify(e){if("userInfo"!==e.type)return;const t=this.client,r=t?.getCacheManager();if(!t||!r||!t.getCurrentUserId())return;const s=e.payload,a=(e=>{const t={};for(const[r,s]of Object.entries(e.metadata)){const e=S(r,s);e&&Object.assign(t,e)}return{userId:e.userId,attributes:t,lastModified:e.lastModified,source:"subscribe_metadata_updated"===e.notifyType?"subscription":"contact_metadata_updated"===e.notifyType?"contact":"own"}})(s);if(!a)return;const o=r.applyUserInfoNotifyPatch(a);if(!o.applied)return void n.debug("User-info notify ignored",{userId:a.userId,notifyType:s.notifyType,reason:o.reason,lastModified:a.lastModified});if(r.updateUserInfoSummaryFromRuntime(a.userId),t.refreshConversationDisplayFromUserInfos?.([{userId:a.userId,lastModified:a.lastModified}]),"subscription"===a.source)return void this.eventContext?.dispatch?.("onUserInfoUpdated",[o.record.profile]);if("own"===a.source)return void this.eventContext?.dispatch?.("onOwnInfoUpdated",o.record.profile);const i=t.getContactSnapshot()?.items.find(e=>e.userId===a.userId);this.eventContext?.dispatch?.(g.CONTACT_INFO_UPDATED,{userInfo:o.record.profile,contact:i})}async getUserInfoByUserId(e){return this.runOperation("getUserInfoByUserId",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=l(c(e.userIds,"params.userIds")),a=p(t);n.debug("UserInfoManager getUserInfoByUserId",{userIds:s.targets});const o=await r.request(a,{method:"POST",body:s,operation:"getUserInfoByUserId"}),i=this.normalizeFetchEnvelope(o,s.targets);return this.writeCache(i),this.completeFetchedProfiles(i,s.targets)})}async getUserInfoByAttribute(e){return this.runOperation("getUserInfoByAttribute",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=h(c(e.userIds,"params.userIds"),f(e.attributes,"params.attributes")),a=p(t);n.debug("UserInfoManager getUserInfoByAttribute",{userIds:s.targets,attributes:s.properties});const o=await r.request(a,{method:"POST",body:s,operation:"getUserInfoByAttribute"}),i=this.normalizeFetchEnvelope(o,s.targets);return this.writeCache(i),this.completeFetchedProfiles(i,s.targets)})}async subscribeUsersInfo(e){return this.runOperation("subscribeUsersInfo",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=(e=>U(e))(t),a=w(e.userIds);n.debug("UserInfoManager subscribeUsersInfo",{userIds:a.usernames}),await r.request(s,{method:"POST",body:a,operation:"subscribeUsersInfo"})})}async unsubscribeUsersInfo(e){return this.runOperation("unsubscribeUsersInfo",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=v(t,e.userIds);n.debug("UserInfoManager unsubscribeUsersInfo",{userIds:c(e.userIds,"params.userIds")}),await r.request(s,{method:"DELETE",operation:"unsubscribeUsersInfo"})})}async getSubscribedUsers(){return this.runOperation("getSubscribedUsers",async()=>{const e=this.getRestContextOrThrow(),t=this.getRestClient(e),r=(e=>U(e))(e);n.debug("UserInfoManager getSubscribedUsers",{userId:e.userId});const s=(e=>{const t=e&&"object"==typeof e?e:null;if(!t||!Array.isArray(t.data))return[];const r=[],s=/* @__PURE__ */new Set;for(const a of t.data){if("string"!=typeof a)continue;const e=a.trim();e&&!s.has(e)&&(s.add(e),r.push(e))}return r})(await t.request(r,{method:"GET",operation:"getSubscribedUsers"}));return 0===s.length?[]:await this.getUserInfoByUserId({userIds:s})})}async updateOwnInfo(e){return this.runOperation("updateOwnInfo",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=m(e),a=b(t);n.debug("UserInfoManager updateOwnInfo",{userId:t.userId,fields:this.getUpdatedFieldNames(e)});const o=await r.request(a,{method:"PUT",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:s,operation:"updateOwnInfo"}),i=this.normalizeUpdateEnvelope(o,t.userId,this.buildFallbackProfile(t.userId,e));return this.writeCache([i]),this.dispatchSelfUpdate(i.profile),i.profile})}async updateOwnInfoByAttribute(e,t){return this.runOperation("updateOwnInfoByAttribute",async()=>{const r=this.getRestContextOrThrow(),s=this.getRestClient(r),a=y(e,t),o=b(r);n.debug("UserInfoManager updateOwnInfoByAttribute",{userId:r.userId,attribute:e});const i=await s.request(o,{method:"PUT",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:a,operation:"updateOwnInfoByAttribute"}),d=this.normalizeUpdateEnvelope(i,r.userId,{userId:r.userId,[e]:t});return this.writeCache([d]),this.dispatchSelfUpdate(d.profile),d.profile})}async runOperation(e,t){try{return await t()}catch(r){throw this.normalizeOperationError(e,r)}}normalizeOperationError(e,t){return t instanceof o?t:(n.warn("UserInfoManager operation failed",{operation:e,message:t instanceof Error?t.message:String(t)}),new o(`${e} failed`))}getRestContextOrThrow(){if(this.client)return this.client.getRestContext();throw new a("UserInfoManager is not bound to client",{code:s.VALIDATION_REQUIRED,details:{fields:[{path:"userInfoManager.client",message:"client is required",rule:"required"}]}})}getRestClient(e){return this.restClient&&this.restBaseUrl===e.restBaseUrl&&this.restToken===e.token||(this.restClient=new i(e.restBaseUrl,{errorMap:x,requestAdapter:this.client?.getRequestAdapter?.(),includeRequestId:!0}),this.restClient.setAuthToken(e.token),this.restBaseUrl=e.restBaseUrl,this.restToken=e.token),this.restClient}normalizeFetchEnvelope(e,t){return I(e,t)}completeFetchedProfiles(e,t){const r=new Map(e.map(e=>[e.profile.userId,e.profile]));return t.map(e=>r.get(e)??{userId:e})}normalizeUpdateEnvelope(t,r,s){const a=e(t)?t:null,n=(a&&e(a.data)?a.data:null)??(a&&this.looksLikeUserInfoAttributes(a)?a:null),o=a&&"number"==typeof a.lastModified?a.lastModified:void 0;return{profile:n?this.toUserInfo(r,n):{userId:r,...s??{}},lastModified:o}}toUserInfo(e,t){const r={userId:e};return"string"==typeof t.nickname&&(r.nickname=t.nickname),"string"==typeof t.avatarurl?r.avatarUrl=t.avatarurl:"string"==typeof t.avatarUrl&&(r.avatarUrl=t.avatarUrl),"string"==typeof t.mail&&(r.mail=t.mail),"string"==typeof t.phone&&(r.phone=t.phone),"string"!=typeof t.gender&&"number"!=typeof t.gender&&"boolean"!=typeof t.gender||(r.gender=t.gender),"string"==typeof t.sign&&(r.sign=t.sign),"string"==typeof t.birth&&(r.birth=t.birth),"string"==typeof t.ext&&(r.ext=t.ext),r}looksLikeUserInfoAttributes(t){return!!e(t)&&("nickname"in t||"avatarurl"in t||"avatarUrl"in t||"mail"in t||"phone"in t||"gender"in t||"sign"in t||"birth"in t||"ext"in t)}buildFallbackProfile(e,t){const r={userId:e},s=r;for(const a of C)a in t&&(s[a]=t[a]);return r}getUpdatedFieldNames(e){return C.filter(t=>t in e)}projectToSummary(e){const r=Date.now(),s=t(e.lastModified);return{userId:e.profile.userId,nickname:e.profile.nickname,avatarUrl:e.profile.avatarUrl,sign:e.profile.sign,ext:e.profile.ext,userInfoUpdateTime:s,lastSyncAt:r,lastAccess:r,lastUpdate:e.lastModified??r}}writeCache(e){if(!this.client||0===e.length)return;const t=this.client.getCacheManager();t&&("function"==typeof t.upsertRuntimeUserInfos&&t.upsertRuntimeUserInfos(e.map(e=>({profile:e.profile,lastModified:e.lastModified,source:e.profile.userId===this.client?.getRestContext().userId?"update":"fetch"}))),t.setUserInfoSummaries(e.map(e=>this.projectToSummary(e))))}dispatchSelfUpdate(e){this.client?.dispatchOwnInfoUpdated?.(e)}};O.key="userInfoManager";let T=O;export{T as UserInfoManager};
+import{i as e}from"../../chunks/cache-utils-B99glc0H.js";import{a as t}from"../../chunks/profile-version-DLMz8lqW.js";import{p as r,E as s,V as a,l as n,S as o,R as i,m as d,C as u}from"../../chunks/common-gbNWJrBc.js";import{c,b as l,a as p,d as h,e as f,f as m,g as b,h as y,i as I}from"../../chunks/user-info-BkqJHgja.js";import{a as g}from"../../chunks/event-system-DguqwFpc.js";const U=e=>{const{orgName:t,appName:s}=r(e.appKey);return`/${t}/${s}/user/${encodeURIComponent(e.userId)}/metadata/subscription`},_=(e,t="params.userIds")=>c(e,t),w=e=>{const t=_(e);if(t.length>100)throw((e,t,r,n=s.VALIDATION_INVALID_FORMAT)=>new a(e,{code:n,details:{fields:[{path:t,message:e,rule:r}]}}))("params.userIds must contain at most 100 unique users","params.userIds","range",s.SERVICE_LIMIT_EXCEEDED);return{usernames:t}},v=(e,t)=>{const r=(e=>_(e))(t);return`${U(e)}?usernames=${r.map(e=>encodeURIComponent(e)).join(",")}`},S=(e,t)=>{switch(e){case"nickname":return"string"==typeof t?{nickname:t}:null;case"avatarurl":case"avatarUrl":return"string"==typeof t?{avatarUrl:t}:null;case"mail":return"string"==typeof t?{mail:t}:null;case"phone":return"string"==typeof t?{phone:t}:null;case"gender":return"string"==typeof t||"number"==typeof t||"boolean"==typeof t?{gender:t}:null;case"sign":return"string"==typeof t?{sign:t}:null;case"birth":return"string"==typeof t?{birth:t}:null;case"ext":return"string"==typeof t?{ext:t}:null;default:return null}},C=["nickname","avatarUrl","mail","phone","gender","sign","birth","ext"],x=d(u,{common:{},apis:{updateOwnUserInfo:{range:"4,110,204,303,505,901",localErrors:{updateOwnInfo:{validation_invalid:{code:110,retryable:!1}},updateOwnInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{service_not_enabled:{code:505,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"user metadata service not allow"},data_length_exceed:{code:901,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"exceeds"},concurrent_update_conflict:{code:303,httpStatus:409,retryable:!0,matchField:"desc",matchPattern:"Concurrent"},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},updateOwnInfo:{range:"4,110,204,303,505,901",localErrors:{updateOwnInfo:{validation_invalid:{code:110,retryable:!1}},updateOwnInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{service_not_enabled:{code:505,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"user metadata service not allow"},data_length_exceed:{code:901,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"exceeds"},concurrent_update_conflict:{code:303,httpStatus:409,retryable:!0,matchField:"desc",matchPattern:"Concurrent"},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},updateOwnInfoByAttribute:{range:"4,110,204,303,505,901",localErrors:{updateOwnInfo:{validation_invalid:{code:110,retryable:!1}},updateOwnInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{service_not_enabled:{code:505,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"user metadata service not allow"},data_length_exceed:{code:901,httpStatus:403,retryable:!1,matchField:"desc",matchPattern:"exceeds"},concurrent_update_conflict:{code:303,httpStatus:409,retryable:!0,matchField:"desc",matchPattern:"Concurrent"},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},getUserInfoByUserId:{range:"4,110,204,900",localErrors:{getUserInfoByUserId:{validation_invalid:{code:110,retryable:!1}}},errors:{usercount_exceed:{code:900,httpStatus:400,retryable:!1},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},getUserInfoByAttribute:{range:"4,110,204,900",localErrors:{getUserInfoByAttribute:{validation_invalid:{code:110,retryable:!1}}},errors:{usercount_exceed:{code:900,httpStatus:400,retryable:!1},resource_not_found:{code:204,httpStatus:404,retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0}}},subscribeUsersInfo:{range:"4,202,210,303,1600,1601",errors:{unauthorized:{code:202,httpStatus:401,retryable:!0},forbidden:{code:210,httpStatus:403,aliases:["operation forbidden"],matchField:"error_description",matchPattern:"metadata subscription not allow",retryable:!1},subscriber_limit_exceeded:{code:1600,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscription count exceeds limit",retryable:!1},target_limit_exceeded:{code:1601,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscribed count exceeds limit",retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0},server_unknown_error:{code:303,httpStatus:500,retryable:!0}}},unsubscribeUsersInfo:{range:"4,202,210,303,1600,1601",errors:{unauthorized:{code:202,httpStatus:401,retryable:!0},forbidden:{code:210,httpStatus:403,aliases:["operation forbidden"],matchField:"error_description",matchPattern:"metadata subscription not allow",retryable:!1},subscriber_limit_exceeded:{code:1600,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscription count exceeds limit",retryable:!1},target_limit_exceeded:{code:1601,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscribed count exceeds limit",retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0},server_unknown_error:{code:303,httpStatus:500,retryable:!0}}},getSubscribedUsers:{range:"4,202,210,303,1600,1601",errors:{unauthorized:{code:202,httpStatus:401,retryable:!0},forbidden:{code:210,httpStatus:403,aliases:["operation forbidden"],matchField:"error_description",matchPattern:"metadata subscription not allow",retryable:!1},subscriber_limit_exceeded:{code:1600,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscription count exceeds limit",retryable:!1},target_limit_exceeded:{code:1601,httpStatus:400,matchField:"error_description",matchPattern:"metadata subscribed count exceeds limit",retryable:!1},rate_limit:{code:4,httpStatus:429,retryable:!0},server_unknown_error:{code:303,httpStatus:500,retryable:!0}}}}}),O=class{constructor(){this.capabilities=["userInfo:read","rawNotify:userInfo"],this.client=null,this.eventContext=null,this.restClient=null,this.restBaseUrl=null,this.restToken=null}bind(e,t){this.client=e,this.eventContext=t??null}addEventHandler(e,t){this.eventContext?.addEventHandler(e,t)}removeEventHandler(e){this.eventContext?.removeEventHandler(e)}handleRawNotify(e){if("userInfo"!==e.type)return;const t=this.client,r=t?.getCacheManager();if(!t||!r||!t.getCurrentUserId())return;const s=e.payload,a=(e=>{const t={};for(const[r,s]of Object.entries(e.metadata)){const e=S(r,s);e&&Object.assign(t,e)}return{userId:e.userId,attributes:t,lastModified:e.lastModified,source:"subscribe_metadata_updated"===e.notifyType?"subscription":"contact_metadata_updated"===e.notifyType?"contact":"own"}})(s);if(!a)return;const o=r.applyUserInfoNotifyPatch(a);if(!o.applied)return void n.debug("User-info notify ignored",{userId:a.userId,notifyType:s.notifyType,reason:o.reason,lastModified:a.lastModified});if(r.updateUserInfoSummaryFromRuntime(a.userId),t.refreshConversationDisplayFromUserInfos?.([{userId:a.userId,lastModified:a.lastModified}]),"subscription"===a.source)return void this.eventContext?.dispatch?.("onUserInfoUpdated",[o.record.profile]);if("own"===a.source)return void this.eventContext?.dispatch?.("onOwnInfoUpdated",o.record.profile);const i=t.getContactSnapshot()?.items.find(e=>e.userId===a.userId);this.eventContext?.dispatch?.(g.CONTACT_INFO_UPDATED,{userInfo:o.record.profile,contact:i})}async getUserInfoByUserId(e){return this.runOperation("getUserInfoByUserId",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=l(c(e.userIds,"params.userIds")),a=p(t);n.debug("UserInfoManager getUserInfoByUserId",{userIds:s.targets});const o=await r.request(a,{method:"POST",body:s,operation:"getUserInfoByUserId"}),i=this.normalizeFetchEnvelope(o,s.targets);return this.writeCache(i),this.completeFetchedProfiles(i,s.targets)})}async getUserInfoByAttribute(e){return this.runOperation("getUserInfoByAttribute",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=h(c(e.userIds,"params.userIds"),f(e.attributes,"params.attributes")),a=p(t);n.debug("UserInfoManager getUserInfoByAttribute",{userIds:s.targets,attributes:s.properties});const o=await r.request(a,{method:"POST",body:s,operation:"getUserInfoByAttribute"}),i=this.normalizeFetchEnvelope(o,s.targets);return this.writeCache(i),this.completeFetchedProfiles(i,s.targets)})}async subscribeUsersInfo(e){return this.runOperation("subscribeUsersInfo",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=(e=>U(e))(t),a=w(e.userIds);n.debug("UserInfoManager subscribeUsersInfo",{userIds:a.usernames}),await r.request(s,{method:"POST",body:a,operation:"subscribeUsersInfo"})})}async unsubscribeUsersInfo(e){return this.runOperation("unsubscribeUsersInfo",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=v(t,e.userIds);n.debug("UserInfoManager unsubscribeUsersInfo",{userIds:c(e.userIds,"params.userIds")}),await r.request(s,{method:"DELETE",operation:"unsubscribeUsersInfo"})})}async getSubscribedUsers(){return this.runOperation("getSubscribedUsers",async()=>{const e=this.getRestContextOrThrow(),t=this.getRestClient(e),r=(e=>U(e))(e);n.debug("UserInfoManager getSubscribedUsers",{userId:e.userId});const s=(e=>{const t=e&&"object"==typeof e?e:null;if(!t||!Array.isArray(t.data))return[];const r=[],s=/* @__PURE__ */new Set;for(const a of t.data){if("string"!=typeof a)continue;const e=a.trim();e&&!s.has(e)&&(s.add(e),r.push(e))}return r})(await t.request(r,{method:"GET",operation:"getSubscribedUsers"}));return 0===s.length?[]:await this.getUserInfoByUserId({userIds:s})})}async updateOwnInfo(e){return this.runOperation("updateOwnInfo",async()=>{const t=this.getRestContextOrThrow(),r=this.getRestClient(t),s=m(e),a=b(t);n.debug("UserInfoManager updateOwnInfo",{userId:t.userId,fields:this.getUpdatedFieldNames(e)});const o=await r.request(a,{method:"PUT",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:s,operation:"updateOwnInfo"}),i=this.normalizeUpdateEnvelope(o,t.userId,this.buildFallbackProfile(t.userId,e));return this.writeCache([i]),this.dispatchSelfUpdate(i.profile),i.profile})}async updateOwnInfoByAttribute(e,t){return this.runOperation("updateOwnInfoByAttribute",async()=>{const r=this.getRestContextOrThrow(),s=this.getRestClient(r),a=y(e,t),o=b(r);n.debug("UserInfoManager updateOwnInfoByAttribute",{userId:r.userId,attribute:e});const i=await s.request(o,{method:"PUT",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:a,operation:"updateOwnInfoByAttribute"}),d=this.normalizeUpdateEnvelope(i,r.userId,{userId:r.userId,[e]:t});return this.writeCache([d]),this.dispatchSelfUpdate(d.profile),d.profile})}async runOperation(e,t){try{return await t()}catch(r){throw this.normalizeOperationError(e,r)}}normalizeOperationError(e,t){return t instanceof o?t:(n.warn("UserInfoManager operation failed",{operation:e,message:t instanceof Error?t.message:String(t)}),new o(`${e} failed`))}getRestContextOrThrow(){if(this.client)return this.client.getRestContext();throw new a("UserInfoManager is not bound to client",{code:s.VALIDATION_REQUIRED,details:{fields:[{path:"userInfoManager.client",message:"client is required",rule:"required"}]}})}getRestClient(e){return this.restClient&&this.restBaseUrl===e.restBaseUrl&&this.restToken===e.token||(this.restClient=new i(e.restBaseUrl,{errorMap:x,requestAdapter:this.client?.getRequestAdapter?.(),includeRequestId:!0}),this.restClient.setAuthToken(e.token),this.restBaseUrl=e.restBaseUrl,this.restToken=e.token),this.restClient}normalizeFetchEnvelope(e,t){return I(e,t)}completeFetchedProfiles(e,t){const r=new Map(e.map(e=>[e.profile.userId,e.profile]));return t.map(e=>r.get(e)??{userId:e})}normalizeUpdateEnvelope(t,r,s){const a=e(t)?t:null,n=(a&&e(a.data)?a.data:null)??(a&&this.looksLikeUserInfoAttributes(a)?a:null),o=a&&"number"==typeof a.lastModified?a.lastModified:void 0;return{profile:n?this.toUserInfo(r,n):{userId:r,...s??{}},lastModified:o}}toUserInfo(e,t){const r={userId:e};return"string"==typeof t.nickname&&(r.nickname=t.nickname),"string"==typeof t.avatarurl?r.avatarUrl=t.avatarurl:"string"==typeof t.avatarUrl&&(r.avatarUrl=t.avatarUrl),"string"==typeof t.mail&&(r.mail=t.mail),"string"==typeof t.phone&&(r.phone=t.phone),"string"!=typeof t.gender&&"number"!=typeof t.gender&&"boolean"!=typeof t.gender||(r.gender=t.gender),"string"==typeof t.sign&&(r.sign=t.sign),"string"==typeof t.birth&&(r.birth=t.birth),"string"==typeof t.ext&&(r.ext=t.ext),r}looksLikeUserInfoAttributes(t){return!!e(t)&&("nickname"in t||"avatarurl"in t||"avatarUrl"in t||"mail"in t||"phone"in t||"gender"in t||"sign"in t||"birth"in t||"ext"in t)}buildFallbackProfile(e,t){const r={userId:e},s=r;for(const a of C)a in t&&(s[a]=t[a]);return r}getUpdatedFieldNames(e){return C.filter(t=>t in e)}projectToSummary(e){const r=Date.now(),s=t(e.lastModified);return{userId:e.profile.userId,nickname:e.profile.nickname,avatarUrl:e.profile.avatarUrl,sign:e.profile.sign,ext:e.profile.ext,userInfoUpdateTime:s,lastSyncAt:r,lastAccess:r,lastUpdate:e.lastModified??r}}writeCache(e){if(!this.client||0===e.length)return;const t=this.client.getCacheManager();t&&("function"==typeof t.upsertRuntimeUserInfos&&t.upsertRuntimeUserInfos(e.map(e=>({profile:e.profile,lastModified:e.lastModified,source:e.profile.userId===this.client?.getRestContext().userId?"update":"fetch"}))),t.setUserInfoSummaries(e.map(e=>this.projectToSummary(e))))}dispatchSelfUpdate(e){this.client?.dispatchOwnInfoUpdated?.(e)}};O.key="userInfoManager";let T=O;export{T as UserInfoManager};

package/message/combine-payload-codec.d.ts

@@ -1,4 +1,4 @@
-import type { ChatConversationType, Message, MessageType, Sender } from '../types';
+import type { ChatConversationType, Message, MessageBody, MessageType, Sender } from '../types';
 /** 合并消息解码后的子消息结构（内部类型） */
 interface CombineMessageItem {
     msgServerId?: string;
@@ -8,7 +8,7 @@ interface CombineMessageItem {
     conversationId: string;
     conversationType: ChatConversationType;
     timestamp: number;
-    body: Record<string, unknown>;
+    body: MessageBody;
     ext?: Record<string, unknown>;
     combineLevel?: number;
 }

package/message/combine-payload-file.d.ts

@@ -0,0 +1,11 @@
+import { type RuntimeDetectionInput } from '../platform/env';
+import type { CompatibleFile } from '../types';
+export interface MaterializeCombinePayloadFileOptions {
+    readonly payload: Uint8Array;
+    readonly filename: string;
+    readonly filetype: string;
+    readonly fileId: string;
+    readonly runtime?: RuntimeDetectionInput;
+}
+export declare const materializeCombinePayloadFile: (options: MaterializeCombinePayloadFileOptions) => Promise<CompatibleFile>;
+export declare const removeCombinePayloadFile: (file: CompatibleFile | undefined, runtime?: RuntimeDetectionInput) => Promise<void>;

package/message/create-message.d.ts

@@ -1,21 +1,33 @@
 /**
  * 消息创建方法
  */
-import type { // 跨端文件类型
+import type { // 合并消息体
+CompatibleFile, // 跨端文件类型
 CreateCmdMessageParams, // 命令消息入参
 CreateCombineMessageParams, // 合并消息入参
 CreateCustomMessageParams, // 自定义消息入参
 CreateFileMessageParams, // 文件消息入参
 CreateImageMessageParams, // 图片消息入参
-CreateLocationMessageParams, // 创建消息基础入参
+CreateLocationMessageParams, // 位置消息入参
+CreateMessageBaseParams, // 创建消息基础入参
 CreateTextMessageParams, // 文本消息入参
 CreateVideoMessageParams, // 视频消息入参
 CreateVoiceMessageParams, // 位置消息体
-Message, // 消息类型联合
-Sender } from '../types';
+Message, // 消息类型
+MessageBody, // 消息体联合类型
+MessageType, // 消息类型联合
+MultiBodySegment, Sender } from '../types';
+export declare const ensureSender: (sender?: Sender) => Sender;
+export declare const resolveMediaUrl: (url: string | undefined, data?: CompatibleFile) => string;
 interface CreateImageMessageOptions {
     useCustomAttachmentUpload?: boolean;
 }
+export declare const buildMessage: (params: CreateMessageBaseParams, // 通用入参
+sender: Sender, // 发送者信息
+type: Exclude<MessageType, "multi_body">, // 消息类型
+body: MessageBody, // 消息体
+msgLocalId?: string) => Message;
+export declare const buildMultiBodyMessage: (params: CreateMessageBaseParams, sender: Sender, bodies: ReadonlyArray<MultiBodySegment>, msgLocalId?: string) => Message;
 /**
  * 创建文本消息
  */

package/message/create-multibody-message.d.ts

@@ -0,0 +1,31 @@
+import type { CreateMultiBodyMessageParams, CreateCustomMessageBodyParams, CreateFileMessageBodyParams, CreateImageMessageBodyParams, CreateLocationMessageBodyParams, CreateTextMessageBodyParams, CreateVideoMessageBodyParams, CreateVoiceMessageBodyParams, CustomMessageBody, FileMessageBody, ImageMessageBody, LocationMessageBody, Message, Sender, TextMessageBody, VideoMessageBody, VoiceMessageBody } from '../types';
+interface CreateImageMessageBodyOptions {
+    readonly useCustomAttachmentUpload?: boolean;
+}
+export declare const createTextMessageBody: (params: CreateTextMessageBodyParams) => {
+    type: "text";
+} & TextMessageBody;
+export declare const createImageMessageBody: (params: CreateImageMessageBodyParams, options?: CreateImageMessageBodyOptions) => {
+    type: "image";
+} & ImageMessageBody;
+export declare const createFileMessageBody: (params: CreateFileMessageBodyParams) => {
+    type: "file";
+} & FileMessageBody;
+export declare const createVoiceMessageBody: (params: CreateVoiceMessageBodyParams) => {
+    type: "voice";
+} & VoiceMessageBody;
+export declare const createVideoMessageBody: (params: CreateVideoMessageBodyParams) => {
+    type: "video";
+} & VideoMessageBody;
+export declare const createLocationMessageBody: (params: CreateLocationMessageBodyParams) => {
+    type: "location";
+} & LocationMessageBody;
+export declare const createCustomMessageBody: (params: CreateCustomMessageBodyParams) => {
+    type: "custom";
+} & CustomMessageBody;
+/**
+ * 组装复合消息。校验不通过时不取走本地文件。
+ * 通过后把文件从分段对象挪到 `msgLocalId:bodyIndex`，发送时按这个 key 找文件。
+ */
+export declare const createMultiBodyMessage: (params: CreateMultiBodyMessageParams, sender?: Sender) => Message;
+export {};

package/message/message-snapshot.d.ts

@@ -0,0 +1,9 @@
+import type { Message, MessageBody } from '../types';
+import type { MessageProfileVersionSidecar } from '../core/message/profile-sync/profile-version-sidecar';
+/** @internal Validated serializable fields shared by realtime projections and both cache formats. */
+export declare const projectMessageMetadata: (value: unknown) => Omit<Partial<Message>, "body"> & MessageProfileVersionSidecar;
+/** @internal Stable comparison for message snapshots; object key order has no business meaning. */
+export declare const messageSnapshotSignature: (value: unknown) => string;
+/** @internal A shallow serializable body projection without expanding combined-message details. */
+export declare const projectMessageSegments: (bodies: ReadonlyArray<Record<string, unknown>>) => ReadonlyArray<Record<string, unknown>>;
+export declare const projectMessageBody: (body: MessageBody | Record<string, unknown> | ReadonlyArray<Record<string, unknown>>) => Record<string, unknown> | ReadonlyArray<Record<string, unknown>>;

package/message/multibody-content.d.ts

@@ -0,0 +1,35 @@
+import type { CompatibleFile, MultiBody, Message, MessageBody, MessageType } from '../types';
+declare const MULTIBODY_SEGMENT_TYPES: readonly ["text", "image", "file", "voice", "video", "location", "custom"];
+export type MultiBodySegmentType = (typeof MULTIBODY_SEGMENT_TYPES)[number];
+export declare const isMultiBodySegmentType: (type: string) => type is MultiBodySegmentType;
+/** 复合消息附件缓存 key。冒号必须保留，避免本地 id 和分段下标粘在一起。 */
+export declare const attachmentStoreKey: (msgLocalId: string, bodyIndex: number) => string;
+/** 本地文件挂在分段对象本身上。组装时按这个对象取走，复制分段会把文件丢掉。 */
+export declare const holdAttachmentFile: (body: object, file: CompatibleFile) => void;
+export declare const takeAttachmentFile: (body: object) => CompatibleFile | undefined;
+export declare const mapRestSegmentType: (type: string | undefined) => MessageType | null;
+/** REST 合并段经常写成 txt/text，并用 subType 0 或合并启发字段标识。 */
+export declare const isCombineRestSegment: (segment: Record<string, unknown>) => boolean;
+/** 多段无法合成复合消息时只留第一段，并说明原因。第一段本身解不出来则仍丢弃。 */
+export declare const keepFirstBody: <T>(segments: ReadonlyArray<T>, reason: string) => ReadonlyArray<T>;
+export declare const composeSegments: (segments: ReadonlyArray<{
+    type: MessageType;
+    body: MessageBody;
+} | null>) => {
+    type: MessageType;
+    body: MessageBody;
+} | null;
+export declare const resolvePublicMessageContent: (contents: ReadonlyArray<unknown>, decodeContent: (content: Record<string, unknown>) => {
+    type: MessageType;
+    body: MessageBody;
+} | null) => {
+    type: MessageType;
+    body: MessageBody;
+} | null;
+export declare const isDownloadableSegmentType: (type: string) => type is "image" | "voice" | "video" | "file";
+export declare const attachMultiBodyUploadDetails: (error: unknown, msgLocalId: string) => void;
+export declare const isMultiBodyMessage: (message: Pick<Message, "type" | "body">) => message is Message & {
+    type: "multi_body";
+    body: MultiBody;
+};
+export {};

package/message/translations.d.ts

@@ -0,0 +1,7 @@
+/** 消息译文的公开映射与现有消息协议数组之间的转换。 */
+export declare const toProtocolTranslations: (translations: Readonly<Record<string, string>> | undefined) => ReadonlyArray<{
+    readonly code: string;
+    readonly text: string;
+}>;
+/** 非法译文不影响原文解析；重复语言采用最后一个合法条目。 */
+export declare const readTranslations: (metaPayload: unknown) => Record<string, string> | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easemob-websdk",
-  "version": "5.1.2",
+  "version": "5.2.0",
   "description": "High-performance, type-safe, extensible instant messaging SDK",
   "homepage": "https://www.easemob.com/",
   "type": "module",

package/platform/image/miniapp-image-processor.d.ts

@@ -4,18 +4,21 @@ interface MiniAppReadFileSuccessResult {
 }
 interface MiniAppGetFileInfoSuccessResult {
     readonly size: number;
+    readonly digest?: string;
+}
+interface MiniAppGetFileInfoOptions {
+    readonly filePath: string;
+    readonly digestAlgorithm?: 'md5';
+    readonly success: (result: MiniAppGetFileInfoSuccessResult) => void;
+    readonly fail?: (error: unknown) => void;
 }
 interface MiniAppFileSystemManagerLike {
-    readFile(options: {
+    readFile?(options: {
         readonly filePath: string;
         readonly success: (result: MiniAppReadFileSuccessResult) => void;
         readonly fail?: (error: unknown) => void;
     }): void;
-    getFileInfo?(options: {
-        readonly filePath: string;
-        readonly success: (result: MiniAppGetFileInfoSuccessResult) => void;
-        readonly fail?: (error: unknown) => void;
-    }): void;
+    getFileInfo?(options: MiniAppGetFileInfoOptions): void;
 }
 interface MiniAppImageInfoResponse {
     readonly width: number;
@@ -40,6 +43,7 @@ export interface MiniAppImageRuntimeLike {
         readonly fail?: (error: unknown) => void;
     }): void;
     getFileSystemManager?(): MiniAppFileSystemManagerLike;
+    getFileInfo?(options: MiniAppGetFileInfoOptions): void;
 }
 export declare const createMiniAppImageProcessor: (runtime: MiniAppImageRuntimeLike) => ImageProcessor;
 export {};

package/protocol/msync/codec.d.ts

@@ -55,7 +55,7 @@ export declare class MsyncCodec {
     private compressionFailureCount;
     private readonly maxCompressionFailures;
     private useReplacedMessageContents;
-    private readonly useCustomAttachmentUpload;
+    private readonly payloadDecoder;
     constructor(options: MsyncContextOptions);
     updateToken(token: string): void;
     updateResource(resource: string | undefined): void;
@@ -149,12 +149,12 @@ export declare class MsyncCodec {
     private decodeMessage;
     private resolveMessageProfileVersionFields;
     private buildMessageMeta;
+    private buildMessageMetaFromBody;
+    private buildTranslationsMeta;
     private resolveProfileVersionTime;
     private isPublicMessageType;
     private resolveMessageIsOnline;
-    private decodeStreamMeta;
-    private mapStreamStatus;
-    private resolveContentText;
+    private buildContents;
     private buildContent;
     private decodeContent;
     private resolveChatType;
@@ -171,23 +171,6 @@ export declare class MsyncCodec {
     private resolveRouteType;
     private resolveBroadcast;
     private resolvePriority;
-    private resolveContentReplaced;
-    private resolveMessageMetaPayload;
-    private resolvePeerRead;
-    private resolveGroupReadCount;
-    private resolveModifiedInfo;
-    private resolveChatThreadMessageContext;
-    private resolveChatThreadOverview;
-    private resolveChatThreadOverviewLastMessage;
-    private resolveThreadLastMessagePayload;
-    private mapThreadMessageType;
-    private normalizeThreadLastMessageBody;
-    private readString;
-    private numberField;
-    private parseMetaPayload;
-    private toFiniteNumber;
-    private resolveReactions;
-    private normalizeMetaPayload;
     private mapPriorityToTag;
     private getRequestedCompressTypes;
     private configureCompression;

package/protocol/msync/message-identity.d.ts

@@ -0,0 +1,2 @@
+/** Returns a payload user ID when present, falling back to the envelope JID. */
+export declare const resolveMessageJidName: (payloadJid: unknown, envelopeJid: unknown) => string;

package/protocol/msync/message-payload-decoder.d.ts

@@ -0,0 +1,39 @@
+import type { Message, MessageBody, MessageModifiedInfo, StreamMessageMeta, StreamMessageStatus } from '../../types';
+import type { ChatConversationType } from '../../types/chat-manager';
+import type { ChatThreadMessageContext, ChatThreadOverview } from '../../types/chat-thread';
+export declare const readMessageContent: (body: Record<string, unknown>) => Record<string, unknown> | undefined;
+/** @internal Shared message payload mapping for realtime and session-list protocols. */
+export declare class MessagePayloadDecoder {
+    private readonly userId;
+    private readonly useCustomAttachmentUpload;
+    constructor(userId: string, useCustomAttachmentUpload?: boolean);
+    decodeMetadata(body: Record<string, unknown>, conversationType: ChatConversationType, direct: Message['direct'], fallbackMeta?: unknown): Omit<Partial<Message>, 'body'>;
+    decodeContent(content: Record<string, unknown>, metaPayload?: unknown): {
+        type: Message['type'];
+        body: MessageBody;
+    } | null;
+    decodeStreamMeta(rawStream: unknown, content: Record<string, unknown> | undefined): StreamMessageMeta | undefined;
+    mapStreamStatus(rawStatus: number, errorType: number): StreamMessageStatus;
+    resolveContentText(content: Record<string, unknown> | undefined): string;
+    resolveContentReplaced(metaPayload: unknown): boolean | undefined;
+    resolveMessageMetaPayload(primaryPayload: unknown, fallbackPayload: unknown): unknown;
+    resolvePeerRead(metaPayload: unknown, conversationType: ChatConversationType, direct: Message['direct']): boolean | undefined;
+    resolveGroupReadCount(metaPayload: unknown, conversationType: ChatConversationType): number | undefined;
+    resolveModifiedInfo(metaPayload: unknown): MessageModifiedInfo | undefined;
+    resolveChatThreadMessageContext(metaPayload: unknown): ChatThreadMessageContext | undefined;
+    resolveChatThreadOverview(metaPayload: unknown): ChatThreadOverview | undefined;
+    resolveChatThreadOverviewLastMessage(rawLastMessage: unknown, chatThreadId: string): ChatThreadOverview['lastMessage'] | undefined;
+    resolveThreadLastMessagePayload(rawLastMessage: Record<string, unknown>): Record<string, unknown> | null;
+    composeThreadBodies(bodies: ReadonlyArray<unknown>): {
+        type: Message['type'];
+        body: MessageBody;
+    } | null;
+    mapThreadMessageType(rawType: string | undefined): Message['type'];
+    normalizeThreadLastMessageBody(type: Message['type'], firstBody: Record<string, unknown> | null, rawLastMessage: Record<string, unknown>): MessageBody;
+    readString(value: unknown): string | undefined;
+    numberField<Key extends string>(key: Key, value: unknown): Record<Key, number> | object;
+    parseMetaPayload(metaPayload: unknown): Record<string, unknown> | null;
+    toFiniteNumber(value: unknown): number | undefined;
+    resolveReactions(metaPayload: unknown): Message['reactions'];
+    normalizeMetaPayload(payload: unknown): Uint8Array | null;
+}

package/protocol/session-list/gateway.d.ts

@@ -14,6 +14,13 @@ export declare const toSessionMessageSnippet: (meta: SessionListMeta | undefined
     readonly conversationId: string;
     readonly conversationType: ConversationItem["conversationType"];
     readonly currentUserId: string;
+    readonly ext?: Record<string, unknown>;
+    readonly payload?: Record<string, unknown> | null;
+    readonly useCustomAttachmentUpload?: boolean;
+    readonly org: string;
+    readonly app: string;
     readonly singleChatPeerDisplay?: Pick<ConversationItem, "conversationName" | "conversationAvatar">;
 }) => SessionMessageSnippet | null;
-export declare const toSessionListItems: (response: SessionListResponse, currentUserId: string) => ReadonlyArray<ConversationItem>;
+export declare const toSessionListItems: (response: SessionListResponse, currentUserId: string, org: string, app: string, options?: {
+    readonly useCustomAttachmentUpload?: boolean;
+}) => ReadonlyArray<ConversationItem>;

package/protocol/session-list/payload-decoder.d.ts

@@ -1 +1,13 @@
-export declare const decodeSessionListPayloadBody: (payload?: Uint8Array) => Record<string, unknown>;
+import type { SessionMessageSnippet } from '../../types/conversation';
+export declare const decodeSessionListPayload: (payload?: Uint8Array) => {
+    readonly body: Record<string, unknown> | ReadonlyArray<Record<string, unknown>>;
+    readonly ext: Record<string, unknown>;
+};
+export declare const decodeSessionListPayloadRecord: (payload?: Uint8Array) => Record<string, unknown> | null;
+export declare const mapSessionListPayload: (decoded: Record<string, unknown> | null, options: {
+    readonly currentUserId: string;
+    readonly conversationType: NonNullable<SessionMessageSnippet["conversationType"]>;
+    readonly from: string;
+    readonly useCustomAttachmentUpload?: boolean;
+}) => Partial<SessionMessageSnippet>;
+export declare const decodeSessionListPayloadBody: (payload?: Uint8Array) => Record<string, unknown> | ReadonlyArray<Record<string, unknown>>;

package/types/chat-manager.d.ts

@@ -63,7 +63,7 @@ export interface RecallMessageParams extends ConversationLocator {
 export interface UpdateMessageParams extends ConversationLocator {
     /** [zh-CN] 待编辑的消息 ID。 [en-US] ID of the message to edit. */
     messageId: string;
-    /** [zh-CN] 编辑后的消息内容。当前仅支持文本消息和自定义消息。 [en-US] Updated message content. Currently, only text messages and custom messages are supported. */
+    /** [zh-CN] 编辑后的消息内容。文本消息可修改 `content` 和 `ext`；`body.targetLanguages` 非空时先翻译再编辑，译文写入 `body.translations`，翻译失败则抛出异常且不发送编辑。自定义消息可修改 `event`、`params` 和 `ext`；图片、语音、视频、文件、位置和合并消息仅可修改 `ext`。命令消息和复合消息不支持编辑。 [en-US] Updated message content. Text messages can change `content` and `ext`. Non-empty `body.targetLanguages` are translated before the edit and stored in `body.translations`; translation failure throws without sending the edit. Custom messages can change `event`, `params`, and `ext`. Image, voice, video, file, location, and combined messages can change `ext` only. Command and multi_body messages cannot be edited. */
     message: Pick<Message, 'type' | 'body' | 'ext'>;
 }
 /**
@@ -113,7 +113,7 @@ export interface MessageHistoryPage {
  * [en-US] Parameters for downloading a message attachment.
  */
 export interface DownloadAttachmentParams {
-    /** [zh-CN] 需要下载附件的消息，通常为图片、语音、视频或文件消息。 [en-US] Message whose attachment is to be downloaded, typically an image, voice, video, or file message. */
+    /** [zh-CN] 需要下载附件的消息，通常为图片、语音、视频、文件或复合消息。复合消息会下载其中全部图片、语音、视频和文件。 [en-US] Message whose attachment is to be downloaded, typically an image, voice, video, file, or multi_body message. A multi_body message downloads every image, voice, video, and file segment. */
     message: Message;
 }
 /**

package/types/conversation.d.ts

@@ -2,8 +2,7 @@
  * [zh-CN] Conversation 公开类型定义。
  * [en-US] Public conversation type definitions.
  */
-import type { Sender } from './sender';
-import type { Message, MessageDirect, MessageModifiedInfo, MessageSendStatus, MessageType } from './index';
+import type { Message } from './index';
 export type { Sender } from './sender';
 export declare const CONVERSATION_TYPE: {
     readonly SINGLE_CHAT: "singleChat";
@@ -205,38 +204,46 @@ export interface RefreshSessionListParams {
  */
 export type SessionListRemindType = 'DEFAULT' | 'ALL' | 'AT' | 'NONE';
 /**
- * [zh-CN] 会话列表最小消息摘要。
- * [en-US] Minimal message snippet used by the conversation list.
+ * [zh-CN] 会话列表最后消息快照。
+ * [en-US] Last-message snapshot used by the conversation list.
+ *
+ * @remarks
+ * [zh-CN] 字段类型复用 Message，保留可获得的正文和元信息。历史摘要可能不完整，因此可选字段保持可选，body 保留对象类型以兼容旧缓存；新解析正文与 MessageBody 一致，不应将历史摘要强制转换为完整 Message。
+ * [en-US] Field types are shared with Message and preserve available content and metadata. Legacy snippets can be incomplete, so optional fields remain optional and body keeps an object type for compatibility. Newly decoded content matches MessageBody; legacy snippets should not be cast to complete Message objects.
+ * [zh-CN] 从旧版缓存升级时，最后消息可能缺少参与者和方向。若无法从同会话、同消息的记录恢复，`from`、`sender.userId` 及无法确定的单聊 `to` 为空字符串，`direct` 为 `undefined`。UI 应省略未知发送者资料和依赖方向的展示，不能默认认定对端发送。同步服务可用时重新同步会话列表，或等待新消息更新，可补齐能够获得的信息；保留旧消息正文，不通过清空缓存恢复身份。
+ * [en-US] After upgrading from a legacy cache, the last message may lack participant and direction data. If it cannot be recovered from a record for the same conversation and message, `from`, `sender.userId`, and an undetermined one-to-one `to` are empty strings, while `direct` is `undefined`. The UI should omit unknown sender details and direction-dependent rendering instead of assuming an incoming message. Re-syncing the conversation list when the sync service is available, or receiving a new message, can populate available information. Legacy message content is retained; clearing the cache does not recover identities.
  */
-export interface SessionMessageSnippet {
+export interface SessionMessageSnippet extends Readonly<Partial<Omit<Message, 'body'>>> {
     /** [zh-CN] 服务端消息 ID。 [en-US] Message ID on the server. */
-    readonly msgServerId: string;
-    /** [zh-CN] 消息发送者的用户 ID。 [en-US] User ID of the message sender. */
-    readonly from: string;
-    /** [zh-CN] 消息接收方 ID：单聊时为对方用户 ID，群聊时为群组 ID，聊天室时为聊天室 ID。 [en-US] Message recipient ID: user ID for one-to-one chat, group ID for group chat, or chat room ID for chat room. */
-    readonly to: string;
-    /** [zh-CN] 发送者信息。 [en-US] Message sender information. */
-    readonly sender: Sender;
+    readonly msgServerId: Message['msgServerId'];
+    /** [zh-CN] 消息发送者的用户 ID；无法恢复的旧缓存身份为空字符串。 [en-US] Sender user ID; empty when identity cannot be recovered from a legacy cache. */
+    readonly from: Message['from'];
+    /** [zh-CN] 实际接收方 ID：单聊为接收者用户 ID，群聊为群组 ID，聊天室为聊天室 ID；无法确定的旧缓存单聊接收者为空字符串。 [en-US] Actual recipient ID: recipient user ID for one-to-one chat, group ID for group chat, or chat room ID for chat room; empty when a legacy one-to-one recipient is undetermined. */
+    readonly to: Message['to'];
+    /** [zh-CN] 发送者信息；无法恢复的旧缓存中 userId 为空字符串。 [en-US] Sender information; userId is empty when legacy identity cannot be recovered. */
+    readonly sender: Message['sender'];
     /** [zh-CN] 会话 ID。 [en-US] Conversation ID. */
-    readonly conversationId?: string;
+    readonly conversationId?: Message['conversationId'];
     /** [zh-CN] 会话类型。 [en-US] Conversation type. */
-    readonly conversationType?: ConversationType;
+    readonly conversationType?: Message['conversationType'];
     /** [zh-CN] 消息类型。 [en-US] Message type. */
-    readonly type?: MessageType;
+    readonly type?: Message['type'];
     /** [zh-CN] 消息发送状态。 [en-US] Message sending status. */
-    readonly sendStatus?: MessageSendStatus;
+    readonly sendStatus?: Message['sendStatus'];
     /** [zh-CN] 消息时间戳（毫秒）。 [en-US] Message timestamp, in milliseconds. */
     readonly timestamp: number;
-    /** [zh-CN] 消息方向：发送或接收。 [en-US] Message direction: outgoing or incoming. */
-    readonly direct?: MessageDirect;
+    /** [zh-CN] 消息方向：发送或接收；仅在有可靠记录时提供，未知时为 undefined，不根据发送者推测。 [en-US] Message direction: outgoing or incoming; provided only from a reliable record, undefined when unknown, and never inferred from the sender. */
+    readonly direct?: Message['direct'];
     /** [zh-CN] 消息修改信息；当最后一条消息被编辑后，此字段可能存在。 [en-US] Message modification information; present when the last message has been edited. */
-    readonly modifiedInfo?: MessageModifiedInfo;
+    readonly modifiedInfo?: Message['modifiedInfo'];
     /** [zh-CN] 发送者用户资料的版本时间戳（秒），用于资料补全。 [en-US] User profile version timestamp (in seconds) of the message sender, used for profile hydration. */
     readonly userInfoUpdateTime?: number;
     /** [zh-CN] 群成员名片的版本时间戳（秒），仅群聊会话的最后一条消息可能存在此字段。 [en-US] The version timestamp (in seconds) of the Group member name card. This field may only exist for the last message in group chat conversations. */
     readonly namecardUpdateTime?: number;
-    /** [zh-CN] 消息体摘要，不包含 `type` 字段。 [en-US] Message body summary without the `type` field. */
-    readonly body: Record<string, unknown>;
+    /** [zh-CN] 与 MessageBody 一致的消息正文。复合消息时这里直接是分段数组。 [en-US] Message content matching MessageBody. For a multi_body message, this is the segment array. */
+    readonly body: Record<string, unknown> | ReadonlyArray<Record<string, unknown>>;
+    /** [zh-CN] 消息扩展字段，与 onMessage 的 ext 一致；旧缓存可能缺失。 [en-US] Message extension fields, matching onMessage ext; may be absent in legacy caches. */
+    readonly ext?: Message['ext'];
 }
 /**
  * [zh-CN] 公开的会话列表项，来自本地会话列表缓存的投影数据。

package/types/index.d.ts

@@ -48,7 +48,7 @@ export type { Sender } from './sender';
  * [zh-CN] SDK 支持的消息类型。
  * [en-US] Message types supported by the SDK.
  */
-export type MessageType = 'text' | 'image' | 'file' | 'voice' | 'video' | 'location' | 'custom' | 'cmd' | 'combine';
+export type MessageType = 'text' | 'image' | 'file' | 'voice' | 'video' | 'location' | 'custom' | 'cmd' | 'combine' | 'multi_body';
 /**
  * [zh-CN] 图片资源类型常量。
  * [en-US] Image resource type constants.
@@ -151,9 +151,9 @@ export type CompatibleFile = File | MiniAppFile | ReactNativeFile;
 export interface TextMessageBody {
     /** [zh-CN] 消息文本内容。 [en-US] Message text content. */
     content: string;
-    /** [zh-CN] 目标翻译语言代码列表。 [en-US] Target translation language codes. */
+    /** [zh-CN] 发送前自动翻译的目标语言代码列表，不传或空数组不翻译。 [en-US] Target language codes for automatic translation before sending; omitted or empty arrays disable translation. */
     targetLanguages?: string[];
-    /** [zh-CN] 语言代码到翻译文本的映射。 [en-US] Mapping from language codes to translated text. */
+    /** [zh-CN] 语言代码到译文的映射，由自动发送翻译或接收解码填充；主动翻译 API 仅返回结果。 [en-US] Language-to-text map populated by automatic translation on send or incoming decoding; the explicit translation API only returns results. */
     translations?: Record<string, string>;
 }
 /**
@@ -307,11 +307,35 @@ export interface CombineMessageBody {
     /** [zh-CN] 当前合并消息嵌套层级。 [en-US] Current nesting level of the combined message. */
     combineLevel: number;
 }
+/**
+ * [zh-CN] 复合消息中的一段可组合内容。`type` 只出现在复合消息的分段上。
+ * [en-US] One segment inside a multi_body message. `type` exists only on these segments.
+ */
+export type MultiBodySegment = ({
+    type: 'text';
+} & TextMessageBody) | ({
+    type: 'image';
+} & ImageMessageBody) | ({
+    type: 'file';
+} & FileMessageBody) | ({
+    type: 'voice';
+} & VoiceMessageBody) | ({
+    type: 'video';
+} & VideoMessageBody) | ({
+    type: 'location';
+} & LocationMessageBody) | ({
+    type: 'custom';
+} & CustomMessageBody);
+/**
+ * [zh-CN] 复合消息正文。分段按发送顺序排列，至少 2 段。
+ * [en-US] Body of a multi_body message. Segments stay in send order and there are at least two.
+ */
+export type MultiBody = ReadonlyArray<MultiBodySegment>;
 /**
  * [zh-CN] 所有消息体的联合类型。
  * [en-US] Union of all message body types.
  */
-export type MessageBody = TextMessageBody | ImageMessageBody | FileMessageBody | VoiceMessageBody | VideoMessageBody | LocationMessageBody | CmdMessageBody | CustomMessageBody | CombineMessageBody;
+export type MessageBody = TextMessageBody | ImageMessageBody | FileMessageBody | VoiceMessageBody | VideoMessageBody | LocationMessageBody | CmdMessageBody | CustomMessageBody | CombineMessageBody | MultiBody;
 /**
  * [zh-CN] 消息对象。
  * [en-US] Message object.
@@ -339,7 +363,7 @@ export interface Message {
     ext: Record<string, unknown>;
     /** [zh-CN] 消息时间戳，单位毫秒。 [en-US] Message timestamp in milliseconds. */
     timestamp: number;
-    /** [zh-CN] 消息体。 [en-US] Message body. */
+    /** [zh-CN] 消息体。复合消息时这里直接是分段数组。 [en-US] Message body. For a multi_body message, this is the segment array. */
     body: MessageBody;
     /** [zh-CN] 消息方向。 [en-US] Message direction. */
     direct?: MessageDirect;
@@ -446,11 +470,11 @@ export interface StreamMessage extends Message {
  * [en-US] File upload progress.
  */
 export interface FileUploadProgress {
-    /** [zh-CN] 已上传字节数。 [en-US] Number of uploaded bytes. */
+    /** [zh-CN] 已上传字节数。复合消息按全部附件文件大小合计。 [en-US] Number of uploaded bytes. MultiBody messages use the combined size of all attachments. */
     loaded: number;
-    /** [zh-CN] 文件总字节数。 [en-US] Total number of bytes in the file. */
+    /** [zh-CN] 附件总字节数。复合消息是各附件文件大小之和。 [en-US] Total attachment size in bytes. MultiBody messages use the sum of every attachment file size. */
     total?: number;
-    /** [zh-CN] 上传进度百分比。 [en-US] Upload progress as a percentage. */
+    /** [zh-CN] 相对全部附件总大小的上传百分比。 [en-US] Upload percentage relative to the total size of all attachments. */
     percent?: number;
 }
 /**
@@ -498,7 +522,7 @@ export interface SendMessageOptions {
     onFileUploadComplete?: (result: FileUploadResult) => void;
     /** [zh-CN] 附件上传失败回调。 [en-US] Triggered when the attachment upload fails. */
     onFileUploadError?: (error: Error) => void;
-    /** [zh-CN] 附件上传取消回调。 [en-US]  Triggered when the attachment upload is cancelled.*/
+    /** [zh-CN] 附件上传取消回调。 [en-US] Triggered when the attachment upload is cancelled. */
     onFileUploadCanceled?: () => void;
 }
 /**