Premium Analytics: add Stats app publish state endpoint

projects/packages/premium-analytics/changelog/add-stats-app-site-published-state-endpoint

@@ -0,0 +1,4 @@
+Significance: patch
+Type: added
+
+Stats: Add app publish state hook.

projects/packages/premium-analytics/packages/data/src/hooks/__tests__/stats-exports.test.ts

@@ -30,6 +30,7 @@ const statsHookNames = [
 	'useStatsHighlights',
 	'useStatsTags',
 	'useStatsDevices',
+	'useStatsAppSiteHasNeverPublishedPost',
 ] as const satisfies ReadonlyArray< keyof typeof dataPackage >;
 
 describe( 'Stats public hook names', () => {

projects/packages/premium-analytics/packages/data/src/hooks/index.ts

@@ -79,6 +79,11 @@ export {
 	type StatsDevicesDeviceParam,
 	type StatsDevicesParams,
 } from './use-stats-devices';
+export {
+	useStatsAppSiteHasNeverPublishedPost,
+	type StatsAppSiteHasNeverPublishedPostParams,
+	type StatsAppSiteHasNeverPublishedPostResponse,
+} from './use-stats-app-site-has-never-published-post';
 export type { UseStatsOptions } from './use-stats-report';
 
 /**

projects/packages/premium-analytics/packages/data/src/hooks/use-stats-app-site-has-never-published-post.ts

@@ -0,0 +1,18 @@
+/**
+ * Internal dependencies
+ */
+import { statsAppSiteHasNeverPublishedPostQuery } from '../queries/stats-app-site-has-never-published-post-query';
+import { useStatsAppQuery, type UseStatsAppOptions } from './use-stats-app-query';
+import type { StatsAppSiteHasNeverPublishedPostParams } from '../queries/stats-app-site-has-never-published-post-query';
+
+export type {
+	StatsAppSiteHasNeverPublishedPostParams,
+	StatsAppSiteHasNeverPublishedPostResponse,
+} from '../queries/stats-app-site-has-never-published-post-query';
+
+export function useStatsAppSiteHasNeverPublishedPost(
+	params: StatsAppSiteHasNeverPublishedPostParams,
+	options?: UseStatsAppOptions
+) {
+	return useStatsAppQuery( statsAppSiteHasNeverPublishedPostQuery( params ), options );
+}

projects/packages/premium-analytics/packages/data/src/index.ts

@@ -85,6 +85,11 @@ export {
 	type StatsDevicesDeviceParam,
 	type StatsDevicesParams,
 } from './hooks/use-stats-devices';
+export {
+	useStatsAppSiteHasNeverPublishedPost,
+	type StatsAppSiteHasNeverPublishedPostParams,
+	type StatsAppSiteHasNeverPublishedPostResponse,
+} from './hooks/use-stats-app-site-has-never-published-post';
 export type { UseStatsOptions } from './hooks/use-stats-report';
 export { prefetchReport } from './prefetch';
 export {

projects/packages/premium-analytics/packages/data/src/queries/__tests__/stats-queries.test.ts

@@ -2,6 +2,7 @@
  * Internal dependencies
  */
 import { statsAppProxyQuery } from '../stats-app-query';
+import { statsAppSiteHasNeverPublishedPostQuery } from '../stats-app-site-has-never-published-post-query';
 import { statsArchivesQuery } from '../stats-archives-query';
 import { statsCommentsQuery } from '../stats-comments-query';
 import { statsDevicesQuery } from '../stats-devices-query';
@@ -528,4 +529,18 @@ describe( 'Stats query factories', () => {
 	it( 'disables streak queries until start and end dates are available', () => {
 		expect( statsStreakQuery( {} as StatsReportParams ).enabled ).toBe( false );
 	} );
+
+	it( 'builds the published state query against the WPCOM proxy endpoint', () => {
+		expect( statsAppSiteHasNeverPublishedPostQuery( { 'include-pages': true } ).queryKey ).toEqual(
+			[
+				'stats-app',
+				'site-has-never-published-post',
+				'2',
+				'site-has-never-published-post',
+				'GET',
+				{ 'include-pages': true },
+				{},
+			]
+		);
+	} );
 } );

projects/packages/premium-analytics/packages/data/src/queries/index.ts

@@ -40,3 +40,8 @@ export { statsUtmQuery } from './stats-utm-query';
 export { statsHighlightsQuery } from './stats-highlights-query';
 export { statsTagsQuery } from './stats-tags-query';
 export { statsDevicesQuery } from './stats-devices-query';
+export {
+	statsAppSiteHasNeverPublishedPostQuery,
+	type StatsAppSiteHasNeverPublishedPostParams,
+	type StatsAppSiteHasNeverPublishedPostResponse,
+} from './stats-app-site-has-never-published-post-query';

projects/packages/premium-analytics/packages/data/src/queries/stats-app-site-has-never-published-post-query.ts

@@ -0,0 +1,20 @@
+/**
+ * Internal dependencies
+ */
+import { statsAppProxyQuery } from './stats-app-query';
+
+export type StatsAppSiteHasNeverPublishedPostParams = {
+	'include-pages': boolean;
+};
+
+export type StatsAppSiteHasNeverPublishedPostResponse = boolean;
+
+export const statsAppSiteHasNeverPublishedPostQuery = (
+	params: StatsAppSiteHasNeverPublishedPostParams
+) =>
+	statsAppProxyQuery< StatsAppSiteHasNeverPublishedPostResponse >( {
+		name: 'site-has-never-published-post',
+		version: '2',
+		endpoint: 'site-has-never-published-post',
+		params,
+	} );