@fsai-flow/core 0.0.3 → 0.0.4

package/dist/src/lib/RedisLeaderElectionManager.d.ts

@@ -0,0 +1,53 @@
+import { RedisOptions } from 'ioredis';
+export interface RedisLeaderElectionCallbacks {
+    onStartedLeading: () => void;
+    onStoppedLeading: () => void;
+    onNewLeader?: (identity: string) => void;
+}
+export declare class RedisLeaderElectionManager {
+    private redis;
+    private isLeader;
+    private lockKey;
+    private nodeId;
+    private lockTTL;
+    private renewalInterval;
+    private renewalTimer?;
+    private callbacks;
+    constructor(lockKey: string, redisConfig: string | RedisOptions, callbacks: RedisLeaderElectionCallbacks);
+    /**
+     * Wait for Redis connection to be ready
+     */
+    private waitForRedisConnection;
+    /**
+     * Start the leader election process
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the leader election process
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if this node is currently the leader
+     */
+    getIsLeader(): boolean;
+    /**
+     * Try to acquire leadership
+     */
+    private tryAcquireLeadership;
+    /**
+     * Renew the leadership lock
+     */
+    private renewLock;
+    /**
+     * Release the leadership lock
+     */
+    private releaseLock;
+    /**
+     * Start the renewal/retry loop
+     */
+    private startRenewalLoop;
+    /**
+     * Generate a unique node identifier
+     */
+    private generateNodeId;
+}

package/dist/src/lib/RedisLeaderElectionManager.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisLeaderElectionManager = void 0;
+const tslib_1 = require("tslib");
+const ioredis_1 = tslib_1.__importDefault(require("ioredis"));
+const workflow_1 = require("@fsai-flow/workflow");
+class RedisLeaderElectionManager {
+    constructor(lockKey, redisConfig, callbacks) {
+        this.isLeader = false;
+        this.lockTTL = 30000; // 30 seconds in milliseconds
+        this.renewalInterval = 10000; // 10 seconds in milliseconds
+        this.lockKey = `leader:${lockKey}`;
+        this.nodeId = this.generateNodeId();
+        this.callbacks = callbacks;
+        // Initialize Redis connection
+        if (typeof redisConfig === 'string') {
+            this.redis = new ioredis_1.default(redisConfig);
+        }
+        else {
+            this.redis = new ioredis_1.default(redisConfig);
+        }
+        // Handle Redis connection events
+        this.redis.on('connect', () => {
+            workflow_1.LoggerProxy.info(`Redis connected for leader election: ${this.lockKey}`);
+        });
+        this.redis.on('ready', () => {
+            workflow_1.LoggerProxy.info(`Redis ready for leader election: ${this.lockKey}`);
+        });
+        this.redis.on('error', (error) => {
+            workflow_1.LoggerProxy.error(`Redis connection error for leader election: ${error.message}`);
+        });
+    }
+    /**
+     * Wait for Redis connection to be ready
+     */
+    waitForRedisConnection() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                if (this.redis.status === 'ready') {
+                    workflow_1.LoggerProxy.debug(`Redis already ready for ${this.lockKey}`);
+                    resolve();
+                    return;
+                }
+                let isSettled = false;
+                let timeoutId = null;
+                // Cleanup function to prevent memory leaks
+                const cleanup = () => {
+                    if (isSettled)
+                        return; // Already cleaned up
+                    isSettled = true;
+                    // Clear timeout safely
+                    if (timeoutId !== null) {
+                        clearTimeout(timeoutId);
+                        timeoutId = null;
+                    }
+                    // Remove event listeners safely
+                    try {
+                        this.redis.off('ready', onReady);
+                        this.redis.off('error', onError);
+                    }
+                    catch (error) {
+                        // Ignore cleanup errors - Redis connection might be destroyed
+                        workflow_1.LoggerProxy.debug(`Cleanup warning for ${this.lockKey}: ${error}`);
+                    }
+                };
+                const onReady = () => {
+                    cleanup();
+                    workflow_1.LoggerProxy.debug(`Redis connection established for ${this.lockKey}`);
+                    resolve();
+                };
+                const onError = (error) => {
+                    cleanup();
+                    workflow_1.LoggerProxy.error(`Redis connection failed for ${this.lockKey}: ${error.message}`);
+                    reject(error);
+                };
+                const onTimeout = () => {
+                    cleanup();
+                    reject(new Error(`Redis connection timeout after 10 seconds for ${this.lockKey}`));
+                };
+                // Set up timeout
+                timeoutId = setTimeout(onTimeout, 10000); // 10 second timeout
+                // Set up event listeners
+                this.redis.once('ready', onReady);
+                this.redis.once('error', onError);
+            });
+        });
+    }
+    /**
+     * Start the leader election process
+     */
+    start() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            workflow_1.LoggerProxy.info(`🚀 Starting Redis leader election for ${this.nodeId} on key ${this.lockKey}`);
+            workflow_1.LoggerProxy.info(`🔧 Leader election config: TTL=${this.lockTTL}ms, RenewalInterval=${this.renewalInterval}ms`);
+            // Wait for Redis connection to be ready
+            workflow_1.LoggerProxy.info(`⏳ ${this.nodeId} waiting for Redis connection...`);
+            yield this.waitForRedisConnection();
+            workflow_1.LoggerProxy.info(`✅ Redis connection ready for ${this.nodeId}`);
+            // Try to acquire leadership immediately
+            workflow_1.LoggerProxy.info(`🎯 ${this.nodeId} making initial leadership attempt...`);
+            yield this.tryAcquireLeadership();
+            // Start the renewal/retry loop
+            this.startRenewalLoop();
+            workflow_1.LoggerProxy.info(`✅ Leader election process started for ${this.nodeId}`);
+        });
+    }
+    /**
+     * Stop the leader election process
+     */
+    stop() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            workflow_1.LoggerProxy.info(`🛑 Stopping Redis leader election for ${this.nodeId}`);
+            // Stop renewal timer
+            if (this.renewalTimer) {
+                workflow_1.LoggerProxy.debug(`⏹️  Stopping leadership monitoring loop for ${this.nodeId}`);
+                clearInterval(this.renewalTimer);
+                this.renewalTimer = undefined;
+            }
+            // Release leadership if we have it
+            if (this.isLeader) {
+                workflow_1.LoggerProxy.info(`👋 ${this.nodeId} releasing leadership voluntarily for ${this.lockKey}`);
+                yield this.releaseLock();
+            }
+            // Close Redis connection
+            workflow_1.LoggerProxy.debug(`🔌 Disconnecting Redis for ${this.nodeId}`);
+            this.redis.disconnect();
+            workflow_1.LoggerProxy.info(`✅ Leader election stopped for ${this.nodeId}`);
+        });
+    }
+    /**
+     * Check if this node is currently the leader
+     */
+    getIsLeader() {
+        return this.isLeader;
+    }
+    /**
+     * Try to acquire leadership
+     */
+    tryAcquireLeadership() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                // Check if Redis connection is ready before attempting operations
+                if (this.redis.status !== 'ready') {
+                    workflow_1.LoggerProxy.warn(`Redis not ready for ${this.nodeId}, current status: ${this.redis.status}`);
+                    return false;
+                }
+                workflow_1.LoggerProxy.debug(`Node ${this.nodeId} attempting to acquire leadership for ${this.lockKey}`);
+                // Use SET with NX (not exists) and PX (expire in milliseconds)
+                const result = yield this.redis.set(this.lockKey, this.nodeId, 'PX', this.lockTTL, 'NX');
+                if (result === 'OK') {
+                    // Successfully acquired leadership
+                    if (!this.isLeader) {
+                        this.isLeader = true;
+                        workflow_1.LoggerProxy.info(`🏆 Node ${this.nodeId} ACQUIRED LEADERSHIP for ${this.lockKey} (TTL: ${this.lockTTL}ms)`);
+                        this.callbacks.onStartedLeading();
+                    }
+                    else {
+                        workflow_1.LoggerProxy.debug(`Node ${this.nodeId} renewed leadership lock for ${this.lockKey}`);
+                    }
+                    return true;
+                }
+                else {
+                    // Failed to acquire leadership - check who is the current leader
+                    const currentLeader = yield this.redis.get(this.lockKey);
+                    const lockTTL = yield this.redis.pttl(this.lockKey);
+                    if (currentLeader) {
+                        if (currentLeader !== this.nodeId) {
+                            workflow_1.LoggerProxy.debug(`👑 Node ${this.nodeId} sees ${currentLeader} is the current leader for ${this.lockKey} (TTL: ${lockTTL}ms)`);
+                            if (this.callbacks.onNewLeader) {
+                                this.callbacks.onNewLeader(currentLeader);
+                            }
+                        }
+                    }
+                    else {
+                        workflow_1.LoggerProxy.debug(`Node ${this.nodeId} found no current leader for ${this.lockKey}, but failed to acquire lock`);
+                    }
+                    // Lost leadership if we previously had it
+                    if (this.isLeader) {
+                        this.isLeader = false;
+                        workflow_1.LoggerProxy.info(`📉 Node ${this.nodeId} LOST LEADERSHIP for ${this.lockKey}`);
+                        this.callbacks.onStoppedLeading();
+                    }
+                    return false;
+                }
+            }
+            catch (error) {
+                workflow_1.LoggerProxy.error(`❌ Error during leader election for ${this.nodeId}: ${error.message}`);
+                // If we had leadership and there's an error, assume we lost it
+                if (this.isLeader) {
+                    this.isLeader = false;
+                    workflow_1.LoggerProxy.info(`💥 Node ${this.nodeId} LOST LEADERSHIP due to error: ${this.lockKey}`);
+                    this.callbacks.onStoppedLeading();
+                }
+                return false;
+            }
+        });
+    }
+    /**
+     * Renew the leadership lock
+     */
+    renewLock() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                // Check if Redis connection is ready before attempting operations
+                if (this.redis.status !== 'ready') {
+                    workflow_1.LoggerProxy.warn(`Redis not ready for ${this.nodeId} renewal, current status: ${this.redis.status}`);
+                    return false;
+                }
+                workflow_1.LoggerProxy.debug(`🔄 Node ${this.nodeId} attempting to renew leadership for ${this.lockKey}`);
+                // Use Lua script to atomically check ownership and renew
+                const script = `
+				if redis.call("get", KEYS[1]) == ARGV[1] then
+					return redis.call("pexpire", KEYS[1], ARGV[2])
+				else
+					return 0
+				end
+			`;
+                const result = yield this.redis.eval(script, 1, this.lockKey, this.nodeId, this.lockTTL.toString());
+                if (result === 1) {
+                    workflow_1.LoggerProxy.debug(`✅ Node ${this.nodeId} successfully renewed leadership for ${this.lockKey} (TTL: ${this.lockTTL}ms)`);
+                    return true;
+                }
+                else {
+                    workflow_1.LoggerProxy.warn(`⚠️  Node ${this.nodeId} failed to renew leadership for ${this.lockKey} - lock no longer owned by this node`);
+                    return false;
+                }
+            }
+            catch (error) {
+                workflow_1.LoggerProxy.error(`❌ Error renewing leadership lock for ${this.nodeId}: ${error.message}`);
+                return false;
+            }
+        });
+    }
+    /**
+     * Release the leadership lock
+     */
+    releaseLock() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                // Use Lua script to atomically check ownership and delete
+                const script = `
+				if redis.call("get", KEYS[1]) == ARGV[1] then
+					return redis.call("del", KEYS[1])
+				else
+					return 0
+				end
+			`;
+                yield this.redis.eval(script, 1, this.lockKey, this.nodeId);
+                workflow_1.LoggerProxy.info(`Node ${this.nodeId} released leadership lock for ${this.lockKey}`);
+            }
+            catch (error) {
+                workflow_1.LoggerProxy.error(`Error releasing lock for ${this.nodeId}: ${error.message}`);
+            }
+        });
+    }
+    /**
+     * Start the renewal/retry loop
+     */
+    startRenewalLoop() {
+        workflow_1.LoggerProxy.info(`Starting leadership monitoring loop for ${this.nodeId} (check every ${this.renewalInterval}ms)`);
+        this.renewalTimer = setInterval(() => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (this.isLeader) {
+                // Leader: Try to renew the lock
+                workflow_1.LoggerProxy.debug(`⏰ [LEADER] Node ${this.nodeId} periodic leadership renewal check`);
+                const renewed = yield this.renewLock();
+                if (!renewed) {
+                    // Failed to renew - we lost leadership
+                    this.isLeader = false;
+                    workflow_1.LoggerProxy.info(`💔 [LEADER] Node ${this.nodeId} LOST LEADERSHIP (failed to renew) for ${this.lockKey}`);
+                    this.callbacks.onStoppedLeading();
+                }
+                else {
+                    // Successfully renewed - keeping leadership
+                    //Logger.info(`🔒 [LEADER] Node ${this.nodeId} RENEWED LEADERSHIP - staying active for ${this.lockKey}`);
+                }
+            }
+            else {
+                // Follower: Try to acquire leadership
+                workflow_1.LoggerProxy.debug(`⏰ [FOLLOWER] Node ${this.nodeId} checking for available leadership`);
+                yield this.tryAcquireLeadership();
+            }
+        }), this.renewalInterval);
+    }
+    /**
+     * Generate a unique node identifier
+     */
+    generateNodeId() {
+        return process.env['POD_NAME'] ||
+            process.env['HOSTNAME'] ||
+            `node-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+exports.RedisLeaderElectionManager = RedisLeaderElectionManager;
+//# sourceMappingURL=RedisLeaderElectionManager.js.map

package/dist/src/lib/RedisLeaderElectionManager.js.map

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

package/dist/src/lib/UserSettings.d.ts

@@ -0,0 +1,80 @@
+import { IUserSettings } from '..';
+/**
+ * Creates the user settings if they do not exist yet
+ *
+ * @export
+ */
+export declare function prepareUserSettings(): Promise<IUserSettings>;
+/**
+ * Returns the encryption key which is used to encrypt
+ * the credentials.
+ *
+ * @export
+ * @returns
+ */
+export declare function getEncryptionKey(): Promise<string | undefined>;
+/**
+ * Returns the instance ID
+ *
+ * @export
+ * @returns
+ */
+export declare function getInstanceId(): Promise<string>;
+/**
+ * Adds/Overwrite the given settings in the currently
+ * saved user settings
+ *
+ * @export
+ * @param {IUserSettings} addSettings  The settings to add/overwrite
+ * @param {string} [settingsPath] Optional settings file path
+ * @returns {Promise<IUserSettings>}
+ */
+export declare function addToUserSettings(addSettings: IUserSettings, settingsPath?: string): Promise<IUserSettings>;
+/**
+ * Writes a user settings file
+ *
+ * @export
+ * @param {IUserSettings} userSettings The settings to write
+ * @param {string} [settingsPath] Optional settings file path
+ * @returns {Promise<IUserSettings>}
+ */
+export declare function writeUserSettings(userSettings: IUserSettings, settingsPath?: string): Promise<IUserSettings>;
+/**
+ * Returns the content of the user settings
+ *
+ * @export
+ * @returns {UserSettings}
+ */
+export declare function getUserSettings(settingsPath?: string, ignoreCache?: boolean): Promise<IUserSettings | undefined>;
+/**
+ * Returns the path to the user settings
+ *
+ * @export
+ * @returns {string}
+ */
+export declare function getUserSettingsPath(): string;
+/**
+ * Retruns the path to the n8n folder in which all n8n
+ * related data gets saved
+ *
+ * @export
+ * @returns {string}
+ */
+export declare function getUserN8nFolderPath(): string;
+/**
+ * Returns the path to the n8n user folder with the custom
+ * extensions like nodes and credentials
+ *
+ * @export
+ * @returns {string}
+ */
+export declare function getUserN8nFolderCustomExtensionPath(): string;
+/**
+ * Returns the home folder path of the user if
+ * none can be found it falls back to the current
+ * working directory
+ *
+ * @export
+ * @returns {string}
+ */
+export declare function getUserHome(): string;