topsyde-utils 1.0.3 → 1.0.5

package/dist/initializable.js

@@ -1,309 +0,0 @@
-"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

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