Adds Bitbucket PR commit links app not installed warning

Displays a warning message when Bitbucket PR commit links are unavailable.
This informs the user about the need to install the Bitbucket app for their commits.
(#4192, #4243)

Author: sergeibbb

package.json

@@ -4995,6 +4995,7 @@
 					"gitlens.advanced.messages": {
 						"type": "object",
 						"default": {
+							"suppressBitbucketPRCommitLinksAppNotInstalledWarning": false,
 							"suppressCommitHasNoPreviousCommitWarning": false,
 							"suppressCommitNotFoundWarning": false,
 							"suppressCreatePullRequestPrompt": false,

src/config.ts

@@ -151,6 +151,7 @@ export type StatusBarCommands =
 
 // NOTE: Must be kept in sync with `gitlens.advanced.messages` setting in the package.json
 export type SuppressedMessages =
+	| 'suppressBitbucketPRCommitLinksAppNotInstalledWarning'
 	| 'suppressCommitHasNoPreviousCommitWarning'
 	| 'suppressCommitNotFoundWarning'
 	| 'suppressCreatePullRequestPrompt'

src/messages.ts

@@ -94,6 +94,22 @@ export async function showGenericErrorMessage(message: string): Promise<void> {
 	}
 }
 
+export async function showBitbucketPRCommitLinksAppNotInstalledWarningMessage(revLink: string): Promise<void> {
+	const allowAccess = { title: 'Allow Access' };
+	const result = await showMessage(
+		'warn',
+		`GitLens cannot access Bitbucket PRs for commits.
+		Allow access by visiting [this commit](${revLink}) on Bitbucket and click “Pull requests” under the “Apps” section on the bottom right
+		or [read our docs](https://help.gitkraken.com/gitlens/gitlens-troubleshooting/#enable-showing-bitbucket-pull-request-for-a-commit) for more info.`,
+		'suppressBitbucketPRCommitLinksAppNotInstalledWarning',
+		{ title: "Don't Show Again" },
+		allowAccess,
+	);
+	if (result === allowAccess) {
+		void openUrl(revLink);
+	}
+}
+
 export function showFileNotUnderSourceControlWarningMessage(message: string): Promise<MessageItem | undefined> {
 	return showMessage(
 		'warn',

src/plus/integrations/providers/bitbucket/bitbucket.ts

@@ -19,7 +19,10 @@ import type { IssueOrPullRequest, IssueOrPullRequestType } from '../../../../git
 import type { PullRequest } from '../../../../git/models/pullRequest';
 import type { Provider } from '../../../../git/models/remoteProvider';
 import type { RepositoryMetadata } from '../../../../git/models/repositoryMetadata';
-import { showIntegrationRequestFailed500WarningMessage } from '../../../../messages';
+import {
+	showBitbucketPRCommitLinksAppNotInstalledWarningMessage,
+	showIntegrationRequestFailed500WarningMessage,
+} from '../../../../messages';
 import { configuration } from '../../../../system/-webview/configuration';
 import { debug } from '../../../../system/decorators/log';
 import { Logger } from '../../../../system/logger';
@@ -457,6 +460,16 @@ export class BitbucketApi implements Disposable {
 			if (!pr) return undefined;
 			return fromBitbucketPullRequest(pr, provider);
 		} catch (ex) {
+			if (ex.original instanceof ProviderFetchError) {
+				const json = await ex.original.response.json();
+				if (json?.error === 'Invalid or unknown installation') {
+					// TODO: In future get it on to home as an worning on the integratin istelf "this integration has issues"
+					// even user suppresses the message it's still visible with some capacity. It's a broader thing to get other errors.
+					const commitWebUrl = `https://bitbucket.org/${owner}/${repo}/commits/${rev}`;
+					void showBitbucketPRCommitLinksAppNotInstalledWarningMessage(commitWebUrl);
+					return undefined;
+				}
+			}
 			Logger.error(ex, scope);
 			return undefined;
 		}