relq 1.0.110 → 1.0.112

package/dist/cjs/core/relq-base.cjs

@@ -93,9 +93,32 @@ class RelqBase {
         }
         await this.ensureInitialized();
         const startTime = performance.now();
-        const result = await this._query(sql);
-        const duration = performance.now() - startTime;
-        return { result, duration };
+        const retryConfig = this.config.retry;
+        if (!retryConfig) {
+            const result = await this._query(sql);
+            return { result, duration: performance.now() - startTime };
+        }
+        const opts = typeof retryConfig === 'object'
+            ? { maxRetries: retryConfig.maxRetries ?? 3, initialDelayMs: retryConfig.initialDelayMs ?? 250, maxDelayMs: retryConfig.maxDelayMs ?? 5000 }
+            : { maxRetries: 3, initialDelayMs: 250, maxDelayMs: 5000 };
+        let lastError;
+        for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+            try {
+                const result = await this._query(sql);
+                return { result, duration: performance.now() - startTime };
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < opts.maxRetries && isTransientError(error)) {
+                    const delay = Math.min(opts.initialDelayMs * 2 ** attempt, opts.maxDelayMs);
+                    (0, helpers_1.debugLog)(this.config, `Transient error (attempt ${attempt + 1}/${opts.maxRetries}), retrying in ${delay}ms: ${error.code || error.message}`);
+                    await sleep(delay);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw lastError;
     }
     buildMetadata(result, duration) {
         return {
@@ -220,3 +243,29 @@ class RelqBase {
     }
 }
 exports.RelqBase = RelqBase;
+const TRANSIENT_NETWORK_CODES = new Set([
+    'ECONNRESET', 'ECONNREFUSED', 'ENOTFOUND', 'ESERVFAIL',
+    'ETIMEDOUT', 'EPIPE', 'EAI_AGAIN', 'EHOSTUNREACH',
+    'CONNECTION_LOST', 'PROTOCOL_CONNECTION_LOST',
+]);
+const TRANSIENT_PG_CODES = new Set([
+    '40P01',
+    '40001',
+    '08006',
+    '08001',
+    '08004',
+    '57P01',
+    '57P03',
+]);
+function isTransientError(error) {
+    if (TRANSIENT_NETWORK_CODES.has(error.code))
+        return true;
+    if (error.cause && TRANSIENT_NETWORK_CODES.has(error.cause.code))
+        return true;
+    if (TRANSIENT_PG_CODES.has(error.code))
+        return true;
+    return false;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/dist/esm/core/relq-base.js

@@ -90,9 +90,32 @@ export class RelqBase {
         }
         await this.ensureInitialized();
         const startTime = performance.now();
-        const result = await this._query(sql);
-        const duration = performance.now() - startTime;
-        return { result, duration };
+        const retryConfig = this.config.retry;
+        if (!retryConfig) {
+            const result = await this._query(sql);
+            return { result, duration: performance.now() - startTime };
+        }
+        const opts = typeof retryConfig === 'object'
+            ? { maxRetries: retryConfig.maxRetries ?? 3, initialDelayMs: retryConfig.initialDelayMs ?? 250, maxDelayMs: retryConfig.maxDelayMs ?? 5000 }
+            : { maxRetries: 3, initialDelayMs: 250, maxDelayMs: 5000 };
+        let lastError;
+        for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+            try {
+                const result = await this._query(sql);
+                return { result, duration: performance.now() - startTime };
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < opts.maxRetries && isTransientError(error)) {
+                    const delay = Math.min(opts.initialDelayMs * 2 ** attempt, opts.maxDelayMs);
+                    debugLog(this.config, `Transient error (attempt ${attempt + 1}/${opts.maxRetries}), retrying in ${delay}ms: ${error.code || error.message}`);
+                    await sleep(delay);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw lastError;
     }
     buildMetadata(result, duration) {
         return {
@@ -216,3 +239,29 @@ export class RelqBase {
         return this._isClosed;
     }
 }
+const TRANSIENT_NETWORK_CODES = new Set([
+    'ECONNRESET', 'ECONNREFUSED', 'ENOTFOUND', 'ESERVFAIL',
+    'ETIMEDOUT', 'EPIPE', 'EAI_AGAIN', 'EHOSTUNREACH',
+    'CONNECTION_LOST', 'PROTOCOL_CONNECTION_LOST',
+]);
+const TRANSIENT_PG_CODES = new Set([
+    '40P01',
+    '40001',
+    '08006',
+    '08001',
+    '08004',
+    '57P01',
+    '57P03',
+]);
+function isTransientError(error) {
+    if (TRANSIENT_NETWORK_CODES.has(error.code))
+        return true;
+    if (error.cause && TRANSIENT_NETWORK_CODES.has(error.cause.code))
+        return true;
+    if (TRANSIENT_PG_CODES.has(error.code))
+        return true;
+    return false;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/dist/index.d.ts

@@ -6760,6 +6760,22 @@ export interface RelqBaseConfig {
 	commitLimit?: number;
 	/** Schema relations for type-safe joins */
 	relations?: SchemaRelations | SchemaRelationsArray;
+	/**
+	 * Retry transient query failures (DNS, connection reset, timeout).
+	 * Disabled by default. Set `true` for 3 retries, or pass options.
+	 */
+	retry?: boolean | RetryOptions;
+}
+/**
+ * Configuration for automatic query retry on transient errors.
+ */
+export interface RetryOptions {
+	/** Maximum number of retry attempts @default 3 */
+	maxRetries?: number;
+	/** Initial delay in ms before first retry (doubles each attempt) @default 250 */
+	initialDelayMs?: number;
+	/** Maximum delay in ms between retries @default 5000 */
+	maxDelayMs?: number;
 }
 export interface PgConnectionFields {
 	/** Database host @default 'localhost' */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relq",
-  "version": "1.0.110",
+  "version": "1.0.112",
   "description": "The Fully-Typed PostgreSQL ORM for TypeScript",
   "author": "Olajide Mathew O. <olajide.mathew@yuniq.solutions>",
   "license": "MIT",