@intelact/driveup 1.4.44 → 1.5.2

package/lib/utils/array.helper.js

@@ -8,7 +8,7 @@ class ArrayHelper {
      * @returns Given T type
      */
     static getRandom(val) {
-        const randomIndex = Math.floor(Math.random() * this.length);
+        const randomIndex = Math.floor(Math.random() * val.length);
         return val[randomIndex];
     }
     /**
@@ -17,7 +17,7 @@ class ArrayHelper {
      * @returns Given T type
      */
     static getLastItem(val) {
-        return val?.length ? val[this.length - 1] : undefined;
+        return val?.length ? val[val.length - 1] : undefined;
     }
     /**
      * Sum all numbers in a number array

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

@@ -1 +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"}
+{"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;CACD;AA9BD,kCA8BC"}

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;AAGjC;;;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

@@ -1,6 +1,35 @@
 import { DateTime, WeekdayNumbers } from 'luxon';
-import { Appointment, Period, WeekDay } from '../calendar';
+import { WeekDay } from '../types';
+import { Appointment, Period } from '../calendar';
 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

package/lib/utils/date.helper.js

@@ -2,8 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DateHelper = void 0;
 const luxon_1 = require("luxon");
-const calendar_1 = require("../calendar");
+const types_1 = require("../types");
 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
@@ -85,12 +124,12 @@ class DateHelper {
      * @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
+        return (weekday === types_1.WeekDay.Monday ? 1
+            : weekday === types_1.WeekDay.Tuesday ? 2
+                : weekday === types_1.WeekDay.Wednesday ? 3
+                    : weekday === types_1.WeekDay.Thursday ? 4
+                        : weekday === types_1.WeekDay.Friday ? 5
+                            : weekday === types_1.WeekDay.Saturday ? 6
                                 : 7 // Sunday
         );
     }
@@ -101,13 +140,13 @@ class DateHelper {
      */
     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);
+        return (number === 1 ? types_1.WeekDay.Monday
+            : number === 2 ? types_1.WeekDay.Tuesday
+                : number === 3 ? types_1.WeekDay.Wednesday
+                    : number === 4 ? types_1.WeekDay.Thursday
+                        : number === 5 ? types_1.WeekDay.Friday
+                            : number === 6 ? types_1.WeekDay.Saturday
+                                : types_1.WeekDay.Sunday);
     }
     /**
      * Converts a WeekDay enum from intelact/driveup to a MySQL weekday number.
@@ -115,12 +154,12 @@ class DateHelper {
      * @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
+        return (weekday === types_1.WeekDay.Monday ? 0
+            : weekday === types_1.WeekDay.Tuesday ? 1
+                : weekday === types_1.WeekDay.Wednesday ? 2
+                    : weekday === types_1.WeekDay.Thursday ? 3
+                        : weekday === types_1.WeekDay.Friday ? 4
+                            : weekday === types_1.WeekDay.Saturday ? 5
                                 : 6 // Sunday
         );
     }

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

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

@@ -1,3 +1,6 @@
 export * from './array.helper';
+export * from './compare.validator';
 export * from './date.helper';
 export * from './phone.helper';
+export * from './required.validator';
+export * from './transformers.helper';

package/lib/utils/index.js

@@ -15,6 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./array.helper"), exports);
+__exportStar(require("./compare.validator"), exports);
 __exportStar(require("./date.helper"), exports);
 __exportStar(require("./phone.helper"), exports);
+__exportStar(require("./required.validator"), exports);
+__exportStar(require("./transformers.helper"), exports);
 //# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

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

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;

package/lib/utils/required.validator.js

@@ -0,0 +1,151 @@
+"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.EitherRequiredConstraint = exports.MutuallyRequiredConstraint = void 0;
+exports.MutuallyRequired = MutuallyRequired;
+exports.EitherRequired = EitherRequired;
+const class_validator_1 = require("class-validator");
+/**
+ * Validator constraint that ensures two fields are both empty or both filled
+ * Used for mutually dependent fields that should be set together
+ */
+let MutuallyRequiredConstraint = class MutuallyRequiredConstraint {
+    /**
+     * 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, args) {
+        const dto = args.object;
+        const relatedField = args.constraints[0]; // field name passed in the decorator
+        const relatedValue = dto[relatedField];
+        if (!value && !relatedValue) {
+            // Both are empty: validation passes
+            return true;
+        }
+        if (value && relatedValue) {
+            // Both fields set: validation passes
+            return true;
+        }
+        // One field has a value but the other does not. validation fails
+        return false;
+    }
+    /**
+     * Returns the default error message when validation fails
+     * @param args - Validation arguments
+     * @returns Error message string
+     */
+    defaultMessage(args) {
+        return `${args.property} cannot be null if ${args.constraints[0]} is provided`;
+    }
+};
+exports.MutuallyRequiredConstraint = MutuallyRequiredConstraint;
+exports.MutuallyRequiredConstraint = MutuallyRequiredConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({
+        name: 'MutuallyRequired',
+        async: false
+    })
+], MutuallyRequiredConstraint);
+/**
+ * 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;
+ * }
+ * ```
+ */
+function MutuallyRequired(relatedField, validationOptions) {
+    return function (object, propertyName) {
+        (0, class_validator_1.registerDecorator)({
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [relatedField], // This should be dynamic
+            validator: MutuallyRequiredConstraint
+        });
+    };
+}
+/**
+ * Validator constraint that ensures at least one of two fields has a value
+ * Used for fields where at least one must be provided
+ */
+let EitherRequiredConstraint = class EitherRequiredConstraint {
+    /**
+     * 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, args) {
+        const dto = args.object;
+        const relatedField = args.constraints[0]; // field name passed in the decorator
+        const relatedValue = dto[relatedField];
+        if (value || relatedValue) {
+            // One has value: validation passes
+            return true;
+        }
+        // Neither has value: validation fails
+        return false;
+    }
+    /**
+     * Returns the default error message when validation fails
+     * @param args - Validation arguments
+     * @returns Error message string
+     */
+    defaultMessage(args) {
+        return `${args.property} cannot be empty if ${args.constraints[0]} is also empty`;
+    }
+};
+exports.EitherRequiredConstraint = EitherRequiredConstraint;
+exports.EitherRequiredConstraint = EitherRequiredConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({
+        name: 'EitherRequired',
+        async: false
+    })
+], EitherRequiredConstraint);
+/**
+ * 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;
+ * }
+ * ```
+ */
+function EitherRequired(relatedField, validationOptions) {
+    return function (object, propertyName) {
+        (0, class_validator_1.registerDecorator)({
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            constraints: [relatedField], // This should be dynamic
+            validator: EitherRequiredConstraint
+        });
+    };
+}
+//# sourceMappingURL=required.validator.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Transforms a value to an array of numbers
+ * Handles comma-separated strings, single values, and arrays
+ * Filters out NaN values
+ * @returns A class-transformer decorator
+ */
+export declare function ToNumberArray(): PropertyDecorator;
+/**
+ * Transforms a value to an array of strings
+ * Handles comma-separated strings, single values, and arrays
+ * Trims and filters out empty strings
+ * @returns A class-transformer decorator
+ */
+export declare function ToStringArray(): PropertyDecorator;
+/**
+ * Transforms a value to an enum type
+ * Matches by value or key (case-insensitive)
+ * @template E - The enum type
+ * @param enumType - The enum object to transform to
+ * @returns A class-transformer decorator
+ */
+export declare function ToEnum<E extends object>(enumType: E): PropertyDecorator;
+/**
+ * Transforms a value to an array of enum values
+ * Matches by value or key (case-insensitive)
+ * @template E - The enum type
+ * @param enumType - The enum object to transform to
+ * @returns A class-transformer decorator
+ */
+export declare function ToEnumArray<E extends object>(enumType: E): PropertyDecorator;
+/**
+ * Transforms a value to a number
+ * Returns original value if conversion results in NaN
+ * @returns A class-transformer decorator
+ */
+export declare function ToNumber(): PropertyDecorator;
+/**
+ * Trims whitespace from string values
+ * Returns non-string values unchanged
+ * @returns A class-transformer decorator
+ */
+export declare function Trim(): PropertyDecorator;
+/**
+ * Transforms a value to a boolean
+ * Handles string values ('true', 'false', '1', '0') and numeric values (1, 0)
+ * @returns A class-transformer decorator
+ */
+export declare function ToBoolean(): PropertyDecorator;