k2-im 0.1.21 → 0.1.23

package/dist/browser-YLMJKRLM.js

@@ -0,0 +1,2 @@
+import {a as a$1}from'./chunk-WOT6VMZA.js';import {parse,isInteger,isSafeNumber}from'lossless-json';import Oe from'axios';function st(t){return {cryptMd5:t.crypt_md5,generateSign:t.generate_sign,encryptAes:t.encrypt_aes,decryptAes:t.decrypt_aes}}var j={};a$1(j,{__wbg_get_67b2ba62fc30de12:()=>Kt,__wbg_get_b9b93047fe3cf45b:()=>Xt,__wbg_length_e2d2a49132c1b256:()=>Qt,__wbg_ownKeys_3930041068756f1f:()=>Zt,__wbg_set_wasm:()=>K,__wbindgen_debug_string:()=>te,__wbindgen_init_externref_table:()=>ee,__wbindgen_is_object:()=>re,__wbindgen_string_get:()=>ne,__wbindgen_string_new:()=>oe,__wbindgen_throw:()=>se,crypt_md5:()=>Vt,decrypt_aes:()=>Gt,encrypt_aes:()=>Yt,generate_sign:()=>Jt});var a;function K(t){a=t;}function $t(t){let e=a.__externref_table_alloc();return a.__wbindgen_export_2.set(e,t),e}function it(t,e){try{return t.apply(this,e)}catch(r){let n=$t(r);a.__wbindgen_exn_store(n);}}function G(t){let e=typeof t;if(e=="number"||e=="boolean"||t==null)return `${t}`;if(e=="string")return `"${t}"`;if(e=="symbol"){let o=t.description;return o==null?"Symbol":`Symbol(${o})`}if(e=="function"){let o=t.name;return typeof o=="string"&&o.length>0?`Function(${o})`:"Function"}if(Array.isArray(t)){let o=t.length,s="[";o>0&&(s+=G(t[0]));for(let i=1;i<o;i++)s+=`, ${G(t[i])}`;return s+="]",s}let r=/\[object ([^\]]+)\]/.exec(toString.call(t)),n;if(r&&r.length>1)n=r[1];else return toString.call(t);if(n=="Object")try{return `Object(${JSON.stringify(t)})`}catch{return "Object"}return t instanceof Error?`${t.name}: ${t.message}
+${t.stack}`:n}var m=0,L=null;function O(){return (L===null||L.byteLength===0)&&(L=new Uint8Array(a.memory.buffer)),L}var Ft=typeof TextEncoder>"u"?(0, module.require)("util").TextEncoder:TextEncoder,v=new Ft("utf-8"),qt=typeof v.encodeInto=="function"?function(t,e){return v.encodeInto(t,e)}:function(t,e){let r=v.encode(t);return e.set(r),{read:t.length,written:r.length}};function E(t,e,r){if(r===void 0){let u=v.encode(t),c=e(u.length,1)>>>0;return O().subarray(c,c+u.length).set(u),m=u.length,c}let n=t.length,o=e(n,1)>>>0,s=O(),i=0;for(;i<n;i++){let u=t.charCodeAt(i);if(u>127)break;s[o+i]=u;}if(i!==n){i!==0&&(t=t.slice(i)),o=r(o,n,n=i+t.length*3,1)>>>0;let u=O().subarray(o+i,o+n),c=qt(t,u);i+=c.written,o=r(o,n,i,1)>>>0;}return m=i,o}var I=null;function N(){return (I===null||I.buffer.detached===true||I.buffer.detached===void 0&&I.buffer!==a.memory.buffer)&&(I=new DataView(a.memory.buffer)),I}function at(t){return t==null}var Wt=typeof TextDecoder>"u"?(0, module.require)("util").TextDecoder:TextDecoder,ct=new Wt("utf-8",{ignoreBOM:true,fatal:true});ct.decode();function H(t,e){return t=t>>>0,ct.decode(O().subarray(t,t+e))}function Vt(t){let e,r;try{let n=E(t,a.__wbindgen_malloc,a.__wbindgen_realloc),o=m,s=a.crypt_md5(n,o);return e=s[0],r=s[1],H(s[0],s[1])}finally{a.__wbindgen_free(e,r,1);}}function zt(t){let e=a.__wbindgen_export_2.get(t);return a.__externref_table_dealloc(t),e}function Jt(t,e,r,n){let o,s;try{let i=E(t,a.__wbindgen_malloc,a.__wbindgen_realloc),u=m,c=E(e,a.__wbindgen_malloc,a.__wbindgen_realloc),f=m,l=at(n)?0:E(n,a.__wbindgen_malloc,a.__wbindgen_realloc),p=m,d=a.generate_sign(i,u,c,f,r,l,p),b=d[0],g=d[1];if(d[3])throw b=0,g=0,zt(d[2]);return o=b,s=g,H(b,g)}finally{a.__wbindgen_free(o,s,1);}}function ut(t,e){let r=e(t.length*1,1)>>>0;return O().set(t,r/1),m=t.length,r}function lt(t,e){return t=t>>>0,O().subarray(t/1,t/1+e)}function Yt(t){let e=ut(t,a.__wbindgen_malloc),r=m,n=a.encrypt_aes(e,r),o=lt(n[0],n[1]).slice();return a.__wbindgen_free(n[0],n[1]*1,1),o}function Gt(t){let e=ut(t,a.__wbindgen_malloc),r=m,n=a.decrypt_aes(e,r),o=lt(n[0],n[1]).slice();return a.__wbindgen_free(n[0],n[1]*1,1),o}function Kt(){return it((t,e)=>Reflect.get(t,e),arguments)}function Xt(t,e){return t[e>>>0]}function Qt(t){return t.length}function Zt(){return it(t=>Reflect.ownKeys(t),arguments)}function te(t,e){let r=G(e),n=E(r,a.__wbindgen_malloc,a.__wbindgen_realloc),o=m;N().setInt32(t+4,o,true),N().setInt32(t+0,n,true);}function ee(){let t=a.__wbindgen_export_2,e=t.grow(4);t.set(0,void 0),t.set(e+0,void 0),t.set(e+1,null),t.set(e+2,true),t.set(e+3,false);}function re(t){let e=t;return typeof e=="object"&&e!==null}function ne(t,e){let r=e,n=typeof r=="string"?r:void 0,o=at(n)?0:E(n,a.__wbindgen_malloc,a.__wbindgen_realloc),s=m;N().setInt32(t+4,s,true),N().setInt32(t+0,o,true);}function oe(t,e){return H(t,e)}function se(t,e){throw new Error(H(t,e))}var pt=null,$=null;async function ie(){let t=await fetch(new URL("./vendor/crypto/index_bg.wasm",import.meta.url));if(!t.ok)throw new Error(`crypto wasm \u52A0\u8F7D\u5931\u8D25\uFF1AHTTP ${t.status}`);let e={"./index_bg.js":j},r;if(typeof WebAssembly.instantiateStreaming=="function")try{r=await WebAssembly.instantiateStreaming(t.clone(),e);}catch{r=await WebAssembly.instantiate(await t.arrayBuffer(),e);}else r=await WebAssembly.instantiate(await t.arrayBuffer(),e);return K(r.instance.exports),r.instance.exports.__wbindgen_start(),st(j)}async function X(){return $||($=ie().catch(t=>{throw $=null,t})),pt=await $,pt}await X();var ft="b097f885e9577cdb04d9faf91aa08329";function ae(t){return Object.keys(t).sort((r,n)=>r.localeCompare(n,void 0,{numeric:true})).map(r=>r+t[r]).join("")}function dt(t,e){let r=ae(e);return t.cryptMd5(ft+r+ft).toUpperCase()}var gt="123456789";var mt={core:"/api/h5",wallet:"/api/h5",bi:"/bi/h5",im:""};function pe(t){return isInteger(t)?isSafeNumber(t)?Number.parseInt(t,10):t:Number.parseFloat(t)}function F(t){return parse(t,void 0,{parseNumber:pe})}var bt="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";function _t(t){return t?t instanceof Headers?Object.fromEntries(t.entries()):Array.isArray(t)?Object.fromEntries(t):{...t}:{}}function yt(t){return t?t instanceof Headers?Object.fromEntries(t.entries()):Object.fromEntries(Object.entries(t).map(([e,r])=>[e,Array.isArray(r)?r.join(", "):String(r)])):{}}function Pt(t,e){let r=e.toLowerCase();return Object.entries(t).find(([o])=>o.toLowerCase()===r)?.[1]??null}function M(t,e=2){return t.toString().padStart(e,"0")}function wt(t){return `${t.getFullYear()}-${M(t.getMonth()+1)}-${M(t.getDate())} ${M(t.getHours())}:${M(t.getMinutes())}:${M(t.getSeconds())}`}function de(t){if(t!=null)return typeof t=="string"?t:typeof t=="number"||typeof t=="boolean"||typeof t=="bigint"?String(t):t&&typeof t=="object"?JSON.stringify(t):String(t)}function Tt(t){let e={};for(let[r,n]of Object.entries(t)){let o=de(n);o!==void 0&&(e[r]=o);}return e}function At(t=16){let e="";for(let r=0;r<t;r+=1){let n=Math.floor(Math.random()*bt.length);e+=bt.charAt(n);}return e}function Rt(t){let e={deviceBrand:"web",deviceInfo:"web",deviceNumber:"",deviceToken:"web"},r=t||(typeof navigator<"u"?navigator.userAgent:"");if(!r)return e;let n=r.match(/(Chrome|Firefox|Safari|Edg)\/([\d.]+)/i);return n?{deviceBrand:"web",deviceInfo:`${n[1]}/${n[2]}`,deviceNumber:n[2]??"",deviceToken:"web"}:{...e,deviceInfo:r}}function ht(t){let e=String(t||"").trim().toLowerCase();return e==="cn"||e.startsWith("zh-cn")?"cn":e==="tc"||e.startsWith("zh-tw")||e.startsWith("zh-hk")?"tc":e==="vn"||e.startsWith("vi")?"vn":e==="th"||e.startsWith("th")?"th":e==="en"||e.startsWith("en")?"en":"cn"}function h(t,e){return {baseUrl:e?.baseUrl??"",prefix:e?.prefix??mt[t]}}function ge(t){return t.replace(/^\/+|\/+$/g,"")}function xt(t,e,r){let n=t.replace(/\/+$/g,""),o=ge(e),s=r.startsWith("/")?r:`/${r}`,i=o?`/${o}`:"";return `${n}${i}${s}`}function Ct(t,e){let r=new URLSearchParams(Object.entries(e).map(([u,c])=>[u,String(c)])).toString();if(!r)return t;let n=t.indexOf("#"),o=n>=0?t.slice(0,n):t,s=n>=0?t.slice(n):"",i=o.includes("?")?o.endsWith("?")||o.endsWith("&")?"":"&":"?";return `${o}${i}${r}${s}`}function Q(t){return !!t&&t.toLowerCase().includes("application/json")}function Z(t){return !!t&&t.toLowerCase().startsWith("text/")}function k(t){return t==null?new Uint8Array:typeof t=="string"?new TextEncoder().encode(t):t instanceof ArrayBuffer?new Uint8Array(t):ArrayBuffer.isView(t)?new Uint8Array(t.buffer,t.byteOffset,t.byteLength):new TextEncoder().encode(JSON.stringify(t))}function q(t){return typeof t=="string"?t:new TextDecoder().decode(k(t))}function It(t){return typeof FormData<"u"&&t instanceof FormData}var Pe=new Set(["content-etag","token","req-id"]);function St(t){let e=t.rawBody,r=e!==null&&typeof e=="object"&&"code"in e?e.code:void 0;return {transportStatus:t.transportStatus,...t.httpStatus===void 0?{}:{httpStatus:t.httpStatus},...typeof r=="number"&&Number.isFinite(r)?{businessCode:r}:{}}}function we(t){return Number.isInteger(t)&&t>=400&&t<=599?t:502}function Te(t,e){return {code:t.status,msg:t.statusText,data:null,time:Math.floor(e/1e3)}}function Ae(t,e){return {code:502,msg:t instanceof Error?t.message:String(t),data:null,time:Math.floor(e/1e3)}}function Re(t){if(!t||typeof t!="object")return  false;let e=t;return Number.isFinite(e.code)&&"data"in e}function Et(t,e,r,n){if(Q(r))return F(q(e.data));if(Z(r))return q(e.data);let o=k(e.data),s=n?t.crypto.decryptAes(o):o,i=new TextDecoder().decode(s);return F(i)}async function Dt(t,e,r){if(!t.onDebugRecord)return;let n={...e.meta,response:e.response,...r?{error:{name:r instanceof Error?r.name:void 0,message:r instanceof Error?r.message:String(r)}}:{}};try{await t.onDebugRecord(n);}catch{}}function he(t,e,r,n,o){if(r.customUrl)return t;let s=h(n,e.config.targets[n]),i=r.baseUrl??s.baseUrl;return xt(i,o,t)}function xe(t,e){let r=new AbortController,n=setTimeout(()=>r.abort(),t),o=()=>r.abort();return e&&(e.aborted?r.abort():e.addEventListener("abort",o,{once:true})),{signal:r.signal,dispose:()=>{clearTimeout(n),e?.removeEventListener("abort",o);}}}async function Ce(t,e,r,n,o,s,i){let u=yt(e.headers),c=Pt(u,"content-type");if(e.status<200||e.status>=300){let l;if(n)l=void 0;else try{l=Et(t,e,c,r);}catch{l=void 0;}return {response:Re(l)?l:Te(e,i),meta:{...o,transportStatus:"http_error",httpStatus:e.status,contentType:c,responseHeaders:u,...l!==void 0?{rawBody:l}:{},timings:{totalMs:i-s,upstreamMs:i-s}}}}let f=Date.now();if(n){let l=k(e.data),p=Date.now();return {response:{code:e.status,data:l,time:Math.floor(p/1e3)},meta:{...o,transportStatus:"success",httpStatus:e.status,contentType:c,responseHeaders:u,rawBody:l,timings:{totalMs:p-s,upstreamMs:i-s,parseMs:p-f}}}}try{if(Q(c)){let T=Et(t,e,c,!1),_=Date.now();return {response:T,meta:{...o,transportStatus:"success",httpStatus:e.status,contentType:c,responseHeaders:u,rawBody:T,timings:{totalMs:_-s,upstreamMs:i-s,parseMs:_-f}}}}if(Z(c)){let T=q(e.data),_=Date.now();return {response:{code:e.status,msg:e.statusText,data:T,time:Math.floor(_/1e3)},meta:{...o,transportStatus:"success",httpStatus:e.status,contentType:c,responseHeaders:u,rawBody:T,timings:{totalMs:_-s,upstreamMs:i-s,parseMs:_-f}}}}let l=k(e.data),p=Date.now(),d=r?t.crypto.decryptAes(l):l,b=Date.now(),g=new TextDecoder().decode(d),D=F(g),B=Date.now();return {response:D,meta:{...o,transportStatus:"success",httpStatus:e.status,contentType:c,responseHeaders:u,rawBody:D,timings:{totalMs:B-s,upstreamMs:i-s,parseMs:B-f,...r?{decryptMs:b-p}:{}}}}}catch(l){let p=Date.now();return {response:{code:we(e.status),msg:l instanceof Error?l.message:String(l),data:null,time:Math.floor(p/1e3)},meta:{...o,transportStatus:"invalid_response",httpStatus:e.status,contentType:c,responseHeaders:u,timings:{totalMs:p-s,upstreamMs:i-s,parseMs:p-f}}}}}function Ie(t){return async function(r,n={}){let o=t.now??(()=>new Date),s=t.randomNonce??(()=>gt),i=t.randomRequestId??(()=>`req-${crypto.randomUUID().replaceAll("-","")}`),u=t.randomETag??(()=>At()),c=(n.method??"POST").toUpperCase(),f=n.target??"core",l=h(f,t.config.targets[f]),p=n.prefix??l.prefix??"",d=n.body!=null,b=Tt(n.data??{}),g=r==="/v1/feedback"&&p==="/bi/h5",D=g?false:n.encrypt??!d,B=g?false:n.sign??!d,T=o(),_=u(),tt=i(),Ut=n.token??await t.getToken?.()??"",Lt=ht(n.locale??t.getLocale?.()),S=t.getBrowserInfo?.()??Rt(n.userAgent),W={app_id:"5",os_type:"4",app_version:t.config.appVersion,sign_method:"md5",timestamp:wt(T),nonce:s()},y={...W,...b},V=W,et=b,x=y;!g&&B&&(y.sign=t.crypto.generateSign("api",t.config.envType,y,_),W.sign=y.sign);let vt={app_version:t.config.appVersion,"X-ENC-VERSION":t.config.appVersion,"X-APP-TYPE":"h5","Client-type":"2","Content-ETag":_,"brand-id":t.config.brandId,"channel-id":n.channelId||t.config.channelId,device_brand:S.deviceBrand,device_info:S.deviceInfo,device_number:S.deviceNumber,device_token:S.deviceToken,lang:Lt,"mch-id":t.config.merchantId,"req-id":tt,token:Ut},Nt=_t(n.headers),Ht=Object.fromEntries(Object.entries(Nt).filter(([A])=>!Pe.has(A.toLowerCase()))),z=r,C,P={...vt,...Ht};if(d)C=n.body??void 0,V=null,et=n.data??null,x=n.data??null;else if(g){let A=String(T.getTime()),w={"app-id":"1","app-version":t.config.appVersion,"sys-type":"h5","sys-version":S.deviceNumber,time:A};V=w,P={...P,...w,sign:dt(t.crypto,w),"Content-Type":"application/json"},C=JSON.stringify(b),x=b;}else c==="GET"?(z=Ct(z,y),x=y):D?(C=t.crypto.encryptAes(new TextEncoder().encode(JSON.stringify(y))),P["Content-Type"]=P["Content-Type"]||"application/octet-stream",x=y):(C=JSON.stringify(y),P["Content-Type"]=P["Content-Type"]||"application/json",x=y);It(C)&&delete P["Content-Type"];let J=he(z,t,n,f,p),Y=Date.now(),rt=n.timeoutMs??6e4,nt=xe(rt,n.signal),ot={requestId:tt,eTag:_,method:c,upstreamUrl:J,requestHeaders:P,requestCommonParams:V,requestBusinessParams:et,requestParams:x},U;try{let A=await t.transport({url:J,method:c,headers:P,body:C,signal:nt.signal,timeoutMs:rt,onUploadProgress:n.onUploadProgress}),w=Date.now(),R=await Ce(t,A,D&&!g,n.responseMode==="raw",ot,Y,w);return n.onResponse&&(U=St(R.meta),R.observation=U),await Dt(t,R),!n.skipBusinessResponseHandler&&t.onBusinessResponse&&await t.onBusinessResponse(R.response,{request:{path:r,method:c,target:f,url:J},options:n}),R}catch(A){let w=Date.now(),R={response:Ae(A,w),...U===void 0?{}:{observation:U},meta:{...ot,transportStatus:"network_error",timings:{totalMs:w-Y,upstreamMs:w-Y}}};return await Dt(t,R,A),R}finally{nt.dispose();}}}function Mt(t){let e=Ie(t);return async function(n,o={}){let s=await e(n,o);return await o.onResponse?.(s.observation??St(s.meta)),s.response}}function kt(t={}){let e={core:h("core",{baseUrl:t.coreBaseUrl||"",...t.targets?.core}),wallet:h("wallet",{baseUrl:t.walletBaseUrl||"",...t.targets?.wallet}),bi:h("bi",{baseUrl:t.biBaseUrl||"",...t.targets?.bi}),im:h("im",{baseUrl:t.imBaseUrl||"",...t.targets?.im})};return {appVersion:t.appVersion||"",brandId:t.brandId||"",merchantId:t.merchantId||"",channelId:t.channelId||"",envType:t.envType||"prod",targets:e}}function Bt(t={}){let e=t.axios??Oe.create();return async r=>{let n=await e.request({url:r.url,method:r.method,headers:r.headers,data:r.body,signal:r.signal,timeout:r.timeoutMs,onUploadProgress:r.onUploadProgress?o=>{let s=typeof o.progress=="number"?o.progress:typeof o.total=="number"&&o.total>0?o.loaded/o.total:void 0;r.onUploadProgress?.({loaded:o.loaded,...typeof o.total=="number"?{total:o.total}:{},...typeof s=="number"?{progress:s}:{},event:o});}:void 0,responseType:"arraybuffer",transformResponse:o=>o,validateStatus:()=>true});return {status:n.status,statusText:n.statusText,headers:n.headers,data:n.data}}}async function Xe(t={}){let e=await X(),r=kt(t.config);return Mt({...t,config:r,crypto:e,transport:t.transport??Bt()})}export{Xe as createBrowserApiProtocolClient};

package/dist/browser.d.ts

@@ -86,6 +86,20 @@ interface ApiProtocolUploadProgress {
     /** 底层 transport 的原始进度事件，供调试或特殊场景读取。 */
     event?: unknown;
 }
+/**
+ * 单次请求完成后的安全状态信息，供调用方识别 HTTP 与业务失败。
+ *
+ * 不包含请求头、URL、凭据或响应正文；HTTP 状态与后端业务码分别保留，避免把网络
+ * 失败合成的 502 或纯 HTTP 403 当成服务端业务码。原始响应仍通过请求返回值交付。
+ */
+interface ApiProtocolResponseObservation {
+    /** 请求结果所属层；成功收到业务错误信封仍属于 `success`。 */
+    transportStatus: 'success' | 'http_error' | 'network_error' | 'invalid_response';
+    /** 服务端真实 HTTP 状态；未收到响应时不存在。 */
+    httpStatus?: number;
+    /** 仅在真实响应正文是协议信封时提供其 code；不包含客户端合成的错误码。 */
+    businessCode?: number;
+}
 /**
  * 单次协议请求的可覆盖项。
  *
@@ -128,6 +142,13 @@ interface ApiProtocolRequestOptions {
     signal?: AbortSignal;
     /** 上传进度回调；默认浏览器客户端的 axios transport 支持该能力。 */
     onUploadProgress?: (progress: ApiProtocolUploadProgress) => void;
+    /**
+     * 请求完成后调用一次，只提供安全状态字段。回调异常会使请求显式失败，不会转换成网络错误。
+     * 调用方如需检查当前账号是否仍有效，可先保存这些字段，在请求返回后决定是否处理。
+     */
+    onResponse?: (observation: ApiProtocolResponseObservation) => void | Promise<void>;
+    /** 跳过客户端注入的全局业务处理器，默认 false；由调用方接管当前请求的业务副作用。 */
+    skipBusinessResponseHandler?: boolean;
     /**
      * 响应解析模式。
      * - `'json'`（默认）：按 content-type 走 JSON / 文本 / AES-JSON 解析，返回业务响应对象。

package/dist/browser.js

@@ -1 +1 @@
-export{A as createLazyBrowserApiProtocolClient}from'./chunk-YAM4YHKF.js';import'./chunk-A2BLOVZ5.js';import'./chunk-WOT6VMZA.js';
+export{A as createLazyBrowserApiProtocolClient}from'./chunk-MO2EU56Q.js';import'./chunk-W5SQGPRQ.js';import'./chunk-WOT6VMZA.js';

package/dist/chat-kit-pinia.d.ts

@@ -2478,6 +2478,20 @@ interface ApiProtocolUploadProgress {
     /** 底层 transport 的原始进度事件，供调试或特殊场景读取。 */
     event?: unknown;
 }
+/**
+ * 单次请求完成后的安全状态信息，供调用方识别 HTTP 与业务失败。
+ *
+ * 不包含请求头、URL、凭据或响应正文；HTTP 状态与后端业务码分别保留，避免把网络
+ * 失败合成的 502 或纯 HTTP 403 当成服务端业务码。原始响应仍通过请求返回值交付。
+ */
+interface ApiProtocolResponseObservation {
+    /** 请求结果所属层；成功收到业务错误信封仍属于 `success`。 */
+    transportStatus: 'success' | 'http_error' | 'network_error' | 'invalid_response';
+    /** 服务端真实 HTTP 状态；未收到响应时不存在。 */
+    httpStatus?: number;
+    /** 仅在真实响应正文是协议信封时提供其 code；不包含客户端合成的错误码。 */
+    businessCode?: number;
+}
 /**
  * 单次协议请求的可覆盖项。
  *
@@ -2520,6 +2534,13 @@ interface ApiProtocolRequestOptions {
     signal?: AbortSignal;
     /** 上传进度回调；默认浏览器客户端的 axios transport 支持该能力。 */
     onUploadProgress?: (progress: ApiProtocolUploadProgress) => void;
+    /**
+     * 请求完成后调用一次，只提供安全状态字段。回调异常会使请求显式失败，不会转换成网络错误。
+     * 调用方如需检查当前账号是否仍有效，可先保存这些字段，在请求返回后决定是否处理。
+     */
+    onResponse?: (observation: ApiProtocolResponseObservation) => void | Promise<void>;
+    /** 跳过客户端注入的全局业务处理器，默认 false；由调用方接管当前请求的业务副作用。 */
+    skipBusinessResponseHandler?: boolean;
     /**
      * 响应解析模式。
      * - `'json'`（默认）：按 content-type 走 JSON / 文本 / AES-JSON 解析，返回业务响应对象。
@@ -4426,6 +4447,17 @@ interface ConversationOpenOptions {
      * 后续 read 事件或新消息不会移动分隔线。
      */
     initialPosition?: ConversationInitialPosition;
+    /**
+     * 初始历史加载方式，默认 `blocking`。
+     *
+     * @remarks 两种模式都在句柄交付前把初始窗口和 `entryUnread` 定稿，交付后不会再因本次初始化替换窗口或补填未读锚点，
+     * 因此交付的快照 `loading` 已经结束。区别只在失败处理：`blocking` 下初始历史失败会拒绝 `openConversation`；
+     * `local-first` 先读出本地最新页，之后的远端补齐失败不再拒绝打开，而是保留失败时的当前连续窗口、把失败写入
+     * `error`（`operation` 为 `history.initial`），并把 `first-unread` 的 `entryUnread` 降级为 `unavailable`，
+     * 由调用方用 `history` 动作重试。窗口可能已经定位在历史锚点，`hasNewer` 仍按实际边界返回。
+     * 两种模式下首屏窗口的本地读取失败都拒绝打开，并保留原始异常。
+     */
+    initialLoad?: 'blocking' | 'local-first';
 }
 /**
  * 产品会话的连续窗口快照；协议 cursor、窗口 id 与 generation 始终保持在 SDK 内部。
@@ -5318,6 +5350,39 @@ interface ImMembershipJoinResult {
     outcome: 'joined' | 'waiting';
 }
 
+/**
+ * SDK 自管 Core JSON / CM HTTP 请求的失败事实，交由宿主决定是否触发全局处理。
+ *
+ * 不包含 URL、响应正文、服务端文案或凭据。`httpStatus` 与 `businessCode` 分别来自 HTTP
+ * 响应和真实业务响应体；网络失败没有 HTTP 状态，合成的 502 不会冒充业务码。
+ * S3、Giphy 和宿主自己发出的请求不属于这两个服务，不会被当作账号认证失败上报。
+ */
+interface ImRequestError {
+    /** 返回错误的服务；宿主不能把 CM 成员权限错误等同于 Core 账号失效。 */
+    readonly service: 'core' | 'cm';
+    /** 失败发生在哪一层；同时有 HTTP 和业务失败时，优先标为 `http`。 */
+    readonly kind: 'http' | 'business' | 'network' | 'invalid-response';
+    /** 实际 HTTP 状态；没有收到响应时不存在。 */
+    readonly httpStatus?: number;
+    /** Core 返回的真实业务码；CM protobuf 请求不提供该字段。 */
+    readonly businessCode?: number;
+}
+/**
+ * 宿主的全局请求错误入口；SDK 不依据返回值重试、登出或改变原调用的结果。
+ *
+ * 每个失败请求通知一次，重复提示策略由宿主现有全局处理器负责。调用前 SDK 会核对账号、
+ * 实际发送凭据及运行时是否仍有效；异步处理器应在第一次 await 前完成需要当前登录态的决策。
+ * 回调抛错或拒绝只进入 SDK 诊断，不会替换请求本身的失败。不会等待回调中的登录/退出操作，
+ * 避免宿主退出流程等待当前请求时互相阻塞。
+ *
+ * @example
+ * ```ts
+ * const onRequestError: ImRequestErrorHandler = issue => appErrors.handleImRequest(issue)
+ * const client = createImClient({ authProvider, endpointProvider, cache, onRequestError })
+ * ```
+ */
+type ImRequestErrorHandler = (issue: ImRequestError) => void | Promise<void>;
+
 /**
  * 当前账号本地会话与消息的分场景产品搜索运行时。
  *
@@ -5586,6 +5651,8 @@ interface ImClientAdapters {
  * ```
  */
 interface ImClientOptions {
+    /** HTTP/业务失败交给宿主全局处理；SDK 不自动登出，详见 ImRequestErrorHandler。 */
+    onRequestError?: ImRequestErrorHandler;
     authProvider: ImAuthProvider;
     endpointProvider: ImEndpointProvider;
     /** 所有 SDK 自管本地数据与协调名称的宿主前缀；创建 client 时同步校验。 */
@@ -6207,6 +6274,8 @@ interface ChatRuntimeHostDeps {
     } | null;
     /** 返回 core JSON 部署配置；未提供 core client 时由 SDK 内部协议工厂创建等价 client。 */
     getCoreApi?: () => ImCoreApiOptions | undefined;
+    /** HTTP/业务错误交回宿主的全局处理器；Chat Kit 不依据状态码作登录决策。 */
+    onRequestError?: ImRequestErrorHandler;
     /** 当前宿主的客户端类型编号，随登录请求上报，PC Web 默认使用自己的固定类型。 */
     clientType: number;
     /** 获取当前环境的媒体上传下载配置；未启用媒体能力时返回 `undefined`。 */
@@ -6740,22 +6809,24 @@ declare function getImChatKitContext(pinia: Pinia): ImChatKitContext;
 /** 释放指定 Pinia 下全部 IM Store 和 Runtime；未安装时不执行任何操作。 */
 declare function disposeImChatKit(pinia: Pinia): void;
 
-type ProductConversationRef$5 = ConversationRef<ProductHandleConversationType>;
+type ProductConversationRef$6 = ConversationRef<ProductHandleConversationType>;
 /** 宿主可据此决定反馈的安全错误；底层 cause/details 只允许进入统一诊断。 */
 type ImConversationActivationError = Readonly<Omit<ImSdkErrorShape, 'cause' | 'details'>>;
 /**
  * 共享会话激活的稳定结果。
  *
- * 成功后宿主才提交路由/面板选择；`stale` 表示该意图已被更新点击、切账号或 Context dispose 取代。
+ * 成功表示已绑定首屏窗口和未读入口已定稿的目标句柄；首屏补齐错误及后续分页状态从 Thread Store 读取。
+ * 等待激活期间的页面外壳和加载提示由宿主展示。
+ * `stale` 表示该意图已被更新点击、切账号或 Context dispose 取代。
  */
 type ImConversationActivationResult = Readonly<{
     ok: true;
     status: 'opened';
-    conversation: ProductConversationRef$5;
+    conversation: ProductConversationRef$6;
 } | {
     ok: false;
     reason: 'draft-save-failed' | 'open-failed';
-    conversation: ProductConversationRef$5;
+    conversation: ProductConversationRef$6;
     error: ImConversationActivationError;
 } | {
     ok: false;
@@ -6764,29 +6835,32 @@ type ImConversationActivationResult = Readonly<{
 }>;
 /** 按单个 Pinia 串联 Composer 与 Thread Store 的无 UI coordinator。 */
 interface ImConversationActivationCoordinator {
-    activate: (conversation: ConversationRef) => Promise<ImConversationActivationResult>;
+    /** signal 取消本次在途激活；保留已显示线程，不影响之后开始的激活。 */
+    activate: (conversation: ConversationRef, options?: {
+        signal?: AbortSignal;
+    }) => Promise<ImConversationActivationResult>;
 }
 /**
  * 取得当前 Vue setup 或显式 Pinia 的会话激活 coordinator。
  *
  * coordinator 没有响应式产品状态；每个 Pinia 只持有 operation epoch，用于在草稿 flush 和 Thread open
- * 之间判定新点击、账号 generation 变化与 dispose。调用方不得根据 Thread 中间态提前提交宿主选择。
+ * 之间判定新点击、账号 generation 变化与 dispose。宿主可先展示目标页，但只有 exact handle 成功后才能展示线程内容。
  */
 declare function useImConversationActivationCoordinator(pinia?: Pinia): ImConversationActivationCoordinator;
 
-type ProductConversationRef$4 = ConversationRef<ProductConversationListType>;
+type ProductConversationRef$5 = ConversationRef<ProductConversationListType>;
 /** 删除失败时提供给宿主映射反馈的安全错误，不暴露底层 cause/details。 */
 type ImConversationDeletionError = Readonly<Omit<ImSdkErrorShape, 'cause' | 'details'>>;
 /** local-only 删除的稳定结果；成功只代表 SDK 已同步提交当前内存删除，不代表 durable 存储已完成。 */
 type ImConversationDeletionResult = Readonly<{
     ok: true;
     status: 'deleted';
-    conversation: ProductConversationRef$4;
+    conversation: ProductConversationRef$5;
     activeConversationCleared: boolean;
 } | {
     ok: false;
     reason: 'delete-failed';
-    conversation: ProductConversationRef$4;
+    conversation: ProductConversationRef$5;
     error: ImConversationDeletionError;
 } | {
     ok: false;
@@ -6805,7 +6879,7 @@ interface ImConversationDeletionCoordinator {
  */
 declare function useImConversationDeletionCoordinator(pinia?: Pinia): ImConversationDeletionCoordinator;
 
-type ProductConversationRef$3 = ConversationRef<ProductConversationListType>;
+type ProductConversationRef$4 = ConversationRef<ProductConversationListType>;
 type ImConversationListMutationOperation = 'set-pinned' | 'set-muted' | 'mark-read' | 'mark-unread' | 'delete-local';
 /** 会话列表动作失败时返回给宿主的安全错误；底层 cause/details 不跨出共享 Store。 */
 type ImConversationListActionError = Readonly<Omit<ImSdkErrorShape, 'cause' | 'details'>>;
@@ -6832,11 +6906,11 @@ interface ImConversationListStore {
     start: () => void;
     reset: () => void;
     refresh: () => Promise<ImConversationListRefreshResult>;
-    setPinned: (ref: ProductConversationRef$3, pinned: boolean) => ImConversationListMutationResult;
-    setMuted: (ref: ProductConversationRef$3, muted: boolean) => Promise<ImConversationListMutationResult>;
-    markRead: (ref: ProductConversationRef$3) => Promise<ImConversationListMutationResult>;
-    markUnread: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
-    deleteLocal: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
+    setPinned: (ref: ProductConversationRef$4, pinned: boolean) => ImConversationListMutationResult;
+    setMuted: (ref: ProductConversationRef$4, muted: boolean) => Promise<ImConversationListMutationResult>;
+    markRead: (ref: ProductConversationRef$4) => Promise<ImConversationListMutationResult>;
+    markUnread: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
+    deleteLocal: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
     dispose: () => void;
 }
 /**
@@ -6848,17 +6922,17 @@ interface ImConversationListStore {
 type ImConversationListMutationResult = Readonly<{
     ok: true;
     operation: ImConversationListMutationOperation;
-    conversation: ProductConversationRef$3;
+    conversation: ProductConversationRef$4;
 } | {
     ok: false;
     operation: ImConversationListMutationOperation;
     reason: 'stale';
-    conversation: ProductConversationRef$3;
+    conversation: ProductConversationRef$4;
 } | {
     ok: false;
     operation: ImConversationListMutationOperation;
     reason: 'failed';
-    conversation: ProductConversationRef$3;
+    conversation: ProductConversationRef$4;
     error: ImConversationListActionError;
 }>;
 declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-conversation-list", Pick<{
@@ -6869,11 +6943,11 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     start: () => void;
     reset: () => void;
     refresh: () => Promise<ImConversationListRefreshResult>;
-    setPinned: (ref: ProductConversationRef$3, pinned: boolean) => ImConversationListMutationResult;
-    setMuted: (ref: ProductConversationRef$3, muted: boolean) => Promise<ImConversationListMutationResult>;
-    markRead: (ref: ProductConversationRef$3) => Promise<ImConversationListMutationResult>;
-    markUnread: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
-    deleteLocal: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
+    setPinned: (ref: ProductConversationRef$4, pinned: boolean) => ImConversationListMutationResult;
+    setMuted: (ref: ProductConversationRef$4, muted: boolean) => Promise<ImConversationListMutationResult>;
+    markRead: (ref: ProductConversationRef$4) => Promise<ImConversationListMutationResult>;
+    markUnread: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
+    deleteLocal: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
     dispose: () => void;
 }, any>, Pick<{
     items: any;
@@ -6883,11 +6957,11 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     start: () => void;
     reset: () => void;
     refresh: () => Promise<ImConversationListRefreshResult>;
-    setPinned: (ref: ProductConversationRef$3, pinned: boolean) => ImConversationListMutationResult;
-    setMuted: (ref: ProductConversationRef$3, muted: boolean) => Promise<ImConversationListMutationResult>;
-    markRead: (ref: ProductConversationRef$3) => Promise<ImConversationListMutationResult>;
-    markUnread: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
-    deleteLocal: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
+    setPinned: (ref: ProductConversationRef$4, pinned: boolean) => ImConversationListMutationResult;
+    setMuted: (ref: ProductConversationRef$4, muted: boolean) => Promise<ImConversationListMutationResult>;
+    markRead: (ref: ProductConversationRef$4) => Promise<ImConversationListMutationResult>;
+    markUnread: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
+    deleteLocal: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
     dispose: () => void;
 }, any>, Pick<{
     items: any;
@@ -6897,11 +6971,11 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     start: () => void;
     reset: () => void;
     refresh: () => Promise<ImConversationListRefreshResult>;
-    setPinned: (ref: ProductConversationRef$3, pinned: boolean) => ImConversationListMutationResult;
-    setMuted: (ref: ProductConversationRef$3, muted: boolean) => Promise<ImConversationListMutationResult>;
-    markRead: (ref: ProductConversationRef$3) => Promise<ImConversationListMutationResult>;
-    markUnread: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
-    deleteLocal: (ref: ProductConversationRef$3) => ImConversationListMutationResult;
+    setPinned: (ref: ProductConversationRef$4, pinned: boolean) => ImConversationListMutationResult;
+    setMuted: (ref: ProductConversationRef$4, muted: boolean) => Promise<ImConversationListMutationResult>;
+    markRead: (ref: ProductConversationRef$4) => Promise<ImConversationListMutationResult>;
+    markUnread: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
+    deleteLocal: (ref: ProductConversationRef$4) => ImConversationListMutationResult;
     dispose: () => void;
 }, any>>;
 type InternalImConversationListStore = ReturnType<ReturnType<typeof defineImConversationListStore>>;
@@ -7061,7 +7135,7 @@ type ImExpressionStore = Store<'k2-im-expression', ImExpressionStoreState, ImExp
  */
 declare function useImExpressionStore(pinia?: Pinia): ImExpressionStore;
 
-type ProductConversationRef$2 = ConversationRef<ProductHandleConversationType>;
+type ProductConversationRef$3 = ConversationRef<ProductHandleConversationType>;
 /** 返回最新页失败时给宿主的安全错误；底层 cause/details 只进入统一诊断。 */
 type ImHistoryReturnError = Readonly<Omit<ImSdkErrorShape, 'cause' | 'details'>>;
 /** 历史窗口发送后的稳定结算；宿主只在 `applied` 时执行自己的 DOM 滚动。 */
@@ -7069,10 +7143,10 @@ type ImHistoryReturnResult = Readonly<{
     status: 'not-needed';
 } | {
     status: 'applied' | 'stale';
-    conversation: ProductConversationRef$2;
+    conversation: ProductConversationRef$3;
 } | {
     status: 'failed';
-    conversation: ProductConversationRef$2;
+    conversation: ProductConversationRef$3;
     error: ImHistoryReturnError;
 }>;
 /** 保留原发送动作的返回值，并把独立的历史窗口结算交给宿主消费。 */
@@ -7092,33 +7166,6 @@ interface ImHistoryReturnAfterSendCoordinator {
  */
 declare function useImHistoryReturnAfterSendCoordinator(pinia?: Pinia): ImHistoryReturnAfterSendCoordinator;
 
-/**
- * 为页面展示当前账号的媒体上传/下载进度，并提供取消、重试和重新选择原文件入口。
- *
- * 【状态从哪里来】
- * Store 订阅 SDK 的完整媒体任务列表，向页面提供任务、当前线程每条消息的上传百分比、是否还在排队等
- * 上传槽位、是否正在完成最后处理以及稳定错误。传输、任务状态、消息状态、取消和重试都由 SDK 维护；Store 不模拟进度，也不
- * 创建第二套上传队列。
- *
- * 【提供的能力】
- * - `start` / `reset`：开始监听当前 SDK Client，或切账号时退订并清空旧任务。
- * - `cancel` / `retry`：按 SDK 给出的任务 ID 取消或重试。
- * - `cancelUpload`：根据当前会话类型、会话 ID 和消息 ID 找到唯一上传任务后取消。
- * - `cancelDownload`：按消息身份取消在途下载；合集要带项下标，因为一条合集的每一项是独立任务。
- *   与 `cancelUpload` 不同，它定位任务时不看当前会话——切会话正是关闭预览的路径之一。
- *   取消是任务级的，同一下载的所有等待方都会一起收到取消，只有唯一消费者才该调它。
- * - `requestReplacement` / `takeReplacementRequest`：视频或文件刷新后失去本地源时，生成一次重新选择请求；
- *   宿主取走意图后自行打开平台文件选择器，File 本身不会写入 Store。
- *
- * 【安全、并发与资源边界】
- * 页面任务会删除 SDK 错误中的底层原因和详情，只保留错误码、分类和是否可重试。File、Blob、本地地址、
- * 播放器、中止控制器、传输能力、Client 和订阅函数都不能进入 `$state`。Store 同时核对当前 Client、
- * 账号版本号和绑定序号；旧账号任务或旧操作晚返回时只得到 `stale`，不会更新新页面。
- *
- * 【明确不负责】
- * 文件选择、预览、录音权限、播放器、Blob URL 生命周期、toast 和页面布局属于浏览器或宿主平台能力。
- */
-
 /** 页面可保存和判断的媒体错误；底层响应、异常对象和详情只进入统一诊断，不进入 Pinia。 */
 type ImMediaStoreError = Readonly<Omit<ImSdkErrorShape, 'cause' | 'details'>>;
 /** 页面可展示的只读媒体任务；不含文件字节、本地地址、密钥、中止控制器或传输对象。 */
@@ -7150,8 +7197,67 @@ type ImMediaOperationResult = Readonly<{
  * 宿主既有的 `downloadProgress[message.id]` 读法不受影响。
  */
 declare function imMediaDownloadKey(messageId: string, itemIndex?: number): string;
+declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-media", Pick<{
+    tasks: any;
+    error: any;
+    uploadProgress: any;
+    downloadTasks: any;
+    downloadProgress: any;
+    uploadWaiting: any;
+    uploadFinalizing: any;
+    replacementRequest: any;
+    start: () => void;
+    reset: () => void;
+    cancel: (taskId: string) => Promise<ImMediaOperationResult>;
+    retry: (taskId: string) => Promise<ImMediaOperationResult>;
+    cancelUpload: (messageId: string) => Promise<ImMediaOperationResult>;
+    cancelDownload: (messageId: string, itemIndex?: number) => Promise<ImMediaOperationResult>;
+    requestReplacement: (message: ImMessageView) => boolean;
+    takeReplacementRequest: () => ImMediaReplacementRequest | null;
+    clearReplacementRequest: () => void;
+    dispose: () => void;
+}, any>, Pick<{
+    tasks: any;
+    error: any;
+    uploadProgress: any;
+    downloadTasks: any;
+    downloadProgress: any;
+    uploadWaiting: any;
+    uploadFinalizing: any;
+    replacementRequest: any;
+    start: () => void;
+    reset: () => void;
+    cancel: (taskId: string) => Promise<ImMediaOperationResult>;
+    retry: (taskId: string) => Promise<ImMediaOperationResult>;
+    cancelUpload: (messageId: string) => Promise<ImMediaOperationResult>;
+    cancelDownload: (messageId: string, itemIndex?: number) => Promise<ImMediaOperationResult>;
+    requestReplacement: (message: ImMessageView) => boolean;
+    takeReplacementRequest: () => ImMediaReplacementRequest | null;
+    clearReplacementRequest: () => void;
+    dispose: () => void;
+}, any>, Pick<{
+    tasks: any;
+    error: any;
+    uploadProgress: any;
+    downloadTasks: any;
+    downloadProgress: any;
+    uploadWaiting: any;
+    uploadFinalizing: any;
+    replacementRequest: any;
+    start: () => void;
+    reset: () => void;
+    cancel: (taskId: string) => Promise<ImMediaOperationResult>;
+    retry: (taskId: string) => Promise<ImMediaOperationResult>;
+    cancelUpload: (messageId: string) => Promise<ImMediaOperationResult>;
+    cancelDownload: (messageId: string, itemIndex?: number) => Promise<ImMediaOperationResult>;
+    requestReplacement: (message: ImMessageView) => boolean;
+    takeReplacementRequest: () => ImMediaReplacementRequest | null;
+    clearReplacementRequest: () => void;
+    dispose: () => void;
+}, any>>;
+type ImMediaStore = ReturnType<ReturnType<typeof defineImMediaStore>>;
 /** 取得当前 Vue setup 或显式 Pinia 的媒体任务 Store；不会隐式创建 Runtime。 */
-declare function useImMediaStore(pinia?: Pinia): any;
+declare function useImMediaStore(pinia?: Pinia): ImMediaStore;
 
 /**
  * 执行“把当前会话中的一条或多条消息转发到若干目标会话”。
@@ -8351,30 +8457,20 @@ type ImReactionStore = Store<'k2-im-reaction', ImReactionStoreState, Record<stri
 declare function useImReactionStore(pinia?: Pinia): ImReactionStore;
 
 /**
- * 为当前聊天线程提供关键词搜索、分类媒体浏览、结果续页和跳转到原消息。
- *
- * 【对外状态】
- * Store 暴露关键词、全部/文件/图片/视频/语音分类、结果列表、搜索状态、是否还有下一页、正在定位的
- * 消息 ID、短暂高亮 ID 与稳定错误。SDK 仍维护搜索索引、消息历史窗口和真实分页位置，Pinia 只保存
- * 当前搜索面板需要展示的状态。
- *
- * 【提供的能力】
- * - `search`：更新关键词，用户停止输入 250ms 后执行，避免每个按键都发请求。
- * - `setCategory`：切换消息、文件、图片、视频或语音产品入口。
- * - `loadMore`：使用闭包中不可解析的分页凭证继续同一次查询。
- * - `locate`：让当前线程加载目标消息附近的历史并发布定位 ID；宿主完成实际滚动后，高亮 ID 再保留 2 秒。
- * - `clearLocation` / `reset`：结束定位或作废当前查询生命周期；`reset({ preserveLocation: true })` 可在关闭搜索面板时保留刚写入的高亮。
+ * 读取当前会话的消息搜索结果和分类媒体列表。
  *
- * 【并发与身份隔离】
- * 分页凭证、定时器、会话句柄、请求序号和账号版本号全部留在闭包。切查询、分类、会话、账号或
- * 销毁 Store 会把等待/在途任务结算为 `stale`；同 ID 的单聊、普通群和社群始终按类型 + ID 隔离。旧任务
- * 不能关闭新任务的 loading，也不能覆盖新结果、错误或高亮。
+ * 全部消息按关键词搜索；文件既可按名称搜索也可浏览；图片、视频和语音按分类浏览。单聊、普通群和
+ * 社群会调用各自的 SDK 搜索能力。分页位置由 SDK 封装成 `ImPageToken`，调用方只能原样传回续页，
+ * 不能解析或修改其中的账号、会话和查询条件。
  *
- * 【明确不负责】
- * Store 不访问滚动容器，不决定搜索面板、空态和反馈文案。宿主监听 `highlightMessageId` 后完成实际
- * DOM 居中/高亮；分页凭证、协议续页位置与底层响应不会暴露给宿主。
+ * 防抖、当前查询状态、切账号/切会话后的旧结果丢弃由 Search Store 负责。本 Service 只取一批结果，
+ * 并在底层出现稀疏空页时有限地向后查找，避免页面误显示“没有结果”。
  */
 
+/** 搜索面板可选择的业务分类：全部/文本走关键词；文件可空词浏览；图/音/视频按类型浏览。 */
+type ConversationSearchCategory = 'all' | 'text' | 'image' | 'video' | 'file' | 'voice';
+
+type ProductConversationRef$2 = ConversationRef<ProductHandleConversationType>;
 type SearchOperation = 'search' | 'load-more' | 'locate';
 /** 搜索、续页或定位结果；宿主只按操作和原因决定反馈，不解析 SDK 底层异常。 */
 type ImSearchOperationResult = Readonly<{
@@ -8386,8 +8482,67 @@ type ImSearchOperationResult = Readonly<{
     reason: 'not-ready' | 'no-condition' | 'busy' | 'exhausted' | 'stale' | 'failed';
     error?: ImSdkErrorShape;
 }>;
+declare function defineImSearchStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-search", Pick<{
+    keyword: any;
+    results: any;
+    searching: any;
+    hasMore: any;
+    category: any;
+    locatingMessageId: any;
+    highlightMessageId: any;
+    error: any;
+    search: (nextKeyword: string) => Promise<ImSearchOperationResult>;
+    setCategory: (nextCategory: ConversationSearchCategory) => Promise<ImSearchOperationResult>;
+    loadMore: () => Promise<ImSearchOperationResult>;
+    locate: (ref: ProductConversationRef$2, messageId: string) => Promise<ImSearchOperationResult>;
+    completeLocation: (messageId: string) => boolean;
+    clearLocation: () => void;
+    reset: (options?: {
+        preserveLocation?: boolean;
+    }) => void;
+    dispose: () => void;
+}, any>, Pick<{
+    keyword: any;
+    results: any;
+    searching: any;
+    hasMore: any;
+    category: any;
+    locatingMessageId: any;
+    highlightMessageId: any;
+    error: any;
+    search: (nextKeyword: string) => Promise<ImSearchOperationResult>;
+    setCategory: (nextCategory: ConversationSearchCategory) => Promise<ImSearchOperationResult>;
+    loadMore: () => Promise<ImSearchOperationResult>;
+    locate: (ref: ProductConversationRef$2, messageId: string) => Promise<ImSearchOperationResult>;
+    completeLocation: (messageId: string) => boolean;
+    clearLocation: () => void;
+    reset: (options?: {
+        preserveLocation?: boolean;
+    }) => void;
+    dispose: () => void;
+}, any>, Pick<{
+    keyword: any;
+    results: any;
+    searching: any;
+    hasMore: any;
+    category: any;
+    locatingMessageId: any;
+    highlightMessageId: any;
+    error: any;
+    search: (nextKeyword: string) => Promise<ImSearchOperationResult>;
+    setCategory: (nextCategory: ConversationSearchCategory) => Promise<ImSearchOperationResult>;
+    loadMore: () => Promise<ImSearchOperationResult>;
+    locate: (ref: ProductConversationRef$2, messageId: string) => Promise<ImSearchOperationResult>;
+    completeLocation: (messageId: string) => boolean;
+    clearLocation: () => void;
+    reset: (options?: {
+        preserveLocation?: boolean;
+    }) => void;
+    dispose: () => void;
+}, any>>;
+type ImSearchStore = ReturnType<ReturnType<typeof defineImSearchStore>>;
 /** 取得当前 Vue setup 或显式 Pinia 的搜索 Store；不同宿主实例不会共享查询或定位状态。 */
-declare function useImSearchStore(pinia?: Pinia): any;
+declare function useImSearchStore(pinia?: Pinia): ImSearchStore;
 
 /**
  * 为 PC/H5 提供同一套会话收藏列表和已收藏标记。
@@ -8652,4 +8807,4 @@ type MessageNotificationDecision = {
 declare function resolveMessageNotificationDecision(input: MessageNotificationInput): MessageNotificationDecision;
 
 export { applicationKey, createAndInstallImChatKit, createImChatKitContext, disposeImChatKit, ensureImChatKitSelfProfile, getImChatKitContext, imMediaDownloadKey, installImChatKit, resolveMessageNotificationDecision, useImApplicationsStore, useImCapabilitiesStore, useImComposerStore, useImConversationActivationCoordinator, useImConversationDeletionCoordinator, useImConversationListStore, useImExpressionStore, useImHistoryReturnAfterSendCoordinator, useImMediaStore, useImMessageOperationsStore, useImProfileDirectoryStore, useImQuotedMessageStore, useImReactionStore, useImSearchStore, useImSessionFavoritesStore, useImSessionStore, useImThreadPagingStore, useImThreadReturnToLatestCoordinator, useImThreadStore };
-export type { ApplyImSessionInput, ChatRuntimeFactories, ChatRuntimeHostDeps, ImApplicationDomainCounts, ImApplicationReviewOperation, ImApplicationReviewResult, ImApplicationsReloadResult, ImApplicationsStoreError, ImCapabilitiesStore, ImChannelManagementMemberTarget, ImChannelMemberManagementOperation, ImChannelMemberManagementResult, ImChannelMemberManagementResultFor, ImChannelProfileActionResult, ImChannelProfileActionResultFor, ImChannelProfileOperation, ImChatKitContext, ImChatKitInstallation, ImComposerStore, ImComposerStoreActions, ImComposerStoreState, ImComposerSubmitResult, ImConversationActivationCoordinator, ImConversationActivationError, ImConversationActivationResult, ImConversationDeletionCoordinator, ImConversationDeletionError, ImConversationDeletionResult, ImConversationListActionError, ImConversationListMutationOperation, ImConversationListMutationResult, ImConversationListRefreshResult, ImConversationListStore, ImDirectContactActionResult, ImDirectContactActionResultFor, ImDirectContactOperation, ImDirectoryState, ImEmojiPanelRecentEntry, ImEmojiRecentEntry, ImExpressionLoadStatus, ImExpressionOperation, ImExpressionOperationResult, ImExpressionRecentPersistencePort, ImExpressionRecentPersistenceSnapshot, ImExpressionRecentViewItem, ImExpressionResetOptions, ImExpressionSendResult, ImExpressionStore, ImExpressionStoreActions, ImExpressionStoreError, ImExpressionStoreGetters, ImExpressionStoreState, ImForwardPreparationResult, ImGameRecentEntry, ImGroupMemberManagementOperation, ImGroupMemberManagementResult, ImGroupMemberManagementResultFor, ImGroupProfileActionResult, ImGroupProfileActionResultFor, ImGroupProfileOperation, ImHistoryReturnAfterSendCoordinator, ImHistoryReturnError, ImHistoryReturnExecution, ImHistoryReturnResult, ImMediaOperationResult, ImMediaReplacementRequest, ImMediaStoreError, ImMediaTaskPresentation, ImMembershipJoinActionResult, ImMembershipJoinOperation, ImMessageOperationsStore, ImMessageOperationsStoreActions, ImMessageOperationsStoreState, ImMessageSelectionResult, ImPersistedEmojiPanelRecentEntry, ImPersistedEmojiRecentEntry, ImPersistedExpressionAssetRecentEntry, ImPersistedGameRecentEntry, ImProfileAccessDestination, ImProfileAccessResult, ImProfileDirectoryResult, ImQuotedMessageState, ImQuotedMessageStore, ImQuotedMessageStoreActions, ImQuotedMessageStoreState, ImReactionOperationResult, ImReactionStore, ImReactionStoreActions, ImReactionStoreError, ImReactionStoreState, ImSearchOperationResult, ImSessionFavoritesReloadResult, ImSessionFavoritesStoreError, ImSessionFavoritesWriteResult, ImSessionPhase, ImSessionStore, ImThreadPagingActions, ImThreadPagingState, ImThreadPagingStore, ImThreadReturnToLatestCoordinator, ImThreadStore, ImThreadStoreActions, ImThreadStoreState };
+export type { ApplyImSessionInput, ChatRuntimeFactories, ChatRuntimeHostDeps, ImApplicationDomainCounts, ImApplicationReviewOperation, ImApplicationReviewResult, ImApplicationsReloadResult, ImApplicationsStoreError, ImCapabilitiesStore, ImChannelManagementMemberTarget, ImChannelMemberManagementOperation, ImChannelMemberManagementResult, ImChannelMemberManagementResultFor, ImChannelProfileActionResult, ImChannelProfileActionResultFor, ImChannelProfileOperation, ImChatKitContext, ImChatKitInstallation, ImComposerStore, ImComposerStoreActions, ImComposerStoreState, ImComposerSubmitResult, ImConversationActivationCoordinator, ImConversationActivationError, ImConversationActivationResult, ImConversationDeletionCoordinator, ImConversationDeletionError, ImConversationDeletionResult, ImConversationListActionError, ImConversationListMutationOperation, ImConversationListMutationResult, ImConversationListRefreshResult, ImConversationListStore, ImDirectContactActionResult, ImDirectContactActionResultFor, ImDirectContactOperation, ImDirectoryState, ImEmojiPanelRecentEntry, ImEmojiRecentEntry, ImExpressionLoadStatus, ImExpressionOperation, ImExpressionOperationResult, ImExpressionRecentPersistencePort, ImExpressionRecentPersistenceSnapshot, ImExpressionRecentViewItem, ImExpressionResetOptions, ImExpressionSendResult, ImExpressionStore, ImExpressionStoreActions, ImExpressionStoreError, ImExpressionStoreGetters, ImExpressionStoreState, ImForwardPreparationResult, ImGameRecentEntry, ImGroupMemberManagementOperation, ImGroupMemberManagementResult, ImGroupMemberManagementResultFor, ImGroupProfileActionResult, ImGroupProfileActionResultFor, ImGroupProfileOperation, ImHistoryReturnAfterSendCoordinator, ImHistoryReturnError, ImHistoryReturnExecution, ImHistoryReturnResult, ImMediaOperationResult, ImMediaReplacementRequest, ImMediaStore, ImMediaStoreError, ImMediaTaskPresentation, ImMembershipJoinActionResult, ImMembershipJoinOperation, ImMessageOperationsStore, ImMessageOperationsStoreActions, ImMessageOperationsStoreState, ImMessageSelectionResult, ImPersistedEmojiPanelRecentEntry, ImPersistedEmojiRecentEntry, ImPersistedExpressionAssetRecentEntry, ImPersistedGameRecentEntry, ImProfileAccessDestination, ImProfileAccessResult, ImProfileDirectoryResult, ImQuotedMessageState, ImQuotedMessageStore, ImQuotedMessageStoreActions, ImQuotedMessageStoreState, ImReactionOperationResult, ImReactionStore, ImReactionStoreActions, ImReactionStoreError, ImReactionStoreState, ImSearchOperationResult, ImSearchStore, ImSessionFavoritesReloadResult, ImSessionFavoritesStoreError, ImSessionFavoritesWriteResult, ImSessionPhase, ImSessionStore, ImThreadPagingActions, ImThreadPagingState, ImThreadPagingStore, ImThreadReturnToLatestCoordinator, ImThreadStore, ImThreadStoreActions, ImThreadStoreState };