@olane/o-node 0.7.12-alpha.4 → 0.7.12-alpha.6

package/dist/src/utils/leader-request-wrapper.d.ts

@@ -0,0 +1,45 @@
+import { oObject, oAddress } from '@olane/o-core';
+export interface LeaderRetryConfig {
+    enabled: boolean;
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    timeoutMs: number;
+}
+/**
+ * Leader Request Wrapper
+ *
+ * Wraps requests to leader/registry with aggressive retry logic.
+ * Used when leader may be temporarily unavailable (healing, maintenance).
+ *
+ * Strategy:
+ * 1. Detect if request is to leader or registry
+ * 2. Apply retry logic with exponential backoff
+ * 3. Timeout individual attempts
+ * 4. Log retries for observability
+ */
+export declare class LeaderRequestWrapper extends oObject {
+    private config;
+    constructor(config: LeaderRetryConfig);
+    /**
+     * Check if address is a leader-related address that needs retry
+     */
+    private isLeaderAddress;
+    /**
+     * Execute request with retry logic
+     */
+    execute<T>(requestFn: () => Promise<T>, address: oAddress, context?: string): Promise<T>;
+    /**
+     * Calculate exponential backoff delay
+     */
+    private calculateBackoffDelay;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Get current configuration
+     */
+    getConfig(): LeaderRetryConfig;
+}
+//# sourceMappingURL=leader-request-wrapper.d.ts.map

package/dist/src/utils/leader-request-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-request-wrapper.d.ts","sourceRoot":"","sources":["../../../src/utils/leader-request-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAuB,MAAM,eAAe,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IACnC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAI7C;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC;IAoEb;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,SAAS,IAAI,iBAAiB;CAG/B"}

package/dist/src/utils/leader-request-wrapper.js

@@ -0,0 +1,89 @@
+import { oObject } from '@olane/o-core';
+/**
+ * Leader Request Wrapper
+ *
+ * Wraps requests to leader/registry with aggressive retry logic.
+ * Used when leader may be temporarily unavailable (healing, maintenance).
+ *
+ * Strategy:
+ * 1. Detect if request is to leader or registry
+ * 2. Apply retry logic with exponential backoff
+ * 3. Timeout individual attempts
+ * 4. Log retries for observability
+ */
+export class LeaderRequestWrapper extends oObject {
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Check if address is a leader-related address that needs retry
+     */
+    isLeaderAddress(address) {
+        const addressStr = address.toString();
+        return addressStr === 'o://leader' || addressStr === 'o://registry';
+    }
+    /**
+     * Execute request with retry logic
+     */
+    async execute(requestFn, address, context) {
+        // If retry disabled or not a leader address, execute directly
+        if (!this.config.enabled || !this.isLeaderAddress(address)) {
+            return await requestFn();
+        }
+        let attempt = 0;
+        let lastError;
+        while (attempt < this.config.maxAttempts) {
+            attempt++;
+            try {
+                this.logger.debug(`Leader request attempt ${attempt}/${this.config.maxAttempts}` +
+                    (context ? ` (${context})` : ''));
+                // Create timeout promise
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error(`Leader request timeout after ${this.config.timeoutMs}ms`)), this.config.timeoutMs);
+                });
+                // Race between request and timeout
+                const result = await Promise.race([requestFn(), timeoutPromise]);
+                // Success!
+                if (attempt > 1) {
+                    this.logger.info(`Leader request succeeded after ${attempt} attempts` +
+                        (context ? ` (${context})` : ''));
+                }
+                return result;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                this.logger.warn(`Leader request attempt ${attempt} failed: ${lastError.message}` +
+                    (context ? ` (${context})` : ''));
+                if (attempt < this.config.maxAttempts) {
+                    const delay = this.calculateBackoffDelay(attempt);
+                    this.logger.debug(`Waiting ${delay}ms before next attempt...`);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        // All attempts failed
+        this.logger.error(`Leader request failed after ${this.config.maxAttempts} attempts` +
+            (context ? ` (${context})` : ''));
+        throw lastError || new Error('Leader request failed');
+    }
+    /**
+     * Calculate exponential backoff delay
+     */
+    calculateBackoffDelay(attempt) {
+        const delay = this.config.baseDelayMs * Math.pow(2, attempt - 1);
+        return Math.min(delay, this.config.maxDelayMs);
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-node",
-  "version": "0.7.12-alpha.4",
+  "version": "0.7.12-alpha.6",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -54,12 +54,12 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-config": "0.7.12-alpha.4",
-    "@olane/o-core": "0.7.12-alpha.4",
-    "@olane/o-protocol": "0.7.12-alpha.4",
-    "@olane/o-tool": "0.7.12-alpha.4",
+    "@olane/o-config": "0.7.12-alpha.5",
+    "@olane/o-core": "0.7.12-alpha.6",
+    "@olane/o-protocol": "0.7.12-alpha.6",
+    "@olane/o-tool": "0.7.12-alpha.6",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0"
   },
-  "gitHead": "13c575d61a455fce146303f4060c6628851a7223"
+  "gitHead": "fad0400ec59d38b163bd996d967cd46c6a5a9e0a"
 }