rxtutils 1.1.4-beta.9 → 1.1.6

package/cjs/request/error.d.ts

@@ -1,31 +0,0 @@
-/**
- * 请求错误类型
- * - server: 服务端业务错误
- * - http: HTTP 网络错误
- */
-type RequestErrorType = 'server' | 'http';
-/**
- * 请求错误类
- * 用于统一处理请求过程中的各种错误
- *
- * @template Data 错误数据类型
- * @extends Error
- */
-declare class RequestError<Data = any> extends Error {
-    /** 错误码 */
-    code: string;
-    /** 错误类型 */
-    type: RequestErrorType;
-    /** 错误相关的数据 */
-    data?: Data;
-    /**
-     * 构造函数
-     * @param message 错误消息
-     * @param type 错误类型
-     * @param data 错误相关的数据
-     */
-    constructor(message: string, type: RequestErrorType, data?: Data);
-}
-
-export { RequestError as default };
-export type { RequestErrorType };

package/cjs/request/index.d.ts

@@ -1,147 +0,0 @@
-import { AxiosResponse, Method, AxiosRequestConfig } from 'axios';
-import { StorageType } from '../cache/index.js';
-export { default as RequestError, RequestErrorType } from './error.js';
-
-/**
- * 错误处理器返回类型
- * @template D 响应数据类型
- */
-type ErrorHandlerReturnType<D> = {
-    /** 替换响应数据 */
-    replaceResData?: D;
-    /**
-     * 是否抛出错误
-     * - true: 强制抛出错误
-     * - false: 不抛出错误
-     * - 'default': 使用默认错误处理逻辑
-     */
-    throwError?: boolean | "default";
-};
-/**
- * 请求配置选项接口
- * @template Params 请求参数类型
- * @template Data 响应数据类型
- */
-interface Options<Params = any, Data = any> {
-    /** 请求基础URL，默认为空字符串 */
-    baseURL?: string;
-    /**
-     * 是否抛出错误
-     * @default true
-     */
-    throwError?: boolean;
-    /**
-     * 默认的消息展示函数
-     * @default window.alert
-     */
-    defaultMessageShower?: (message: string) => void;
-    /**
-     * 是否启用缓存功能
-     * @default false
-     */
-    enableCache?: boolean;
-    /**
-     * 缓存键比较函数
-     * @default defaultEquals 使用 JSON.stringify 进行比较
-     */
-    cacheKeyEquals?: (prev: Params, next: Params) => boolean;
-    /**
-     * 是否将响应数据存入缓存
-     * @default false
-     */
-    cacheData?: boolean;
-    /**
-     * 缓存时间（秒）
-     * @default 60
-     */
-    cacheTime?: number;
-    /**
-     * 缓存数据的存储类型
-     * - localStorage: 使用浏览器本地存储，数据永久保存
-     * - sessionStorage: 使用会话存储，关闭浏览器后清除
-     * - indexedDB: 使用 IndexedDB 数据库存储
-     * - 不填则仅在内存中缓存，页面刷新后清除
-     */
-    cacheDataInStorage?: StorageType;
-    /**
-     * 缓存数据的键名
-     * @default `${method}:${baseURL}${url}` 默认使用请求方法、基础URL和请求路径组合
-     */
-    cacheDataKey?: string;
-    /**
-     * IndexedDB 数据库名称
-     * @default '__apiCacheDatabase__'
-     */
-    indexDBName?: string;
-    /**
-     * 错误码在响应数据中的路径
-     * @default 'code'
-     */
-    errorCodePath?: string;
-    /**
-     * 错误码映射表
-     * 可以配置错误码对应的错误信息或处理函数
-     * @default {} 空对象，使用默认处理函数
-     */
-    errorCodeMap?: Record<string, string | ((code: string, data: Data, res: AxiosResponse<Data>, requestParam: RequestOptions<Params>) => ErrorHandlerReturnType<Data> | void)>;
-    /**
-     * 默认错误码处理函数
-     * 当错误码不在 errorCodeMap 中时调用
-     */
-    defaultErrorCodeHandler?: (code: string, data: Data, res: AxiosResponse<Data>) => Promise<ErrorHandlerReturnType<Data> | void>;
-    /**
-     * 成功状态的错误码列表
-     * @default ['0', '200']
-     */
-    successCodes?: string[];
-    /**
-     * HTTP 错误码映射表
-     * 可以配置 HTTP 状态码对应的错误信息或处理函数
-     * @default {} 空对象，使用默认处理函数
-     */
-    httpErrorCodeMap?: Record<string, string | ((code: number, res: AxiosResponse<Data>, requestParam: RequestOptions<Params>) => Promise<ErrorHandlerReturnType<Data> | void>)>;
-    /**
-     * 默认 HTTP 错误码处理函数
-     * 当 HTTP 状态码不在 httpErrorCodeMap 中时调用
-     */
-    defaultHttpErrorCodeHandler?: (code: number, error: any) => Promise<ErrorHandlerReturnType<Data> | void>;
-    /**
-     * 其他错误处理函数
-     * 处理非 HTTP 错误和非业务错误码的错误
-     */
-    otherErrorHandler?: (error: any) => Promise<ErrorHandlerReturnType<Data> | void>;
-    axiosOptions?: Omit<AxiosRequestConfig<Params>, "method" | "url" | "params" | "data">;
-    requestMiddlewares?: ((options: Options<Params, Data>, requestOptions: RequestOptions<Params>) => Promise<{
-        axiosOptions?: Options<Params, Data>["axiosOptions"];
-        requestOptions?: RequestOptions<Params>;
-    }> | {
-        axiosOptions: Options<Params, Data>["axiosOptions"];
-        requestOptions?: RequestOptions<Params>;
-    })[];
-}
-/**
- * 请求参数接口
- * @template Param 请求参数类型
- */
-interface RequestOptions<Param> {
-    /** HTTP 请求方法 */
-    method: Method;
-    /** 请求URL */
-    url: string;
-    /** POST/PUT 等请求的数据 */
-    data?: Param;
-    /** URL 查询参数 */
-    params?: Param;
-}
-/**
- * 创建基础请求实例
- * @param baseOptions 基础配置选项
- * @returns 请求创建函数
- */
-declare function createBaseRequest(baseOptions?: Options): <Param, Data extends Record<any, any>>(requestOptions: RequestOptions<Param>, createOptions?: Omit<Options<Param, Data>, "baseURL">) => {
-    (requestParam?: Omit<RequestOptions<Param>, "url" | "method">, options?: Omit<Options<Param, Data>, "baseURL" | "cacheDataKey" | "cacheDataInStorage" | "cacheKeyEquals">): Promise<Data>;
-    clearCache(): void;
-};
-
-export { createBaseRequest as default };
-export type { ErrorHandlerReturnType, Options, RequestOptions };

package/cjs/store/createGetter/index.d.ts

@@ -1,30 +0,0 @@
-import createStateStore from '../createStateStore/index.js';
-
-type StoreGetter<S = any> = {
-    [K in string]: (store: S) => any;
-};
-type GetterNameMap<G extends StoreGetter<any>> = {
-    [K in keyof G]: string;
-};
-type ReducedData<G extends StoreGetter<any>, M extends GetterNameMap<G>> = {
-    [K in keyof M as M[K]]: G[K extends keyof G ? K : never] extends (store: any) => infer R ? R : never;
-};
-/**
- * 创建 store getter
- * @param store store实例
- * @param getters getter函数
- * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
- * @returns getter object
- */
-declare const createStoreGetter: <S, G extends StoreGetter<S>, M extends GetterNameMap<G>>(store: ReturnType<typeof createStateStore<S>>, getters: G, getterNameMaps: M) => ReducedData<G, M>;
-/**
- *
- * @param store store实例
- * @param getters getter函数
- * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
- * @returns getter memo hook
- */
-declare const createStoreGetterMemo: <S, G extends StoreGetter<S>, M extends GetterNameMap<G>>(store: ReturnType<typeof createStateStore<S>>, getters: G, getterNameMaps: M) => () => ReducedData<G, M>;
-
-export { createStoreGetter, createStoreGetterMemo };
-export type { GetterNameMap, ReducedData, StoreGetter };

package/cjs/store/createStateStore/index.d.ts

@@ -1,42 +0,0 @@
-/**
- * 状态初始化设置器类型
- * 用于延迟初始化状态的函数类型
- */
-type IHookStateInitialSetter<S> = () => S;
-/**
- * 状态初始化动作类型
- * 可以是直接的状态值或初始化设置器
- */
-type IHookStateInitAction<S> = S | IHookStateInitialSetter<S>;
-/**
- * 状态设置器类型
- * 可以是接收前一个状态的函数或无参数的函数
- */
-type IHookStateSetter<S> = ((prevState: S) => S) | (() => S);
-/**
- * 状态设置动作类型
- * 可以是直接的状态值或状态设置器
- */
-type IHookStateSetAction<S> = S | IHookStateSetter<S>;
-/**
- * 可解析的状态类型
- * 包含所有可能的状态值或状态设置函数
- */
-type IHookStateResolvable<S> = S | IHookStateInitialSetter<S> | IHookStateSetter<S>;
-/**
- * 创建状态存储
- * 提供一个简单的状态管理解决方案，支持组件间状态共享
- *
- * @template S 状态类型
- * @param initialState 初始状态值或初始化函数
- * @returns 包含状态操作方法的对象
- */
-declare function createStateStore<S>(initialState?: S): {
-    use: () => [S, (state: IHookStateSetAction<S>) => void];
-    get: () => S;
-    set: (state: IHookStateSetAction<S>) => void;
-    watch: (callback: (state: S) => S | void) => () => void;
-};
-
-export { createStateStore as default };
-export type { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter };

package/cjs/store/index.d.ts

@@ -1,2 +0,0 @@
-export { GetterNameMap, ReducedData, StoreGetter, createStoreGetter, createStoreGetterMemo } from './createGetter/index.js';
-export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './createStateStore/index.js';

package/cjs/validator/decorators.d.ts

@@ -1,159 +0,0 @@
-import { BaseValidator } from './validator.js';
-
-/**
- * 验证器装饰器模块
- * 提供一系列用于数据验证的装饰器，可用于类属性的验证规则定义
- * 这些装饰器基于 BaseValidator 的 decoratorCreator 方法创建
- */
-
-/**
- * 必填项验证装饰器
- * 验证值是否存在且不在指定的无效值列表中
- *
- * @param noneVals 被视为无效的值数组，默认为 [undefined]
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @(VRequired()('用户名不能为空'))
- *   username?: string;
- * }
- */
-declare function VRequired(noneVals?: any[]): (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 字符串类型验证装饰器
- * 验证值是否为字符串类型
- *
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @VString('用户名必须为字符串')
- *   username?: string;
- * }
- */
-declare const VString: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 数字类型验证装饰器
- * 验证值是否为数字类型
- *
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @VNumber('年龄必须为数字')
- *   age?: number;
- * }
- */
-declare const VNumber: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 数组类型验证装饰器
- * 验证值是否为数组类型
- *
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @VArray('标签必须为数组')
- *   tags?: string[];
- * }
- */
-declare const VArray: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 布尔类型验证装饰器
- * 验证值是否为布尔类型
- *
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @VBoolean('状态必须为布尔值')
- *   active?: boolean;
- * }
- */
-declare const VBoolean: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 最小值验证装饰器
- * 验证数字是否大于或等于指定的最小值
- *
- * @param min 最小值
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @(VMin(18)('年龄必须大于或等于18岁'))
- *   age?: number;
- * }
- */
-declare const VMin: (min: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 最大值验证装饰器
- * 验证数字是否小于或等于指定的最大值
- *
- * @param max 最大值
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @(VMax(120)('年龄必须小于或等于120岁'))
- *   age?: number;
- * }
- */
-declare const VMax: (max: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 最小长度验证装饰器
- * 验证字符串或数组的长度是否大于或等于指定的最小长度
- *
- * @param minLen 最小长度
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @(VMinLength(6)('密码长度不能少于6位'))
- *   password?: string;
- * }
- */
-declare const VMinLength: (minLen: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 最大长度验证装饰器
- * 验证字符串或数组的长度是否小于或等于指定的最大长度
- *
- * @param maxLen 最大长度
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @(VMaxLength(20)('用户名长度不能超过20位'))
- *   username?: string;
- * }
- */
-declare const VMaxLength: (maxLen: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 邮箱格式验证装饰器
- * 验证字符串是否符合邮箱格式
- *
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @VEmail('邮箱格式不正确')
- *   email?: string;
- * }
- */
-declare const VEmail: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-/**
- * 正则表达式验证装饰器
- * 验证字符串是否匹配指定的正则表达式模式
- *
- * @param pattern 正则表达式
- * @returns 装饰器工厂函数，可接收自定义错误消息
- *
- * @example
- * class User extends BaseValidator {
- *   @(VPattern(/^1[3-9]\d{9}$/)('手机号格式不正确'))
- *   phone?: string;
- * }
- */
-declare const VPattern: (pattern: RegExp) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-
-export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString };

package/cjs/validator/index.d.ts

@@ -1,2 +0,0 @@
-export { BaseValidator } from './validator.js';
-export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './decorators.js';

package/cjs/validator/validator.d.ts

@@ -1,84 +0,0 @@
-/**
- * 验证器函数类型，接收任意值并返回验证结果
- * @param val 需要验证的值
- * @returns 包含验证状态和可选错误消息的对象
- */
-type Validator = (val: any) => {
-    name: string;
-    status: boolean;
-    message?: string;
-};
-/**
- * 验证器映射类型，用于存储字段名到验证器数组的映射
- */
-type ValidatorMap = {
-    [key: string]: Validator[];
-};
-/**
- * 基础验证器类
- * 提供字段验证功能，可通过装饰器为类属性添加验证规则
- */
-declare class BaseValidator {
-    /** 用于存储验证器映射的私有符号 */
-    private __keySymbol;
-    /** 用于存储验证器映射的索引签名 */
-    [key: symbol]: ValidatorMap;
-    /** 用于存储类属性的索引签名 */
-    [key: string]: any;
-    /**
-     * 构造函数
-     * 初始化验证器映射存储
-     */
-    constructor();
-    /**
-     * 验证单个字段
-     * @param itemAll 是否验证所有规则，为true时会验证该字段的所有规则，为false时遇到第一个失败的规则就停止
-     * @param itemKey 要验证的字段名
-     * @returns 验证错误数组，如果没有错误则返回null
-     */
-    validate(itemKey: string, itemAll?: boolean): string[] | null;
-    /**
-     * 验证多个或所有字段
-     * @param order 验证字段的顺序，可以指定验证的字段名数组及其顺序
-     * @param itemAll 是否验证每个字段的所有规则，为true时会验证字段的所有规则，为false时遇到第一个失败的规则就停止
-     * @param everyItem 是否验证所有字段，为true时会验证所有字段，为false时遇到第一个失败的字段就停止
-     * @returns 验证错误数组，如果没有错误则返回null
-     */
-    validateAll(order?: string[], itemAll?: boolean, everyItem?: boolean): Record<string, string[]> | null;
-    /**
-     * 装饰器创建器
-     * 用于创建属性验证装饰器的工厂函数
-     *
-     * @param func 验证函数，接收属性值并返回布尔值表示验证结果
-     * @returns 返回一个接收错误消息的函数，该函数再返回实际的装饰器
-     *
-     * @example
-     * // 创建一个验证字符串的装饰器
-     * const VString = BaseValidator.decoratorCreator(
-     *   (val) => typeof val === 'string' || val === undefined
-     * );
-     *
-     * // 创建一个验证必填项的装饰器
-     * const VRequired = BaseValidator.decoratorCreator(
-     *   (val) => val !== undefined && val !== null && val !== ''
-     * );
-     *
-     * // 在类中使用这些装饰器
-     * class User extends BaseValidator {
-     *   @VString('名称必须为字符串')
-     *   @(VRequired()('名称必须填写'))
-     *   name?: string;
-     *
-     *   // 验证使用
-     *   validateName() {
-     *     return this.validate('name');
-     *   }
-     * }
-     *
-     * const user = new User();
-     * console.log(user.validateName()); // 显示错误信息：名称必须填写
-     */
-    static decoratorCreator: (func: (val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => boolean) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
-}
-
-export { BaseValidator };

package/es/_utils/deepAssign.mjs

@@ -1,23 +0,0 @@
-function deepAssign(target) {
-    var sources = [];
-    for (var _i = 1; _i < arguments.length; _i++) {
-        sources[_i - 1] = arguments[_i];
-    }
-    for (var _a = 0, sources_1 = sources; _a < sources_1.length; _a++) {
-        var source = sources_1[_a];
-        for (var key in source) {
-            var val = source[key];
-            if (val &&
-                typeof val === 'object' &&
-                !Array.isArray(val)) {
-                target[key] = deepAssign(target[key] || {}, val);
-            }
-            else {
-                target[key] = val;
-            }
-        }
-    }
-    return target;
-}
-
-export { deepAssign };