@temboplus/frontend-core 0.2.2 → 0.2.3

package/README.md

@@ -8,6 +8,8 @@ The library contains:
 
 * **Utilities**: Ready-to-use helper functions for common development tasks
 * **Data Models**: Standardized structures for handling data like phone numbers, amounts, currencies, countries, and bank details
+* **Report Management**: Tools for generating and downloading reports across different projects
+* **Configuration Service**: Centralized configuration management for application settings
 
 ## Key Data Models
 
@@ -18,6 +20,66 @@ The library contains:
 - **Country**: Standardized country data with ISO codes and validation
 - **Bank**: Standardized bank account information management
 
+## Report Management
+
+The library includes a `ReportManager` for downloading reports in different formats across various TemboPlus projects:
+
+```typescript
+import { 
+  ReportManager, 
+  FileFormat, 
+  ReportType, 
+  ProjectType 
+} from '@temboplus/frontend-core';
+
+// Download a report
+await ReportManager.instance.downloadReport({
+  token: "your-auth-token",
+  projectType: ProjectType.DASHBOARD,
+  reportType: ReportType.MERCHANT_DISBURSEMENT_REPORT,
+  fileFormat: FileFormat.PDF,
+  query: {
+    startDate: "2023-01-01T00:00:00.000Z",
+    endDate: "2023-01-31T00:00:00.000Z"
+  }
+});
+
+// Get all reports for a specific project
+import { getReportsByProject } from '@temboplus/frontend-core';
+const dashboardReports = getReportsByProject(ProjectType.DASHBOARD);
+```
+
+### Available Report Types
+
+The library supports the following report types:
+
+- **Dashboard Reports**:
+  - `MERCHANT_DISBURSEMENT_REPORT`: Detailed breakdown of payments made to merchants
+  - `TRANSACTION_REVENUE_SUMMARY`: Summary of all revenue transactions by period
+  
+- **Afloat Reports**:
+  - `CUSTOMER_WALLET_ACTIVITY`: Detailed record of all customer wallet transactions
+  - `CUSTOMER_PROFILE_SNAPSHOT`: Current account information and status
+  
+- **VertoX Reports**:
+  - `GATEWAY_TRANSACTION_LOG`: Log of all payment gateway API transactions
+
+## Configuration Service
+
+The library provides a centralized configuration service for managing application settings:
+
+```typescript
+import { ConfigService } from '@temboplus/frontend-core';
+
+// Initialize configuration at application startup
+ConfigService.instance.initialize({
+  pdfMakerBaseUrl: 'https://api.temboplus.com/pdf-maker'
+});
+
+// Access configuration values throughout your application
+const baseUrl = ConfigService.instance.pdfMakerBaseUrl;
+```
+
 ## Working with Data Models
 
 Each data model in our library comes with three key validation methods:

package/esm/mod.d.ts

@@ -1,3 +1,5 @@
 export * from "./src/models/index.js";
 export * from "./src/utils/index.js";
+export * from "./src/reports/index.js";
+export * from "./src/config/index.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/esm/mod.js

@@ -1,2 +1,4 @@
 export * from "./src/models/index.js";
 export * from "./src/utils/index.js";
+export * from "./src/reports/index.js";
+export * from "./src/config/index.js";

package/esm/src/config/config_service.d.ts

@@ -0,0 +1,11 @@
+export declare class ConfigService {
+    private static _instance;
+    private _pdfMakerBaseUrl;
+    private constructor();
+    static get instance(): ConfigService;
+    initialize(config: {
+        pdfMakerBaseUrl: string;
+    }): void;
+    get pdfMakerBaseUrl(): string;
+}
+//# sourceMappingURL=config_service.d.ts.map

package/esm/src/config/config_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_service.d.ts","sourceRoot":"","sources":["../../../src/src/config/config_service.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgB;IACxC,OAAO,CAAC,gBAAgB,CAAc;IAEtC,OAAO;IAEP,WAAkB,QAAQ,kBAEzB;IAEM,UAAU,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE;IAIrD,IAAW,eAAe,IAAI,MAAM,CAEnC;CACF"}

package/esm/src/config/config_service.js

@@ -0,0 +1,19 @@
+export class ConfigService {
+    constructor() {
+        Object.defineProperty(this, "_pdfMakerBaseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ""
+        });
+    }
+    static get instance() {
+        return this._instance || (this._instance = new this());
+    }
+    initialize(config) {
+        this._pdfMakerBaseUrl = config.pdfMakerBaseUrl;
+    }
+    get pdfMakerBaseUrl() {
+        return this._pdfMakerBaseUrl;
+    }
+}

package/esm/src/config/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./config_service.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/esm/src/config/index.js

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

package/esm/src/reports/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./report_manager.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/reports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/reports/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/esm/src/reports/index.js

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

package/esm/src/reports/report_manager.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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",
+    /** 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",
+    /** 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;
+}
+/**
+ * Registry of all available reports
+ */
+export declare const REPORTS: {
+    merchant_disbursement_report: ReportDefinition;
+    transaction_revenue_summary: ReportDefinition;
+    customer_wallet_activity: ReportDefinition;
+    customer_profile_snapshot: 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 based on project type and report type
+     * @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>;
+    /**
+     * Process the download
+     * @param response The response from the API
+     * @param report The report definition
+     * @param fileFormat The requested file format
+     */
+    private processDownload;
+    /**
+     * 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;
+}
+//# sourceMappingURL=report_manager.d.ts.map

package/esm/src/reports/report_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report_manager.d.ts","sourceRoot":"","sources":["../../../src/src/reports/report_manager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,oBAAY,UAAU;IACpB,sBAAsB;IACtB,GAAG,QAAQ;IACX,wBAAwB;IACxB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,8BAA8B;IAC9B,SAAS,cAAc;IACvB,qBAAqB;IACrB,MAAM,WAAW;IACjB,qBAAqB;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,4CAA4C;IAC5C,4BAA4B,iCAAiC;IAC7D,8CAA8C;IAC9C,2BAA2B,gCAAgC;IAC3D,wCAAwC;IACxC,wBAAwB,6BAA6B;IACrD,4CAA4C;IAC5C,yBAAyB,8BAA8B;IACvD,uCAAuC;IACvC,uBAAuB,4BAA4B;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,gBAAgB,EAAE,UAAU,EAAE,CAAC;IAC/B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;kCAUb,gBAAgB;iCAUhB,gBAAgB;8BAWhB,gBAAgB;+BAUhB,gBAAgB;6BAWhB,gBAAgB;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GACvB,gBAAgB,EAAE,CAIpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,OAAO,CAGT;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgB;IAExC,OAAO;IAEP;;OAEG;IACH,WAAkB,QAAQ,kBAEzB;IAED;;;OAGG;IACH,OAAO,CAAC,UAAU,CAIhB;IAEF;;;;OAIG;IACU,cAAc,CAAC,IAAI,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,WAAW,CAAC;QACzB,UAAU,EAAE,UAAU,CAAC;QACvB,UAAU,EAAE,UAAU,CAAC;QAEvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC7B,GAAG,OAAO,CAAC,IAAI,CAAC;IAmFjB;;;;;OAKG;YACW,eAAe;IAqB7B;;;;OAIG;YACW,mBAAmB;IAwBjC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;OAIG;IACH,OAAO,CAAC,qCAAqC;IA6B7C;;;;OAIG;IACH,OAAO,CAAC,SAAS,CACyB;CAC3C"}

package/esm/src/reports/report_manager.js

@@ -0,0 +1,315 @@
+import FileSaver from "file-saver";
+import { ConfigService } from "../config/index.js";
+/**
+ * Available file formats for reports
+ */
+export var FileFormat;
+(function (FileFormat) {
+    /** PDF file format */
+    FileFormat["PDF"] = "pdf";
+    /** Excel file format */
+    FileFormat["EXCEL"] = "excel";
+})(FileFormat || (FileFormat = {}));
+/**
+ * Available project types
+ */
+export var ProjectType;
+(function (ProjectType) {
+    /** Tembo Dashboard project */
+    ProjectType["DASHBOARD"] = "dashboard";
+    /** Afloat project */
+    ProjectType["AFLOAT"] = "afloat";
+    /** VertoX project */
+    ProjectType["VERTO_X"] = "verto_x";
+})(ProjectType || (ProjectType = {}));
+/**
+ * Available report types with improved naming
+ */
+export var ReportType;
+(function (ReportType) {
+    /** Merchant payout statement (Dashboard) */
+    ReportType["MERCHANT_DISBURSEMENT_REPORT"] = "merchant_disbursement_report";
+    /** Transaction revenue summary (Dashboard) */
+    ReportType["TRANSACTION_REVENUE_SUMMARY"] = "transaction_revenue_summary";
+    /** Customer wallet activity (Afloat) */
+    ReportType["CUSTOMER_WALLET_ACTIVITY"] = "customer_wallet_activity";
+    /** Customer profile information (Afloat) */
+    ReportType["CUSTOMER_PROFILE_SNAPSHOT"] = "customer_profile_snapshot";
+    /** Gateway transaction log (VertoX) */
+    ReportType["GATEWAY_TRANSACTION_LOG"] = "gateway_transaction_log";
+})(ReportType || (ReportType = {}));
+/**
+ * Registry of all available reports
+ */
+export const REPORTS = {
+    // Dashboard Reports
+    [ReportType.MERCHANT_DISBURSEMENT_REPORT]: {
+        id: "merchant_disbursement_report",
+        displayName: "Merchant Disbursement Report",
+        endpoint: "/dashboard/merchant_disbursements",
+        availableFormats: [FileFormat.PDF, FileFormat.EXCEL],
+        projectType: ProjectType.DASHBOARD,
+        reportType: ReportType.MERCHANT_DISBURSEMENT_REPORT,
+        description: "Detailed breakdown of payments made to merchants",
+    },
+    [ReportType.TRANSACTION_REVENUE_SUMMARY]: {
+        id: "transaction_revenue_summary",
+        displayName: "Transaction Revenue Summary",
+        endpoint: "/dashboard/revenue_summary",
+        availableFormats: [FileFormat.PDF, FileFormat.EXCEL],
+        projectType: ProjectType.DASHBOARD,
+        reportType: ReportType.TRANSACTION_REVENUE_SUMMARY,
+        description: "Summary of all revenue transactions by period",
+    },
+    // Afloat Reports
+    [ReportType.CUSTOMER_WALLET_ACTIVITY]: {
+        id: "customer_wallet_activity",
+        displayName: "Customer Wallet Activity",
+        endpoint: "/afloat/wallet_activity",
+        availableFormats: [FileFormat.PDF, FileFormat.EXCEL],
+        projectType: ProjectType.AFLOAT,
+        reportType: ReportType.CUSTOMER_WALLET_ACTIVITY,
+        description: "Detailed record of all customer wallet transactions",
+    },
+    [ReportType.CUSTOMER_PROFILE_SNAPSHOT]: {
+        id: "customer_profile_snapshot",
+        displayName: "Customer Profile Snapshot",
+        endpoint: "/afloat/profile_snapshot",
+        availableFormats: [FileFormat.PDF],
+        projectType: ProjectType.AFLOAT,
+        reportType: ReportType.CUSTOMER_PROFILE_SNAPSHOT,
+        description: "Current account information and status",
+    },
+    // VertoX Reports
+    [ReportType.GATEWAY_TRANSACTION_LOG]: {
+        id: "gateway_transaction_log",
+        displayName: "Gateway Transaction Log",
+        endpoint: "/vertox/gateway_transactions",
+        availableFormats: [FileFormat.EXCEL],
+        projectType: ProjectType.VERTO_X,
+        reportType: ReportType.GATEWAY_TRANSACTION_LOG,
+        description: "Log of all payment gateway API transactions",
+    },
+};
+/**
+ * Get all reports for a specific project
+ * @param projectType The project type to filter by
+ * @returns Array of report definitions for the project
+ */
+export function getReportsByProject(projectType) {
+    return Object.values(REPORTS).filter((report) => report.projectType === projectType);
+}
+/**
+ * Get a report by its type
+ * @param reportType The report type to retrieve
+ * @returns The report definition or undefined if not found
+ */
+export function getReportByType(reportType) {
+    return REPORTS[reportType];
+}
+/**
+ * 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 function isReportAvailableForProject(projectType, reportType) {
+    const report = REPORTS[reportType];
+    return report !== undefined && report.projectType === projectType;
+}
+/**
+ * Report Manager class for handling report downloads
+ */
+export class ReportManager {
+    constructor() {
+        /**
+         * Get the base URL for the report API
+         * @returns The base URL
+         */
+        Object.defineProperty(this, "getBaseURL", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                const url = ConfigService.instance.pdfMakerBaseUrl;
+                if (url.endsWith("/"))
+                    return url.slice(0, -1);
+                return url;
+            }
+        });
+        /**
+         * Converts a base64 string to a Blob
+         * @param base64 The base64 string
+         * @returns A Blob
+         */
+        Object.defineProperty(this, "b64toBlob", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (base64) => fetch(base64).then((res) => res.blob())
+        });
+    }
+    /**
+     * Get the singleton instance of ReportManager
+     */
+    static get instance() {
+        return this._instance || (this._instance = new this());
+    }
+    /**
+     * Downloads a report based on project type and report type
+     * @param args Arguments for the report download
+     * @returns Promise that resolves when download is complete
+     */
+    async downloadReport(args) {
+        try {
+            // Get the report from the registry
+            const report = REPORTS[args.reportType];
+            if (!report) {
+                throw new Error(`Report type ${args.reportType} not configured`);
+            }
+            // Validate that the report belongs to the specified project
+            if (report.projectType !== args.projectType) {
+                throw new Error(`Report type ${args.reportType} does not belong to project ${args.projectType}`);
+            }
+            // Check if requested format is supported
+            if (!report.availableFormats.includes(args.fileFormat)) {
+                throw new Error(`File format ${args.fileFormat} not supported for ${report.displayName}`);
+            }
+            // Build URL using the report's endpoint
+            let url = `${this.getBaseURL()}${report.endpoint}`;
+            // Create a properly typed query parameters object
+            // deno-lint-ignore no-explicit-any
+            const queryParams = {
+                ...(args.query || {}),
+                format: args.fileFormat,
+            };
+            // Build the query string
+            const searchParams = new URLSearchParams();
+            for (const key in queryParams) {
+                if (Object.prototype.hasOwnProperty.call(queryParams, key)) {
+                    const value = queryParams[key];
+                    if (value !== undefined && value !== null) {
+                        if (Array.isArray(value)) {
+                            value.forEach((item) => {
+                                searchParams.append(key + "[]", String(item));
+                            });
+                        }
+                        else {
+                            searchParams.append(key, String(value));
+                        }
+                    }
+                }
+            }
+            const queryString = searchParams.toString();
+            if (queryString) {
+                url += `?${queryString}`;
+            }
+            // Make the request
+            const response = await fetch(url, {
+                method: "GET",
+                headers: {
+                    "Accept": "*/*",
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${args.token}`,
+                },
+            });
+            if (response.status !== 200) {
+                await this.handleErrorResponse(response);
+            }
+            // Process the download
+            await this.processDownload(response, report, args.fileFormat);
+        }
+        catch (error) {
+            console.error("Report download failed:", error);
+            throw error;
+        }
+    }
+    /**
+     * Process the download
+     * @param response The response from the API
+     * @param report The report definition
+     * @param fileFormat The requested file format
+     */
+    async processDownload(response, report, fileFormat) {
+        const contentDisposition = response.headers.get("Content-Disposition");
+        // Get default filename based on report and file format
+        const defaultFilename = this.getDefaultFilename(report, fileFormat);
+        // Try to get filename from Content-Disposition, fall back to default
+        const fileName = this.extractFilenameFromContentDisposition(contentDisposition) ||
+            defaultFilename;
+        // Handle the response based on content type
+        // deno-lint-ignore no-explicit-any
+        const blob = await this.b64toBlob(await response.text());
+        FileSaver.saveAs(blob, fileName);
+    }
+    /**
+     * Handle error responses from the API
+     * @param response The response from the API
+     * @throws Error with appropriate message
+     */
+    async handleErrorResponse(response) {
+        let errorMessage = "Encountered an error while generating report";
+        try {
+            // Try to parse as JSON first
+            const contentType = response.headers.get("Content-Type");
+            if (contentType && contentType.includes("application/json")) {
+                const errorData = await response.json();
+                errorMessage = errorData.message || errorData.error ||
+                    errorMessage;
+            }
+            else {
+                // Try to get error as text
+                const textError = await response.text();
+                if (textError) {
+                    errorMessage = textError;
+                }
+            }
+        }
+        catch (parseError) {
+            console.error("Error parsing error response:", parseError);
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * 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
+     */
+    getDefaultFilename(report, fileFormat) {
+        const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD format
+        // Build the filename with project, report type, and date
+        const baseFilename = `${report.id}_${date}`;
+        // Add the extension based on the file format
+        return fileFormat === FileFormat.PDF
+            ? `${baseFilename}.pdf`
+            : `${baseFilename}.xlsx`;
+    }
+    /**
+     * Extracts the filename from the Content-Disposition header
+     * @param contentDisposition The Content-Disposition header value
+     * @returns The extracted filename or null if not found
+     */
+    extractFilenameFromContentDisposition(contentDisposition) {
+        // Check if the header exists
+        if (!contentDisposition) {
+            return null;
+        }
+        // Try to match the filename pattern
+        const filenameRegex = /filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/;
+        const matches = filenameRegex.exec(contentDisposition);
+        if (matches && matches[1]) {
+            // Clean up the filename by removing quotes if present
+            let filename = matches[1].trim();
+            // Remove surrounding quotes if they exist
+            if (filename.startsWith('"') && filename.endsWith('"')) {
+                filename = filename.substring(1, filename.length - 1);
+            }
+            else if (filename.startsWith("'") && filename.endsWith("'")) {
+                filename = filename.substring(1, filename.length - 1);
+            }
+            return filename;
+        }
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/frontend-core",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "A JavaScript/TypeScript package providing common utilities and logic shared across front-end TemboPlus projects.",
   "repository": {
     "type": "git",
@@ -24,6 +24,7 @@
   "private": false,
   "dependencies": {
     "antd": "^5.24.2",
+    "file-saver": "^2.0.5",
     "uuid": "^11.1.0"
   },
   "devDependencies": {

package/script/mod.d.ts

@@ -1,3 +1,5 @@
 export * from "./src/models/index.js";
 export * from "./src/utils/index.js";
+export * from "./src/reports/index.js";
+export * from "./src/config/index.js";
 //# sourceMappingURL=mod.d.ts.map

package/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/script/mod.js

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./src/models/index.js"), exports);
 __exportStar(require("./src/utils/index.js"), exports);
+__exportStar(require("./src/reports/index.js"), exports);
+__exportStar(require("./src/config/index.js"), exports);

package/script/src/config/config_service.d.ts

@@ -0,0 +1,11 @@
+export declare class ConfigService {
+    private static _instance;
+    private _pdfMakerBaseUrl;
+    private constructor();
+    static get instance(): ConfigService;
+    initialize(config: {
+        pdfMakerBaseUrl: string;
+    }): void;
+    get pdfMakerBaseUrl(): string;
+}
+//# sourceMappingURL=config_service.d.ts.map

package/script/src/config/config_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_service.d.ts","sourceRoot":"","sources":["../../../src/src/config/config_service.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgB;IACxC,OAAO,CAAC,gBAAgB,CAAc;IAEtC,OAAO;IAEP,WAAkB,QAAQ,kBAEzB;IAEM,UAAU,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE;IAIrD,IAAW,eAAe,IAAI,MAAM,CAEnC;CACF"}

package/script/src/config/config_service.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = void 0;
+class ConfigService {
+    constructor() {
+        Object.defineProperty(this, "_pdfMakerBaseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ""
+        });
+    }
+    static get instance() {
+        return this._instance || (this._instance = new this());
+    }
+    initialize(config) {
+        this._pdfMakerBaseUrl = config.pdfMakerBaseUrl;
+    }
+    get pdfMakerBaseUrl() {
+        return this._pdfMakerBaseUrl;
+    }
+}
+exports.ConfigService = ConfigService;

package/script/src/config/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./config_service.js";
+//# sourceMappingURL=index.d.ts.map

package/script/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/script/src/config/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config_service.js"), exports);

package/script/src/reports/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./report_manager.js";
+//# sourceMappingURL=index.d.ts.map

package/script/src/reports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/reports/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}

package/script/src/reports/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./report_manager.js"), exports);

package/script/src/reports/report_manager.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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",
+    /** 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",
+    /** 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;
+}
+/**
+ * Registry of all available reports
+ */
+export declare const REPORTS: {
+    merchant_disbursement_report: ReportDefinition;
+    transaction_revenue_summary: ReportDefinition;
+    customer_wallet_activity: ReportDefinition;
+    customer_profile_snapshot: 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 based on project type and report type
+     * @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>;
+    /**
+     * Process the download
+     * @param response The response from the API
+     * @param report The report definition
+     * @param fileFormat The requested file format
+     */
+    private processDownload;
+    /**
+     * 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;
+}
+//# sourceMappingURL=report_manager.d.ts.map

package/script/src/reports/report_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report_manager.d.ts","sourceRoot":"","sources":["../../../src/src/reports/report_manager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,oBAAY,UAAU;IACpB,sBAAsB;IACtB,GAAG,QAAQ;IACX,wBAAwB;IACxB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,8BAA8B;IAC9B,SAAS,cAAc;IACvB,qBAAqB;IACrB,MAAM,WAAW;IACjB,qBAAqB;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,4CAA4C;IAC5C,4BAA4B,iCAAiC;IAC7D,8CAA8C;IAC9C,2BAA2B,gCAAgC;IAC3D,wCAAwC;IACxC,wBAAwB,6BAA6B;IACrD,4CAA4C;IAC5C,yBAAyB,8BAA8B;IACvD,uCAAuC;IACvC,uBAAuB,4BAA4B;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,gBAAgB,EAAE,UAAU,EAAE,CAAC;IAC/B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;kCAUb,gBAAgB;iCAUhB,gBAAgB;8BAWhB,gBAAgB;+BAUhB,gBAAgB;6BAWhB,gBAAgB;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GACvB,gBAAgB,EAAE,CAIpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,OAAO,CAGT;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgB;IAExC,OAAO;IAEP;;OAEG;IACH,WAAkB,QAAQ,kBAEzB;IAED;;;OAGG;IACH,OAAO,CAAC,UAAU,CAIhB;IAEF;;;;OAIG;IACU,cAAc,CAAC,IAAI,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,WAAW,CAAC;QACzB,UAAU,EAAE,UAAU,CAAC;QACvB,UAAU,EAAE,UAAU,CAAC;QAEvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC7B,GAAG,OAAO,CAAC,IAAI,CAAC;IAmFjB;;;;;OAKG;YACW,eAAe;IAqB7B;;;;OAIG;YACW,mBAAmB;IAwBjC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;OAIG;IACH,OAAO,CAAC,qCAAqC;IA6B7C;;;;OAIG;IACH,OAAO,CAAC,SAAS,CACyB;CAC3C"}

package/script/src/reports/report_manager.js

@@ -0,0 +1,325 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportManager = exports.REPORTS = exports.ReportType = exports.ProjectType = exports.FileFormat = void 0;
+exports.getReportsByProject = getReportsByProject;
+exports.getReportByType = getReportByType;
+exports.isReportAvailableForProject = isReportAvailableForProject;
+const file_saver_1 = __importDefault(require("file-saver"));
+const index_js_1 = require("../config/index.js");
+/**
+ * Available file formats for reports
+ */
+var FileFormat;
+(function (FileFormat) {
+    /** PDF file format */
+    FileFormat["PDF"] = "pdf";
+    /** Excel file format */
+    FileFormat["EXCEL"] = "excel";
+})(FileFormat || (exports.FileFormat = FileFormat = {}));
+/**
+ * Available project types
+ */
+var ProjectType;
+(function (ProjectType) {
+    /** Tembo Dashboard project */
+    ProjectType["DASHBOARD"] = "dashboard";
+    /** Afloat project */
+    ProjectType["AFLOAT"] = "afloat";
+    /** VertoX project */
+    ProjectType["VERTO_X"] = "verto_x";
+})(ProjectType || (exports.ProjectType = ProjectType = {}));
+/**
+ * Available report types with improved naming
+ */
+var ReportType;
+(function (ReportType) {
+    /** Merchant payout statement (Dashboard) */
+    ReportType["MERCHANT_DISBURSEMENT_REPORT"] = "merchant_disbursement_report";
+    /** Transaction revenue summary (Dashboard) */
+    ReportType["TRANSACTION_REVENUE_SUMMARY"] = "transaction_revenue_summary";
+    /** Customer wallet activity (Afloat) */
+    ReportType["CUSTOMER_WALLET_ACTIVITY"] = "customer_wallet_activity";
+    /** Customer profile information (Afloat) */
+    ReportType["CUSTOMER_PROFILE_SNAPSHOT"] = "customer_profile_snapshot";
+    /** Gateway transaction log (VertoX) */
+    ReportType["GATEWAY_TRANSACTION_LOG"] = "gateway_transaction_log";
+})(ReportType || (exports.ReportType = ReportType = {}));
+/**
+ * Registry of all available reports
+ */
+exports.REPORTS = {
+    // Dashboard Reports
+    [ReportType.MERCHANT_DISBURSEMENT_REPORT]: {
+        id: "merchant_disbursement_report",
+        displayName: "Merchant Disbursement Report",
+        endpoint: "/dashboard/merchant_disbursements",
+        availableFormats: [FileFormat.PDF, FileFormat.EXCEL],
+        projectType: ProjectType.DASHBOARD,
+        reportType: ReportType.MERCHANT_DISBURSEMENT_REPORT,
+        description: "Detailed breakdown of payments made to merchants",
+    },
+    [ReportType.TRANSACTION_REVENUE_SUMMARY]: {
+        id: "transaction_revenue_summary",
+        displayName: "Transaction Revenue Summary",
+        endpoint: "/dashboard/revenue_summary",
+        availableFormats: [FileFormat.PDF, FileFormat.EXCEL],
+        projectType: ProjectType.DASHBOARD,
+        reportType: ReportType.TRANSACTION_REVENUE_SUMMARY,
+        description: "Summary of all revenue transactions by period",
+    },
+    // Afloat Reports
+    [ReportType.CUSTOMER_WALLET_ACTIVITY]: {
+        id: "customer_wallet_activity",
+        displayName: "Customer Wallet Activity",
+        endpoint: "/afloat/wallet_activity",
+        availableFormats: [FileFormat.PDF, FileFormat.EXCEL],
+        projectType: ProjectType.AFLOAT,
+        reportType: ReportType.CUSTOMER_WALLET_ACTIVITY,
+        description: "Detailed record of all customer wallet transactions",
+    },
+    [ReportType.CUSTOMER_PROFILE_SNAPSHOT]: {
+        id: "customer_profile_snapshot",
+        displayName: "Customer Profile Snapshot",
+        endpoint: "/afloat/profile_snapshot",
+        availableFormats: [FileFormat.PDF],
+        projectType: ProjectType.AFLOAT,
+        reportType: ReportType.CUSTOMER_PROFILE_SNAPSHOT,
+        description: "Current account information and status",
+    },
+    // VertoX Reports
+    [ReportType.GATEWAY_TRANSACTION_LOG]: {
+        id: "gateway_transaction_log",
+        displayName: "Gateway Transaction Log",
+        endpoint: "/vertox/gateway_transactions",
+        availableFormats: [FileFormat.EXCEL],
+        projectType: ProjectType.VERTO_X,
+        reportType: ReportType.GATEWAY_TRANSACTION_LOG,
+        description: "Log of all payment gateway API transactions",
+    },
+};
+/**
+ * Get all reports for a specific project
+ * @param projectType The project type to filter by
+ * @returns Array of report definitions for the project
+ */
+function getReportsByProject(projectType) {
+    return Object.values(exports.REPORTS).filter((report) => report.projectType === projectType);
+}
+/**
+ * Get a report by its type
+ * @param reportType The report type to retrieve
+ * @returns The report definition or undefined if not found
+ */
+function getReportByType(reportType) {
+    return exports.REPORTS[reportType];
+}
+/**
+ * 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
+ */
+function isReportAvailableForProject(projectType, reportType) {
+    const report = exports.REPORTS[reportType];
+    return report !== undefined && report.projectType === projectType;
+}
+/**
+ * Report Manager class for handling report downloads
+ */
+class ReportManager {
+    constructor() {
+        /**
+         * Get the base URL for the report API
+         * @returns The base URL
+         */
+        Object.defineProperty(this, "getBaseURL", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                const url = index_js_1.ConfigService.instance.pdfMakerBaseUrl;
+                if (url.endsWith("/"))
+                    return url.slice(0, -1);
+                return url;
+            }
+        });
+        /**
+         * Converts a base64 string to a Blob
+         * @param base64 The base64 string
+         * @returns A Blob
+         */
+        Object.defineProperty(this, "b64toBlob", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (base64) => fetch(base64).then((res) => res.blob())
+        });
+    }
+    /**
+     * Get the singleton instance of ReportManager
+     */
+    static get instance() {
+        return this._instance || (this._instance = new this());
+    }
+    /**
+     * Downloads a report based on project type and report type
+     * @param args Arguments for the report download
+     * @returns Promise that resolves when download is complete
+     */
+    async downloadReport(args) {
+        try {
+            // Get the report from the registry
+            const report = exports.REPORTS[args.reportType];
+            if (!report) {
+                throw new Error(`Report type ${args.reportType} not configured`);
+            }
+            // Validate that the report belongs to the specified project
+            if (report.projectType !== args.projectType) {
+                throw new Error(`Report type ${args.reportType} does not belong to project ${args.projectType}`);
+            }
+            // Check if requested format is supported
+            if (!report.availableFormats.includes(args.fileFormat)) {
+                throw new Error(`File format ${args.fileFormat} not supported for ${report.displayName}`);
+            }
+            // Build URL using the report's endpoint
+            let url = `${this.getBaseURL()}${report.endpoint}`;
+            // Create a properly typed query parameters object
+            // deno-lint-ignore no-explicit-any
+            const queryParams = {
+                ...(args.query || {}),
+                format: args.fileFormat,
+            };
+            // Build the query string
+            const searchParams = new URLSearchParams();
+            for (const key in queryParams) {
+                if (Object.prototype.hasOwnProperty.call(queryParams, key)) {
+                    const value = queryParams[key];
+                    if (value !== undefined && value !== null) {
+                        if (Array.isArray(value)) {
+                            value.forEach((item) => {
+                                searchParams.append(key + "[]", String(item));
+                            });
+                        }
+                        else {
+                            searchParams.append(key, String(value));
+                        }
+                    }
+                }
+            }
+            const queryString = searchParams.toString();
+            if (queryString) {
+                url += `?${queryString}`;
+            }
+            // Make the request
+            const response = await fetch(url, {
+                method: "GET",
+                headers: {
+                    "Accept": "*/*",
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${args.token}`,
+                },
+            });
+            if (response.status !== 200) {
+                await this.handleErrorResponse(response);
+            }
+            // Process the download
+            await this.processDownload(response, report, args.fileFormat);
+        }
+        catch (error) {
+            console.error("Report download failed:", error);
+            throw error;
+        }
+    }
+    /**
+     * Process the download
+     * @param response The response from the API
+     * @param report The report definition
+     * @param fileFormat The requested file format
+     */
+    async processDownload(response, report, fileFormat) {
+        const contentDisposition = response.headers.get("Content-Disposition");
+        // Get default filename based on report and file format
+        const defaultFilename = this.getDefaultFilename(report, fileFormat);
+        // Try to get filename from Content-Disposition, fall back to default
+        const fileName = this.extractFilenameFromContentDisposition(contentDisposition) ||
+            defaultFilename;
+        // Handle the response based on content type
+        // deno-lint-ignore no-explicit-any
+        const blob = await this.b64toBlob(await response.text());
+        file_saver_1.default.saveAs(blob, fileName);
+    }
+    /**
+     * Handle error responses from the API
+     * @param response The response from the API
+     * @throws Error with appropriate message
+     */
+    async handleErrorResponse(response) {
+        let errorMessage = "Encountered an error while generating report";
+        try {
+            // Try to parse as JSON first
+            const contentType = response.headers.get("Content-Type");
+            if (contentType && contentType.includes("application/json")) {
+                const errorData = await response.json();
+                errorMessage = errorData.message || errorData.error ||
+                    errorMessage;
+            }
+            else {
+                // Try to get error as text
+                const textError = await response.text();
+                if (textError) {
+                    errorMessage = textError;
+                }
+            }
+        }
+        catch (parseError) {
+            console.error("Error parsing error response:", parseError);
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * 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
+     */
+    getDefaultFilename(report, fileFormat) {
+        const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD format
+        // Build the filename with project, report type, and date
+        const baseFilename = `${report.id}_${date}`;
+        // Add the extension based on the file format
+        return fileFormat === FileFormat.PDF
+            ? `${baseFilename}.pdf`
+            : `${baseFilename}.xlsx`;
+    }
+    /**
+     * Extracts the filename from the Content-Disposition header
+     * @param contentDisposition The Content-Disposition header value
+     * @returns The extracted filename or null if not found
+     */
+    extractFilenameFromContentDisposition(contentDisposition) {
+        // Check if the header exists
+        if (!contentDisposition) {
+            return null;
+        }
+        // Try to match the filename pattern
+        const filenameRegex = /filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/;
+        const matches = filenameRegex.exec(contentDisposition);
+        if (matches && matches[1]) {
+            // Clean up the filename by removing quotes if present
+            let filename = matches[1].trim();
+            // Remove surrounding quotes if they exist
+            if (filename.startsWith('"') && filename.endsWith('"')) {
+                filename = filename.substring(1, filename.length - 1);
+            }
+            else if (filename.startsWith("'") && filename.endsWith("'")) {
+                filename = filename.substring(1, filename.length - 1);
+            }
+            return filename;
+        }
+        return null;
+    }
+}
+exports.ReportManager = ReportManager;