itlab-internal-services 2.14.1 → 2.14.2

package/dist/functions/index.d.ts

@@ -1,4 +1,3 @@
 export { configureAxiosInstance } from './configure-axios-instance.function';
 export { createDuplicateChecker } from './create-duplicate-checker.function';
 export { createSchemaTransformer } from './create-schema-transformer.function';
-export {} from './string-like.functions';

package/dist/models/filter/limit.property.js

@@ -9,5 +9,5 @@ const transform_1 = require("../../transform");
  * Creates a PropertyLimitDecorator with the given options.
  */
 function PropertyLimit() {
-    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({ minimum: 0, default: 10, description: 'Die maximale Anzahl der Ergebnisse' }), (0, transform_1.TransformToNumber)({ default: 10, min: 0 }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.Min)(0));
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({ minimum: 0, default: 10, description: 'Die maximale Anzahl der Ergebnisse' }), (0, transform_1.NumberTransform)({ default: 10, min: 0 }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.Min)(0));
 }

package/dist/models/filter/skip.property.js

@@ -9,5 +9,5 @@ const transform_1 = require("../../transform");
  * Creates a PropertySkipDecorator with the given options.
  */
 function PropertySkip() {
-    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({ minimum: 0, default: 0, description: 'Die Anzahl der zu überspringenden Ergebnisse' }), (0, transform_1.TransformToNumber)({ default: 0, min: 0 }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.Min)(0));
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({ minimum: 0, default: 0, description: 'Die Anzahl der zu überspringenden Ergebnisse' }), (0, transform_1.NumberTransform)({ default: 0, min: 0 }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.Min)(0));
 }

package/dist/models/filter/sort-direction.property.js

@@ -15,5 +15,5 @@ function PropertySortDirection() {
             asc: { value: 1, summary: 'Aufsteigend' },
             desc: { value: -1, summary: 'Absteigend (Standard)' },
         },
-    }), (0, transform_1.TransformToNumber)({ default: -1, min: -1, max: 1 }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.IsIn)([-1, 1]));
+    }), (0, transform_1.NumberTransform)({ default: -1, min: -1, max: 1 }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.IsIn)([-1, 1]));
 }

package/dist/models/filter/sort-field.property.js

@@ -4,6 +4,7 @@ exports.PropertySortField = PropertySortField;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+const transform_1 = require("../../transform");
 /**
  * Creates a PropertySortFieldDecorator with the given options.
  */
@@ -12,5 +13,5 @@ function PropertySortField() {
         description: 'Das Feld, nach dem sortiert werden soll',
         default: '_id',
         example: 'title',
-    }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.MinLength)(1));
+    }), (0, transform_1.StringTransform)({ trim: true }), (0, class_validator_1.IsOptional)(), (0, class_validator_1.MinLength)(1));
 }

package/dist/models/thumbnail/alt.property.js

@@ -4,6 +4,7 @@ exports.ThumbnailAlt = ThumbnailAlt;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+const transform_1 = require("../../transform");
 /**
  * Creates a ThumbnailAltDecorator with the given options.
  *
@@ -13,7 +14,7 @@ const class_validator_1 = require("class-validator");
 function ThumbnailAlt(options = {}) {
     return (0, common_1.applyDecorators)(
     /** ApiProperty with the given options */
-    (0, swagger_1.ApiProperty)(Object.assign({ example: 'Eine Person mit einem Kissen' }, options)), 
+    (0, swagger_1.ApiProperty)(Object.assign({ example: 'Eine Person mit einem Kissen' }, options)), (0, transform_1.StringTransform)({ trim: true }), 
     /** Check if the length is at least 3 */
     (0, class_validator_1.MinLength)(3, { message: 'Der Alternativtext muss mindestens 3 Zeichen lang sein' }));
 }

package/dist/models/thumbnail/background.property.js

@@ -20,7 +20,7 @@ function ThumbnailBackground(options = {}) {
             Farbverlauf: { value: ['#e74c3c', '#c0392b'] },
         } }, options)), 
     /** Transform the string array */
-    (0, transform_1.TransformToStringArray)(), 
+    (0, transform_1.StringArrayTransform)({ trim: true }), 
     /** Check if the value is a HEX color */
     (0, class_validator_1.IsHexColor)({ each: true, message: 'Die Hintergrundfarbe muss eine HEX Farbe sein' }), 
     /** Check if the value is an array */

package/dist/models/thumbnail/contain.property.js

@@ -4,6 +4,7 @@ exports.ThumbnailContain = ThumbnailContain;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+const transform_1 = require("../../transform");
 /**
  * Creates a ThumbnailContainDecorator with the given options.
  *
@@ -13,7 +14,7 @@ const class_validator_1 = require("class-validator");
 function ThumbnailContain(options = {}) {
     return (0, common_1.applyDecorators)(
     /** ApiProperty with the given options */
-    (0, swagger_1.ApiProperty)(Object.assign({ description: 'Gibt an, ob das Bild gecroppt oder komplett angezeigt werden soll', example: false }, options)), 
+    (0, swagger_1.ApiProperty)(Object.assign({ description: 'Gibt an, ob das Bild gecroppt oder komplett angezeigt werden soll', example: false }, options)), (0, transform_1.BooleanTransform)(), 
     /** Check if the value is a boolean */
     (0, class_validator_1.IsBoolean)({ message: 'Contain muss als Boolean übergeben werden' }));
 }

package/dist/models/thumbnail/src.property.js

@@ -16,7 +16,7 @@ function ThumbnailSrc(options = {}) {
     /** ApiProperty with the given options */
     (0, swagger_1.ApiProperty)(Object.assign({ example: 'https://example.com/image' }, options)), 
     /** Transform the URL */
-    (0, transform_1.TransformToImageUrl)(), 
+    (0, transform_1.ImageUrlTransform)(), 
     /** Check if the URL starts with https */
     (0, class_validator_1.IsUrl)({ protocols: ['https'], require_protocol: true }, { message: 'Die URL muss mit https beginnen' }));
 }

package/dist/transform/{to-boolean.transform.d.ts → boolean.transform.d.ts}

@@ -1,6 +1,6 @@
 /**
  * Class-level comment block:
- * This module provides a property decorator function, TransformBoolean, which is used to convert
+ * This module provides a property decorator function, BooleanTransform, which is used to convert
  * various input types into boolean values. It handles strings, numbers, and boolean inputs,
  * ensuring they are correctly interpreted as true or false. This decorator is useful for
  * sanitizing and standardizing input data in class properties.
@@ -11,4 +11,4 @@
  *
  * @returns {PropertyDecorator} - A decorator function for transforming property values.
  */
-export declare function TransformToBoolean(): PropertyDecorator;
+export declare function BooleanTransform(): PropertyDecorator;

package/dist/transform/{to-boolean.transform.js → boolean.transform.js}

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToBoolean = TransformToBoolean;
+exports.BooleanTransform = BooleanTransform;
 const class_transformer_1 = require("class-transformer");
-const string_like_functions_1 = require("../functions/string-like.functions");
 /**
  * Class-level comment block:
- * This module provides a property decorator function, TransformBoolean, which is used to convert
+ * This module provides a property decorator function, BooleanTransform, which is used to convert
  * various input types into boolean values. It handles strings, numbers, and boolean inputs,
  * ensuring they are correctly interpreted as true or false. This decorator is useful for
  * sanitizing and standardizing input data in class properties.
@@ -16,12 +15,8 @@ const string_like_functions_1 = require("../functions/string-like.functions");
  *
  * @returns {PropertyDecorator} - A decorator function for transforming property values.
  */
-function TransformToBoolean() {
+function BooleanTransform() {
     return (0, class_transformer_1.Transform)(({ value }) => {
-        // Check if the value is string-like and trim it if necessary.
-        if ((0, string_like_functions_1.isStringLike)(value)) {
-            value = String((0, string_like_functions_1.trimStringLike)(value)).toLowerCase();
-        }
         // Convert the value to a boolean if it matches any of the true or false representations.
         if (value === true || value === 'true' || value === 1 || value === '1') {
             return true;

package/dist/transform/{to-image-url.transform.d.ts → image-url.transform.d.ts}

@@ -9,4 +9,4 @@
  *
  * @returns {PropertyDecorator} - A decorator function that transforms the property value.
  */
-export declare function TransformToImageUrl(): PropertyDecorator;
+export declare function ImageUrlTransform(): PropertyDecorator;

package/dist/transform/{to-image-url.transform.js → image-url.transform.js}

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToImageUrl = TransformToImageUrl;
+exports.ImageUrlTransform = ImageUrlTransform;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const itlab_functions_1 = require("itlab-functions");
-const string_like_functions_1 = require("../functions/string-like.functions");
 /**
  * Class-level comment:
  * This module provides a decorator function for transforming image URLs.
@@ -16,11 +15,11 @@ const string_like_functions_1 = require("../functions/string-like.functions");
  *
  * @returns {PropertyDecorator} - A decorator function that transforms the property value.
  */
-function TransformToImageUrl() {
+function ImageUrlTransform() {
     // Use the Transform decorator to apply the transformation logic to the property value.
     return (0, class_transformer_1.Transform)(({ value }) => {
         // Check if the value is a string. If so, trim and transform it into a cleaned image URL.
         // Otherwise, return the original value.
-        return (0, class_validator_1.isString)(value) ? (0, itlab_functions_1.transformImage)((0, string_like_functions_1.trimStringLike)(value)) : value;
+        return (0, class_validator_1.isString)(value) ? (0, itlab_functions_1.transformImage)(value.trim()) : value;
     });
 }

package/dist/transform/index.d.ts

@@ -1,8 +1,6 @@
-export { CastToArray } from './cast-to-array.transform';
-export { TransformToBoolean } from './to-boolean.transform';
-export { TransformToImageUrl } from './to-image-url.transform';
-export { TransformToNumber } from './to-number.transform';
-export { TransformToStringArray } from './to-string-array.transform';
-export { TransformToStringLike } from './to-string-like.transform';
-export { TransformToString } from './to-string.transform';
-export { TransformToTimestamp } from './to-timestamp.transform';
+export { BooleanTransform } from './boolean.transform';
+export { ImageUrlTransform } from './image-url.transform';
+export { NumberTransform } from './number.transform';
+export { StringArrayTransform } from './string-array.transform';
+export { StringTransform } from './string.transform';
+export { TimestampTransform } from './timestamp.transform';

package/dist/transform/index.js

@@ -1,19 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToTimestamp = exports.TransformToString = exports.TransformToStringLike = exports.TransformToStringArray = exports.TransformToNumber = exports.TransformToImageUrl = exports.TransformToBoolean = exports.CastToArray = void 0;
-var cast_to_array_transform_1 = require("./cast-to-array.transform");
-Object.defineProperty(exports, "CastToArray", { enumerable: true, get: function () { return cast_to_array_transform_1.CastToArray; } });
-var to_boolean_transform_1 = require("./to-boolean.transform");
-Object.defineProperty(exports, "TransformToBoolean", { enumerable: true, get: function () { return to_boolean_transform_1.TransformToBoolean; } });
-var to_image_url_transform_1 = require("./to-image-url.transform");
-Object.defineProperty(exports, "TransformToImageUrl", { enumerable: true, get: function () { return to_image_url_transform_1.TransformToImageUrl; } });
-var to_number_transform_1 = require("./to-number.transform");
-Object.defineProperty(exports, "TransformToNumber", { enumerable: true, get: function () { return to_number_transform_1.TransformToNumber; } });
-var to_string_array_transform_1 = require("./to-string-array.transform");
-Object.defineProperty(exports, "TransformToStringArray", { enumerable: true, get: function () { return to_string_array_transform_1.TransformToStringArray; } });
-var to_string_like_transform_1 = require("./to-string-like.transform");
-Object.defineProperty(exports, "TransformToStringLike", { enumerable: true, get: function () { return to_string_like_transform_1.TransformToStringLike; } });
-var to_string_transform_1 = require("./to-string.transform");
-Object.defineProperty(exports, "TransformToString", { enumerable: true, get: function () { return to_string_transform_1.TransformToString; } });
-var to_timestamp_transform_1 = require("./to-timestamp.transform");
-Object.defineProperty(exports, "TransformToTimestamp", { enumerable: true, get: function () { return to_timestamp_transform_1.TransformToTimestamp; } });
+exports.TimestampTransform = exports.StringTransform = exports.StringArrayTransform = exports.NumberTransform = exports.ImageUrlTransform = exports.BooleanTransform = void 0;
+var boolean_transform_1 = require("./boolean.transform");
+Object.defineProperty(exports, "BooleanTransform", { enumerable: true, get: function () { return boolean_transform_1.BooleanTransform; } });
+var image_url_transform_1 = require("./image-url.transform");
+Object.defineProperty(exports, "ImageUrlTransform", { enumerable: true, get: function () { return image_url_transform_1.ImageUrlTransform; } });
+var number_transform_1 = require("./number.transform");
+Object.defineProperty(exports, "NumberTransform", { enumerable: true, get: function () { return number_transform_1.NumberTransform; } });
+var string_array_transform_1 = require("./string-array.transform");
+Object.defineProperty(exports, "StringArrayTransform", { enumerable: true, get: function () { return string_array_transform_1.StringArrayTransform; } });
+var string_transform_1 = require("./string.transform");
+Object.defineProperty(exports, "StringTransform", { enumerable: true, get: function () { return string_transform_1.StringTransform; } });
+var timestamp_transform_1 = require("./timestamp.transform");
+Object.defineProperty(exports, "TimestampTransform", { enumerable: true, get: function () { return timestamp_transform_1.TimestampTransform; } });

package/dist/transform/{to-number.transform.d.ts → number.transform.d.ts}

@@ -17,5 +17,5 @@ interface NumberOptions {
  * @param {NumberOptions} opts - Options to configure the transformation.
  * @returns {PropertyDecorator} - A decorator function for property transformation.
  */
-export declare function TransformToNumber(opts?: NumberOptions): PropertyDecorator;
+export declare function NumberTransform(opts?: NumberOptions): PropertyDecorator;
 export {};

package/dist/transform/{to-number.transform.js → number.transform.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToNumber = TransformToNumber;
+exports.NumberTransform = NumberTransform;
 const class_transformer_1 = require("class-transformer");
 /**
  * Transforms the input value into a number, applying constraints such as default,
@@ -10,7 +10,7 @@ const class_transformer_1 = require("class-transformer");
  * @param {NumberOptions} opts - Options to configure the transformation.
  * @returns {PropertyDecorator} - A decorator function for property transformation.
  */
-function TransformToNumber(opts = {}) {
+function NumberTransform(opts = {}) {
     return (0, class_transformer_1.Transform)(({ value }) => {
         // Attempt to parse the value as an integer, using the default if necessary
         let parsedNumber = Number.parseInt(value || String(opts.default), 10);

package/dist/transform/string-array.transform.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interface defining options for transforming string arrays.
+ */
+interface StringArrayOptions {
+    trim?: boolean;
+    unique?: boolean;
+}
+/**
+ * Transforms an array of values into an array of strings, applying options such as trimming and uniqueness.
+ *
+ * @param {StringArrayOptions} opts - Options for transformation including trimming and ensuring uniqueness.
+ * @returns {PropertyDecorator} - A decorator function for transforming the property value.
+ */
+export declare function StringArrayTransform(opts?: StringArrayOptions): PropertyDecorator;
+export {};

package/dist/transform/string-array.transform.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringArrayTransform = StringArrayTransform;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Transforms an array of values into an array of strings, applying options such as trimming and uniqueness.
+ *
+ * @param {StringArrayOptions} opts - Options for transformation including trimming and ensuring uniqueness.
+ * @returns {PropertyDecorator} - A decorator function for transforming the property value.
+ */
+function StringArrayTransform(opts = {}) {
+    return (0, class_transformer_1.Transform)(({ value }) => {
+        // If the value is not an array, return it unchanged
+        if (!(0, class_validator_1.isArray)(value))
+            return value;
+        const stringArray = value.map((element) => {
+            const str = String(element);
+            return opts.trim ? str.trim() : str;
+        });
+        // Ensure uniqueness if specified
+        if (opts.unique) {
+            return [...new Set(stringArray)];
+        }
+        return stringArray;
+    });
+}

package/dist/transform/{to-string.transform.d.ts → string.transform.d.ts}

@@ -1,10 +1,13 @@
 /**
  * Class-level comment:
- * The TransformToString function is a property decorator designed to consistently format string properties in a class.
+ * The StringTransform function is a property decorator designed to consistently format string properties in a class.
  * It checks if the input value is a string and applies transformations such as trimming, converting to lowercase, or uppercase.
  * If the input is not a string, it returns the original value unchanged.
  * This decorator ensures that string properties adhere to specified formatting options.
  */
+/**
+ * Interface defining options for transforming strings.
+ */
 interface StringOptions {
     trim?: boolean;
     lowercase?: boolean;
@@ -17,5 +20,5 @@ interface StringOptions {
  * @param {StringOptions} opts - Options to specify string transformations (trim, lowercase, uppercase).
  * @returns {PropertyDecorator} - A decorator function that applies the specified transformations.
  */
-export declare function TransformToString(opts?: StringOptions): PropertyDecorator;
+export declare function StringTransform(opts?: StringOptions): PropertyDecorator;
 export {};

package/dist/transform/{to-string.transform.js → string.transform.js}

@@ -1,9 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToString = TransformToString;
+exports.StringTransform = StringTransform;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const string_like_functions_1 = require("../functions/string-like.functions");
 /**
  * Transforms the input value to a formatted string based on provided options.
  * If the value is not a string, it returns the original value.
@@ -11,7 +10,7 @@ const string_like_functions_1 = require("../functions/string-like.functions");
  * @param {StringOptions} opts - Options to specify string transformations (trim, lowercase, uppercase).
  * @returns {PropertyDecorator} - A decorator function that applies the specified transformations.
  */
-function TransformToString(opts = {}) {
+function StringTransform(opts = {}) {
     return (0, class_transformer_1.Transform)(({ value }) => {
         // Check if the value is a string; if not, return it unchanged
         if (!(0, class_validator_1.isString)(value))
@@ -20,7 +19,7 @@ function TransformToString(opts = {}) {
         let formattedString = String(value);
         // Apply transformations based on options
         if (opts.trim)
-            formattedString = (0, string_like_functions_1.trimStringLike)(formattedString);
+            formattedString = formattedString.trim();
         if (opts.lowercase)
             formattedString = formattedString.toLowerCase();
         if (opts.uppercase)

package/dist/transform/{to-timestamp.transform.d.ts → timestamp.transform.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Interface defining options for number transformation.
+ * Interface defining options for timestamp transformation.
  */
 interface NumberOptions {
     /** Default value if the provided value is not a number */
@@ -20,5 +20,5 @@ interface NumberOptions {
  * @param {NumberOptions} opts - Options for transformation including default value, min/max bounds, and rounding unit.
  * @returns {PropertyDecorator} - A decorator function for transforming the property value.
  */
-export declare function TransformToTimestamp(opts?: NumberOptions): PropertyDecorator;
+export declare function TimestampTransform(opts?: NumberOptions): PropertyDecorator;
 export {};

package/dist/transform/{to-timestamp.transform.js → timestamp.transform.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToTimestamp = TransformToTimestamp;
+exports.TimestampTransform = TimestampTransform;
 const class_transformer_1 = require("class-transformer");
 /**
  * Transforms a value into a number, applying constraints and rounding options.
@@ -11,7 +11,7 @@ const class_transformer_1 = require("class-transformer");
  * @param {NumberOptions} opts - Options for transformation including default value, min/max bounds, and rounding unit.
  * @returns {PropertyDecorator} - A decorator function for transforming the property value.
  */
-function TransformToTimestamp(opts = {}) {
+function TimestampTransform(opts = {}) {
     return (0, class_transformer_1.Transform)(({ value }) => {
         // Parse the value as an integer, using the default if value is not provided
         let parsedNumber = Number.parseInt(value || String(opts.default), 10);

package/package.json

@@ -5,7 +5,7 @@
     "email": "timo.scheuermann@sv-informatik.de",
     "url": "https://timos.design"
   },
-  "version": "2.14.1",
+  "version": "2.14.2",
   "type": "commonjs",
   "files": [
     "dist"

package/dist/functions/string-like.functions.d.ts

@@ -1,21 +0,0 @@
-/**
- * Utility functions for handling values that can be either strings or numbers.
- * This module provides methods to check if a value is string-like and to trim
- * whitespace from such values. It interacts with the class-validator library
- * to determine the type of values.
- */
-/**
- * Checks if the provided value is either a string or a number.
- *
- * @param {unknown} value - The value to be checked.
- * @returns {boolean} - Returns true if the value is a string or a number, false otherwise.
- */
-export declare function isStringLike(value: unknown): value is string | number;
-/**
- * Trims whitespace from a string-like value (string or number).
- * If the value is not string-like, it returns the original value.
- *
- * @param {T} value - The value to be trimmed.
- * @returns {string | T} - The trimmed string-like value or the original value if not string-like.
- */
-export declare function trimStringLike<T = any>(value: T): string | T;

package/dist/functions/string-like.functions.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isStringLike = isStringLike;
-exports.trimStringLike = trimStringLike;
-const class_validator_1 = require("class-validator");
-/**
- * Utility functions for handling values that can be either strings or numbers.
- * This module provides methods to check if a value is string-like and to trim
- * whitespace from such values. It interacts with the class-validator library
- * to determine the type of values.
- */
-/**
- * Checks if the provided value is either a string or a number.
- *
- * @param {unknown} value - The value to be checked.
- * @returns {boolean} - Returns true if the value is a string or a number, false otherwise.
- */
-function isStringLike(value) {
-    // Utilize class-validator to determine if the value is a string or a number
-    return (0, class_validator_1.isString)(value) || (0, class_validator_1.isNumber)(value);
-}
-/**
- * Trims whitespace from a string-like value (string or number).
- * If the value is not string-like, it returns the original value.
- *
- * @param {T} value - The value to be trimmed.
- * @returns {string | T} - The trimmed string-like value or the original value if not string-like.
- */
-function trimStringLike(value) {
-    // Check if the value is string-like using the isStringLike function
-    if (!isStringLike(value))
-        return value;
-    // Convert the value to a string, replace multiple spaces with a single space, and trim the result
-    return String(value).replace(/\s+/g, ' ').trim();
-}

package/dist/transform/cast-to-array.transform.d.ts

@@ -1,20 +0,0 @@
-/**
- * Interface defining options for the CastToArray decorator.
- * - onlyStringLike: If true, filters the array to include only string-like values.
- * - unique: If true, ensures all elements in the array are unique.
- */
-interface ArrayOptions {
-    onlyStringLike?: boolean;
-    unique?: boolean;
-}
-/**
- * The CastToArray decorator function ensures that the decorated property is always an array.
- * It checks the input value and returns it as an array, wrapping non-array values in an array.
- * This decorator is useful for maintaining consistent data types when processing input data,
- * particularly when the input can vary between single values and arrays.
- *
- * @param {ArrayOptions} opts - Options to customize the behavior of the array transformation.
- * @returns {PropertyDecorator} - A decorator function that transforms the property value into an array.
- */
-export declare function CastToArray(opts?: ArrayOptions): PropertyDecorator;
-export {};

package/dist/transform/cast-to-array.transform.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CastToArray = CastToArray;
-const class_transformer_1 = require("class-transformer");
-const string_like_functions_1 = require("../functions/string-like.functions");
-/**
- * The CastToArray decorator function ensures that the decorated property is always an array.
- * It checks the input value and returns it as an array, wrapping non-array values in an array.
- * This decorator is useful for maintaining consistent data types when processing input data,
- * particularly when the input can vary between single values and arrays.
- *
- * @param {ArrayOptions} opts - Options to customize the behavior of the array transformation.
- * @returns {PropertyDecorator} - A decorator function that transforms the property value into an array.
- */
-function CastToArray(opts = {}) {
-    return (0, class_transformer_1.Transform)(({ value }) => {
-        // Ensure the value is an array; wrap non-array values in an array
-        let resultArray = Array.isArray(value) ? value : [value];
-        // If onlyStringLike option is enabled, filter and normalize the array
-        if (opts.onlyStringLike) {
-            resultArray = resultArray
-                .filter((element) => (0, string_like_functions_1.isStringLike)(element)) // Filter out non-string-like values
-                .map((element) => (0, string_like_functions_1.trimStringLike)(element)) // Trim and normalize the values
-                .filter((element) => String(element).length); // Remove empty values
-        }
-        // If unique option is enabled, remove duplicate elements
-        if (opts.unique) {
-            resultArray = [...new Set(resultArray)];
-        }
-        return resultArray;
-    });
-}

package/dist/transform/to-string-array.transform.d.ts

@@ -1,16 +0,0 @@
-/**
- * TransformToStringArray is a decorator function designed to transform a property value
- * into an array of trimmed strings.
- *
- * Key Responsibilities:
- * - Validates if the input value is an array.
- * - Filters the array to retain only elements that are string-like (strings or numbers).
- * - Trims each element and removes any empty strings from the array.
- * - Returns the original value unchanged if it is not an array.
- *
- * This decorator is useful for ensuring that properties meant to be arrays of strings
- * are consistently formatted and free of extraneous whitespace or empty entries.
- *
- * @returns {PropertyDecorator} A decorator function that applies the transformation.
- */
-export declare function TransformToStringArray(): PropertyDecorator;

package/dist/transform/to-string-array.transform.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToStringArray = TransformToStringArray;
-const class_transformer_1 = require("class-transformer");
-const class_validator_1 = require("class-validator");
-const string_like_functions_1 = require("../functions/string-like.functions");
-/**
- * TransformToStringArray is a decorator function designed to transform a property value
- * into an array of trimmed strings.
- *
- * Key Responsibilities:
- * - Validates if the input value is an array.
- * - Filters the array to retain only elements that are string-like (strings or numbers).
- * - Trims each element and removes any empty strings from the array.
- * - Returns the original value unchanged if it is not an array.
- *
- * This decorator is useful for ensuring that properties meant to be arrays of strings
- * are consistently formatted and free of extraneous whitespace or empty entries.
- *
- * @returns {PropertyDecorator} A decorator function that applies the transformation.
- */
-function TransformToStringArray() {
-    return (0, class_transformer_1.Transform)(({ value }) => {
-        // If the value is not an array, return it unchanged
-        if (!(0, class_validator_1.isArray)(value))
-            return value;
-        // Process the array: filter, trim, and remove empty strings
-        const processedArray = value
-            .filter((element) => (0, string_like_functions_1.isStringLike)(element)) // Retain only string-like elements
-            .map((element) => (0, string_like_functions_1.trimStringLike)(element)) // Trim each element
-            .filter((element) => String(element).length); // Remove elements that are empty strings
-        return processedArray;
-    });
-}

package/dist/transform/to-string-like.transform.d.ts

@@ -1,24 +0,0 @@
-/**
- * Class-level comment block:
- * This module provides a transformation decorator for use with class-transformer.
- * The TransformToStringLike function is designed to automatically transform values
- * that are considered "string-like" (either strings or numbers) according to specified options.
- * It ensures that any string-like property of a class is stored in a consistent format,
- * enhancing data uniformity. It interacts with other components by being applied as a
- * decorator to class properties.
- */
-interface StringLikeOptions {
-    trim?: boolean;
-    lowercase?: boolean;
-    uppercase?: boolean;
-}
-/**
- * Transforms the input value to a formatted string if it's a string or a number.
- * Applies trimming, lowercase, or uppercase transformations based on the provided options.
- * If the value is not string-like, it returns the original value.
- *
- * @param {StringLikeOptions} [opts={}] - Options to specify transformations like trim, lowercase, or uppercase.
- * @return {PropertyDecorator} - A transformation function for class-transformer.
- */
-export declare function TransformToStringLike(opts?: StringLikeOptions): PropertyDecorator;
-export {};

package/dist/transform/to-string-like.transform.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransformToStringLike = TransformToStringLike;
-const class_transformer_1 = require("class-transformer");
-const string_like_functions_1 = require("../functions/string-like.functions");
-/**
- * Transforms the input value to a formatted string if it's a string or a number.
- * Applies trimming, lowercase, or uppercase transformations based on the provided options.
- * If the value is not string-like, it returns the original value.
- *
- * @param {StringLikeOptions} [opts={}] - Options to specify transformations like trim, lowercase, or uppercase.
- * @return {PropertyDecorator} - A transformation function for class-transformer.
- */
-function TransformToStringLike(opts = {}) {
-    return (0, class_transformer_1.Transform)(({ value }) => {
-        // Check if the value is string-like (either a string or a number)
-        if (!(0, string_like_functions_1.isStringLike)(value))
-            return value;
-        // Convert the value to a string for consistent processing
-        let formattedString = String(value);
-        // Apply transformations based on options
-        if (opts.trim)
-            formattedString = (0, string_like_functions_1.trimStringLike)(formattedString);
-        if (opts.lowercase)
-            formattedString = formattedString.toLowerCase();
-        if (opts.uppercase)
-            formattedString = formattedString.toUpperCase();
-        // Return the transformed string-like value
-        return formattedString;
-    });
-}