feat: add backups list method

Author: joaotonaco

.changeset/hungry-planes-heal.md

@@ -0,0 +1,5 @@
+---
+"@squarecloud/api": minor
+---
+
+New `Application#backups#list` method for listing snapshots

src/managers/application/backup.ts

@@ -1,28 +1,39 @@
 import { type Application, SquareCloudAPIError } from "@/index";
 import { Routes } from "@/lib/routes";
-import type { RESTPostAPIApplicationBackupResult } from "@squarecloud/api-types/v2";
+import type {
+	APIApplicationBackup,
+	RESTPostAPIApplicationBackupResult,
+} from "@squarecloud/api-types/v2";
 
 export class ApplicationBackupManager {
 	constructor(public readonly application: Application) {}
 
-	/** @returns The generated backup URL */
-	async create(): Promise<RESTPostAPIApplicationBackupResult> {
+	async list(): Promise<APIApplicationBackup[]> {
 		const data = await this.application.client.api.request(
-			Routes.apps.generateBackup(this.application.id),
-			{ method: "POST" },
+			Routes.apps.backups(this.application.id),
 		);
 
-		const backup = data.response;
+		const backups = data.response;
 
 		this.application.client.emit(
-			"backupUpdate",
+			"backupsUpdate",
 			this.application,
-			this.application.cache.backup,
-			backup,
+			this.application.cache.backups,
+			backups,
+		);
+		this.application.cache.set("backups", backups);
+
+		return backups;
+	}
+
+	/** @returns The generated backup URL */
+	async create(): Promise<RESTPostAPIApplicationBackupResult> {
+		const data = await this.application.client.api.request(
+			Routes.apps.generateBackup(this.application.id),
+			{ method: "POST" },
 		);
-		this.application.cache.set("backup", backup);
 
-		return backup;
+		return data.response;
 	}
 
 	/** @returns The generated backup buffer */

src/managers/application/cache.ts

@@ -1,11 +1,11 @@
 import type { ApplicationStatus } from "@/structures";
-import type { RESTPostAPIApplicationBackupResult } from "@squarecloud/api-types/v2";
+import type { APIApplicationBackup } from "@squarecloud/api-types/v2";
 
-export type ApplicationCacheKey = "status" | "backup" | "logs";
+export type ApplicationCacheKey = "status" | "backups" | "logs";
 
 export class ApplicationCacheManager {
 	readonly status?: ApplicationStatus;
-	readonly backup?: RESTPostAPIApplicationBackupResult;
+	readonly backups?: APIApplicationBackup[];
 	readonly logs?: string;
 
 	set<T extends ApplicationCacheKey>(

src/types/client.ts

@@ -1,5 +1,5 @@
 import EventEmitter from "events";
-import type { RESTPostAPIApplicationBackupResult } from "@squarecloud/api-types/v2";
+import type { APIApplicationBackup } from "@squarecloud/api-types/v2";
 import type { Application, ApplicationStatus, User } from "..";
 
 export class TypedEventEmitter<TEvents extends Record<string, any>> {
@@ -33,10 +33,10 @@ export interface ClientEvents {
 		before: string | undefined,
 		after: string,
 	];
-	backupUpdate: [
+	backupsUpdate: [
 		application: Application,
-		before: RESTPostAPIApplicationBackupResult | undefined,
-		after: RESTPostAPIApplicationBackupResult,
+		before: APIApplicationBackup[] | undefined,
+		after: APIApplicationBackup[],
 	];
 	statusUpdate: [
 		application: Application,