@hlw-uni/mp-vue 2.1.52 → 2.1.54

package/src/composables/http/client.ts

@@ -1,237 +0,0 @@
-/**
- * HttpClient - Axios 风格的 HTTP 客户端
- * 支持请求/响应拦截器、组件内请求 composable、上传策略模式。
- */
-import { ref } from 'vue';
-import type {
-  ApiResponse,
-  RequestConfig,
-  RequestInterceptor,
-  ResponseInterceptor,
-  ErrorInterceptor,
-  UploadConfig,
-  UploadResult,
-} from './types';
-import { getAdapter } from './adapters';
-
-/** 组件内请求返回的状态对象。 */
-export interface UseRequestReturn<T = unknown> {
-  loading: ReturnType<typeof ref<boolean>>;
-  data: ReturnType<typeof ref<T | null>>;
-  error: ReturnType<typeof ref<Error | null>>;
-  run: (config: RequestConfig) => Promise<ApiResponse<T>>;
-  get: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
-  post: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
-  put: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
-  del: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
-}
-
-export class HttpClient {
-  private _reqInterceptors: RequestInterceptor[] = [];
-  private _resInterceptors: ResponseInterceptor[] = [];
-  private _errInterceptors: ErrorInterceptor[] = [];
-  private _baseURL: string;
-  private _defaultHeaders: Record<string, string>;
-  private _noCache: boolean;
-
-  /**
-   * 创建 HttpClient 实例并初始化默认配置。
-   */
-  constructor(options: { baseURL?: string; headers?: Record<string, string>; noCache?: boolean } = {}) {
-    this._baseURL = options.baseURL ?? '';
-    this._noCache = options.noCache ?? true;
-    this._defaultHeaders = {
-      'Content-Type': 'application/json',
-      ...options.headers,
-    };
-  }
-
-  /** 运行时设置 baseURL。 */
-  setBaseURL(url: string): void {
-    this._baseURL = url;
-  }
-
-  /** 注册请求拦截器，并返回注销函数。 */
-  onRequest(fn: RequestInterceptor): () => void {
-    this._reqInterceptors.push(fn);
-    return () => {
-      const idx = this._reqInterceptors.indexOf(fn);
-      if (idx > -1) this._reqInterceptors.splice(idx, 1);
-    };
-  }
-
-  /** 注册响应拦截器，并返回注销函数。 */
-  onResponse<T = unknown>(fn: ResponseInterceptor<T>): () => void {
-    this._resInterceptors.push(fn as ResponseInterceptor);
-    return () => {
-      const idx = this._resInterceptors.indexOf(fn as ResponseInterceptor);
-      if (idx > -1) this._resInterceptors.splice(idx, 1);
-    };
-  }
-
-  /** 注册错误拦截器，并返回注销函数。 */
-  onError(fn: ErrorInterceptor): () => void {
-    this._errInterceptors.push(fn);
-    return () => {
-      const idx = this._errInterceptors.indexOf(fn);
-      if (idx > -1) this._errInterceptors.splice(idx, 1);
-    };
-  }
-
-  /**
-   * 执行一次全局请求，自动串联请求与响应拦截器。
-   */
-  async request<T = unknown>(config: RequestConfig): Promise<ApiResponse<T>> {
-    let cfg: RequestConfig = {
-      method: 'GET',
-      ...config,
-      headers: { ...this._defaultHeaders, ...config.headers },
-    };
-
-    for (const fn of this._reqInterceptors) {
-      cfg = await fn(cfg);
-    }
-
-    try {
-      const fullUrl = this._buildUrl(cfg.url);
-      const res = await this._doRequest<T>(fullUrl, cfg);
-
-      for (const fn of this._resInterceptors) {
-        const modified = await fn(res as ApiResponse<unknown>);
-        if (modified !== undefined) return modified as ApiResponse<T>;
-      }
-      return res;
-    } catch (e) {
-      const err = e as Error;
-      await this._applyErrorInterceptors(err);
-      throw err;
-    }
-  }
-
-  /**
-   * 创建组件内可复用的请求状态对象。
-   */
-  useRequest<T = unknown>(): UseRequestReturn<T> {
-    const loading = ref(false);
-    const data = ref<T | null>(null);
-    const error = ref<Error | null>(null);
-
-    /**
-     * 执行一次请求并维护 loading、data、error 状态。
-     */
-    const run = async (cfg: RequestConfig): Promise<ApiResponse<T>> => {
-      loading.value = true;
-      error.value = null;
-      try {
-        const res = await this.request<T>(cfg);
-        data.value = res.data as T;
-        return res;
-      } catch (e) {
-        error.value = e as Error;
-        throw e;
-      } finally {
-        loading.value = false;
-      }
-    };
-
-    /** 发起 GET 请求。 */
-    const get = (url: string, d?: unknown) => run({ url, method: 'GET', data: d });
-    /** 发起 POST 请求。 */
-    const post = (url: string, d?: unknown) => run({ url, method: 'POST', data: d });
-    /** 发起 PUT 请求。 */
-    const put = (url: string, d?: unknown) => run({ url, method: 'PUT', data: d });
-    /** 发起 DELETE 请求。 */
-    const del = (url: string, d?: unknown) => run({ url, method: 'DELETE', data: d });
-
-    return { loading, data, error, run, get, post, put, del };
-  }
-
-  /**
-   * 根据上传类型选择适配器并执行文件上传。
-   */
-  upload(config: UploadConfig): Promise<UploadResult> {
-    const fileName = config.fileName ?? config.filePath.split('/').pop() ?? 'file';
-
-    let server = config.server;
-    if (config.type === 'local' && config.url) server = config.url;
-
-    const formData = config.type === 'local'
-      ? (config.credentials ?? {})
-      : getAdapter(config.type).buildFormData({
-          filePath: config.filePath,
-          fileName,
-          credentials: config.credentials,
-        });
-
-    return new Promise((resolve, reject) => {
-      uni.uploadFile({
-        url: server,
-        filePath: config.filePath,
-        name: 'file',
-        formData: formData as unknown as UniNamespace.UploadFileOption['formData'],
-        header: config.header as Record<string, string>,
-        success: (res) => {
-          if (res.statusCode === 200) {
-            try {
-              const body = JSON.parse(res.data);
-              resolve({ code: body.code ?? 1, msg: body.message ?? '上传成功', data: body.data ?? '' });
-            } catch {
-              resolve({ code: 1, msg: '上传成功', data: res.data });
-            }
-          } else {
-            reject(new Error('上传失败'));
-          }
-        },
-        fail: (err) => reject(new Error(err.errMsg || '上传失败')),
-      });
-    });
-  }
-
-  /**
-   * 拼接 baseURL，并在开启防缓存时追加时间戳参数。
-   */
-  private _buildUrl(url: string): string {
-    if (/^https?:\/\//.test(url)) return url;
-    const full = `${this._baseURL}${url}`;
-    if (!this._noCache) return full;
-    const sep = full.includes('?') ? '&' : '?';
-    return `${full}${sep}_t=${Date.now()}`;
-  }
-
-  /**
-   * 调用 uni.request 发起底层网络请求。
-   */
-  private async _doRequest<T>(url: string, cfg: RequestConfig): Promise<ApiResponse<T>> {
-    return new Promise((resolve, reject) => {
-      uni.request({
-        url,
-        method: cfg.method,
-        data: cfg.data as UniNamespace.RequestOptions['data'],
-        header: cfg.headers as Record<string, string>,
-        success: (res) => {
-          if (res.statusCode >= 200 && res.statusCode < 300) {
-            resolve(res.data as ApiResponse<T>);
-          } else {
-            const msg = (res.data as Record<string, unknown>)?.info ?? `请求失败: ${res.statusCode}`;
-            reject(new Error(String(msg)));
-          }
-        },
-        fail: (err) => reject(new Error(err.errMsg || '网络请求失败')),
-      });
-    });
-  }
-
-  /**
-   * 顺序执行已注册的错误拦截器。
-   */
-  private async _applyErrorInterceptors(err: Error): Promise<void> {
-    for (const fn of this._errInterceptors) {
-      await fn(err);
-    }
-  }
-}
-
-/**
- * 全局 HTTP 实例。
- */
-export const http = new HttpClient();

package/src/composables/http/index.ts

@@ -1,8 +0,0 @@
-/**
- * HTTP 模块统一导出
- */
-export { http, HttpClient } from "./client";
-export { useRequest, useUpload } from "./useRequest";
-export type { ApiResponse, PageResult, RequestConfig, RequestInterceptor, ResponseInterceptor, ErrorInterceptor, UploadConfig, UploadResult } from "./types";
-export type { UseRequestReturn } from "./client";
-export * from "./adapters";

package/src/composables/http/useRequest.ts

@@ -1,107 +0,0 @@
-/**
- * useRequest - 组件内请求 composable
- */
-import { http } from './client';
-import type { RequestConfig, ApiResponse } from './types';
-import { ref } from 'vue';
-
-export interface UseRequestOptions<T = unknown> {
-  /** 初始数据 */
-  initialData?: T | null;
-  /** 手动触发，不自动请求 */
-  manual?: boolean;
-  /** 成功回调 */
-  onSuccess?: (data: T, res: ApiResponse<T>) => void;
-  /** 失败回调 */
-  onError?: (err: Error) => void;
-}
-
-/**
- * 创建带有 loading、data、error 状态的请求方法集。
- *
- * @example
- * const { loading, data, error, run } = useRequest<User>();
- * run({ url: '/user/info', method: 'GET' });
- */
-export function useRequest<T = unknown>(options: UseRequestOptions<T> = {}) {
-  const { initialData = null, manual = false, onSuccess, onError } = options;
-
-  const loading = ref(false);
-  const data = ref<T | null>(initialData);
-  const error = ref<Error | null>(null);
-
-  /**
-   * 执行一次自定义请求配置。
-   */
-  async function run(config: RequestConfig): Promise<ApiResponse<T>> {
-    loading.value = true;
-    error.value = null;
-    try {
-      const res = await http.request<T>(config);
-      data.value = res.data as T;
-      onSuccess?.(res.data as T, res);
-      return res;
-    } catch (e) {
-      error.value = e as Error;
-      onError?.(e as Error);
-      throw e;
-    } finally {
-      loading.value = false;
-    }
-  }
-
-  /**
-   * 发起 GET 请求。
-   */
-  function get(url: string, data?: unknown) {
-    return run({ url, method: 'GET', data });
-  }
-
-  /**
-   * 发起 POST 请求。
-   */
-  function post(url: string, data?: unknown) {
-    return run({ url, method: 'POST', data });
-  }
-
-  /**
-   * 发起 PUT 请求。
-   */
-  function put(url: string, data?: unknown) {
-    return run({ url, method: 'PUT', data });
-  }
-
-  /**
-   * 发起 DELETE 请求。
-   */
-  function del(url: string, data?: unknown) {
-    return run({ url, method: 'DELETE', data });
-  }
-
-  if (!manual) {
-    // 空配置时保持手动触发，避免误请求。
-  }
-
-  return { loading, data, error, run, get, post, put, del };
-}
-
-/**
- * 上传文件状态管理 composable。
- */
-export function useUpload() {
-  const uploading = ref(false);
-
-  /**
-   * 调用全局 http.upload 执行文件上传。
-   */
-  async function upload(options: Parameters<typeof http.upload>[0]) {
-    uploading.value = true;
-    try {
-      return await http.upload(options);
-    } finally {
-      uploading.value = false;
-    }
-  }
-
-  return { uploading, upload };
-}

package/src/composables/loading/index.ts

@@ -1,23 +0,0 @@
-/**
- * useLoading - 全局 Loading 状态
- */
-export function useLoading() {
-    /**
-     * 显示全局加载提示。
-     */
-    function showLoading(message = "加载中...") {
-        uni.showLoading({ title: message, mask: true });
-    }
-
-    /**
-     * 关闭全局加载提示。
-     */
-    function hideLoading() {
-        uni.hideLoading();
-    }
-
-    return {
-        showLoading,
-        hideLoading,
-    };
-}

package/src/composables/page-meta/index.ts

@@ -1,49 +0,0 @@
-/**
- * usePageMeta - 页面元信息 composable
- */
-export interface PageMeta {
-    title?: string;
-    navigationBarTitleText?: string;
-    navigationBarBackgroundColor?: string;
-    navigationBarTextStyle?: "white" | "black";
-    backgroundColor?: string;
-    enablePullDownRefresh?: boolean;
-}
-
-/**
- * 页面导航栏与背景元信息工具。
- */
-export function usePageMeta() {
-    /**
-     * 设置当前页面标题。
-     */
-    function setTitle(title: string) {
-        uni.setNavigationBarTitle({ title });
-    }
-
-    /**
-     * 批量设置页面标题、导航栏和背景样式。
-     */
-    function setOptions(options: PageMeta) {
-        if (options.title || options.navigationBarTitleText) {
-            setTitle(options.title || options.navigationBarTitleText!);
-        }
-        if (options.navigationBarBackgroundColor || options.navigationBarTextStyle) {
-            uni.setNavigationBarColor({
-                frontColor: options.navigationBarTextStyle === "white" ? "#ffffff" : "#000000",
-                backgroundColor: options.navigationBarBackgroundColor ?? "#ffffff",
-            });
-        }
-        if (options.backgroundColor) {
-            uni.setBackgroundColor({ backgroundColor: options.backgroundColor });
-        }
-        if (options.enablePullDownRefresh !== undefined) {
-            uni.setBackgroundTextStyle({ textStyle: "dark" });
-        }
-    }
-
-    return {
-        setTitle,
-        setOptions,
-    };
-}

package/src/composables/storage/index.ts

@@ -1,76 +0,0 @@
-/**
- * useStorage - 本地存储 composable
- */
-export interface StorageInstance {
-    get: <T = unknown>(key: string) => T | null;
-    set: <T>(key: string, value: T) => boolean;
-    remove: (key: string) => boolean;
-    clear: () => boolean;
-    info: () => UniApp.GetStorageInfoSuccess | null;
-}
-
-/**
- * 本地存储读写工具。
- */
-export function useStorage(): StorageInstance {
-    /**
-     * 读取指定 key 的缓存值。
-     */
-    function get<T = unknown>(key: string): T | null {
-        try {
-            const value = uni.getStorageSync(key);
-            return value ?? null;
-        } catch {
-            return null;
-        }
-    }
-
-    /**
-     * 写入指定 key 的缓存值。
-     */
-    function set<T>(key: string, value: T): boolean {
-        try {
-            uni.setStorageSync(key, value);
-            return true;
-        } catch {
-            return false;
-        }
-    }
-
-    /**
-     * 删除指定 key 的缓存值。
-     */
-    function remove(key: string): boolean {
-        try {
-            uni.removeStorageSync(key);
-            return true;
-        } catch {
-            return false;
-        }
-    }
-
-    /**
-     * 清空全部本地缓存。
-     */
-    function clear(): boolean {
-        try {
-            uni.clearStorageSync();
-            return true;
-        } catch {
-            return false;
-        }
-    }
-
-    /**
-     * 获取当前缓存使用信息。
-     */
-    function info(): UniApp.GetStorageInfoSuccess | null {
-        try {
-            return uni.getStorageInfoSync();
-        } catch {
-            return null;
-        }
-    }
-
-    return { get, set, remove, clear, info };
-}

package/src/composables/validate/index.ts

@@ -1,58 +0,0 @@
-/**
- * useValidate - 校验工具 composable
- */
-export function useValidate() {
-    /** 中国大陆手机号格式校验。 */
-    function phone(value: string): boolean {
-        return /^1[3-9]\d{9}$/.test(value);
-    }
-
-    /** 校验邮箱地址格式。 */
-    function email(value: string): boolean {
-        return /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/.test(value);
-    }
-
-    /** 校验是否为合法 URL。 */
-    function url(value: string): boolean {
-        try {
-            new URL(value);
-            return true;
-        } catch {
-            return false;
-        }
-    }
-
-    /** 18 位身份证号格式校验。 */
-    function idCard(value: string): boolean {
-        return /^[1-9]\d{5}(18|19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$/.test(value);
-    }
-
-    /** 普通民用车牌号格式校验。 */
-    function carNumber(value: string): boolean {
-        return /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z][A-Z0-9]{5}$/.test(value);
-    }
-
-    /** 至少 8 位且同时包含字母和数字的密码校验。 */
-    function password(value: string): boolean {
-        return /^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d]{8,}$/.test(value);
-    }
-
-    /** 判断值是否为空字符串、空数组、空对象或 null/undefined。 */
-    function empty(value: unknown): boolean {
-        if (value == null) return true;
-        if (typeof value === "string") return value.trim() === "";
-        if (Array.isArray(value)) return value.length === 0;
-        if (typeof value === "object") return Object.keys(value).length === 0;
-        return false;
-    }
-
-    return {
-        phone,
-        email,
-        url,
-        idCard,
-        carNumber,
-        password,
-        empty,
-    };
-}

package/src/error.ts

@@ -1,5 +0,0 @@
-export function getErrorMessage(error: unknown): string {
-    if (error instanceof Error && error.message) return error.message;
-    if (typeof error === "string" && error) return error;
-    return "查询失败，请稍后重试";
-}