@temboplus/frontend-react-core 0.1.1

package/README.md

@@ -0,0 +1,385 @@
+# @temboplus/frontend-react-core
+
+A React UI library for TemboPlus applications, providing reusable components, validators, and utilities for building consistent react applications across the platform.
+
+## 📦 Installation
+
+```bash
+npm install @temboplus/frontend-react-core
+# or
+yarn add @temboplus/frontend-react-core
+# or
+pnpm add @temboplus/frontend-react-core
+```
+
+## 🏗️ Dependencies
+
+This package requires the following peer dependencies:
+
+```bash
+npm install @temboplus/frontend-core
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { PHONE_NUMBER_VALIDATOR, AMOUNT_VALIDATOR } from '@temboplus/frontend-react-core';
+
+// Use in your Ant Design form
+const formRules = {
+  phoneNumber: [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }],
+  amount: [{ required: true, validator: AMOUNT_VALIDATOR({ currencyCode: 'TZS' }) }]
+};
+```
+
+## 📚 Features
+
+### ✅ Form Validators (Available Now)
+
+Type-safe, country-aware form validators for Ant Design forms with built-in internationalization and error messaging.
+
+### 🔄 Coming Soon
+
+- **Reusable React Components** - Pre-built UI components for financial applications
+- **Hooks Library** - Custom React hooks for common patterns
+- **Context Providers** - Application-wide state management
+- **Theme System** - Consistent design tokens and styling
+- **Utility Functions** - Helper functions for React applications
+
+## 📋 API Reference
+
+### Form Validators
+
+All validators follow the Ant Design validator pattern and return Promise-based validation results.
+
+#### `PHONE_NUMBER_VALIDATOR(countryCode?: ISO2CountryCode)`
+
+Validates general phone number format using libphonenumber-js.
+
+```typescript
+import { PHONE_NUMBER_VALIDATOR } from '@temboplus/frontend-react-core';
+
+// Basic usage
+const rules = [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }];
+
+// Supported countries: TZ, KE, and all libphonenumber-js supported countries
+```
+
+**Features:**
+- Validates phone number format for any country
+- Returns normalized E.164 format on success
+- Country-specific error messages
+- Supports international and local number formats
+
+#### `MOBILE_PHONE_VALIDATOR(countryCode?: ISO2CountryCode)`
+
+Validates mobile phone numbers eligible for payout operations (stricter validation).
+
+```typescript
+import { MOBILE_PHONE_VALIDATOR } from '@temboplus/frontend-react-core';
+
+const rules = [{ required: true, validator: MOBILE_PHONE_VALIDATOR('TZ') }];
+```
+
+**Features:**
+- Validates mobile-specific number formats
+- Checks payout eligibility (supports TZ and KE)
+- MNO (Mobile Network Operator) validation
+- Returns normalized E.164 format
+
+#### `ACCOUNT_NAME_VALIDATOR`
+
+Validates bank account holder names.
+
+```typescript
+import { ACCOUNT_NAME_VALIDATOR } from '@temboplus/frontend-react-core';
+
+const rules = [{ required: true, validator: ACCOUNT_NAME_VALIDATOR }];
+```
+
+**Validation Rules:**
+- 3-50 characters length
+- Only letters, spaces, hyphens, apostrophes, commas
+- At least two words (first name + last name)
+- Not all uppercase
+- No numbers or special characters
+
+#### `SWIFT_CODE_VALIDATOR(countryCode?: ISO2CountryCode)`
+
+Validates SWIFT/BIC codes for banks.
+
+```typescript
+import { SWIFT_CODE_VALIDATOR } from '@temboplus/frontend-react-core';
+
+// Country-specific validation
+const rules = [{ required: true, validator: SWIFT_CODE_VALIDATOR('TZ') }];
+
+// Multi-country validation
+const rules = [{ required: true, validator: SWIFT_CODE_VALIDATOR() }];
+```
+
+**Features:**
+- Validates against known bank SWIFT codes
+- Country-specific validation (TZ, KE)
+- Automatic uppercase conversion
+- Real bank verification
+
+#### `ACCOUNT_NUMBER_VALIDATOR(countryCode?: ISO2CountryCode)`
+
+Validates bank account numbers with country-specific formats.
+
+```typescript
+import { ACCOUNT_NUMBER_VALIDATOR } from '@temboplus/frontend-react-core';
+
+const rules = [{ required: true, validator: ACCOUNT_NUMBER_VALIDATOR('KE') }];
+```
+
+**Country-Specific Rules:**
+- **Kenya (KE)**: 10, 12, or 15 alphanumeric characters
+- **Tanzania (TZ)**: 9-19 characters
+- Automatic space removal and normalization
+
+#### `AMOUNT_VALIDATOR(options?: AmountValidatorOptions)`
+
+Validates monetary amounts with currency-specific constraints.
+
+```typescript
+import { AMOUNT_VALIDATOR } from '@temboplus/frontend-react-core';
+
+// Basic usage with defaults
+const rules = [{ required: true, validator: AMOUNT_VALIDATOR() }];
+
+// Custom configuration
+const rules = [{
+  required: true,
+  validator: AMOUNT_VALIDATOR({
+    currencyCode: 'KES',
+    min: 100,
+    max: 50000,
+    invalidFormatMessage: 'Please enter a valid amount',
+    minMessage: 'Minimum amount is 100 KES',
+    maxMessage: 'Maximum amount is 50,000 KES'
+  })
+}];
+
+// Disable constraints
+const rules = [{
+  required: true,
+  validator: AMOUNT_VALIDATOR({
+    currencyCode: 'USD',
+    min: null,    // No minimum
+    max: null,    // No maximum
+  })
+}];
+```
+
+**Default Constraints:**
+- **TZS**: Min: 1,000, Max: 1,000,000
+- **KES**: Min: 40, Max: 40,000,000  
+- **Other**: Min: 1, Max: 1,000,000
+
+**Options:**
+```typescript
+interface AmountValidatorOptions {
+  currencyCode?: CurrencyCode;           // Default: 'TZS'
+  min?: number | null;                   // Default: currency-specific
+  max?: number | null;                   // Default: currency-specific
+  invalidFormatMessage?: string;         // Custom error message
+  minMessage?: string;                   // Custom minimum error
+  maxMessage?: string;                   // Custom maximum error
+}
+```
+
+**Features:**
+- Supports all currencies from @temboplus/frontend-core
+- Handles comma-separated numbers (1,000.50)
+- Rejects negative amounts
+- Currency-specific formatting
+- Returns normalized numeric format
+
+## 🎯 Usage Examples
+
+### Complete Form Example
+
+```typescript
+import React from 'react';
+import { Form, Input, Button } from 'antd';
+import {
+  PHONE_NUMBER_VALIDATOR,
+  AMOUNT_VALIDATOR,
+  ACCOUNT_NAME_VALIDATOR,
+  SWIFT_CODE_VALIDATOR,
+  ACCOUNT_NUMBER_VALIDATOR,
+} from '@temboplus/frontend-react-core';
+
+const PayoutForm: React.FC = () => {
+  const [form] = Form.useForm();
+
+  const onFinish = (values: any) => {
+    console.log('Validated values:', values);
+  };
+
+  return (
+    <Form form={form} onFinish={onFinish} layout="vertical">
+      <Form.Item
+        label="Phone Number"
+        name="phoneNumber"
+        rules={[{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }]}
+      >
+        <Input placeholder="+255 712 345 678" />
+      </Form.Item>
+
+      <Form.Item
+        label="Amount"
+        name="amount"
+        rules={[{
+          required: true,
+          validator: AMOUNT_VALIDATOR({
+            currencyCode: 'TZS',
+            min: 1000,
+            max: 100000
+          })
+        }]}
+      >
+        <Input placeholder="10,000" />
+      </Form.Item>
+
+      <Form.Item
+        label="Account Name"
+        name="accountName"
+        rules={[{ required: true, validator: ACCOUNT_NAME_VALIDATOR }]}
+      >
+        <Input placeholder="John Smith" />
+      </Form.Item>
+
+      <Form.Item
+        label="Bank SWIFT Code"
+        name="swiftCode"
+        rules={[{ required: true, validator: SWIFT_CODE_VALIDATOR('TZ') }]}
+      >
+        <Input placeholder="CORUTZTZ" />
+      </Form.Item>
+
+      <Form.Item
+        label="Account Number"
+        name="accountNumber"
+        rules={[{ required: true, validator: ACCOUNT_NUMBER_VALIDATOR('TZ') }]}
+      >
+        <Input placeholder="123456789" />
+      </Form.Item>
+
+      <Form.Item>
+        <Button type="primary" htmlType="submit">
+          Submit
+        </Button>
+      </Form.Item>
+    </Form>
+  );
+};
+
+export default PayoutForm;
+```
+
+### Multi-Country Support
+
+```typescript
+import { useState } from 'react';
+import { PHONE_NUMBER_VALIDATOR, AMOUNT_VALIDATOR } from '@temboplus/frontend-react-core';
+
+const MultiCountryForm: React.FC = () => {
+  const [selectedCountry, setSelectedCountry] = useState<'TZ' | 'KE'>('TZ');
+
+  const getValidationRules = () => ({
+    phoneNumber: [{ 
+      required: true, 
+      validator: PHONE_NUMBER_VALIDATOR(selectedCountry) 
+    }],
+    amount: [{ 
+      required: true, 
+      validator: AMOUNT_VALIDATOR({ 
+        currencyCode: selectedCountry === 'TZ' ? 'TZS' : 'KES' 
+      }) 
+    }]
+  });
+
+  // Rest of component...
+};
+```
+
+## 🌍 Supported Countries
+
+| Country  | Code | Phone | Mobile | Bank | Currency        |
+| -------- | ---- | ----- | ------ | ---- | --------------- |
+| Tanzania | TZ   | ✅     | ✅      | ✅    | TZS             |
+| Kenya    | KE   | ✅     | ✅      | ✅    | KES             |
+| Global   | *    | ✅     | ❌      | ❌    | 150+ currencies |
+
+## 🔧 Error Handling
+
+All validators provide clear, user-friendly error messages:
+
+```typescript
+// Phone validation errors
+"Invalid Tanzania phone number format. Please enter a valid Tanzania phone number."
+
+// Amount validation errors  
+"Amount must be at least TSh 1,000. Please enter a higher amount."
+"Negative amounts are not allowed. Please enter a positive amount."
+
+// Account name errors
+"Invalid account name. Please enter a valid full name with at least two words."
+
+// SWIFT code errors
+"Invalid Tanzania SWIFT code. Please enter a valid Tanzania bank SWIFT/BIC code."
+```
+
+## 🏆 Best Practices
+
+### 1. Always Specify Country Context
+```typescript
+// ✅ Good - specific country validation
+validator: PHONE_NUMBER_VALIDATOR('TZ')
+
+// ❌ Less ideal - generic validation
+validator: PHONE_NUMBER_VALIDATOR()
+```
+
+### 2. Combine with Required Rules
+```typescript
+// ✅ Good - explicit required validation
+rules: [
+  { required: true, message: 'Phone number is required' },
+  { validator: PHONE_NUMBER_VALIDATOR('TZ') }
+]
+
+// ✅ Also good - validator handles required
+rules: [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }]
+```
+
+### 3. Custom Error Messages
+```typescript
+// ✅ Good - custom business-specific messages
+validator: AMOUNT_VALIDATOR({
+  currencyCode: 'TZS',
+  min: 5000,
+  minMessage: 'Minimum transfer amount is TSh 5,000 for international transfers'
+})
+```
+
+### 4. Normalize Return Values
+```typescript
+const onFinish = (values: any) => {
+  // Validators return normalized values
+  console.log(values.phoneNumber); // "+255712345678" (E.164 format)
+  console.log(values.amount);      // "10000.00" (normalized number)
+  console.log(values.swiftCode);   // "CORUTZTZ" (uppercase)
+};
+```
+
+## 📄 License
+
+Private package for TemboPlus applications.
+
+## 🔗 Related Packages
+
+- **[@temboplus/frontend-core](https://github.com/TemboPlus-Frontend/temboplus-frontend-core)** - Core business logic and models

package/dist/antd-validators.d.ts

@@ -0,0 +1,139 @@
+import type { CurrencyCode, ISO2CountryCode } from "@temboplus/frontend-core";
+/**
+ * Creates a validator for general phone numbers that validates format and country.
+ * Uses PhoneNumberFactory.canCreate() for validation.
+ *
+ * @param countryCode - The ISO2 country code for validation context
+ * @returns Validator function for AntD form rules
+ *
+ * @example
+ * // In form rules
+ * rules: [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }]
+ */
+export declare const PHONE_NUMBER_VALIDATOR: (countryCode?: ISO2CountryCode) => (rule: any, value: string | null | undefined) => Promise<string | undefined>;
+/**
+ * Creates a validator for mobile phone numbers eligible for payout operations.
+ * Uses PhoneNumberFactory.checkPayoutEligibility() for validation.
+ *
+ * @param countryCode - The ISO2 country code for validation context
+ * @returns Validator function for AntD form rules
+ *
+ * @example
+ * // In form rules
+ * rules: [{ required: true, validator: MOBILE_PHONE_VALIDATOR('TZ') }]
+ */
+export declare const MOBILE_PHONE_VALIDATOR: (countryCode?: ISO2CountryCode) => (rule: any, value: string | null | undefined) => Promise<string | undefined>;
+/**
+ * Validator for account name field using existing BankValidation.
+ * Ensures the account name meets the criteria defined in your validation utils.
+ *
+ * @param rule - The rule object for validation
+ * @param value - The value to validate
+ * @returns Promise resolving to trimmed account name or rejecting with error
+ *
+ * @example
+ * // In form rules
+ * rules: [{ required: true, validator: ACCOUNT_NAME_VALIDATOR }]
+ */
+export declare const ACCOUNT_NAME_VALIDATOR: (rule: any, value: string | null | undefined) => Promise<string | undefined>;
+/**
+ * Creates a validator for SWIFT/BIC codes specific to a country.
+ * Uses BankValidation.validateSwiftCode() for validation.
+ *
+ * @param countryCode - The ISO2 country code for validation context
+ * @returns Validator function for AntD form rules
+ *
+ * @example
+ * // In form rules
+ * rules: [{ required: true, validator: SWIFT_CODE_VALIDATOR('TZ') }]
+ */
+export declare const SWIFT_CODE_VALIDATOR: (countryCode?: ISO2CountryCode) => (rule: any, value: string | null | undefined) => Promise<string | undefined>;
+/**
+ * Creates a validator for bank account numbers specific to a country.
+ * Uses BankValidation.validateAccountNumber() for validation.
+ *
+ * @param countryCode - The ISO2 country code for validation context
+ * @returns Validator function for AntD form rules
+ *
+ * @example
+ * // In form rules
+ * rules: [{ required: true, validator: ACCOUNT_NUMBER_VALIDATOR('KE') }]
+ */
+export declare const ACCOUNT_NUMBER_VALIDATOR: (countryCode?: ISO2CountryCode) => (rule: any, value: string | null | undefined) => Promise<string | undefined>;
+/**
+ * Configuration options for amount validation
+ */
+interface AmountValidatorOptions {
+    /** Currency code for validation (defaults to 'TZS') */
+    currencyCode?: CurrencyCode;
+    /** Minimum allowed amount (inclusive). Set to null to disable minimum constraint. */
+    min?: number | null;
+    /** Maximum allowed amount (inclusive). Set to null to disable maximum constraint. */
+    max?: number | null;
+    /** Custom error message for invalid format */
+    invalidFormatMessage?: string;
+    /** Custom error message for minimum validation */
+    minMessage?: string;
+    /** Custom error message for maximum validation */
+    maxMessage?: string;
+}
+/**
+ * Creates a validator for monetary amounts using the Amount class.
+ * Validates format, currency, and range constraints with currency-specific defaults.
+ * Only allows positive amounts (including zero).
+ *
+ * **Default Range Constraints by Currency:**
+ * - **TZS (Tanzanian Shilling)**: Min: 1,000 TZS, Max: 1,000,000 TZS
+ * - **KES (Kenyan Shilling)**: Min: 40 KES, Max: 40,000,000 KES
+ * - **Other Currencies**: Min: 1, Max: 1,000,000 (in respective currency units)
+ *
+ * These defaults are applied only when `min` and/or `max` options are not explicitly provided.
+ * You can override these defaults by providing explicit `min` and `max` values in the options.
+ * Set `min` or `max` to `null` to completely disable that constraint.
+ *
+ * @param options - Configuration options for amount validation
+ * @returns Validator function for AntD form rules
+ *
+ * @example
+ * // Basic validation with TZS currency (uses default min: 1,000 TZS, max: 1,000,000 TZS)
+ * rules: [{ required: true, validator: AMOUNT_VALIDATOR() }]
+ *
+ * @example
+ * // Basic validation with KES currency (uses default min: 40 KES, max: 40,000,000 KES)
+ * rules: [{ required: true, validator: AMOUNT_VALIDATOR({ currencyCode: 'KES' }) }]
+ *
+ * @example
+ * // Override default ranges with custom min/max values
+ * rules: [{
+ *   required: true,
+ *   validator: AMOUNT_VALIDATOR({
+ *     currencyCode: 'USD',
+ *     min: 1,           // Custom minimum (overrides default)
+ *     max: 10000,       // Custom maximum (overrides default)
+ *   })
+ * }]
+ *
+ * @example
+ * // Disable range validation by setting min and max to null
+ * rules: [{
+ *   required: true,
+ *   validator: AMOUNT_VALIDATOR({
+ *     currencyCode: 'USD',
+ *     min: null,        // No minimum constraint
+ *     max: null,        // No maximum constraint
+ *   })
+ * }]
+ *
+ * @example
+ * // Disable only minimum constraint, keep maximum
+ * rules: [{
+ *   required: true,
+ *   validator: AMOUNT_VALIDATOR({
+ *     currencyCode: 'TZS',
+ *     min: null,        // No minimum constraint
+ *     // max uses default (1,000,000 TZS)
+ *   })
+ * }]
+ */
+export declare const AMOUNT_VALIDATOR: (options?: AmountValidatorOptions) => (rule: any, value: string | number | null | undefined) => Promise<string | undefined>;
+export {};

package/dist/index.cjs.js

@@ -0,0 +1,2 @@
+"use strict";var e=require("@temboplus/frontend-core");exports.ACCOUNT_NAME_VALIDATOR=(r,o)=>{const n=null==o?void 0:o.toString().trim();if(!n)return r.required?Promise.reject(new Error("Account name is required.")):Promise.resolve(void 0);return e.BankValidation.validateAccountName(n)?Promise.resolve(n):Promise.reject(new Error("Invalid account name. Please enter a valid full name with at least two words (e.g., 'John Smith', 'Anna-Marie Johnson')."))},exports.ACCOUNT_NUMBER_VALIDATOR=r=>(o,n)=>{var t;const i=null==n?void 0:n.toString().trim();if(!i)return o.required?Promise.reject(new Error("Account number is required.")):Promise.resolve(void 0);const a=i.replace(/\s+/g,"");if(r){if(e.BankValidation.validateAccountNumber(a,r))return Promise.resolve(a);const o=null===(t=e.Country.from(r))||void 0===t?void 0:t.name,n=function(e){return{TZ:"Account number should be 9-19 characters long.",KE:"Account number should be 10, 12, or 15 alphanumeric characters."}[e]||"Please enter a valid account number."}(r);return Promise.reject(new Error(`Invalid ${o} account number format. ${n}`))}return e.BankValidation.validateAccountNumberForAnyCountry(a)?Promise.resolve(a):Promise.reject(new Error("Invalid account number format"))},exports.AMOUNT_VALIDATOR=(r={})=>{const{currencyCode:o="TZS",invalidFormatMessage:n,minMessage:t,maxMessage:i}=r,{defaultMin:a,defaultMax:u}=(e=>{switch(e){case"TZS":return{defaultMin:1e3,defaultMax:1e6};case"KES":return{defaultMin:40,defaultMax:4e7};default:return{defaultMin:1,defaultMax:1e6}}})(o),s=void 0!==r.min?r.min:a,l=void 0!==r.max?r.max:u;return(r,a)=>{const u=null==a?void 0:a.toString().trim();if(!u)return r.required?Promise.reject(new Error("Amount is required.")):Promise.resolve(void 0);const m=e.Amount.from(u,o);if(!m)return Promise.reject(new Error(n||'Invalid amount format. Please enter a valid monetary amount (e.g., "1000", "1,234.56").'));const d=m.numericValue;if(m.isNegative())return Promise.reject(new Error("Negative amounts are not allowed. Please enter a positive amount."));if(null!==s&&d<s){const r=e.Amount.from(s,o);return Promise.reject(new Error(t||`Amount must be at least ${(null==r?void 0:r.label)||s}. Please enter a higher amount.`))}if(null!==l&&d>l){const r=e.Amount.from(l,o);return Promise.reject(new Error(i||`Amount must not exceed ${(null==r?void 0:r.label)||l}. Please enter a lower amount.`))}return Promise.resolve(m.formattedNumericValue)}},exports.MOBILE_PHONE_VALIDATOR=r=>(o,n)=>{var t;const i=null==n?void 0:n.toString().trim();if(!i)return o.required?Promise.reject(new Error("Mobile phone number is required.")):Promise.resolve(void 0);const a=e.PhoneNumberFactory.create(i,{defaultCountry:r});if(!a)return Promise.reject(new Error("This phone number is invalid."));if(e.PhoneNumberFactory.checkPayoutEligibility(a))return Promise.resolve((null==a?void 0:a.e164Format)||i);if(r){const o=null===(t=e.Country.from(r))||void 0===t?void 0:t.name;return Promise.reject(new Error(`Invalid ${o} phone number format. Please enter a valid ${o} phone number.`))}return Promise.reject(new Error("This phone number is invalid."))},exports.PHONE_NUMBER_VALIDATOR=r=>(o,n)=>{var t;const i=null==n?void 0:n.toString().trim();if(!i)return o.required?Promise.reject(new Error("Phone number is required.")):Promise.resolve(void 0);if(e.PhoneNumberFactory.canCreate(i,{defaultCountry:r})){const o=e.PhoneNumberFactory.create(i,{defaultCountry:r});return Promise.resolve((null==o?void 0:o.e164Format)||i)}if(r){const o=null===(t=e.Country.from(r))||void 0===t?void 0:t.name;return Promise.reject(new Error(`Invalid ${o} phone number format. Please enter a valid ${o} phone number.`))}return Promise.reject(new Error("This phone number is invalid."))},exports.SWIFT_CODE_VALIDATOR=r=>(o,n)=>{var t;const i=null==n?void 0:n.toString().trim().toUpperCase();if(!i)return o.required?Promise.reject(new Error("SWIFT code is required.")):Promise.resolve(void 0);if(r){if(e.BankValidation.validateSwiftCode(i,r))return Promise.resolve(i);const o=null===(t=e.Country.from(r))||void 0===t?void 0:t.name;return Promise.reject(new Error(`Invalid ${o} SWIFT code. Please enter a valid ${o} bank SWIFT/BIC code.`))}return e.BankValidation.validateSwiftCodeForAnyCountry(i)?Promise.resolve(i):Promise.reject(new Error("Invalid SWIFT code. Please enter a valid supported bank SWIFT/BIC code."))};
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/antd-validators.ts"],"sourcesContent":[null],"names":["rule","value","accountNameString","toString","trim","required","Promise","reject","Error","resolve","undefined","BankValidation","validateAccountName","countryCode","accountNumberString","normalizedAccountNumber","replace","validateAccountNumber","countryName","_a","Country","from","name","formatHint","TZ","KE","getAccountNumberFormatHint","validateAccountNumberForAnyCountry","options","currencyCode","invalidFormatMessage","minMessage","maxMessage","defaultMin","defaultMax","currency","getDefaultConstraints","min","max","amountString","amountInstance","Amount","numericValue","isNegative","minAmount","label","maxAmount","formattedNumericValue","phoneString","phoneInstance","PhoneNumberFactory","create","defaultCountry","checkPayoutEligibility","e164Format","canCreate","swiftCodeString","toUpperCase","validateSwiftCode","validateSwiftCodeForAnyCountry"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./antd-validators";

package/dist/index.esm.js

@@ -0,0 +1,2 @@
+import{PhoneNumberFactory as e,Country as r,BankValidation as o,Amount as n}from"@temboplus/frontend-core";const t=o=>(n,t)=>{var i;const a=null==t?void 0:t.toString().trim();if(!a)return n.required?Promise.reject(new Error("Phone number is required.")):Promise.resolve(void 0);if(e.canCreate(a,{defaultCountry:o})){const r=e.create(a,{defaultCountry:o});return Promise.resolve((null==r?void 0:r.e164Format)||a)}if(o){const e=null===(i=r.from(o))||void 0===i?void 0:i.name;return Promise.reject(new Error(`Invalid ${e} phone number format. Please enter a valid ${e} phone number.`))}return Promise.reject(new Error("This phone number is invalid."))},i=o=>(n,t)=>{var i;const a=null==t?void 0:t.toString().trim();if(!a)return n.required?Promise.reject(new Error("Mobile phone number is required.")):Promise.resolve(void 0);const u=e.create(a,{defaultCountry:o});if(!u)return Promise.reject(new Error("This phone number is invalid."));if(e.checkPayoutEligibility(u))return Promise.resolve((null==u?void 0:u.e164Format)||a);if(o){const e=null===(i=r.from(o))||void 0===i?void 0:i.name;return Promise.reject(new Error(`Invalid ${e} phone number format. Please enter a valid ${e} phone number.`))}return Promise.reject(new Error("This phone number is invalid."))},a=(e,r)=>{const n=null==r?void 0:r.toString().trim();if(!n)return e.required?Promise.reject(new Error("Account name is required.")):Promise.resolve(void 0);return o.validateAccountName(n)?Promise.resolve(n):Promise.reject(new Error("Invalid account name. Please enter a valid full name with at least two words (e.g., 'John Smith', 'Anna-Marie Johnson')."))},u=e=>(n,t)=>{var i;const a=null==t?void 0:t.toString().trim().toUpperCase();if(!a)return n.required?Promise.reject(new Error("SWIFT code is required.")):Promise.resolve(void 0);if(e){if(o.validateSwiftCode(a,e))return Promise.resolve(a);const n=null===(i=r.from(e))||void 0===i?void 0:i.name;return Promise.reject(new Error(`Invalid ${n} SWIFT code. Please enter a valid ${n} bank SWIFT/BIC code.`))}return o.validateSwiftCodeForAnyCountry(a)?Promise.resolve(a):Promise.reject(new Error("Invalid SWIFT code. Please enter a valid supported bank SWIFT/BIC code."))},s=e=>(n,t)=>{var i;const a=null==t?void 0:t.toString().trim();if(!a)return n.required?Promise.reject(new Error("Account number is required.")):Promise.resolve(void 0);const u=a.replace(/\s+/g,"");if(e){if(o.validateAccountNumber(u,e))return Promise.resolve(u);const n=null===(i=r.from(e))||void 0===i?void 0:i.name,t=function(e){return{TZ:"Account number should be 9-19 characters long.",KE:"Account number should be 10, 12, or 15 alphanumeric characters."}[e]||"Please enter a valid account number."}(e);return Promise.reject(new Error(`Invalid ${n} account number format. ${t}`))}return o.validateAccountNumberForAnyCountry(u)?Promise.resolve(u):Promise.reject(new Error("Invalid account number format"))},l=(e={})=>{const{currencyCode:r="TZS",invalidFormatMessage:o,minMessage:t,maxMessage:i}=e,{defaultMin:a,defaultMax:u}=(e=>{switch(e){case"TZS":return{defaultMin:1e3,defaultMax:1e6};case"KES":return{defaultMin:40,defaultMax:4e7};default:return{defaultMin:1,defaultMax:1e6}}})(r),s=void 0!==e.min?e.min:a,l=void 0!==e.max?e.max:u;return(e,a)=>{const u=null==a?void 0:a.toString().trim();if(!u)return e.required?Promise.reject(new Error("Amount is required.")):Promise.resolve(void 0);const m=n.from(u,r);if(!m)return Promise.reject(new Error(o||'Invalid amount format. Please enter a valid monetary amount (e.g., "1000", "1,234.56").'));const d=m.numericValue;if(m.isNegative())return Promise.reject(new Error("Negative amounts are not allowed. Please enter a positive amount."));if(null!==s&&d<s){const e=n.from(s,r);return Promise.reject(new Error(t||`Amount must be at least ${(null==e?void 0:e.label)||s}. Please enter a higher amount.`))}if(null!==l&&d>l){const e=n.from(l,r);return Promise.reject(new Error(i||`Amount must not exceed ${(null==e?void 0:e.label)||l}. Please enter a lower amount.`))}return Promise.resolve(m.formattedNumericValue)}};export{a as ACCOUNT_NAME_VALIDATOR,s as ACCOUNT_NUMBER_VALIDATOR,l as AMOUNT_VALIDATOR,i as MOBILE_PHONE_VALIDATOR,t as PHONE_NUMBER_VALIDATOR,u as SWIFT_CODE_VALIDATOR};
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/antd-validators.ts"],"sourcesContent":[null],"names":["PHONE_NUMBER_VALIDATOR","countryCode","rule","value","phoneString","toString","trim","required","Promise","reject","Error","resolve","undefined","PhoneNumberFactory","canCreate","defaultCountry","phoneInstance","create","e164Format","countryName","_a","Country","from","name","MOBILE_PHONE_VALIDATOR","checkPayoutEligibility","ACCOUNT_NAME_VALIDATOR","accountNameString","BankValidation","validateAccountName","SWIFT_CODE_VALIDATOR","swiftCodeString","toUpperCase","validateSwiftCode","validateSwiftCodeForAnyCountry","ACCOUNT_NUMBER_VALIDATOR","accountNumberString","normalizedAccountNumber","replace","validateAccountNumber","formatHint","TZ","KE","getAccountNumberFormatHint","validateAccountNumberForAnyCountry","AMOUNT_VALIDATOR","options","currencyCode","invalidFormatMessage","minMessage","maxMessage","defaultMin","defaultMax","currency","getDefaultConstraints","min","max","amountString","amountInstance","Amount","numericValue","isNegative","minAmount","label","maxAmount","formattedNumericValue"],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@temboplus/frontend-react-core",
+  "version": "0.1.1",
+  "repository": "https://github.com/TemboPlus-Frontend/temboplus-frontend-react-core",
+  "author": "Okello Gerald",
+  "license": "ISC",
+  "description": "A React UI library for TemboPlus applications, providing reusable components, validators, and utilities for building consistent react applications across the platform.",
+  "scripts": {
+    "build": "rollup -c rollup.config.js --configTsconfig tsconfig.build.json",
+    "prepare": "npm run build",
+    "dev": "npm run build -- --watch",
+    "test": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [],
+  "devDependencies": {
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.3",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "@vitest/coverage-v8": "^3.2.4",
+    "antd": "5.26.2",
+    "autoprefixer": "^10.4.21",
+    "less": "^4.3.0",
+    "postcss": "^8.5.6",
+    "rollup": "^4.44.1",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-postcss": "^4.0.2",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "@temboplus/frontend-core": "file:../npm.frontend-core",
+    "antd": "^5.26.2",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  }
+}