@qimen-lab/core 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Dengqiao Huang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# QimenJS
+
+> 现代化 TypeScript 基础设施库 — 奇门遁甲，排兵布阵
+
+QimenJS 是一个模块化的 TypeScript 基础设施库，提供事件系统、数据管道、实体管理、国际化、HTTP 客户端等 27 个独立子包，覆盖前端应用的基础层到服务层。
+
+名字取自"奇门遁甲"——古代排兵布阵的术数体系。正如奇门以八门九星组合千变万化的格局，QimenJS 通过能力组合（Ability）和数据管道（Pipeline）构建灵活的前端架构。
+
+## 状态
+
+**0.1.1** — 初始开发阶段，核心 API 已可用，UI 组件层尚未实现。API 可能在后续版本中发生变化。
+
+## 快速开始
+
+```bash
+# 安装
+pnpm install
+
+# 构建
+npm run build
+
+# 运行完整 Demo（前端 + 后端）
+cd examples/full-stack
+npm start
+```
+
+或使用 GitHub Codespaces 一键启动完整演示环境。
+
+## 包列表
+
+### 基础层 (Layer 0)
+
+| 包 | 说明 |
+|---|------|
+| `@qimen-lab/error` | 统一错误体系，错误码 + 错误链 |
+| `@qimen-lab/logger` | 日志系统，多级别 + 多输出 |
+| `@qimen-lab/utils` | 通用工具函数 |
+| `@qimen-lab/async` | 异步工具（重试、并发控制、超时） |
+| `@qimen-lab/runtime` | 运行时环境检测 |
+| `@qimen-lab/crypto` | 哈希与编解码（MD5/SHA/XXHash/Base64） |
+| `@qimen-lab/i18n` | 国际化，loadScript 动态加载语言包 |
+| `@qimen-lab/context` | 请求上下文，贯穿数据处理管道 |
+
+### 核心层 (Layer 1)
+
+| 包 | 说明 |
+|---|------|
+| `@qimen-lab/registry` | 注册表，领域隔离的注册中心 |
+| `@qimen-lab/events` | 事件总线，发布/订阅 |
+| `@qimen-lab/cache` | 缓存管理，LRU + TTL |
+| `@qimen-lab/pipeline` | 数据管道，可组合的处理链 |
+| `@qimen-lab/composable` | 能力组合，定义可复用的能力描述符 |
+| `@qimen-lab/task` | 任务调度，队列 + 优先级 |
+| `@qimen-lab/schema` | Schema 定义，字段 + 验证规则 |
+
+### 数据层 (Layer 2)
+
+| 包 | 说明 |
+|---|------|
+| `@qimen-lab/data-processor` | 数据处理器框架，管道式请求/响应处理 |
+| `@qimen-lab/validation` | 验证引擎，规则 + 链式验证 |
+| `@qimen-lab/event-dom` | DOM 事件适配，手势识别 |
+| `@qimen-lab/mime` | MIME 类型解析 |
+| `@qimen-lab/pattern` | 设计模式工具（观察者、策略、工厂等） |
+
+### 服务层 (Layer 3)
+
+| 包 | 说明 |
+|---|------|
+| `@qimen-lab/http` | HTTP 客户端，拦截器 + 重试 + 缓存 |
+| `@qimen-lab/oauth2` | OAuth2 认证，授权码/密码/客户端模式 |
+| `@qimen-lab/data-processor-abp` | ABP 框架数据处理器，分页/过滤/排序参数转换 |
+| `@qimen-lab/data-processor-spring` | Spring Data 数据处理器，Page\<T\> 格式适配 |
+| `@qimen-lab/system-abilities` | 系统能力集，搜索/分页/CRUD 能力定义 |
+
+### 应用层 (Layer 4)
+
+| 包 | 说明 |
+|---|------|
+| `@qimen-lab/entity` | 实体管理框架，Manager + Ability 架构 |
+| `@qimen-lab/types` | 公共类型定义 |
+
+## 架构特点
+
+- **分层设计** — 从基础层到应用层，依赖方向单一，不跨层引用
+- **能力组合** — 实体管理器通过 AbilityDefinition 动态组合能力，按需装配
+- **管道式处理** — 数据请求/响应通过可插拔的处理器管道，ABP/Spring 开箱即用
+- **环境适配** — 核心包环境无关，浏览器/Node.js 通用；特定功能包环境专用
+- **类型安全** — 完整的 TypeScript 类型定义
+
+## 示例
+
+`examples/full-stack/` 包含完整的全栈演示：
+
+- OAuth2 认证（密码模式 + 授权码模式 + 客户端凭证）
+- ABP API 用户管理（分页、搜索、排序）
+- Spring Data 订单管理（Page\<T\> 分页）
+- 27 个 QimenJS 子包的功能演示页面
+- 国际化（i18n 预编译 + 动态语言切换）
+
+## 文档
+
+- [架构说明](./docs/architecture/README.md)
+- [包说明](./docs/architecture/packages/)
+- [最佳实践](./docs/best-practices/)
+- [API 参考](./docs/api/)
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 构建
+npm run build
+
+# 运行测试
+npm run test
+
+# 代码检查
+npm run lint
+
+# 生成 API 文档
+npm run docs
+```
+
+## 版本
+
+当前版本：**0.1.1** — 详见 [VERSION](./VERSION) 文件和 [CHANGELOG](./CHANGELOG.md)。
+
+版本号遵循 [SemVer](https://semver.org/lang/zh-CN/) 规范。`0.x.x` 表示初始开发阶段，API 不保证稳定。
+
+## AI 辅助开发声明
+
+**本项目是 AI 辅助开发的项目，大部分代码由 AI 生成。**
+
+感谢以下 AI 工具的贡献：
+
+- **华为 CodeArts** — 完成了项目的大部分代码，是本项目的主力开发工具
+- ChatGPT — 架构设计和代码审查
+- DeepSeek — 代码生成和优化
+- Gemini — 文档和测试辅助
+- 通义千问 — 代码审查和优化建议
+- FitEncode — 代码生成辅助
+
+特别感谢 **华为 CodeArts**，本项目的绝大部分代码是在 CodeArts 智能体的辅助下完成的，从架构设计到代码实现，从 Bug 修复到文档编写，CodeArts 都发挥了关键作用。
+
+## License
+
+MIT

package/dist/async/debounce.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 防抖函数 - 在指定时间 wait 内，如果函数被多次调用，则只执行最后一次调用
+ * 如果设置了 immediate 为 true，则会在延时之前立即执行
+ *
+ * @description
+ * 防抖是一种函数调用技术，它确保函数在指定的等待时间内不被重复执行。
+ * 如果在等待期间再次调用函数，则会重新开始计时。
+ *
+ * @template T - 函数类型
+ * @param fn - 需要防抖的函数
+ * @param wait - 延迟时间（毫秒）
+ * @param immediate - 是否立即执行（true 为立即执行，false 为延迟后执行）
+ * @returns 返回处理后的函数，该函数接收与原函数相同的参数
+ *
+ * @example
+ * ```ts
+ * const debouncedFunction = debounce(() => console.log('Hello'), 300);
+ * debouncedFunction(); // 不会立即执行
+ * debouncedFunction(); // 重新开始计时
+ * // 300ms 后，执行 'Hello'
+ * ```
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, wait?: number, immediate?: boolean): {
+    (this: any, ...args: Parameters<T>): any;
+    cancel(): void;
+} & {
+    cancel(): void;
+};
+//# sourceMappingURL=debounce.d.ts.map

package/dist/async/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../src/async/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,SAAI,EAAE,SAAS,UAAQ,GA0BtE;WAtBc,GAAG,WAAW,UAAU,CAAC,CAAC,CAAC;;IAsBtB;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAC5D"}

package/dist/async/debounce.esm.js

@@ -0,0 +1,48 @@
+/**
+ * 防抖函数 - 在指定时间 wait 内，如果函数被多次调用，则只执行最后一次调用
+ * 如果设置了 immediate 为 true，则会在延时之前立即执行
+ *
+ * @description
+ * 防抖是一种函数调用技术，它确保函数在指定的等待时间内不被重复执行。
+ * 如果在等待期间再次调用函数，则会重新开始计时。
+ *
+ * @template T - 函数类型
+ * @param fn - 需要防抖的函数
+ * @param wait - 延迟时间（毫秒）
+ * @param immediate - 是否立即执行（true 为立即执行，false 为延迟后执行）
+ * @returns 返回处理后的函数，该函数接收与原函数相同的参数
+ *
+ * @example
+ * ```ts
+ * const debouncedFunction = debounce(() => console.log('Hello'), 300);
+ * debouncedFunction(); // 不会立即执行
+ * debouncedFunction(); // 重新开始计时
+ * // 300ms 后，执行 'Hello'
+ * ```
+ */
+export function debounce(fn, wait = 0, immediate = false) {
+    let timeout = null;
+    // 1. 定义要返回的函数
+    const debounced = function (...args) {
+        const callNow = immediate && !timeout;
+        if (timeout)
+            clearTimeout(timeout);
+        timeout = setTimeout(() => {
+            timeout = null;
+            if (!immediate)
+                fn.apply(this, args);
+        }, wait);
+        if (callNow)
+            return fn.apply(this, args);
+    };
+    // 2. 在函数对象上挂载 cancel 方法
+    debounced.cancel = () => {
+        if (timeout) {
+            clearTimeout(timeout);
+            timeout = null;
+        }
+    };
+    // 3. 强制转换类型，让 TS 知道它带 cancel
+    return debounced;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/async/debounce.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../src/async/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,QAAQ,CAAoC,EAAK,EAAE,IAAI,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK;IAC1F,IAAI,OAAO,GAAyC,IAAI,CAAC;IAEzD,cAAc;IACd,MAAM,SAAS,GAAG,UAAqB,GAAG,IAAmB;QACzD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC;QAEtC,IAAI,OAAO;YAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,CAAC,SAAS;gBAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,IAAI,OAAO;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,wBAAwB;IACxB,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO,EAAE,CAAC;YACV,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;IACL,CAAC,CAAC;IAEF,6BAA6B;IAC7B,OAAO,SAAkD,CAAC;AAC9D,CAAC"}

package/dist/async/debounce.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debounce = debounce;
+/**
+ * 防抖函数 - 在指定时间 wait 内，如果函数被多次调用，则只执行最后一次调用
+ * 如果设置了 immediate 为 true，则会在延时之前立即执行
+ *
+ * @description
+ * 防抖是一种函数调用技术，它确保函数在指定的等待时间内不被重复执行。
+ * 如果在等待期间再次调用函数，则会重新开始计时。
+ *
+ * @template T - 函数类型
+ * @param fn - 需要防抖的函数
+ * @param wait - 延迟时间（毫秒）
+ * @param immediate - 是否立即执行（true 为立即执行，false 为延迟后执行）
+ * @returns 返回处理后的函数，该函数接收与原函数相同的参数
+ *
+ * @example
+ * ```ts
+ * const debouncedFunction = debounce(() => console.log('Hello'), 300);
+ * debouncedFunction(); // 不会立即执行
+ * debouncedFunction(); // 重新开始计时
+ * // 300ms 后，执行 'Hello'
+ * ```
+ */
+function debounce(fn, wait = 0, immediate = false) {
+    let timeout = null;
+    // 1. 定义要返回的函数
+    const debounced = function (...args) {
+        const callNow = immediate && !timeout;
+        if (timeout)
+            clearTimeout(timeout);
+        timeout = setTimeout(() => {
+            timeout = null;
+            if (!immediate)
+                fn.apply(this, args);
+        }, wait);
+        if (callNow)
+            return fn.apply(this, args);
+    };
+    // 2. 在函数对象上挂载 cancel 方法
+    debounced.cancel = () => {
+        if (timeout) {
+            clearTimeout(timeout);
+            timeout = null;
+        }
+    };
+    // 3. 强制转换类型，让 TS 知道它带 cancel
+    return debounced;
+}
+//# sourceMappingURL=debounce.js.map

package/dist/async/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../src/async/debounce.ts"],"names":[],"mappings":";;AAsBA,4BA2BC;AAjDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,QAAQ,CAAoC,EAAK,EAAE,IAAI,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK;IAC1F,IAAI,OAAO,GAAyC,IAAI,CAAC;IAEzD,cAAc;IACd,MAAM,SAAS,GAAG,UAAqB,GAAG,IAAmB;QACzD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC;QAEtC,IAAI,OAAO;YAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,CAAC,SAAS;gBAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,IAAI,OAAO;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,wBAAwB;IACxB,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO,EAAE,CAAC;YACV,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;IACL,CAAC,CAAC;IAEF,6BAA6B;IAC7B,OAAO,SAAkD,CAAC;AAC9D,CAAC"}

package/dist/async/index.d.ts

@@ -0,0 +1,3 @@
+export * from './debounce';
+export * from './throttle';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/async/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/async/index.esm.js

@@ -0,0 +1,3 @@
+export * from './debounce';
+export * from './throttle';
+//# sourceMappingURL=index.js.map

package/dist/async/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/async/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/async/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./debounce"), exports);
+__exportStar(require("./throttle"), exports);
+//# sourceMappingURL=index.js.map

package/dist/async/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/async/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B"}

package/dist/async/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@qimen-lab/async",
+  "version": "0.1.1",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.esm.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  }
+}

package/dist/async/throttle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 节流函数 - 在指定时间 wait 内，函数最多只会执行一次
+ *
+ * @description
+ * 节流是一种函数调用技术，确保函数在指定的时间间隔内最多只执行一次。
+ * 这可以限制函数执行的频率，避免在短时间内重复执行。
+ *
+ * @template T - 函数类型
+ * @param fn - 需要节流的函数
+ * @param wait - 时间间隔（毫秒）
+ * @returns 返回处理后的函数，该函数接收与原函数相同的参数
+ *
+ * @example
+ * ```ts
+ * const throttledFunction = throttle(() => console.log('Hello'), 1000);
+ * throttledFunction(); // 立即执行
+ * throttledFunction(); // 不执行
+ * throttledFunction(); // 不执行
+ * // 1000ms 后，再次调用会执行
+ * ```
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, wait?: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/async/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/async/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtD,EAAE,EAAE,CAAC,EACL,IAAI,SAAI,GACT,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAmBlC"}

package/dist/async/throttle.esm.js

@@ -0,0 +1,41 @@
+/**
+ * 节流函数 - 在指定时间 wait 内，函数最多只会执行一次
+ *
+ * @description
+ * 节流是一种函数调用技术，确保函数在指定的时间间隔内最多只执行一次。
+ * 这可以限制函数执行的频率，避免在短时间内重复执行。
+ *
+ * @template T - 函数类型
+ * @param fn - 需要节流的函数
+ * @param wait - 时间间隔（毫秒）
+ * @returns 返回处理后的函数，该函数接收与原函数相同的参数
+ *
+ * @example
+ * ```ts
+ * const throttledFunction = throttle(() => console.log('Hello'), 1000);
+ * throttledFunction(); // 立即执行
+ * throttledFunction(); // 不执行
+ * throttledFunction(); // 不执行
+ * // 1000ms 后，再次调用会执行
+ * ```
+ */
+export function throttle(fn, wait = 0) {
+    let last = 0;
+    let timeout = null;
+    return function (...args) {
+        const now = Date.now();
+        const remaining = wait - (now - last);
+        if (remaining <= 0) {
+            last = now;
+            fn.apply(this, args);
+        }
+        else if (!timeout) {
+            timeout = setTimeout(() => {
+                timeout = null;
+                last = Date.now();
+                fn.apply(this, args);
+            }, remaining);
+        }
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/async/throttle.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/async/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CACpB,EAAK,EACL,IAAI,GAAG,CAAC;IAER,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,OAAO,GAAyC,IAAI,CAAC;IAEzD,OAAO,UAAqB,GAAG,IAAmB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QAEtC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACjB,IAAI,GAAG,GAAG,CAAC;YACX,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAClB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC,EAAE,SAAS,CAAC,CAAC;QAClB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/async/throttle.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throttle = throttle;
+/**
+ * 节流函数 - 在指定时间 wait 内，函数最多只会执行一次
+ *
+ * @description
+ * 节流是一种函数调用技术，确保函数在指定的时间间隔内最多只执行一次。
+ * 这可以限制函数执行的频率，避免在短时间内重复执行。
+ *
+ * @template T - 函数类型
+ * @param fn - 需要节流的函数
+ * @param wait - 时间间隔（毫秒）
+ * @returns 返回处理后的函数，该函数接收与原函数相同的参数
+ *
+ * @example
+ * ```ts
+ * const throttledFunction = throttle(() => console.log('Hello'), 1000);
+ * throttledFunction(); // 立即执行
+ * throttledFunction(); // 不执行
+ * throttledFunction(); // 不执行
+ * // 1000ms 后，再次调用会执行
+ * ```
+ */
+function throttle(fn, wait = 0) {
+    let last = 0;
+    let timeout = null;
+    return function (...args) {
+        const now = Date.now();
+        const remaining = wait - (now - last);
+        if (remaining <= 0) {
+            last = now;
+            fn.apply(this, args);
+        }
+        else if (!timeout) {
+            timeout = setTimeout(() => {
+                timeout = null;
+                last = Date.now();
+                fn.apply(this, args);
+            }, remaining);
+        }
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/async/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/async/throttle.ts"],"names":[],"mappings":";;AAqBA,4BAsBC;AA3CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,QAAQ,CACpB,EAAK,EACL,IAAI,GAAG,CAAC;IAER,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,OAAO,GAAyC,IAAI,CAAC;IAEzD,OAAO,UAAqB,GAAG,IAAmB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QAEtC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACjB,IAAI,GAAG,GAAG,CAAC;YACX,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAClB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC,EAAE,SAAS,CAAC,CAAC;QAClB,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/cache/BaseCacheProvider.d.ts

@@ -0,0 +1,21 @@
+import { CacheType, ICacheEntry, ICacheProvider } from './types';
+export declare abstract class BaseCacheProvider<TKey = string, TData = any> implements ICacheProvider<TKey, TData> {
+    id: string;
+    type: CacheType;
+    protected abstract rawGet(key: string): Promise<ICacheEntry<TData> | null>;
+    protected abstract rawSet(key: string, entry: ICacheEntry<TData>): Promise<void>;
+    abstract remove(key: TKey): Promise<void>;
+    abstract clear(): Promise<void>;
+    abstract has(key: TKey): Promise<boolean>;
+    constructor();
+    /**
+     * 统一的获取逻辑（含过期检查）
+     */
+    get(key: TKey): Promise<TData | null>;
+    /**
+     * 统一的存储逻辑
+     */
+    set(key: TKey, data: TData, ttl?: number): Promise<void>;
+    protected resolveKey(key: TKey): string;
+}
+//# sourceMappingURL=BaseCacheProvider.d.ts.map

package/dist/cache/BaseCacheProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCacheProvider.d.ts","sourceRoot":"","sources":["../../../src/cache/BaseCacheProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjE,8BAAsB,iBAAiB,CAAC,IAAI,GAAG,MAAM,EAAE,KAAK,GAAG,GAAG,CAAE,YAAW,cAAc,CACzF,IAAI,EACJ,KAAK,CACR;IACG,EAAE,EAAE,MAAM,CAAM;IAChB,IAAI,EAAE,SAAS,CAAM;IAGrB,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC1E,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAChF,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;;IAMzC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAe3C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM;CAG1C"}

package/dist/cache/BaseCacheProvider.esm.js

@@ -0,0 +1,39 @@
+import { string } from '@qimenjs/utils';
+export class BaseCacheProvider {
+    constructor() {
+        this.id = '';
+        this.type = '';
+        this.id = string.getId(this.type + '-cache');
+    }
+    /**
+     * 统一的获取逻辑（含过期检查）
+     */
+    async get(key) {
+        const fullKey = this.resolveKey(key);
+        const entry = await this.rawGet(fullKey);
+        if (!entry)
+            return null;
+        // 检查是否过期
+        if (entry.ttl > 0 && Date.now() - entry.timestamp > entry.ttl) {
+            await this.remove(key);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * 统一的存储逻辑
+     */
+    async set(key, data, ttl = 0) {
+        const fullKey = this.resolveKey(key);
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            ttl,
+        };
+        await this.rawSet(fullKey, entry);
+    }
+    resolveKey(key) {
+        return `${this.type}-cache:${String(key)}`;
+    }
+}
+//# sourceMappingURL=BaseCacheProvider.js.map

package/dist/cache/BaseCacheProvider.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCacheProvider.js","sourceRoot":"","sources":["../../../src/cache/BaseCacheProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,OAAgB,iBAAiB;IAcnC;QAVA,OAAE,GAAW,EAAE,CAAC;QAChB,SAAI,GAAc,EAAE,CAAC;QAUjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAS;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,SAAS;QACT,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAS,EAAE,IAAW,EAAE,MAAc,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAuB;YAC9B,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG;SACN,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,UAAU,CAAC,GAAS;QAC1B,OAAO,GAAG,IAAI,CAAC,IAAI,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/C,CAAC;CACJ"}

package/dist/cache/BaseCacheProvider.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCacheProvider = void 0;
+const utils_1 = require("@qimenjs/utils");
+class BaseCacheProvider {
+    constructor() {
+        this.id = '';
+        this.type = '';
+        this.id = utils_1.string.getId(this.type + '-cache');
+    }
+    /**
+     * 统一的获取逻辑（含过期检查）
+     */
+    async get(key) {
+        const fullKey = this.resolveKey(key);
+        const entry = await this.rawGet(fullKey);
+        if (!entry)
+            return null;
+        // 检查是否过期
+        if (entry.ttl > 0 && Date.now() - entry.timestamp > entry.ttl) {
+            await this.remove(key);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * 统一的存储逻辑
+     */
+    async set(key, data, ttl = 0) {
+        const fullKey = this.resolveKey(key);
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            ttl,
+        };
+        await this.rawSet(fullKey, entry);
+    }
+    resolveKey(key) {
+        return `${this.type}-cache:${String(key)}`;
+    }
+}
+exports.BaseCacheProvider = BaseCacheProvider;
+//# sourceMappingURL=BaseCacheProvider.js.map

package/dist/cache/BaseCacheProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCacheProvider.js","sourceRoot":"","sources":["../../../src/cache/BaseCacheProvider.ts"],"names":[],"mappings":";;;AAAA,0CAAwC;AAGxC,MAAsB,iBAAiB;IAcnC;QAVA,OAAE,GAAW,EAAE,CAAC;QAChB,SAAI,GAAc,EAAE,CAAC;QAUjB,IAAI,CAAC,EAAE,GAAG,cAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAS;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,SAAS;QACT,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAS,EAAE,IAAW,EAAE,MAAc,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAuB;YAC9B,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG;SACN,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAES,UAAU,CAAC,GAAS;QAC1B,OAAO,GAAG,IAAI,CAAC,IAAI,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/C,CAAC;CACJ;AApDD,8CAoDC"}

package/dist/cache/CacheFactory.d.ts

@@ -0,0 +1,7 @@
+import { CacheType, ICacheProvider } from './types';
+export declare class CacheFactory {
+    static _instances: Map<string, ICacheProvider<string, any>>;
+    static create(type: CacheType, _offline?: boolean): Promise<ICacheProvider>;
+    static release(id: string, autoClear?: boolean): void;
+}
+//# sourceMappingURL=CacheFactory.d.ts.map

package/dist/cache/CacheFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFactory.d.ts","sourceRoot":"","sources":["../../../src/cache/CacheFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGpD,qBAAa,YAAY;IACrB,MAAM,CAAC,UAAU,2CAAqC;WAEzC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAQxF,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,OAAe,GAAG,IAAI;CAW/D"}

package/dist/cache/CacheFactory.esm.js

@@ -0,0 +1,23 @@
+import { Logger } from '@qimenjs/logger';
+import { MemoryProvider } from './MemoryProvider';
+export class CacheFactory {
+    static async create(type, _offline = false) {
+        const logger = Logger.for('CacheFactory');
+        logger.debug('Creating cache provider', type);
+        const provider = new MemoryProvider();
+        this._instances.set(provider.id, provider);
+        return provider;
+    }
+    static release(id, autoClear = false) {
+        const provider = this._instances.get(id);
+        if (!provider)
+            return;
+        if (autoClear) {
+            provider.clear(); // 执行物理清理（如清空内存 Map）
+        }
+        // 销毁实例引用，让 GC 回收
+        this._instances.delete(id);
+    }
+}
+CacheFactory._instances = new Map();
+//# sourceMappingURL=CacheFactory.js.map

package/dist/cache/CacheFactory.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFactory.js","sourceRoot":"","sources":["../../../src/cache/CacheFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,OAAO,YAAY;IAGrB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAe,EAAE,WAAoB,KAAK;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,EAAU,EAAE,YAAqB,KAAK;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,SAAS,EAAE,CAAC;YACZ,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,oBAAoB;QAC1C,CAAC;QAED,iBAAiB;QACjB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;;AApBM,uBAAU,GAAG,IAAI,GAAG,EAA0B,CAAC"}