@hasna/connectors 1.3.29 → 1.3.30

package/README.md

@@ -8,7 +8,7 @@ Open-source connector platform for enabling, authenticating, and running API con
 ## Install
 
 ```bash
-npm install -g @hasna/connectors
+bun install -g @hasna/connectors
 ```
 
 ## What It Is
@@ -56,6 +56,16 @@ connectors-mcp
 connectors-serve
 ```
 
+The local REST API is served by the one-product runtime at
+`http://localhost:9876`. Use `@hasna/connectors-sdk` with
+`ConnectorsClient` or `LocalConnectorsClient` for this local
+`connectors-serve` API.
+
+Hosted SaaS products should use `HostedConnectorsClient` from
+`@hasna/connectors-sdk`. The hosted client talks to a platform
+`/api/v1` endpoint with bearer API keys and does not require local connector
+installs or individual connector packages.
+
 ## Project Layout
 
 Project-local enablement is lightweight:

package/bin/index.js

@@ -1909,7 +1909,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/connectors",
-    version: "1.3.29",
+    version: "1.3.30",
     description: "Open source connector library - Install API connectors with a single command",
     type: "module",
     bin: {
@@ -7017,22 +7017,58 @@ async function requestJson(profile, path, params, options = {}) {
     if (value !== undefined && value !== null && value !== "")
       url.searchParams.append(key, String(value));
   }
-  const response = await fetch(url, {
-    method: options.method ?? "GET",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      Accept: "application/json",
-      ...options.body ? { "Content-Type": "application/json" } : {}
-    },
-    body: options.body ? JSON.stringify(options.body) : undefined
-  });
-  const text = await response.text();
-  const data = text ? JSON.parse(text) : {};
-  if (!response.ok) {
+  let lastError;
+  for (let attempt = 0;attempt <= MAX_GMAIL_RETRIES; attempt++) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: options.method ?? "GET",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          Accept: "application/json",
+          ...options.body ? { "Content-Type": "application/json" } : {}
+        },
+        body: options.body ? JSON.stringify(options.body) : undefined
+      });
+    } catch (error2) {
+      lastError = error2 instanceof Error ? error2.message : String(error2);
+      if (attempt >= MAX_GMAIL_RETRIES)
+        throw error2;
+      await sleep(gmailBackoffDelayMs(attempt));
+      continue;
+    }
+    const text = await response.text();
+    const data = text ? JSON.parse(text) : {};
+    if (response.ok)
+      return data;
     const error = data;
-    throw new Error(`Gmail request failed (${response.status}): ${error.error?.message ?? response.statusText}`);
+    lastError = error.error?.message ?? response.statusText;
+    if (!isRetryableGmailResponse(response.status, error) || attempt >= MAX_GMAIL_RETRIES) {
+      throw new Error(`Gmail request failed (${response.status}): ${lastError}`);
+    }
+    await sleep(gmailBackoffDelayMs(attempt, response.headers.get("retry-after")));
   }
-  return data;
+  throw new Error(`Gmail request failed: ${lastError ?? "unknown error"}`);
+}
+function isRetryableGmailResponse(status, error) {
+  if ([429, 500, 502, 503, 504].includes(status))
+    return true;
+  const reasons = error.error?.errors?.map((entry) => entry.reason) ?? [];
+  return reasons.some((reason) => reason === "rateLimitExceeded" || reason === "userRateLimitExceeded");
+}
+function gmailBackoffDelayMs(attempt, retryAfter = null) {
+  if (retryAfter) {
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0)
+      return seconds * 1000;
+  }
+  const base = Number(process.env.CONNECTORS_GMAIL_RETRY_BASE_MS ?? "1000");
+  const baseMs = Number.isFinite(base) && base >= 0 ? base : 1000;
+  const jitterMs = Math.floor(Math.random() * 1000);
+  return Math.min(2 ** attempt * baseMs + jitterMs, 64000);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function getValidAccessToken(profile) {
   if (process.env.GMAIL_ACCESS_TOKEN)
@@ -7210,7 +7246,7 @@ ${input.body}`;
 function safeFilename(filename) {
   return basename(filename.replace(/[\u00A0\u2000-\u200B\u202F\u205F\u3000]/g, " ")).replace(/[\/\\]/g, "_");
 }
-var GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1", TOKEN_URL = "https://oauth2.googleapis.com/token", REFRESH_BUFFER_MS, listMessagesSchema, messageIdSchema, readMessageSchema, attachmentListSchema, attachmentDownloadSchema, historyListSchema, replySchema, gmailConnector;
+var GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1", TOKEN_URL = "https://oauth2.googleapis.com/token", REFRESH_BUFFER_MS, MAX_GMAIL_RETRIES = 5, listMessagesSchema, messageIdSchema, readMessageSchema, attachmentListSchema, attachmentDownloadSchema, historyListSchema, replySchema, gmailConnector;
 var init_gmail = __esm(() => {
   init_zod();
   init_connector();

package/bin/mcp.js

@@ -11542,22 +11542,58 @@ async function requestJson(profile, path, params, options = {}) {
     if (value !== undefined && value !== null && value !== "")
       url.searchParams.append(key, String(value));
   }
-  const response = await fetch(url, {
-    method: options.method ?? "GET",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      Accept: "application/json",
-      ...options.body ? { "Content-Type": "application/json" } : {}
-    },
-    body: options.body ? JSON.stringify(options.body) : undefined
-  });
-  const text = await response.text();
-  const data = text ? JSON.parse(text) : {};
-  if (!response.ok) {
+  let lastError;
+  for (let attempt = 0;attempt <= MAX_GMAIL_RETRIES; attempt++) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: options.method ?? "GET",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          Accept: "application/json",
+          ...options.body ? { "Content-Type": "application/json" } : {}
+        },
+        body: options.body ? JSON.stringify(options.body) : undefined
+      });
+    } catch (error3) {
+      lastError = error3 instanceof Error ? error3.message : String(error3);
+      if (attempt >= MAX_GMAIL_RETRIES)
+        throw error3;
+      await sleep(gmailBackoffDelayMs(attempt));
+      continue;
+    }
+    const text = await response.text();
+    const data = text ? JSON.parse(text) : {};
+    if (response.ok)
+      return data;
     const error2 = data;
-    throw new Error(`Gmail request failed (${response.status}): ${error2.error?.message ?? response.statusText}`);
+    lastError = error2.error?.message ?? response.statusText;
+    if (!isRetryableGmailResponse(response.status, error2) || attempt >= MAX_GMAIL_RETRIES) {
+      throw new Error(`Gmail request failed (${response.status}): ${lastError}`);
+    }
+    await sleep(gmailBackoffDelayMs(attempt, response.headers.get("retry-after")));
+  }
+  throw new Error(`Gmail request failed: ${lastError ?? "unknown error"}`);
+}
+function isRetryableGmailResponse(status, error2) {
+  if ([429, 500, 502, 503, 504].includes(status))
+    return true;
+  const reasons = error2.error?.errors?.map((entry) => entry.reason) ?? [];
+  return reasons.some((reason) => reason === "rateLimitExceeded" || reason === "userRateLimitExceeded");
+}
+function gmailBackoffDelayMs(attempt, retryAfter = null) {
+  if (retryAfter) {
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0)
+      return seconds * 1000;
   }
-  return data;
+  const base = Number(process.env.CONNECTORS_GMAIL_RETRY_BASE_MS ?? "1000");
+  const baseMs = Number.isFinite(base) && base >= 0 ? base : 1000;
+  const jitterMs = Math.floor(Math.random() * 1000);
+  return Math.min(2 ** attempt * baseMs + jitterMs, 64000);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function getValidAccessToken(profile) {
   if (process.env.GMAIL_ACCESS_TOKEN)
@@ -11735,7 +11771,7 @@ ${input.body}`;
 function safeFilename(filename) {
   return basename(filename.replace(/[\u00A0\u2000-\u200B\u202F\u205F\u3000]/g, " ")).replace(/[\/\\]/g, "_");
 }
-var GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1", TOKEN_URL = "https://oauth2.googleapis.com/token", REFRESH_BUFFER_MS, listMessagesSchema, messageIdSchema, readMessageSchema, attachmentListSchema, attachmentDownloadSchema, historyListSchema, replySchema, gmailConnector;
+var GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1", TOKEN_URL = "https://oauth2.googleapis.com/token", REFRESH_BUFFER_MS, MAX_GMAIL_RETRIES = 5, listMessagesSchema, messageIdSchema, readMessageSchema, attachmentListSchema, attachmentDownloadSchema, historyListSchema, replySchema, gmailConnector;
 var init_gmail = __esm(() => {
   init_zod();
   init_connector();
@@ -12240,7 +12276,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/connectors",
-    version: "1.3.29",
+    version: "1.3.30",
     description: "Open source connector library - Install API connectors with a single command",
     type: "module",
     bin: {

package/bin/serve.js

@@ -15200,6 +15200,7 @@ import { basename, join as join9 } from "path";
 var GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1";
 var TOKEN_URL = "https://oauth2.googleapis.com/token";
 var REFRESH_BUFFER_MS = 5 * 60 * 1000;
+var MAX_GMAIL_RETRIES = 5;
 var listMessagesSchema = exports_external2.object({
   max: exports_external2.coerce.number().int().positive().max(500).optional(),
   maxResults: exports_external2.coerce.number().int().positive().max(500).optional(),
@@ -15430,22 +15431,58 @@ async function requestJson(profile, path, params, options = {}) {
     if (value !== undefined && value !== null && value !== "")
       url.searchParams.append(key, String(value));
   }
-  const response = await fetch(url, {
-    method: options.method ?? "GET",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      Accept: "application/json",
-      ...options.body ? { "Content-Type": "application/json" } : {}
-    },
-    body: options.body ? JSON.stringify(options.body) : undefined
-  });
-  const text = await response.text();
-  const data = text ? JSON.parse(text) : {};
-  if (!response.ok) {
+  let lastError;
+  for (let attempt = 0;attempt <= MAX_GMAIL_RETRIES; attempt++) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: options.method ?? "GET",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          Accept: "application/json",
+          ...options.body ? { "Content-Type": "application/json" } : {}
+        },
+        body: options.body ? JSON.stringify(options.body) : undefined
+      });
+    } catch (error2) {
+      lastError = error2 instanceof Error ? error2.message : String(error2);
+      if (attempt >= MAX_GMAIL_RETRIES)
+        throw error2;
+      await sleep(gmailBackoffDelayMs(attempt));
+      continue;
+    }
+    const text = await response.text();
+    const data = text ? JSON.parse(text) : {};
+    if (response.ok)
+      return data;
     const error = data;
-    throw new Error(`Gmail request failed (${response.status}): ${error.error?.message ?? response.statusText}`);
+    lastError = error.error?.message ?? response.statusText;
+    if (!isRetryableGmailResponse(response.status, error) || attempt >= MAX_GMAIL_RETRIES) {
+      throw new Error(`Gmail request failed (${response.status}): ${lastError}`);
+    }
+    await sleep(gmailBackoffDelayMs(attempt, response.headers.get("retry-after")));
   }
-  return data;
+  throw new Error(`Gmail request failed: ${lastError ?? "unknown error"}`);
+}
+function isRetryableGmailResponse(status, error) {
+  if ([429, 500, 502, 503, 504].includes(status))
+    return true;
+  const reasons = error.error?.errors?.map((entry) => entry.reason) ?? [];
+  return reasons.some((reason) => reason === "rateLimitExceeded" || reason === "userRateLimitExceeded");
+}
+function gmailBackoffDelayMs(attempt, retryAfter = null) {
+  if (retryAfter) {
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0)
+      return seconds * 1000;
+  }
+  const base = Number(process.env.CONNECTORS_GMAIL_RETRY_BASE_MS ?? "1000");
+  const baseMs = Number.isFinite(base) && base >= 0 ? base : 1000;
+  const jitterMs = Math.floor(Math.random() * 1000);
+  return Math.min(2 ** attempt * baseMs + jitterMs, 64000);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function getValidAccessToken(profile) {
   if (process.env.GMAIL_ACCESS_TOKEN)
@@ -15953,7 +15990,7 @@ function extractGoogleError(body) {
 // package.json
 var package_default = {
   name: "@hasna/connectors",
-  version: "1.3.29",
+  version: "1.3.30",
   description: "Open source connector library - Install API connectors with a single command",
   type: "module",
   bin: {

package/dist/index.js

@@ -4974,6 +4974,7 @@ import { basename, join as join2 } from "path";
 var GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1";
 var TOKEN_URL = "https://oauth2.googleapis.com/token";
 var REFRESH_BUFFER_MS = 5 * 60 * 1000;
+var MAX_GMAIL_RETRIES = 5;
 var listMessagesSchema = exports_external.object({
   max: exports_external.coerce.number().int().positive().max(500).optional(),
   maxResults: exports_external.coerce.number().int().positive().max(500).optional(),
@@ -5204,22 +5205,58 @@ async function requestJson(profile, path, params, options = {}) {
     if (value !== undefined && value !== null && value !== "")
       url.searchParams.append(key, String(value));
   }
-  const response = await fetch(url, {
-    method: options.method ?? "GET",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      Accept: "application/json",
-      ...options.body ? { "Content-Type": "application/json" } : {}
-    },
-    body: options.body ? JSON.stringify(options.body) : undefined
-  });
-  const text = await response.text();
-  const data = text ? JSON.parse(text) : {};
-  if (!response.ok) {
+  let lastError;
+  for (let attempt = 0;attempt <= MAX_GMAIL_RETRIES; attempt++) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: options.method ?? "GET",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          Accept: "application/json",
+          ...options.body ? { "Content-Type": "application/json" } : {}
+        },
+        body: options.body ? JSON.stringify(options.body) : undefined
+      });
+    } catch (error2) {
+      lastError = error2 instanceof Error ? error2.message : String(error2);
+      if (attempt >= MAX_GMAIL_RETRIES)
+        throw error2;
+      await sleep(gmailBackoffDelayMs(attempt));
+      continue;
+    }
+    const text = await response.text();
+    const data = text ? JSON.parse(text) : {};
+    if (response.ok)
+      return data;
     const error = data;
-    throw new Error(`Gmail request failed (${response.status}): ${error.error?.message ?? response.statusText}`);
+    lastError = error.error?.message ?? response.statusText;
+    if (!isRetryableGmailResponse(response.status, error) || attempt >= MAX_GMAIL_RETRIES) {
+      throw new Error(`Gmail request failed (${response.status}): ${lastError}`);
+    }
+    await sleep(gmailBackoffDelayMs(attempt, response.headers.get("retry-after")));
   }
-  return data;
+  throw new Error(`Gmail request failed: ${lastError ?? "unknown error"}`);
+}
+function isRetryableGmailResponse(status, error) {
+  if ([429, 500, 502, 503, 504].includes(status))
+    return true;
+  const reasons = error.error?.errors?.map((entry) => entry.reason) ?? [];
+  return reasons.some((reason) => reason === "rateLimitExceeded" || reason === "userRateLimitExceeded");
+}
+function gmailBackoffDelayMs(attempt, retryAfter = null) {
+  if (retryAfter) {
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0)
+      return seconds * 1000;
+  }
+  const base = Number(process.env.CONNECTORS_GMAIL_RETRY_BASE_MS ?? "1000");
+  const baseMs = Number.isFinite(base) && base >= 0 ? base : 1000;
+  const jitterMs = Math.floor(Math.random() * 1000);
+  return Math.min(2 ** attempt * baseMs + jitterMs, 64000);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function getValidAccessToken(profile) {
   if (process.env.GMAIL_ACCESS_TOKEN)
@@ -5727,7 +5764,7 @@ function extractGoogleError(body) {
 // package.json
 var package_default = {
   name: "@hasna/connectors",
-  version: "1.3.29",
+  version: "1.3.30",
   description: "Open source connector library - Install API connectors with a single command",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "1.3.29",
+  "version": "1.3.30",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {