@bernierllc/backoff-retry 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @bernierllc/backoff-retry
 
+## 0.3.0
+
+### Minor Changes
+
+- f22e382: refactor: use core retry-policy, retry-state, retry-metrics packages for all retry logic
+
+## 0.2.0
+
+### Minor Changes
+
+- 00c3e32: refactor: use core retry-policy, retry-state, retry-metrics packages for all retry logic
+- 043d97d: refactor: use core retry-policy, retry-state, retry-metrics packages for all retry logic
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -76,6 +76,13 @@ RETRY_STORAGE_TYPE=redis
 
 # Redis connection URL (if using Redis storage)
 REDIS_URL=redis://localhost:6379
+
+# Enhancement configuration
+NEVERADMIN_API_KEY=your_admin_api_key
+NEVERHUB_API_KEY=your_hub_api_key
+NOTIFICATION_EMAIL=admin@example.com,ops@example.com
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK
+PAGERDUTY_KEY=your_pagerduty_key
 ```
 
 ### Custom Configuration
@@ -98,6 +105,24 @@ const retryManager = createRetryManager({
     maxDelayMs: 10000,
     backoffFactor: 2,
     jitter: true
+  },
+  enhancements: {
+    storage: {
+      enabled: true,
+      type: 'memory',
+      autoUpgrade: true,
+      thresholdNotifications: true,
+      memoryThreshold: 80
+    },
+    notifications: {
+      enabled: true,
+      email: ['admin@example.com'],
+      thresholds: {
+        memoryUsage: 80,
+        retryFailures: 10,
+        performanceDegradation: 20
+      }
+    }
   }
 });
 ```
@@ -198,6 +223,91 @@ const redisClient = createClient({ url: 'redis://localhost:6379' });
 const storage = new RedisStorageAdapter(redisClient, 'retry:');
 ```
 
+## Enhancement System
+
+The package includes an opt-in enhancement system that provides advanced features with automatic upgrades and admin notifications:
+
+### Available Enhancements
+
+- **Storage Enhancements**: Auto-upgrade from memory to Redis/PostgreSQL/MongoDB
+- **Memory Protection**: Advanced analytics, leak detection, predictive forecasting
+- **NeverAdmin Integration**: Dashboard widgets, real-time metrics, configuration management
+- **NeverHub Integration**: Event streaming, webhook management, cross-service sync
+- **Machine Learning**: Predictive retry optimization, error classification
+- **Performance**: Multi-level caching, concurrency management, load balancing
+- **Security**: Encryption, rate limiting, audit logging, access control
+- **Notifications**: Email, Slack, PagerDuty, webhook notifications
+
+### Basic Enhancement Setup
+
+```typescript
+const retryManager = createRetryManager({
+  enhancements: {
+    storage: {
+      enabled: true,
+      type: 'memory',
+      autoUpgrade: true, // Automatically upgrade when Redis/DB available
+      thresholdNotifications: true,
+      memoryThreshold: 80 // Notify when 80% memory usage reached
+    },
+    notifications: {
+      enabled: true,
+      email: ['admin@example.com'],
+      thresholds: {
+        memoryUsage: 80,
+        retryFailures: 10,
+        performanceDegradation: 20
+      }
+    }
+  }
+});
+```
+
+### Environment-Based Auto-Configuration
+
+The enhancement system automatically detects and enables features based on environment variables:
+
+```bash
+# Auto-enable Redis storage
+REDIS_URL=redis://localhost:6379
+
+# Auto-enable NeverAdmin integration
+NEVERADMIN_API_KEY=your_key
+NEVERADMIN_DASHBOARD_URL=https://admin.example.com
+
+# Auto-enable NeverHub integration
+NEVERHUB_API_KEY=your_key
+NEVERHUB_URL=https://hub.example.com
+
+# Auto-enable notifications
+NOTIFICATION_EMAIL=admin@example.com,ops@example.com
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK
+PAGERDUTY_KEY=your_pagerduty_key
+```
+
+### Dynamic Enhancement Management
+
+```typescript
+// Check if enhancement is available
+if (retryManager.isEnhancementAvailable('neverAdmin')) {
+  console.log('NeverAdmin integration is enabled');
+}
+
+// Enable enhancement dynamically
+retryManager.enableEnhancement('ml', {
+  predictiveRetry: true,
+  errorClassification: true
+});
+
+// Get enhancement recommendations
+const recommendations = retryManager.getEnhancementRecommendations();
+console.log('Recommendations:', recommendations);
+
+// Get enhancement metrics
+const enhancementMetrics = retryManager.getEnhancementManager().getMetrics();
+console.log('Performance score:', enhancementMetrics.performanceScore);
+```
+
 ## Memory Protection
 
 The package includes built-in memory protection to prevent runaway memory usage:

package/dist/enhancement-manager.d.ts

@@ -0,0 +1,205 @@
+import { EventEmitter } from 'events';
+export interface EnhancementConfig {
+    storage?: {
+        enabled: boolean;
+        type: 'memory' | 'redis' | 'postgresql' | 'mongodb';
+        config?: any;
+        autoUpgrade: boolean;
+        thresholdNotifications: boolean;
+        memoryThreshold: number;
+    };
+    memoryProtection?: {
+        enabled: boolean;
+        advancedAnalytics: boolean;
+        predictiveForecasting: boolean;
+        leakDetection: boolean;
+        autoAdjustment: boolean;
+        systemResourceMonitoring: boolean;
+    };
+    neverAdmin?: {
+        enabled: boolean;
+        dashboardUrl?: string;
+        apiKey?: string;
+        autoMetrics: boolean;
+        realTimeUpdates: boolean;
+    };
+    neverHub?: {
+        enabled: boolean;
+        eventStreaming: boolean;
+        webhookManagement: boolean;
+        crossServiceSync: boolean;
+        hubUrl?: string;
+        apiKey?: string;
+    };
+    ml?: {
+        enabled: boolean;
+        predictiveRetry: boolean;
+        errorClassification: boolean;
+        performanceOptimization: boolean;
+        modelPath?: string;
+    };
+    performance?: {
+        enabled: boolean;
+        caching: boolean;
+        concurrencyManagement: boolean;
+        loadBalancing: boolean;
+        cacheLevels: 'l1' | 'l2' | 'l3' | 'all';
+    };
+    security?: {
+        enabled: boolean;
+        encryption: boolean;
+        rateLimiting: boolean;
+        auditLogging: boolean;
+        accessControl: boolean;
+    };
+    notifications?: {
+        enabled: boolean;
+        email?: string[];
+        webhook?: string;
+        slack?: string;
+        pagerDuty?: string;
+        thresholds: {
+            memoryUsage: number;
+            retryFailures: number;
+            performanceDegradation: number;
+        };
+    };
+}
+export interface EnhancementEvent {
+    type: 'threshold_reached' | 'auto_upgrade' | 'performance_alert' | 'security_alert';
+    severity: 'info' | 'warning' | 'error' | 'critical';
+    message: string;
+    data?: any;
+    timestamp: Date;
+}
+export interface EnhancementMetrics {
+    currentUsage: number;
+    maxUsage: number;
+    usagePercentage: number;
+    activeEnhancements: string[];
+    performanceScore: number;
+    recommendations: string[];
+}
+/**
+ * Enhancement Manager for opt-in features with automatic upgrades
+ */
+export declare class EnhancementManager extends EventEmitter {
+    private config;
+    private activeEnhancements;
+    private metrics;
+    private notificationQueue;
+    constructor(config?: Partial<EnhancementConfig>);
+    /**
+     * Check if an enhancement is available and enabled
+     */
+    isEnhancementAvailable(type: keyof EnhancementConfig): boolean;
+    /**
+     * Get enhancement configuration
+     */
+    getEnhancementConfig<T extends keyof EnhancementConfig>(type: T): EnhancementConfig[T];
+    /**
+     * Enable an enhancement
+     */
+    enableEnhancement(type: keyof EnhancementConfig, config?: any): void;
+    /**
+     * Disable an enhancement
+     */
+    disableEnhancement(type: keyof EnhancementConfig): void;
+    /**
+     * Check if storage should auto-upgrade
+     */
+    shouldAutoUpgradeStorage(currentUsage: number, maxUsage: number): boolean;
+    /**
+     * Get recommended storage upgrade
+     */
+    getRecommendedStorageUpgrade(): string | null;
+    /**
+     * Send notification to administrators
+     */
+    sendNotification(event: EnhancementEvent): Promise<void>;
+    /**
+     * Update metrics and check thresholds
+     */
+    updateMetrics(metrics: Partial<EnhancementMetrics>): void;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): EnhancementMetrics;
+    /**
+     * Get active enhancements
+     */
+    getActiveEnhancements(): string[];
+    /**
+     * Get enhancement recommendations
+     */
+    getRecommendations(): string[];
+    /**
+     * Initialize enhancements based on configuration
+     */
+    private initializeEnhancements;
+    /**
+     * Check thresholds and send notifications
+     */
+    private checkThresholds;
+    /**
+     * Check for auto-upgrade opportunities
+     */
+    private checkAutoUpgradeOpportunities;
+    /**
+     * Initialize storage enhancement
+     */
+    private initializeStorageEnhancement;
+    /**
+     * Initialize memory protection enhancement
+     */
+    private initializeMemoryProtectionEnhancement;
+    /**
+     * Initialize NeverAdmin enhancement
+     */
+    private initializeNeverAdminEnhancement;
+    /**
+     * Initialize NeverHub enhancement
+     */
+    private initializeNeverHubEnhancement;
+    /**
+     * Initialize ML enhancement
+     */
+    private initializeMLEnhancement;
+    /**
+     * Initialize performance enhancement
+     */
+    private initializePerformanceEnhancement;
+    /**
+     * Initialize security enhancement
+     */
+    private initializeSecurityEnhancement;
+    /**
+     * Merge configuration with defaults
+     */
+    private mergeWithDefaults;
+    /**
+     * Initialize metrics
+     */
+    private initializeMetrics;
+    /**
+     * Send email notification
+     */
+    private sendEmailNotification;
+    /**
+     * Send webhook notification
+     */
+    private sendWebhookNotification;
+    /**
+     * Send Slack notification
+     */
+    private sendSlackNotification;
+    /**
+     * Send PagerDuty notification
+     */
+    private sendPagerDutyNotification;
+}
+/**
+ * Factory function to create enhancement manager
+ */
+export declare function createEnhancementManager(config?: Partial<EnhancementConfig>): EnhancementManager;
+//# sourceMappingURL=enhancement-manager.d.ts.map

package/dist/enhancement-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancement-manager.d.ts","sourceRoot":"","sources":["../src/enhancement-manager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAEhC,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;QACpD,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,WAAW,EAAE,OAAO,CAAC;QACrB,sBAAsB,EAAE,OAAO,CAAC;QAChC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAGF,gBAAgB,CAAC,EAAE;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC;QACxB,wBAAwB,EAAE,OAAO,CAAC;KACnC,CAAC;IAGF,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IAGF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,EAAE,OAAO,CAAC;QACxB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,EAAE,CAAC,EAAE;QACH,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,OAAO,CAAC;QACzB,mBAAmB,EAAE,OAAO,CAAC;QAC7B,uBAAuB,EAAE,OAAO,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,qBAAqB,EAAE,OAAO,CAAC;QAC/B,aAAa,EAAE,OAAO,CAAC;QACvB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;KACzC,CAAC;IAGF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IAGF,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE;YACV,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,CAAC;YACtB,sBAAsB,EAAE,MAAM,CAAC;SAChC,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,mBAAmB,GAAG,cAAc,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;IACpF,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,iBAAiB,CAA0B;gBAEvC,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAOnD;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,iBAAiB,GAAG,OAAO;IAK9D;;OAEG;IACH,oBAAoB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAItF;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,iBAAiB,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI;IAepE;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,iBAAiB,GAAG,IAAI;IAQvD;;OAEG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUzE;;OAEG;IACH,4BAA4B,IAAI,MAAM,GAAG,IAAI;IAoB7C;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC9D;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAazD;;OAEG;IACH,UAAU,IAAI,kBAAkB;IAIhC;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAsB9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAmBrC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,OAAO,CAAC,qCAAqC;IAqB7C;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAavC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAarC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAaxC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAarC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmEzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;YACW,qBAAqB;IAKnC;;OAEG;YACW,uBAAuB;IAYrC;;OAEG;YACW,qBAAqB;IAenC;;OAEG;YACW,yBAAyB;CAsBxC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,kBAAkB,CAEhG"}