@intelact/driveup 2.4.5 → 2.4.6

package/lib/utils/array.helper.js

@@ -0,0 +1,42 @@
+"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() * val.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[val.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);
+    }
+    /**
+     * Get the average number in a number array
+     * @param val Number[]
+     * @param toFixed (2)
+     * @returns Average number
+     */
+    static getAvg(val, toFixed = 2) {
+        return +(ArrayHelper.getSum(val) / val.length).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":";;;AAAA,MAAa,WAAW;IAEvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAI,GAAQ;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3D,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,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,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;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,GAAa,EAAE,OAAO,GAAC,CAAC;QACrC,OAAO,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;CACD;AAxCD,kCAwCC"}

package/lib/utils/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;
+}

package/lib/utils/compare.validator.js

@@ -0,0 +1,35 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompareWithEndDate = void 0;
+const class_validator_1 = require("class-validator");
+const luxon_1 = require("luxon");
+/**
+ * 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
+ */
+let CompareWithEndDate = class CompareWithEndDate {
+    // startDate must be there before the args param, 
+    // if it's not there the args will be treated as the startDate and we won't have access to the object
+    validate(startDate, args) {
+        const dto = args.object;
+        // no validation is performed if either is not provided
+        if (!luxon_1.DateTime.fromJSDate(dto.startDate).isValid ||
+            !luxon_1.DateTime.fromJSDate(dto.endDate).isValid)
+            return true;
+        return dto.startDate < dto.endDate;
+    }
+    defaultMessage(args) {
+        return 'start date cannot be greater than end date';
+    }
+};
+exports.CompareWithEndDate = CompareWithEndDate;
+exports.CompareWithEndDate = CompareWithEndDate = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'CompareWithEndDate', async: false })
+], CompareWithEndDate);
+//# sourceMappingURL=compare.validator.js.map

package/lib/utils/compare.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.validator.js","sourceRoot":"","sources":["../../src/utils/compare.validator.ts"],"names":[],"mappings":";;;;;;;;;AAAA,qDAAyG;AACzG,iCAAiC;AAEjC;;;GAGG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC9B,kDAAkD;IAClD,qGAAqG;IACrG,QAAQ,CAAC,SAAe,EAAE,IAAyB;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAgB,CAAC;QAElC,uDAAuD;QACvD,IACC,CAAC,gBAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO;YAC3C,CAAC,gBAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO;YAEzC,OAAO,IAAI,CAAC;QAEb,OAAO,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,cAAc,CAAC,IAA0B;QACxC,OAAO,4CAA4C,CAAC;IACrD,CAAC;CACD,CAAA;AAnBY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,qCAAmB,EAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GACrD,kBAAkB,CAmB9B"}

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

@@ -0,0 +1,127 @@
+import { WeekDay } from '@driveup/shared';
+import { DateTime, WeekdayNumbers } from 'luxon';
+import { Appointment } from "../calendar/appointment";
+import { Period } from "../calendar/date";
+export declare class DateHelper {
+    /**
+     * Set timezone to date
+     * @param date Date
+     * @param timezone string
+     * @returns Date
+     */
+    static setTimezone(date: Date, timezone: string): Date;
+    /**
+     * Format like 'October 14, 1983'
+     * @param date Date
+     * @param timezone string
+     * @returns string
+     */
+    static toLocalDate(date: Date, timezone?: string): string;
+    /**
+     * Format like 'Oct 14, 1983, 9:30 AM'. Only 12-hour if the locale is.
+     * @param date Date
+     * @param timezone string
+     * @returns string
+     */
+    static toLocalDateTime(date: Date, timezone?: string): string;
+    /**
+     * Format like 'Fri, 14 Oct 1983, 9:30 AM'. Only 12-hour if the locale is.
+     * @param date Date
+     * @param timezone string
+     * @returns string
+     */
+    static toLocalWeekDayAndDateTime(date: Date, timezone?: string): string;
+    /**
+     * 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 de
+     * @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 de
+     * @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,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateHelper = void 0;
+const shared_1 = require("@driveup/shared");
+const luxon_1 = require("luxon");
+class DateHelper {
+    /**
+     * Set timezone to date
+     * @param date Date
+     * @param timezone string
+     * @returns Date
+     */
+    static setTimezone(date, timezone) {
+        return date = luxon_1.DateTime.fromJSDate(date, { zone: timezone }).toJSDate();
+    }
+    /**
+     * Format like 'October 14, 1983'
+     * @param date Date
+     * @param timezone string
+     * @returns string
+     */
+    static toLocalDate(date, timezone) {
+        date = timezone ? DateHelper.setTimezone(date, timezone) : date;
+        return date ? luxon_1.DateTime.fromJSDate(date).toLocaleString(luxon_1.DateTime.DATE_FULL) : '';
+    }
+    /**
+     * Format like 'Oct 14, 1983, 9:30 AM'. Only 12-hour if the locale is.
+     * @param date Date
+     * @param timezone string
+     * @returns string
+     */
+    static toLocalDateTime(date, timezone) {
+        date = timezone ? DateHelper.setTimezone(date, timezone) : date;
+        return date ? luxon_1.DateTime.fromJSDate(date).toLocaleString(luxon_1.DateTime.DATETIME_MED) : '';
+    }
+    /**
+     * Format like 'Fri, 14 Oct 1983, 9:30 AM'. Only 12-hour if the locale is.
+     * @param date Date
+     * @param timezone string
+     * @returns string
+     */
+    static toLocalWeekDayAndDateTime(date, timezone) {
+        date = timezone ? DateHelper.setTimezone(date, timezone) : date;
+        return date ? luxon_1.DateTime.fromJSDate(date).toLocaleString(luxon_1.DateTime.DATETIME_MED_WITH_WEEKDAY) : '';
+    }
+    /**
+     * 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 === shared_1.WeekDay.Monday ? 1
+            : weekday === shared_1.WeekDay.Tuesday ? 2
+                : weekday === shared_1.WeekDay.Wednesday ? 3
+                    : weekday === shared_1.WeekDay.Thursday ? 4
+                        : weekday === shared_1.WeekDay.Friday ? 5
+                            : weekday === shared_1.WeekDay.Saturday ? 6
+                                : 7 // Sunday
+        );
+    }
+    /**
+     * Get WeekDay from DateTime
+     * @param date
+     * @returns WeekDay
+     */
+    static getWeekday(date) {
+        const number = date.weekday;
+        return (number === 1 ? shared_1.WeekDay.Monday
+            : number === 2 ? shared_1.WeekDay.Tuesday
+                : number === 3 ? shared_1.WeekDay.Wednesday
+                    : number === 4 ? shared_1.WeekDay.Thursday
+                        : number === 5 ? shared_1.WeekDay.Friday
+                            : number === 6 ? shared_1.WeekDay.Saturday
+                                : shared_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 === shared_1.WeekDay.Monday ? 0
+            : weekday === shared_1.WeekDay.Tuesday ? 1
+                : weekday === shared_1.WeekDay.Wednesday ? 2
+                    : weekday === shared_1.WeekDay.Thursday ? 3
+                        : weekday === shared_1.WeekDay.Friday ? 4
+                            : weekday === shared_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 de
+     * @returns Formatted date string
+     */
+    static formatDate(date, local = shared_1.Language.De) {
+        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 de
+     * @returns Formatted date and time string
+     */
+    static formatDateAndTime(date, seperator = '-', local = shared_1.Language.De) {
+        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/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/utils/required.validator.d.ts

@@ -0,0 +1,77 @@
+import { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from "class-validator";
+/**
+ * Validator constraint that ensures two fields are both empty or both filled
+ * Used for mutually dependent fields that should be set together
+ */
+export declare class MutuallyRequiredConstraint implements ValidatorConstraintInterface {
+    /**
+     * Validates that both fields are either empty or both have values
+     * @param value - The value of the decorated field
+     * @param args - Validation arguments containing the related field name
+     * @returns True if both fields are empty or both have values, false otherwise
+     */
+    validate(value: any, args: ValidationArguments): boolean;
+    /**
+     * Returns the default error message when validation fails
+     * @param args - Validation arguments
+     * @returns Error message string
+     */
+    defaultMessage(args: ValidationArguments): string;
+}
+/**
+ * Decorator that checks if two fields are mutually empty or both with value
+ * Both fields must be either empty or filled together
+ *
+ * @param relatedField - The field name that needs to be checked with the decorated field
+ * @param validationOptions - Optional class-validator validation options
+ * @returns Property decorator function
+ *
+ * @example
+ * ```typescript
+ * class MyDto {
+ *   @MutuallyRequired('endDate')
+ *   startDate: Date;
+ *
+ *   endDate: Date;
+ * }
+ * ```
+ */
+export declare function MutuallyRequired(relatedField: string, validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;
+/**
+ * Validator constraint that ensures at least one of two fields has a value
+ * Used for fields where at least one must be provided
+ */
+export declare class EitherRequiredConstraint implements ValidatorConstraintInterface {
+    /**
+     * Validates that at least one of the two fields has a value
+     * @param value - The value of the decorated field
+     * @param args - Validation arguments containing the related field name
+     * @returns True if at least one field has a value, false if both are empty
+     */
+    validate(value: any, args: ValidationArguments): boolean;
+    /**
+     * Returns the default error message when validation fails
+     * @param args - Validation arguments
+     * @returns Error message string
+     */
+    defaultMessage(args: ValidationArguments): string;
+}
+/**
+ * Decorator that checks if at least one of two fields has a value
+ * At least one field must be provided
+ *
+ * @param relatedField - The field name that needs to be checked with the decorated field
+ * @param validationOptions - Optional class-validator validation options
+ * @returns Property decorator function
+ *
+ * @example
+ * ```typescript
+ * class MyDto {
+ *   @EitherRequired('email')
+ *   phone: string;
+ *
+ *   email: string;
+ * }
+ * ```
+ */
+export declare function EitherRequired(relatedField: string, validationOptions?: ValidationOptions): (object: Object, propertyName: string) => void;