@hlw-uni-mp/request 1.0.1 → 1.0.3

package/dist/index.d.mts

@@ -56,25 +56,30 @@ declare function sha256(rawInput: string): string;
 /**
  * 递归规范化参数排序串（与后端 1:1 对齐）
  */
-declare function sortString(data: any): string;
+declare function sortString(data: unknown): string;
 interface SignOptions {
     timestamp: string | number;
     nonce: string;
     context: string;
     secret?: string;
-    data?: any;
+    data?: unknown;
 }
 /**
  * 计算请求防篡改签名
  */
 declare function calculateSign(options: SignOptions): string;
 
+/**
+ * 支持的 HTTP 请求动词
+ */
+type HttpMethod = 'OPTIONS' | 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'TRACE' | 'CONNECT'
+
 /**
  * 请求配置项
  */
 interface RequestConfig {
 	url: string
-	method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | string
+	method?: HttpMethod | string
 	data?: unknown
 	params?: unknown
 	baseURL?: string
@@ -85,7 +90,7 @@ interface RequestConfig {
 /**
  * 响应数据包
  */
-interface AxiosResponse<T = any> {
+interface AxiosResponse<T = unknown> {
 	data: T
 	status: number
 	statusText: string
@@ -98,7 +103,7 @@ interface AxiosResponse<T = any> {
  */
 interface InterceptorHandler<T> {
 	fulfilled?: (value: T) => T | Promise<T>
-	rejected?: (error: any) => any
+	rejected?: (error: unknown) => unknown
 }
 
 /**
@@ -126,7 +131,7 @@ interface ApiResData {
 /**
  * 接口响应表
  */
-interface ApiRes<T = any> {
+interface ApiRes<T = unknown> {
 	/**
 	 * 状态码数值 (1 为成功)
 	 */
@@ -168,7 +173,7 @@ interface HttpOptions {
 	/**
 	 * 获取设备函数
 	 */
-	getDevice?: () => DeviceInfo | Record<string, any>
+	getDevice?: () => DeviceInfo | Record<string, unknown>
 	/**
 	 * 鉴权失败回调
 	 */
@@ -201,17 +206,14 @@ interface LocalUploadSign extends UploadSignBase {
 }
 
 /**
- * 阿里存储凭据
+ * 阿里存储凭据（严格遵循阿里云 PostObject 规范单一属性名）
  */
 interface AliossUploadSign extends UploadSignBase {
 	type: 'alioss'
 	OSSAccessKeyId: string
 	policy: string
 	Signature: string
-	success_action_status: string
-	oSSAccessKeyId?: string
-	signature?: string
-	successActionStatus?: string
+	success_action_status?: string
 }
 
 /**
@@ -290,7 +292,10 @@ declare function encryptRsa(plaintext: string, publicKey: string): string;
  * @param source 源文件路径或文件对象
  * @returns 资源访问地址
  */
-declare function uploadOss(oss: OssConfig, source: string | any): Promise<string>;
+declare function uploadOss(oss: OssConfig, source: string | {
+    path?: string;
+    tempFilePath?: string;
+}): Promise<string>;
 
 /**
  * 请求上传凭证
@@ -304,7 +309,7 @@ declare function postUploadSign(data: {
     size?: number;
 }, signUrl?: string): Promise<ApiRes<UploadSign>>;
 /**
- * 执行文件直传
+ * 执行文件直传（原生解析，杜绝 escape/decode 废弃 API）
  * @param cred 上传签名凭据
  * @param filePath 本地文件路径
  * @param customHeader 额外请求头
@@ -318,12 +323,25 @@ declare function doUpload(cred: UploadSign, filePath: string, customHeader?: Rec
  */
 declare function uploadFile(params: UploadFileParams): Promise<string>;
 
+/**
+ * 统一网络请求异常类
+ */
+declare class HttpError<T = unknown> extends Error {
+    response?: AxiosResponse<T>;
+    status?: number;
+    config?: RequestConfig;
+    constructor(message: string, options?: {
+        response?: AxiosResponse<T>;
+        status?: number;
+        config?: RequestConfig;
+    });
+}
 /**
  * 拦截管理器
  */
 declare class InterceptorManager<T> {
     private handlers;
-    use(fulfilled?: (value: T) => T | Promise<T>, rejected?: (error: any) => any): number;
+    use(fulfilled?: (value: T) => T | Promise<T>, rejected?: (error: unknown) => unknown): number;
     eject(id: number): void;
     forEach(fn: (handler: InterceptorHandler<T>) => void): void;
 }
@@ -338,18 +356,18 @@ declare class UniHttpClient {
     };
     interceptors: {
         request: InterceptorManager<RequestConfig>;
-        response: InterceptorManager<AxiosResponse<any>>;
+        response: InterceptorManager<AxiosResponse<unknown>>;
     };
     constructor(options?: {
         baseURL?: string;
         timeout?: number;
         headers?: Record<string, string>;
     });
-    request<T = any>(config: RequestConfig): Promise<AxiosResponse<T>>;
-    get<T = any>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
-    post<T = any>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
-    put<T = any>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
-    delete<T = any>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    request<T = unknown>(config: RequestConfig): Promise<AxiosResponse<T>>;
+    get<T = unknown>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    post<T = unknown>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    put<T = unknown>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    delete<T = unknown>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
     private resolveUrl;
     private send;
 }
@@ -364,23 +382,23 @@ declare function setupHttp(options?: Partial<HttpOptions>): UniHttpClient;
 /**
  * 发送通用请求
  */
-declare function request<T = any>(config: RequestConfig): Promise<ApiRes<T>>;
+declare function request<T = unknown>(config: RequestConfig): Promise<ApiRes<T>>;
 /**
  * 发送 GET 读取请求
  */
-declare function get<T = any>(url: string, params?: unknown): Promise<ApiRes<T>>;
+declare function get<T = unknown>(url: string, params?: unknown): Promise<ApiRes<T>>;
 /**
  * 发送 POST 提交请求
  */
-declare function post<T = any>(url: string, data?: unknown): Promise<ApiRes<T>>;
+declare function post<T = unknown>(url: string, data?: unknown): Promise<ApiRes<T>>;
 /**
  * 发送 PUT 修改请求
  */
-declare function put<T = any>(url: string, data?: unknown): Promise<ApiRes<T>>;
+declare function put<T = unknown>(url: string, data?: unknown): Promise<ApiRes<T>>;
 /**
  * 发送 DELETE 删除请求
  */
-declare function del<T = any>(url: string, params?: unknown): Promise<ApiRes<T>>;
+declare function del<T = unknown>(url: string, params?: unknown): Promise<ApiRes<T>>;
 /**
  * 获取全局网络配置
  */
@@ -388,4 +406,4 @@ declare function getHttpOptions(): HttpOptions;
 declare const client: UniHttpClient;
 declare const http: UniHttpClient;
 
-export { type AliossUploadSign, type ApiRes, type ApiResData, type AxiosResponse, type DeviceInfo, type HttpOptions, type InterceptorHandler, InterceptorManager, type LocalUploadSign, type ModalOptions, type OssConfig, type QiniuUploadSign, type RequestConfig, type SignOptions, UniHttpClient, type UploadFileParams, type UploadSign, type UploadSignBase, calculateSign, client, request as default, del, doUpload, encryptRsa, get, getClient, getDevice, getHttpOptions, http, post, postUploadSign, put, request, setupHttp, sha256, sortString, uploadFile, uploadOss };
+export { type AliossUploadSign, type ApiRes, type ApiResData, type AxiosResponse, type DeviceInfo, HttpError, type HttpMethod, type HttpOptions, type InterceptorHandler, InterceptorManager, type LocalUploadSign, type ModalOptions, type OssConfig, type QiniuUploadSign, type RequestConfig, type SignOptions, UniHttpClient, type UploadFileParams, type UploadSign, type UploadSignBase, calculateSign, client, request as default, del, doUpload, encryptRsa, get, getClient, getDevice, getHttpOptions, http, post, postUploadSign, put, request, setupHttp, sha256, sortString, uploadFile, uploadOss };

package/dist/index.d.ts

@@ -56,25 +56,30 @@ declare function sha256(rawInput: string): string;
 /**
  * 递归规范化参数排序串（与后端 1:1 对齐）
  */
-declare function sortString(data: any): string;
+declare function sortString(data: unknown): string;
 interface SignOptions {
     timestamp: string | number;
     nonce: string;
     context: string;
     secret?: string;
-    data?: any;
+    data?: unknown;
 }
 /**
  * 计算请求防篡改签名
  */
 declare function calculateSign(options: SignOptions): string;
 
+/**
+ * 支持的 HTTP 请求动词
+ */
+type HttpMethod = 'OPTIONS' | 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'TRACE' | 'CONNECT'
+
 /**
  * 请求配置项
  */
 interface RequestConfig {
 	url: string
-	method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | string
+	method?: HttpMethod | string
 	data?: unknown
 	params?: unknown
 	baseURL?: string
@@ -85,7 +90,7 @@ interface RequestConfig {
 /**
  * 响应数据包
  */
-interface AxiosResponse<T = any> {
+interface AxiosResponse<T = unknown> {
 	data: T
 	status: number
 	statusText: string
@@ -98,7 +103,7 @@ interface AxiosResponse<T = any> {
  */
 interface InterceptorHandler<T> {
 	fulfilled?: (value: T) => T | Promise<T>
-	rejected?: (error: any) => any
+	rejected?: (error: unknown) => unknown
 }
 
 /**
@@ -126,7 +131,7 @@ interface ApiResData {
 /**
  * 接口响应表
  */
-interface ApiRes<T = any> {
+interface ApiRes<T = unknown> {
 	/**
 	 * 状态码数值 (1 为成功)
 	 */
@@ -168,7 +173,7 @@ interface HttpOptions {
 	/**
 	 * 获取设备函数
 	 */
-	getDevice?: () => DeviceInfo | Record<string, any>
+	getDevice?: () => DeviceInfo | Record<string, unknown>
 	/**
 	 * 鉴权失败回调
 	 */
@@ -201,17 +206,14 @@ interface LocalUploadSign extends UploadSignBase {
 }
 
 /**
- * 阿里存储凭据
+ * 阿里存储凭据（严格遵循阿里云 PostObject 规范单一属性名）
  */
 interface AliossUploadSign extends UploadSignBase {
 	type: 'alioss'
 	OSSAccessKeyId: string
 	policy: string
 	Signature: string
-	success_action_status: string
-	oSSAccessKeyId?: string
-	signature?: string
-	successActionStatus?: string
+	success_action_status?: string
 }
 
 /**
@@ -290,7 +292,10 @@ declare function encryptRsa(plaintext: string, publicKey: string): string;
  * @param source 源文件路径或文件对象
  * @returns 资源访问地址
  */
-declare function uploadOss(oss: OssConfig, source: string | any): Promise<string>;
+declare function uploadOss(oss: OssConfig, source: string | {
+    path?: string;
+    tempFilePath?: string;
+}): Promise<string>;
 
 /**
  * 请求上传凭证
@@ -304,7 +309,7 @@ declare function postUploadSign(data: {
     size?: number;
 }, signUrl?: string): Promise<ApiRes<UploadSign>>;
 /**
- * 执行文件直传
+ * 执行文件直传（原生解析，杜绝 escape/decode 废弃 API）
  * @param cred 上传签名凭据
  * @param filePath 本地文件路径
  * @param customHeader 额外请求头
@@ -318,12 +323,25 @@ declare function doUpload(cred: UploadSign, filePath: string, customHeader?: Rec
  */
 declare function uploadFile(params: UploadFileParams): Promise<string>;
 
+/**
+ * 统一网络请求异常类
+ */
+declare class HttpError<T = unknown> extends Error {
+    response?: AxiosResponse<T>;
+    status?: number;
+    config?: RequestConfig;
+    constructor(message: string, options?: {
+        response?: AxiosResponse<T>;
+        status?: number;
+        config?: RequestConfig;
+    });
+}
 /**
  * 拦截管理器
  */
 declare class InterceptorManager<T> {
     private handlers;
-    use(fulfilled?: (value: T) => T | Promise<T>, rejected?: (error: any) => any): number;
+    use(fulfilled?: (value: T) => T | Promise<T>, rejected?: (error: unknown) => unknown): number;
     eject(id: number): void;
     forEach(fn: (handler: InterceptorHandler<T>) => void): void;
 }
@@ -338,18 +356,18 @@ declare class UniHttpClient {
     };
     interceptors: {
         request: InterceptorManager<RequestConfig>;
-        response: InterceptorManager<AxiosResponse<any>>;
+        response: InterceptorManager<AxiosResponse<unknown>>;
     };
     constructor(options?: {
         baseURL?: string;
         timeout?: number;
         headers?: Record<string, string>;
     });
-    request<T = any>(config: RequestConfig): Promise<AxiosResponse<T>>;
-    get<T = any>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
-    post<T = any>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
-    put<T = any>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
-    delete<T = any>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    request<T = unknown>(config: RequestConfig): Promise<AxiosResponse<T>>;
+    get<T = unknown>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    post<T = unknown>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    put<T = unknown>(url: string, data?: unknown, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
+    delete<T = unknown>(url: string, config?: Partial<RequestConfig>): Promise<AxiosResponse<T>>;
     private resolveUrl;
     private send;
 }
@@ -364,23 +382,23 @@ declare function setupHttp(options?: Partial<HttpOptions>): UniHttpClient;
 /**
  * 发送通用请求
  */
-declare function request<T = any>(config: RequestConfig): Promise<ApiRes<T>>;
+declare function request<T = unknown>(config: RequestConfig): Promise<ApiRes<T>>;
 /**
  * 发送 GET 读取请求
  */
-declare function get<T = any>(url: string, params?: unknown): Promise<ApiRes<T>>;
+declare function get<T = unknown>(url: string, params?: unknown): Promise<ApiRes<T>>;
 /**
  * 发送 POST 提交请求
  */
-declare function post<T = any>(url: string, data?: unknown): Promise<ApiRes<T>>;
+declare function post<T = unknown>(url: string, data?: unknown): Promise<ApiRes<T>>;
 /**
  * 发送 PUT 修改请求
  */
-declare function put<T = any>(url: string, data?: unknown): Promise<ApiRes<T>>;
+declare function put<T = unknown>(url: string, data?: unknown): Promise<ApiRes<T>>;
 /**
  * 发送 DELETE 删除请求
  */
-declare function del<T = any>(url: string, params?: unknown): Promise<ApiRes<T>>;
+declare function del<T = unknown>(url: string, params?: unknown): Promise<ApiRes<T>>;
 /**
  * 获取全局网络配置
  */
@@ -388,4 +406,4 @@ declare function getHttpOptions(): HttpOptions;
 declare const client: UniHttpClient;
 declare const http: UniHttpClient;
 
-export { type AliossUploadSign, type ApiRes, type ApiResData, type AxiosResponse, type DeviceInfo, type HttpOptions, type InterceptorHandler, InterceptorManager, type LocalUploadSign, type ModalOptions, type OssConfig, type QiniuUploadSign, type RequestConfig, type SignOptions, UniHttpClient, type UploadFileParams, type UploadSign, type UploadSignBase, calculateSign, client, request as default, del, doUpload, encryptRsa, get, getClient, getDevice, getHttpOptions, http, post, postUploadSign, put, request, setupHttp, sha256, sortString, uploadFile, uploadOss };
+export { type AliossUploadSign, type ApiRes, type ApiResData, type AxiosResponse, type DeviceInfo, HttpError, type HttpMethod, type HttpOptions, type InterceptorHandler, InterceptorManager, type LocalUploadSign, type ModalOptions, type OssConfig, type QiniuUploadSign, type RequestConfig, type SignOptions, UniHttpClient, type UploadFileParams, type UploadSign, type UploadSignBase, calculateSign, client, request as default, del, doUpload, encryptRsa, get, getClient, getDevice, getHttpOptions, http, post, postUploadSign, put, request, setupHttp, sha256, sortString, uploadFile, uploadOss };

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  HttpError: () => HttpError,
   InterceptorManager: () => InterceptorManager,
   UniHttpClient: () => UniHttpClient,
   calculateSign: () => calculateSign,
@@ -58,64 +59,57 @@ module.exports = __toCommonJS(index_exports);
 // src/device/index.ts
 var deviceCache = null;
 var currentNetworkType = "";
-try {
-  if (typeof uni !== "undefined" && uni.getNetworkType) {
-    uni.getNetworkType({
-      success(res) {
-        currentNetworkType = res.networkType || "";
-        if (deviceCache) {
-          deviceCache.networkType = currentNetworkType;
-        }
-      }
-    });
-    if (uni.onNetworkStatusChange) {
-      uni.onNetworkStatusChange((res) => {
-        currentNetworkType = res.networkType || "";
-        if (deviceCache) {
-          deviceCache.networkType = currentNetworkType;
-        }
-      });
+uni.getNetworkType({
+  success(res) {
+    currentNetworkType = res.networkType || "";
+    if (deviceCache) {
+      deviceCache.networkType = currentNetworkType;
     }
   }
-} catch {
-}
+});
+uni.onNetworkStatusChange((res) => {
+  currentNetworkType = res.networkType || "";
+  if (deviceCache) {
+    deviceCache.networkType = currentNetworkType;
+  }
+});
 function getDevice() {
   if (deviceCache) return deviceCache;
-  const deviceRaw = typeof uni !== "undefined" ? uni.getDeviceInfo?.() : void 0;
-  const windowRaw = typeof uni !== "undefined" ? uni.getWindowInfo?.() : void 0;
-  const appRaw = typeof uni !== "undefined" ? uni.getAppBaseInfo?.() : void 0;
-  const accountRaw = typeof uni !== "undefined" ? uni.getAccountInfoSync?.() : void 0;
-  const system = deviceRaw?.system || "";
+  const deviceRaw = uni.getDeviceInfo();
+  const windowRaw = uni.getWindowInfo();
+  const appRaw = uni.getAppBaseInfo();
+  const accountRaw = uni.getAccountInfoSync();
+  const system = deviceRaw.system || "";
   deviceCache = {
-    appid: accountRaw?.miniProgram?.appId || "",
-    appName: appRaw?.appName || "",
-    version: appRaw?.appVersion || "",
-    versionCode: appRaw?.appVersionCode || "",
-    channel: appRaw?.appChannel || "",
-    deviceId: deviceRaw?.deviceId || "",
-    deviceType: deviceRaw?.deviceType || "",
-    deviceOrientation: deviceRaw?.deviceOrientation || windowRaw?.deviceOrientation || "portrait",
-    brand: deviceRaw?.brand || "",
-    model: deviceRaw?.model || "",
+    appid: accountRaw.miniProgram?.appId || "",
+    appName: appRaw.appName || "",
+    version: appRaw.appVersion || "",
+    versionCode: appRaw.appVersionCode || "",
+    channel: appRaw.appChannel || "",
+    deviceId: deviceRaw.deviceId || "",
+    deviceType: deviceRaw.deviceType || "",
+    deviceOrientation: deviceRaw.deviceOrientation || windowRaw.deviceOrientation || "portrait",
+    brand: deviceRaw.brand || "",
+    model: deviceRaw.model || "",
     system,
     os: system.split(" ")[0] || "",
-    pixelRatio: windowRaw?.pixelRatio || 0,
-    screenWidth: windowRaw?.screenWidth || 0,
-    screenHeight: windowRaw?.screenHeight || 0,
-    windowWidth: windowRaw?.windowWidth || 0,
-    windowHeight: windowRaw?.windowHeight || 0,
-    statusBarHeight: windowRaw?.statusBarHeight || 0,
-    sdkVersion: appRaw?.SDKVersion || "",
-    hostName: appRaw?.hostName || "",
-    hostVersion: appRaw?.hostVersion || "",
-    hostLanguage: appRaw?.hostLanguage || "",
-    hostTheme: appRaw?.hostTheme || "",
-    platform: deviceRaw?.platform || "",
-    language: appRaw?.appLanguage || appRaw?.language || "",
+    pixelRatio: windowRaw.pixelRatio || 0,
+    screenWidth: windowRaw.screenWidth || 0,
+    screenHeight: windowRaw.screenHeight || 0,
+    windowWidth: windowRaw.windowWidth || 0,
+    windowHeight: windowRaw.windowHeight || 0,
+    statusBarHeight: windowRaw.statusBarHeight || 0,
+    sdkVersion: appRaw.SDKVersion || "",
+    hostName: appRaw.hostName || "",
+    hostVersion: appRaw.hostVersion || "",
+    hostLanguage: appRaw.hostLanguage || "",
+    hostTheme: appRaw.hostTheme || "",
+    platform: deviceRaw.platform || "",
+    language: appRaw.appLanguage || appRaw.language || "",
     networkType: currentNetworkType,
-    benchmarkLevel: deviceRaw?.benchmarkLevel || 0,
-    theme: appRaw?.theme || "light",
-    fontSizeSetting: appRaw?.fontSizeSetting || 16
+    benchmarkLevel: deviceRaw.benchmarkLevel || 0,
+    theme: appRaw.theme || "light",
+    fontSizeSetting: appRaw.fontSizeSetting || 16
   };
   return deviceCache;
 }
@@ -305,10 +299,11 @@ function sortString(data) {
   if (Array.isArray(data)) {
     return "[" + data.map((item) => sortString(item)).join(",") + "]";
   }
-  const keys = Object.keys(data).sort();
+  const obj = data;
+  const keys = Object.keys(obj).sort();
   const parts = [];
   for (const key of keys) {
-    const val = data[key];
+    const val = obj[key];
     if (val !== null && val !== void 0) {
       parts.push(`${key}=${sortString(val)}`);
     }
@@ -327,17 +322,17 @@ function calculateSign(options) {
 
 // src/oss.ts
 async function uploadOss(oss, source) {
-  const filePath = typeof source === "string" ? source : source?.path || source?.tempFilePath || "";
-  const name = oss.filename || filePath?.split("/").pop() || "file";
+  const filePath = typeof source === "string" ? source : source.path || source.tempFilePath || "";
+  const name = oss.filename || filePath.split("/").pop() || "file";
   const formData = {
-    key: String(oss.key || ""),
+    key: oss.key || "",
     success_action_status: "200"
   };
-  if (oss.policy) formData.policy = String(oss.policy);
-  if (oss.OSSAccessKeyId) formData.OSSAccessKeyId = String(oss.OSSAccessKeyId);
-  if (oss.signature) formData.signature = String(oss.signature);
+  if (oss.policy) formData.policy = oss.policy;
+  if (oss.OSSAccessKeyId) formData.OSSAccessKeyId = oss.OSSAccessKeyId;
+  if (oss.signature) formData.signature = oss.signature;
   if (oss["x-oss-security-token"]) formData["x-oss-security-token"] = String(oss["x-oss-security-token"]);
-  const target2 = String(oss.host || "");
+  const target2 = oss.host || "";
   return new Promise((resolve, reject) => {
     uni.uploadFile({
       url: target2,
@@ -349,7 +344,7 @@ async function uploadOss(oss, source) {
       },
       success: (res) => {
         if (res.statusCode === 200 || res.statusCode === 204) {
-          resolve(String(oss.url || ""));
+          resolve(oss.url || "");
         } else {
           reject(new Error(`\u4E0A\u4F20\u963F\u91CC\u4E91\u5931\u8D25 (${res.statusCode}): ${res.data || ""}`));
         }
@@ -372,9 +367,9 @@ function buildFormData(cred) {
     return {
       key: cred.key,
       policy: cred.policy,
-      OSSAccessKeyId: cred.OSSAccessKeyId || cred.oSSAccessKeyId || "",
-      Signature: cred.Signature || cred.signature || "",
-      success_action_status: cred.success_action_status || cred.successActionStatus || "200"
+      OSSAccessKeyId: cred.OSSAccessKeyId,
+      Signature: cred.Signature,
+      success_action_status: cred.success_action_status || "200"
     };
   }
   return {
@@ -382,14 +377,6 @@ function buildFormData(cred) {
     token: cred.token
   };
 }
-function decodeUtf8(value) {
-  if (!value) return value;
-  try {
-    return decodeURIComponent(escape(value));
-  } catch {
-    return value;
-  }
-}
 function buildHeader(cred, customHeader) {
   if (cred.type !== "local" && !customHeader) {
     return void 0;
@@ -426,13 +413,13 @@ function doUpload(cred, filePath, customHeader) {
           return;
         }
         try {
-          const body = JSON.parse(decodeUtf8(res.data));
-          body.code === 1 ? resolve() : reject(new Error(body.msg || "\u4E0A\u4F20\u5931\u8D25"));
+          const body = typeof res.data === "string" ? JSON.parse(res.data) : res.data;
+          body?.code === 1 ? resolve() : reject(new Error(body?.msg || "\u4E0A\u4F20\u5931\u8D25"));
         } catch {
           reject(new Error("\u54CD\u5E94\u89E3\u6790\u5931\u8D25"));
         }
       },
-      fail: (error) => reject(new Error(error?.errMsg || "\u4E0A\u4F20\u5931\u8D25"))
+      fail: (error) => reject(new Error(error.errMsg || "\u4E0A\u4F20\u5931\u8D25"))
     });
   });
 }
@@ -449,6 +436,15 @@ async function uploadFile(params) {
 }
 
 // src/index.ts
+var HttpError = class extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "HttpError";
+    this.response = options?.response;
+    this.status = options?.status;
+    this.config = options?.config;
+  }
+};
 var InterceptorManager = class {
   constructor() {
     this.handlers = [];
@@ -537,9 +533,10 @@ var UniHttpClient = class {
     return new Promise((resolve, reject) => {
       const isGet = (cfg.method || "GET").toUpperCase() === "GET";
       const requestData = isGet ? cfg.params ?? cfg.data : cfg.data ?? cfg.params;
+      const method = cfg.method?.toUpperCase() || "GET";
       uni.request({
         url,
-        method: cfg.method?.toUpperCase() || "GET",
+        method,
         data: requestData,
         header: cfg.headers,
         timeout: cfg.timeout,
@@ -555,16 +552,12 @@ var UniHttpClient = class {
             resolve(response);
           } else {
             const body = res.data;
-            const error = new Error(String(body?.msg || `\u8BF7\u6C42\u5931\u8D25: ${res.statusCode}`));
-            error.response = response;
-            error.status = res.statusCode;
-            reject(error);
+            const msg = typeof body?.msg === "string" ? body.msg : `\u8BF7\u6C42\u5931\u8D25: ${res.statusCode}`;
+            reject(new HttpError(msg, { response, status: res.statusCode, config: cfg }));
           }
         },
         fail: (errorResult) => {
-          const error = new Error(errorResult.errMsg || "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25");
-          error.config = cfg;
-          reject(error);
+          reject(new HttpError(errorResult.errMsg || "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25", { config: cfg }));
         }
       });
     });
@@ -577,9 +570,7 @@ function handleUnauthorized(message, callback) {
   const now = Date.now();
   if (now - lastToastTime > 3e3) {
     lastToastTime = now;
-    if (typeof uni !== "undefined" && uni.showToast) {
-      uni.showToast({ title: message, icon: "none" });
-    }
+    uni.showToast({ title: message, icon: "none" });
   }
   if (callback) {
     callback(message);
@@ -629,7 +620,7 @@ function getClient() {
       config.headers["X-Client-Nonce"] = nonce;
       config.headers["X-Client-Sign"] = sign;
       config.headers["X-Client-Context"] = cipher;
-      if (devInfo.appid) {
+      if ("appid" in devInfo && devInfo.appid) {
         config.headers["x-appid"] = String(devInfo.appid);
       }
       return config;
@@ -646,8 +637,10 @@ function getClient() {
       return response;
     },
     (error) => {
-      const status = error.response?.status;
-      const message = error.response?.data?.msg || error.message || "\u7F51\u7EDC\u8FDE\u63A5\u5F02\u5E38";
+      const httpErr = error instanceof HttpError ? error : void 0;
+      const status = httpErr?.status ?? httpErr?.response?.status;
+      const body = httpErr?.response?.data;
+      const message = body?.msg || (error instanceof Error ? error.message : "\u7F51\u7EDC\u8FDE\u63A5\u5F02\u5E38");
       if (status === 401 || status === 403) {
         handleUnauthorized(message, currentOptions.onUnauthorized);
       }
@@ -685,7 +678,7 @@ function getHttpOptions() {
 var client = new Proxy({}, {
   get(_, prop) {
     const inst = getClient();
-    const val = inst[prop];
+    const val = Reflect.get(inst, prop);
     return typeof val === "function" ? val.bind(inst) : val;
   }
 });
@@ -693,6 +686,7 @@ var http = client;
 var index_default = request;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HttpError,
   InterceptorManager,
   UniHttpClient,
   calculateSign,

package/dist/index.mjs

@@ -1,64 +1,57 @@
 // src/device/index.ts
 var deviceCache = null;
 var currentNetworkType = "";
-try {
-  if (typeof uni !== "undefined" && uni.getNetworkType) {
-    uni.getNetworkType({
-      success(res) {
-        currentNetworkType = res.networkType || "";
-        if (deviceCache) {
-          deviceCache.networkType = currentNetworkType;
-        }
-      }
-    });
-    if (uni.onNetworkStatusChange) {
-      uni.onNetworkStatusChange((res) => {
-        currentNetworkType = res.networkType || "";
-        if (deviceCache) {
-          deviceCache.networkType = currentNetworkType;
-        }
-      });
+uni.getNetworkType({
+  success(res) {
+    currentNetworkType = res.networkType || "";
+    if (deviceCache) {
+      deviceCache.networkType = currentNetworkType;
     }
   }
-} catch {
-}
+});
+uni.onNetworkStatusChange((res) => {
+  currentNetworkType = res.networkType || "";
+  if (deviceCache) {
+    deviceCache.networkType = currentNetworkType;
+  }
+});
 function getDevice() {
   if (deviceCache) return deviceCache;
-  const deviceRaw = typeof uni !== "undefined" ? uni.getDeviceInfo?.() : void 0;
-  const windowRaw = typeof uni !== "undefined" ? uni.getWindowInfo?.() : void 0;
-  const appRaw = typeof uni !== "undefined" ? uni.getAppBaseInfo?.() : void 0;
-  const accountRaw = typeof uni !== "undefined" ? uni.getAccountInfoSync?.() : void 0;
-  const system = deviceRaw?.system || "";
+  const deviceRaw = uni.getDeviceInfo();
+  const windowRaw = uni.getWindowInfo();
+  const appRaw = uni.getAppBaseInfo();
+  const accountRaw = uni.getAccountInfoSync();
+  const system = deviceRaw.system || "";
   deviceCache = {
-    appid: accountRaw?.miniProgram?.appId || "",
-    appName: appRaw?.appName || "",
-    version: appRaw?.appVersion || "",
-    versionCode: appRaw?.appVersionCode || "",
-    channel: appRaw?.appChannel || "",
-    deviceId: deviceRaw?.deviceId || "",
-    deviceType: deviceRaw?.deviceType || "",
-    deviceOrientation: deviceRaw?.deviceOrientation || windowRaw?.deviceOrientation || "portrait",
-    brand: deviceRaw?.brand || "",
-    model: deviceRaw?.model || "",
+    appid: accountRaw.miniProgram?.appId || "",
+    appName: appRaw.appName || "",
+    version: appRaw.appVersion || "",
+    versionCode: appRaw.appVersionCode || "",
+    channel: appRaw.appChannel || "",
+    deviceId: deviceRaw.deviceId || "",
+    deviceType: deviceRaw.deviceType || "",
+    deviceOrientation: deviceRaw.deviceOrientation || windowRaw.deviceOrientation || "portrait",
+    brand: deviceRaw.brand || "",
+    model: deviceRaw.model || "",
     system,
     os: system.split(" ")[0] || "",
-    pixelRatio: windowRaw?.pixelRatio || 0,
-    screenWidth: windowRaw?.screenWidth || 0,
-    screenHeight: windowRaw?.screenHeight || 0,
-    windowWidth: windowRaw?.windowWidth || 0,
-    windowHeight: windowRaw?.windowHeight || 0,
-    statusBarHeight: windowRaw?.statusBarHeight || 0,
-    sdkVersion: appRaw?.SDKVersion || "",
-    hostName: appRaw?.hostName || "",
-    hostVersion: appRaw?.hostVersion || "",
-    hostLanguage: appRaw?.hostLanguage || "",
-    hostTheme: appRaw?.hostTheme || "",
-    platform: deviceRaw?.platform || "",
-    language: appRaw?.appLanguage || appRaw?.language || "",
+    pixelRatio: windowRaw.pixelRatio || 0,
+    screenWidth: windowRaw.screenWidth || 0,
+    screenHeight: windowRaw.screenHeight || 0,
+    windowWidth: windowRaw.windowWidth || 0,
+    windowHeight: windowRaw.windowHeight || 0,
+    statusBarHeight: windowRaw.statusBarHeight || 0,
+    sdkVersion: appRaw.SDKVersion || "",
+    hostName: appRaw.hostName || "",
+    hostVersion: appRaw.hostVersion || "",
+    hostLanguage: appRaw.hostLanguage || "",
+    hostTheme: appRaw.hostTheme || "",
+    platform: deviceRaw.platform || "",
+    language: appRaw.appLanguage || appRaw.language || "",
     networkType: currentNetworkType,
-    benchmarkLevel: deviceRaw?.benchmarkLevel || 0,
-    theme: appRaw?.theme || "light",
-    fontSizeSetting: appRaw?.fontSizeSetting || 16
+    benchmarkLevel: deviceRaw.benchmarkLevel || 0,
+    theme: appRaw.theme || "light",
+    fontSizeSetting: appRaw.fontSizeSetting || 16
   };
   return deviceCache;
 }
@@ -248,10 +241,11 @@ function sortString(data) {
   if (Array.isArray(data)) {
     return "[" + data.map((item) => sortString(item)).join(",") + "]";
   }
-  const keys = Object.keys(data).sort();
+  const obj = data;
+  const keys = Object.keys(obj).sort();
   const parts = [];
   for (const key of keys) {
-    const val = data[key];
+    const val = obj[key];
     if (val !== null && val !== void 0) {
       parts.push(`${key}=${sortString(val)}`);
     }
@@ -270,17 +264,17 @@ function calculateSign(options) {
 
 // src/oss.ts
 async function uploadOss(oss, source) {
-  const filePath = typeof source === "string" ? source : source?.path || source?.tempFilePath || "";
-  const name = oss.filename || filePath?.split("/").pop() || "file";
+  const filePath = typeof source === "string" ? source : source.path || source.tempFilePath || "";
+  const name = oss.filename || filePath.split("/").pop() || "file";
   const formData = {
-    key: String(oss.key || ""),
+    key: oss.key || "",
     success_action_status: "200"
   };
-  if (oss.policy) formData.policy = String(oss.policy);
-  if (oss.OSSAccessKeyId) formData.OSSAccessKeyId = String(oss.OSSAccessKeyId);
-  if (oss.signature) formData.signature = String(oss.signature);
+  if (oss.policy) formData.policy = oss.policy;
+  if (oss.OSSAccessKeyId) formData.OSSAccessKeyId = oss.OSSAccessKeyId;
+  if (oss.signature) formData.signature = oss.signature;
   if (oss["x-oss-security-token"]) formData["x-oss-security-token"] = String(oss["x-oss-security-token"]);
-  const target2 = String(oss.host || "");
+  const target2 = oss.host || "";
   return new Promise((resolve, reject) => {
     uni.uploadFile({
       url: target2,
@@ -292,7 +286,7 @@ async function uploadOss(oss, source) {
       },
       success: (res) => {
         if (res.statusCode === 200 || res.statusCode === 204) {
-          resolve(String(oss.url || ""));
+          resolve(oss.url || "");
         } else {
           reject(new Error(`\u4E0A\u4F20\u963F\u91CC\u4E91\u5931\u8D25 (${res.statusCode}): ${res.data || ""}`));
         }
@@ -315,9 +309,9 @@ function buildFormData(cred) {
     return {
       key: cred.key,
       policy: cred.policy,
-      OSSAccessKeyId: cred.OSSAccessKeyId || cred.oSSAccessKeyId || "",
-      Signature: cred.Signature || cred.signature || "",
-      success_action_status: cred.success_action_status || cred.successActionStatus || "200"
+      OSSAccessKeyId: cred.OSSAccessKeyId,
+      Signature: cred.Signature,
+      success_action_status: cred.success_action_status || "200"
     };
   }
   return {
@@ -325,14 +319,6 @@ function buildFormData(cred) {
     token: cred.token
   };
 }
-function decodeUtf8(value) {
-  if (!value) return value;
-  try {
-    return decodeURIComponent(escape(value));
-  } catch {
-    return value;
-  }
-}
 function buildHeader(cred, customHeader) {
   if (cred.type !== "local" && !customHeader) {
     return void 0;
@@ -369,13 +355,13 @@ function doUpload(cred, filePath, customHeader) {
           return;
         }
         try {
-          const body = JSON.parse(decodeUtf8(res.data));
-          body.code === 1 ? resolve() : reject(new Error(body.msg || "\u4E0A\u4F20\u5931\u8D25"));
+          const body = typeof res.data === "string" ? JSON.parse(res.data) : res.data;
+          body?.code === 1 ? resolve() : reject(new Error(body?.msg || "\u4E0A\u4F20\u5931\u8D25"));
         } catch {
           reject(new Error("\u54CD\u5E94\u89E3\u6790\u5931\u8D25"));
         }
       },
-      fail: (error) => reject(new Error(error?.errMsg || "\u4E0A\u4F20\u5931\u8D25"))
+      fail: (error) => reject(new Error(error.errMsg || "\u4E0A\u4F20\u5931\u8D25"))
     });
   });
 }
@@ -392,6 +378,15 @@ async function uploadFile(params) {
 }
 
 // src/index.ts
+var HttpError = class extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "HttpError";
+    this.response = options?.response;
+    this.status = options?.status;
+    this.config = options?.config;
+  }
+};
 var InterceptorManager = class {
   constructor() {
     this.handlers = [];
@@ -480,9 +475,10 @@ var UniHttpClient = class {
     return new Promise((resolve, reject) => {
       const isGet = (cfg.method || "GET").toUpperCase() === "GET";
       const requestData = isGet ? cfg.params ?? cfg.data : cfg.data ?? cfg.params;
+      const method = cfg.method?.toUpperCase() || "GET";
       uni.request({
         url,
-        method: cfg.method?.toUpperCase() || "GET",
+        method,
         data: requestData,
         header: cfg.headers,
         timeout: cfg.timeout,
@@ -498,16 +494,12 @@ var UniHttpClient = class {
             resolve(response);
           } else {
             const body = res.data;
-            const error = new Error(String(body?.msg || `\u8BF7\u6C42\u5931\u8D25: ${res.statusCode}`));
-            error.response = response;
-            error.status = res.statusCode;
-            reject(error);
+            const msg = typeof body?.msg === "string" ? body.msg : `\u8BF7\u6C42\u5931\u8D25: ${res.statusCode}`;
+            reject(new HttpError(msg, { response, status: res.statusCode, config: cfg }));
           }
         },
         fail: (errorResult) => {
-          const error = new Error(errorResult.errMsg || "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25");
-          error.config = cfg;
-          reject(error);
+          reject(new HttpError(errorResult.errMsg || "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25", { config: cfg }));
         }
       });
     });
@@ -520,9 +512,7 @@ function handleUnauthorized(message, callback) {
   const now = Date.now();
   if (now - lastToastTime > 3e3) {
     lastToastTime = now;
-    if (typeof uni !== "undefined" && uni.showToast) {
-      uni.showToast({ title: message, icon: "none" });
-    }
+    uni.showToast({ title: message, icon: "none" });
   }
   if (callback) {
     callback(message);
@@ -572,7 +562,7 @@ function getClient() {
       config.headers["X-Client-Nonce"] = nonce;
       config.headers["X-Client-Sign"] = sign;
       config.headers["X-Client-Context"] = cipher;
-      if (devInfo.appid) {
+      if ("appid" in devInfo && devInfo.appid) {
         config.headers["x-appid"] = String(devInfo.appid);
       }
       return config;
@@ -589,8 +579,10 @@ function getClient() {
       return response;
     },
     (error) => {
-      const status = error.response?.status;
-      const message = error.response?.data?.msg || error.message || "\u7F51\u7EDC\u8FDE\u63A5\u5F02\u5E38";
+      const httpErr = error instanceof HttpError ? error : void 0;
+      const status = httpErr?.status ?? httpErr?.response?.status;
+      const body = httpErr?.response?.data;
+      const message = body?.msg || (error instanceof Error ? error.message : "\u7F51\u7EDC\u8FDE\u63A5\u5F02\u5E38");
       if (status === 401 || status === 403) {
         handleUnauthorized(message, currentOptions.onUnauthorized);
       }
@@ -628,13 +620,14 @@ function getHttpOptions() {
 var client = new Proxy({}, {
   get(_, prop) {
     const inst = getClient();
-    const val = inst[prop];
+    const val = Reflect.get(inst, prop);
     return typeof val === "function" ? val.bind(inst) : val;
   }
 });
 var http = client;
 var index_default = request;
 export {
+  HttpError,
   InterceptorManager,
   UniHttpClient,
   calculateSign,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hlw-uni-mp/request",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Universal Uni-App HTTP and upload client with RSA encryption & sign verification",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",