@tap-payments/os-micro-frontend-shared 0.1.39 → 0.1.40-9.hotfix.1

package/build/types/user.d.ts

@@ -2,12 +2,8 @@ import { UserApp } from './apps';
 import { Brand } from './brand';
 import { Entity } from './entity';
 import { Merchant } from './merchant';
-import { ACCOUNT_SECTION } from './account';
 import { Country } from './appConfig';
-export interface TextAndLang {
-    lang: string;
-    text: string;
-}
+import { TextAndLang } from './common';
 export interface SegmentCountry {
     id: string;
     code: string;
@@ -44,6 +40,7 @@ export interface SegmentType {
 }
 export interface Segment {
     id: string;
+    code: string;
     organization_id: string;
     name: TextAndLang[];
     logo: string;
@@ -80,6 +77,7 @@ export interface Segment {
     };
     is_business_segment?: boolean;
     is_segment_has_more_than_one_merchant?: boolean;
+    marketplace_merchants_count?: number;
 }
 interface SegmentUserName {
     first: string;
@@ -102,18 +100,19 @@ export interface SegmentDetails {
 interface SegmentEntity {
     id: string;
 }
+export interface Contact {
+    email: string;
+    phone: {
+        country_code: string;
+        number: string;
+    };
+}
 export interface SegmentUser {
     id: string;
     created: number;
     individual_id: string;
-    names: Record<string, SegmentUserName>;
-    contact: {
-        email: string;
-        phone: {
-            country_code: string;
-            number: string;
-        };
-    };
+    name: Record<string, SegmentUserName>;
+    contact: Contact;
     birth: {
         date: number;
     };
@@ -127,13 +126,7 @@ export interface SegmentUser {
 export interface IndividualSegmentDetails {
     individual: {
         name: UserName[];
-        contact: {
-            email: string;
-            phone: {
-                country_code: string;
-                number: string;
-            };
-        };
+        contact: Contact;
     };
     segment: Segment;
 }
@@ -161,7 +154,7 @@ export interface SegmentRole {
     role_id: string;
 }
 export interface UserSection {
-    id: ACCOUNT_SECTION;
+    id: string;
     title?: string;
     icon?: string;
 }
@@ -214,4 +207,57 @@ export interface UserFormI {
     is_authorized?: boolean;
 }
 export type GeographyVariant = 'G' | 'L' | 'R';
+export interface BrandReference {
+    id: string;
+}
+export interface CountryReference {
+    id: string;
+    entities: EntityReference[];
+}
+export interface EntityReference {
+    id: string;
+}
+export interface UserReference {
+    id: string;
+}
+export interface DeveloperReference {
+    id: string;
+}
+export interface CustomerReference {
+    id: string;
+}
+export interface SelectedSegment {
+    id: string;
+    brands: BrandReference[];
+    countries: CountryReference[];
+    users: UserReference[];
+    developers: DeveloperReference[];
+    customers: CustomerReference[];
+}
+export interface UserNameLocale {
+    lang: string;
+    first: string;
+    last: string;
+}
+export interface Individual {
+    id: string;
+    contact: Contact;
+    name: UserNameLocale[];
+}
+export interface User {
+    individual: Individual;
+    authentication_id: string;
+    individual_id: string;
+    is_active: boolean;
+    bi: string;
+    count: number;
+    has_more: boolean;
+    live_mode: boolean;
+    force_logout: boolean;
+    segments: Segment[];
+    active_segment_id: string;
+    active_segments: SelectedSegment[];
+    created_at: string;
+    updated_at: string;
+}
 export {};

package/build/types/utilities.d.ts

@@ -0,0 +1,24 @@
+export type OptionsListItem = {
+    id: string;
+    logo?: string;
+    code?: string;
+    name: {
+        ar: string;
+        en: string;
+    };
+    currency_code?: string[];
+    country_code?: string[];
+    range?: {
+        from: number;
+        to: number;
+    };
+    sub?: {
+        id: string;
+        logo: string;
+        code: string;
+        name: {
+            ar: string;
+            en: string;
+        };
+    }[];
+};

package/build/types/utilities.js

@@ -0,0 +1 @@
+export {};

package/build/types/window.d.ts

@@ -0,0 +1,4 @@
+export type AppEnvironment = 'development' | 'sandbox' | 'beta' | 'production';
+export type WindowGlobalConfig = {
+    MW_BASE_URL?: string;
+};

package/build/types/window.js

@@ -0,0 +1 @@
+export {};

package/build/utils/api.js

@@ -61,6 +61,7 @@ api.interceptors.request.use((config) => {
         }, 0);
     });
 });
+// create interceptor to add token to all requests
 api.interceptors.request.use((config) => {
     config.headers.Authorization = getLoggedInUserJwtToken();
     const secretKey = getSecretKey();
@@ -81,7 +82,9 @@ export function setApiToken(token) {
         api.defaults.headers.common.Authorization = token;
     });
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function getHeaders(attrs) {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const _a = attrs !== null && attrs !== void 0 ? attrs : {}, { sandboxMode, fixedSecretKey, applicationId, serviceId, functionId, userFunctionId, segmentId } = _a, rest = __rest(_a, ["sandboxMode", "fixedSecretKey", "applicationId", "serviceId", "functionId", "userFunctionId", "segmentId"]);
     return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, rest), { live_mode: sandboxMode ? 'false' : 'true' }), (!!fixedSecretKey && { 'x-test-secret': fixedSecretKey })), (!!applicationId && { application_id: applicationId })), (!!serviceId && { service_id: serviceId })), (!!functionId && { function_id: functionId })), (!!userFunctionId && { user_function_id: userFunctionId }));
 }

package/build/utils/array.js

@@ -1,10 +1,14 @@
 import orderBy from 'lodash/orderBy';
 import get from 'lodash/get';
 export const generateArray = (length) => Array.from({ length }, (_, i) => i);
-export const groupBy = (arr, groupFn) => arr.reduce((grouped, obj) => (Object.assign(Object.assign({}, grouped), { [groupFn(obj)]: [...(grouped[groupFn(obj)] || []), obj] })), {});
+// eslint-disable-next-line
+export const groupBy = (arr, groupFn) => arr.reduce(
+// eslint-disable-next-line
+(grouped, obj) => (Object.assign(Object.assign({}, grouped), { [groupFn(obj)]: [...(grouped[groupFn(obj)] || []), obj] })), {});
 export function sortList({ list, sortBy, orders }) {
     return (sortBy === null || sortBy === void 0 ? void 0 : sortBy.length) && (orders === null || orders === void 0 ? void 0 : orders.length) ? orderBy(list, sortBy, orders) : list;
 }
+// eslint-disable-next-line
 export const sortByString = (list = [], key) => {
     if (!list.length)
         return [];

package/build/utils/billing.js

@@ -28,5 +28,6 @@ export const getDefaultInvoiceInfo = () => ({
     isItemsNotValid: false,
     isAmountIsMissing: false,
     errors: [],
+    // eslint-disable-next-line
     brand: {},
 });

package/build/utils/boolean.d.ts

@@ -0,0 +1 @@
+export declare const stringToBoolean: (value: string | undefined) => boolean | undefined;

package/build/utils/boolean.js

@@ -0,0 +1,7 @@
+export const stringToBoolean = (value) => {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return undefined;
+};

package/build/utils/color.d.ts

@@ -1,2 +1,13 @@
+import { ColorObject } from 'color';
 export declare function getRandomColor(): string;
 export declare function getRandomGradientColor(): string;
+export declare const hexa2Rgba: (value: string) => {
+    value: {
+        r: number;
+        g: number;
+        b: number;
+        alpha: number;
+    };
+    stringified: string;
+};
+export declare const rgba2Hexa: (value: ColorObject) => string;

package/build/utils/color.js

@@ -1,3 +1,4 @@
+import Color from 'color';
 export function getRandomColor() {
     const colors = [
         '#D6D6D6',
@@ -36,3 +37,29 @@ export function getRandomGradientColor() {
     ];
     return colors[Math.trunc(Math.random() * colors.length)];
 }
+const BLACK_RGBA_COLOR = {
+    r: 0,
+    g: 0,
+    b: 0,
+    alpha: 1,
+};
+export const hexa2Rgba = (value) => {
+    try {
+        const colorInstance = Color(value).rgb();
+        const { r, g, b, alpha = 1 } = colorInstance.object();
+        return {
+            value: { r, g, b, alpha },
+            stringified: `rgba(${r},${g},${b},${alpha})`,
+        };
+    }
+    catch (error) {
+        console.error(error);
+        console.warn(`Invalid hex color: "${value}". Falling back to black.`);
+        const { r, g, b, alpha } = BLACK_RGBA_COLOR;
+        return {
+            value: BLACK_RGBA_COLOR,
+            stringified: `rgba(${r},${g},${b},${alpha})`,
+        };
+    }
+};
+export const rgba2Hexa = (value) => Color(value).hexa();

package/build/utils/columnResizeStorage.d.ts

@@ -0,0 +1,16 @@
+export interface ColumnSettings {
+    width: number;
+}
+export interface ColumnSettingsMap {
+    [columnId: string]: ColumnSettings;
+}
+export interface ServiceColumnsMap {
+    [serviceCode: string]: ColumnSettingsMap;
+}
+export interface SheetViewColumnsData {
+    [windowId: string]: ServiceColumnsMap;
+}
+export declare const getSheetViewColumns: () => SheetViewColumnsData;
+export declare const setSheetViewColumns: (data: SheetViewColumnsData) => boolean;
+export declare const getColumnWidth: (windowId: string, serviceCode: string, columnId: string, defaultWidth?: number) => number | undefined;
+export declare const setColumnWidth: (windowId: string, serviceCode: string, columnId: string, width: number) => boolean;

package/build/utils/columnResizeStorage.js

@@ -0,0 +1,96 @@
+import { getSheetViewColumnsStorage, setSheetViewColumnsStorage } from './localStorage';
+const isValidString = (value) => typeof value === 'string' && value.trim().length > 0;
+const isValidNumber = (value) => typeof value === 'number' && !isNaN(value) && isFinite(value) && value > 0;
+const isValidColumnSettings = (data) => {
+    if (!data || typeof data !== 'object')
+        return false;
+    const settings = data;
+    return 'width' in settings && isValidNumber(settings.width);
+};
+const isValidColumnSettingsMap = (data) => {
+    if (!data || typeof data !== 'object')
+        return false;
+    return Object.values(data).every(isValidColumnSettings);
+};
+const isValidServiceColumnsMap = (data) => {
+    if (!data || typeof data !== 'object')
+        return false;
+    return Object.values(data).every(isValidColumnSettingsMap);
+};
+const isValidSheetViewColumnsData = (data) => {
+    if (!data || typeof data !== 'object')
+        return false;
+    return Object.values(data).every(isValidServiceColumnsMap);
+};
+export const getSheetViewColumns = () => {
+    try {
+        const data = getSheetViewColumnsStorage();
+        if (!data)
+            return {};
+        const parsedData = data;
+        if (!isValidSheetViewColumnsData(parsedData)) {
+            console.warn('Invalid column settings in localStorage');
+            return {};
+        }
+        return parsedData;
+    }
+    catch (error) {
+        console.warn('Failed to get sheetview columns:', error);
+        return {};
+    }
+};
+export const setSheetViewColumns = (data) => {
+    if (!isValidSheetViewColumnsData(data)) {
+        console.warn('Invalid data structure for sheetview columns');
+        return false;
+    }
+    try {
+        setSheetViewColumnsStorage(data);
+        return true;
+    }
+    catch (error) {
+        console.warn('Failed to save sheetview columns:', error);
+        return false;
+    }
+};
+export const getColumnWidth = (windowId, serviceCode, columnId, defaultWidth) => {
+    var _a, _b, _c;
+    if (!isValidString(windowId) || !isValidString(serviceCode) || !isValidString(columnId)) {
+        return defaultWidth;
+    }
+    try {
+        const columnsData = getSheetViewColumns();
+        const width = (_c = (_b = (_a = columnsData[windowId]) === null || _a === void 0 ? void 0 : _a[serviceCode]) === null || _b === void 0 ? void 0 : _b[columnId]) === null || _c === void 0 ? void 0 : _c.width;
+        return width !== null && width !== void 0 ? width : defaultWidth;
+    }
+    catch (error) {
+        console.warn('Failed to get column width:', error);
+        return defaultWidth;
+    }
+};
+export const setColumnWidth = (windowId, serviceCode, columnId, width) => {
+    if (!isValidString(windowId) || !isValidString(serviceCode) || !isValidString(columnId) || !isValidNumber(width)) {
+        console.warn('Invalid parameters for setColumnWidth');
+        return false;
+    }
+    try {
+        const columnsData = getSheetViewColumns();
+        if (!columnsData[windowId]) {
+            columnsData[windowId] = {};
+        }
+        if (!columnsData[windowId][serviceCode]) {
+            columnsData[windowId][serviceCode] = {};
+        }
+        if (!columnsData[windowId][serviceCode][columnId]) {
+            columnsData[windowId][serviceCode][columnId] = { width };
+        }
+        else {
+            columnsData[windowId][serviceCode][columnId].width = width;
+        }
+        return setSheetViewColumns(columnsData);
+    }
+    catch (error) {
+        console.warn('Failed to set column width:', error);
+        return false;
+    }
+};

package/build/utils/columns.d.ts

@@ -9,8 +9,8 @@ export declare function filterShownColumns<T>(columns: Array<IColumnProps<T & {
 export declare function isParameterSelected(columns: ColumnViewProps[], columnId: string, parameter: string): boolean;
 export declare function mapDataToViews(columnData?: ColumnsView[], language?: string): ColumnViewProps[];
 export declare function mapViewsToData(columns: ColumnViewProps[]): ColumnsView[];
-export declare const updateColumnSelection: ({ columnsViewData, columnName, selected, }: {
+export declare const updateColumnSelection: ({ columnsViewData, columnsName, selected, }: {
     columnsViewData: ColumnsView[];
-    columnName: string;
+    columnsName: string[];
     selected: boolean;
 }) => ColumnsView[];

package/build/utils/columns.js

@@ -65,11 +65,10 @@ export function mapViewsToData(columns) {
         };
     });
 }
-export const updateColumnSelection = ({ columnsViewData, columnName, selected, }) => {
+export const updateColumnSelection = ({ columnsViewData, columnsName, selected, }) => {
     return columnsViewData.map((column) => {
-        var _a, _b;
-        const columnText = (_b = (_a = column.name[0]) === null || _a === void 0 ? void 0 : _a.text) === null || _b === void 0 ? void 0 : _b.toLowerCase();
-        if (columnText === columnName.toLowerCase()) {
+        var _a;
+        if (columnsName.includes((_a = column.name[0]) === null || _a === void 0 ? void 0 : _a.text)) {
             return Object.assign(Object.assign({}, column), { selected });
         }
         return column;

package/build/utils/country.d.ts

@@ -1 +1,2 @@
-export declare function getCountryName(countryCode: string): string | undefined;
+export declare function getCountryNameByISO(countryCode: string): string | undefined;
+export declare function isSaudiArabia(countryCode: string): boolean;

package/build/utils/country.js

@@ -1,11 +1,14 @@
-import { toast } from 'react-hot-toast';
-export function getCountryName(countryCode) {
+export function getCountryNameByISO(countryCode) {
     var _a, _b, _c;
     try {
         const regionNames = new Intl.DisplayNames(['en'], { type: 'region' });
         return regionNames.of(countryCode);
+        // eslint-disable-next-line
     }
     catch (error) {
-        toast.error((_c = (_b = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.message);
+        console.error((_c = (_b = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.message);
     }
 }
+export function isSaudiArabia(countryCode) {
+    return countryCode === 'SA';
+}

package/build/utils/currency.d.ts

@@ -5,7 +5,6 @@ export declare const conversionTypesLabels: {
 };
 export declare const currencyConfig: Record<string, number>;
 export declare const intlCurrency: (charge: number, currencyType: CurrencyCodes) => string;
-export declare const getCurrencyCodeFlag: (currency: string) => string;
 export declare const isIntegerAmount: (charge: number) => boolean;
 export declare const isDecimalWithOneDigit: (charge: number) => boolean;
 export declare const hasOnlyOneDigitAfterDecimal: (charge: number) => boolean;

package/build/utils/currency.js

@@ -1,6 +1,4 @@
-import { toast } from 'react-hot-toast';
-import { getCurrenciesIcon, SUPPORTED_CURRENCY_DETAILS, SUPPORTED_CURRENCY_CODES } from '../constants/index.js';
-import { CurrencyCodes } from '../types/index.js';
+import { SUPPORTED_CURRENCY_DETAILS } from '../constants/index.js';
 export const conversionTypesLabels = {
     fx: 'Foreign Exchange',
     dcc: 'Dynamic Currency Conversion',
@@ -22,16 +20,13 @@ export const intlCurrency = (charge, currencyType) => {
             minimumFractionDigits: currencyConfig[currencyType] ? 3 : 2,
         }).format(charge);
         return currency;
+        // eslint-disable-next-line
     }
     catch (error) {
-        toast.error((_c = (_b = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.message);
+        console.error((_c = (_b = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.message);
         return '0';
     }
 };
-export const getCurrencyCodeFlag = (currency) => {
-    const currencyMap = new Map(SUPPORTED_CURRENCY_CODES.map((selectedCurrency) => [selectedCurrency, getCurrenciesIcon(selectedCurrency)]));
-    return currencyMap.get(currency) || CurrencyCodes.SAR;
-};
 export const isIntegerAmount = (charge) => {
     return charge % 1 === 0;
 };
@@ -56,7 +51,9 @@ export const formatCurrencyWithInput = (charge, selectedCurrency) => {
     return chargeString;
 };
 export function formatAmount(amount, decimal = 2) {
+    // Ensure the input is a number
     const num = parseFloat(amount.toString());
+    // Check if it's a valid number
     if (isNaN(num)) {
         const [integerAmount, decimalAmount] = (0).toFixed(decimal).split('.');
         const fullAmount = `${integerAmount}.${decimalAmount}`;
@@ -66,8 +63,11 @@ export function formatAmount(amount, decimal = 2) {
             fullAmount,
         };
     }
+    // Use toFixed(limit) to limit to 2 decimal places
     const fixedNumber = num.toFixed(decimal);
+    // Split integer and decimal parts
     const [integerPart, decimalPart] = fixedNumber.split('.');
+    // Add commas to the integer part
     const formattedInteger = parseInt(integerPart).toLocaleString();
     return {
         integerAmount: formattedInteger,

package/build/utils/date.d.ts

@@ -2,6 +2,11 @@ export declare function getGreetingMessageId(userTimeHours: number): string;
 export declare function getDatePickerFormat(date: Date | [Date, Date], locale: string): string;
 export declare const getUTCOffset: (offsetStr?: string | number) => number;
 export declare const formatUTCOffset: (offset?: number) => string;
+/**
+ * Get the default date range for the calendar
+ * @param startDay - Number of days to subtract from today, default value is 6 days to get the date range of the last 7 days including today
+ * @returns - Array of two dates [startDate, endDate]
+ */
 export declare const getDefaultDateRange: (startDay?: number) => [Date, Date];
 export declare const getUTCTimestamp: (date: Date | string | number) => number;
 export declare const getTimestampByTimezone: (date: Date | string | number, selectedTimezone?: string) => number;
@@ -33,3 +38,10 @@ export declare const generatePastYearList: (length?: number) => {
     label: number;
 }[];
 export declare function secondsToTimeString(seconds: number): string;
+type TimeUnit = 'seconds' | 'minutes' | 'hours' | 'days';
+export declare function isWithinTimeAgo(timestampMs: number, amount: number, unit?: TimeUnit): boolean;
+export declare const formatRelativeTimeWithinHour: (timestampMs: number) => string;
+export declare const isTodayDate: (date: string | Date) => boolean;
+export declare const isYesterdayDate: (date: string | Date) => boolean;
+export declare const isValidDate: (date?: Date | string | number) => boolean;
+export {};

package/build/utils/date.js

@@ -3,8 +3,12 @@ import relativeTime from 'dayjs/plugin/relativeTime';
 import timezone from 'dayjs/plugin/timezone';
 import utc from 'dayjs/plugin/utc';
 import calendar from 'dayjs/plugin/calendar';
+import isToday from 'dayjs/plugin/isToday';
+import isYesterday from 'dayjs/plugin/isYesterday';
 import { TIMEZONES } from '../constants/index.js';
 import { pad } from './number';
+dayjs.extend(isToday);
+dayjs.extend(isYesterday);
 dayjs.extend(utc);
 dayjs.extend(timezone);
 dayjs.extend(relativeTime);
@@ -34,6 +38,7 @@ export function getDatePickerFormat(date, locale) {
             month: locale === 'hijri' ? 'short' : 'short',
             day: 'numeric',
         });
+        // @ts-expect-error formatRange is not defined in the type
         return formatter.formatRange(startDate, endDate).replace('AH', '').trim().replace('–', ' – ');
     }
     const formatter = new Intl.DateTimeFormat(calendarMode, {
@@ -58,25 +63,43 @@ export const formatUTCOffset = (offset = 0) => {
     const paddedOffset = Math.abs(offset).toString().padStart(2, '0');
     return `UTC${sign}${paddedOffset}:00`;
 };
+/**
+ * Get the default date range for the calendar
+ * @param startDay - Number of days to subtract from today, default value is 6 days to get the date range of the last 7 days including today
+ * @returns - Array of two dates [startDate, endDate]
+ */
 export const getDefaultDateRange = (startDay = 6) => {
-    const monthDaysMinus = dayjs().subtract(startDay, 'day').hour(0).minute(0).second(0).toDate();
-    const today = dayjs(new Date()).hour(23).minute(59).second(59).toDate();
-    return [monthDaysMinus, today];
+    const safeDays = Number.isFinite(startDay) && startDay >= 0 ? startDay : 0;
+    const now = dayjs();
+    const start = now.subtract(safeDays, 'day').startOf('day');
+    const end = now.endOf('day');
+    return [start.toDate(), end.toDate()];
 };
 export const getUTCTimestamp = (date) => {
+    // Create a Date object with the local date string
     const localDate = new Date(date);
+    // Get the local timezone offset in minutes
     const localTimezoneOffset = localDate.getTimezoneOffset();
-    const utcTimestamp = localDate.getTime() - localTimezoneOffset * 60000;
+    // Calculate the UTC timestamp by subtracting the local timezone offset
+    const utcTimestamp = localDate.getTime() - localTimezoneOffset * 60000; // Convert minutes to milliseconds
+    // Create a new Date object with the UTC timestamp
     const utcDate = new Date(utcTimestamp);
+    // Convert the UTC date to a string
     const utcDateString = utcDate.toISOString();
     return dayjs(utcDateString).valueOf();
 };
+/*
+ * Convert local date to the selected timezone
+ * @param date - Date object, date string or timestamp
+ * @param selectedTimezone - Timezone string
+ * @returns - Milliseconds
+ */
 export const getTimestampByTimezone = (date, selectedTimezone = TIMEZONES.KW) => {
     const localDate = new Date(date);
     const localTimezoneOffset = localDate.getTimezoneOffset();
-    const selectedTimezoneOffset = getUTCOffset(selectedTimezone) * 60;
+    const selectedTimezoneOffset = getUTCOffset(selectedTimezone) * 60; // Convert hours to minutes
     const timezoneDiff = selectedTimezoneOffset - localTimezoneOffset;
-    const timezoneTimestamp = localDate.getTime() + timezoneDiff * 60000;
+    const timezoneTimestamp = localDate.getTime() + timezoneDiff * 60000; // Convert minutes to milliseconds
     const timezoneDate = new Date(timezoneTimestamp);
     const timezoneDateString = timezoneDate.toISOString();
     return dayjs(timezoneDateString).valueOf();
@@ -86,12 +109,23 @@ export const convertCalendarDateToUTC = (date, hoursOffset = 0) => {
     const adjustedDate = utcDate.subtract(hoursOffset, 'hour');
     return adjustedDate.valueOf();
 };
+/*
+ * Convert UTC date to local date
+ * @param date - Date object, date string or timestamp
+ * @returns - Date object
+ */
 export const convertUTCtoLocalDate = (date) => {
     const localDate = new Date(date);
     const localTimezoneOffset = localDate.getTimezoneOffset();
     const localTimestamp = localDate.getTime() + localTimezoneOffset * 60000;
     return new Date(localTimestamp);
 };
+/*
+ * Convert Local date to the selected timezone
+ * @param date - Date object, date string or timestamp
+ * @param selectedTimezone - Timezone string
+ * @returns - Date object
+ */
 export const changeDateTimezone = (date, { currentTimezone, targetTimezone }) => {
     if (!date) {
         return '';
@@ -188,3 +222,29 @@ export function secondsToTimeString(seconds) {
     }
     return `${pad(minutes)}:${pad(secondsValue)}`;
 }
+export function isWithinTimeAgo(timestampMs, amount, unit = 'seconds') {
+    const unitSeconds = {
+        seconds: 1,
+        minutes: 60,
+        hours: 3600,
+        days: 86400,
+    };
+    const now = Date.now();
+    const diffSeconds = (now - timestampMs) / 1000;
+    return diffSeconds < amount * unitSeconds[unit];
+}
+export const formatRelativeTimeWithinHour = (timestampMs) => {
+    const now = Date.now();
+    const diffSeconds = Math.floor((now - timestampMs) / 1000);
+    const diffMinutes = Math.floor(diffSeconds / 60);
+    if (isWithinTimeAgo(timestampMs, 60, 'seconds'))
+        return 'just now';
+    if (isWithinTimeAgo(timestampMs, 60, 'minutes'))
+        return `${diffMinutes} min${diffMinutes === 1 ? '' : 's'} ago`;
+    return '1 hour ago'; // fallback for > 59 mins
+};
+export const isTodayDate = (date) => dayjs(date).isToday();
+export const isYesterdayDate = (date) => dayjs(date).isYesterday();
+export const isValidDate = (date) => {
+    return dayjs(date).isValid();
+};