@takentrade/takentrade-libs 3.3.3 → 4.0.0

package/dist/common/enums/transaction.enum.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Frequency = exports.AjoType = exports.AjoMembershipStatus = exports.AjoStatus = exports.SavingsStatus = exports.LoanStatus = exports.TransactionStatus = exports.TransactionCategory = exports.TransactionType = void 0;
+var TransactionType;
+(function (TransactionType) {
+    TransactionType["CREDIT"] = "CREDIT";
+    TransactionType["DEBIT"] = "DEBIT";
+    TransactionType["DEPOSIT"] = "DEPOSIT";
+    TransactionType["TOP_UP"] = "TOP_UP";
+    TransactionType["WITHDRAWAL"] = "WITHDRAWAL";
+    TransactionType["INTEREST_ACCRUAL"] = "INTEREST_ACCRUAL";
+    TransactionType["TAX_DEDUCTION"] = "TAX_DEDUCTION";
+    TransactionType["PAUSE"] = "PAUSE";
+    TransactionType["CONTRIBUTION"] = "CONTRIBUTION";
+    TransactionType["PAYOUT"] = "PAYOUT";
+    TransactionType["FEE_DEDUCTION"] = "FEE_DEDUCTION";
+})(TransactionType || (exports.TransactionType = TransactionType = {}));
+var TransactionCategory;
+(function (TransactionCategory) {
+    TransactionCategory["DEPOSIT"] = "DEPOSIT";
+    TransactionCategory["WITHDRAWAL"] = "WITHDRAWAL";
+    TransactionCategory["LOAN_DISBURSEMENT"] = "LOAN_DISBURSEMENT";
+    TransactionCategory["LOAN_REPAYMENT"] = "LOAN_REPAYMENT";
+    TransactionCategory["AJO_CONTRIBUTION"] = "AJO_CONTRIBUTION";
+    TransactionCategory["AJO_TOPUP"] = "AJO_TOPUP";
+    TransactionCategory["AJO_COMPLETION"] = "AJO_COMPLETION";
+    TransactionCategory["AIRTIME"] = "AIRTIME";
+    TransactionCategory["DATA"] = "DATA";
+    TransactionCategory["ELECTRICITY"] = "ELECTRICITY";
+    TransactionCategory["CABLETV"] = "CABLETV";
+    TransactionCategory["BETTING"] = "BETTING";
+    TransactionCategory["INTERNET"] = "INTERNET";
+    TransactionCategory["EDUCATION"] = "EDUCATION";
+    TransactionCategory["TRANSPORT"] = "TRANSPORT";
+    TransactionCategory["DONATION"] = "DONATION";
+    TransactionCategory["INSURANCE"] = "INSURANCE";
+    TransactionCategory["TAX"] = "TAX";
+    TransactionCategory["RELIGION"] = "RELIGION";
+    TransactionCategory["TRANSFER"] = "TRANSFER";
+    TransactionCategory["REFERRAL_BONUS"] = "REFERRAL_BONUS";
+    TransactionCategory["FEES"] = "FEES";
+    TransactionCategory["FEE_COLLECTION"] = "FEE_COLLECTION";
+    TransactionCategory["PENALTY"] = "PENALTY";
+    TransactionCategory["LOAN_INTEREST"] = "LOAN_INTEREST";
+    TransactionCategory["AJO_FEE"] = "AJO_FEE";
+})(TransactionCategory || (exports.TransactionCategory = TransactionCategory = {}));
+var TransactionStatus;
+(function (TransactionStatus) {
+    TransactionStatus["PENDING"] = "PENDING";
+    TransactionStatus["SUCCESSFUL"] = "SUCCESSFUL";
+    TransactionStatus["FAILED"] = "FAILED";
+    TransactionStatus["REVERSED"] = "REVERSED";
+})(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+var LoanStatus;
+(function (LoanStatus) {
+    LoanStatus["PENDING"] = "PENDING";
+    LoanStatus["APPROVED"] = "APPROVED";
+    LoanStatus["DISBURSED"] = "DISBURSED";
+    LoanStatus["REPAID"] = "REPAID";
+    LoanStatus["OVERDUE"] = "OVERDUE";
+    LoanStatus["DECLINED"] = "DECLINED";
+})(LoanStatus || (exports.LoanStatus = LoanStatus = {}));
+var SavingsStatus;
+(function (SavingsStatus) {
+    SavingsStatus["ACTIVE"] = "ACTIVE";
+    SavingsStatus["MATURED"] = "MATURED";
+    SavingsStatus["CLOSED"] = "CLOSED";
+    SavingsStatus["PENDING"] = "PENDING";
+    SavingsStatus["SUSPENDED"] = "SUSPENDED";
+})(SavingsStatus || (exports.SavingsStatus = SavingsStatus = {}));
+var AjoStatus;
+(function (AjoStatus) {
+    AjoStatus["ACTIVE"] = "ACTIVE";
+    AjoStatus["COMPLETED"] = "COMPLETED";
+    AjoStatus["CANCELLED"] = "CANCELLED";
+    AjoStatus["PAUSED"] = "PAUSED";
+})(AjoStatus || (exports.AjoStatus = AjoStatus = {}));
+var AjoMembershipStatus;
+(function (AjoMembershipStatus) {
+    AjoMembershipStatus["PENDING"] = "PENDING";
+    AjoMembershipStatus["ACTIVE"] = "ACTIVE";
+    AjoMembershipStatus["INACTIVE"] = "INACTIVE";
+    AjoMembershipStatus["REMOVED"] = "REMOVED";
+})(AjoMembershipStatus || (exports.AjoMembershipStatus = AjoMembershipStatus = {}));
+var AjoType;
+(function (AjoType) {
+    AjoType["PERSONAL"] = "PERSONAL";
+    AjoType["FAMILY"] = "FAMILY";
+    AjoType["FRIEND"] = "FRIEND";
+    AjoType["GROUP"] = "GROUP";
+})(AjoType || (exports.AjoType = AjoType = {}));
+var Frequency;
+(function (Frequency) {
+    Frequency["DAILY"] = "DAILY";
+    Frequency["WEEKLY"] = "WEEKLY";
+    Frequency["MONTHLY"] = "MONTHLY";
+})(Frequency || (exports.Frequency = Frequency = {}));

package/dist/common/index.d.ts

@@ -1,3 +1,4 @@
 export * from './constants';
 export * from './enums';
 export * from './utils';
+export * from './dto';

package/dist/common/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./dto"), exports);

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './bullmq';
 export * from './cache';
 export * from './utils';
 export * from './rpc';
+export * from './logging';
 export * from './auth';
 export * from './notification';
 export * from './resilience';

package/dist/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./bullmq"), exports);
 __exportStar(require("./cache"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./rpc"), exports);
+__exportStar(require("./logging"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./notification"), exports);
 __exportStar(require("./resilience"), exports);

package/dist/logging/index.d.ts

@@ -0,0 +1,3 @@
+export * from './logger.service';
+export * from './logger.module';
+export type { LogContext } from './logger.service';

package/dist/logging/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("./logger.service"), exports);
+__exportStar(require("./logger.module"), exports);

package/dist/logging/logger.module.d.ts

@@ -0,0 +1,6 @@
+/**
+ * TNT Logger Module - Global module for logging
+ * Import this module to use TntLoggerService across your application
+ */
+export declare class TntLoggerModule {
+}

package/dist/logging/logger.module.js

@@ -0,0 +1,25 @@
+"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.TntLoggerModule = void 0;
+const common_1 = require("@nestjs/common");
+const logger_service_1 = require("./logger.service");
+/**
+ * TNT Logger Module - Global module for logging
+ * Import this module to use TntLoggerService across your application
+ */
+let TntLoggerModule = class TntLoggerModule {
+};
+exports.TntLoggerModule = TntLoggerModule;
+exports.TntLoggerModule = TntLoggerModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [logger_service_1.TntLoggerService],
+        exports: [logger_service_1.TntLoggerService],
+    })
+], TntLoggerModule);

package/dist/logging/logger.service.d.ts

@@ -0,0 +1,48 @@
+import { LoggerService as NestLoggerService } from '@nestjs/common';
+export interface LogContext {
+    correlationId?: string;
+    userId?: string;
+    service?: string;
+    [key: string]: any;
+}
+/**
+ * TNT Logger Service - Pino-based structured JSON logger
+ * Provides consistent logging across all microservices
+ */
+export declare class TntLoggerService implements NestLoggerService {
+    private logger;
+    private context;
+    constructor(context?: LogContext);
+    /**
+     * Set context for all subsequent log messages
+     */
+    setContext(context: LogContext): void;
+    /**
+     * Log info message
+     */
+    log(message: string, context?: LogContext): void;
+    /**
+     * Log error message
+     */
+    error(message: string, trace?: string, context?: LogContext): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log debug message
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log verbose message
+     */
+    verbose(message: string, context?: LogContext): void;
+    /**
+     * Log HTTP request
+     */
+    logRequest(req: any, context?: LogContext): void;
+    /**
+     * Log HTTP response
+     */
+    logResponse(req: any, res: any, responseTime: number, context?: LogContext): void;
+}

package/dist/logging/logger.service.js

@@ -0,0 +1,107 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TntLoggerService = void 0;
+const common_1 = require("@nestjs/common");
+const pino_1 = __importDefault(require("pino"));
+/**
+ * TNT Logger Service - Pino-based structured JSON logger
+ * Provides consistent logging across all microservices
+ */
+let TntLoggerService = class TntLoggerService {
+    logger;
+    context = {};
+    constructor(context) {
+        const isDevelopment = process.env.NODE_ENV !== 'production';
+        this.logger = (0, pino_1.default)({
+            level: process.env.LOG_LEVEL || 'info',
+            ...(isDevelopment && {
+                transport: {
+                    target: 'pino-pretty',
+                    options: {
+                        colorize: true,
+                        translateTime: 'HH:MM:ss Z',
+                        ignore: 'pid,hostname',
+                    },
+                },
+            }),
+        });
+        if (context) {
+            this.context = context;
+        }
+    }
+    /**
+     * Set context for all subsequent log messages
+     */
+    setContext(context) {
+        this.context = { ...this.context, ...context };
+    }
+    /**
+     * Log info message
+     */
+    log(message, context) {
+        this.logger.info({ ...this.context, ...context }, message);
+    }
+    /**
+     * Log error message
+     */
+    error(message, trace, context) {
+        this.logger.error({ ...this.context, ...context, trace }, message);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.logger.warn({ ...this.context, ...context }, message);
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.logger.debug({ ...this.context, ...context }, message);
+    }
+    /**
+     * Log verbose message
+     */
+    verbose(message, context) {
+        this.logger.trace({ ...this.context, ...context }, message);
+    }
+    /**
+     * Log HTTP request
+     */
+    logRequest(req, context) {
+        this.logger.info({
+            ...this.context,
+            ...context,
+            method: req.method,
+            url: req.url,
+            userAgent: req.headers?.['user-agent'],
+            ip: req.ip,
+        }, 'HTTP Request');
+    }
+    /**
+     * Log HTTP response
+     */
+    logResponse(req, res, responseTime, context) {
+        this.logger.info({
+            ...this.context,
+            ...context,
+            method: req.method,
+            url: req.url,
+            statusCode: res.statusCode,
+            responseTime: `${responseTime}ms`,
+        }, 'HTTP Response');
+    }
+};
+exports.TntLoggerService = TntLoggerService;
+exports.TntLoggerService = TntLoggerService = __decorate([
+    (0, common_1.Injectable)()
+], TntLoggerService);

package/dist/nats/constants/nats.constants.d.ts

@@ -8,14 +8,9 @@ export declare const DEFAULT_NATS_CONFIG: {
     maxReconnectAttempts: number;
 };
 export declare enum NatsSubjects {
-    SUBACCOUNT_UPDATE_AMOUNT = "subaccount.amount.update",
-    SUBACCOUNT_GET_BY_ID = "subaccount.get.by.id",
-    SUBACCOUNT_GET_ALL = "subaccount.get.all",
     USER_CHECK = "user.check",
     USER_CREATED = "user.created",
     USER_GET_PREFERENCE = "user.preference.get",
-    NOTIFICATION_UPDATE_TOKEN = "notification.token.update",
-    NOTIFICATION_SEND = "notification.send",
     NOTIFICATION_GET_ALL = "notification.get.all",
     NOTIFICATION_GET_BY_ID = "notification.get.by.id",
     NOTIFICATION_MARK_AS_READ = "notification.mark.as.read",
@@ -25,27 +20,19 @@ export declare enum NatsSubjects {
     GET_ALL_USERS_FCM_TOKENS = "user.get.all.fcm_tokens",
     GET_USER_BY_ID = "user.get.by_id",
     GET_USER_BALANCE = "user.get.balance",
-    CHAT_GET_CONVERSATIONS = "chat.conversations.get",
-    CHAT_GET_CONVERSATION = "chat.conversation.get",
-    CHAT_GET_MESSAGES = "chat.messages.get",
-    CHAT_CLOSE_CONVERSATION = "chat.conversation.close",
-    CHAT_ASSIGN_SUPPORT = "chat.conversation.assign",
-    AJO_PLANS_GET = "ajo.plans.get",
-    AJO_CREATE = "ajo.create",
-    AJO_LIST = "ajo.list",
-    AJO_GET = "ajo.get",
-    AJO_JOIN = "ajo.join",
-    AJO_CONTRIBUTE = "ajo.contribute",
-    AJO_PAYOUT = "ajo.payout",
-    AJO_CONTRIBUTIONS_GET = "ajo.contributions.get",
-    AJO_UPDATE = "ajo.update",
-    AJO_ADMIN_CYCLE = "ajo.admin.cycle",
     PROVIDUS_GET_ACCOUNT = "providus.account.get",
     PROVIDUS_DEBIT_CUSTOMER = "providus.customer.debit",
     PROVIDUS_CREDIT_CUSTOMER = "providus.customer.credit",
-    ACCOUNT_ADD_HOLD = "account.hold.add",
-    ACCOUNT_GET_HOLDS = "account.holds.get",
-    ACCOUNT_RELEASE_HOLD = "account.hold.release",
-    ADMIN_GET_ALL_HOLDS = "admin.holds.get.all",
+    CREATE_PROVIDUS_ACCOUNT = "providus.account.create",
+    KYC_VERIFIED = "kyc.verified",
+    KYC_REJECTED = "kyc.rejected",
+    VAS_TRANSACTION_SUCCESS = "vas.transaction.success",
+    VAS_TRANSACTION_FAILED = "vas.transaction.failed",
+    AJO_MEMBER_JOINED = "ajo.member.joined",
+    AJO_CONTRIBUTION_SUCCESS = "ajo.contribution.success",
+    AJO_MATURED = "ajo.matured",
+    REFERRAL_REWARD_CLAIMED = "referral.reward.claimed",
+    WITHDRAWAL_REQUESTED = "withdrawal.requested",
+    WITHDRAWAL_PROCESSED = "withdrawal.processed",
     ADMIN_GET_TERMII_BALANCE = "admin.termii.balance.get"
 }

package/dist/nats/constants/nats.constants.js

@@ -12,17 +12,11 @@ exports.DEFAULT_NATS_CONFIG = {
 };
 var NatsSubjects;
 (function (NatsSubjects) {
-    // Subaccount operations
-    NatsSubjects["SUBACCOUNT_UPDATE_AMOUNT"] = "subaccount.amount.update";
-    NatsSubjects["SUBACCOUNT_GET_BY_ID"] = "subaccount.get.by.id";
-    NatsSubjects["SUBACCOUNT_GET_ALL"] = "subaccount.get.all";
     // User operations
     NatsSubjects["USER_CHECK"] = "user.check";
     NatsSubjects["USER_CREATED"] = "user.created";
     NatsSubjects["USER_GET_PREFERENCE"] = "user.preference.get";
     // Notification operations
-    NatsSubjects["NOTIFICATION_UPDATE_TOKEN"] = "notification.token.update";
-    NatsSubjects["NOTIFICATION_SEND"] = "notification.send";
     NatsSubjects["NOTIFICATION_GET_ALL"] = "notification.get.all";
     NatsSubjects["NOTIFICATION_GET_BY_ID"] = "notification.get.by.id";
     NatsSubjects["NOTIFICATION_MARK_AS_READ"] = "notification.mark.as.read";
@@ -33,32 +27,26 @@ var NatsSubjects;
     NatsSubjects["GET_ALL_USERS_FCM_TOKENS"] = "user.get.all.fcm_tokens";
     NatsSubjects["GET_USER_BY_ID"] = "user.get.by_id";
     NatsSubjects["GET_USER_BALANCE"] = "user.get.balance";
-    // Chat operations
-    NatsSubjects["CHAT_GET_CONVERSATIONS"] = "chat.conversations.get";
-    NatsSubjects["CHAT_GET_CONVERSATION"] = "chat.conversation.get";
-    NatsSubjects["CHAT_GET_MESSAGES"] = "chat.messages.get";
-    NatsSubjects["CHAT_CLOSE_CONVERSATION"] = "chat.conversation.close";
-    NatsSubjects["CHAT_ASSIGN_SUPPORT"] = "chat.conversation.assign";
-    // Ajo operations
-    NatsSubjects["AJO_PLANS_GET"] = "ajo.plans.get";
-    NatsSubjects["AJO_CREATE"] = "ajo.create";
-    NatsSubjects["AJO_LIST"] = "ajo.list";
-    NatsSubjects["AJO_GET"] = "ajo.get";
-    NatsSubjects["AJO_JOIN"] = "ajo.join";
-    NatsSubjects["AJO_CONTRIBUTE"] = "ajo.contribute";
-    NatsSubjects["AJO_PAYOUT"] = "ajo.payout";
-    NatsSubjects["AJO_CONTRIBUTIONS_GET"] = "ajo.contributions.get";
-    NatsSubjects["AJO_UPDATE"] = "ajo.update";
-    NatsSubjects["AJO_ADMIN_CYCLE"] = "ajo.admin.cycle";
     // Providus account operations
     NatsSubjects["PROVIDUS_GET_ACCOUNT"] = "providus.account.get";
     NatsSubjects["PROVIDUS_DEBIT_CUSTOMER"] = "providus.customer.debit";
     NatsSubjects["PROVIDUS_CREDIT_CUSTOMER"] = "providus.customer.credit";
-    // Account Holds
-    NatsSubjects["ACCOUNT_ADD_HOLD"] = "account.hold.add";
-    NatsSubjects["ACCOUNT_GET_HOLDS"] = "account.holds.get";
-    NatsSubjects["ACCOUNT_RELEASE_HOLD"] = "account.hold.release";
-    NatsSubjects["ADMIN_GET_ALL_HOLDS"] = "admin.holds.get.all";
+    NatsSubjects["CREATE_PROVIDUS_ACCOUNT"] = "providus.account.create";
+    // KYC operations
+    NatsSubjects["KYC_VERIFIED"] = "kyc.verified";
+    NatsSubjects["KYC_REJECTED"] = "kyc.rejected";
+    // VAS operations
+    NatsSubjects["VAS_TRANSACTION_SUCCESS"] = "vas.transaction.success";
+    NatsSubjects["VAS_TRANSACTION_FAILED"] = "vas.transaction.failed";
+    // Ajo / Thrift operations
+    NatsSubjects["AJO_MEMBER_JOINED"] = "ajo.member.joined";
+    NatsSubjects["AJO_CONTRIBUTION_SUCCESS"] = "ajo.contribution.success";
+    NatsSubjects["AJO_MATURED"] = "ajo.matured";
+    // Reward operations
+    NatsSubjects["REFERRAL_REWARD_CLAIMED"] = "referral.reward.claimed";
+    // Withdrawal operations
+    NatsSubjects["WITHDRAWAL_REQUESTED"] = "withdrawal.requested";
+    NatsSubjects["WITHDRAWAL_PROCESSED"] = "withdrawal.processed";
     // Other Admin operations
     NatsSubjects["ADMIN_GET_TERMII_BALANCE"] = "admin.termii.balance.get";
 })(NatsSubjects || (exports.NatsSubjects = NatsSubjects = {}));

package/dist/nats/events/index.d.ts

@@ -0,0 +1,174 @@
+import { TransactionCategory, TransactionStatus } from '../../common/enums/transaction.enum';
+/**
+ * NATS Event Contracts
+ * TypeScript interfaces for inter-service communication via NATS
+ */
+export interface UserCreatedEvent {
+    userId: string;
+    email: string;
+    phone: string;
+    username: string;
+    firstname?: string;
+    lastname?: string;
+    middlename?: string;
+    gender?: string;
+    dateOfBirth?: string;
+    referralCode?: string;
+    createdAt: string;
+}
+export interface PaymentSuccessEvent {
+    transactionId: string;
+    userId: string;
+    amount: number;
+    fee?: number;
+    currency: string;
+    category?: string;
+    provider: 'PROVIDUS' | 'PAYSTACK';
+    reference: string;
+    providerReference?: string;
+    balanceBefore?: number;
+    balanceAfter?: number;
+    metadata?: Record<string, any>;
+    timestamp: string;
+}
+export interface PaymentFailedEvent {
+    transactionId: string;
+    userId: string;
+    amount: number;
+    currency: string;
+    provider: 'PROVIDUS' | 'PAYSTACK';
+    reference: string;
+    reason: string;
+    errorCode?: string;
+    timestamp: string;
+}
+export interface TransactionProcessedEvent {
+    transactionId: string;
+    userId: string;
+    type: 'CREDIT' | 'DEBIT';
+    category: string;
+    amount: number;
+    fee: number;
+    balanceBefore: number;
+    balanceAfter: number;
+    reference: string;
+    description: string;
+    metadata?: Record<string, any>;
+    timestamp: string;
+}
+export interface NotificationSentEvent {
+    notificationId: string;
+    userId: string;
+    channel: 'EMAIL' | 'SMS' | 'PUSH' | 'VOICE';
+    type: string;
+    status: 'SENT' | 'FAILED';
+    timestamp: string;
+}
+export interface SavingsMaturedEvent {
+    savingsId: string;
+    userId: string;
+    amount: number;
+    interest: number;
+    interestRate?: number;
+    balance: number;
+    plan: string;
+    maturityDate: string;
+    timestamp: string;
+}
+export interface LoanApprovedEvent {
+    loanId: string;
+    userId: string;
+    amount: number;
+    interestRate: number;
+    totalInterest: number;
+    processingFee: number;
+    duration: string;
+    repaymentDate: string;
+    timestamp: string;
+}
+export interface LoanRepaidEvent {
+    loanId: string;
+    userId: string;
+    amount: number;
+    remainingBalance: number;
+    reference?: string;
+    timestamp: string;
+}
+export interface CreateProvidusAccountEvent {
+    userId: string;
+    bvn?: string;
+    firstName?: string;
+    lastName?: string;
+    dateOfBirth?: string;
+    phoneNumber?: string;
+    email?: string;
+    address?: string;
+}
+export interface KycVerifiedEvent {
+    userId: string;
+    verificationId: string;
+    bvn: string;
+    timestamp: string;
+}
+export interface KycRejectedEvent {
+    userId: string;
+    verificationId: string;
+    reason: string;
+    timestamp: string;
+}
+export interface VasTransactionEvent {
+    transactionId: string;
+    userId: string;
+    serviceId: string;
+    category: TransactionCategory;
+    amount: number;
+    recipientIdentifier: string;
+    status: TransactionStatus;
+    provider: string;
+    reference: string;
+    timestamp: string;
+}
+export interface AjoContributionEvent {
+    ajoId: string;
+    userId: string;
+    amount: number;
+    reference: string;
+    status: TransactionStatus;
+    timestamp: string;
+}
+export interface AjoMemberJoinedEvent {
+    ajoId: string;
+    userId: string;
+    joinedAt: string;
+    timestamp: string;
+}
+export interface ReferralRewardClaimedEvent {
+    userId: string;
+    referralId: string;
+    amount: number;
+    reference: string;
+    timestamp: string;
+}
+export interface WithdrawalRequestedEvent {
+    withdrawalId: string;
+    userId: string;
+    amount: number;
+    bankName: string;
+    accountNumber: string;
+    status: TransactionStatus;
+    timestamp: string;
+}
+export interface ProvidusDebitEvent {
+    userId: string;
+    amount: number;
+    reference: string;
+    metadata?: Record<string, any>;
+    timestamp: string;
+}
+export interface ProvidusCreditEvent {
+    userId: string;
+    amount: number;
+    reference: string;
+    metadata?: Record<string, any>;
+    timestamp: string;
+}

package/dist/nats/events/index.js

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

package/dist/nats/index.d.ts

@@ -3,3 +3,4 @@ export * from './interfaces/nats-options.interface';
 export * from './dto/nats-message.dto';
 export * from './decorators/nats-event-pattern.decorator';
 export * from './interceptors/nats-logging.interceptor';
+export * from './events';

package/dist/nats/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./interfaces/nats-options.interface"), exports);
 __exportStar(require("./dto/nats-message.dto"), exports);
 __exportStar(require("./decorators/nats-event-pattern.decorator"), exports);
 __exportStar(require("./interceptors/nats-logging.interceptor"), exports);
+__exportStar(require("./events"), exports);

package/dist/rpc/filters/index.d.ts

@@ -0,0 +1 @@
+export * from './rpc-exception.filter';