@gaias/basenode 1.3.6 → 1.3.9

package/README.md

@@ -1,12 +1,20 @@
 # @gaias/basenode
 
-[![Version](https://img.shields.io/badge/version-1.0.24-blue.svg)](https://github.com/gaias/basenode)
+[![Version](https://img.shields.io/badge/version-1.3.6-blue.svg)](https://github.com/gaias/basenode)
 [![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-UNLICENSED-red.svg)]()
 
+[English](#english) | [简体中文](#简体中文)
+
+---
+
+<a name="english"></a>
+
+## English
+
 A comprehensive Node.js API development framework built on Koa, TypeORM, TypeDI, and routing-controllers. Provides a microframework architecture with built-in support for RESTful APIs, WebSocket controllers, database ORM, distributed events, Redis caching, and API gateway integration.
 
-## Features
+### Features
 
 - **Modern Framework Stack**: Koa 3.x, TypeORM 0.3.x, TypeDI, routing-controllers
 - **TypeScript First**: Full TypeScript support with decorators and strict type checking
@@ -24,9 +32,9 @@ A comprehensive Node.js API development framework built on Koa, TypeORM, TypeDI,
 - **OpenAPI**: Automatic OpenAPI/Swagger documentation generation
 - **Development Tools**: Hot reload, linting, testing, code generation
 
-## Quick Start
+### Quick Start
 
-### Prerequisites
+#### Prerequisites
 
 - Node.js >= 18.0.0
 - Yarn >= 1.22.x
@@ -34,7 +42,7 @@ A comprehensive Node.js API development framework built on Koa, TypeORM, TypeDI,
 - Redis 6.0+ (optional, for caching)
 - RabbitMQ 3.8+ (optional, for distributed events)
 
-### Installation
+#### Installation
 
 ```bash
 # Clone the repository
@@ -45,7 +53,7 @@ cd basenode
 yarn install
 ```
 
-### Configuration
+#### Configuration
 
 1. **Database Configuration**
 
@@ -93,7 +101,7 @@ API_GATEWAY_HOST_PORT=192.168.1.100:9180    # Gateway admin API address
 DOMAINS=example.com,*.example.com           # Allowed domains for gateway
 ```
 
-### Running the Application
+#### Running the Application
 
 ```bash
 # Development mode with hot reload
@@ -110,7 +118,7 @@ The application will start on `http://localhost:3000` (or configured port).
 
 Access the health check endpoint: `http://localhost:3000/_healthcheck`
 
-## Project Structure
+### Project Structure
 
 ```
 .
@@ -164,9 +172,9 @@ Access the health check endpoint: `http://localhost:3000/_healthcheck`
 └── keys/                  # JWT keys (generated)
 ```
 
-## Development Commands
+### Development Commands
 
-### Running
+#### Running
 
 ```bash
 # Development with hot reload
@@ -179,7 +187,7 @@ yarn devPro
 yarn ncc:run
 ```
 
-### Building
+#### Building
 
 ```bash
 # Build for publishing
@@ -189,7 +197,7 @@ yarn build:publish
 yarn ncc:build
 ```
 
-### Database Code Generation
+#### Database Code Generation
 
 ```bash
 # Generate entities from database schema
@@ -207,7 +215,7 @@ yarn gen:idx
 
 **Note**: Define tables to generate in `gen_db.json` before running.
 
-### Testing & Quality
+#### Testing & Quality
 
 ```bash
 # Run tests
@@ -226,7 +234,7 @@ yarn lint
 yarn lint:fix
 ```
 
-### Security
+#### Security
 
 ```bash
 # Run security audit
@@ -244,7 +252,7 @@ yarn security:json
 
 See [docs/SECURITY.md](docs/SECURITY.md) for comprehensive security guidelines.
 
-### Dependency Management
+#### Dependency Management
 
 ```bash
 # Check for outdated dependencies
@@ -254,7 +262,7 @@ yarn deps:check
 yarn deps:update
 ```
 
-### Other Tools
+#### Other Tools
 
 ```bash
 # Generate RSA keys for JWT
@@ -264,9 +272,9 @@ yarn gen:keys
 yarn buildNum
 ```
 
-## Usage Examples
+### Usage Examples
 
-### Creating a RESTful Controller
+#### Creating a RESTful Controller
 
 ```typescript
 import { rest, di } from '@/libs/deps';
@@ -297,7 +305,7 @@ export class UserController extends UniversalController {
 }
 ```
 
-### Creating a Service with Repository
+#### Creating a Service with Repository
 
 ```typescript
 import { di } from '@/libs/deps';
@@ -317,7 +325,7 @@ export class UserService extends UniversalService<User> {
 }
 ```
 
-### Validation with VO (Value Object)
+#### Validation with VO (Value Object)
 
 ```typescript
 import { cv } from '@/libs/deps';
@@ -341,7 +349,7 @@ export class UserVo {
 }
 ```
 
-### Pagination
+#### Pagination
 
 ```typescript
 import { rest, di } from '@/libs/deps';
@@ -362,7 +370,7 @@ export class UserController {
 }
 ```
 
-### Caching
+#### Caching
 
 ```typescript
 import { rest, di } from '@/libs/deps';
@@ -395,7 +403,7 @@ export class DataController {
 }
 ```
 
-### Distributed Events
+#### Distributed Events
 
 ```typescript
 import { di } from '@/libs/deps';
@@ -435,34 +443,34 @@ export class UserEventHandler {
 }
 ```
 
-## Key Technologies
+### Key Technologies
 
-### Core Framework
+#### Core Framework
 - **[Koa](https://koajs.com/)** 3.0.3 - Lightweight web framework
 - **[routing-controllers](https://github.com/typestack/routing-controllers)** 0.11.3 - Decorator-based routing
 - **[socket-controllers](https://github.com/typestack/socket-controllers)** 0.3.1 - WebSocket controllers
 - **[TypeDI](https://github.com/typestack/typedi)** 0.10.0 - Dependency injection
 - **[microframework](https://github.com/typestack/microframework)** 0.6.4 - Loader pattern
 
-### Data Layer
+#### Data Layer
 - **[TypeORM](https://typeorm.io/)** 0.3.27 - SQL ORM
 - **[typeorm-transactional](https://github.com/Aliheym/typeorm-transactional)** 0.5.0 - Transaction management
 - **[mysql2](https://github.com/sidorares/node-mysql2)** 3.15.2 - MySQL/MariaDB driver
 - **[class-validator](https://github.com/typestack/class-validator)** 0.14.2 - Validation
 - **[class-transformer](https://github.com/typestack/class-transformer)** 0.5.1 - Transformation
 
-### Caching & Messaging
+#### Caching & Messaging
 - **[ioredis](https://github.com/luin/ioredis)** 5.8.1 - Redis client
 - **[amqplib](https://github.com/amqp-node/amqplib)** 0.10.9 - RabbitMQ client
 
-### Utilities
+#### Utilities
 - **[pino](https://github.com/pinojs/pino)** 10.0.0 - High-performance logger
 - **[jsonwebtoken](https://github.com/auth0/node-jsonwebtoken)** 9.0.2 - JWT authentication
 - **[nanoid](https://github.com/ai/nanoid)** 5.1.6 - Unique ID generator
 - **[axios](https://github.com/axios/axios)** 1.12.2 - HTTP client
 - **[helmet](https://github.com/helmetjs/helmet)** 8.1.0 - Security headers
 
-## Documentation
+### Documentation
 
 - **[CLAUDE.md](CLAUDE.md)** - Comprehensive framework documentation
 - **[docs/SECURITY.md](docs/SECURITY.md)** - Security guidelines and best practices
@@ -472,7 +480,7 @@ export class UserEventHandler {
 - **[docs/BUILD_AND_USE.md](docs/BUILD_AND_USE.md)** - Building and usage instructions
 - **[docs/DOCKER_OPTIMIZATION.md](docs/DOCKER_OPTIMIZATION.md)** - Docker optimization guide
 
-### Module Documentation
+#### Module Documentation
 
 - `src/libs/deps/README.md` - Unified dependency exports
 - `src/libs/validator/README.md` - Validation helpers
@@ -486,7 +494,7 @@ export class UserEventHandler {
 - `src/libs/type/README.md` - Type utilities
 - `src/libs/universal/README.md` - Universal CRUD patterns
 
-## Security
+### Security
 
 This project takes security seriously. We use:
 
@@ -500,7 +508,7 @@ See [docs/SECURITY.md](docs/SECURITY.md) for detailed information.
 
 **Important**: Always use `@IsSafeUrl()` instead of `@IsUrl()` to avoid CVE-2025-56200.
 
-## Contributing
+### Contributing
 
 Contributions are welcome! Please follow these guidelines:
 
@@ -511,7 +519,7 @@ Contributions are welcome! Please follow these guidelines:
 5. Run security check: `yarn security:check`
 6. Create a pull request to `develope` branch
 
-### Development Guidelines
+#### Development Guidelines
 
 - Follow existing code conventions
 - Use TypeScript strict mode
@@ -519,7 +527,7 @@ Contributions are welcome! Please follow these guidelines:
 - Write tests for new features
 - Update documentation as needed
 
-## Publishing
+### Publishing
 
 This is a private npm package. To publish:
 
@@ -543,48 +551,634 @@ yarn publish:github
 
 See [docs/PUBLISHING.md](docs/PUBLISHING.md) for detailed publishing instructions.
 
-## Troubleshooting
+### Troubleshooting
 
-### Database Connection Issues
+#### Database Connection Issues
 
 - Verify `cfg/database.yml` connection string
 - Check MariaDB/MySQL is running
 - Ensure database user has proper permissions
 
-### Redis Connection Issues
+#### Redis Connection Issues
 
 - Check Redis is running: `redis-cli ping`
 - Verify `cfg/redis.yml` settings
 - Can disable Redis by setting `disableRedis: true` in bootstrap
 
-### TypeORM Entity Not Found
+#### TypeORM Entity Not Found
 
 - Ensure entity is registered in bootstrap `entities` array
 - Check entity file has `@Entity()` decorator
 - Verify import path is correct
 
-## License
+### License
 
 UNLICENSED - Private package
 
-## Author
+### Author
 
 FOT Team
 
-## Links
+### Links
 
 - [Repository](https://github.com/gaias/basenode)
 - [Issue Tracker](https://github.com/gaias/basenode/issues)
 - [npm Package](https://www.npmjs.com/package/@gaias/basenode)
 
-## Version History
+### Version History
 
-- **1.0.24** (Current) - Latest updates and improvements
+- **1.3.6** (Current) - Latest updates and improvements
 - **1.0.13** - Security enhancements and dependency updates
 - **1.0.0** - Initial release
 
 ---
 
-**Last Updated**: 2025-10-23
-**Framework Version**: 1.0.24
-**Build Number**: 251022024
+<a name="简体中文"></a>
+
+## 简体中文
+
+一个基于 Koa、TypeORM、TypeDI 和 routing-controllers 构建的全面的 Node.js API 开发框架。提供微框架架构，内置支持 RESTful API、WebSocket 控制器、数据库 ORM、分布式事件、Redis 缓存和 API 网关集成。
+
+### 特性
+
+- **现代框架栈**：Koa 3.x、TypeORM 0.3.x、TypeDI、routing-controllers
+- **TypeScript 优先**：完整的 TypeScript 支持，包括装饰器和严格类型检查
+- **RESTful 和 WebSocket**：同时支持 REST API 和 WebSocket 控制器
+- **数据库 ORM**：TypeORM 支持 MySQL/MariaDB，自动生成实体
+- **依赖注入**：基于 TypeDI 的 IoC 容器，实现清晰架构
+- **验证**：class-validator 支持国际化错误消息
+- **缓存**：双层缓存（L1 内存、L2 Redis）
+- **分布式事件**：基于 RabbitMQ 的发布/订阅系统
+- **API 网关**：APISIX 集成实现服务注册
+- **领导者选举**：基于 Redis 的分布式系统领导者选举
+- **健康检查**：内置健康检查端点和系统指标
+- **分页**：完整的分页解决方案，支持排序
+- **安全性**：内置安全特性、漏洞跟踪和缓解措施
+- **OpenAPI**：自动生成 OpenAPI/Swagger 文档
+- **开发工具**：热重载、代码检查、测试、代码生成
+
+### 快速开始
+
+#### 系统要求
+
+- Node.js >= 18.0.0
+- Yarn >= 1.22.x
+- MariaDB/MySQL 5.7+ 或 8.0+（生产环境）
+- Redis 6.0+（可选，用于缓存）
+- RabbitMQ 3.8+（可选，用于分布式事件）
+
+#### 安装
+
+```bash
+# 克隆仓库
+git clone https://github.com/gaias/basenode.git
+cd basenode
+
+# 安装依赖
+yarn install
+```
+
+#### 配置
+
+1. **数据库配置**
+
+编辑 `cfg/database.yml`：
+```yaml
+mariaDBUrl: mysql://用户名:密码@localhost:3306/数据库名
+output: ./example
+```
+
+2. **应用配置**
+
+编辑 `cfg/application.yml`：
+```yaml
+appName: example
+version: 1
+port: 3000
+privateKeyPath: ./keys/privateKey
+publicKeyPath: ./keys/publicKey
+```
+
+3. **Redis 配置**（可选）
+
+编辑 `cfg/redis.yml`：
+```yaml
+host: localhost
+port: 6379
+password: 你的密码
+db: 0
+```
+
+4. **RabbitMQ 配置**（可选）
+
+编辑 `cfg/rabbitmq.yml`：
+```yaml
+url: amqp://localhost:5672
+```
+
+5. **环境变量**（可选）
+
+创建 `.env` 文件或导出变量：
+```bash
+NODE_ENV=development                        # 环境：development、production、test
+ENABLE_API_GATEWAY=true                     # 启用 APISIX 网关注册
+API_GATEWAY_HOST_PORT=192.168.1.100:9180    # 网关管理 API 地址
+DOMAINS=example.com,*.example.com           # 网关允许的域名
+```
+
+#### 运行应用
+
+```bash
+# 开发模式（热重载）
+yarn dev
+
+# 开发模式（启用 API 网关）
+yarn devPro
+
+# 生产模式（构建后）
+yarn ncc:run
+```
+
+应用将在 `http://localhost:3000`（或配置的端口）启动。
+
+访问健康检查端点：`http://localhost:3000/_healthcheck`
+
+### 项目结构
+
+```
+.
+├── src/                    # 框架源代码
+│   ├── libs/              # 框架组件
+│   │   ├── apisix/        # APISIX HTTP 客户端
+│   │   ├── cache/         # 双层缓存系统
+│   │   ├── configure/     # YAML 配置管理
+│   │   ├── deps/          # 依赖库导出
+│   │   ├── error/         # 错误处理
+│   │   ├── gateway/       # API 网关集成
+│   │   ├── generator/     # ID 生成（nanoid、snowflake）
+│   │   ├── healthcheck/   # 健康检查端点
+│   │   ├── koa/           # Koa 服务器设置
+│   │   ├── leader/        # 基于 Redis 的领导者选举
+│   │   ├── logger/        # Pino 日志包装器
+│   │   ├── network/       # 网络工具
+│   │   ├── orm/           # TypeORM 扩展
+│   │   ├── pagination/    # 分页工具
+│   │   ├── rabbitmq/      # RabbitMQ 分布式事件
+│   │   ├── redis/         # Redis 客户端包装器
+│   │   ├── register/      # API 路由注册
+│   │   ├── type/          # 类型定义
+│   │   ├── universal/     # 通用 CRUD 模式
+│   │   └── validator/     # 验证辅助工具
+│   ├── server/            # 启动逻辑
+│   └── utils/             # 工具类（JWT、加密、YAML）
+├── example/               # 示例应用
+│   ├── app.ts            # 入口点
+│   ├── controllers/       # RESTful 控制器
+│   ├── wsControllers/     # WebSocket 控制器
+│   ├── entities/          # TypeORM 实体
+│   ├── repositories/      # 仓储类
+│   ├── services/          # 业务逻辑服务
+│   ├── vo/                # 值对象（DTO）
+│   └── events/            # 分布式事件处理器
+├── cfg/                   # YAML 配置文件
+│   ├── application.yml    # 应用设置
+│   ├── database.yml       # 数据库连接
+│   ├── redis.yml          # Redis 连接
+│   ├── rabbitmq.yml       # RabbitMQ 连接
+│   ├── logger.yml         # 日志设置
+│   ├── apisix.apikey.yml  # API 网关设置
+│   └── openapi.yml        # OpenAPI/Swagger 配置
+├── tools/                 # 开发工具
+│   ├── DBSchemaGenerator.ts      # 从数据库生成实体
+│   ├── RepositoryGenerator.ts    # 生成仓储类
+│   └── repository.mst            # Mustache 模板
+├── docs/                  # 文档
+├── k8s/                   # Kubernetes 清单
+└── keys/                  # JWT 密钥（生成的）
+```
+
+### 开发命令
+
+#### 运行
+
+```bash
+# 开发模式（热重载）
+yarn dev
+
+# 开发模式（带 API 网关）
+yarn devPro
+
+# 运行编译后的应用
+yarn ncc:run
+```
+
+#### 构建
+
+```bash
+# 构建用于发布
+yarn build:publish
+
+# 构建单文件可执行文件
+yarn ncc:build
+```
+
+#### 数据库代码生成
+
+```bash
+# 从数据库架构生成实体
+yarn gen:db-schema
+
+# 生成仓储类
+yarn gen:db-repo
+
+# 生成实体和仓储
+yarn gen:db
+
+# 生成索引文件
+yarn gen:idx
+```
+
+**注意**：运行前在 `gen_db.json` 中定义要生成的表。
+
+#### 测试与质量
+
+```bash
+# 运行测试
+yarn test
+
+# 监视模式运行测试
+yarn test:watch
+
+# 带覆盖率运行测试
+yarn test:coverage
+
+# 类型检查和代码检查
+yarn lint
+
+# 自动修复代码检查问题
+yarn lint:fix
+```
+
+#### 安全
+
+```bash
+# 运行安全审计
+yarn security
+
+# 显示审计摘要
+yarn security:summary
+
+# 增强安全检查（推荐）
+yarn security:check
+
+# 生成安全报告
+yarn security:json
+```
+
+查看 [docs/SECURITY.md](docs/SECURITY.md) 了解全面的安全指南。
+
+#### 依赖管理
+
+```bash
+# 检查过时的依赖
+yarn deps:check
+
+# 更新依赖
+yarn deps:update
+```
+
+#### 其他工具
+
+```bash
+# 为 JWT 生成 RSA 密钥
+yarn gen:keys
+
+# 更新构建编号
+yarn buildNum
+```
+
+### 使用示例
+
+#### 创建 RESTful 控制器
+
+```typescript
+import { rest, di } from '@/libs/deps';
+import { UniversalController } from '@/libs/universal';
+import { UserService } from './services/UserService';
+import { UserVo } from './vo/UserVo';
+
+@rest.JsonController('/api/users')
+@di.Service()
+export class UserController extends UniversalController {
+  @di.Inject()
+  private userService: UserService;
+
+  @rest.Get('/')
+  async getAll() {
+    return this.userService.getAll(UserVo);
+  }
+
+  @rest.Post('/')
+  async create(@rest.Body() data: UserVo) {
+    // rest.Body 自动启用 excludeExtraneousValues 以提高安全性
+    return this.userService.create(data);
+  }
+
+  @rest.Get('/:id')
+  async getById(@rest.Param('id') id: number) {
+    return this.userService.readById(id, UserVo);
+  }
+}
+```
+
+#### 创建带仓储的服务
+
+```typescript
+import { di } from '@/libs/deps';
+import { UniversalService } from '@/libs/universal';
+import { User } from './entities/User';
+import { UserRepo } from './repositories/UserRepo';
+
+@di.Service()
+export class UserService extends UniversalService<User> {
+  constructor(@di.Inject(() => UserRepo) private userRepo: UserRepo) {
+    super(userRepo);
+  }
+
+  async findByEmail(email: string): Promise<User | null> {
+    return this.userRepo.findOne({ where: { email } });
+  }
+}
+```
+
+#### 使用 VO 进行验证
+
+```typescript
+import { cv } from '@/libs/deps';
+import { i18n } from '@/libs/validator';
+import { IsSafeUrl } from '@/libs/validator';
+
+export class UserVo {
+  @i18n(cv.IsString)
+  @i18n(cv.MaxLength, 50)
+  userName: string;
+
+  @i18n(cv.IsEmail)
+  email: string;
+
+  @IsSafeUrl()
+  website?: string;
+
+  @i18n(cv.IsOptional)
+  @i18n(cv.MinLength, 6)
+  password?: string;
+}
+```
+
+#### 分页
+
+```typescript
+import { rest, di } from '@/libs/deps';
+import { PaginationIn, PaginationOut } from '@/libs/pagination';
+import { UserService } from './services/UserService';
+import { UserVo } from './vo/UserVo';
+
+@rest.JsonController('/api/users')
+@di.Service()
+export class UserController {
+  @di.Inject()
+  private userService: UserService;
+
+  @rest.Post('/search')
+  async search(@rest.Body() pagination: PaginationIn): Promise<PaginationOut<UserVo, User>> {
+    return this.userService.search(pagination);
+  }
+}
+```
+
+#### 缓存
+
+```typescript
+import { rest, di } from '@/libs/deps';
+import { L1Cache } from '@/libs/cache';
+import { CacheService } from '@/libs/cache';
+
+@rest.JsonController('/api/data')
+@di.Service()
+export class DataController {
+  @di.Inject()
+  private cacheService: CacheService;
+
+  @rest.Get('/cached')
+  @L1Cache({ ttlSeconds: 60 })
+  async getCachedData() {
+    // L1 缓存 - 内存
+    return { data: '这将被缓存 60 秒' };
+  }
+
+  @rest.Get('/redis')
+  async getRedisData() {
+    // L2 缓存 - Redis
+    const cached = await this.cacheService.get('key');
+    if (cached) return cached;
+
+    const data = { data: '新数据' };
+    await this.cacheService.set('key', data, 300);
+    return data;
+  }
+}
+```
+
+#### 分布式事件
+
+```typescript
+import { di } from '@/libs/deps';
+import { DistributedEvents } from '@/libs/rabbitmq';
+
+@di.Service()
+export class UserService {
+  @di.Inject()
+  private events: DistributedEvents;
+
+  async createUser(data: UserVo) {
+    const user = await this.userRepo.save(data);
+
+    // 发布事件到 RabbitMQ
+    await this.events.pub('user.created', { userId: user.id });
+
+    return user;
+  }
+}
+
+// 事件处理器
+@di.Service()
+export class UserEventHandler {
+  @di.Inject()
+  private events: DistributedEvents;
+
+  async init() {
+    // 订阅事件
+    await this.events.sub(['user.created']);
+
+    this.events.on('RemoteEvent', (eventName, data) => {
+      if (eventName === 'user.created') {
+        console.log('用户已创建:', data);
+      }
+    });
+  }
+}
+```
+
+### 核心技术
+
+#### 核心框架
+- **[Koa](https://koajs.com/)** 3.0.3 - 轻量级 Web 框架
+- **[routing-controllers](https://github.com/typestack/routing-controllers)** 0.11.3 - 基于装饰器的路由
+- **[socket-controllers](https://github.com/typestack/socket-controllers)** 0.3.1 - WebSocket 控制器
+- **[TypeDI](https://github.com/typestack/typedi)** 0.10.0 - 依赖注入
+- **[microframework](https://github.com/typestack/microframework)** 0.6.4 - 加载器模式
+
+#### 数据层
+- **[TypeORM](https://typeorm.io/)** 0.3.27 - SQL ORM
+- **[typeorm-transactional](https://github.com/Aliheym/typeorm-transactional)** 0.5.0 - 事务管理
+- **[mysql2](https://github.com/sidorares/node-mysql2)** 3.15.2 - MySQL/MariaDB 驱动
+- **[class-validator](https://github.com/typestack/class-validator)** 0.14.2 - 验证
+- **[class-transformer](https://github.com/typestack/class-transformer)** 0.5.1 - 转换
+
+#### 缓存与消息
+- **[ioredis](https://github.com/luin/ioredis)** 5.8.1 - Redis 客户端
+- **[amqplib](https://github.com/amqp-node/amqplib)** 0.10.9 - RabbitMQ 客户端
+
+#### 工具
+- **[pino](https://github.com/pinojs/pino)** 10.0.0 - 高性能日志
+- **[jsonwebtoken](https://github.com/auth0/node-jsonwebtoken)** 9.0.2 - JWT 认证
+- **[nanoid](https://github.com/ai/nanoid)** 5.1.6 - 唯一 ID 生成器
+- **[axios](https://github.com/axios/axios)** 1.12.2 - HTTP 客户端
+- **[helmet](https://github.com/helmetjs/helmet)** 8.1.0 - 安全头
+
+### 文档
+
+- **[CLAUDE.md](CLAUDE.md)** - 全面的框架文档
+- **[docs/SECURITY.md](docs/SECURITY.md)** - 安全指南和最佳实践
+- **[docs/VULNERABILITY_MITIGATION.md](docs/VULNERABILITY_MITIGATION.md)** - 漏洞跟踪
+- **[docs/QUICKSTART.md](docs/QUICKSTART.md)** - 快速开始指南
+- **[docs/PUBLISHING.md](docs/PUBLISHING.md)** - 发布指南
+- **[docs/BUILD_AND_USE.md](docs/BUILD_AND_USE.md)** - 构建和使用说明
+- **[docs/DOCKER_OPTIMIZATION.md](docs/DOCKER_OPTIMIZATION.md)** - Docker 优化指南
+
+#### 模块文档
+
+- `src/libs/deps/README.md` - 统一依赖导出
+- `src/libs/validator/README.md` - 验证辅助工具
+- `src/libs/apisix/README.md` - API 网关集成
+- `src/libs/gateway/README.md` - 网关加载器
+- `src/libs/generator/README.md` - ID 生成
+- `src/libs/koa/README.md` - Koa 服务器设置
+- `src/libs/network/README.md` - 网络工具
+- `src/libs/rabbitmq/README.md` - 分布式事件
+- `src/libs/register/README.md` - API 路由注册
+- `src/libs/type/README.md` - 类型工具
+- `src/libs/universal/README.md` - 通用 CRUD 模式
+
+### 安全性
+
+本项目高度重视安全性。我们使用：
+
+- 使用 `yarn security:check` 定期进行安全审计
+- 依赖漏洞跟踪和缓解
+- 自定义验证器避免已知 CVE（例如，使用 `@IsSafeUrl()` 而非 `@IsUrl()`）
+- 传递依赖的安全解析
+- 安全文档和最佳实践
+
+详细信息请查看 [docs/SECURITY.md](docs/SECURITY.md)。
+
+**重要**：始终使用 `@IsSafeUrl()` 而非 `@IsUrl()` 以避免 CVE-2025-56200。
+
+### 贡献
+
+欢迎贡献！请遵循以下指南：
+
+1. Fork 仓库
+2. 从 `develope` 创建功能分支
+3. 使用描述性提交进行更改
+4. 运行测试和代码检查：`yarn test && yarn lint`
+5. 运行安全检查：`yarn security:check`
+6. 创建到 `develope` 分支的拉取请求
+
+#### 开发指南
+
+- 遵循现有代码约定
+- 使用 TypeScript 严格模式
+- 为公共 API 添加 JSDoc 注释
+- 为新功能编写测试
+- 根据需要更新文档
+
+### 发布
+
+这是一个私有 npm 包。要发布：
+
+```bash
+# 更新 package.json 中的版本
+# 更新构建编号
+yarn buildNum
+
+# 运行发布前检查
+yarn publish:check
+
+# 构建用于发布
+yarn build:publish
+
+# 发布到 npm
+yarn publish:npmjs
+
+# 或发布到 GitHub packages
+yarn publish:github
+```
+
+详细发布说明请查看 [docs/PUBLISHING.md](docs/PUBLISHING.md)。
+
+### 故障排除
+
+#### 数据库连接问题
+
+- 验证 `cfg/database.yml` 连接字符串
+- 检查 MariaDB/MySQL 是否正在运行
+- 确保数据库用户具有适当的权限
+
+#### Redis 连接问题
+
+- 检查 Redis 是否正在运行：`redis-cli ping`
+- 验证 `cfg/redis.yml` 设置
+- 可以通过在启动时设置 `disableRedis: true` 来禁用 Redis
+
+#### TypeORM 实体未找到
+
+- 确保实体在启动时注册到 `entities` 数组中
+- 检查实体文件是否有 `@Entity()` 装饰器
+- 验证导入路径是否正确
+
+### 许可证
+
+UNLICENSED - 私有包
+
+### 作者
+
+FOT 团队
+
+### 链接
+
+- [仓库](https://github.com/gaias/basenode)
+- [问题跟踪](https://github.com/gaias/basenode/issues)
+- [npm 包](https://www.npmjs.com/package/@gaias/basenode)
+
+### 版本历史
+
+- **1.3.6**（当前）- 最新更新和改进
+- **1.0.13** - 安全增强和依赖更新
+- **1.0.0** - 初始版本
+
+---
+
+**Last Updated | 最后更新**: 2025-12-31
+**Framework Version | 框架版本**: 1.3.6
+**Build Number | 构建编号**: 251025471

package/dist/libs/rabbitmq/DistributedEvents.d.ts

@@ -1,7 +1,5 @@
 import EventEmitter from 'eventemitter3';
-export type RabbitMQConfig = {
-    connection: string;
-};
+import { RabbitMQConfig } from './RabbitMQConfig';
 export declare class DistributedEvents extends EventEmitter {
     private logger;
     private channel;

package/dist/libs/rabbitmq/DistributedEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DistributedEvents.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEvents.ts"],"names":[],"mappings":"AAuHA,OAAO,YAAY,MAAM,eAAe,CAAC;AA6BzC,MAAM,MAAM,cAAc,GAAG;IAc3B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAoKF,qBACa,iBAAkB,SAAQ,YAAY;IAOjD,OAAO,CAAC,MAAM,CAAuC;IAqBrD,OAAO,CAAC,OAAO,CAAe;IAe9B,OAAO,CAAC,SAAS,CAAS;WA6Eb,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM;IAkJrD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE;IA4JpB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IA4FvC,KAAK;CAGZ"}
+{"version":3,"file":"DistributedEvents.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEvents.ts"],"names":[],"mappings":"AAuHA,OAAO,YAAY,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAoKlD,qBACa,iBAAkB,SAAQ,YAAY;IAOjD,OAAO,CAAC,MAAM,CAAuC;IAqBrD,OAAO,CAAC,OAAO,CAAe;IAe9B,OAAO,CAAC,SAAS,CAAS;WA6Eb,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM;IAkJrD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE;IA4JpB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IA4FvC,KAAK;CAGZ"}

package/dist/libs/rabbitmq/DistributedEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"DistributedEvents.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEvents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DistributedEvents.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEvents.ts"],"names":[],"mappings":"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"}

package/dist/libs/rabbitmq/DistributedEventsLoader.d.ts

@@ -2,6 +2,7 @@ import { MicroframeworkSettings } from 'microframework';
 import { ClassType } from '../type';
 export type DistributedEventsLoaderOption = {
     eventsHandlers?: ClassType[];
+    useReliable?: boolean;
 };
 export declare const rabbitmqLoader: (option: DistributedEventsLoaderOption) => (settings?: MicroframeworkSettings) => Promise<void>;
 //# sourceMappingURL=DistributedEventsLoader.d.ts.map

package/dist/libs/rabbitmq/DistributedEventsLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DistributedEventsLoader.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEventsLoader.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAapC,MAAM,MAAM,6BAA6B,GAAG;IA2B1C,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;CAC9B,CAAC;AAsFF,eAAO,MAAM,cAAc,GAAI,QAAQ,6BAA6B,MAAM,WAAW,sBAAsB,kBAgC1G,CAAC"}
+{"version":3,"file":"DistributedEventsLoader.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEventsLoader.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAepC,MAAM,MAAM,6BAA6B,GAAG;IA2B1C,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;IAoD7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAsFF,eAAO,MAAM,cAAc,GAAI,QAAQ,6BAA6B,MAAM,WAAW,sBAAsB,kBAgD1G,CAAC"}

package/dist/libs/rabbitmq/DistributedEventsLoader.js

@@ -6,6 +6,7 @@ const logger_1 = require("../logger");
 const configure_1 = require("../configure");
 const EventsManager_1 = require("./EventsManager");
 const DistributedEvents_1 = require("./DistributedEvents");
+const ReliableDistributedEvents_1 = require("./ReliableDistributedEvents");
 const rabbitmqLoader = (option) => (settings) => {
     const appCfg = configure_1.ConfigManager.getConfig('application');
     const rabbitmqCfg = configure_1.ConfigManager.getConfig('rabbitmq');
@@ -14,11 +15,20 @@ const rabbitmqLoader = (option) => (settings) => {
         logger.warn('⚠️  RabbitMQ configuration not found, skipping RabbitMQ initialization');
         return Promise.resolve();
     }
-    return DistributedEvents_1.DistributedEvents.open(rabbitmqCfg, appCfg.appName).then((events) => {
-        typedi_1.Container.set(DistributedEvents_1.DistributedEvents, events);
+    const EventsClass = option.useReliable ? ReliableDistributedEvents_1.ReliableDistributedEvents : DistributedEvents_1.DistributedEvents;
+    const versionName = option.useReliable ? 'Reliable' : 'Standard';
+    logger.info(`📦 Using ${versionName} version of DistributedEvents`);
+    return EventsClass.open(rabbitmqCfg, appCfg.appName).then((events) => {
+        if (option.useReliable) {
+            typedi_1.Container.set(ReliableDistributedEvents_1.ReliableDistributedEvents, events);
+            typedi_1.Container.set(DistributedEvents_1.DistributedEvents, events);
+        }
+        else {
+            typedi_1.Container.set(DistributedEvents_1.DistributedEvents, events);
+        }
         settings?.onShutdown(async () => events.close());
         return EventsManager_1.EventsManager.start(events, option.eventsHandlers).then(() => {
-            logger_1.Logger.getLogger('RabbitmqLoader').info(`✅  RabbitMQ - Connected to ${rabbitmqCfg.connection}`);
+            logger.info(`✅  RabbitMQ (${versionName}) - Connected to ${rabbitmqCfg.connection}`);
         });
     });
 };

package/dist/libs/rabbitmq/DistributedEventsLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"DistributedEventsLoader.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEventsLoader.ts"],"names":[],"mappings":";;;AAyCA,mCAAmC;AACnC,sCAAmC;AAEnC,4CAAgE;AAChE,mDAAgD;AAChD,2DAAwE;AA4HjE,MAAM,cAAc,GAAG,CAAC,MAAqC,EAAE,EAAE,CAAC,CAAC,QAAiC,EAAE,EAAE;IAG7G,MAAM,MAAM,GAAG,yBAAa,CAAC,SAAS,CAAoB,aAAa,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,yBAAa,CAAC,SAAS,CAAiB,UAAU,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,eAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAGlD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAID,OAAO,qCAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAGzE,kBAAS,CAAC,GAAG,CAAC,qCAAiB,EAAE,MAAM,CAAC,CAAC;QAIzC,QAAQ,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAIjD,OAAO,6BAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAGlE,eAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,8BAA8B,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAhCW,QAAA,cAAc,kBAgCzB"}
+{"version":3,"file":"DistributedEventsLoader.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/DistributedEventsLoader.ts"],"names":[],"mappings":";;;AAyCA,mCAAmC;AACnC,sCAAmC;AAEnC,4CAAgE;AAChE,mDAAgD;AAChD,2DAAwD;AACxD,2EAAwE;AAiLjE,MAAM,cAAc,GAAG,CAAC,MAAqC,EAAE,EAAE,CAAC,CAAC,QAAiC,EAAE,EAAE;IAG7G,MAAM,MAAM,GAAG,yBAAa,CAAC,SAAS,CAAoB,aAAa,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,yBAAa,CAAC,SAAS,CAAiB,UAAU,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,eAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAGlD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAID,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,qDAAyB,CAAC,CAAC,CAAC,qCAAiB,CAAC;IACvF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAEjE,MAAM,CAAC,IAAI,CAAC,YAAY,WAAW,+BAA+B,CAAC,CAAC;IAIpE,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAGnE,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAEvB,kBAAS,CAAC,GAAG,CAAC,qDAAyB,EAAE,MAAmC,CAAC,CAAC;YAG9E,kBAAS,CAAC,GAAG,CAAC,qCAAiB,EAAE,MAAa,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YAEN,kBAAS,CAAC,GAAG,CAAC,qCAAiB,EAAE,MAA2B,CAAC,CAAC;QAChE,CAAC;QAID,QAAQ,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAIjD,OAAO,6BAAa,CAAC,KAAK,CAAC,MAAa,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAGzE,MAAM,CAAC,IAAI,CAAC,gBAAgB,WAAW,oBAAoB,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAhDW,QAAA,cAAc,kBAgDzB"}

package/dist/libs/rabbitmq/EventsManager.d.ts

@@ -1,5 +1,7 @@
 import { DistributedEvents } from './DistributedEvents';
+import { ReliableDistributedEvents } from './ReliableDistributedEvents';
 import { ClassType } from '../type';
+type AnyDistributedEvents = DistributedEvents | ReliableDistributedEvents;
 export type DistributedEventListener = {
     clazz: ClassType;
     method: string;
@@ -12,6 +14,7 @@ export declare class EventsManager {
     static readonly registry: Registry;
     private logger;
     static addDistributedEventListener(event: string, listener: DistributedEventListener): void;
-    static start(de: DistributedEvents, listeners?: ClassType[]): Promise<void>;
+    static start(de: AnyDistributedEvents, listeners?: ClassType[]): Promise<void>;
 }
+export {};
 //# sourceMappingURL=EventsManager.d.ts.map

package/dist/libs/rabbitmq/EventsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventsManager.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/EventsManager.ts"],"names":[],"mappings":"AA+CA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAUpC,MAAM,MAAM,wBAAwB,GAAG;IASrC,KAAK,EAAE,SAAS,CAAC;IAUjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA0BF,MAAM,WAAW,QAAQ;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,wBAAwB,CAAC,CAAC;CAClD;AAuDD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,IAC3B,QAAQ,GAAG,EAAE,aAAa,MAAM,UAMzC;AAaD,qBAAa,aAAa;IAYxB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAM;IAMxC,OAAO,CAAC,MAAM,CAAmC;IA0BjD,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;WAoE9E,KAAK,CAAC,EAAE,EAAE,iBAAiB,EAAE,SAAS,GAAE,SAAS,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA2CtF"}
+{"version":3,"file":"EventsManager.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/EventsManager.ts"],"names":[],"mappings":"AA+CA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAapC,KAAK,oBAAoB,GAAG,iBAAiB,GAAG,yBAAyB,CAAC;AAU1E,MAAM,MAAM,wBAAwB,GAAG;IASrC,KAAK,EAAE,SAAS,CAAC;IAUjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA0BF,MAAM,WAAW,QAAQ;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,wBAAwB,CAAC,CAAC;CAClD;AAuDD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,IAC3B,QAAQ,GAAG,EAAE,aAAa,MAAM,UAMzC;AAaD,qBAAa,aAAa;IAYxB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAM;IAMxC,OAAO,CAAC,MAAM,CAAmC;IA0BjD,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;WA6E9E,KAAK,CAAC,EAAE,EAAE,oBAAoB,EAAE,SAAS,GAAE,SAAS,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA2CzF"}

package/dist/libs/rabbitmq/EventsManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventsManager.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/EventsManager.ts"],"names":[],"mappings":";;;AAkKA,0BAOC;AA3HD,mCAAmC;AAEnC,sCAAmC;AAkHnC,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,EAAE;QAC1C,aAAa,CAAC,2BAA2B,CAAC,KAAK,EAAE;YAC/C,KAAK,EAAE,MAAM,CAAC,WAAW;YACzB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAaD,MAAa,aAAa;IAA1B;QAkBU,WAAM,GAAG,eAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAyInD,CAAC;IA/GC,MAAM,CAAC,2BAA2B,CAAC,KAAa,EAAE,QAAkC;QAGlF,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChD,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QAID,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IA0DD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAqB,EAAE,YAAyB,EAAE;QAGnE,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAGnC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAE3C,IAAI,IAAI,EAAE,CAAC;gBAGT,KAAK,OAAO,CAAC,GAAG,CACd,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oBAGf,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;oBAExD,IAAI,IAAI,EAAE,CAAC;wBAGT,MAAM,QAAQ,GAAG,kBAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBAIrC,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;oBACpC,CAAC;oBAED,OAAO,SAAS,CAAC;gBACnB,CAAC,CAAC,CACH,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBAGZ,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QAIH,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;;AA1JH,sCA2JC;AA/IiB,sBAAQ,GAAa,EAAE,AAAf,CAAgB"}
+{"version":3,"file":"EventsManager.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/EventsManager.ts"],"names":[],"mappings":";;;AAgLA,0BAOC;AAzID,mCAAmC;AAGnC,sCAAmC;AA+HnC,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,EAAE;QAC1C,aAAa,CAAC,2BAA2B,CAAC,KAAK,EAAE;YAC/C,KAAK,EAAE,MAAM,CAAC,WAAW;YACzB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAaD,MAAa,aAAa;IAA1B;QAkBU,WAAM,GAAG,eAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAkJnD,CAAC;IAxHC,MAAM,CAAC,2BAA2B,CAAC,KAAa,EAAE,QAAkC;QAGlF,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChD,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;QAID,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAmED,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAwB,EAAE,YAAyB,EAAE;QAGtE,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAGnC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAE3C,IAAI,IAAI,EAAE,CAAC;gBAGT,KAAK,OAAO,CAAC,GAAG,CACd,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oBAGf,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;oBAExD,IAAI,IAAI,EAAE,CAAC;wBAGT,MAAM,QAAQ,GAAG,kBAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBAIrC,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;oBACpC,CAAC;oBAED,OAAO,SAAS,CAAC;gBACnB,CAAC,CAAC,CACH,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBAGZ,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QAIH,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;;AAnKH,sCAoKC;AAxJiB,sBAAQ,GAAa,EAAE,AAAf,CAAgB"}

package/dist/libs/rabbitmq/RabbitMQConfig.d.ts

@@ -0,0 +1,4 @@
+export type RabbitMQConfig = {
+    connection: string;
+};
+//# sourceMappingURL=RabbitMQConfig.d.ts.map

package/dist/libs/rabbitmq/RabbitMQConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RabbitMQConfig.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/RabbitMQConfig.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,cAAc,GAAG;IAc3B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/libs/rabbitmq/RabbitMQConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=RabbitMQConfig.js.map

package/dist/libs/rabbitmq/RabbitMQConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RabbitMQConfig.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/RabbitMQConfig.ts"],"names":[],"mappings":""}

package/dist/libs/rabbitmq/ReliableDistributedEvents.d.ts

@@ -0,0 +1,21 @@
+import amqp from 'amqplib';
+import EventEmitter from 'eventemitter3';
+import { RabbitMQConfig } from './RabbitMQConfig';
+export declare class ReliableDistributedEvents extends EventEmitter {
+    private logger;
+    private channel;
+    private queueName;
+    static open(config: RabbitMQConfig, queueName: string): Promise<ReliableDistributedEvents>;
+    sub(events: string[]): Promise<void>;
+    pub<T = unknown>(event: string, data: T, options?: {
+        retries?: number;
+        retryDelay?: number;
+    }): Promise<boolean>;
+    pubBatch<T = unknown>(events: Array<{
+        event: string;
+        data: T;
+    }>): Promise<boolean[]>;
+    setupReturnHandler(handler: (msg: amqp.Message) => void): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ReliableDistributedEvents.d.ts.map

package/dist/libs/rabbitmq/ReliableDistributedEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReliableDistributedEvents.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/ReliableDistributedEvents.ts"],"names":[],"mappings":"AAmIA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,YAAY,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA2KlD,qBACa,yBAA0B,SAAQ,YAAY;IAOzD,OAAO,CAAC,MAAM,CAA+C;IAqB7D,OAAO,CAAC,OAAO,CAAsB;IAerC,OAAO,CAAC,SAAS,CAAS;WA6Eb,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM;IAkJrD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE;IA6KpB,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,OAAO,CAAC;IAgHb,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAyG1F,kBAAkB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,GAAG,IAAI;IAoFxD,KAAK;CAmBZ"}

package/dist/libs/rabbitmq/ReliableDistributedEvents.js

@@ -0,0 +1,157 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var ReliableDistributedEvents_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReliableDistributedEvents = void 0;
+const amqplib_1 = __importDefault(require("amqplib"));
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+const typedi_1 = require("typedi");
+const logger_1 = require("../logger");
+const EVENTS_EXCHANGE = 'BizEvents';
+const DEAD_LETTER_EXCHANGE = 'BizEventDeadLetter';
+const DEAD_LETTER_QUEUE = 'DeadLetters';
+const DEAD_LETTER_ROUTING_KEY = 'DeadLetter';
+let ReliableDistributedEvents = ReliableDistributedEvents_1 = class ReliableDistributedEvents extends eventemitter3_1.default {
+    constructor() {
+        super(...arguments);
+        this.logger = logger_1.Logger.getLogger(ReliableDistributedEvents_1);
+    }
+    static async open(config, queueName) {
+        const conn = await amqplib_1.default.connect(config.connection);
+        const channel = await conn.createConfirmChannel();
+        const events = new ReliableDistributedEvents_1();
+        events.channel = channel;
+        events.queueName = queueName;
+        await channel.assertExchange(DEAD_LETTER_EXCHANGE, 'direct', {
+            durable: true,
+        });
+        await channel.assertQueue(queueName, {
+            durable: true,
+            arguments: {
+                'x-dead-letter-exchange': DEAD_LETTER_EXCHANGE,
+                'x-dead-letter-routing-key': DEAD_LETTER_ROUTING_KEY,
+            },
+        });
+        await channel.assertQueue(DEAD_LETTER_QUEUE, {
+            durable: true,
+        });
+        await channel.assertExchange(EVENTS_EXCHANGE, 'topic', {
+            durable: true,
+        });
+        await channel.bindQueue(DEAD_LETTER_QUEUE, DEAD_LETTER_EXCHANGE, DEAD_LETTER_ROUTING_KEY);
+        return events;
+    }
+    async sub(events) {
+        await Promise.all(events.map((event) => this.channel.bindQueue(this.queueName, EVENTS_EXCHANGE, event)));
+        void this.channel.consume(this.queueName, (msg) => {
+            if (msg) {
+                const eventName = msg?.properties?.headers['x-eventName'];
+                const content = msg.content.toString();
+                const data = JSON.parse(content);
+                try {
+                    this.logger.debug(`Received event: ${eventName}, Content: ${content}`);
+                    this.emit('RemoteEvent', eventName, data);
+                    this.channel.ack(msg);
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    this.logger.debug(`Message rejected: ${eventName} with error: ${errorMessage}`);
+                    this.channel.reject(msg, !msg.fields.redelivered);
+                }
+            }
+        });
+    }
+    async pub(event, data, options) {
+        const maxRetries = options?.retries ?? 3;
+        const retryDelay = options?.retryDelay ?? 1000;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                this.channel.publish(EVENTS_EXCHANGE, event, Buffer.from(JSON.stringify(data)), {
+                    contentEncoding: 'UTF-8',
+                    contentType: 'text/json',
+                    deliveryMode: 2,
+                    headers: {
+                        'x-eventName': event,
+                    },
+                    mandatory: true,
+                });
+                await this.channel.waitForConfirms();
+                this.logger.debug(`✅ Event published successfully: ${event}`);
+                return true;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.logger.error(`❌ Failed to publish event (attempt ${attempt}/${maxRetries}): ${event} - ${errorMessage}`);
+                if (attempt < maxRetries) {
+                    this.logger.debug(`⏳ Retrying in ${retryDelay}ms...`);
+                    await new Promise((resolve) => setTimeout(resolve, retryDelay));
+                }
+                else {
+                    throw new Error(`Failed to publish event '${event}' after ${maxRetries} attempts: ${errorMessage}`);
+                }
+            }
+        }
+        return false;
+    }
+    async pubBatch(events) {
+        try {
+            for (const item of events) {
+                this.channel.publish(EVENTS_EXCHANGE, item.event, Buffer.from(JSON.stringify(item.data)), {
+                    contentEncoding: 'UTF-8',
+                    contentType: 'text/json',
+                    deliveryMode: 2,
+                    headers: {
+                        'x-eventName': item.event,
+                    },
+                    mandatory: true,
+                });
+            }
+            await this.channel.waitForConfirms();
+            this.logger.debug(`✅ Batch published ${events.length} events successfully`);
+            return events.map(() => true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`❌ Failed to batch publish ${events.length} events: ${errorMessage}`);
+            throw error;
+        }
+    }
+    setupReturnHandler(handler) {
+        this.channel.on('return', (msg) => {
+            const eventName = msg.properties?.headers?.['x-eventName'] || 'unknown';
+            const details = JSON.stringify({
+                exchange: msg.fields.exchange,
+                routingKey: msg.fields.routingKey,
+                replyText: msg.fields.replyText,
+            });
+            this.logger.error(`⚠️  Message returned (no route): ${eventName} - ${details}`);
+            handler(msg);
+        });
+    }
+    async close() {
+        try {
+            this.logger.debug('Waiting for pending message confirmations before closing...');
+            await this.channel.waitForConfirms();
+            this.logger.debug('All pending confirmations received');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Error waiting for confirmations before close: ${errorMessage}`);
+        }
+        await this.channel.close();
+        this.logger.debug('RabbitMQ channel closed successfully');
+    }
+};
+exports.ReliableDistributedEvents = ReliableDistributedEvents;
+exports.ReliableDistributedEvents = ReliableDistributedEvents = ReliableDistributedEvents_1 = __decorate([
+    (0, typedi_1.Service)()
+], ReliableDistributedEvents);
+//# sourceMappingURL=ReliableDistributedEvents.js.map

package/dist/libs/rabbitmq/ReliableDistributedEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReliableDistributedEvents.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/ReliableDistributedEvents.ts"],"names":[],"mappings":"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"}

package/dist/libs/rabbitmq/index.d.ts

@@ -1,4 +1,6 @@
 export * from './DistributedEvents';
 export * from './DistributedEventsLoader';
 export * from './EventsManager';
+export * from './RabbitMQConfig';
+export * from './ReliableDistributedEvents';
 //# sourceMappingURL=index.d.ts.map

package/dist/libs/rabbitmq/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC"}

package/dist/libs/rabbitmq/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./DistributedEvents"), exports);
 __exportStar(require("./DistributedEventsLoader"), exports);
 __exportStar(require("./EventsManager"), exports);
+__exportStar(require("./RabbitMQConfig"), exports);
+__exportStar(require("./ReliableDistributedEvents"), exports);
 //# sourceMappingURL=index.js.map

package/dist/libs/rabbitmq/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,sDAAoC;AACpC,4DAA0C;AAC1C,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/libs/rabbitmq/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,sDAAoC;AACpC,4DAA0C;AAC1C,kDAAgC;AAChC,mDAAiC;AACjC,8DAA4C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaias/basenode",
-  "version": "1.3.6",
+  "version": "1.3.9",
   "buildNumber": 251025471,
   "description": "API development framework for NodeJs",
   "author": "FOT",