@shadow-corp/nearconnect 1.0.0

package/build/connection/reconnect.js

@@ -0,0 +1,454 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconnectionManager = exports.DEFAULT_RECONNECT_CONFIG = exports.DEFAULT_RECONNECT_TRIGGERS = void 0;
+exports.createReconnectionManager = createReconnectionManager;
+const errors_1 = require("../errors");
+const retry_1 = require("./retry");
+/**
+ * Default reconnection triggers
+ */
+exports.DEFAULT_RECONNECT_TRIGGERS = {
+    visibilityChange: true,
+    networkChange: true,
+    wakeFromSleep: true,
+    heartbeatFailure: true,
+    userActivity: false,
+};
+/**
+ * Default reconnection configuration
+ */
+exports.DEFAULT_RECONNECT_CONFIG = {
+    autoReconnect: true,
+    reconnectOn: exports.DEFAULT_RECONNECT_TRIGGERS,
+    maxReconnectAttempts: 5,
+    backoff: {
+        maxAttempts: 5,
+        baseDelay: 1000,
+        maxDelay: 30000,
+        backoffMultiplier: 2,
+        jitter: true,
+    },
+    preserveQueue: true,
+    silentReconnect: true,
+    minReconnectInterval: 1000,
+    visibilityDebounce: 500,
+    sleepThreshold: 30000,
+};
+/**
+ * Reconnection Manager
+ *
+ * Handles automatic reconnection with various triggers:
+ * - Page visibility changes (tab focus)
+ * - Network status changes
+ * - System wake from sleep
+ * - Heartbeat failures
+ */
+class ReconnectionManager {
+    config;
+    state;
+    reconnectFn;
+    listeners = new Map();
+    // Browser event listeners
+    visibilityHandler = null;
+    networkHandler = null;
+    activityHandler = null;
+    // Timers and tracking
+    lastActivityTime = Date.now();
+    lastCheckTime = Date.now();
+    sleepCheckInterval = null;
+    visibilityDebounceTimer = null;
+    reconnectTimer = null;
+    operationIdCounter = 0;
+    constructor(reconnectFn, config = {}) {
+        this.reconnectFn = reconnectFn;
+        this.config = {
+            ...exports.DEFAULT_RECONNECT_CONFIG,
+            ...config,
+            reconnectOn: { ...exports.DEFAULT_RECONNECT_TRIGGERS, ...config.reconnectOn },
+            backoff: { ...exports.DEFAULT_RECONNECT_CONFIG.backoff, ...config.backoff },
+        };
+        this.state = this.createInitialState();
+    }
+    /**
+     * Create initial state
+     */
+    createInitialState() {
+        return {
+            attempting: false,
+            attempt: 0,
+            lastAttempt: 0,
+            queuedOperations: [],
+            lastTrigger: null,
+            disabled: false,
+        };
+    }
+    /**
+     * Start listening for reconnection triggers
+     */
+    start() {
+        if (typeof window === "undefined")
+            return;
+        // Visibility change
+        if (this.config.reconnectOn.visibilityChange) {
+            this.visibilityHandler = this.handleVisibilityChange.bind(this);
+            document.addEventListener("visibilitychange", this.visibilityHandler);
+        }
+        // Network change
+        if (this.config.reconnectOn.networkChange) {
+            this.networkHandler = this.handleNetworkChange.bind(this);
+            window.addEventListener("online", this.networkHandler);
+            window.addEventListener("offline", this.networkHandler);
+        }
+        // User activity
+        if (this.config.reconnectOn.userActivity) {
+            this.activityHandler = this.handleUserActivity.bind(this);
+            window.addEventListener("mousemove", this.activityHandler, { passive: true });
+            window.addEventListener("keydown", this.activityHandler, { passive: true });
+            window.addEventListener("touchstart", this.activityHandler, { passive: true });
+        }
+        // Wake from sleep detection
+        if (this.config.reconnectOn.wakeFromSleep) {
+            this.startSleepDetection();
+        }
+    }
+    /**
+     * Stop listening for reconnection triggers
+     */
+    stop() {
+        if (typeof window === "undefined")
+            return;
+        if (this.visibilityHandler) {
+            document.removeEventListener("visibilitychange", this.visibilityHandler);
+            this.visibilityHandler = null;
+        }
+        if (this.networkHandler) {
+            window.removeEventListener("online", this.networkHandler);
+            window.removeEventListener("offline", this.networkHandler);
+            this.networkHandler = null;
+        }
+        if (this.activityHandler) {
+            window.removeEventListener("mousemove", this.activityHandler);
+            window.removeEventListener("keydown", this.activityHandler);
+            window.removeEventListener("touchstart", this.activityHandler);
+            this.activityHandler = null;
+        }
+        this.stopSleepDetection();
+        this.cancelReconnect();
+    }
+    /**
+     * Handle visibility change
+     */
+    handleVisibilityChange() {
+        const visible = document.visibilityState === "visible";
+        this.emit("trigger:visibility", { visible });
+        if (visible) {
+            // Debounce to avoid rapid reconnects
+            if (this.visibilityDebounceTimer) {
+                clearTimeout(this.visibilityDebounceTimer);
+            }
+            this.visibilityDebounceTimer = setTimeout(() => {
+                this.trigger("visibilityChange");
+            }, this.config.visibilityDebounce);
+        }
+    }
+    /**
+     * Handle network change
+     */
+    handleNetworkChange() {
+        const online = navigator.onLine;
+        this.emit("trigger:network", { online });
+        if (online) {
+            this.trigger("networkChange");
+        }
+    }
+    /**
+     * Handle user activity
+     */
+    handleUserActivity() {
+        this.lastActivityTime = Date.now();
+    }
+    /**
+     * Start sleep detection
+     */
+    startSleepDetection() {
+        this.lastCheckTime = Date.now();
+        this.sleepCheckInterval = setInterval(() => {
+            const now = Date.now();
+            const elapsed = now - this.lastCheckTime;
+            // If elapsed time is much greater than interval, system was asleep
+            if (elapsed > this.config.sleepThreshold) {
+                this.emit("trigger:wake", { sleepDuration: elapsed });
+                this.trigger("wakeFromSleep");
+            }
+            this.lastCheckTime = now;
+        }, 10000); // Check every 10 seconds
+    }
+    /**
+     * Stop sleep detection
+     */
+    stopSleepDetection() {
+        if (this.sleepCheckInterval) {
+            clearInterval(this.sleepCheckInterval);
+            this.sleepCheckInterval = null;
+        }
+    }
+    /**
+     * Trigger reconnection
+     */
+    async trigger(reason) {
+        if (!this.config.autoReconnect || this.state.disabled) {
+            return false;
+        }
+        // Don't interrupt ongoing reconnect
+        if (this.state.attempting) {
+            return false;
+        }
+        // Enforce minimum interval
+        if (Date.now() - this.state.lastAttempt < this.config.minReconnectInterval) {
+            return false;
+        }
+        this.state.lastTrigger = reason;
+        return this.attemptReconnect();
+    }
+    /**
+     * Attempt reconnection with retries
+     */
+    async attemptReconnect() {
+        this.state.attempting = true;
+        this.state.attempt = 0;
+        const maxAttempts = this.config.maxReconnectAttempts;
+        const backoff = { ...retry_1.DEFAULT_RETRY_CONFIG, ...this.config.backoff };
+        while (this.state.attempt < maxAttempts) {
+            this.state.attempt++;
+            this.state.lastAttempt = Date.now();
+            this.emit("reconnect:started", {
+                attempt: this.state.attempt,
+                trigger: this.state.lastTrigger || "unknown",
+            });
+            try {
+                const success = await this.reconnectFn();
+                if (success) {
+                    this.emit("reconnect:success", {
+                        attempt: this.state.attempt,
+                        trigger: this.state.lastTrigger || "unknown",
+                    });
+                    this.state.attempting = false;
+                    // Replay queued operations
+                    if (this.config.preserveQueue && this.state.queuedOperations.length > 0) {
+                        await this.replayQueue();
+                    }
+                    return true;
+                }
+            }
+            catch (error) {
+                const willRetry = this.state.attempt < maxAttempts;
+                this.emit("reconnect:failed", {
+                    attempt: this.state.attempt,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                    willRetry,
+                });
+                if (willRetry) {
+                    // Wait before next attempt
+                    const delay = (0, retry_1.calculateBackoffDelay)(this.state.attempt - 1, backoff);
+                    await this.wait(delay);
+                }
+            }
+        }
+        // All attempts exhausted
+        this.emit("reconnect:exhausted", {
+            attempts: this.state.attempt,
+            trigger: this.state.lastTrigger || "unknown",
+        });
+        this.state.attempting = false;
+        return false;
+    }
+    /**
+     * Cancel ongoing reconnection
+     */
+    cancelReconnect() {
+        if (this.state.attempting) {
+            this.state.attempting = false;
+            this.emit("reconnect:cancelled", { reason: "manual" });
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.visibilityDebounceTimer) {
+            clearTimeout(this.visibilityDebounceTimer);
+            this.visibilityDebounceTimer = null;
+        }
+    }
+    /**
+     * Queue an operation for replay after reconnect
+     */
+    queueOperation(type, payload, maxRetries = 3) {
+        return new Promise((resolve, reject) => {
+            const operation = {
+                id: `op_${++this.operationIdCounter}_${Date.now()}`,
+                type,
+                payload,
+                timestamp: Date.now(),
+                retries: 0,
+                maxRetries,
+                resolve: resolve,
+                reject,
+            };
+            this.state.queuedOperations.push(operation);
+            this.emit("queue:added", { operation });
+        });
+    }
+    /**
+     * Remove an operation from the queue
+     */
+    removeOperation(operationId) {
+        const index = this.state.queuedOperations.findIndex((op) => op.id === operationId);
+        if (index !== -1) {
+            const [removed] = this.state.queuedOperations.splice(index, 1);
+            removed.reject(new errors_1.WalletError({
+                code: errors_1.ErrorCode.USER_REJECTED,
+                message: "Operation cancelled",
+            }));
+            this.emit("queue:removed", { operationId });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Clear all queued operations
+     */
+    clearQueue() {
+        for (const op of this.state.queuedOperations) {
+            op.reject(new errors_1.WalletError({
+                code: errors_1.ErrorCode.USER_REJECTED,
+                message: "Queue cleared",
+            }));
+        }
+        this.state.queuedOperations = [];
+    }
+    /**
+     * Replay queued operations
+     */
+    async replayQueue() {
+        const operations = [...this.state.queuedOperations];
+        this.state.queuedOperations = [];
+        this.emit("queue:replaying", { operations });
+        let successful = 0;
+        let failed = 0;
+        for (const op of operations) {
+            try {
+                // The actual replay logic would be implemented by the caller
+                // through a custom replay handler
+                // For now, we just resolve with null and let the caller handle it
+                op.resolve(null);
+                successful++;
+            }
+            catch (error) {
+                op.reject(error);
+                failed++;
+            }
+        }
+        this.emit("queue:replayed", { successful, failed });
+    }
+    /**
+     * Get reconnection state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get queued operations count
+     */
+    getQueueSize() {
+        return this.state.queuedOperations.length;
+    }
+    /**
+     * Disable reconnection temporarily
+     */
+    disable() {
+        this.state.disabled = true;
+    }
+    /**
+     * Enable reconnection
+     */
+    enable() {
+        this.state.disabled = false;
+    }
+    /**
+     * Check if reconnection is enabled
+     */
+    isEnabled() {
+        return this.config.autoReconnect && !this.state.disabled;
+    }
+    /**
+     * Event listener
+     */
+    on(event, callback) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(callback);
+        return () => {
+            this.listeners.get(event)?.delete(callback);
+        };
+    }
+    /**
+     * Emit event
+     */
+    emit(event, payload) {
+        const listeners = this.listeners.get(event);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(payload);
+                }
+                catch (e) {
+                    console.error(`Error in reconnect event listener for ${event}:`, e);
+                }
+            }
+        }
+    }
+    /**
+     * Wait helper
+     */
+    wait(ms) {
+        return new Promise((resolve) => {
+            this.reconnectTimer = setTimeout(resolve, ms);
+        });
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = {
+            ...this.config,
+            ...config,
+            reconnectOn: { ...this.config.reconnectOn, ...config.reconnectOn },
+            backoff: { ...this.config.backoff, ...config.backoff },
+        };
+    }
+    /**
+     * Reset state
+     */
+    reset() {
+        this.cancelReconnect();
+        this.clearQueue();
+        this.state = this.createInitialState();
+    }
+    /**
+     * Cleanup
+     */
+    destroy() {
+        this.stop();
+        this.clearQueue();
+        this.listeners.clear();
+    }
+}
+exports.ReconnectionManager = ReconnectionManager;
+/**
+ * Create a reconnection manager
+ */
+function createReconnectionManager(reconnectFn, config) {
+    return new ReconnectionManager(reconnectFn, config);
+}
+//# sourceMappingURL=reconnect.js.map

package/build/connection/reconnect.js.map

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

package/build/connection/retry.d.ts

@@ -0,0 +1,187 @@
+import { ErrorCode } from "../errors";
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts: number;
+    /** Base delay between retries in ms (default: 1000) */
+    baseDelay: number;
+    /** Maximum delay between retries in ms (default: 30000) */
+    maxDelay: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier: number;
+    /** Whether to add jitter to prevent thundering herd (default: true) */
+    jitter: boolean;
+    /** Error codes that should trigger a retry */
+    retryableErrors: ErrorCode[];
+    /** Custom retry condition function */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /** Callback for each retry attempt */
+    onRetry?: (attempt: number, delay: number, error: unknown) => void;
+    /** Callback when all retries exhausted */
+    onExhausted?: (error: unknown, attempts: number) => void;
+}
+/**
+ * Timeout configuration
+ */
+export interface TimeoutConfig {
+    /** Connection timeout in ms (default: 30000) */
+    connection: number;
+    /** Sign transaction timeout in ms (default: 120000) */
+    signTransaction: number;
+    /** Sign message timeout in ms (default: 60000) */
+    signMessage: number;
+    /** Broadcast timeout in ms (default: 60000) */
+    broadcast: number;
+    /** Show warning at this percentage of timeout (default: 0.8) */
+    warningThreshold: number;
+    /** Callback when warning threshold reached */
+    onWarning?: (operation: string, elapsed: number, timeout: number) => void;
+}
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold: number;
+    /** Time in ms before attempting to close circuit (default: 60000) */
+    cooldownPeriod: number;
+    /** Interval for health checks in ms (default: 10000) */
+    healthCheckInterval: number;
+    /** Callback when circuit opens */
+    onOpen?: (walletId: string, failures: number) => void;
+    /** Callback when circuit closes */
+    onClose?: (walletId: string) => void;
+    /** Callback when circuit is half-open (testing) */
+    onHalfOpen?: (walletId: string) => void;
+}
+/**
+ * Circuit breaker state
+ */
+export type CircuitState = "closed" | "open" | "half-open";
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Default timeout configuration
+ */
+export declare const DEFAULT_TIMEOUT_CONFIG: TimeoutConfig;
+/**
+ * Default circuit breaker configuration
+ */
+export declare const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig;
+/**
+ * Calculate delay for a given attempt with exponential backoff
+ */
+export declare function calculateBackoffDelay(attempt: number, config: Pick<RetryConfig, "baseDelay" | "maxDelay" | "backoffMultiplier" | "jitter">): number;
+/**
+ * Check if an error is retryable based on config
+ */
+export declare function isRetryableError(error: unknown, config: RetryConfig): boolean;
+/**
+ * Execute an operation with retry logic
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+/**
+ * Execute an operation with timeout
+ */
+export declare function withTimeout<T>(operation: () => Promise<T>, timeoutMs: number, operationName?: string, onWarning?: (elapsed: number, timeout: number) => void, warningThreshold?: number): Promise<T>;
+/**
+ * Combine retry and timeout
+ */
+export declare function withRetryAndTimeout<T>(operation: () => Promise<T>, timeoutMs: number, retryConfig?: Partial<RetryConfig>, operationName?: string): Promise<T>;
+/**
+ * Circuit Breaker
+ *
+ * Prevents hammering a failing wallet by temporarily disabling connections
+ */
+export declare class CircuitBreaker {
+    private circuits;
+    private config;
+    private healthCheckTimers;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Get or create circuit entry for a wallet
+     */
+    private getCircuit;
+    /**
+     * Check if a wallet's circuit allows requests
+     */
+    isAllowed(walletId: string): boolean;
+    /**
+     * Record a successful operation
+     */
+    recordSuccess(walletId: string): void;
+    /**
+     * Record a failed operation
+     */
+    recordFailure(walletId: string): void;
+    /**
+     * Transition circuit to a new state
+     */
+    private transitionTo;
+    /**
+     * Schedule health check for an open circuit
+     */
+    private scheduleHealthCheck;
+    /**
+     * Cancel health check timer
+     */
+    private cancelHealthCheck;
+    /**
+     * Manually reset a circuit
+     */
+    reset(walletId: string): void;
+    /**
+     * Manually reset all circuits
+     */
+    resetAll(): void;
+    /**
+     * Get circuit state for a wallet
+     */
+    getState(walletId: string): CircuitState;
+    /**
+     * Get circuit info for a wallet
+     */
+    getInfo(walletId: string): {
+        state: CircuitState;
+        failures: number;
+        lastFailure: number;
+        lastSuccess: number;
+        remainingCooldown: number | null;
+    };
+    /**
+     * Get all circuit states
+     */
+    getAllStates(): Record<string, CircuitState>;
+    /**
+     * Execute an operation through the circuit breaker
+     */
+    execute<T>(walletId: string, operation: () => Promise<T>): Promise<T>;
+    /**
+     * Cleanup all timers
+     */
+    destroy(): void;
+}
+/**
+ * Create a retry wrapper with default configuration
+ */
+export declare function createRetryWrapper(config?: Partial<RetryConfig>): <T>(operation: () => Promise<T>) => Promise<T>;
+/**
+ * Create a timeout wrapper with default configuration
+ */
+export declare function createTimeoutWrapper(timeoutMs: number, operationName?: string, onWarning?: (elapsed: number, timeout: number) => void): <T>(operation: () => Promise<T>) => Promise<T>;
+/**
+ * Cancellable operation wrapper
+ */
+export interface CancellableOperation<T> {
+    promise: Promise<T>;
+    cancel: () => void;
+    isCancelled: () => boolean;
+}
+/**
+ * Create a cancellable operation
+ */
+export declare function makeCancellable<T>(operation: () => Promise<T>): CancellableOperation<T>;