CLI: Source WordPress zip from a local cache file before looking for it online

packages/playground/cli/src/cli.ts

@@ -22,13 +22,7 @@ import { createNodeFsMountHandler, loadNodeRuntime } from '@php-wasm/node';
 import { RecommendedPHPVersion, zipDirectory } from '@wp-playground/common';
 import { bootWordPress } from '@wp-playground/wordpress';
 import { rootCertificates } from 'tls';
-import {
-	CACHE_FOLDER,
-	fetchSqliteIntegration,
-	fetchWordPress,
-	readAsFile,
-	resolveWPRelease,
-} from './download';
+import { resolveWordPressZip, fetchSqliteIntegration } from './download';
 
 export interface Mount {
 	hostPath: string;
@@ -272,24 +266,14 @@ async function run() {
 					}
 				}) as any);
 
-				wpDetails = await resolveWPRelease(args.wp);
+				wpDetails = await resolveWordPressZip(args.wp, monitor);
 			}
 
-			const preinstalledWpContentPath = path.join(
-				CACHE_FOLDER,
-				`prebuilt-wp-content-for-wp-${wpDetails.version}.zip`
-			);
-			const wordPressZip = !wpDetails
-				? undefined
-				: fs.existsSync(preinstalledWpContentPath)
-				? readAsFile(preinstalledWpContentPath)
-				: fetchWordPress(wpDetails.url, monitor);
-
 			requestHandler = await bootWordPress({
 				siteUrl: absoluteUrl,
 				createPhpRuntime: async () =>
 					await loadNodeRuntime(compiledBlueprint.versions.php),
-				wordPressZip,
+				wordPressZip: wpDetails.zipFile,
 				sqliteIntegrationPluginZip: fetchSqliteIntegration(monitor),
 				sapiName: 'cli',
 				createFiles: {
@@ -313,8 +297,8 @@ async function run() {
 			const php = await requestHandler.getPrimaryPhp();
 			if (wpDetails && !args.mountBeforeInstall) {
 				fs.writeFileSync(
-					preinstalledWpContentPath,
-					await zipDirectory(php, '/wordpress')
+					wpDetails.localZipPath,
+					await zipDirectory(php, requestHandler.documentRoot)
 				);
 			}
 

packages/playground/cli/src/download.ts

@@ -2,6 +2,7 @@ import { EmscriptenDownloadMonitor } from '@php-wasm/progress';
 import { createHash } from 'crypto';
 import fs from 'fs-extra';
 import os from 'os';
+import { globSync } from 'glob';
 import path, { basename } from 'path';
 
 export const CACHE_FOLDER = path.join(os.homedir(), '.wordpress-playground');
@@ -84,6 +85,83 @@ export function readAsFile(path: string, fileName?: string): File {
 	return new File([fs.readFileSync(path)], fileName ?? basename(path));
 }
 
+/**
+ * Offline-first WordPress zip resolution.
+ * It will first look for a pre-installed WordPress zip file in the local cache,
+ * and will only do a network lookup if it doesn't find one.
+ *
+ * @param preferredVersion
+ * @param monitor
+ * @returns
+ */
+export async function resolveWordPressZip(
+	preferredVersion: string,
+	monitor: EmscriptenDownloadMonitor
+): Promise<{ zipFile: File | Promise<File>; localZipPath: string }> {
+	const filenamePrefix = `prebuilt-wp-`;
+	const filenameSuffix = `.zip`;
+	let wpDetails;
+
+	// First, let's grab a pre-installed WordPress zip file we may have
+	// already prepared earlier.
+	const localVersions = globSync(
+		path.join(CACHE_FOLDER, `${filenamePrefix}*${filenameSuffix}`)
+	)
+		.sort()
+		.map((path) => path.split('/').pop()!)
+		.reverse();
+	let resolvedFilename: string | undefined;
+	if (preferredVersion === 'latest') {
+		resolvedFilename = localVersions.filter(
+			(filename) =>
+				!filename.includes('beta') && !filename.includes('nightly')
+		)[0];
+	} else if (preferredVersion === 'beta') {
+		resolvedFilename = localVersions.filter((filename) =>
+			filename.includes('beta')
+		)[0];
+	} else if (preferredVersion === 'nightly') {
+		resolvedFilename = localVersions.filter((filename) =>
+			filename.includes('nightly')
+		)[0];
+	} else {
+		resolvedFilename = localVersions.filter((filename) =>
+			filename.startsWith(`${filenamePrefix}${preferredVersion}`)
+		)[0];
+	}
+	if (resolvedFilename) {
+		const localZipPath = path.join(CACHE_FOLDER, resolvedFilename);
+		const zipFile = readAsFile(localZipPath);
+		return {
+			zipFile,
+			localZipPath,
+		};
+	}
+
+	// We don't have this WordPress version on the device. Let's
+	// do a network lookup.
+	try {
+		wpDetails = await resolveWPRelease(preferredVersion);
+		const localZipPath = path.join(
+			CACHE_FOLDER,
+			`${filenamePrefix}${wpDetails.version}${filenameSuffix}`
+		);
+		return {
+			zipFile: fs.existsSync(localZipPath)
+				? readAsFile(localZipPath)
+				: fetchWordPress(wpDetails.url, monitor),
+			localZipPath,
+		};
+	} catch (e) {
+		throw new Error(
+			`Could not resolve WordPress ${resolvedFilename} from local cache (you're offline)`,
+			{
+				cause: e,
+			}
+		);
+	}
+}
+
 export async function resolveWPRelease(version = 'latest') {
 	// Support custom URLs
 	if (version.startsWith('https://') || version.startsWith('http://')) {