@owox/internal-helpers 0.13.0-next-20251119115009 → 0.13.0-next-20251124115326

package/dist/index.d.ts

@@ -3,5 +3,9 @@ export * from './environment/parse-mysql-ssl.js';
 export * from './logging/logger-factory.js';
 export * from './logging/types.js';
 export * from './utils/promiseWithTimeout.js';
+export * from './utils/fetchWithBackoff.js';
+export * from './utils/castError.js';
+export * from './utils/isReadonlyQuery.js';
+export * from './utils/runWithConcurrency.js';
 export * from './integrations/event-bus/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC"}

package/dist/index.js

@@ -3,4 +3,8 @@ export * from './environment/parse-mysql-ssl.js';
 export * from './logging/logger-factory.js';
 export * from './logging/types.js';
 export * from './utils/promiseWithTimeout.js';
+export * from './utils/fetchWithBackoff.js';
+export * from './utils/castError.js';
+export * from './utils/isReadonlyQuery.js';
+export * from './utils/runWithConcurrency.js';
 export * from './integrations/event-bus/index.js';

package/dist/utils/castError.d.ts

@@ -0,0 +1,2 @@
+export declare function castError(error: unknown): Error;
+//# sourceMappingURL=castError.d.ts.map

package/dist/utils/castError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"castError.d.ts","sourceRoot":"","sources":["../../src/utils/castError.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQ/C"}

package/dist/utils/castError.js

@@ -0,0 +1,12 @@
+export function castError(error) {
+    if (error instanceof Error)
+        return error;
+    if (typeof error === 'string')
+        return new Error(error);
+    try {
+        return new Error(JSON.stringify(error));
+    }
+    catch {
+        return new Error(String(error));
+    }
+}

package/dist/utils/fetchWithBackoff.d.ts

@@ -0,0 +1,2 @@
+export declare function fetchWithBackoff(url: string, options: RequestInit, maxRetries?: number, initialDelay?: number): Promise<Response>;
+//# sourceMappingURL=fetchWithBackoff.d.ts.map

package/dist/utils/fetchWithBackoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithBackoff.d.ts","sourceRoot":"","sources":["../../src/utils/fetchWithBackoff.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,UAAU,SAAI,EACd,YAAY,SAAM,GACjB,OAAO,CAAC,QAAQ,CAAC,CAwCnB"}

package/dist/utils/fetchWithBackoff.js

@@ -0,0 +1,36 @@
+import { LoggerFactory } from '../logging/logger-factory.js';
+import { castError } from './castError.js';
+export async function fetchWithBackoff(url, options, maxRetries = 3, initialDelay = 300) {
+    const logger = LoggerFactory.createNamedLogger('fetchWithBackoff');
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const res = await fetch(url, options);
+            // Retry on 5xx or 429
+            if (res.status >= 500 || res.status === 429) {
+                const retryAfter = parseInt(res.headers.get('retry-after') ?? '0', 10);
+                const backoff = retryAfter > 0 ? retryAfter * 1000 : initialDelay * Math.pow(2, attempt - 1);
+                logger.debug(`[fetchWithBackoff] ${res.status} retrying in ${backoff}ms`);
+                await new Promise(r => setTimeout(r, backoff));
+                continue;
+            }
+            // Don't retry on 4xx other than 429
+            if (res.status >= 400)
+                return res;
+            return res;
+        }
+        catch (err) {
+            const msg = castError(err).message;
+            const isTransient = msg.includes('EPIPE') ||
+                msg.includes('ECONNRESET') ||
+                msg.includes('fetch failed') ||
+                msg.includes('timed out') ||
+                msg.includes('socket hang up');
+            if (!isTransient || attempt === maxRetries)
+                throw err;
+            const backoff = initialDelay * Math.pow(2, attempt - 1) + Math.random() * 100;
+            logger.debug(`[fetchWithBackoff] attempt ${attempt} failed (${msg}); retrying in ${Math.round(backoff)}ms`);
+            await new Promise(r => setTimeout(r, backoff));
+        }
+    }
+    throw new Error('fetchWithBackoff: exceeded max retries');
+}

package/dist/utils/isReadonlyQuery.d.ts

@@ -0,0 +1,2 @@
+export declare function isReadonlyQuery(sql: string): boolean;
+//# sourceMappingURL=isReadonlyQuery.d.ts.map

package/dist/utils/isReadonlyQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isReadonlyQuery.d.ts","sourceRoot":"","sources":["../../src/utils/isReadonlyQuery.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUpD"}

package/dist/utils/isReadonlyQuery.js

@@ -0,0 +1,10 @@
+export function isReadonlyQuery(sql) {
+    const cleaned = sql
+        .trim()
+        .replace(/^--.*$/gm, '') // remove line comments
+        .replace(/\/\*[\s\S]*?\*\//g, '') // remove block comments
+        .trim()
+        .replace(/^\(+/, '') // strip leading parentheses
+        .trim();
+    return /^(WITH|SELECT)\b/i.test(cleaned);
+}

package/dist/utils/runWithConcurrency.d.ts

@@ -0,0 +1,2 @@
+export declare function runWithConcurrency<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=runWithConcurrency.d.ts.map

package/dist/utils/runWithConcurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWithConcurrency.d.ts","sourceRoot":"","sources":["../../src/utils/runWithConcurrency.ts"],"names":[],"mappings":"AAAA,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAiBd"}

package/dist/utils/runWithConcurrency.js

@@ -0,0 +1,14 @@
+export async function runWithConcurrency(items, limit, fn) {
+    if (items.length === 0)
+        return [];
+    const size = Math.max(1, Math.min(limit, items.length));
+    const results = new Array(items.length);
+    for (let i = 0; i < items.length; i += size) {
+        const batch = items.slice(i, i + size);
+        const batchResults = await Promise.all(batch.map((item, j) => fn(item, i + j)));
+        batchResults.forEach((value, j) => {
+            results[i + j] = value;
+        });
+    }
+    return results;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owox/internal-helpers",
-  "version": "0.13.0-next-20251119115009",
+  "version": "0.13.0-next-20251124115326",
   "description": "Internal helpers used by core OWOX packages",
   "type": "module",
   "author": "OWOX",