@temboplus/frontend-core 0.4.0 → 0.4.1

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

@@ -0,0 +1,146 @@
+/**
+ * Available file formats for reports
+ */
+export declare enum FileFormat {
+    /** PDF file format */
+    PDF = "pdf",
+    /** Excel file format */
+    EXCEL = "excel",
+    /** CSV file format */
+    CSV = "csv"
+}
+/**
+ * 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;IACf,sBAAsB;IACtB,GAAG,QAAQ;CACZ;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,CAOhB;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,320 @@
+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";
+    /** CSV file format */
+    FileFormat["CSV"] = "csv";
+})(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: () => {
+                let url = ConfigService.instance.pdfMakerBaseUrl;
+                if (url.trim().length === 0) {
+                    url = "https://api.afloat.money/pdf-maker";
+                }
+                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 || {}),
+                fileFormat: 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/{dist → esm/src}/utils/id.d.ts

@@ -2,15 +2,11 @@
  * Generates a unique UUID (version 4).
  * @returns {string} - A randomly generated UUID string.
  */
-declare function generateUniqueUUID(): string;
+export declare function generateUniqueUUID(): string;
 /**
  * Generates a UUID (version 5) based on the input string and a predefined namespace.
  * @param {string} data - The input string to generate the UUID from.
  * @returns {string} - A UUID string generated from the input string.
  */
-declare function generateUuidBasedOn(data: string): string;
-export declare const IdUtils: {
-    generateUniqueUUID: typeof generateUniqueUUID;
-    generateUuidBasedOn: typeof generateUuidBasedOn;
-};
-export {};
+export declare function generateUuidBasedOn(data: string): string;
+//# sourceMappingURL=id.d.ts.map

package/esm/src/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/src/utils/id.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAKD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/esm/src/utils/id.js

@@ -0,0 +1,19 @@
+import { v4 as uuidv4 } from "uuid";
+import { v5 as uuidv5 } from "uuid";
+/**
+ * Generates a unique UUID (version 4).
+ * @returns {string} - A randomly generated UUID string.
+ */
+export function generateUniqueUUID() {
+    return uuidv4();
+}
+// Predefined namespace
+const NAMESPACE = uuidv5.DNS;
+/**
+ * Generates a UUID (version 5) based on the input string and a predefined namespace.
+ * @param {string} data - The input string to generate the UUID from.
+ * @returns {string} - A UUID string generated from the input string.
+ */
+export function generateUuidBasedOn(data) {
+    return uuidv5(data, NAMESPACE);
+}

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

@@ -0,0 +1,4 @@
+export * from "./id.js";
+export * from "./time.js";
+export * from "./text.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/esm/src/utils/text.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Capitalizes the first letter of a string and converts the rest of the string to lowercase.
+ * @param {string} str - The input string.
+ * @returns {string} - The formatted string with the first letter capitalized.
+ */
+export declare function capitalizeFirstLetter(str: string): string;
+/**
+ * Combines a first name and a last name into a full name.
+ * @param {string} firstName - The first name.
+ * @param {string} lastName - The last name.
+ * @returns {string} - The full name formatted as "FirstName LastName".
+ */
+export declare function getFullName(firstName: string, lastName: string): string;
+/**
+ * Generates a URL-friendly slug from a given text.
+ * @param {string} text - The input string.
+ * @returns {string} - The generated slug with lowercase alphanumeric characters and hyphens.
+ */
+export declare function generateSlug(text: string): string;
+/**
+ * Abbreviates a full name into a first name and the initial of the last name.
+ * @param {string} fullName - The input full name.
+ * @returns {string} - The abbreviated name in the format "FirstName L.".
+ */
+export declare function abbreviateName(fullName: string): string;
+/**
+ * Extracts the initials from a full name.
+ * @param {string} fullName - The input full name.
+ * @returns {string} - The initials in uppercase format.
+ */
+export declare function getInitialsFrom(fullName: string): string;
+//# sourceMappingURL=text.d.ts.map

package/esm/src/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/src/utils/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcxD"}

package/esm/src/utils/text.js

@@ -0,0 +1,68 @@
+/**
+ * Capitalizes the first letter of a string and converts the rest of the string to lowercase.
+ * @param {string} str - The input string.
+ * @returns {string} - The formatted string with the first letter capitalized.
+ */
+export function capitalizeFirstLetter(str) {
+    if (str.length === 0) {
+        return str; // Return an empty string if input is empty
+    }
+    const firstLetter = str.charAt(0).toUpperCase();
+    const restOfString = str.slice(1).toLowerCase();
+    return firstLetter + restOfString;
+}
+/**
+ * Combines a first name and a last name into a full name.
+ * @param {string} firstName - The first name.
+ * @param {string} lastName - The last name.
+ * @returns {string} - The full name formatted as "FirstName LastName".
+ */
+export function getFullName(firstName, lastName) {
+    return `${firstName} ${lastName}`;
+}
+/**
+ * Generates a URL-friendly slug from a given text.
+ * @param {string} text - The input string.
+ * @returns {string} - The generated slug with lowercase alphanumeric characters and hyphens.
+ */
+export function generateSlug(text) {
+    return text
+        .toLowerCase() // Convert to lowercase
+        .replace(/[^\w\s-]/g, "") // Remove non-alphanumeric characters except spaces and hyphens
+        .trim() // Trim leading/trailing spaces
+        .replace(/\s+/g, "-") // Replace spaces with hyphens
+        .replace(/-+/g, "-"); // Replace multiple hyphens with a single hyphen
+}
+/**
+ * Abbreviates a full name into a first name and the initial of the last name.
+ * @param {string} fullName - The input full name.
+ * @returns {string} - The abbreviated name in the format "FirstName L.".
+ */
+export function abbreviateName(fullName) {
+    const nameParts = fullName.trim().split(" ");
+    if (nameParts.length === 1) {
+        // If there's only one word in the name, return it as is.
+        return fullName;
+    }
+    const firstName = nameParts[0];
+    const lastNameInitial = nameParts[nameParts.length - 1].charAt(0);
+    return `${firstName} ${lastNameInitial}.`;
+}
+/**
+ * Extracts the initials from a full name.
+ * @param {string} fullName - The input full name.
+ * @returns {string} - The initials in uppercase format.
+ */
+export function getInitialsFrom(fullName) {
+    let label = "";
+    const names = (fullName ?? "").trim().split(" ");
+    if (names.length === 0)
+        return "";
+    const firstName = names[0];
+    label = firstName.charAt(0);
+    if (names.length > 1) {
+        const lastName = names[names.length - 1];
+        label = `${firstName.charAt(0)}${lastName.charAt(0)}`;
+    }
+    return label.toUpperCase();
+}

package/esm/src/utils/text.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.test.d.ts","sourceRoot":"","sources":["../../../src/src/utils/text.test.ts"],"names":[],"mappings":""}

package/{dist → esm/src}/utils/time.d.ts

@@ -4,23 +4,18 @@
  * @param {Date} b - The second Date object.
  * @returns {boolean} - Returns true if the dates are equal in terms of year, month, and day; otherwise, false.
  */
-declare function compareDates(a: Date, b: Date): boolean;
+export declare function compareDates(a: Date, b: Date): boolean;
 /**
  * Sorts two dates in descending order (latest date first).
  * @param {Date} a - The first Date object.
  * @param {Date} b - The second Date object.
  * @returns {number} - Returns a positive value if `b` is after `a`, a negative value if `a` is after `b`, and 0 if they are equal.
  */
-declare function sortDates(a: Date, b: Date): number;
+export declare function sortDates(a: Date, b: Date): number;
 /**
  * Creates a delay for a given number of milliseconds.
  * @param {number} milliseconds - The delay duration in milliseconds.
  * @returns {Promise<void>} - A promise that resolves after the specified delay.
  */
-declare function delay(milliseconds: number): Promise<void>;
-export declare const TimeUtils: {
-    compareDates: typeof compareDates;
-    sortDates: typeof sortDates;
-    delay: typeof delay;
-};
-export {};
+export declare function delay(milliseconds: number): Promise<void>;
+//# sourceMappingURL=time.d.ts.map

package/esm/src/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAMtD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzD"}