rxtutils 1.1.1 → 1.1.2-beta.2

package/README.md

@@ -0,0 +1,404 @@
+# RUtils
+
+一个功能丰富的 TypeScript 工具库，提供缓存管理、HTTP 请求和状态管理等功能。
+
+## 📦 安装
+
+```bash
+npm install rxtutils
+# 或
+yarn add rxtutils
+# 或
+pnpm add rxtutils
+```
+
+## 🚀 功能特性
+
+- **缓存管理** - 支持内存、localStorage、sessionStorage 和 IndexedDB 多种存储方式
+- **HTTP 请求** - 基于 axios 的请求封装，支持错误处理和缓存
+- **状态管理** - 轻量级的状态管理解决方案，支持 React Hook
+- **TypeScript** - 完整的 TypeScript 类型支持
+
+## 📚 模块介绍
+
+### 1. 缓存管理 (Cache)
+
+提供灵活的缓存管理功能，支持多种存储方式。
+
+#### 基本用法
+
+```typescript
+import { Cache } from 'rxtutils';
+
+// 创建内存缓存
+const memoryCache = new Cache<string, any>();
+
+// 创建 localStorage 缓存
+const localCache = new Cache<string, any>('localStorage', 'myCache', 300);
+
+// 创建 IndexedDB 缓存
+const dbCache = new Cache<string, any>('indexedDB', 'dbCache', 600, 'myDatabase');
+```
+
+#### 缓存操作
+
+```typescript
+// 设置缓存
+cache.setCache('key1', { data: 'value1' });
+cache.setCache('key2', { data: 'value2' }, { cacheTime: 120 }); // 2分钟过期
+
+// 获取缓存
+const data = cache.getCache('key1');
+console.log(data); // { data: 'value1' }
+
+// 清空缓存
+cache.clear();
+```
+
+#### 高级配置
+
+```typescript
+import { Cache } from 'rxtutils';
+
+// 自定义比较函数
+const customCache = new Cache<{ id: number; name: string }, any>(
+  'localStorage',
+  'customCache',
+  300,
+  'customDB',
+  (prev, next) => prev.id === next.id // 只比较 id 字段
+);
+```
+
+### 2. HTTP 请求 (createBaseRequest)
+
+基于 axios 的请求封装，支持错误处理、缓存和自定义配置。
+
+#### 基本用法
+
+```typescript
+import { createBaseRequest } from 'rxtutils';
+
+// 创建请求实例
+const request = createBaseRequest({
+  baseURL: 'https://api.example.com',
+  throwError: true,
+  defaultMessageShower: (message) => console.log(message)
+});
+
+// 创建具体请求
+const getUserInfo = request<{ id: number }, { name: string; email: string }>({
+  method: 'GET',
+  url: '/user/:id'
+});
+
+// 发送请求
+const userInfo = await getUserInfo({ params: { id: 123 } });
+```
+
+#### 错误处理
+
+```typescript
+const request = createBaseRequest({
+  baseURL: 'https://api.example.com',
+  errorCodeMap: {
+    '400': '请求参数错误',
+    '401': '未授权，请重新登录',
+    '500': (code, data, res) => ({
+      replaceResData: { error: '服务器内部错误' },
+      throwError: false
+    })
+  },
+  httpErrorCodeMap: {
+    404: '资源不存在',
+    500: '服务器错误'
+  }
+});
+```
+
+#### 缓存功能
+
+```typescript
+const request = createBaseRequest({
+  baseURL: 'https://api.example.com',
+  enableCache: true,
+  cacheData: true,
+  cacheDataInStorage: 'localStorage',
+  cacheDataKey: 'api-cache',
+  cacheTime: 300
+});
+
+// 第一次请求会从服务器获取数据
+const data1 = await getUserInfo({ params: { id: 123 } });
+
+// 第二次请求会从缓存获取数据
+const data2 = await getUserInfo({ params: { id: 123 } });
+
+// 清空缓存
+getUserInfo.clearCache();
+```
+
+### 3. 状态管理 (createStateStore)
+
+轻量级的状态管理解决方案，支持组件间状态共享。
+
+#### 基本用法
+
+```typescript
+import { createStateStore } from 'rxtutils';
+
+// 创建状态存储
+const userStore = createStateStore({
+  name: '',
+  email: '',
+  isLoggedIn: false
+});
+
+// 在组件中使用
+function UserComponent() {
+  const [user, setUser] = userStore.use();
+  
+  const handleLogin = () => {
+    setUser({
+      name: 'John Doe',
+      email: 'john@example.com',
+      isLoggedIn: true
+    });
+  };
+  
+  return (
+    <div>
+      <p>用户名: {user.name}</p>
+      <p>邮箱: {user.email}</p>
+      <button onClick={handleLogin}>登录</button>
+    </div>
+  );
+}
+```
+
+#### 状态监听
+
+```typescript
+// 监听状态变化
+const unsubscribe = userStore.watch((state) => {
+  console.log('状态已更新:', state);
+});
+
+// 取消监听
+unsubscribe();
+```
+
+#### 直接访问和设置
+
+```typescript
+// 直接获取状态
+const currentUser = userStore.get();
+
+// 直接设置状态
+userStore.set({ name: 'Jane Doe', email: 'jane@example.com', isLoggedIn: true });
+```
+
+### 4. 状态计算器 (createStoreGetter)
+
+为状态存储提供计算属性和派生状态。
+
+#### 基本用法
+
+```typescript
+import { createStoreGetter, createStoreGetterMemo } from 'rxtutils';
+
+const userStore = createStateStore({
+  firstName: 'John',
+  lastName: 'Doe',
+  age: 30
+});
+
+// 创建 getter 函数
+const getters = {
+  fullName: (state) => `${state.firstName} ${state.lastName}`,
+  isAdult: (state) => state.age >= 18,
+  displayName: (state) => state.firstName
+};
+
+// 创建 getter 名称映射
+const getterNameMaps = {
+  fullName: 'fullName',
+  isAdult: 'isAdult',
+  displayName: 'displayName'
+};
+
+// 创建 getter 对象（非响应式）
+const userGetters = createStoreGetter(userStore, getters, getterNameMaps);
+console.log(userGetters.fullName); // "John Doe"
+
+// 创建 getter memo hook（响应式）
+const useUserGetters = createStoreGetterMemo(userStore, getters, getterNameMaps);
+
+function UserProfile() {
+  const { fullName, isAdult, displayName } = useUserGetters();
+  
+  return (
+    <div>
+      <h1>{fullName}</h1>
+      <p>成年人: {isAdult ? '是' : '否'}</p>
+      <p>显示名: {displayName}</p>
+    </div>
+  );
+}
+```
+
+## 🔧 配置选项
+
+### Cache 配置
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `storageType` | `'sessionStorage' \| 'localStorage' \| 'indexedDB'` | `undefined` | 存储类型 |
+| `cacheKey` | `string` | `undefined` | 缓存键名 |
+| `cacheTime` | `number` | `60` | 缓存时间（秒） |
+| `indexDBName` | `string` | `'__apiCacheDatabase__'` | IndexedDB 数据库名称 |
+| `cacheKeyEquals` | `function` | `defaultEquals` | 缓存键比较函数 |
+
+### Request 配置
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `baseURL` | `string` | `''` | 请求基础URL |
+| `throwError` | `boolean` | `true` | 是否抛出错误 |
+| `enableCache` | `boolean` | `false` | 是否启用缓存 |
+| `cacheData` | `boolean` | `false` | 是否缓存数据 |
+| `cacheTime` | `number` | `60` | 缓存时间（秒） |
+| `cacheDataInStorage` | `StorageType` | `undefined` | 缓存存储类型 |
+| `errorCodePath` | `string` | `'code'` | 错误码路径 |
+| `successCodes` | `string[]` | `['0', '200']` | 成功状态码 |
+
+## 📝 类型定义
+
+### 缓存相关类型
+
+```typescript
+// 缓存项接口
+interface ICache<Param, Data> {
+  params: Param;
+  data: Data;
+  expireTime: string;
+}
+
+// 缓存选项接口
+interface ICacheOptions<Param> {
+  storageType?: StorageType;
+  cacheKey?: string;
+  cacheTime?: number;
+  cacheKeyEquals: (prev: Param, next: Param) => boolean;
+  indexDBName?: string;
+}
+```
+
+### 请求相关类型
+
+```typescript
+// 请求配置接口
+interface Options<Params, Data> {
+  baseURL?: string;
+  throwError?: boolean;
+  enableCache?: boolean;
+  cacheData?: boolean;
+  cacheTime?: number;
+  errorCodeMap?: Record<string, string | Function>;
+  httpErrorCodeMap?: Record<string, string | Function>;
+  // ... 更多配置选项
+}
+
+// 请求参数接口
+interface RequestOptions<Param> {
+  method: Method;
+  url: string;
+  data?: Param;
+  params?: Param;
+}
+```
+
+### 状态管理相关类型
+
+```typescript
+// 状态存储接口
+interface StateStore<S> {
+  use: () => [S, (state: IHookStateSetAction<S>) => void];
+  get: () => S;
+  set: (state: IHookStateSetAction<S>) => void;
+  watch: (callback: (state: S) => void) => () => void;
+}
+
+// 状态设置动作类型
+type IHookStateSetAction<S> = S | IHookStateSetter<S>;
+```
+
+## 🎯 使用场景
+
+### 1. API 数据缓存
+
+```typescript
+// 创建带缓存的 API 请求
+const apiRequest = createBaseRequest({
+  baseURL: 'https://api.example.com',
+  enableCache: true,
+  cacheData: true,
+  cacheDataInStorage: 'localStorage',
+  cacheTime: 300
+});
+
+const getProductList = apiRequest<{ page: number }, { products: Product[] }>({
+  method: 'GET',
+  url: '/products'
+});
+```
+
+### 2. 用户状态管理
+
+```typescript
+// 创建用户状态存储
+const userStore = createStateStore({
+  user: null,
+  permissions: [],
+  theme: 'light'
+});
+
+// 创建用户相关的计算属性
+const userGetters = createStoreGetter(userStore, {
+  isLoggedIn: (state) => !!state.user,
+  canEdit: (state) => state.permissions.includes('edit'),
+  isDarkTheme: (state) => state.theme === 'dark'
+}, {
+  isLoggedIn: 'isLoggedIn',
+  canEdit: 'canEdit',
+  isDarkTheme: 'isDarkTheme'
+});
+```
+
+### 3. 表单数据缓存
+
+```typescript
+// 创建表单缓存
+const formCache = new Cache<string, FormData>('sessionStorage', 'form-cache', 1800);
+
+// 保存表单数据
+formCache.setCache('user-form', formData);
+
+// 恢复表单数据
+const savedData = formCache.getCache('user-form');
+```
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request 来帮助改进这个项目。
+
+## 📄 许可证
+
+MIT License
+
+## 🔗 相关链接
+
+- [TypeScript](https://www.typescriptlang.org/)
+- [React](https://reactjs.org/)
+- [Axios](https://axios-http.com/)
+- [IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API)

package/dist/cjs/index.cjs

@@ -2,10 +2,27 @@
 
 var index = require('./cache/index.cjs');
 var index$1 = require('./request/index.cjs');
-var index$2 = require('./createStateStore/index.cjs');
+var index$3 = require('./store/createGetter/index.cjs');
+var index$2 = require('./store/createStateStore/index.cjs');
+var validator = require('./validator/validator.cjs');
+var decorators = require('./validator/decorators.cjs');
 
 
 
 exports.Cache = index.default;
 exports.createBaseRequest = index$1;
+exports.createStoreGetter = index$3.createStoreGetter;
+exports.createStoreGetterMemo = index$3.createStoreGetterMemo;
 exports.createStateStore = index$2.default;
+exports.BaseValidator = validator.BaseValidator;
+exports.VArray = decorators.VArray;
+exports.VBoolean = decorators.VBoolean;
+exports.VEmail = decorators.VEmail;
+exports.VMax = decorators.VMax;
+exports.VMaxLength = decorators.VMaxLength;
+exports.VMin = decorators.VMin;
+exports.VMinLength = decorators.VMinLength;
+exports.VNumber = decorators.VNumber;
+exports.VPattern = decorators.VPattern;
+exports.VRequired = decorators.VRequired;
+exports.VString = decorators.VString;

package/dist/cjs/request/index.cjs

@@ -38,7 +38,7 @@ function createBaseRequest(baseOptions) {
             if (method.toLowerCase() === 'post') {
                 requestDataOrParams = data;
             }
-            var _d = tslib.__assign(tslib.__assign(tslib.__assign({}, baseOptions), createOptions), options).defaultMessageShower, defaultMessageShower = _d === void 0 ? alert : _d;
+            var _d = tslib.__assign(tslib.__assign(tslib.__assign({}, baseOptions), createOptions), options).defaultMessageShower, defaultMessageShower = _d === void 0 ? console.error : _d;
             var _e = tslib.__assign(tslib.__assign(tslib.__assign({}, baseOptions), createOptions), options), _f = _e.enableCache, enableCache = _f === void 0 ? false : _f, _g = _e.cacheData, cacheData = _g === void 0 ? false : _g, _h = _e.defaultErrorCodeHandler, defaultErrorCodeHandler = _h === void 0 ? defaultHandlers._defaultErrorCodeHandler.bind(null, defaultMessageShower) : _h, _j = _e.defaultHttpErrorCodeHandler, defaultHttpErrorCodeHandler = _j === void 0 ? defaultHandlers._defaultHttpErrorCodeHandler.bind(null, defaultMessageShower) : _j, _k = _e.otherErrorHandler, otherErrorHandler = _k === void 0 ? defaultHandlers._defaultOtherErrorCodeHandler.bind(null, defaultMessageShower) : _k, _l = _e.errorCodePath, errorCodePath = _l === void 0 ? 'code' : _l, _m = _e.cacheTime, cacheTime = _m === void 0 ? 60 : _m, _o = _e.errorCodeMap, errorCodeMap = _o === void 0 ? {} : _o, _p = _e.successCodes, successCodes = _p === void 0 ? ['0', '200'] : _p, _q = _e.httpErrorCodeMap, httpErrorCodeMap = _q === void 0 ? {} : _q, _r = _e.axiosOptions, axiosOptions = _r === void 0 ? {} : _r, _s = _e.throwError, throwError = _s === void 0 ? true : _s;
             if (enableCache) {
                 var cacheItem = cache.getCache(requestDataOrParams);

package/dist/cjs/store/createGetter/index.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var react = require('react');
+
+/**
+ * 创建 store getter
+ * @param store store实例
+ * @param getters getter函数
+ * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
+ * @returns getter object
+ */
+var createStoreGetter = function (store, getters, getterNameMaps) {
+    var gettersObj = {};
+    Object.keys(getters).forEach(function (key) {
+        Object.defineProperty(gettersObj, getterNameMaps[key], {
+            get: function () { return getters[key](store.get()); }
+        });
+    });
+    return gettersObj;
+};
+/**
+ *
+ * @param store store实例
+ * @param getters getter函数
+ * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
+ * @returns getter memo hook
+ */
+var createStoreGetterMemo = function (store, getters, getterNameMaps) {
+    // 创建缓存数据 hook
+    return function () {
+        var storeData = store.use()[0];
+        var reducedData = react.useMemo(function () {
+            return Object.keys(getters).reduce(function (acc, key) {
+                var mappedKey = getterNameMaps[key];
+                var getterValue = getters[key](storeData);
+                acc[mappedKey] = getterValue;
+                return acc;
+            }, {});
+        }, [storeData]);
+        return reducedData;
+    };
+};
+
+exports.createStoreGetter = createStoreGetter;
+exports.createStoreGetterMemo = createStoreGetterMemo;

package/dist/cjs/validator/decorators.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+var validator = require('./validator.cjs');
+
+function VRequired(noneVals) {
+    if (noneVals === void 0) { noneVals = [undefined]; }
+    return validator.BaseValidator.decoratorCreator(function (val) {
+        if (noneVals.includes(val)) {
+            return false;
+        }
+        return true;
+    });
+}
+var VString = validator.BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'string') {
+        return false;
+    }
+    return true;
+});
+var VNumber = validator.BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'number') {
+        return false;
+    }
+    return true;
+});
+var VArray = validator.BaseValidator.decoratorCreator(function (val) {
+    if (!Array.isArray(val)) {
+        return false;
+    }
+    return true;
+});
+// 常用校验装饰器
+var VBoolean = validator.BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'boolean') {
+        return false;
+    }
+    return true;
+});
+var VMin = function (min) {
+    return validator.BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'number' || val < min) {
+            return false;
+        }
+        return true;
+    });
+};
+var VMax = function (max) {
+    return validator.BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'number' || val > max) {
+            return false;
+        }
+        return true;
+    });
+};
+var VMinLength = function (minLen) {
+    return validator.BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'string' && !Array.isArray(val)) {
+            return false;
+        }
+        if (val.length < minLen) {
+            return false;
+        }
+        return true;
+    });
+};
+var VMaxLength = function (maxLen) {
+    return validator.BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'string' && !Array.isArray(val)) {
+            return false;
+        }
+        if (val.length > maxLen) {
+            return false;
+        }
+        return true;
+    });
+};
+var VEmail = validator.BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'string') {
+        return false;
+    }
+    // 简单邮箱正则
+    var emailReg = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailReg.test(val);
+});
+var VPattern = function (pattern) {
+    return validator.BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'string') {
+            return false;
+        }
+        return pattern.test(val);
+    });
+};
+
+exports.VArray = VArray;
+exports.VBoolean = VBoolean;
+exports.VEmail = VEmail;
+exports.VMax = VMax;
+exports.VMaxLength = VMaxLength;
+exports.VMin = VMin;
+exports.VMinLength = VMinLength;
+exports.VNumber = VNumber;
+exports.VPattern = VPattern;
+exports.VRequired = VRequired;
+exports.VString = VString;

package/dist/cjs/validator/validator.cjs

@@ -0,0 +1,124 @@
+'use strict';
+
+var tslib = require('tslib');
+
+var BaseValidator = /** @class */ (function () {
+    function BaseValidator() {
+        this.__keySymbol = Symbol('key-description');
+        this.__keySymbol = Symbol('key-description');
+        this[this.__keySymbol] = {};
+    }
+    BaseValidator.prototype.validate = function (itemKey, itemAll) {
+        if (itemAll === void 0) { itemAll = false; }
+        var validatorMap = this[this.__keySymbol];
+        var errors = [];
+        // 校验每个 key
+        var validators = validatorMap[itemKey];
+        if (!validators) {
+            return errors;
+        }
+        for (var _i = 0, validators_1 = validators; _i < validators_1.length; _i++) {
+            var validator = validators_1[_i];
+            var res = validator(this[itemKey]);
+            if (!res.status) {
+                errors.push(res);
+                if (!itemAll)
+                    break;
+            }
+        }
+        if (errors.length) {
+            return errors;
+        }
+        return null;
+    };
+    BaseValidator.prototype.validateAll = function (itemAll, everyItem, order) {
+        if (itemAll === void 0) { itemAll = false; }
+        if (everyItem === void 0) { everyItem = false; }
+        var validatorMap = this[this.__keySymbol];
+        var errors = [];
+        // 校验每个 key
+        var keys = order || Object.keys(validatorMap);
+        for (var _i = 0, keys_1 = keys; _i < keys_1.length; _i++) {
+            var key = keys_1[_i];
+            var value = this[key];
+            var fns = validatorMap[key];
+            // 校验每个校验项目
+            for (var _a = 0, fns_1 = fns; _a < fns_1.length; _a++) {
+                var fn = fns_1[_a];
+                var res = fn(value);
+                if (!res.status) {
+                    errors.push(res);
+                    if (!itemAll)
+                        break;
+                }
+            }
+            if (!everyItem) {
+                break;
+            }
+        }
+        if (errors.length) {
+            return errors;
+        }
+        return null;
+    };
+    BaseValidator.decoratorCreator = function (func) {
+        return function (message) {
+            if (message === void 0) { message = function (val, value, context) { return "".concat(String(context.name), "\u683C\u5F0F\u9519\u8BEF"); }; }
+            return function (value, context) {
+                context.addInitializer(function () {
+                    var validators = this[this.__keySymbol];
+                    if (!validators) {
+                        this[this.__keySymbol] = {};
+                        validators = this[this.__keySymbol];
+                    }
+                    var name = context.name;
+                    var validator = function (val) {
+                        var validateStatus = func(val, value, context);
+                        if (validateStatus) {
+                            return { status: true };
+                        }
+                        else {
+                            var msg = '';
+                            if (typeof message === 'function') {
+                                msg = message(val, value, context);
+                            }
+                            else {
+                                msg = message;
+                            }
+                            return { status: false, message: msg };
+                        }
+                    };
+                    if (validators[name]) {
+                        validators[name] = tslib.__spreadArray(tslib.__spreadArray([], validators[name], true), [validator], false);
+                    }
+                    else {
+                        validators[name] = [validator];
+                    }
+                });
+            };
+        };
+    };
+    return BaseValidator;
+}());
+// class User extends BaseValidator{
+//   @VString('名称必须为字符串')
+//   @(VRequired()('名称必须填写'))
+//   name?: string;
+//   @VNumber('年龄必须为数字')
+//   @(VRequired()('年龄必须填写'))
+//   age?: number;
+//   @VEmail('邮箱格式不正确')
+//   @(VRequired()('邮箱必须填写'))
+//   email?: string;
+//   @(VMinLength(6)('密码长度不能少于6位'))
+//   @(VRequired()('密码必须填写'))
+//   password?: string
+// }
+// const user = new User();
+// user.name = '张三'
+// user.email = ' asdfasdf'
+// user.password = '12345'
+// console.log(user)
+// console.log(user.validateAll(false,true,['password','age','email']));
+
+exports.BaseValidator = BaseValidator;

package/dist/es/index.mjs

@@ -1,3 +1,6 @@
 export { default as Cache } from './cache/index.mjs';
 export { default as createBaseRequest } from './request/index.mjs';
-export { default as createStateStore } from './createStateStore/index.mjs';
+export { createStoreGetter, createStoreGetterMemo } from './store/createGetter/index.mjs';
+export { default as createStateStore } from './store/createStateStore/index.mjs';
+export { BaseValidator } from './validator/validator.mjs';
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './validator/decorators.mjs';

package/dist/es/request/index.mjs

@@ -36,7 +36,7 @@ function createBaseRequest(baseOptions) {
             if (method.toLowerCase() === 'post') {
                 requestDataOrParams = data;
             }
-            var _d = __assign(__assign(__assign({}, baseOptions), createOptions), options).defaultMessageShower, defaultMessageShower = _d === void 0 ? alert : _d;
+            var _d = __assign(__assign(__assign({}, baseOptions), createOptions), options).defaultMessageShower, defaultMessageShower = _d === void 0 ? console.error : _d;
             var _e = __assign(__assign(__assign({}, baseOptions), createOptions), options), _f = _e.enableCache, enableCache = _f === void 0 ? false : _f, _g = _e.cacheData, cacheData = _g === void 0 ? false : _g, _h = _e.defaultErrorCodeHandler, defaultErrorCodeHandler = _h === void 0 ? _defaultErrorCodeHandler.bind(null, defaultMessageShower) : _h, _j = _e.defaultHttpErrorCodeHandler, defaultHttpErrorCodeHandler = _j === void 0 ? _defaultHttpErrorCodeHandler.bind(null, defaultMessageShower) : _j, _k = _e.otherErrorHandler, otherErrorHandler = _k === void 0 ? _defaultOtherErrorCodeHandler.bind(null, defaultMessageShower) : _k, _l = _e.errorCodePath, errorCodePath = _l === void 0 ? 'code' : _l, _m = _e.cacheTime, cacheTime = _m === void 0 ? 60 : _m, _o = _e.errorCodeMap, errorCodeMap = _o === void 0 ? {} : _o, _p = _e.successCodes, successCodes = _p === void 0 ? ['0', '200'] : _p, _q = _e.httpErrorCodeMap, httpErrorCodeMap = _q === void 0 ? {} : _q, _r = _e.axiosOptions, axiosOptions = _r === void 0 ? {} : _r, _s = _e.throwError, throwError = _s === void 0 ? true : _s;
             if (enableCache) {
                 var cacheItem = cache.getCache(requestDataOrParams);

package/dist/es/store/createGetter/index.mjs

@@ -0,0 +1,42 @@
+import { useMemo } from 'react';
+
+/**
+ * 创建 store getter
+ * @param store store实例
+ * @param getters getter函数
+ * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
+ * @returns getter object
+ */
+var createStoreGetter = function (store, getters, getterNameMaps) {
+    var gettersObj = {};
+    Object.keys(getters).forEach(function (key) {
+        Object.defineProperty(gettersObj, getterNameMaps[key], {
+            get: function () { return getters[key](store.get()); }
+        });
+    });
+    return gettersObj;
+};
+/**
+ *
+ * @param store store实例
+ * @param getters getter函数
+ * @param getterNameMaps 将 getter 函数和 getter 名称一一映射
+ * @returns getter memo hook
+ */
+var createStoreGetterMemo = function (store, getters, getterNameMaps) {
+    // 创建缓存数据 hook
+    return function () {
+        var storeData = store.use()[0];
+        var reducedData = useMemo(function () {
+            return Object.keys(getters).reduce(function (acc, key) {
+                var mappedKey = getterNameMaps[key];
+                var getterValue = getters[key](storeData);
+                acc[mappedKey] = getterValue;
+                return acc;
+            }, {});
+        }, [storeData]);
+        return reducedData;
+    };
+};
+
+export { createStoreGetter, createStoreGetterMemo };

package/dist/es/validator/decorators.mjs

@@ -0,0 +1,92 @@
+import { BaseValidator } from './validator.mjs';
+
+function VRequired(noneVals) {
+    if (noneVals === void 0) { noneVals = [undefined]; }
+    return BaseValidator.decoratorCreator(function (val) {
+        if (noneVals.includes(val)) {
+            return false;
+        }
+        return true;
+    });
+}
+var VString = BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'string') {
+        return false;
+    }
+    return true;
+});
+var VNumber = BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'number') {
+        return false;
+    }
+    return true;
+});
+var VArray = BaseValidator.decoratorCreator(function (val) {
+    if (!Array.isArray(val)) {
+        return false;
+    }
+    return true;
+});
+// 常用校验装饰器
+var VBoolean = BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'boolean') {
+        return false;
+    }
+    return true;
+});
+var VMin = function (min) {
+    return BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'number' || val < min) {
+            return false;
+        }
+        return true;
+    });
+};
+var VMax = function (max) {
+    return BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'number' || val > max) {
+            return false;
+        }
+        return true;
+    });
+};
+var VMinLength = function (minLen) {
+    return BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'string' && !Array.isArray(val)) {
+            return false;
+        }
+        if (val.length < minLen) {
+            return false;
+        }
+        return true;
+    });
+};
+var VMaxLength = function (maxLen) {
+    return BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'string' && !Array.isArray(val)) {
+            return false;
+        }
+        if (val.length > maxLen) {
+            return false;
+        }
+        return true;
+    });
+};
+var VEmail = BaseValidator.decoratorCreator(function (val) {
+    if (typeof val !== 'string') {
+        return false;
+    }
+    // 简单邮箱正则
+    var emailReg = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailReg.test(val);
+});
+var VPattern = function (pattern) {
+    return BaseValidator.decoratorCreator(function (val) {
+        if (typeof val !== 'string') {
+            return false;
+        }
+        return pattern.test(val);
+    });
+};
+
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString };

package/dist/es/validator/validator.mjs

@@ -0,0 +1,122 @@
+import { __spreadArray } from 'tslib';
+
+var BaseValidator = /** @class */ (function () {
+    function BaseValidator() {
+        this.__keySymbol = Symbol('key-description');
+        this.__keySymbol = Symbol('key-description');
+        this[this.__keySymbol] = {};
+    }
+    BaseValidator.prototype.validate = function (itemKey, itemAll) {
+        if (itemAll === void 0) { itemAll = false; }
+        var validatorMap = this[this.__keySymbol];
+        var errors = [];
+        // 校验每个 key
+        var validators = validatorMap[itemKey];
+        if (!validators) {
+            return errors;
+        }
+        for (var _i = 0, validators_1 = validators; _i < validators_1.length; _i++) {
+            var validator = validators_1[_i];
+            var res = validator(this[itemKey]);
+            if (!res.status) {
+                errors.push(res);
+                if (!itemAll)
+                    break;
+            }
+        }
+        if (errors.length) {
+            return errors;
+        }
+        return null;
+    };
+    BaseValidator.prototype.validateAll = function (itemAll, everyItem, order) {
+        if (itemAll === void 0) { itemAll = false; }
+        if (everyItem === void 0) { everyItem = false; }
+        var validatorMap = this[this.__keySymbol];
+        var errors = [];
+        // 校验每个 key
+        var keys = order || Object.keys(validatorMap);
+        for (var _i = 0, keys_1 = keys; _i < keys_1.length; _i++) {
+            var key = keys_1[_i];
+            var value = this[key];
+            var fns = validatorMap[key];
+            // 校验每个校验项目
+            for (var _a = 0, fns_1 = fns; _a < fns_1.length; _a++) {
+                var fn = fns_1[_a];
+                var res = fn(value);
+                if (!res.status) {
+                    errors.push(res);
+                    if (!itemAll)
+                        break;
+                }
+            }
+            if (!everyItem) {
+                break;
+            }
+        }
+        if (errors.length) {
+            return errors;
+        }
+        return null;
+    };
+    BaseValidator.decoratorCreator = function (func) {
+        return function (message) {
+            if (message === void 0) { message = function (val, value, context) { return "".concat(String(context.name), "\u683C\u5F0F\u9519\u8BEF"); }; }
+            return function (value, context) {
+                context.addInitializer(function () {
+                    var validators = this[this.__keySymbol];
+                    if (!validators) {
+                        this[this.__keySymbol] = {};
+                        validators = this[this.__keySymbol];
+                    }
+                    var name = context.name;
+                    var validator = function (val) {
+                        var validateStatus = func(val, value, context);
+                        if (validateStatus) {
+                            return { status: true };
+                        }
+                        else {
+                            var msg = '';
+                            if (typeof message === 'function') {
+                                msg = message(val, value, context);
+                            }
+                            else {
+                                msg = message;
+                            }
+                            return { status: false, message: msg };
+                        }
+                    };
+                    if (validators[name]) {
+                        validators[name] = __spreadArray(__spreadArray([], validators[name], true), [validator], false);
+                    }
+                    else {
+                        validators[name] = [validator];
+                    }
+                });
+            };
+        };
+    };
+    return BaseValidator;
+}());
+// class User extends BaseValidator{
+//   @VString('名称必须为字符串')
+//   @(VRequired()('名称必须填写'))
+//   name?: string;
+//   @VNumber('年龄必须为数字')
+//   @(VRequired()('年龄必须填写'))
+//   age?: number;
+//   @VEmail('邮箱格式不正确')
+//   @(VRequired()('邮箱必须填写'))
+//   email?: string;
+//   @(VMinLength(6)('密码长度不能少于6位'))
+//   @(VRequired()('密码必须填写'))
+//   password?: string
+// }
+// const user = new User();
+// user.name = '张三'
+// user.email = ' asdfasdf'
+// user.password = '12345'
+// console.log(user)
+// console.log(user.validateAll(false,true,['password','age','email']));
+
+export { BaseValidator };

package/dist/types/index.d.ts

@@ -1,4 +1,7 @@
 export { default as Cache, ICache, ICacheOptions, StorageMap, StorageType } from './cache/index.js';
 export { ErrorHandlerReturnType, Options, RequestOptions, default as createBaseRequest } from './request/index.js';
-export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './createStateStore/index.js';
+export { createStoreGetter, createStoreGetterMemo } from './store/createGetter/index.js';
+export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './store/createStateStore/index.js';
+export { BaseValidator } from './validator/validator.js';
+export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './validator/decorators.js';
 export { default as RequestError, RequestErrorType } from './request/error.js';

package/dist/types/store/createGetter/index.d.ts

@@ -0,0 +1,30 @@
+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/dist/types/validator/decorators.d.ts

@@ -0,0 +1,15 @@
+import { BaseValidator } from './validator.js';
+
+declare function VRequired(noneVals?: any[]): (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VString: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VNumber: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VArray: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VBoolean: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VMin: (min: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VMax: (max: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VMinLength: (minLen: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VMaxLength: (maxLen: number) => (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+declare const VEmail: (message?: ((val: any, value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => string) | string) => (value: undefined, context: ClassFieldDecoratorContext<BaseValidator>) => void;
+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/dist/types/validator/validator.d.ts

@@ -0,0 +1,24 @@
+type Validator = (val: any) => {
+    status: boolean;
+    message?: string;
+};
+type ValidatorMap = {
+    [key: string]: Validator[];
+};
+declare class BaseValidator {
+    private __keySymbol;
+    [key: symbol]: ValidatorMap;
+    [key: string]: any;
+    constructor();
+    validate(itemKey: string, itemAll?: boolean): {
+        status: boolean;
+        message?: string;
+    }[];
+    validateAll(itemAll?: boolean, everyItem?: boolean, order?: string[]): {
+        status: boolean;
+        message?: string;
+    }[];
+    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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rxtutils",
-  "version": "1.1.1",
+  "version": "1.1.2-beta.2",
   "type": "module",
   "main": "dist/cjs/index.cjs",
   "module": "dist/es/index.mjs",
@@ -16,6 +16,7 @@
     "@rollup/plugin-typescript": "^12.1.2",
     "@types/lodash": "^4.17.17",
     "@types/node": "^22.15.29",
+    "@types/react": "^19.1.12",
     "rollup": "^4.41.1",
     "rollup-plugin-dts": "^6.2.1",
     "typescript": "^5.8.3",
@@ -25,9 +26,9 @@
     "react": "^19.1.0"
   },
   "dependencies": {
-    "tslib": "^2.8.1",
     "axios": "^1.9.0",
     "lodash": "^4.17.21",
-    "moment": "^2.30.1"
+    "moment": "^2.30.1",
+    "tslib": "^2.8.1"
   }
 }