From dd995cdc7250709b549a606ddec59827dd12b68b Mon Sep 17 00:00:00 2001
From: Thorsten Hake <mail@thorsten-hake.com>
Date: Thu, 10 Nov 2022 08:54:11 +0100
Subject: [PATCH 1/7] Adds support for generic $ref resolving in yaml/json
 documents.

This resolves https://github.com/backstage/backstage/issues/14490.

Signed-off-by: Thorsten Hake <mail@thorsten-hake.com>
---
 .changeset/tender-colts-greet.md              |  5 ++
 .../catalog-backend-module-openapi/README.md  | 19 ++++--
 .../package.json                              |  2 +-
 .../src/OpenApiRefProcessor.test.ts           | 10 +--
 .../src/OpenApiRefProcessor.ts                |  4 +-
 .../src/index.ts                              |  9 ++-
 .../src/lib/bundle.test.ts                    | 68 +++++++++++++++++--
 .../src/lib/bundle.ts                         | 18 ++---
 ...test.ts => refPlaceholderResolver.test.ts} | 20 +++---
 ...rResolver.ts => refPlaceholderResolver.ts} |  6 +-
 10 files changed, 119 insertions(+), 42 deletions(-)
 create mode 100644 .changeset/tender-colts-greet.md
 rename plugins/catalog-backend-module-openapi/src/{openApiPlaceholderResolver.test.ts => refPlaceholderResolver.test.ts} (70%)
 rename plugins/catalog-backend-module-openapi/src/{openApiPlaceholderResolver.ts => refPlaceholderResolver.ts} (94%)

diff --git a/.changeset/tender-colts-greet.md b/.changeset/tender-colts-greet.md
new file mode 100644
index 0000000000..77c1a8f1b5
--- /dev/null
+++ b/.changeset/tender-colts-greet.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-catalog-backend-module-openapi': patch
+---
+
+Enabled support of resolving `$refs` in all kind of yaml documents, not only OpenAPI. This implicitly adds `$ref` resolving support for AsyncAPI specs. Thus, the `openApiPlaceholderResolver` has been renamed to `refPlaceholderResolver`.
diff --git a/plugins/catalog-backend-module-openapi/README.md b/plugins/catalog-backend-module-openapi/README.md
index f80798e267..68e9c90e05 100644
--- a/plugins/catalog-backend-module-openapi/README.md
+++ b/plugins/catalog-backend-module-openapi/README.md
@@ -1,8 +1,10 @@
-# Catalog Backend Module for OpenAPI specifications
+# Catalog Backend Module to resolve $refs in yaml documents
 
-This is an extension module to the plugin-catalog-backend plugin, providing extensions targeted at OpenAPI specifications.
+This is an extension module to the plugin-catalog-backend plugin, providing an extensions to resolve $refs in yamls documents.
 
-With this you can split your OpenAPI definition into multiple files and reference them. They will be bundled, using an UrlReader, during processing and stored as a single specification.
+With this you can split your yaml documents into multiple files and reference them. They will be bundled, using an UrlReader, during processing and stored as a single specification.
+
+This is useful for OpenAPI and AsyncAPI specifications.
 
 ## Installation
 
@@ -15,15 +17,18 @@ yarn add --cwd packages/backend @backstage/plugin-catalog-backend-module-openapi
 
 ### Adding the plugin to your `packages/backend`
 
-#### **openApiPlaceholderResolver**
+#### **refPlaceholderResolver**
 
-The placeholder resolver can be added by importing `openApiPlaceholderResolver` in `src/plugins/catalog.ts` in your `backend` package and adding the following.
+The placeholder resolver can be added by importing `refPlaceholderResolver` in `src/plugins/catalog.ts` in your `backend` package and adding the following.
 
 ```ts
-builder.setPlaceholderResolver('openapi', openApiPlaceholderResolver);
+builder.setPlaceholderResolver('openapi', refPlaceholderResolver);
+builder.setPlaceholderResolver('asyncapi', refPlaceholderResolver);
 ```
 
-This allows you to use the `$openapi` placeholder when referencing your OpenAPI specification. This will then resolve all `$ref` instances in your specification.
+This allows you to use the `$openapi` placeholder when referencing your OpenAPI specification and `$asyncapi` when referencing your AsyncAPI specifications. This will then resolve all `$ref` instances in your specification.
+
+You can also use this resolver for other kind of yaml files to resolve $ref pointer.
 
 ```yaml
 apiVersion: backstage.io/v1alpha1
diff --git a/plugins/catalog-backend-module-openapi/package.json b/plugins/catalog-backend-module-openapi/package.json
index 1055b5ea92..616e10b98d 100644
--- a/plugins/catalog-backend-module-openapi/package.json
+++ b/plugins/catalog-backend-module-openapi/package.json
@@ -32,7 +32,7 @@
     "start": "backstage-cli package start"
   },
   "dependencies": {
-    "@apidevtools/swagger-parser": "^10.1.0",
+    "@apidevtools/json-schema-ref-parser": "^9.0.6",
     "@backstage/backend-common": "workspace:^",
     "@backstage/catalog-model": "workspace:^",
     "@backstage/config": "workspace:^",
diff --git a/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.test.ts b/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.test.ts
index 9f97e621c2..78568fd19f 100644
--- a/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.test.ts
+++ b/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.test.ts
@@ -17,13 +17,13 @@ import { getVoidLogger } from '@backstage/backend-common';
 import { ConfigReader } from '@backstage/config';
 import { LocationSpec } from '@backstage/plugin-catalog-backend';
 import { OpenApiRefProcessor } from './OpenApiRefProcessor';
-import { bundleOpenApiSpecification } from './lib';
+import { bundleFileWithRefs } from './lib';
 
 jest.mock('./lib', () => ({
-  bundleOpenApiSpecification: jest.fn(),
+  bundleFileWithRefs: jest.fn(),
 }));
 
-const bundledSpecification = '<bundled-specification>';
+const bundled = '<bundled-specification>';
 
 describe('OpenApiRefProcessor', () => {
   const mockLocation = (): LocationSpec => ({
@@ -32,7 +32,7 @@ describe('OpenApiRefProcessor', () => {
   });
 
   beforeEach(() => {
-    (bundleOpenApiSpecification as any).mockResolvedValue(bundledSpecification);
+    (bundleFileWithRefs as any).mockResolvedValue(bundled);
   });
 
   afterEach(() => {
@@ -71,7 +71,7 @@ describe('OpenApiRefProcessor', () => {
         mockLocation(),
       );
 
-      expect(result.spec?.definition).toEqual(bundledSpecification);
+      expect(result.spec?.definition).toEqual(bundled);
     });
 
     it('should ignore other kinds', async () => {
diff --git a/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.ts b/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.ts
index f4cffdf48f..6298aea77d 100644
--- a/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.ts
+++ b/plugins/catalog-backend-module-openapi/src/OpenApiRefProcessor.ts
@@ -21,7 +21,7 @@ import {
   CatalogProcessor,
   LocationSpec,
 } from '@backstage/plugin-catalog-backend';
-import { bundleOpenApiSpecification } from './lib';
+import { bundleFileWithRefs } from './lib';
 import { Logger } from 'winston';
 
 /**
@@ -84,7 +84,7 @@ export class OpenApiRefProcessor implements CatalogProcessor {
 
     this.logger.debug(`Bundling OpenAPI specification from ${location.target}`);
     try {
-      const bundledSpec = await bundleOpenApiSpecification(
+      const bundledSpec = await bundleFileWithRefs(
         definition.toString(),
         location.target,
         this.reader.read,
diff --git a/plugins/catalog-backend-module-openapi/src/index.ts b/plugins/catalog-backend-module-openapi/src/index.ts
index ccd3ced71e..57f3d8806f 100644
--- a/plugins/catalog-backend-module-openapi/src/index.ts
+++ b/plugins/catalog-backend-module-openapi/src/index.ts
@@ -13,5 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { refPlaceholderResolver } from './refPlaceholderResolver';
+
 export { OpenApiRefProcessor } from './OpenApiRefProcessor';
-export { openApiPlaceholderResolver } from './openApiPlaceholderResolver';
+export { refPlaceholderResolver } from './refPlaceholderResolver';
+/**
+ * @public
+ * @deprecated replaced by refPlaceholderResolver
+ */
+export const openApiPlaceholderResolver = refPlaceholderResolver;
diff --git a/plugins/catalog-backend-module-openapi/src/lib/bundle.test.ts b/plugins/catalog-backend-module-openapi/src/lib/bundle.test.ts
index 57ecd54f26..ec77610733 100644
--- a/plugins/catalog-backend-module-openapi/src/lib/bundle.test.ts
+++ b/plugins/catalog-backend-module-openapi/src/lib/bundle.test.ts
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { bundleOpenApiSpecification } from './bundle';
+import { bundleFileWithRefs } from './bundle';
 
 const specification = `
 openapi: "3.0.0"
@@ -70,7 +70,7 @@ paths:
                 type: string
 `;
 
-describe('bundleOpenApiSpecification', () => {
+describe('bundleFileWithRefs', () => {
   const read = jest.fn();
   const resolveUrl = jest.fn();
 
@@ -81,7 +81,7 @@ describe('bundleOpenApiSpecification', () => {
   it('should return the bundled specification', async () => {
     read.mockResolvedValue(list);
 
-    const result = await bundleOpenApiSpecification(
+    const result = await bundleFileWithRefs(
       specification,
       'https://github.com/owner/repo/blob/main/catalog-info.yaml',
       read,
@@ -108,7 +108,7 @@ describe('bundleOpenApiSpecification', () => {
 
     read.mockResolvedValue(list);
 
-    const result = await bundleOpenApiSpecification(
+    const result = await bundleFileWithRefs(
       spec,
       'https://github.com/owner/repo/blob/main/catalog-info.yaml',
       read,
@@ -117,4 +117,64 @@ describe('bundleOpenApiSpecification', () => {
 
     expect(result).toEqual(expectedResult.trimStart());
   });
+  it('should return the bundled asyncapi specification', async () => {
+    const spec = `
+      asyncapi: 2.5.0
+      info:
+        version: 1.0.0
+        title: Sample API
+        description: A sample API to illustrate OpenAPI concepts
+      channels:
+        my-topic:
+          subscribe:
+            message: 
+              schemaFormat: "application/schema+json;version=draft-07"
+              payload: 
+                $ref : "./asyncapi.schema.json"
+    `;
+    const jsonSchema = `
+      {
+        "type": "object",
+        "description": "ExampleSchema",
+        "properties": {
+          "name" : {
+            "type": "string"
+          },
+          "age" : {
+            "type" : "integer"
+          }
+        }
+      }
+    `;
+    const expectedSchema = `
+asyncapi: 2.5.0
+info:
+  version: 1.0.0
+  title: Sample API
+  description: A sample API to illustrate OpenAPI concepts
+channels:
+  my-topic:
+    subscribe:
+      message:
+        schemaFormat: application/schema+json;version=draft-07
+        payload:
+          type: object
+          description: ExampleSchema
+          properties:
+            name:
+              type: string
+            age:
+              type: integer
+`;
+    read.mockResolvedValue(jsonSchema);
+
+    const result = await bundleFileWithRefs(
+      spec,
+      'https://github.com/owner/repo/blob/main/catalog-info.yaml',
+      read,
+      resolveUrl,
+    );
+
+    expect(result).toEqual(expectedSchema.trimStart());
+  });
 });
diff --git a/plugins/catalog-backend-module-openapi/src/lib/bundle.ts b/plugins/catalog-backend-module-openapi/src/lib/bundle.ts
index 8dd880c234..64c772b91e 100644
--- a/plugins/catalog-backend-module-openapi/src/lib/bundle.ts
+++ b/plugins/catalog-backend-module-openapi/src/lib/bundle.ts
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import SwaggerParser from '@apidevtools/swagger-parser';
+import $RefParser from '@apidevtools/json-schema-ref-parser';
 import { parse, stringify } from 'yaml';
 import * as path from 'path';
 
@@ -30,13 +30,13 @@ export type BundlerRead = (url: string) => Promise<Buffer>;
 
 export type BundlerResolveUrl = (url: string, base: string) => string;
 
-export async function bundleOpenApiSpecification(
-  specification: string,
+export async function bundleFileWithRefs(
+  fileWithRefs: string,
   baseUrl: string,
   read: BundlerRead,
   resolveUrl: BundlerResolveUrl,
 ): Promise<string> {
-  const fileUrlReaderResolver: SwaggerParser.ResolverOptions = {
+  const fileUrlReaderResolver: $RefParser.ResolverOptions = {
     canRead: file => {
       const protocol = getProtocol(file.url);
       return protocol === undefined || protocol === 'file';
@@ -47,7 +47,7 @@ export async function bundleOpenApiSpecification(
       return await read(url);
     },
   };
-  const httpUrlReaderResolver: SwaggerParser.ResolverOptions = {
+  const httpUrlReaderResolver: $RefParser.ResolverOptions = {
     canRead: ref => {
       const protocol = getProtocol(ref.url);
       return protocol === 'http' || protocol === 'https';
@@ -58,13 +58,13 @@ export async function bundleOpenApiSpecification(
     },
   };
 
-  const options: SwaggerParser.Options = {
+  const options: $RefParser.Options = {
     resolve: {
       file: fileUrlReaderResolver,
       http: httpUrlReaderResolver,
     },
   };
-  const specObject = parse(specification);
-  const bundledSpec = await SwaggerParser.bundle(specObject, options);
-  return stringify(bundledSpec);
+  const fileObject = parse(fileWithRefs);
+  const bundledObject = await $RefParser.bundle(fileObject, options);
+  return stringify(bundledObject);
 }
diff --git a/plugins/catalog-backend-module-openapi/src/openApiPlaceholderResolver.test.ts b/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.test.ts
similarity index 70%
rename from plugins/catalog-backend-module-openapi/src/openApiPlaceholderResolver.test.ts
rename to plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.test.ts
index f58a818ba5..9ecf0a2995 100644
--- a/plugins/catalog-backend-module-openapi/src/openApiPlaceholderResolver.test.ts
+++ b/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.test.ts
@@ -14,16 +14,16 @@
  * limitations under the License.
  */
 import { PlaceholderResolverParams } from '@backstage/plugin-catalog-backend';
-import { openApiPlaceholderResolver } from './openApiPlaceholderResolver';
-import { bundleOpenApiSpecification } from './lib';
+import { refPlaceholderResolver } from './refPlaceholderResolver';
+import { bundleFileWithRefs } from './lib';
 
 jest.mock('./lib', () => ({
-  bundleOpenApiSpecification: jest.fn(),
+  bundleFileWithRefs: jest.fn(),
 }));
 
-const bundledSpecification = '<bundled-specification>';
+const bundled = '<bundled-specification>';
 
-describe('openApiPlaceholderResolver', () => {
+describe('refPlaceholderResolver', () => {
   const mockResolveUrl = jest.fn();
   mockResolveUrl.mockReturnValue('mockUrl');
 
@@ -40,7 +40,7 @@ describe('openApiPlaceholderResolver', () => {
   };
 
   beforeEach(() => {
-    (bundleOpenApiSpecification as any).mockResolvedValue(bundledSpecification);
+    (bundleFileWithRefs as any).mockResolvedValue(bundled);
   });
 
   afterEach(() => {
@@ -48,16 +48,16 @@ describe('openApiPlaceholderResolver', () => {
   });
 
   it('should throw error if unable to bundle the OpenAPI specification', async () => {
-    (bundleOpenApiSpecification as any).mockRejectedValue(new Error('TEST'));
+    (bundleFileWithRefs as any).mockRejectedValue(new Error('TEST'));
 
-    await expect(openApiPlaceholderResolver(params)).rejects.toThrow(
+    await expect(refPlaceholderResolver(params)).rejects.toThrow(
       'Placeholder $openapi unable to bundle OpenAPI specification',
     );
   });
 
   it('should bundle the OpenAPI specification', async () => {
-    const result = await openApiPlaceholderResolver(params);
+    const result = await refPlaceholderResolver(params);
 
-    expect(result).toEqual(bundledSpecification);
+    expect(result).toEqual(bundled);
   });
 });
diff --git a/plugins/catalog-backend-module-openapi/src/openApiPlaceholderResolver.ts b/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.ts
similarity index 94%
rename from plugins/catalog-backend-module-openapi/src/openApiPlaceholderResolver.ts
rename to plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.ts
index 96fadb3cbc..39c2e639ab 100644
--- a/plugins/catalog-backend-module-openapi/src/openApiPlaceholderResolver.ts
+++ b/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.ts
@@ -16,10 +16,10 @@
 import { PlaceholderResolverParams } from '@backstage/plugin-catalog-backend';
 import { JsonValue } from '@backstage/types';
 import { processingResult } from '@backstage/plugin-catalog-node';
-import { bundleOpenApiSpecification } from './lib';
+import { bundleFileWithRefs } from './lib';
 
 /** @public */
-export async function openApiPlaceholderResolver(
+export async function refPlaceholderResolver(
   params: PlaceholderResolverParams,
 ): Promise<JsonValue> {
   const { content, url } = await readTextLocation(params);
@@ -27,7 +27,7 @@ export async function openApiPlaceholderResolver(
   params.emit(processingResult.refresh(`url:${url}`));
 
   try {
-    return await bundleOpenApiSpecification(
+    return await bundleFileWithRefs(
       content,
       url,
       params.read,

From 5b6ae89870d93743ecad090b66fc8718fc14fd71 Mon Sep 17 00:00:00 2001
From: Thorsten Hake <mail@thorsten-hake.com>
Date: Fri, 11 Nov 2022 09:36:48 +0100
Subject: [PATCH 2/7] updated api-report.md

Signed-off-by: Thorsten Hake <mail@thorsten-hake.com>
---
 plugins/catalog-backend-module-openapi/api-report.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/plugins/catalog-backend-module-openapi/api-report.md b/plugins/catalog-backend-module-openapi/api-report.md
index d3a40067c5..9dbc899dde 100644
--- a/plugins/catalog-backend-module-openapi/api-report.md
+++ b/plugins/catalog-backend-module-openapi/api-report.md
@@ -13,10 +13,8 @@ import { PlaceholderResolverParams } from '@backstage/plugin-catalog-backend';
 import { ScmIntegrations } from '@backstage/integration';
 import { UrlReader } from '@backstage/backend-common';
 
-// @public (undocumented)
-export function openApiPlaceholderResolver(
-  params: PlaceholderResolverParams,
-): Promise<JsonValue>;
+// @public @deprecated (undocumented)
+export const openApiPlaceholderResolver: typeof refPlaceholderResolver;
 
 // @public @deprecated (undocumented)
 export class OpenApiRefProcessor implements CatalogProcessor {
@@ -39,5 +37,10 @@ export class OpenApiRefProcessor implements CatalogProcessor {
   preProcessEntity(entity: Entity, location: LocationSpec): Promise<Entity>;
 }
 
+// @public (undocumented)
+export function refPlaceholderResolver(
+  params: PlaceholderResolverParams,
+): Promise<JsonValue>;
+
 // (No @packageDocumentation comment for this package)
 ```

From 7da041daa7373bdfa6e41dbd9e95f355f945385c Mon Sep 17 00:00:00 2001
From: Thorsten Hake <thorsten.hake@gmail.com>
Date: Mon, 14 Nov 2022 18:49:51 +0100
Subject: [PATCH 3/7] Update plugins/catalog-backend-module-openapi/README.md

Co-authored-by: Johan Haals <johan@haals.se>
Signed-off-by: Thorsten Hake <thorsten.hake@gmail.com>
---
 plugins/catalog-backend-module-openapi/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plugins/catalog-backend-module-openapi/README.md b/plugins/catalog-backend-module-openapi/README.md
index 68e9c90e05..44e0307ac7 100644
--- a/plugins/catalog-backend-module-openapi/README.md
+++ b/plugins/catalog-backend-module-openapi/README.md
@@ -1,6 +1,6 @@
 # Catalog Backend Module to resolve $refs in yaml documents
 
-This is an extension module to the plugin-catalog-backend plugin, providing an extensions to resolve $refs in yamls documents.
+This is an extension module to the Catalog backend, providing extensions to resolve $refs in yaml documents.
 
 With this you can split your yaml documents into multiple files and reference them. They will be bundled, using an UrlReader, during processing and stored as a single specification.
 

From 376551522566d3c114c8df7c8ed5d6226029d731 Mon Sep 17 00:00:00 2001
From: Thorsten Hake <mail@thorsten-hake.com>
Date: Wed, 16 Nov 2022 06:27:00 +0100
Subject: [PATCH 4/7] updated yarn.lock

Signed-off-by: Thorsten Hake <mail@thorsten-hake.com>
---
 yarn.lock | 49 +++----------------------------------------------
 1 file changed, 3 insertions(+), 46 deletions(-)

diff --git a/yarn.lock b/yarn.lock
index b19521eb82..396a6a6e51 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -21,7 +21,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@apidevtools/json-schema-ref-parser@npm:9.0.6, @apidevtools/json-schema-ref-parser@npm:^9.0.6":
+"@apidevtools/json-schema-ref-parser@npm:^9.0.6":
   version: 9.0.6
   resolution: "@apidevtools/json-schema-ref-parser@npm:9.0.6"
   dependencies:
@@ -32,37 +32,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@apidevtools/openapi-schemas@npm:^2.1.0":
-  version: 2.1.0
-  resolution: "@apidevtools/openapi-schemas@npm:2.1.0"
-  checksum: 4a8f64935b9049ef21e41fa4b188f39f6bc3f5291cebd451701db1115451ccb246a739e46cc5ce9ecdec781671431db40db7851acdac84a990a45756e0f32de3
-  languageName: node
-  linkType: hard
-
-"@apidevtools/swagger-methods@npm:^3.0.2":
-  version: 3.0.2
-  resolution: "@apidevtools/swagger-methods@npm:3.0.2"
-  checksum: d06b1ac5c1956613c4c6be695612ef860cd4e962b93a509ca551735a328a856cae1e33399cac1dcbf8333ba22b231746f3586074769ef0e172cf549ec9e7eaae
-  languageName: node
-  linkType: hard
-
-"@apidevtools/swagger-parser@npm:^10.1.0":
-  version: 10.1.0
-  resolution: "@apidevtools/swagger-parser@npm:10.1.0"
-  dependencies:
-    "@apidevtools/json-schema-ref-parser": 9.0.6
-    "@apidevtools/openapi-schemas": ^2.1.0
-    "@apidevtools/swagger-methods": ^3.0.2
-    "@jsdevtools/ono": ^7.1.3
-    ajv: ^8.6.3
-    ajv-draft-04: ^1.0.0
-    call-me-maybe: ^1.0.1
-  peerDependencies:
-    openapi-types: ">=7"
-  checksum: c7c923755bd025ee2cae97e1cfd525538523ba74c341a0ac814c023ffe5e63fc2d997539a8ccf9a0fcec41a2d6337d40cc5735acb991ddcbb415853a241908d1
-  languageName: node
-  linkType: hard
-
 "@apollo/explorer@npm:^1.1.1":
   version: 1.2.0
   resolution: "@apollo/explorer@npm:1.2.0"
@@ -4478,7 +4447,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@backstage/plugin-catalog-backend-module-openapi@workspace:plugins/catalog-backend-module-openapi"
   dependencies:
-    "@apidevtools/swagger-parser": ^10.1.0
+    "@apidevtools/json-schema-ref-parser": ^9.0.6
     "@backstage/backend-common": "workspace:^"
     "@backstage/backend-test-utils": "workspace:^"
     "@backstage/catalog-model": "workspace:^"
@@ -14990,18 +14959,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ajv-draft-04@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "ajv-draft-04@npm:1.0.0"
-  peerDependencies:
-    ajv: ^8.5.0
-  peerDependenciesMeta:
-    ajv:
-      optional: true
-  checksum: 3f11fa0e7f7359bef6608657f02ab78e9cc62b1fb7bdd860db0d00351b3863a1189c1a23b72466d2d82726cab4eb20725c76f5e7c134a89865e2bfd0e6828137
-  languageName: node
-  linkType: hard
-
 "ajv-formats@npm:^2.1.1":
   version: 2.1.1
   resolution: "ajv-formats@npm:2.1.1"
@@ -15048,7 +15005,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ajv@npm:^8.0.0, ajv@npm:^8.10.0, ajv@npm:^8.11.0, ajv@npm:^8.6.3, ajv@npm:^8.8.0":
+"ajv@npm:^8.0.0, ajv@npm:^8.10.0, ajv@npm:^8.11.0, ajv@npm:^8.8.0":
   version: 8.11.2
   resolution: "ajv@npm:8.11.2"
   dependencies:

From 7ce59cbd3ce2d4088ce60d36cfb830e92b99a140 Mon Sep 17 00:00:00 2001
From: Thorsten Hake <mail@thorsten-hake.com>
Date: Tue, 22 Nov 2022 09:00:28 +0100
Subject: [PATCH 5/7] renamed refPlaceholderResolver.ts to
 jsonSchemaRefPlaceholderResolver.ts

Signed-off-by: Thorsten Hake <mail@thorsten-hake.com>
---
 .changeset/tender-colts-greet.md                          | 2 +-
 plugins/catalog-backend-module-openapi/README.md          | 8 ++++----
 plugins/catalog-backend-module-openapi/api-report.md      | 4 ++--
 plugins/catalog-backend-module-openapi/src/index.ts       | 8 ++++----
 ...r.test.ts => jsonSchemaRefPlaceholderResolver.test.ts} | 8 ++++----
 ...derResolver.ts => jsonSchemaRefPlaceholderResolver.ts} | 4 ++--
 6 files changed, 17 insertions(+), 17 deletions(-)
 rename plugins/catalog-backend-module-openapi/src/{refPlaceholderResolver.test.ts => jsonSchemaRefPlaceholderResolver.test.ts} (86%)
 rename plugins/catalog-backend-module-openapi/src/{refPlaceholderResolver.ts => jsonSchemaRefPlaceholderResolver.ts} (94%)

diff --git a/.changeset/tender-colts-greet.md b/.changeset/tender-colts-greet.md
index 77c1a8f1b5..ff59bf0bea 100644
--- a/.changeset/tender-colts-greet.md
+++ b/.changeset/tender-colts-greet.md
@@ -2,4 +2,4 @@
 '@backstage/plugin-catalog-backend-module-openapi': patch
 ---
 
-Enabled support of resolving `$refs` in all kind of yaml documents, not only OpenAPI. This implicitly adds `$ref` resolving support for AsyncAPI specs. Thus, the `openApiPlaceholderResolver` has been renamed to `refPlaceholderResolver`.
+Enabled support of resolving `$refs` in all kind of yaml documents, not only OpenAPI. This implicitly adds `$ref` resolving support for AsyncAPI specs. Thus, the `openApiPlaceholderResolver` has been renamed to `jsonSchemaRefPlaceholderResolver`.
diff --git a/plugins/catalog-backend-module-openapi/README.md b/plugins/catalog-backend-module-openapi/README.md
index 44e0307ac7..6b988e15f5 100644
--- a/plugins/catalog-backend-module-openapi/README.md
+++ b/plugins/catalog-backend-module-openapi/README.md
@@ -17,13 +17,13 @@ yarn add --cwd packages/backend @backstage/plugin-catalog-backend-module-openapi
 
 ### Adding the plugin to your `packages/backend`
 
-#### **refPlaceholderResolver**
+#### **jsonSchemaRefPlaceholderResolver**
 
-The placeholder resolver can be added by importing `refPlaceholderResolver` in `src/plugins/catalog.ts` in your `backend` package and adding the following.
+The placeholder resolver can be added by importing `jsonSchemaRefPlaceholderResolver` in `src/plugins/catalog.ts` in your `backend` package and adding the following.
 
 ```ts
-builder.setPlaceholderResolver('openapi', refPlaceholderResolver);
-builder.setPlaceholderResolver('asyncapi', refPlaceholderResolver);
+builder.setPlaceholderResolver('openapi', jsonSchemaRefPlaceholderResolver);
+builder.setPlaceholderResolver('asyncapi', jsonSchemaRefPlaceholderResolver);
 ```
 
 This allows you to use the `$openapi` placeholder when referencing your OpenAPI specification and `$asyncapi` when referencing your AsyncAPI specifications. This will then resolve all `$ref` instances in your specification.
diff --git a/plugins/catalog-backend-module-openapi/api-report.md b/plugins/catalog-backend-module-openapi/api-report.md
index 9dbc899dde..7294fd5936 100644
--- a/plugins/catalog-backend-module-openapi/api-report.md
+++ b/plugins/catalog-backend-module-openapi/api-report.md
@@ -14,7 +14,7 @@ import { ScmIntegrations } from '@backstage/integration';
 import { UrlReader } from '@backstage/backend-common';
 
 // @public @deprecated (undocumented)
-export const openApiPlaceholderResolver: typeof refPlaceholderResolver;
+export const openApiPlaceholderResolver: typeof jsonSchemaRefPlaceholderResolver;
 
 // @public @deprecated (undocumented)
 export class OpenApiRefProcessor implements CatalogProcessor {
@@ -38,7 +38,7 @@ export class OpenApiRefProcessor implements CatalogProcessor {
 }
 
 // @public (undocumented)
-export function refPlaceholderResolver(
+export function jsonSchemaRefPlaceholderResolver(
   params: PlaceholderResolverParams,
 ): Promise<JsonValue>;
 
diff --git a/plugins/catalog-backend-module-openapi/src/index.ts b/plugins/catalog-backend-module-openapi/src/index.ts
index 57f3d8806f..170c925a7f 100644
--- a/plugins/catalog-backend-module-openapi/src/index.ts
+++ b/plugins/catalog-backend-module-openapi/src/index.ts
@@ -13,12 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { refPlaceholderResolver } from './refPlaceholderResolver';
+import { jsonSchemaRefPlaceholderResolver } from './jsonSchemaRefPlaceholderResolver';
 
 export { OpenApiRefProcessor } from './OpenApiRefProcessor';
-export { refPlaceholderResolver } from './refPlaceholderResolver';
+export { jsonSchemaRefPlaceholderResolver } from './jsonSchemaRefPlaceholderResolver';
 /**
  * @public
- * @deprecated replaced by refPlaceholderResolver
+ * @deprecated replaced by jsonSchemaRefPlaceholderResolver
  */
-export const openApiPlaceholderResolver = refPlaceholderResolver;
+export const openApiPlaceholderResolver = jsonSchemaRefPlaceholderResolver;
diff --git a/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.test.ts b/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts
similarity index 86%
rename from plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.test.ts
rename to plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts
index 9ecf0a2995..6aecc9b468 100644
--- a/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.test.ts
+++ b/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { PlaceholderResolverParams } from '@backstage/plugin-catalog-backend';
-import { refPlaceholderResolver } from './refPlaceholderResolver';
+import { jsonSchemaRefPlaceholderResolver } from './jsonSchemaRefPlaceholderResolver';
 import { bundleFileWithRefs } from './lib';
 
 jest.mock('./lib', () => ({
@@ -23,7 +23,7 @@ jest.mock('./lib', () => ({
 
 const bundled = '<bundled-specification>';
 
-describe('refPlaceholderResolver', () => {
+describe('jsonSchemaRefPlaceholderResolver', () => {
   const mockResolveUrl = jest.fn();
   mockResolveUrl.mockReturnValue('mockUrl');
 
@@ -50,13 +50,13 @@ describe('refPlaceholderResolver', () => {
   it('should throw error if unable to bundle the OpenAPI specification', async () => {
     (bundleFileWithRefs as any).mockRejectedValue(new Error('TEST'));
 
-    await expect(refPlaceholderResolver(params)).rejects.toThrow(
+    await expect(jsonSchemaRefPlaceholderResolver(params)).rejects.toThrow(
       'Placeholder $openapi unable to bundle OpenAPI specification',
     );
   });
 
   it('should bundle the OpenAPI specification', async () => {
-    const result = await refPlaceholderResolver(params);
+    const result = await jsonSchemaRefPlaceholderResolver(params);
 
     expect(result).toEqual(bundled);
   });
diff --git a/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.ts b/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.ts
similarity index 94%
rename from plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.ts
rename to plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.ts
index 39c2e639ab..befafbde8a 100644
--- a/plugins/catalog-backend-module-openapi/src/refPlaceholderResolver.ts
+++ b/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.ts
@@ -19,7 +19,7 @@ import { processingResult } from '@backstage/plugin-catalog-node';
 import { bundleFileWithRefs } from './lib';
 
 /** @public */
-export async function refPlaceholderResolver(
+export async function jsonSchemaRefPlaceholderResolver(
   params: PlaceholderResolverParams,
 ): Promise<JsonValue> {
   const { content, url } = await readTextLocation(params);
@@ -35,7 +35,7 @@ export async function refPlaceholderResolver(
     );
   } catch (error) {
     throw new Error(
-      `Placeholder \$${params.key} unable to bundle OpenAPI specification at ${params.value}, ${error}`,
+      `Placeholder \$${params.key} unable to bundle the file at ${params.value}, ${error}`,
     );
   }
 }

From db4089d33cb275afc4dc41f9b5ee2b67060859ae Mon Sep 17 00:00:00 2001
From: Thorsten Hake <mail@thorsten-hake.com>
Date: Tue, 22 Nov 2022 13:58:27 +0100
Subject: [PATCH 6/7] updated yarn.lock and api-report.md

Signed-off-by: Thorsten Hake <mail@thorsten-hake.com>
---
 plugins/catalog-backend-module-openapi/api-report.md | 10 +++++-----
 yarn.lock                                            |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/plugins/catalog-backend-module-openapi/api-report.md b/plugins/catalog-backend-module-openapi/api-report.md
index 7294fd5936..c2af9cbe01 100644
--- a/plugins/catalog-backend-module-openapi/api-report.md
+++ b/plugins/catalog-backend-module-openapi/api-report.md
@@ -13,6 +13,11 @@ import { PlaceholderResolverParams } from '@backstage/plugin-catalog-backend';
 import { ScmIntegrations } from '@backstage/integration';
 import { UrlReader } from '@backstage/backend-common';
 
+// @public (undocumented)
+export function jsonSchemaRefPlaceholderResolver(
+  params: PlaceholderResolverParams,
+): Promise<JsonValue>;
+
 // @public @deprecated (undocumented)
 export const openApiPlaceholderResolver: typeof jsonSchemaRefPlaceholderResolver;
 
@@ -37,10 +42,5 @@ export class OpenApiRefProcessor implements CatalogProcessor {
   preProcessEntity(entity: Entity, location: LocationSpec): Promise<Entity>;
 }
 
-// @public (undocumented)
-export function jsonSchemaRefPlaceholderResolver(
-  params: PlaceholderResolverParams,
-): Promise<JsonValue>;
-
 // (No @packageDocumentation comment for this package)
 ```
diff --git a/yarn.lock b/yarn.lock
index 96b7ddbf8b..959d6a3453 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -15118,7 +15118,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ajv8@npm:ajv@^8.11.0, ajv@npm:^8.0.0, ajv@npm:^8.10.0, ajv@npm:^8.6.3, ajv@npm:^8.8.0":
+"ajv8@npm:ajv@^8.11.0, ajv@npm:^8.0.0, ajv@npm:^8.10.0, ajv@npm:^8.8.0":
   version: 8.11.2
   resolution: "ajv@npm:8.11.2"
   dependencies:

From e1c481e0b398cba9cc9d7282912ca5e61fafe984 Mon Sep 17 00:00:00 2001
From: Thorsten Hake <mail@thorsten-hake.com>
Date: Tue, 22 Nov 2022 16:22:10 +0100
Subject: [PATCH 7/7] fixed test

Signed-off-by: Thorsten Hake <mail@thorsten-hake.com>
---
 .../src/jsonSchemaRefPlaceholderResolver.test.ts              | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts b/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts
index 6aecc9b468..afa523ccf0 100644
--- a/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts
+++ b/plugins/catalog-backend-module-openapi/src/jsonSchemaRefPlaceholderResolver.test.ts
@@ -50,9 +50,7 @@ describe('jsonSchemaRefPlaceholderResolver', () => {
   it('should throw error if unable to bundle the OpenAPI specification', async () => {
     (bundleFileWithRefs as any).mockRejectedValue(new Error('TEST'));
 
-    await expect(jsonSchemaRefPlaceholderResolver(params)).rejects.toThrow(
-      'Placeholder $openapi unable to bundle OpenAPI specification',
-    );
+    await expect(jsonSchemaRefPlaceholderResolver(params)).rejects.toThrow();
   });
 
   it('should bundle the OpenAPI specification', async () => {