@backstage/plugin-catalog-backend-module-msgraph 0.6.3-next.0 → 0.6.3-next.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @backstage/plugin-catalog-backend-module-msgraph
 
+## 0.6.3-next.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/plugin-catalog-node@1.13.1-next.1
+  - @backstage/backend-plugin-api@1.0.1-next.1
+  - @backstage/catalog-model@1.7.0
+  - @backstage/config@1.2.0
+  - @backstage/plugin-catalog-common@1.1.0
+
 ## 0.6.3-next.0
 
 ### Patch Changes

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-catalog-backend-module-msgraph__alpha",
-  "version": "0.6.3-next.0",
+  "version": "0.6.3-next.1",
   "main": "../dist/alpha.cjs.js",
   "types": "../dist/alpha.d.ts"
 }

package/dist/alpha.cjs.js

@@ -2,85 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var backendPluginApi = require('@backstage/backend-plugin-api');
-var alpha = require('@backstage/plugin-catalog-node/alpha');
-var MicrosoftGraphOrgEntityProvider = require('./cjs/MicrosoftGraphOrgEntityProvider-COL3N3sC.cjs.js');
-require('@backstage/plugin-catalog-node');
-require('@azure/identity');
-require('node-fetch');
-require('qs');
-require('lodash');
-require('@backstage/catalog-model');
-require('p-limit');
-require('uuid');
+var catalogModuleMicrosoftGraphOrgEntityProvider = require('./module/catalogModuleMicrosoftGraphOrgEntityProvider.cjs.js');
 
-const microsoftGraphOrgEntityProviderTransformExtensionPoint = backendPluginApi.createExtensionPoint(
-  {
-    id: "catalog.microsoftGraphOrgEntityProvider.transforms"
-  }
-);
-const catalogModuleMicrosoftGraphOrgEntityProvider = backendPluginApi.createBackendModule(
-  {
-    pluginId: "catalog",
-    moduleId: "microsoftGraphOrgEntityProvider",
-    register(env) {
-      let userTransformer;
-      let groupTransformer;
-      let organizationTransformer;
-      let providerConfigTransformer;
-      env.registerExtensionPoint(
-        microsoftGraphOrgEntityProviderTransformExtensionPoint,
-        {
-          setUserTransformer(transformer) {
-            if (userTransformer) {
-              throw new Error("User transformer may only be set once");
-            }
-            userTransformer = transformer;
-          },
-          setGroupTransformer(transformer) {
-            if (groupTransformer) {
-              throw new Error("Group transformer may only be set once");
-            }
-            groupTransformer = transformer;
-          },
-          setOrganizationTransformer(transformer) {
-            if (organizationTransformer) {
-              throw new Error("Organization transformer may only be set once");
-            }
-            organizationTransformer = transformer;
-          },
-          setProviderConfigTransformer(transformer) {
-            if (providerConfigTransformer) {
-              throw new Error("Provider transformer may only be set once");
-            }
-            providerConfigTransformer = transformer;
-          }
-        }
-      );
-      env.registerInit({
-        deps: {
-          catalog: alpha.catalogProcessingExtensionPoint,
-          config: backendPluginApi.coreServices.rootConfig,
-          logger: backendPluginApi.coreServices.logger,
-          scheduler: backendPluginApi.coreServices.scheduler
-        },
-        async init({ catalog, config, logger, scheduler }) {
-          catalog.addEntityProvider(
-            MicrosoftGraphOrgEntityProvider.MicrosoftGraphOrgEntityProvider.fromConfig(config, {
-              logger,
-              scheduler,
-              userTransformer,
-              groupTransformer,
-              organizationTransformer,
-              providerConfigTransformer
-            })
-          );
-        }
-      });
-    }
-  }
-);
 
-exports.default = catalogModuleMicrosoftGraphOrgEntityProvider;
-exports.microsoftGraphOrgEntityProviderTransformExtensionPoint = microsoftGraphOrgEntityProviderTransformExtensionPoint;
+
+exports.default = catalogModuleMicrosoftGraphOrgEntityProvider.catalogModuleMicrosoftGraphOrgEntityProvider;
+exports.microsoftGraphOrgEntityProviderTransformExtensionPoint = catalogModuleMicrosoftGraphOrgEntityProvider.microsoftGraphOrgEntityProviderTransformExtensionPoint;
 //# sourceMappingURL=alpha.cjs.js.map

package/dist/alpha.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"alpha.cjs.js","sources":["../src/module/catalogModuleMicrosoftGraphOrgEntityProvider.ts"],"sourcesContent":["/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  coreServices,\n  createBackendModule,\n  createExtensionPoint,\n} from '@backstage/backend-plugin-api';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node/alpha';\nimport {\n  GroupTransformer,\n  OrganizationTransformer,\n  ProviderConfigTransformer,\n  UserTransformer,\n} from '@backstage/plugin-catalog-backend-module-msgraph';\nimport { MicrosoftGraphOrgEntityProvider } from '../processors';\n\n/**\n * Interface for {@link microsoftGraphOrgEntityProviderTransformExtensionPoint}.\n *\n * @alpha\n */\nexport interface MicrosoftGraphOrgEntityProviderTransformsExtensionPoint {\n  /**\n   * Set the function that transforms a user entry in msgraph to an entity.\n   * Optionally, you can pass separate transformers per provider ID.\n   */\n  setUserTransformer(\n    transformer: UserTransformer | Record<string, UserTransformer>,\n  ): void;\n\n  /**\n   * Set the function that transforms a group entry in msgraph to an entity.\n   * Optionally, you can pass separate transformers per provider ID.\n   */\n  setGroupTransformer(\n    transformer: GroupTransformer | Record<string, GroupTransformer>,\n  ): void;\n\n  /**\n   * Set the function that transforms an organization entry in msgraph to an entity.\n   * Optionally, you can pass separate transformers per provider ID.\n   */\n  setOrganizationTransformer(\n    transformer:\n      | OrganizationTransformer\n      | Record<string, OrganizationTransformer>,\n  ): void;\n\n  /**\n   * Set the function that transforms provider config dynamically.\n   * Optionally, you can pass separate transformers per provider ID.\n   * Note: adjusting fields that are not used on each scheduled ingestion\n   *       (e.g., id, schedule) will have no effect.\n   */\n  setProviderConfigTransformer(\n    transformer:\n      | ProviderConfigTransformer\n      | Record<string, ProviderConfigTransformer>,\n  ): void;\n}\n\n/**\n * Extension point used to customize the transforms used by the module.\n *\n * @alpha\n */\nexport const microsoftGraphOrgEntityProviderTransformExtensionPoint =\n  createExtensionPoint<MicrosoftGraphOrgEntityProviderTransformsExtensionPoint>(\n    {\n      id: 'catalog.microsoftGraphOrgEntityProvider.transforms',\n    },\n  );\n\n/**\n * Registers the MicrosoftGraphOrgEntityProvider with the catalog processing extension point.\n *\n * @alpha\n */\nexport const catalogModuleMicrosoftGraphOrgEntityProvider = createBackendModule(\n  {\n    pluginId: 'catalog',\n    moduleId: 'microsoftGraphOrgEntityProvider',\n    register(env) {\n      let userTransformer:\n        | UserTransformer\n        | Record<string, UserTransformer>\n        | undefined;\n      let groupTransformer:\n        | GroupTransformer\n        | Record<string, GroupTransformer>\n        | undefined;\n      let organizationTransformer:\n        | OrganizationTransformer\n        | Record<string, OrganizationTransformer>\n        | undefined;\n      let providerConfigTransformer:\n        | ProviderConfigTransformer\n        | Record<string, ProviderConfigTransformer>\n        | undefined;\n\n      env.registerExtensionPoint(\n        microsoftGraphOrgEntityProviderTransformExtensionPoint,\n        {\n          setUserTransformer(transformer) {\n            if (userTransformer) {\n              throw new Error('User transformer may only be set once');\n            }\n            userTransformer = transformer;\n          },\n          setGroupTransformer(transformer) {\n            if (groupTransformer) {\n              throw new Error('Group transformer may only be set once');\n            }\n            groupTransformer = transformer;\n          },\n          setOrganizationTransformer(transformer) {\n            if (organizationTransformer) {\n              throw new Error('Organization transformer may only be set once');\n            }\n            organizationTransformer = transformer;\n          },\n          setProviderConfigTransformer(transformer) {\n            if (providerConfigTransformer) {\n              throw new Error('Provider transformer may only be set once');\n            }\n            providerConfigTransformer = transformer;\n          },\n        },\n      );\n\n      env.registerInit({\n        deps: {\n          catalog: catalogProcessingExtensionPoint,\n          config: coreServices.rootConfig,\n          logger: coreServices.logger,\n          scheduler: coreServices.scheduler,\n        },\n        async init({ catalog, config, logger, scheduler }) {\n          catalog.addEntityProvider(\n            MicrosoftGraphOrgEntityProvider.fromConfig(config, {\n              logger,\n              scheduler,\n              userTransformer: userTransformer,\n              groupTransformer: groupTransformer,\n              organizationTransformer: organizationTransformer,\n              providerConfigTransformer: providerConfigTransformer,\n            }),\n          );\n        },\n      });\n    },\n  },\n);\n"],"names":["createExtensionPoint","createBackendModule","catalogProcessingExtensionPoint","coreServices","MicrosoftGraphOrgEntityProvider"],"mappings":";;;;;;;;;;;;;;;;AAgFO,MAAM,sDACX,GAAAA,qCAAA;AAAA,EACE;AAAA,IACE,EAAI,EAAA,oDAAA;AAAA,GACN;AACF,EAAA;AAOK,MAAM,4CAA+C,GAAAC,oCAAA;AAAA,EAC1D;AAAA,IACE,QAAU,EAAA,SAAA;AAAA,IACV,QAAU,EAAA,iCAAA;AAAA,IACV,SAAS,GAAK,EAAA;AACZ,MAAI,IAAA,eAAA,CAAA;AAIJ,MAAI,IAAA,gBAAA,CAAA;AAIJ,MAAI,IAAA,uBAAA,CAAA;AAIJ,MAAI,IAAA,yBAAA,CAAA;AAKJ,MAAI,GAAA,CAAA,sBAAA;AAAA,QACF,sDAAA;AAAA,QACA;AAAA,UACE,mBAAmB,WAAa,EAAA;AAC9B,YAAA,IAAI,eAAiB,EAAA;AACnB,cAAM,MAAA,IAAI,MAAM,uCAAuC,CAAA,CAAA;AAAA,aACzD;AACA,YAAkB,eAAA,GAAA,WAAA,CAAA;AAAA,WACpB;AAAA,UACA,oBAAoB,WAAa,EAAA;AAC/B,YAAA,IAAI,gBAAkB,EAAA;AACpB,cAAM,MAAA,IAAI,MAAM,wCAAwC,CAAA,CAAA;AAAA,aAC1D;AACA,YAAmB,gBAAA,GAAA,WAAA,CAAA;AAAA,WACrB;AAAA,UACA,2BAA2B,WAAa,EAAA;AACtC,YAAA,IAAI,uBAAyB,EAAA;AAC3B,cAAM,MAAA,IAAI,MAAM,+CAA+C,CAAA,CAAA;AAAA,aACjE;AACA,YAA0B,uBAAA,GAAA,WAAA,CAAA;AAAA,WAC5B;AAAA,UACA,6BAA6B,WAAa,EAAA;AACxC,YAAA,IAAI,yBAA2B,EAAA;AAC7B,cAAM,MAAA,IAAI,MAAM,2CAA2C,CAAA,CAAA;AAAA,aAC7D;AACA,YAA4B,yBAAA,GAAA,WAAA,CAAA;AAAA,WAC9B;AAAA,SACF;AAAA,OACF,CAAA;AAEA,MAAA,GAAA,CAAI,YAAa,CAAA;AAAA,QACf,IAAM,EAAA;AAAA,UACJ,OAAS,EAAAC,qCAAA;AAAA,UACT,QAAQC,6BAAa,CAAA,UAAA;AAAA,UACrB,QAAQA,6BAAa,CAAA,MAAA;AAAA,UACrB,WAAWA,6BAAa,CAAA,SAAA;AAAA,SAC1B;AAAA,QACA,MAAM,IAAK,CAAA,EAAE,SAAS,MAAQ,EAAA,MAAA,EAAQ,WAAa,EAAA;AACjD,UAAQ,OAAA,CAAA,iBAAA;AAAA,YACNC,+DAAA,CAAgC,WAAW,MAAQ,EAAA;AAAA,cACjD,MAAA;AAAA,cACA,SAAA;AAAA,cACA,eAAA;AAAA,cACA,gBAAA;AAAA,cACA,uBAAA;AAAA,cACA,yBAAA;AAAA,aACD,CAAA;AAAA,WACH,CAAA;AAAA,SACF;AAAA,OACD,CAAA,CAAA;AAAA,KACH;AAAA,GACF;AACF;;;;;"}
+{"version":3,"file":"alpha.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/index.cjs.js

@@ -1,105 +1,29 @@
 'use strict';
 
-var MicrosoftGraphOrgEntityProvider = require('./cjs/MicrosoftGraphOrgEntityProvider-COL3N3sC.cjs.js');
-var pluginCatalogNode = require('@backstage/plugin-catalog-node');
-require('@backstage/catalog-model');
-require('lodash');
-require('uuid');
-require('@azure/identity');
-require('node-fetch');
-require('qs');
-require('@backstage/backend-plugin-api');
-require('p-limit');
+var client = require('./microsoftGraph/client.cjs.js');
+var config = require('./microsoftGraph/config.cjs.js');
+var constants = require('./microsoftGraph/constants.cjs.js');
+var helper = require('./microsoftGraph/helper.cjs.js');
+var defaultTransformers = require('./microsoftGraph/defaultTransformers.cjs.js');
+var read = require('./microsoftGraph/read.cjs.js');
+var MicrosoftGraphOrgEntityProvider = require('./processors/MicrosoftGraphOrgEntityProvider.cjs.js');
+var MicrosoftGraphOrgReaderProcessor = require('./processors/MicrosoftGraphOrgReaderProcessor.cjs.js');
 
-class MicrosoftGraphOrgReaderProcessor {
-  providers;
-  logger;
-  userTransformer;
-  groupTransformer;
-  organizationTransformer;
-  static fromConfig(config, options) {
-    const c = config.getOptionalConfig("catalog.processors.microsoftGraphOrg");
-    return new MicrosoftGraphOrgReaderProcessor({
-      ...options,
-      providers: c ? MicrosoftGraphOrgEntityProvider.readMicrosoftGraphConfig(c) : []
-    });
-  }
-  constructor(options) {
-    options.logger.warn(
-      "MicrosoftGraphOrgReaderProcessor is deprecated. Please use MicrosoftGraphOrgEntityProvider instead. More info at https://github.com/backstage/backstage/blob/master/plugins/catalog-backend-module-msgraph/CHANGELOG.md#040-next1"
-    );
-    this.providers = options.providers;
-    this.logger = options.logger;
-    this.userTransformer = options.userTransformer;
-    this.groupTransformer = options.groupTransformer;
-    this.organizationTransformer = options.organizationTransformer;
-  }
-  getProcessorName() {
-    return "MicrosoftGraphOrgReaderProcessor";
-  }
-  async readLocation(location, _optional, emit) {
-    if (location.type !== "microsoft-graph-org") {
-      return false;
-    }
-    const provider = this.providers.find(
-      (p) => location.target.startsWith(p.target)
-    );
-    if (!provider) {
-      throw new Error(
-        `There is no Microsoft Graph Org provider that matches ${location.target}. Please add a configuration entry for it under catalog.processors.microsoftGraphOrg.providers.`
-      );
-    }
-    const startTimestamp = Date.now();
-    this.logger.info("Reading Microsoft Graph users and groups");
-    const client = MicrosoftGraphOrgEntityProvider.MicrosoftGraphClient.create(provider);
-    const { users, groups } = await MicrosoftGraphOrgEntityProvider.readMicrosoftGraphOrg(
-      client,
-      provider.tenantId,
-      {
-        userExpand: provider.userExpand,
-        userFilter: provider.userFilter,
-        userSelect: provider.userSelect,
-        loadUserPhotos: provider.loadUserPhotos,
-        userGroupMemberFilter: provider.userGroupMemberFilter,
-        userGroupMemberSearch: provider.userGroupMemberSearch,
-        groupExpand: provider.groupExpand,
-        groupFilter: provider.groupFilter,
-        groupSearch: provider.groupSearch,
-        groupSelect: provider.groupSelect,
-        queryMode: provider.queryMode,
-        userTransformer: this.userTransformer,
-        groupTransformer: this.groupTransformer,
-        organizationTransformer: this.organizationTransformer,
-        logger: this.logger
-      }
-    );
-    const duration = ((Date.now() - startTimestamp) / 1e3).toFixed(1);
-    this.logger.debug(
-      `Read ${users.length} users and ${groups.length} groups from Microsoft Graph in ${duration} seconds`
-    );
-    for (const group of groups) {
-      emit(pluginCatalogNode.processingResult.entity(location, group));
-    }
-    for (const user of users) {
-      emit(pluginCatalogNode.processingResult.entity(location, user));
-    }
-    return true;
-  }
-}
 
-exports.MICROSOFT_EMAIL_ANNOTATION = MicrosoftGraphOrgEntityProvider.MICROSOFT_EMAIL_ANNOTATION;
-exports.MICROSOFT_GRAPH_GROUP_ID_ANNOTATION = MicrosoftGraphOrgEntityProvider.MICROSOFT_GRAPH_GROUP_ID_ANNOTATION;
-exports.MICROSOFT_GRAPH_TENANT_ID_ANNOTATION = MicrosoftGraphOrgEntityProvider.MICROSOFT_GRAPH_TENANT_ID_ANNOTATION;
-exports.MICROSOFT_GRAPH_USER_ID_ANNOTATION = MicrosoftGraphOrgEntityProvider.MICROSOFT_GRAPH_USER_ID_ANNOTATION;
-exports.MicrosoftGraphClient = MicrosoftGraphOrgEntityProvider.MicrosoftGraphClient;
+
+exports.MicrosoftGraphClient = client.MicrosoftGraphClient;
+exports.readMicrosoftGraphConfig = config.readMicrosoftGraphConfig;
+exports.readProviderConfig = config.readProviderConfig;
+exports.readProviderConfigs = config.readProviderConfigs;
+exports.MICROSOFT_EMAIL_ANNOTATION = constants.MICROSOFT_EMAIL_ANNOTATION;
+exports.MICROSOFT_GRAPH_GROUP_ID_ANNOTATION = constants.MICROSOFT_GRAPH_GROUP_ID_ANNOTATION;
+exports.MICROSOFT_GRAPH_TENANT_ID_ANNOTATION = constants.MICROSOFT_GRAPH_TENANT_ID_ANNOTATION;
+exports.MICROSOFT_GRAPH_USER_ID_ANNOTATION = constants.MICROSOFT_GRAPH_USER_ID_ANNOTATION;
+exports.normalizeEntityName = helper.normalizeEntityName;
+exports.defaultGroupTransformer = defaultTransformers.defaultGroupTransformer;
+exports.defaultOrganizationTransformer = defaultTransformers.defaultOrganizationTransformer;
+exports.defaultUserTransformer = defaultTransformers.defaultUserTransformer;
+exports.readMicrosoftGraphOrg = read.readMicrosoftGraphOrg;
 exports.MicrosoftGraphOrgEntityProvider = MicrosoftGraphOrgEntityProvider.MicrosoftGraphOrgEntityProvider;
-exports.defaultGroupTransformer = MicrosoftGraphOrgEntityProvider.defaultGroupTransformer;
-exports.defaultOrganizationTransformer = MicrosoftGraphOrgEntityProvider.defaultOrganizationTransformer;
-exports.defaultUserTransformer = MicrosoftGraphOrgEntityProvider.defaultUserTransformer;
-exports.normalizeEntityName = MicrosoftGraphOrgEntityProvider.normalizeEntityName;
-exports.readMicrosoftGraphConfig = MicrosoftGraphOrgEntityProvider.readMicrosoftGraphConfig;
-exports.readMicrosoftGraphOrg = MicrosoftGraphOrgEntityProvider.readMicrosoftGraphOrg;
-exports.readProviderConfig = MicrosoftGraphOrgEntityProvider.readProviderConfig;
-exports.readProviderConfigs = MicrosoftGraphOrgEntityProvider.readProviderConfigs;
-exports.MicrosoftGraphOrgReaderProcessor = MicrosoftGraphOrgReaderProcessor;
+exports.MicrosoftGraphOrgReaderProcessor = MicrosoftGraphOrgReaderProcessor.MicrosoftGraphOrgReaderProcessor;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/processors/MicrosoftGraphOrgReaderProcessor.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Config } from '@backstage/config';\nimport {\n  CatalogProcessor,\n  CatalogProcessorEmit,\n  processingResult,\n} from '@backstage/plugin-catalog-node';\nimport { LocationSpec } from '@backstage/plugin-catalog-common';\nimport {\n  GroupTransformer,\n  MicrosoftGraphClient,\n  MicrosoftGraphProviderConfig,\n  OrganizationTransformer,\n  readMicrosoftGraphConfig,\n  readMicrosoftGraphOrg,\n  UserTransformer,\n} from '../microsoftGraph';\nimport { LoggerService } from '@backstage/backend-plugin-api';\n\n/**\n * Extracts teams and users out of the Microsoft Graph API.\n *\n * @public\n * @deprecated Use the MicrosoftGraphOrgEntityProvider instead.\n */\nexport class MicrosoftGraphOrgReaderProcessor implements CatalogProcessor {\n  private readonly providers: MicrosoftGraphProviderConfig[];\n  private readonly logger: LoggerService;\n  private readonly userTransformer?: UserTransformer;\n  private readonly groupTransformer?: GroupTransformer;\n  private readonly organizationTransformer?: OrganizationTransformer;\n\n  static fromConfig(\n    config: Config,\n    options: {\n      logger: LoggerService;\n      userTransformer?: UserTransformer;\n      groupTransformer?: GroupTransformer;\n      organizationTransformer?: OrganizationTransformer;\n    },\n  ) {\n    const c = config.getOptionalConfig('catalog.processors.microsoftGraphOrg');\n    return new MicrosoftGraphOrgReaderProcessor({\n      ...options,\n      providers: c ? readMicrosoftGraphConfig(c) : [],\n    });\n  }\n\n  constructor(options: {\n    providers: MicrosoftGraphProviderConfig[];\n    logger: LoggerService;\n    userTransformer?: UserTransformer;\n    groupTransformer?: GroupTransformer;\n    organizationTransformer?: OrganizationTransformer;\n  }) {\n    options.logger.warn(\n      'MicrosoftGraphOrgReaderProcessor is deprecated. Please use MicrosoftGraphOrgEntityProvider instead. More info at https://github.com/backstage/backstage/blob/master/plugins/catalog-backend-module-msgraph/CHANGELOG.md#040-next1',\n    );\n    this.providers = options.providers;\n    this.logger = options.logger;\n    this.userTransformer = options.userTransformer;\n    this.groupTransformer = options.groupTransformer;\n    this.organizationTransformer = options.organizationTransformer;\n  }\n\n  getProcessorName(): string {\n    return 'MicrosoftGraphOrgReaderProcessor';\n  }\n\n  async readLocation(\n    location: LocationSpec,\n    _optional: boolean,\n    emit: CatalogProcessorEmit,\n  ): Promise<boolean> {\n    if (location.type !== 'microsoft-graph-org') {\n      return false;\n    }\n\n    const provider = this.providers.find(p =>\n      location.target.startsWith(p.target),\n    );\n    if (!provider) {\n      throw new Error(\n        `There is no Microsoft Graph Org provider that matches ${location.target}. Please add a configuration entry for it under catalog.processors.microsoftGraphOrg.providers.`,\n      );\n    }\n\n    // Read out all the raw data\n    const startTimestamp = Date.now();\n    this.logger.info('Reading Microsoft Graph users and groups');\n\n    // We create a client each time as we need one that matches the specific provider\n    const client = MicrosoftGraphClient.create(provider);\n    const { users, groups } = await readMicrosoftGraphOrg(\n      client,\n      provider.tenantId,\n      {\n        userExpand: provider.userExpand,\n        userFilter: provider.userFilter,\n        userSelect: provider.userSelect,\n        loadUserPhotos: provider.loadUserPhotos,\n        userGroupMemberFilter: provider.userGroupMemberFilter,\n        userGroupMemberSearch: provider.userGroupMemberSearch,\n        groupExpand: provider.groupExpand,\n        groupFilter: provider.groupFilter,\n        groupSearch: provider.groupSearch,\n        groupSelect: provider.groupSelect,\n        queryMode: provider.queryMode,\n        userTransformer: this.userTransformer,\n        groupTransformer: this.groupTransformer,\n        organizationTransformer: this.organizationTransformer,\n        logger: this.logger,\n      },\n    );\n\n    const duration = ((Date.now() - startTimestamp) / 1000).toFixed(1);\n    this.logger.debug(\n      `Read ${users.length} users and ${groups.length} groups from Microsoft Graph in ${duration} seconds`,\n    );\n\n    // Done!\n    for (const group of groups) {\n      emit(processingResult.entity(location, group));\n    }\n    for (const user of users) {\n      emit(processingResult.entity(location, user));\n    }\n\n    return true;\n  }\n}\n"],"names":["readMicrosoftGraphConfig","MicrosoftGraphClient","readMicrosoftGraphOrg","processingResult"],"mappings":"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"}
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/microsoftGraph/client.cjs.js

@@ -0,0 +1,290 @@
+'use strict';
+
+var identity = require('@azure/identity');
+var fetch = require('node-fetch');
+var qs = require('qs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fetch__default = /*#__PURE__*/_interopDefaultCompat(fetch);
+var qs__default = /*#__PURE__*/_interopDefaultCompat(qs);
+
+class MicrosoftGraphClient {
+  /**
+   * @param baseUrl - baseUrl of Graph API {@link MicrosoftGraphProviderConfig.target}
+   * @param tokenCredential - instance of `TokenCredential` that is used to acquire token for Graph API calls
+   *
+   */
+  constructor(baseUrl, tokenCredential) {
+    this.baseUrl = baseUrl;
+    this.tokenCredential = tokenCredential;
+  }
+  /**
+   * Factory method that instantiate `msal` client and return
+   * an instance of `MicrosoftGraphClient`
+   *
+   * @public
+   *
+   * @param config - Configuration for Interacting with Graph API
+   */
+  static create(config) {
+    const options = {
+      authorityHost: config.authority,
+      tenantId: config.tenantId
+    };
+    const credential = config.clientId && config.clientSecret ? new identity.ClientSecretCredential(
+      config.tenantId,
+      config.clientId,
+      config.clientSecret,
+      options
+    ) : new identity.DefaultAzureCredential(options);
+    return new MicrosoftGraphClient(config.target, credential);
+  }
+  /**
+   * Get a collection of resource from Graph API and
+   * return an `AsyncIterable` of that resource
+   *
+   * @public
+   * @param path - Resource in Microsoft Graph
+   * @param query - OData Query {@link ODataQuery}
+   * @param queryMode - Mode to use while querying. Some features are only available at "advanced".
+   */
+  async *requestCollection(path, query, queryMode) {
+    const appliedQueryMode = query?.search ? "advanced" : queryMode ?? "basic";
+    if (appliedQueryMode === "advanced" && (query?.filter || query?.select)) {
+      query.count = true;
+    }
+    const headers = appliedQueryMode === "advanced" ? {
+      // Eventual consistency is required for advanced querying capabilities
+      // like "$search" or parts of "$filter".
+      // If a new user/group is not found, it'll eventually be imported on a subsequent read
+      ConsistencyLevel: "eventual"
+    } : {};
+    let response = await this.requestApi(path, query, headers);
+    for (; ; ) {
+      if (response.status !== 200) {
+        await this.handleError(path, response);
+      }
+      const result = await response.json();
+      const elements = result.value;
+      yield* elements;
+      if (!result["@odata.nextLink"]) {
+        return;
+      }
+      response = await this.requestRaw(result["@odata.nextLink"], headers);
+    }
+  }
+  /**
+   * Abstract on top of {@link MicrosoftGraphClient.requestRaw}
+   *
+   * @public
+   * @param path - Resource in Microsoft Graph
+   * @param query - OData Query {@link ODataQuery}
+   * @param headers - optional HTTP headers
+   */
+  async requestApi(path, query, headers) {
+    const queryString = qs__default.default.stringify(
+      {
+        $search: query?.search,
+        $filter: query?.filter,
+        $select: query?.select?.join(","),
+        $expand: query?.expand,
+        $count: query?.count,
+        $top: query?.top
+      },
+      {
+        addQueryPrefix: true,
+        // Microsoft Graph doesn't like an encoded query string
+        encode: false
+      }
+    );
+    return await this.requestRaw(
+      `${this.baseUrl}/${path}${queryString}`,
+      headers
+    );
+  }
+  /**
+   * Makes a HTTP call to Graph API with token
+   *
+   * @param url - HTTP Endpoint of Graph API
+   * @param headers - optional HTTP headers
+   */
+  async requestRaw(url, headers, retryCount = 2) {
+    const urlObj = new URL(url);
+    const token = await this.tokenCredential.getToken(
+      `${urlObj.protocol}//${urlObj.hostname}/.default`
+    );
+    if (!token) {
+      throw new Error("Failed to obtain token from Azure Identity");
+    }
+    try {
+      return await fetch__default.default(url, {
+        headers: {
+          ...headers,
+          Authorization: `Bearer ${token.token}`
+        }
+      });
+    } catch (e) {
+      if (e?.code === "ETIMEDOUT" && retryCount > 0) {
+        return this.requestRaw(url, headers, retryCount - 1);
+      }
+      throw e;
+    }
+  }
+  /**
+   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/profilephoto | profilePhoto}
+   * of `User` from Graph API with size limit
+   *
+   * @param userId - The unique identifier for the `User` resource
+   * @param maxSize - Maximum pixel height of the photo
+   *
+   */
+  async getUserPhotoWithSizeLimit(userId, maxSize) {
+    return await this.getPhotoWithSizeLimit("users", userId, maxSize);
+  }
+  async getUserPhoto(userId, sizeId) {
+    return await this.getPhoto("users", userId, sizeId);
+  }
+  /**
+   * Get a collection of
+   * {@link https://docs.microsoft.com/en-us/graph/api/resources/user | User}
+   * from Graph API and return as `AsyncIterable`
+   *
+   * @public
+   * @param query - OData Query {@link ODataQuery}
+   * @param queryMode - Mode to use while querying. Some features are only available at "advanced".
+   */
+  async *getUsers(query, queryMode) {
+    yield* this.requestCollection(
+      `users`,
+      query,
+      queryMode
+    );
+  }
+  /**
+   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/profilephoto | profilePhoto}
+   * of `Group` from Graph API with size limit
+   *
+   * @param groupId - The unique identifier for the `Group` resource
+   * @param maxSize - Maximum pixel height of the photo
+   *
+   */
+  async getGroupPhotoWithSizeLimit(groupId, maxSize) {
+    return await this.getPhotoWithSizeLimit("groups", groupId, maxSize);
+  }
+  async getGroupPhoto(groupId, sizeId) {
+    return await this.getPhoto("groups", groupId, sizeId);
+  }
+  /**
+   * Get a collection of
+   * {@link https://docs.microsoft.com/en-us/graph/api/resources/group | Group}
+   * from Graph API and return as `AsyncIterable`
+   *
+   * @public
+   * @param query - OData Query {@link ODataQuery}
+   * @param queryMode - Mode to use while querying. Some features are only available at "advanced".
+   */
+  async *getGroups(query, queryMode) {
+    yield* this.requestCollection(
+      `groups`,
+      query,
+      queryMode
+    );
+  }
+  /**
+   * Get a collection of
+   * {@link https://docs.microsoft.com/en-us/graph/api/resources/user | User}
+   * belonging to a `Group` from Graph API and return as `AsyncIterable`
+   * @public
+   * @param groupId - The unique identifier for the `Group` resource
+   *
+   */
+  async *getGroupMembers(groupId, query, queryMode) {
+    yield* this.requestCollection(
+      `groups/${groupId}/members`,
+      query,
+      queryMode
+    );
+  }
+  /**
+   * Get a collection of
+   * {@link https://docs.microsoft.com/en-us/graph/api/resources/user | User}
+   * belonging to a `Group` from Graph API and return as `AsyncIterable`
+   * @public
+   * @param groupId - The unique identifier for the `Group` resource
+   * @param query - OData Query {@link ODataQuery}
+   * @param queryMode - Mode to use while querying. Some features are only available at "advanced".
+   */
+  async *getGroupUserMembers(groupId, query, queryMode) {
+    yield* this.requestCollection(
+      `groups/${groupId}/members/microsoft.graph.user/`,
+      query,
+      queryMode
+    );
+  }
+  /**
+   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/organization | Organization}
+   * from Graph API
+   * @public
+   * @param tenantId - The unique identifier for the `Organization` resource
+   *
+   */
+  async getOrganization(tenantId) {
+    const response = await this.requestApi(`organization/${tenantId}`);
+    if (response.status !== 200) {
+      await this.handleError(`organization/${tenantId}`, response);
+    }
+    return await response.json();
+  }
+  /**
+   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/profilephoto | profilePhoto}
+   * from Graph API
+   *
+   * @param entityName - type of parent resource, either `User` or `Group`
+   * @param id - The unique identifier for the {@link entityName | entityName} resource
+   * @param maxSize - Maximum pixel height of the photo
+   *
+   */
+  async getPhotoWithSizeLimit(entityName, id, maxSize) {
+    const response = await this.requestApi(`${entityName}/${id}/photos`);
+    if (response.status === 404) {
+      return void 0;
+    } else if (response.status !== 200) {
+      await this.handleError(`${entityName} photos`, response);
+    }
+    const result = await response.json();
+    const photos = result.value;
+    let selectedPhoto = void 0;
+    for (const p of photos) {
+      if (!selectedPhoto || p.height >= selectedPhoto.height && p.height <= maxSize) {
+        selectedPhoto = p;
+      }
+    }
+    if (!selectedPhoto) {
+      return void 0;
+    }
+    return await this.getPhoto(entityName, id, selectedPhoto.id);
+  }
+  async getPhoto(entityName, id, sizeId) {
+    const path = sizeId ? `${entityName}/${id}/photos/${sizeId}/$value` : `${entityName}/${id}/photo/$value`;
+    const response = await this.requestApi(path);
+    if (response.status === 404) {
+      return void 0;
+    } else if (response.status !== 200) {
+      await this.handleError("photo", response);
+    }
+    return `data:image/jpeg;base64,${Buffer.from(
+      await response.arrayBuffer()
+    ).toString("base64")}`;
+  }
+  async handleError(path, response) {
+    const result = await response.json();
+    const error = result.error;
+    throw new Error(
+      `Error while reading ${path} from Microsoft Graph: ${error.code} - ${error.message}`
+    );
+  }
+}
+
+exports.MicrosoftGraphClient = MicrosoftGraphClient;
+//# sourceMappingURL=client.cjs.js.map

package/dist/microsoftGraph/client.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs.js","sources":["../../src/microsoftGraph/client.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  TokenCredential,\n  DefaultAzureCredential,\n  ClientSecretCredential,\n} from '@azure/identity';\nimport * as MicrosoftGraph from '@microsoft/microsoft-graph-types';\nimport fetch, { Response } from 'node-fetch';\nimport qs from 'qs';\nimport { MicrosoftGraphProviderConfig } from './config';\n\n/**\n * OData (Open Data Protocol) Query\n *\n * {@link https://docs.microsoft.com/en-us/odata/concepts/queryoptions-overview}\n * {@link https://docs.microsoft.com/en-us/graph/query-parameters}\n * @public\n */\nexport type ODataQuery = {\n  /**\n   * search resources within a collection matching a free-text search expression.\n   */\n  search?: string;\n  /**\n   * filter a collection of resources\n   */\n  filter?: string;\n  /**\n   * specifies the related resources or media streams to be included in line with retrieved resources\n   */\n  expand?: string;\n  /**\n   * request a specific set of properties for each entity or complex type\n   */\n  select?: string[];\n  /**\n   * Retrieves the total count of matching resources.\n   */\n  count?: boolean;\n  /**\n   * Maximum number of records to receive in one batch.\n   */\n  top?: number;\n};\n\n/**\n * Extends the base msgraph types to include the odata type.\n *\n * @public\n */\nexport type GroupMember =\n  | (MicrosoftGraph.Group & { '@odata.type': '#microsoft.graph.group' })\n  | (MicrosoftGraph.User & { '@odata.type': '#microsoft.graph.user' });\n\n/**\n * A HTTP Client that communicates with Microsoft Graph API.\n * Simplify Authentication and API calls to get `User` and `Group` from Microsoft Graph\n *\n * Uses `msal-node` for authentication\n *\n * @public\n */\nexport class MicrosoftGraphClient {\n  /**\n   * Factory method that instantiate `msal` client and return\n   * an instance of `MicrosoftGraphClient`\n   *\n   * @public\n   *\n   * @param config - Configuration for Interacting with Graph API\n   */\n  static create(config: MicrosoftGraphProviderConfig): MicrosoftGraphClient {\n    const options = {\n      authorityHost: config.authority,\n      tenantId: config.tenantId,\n    };\n\n    const credential =\n      config.clientId && config.clientSecret\n        ? new ClientSecretCredential(\n            config.tenantId,\n            config.clientId,\n            config.clientSecret,\n            options,\n          )\n        : new DefaultAzureCredential(options);\n\n    return new MicrosoftGraphClient(config.target, credential);\n  }\n\n  /**\n   * @param baseUrl - baseUrl of Graph API {@link MicrosoftGraphProviderConfig.target}\n   * @param tokenCredential - instance of `TokenCredential` that is used to acquire token for Graph API calls\n   *\n   */\n  constructor(\n    private readonly baseUrl: string,\n    private readonly tokenCredential: TokenCredential,\n  ) {}\n\n  /**\n   * Get a collection of resource from Graph API and\n   * return an `AsyncIterable` of that resource\n   *\n   * @public\n   * @param path - Resource in Microsoft Graph\n   * @param query - OData Query {@link ODataQuery}\n   * @param queryMode - Mode to use while querying. Some features are only available at \"advanced\".\n   */\n  async *requestCollection<T>(\n    path: string,\n    query?: ODataQuery,\n    queryMode?: 'basic' | 'advanced',\n  ): AsyncIterable<T> {\n    // upgrade to advanced query mode transparently when \"search\" is used\n    // to stay backwards compatible.\n    const appliedQueryMode = query?.search ? 'advanced' : queryMode ?? 'basic';\n\n    // not needed for \"search\"\n    // as of https://docs.microsoft.com/en-us/graph/aad-advanced-queries?tabs=http\n    // even though a few other places say the opposite\n    // - https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http#request-headers\n    // - https://docs.microsoft.com/en-us/graph/api/resources/group?view=graph-rest-1.0#properties\n    if (appliedQueryMode === 'advanced' && (query?.filter || query?.select)) {\n      query.count = true;\n    }\n    const headers: Record<string, string> =\n      appliedQueryMode === 'advanced'\n        ? {\n            // Eventual consistency is required for advanced querying capabilities\n            // like \"$search\" or parts of \"$filter\".\n            // If a new user/group is not found, it'll eventually be imported on a subsequent read\n            ConsistencyLevel: 'eventual',\n          }\n        : {};\n\n    let response = await this.requestApi(path, query, headers);\n\n    for (;;) {\n      if (response.status !== 200) {\n        await this.handleError(path, response);\n      }\n\n      const result = await response.json();\n\n      // Graph API return array of collections\n      const elements: T[] = result.value;\n\n      yield* elements;\n\n      // Follow cursor to the next page if one is available\n      if (!result['@odata.nextLink']) {\n        return;\n      }\n\n      response = await this.requestRaw(result['@odata.nextLink'], headers);\n    }\n  }\n\n  /**\n   * Abstract on top of {@link MicrosoftGraphClient.requestRaw}\n   *\n   * @public\n   * @param path - Resource in Microsoft Graph\n   * @param query - OData Query {@link ODataQuery}\n   * @param headers - optional HTTP headers\n   */\n  async requestApi(\n    path: string,\n    query?: ODataQuery,\n    headers?: Record<string, string>,\n  ): Promise<Response> {\n    const queryString = qs.stringify(\n      {\n        $search: query?.search,\n        $filter: query?.filter,\n        $select: query?.select?.join(','),\n        $expand: query?.expand,\n        $count: query?.count,\n        $top: query?.top,\n      },\n      {\n        addQueryPrefix: true,\n        // Microsoft Graph doesn't like an encoded query string\n        encode: false,\n      },\n    );\n\n    return await this.requestRaw(\n      `${this.baseUrl}/${path}${queryString}`,\n      headers,\n    );\n  }\n\n  /**\n   * Makes a HTTP call to Graph API with token\n   *\n   * @param url - HTTP Endpoint of Graph API\n   * @param headers - optional HTTP headers\n   */\n  async requestRaw(\n    url: string,\n    headers?: Record<string, string>,\n    retryCount = 2,\n  ): Promise<Response> {\n    // Make sure that we always have a valid access token (might be cached)\n    const urlObj = new URL(url);\n    const token = await this.tokenCredential.getToken(\n      `${urlObj.protocol}//${urlObj.hostname}/.default`,\n    );\n\n    if (!token) {\n      throw new Error('Failed to obtain token from Azure Identity');\n    }\n\n    try {\n      return await fetch(url, {\n        headers: {\n          ...headers,\n          Authorization: `Bearer ${token.token}`,\n        },\n      });\n    } catch (e: any) {\n      if (e?.code === 'ETIMEDOUT' && retryCount > 0) {\n        return this.requestRaw(url, headers, retryCount - 1);\n      }\n      throw e;\n    }\n  }\n\n  /**\n   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/profilephoto | profilePhoto}\n   * of `User` from Graph API with size limit\n   *\n   * @param userId - The unique identifier for the `User` resource\n   * @param maxSize - Maximum pixel height of the photo\n   *\n   */\n  async getUserPhotoWithSizeLimit(\n    userId: string,\n    maxSize: number,\n  ): Promise<string | undefined> {\n    return await this.getPhotoWithSizeLimit('users', userId, maxSize);\n  }\n\n  async getUserPhoto(\n    userId: string,\n    sizeId?: string,\n  ): Promise<string | undefined> {\n    return await this.getPhoto('users', userId, sizeId);\n  }\n\n  /**\n   * Get a collection of\n   * {@link https://docs.microsoft.com/en-us/graph/api/resources/user | User}\n   * from Graph API and return as `AsyncIterable`\n   *\n   * @public\n   * @param query - OData Query {@link ODataQuery}\n   * @param queryMode - Mode to use while querying. Some features are only available at \"advanced\".\n   */\n  async *getUsers(\n    query?: ODataQuery,\n    queryMode?: 'basic' | 'advanced',\n  ): AsyncIterable<MicrosoftGraph.User> {\n    yield* this.requestCollection<MicrosoftGraph.User>(\n      `users`,\n      query,\n      queryMode,\n    );\n  }\n\n  /**\n   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/profilephoto | profilePhoto}\n   * of `Group` from Graph API with size limit\n   *\n   * @param groupId - The unique identifier for the `Group` resource\n   * @param maxSize - Maximum pixel height of the photo\n   *\n   */\n  async getGroupPhotoWithSizeLimit(\n    groupId: string,\n    maxSize: number,\n  ): Promise<string | undefined> {\n    return await this.getPhotoWithSizeLimit('groups', groupId, maxSize);\n  }\n\n  async getGroupPhoto(\n    groupId: string,\n    sizeId?: string,\n  ): Promise<string | undefined> {\n    return await this.getPhoto('groups', groupId, sizeId);\n  }\n\n  /**\n   * Get a collection of\n   * {@link https://docs.microsoft.com/en-us/graph/api/resources/group | Group}\n   * from Graph API and return as `AsyncIterable`\n   *\n   * @public\n   * @param query - OData Query {@link ODataQuery}\n   * @param queryMode - Mode to use while querying. Some features are only available at \"advanced\".\n   */\n  async *getGroups(\n    query?: ODataQuery,\n    queryMode?: 'basic' | 'advanced',\n  ): AsyncIterable<MicrosoftGraph.Group> {\n    yield* this.requestCollection<MicrosoftGraph.Group>(\n      `groups`,\n      query,\n      queryMode,\n    );\n  }\n\n  /**\n   * Get a collection of\n   * {@link https://docs.microsoft.com/en-us/graph/api/resources/user | User}\n   * belonging to a `Group` from Graph API and return as `AsyncIterable`\n   * @public\n   * @param groupId - The unique identifier for the `Group` resource\n   *\n   */\n  async *getGroupMembers(\n    groupId: string,\n    query?: ODataQuery,\n    queryMode?: 'basic' | 'advanced',\n  ): AsyncIterable<GroupMember> {\n    yield* this.requestCollection<GroupMember>(\n      `groups/${groupId}/members`,\n      query,\n      queryMode,\n    );\n  }\n\n  /**\n   * Get a collection of\n   * {@link https://docs.microsoft.com/en-us/graph/api/resources/user | User}\n   * belonging to a `Group` from Graph API and return as `AsyncIterable`\n   * @public\n   * @param groupId - The unique identifier for the `Group` resource\n   * @param query - OData Query {@link ODataQuery}\n   * @param queryMode - Mode to use while querying. Some features are only available at \"advanced\".\n   */\n  async *getGroupUserMembers(\n    groupId: string,\n    query?: ODataQuery,\n    queryMode?: 'basic' | 'advanced',\n  ): AsyncIterable<MicrosoftGraph.User> {\n    yield* this.requestCollection<MicrosoftGraph.User>(\n      `groups/${groupId}/members/microsoft.graph.user/`,\n      query,\n      queryMode,\n    );\n  }\n\n  /**\n   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/organization | Organization}\n   * from Graph API\n   * @public\n   * @param tenantId - The unique identifier for the `Organization` resource\n   *\n   */\n  async getOrganization(\n    tenantId: string,\n  ): Promise<MicrosoftGraph.Organization> {\n    const response = await this.requestApi(`organization/${tenantId}`);\n\n    if (response.status !== 200) {\n      await this.handleError(`organization/${tenantId}`, response);\n    }\n\n    return await response.json();\n  }\n\n  /**\n   * Get {@link https://docs.microsoft.com/en-us/graph/api/resources/profilephoto | profilePhoto}\n   * from Graph API\n   *\n   * @param entityName - type of parent resource, either `User` or `Group`\n   * @param id - The unique identifier for the {@link entityName | entityName} resource\n   * @param maxSize - Maximum pixel height of the photo\n   *\n   */\n  private async getPhotoWithSizeLimit(\n    entityName: string,\n    id: string,\n    maxSize: number,\n  ): Promise<string | undefined> {\n    const response = await this.requestApi(`${entityName}/${id}/photos`);\n\n    if (response.status === 404) {\n      return undefined;\n    } else if (response.status !== 200) {\n      await this.handleError(`${entityName} photos`, response);\n    }\n\n    const result = await response.json();\n    const photos = result.value as MicrosoftGraph.ProfilePhoto[];\n    let selectedPhoto: MicrosoftGraph.ProfilePhoto | undefined = undefined;\n\n    // Find the biggest picture that is smaller than the max size\n    for (const p of photos) {\n      if (\n        !selectedPhoto ||\n        (p.height! >= selectedPhoto.height! && p.height! <= maxSize)\n      ) {\n        selectedPhoto = p;\n      }\n    }\n\n    if (!selectedPhoto) {\n      return undefined;\n    }\n\n    return await this.getPhoto(entityName, id, selectedPhoto.id!);\n  }\n\n  private async getPhoto(\n    entityName: string,\n    id: string,\n    sizeId?: string,\n  ): Promise<string | undefined> {\n    const path = sizeId\n      ? `${entityName}/${id}/photos/${sizeId}/$value`\n      : `${entityName}/${id}/photo/$value`;\n    const response = await this.requestApi(path);\n\n    if (response.status === 404) {\n      return undefined;\n    } else if (response.status !== 200) {\n      await this.handleError('photo', response);\n    }\n\n    return `data:image/jpeg;base64,${Buffer.from(\n      await response.arrayBuffer(),\n    ).toString('base64')}`;\n  }\n\n  private async handleError(path: string, response: Response): Promise<void> {\n    const result = await response.json();\n    const error = result.error as MicrosoftGraph.PublicError;\n\n    throw new Error(\n      `Error while reading ${path} from Microsoft Graph: ${error.code} - ${error.message}`,\n    );\n  }\n}\n"],"names":["ClientSecretCredential","DefaultAzureCredential","qs","fetch"],"mappings":"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"}