@backstage/repo-tools 0.5.0-next.0 → 0.5.0-next.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @backstage/repo-tools
 
+## 0.5.0-next.1
+
+### Patch Changes
+
+- f909e9d: Includes templates in @backstage/repo-tools package and use them in the CLI
+- da3c4db: Updates the `schema openapi generate-client` command to export all generated types from the generated directory.
+- 7959f23: The `api-reports` command now checks for api report files that no longer apply.
+  If it finds such files, it's treated basically the same as report errors do, and
+  the check fails.
+
+  For example, if you had an `api-report-alpha.md` but then removed the alpha
+  export, the reports generator would now report that this file needs to be
+  deleted.
+
+- f49e237: Fixed a bug where `schema openapi init` created an invalid test command.
+- f91be2c: Updated dependency `@stoplight/types` to `^14.0.0`.
+- 45bfb20: Execute `openapi-generator-cli` from `@backstage/repo-tools` directory to force it to use our openapitools.json config file.
+- Updated dependencies
+  - @backstage/backend-common@0.20.0-next.2
+  - @backstage/catalog-model@1.4.3
+  - @backstage/cli-common@0.1.13
+  - @backstage/cli-node@0.2.0
+  - @backstage/errors@1.2.3
+
 ## 0.5.0-next.0
 
 ### Minor Changes

package/dist/cjs/{api-reports-0697bd2a.cjs.js → api-reports-143209ff.cjs.js}

@@ -1,5 +1,6 @@
 'use strict';
 
+var lodash = require('lodash');
 var path = require('path');
 var child_process = require('child_process');
 var fs = require('fs-extra');
@@ -255,7 +256,9 @@ async function runApiExtraction({
     };
   }
   const warnings = new Array();
-  for (const { packageDir, name } of packageEntryPoints) {
+  for (const [packageDir, group] of Object.entries(
+    lodash.groupBy(packageEntryPoints, (ep) => ep.packageDir)
+  )) {
     console.log(`## Processing ${packageDir}`);
     const noBail = Array.isArray(allowWarnings) ? allowWarnings.some((aw) => aw === packageDir || minimatch__default["default"](packageDir, aw)) : allowWarnings;
     const projectFolder = paths.paths.resolveTargetRoot(packageDir);
@@ -263,165 +266,190 @@ async function runApiExtraction({
       "./dist-types",
       packageDir
     );
-    const suffix = name === "index" ? "" : `-${name}`;
-    const reportFileName = `api-report${suffix}.md`;
-    const reportPath = path.resolve(projectFolder, reportFileName);
-    const warningCountBefore = await countApiReportWarnings(reportPath);
-    const extractorConfig = apiExtractor.ExtractorConfig.prepare({
-      configObject: {
-        mainEntryPointFilePath: path.resolve(packageFolder, `src/${name}.d.ts`),
-        bundledPackages: [],
-        compiler: {
-          tsconfigFilePath
-        },
-        apiReport: {
-          enabled: true,
-          reportFileName,
-          reportFolder: projectFolder,
-          reportTempFolder: path.resolve(
-            outputDir,
-            `<unscopedPackageName>${suffix}`
-          )
-        },
-        docModel: {
-          // TODO(Rugvip): This skips docs for non-index entry points. We can try to work around it, but
-          //               most likely it makes sense to wait for API Extractor to natively support exports.
-          enabled: name === "index",
-          apiJsonFilePath: path.resolve(
-            outputDir,
-            `<unscopedPackageName>${suffix}.api.json`
-          )
-        },
-        dtsRollup: {
-          enabled: false
-        },
-        tsdocMetadata: {
-          enabled: false
-        },
-        messages: {
-          // Silence compiler warnings, as these will prevent the CI build to work
-          compilerMessageReporting: {
-            default: {
-              logLevel: "none"
-              // These contain absolute file paths, so can't be included in the report
-              // addToApiReportFile: true,
-            }
+    const names = group.map((ep) => ep.name);
+    const remainingReportFiles = new Set(
+      fs__default["default"].readdirSync(projectFolder).filter(
+        (filename) => filename.match(/^(.+)-api-report\.md$/) || filename.match(/^api-report(-.+)?\.md$/)
+      )
+    );
+    for (const name of names) {
+      const suffix = name === "index" ? "" : `-${name}`;
+      const reportFileName = `api-report${suffix}.md`;
+      const reportPath = path.resolve(projectFolder, reportFileName);
+      remainingReportFiles.delete(reportFileName);
+      const warningCountBefore = await countApiReportWarnings(reportPath);
+      const extractorConfig = apiExtractor.ExtractorConfig.prepare({
+        configObject: {
+          mainEntryPointFilePath: path.resolve(
+            packageFolder,
+            `src/${name}.d.ts`
+          ),
+          bundledPackages: [],
+          compiler: {
+            tsconfigFilePath
+          },
+          apiReport: {
+            enabled: true,
+            reportFileName,
+            reportFolder: projectFolder,
+            reportTempFolder: path.resolve(
+              outputDir,
+              `<unscopedPackageName>${suffix}`
+            )
+          },
+          docModel: {
+            // TODO(Rugvip): This skips docs for non-index entry points. We can try to work around it, but
+            //               most likely it makes sense to wait for API Extractor to natively support exports.
+            enabled: name === "index",
+            apiJsonFilePath: path.resolve(
+              outputDir,
+              `<unscopedPackageName>${suffix}.api.json`
+            )
+          },
+          dtsRollup: {
+            enabled: false
           },
-          extractorMessageReporting: {
-            default: {
-              logLevel: "warning",
-              addToApiReportFile: true
+          tsdocMetadata: {
+            enabled: false
+          },
+          messages: {
+            // Silence compiler warnings, as these will prevent the CI build to work
+            compilerMessageReporting: {
+              default: {
+                logLevel: "none"
+                // These contain absolute file paths, so can't be included in the report
+                // addToApiReportFile: true,
+              }
+            },
+            extractorMessageReporting: {
+              default: {
+                logLevel: "warning",
+                addToApiReportFile: true
+              },
+              ...messagesConf
             },
-            ...messagesConf
+            tsdocMessageReporting: {
+              default: {
+                logLevel: "warning",
+                addToApiReportFile: true
+              }
+            }
           },
-          tsdocMessageReporting: {
-            default: {
-              logLevel: "warning",
-              addToApiReportFile: true
+          newlineKind: "lf",
+          projectFolder
+        },
+        configObjectFullPath: projectFolder,
+        packageJsonFullPath: path.resolve(projectFolder, "package.json"),
+        tsdocConfigFile: await getTsDocConfig(),
+        ignoreMissingEntryPoint: true
+      });
+      extractorConfig.packageFolder = packageFolder;
+      if (!compilerState) {
+        compilerState = apiExtractor.CompilerState.create(extractorConfig, {
+          additionalEntryPoints: entryPoints
+        });
+      }
+      apiExtractor.Extractor._checkCompilerCompatibility = () => {
+      };
+      let shouldLogInstructions = false;
+      let conflictingFile = void 0;
+      const extractorResult = apiExtractor.Extractor.invoke(extractorConfig, {
+        localBuild: isLocalBuild,
+        showVerboseMessages: false,
+        showDiagnostics: false,
+        messageCallback(message) {
+          if (message.text.includes("The API report file is missing")) {
+            shouldLogInstructions = true;
+          }
+          if (message.text.includes(
+            "You have changed the public API signature for this project."
+          )) {
+            shouldLogInstructions = true;
+            const match = message.text.match(
+              /Please copy the file "(.*)" to "api-report\.md"/
+            );
+            if (match) {
+              conflictingFile = match[1];
             }
           }
         },
-        newlineKind: "lf",
-        projectFolder
-      },
-      configObjectFullPath: projectFolder,
-      packageJsonFullPath: path.resolve(projectFolder, "package.json"),
-      tsdocConfigFile: await getTsDocConfig(),
-      ignoreMissingEntryPoint: true
-    });
-    extractorConfig.packageFolder = packageFolder;
-    if (!compilerState) {
-      compilerState = apiExtractor.CompilerState.create(extractorConfig, {
-        additionalEntryPoints: entryPoints
+        compilerState
       });
-    }
-    apiExtractor.Extractor._checkCompilerCompatibility = () => {
-    };
-    let shouldLogInstructions = false;
-    let conflictingFile = void 0;
-    const extractorResult = apiExtractor.Extractor.invoke(extractorConfig, {
-      localBuild: isLocalBuild,
-      showVerboseMessages: false,
-      showDiagnostics: false,
-      messageCallback(message) {
-        if (message.text.includes("The API report file is missing")) {
-          shouldLogInstructions = true;
-        }
-        if (message.text.includes(
-          "You have changed the public API signature for this project."
-        )) {
-          shouldLogInstructions = true;
-          const match = message.text.match(
-            /Please copy the file "(.*)" to "api-report\.md"/
+      if (validateReleaseTags && fs__default["default"].pathExistsSync(extractorConfig.reportFilePath)) {
+        if (["index", "alpha", "beta"].includes(name)) {
+          const report = await fs__default["default"].readFile(
+            extractorConfig.reportFilePath,
+            "utf8"
           );
-          if (match) {
-            conflictingFile = match[1];
+          const lines = report.split(/\r?\n/);
+          const expectedTag = name === "index" ? "public" : name;
+          for (let i = 0; i < lines.length; i += 1) {
+            const line = lines[i];
+            const match = line.match(/^\/\/ @(alpha|beta|public)/);
+            if (match && match[1] !== expectedTag) {
+              if (expectedTag !== "public" && match[1] === "public") {
+                continue;
+              }
+              throw new Error(
+                `Unexpected release tag ${match[1]} in ${extractorConfig.reportFilePath} at line ${i + 1}`
+              );
+            }
           }
         }
-      },
-      compilerState
-    });
-    if (validateReleaseTags && fs__default["default"].pathExistsSync(extractorConfig.reportFilePath)) {
-      if (["index", "alpha", "beta"].includes(name)) {
-        const report = await fs__default["default"].readFile(
-          extractorConfig.reportFilePath,
-          "utf8"
-        );
-        const lines = report.split(/\r?\n/);
-        const expectedTag = name === "index" ? "public" : name;
-        for (let i = 0; i < lines.length; i += 1) {
-          const line = lines[i];
-          const match = line.match(/^\/\/ @(alpha|beta|public)/);
-          if (match && match[1] !== expectedTag) {
-            if (expectedTag !== "public" && match[1] === "public") {
-              continue;
-            }
-            throw new Error(
-              `Unexpected release tag ${match[1]} in ${extractorConfig.reportFilePath} at line ${i + 1}`
+      }
+      if (!extractorResult.succeeded) {
+        if (shouldLogInstructions) {
+          logApiReportInstructions();
+          if (conflictingFile) {
+            console.log("");
+            console.log(
+              `The conflicting file is ${path.relative(
+                tmpDir,
+                conflictingFile
+              )}, with the following content:`
             );
+            console.log("");
+            const content = await fs__default["default"].readFile(conflictingFile, "utf8");
+            console.log(content);
+            logApiReportInstructions();
           }
         }
+        throw new Error(
+          `API Extractor completed with ${extractorResult.errorCount} errors and ${extractorResult.warningCount} warnings`
+        );
+      }
+      const warningCountAfter = await countApiReportWarnings(reportPath);
+      if (noBail) {
+        console.log(`Skipping warnings check for ${packageDir}`);
+      }
+      if (warningCountAfter > 0 && !noBail) {
+        throw new Error(
+          `The API Report for ${packageDir} is not allowed to have warnings`
+        );
+      }
+      if (warningCountAfter === 0 && allowWarningPkg.includes(packageDir)) {
+        console.log(
+          `No need to allow warnings for ${packageDir}, it does not have any`
+        );
+      }
+      if (warningCountAfter > warningCountBefore) {
+        warnings.push(
+          `The API Report for ${packageDir} introduces new warnings. Please fix these warnings in order to keep the API Reports tidy.`
+        );
       }
     }
-    if (!extractorResult.succeeded) {
-      if (shouldLogInstructions) {
-        logApiReportInstructions();
-        if (conflictingFile) {
-          console.log("");
-          console.log(
-            `The conflicting file is ${path.relative(
-              tmpDir,
-              conflictingFile
-            )}, with the following content:`
-          );
-          console.log("");
-          const content = await fs__default["default"].readFile(conflictingFile, "utf8");
-          console.log(content);
-          logApiReportInstructions();
+    if (remainingReportFiles.size > 0) {
+      if (isLocalBuild) {
+        for (const f of remainingReportFiles) {
+          fs__default["default"].rmSync(path.resolve(projectFolder, f));
+          console.log(`Deleted deprecated API report ${f}`);
         }
+      } else {
+        const staleList = [...remainingReportFiles].map((f) => path.join(packageDir, f)).join(", ");
+        throw new Error(
+          `The API Report(s) ${staleList} are no longer relevant and should be deleted`
+        );
       }
-      throw new Error(
-        `API Extractor completed with ${extractorResult.errorCount} errors and ${extractorResult.warningCount} warnings`
-      );
-    }
-    const warningCountAfter = await countApiReportWarnings(reportPath);
-    if (noBail) {
-      console.log(`Skipping warnings check for ${packageDir}`);
-    }
-    if (warningCountAfter > 0 && !noBail) {
-      throw new Error(
-        `The API Report for ${packageDir} is not allowed to have warnings`
-      );
-    }
-    if (warningCountAfter === 0 && allowWarningPkg.includes(packageDir)) {
-      console.log(
-        `No need to allow warnings for ${packageDir}, it does not have any`
-      );
-    }
-    if (warningCountAfter > warningCountBefore) {
-      warnings.push(
-        `The API Report for ${packageDir} introduces new warnings. Please fix these warnings in order to keep the API Reports tidy.`
-      );
     }
   }
   if (warnings.length > 0) {
@@ -1150,4 +1178,4 @@ function parseArrayOption(value) {
 }
 
 exports.buildApiReports = buildApiReports;
-//# sourceMappingURL=api-reports-0697bd2a.cjs.js.map
+//# sourceMappingURL=api-reports-143209ff.cjs.js.map

package/dist/cjs/{generate-be7745a5.cjs.js → generate-675bd523.cjs.js}

@@ -6,6 +6,7 @@ var constants = require('./constants-866c449d.cjs.js');
 var paths = require('./paths-9ab9b8a8.cjs.js');
 var fs = require('fs-extra');
 var exec = require('./exec-7bf444eb.cjs.js');
+var backendCommon = require('@backstage/backend-common');
 require('@backstage/cli-common');
 require('@backstage/cli-node');
 require('minimatch');
@@ -27,10 +28,9 @@ async function generate(spec, outputDirectory) {
     constants.OPENAPI_IGNORE_FILES.join("\n")
   );
   await exec.exec(
-    // The actual main.js file for the binary isn't executable but yarn does _something_ to make it executable.
-    // TODO (sennyeya@): Make this use the actual binary
-    `yarn openapi-generator-cli`,
+    "node",
     [
+      backendCommon.resolvePackagePath("@openapitools/openapi-generator-cli", "main.js"),
       "generate",
       "-i",
       resolvedOpenapiPath,
@@ -39,24 +39,27 @@ async function generate(spec, outputDirectory) {
       "-g",
       "typescript",
       "-c",
-      "templates/typescript-backstage.yaml",
+      backendCommon.resolvePackagePath(
+        "@backstage/repo-tools",
+        "templates/typescript-backstage.yaml"
+      ),
       "--generator-key",
       "v3.0"
     ],
     {
       maxBuffer: Number.MAX_VALUE,
-      cwd: paths.paths.ownDir,
+      cwd: backendCommon.resolvePackagePath("@backstage/repo-tools"),
       env: {
         ...process.env
-        // PWD: outputDirectory,
       }
     }
   );
   await exec.exec(
     `yarn backstage-cli package lint --fix ${resolvedOutputDirectory}`
   );
-  if (paths.paths.resolveTargetRoot("node_modules/.bin/prettier")) {
-    await exec.exec(`yarn prettier --write ${resolvedOutputDirectory}`);
+  const prettier = paths.paths.resolveTargetRoot("node_modules/.bin/prettier");
+  if (prettier) {
+    await exec.exec(`${prettier} --write ${resolvedOutputDirectory}`);
   }
   fs__default["default"].removeSync(path.resolve(resolvedOutputDirectory, ".openapi-generator-ignore"));
   fs__default["default"].rmSync(path.resolve(resolvedOutputDirectory, ".openapi-generator"), {
@@ -80,4 +83,4 @@ async function singleCommand({
 }
 
 exports.singleCommand = singleCommand;
-//# sourceMappingURL=generate-be7745a5.cjs.js.map
+//# sourceMappingURL=generate-675bd523.cjs.js.map

package/dist/cjs/{init-9d8f5e0f.cjs.js → init-5e60457a.cjs.js}

@@ -32,7 +32,7 @@ async function init(directoryPath) {
     );
   }
   const opticConfigFilePath = path.join(directoryPath, "optic.yml");
-  if (!await fs__default["default"].pathExists(opticConfigFilePath)) {
+  if (await fs__default["default"].pathExists(opticConfigFilePath)) {
     throw new Error(`This directory already has an optic.yml file. Exiting.`);
   }
   await fs__default["default"].writeFile(
@@ -53,7 +53,7 @@ capture:
                 # \u{1F527} Specify a command that will generate traffic
                 command: yarn backstage-cli package test --no-watch ${ROUTER_TEST_PATHS.map(
       (e) => `"${e}"`
-    ).join(",")} 
+    ).join(" ")} 
   `
   );
   if (await paths.paths.resolveTargetRoot("node_modules/.bin/prettier")) {
@@ -83,4 +83,4 @@ async function initCommand(paths = []) {
 }
 
 exports["default"] = initCommand;
-//# sourceMappingURL=init-9d8f5e0f.cjs.js.map
+//# sourceMappingURL=init-5e60457a.cjs.js.map

package/dist/index.cjs.js

@@ -62,10 +62,10 @@ function registerSchemaCommand(program) {
     "Fail on any linting severity messages, not just errors."
   ).action(lazy(() => Promise.resolve().then(function () { return require('./cjs/lint-e06bf899.cjs.js'); }).then((m) => m.bulkCommand)));
   openApiCommand.command("test [paths...]").description("Test OpenAPI schemas against written tests").option("--update", "Update the spec on failure.").action(lazy(() => Promise.resolve().then(function () { return require('./cjs/index-ed4aaab1.cjs.js'); }).then((m) => m.bulkCommand)));
-  openApiCommand.command("init <paths...>").description("Creates any config needed for the test command.").action(lazy(() => Promise.resolve().then(function () { return require('./cjs/init-9d8f5e0f.cjs.js'); }).then((m) => m.default)));
+  openApiCommand.command("init <paths...>").description("Creates any config needed for the test command.").action(lazy(() => Promise.resolve().then(function () { return require('./cjs/init-5e60457a.cjs.js'); }).then((m) => m.default)));
   openApiCommand.command("generate-client").requiredOption("--input-spec <file>").requiredOption("--output-directory <directory>").action(
     lazy(
-      () => Promise.resolve().then(function () { return require('./cjs/generate-be7745a5.cjs.js'); }).then((m) => m.singleCommand)
+      () => Promise.resolve().then(function () { return require('./cjs/generate-675bd523.cjs.js'); }).then((m) => m.singleCommand)
     )
   );
 }
@@ -93,7 +93,7 @@ function registerCommands(program) {
     "Turn on release tag validation for the public, beta, and alpha APIs"
   ).description("Generate an API report for selected packages").action(
     lazy(
-      () => Promise.resolve().then(function () { return require('./cjs/api-reports-0697bd2a.cjs.js'); }).then((m) => m.buildApiReports)
+      () => Promise.resolve().then(function () { return require('./cjs/api-reports-143209ff.cjs.js'); }).then((m) => m.buildApiReports)
     )
   );
   program.command("type-deps").description("Find inconsistencies in types of all packages and plugins").action(lazy(() => Promise.resolve().then(function () { return require('./cjs/type-deps-5eacd931.cjs.js'); }).then((m) => m.default)));
@@ -125,7 +125,7 @@ function lazy(getActionFunc) {
   };
 }
 
-var version = "0.5.0-next.0";
+var version = "0.5.0-next.1";
 
 const main = (argv) => {
   commander.program.name("backstage-repo-tools").version(version);

package/openapitools.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "../../node_modules/@openapitools/openapi-generator-cli/config.schema.json",
+  "spaces": 2,
+  "generator-cli": {
+    "version": "6.5.0"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/repo-tools",
   "description": "CLI for Backstage repo tooling ",
-  "version": "0.5.0-next.0",
+  "version": "0.5.0-next.1",
   "publishConfig": {
     "access": "public"
   },
@@ -32,6 +32,7 @@
   "dependencies": {
     "@apidevtools/swagger-parser": "^10.1.0",
     "@apisyouwonthate/style-guide": "^1.4.0",
+    "@backstage/backend-common": "^0.20.0-next.2",
     "@backstage/catalog-model": "^1.4.3",
     "@backstage/cli-common": "^0.1.13",
     "@backstage/cli-node": "^0.2.0",
@@ -46,7 +47,7 @@
     "@stoplight/spectral-parsers": "^1.0.2",
     "@stoplight/spectral-rulesets": "^1.18.0",
     "@stoplight/spectral-runtime": "^1.1.2",
-    "@stoplight/types": "^13.14.0",
+    "@stoplight/types": "^14.0.0",
     "chalk": "^4.0.0",
     "codeowners-utils": "^1.0.2",
     "commander": "^9.1.0",
@@ -62,7 +63,7 @@
     "yaml-diff-patch": "^2.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.25.0-next.1",
+    "@backstage/cli": "^0.25.0-next.2",
     "@backstage/types": "^1.1.1",
     "@types/is-glob": "^4.0.2",
     "@types/mock-fs": "^4.13.0",
@@ -85,7 +86,9 @@
   },
   "files": [
     "bin",
-    "dist/**/*.js"
+    "dist/**/*.js",
+    "templates",
+    "openapitools.json"
   ],
   "nodemonConfig": {
     "watch": "./src",

package/templates/typescript-backstage/api.mustache

@@ -0,0 +1,114 @@
+{{>licenseInfo}}
+import { DiscoveryApi } from '../types/discovery';
+import { FetchApi } from '../types/fetch';
+import crossFetch from 'cross-fetch';
+import {pluginId} from '../pluginId';
+import * as parser from 'uri-template';
+
+{{#imports}}
+import { {{classname}} } from '{{filename}}.model{{importFileExtension}}';
+{{/imports}}
+
+type TypedResponse<T> = Omit<Response, 'json'> & {
+  json: () => Promise<T>;
+};
+
+{{#operations}}
+
+/**
+ * Options you can pass into a request for additional information.
+ *
+ * @public
+ */
+export interface RequestOptions {
+  token?: string;
+}
+
+/**
+ * {{{description}}}{{^description}}no description{{/description}}
+ */
+export class {{classname}}Client {
+    private readonly discoveryApi: DiscoveryApi;
+    private readonly fetchApi: FetchApi;
+
+    constructor(options: {
+        discoveryApi: { getBaseUrl(pluginId: string): Promise<string> };
+        fetchApi?: { fetch: typeof fetch };
+    }) {
+        this.discoveryApi = options.discoveryApi;
+        this.fetchApi = options.fetchApi || { fetch: crossFetch };
+    }
+
+    {{#operation}}
+    /**
+     {{#notes}}
+     * {{&notes}}
+     {{/notes}}
+     {{#summary}}
+     * {{&summary}}
+     {{/summary}}
+     {{#allParams}}
+     * @param {{paramName}} {{description}}
+     {{/allParams}}
+     */
+    public async {{nickname}}(
+        // @ts-ignore
+        request: {
+            {{#hasPathParams}}
+            path: {
+                {{#pathParams}}
+                    {{paramName}}{{^required}}?{{/required}}: {{{dataType}}},
+                {{/pathParams}}
+            },
+            {{/hasPathParams}}
+            {{#hasBodyParam}}
+                {{#bodyParam}}
+                body: {{{dataType}}},
+                {{/bodyParam}}
+            {{/hasBodyParam}}
+            {{#hasQueryParams}}
+            query: {
+                {{#queryParams}}
+                {{paramName}}{{^required}}?{{/required}}: {{{dataType}}},
+                {{/queryParams}}
+            },
+            {{/hasQueryParams}}
+            {{#hasHeaderParams}}
+            header: {
+                {{#headerParams}}
+                {{paramName}}{{^required}}?{{/required}}: {{{dataType}}},
+                {{/headerParams}}
+            },
+            {{/hasHeaderParams}}
+        },
+        options?: RequestOptions
+    ): Promise<TypedResponse<{{{returnType}}} {{^returnType}}void{{/returnType}}>> {
+        const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);
+        
+        const uriTemplate = `{{{path}}}{{#hasQueryParams}}{?{{#queryParams}}{{baseName}}{{#isArray}}{{#isExplode}}*{{/isExplode}}{{/isArray}}{{^-last}},{{/-last}}{{/queryParams}}}{{/hasQueryParams}}`;
+        
+        const uri = parser.parse(uriTemplate).expand({
+        {{#pathParams}}
+            {{baseName}}: request.path.{{paramName}},
+        {{/pathParams}}
+        {{#hasQueryParams}}
+            ...request.query,
+        {{/hasQueryParams}}
+        })
+
+        return await this.fetchApi.fetch(`${baseUrl}${uri}`, {
+            headers: {
+                {{#hasHeaderParams}}
+                ...request.header,
+                {{/hasHeaderParams}}
+                'Content-Type': 'application/json',
+                ...(options?.token && { Authorization: `Bearer ${options?.token}` }),
+            },
+            method: '{{httpMethod}}',
+            {{#hasBodyParam}} body: JSON.stringify(request.body), {{/hasBodyParam}}
+        });
+    }
+
+    {{/operation}}
+}
+{{/operations}}

package/templates/typescript-backstage/apis/index.mustache

@@ -0,0 +1,3 @@
+//
+
+export * from './DefaultApi.client';

package/templates/typescript-backstage/index.mustache

@@ -0,0 +1,4 @@
+// 
+
+export * from './apis';
+export * from './models';

package/templates/typescript-backstage/model.mustache

@@ -0,0 +1,43 @@
+//
+
+{{#models}}
+{{#model}}
+{{#tsImports}}
+import { {{classname}} } from '{{filename}}.model{{importFileExtension}}';
+{{/tsImports}}
+
+{{#description}}
+/**
+* {{{.}}}
+*/
+{{/description}}
+{{^isEnum}}
+export interface {{classname}} {
+{{#additionalPropertiesType}}
+    [key: string]: {{{additionalPropertiesType}}};
+{{/additionalPropertiesType}}
+{{#vars}}
+{{#description}}
+    /**
+    * {{{.}}}
+    */
+{{/description}}
+    '{{name}}'{{^required}}?{{/required}}: {{#isEnum}}{{{datatypeWithEnum}}}{{/isEnum}}{{^isEnum}}{{{dataType}}}{{/isEnum}}{{#isNullable}} | null{{/isNullable}};
+{{/vars}}
+}
+
+{{#hasEnums}}
+
+{{#vars}}
+{{#isEnum}}
+export type {{classname}}{{enumName}} ={{#allowableValues}}{{#values}} "{{.}}" {{^-last}}|{{/-last}}{{/values}}{{/allowableValues}};
+{{/isEnum}}
+{{/vars}}
+
+{{/hasEnums}}
+{{/isEnum}}
+{{#isEnum}}
+export type {{classname}} ={{#allowableValues}}{{#values}} "{{.}}" {{^-last}}|{{/-last}}{{/values}}{{/allowableValues}};
+{{/isEnum}}
+{{/model}}
+{{/models}}

package/templates/typescript-backstage/models/models_all.mustache

@@ -0,0 +1,7 @@
+//
+
+{{#models}}
+{{#model}}
+export * from '{{{ importPath }}}.model{{importFileExtension}}'
+{{/model}}
+{{/models}}

package/templates/typescript-backstage/pluginId.mustache

@@ -0,0 +1,6 @@
+
+{{#servers}}
+{{#-last}}
+export const pluginId = "{{url}}";
+{{/-last}}
+{{/servers}}

package/templates/typescript-backstage/types/discovery.ts

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * This is a copy of the DiscoveryApi, to avoid importing core-plugin-api.
+ */
+export type DiscoveryApi = {
+  getBaseUrl(pluginId: string): Promise<string>;
+};

package/templates/typescript-backstage/types/fetch.ts

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2023 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * This is a copy of FetchApi, to avoid importing core-plugin-api.
+ */
+export type FetchApi = {
+  fetch: typeof fetch;
+};

package/templates/typescript-backstage.yaml

@@ -0,0 +1,21 @@
+templateDir: templates/typescript-backstage
+
+files:
+  api.mustache:
+    templateType: API
+    # For some reason, they check for destinationFilename differences. We have to change the ending to override the file.
+    destinationFilename: .client.ts
+  model.mustache:
+    templateType: Model
+    destinationFilename: .model.ts
+  models/models_all.mustache:
+    templateType: SupportingFiles
+    destinationFilename: models/index.ts
+  types/fetch.ts: {}
+  types/discovery.ts: {}
+  apis/index.mustache:
+    templateType: SupportingFiles
+    destinationFilename: apis/index.ts
+  pluginId.mustache:
+    templateType: SupportingFiles
+    destinationFilename: pluginId.ts