@automattic/jetpack-shared-extension-utils 0.2.0 → 0.4.1-alpha

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.4.1-alpha] - unreleased
+
+This is an alpha version! The changes listed here are not final.
+
+## [0.4.0] - 2022-03-31
+### Added
+- Add a new utility function to determine whether a site has been launched.
+
+## [0.3.1] - 2022-03-29
+### Added
+- Add missing JS peer dependency.
+
+## [0.3.0] - 2022-03-23
+### Added
+- Moved plan-utils.js file from plugin/jetpack to shared-extension-utils. Updated import references for the same
+
+### Changed
+- Updated package dependencies
+
 ## [0.2.0] - 2022-03-15
 ### Added
 - Moved with-has-warning-is-interactive-class-names folder from jetpack plugin shared extensions
@@ -25,5 +44,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Core: prepare utility for release
 
+[0.4.1-alpha]: https://github.com/Automattic/jetpack-shared-extension-utils/compare/0.4.0...0.4.1-alpha
+[0.4.0]: https://github.com/Automattic/jetpack-shared-extension-utils/compare/0.3.1...0.4.0
+[0.3.1]: https://github.com/Automattic/jetpack-shared-extension-utils/compare/0.3.0...0.3.1
+[0.3.0]: https://github.com/Automattic/jetpack-shared-extension-utils/compare/0.2.0...0.3.0
 [0.2.0]: https://github.com/Automattic/jetpack-shared-extension-utils/compare/0.1.1...0.2.0
 [0.1.1]: https://github.com/Automattic/jetpack-shared-extension-utils/compare/0.1.0...0.1.1

package/index.js

@@ -1,6 +1,15 @@
 export { default as getJetpackData, JETPACK_DATA_PATH } from './src/get-jetpack-data';
 export { default as getSiteFragment } from './src/get-site-fragment';
-export { isSimpleSite, isAtomicSite, isPrivateSite } from './src/site-type-utils';
+export * from './src/site-type-utils';
 export { default as getJetpackExtensionAvailability } from './src/get-jetpack-extension-availability';
 export { default as registerJetpackPlugin } from './src/register-jetpack-plugin';
 export { default as withHasWarningIsInteractiveClassNames } from './src/with-has-warning-is-interactive-class-names';
+export {
+	getUpgradeUrl,
+	isUpgradable,
+	requiresPaidPlan,
+	getRequiredPlan,
+	isUpgradeNudgeEnabled,
+	isStillUsableWithFreePlan,
+	getUsableBlockProps,
+} from './src/plan-utils';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@automattic/jetpack-shared-extension-utils",
-	"version": "0.2.0",
+	"version": "0.4.1-alpha",
 	"description": "Utility functions used by the block editor extensions",
 	"homepage": "https://jetpack.com",
 	"bugs": {
@@ -17,13 +17,16 @@
 	},
 	"dependencies": {
 		"@wordpress/compose": "5.1.2",
-		"@wordpress/plugins": "4.1.1"
+		"@wordpress/i18n": "4.3.0",
+		"@wordpress/plugins": "4.1.1",
+		"@wordpress/url": "3.4.0",
+		"lodash": "4.17.21"
 	},
 	"devDependencies": {
-		"@babel/core": "7.16.0",
-		"@babel/preset-react": "7.16.0",
-		"jetpack-js-test-runner": "workspace:*",
-		"nyc": "15.1.0"
+		"@babel/core": "7.17.8",
+		"@babel/preset-react": "7.16.7",
+		"nyc": "15.1.0",
+		"react": "17.0.2"
 	},
 	"exports": {
 		".": "./index.js"

package/src/plan-utils.js

@@ -0,0 +1,187 @@
+/**
+ * External dependencies
+ */
+import { compact, get, startsWith, map, filter, head } from 'lodash';
+
+/**
+ * WordPress dependencies
+ */
+import { addQueryArgs } from '@wordpress/url';
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Internal dependencies
+ */
+import { isAtomicSite, isSimpleSite } from './site-type-utils';
+import getJetpackData from './get-jetpack-data';
+import getJetpackExtensionAvailability from './get-jetpack-extension-availability';
+import getSiteFragment from './get-site-fragment';
+
+/**
+ * Return the checkout URL to upgrade the site plan,
+ * depending on the plan, postId, and postType site values.
+ *
+ * @param {object} siteParams -          Site params used to build the URL.
+ * @param {string} siteParams.planSlug - Plan slug.
+ * @param {object} siteParams.plan -     An object with details about the plan.
+ * @param {number} siteParams.postId -   Post id.
+ * @param {string} siteParams.postType - Post type.
+ * @returns {string}                     Upgrade URL.
+ */
+export function getUpgradeUrl( { planSlug, plan, postId, postType } ) {
+	// WP.com plan objects have a dedicated `path_slug` field, Jetpack plan objects don't.
+	const planPathSlug = startsWith( planSlug, 'jetpack_' ) ? planSlug : get( plan, [ 'path_slug' ] );
+
+	// The full site editor has no set post type.
+	const redirect_to = ( undefined === postType
+		? () => {
+				const queryParams = new URLSearchParams( window.location.search );
+
+				return addQueryArgs(
+					window.location.protocol +
+						`//${ getSiteFragment().replace( '::', '/' ) }/wp-admin/admin.php`,
+					{
+						page: 'gutenberg-edit-site',
+						postId: queryParams.get( 'postId' ),
+						postType: queryParams.get( 'postType' ),
+						plan_upgraded: 1,
+					}
+				);
+		  }
+		: () => {
+				// The editor for CPTs has an `edit/` route fragment prefixed.
+				const postTypeEditorRoutePrefix = [ 'page', 'post' ].includes( postType ) ? '' : 'edit';
+
+				// Post-checkout: redirect back here.
+				return isSimpleSite()
+					? addQueryArgs(
+							'/' +
+								compact( [ postTypeEditorRoutePrefix, postType, getSiteFragment(), postId ] ).join(
+									'/'
+								),
+							{
+								plan_upgraded: 1,
+							}
+					  )
+					: addQueryArgs(
+							window.location.protocol +
+								`//${ getSiteFragment().replace( '::', '/' ) }/wp-admin/post.php`,
+							{
+								action: 'edit',
+								post: postId,
+								plan_upgraded: 1,
+							}
+					  );
+		  } )();
+
+	// Redirect to calypso plans page for WoC sites.
+	if ( isAtomicSite() ) {
+		return addQueryArgs( `https://wordpress.com/plans/${ getSiteFragment() }`, {
+			redirect_to,
+			customerType: 'business',
+		} );
+	}
+
+	return (
+		planPathSlug &&
+		addQueryArgs( `https://wordpress.com/checkout/${ getSiteFragment() }/${ planPathSlug }`, {
+			redirect_to,
+		} )
+	);
+}
+
+/**
+ * Check if the block is upgradable, based on whether
+ * the block requires a paid plan.
+ *
+ * @param {string} name - Block name.
+ * @returns {boolean} True if the block is upgradable, false otherwise.
+ */
+export function isUpgradable( name ) {
+	if ( ! name ) {
+		return false;
+	}
+
+	const blockName = /^jetpack\//.test( name ) ? name.substr( 8, name.length ) : name;
+	const { available, unavailableReason } = getJetpackExtensionAvailability( blockName );
+
+	return ! available && 'missing_plan' === unavailableReason;
+}
+
+/**
+ * Checks whether the block requires a paid plan or not.
+ *
+ * @param {string} unavailableReason - The reason why block is unavailable
+ * @param {object} details - The block details
+ * @returns {string|boolean} Either false if the block doesn't require a paid plan, or the actual plan name it requires.
+ */
+export function requiresPaidPlan( unavailableReason, details ) {
+	if ( unavailableReason === 'missing_plan' ) {
+		return details.required_plan;
+	}
+	return false;
+}
+
+/**
+ * Returns the required plan slug for a passed block name.
+ *
+ * @param {string} name - Block name.
+ * @returns {string|boolean} Plan name if the block is upgradable, false otherwise.
+ */
+export function getRequiredPlan( name ) {
+	if ( ! name ) {
+		return false;
+	}
+
+	const blockName = /^jetpack\//.test( name ) ? name.substr( 8, name.length ) : name;
+	const { details, unavailableReason } = getJetpackExtensionAvailability( blockName );
+
+	return requiresPaidPlan( unavailableReason, details );
+}
+
+/*
+ * Usable blocks list with a free plan.
+ * This array contains blocks that can be usable
+ * even with a free plan, as well as properties
+ * used to handle specific behaviour.
+ */
+const usableBlockWithFreePlan = [
+	{
+		name: 'core/cover',
+		mediaPlaceholder: true,
+		mediaReplaceFlow: true,
+		fileType: 'video',
+		description: __( 'Upgrade your plan to use video covers', 'jetpack' ),
+	},
+	{
+		name: 'core/audio',
+		mediaPlaceholder: true,
+		mediaReplaceFlow: true,
+		fileType: 'audio',
+		description: __( 'Upgrade your plan to upload audio', 'jetpack' ),
+	},
+];
+
+/**
+ * Return whether upgrade nudges are enabled or not.
+ *
+ * @returns {boolean} True if the Upgrade Nudge is enable. Otherwise, False.
+ */
+export function isUpgradeNudgeEnabled() {
+	return get( getJetpackData(), 'jetpack.enable_upgrade_nudge', false );
+}
+
+/*
+ * Some blocks are still usable with a free plan.
+ * We can handle their dual behavior defining specifically
+ * when to show the upgrade banner
+ * through or the Paid Block context.
+ *
+ * @param {string} name - Block name to check.
+ * @returns {boolean} True is the block is usable with a Free plan. Otherwise, False.
+ */
+export const isStillUsableWithFreePlan = name =>
+	map( usableBlockWithFreePlan, 'name' ).includes( name );
+
+export const getUsableBlockProps = blockName =>
+	head( filter( usableBlockWithFreePlan, ( { name } ) => name === blockName ) );

package/src/site-type-utils.js

@@ -41,3 +41,14 @@ export function isPrivateSite() {
 	const jetpackData = getJetpackData();
 	return jetpackData?.jetpack?.is_private_site ?? false;
 }
+
+/**
+ * Return whether the current site is coming soon (i.e. not launched yet).
+ * This is only available for WordPress.com sites so far.
+ *
+ * @returns {boolean} whether the current site is coming soon.
+ */
+export function isComingSoon() {
+	const jetpackData = getJetpackData();
+	return jetpackData?.jetpack?.is_coming_soon ?? false;
+}