From 57ad208c8547fd591c33bed863c49e56c8a1cdb5 Mon Sep 17 00:00:00 2001
From: Patrick Jungermann <Patrick.Jungermann@gmail.com>
Date: Tue, 8 Apr 2025 02:41:37 +0200
Subject: [PATCH] feat: add support for Bitbucket Cloud `repo:updated` events

Add support for `repo:updated` events as `Events.RepoUpdatedEvent`.

Signed-off-by: Patrick Jungermann <Patrick.Jungermann@gmail.com>
---
 .changeset/icy-mugs-glow.md                   |  5 ++++
 plugins/bitbucket-cloud-common/report.api.md  | 29 +++++++++++++++++++
 .../src/events/index.ts                       | 23 +++++++++++++++
 3 files changed, 57 insertions(+)
 create mode 100644 .changeset/icy-mugs-glow.md

diff --git a/.changeset/icy-mugs-glow.md b/.changeset/icy-mugs-glow.md
new file mode 100644
index 0000000000..553daff24a
--- /dev/null
+++ b/.changeset/icy-mugs-glow.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-bitbucket-cloud-common': patch
+---
+
+Add support for `repo:updated` events as `Events.RepoUpdatedEvent`.
diff --git a/plugins/bitbucket-cloud-common/report.api.md b/plugins/bitbucket-cloud-common/report.api.md
index 8d2bd820f6..c53863b92f 100644
--- a/plugins/bitbucket-cloud-common/report.api.md
+++ b/plugins/bitbucket-cloud-common/report.api.md
@@ -70,6 +70,30 @@ export namespace Events {
     html: Models.Link;
   }
   // (undocumented)
+  export interface RepoChange<T> {
+    // (undocumented)
+    new: T;
+    // (undocumented)
+    old: T;
+  }
+  // (undocumented)
+  export interface RepoChanges {
+    // (undocumented)
+    description?: RepoChange<string>;
+    // (undocumented)
+    full_name?: RepoChange<string>;
+    // (undocumented)
+    language?: RepoChange<string>;
+    // (undocumented)
+    links?: RepoChange<
+      Pick<Models.RepositoryLinks, 'avatar' | 'html' | 'self'>
+    >;
+    // (undocumented)
+    name?: RepoChange<string>;
+    // (undocumented)
+    website?: RepoChange<string>;
+  }
+  // (undocumented)
   export interface RepoEvent {
     // (undocumented)
     actor: Models.Account;
@@ -88,6 +112,11 @@ export namespace Events {
     // (undocumented)
     push: RepoPush;
   }
+  // (undocumented)
+  export interface RepoUpdatedEvent extends RepoEvent {
+    // (undocumented)
+    changes: RepoChanges;
+  }
 }
 
 // @public (undocumented)
diff --git a/plugins/bitbucket-cloud-common/src/events/index.ts b/plugins/bitbucket-cloud-common/src/events/index.ts
index 53658be032..5058ef5230 100644
--- a/plugins/bitbucket-cloud-common/src/events/index.ts
+++ b/plugins/bitbucket-cloud-common/src/events/index.ts
@@ -30,6 +30,29 @@ export namespace Events {
     push: RepoPush;
   }
 
+  /** @public */
+  export interface RepoUpdatedEvent extends RepoEvent {
+    changes: RepoChanges;
+  }
+
+  /** @public */
+  export interface RepoChanges {
+    description?: RepoChange<string>;
+    full_name?: RepoChange<string>;
+    language?: RepoChange<string>;
+    links?: RepoChange<
+      Pick<Models.RepositoryLinks, 'avatar' | 'html' | 'self'>
+    >;
+    name?: RepoChange<string>;
+    website?: RepoChange<string>;
+  }
+
+  /** @public */
+  export interface RepoChange<T> {
+    new: T;
+    old: T;
+  }
+
   /** @public */
   export interface RepoPush {
     changes: Change[];