@eventcatalog/connectors 0.0.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2022-2026 boyney123
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: Source code within `packages/core/eventcatalog/src/enterprise/` is
+licensed under the EventCatalog Commercial License and is NOT covered by the
+MIT License above. See `packages/core/eventcatalog/src/enterprise/LICENSE`
+for the full terms.

package/README.md

@@ -2,16 +2,18 @@
 
 Connectors for syncing external systems into EventCatalog.
 
+## GitHub
+
 ```js
 // eventcatalog.config.js
-import { githubDirectory } from '@eventcatalog/connectors';
+import { githubDirectory } from "@eventcatalog/connectors";
 
 export default {
   directory: {
     sources: [
       githubDirectory({
-        org: 'acme',
-        teams: true,
+        org: "acme",
+        teams: ["platform", "architecture"],
         users: true,
         token: process.env.GITHUB_TOKEN,
       }),
@@ -20,25 +22,82 @@ export default {
 };
 ```
 
+## Microsoft Entra ID
+
+Sync selected Microsoft Entra ID groups into EventCatalog teams, and sync their
+direct user members into EventCatalog users.
+
+```js
+// eventcatalog.config.js
+import { microsoftEntraDirectory } from "@eventcatalog/connectors";
+
+export default {
+  directory: {
+    sources: [
+      microsoftEntraDirectory({
+        tenantId: process.env.AZURE_TENANT_ID,
+        clientId: process.env.AZURE_CLIENT_ID,
+        clientSecret: process.env.AZURE_CLIENT_SECRET,
+        groups: [
+          {
+            id: "00000000-0000-0000-0000-000000000000",
+            alias: "platform",
+          },
+          {
+            displayName: "Architecture Guild",
+          },
+        ],
+      }),
+    ],
+  },
+};
+```
+
+The connector uses Microsoft Graph with the OAuth client credentials flow.
+Create an app registration in Microsoft Entra ID, add read-only Microsoft Graph
+application permissions for reading groups, users, and group members, grant
+admin consent, then create a client secret for the build environment.
+
+Groups can be configured by stable `id` or exact `displayName`. Group IDs are
+recommended. If a `displayName` lookup finds no groups or multiple groups, the
+connector fails and asks you to use the group ID.
+
+Selected groups become EventCatalog teams. Team IDs use `alias` when provided,
+otherwise they are slugified from the Entra group display name. Only direct user
+members are synced. Disabled users are excluded by default; set
+`includeDisabledUsers: true` to include them.
+
+```js
+microsoftEntraDirectory({
+  tenantId: process.env.AZURE_TENANT_ID,
+  clientId: process.env.AZURE_CLIENT_ID,
+  clientSecret: process.env.AZURE_CLIENT_SECRET,
+  groups: [{ id: "00000000-0000-0000-0000-000000000000" }],
+  includeDisabledUsers: true,
+  graphBaseUrl: "https://graph.microsoft.com/v1.0",
+  tokenUrl: "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token",
+});
+```
+
 External directory sources require EventCatalog Scale when loaded by EventCatalog.
 
 Custom directory sources can use the same contract:
 
 ```js
-import { defineDirectorySource } from '@eventcatalog/connectors';
+import { defineDirectorySource } from "@eventcatalog/connectors";
 
 export const companyDirectory = defineDirectorySource({
-  type: 'directory',
-  name: 'company-directory',
+  type: "directory",
+  name: "company-directory",
 
   async loadTeams() {
     return [
       {
-        id: 'platform',
-        name: 'Platform',
-        members: ['alice'],
+        id: "platform",
+        name: "Platform",
+        members: ["alice"],
         source: {
-          provider: 'company-directory',
+          provider: "company-directory",
         },
       },
     ];
@@ -47,11 +106,11 @@ export const companyDirectory = defineDirectorySource({
   async loadUsers() {
     return [
       {
-        id: 'alice',
-        name: 'Alice',
-        avatarUrl: 'https://example.com/alice.png',
+        id: "alice",
+        name: "Alice",
+        avatarUrl: "https://example.com/alice.png",
         source: {
-          provider: 'company-directory',
+          provider: "company-directory",
         },
       },
     ];

package/dist/index.d.mts

@@ -22,7 +22,7 @@ type DirectoryEntrySource = {
 type DirectoryUser = {
     id: string;
     name: string;
-    avatarUrl: string;
+    avatarUrl?: string;
     role?: string;
     email?: string;
     markdown?: string;
@@ -53,11 +53,9 @@ type DirectoryTeam = {
  * `.eventcatalog/store/directory.json` file for SDK/editor reads.
  */
 type DirectorySource = {
-    type: 'directory';
+    type: "directory";
     /** Stable source identifier, usually `<provider>:<account-or-org>`. */
     name: string;
-    /** Optional stable cache key for this source configuration. */
-    cacheKey?: string;
     /** Load users from the external directory. */
     loadUsers?: () => Promise<DirectoryUser[]>;
     /** Load teams from the external directory. */
@@ -71,10 +69,29 @@ declare const defineDirectorySource: <TSource extends DirectorySource>(source: T
 type GitHubDirectoryOptions = {
     org: string;
     token?: string;
-    teams?: true | string[];
+    teams: string[];
     users?: boolean;
     baseUrl?: string;
 };
 declare const githubDirectory: (options: GitHubDirectoryOptions) => DirectorySource;
 
-export { type DirectoryEntrySource, type DirectorySource, type DirectoryTeam, type DirectoryUser, defineDirectorySource, githubDirectory };
+type MicrosoftEntraGroupInput = string | {
+    id: string;
+    alias?: string;
+} | {
+    displayName: string;
+    alias?: string;
+};
+type MicrosoftEntraDirectoryOptions = {
+    tenantId: string;
+    clientId: string;
+    clientSecret: string;
+    groups: MicrosoftEntraGroupInput[];
+    users?: boolean;
+    includeDisabledUsers?: boolean;
+    graphBaseUrl?: string;
+    tokenUrl?: string;
+};
+declare const microsoftEntraDirectory: (options: MicrosoftEntraDirectoryOptions) => DirectorySource;
+
+export { type DirectoryEntrySource, type DirectorySource, type DirectoryTeam, type DirectoryUser, defineDirectorySource, githubDirectory, microsoftEntraDirectory };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ type DirectoryEntrySource = {
 type DirectoryUser = {
     id: string;
     name: string;
-    avatarUrl: string;
+    avatarUrl?: string;
     role?: string;
     email?: string;
     markdown?: string;
@@ -53,11 +53,9 @@ type DirectoryTeam = {
  * `.eventcatalog/store/directory.json` file for SDK/editor reads.
  */
 type DirectorySource = {
-    type: 'directory';
+    type: "directory";
     /** Stable source identifier, usually `<provider>:<account-or-org>`. */
     name: string;
-    /** Optional stable cache key for this source configuration. */
-    cacheKey?: string;
     /** Load users from the external directory. */
     loadUsers?: () => Promise<DirectoryUser[]>;
     /** Load teams from the external directory. */
@@ -71,10 +69,29 @@ declare const defineDirectorySource: <TSource extends DirectorySource>(source: T
 type GitHubDirectoryOptions = {
     org: string;
     token?: string;
-    teams?: true | string[];
+    teams: string[];
     users?: boolean;
     baseUrl?: string;
 };
 declare const githubDirectory: (options: GitHubDirectoryOptions) => DirectorySource;
 
-export { type DirectoryEntrySource, type DirectorySource, type DirectoryTeam, type DirectoryUser, defineDirectorySource, githubDirectory };
+type MicrosoftEntraGroupInput = string | {
+    id: string;
+    alias?: string;
+} | {
+    displayName: string;
+    alias?: string;
+};
+type MicrosoftEntraDirectoryOptions = {
+    tenantId: string;
+    clientId: string;
+    clientSecret: string;
+    groups: MicrosoftEntraGroupInput[];
+    users?: boolean;
+    includeDisabledUsers?: boolean;
+    graphBaseUrl?: string;
+    tokenUrl?: string;
+};
+declare const microsoftEntraDirectory: (options: MicrosoftEntraDirectoryOptions) => DirectorySource;
+
+export { type DirectoryEntrySource, type DirectorySource, type DirectoryTeam, type DirectoryUser, defineDirectorySource, githubDirectory, microsoftEntraDirectory };

package/dist/index.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   defineDirectorySource: () => defineDirectorySource,
-  githubDirectory: () => githubDirectory
+  githubDirectory: () => githubDirectory,
+  microsoftEntraDirectory: () => microsoftEntraDirectory
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -31,6 +32,11 @@ var defineDirectorySource = (source) => source;
 // src/github-directory.ts
 var GITHUB_API_VERSION = "2022-11-28";
 var githubDirectory = (options) => {
+  if (!Array.isArray(options.teams) || options.teams.length === 0) {
+    throw new Error(
+      'GitHub directory connector requires at least one team slug. Set teams: ["platform"].'
+    );
+  }
   let cachedData;
   const load = () => {
     cachedData = cachedData ?? loadGitHubDirectory(options);
@@ -39,7 +45,6 @@ var githubDirectory = (options) => {
   return defineDirectorySource({
     type: "directory",
     name: `github:${options.org}`,
-    cacheKey: createGitHubDirectoryCacheKey(options),
     loadTeams: async () => {
       const data = await load();
       return data.teams;
@@ -50,12 +55,6 @@ var githubDirectory = (options) => {
     }
   });
 };
-var createGitHubDirectoryCacheKey = (options) => {
-  const teams = options.teams === true || options.teams === void 0 ? "all" : [...options.teams].sort().join(",");
-  const users = options.users !== false ? "true" : "false";
-  const baseUrl = options.baseUrl ?? "https://api.github.com";
-  return `github:${baseUrl}:${options.org}:teams=${teams}:users=${users}`;
-};
 var loadGitHubDirectory = async (options) => {
   const teams = await loadGitHubTeams(options);
   const shouldLoadUsers = options.users !== false;
@@ -80,9 +79,11 @@ var loadGitHubDirectory = async (options) => {
   };
 };
 var loadGitHubTeams = async (options) => {
-  const teams = await paginate(options, `/orgs/${encodeURIComponent(options.org)}/teams`);
-  const configuredTeams = options.teams === void 0 || options.teams === true ? void 0 : new Set(options.teams);
-  return teams.filter((team) => !configuredTeams || configuredTeams.has(team.slug)).map((team) => ({
+  const teams = [];
+  for (const teamSlug of options.teams) {
+    teams.push(await loadGitHubTeam(options, teamSlug));
+  }
+  return teams.map((team) => ({
     id: team.slug,
     name: team.name,
     summary: team.description ?? void 0,
@@ -94,6 +95,16 @@ var loadGitHubTeams = async (options) => {
     }
   }));
 };
+var loadGitHubTeam = async (options, teamSlug) => {
+  const response = await githubRequest(
+    options,
+    buildGitHubUrl(
+      options,
+      `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}`
+    )
+  );
+  return response.data;
+};
 var loadGitHubTeamMembers = async (options, teamSlug) => {
   const members = await paginate(
     options,
@@ -154,7 +165,9 @@ var githubRequest = async (options, url) => {
   });
   if (!response.ok) {
     const message = await response.text();
-    throw new Error(`GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`);
+    throw new Error(
+      `GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`
+    );
   }
   return {
     data: await response.json(),
@@ -175,9 +188,324 @@ var getNextPageUrl = (linkHeader) => {
   const match = nextLink?.match(/<([^>]+)>/);
   return match?.[1];
 };
+
+// src/microsoft-entra-directory.ts
+var DEFAULT_GRAPH_BASE_URL = "https://graph.microsoft.com/v1.0";
+var GRAPH_RETRY_ATTEMPTS = 3;
+var GRAPH_SELECT_GROUP = "id,displayName,description,mail";
+var GRAPH_SELECT_USER = "id,displayName,userPrincipalName,mail,jobTitle,accountEnabled";
+var microsoftEntraDirectory = (options) => {
+  validateOptions(options);
+  let cachedData;
+  const load = () => {
+    cachedData = cachedData ?? loadMicrosoftEntraDirectory(options);
+    return cachedData;
+  };
+  return defineDirectorySource({
+    type: "directory",
+    name: `microsoft-entra:${options.tenantId}`,
+    loadTeams: async () => {
+      const data = await load();
+      return data.teams;
+    },
+    loadUsers: async () => {
+      const data = await load();
+      return data.users;
+    }
+  });
+};
+var validateOptions = (options) => {
+  if (!options.tenantId) {
+    throw new Error("Microsoft Entra directory connector requires tenantId.");
+  }
+  if (!options.clientId) {
+    throw new Error("Microsoft Entra directory connector requires clientId.");
+  }
+  if (!options.clientSecret) {
+    throw new Error(
+      "Microsoft Entra directory connector requires clientSecret."
+    );
+  }
+  if (!Array.isArray(options.groups) || options.groups.length === 0) {
+    throw new Error(
+      'Microsoft Entra directory connector requires at least one group. Set groups: [{ id: "00000000-0000-0000-0000-000000000000" }].'
+    );
+  }
+};
+var loadMicrosoftEntraDirectory = async (options) => {
+  const token = await getAccessToken(options);
+  const resolvedGroups = await loadMicrosoftEntraGroups(options, token);
+  const teams = mapMicrosoftEntraTeams(resolvedGroups);
+  const shouldLoadUsers = options.users !== false;
+  if (!shouldLoadUsers) {
+    return { teams, users: [] };
+  }
+  const usersById = /* @__PURE__ */ new Map();
+  const teamsWithMembers = [];
+  for (const team of teams) {
+    const members = await loadMicrosoftEntraGroupMembers(
+      options,
+      token,
+      String(team.source?.id ?? team.id)
+    );
+    for (const member of members) {
+      usersById.set(member.id, member);
+    }
+    teamsWithMembers.push({
+      ...team,
+      members: members.map((member) => member.id)
+    });
+  }
+  return {
+    teams: teamsWithMembers,
+    users: Array.from(usersById.values())
+  };
+};
+var loadMicrosoftEntraGroups = async (options, token) => {
+  const resolvedGroups = [];
+  for (const groupInput of options.groups) {
+    resolvedGroups.push(
+      await resolveMicrosoftEntraGroup(options, token, groupInput)
+    );
+  }
+  assertUniqueTeamIds(resolvedGroups);
+  return resolvedGroups;
+};
+var resolveMicrosoftEntraGroup = async (options, token, groupInput) => {
+  if (typeof groupInput === "string") {
+    return {
+      group: await loadMicrosoftEntraGroupById(options, token, groupInput)
+    };
+  }
+  if ("id" in groupInput) {
+    return {
+      group: await loadMicrosoftEntraGroupById(options, token, groupInput.id),
+      alias: groupInput.alias
+    };
+  }
+  return {
+    group: await loadMicrosoftEntraGroupByDisplayName(
+      options,
+      token,
+      groupInput.displayName
+    ),
+    alias: groupInput.alias
+  };
+};
+var loadMicrosoftEntraGroupById = async (options, token, groupId) => {
+  return microsoftGraphRequest(
+    options,
+    token,
+    buildMicrosoftGraphUrl(options, `/groups/${encodeURIComponent(groupId)}`, {
+      $select: GRAPH_SELECT_GROUP
+    })
+  );
+};
+var loadMicrosoftEntraGroupByDisplayName = async (options, token, displayName) => {
+  const groups = await paginate2(
+    options,
+    token,
+    buildMicrosoftGraphUrl(options, "/groups", {
+      $filter: `displayName eq '${escapeODataString(displayName)}'`,
+      $select: GRAPH_SELECT_GROUP
+    })
+  );
+  if (groups.length === 0) {
+    throw new Error(
+      `Microsoft Entra directory connector could not find a group with displayName "${displayName}". Use the group id instead.`
+    );
+  }
+  if (groups.length > 1) {
+    throw new Error(
+      `Microsoft Entra directory connector found ${groups.length} groups with displayName "${displayName}". Use the group id instead.`
+    );
+  }
+  return groups[0];
+};
+var mapMicrosoftEntraTeams = (groups) => {
+  return groups.map(({ group, alias }) => {
+    const displayName = group.displayName ?? group.id;
+    return {
+      id: alias ?? slugify(displayName),
+      name: displayName,
+      summary: group.description ?? void 0,
+      email: group.mail ?? void 0,
+      markdown: createMicrosoftEntraSyncedMarkdown("team"),
+      source: {
+        provider: "microsoft-entra",
+        id: group.id
+      }
+    };
+  });
+};
+var loadMicrosoftEntraGroupMembers = async (options, token, groupId) => {
+  const users = await paginate2(
+    options,
+    token,
+    buildMicrosoftGraphUrl(
+      options,
+      `/groups/${encodeURIComponent(groupId)}/members/microsoft.graph.user`,
+      {
+        $select: GRAPH_SELECT_USER
+      }
+    )
+  );
+  return users.filter(
+    (user) => options.includeDisabledUsers || user.accountEnabled !== false
+  ).map(mapMicrosoftEntraUser);
+};
+var mapMicrosoftEntraUser = (user) => {
+  const userPrincipalName = user.userPrincipalName ?? void 0;
+  const email = user.mail ?? userPrincipalName;
+  const id = getMicrosoftEntraUserId(user);
+  const name = user.displayName ?? userPrincipalName ?? user.id;
+  return {
+    id,
+    name,
+    email,
+    role: user.jobTitle ?? void 0,
+    markdown: createMicrosoftEntraSyncedMarkdown("user"),
+    source: {
+      provider: "microsoft-entra",
+      id: user.id
+    }
+  };
+};
+var getMicrosoftEntraUserId = (user) => {
+  if (user.mail) return user.mail.toLowerCase();
+  if (user.userPrincipalName)
+    return normalizeMicrosoftEntraUserPrincipalName(user.userPrincipalName);
+  return user.id;
+};
+var normalizeMicrosoftEntraUserPrincipalName = (userPrincipalName) => {
+  const guestUserMatch = userPrincipalName.match(/^(.+)#EXT#@.+$/i);
+  if (!guestUserMatch) return userPrincipalName.toLowerCase();
+  const externalUserName = guestUserMatch[1];
+  const lastUnderscoreIndex = externalUserName.lastIndexOf("_");
+  if (lastUnderscoreIndex === -1) return externalUserName.toLowerCase();
+  return `${externalUserName.slice(0, lastUnderscoreIndex)}@${externalUserName.slice(lastUnderscoreIndex + 1)}`.toLowerCase();
+};
+var createMicrosoftEntraSyncedMarkdown = (type) => {
+  if (type === "team") {
+    return [
+      ":::note",
+      "This team is synced from Microsoft Entra ID and is read-only in EventCatalog.",
+      "",
+      "Manage the team and its members in Microsoft Entra ID.",
+      ":::"
+    ].join("\n");
+  }
+  return [
+    ":::note",
+    "This user is synced from Microsoft Entra ID and is read-only in EventCatalog.",
+    "",
+    "Manage profile details and team membership in Microsoft Entra ID.",
+    ":::"
+  ].join("\n");
+};
+var getAccessToken = async (options) => {
+  const tokenUrl = options.tokenUrl ?? `https://login.microsoftonline.com/${encodeURIComponent(options.tenantId)}/oauth2/v2.0/token`;
+  const body = new URLSearchParams({
+    client_id: options.clientId,
+    client_secret: options.clientSecret,
+    grant_type: "client_credentials",
+    scope: getMicrosoftGraphScope(options)
+  });
+  const response = await fetch(tokenUrl, {
+    method: "POST",
+    headers: {
+      "content-type": "application/x-www-form-urlencoded",
+      "user-agent": "@eventcatalog/connectors"
+    },
+    body
+  });
+  if (!response.ok) {
+    const message = await response.text();
+    throw new Error(
+      `Microsoft Entra directory connector failed to get an access token (${response.status} ${response.statusText}): ${message}`
+    );
+  }
+  const data = await response.json();
+  if (!data.access_token) {
+    throw new Error(
+      "Microsoft Entra directory connector failed to get an access token: response did not include access_token."
+    );
+  }
+  return data.access_token;
+};
+var getMicrosoftGraphScope = (options) => {
+  const graphBaseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;
+  return `${new URL(graphBaseUrl).origin}/.default`;
+};
+var microsoftGraphRequest = async (options, token, url, attempt = 0) => {
+  const response = await fetch(url, {
+    headers: {
+      accept: "application/json",
+      authorization: `Bearer ${token}`,
+      ConsistencyLevel: "eventual",
+      "user-agent": "@eventcatalog/connectors"
+    }
+  });
+  if (response.status === 429 && attempt < GRAPH_RETRY_ATTEMPTS) {
+    await waitForRetry(response.headers.get("retry-after"));
+    return microsoftGraphRequest(options, token, url, attempt + 1);
+  }
+  if (!response.ok) {
+    const message = await response.text();
+    throw new Error(
+      `Microsoft Entra directory connector failed (${response.status} ${response.statusText}): ${message}`
+    );
+  }
+  return await response.json();
+};
+var paginate2 = async (options, token, url) => {
+  const results = [];
+  let nextUrl = url;
+  while (nextUrl) {
+    const response = await microsoftGraphRequest(options, token, nextUrl);
+    results.push(...response.value ?? []);
+    nextUrl = response["@odata.nextLink"];
+  }
+  return results;
+};
+var buildMicrosoftGraphUrl = (options, pathname, query) => {
+  const baseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;
+  const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+  const normalizedPathname = pathname.replace(/^\//u, "");
+  const url = new URL(normalizedPathname, normalizedBaseUrl);
+  for (const [key, value] of Object.entries(query ?? {})) {
+    url.searchParams.set(key, value);
+  }
+  return url.toString();
+};
+var assertUniqueTeamIds = (groups) => {
+  const teamIds = /* @__PURE__ */ new Map();
+  for (const { group, alias } of groups) {
+    const displayName = group.displayName ?? group.id;
+    const teamId = alias ?? slugify(displayName);
+    const existingGroupId = teamIds.get(teamId);
+    if (existingGroupId) {
+      throw new Error(
+        `Microsoft Entra directory connector resolved duplicate team id "${teamId}" from groups "${existingGroupId}" and "${group.id}". Set alias for one of the groups.`
+      );
+    }
+    teamIds.set(teamId, group.id);
+  }
+};
+var slugify = (value) => {
+  const slug = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return slug || value;
+};
+var escapeODataString = (value) => value.replace(/'/g, "''");
+var waitForRetry = async (retryAfter) => {
+  const retryAfterSeconds = retryAfter ? Number(retryAfter) : 1;
+  const delayMs = Number.isFinite(retryAfterSeconds) ? Math.max(retryAfterSeconds, 0) * 1e3 : 1e3;
+  await new Promise((resolve) => setTimeout(resolve, delayMs));
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   defineDirectorySource,
-  githubDirectory
+  githubDirectory,
+  microsoftEntraDirectory
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/github-directory.ts"],"sourcesContent":["export { githubDirectory } from './github-directory';\nexport { defineDirectorySource } from './types';\nexport type { DirectoryEntrySource, DirectorySource, DirectoryTeam, DirectoryUser } from './types';\n","/**\n * Describes where a generated directory entry came from.\n *\n * EventCatalog uses the provider to show source badges and to treat generated\n * resources as externally managed.\n */\nexport type DirectoryEntrySource = {\n  /** Provider identifier, for example `github`, `okta`, or `ldap`. */\n  provider: string;\n  /** Optional provider-specific identifier for the external resource. */\n  id?: string;\n  /** Optional URL back to the resource in the external provider. */\n  url?: string;\n  [key: string]: unknown;\n};\n\n/**\n * User returned by a directory source.\n *\n * Directory users are synced as read-only EventCatalog users and can be\n * referenced by teams through their `id`.\n */\nexport type DirectoryUser = {\n  id: string;\n  name: string;\n  avatarUrl: string;\n  role?: string;\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Team returned by a directory source.\n *\n * Directory teams are synced as read-only EventCatalog teams.\n */\nexport type DirectoryTeam = {\n  id: string;\n  name: string;\n  summary?: string;\n  /** User IDs for members of this team. */\n  members?: string[];\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Loads users and/or teams from an external directory provider.\n *\n * EventCatalog calls these loaders during content sync, writes the returned\n * entries into Astro collections, and mirrors them into the generated\n * `.eventcatalog/store/directory.json` file for SDK/editor reads.\n */\nexport type DirectorySource = {\n  type: 'directory';\n  /** Stable source identifier, usually `<provider>:<account-or-org>`. */\n  name: string;\n  /** Optional stable cache key for this source configuration. */\n  cacheKey?: string;\n  /** Load users from the external directory. */\n  loadUsers?: () => Promise<DirectoryUser[]>;\n  /** Load teams from the external directory. */\n  loadTeams?: () => Promise<DirectoryTeam[]>;\n};\n\n/**\n * Defines a custom directory source with type inference for connector authors.\n */\nexport const defineDirectorySource = <TSource extends DirectorySource>(source: TSource) => source;\n","import { defineDirectorySource, type DirectorySource, type DirectoryTeam, type DirectoryUser } from './types';\n\ntype GitHubDirectoryOptions = {\n  org: string;\n  token?: string;\n  teams?: true | string[];\n  users?: boolean;\n  baseUrl?: string;\n};\n\ntype GitHubTeam = {\n  id: number;\n  name: string;\n  slug: string;\n  description: string | null;\n  html_url: string;\n};\n\ntype GitHubUser = {\n  id: number;\n  login: string;\n  avatar_url: string;\n  html_url: string;\n};\n\ntype GitHubDirectoryData = {\n  teams: DirectoryTeam[];\n  users: DirectoryUser[];\n};\n\nconst GITHUB_API_VERSION = '2022-11-28';\n\nexport const githubDirectory = (options: GitHubDirectoryOptions): DirectorySource => {\n  let cachedData: Promise<GitHubDirectoryData> | undefined;\n\n  const load = () => {\n    cachedData = cachedData ?? loadGitHubDirectory(options);\n    return cachedData;\n  };\n\n  return defineDirectorySource({\n    type: 'directory',\n    name: `github:${options.org}`,\n    cacheKey: createGitHubDirectoryCacheKey(options),\n    loadTeams: async () => {\n      const data = await load();\n      return data.teams;\n    },\n    loadUsers: async () => {\n      const data = await load();\n      return data.users;\n    },\n  });\n};\n\nconst createGitHubDirectoryCacheKey = (options: GitHubDirectoryOptions) => {\n  const teams = options.teams === true || options.teams === undefined ? 'all' : [...options.teams].sort().join(',');\n  const users = options.users !== false ? 'true' : 'false';\n  const baseUrl = options.baseUrl ?? 'https://api.github.com';\n\n  return `github:${baseUrl}:${options.org}:teams=${teams}:users=${users}`;\n};\n\nconst loadGitHubDirectory = async (options: GitHubDirectoryOptions): Promise<GitHubDirectoryData> => {\n  const teams = await loadGitHubTeams(options);\n  const shouldLoadUsers = options.users !== false;\n\n  if (!shouldLoadUsers) {\n    return { teams, users: [] };\n  }\n\n  const usersById = new Map<string, DirectoryUser>();\n  const teamsWithMembers: DirectoryTeam[] = [];\n\n  for (const team of teams) {\n    const members = await loadGitHubTeamMembers(options, team.id);\n\n    for (const member of members) {\n      usersById.set(member.id, member);\n    }\n\n    teamsWithMembers.push({\n      ...team,\n      members: members.map((member) => member.id),\n    });\n  }\n\n  return {\n    teams: teamsWithMembers,\n    users: Array.from(usersById.values()),\n  };\n};\n\nconst loadGitHubTeams = async (options: GitHubDirectoryOptions): Promise<DirectoryTeam[]> => {\n  const teams = await paginate<GitHubTeam>(options, `/orgs/${encodeURIComponent(options.org)}/teams`);\n  const configuredTeams = options.teams === undefined || options.teams === true ? undefined : new Set(options.teams);\n\n  return teams\n    .filter((team) => !configuredTeams || configuredTeams.has(team.slug))\n    .map((team) => ({\n      id: team.slug,\n      name: team.name,\n      summary: team.description ?? undefined,\n      markdown: createGitHubSyncedMarkdown('team', team.html_url),\n      source: {\n        provider: 'github',\n        id: String(team.id),\n        url: team.html_url,\n      },\n    }));\n};\n\nconst loadGitHubTeamMembers = async (options: GitHubDirectoryOptions, teamSlug: string): Promise<DirectoryUser[]> => {\n  const members = await paginate<GitHubUser>(\n    options,\n    `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}/members`\n  );\n\n  return members.map((member) => ({\n    id: member.login,\n    name: member.login,\n    avatarUrl: member.avatar_url,\n    markdown: createGitHubSyncedMarkdown('user', member.html_url),\n    source: {\n      provider: 'github',\n      id: String(member.id),\n      url: member.html_url,\n    },\n  }));\n};\n\nconst createGitHubSyncedMarkdown = (type: 'team' | 'user', url: string) => {\n  if (type === 'team') {\n    return [\n      ':::note',\n      'This team is synced from GitHub and is read-only in EventCatalog.',\n      '',\n      'Manage the team and its members in GitHub.',\n      '',\n      `[View team on GitHub](${url})`,\n      ':::',\n    ].join('\\n');\n  }\n\n  return [\n    ':::note',\n    'This user is synced from GitHub and is read-only in EventCatalog.',\n    '',\n    'Manage profile details and team membership in GitHub.',\n    '',\n    `[View user on GitHub](${url})`,\n    ':::',\n  ].join('\\n');\n};\n\nconst paginate = async <T>(options: GitHubDirectoryOptions, pathname: string): Promise<T[]> => {\n  const results: T[] = [];\n  let url: string | undefined = buildGitHubUrl(options, pathname);\n\n  while (url) {\n    const response = await githubRequest<T[]>(options, url);\n    results.push(...response.data);\n    url = getNextPageUrl(response.headers.get('link'));\n  }\n\n  return results;\n};\n\nconst githubRequest = async <T>(\n  options: GitHubDirectoryOptions,\n  url: string\n): Promise<{ data: T; headers: Headers }> => {\n  const response = await fetch(url, {\n    headers: {\n      accept: 'application/vnd.github+json',\n      'x-github-api-version': GITHUB_API_VERSION,\n      'user-agent': '@eventcatalog/connectors',\n      ...(options.token ? { authorization: `Bearer ${options.token}` } : {}),\n    },\n  });\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(`GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`);\n  }\n\n  return {\n    data: (await response.json()) as T,\n    headers: response.headers,\n  };\n};\n\nconst buildGitHubUrl = (options: GitHubDirectoryOptions, pathname: string) => {\n  const baseUrl = options.baseUrl ?? 'https://api.github.com';\n  const normalizedBaseUrl = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;\n  const normalizedPathname = pathname.replace(/^\\//u, '');\n  const url = new URL(normalizedPathname, normalizedBaseUrl);\n  url.searchParams.set('per_page', '100');\n  return url.toString();\n};\n\nconst getNextPageUrl = (linkHeader: string | null) => {\n  if (!linkHeader) return undefined;\n\n  const nextLink = linkHeader.split(',').find((link) => link.includes('rel=\"next\"'));\n  const match = nextLink?.match(/<([^>]+)>/);\n\n  return match?.[1];\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/github-directory.ts","../src/microsoft-entra-directory.ts"],"sourcesContent":["export { githubDirectory } from \"./github-directory\";\nexport { microsoftEntraDirectory } from \"./microsoft-entra-directory\";\nexport { defineDirectorySource } from \"./types\";\nexport type {\n  DirectoryEntrySource,\n  DirectorySource,\n  DirectoryTeam,\n  DirectoryUser,\n} from \"./types\";\n","/**\n * Describes where a generated directory entry came from.\n *\n * EventCatalog uses the provider to show source badges and to treat generated\n * resources as externally managed.\n */\nexport type DirectoryEntrySource = {\n  /** Provider identifier, for example `github`, `okta`, or `ldap`. */\n  provider: string;\n  /** Optional provider-specific identifier for the external resource. */\n  id?: string;\n  /** Optional URL back to the resource in the external provider. */\n  url?: string;\n  [key: string]: unknown;\n};\n\n/**\n * User returned by a directory source.\n *\n * Directory users are synced as read-only EventCatalog users and can be\n * referenced by teams through their `id`.\n */\nexport type DirectoryUser = {\n  id: string;\n  name: string;\n  avatarUrl?: string;\n  role?: string;\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Team returned by a directory source.\n *\n * Directory teams are synced as read-only EventCatalog teams.\n */\nexport type DirectoryTeam = {\n  id: string;\n  name: string;\n  summary?: string;\n  /** User IDs for members of this team. */\n  members?: string[];\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Loads users and/or teams from an external directory provider.\n *\n * EventCatalog calls these loaders during content sync, writes the returned\n * entries into Astro collections, and mirrors them into the generated\n * `.eventcatalog/store/directory.json` file for SDK/editor reads.\n */\nexport type DirectorySource = {\n  type: \"directory\";\n  /** Stable source identifier, usually `<provider>:<account-or-org>`. */\n  name: string;\n  /** Load users from the external directory. */\n  loadUsers?: () => Promise<DirectoryUser[]>;\n  /** Load teams from the external directory. */\n  loadTeams?: () => Promise<DirectoryTeam[]>;\n};\n\n/**\n * Defines a custom directory source with type inference for connector authors.\n */\nexport const defineDirectorySource = <TSource extends DirectorySource>(\n  source: TSource,\n) => source;\n","import {\n  defineDirectorySource,\n  type DirectorySource,\n  type DirectoryTeam,\n  type DirectoryUser,\n} from \"./types\";\n\ntype GitHubDirectoryOptions = {\n  org: string;\n  token?: string;\n  teams: string[];\n  users?: boolean;\n  baseUrl?: string;\n};\n\ntype GitHubTeam = {\n  id: number;\n  name: string;\n  slug: string;\n  description: string | null;\n  html_url: string;\n};\n\ntype GitHubUser = {\n  id: number;\n  login: string;\n  avatar_url: string;\n  html_url: string;\n};\n\ntype GitHubDirectoryData = {\n  teams: DirectoryTeam[];\n  users: DirectoryUser[];\n};\n\nconst GITHUB_API_VERSION = \"2022-11-28\";\n\nexport const githubDirectory = (\n  options: GitHubDirectoryOptions,\n): DirectorySource => {\n  if (!Array.isArray(options.teams) || options.teams.length === 0) {\n    throw new Error(\n      'GitHub directory connector requires at least one team slug. Set teams: [\"platform\"].',\n    );\n  }\n\n  let cachedData: Promise<GitHubDirectoryData> | undefined;\n\n  const load = () => {\n    cachedData = cachedData ?? loadGitHubDirectory(options);\n    return cachedData;\n  };\n\n  return defineDirectorySource({\n    type: \"directory\",\n    name: `github:${options.org}`,\n    loadTeams: async () => {\n      const data = await load();\n      return data.teams;\n    },\n    loadUsers: async () => {\n      const data = await load();\n      return data.users;\n    },\n  });\n};\n\nconst loadGitHubDirectory = async (\n  options: GitHubDirectoryOptions,\n): Promise<GitHubDirectoryData> => {\n  const teams = await loadGitHubTeams(options);\n  const shouldLoadUsers = options.users !== false;\n\n  if (!shouldLoadUsers) {\n    return { teams, users: [] };\n  }\n\n  const usersById = new Map<string, DirectoryUser>();\n  const teamsWithMembers: DirectoryTeam[] = [];\n\n  for (const team of teams) {\n    const members = await loadGitHubTeamMembers(options, team.id);\n\n    for (const member of members) {\n      usersById.set(member.id, member);\n    }\n\n    teamsWithMembers.push({\n      ...team,\n      members: members.map((member) => member.id),\n    });\n  }\n\n  return {\n    teams: teamsWithMembers,\n    users: Array.from(usersById.values()),\n  };\n};\n\nconst loadGitHubTeams = async (\n  options: GitHubDirectoryOptions,\n): Promise<DirectoryTeam[]> => {\n  const teams: GitHubTeam[] = [];\n\n  for (const teamSlug of options.teams) {\n    teams.push(await loadGitHubTeam(options, teamSlug));\n  }\n\n  return teams.map((team) => ({\n    id: team.slug,\n    name: team.name,\n    summary: team.description ?? undefined,\n    markdown: createGitHubSyncedMarkdown(\"team\", team.html_url),\n    source: {\n      provider: \"github\",\n      id: String(team.id),\n      url: team.html_url,\n    },\n  }));\n};\n\nconst loadGitHubTeam = async (\n  options: GitHubDirectoryOptions,\n  teamSlug: string,\n) => {\n  const response = await githubRequest<GitHubTeam>(\n    options,\n    buildGitHubUrl(\n      options,\n      `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}`,\n    ),\n  );\n\n  return response.data;\n};\n\nconst loadGitHubTeamMembers = async (\n  options: GitHubDirectoryOptions,\n  teamSlug: string,\n): Promise<DirectoryUser[]> => {\n  const members = await paginate<GitHubUser>(\n    options,\n    `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}/members`,\n  );\n\n  return members.map((member) => ({\n    id: member.login,\n    name: member.login,\n    avatarUrl: member.avatar_url,\n    markdown: createGitHubSyncedMarkdown(\"user\", member.html_url),\n    source: {\n      provider: \"github\",\n      id: String(member.id),\n      url: member.html_url,\n    },\n  }));\n};\n\nconst createGitHubSyncedMarkdown = (type: \"team\" | \"user\", url: string) => {\n  if (type === \"team\") {\n    return [\n      \":::note\",\n      \"This team is synced from GitHub and is read-only in EventCatalog.\",\n      \"\",\n      \"Manage the team and its members in GitHub.\",\n      \"\",\n      `[View team on GitHub](${url})`,\n      \":::\",\n    ].join(\"\\n\");\n  }\n\n  return [\n    \":::note\",\n    \"This user is synced from GitHub and is read-only in EventCatalog.\",\n    \"\",\n    \"Manage profile details and team membership in GitHub.\",\n    \"\",\n    `[View user on GitHub](${url})`,\n    \":::\",\n  ].join(\"\\n\");\n};\n\nconst paginate = async <T>(\n  options: GitHubDirectoryOptions,\n  pathname: string,\n): Promise<T[]> => {\n  const results: T[] = [];\n  let url: string | undefined = buildGitHubUrl(options, pathname);\n\n  while (url) {\n    const response = await githubRequest<T[]>(options, url);\n    results.push(...response.data);\n    url = getNextPageUrl(response.headers.get(\"link\"));\n  }\n\n  return results;\n};\n\nconst githubRequest = async <T>(\n  options: GitHubDirectoryOptions,\n  url: string,\n): Promise<{ data: T; headers: Headers }> => {\n  const response = await fetch(url, {\n    headers: {\n      accept: \"application/vnd.github+json\",\n      \"x-github-api-version\": GITHUB_API_VERSION,\n      \"user-agent\": \"@eventcatalog/connectors\",\n      ...(options.token ? { authorization: `Bearer ${options.token}` } : {}),\n    },\n  });\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(\n      `GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`,\n    );\n  }\n\n  return {\n    data: (await response.json()) as T,\n    headers: response.headers,\n  };\n};\n\nconst buildGitHubUrl = (options: GitHubDirectoryOptions, pathname: string) => {\n  const baseUrl = options.baseUrl ?? \"https://api.github.com\";\n  const normalizedBaseUrl = baseUrl.endsWith(\"/\") ? baseUrl : `${baseUrl}/`;\n  const normalizedPathname = pathname.replace(/^\\//u, \"\");\n  const url = new URL(normalizedPathname, normalizedBaseUrl);\n  url.searchParams.set(\"per_page\", \"100\");\n  return url.toString();\n};\n\nconst getNextPageUrl = (linkHeader: string | null) => {\n  if (!linkHeader) return undefined;\n\n  const nextLink = linkHeader\n    .split(\",\")\n    .find((link) => link.includes('rel=\"next\"'));\n  const match = nextLink?.match(/<([^>]+)>/);\n\n  return match?.[1];\n};\n","import {\n  defineDirectorySource,\n  type DirectorySource,\n  type DirectoryTeam,\n  type DirectoryUser,\n} from \"./types\";\n\ntype MicrosoftEntraGroupInput =\n  | string\n  | {\n      id: string;\n      alias?: string;\n    }\n  | {\n      displayName: string;\n      alias?: string;\n    };\n\ntype MicrosoftEntraDirectoryOptions = {\n  tenantId: string;\n  clientId: string;\n  clientSecret: string;\n  groups: MicrosoftEntraGroupInput[];\n  users?: boolean;\n  includeDisabledUsers?: boolean;\n  graphBaseUrl?: string;\n  tokenUrl?: string;\n};\n\ntype MicrosoftEntraGroup = {\n  id: string;\n  displayName?: string | null;\n  description?: string | null;\n  mail?: string | null;\n};\n\ntype MicrosoftEntraUser = {\n  id: string;\n  displayName?: string | null;\n  userPrincipalName?: string | null;\n  mail?: string | null;\n  jobTitle?: string | null;\n  accountEnabled?: boolean | null;\n};\n\ntype MicrosoftEntraDirectoryData = {\n  teams: DirectoryTeam[];\n  users: DirectoryUser[];\n};\n\ntype MicrosoftGraphCollection<T> = {\n  value?: T[];\n  \"@odata.nextLink\"?: string;\n};\n\ntype ResolvedGroupInput = {\n  group: MicrosoftEntraGroup;\n  alias?: string;\n};\n\nconst DEFAULT_GRAPH_BASE_URL = \"https://graph.microsoft.com/v1.0\";\nconst GRAPH_RETRY_ATTEMPTS = 3;\nconst GRAPH_SELECT_GROUP = \"id,displayName,description,mail\";\nconst GRAPH_SELECT_USER =\n  \"id,displayName,userPrincipalName,mail,jobTitle,accountEnabled\";\n\nexport const microsoftEntraDirectory = (\n  options: MicrosoftEntraDirectoryOptions,\n): DirectorySource => {\n  validateOptions(options);\n\n  let cachedData: Promise<MicrosoftEntraDirectoryData> | undefined;\n\n  const load = () => {\n    cachedData = cachedData ?? loadMicrosoftEntraDirectory(options);\n    return cachedData;\n  };\n\n  return defineDirectorySource({\n    type: \"directory\",\n    name: `microsoft-entra:${options.tenantId}`,\n    loadTeams: async () => {\n      const data = await load();\n      return data.teams;\n    },\n    loadUsers: async () => {\n      const data = await load();\n      return data.users;\n    },\n  });\n};\n\nconst validateOptions = (options: MicrosoftEntraDirectoryOptions) => {\n  if (!options.tenantId) {\n    throw new Error(\"Microsoft Entra directory connector requires tenantId.\");\n  }\n  if (!options.clientId) {\n    throw new Error(\"Microsoft Entra directory connector requires clientId.\");\n  }\n  if (!options.clientSecret) {\n    throw new Error(\n      \"Microsoft Entra directory connector requires clientSecret.\",\n    );\n  }\n  if (!Array.isArray(options.groups) || options.groups.length === 0) {\n    throw new Error(\n      'Microsoft Entra directory connector requires at least one group. Set groups: [{ id: \"00000000-0000-0000-0000-000000000000\" }].',\n    );\n  }\n};\n\nconst loadMicrosoftEntraDirectory = async (\n  options: MicrosoftEntraDirectoryOptions,\n): Promise<MicrosoftEntraDirectoryData> => {\n  const token = await getAccessToken(options);\n  const resolvedGroups = await loadMicrosoftEntraGroups(options, token);\n  const teams = mapMicrosoftEntraTeams(resolvedGroups);\n  const shouldLoadUsers = options.users !== false;\n\n  if (!shouldLoadUsers) {\n    return { teams, users: [] };\n  }\n\n  const usersById = new Map<string, DirectoryUser>();\n  const teamsWithMembers: DirectoryTeam[] = [];\n\n  for (const team of teams) {\n    const members = await loadMicrosoftEntraGroupMembers(\n      options,\n      token,\n      String(team.source?.id ?? team.id),\n    );\n\n    for (const member of members) {\n      usersById.set(member.id, member);\n    }\n\n    teamsWithMembers.push({\n      ...team,\n      members: members.map((member) => member.id),\n    });\n  }\n\n  return {\n    teams: teamsWithMembers,\n    users: Array.from(usersById.values()),\n  };\n};\n\nconst loadMicrosoftEntraGroups = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n): Promise<ResolvedGroupInput[]> => {\n  const resolvedGroups: ResolvedGroupInput[] = [];\n\n  for (const groupInput of options.groups) {\n    resolvedGroups.push(\n      await resolveMicrosoftEntraGroup(options, token, groupInput),\n    );\n  }\n\n  assertUniqueTeamIds(resolvedGroups);\n\n  return resolvedGroups;\n};\n\nconst resolveMicrosoftEntraGroup = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  groupInput: MicrosoftEntraGroupInput,\n): Promise<ResolvedGroupInput> => {\n  if (typeof groupInput === \"string\") {\n    return {\n      group: await loadMicrosoftEntraGroupById(options, token, groupInput),\n    };\n  }\n\n  if (\"id\" in groupInput) {\n    return {\n      group: await loadMicrosoftEntraGroupById(options, token, groupInput.id),\n      alias: groupInput.alias,\n    };\n  }\n\n  return {\n    group: await loadMicrosoftEntraGroupByDisplayName(\n      options,\n      token,\n      groupInput.displayName,\n    ),\n    alias: groupInput.alias,\n  };\n};\n\nconst loadMicrosoftEntraGroupById = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  groupId: string,\n) => {\n  return microsoftGraphRequest<MicrosoftEntraGroup>(\n    options,\n    token,\n    buildMicrosoftGraphUrl(options, `/groups/${encodeURIComponent(groupId)}`, {\n      $select: GRAPH_SELECT_GROUP,\n    }),\n  );\n};\n\nconst loadMicrosoftEntraGroupByDisplayName = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  displayName: string,\n) => {\n  const groups = await paginate<MicrosoftEntraGroup>(\n    options,\n    token,\n    buildMicrosoftGraphUrl(options, \"/groups\", {\n      $filter: `displayName eq '${escapeODataString(displayName)}'`,\n      $select: GRAPH_SELECT_GROUP,\n    }),\n  );\n\n  if (groups.length === 0) {\n    throw new Error(\n      `Microsoft Entra directory connector could not find a group with displayName \"${displayName}\". Use the group id instead.`,\n    );\n  }\n\n  if (groups.length > 1) {\n    throw new Error(\n      `Microsoft Entra directory connector found ${groups.length} groups with displayName \"${displayName}\". Use the group id instead.`,\n    );\n  }\n\n  return groups[0];\n};\n\nconst mapMicrosoftEntraTeams = (groups: ResolvedGroupInput[]) => {\n  return groups.map(({ group, alias }) => {\n    const displayName = group.displayName ?? group.id;\n\n    return {\n      id: alias ?? slugify(displayName),\n      name: displayName,\n      summary: group.description ?? undefined,\n      email: group.mail ?? undefined,\n      markdown: createMicrosoftEntraSyncedMarkdown(\"team\"),\n      source: {\n        provider: \"microsoft-entra\",\n        id: group.id,\n      },\n    };\n  });\n};\n\nconst loadMicrosoftEntraGroupMembers = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  groupId: string,\n): Promise<DirectoryUser[]> => {\n  const users = await paginate<MicrosoftEntraUser>(\n    options,\n    token,\n    buildMicrosoftGraphUrl(\n      options,\n      `/groups/${encodeURIComponent(groupId)}/members/microsoft.graph.user`,\n      {\n        $select: GRAPH_SELECT_USER,\n      },\n    ),\n  );\n\n  return users\n    .filter(\n      (user) => options.includeDisabledUsers || user.accountEnabled !== false,\n    )\n    .map(mapMicrosoftEntraUser);\n};\n\nconst mapMicrosoftEntraUser = (user: MicrosoftEntraUser): DirectoryUser => {\n  const userPrincipalName = user.userPrincipalName ?? undefined;\n  const email = user.mail ?? userPrincipalName;\n  const id = getMicrosoftEntraUserId(user);\n  const name = user.displayName ?? userPrincipalName ?? user.id;\n\n  return {\n    id,\n    name,\n    email,\n    role: user.jobTitle ?? undefined,\n    markdown: createMicrosoftEntraSyncedMarkdown(\"user\"),\n    source: {\n      provider: \"microsoft-entra\",\n      id: user.id,\n    },\n  };\n};\n\nconst getMicrosoftEntraUserId = (user: MicrosoftEntraUser) => {\n  if (user.mail) return user.mail.toLowerCase();\n  if (user.userPrincipalName)\n    return normalizeMicrosoftEntraUserPrincipalName(user.userPrincipalName);\n  return user.id;\n};\n\nconst normalizeMicrosoftEntraUserPrincipalName = (\n  userPrincipalName: string,\n) => {\n  const guestUserMatch = userPrincipalName.match(/^(.+)#EXT#@.+$/i);\n\n  if (!guestUserMatch) return userPrincipalName.toLowerCase();\n\n  const externalUserName = guestUserMatch[1];\n  const lastUnderscoreIndex = externalUserName.lastIndexOf(\"_\");\n\n  if (lastUnderscoreIndex === -1) return externalUserName.toLowerCase();\n\n  return `${externalUserName.slice(0, lastUnderscoreIndex)}@${externalUserName.slice(lastUnderscoreIndex + 1)}`.toLowerCase();\n};\n\nconst createMicrosoftEntraSyncedMarkdown = (type: \"team\" | \"user\") => {\n  if (type === \"team\") {\n    return [\n      \":::note\",\n      \"This team is synced from Microsoft Entra ID and is read-only in EventCatalog.\",\n      \"\",\n      \"Manage the team and its members in Microsoft Entra ID.\",\n      \":::\",\n    ].join(\"\\n\");\n  }\n\n  return [\n    \":::note\",\n    \"This user is synced from Microsoft Entra ID and is read-only in EventCatalog.\",\n    \"\",\n    \"Manage profile details and team membership in Microsoft Entra ID.\",\n    \":::\",\n  ].join(\"\\n\");\n};\n\nconst getAccessToken = async (options: MicrosoftEntraDirectoryOptions) => {\n  const tokenUrl =\n    options.tokenUrl ??\n    `https://login.microsoftonline.com/${encodeURIComponent(options.tenantId)}/oauth2/v2.0/token`;\n  const body = new URLSearchParams({\n    client_id: options.clientId,\n    client_secret: options.clientSecret,\n    grant_type: \"client_credentials\",\n    scope: getMicrosoftGraphScope(options),\n  });\n\n  const response = await fetch(tokenUrl, {\n    method: \"POST\",\n    headers: {\n      \"content-type\": \"application/x-www-form-urlencoded\",\n      \"user-agent\": \"@eventcatalog/connectors\",\n    },\n    body,\n  });\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(\n      `Microsoft Entra directory connector failed to get an access token (${response.status} ${response.statusText}): ${message}`,\n    );\n  }\n\n  const data = (await response.json()) as { access_token?: string };\n  if (!data.access_token) {\n    throw new Error(\n      \"Microsoft Entra directory connector failed to get an access token: response did not include access_token.\",\n    );\n  }\n\n  return data.access_token;\n};\n\nconst getMicrosoftGraphScope = (options: MicrosoftEntraDirectoryOptions) => {\n  const graphBaseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;\n  return `${new URL(graphBaseUrl).origin}/.default`;\n};\n\nconst microsoftGraphRequest = async <T>(\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  url: string,\n  attempt = 0,\n): Promise<T> => {\n  const response = await fetch(url, {\n    headers: {\n      accept: \"application/json\",\n      authorization: `Bearer ${token}`,\n      ConsistencyLevel: \"eventual\",\n      \"user-agent\": \"@eventcatalog/connectors\",\n    },\n  });\n\n  if (response.status === 429 && attempt < GRAPH_RETRY_ATTEMPTS) {\n    await waitForRetry(response.headers.get(\"retry-after\"));\n    return microsoftGraphRequest(options, token, url, attempt + 1);\n  }\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(\n      `Microsoft Entra directory connector failed (${response.status} ${response.statusText}): ${message}`,\n    );\n  }\n\n  return (await response.json()) as T;\n};\n\nconst paginate = async <T>(\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  url: string,\n): Promise<T[]> => {\n  const results: T[] = [];\n  let nextUrl: string | undefined = url;\n\n  while (nextUrl) {\n    const response: MicrosoftGraphCollection<T> = await microsoftGraphRequest<\n      MicrosoftGraphCollection<T>\n    >(options, token, nextUrl);\n    results.push(...(response.value ?? []));\n    nextUrl = response[\"@odata.nextLink\"];\n  }\n\n  return results;\n};\n\nconst buildMicrosoftGraphUrl = (\n  options: MicrosoftEntraDirectoryOptions,\n  pathname: string,\n  query?: Record<string, string>,\n) => {\n  const baseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;\n  const normalizedBaseUrl = baseUrl.endsWith(\"/\") ? baseUrl : `${baseUrl}/`;\n  const normalizedPathname = pathname.replace(/^\\//u, \"\");\n  const url = new URL(normalizedPathname, normalizedBaseUrl);\n\n  for (const [key, value] of Object.entries(query ?? {})) {\n    url.searchParams.set(key, value);\n  }\n\n  return url.toString();\n};\n\nconst assertUniqueTeamIds = (groups: ResolvedGroupInput[]) => {\n  const teamIds = new Map<string, string>();\n\n  for (const { group, alias } of groups) {\n    const displayName = group.displayName ?? group.id;\n    const teamId = alias ?? slugify(displayName);\n    const existingGroupId = teamIds.get(teamId);\n\n    if (existingGroupId) {\n      throw new Error(\n        `Microsoft Entra directory connector resolved duplicate team id \"${teamId}\" from groups \"${existingGroupId}\" and \"${group.id}\". Set alias for one of the groups.`,\n      );\n    }\n\n    teamIds.set(teamId, group.id);\n  }\n};\n\nconst slugify = (value: string) => {\n  const slug = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n\n  return slug || value;\n};\n\nconst escapeODataString = (value: string) => value.replace(/'/g, \"''\");\n\nconst waitForRetry = async (retryAfter: string | null) => {\n  const retryAfterSeconds = retryAfter ? Number(retryAfter) : 1;\n  const delayMs = Number.isFinite(retryAfterSeconds)\n    ? Math.max(retryAfterSeconds, 0) * 1000\n    : 1000;\n\n  await new Promise((resolve) => setTimeout(resolve, delayMs));\n};\n"],"mappings":"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","names":["paginate"]}

package/dist/index.mjs

@@ -4,6 +4,11 @@ var defineDirectorySource = (source) => source;
 // src/github-directory.ts
 var GITHUB_API_VERSION = "2022-11-28";
 var githubDirectory = (options) => {
+  if (!Array.isArray(options.teams) || options.teams.length === 0) {
+    throw new Error(
+      'GitHub directory connector requires at least one team slug. Set teams: ["platform"].'
+    );
+  }
   let cachedData;
   const load = () => {
     cachedData = cachedData ?? loadGitHubDirectory(options);
@@ -12,7 +17,6 @@ var githubDirectory = (options) => {
   return defineDirectorySource({
     type: "directory",
     name: `github:${options.org}`,
-    cacheKey: createGitHubDirectoryCacheKey(options),
     loadTeams: async () => {
       const data = await load();
       return data.teams;
@@ -23,12 +27,6 @@ var githubDirectory = (options) => {
     }
   });
 };
-var createGitHubDirectoryCacheKey = (options) => {
-  const teams = options.teams === true || options.teams === void 0 ? "all" : [...options.teams].sort().join(",");
-  const users = options.users !== false ? "true" : "false";
-  const baseUrl = options.baseUrl ?? "https://api.github.com";
-  return `github:${baseUrl}:${options.org}:teams=${teams}:users=${users}`;
-};
 var loadGitHubDirectory = async (options) => {
   const teams = await loadGitHubTeams(options);
   const shouldLoadUsers = options.users !== false;
@@ -53,9 +51,11 @@ var loadGitHubDirectory = async (options) => {
   };
 };
 var loadGitHubTeams = async (options) => {
-  const teams = await paginate(options, `/orgs/${encodeURIComponent(options.org)}/teams`);
-  const configuredTeams = options.teams === void 0 || options.teams === true ? void 0 : new Set(options.teams);
-  return teams.filter((team) => !configuredTeams || configuredTeams.has(team.slug)).map((team) => ({
+  const teams = [];
+  for (const teamSlug of options.teams) {
+    teams.push(await loadGitHubTeam(options, teamSlug));
+  }
+  return teams.map((team) => ({
     id: team.slug,
     name: team.name,
     summary: team.description ?? void 0,
@@ -67,6 +67,16 @@ var loadGitHubTeams = async (options) => {
     }
   }));
 };
+var loadGitHubTeam = async (options, teamSlug) => {
+  const response = await githubRequest(
+    options,
+    buildGitHubUrl(
+      options,
+      `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}`
+    )
+  );
+  return response.data;
+};
 var loadGitHubTeamMembers = async (options, teamSlug) => {
   const members = await paginate(
     options,
@@ -127,7 +137,9 @@ var githubRequest = async (options, url) => {
   });
   if (!response.ok) {
     const message = await response.text();
-    throw new Error(`GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`);
+    throw new Error(
+      `GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`
+    );
   }
   return {
     data: await response.json(),
@@ -148,8 +160,323 @@ var getNextPageUrl = (linkHeader) => {
   const match = nextLink?.match(/<([^>]+)>/);
   return match?.[1];
 };
+
+// src/microsoft-entra-directory.ts
+var DEFAULT_GRAPH_BASE_URL = "https://graph.microsoft.com/v1.0";
+var GRAPH_RETRY_ATTEMPTS = 3;
+var GRAPH_SELECT_GROUP = "id,displayName,description,mail";
+var GRAPH_SELECT_USER = "id,displayName,userPrincipalName,mail,jobTitle,accountEnabled";
+var microsoftEntraDirectory = (options) => {
+  validateOptions(options);
+  let cachedData;
+  const load = () => {
+    cachedData = cachedData ?? loadMicrosoftEntraDirectory(options);
+    return cachedData;
+  };
+  return defineDirectorySource({
+    type: "directory",
+    name: `microsoft-entra:${options.tenantId}`,
+    loadTeams: async () => {
+      const data = await load();
+      return data.teams;
+    },
+    loadUsers: async () => {
+      const data = await load();
+      return data.users;
+    }
+  });
+};
+var validateOptions = (options) => {
+  if (!options.tenantId) {
+    throw new Error("Microsoft Entra directory connector requires tenantId.");
+  }
+  if (!options.clientId) {
+    throw new Error("Microsoft Entra directory connector requires clientId.");
+  }
+  if (!options.clientSecret) {
+    throw new Error(
+      "Microsoft Entra directory connector requires clientSecret."
+    );
+  }
+  if (!Array.isArray(options.groups) || options.groups.length === 0) {
+    throw new Error(
+      'Microsoft Entra directory connector requires at least one group. Set groups: [{ id: "00000000-0000-0000-0000-000000000000" }].'
+    );
+  }
+};
+var loadMicrosoftEntraDirectory = async (options) => {
+  const token = await getAccessToken(options);
+  const resolvedGroups = await loadMicrosoftEntraGroups(options, token);
+  const teams = mapMicrosoftEntraTeams(resolvedGroups);
+  const shouldLoadUsers = options.users !== false;
+  if (!shouldLoadUsers) {
+    return { teams, users: [] };
+  }
+  const usersById = /* @__PURE__ */ new Map();
+  const teamsWithMembers = [];
+  for (const team of teams) {
+    const members = await loadMicrosoftEntraGroupMembers(
+      options,
+      token,
+      String(team.source?.id ?? team.id)
+    );
+    for (const member of members) {
+      usersById.set(member.id, member);
+    }
+    teamsWithMembers.push({
+      ...team,
+      members: members.map((member) => member.id)
+    });
+  }
+  return {
+    teams: teamsWithMembers,
+    users: Array.from(usersById.values())
+  };
+};
+var loadMicrosoftEntraGroups = async (options, token) => {
+  const resolvedGroups = [];
+  for (const groupInput of options.groups) {
+    resolvedGroups.push(
+      await resolveMicrosoftEntraGroup(options, token, groupInput)
+    );
+  }
+  assertUniqueTeamIds(resolvedGroups);
+  return resolvedGroups;
+};
+var resolveMicrosoftEntraGroup = async (options, token, groupInput) => {
+  if (typeof groupInput === "string") {
+    return {
+      group: await loadMicrosoftEntraGroupById(options, token, groupInput)
+    };
+  }
+  if ("id" in groupInput) {
+    return {
+      group: await loadMicrosoftEntraGroupById(options, token, groupInput.id),
+      alias: groupInput.alias
+    };
+  }
+  return {
+    group: await loadMicrosoftEntraGroupByDisplayName(
+      options,
+      token,
+      groupInput.displayName
+    ),
+    alias: groupInput.alias
+  };
+};
+var loadMicrosoftEntraGroupById = async (options, token, groupId) => {
+  return microsoftGraphRequest(
+    options,
+    token,
+    buildMicrosoftGraphUrl(options, `/groups/${encodeURIComponent(groupId)}`, {
+      $select: GRAPH_SELECT_GROUP
+    })
+  );
+};
+var loadMicrosoftEntraGroupByDisplayName = async (options, token, displayName) => {
+  const groups = await paginate2(
+    options,
+    token,
+    buildMicrosoftGraphUrl(options, "/groups", {
+      $filter: `displayName eq '${escapeODataString(displayName)}'`,
+      $select: GRAPH_SELECT_GROUP
+    })
+  );
+  if (groups.length === 0) {
+    throw new Error(
+      `Microsoft Entra directory connector could not find a group with displayName "${displayName}". Use the group id instead.`
+    );
+  }
+  if (groups.length > 1) {
+    throw new Error(
+      `Microsoft Entra directory connector found ${groups.length} groups with displayName "${displayName}". Use the group id instead.`
+    );
+  }
+  return groups[0];
+};
+var mapMicrosoftEntraTeams = (groups) => {
+  return groups.map(({ group, alias }) => {
+    const displayName = group.displayName ?? group.id;
+    return {
+      id: alias ?? slugify(displayName),
+      name: displayName,
+      summary: group.description ?? void 0,
+      email: group.mail ?? void 0,
+      markdown: createMicrosoftEntraSyncedMarkdown("team"),
+      source: {
+        provider: "microsoft-entra",
+        id: group.id
+      }
+    };
+  });
+};
+var loadMicrosoftEntraGroupMembers = async (options, token, groupId) => {
+  const users = await paginate2(
+    options,
+    token,
+    buildMicrosoftGraphUrl(
+      options,
+      `/groups/${encodeURIComponent(groupId)}/members/microsoft.graph.user`,
+      {
+        $select: GRAPH_SELECT_USER
+      }
+    )
+  );
+  return users.filter(
+    (user) => options.includeDisabledUsers || user.accountEnabled !== false
+  ).map(mapMicrosoftEntraUser);
+};
+var mapMicrosoftEntraUser = (user) => {
+  const userPrincipalName = user.userPrincipalName ?? void 0;
+  const email = user.mail ?? userPrincipalName;
+  const id = getMicrosoftEntraUserId(user);
+  const name = user.displayName ?? userPrincipalName ?? user.id;
+  return {
+    id,
+    name,
+    email,
+    role: user.jobTitle ?? void 0,
+    markdown: createMicrosoftEntraSyncedMarkdown("user"),
+    source: {
+      provider: "microsoft-entra",
+      id: user.id
+    }
+  };
+};
+var getMicrosoftEntraUserId = (user) => {
+  if (user.mail) return user.mail.toLowerCase();
+  if (user.userPrincipalName)
+    return normalizeMicrosoftEntraUserPrincipalName(user.userPrincipalName);
+  return user.id;
+};
+var normalizeMicrosoftEntraUserPrincipalName = (userPrincipalName) => {
+  const guestUserMatch = userPrincipalName.match(/^(.+)#EXT#@.+$/i);
+  if (!guestUserMatch) return userPrincipalName.toLowerCase();
+  const externalUserName = guestUserMatch[1];
+  const lastUnderscoreIndex = externalUserName.lastIndexOf("_");
+  if (lastUnderscoreIndex === -1) return externalUserName.toLowerCase();
+  return `${externalUserName.slice(0, lastUnderscoreIndex)}@${externalUserName.slice(lastUnderscoreIndex + 1)}`.toLowerCase();
+};
+var createMicrosoftEntraSyncedMarkdown = (type) => {
+  if (type === "team") {
+    return [
+      ":::note",
+      "This team is synced from Microsoft Entra ID and is read-only in EventCatalog.",
+      "",
+      "Manage the team and its members in Microsoft Entra ID.",
+      ":::"
+    ].join("\n");
+  }
+  return [
+    ":::note",
+    "This user is synced from Microsoft Entra ID and is read-only in EventCatalog.",
+    "",
+    "Manage profile details and team membership in Microsoft Entra ID.",
+    ":::"
+  ].join("\n");
+};
+var getAccessToken = async (options) => {
+  const tokenUrl = options.tokenUrl ?? `https://login.microsoftonline.com/${encodeURIComponent(options.tenantId)}/oauth2/v2.0/token`;
+  const body = new URLSearchParams({
+    client_id: options.clientId,
+    client_secret: options.clientSecret,
+    grant_type: "client_credentials",
+    scope: getMicrosoftGraphScope(options)
+  });
+  const response = await fetch(tokenUrl, {
+    method: "POST",
+    headers: {
+      "content-type": "application/x-www-form-urlencoded",
+      "user-agent": "@eventcatalog/connectors"
+    },
+    body
+  });
+  if (!response.ok) {
+    const message = await response.text();
+    throw new Error(
+      `Microsoft Entra directory connector failed to get an access token (${response.status} ${response.statusText}): ${message}`
+    );
+  }
+  const data = await response.json();
+  if (!data.access_token) {
+    throw new Error(
+      "Microsoft Entra directory connector failed to get an access token: response did not include access_token."
+    );
+  }
+  return data.access_token;
+};
+var getMicrosoftGraphScope = (options) => {
+  const graphBaseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;
+  return `${new URL(graphBaseUrl).origin}/.default`;
+};
+var microsoftGraphRequest = async (options, token, url, attempt = 0) => {
+  const response = await fetch(url, {
+    headers: {
+      accept: "application/json",
+      authorization: `Bearer ${token}`,
+      ConsistencyLevel: "eventual",
+      "user-agent": "@eventcatalog/connectors"
+    }
+  });
+  if (response.status === 429 && attempt < GRAPH_RETRY_ATTEMPTS) {
+    await waitForRetry(response.headers.get("retry-after"));
+    return microsoftGraphRequest(options, token, url, attempt + 1);
+  }
+  if (!response.ok) {
+    const message = await response.text();
+    throw new Error(
+      `Microsoft Entra directory connector failed (${response.status} ${response.statusText}): ${message}`
+    );
+  }
+  return await response.json();
+};
+var paginate2 = async (options, token, url) => {
+  const results = [];
+  let nextUrl = url;
+  while (nextUrl) {
+    const response = await microsoftGraphRequest(options, token, nextUrl);
+    results.push(...response.value ?? []);
+    nextUrl = response["@odata.nextLink"];
+  }
+  return results;
+};
+var buildMicrosoftGraphUrl = (options, pathname, query) => {
+  const baseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;
+  const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+  const normalizedPathname = pathname.replace(/^\//u, "");
+  const url = new URL(normalizedPathname, normalizedBaseUrl);
+  for (const [key, value] of Object.entries(query ?? {})) {
+    url.searchParams.set(key, value);
+  }
+  return url.toString();
+};
+var assertUniqueTeamIds = (groups) => {
+  const teamIds = /* @__PURE__ */ new Map();
+  for (const { group, alias } of groups) {
+    const displayName = group.displayName ?? group.id;
+    const teamId = alias ?? slugify(displayName);
+    const existingGroupId = teamIds.get(teamId);
+    if (existingGroupId) {
+      throw new Error(
+        `Microsoft Entra directory connector resolved duplicate team id "${teamId}" from groups "${existingGroupId}" and "${group.id}". Set alias for one of the groups.`
+      );
+    }
+    teamIds.set(teamId, group.id);
+  }
+};
+var slugify = (value) => {
+  const slug = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return slug || value;
+};
+var escapeODataString = (value) => value.replace(/'/g, "''");
+var waitForRetry = async (retryAfter) => {
+  const retryAfterSeconds = retryAfter ? Number(retryAfter) : 1;
+  const delayMs = Number.isFinite(retryAfterSeconds) ? Math.max(retryAfterSeconds, 0) * 1e3 : 1e3;
+  await new Promise((resolve) => setTimeout(resolve, delayMs));
+};
 export {
   defineDirectorySource,
-  githubDirectory
+  githubDirectory,
+  microsoftEntraDirectory
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/github-directory.ts"],"sourcesContent":["/**\n * Describes where a generated directory entry came from.\n *\n * EventCatalog uses the provider to show source badges and to treat generated\n * resources as externally managed.\n */\nexport type DirectoryEntrySource = {\n  /** Provider identifier, for example `github`, `okta`, or `ldap`. */\n  provider: string;\n  /** Optional provider-specific identifier for the external resource. */\n  id?: string;\n  /** Optional URL back to the resource in the external provider. */\n  url?: string;\n  [key: string]: unknown;\n};\n\n/**\n * User returned by a directory source.\n *\n * Directory users are synced as read-only EventCatalog users and can be\n * referenced by teams through their `id`.\n */\nexport type DirectoryUser = {\n  id: string;\n  name: string;\n  avatarUrl: string;\n  role?: string;\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Team returned by a directory source.\n *\n * Directory teams are synced as read-only EventCatalog teams.\n */\nexport type DirectoryTeam = {\n  id: string;\n  name: string;\n  summary?: string;\n  /** User IDs for members of this team. */\n  members?: string[];\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Loads users and/or teams from an external directory provider.\n *\n * EventCatalog calls these loaders during content sync, writes the returned\n * entries into Astro collections, and mirrors them into the generated\n * `.eventcatalog/store/directory.json` file for SDK/editor reads.\n */\nexport type DirectorySource = {\n  type: 'directory';\n  /** Stable source identifier, usually `<provider>:<account-or-org>`. */\n  name: string;\n  /** Optional stable cache key for this source configuration. */\n  cacheKey?: string;\n  /** Load users from the external directory. */\n  loadUsers?: () => Promise<DirectoryUser[]>;\n  /** Load teams from the external directory. */\n  loadTeams?: () => Promise<DirectoryTeam[]>;\n};\n\n/**\n * Defines a custom directory source with type inference for connector authors.\n */\nexport const defineDirectorySource = <TSource extends DirectorySource>(source: TSource) => source;\n","import { defineDirectorySource, type DirectorySource, type DirectoryTeam, type DirectoryUser } from './types';\n\ntype GitHubDirectoryOptions = {\n  org: string;\n  token?: string;\n  teams?: true | string[];\n  users?: boolean;\n  baseUrl?: string;\n};\n\ntype GitHubTeam = {\n  id: number;\n  name: string;\n  slug: string;\n  description: string | null;\n  html_url: string;\n};\n\ntype GitHubUser = {\n  id: number;\n  login: string;\n  avatar_url: string;\n  html_url: string;\n};\n\ntype GitHubDirectoryData = {\n  teams: DirectoryTeam[];\n  users: DirectoryUser[];\n};\n\nconst GITHUB_API_VERSION = '2022-11-28';\n\nexport const githubDirectory = (options: GitHubDirectoryOptions): DirectorySource => {\n  let cachedData: Promise<GitHubDirectoryData> | undefined;\n\n  const load = () => {\n    cachedData = cachedData ?? loadGitHubDirectory(options);\n    return cachedData;\n  };\n\n  return defineDirectorySource({\n    type: 'directory',\n    name: `github:${options.org}`,\n    cacheKey: createGitHubDirectoryCacheKey(options),\n    loadTeams: async () => {\n      const data = await load();\n      return data.teams;\n    },\n    loadUsers: async () => {\n      const data = await load();\n      return data.users;\n    },\n  });\n};\n\nconst createGitHubDirectoryCacheKey = (options: GitHubDirectoryOptions) => {\n  const teams = options.teams === true || options.teams === undefined ? 'all' : [...options.teams].sort().join(',');\n  const users = options.users !== false ? 'true' : 'false';\n  const baseUrl = options.baseUrl ?? 'https://api.github.com';\n\n  return `github:${baseUrl}:${options.org}:teams=${teams}:users=${users}`;\n};\n\nconst loadGitHubDirectory = async (options: GitHubDirectoryOptions): Promise<GitHubDirectoryData> => {\n  const teams = await loadGitHubTeams(options);\n  const shouldLoadUsers = options.users !== false;\n\n  if (!shouldLoadUsers) {\n    return { teams, users: [] };\n  }\n\n  const usersById = new Map<string, DirectoryUser>();\n  const teamsWithMembers: DirectoryTeam[] = [];\n\n  for (const team of teams) {\n    const members = await loadGitHubTeamMembers(options, team.id);\n\n    for (const member of members) {\n      usersById.set(member.id, member);\n    }\n\n    teamsWithMembers.push({\n      ...team,\n      members: members.map((member) => member.id),\n    });\n  }\n\n  return {\n    teams: teamsWithMembers,\n    users: Array.from(usersById.values()),\n  };\n};\n\nconst loadGitHubTeams = async (options: GitHubDirectoryOptions): Promise<DirectoryTeam[]> => {\n  const teams = await paginate<GitHubTeam>(options, `/orgs/${encodeURIComponent(options.org)}/teams`);\n  const configuredTeams = options.teams === undefined || options.teams === true ? undefined : new Set(options.teams);\n\n  return teams\n    .filter((team) => !configuredTeams || configuredTeams.has(team.slug))\n    .map((team) => ({\n      id: team.slug,\n      name: team.name,\n      summary: team.description ?? undefined,\n      markdown: createGitHubSyncedMarkdown('team', team.html_url),\n      source: {\n        provider: 'github',\n        id: String(team.id),\n        url: team.html_url,\n      },\n    }));\n};\n\nconst loadGitHubTeamMembers = async (options: GitHubDirectoryOptions, teamSlug: string): Promise<DirectoryUser[]> => {\n  const members = await paginate<GitHubUser>(\n    options,\n    `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}/members`\n  );\n\n  return members.map((member) => ({\n    id: member.login,\n    name: member.login,\n    avatarUrl: member.avatar_url,\n    markdown: createGitHubSyncedMarkdown('user', member.html_url),\n    source: {\n      provider: 'github',\n      id: String(member.id),\n      url: member.html_url,\n    },\n  }));\n};\n\nconst createGitHubSyncedMarkdown = (type: 'team' | 'user', url: string) => {\n  if (type === 'team') {\n    return [\n      ':::note',\n      'This team is synced from GitHub and is read-only in EventCatalog.',\n      '',\n      'Manage the team and its members in GitHub.',\n      '',\n      `[View team on GitHub](${url})`,\n      ':::',\n    ].join('\\n');\n  }\n\n  return [\n    ':::note',\n    'This user is synced from GitHub and is read-only in EventCatalog.',\n    '',\n    'Manage profile details and team membership in GitHub.',\n    '',\n    `[View user on GitHub](${url})`,\n    ':::',\n  ].join('\\n');\n};\n\nconst paginate = async <T>(options: GitHubDirectoryOptions, pathname: string): Promise<T[]> => {\n  const results: T[] = [];\n  let url: string | undefined = buildGitHubUrl(options, pathname);\n\n  while (url) {\n    const response = await githubRequest<T[]>(options, url);\n    results.push(...response.data);\n    url = getNextPageUrl(response.headers.get('link'));\n  }\n\n  return results;\n};\n\nconst githubRequest = async <T>(\n  options: GitHubDirectoryOptions,\n  url: string\n): Promise<{ data: T; headers: Headers }> => {\n  const response = await fetch(url, {\n    headers: {\n      accept: 'application/vnd.github+json',\n      'x-github-api-version': GITHUB_API_VERSION,\n      'user-agent': '@eventcatalog/connectors',\n      ...(options.token ? { authorization: `Bearer ${options.token}` } : {}),\n    },\n  });\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(`GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`);\n  }\n\n  return {\n    data: (await response.json()) as T,\n    headers: response.headers,\n  };\n};\n\nconst buildGitHubUrl = (options: GitHubDirectoryOptions, pathname: string) => {\n  const baseUrl = options.baseUrl ?? 'https://api.github.com';\n  const normalizedBaseUrl = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;\n  const normalizedPathname = pathname.replace(/^\\//u, '');\n  const url = new URL(normalizedPathname, normalizedBaseUrl);\n  url.searchParams.set('per_page', '100');\n  return url.toString();\n};\n\nconst getNextPageUrl = (linkHeader: string | null) => {\n  if (!linkHeader) return undefined;\n\n  const nextLink = linkHeader.split(',').find((link) => link.includes('rel=\"next\"'));\n  const match = nextLink?.match(/<([^>]+)>/);\n\n  return match?.[1];\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/github-directory.ts","../src/microsoft-entra-directory.ts"],"sourcesContent":["/**\n * Describes where a generated directory entry came from.\n *\n * EventCatalog uses the provider to show source badges and to treat generated\n * resources as externally managed.\n */\nexport type DirectoryEntrySource = {\n  /** Provider identifier, for example `github`, `okta`, or `ldap`. */\n  provider: string;\n  /** Optional provider-specific identifier for the external resource. */\n  id?: string;\n  /** Optional URL back to the resource in the external provider. */\n  url?: string;\n  [key: string]: unknown;\n};\n\n/**\n * User returned by a directory source.\n *\n * Directory users are synced as read-only EventCatalog users and can be\n * referenced by teams through their `id`.\n */\nexport type DirectoryUser = {\n  id: string;\n  name: string;\n  avatarUrl?: string;\n  role?: string;\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Team returned by a directory source.\n *\n * Directory teams are synced as read-only EventCatalog teams.\n */\nexport type DirectoryTeam = {\n  id: string;\n  name: string;\n  summary?: string;\n  /** User IDs for members of this team. */\n  members?: string[];\n  email?: string;\n  markdown?: string;\n  source?: DirectoryEntrySource;\n  [key: string]: unknown;\n};\n\n/**\n * Loads users and/or teams from an external directory provider.\n *\n * EventCatalog calls these loaders during content sync, writes the returned\n * entries into Astro collections, and mirrors them into the generated\n * `.eventcatalog/store/directory.json` file for SDK/editor reads.\n */\nexport type DirectorySource = {\n  type: \"directory\";\n  /** Stable source identifier, usually `<provider>:<account-or-org>`. */\n  name: string;\n  /** Load users from the external directory. */\n  loadUsers?: () => Promise<DirectoryUser[]>;\n  /** Load teams from the external directory. */\n  loadTeams?: () => Promise<DirectoryTeam[]>;\n};\n\n/**\n * Defines a custom directory source with type inference for connector authors.\n */\nexport const defineDirectorySource = <TSource extends DirectorySource>(\n  source: TSource,\n) => source;\n","import {\n  defineDirectorySource,\n  type DirectorySource,\n  type DirectoryTeam,\n  type DirectoryUser,\n} from \"./types\";\n\ntype GitHubDirectoryOptions = {\n  org: string;\n  token?: string;\n  teams: string[];\n  users?: boolean;\n  baseUrl?: string;\n};\n\ntype GitHubTeam = {\n  id: number;\n  name: string;\n  slug: string;\n  description: string | null;\n  html_url: string;\n};\n\ntype GitHubUser = {\n  id: number;\n  login: string;\n  avatar_url: string;\n  html_url: string;\n};\n\ntype GitHubDirectoryData = {\n  teams: DirectoryTeam[];\n  users: DirectoryUser[];\n};\n\nconst GITHUB_API_VERSION = \"2022-11-28\";\n\nexport const githubDirectory = (\n  options: GitHubDirectoryOptions,\n): DirectorySource => {\n  if (!Array.isArray(options.teams) || options.teams.length === 0) {\n    throw new Error(\n      'GitHub directory connector requires at least one team slug. Set teams: [\"platform\"].',\n    );\n  }\n\n  let cachedData: Promise<GitHubDirectoryData> | undefined;\n\n  const load = () => {\n    cachedData = cachedData ?? loadGitHubDirectory(options);\n    return cachedData;\n  };\n\n  return defineDirectorySource({\n    type: \"directory\",\n    name: `github:${options.org}`,\n    loadTeams: async () => {\n      const data = await load();\n      return data.teams;\n    },\n    loadUsers: async () => {\n      const data = await load();\n      return data.users;\n    },\n  });\n};\n\nconst loadGitHubDirectory = async (\n  options: GitHubDirectoryOptions,\n): Promise<GitHubDirectoryData> => {\n  const teams = await loadGitHubTeams(options);\n  const shouldLoadUsers = options.users !== false;\n\n  if (!shouldLoadUsers) {\n    return { teams, users: [] };\n  }\n\n  const usersById = new Map<string, DirectoryUser>();\n  const teamsWithMembers: DirectoryTeam[] = [];\n\n  for (const team of teams) {\n    const members = await loadGitHubTeamMembers(options, team.id);\n\n    for (const member of members) {\n      usersById.set(member.id, member);\n    }\n\n    teamsWithMembers.push({\n      ...team,\n      members: members.map((member) => member.id),\n    });\n  }\n\n  return {\n    teams: teamsWithMembers,\n    users: Array.from(usersById.values()),\n  };\n};\n\nconst loadGitHubTeams = async (\n  options: GitHubDirectoryOptions,\n): Promise<DirectoryTeam[]> => {\n  const teams: GitHubTeam[] = [];\n\n  for (const teamSlug of options.teams) {\n    teams.push(await loadGitHubTeam(options, teamSlug));\n  }\n\n  return teams.map((team) => ({\n    id: team.slug,\n    name: team.name,\n    summary: team.description ?? undefined,\n    markdown: createGitHubSyncedMarkdown(\"team\", team.html_url),\n    source: {\n      provider: \"github\",\n      id: String(team.id),\n      url: team.html_url,\n    },\n  }));\n};\n\nconst loadGitHubTeam = async (\n  options: GitHubDirectoryOptions,\n  teamSlug: string,\n) => {\n  const response = await githubRequest<GitHubTeam>(\n    options,\n    buildGitHubUrl(\n      options,\n      `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}`,\n    ),\n  );\n\n  return response.data;\n};\n\nconst loadGitHubTeamMembers = async (\n  options: GitHubDirectoryOptions,\n  teamSlug: string,\n): Promise<DirectoryUser[]> => {\n  const members = await paginate<GitHubUser>(\n    options,\n    `/orgs/${encodeURIComponent(options.org)}/teams/${encodeURIComponent(teamSlug)}/members`,\n  );\n\n  return members.map((member) => ({\n    id: member.login,\n    name: member.login,\n    avatarUrl: member.avatar_url,\n    markdown: createGitHubSyncedMarkdown(\"user\", member.html_url),\n    source: {\n      provider: \"github\",\n      id: String(member.id),\n      url: member.html_url,\n    },\n  }));\n};\n\nconst createGitHubSyncedMarkdown = (type: \"team\" | \"user\", url: string) => {\n  if (type === \"team\") {\n    return [\n      \":::note\",\n      \"This team is synced from GitHub and is read-only in EventCatalog.\",\n      \"\",\n      \"Manage the team and its members in GitHub.\",\n      \"\",\n      `[View team on GitHub](${url})`,\n      \":::\",\n    ].join(\"\\n\");\n  }\n\n  return [\n    \":::note\",\n    \"This user is synced from GitHub and is read-only in EventCatalog.\",\n    \"\",\n    \"Manage profile details and team membership in GitHub.\",\n    \"\",\n    `[View user on GitHub](${url})`,\n    \":::\",\n  ].join(\"\\n\");\n};\n\nconst paginate = async <T>(\n  options: GitHubDirectoryOptions,\n  pathname: string,\n): Promise<T[]> => {\n  const results: T[] = [];\n  let url: string | undefined = buildGitHubUrl(options, pathname);\n\n  while (url) {\n    const response = await githubRequest<T[]>(options, url);\n    results.push(...response.data);\n    url = getNextPageUrl(response.headers.get(\"link\"));\n  }\n\n  return results;\n};\n\nconst githubRequest = async <T>(\n  options: GitHubDirectoryOptions,\n  url: string,\n): Promise<{ data: T; headers: Headers }> => {\n  const response = await fetch(url, {\n    headers: {\n      accept: \"application/vnd.github+json\",\n      \"x-github-api-version\": GITHUB_API_VERSION,\n      \"user-agent\": \"@eventcatalog/connectors\",\n      ...(options.token ? { authorization: `Bearer ${options.token}` } : {}),\n    },\n  });\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(\n      `GitHub directory connector failed (${response.status} ${response.statusText}): ${message}`,\n    );\n  }\n\n  return {\n    data: (await response.json()) as T,\n    headers: response.headers,\n  };\n};\n\nconst buildGitHubUrl = (options: GitHubDirectoryOptions, pathname: string) => {\n  const baseUrl = options.baseUrl ?? \"https://api.github.com\";\n  const normalizedBaseUrl = baseUrl.endsWith(\"/\") ? baseUrl : `${baseUrl}/`;\n  const normalizedPathname = pathname.replace(/^\\//u, \"\");\n  const url = new URL(normalizedPathname, normalizedBaseUrl);\n  url.searchParams.set(\"per_page\", \"100\");\n  return url.toString();\n};\n\nconst getNextPageUrl = (linkHeader: string | null) => {\n  if (!linkHeader) return undefined;\n\n  const nextLink = linkHeader\n    .split(\",\")\n    .find((link) => link.includes('rel=\"next\"'));\n  const match = nextLink?.match(/<([^>]+)>/);\n\n  return match?.[1];\n};\n","import {\n  defineDirectorySource,\n  type DirectorySource,\n  type DirectoryTeam,\n  type DirectoryUser,\n} from \"./types\";\n\ntype MicrosoftEntraGroupInput =\n  | string\n  | {\n      id: string;\n      alias?: string;\n    }\n  | {\n      displayName: string;\n      alias?: string;\n    };\n\ntype MicrosoftEntraDirectoryOptions = {\n  tenantId: string;\n  clientId: string;\n  clientSecret: string;\n  groups: MicrosoftEntraGroupInput[];\n  users?: boolean;\n  includeDisabledUsers?: boolean;\n  graphBaseUrl?: string;\n  tokenUrl?: string;\n};\n\ntype MicrosoftEntraGroup = {\n  id: string;\n  displayName?: string | null;\n  description?: string | null;\n  mail?: string | null;\n};\n\ntype MicrosoftEntraUser = {\n  id: string;\n  displayName?: string | null;\n  userPrincipalName?: string | null;\n  mail?: string | null;\n  jobTitle?: string | null;\n  accountEnabled?: boolean | null;\n};\n\ntype MicrosoftEntraDirectoryData = {\n  teams: DirectoryTeam[];\n  users: DirectoryUser[];\n};\n\ntype MicrosoftGraphCollection<T> = {\n  value?: T[];\n  \"@odata.nextLink\"?: string;\n};\n\ntype ResolvedGroupInput = {\n  group: MicrosoftEntraGroup;\n  alias?: string;\n};\n\nconst DEFAULT_GRAPH_BASE_URL = \"https://graph.microsoft.com/v1.0\";\nconst GRAPH_RETRY_ATTEMPTS = 3;\nconst GRAPH_SELECT_GROUP = \"id,displayName,description,mail\";\nconst GRAPH_SELECT_USER =\n  \"id,displayName,userPrincipalName,mail,jobTitle,accountEnabled\";\n\nexport const microsoftEntraDirectory = (\n  options: MicrosoftEntraDirectoryOptions,\n): DirectorySource => {\n  validateOptions(options);\n\n  let cachedData: Promise<MicrosoftEntraDirectoryData> | undefined;\n\n  const load = () => {\n    cachedData = cachedData ?? loadMicrosoftEntraDirectory(options);\n    return cachedData;\n  };\n\n  return defineDirectorySource({\n    type: \"directory\",\n    name: `microsoft-entra:${options.tenantId}`,\n    loadTeams: async () => {\n      const data = await load();\n      return data.teams;\n    },\n    loadUsers: async () => {\n      const data = await load();\n      return data.users;\n    },\n  });\n};\n\nconst validateOptions = (options: MicrosoftEntraDirectoryOptions) => {\n  if (!options.tenantId) {\n    throw new Error(\"Microsoft Entra directory connector requires tenantId.\");\n  }\n  if (!options.clientId) {\n    throw new Error(\"Microsoft Entra directory connector requires clientId.\");\n  }\n  if (!options.clientSecret) {\n    throw new Error(\n      \"Microsoft Entra directory connector requires clientSecret.\",\n    );\n  }\n  if (!Array.isArray(options.groups) || options.groups.length === 0) {\n    throw new Error(\n      'Microsoft Entra directory connector requires at least one group. Set groups: [{ id: \"00000000-0000-0000-0000-000000000000\" }].',\n    );\n  }\n};\n\nconst loadMicrosoftEntraDirectory = async (\n  options: MicrosoftEntraDirectoryOptions,\n): Promise<MicrosoftEntraDirectoryData> => {\n  const token = await getAccessToken(options);\n  const resolvedGroups = await loadMicrosoftEntraGroups(options, token);\n  const teams = mapMicrosoftEntraTeams(resolvedGroups);\n  const shouldLoadUsers = options.users !== false;\n\n  if (!shouldLoadUsers) {\n    return { teams, users: [] };\n  }\n\n  const usersById = new Map<string, DirectoryUser>();\n  const teamsWithMembers: DirectoryTeam[] = [];\n\n  for (const team of teams) {\n    const members = await loadMicrosoftEntraGroupMembers(\n      options,\n      token,\n      String(team.source?.id ?? team.id),\n    );\n\n    for (const member of members) {\n      usersById.set(member.id, member);\n    }\n\n    teamsWithMembers.push({\n      ...team,\n      members: members.map((member) => member.id),\n    });\n  }\n\n  return {\n    teams: teamsWithMembers,\n    users: Array.from(usersById.values()),\n  };\n};\n\nconst loadMicrosoftEntraGroups = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n): Promise<ResolvedGroupInput[]> => {\n  const resolvedGroups: ResolvedGroupInput[] = [];\n\n  for (const groupInput of options.groups) {\n    resolvedGroups.push(\n      await resolveMicrosoftEntraGroup(options, token, groupInput),\n    );\n  }\n\n  assertUniqueTeamIds(resolvedGroups);\n\n  return resolvedGroups;\n};\n\nconst resolveMicrosoftEntraGroup = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  groupInput: MicrosoftEntraGroupInput,\n): Promise<ResolvedGroupInput> => {\n  if (typeof groupInput === \"string\") {\n    return {\n      group: await loadMicrosoftEntraGroupById(options, token, groupInput),\n    };\n  }\n\n  if (\"id\" in groupInput) {\n    return {\n      group: await loadMicrosoftEntraGroupById(options, token, groupInput.id),\n      alias: groupInput.alias,\n    };\n  }\n\n  return {\n    group: await loadMicrosoftEntraGroupByDisplayName(\n      options,\n      token,\n      groupInput.displayName,\n    ),\n    alias: groupInput.alias,\n  };\n};\n\nconst loadMicrosoftEntraGroupById = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  groupId: string,\n) => {\n  return microsoftGraphRequest<MicrosoftEntraGroup>(\n    options,\n    token,\n    buildMicrosoftGraphUrl(options, `/groups/${encodeURIComponent(groupId)}`, {\n      $select: GRAPH_SELECT_GROUP,\n    }),\n  );\n};\n\nconst loadMicrosoftEntraGroupByDisplayName = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  displayName: string,\n) => {\n  const groups = await paginate<MicrosoftEntraGroup>(\n    options,\n    token,\n    buildMicrosoftGraphUrl(options, \"/groups\", {\n      $filter: `displayName eq '${escapeODataString(displayName)}'`,\n      $select: GRAPH_SELECT_GROUP,\n    }),\n  );\n\n  if (groups.length === 0) {\n    throw new Error(\n      `Microsoft Entra directory connector could not find a group with displayName \"${displayName}\". Use the group id instead.`,\n    );\n  }\n\n  if (groups.length > 1) {\n    throw new Error(\n      `Microsoft Entra directory connector found ${groups.length} groups with displayName \"${displayName}\". Use the group id instead.`,\n    );\n  }\n\n  return groups[0];\n};\n\nconst mapMicrosoftEntraTeams = (groups: ResolvedGroupInput[]) => {\n  return groups.map(({ group, alias }) => {\n    const displayName = group.displayName ?? group.id;\n\n    return {\n      id: alias ?? slugify(displayName),\n      name: displayName,\n      summary: group.description ?? undefined,\n      email: group.mail ?? undefined,\n      markdown: createMicrosoftEntraSyncedMarkdown(\"team\"),\n      source: {\n        provider: \"microsoft-entra\",\n        id: group.id,\n      },\n    };\n  });\n};\n\nconst loadMicrosoftEntraGroupMembers = async (\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  groupId: string,\n): Promise<DirectoryUser[]> => {\n  const users = await paginate<MicrosoftEntraUser>(\n    options,\n    token,\n    buildMicrosoftGraphUrl(\n      options,\n      `/groups/${encodeURIComponent(groupId)}/members/microsoft.graph.user`,\n      {\n        $select: GRAPH_SELECT_USER,\n      },\n    ),\n  );\n\n  return users\n    .filter(\n      (user) => options.includeDisabledUsers || user.accountEnabled !== false,\n    )\n    .map(mapMicrosoftEntraUser);\n};\n\nconst mapMicrosoftEntraUser = (user: MicrosoftEntraUser): DirectoryUser => {\n  const userPrincipalName = user.userPrincipalName ?? undefined;\n  const email = user.mail ?? userPrincipalName;\n  const id = getMicrosoftEntraUserId(user);\n  const name = user.displayName ?? userPrincipalName ?? user.id;\n\n  return {\n    id,\n    name,\n    email,\n    role: user.jobTitle ?? undefined,\n    markdown: createMicrosoftEntraSyncedMarkdown(\"user\"),\n    source: {\n      provider: \"microsoft-entra\",\n      id: user.id,\n    },\n  };\n};\n\nconst getMicrosoftEntraUserId = (user: MicrosoftEntraUser) => {\n  if (user.mail) return user.mail.toLowerCase();\n  if (user.userPrincipalName)\n    return normalizeMicrosoftEntraUserPrincipalName(user.userPrincipalName);\n  return user.id;\n};\n\nconst normalizeMicrosoftEntraUserPrincipalName = (\n  userPrincipalName: string,\n) => {\n  const guestUserMatch = userPrincipalName.match(/^(.+)#EXT#@.+$/i);\n\n  if (!guestUserMatch) return userPrincipalName.toLowerCase();\n\n  const externalUserName = guestUserMatch[1];\n  const lastUnderscoreIndex = externalUserName.lastIndexOf(\"_\");\n\n  if (lastUnderscoreIndex === -1) return externalUserName.toLowerCase();\n\n  return `${externalUserName.slice(0, lastUnderscoreIndex)}@${externalUserName.slice(lastUnderscoreIndex + 1)}`.toLowerCase();\n};\n\nconst createMicrosoftEntraSyncedMarkdown = (type: \"team\" | \"user\") => {\n  if (type === \"team\") {\n    return [\n      \":::note\",\n      \"This team is synced from Microsoft Entra ID and is read-only in EventCatalog.\",\n      \"\",\n      \"Manage the team and its members in Microsoft Entra ID.\",\n      \":::\",\n    ].join(\"\\n\");\n  }\n\n  return [\n    \":::note\",\n    \"This user is synced from Microsoft Entra ID and is read-only in EventCatalog.\",\n    \"\",\n    \"Manage profile details and team membership in Microsoft Entra ID.\",\n    \":::\",\n  ].join(\"\\n\");\n};\n\nconst getAccessToken = async (options: MicrosoftEntraDirectoryOptions) => {\n  const tokenUrl =\n    options.tokenUrl ??\n    `https://login.microsoftonline.com/${encodeURIComponent(options.tenantId)}/oauth2/v2.0/token`;\n  const body = new URLSearchParams({\n    client_id: options.clientId,\n    client_secret: options.clientSecret,\n    grant_type: \"client_credentials\",\n    scope: getMicrosoftGraphScope(options),\n  });\n\n  const response = await fetch(tokenUrl, {\n    method: \"POST\",\n    headers: {\n      \"content-type\": \"application/x-www-form-urlencoded\",\n      \"user-agent\": \"@eventcatalog/connectors\",\n    },\n    body,\n  });\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(\n      `Microsoft Entra directory connector failed to get an access token (${response.status} ${response.statusText}): ${message}`,\n    );\n  }\n\n  const data = (await response.json()) as { access_token?: string };\n  if (!data.access_token) {\n    throw new Error(\n      \"Microsoft Entra directory connector failed to get an access token: response did not include access_token.\",\n    );\n  }\n\n  return data.access_token;\n};\n\nconst getMicrosoftGraphScope = (options: MicrosoftEntraDirectoryOptions) => {\n  const graphBaseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;\n  return `${new URL(graphBaseUrl).origin}/.default`;\n};\n\nconst microsoftGraphRequest = async <T>(\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  url: string,\n  attempt = 0,\n): Promise<T> => {\n  const response = await fetch(url, {\n    headers: {\n      accept: \"application/json\",\n      authorization: `Bearer ${token}`,\n      ConsistencyLevel: \"eventual\",\n      \"user-agent\": \"@eventcatalog/connectors\",\n    },\n  });\n\n  if (response.status === 429 && attempt < GRAPH_RETRY_ATTEMPTS) {\n    await waitForRetry(response.headers.get(\"retry-after\"));\n    return microsoftGraphRequest(options, token, url, attempt + 1);\n  }\n\n  if (!response.ok) {\n    const message = await response.text();\n    throw new Error(\n      `Microsoft Entra directory connector failed (${response.status} ${response.statusText}): ${message}`,\n    );\n  }\n\n  return (await response.json()) as T;\n};\n\nconst paginate = async <T>(\n  options: MicrosoftEntraDirectoryOptions,\n  token: string,\n  url: string,\n): Promise<T[]> => {\n  const results: T[] = [];\n  let nextUrl: string | undefined = url;\n\n  while (nextUrl) {\n    const response: MicrosoftGraphCollection<T> = await microsoftGraphRequest<\n      MicrosoftGraphCollection<T>\n    >(options, token, nextUrl);\n    results.push(...(response.value ?? []));\n    nextUrl = response[\"@odata.nextLink\"];\n  }\n\n  return results;\n};\n\nconst buildMicrosoftGraphUrl = (\n  options: MicrosoftEntraDirectoryOptions,\n  pathname: string,\n  query?: Record<string, string>,\n) => {\n  const baseUrl = options.graphBaseUrl ?? DEFAULT_GRAPH_BASE_URL;\n  const normalizedBaseUrl = baseUrl.endsWith(\"/\") ? baseUrl : `${baseUrl}/`;\n  const normalizedPathname = pathname.replace(/^\\//u, \"\");\n  const url = new URL(normalizedPathname, normalizedBaseUrl);\n\n  for (const [key, value] of Object.entries(query ?? {})) {\n    url.searchParams.set(key, value);\n  }\n\n  return url.toString();\n};\n\nconst assertUniqueTeamIds = (groups: ResolvedGroupInput[]) => {\n  const teamIds = new Map<string, string>();\n\n  for (const { group, alias } of groups) {\n    const displayName = group.displayName ?? group.id;\n    const teamId = alias ?? slugify(displayName);\n    const existingGroupId = teamIds.get(teamId);\n\n    if (existingGroupId) {\n      throw new Error(\n        `Microsoft Entra directory connector resolved duplicate team id \"${teamId}\" from groups \"${existingGroupId}\" and \"${group.id}\". Set alias for one of the groups.`,\n      );\n    }\n\n    teamIds.set(teamId, group.id);\n  }\n};\n\nconst slugify = (value: string) => {\n  const slug = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n\n  return slug || value;\n};\n\nconst escapeODataString = (value: string) => value.replace(/'/g, \"''\");\n\nconst waitForRetry = async (retryAfter: string | null) => {\n  const retryAfterSeconds = retryAfter ? Number(retryAfter) : 1;\n  const delayMs = Number.isFinite(retryAfterSeconds)\n    ? Math.max(retryAfterSeconds, 0) * 1000\n    : 1000;\n\n  await new Promise((resolve) => setTimeout(resolve, delayMs));\n};\n"],"mappings":"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","names":["paginate"]}

package/package.json

@@ -1,15 +1,7 @@
 {
   "name": "@eventcatalog/connectors",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Connectors for syncing external systems into EventCatalog Collections",
-  "scripts": {
-    "build": "tsup",
-    "build:bin": "tsup",
-    "test": "vitest --run",
-    "test:ci": "vitest --run",
-    "format": "prettier --write .",
-    "format:diff": "prettier --list-different ."
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -45,5 +37,13 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/event-catalog/eventcatalog"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:bin": "tsup",
+    "test": "vitest --run",
+    "test:ci": "vitest --run",
+    "format": "prettier --write .",
+    "format:diff": "prettier --list-different ."
   }
-}
+}