@navios/core 1.0.0-alpha.2 → 1.0.0-alpha.4

package/CHANGELOG.md

@@ -5,6 +5,96 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-alpha.4] - 2026-01-09
+
+### Added
+
+- **Unified Adapter Architecture**: New abstract adapter system supporting multiple adapter types (HTTP, CLI, etc.)
+  - `AbstractAdapterInterface` - Base interface for all adapters with lifecycle methods (`setupAdapter`, `onModulesInit`, `ready`, `dispose`)
+  - `AdapterEnvironment` - Base interface for adapter environments with type-safe options
+  - `HttpAdapterEnvironment` - Extended environment interface for HTTP adapters with server, CORS, multipart, and listen options types
+  - `DefaultAdapterEnvironment` - Default environment with unknown types for generic usage
+  - `AdapterToken` - New injection token for accessing the current adapter instance
+  - `AdapterFactory` - Factory for creating adapter instances from environment definitions
+- **Type-Safe Application Generic**: `NaviosApplication<TEnvironment>` now accepts an environment type parameter
+  - All adapter-specific methods (`configure`, `enableCors`, `enableMultipart`, `listen`, `getServer`) are now properly typed based on the environment
+  - Environment types provide IntelliSense for adapter-specific options
+- **Enhanced Plugin System**: Plugins are now typed with adapter constraints
+  - `NaviosPlugin<TOptions, TAdapter>` - Second type parameter for adapter-specific plugins
+  - `PluginContext<TAdapter>` - Typed context with adapter access
+  - Plugins can access `context.adapter` instead of `context.server` for better type safety
+- **Module Custom Entries**: New `customEntries` property on `ModuleMetadata` for adapter-specific module data
+  - Allows adapters to store custom metadata on modules (e.g., commands for CLI adapter)
+- **Console Logger Tests**: Added comprehensive test suite for `ConsoleLoggerService`
+
+### Changed
+
+- **Renamed Environment Methods**: `getHttpToken` renamed to `getToken` for adapter-agnostic naming
+- **Renamed Environment Property**: `httpTokens` renamed to `tokens` in environment definitions
+- **Application Configuration**: New `configure()` method replaces `setupHttpServer()` for pre-init configuration
+  - Configuration options are merged with adapter defaults
+  - Must be called before `init()` for options to take effect
+- **Plugin Context**: `PluginContext.server` replaced with `PluginContext.adapter` for accessing the adapter instance
+  - Use `context.adapter.getServer()` for HTTP server access
+  - `context.globalPrefix` removed; use `context.adapter.getGlobalPrefix()` instead
+- **Abstract HTTP Adapter**: `AbstractHttpAdapterInterface` now extends `AbstractAdapterInterface`
+  - Added `configure(options)` method for pre-init configuration
+  - Method signatures updated for environment-based typing
+
+### Breaking Changes
+
+- **Environment Definition Format**: `httpTokens` property renamed to `tokens`
+  - Before: `{ httpTokens: new Map([...]) }`
+  - After: `{ tokens: new Map([...]) }`
+- **Plugin Context API**: `context.server` and `context.globalPrefix` removed
+  - Before: `const server = context.server`
+  - After: `const server = context.adapter.getServer()`
+  - Before: `const prefix = context.globalPrefix`
+  - After: `const prefix = context.adapter.getGlobalPrefix()`
+- **Application Setup**: `setupHttpServer()` replaced with `configure()`
+  - Before: `await app.setupHttpServer({ logger: true })`
+  - After: `app.configure({ logger: true }); await app.init()`
+
+### Dependencies
+
+- Updated to support unified adapter architecture across all packages
+
+## [1.0.0-alpha.3] - 2026-01-08
+
+### Added
+
+- **Abstract Handler Adapter Base Class**: New `AbstractHandlerAdapterService` base class for HTTP handler adapters
+  - Provides shared logic for controller resolution (singleton vs request-scoped)
+  - Automatic sync/async detection for argument formatting
+  - Standardized handler generation with static/dynamic branching
+  - Supports all adapter types: endpoint, stream, and multipart
+- **New Handler Adapter Types**: Exported types for adapter implementations
+  - `ArgumentGetterFn<TRequest>` - Function type for extracting data from requests
+  - `FormatArgumentsFn<TRequest>` - Function type for formatting arguments
+  - `AbstractStaticHandler<TRequest, TReply>` - Static handler type for singleton controllers
+  - `AbstractDynamicHandler<TRequest, TReply>` - Dynamic handler type for request-scoped controllers
+  - `AbstractHandlerResult<TRequest, TReply>` - Union type for handler results
+  - `HandlerContext<TConfig>` - Context passed to handler creation methods
+- **Enhanced Handler Adapter Interface**: Extended `AbstractHttpHandlerAdapterInterface` with new optional methods
+  - `buildFormatArguments()` - Builds optimized formatArguments function from getters
+  - `hasSchema()` - Checks if handler has validation schemas
+  - `provideSchema()` - Provides schema information for framework registration
+
+### Changed
+
+- **Legacy-Compat DI Re-exports**: `Injectable`, `Factory`, `createClassContext`, and `createMethodContext` are now re-exported from `@navios/di/legacy-compat` instead of being defined locally
+  - Removes code duplication between core and di packages
+  - Ensures consistent behavior across the framework
+
+### Removed
+
+- **Local DI Decorators**: Removed local `Injectable` and `Factory` decorator implementations from legacy-compat (now imported from `@navios/di/legacy-compat`)
+- **Context Compat Module**: Removed `context-compat.mts` module (functionality moved to `@navios/di`)
+
+### Dependencies
+
+- Updated to support `@navios/di` with legacy-compat exports
+
 ## [1.0.0-alpha.2] - 2026-01-07
 
 ### Added