@zintrust/core 0.4.28 → 0.4.30

package/packages/workers/src/CircuitBreaker.js

@@ -1,374 +0,0 @@
-/**
- * Circuit Breaker Pattern
- * Fault tolerance with version tracking and automatic recovery
- * Sealed namespace for immutability
- */
-import { Logger } from '../../../src/index.js';
-// Internal state
-const circuits = new Map();
-const eventHistory = new Map();
-const defaultConfig = {
-    failureThreshold: 5,
-    successThreshold: 3,
-    timeout: 60000, // 1 minute
-    resetTimeout: 300000, // 5 minutes
-    volumeThreshold: 10,
-};
-/**
- * Helper: Get circuit key
- */
-const getCircuitKey = (workerName, version) => {
-    return `${workerName}:${version}`;
-};
-/**
- * Helper: Record event
- */
-const recordEvent = (event) => {
-    const key = getCircuitKey(event.workerName, event.version);
-    let history = eventHistory.get(key);
-    if (!history) {
-        history = [];
-        eventHistory.set(key, history);
-    }
-    history.push(event);
-    // Keep only last 1000 events
-    if (history.length > 1000) {
-        history.shift();
-    }
-    Logger.debug(`Circuit breaker event: ${event.workerName}:${event.version} - ${event.event}`, {
-        state: event.state,
-        reason: event.reason,
-    });
-};
-/**
- * Helper: Transition to new state
- */
-const transitionState = (circuit, newState, reason) => {
-    const oldState = circuit.state;
-    circuit.state = newState;
-    circuit.lastStateChange = new Date();
-    if (newState === 'open') {
-        circuit.nextRetryTime = new Date(Date.now() + defaultConfig.timeout);
-    }
-    else if (newState === 'closed') {
-        circuit.failureCount = 0;
-        circuit.successCount = 0;
-        circuit.nextRetryTime = null;
-    }
-    else if (newState === 'half-open') {
-        circuit.successCount = 0;
-        circuit.nextRetryTime = null;
-    }
-    Logger.info(`Circuit breaker state transition: ${circuit.workerName}:${circuit.version}`, {
-        from: oldState,
-        to: newState,
-        reason,
-    });
-    const eventType = newState === 'open' ? 'opened' : newState;
-    recordEvent({
-        workerName: circuit.workerName,
-        version: circuit.version,
-        event: eventType,
-        state: newState,
-        timestamp: new Date(),
-        reason,
-    });
-};
-/**
- * Helper: Calculate error rate
- */
-const calculateErrorRate = (circuit) => {
-    if (circuit.totalRequests === 0) {
-        return 0;
-    }
-    return (circuit.failureCount / circuit.totalRequests) * 100;
-};
-/**
- * Helper: Check if should reset failure count
- */
-const shouldResetFailureCount = (circuit) => {
-    if (!circuit.lastFailureTime) {
-        return false;
-    }
-    const timeSinceLastFailure = Date.now() - circuit.lastFailureTime.getTime();
-    return timeSinceLastFailure > defaultConfig.resetTimeout;
-};
-/**
- * Circuit Breaker - Sealed namespace
- */
-export const CircuitBreaker = Object.freeze({
-    /**
-     * Initialize circuit breaker for a worker version
-     */
-    initialize(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        if (circuits.has(key)) {
-            Logger.debug(`Circuit breaker already exists: ${key}`);
-            return;
-        }
-        const circuit = {
-            workerName,
-            version,
-            state: 'closed',
-            failureCount: 0,
-            successCount: 0,
-            totalRequests: 0,
-            lastFailureTime: null,
-            lastSuccessTime: null,
-            lastStateChange: new Date(),
-            nextRetryTime: null,
-            errorRate: 0,
-        };
-        circuits.set(key, circuit);
-        Logger.info(`Circuit breaker initialized: ${key}`);
-    },
-    /**
-     * Check if circuit allows execution
-     */
-    canExecute(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        if (!circuit) {
-            // No circuit exists, create and allow
-            CircuitBreaker.initialize(workerName, version);
-            return true;
-        }
-        const now = Date.now();
-        // Reset failure count if enough time has passed
-        if (circuit.state === 'closed' && shouldResetFailureCount(circuit)) {
-            circuit.failureCount = 0;
-            circuit.totalRequests = 0;
-            Logger.debug(`Reset failure count for ${key}`);
-        }
-        switch (circuit.state) {
-            case 'closed':
-                return true;
-            case 'open':
-                // Check if timeout has passed to try half-open
-                if (circuit.nextRetryTime && now >= circuit.nextRetryTime.getTime()) {
-                    transitionState(circuit, 'half-open', 'Timeout elapsed, attempting recovery');
-                    return true;
-                }
-                return false;
-            case 'half-open':
-                // Allow limited requests to test recovery
-                return true;
-        }
-    },
-    /**
-     * Record successful execution
-     */
-    recordSuccess(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        if (!circuit) {
-            CircuitBreaker.initialize(workerName, version);
-            return;
-        }
-        circuit.successCount++;
-        circuit.totalRequests++;
-        circuit.lastSuccessTime = new Date();
-        circuit.errorRate = calculateErrorRate(circuit);
-        recordEvent({
-            workerName,
-            version,
-            event: 'success',
-            state: circuit.state,
-            timestamp: new Date(),
-        });
-        // Transition based on state
-        if (circuit.state === 'half-open') {
-            if (circuit.successCount >= defaultConfig.successThreshold) {
-                transitionState(circuit, 'closed', `${circuit.successCount} consecutive successes`);
-            }
-        }
-    },
-    /**
-     * Record failed execution
-     */
-    recordFailure(workerName, version, error) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        if (!circuit) {
-            CircuitBreaker.initialize(workerName, version);
-            return;
-        }
-        circuit.failureCount++;
-        circuit.totalRequests++;
-        circuit.lastFailureTime = new Date();
-        circuit.errorRate = calculateErrorRate(circuit);
-        recordEvent({
-            workerName,
-            version,
-            event: 'failure',
-            state: circuit.state,
-            timestamp: new Date(),
-            error,
-        });
-        // Transition based on state and thresholds
-        if (circuit.state === 'half-open') {
-            // Any failure in half-open reopens the circuit
-            transitionState(circuit, 'open', 'Failure during recovery attempt');
-        }
-        else if (circuit.state === 'closed') {
-            // Check if should open based on failure threshold
-            if (circuit.totalRequests >= defaultConfig.volumeThreshold) {
-                if (circuit.failureCount >= defaultConfig.failureThreshold) {
-                    transitionState(circuit, 'open', `Failure threshold exceeded: ${circuit.failureCount}/${defaultConfig.failureThreshold}`);
-                }
-            }
-        }
-    },
-    /**
-     * Record rejected execution (when circuit is open)
-     */
-    recordRejection(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        if (!circuit) {
-            return;
-        }
-        recordEvent({
-            workerName,
-            version,
-            event: 'rejected',
-            state: circuit.state,
-            timestamp: new Date(),
-            reason: 'Circuit breaker is open',
-        });
-    },
-    /**
-     * Get circuit state
-     */
-    getState(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        return circuit ? { ...circuit } : null;
-    },
-    /**
-     * Get all circuit states
-     */
-    getAllStates() {
-        return Array.from(circuits.values()).map((circuit) => ({ ...circuit }));
-    },
-    /**
-     * Get circuit states by worker name (all versions)
-     */
-    getStatesByWorker(workerName) {
-        const states = [];
-        for (const circuit of circuits.values()) {
-            if (circuit.workerName === workerName) {
-                states.push({ ...circuit });
-            }
-        }
-        return states;
-    },
-    /**
-     * Get event history
-     */
-    getEventHistory(workerName, version, limit = 100) {
-        const key = getCircuitKey(workerName, version);
-        const history = eventHistory.get(key) ?? [];
-        return history.slice(-limit).map((event) => ({ ...event }));
-    },
-    /**
-     * Manually reset circuit to closed state
-     */
-    reset(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        if (!circuit) {
-            Logger.warn(`Circuit breaker not found: ${key}`);
-            return;
-        }
-        transitionState(circuit, 'closed', 'Manual reset');
-        circuit.failureCount = 0;
-        circuit.successCount = 0;
-        circuit.totalRequests = 0;
-        circuit.errorRate = 0;
-        Logger.info(`Circuit breaker manually reset: ${key}`);
-    },
-    /**
-     * Manually force circuit to open state
-     */
-    forceOpen(workerName, version, reason) {
-        const key = getCircuitKey(workerName, version);
-        const circuit = circuits.get(key);
-        if (!circuit) {
-            CircuitBreaker.initialize(workerName, version);
-            const newCircuit = circuits.get(key);
-            if (!newCircuit) {
-                return;
-            }
-            transitionState(newCircuit, 'open', `Forced open: ${reason}`);
-            return;
-        }
-        transitionState(circuit, 'open', `Forced open: ${reason}`);
-        Logger.warn(`Circuit breaker forced open: ${key}`, { reason });
-    },
-    /**
-     * Delete circuit breaker
-     */
-    delete(workerName, version) {
-        const key = getCircuitKey(workerName, version);
-        circuits.delete(key);
-        eventHistory.delete(key);
-        Logger.info(`Circuit breaker deleted: ${key}`);
-    },
-    /**
-     * Delete all circuit breakers for a worker (all versions)
-     */
-    deleteWorker(workerName) {
-        const keysToDelete = [];
-        for (const [key, circuit] of circuits.entries()) {
-            if (circuit.workerName === workerName) {
-                keysToDelete.push(key);
-            }
-        }
-        for (const key of keysToDelete) {
-            circuits.delete(key);
-            eventHistory.delete(key);
-        }
-        Logger.info(`Deleted all circuit breakers for worker: ${workerName}`, {
-            count: keysToDelete.length,
-        });
-    },
-    /**
-     * Get summary statistics
-     */
-    getSummary() {
-        const summary = {
-            totalCircuits: circuits.size,
-            openCircuits: 0,
-            halfOpenCircuits: 0,
-            closedCircuits: 0,
-            circuitsByWorker: {},
-        };
-        for (const circuit of circuits.values()) {
-            switch (circuit.state) {
-                case 'open':
-                    summary.openCircuits++;
-                    break;
-                case 'half-open':
-                    summary.halfOpenCircuits++;
-                    break;
-                case 'closed':
-                    summary.closedCircuits++;
-                    break;
-            }
-            summary.circuitsByWorker[circuit.workerName] =
-                (summary.circuitsByWorker[circuit.workerName] || 0) + 1;
-        }
-        return summary;
-    },
-    /**
-     * Shutdown and clear all circuits
-     */
-    shutdown() {
-        Logger.info('CircuitBreaker shutting down...');
-        circuits.clear();
-        eventHistory.clear();
-        Logger.info('CircuitBreaker shutdown complete');
-    },
-});
-// Graceful shutdown handled by WorkerShutdown

package/packages/workers/src/ClusterLock.d.ts

@@ -1,91 +0,0 @@
-/**
- * Cluster Lock Manager
- * Distributed locking using Redis for multi-instance worker coordination
- * Sealed namespace for immutability
- */
-import { type RedisConfig } from '../../../src/index.js';
-export type LockAcquisitionOptions = {
-    lockKey: string;
-    ttl: number;
-    region?: string;
-    userId?: string;
-};
-export type LockInfo = {
-    lockKey: string;
-    instanceId: string;
-    acquiredAt: Date;
-    expiresAt: Date;
-    region: string;
-    userId?: string;
-};
-export type AuditLogEntry = {
-    timestamp: Date;
-    operation: 'acquire' | 'release' | 'extend' | 'force-release';
-    lockKey: string;
-    instanceId: string;
-    userId?: string;
-    reason?: string;
-    success: boolean;
-};
-/**
- * Cluster Lock Manager - Sealed namespace
- */
-export declare const ClusterLock: Readonly<{
-    /**
-     * Initialize the lock manager with Redis connection
-     */
-    initialize(config: RedisConfig): void;
-    /**
-     * Acquire a distributed lock
-     */
-    acquire(options: LockAcquisitionOptions): Promise<boolean>;
-    /**
-     * Release a distributed lock
-     */
-    release(lockKey: string, userId?: string): Promise<boolean>;
-    /**
-     * Extend lock TTL
-     */
-    extend(lockKey: string, ttl: number): Promise<boolean>;
-    /**
-     * Check if lock is held by this instance
-     */
-    isHeldByMe(lockKey: string): Promise<boolean>;
-    /**
-     * Force release a lock (admin operation)
-     */
-    forceRelease(lockKey: string, userId: string, reason: string): Promise<boolean>;
-    /**
-     * List all locks
-     */
-    listLocks(): Promise<ReadonlyArray<{
-        key: string;
-        owner: string;
-        region?: string;
-    }>>;
-    /**
-     * Get lock owner
-     */
-    getLockOwner(lockKey: string): Promise<string | null>;
-    /**
-     * Get locks by region
-     */
-    getLocksByRegion(region: string): ReadonlyArray<LockInfo>;
-    /**
-     * Get audit log for a lock
-     */
-    getAuditLog(lockKey: string, limit?: number): Promise<ReadonlyArray<AuditLogEntry>>;
-    /**
-     * Get active locks held by this instance
-     */
-    getActiveLocks(): ReadonlyArray<LockInfo>;
-    /**
-     * Get instance ID
-     */
-    getInstanceId(): string;
-    /**
-     * Shutdown and release all locks
-     */
-    shutdown(): Promise<void>;
-}>;
-//# sourceMappingURL=ClusterLock.d.ts.map

package/packages/workers/src/ClusterLock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClusterLock.d.ts","sourceRoot":"","sources":["../../../../packages/workers/src/ClusterLock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AA6IF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;uBACgB,WAAW,GAAG,IAAI;IAarC;;OAEG;qBACoB,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAgEhE;;OAEG;qBACoB,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsCjE;;OAEG;oBACmB,MAAM,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB5D;;OAEG;wBACuB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWnD;;OAEG;0BACyB,MAAM,UAAU,MAAM,UAAU,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8CrF;;OAEG;iBACgB,OAAO,CAAC,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA8B1F;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS3D;;OAEG;6BACsB,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC;IAYzD;;OAEG;yBACwB,MAAM,mBAAgB,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAkBtF;;OAEG;sBACe,aAAa,CAAC,QAAQ,CAAC;IAIzC;;OAEG;qBACc,MAAM;IAIvB;;OAEG;gBACe,OAAO,CAAC,IAAI,CAAC;EAuB/B,CAAC"}