@takentrade/takentrade-libs 4.1.1 → 4.1.3

package/README.md

@@ -1,6 +1,6 @@
 # TakeNTrade Microservices Libraries
 
-Shared libraries for the TakeNTrade microservices architecture, providing authentication, caching, messaging, notifications, resilience patterns, metrics, and common utilities.
+Shared libraries for the TakeNTrade microservices architecture, providing authentication, caching, messaging, notifications, and common utilities.
 
 ## Installation
 
@@ -11,22 +11,27 @@ npm install @takentrade/takentrade-libs
 ## Quick Start
 
 ```typescript
-import {
-  CacheModule,
-  MetricsModule,
-  CircuitBreakerModule,
-} from '@takentrade/takentrade-libs';
+import { CacheModule } from '@takentrade/takentrade-libs';
+import { ConfigService } from '@nestjs/config';
 
 @Module({
   imports: [
-    CacheModule.register(),
-    MetricsModule.register({ defaultMetrics: true }),
-    CircuitBreakerModule,
+    CacheModule.registerAsync({
+      inject: [ConfigService],
+      useFactory: (configService: ConfigService) => ({
+        host: configService.get<string>('redis.host'),
+        port: configService.get<number>('redis.port'),
+        username: configService.get<string>('redis.username'),
+        password: configService.get<string>('redis.password'),
+      }),
+    }),
   ],
 })
 export class AppModule {}
 ```
 
+For authentication, services can extend the shared `TntBaseAuthGuard` and pair it with their own JWT strategy implementation based on `TntJwtStrategy`.
+
 ## Modules
 
 | Module             | Description                                    | Documentation                                  |
@@ -37,9 +42,6 @@ export class AppModule {}
 | **NATS**           | Microservice messaging and event streaming     | [docs/nats.md](docs/nats.md)                   |
 | **Notifications**  | Email, SMS, and push notifications             | [docs/notifications.md](docs/notifications.md) |
 | **RPC**            | Request-response patterns for NATS             | [docs/rpc.md](docs/rpc.md)                     |
-| **Resilience**     | Circuit breakers for fault tolerance           | [docs/resilience.md](docs/resilience.md)       |
-| **Metrics**        | Prometheus metrics collection                  | [docs/metrics.md](docs/metrics.md)             |
-| **Monitoring**     | Error tracking, alerting, uptime monitoring    | [docs/monitoring.md](docs/monitoring.md)       |
 | **Common**         | Shared constants, enums, and utilities         | [docs/common.md](docs/common.md)               |
 | **Utils**          | DTOs, pipes, filters, and helpers              | [docs/utils.md](docs/utils.md)                 |
 
@@ -48,6 +50,7 @@ export class AppModule {}
 ### 🔐 Authentication & Authorization
 
 - `@Public()` and `@Roles()` decorators
+- `TntBaseAuthGuard` for shared JWT guard behavior
 - JWT-based authentication support
 - Role-based access control
 
@@ -58,23 +61,6 @@ export class AppModule {}
 - Hash operations
 - Auto-reconnection
 
-### 📊 Metrics & Observability
-
-- Prometheus metrics with prom-client
-- Default process metrics (CPU, memory, event loop)
-- Custom counters, gauges, histograms, summaries
-- Circuit breaker metrics integration
-- `/metrics` endpoint for scraping
-
-### 🔄 Resilience
-
-- Circuit breakers using Opossum
-- Automatic failure detection
-- Fallback support
-- Health checks
-- Request caching
-- Comprehensive metrics
-
 ### 🚀 Background Jobs
 
 - BullMQ integration
@@ -122,30 +108,6 @@ await this.cacheService.set('key', 'value', 3600); // 1 hour TTL
 const value = await this.cacheService.get('key');
 ```
 
-### Metrics
-
-```typescript
-this.metricsService.registerCounter({
-  name: 'requests_total',
-  help: 'Total requests',
-  labelNames: ['method', 'status'],
-});
-this.metricsService.incrementCounter('requests_total', {
-  method: 'GET',
-  status: '200',
-});
-```
-
-### Circuit Breaker
-
-```typescript
-this.circuitBreaker.createBreaker('api', async (data) => this.apiCall(data), {
-  timeout: 5000,
-  errorThresholdPercentage: 50,
-});
-const result = await this.circuitBreaker.fire('api', requestData);
-```
-
 ### Background Jobs
 
 ```typescript
@@ -167,8 +129,6 @@ await this.queue.add(
 - [NATS](docs/nats.md) - Messaging
 - [Notifications](docs/notifications.md) - Email, SMS, push
 - [RPC](docs/rpc.md) - Request-response patterns
-- [Resilience](docs/resilience.md) - Circuit breakers
-- [Metrics](docs/metrics.md) - Prometheus metrics
 - [Common](docs/common.md) - Shared utilities
 - [Utils](docs/utils.md) - DTOs, pipes, filters
 

package/dist/auth/guards/index.d.ts

@@ -1 +1,2 @@
 export * from './roles.guard';
+export * from './tnt-base-auth.guard';

package/dist/auth/guards/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./roles.guard"), exports);
+__exportStar(require("./tnt-base-auth.guard"), exports);

package/dist/auth/guards/tnt-base-auth.guard.d.ts

@@ -0,0 +1,15 @@
+import { ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+declare const TntBaseAuthGuard_base: import("@nestjs/passport").Type<import("@nestjs/passport").IAuthGuard>;
+export declare class TntBaseAuthGuard extends TntBaseAuthGuard_base {
+    private readonly reflector;
+    private readonly logger;
+    constructor(reflector: Reflector);
+    canActivate(context: ExecutionContext): boolean | Promise<boolean> | Observable<boolean>;
+    handleRequest<TUser = unknown>(err: unknown, user: TUser, info: {
+        name?: string;
+        message?: string;
+    } | undefined, context: ExecutionContext, status?: unknown): TUser;
+}
+export {};

package/dist/auth/guards/tnt-base-auth.guard.js

@@ -0,0 +1,56 @@
+"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 TntBaseAuthGuard_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TntBaseAuthGuard = void 0;
+const common_1 = require("@nestjs/common");
+const passport_1 = require("@nestjs/passport");
+const decorators_1 = require("../decorators");
+let TntBaseAuthGuard = TntBaseAuthGuard_1 = class TntBaseAuthGuard extends (0, passport_1.AuthGuard)('jwt') {
+    reflector;
+    logger = new common_1.Logger(TntBaseAuthGuard_1.name);
+    constructor(reflector) {
+        super();
+        this.reflector = reflector;
+    }
+    canActivate(context) {
+        const isPublic = this.reflector.getAllAndOverride(decorators_1.IS_PUBLIC_KEY, [
+            context.getHandler(),
+            context.getClass(),
+        ]);
+        if (isPublic) {
+            return true;
+        }
+        return super.canActivate(context);
+    }
+    handleRequest(err, user, info, context, status) {
+        void status;
+        if (err || !user) {
+            const request = context.switchToHttp().getRequest();
+            const message = err instanceof Error
+                ? err.message
+                : (info?.message ?? 'Authentication failed');
+            this.logger.error(`JWT validation error on ${request.method ?? 'UNKNOWN'} ${request.url ?? 'UNKNOWN'}: ${message}`);
+            if (info?.name === 'TokenExpiredError') {
+                throw new common_1.UnauthorizedException('Token has expired');
+            }
+            if (info?.name === 'JsonWebTokenError') {
+                throw new common_1.UnauthorizedException('Invalid token');
+            }
+            if (info?.name === 'NotBeforeError') {
+                throw new common_1.UnauthorizedException('Token not yet valid');
+            }
+            throw new common_1.UnauthorizedException('Authentication failed');
+        }
+        return user;
+    }
+};
+exports.TntBaseAuthGuard = TntBaseAuthGuard;
+exports.TntBaseAuthGuard = TntBaseAuthGuard = TntBaseAuthGuard_1 = __decorate([
+    (0, common_1.Injectable)()
+], TntBaseAuthGuard);

package/dist/bullmq/config/bull.config.js

@@ -14,7 +14,7 @@ class BullConfigFactory {
                 password: this.configService.get('REDIS_PASSWORD'),
             },
             defaultJobOptions: {
-                removeOnComplete: false, // Keep completed jobs for monitoring
+                removeOnComplete: false, // Keep completed jobs available for inspection
                 removeOnFail: false, // Keep failed jobs for debugging
                 attempts: 3, // Default retry attempts
                 backoff: {

package/dist/cache/cache.module.d.ts

@@ -1,5 +1,9 @@
-import { DynamicModule } from '@nestjs/common';
+import { DynamicModule, InjectionToken, ModuleMetadata } from '@nestjs/common';
 import { CacheOptions } from './cache.interface';
 export declare class CacheModule {
-    static register(options?: CacheOptions): DynamicModule;
+    static registerAsync(options: {
+        imports?: ModuleMetadata['imports'];
+        inject?: InjectionToken[];
+        useFactory: (...args: any[]) => Promise<CacheOptions> | CacheOptions;
+    }): DynamicModule;
 }

package/dist/cache/cache.module.js

@@ -12,11 +12,18 @@ const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const cache_service_1 = require("./cache.service");
 let CacheModule = CacheModule_1 = class CacheModule {
-    static register(options = {}) {
+    static registerAsync(options) {
         return {
             module: CacheModule_1,
-            imports: [config_1.ConfigModule],
-            providers: [cache_service_1.CacheService, { provide: 'options', useValue: options }],
+            imports: [...(options.imports ?? []), config_1.ConfigModule],
+            providers: [
+                cache_service_1.CacheService,
+                {
+                    provide: 'options',
+                    inject: options.inject ?? [],
+                    useFactory: options.useFactory,
+                },
+            ],
             exports: [cache_service_1.CacheService],
         };
     }

package/dist/index.d.ts

@@ -7,6 +7,3 @@ export * from './rpc';
 export * from './logging';
 export * from './auth';
 export * from './notification';
-export * from './resilience';
-export * from './metrics';
-export * from './monitoring';

package/dist/index.js

@@ -23,6 +23,3 @@ __exportStar(require("./rpc"), exports);
 __exportStar(require("./logging"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./notification"), exports);
-__exportStar(require("./resilience"), exports);
-__exportStar(require("./metrics"), exports);
-__exportStar(require("./monitoring"), exports);