@takentrade/takentrade-libs 1.0.2 → 1.0.4

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,5 @@ export * from './cache';
 export * from './utils';
 export * from './rpc';
 export * from './prisma';
+export * from './auth';
+export * from './notification';

package/dist/index.js

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

package/dist/notification/index.d.ts

@@ -0,0 +1,4 @@
+export * from './notification.client';
+export * from './notification.interface';
+export * from './notification.enum';
+export * from './notification.module';

package/dist/notification/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("./notification.client"), exports);
+__exportStar(require("./notification.interface"), exports);
+__exportStar(require("./notification.enum"), exports);
+__exportStar(require("./notification.module"), exports);

package/dist/notification/notification.client.d.ts

@@ -0,0 +1,50 @@
+import { ClientProxy } from '@nestjs/microservices';
+import { OTPNotificationChannel } from './notification.enum';
+import { AccountFreezeEmailData, AccountStatementEmailData, AccountUnfreezeEmailData, AjoCancellationEmailData, AjoContributionEmailData, AjoInviteEmailData, AjoMembershipUpdateEmailData, ContactMessageEmailData, CreditTransactionMailData, CustomMailSendOptions, DebitTransactionMailData, InvestmentCancellationEmailData, LoanApprovedEmailData, LoanRepaymentConfirmationEmailData, LoanRepaymentFailedEmailData, NewLoanApplicationEmailData, OTPMailData, PasswordResetMailData, ResetTransactionPinEmailData, AjoContributionConfirmationEmailData, InvestmentConfirmationEmailData, SendPushNotificationInput, BaseEmailData } from './notification.interface';
+export declare class NotificationClient {
+    private readonly natsClient;
+    constructor(natsClient: ClientProxy);
+    private validatePhoneNumber;
+    private validateEmailAddress;
+    sendSms(to: string, message: string): Promise<void>;
+    /**
+     * This utility method sends an OTP message via the SMS channel.
+     *
+     * @param to - The recipient phone number
+     * @param message - The OTP message
+     * @deprecated
+     */
+    sendSmsOTP(to: string, message: string): Promise<void>;
+    sendCustomMail(to: string, options: CustomMailSendOptions): Promise<void>;
+    sendPasswordResetMail(to: string, data: PasswordResetMailData): Promise<void>;
+    sendCreditTransactionMail(to: string, data: CreditTransactionMailData): Promise<void>;
+    sendDebitTransactionMail(to: string, data: DebitTransactionMailData): Promise<void>;
+    sendAccountFreezeMail(to: string, data: AccountFreezeEmailData): Promise<void>;
+    sendAccountStatementMail(to: string, data: AccountStatementEmailData): Promise<void>;
+    sendAccountUnfreezeMail(to: string, data: AccountUnfreezeEmailData): Promise<void>;
+    sendAdminNewLoanMail(to: string, data: NewLoanApplicationEmailData): Promise<void>;
+    sendAjoCancellationMail(to: string, data: AjoCancellationEmailData): Promise<void>;
+    sendAjoContributionMail(to: string, data: AjoContributionEmailData): Promise<void>;
+    sendAjoInvitationMail(to: string, data: AjoInviteEmailData): Promise<void>;
+    sendAjoMembershipMail(to: string, data: AjoMembershipUpdateEmailData): Promise<void>;
+    sendContactMail(to: string, data: ContactMessageEmailData): Promise<void>;
+    sendForgetPinOTPMail(to: string, data: ResetTransactionPinEmailData): Promise<void>;
+    sendInvestmentCancellationMail(to: string, data: InvestmentCancellationEmailData): Promise<void>;
+    sendLoanApprovedMail(to: string, data: LoanApprovedEmailData): Promise<void>;
+    sendLoanRepaymentFailedMail(to: string, data: LoanRepaymentFailedEmailData): Promise<void>;
+    sendLoanRepaymentSuccessMail(to: string, data: LoanRepaymentConfirmationEmailData): Promise<void>;
+    sendNewAjoMail(to: string, data: AjoContributionConfirmationEmailData): Promise<void>;
+    sendNewInvestmentMail(to: string, data: InvestmentConfirmationEmailData): Promise<void>;
+    sendWelcomeMail(to: string, data: BaseEmailData): Promise<void>;
+    /**
+     * Sends generated OTP to a recipient
+     * @param to - recipient phone number or email
+     * @param data - OTP data
+     * @param channel - OTP notification channel. Defaults to sms.
+     */
+    sendOTP(to: string, data: OTPMailData, channel?: OTPNotificationChannel): Promise<void>;
+    /**
+     * Sends push notification
+     */
+    sendPush(input: SendPushNotificationInput): Promise<void>;
+}

package/dist/notification/notification.client.js

@@ -0,0 +1,211 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationClient = void 0;
+const common_1 = require("@nestjs/common");
+const notification_enum_1 = require("./notification.enum");
+const nats_1 = require("../nats");
+const class_validator_1 = require("class-validator");
+let NotificationClient = class NotificationClient {
+    natsClient;
+    constructor(natsClient) {
+        this.natsClient = natsClient;
+    }
+    validatePhoneNumber(phone) {
+        if (!(0, class_validator_1.isPhoneNumber)(phone)) {
+            throw new common_1.BadRequestException('Invalid phone number');
+        }
+    }
+    validateEmailAddress(email) {
+        if (!(0, class_validator_1.isEmail)(email)) {
+            throw new common_1.BadRequestException('Invalid email address');
+        }
+    }
+    async sendSms(to, message) {
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NOTIFICATION_TEXT, {
+            to: to.slice(1),
+            message,
+        });
+    }
+    /**
+     * This utility method sends an OTP message via the SMS channel.
+     *
+     * @param to - The recipient phone number
+     * @param message - The OTP message
+     * @deprecated
+     */
+    async sendSmsOTP(to, message) {
+        this.natsClient.emit(`notification.sms.otp`, {
+            to: to.slice(1),
+            message,
+        });
+    }
+    async sendCustomMail(to, options) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NOTIFICATION_MAIL, {
+            to,
+            ...options,
+        });
+    }
+    async sendPasswordResetMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.PASSWORD_RESET_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendCreditTransactionMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.TRANSANCTION_CREDIT_MAIL, { to, data });
+    }
+    async sendDebitTransactionMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.TRANSANCTION_DEBIT_MAIL, { to, data });
+    }
+    async sendAccountFreezeMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.ACCOUNT_FREEZE_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendAccountStatementMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.ACCOUNT_STATEMENT_MAIL, { to, data });
+    }
+    async sendAccountUnfreezeMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.ACCOUNT_UNFREEZE_MAIL, { to, data });
+    }
+    async sendAdminNewLoanMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.ADMIN_NEW_LOAN_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendAjoCancellationMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.AJO_CANCELLATION_MAIL, { to, data });
+    }
+    async sendAjoContributionMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.AJO_CONTRIBUTION_MAIL, { to, data });
+    }
+    async sendAjoInvitationMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.AJO_INVITATION_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendAjoMembershipMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.AJO_MEMBERSHIP_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendContactMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.CONTACT_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendForgetPinOTPMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.FORGET_PIN_OTP_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendInvestmentCancellationMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.INVESTMENT_CANCELLATION_MAIL, { to, data });
+    }
+    async sendLoanApprovedMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.LOAN_APPROVED_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendLoanRepaymentFailedMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.LOAN_REPAYMENT_FAILED_MAIL, { to, data });
+    }
+    async sendLoanRepaymentSuccessMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.LOAN_REPAYMENT_SUCCESS_MAIL, { to, data });
+    }
+    async sendNewAjoMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NEW_AJO_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendNewInvestmentMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NEW_INVESTMENT_MAIL, {
+            to,
+            data,
+        });
+    }
+    async sendWelcomeMail(to, data) {
+        this.validateEmailAddress(to);
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.WELCOME_MAIL, {
+            to,
+            data,
+        });
+    }
+    /**
+     * Sends generated OTP to a recipient
+     * @param to - recipient phone number or email
+     * @param data - OTP data
+     * @param channel - OTP notification channel. Defaults to sms.
+     */
+    async sendOTP(to, data, channel = notification_enum_1.OTPNotificationChannel.sms) {
+        if (channel == notification_enum_1.OTPNotificationChannel.mail) {
+            this.validateEmailAddress(to);
+            this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.OTP_MAIL, {
+                to,
+                ...data,
+            });
+        }
+        else if (channel == notification_enum_1.OTPNotificationChannel.sms) {
+            this.validatePhoneNumber(to);
+            this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NOTIFICATION_OTP_TEXT, { to, ...data });
+        }
+        else if (channel == notification_enum_1.OTPNotificationChannel.voice) {
+            this.validatePhoneNumber(to);
+            this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NOTIFICATION_OTP_VOICE, { to, ...data });
+        }
+        else {
+            throw new common_1.BadRequestException('Invalid OTP channel');
+        }
+    }
+    /**
+     * Sends push notification
+     */
+    async sendPush(input) {
+        if (!input.tokens?.length && !input.userId) {
+            throw new common_1.BadRequestException('You must provide a device tokens array or a userId');
+        }
+        this.natsClient.emit(notification_enum_1.NotificationSubcribedNATSSubject.NOTIFICATION_PUSH, input);
+    }
+};
+exports.NotificationClient = NotificationClient;
+exports.NotificationClient = NotificationClient = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(nats_1.NATS_CLIENT))
+], NotificationClient);

package/dist/notification/notification.enum.d.ts

@@ -0,0 +1,36 @@
+export declare enum NotificationTextChannel {
+    sms = "sms"
+}
+export declare enum OTPNotificationChannel {
+    sms = "sms",
+    voice = "voice",
+    mail = "mail"
+}
+export declare enum NotificationSubcribedNATSSubject {
+    NOTIFICATION_MAIL = "notification.mail",
+    OTP_MAIL = "notification.mail.otp",
+    WELCOME_MAIL = "notification.mail.welcome",
+    PASSWORD_RESET_MAIL = "notification.mail.passwordreset",
+    TRANSANCTION_DEBIT_MAIL = "notification.mail.transaction.debit",
+    TRANSANCTION_CREDIT_MAIL = "notification.mail.transaction.credit",
+    ACCOUNT_FREEZE_MAIL = "notification.mail.account.freeze",
+    ACCOUNT_STATEMENT_MAIL = "notification.mail.account.statement",
+    ACCOUNT_UNFREEZE_MAIL = "notification.mail.account.unfreeze",
+    ADMIN_NEW_LOAN_MAIL = "notification.mail.admin.loan.new",
+    AJO_CANCELLATION_MAIL = "notification.mail.ajo.cancellation",
+    AJO_CONTRIBUTION_MAIL = "notification.mail.ajo.contribution",
+    AJO_INVITATION_MAIL = "notification.mail.ajo.invitation",
+    AJO_MEMBERSHIP_MAIL = "notification.mail.ajo.membership",
+    CONTACT_MAIL = "notification.mail.contact",
+    FORGET_PIN_OTP_MAIL = "notification.mail.forgetpin.otp",
+    INVESTMENT_CANCELLATION_MAIL = "notification.mail.investment.cancellation",
+    LOAN_APPROVED_MAIL = "notification.mail.loan.approved",
+    LOAN_REPAYMENT_FAILED_MAIL = "notification.mail.loan.repayment.failed",
+    LOAN_REPAYMENT_SUCCESS_MAIL = "notification.mail.loan.repayment.success",
+    NEW_AJO_MAIL = "notification.mail.ajo.new",
+    NEW_INVESTMENT_MAIL = "notification.mail.investment.new",
+    NOTIFICATION_TEXT = "notification.text",
+    NOTIFICATION_OTP_TEXT = "notification.text.otp",
+    NOTIFICATION_OTP_VOICE = "notification.voice.otp",
+    NOTIFICATION_PUSH = "notification.push"
+}

package/dist/notification/notification.enum.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationSubcribedNATSSubject = exports.OTPNotificationChannel = exports.NotificationTextChannel = void 0;
+var NotificationTextChannel;
+(function (NotificationTextChannel) {
+    NotificationTextChannel["sms"] = "sms";
+})(NotificationTextChannel || (exports.NotificationTextChannel = NotificationTextChannel = {}));
+var OTPNotificationChannel;
+(function (OTPNotificationChannel) {
+    OTPNotificationChannel["sms"] = "sms";
+    OTPNotificationChannel["voice"] = "voice";
+    OTPNotificationChannel["mail"] = "mail";
+})(OTPNotificationChannel || (exports.OTPNotificationChannel = OTPNotificationChannel = {}));
+var NotificationSubcribedNATSSubject;
+(function (NotificationSubcribedNATSSubject) {
+    // MAIL
+    NotificationSubcribedNATSSubject["NOTIFICATION_MAIL"] = "notification.mail";
+    NotificationSubcribedNATSSubject["OTP_MAIL"] = "notification.mail.otp";
+    NotificationSubcribedNATSSubject["WELCOME_MAIL"] = "notification.mail.welcome";
+    NotificationSubcribedNATSSubject["PASSWORD_RESET_MAIL"] = "notification.mail.passwordreset";
+    NotificationSubcribedNATSSubject["TRANSANCTION_DEBIT_MAIL"] = "notification.mail.transaction.debit";
+    NotificationSubcribedNATSSubject["TRANSANCTION_CREDIT_MAIL"] = "notification.mail.transaction.credit";
+    NotificationSubcribedNATSSubject["ACCOUNT_FREEZE_MAIL"] = "notification.mail.account.freeze";
+    NotificationSubcribedNATSSubject["ACCOUNT_STATEMENT_MAIL"] = "notification.mail.account.statement";
+    NotificationSubcribedNATSSubject["ACCOUNT_UNFREEZE_MAIL"] = "notification.mail.account.unfreeze";
+    NotificationSubcribedNATSSubject["ADMIN_NEW_LOAN_MAIL"] = "notification.mail.admin.loan.new";
+    NotificationSubcribedNATSSubject["AJO_CANCELLATION_MAIL"] = "notification.mail.ajo.cancellation";
+    NotificationSubcribedNATSSubject["AJO_CONTRIBUTION_MAIL"] = "notification.mail.ajo.contribution";
+    NotificationSubcribedNATSSubject["AJO_INVITATION_MAIL"] = "notification.mail.ajo.invitation";
+    NotificationSubcribedNATSSubject["AJO_MEMBERSHIP_MAIL"] = "notification.mail.ajo.membership";
+    NotificationSubcribedNATSSubject["CONTACT_MAIL"] = "notification.mail.contact";
+    NotificationSubcribedNATSSubject["FORGET_PIN_OTP_MAIL"] = "notification.mail.forgetpin.otp";
+    NotificationSubcribedNATSSubject["INVESTMENT_CANCELLATION_MAIL"] = "notification.mail.investment.cancellation";
+    NotificationSubcribedNATSSubject["LOAN_APPROVED_MAIL"] = "notification.mail.loan.approved";
+    NotificationSubcribedNATSSubject["LOAN_REPAYMENT_FAILED_MAIL"] = "notification.mail.loan.repayment.failed";
+    NotificationSubcribedNATSSubject["LOAN_REPAYMENT_SUCCESS_MAIL"] = "notification.mail.loan.repayment.success";
+    NotificationSubcribedNATSSubject["NEW_AJO_MAIL"] = "notification.mail.ajo.new";
+    NotificationSubcribedNATSSubject["NEW_INVESTMENT_MAIL"] = "notification.mail.investment.new";
+    // TEXT
+    NotificationSubcribedNATSSubject["NOTIFICATION_TEXT"] = "notification.text";
+    NotificationSubcribedNATSSubject["NOTIFICATION_OTP_TEXT"] = "notification.text.otp";
+    // VOICE
+    NotificationSubcribedNATSSubject["NOTIFICATION_OTP_VOICE"] = "notification.voice.otp";
+    // PUSH
+    NotificationSubcribedNATSSubject["NOTIFICATION_PUSH"] = "notification.push";
+})(NotificationSubcribedNATSSubject || (exports.NotificationSubcribedNATSSubject = NotificationSubcribedNATSSubject = {}));

package/dist/notification/notification.interface.d.ts

@@ -0,0 +1,133 @@
+import { MulterFile } from '../utils';
+export interface CustomMailSendOptions {
+    subject: string;
+    from?: string;
+    text?: string;
+    html?: string;
+    template?: string | Buffer;
+    attachments?: MulterFile[] | Buffer[];
+    data?: object;
+}
+export interface TemplateMailSendOption<D = Record<string, string | number>> {
+    to: string[];
+    attachments?: MulterFile[] | Buffer[];
+    data?: D;
+}
+export interface BaseEmailData {
+    firstName: string;
+    currentYear: number;
+}
+export interface OTPMailData extends BaseEmailData {
+    otp: string;
+    expiration: string;
+}
+export interface PasswordResetMailData extends OTPMailData {
+}
+export interface BaseTransactionMailData extends BaseEmailData {
+    amount: string;
+    currency: string;
+    type: string;
+    direction: string;
+    totalAmount: string;
+    paymentReference: string;
+    description: string;
+    createdAt: string;
+    beneficiaryAccountName?: string;
+    beneficiaryAccountNumber?: string;
+}
+export interface CreditTransactionMailData extends BaseTransactionMailData {
+}
+export interface DebitTransactionMailData extends BaseTransactionMailData {
+}
+export interface AccountFreezeEmailData extends BaseEmailData {
+    freezeDate: string;
+    reason: string;
+}
+export interface AccountStatementEmailData extends BaseEmailData {
+    userName: string;
+    startDate: string;
+    format: 'pdf' | 'csv' | 'xlsx';
+    expiryDate: string;
+    statementUrl: string;
+    isAdmin?: boolean;
+}
+export interface AccountUnfreezeEmailData extends BaseEmailData {
+    unfreezeDate: string;
+    reason: string;
+}
+export interface NewLoanApplicationEmailData extends BaseEmailData {
+    amount: number;
+    repaymentDate: string;
+    status: 'pending' | 'approved' | 'rejected';
+}
+export interface AjoCancellationEmailData extends BaseEmailData {
+    ajoName: string;
+    refundAmount: number;
+}
+export interface AjoContributionEmailData extends BaseEmailData {
+    amount: number;
+    ajoName: string;
+}
+export interface AjoInviteEmailData extends BaseEmailData {
+    ajoName: string;
+    acceptUrl: string;
+}
+export interface AjoMembershipUpdateEmailData extends BaseEmailData {
+    ajoName: string;
+    status: 'active' | 'inactive' | 'pending' | 'cancelled';
+}
+export interface ContactMessageEmailData extends BaseEmailData {
+    name: string;
+    email: string;
+    message: string;
+}
+export interface ResetTransactionPinEmailData extends BaseEmailData {
+    otpCode: string;
+    expiryMinutes: number;
+}
+export interface InvestmentCancellationEmailData extends BaseEmailData {
+    amount: number;
+    reason: string;
+}
+export interface LoanApprovedEmailData extends BaseEmailData {
+    amount: number;
+    repaymentDate: string;
+    status: 'approved';
+}
+export interface LoanRepaymentFailedEmailData extends BaseEmailData {
+    amount: number;
+    repaymentDate: string;
+}
+export interface LoanRepaymentConfirmationEmailData extends BaseEmailData {
+    amount: number;
+    remainingBalance?: number;
+    isFullyRepaid: boolean;
+    wasDefaulted?: boolean;
+}
+export interface AjoContributionConfirmationEmailData extends BaseEmailData {
+    ajoName: string;
+    amount: number;
+    frequency: 'daily' | 'weekly' | 'monthly';
+    startDate: string;
+    duration: number;
+}
+export interface InvestmentConfirmationEmailData extends BaseEmailData {
+    type: string;
+    amount: number;
+    duration: string;
+    startDate: string;
+    maturityDate: string;
+    expectedReturn: number;
+}
+export interface SendPushNotificationInput {
+    title: string;
+    body: string;
+    userId?: string;
+    tokens?: string[];
+    data?: {
+        resourceType: string;
+        resourceId: string;
+    };
+    priority?: boolean;
+    topic?: string;
+}

package/dist/notification/notification.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/notification/notification.module.d.ts

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

package/dist/notification/notification.module.js

@@ -0,0 +1,20 @@
+"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.NotificationClientModule = void 0;
+const common_1 = require("@nestjs/common");
+const notification_client_1 = require("./notification.client");
+let NotificationClientModule = class NotificationClientModule {
+};
+exports.NotificationClientModule = NotificationClientModule;
+exports.NotificationClientModule = NotificationClientModule = __decorate([
+    (0, common_1.Module)({
+        providers: [notification_client_1.NotificationClient],
+        exports: [notification_client_1.NotificationClient],
+    })
+], NotificationClientModule);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takentrade/takentrade-libs",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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": {