finprim 0.1.1 → 0.1.3

package/README.md

@@ -1,50 +1,89 @@
-# finprim
+<p align="center">
+  <h1 align="center">finprim</h1>
+  <p align="center">Financial primitives for modern TypeScript applications.</p>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/finprim"><img src="https://img.shields.io/npm/v/finprim.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/finprim"><img src="https://img.shields.io/npm/dm/finprim.svg" alt="npm downloads"></a>
+  <a href="https://github.com/tintolee/finprim/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/finprim.svg" alt="license"></a>
+  <a href="https://github.com/tintolee/finprim"><img src="https://img.shields.io/github/stars/tintolee/finprim?style=social" alt="GitHub stars"></a>
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="zero dependencies">
+  <img src="https://img.shields.io/badge/TypeScript-strict-blue" alt="TypeScript strict">
+</p>
+
+<p align="center">
+  <b>IBAN &middot; BIC/SWIFT &middot; Card &middot; Sort Code &middot; VAT &middot; Routing Number &middot; Loan/EMI &middot; Currency</b><br/>
+  One library. Zero dependencies. Fully typed.
+</p>
 
-**Financial primitives for modern TypeScript applications.**
+---
 
-A unified, production-grade TypeScript library for validating and formatting financial data. No more stitching together five different packages. No more custom glue code. Just clean, typed, fintech-first utilities that work anywhere TypeScript runs.
+> Every fintech team builds this internally. Sort code validation here, an IBAN check there, a custom currency formatter somewhere else. It's fragmented, inconsistent, and expensive to maintain. **finprim is the open source version of what your team has already written three times.**
 
 ---
 
-## Why finprim?
+## Quick Start
 
-Every fintech team builds this internally. Sort code validation here, an IBAN check there, a custom currency formatter somewhere else. It's fragmented, inconsistent, and expensive to maintain.
+```bash
+npm install finprim
+```
 
-finprim is the open source version of what your team has already written three times.
+```ts
+import { validateIBAN, validateCardNumber, formatCurrency } from 'finprim'
+
+const iban = validateIBAN('GB29NWBK60161331926819')
+// { valid: true, value: 'GB29NWBK60161331926819', formatted: 'GB29 NWBK 6016 1331 9268 19', countryCode: 'GB' }
+
+const card = validateCardNumber('4532015112830366')
+// { valid: true, formatted: '4532 0151 1283 0366', network: 'Visa', last4: '0366' }
+
+formatCurrency(1000.5, 'GBP', 'en-GB')
+// '£1,000.50'
+```
+
+**That's it.** No config. No setup. Just import and use.
 
 ---
 
-## Features
+## Why finprim?
 
-- ✅ IBAN validation and formatting (80+ countries, with country code)
-- ✅ UK sort code and account number validation
-- ✅ BIC/SWIFT validation
-- ✅ Card number validation (Luhn, network detection, formatting)
-- ✅ Currency validation and formatting with locale support
-- ✅ Branded types for compile-time correctness
-- ✅ Zod schemas out of the box
-- ✅ Optional React hooks for form inputs
-- ✅ Zero dependencies at the core
-- ✅ Tree-shakeable ESM and CJS builds
-- ✅ Fully typed
+| Problem | finprim |
+|---|---|
+| 5 different npm packages for financial validation | **One unified library** |
+| Custom glue code between validators | **Consistent API across all validators** |
+| Runtime type confusion | **Branded TypeScript types** for compile-time safety |
+| No framework integration | **Built-in Zod schemas, React hooks, NestJS pipes** |
+| Heavy dependency trees | **Zero runtime dependencies** |
 
 ---
 
-## Installation
+## Features
 
-```bash
-npm install finprim
-```
+- **Validators** - IBAN (80+ countries), BIC/SWIFT, UK sort code & account number, card number (Luhn + network detection), EU VAT, US ABA routing number
+- **Loan math** - EMI calculation and full amortization schedules
+- **Formatting** - Display-ready IBAN, sort code, account number, and multi-locale currency formatting
+- **Branded types** - Compile-time correctness that prevents invalid data from flowing through your system
+- **Framework integrations** - Zod schemas, React hooks, NestJS pipes (all optional)
+- **Production-ready** - Input length guards, type checking, no sensitive data logging
+- **Lightweight** - Zero dependencies, tree-shakeable ESM + CJS
 
-For Zod integration:
+---
 
-```bash
-npm install finprim zod
-```
+## Integrations
+
+finprim works standalone or plugs into your existing stack:
+
+| Import path | What it contains | Extra dependency |
+|---|---|---|
+| `finprim` | Core validators, formatters, loan math | none |
+| `finprim/zod` | Zod schemas for validation pipelines | `zod` |
+| `finprim/react` | React hooks for form inputs | `react` |
+| `finprim/nest` | NestJS validation pipes | `@nestjs/common` |
 
 ---
 
-## Usage
+## Usage Examples
 
 ### Validation
 
@@ -56,51 +95,76 @@ import {
   validateBIC,
   validateCardNumber,
   validateCurrencyCode,
+  validateEUVAT,
+  validateUSRoutingNumber,
 } from 'finprim'
 
-const iban = validateIBAN('GB29NWBK60161331926819')
+validateIBAN('GB29NWBK60161331926819')
 // { valid: true, value: 'GB29NWBK60161331926819', formatted: 'GB29 NWBK 6016 1331 9268 19', countryCode: 'GB' }
 
-const sortCode = validateUKSortCode('60-16-13')
+validateUKSortCode('60-16-13')
 // { valid: true, value: '601613', formatted: '60-16-13' }
 
-const account = validateUKAccountNumber('31926819')
+validateUKAccountNumber('31926819')
 // { valid: true, value: '31926819', formatted: '3192 6819' }
 
-const card = validateCardNumber('4532015112830366')
-// { valid: true, value: '...', formatted: '4532 0151 1283 0366', network: 'Visa', last4: '0366' }
+validateCardNumber('4532015112830366')
+// { valid: true, formatted: '4532 0151 1283 0366', network: 'Visa', last4: '0366' }
+
+validateEUVAT('DE123456789')
+// { valid: true, value: 'DE123456789', formatted: 'DE 123456789', countryCode: 'DE' }
+
+validateUSRoutingNumber('021000021')
+// { valid: true, value: '021000021', formatted: '021000021' }
+```
+
+### Formatting & Display
+
+```ts
+import { formatIBAN, formatSortCode, formatUKAccountNumber, formatCurrency, parseMoney } from 'finprim'
+
+formatIBAN('GB29NWBK60161331926819')        // 'GB29 NWBK 6016 1331 9268 19'
+formatSortCode('601613')                     // '60-16-13'
+formatUKAccountNumber('31926819')            // '3192 6819'
+
+formatCurrency(1000.5, 'GBP', 'en-GB')      // '£1,000.50'
+formatCurrency(1000.5, 'EUR', 'de-DE')       // '1.000,50 €'
+formatCurrency(1000.5, 'USD', 'en-US')       // '$1,000.50'
+
+parseMoney('£1,000.50')
+// { valid: true, amount: 1000.50, currency: 'GBP', formatted: '£1,000.50' }
 ```
 
-### Currency Formatting
+### Loan / EMI Calculation
 
 ```ts
-import { formatCurrency, parseMoney } from 'finprim'
+import { calculateEMI, getLoanSchedule } from 'finprim'
 
-formatCurrency(1000.5, 'GBP', 'en-GB')  // '£1,000.50'
-formatCurrency(1000.5, 'EUR', 'de-DE')  // '1.000,50 €'
-formatCurrency(1000.5, 'USD', 'en-US')  // '$1,000.50'
+calculateEMI(100_000, 10, 12)
+// Monthly payment amount
 
-parseMoney('£1,000.50')  // { valid: true, amount: 1000.50, currency: 'GBP', formatted: '£1,000.50' }
+getLoanSchedule(100_000, 10, 12)
+// [{ month, payment, principal, interest, balance }, ...]
 ```
 
 ### Branded Types
 
 ```ts
-import type { IBAN, SortCode, AccountNumber, CurrencyCode } from 'finprim'
+import type { IBAN, SortCode, AccountNumber } from 'finprim'
 
 // Invalid data cannot be passed where valid data is expected
-function processPayment(iban: IBAN, amount: number) { ... }
+function processPayment(iban: IBAN, amount: number) { /* ... */ }
 
-// This forces validation before use
-const iban = validateIBAN(input)
-if (iban.valid) {
-  processPayment(iban.value, 100) // iban.value is typed as IBAN
+const result = validateIBAN(input)
+if (result.valid) {
+  processPayment(result.value, 100) // result.value is typed as IBAN
 }
 ```
 
 ### Zod Schemas
 
 ```ts
+import { z } from 'zod'
 import { ibanSchema, sortCodeSchema, accountNumberSchema, currencySchema } from 'finprim/zod'
 
 const PaymentSchema = z.object({
@@ -114,24 +178,39 @@ const PaymentSchema = z.object({
 
 ### React Hooks
 
-```ts
+```tsx
 import { useIBANInput, useCardNumberInput, useCurrencyInput } from 'finprim/react'
 
 function PaymentForm() {
   const iban = useIBANInput()
   const card = useCardNumberInput()
-  const { rawValue, formatted, onChange } = useCurrencyInput('GBP', 'en-GB')
+  const currency = useCurrencyInput('GBP', 'en-GB')
 
   return (
-    <>
+    <form>
       <input value={iban.value} onChange={iban.onChange} aria-invalid={iban.valid === false} />
       <input value={card.formatted} onChange={card.onChange} aria-invalid={card.valid === false} />
-      <input value={formatted} onChange={onChange} />
-    </>
+      <input value={currency.formatted} onChange={currency.onChange} />
+    </form>
   )
 }
 ```
 
+### NestJS Pipes
+
+```ts
+import { IbanValidationPipe, SortCodeValidationPipe, createValidationPipe } from 'finprim/nest'
+import { validateIBAN } from 'finprim'
+
+@Get('iban/:iban')
+findByIban(@Param('iban', IbanValidationPipe) iban: string) {
+  return this.service.findByIban(iban)
+}
+
+// Create a custom pipe from any validator
+const MyPipe = createValidationPipe(validateIBAN)
+```
+
 ---
 
 ## API Reference
@@ -140,64 +219,73 @@ function PaymentForm() {
 
 | Function | Input | Returns |
 |----------|-------|---------|
-| `validateIBAN(input)` | `string` | `IBANValidationResult` (includes `countryCode` when valid) |
+| `validateIBAN(input)` | `string` | `IBANValidationResult` (includes `countryCode`) |
 | `validateUKSortCode(input)` | `string` | `ValidationResult<SortCode>` |
 | `validateUKAccountNumber(input)` | `string` | `ValidationResult<AccountNumber>` |
 | `validateCurrencyCode(input)` | `string` | `ValidationResult<CurrencyCode>` |
 | `validateBIC(input)` | `string` | `ValidationResult<BIC>` |
-| `validateCardNumber(input)` | `string` | `CardValidationResult` (includes `network`, `last4` when valid) |
+| `validateCardNumber(input)` | `string` | `CardValidationResult` (includes `network`, `last4`) |
+| `validateEUVAT(input)` | `string` | `VATValidationResult` (includes `countryCode`) |
+| `validateUSRoutingNumber(input)` | `string` | `ValidationResult<RoutingNumber>` |
 
 ### Formatting
 
 | Function | Input | Returns |
 |----------|-------|---------|
+| `formatIBAN(input)` | `string` | `string` (space-separated) |
+| `formatSortCode(input)` | `string` | `string` (XX-XX-XX) |
+| `formatUKAccountNumber(input)` | `string` | `string` (XXXX XXXX) |
 | `formatCurrency(amount, currency, locale?)` | `number`, `SupportedCurrency`, `string?` | `string` |
 | `parseMoney(input)` | `string` | `MoneyResult` |
 
-Validation results include a `formatted` string when valid (e.g. IBAN and card numbers are space-separated).
+### Loan
 
----
-
-## Packages
-
-| Import path | What it contains | Extra dependency |
-|---|---|---|
-| `finprim` | Core validators and formatters | none |
-| `finprim/zod` | Zod schemas | `zod` |
-| `finprim/react` | React hooks | `react` |
+| Function | Input | Returns |
+|----------|-------|---------|
+| `calculateEMI(principal, rate, months)` | `number`, `number`, `number` | `number` |
+| `getLoanSchedule(principal, rate, months)` | `number`, `number`, `number` | `LoanScheduleEntry[]` |
 
 ---
 
-## Tech Stack
+## Roadmap
 
-- TypeScript
-- tsup (build)
-- Vitest (testing)
-- React (optional hooks subpath)
-- Zod (optional schema subpath)
+- [x] IBAN validation (80+ countries)
+- [x] BIC/SWIFT validation
+- [x] Card number validation (Luhn + network detection)
+- [x] EU VAT number validation
+- [x] US routing number validation
+- [x] UK sort code and account number validation
+- [x] Loan/EMI calculation
+- [x] Format-only helpers
+- [x] Currency formatting with locale support
+- [x] Branded TypeScript types
+- [x] Zod schema integration
+- [x] React hooks
+- [x] NestJS pipes
+- [ ] More locale coverage
+- [ ] SEPA credit transfer XML generation
+- [ ] ACH file format support
 
 ---
 
-## Roadmap
+## Security
 
-- [x] SWIFT / BIC validation
-- [x] Luhn algorithm for card number validation
-- [ ] EU VAT number validation
-- [ ] NestJS pipe integration
-- [ ] More locale coverage
+- **Input length** - All string validators reject input longer than 256 characters
+- **Type checking** - Validators require non-empty strings; numeric helpers require finite numbers and sane bounds
+- **No sensitive logging** - The library does not log or persist input
+- **Format helpers** - Cap input length and accept only strings
 
 ---
 
 ## Contributing
 
-Contributions are welcome. Please open an issue before submitting a pull request so we can discuss the change.
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ```bash
-git clone https://github.com/YOUR_USERNAME/finprim
+git clone https://github.com/tintolee/finprim.git
 cd finprim
 npm install
 npm test
-npm run dev
 ```
 
 ---

package/dist/{card-D3WC2rzV.d.mts → card-D2-7wbam.d.mts}

@@ -8,6 +8,8 @@ type AccountNumber = Brand<string, 'AccountNumber'>;
 type CurrencyCode = Brand<string, 'CurrencyCode'>;
 type BIC = Brand<string, 'BIC'>;
 type CardNumber = Brand<string, 'CardNumber'>;
+type VATNumber = Brand<string, 'VATNumber'>;
+type RoutingNumber = Brand<string, 'RoutingNumber'>;
 type SupportedCurrency = 'GBP' | 'EUR' | 'USD' | 'JPY' | 'CHF' | 'CAD' | 'AUD' | 'NZD';
 type ValidationSuccess<T> = {
     valid: true;
@@ -20,6 +22,7 @@ type ValidationFailure = {
 };
 type ValidationResult<T> = ValidationSuccess<T> | ValidationFailure;
 declare function isValidationSuccess<T>(result: ValidationResult<T>): result is ValidationSuccess<T>;
+declare function isValidationFailure<T>(result: ValidationResult<T>): result is ValidationFailure;
 type IBANValidationSuccess = ValidationSuccess<IBAN> & {
     countryCode: string;
 };
@@ -33,6 +36,10 @@ type MoneyResult = {
     valid: false;
     error: string;
 };
+type VATValidationSuccess = ValidationSuccess<VATNumber> & {
+    countryCode: string;
+};
+type VATValidationResult = VATValidationSuccess | ValidationFailure;
 
 type CardNetwork = 'Visa' | 'Mastercard' | 'Amex' | 'Discover' | 'Unknown';
 type CardValidationResult = {
@@ -47,4 +54,4 @@ type CardValidationResult = {
 };
 declare function validateCardNumber(input: string): CardValidationResult;
 
-export { type AccountNumber as A, type BIC as B, type CurrencyCode as C, type IBANValidationResult as I, type MoneyResult as M, type SortCode as S, type ValidationResult as V, type SupportedCurrency as a, type CardNetwork as b, type CardNumber as c, type CardValidationResult as d, type IBAN as e, type IBANValidationSuccess as f, type ValidationFailure as g, type ValidationSuccess as h, isValidationSuccess as i, validateCardNumber as v };
+export { type AccountNumber as A, type BIC as B, type CurrencyCode as C, type IBANValidationResult as I, type MoneyResult as M, type RoutingNumber as R, type SortCode as S, type ValidationResult as V, type SupportedCurrency as a, type VATValidationResult as b, type CardNetwork as c, type CardNumber as d, type CardValidationResult as e, type IBAN as f, type IBANValidationSuccess as g, type VATNumber as h, type VATValidationSuccess as i, type ValidationFailure as j, type ValidationSuccess as k, isValidationFailure as l, isValidationSuccess as m, validateCardNumber as v };

package/dist/{card-D3WC2rzV.d.ts → card-D2-7wbam.d.ts}

@@ -8,6 +8,8 @@ type AccountNumber = Brand<string, 'AccountNumber'>;
 type CurrencyCode = Brand<string, 'CurrencyCode'>;
 type BIC = Brand<string, 'BIC'>;
 type CardNumber = Brand<string, 'CardNumber'>;
+type VATNumber = Brand<string, 'VATNumber'>;
+type RoutingNumber = Brand<string, 'RoutingNumber'>;
 type SupportedCurrency = 'GBP' | 'EUR' | 'USD' | 'JPY' | 'CHF' | 'CAD' | 'AUD' | 'NZD';
 type ValidationSuccess<T> = {
     valid: true;
@@ -20,6 +22,7 @@ type ValidationFailure = {
 };
 type ValidationResult<T> = ValidationSuccess<T> | ValidationFailure;
 declare function isValidationSuccess<T>(result: ValidationResult<T>): result is ValidationSuccess<T>;
+declare function isValidationFailure<T>(result: ValidationResult<T>): result is ValidationFailure;
 type IBANValidationSuccess = ValidationSuccess<IBAN> & {
     countryCode: string;
 };
@@ -33,6 +36,10 @@ type MoneyResult = {
     valid: false;
     error: string;
 };
+type VATValidationSuccess = ValidationSuccess<VATNumber> & {
+    countryCode: string;
+};
+type VATValidationResult = VATValidationSuccess | ValidationFailure;
 
 type CardNetwork = 'Visa' | 'Mastercard' | 'Amex' | 'Discover' | 'Unknown';
 type CardValidationResult = {
@@ -47,4 +54,4 @@ type CardValidationResult = {
 };
 declare function validateCardNumber(input: string): CardValidationResult;
 
-export { type AccountNumber as A, type BIC as B, type CurrencyCode as C, type IBANValidationResult as I, type MoneyResult as M, type SortCode as S, type ValidationResult as V, type SupportedCurrency as a, type CardNetwork as b, type CardNumber as c, type CardValidationResult as d, type IBAN as e, type IBANValidationSuccess as f, type ValidationFailure as g, type ValidationSuccess as h, isValidationSuccess as i, validateCardNumber as v };
+export { type AccountNumber as A, type BIC as B, type CurrencyCode as C, type IBANValidationResult as I, type MoneyResult as M, type RoutingNumber as R, type SortCode as S, type ValidationResult as V, type SupportedCurrency as a, type VATValidationResult as b, type CardNetwork as c, type CardNumber as d, type CardValidationResult as e, type IBAN as f, type IBANValidationSuccess as g, type VATNumber as h, type VATValidationSuccess as i, type ValidationFailure as j, type ValidationSuccess as k, isValidationFailure as l, isValidationSuccess as m, validateCardNumber as v };

package/dist/index.d.mts

@@ -1,8 +1,11 @@
-import { I as IBANValidationResult, V as ValidationResult, A as AccountNumber, S as SortCode, a as SupportedCurrency, M as MoneyResult, C as CurrencyCode, B as BIC } from './card-D3WC2rzV.mjs';
-export { b as CardNetwork, c as CardNumber, d as CardValidationResult, e as IBAN, f as IBANValidationSuccess, g as ValidationFailure, h as ValidationSuccess, i as isValidationSuccess, v as validateCardNumber } from './card-D3WC2rzV.mjs';
+import { I as IBANValidationResult, V as ValidationResult, A as AccountNumber, S as SortCode, a as SupportedCurrency, M as MoneyResult, C as CurrencyCode, B as BIC, b as VATValidationResult, R as RoutingNumber } from './card-D2-7wbam.mjs';
+export { c as CardNetwork, d as CardNumber, e as CardValidationResult, f as IBAN, g as IBANValidationSuccess, h as VATNumber, i as VATValidationSuccess, j as ValidationFailure, k as ValidationSuccess, l as isValidationFailure, m as isValidationSuccess, v as validateCardNumber } from './card-D2-7wbam.mjs';
 
+declare function formatIBAN(input: string): string;
 declare function validateIBAN(input: string): IBANValidationResult;
 
+declare function formatSortCode(input: string): string;
+declare function formatUKAccountNumber(input: string): string;
 declare function validateUKSortCode(input: string): ValidationResult<SortCode>;
 declare function validateUKAccountNumber(input: string): ValidationResult<AccountNumber>;
 
@@ -13,4 +16,18 @@ declare function parseMoney(input: string): MoneyResult;
 
 declare function validateBIC(input: string): ValidationResult<BIC>;
 
-export { AccountNumber, BIC, CurrencyCode, IBANValidationResult, MoneyResult, SUPPORTED_CURRENCIES, SortCode, SupportedCurrency, ValidationResult, formatCurrency, parseMoney, validateBIC, validateCurrencyCode, validateIBAN, validateUKAccountNumber, validateUKSortCode };
+declare function validateEUVAT(input: string): VATValidationResult;
+
+declare function validateUSRoutingNumber(input: string): ValidationResult<RoutingNumber>;
+
+type LoanScheduleEntry = {
+    month: number;
+    payment: number;
+    principal: number;
+    interest: number;
+    balance: number;
+};
+declare function calculateEMI(principal: number, annualRatePercent: number, months: number): number;
+declare function getLoanSchedule(principal: number, annualRatePercent: number, months: number): LoanScheduleEntry[];
+
+export { AccountNumber, BIC, CurrencyCode, IBANValidationResult, type LoanScheduleEntry, MoneyResult, RoutingNumber, SUPPORTED_CURRENCIES, SortCode, SupportedCurrency, VATValidationResult, ValidationResult, calculateEMI, formatCurrency, formatIBAN, formatSortCode, formatUKAccountNumber, getLoanSchedule, parseMoney, validateBIC, validateCurrencyCode, validateEUVAT, validateIBAN, validateUKAccountNumber, validateUKSortCode, validateUSRoutingNumber };

package/dist/index.d.ts

@@ -1,8 +1,11 @@
-import { I as IBANValidationResult, V as ValidationResult, A as AccountNumber, S as SortCode, a as SupportedCurrency, M as MoneyResult, C as CurrencyCode, B as BIC } from './card-D3WC2rzV.js';
-export { b as CardNetwork, c as CardNumber, d as CardValidationResult, e as IBAN, f as IBANValidationSuccess, g as ValidationFailure, h as ValidationSuccess, i as isValidationSuccess, v as validateCardNumber } from './card-D3WC2rzV.js';
+import { I as IBANValidationResult, V as ValidationResult, A as AccountNumber, S as SortCode, a as SupportedCurrency, M as MoneyResult, C as CurrencyCode, B as BIC, b as VATValidationResult, R as RoutingNumber } from './card-D2-7wbam.js';
+export { c as CardNetwork, d as CardNumber, e as CardValidationResult, f as IBAN, g as IBANValidationSuccess, h as VATNumber, i as VATValidationSuccess, j as ValidationFailure, k as ValidationSuccess, l as isValidationFailure, m as isValidationSuccess, v as validateCardNumber } from './card-D2-7wbam.js';
 
+declare function formatIBAN(input: string): string;
 declare function validateIBAN(input: string): IBANValidationResult;
 
+declare function formatSortCode(input: string): string;
+declare function formatUKAccountNumber(input: string): string;
 declare function validateUKSortCode(input: string): ValidationResult<SortCode>;
 declare function validateUKAccountNumber(input: string): ValidationResult<AccountNumber>;
 
@@ -13,4 +16,18 @@ declare function parseMoney(input: string): MoneyResult;
 
 declare function validateBIC(input: string): ValidationResult<BIC>;
 
-export { AccountNumber, BIC, CurrencyCode, IBANValidationResult, MoneyResult, SUPPORTED_CURRENCIES, SortCode, SupportedCurrency, ValidationResult, formatCurrency, parseMoney, validateBIC, validateCurrencyCode, validateIBAN, validateUKAccountNumber, validateUKSortCode };
+declare function validateEUVAT(input: string): VATValidationResult;
+
+declare function validateUSRoutingNumber(input: string): ValidationResult<RoutingNumber>;
+
+type LoanScheduleEntry = {
+    month: number;
+    payment: number;
+    principal: number;
+    interest: number;
+    balance: number;
+};
+declare function calculateEMI(principal: number, annualRatePercent: number, months: number): number;
+declare function getLoanSchedule(principal: number, annualRatePercent: number, months: number): LoanScheduleEntry[];
+
+export { AccountNumber, BIC, CurrencyCode, IBANValidationResult, type LoanScheduleEntry, MoneyResult, RoutingNumber, SUPPORTED_CURRENCIES, SortCode, SupportedCurrency, VATValidationResult, ValidationResult, calculateEMI, formatCurrency, formatIBAN, formatSortCode, formatUKAccountNumber, getLoanSchedule, parseMoney, validateBIC, validateCurrencyCode, validateEUVAT, validateIBAN, validateUKAccountNumber, validateUKSortCode, validateUSRoutingNumber };