@temboplus/frontend-core 0.2.11 → 0.2.13

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

@@ -726,6 +726,27 @@ declare class Amount {
      * @returns True if the amount data is available and valid
      */
     validate(): boolean;
+    /**
+     * Gets payout constraints (min/max amounts) for a specific currency
+     *
+     * Returns Amount objects that can be directly compared and formatted,
+     * providing type safety and automatic currency context.
+     *
+     * @param currency - The currency code to get constraints for
+     * @returns Object with min and max Amount objects, or undefined if currency not supported
+     *
+     * @example
+     * ```typescript
+     * const constraints = Amount.getTransactionLimits('TZS');
+     * if (constraints && myAmount.lessThan(constraints.min)) {
+     *   throw new Error(`Minimum amount is ${constraints.min.label}`);
+     * }
+     * ```
+     */
+    static getTransactionLimits(currency: CurrencyCode): {
+        min: Amount;
+        max: Amount;
+    } | undefined;
 }
 /**
  * Export the Amount class and regex pattern

package/dist/reports/report-manager.d.ts

@@ -52,6 +52,17 @@ export interface ReportDefinition {
     /** Type of the report */
     reportType: ReportType;
 }
+/**
+ * Return type for server-side report downloads
+ */
+export interface ReportDownloadResult {
+    /** The filename for the downloaded report */
+    filename: string;
+    /** The raw base64 data from the response */
+    data: string;
+    /** The report definition used */
+    report: ReportDefinition;
+}
 /**
  * Registry of all available reports
  */
@@ -97,7 +108,7 @@ export declare class ReportManager {
      */
     private getBaseURL;
     /**
-     * Downloads a report based on project type and report type
+     * Downloads a report for client-side usage (browser)
      * @param args Arguments for the report download
      * @returns Promise that resolves when download is complete
      */
@@ -109,12 +120,25 @@ export declare class ReportManager {
         query?: Record<string, any>;
     }): Promise<void>;
     /**
-     * Process the download
+     * Fetches a report for server-side usage or when you want to handle saving separately
+     * @param args Arguments for the report fetch
+     * @returns Promise that resolves with the report data and filename
+     */
+    fetchReport(args: {
+        token: string;
+        projectType: ProjectType;
+        reportType: ReportType;
+        fileFormat: FileFormat;
+        query?: Record<string, any>;
+    }): Promise<ReportDownloadResult>;
+    /**
+     * Get the filename from response or generate a default one
      * @param response The response from the API
      * @param report The report definition
      * @param fileFormat The requested file format
+     * @returns The filename to use
      */
-    private processDownload;
+    private getFilename;
     /**
      * Handle error responses from the API
      * @param response The response from the API

package/dist/utils/text.d.ts

@@ -29,11 +29,75 @@ declare function abbreviateName(fullName: string): string;
  * @returns {string} - The initials in uppercase format.
  */
 declare function getInitialsFrom(fullName: string): string;
+/**
+ * Validates a personal name (account holder name, wallet owner name, etc.)
+ * Used across bank accounts and MNO wallets for consistent validation.
+ *
+ * @param {string} name - The name to validate
+ * @returns {boolean} True if the name meets all validation criteria, false otherwise
+ *
+ * @example
+ * // Returns true
+ * validatePersonalName("John Smith");
+ *
+ * @example
+ * // Returns false (too short)
+ * validatePersonalName("Jo");
+ *
+ * @example
+ * // Returns false (invalid characters)
+ * validatePersonalName("User123");
+ */
+declare function validatePersonalName(name: string): boolean;
+/**
+ * Validates a business name (company, organization, etc.)
+ * More lenient than personal name validation.
+ *
+ * @param {string} name - The business name to validate
+ * @returns {boolean} True if the name meets business name criteria, false otherwise
+ *
+ * @example
+ * // Returns true
+ * validateBusinessName("ABC Corporation Ltd");
+ *
+ * @example
+ * // Returns true
+ * validateBusinessName("Smith & Sons Inc.");
+ *
+ * @example
+ * // Returns true
+ * validateBusinessName("M-Pesa");
+ */
+declare function validateBusinessName(name: string): boolean;
+/**
+ * Validates any name (personal or business) with automatic detection.
+ * First tries to detect if it's a business name, then validates accordingly.
+ * If detection fails, tries both validation methods.
+ *
+ * @param {string} name - The name to validate (personal or business)
+ * @returns {boolean} True if the name is valid as either personal or business name
+ *
+ * @example
+ * // Returns true (personal name)
+ * validateName("John Smith");
+ *
+ * @example
+ * // Returns true (business name)
+ * validateName("CRDB Bank PLC");
+ *
+ * @example
+ * // Returns true (could be either)
+ * validateName("Smith Solutions");
+ */
+declare function validateName(name: string): boolean;
 export declare const TextUtils: {
     capitalizeFirstLetter: typeof capitalizeFirstLetter;
     getFullName: typeof getFullName;
     generateSlug: typeof generateSlug;
     abbreviateName: typeof abbreviateName;
     getInitialsFrom: typeof getInitialsFrom;
+    validatePersonalName: typeof validatePersonalName;
+    validateBusinessName: typeof validateBusinessName;
+    validateName: typeof validateName;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/frontend-core",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "A JavaScript/TypeScript package providing common utilities and logic shared across front-end TemboPlus projects.",
   "author": "Okello Gerald",
   "license": "MIT",
@@ -67,4 +67,4 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"
   }
-}
+}