@alacard-project/shared 1.0.10 → 1.1.0

package/dist/resilience/circuit-breaker.service.js

@@ -0,0 +1,45 @@
+"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 CircuitBreakerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerService = void 0;
+const common_1 = require("@nestjs/common");
+const CircuitBreaker = require("opossum");
+let CircuitBreakerService = CircuitBreakerService_1 = class CircuitBreakerService {
+    constructor() {
+        this.logger = new common_1.Logger(CircuitBreakerService_1.name);
+        this.breakers = new Map();
+    }
+    async execute(key, action, options) {
+        let breaker = this.breakers.get(key);
+        if (!breaker) {
+            const defaultOptions = {
+                timeout: 5000,
+                errorThresholdPercentage: 50,
+                resetTimeout: 10000,
+                ...options,
+            };
+            const passThrough = async (promiseFactory) => promiseFactory();
+            breaker = new CircuitBreaker(passThrough, defaultOptions);
+            this.bindEvents(breaker, key);
+            this.breakers.set(key, breaker);
+        }
+        return breaker.fire(action);
+    }
+    bindEvents(breaker, key) {
+        breaker.on('open', () => this.logger.warn(`Circuit Breaker OPEN for ${key}`));
+        breaker.on('halfOpen', () => this.logger.log(`Circuit Breaker HALF-OPEN for ${key}`));
+        breaker.on('close', () => this.logger.log(`Circuit Breaker CLOSED for ${key}`));
+        breaker.on('fallback', () => this.logger.warn(`Circuit Breaker FALLBACK for ${key}`));
+    }
+};
+exports.CircuitBreakerService = CircuitBreakerService;
+exports.CircuitBreakerService = CircuitBreakerService = CircuitBreakerService_1 = __decorate([
+    (0, common_1.Injectable)()
+], CircuitBreakerService);
+//# sourceMappingURL=circuit-breaker.service.js.map

package/dist/resilience/circuit-breaker.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.service.js","sourceRoot":"","sources":["../../src/resilience/circuit-breaker.service.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAoD;AACpD,0CAA2C;AAGpC,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IAA3B;QACc,WAAM,GAAG,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;QAChD,aAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAuClE,CAAC;IA/BG,KAAK,CAAC,OAAO,CACT,GAAW,EACX,MAAwB,EACxB,OAAgC;QAEhC,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAErC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,cAAc,GAA2B;gBAC3C,OAAO,EAAE,IAAI;gBACb,wBAAwB,EAAE,EAAE;gBAC5B,YAAY,EAAE,KAAK;gBACnB,GAAG,OAAO;aACb,CAAC;YAGF,MAAM,WAAW,GAAG,KAAK,EAAE,cAAgC,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC;YACjF,OAAO,GAAG,IAAI,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAC1D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAe,CAAC;IAC9C,CAAC;IAEO,UAAU,CAAC,OAAuB,EAAE,GAAW;QACnD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC;CACJ,CAAA;AAzCY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;GACA,qBAAqB,CAyCjC"}

package/dist/resilience/resilience.module.d.ts

@@ -0,0 +1,2 @@
+export declare class ResilienceModule {
+}

package/dist/resilience/resilience.module.js

@@ -0,0 +1,22 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResilienceModule = void 0;
+const common_1 = require("@nestjs/common");
+const circuit_breaker_service_1 = require("./circuit-breaker.service");
+let ResilienceModule = class ResilienceModule {
+};
+exports.ResilienceModule = ResilienceModule;
+exports.ResilienceModule = ResilienceModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [circuit_breaker_service_1.CircuitBreakerService],
+        exports: [circuit_breaker_service_1.CircuitBreakerService],
+    })
+], ResilienceModule);
+//# sourceMappingURL=resilience.module.js.map

package/dist/resilience/resilience.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.module.js","sourceRoot":"","sources":["../../src/resilience/resilience.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,uEAAkE;AAO3D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAI,CAAA;AAApB,4CAAgB;2BAAhB,gBAAgB;IAL5B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACJ,SAAS,EAAE,CAAC,+CAAqB,CAAC;QAClC,OAAO,EAAE,CAAC,+CAAqB,CAAC;KACnC,CAAC;GACW,gBAAgB,CAAI"}

package/dist/types/auth.types.d.ts

@@ -1,7 +1,10 @@
-export interface JwtPayload {
+import { JsonObject, JsonValue } from './common.types';
+import { SubjectType } from '../enums/iam.enum';
+export interface JwtPayload extends JsonObject {
     sub: string;
-    email: string;
+    email?: string;
     role: string;
+    subjectType: SubjectType;
     scopes: string[];
     iat?: number;
     exp?: number;
@@ -13,6 +16,21 @@ export interface JwtTokens {
     expiresIn: number;
 }
 export interface AuthenticatedRequest {
-    user: any;
-    [key: string]: any;
+    user: JwtPayload;
+    [key: string]: JsonValue;
+}
+export interface ValidateServiceTokenResponse {
+    isValid: boolean;
+    identityId?: string;
+    tokenId?: string;
+}
+export interface Session {
+    sessionId: string;
+    identityId: string;
+    ipAddress?: string;
+    userAgent?: string;
+    deviceInfo?: string;
+    createdAt: Date;
+    expiresAt: Date;
+    isRevoked?: boolean;
 }

package/dist/types/common.types.d.ts

@@ -0,0 +1,11 @@
+export type JsonPrimitive = string | number | boolean | null | undefined;
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export interface JsonArray extends Array<JsonValue> {
+}
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export interface Metadata {
+    [key: string]: JsonValue;
+}
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';

package/dist/types/common.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.types.js.map

package/dist/types/common.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":""}

package/dist/types/iam.types.d.ts

@@ -0,0 +1,46 @@
+import { SubjectType, IdentityStatus, UserRole, IdentifierType } from '../enums';
+import { JsonValue } from './common.types';
+export interface Identity {
+    identityId: string;
+    subjectType: SubjectType;
+    role: UserRole;
+    status: IdentityStatus;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+export interface IdentityAttributes {
+    department?: string;
+    companyId?: string;
+    permissions: string[];
+    metadata?: Record<string, JsonValue>;
+}
+export interface PolicyCheckRequest {
+    identityId: string;
+    resource: string;
+    action: string;
+    context?: Record<string, JsonValue>;
+}
+export interface PolicyCheckResponse {
+    allowed: boolean;
+    reason?: string;
+}
+export interface OwnershipCheckRequest {
+    identityId: string;
+    resourceId: string;
+    resourceType: string;
+}
+export interface ScopeCheckRequest {
+    identityId: string;
+    scope: string;
+    context?: Record<string, JsonValue>;
+}
+export interface Credential {
+    id: string;
+    identityId: string;
+    identifierType: IdentifierType;
+    identifierValue: string;
+    passwordHash: string;
+    status: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}

package/dist/types/iam.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=iam.types.js.map

package/dist/types/iam.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iam.types.js","sourceRoot":"","sources":["../../src/types/iam.types.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 export * from './config.types';
 export * from './auth.types';
+export * from './iam.types';
 export * from './user.types';
+export * from './common.types';
 export * from './monitoring.types';

package/dist/types/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./config.types"), exports);
 __exportStar(require("./auth.types"), exports);
+__exportStar(require("./iam.types"), exports);
 __exportStar(require("./user.types"), exports);
+__exportStar(require("./common.types"), exports);
 __exportStar(require("./monitoring.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,+CAA6B;AAC7B,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B;AAC/B,qDAAmC"}

package/dist/types/monitoring.types.d.ts

@@ -1,7 +1,8 @@
+import { MetricType } from './common.types';
 export interface PrometheusMetric {
     name: string;
     help: string;
-    type: 'counter' | 'gauge' | 'histogram' | 'summary';
+    type: MetricType;
     labelNames?: string[];
 }
 export interface MetricValue {

package/dist/types/user.types.d.ts

@@ -4,7 +4,11 @@ import { GetUserByIdGrpcRequest, GetUserByEmailGrpcRequest } from '../contracts/
 export interface IUserService {
     getUserById(data: GetUserByIdGrpcRequest): Observable<UserResponse>;
     getUserByEmail(data: GetUserByEmailGrpcRequest): Observable<UserResponse>;
-    createUser(data: any): Observable<UserResponse>;
-    updateUser(data: any): Observable<UserResponse>;
-    deleteUser(data: any): Observable<any>;
+    createUser(data: unknown): Observable<UserResponse>;
+    updateUser(data: unknown): Observable<UserResponse>;
+    deleteUser(data: {
+        id: string;
+    }): Observable<{
+        success: boolean;
+    }>;
 }

package/dist/utils/app.utils.d.ts

@@ -4,5 +4,6 @@ export interface AppSetupOptions {
     apiPrefix?: string;
     helmet?: boolean;
     validation?: boolean;
+    shutdownHooks?: boolean;
 }
 export declare function setupStandardApp(app: INestApplication, options?: AppSetupOptions): void;

package/dist/utils/app.utils.js

@@ -5,7 +5,10 @@ const common_1 = require("@nestjs/common");
 const http_constants_1 = require("../constants/http.constants");
 const helmet_1 = require("helmet");
 function setupStandardApp(app, options = {}) {
-    const { corsOrigins = ['*'], apiPrefix = http_constants_1.API_PREFIX.V1, helmet: useHelmet = true, validation = true, } = options;
+    const { corsOrigins = ['*'], apiPrefix = http_constants_1.API_PREFIX.V1, helmet: useHelmet = true, validation = true, shutdownHooks = true, } = options;
+    if (shutdownHooks) {
+        app.enableShutdownHooks();
+    }
     app.enableCors({
         origin: corsOrigins,
         credentials: true,
@@ -19,6 +22,9 @@ function setupStandardApp(app, options = {}) {
             whitelist: true,
             forbidNonWhitelisted: true,
             transform: true,
+            transformOptions: {
+                enableImplicitConversion: true,
+            },
         }));
     }
 }

package/dist/utils/app.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.utils.js","sourceRoot":"","sources":["../../src/utils/app.utils.ts"],"names":[],"mappings":";;AAWA,4CA+BC;AA1CD,2CAAkE;AAClE,gEAAyD;AACzD,mCAA4B;AAS5B,SAAgB,gBAAgB,CAC5B,GAAqB,EACrB,UAA2B,EAAE;IAE7B,MAAM,EACF,WAAW,GAAG,CAAC,GAAG,CAAC,EACnB,SAAS,GAAG,2BAAU,CAAC,EAAE,EACzB,MAAM,EAAE,SAAS,GAAG,IAAI,EACxB,UAAU,GAAG,IAAI,GACpB,GAAG,OAAO,CAAC;IAEZ,GAAG,CAAC,UAAU,CAAC;QACX,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAE/B,IAAI,SAAS,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,CAAC,IAAA,gBAAM,GAAE,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACb,GAAG,CAAC,cAAc,CACd,IAAI,uBAAc,CAAC;YACf,SAAS,EAAE,IAAI;YACf,oBAAoB,EAAE,IAAI;YAC1B,SAAS,EAAE,IAAI;SAClB,CAAC,CACL,CAAC;IACN,CAAC;AACL,CAAC"}
+{"version":3,"file":"app.utils.js","sourceRoot":"","sources":["../../src/utils/app.utils.ts"],"names":[],"mappings":";;AAYA,4CAuCC;AAnDD,2CAAkE;AAClE,gEAAyD;AACzD,mCAA4B;AAU5B,SAAgB,gBAAgB,CAC5B,GAAqB,EACrB,UAA2B,EAAE;IAE7B,MAAM,EACF,WAAW,GAAG,CAAC,GAAG,CAAC,EACnB,SAAS,GAAG,2BAAU,CAAC,EAAE,EACzB,MAAM,EAAE,SAAS,GAAG,IAAI,EACxB,UAAU,GAAG,IAAI,EACjB,aAAa,GAAG,IAAI,GACvB,GAAG,OAAO,CAAC;IAEZ,IAAI,aAAa,EAAE,CAAC;QAChB,GAAG,CAAC,mBAAmB,EAAE,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,UAAU,CAAC;QACX,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAE/B,IAAI,SAAS,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,CAAC,IAAA,gBAAM,GAAE,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACb,GAAG,CAAC,cAAc,CACd,IAAI,uBAAc,CAAC;YACf,SAAS,EAAE,IAAI;YACf,oBAAoB,EAAE,IAAI;YAC1B,SAAS,EAAE,IAAI;YACf,gBAAgB,EAAE;gBACd,wBAAwB,EAAE,IAAI;aACjC;SACJ,CAAC,CACL,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/utils/health.utils.d.ts

@@ -1,6 +1,10 @@
+import { JsonValue } from '../types/common.types';
 export type HealthCheckStatus = 'up' | 'down';
 export interface ComponentHealth {
     status: HealthCheckStatus;
-    [key: string]: any;
+    [key: string]: JsonValue;
 }
-export declare const createPrismaHealthCheck: (prisma: any) => () => Promise<ComponentHealth>;
+export interface PrismaLike {
+    $queryRaw: (query: TemplateStringsArray, ...values: unknown[]) => Promise<unknown>;
+}
+export declare const createPrismaHealthCheck: (prisma: PrismaLike) => () => Promise<ComponentHealth>;

package/dist/utils/health.utils.js

@@ -8,7 +8,8 @@ const createPrismaHealthCheck = (prisma) => {
             return { status: 'up' };
         }
         catch (e) {
-            return { status: 'down', error: e.message };
+            const message = e instanceof Error ? e.message : 'Unknown error';
+            return { status: 'down', error: message };
         }
     };
 };

package/dist/utils/health.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"health.utils.js","sourceRoot":"","sources":["../../src/utils/health.utils.ts"],"names":[],"mappings":";;;AAOO,MAAM,uBAAuB,GAAG,CAAC,MAAW,EAAE,EAAE;IACnD,OAAO,KAAK,IAA8B,EAAE;QACxC,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,SAAS,CAAA,UAAU,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YACd,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAChD,CAAC;IACL,CAAC,CAAC;AACN,CAAC,CAAC;AATW,QAAA,uBAAuB,2BASlC"}
+{"version":3,"file":"health.utils.js","sourceRoot":"","sources":["../../src/utils/health.utils.ts"],"names":[],"mappings":";;;AAaO,MAAM,uBAAuB,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC1D,OAAO,KAAK,IAA8B,EAAE;QACxC,IAAI,CAAC;YACD,MAAM,MAAM,CAAC,SAAS,CAAA,UAAU,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACjE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC9C,CAAC;IACL,CAAC,CAAC;AACN,CAAC,CAAC;AAVW,QAAA,uBAAuB,2BAUlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@alacard-project/shared",
-    "version": "1.0.10",
+    "version": "1.1.0",
     "engines": {
         "node": ">=24.0.0"
     },
@@ -8,28 +8,41 @@
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "exports": {
-        ".": "./dist/index.js"
+        ".": "./dist/index.js",
+        "./dist/observability/tracing": "./dist/observability/tracing.js"
     },
     "scripts": {
         "build": "tsc",
         "watch": "tsc -w"
     },
+    "peerDependencies": {
+        "@nestjs/common": "^10.0.0",
+        "@nestjs/core": "^10.0.0",
+        "reflect-metadata": "^0.2.0",
+        "rxjs": "^7.8.1"
+    },
     "dependencies": {
-        "@nestjs/common": "^11.1.12",
-        "@nestjs/config": "^4.0.2",
-        "@nestjs/core": "^11.1.12",
-        "axios": "^1.13.2",
+        "@nestjs/bullmq": "^10.0.0",
+        "@opentelemetry/auto-instrumentations-node": "^0.69.0",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.211.0",
+        "@opentelemetry/resources": "^2.5.0",
+        "@opentelemetry/sdk-node": "^0.211.0",
+        "@opentelemetry/semantic-conventions": "^1.39.0",
+        "@types/opossum": "^8.1.9",
+        "axios": "^1.6.0",
+        "bullmq": "^5.67.2",
         "class-transformer": "^0.5.1",
-        "class-validator": "^0.14.3",
-        "helmet": "^8.1.0",
-        "reflect-metadata": "^0.2.2",
-        "rxjs": "^7.8.2"
+        "class-validator": "^0.14.1",
+        "helmet": "^7.1.0",
+        "opossum": "^9.0.0"
     },
     "devDependencies": {
-        "@nestjs/common": "^11.1.12",
+        "@nestjs/common": "^10.0.0",
         "@nestjs/config": "^4.0.2",
-        "@nestjs/core": "^11.1.12",
-        "@types/node": "^24.10.0",
-        "typescript": "^5.9.3"
+        "@nestjs/core": "^10.0.0",
+        "@types/node": "^20.3.1",
+        "reflect-metadata": "^0.2.0",
+        "rxjs": "^7.8.1",
+        "typescript": "^5.1.3"
     }
-}
+}

package/proto/dbf.proto

@@ -4,7 +4,7 @@ package dbf;
 
 // ==================== Service Definition ====================
 
-service Dbf Service {
+service DbfService {
   // Read DBF file with optional filtering
   rpc ReadDbf(ReadDbfRequest) returns (ReadDbfResponse);
   

package/src/constants/auth-config.constants.ts

@@ -7,3 +7,10 @@ export const PASSWORD_RESET_CONFIG = {
     TOKEN_EXPIRY_HOURS: 1,
     TOKEN_LENGTH: 32,
 };
+export const AUTH_CONFIG = {
+    JWT_ACCESS_EXPIRATION: '15m',
+    JWT_REFRESH_EXPIRATION: '7d',
+    SESSION_EXPIRATION_HOURS: 24,
+    MAX_LOGIN_ATTEMPTS: 5,
+    LOCKOUT_DURATION_MINUTES: 30,
+} as const;

package/src/constants/auth.constants.ts

@@ -13,6 +13,22 @@ export const AUTHENTICATION_MESSAGES = {
     INVALID_CREDENTIALS: 'The email or password you entered is incorrect.',
 };
 
+export const AUTH_MESSAGES = {
+    ...AUTHENTICATION_MESSAGES,
+    USER_SUSPENDED: 'User account is suspended',
+    USER_LOCKED: 'User account is locked',
+    USER_DELETED: 'User account has been deleted',
+    TOKEN_EXPIRED: 'Token has expired',
+    TOKEN_INVALID: 'Invalid token',
+    TOKEN_REVOKED: 'Token has been revoked',
+    REFRESH_SUCCESS: 'Token refreshed successfully',
+    PASSWORD_CHANGED: 'Password changed successfully',
+    TWO_FACTOR_REQUIRED: 'PENDING_2FA',
+    TWO_FACTOR_VERIFIED: 'Two-factor authentication verified successfully',
+    TWO_FACTOR_INVALID: 'Invalid or expired two-factor code',
+} as const;
+
+
 export const COOKIE_EXPIRATION = {
     REFRESH_TOKEN_MS: 7 * 24 * 60 * 60 * 1000, // 7 days
     ACCESS_TOKEN_MS: 15 * 60 * 1000, // 15 minutes

package/src/constants/index.ts

@@ -6,5 +6,6 @@ export * from './error-messages';
 export * from './auth.constants';
 export * from './logging-messages.constants';
 export * from './routes.constants';
+export * from './queue.constants';
 export * from './common.constants';
 export * from './auth-config.constants';

package/src/constants/queue.constants.ts

@@ -0,0 +1,8 @@
+export const QUEUE_CONSTANTS = {
+    QUEUES: {
+        NOTIFICATIONS: 'notifications-queue',
+    },
+    JOBS: {
+        SEND_NOTIFICATION: 'send-notification-job',
+    },
+};

package/src/contracts/auth.contract.ts

@@ -1,14 +1,15 @@
 import { Observable } from 'rxjs';
-import { RegisterDto, LoginDto } from '../dto/auth.dto';
+import { RegisterDto, LoginDto, UserResponse } from '../dto/auth.dto';
 import { JwtTokens } from '../types/auth.types';
 import { GenerateTokensRequest } from './token.contract';
+import { UserRole } from '../enums';
 
 export interface GetUserByIdGrpcRequest {
     userId: string;
 }
 
 export interface GetUserByIdGrpcResponse {
-    user: any;
+    user: UserResponse;
 }
 
 export interface GetUserByEmailGrpcRequest {
@@ -16,7 +17,7 @@ export interface GetUserByEmailGrpcRequest {
 }
 
 export interface GetUserByEmailGrpcResponse {
-    user: any;
+    user: UserResponse;
 }
 
 export interface ValidateTokenGrpcRequest {
@@ -25,7 +26,7 @@ export interface ValidateTokenGrpcRequest {
 
 export interface ValidateTokenGrpcResponse {
     valid: boolean;
-    user?: any;
+    user?: UserResponse;
 }
 
 export interface RefreshTokenGrpcRequest {
@@ -60,7 +61,7 @@ export interface CreateIdentityRequest {
     password: string;
     name?: string;
     userId: string;
-    role: string;
+    role: UserRole;
 }
 
 export interface GetUserPermissionsGrpcResponse {
@@ -72,7 +73,7 @@ export interface GetUserPermissionsGrpcResponse {
 export interface CreateUserRequest {
     userId?: string;
     email: string;
-    role: string;
+    role: UserRole;
     password?: string;
 
     // Employee Fields
@@ -91,7 +92,7 @@ export interface CreateUserRequest {
 export interface UpdateUserRequest {
     userId: string;
     email?: string;
-    role?: string;
+    role?: UserRole;
     password?: string;
     isActive?: boolean;
 
@@ -133,8 +134,8 @@ export type DeleteUserResponse = { success: boolean };
 export interface IAuthService {
     login(data: LoginDto): Observable<JwtTokens>;
     generateTokens(data: GenerateTokensRequest): Observable<JwtTokens>;
-    createIdentity(data: CreateIdentityRequest): Observable<any>;
-    validate(data: { token: string }): Observable<{ valid: boolean; userId?: string; email?: string; role?: string }>;
+    createIdentity(data: CreateIdentityRequest): Observable<{ identityId: string }>;
+    validate(data: { token: string }): Observable<{ valid: boolean; userId?: string; email?: string; role?: UserRole }>;
     validateToken(data: ValidateTokenGrpcRequest): Observable<ValidateTokenGrpcResponse>;
     refreshToken(data: RefreshTokenGrpcRequest): Observable<JwtTokens>;
     revokeToken(data: RevokeTokenGrpcRequest): Observable<RevokeTokenGrpcResponse>;

package/src/dto/account.dto.ts

@@ -0,0 +1,28 @@
+import { IsString, IsOptional } from 'class-validator';
+
+export class CreateAccountDto {
+    @IsString()
+    accountNumber!: string;
+
+    @IsOptional()
+    @IsString()
+    clientNumber?: string;
+
+    @IsOptional()
+    @IsString()
+    currency?: string;
+
+    @IsOptional()
+    @IsString() // Or @IsNumber() depending on your schema. Assuming string for Decimal/Money
+    balance?: string;
+}
+
+export class UpdateAccountDto {
+    @IsOptional()
+    @IsString()
+    status?: string;
+
+    @IsOptional()
+    @IsString()
+    balance?: string;
+}