Add new endpoint for repositories overview

Author: baileyherbert

src/collections/RepositoryCollection.ts

@@ -2,6 +2,7 @@ import { OmahaCollection } from '../client/OmahaCollection';
 import { Repository } from '../entities/Repository';
 import { DeleteObjectResponse } from './generic/DeleteObjectResponse';
 import { CreateRepositoryRequest } from './repository/CreateRepositoryRequest';
+import { RepositoryOverview } from './repository/RepositoryOverview';
 import { RepositoryWithCollaboration } from './repository/RepositoryWithCollaboration';
 import { UpdateRepositoryRequest } from './repository/UpdateRepositoryRequest';
 import { RepositoryTokensCollection } from './RepositoryTokensCollection';
@@ -22,6 +23,15 @@ export class RepositoryCollection extends OmahaCollection {
 		return this.client.get<RepositoryWithCollaboration[]>('/v1/repositories');
 	}
 
+	/**
+	 * Gets a list of all repositories that the current token has access to, along with the collaboration, latest
+	 * release, and the last year's worth of weekly download statistics for each.
+	 * @scope None, but an account-based token is required.
+	 */
+	public async overview() {
+		return this.client.get<RepositoryOverview[]>('/v1/repositories/overview');
+	}
+
 	/**
 	 * Gets a specific repository that the current token has access to.
 	 */

src/collections/repository/RepositoryOverview.ts

@@ -0,0 +1,28 @@
+import { Collaboration } from '../../entities/Collaboration';
+import { Release } from '../../entities/Release';
+import { Repository } from '../../entities/Repository';
+import { WeeklyDownloadCount } from '../downloads/WeeklyDownloadCount';
+
+export interface RepositoryOverview {
+
+	/**
+	 * The repository.
+	 */
+	repository: Repository;
+
+	/**
+	 * The user's collaboration for this repository.
+	 */
+	collaboration: Collaboration;
+
+	/**
+	 * The greatest published release for the repository or `undefined` if there aren't any published releases.
+	 */
+	release?: Release;
+
+	/**
+	 * The last year's worth of weekly download statistics for this repository.
+	 */
+	downloads: WeeklyDownloadCount[];
+
+}

src/index.ts

@@ -84,6 +84,7 @@ export * from './collections/repository/tokens/UpdateRepositoryTokenRequest';
 export * from './collections/repository/tokens/UpdateRepositoryTokenResponse';
 export * from './collections/repository/CreateRepositoryRequest';
 export * from './collections/repository/RepositoryWithCollaboration';
+export * from './collections/repository/RepositoryOverview';
 export * from './collections/repository/UpdateRepositoryRequest';
 
 export * from './collections/tags/CreateTagRequest';