@shadow-library/fastify 0.0.9 → 0.0.10

package/README.md

@@ -695,6 +695,64 @@ export class DataController {
 }
 ```
 
+### Extending Context Service
+
+The `ContextService` can be extended with custom methods to add application-specific functionality while maintaining type safety and method chaining capabilities.
+
+```typescript
+import { contextService } from '@shadow-library/fastify';
+
+declare module '@shadow-library/fastify' {
+  export interface ContextExtension {
+    setUserRole(role: string): ContextService;
+    getUserRole(): string;
+    setCurrentUserId(userId: string): ContextService;
+    getCurrentUserId(): string;
+  }
+}
+
+// Extend the context service with custom methods
+contextService.extend({
+  setUserRole(role: string) {
+    return this.set('user-role', role);
+  },
+  getUserRole() {
+    return this.get<string>('user-role', false);
+  },
+  setCurrentUserId(userId: string) {
+    return this.set('current-user-id', userId);
+  },
+  getCurrentUserId() {
+    return this.get<string>('current-user-id', false);
+  },
+});
+
+// Use in controllers with method chaining
+@HttpController('/api')
+export class UserController {
+  constructor(private readonly contextService: ContextService) {}
+
+  @Post('/login')
+  async login(@Body() loginDto: LoginDto) {
+    const user = await this.authService.validateUser(loginDto);
+
+    // Chain extended methods
+    this.contextService.setCurrentUserId(user.id).setUserRole(user.role);
+
+    return { message: 'Login successful' };
+  }
+
+  @Get('/profile')
+  getProfile() {
+    return {
+      userId: this.contextService.getCurrentUserId(),
+      role: this.contextService.getUserRole(),
+      requestId: this.contextService.getRID(),
+    };
+  }
+}
+```
+
 ## Examples
 
 Check out the [examples](./examples) directory for complete working examples:

package/cjs/services/context.service.d.ts

@@ -1,7 +1,9 @@
 import { onRequestHookHandler } from 'fastify';
 import { HttpRequest, HttpResponse } from '../interfaces/index.js';
 type Key = string | symbol;
-export declare class ContextService {
+export interface ContextExtension {
+}
+export declare class ContextService implements ContextExtension {
     static readonly name = "ContextService";
     private readonly storage;
     init(): onRequestHookHandler;
@@ -21,5 +23,6 @@ export declare class ContextService {
     getResponse(throwOnMissing: false): HttpResponse | null;
     getRID(): string;
     getRID(throwOnMissing: false): string | null;
+    extend<T extends ContextExtension = ContextExtension>(extension: T & ThisType<this & T>): this;
 }
 export {};

package/cjs/services/context.service.js

@@ -92,6 +92,9 @@ let ContextService = class ContextService {
     getRID(throwOnMissing = true) {
         return this.get(RID, throwOnMissing);
     }
+    extend(extension) {
+        return Object.assign(this, extension);
+    }
 };
 exports.ContextService = ContextService;
 exports.ContextService = ContextService = __decorate([

package/esm/services/context.service.d.ts

@@ -1,7 +1,9 @@
 import { onRequestHookHandler } from 'fastify';
 import { HttpRequest, HttpResponse } from '../interfaces/index.js';
 type Key = string | symbol;
-export declare class ContextService {
+export interface ContextExtension {
+}
+export declare class ContextService implements ContextExtension {
     static readonly name = "ContextService";
     private readonly storage;
     init(): onRequestHookHandler;
@@ -21,5 +23,6 @@ export declare class ContextService {
     getResponse(throwOnMissing: false): HttpResponse | null;
     getRID(): string;
     getRID(throwOnMissing: false): string | null;
+    extend<T extends ContextExtension = ContextExtension>(extension: T & ThisType<this & T>): this;
 }
 export {};

package/esm/services/context.service.js

@@ -89,6 +89,9 @@ let ContextService = class ContextService {
     getRID(throwOnMissing = true) {
         return this.get(RID, throwOnMissing);
     }
+    extend(extension) {
+        return Object.assign(this, extension);
+    }
 };
 ContextService = __decorate([
     Injectable()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shadow-library/fastify",
   "type": "module",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "sideEffects": false,
   "description": "A Fastify wrapper featuring decorator-based routing, middleware and error handling",
   "repository": {