@trentapps/manager-protocol 1.1.3 → 1.2.0

package/dist/supervisor/ManagedServerRegistry.d.ts

@@ -2,6 +2,10 @@
  * Managed Server Registry
  *
  * Allows registering servers (ip + sourceDir) and checking online status.
+ * Features:
+ * - Connection pooling for TCP checks (reuse connections, timeout limits)
+ * - Caching for health check results (short TTL for success, no cache for failures)
+ * - Rate limiting with exponential backoff for repeated failures
  */
 export interface ManagedServer {
     id: string;
@@ -19,12 +23,83 @@ export interface ServerStatus {
     sourceDir: string;
     sourceDirExists: boolean;
     checkedAt: string;
+    /** Whether result came from cache */
+    cached?: boolean;
+    /** Cache age in milliseconds if cached */
+    cacheAgeMs?: number;
+}
+/**
+ * Configuration for connection pooling
+ */
+export interface ConnectionPoolConfig {
+    /** Maximum connections per host:port combination (default: 5) */
+    maxConnectionsPerEndpoint?: number;
+    /** Connection idle timeout in ms before cleanup (default: 30000) */
+    connectionIdleTimeoutMs?: number;
+    /** Maximum connection age in ms before forced cleanup (default: 60000) */
+    maxConnectionAgeMs?: number;
+    /** Interval to run cleanup of stale connections (default: 10000) */
+    cleanupIntervalMs?: number;
+}
+/**
+ * Configuration for health check caching
+ */
+export interface CacheConfig {
+    /** TTL for successful checks in ms (default: 5000) */
+    successTtlMs?: number;
+    /** Whether to cache failures - generally should be false (default: false) */
+    cacheFailures?: boolean;
+    /** TTL for failed checks if cacheFailures is true (default: 1000) */
+    failureTtlMs?: number;
+    /** Maximum cache entries before LRU eviction (default: 1000) */
+    maxEntries?: number;
+}
+/**
+ * Configuration for rate limiting
+ */
+export interface RateLimitConfig {
+    /** Initial delay after first failure in ms (default: 1000) */
+    initialDelayMs?: number;
+    /** Maximum delay between retries in ms (default: 60000) */
+    maxDelayMs?: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+    /** Number of consecutive failures before rate limiting kicks in (default: 3) */
+    failureThreshold?: number;
+    /** Time window to track failures in ms (default: 60000) */
+    failureWindowMs?: number;
+}
+/**
+ * Configuration for ManagedServerRegistry
+ */
+export interface ManagedServerRegistryConfig {
+    /** Path to persist server list (default: ./managed-servers.json) */
+    filePath?: string;
+    /** Connection pool configuration */
+    connectionPool?: ConnectionPoolConfig;
+    /** Health check cache configuration */
+    cache?: CacheConfig;
+    /** Rate limiting configuration */
+    rateLimit?: RateLimitConfig;
+    /** Whether to use connection pooling (default: true) */
+    enablePooling?: boolean;
+    /** Whether to use caching (default: true) */
+    enableCaching?: boolean;
+    /** Whether to use rate limiting (default: true) */
+    enableRateLimiting?: boolean;
 }
 export declare class ManagedServerRegistry {
     private filePath;
     private servers;
     private loaded;
-    constructor(filePath?: string);
+    private connectionPool;
+    private healthCache;
+    private rateLimiter;
+    private enablePooling;
+    private enableCaching;
+    private enableRateLimiting;
+    private stats;
+    constructor(config?: ManagedServerRegistryConfig);
     private ensureLoaded;
     private persist;
     addServer(params: {
@@ -41,8 +116,70 @@ export declare class ManagedServerRegistry {
         ip?: string;
         sourceDir?: string;
         ports?: number[];
+        skipCache?: boolean;
     }): Promise<ServerStatus>;
-    private tcpCheck;
+    /**
+     * TCP check with connection pooling, caching, and rate limiting
+     */
+    private tcpCheckWithFeatures;
+    /**
+     * TCP check using connection pool
+     */
+    private tcpCheckPooled;
+    /**
+     * Direct TCP check without pooling (original implementation)
+     */
+    private tcpCheckDirect;
+    /**
+     * Get comprehensive statistics about TCP checks
+     */
+    getCheckStats(): {
+        totalChecks: number;
+        cacheHits: number;
+        cacheMisses: number;
+        cacheHitRate: number;
+        pooledConnections: number;
+        newConnections: number;
+        poolReuseRate: number;
+        rateLimitedChecks: number;
+        pool: {
+            totalConnections: number;
+            activeConnections: number;
+            endpoints: number;
+        };
+        cache: {
+            entries: number;
+            hitRate?: number;
+        };
+        rateLimit: {
+            trackedEndpoints: number;
+            rateLimitedEndpoints: number;
+        };
+    };
+    /**
+     * Invalidate cache for a specific endpoint
+     */
+    invalidateCache(host: string, port: number): boolean;
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    /**
+     * Clear rate limiting for an endpoint
+     */
+    clearRateLimit(host: string, port: number): boolean;
+    /**
+     * Clear all rate limiting
+     */
+    clearAllRateLimits(): void;
+    /**
+     * Reset all statistics
+     */
+    resetStats(): void;
+    /**
+     * Clean up resources (connection pool, timers)
+     */
+    destroy(): void;
 }
 export declare const managedServerRegistry: ManagedServerRegistry;
 //# sourceMappingURL=ManagedServerRegistry.d.ts.map

package/dist/supervisor/ManagedServerRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManagedServerRegistry.d.ts","sourceRoot":"","sources":["../../src/supervisor/ManagedServerRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,CAAC,EAAE,MAAM;YAIf,YAAY;YAiBZ,OAAO;IAKf,SAAS,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAe1G,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO1C,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKvC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAKzD,WAAW,CAAC,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAqDnH,OAAO,CAAC,QAAQ;CA0BjB;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}
+{"version":3,"file":"ManagedServerRegistry.d.ts","sourceRoot":"","sources":["../../src/supervisor/ManagedServerRegistry.ts"],"names":[],"mappings":"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"}