# Changelog

## 2.2.0

### Minor Changes

- build
- build

### Patch Changes

- Updated dependencies
- Updated dependencies
  - koatty_exception@2.2.0
  - koatty_core@2.2.0
  - koatty_container@3.0.0
  - koatty_graphql@2.0.0
  - koatty_lib@1.5.0
  - koatty_logger@3.0.0
  - koatty_proto@2.0.0
  - koatty_validation@3.0.0

## 2.1.11

### Patch Changes

- build
- Updated dependencies
  - koatty_exception@2.1.10
  - koatty_core@2.1.10
  - koatty_container@2.0.10
  - koatty_graphql@1.1.10
  - koatty_lib@1.4.10
  - koatty_logger@2.8.6
  - koatty_proto@1.3.10
  - koatty_validation@2.0.8

## 2.1.10

### Patch Changes

- build
- Updated dependencies
  - koatty_container@2.0.8
  - koatty_core@2.1.9
  - koatty_exception@2.1.9
  - koatty_validation@2.0.8

## 2.1.9

### Patch Changes

- Updated dependencies
  - koatty_container@2.0.7
  - koatty_core@2.1.8
  - koatty_exception@2.1.8
  - koatty_validation@2.0.7

## 2.1.8

### Patch Changes

- Updated dependencies
  - koatty_lib@1.4.8
  - koatty_container@2.0.6
  - koatty_core@2.1.7
  - koatty_exception@2.1.7
  - koatty_graphql@1.1.8
  - koatty_logger@2.8.4
  - koatty_proto@1.3.8
  - koatty_validation@2.0.6

## 2.1.7

### Patch Changes

- Updated dependencies
  - koatty_graphql@1.1.7

## 2.1.6

### Patch Changes

- Updated dependencies
  - koatty_container@2.0.6
  - koatty_core@2.1.6
  - koatty_exception@2.1.6
  - koatty_validation@2.0.6

## 2.1.5

### Patch Changes

- Updated dependencies
  - koatty_container@2.0.5
  - koatty_graphql@1.1.6
  - koatty_lib@1.4.7
  - koatty_logger@2.8.3
  - koatty_proto@1.3.7
  - koatty_validation@2.0.5
  - koatty_core@2.1.5
  - koatty_exception@2.1.5

## 2.1.4

### Patch Changes

- Updated dependencies
  - koatty_logger@2.8.2
  - koatty_container@2.0.4
  - koatty_core@2.1.4
  - koatty_exception@2.1.4
  - koatty_validation@2.0.4

## 2.1.3

### Patch Changes

- Updated dependencies
- Updated dependencies
  - koatty_container@2.0.3
  - koatty_core@2.1.3
  - koatty_exception@2.1.3
  - koatty_validation@2.0.3

## 2.1.2

### Patch Changes

- patch version bump for koatty, koatty_cacheable, koatty_config, koatty_container, koatty_core, koatty_exception, koatty_graphql, koatty_lib, koatty_loader, koatty_logger, koatty_proto, koatty_router, koatty_schedule, koatty_serve, koatty_store, koatty_trace, koatty_typeorm, koatty_validation
- Updated dependencies
  - koatty_container@2.0.2
  - koatty_core@2.1.2
  - koatty_exception@2.1.2
  - koatty_graphql@1.1.5
  - koatty_lib@1.4.6
  - koatty_logger@2.4.2
  - koatty_proto@1.3.6
  - koatty_validation@2.0.2

## 2.1.1

### Patch Changes

- Updated dependencies
  - koatty_container@2.0.1
  - koatty_logger@2.4.1
  - koatty_core@2.1.1
  - koatty_exception@2.1.1
  - koatty_validation@2.0.1

## 2.1.0

### Minor Changes

- build

### Patch Changes

- Updated dependencies
  - koatty_container@2.0.0
  - koatty_core@2.1.0
  - koatty_exception@2.1.0
  - koatty_logger@2.4.0
  - koatty_validation@2.0.0

## 2.0.9

### Patch Changes

- build
- Updated dependencies
  - koatty_container@1.17.4
  - koatty_core@2.0.14
  - koatty_exception@2.0.10
  - koatty_graphql@1.1.4
  - koatty_lib@1.4.5
  - koatty_logger@2.3.4
  - koatty_proto@1.3.5
  - koatty_validation@1.6.6

## 2.0.8

### Patch Changes

- build
- Updated dependencies
  - koatty_container@1.17.3
  - koatty_core@2.0.13
  - koatty_exception@2.0.9
  - koatty_graphql@1.1.3
  - koatty_lib@1.4.4
  - koatty_logger@2.3.3
  - koatty_proto@1.3.4
  - koatty_validation@1.6.5

## 2.0.7

### Patch Changes

- Updated dependencies
  - koatty_container@1.17.2
  - koatty_graphql@1.1.2
  - koatty_lib@1.4.3
  - koatty_logger@2.3.2
  - koatty_proto@1.3.3
  - koatty_validation@1.6.4
  - koatty_core@2.0.12
  - koatty_exception@2.0.8

## 2.0.6

### Patch Changes

- Updated dependencies
  - koatty_proto@1.3.2

## 2.0.5

### Patch Changes

- Updated dependencies
  - koatty_lib@1.4.2
  - koatty_container@1.17.1
  - koatty_core@2.0.11
  - koatty_exception@2.0.7
  - koatty_graphql@1.1.1
  - koatty_logger@2.3.1
  - koatty_proto@1.3.1
  - koatty_validation@1.6.3

## 2.0.4

### Patch Changes

- build
- build
- Updated dependencies
- Updated dependencies
  - koatty_core@2.0.10
  - koatty_exception@2.0.6
  - koatty_validation@1.6.2

## 2.0.3

### Patch Changes

- init
- Updated dependencies
  - koatty_core@2.0.9
  - koatty_exception@2.0.5

All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.

### [2.0.2](https://github.com/koatty/koatty_router/compare/koatty-router@2.0.1...koatty-router@2.0.2) (2025-10-25)

### Features

- **trace:** enhance tracing with timeout handling and status checks ([caa6a10](https://github.com/koatty/koatty_router/commit/caa6a10d0d82064567f1a3f8f3146f28a7b7398d))

### Bug Fixes

- **koatty-serve:** 修复不稳定的时间相关测试 ([cf2d6b5](https://github.com/koatty/koatty_router/commit/cf2d6b5754a56217df1b912faf7cd40b01dbcbdc))
- **koatty-trace:** 修复 ESLint 错误和测试 mock 问题 ([b24e1f9](https://github.com/koatty/koatty_router/commit/b24e1f9dcc55c64f5d97f3ca01bc53161e7bdb7c))

### 2.0.1 (2025-10-25)

### ⚠ BREAKING CHANGES

- **scripts:** - Tag 格式从 v{version} 改为 {package-name}@{version}

### Features

- add examples directory with basic-app example ([ef49c6f](https://github.com/koatty/koatty_router/commit/ef49c6f932b88ba947fc4c7f448d91b016e3e020))
- improve type safety in compress middleware ([61beb1d](https://github.com/koatty/koatty_router/commit/61beb1d206bebfd5f6fec9a2d1297f420be217a2))
- **koatty_core:** upgrade to Koa 3.0 ([fe246ad](https://github.com/koatty/koatty_router/commit/fe246ad773521b6117d212378b07faa30abd17e0))
- **koatty_router:** migrate from koa-graphql to graphql-http ([847821a](https://github.com/koatty/koatty_router/commit/847821ac80109c6f4fd953e0701ad695e4fb771f))
- make exception context fields optional and improve trace handling ([e0ec4db](https://github.com/koatty/koatty_router/commit/e0ec4db1ba7299b1d22018558f61288cb2564dc6))
- **release:** add release guide and automation script ([c5f01b1](https://github.com/koatty/koatty_router/commit/c5f01b17765a9b1eeb07c448b27be5ade9278569))
- update sync script to use HTTPS instead of SSH for package repos ([91c9fd7](https://github.com/koatty/koatty_router/commit/91c9fd74f080685cb2e8fab66e4765cbf86be57c))
- upgrade to Koa 3.0 (WIP) ([d14114c](https://github.com/koatty/koatty_router/commit/d14114c63d0f62fcd3a64296cbb6648ec1ee1e83))

### Bug Fixes

- **koatty_core:** attempt to fix test timeouts ([fb197ea](https://github.com/koatty/koatty_router/commit/fb197eab7d193616ed4255753c22df0b400c1bc6))
- resolve workspace dependencies in build process ([d8a2661](https://github.com/koatty/koatty_router/commit/d8a266123fee1dea8ea7be6a39401bf0c052688b))
- **scripts:** 修复 monorepo 中 tag 冲突问题 ([d2602bc](https://github.com/koatty/koatty_router/commit/d2602bcc8c245e6f2137a678ec0e5e2fd6ef673a))
- **scripts:** 增强 release 脚本的验证和调试信息 ([2e0db49](https://github.com/koatty/koatty_router/commit/2e0db499234bd4f132bbfc65559105fd9f98f926))
- 解决依赖问题以支持 Koa 3.0 升级 ([30cf0b5](https://github.com/koatty/koatty_router/commit/30cf0b53ed032c7de5ea24b4c2ed965e8d4948df))

## [2.0.0] (2025-03-16)

### 🚀 Major Performance and Memory Optimizations

This is a major release focusing on **performance**, **memory efficiency**, and **code quality improvements** beyond the v1.20.0-8 optimizations.

#### Breaking Changes

- **Removed deprecated `validatorFuncs`**: All validators must now be pre-compiled at startup time. This ensures consistent performance and eliminates runtime validation overhead.
- **Strict validator compilation**: Applications will fail to start if any validator fails to compile, ensuring all validation is optimized.

#### Memory Optimizations

- **Pre-computed error message prefixes**: Error messages in validators are now partially pre-computed at compilation time, reducing string concatenation overhead (~10% reduction in string allocations)
- **Optimized closure captures**: Reduced memory captured by closures in compiled validators
- **Removed object pooling**: Initially implemented object pooling for `ParamSource` but removed due to concurrency safety concerns. Direct object creation is safer and performs well with V8's generational GC optimization for short-lived objects

#### Performance Improvements

- **Stricter compilation requirements**: All validation rules must compile successfully, eliminating fallback paths
- **Reduced runtime checks**: Removed all deprecated code paths for cleaner and faster execution
- **Better error reporting**: Compilation failures now provide clear error messages with parameter names and indices

#### Code Quality

- **Removed 54 lines of deprecated code**: Cleaner codebase with single optimized path
- **Removed built-in performance statistics**: Eliminated ~60 lines of code with concurrency issues. Use external monitoring tools (Prometheus, StatsD, OpenTelemetry) for production metrics
- **Enhanced error handling**: Better diagnostics when validators fail to compile
- **Updated test suite**: All tests updated to reflect v2.0.0 requirements
- **Improved concurrency safety**: All shared state is now immutable or properly isolated

#### Migration Guide from v1.x

**If upgrading from v1.20.0-8 or earlier:**

1. **Validator Compilation**: Ensure all validation rules are compatible with pre-compilation
   - Custom validation functions must be pure functions
   - All `ValidRules` references must exist in `FunctionValidator`

2. **Error Handling**: Applications will now fail at startup (not runtime) if validators cannot compile
   - Check application startup logs for compilation errors
   - Fix any custom validators that throw during compilation

3. **No API Changes**: All public APIs remain the same - this is a drop-in replacement for most applications

### 📊 Performance Comparison

```
v1.20.0-8 vs v2.0.0:
- Memory allocations:  -10% (pre-computed strings)
- Startup time:        +5% (stricter validation)
- Runtime performance: +10% (removed fallback paths)
- Code quality:        Improved (removed 54 lines, concurrency-safe)
```

### ✅ Validation

- 354 tests passing (100%)
- Zero deprecated code paths
- All validators pre-compiled successfully

---

## [1.20.0-8] (2025-03-16)

### 🚀 Performance Improvements

This release focuses on significant performance optimizations for parameter validation and extraction, achieving **70-90% overall performance improvement** without breaking API compatibility.

#### Stage 1-3: Parameter Validation Optimization (50-70% improvement)

- **Pre-compiled validators**: Validation rules are now compiled at startup time instead of runtime
- **Pre-compiled type converters**: Type conversion functions are generated once and reused
- **Pre-compiled options**: Parameter options objects are created at startup to avoid runtime allocations
- **Fast-path detection**: Methods without validation can skip the validation pipeline entirely
- **Zero-copy optimization**: String parameters without validation/conversion use direct references

#### Stage 4: Parameter Extraction Optimization (additional 20% improvement)

- **Enum-based parameter routing** (`ParamSourceType`): ~30% faster than string-based conditionals
- **Sync/async path separation**: Pure synchronous parameters avoid Promise overhead (~40% faster)
- **Unified parameter extractors**: Singleton pattern enables V8 monomorphic optimization
- **Pre-compiled extractors**: Direct property access eliminates runtime conditionals (~25% faster)
- **Default value support**: Decorators now accept optional default values

#### Performance Benchmarks

```
Query Parameter Extraction:  0.240ms/req (1000 iterations)
Mixed Parameters:            0.167ms/req (1000 iterations)
Enum-Based Extraction:       0.063ms/req (2000 iterations)
Overall Throughput:          7764 req/s
Average Response Time:       0.132ms/req
```

### ✨ New Features

- **Default values for decorators**: All parameter decorators now support optional default values
  ```typescript
  async getUsers(
    @Get('page', 1) page: number,          // Defaults to 1 if not provided
    @Get('limit', 10) limit: number,       // Defaults to 10
    @Header('lang', 'en') lang: string     // Defaults to 'en'
  ) { ... }
  ```

### 🔧 Internal Improvements

- Added `ParamSourceType` enum for type-safe parameter source identification
- Added `CompiledMethodParams` interface with optimization flags
- Added `generatePrecompiledExtractor` for startup-time extractor generation
- Added `extractValueSync` for synchronous parameter extraction
- Enhanced `ParamMetadata` interface with optimization fields:
  - `sourceType`: Parameter source identification
  - `paramName`: Explicit parameter name for extraction
  - `extractorType`: Unified extractor type
  - `precompiledExtractor`: Pre-generated extraction function
  - `defaultValue`: Optional default value
  - `compiledValidator`: Pre-compiled validation function
  - `compiledTypeConverter`: Pre-compiled type conversion function
  - `precompiledOptions`: Pre-created options object

### 📝 Documentation

- Comprehensive JSDoc comments for all new functions
- Performance annotations explaining optimization techniques
- Migration guide for deprecated functions
- Code examples demonstrating best practices

### ⚠️ Deprecations

- `validatorFuncs`: Deprecated in favor of pre-compiled validators (to be removed in v2.0.0)

### 🔄 Backward Compatibility

✅ **100% backward compatible** - No breaking changes to public API

- Existing decorators work without modification
- Old metadata formats are automatically upgraded
- Default value parameter is optional in all decorators

### 📊 Test Coverage

- 354 tests passing (25 test suites)
- Added 60+ new tests for optimization features
- Performance benchmark suite included
- Code coverage: 56% statements, 48% branches

### [1.10.1](https://github.com/koatty/koatty_router/compare/v1.10.0...v1.10.1) (2024-11-29)

### Bug Fixes

- mix router binding ([b4cfa9c](https://github.com/koatty/koatty_router/commit/b4cfa9c10dcbfb77aed4be262b84f875f61d9568))

## [1.10.0](https://github.com/koatty/koatty_router/compare/v1.10.0-0...v1.10.0) (2024-11-07)

## [1.10.0-0](https://github.com/koatty/koatty_router/compare/v1.9.2...v1.10.0-0) (2024-10-31)

### Performance

- 优化 ([50f4729](https://github.com/koatty/koatty_router/commit/50f4729e128ed57db3282e89ffe69f2d99f34e64))

### [1.9.2](https://github.com/koatty/koatty_router/compare/v1.9.1...v1.9.2) (2024-03-15)

### Bug Fixes

- controller 方法执行结果错误对象拦截 ([1536793](https://github.com/koatty/koatty_router/commit/1536793e89c5af2aa2114c71eef4c155b627da01))

### [1.9.1](https://github.com/koatty/koatty_router/compare/v1.9.0...v1.9.1) (2024-03-15)

### Bug Fixes

- injectParamMetaData 参数传递错误 ([c2f91c4](https://github.com/koatty/koatty_router/commit/c2f91c4d825c5ba573f56360f3113636d58a3dd3))

## [1.9.0](https://github.com/koatty/koatty_router/compare/v1.9.0-2...v1.9.0) (2024-01-16)

## [1.9.0-2](https://github.com/koatty/koatty_router/compare/v1.9.0-1...v1.9.0-2) (2024-01-15)

## [1.9.0-1](https://github.com/koatty/koatty_router/compare/v1.8.6...v1.9.0-1) (2024-01-15)

### [1.8.11-0](https://github.com/koatty/koatty_router/compare/v1.8.6...v1.8.11-0) (2024-01-15)

### [1.8.6](https://github.com/koatty/koatty_router/compare/v1.8.5...v1.8.6) (2023-02-17)

### Bug Fixes

- convert param types ([46f5e80](https://github.com/koatty/koatty_router/commit/46f5e80a6bd35d6b77e20fa36fe46971f67be0b9))

### [1.8.5](https://github.com/koatty/koatty_router/compare/v1.8.4...v1.8.5) (2023-02-17)

### Bug Fixes

- 修复 dto 参数类型转换 ([7fd8f64](https://github.com/koatty/koatty_router/commit/7fd8f642c8094e2f93ce1cd50bb91b56043e71d3))

### [1.8.4](https://github.com/koatty/koatty_router/compare/v1.8.3...v1.8.4) (2023-02-10)

### [1.8.3](https://github.com/koatty/koatty_router/compare/v1.8.2...v1.8.3) (2023-02-10)

### Bug Fixes

- koa's redirect function not available ([8b5dde5](https://github.com/koatty/koatty_router/commit/8b5dde52870f5b331cb8da8881c0774875a79ef2))
- words ([06d2803](https://github.com/koatty/koatty_router/commit/06d28038a9140e509b9bd3bb083ee2503d2b0f75))

### [1.8.2](https://github.com/koatty/koatty_router/compare/v1.8.0...v1.8.2) (2023-01-13)

## [1.8.0](https://github.com/koatty/koatty_router/compare/v1.7.12...v1.8.0) (2022-11-12)

### Bug Fixes

- httpRouter 与 wsRouter 使用了错误的加载方式 ([94d111c](https://github.com/koatty/koatty_router/commit/94d111cc321d80b3098a3abcb999ca64d0cc4f95))

### [1.7.12](https://github.com/koatty/koatty_router/compare/v1.7.10...v1.7.12) (2022-11-01)

### Bug Fixes

- ctx.body 赋值 ([2a8d8c8](https://github.com/koatty/koatty_router/commit/2a8d8c8d4e8615777f50dc4ccaf331e4f10bc66b))

### [1.7.10](https://github.com/koatty/koatty_router/compare/v1.7.9...v1.7.10) (2022-10-31)

### [1.7.9](https://github.com/koatty/koatty_router/compare/v1.7.8...v1.7.9) (2022-08-19)

### Bug Fixes

- querystring must be convert type ([1bec352](https://github.com/koatty/koatty_router/commit/1bec3528a4f29d398a3158a25bcab4824e483433))

### [1.7.8](https://github.com/koatty/koatty_router/compare/v1.7.7...v1.7.8) (2022-08-19)

### [1.7.7](https://github.com/koatty/koatty_router/compare/v1.7.6...v1.7.7) (2022-08-19)

### Bug Fixes

- 移除强制类型转换，增加类型检查 ([199fa8d](https://github.com/koatty/koatty_router/commit/199fa8d16a3a8bc271f445e8a39a7e760afa982b))

### [1.7.6](https://github.com/koatty/koatty_router/compare/v1.7.5...v1.7.6) (2022-05-27)

### [1.7.5](https://github.com/koatty/koatty_router/compare/v1.7.4...v1.7.5) (2022-03-14)

### [1.7.4](https://github.com/koatty/koatty_router/compare/v1.7.3...v1.7.4) (2022-03-14)

### [1.7.3](https://github.com/koatty/koatty_router/compare/v1.7.2...v1.7.3) (2022-03-09)

### [1.7.2](https://github.com/koatty/koatty_router/compare/v1.7.1...v1.7.2) (2022-02-25)

### [1.7.1](https://github.com/koatty/koatty_router/compare/v1.7.0...v1.7.1) (2022-02-23)

## [1.7.0](https://github.com/koatty/koatty_router/compare/v1.7.0-1...v1.7.0) (2022-02-21)

## [1.7.0-1](https://github.com/koatty/koatty_router/compare/v1.7.0-0...v1.7.0-1) (2022-02-18)

## [1.7.0-0](https://github.com/koatty/koatty_router/compare/v1.6.6...v1.7.0-0) (2022-02-18)

### [1.6.6](https://github.com/koatty/koatty_router/compare/v1.6.4...v1.6.6) (2022-02-16)

### [1.6.4](https://github.com/koatty/koatty_router/compare/v1.6.4-1...v1.6.4) (2021-12-23)

### [1.6.4-1](https://github.com/koatty/koatty_router/compare/v1.6.4-0...v1.6.4-1) (2021-12-22)

### [1.6.4-0](https://github.com/koatty/koatty_router/compare/v1.6.2...v1.6.4-0) (2021-12-21)

### [1.6.2](https://github.com/koatty/koatty_router/compare/v1.6.0...v1.6.2) (2021-12-20)

## [1.6.0](https://github.com/koatty/koatty_router/compare/v1.5.16...v1.6.0) (2021-12-19)