@traxionpay/cbsmiddleware 0.0.1

package/src/banking/banking.controller.ts

@@ -0,0 +1,142 @@
+import { Controller, Post, Body, UseGuards } from '@nestjs/common';
+import { FetchBankBalanceDto } from './dto/fetch-bank-balance.dto';
+import { BankStrategyFactory } from './factory/bank-strategy.factory';
+import { JwtAuthGuard } from '../auth/jwt-guard';
+import { ResponseMessage } from '../decorators/response_message.decorator';
+import { AccountDto, ValidateOtp } from './dto/account.dto';
+import { TransactionHistoryDto } from './dto/transaction-history.dto'
+import { AccountTransferDto } from './dto/account-transfer.dto'
+
+@Controller('banking')
+@UseGuards(JwtAuthGuard)
+export class BankingController {
+  constructor(private readonly factory: BankStrategyFactory) { }
+
+  @Post('token')
+  @ResponseMessage("Tokens")
+  async getAccessToken(@Body() body: any) {
+
+    const bankid = body.bankId;
+
+    const service = this.factory.getBankService(bankid);
+
+    const token = await service.generateToken();
+
+    return token;
+
+  }
+
+
+  @Post('refresh-token')
+  @ResponseMessage("Refresh Token")
+  async getRefreshToken(@Body() body: any) {
+
+    const service = this.factory.getBankService(body.bankId);
+
+    const response = await service.refreshToken(body.refreshToken);
+
+    return response;
+
+  }
+
+  @Post('link')
+  @ResponseMessage("Generate OTP from Mobile No.:")
+  async linkAccount(@Body() accountDto: AccountDto) {
+    // async linkAccount(@Query('acc') acc: string, @Query('br')  br?: string) {
+    const { bankId } = accountDto;
+    //let send_otp!: string;
+    // let otp!: string;
+    /*     if (!userid ) {
+          return { success: false, message: 'Account No. is required' };
+        } */
+    const service = this.factory.getBankService(bankId);
+
+    const response = await service.linkAccount(accountDto);
+
+    return response;
+    //const response = await service.findAccountDetailsRaw(token.token, userid);
+
+    //const { id, username, mobileNumber, ...rest } = response;
+
+    /*     if (response) {
+          const otp = service.generateOtp(mobileNumber, id.toString(), bankid);
+          send_otp = otp;
+          return { success: true, send_otp, message: 'OTP Sent. Kindly verify your OTP' };
+        } else {
+          return { success: false, send_otp: {}, message: 'Account Not Found' };
+        } */
+  }
+
+  @Post('validate')
+  @ResponseMessage("OTP Validation")
+  async validateOtp(@Body() validateOtp: ValidateOtp) {
+    const { bankId } = validateOtp;
+
+    const service = this.factory.getBankService(bankId);
+
+    /*     if (!acc || !otp) {
+          return { success: false, message: 'Mobile No. and OTP are required' };
+        }
+    
+        const isValid = service.validateOtp(acc.toString(), otp);
+     */
+
+    const response = service.validateOtp(validateOtp);
+    /*     return {
+          success: isValid,
+          message: isValid ? 'OTP is valid' : 'Invalid or expired OTP',
+        }; */
+
+    return response;
+  }
+
+
+  @Post('balance-inquiry')
+  async fetchBankBalance(@Body() fetchBankBalanceDto: FetchBankBalanceDto) {
+
+    const { bankId } = fetchBankBalanceDto
+
+    const service = this.factory.getBankService(bankId);
+
+
+    const balance = await service.processBalanceTransaction(fetchBankBalanceDto);
+
+    return balance;
+  }
+
+  @Post('wallet-cash-in')
+  @ResponseMessage("Account Cash In")
+  async accountCashIn(@Body() accountTransaferDto: AccountTransferDto) {
+    const { bankId } = accountTransaferDto;
+
+    const service = this.factory.getBankService(bankId);
+
+    const response = await service.accountCashIn(accountTransaferDto);
+
+    return response;
+  }
+
+  @Post('bank-deposit')
+  @ResponseMessage("Account Deposit")
+  async accountDeposit(@Body() accountTransaferDto: AccountTransferDto) {
+    const { bankId } = accountTransaferDto;
+
+    const service = this.factory.getBankService(bankId);
+
+    const response = await service.accountDeposit(accountTransaferDto);
+
+    return response;
+  }
+  @Post('transaction-history')
+  @ResponseMessage("Transaction History")
+  async getTranHisto(@Body() transactionHistoryDto: TransactionHistoryDto) {
+    const { bankId } = transactionHistoryDto;
+
+    const service = this.factory.getBankService(bankId);
+
+    const response = await service.getTransactionHistory(transactionHistoryDto);
+
+    return response;
+  }
+
+}

package/src/banking/banking.module.ts

@@ -0,0 +1,142 @@
+import { DynamicModule, Module, Provider } from '@nestjs/common';
+import { BankingModuleOptions } from './types';
+import { ASPAC_SERVICE_TOKEN, BANKING_CONFIG, MBWIN_SERVICE_TOKEN, WELCOMEBANK_SERVICE_TOKEN } from './tokens/bank-service.tokens';
+import { SmsService } from './services/sms.service';
+import { BankStrategyFactory } from './factory/bank-strategy.factory';
+import { BankingController } from './banking.controller';
+import { AppLoggerModule } from '../logger/logger.module';
+import { ConfigModule } from '@nestjs/config';
+import { ASPACService } from './services/ASPAC.service';
+import { WelcomeBankService } from './services/WelcomeBank.service';
+import { MBWINService } from './services/MBWIN.service';
+import { BankingGatewayService } from './services/BankGateway.service';
+
+/**
+ * The `BankingModule` provides dynamic registration for bank service integrations.
+ * 
+ * This module allows you to inject custom implementations of bank services (e.g., Bank1, Bank2)
+ * and configuration options for flexible banking-related operations such as balance checks,
+ * OTP generation, and transaction history retrieval.
+ * 
+ * It uses the strategy pattern internally to switch between bank service implementations at runtime.
+ * 
+ * @export
+ * @class BankingModule
+ * @typedef {BankingModule}
+ *
+ * @example
+ * // Register with custom service implementations
+ * BankingModule.register({
+ *   bank1Service: CustomBank1Service,
+ *   bank2Service: CustomBank2Service,
+ *   config: {
+ *     BANK1_AUTH_KEY: 'abc123',
+ *     BANK1_URL: 'https://bank1.api',
+ *     BANK1_DATA_PORT: 3001,
+ *     ...
+ *   },
+ * });
+ */
+@Module({})
+export class BankingModule {
+  /**
+   * Registers the `BankingModule` dynamically with optional overrides for services and config.
+   *
+   * @static
+   * @param {BankingModuleOptions} [options={}] - Configuration options for banking integration.
+   * @returns {DynamicModule} A configured `DynamicModule` to be imported in the main AppModule or feature module.
+   *
+   * @example
+   * import { BankingModule } from './banking/banking.module';
+   *
+   * `@`Module({
+   *   imports: [
+   *     BankingModule.register({
+   *       bank1Service: CustomBank1Service,
+   *       config: {
+   *         BANK1_AUTH_KEY: process.env.BANK1_KEY,
+   *         BANK1_URL: 'https://api.bank1.com',
+   *         BANK1_DATA_PORT: 443,
+   *         BANK1_MESSAGE_ID: 'MSG1234'
+   *       },
+   *     })
+   *   ],
+   * })
+   * export class AppModule {}
+   */
+  static register(options: BankingModuleOptions = {}): DynamicModule {
+    // Provide default configuration if none is passed
+    const configProvider: Provider = {
+      provide: BANKING_CONFIG,
+      useValue: options.config ?? {
+        BANK1_DATA_KEY: '',
+        BANK1_AUTH_KEY: '',
+        BANK2_AUTH_KEY: '',
+        BANK1_URL: '',
+        BANK2_URL: '',
+        BANK1_DATA_PORT: 0,
+        BANK2_DATA_PORT: 0,
+        BANK1_MESSAGE_ID: '',
+
+        //ASPAC
+        ASPAC_URL: '',
+        ASPAC_API_KEY: '',
+        ASPAC_VERSION_KEY: '',
+
+        //WelcomeBank
+        WELCOMEBANK_URL: '',
+        WELCOMEBANK_PORT: 0,
+        WELCOMEBANK_API_KEY: '',
+        WELCOMEBANK_VERSION_KEY: '',
+        WELCOMBANK_ENABLEENCRYPTION: false,
+
+        //MBWIN
+        MBWIN_URL: '',
+        MBWIN_PORT: 0,
+        MBWIN_API_KEY: '',
+
+      },
+    };
+
+    // Core providers including injectable services and strategy factory
+    const providers: Provider[] = [
+      configProvider,
+      {
+        provide: ASPAC_SERVICE_TOKEN,
+        useClass: options.ASPACService ?? ASPACService,
+      },
+      {
+        provide: WELCOMEBANK_SERVICE_TOKEN,
+        useClass: options.WelcomeBankService ?? WelcomeBankService,
+      },
+      {
+        provide: MBWIN_SERVICE_TOKEN,
+        useClass: options.MBWINService ?? MBWINService,
+      },
+      BankStrategyFactory,
+      ASPACService,
+      WelcomeBankService,
+      SmsService,
+      MBWINService,
+      BankingGatewayService,
+    ];
+
+    // Return the dynamic module definition
+    return {
+      module: BankingModule,
+      imports: [
+        AppLoggerModule, // Custom application logger
+        ConfigModule,    // NestJS config module for env vars
+      ],
+      controllers: [BankingController], // Controller to expose routes
+      providers, // Registered providers
+      exports: [
+        BankStrategyFactory,
+        ASPACService,
+        BankingGatewayService,
+
+        configProvider, // Export config for downstream modules
+      ],
+    };
+  }
+}

package/src/banking/dto/account-transfer.dto.ts

@@ -0,0 +1,66 @@
+import {
+  IsDefined,
+  IsNotEmpty,
+  IsNumber,
+  IsOptional,
+  IsString
+} from "class-validator";
+
+export class AccountTransferDto {
+
+    @IsDefined()
+    @IsString()
+    bankId: string
+
+    @IsOptional()
+    @IsString()
+    token?: string
+
+    @IsOptional()
+    @IsString()
+    permissionKey?: string
+
+    @IsOptional()
+    @IsString()
+    sourceAccount?: string;
+
+    @IsOptional()
+    @IsString()
+    sourceBranch?: string;
+
+    @IsOptional()
+    @IsString()
+    sourceAccountType?: string;
+
+    @IsOptional()
+    @IsString()
+    destinationAccount?: string;
+
+    @IsOptional()
+    @IsString()
+    destinationBranch?: string;
+
+    @IsOptional()
+    @IsString()
+    destinationAccountType?: string;
+
+    @IsOptional()
+    @IsNumber()
+    amount?: number;
+
+    @IsOptional()
+    @IsString()
+    particulars?: string;
+
+    @IsOptional()
+    @IsNumber()
+    mobile?: number
+
+    @IsOptional()
+    @IsString()
+    fullName?: string;
+
+    @IsOptional()
+    @IsString()
+    birthDate?: string;
+}

package/src/banking/dto/account.dto.ts

@@ -0,0 +1,70 @@
+import {
+    IsDefined,
+    IsNotEmpty,
+    IsNumber,
+    IsString,
+    IsOptional
+} from "class-validator";
+
+export class AccountDto {
+
+    @IsDefined()
+    @IsString()
+    bankId: string
+
+    @IsOptional()
+    @IsString()
+    token?: string
+
+    @IsDefined()
+    @IsString()
+    account?: string
+
+    @IsOptional()
+    @IsString()
+    branch?: string;
+
+    @IsOptional()
+    @IsString()
+    accountType?: string;
+
+    @IsOptional()
+    @IsNumber()
+    mobile?: number
+
+    @IsOptional()
+    @IsString()
+    fullName?: string;
+
+    @IsOptional()
+    @IsString()
+    birthDate?: string;
+
+}
+
+export class ValidateOtp {
+
+    @IsDefined()
+    @IsString()
+    bankId: string
+
+    @IsDefined()
+    @IsString()
+    token?: string
+
+    @IsDefined()
+    @IsString()
+    account?: string
+
+    @IsOptional()
+    @IsString()
+    branch?: string;
+
+    @IsOptional()
+    @IsString()
+    accountType?: string;
+
+    @IsOptional()
+    @IsString()
+    otp?: string
+}

package/src/banking/dto/fetch-bank-balance.dto.ts

@@ -0,0 +1,46 @@
+import {
+  IsDefined,
+  IsString,
+  IsOptional,
+  IsNumber
+} from "class-validator";
+
+export class FetchBankBalanceDto {
+
+    @IsDefined()
+    @IsString()
+    bankId: string
+
+    @IsOptional()
+    @IsString()
+    token?: string
+
+    @IsOptional()
+    @IsString()
+    permissionKey?: string
+
+    @IsOptional()
+    @IsString()
+    account?: string;
+
+    @IsOptional()
+    @IsString()
+    branch?: string;
+
+    @IsOptional()
+    @IsString()
+    accountType?: string;
+
+    @IsOptional()
+    @IsNumber()
+    mobile?: number
+
+    @IsOptional()
+    @IsString()
+    fullName?: string;
+
+    @IsOptional()
+    @IsString()
+    birthDate?: string;
+    
+}

package/src/banking/dto/transaction-history.dto.ts

@@ -0,0 +1,58 @@
+import {
+  IsDefined,
+  IsNotEmpty,
+  IsNumber,
+  IsOptional,
+  IsString
+} from "class-validator";
+
+export class TransactionHistoryDto {
+
+    @IsDefined()
+    @IsString()
+    bankId: string
+
+    @IsOptional()
+    @IsString()
+    token?: string
+
+    @IsOptional()
+    @IsString()
+    permissionKey?: string
+
+    @IsOptional()
+    @IsString()
+    account?: string;
+
+    @IsOptional()
+    @IsString()
+    branch?: string;
+
+    @IsOptional()
+    @IsString()
+    accountType?: string;
+
+    @IsOptional()
+    @IsString()
+    dateFrom?: string;
+
+    @IsOptional()
+    @IsString()
+    dateTo?: string;
+
+    @IsOptional()
+    @IsNumber()
+    page?: number;
+
+    @IsOptional()
+    @IsNumber()
+    mobile?: number
+
+    @IsOptional()
+    @IsString()
+    fullName?: string;
+
+    @IsOptional()
+    @IsString()
+    birthDate?: string;
+}

package/src/banking/factory/bank-strategy.factory.ts

@@ -0,0 +1,25 @@
+import { Inject, Injectable } from '@nestjs/common';
+import { BankService } from '../interfaces/bank-service.interface';
+import { ASPAC_SERVICE_TOKEN, WELCOMEBANK_SERVICE_TOKEN, MBWIN_SERVICE_TOKEN } from '../tokens/bank-service.tokens';
+
+@Injectable()
+export class BankStrategyFactory {
+  constructor(
+    @Inject(ASPAC_SERVICE_TOKEN) private readonly ASPACService: BankService,
+    @Inject(WELCOMEBANK_SERVICE_TOKEN) private readonly WelcomeBankService: BankService,
+    @Inject(MBWIN_SERVICE_TOKEN) private readonly MBWINService: BankService,
+  ) {}
+
+  getBankService(bankid: string): BankService {
+    switch (bankid) {
+      case 'ASPAC':
+        return this.ASPACService;
+      case 'RBSAGAY':
+        return this.MBWINService;
+      case 'WELCOMEBANK':
+        return this.WelcomeBankService;
+      default:
+        throw new Error(`Unsupported bankId: ${bankid}`);
+    }
+  }
+}

package/src/banking/interfaces/bank-config.interface.ts

@@ -0,0 +1,25 @@
+// banking-config.interface.ts
+export interface BankingConfig {
+  BANK1_DATA_KEY: string;
+  BANK1_AUTH_KEY: string;
+  BANK2_AUTH_KEY: string;
+  BANK1_URL: string;
+  BANK2_URL: string;
+  BANK1_DATA_PORT: number;
+  BANK2_DATA_PORT: number;
+  BANK1_MESSAGE_ID: string;
+  //ASPAC
+  ASPAC_URL: string;
+  ASPAC_API_KEY: string;
+  ASPAC_VERSION_KEY: string;
+  //WelcomeBank
+  WELCOMEBANK_URL: string;
+  WELCOMEBANK_PORT: number;
+  WELCOMEBANK_API_KEY: string;
+  WELCOMEBANK_VERSION_KEY: string;
+  WELCOMBANK_ENABLEENCRYPTION: boolean;
+  //MBWIN
+  MBWIN_URL: string,
+  MBWIN_PORT: number,
+  MBWIN_API_KEY: string,
+}