@owox/internal-helpers 0.15.0-next-20251203174158 → 0.15.0-next-20251204114133

package/dist/index.d.ts

@@ -7,5 +7,7 @@ export * from './utils/fetchWithBackoff.js';
 export * from './utils/castError.js';
 export * from './utils/isReadonlyQuery.js';
 export * from './utils/runWithConcurrency.js';
+export * from './utils/zodSchemaParser.js';
+export * from './utils/extractJsonFromText.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,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,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,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC"}

package/dist/index.js

@@ -7,4 +7,6 @@ export * from './utils/fetchWithBackoff.js';
 export * from './utils/castError.js';
 export * from './utils/isReadonlyQuery.js';
 export * from './utils/runWithConcurrency.js';
+export * from './utils/zodSchemaParser.js';
+export * from './utils/extractJsonFromText.js';
 export * from './integrations/event-bus/index.js';

package/dist/utils/extractJsonFromText.d.ts

@@ -0,0 +1,2 @@
+export declare function extractJsonFromText(raw: string | undefined): string | null;
+//# sourceMappingURL=extractJsonFromText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractJsonFromText.d.ts","sourceRoot":"","sources":["../../src/utils/extractJsonFromText.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAkC1E"}

package/dist/utils/extractJsonFromText.js

@@ -0,0 +1,32 @@
+export function extractJsonFromText(raw) {
+    if (!raw) {
+        return null;
+    }
+    // Strip markdown fences ```json ... ``` / ``` ... ```
+    const text = raw
+        .replace(/```json/gi, '')
+        .replace(/```/g, '')
+        .trim();
+    // First try: whole text as JSON
+    try {
+        JSON.parse(text);
+        return text;
+    }
+    catch {
+        // ignore
+    }
+    // Second try: take first {...} block by braces
+    const firstBrace = text.indexOf('{');
+    const lastBrace = text.lastIndexOf('}');
+    if (firstBrace === -1 || lastBrace === -1 || lastBrace <= firstBrace) {
+        return null;
+    }
+    const candidate = text.slice(firstBrace, lastBrace + 1);
+    try {
+        JSON.parse(candidate);
+        return candidate;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/utils/fetchWithBackoff.d.ts

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

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

@@ -1 +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"}
+{"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,EAClB,SAAS,SAAS,GACjB,OAAO,CAAC,QAAQ,CAAC,CAyCnB;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,SAAS,SAAS,GACjB,OAAO,CAAC,QAAQ,CAAC,CAcnB"}

package/dist/utils/fetchWithBackoff.js

@@ -1,10 +1,10 @@
 import { LoggerFactory } from '../logging/logger-factory.js';
 import { castError } from './castError.js';
-export async function fetchWithBackoff(url, options, maxRetries = 3, initialDelay = 300) {
+export async function fetchWithBackoff(url, options, maxRetries = 3, initialDelay = 300, timeoutMs = 25_000) {
     const logger = LoggerFactory.createNamedLogger('fetchWithBackoff');
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
         try {
-            const res = await fetch(url, options);
+            const res = await fetchWithTimeout(url, options, timeoutMs);
             // Retry on 5xx or 429
             if (res.status >= 500 || res.status === 429) {
                 const retryAfter = parseInt(res.headers.get('retry-after') ?? '0', 10);
@@ -24,6 +24,7 @@ export async function fetchWithBackoff(url, options, maxRetries = 3, initialDela
                 msg.includes('ECONNRESET') ||
                 msg.includes('fetch failed') ||
                 msg.includes('timed out') ||
+                msg.includes('Fetch timeout') ||
                 msg.includes('socket hang up');
             if (!isTransient || attempt === maxRetries)
                 throw err;
@@ -34,3 +35,19 @@ export async function fetchWithBackoff(url, options, maxRetries = 3, initialDela
     }
     throw new Error('fetchWithBackoff: exceeded max retries');
 }
+export async function fetchWithTimeout(url, options = {}, timeoutMs = 25_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { ...options, signal: controller.signal });
+    }
+    catch (err) {
+        if (castError(err).name === 'AbortError') {
+            throw new Error(`Fetch timeout: request did not complete within ${timeoutMs}ms`);
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/utils/zodSchemaParser.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare function parseJsonWithSchema<TSchema extends z.ZodTypeAny>(schema: TSchema, raw: string | undefined, contextName: string): z.infer<TSchema>;
+//# sourceMappingURL=zodSchemaParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zodSchemaParser.d.ts","sourceRoot":"","sources":["../../src/utils/zodSchemaParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wBAAgB,mBAAmB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EAC9D,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,WAAW,EAAE,MAAM,GAClB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAkBlB"}

package/dist/utils/zodSchemaParser.js

@@ -0,0 +1,16 @@
+import { castError } from './castError.js';
+export function parseJsonWithSchema(schema, raw, contextName) {
+    let json;
+    try {
+        json = JSON.parse(raw ?? '');
+    }
+    catch (error) {
+        throw new Error(`${contextName}: Invalid JSON, message: ${castError(error).message}  content: ${raw}`);
+    }
+    try {
+        return schema.parse(json);
+    }
+    catch (error) {
+        throw new Error(`${contextName}: Failed to parse JSON with schema: ${castError(error).message}, content: ${raw}`);
+    }
+}

package/package.json

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