@automattic/data-stores 3.1.0 → 3.1.2

package/src/plans/mock/next/store/plans.ts

@@ -28,9 +28,12 @@ export const NEXT_STORE_SITE_PLAN_BUSINESS: SitePlan = {
 	productId: 2,
 	pricing: {
 		introOffer: {
-			formattedPrice: '$15.00',
-			rawPrice: 15,
-			intervalUnit: 'month',
+			formattedPrice: '$150.00',
+			rawPrice: {
+				monthly: 1250,
+				full: 15000,
+			},
+			intervalUnit: 'year',
 			intervalCount: 1,
 			isOfferComplete: false,
 		},
@@ -84,9 +87,12 @@ export const NEXT_STORE_PLAN_BUSINESS: PlanNext = {
 		billPeriod: 365,
 		currencyCode: 'USD',
 		introOffer: {
-			formattedPrice: '$25.00',
-			rawPrice: 25,
-			intervalUnit: 'month',
+			formattedPrice: '$300.00',
+			rawPrice: {
+				monthly: 2500,
+				full: 30000,
+			},
+			intervalUnit: 'year',
 			intervalCount: 1,
 			isOfferComplete: false,
 		},

package/src/plans/queries/lib/unpack-intro-offer.ts

@@ -6,8 +6,11 @@ import type { PlanIntroductoryOffer, PricedAPIPlan, PricedAPISitePlan } from '..
 const unpackIntroOffer = (
 	plan: PricedAPISitePlan | PricedAPIPlan
 ): PlanIntroductoryOffer | null => {
-	// these aren't grouped or separated. so no introductory offer if no cost or interval
-	if ( ! plan.introductory_offer_interval_unit && ! plan.introductory_offer_interval_count ) {
+	// these aren't grouped or separated. so no introductory offer if missing or malformed raw_price
+	if (
+		typeof plan.introductory_offer_raw_price_integer !== 'number' ||
+		! plan.introductory_offer_interval_count
+	) {
 		return null;
 	}
 
@@ -30,9 +33,25 @@ const unpackIntroOffer = (
 
 	return {
 		formattedPrice: plan.introductory_offer_formatted_price as string,
-		rawPrice: plan.introductory_offer_raw_price as number,
+		rawPrice: {
+			monthly:
+				/**
+				 * IMPORTANT:
+				 * we make the raw assumption that the interval unit is either "year" or "month"
+				 * to compute monthly/full price
+				 */
+				'year' === plan.introductory_offer_interval_unit
+					? parseFloat(
+							(
+								plan.introductory_offer_raw_price_integer /
+								( plan.introductory_offer_interval_count * 12 )
+							).toFixed( 2 )
+					  )
+					: plan.introductory_offer_raw_price_integer,
+			full: plan.introductory_offer_raw_price_integer,
+		},
 		intervalUnit: plan.introductory_offer_interval_unit as string,
-		intervalCount: plan.introductory_offer_interval_count as number,
+		intervalCount: plan.introductory_offer_interval_count,
 		isOfferComplete,
 	};
 };

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

@@ -1,5 +1,9 @@
 const useQueryKeysFactory = () => ( {
-	sitePlans: ( siteId?: string | number | null ) => [ 'site-plans', siteId ],
+	sitePlans: ( coupon?: string, siteId?: string | number | null ) => [
+		'site-plans',
+		siteId,
+		coupon,
+	],
 	plans: ( coupon?: string ) => [ 'plans', coupon ],
 } );
 

package/src/plans/queries/use-plans.ts

@@ -31,7 +31,7 @@ function usePlans( {
 		queryKey: queryKeys.plans( coupon ),
 		queryFn: async (): Promise< PlansIndex > => {
 			const data: PricedAPIPlan[] = await wpcomRequest( {
-				path: `/plans`,
+				path: '/plans',
 				apiVersion: '1.5',
 				query: params.toString(),
 			} );

package/src/plans/queries/use-site-plans.ts

@@ -14,6 +14,11 @@ interface PricedAPISitePlansIndex {
 }
 
 interface Props {
+	/**
+	 * To match the use-plans hook, `coupon` is required on purpose to mitigate risk of not passing
+	 * something through when we should
+	 */
+	coupon: string | undefined;
 	siteId: string | number | null | undefined;
 }
 
@@ -22,15 +27,18 @@ interface Props {
  * - Plans from `/sites/[siteId]/plans`, unlike `/plans`, are returned indexed by product_id, and do not include that in the plan's payload.
  * - UI works with product/plan slugs everywhere, so returned index is transformed to be keyed by product_slug
  */
-function useSitePlans( { siteId }: Props ): UseQueryResult< SitePlansIndex > {
+function useSitePlans( { coupon, siteId }: Props ): UseQueryResult< SitePlansIndex > {
 	const queryKeys = useQueryKeysFactory();
+	const params = new URLSearchParams();
+	coupon && params.append( 'coupon_code', coupon );
 
 	return useQuery( {
-		queryKey: queryKeys.sitePlans( siteId ),
+		queryKey: queryKeys.sitePlans( coupon, siteId ),
 		queryFn: async (): Promise< SitePlansIndex > => {
 			const data: PricedAPISitePlansIndex = await wpcomRequest( {
 				path: `/sites/${ encodeURIComponent( siteId as string ) }/plans`,
 				apiVersion: '1.3',
+				query: params.toString(),
 			} );
 
 			return Object.fromEntries(
@@ -52,6 +60,7 @@ function useSitePlans( { siteId }: Props ): UseQueryResult< SitePlansIndex > {
 							hasRedeemedDomainCredit: plan?.has_redeemed_domain_credit,
 							purchaseId: plan.id ? Number( plan.id ) : undefined,
 							pricing: {
+								hasSaleCoupon: plan.has_sale_coupon,
 								currencyCode: plan.currency_code,
 								introOffer: unpackIntroOffer( plan ),
 								costOverrides: unpackCostOverrides( plan ),

package/src/plans/resolvers.ts

@@ -1,4 +1,4 @@
-import formatCurrency from '@automattic/format-currency';
+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/plans/types.ts

@@ -67,8 +67,19 @@ export interface PlanProduct {
 }
 
 export interface PlanIntroductoryOffer {
+	/**
+	 * @deprecated use `formatCurrency` call instead on the respective price (monthly/full)
+	 */
 	formattedPrice: string;
-	rawPrice: number;
+	rawPrice: {
+		monthly: number;
+		full: number;
+	};
+	/**
+	 * IMPORTANT:
+	 * we make the raw assumption that the interval unit is either "year" or "month"
+	 * to compute monthly/full price
+	 */
 	intervalUnit: string;
 	intervalCount: number;
 	isOfferComplete: boolean;
@@ -109,6 +120,7 @@ export interface PlanPricing {
 }
 
 export interface SitePlanPricing extends Omit< PlanPricing, 'billPeriod' > {
+	hasSaleCoupon?: boolean;
 	costOverrides?: CostOverride[];
 }
 
@@ -173,8 +185,17 @@ export interface PlanNext {
 }
 
 export interface PricedAPIPlanIntroductoryOffer {
+	/**
+	 * @deprecated use `formatCurrency` call instead on the respective price (monthly/full)
+	 * - no need to pass this from the API at all
+	 */
 	introductory_offer_formatted_price?: string;
-	introductory_offer_raw_price?: number;
+	introductory_offer_raw_price_integer?: number;
+	/**
+	 * IMPORTANT:
+	 * we make the raw assumption that the interval unit is either "year" or "month"
+	 * to compute monthly/full price
+	 */
 	introductory_offer_interval_unit?: string;
 	introductory_offer_interval_count?: number;
 	introductory_offer_end_date?: string;
@@ -249,6 +270,7 @@ export interface PricedAPIPlan extends PricedAPIPlanPricing, PricedAPIPlanIntrod
 export interface PricedAPISitePlan
 	extends PricedAPISitePlanPricing,
 		PricedAPIPlanIntroductoryOffer {
+	has_sale_coupon?: boolean;
 	/* product_id: number; // not included in the plan's payload */
 	product_slug: StorePlanSlug;
 	current_plan?: boolean;

package/src/products-list/queries/use-products.ts

@@ -25,7 +25,7 @@ function useProducts(
 		queryKey: [ ...queryKeys.products(), product_slugs, locale ],
 		queryFn: async (): Promise< ProductsIndex > => {
 			const apiProducts: RawAPIProductsList = await wpcomRequest( {
-				path: `/products`,
+				path: '/products',
 				apiVersion: '1.1',
 				...( product_slugs
 					? { query: new URLSearchParams( { product_slugs, locale } ).toString() }

package/src/products-list/types.ts

@@ -44,6 +44,7 @@ export interface RawAPIProduct {
 	available: boolean;
 	combined_cost_display: string;
 	cost: number;
+	cost_per_month_display?: string;
 	cost_smallest_unit: number;
 	currency_code: string;
 	description: string;

package/src/purchases/lib/assembler.ts

@@ -12,6 +12,7 @@ export function createPurchaseObject( purchase: RawPurchase | RawPurchaseCreditC
 		billPeriodDays: Number( purchase.bill_period_days ),
 		billPeriodLabel: purchase.bill_period_label,
 		mostRecentRenewDate: purchase.most_recent_renew_date,
+		asyncPendingPaymentBlockIsSet: purchase.async_pending_payment_block_is_set,
 		canDisableAutoRenew: Boolean( purchase.can_disable_auto_renew ),
 		canReenableAutoRenewal: Boolean( purchase.can_reenable_auto_renewal ),
 		canExplicitRenew: Boolean( purchase.can_explicit_renew ),
@@ -58,6 +59,7 @@ export function createPurchaseObject( purchase: RawPurchase | RawPurchaseCreditC
 		isCancelable: Boolean( purchase.is_cancelable ),
 		isDomain: Boolean( purchase.is_domain ),
 		isDomainRegistration: Boolean( purchase.is_domain_registration ),
+		isHundredYearDomain: Boolean( purchase.is_hundred_year_domain ),
 		isLocked: Boolean( purchase.is_locked ),
 		isInAppPurchase: Boolean( purchase.is_iap_purchase ),
 		isRechargeable: Boolean( purchase.is_rechargable ),
@@ -112,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,
@@ -122,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;

package/src/purchases/types.ts

@@ -8,6 +8,7 @@ export interface Purchase {
 	billPeriodLabel: string;
 	blogCreatedDate: string;
 	canDisableAutoRenew: boolean;
+	asyncPendingPaymentBlockIsSet: boolean;
 	canExplicitRenew: boolean;
 	canReenableAutoRenewal: boolean;
 	costToUnbundle: number;
@@ -15,7 +16,18 @@ export interface Purchase {
 	currencyCode: string;
 	currencySymbol: string;
 	description: string;
+
+	/**
+	 * The domain name of the site associated with the purchase.
+	 *
+	 * IMPORTANT: this is not necessarily the primary domain of the site. This
+	 * can cause issues for Atomic sites if you try to use it for things that
+	 * expect the primary domain, like routing.
+	 *
+	 * To get the primary domain instead, use `siteSlug`.
+	 */
 	domain: string;
+
 	domainRegistrationAgreementUrl: string | null;
 	error: null;
 	expiryDate: string;
@@ -29,6 +41,7 @@ export interface Purchase {
 	isCancelable: boolean;
 	isDomain?: boolean;
 	isDomainRegistration?: boolean;
+	isHundredYearDomain?: boolean;
 	isInAppPurchase: boolean;
 	isLocked: boolean;
 	isRechargeable: boolean;
@@ -58,6 +71,7 @@ export interface Purchase {
 	productSlug: string;
 	productType: string;
 	purchaseRenewalQuantity: number | null;
+	purchaserId?: number;
 
 	/**
 	 * The refund amount for the purchase, not including bundled domains, as a
@@ -104,6 +118,12 @@ export interface Purchase {
 	saleAmountInteger?: number;
 	siteId: number;
 	siteName: string;
+
+	/**
+	 * The primary domain for the site that owns this purchase.
+	 */
+	siteSlug?: string;
+
 	subscribedDate: string;
 	subscriptionStatus: 'active' | 'inactive';
 
@@ -183,6 +203,7 @@ export interface RawPurchase {
 	most_recent_renew_date: string;
 	can_disable_auto_renew: boolean;
 	can_reenable_auto_renewal: boolean;
+	async_pending_payment_block_is_set: boolean;
 	can_explicit_renew: boolean;
 	cost_to_unbundle: undefined | number | string;
 	cost_to_unbundle_display: undefined | string;
@@ -203,6 +224,7 @@ export interface RawPurchase {
 	is_cancelable: boolean;
 	is_domain: boolean;
 	is_domain_registration: boolean;
+	is_hundred_year_domain: boolean;
 	is_locked: boolean;
 	is_iap_purchase: boolean;
 	is_rechargable: boolean;
@@ -235,6 +257,7 @@ export interface RawPurchase {
 	product_type: string;
 	product_display_price: string;
 	price_integer: number;
+	purchaser_id?: number;
 	total_refund_amount: number | undefined;
 	total_refund_currency: string;
 	total_refund_integer: number;
@@ -252,6 +275,7 @@ export interface RawPurchase {
 	sale_amount_integer: number | undefined;
 	blog_id: number | string;
 	blogname: string;
+	site_slug?: string;
 	subscribed_date: string;
 	subscription_status: 'active' | 'inactive';
 	tag_line: string;
@@ -316,6 +340,7 @@ export interface PurchasePayment {
 	storedDetailsId: string | number | undefined | null;
 	expiryDate?: string;
 	creditCard?: PurchasePaymentCreditCard;
+	paymentPartner?: string;
 }
 
 /**

package/src/queries/use-all-domains-query.ts

@@ -17,11 +17,13 @@ export type PartialDomainData = Pick<
 	| 'google_apps_subscription'
 	| 'has_registration'
 	| 'is_wpcom_staging_domain'
+	| 'is_hundred_year_domain'
 	| 'registration_date'
 	| 'titan_mail_subscription'
 	| 'tld_maintenance_end_time'
 	| 'type'
 	| 'wpcom_domain'
+	| 'domain_status'
 >;
 
 export interface AllDomainsQueryFnData {
@@ -30,6 +32,7 @@ export interface AllDomainsQueryFnData {
 
 export interface AllDomainsQueryArgs {
 	no_wpcom?: boolean;
+	resolve_status?: boolean;
 }
 
 export const getAllDomainsQueryKey = ( queryArgs: AllDomainsQueryArgs = {} ) => [

package/src/queries/use-bulk-domain-update-status-query.ts

@@ -24,6 +24,11 @@ export interface JobStatus {
 	failed: string[];
 	pending: string[];
 	complete: boolean;
+	params: {
+		auto_renew?: boolean;
+		whois?: unknown;
+		transfer_lock?: boolean;
+	};
 }
 
 interface DomainUpdateRemoteStatus {
@@ -64,17 +69,16 @@ export function useBulkDomainUpdateStatusQuery< TError = unknown >(
 			wpcomRequest< BulkDomainUpdateStatusQueryFnData >( {
 				path: '/domains/bulk-actions',
 				apiNamespace: 'wpcom/v2',
-				apiVersion: '2',
 			} ),
 		select: ( data ): BulkDomainUpdateStatusResult => {
 			// get top-level info about recent jobs
 			const allJobs: JobStatus[] = Object.keys( data ).map( ( jobId ) => {
-				const job = data[ jobId ];
+				const { action, created_at, results, ...rest } = data[ jobId ];
 				const success: string[] = [];
 				const failed: string[] = [];
 				const pending: string[] = [];
 
-				Object.entries( job.results ).forEach( ( entry ) => {
+				Object.entries( results ).forEach( ( entry ) => {
 					if ( entry[ 1 ] === 'success' ) {
 						success.push( entry[ 0 ] );
 					} else if ( entry[ 1 ] === 'failed' ) {
@@ -86,12 +90,13 @@ export function useBulkDomainUpdateStatusQuery< TError = unknown >(
 
 				return {
 					id: jobId,
-					action: job.action,
-					created_at: job.created_at,
+					action: action,
+					created_at: created_at,
 					success,
 					failed,
 					pending,
 					complete: pending.length === 0,
+					params: rest,
 				};
 			} );
 

package/src/queries/use-launchpad.ts

@@ -1,4 +1,5 @@
 import { recordTracksEvent } from '@automattic/calypso-analytics';
+import * as oauthToken from '@automattic/oauth-token';
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import apiFetch from '@wordpress/api-fetch';
 import { addQueryArgs } from '@wordpress/url';
@@ -70,21 +71,21 @@ export const fetchLaunchpad = (
 	const checklistSlugEncoded = checklistSlug ? encodeURIComponent( checklistSlug ) : null;
 	const launchpadContextEncoded = launchpadContext ? encodeURIComponent( launchpadContext ) : null;
 	const queryArgs = {
-		_locale: 'uesr',
+		_locale: 'user',
 		...( checklistSlug && { checklist_slug: checklistSlugEncoded } ),
 		...( launchpadContext && { launchpad_context: launchpadContextEncoded } ),
 	};
-
+	const token = oauthToken.getToken();
 	return canAccessWpcomApis()
 		? wpcomRequest( {
 				path: addQueryArgs( `/sites/${ slug }/launchpad`, queryArgs ),
 				apiNamespace: 'wpcom/v2',
-				apiVersion: '2',
 				method: 'GET',
+				token: typeof token === 'string' ? token : undefined,
 		  } )
 		: apiFetch( {
 				global: true,
-				path: addQueryArgs( `/wpcom/v2/launchpad`, queryArgs ),
+				path: addQueryArgs( '/wpcom/v2/launchpad', queryArgs ),
 		  } as APIFetchOptions );
 };
 
@@ -105,12 +106,12 @@ export function sortLaunchpadTasksByCompletionStatus( response: LaunchpadRespons
 	return response;
 }
 
-const defaultSuccessCallback = ( response: LaunchpadResponse ) => {
+export function defaultSuccessCallback( response: LaunchpadResponse ) {
 	const tasks = response.checklist || [];
 	response.checklist = tasks.map( addOrderToTask );
 
 	return response;
-};
+}
 
 type SiteSlug = string | number | null;
 
@@ -138,6 +139,7 @@ export const useLaunchpad = (
 			is_dismissible: false,
 			title: null,
 		},
+		enabled: Boolean( siteSlug ),
 	} );
 };
 
@@ -158,17 +160,18 @@ export const updateLaunchpadSettings = (
 	settings: LaunchpadUpdateSettings = {}
 ) => {
 	const slug = siteSlug ? encodeURIComponent( siteSlug ) : null;
-
+	const token = oauthToken.getToken();
 	return canAccessWpcomApis()
 		? wpcomRequest( {
 				path: `/sites/${ slug }/launchpad`,
 				apiNamespace: 'wpcom/v2',
 				method: 'PUT',
 				body: settings,
+				token: typeof token === 'string' ? token : undefined,
 		  } )
 		: apiFetch( {
 				global: true,
-				path: `/wpcom/v2/launchpad`,
+				path: '/wpcom/v2/launchpad',
 				method: 'PUT',
 				data: settings,
 		  } as APIFetchOptions );
@@ -203,7 +206,11 @@ const getDismissParams = ( settings: DismissSettings ) => {
 	}
 };
 
-export const useLaunchpadDismisser = ( siteSlug: SiteSlug, checklistSlug: string ) => {
+export const useLaunchpadDismisser = (
+	siteSlug: SiteSlug,
+	checklistSlug: string,
+	launchpadContext: string
+) => {
 	const queryClient = useQueryClient();
 	const key = getKey( siteSlug, checklistSlug );
 
@@ -230,7 +237,7 @@ export const useLaunchpadDismisser = ( siteSlug: SiteSlug, checklistSlug: string
 		onSuccess: () => {
 			recordTracksEvent( 'calypso_launchpad_dismiss_guide', {
 				checklist_slug: checklistSlug,
-				context: 'customer-home',
+				context: launchpadContext,
 			} );
 		},
 		onError: ( _, _2, context ) => {

package/src/queries/use-site-domains-query.ts

@@ -40,7 +40,6 @@ export interface DomainData {
 	expired: boolean;
 	auto_renewing: boolean;
 	pending_registration: boolean;
-	pending_registration_time: string;
 	has_registration: boolean;
 	has_email_forward_dns_records: unknown;
 	points_to_wpcom: boolean;
@@ -53,6 +52,8 @@ export interface DomainData {
 	is_dnssec_enabled: boolean;
 	is_dnssec_supported: boolean;
 	is_gravatar_domain: boolean;
+	is_gravatar_restricted_domain: boolean;
+	is_hundred_year_domain: boolean;
 	is_renewable: boolean;
 	is_redeemable: boolean;
 	is_subdomain: boolean;
@@ -105,6 +106,7 @@ export interface DomainData {
 	has_private_registration: boolean;
 	is_pending_icann_verification: boolean;
 	is_icann_verification_suspended: boolean;
+	is_root_domain_registered_with_automattic: boolean;
 	manual_transfer_required: boolean;
 	registrar: string;
 	domain_locking_available: boolean;
@@ -128,6 +130,11 @@ export interface DomainData {
 	pending_registration_at_registry_url: string;
 	registered_via_trustee: boolean;
 	registered_via_trustee_url: string;
+	domain_status?: {
+		status: string;
+		status_type: string;
+		status_weight: number;
+	};
 }
 
 export interface SiteDomainsQueryFnData {

package/src/queries/use-site-intent.ts

@@ -1,9 +1,10 @@
 import { useQuery } from '@tanstack/react-query';
 import wpcomRequest from 'wpcom-proxy-request';
+import { SiteIntent } from '../onboard';
 
 export function useSiteIntent( siteId: string | number | undefined ) {
 	return useQuery< {
-		site_intent: '';
+		site_intent: SiteIntent;
 	} >( {
 		queryKey: [ 'site-intent', siteId ],
 		queryFn: async () =>

package/src/reader/contexts/site-subscriptions-query-props.tsx

@@ -1,4 +1,4 @@
-import React, { createContext, useState, useContext } from 'react';
+import React, { createContext, useState, useContext, useMemo } from 'react';
 import { SiteSubscriptionsFilterBy, SiteSubscriptionsSortBy } from '../constants';
 
 type SiteSubscriptionsQueryPropsType = {
@@ -19,24 +19,33 @@ export const SiteSubscriptionsQueryProps = createContext< SiteSubscriptionsQuery
 	setFilterOption: () => undefined,
 } );
 
-export const SiteSubscriptionsQueryPropsProvider: React.FC< { children: React.ReactNode } > = ( {
+type SiteSubscriptionsQueryPropsProviderProps = {
+	// initializer for `searchTerm` state, either a value or a callback, a standard initializer arg for `useState`
+	initialSearchTermState?: string | ( () => string );
+	children: React.ReactNode;
+};
+
+export const SiteSubscriptionsQueryPropsProvider = ( {
+	initialSearchTermState = '',
 	children,
-} ) => {
-	const [ searchTerm, setSearchTerm ] = useState( '' );
+}: SiteSubscriptionsQueryPropsProviderProps ) => {
+	const [ searchTerm, setSearchTerm ] = useState( initialSearchTermState );
 	const [ sortTerm, setSortTerm ] = useState( SiteSubscriptionsSortBy.DateSubscribed );
 	const [ filterOption, setFilterOption ] = useState( SiteSubscriptionsFilterBy.All );
 
+	const value = useMemo(
+		() => ( {
+			searchTerm,
+			setSearchTerm,
+			sortTerm,
+			setSortTerm,
+			filterOption,
+			setFilterOption,
+		} ),
+		[ searchTerm, setSearchTerm, sortTerm, setSortTerm, filterOption, setFilterOption ]
+	);
 	return (
-		<SiteSubscriptionsQueryProps.Provider
-			value={ {
-				searchTerm,
-				setSearchTerm,
-				sortTerm,
-				setSortTerm,
-				filterOption,
-				setFilterOption,
-			} }
-		>
+		<SiteSubscriptionsQueryProps.Provider value={ value }>
 			{ children }
 		</SiteSubscriptionsQueryProps.Provider>
 	);