topsyde-utils 1.0.0

package/dist/initializable.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Configuration options for initialization
+ */
+export interface InitOptions {
+    /** Number of retry attempts (default: 25) */
+    retries?: number;
+    /** Time in milliseconds between retry attempts (default: 200) */
+    retryInterval?: number;
+    /** Whether to initialize automatically in constructor (default: false) */
+    autoInitialize?: boolean;
+    /** Custom timeout in milliseconds (overrides retries * retryInterval) */
+    timeout?: number;
+}
+/**
+ * Events emitted by Initializable instances
+ */
+export type InitializableEvent = 'initializing' | 'initialized' | 'failed' | 'timeout';
+/**
+ * Base class for objects that require asynchronous initialization
+ *
+ * @example
+ * class Database extends Initializable {
+ *   private connection: any;
+ *
+ *   constructor() {
+ *     super({ retries: 10, retryInterval: 500 });
+ *   }
+ *
+ *   protected async doInitialize(): Promise<void> {
+ *     this.connection = await connectToDatabase();
+ *   }
+ * }
+ *
+ * // Usage
+ * const db = new Database();
+ * await db.initialize();
+ * // or check status
+ * if (await db.isInitialized()) {
+ *   // use the database
+ * }
+ */
+declare class Initializable {
+    /** Number of retry attempts */
+    private retries;
+    /** Time in milliseconds between retry attempts */
+    private retryInterval;
+    /** Whether initialization has completed successfully */
+    private _initialized;
+    /** Whether initialization is in progress */
+    private initializing;
+    /** Whether initialization has failed */
+    private failed;
+    /** Optional timeout in milliseconds */
+    private timeout?;
+    /** Event listeners */
+    private listeners;
+    /** Abort controller for cancellation */
+    private abortController;
+    /**
+     * Creates a new Initializable instance
+     * @param options Configuration options
+     */
+    constructor(options?: InitOptions);
+    /**
+     * Initialize the object
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if initialization fails
+     */
+    initialize(): Promise<void>;
+    /**
+     * Implementation-specific initialization logic
+     * Override this method in subclasses to provide custom initialization
+     */
+    protected doInitialize(): Promise<void>;
+    /**
+     * Check if the object is initialized
+     * @param waitForIt Whether to wait for initialization to complete
+     * @returns Promise that resolves to true if initialized, false otherwise
+     */
+    isInitialized(waitForIt?: boolean): Promise<boolean>;
+    /**
+     * Wait for initialization to complete
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if initialization fails or times out
+     */
+    private waitForInitialization;
+    /**
+     * Cancel initialization if in progress
+     */
+    cancel(): void;
+    /**
+     * Reset initialization state
+     * Allows re-initialization after failure
+     */
+    reset(): void;
+    /**
+     * Register an event listener
+     * @param event Event name
+     * @param callback Function to call when event is emitted
+     * @returns this for chaining
+     */
+    on(event: InitializableEvent, callback: Function): this;
+    /**
+     * Remove an event listener
+     * @param event Event name
+     * @param callback Function to remove
+     * @returns this for chaining
+     */
+    off(event: InitializableEvent, callback: Function): this;
+    /**
+     * Emit an event
+     * @param event Event name
+     * @param args Arguments to pass to listeners
+     */
+    protected emit(event: InitializableEvent, ...args: any[]): void;
+    /**
+     * Get the abort signal for cancellation
+     * Can be passed to fetch or other cancellable operations
+     */
+    protected get abortSignal(): AbortSignal | undefined;
+    /**
+     * Check if initialization has been completed
+     */
+    get initialized(): boolean;
+    /**
+     * Check if initialization is in progress
+     */
+    get isInitializing(): boolean;
+    /**
+     * Check if initialization has failed
+     */
+    get hasFailed(): boolean;
+}
+export default Initializable;

package/dist/initializable.js

@@ -0,0 +1,311 @@
+"use strict";
+/* class Initializable {
+    retries: number;
+    initialized: boolean;
+    constructor(retries: number = 25) {
+        this.retries = retries;
+        this.initialized = false;
+        this.initialize();
+    }
+
+    protected initialize() {
+        this.initialized = true;
+    }
+
+    protected async isInitialized(): Promise<boolean> {
+        let retries = this.retries; // 5 seconds / 200ms = 25 retries
+
+        while (!this.initialized && retries > 0) {
+            await new Promise((resolve) => setTimeout(resolve, 200));
+            retries--;
+        }
+
+        if (!this.initialized) {
+            throw new Error("Initialization failed after 5 seconds");
+        }
+
+        return true;
+    }
+}
+
+export default Initializable;
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Base class for objects that require asynchronous initialization
+ *
+ * @example
+ * class Database extends Initializable {
+ *   private connection: any;
+ *
+ *   constructor() {
+ *     super({ retries: 10, retryInterval: 500 });
+ *   }
+ *
+ *   protected async doInitialize(): Promise<void> {
+ *     this.connection = await connectToDatabase();
+ *   }
+ * }
+ *
+ * // Usage
+ * const db = new Database();
+ * await db.initialize();
+ * // or check status
+ * if (await db.isInitialized()) {
+ *   // use the database
+ * }
+ */
+class Initializable {
+    /**
+     * Creates a new Initializable instance
+     * @param options Configuration options
+     */
+    constructor(options = {}) {
+        /** Whether initialization has completed successfully */
+        this._initialized = false;
+        /** Whether initialization is in progress */
+        this.initializing = false;
+        /** Whether initialization has failed */
+        this.failed = false;
+        /** Event listeners */
+        this.listeners = new Map();
+        /** Abort controller for cancellation */
+        this.abortController = null;
+        this.retries = options.retries ?? 25;
+        this.retryInterval = options.retryInterval ?? 200;
+        this.timeout = options.timeout;
+        if (options.autoInitialize) {
+            // Schedule initialization on next tick to allow subclass construction to complete
+            setTimeout(() => this.initialize(), 0);
+        }
+    }
+    /**
+     * Initialize the object
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if initialization fails
+     */
+    async initialize() {
+        // If already initialized, return immediately
+        if (this._initialized) {
+            return;
+        }
+        // If already initializing, wait for it to complete
+        if (this.initializing) {
+            return this.waitForInitialization();
+        }
+        // Start initialization
+        this.initializing = true;
+        this.failed = false;
+        this.abortController = new AbortController();
+        try {
+            // Emit initializing event
+            this.emit('initializing');
+            // Call the implementation-specific initialization
+            await this.doInitialize();
+            // Mark as initialized
+            this._initialized = true;
+            this.initializing = false;
+            // Emit initialized event
+            this.emit('initialized');
+        }
+        catch (error) {
+            // Mark as failed
+            this.failed = true;
+            this.initializing = false;
+            // Emit failed event
+            this.emit('failed', error);
+            // Re-throw the error
+            throw error instanceof Error
+                ? error
+                : new Error(`Initialization failed: ${String(error)}`);
+        }
+        finally {
+            this.abortController = null;
+        }
+    }
+    /**
+     * Implementation-specific initialization logic
+     * Override this method in subclasses to provide custom initialization
+     */
+    async doInitialize() {
+        // Default implementation does nothing
+        // Subclasses should override this method
+        this._initialized = true;
+    }
+    /**
+     * Check if the object is initialized
+     * @param waitForIt Whether to wait for initialization to complete
+     * @returns Promise that resolves to true if initialized, false otherwise
+     */
+    async isInitialized(waitForIt = false) {
+        // If already initialized, return immediately
+        if (this._initialized) {
+            return true;
+        }
+        // If not waiting or already failed, return current status
+        if (!waitForIt || this.failed) {
+            return this._initialized;
+        }
+        // Wait for initialization to complete
+        try {
+            await this.waitForInitialization();
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Wait for initialization to complete
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if initialization fails or times out
+     */
+    async waitForInitialization() {
+        // If already initialized, return immediately
+        if (this._initialized) {
+            return;
+        }
+        // If not initializing, start initialization
+        if (!this.initializing) {
+            return this.initialize();
+        }
+        const className = this.constructor.name;
+        const maxTime = this.timeout ?? (this.retries * this.retryInterval);
+        let retries = this.retries;
+        // Create a promise that resolves when initialization completes
+        return new Promise((resolve, reject) => {
+            // One-time event listeners for completion
+            const onInitialized = () => {
+                this.off('initialized', onInitialized);
+                this.off('failed', onFailed);
+                this.off('timeout', onTimeout);
+                resolve();
+            };
+            const onFailed = (error) => {
+                this.off('initialized', onInitialized);
+                this.off('failed', onFailed);
+                this.off('timeout', onTimeout);
+                reject(error);
+            };
+            const onTimeout = () => {
+                this.off('initialized', onInitialized);
+                this.off('failed', onFailed);
+                this.off('timeout', onTimeout);
+                reject(new Error(`Initialization of ${className} timed out after ${maxTime}ms`));
+            };
+            // Register event listeners
+            this.on('initialized', onInitialized);
+            this.on('failed', onFailed);
+            this.on('timeout', onTimeout);
+            // Set up polling to check for timeout
+            const checkInterval = setInterval(() => {
+                retries--;
+                if (this._initialized) {
+                    clearInterval(checkInterval);
+                    // Will be handled by event
+                }
+                else if (retries <= 0) {
+                    clearInterval(checkInterval);
+                    this.emit('timeout');
+                }
+            }, this.retryInterval);
+        });
+    }
+    /**
+     * Cancel initialization if in progress
+     */
+    cancel() {
+        if (this.initializing && this.abortController) {
+            this.abortController.abort();
+            this.initializing = false;
+            this.failed = true;
+            this.emit('failed', new Error('Initialization cancelled'));
+        }
+    }
+    /**
+     * Reset initialization state
+     * Allows re-initialization after failure
+     */
+    reset() {
+        if (this.initializing) {
+            this.cancel();
+        }
+        this._initialized = false;
+        this.initializing = false;
+        this.failed = false;
+    }
+    /**
+     * Register an event listener
+     * @param event Event name
+     * @param callback Function to call when event is emitted
+     * @returns this for chaining
+     */
+    on(event, callback) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, []);
+        }
+        this.listeners.get(event).push(callback);
+        return this;
+    }
+    /**
+     * Remove an event listener
+     * @param event Event name
+     * @param callback Function to remove
+     * @returns this for chaining
+     */
+    off(event, callback) {
+        if (this.listeners.has(event)) {
+            const callbacks = this.listeners.get(event);
+            const index = callbacks.indexOf(callback);
+            if (index !== -1) {
+                callbacks.splice(index, 1);
+            }
+        }
+        return this;
+    }
+    /**
+     * Emit an event
+     * @param event Event name
+     * @param args Arguments to pass to listeners
+     */
+    emit(event, ...args) {
+        if (this.listeners.has(event)) {
+            const callbacks = [...this.listeners.get(event)];
+            callbacks.forEach(callback => {
+                try {
+                    callback(...args);
+                }
+                catch (error) {
+                    console.error(`Error in ${event} event listener:`, error);
+                }
+            });
+        }
+    }
+    /**
+     * Get the abort signal for cancellation
+     * Can be passed to fetch or other cancellable operations
+     */
+    get abortSignal() {
+        return this.abortController?.signal;
+    }
+    /**
+     * Check if initialization has been completed
+     */
+    get initialized() {
+        return this._initialized;
+    }
+    /**
+     * Check if initialization is in progress
+     */
+    get isInitializing() {
+        return this.initializing;
+    }
+    /**
+     * Check if initialization has failed
+     */
+    get hasFailed() {
+        return this.failed;
+    }
+}
+exports.default = Initializable;
+//# sourceMappingURL=initializable.js.map

package/dist/initializable.js.map

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

package/dist/lib.d.ts

@@ -0,0 +1,67 @@
+import * as fs from "fs";
+declare class Lib {
+    static Log(...args: any): void;
+    static LogObject(object: any, text?: string): void;
+    static Warn(...args: any): void;
+    static $Log(...args: any): void;
+    static secondsToMilliseconds(seconds: number): number;
+    static minutesToMilliseconds(minutes: number): number;
+    static hoursToMilliseconds(hours: number): number;
+    static GetTimestamp(milliseconds_ago: number): Date;
+    static GetDateTimestamp(date: string | Date, format?: string, isUTC?: boolean): number;
+    static calculatePercentage(x: number, y: number): number;
+    static MYSQLTimestamp(): string;
+    static FormatUnixToDate(unix_time_stamp: number, in_milliseconds?: boolean): Date;
+    static FormatDate(date: Date | string, format?: string): string;
+    static DaysBetweenDates(startDate: Date | string | undefined, endDate: Date | string | undefined, format?: string): number;
+    static IsPastDate(date: Date | string, format?: string, debug?: boolean, currentDate?: Date | string): boolean;
+    static IsPastDateFrom(date: Date | string, from: Date | string, format?: string): boolean;
+    static addTimeFromDate(date: Date | string, milliseconds: number): Date;
+    static UUID(minLength?: number): string;
+    static Debounce(callback: (...args: any[]) => void, delay?: number): (...args: any[]) => any;
+    static IsNil(value: any): boolean;
+    static IsPrimitive(value: any): boolean;
+    static EmptyObject(value: any): boolean;
+    static IsNumpty(value: any, _objectsOnly?: boolean): boolean;
+    static IsEmpty(value: any, _objectsOnly?: boolean): boolean;
+    static IsArray(variable: any): boolean;
+    static IsString(variable: any): boolean;
+    static IsNumber(variable: any): boolean;
+    static IsObject(variable: any): boolean;
+    static IsFunction(variable: any): boolean;
+    static IsRegex(variable: any): boolean;
+    static IsBoolean(variable: any): boolean;
+    static GetType(value: any, asTypeOf?: boolean): null | string | boolean;
+    static GetProjectRoot(startDir?: string, rootReference?: string): string;
+    static RunTaskWithTimeout(task: () => Promise<void>, timeout: number): Promise<unknown>;
+    static GetFolderPath(folder: string): string;
+    static GetFilePath(folder: string, file: string): string;
+    static CreateDirectory(folderToCreate: string): Promise<string>;
+    static DeleteDirectory(folderToDelete: string): Promise<void>;
+    static CreateFile(folderPath: string, filePath: string, content: string): Promise<void>;
+    static GetFile(filePathFromRoot: string): fs.ReadStream;
+    static GetFilesInDirectory(directoryPath: string): string[];
+    static DeleteFile(filePathFromRoot: string): Promise<void>;
+    static Timestamp(log?: boolean): string;
+    static RemoveWhitespace(value: string): string;
+    static msToString(ms: number): string;
+    static FormatPhone(phone_number: string): string;
+    static ToMB(bytes: number, as_KB?: boolean, decimalPlaces?: number): string;
+    static ToGB(bytes: number, as_KB?: boolean, decimalPlaces?: number): string;
+    static RetryHandler<T extends (...args: any[]) => any>(func: T, retries?: number, ...args: Parameters<T>): Promise<ReturnType<T>>;
+    static Difference(x: any[], y: any[]): any[];
+    static ReadFileContent(filePath: string): Promise<string>;
+    static measureExecutionTime<T extends (...args: any[]) => any, U extends ReturnType<T>>(func: T, ...args: Parameters<T>): Promise<{
+        result: Awaited<U>;
+        time: number | string;
+    }>;
+    static ToCamelCase(str: string): string;
+    static ToSnakeCase(str: string): string;
+    static ToKebebCase(str: string): string;
+}
+export default Lib;
+export declare class Debug {
+    static Log(...args: any): void;
+    static $Log(...args: any): void;
+    static LogObject(object: any, text?: string): void;
+}