@smythos/sre 1.6.1 → 1.6.8

package/src/utils/date-time.utils.ts

@@ -1,22 +1,22 @@
-export function getCurrentFormattedDate() {
-    const date = new Date();
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, '0'); // Months are 0-based
-    const day = String(date.getDate()).padStart(2, '0');
-    const hours = String(date.getHours()).padStart(2, '0');
-    const minutes = String(date.getMinutes()).padStart(2, '0');
-    const seconds = String(date.getSeconds()).padStart(2, '0');
-    return `${year}-${month}-${day}-${hours}-${minutes}-${seconds}`;
-}
-
-export function getDayFormattedDate() {
-    const date = new Date();
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, '0'); // Months are 0-based
-    const day = String(date.getDate()).padStart(2, '0');
-    return `${year}-${month}-${day}`;
-}
-
-export function delay(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
+export function getCurrentFormattedDate() {
+    const date = new Date();
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0'); // Months are 0-based
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day}-${hours}-${minutes}-${seconds}`;
+}
+
+export function getDayFormattedDate() {
+    const date = new Date();
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0'); // Months are 0-based
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+
+export function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}

package/src/utils/general.utils.ts

@@ -1,238 +1,238 @@
-import { LogHelper } from '@sre/helpers/Log.helper';
-import pLimit from 'p-limit';
-export function uid() {
-    return (Date.now() + Math.random()).toString(36).replace('.', '').toUpperCase();
-}
-
-/**
- * this function is used to check if a class is a subclass of another class
- * @param subClass
- * @param superClass
- * @returns
- */
-export function isSubclassOf(subClass: any, superClass: any): boolean {
-    if (typeof subClass !== 'function' || typeof superClass !== 'function') {
-        return false;
-    }
-
-    let prototype = Object.getPrototypeOf(subClass.prototype);
-    let depth = 10;
-
-    while (prototype && depth >= 0) {
-        if (prototype === superClass.prototype) {
-            return true;
-        }
-        prototype = Object.getPrototypeOf(prototype);
-        depth++;
-    }
-
-    return false;
-}
-
-/**
- * Processes an array of tasks concurrently with a specified concurrency limit.
- *
- * @template T - The type of the result returned by each task.
- *
- * @param {(() => Promise<T>)[]} tasks - An array of functions that return promises.
- * Each function represents a task to be processed.
- * @param {number} [maxConcurrentTasks=10] - The maximum number of concurrent tasks.
- *
- * @returns {Promise<T[]>} - A promise that resolves to an array of results.
- * Only successfully fulfilled promises are included in the result array.
- *
- * @throws {TypeError} - Throws an error if the tasks parameter is not an array of functions.
- *
- * @example
- * const tasks = [
- *     () => await processFile('file1.txt'),
- *     () => await processFile('file2.txt'),
- *     () => await processFile('file3.txt'),
- * ];
- *
- * const maxConcurrentTasks = 2;
- *
- * processWithConcurrencyLimit(tasks, maxConcurrentTasks)
- *     .then(results => console.log(results)) // Array of results from the fulfilled promises
- *     .catch(error => console.error(error));
- *
- * @note Currently, this function ignores tasks that fail to process.
- *       Only successfully fulfilled promises are included in the result array.
- *       To improve this behavior, we could add an option to control whether to exit the function if a task fails.
- */
-export async function processWithConcurrencyLimit<T>(tasks: (() => Promise<T>)[], maxConcurrentTasks: number = 10): Promise<T[]> {
-    const limit = pLimit(maxConcurrentTasks);
-
-    const limitedTasks = tasks.map((task) => limit(task));
-
-    const results = await Promise.allSettled(limitedTasks);
-
-    // Filter for successfully fulfilled promises and extract their values
-    const validResults = results.flatMap((result) => (result.status === 'fulfilled' ? [result.value] : [])).filter(Boolean);
-
-    return validResults;
-}
-
-export const detectURLSourceType = (url: string) => {
-    const urlObj = new URL(url);
-    const ext = urlObj.pathname.split('.').pop();
-
-    switch (ext) {
-        case 'pdf':
-            return 'PDF';
-        case 'xml':
-            return 'SITEMAP';
-        case 'html':
-        case 'htm':
-        case 'txt':
-            return 'WEBPAGE';
-        case 'doc':
-        case 'docx':
-            return 'WORD';
-        default:
-            return 'WEBPAGE';
-    }
-};
-
-/**
- * This function checks if a string is a valid JSON string.
- * @param str
- * @returns
- */
-export const isJSONString = (str: string): boolean => {
-    try {
-        return typeof str === 'string' && !!JSON.parse(str);
-    } catch {
-        return false;
-    }
-};
-
-export class ControlledPromise<T> extends Promise<T> {
-    private _isSettled = false;
-    public readonly isSettled: () => boolean;
-    public resolve!: (value: T) => void;
-    public reject!: (reason?: any) => void;
-
-    constructor(executor: (resolve: (value: T) => void, reject: (reason?: any) => void, isSettled: () => boolean) => void) {
-        let internalResolve!: (value: T) => void;
-        let internalReject!: (reason?: any) => void;
-        let _isSettled = false;
-
-        super((resolve, reject) => {
-            internalResolve = (value: T) => {
-                if (!_isSettled) {
-                    _isSettled = true;
-                    resolve(value);
-                }
-            };
-
-            internalReject = (reason?: any) => {
-                if (!_isSettled) {
-                    _isSettled = true;
-                    reject(reason);
-                }
-            };
-        });
-
-        this.resolve = internalResolve;
-        this.reject = internalReject;
-        this.isSettled = () => _isSettled;
-
-        // run user executor with the third isSettled arg
-        executor(this.resolve, this.reject, this.isSettled);
-    }
-}
-
-/**
- * This function ensures that a function is called at most once per wait time.
- * @param func - The function to debounce
- * @param wait - The wait time in milliseconds
- * @param options - The options object : leading means the function will be called immediately if it's called within the wait time,
- * trailing means the function will be called after the wait time has passed. maxWait is the maximum time to wait before calling the function.
- * if maxWait is provided, the function will be called after the maxWait time has passed.
- *
- * @returns
- */
-export function debounce(func: Function, wait: number, options: { leading: boolean; trailing: boolean; maxWait?: number }) {
-    let timeout: NodeJS.Timeout | null = null;
-    let lastCall = 0;
-
-    return function (this: any, ...args: any[]) {
-        const now = Date.now();
-        const later = () => {
-            timeout = null;
-            lastCall = now;
-            func.apply(this, args);
-        };
-
-        if (timeout) {
-            clearTimeout(timeout);
-        }
-
-        if (options.leading && !timeout) {
-            func.apply(this, args);
-            lastCall = now;
-        }
-
-        if (options.maxWait && now - lastCall >= options.maxWait) {
-            func.apply(this, args);
-            lastCall = now;
-        }
-
-        timeout = setTimeout(later, wait);
-    };
-}
-
-/**
- * Extracts and formats the last N calls from the stack trace in a user-friendly way
- */
-export function getFormattedStackTrace(limit: number = 3, skip: number = 0): string[] {
-    const stack = new Error().stack;
-    if (!stack) return [];
-
-    const stackLines = stack.split('\n');
-    // Skip the first few lines (Error message, this function, and the caller)
-    const relevantLines = stackLines.slice(3 + skip);
-
-    const formattedCalls: string[] = [];
-
-    const length = Math.min(limit, relevantLines.length);
-    for (let i = 0; i < length; i++) {
-        const line = relevantLines[i].trim();
-        if (!line) continue;
-
-        // Parse different stack trace formats
-        let match = line.match(/at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)/); // at functionName (file:line:col)
-        if (!match) {
-            match = line.match(/at\s+(.+?):(\d+):(\d+)/); // at file:line:col
-            if (match) {
-                const [, filePath, lineNum] = match;
-                const fileName = filePath.split(/[/\\]/).pop() || filePath;
-                formattedCalls.push(` ${fileName}:${lineNum}`);
-            }
-        } else {
-            const [, functionName, filePath, lineNum] = match;
-            const fileName = filePath.split(/[/\\]/).pop() || filePath;
-            const cleanFunctionName = functionName.includes('.') ? functionName.split('.').pop() : functionName;
-            formattedCalls.push(`${i < length - 1 ? '├' : '└'} ${cleanFunctionName}() in ${fileName}  (${filePath}:${lineNum})`);
-        }
-
-        // Fallback for other formats
-        if (!match && line.includes('at ')) {
-            const cleanLine = line.replace('at ', '').trim();
-            formattedCalls.push(` ${cleanLine}`);
-        }
-    }
-
-    return formattedCalls;
-}
-
-export function printStackTrace(logger: LogHelper | Console, limit: number = 3, skip: number = 0) {
-    const stackTrace = getFormattedStackTrace(limit, skip);
-    if (stackTrace.length > 0) {
-        logger.debug('Call trace:');
-        stackTrace.forEach((call, index) => {
-            logger.debug(`   ${call}`);
-        });
-    }
-}
+import { LogHelper } from '@sre/helpers/Log.helper';
+import pLimit from 'p-limit';
+export function uid() {
+    return (Date.now() + Math.random()).toString(36).replace('.', '').toUpperCase();
+}
+
+/**
+ * this function is used to check if a class is a subclass of another class
+ * @param subClass
+ * @param superClass
+ * @returns
+ */
+export function isSubclassOf(subClass: any, superClass: any): boolean {
+    if (typeof subClass !== 'function' || typeof superClass !== 'function') {
+        return false;
+    }
+
+    let prototype = Object.getPrototypeOf(subClass.prototype);
+    let depth = 10;
+
+    while (prototype && depth >= 0) {
+        if (prototype === superClass.prototype) {
+            return true;
+        }
+        prototype = Object.getPrototypeOf(prototype);
+        depth++;
+    }
+
+    return false;
+}
+
+/**
+ * Processes an array of tasks concurrently with a specified concurrency limit.
+ *
+ * @template T - The type of the result returned by each task.
+ *
+ * @param {(() => Promise<T>)[]} tasks - An array of functions that return promises.
+ * Each function represents a task to be processed.
+ * @param {number} [maxConcurrentTasks=10] - The maximum number of concurrent tasks.
+ *
+ * @returns {Promise<T[]>} - A promise that resolves to an array of results.
+ * Only successfully fulfilled promises are included in the result array.
+ *
+ * @throws {TypeError} - Throws an error if the tasks parameter is not an array of functions.
+ *
+ * @example
+ * const tasks = [
+ *     () => await processFile('file1.txt'),
+ *     () => await processFile('file2.txt'),
+ *     () => await processFile('file3.txt'),
+ * ];
+ *
+ * const maxConcurrentTasks = 2;
+ *
+ * processWithConcurrencyLimit(tasks, maxConcurrentTasks)
+ *     .then(results => console.log(results)) // Array of results from the fulfilled promises
+ *     .catch(error => console.error(error));
+ *
+ * @note Currently, this function ignores tasks that fail to process.
+ *       Only successfully fulfilled promises are included in the result array.
+ *       To improve this behavior, we could add an option to control whether to exit the function if a task fails.
+ */
+export async function processWithConcurrencyLimit<T>(tasks: (() => Promise<T>)[], maxConcurrentTasks: number = 10): Promise<T[]> {
+    const limit = pLimit(maxConcurrentTasks);
+
+    const limitedTasks = tasks.map((task) => limit(task));
+
+    const results = await Promise.allSettled(limitedTasks);
+
+    // Filter for successfully fulfilled promises and extract their values
+    const validResults = results.flatMap((result) => (result.status === 'fulfilled' ? [result.value] : [])).filter(Boolean);
+
+    return validResults;
+}
+
+export const detectURLSourceType = (url: string) => {
+    const urlObj = new URL(url);
+    const ext = urlObj.pathname.split('.').pop();
+
+    switch (ext) {
+        case 'pdf':
+            return 'PDF';
+        case 'xml':
+            return 'SITEMAP';
+        case 'html':
+        case 'htm':
+        case 'txt':
+            return 'WEBPAGE';
+        case 'doc':
+        case 'docx':
+            return 'WORD';
+        default:
+            return 'WEBPAGE';
+    }
+};
+
+/**
+ * This function checks if a string is a valid JSON string.
+ * @param str
+ * @returns
+ */
+export const isJSONString = (str: string): boolean => {
+    try {
+        return typeof str === 'string' && !!JSON.parse(str);
+    } catch {
+        return false;
+    }
+};
+
+export class ControlledPromise<T> extends Promise<T> {
+    private _isSettled = false;
+    public readonly isSettled: () => boolean;
+    public resolve!: (value: T) => void;
+    public reject!: (reason?: any) => void;
+
+    constructor(executor: (resolve: (value: T) => void, reject: (reason?: any) => void, isSettled: () => boolean) => void) {
+        let internalResolve!: (value: T) => void;
+        let internalReject!: (reason?: any) => void;
+        let _isSettled = false;
+
+        super((resolve, reject) => {
+            internalResolve = (value: T) => {
+                if (!_isSettled) {
+                    _isSettled = true;
+                    resolve(value);
+                }
+            };
+
+            internalReject = (reason?: any) => {
+                if (!_isSettled) {
+                    _isSettled = true;
+                    reject(reason);
+                }
+            };
+        });
+
+        this.resolve = internalResolve;
+        this.reject = internalReject;
+        this.isSettled = () => _isSettled;
+
+        // run user executor with the third isSettled arg
+        executor(this.resolve, this.reject, this.isSettled);
+    }
+}
+
+/**
+ * This function ensures that a function is called at most once per wait time.
+ * @param func - The function to debounce
+ * @param wait - The wait time in milliseconds
+ * @param options - The options object : leading means the function will be called immediately if it's called within the wait time,
+ * trailing means the function will be called after the wait time has passed. maxWait is the maximum time to wait before calling the function.
+ * if maxWait is provided, the function will be called after the maxWait time has passed.
+ *
+ * @returns
+ */
+export function debounce(func: Function, wait: number, options: { leading: boolean; trailing: boolean; maxWait?: number }) {
+    let timeout: NodeJS.Timeout | null = null;
+    let lastCall = 0;
+
+    return function (this: any, ...args: any[]) {
+        const now = Date.now();
+        const later = () => {
+            timeout = null;
+            lastCall = now;
+            func.apply(this, args);
+        };
+
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+
+        if (options.leading && !timeout) {
+            func.apply(this, args);
+            lastCall = now;
+        }
+
+        if (options.maxWait && now - lastCall >= options.maxWait) {
+            func.apply(this, args);
+            lastCall = now;
+        }
+
+        timeout = setTimeout(later, wait);
+    };
+}
+
+/**
+ * Extracts and formats the last N calls from the stack trace in a user-friendly way
+ */
+export function getFormattedStackTrace(limit: number = 3, skip: number = 0): string[] {
+    const stack = new Error().stack;
+    if (!stack) return [];
+
+    const stackLines = stack.split('\n');
+    // Skip the first few lines (Error message, this function, and the caller)
+    const relevantLines = stackLines.slice(3 + skip);
+
+    const formattedCalls: string[] = [];
+
+    const length = Math.min(limit, relevantLines.length);
+    for (let i = 0; i < length; i++) {
+        const line = relevantLines[i].trim();
+        if (!line) continue;
+
+        // Parse different stack trace formats
+        let match = line.match(/at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)/); // at functionName (file:line:col)
+        if (!match) {
+            match = line.match(/at\s+(.+?):(\d+):(\d+)/); // at file:line:col
+            if (match) {
+                const [, filePath, lineNum] = match;
+                const fileName = filePath.split(/[/\\]/).pop() || filePath;
+                formattedCalls.push(` ${fileName}:${lineNum}`);
+            }
+        } else {
+            const [, functionName, filePath, lineNum] = match;
+            const fileName = filePath.split(/[/\\]/).pop() || filePath;
+            const cleanFunctionName = functionName.includes('.') ? functionName.split('.').pop() : functionName;
+            formattedCalls.push(`${i < length - 1 ? '├' : '└'} ${cleanFunctionName}() in ${fileName}  (${filePath}:${lineNum})`);
+        }
+
+        // Fallback for other formats
+        if (!match && line.includes('at ')) {
+            const cleanLine = line.replace('at ', '').trim();
+            formattedCalls.push(` ${cleanLine}`);
+        }
+    }
+
+    return formattedCalls;
+}
+
+export function printStackTrace(logger: LogHelper | Console, limit: number = 3, skip: number = 0) {
+    const stackTrace = getFormattedStackTrace(limit, skip);
+    if (stackTrace.length > 0) {
+        logger.debug('Call trace:');
+        stackTrace.forEach((call, index) => {
+            logger.debug(`   ${call}`);
+        });
+    }
+}

package/src/utils/index.ts

@@ -1,12 +1,12 @@
-//Rules :
-// Utils code should not depend on any other file in the project, but utils can depend on each other or on npm packages
-
-export * from './general.utils';
-export * from './date-time.utils';
-export * from './data.utils';
-export * from './base64.utils';
-export * from './cli.utils';
-export * from './numbers.utils';
-export * from './string.utils';
-export * from './url.utils';
-export * from './validation.utils';
+//Rules :
+// Utils code should not depend on any other file in the project, but utils can depend on each other or on npm packages
+
+export * from './general.utils';
+export * from './date-time.utils';
+export * from './data.utils';
+export * from './base64.utils';
+export * from './cli.utils';
+export * from './numbers.utils';
+export * from './string.utils';
+export * from './url.utils';
+export * from './validation.utils';