My Jetpack: Add Backup 'needs-attention' status when backups are fail…

…ing. (#40454)

* Add red bubble alert if Backups failing.

Committed via a GitHub action: https://github.com/Automattic/jetpack/actions/runs/12405852722

Upstream-Ref: Automattic/jetpack@cff42cc

jetpack_vendor/automattic/jetpack-my-jetpack/CHANGELOG.md

@@ -13,6 +13,7 @@ This is an alpha version! The changes listed here are not final.
 - My Jetpack: add features as possible modules to the recommendations list.
 
 ### Changed
+- My Jetpack: Add 'Needs attention' status to Backup product card when Backups are failing.
 - My Jetpack: Plans section: Improvements to how we display plan expiration date.
 
 ## [5.1.2] - 2024-12-16

jetpack_vendor/automattic/jetpack-my-jetpack/build/index.asset.php

@@ -1 +1 @@
-<?php return array('dependencies' => array('jetpack-connection', 'jetpack-script-data', 'react', 'react-jsx-runtime', 'wp-api-fetch', 'wp-components', 'wp-compose', 'wp-data', 'wp-date', 'wp-element', 'wp-i18n', 'wp-polyfill', 'wp-primitives', 'wp-url'), 'version' => '4658c99dfb976436a610');
+<?php return array('dependencies' => array('jetpack-connection', 'jetpack-script-data', 'react', 'react-jsx-runtime', 'wp-api-fetch', 'wp-components', 'wp-compose', 'wp-data', 'wp-date', 'wp-element', 'wp-i18n', 'wp-polyfill', 'wp-primitives', 'wp-url'), 'version' => 'ae52d8e253d4262b5905');

jetpack_vendor/automattic/jetpack-my-jetpack/src/class-products.php

@@ -29,6 +29,7 @@ class Products {
 	const STATUS_NEEDS_PLAN                  = 'needs_plan';
 	const STATUS_NEEDS_ACTIVATION            = 'needs_activation';
 	const STATUS_NEEDS_FIRST_SITE_CONNECTION = 'needs_first_site_connection';
+	const STATUS_NEEDS_ATTENTION             = 'needs_attention';
 
 	/**
 	 * List of statuses that display the module as disabled
@@ -107,6 +108,7 @@ class Products {
 		self::STATUS_NEEDS_PLAN,
 		self::STATUS_NEEDS_ACTIVATION,
 		self::STATUS_NEEDS_FIRST_SITE_CONNECTION,
+		self::STATUS_NEEDS_ATTENTION,
 	);
 
 	/**

jetpack_vendor/automattic/jetpack-my-jetpack/src/products/class-backup.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * Boost product
+ * Backup product
  *
  * @package my-jetpack
  */
@@ -11,7 +11,6 @@
 use Automattic\Jetpack\My_Jetpack\Hybrid_Product;
 use Automattic\Jetpack\My_Jetpack\Wpcom_Products;
 use Automattic\Jetpack\Redirect;
-use Jetpack_Options;
 use WP_Error;
 
 /**
@@ -186,9 +185,15 @@ private static function get_state_from_wpcom() {
 			return $status;
 		}
 
-		$site_id = Jetpack_Options::get_option( 'id' );
+		$site_id = \Jetpack_Options::get_option( 'id' );
 
-		$response = Client::wpcom_json_api_request_as_blog( sprintf( '/sites/%d/rewind', $site_id ) . '?force=wpcom', '2', array( 'timeout' => 2 ), null, 'wpcom' );
+		$response = Client::wpcom_json_api_request_as_blog(
+			sprintf( '/sites/%d/rewind', $site_id ) . '?force=wpcom',
+			'2',
+			array( 'timeout' => 2 ),
+			null,
+			'wpcom'
+		);
 
 		if ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
 			$status = new WP_Error( 'rewind_state_fetch_failed' );
@@ -200,6 +205,90 @@ private static function get_state_from_wpcom() {
 		return $status;
 	}
 
+	/**
+	 * Hits the wpcom api to retrieve the last 10 backup records.
+	 *
+	 * @return Object|WP_Error
+	 */
+	public static function get_latest_backups() {
+		static $backups = null;
+
+		if ( $backups !== null ) {
+			return $backups;
+		}
+
+		$site_id  = \Jetpack_Options::get_option( 'id' );
+		$response = Client::wpcom_json_api_request_as_blog(
+			sprintf( '/sites/%d/rewind/backups', $site_id ) . '?force=wpcom',
+			'2',
+			array( 'timeout' => 2 ),
+			null,
+			'wpcom'
+		);
+
+		if ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
+			$backups = new WP_Error( 'rewind_backups_fetch_failed' );
+			return $backups;
+		}
+
+		$body    = wp_remote_retrieve_body( $response );
+		$backups = json_decode( $body );
+		return $backups;
+	}
+
+	/**
+	 * Determines whether the module/plugin/product needs the users attention.
+	 * Typically due to some sort of error where user troubleshooting is needed.
+	 *
+	 * @return boolean|array
+	 */
+	public static function does_module_need_attention() {
+		$backup_failed_status = false;
+		// First check the status of Rewind for failure.
+		$rewind_state = self::get_state_from_wpcom();
+		if ( ! is_wp_error( $rewind_state ) ) {
+			$backup_failure_reasons = array(
+				'unknown_error',
+				'no_site_found',
+				'missing_plan',
+				'no_connected_jetpack',
+				'no_connected_jetpack_with_credentials',
+				'multisite_not_supported',
+				'host_not_supported',
+				'vp_active_on_site',
+			);
+			if ( $rewind_state->state === 'unavailable' && ! empty( $rewind_state->reason ) && in_array( $rewind_state->reason, $backup_failure_reasons, true ) ) {
+				$backup_failed_status = array(
+					'status'       => $rewind_state->reason,
+					'last_updated' => $rewind_state->last_updated,
+				);
+			}
+		}
+		// Next check for a failed last backup.
+		$latest_backups = self::get_latest_backups();
+		if ( ! is_wp_error( $latest_backups ) ) {
+			// Get the last/latest backup record.
+			$last_backup = null;
+			foreach ( $latest_backups as $backup ) {
+				if ( $backup->is_backup ) {
+					$last_backup = $backup;
+					break;
+				}
+			}
+
+			if ( $last_backup && isset( $last_backup->status ) ) {
+				if ( $last_backup->status === 'not-accessible' || $last_backup->status === 'error' || $last_backup->status === 'credential-error' ) {
+					$backup_failed_status = array(
+						'status'       => $last_backup->status,
+						'last_updated' => $last_backup->last_updated,
+					);
+				}
+			}
+		}
+
+		return $backup_failed_status;
+	}
+
 	/**
 	 * Return product bundles list
 	 * that supports the product.

jetpack_vendor/automattic/jetpack-my-jetpack/src/products/class-product.php

@@ -10,6 +10,7 @@
 use Automattic\Jetpack\Connection\Client;
 use Automattic\Jetpack\Connection\Manager as Connection_Manager;
 use Automattic\Jetpack\Modules;
+use Automattic\Jetpack\My_Jetpack\Products\Backup;
 use Automattic\Jetpack\Plugins_Installer;
 use Automattic\Jetpack\Status;
 use Jetpack_Options;
@@ -716,6 +717,9 @@ public static function get_status() {
 			} elseif ( static::$requires_user_connection && ! ( new Connection_Manager() )->has_connected_owner() ) {
 				$status = Products::STATUS_USER_CONNECTION_ERROR;
 			} elseif ( static::has_paid_plan_for_product() ) {
+				if ( static::$slug === 'backup' && Backup::does_module_need_attention() ) {
+					$status = Products::STATUS_NEEDS_ATTENTION;
+				}
 				if ( static::is_paid_plan_expired() ) {
 					$status = Products::STATUS_EXPIRED;
 				} elseif ( static::is_paid_plan_expiring() ) {
@@ -987,4 +991,14 @@ public static function install_and_activate_standalone() {
 
 		return true;
 	}
+
+	/**
+	 * Determines whether the module/plugin/product needs the users attention.
+	 * Typically due to some sort of error where user troubleshooting is needed.
+	 *
+	 * @return boolean
+	 */
+	public static function does_module_need_attention() {
+		return false;
+	}
 }

jetpack_vendor/i18n-map.php

@@ -46,7 +46,7 @@
     ),
     'jetpack-my-jetpack' => array(
       'path' => 'jetpack_vendor/automattic/jetpack-my-jetpack',
-      'ver' => '5.2.0-alpha1734548054',
+      'ver' => '5.2.0-alpha1734579889',
     ),
     'jetpack-password-checker' => array(
       'path' => 'jetpack_vendor/automattic/jetpack-password-checker',