@smounters/imperium 1.1.0 → 1.1.2

package/README.md

@@ -1,41 +1,24 @@
 # @smounters/imperium
 
-`@smounters/imperium` is **inspired by NestJS** and provides a modular DI-first runtime for TypeScript services using Fastify + ConnectRPC + WebSocket.
+NestJS-inspired modular DI framework for TypeScript services. Unified HTTP + ConnectRPC + WebSocket server on a single Fastify instance.
 
-It is designed for teams that want Nest-like architecture but with explicit control over runtime wiring and exported API surface.
+## Features
 
-## Key Features
+- **Module system** with `@Module`, `@Injectable`, guards, pipes, interceptors, filters
+- **HTTP controllers** with `@HttpController`, `@Get`, `@Post`, `@Body`, `@Query`, `@Param`
+- **ConnectRPC** with `@RpcService`, `@RpcMethod` (unary + server streaming)
+- **WebSocket gateway** with `@WsGateway`, `@WsHandler`, message routing, lifecycle hooks
+- **Request-scoped DI** via AsyncLocalStorage (tsyringe-based)
+- **Typed config** via Zod + `ConfigService`
+- **Structured logging** via tslog + `LoggerService`
 
-- Nest-like modules and decorators (`@Module`, `@Injectable`, guards/pipes/interceptors/filters).
-- Unified HTTP + RPC + WebSocket server on one Fastify instance.
-- Server streaming RPC via `async function*` (delivered as SSE in browsers).
-- WebSocket gateway with message routing, lifecycle hooks, and guards at connection time.
-- Request-scoped handler execution.
-- Typed runtime config via `zod` + `ConfigService`.
-- Built-in `LoggerService` (tslog-based).
-- Global enhancer tokens (`APP_GUARD`, `APP_PIPE`, `APP_INTERCEPTOR`, `APP_FILTER`).
-- Multi-provider array injection (`InjectAll`) and manual array resolution (`resolveAll`).
-
-## Public Imports
-
-Root import is intentionally disabled.
-
-Use subpaths only:
-
-- `@smounters/imperium/core`
-- `@smounters/imperium/decorators`
-- `@smounters/imperium/services`
-- `@smounters/imperium/pipes`
-- `@smounters/imperium/validation`
-- `@smounters/imperium/ws`
-
-## Installation
+## Install
 
 ```bash
-pnpm add @smounters/imperium reflect-metadata tsyringe fastify @connectrpc/connect @connectrpc/connect-fastify zod
+pnpm add @smounters/imperium reflect-metadata tsyringe fastify @connectrpc/connect @connectrpc/connect-fastify zod tslog
 ```
 
-TypeScript requirements:
+TypeScript config requires:
 
 ```json
 {
@@ -46,220 +29,78 @@ TypeScript requirements:
 }
 ```
 
-Entry point must import metadata:
-
-```ts
-import "reflect-metadata";
-```
-
 ## Quick Start
 
 ```ts
 import "reflect-metadata";
-
 import { Application } from "@smounters/imperium/core";
 import { Body, HttpController, Injectable, Module, Post } from "@smounters/imperium/decorators";
 
 @Injectable()
-class AuthService {
-  signIn(email: string) {
-    return { ok: true, email };
+class GreetService {
+  greet(name: string) {
+    return { message: `Hello, ${name}` };
   }
 }
 
-@HttpController("/auth")
-class AuthHttpController {
-  constructor(private readonly authService: AuthService) {}
+@HttpController("/api")
+class ApiController {
+  constructor(private readonly greetService: GreetService) {}
 
-  @Post("/sign-in")
-  signIn(@Body("email") email: string) {
-    return this.authService.signIn(email);
+  @Post("/greet")
+  greet(@Body("name") name: string) {
+    return this.greetService.greet(name);
   }
 }
 
 @Module({
-  providers: [AuthService],
-  httpControllers: [AuthHttpController],
+  providers: [GreetService],
+  httpControllers: [ApiController],
 })
 class AppModule {}
 
-const app = new Application(AppModule, {
-  host: "0.0.0.0",
-  accessLogs: true,
-});
-
-await app.start({ port: 3000 });
-```
-
-## Recommended Bootstrap Flow
-
-```ts
-import { Application } from "@smounters/imperium/core";
-import { ConfigService, LoggerService } from "@smounters/imperium/services";
-import { appConfigSchema, type AppConfig } from "@smounters/imperium/validation";
-
-const app = new Application(AppModule, {
-  host: "0.0.0.0",
-  accessLogs: true,
-});
-
-app.configureConfig(appConfigSchema, process.env);
-
-const config = app.resolve(ConfigService<AppConfig>).getAll();
-
-app.configureLogger({
-  name: "backend",
-  minLevel: 3,
-});
-
-await app.start({
-  port: config.APP_PORT,
-  prefix: config.APP_GLOBAL_PREFIX,
-});
-
-app.resolve(LoggerService).info({ event: "app.started", port: config.APP_PORT });
+await new Application(AppModule).start({ port: 3000 });
 ```
 
-If your app needs extra config fields, extend the exported base schema:
-
-```ts
-import { appConfigSchema } from "@smounters/imperium/validation";
-import { z } from "zod";
-
-const projectConfigSchema = appConfigSchema.extend({
-  REDIS_URL: z.url(),
-});
-```
-
-## Multi Providers
-
-```ts
-import { InjectAll, Injectable, Module } from "@smounters/imperium/decorators";
-
-const AML_RULES = Symbol("AML_RULES");
-
-@Module({
-  providers: [
-    { provide: AML_RULES, multi: true, useClass: SanctionsRule },
-    { provide: AML_RULES, multi: true, useClass: MixerRule },
-    { provide: AML_RULES, multi: true, useClass: FreshAddressRule },
-  ],
-  exports: [AML_RULES],
-})
-class AmlModule {}
-
-@Injectable()
-class AmlEngine {
-  constructor(@InjectAll(AML_RULES) private readonly rules: AmlRule[]) {}
-}
-```
-
-Manual resolution is also available:
-
-```ts
-const rules = app.resolveAll<AmlRule>(AML_RULES);
-```
-
-## HTTP and RPC
-
-Use decorators from `@smounters/imperium/decorators`:
-
-- HTTP: `HttpController`, `Get`, `Post`, `Put`, `Patch`, `Delete`, `Body`, `Query`, `Param`, `Header`, `Req`, `Res`
-- RPC: `RpcService`, `RpcMethod`, `RpcData`, `RpcContext`, `RpcHeaders`, `RpcHeader`, `RpcAbortSignal`
-- WebSocket: `WsGateway`, `WsHandler`, `WsConnection`, `WsMessage`, `WsRequest`
-
-Imperium auto-detects registered HTTP/RPC/WebSocket handlers and serves all protocols from one server.
-
 ## WebSocket
 
 ```ts
-import { WsGateway, WsHandler, WsConnection, WsMessage, Module } from "@smounters/imperium/decorators";
+import { WsGateway, WsHandler, WsConnection, WsMessage } from "@smounters/imperium/decorators";
 import type { WsGatewayLifecycle } from "@smounters/imperium/ws";
 import type { WebSocket } from "@fastify/websocket";
 
 @WsGateway("/ws")
-class ChatGateway implements WsGatewayLifecycle {
+class EventsGateway implements WsGatewayLifecycle {
   private clients = new Set<WebSocket>();
 
   onConnection(socket: WebSocket) { this.clients.add(socket); }
   onDisconnect(socket: WebSocket) { this.clients.delete(socket); }
 
-  @WsHandler("message")
-  onMessage(@WsConnection() ws: WebSocket, @WsMessage() data: { text: string }) {
-    const msg = JSON.stringify({ type: "message", data });
-    for (const client of this.clients) {
-      if (client.readyState === 1) client.send(msg);
-    }
+  @WsHandler("ping")
+  onPing(@WsConnection() ws: WebSocket) {
+    ws.send(JSON.stringify({ type: "pong" }));
   }
 }
-
-@Module({ providers: [ChatGateway] })
-class AppModule {}
 ```
 
 Requires optional peer dependency: `pnpm add @fastify/websocket`
 
-## Services
-
-From `@smounters/imperium/services`:
-
-- `ConfigService`
-- `LoggerService`
-
-## Pipes and Validation
-
-- `ZodPipe` from `@smounters/imperium/pipes`
-- validation helpers from `@smounters/imperium/validation`
-  - `appConfigSchema`
-  - `AppConfig`
-  - `booleanSchema`
-  - `numberSchema`
-  - `nativeEnumSchema`
-  - `stringArraySchema`
-  - `enumArraySchema`
-
-## Error Classes
-
-From `@smounters/imperium/core`:
+## Import Paths
 
-- `HttpException`
-- `BadRequestException`
-- `UnauthorizedException`
-- `ForbiddenException`
-- `NotFoundException`
-- `InternalServerErrorException`
+No root import. Use subpaths:
 
-## Documentation
-
-Full docs (VitePress) are located in:
-
-- `docs`
-
-Local docs commands:
-
-```bash
-pnpm run docs:dev
-pnpm run docs:build
-```
-
-GitHub Pages deployment is configured via `.github/workflows/publish.yml`.
-
-## Publish to npm
-
-```bash
-pnpm install
-pnpm run typecheck
-pnpm run build
-pnpm publish --access public --no-git-checks
+```ts
+import { Application } from "@smounters/imperium/core";
+import { Module, Injectable, HttpController, Get } from "@smounters/imperium/decorators";
+import { ConfigService, LoggerService } from "@smounters/imperium/services";
+import { ZodPipe } from "@smounters/imperium/pipes";
+import { appConfigSchema } from "@smounters/imperium/validation";
+import { registerWsGateways } from "@smounters/imperium/ws";
 ```
 
-Automated npm publishing workflow:
-
-- `.github/workflows/publish.yml`
-
-Required secret:
+## Documentation
 
-- `NPM_TOKEN`
+Full guide and API reference: **[smounters.github.io/imperium](https://smounters.github.io/imperium/)**
 
 ## License
 

package/dist/core/app-tokens.d.ts

@@ -1,4 +1,4 @@
-import type { ExceptionFilterLike, GuardLike, InjectionToken, InterceptorLike, PipeLike } from "../types";
+import type { ExceptionFilterLike, GuardLike, InjectionToken, InterceptorLike, PipeLike } from "../types.js";
 export declare const APP_GUARD: InjectionToken<GuardLike>;
 export declare const APP_INTERCEPTOR: InjectionToken<InterceptorLike>;
 export declare const APP_PIPE: InjectionToken<PipeLike>;

package/dist/core/application.d.ts

@@ -1,7 +1,7 @@
 import type { FastifyInstance } from "fastify";
-import type { InjectionToken, LoggerOptions, ModuleImport, ServerOptions } from "../types";
+import type { InjectionToken, LoggerOptions, ModuleImport, ServerOptions } from "../types.js";
 import type { ZodType, output } from "zod";
-import { AppContainer } from "./container";
+import { AppContainer } from "./container.js";
 export declare class Application {
     private static readonly DEFAULT_SHUTDOWN_SIGNALS;
     private static readonly DEFAULT_SHUTDOWN_TIMEOUT_MS;

package/dist/core/application.js

@@ -1,5 +1,5 @@
-import { AppContainer } from "./container";
-import { startServer } from "./server";
+import { AppContainer } from "./container.js";
+import { startServer } from "./server.js";
 export class Application {
     static { this.DEFAULT_SHUTDOWN_SIGNALS = ["SIGINT", "SIGTERM"]; }
     static { this.DEFAULT_SHUTDOWN_TIMEOUT_MS = 15_000; }

package/dist/core/container.d.ts

@@ -1,8 +1,8 @@
 import "reflect-metadata";
 import { type DependencyContainer } from "tsyringe";
-import type { Constructor, ExceptionFilterLike, GuardLike, InjectionToken, InterceptorLike, LoggerOptions, ModuleImport, PipeLike } from "../types";
+import type { Constructor, ExceptionFilterLike, GuardLike, InjectionToken, InterceptorLike, LoggerOptions, ModuleImport, PipeLike } from "../types.js";
 import type { ZodType, output } from "zod";
-import { type AppLogger } from "./logger";
+import { type AppLogger } from "./logger.js";
 export declare class AppContainer {
     private readonly root;
     private readonly loadedModules;

package/dist/core/container.js

@@ -1,13 +1,13 @@
 import "reflect-metadata";
 import { container, Lifecycle } from "tsyringe";
 import { AsyncLocalStorage } from "node:async_hooks";
-import { MODULE_KEY } from "../decorators/di.decorators";
-import { WS_GATEWAY_KEY } from "../decorators/ws.decorators";
-import { ConfigService, LoggerService } from "../services";
-import { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from "./app-tokens";
-import { CONFIG_TOKEN } from "./config";
-import { createLogger, LOGGER_TOKEN } from "./logger";
-import { Reflector } from "./reflector";
+import { MODULE_KEY } from "../decorators/di.decorators.js";
+import { WS_GATEWAY_KEY } from "../decorators/ws.decorators.js";
+import { ConfigService, LoggerService } from "../services/index.js";
+import { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from "./app-tokens.js";
+import { CONFIG_TOKEN } from "./config.js";
+import { createLogger, LOGGER_TOKEN } from "./logger.js";
+import { Reflector } from "./reflector.js";
 function isDynamicModule(value) {
     return typeof value === "object" && value !== null && "module" in value && typeof value.module === "function";
 }
@@ -229,7 +229,7 @@ export class AppContainer {
             return provider.useValue;
         }
         if ("useFactory" in provider) {
-            return provider.useFactory(moduleRef.container);
+            return (provider).useFactory(moduleRef.container);
         }
         if ("useExisting" in provider) {
             return moduleRef.container.resolve(provider.useExisting);
@@ -281,7 +281,7 @@ export class AppContainer {
         }
         if ("useFactory" in provider) {
             moduleRef.container.register(provider.provide, {
-                useFactory: (dc) => provider.useFactory(dc),
+                useFactory: (dc) => (provider).useFactory(dc),
             });
             return;
         }
@@ -467,9 +467,7 @@ export class AppContainer {
     }
     loadModule(moduleImport) {
         const moduleRef = this.loadModuleRef(moduleImport);
-        if (!this.rootModuleRef) {
-            this.rootModuleRef = moduleRef;
-        }
+        this.rootModuleRef ??= moduleRef;
     }
     resolve(token) {
         if (this.root.isRegistered(token, false)) {

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-export { Application } from "./application";
-export { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from "./app-tokens";
-export { BadRequestException, ForbiddenException, HttpException, InternalServerErrorException, NotFoundException, UnauthorizedException, } from "./errors";
-export { Reflector } from "./reflector";
-export type * from "../types";
+export { Application } from "./application.js";
+export { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from "./app-tokens.js";
+export { BadRequestException, ForbiddenException, HttpException, InternalServerErrorException, NotFoundException, UnauthorizedException, } from "./errors.js";
+export { Reflector } from "./reflector.js";
+export type * from "../types.js";

package/dist/core/index.js

@@ -1,4 +1,4 @@
-export { Application } from "./application";
-export { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from "./app-tokens";
-export { BadRequestException, ForbiddenException, HttpException, InternalServerErrorException, NotFoundException, UnauthorizedException, } from "./errors";
-export { Reflector } from "./reflector";
+export { Application } from "./application.js";
+export { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_PIPE } from "./app-tokens.js";
+export { BadRequestException, ForbiddenException, HttpException, InternalServerErrorException, NotFoundException, UnauthorizedException, } from "./errors.js";
+export { Reflector } from "./reflector.js";

package/dist/core/logger.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from "tslog";
-import type { LoggerOptions } from "../types";
+import type { LoggerOptions } from "../types.js";
 type LoggerPayload = Record<string, unknown>;
 export type AppLogger = Logger<LoggerPayload>;
 export declare const LOGGER_TOKEN: unique symbol;

package/dist/core/reflector.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import type { MetadataKey } from "../types";
+import type { MetadataKey } from "../types.js";
 type MetadataTarget = object | Function | undefined;
 export declare class Reflector {
     get<T = unknown>(metadataKey: MetadataKey, target: MetadataTarget): T | undefined;

package/dist/core/reflector.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import "reflect-metadata";
-import { Injectable } from "../decorators/di.decorators";
+import { Injectable } from "../decorators/di.decorators.js";
 let Reflector = class Reflector {
     get(metadataKey, target) {
         if (!target) {

package/dist/core/server.d.ts

@@ -1,7 +1,7 @@
 import "reflect-metadata";
 import { type FastifyInstance } from "fastify";
-import type { ServerOptions } from "../types";
-import { AppContainer } from "./container";
+import type { ServerOptions } from "../types.js";
+import { AppContainer } from "./container.js";
 type LegacyServerOptions = ServerOptions & {
     di: AppContainer;
 };

package/dist/core/server.js

@@ -2,12 +2,12 @@ import "reflect-metadata";
 import { fastifyConnectPlugin } from "@connectrpc/connect-fastify";
 import fastifyCors from "@fastify/cors";
 import Fastify from "fastify";
-import { HTTP_ROUTES_KEY } from "../decorators/http.decorators";
-import { RPC_METHODS_KEY, RPC_SERVICE_KEY } from "../decorators/rpc.decorators";
-import { registerHttpRoutes } from "../http";
-import { buildConnectRoutes } from "../rpc";
-import { registerWsGateways } from "../ws";
-import { AppContainer } from "./container";
+import { HTTP_ROUTES_KEY } from "../decorators/http.decorators.js";
+import { RPC_METHODS_KEY, RPC_SERVICE_KEY } from "../decorators/rpc.decorators.js";
+import { registerHttpRoutes } from "../http/index.js";
+import { buildConnectRoutes } from "../rpc/index.js";
+import { registerWsGateways } from "../ws/index.js";
+import { AppContainer } from "./container.js";
 function normalizePrefix(prefix) {
     if (!prefix) {
         return "";
@@ -179,9 +179,10 @@ export async function startServer(diOrOptions, options) {
         const corsConfig = resolveCors(cors);
         const effectiveHttpPrefix = mergePrefixes(prefix, httpPrefix);
         const effectiveRpcPrefix = mergePrefixes(prefix, rpcPrefix);
-        server.addHook("onRequest", async (req) => {
+        server.addHook("onRequest", (req, _reply, done) => {
             const request = req;
             request.requestStartAt = Date.now();
+            done();
         });
         server.addHook("onResponse", async (req, reply) => {
             const request = req;

package/dist/decorators/di.decorators.d.ts

@@ -1,6 +1,6 @@
 import "reflect-metadata";
 import { inject, injectAll, injectable, Lifecycle } from "tsyringe";
-import type { InjectionToken, ModuleMeta } from "../types";
+import type { InjectionToken, ModuleMeta } from "../types.js";
 export declare const MODULE_KEY: unique symbol;
 export declare function Module(meta: ModuleMeta): ClassDecorator;
 export declare const Injectable: typeof injectable;

package/dist/decorators/filters.decorators.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import type { Constructor, ExceptionFilterLike } from "../types";
+import type { Constructor, ExceptionFilterLike } from "../types.js";
 export declare const FILTERS_KEY: unique symbol;
 export declare const CATCH_EXCEPTIONS_KEY: unique symbol;
 export declare function UseFilters(...filters: ExceptionFilterLike[]): ClassDecorator & MethodDecorator;

package/dist/decorators/filters.decorators.js

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { Injectable } from "./di.decorators";
-import { appendArrayMetadata } from "./metadata.decorators";
+import { Injectable } from "./di.decorators.js";
+import { appendArrayMetadata } from "./metadata.decorators.js";
 export const FILTERS_KEY = Symbol("filters");
 export const CATCH_EXCEPTIONS_KEY = Symbol("filter:exceptions");
 export function UseFilters(...filters) {

package/dist/decorators/guards.decorators.d.ts

@@ -1,4 +1,4 @@
 import "reflect-metadata";
-import type { GuardLike } from "../types";
+import type { GuardLike } from "../types.js";
 export declare const GUARDS_KEY: unique symbol;
 export declare function UseGuards(...guards: GuardLike[]): ClassDecorator & MethodDecorator;

package/dist/decorators/guards.decorators.js

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { appendArrayMetadata } from "./metadata.decorators";
+import { appendArrayMetadata } from "./metadata.decorators.js";
 export const GUARDS_KEY = Symbol("guards");
 export function UseGuards(...guards) {
     return (target, propertyKey) => {

package/dist/decorators/http.decorators.js

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { Injectable } from "./di.decorators";
+import { Injectable } from "./di.decorators.js";
 export const HTTP_ROUTES_KEY = Symbol("http:routes");
 export const HTTP_CONTROLLER_KEY = Symbol("http:controller");
 export const PARAMS_KEY = Symbol("http:params");

package/dist/decorators/index.d.ts

@@ -1,9 +1,9 @@
-export { Inject, InjectAll, Injectable, Module, Optional, Scope } from "./di.decorators";
-export { Catch, UseFilters } from "./filters.decorators";
-export { UseGuards } from "./guards.decorators";
-export { Body, Delete, Get, Header, HttpController, Param, Patch, Post, Put, Query, Req, Res } from "./http.decorators";
-export { UseInterceptors } from "./interceptors.decorators";
-export { SetMetadata } from "./metadata.decorators";
-export { UsePipes } from "./pipes.decorators";
-export { RpcAbortSignal, RpcContext, RpcData, RpcHeader, RpcHeaders, RpcMethod, RpcService } from "./rpc.decorators";
-export { WsConnection, WsGateway, WsHandler, WsMessage, WsRequest } from "./ws.decorators";
+export { Inject, InjectAll, Injectable, Module, Optional, Scope } from "./di.decorators.js";
+export { Catch, UseFilters } from "./filters.decorators.js";
+export { UseGuards } from "./guards.decorators.js";
+export { Body, Delete, Get, Header, HttpController, Param, Patch, Post, Put, Query, Req, Res } from "./http.decorators.js";
+export { UseInterceptors } from "./interceptors.decorators.js";
+export { SetMetadata } from "./metadata.decorators.js";
+export { UsePipes } from "./pipes.decorators.js";
+export { RpcAbortSignal, RpcContext, RpcData, RpcHeader, RpcHeaders, RpcMethod, RpcService } from "./rpc.decorators.js";
+export { WsConnection, WsGateway, WsHandler, WsMessage, WsRequest } from "./ws.decorators.js";

package/dist/decorators/index.js

@@ -1,9 +1,9 @@
-export { Inject, InjectAll, Injectable, Module, Optional, Scope } from "./di.decorators";
-export { Catch, UseFilters } from "./filters.decorators";
-export { UseGuards } from "./guards.decorators";
-export { Body, Delete, Get, Header, HttpController, Param, Patch, Post, Put, Query, Req, Res } from "./http.decorators";
-export { UseInterceptors } from "./interceptors.decorators";
-export { SetMetadata } from "./metadata.decorators";
-export { UsePipes } from "./pipes.decorators";
-export { RpcAbortSignal, RpcContext, RpcData, RpcHeader, RpcHeaders, RpcMethod, RpcService } from "./rpc.decorators";
-export { WsConnection, WsGateway, WsHandler, WsMessage, WsRequest } from "./ws.decorators";
+export { Inject, InjectAll, Injectable, Module, Optional, Scope } from "./di.decorators.js";
+export { Catch, UseFilters } from "./filters.decorators.js";
+export { UseGuards } from "./guards.decorators.js";
+export { Body, Delete, Get, Header, HttpController, Param, Patch, Post, Put, Query, Req, Res } from "./http.decorators.js";
+export { UseInterceptors } from "./interceptors.decorators.js";
+export { SetMetadata } from "./metadata.decorators.js";
+export { UsePipes } from "./pipes.decorators.js";
+export { RpcAbortSignal, RpcContext, RpcData, RpcHeader, RpcHeaders, RpcMethod, RpcService } from "./rpc.decorators.js";
+export { WsConnection, WsGateway, WsHandler, WsMessage, WsRequest } from "./ws.decorators.js";

package/dist/decorators/interceptors.decorators.d.ts

@@ -1,4 +1,4 @@
 import "reflect-metadata";
-import type { InterceptorLike } from "../types";
+import type { InterceptorLike } from "../types.js";
 export declare const INTERCEPTORS_KEY: unique symbol;
 export declare function UseInterceptors(...inters: InterceptorLike[]): ClassDecorator & MethodDecorator;

package/dist/decorators/interceptors.decorators.js

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { appendArrayMetadata } from "./metadata.decorators";
+import { appendArrayMetadata } from "./metadata.decorators.js";
 export const INTERCEPTORS_KEY = Symbol("interceptors");
 export function UseInterceptors(...inters) {
     return (target, propertyKey) => {

package/dist/decorators/metadata.decorators.d.ts

@@ -1,4 +1,4 @@
 import "reflect-metadata";
-import type { MetadataKey } from "../types";
+import type { MetadataKey } from "../types.js";
 export declare function SetMetadata<T = unknown>(metadataKey: MetadataKey, metadataValue: T): ClassDecorator & MethodDecorator;
 export declare function appendArrayMetadata<T>(metadataKey: MetadataKey, values: readonly T[], target: object, propertyKey?: string | symbol): void;

package/dist/decorators/pipes.decorators.d.ts

@@ -1,4 +1,4 @@
 import "reflect-metadata";
-import type { PipeLike } from "../types";
+import type { PipeLike } from "../types.js";
 export declare const PIPES_KEY: unique symbol;
 export declare function UsePipes(...pipes: PipeLike[]): ClassDecorator & MethodDecorator;

package/dist/decorators/pipes.decorators.js

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { appendArrayMetadata } from "./metadata.decorators";
+import { appendArrayMetadata } from "./metadata.decorators.js";
 export const PIPES_KEY = Symbol("pipes");
 export function UsePipes(...pipes) {
     return (target, propertyKey) => {

package/dist/decorators/rpc.decorators.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import type { RpcMethodDescriptor, RpcServiceDescriptor } from "../core/types";
+import type { RpcMethodDescriptor, RpcServiceDescriptor } from "../core/types.js";
 export declare const RPC_SERVICE_KEY: unique symbol;
 export declare const RPC_METHODS_KEY: unique symbol;
 export declare const RPC_PARAMS_KEY: unique symbol;

package/dist/decorators/rpc.decorators.js

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { Injectable } from "./di.decorators";
+import { Injectable } from "./di.decorators.js";
 export const RPC_SERVICE_KEY = Symbol("rpc:service");
 export const RPC_METHODS_KEY = Symbol("rpc:methods");
 export const RPC_PARAMS_KEY = Symbol("rpc:params");

package/dist/decorators/ws.decorators.js

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { Injectable } from "./di.decorators";
+import { Injectable } from "./di.decorators.js";
 export const WS_GATEWAY_KEY = Symbol("ws:gateway");
 export const WS_HANDLERS_KEY = Symbol("ws:handlers");
 export const WS_PARAMS_KEY = Symbol("ws:params");

package/dist/http/adapter.d.ts

@@ -1,4 +1,4 @@
 import type { FastifyReply, FastifyRequest } from "fastify";
-import type { AppContainer } from "../core/container";
-import type { Constructor } from "../types";
+import type { AppContainer } from "../core/container.js";
+import type { Constructor } from "../types.js";
 export declare function createHttpHandler<TController extends Record<string, unknown>>(app: AppContainer, controller: Constructor<TController>, methodName: keyof TController & string): (req: FastifyRequest, reply: FastifyReply) => Promise<void>;

package/dist/http/adapter.js

@@ -1,8 +1,8 @@
-import { LoggerService } from "../services";
-import { ForbiddenException, toHttpError } from "../core/errors";
-import { CATCH_EXCEPTIONS_KEY } from "../decorators/filters.decorators";
-import { PARAMS_KEY } from "../decorators/http.decorators";
-import { collectFiltersForHttp, collectGuardsForHttp, collectInterceptorsForHttp, collectPipesForHttp } from "./utils";
+import { LoggerService } from "../services/index.js";
+import { ForbiddenException, toHttpError } from "../core/errors.js";
+import { CATCH_EXCEPTIONS_KEY } from "../decorators/filters.decorators.js";
+import { PARAMS_KEY } from "../decorators/http.decorators.js";
+import { collectFiltersForHttp, collectGuardsForHttp, collectInterceptorsForHttp, collectPipesForHttp } from "./utils.js";
 function logHttpError(app, scope, details, error) {
     try {
         scope.resolve(LoggerService).error(details, error);

package/dist/http/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./adapter";
-export * from "./router-builder";
-export * from "./utils";
+export * from "./adapter.js";
+export * from "./router-builder.js";
+export * from "./utils.js";

package/dist/http/index.js

@@ -1,3 +1,3 @@
-export * from "./adapter";
-export * from "./router-builder";
-export * from "./utils";
+export * from "./adapter.js";
+export * from "./router-builder.js";
+export * from "./utils.js";

package/dist/http/router-builder.d.ts

@@ -1,4 +1,4 @@
 import type { FastifyInstance } from "fastify";
 import "reflect-metadata";
-import type { AppContainer } from "../core/container";
+import type { AppContainer } from "../core/container.js";
 export declare function registerHttpRoutes(server: FastifyInstance, di: AppContainer, globalPrefix?: string): void;

package/dist/http/router-builder.js

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { HTTP_CONTROLLER_KEY, HTTP_ROUTES_KEY } from "../decorators/http.decorators";
-import { createHttpHandler } from "./adapter";
+import { HTTP_CONTROLLER_KEY, HTTP_ROUTES_KEY } from "../decorators/http.decorators.js";
+import { createHttpHandler } from "./adapter.js";
 function joinUrlPath(...segments) {
     const parts = segments
         .map((segment) => segment.trim())

package/dist/http/utils.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import type { Constructor, ExceptionFilterLike, GuardLike, InterceptorLike, PipeLike } from "../types";
+import type { Constructor, ExceptionFilterLike, GuardLike, InterceptorLike, PipeLike } from "../types.js";
 export declare function collectGuardsForHttp(controller: Constructor, method: string, global: GuardLike[]): GuardLike[];
 export declare function collectInterceptorsForHttp(controller: Constructor, method: string, global: InterceptorLike[]): InterceptorLike[];
 export declare function collectPipesForHttp(controller: Constructor, method: string, global: PipeLike[]): PipeLike[];

package/dist/http/utils.js

@@ -1,9 +1,9 @@
 import "reflect-metadata";
-import { Reflector } from "../core/reflector";
-import { FILTERS_KEY } from "../decorators/filters.decorators";
-import { GUARDS_KEY } from "../decorators/guards.decorators";
-import { INTERCEPTORS_KEY } from "../decorators/interceptors.decorators";
-import { PIPES_KEY } from "../decorators/pipes.decorators";
+import { Reflector } from "../core/reflector.js";
+import { FILTERS_KEY } from "../decorators/filters.decorators.js";
+import { GUARDS_KEY } from "../decorators/guards.decorators.js";
+import { INTERCEPTORS_KEY } from "../decorators/interceptors.decorators.js";
+import { PIPES_KEY } from "../decorators/pipes.decorators.js";
 const reflector = new Reflector();
 function enhancerKey(value) {
     if (typeof value === "function") {

package/dist/pipes/index.d.ts

@@ -1 +1 @@
-export * from "./zod.pipe";
+export * from "./zod.pipe.js";

package/dist/pipes/index.js

@@ -1 +1 @@
-export * from "./zod.pipe";
+export * from "./zod.pipe.js";

package/dist/pipes/zod.pipe.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { PipeTransform } from "../types";
+import type { PipeTransform } from "../types.js";
 export declare class ZodPipe<TSchema extends z.ZodType> implements PipeTransform<unknown, z.infer<TSchema>> {
     private schema;
     constructor(schema: TSchema);

package/dist/rpc/adapter.d.ts

@@ -1,7 +1,7 @@
 import type { HandlerContext } from "@connectrpc/connect";
 import "reflect-metadata";
-import type { AppContainer } from "../core/container";
-import type { Constructor } from "../types";
+import type { AppContainer } from "../core/container.js";
+import type { Constructor } from "../types.js";
 type RpcResponse = Record<string, unknown>;
 export declare function createRpcHandler<TController extends Record<string, unknown>>(app: AppContainer, controller: Constructor<TController>, methodName: keyof TController & string): (req: unknown, context: HandlerContext) => Promise<RpcResponse>;
 export {};

package/dist/rpc/adapter.js

@@ -1,9 +1,9 @@
 import "reflect-metadata";
-import { ForbiddenException, toConnectError } from "../core/errors";
-import { CATCH_EXCEPTIONS_KEY } from "../decorators/filters.decorators";
-import { RPC_PARAMS_KEY } from "../decorators/rpc.decorators";
-import { LoggerService } from "../services";
-import { collectFiltersForRpc, collectGuardsForRpc, collectInterceptorsForRpc, collectPipesForRpc } from "./utils";
+import { ForbiddenException, toConnectError } from "../core/errors.js";
+import { CATCH_EXCEPTIONS_KEY } from "../decorators/filters.decorators.js";
+import { RPC_PARAMS_KEY } from "../decorators/rpc.decorators.js";
+import { LoggerService } from "../services/index.js";
+import { collectFiltersForRpc, collectGuardsForRpc, collectInterceptorsForRpc, collectPipesForRpc } from "./utils.js";
 function logRpcError(app, scope, details, error) {
     try {
         scope.resolve(LoggerService).error(details, error);

package/dist/rpc/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./adapter";
-export * from "./streaming-adapter";
-export * from "./router-builder";
-export * from "./utils";
+export * from "./adapter.js";
+export * from "./streaming-adapter.js";
+export * from "./router-builder.js";
+export * from "./utils.js";

package/dist/rpc/index.js

@@ -1,4 +1,4 @@
-export * from "./adapter";
-export * from "./streaming-adapter";
-export * from "./router-builder";
-export * from "./utils";
+export * from "./adapter.js";
+export * from "./streaming-adapter.js";
+export * from "./router-builder.js";
+export * from "./utils.js";

package/dist/rpc/router-builder.d.ts

@@ -1,4 +1,4 @@
 import type { ConnectRouter } from "@connectrpc/connect";
 import "reflect-metadata";
-import type { AppContainer } from "../core/container";
+import type { AppContainer } from "../core/container.js";
 export declare function buildConnectRoutes(di: AppContainer): (router: ConnectRouter) => void;

package/dist/rpc/router-builder.js

@@ -1,7 +1,7 @@
 import "reflect-metadata";
-import { RPC_METHODS_KEY, RPC_SERVICE_KEY } from "../decorators/rpc.decorators";
-import { createRpcHandler } from "./adapter";
-import { createStreamingRpcHandler } from "./streaming-adapter";
+import { RPC_METHODS_KEY, RPC_SERVICE_KEY } from "../decorators/rpc.decorators.js";
+import { createRpcHandler } from "./adapter.js";
+import { createStreamingRpcHandler } from "./streaming-adapter.js";
 export function buildConnectRoutes(di) {
     return (router) => {
         for (const ctrl of di.getControllers()) {

package/dist/rpc/streaming-adapter.d.ts

@@ -1,5 +1,5 @@
 import type { HandlerContext } from "@connectrpc/connect";
 import "reflect-metadata";
-import type { AppContainer } from "../core/container";
-import type { Constructor } from "../types";
+import type { AppContainer } from "../core/container.js";
+import type { Constructor } from "../types.js";
 export declare function createStreamingRpcHandler<TController extends Record<string, unknown>>(app: AppContainer, controller: Constructor<TController>, methodName: keyof TController & string): (req: unknown, context: HandlerContext) => AsyncIterable<unknown>;

package/dist/rpc/streaming-adapter.js

@@ -1,9 +1,9 @@
 import "reflect-metadata";
-import { ForbiddenException, toConnectError } from "../core/errors";
-import { CATCH_EXCEPTIONS_KEY } from "../decorators/filters.decorators";
-import { RPC_PARAMS_KEY } from "../decorators/rpc.decorators";
-import { LoggerService } from "../services";
-import { collectFiltersForRpc, collectGuardsForRpc, collectPipesForRpc } from "./utils";
+import { ForbiddenException, toConnectError } from "../core/errors.js";
+import { CATCH_EXCEPTIONS_KEY } from "../decorators/filters.decorators.js";
+import { RPC_PARAMS_KEY } from "../decorators/rpc.decorators.js";
+import { LoggerService } from "../services/index.js";
+import { collectFiltersForRpc, collectGuardsForRpc, collectPipesForRpc } from "./utils.js";
 function logRpcError(app, scope, details, error) {
     try {
         scope.resolve(LoggerService).error(details, error);

package/dist/rpc/utils.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import type { Constructor, ExceptionFilterLike, GuardLike, InterceptorLike, PipeLike } from "../types";
+import type { Constructor, ExceptionFilterLike, GuardLike, InterceptorLike, PipeLike } from "../types.js";
 export declare function collectGuardsForRpc(controller: Constructor, method: string, global: GuardLike[]): GuardLike[];
 export declare function collectInterceptorsForRpc(controller: Constructor, method: string, global: InterceptorLike[]): InterceptorLike[];
 export declare function collectPipesForRpc(controller: Constructor, method: string, global: PipeLike[]): PipeLike[];

package/dist/rpc/utils.js

@@ -1,9 +1,9 @@
 import "reflect-metadata";
-import { Reflector } from "../core/reflector";
-import { FILTERS_KEY } from "../decorators/filters.decorators";
-import { GUARDS_KEY } from "../decorators/guards.decorators";
-import { INTERCEPTORS_KEY } from "../decorators/interceptors.decorators";
-import { PIPES_KEY } from "../decorators/pipes.decorators";
+import { Reflector } from "../core/reflector.js";
+import { FILTERS_KEY } from "../decorators/filters.decorators.js";
+import { GUARDS_KEY } from "../decorators/guards.decorators.js";
+import { INTERCEPTORS_KEY } from "../decorators/interceptors.decorators.js";
+import { PIPES_KEY } from "../decorators/pipes.decorators.js";
 const reflector = new Reflector();
 function enhancerKey(value) {
     if (typeof value === "function") {

package/dist/services/config.service.js

@@ -10,8 +10,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { CONFIG_TOKEN } from "../core/config";
-import { Inject, Injectable } from "../decorators";
+import { CONFIG_TOKEN } from "../core/config.js";
+import { Inject, Injectable } from "../decorators/index.js";
 let ConfigService = class ConfigService {
     constructor(config) {
         this.config = config;

package/dist/services/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./config.service";
-export * from "./logger.service";
+export * from "./config.service.js";
+export * from "./logger.service.js";

package/dist/services/index.js

@@ -1,2 +1,2 @@
-export * from "./config.service";
-export * from "./logger.service";
+export * from "./config.service.js";
+export * from "./logger.service.js";

package/dist/services/logger.service.d.ts

@@ -1,4 +1,4 @@
-import { type AppLogger } from "../core/logger";
+import { type AppLogger } from "../core/logger.js";
 export declare class LoggerService {
     private readonly logger;
     constructor(logger: AppLogger);

package/dist/services/logger.service.js

@@ -10,8 +10,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { LOGGER_TOKEN } from "../core/logger";
-import { Inject, Injectable } from "../decorators";
+import { LOGGER_TOKEN } from "../core/logger.js";
+import { Inject, Injectable } from "../decorators/index.js";
 let LoggerService = class LoggerService {
     constructor(logger) {
         this.logger = logger;

package/dist/types.d.ts

@@ -39,8 +39,7 @@ interface BaseModuleMeta {
     exports?: InjectionToken[];
     global?: boolean;
 }
-export interface ModuleMeta extends BaseModuleMeta {
-}
+export type ModuleMeta = BaseModuleMeta;
 export interface DynamicModule extends BaseModuleMeta {
     module: Constructor;
     id?: string;
@@ -70,9 +69,9 @@ export interface RpcArgumentsHost {
     getContext<T = unknown>(): T | undefined;
 }
 export interface WsArgumentsHost {
-    getSocket<T = unknown>(): T | undefined;
+    getSocket(): unknown;
     getRequest(): FastifyRequest | undefined;
-    getMessage<T = unknown>(): T | undefined;
+    getMessage(): unknown;
 }
 export interface BaseContext {
     type: ContextType;
@@ -115,7 +114,7 @@ export interface PipeTransform<TIn = unknown, TOut = unknown> {
 }
 export type PipeLike = Constructor<PipeTransform> | PipeTransform;
 export interface ExceptionFilter<T = unknown> {
-    catch(exception: T, ctx: BaseContext): Promise<unknown> | unknown;
+    catch(exception: T, ctx: BaseContext): unknown;
 }
 export type ExceptionFilterLike = Constructor<ExceptionFilter> | ExceptionFilter;
 export interface ConfigServiceOptions<TSchema extends ZodType = ZodType> {
@@ -124,7 +123,7 @@ export interface ConfigServiceOptions<TSchema extends ZodType = ZodType> {
 }
 export interface CorsOptions {
     enabled?: boolean;
-    origin?: string | boolean | RegExp | Array<string | boolean | RegExp>;
+    origin?: string | boolean | RegExp | (string | boolean | RegExp)[];
     credentials?: boolean;
     exposedHeaders?: string | string[];
     allowedHeaders?: string | string[];

package/dist/validation/app-config.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { booleanSchema, numberSchema, stringArraySchema } from "./common";
+import { booleanSchema, numberSchema, stringArraySchema } from "./common.js";
 const LOG_LEVELS = ["silly", "trace", "debug", "info", "warn", "error", "fatal"];
 const LOG_TYPES = ["pretty", "json"];
 export const appConfigSchema = z.object({

package/dist/validation/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./app-config";
-export * from "./common";
+export * from "./app-config.js";
+export * from "./common.js";

package/dist/validation/index.js

@@ -1,2 +1,2 @@
-export * from "./app-config";
-export * from "./common";
+export * from "./app-config.js";
+export * from "./common.js";

package/dist/ws/adapter.d.ts

@@ -1,6 +1,6 @@
 import type { FastifyRequest } from "fastify";
 import type { WebSocket } from "@fastify/websocket";
 import "reflect-metadata";
-import type { AppContainer } from "../core/container";
-import type { Constructor } from "../types";
+import type { AppContainer } from "../core/container.js";
+import type { Constructor } from "../types.js";
 export declare function handleWsConnection(app: AppContainer, gateway: Constructor, socket: WebSocket, request: FastifyRequest): void;

package/dist/ws/adapter.js

@@ -1,8 +1,8 @@
 import "reflect-metadata";
-import { GUARDS_KEY } from "../decorators/guards.decorators";
-import { WS_HANDLERS_KEY, WS_PARAMS_KEY } from "../decorators/ws.decorators";
-import { Reflector } from "../core/reflector";
-import { LoggerService } from "../services";
+import { GUARDS_KEY } from "../decorators/guards.decorators.js";
+import { WS_HANDLERS_KEY, WS_PARAMS_KEY } from "../decorators/ws.decorators.js";
+import { Reflector } from "../core/reflector.js";
+import { LoggerService } from "../services/index.js";
 const reflector = new Reflector();
 function collectGuardsForWs(gateway, app) {
     const classGuards = (reflector.get(GUARDS_KEY, gateway) ?? []);
@@ -104,9 +104,9 @@ export function handleWsConnection(app, gateway, socket, request) {
         }
         // Route messages to handlers
         socket.on("message", (raw) => {
-            (async () => {
+            void (async () => {
                 try {
-                    const msg = JSON.parse(raw.toString());
+                    const msg = JSON.parse(String(raw));
                     const handler = handlers.find((h) => h.messageType === msg.type);
                     if (!handler) {
                         return;
@@ -125,7 +125,7 @@ export function handleWsConnection(app, gateway, socket, request) {
         });
         // Cleanup on disconnect
         socket.on("close", () => {
-            (async () => {
+            void (async () => {
                 try {
                     if (typeof instance.onDisconnect === "function") {
                         await instance.onDisconnect(socket);
@@ -162,6 +162,7 @@ export function handleWsConnection(app, gateway, socket, request) {
         catch {
             // socket may already be closed
         }
+        // eslint-disable-next-line @typescript-eslint/no-empty-function
         app.disposeRequestScope(scope).catch(() => { });
     });
 }

package/dist/ws/index.d.ts

@@ -1,3 +1,3 @@
-export { handleWsConnection } from "./adapter";
-export { registerWsGateways } from "./router-builder";
-export type { WsGatewayLifecycle, WsGatewayMeta, WsHandlerMeta, WsParamMeta, WsParamSource } from "./types";
+export { handleWsConnection } from "./adapter.js";
+export { registerWsGateways } from "./router-builder.js";
+export type { WsGatewayLifecycle, WsGatewayMeta, WsHandlerMeta, WsParamMeta, WsParamSource } from "./types.js";

package/dist/ws/index.js

@@ -1,2 +1,2 @@
-export { handleWsConnection } from "./adapter";
-export { registerWsGateways } from "./router-builder";
+export { handleWsConnection } from "./adapter.js";
+export { registerWsGateways } from "./router-builder.js";

package/dist/ws/router-builder.d.ts

@@ -1,4 +1,4 @@
 import type { FastifyInstance } from "fastify";
 import "reflect-metadata";
-import type { AppContainer } from "../core/container";
+import type { AppContainer } from "../core/container.js";
 export declare function registerWsGateways(server: FastifyInstance, app: AppContainer): Promise<void>;

package/dist/ws/router-builder.js

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { WS_GATEWAY_KEY } from "../decorators/ws.decorators";
-import { handleWsConnection } from "./adapter";
+import { WS_GATEWAY_KEY } from "../decorators/ws.decorators.js";
+import { handleWsConnection } from "./adapter.js";
 export async function registerWsGateways(server, app) {
     const gateways = app.getWsGateways();
     if (gateways.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smounters/imperium",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "NestJS-like modular DI container with unified HTTP + Connect RPC server for TypeScript",
   "keywords": [
     "di",
@@ -64,6 +64,8 @@
     "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix",
     "format": "prettier . --write",
     "format:check": "prettier . --check",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "clean": "rm -rf dist",
     "docs:dev": "pnpm exec vitepress dev docs",
     "docs:build": "pnpm exec vitepress build docs",
@@ -91,11 +93,11 @@
   "devDependencies": {
     "@connectrpc/connect": "^2.1.1",
     "@connectrpc/connect-fastify": "^2.1.1",
+    "@eslint/js": "^10.0.1",
     "@fastify/cors": "^11.2.0",
     "@fastify/websocket": "^11.2.0",
     "@types/node": "^25.5.0",
-    "@typescript-eslint/eslint-plugin": "^8.57.2",
-    "@typescript-eslint/parser": "^8.57.2",
+    "@types/ws": "^8.18.1",
     "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "fastify": "^5.8.4",
@@ -104,7 +106,11 @@
     "tslog": "^4.10.2",
     "tsyringe": "^4.10.0",
     "typescript": "^5.9.3",
+    "typescript-eslint": "^8.57.2",
+    "vite": "^8.0.3",
     "vitepress": "^1.6.4",
+    "vitest": "^4.1.2",
+    "ws": "^8.20.0",
     "zod": "^4.3.6"
   }
 }