react-toolkits 2.27.20 → 2.28.0

package/locale/hooks.js

@@ -2,11 +2,348 @@ import { template, has, get } from 'lodash-es';
 import { createContext, useMemo, useContext } from 'react';
 import 'antd';
 import { useStore } from 'zustand';
+import ky from 'ky';
 import 'zustand/middleware';
 import 'jwt-decode';
 import 'react/jsx-runtime';
 
-// src/locale/hooks.ts
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/constants/index.ts
+var APP_ID_HEADER = "App-ID";
+
+// src/libs/ky.ts
+var DEFAULT_SUCCESS_RESPONSE_CODES = [0, 1, 200];
+var DEFAULT_STATUS_FIELDS = ["code", "status", "errno"];
+var DEFAULT_ERROR_FIELDS = ["msg", "message", "error"];
+var HTTP_STATUS = {
+  OK: 200,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  UNREGISTERED: 412
+};
+var REQUEST_TIMEOUT = 3e4;
+function isStatusCodeSuccess(config) {
+  const { value, allowedCodes } = config;
+  if (value === void 0 || value === null) {
+    return false;
+  }
+  if (typeof value !== "number") {
+    return false;
+  }
+  return allowedCodes.includes(value);
+}
+function isSuccessResponse(data, status, config) {
+  if (config?.isSuccess) {
+    return config.isSuccess(data, status);
+  }
+  if (status < HTTP_STATUS.OK || status >= 300) {
+    return false;
+  }
+  if (!data || typeof data !== "object") {
+    return true;
+  }
+  const successCodes = config?.successCodes || DEFAULT_SUCCESS_RESPONSE_CODES;
+  const statusFields = config?.statusFields || DEFAULT_STATUS_FIELDS;
+  const dataObj = data;
+  const statusChecks = statusFields.map((field) => ({
+    field,
+    value: dataObj[field],
+    allowedCodes: successCodes
+  }));
+  const hasBusinessStatusCode = statusChecks.some((check) => check.value !== void 0 && check.value !== null);
+  if (hasBusinessStatusCode) {
+    return statusChecks.every((check) => check.value === void 0 || check.value === null || isStatusCodeSuccess(check));
+  }
+  return true;
+}
+function extractErrorMessage(data, config) {
+  if (!data || typeof data !== "object") {
+    return "Unknown error";
+  }
+  if (config?.extractErrorMessage) {
+    return config.extractErrorMessage(data);
+  }
+  const errorFields = config?.errorFields || DEFAULT_ERROR_FIELDS;
+  for (const field of errorFields) {
+    const value = data[field];
+    if (value) {
+      return String(value);
+    }
+  }
+  return "Unknown error";
+}
+async function processResponseByType(response, responseType) {
+  switch (responseType) {
+    case "text":
+      return response.text();
+    case "arrayBuffer":
+      return response.arrayBuffer();
+    case "formData":
+      return response.formData();
+    case "json":
+      return response.json();
+    default:
+      return response;
+  }
+}
+var KyClient = class {
+  constructor(options = {}) {
+    __publicField(this, "_instance");
+    __publicField(this, "businessConfig");
+    __publicField(this, "errorConfig");
+    __publicField(this, "errorHandlers");
+    __publicField(this, "context");
+    __publicField(this, "disableDefaultErrorNotification");
+    __publicField(this, "get", (url, options) => {
+      return this.makeRequest("GET", url, void 0, options);
+    });
+    __publicField(this, "post", (url, data, options) => {
+      return this.makeRequest("POST", url, data, options);
+    });
+    __publicField(this, "put", (url, data, options) => {
+      return this.makeRequest("PUT", url, data, options);
+    });
+    __publicField(this, "delete", (url, options) => {
+      return this.makeRequest("DELETE", url, void 0, options);
+    });
+    __publicField(this, "patch", (url, data, options) => {
+      return this.makeRequest("PATCH", url, data, options);
+    });
+    __publicField(this, "options", (url, requestOptions) => {
+      return this.makeRequest("OPTIONS", url, void 0, requestOptions);
+    });
+    __publicField(this, "head", (url, requestOptions) => {
+      return this.makeRequest("HEAD", url, void 0, requestOptions);
+    });
+    __publicField(this, "request", (requestOptions) => {
+      const { url, ...requestOpts } = requestOptions;
+      return this.makeRequest(requestOpts.method || "GET", url, void 0, requestOpts);
+    });
+    const {
+      baseURL,
+      successCodes,
+      statusFields,
+      errorFields,
+      extractErrorMessage: customExtractErrorMessage,
+      onUnauthorized: customOnUnauthorized,
+      onForbidden: customOnForbidden,
+      onUnregistered: customOnUnregistered,
+      onError: customOnError,
+      onNetworkError: customOnNetworkError,
+      isSuccess: customIsSuccess,
+      disableDefaultErrorNotification = false,
+      context
+    } = options;
+    this.context = context;
+    this.disableDefaultErrorNotification = disableDefaultErrorNotification;
+    this.businessConfig = {
+      successCodes,
+      statusFields,
+      isSuccess: customIsSuccess
+    };
+    this.errorConfig = {
+      errorFields,
+      extractErrorMessage: customExtractErrorMessage
+    };
+    this.errorHandlers = {
+      onUnauthorized: customOnUnauthorized,
+      onForbidden: customOnForbidden,
+      onUnregistered: customOnUnregistered,
+      onError: customOnError,
+      onNetworkError: customOnNetworkError
+    };
+    this._instance = ky.create({
+      prefixUrl: baseURL ?? context?.apiBaseUrl,
+      retry: 0,
+      timeout: REQUEST_TIMEOUT,
+      hooks: {
+        beforeRequest: [this.handleBeforeRequest.bind(this)],
+        beforeError: [this.handleBeforeError.bind(this)]
+      }
+    });
+  }
+  /** 获取 ky 实例（用于高级用法） */
+  get instance() {
+    return this._instance;
+  }
+  /**
+   * 通用请求处理函数
+   */
+  async makeRequest(method, url, data, requestOptions) {
+    const { responseType = "json", ...kyOptions } = requestOptions || {};
+    const finalOptions = {
+      ...kyOptions,
+      hooks: {
+        ...kyOptions.hooks,
+        afterResponse: [...kyOptions.hooks?.afterResponse || [], this.createResponseHandler(responseType)]
+      }
+    };
+    let response;
+    if (data) {
+      if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || typeof data === "string" || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {
+        response = await this._instance(url, { method, body: data, ...finalOptions });
+      } else {
+        response = await this._instance(url, { method, json: data, ...finalOptions });
+      }
+    } else {
+      response = await this._instance(url, { method, ...finalOptions });
+    }
+    return processResponseByType(response, responseType);
+  }
+  /**
+   * 创建响应处理函数
+   */
+  createResponseHandler(responseType) {
+    return async (_request, _options, response) => {
+      if (responseType === "blob" || responseType === "arrayBuffer" || responseType === "text" || responseType === "formData") {
+        return response;
+      }
+      let data;
+      try {
+        data = await response.clone().json();
+      } catch {
+        return response;
+      }
+      if (isSuccessResponse(data, response.status, this.businessConfig)) {
+        return new Response(JSON.stringify(data), {
+          status: response.status,
+          statusText: response.statusText,
+          headers: response.headers
+        });
+      }
+      const errorMessage = extractErrorMessage(data, this.errorConfig);
+      if (!this.disableDefaultErrorNotification && !this.errorHandlers.onError && this.context?.notifyError) {
+        this.context.notifyError("Request failed", errorMessage);
+      }
+      if (this.errorHandlers.onError) {
+        this.errorHandlers.onError(response.status, data, errorMessage);
+      }
+      const error = new Error(errorMessage);
+      error.response = response;
+      error.data = data;
+      throw error;
+    };
+  }
+  /**
+   * 请求前处理：设置认证和 appId headers
+   */
+  handleBeforeRequest(request) {
+    const { token, isGlobalMode, appId } = this.context || {};
+    if (token) {
+      request.headers.set("Authorization", `Bearer ${token}`);
+    }
+    if (!request.headers.has(APP_ID_HEADER)) {
+      if (isGlobalMode || !appId) {
+        request.headers.set(APP_ID_HEADER, "global");
+      } else {
+        request.headers.set(APP_ID_HEADER, encodeURIComponent(String(appId)));
+      }
+    }
+  }
+  /**
+   * 错误前处理：处理 HTTP 状态码错误
+   */
+  async handleBeforeError(error) {
+    const { response } = error;
+    if (response) {
+      const status = response.status;
+      let data;
+      try {
+        const contentType = response.headers.get("content-type") || "";
+        if (contentType.includes("application/json") || contentType.startsWith("text/")) {
+          data = await response.clone().json();
+        }
+      } catch {
+      }
+      this.handleHttpStatusError(status, data);
+    } else {
+      if (this.errorHandlers.onNetworkError) {
+        this.errorHandlers.onNetworkError(error);
+      } else if (!this.disableDefaultErrorNotification && this.context?.notifyError) {
+        this.context.notifyError("Network Error", error.message || "Network request failed");
+      }
+    }
+    return error;
+  }
+  /**
+   * 处理 HTTP 状态码错误
+   */
+  handleHttpStatusError(status, data) {
+    switch (status) {
+      case HTTP_STATUS.UNAUTHORIZED:
+        if (this.errorHandlers.onUnauthorized) {
+          this.errorHandlers.onUnauthorized(data);
+        } else {
+          this.defaultHandleUnauthorized();
+        }
+        break;
+      case HTTP_STATUS.UNREGISTERED:
+        if (this.errorHandlers.onUnregistered) {
+          this.errorHandlers.onUnregistered(data);
+        } else {
+          this.defaultHandleUnregistered();
+        }
+        break;
+      case HTTP_STATUS.FORBIDDEN:
+        if (this.errorHandlers.onForbidden) {
+          this.errorHandlers.onForbidden(data);
+        } else {
+          this.defaultHandleForbidden();
+        }
+        break;
+      default: {
+        const errorMessage = extractErrorMessage(data, this.errorConfig) || `HTTP ${status} Error`;
+        if (this.errorHandlers.onError) {
+          this.errorHandlers.onError(status, data, errorMessage);
+        } else if (!this.disableDefaultErrorNotification && this.context?.notifyError) {
+          this.context.notifyError("Request failed", errorMessage);
+        }
+        break;
+      }
+    }
+  }
+  /**
+   * 默认处理未授权错误
+   */
+  defaultHandleUnauthorized() {
+    const { clear, loginPath } = this.context || {};
+    if (clear && loginPath) {
+      clear();
+      window.location.href = loginPath;
+    }
+  }
+  /**
+   * 默认处理未注册错误
+   */
+  defaultHandleUnregistered() {
+    const { clear, loginPath } = this.context || {};
+    if (clear && loginPath) {
+      clear();
+      const url = new URL(loginPath, window.location.origin);
+      url.searchParams.set("unregistered", "true");
+      window.location.href = url.toString();
+    }
+  }
+  /**
+   * 默认处理禁止访问错误
+   */
+  defaultHandleForbidden() {
+    if (!this.disableDefaultErrorNotification && this.context?.notifyError) {
+      this.context.notifyError("\u8BBF\u95EE\u88AB\u7981\u6B62", "\u60A8\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6B64\u8D44\u6E90\u3002");
+    }
+  }
+  /**
+   * 更新上下文信息
+   * 用于在运行时更新 context（例如在 React 组件中从 context 获取最新信息）
+   */
+  updateContext(context) {
+    this.context = context;
+  }
+};
+new KyClient();
 var ToolkitsContext = createContext(null);
 function useToolkitsStore(selector) {
   const store = useContext(ToolkitsContext);

package/locale/index.js

@@ -2,11 +2,348 @@ import { template, has, get } from 'lodash-es';
 import { createContext, useMemo, useContext } from 'react';
 import 'antd';
 import { useStore } from 'zustand';
+import ky from 'ky';
 import 'zustand/middleware';
 import 'jwt-decode';
 import 'react/jsx-runtime';
 
-// src/locale/hooks.ts
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/constants/index.ts
+var APP_ID_HEADER = "App-ID";
+
+// src/libs/ky.ts
+var DEFAULT_SUCCESS_RESPONSE_CODES = [0, 1, 200];
+var DEFAULT_STATUS_FIELDS = ["code", "status", "errno"];
+var DEFAULT_ERROR_FIELDS = ["msg", "message", "error"];
+var HTTP_STATUS = {
+  OK: 200,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  UNREGISTERED: 412
+};
+var REQUEST_TIMEOUT = 3e4;
+function isStatusCodeSuccess(config) {
+  const { value, allowedCodes } = config;
+  if (value === void 0 || value === null) {
+    return false;
+  }
+  if (typeof value !== "number") {
+    return false;
+  }
+  return allowedCodes.includes(value);
+}
+function isSuccessResponse(data, status, config) {
+  if (config?.isSuccess) {
+    return config.isSuccess(data, status);
+  }
+  if (status < HTTP_STATUS.OK || status >= 300) {
+    return false;
+  }
+  if (!data || typeof data !== "object") {
+    return true;
+  }
+  const successCodes = config?.successCodes || DEFAULT_SUCCESS_RESPONSE_CODES;
+  const statusFields = config?.statusFields || DEFAULT_STATUS_FIELDS;
+  const dataObj = data;
+  const statusChecks = statusFields.map((field) => ({
+    field,
+    value: dataObj[field],
+    allowedCodes: successCodes
+  }));
+  const hasBusinessStatusCode = statusChecks.some((check) => check.value !== void 0 && check.value !== null);
+  if (hasBusinessStatusCode) {
+    return statusChecks.every((check) => check.value === void 0 || check.value === null || isStatusCodeSuccess(check));
+  }
+  return true;
+}
+function extractErrorMessage(data, config) {
+  if (!data || typeof data !== "object") {
+    return "Unknown error";
+  }
+  if (config?.extractErrorMessage) {
+    return config.extractErrorMessage(data);
+  }
+  const errorFields = config?.errorFields || DEFAULT_ERROR_FIELDS;
+  for (const field of errorFields) {
+    const value = data[field];
+    if (value) {
+      return String(value);
+    }
+  }
+  return "Unknown error";
+}
+async function processResponseByType(response, responseType) {
+  switch (responseType) {
+    case "text":
+      return response.text();
+    case "arrayBuffer":
+      return response.arrayBuffer();
+    case "formData":
+      return response.formData();
+    case "json":
+      return response.json();
+    default:
+      return response;
+  }
+}
+var KyClient = class {
+  constructor(options = {}) {
+    __publicField(this, "_instance");
+    __publicField(this, "businessConfig");
+    __publicField(this, "errorConfig");
+    __publicField(this, "errorHandlers");
+    __publicField(this, "context");
+    __publicField(this, "disableDefaultErrorNotification");
+    __publicField(this, "get", (url, options) => {
+      return this.makeRequest("GET", url, void 0, options);
+    });
+    __publicField(this, "post", (url, data, options) => {
+      return this.makeRequest("POST", url, data, options);
+    });
+    __publicField(this, "put", (url, data, options) => {
+      return this.makeRequest("PUT", url, data, options);
+    });
+    __publicField(this, "delete", (url, options) => {
+      return this.makeRequest("DELETE", url, void 0, options);
+    });
+    __publicField(this, "patch", (url, data, options) => {
+      return this.makeRequest("PATCH", url, data, options);
+    });
+    __publicField(this, "options", (url, requestOptions) => {
+      return this.makeRequest("OPTIONS", url, void 0, requestOptions);
+    });
+    __publicField(this, "head", (url, requestOptions) => {
+      return this.makeRequest("HEAD", url, void 0, requestOptions);
+    });
+    __publicField(this, "request", (requestOptions) => {
+      const { url, ...requestOpts } = requestOptions;
+      return this.makeRequest(requestOpts.method || "GET", url, void 0, requestOpts);
+    });
+    const {
+      baseURL,
+      successCodes,
+      statusFields,
+      errorFields,
+      extractErrorMessage: customExtractErrorMessage,
+      onUnauthorized: customOnUnauthorized,
+      onForbidden: customOnForbidden,
+      onUnregistered: customOnUnregistered,
+      onError: customOnError,
+      onNetworkError: customOnNetworkError,
+      isSuccess: customIsSuccess,
+      disableDefaultErrorNotification = false,
+      context
+    } = options;
+    this.context = context;
+    this.disableDefaultErrorNotification = disableDefaultErrorNotification;
+    this.businessConfig = {
+      successCodes,
+      statusFields,
+      isSuccess: customIsSuccess
+    };
+    this.errorConfig = {
+      errorFields,
+      extractErrorMessage: customExtractErrorMessage
+    };
+    this.errorHandlers = {
+      onUnauthorized: customOnUnauthorized,
+      onForbidden: customOnForbidden,
+      onUnregistered: customOnUnregistered,
+      onError: customOnError,
+      onNetworkError: customOnNetworkError
+    };
+    this._instance = ky.create({
+      prefixUrl: baseURL ?? context?.apiBaseUrl,
+      retry: 0,
+      timeout: REQUEST_TIMEOUT,
+      hooks: {
+        beforeRequest: [this.handleBeforeRequest.bind(this)],
+        beforeError: [this.handleBeforeError.bind(this)]
+      }
+    });
+  }
+  /** 获取 ky 实例（用于高级用法） */
+  get instance() {
+    return this._instance;
+  }
+  /**
+   * 通用请求处理函数
+   */
+  async makeRequest(method, url, data, requestOptions) {
+    const { responseType = "json", ...kyOptions } = requestOptions || {};
+    const finalOptions = {
+      ...kyOptions,
+      hooks: {
+        ...kyOptions.hooks,
+        afterResponse: [...kyOptions.hooks?.afterResponse || [], this.createResponseHandler(responseType)]
+      }
+    };
+    let response;
+    if (data) {
+      if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || typeof data === "string" || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {
+        response = await this._instance(url, { method, body: data, ...finalOptions });
+      } else {
+        response = await this._instance(url, { method, json: data, ...finalOptions });
+      }
+    } else {
+      response = await this._instance(url, { method, ...finalOptions });
+    }
+    return processResponseByType(response, responseType);
+  }
+  /**
+   * 创建响应处理函数
+   */
+  createResponseHandler(responseType) {
+    return async (_request, _options, response) => {
+      if (responseType === "blob" || responseType === "arrayBuffer" || responseType === "text" || responseType === "formData") {
+        return response;
+      }
+      let data;
+      try {
+        data = await response.clone().json();
+      } catch {
+        return response;
+      }
+      if (isSuccessResponse(data, response.status, this.businessConfig)) {
+        return new Response(JSON.stringify(data), {
+          status: response.status,
+          statusText: response.statusText,
+          headers: response.headers
+        });
+      }
+      const errorMessage = extractErrorMessage(data, this.errorConfig);
+      if (!this.disableDefaultErrorNotification && !this.errorHandlers.onError && this.context?.notifyError) {
+        this.context.notifyError("Request failed", errorMessage);
+      }
+      if (this.errorHandlers.onError) {
+        this.errorHandlers.onError(response.status, data, errorMessage);
+      }
+      const error = new Error(errorMessage);
+      error.response = response;
+      error.data = data;
+      throw error;
+    };
+  }
+  /**
+   * 请求前处理：设置认证和 appId headers
+   */
+  handleBeforeRequest(request) {
+    const { token, isGlobalMode, appId } = this.context || {};
+    if (token) {
+      request.headers.set("Authorization", `Bearer ${token}`);
+    }
+    if (!request.headers.has(APP_ID_HEADER)) {
+      if (isGlobalMode || !appId) {
+        request.headers.set(APP_ID_HEADER, "global");
+      } else {
+        request.headers.set(APP_ID_HEADER, encodeURIComponent(String(appId)));
+      }
+    }
+  }
+  /**
+   * 错误前处理：处理 HTTP 状态码错误
+   */
+  async handleBeforeError(error) {
+    const { response } = error;
+    if (response) {
+      const status = response.status;
+      let data;
+      try {
+        const contentType = response.headers.get("content-type") || "";
+        if (contentType.includes("application/json") || contentType.startsWith("text/")) {
+          data = await response.clone().json();
+        }
+      } catch {
+      }
+      this.handleHttpStatusError(status, data);
+    } else {
+      if (this.errorHandlers.onNetworkError) {
+        this.errorHandlers.onNetworkError(error);
+      } else if (!this.disableDefaultErrorNotification && this.context?.notifyError) {
+        this.context.notifyError("Network Error", error.message || "Network request failed");
+      }
+    }
+    return error;
+  }
+  /**
+   * 处理 HTTP 状态码错误
+   */
+  handleHttpStatusError(status, data) {
+    switch (status) {
+      case HTTP_STATUS.UNAUTHORIZED:
+        if (this.errorHandlers.onUnauthorized) {
+          this.errorHandlers.onUnauthorized(data);
+        } else {
+          this.defaultHandleUnauthorized();
+        }
+        break;
+      case HTTP_STATUS.UNREGISTERED:
+        if (this.errorHandlers.onUnregistered) {
+          this.errorHandlers.onUnregistered(data);
+        } else {
+          this.defaultHandleUnregistered();
+        }
+        break;
+      case HTTP_STATUS.FORBIDDEN:
+        if (this.errorHandlers.onForbidden) {
+          this.errorHandlers.onForbidden(data);
+        } else {
+          this.defaultHandleForbidden();
+        }
+        break;
+      default: {
+        const errorMessage = extractErrorMessage(data, this.errorConfig) || `HTTP ${status} Error`;
+        if (this.errorHandlers.onError) {
+          this.errorHandlers.onError(status, data, errorMessage);
+        } else if (!this.disableDefaultErrorNotification && this.context?.notifyError) {
+          this.context.notifyError("Request failed", errorMessage);
+        }
+        break;
+      }
+    }
+  }
+  /**
+   * 默认处理未授权错误
+   */
+  defaultHandleUnauthorized() {
+    const { clear, loginPath } = this.context || {};
+    if (clear && loginPath) {
+      clear();
+      window.location.href = loginPath;
+    }
+  }
+  /**
+   * 默认处理未注册错误
+   */
+  defaultHandleUnregistered() {
+    const { clear, loginPath } = this.context || {};
+    if (clear && loginPath) {
+      clear();
+      const url = new URL(loginPath, window.location.origin);
+      url.searchParams.set("unregistered", "true");
+      window.location.href = url.toString();
+    }
+  }
+  /**
+   * 默认处理禁止访问错误
+   */
+  defaultHandleForbidden() {
+    if (!this.disableDefaultErrorNotification && this.context?.notifyError) {
+      this.context.notifyError("\u8BBF\u95EE\u88AB\u7981\u6B62", "\u60A8\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6B64\u8D44\u6E90\u3002");
+    }
+  }
+  /**
+   * 更新上下文信息
+   * 用于在运行时更新 context（例如在 React 组件中从 context 获取最新信息）
+   */
+  updateContext(context) {
+    this.context = context;
+  }
+};
+new KyClient();
 var ToolkitsContext = createContext(null);
 function useToolkitsStore(selector) {
   const store = useContext(ToolkitsContext);