@temboplus/frontend-core 0.2.14 → 0.2.16

package/dist/models/amount/amount.d.ts

@@ -2,19 +2,33 @@ import { CurrencyCode } from "../../models/currency";
 /**
  * Regular expression for validating amount strings
  * Supports both positive and negative amounts with optional comma separators and decimals
+ */
+declare const AMOUNT_REGEX: RegExp;
+/**
+ * Represents a monetary amount with currency information
  *
- * Pattern breakdown:
- * - ^-? : Optional minus sign at the start (for negative amounts)
- * - (?:\d{1,3}(?:,\d{3})*|\d+) : Either:
- *   - \d{1,3}(?:,\d{3})* : 1-3 digits followed by groups of comma + 3 digits (e.g., "1,234,567")
- *   - |\d+ : OR just any sequence of digits (e.g., "1234567")
- * - (?:\.\d+)? : Optional decimal part with any number of digits
- * - $ : End of string
+ * Enhanced with currency-amount parsing support:
+ * - Supports formats like "TZS1000", "1000TZS", "TZS1,000.00", "1,000.00TZS"
+ * - Case-insensitive currency codes
+ * - US/UK format (comma for thousands, period for decimal)
+ * - Automatic whitespace removal
+ * - Clear error messages for invalid formats
  *
- * Valid examples: "123", "-456", "1,234", "-1,234.56", "0", "-0.50"
- * Invalid examples: "12.34.56", "1,23", "-", "abc", "1,,234"
+ * @example
+ * ```typescript
+ * // Currency-amount combinations
+ * Amount.from('TZS10000');           // TSh 10,000.00
+ * Amount.from('TZS 10,000');         // TSh 10,000.00 (spaces removed)
+ * Amount.from('10000TZS');           // TSh 10,000.00
+ * Amount.from('TZS1,234.56');        // TSh 1,234.56
+ * Amount.from('-TZS1000');           // -TSh 1,000.00
+ * Amount.from('TZS-1000');           // -TSh 1,000.00
+ *
+ * // Traditional usage still works
+ * Amount.from(1000, 'TZS');          // TSh 1,000.00
+ * Amount.from('1000', 'USD');        // $1,000.00
+ * ```
  */
-declare const AMOUNT_REGEX: RegExp;
 /**
  * JSON representation interface for Amount serialization
  */
@@ -101,27 +115,42 @@ declare class Amount {
      */
     private constructor();
     /**
-     * Creates an Amount instance from a string or number input
+     * Creates an Amount instance from string or number input
      *
-     * Supports various input formats:
-     * - Numbers: 1000, -500, 0, 123.45, -67.89
-     * - Strings: "1000", "-500", "1,234", "-1,234.56"
-     * - Currency symbols are automatically removed from strings
+     * Supports currency-amount combinations like:
+     * - "TZS10000", "10000TZS" (no space)
+     * - "TZS 10,000", "10,000 TZS" (with spaces - automatically cleaned)
+     * - "-TZS1000", "TZS-1000", "-1000TZS" (negative amounts)
+     * - Case-insensitive: "tzs10000", "TZS10000", "Tzs10000"
      *
-     * @param input - The input value (string or number, positive or negative)
-     * @param currencyCode - The currency code (defaults to TZS)
-     * @returns Amount instance or undefined if validation fails
-     *
-     * @example
-     * ```typescript
-     * Amount.from(1000);           // Valid: TSh 1,000.00
-     * Amount.from(-500, 'USD');    // Valid: -$500.00
-     * Amount.from('-1,234.56');    // Valid: -TSh 1,234.56
-     * Amount.from('abc');          // Invalid: returns undefined
-     * Amount.from('');             // Invalid: returns undefined
-     * ```
+     * @param input - String with currency-amount or number
+     * @param currencyCode - Currency code (optional if detected from string)
+     * @returns Amount instance or undefined if invalid
+     * @throws Error with clear message if format is invalid
      */
     static from(input: string | number, currencyCode?: CurrencyCode | null): Amount | undefined;
+    /**
+     * Parse currency-amount combination from cleaned string
+     * @param cleaned - String with whitespace already removed
+     * @returns Object with currency code and amount string
+     */
+    private static parseCurrencyAmount;
+    /**
+     * Validate and normalize currency code
+     * @param code - Currency code string (e.g., "TZS", "tzs")
+     * @returns Normalized currency code or undefined if invalid
+     */
+    private static validateCurrencyCode;
+    /**
+     * Create Amount from numeric value
+     */
+    private static fromNumericValue;
+    /**
+     * Create Amount from parsed currency and amount values
+     * @param amountStr - Numeric amount string (may include commas, decimal, minus)
+     * @param currencyCode - Validated currency code
+     */
+    private static fromParsedValues;
     /**
      * Returns the currency code
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/frontend-core",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "A JavaScript/TypeScript package providing common utilities and logic shared across front-end TemboPlus projects.",
   "author": "Okello Gerald",
   "license": "MIT",