@0xchain/request 1.1.0-beta.9 → 1.1.0-beta.91

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present 0xchain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,6 +10,7 @@ This library was generated with [Nx](https://nx.dev).
 - 自动添加通用请求头
 - 统一的错误处理
 - 支持返回完整响应对象（包含 headers 信息）
+- 业务信封可选 `toast` 时，客户端派发 `xchain-response-toast`
 
 ## 使用方法
 
@@ -68,6 +69,18 @@ if (response.status === 201) {
 }
 ```
 
+### 响应体 toast
+
+成功信封可带可选字段 `toast: { amount, title? }`。客户端会派发 `xchain-response-toast`（导出常量 `RESPONSE_TOAST_EVENT`），业务自行监听并展示；SSR 不会派发。没有 toast 时后端应省略该字段。
+
+```typescript
+import axiosInstance, { RESPONSE_TOAST_EVENT } from '@0xchain/request';
+
+window.addEventListener(RESPONSE_TOAST_EVENT, (event) => {
+  const toast = (event as CustomEvent).detail; // { amount, title? }
+});
+```
+
 ## API 配置选项
 
 ### ApiRequestConfig

package/dist/index.d.ts

@@ -1,15 +1,21 @@
 import { AxiosError } from 'axios';
+import { ResponseToast } from './responseToast';
 export interface ApiResponse<T> {
     status: {
         code: number;
         msg: string;
     };
     data: T;
+    toast?: ResponseToast;
 }
 export interface ApiError extends AxiosError {
     need?: boolean;
 }
 declare const axiosInstance: import('axios').AxiosInstance;
 export default axiosInstance;
-export type { ApiRequestConfig, Pagination, Status, IResponse, IFilters, IPageRequest, } from './types';
+export { setServerHeaderProvider, setClientLocales } from './interceptors/commonHeader';
+export { refreshAccessToken, getCurrentAccessToken } from './tokenRefresh';
+export { RESPONSE_TOAST_EVENT, emitResponseToast, parseResponseToast, } from './responseToast';
+export type { ResponseToast } from './responseToast';
+export type { ApiRequestConfig, ServerHeaderProvider, Pagination, Status, IResponse, IFilters, IPageRequest, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAQ/C,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,QAAA,MAAM,aAAa,+BAYjB,CAAC;AASH,eAAe,aAAa,CAAC;AAE7B,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAM/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,QAAA,MAAM,aAAa,+BAYjB,CAAC;AASH,eAAe,aAAa,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -1,18 +1,34 @@
 import axios, { isAxiosError, AxiosError } from "axios";
 import qs from "qs";
 import jsCookie from "js-cookie";
+import { envCookieName, getToken, removeAllToken, isTokenExpired } from "@0xchain/token";
 import { logger } from "@0xchain/logger";
-import TokenManager, { isTokenExpired, getToken, removeAllToken } from "@0xchain/token";
 const isSimplifiedChinese = () => {
-  return /^(zh-hans|zh-cn|zh-sg|zh-my)$/.test(window == null ? void 0 : window.navigator.language.toLowerCase());
+  return /^(zh-hans|zh-cn|zh-sg|zh-my)$/.test(window?.navigator.language.toLowerCase());
 };
 const matchSystemLanguage = () => {
   return isSimplifiedChinese() ? "zh-hans" : "";
 };
+function isServerRuntime() {
+  if (typeof window !== "undefined") {
+    return false;
+  }
+  return true;
+}
 let httpAgent;
 let httpsAgent;
-function isServerRuntime() {
-  return typeof window === "undefined" || process.env.IS_SERVER === "true";
+let serverHeaderProvider;
+function setServerHeaderProvider(provider) {
+  serverHeaderProvider = provider;
+}
+let clientLocales;
+function setClientLocales(locales) {
+  clientLocales = locales;
+}
+function getUrlLocale() {
+  if (typeof window === "undefined" || !clientLocales?.length) return void 0;
+  const seg = window.location.pathname.split("/")[1];
+  return seg && clientLocales.includes(seg) ? seg : void 0;
 }
 function isEdgeRuntime() {
   return process.env.NEXT_RUNTIME === "edge" || typeof globalThis.EdgeRuntime !== "undefined";
@@ -22,51 +38,61 @@ function isNodeRuntime() {
 }
 function getHeader(config, key) {
   const h = config.headers;
-  if ((h == null ? void 0 : h.get) && typeof h.get === "function") return h.get(key);
-  return h == null ? void 0 : h[key];
+  if (h?.get && typeof h.get === "function") return h.get(key);
+  return h?.[key];
 }
 function setHeader(config, key, value) {
   const h = config.headers;
-  if ((h == null ? void 0 : h.set) && typeof h.set === "function") {
+  if (h?.set && typeof h.set === "function") {
     h.set(key, value);
   } else {
     h[key] = value;
   }
 }
 async function commonHeader(config) {
-  var _a, _b;
   let access_token = "";
   let language = "";
   if (isServerRuntime()) {
     if (isNodeRuntime()) {
       try {
         const http = await import("http");
-        const https = await import("./__vite-browser-external-2Ng8QIWW.js");
-        const baseURL = config == null ? void 0 : config.baseURL;
+        const https = await import("https");
+        const baseURL = config?.baseURL;
         const isHttps = typeof baseURL === "string" ? baseURL.startsWith("https://") : false;
-        if (!httpAgent && (http == null ? void 0 : http.Agent)) httpAgent = new http.Agent({ keepAlive: true });
-        if (!httpsAgent && (https == null ? void 0 : https.Agent)) httpsAgent = new https.Agent({ keepAlive: true });
+        if (!httpAgent && http?.Agent) httpAgent = new http.Agent({ keepAlive: true });
+        if (!httpsAgent && https?.Agent) httpsAgent = new https.Agent({ keepAlive: true });
         config.httpAgent = isHttps ? void 0 : httpAgent;
         config.httpsAgent = isHttps ? httpsAgent : void 0;
       } catch {
       }
     }
-    try {
+    setHeader(config, "x-whistle-nohost-env", process.env.NO_HOST_ENV || "ichaingo");
+    if (serverHeaderProvider) {
       const startLanguage = getHeader(config, "Accept-Language");
-      setHeader(config, "x-whistle-nohost-env", process.env.NO_HOST_ENV || "ichaingo");
-      const { cookies, headers } = await import("next/headers");
-      const cookieStore = await cookies();
-      access_token = ((_a = cookieStore.get("access_token")) == null ? void 0 : _a.value) || "";
-      const hList = await headers();
-      language = startLanguage || hList.get("x-next-intl-locale") || "en";
-    } catch (error) {
-      console.error("Error accessing cookies in server component:", error);
+      try {
+        access_token = await serverHeaderProvider.getAccessToken() || "";
+        language = startLanguage || await serverHeaderProvider.getLanguage() || "en";
+      } catch (error) {
+        console.error("Error accessing server headers via provider:", error);
+      }
+    } else {
+      try {
+        const startLanguage = getHeader(config, "Accept-Language");
+        const { cookies, headers } = await import("next/headers");
+        const cookieStore = await cookies();
+        access_token = cookieStore.get(envCookieName("access_token"))?.value || "";
+        const hList = await headers();
+        language = startLanguage || hList.get("x-next-intl-locale") || "en";
+      } catch (error) {
+        console.error("Error accessing cookies in server component:", error);
+      }
     }
   } else {
-    access_token = jsCookie.get("access_token") || "";
-    language = jsCookie.get("NEXT_LOCALE") || matchSystemLanguage() || "en";
+    access_token = jsCookie.get(envCookieName("access_token")) || "";
+    const preset = getHeader(config, "Accept-Language");
+    language = preset || getUrlLocale() || jsCookie.get("NEXT_LOCALE") || matchSystemLanguage() || "en";
   }
-  const isRefreshToken = (_b = config.headers) == null ? void 0 : _b["isRefreshToken"];
+  const isRefreshToken = config.headers?.["isRefreshToken"];
   setHeader(config, "Accept-Language", language);
   if (access_token && !isRefreshToken) {
     setHeader(config, "Authorization", `Bearer ${access_token}`);
@@ -78,13 +104,12 @@ function toUpperMethod(m) {
   return m ? m.toUpperCase() : void 0;
 }
 function getTypeName(v) {
-  var _a;
   if (v === null) return "null";
   if (v === void 0) return "undefined";
   const t = typeof v;
   if (t !== "object") return t;
   try {
-    return ((_a = v == null ? void 0 : v.constructor) == null ? void 0 : _a.name) || "object";
+    return v?.constructor?.name || "object";
   } catch {
     return "object";
   }
@@ -105,15 +130,14 @@ function n(v) {
   return v === void 0 ? null : v;
 }
 function buildErrorMessage(err) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-  const method = toUpperMethod((_a = err.config) == null ? void 0 : _a.method);
-  const baseURL = ((_b = err.config) == null ? void 0 : _b.baseURL) || "";
-  const url = ((_c = err.config) == null ? void 0 : _c.url) ? `${baseURL || ""}${err.config.url}` : "";
-  const status = (_d = err.response) == null ? void 0 : _d.status;
-  const statusText = (_e = err.response) == null ? void 0 : _e.statusText;
-  const respData = (_f = err.response) == null ? void 0 : _f.data;
-  const requestId = ((_h = (_g = err.response) == null ? void 0 : _g.headers) == null ? void 0 : _h["x-request-id"]) || ((_i = respData == null ? void 0 : respData.status) == null ? void 0 : _i.requestId);
-  const serverMsg = (respData == null ? void 0 : respData.message) || (respData == null ? void 0 : respData.msg) || ((_j = respData == null ? void 0 : respData.status) == null ? void 0 : _j.msg);
+  const method = toUpperMethod(err.config?.method);
+  const baseURL = err.config?.baseURL || "";
+  const url = err.config?.url ? `${baseURL || ""}${err.config.url}` : "";
+  const status = err.response?.status;
+  const statusText = err.response?.statusText;
+  const respData = err.response?.data;
+  const requestId = err.response?.headers?.["x-request-id"] || respData?.status?.requestId;
+  const serverMsg = respData?.message || respData?.msg || respData?.status?.msg;
   const summary = [
     status ? `HTTP ${status}` : "HTTP ERROR",
     method,
@@ -127,18 +151,17 @@ function buildErrorMessage(err) {
   return [summary, shortMsg, ridMsg, codeMsg, localMsg].filter(Boolean).join(" | ");
 }
 function buildDetails(err) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
   const cfg = err.config;
-  let body = cfg == null ? void 0 : cfg.data;
+  let body = cfg?.data;
   if (typeof body === "string") {
     try {
       body = JSON.parse(body);
     } catch {
     }
   }
-  const baseURL = cfg == null ? void 0 : cfg.baseURL;
-  const url = (cfg == null ? void 0 : cfg.url) ? baseURL ? `${baseURL}${cfg.url}` : cfg.url : void 0;
-  const requestId = ((_b = (_a = err.response) == null ? void 0 : _a.headers) == null ? void 0 : _b["x-request-id"]) || ((_e = (_d = (_c = err.response) == null ? void 0 : _c.data) == null ? void 0 : _d.status) == null ? void 0 : _e.requestId);
+  const baseURL = cfg?.baseURL;
+  const url = cfg?.url ? baseURL ? `${baseURL}${cfg.url}` : cfg.url : void 0;
+  const requestId = err.response?.headers?.["x-request-id"] || err.response?.data?.status?.requestId;
   return {
     // error 基础信息（保证不会被 stringify 成 {}）
     name: n(err.name),
@@ -146,29 +169,28 @@ function buildDetails(err) {
     code: n(err.code),
     stack: n(err.stack),
     // request 信息
-    method: n(toUpperMethod(cfg == null ? void 0 : cfg.method)),
+    method: n(toUpperMethod(cfg?.method)),
     baseURL: n(baseURL),
     url: n(url),
-    timeout: n(cfg == null ? void 0 : cfg.timeout),
-    withCredentials: n(cfg == null ? void 0 : cfg.withCredentials),
-    params: n(cfg == null ? void 0 : cfg.params),
+    timeout: n(cfg?.timeout),
+    withCredentials: n(cfg?.withCredentials),
+    params: n(cfg?.params),
     data: n(body),
     // response 信息
-    status: n((_f = err.response) == null ? void 0 : _f.status),
-    statusText: n((_g = err.response) == null ? void 0 : _g.statusText),
+    status: n(err.response?.status),
+    statusText: n(err.response?.statusText),
     requestId: n(requestId),
-    responseDataType: n(getTypeName((_h = err.response) == null ? void 0 : _h.data)),
-    responseData: n(safeResponseData((_i = err.response) == null ? void 0 : _i.data))
+    responseDataType: n(getTypeName(err.response?.data)),
+    responseData: n(safeResponseData(err.response?.data))
   };
 }
 function errorInterceptor(error) {
-  var _a, _b, _c;
   const err = isAxiosError(error) ? error : new AxiosError(String(error));
   const isTimeout = err.code === "ECONNABORTED" || /timeout/i.test(err.message || "");
   if (isTimeout) {
-    const method = toUpperMethod((_a = err.config) == null ? void 0 : _a.method);
-    const baseURL = ((_b = err.config) == null ? void 0 : _b.baseURL) || "";
-    const url = ((_c = err.config) == null ? void 0 : _c.url) ? `${baseURL || ""}${err.config.url}` : "";
+    const method = toUpperMethod(err.config?.method);
+    const baseURL = err.config?.baseURL || "";
+    const url = err.config?.url ? `${baseURL || ""}${err.config.url}` : "";
     const summary = [`TIMEOUT`, method, url].filter(Boolean).join(" | ");
     err.summary = summary;
     err.details = buildDetails(err);
@@ -181,40 +203,125 @@ function errorInterceptor(error) {
   logger.error({ message, details: err.details, errType: "server error" });
   return Promise.reject(err);
 }
-function ResponseInterceptor(response) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-  const config = response.config;
-  if (config.returnFullResponse) {
-    return response;
+const refreshBaseURL = typeof window !== "undefined" ? process.env.NEXT_PUBLIC_AUTH_URL || window.location.origin : process.env.AUTH_INNER_API_URL || process.env.NEXT_PUBLIC_AUTH_URL;
+const refreshClient = axios.create({
+  baseURL: refreshBaseURL,
+  timeout: 1e4,
+  withCredentials: true,
+  paramsSerializer(params) {
+    return qs.stringify(params, { arrayFormat: "brackets" });
+  }
+});
+let refreshPromise = null;
+const REFRESH_DEDUPE_MS = 2e3;
+let lastRefreshAt = 0;
+let lastRefreshResult = null;
+function refreshAccessToken() {
+  if (refreshPromise) {
+    return refreshPromise;
+  }
+  if (Date.now() - lastRefreshAt < REFRESH_DEDUPE_MS) {
+    return Promise.resolve(lastRefreshResult);
   }
-  if (response.status === 401) {
-    if (typeof window !== "undefined") {
-      TokenManager.removeAllToken();
+  const refresh_token = getToken("refresh_token");
+  if (!refresh_token) {
+    return Promise.resolve(null);
+  }
+  const pending = refreshClient.get("/api/refresh/token", {
+    params: {
+      grant_type: "refresh_token",
+      refresh_token
+    },
+    headers: {
+      isRefreshToken: true
+    }
+  }).then((res) => {
+    const data = res?.data?.data;
+    if (data?.access_token) {
+      if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("user-profile-updated"));
+      }
+      return data.access_token;
     }
+    removeAllToken();
+    return null;
+  }).catch(() => null).then((result) => {
+    lastRefreshAt = Date.now();
+    lastRefreshResult = result;
+    return result;
+  }).finally(() => {
+    refreshPromise = null;
+  });
+  refreshPromise = pending;
+  return pending;
+}
+function getCurrentAccessToken() {
+  return jsCookie.get(envCookieName("access_token")) || getToken("access_token") || "";
+}
+const RESPONSE_TOAST_EVENT = "xchain-response-toast";
+function readToastObject(source) {
+  if (!source || typeof source !== "object") return null;
+  const raw = source;
+  const amount = Number(raw.amount);
+  if (!Number.isFinite(amount)) return null;
+  return {
+    amount,
+    title: typeof raw.title === "string" ? raw.title : void 0
+  };
+}
+function parseResponseToast(payload) {
+  if (!payload || typeof payload !== "object") return null;
+  const rec = payload;
+  const direct = readToastObject(rec.toast);
+  if (direct) return direct;
+  if (rec.data && typeof rec.data === "object") {
+    return readToastObject(rec.data.toast);
+  }
+  return null;
+}
+function emitResponseToast(payload) {
+  if (isServerRuntime()) return;
+  if (typeof window === "undefined") return;
+  const toast = parseResponseToast(payload);
+  if (!toast) return;
+  window.dispatchEvent(
+    new CustomEvent(RESPONSE_TOAST_EVENT, { detail: toast })
+  );
+}
+function shouldSkipRefresh(config) {
+  const url = typeof config?.url === "string" ? config.url : "";
+  if (url.includes("/api/refresh/token")) return true;
+  if (url.includes("/v2/auth/")) return true;
+  if (config?.headers?.isRefreshToken) return true;
+  return false;
+}
+function handleBusinessResponse(response) {
+  const config = response.config;
+  if (config.returnFullResponse) {
+    emitResponseToast(response.data);
     return response;
   }
   if (response.status === 200) {
-    if ((_a = response.headers["content-type"]) == null ? void 0 : _a.includes("text/event-stream")) {
+    if (response.headers["content-type"]?.includes("text/event-stream")) {
       return response;
     }
     const data = response.data;
     const businessStatus = data.status;
     if (businessStatus && typeof businessStatus.code === "number" && ![0, 200].includes(businessStatus.code) && businessStatus.code !== 401) {
       const err = new AxiosError(
-        (businessStatus == null ? void 0 : businessStatus.msg) || "Business error",
+        businessStatus?.msg || "Business error",
         String(businessStatus.code),
         response.config,
         response.request,
         response
       );
-      const summary = `BIZ ${businessStatus.code} | ${(_c = (_b = response.config) == null ? void 0 : _b.method) == null ? void 0 : _c.toUpperCase()} | ${((_d = response.config) == null ? void 0 : _d.baseURL) || ""}${((_e = response.config) == null ? void 0 : _e.url) || ""} | server: ${businessStatus == null ? void 0 : businessStatus.msg}`;
+      const summary = `BIZ ${businessStatus.code} | ${response.config?.method?.toUpperCase()} | ${response.config?.baseURL || ""}${response.config?.url || ""} | server: ${businessStatus?.msg}`;
       const details = {
-        method: (_g = (_f = response.config) == null ? void 0 : _f.method) == null ? void 0 : _g.toUpperCase(),
-        url: ((_h = response.config) == null ? void 0 : _h.baseURL) ? `${response.config.baseURL}${response.config.url || ""}` : response.config.url,
-        params: (_i = response.config) == null ? void 0 : _i.params,
+        method: response.config?.method?.toUpperCase(),
+        url: response.config?.baseURL ? `${response.config.baseURL}${response.config.url || ""}` : response.config.url,
+        params: response.config?.params,
         data: (() => {
-          var _a2;
-          let d = (_a2 = response.config) == null ? void 0 : _a2.data;
+          let d = response.config?.data;
           if (typeof d === "string") {
             try {
               d = JSON.parse(d);
@@ -225,7 +332,7 @@ function ResponseInterceptor(response) {
         })(),
         status: response.status,
         statusText: response.statusText,
-        requestId: ((_j = response.headers) == null ? void 0 : _j["x-request-id"]) || (businessStatus == null ? void 0 : businessStatus.requestId),
+        requestId: response.headers?.["x-request-id"] || businessStatus?.requestId,
         responseData: data
       };
       if (process.env.NODE_ENV !== "development") {
@@ -233,30 +340,48 @@ function ResponseInterceptor(response) {
       }
       throw err;
     }
+    emitResponseToast(data);
     return data;
   }
   return response;
 }
-let refreshPromise = null;
-const axiosInstance$1 = axios.create({
-  baseURL: process.env.AUTH_INNER_API_URL || process.env.NEXT_PUBLIC_AUTH_URL,
-  timeout: 1e4,
-  withCredentials: true,
-  // Always include credentials by default
-  paramsSerializer: function(params) {
-    return qs.stringify(params, { arrayFormat: "brackets" });
+function createResponseInterceptor(instance) {
+  return async function ResponseInterceptor(response) {
+    if (response.status === 401) {
+      const config = response.config;
+      const canRetry = !isServerRuntime() && !shouldSkipRefresh(config) && !config.__isRetryAfterRefresh;
+      if (canRetry) {
+        const newAccessToken = await refreshAccessToken();
+        if (newAccessToken) {
+          config.__isRetryAfterRefresh = true;
+          return instance(config);
+        }
+      }
+      return response;
+    }
+    return handleBusinessResponse(response);
+  };
+}
+function setAuthHeader(config, accessToken) {
+  const value = `Bearer ${accessToken}`;
+  const h = config.headers;
+  if (h?.set && typeof h.set === "function") {
+    h.set("Authorization", value);
+  } else {
+    h.Authorization = value;
   }
-});
+}
 async function refreshToken(config) {
-  if (typeof window === "undefined" || process.env.IS_SERVER === "true") {
+  if (isServerRuntime()) {
     return config;
   }
   if (typeof config.url === "string" && config.url.includes("/api/refresh/token")) {
     return config;
   }
-  const headers = config.headers;
-  if (refreshPromise) {
-    await refreshPromise;
+  if (typeof config.url === "string" && config.url.includes("/v2/auth/")) {
+    return config;
+  }
+  if (config.headers?.isRefreshToken) {
     return config;
   }
   let expired = false;
@@ -266,42 +391,11 @@ async function refreshToken(config) {
     expired = false;
   }
   if (expired) {
-    const refresh_token = getToken("refresh_token");
-    if (!refresh_token) {
-      removeAllToken();
-      return config;
+    const newAccessToken = await refreshAccessToken();
+    const accessToken = newAccessToken || getCurrentAccessToken();
+    if (accessToken) {
+      setAuthHeader(config, accessToken);
     }
-    if (refreshPromise) {
-      await refreshPromise;
-      return config;
-    }
-    const refreshHeaders = { ...headers };
-    delete refreshHeaders.Authorization;
-    delete refreshHeaders.authorization;
-    refreshHeaders.isRefreshToken = true;
-    refreshPromise = axiosInstance$1.get(`/api/refresh/token`, {
-      params: {
-        grant_type: "refresh_token",
-        refresh_token
-      },
-      headers: {
-        ...refreshHeaders
-      }
-    }).then((res) => {
-      var _a;
-      if ((_a = res == null ? void 0 : res.data) == null ? void 0 : _a.data) {
-        return res.data.data;
-      } else {
-        removeAllToken();
-        return null;
-      }
-    }).catch(() => {
-      removeAllToken();
-      return null;
-    }).finally(() => {
-      refreshPromise = null;
-    });
-    await refreshPromise;
   }
   return config;
 }
@@ -319,7 +413,14 @@ const axiosInstance = axios.create({
 });
 axiosInstance.interceptors.request.use(refreshToken);
 axiosInstance.interceptors.request.use(commonHeader, errorInterceptor);
-axiosInstance.interceptors.response.use(ResponseInterceptor, errorInterceptor);
+axiosInstance.interceptors.response.use(createResponseInterceptor(axiosInstance), errorInterceptor);
 export {
-  axiosInstance as default
+  RESPONSE_TOAST_EVENT,
+  axiosInstance as default,
+  emitResponseToast,
+  getCurrentAccessToken,
+  parseResponseToast,
+  refreshAccessToken,
+  setClientLocales,
+  setServerHeaderProvider
 };

package/dist/interceptors/commonHeader.d.ts

@@ -1,3 +1,11 @@
 import { InternalAxiosRequestConfig } from 'axios';
+import { ServerHeaderProvider } from '../types';
+export declare function setServerHeaderProvider(provider: ServerHeaderProvider): void;
+/**
+ * 注入应用支持的 locale 列表后，客户端 Accept-Language 以 URL 首段为准，
+ * 避免 iframe 分区（partitioned）或重复的 NEXT_LOCALE cookie 读到旧值。
+ * 未调用时行为不变（仍读 cookie）。
+ */
+export declare function setClientLocales(locales: readonly string[]): void;
 export declare function commonHeader(config: InternalAxiosRequestConfig): Promise<InternalAxiosRequestConfig<any>>;
 //# sourceMappingURL=commonHeader.d.ts.map

package/dist/interceptors/commonHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commonHeader.d.ts","sourceRoot":"","sources":["../../src/interceptors/commonHeader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,0BAA0B,EAAE,MAAM,OAAO,CAAC;AAiCrE,wBAAsB,YAAY,CAChC,MAAM,EAAE,0BAA0B,4CA+CnC"}
+{"version":3,"file":"commonHeader.d.ts","sourceRoot":"","sources":["../../src/interceptors/commonHeader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,0BAA0B,EAAE,MAAM,OAAO,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAQrD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,QAErE;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,QAE1D;AA+BD,wBAAsB,YAAY,CAChC,MAAM,EAAE,0BAA0B,4CA8DnC"}

package/dist/interceptors/refreshToken.d.ts

@@ -1,3 +1,7 @@
 import { InternalAxiosRequestConfig } from 'axios';
+/**
+ * 请求前的「预测式刷新」：若本地判断 access_token 即将/已过期，提前刷新。
+ * 这是一层优化；真正的兜底由响应拦截器的 401 自动刷新+重放保证。
+ */
 export default function refreshToken(config: InternalAxiosRequestConfig): Promise<InternalAxiosRequestConfig<any>>;
 //# sourceMappingURL=refreshToken.d.ts.map

package/dist/interceptors/refreshToken.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refreshToken.d.ts","sourceRoot":"","sources":["../../src/interceptors/refreshToken.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAC;AAY1D,wBAA8B,YAAY,CACxC,MAAM,EAAE,0BAA0B,4CAqEnC"}
+{"version":3,"file":"refreshToken.d.ts","sourceRoot":"","sources":["../../src/interceptors/refreshToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,0BAA0B,EAAE,MAAM,OAAO,CAAC;AAerE;;;GAGG;AACH,wBAA8B,YAAY,CACxC,MAAM,EAAE,0BAA0B,4CAkCnC"}

package/dist/interceptors/response.d.ts

@@ -1,3 +1,13 @@
-import { AxiosResponse } from 'axios';
-export default function ResponseInterceptor(response: AxiosResponse): any;
+import { AxiosInstance, AxiosResponse } from 'axios';
+/**
+ * 响应拦截器工厂。
+ *
+ * 业界标准 401 处理：业务接口返回 401 时，用 refresh_token 刷新一次并重放原请求；
+ * 仅当刷新失败时把 401 透传给上层（由显式 logout 决定是否清登录态）。
+ * - 仅在客户端重试（SSR 无 cookie jar）。
+ * - 每个请求最多重试一次，避免死循环。
+ * - /v2/auth/*、刷新接口本身不触发重试。
+ */
+export declare function createResponseInterceptor(instance: AxiosInstance): (response: AxiosResponse) => Promise<any>;
+export default createResponseInterceptor;
 //# sourceMappingURL=response.d.ts.map

package/dist/interceptors/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/interceptors/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,aAAa,EAAE,MAAM,OAAO,CAAC;AAKlD,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,GAAG,CAuDxE"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/interceptors/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,aAAa,EAAE,aAAa,EAA8B,MAAM,OAAO,CAAC;AAwE7F;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,aAAa,IACrB,UAAU,aAAa,KAAG,OAAO,CAAC,GAAG,CAAC,CAoBjF;AAED,eAAe,yBAAyB,CAAC"}

package/dist/responseToast.d.ts

@@ -0,0 +1,14 @@
+/** 业务信封里的 toast。无发放时后端应省略该字段。 */
+export type ResponseToast = {
+    amount: number;
+    title?: string;
+};
+/** 客户端 window 事件名。产品层自行监听并展示 UI，本库不弹 toast。 */
+export declare const RESPONSE_TOAST_EVENT = "xchain-response-toast";
+/**
+ * 从业务信封 `{ data, status, toast }` 或 AxiosResponse `{ data: envelope }` 解析 toast。
+ * 只认 `toast` 字段，不把业务 `data.amount` 当成提示。
+ */
+export declare function parseResponseToast(payload: unknown): ResponseToast | null;
+export declare function emitResponseToast(payload: unknown): void;
+//# sourceMappingURL=responseToast.d.ts.map

package/dist/responseToast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseToast.d.ts","sourceRoot":"","sources":["../src/responseToast.ts"],"names":[],"mappings":"AAEA,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAa5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CASzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQxD"}

package/dist/runtime.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 判断是否处于“服务端运行时”。
+ *
+ * 关键点：只要存在真实浏览器 window，就一律视为客户端，
+ * 避免业务方在客户端 bundle 中固化 IS_SERVER=true 时被误判为服务端，
+ * 从而走 next/headers 读 cookie 失败、请求不带 Authorization。
+ */
+export declare function isServerRuntime(): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAKzC"}

package/dist/tokenRefresh.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 触发一次 token 刷新；并发/紧邻调用共享同一个结果。
+ *
+ * 关键设计：cookie 由服务端 `/api/refresh/token` 的 Set-Cookie 统一写入，
+ * 客户端这里「绝不」再用 js-cookie 写一遍，避免双写竞态把 cookie 写坏。
+ *
+ * @returns 新的 access_token；刷新失败返回 null。
+ */
+export declare function refreshAccessToken(): Promise<string | null>;
+export declare function getCurrentAccessToken(): string;
+//# sourceMappingURL=tokenRefresh.d.ts.map

package/dist/tokenRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenRefresh.d.ts","sourceRoot":"","sources":["../src/tokenRefresh.ts"],"names":[],"mappings":"AAqCA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwD3D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/types.d.ts

@@ -1,4 +1,10 @@
 import { AxiosRequestConfig } from 'axios';
+import { ResponseToast } from './responseToast';
+export type { ResponseToast };
+export interface ServerHeaderProvider {
+    getAccessToken(): Promise<string | undefined>;
+    getLanguage(): Promise<string | undefined>;
+}
 export interface ApiRequestConfig extends AxiosRequestConfig {
     withCredentials?: boolean;
     returnFullResponse?: boolean;
@@ -28,6 +34,7 @@ export interface IResponse<T> {
     data: T;
     pagination?: null | Pagination;
     status: Status;
+    toast?: ResponseToast;
     [property: string]: any;
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED;;EAEE;AACF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AACD;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,CAAC,EAAE,IAAI,GAAG,UAAU,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED;;EAEE;AACF,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AACD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,oBAAoB;IACnC,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED;;EAEE;AACF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,CAAC,EAAE,IAAI,GAAG,UAAU,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED;;EAEE;AACF,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AACD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xchain/request",
-  "version": "1.1.0-beta.9",
+  "version": "1.1.0-beta.91",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -17,17 +17,28 @@
     "dist",
     "!**/*.tsbuildinfo"
   ],
+  "peerDependencies": {
+    "axios": "1.13.2",
+    "js-cookie": "3.0.5",
+    "next": "16.1.6",
+    "qs": "6.14.0"
+  },
   "devDependencies": {
     "@types/js-cookie": "3.0.6",
-    "@types/qs": "6.14.0"
-  },
-  "dependencies": {
+    "@types/qs": "6.14.0",
     "axios": "1.13.2",
     "js-cookie": "3.0.5",
     "next": "16.1.6",
-    "qs": "6.14.0",
-    "@0xchain/token": "1.1.0-beta.9",
-    "@0xchain/logger": "1.1.0-beta.9"
+    "qs": "6.14.0"
+  },
+  "dependencies": {
+    "@0xchain/logger": "1.1.0-beta.91",
+    "@0xchain/token": "1.1.0-beta.91"
+  },
+  "nx": {
+    "tags": [
+      "type:util"
+    ]
   },
   "publishConfig": {
     "access": "public"

package/dist/__vite-browser-external-2Ng8QIWW.js

@@ -1,4 +0,0 @@
-const __viteBrowserExternal = {};
-export {
-  __viteBrowserExternal as default
-};