@intelact/driveup 1.4.47 → 1.4.49

package/lib/user/user.model.js

@@ -0,0 +1,200 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.User = void 0;
+const class_transformer_1 = require("class-transformer");
+const common_1 = require("../common");
+const security_1 = require("../security");
+const company_model_1 = require("../company/company.model");
+const instructor_model_1 = require("../instructor/instructor.model");
+const country_1 = require("../country");
+const agent_1 = require("../agent");
+const student_1 = require("../student");
+const profile_type_1 = require("./profile.type");
+const geo_1 = require("../geo");
+const alert_model_1 = require("../alert/alert.model");
+const metric_1 = require("../metric");
+/**
+ * Implemented for all kind of users (student, instructor, company user or agent).
+ * Depends on app sessions (public, mobile, admin, console).
+ * Some of properties can have different validaition rules.
+ */
+class User {
+    id;
+    uid;
+    language;
+    status;
+    /******************** Personal Data ********************/
+    name;
+    phone;
+    image;
+    email;
+    birthday;
+    address;
+    zipCode;
+    coord;
+    timezone;
+    /************************* alerts *************************/
+    alerts;
+    /************************** activity ***************************/
+    lastActivity;
+    overdatedActivity;
+    /************************* FCM tokens (for push notifications) *************************/
+    fcmTokens;
+    /************************* profiles **************************/
+    selectedProfile;
+    student;
+    agent;
+    instructor;
+    companies;
+    country;
+    company;
+    createdOn;
+    metrics;
+    /************************* methods *************************/
+    constructor(props) {
+        Object.assign(this, props);
+    }
+    static toInstance(data) {
+        return data ? (0, class_transformer_1.plainToInstance)(User, data) : null;
+    }
+    isActive() {
+        return this.status === security_1.AccountStatus.Active;
+    }
+}
+exports.User = User;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], User.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "uid", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "image", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Date),
+    __metadata("design:type", Date)
+], User.prototype, "birthday", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "address", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "zipCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => geo_1.Coordinate),
+    __metadata("design:type", geo_1.Coordinate)
+], User.prototype, "coord", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "timezone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => alert_model_1.UserAlert),
+    __metadata("design:type", Array)
+], User.prototype, "alerts", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Date),
+    __metadata("design:type", Date)
+], User.prototype, "lastActivity", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Boolean),
+    __metadata("design:type", Boolean)
+], User.prototype, "overdatedActivity", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], User.prototype, "selectedProfile", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => student_1.Student),
+    __metadata("design:type", student_1.Student)
+], User.prototype, "student", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => agent_1.Agent),
+    __metadata("design:type", agent_1.Agent)
+], User.prototype, "agent", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => instructor_model_1.Instructor),
+    __metadata("design:type", instructor_model_1.Instructor)
+], User.prototype, "instructor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => company_model_1.Company),
+    __metadata("design:type", Array)
+], User.prototype, "companies", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => country_1.Country),
+    __metadata("design:type", country_1.Country)
+], User.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => company_model_1.Company),
+    __metadata("design:type", company_model_1.Company)
+], User.prototype, "company", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Date),
+    __metadata("design:type", Date)
+], User.prototype, "createdOn", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => metric_1.Metric),
+    __metadata("design:type", Array)
+], User.prototype, "metrics", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)({ groups: ['admin'] }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Boolean)
+], User.prototype, "isActive", null);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], User, "toInstance", null);
+//# sourceMappingURL=user.model.js.map

package/lib/user/user.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.model.js","sourceRoot":"","sources":["../../src/user/user.model.ts"],"names":[],"mappings":"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"}

package/lib/utils/array.helper.d.ts

@@ -0,0 +1,21 @@
+export declare class ArrayHelper {
+    /**
+     * Get a random item from an array
+     * @param val Given T type array
+     * @returns Given T type
+     */
+    static getRandom<T>(val: T[]): T;
+    /**
+     * Get the last item from an array
+     * @param val Given T type array
+     * @returns Given T type
+     */
+    static getLastItem<T>(val: T[]): T;
+    /**
+     * Sum all numbers in a number array
+     * @param val Number[]
+     * @param toFixed (2)
+     * @returns Sum number
+     */
+    static getSum(val: number[], toFixed?: number): number;
+}

package/lib/utils/array.helper.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayHelper = void 0;
+class ArrayHelper {
+    /**
+     * Get a random item from an array
+     * @param val Given T type array
+     * @returns Given T type
+     */
+    static getRandom(val) {
+        const randomIndex = Math.floor(Math.random() * this.length);
+        return val[randomIndex];
+    }
+    /**
+     * Get the last item from an array
+     * @param val Given T type array
+     * @returns Given T type
+     */
+    static getLastItem(val) {
+        return val?.length ? val[this.length - 1] : undefined;
+    }
+    /**
+     * Sum all numbers in a number array
+     * @param val Number[]
+     * @param toFixed (2)
+     * @returns Sum number
+     */
+    static getSum(val, toFixed = 2) {
+        return +val.reduce((acc, curr) => +acc + +curr, 0).toFixed(toFixed);
+    }
+}
+exports.ArrayHelper = ArrayHelper;
+//# sourceMappingURL=array.helper.js.map

package/lib/utils/array.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.helper.js","sourceRoot":"","sources":["../../src/utils/array.helper.ts"],"names":[],"mappings":";;;AACA,MAAa,WAAW;IAEvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAI,GAAQ;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAI,GAAQ;QAC7B,OAAO,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,GAAa,EAAE,OAAO,GAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CACD;AA9BD,kCA8BC"}

package/lib/utils/date.helper.d.ts

@@ -0,0 +1,97 @@
+import { DateTime, WeekdayNumbers } from 'luxon';
+import { Appointment, Period, WeekDay } from '../calendar';
+export declare class DateHelper {
+    /**
+     * Is date between start and end dates
+     * @param date Date
+     * @param start Date
+     * @param end Date
+     * @returns
+     */
+    static isBetween(date: Date, start: Date, end: Date): boolean;
+    /**
+     * Converts a Date to a date-only string in the format "YYYY-MM-DD".
+     * @param date Given date
+     * @returns Date string
+     */
+    static toDateOnly(date: Date): string;
+    /**
+     * Converts a Date to a time-only string in the format "HH:MM:SS.sssZ".
+     * @param date Given date
+     * @returns Time string
+     */
+    static toTimeOnly(date: Date): string;
+    /**
+     * Get DateTime instance from Date
+     * @param date
+     * @returns DateTime
+     */
+    static toDateTimeInstance(date: Date): DateTime;
+    /**
+     * Check if date is start of day
+     * @param date Given date
+     * @returns True if date is start of day
+     */
+    static isStartOfDay(date: Date): boolean;
+    /**
+     * Check if date is end of day
+     * @param date Given date
+     * @returns True if date is end of day
+     */
+    static isEndOfDay(date: Date): boolean;
+    /**
+     * Converts a number to a WeekdayNumbers enum from luxon.
+     * @param val
+     * @returns
+     */
+    static toWeekdayNumber(val: number): WeekdayNumbers;
+    /**
+     * Converts a WeekDay enum from intelact/driveup to a WeekdayNumbers enum from luxon.
+     * @param Weekday - The weekday to convert
+     * @returns WeekdayNumbers from luxon - 1 to 7
+     */
+    static getWeekdayNumber(weekday: WeekDay): WeekdayNumbers;
+    /**
+     * Get WeekDay from DateTime
+     * @param date
+     * @returns WeekDay
+     */
+    static getWeekday(date: DateTime): WeekDay;
+    /**
+     * Converts a WeekDay enum from intelact/driveup to a MySQL weekday number.
+     * @param Weekday - The weekday to convert
+     * @returns number - MySQL weekday number (0 = Monday, 6 = Sunday)
+     */
+    static getMySqlWeekday(weekday: WeekDay): number;
+    /**
+     * Merge periods
+     * @param Period[]
+     * @returns Period[] - Returns an array of merged periods
+     */
+    static mergePeriods(periods: Period[]): Period[];
+    /**
+     * Merge appointment periods
+     * @param Appointment[]
+     * @returns Appointment[] - Returns an array of merged appointments
+     */
+    static mergeAppointmentPeriods(appointments: Appointment[]): Appointment[];
+    /**
+     * Get a formatted date string in "DD MMM YYYY" format,
+     * or an empty string if the given date is invalid.
+     * Example: "23 Oct 2025"
+     * @param date string | number | Date
+     * @param local Default en-GB
+     * @returns Formatted date string
+     */
+    static formatDate(date: string | number | Date, local?: string): string;
+    /**
+     * Get a formatted date and time string in "DD MMM YYYY - HH:MM" format,
+     * or an empty string if the given date is invalid.
+     * Example: "23 Oct 2025 - 14:30"
+     * @param date string | number | Date
+     * @param seperator Default '-'
+     * @param local Default en-GB
+     * @returns Formatted date and time string
+     */
+    static formatDateAndTime(date: string | number | Date, seperator?: string, local?: string): string;
+}

package/lib/utils/date.helper.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateHelper = void 0;
+const luxon_1 = require("luxon");
+const calendar_1 = require("../calendar");
+class DateHelper {
+    /**
+     * Is date between start and end dates
+     * @param date Date
+     * @param start Date
+     * @param end Date
+     * @returns
+     */
+    static isBetween(date, start, end) {
+        return date.getTime() >= start.getTime() && date.getTime() <= end.getTime();
+    }
+    /**
+     * Converts a Date to a date-only string in the format "YYYY-MM-DD".
+     * @param date Given date
+     * @returns Date string
+     */
+    static toDateOnly(date) {
+        return date.toISOString().split('T')[0];
+    }
+    ;
+    /**
+     * Converts a Date to a time-only string in the format "HH:MM:SS.sssZ".
+     * @param date Given date
+     * @returns Time string
+     */
+    static toTimeOnly(date) {
+        return date.toISOString().split('T')[1];
+    }
+    ;
+    /**
+     * Get DateTime instance from Date
+     * @param date
+     * @returns DateTime
+     */
+    static toDateTimeInstance(date) {
+        const dt = luxon_1.DateTime.fromJSDate(date);
+        return dt.isValid ? dt : null;
+    }
+    /**
+     * Check if date is start of day
+     * @param date Given date
+     * @returns True if date is start of day
+     */
+    static isStartOfDay(date) {
+        return (date.getHours() === 0 &&
+            date.getMinutes() === 0 &&
+            date.getSeconds() === 0 &&
+            date.getMilliseconds() === 0);
+    }
+    /**
+     * Check if date is end of day
+     * @param date Given date
+     * @returns True if date is end of day
+     */
+    static isEndOfDay(date) {
+        return (date.getHours() === 23 &&
+            date.getMinutes() === 59 &&
+            date.getSeconds() === 59 &&
+            date.getMilliseconds() === 999);
+    }
+    /**
+     * Converts a number to a WeekdayNumbers enum from luxon.
+     * @param val
+     * @returns
+     */
+    static toWeekdayNumber(val) {
+        return (val === 1 ? 1
+            : val === 2 ? 2
+                : val === 3 ? 3
+                    : val === 4 ? 4
+                        : val === 5 ? 5
+                            : val === 6 ? 6
+                                : val === 7 ? 7
+                                    : undefined);
+    }
+    ;
+    /**
+     * Converts a WeekDay enum from intelact/driveup to a WeekdayNumbers enum from luxon.
+     * @param Weekday - The weekday to convert
+     * @returns WeekdayNumbers from luxon - 1 to 7
+     */
+    static getWeekdayNumber(weekday) {
+        return (weekday === calendar_1.WeekDay.Monday ? 1
+            : weekday === calendar_1.WeekDay.Tuesday ? 2
+                : weekday === calendar_1.WeekDay.Wednesday ? 3
+                    : weekday === calendar_1.WeekDay.Thursday ? 4
+                        : weekday === calendar_1.WeekDay.Friday ? 5
+                            : weekday === calendar_1.WeekDay.Saturday ? 6
+                                : 7 // Sunday
+        );
+    }
+    /**
+     * Get WeekDay from DateTime
+     * @param date
+     * @returns WeekDay
+     */
+    static getWeekday(date) {
+        const number = date.weekday;
+        return (number === 1 ? calendar_1.WeekDay.Monday
+            : number === 2 ? calendar_1.WeekDay.Tuesday
+                : number === 3 ? calendar_1.WeekDay.Wednesday
+                    : number === 4 ? calendar_1.WeekDay.Thursday
+                        : number === 5 ? calendar_1.WeekDay.Friday
+                            : number === 6 ? calendar_1.WeekDay.Saturday
+                                : calendar_1.WeekDay.Sunday);
+    }
+    /**
+     * Converts a WeekDay enum from intelact/driveup to a MySQL weekday number.
+     * @param Weekday - The weekday to convert
+     * @returns number - MySQL weekday number (0 = Monday, 6 = Sunday)
+     */
+    static getMySqlWeekday(weekday) {
+        return (weekday === calendar_1.WeekDay.Monday ? 0
+            : weekday === calendar_1.WeekDay.Tuesday ? 1
+                : weekday === calendar_1.WeekDay.Wednesday ? 2
+                    : weekday === calendar_1.WeekDay.Thursday ? 3
+                        : weekday === calendar_1.WeekDay.Friday ? 4
+                            : weekday === calendar_1.WeekDay.Saturday ? 5
+                                : 6 // Sunday
+        );
+    }
+    /**
+     * Merge periods
+     * @param Period[]
+     * @returns Period[] - Returns an array of merged periods
+     */
+    static mergePeriods(periods) {
+        if (!periods?.length)
+            return [];
+        periods.sort((a, b) => a.startDate.getTime() - b.startDate.getTime());
+        const merged = [];
+        for (const period of periods) {
+            // if this is the first itteration of the loop, add the period to the reslult array
+            if (!merged.length) {
+                merged.push(period);
+                continue;
+            }
+            const last = merged[merged.length - 1];
+            // if the period overlaps with the last one, merge them
+            if (period.startDate <= last.endDate) {
+                last.endDate = last.endDate > period.endDate ? last.endDate : period.endDate;
+            }
+            else {
+                merged.push(period);
+            }
+        }
+        return merged;
+    }
+    /**
+     * Merge appointment periods
+     * @param Appointment[]
+     * @returns Appointment[] - Returns an array of merged appointments
+     */
+    static mergeAppointmentPeriods(appointments) {
+        if (!appointments?.length)
+            return [];
+        appointments.sort((a, b) => new Date(a.startDate).getTime() - new Date(b.startDate).getTime());
+        const merged = [];
+        for (const appointment of appointments) {
+            // if this is the first itteration of the loop, add the period to the reslult array
+            if (!merged.length) {
+                merged.push(appointment);
+                continue;
+            }
+            // if the period overlaps with the last period in the array, merge them
+            const last = merged[merged.length - 1];
+            if (new Date(appointment.startDate) <= new Date(last.endDate)) {
+                last.endDate =
+                    last.endDate > appointment.endDate ? last.endDate : appointment.endDate;
+            }
+            else {
+                merged.push(appointment);
+            }
+        }
+        return merged;
+    }
+    /**
+     * Get a formatted date string in "DD MMM YYYY" format,
+     * or an empty string if the given date is invalid.
+     * Example: "23 Oct 2025"
+     * @param date string | number | Date
+     * @param local Default en-GB
+     * @returns Formatted date string
+     */
+    static formatDate(date, local = 'en-GB') {
+        if (!date)
+            return '';
+        return new Date(date).toLocaleDateString(local, {
+            day: 'numeric',
+            month: 'short',
+            year: 'numeric'
+        });
+    }
+    /**
+     * Get a formatted date and time string in "DD MMM YYYY - HH:MM" format,
+     * or an empty string if the given date is invalid.
+     * Example: "23 Oct 2025 - 14:30"
+     * @param date string | number | Date
+     * @param seperator Default '-'
+     * @param local Default en-GB
+     * @returns Formatted date and time string
+     */
+    static formatDateAndTime(date, seperator = '-', local = 'en-GB') {
+        if (!date)
+            return '';
+        const dateObj = new Date(date);
+        const datePart = dateObj.toLocaleDateString(local, {
+            day: 'numeric',
+            month: 'short',
+            year: 'numeric'
+        });
+        const timePart = dateObj.toLocaleTimeString(local, {
+            hour: '2-digit',
+            minute: '2-digit',
+            hour12: false
+        });
+        return `${datePart} ${seperator} ${timePart}`;
+    }
+}
+exports.DateHelper = DateHelper;
+//# sourceMappingURL=date.helper.js.map

package/lib/utils/date.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.helper.js","sourceRoot":"","sources":["../../src/utils/date.helper.ts"],"names":[],"mappings":"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"}

package/lib/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './array.helper';
+export * from './date.helper';
+export * from './phone.helper';

package/lib/utils/index.js

@@ -0,0 +1,20 @@
+"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("./array.helper"), exports);
+__exportStar(require("./date.helper"), exports);
+__exportStar(require("./phone.helper"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,gDAA8B;AAC9B,iDAA+B"}

package/lib/utils/phone.helper.d.ts

@@ -0,0 +1,9 @@
+export declare class PhoneHelper {
+    /**
+     * Extracts the country code from a given phone number string.
+     * @param phoneNumber - The phone number string to extract the country code from.
+     * @param prefix - The prefix to prepend to the extracted country code. Default is '+'.
+     * @returns The extracted country code with the specified prefix, or null if not found.
+     */
+    static extractCountryCode(phoneNumber: string, prefix?: string): string;
+}

package/lib/utils/phone.helper.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhoneHelper = void 0;
+class PhoneHelper {
+    /**
+     * Extracts the country code from a given phone number string.
+     * @param phoneNumber - The phone number string to extract the country code from.
+     * @param prefix - The prefix to prepend to the extracted country code. Default is '+'.
+     * @returns The extracted country code with the specified prefix, or null if not found.
+     */
+    static extractCountryCode(phoneNumber, prefix = '+') {
+        const match = /^\+(\d{1,4})/.exec(phoneNumber);
+        return match ? prefix + match[1] : null;
+    }
+}
+exports.PhoneHelper = PhoneHelper;
+//# sourceMappingURL=phone.helper.js.map

package/lib/utils/phone.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.helper.js","sourceRoot":"","sources":["../../src/utils/phone.helper.ts"],"names":[],"mappings":";;;AACA,MAAa,WAAW;IAEvB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAmB,EAAE,MAAM,GAAG,GAAG;QAC1D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;CACD;AAZD,kCAYC"}

package/lib/validators/compare.validator.d.ts

@@ -0,0 +1,9 @@
+import { ValidationArguments, ValidatorConstraintInterface } from "class-validator";
+/**
+ * Checks if the start date is less than or equal to the end date
+ * If one of the does not have a valid value, returns true
+ */
+export declare class CompareWithEndDate implements ValidatorConstraintInterface {
+    validate(startDate: Date, args: ValidationArguments): boolean;
+    defaultMessage(args?: ValidationArguments): string;
+}