@heyhru/web-util-http 0.1.1

package/dist/HttpClient.d.ts

@@ -0,0 +1,67 @@
+import type { HttpClientConfig, MessageFns, RequestOptions } from "./types";
+/**
+ * HTTP 客户端类
+ * 提供基于 Protobuf 的 HTTP 请求功能
+ */
+export declare class HttpClient {
+    private config;
+    private httpService;
+    private logger;
+    private monitor?;
+    private memoryCache;
+    private defaultTtl;
+    constructor(config: HttpClientConfig);
+    /**
+     * 设置请求拦截器
+     */
+    private setupRequestInterceptor;
+    /**
+     * 设置响应拦截器
+     */
+    private setupResponseInterceptor;
+    /**
+     * 构建客户端消息
+     */
+    private clientMessage;
+    /**
+     * 从类型字符串中提取名称（点号后的部分）
+     */
+    private getTypeAfterDot;
+    /**
+     * 发送 POST 请求（基础方法）
+     */
+    requestPost<T, U>(requestType: MessageFns<T>, requestData: T, responseType: MessageFns<U>, requestName: string, options?: RequestOptions): Promise<U>;
+    /**
+     * 发送 POST 请求（自动提取请求名称）
+     */
+    requestPost2<T, U>(requestType: MessageFns<T>, requestData: T, responseType: MessageFns<U>, options?: RequestOptions): Promise<U>;
+    /**
+     * 设置缓存
+     */
+    setCache<T>(key: string, data: T, ttl?: number): void;
+    /**
+     * 获取缓存
+     */
+    getCache<T>(key: string): T | null;
+    /**
+     * 清除缓存
+     */
+    clearCache(key?: string): void;
+    /**
+     * 构建缓存 key
+     */
+    private buildCacheKey;
+    /**
+     * 发送 POST 请求（带缓存）
+     */
+    requestPostCache<T, U>(requestType: MessageFns<T>, requestData: T, responseType: MessageFns<U>, options?: RequestOptions): Promise<U>;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<HttpClientConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): Readonly<HttpClientConfig>;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../src/HttpClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAA8C,MAAM,SAAS,CAAC;AAoBxH;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,UAAU,CAAiB;gBAEvB,MAAM,EAAE,gBAAgB;IA8BpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoFhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACG,WAAW,CAAC,CAAC,EAAE,CAAC,EACpB,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAC1B,WAAW,EAAE,CAAC,EACd,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAsFb;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,CAAC,EACrB,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAC1B,WAAW,EAAE,CAAC,EACd,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,SAAkB,GAAG,IAAI;IAI9D;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAUlC;;OAEG;IACH,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACG,gBAAgB,CAAC,CAAC,EAAE,CAAC,EACzB,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAC1B,WAAW,EAAE,CAAC,EACd,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIrD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,gBAAgB,CAAC;CAGxC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { HttpClient } from "./HttpClient";
+export type { HttpClientConfig, MessageFns, RequestOptions, UserInfo, MonitorAdapter, LoggerAdapter, CacheRecord, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,355 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  HttpClient: () => HttpClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/HttpClient.ts
+var import_axios = __toESM(require("axios"));
+var DefaultLogger = class {
+  log(...args) {
+    console.log(...args);
+  }
+  error(...args) {
+    console.error(...args);
+  }
+  warn(...args) {
+    console.warn(...args);
+  }
+  info(...args) {
+    console.info(...args);
+  }
+};
+var HttpClient = class {
+  // 5 分钟
+  constructor(config) {
+    this.memoryCache = /* @__PURE__ */ new Map();
+    this.defaultTtl = 5 * 60 * 1e3;
+    this.config = {
+      timeout: 45e3,
+      slowApiThreshold: 5e3,
+      businessErrorCodesToReport: [2, 4, 99, 120],
+      athenaAllowedRequests: [],
+      noLoginPaths: [],
+      ...config
+    };
+    this.logger = config.loggerAdapter || new DefaultLogger();
+    this.monitor = config.monitorAdapter;
+    this.httpService = import_axios.default.create({
+      timeout: this.config.timeout,
+      method: "post",
+      headers: {
+        "X-Requested-With": "XMLHttpRequest",
+        "Content-Type": "application/octet-stream"
+      },
+      responseType: "arraybuffer"
+    });
+    this.setupRequestInterceptor();
+    this.setupResponseInterceptor();
+  }
+  /**
+   * 设置请求拦截器
+   */
+  setupRequestInterceptor() {
+    this.httpService.interceptors.request.use(
+      (config) => {
+        config.headers.Authorization = `Bearer ${this.config.getToken()}`;
+        config.headers.params = JSON.stringify({
+          os: this.config.getOs(),
+          app_name: this.config.getAppName(),
+          locale: this.config.getLocale(),
+          app_version: this.config.getAppVersion()
+        });
+        config.metadata = {
+          ...config.metadata || {},
+          requestTimestamp: Date.now(),
+          requestTime: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        return config;
+      },
+      (error) => Promise.reject(error)
+    );
+  }
+  /**
+   * 设置响应拦截器
+   */
+  setupResponseInterceptor() {
+    this.httpService.interceptors.response.use(
+      (response) => {
+        const metadata = response.config?.metadata || {};
+        const requestTimestamp = metadata.requestTimestamp || Date.now();
+        const duration = Date.now() - requestTimestamp;
+        if (this.monitor && duration > (this.config.slowApiThreshold || 5e3)) {
+          const userInfo = this.monitor.getUserInfo();
+          this.monitor.reportSlowApi({
+            requestName: metadata.requestName || "unknown",
+            protoId: metadata.protoId || "unknown",
+            requestTime: metadata.requestTime || (/* @__PURE__ */ new Date()).toISOString(),
+            requestTimestamp,
+            duration,
+            requestParams: metadata.requestParams || "unavailable",
+            userId: userInfo.userId,
+            username: userInfo.username
+          });
+        }
+        return response;
+      },
+      async (error) => {
+        const requestUrl = error.config?.url || "unknown";
+        const requestMethod = error.config?.method || "unknown";
+        const statusCode = error.response?.status || 0;
+        const metadata = error.config?.metadata || {};
+        const requestTimestamp = metadata.requestTimestamp || Date.now();
+        const duration = Date.now() - requestTimestamp;
+        let responseData = "unavailable";
+        try {
+          if (error.response?.data) {
+            if (error.response.data instanceof ArrayBuffer) {
+              const decoder = new TextDecoder();
+              responseData = decoder.decode(error.response.data).substring(0, 500);
+            } else {
+              responseData = JSON.stringify(error.response.data).substring(0, 500);
+            }
+          }
+        } catch (e) {
+          responseData = "parse_failed";
+        }
+        if (this.monitor && statusCode !== 401) {
+          const userInfo = this.monitor.getUserInfo();
+          this.monitor.reportApiError({
+            error,
+            requestUrl,
+            requestMethod,
+            statusCode,
+            requestName: metadata.requestName || "unknown",
+            protoId: metadata.protoId || "unknown",
+            requestTime: metadata.requestTime || (/* @__PURE__ */ new Date()).toISOString(),
+            requestTimestamp,
+            duration,
+            requestParams: metadata.requestParams || "unavailable",
+            responseData,
+            userId: userInfo.userId,
+            username: userInfo.username
+          });
+        }
+        if (statusCode === 401) {
+          const pathname = typeof window !== "undefined" ? window.location.pathname || "" : "";
+          const noLoginPaths = this.config.noLoginPaths || [];
+          if (noLoginPaths.includes(pathname)) {
+            return Promise.reject(error);
+          }
+          if (this.config.on401Error) {
+            await this.config.on401Error();
+          }
+        }
+        return Promise.reject(error);
+      }
+    );
+  }
+  /**
+   * 构建客户端消息
+   */
+  clientMessage(protoId, msgBuffer) {
+    const len = 4 + msgBuffer.length;
+    const buffer = new ArrayBuffer(len);
+    const view = new DataView(buffer);
+    view.setInt32(0, protoId, false);
+    msgBuffer.forEach((byte, index) => {
+      view.setUint8(4 + index, byte);
+    });
+    return buffer;
+  }
+  /**
+   * 从类型字符串中提取名称（点号后的部分）
+   */
+  getTypeAfterDot(type) {
+    const dotIndex = type.lastIndexOf(".");
+    return dotIndex === -1 ? type : type.substring(dotIndex + 1);
+  }
+  /**
+   * 发送 POST 请求（基础方法）
+   */
+  async requestPost(requestType, requestData, responseType, requestName, options) {
+    const protoId = this.config.protoMap[requestName];
+    if (!protoId) {
+      throw new Error(`Proto ID not found for ${requestName}`);
+    }
+    this.logger.log("protoId", protoId);
+    const isAthena = this.config.isAthenaEnv?.() || false;
+    const athenaAllowed = this.config.athenaAllowedRequests || [];
+    if (isAthena && !athenaAllowed.includes(requestName)) {
+      return {};
+    }
+    try {
+      const requestMessage = requestType.create(requestData);
+      const encodedMessage = requestType.encode(requestMessage).finish();
+      const reqMessage = this.clientMessage(protoId, encodedMessage);
+      let requestParamsStr = "unavailable";
+      try {
+        requestParamsStr = JSON.stringify(requestData).substring(0, 1e3);
+      } catch (e) {
+        requestParamsStr = "serialize_failed";
+      }
+      const response = await this.httpService.post(this.config.apiHost, reqMessage, {
+        signal: options?.signal,
+        timeout: options?.timeout ?? this.config.timeout,
+        metadata: {
+          protoId,
+          requestName,
+          requestParams: requestParamsStr
+        }
+      });
+      const buf = response.data;
+      const realProto = buf.slice(4);
+      const uint8Array = new Uint8Array(realProto);
+      const responseProto = responseType.decode(uint8Array);
+      this.logger.log("HttpClient", requestName, requestData, responseProto);
+      if (responseProto.code !== void 0) {
+        const businessCode = responseProto.code;
+        const errorCodesToReport = this.config.businessErrorCodesToReport || [];
+        if (businessCode !== 1 && businessCode !== 0) {
+          if (this.monitor && errorCodesToReport.includes(businessCode)) {
+            const errorMessage = responseProto.message || responseProto.msg || "unknown";
+            let responseStr = "unavailable";
+            try {
+              responseStr = JSON.stringify(responseProto).substring(0, 1e3);
+            } catch (e) {
+              responseStr = "serialize_failed";
+            }
+            const userInfo = this.monitor.getUserInfo();
+            this.monitor.reportBusinessError({
+              businessCode,
+              requestName,
+              protoId,
+              requestParams: requestParamsStr,
+              errorMessage,
+              responseData: responseStr,
+              userId: userInfo.userId,
+              username: userInfo.username
+            });
+          }
+        }
+      }
+      return responseProto;
+    } catch (e) {
+      this.logger.error("HttpClient", `${requestName} request error:`, e);
+      throw e;
+    }
+  }
+  /**
+   * 发送 POST 请求（自动提取请求名称）
+   */
+  async requestPost2(requestType, requestData, responseType, options) {
+    const requestName = this.getTypeAfterDot(requestType.$type);
+    return this.requestPost(requestType, requestData, responseType, requestName, options);
+  }
+  /**
+   * 设置缓存
+   */
+  setCache(key, data, ttl = this.defaultTtl) {
+    this.memoryCache.set(key, { data, expiry: Date.now() + ttl });
+  }
+  /**
+   * 获取缓存
+   */
+  getCache(key) {
+    const record = this.memoryCache.get(key);
+    if (!record) return null;
+    if (Date.now() > record.expiry) {
+      this.memoryCache.delete(key);
+      return null;
+    }
+    return record.data;
+  }
+  /**
+   * 清除缓存
+   */
+  clearCache(key) {
+    if (key) {
+      this.memoryCache.delete(key);
+    } else {
+      this.memoryCache.clear();
+    }
+  }
+  /**
+   * 构建缓存 key
+   */
+  buildCacheKey(requestType, requestData) {
+    const typeName = this.getTypeAfterDot(requestType.$type);
+    try {
+      const message = requestType.create(requestData);
+      const bytes = requestType.encode(message).finish();
+      const payloadKey = Array.from(bytes).join(",");
+      return `${typeName}:${payloadKey}`;
+    } catch (e) {
+      const stableStringify = (value) => {
+        if (value === null || typeof value !== "object") return JSON.stringify(value);
+        if (Array.isArray(value)) return `[${value.map((v) => stableStringify(v)).join(",")}]`;
+        const keys = Object.keys(value).sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`).join(",")}}`;
+      };
+      return `${typeName}:${stableStringify(requestData)}`;
+    }
+  }
+  /**
+   * 发送 POST 请求（带缓存）
+   */
+  async requestPostCache(requestType, requestData, responseType, options) {
+    const cacheKey = this.buildCacheKey(requestType, requestData);
+    const cached = this.getCache(cacheKey);
+    if (cached) {
+      this.logger.log("HttpClient", `requestPostCache hit: ${cacheKey}`);
+      return cached;
+    }
+    const result = await this.requestPost2(requestType, requestData, responseType, options);
+    this.setCache(cacheKey, result, this.defaultTtl);
+    this.logger.log("HttpClient", `requestPostCache set: ${cacheKey}`);
+    return result;
+  }
+  /**
+   * 更新配置
+   */
+  updateConfig(config) {
+    this.config = { ...this.config, ...config };
+  }
+  /**
+   * 获取当前配置
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HttpClient
+});

package/dist/index.mjs

@@ -0,0 +1,318 @@
+// src/HttpClient.ts
+import axios from "axios";
+var DefaultLogger = class {
+  log(...args) {
+    console.log(...args);
+  }
+  error(...args) {
+    console.error(...args);
+  }
+  warn(...args) {
+    console.warn(...args);
+  }
+  info(...args) {
+    console.info(...args);
+  }
+};
+var HttpClient = class {
+  // 5 分钟
+  constructor(config) {
+    this.memoryCache = /* @__PURE__ */ new Map();
+    this.defaultTtl = 5 * 60 * 1e3;
+    this.config = {
+      timeout: 45e3,
+      slowApiThreshold: 5e3,
+      businessErrorCodesToReport: [2, 4, 99, 120],
+      athenaAllowedRequests: [],
+      noLoginPaths: [],
+      ...config
+    };
+    this.logger = config.loggerAdapter || new DefaultLogger();
+    this.monitor = config.monitorAdapter;
+    this.httpService = axios.create({
+      timeout: this.config.timeout,
+      method: "post",
+      headers: {
+        "X-Requested-With": "XMLHttpRequest",
+        "Content-Type": "application/octet-stream"
+      },
+      responseType: "arraybuffer"
+    });
+    this.setupRequestInterceptor();
+    this.setupResponseInterceptor();
+  }
+  /**
+   * 设置请求拦截器
+   */
+  setupRequestInterceptor() {
+    this.httpService.interceptors.request.use(
+      (config) => {
+        config.headers.Authorization = `Bearer ${this.config.getToken()}`;
+        config.headers.params = JSON.stringify({
+          os: this.config.getOs(),
+          app_name: this.config.getAppName(),
+          locale: this.config.getLocale(),
+          app_version: this.config.getAppVersion()
+        });
+        config.metadata = {
+          ...config.metadata || {},
+          requestTimestamp: Date.now(),
+          requestTime: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        return config;
+      },
+      (error) => Promise.reject(error)
+    );
+  }
+  /**
+   * 设置响应拦截器
+   */
+  setupResponseInterceptor() {
+    this.httpService.interceptors.response.use(
+      (response) => {
+        const metadata = response.config?.metadata || {};
+        const requestTimestamp = metadata.requestTimestamp || Date.now();
+        const duration = Date.now() - requestTimestamp;
+        if (this.monitor && duration > (this.config.slowApiThreshold || 5e3)) {
+          const userInfo = this.monitor.getUserInfo();
+          this.monitor.reportSlowApi({
+            requestName: metadata.requestName || "unknown",
+            protoId: metadata.protoId || "unknown",
+            requestTime: metadata.requestTime || (/* @__PURE__ */ new Date()).toISOString(),
+            requestTimestamp,
+            duration,
+            requestParams: metadata.requestParams || "unavailable",
+            userId: userInfo.userId,
+            username: userInfo.username
+          });
+        }
+        return response;
+      },
+      async (error) => {
+        const requestUrl = error.config?.url || "unknown";
+        const requestMethod = error.config?.method || "unknown";
+        const statusCode = error.response?.status || 0;
+        const metadata = error.config?.metadata || {};
+        const requestTimestamp = metadata.requestTimestamp || Date.now();
+        const duration = Date.now() - requestTimestamp;
+        let responseData = "unavailable";
+        try {
+          if (error.response?.data) {
+            if (error.response.data instanceof ArrayBuffer) {
+              const decoder = new TextDecoder();
+              responseData = decoder.decode(error.response.data).substring(0, 500);
+            } else {
+              responseData = JSON.stringify(error.response.data).substring(0, 500);
+            }
+          }
+        } catch (e) {
+          responseData = "parse_failed";
+        }
+        if (this.monitor && statusCode !== 401) {
+          const userInfo = this.monitor.getUserInfo();
+          this.monitor.reportApiError({
+            error,
+            requestUrl,
+            requestMethod,
+            statusCode,
+            requestName: metadata.requestName || "unknown",
+            protoId: metadata.protoId || "unknown",
+            requestTime: metadata.requestTime || (/* @__PURE__ */ new Date()).toISOString(),
+            requestTimestamp,
+            duration,
+            requestParams: metadata.requestParams || "unavailable",
+            responseData,
+            userId: userInfo.userId,
+            username: userInfo.username
+          });
+        }
+        if (statusCode === 401) {
+          const pathname = typeof window !== "undefined" ? window.location.pathname || "" : "";
+          const noLoginPaths = this.config.noLoginPaths || [];
+          if (noLoginPaths.includes(pathname)) {
+            return Promise.reject(error);
+          }
+          if (this.config.on401Error) {
+            await this.config.on401Error();
+          }
+        }
+        return Promise.reject(error);
+      }
+    );
+  }
+  /**
+   * 构建客户端消息
+   */
+  clientMessage(protoId, msgBuffer) {
+    const len = 4 + msgBuffer.length;
+    const buffer = new ArrayBuffer(len);
+    const view = new DataView(buffer);
+    view.setInt32(0, protoId, false);
+    msgBuffer.forEach((byte, index) => {
+      view.setUint8(4 + index, byte);
+    });
+    return buffer;
+  }
+  /**
+   * 从类型字符串中提取名称（点号后的部分）
+   */
+  getTypeAfterDot(type) {
+    const dotIndex = type.lastIndexOf(".");
+    return dotIndex === -1 ? type : type.substring(dotIndex + 1);
+  }
+  /**
+   * 发送 POST 请求（基础方法）
+   */
+  async requestPost(requestType, requestData, responseType, requestName, options) {
+    const protoId = this.config.protoMap[requestName];
+    if (!protoId) {
+      throw new Error(`Proto ID not found for ${requestName}`);
+    }
+    this.logger.log("protoId", protoId);
+    const isAthena = this.config.isAthenaEnv?.() || false;
+    const athenaAllowed = this.config.athenaAllowedRequests || [];
+    if (isAthena && !athenaAllowed.includes(requestName)) {
+      return {};
+    }
+    try {
+      const requestMessage = requestType.create(requestData);
+      const encodedMessage = requestType.encode(requestMessage).finish();
+      const reqMessage = this.clientMessage(protoId, encodedMessage);
+      let requestParamsStr = "unavailable";
+      try {
+        requestParamsStr = JSON.stringify(requestData).substring(0, 1e3);
+      } catch (e) {
+        requestParamsStr = "serialize_failed";
+      }
+      const response = await this.httpService.post(this.config.apiHost, reqMessage, {
+        signal: options?.signal,
+        timeout: options?.timeout ?? this.config.timeout,
+        metadata: {
+          protoId,
+          requestName,
+          requestParams: requestParamsStr
+        }
+      });
+      const buf = response.data;
+      const realProto = buf.slice(4);
+      const uint8Array = new Uint8Array(realProto);
+      const responseProto = responseType.decode(uint8Array);
+      this.logger.log("HttpClient", requestName, requestData, responseProto);
+      if (responseProto.code !== void 0) {
+        const businessCode = responseProto.code;
+        const errorCodesToReport = this.config.businessErrorCodesToReport || [];
+        if (businessCode !== 1 && businessCode !== 0) {
+          if (this.monitor && errorCodesToReport.includes(businessCode)) {
+            const errorMessage = responseProto.message || responseProto.msg || "unknown";
+            let responseStr = "unavailable";
+            try {
+              responseStr = JSON.stringify(responseProto).substring(0, 1e3);
+            } catch (e) {
+              responseStr = "serialize_failed";
+            }
+            const userInfo = this.monitor.getUserInfo();
+            this.monitor.reportBusinessError({
+              businessCode,
+              requestName,
+              protoId,
+              requestParams: requestParamsStr,
+              errorMessage,
+              responseData: responseStr,
+              userId: userInfo.userId,
+              username: userInfo.username
+            });
+          }
+        }
+      }
+      return responseProto;
+    } catch (e) {
+      this.logger.error("HttpClient", `${requestName} request error:`, e);
+      throw e;
+    }
+  }
+  /**
+   * 发送 POST 请求（自动提取请求名称）
+   */
+  async requestPost2(requestType, requestData, responseType, options) {
+    const requestName = this.getTypeAfterDot(requestType.$type);
+    return this.requestPost(requestType, requestData, responseType, requestName, options);
+  }
+  /**
+   * 设置缓存
+   */
+  setCache(key, data, ttl = this.defaultTtl) {
+    this.memoryCache.set(key, { data, expiry: Date.now() + ttl });
+  }
+  /**
+   * 获取缓存
+   */
+  getCache(key) {
+    const record = this.memoryCache.get(key);
+    if (!record) return null;
+    if (Date.now() > record.expiry) {
+      this.memoryCache.delete(key);
+      return null;
+    }
+    return record.data;
+  }
+  /**
+   * 清除缓存
+   */
+  clearCache(key) {
+    if (key) {
+      this.memoryCache.delete(key);
+    } else {
+      this.memoryCache.clear();
+    }
+  }
+  /**
+   * 构建缓存 key
+   */
+  buildCacheKey(requestType, requestData) {
+    const typeName = this.getTypeAfterDot(requestType.$type);
+    try {
+      const message = requestType.create(requestData);
+      const bytes = requestType.encode(message).finish();
+      const payloadKey = Array.from(bytes).join(",");
+      return `${typeName}:${payloadKey}`;
+    } catch (e) {
+      const stableStringify = (value) => {
+        if (value === null || typeof value !== "object") return JSON.stringify(value);
+        if (Array.isArray(value)) return `[${value.map((v) => stableStringify(v)).join(",")}]`;
+        const keys = Object.keys(value).sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`).join(",")}}`;
+      };
+      return `${typeName}:${stableStringify(requestData)}`;
+    }
+  }
+  /**
+   * 发送 POST 请求（带缓存）
+   */
+  async requestPostCache(requestType, requestData, responseType, options) {
+    const cacheKey = this.buildCacheKey(requestType, requestData);
+    const cached = this.getCache(cacheKey);
+    if (cached) {
+      this.logger.log("HttpClient", `requestPostCache hit: ${cacheKey}`);
+      return cached;
+    }
+    const result = await this.requestPost2(requestType, requestData, responseType, options);
+    this.setCache(cacheKey, result, this.defaultTtl);
+    this.logger.log("HttpClient", `requestPostCache set: ${cacheKey}`);
+    return result;
+  }
+  /**
+   * 更新配置
+   */
+  updateConfig(config) {
+    this.config = { ...this.config, ...config };
+  }
+  /**
+   * 获取当前配置
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+};
+export {
+  HttpClient
+};

package/dist/types.d.ts

@@ -0,0 +1,138 @@
+import { AxiosError } from "axios";
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { DeepPartial, Exact } from "@heyhru/business-pwa-proto/baseType";
+/**
+ * MessageFns 接口定义（与 protobuf 生成的类型兼容）
+ */
+export interface MessageFns<T, Type extends string = string> {
+    $type: string;
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+/**
+ * HTTP 客户端配置
+ */
+export interface HttpClientConfig {
+    /** API 主机地址 */
+    apiHost: string;
+    /** 请求超时时间（毫秒），默认 45000 */
+    timeout?: number;
+    /** 获取授权 token */
+    getToken: () => string;
+    /** 获取操作系统信息 */
+    getOs: () => string;
+    /** 获取应用名称 */
+    getAppName: () => string;
+    /** 获取语言设置 */
+    getLocale: () => string;
+    /** 获取应用版本 */
+    getAppVersion: () => string;
+    /** Proto ID 映射表 */
+    protoMap: Record<string, number>;
+    /** 可选的监控适配器 */
+    monitorAdapter?: MonitorAdapter;
+    /** 可选的日志适配器 */
+    loggerAdapter?: LoggerAdapter;
+    /** 可选的环境检查函数 */
+    isAthenaEnv?: () => boolean;
+    /** 雅典娜环境允许的请求列表 */
+    athenaAllowedRequests?: string[];
+    /** 需要上报的业务错误码白名单 */
+    businessErrorCodesToReport?: number[];
+    /** 401 错误时的处理回调 */
+    on401Error?: () => void | Promise<void>;
+    /** 不需要登录的路径列表 */
+    noLoginPaths?: string[];
+    /** 慢接口阈值（毫秒），默认 5000 */
+    slowApiThreshold?: number;
+}
+/**
+ * 用户信息接口
+ */
+export interface UserInfo {
+    userId: string | number;
+    username?: string;
+}
+/**
+ * 监控适配器接口（用于错误上报，如 Sentry）
+ */
+export interface MonitorAdapter {
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(): UserInfo;
+    /**
+     * 上报慢接口
+     */
+    reportSlowApi(params: {
+        requestName: string;
+        protoId: number | string;
+        requestTime: string;
+        requestTimestamp: number;
+        duration: number;
+        requestParams: string;
+        userId: string | number;
+        username?: string;
+    }): void;
+    /**
+     * 上报 API 错误
+     */
+    reportApiError(params: {
+        error: AxiosError;
+        requestUrl: string;
+        requestMethod: string;
+        statusCode: number;
+        requestName: string;
+        protoId: number | string;
+        requestTime: string;
+        requestTimestamp: number;
+        duration: number;
+        requestParams: string;
+        responseData: string;
+        userId: string | number;
+        username?: string;
+    }): void;
+    /**
+     * 上报业务错误
+     */
+    reportBusinessError(params: {
+        businessCode: number;
+        requestName: string;
+        protoId: number | string;
+        requestParams: string;
+        errorMessage: string;
+        responseData: string;
+        userId: string | number;
+        username?: string;
+    }): void;
+}
+/**
+ * 日志适配器接口
+ */
+export interface LoggerAdapter {
+    log(...args: any[]): void;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+}
+/**
+ * 请求选项
+ */
+export interface RequestOptions {
+    /** 取消信号 */
+    signal?: AbortSignal;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * 缓存记录
+ */
+export interface CacheRecord<T> {
+    data: T;
+    expiry: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@heyhru/web-util-http",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.1",
+  "description": "HTTP client with protobuf encoding, caching, and monitoring adapters",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly",
+    "dev": "tsup --watch",
+    "lint1": "eslint src",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@heyhru/business-pwa-proto": "^0.1.1",
+    "@heyhru/web-util-ua": "^0.1.1",
+    "axios": "^1.15.0"
+  },
+  "peerDependencies": {
+    "@bufbuild/protobuf": "^2.0.0"
+  },
+  "devDependencies": {
+    "@bufbuild/protobuf": "^2.2.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2"
+  },
+  "gitHead": "bea932bfa6fd932a7a27a305d74b4b01c2e4ebe3"
+}