@automattic/data-stores 3.1.1 → 3.1.2

package/src/help-center/actions.ts

@@ -1,11 +1,9 @@
 import { default as apiFetchPromise } from '@wordpress/api-fetch';
 import { select } from '@wordpress/data';
-import { apiFetch } from '@wordpress/data-controls';
 import { addQueryArgs } from '@wordpress/url';
 import { default as wpcomRequestPromise, canAccessWpcomApis } from 'wpcom-proxy-request';
 import { GeneratorReturnType } from '../mapped-types';
 import { SiteDetails } from '../site';
-import { wpcomRequest } from '../wpcom-request-controls';
 import { STORE_KEY } from './constants';
 import { isE2ETest } from '.';
 import type {
@@ -15,37 +13,7 @@ import type {
 	HelpCenterShowOptions,
 } from './types';
 import type { SupportInteraction } from '@automattic/odie-client/src/types';
-
-export const receiveHasSeenWhatsNewModal = ( value: boolean | undefined ) =>
-	( {
-		type: 'HELP_CENTER_SET_SEEN_WHATS_NEW_MODAL',
-		value,
-	} ) as const;
-
-export function* setHasSeenWhatsNewModal( value: boolean ) {
-	let response: {
-		has_seen_whats_new_modal: boolean;
-	};
-	if ( canAccessWpcomApis() ) {
-		response = yield wpcomRequest( {
-			path: '/block-editor/has-seen-whats-new-modal',
-			apiNamespace: 'wpcom/v2',
-			method: 'PUT',
-			body: {
-				has_seen_whats_new_modal: value,
-			},
-		} );
-	} else {
-		response = yield apiFetch( {
-			global: true,
-			path: '/wpcom/v2/block-editor/has-seen-whats-new-modal',
-			method: 'PUT',
-			data: { has_seen_whats_new_modal: value },
-		} as APIFetchOptions );
-	}
-
-	return receiveHasSeenWhatsNewModal( response.has_seen_whats_new_modal );
-}
+import type { Location } from 'history';
 
 export function setCurrentSupportInteraction( supportInteraction: SupportInteraction ) {
 	return {
@@ -54,6 +22,15 @@ export function setCurrentSupportInteraction( supportInteraction: SupportInterac
 	} as const;
 }
 
+export function setHelpCenterRouterHistory(
+	history: { entries: Location[]; index: number } | undefined
+) {
+	return {
+		type: 'HELP_CENTER_SET_HELP_CENTER_ROUTER_HISTORY',
+		history,
+	} as const;
+}
+
 export const setNavigateToRoute = ( route?: string ) =>
 	( {
 		type: 'HELP_CENTER_SET_NAVIGATE_TO_ROUTE',
@@ -120,6 +97,12 @@ export const setMessage = ( message: string ) =>
 		message,
 	} ) as const;
 
+export const setContextTerm = ( contextTerm: string ) =>
+	( {
+		type: 'HELP_CENTER_SET_CONTEXT_TERM',
+		contextTerm,
+	} ) as const;
+
 export const setAllowPremiumSupport = ( allow: boolean ) =>
 	( {
 		type: 'HELP_CENTER_SET_ALLOW_PREMIUM_SUPPORT',
@@ -134,7 +117,7 @@ export const setHelpCenterOptions = ( options: HelpCenterOptions ) => ( {
 export const setShowHelpCenter = function* (
 	show: boolean,
 	allowPremiumSupport = false,
-	options: HelpCenterShowOptions = { hideBackButton: false, searchTerm: '' }
+	options: HelpCenterShowOptions = { hideBackButton: false, contextTerm: '' }
 ): Generator< unknown, { type: 'HELP_CENTER_SET_SHOW'; show: boolean }, unknown > {
 	const isMinimized = ( select( STORE_KEY ) as HelpCenterSelect ).getIsMinimized();
 
@@ -155,7 +138,11 @@ export const setShowHelpCenter = function* (
 				apiNamespace: 'wpcom/v2',
 				method: 'PUT',
 				body: {
-					calypso_preferences: { help_center_open: show },
+					calypso_preferences: {
+						help_center_open: show,
+						// Delete the remote version of the navigation history when closing the help center
+						...( ! show ? { help_center_router_history: null } : {} ),
+					},
 				},
 			} ).catch( () => {} );
 		} else {
@@ -164,18 +151,23 @@ export const setShowHelpCenter = function* (
 				global: true,
 				path: '/help-center/open-state',
 				method: 'PUT',
-				data: { help_center_open: show },
+				data: {
+					help_center_open: show, // Delete the remote version of the navigation history when closing the help center
+					...( ! show ? { help_center_router_history: null } : {} ),
+				},
 			} as APIFetchOptions ).catch( () => {} );
 		}
 	}
 
 	if ( ! show ) {
 		yield setNavigateToRoute( undefined );
+		// Reset the local navigation history when closing the help center
+		yield setHelpCenterRouterHistory( undefined );
 	} else {
 		yield setShowMessagingWidget( false );
 	}
 
-	yield setMessage( options?.searchTerm || '' );
+	yield setContextTerm( options?.contextTerm || '' );
 	yield setIsMinimized( false );
 
 	if ( allowPremiumSupport ) {
@@ -220,11 +212,13 @@ export const setNewMessagingChat = function* ( {
 	section,
 	siteUrl,
 	siteId,
+	userFieldFlowName,
 }: {
 	initialMessage: string;
 	section?: string;
 	siteUrl?: string;
 	siteId?: string;
+	userFieldFlowName?: string;
 } ) {
 	const url = addQueryArgs( '/odie', {
 		provider: 'zendesk',
@@ -232,11 +226,17 @@ export const setNewMessagingChat = function* ( {
 		section,
 		siteUrl,
 		siteId,
+		userFieldFlowName,
 	} );
 	yield setNavigateToRoute( url );
 	yield setShowHelpCenter( true );
 };
 
+export const setNavigateToOdie = function* () {
+	yield setNavigateToRoute( '/odie' );
+	yield setShowHelpCenter( true );
+};
+
 export const setShowSupportDoc = function* ( link: string, postId?: number, blogId?: number ) {
 	const params = new URLSearchParams( {
 		link,
@@ -255,12 +255,13 @@ export type HelpCenterAction =
 			| typeof setShowMessagingWidget
 			| typeof setSubject
 			| typeof resetStore
-			| typeof receiveHasSeenWhatsNewModal
 			| typeof setMessage
+			| typeof setContextTerm
 			| typeof setUserDeclaredSite
 			| typeof setUserDeclaredSiteUrl
 			| typeof setUnreadCount
 			| typeof setIsMinimized
+			| typeof setHelpCenterRouterHistory
 			| typeof setIsChatLoaded
 			| typeof setAreSoundNotificationsEnabled
 			| typeof setZendeskClientId
@@ -271,4 +272,4 @@ export type HelpCenterAction =
 			| typeof setAllowPremiumSupport
 			| typeof setHelpCenterOptions
 	  >
-	| GeneratorReturnType< typeof setShowHelpCenter | typeof setHasSeenWhatsNewModal >;
+	| GeneratorReturnType< typeof setShowHelpCenter >;

package/src/help-center/index.ts

@@ -9,7 +9,9 @@ import { isHelpCenterShown } from './resolvers';
 import * as selectors from './selectors';
 export type { State };
 
-declare const helpCenterData: { isProxied: boolean } | undefined;
+declare const helpCenterData: { isProxied: boolean; isSU: boolean; isSSP: boolean } | undefined;
+declare const isSupportSession: boolean;
+declare const isSSP: boolean;
 
 let isRegistered = false;
 
@@ -19,10 +21,9 @@ const E2E_USER_AGENT = 'wp-e2e-tests';
 export const isE2ETest = () =>
 	typeof window !== 'undefined' && window.navigator.userAgent.includes( E2E_USER_AGENT );
 
-export const isSupportSession = () => {
+export const isInSupportSession = () => {
 	if ( typeof window !== 'undefined' ) {
 		return (
-			'disableHelpCenterAutoOpen' in window ||
 			// A bit hacky but much easier than passing down data from PHP in Jetpack
 			// Simple
 			!! document.querySelector( '#wp-admin-bar-support-session-details' ) ||
@@ -30,16 +31,17 @@ export const isSupportSession = () => {
 			// Atomic
 			document.body.classList.contains( 'support-session' ) ||
 			document.querySelector( '#wpcom > .is-support-session' ) ||
-			// Our failover last hope, don't re-open when proxied.
-			// This is not the same `window.helpCenterData`, because it's defined as `const helpCenterData`
-			( typeof helpCenterData !== 'undefined' && helpCenterData?.isProxied )
+			( typeof isSupportSession !== 'undefined' && !! isSupportSession ) ||
+			( typeof helpCenterData !== 'undefined' && helpCenterData?.isSU ) ||
+			( typeof helpCenterData !== 'undefined' && helpCenterData?.isSSP ) ||
+			( typeof isSSP !== 'undefined' && !! isSSP )
 		);
 	}
 	return false;
 };
 
 export function register(): typeof STORE_KEY {
-	const enabledPesistedOpenState = ! isE2ETest() && ! isSupportSession();
+	const enabledPersistedOpenState = ! isE2ETest() && ! isInSupportSession();
 
 	registerPlugins();
 
@@ -51,7 +53,7 @@ export function register(): typeof STORE_KEY {
 			selectors,
 			persist: [ 'message', 'userDeclaredSite', 'userDeclaredSiteUrl', 'subject' ],
 			// Don't persist the open state for e2e users, because parallel tests will start interfering with each other.
-			resolvers: enabledPesistedOpenState ? { isHelpCenterShown } : undefined,
+			resolvers: enabledPersistedOpenState ? { isHelpCenterShown } : undefined,
 		} );
 		isRegistered = true;
 	}

package/src/help-center/reducer.ts

@@ -3,6 +3,7 @@ import { SiteDetails } from '../site';
 import type { HelpCenterAction } from './actions';
 import type { HelpCenterOptions } from './types';
 import type { SupportInteraction } from '@automattic/odie-client/src/types';
+import type { Location } from 'history';
 import type { Reducer } from 'redux';
 
 const showHelpCenter: Reducer< boolean | undefined, HelpCenterAction > = ( state, action ) => {
@@ -24,21 +25,21 @@ const showMessagingLauncher: Reducer< boolean | undefined, HelpCenterAction > =
 	return state;
 };
 
-const showMessagingWidget: Reducer< boolean | undefined, HelpCenterAction > = ( state, action ) => {
+const helpCenterRouterHistory: Reducer<
+	{ entries: Location[]; index: number } | undefined,
+	HelpCenterAction
+> = ( state, action ) => {
 	switch ( action.type ) {
-		case 'HELP_CENTER_SET_SHOW_MESSAGING_WIDGET':
-			return action.show;
+		case 'HELP_CENTER_SET_HELP_CENTER_ROUTER_HISTORY':
+			return action.history;
 	}
 	return state;
 };
 
-const hasSeenWhatsNewModal: Reducer< boolean | undefined, HelpCenterAction > = (
-	state,
-	action
-) => {
+const showMessagingWidget: Reducer< boolean | undefined, HelpCenterAction > = ( state, action ) => {
 	switch ( action.type ) {
-		case 'HELP_CENTER_SET_SEEN_WHATS_NEW_MODAL':
-			return action.value;
+		case 'HELP_CENTER_SET_SHOW_MESSAGING_WIDGET':
+			return action.show;
 	}
 	return state;
 };
@@ -168,6 +169,13 @@ const allowPremiumSupport: Reducer< boolean, HelpCenterAction > = ( state = fals
 	return state;
 };
 
+const contextTerm: Reducer< string | undefined, HelpCenterAction > = ( state, action ) => {
+	if ( action.type === 'HELP_CENTER_SET_CONTEXT_TERM' ) {
+		return action.contextTerm;
+	}
+	return state;
+};
+
 const helpCenterOptions: Reducer< HelpCenterOptions, HelpCenterAction > = (
 	state = {},
 	action
@@ -187,7 +195,6 @@ const reducer = combineReducers( {
 	message,
 	userDeclaredSite,
 	userDeclaredSiteUrl,
-	hasSeenWhatsNewModal,
 	isMinimized,
 	isChatLoaded,
 	areSoundNotificationsEnabled,
@@ -196,7 +203,9 @@ const reducer = combineReducers( {
 	navigateToRoute,
 	odieInitialPromptText,
 	odieBotNameSlug,
+	helpCenterRouterHistory,
 	allowPremiumSupport,
+	contextTerm,
 	helpCenterOptions,
 } );
 

package/src/help-center/resolvers.ts

@@ -1,12 +1,18 @@
 import { apiFetch } from '@wordpress/data-controls';
 import { canAccessWpcomApis } from 'wpcom-proxy-request';
 import { wpcomRequest } from '../wpcom-request-controls';
+import { setHelpCenterRouterHistory } from './actions';
 import type { APIFetchOptions } from './types';
+import type { Location } from 'history';
 
 export function* isHelpCenterShown() {
 	try {
 		const preferences: {
 			help_center_open: boolean;
+			help_center_router_history: {
+				entries: Location[];
+				index: number;
+			};
 		} = canAccessWpcomApis()
 			? yield wpcomRequest( {
 					path: '/me/preferences',
@@ -17,6 +23,10 @@ export function* isHelpCenterShown() {
 					path: '/help-center/open-state',
 			  } as APIFetchOptions );
 
+		if ( preferences.help_center_router_history ) {
+			yield setHelpCenterRouterHistory( preferences.help_center_router_history );
+		}
+
 		// We only want to auto-open, we don't want to auto-close (and potentially overrule the user's action).
 		if ( preferences.help_center_open ) {
 			return {

package/src/help-center/selectors.ts

@@ -13,10 +13,11 @@ export const getIsChatLoaded = ( state: State ) => state.isChatLoaded;
 export const getAreSoundNotificationsEnabled = ( state: State ) =>
 	state.areSoundNotificationsEnabled;
 export const getZendeskClientId = ( state: State ) => state.zendeskClientId;
-export const getHasSeenWhatsNewModal = ( state: State ) => state.hasSeenWhatsNewModal;
+export const getHelpCenterRouterHistory = ( state: State ) => state.helpCenterRouterHistory;
 export const getNavigateToRoute = ( state: State ) => state.navigateToRoute;
 export const getOdieInitialPromptText = ( state: State ) => state.odieInitialPromptText;
 export const getOdieBotNameSlug = ( state: State ) => state.odieBotNameSlug;
 export const getCurrentSupportInteraction = ( state: State ) => state.currentSupportInteraction;
 export const getAllowPremiumSupport = ( state: State ) => state.allowPremiumSupport;
 export const getHelpCenterOptions = ( state: State ) => state.helpCenterOptions;
+export const getContextTerm = ( state: State ) => state.contextTerm;

package/src/help-center/types.ts

@@ -11,7 +11,7 @@ export type Location = {
 };
 export interface HelpCenterShowOptions {
 	hideBackButton: boolean;
-	searchTerm: string;
+	contextTerm: string;
 }
 export interface SiteLogo {
 	id: number;
@@ -32,6 +32,7 @@ export interface HelpCenterSite {
 	is_wpcom_atomic: boolean;
 	jetpack: boolean;
 	logo: SiteLogo;
+	site_owner: number;
 	options: {
 		launchpad_screen: string;
 		site_intent: string;

package/src/index.ts

@@ -1,5 +1,4 @@
 import * as AddOns from './add-ons';
-import * as Analyzer from './analyzer';
 import * as DomainSuggestions from './domain-suggestions';
 import * as HelpCenter from './help-center';
 import * as Onboard from './onboard';
@@ -38,7 +37,6 @@ const { SubscriptionManager } = Reader;
 
 export {
 	AddOns,
-	Analyzer,
 	User,
 	DomainSuggestions,
 	HelpCenter,
@@ -63,9 +61,14 @@ export type { Section } from './contextual-help/contextual-help';
 export { generateAdminSections } from './contextual-help/admin-sections';
 export type { LinksForSection } from './contextual-help/contextual-help';
 export * from './contextual-help/constants';
-export type { HelpCenterSite, HelpCenterSelect } from './help-center/types';
+export type {
+	HelpCenterSite,
+	HelpCenterSelect,
+	Dispatch as HelpCenterDispatch,
+} from './help-center/types';
 export type { OnboardSelect, OnboardActions } from './onboard';
 export type { StepperInternalSelect } from './stepper-internal';
 export type { SiteActions } from './site';
 export type { UserActions } from './user';
 export type { Member, UseQuery, UsersQuery } from './users/types';
+export { isInSupportSession } from './help-center';

package/src/newsletter-categories/test/index.tsx

@@ -14,7 +14,7 @@ describe( 'useNewsletterCategories', () => {
 	let wrapper: React.FC< { children: React.ReactNode } >;
 
 	beforeEach( () => {
-		( request as jest.MockedFunction< typeof request > ).mockReset();
+		jest.mocked( request ).mockReset();
 
 		queryClient = new QueryClient( {
 			defaultOptions: {
@@ -34,7 +34,7 @@ describe( 'useNewsletterCategories', () => {
 	} );
 
 	it( 'should return expected data when successful', async () => {
-		( request as jest.MockedFunction< typeof request > ).mockResolvedValue( {
+		jest.mocked( request ).mockResolvedValue( {
 			enabled: true,
 			newsletter_categories: [
 				{ id: 1, name: 'Category 1', slug: 'Slug 1', description: 'Description 1', parent: 1 },
@@ -56,7 +56,7 @@ describe( 'useNewsletterCategories', () => {
 	} );
 
 	it( 'should handle empty response', async () => {
-		( request as jest.MockedFunction< typeof request > ).mockResolvedValue( {
+		jest.mocked( request ).mockResolvedValue( {
 			enabled: false,
 			newsletter_categories: [],
 		} );
@@ -69,7 +69,7 @@ describe( 'useNewsletterCategories', () => {
 	} );
 
 	it( 'should call request with correct arguments', async () => {
-		( request as jest.MockedFunction< typeof request > ).mockResolvedValue( {
+		jest.mocked( request ).mockResolvedValue( {
 			enabled: true,
 			newsletter_categories: [],
 		} );
@@ -88,9 +88,7 @@ describe( 'useNewsletterCategories', () => {
 
 	it( 'should handle error response', async () => {
 		const errorMessage = 'API Error';
-		( request as jest.MockedFunction< typeof request > ).mockRejectedValue(
-			new Error( errorMessage )
-		);
+		jest.mocked( request ).mockRejectedValue( new Error( errorMessage ) );
 
 		const { result } = renderHook( () => useNewsletterCategories( { siteId: 123 } ), { wrapper } );
 

package/src/onboard/actions.ts

@@ -34,19 +34,6 @@ export const setSiteUrl = ( siteUrl: string ) => ( {
 	siteUrl,
 } );
 
-export interface CreateSiteBaseActionParameters {
-	username: string;
-	languageSlug: string;
-	visibility: number;
-}
-
-export interface CreateSiteActionParameters extends CreateSiteBaseActionParameters {
-	bearerToken?: string;
-	anchorFmPodcastId: string | null;
-	anchorFmEpisodeId: string | null;
-	anchorFmSpotifyUrl: string | null;
-}
-
 export function* createSenseiSite( {
 	username = '',
 	languageSlug = '',
@@ -356,11 +343,6 @@ export const setHidePlansFeatureComparison = ( hidePlansFeatureComparison: boole
 	hidePlansFeatureComparison,
 } );
 
-export const setIsMigrateFromWp = ( isMigrateFromWp: boolean ) => ( {
-	type: 'SET_IS_MIGRATE_FROM_WP' as const,
-	isMigrateFromWp,
-} );
-
 export const setPluginsToVerify = ( pluginSlugs: string[] ) => ( {
 	type: 'SET_PLUGIN_SLUGS_TO_VERIFY' as const,
 	pluginSlugs,
@@ -381,11 +363,6 @@ export const setPartnerBundle = ( partnerBundle: string | null ) => ( {
 	partnerBundle,
 } );
 
-export const setCreateWithBigSky = ( createWithBigSky: boolean ) => ( {
-	type: 'SET_CREATE_WITH_BIG_SKY' as const,
-	createWithBigSky,
-} );
-
 export type OnboardAction = ReturnType<
 	| typeof addFeature
 	| typeof removeFeature
@@ -442,9 +419,7 @@ export type OnboardAction = ReturnType<
 	| typeof setHidePlansFeatureComparison
 	| typeof setProductCartItems
 	| typeof setPlanCartItem
-	| typeof setIsMigrateFromWp
 	| typeof setPaidSubscribers
 	| typeof setPartnerBundle
 	| typeof setSignupDomainOrigin
-	| typeof setCreateWithBigSky
 >;

package/src/onboard/index.ts

@@ -62,7 +62,6 @@ export function register(): typeof STORE_KEY {
 			'domainCartItem',
 			'planCartItem',
 			'productCartItems',
-			'createWithBigSky',
 			'partnerBundle',
 		],
 	} );

package/src/onboard/reducer.ts

@@ -489,16 +489,6 @@ const domainCartItems: Reducer< MinimalRequestCartProduct[] | undefined, Onboard
 	return state;
 };
 
-const isMigrateFromWp: Reducer< boolean, OnboardAction > = ( state = false, action ) => {
-	if ( action.type === 'SET_IS_MIGRATE_FROM_WP' ) {
-		return action.isMigrateFromWp;
-	}
-	if ( action.type === 'RESET_ONBOARD_STORE' ) {
-		return false;
-	}
-	return state;
-};
-
 const pluginsToVerify: Reducer< string[] | undefined, OnboardAction > = ( state, action ) => {
 	if ( action.type === 'SET_PLUGIN_SLUGS_TO_VERIFY' ) {
 		return action.pluginSlugs;
@@ -622,20 +612,6 @@ const signupDomainOrigin: Reducer< string | undefined, OnboardAction > = (
 	return state;
 };
 
-const createWithBigSky: Reducer< boolean | undefined, OnboardAction > = (
-	state = undefined,
-	action
-) => {
-	if ( action.type === 'SET_CREATE_WITH_BIG_SKY' ) {
-		return action.createWithBigSky;
-	}
-	if ( action.type === 'RESET_ONBOARD_STORE' ) {
-		return undefined;
-	}
-
-	return state;
-};
-
 const reducer = combineReducers( {
 	domain,
 	domainCartItem,
@@ -678,14 +654,12 @@ const reducer = combineReducers( {
 	storageAddonSlug,
 	planCartItem,
 	productCartItems,
-	isMigrateFromWp,
 	domainCartItems,
 	pluginsToVerify,
 	profilerData,
 	paidSubscribers,
 	partnerBundle,
 	signupDomainOrigin,
-	createWithBigSky,
 } );
 
 export type State = ReturnType< typeof reducer >;

package/src/onboard/selectors.ts

@@ -77,9 +77,7 @@ export const getSignupDomainOrigin = ( state: State ) => state.signupDomainOrigi
 export const getSiteUrl = ( state: State ) => state.siteUrl;
 export const getHideFreePlan = ( state: State ) => state.hideFreePlan;
 export const getHidePlansFeatureComparison = ( state: State ) => state.hidePlansFeatureComparison;
-export const getIsMigrateFromWp = ( state: State ) => state.isMigrateFromWp;
 export const getPluginsToVerify = ( state: State ) => state.pluginsToVerify;
 export const getProfilerData = ( state: State ) => state.profilerData;
 export const getPaidSubscribers = ( state: State ) => state.paidSubscribers;
 export const getPartnerBundle = ( state: State ) => state.partnerBundle;
-export const getCreateWithBigSky = ( state: State ) => state.createWithBigSky;

package/src/plans/resolvers.ts

@@ -1,4 +1,4 @@
-import { formatCurrency } from 'i18n-calypso';
+import { formatCurrency } from '@automattic/number-formatters';
 import { stringify } from 'qs';
 import { fetchAndParse, wpcomRequest } from '../wpcom-request-controls';
 import { setFeatures, setFeaturesByType, setPlanProducts, setPlans } from './actions';

package/src/purchases/lib/assembler.ts

@@ -114,6 +114,7 @@ export function createPurchaseObject( purchase: RawPurchase | RawPurchaseCreditC
 		saleAmountInteger: purchase.sale_amount_integer,
 		siteId: Number( purchase.blog_id ),
 		siteName: purchase.blogname,
+		siteSlug: purchase.site_slug,
 		subscribedDate: purchase.subscribed_date,
 		subscriptionStatus: purchase.subscription_status,
 		tagLine: purchase.tag_line,
@@ -124,6 +125,10 @@ export function createPurchaseObject( purchase: RawPurchase | RawPurchaseCreditC
 		isAutoRenewEnabled: parseInt( purchase.auto_renew ?? '' ) === 1,
 	};
 
+	if ( purchase.purchaser_id ) {
+		object.purchaserId = Number( purchase.purchaser_id );
+	}
+
 	if ( isCreditCardPurchase( purchase ) ) {
 		object.payment.creditCard = {
 			id: Number( purchase.payment_card_id ),

package/src/purchases/queries/lib/use-query-keys-factory.ts

@@ -1,5 +1,6 @@
 const useQueryKeysFactory = () => ( {
 	sitePurchases: ( siteId?: string | number | null ) => [ 'site-purchases', siteId ],
+	transferredPurchases: ( userId?: string | number | null ) => [ 'transferred-purchases', userId ],
 } );
 
 export default useQueryKeysFactory;

package/src/purchases/queries/use-get-jetpack-transferred-license-purchases.tsx

@@ -0,0 +1,43 @@
+import { useQuery } from '@tanstack/react-query';
+import wpcomRequest from 'wpcom-proxy-request';
+import { createPurchaseObject } from '../lib/assembler';
+import useQueryKeysFactory from './lib/use-query-keys-factory';
+import type { RawPurchase, Purchase } from '../types';
+
+interface Props {
+	userId?: string | number;
+}
+
+export function getUseTransferredPurchasesOptions(
+	{ userId }: Props,
+	queryKey: ( string | number | null | undefined )[]
+) {
+	return {
+		queryKey,
+		queryFn: async (): Promise< Purchase[] > => {
+			const purchases: RawPurchase[] = await wpcomRequest( {
+				path: '/me/purchases/transferred',
+				apiVersion: '1.1',
+			} );
+
+			return purchases.map( ( rawPurchase ) => createPurchaseObject( rawPurchase ) );
+		},
+		enabled: !! userId,
+	};
+}
+
+/**
+ * Fetches all purchases for a given site, transformed into a map of purchaseId => Purchase
+ * @param {Object} props - The properties for the function
+ * @param props.userId Site ID
+ * @returns Query result
+ */
+function useGetJetpackTransferredLicensePurchases( { userId }: Props ) {
+	const queryKeys = useQueryKeysFactory();
+
+	return useQuery< Purchase[] >(
+		getUseTransferredPurchasesOptions( { userId }, queryKeys.transferredPurchases( userId ) )
+	);
+}
+
+export default useGetJetpackTransferredLicensePurchases;