@temboplus/frontend-core 0.3.0-beta.3 → 0.4.0

package/dist/models/currency/currency.d.ts

@@ -7,20 +7,15 @@
  * These two classes have been intentionally placed in the same file to resolve
  * a circular dependency issue. The original implementation had these in separate files:
  *
- * - Currency class: Defines currency properties and static accessors
+ * - Currency class: Defines currency properties and lookup helpers
  * - CurrencyService class: Loads currency data and provides instance methods
  *
  * The circular dependency occurred because:
- * 1. Currency needed CurrencyService to initialize its static properties
+ * 1. Currency needed CurrencyService for centralized lookups
  * 2. CurrencyService needed Currency to create Currency instances
  *
- * Previous attempts to solve this used setTimeout(0) to defer static initialization,
- * but this created race conditions where static properties weren't immediately available
- * after import (Currency.AFN would be undefined on first access).
- *
  * By combining both classes in a single file:
  * - We ensure proper initialization order
- * - All static properties are immediately available after import
  * - The public API remains unchanged
  *
  * This approach follows the principle that closely related classes with circular
@@ -45,241 +40,6 @@ export declare class Currency {
     private readonly _rounding;
     private readonly _code;
     private readonly _namePlural;
-    static readonly USD: Currency;
-    static readonly CAD: Currency;
-    static readonly EUR: Currency;
-    static readonly AED: Currency;
-    static readonly AFN: Currency;
-    static readonly ALL: Currency;
-    static readonly AMD: Currency;
-    static readonly ARS: Currency;
-    static readonly AUD: Currency;
-    static readonly AZN: Currency;
-    static readonly BAM: Currency;
-    static readonly BDT: Currency;
-    static readonly BGN: Currency;
-    static readonly BHD: Currency;
-    static readonly BIF: Currency;
-    static readonly BND: Currency;
-    static readonly BOB: Currency;
-    static readonly BRL: Currency;
-    static readonly BWP: Currency;
-    static readonly BYN: Currency;
-    static readonly BZD: Currency;
-    static readonly CDF: Currency;
-    static readonly CHF: Currency;
-    static readonly CLP: Currency;
-    static readonly CNY: Currency;
-    static readonly COP: Currency;
-    static readonly CRC: Currency;
-    static readonly CVE: Currency;
-    static readonly CZK: Currency;
-    static readonly DJF: Currency;
-    static readonly DKK: Currency;
-    static readonly DOP: Currency;
-    static readonly DZD: Currency;
-    static readonly EEK: Currency;
-    static readonly EGP: Currency;
-    static readonly ERN: Currency;
-    static readonly ETB: Currency;
-    static readonly GBP: Currency;
-    static readonly GEL: Currency;
-    static readonly GHS: Currency;
-    static readonly GNF: Currency;
-    static readonly GTQ: Currency;
-    static readonly HKD: Currency;
-    static readonly HNL: Currency;
-    static readonly HRK: Currency;
-    static readonly HUF: Currency;
-    static readonly IDR: Currency;
-    static readonly ILS: Currency;
-    static readonly INR: Currency;
-    static readonly IQD: Currency;
-    static readonly IRR: Currency;
-    static readonly ISK: Currency;
-    static readonly JMD: Currency;
-    static readonly JOD: Currency;
-    static readonly JPY: Currency;
-    static readonly KES: Currency;
-    static readonly KHR: Currency;
-    static readonly KMF: Currency;
-    static readonly KRW: Currency;
-    static readonly KWD: Currency;
-    static readonly KZT: Currency;
-    static readonly LBP: Currency;
-    static readonly LKR: Currency;
-    static readonly LTL: Currency;
-    static readonly LVL: Currency;
-    static readonly LYD: Currency;
-    static readonly MAD: Currency;
-    static readonly MDL: Currency;
-    static readonly MGA: Currency;
-    static readonly MKD: Currency;
-    static readonly MMK: Currency;
-    static readonly MOP: Currency;
-    static readonly MUR: Currency;
-    static readonly MXN: Currency;
-    static readonly MYR: Currency;
-    static readonly MZN: Currency;
-    static readonly NAD: Currency;
-    static readonly NGN: Currency;
-    static readonly NIO: Currency;
-    static readonly NOK: Currency;
-    static readonly NPR: Currency;
-    static readonly NZD: Currency;
-    static readonly OMR: Currency;
-    static readonly PAB: Currency;
-    static readonly PEN: Currency;
-    static readonly PHP: Currency;
-    static readonly PKR: Currency;
-    static readonly PLN: Currency;
-    static readonly PYG: Currency;
-    static readonly QAR: Currency;
-    static readonly RON: Currency;
-    static readonly RSD: Currency;
-    static readonly RUB: Currency;
-    static readonly RWF: Currency;
-    static readonly SAR: Currency;
-    static readonly SDG: Currency;
-    static readonly SEK: Currency;
-    static readonly SGD: Currency;
-    static readonly SOS: Currency;
-    static readonly SYP: Currency;
-    static readonly THB: Currency;
-    static readonly TND: Currency;
-    static readonly TOP: Currency;
-    static readonly TRY: Currency;
-    static readonly TTD: Currency;
-    static readonly TWD: Currency;
-    static readonly TZS: Currency;
-    static readonly UAH: Currency;
-    static readonly UGX: Currency;
-    static readonly UYU: Currency;
-    static readonly UZS: Currency;
-    static readonly VEF: Currency;
-    static readonly VND: Currency;
-    static readonly XAF: Currency;
-    static readonly XOF: Currency;
-    static readonly YER: Currency;
-    static readonly ZAR: Currency;
-    static readonly ZMK: Currency;
-    static readonly ZWL: Currency;
-    static readonly ZIMBABWEAN_DOLLAR: Currency;
-    static readonly ZAMBIAN_KWACHA: Currency;
-    static readonly YEMENI_RIAL: Currency;
-    static readonly URUGUAYAN_PESO: Currency;
-    static readonly UZBEKISTAN_SOM: Currency;
-    static readonly VENEZUELAN_BOLIVAR: Currency;
-    static readonly VIETNAMESE_DONG: Currency;
-    static readonly UGANDAN_SHILLING: Currency;
-    static readonly UKRAINIAN_HRYVNIA: Currency;
-    static readonly TANZANIAN_SHILLING: Currency;
-    static readonly TAIWAN_NEW_DOLLAR: Currency;
-    static readonly TRINIDAD_AND_TOBAGO_DOLLAR: Currency;
-    static readonly TURKISH_LIRA: Currency;
-    static readonly TONGAN_PAANGA: Currency;
-    static readonly TUNISIAN_DINAR: Currency;
-    static readonly THAI_BAHT: Currency;
-    static readonly SYRIAN_POUND: Currency;
-    static readonly SOMALI_SHILLING: Currency;
-    static readonly SINGAPORE_DOLLAR: Currency;
-    static readonly SWEDISH_KRONA: Currency;
-    static readonly SUDANESE_POUND: Currency;
-    static readonly SAUDI_RIYAL: Currency;
-    static readonly RWANDAN_FRANC: Currency;
-    static readonly RUSSIAN_RUBLE: Currency;
-    static readonly SERBIAN_DINAR: Currency;
-    static readonly ROMANIAN_LEU: Currency;
-    static readonly QATARI_RIAL: Currency;
-    static readonly PARAGUAYAN_GUARANI: Currency;
-    static readonly POLISH_ZLOTY: Currency;
-    static readonly PAKISTANI_RUPEE: Currency;
-    static readonly PHILIPPINE_PESO: Currency;
-    static readonly PERUVIAN_NUEVO_SOL: Currency;
-    static readonly PANAMANIAN_BALBOA: Currency;
-    static readonly OMANI_RIAL: Currency;
-    static readonly NEW_ZEALAND_DOLLAR: Currency;
-    static readonly NEPALESE_RUPEE: Currency;
-    static readonly NORWEGIAN_KRONE: Currency;
-    static readonly NICARAGUAN_CORDOBA: Currency;
-    static readonly NIGERIAN_NAIRA: Currency;
-    static readonly NAMIBIAN_DOLLAR: Currency;
-    static readonly MOZAMBICAN_METICAL: Currency;
-    static readonly MALAYSIAN_RINGGIT: Currency;
-    static readonly MEXICAN_PESO: Currency;
-    static readonly MAURITIAN_RUPEE: Currency;
-    static readonly MACANESE_PATACA: Currency;
-    static readonly MYANMA_KYAT: Currency;
-    static readonly MACEDONIAN_DENAR: Currency;
-    static readonly MALAGASY_ARIARY: Currency;
-    static readonly MOLDOVAN_LEU: Currency;
-    static readonly MOROCCAN_DIRHAM: Currency;
-    static readonly LIBYAN_DINAR: Currency;
-    static readonly LATVIAN_LATS: Currency;
-    static readonly LITHUANIAN_LITAS: Currency;
-    static readonly SRI_LANKAN_RUPEE: Currency;
-    static readonly LEBANESE_POUND: Currency;
-    static readonly KAZAKHSTANI_TENGE: Currency;
-    static readonly KUWAITI_DINAR: Currency;
-    static readonly SOUTH_KOREAN_WON: Currency;
-    static readonly CAMBODIAN_RIEL: Currency;
-    static readonly KENYAN_SHILLING: Currency;
-    static readonly JORDANIAN_DINAR: Currency;
-    static readonly JAMAICAN_DOLLAR: Currency;
-    static readonly ICELANDIC_KRONA: Currency;
-    static readonly IRANIAN_RIAL: Currency;
-    static readonly IRAQI_DINAR: Currency;
-    static readonly INDIAN_RUPEE: Currency;
-    static readonly ISRAELI_NEW_SHEQEL: Currency;
-    static readonly INDONESIAN_RUPIAH: Currency;
-    static readonly HUNGARIAN_FORINT: Currency;
-    static readonly CROATIAN_KUNA: Currency;
-    static readonly HONDURAN_LEMPIRA: Currency;
-    static readonly HONG_KONG_DOLLAR: Currency;
-    static readonly GUATEMALAN_QUETZAL: Currency;
-    static readonly GUINEAN_FRANC: Currency;
-    static readonly GHANAIAN_CEDI: Currency;
-    static readonly GEORGIAN_LARI: Currency;
-    static readonly BRITISH_POUND_STERLING: Currency;
-    static readonly ETHIOPIAN_BIRR: Currency;
-    static readonly ERITREAN_NAKFA: Currency;
-    static readonly EGYPTIAN_POUND: Currency;
-    static readonly ESTONIAN_KROON: Currency;
-    static readonly ALGERIAN_DINAR: Currency;
-    static readonly DOMINICAN_PESO: Currency;
-    static readonly DANISH_KRONE: Currency;
-    static readonly DJIBOUTIAN_FRANC: Currency;
-    static readonly CZECH_REPUBLIC_KORUNA: Currency;
-    static readonly CAPE_VERDEAN_ESCUDO: Currency;
-    static readonly COSTA_RICAN_COLON: Currency;
-    static readonly COLOMBIAN_PESO: Currency;
-    static readonly CHINESE_YUAN: Currency;
-    static readonly CHILEAN_PESO: Currency;
-    static readonly SWISS_FRANC: Currency;
-    static readonly CONGOLESE_FRANC: Currency;
-    static readonly BELIZE_DOLLAR: Currency;
-    static readonly BELARUSIAN_RUBLE: Currency;
-    static readonly BOTSWANAN_PULA: Currency;
-    static readonly BRAZILIAN_REAL: Currency;
-    static readonly BOLIVIAN_BOLIVIANO: Currency;
-    static readonly BRUNEI_DOLLAR: Currency;
-    static readonly BURUNDIAN_FRANC: Currency;
-    static readonly BAHRAINI_DINAR: Currency;
-    static readonly BULGARIAN_LEV: Currency;
-    static readonly BANGLADESHI_TAKA: Currency;
-    static readonly BOSNIAN_CONVERTIBLE_MARK: Currency;
-    static readonly AZERBAIJANI_MANAT: Currency;
-    static readonly ARGENTINE_PESO: Currency;
-    static readonly ARMENIAN_DRAM: Currency;
-    static readonly ALBANIAN_LEK: Currency;
-    static readonly AFGHAN_AFGHANI: Currency;
-    static readonly UNITED_ARAB_EMIRATES_DIRHAM: Currency;
-    static readonly EURO: Currency;
-    static readonly CANADIAN_DOLLAR: Currency;
-    static readonly US_DOLLAR: Currency;
-    static readonly AUSTRALIAN_DOLLAR: Currency;
-    static readonly CFA_FRANC_BEAC: Currency;
-    static readonly CFA_FRANC_BCEAO: Currency;
     /**
      * Creates a new Currency instance.
      * @param {string} _symbol - The international symbol of the currency
@@ -337,12 +97,6 @@ export declare class Currency {
      * @returns {Currency | undefined} The currency corresponding to the ISO code or `undefined` if not found.
      */
     static fromCode(code: CurrencyCode): Currency | undefined;
-    /**
-     * Retrieves a currency by its name.
-     * @param {string} currencyName The name of the currency.
-     * @returns {Currency | undefined} The currency corresponding to the name or `undefined` if not found.
-     */
-    static fromName(currencyName: string): Currency | undefined;
     /**
      * Returns all available currencies.
      * @returns {Currency[]} Array of all currencies
@@ -355,15 +109,9 @@ export declare class Currency {
      */
     static isValidCode(code?: CurrencyCode | null): boolean;
     /**
-     * Validates if a given currency name is valid
-     * @param currencyName The currency name to validate
-     * @returns True if the currency name is valid
-     */
-    static isValidName(currencyName?: string | null): boolean;
-    /**
-     * Attempts to create a Currency instance from a currency name or ISO code string.
+     * Attempts to create a Currency instance from an ISO code string.
      * The `CurrencyCode` type provides type hints for valid ISO codes but resolves to `string`.
-     * @param input The currency name or ISO code string.
+     * @param input The ISO code string.
      * @returns A Currency instance if valid input, undefined otherwise.
      */
     static from(input: string | CurrencyCode): Currency | undefined;
@@ -402,8 +150,6 @@ export declare class CurrencyService {
     private static instance;
     private currencyList;
     private currencyRecord;
-    private nameRecord;
-    private staticReferences;
     private constructor();
     /**
      * Gets the singleton instance of CurrencyService.
@@ -427,23 +173,12 @@ export declare class CurrencyService {
      * @returns {Record<string, Currency>} Record of currency codes and currency objects
      */
     getAllAsRecord(): Record<string, Currency>;
-    /**
-     * Gets static currency references to be used by the Currency class.
-     * @returns {Map<string, Currency>} Map of static references
-     */
-    getStaticReferences(): Map<string, Currency>;
     /**
      * Retrieves a currency by its ISO code.
      * @param {string} code The ISO code of the currency.
      * @returns {Currency | undefined} The currency corresponding to the ISO code or `undefined` if not found.
      */
     fromCode(code: string): Currency | undefined;
-    /**
-     * Retrieves a currency by its name.
-     * @param {string} currencyName The name of the currency.
-     * @returns {Currency | undefined} The currency corresponding to the name or `undefined` if not found.
-     */
-    fromName(currencyName: string): Currency | undefined;
     /**
      * Validates if a given ISO currency code is valid
      *
@@ -456,17 +191,6 @@ export declare class CurrencyService {
      *   Returns false otherwise.
      */
     isValidCode(code?: string | null): boolean;
-    /**
-     * Validates if a given currency name is valid
-     *
-     * @param {string | null | undefined} currencyName - The currency name to validate.
-     *
-     * @returns {boolean} Returns true if:
-     *   - The currency name is not null/undefined
-     *   - The currency name successfully resolves to a valid Currency instance
-     *   Returns false otherwise.
-     */
-    isValidName(currencyName?: string | null): boolean;
     /**
      * Gets a regex-ready pattern matching all currency symbols
      * Pattern is memoized for performance

package/dist/models/phone-number/mno/mno.types.d.ts

@@ -14,8 +14,7 @@ export declare enum TZMNOId {
  * Values are used in payout channel-code field and should not change.
  */
 export declare enum KEMNOId {
-    SAFARICOM = "SAFARICOM",
-    AIRTEL = "AIRTEL"
+    SAFARICOM = "SAFARICOM"
 }
 /**
  * Union type for all MNO IDs

package/dist/services/index.d.ts

@@ -1,2 +1 @@
-export * from "./config.js";
 export * from "./logger.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/frontend-core",
-  "version": "0.3.0-beta.3",
+  "version": "0.4.0",
   "description": "A JavaScript/TypeScript package providing common utilities and logic shared across front-end TemboPlus projects.",
   "author": "Okello Gerald",
   "license": "MIT",
@@ -14,16 +14,16 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.esm.js",
-      "require": "./dist/index.cjs.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "rollup -c rollup.config.js --configTsconfig tsconfig.build.json",
+    "build": "rollup -c rollup.config.js",
     "prepare": "npm run build",
     "dev": "npm run build -- --watch",
     "test": "vitest"
@@ -37,7 +37,6 @@
   },
   "homepage": "https://github.com/TemboPlus-Frontend/frontend-core-js#readme",
   "dependencies": {
-    "file-saver": "^2.0.5",
     "libphonenumber-js": "^1.12.6",
     "pino": "^9.13.1",
     "tslib": "^2.8.1",
@@ -51,7 +50,6 @@
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
-    "@types/file-saver": "^2.0.7",
     "pino-pretty": "^13.1.1",
     "rollup": "^4.39.0",
     "ts-node": "^10.9.2",

package/dist/reports/index.d.ts

@@ -1 +0,0 @@
-export * from "./report-manager.js";

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

@@ -1,176 +0,0 @@
-/**
- * Available file formats for reports
- */
-export declare enum FileFormat {
-    /** PDF file format */
-    PDF = "pdf",
-    /** Excel file format */
-    EXCEL = "excel"
-}
-/**
- * Available project types
- */
-export declare enum ProjectType {
-    /** Tembo Dashboard project */
-    DASHBOARD = "dashboard",
-    /** Afloat project */
-    AFLOAT = "afloat",
-    /** VertoX project */
-    VERTO_X = "verto_x"
-}
-/**
- * Available report types with improved naming
- */
-export declare enum ReportType {
-    /** Merchant payout statement (Dashboard) */
-    MERCHANT_DISBURSEMENT_REPORT = "merchant_disbursement_report",
-    /** Merchant wallet statement (Dashboard) */
-    MERCHANT_WALLET_STATEMENT = "merchant_wallet_statement",
-    /** Transaction revenue summary (Dashboard) */
-    TRANSACTION_REVENUE_SUMMARY = "transaction_revenue_summary",
-    /** Customer wallet activity (Afloat) */
-    CUSTOMER_WALLET_ACTIVITY = "customer_wallet_activity",
-    /** Customer profile information (Afloat) */
-    CUSTOMER_PROFILE_SNAPSHOT = "customer_profile_snapshot",
-    /** Customer transaction history (Afloat) */
-    CUSTOMER_TRANSACTION_HISTORY = "customer_transaction_history",
-    /** Customer saved beneficiary list (Afloat) */
-    CUSTOMER_SAVED_BENEFICIARY_LIST = "customer_saved_beneficiary_list",
-    /** Gateway transaction log (VertoX) */
-    GATEWAY_TRANSACTION_LOG = "gateway_transaction_log"
-}
-/**
- * Report definition interface
- */
-export interface ReportDefinition {
-    /** Unique identifier for the report */
-    id: string;
-    /** Human-readable report name for UI display */
-    displayName: string;
-    /** API endpoint path for the report */
-    endpoint: string;
-    /** Available file formats for the report */
-    availableFormats: FileFormat[];
-    /** Optional description of the report */
-    description?: string;
-    /** Project the report belongs to */
-    projectType: ProjectType;
-    /** 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
- */
-export declare const REPORTS: {
-    merchant_disbursement_report: ReportDefinition;
-    transaction_revenue_summary: ReportDefinition;
-    merchant_wallet_statement: ReportDefinition;
-    customer_wallet_activity: ReportDefinition;
-    customer_profile_snapshot: ReportDefinition;
-    customer_transaction_history: ReportDefinition;
-    customer_saved_beneficiary_list: ReportDefinition;
-    gateway_transaction_log: ReportDefinition;
-};
-/**
- * Get all reports for a specific project
- * @param projectType The project type to filter by
- * @returns Array of report definitions for the project
- */
-export declare function getReportsByProject(projectType: ProjectType): ReportDefinition[];
-/**
- * Get a report by its type
- * @param reportType The report type to retrieve
- * @returns The report definition or undefined if not found
- */
-export declare function getReportByType(reportType: ReportType): ReportDefinition;
-/**
- * Validates if a report type is available for a project
- * @param projectType The project type
- * @param reportType The report type
- * @returns True if the report is available for the project, false otherwise
- */
-export declare function isReportAvailableForProject(projectType: ProjectType, reportType: ReportType): boolean;
-/**
- * Report Manager class for handling report downloads
- */
-export declare class ReportManager {
-    private static _instance;
-    private constructor();
-    /**
-     * Get the singleton instance of ReportManager
-     */
-    static get instance(): ReportManager;
-    /**
-     * Get the base URL for the report API
-     * @returns The base URL
-     */
-    private getBaseURL;
-    /**
-     * Downloads a report for client-side usage (browser)
-     * @param args Arguments for the report download
-     * @returns Promise that resolves when download is complete
-     */
-    downloadReport(args: {
-        token: string;
-        projectType: ProjectType;
-        reportType: ReportType;
-        fileFormat: FileFormat;
-        query?: Record<string, any>;
-    }): Promise<void>;
-    /**
-     * 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 getFilename;
-    /**
-     * Handle error responses from the API
-     * @param response The response from the API
-     * @throws Error with appropriate message
-     */
-    private handleErrorResponse;
-    /**
-     * Generates a default filename based on report and file format
-     * @param report The report definition
-     * @param fileFormat The requested file format
-     * @returns A suitable default filename with proper extension
-     */
-    private getDefaultFilename;
-    /**
-     * Extracts the filename from the Content-Disposition header
-     * @param contentDisposition The Content-Disposition header value
-     * @returns The extracted filename or null if not found
-     */
-    private extractFilenameFromContentDisposition;
-    /**
-     * Converts a base64 string to a Blob
-     * @param base64 The base64 string
-     * @returns A Blob
-     */
-    private b64toBlob;
-}

package/dist/services/config.d.ts

@@ -1,12 +0,0 @@
-export interface AppConfig {
-    pdfMakerBaseUrl: string;
-}
-export declare class ConfigService {
-    private static _instance;
-    private _config;
-    private constructor();
-    static get instance(): ConfigService;
-    initialize(config: AppConfig): void;
-    get pdfMakerBaseUrl(): string;
-}
-export declare const configService: ConfigService;