@takentrade/takentrade-libs 1.0.1 → 1.0.3

package/dist/auth/auth.module.d.ts

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

package/dist/auth/auth.module.js

@@ -0,0 +1,21 @@
+"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.TNTAuthModule = void 0;
+const common_1 = require("@nestjs/common");
+const auth_guard_1 = require("./guards/auth.guard");
+const roles_guard_1 = require("./guards/roles.guard");
+let TNTAuthModule = class TNTAuthModule {
+};
+exports.TNTAuthModule = TNTAuthModule;
+exports.TNTAuthModule = TNTAuthModule = __decorate([
+    (0, common_1.Module)({
+        providers: [auth_guard_1.TNTAuthGuard, roles_guard_1.RolesGuard],
+        exports: [auth_guard_1.TNTAuthGuard, roles_guard_1.RolesGuard],
+    })
+], TNTAuthModule);

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

@@ -0,0 +1,3 @@
+export * from './public.decorator';
+export * from './users.decorator';
+export * from './roles.decorator';

package/dist/auth/decorators/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./public.decorator"), exports);
+__exportStar(require("./users.decorator"), exports);
+__exportStar(require("./roles.decorator"), exports);

package/dist/auth/decorators/public.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const IS_PUBLIC_KEY = "isPublic";
+export declare const Public: () => import("@nestjs/common").CustomDecorator<string>;

package/dist/auth/decorators/public.decorator.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Public = exports.IS_PUBLIC_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.IS_PUBLIC_KEY = 'isPublic';
+const Public = () => (0, common_1.SetMetadata)(exports.IS_PUBLIC_KEY, true);
+exports.Public = Public;

package/dist/auth/decorators/roles.decorator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Metadata key for storing roles in the decorator.
+ */
+export declare const ROLES_KEY = "roles";
+/**
+ * Decorator to set required roles for a route or controller.
+ * @param roles List of role names required to access the resource.
+ * @returns Custom metadata decorator for role-based access control.
+ */
+export declare const Roles: (...roles: string[]) => import("@nestjs/common").CustomDecorator<string>;

package/dist/auth/decorators/roles.decorator.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Roles = exports.ROLES_KEY = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Metadata key for storing roles in the decorator.
+ */
+exports.ROLES_KEY = 'roles';
+/**
+ * Decorator to set required roles for a route or controller.
+ * @param roles List of role names required to access the resource.
+ * @returns Custom metadata decorator for role-based access control.
+ */
+const Roles = (...roles) => (0, common_1.SetMetadata)(exports.ROLES_KEY, roles);
+exports.Roles = Roles;

package/dist/auth/decorators/users.decorator.d.ts

@@ -0,0 +1,8 @@
+import { TokenPayload } from '../interfaces';
+/**
+ * Custom decorator to extract user data from the request.
+ * @param data Optional key of the TokenPayload to extract a specific property.
+ * @param ctx Execution context to access the request.
+ * @returns The user object or the specified property value.
+ */
+export declare const GetUser: (...dataOrPipes: (import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>> | keyof TokenPayload | undefined)[]) => ParameterDecorator;

package/dist/auth/decorators/users.decorator.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUser = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Extracts the user object or a specific property from the request's user payload.
+ * @param data Optional key of the TokenPayload to extract a specific property.
+ * @param ctx Execution context to access the request.
+ * @returns The entire user object or the specified property value.
+ * @throws UnauthorizedException if user or requested property is not found.
+ */
+const getUserHelpers = {
+    getUserFromRequest(request) {
+        const user = request.user;
+        if (!user) {
+            throw new common_1.UnauthorizedException('User not found in request');
+        }
+        return user;
+    },
+    getUserProperty(user, data) {
+        if (!data) {
+            return user;
+        }
+        if (data === 'sub') {
+            const value = user.id || user.sub;
+            if (!value) {
+                throw new common_1.UnauthorizedException('User ID not found');
+            }
+            return value;
+        }
+        const value = user[data];
+        if (value === undefined) {
+            throw new common_1.UnauthorizedException(`User ${data} not found`);
+        }
+        return value;
+    },
+};
+/**
+ * Custom decorator to extract user data from the request.
+ * @param data Optional key of the TokenPayload to extract a specific property.
+ * @param ctx Execution context to access the request.
+ * @returns The user object or the specified property value.
+ */
+exports.GetUser = (0, common_1.createParamDecorator)((data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    const user = getUserHelpers.getUserFromRequest(request);
+    return getUserHelpers.getUserProperty(user, data);
+});

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

@@ -0,0 +1,19 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+declare const TNTAuthGuard_base: import("@nestjs/passport").Type<import("@nestjs/passport").IAuthGuard>;
+/**
+ * Custom guard to validate JWT tokens and authorize requests using Passport JWT strategy.
+ * Allows public routes to bypass authentication if decorated with @Public().
+ */
+export declare class TNTAuthGuard extends TNTAuthGuard_base implements CanActivate {
+    private readonly reflector;
+    constructor(reflector: Reflector);
+    /**
+     * Determines if the request is authorized based on JWT validation.
+     * @param context Execution context containing the request.
+     * @returns True if the request is authorized or public, false otherwise.
+     * @throws UnauthorizedException if token validation fails.
+     */
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}
+export {};

package/dist/auth/guards/auth.guard.js

@@ -0,0 +1,66 @@
+"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.TNTAuthGuard = void 0;
+const common_1 = require("@nestjs/common");
+const passport_1 = require("@nestjs/passport");
+const public_decorator_1 = require("../decorators/public.decorator");
+/**
+ * Validates if the decoded JWT payload contains required AuthUser properties.
+ * @param payload The decoded JWT payload.
+ * @returns The validated AuthUser object with id, email, phone, isActive, and optional role.
+ * @throws UnauthorizedException if required properties are missing.
+ */
+function validateAuthUser(payload) {
+    if (!payload || typeof payload !== 'object') {
+        throw new common_1.UnauthorizedException('Invalid token payload');
+    }
+    const { id, email, phone, isActive, role } = payload;
+    if (!id || !email || !phone || isActive === undefined) {
+        throw new common_1.UnauthorizedException('Token payload missing required properties');
+    }
+    return { id, email, phone, isActive, role };
+}
+/**
+ * Custom guard to validate JWT tokens and authorize requests using Passport JWT strategy.
+ * Allows public routes to bypass authentication if decorated with @Public().
+ */
+let TNTAuthGuard = class TNTAuthGuard extends (0, passport_1.AuthGuard)('jwt') {
+    reflector;
+    constructor(reflector) {
+        super();
+        this.reflector = reflector;
+    }
+    /**
+     * Determines if the request is authorized based on JWT validation.
+     * @param context Execution context containing the request.
+     * @returns True if the request is authorized or public, false otherwise.
+     * @throws UnauthorizedException if token validation fails.
+     */
+    async canActivate(context) {
+        const isPublic = this.reflector.getAllAndOverride(public_decorator_1.IS_PUBLIC_KEY, [
+            context.getHandler(),
+            context.getClass(),
+        ]);
+        if (isPublic) {
+            return true;
+        }
+        const canActivate = await super.canActivate(context);
+        if (!canActivate) {
+            throw new common_1.UnauthorizedException('Invalid or expired token');
+        }
+        const request = context.switchToHttp().getRequest();
+        const user = request.user;
+        request.user = validateAuthUser(user);
+        return true;
+    }
+};
+exports.TNTAuthGuard = TNTAuthGuard;
+exports.TNTAuthGuard = TNTAuthGuard = __decorate([
+    (0, common_1.Injectable)()
+], TNTAuthGuard);

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

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

package/dist/auth/guards/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth.guard"), exports);
+__exportStar(require("./roles.guard"), exports);

package/dist/auth/guards/roles.guard.d.ts

@@ -0,0 +1,15 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+/**
+ * Guard to enforce role-based access control using the Roles decorator.
+ */
+export declare class RolesGuard implements CanActivate {
+    private reflector;
+    constructor(reflector: Reflector);
+    /**
+     * Checks if the user has one of the required roles to access the route.
+     * @param context Execution context containing the request.
+     * @returns True if the user has a required role or no roles are specified, false otherwise.
+     */
+    canActivate(context: ExecutionContext): boolean;
+}

package/dist/auth/guards/roles.guard.js

@@ -0,0 +1,41 @@
+"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.RolesGuard = void 0;
+const common_1 = require("@nestjs/common");
+const roles_decorator_1 = require("../decorators/roles.decorator");
+/**
+ * Guard to enforce role-based access control using the Roles decorator.
+ */
+let RolesGuard = class RolesGuard {
+    reflector;
+    constructor(reflector) {
+        this.reflector = reflector;
+    }
+    /**
+     * Checks if the user has one of the required roles to access the route.
+     * @param context Execution context containing the request.
+     * @returns True if the user has a required role or no roles are specified, false otherwise.
+     */
+    canActivate(context) {
+        const requiredRoles = this.reflector.getAllAndOverride(roles_decorator_1.ROLES_KEY, [context.getHandler(), context.getClass()]);
+        if (!requiredRoles || requiredRoles.length === 0) {
+            return true;
+        }
+        const request = context.switchToHttp().getRequest();
+        const user = request.user;
+        if (!user || !user.role) {
+            return false;
+        }
+        return requiredRoles.includes(user.role);
+    }
+};
+exports.RolesGuard = RolesGuard;
+exports.RolesGuard = RolesGuard = __decorate([
+    (0, common_1.Injectable)()
+], RolesGuard);

package/dist/auth/index.d.ts

@@ -0,0 +1,4 @@
+export * from './guards';
+export * from './decorators';
+export * from './auth.module';
+export * from './interfaces';

package/dist/auth/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./guards"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./auth.module"), exports);
+__exportStar(require("./interfaces"), exports);

package/dist/auth/interfaces/auth.interface.d.ts

@@ -0,0 +1,18 @@
+export interface AuthUser {
+    id: string;
+    email: string;
+    phone: string;
+    isActive: boolean;
+    role?: string;
+}
+export declare enum UserType {
+    CUSTOMER = "CUSTOMER",
+    STAFF = "STAFF"
+}
+export interface TokenPayload {
+    sub?: string;
+    id?: string;
+    email?: string;
+    role?: string;
+    [key: string]: any;
+}

package/dist/auth/interfaces/auth.interface.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserType = void 0;
+var UserType;
+(function (UserType) {
+    UserType["CUSTOMER"] = "CUSTOMER";
+    UserType["STAFF"] = "STAFF";
+})(UserType || (exports.UserType = UserType = {}));

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

@@ -0,0 +1 @@
+export * from './auth.interface';

package/dist/auth/interfaces/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth.interface"), exports);

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from './cache';
 export * from './utils';
 export * from './rpc';
 export * from './prisma';
+export * from './auth';

package/dist/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./cache"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./rpc"), exports);
 __exportStar(require("./prisma"), exports);
+__exportStar(require("./auth"), exports);

package/dist/utils/interfaces/config.interface.d.ts

@@ -2,6 +2,7 @@ export interface Configuration {
     PORT: number;
     HOST: string;
     DATABASE_URL: string;
+    NOTIFICATION_DB_URL: string;
     JWT_ACCESS_TOKEN_SECRET: string;
     JWT_ACCESS_TOKEN_EXPIRES_IN: string;
     JWT_REFRESH_TOKEN_SECRET: string;
@@ -11,8 +12,10 @@ export interface Configuration {
     REDIS_USERNAME?: string;
     REDIS_PASSWORD?: string;
     MAIL_HOST: string;
+    MAIL_PORT: number;
     MAIL_USER: string;
     MAIL_PASS: string;
+    MAIL_FROM: string;
     PROVIDUS_BASE_URL: string;
     PROVIDUS_SECRET_KEY: string;
     PROVIDUS_PUBLIC_KEY: string;
@@ -36,5 +39,12 @@ export interface Configuration {
     NATS_URL: string;
     CORS_ORIGIN: string;
     EXPO_ACCESS_TOKEN: string;
+    AFRICASTALKING_BASE_URL: string;
     AFRICASTALKING_API_KEY: string;
+    AFRICASTALKING_USERNAME: string;
+    TERMII_API_KEY: string;
+    TERMII_SECRET_KEY: string;
+    TERMII_BASE_URL: string;
+    TERMII_SENDER_ID: string;
+    TERMII_DEFAULT_CHANNEL: string;
 }

package/dist/utils/utils/configuration.js

@@ -41,20 +41,25 @@ exports.config = Joi.object({
     HOST: Joi.string().default('localhost'),
     // Database
     DATABASE_URL: Joi.string().uri().required(),
+    NOTIFICATION_DB_URL: Joi.string().uri().required(),
     // JWT
     JWT_ACCESS_TOKEN_SECRET: Joi.string().required(),
     JWT_ACCESS_TOKEN_EXPIRES_IN: Joi.string().default('90d'),
     JWT_REFRESH_TOKEN_SECRET: Joi.string().required(),
     JWT_REFRESH_TOKEN_EXPIRES_IN: Joi.string().default('30d'),
-    // Redis - Split configuration
+    // Redis
     REDIS_HOST: Joi.string().default('localhost'),
     REDIS_PORT: Joi.number().default(6379),
     REDIS_USERNAME: Joi.string().optional(),
     REDIS_PASSWORD: Joi.string().optional(),
     // Mail Settings
     MAIL_HOST: Joi.string().required(),
+    MAIL_PORT: Joi.number().required().default(587),
     MAIL_USER: Joi.string().required(),
     MAIL_PASS: Joi.string().required(),
+    MAIL_FROM: Joi.string()
+        .required()
+        .default('TakeNTrade <support@takentrade.com>'),
     // Providus Bank
     PROVIDUS_BASE_URL: Joi.string().uri().required(),
     PROVIDUS_SECRET_KEY: Joi.string().required(),
@@ -84,5 +89,14 @@ exports.config = Joi.object({
     NATS_URL: Joi.string().uri().default('nats://localhost:4222'),
     CORS_ORIGIN: Joi.string().default('*'),
     EXPO_ACCESS_TOKEN: Joi.string().required(),
+    // AfricasTalking
+    AFRICASTALKING_BASE_URL: Joi.string().required(),
     AFRICASTALKING_API_KEY: Joi.string().required(),
+    AFRICASTALKING_USERNAME: Joi.string().required(),
+    // Termii
+    TERMII_API_KEY: Joi.string().required(),
+    TERMII_SECRET_KEY: Joi.string().required(),
+    TERMII_BASE_URL: Joi.string().uri().required(),
+    TERMII_SENDER_ID: Joi.string().required(),
+    TERMII_DEFAULT_CHANNEL: Joi.string().required(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takentrade/takentrade-libs",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "TakeNTrade shared libraries",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -32,6 +32,7 @@
     "@nestjs/config": "^4.0.2",
     "@nestjs/jwt": "^11.0.0",
     "@nestjs/microservices": "^11.1.5",
+    "@nestjs/passport": "^11.0.5",
     "@nestjs/swagger": "^11.2.0",
     "@nestjs/terminus": "^11.0.0",
     "@prisma/client": "^6.12.0",
@@ -50,6 +51,7 @@
   "devDependencies": {
     "@types/node": "^24.1.0",
     "@types/object-hash": "^3.0.6",
+    "@types/passport": "^1.0.17",
     "prettier": "^3.6.2"
   },
   "exports": {