@minson1994/ms-utils 1.0.0

package/dist/api/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * API 请求模块入口。
+ *
+ * 使用 Api* 命名，强调这是“跨运行时业务 API 请求编排器”，
+ * 不是要替代 axios/fetch/xhr 的底层 HTTP Client。
+ */
+export { default as ApiRequest } from "./ApiRequest";
+export { ApiError, ApiCancelError, ApiTimeoutError, ApiNetworkError, isApiCancelError, } from "./ApiError";
+export { ApiConfig, ApiGlobalConfig, useApiConfig, useApiConfig as $Api, useApiConfig as $Use, } from "./ApiConfig";
+export type { ApiConfigOptions, ApiCancel, ApiCancelHandler, ApiGlobalConfigOptions, ApiHeaders, ApiMethod, ApiProgress, ApiProgressHandler, } from "./ApiConfig";
+export { default as ApiResponse } from "./ApiResponse";
+export { default as ApiInterceptor } from "./interceptor/ApiInterceptor";
+export { default as ApiUIInterceptor } from "./interceptor/ApiUIInterceptor";
+export { default as ApiStatusInterceptor } from "./interceptor/ApiStatusInterceptor";
+export type { ApiStatusInterceptorOptions } from "./interceptor/ApiStatusInterceptor";
+export { default as ApiCacheInterceptor } from "./interceptor/ApiCacheInterceptor";
+export { default as ApiAdapter } from "./adapter/ApiAdapter";
+export { default as FetchHttpAdapter } from "./adapter/FetchHttpAdapter";
+export type { FetchHttpAdapterOptions, FetchLike } from "./adapter/FetchHttpAdapter";
+export { default as XhrHttpAdapter } from "./adapter/XhrHttpAdapter";
+export type { XhrHttpAdapterOptions, XMLHttpRequestFactory } from "./adapter/XhrHttpAdapter";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACH,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,SAAS,EACT,eAAe,EACf,YAAY,EACZ,YAAY,IAAI,IAAI,EACpB,YAAY,IAAI,IAAI,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EACR,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,WAAW,EACX,kBAAkB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AACrF,YAAY,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/api/interceptor/ApiCacheInterceptor.d.ts

@@ -0,0 +1,29 @@
+import ApiInterceptor from './ApiInterceptor';
+import type { ApiConfig } from '../ApiConfig';
+import type ApiResponse from '../ApiResponse';
+/**
+ * 缓存 key 生成函数。
+ */
+export type CacheKeyFactory = (config: ApiConfig) => string;
+/**
+ * 默认缓存 key：按 baseUrl、url、method、data 区分请求。
+ */
+export declare const defaultCacheKey: CacheKeyFactory;
+/**
+ * HTTP 响应缓存拦截器。
+ */
+export default class ApiCacheInterceptor extends ApiInterceptor {
+    private readonly getKey;
+    /** 缓存数据映射。 */
+    readonly cacheMap: Map<string, unknown>;
+    constructor(getKey?: CacheKeyFactory);
+    /**
+     * 请求前命中缓存则直接返回缓存值。
+     */
+    before(config: ApiConfig): Promise<unknown | void>;
+    /**
+     * 请求后按 key 写入缓存。
+     */
+    after(config: ApiConfig, response: ApiResponse): Promise<void>;
+}
+//# sourceMappingURL=ApiCacheInterceptor.d.ts.map

package/dist/api/interceptor/ApiCacheInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiCacheInterceptor.d.ts","sourceRoot":"","sources":["../../../src/api/interceptor/ApiCacheInterceptor.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,eAMxB,CAAC;AAEP;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,cAAc;IAI/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,cAAc;IACd,QAAQ,CAAC,QAAQ,uBAA8B;gBAElB,MAAM,GAAE,eAAiC;IAItE;;OAEG;IACY,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAMjE;;OAEG;IACY,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhF"}

package/dist/api/interceptor/ApiInterceptor.d.ts

@@ -0,0 +1,18 @@
+import type { ApiConfig } from '../ApiConfig';
+import type ApiResponse from '../ApiResponse';
+/**
+ * HTTP 拦截器基类。
+ *
+ * before 返回非 undefined 数据时，请求链会直接使用该数据作为结果。
+ */
+export default abstract class ApiInterceptor<TData = unknown> {
+    /**
+     * 请求前置处理。
+     */
+    abstract before(config: ApiConfig): Promise<TData | void>;
+    /**
+     * 请求后置处理。
+     */
+    abstract after(config: ApiConfig, response?: ApiResponse): Promise<void>;
+}
+//# sourceMappingURL=ApiInterceptor.d.ts.map

package/dist/api/interceptor/ApiInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiInterceptor.d.ts","sourceRoot":"","sources":["../../../src/api/interceptor/ApiInterceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,cAAc,CAAC,KAAK,GAAG,OAAO;IACxD;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAC3E"}

package/dist/api/interceptor/ApiStatusInterceptor.d.ts

@@ -0,0 +1,49 @@
+import ApiInterceptor from './ApiInterceptor';
+import type { ApiConfig } from '../ApiConfig';
+import type ApiResponse from '../ApiResponse';
+/**
+ * HTTP 状态拦截器配置。
+ */
+export interface ApiStatusInterceptorOptions {
+    /** 业务状态码字段名。 */
+    status?: string;
+    /** 业务消息字段名。 */
+    message?: string;
+    /** 业务数据字段名。 */
+    data?: string;
+    /** 成功业务状态码。 */
+    success?: string | number;
+    /** 认证失效回调。 */
+    onUnauthorized?: (message: string, response: ApiResponse, config: ApiConfig) => void | Promise<void>;
+}
+/**
+ * HTTP 状态和业务状态拦截器。
+ *
+ * 负责检查 HTTP 状态码、业务状态码、认证失效回调，以及按配置剥离 data 字段。
+ */
+export default class ApiStatusInterceptor extends ApiInterceptor {
+    /** 业务状态码字段名。 */
+    status: string;
+    /** 业务消息字段名。 */
+    message: string;
+    /** 业务数据字段名。 */
+    data: string;
+    /** 成功业务状态码。 */
+    success: string | number;
+    /** 认证失效回调。 */
+    onUnauthorized?: ApiStatusInterceptorOptions['onUnauthorized'];
+    constructor(options?: ApiStatusInterceptorOptions);
+    /**
+     * 状态拦截器不需要请求前处理。
+     */
+    before(_config: ApiConfig): Promise<void>;
+    /**
+     * 检查响应状态，并按配置改写 response.data。
+     */
+    after(config: ApiConfig, response: ApiResponse<Record<string, unknown>>): Promise<void>;
+    /**
+     * 更新业务字段映射和回调配置。
+     */
+    useConfig(options: ApiStatusInterceptorOptions): this;
+}
+//# sourceMappingURL=ApiStatusInterceptor.d.ts.map

package/dist/api/interceptor/ApiStatusInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiStatusInterceptor.d.ts","sourceRoot":"","sources":["../../../src/api/interceptor/ApiStatusInterceptor.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,gBAAgB;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxG;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,cAAc;IAC5D,gBAAgB;IAChB,MAAM,SAAU;IAChB,eAAe;IACf,OAAO,SAAa;IACpB,eAAe;IACf,IAAI,SAAU;IACd,eAAe;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAO;IAC/B,cAAc;IACd,cAAc,CAAC,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;gBAEnD,OAAO,GAAE,2BAAgC;IAKrD;;OAEG;IACY,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;OAEG;IACY,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtG;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI;CAQxD"}

package/dist/api/interceptor/ApiUIInterceptor.d.ts

@@ -0,0 +1,37 @@
+import ApiInterceptor from './ApiInterceptor';
+import type { ApiConfig } from '../ApiConfig';
+import type ApiResponse from '../ApiResponse';
+/**
+ * loading 显示/隐藏回调。
+ */
+export type LoadingHandler = () => void | Promise<void>;
+/**
+ * 错误消息回调。
+ */
+export type ErrorMessageHandler = (message: string, config: ApiConfig) => void | Promise<void>;
+/**
+ * HTTP UI 拦截器。
+ *
+ * 只保存回调，不直接绑定具体 UI 框架。
+ */
+export default class ApiUIInterceptor extends ApiInterceptor {
+    /** 显示 loading 回调。 */
+    loading?: LoadingHandler;
+    /** 隐藏 loading 回调。 */
+    loadingHide?: LoadingHandler;
+    /** 错误消息回调。 */
+    errorMessage?: ErrorMessageHandler;
+    /** 请求前显示 loading。 */
+    before(config: ApiConfig): Promise<void>;
+    /** 请求结束后隐藏 loading。 */
+    after(config: ApiConfig, _response?: ApiResponse): Promise<void>;
+    /** 按请求配置显示错误消息。 */
+    showErrorMessage(config: ApiConfig, message: string): Promise<void>;
+    /** 设置显示 loading 回调。 */
+    useLoading(loading: LoadingHandler): this;
+    /** 设置隐藏 loading 回调。 */
+    useLoadingHide(loadingHide: LoadingHandler): this;
+    /** 设置错误消息回调。 */
+    useErrorMessage(errorMessage: ErrorMessageHandler): this;
+}
+//# sourceMappingURL=ApiUIInterceptor.d.ts.map

package/dist/api/interceptor/ApiUIInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiUIInterceptor.d.ts","sourceRoot":"","sources":["../../../src/api/interceptor/ApiUIInterceptor.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/F;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IACxD,qBAAqB;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,qBAAqB;IACrB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,cAAc;IACd,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAEnC,qBAAqB;IACN,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,uBAAuB;IACR,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,mBAAmB;IACb,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,uBAAuB;IACvB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAKzC,uBAAuB;IACvB,cAAc,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI;IAKjD,gBAAgB;IAChB,eAAe,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;CAI3D"}

package/dist/axios.cjs

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/axios.ts
+var axios_exports = {};
+__export(axios_exports, {
+  AxiosHttpAdapter: () => AxiosHttpAdapter
+});
+module.exports = __toCommonJS(axios_exports);
+
+// src/api/adapter/ApiAdapter.ts
+var ApiAdapter = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  /**
+   * 触发标准化进度回调。
+   */
+  emitProgress(handler, loaded, total, event) {
+    if (!handler) return;
+    const lengthComputable = typeof total === "number" && Number.isFinite(total) && total > 0;
+    const progress = {
+      loaded,
+      lengthComputable,
+      event
+    };
+    if (lengthComputable) {
+      progress.total = total;
+      progress.percent = Math.min(100, Math.round(loaded / total * 100));
+    }
+    handler(progress);
+  }
+  /**
+   * 将 fetch / axios / xhr 等运行时进度事件转换为标准进度对象。
+   */
+  emitProgressEvent(handler, event) {
+    const source = event;
+    const loaded = Number(source.loaded ?? 0);
+    const total = source.lengthComputable === false ? void 0 : source.total;
+    this.emitProgress(handler, loaded, total, event);
+  }
+  /**
+   * 将上传请求数据转换为 FormData。
+   */
+  formData(config, target) {
+    if (!config.isUpload) return;
+    const formData = this.options.formDataFactory?.() ?? this.createGlobalFormData();
+    const fileName = config.data.fileName ?? "file";
+    for (const [key, value] of Object.entries(config.data)) {
+      if (key !== "file" && key !== "fileName")
+        formData.append(key, value);
+    }
+    if (config.data.file !== void 0)
+      formData.append(fileName, config.data.file);
+    target.data = formData;
+    target.headers ?? (target.headers = {});
+    target.headers["Content-Type"] = "multipart/form-data";
+    target.method = "POST";
+  }
+  /**
+   * 使用全局 FormData 构造器。
+   */
+  createGlobalFormData() {
+    const FormDataCtor = globalThis.FormData;
+    if (!FormDataCtor) {
+      throw new Error(
+        "FormData is not available; pass formDataFactory to the adapter"
+      );
+    }
+    return new FormDataCtor();
+  }
+};
+
+// src/api/ApiResponse.ts
+var ApiResponse = class {
+  constructor(status, data) {
+    this.status = status;
+    this.data = data;
+  }
+};
+
+// src/api/adapter/AxiosHttpAdapter.ts
+var AxiosHttpAdapter = class extends ApiAdapter {
+  constructor(axios, qs) {
+    super();
+    this.axios = axios;
+    this.qs = qs;
+  }
+  /**
+   * 将 ApiConfig 转换为 axios 配置并发起请求。
+   */
+  async request(config) {
+    const requestSource = this.axios.CancelToken?.source();
+    const requestConfig = {
+      url: `${config.baseUrl}${config.url}`,
+      method: config.method,
+      headers: { ...config.headers },
+      timeout: config.timeout * 1e3,
+      withCredentials: config.withCredentials
+    };
+    if (config.onUploadProgress) {
+      requestConfig.onUploadProgress = (event) => this.emitProgressEvent(config.onUploadProgress, event);
+    }
+    if (config.onDownloadProgress) {
+      requestConfig.onDownloadProgress = (event) => this.emitProgressEvent(config.onDownloadProgress, event);
+    }
+    if (config.isUpload) {
+      this.formData(
+        config,
+        requestConfig
+      );
+    } else if (config.isJsonBody) {
+      requestConfig.data = config.data;
+    } else if (["get", "delete"].includes(config.method.toLowerCase()) || !config.method) {
+      requestConfig.params = config.data;
+    } else {
+      requestConfig.data = this.qs?.stringify(config.data, { indices: false }) ?? config.data;
+    }
+    const onCancel = config.onCancel ?? config.cancelCallback;
+    if (onCancel && requestSource)
+      onCancel(requestSource.cancel.bind(requestSource));
+    try {
+      const response = await this.axios.request(requestConfig);
+      return new ApiResponse(response.status, response.data);
+    } catch (error) {
+      const response = error.response;
+      if (response) return new ApiResponse(response.status, response.data);
+      throw error;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AxiosHttpAdapter
+});

package/dist/axios.d.ts

@@ -0,0 +1,6 @@
+/**
+ * axios 适配器入口。
+ */
+export { default as AxiosHttpAdapter } from './api/adapter/AxiosHttpAdapter';
+export type { AxiosLike, QsLike } from './api/adapter/AxiosHttpAdapter';
+//# sourceMappingURL=axios.d.ts.map

package/dist/axios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.d.ts","sourceRoot":"","sources":["../src/axios.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/axios.js

@@ -0,0 +1,58 @@
+import {
+  ApiAdapter,
+  ApiResponse
+} from "./chunk-PV2X54HI.js";
+
+// src/api/adapter/AxiosHttpAdapter.ts
+var AxiosHttpAdapter = class extends ApiAdapter {
+  constructor(axios, qs) {
+    super();
+    this.axios = axios;
+    this.qs = qs;
+  }
+  /**
+   * 将 ApiConfig 转换为 axios 配置并发起请求。
+   */
+  async request(config) {
+    const requestSource = this.axios.CancelToken?.source();
+    const requestConfig = {
+      url: `${config.baseUrl}${config.url}`,
+      method: config.method,
+      headers: { ...config.headers },
+      timeout: config.timeout * 1e3,
+      withCredentials: config.withCredentials
+    };
+    if (config.onUploadProgress) {
+      requestConfig.onUploadProgress = (event) => this.emitProgressEvent(config.onUploadProgress, event);
+    }
+    if (config.onDownloadProgress) {
+      requestConfig.onDownloadProgress = (event) => this.emitProgressEvent(config.onDownloadProgress, event);
+    }
+    if (config.isUpload) {
+      this.formData(
+        config,
+        requestConfig
+      );
+    } else if (config.isJsonBody) {
+      requestConfig.data = config.data;
+    } else if (["get", "delete"].includes(config.method.toLowerCase()) || !config.method) {
+      requestConfig.params = config.data;
+    } else {
+      requestConfig.data = this.qs?.stringify(config.data, { indices: false }) ?? config.data;
+    }
+    const onCancel = config.onCancel ?? config.cancelCallback;
+    if (onCancel && requestSource)
+      onCancel(requestSource.cancel.bind(requestSource));
+    try {
+      const response = await this.axios.request(requestConfig);
+      return new ApiResponse(response.status, response.data);
+    } catch (error) {
+      const response = error.response;
+      if (response) return new ApiResponse(response.status, response.data);
+      throw error;
+    }
+  }
+};
+export {
+  AxiosHttpAdapter
+};

package/dist/browser.cjs

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/browser.ts
+var browser_exports = {};
+__export(browser_exports, {
+  CookieUtils: () => CookieUtils
+});
+module.exports = __toCommonJS(browser_exports);
+
+// src/utils/CookieUtils.ts
+var CookieUtils = class {
+  /**
+   * 读取指定 Cookie。
+   */
+  static read(name) {
+    const cookies = document.cookie ? document.cookie.split("; ") : [];
+    for (const item of cookies) {
+      const [cookieName, ...valueParts] = item.split("=");
+      if (cookieName === name) return valueParts.join("=");
+    }
+    return null;
+  }
+  /**
+   * 写入 Cookie。
+   *
+   * @param expires number 表示多少秒后过期；Date/string 表示绝对过期时间
+   */
+  static write(name, value, expires = 86400, path, domain, secure) {
+    let cookie = `${name}=${value}`;
+    if (expires !== void 0) {
+      const expiresAt = typeof expires === "number" ? new Date(Date.now() + expires * 1e3) : expires instanceof Date ? expires : new Date(expires);
+      cookie += `; expires=${expiresAt.toUTCString()}`;
+    }
+    if (path) cookie += `; path=${path}`;
+    if (domain) cookie += `; domain=${domain}`;
+    if (secure) cookie += "; secure";
+    document.cookie = cookie;
+  }
+  /**
+   * 删除指定 Cookie。
+   */
+  static delete(name, path, domain, secure) {
+    this.write(name, "", /* @__PURE__ */ new Date(0), path, domain, secure);
+  }
+  /**
+   * 将对象序列化为 JSON 后写入 Cookie。
+   */
+  static writeJSON(name, value, expires = 86400, path, domain, secure) {
+    this.write(name, JSON.stringify(value), expires, path, domain, secure);
+  }
+  /**
+   * 读取 Cookie 并按 JSON 反序列化。
+   */
+  static readJSON(name) {
+    const value = this.read(name);
+    if (!value) return null;
+    try {
+      return JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 读取所有 Cookie。
+   */
+  static readAll() {
+    const cookies = {};
+    if (!document.cookie) return cookies;
+    for (const item of document.cookie.split("; ")) {
+      const [name, ...valueParts] = item.split("=");
+      if (name) cookies[name] = valueParts.join("=");
+    }
+    return cookies;
+  }
+  /**
+   * 判断指定 Cookie 是否存在。
+   */
+  static has(name) {
+    return this.read(name) !== null;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CookieUtils
+});

package/dist/browser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 浏览器专用入口。
+ */
+export { default as CookieUtils } from './utils/CookieUtils';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/browser.js

@@ -0,0 +1,75 @@
+// src/utils/CookieUtils.ts
+var CookieUtils = class {
+  /**
+   * 读取指定 Cookie。
+   */
+  static read(name) {
+    const cookies = document.cookie ? document.cookie.split("; ") : [];
+    for (const item of cookies) {
+      const [cookieName, ...valueParts] = item.split("=");
+      if (cookieName === name) return valueParts.join("=");
+    }
+    return null;
+  }
+  /**
+   * 写入 Cookie。
+   *
+   * @param expires number 表示多少秒后过期；Date/string 表示绝对过期时间
+   */
+  static write(name, value, expires = 86400, path, domain, secure) {
+    let cookie = `${name}=${value}`;
+    if (expires !== void 0) {
+      const expiresAt = typeof expires === "number" ? new Date(Date.now() + expires * 1e3) : expires instanceof Date ? expires : new Date(expires);
+      cookie += `; expires=${expiresAt.toUTCString()}`;
+    }
+    if (path) cookie += `; path=${path}`;
+    if (domain) cookie += `; domain=${domain}`;
+    if (secure) cookie += "; secure";
+    document.cookie = cookie;
+  }
+  /**
+   * 删除指定 Cookie。
+   */
+  static delete(name, path, domain, secure) {
+    this.write(name, "", /* @__PURE__ */ new Date(0), path, domain, secure);
+  }
+  /**
+   * 将对象序列化为 JSON 后写入 Cookie。
+   */
+  static writeJSON(name, value, expires = 86400, path, domain, secure) {
+    this.write(name, JSON.stringify(value), expires, path, domain, secure);
+  }
+  /**
+   * 读取 Cookie 并按 JSON 反序列化。
+   */
+  static readJSON(name) {
+    const value = this.read(name);
+    if (!value) return null;
+    try {
+      return JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 读取所有 Cookie。
+   */
+  static readAll() {
+    const cookies = {};
+    if (!document.cookie) return cookies;
+    for (const item of document.cookie.split("; ")) {
+      const [name, ...valueParts] = item.split("=");
+      if (name) cookies[name] = valueParts.join("=");
+    }
+    return cookies;
+  }
+  /**
+   * 判断指定 Cookie 是否存在。
+   */
+  static has(name) {
+    return this.read(name) !== null;
+  }
+};
+export {
+  CookieUtils
+};

package/dist/chunk-PV2X54HI.js

@@ -0,0 +1,75 @@
+// src/api/adapter/ApiAdapter.ts
+var ApiAdapter = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  /**
+   * 触发标准化进度回调。
+   */
+  emitProgress(handler, loaded, total, event) {
+    if (!handler) return;
+    const lengthComputable = typeof total === "number" && Number.isFinite(total) && total > 0;
+    const progress = {
+      loaded,
+      lengthComputable,
+      event
+    };
+    if (lengthComputable) {
+      progress.total = total;
+      progress.percent = Math.min(100, Math.round(loaded / total * 100));
+    }
+    handler(progress);
+  }
+  /**
+   * 将 fetch / axios / xhr 等运行时进度事件转换为标准进度对象。
+   */
+  emitProgressEvent(handler, event) {
+    const source = event;
+    const loaded = Number(source.loaded ?? 0);
+    const total = source.lengthComputable === false ? void 0 : source.total;
+    this.emitProgress(handler, loaded, total, event);
+  }
+  /**
+   * 将上传请求数据转换为 FormData。
+   */
+  formData(config, target) {
+    if (!config.isUpload) return;
+    const formData = this.options.formDataFactory?.() ?? this.createGlobalFormData();
+    const fileName = config.data.fileName ?? "file";
+    for (const [key, value] of Object.entries(config.data)) {
+      if (key !== "file" && key !== "fileName")
+        formData.append(key, value);
+    }
+    if (config.data.file !== void 0)
+      formData.append(fileName, config.data.file);
+    target.data = formData;
+    target.headers ?? (target.headers = {});
+    target.headers["Content-Type"] = "multipart/form-data";
+    target.method = "POST";
+  }
+  /**
+   * 使用全局 FormData 构造器。
+   */
+  createGlobalFormData() {
+    const FormDataCtor = globalThis.FormData;
+    if (!FormDataCtor) {
+      throw new Error(
+        "FormData is not available; pass formDataFactory to the adapter"
+      );
+    }
+    return new FormDataCtor();
+  }
+};
+
+// src/api/ApiResponse.ts
+var ApiResponse = class {
+  constructor(status, data) {
+    this.status = status;
+    this.data = data;
+  }
+};
+
+export {
+  ApiAdapter,
+  ApiResponse
+};