@backstage/plugin-catalog-backend-module-backstage-openapi 0.5.16 → 0.5.17

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @backstage/plugin-catalog-backend-module-backstage-openapi
 
+## 0.5.17
+
+### Patch Changes
+
+- 74d8cbf: The internal OpenAPI documentation provider now automatically discovers installed plugins via the system metadata service. The `catalog.providers.backstageOpenapi.plugins` configuration option is now optional and deprecated; when omitted, all installed plugins are discovered dynamically.
+- Updated dependencies
+  - @backstage/catalog-model@1.10.0
+  - @backstage/backend-plugin-api@1.10.0
+  - @backstage/backend-openapi-utils@0.7.1
+  - @backstage/plugin-catalog-node@2.2.4
+
+## 0.5.17-next.0
+
+### Patch Changes
+
+- 74d8cbf: The internal OpenAPI documentation provider now automatically discovers installed plugins via the system metadata service. The `catalog.providers.backstageOpenapi.plugins` configuration option is now optional and deprecated; when omitted, all installed plugins are discovered dynamically.
+- Updated dependencies
+  - @backstage/backend-plugin-api@1.10.0-next.0
+  - @backstage/backend-openapi-utils@0.7.1-next.0
+  - @backstage/plugin-catalog-node@2.2.4-next.0
+
 ## 0.5.16
 
 ### Patch Changes

package/config.schema.json

@@ -16,7 +16,8 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "A list of plugins, whose OpenAPI specs you want to collate in `InternalOpenApiDocumentationProvider`."
+                  "description": "A list of plugins whose OpenAPI specs you want to collate in `InternalOpenApiDocumentationProvider`.",
+                  "deprecated": "Plugins are now discovered automatically via the system metadata service.\nSet this only to override the automatically discovered list."
                 },
                 "entityOverrides": {
                   "type": "object",
@@ -31,9 +32,6 @@
                   "description": "The format of the definition."
                 }
               },
-              "required": [
-                "plugins"
-              ],
               "description": "BackstageOpenApiEntityProvider configuration"
             }
           }

package/dist/InternalOpenApiDocumentationProvider.cjs.js

@@ -126,11 +126,13 @@ class InternalOpenApiDocumentationProvider {
   discovery;
   logger;
   auth;
-  constructor(config, discovery, logger, auth, taskRunner) {
+  rootSystemMetadata;
+  constructor(config, discovery, logger, auth, rootSystemMetadata, taskRunner) {
     this.config = config;
     this.discovery = discovery;
     this.logger = logger;
     this.auth = auth;
+    this.rootSystemMetadata = rootSystemMetadata;
     this.scheduleFn = this.createScheduleFn(taskRunner);
   }
   static fromConfig(config, options) {
@@ -147,6 +149,7 @@ class InternalOpenApiDocumentationProvider {
       options.discovery,
       options.logger,
       options.auth,
+      options.rootSystemMetadata,
       taskRunner
     );
   }
@@ -176,9 +179,16 @@ class InternalOpenApiDocumentationProvider {
     };
   }
   async refresh(logger) {
-    const pluginsToMerge = this.config.getStringArray(
+    const explicitPlugins = this.config.getOptionalStringArray(
       "catalog.providers.backstageOpenapi.plugins"
     );
+    const pluginsToMerge = Array.from(
+      new Set(
+        explicitPlugins ?? (await this.rootSystemMetadata.getInstalledPlugins()).map(
+          (p) => p.pluginId
+        )
+      )
+    );
     const configToMerge = this.config.getOptional(
       "catalog.providers.backstageOpenapi.entityOverrides"
     );

package/dist/InternalOpenApiDocumentationProvider.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"InternalOpenApiDocumentationProvider.cjs.js","sources":["../src/InternalOpenApiDocumentationProvider.ts"],"sourcesContent":["/*\n * Copyright 2023 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 */\nimport yaml from 'yaml';\nimport {\n  ANNOTATION_LOCATION,\n  ANNOTATION_ORIGIN_LOCATION,\n  type ApiEntity,\n} from '@backstage/catalog-model';\nimport { Config } from '@backstage/config';\nimport { ForwardedError } from '@backstage/errors';\nimport {\n  EntityProvider,\n  EntityProviderConnection,\n} from '@backstage/plugin-catalog-node';\nimport { merge, isErrorResult } from 'openapi-merge';\nimport { getOpenApiSpecRoute } from '@backstage/backend-openapi-utils';\nimport type {\n  OpenAPIObject,\n  OperationObject,\n  PathItemObject,\n} from 'openapi3-ts';\nimport fetch from 'cross-fetch';\nimport {\n  AuthService,\n  DiscoveryService,\n  LoggerService,\n  SchedulerService,\n  SchedulerServiceTaskRunner,\n} from '@backstage/backend-plugin-api';\nimport { randomUUID } from 'node:crypto';\nimport lodash from 'lodash';\n\nconst HTTP_VERBS: (keyof PathItemObject)[] = [\n  'get',\n  'post',\n  'put',\n  'delete',\n  'patch',\n  'trace',\n  'options',\n  'head',\n];\n\nconst addTagsToSpec = (spec: OpenAPIObject, tag: string) => {\n  Object.values(spec?.paths).forEach((path: PathItemObject) => {\n    HTTP_VERBS.forEach(verb => {\n      if (verb in path) {\n        if (!('tags' in path[verb])) {\n          (path[verb] as OperationObject).tags = [];\n        }\n        if (!(path[verb] as OperationObject).tags?.includes(tag)) {\n          (path[verb] as OperationObject).tags?.push(tag);\n        }\n      }\n    });\n  });\n};\n\nconst mergeSpecs = async ({\n  baseUrl,\n  specs,\n}: {\n  baseUrl: string;\n  specs: OpenAPIObject[];\n}) => {\n  const mergeResult = merge([\n    // Add the full API information as the first item for other items to merge against it with.\n    {\n      oas: {\n        openapi: '3.0.3',\n        info: {\n          title: 'Backstage API',\n          version: '1',\n        },\n        servers: [{ url: baseUrl }],\n        paths: {},\n      },\n    },\n    // For each plugin, load its spec and the known endpoint that it sits under.\n    ...specs.map(\n      spec =>\n        ({\n          oas: spec,\n          // Weird typing differences between this package and the client package's openapi 3.\n        } as any),\n    ),\n  ]);\n\n  if (isErrorResult(mergeResult)) {\n    throw new ForwardedError(\n      `${mergeResult.message} (${mergeResult.type})`,\n      mergeResult,\n    );\n  } else {\n    return mergeResult.output;\n  }\n};\n\nconst loadSpecs = async ({\n  baseUrl,\n  discovery,\n  plugins,\n  logger,\n  auth,\n}: {\n  baseUrl: string;\n  plugins: string[];\n  discovery: DiscoveryService;\n  logger: LoggerService;\n  auth: AuthService;\n}) => {\n  const specs: OpenAPIObject[] = [];\n  for (const pluginId of plugins) {\n    const url = await discovery.getBaseUrl(pluginId);\n    const openApiUrl = getOpenApiSpecRoute(url);\n    const { token } = await auth.getPluginRequestToken({\n      onBehalfOf: await auth.getOwnServiceCredentials(),\n      targetPluginId: pluginId,\n    });\n    const response = await fetch(openApiUrl, {\n      method: 'GET',\n      headers: {\n        Authorization: `Bearer ${token}`,\n      },\n    });\n    if (response.ok) {\n      const spec = await response.json();\n      addTagsToSpec(spec, pluginId);\n      specs.push(spec);\n    } else if (response.status === 404) {\n      logger.error(\n        `Plugin=${pluginId} does not have an OpenAPI spec at '${openApiUrl}'.`,\n      );\n    } else {\n      logger.error(\n        `Failed to load spec for plugin=${pluginId} at ${openApiUrl}. Error (${\n          response.status\n        }): ${response.body ? await response.text() : response.statusText}`,\n      );\n    }\n  }\n  return mergeSpecs({ baseUrl, specs });\n};\n\nconst formatDefinition = (\n  definition: any,\n  format: string | 'json' | 'yaml',\n) => {\n  if (format === 'json') {\n    return JSON.stringify(definition, null, 2);\n  }\n  if (format === 'yaml') {\n    return yaml.stringify(definition);\n  }\n  throw new Error(`Unsupported format type: ${format}`);\n};\n\nexport class InternalOpenApiDocumentationProvider implements EntityProvider {\n  private connection?: EntityProviderConnection;\n  private readonly scheduleFn: () => Promise<void>;\n  public readonly config: Config;\n  public readonly discovery: DiscoveryService;\n  public readonly logger: LoggerService;\n  public readonly auth: AuthService;\n\n  constructor(\n    config: Config,\n    discovery: DiscoveryService,\n    logger: LoggerService,\n    auth: AuthService,\n    taskRunner: SchedulerServiceTaskRunner,\n  ) {\n    this.config = config;\n    this.discovery = discovery;\n    this.logger = logger;\n    this.auth = auth;\n    this.scheduleFn = this.createScheduleFn(taskRunner);\n  }\n\n  static fromConfig(\n    config: Config,\n    options: {\n      discovery: DiscoveryService;\n      logger: LoggerService;\n      schedule: SchedulerService;\n      auth: AuthService;\n    },\n  ) {\n    const taskRunner = options.schedule.createScheduledTaskRunner({\n      frequency: {\n        minutes: 1,\n      },\n      timeout: {\n        minutes: 1,\n      },\n    });\n    return new InternalOpenApiDocumentationProvider(\n      config,\n      options.discovery,\n      options.logger,\n      options.auth,\n      taskRunner,\n    );\n  }\n  /** {@inheritdoc @backstage/plugin-catalog-node#EntityProvider.getProviderName} */\n  getProviderName() {\n    return `InternalOpenApiDocumentationProvider`;\n  }\n\n  /** {@inheritdoc @backstage/plugin-catalog-node#EntityProvider.connect} */\n  async connect(connection: EntityProviderConnection) {\n    this.connection = connection;\n    return await this.scheduleFn();\n  }\n\n  private createScheduleFn(\n    taskRunner: SchedulerServiceTaskRunner,\n  ): () => Promise<void> {\n    return async () => {\n      const taskId = `${this.getProviderName()}:refresh`;\n      return taskRunner.run({\n        id: taskId,\n        fn: async () => {\n          const logger = this.logger.child({\n            class:\n              InternalOpenApiDocumentationProvider.prototype.constructor.name,\n            taskId,\n            taskInstanceId: randomUUID(),\n          });\n          await this.refresh(logger);\n        },\n      });\n    };\n  }\n\n  async refresh(logger: LoggerService) {\n    const pluginsToMerge = this.config.getStringArray(\n      'catalog.providers.backstageOpenapi.plugins',\n    );\n    const configToMerge = this.config.getOptional(\n      'catalog.providers.backstageOpenapi.entityOverrides',\n    );\n    const formatConfig =\n      this.config.getOptionalString(\n        'catalog.providers.backstageOpenapi.definitionFormat',\n      ) ?? 'json';\n\n    const baseConfig = {\n      metadata: {\n        name: 'internal_backstage_openapi_doc',\n        title: 'Backstage API',\n      },\n      spec: {\n        lifecycle: 'production',\n        owner: 'backstage',\n      },\n    };\n\n    logger.info(`Loading specs from ${pluginsToMerge}.`);\n    const requiredConfig = {\n      apiVersion: 'backstage.io/v1beta1',\n      kind: 'API',\n      metadata: {\n        annotations: {\n          [ANNOTATION_LOCATION]:\n            'internal-package:@backstage/plugin-catalog-backend-module-backstage-openapi',\n          [ANNOTATION_ORIGIN_LOCATION]:\n            'internal-package:@backstage/plugin-catalog-backend-module-backstage-openapi',\n        },\n      },\n      spec: {\n        type: 'openapi',\n        definition: formatDefinition(\n          await loadSpecs({\n            baseUrl: this.config.getString('backend.baseUrl'),\n            discovery: this.discovery,\n            auth: this.auth,\n            plugins: pluginsToMerge,\n            logger,\n          }),\n          formatConfig,\n        ),\n      },\n    };\n\n    // Overwrite baseConfig with options from config file.\n    const mergedConfig = lodash.merge(baseConfig, configToMerge);\n\n    // Overwrite mergedConfig with requiredConfig (i.e., spec.type and spec.definition) to avoid bad configuration.\n    const documentationEntity = lodash.merge(\n      mergedConfig,\n      requiredConfig,\n    ) as ApiEntity;\n\n    await this.connection?.applyMutation({\n      type: 'full',\n      entities: [\n        {\n          entity: documentationEntity,\n          locationKey: 'internal-api-doc',\n        },\n      ],\n    });\n  }\n}\n"],"names":["merge","isErrorResult","ForwardedError","getOpenApiSpecRoute","fetch","yaml","randomUUID","ANNOTATION_LOCATION","ANNOTATION_ORIGIN_LOCATION","lodash"],"mappings":"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"}
+{"version":3,"file":"InternalOpenApiDocumentationProvider.cjs.js","sources":["../src/InternalOpenApiDocumentationProvider.ts"],"sourcesContent":["/*\n * Copyright 2023 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 */\nimport yaml from 'yaml';\nimport {\n  ANNOTATION_LOCATION,\n  ANNOTATION_ORIGIN_LOCATION,\n  type ApiEntity,\n} from '@backstage/catalog-model';\nimport { Config } from '@backstage/config';\nimport { ForwardedError } from '@backstage/errors';\nimport {\n  EntityProvider,\n  EntityProviderConnection,\n} from '@backstage/plugin-catalog-node';\nimport { merge, isErrorResult } from 'openapi-merge';\nimport { getOpenApiSpecRoute } from '@backstage/backend-openapi-utils';\nimport type {\n  OpenAPIObject,\n  OperationObject,\n  PathItemObject,\n} from 'openapi3-ts';\nimport fetch from 'cross-fetch';\nimport {\n  AuthService,\n  DiscoveryService,\n  LoggerService,\n  RootSystemMetadataService,\n  SchedulerService,\n  SchedulerServiceTaskRunner,\n} from '@backstage/backend-plugin-api';\nimport { randomUUID } from 'node:crypto';\nimport lodash from 'lodash';\n\nconst HTTP_VERBS: (keyof PathItemObject)[] = [\n  'get',\n  'post',\n  'put',\n  'delete',\n  'patch',\n  'trace',\n  'options',\n  'head',\n];\n\nconst addTagsToSpec = (spec: OpenAPIObject, tag: string) => {\n  Object.values(spec?.paths).forEach((path: PathItemObject) => {\n    HTTP_VERBS.forEach(verb => {\n      if (verb in path) {\n        if (!('tags' in path[verb])) {\n          (path[verb] as OperationObject).tags = [];\n        }\n        if (!(path[verb] as OperationObject).tags?.includes(tag)) {\n          (path[verb] as OperationObject).tags?.push(tag);\n        }\n      }\n    });\n  });\n};\n\nconst mergeSpecs = async ({\n  baseUrl,\n  specs,\n}: {\n  baseUrl: string;\n  specs: OpenAPIObject[];\n}) => {\n  const mergeResult = merge([\n    // Add the full API information as the first item for other items to merge against it with.\n    {\n      oas: {\n        openapi: '3.0.3',\n        info: {\n          title: 'Backstage API',\n          version: '1',\n        },\n        servers: [{ url: baseUrl }],\n        paths: {},\n      },\n    },\n    // For each plugin, load its spec and the known endpoint that it sits under.\n    ...specs.map(\n      spec =>\n        ({\n          oas: spec,\n          // Weird typing differences between this package and the client package's openapi 3.\n        } as any),\n    ),\n  ]);\n\n  if (isErrorResult(mergeResult)) {\n    throw new ForwardedError(\n      `${mergeResult.message} (${mergeResult.type})`,\n      mergeResult,\n    );\n  } else {\n    return mergeResult.output;\n  }\n};\n\nconst loadSpecs = async ({\n  baseUrl,\n  discovery,\n  plugins,\n  logger,\n  auth,\n}: {\n  baseUrl: string;\n  plugins: string[];\n  discovery: DiscoveryService;\n  logger: LoggerService;\n  auth: AuthService;\n}) => {\n  const specs: OpenAPIObject[] = [];\n  for (const pluginId of plugins) {\n    const url = await discovery.getBaseUrl(pluginId);\n    const openApiUrl = getOpenApiSpecRoute(url);\n    const { token } = await auth.getPluginRequestToken({\n      onBehalfOf: await auth.getOwnServiceCredentials(),\n      targetPluginId: pluginId,\n    });\n    const response = await fetch(openApiUrl, {\n      method: 'GET',\n      headers: {\n        Authorization: `Bearer ${token}`,\n      },\n    });\n    if (response.ok) {\n      const spec = await response.json();\n      addTagsToSpec(spec, pluginId);\n      specs.push(spec);\n    } else if (response.status === 404) {\n      logger.error(\n        `Plugin=${pluginId} does not have an OpenAPI spec at '${openApiUrl}'.`,\n      );\n    } else {\n      logger.error(\n        `Failed to load spec for plugin=${pluginId} at ${openApiUrl}. Error (${\n          response.status\n        }): ${response.body ? await response.text() : response.statusText}`,\n      );\n    }\n  }\n  return mergeSpecs({ baseUrl, specs });\n};\n\nconst formatDefinition = (\n  definition: any,\n  format: string | 'json' | 'yaml',\n) => {\n  if (format === 'json') {\n    return JSON.stringify(definition, null, 2);\n  }\n  if (format === 'yaml') {\n    return yaml.stringify(definition);\n  }\n  throw new Error(`Unsupported format type: ${format}`);\n};\n\nexport class InternalOpenApiDocumentationProvider implements EntityProvider {\n  private connection?: EntityProviderConnection;\n  private readonly scheduleFn: () => Promise<void>;\n  public readonly config: Config;\n  public readonly discovery: DiscoveryService;\n  public readonly logger: LoggerService;\n  public readonly auth: AuthService;\n  public readonly rootSystemMetadata: RootSystemMetadataService;\n\n  constructor(\n    config: Config,\n    discovery: DiscoveryService,\n    logger: LoggerService,\n    auth: AuthService,\n    rootSystemMetadata: RootSystemMetadataService,\n    taskRunner: SchedulerServiceTaskRunner,\n  ) {\n    this.config = config;\n    this.discovery = discovery;\n    this.logger = logger;\n    this.auth = auth;\n    this.rootSystemMetadata = rootSystemMetadata;\n    this.scheduleFn = this.createScheduleFn(taskRunner);\n  }\n\n  static fromConfig(\n    config: Config,\n    options: {\n      discovery: DiscoveryService;\n      logger: LoggerService;\n      schedule: SchedulerService;\n      auth: AuthService;\n      rootSystemMetadata: RootSystemMetadataService;\n    },\n  ) {\n    const taskRunner = options.schedule.createScheduledTaskRunner({\n      frequency: {\n        minutes: 1,\n      },\n      timeout: {\n        minutes: 1,\n      },\n    });\n    return new InternalOpenApiDocumentationProvider(\n      config,\n      options.discovery,\n      options.logger,\n      options.auth,\n      options.rootSystemMetadata,\n      taskRunner,\n    );\n  }\n  /** {@inheritdoc @backstage/plugin-catalog-node#EntityProvider.getProviderName} */\n  getProviderName() {\n    return `InternalOpenApiDocumentationProvider`;\n  }\n\n  /** {@inheritdoc @backstage/plugin-catalog-node#EntityProvider.connect} */\n  async connect(connection: EntityProviderConnection) {\n    this.connection = connection;\n    return await this.scheduleFn();\n  }\n\n  private createScheduleFn(\n    taskRunner: SchedulerServiceTaskRunner,\n  ): () => Promise<void> {\n    return async () => {\n      const taskId = `${this.getProviderName()}:refresh`;\n      return taskRunner.run({\n        id: taskId,\n        fn: async () => {\n          const logger = this.logger.child({\n            class:\n              InternalOpenApiDocumentationProvider.prototype.constructor.name,\n            taskId,\n            taskInstanceId: randomUUID(),\n          });\n          await this.refresh(logger);\n        },\n      });\n    };\n  }\n\n  async refresh(logger: LoggerService) {\n    const explicitPlugins = this.config.getOptionalStringArray(\n      'catalog.providers.backstageOpenapi.plugins',\n    );\n    const pluginsToMerge = Array.from(\n      new Set(\n        explicitPlugins ??\n          (await this.rootSystemMetadata.getInstalledPlugins()).map(\n            p => p.pluginId,\n          ),\n      ),\n    );\n    const configToMerge = this.config.getOptional(\n      'catalog.providers.backstageOpenapi.entityOverrides',\n    );\n    const formatConfig =\n      this.config.getOptionalString(\n        'catalog.providers.backstageOpenapi.definitionFormat',\n      ) ?? 'json';\n\n    const baseConfig = {\n      metadata: {\n        name: 'internal_backstage_openapi_doc',\n        title: 'Backstage API',\n      },\n      spec: {\n        lifecycle: 'production',\n        owner: 'backstage',\n      },\n    };\n\n    logger.info(`Loading specs from ${pluginsToMerge}.`);\n    const requiredConfig = {\n      apiVersion: 'backstage.io/v1beta1',\n      kind: 'API',\n      metadata: {\n        annotations: {\n          [ANNOTATION_LOCATION]:\n            'internal-package:@backstage/plugin-catalog-backend-module-backstage-openapi',\n          [ANNOTATION_ORIGIN_LOCATION]:\n            'internal-package:@backstage/plugin-catalog-backend-module-backstage-openapi',\n        },\n      },\n      spec: {\n        type: 'openapi',\n        definition: formatDefinition(\n          await loadSpecs({\n            baseUrl: this.config.getString('backend.baseUrl'),\n            discovery: this.discovery,\n            auth: this.auth,\n            plugins: pluginsToMerge,\n            logger,\n          }),\n          formatConfig,\n        ),\n      },\n    };\n\n    // Overwrite baseConfig with options from config file.\n    const mergedConfig = lodash.merge(baseConfig, configToMerge);\n\n    // Overwrite mergedConfig with requiredConfig (i.e., spec.type and spec.definition) to avoid bad configuration.\n    const documentationEntity = lodash.merge(\n      mergedConfig,\n      requiredConfig,\n    ) as ApiEntity;\n\n    await this.connection?.applyMutation({\n      type: 'full',\n      entities: [\n        {\n          entity: documentationEntity,\n          locationKey: 'internal-api-doc',\n        },\n      ],\n    });\n  }\n}\n"],"names":["merge","isErrorResult","ForwardedError","getOpenApiSpecRoute","fetch","yaml","randomUUID","ANNOTATION_LOCATION","ANNOTATION_ORIGIN_LOCATION","lodash"],"mappings":"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"}

package/dist/index.cjs.js

@@ -18,15 +18,25 @@ const catalogModuleInternalOpenApiSpec = backendPluginApi.createBackendModule({
         discovery: backendPluginApi.coreServices.discovery,
         scheduler: backendPluginApi.coreServices.scheduler,
         logger: backendPluginApi.coreServices.logger,
-        auth: backendPluginApi.coreServices.auth
+        auth: backendPluginApi.coreServices.auth,
+        rootSystemMetadata: backendPluginApi.coreServices.rootSystemMetadata
       },
-      async init({ catalog, config, discovery, scheduler, logger, auth }) {
+      async init({
+        catalog,
+        config,
+        discovery,
+        scheduler,
+        logger,
+        auth,
+        rootSystemMetadata
+      }) {
         catalog.addEntityProvider(
           InternalOpenApiDocumentationProvider.InternalOpenApiDocumentationProvider.fromConfig(config, {
             discovery,
             schedule: scheduler,
             logger,
-            auth
+            auth,
+            rootSystemMetadata
           })
         );
       }

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/index.ts"],"sourcesContent":["/*\n * Copyright 2023 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} from '@backstage/backend-plugin-api';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node';\nimport { InternalOpenApiDocumentationProvider } from './InternalOpenApiDocumentationProvider';\n\n/**\n * @public\n */\nexport type MetaApiDocsPluginOptions = { exampleOption: boolean };\n\n/**\n * @public\n */\nexport const metaOpenApiDocsPluginId = 'meta-api-docs';\n\n/**\n * @public\n */\nexport const catalogModuleInternalOpenApiSpec = createBackendModule({\n  moduleId: metaOpenApiDocsPluginId,\n  pluginId: 'catalog',\n  register(env) {\n    env.registerInit({\n      deps: {\n        catalog: catalogProcessingExtensionPoint,\n        config: coreServices.rootConfig,\n        discovery: coreServices.discovery,\n        scheduler: coreServices.scheduler,\n        logger: coreServices.logger,\n        auth: coreServices.auth,\n      },\n      async init({ catalog, config, discovery, scheduler, logger, auth }) {\n        catalog.addEntityProvider(\n          InternalOpenApiDocumentationProvider.fromConfig(config, {\n            discovery,\n            schedule: scheduler,\n            logger,\n            auth,\n          }),\n        );\n      },\n    });\n  },\n});\n\nexport default catalogModuleInternalOpenApiSpec;\n"],"names":["createBackendModule","catalogProcessingExtensionPoint","coreServices","InternalOpenApiDocumentationProvider"],"mappings":";;;;;;;;AA+BO,MAAM,uBAAA,GAA0B;AAKhC,MAAM,mCAAmCA,oCAAA,CAAoB;AAAA,EAClE,QAAA,EAAU,uBAAA;AAAA,EACV,QAAA,EAAU,SAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,OAAA,EAASC,iDAAA;AAAA,QACT,QAAQC,6BAAA,CAAa,UAAA;AAAA,QACrB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,QAAQA,6BAAA,CAAa,MAAA;AAAA,QACrB,MAAMA,6BAAA,CAAa;AAAA,OACrB;AAAA,MACA,MAAM,KAAK,EAAE,OAAA,EAAS,QAAQ,SAAA,EAAW,SAAA,EAAW,MAAA,EAAQ,IAAA,EAAK,EAAG;AAClE,QAAA,OAAA,CAAQ,iBAAA;AAAA,UACNC,yEAAA,CAAqC,WAAW,MAAA,EAAQ;AAAA,YACtD,SAAA;AAAA,YACA,QAAA,EAAU,SAAA;AAAA,YACV,MAAA;AAAA,YACA;AAAA,WACD;AAAA,SACH;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;;;"}
+{"version":3,"file":"index.cjs.js","sources":["../src/index.ts"],"sourcesContent":["/*\n * Copyright 2023 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} from '@backstage/backend-plugin-api';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node';\nimport { InternalOpenApiDocumentationProvider } from './InternalOpenApiDocumentationProvider';\n\n/**\n * @public\n */\nexport type MetaApiDocsPluginOptions = { exampleOption: boolean };\n\n/**\n * @public\n */\nexport const metaOpenApiDocsPluginId = 'meta-api-docs';\n\n/**\n * @public\n */\nexport const catalogModuleInternalOpenApiSpec = createBackendModule({\n  moduleId: metaOpenApiDocsPluginId,\n  pluginId: 'catalog',\n  register(env) {\n    env.registerInit({\n      deps: {\n        catalog: catalogProcessingExtensionPoint,\n        config: coreServices.rootConfig,\n        discovery: coreServices.discovery,\n        scheduler: coreServices.scheduler,\n        logger: coreServices.logger,\n        auth: coreServices.auth,\n        rootSystemMetadata: coreServices.rootSystemMetadata,\n      },\n      async init({\n        catalog,\n        config,\n        discovery,\n        scheduler,\n        logger,\n        auth,\n        rootSystemMetadata,\n      }) {\n        catalog.addEntityProvider(\n          InternalOpenApiDocumentationProvider.fromConfig(config, {\n            discovery,\n            schedule: scheduler,\n            logger,\n            auth,\n            rootSystemMetadata,\n          }),\n        );\n      },\n    });\n  },\n});\n\nexport default catalogModuleInternalOpenApiSpec;\n"],"names":["createBackendModule","catalogProcessingExtensionPoint","coreServices","InternalOpenApiDocumentationProvider"],"mappings":";;;;;;;;AA+BO,MAAM,uBAAA,GAA0B;AAKhC,MAAM,mCAAmCA,oCAAA,CAAoB;AAAA,EAClE,QAAA,EAAU,uBAAA;AAAA,EACV,QAAA,EAAU,SAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,OAAA,EAASC,iDAAA;AAAA,QACT,QAAQC,6BAAA,CAAa,UAAA;AAAA,QACrB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,QAAQA,6BAAA,CAAa,MAAA;AAAA,QACrB,MAAMA,6BAAA,CAAa,IAAA;AAAA,QACnB,oBAAoBA,6BAAA,CAAa;AAAA,OACnC;AAAA,MACA,MAAM,IAAA,CAAK;AAAA,QACT,OAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA,SAAA;AAAA,QACA,MAAA;AAAA,QACA,IAAA;AAAA,QACA;AAAA,OACF,EAAG;AACD,QAAA,OAAA,CAAQ,iBAAA;AAAA,UACNC,yEAAA,CAAqC,WAAW,MAAA,EAAQ;AAAA,YACtD,SAAA;AAAA,YACA,QAAA,EAAU,SAAA;AAAA,YACV,MAAA;AAAA,YACA,IAAA;AAAA,YACA;AAAA,WACD;AAAA,SACH;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-catalog-backend-module-backstage-openapi",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "backstage": {
     "role": "backend-plugin-module",
     "pluginId": "catalog",
@@ -36,19 +36,19 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/backend-openapi-utils": "^0.7.0",
-    "@backstage/backend-plugin-api": "^1.9.3",
-    "@backstage/catalog-model": "^1.9.0",
+    "@backstage/backend-openapi-utils": "^0.7.1",
+    "@backstage/backend-plugin-api": "^1.10.0",
+    "@backstage/catalog-model": "^1.10.0",
     "@backstage/config": "^1.3.8",
     "@backstage/errors": "^1.3.1",
-    "@backstage/plugin-catalog-node": "^2.2.3",
+    "@backstage/plugin-catalog-node": "^2.2.4",
     "cross-fetch": "^4.0.0",
     "lodash": "^4.17.21",
     "openapi-merge": "^1.3.2",
     "yaml": "^2.7.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.36.4",
+    "@backstage/cli": "^0.36.5",
     "openapi3-ts": "^3.1.2"
   },
   "configSchema": "config.schema.json",