@xeno-js/shared 0.1.0 → 0.1.1

package/dist/shared/utils/http.utils.js

@@ -1,144 +0,0 @@
-import { STATUS_CODES } from '../constants/error.constants';
-import { DateHelper } from './date.utils';
-import { Guards } from './guards.utils';
-/**
- * @description This module provides utility functions for handling HTTP-related tasks, such as normalizing HTTP headers. It includes a single function, `normalizeHeaders`, which takes an input of unknown type and returns an object with normalized header values. The function ensures that all header values are converted to strings, and if a header value is an array, it joins the elements into a single string separated by commas. This utility is useful for ensuring consistent header formats when working with various HTTP client libraries.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-/**
- * @description A helper object that provides utility functions for HTTP-related tasks. Currently, it includes a method for normalizing HTTP headers, which ensures that all header values are strings and handles cases where header values may be arrays. This helper can be extended in the future to include additional HTTP-related utilities as needed.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-export const HttpHelper = Object.freeze({
-    /**
-     * @description Normalizes HTTP headers by converting all header values to strings. If a header value is an array, it joins the array elements into a single string separated by commas. This method ensures that the headers are in a consistent format, which can be particularly useful when working with different HTTP client libraries that may represent headers in various ways. If the input headers are not defined or not an object, it returns an empty object.
-     * @param headers The input headers to be normalized, which can be of any type. The method checks if the headers are defined and are an object before processing them.
-     * @returns An object containing the normalized headers, where each header value is a string. If the input headers were not valid, it returns an empty object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    normalizeHeaders(headers) {
-        if (!Guards.isDefined(headers) || !Guards.isObject(headers))
-            return {};
-        const normalized = {};
-        for (const [key, value] of Object.entries(headers)) {
-            if (!Guards.isDefined(value)) {
-                continue;
-            }
-            normalized[key] = Array.isArray(value)
-                ? value.map((part) => String(part)).join(',')
-                : String(value);
-        }
-        return normalized;
-    },
-    /**
-     * @description Sanitizes the origin URL by parsing it and extracting the origin part. If the URL is not valid or cannot be parsed or does not contain an origin, it returns undefined.
-     * @param url The URL to be sanitized.
-     * @returns The sanitized origin URL or undefined if the URL is not valid or cannot be parsed or does not contain an origin.
-     *
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    sanitizeOriginUrl(url) {
-        if (!Guards.isDefined(url))
-            return undefined;
-        try {
-            const parsed = new URL(url);
-            return parsed.origin;
-        }
-        catch {
-            return undefined;
-        }
-    },
-    /**
-     * @description Generates a standardized successful HTTP response with the provided data, status code, metadata, and custom headers. The response includes a success flag set to true, the data payload, and any additional metadata. The headers include a default 'Content-Type' of 'application/json' along with any custom headers provided.
-     * @param data The actual data payload to be included in the successful response. This can be of any type and will be wrapped in a SuccessResponseDto structure.
-     * @param status The HTTP status code for the response, defaulting to 200 (OK) if not provided. This allows for flexibility in indicating different types of successful responses (e.g., 201 for created, 204 for no content).
-     * @param meta Optional metadata to be included in the response. This can contain additional information relevant to the response, such as pagination details, rate limit information, or any other contextual data that may be useful for clients consuming the API.
-     * @param customHeaders Optional custom HTTP headers to be included in the response. This allows for adding any additional headers that may be necessary for specific responses, such as caching directives, custom authentication headers, or other relevant information.
-     * @returns A ResponseDto object representing the successful HTTP response, containing the status code, success flag, headers, and data payload structured as a SuccessResponseDto.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    success(data, status = 200, meta = {}, customHeaders = {}) {
-        const successPayload = {
-            success: true,
-            data,
-            meta,
-        };
-        return {
-            status,
-            ok: true,
-            headers: {
-                ...customHeaders,
-                'Content-Type': ['application/json'],
-            },
-            data: successPayload,
-        };
-    },
-    /**
-     * @description Generates a standardized error HTTP response with the provided error details, status code, correlation ID, request ID, timestamp, and custom headers. The response includes a success flag set to false, an error object containing the error code, message, and optional details, as well as metadata such as correlation ID and request ID for tracking purposes. The headers include a default 'Content-Type' of 'application/json' along with any custom headers provided.
-     * @param dto An object containing the error details, including the error code, message, optional details, and optional path. This information is structured as an ErrorResponseDto and provides context about the error that occurred.
-     * @param status The HTTP status code for the response, defaulting to 500 (Internal Server Error) if not provided. This allows for flexibility in indicating different types of error responses (e.g., 400 for bad request, 404 for not found).
-     * @param customHeaders Optional custom HTTP headers to be included in the response. This allows for adding any additional headers that may be necessary for specific error responses, such as caching directives, custom authentication headers, or other relevant information.
-     * @returns A ResponseDto object representing the error HTTP response, containing the status code, success flag, headers, and data payload structured as an ErrorResponseDto.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    error(dto, status = STATUS_CODES.INTERNAL_SERVER_ERROR, customHeaders = undefined) {
-        const errorPayload = {
-            success: false,
-            error: {
-                code: dto.error.code,
-                message: dto.error.message,
-                details: dto.error.details,
-                path: dto.error.path,
-            },
-            correlationId: dto.correlationId,
-            requestId: dto.requestId,
-            spanId: dto.spanId,
-            timestamp: DateHelper.toISOString(new Date()),
-        };
-        return {
-            status,
-            ok: false,
-            headers: {
-                'Content-Type': ['application/json'],
-                'X-Correlation-Id': [dto.correlationId],
-                'X-Request-Id': [dto.requestId],
-                'X-Span-Id': [dto.spanId ?? ''],
-                'Cache-Control': ['no-store, no-cache, must-revalidate, proxy-revalidate'],
-                'Pragma': ['no-cache'],
-                'Expires': ['0'],
-                ...(customHeaders ?? {}),
-            },
-            data: errorPayload,
-        };
-    },
-});
-//# sourceMappingURL=http.utils.js.map

package/dist/shared/utils/http.utils.js.map

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

package/dist/shared/utils/index.d.ts

@@ -1,11 +0,0 @@
-export * from './abort.utils';
-export * from './date.utils';
-export * from './enumerable.utils';
-export * from './guards.utils';
-export * from './guid.utils';
-export * from './http.utils';
-export * from './math.utils';
-export * from './promise.utils';
-export * from './sanitize.utils';
-export * from './string.utils';
-//# sourceMappingURL=index.d.ts.map

package/dist/shared/utils/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}

package/dist/shared/utils/index.js

@@ -1,11 +0,0 @@
-export * from './abort.utils';
-export * from './date.utils';
-export * from './enumerable.utils';
-export * from './guards.utils';
-export * from './guid.utils';
-export * from './http.utils';
-export * from './math.utils';
-export * from './promise.utils';
-export * from './sanitize.utils';
-export * from './string.utils';
-//# sourceMappingURL=index.js.map

package/dist/shared/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA"}

package/dist/shared/utils/math.utils.d.ts

@@ -1,79 +0,0 @@
-import type { Optional } from '../types';
-/**
- * @description Namespace for safe mathematical operations.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-export declare const MathHelper: Readonly<{
-    /**
-     * @description Constrains a value within an inclusive min-max range.
-     * @param value Input value.
-     * @param min Minimum bound.
-     * @param max Maximum bound.
-     * @returns Clamped value.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly clamp: (value: number, min: number, max: number) => number;
-    /**
-     * @description Rounds a number to the specified decimal precision.
-     * @param value Input value.
-     * @param decimals Number of decimal places.
-     * @returns Rounded value.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly roundTo: (value: number, decimals: number) => number;
-    /**
-     * @description Divides two numbers, returning a safe fallback on zero denominator.
-     * @param numerator Numerator.
-     * @param denominator Denominator.
-     * @param fallback Return value when denominator is zero.
-     * @returns Division result or fallback.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly safeDivide: (numerator: number, denominator: number, fallback?: number) => number;
-    /**
-     * @description Returns the percentage of part over total (0–100 scale).
-     * @param part Part value.
-     * @param total Total value.
-     * @returns Percentage or 0 when total is zero.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly toPercentage: (part: number, total: number) => number;
-    /**
-     * @description Converts a value to a number, returning a fallback for non-numeric inputs.
-     * @param value Input value.
-     * @param fallback Fallback value for non-numeric inputs.
-     * @returns Numeric value or fallback.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly toNumber: (value: Optional<unknown>, fallback?: number) => number;
-}>;
-//# sourceMappingURL=math.utils.d.ts.map

package/dist/shared/utils/math.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"math.utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/math.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;;;;;;KAQK;AACL,eAAO,MAAM,UAAU;IACrB;;;;;;;;;;;;OAYG;4BACU,MAAM,OAAO,MAAM,OAAO,MAAM,KAAG,MAAM;IAItD;;;;;;;;;;;OAWG;8BACY,MAAM,YAAY,MAAM,KAAG,MAAM;IAKhD;;;;;;;;;;;;OAYG;qCACmB,MAAM,eAAe,MAAM,wBAAiB,MAAM;IAKxE;;;;;;;;;;;OAWG;kCACgB,MAAM,SAAS,MAAM,KAAG,MAAM;IAIjD;;;;;;;;;;OAUG;+BACa,QAAQ,CAAC,OAAO,CAAC,wBAAiB,MAAM;EAK/C,CAAA"}

package/dist/shared/utils/math.utils.js

@@ -1,97 +0,0 @@
-import { Guards } from './guards.utils';
-/**
- * @description Namespace for safe mathematical operations.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-export const MathHelper = Object.freeze({
-    /**
-     * @description Constrains a value within an inclusive min-max range.
-     * @param value Input value.
-     * @param min Minimum bound.
-     * @param max Maximum bound.
-     * @returns Clamped value.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    clamp(value, min, max) {
-        return Math.min(Math.max(value, min), max);
-    },
-    /**
-     * @description Rounds a number to the specified decimal precision.
-     * @param value Input value.
-     * @param decimals Number of decimal places.
-     * @returns Rounded value.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    roundTo(value, decimals) {
-        const factor = 10 ** decimals;
-        return Math.round(value * factor) / factor;
-    },
-    /**
-     * @description Divides two numbers, returning a safe fallback on zero denominator.
-     * @param numerator Numerator.
-     * @param denominator Denominator.
-     * @param fallback Return value when denominator is zero.
-     * @returns Division result or fallback.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    safeDivide(numerator, denominator, fallback = 0) {
-        if (denominator === 0)
-            return fallback;
-        return numerator / denominator;
-    },
-    /**
-     * @description Returns the percentage of part over total (0–100 scale).
-     * @param part Part value.
-     * @param total Total value.
-     * @returns Percentage or 0 when total is zero.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    toPercentage(part, total) {
-        if (total === 0)
-            return 0;
-        return (part / total) * 100;
-    },
-    /**
-     * @description Converts a value to a number, returning a fallback for non-numeric inputs.
-     * @param value Input value.
-     * @param fallback Fallback value for non-numeric inputs.
-     * @returns Numeric value or fallback.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    toNumber(value, fallback = 0) {
-        if (!Guards.isDefined(value) || !Guards.isNumber(value))
-            return fallback;
-        const num = Number(value);
-        return isNaN(num) ? fallback : num;
-    },
-});
-//# sourceMappingURL=math.utils.js.map

package/dist/shared/utils/math.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"math.utils.js","sourceRoot":"","sources":["../../../src/shared/utils/math.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC;;;;;;;;KAQK;AACL,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAa,EAAE,QAAgB;QACrC,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAA;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAA;IAC5C,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,SAAiB,EAAE,WAAmB,EAAE,QAAQ,GAAG,CAAC;QAC7D,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAA;QACtC,OAAO,SAAS,GAAG,WAAW,CAAA;IAChC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,IAAY,EAAE,KAAa;QACtC,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,CAAC,CAAA;QACzB,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;IAC7B,CAAC;IACD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAwB,EAAE,QAAQ,GAAG,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAA;QACxE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAA;IACpC,CAAC;CACO,CAAC,CAAA"}

package/dist/shared/utils/promise.utils.d.ts

@@ -1,40 +0,0 @@
-/**
- * @description Fornisce utilità per la gestione avanzata di Promise, ritardi asincroni e concorrenza.
- * Astrae le logiche di timing per renderle facilmente testabili e riutilizzabili.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-export declare const PromiseHelper: Readonly<{
-    /**
-     * @description Sospende l'esecuzione asincrona per un numero esatto di millisecondi.
-     * @param ms I millisecondi di attesa.
-     * @returns Una Promise che si risolve al termine del tempo.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly delay: (ms: number) => Promise<void>;
-    /**
-     * @description Introduce un ritardo asincrono composto da un tempo base più una variazione casuale.
-     * Fondamentale per mitigare il "Thundering Herd problem" (effetto gregge) distribuendo
-     * nel tempo i retry simultanei di più client.
-     * * @param baseDelayMs Il ritardo minimo garantito.
-     * @param maxJitterMs La variazione massima casuale aggiuntiva.
-     * @returns Una Promise che si risolve al termine del calcolo.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly delayWithJitter: (baseDelayMs: number, maxJitterMs: number) => Promise<void>;
-}>;
-//# sourceMappingURL=promise.utils.d.ts.map

package/dist/shared/utils/promise.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"promise.utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/promise.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;KASK;AACL,eAAO,MAAM,aAAa;IACxB;;;;;;;;;;OAUG;yBACO,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;;;;;;;;OAaG;4CAC0B,MAAM,eAAe,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;EAI/D,CAAA"}

package/dist/shared/utils/promise.utils.js

@@ -1,45 +0,0 @@
-/**
- * @description Fornisce utilità per la gestione avanzata di Promise, ritardi asincroni e concorrenza.
- * Astrae le logiche di timing per renderle facilmente testabili e riutilizzabili.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-export const PromiseHelper = Object.freeze({
-    /**
-     * @description Sospende l'esecuzione asincrona per un numero esatto di millisecondi.
-     * @param ms I millisecondi di attesa.
-     * @returns Una Promise che si risolve al termine del tempo.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    delay(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    },
-    /**
-     * @description Introduce un ritardo asincrono composto da un tempo base più una variazione casuale.
-     * Fondamentale per mitigare il "Thundering Herd problem" (effetto gregge) distribuendo
-     * nel tempo i retry simultanei di più client.
-     * * @param baseDelayMs Il ritardo minimo garantito.
-     * @param maxJitterMs La variazione massima casuale aggiuntiva.
-     * @returns Una Promise che si risolve al termine del calcolo.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    delayWithJitter(baseDelayMs, maxJitterMs) {
-        const jitter = Math.floor(Math.random() * maxJitterMs);
-        return new Promise((resolve) => setTimeout(resolve, baseDelayMs + jitter));
-    },
-});
-//# sourceMappingURL=promise.utils.js.map

package/dist/shared/utils/promise.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"promise.utils.js","sourceRoot":"","sources":["../../../src/shared/utils/promise.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;KASK;AACL,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAU;QACd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,WAAmB,EAAE,WAAmB;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAA;QACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC,CAAA;IAC5E,CAAC;CACO,CAAC,CAAA"}

package/dist/shared/utils/sanitize.utils.d.ts

@@ -1,39 +0,0 @@
-import type { Optional } from '../types/index';
-/**
- * @description Centralized security utility for data and context sanitization.
- * Enforces OWASP guidelines preventing Log Injection (CWE-117), CRLF injection,
- * and URI protocol manipulation across all application layers.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-export declare const SanitizeHelper: Readonly<{
-    /**
-     * @description Removes carriage returns, line feeds, null bytes, and non-printable control characters.
-     * Mitigates Log Forging and Log Injection attacks (CWE-117).
-     * @param value The candidate string to sanitize.
-     * @param maxLength Maximum allowable length after sanitization. Defaults to 256.
-     * @returns Sanitized string or undefined if empty/non-string.
-     */
-    readonly stripControlChars: (value: Optional<string>, maxLength?: number) => Optional<string>;
-    /**
-     * @description Sanitizes navigation paths and URLs, removing control characters
-     * and preventing execution of dangerous pseudo-protocols (e.g. javascript:, data:).
-     * @param path The path string to sanitize.
-     * @param maxLength Maximum length of the path. Defaults to 512.
-     * @returns Sanitized path or '/' fallback for unsafe inputs.
-     */
-    readonly sanitizePath: (path: Optional<string>, maxLength?: number) => Optional<string>;
-    /**
-     * @description Sanitizes an array of strings (e.g. roles, permissions, scopes).
-     * Strips control characters, filters out empty entries, and limits collection size.
-     * @param items Array of strings to sanitize.
-     * @param maxItemLength Maximum allowable character length per item. Defaults to 64.
-     * @param maxItems Maximum total number of elements kept. Defaults to 50.
-     * @returns Immutable array of sanitized strings.
-     */
-    readonly sanitizeStringArray: (items: Optional<string[]>, maxItemLength?: number, maxItems?: number) => Optional<string[]>;
-}>;
-//# sourceMappingURL=sanitize.utils.d.ts.map

package/dist/shared/utils/sanitize.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sanitize.utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/sanitize.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAU9C;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;OAMG;wCACsB,QAAQ,CAAC,MAAM,CAAC,yBAAoB,QAAQ,CAAC,MAAM,CAAC;IAO7E;;;;;;OAMG;kCACgB,QAAQ,CAAC,MAAM,CAAC,yBAAoB,QAAQ,CAAC,MAAM,CAAC;IASvE;;;;;;;OAOG;0CAEM,QAAQ,CAAC,MAAM,EAAE,CAAC,gDAGxB,QAAQ,CAAC,MAAM,EAAE,CAAC;EASZ,CAAA"}

package/dist/shared/utils/sanitize.utils.js

@@ -1,67 +0,0 @@
-import { Guards } from './guards.utils';
-const start = String.fromCharCode(0);
-const end = String.fromCharCode(31);
-const del = String.fromCharCode(127);
-const CONTROL_CHARS_REGEX = new RegExp(`[\\r\\n\\t${start}-${end}${del}]`, 'g');
-const DANGEROUS_PROTOCOLS_REGEX = /^(javascript|data|vbscript):/i;
-/**
- * @description Centralized security utility for data and context sanitization.
- * Enforces OWASP guidelines preventing Log Injection (CWE-117), CRLF injection,
- * and URI protocol manipulation across all application layers.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-export const SanitizeHelper = Object.freeze({
-    /**
-     * @description Removes carriage returns, line feeds, null bytes, and non-printable control characters.
-     * Mitigates Log Forging and Log Injection attacks (CWE-117).
-     * @param value The candidate string to sanitize.
-     * @param maxLength Maximum allowable length after sanitization. Defaults to 256.
-     * @returns Sanitized string or undefined if empty/non-string.
-     */
-    stripControlChars(value, maxLength = 256) {
-        if (Guards.isNullOrEmpty(value))
-            return undefined;
-        const clean = value.replace(CONTROL_CHARS_REGEX, '').trim();
-        if (Guards.isNullOrEmpty(clean))
-            return undefined;
-        return clean.slice(0, maxLength);
-    },
-    /**
-     * @description Sanitizes navigation paths and URLs, removing control characters
-     * and preventing execution of dangerous pseudo-protocols (e.g. javascript:, data:).
-     * @param path The path string to sanitize.
-     * @param maxLength Maximum length of the path. Defaults to 512.
-     * @returns Sanitized path or '/' fallback for unsafe inputs.
-     */
-    sanitizePath(path, maxLength = 512) {
-        if (Guards.isNullOrEmpty(path))
-            return undefined;
-        const clean = path.replace(CONTROL_CHARS_REGEX, '').trim();
-        if (Guards.isNullOrEmpty(clean) || DANGEROUS_PROTOCOLS_REGEX.test(clean)) {
-            return '/';
-        }
-        return clean.slice(0, maxLength);
-    },
-    /**
-     * @description Sanitizes an array of strings (e.g. roles, permissions, scopes).
-     * Strips control characters, filters out empty entries, and limits collection size.
-     * @param items Array of strings to sanitize.
-     * @param maxItemLength Maximum allowable character length per item. Defaults to 64.
-     * @param maxItems Maximum total number of elements kept. Defaults to 50.
-     * @returns Immutable array of sanitized strings.
-     */
-    sanitizeStringArray(items, maxItemLength = 64, maxItems = 50) {
-        if (Guards.isNullOrEmpty(items))
-            return undefined;
-        const sanitized = items
-            .slice(0, maxItems)
-            .map((item) => SanitizeHelper.stripControlChars(item, maxItemLength))
-            .filter((item) => Guards.isDefined(item));
-        return sanitized;
-    },
-});
-//# sourceMappingURL=sanitize.utils.js.map

package/dist/shared/utils/sanitize.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sanitize.utils.js","sourceRoot":"","sources":["../../../src/shared/utils/sanitize.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;AACpC,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;AACnC,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;AAEpC,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,CAAA;AAC/E,MAAM,yBAAyB,GAAG,+BAA+B,CAAA;AAEjE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAuB,EAAE,SAAS,GAAG,GAAG;QACxD,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QAC3D,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACjD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAClC,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,IAAsB,EAAE,SAAS,GAAG,GAAG;QAClD,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAA;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1D,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAClC,CAAC;IAED;;;;;;;OAOG;IACH,mBAAmB,CACjB,KAAyB,EACzB,aAAa,GAAG,EAAE,EAClB,QAAQ,GAAG,EAAE;QAEb,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACjD,MAAM,SAAS,GAAG,KAAK;aACpB,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;aAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;aACpE,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;QAE3D,OAAO,SAAS,CAAA;IAClB,CAAC;CACO,CAAC,CAAA"}