@backstage/plugin-catalog-backend-module-github 0.0.0-nightly-20230907021058 → 0.0.0-nightly-20230909020837

package/CHANGELOG.md

@@ -1,25 +1,45 @@
 # @backstage/plugin-catalog-backend-module-github
 
-## 0.0.0-nightly-20230907021058
+## 0.0.0-nightly-20230909020837
+
+### Minor Changes
+
+- fa7004d9722c: Added a `catalogModuleGithubOrgEntityProvider` for the new backend system
 
 ### Patch Changes
 
+- 71114ac50e02: The export for the new backend system has been moved to be the `default` export.
+
+  For example, if you are currently importing the plugin using the following pattern:
+
+  ```ts
+  import { examplePlugin } from '@backstage/plugin-example-backend';
+
+  backend.add(examplePlugin);
+  ```
+
+  It should be migrated to this:
+
+  ```ts
+  backend.add(import('@backstage/plugin-example-backend'));
+  ```
+
 - 96353bb7cb4a: Properly support custom `userTransformer` returning `undefined` in `GithubMultiOrgEntityProvider`
 - 3c44761b9191: Allow github user and team transforms to return any Entity
 - Updated dependencies
-  - @backstage/plugin-catalog-backend@0.0.0-nightly-20230907021058
-  - @backstage/config@0.0.0-nightly-20230907021058
-  - @backstage/integration@0.0.0-nightly-20230907021058
-  - @backstage/backend-common@0.0.0-nightly-20230907021058
-  - @backstage/backend-tasks@0.0.0-nightly-20230907021058
-  - @backstage/backend-plugin-api@0.0.0-nightly-20230907021058
-  - @backstage/plugin-catalog-node@0.0.0-nightly-20230907021058
-  - @backstage/catalog-client@0.0.0-nightly-20230907021058
-  - @backstage/catalog-model@0.0.0-nightly-20230907021058
-  - @backstage/errors@1.2.1
-  - @backstage/types@1.1.0
-  - @backstage/plugin-catalog-common@0.0.0-nightly-20230907021058
-  - @backstage/plugin-events-node@0.0.0-nightly-20230907021058
+  - @backstage/plugin-catalog-backend@0.0.0-nightly-20230909020837
+  - @backstage/config@0.0.0-nightly-20230909020837
+  - @backstage/catalog-client@0.0.0-nightly-20230909020837
+  - @backstage/catalog-model@0.0.0-nightly-20230909020837
+  - @backstage/errors@0.0.0-nightly-20230909020837
+  - @backstage/integration@0.0.0-nightly-20230909020837
+  - @backstage/plugin-catalog-common@0.0.0-nightly-20230909020837
+  - @backstage/types@0.0.0-nightly-20230909020837
+  - @backstage/backend-common@0.0.0-nightly-20230909020837
+  - @backstage/backend-plugin-api@0.0.0-nightly-20230909020837
+  - @backstage/backend-tasks@0.0.0-nightly-20230909020837
+  - @backstage/plugin-catalog-node@0.0.0-nightly-20230909020837
+  - @backstage/plugin-events-node@0.0.0-nightly-20230909020837
 
 ## 0.3.8-next.2
 

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-catalog-backend-module-github",
-  "version": "0.0.0-nightly-20230907021058",
+  "version": "0.0.0-nightly-20230909020837",
   "main": "../dist/alpha.cjs.js",
   "types": "../dist/alpha.d.ts"
 }

package/config.d.ts

@@ -183,6 +183,69 @@ export interface Config {
               schedule?: TaskScheduleDefinitionConfig;
             };
           };
+
+      /**
+       * Configuration for catalogModuleGithubOrgEntityProvider
+       */
+      githubOrg?:
+        | {
+            /**
+             * A stable id for this provider. Entities from this provider will
+             * be associated with this ID, so you should take care not to change
+             * it over time since that may lead to orphaned entities and/or
+             * conflicts.
+             *
+             * @example "ghe"
+             */
+            id: string;
+
+            /**
+             * The target that this provider should consume.
+             *
+             * @example "https://mycompany.github.com"
+             */
+            githubUrl: string;
+
+            /**
+             * The list of the GitHub orgs to consume. By default will consume all accessible
+             * orgs on the given GitHub instance (support for GitHub App integration only).
+             */
+            orgs?: string[];
+
+            /**
+             * The refresh schedule to use.
+             */
+            schedule: TaskScheduleDefinitionConfig;
+          }
+        | Array<{
+            /**
+             * A stable id for this provider. Entities from this provider will
+             * be associated with this ID, so you should take care not to change
+             * it over time since that may lead to orphaned entities and/or
+             * conflicts.
+             *
+             * @example "ghe"
+             */
+            id: string;
+
+            /**
+             * The target that this provider should consume.
+             *
+             * @example "https://mycompany.github.com"
+             */
+            githubUrl: string;
+
+            /**
+             * The list of the GitHub orgs to consume. By default will consume all accessible
+             * orgs on the given GitHub instance (support for GitHub App integration only).
+             */
+            orgs?: string[];
+
+            /**
+             * The refresh schedule to use.
+             */
+            schedule: TaskScheduleDefinitionConfig;
+          }>;
     };
   };
 }

package/dist/alpha.cjs.js

@@ -6,11 +6,12 @@ var backendPluginApi = require('@backstage/backend-plugin-api');
 var backendCommon = require('@backstage/backend-common');
 var alpha = require('@backstage/plugin-catalog-node/alpha');
 var GithubEntityProvider = require('./cjs/GithubEntityProvider-9bc718e3.cjs.js');
+var backendTasks = require('@backstage/backend-tasks');
+var pluginCatalogBackendModuleGithub = require('@backstage/plugin-catalog-backend-module-github');
 require('@backstage/integration');
 require('@backstage/plugin-catalog-node');
 require('@octokit/graphql');
 require('uuid');
-require('@backstage/backend-tasks');
 require('@backstage/catalog-model');
 require('lodash');
 require('minimatch');
@@ -38,5 +39,75 @@ const catalogModuleGithubEntityProvider = backendPluginApi.createBackendModule({
   }
 });
 
-exports.catalogModuleGithubEntityProvider = catalogModuleGithubEntityProvider;
+const githubOrgEntityProviderTransformsExtensionPoint = backendPluginApi.createExtensionPoint({
+  id: "catalog.githubOrgEntityProvider"
+});
+const catalogModuleGithubOrgEntityProvider = backendPluginApi.createBackendModule({
+  pluginId: "catalog",
+  moduleId: "githubOrgEntityProvider",
+  register(env) {
+    let userTransformer;
+    let teamTransformer;
+    env.registerExtensionPoint(
+      githubOrgEntityProviderTransformsExtensionPoint,
+      {
+        setUserTransformer(transformer) {
+          if (userTransformer) {
+            throw new Error("User transformer may only be set once");
+          }
+          userTransformer = transformer;
+        },
+        setTeamTransformer(transformer) {
+          if (teamTransformer) {
+            throw new Error("Team transformer may only be set once");
+          }
+          teamTransformer = 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 }) {
+        for (const definition of readDefinitionsFromConfig(config)) {
+          catalog.addEntityProvider(
+            pluginCatalogBackendModuleGithub.GithubMultiOrgEntityProvider.fromConfig(config, {
+              id: definition.id,
+              githubUrl: definition.githubUrl,
+              orgs: definition.orgs,
+              schedule: scheduler.createScheduledTaskRunner(
+                definition.schedule
+              ),
+              logger: backendCommon.loggerToWinstonLogger(logger),
+              userTransformer,
+              teamTransformer
+            })
+          );
+        }
+      }
+    });
+  }
+});
+function readDefinitionsFromConfig(rootConfig) {
+  const baseKey = "catalog.providers.githubOrg";
+  const baseConfig = rootConfig.getOptional(baseKey);
+  if (!baseConfig) {
+    return [];
+  }
+  const configs = Array.isArray(baseConfig) ? rootConfig.getConfigArray(baseKey) : [rootConfig.getConfig(baseKey)];
+  return configs.map((c) => ({
+    id: c.getString("id"),
+    githubUrl: c.getString("githubUrl"),
+    orgs: c.getOptionalStringArray("orgs"),
+    schedule: backendTasks.readTaskScheduleDefinitionFromConfig(c.getConfig("schedule"))
+  }));
+}
+
+exports.catalogModuleGithubOrgEntityProvider = catalogModuleGithubOrgEntityProvider;
+exports["default"] = catalogModuleGithubEntityProvider;
+exports.githubOrgEntityProviderTransformsExtensionPoint = githubOrgEntityProviderTransformsExtensionPoint;
 //# sourceMappingURL=alpha.cjs.js.map

package/dist/alpha.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"alpha.cjs.js","sources":["../src/module/catalogModuleGithubEntityProvider.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  createBackendModule,\n  coreServices,\n} from '@backstage/backend-plugin-api';\nimport { loggerToWinstonLogger } from '@backstage/backend-common';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node/alpha';\nimport { GithubEntityProvider } from '../providers/GithubEntityProvider';\n\n/**\n * Registers the `GithubEntityProvider` with the catalog processing extension point.\n *\n * @alpha\n */\nexport const catalogModuleGithubEntityProvider = createBackendModule({\n  pluginId: 'catalog',\n  moduleId: 'githubEntityProvider',\n  register(env) {\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          GithubEntityProvider.fromConfig(config, {\n            logger: loggerToWinstonLogger(logger),\n            scheduler,\n          }),\n        );\n      },\n    });\n  },\n});\n"],"names":["createBackendModule","catalogProcessingExtensionPoint","coreServices","GithubEntityProvider","loggerToWinstonLogger"],"mappings":";;;;;;;;;;;;;;;;;AA6BO,MAAM,oCAAoCA,oCAAoB,CAAA;AAAA,EACnE,QAAU,EAAA,SAAA;AAAA,EACV,QAAU,EAAA,sBAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,OAAS,EAAAC,qCAAA;AAAA,QACT,QAAQC,6BAAa,CAAA,UAAA;AAAA,QACrB,QAAQA,6BAAa,CAAA,MAAA;AAAA,QACrB,WAAWA,6BAAa,CAAA,SAAA;AAAA,OAC1B;AAAA,MACA,MAAM,IAAK,CAAA,EAAE,SAAS,MAAQ,EAAA,MAAA,EAAQ,WAAa,EAAA;AACjD,QAAQ,OAAA,CAAA,iBAAA;AAAA,UACNC,yCAAA,CAAqB,WAAW,MAAQ,EAAA;AAAA,YACtC,MAAA,EAAQC,oCAAsB,MAAM,CAAA;AAAA,YACpC,SAAA;AAAA,WACD,CAAA;AAAA,SACH,CAAA;AAAA,OACF;AAAA,KACD,CAAA,CAAA;AAAA,GACH;AACF,CAAC;;;;"}
+{"version":3,"file":"alpha.cjs.js","sources":["../src/module/catalogModuleGithubEntityProvider.ts","../src/module/catalogModuleGithubOrgEntityProvider.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  createBackendModule,\n  coreServices,\n} from '@backstage/backend-plugin-api';\nimport { loggerToWinstonLogger } from '@backstage/backend-common';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node/alpha';\nimport { GithubEntityProvider } from '../providers/GithubEntityProvider';\n\n/**\n * Registers the `GithubEntityProvider` with the catalog processing extension point.\n *\n * @alpha\n */\nexport const catalogModuleGithubEntityProvider = createBackendModule({\n  pluginId: 'catalog',\n  moduleId: 'githubEntityProvider',\n  register(env) {\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          GithubEntityProvider.fromConfig(config, {\n            logger: loggerToWinstonLogger(logger),\n            scheduler,\n          }),\n        );\n      },\n    });\n  },\n});\n","/*\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 { loggerToWinstonLogger } from '@backstage/backend-common';\nimport {\n  coreServices,\n  createBackendModule,\n  createExtensionPoint,\n} from '@backstage/backend-plugin-api';\nimport {\n  readTaskScheduleDefinitionFromConfig,\n  TaskScheduleDefinition,\n} from '@backstage/backend-tasks';\nimport { Config } from '@backstage/config';\nimport {\n  GithubMultiOrgEntityProvider,\n  TeamTransformer,\n  UserTransformer,\n} from '@backstage/plugin-catalog-backend-module-github';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node/alpha';\n\n/**\n * Interface for {@link githubOrgEntityProviderTransformsExtensionPoint}.\n *\n * @alpha\n */\nexport interface GithubOrgEntityProviderTransformsExtensionPoint {\n  /**\n   * Set a custom transformer for transforming from GitHub users to catalog\n   * entities.\n   */\n  setUserTransformer(transformer: UserTransformer): void;\n\n  /**\n   * Set a custom transformer for transforming from GitHub teams to catalog\n   * entities.\n   */\n  setTeamTransformer(transformer: TeamTransformer): void;\n}\n\n/**\n * Extension point for runtime configuration of {@link catalogModuleGithubOrgEntityProvider}.\n *\n * @alpha\n */\nexport const githubOrgEntityProviderTransformsExtensionPoint =\n  createExtensionPoint<GithubOrgEntityProviderTransformsExtensionPoint>({\n    id: 'catalog.githubOrgEntityProvider',\n  });\n\n/**\n * Registers the `GithubMultiOrgEntityProvider` with the catalog processing extension point.\n *\n * @alpha\n */\nexport const catalogModuleGithubOrgEntityProvider = createBackendModule({\n  pluginId: 'catalog',\n  moduleId: 'githubOrgEntityProvider',\n  register(env) {\n    let userTransformer: UserTransformer | undefined;\n    let teamTransformer: TeamTransformer | undefined;\n\n    env.registerExtensionPoint(\n      githubOrgEntityProviderTransformsExtensionPoint,\n      {\n        setUserTransformer(transformer) {\n          if (userTransformer) {\n            throw new Error('User transformer may only be set once');\n          }\n          userTransformer = transformer;\n        },\n        setTeamTransformer(transformer) {\n          if (teamTransformer) {\n            throw new Error('Team transformer may only be set once');\n          }\n          teamTransformer = 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        for (const definition of readDefinitionsFromConfig(config)) {\n          catalog.addEntityProvider(\n            GithubMultiOrgEntityProvider.fromConfig(config, {\n              id: definition.id,\n              githubUrl: definition.githubUrl,\n              orgs: definition.orgs,\n              schedule: scheduler.createScheduledTaskRunner(\n                definition.schedule,\n              ),\n              logger: loggerToWinstonLogger(logger),\n              userTransformer,\n              teamTransformer,\n            }),\n          );\n        }\n      },\n    });\n  },\n});\n\nfunction readDefinitionsFromConfig(rootConfig: Config): Array<{\n  id: string;\n  githubUrl: string;\n  orgs?: string[];\n  schedule: TaskScheduleDefinition;\n}> {\n  const baseKey = 'catalog.providers.githubOrg';\n  const baseConfig = rootConfig.getOptional(baseKey);\n  if (!baseConfig) {\n    return [];\n  }\n\n  const configs = Array.isArray(baseConfig)\n    ? rootConfig.getConfigArray(baseKey)\n    : [rootConfig.getConfig(baseKey)];\n\n  return configs.map(c => ({\n    id: c.getString('id'),\n    githubUrl: c.getString('githubUrl'),\n    orgs: c.getOptionalStringArray('orgs'),\n    schedule: readTaskScheduleDefinitionFromConfig(c.getConfig('schedule')),\n  }));\n}\n"],"names":["createBackendModule","catalogProcessingExtensionPoint","coreServices","GithubEntityProvider","loggerToWinstonLogger","createExtensionPoint","GithubMultiOrgEntityProvider","readTaskScheduleDefinitionFromConfig"],"mappings":"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"}

package/dist/alpha.d.ts

@@ -1,4 +1,5 @@
 import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+import { UserTransformer, TeamTransformer } from '@backstage/plugin-catalog-backend-module-github';
 
 /**
  * Registers the `GithubEntityProvider` with the catalog processing extension point.
@@ -7,4 +8,34 @@ import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
  */
 declare const catalogModuleGithubEntityProvider: () => _backstage_backend_plugin_api.BackendFeature;
 
-export { catalogModuleGithubEntityProvider };
+/**
+ * Interface for {@link githubOrgEntityProviderTransformsExtensionPoint}.
+ *
+ * @alpha
+ */
+interface GithubOrgEntityProviderTransformsExtensionPoint {
+    /**
+     * Set a custom transformer for transforming from GitHub users to catalog
+     * entities.
+     */
+    setUserTransformer(transformer: UserTransformer): void;
+    /**
+     * Set a custom transformer for transforming from GitHub teams to catalog
+     * entities.
+     */
+    setTeamTransformer(transformer: TeamTransformer): void;
+}
+/**
+ * Extension point for runtime configuration of {@link catalogModuleGithubOrgEntityProvider}.
+ *
+ * @alpha
+ */
+declare const githubOrgEntityProviderTransformsExtensionPoint: _backstage_backend_plugin_api.ExtensionPoint<GithubOrgEntityProviderTransformsExtensionPoint>;
+/**
+ * Registers the `GithubMultiOrgEntityProvider` with the catalog processing extension point.
+ *
+ * @alpha
+ */
+declare const catalogModuleGithubOrgEntityProvider: () => _backstage_backend_plugin_api.BackendFeature;
+
+export { GithubOrgEntityProviderTransformsExtensionPoint, catalogModuleGithubOrgEntityProvider, catalogModuleGithubEntityProvider as default, githubOrgEntityProviderTransformsExtensionPoint };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/plugin-catalog-backend-module-github",
   "description": "A Backstage catalog backend module that helps integrate towards GitHub",
-  "version": "0.0.0-nightly-20230907021058",
+  "version": "0.0.0-nightly-20230909020837",
   "main": "./dist/index.cjs.js",
   "types": "./dist/index.d.ts",
   "license": "Apache-2.0",
@@ -43,19 +43,19 @@
     "start": "backstage-cli package start"
   },
   "dependencies": {
-    "@backstage/backend-common": "^0.0.0-nightly-20230907021058",
-    "@backstage/backend-plugin-api": "^0.0.0-nightly-20230907021058",
-    "@backstage/backend-tasks": "^0.0.0-nightly-20230907021058",
-    "@backstage/catalog-client": "^0.0.0-nightly-20230907021058",
-    "@backstage/catalog-model": "^0.0.0-nightly-20230907021058",
-    "@backstage/config": "^0.0.0-nightly-20230907021058",
-    "@backstage/errors": "^1.2.1",
-    "@backstage/integration": "^0.0.0-nightly-20230907021058",
-    "@backstage/plugin-catalog-backend": "^0.0.0-nightly-20230907021058",
-    "@backstage/plugin-catalog-common": "^0.0.0-nightly-20230907021058",
-    "@backstage/plugin-catalog-node": "^0.0.0-nightly-20230907021058",
-    "@backstage/plugin-events-node": "^0.0.0-nightly-20230907021058",
-    "@backstage/types": "^1.1.0",
+    "@backstage/backend-common": "^0.0.0-nightly-20230909020837",
+    "@backstage/backend-plugin-api": "^0.0.0-nightly-20230909020837",
+    "@backstage/backend-tasks": "^0.0.0-nightly-20230909020837",
+    "@backstage/catalog-client": "^0.0.0-nightly-20230909020837",
+    "@backstage/catalog-model": "^0.0.0-nightly-20230909020837",
+    "@backstage/config": "^0.0.0-nightly-20230909020837",
+    "@backstage/errors": "^0.0.0-nightly-20230909020837",
+    "@backstage/integration": "^0.0.0-nightly-20230909020837",
+    "@backstage/plugin-catalog-backend": "^0.0.0-nightly-20230909020837",
+    "@backstage/plugin-catalog-common": "^0.0.0-nightly-20230909020837",
+    "@backstage/plugin-catalog-node": "^0.0.0-nightly-20230909020837",
+    "@backstage/plugin-events-node": "^0.0.0-nightly-20230909020837",
+    "@backstage/types": "^0.0.0-nightly-20230909020837",
     "@octokit/graphql": "^5.0.0",
     "@octokit/rest": "^19.0.3",
     "git-url-parse": "^13.0.0",
@@ -66,8 +66,8 @@
     "winston": "^3.2.1"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "^0.0.0-nightly-20230907021058",
-    "@backstage/cli": "^0.0.0-nightly-20230907021058",
+    "@backstage/backend-test-utils": "^0.0.0-nightly-20230909020837",
+    "@backstage/cli": "^0.0.0-nightly-20230909020837",
     "@types/lodash": "^4.14.151",
     "luxon": "^3.0.0",
     "msw": "^1.0.0"