@hasna/connectors 1.3.28 → 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.28",
+    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();
@@ -34282,6 +34318,27 @@ function getOAuthTokenState(name) {
   })();
   return { hasTokens: true, expired: isExpired, expiresIn };
 }
+function getCurrentOAuthProfile(name, connectorsHome = getConnectorsHome()) {
+  for (const dir of getConnectorConfigReadDirs(name, connectorsHome)) {
+    const currentProfilePath = join20(dir, "current_profile");
+    if (!existsSync20(currentProfilePath))
+      continue;
+    const profile = readFileSync11(currentProfilePath, "utf8").trim();
+    if (profile)
+      return profile;
+  }
+  return "default";
+}
+function getOAuthTokenPathsForProfile(name, connectorsHome = getConnectorsHome(), profile = getCurrentOAuthProfile(name, connectorsHome)) {
+  return getConnectorConfigReadDirs(name, connectorsHome).map((dir) => join20(dir, "profiles", profile, "tokens.json"));
+}
+function hasOAuthTokenFileUpdatedSince(tokenPaths, sinceMs) {
+  return tokenPaths.some((tokensPath) => {
+    if (!existsSync20(tokensPath))
+      return false;
+    return statSync8(tokensPath).mtimeMs >= sinceMs;
+  });
+}
 function registerCommands4(program2) {
   program2.command("auth").argument("<connector>", "Connector name to configure auth for").option("-k, --key <value>", "API key or bearer token value (non-interactive)").option("-f, --field <field>", "Which field to set (for multi-field connectors)").option("--json", "Output as JSON", false).option("--no-browser", "Print OAuth URL without opening a browser (agent-friendly)", false).option("--refresh", "Refresh expired OAuth tokens", false).option("--port <port>", "OAuth server port (default: 9876)", "9876").description("Configure authentication for a connector").action(async (connector, options) => {
     const meta = getConnector(connector);
@@ -34407,10 +34464,11 @@ ${meta.displayName} \u2014 Auth Configuration
           console.log(chalk5.dim(`Starting OAuth server on port ${port}...`));
           const { spawn: spawn3 } = await import("child_process");
           const scriptPath = process.argv[1];
-          const serverProc = spawn3("node", [scriptPath, "serve", "--port", String(port)], {
+          const serverProc = spawn3(process.execPath, [scriptPath, "serve", "--port", String(port)], {
             detached: true,
             stdio: "ignore"
           });
+          const startedAt = Date.now();
           serverProc.unref();
           await new Promise((resolve) => setTimeout(resolve, 2000));
           try {
@@ -34427,12 +34485,13 @@ ${meta.displayName} \u2014 Auth Configuration
 `);
           console.log(chalk5.dim("Waiting for authentication to complete..."));
           const connectorsHome = getConnectorsHome();
-          const tokenPaths = getConnectorConfigReadDirs(connector, connectorsHome).map((dir) => join20(dir, "profiles", "default", "tokens.json"));
+          const activeProfile = getCurrentOAuthProfile(connector, connectorsHome);
+          const tokenPaths = getOAuthTokenPathsForProfile(connector, connectorsHome, activeProfile);
           let attempts = 0;
           const maxAttempts = 360;
           while (attempts < maxAttempts) {
             await new Promise((resolve) => setTimeout(resolve, 500));
-            if (tokenPaths.some((tokensPath) => existsSync20(tokensPath))) {
+            if (hasOAuthTokenFileUpdatedSince(tokenPaths, startedAt)) {
               break;
             }
             attempts++;
@@ -35586,7 +35645,6 @@ Testing connector credentials...
 init_registry2();
 init_auth();
 init_runner();
-init_connector_resolver();
 import chalk7 from "chalk";
 function registerCommands6(program2) {
   program2.command("ops").description("List available API operations for a connector").argument("<name>", "Connector name (e.g. stripe, gmail)").argument("[command]", "Get detailed help for a specific subcommand").option("--json", "Output as JSON").action(async (name, command, options) => {
@@ -35750,13 +35808,12 @@ Setting up ${meta.displayName}...
 `);
             const { spawn: spawn3 } = await import("child_process");
             const { getConnectorsHome: getConnectorsHome2 } = await Promise.resolve().then(() => (init_database(), exports_database));
-            const { existsSync: existsSync8 } = await import("fs");
-            const { join: join8 } = await import("path");
             const scriptPath = process.argv[1];
-            const serverProc = spawn3("node", [scriptPath, "serve", "--port", String(port)], {
+            const serverProc = spawn3(process.execPath, [scriptPath, "serve", "--port", String(port)], {
               detached: true,
               stdio: "ignore"
             });
+            const startedAt = Date.now();
             serverProc.unref();
             await new Promise((resolve) => setTimeout(resolve, 2000));
             try {
@@ -35768,12 +35825,13 @@ Setting up ${meta.displayName}...
             }
             console.log(chalk7.dim("  Waiting for authentication to complete..."));
             const connectorsHome = getConnectorsHome2();
-            const tokenPaths = getConnectorConfigReadDirs(name, connectorsHome).map((dir) => join8(dir, "profiles", "default", "tokens.json"));
+            const activeProfile = getCurrentOAuthProfile(name, connectorsHome);
+            const tokenPaths = getOAuthTokenPathsForProfile(name, connectorsHome, activeProfile);
             let attempts = 0;
             const maxAttempts = 360;
             while (attempts < maxAttempts) {
               await new Promise((resolve) => setTimeout(resolve, 500));
-              if (tokenPaths.some((tokensPath) => existsSync8(tokensPath)))
+              if (hasOAuthTokenFileUpdatedSince(tokenPaths, startedAt))
                 break;
               attempts++;
               if (attempts % 6 === 0)

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.28",
+    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.28",
+  version: "1.3.30",
   description: "Open source connector library - Install API connectors with a single command",
   type: "module",
   bin: {

package/dist/cli/auth-no-browser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/commands/auth.d.ts

@@ -1,2 +1,5 @@
 import { Command } from "commander";
+export declare function getCurrentOAuthProfile(name: string, connectorsHome?: string): string;
+export declare function getOAuthTokenPathsForProfile(name: string, connectorsHome?: string, profile?: string): string[];
+export declare function hasOAuthTokenFileUpdatedSince(tokenPaths: string[], sinceMs: number): boolean;
 export declare function registerCommands(program: Command): void;

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.28",
+  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.28",
+  "version": "1.3.30",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {