@takentrade/takentrade-libs 3.0.0 → 3.2.0

package/dist/utils/helpers/date.util.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Calculate next date based on frequency
+ */
+export declare const calculateNextDate: (frequency: "DAILY" | "WEEKLY" | "MONTHLY", lastDate: Date) => Date;
+/**
+ * Check if a given date is today
+ */
+export declare const isToday: (date: Date) => boolean;

package/dist/utils/helpers/date.util.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isToday = exports.calculateNextDate = void 0;
+/**
+ * Calculate next date based on frequency
+ */
+const calculateNextDate = (frequency, lastDate) => {
+    const nextDate = new Date(lastDate);
+    const frequencyMap = {
+        DAILY: () => nextDate.setDate(nextDate.getDate() + 1),
+        WEEKLY: () => nextDate.setDate(nextDate.getDate() + 7),
+        MONTHLY: () => nextDate.setMonth(nextDate.getMonth() + 1),
+    };
+    const calculateFn = frequencyMap[frequency];
+    if (!calculateFn)
+        throw new Error('Invalid frequency');
+    calculateFn();
+    return nextDate;
+};
+exports.calculateNextDate = calculateNextDate;
+/**
+ * Check if a given date is today
+ */
+const isToday = (date) => {
+    const today = new Date();
+    return (date.getDate() === today.getDate() &&
+        date.getMonth() === today.getMonth() &&
+        date.getFullYear() === today.getFullYear());
+};
+exports.isToday = isToday;

package/dist/utils/helpers/decimal.util.d.ts

@@ -0,0 +1,9 @@
+import Decimal from 'decimal.js';
+/**
+ * Convert a value to Decimal
+ */
+export declare const toDecimal: (value: number | string | Decimal) => Decimal;
+/**
+ * Convert Decimal to Prisma-compatible number
+ */
+export declare const toPrismaDecimal: (value: Decimal) => number;

package/dist/utils/helpers/decimal.util.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPrismaDecimal = exports.toDecimal = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const DEFAULT_DECIMAL_PLACES = 4;
+decimal_js_1.default.set({ precision: 20, rounding: decimal_js_1.default.ROUND_HALF_UP });
+/**
+ * Convert a value to Decimal
+ */
+const toDecimal = (value) => {
+    try {
+        return new decimal_js_1.default(value);
+    }
+    catch (error) {
+        throw new Error(`Invalid decimal value: ${value}`);
+    }
+};
+exports.toDecimal = toDecimal;
+/**
+ * Convert Decimal to Prisma-compatible number
+ */
+const toPrismaDecimal = (value) => {
+    if (!decimal_js_1.default.isDecimal(value)) {
+        throw new Error('Value must be a Decimal instance');
+    }
+    return value.toDecimalPlaces(DEFAULT_DECIMAL_PLACES).toNumber();
+};
+exports.toPrismaDecimal = toPrismaDecimal;

package/dist/utils/helpers/format.util.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Formats currency (Naira)
+ * 1234.56 → ₦1,234.56
+ */
+export declare const formatCurrency: (amount: number, currency?: string, decimals?: number) => string;
+/**
+ * Formats currency without symbol
+ * 1234.56 → 1,234.56
+ */
+export declare const formatAmount: (amount: number, decimals?: number) => string;
+/**
+ * Formats account number for display
+ * 0123456789 → 0123 4567 89
+ */
+export declare const formatAccountNumber: (accountNumber: string) => string;
+/**
+ * Masks account number for security
+ * 0123456789 → ****6789
+ */
+export declare const maskAccountNumber: (accountNumber: string) => string;
+/**
+ * Masks email for security
+ * user@example.com → u***@example.com
+ */
+export declare const maskEmail: (email: string) => string;
+/**
+ * Formats date to Nigerian format
+ * 2024-01-15 → 15/01/2024
+ */
+export declare const formatDate: (date: Date | string) => string;
+/**
+ * Formats date and time
+ * → 15/01/2024 14:30
+ */
+export declare const formatDateTime: (date: Date | string) => string;
+/**
+ * Formats relative time
+ * → "2 hours ago", "3 days ago"
+ */
+export declare const formatRelativeTime: (date: Date | string) => string;
+/**
+ * Formats percentage
+ * 0.025 → 2.5%
+ */
+export declare const formatPercentage: (value: number, decimals?: number) => string;
+/**
+ * Formats file size
+ * 1536 → 1.5 KB
+ */
+export declare const formatFileSize: (bytes: number) => string;
+/**
+ * Truncates text with ellipsis
+ * "Long text here" → "Long te..."
+ */
+export declare const truncateText: (text: string, maxLength: number) => string;
+/**
+ * Capitalizes first letter of each word
+ * "john doe" → "John Doe"
+ */
+export declare const toTitleCase: (text: string) => string;
+/**
+ * Formats transaction status for display
+ */
+export declare const formatTransactionStatus: (status: string) => string;

package/dist/utils/helpers/format.util.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTransactionStatus = exports.toTitleCase = exports.truncateText = exports.formatFileSize = exports.formatPercentage = exports.formatRelativeTime = exports.formatDateTime = exports.formatDate = exports.maskEmail = exports.maskAccountNumber = exports.formatAccountNumber = exports.formatAmount = exports.formatCurrency = void 0;
+/**
+ * Formats currency (Naira)
+ * 1234.56 → ₦1,234.56
+ */
+const formatCurrency = (amount, currency = '₦', decimals = 2) => {
+    const formatted = amount.toLocaleString('en-NG', {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    });
+    return `${currency}${formatted}`;
+};
+exports.formatCurrency = formatCurrency;
+/**
+ * Formats currency without symbol
+ * 1234.56 → 1,234.56
+ */
+const formatAmount = (amount, decimals = 2) => {
+    return amount.toLocaleString('en-NG', {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    });
+};
+exports.formatAmount = formatAmount;
+/**
+ * Formats account number for display
+ * 0123456789 → 0123 4567 89
+ */
+const formatAccountNumber = (accountNumber) => {
+    if (accountNumber.length !== 10)
+        return accountNumber;
+    return `${accountNumber.substring(0, 4)} ${accountNumber.substring(4, 8)} ${accountNumber.substring(8)}`;
+};
+exports.formatAccountNumber = formatAccountNumber;
+/**
+ * Masks account number for security
+ * 0123456789 → ****6789
+ */
+const maskAccountNumber = (accountNumber) => {
+    if (accountNumber.length < 4)
+        return accountNumber;
+    return '*'.repeat(accountNumber.length - 4) + accountNumber.slice(-4);
+};
+exports.maskAccountNumber = maskAccountNumber;
+/**
+ * Masks email for security
+ * user@example.com → u***@example.com
+ */
+const maskEmail = (email) => {
+    const [username, domain] = email.split('@');
+    if (!username || !domain)
+        return email;
+    const maskedUsername = username[0] + '*'.repeat(username.length - 1);
+    return `${maskedUsername}@${domain}`;
+};
+exports.maskEmail = maskEmail;
+/**
+ * Formats date to Nigerian format
+ * 2024-01-15 → 15/01/2024
+ */
+const formatDate = (date) => {
+    const d = new Date(date);
+    const day = String(d.getDate()).padStart(2, '0');
+    const month = String(d.getMonth() + 1).padStart(2, '0');
+    const year = d.getFullYear();
+    return `${day}/${month}/${year}`;
+};
+exports.formatDate = formatDate;
+/**
+ * Formats date and time
+ * → 15/01/2024 14:30
+ */
+const formatDateTime = (date) => {
+    const d = new Date(date);
+    const dateStr = (0, exports.formatDate)(d);
+    const hours = String(d.getHours()).padStart(2, '0');
+    const minutes = String(d.getMinutes()).padStart(2, '0');
+    return `${dateStr} ${hours}:${minutes}`;
+};
+exports.formatDateTime = formatDateTime;
+/**
+ * Formats relative time
+ * → "2 hours ago", "3 days ago"
+ */
+const formatRelativeTime = (date) => {
+    const d = new Date(date);
+    const now = new Date();
+    const diffMs = now.getTime() - d.getTime();
+    const diffSecs = Math.floor(diffMs / 1000);
+    const diffMins = Math.floor(diffSecs / 60);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffSecs < 60)
+        return 'Just now';
+    if (diffMins < 60)
+        return `${diffMins} minute${diffMins > 1 ? 's' : ''} ago`;
+    if (diffHours < 24)
+        return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+    if (diffDays < 7)
+        return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+    return (0, exports.formatDate)(d);
+};
+exports.formatRelativeTime = formatRelativeTime;
+/**
+ * Formats percentage
+ * 0.025 → 2.5%
+ */
+const formatPercentage = (value, decimals = 1) => {
+    return `${(value * 100).toFixed(decimals)}%`;
+};
+exports.formatPercentage = formatPercentage;
+/**
+ * Formats file size
+ * 1536 → 1.5 KB
+ */
+const formatFileSize = (bytes) => {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+};
+exports.formatFileSize = formatFileSize;
+/**
+ * Truncates text with ellipsis
+ * "Long text here" → "Long te..."
+ */
+const truncateText = (text, maxLength) => {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3) + '...';
+};
+exports.truncateText = truncateText;
+/**
+ * Capitalizes first letter of each word
+ * "john doe" → "John Doe"
+ */
+const toTitleCase = (text) => {
+    return text
+        .toLowerCase()
+        .split(' ')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+};
+exports.toTitleCase = toTitleCase;
+/**
+ * Formats transaction status for display
+ */
+const formatTransactionStatus = (status) => {
+    const statusMap = {
+        PENDING: 'Pending',
+        SUCCESS: 'Successful',
+        FAILED: 'Failed',
+        REVERSED: 'Reversed',
+        PROCESSING: 'Processing',
+    };
+    return statusMap[status] || (0, exports.toTitleCase)(status);
+};
+exports.formatTransactionStatus = formatTransactionStatus;

package/dist/utils/helpers/penalty.util.d.ts

@@ -0,0 +1,25 @@
+interface PenaltyTier {
+    maxDays: number;
+    rate: number;
+}
+/**
+ * Calculates the penalty rate based on the number of days a loan repayment is delayed.
+ * Uses predefined penalty tiers to determine the rate.
+ *
+ * @param delayInDays - The number of days the loan repayment is delayed.
+ * @returns The penalty rate as a decimal (e.g., 0.025 for 2.5%).
+ */
+export declare const calculatePenalty: (delayInDays: number) => number;
+/**
+ * Calculates the penalty amount based on the principal and the number of days delayed.
+ *
+ * @param principal - The principal amount of the loan.
+ * @param delayInDays - The number of days the loan repayment is delayed.
+ * @returns The penalty amount.
+ */
+export declare const calculatePenaltyAmount: (principal: number, delayInDays: number) => number;
+/**
+ * Get all penalty tiers
+ */
+export declare const getPenaltyTiers: () => PenaltyTier[];
+export {};

package/dist/utils/helpers/penalty.util.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPenaltyTiers = exports.calculatePenaltyAmount = exports.calculatePenalty = void 0;
+const PENALTY_TIERS = [
+    { maxDays: 7, rate: 0.025 }, // 2.5% for first week
+    { maxDays: 14, rate: 0.05 }, // 5% for second week
+    { maxDays: 21, rate: 0.075 }, // 7.5% for third week
+    { maxDays: Infinity, rate: 0.1 }, // 10% for anything beyond
+];
+/**
+ * Calculates the penalty rate based on the number of days a loan repayment is delayed.
+ * Uses predefined penalty tiers to determine the rate.
+ *
+ * @param delayInDays - The number of days the loan repayment is delayed.
+ * @returns The penalty rate as a decimal (e.g., 0.025 for 2.5%).
+ */
+const calculatePenalty = (delayInDays) => {
+    const tier = PENALTY_TIERS.find((tier) => delayInDays <= tier.maxDays);
+    return tier ? tier.rate : PENALTY_TIERS[PENALTY_TIERS.length - 1].rate;
+};
+exports.calculatePenalty = calculatePenalty;
+/**
+ * Calculates the penalty amount based on the principal and the number of days delayed.
+ *
+ * @param principal - The principal amount of the loan.
+ * @param delayInDays - The number of days the loan repayment is delayed.
+ * @returns The penalty amount.
+ */
+const calculatePenaltyAmount = (principal, delayInDays) => {
+    const rate = (0, exports.calculatePenalty)(delayInDays);
+    return principal * rate;
+};
+exports.calculatePenaltyAmount = calculatePenaltyAmount;
+/**
+ * Get all penalty tiers
+ */
+const getPenaltyTiers = () => {
+    return [...PENALTY_TIERS];
+};
+exports.getPenaltyTiers = getPenaltyTiers;

package/dist/utils/helpers/referral.util.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate a unique referral code in format TNT-XXXX-XXXX
+ */
+export declare const generateReferralCode: () => string;

package/dist/utils/helpers/referral.util.js

@@ -0,0 +1,53 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateReferralCode = void 0;
+const crypto = __importStar(require("crypto"));
+/**
+ * Generate a unique referral code in format TNT-XXXX-XXXX
+ */
+const generateReferralCode = () => {
+    const chars = '23456789ABCDEFGHJKLMNPQRSTUVWXYZ';
+    const generateRandomPart = (length) => {
+        const randomBytes = crypto.randomBytes(length);
+        return Array.from(randomBytes)
+            .map((x) => chars[x % chars.length])
+            .join('');
+    };
+    const firstPart = generateRandomPart(4);
+    const secondPart = generateRandomPart(4);
+    return `TNT-${firstPart}-${secondPart}`;
+};
+exports.generateReferralCode = generateReferralCode;

package/dist/utils/helpers/role.util.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check if role is an admin role
+ */
+export declare const isAdminRole: (roleName: string) => boolean;
+/**
+ * Get base role
+ */
+export declare const getBaseRole: () => string;

package/dist/utils/helpers/role.util.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBaseRole = exports.isAdminRole = void 0;
+const BASE_ROLE = 'USER';
+/**
+ * Check if role is an admin role
+ */
+const isAdminRole = (roleName) => {
+    return roleName !== BASE_ROLE;
+};
+exports.isAdminRole = isAdminRole;
+/**
+ * Get base role
+ */
+const getBaseRole = () => {
+    return BASE_ROLE;
+};
+exports.getBaseRole = getBaseRole;

package/dist/utils/helpers/validation.util.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Validation utilities for common Nigerian/African fintech use cases
+ */
+/**
+ * Validates Nigerian phone number
+ * Accepts formats: 08012345678, +2348012345678, 2348012345678
+ */
+export declare const isValidNigerianPhone: (phone: string) => boolean;
+/**
+ * Validates email address
+ */
+export declare const isValidEmail: (email: string) => boolean;
+/**
+ * Validates Nigerian BVN (Bank Verification Number)
+ * Must be exactly 11 digits
+ */
+export declare const isValidBVN: (bvn: string) => boolean;
+/**
+ * Validates Nigerian NIN (National Identification Number)
+ * Must be exactly 11 digits
+ */
+export declare const isValidNIN: (nin: string) => boolean;
+/**
+ * Validates Nigerian account number
+ * Must be exactly 10 digits (NUBAN format)
+ */
+export declare const isValidAccountNumber: (accountNumber: string) => boolean;
+/**
+ * Validates amount (must be positive number)
+ */
+export declare const isValidAmount: (amount: number) => boolean;
+/**
+ * Validates password strength
+ * At least 8 characters, 1 uppercase, 1 lowercase, 1 number
+ */
+export declare const isStrongPassword: (password: string) => boolean;
+/**
+ * Validates referral code format
+ * 6-10 alphanumeric characters
+ */
+export declare const isValidReferralCode: (code: string) => boolean;
+/**
+ * Validates transaction reference format
+ */
+export declare const isValidTransactionReference: (ref: string) => boolean;
+/**
+ * Sanitizes phone number to standard format
+ * Converts to: 2348012345678
+ */
+export declare const sanitizePhoneNumber: (phone: string) => string;
+/**
+ * Validates date is not in the past
+ */
+export declare const isNotPastDate: (date: Date) => boolean;
+/**
+ * Validates date is within range
+ */
+export declare const isDateInRange: (date: Date, minDate: Date, maxDate: Date) => boolean;
+/**
+ * Validates age is above minimum (for KYC)
+ */
+export declare const isValidAge: (dateOfBirth: Date, minAge?: number) => boolean;

package/dist/utils/helpers/validation.util.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Validation utilities for common Nigerian/African fintech use cases
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidAge = exports.isDateInRange = exports.isNotPastDate = exports.sanitizePhoneNumber = exports.isValidTransactionReference = exports.isValidReferralCode = exports.isStrongPassword = exports.isValidAmount = exports.isValidAccountNumber = exports.isValidNIN = exports.isValidBVN = exports.isValidEmail = exports.isValidNigerianPhone = void 0;
+/**
+ * Validates Nigerian phone number
+ * Accepts formats: 08012345678, +2348012345678, 2348012345678
+ */
+const isValidNigerianPhone = (phone) => {
+    const cleaned = phone.replace(/[\s\-\(\)]/g, '');
+    const patterns = [
+        /^0[7-9][0-1]\d{8}$/, // 08012345678
+        /^\+234[7-9][0-1]\d{8}$/, // +2348012345678
+        /^234[7-9][0-1]\d{8}$/, // 2348012345678
+    ];
+    return patterns.some((pattern) => pattern.test(cleaned));
+};
+exports.isValidNigerianPhone = isValidNigerianPhone;
+/**
+ * Validates email address
+ */
+const isValidEmail = (email) => {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+};
+exports.isValidEmail = isValidEmail;
+/**
+ * Validates Nigerian BVN (Bank Verification Number)
+ * Must be exactly 11 digits
+ */
+const isValidBVN = (bvn) => {
+    return /^\d{11}$/.test(bvn);
+};
+exports.isValidBVN = isValidBVN;
+/**
+ * Validates Nigerian NIN (National Identification Number)
+ * Must be exactly 11 digits
+ */
+const isValidNIN = (nin) => {
+    return /^\d{11}$/.test(nin);
+};
+exports.isValidNIN = isValidNIN;
+/**
+ * Validates Nigerian account number
+ * Must be exactly 10 digits (NUBAN format)
+ */
+const isValidAccountNumber = (accountNumber) => {
+    return /^\d{10}$/.test(accountNumber);
+};
+exports.isValidAccountNumber = isValidAccountNumber;
+/**
+ * Validates amount (must be positive number)
+ */
+const isValidAmount = (amount) => {
+    return typeof amount === 'number' && amount > 0 && isFinite(amount);
+};
+exports.isValidAmount = isValidAmount;
+/**
+ * Validates password strength
+ * At least 8 characters, 1 uppercase, 1 lowercase, 1 number
+ */
+const isStrongPassword = (password) => {
+    const minLength = 8;
+    const hasUpperCase = /[A-Z]/.test(password);
+    const hasLowerCase = /[a-z]/.test(password);
+    const hasNumber = /\d/.test(password);
+    return (password.length >= minLength &&
+        hasUpperCase &&
+        hasLowerCase &&
+        hasNumber);
+};
+exports.isStrongPassword = isStrongPassword;
+/**
+ * Validates referral code format
+ * 6-10 alphanumeric characters
+ */
+const isValidReferralCode = (code) => {
+    return /^[A-Z0-9]{6,10}$/.test(code);
+};
+exports.isValidReferralCode = isValidReferralCode;
+/**
+ * Validates transaction reference format
+ */
+const isValidTransactionReference = (ref) => {
+    return /^[A-Z0-9_-]{10,50}$/.test(ref);
+};
+exports.isValidTransactionReference = isValidTransactionReference;
+/**
+ * Sanitizes phone number to standard format
+ * Converts to: 2348012345678
+ */
+const sanitizePhoneNumber = (phone) => {
+    const cleaned = phone.replace(/[\s\-\(\)]/g, '');
+    // Remove leading + if present
+    let sanitized = cleaned.replace(/^\+/, '');
+    // Convert 0801... to 234801...
+    if (sanitized.startsWith('0')) {
+        sanitized = '234' + sanitized.substring(1);
+    }
+    // Ensure it starts with 234
+    if (!sanitized.startsWith('234')) {
+        sanitized = '234' + sanitized;
+    }
+    return sanitized;
+};
+exports.sanitizePhoneNumber = sanitizePhoneNumber;
+/**
+ * Validates date is not in the past
+ */
+const isNotPastDate = (date) => {
+    return date.getTime() >= new Date().getTime();
+};
+exports.isNotPastDate = isNotPastDate;
+/**
+ * Validates date is within range
+ */
+const isDateInRange = (date, minDate, maxDate) => {
+    const timestamp = date.getTime();
+    return timestamp >= minDate.getTime() && timestamp <= maxDate.getTime();
+};
+exports.isDateInRange = isDateInRange;
+/**
+ * Validates age is above minimum (for KYC)
+ */
+const isValidAge = (dateOfBirth, minAge = 18) => {
+    const today = new Date();
+    const birthDate = new Date(dateOfBirth);
+    let age = today.getFullYear() - birthDate.getFullYear();
+    const monthDiff = today.getMonth() - birthDate.getMonth();
+    if (monthDiff < 0 ||
+        (monthDiff === 0 && today.getDate() < birthDate.getDate())) {
+        age--;
+    }
+    return age >= minAge;
+};
+exports.isValidAge = isValidAge;

package/dist/utils/index.d.ts

@@ -14,6 +14,13 @@ export * from './utils';
 export * from './interfaces';
 export * from './dto';
 export * from './enums';
+export * from './helpers/decimal.util';
+export * from './helpers/date.util';
+export * from './helpers/role.util';
+export * from './helpers/referral.util';
+export * from './helpers/penalty.util';
+export * from './helpers/validation.util';
+export * from './helpers/format.util';
 /**
  * A set of shared utilities across the application.
  */