integrate-sdk 0.9.43-dev.0 → 0.9.44-dev.0

package/dist/server.js

@@ -736,104 +736,267 @@ function base64UrlDecode(str) {
 
 // src/oauth/email-fetcher.ts
 async function fetchUserEmail(provider, tokenData) {
+  const fetcher = EMAIL_FETCHERS[provider.toLowerCase()];
+  if (!fetcher) {
+    return tokenData.email;
+  }
   try {
-    switch (provider.toLowerCase()) {
-      case "github":
-        return await fetchGitHubEmail(tokenData.accessToken);
-      case "gmail":
-      case "google":
-        return await fetchGoogleEmail(tokenData.accessToken);
-      case "notion":
-        return await fetchNotionEmail(tokenData.accessToken);
-      default:
-        return tokenData.email;
-    }
+    const email = await fetcher(tokenData);
+    return email ?? tokenData.email;
   } catch (error) {
     logger3.error(`Failed to fetch email for ${provider}:`, error);
-    return;
+    return tokenData.email;
   }
 }
-async function fetchGitHubEmail(accessToken) {
-  try {
-    const userResponse = await fetch("https://api.github.com/user", {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: "application/vnd.github.v3+json"
-      }
-    });
-    if (!userResponse.ok) {
-      return;
-    }
-    const user = await userResponse.json();
-    if (user.email) {
-      return user.email;
-    }
-    const emailsResponse = await fetch("https://api.github.com/user/emails", {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        Accept: "application/vnd.github.v3+json"
-      }
-    });
-    if (!emailsResponse.ok) {
-      return;
-    }
-    const emails = await emailsResponse.json();
-    const primaryEmail = emails.find((e) => e.primary && e.verified);
-    if (primaryEmail) {
-      return primaryEmail.email;
+async function fetchGitHubEmail(token) {
+  const headers = {
+    Authorization: `Bearer ${token.accessToken}`,
+    Accept: "application/vnd.github.v3+json"
+  };
+  const userResponse = await fetch("https://api.github.com/user", { headers });
+  if (!userResponse.ok)
+    return;
+  const user = await userResponse.json();
+  if (user.email)
+    return user.email;
+  const emailsResponse = await fetch("https://api.github.com/user/emails", { headers });
+  if (!emailsResponse.ok)
+    return;
+  const emails = await emailsResponse.json();
+  const primary = emails.find((e) => e.primary && e.verified);
+  if (primary)
+    return primary.email;
+  const verified = emails.find((e) => e.verified);
+  if (verified)
+    return verified.email;
+  return emails[0]?.email;
+}
+async function fetchGoogleEmail(token) {
+  const response = await fetch("https://www.googleapis.com/oauth2/v2/userinfo", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const user = await response.json();
+  return user.email;
+}
+async function fetchNotionEmail(token) {
+  const response = await fetch("https://api.notion.com/v1/users/me", {
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`,
+      "Notion-Version": "2022-06-28"
     }
-    const verifiedEmail = emails.find((e) => e.verified);
-    if (verifiedEmail) {
-      return verifiedEmail.email;
+  });
+  if (!response.ok)
+    return;
+  const user = await response.json();
+  return user.person?.email ?? user.bot?.owner?.user?.person?.email;
+}
+async function fetchLinearEmail(token) {
+  const response = await fetch("https://api.linear.app/graphql", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ query: "{ viewer { email } }" })
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.data?.viewer?.email;
+}
+async function fetchHubSpotEmail(token) {
+  const url = `https://api.hubapi.com/oauth/v1/access-tokens/${encodeURIComponent(token.accessToken)}`;
+  const response = await fetch(url);
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.user;
+}
+async function fetchPolarEmail(token) {
+  const response = await fetch("https://api.polar.sh/v1/oauth2/userinfo", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.email;
+}
+async function fetchTodoistEmail(token) {
+  const response = await fetch("https://api.todoist.com/sync/v9/sync", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`,
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    body: 'sync_token=*&resource_types=["user"]'
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.user?.email;
+}
+async function fetchVercelEmail(token) {
+  const response = await fetch("https://api.vercel.com/v2/user", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.user?.email ?? body.email;
+}
+async function fetchSlackEmail(token) {
+  const response = await fetch("https://slack.com/api/users.identity", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  if (!body.ok)
+    return;
+  return body.user?.email;
+}
+async function fetchIntercomEmail(token) {
+  const response = await fetch("https://api.intercom.io/me", {
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`,
+      Accept: "application/json"
     }
-    if (emails.length > 0 && emails[0]?.email) {
-      return emails[0].email;
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.email;
+}
+async function fetchAtlassianEmail(token) {
+  const response = await fetch("https://api.atlassian.com/me", {
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`,
+      Accept: "application/json"
     }
+  });
+  if (!response.ok)
     return;
-  } catch (error) {
-    logger3.error("Failed to fetch GitHub email:", error);
+  const body = await response.json();
+  return body.email;
+}
+async function fetchZendeskEmail(token) {
+  const subdomain = token.providerConfig?.subdomain?.trim();
+  if (!subdomain)
     return;
-  }
+  const response = await fetch(`https://${subdomain}.zendesk.com/api/v2/users/me.json`, {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.user?.email;
 }
-async function fetchGoogleEmail(accessToken) {
-  try {
-    const response = await fetch("https://www.googleapis.com/oauth2/v2/userinfo", {
-      headers: {
-        Authorization: `Bearer ${accessToken}`
-      }
-    });
-    if (!response.ok) {
-      return;
-    }
-    const user = await response.json();
-    return user.email;
-  } catch (error) {
-    logger3.error("Failed to fetch Google email:", error);
+async function fetchAirtableEmail(token) {
+  const response = await fetch("https://api.airtable.com/v0/meta/whoami", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
     return;
-  }
+  const body = await response.json();
+  return body.email;
 }
-async function fetchNotionEmail(accessToken) {
-  try {
-    const response = await fetch("https://api.notion.com/v1/users/me", {
-      headers: {
-        Authorization: `Bearer ${accessToken}`,
-        "Notion-Version": "2022-06-28"
-      }
-    });
-    if (!response.ok) {
-      return;
+async function fetchDiscordEmail(token) {
+  const response = await fetch("https://discord.com/api/users/@me", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.email;
+}
+async function fetchDropboxEmail(token) {
+  const response = await fetch("https://api.dropboxapi.com/2/users/get_current_account", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`
+    },
+    body: "null"
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.email;
+}
+async function fetchGitLabEmail(token) {
+  const response = await fetch("https://gitlab.com/api/v4/user", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.email;
+}
+async function fetchRedditEmail(token) {
+  const response = await fetch("https://oauth.reddit.com/api/v1/me", {
+    headers: {
+      Authorization: `Bearer ${token.accessToken}`,
+      "User-Agent": "integrate-sdk"
     }
-    const user = await response.json();
-    return user.person?.email;
-  } catch (error) {
-    logger3.error("Failed to fetch Notion email:", error);
+  });
+  if (!response.ok)
     return;
-  }
+  const body = await response.json();
+  return body.name;
+}
+async function fetchMicrosoftEmail(token) {
+  const response = await fetch("https://graph.microsoft.com/v1.0/me", {
+    headers: { Authorization: `Bearer ${token.accessToken}` }
+  });
+  if (!response.ok)
+    return;
+  const body = await response.json();
+  return body.mail ?? body.userPrincipalName;
 }
-var logger3;
+var logger3, EMAIL_FETCHERS;
 var init_email_fetcher = __esm(() => {
   init_logger();
   logger3 = createLogger("EmailFetcher");
+  EMAIL_FETCHERS = {
+    github: fetchGitHubEmail,
+    gmail: fetchGoogleEmail,
+    google: fetchGoogleEmail,
+    gcal: fetchGoogleEmail,
+    gdrive: fetchGoogleEmail,
+    gdocs: fetchGoogleEmail,
+    gsheets: fetchGoogleEmail,
+    gslides: fetchGoogleEmail,
+    gcontacts: fetchGoogleEmail,
+    gmeet: fetchGoogleEmail,
+    gchat: fetchGoogleEmail,
+    gtasks: fetchGoogleEmail,
+    ga4: fetchGoogleEmail,
+    youtube: fetchGoogleEmail,
+    notion: fetchNotionEmail,
+    linear: fetchLinearEmail,
+    hubspot: fetchHubSpotEmail,
+    polar: fetchPolarEmail,
+    todoist: fetchTodoistEmail,
+    vercel: fetchVercelEmail,
+    slack: fetchSlackEmail,
+    intercom: fetchIntercomEmail,
+    jira: fetchAtlassianEmail,
+    zendesk: fetchZendeskEmail,
+    airtable: fetchAirtableEmail,
+    discord: fetchDiscordEmail,
+    dropbox: fetchDropboxEmail,
+    gitlab: fetchGitLabEmail,
+    reddit: fetchRedditEmail,
+    outlook: fetchMicrosoftEmail,
+    teams: fetchMicrosoftEmail,
+    onedrive: fetchMicrosoftEmail,
+    sharepoint: fetchMicrosoftEmail,
+    excel: fetchMicrosoftEmail,
+    word: fetchMicrosoftEmail,
+    powerpoint: fetchMicrosoftEmail,
+    planner: fetchMicrosoftEmail
+  };
 });
 
 // src/utils/concurrency.ts

package/dist/src/oauth/email-fetcher.d.ts

@@ -1,14 +1,25 @@
 /**
  * Email Fetcher
- * Fetches user email from OAuth provider APIs after token exchange
+ * Fetches user email from OAuth provider APIs after token exchange so the
+ * UI can label connected accounts.
+ *
+ * Implementations are registered in EMAIL_FETCHERS; unknown providers fall
+ * back to whatever email the OAuth response itself carried (e.g. Google's
+ * id_token JWT, which the MCP server extracts and surfaces on the callback
+ * response).
  */
 import type { ProviderTokenData } from "./types.js";
+export type EmailFetcher = (token: ProviderTokenData) => Promise<string | undefined>;
 /**
- * Fetch user email from OAuth provider
- *
- * @param provider - Provider name (e.g., 'github', 'gmail')
- * @param tokenData - Token data with access token
- * @returns User email address or undefined if not available
+ * Register a custom email fetcher for a provider. Useful when downstream
+ * apps add integrations that aren't yet in the SDK's built-in registry.
+ */
+export declare function registerEmailFetcher(provider: string, fetcher: EmailFetcher): void;
+/**
+ * Fetch user email from the OAuth provider after a successful token
+ * exchange. Returns undefined if no fetcher is registered or the provider
+ * call fails. Caller should fall back to whatever tokenData.email already
+ * holds.
  */
 export declare function fetchUserEmail(provider: string, tokenData: ProviderTokenData): Promise<string | undefined>;
 //# sourceMappingURL=email-fetcher.d.ts.map

package/dist/src/oauth/email-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-fetcher.d.ts","sourceRoot":"","sources":["../../../src/oauth/email-fetcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B"}
+{"version":3,"file":"email-fetcher.d.ts","sourceRoot":"","sources":["../../../src/oauth/email-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKpD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AA0CrF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAElF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.9.43-dev.0",
+  "version": "0.9.44-dev.0",
   "description": "Type-safe 3rd party integration SDK for the Integrate MCP server",
   "type": "module",
   "main": "./dist/index.js",