dognose24 · Jul 2, 2026 · Jun 29, 2026 · Jun 29, 2026 · Jun 29, 2026 · Jun 29, 2026
@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Add file-downloads widget porting the Jetpack Stats File downloads module into Premium Analytics.
@@ -14,6 +14,106 @@ import type { APIFetchMiddleware, APIFetchOptions } from '@wordpress/api-fetch';
 const STATS_BASE = '/jetpack-premium-analytics/v1/proxy/v1.1/stats';
 const DAY_IN_MS = 24 * 60 * 60 * 1000;
 
+const MOCK_FILE_DOWNLOADS_FILES = [
+	{
+		relative_url: '/annual-report-2025.pdf',
+		filename: 'annual-report-2025.pdf',
+		download_url: 'https://example.com/annual-report-2025.pdf',
+		downloads: '3840',
+	},
+	{
+		relative_url: '/product-brochure.pdf',
+		filename: 'product-brochure.pdf',
+		download_url: 'https://example.com/product-brochure.pdf',
+		downloads: '2610',
+	},
+	{
+		relative_url: '/getting-started-guide.pdf',
+		filename: 'getting-started-guide.pdf',
+		download_url: 'https://example.com/getting-started-guide.pdf',
+		downloads: '1920',
+	},
+	{
+		relative_url: '/press-release-q1.docx',
+		filename: 'press-release-q1.docx',
+		download_url: 'https://example.com/press-release-q1.docx',
+		downloads: '1305',
+	},
+	{
+		relative_url: '/logo-assets.zip',
+		filename: 'logo-assets.zip',
+		download_url: 'https://example.com/logo-assets.zip',
+		downloads: '870',
+	},
+];
+
+const MOCK_FILE_DOWNLOADS_COMPARISON_FILES = [
+	{
+		relative_url: '/annual-report-2025.pdf',
+		filename: 'annual-report-2025.pdf',
+		download_url: 'https://example.com/annual-report-2025.pdf',
+		downloads: '3200',
+	},
+	{
+		relative_url: '/product-brochure.pdf',
+		filename: 'product-brochure.pdf',
+		download_url: 'https://example.com/product-brochure.pdf',
+		downloads: '2900',
+	},
+	{
+		relative_url: '/getting-started-guide.pdf',
+		filename: 'getting-started-guide.pdf',
+		download_url: 'https://example.com/getting-started-guide.pdf',
+		downloads: '1600',
+	},
+	{
+		relative_url: '/press-release-q1.docx',
+		filename: 'press-release-q1.docx',
+		download_url: 'https://example.com/press-release-q1.docx',
+		downloads: '1500',
+	},
+	{
+		relative_url: '/logo-assets.zip',
+		filename: 'logo-assets.zip',
+		download_url: 'https://example.com/logo-assets.zip',
+		downloads: '700',
+	},
+];
+
+const MOCK_FILE_DOWNLOADS = {
+	date: '2026-06-29',
+	period: 'day',
+	days: {
+		'2026-06-29': {
+			files: MOCK_FILE_DOWNLOADS_FILES,
+			other_downloads: 0,
+			total_downloads: 10545,
+		},
+	},
+	summary: {
+		files: MOCK_FILE_DOWNLOADS_FILES,
+		other_downloads: 0,
+		total_downloads: 10545,
+	},
+};
+
+const MOCK_FILE_DOWNLOADS_COMPARISON = {
+	date: '2026-05-30',
+	period: 'day',
+	days: {
+		'2026-05-30': {
+			files: MOCK_FILE_DOWNLOADS_COMPARISON_FILES,
+			other_downloads: 0,
+			total_downloads: 9900,
+		},
+	},
+	summary: {
+		files: MOCK_FILE_DOWNLOADS_COMPARISON_FILES,
+		other_downloads: 0,
+		total_downloads: 9900,
+	},
+};
+
 type UtmMock = {
 	top_utm_values: Record< string, number >;
 	top_posts: Record< string, unknown[] >;
@@ -308,7 +408,7 @@ const REGION_COMPARISON_ROWS_BY_COUNTRY: Record< string, StatsLocationItem[] > =
 
 // Heuristic: a request whose `date` param is more than 1 day ago is treated as the
 // comparison-period request. This works for the default `last-30-days` preset (primary
-// date ≈ today, comparison date ≈ 30 days ago). It would misclassify a `today` preset
+// date ~= today, comparison date ~= 30 days ago). It would misclassify a `today` preset
 // (comparison date = yesterday, daysFromToday === 1), but the stories only use the default
 // preset so this is fine in practice.
 function isComparisonRequest( path: string ): boolean {
@@ -382,10 +482,16 @@ function getStatsMock( path: string ): unknown | null {
 	const withoutBase = path.slice( STATS_BASE.length );
 	const queryIndex = withoutBase.indexOf( '?' );
 	const subPath = queryIndex === -1 ? withoutBase : withoutBase.slice( 0, queryIndex );
-	const query = new URLSearchParams( queryIndex === -1 ? '' : withoutBase.slice( queryIndex + 1 ) );
-	const locationViewsMatch = subPath.match( /^\/location-views\/(country|region|city)$/ );
 
+	if ( subPath.startsWith( '/file-downloads' ) ) {
+		return isComparisonRequest( path ) ? MOCK_FILE_DOWNLOADS_COMPARISON : MOCK_FILE_DOWNLOADS;
+	}
+
+	const locationViewsMatch = subPath.match( /^\/location-views\/(country|region|city)$/ );
 	if ( locationViewsMatch ) {
+		const query = new URLSearchParams(
+			queryIndex === -1 ? '' : withoutBase.slice( queryIndex + 1 )
+		);
 		return buildStatsLocationViewsResponse(
 			locationViewsMatch[ 1 ] as GeoMode,
 			query,

@@ -240,6 +240,21 @@ function seed_default_dashboard_layout( $dashboard_layout, $dashboard_name = ''
 		);
 	}
 
+	if ( ! in_array( 'default-file-downloads-widget-instance', $uuids, true ) ) {
+		$dashboard_layout[] = array(
+			'uuid'       => 'default-file-downloads-widget-instance',
+			'type'       => 'jpa/file-downloads',
+			'attributes' => array(
+				'max' => 10,
+			),
+			'placement'  => array(
+				'width'  => 1,
+				'height' => 2,
+				'order'  => 6,
+			),
+		);
+	}
+
 	return $dashboard_layout;
 }
 add_filter( DASHBOARD_DEFAULT_LAYOUT_FILTER, __NAMESPACE__ . '\\seed_default_dashboard_layout', 10, 2 );
@@ -31,7 +31,7 @@ public function test_seed_default_dashboard_layout_ignores_other_dashboards() {
 	}
 
 	/**
-	 * The Premium Analytics dashboard receives the bundled default widgets.
+	 * The Premium Analytics dashboard receives the UTM Insights widget.
 	 */
 	public function test_seed_default_dashboard_layout_adds_utm_insights_widget() {
 		$layout          = seed_default_dashboard_layout( array(), DASHBOARD_NAME );
@@ -60,6 +60,33 @@ public function test_seed_default_dashboard_layout_adds_utm_insights_widget() {
 		);
 	}
 
+	/**
+	 * The Premium Analytics dashboard receives the File Downloads widget.
+	 */
+	public function test_seed_default_dashboard_layout_adds_file_downloads_widget() {
+		$layout                     = seed_default_dashboard_layout( array(), DASHBOARD_NAME );
+		$layout_by_uuid             = array_column( $layout, null, 'uuid' );
+		$file_downloads_widget_uuid = 'default-file-downloads-widget-instance';
+
+		$this->assertArrayHasKey( $file_downloads_widget_uuid, $layout_by_uuid );
+
+		$this->assertSame(
+			array(
+				'uuid'       => $file_downloads_widget_uuid,
+				'type'       => 'jpa/file-downloads',
+				'attributes' => array(
+					'max' => 10,
+				),
+				'placement'  => array(
+					'width'  => 1,
+					'height' => 2,
+					'order'  => 6,
+				),
+			),
+			$layout_by_uuid[ $file_downloads_widget_uuid ]
+		);
+	}
+
 	/**
 	 * An existing UTM Insights default instance is not duplicated.
 	 */
@@ -79,4 +106,31 @@ static function ( $widget ) {
 
 		$this->assertCount( 1, $utm_widgets );
 	}
+
+	/**
+	 * An existing File Downloads default instance is not duplicated.
+	 */
+	public function test_seed_default_dashboard_layout_does_not_duplicate_file_downloads_widget() {
+		$existing_file_downloads_widget = array(
+			'uuid'       => 'default-file-downloads-widget-instance',
+			'type'       => 'jpa/file-downloads',
+			'attributes' => array( 'max' => 5 ),
+			'placement'  => array(
+				'width'  => 2,
+				'height' => 1,
+				'order'  => 9,
+			),
+		);
+
+		$layout                 = seed_default_dashboard_layout( array( $existing_file_downloads_widget ), DASHBOARD_NAME );
+		$file_downloads_widgets = array_filter(
+			$layout,
+			static function ( $widget ) {
+				return 'default-file-downloads-widget-instance' === $widget['uuid'];
+			}
+		);
+
+		$this->assertCount( 1, $file_downloads_widgets );
+		$this->assertSame( $existing_file_downloads_widget, reset( $file_downloads_widgets ) );
+	}
 }
@@ -0,0 +1,14 @@
+{
+	"name": "@automattic/jetpack-premium-analytics-widget-file-downloads",
+	"version": "0.1.0-alpha",
+	"private": true,
+	"type": "module",
+	"dependencies": {
+		"@jetpack-premium-analytics/data": "link:../../packages/data",
+		"@jetpack-premium-analytics/widgets-toolkit": "link:../../packages/widgets-toolkit",
+		"@wordpress/i18n": "^6.9.0",
+		"@wordpress/icons": "^13.0.0",
+		"@wordpress/ui": "0.13.0",
+		"@wordpress/widget-primitives": "next"
+	}
+}