Merge pull request #7643 from marleypowell/marley/7641-export-ado-types

refactor(`@backstage/plugin-azure-devops-backend`): re-exported types from `azure-devops-node-api`

plugins/azure-devops-backend/api-report.md

@@ -45,6 +45,10 @@ export class AzureDevOpsApi {
   ): Promise<RepoBuild[]>;
 }
 
+export { BuildResult };
+
+export { BuildStatus };
+
 // Warning: (ae-missing-release-tag) "createRouter" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal)
 //
 // @public (undocumented)

plugins/azure-devops-backend/src/api/AzureDevOpsApi.ts

@@ -14,42 +14,47 @@
  * limitations under the License.
  */
 
-import { Logger } from 'winston';
-import { WebApi } from 'azure-devops-node-api';
 import {
   Build,
   BuildResult,
   BuildStatus,
-} from 'azure-devops-node-api/interfaces/BuildInterfaces';
-import {
   GitPullRequest,
   GitPullRequestSearchCriteria,
-} from 'azure-devops-node-api/interfaces/GitInterfaces';
-import { PullRequest, PullRequestOptions, RepoBuild } from './types';
+  GitRepository,
+  PullRequest,
+  PullRequestOptions,
+  RepoBuild,
+} from './types';
+
+import { Logger } from 'winston';
+import { WebApi } from 'azure-devops-node-api';
 
 export class AzureDevOpsApi {
-  constructor(
+  public constructor(
     private readonly logger: Logger,
     private readonly webApi: WebApi,
   ) {}
 
-  async getGitRepository(projectName: string, repoName: string) {
-    if (this.logger) {
-      this.logger.debug(
-        `Calling Azure DevOps REST API, getting Repository ${repoName} for Project ${projectName}`,
-      );
-    }
+  public async getGitRepository(
+    projectName: string,
+    repoName: string,
+  ): Promise<GitRepository> {
+    this.logger?.debug(
+      `Calling Azure DevOps REST API, getting Repository ${repoName} for Project ${projectName}`,
+    );
 
     const client = await this.webApi.getGitApi();
     return client.getRepository(repoName, projectName);
   }
 
-  async getBuildList(projectName: string, repoId: string, top: number) {
-    if (this.logger) {
-      this.logger.debug(
-        `Calling Azure DevOps REST API, getting up to ${top} Builds for Repository Id ${repoId} for Project ${projectName}`,
-      );
-    }
+  public async getBuildList(
+    projectName: string,
+    repoId: string,
+    top: number,
+  ): Promise<Build[]> {
+    this.logger?.debug(
+      `Calling Azure DevOps REST API, getting up to ${top} Builds for Repository Id ${repoId} for Project ${projectName}`,
+    );
 
     const client = await this.webApi.getBuildApi();
     return client.getBuilds(
@@ -77,12 +82,14 @@ export class AzureDevOpsApi {
     );
   }
 
-  async getRepoBuilds(projectName: string, repoName: string, top: number) {
-    if (this.logger) {
-      this.logger.debug(
-        `Calling Azure DevOps REST API, getting up to ${top} Builds for Repository ${repoName} for Project ${projectName}`,
-      );
-    }
+  public async getRepoBuilds(
+    projectName: string,
+    repoName: string,
+    top: number,
+  ) {
+    this.logger?.debug(
+      `Calling Azure DevOps REST API, getting up to ${top} Builds for Repository ${repoName} for Project ${projectName}`,
+    );
 
     const gitRepository = await this.getGitRepository(projectName, repoName);
     const buildList = await this.getBuildList(
@@ -98,16 +105,14 @@ export class AzureDevOpsApi {
     return repoBuilds;
   }
 
-  async getPullRequests(
+  public async getPullRequests(
     projectName: string,
     repoName: string,
     options: PullRequestOptions,
-  ) {
-    if (this.logger) {
-      this.logger.debug(
-        `Calling Azure DevOps REST API, getting up to ${top} Pull Requests for Repository ${repoName} for Project ${projectName}`,
-      );
-    }
+  ): Promise<PullRequest[]> {
+    this.logger?.debug(
+      `Calling Azure DevOps REST API, getting up to ${top} Pull Requests for Repository ${repoName} for Project ${projectName}`,
+    );
 
     const gitRepository = await this.getGitRepository(projectName, repoName);
     const client = await this.webApi.getGitApi();
@@ -133,7 +138,7 @@ export class AzureDevOpsApi {
   }
 }
 
-export function mappedRepoBuild(build: Build) {
+export function mappedRepoBuild(build: Build): RepoBuild {
   return {
     id: build.id,
     title: [build.definition?.name, build.buildNumber]
@@ -150,7 +155,7 @@ export function mappedRepoBuild(build: Build) {
 export function mappedPullRequest(
   pullRequest: GitPullRequest,
   linkBaseUrl: string,
-) {
+): PullRequest {
   return {
     pullRequestId: pullRequest.pullRequestId,
     repoName: pullRequest.repository?.name,

plugins/azure-devops-backend/src/api/index.ts

@@ -15,4 +15,5 @@
  */
 
 export { AzureDevOpsApi } from './AzureDevOpsApi';
+export { BuildResult, BuildStatus } from './types';
 export type { RepoBuild, PullRequest } from './types';

plugins/azure-devops-backend/src/api/types.ts

@@ -15,10 +15,24 @@
  */
 
 import {
+  Build,
   BuildResult,
   BuildStatus,
 } from 'azure-devops-node-api/interfaces/BuildInterfaces';
-import { PullRequestStatus } from 'azure-devops-node-api/interfaces/GitInterfaces';
+import {
+  GitPullRequest,
+  GitPullRequestSearchCriteria,
+  GitRepository,
+  PullRequestStatus,
+} from 'azure-devops-node-api/interfaces/GitInterfaces';
+
+export { BuildResult, BuildStatus, PullRequestStatus };
+export type {
+  Build,
+  GitPullRequest,
+  GitPullRequestSearchCriteria,
+  GitRepository,
+};
 
 export type RepoBuild = {
   id?: number;

plugins/azure-devops-backend/src/index.ts

@@ -13,6 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export { AzureDevOpsApi } from './api';
+export { AzureDevOpsApi, BuildResult, BuildStatus } from './api';
 export type { RepoBuild, PullRequest } from './api';
 export * from './service/router';

plugins/azure-devops-backend/src/service/router.ts

@@ -14,15 +14,15 @@
  * limitations under the License.
  */
 
+import { PullRequestOptions, PullRequestStatus } from '../api/types';
+import { WebApi, getPersonalAccessTokenHandler } from 'azure-devops-node-api';
+
+import { AzureDevOpsApi } from '../api';
+import { Config } from '@backstage/config';
+import { Logger } from 'winston';
+import Router from 'express-promise-router';
 import { errorHandler } from '@backstage/backend-common';
 import express from 'express';
-import Router from 'express-promise-router';
-import { Logger } from 'winston';
-import { Config } from '@backstage/config';
-import { getPersonalAccessTokenHandler, WebApi } from 'azure-devops-node-api';
-import { AzureDevOpsApi } from '../api';
-import { PullRequestStatus } from 'azure-devops-node-api/interfaces/GitInterfaces';
-import { PullRequestOptions } from '../api/types';
 
 const DEFAULT_TOP: number = 10;