Phan: Address issues discovered while testing against old WooCommerce stubs (#46003)

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

Upstream-Ref: Automattic/jetpack@a0c74e4

Author: tbradsha

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.2-alpha] - unreleased
+
+This is an alpha version! The changes listed here are not final.
+
+### Fixed
+- Improve compatibility with old WooCommerce versions.
+
 ## [0.12.1] - 2025-11-19
 ### Fixed
 - Fix compatibility issue with WooCommerce older than 9.7.0. [#45988]
@@ -212,6 +219,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fix namespace issue with WooCommerce class reference. [#35857]
 - General: bail early when WooCommerce is not active. [#36278]
 
+[0.12.2-alpha]: https://github.com/Automattic/woocommerce-analytics/compare/v0.12.1...v0.12.2-alpha
 [0.12.1]: https://github.com/Automattic/woocommerce-analytics/compare/v0.12.0...v0.12.1
 [0.12.0]: https://github.com/Automattic/woocommerce-analytics/compare/v0.11.0...v0.12.0
 [0.11.0]: https://github.com/Automattic/woocommerce-analytics/compare/v0.10.1...v0.11.0

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@automattic/woocommerce-analytics",
-	"version": "0.12.1",
+	"version": "0.12.2-alpha",
 	"private": true,
 	"description": "WooCommerce Analytics package to track frontend events",
 	"homepage": "https://github.com/Automattic/jetpack/tree/HEAD/projects/packages/woocommerce-analytics/#readme",

src/class-wc-analytics-tracking.php

@@ -231,6 +231,7 @@ public static function send_batched_pixels() {
 		foreach ( self::$pixel_batch_queue as $pixel ) {
 			// Check if the method exists for backwards compatibility with older WooCommerce versions.
 			if ( method_exists( WC_Tracks_Client::class, 'add_request_timestamp_and_nocache' ) ) {
+				// @phan-suppress-current-line UnusedPluginSuppression @phan-suppress-next-line PhanUndeclaredStaticMethod -- We verify the method exists before using it. See also: https://github.com/phan/phan/issues/1204
 				$pixels_to_send[] = WC_Tracks_Client::add_request_timestamp_and_nocache( $pixel );
 			} else {
 				// Fallback for older versions - add timestamp and nocache parameters manually.
@@ -387,7 +388,7 @@ public static function get_server_details() {
 			$data = parent::get_server_details();
 		} elseif ( method_exists( WC_Site_Tracking::class, 'get_server_details' ) ) {
 			// WC < 6.8
-			$data = WC_Site_Tracking::get_server_details(); // @phan-suppress-current-line PhanUndeclaredStaticMethod -- method is available in WC < 6.8
+			$data = WC_Site_Tracking::get_server_details(); // @phan-suppress-current-line PhanUndeclaredStaticMethod -- method is available in WC < 6.8. See also: https://github.com/phan/phan/issues/1204
 		}
 
 		return array_merge(
@@ -413,7 +414,7 @@ public static function get_blog_details( $blog_id ) {
 			return parent::get_blog_details( $blog_id );
 		} elseif ( method_exists( WC_Site_Tracking::class, 'get_blog_details' ) ) {
 			// WC < 6.8
-			return WC_Site_Tracking::get_blog_details( $blog_id ); // @phan-suppress-current-line PhanUndeclaredStaticMethod -- method is available in WC < 6.8
+			return WC_Site_Tracking::get_blog_details( $blog_id ); // @phan-suppress-current-line PhanUndeclaredStaticMethod -- method is available in WC < 6.8. See also: https://github.com/phan/phan/issues/1204
 		}
 		return array();
 	}

src/class-woo-analytics-trait.php

@@ -172,6 +172,7 @@ public function find_cart_checkout_content_sources() {
 
 		$this->cart_checkout_templates_in_use = wp_is_block_theme()
 			&& class_exists( '\Automattic\WooCommerce\Blocks\Package' )
+			// @phan-suppress-current-line UnusedPluginSuppression @phan-suppress-next-line PhanUndeclaredClassMethod -- If the class exists (as of WooCommerce 8.5.0), the method exists. See also: https://github.com/phan/phan/issues/1204
 			&& version_compare( \Automattic\WooCommerce\Blocks\Package::get_version(), '10.6.0', '>=' );
 
 		// Cart/Checkout *pages* are in use if the templates are not in use. Return their content and do nothing else.
@@ -260,6 +261,7 @@ public function find_cart_checkout_content_sources() {
 	public function get_common_properties() {
 		$site_info = array(
 			'blog_id'        => Jetpack_Connection::get_site_id(),
+			// @phan-suppress-current-line UnusedPluginSuppression @phan-suppress-next-line PhanUndeclaredConstantOfClass -- The constant has only existed since WooCommerce 8.4, but we check for its existence. See also: https://github.com/phan/phan/issues/1204
 			'store_id'       => defined( '\\WC_Install::STORE_ID_OPTION' ) ? get_option( \WC_Install::STORE_ID_OPTION ) : false,
 			'ui'             => $this->get_user_id(),
 			'url'            => home_url(),

src/class-woocommerce-analytics.php

@@ -21,7 +21,7 @@ class Woocommerce_Analytics {
 	/**
 	 * Package version.
 	 */
-	const PACKAGE_VERSION = '0.12.1';
+	const PACKAGE_VERSION = '0.12.2-alpha';
 
 	/**
 	 * Proxy speed module version.