mindgraph-core 0.1.0

package/dist/utils/retry-fetch.js

@@ -0,0 +1,71 @@
+/**
+ * Structured error for non-retryable HTTP responses (4xx except 429).
+ * Exposes status and response body for programmatic handling.
+ */
+export class FetchError extends Error {
+    constructor(status, body) {
+        super(`Request failed: ${status} ${body}`);
+        this.name = 'FetchError';
+        this.status = status;
+        this.body = body;
+    }
+}
+/**
+ * Wraps fetch() with exponential backoff retry for 429/5xx and network errors.
+ * 4xx errors (except 429) fail immediately.
+ */
+export async function retryFetch(url, init, options) {
+    const maxRetries = options?.maxRetries ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 1000;
+    const timeoutMs = options?.timeoutMs ?? 30000;
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const timeoutSignal = AbortSignal.timeout(timeoutMs);
+            const signal = init.signal
+                ? AbortSignal.any([init.signal, timeoutSignal])
+                : timeoutSignal;
+            const response = await fetch(url, { ...init, signal });
+            // 4xx (not 429) — fail immediately
+            if (response.status >= 400 && response.status < 500 && response.status !== 429) {
+                const text = await response.text().catch(() => '');
+                throw new FetchError(response.status, text);
+            }
+            // 429 or 5xx — retry with backoff
+            if (response.status === 429 || response.status >= 500) {
+                if (attempt === maxRetries)
+                    return response;
+                let delay = baseDelayMs * Math.pow(2, attempt);
+                if (response.status === 429) {
+                    // Note: Retry-After can also be an HTTP date; we only parse integer seconds,
+                    // which covers the common case. Date values will be ignored (parseInt → NaN).
+                    const retryAfter = response.headers.get('Retry-After');
+                    if (retryAfter) {
+                        const seconds = parseInt(retryAfter, 10);
+                        if (!isNaN(seconds))
+                            delay = seconds * 1000;
+                    }
+                }
+                await sleep(delay);
+                continue;
+            }
+            return response;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            // Non-retryable errors (4xx FetchError thrown above)
+            if (lastError instanceof FetchError)
+                throw lastError;
+            // Network errors — retry with backoff
+            if (attempt < maxRetries) {
+                await sleep(baseDelayMs * Math.pow(2, attempt));
+                continue;
+            }
+        }
+    }
+    throw lastError ?? new Error('retryFetch failed');
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry-fetch.js.map

package/dist/utils/retry-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-fetch.js","sourceRoot":"","sources":["../../src/utils/retry-fetch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "mindgraph-core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "sql.js": "^1.11.0",
+    "uuid": "^9.0.0"
+  },
+  "optionalDependencies": {
+    "@huggingface/transformers": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/uuid": "^9.0.0",
+    "vitest": "^1.3.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}