@wp-operations/wp-app 0.1.0 → 0.2.0

package/dist/main.js

@@ -1,89 +1,39 @@
 // src/run-cli.ts
-import fs11 from "fs-extra";
-import path14 from "path";
+import fs13 from "fs";
+import path11 from "path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { spawn, execSync } from "child_process";
 
 // src/start-server.ts
-import fs10 from "fs";
+import fs11 from "fs";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
 import express from "express";
-import fileUpload from "express-fileupload";
 
-// src/port-finder.ts
-import http from "http";
+// src/engine.ts
+import fs10 from "fs";
+import path9 from "path";
+import { createNodeFsMountHandler, loadNodeRuntime } from "@php-wasm/node";
+import { bootWordPressAndRequestHandler } from "@wp-playground/wordpress";
 
 // src/constants.ts
-var WP_NOW_HIDDEN_FOLDER = ".wp-app";
-var SQLITE_FILENAME = "sqlite-database-integration";
+import { RecommendedPHPVersion } from "@wp-playground/common";
+var WP_APP_HIDDEN_FOLDER = ".wp-app";
+var WP_APP_HOME_ENV = "WP_APP_HOME";
 var SQLITE_URL = "https://github.com/WordPress/sqlite-database-integration/archive/refs/heads/main.zip";
 var CLASSICPRESS_LATEST_URL = "https://www.classicpress.net/latest.zip";
 var DEFAULT_PORT = 8881;
-var DEFAULT_PHP_VERSION = "8.0";
+var DEFAULT_PHP_VERSION = RecommendedPHPVersion;
 var DEFAULT_WORDPRESS_VERSION = "latest";
-
-// src/port-finder.ts
-var PortFinder = class _PortFinder {
-  static #instance;
-  #searchPort = DEFAULT_PORT;
-  #openPort = null;
-  constructor() {
-  }
-  static getInstance() {
-    if (!_PortFinder.#instance) {
-      _PortFinder.#instance = new _PortFinder();
-    }
-    return _PortFinder.#instance;
-  }
-  #incrementPort() {
-    return this.#searchPort++;
-  }
-  #isPortFree() {
-    return new Promise((resolve) => {
-      const server = http.createServer();
-      server.listen(this.#searchPort, () => {
-        server.close();
-        resolve(true);
-      }).on("error", () => {
-        resolve(false);
-      });
-    });
-  }
-  /**
-   * Returns the first available open port, caching and reusing it for subsequent calls.
-   *
-   * @returns {Promise<number>} A promise that resolves to the open port number.
-   */
-  async getOpenPort() {
-    if (this.#openPort) {
-      return this.#openPort;
-    }
-    while (!await this.#isPortFree()) {
-      this.#incrementPort();
-    }
-    this.#openPort = this.#searchPort;
-    return this.#openPort;
-  }
-  setPort(port) {
-    this.#openPort = port;
-  }
-};
-var portFinder = PortFinder.getInstance();
-
-// src/wp-now.ts
-import fs9 from "fs-extra";
-import { NodePHP } from "@php-wasm/node";
-import path13 from "path";
+var DOCROOT = "/wordpress";
 
 // src/download.ts
-import fs8 from "fs-extra";
-import path11 from "path";
-import followRedirects from "follow-redirects";
-import unzipper from "unzipper";
-import os3 from "os";
+import fs9 from "fs";
+import path8 from "path";
 
 // src/wp-playground-wordpress/has-index-file.ts
-import fs from "fs-extra";
+import fs from "fs";
 import path from "path";
 function hasIndexFile(projectPath) {
   return fs.existsSync(path.join(projectPath, "index.php"));
@@ -100,11 +50,11 @@ function isClassicPressVersion(version) {
 }
 
 // src/wp-playground-wordpress/get-plugin-file.ts
-import fs3 from "fs-extra";
+import fs3 from "fs";
 import path2, { basename } from "path";
 
 // src/wp-playground-wordpress/read-file-head.ts
-import fs2 from "fs-extra";
+import fs2 from "fs";
 function readFileHead(filePath, length = 8192) {
   const buffer = Buffer.alloc(length);
   const fd = fs2.openSync(filePath, "r");
@@ -145,7 +95,7 @@ function isPluginDirectory(projectPath) {
 }
 
 // src/wp-playground-wordpress/is-theme-directory.ts
-import fs4 from "fs-extra";
+import fs4 from "fs";
 import path3 from "path";
 function isThemeDirectory(projectPath) {
   const styleCSSExists = fs4.existsSync(path3.join(projectPath, "style.css"));
@@ -158,7 +108,7 @@ function isThemeDirectory(projectPath) {
 }
 
 // src/wp-playground-wordpress/is-wp-content-directory.ts
-import fs5 from "fs-extra";
+import fs5 from "fs";
 import path4 from "path";
 function isWpContentDirectory(projectPath) {
   const muPluginsExists = fs5.existsSync(path4.join(projectPath, "mu-plugins"));
@@ -171,14 +121,14 @@ function isWpContentDirectory(projectPath) {
 }
 
 // src/wp-playground-wordpress/is-wordpress-directory.ts
-import fs6 from "fs-extra";
+import fs6 from "fs";
 import path5 from "path";
 function isWordPressDirectory(projectPath) {
   return fs6.existsSync(path5.join(projectPath, "wp-content")) && fs6.existsSync(path5.join(projectPath, "wp-includes")) && fs6.existsSync(path5.join(projectPath, "wp-load.php"));
 }
 
 // src/wp-playground-wordpress/is-wordpress-develop-directory.ts
-import fs7 from "fs-extra";
+import fs7 from "fs";
 import path6 from "path";
 function isWordPressDevelopDirectory(projectPath) {
   const requiredFiles = [
@@ -201,44 +151,30 @@ function shouldOutput() {
   return process.env.NODE_ENV !== "test";
 }
 var output = shouldOutput() ? console : null;
-function disableOutput() {
-  output = null;
-}
 
-// src/get-wp-now-path.ts
-import path8 from "path";
-import os2 from "os";
-
-// src/get-wp-now-tmp-path.ts
-import path7 from "path";
+// src/paths.ts
+import crypto from "crypto";
+import fs8 from "fs";
 import os from "os";
-function getWpNowTmpPath() {
-  const tmpDirectory = os.tmpdir();
-  return path7.join(tmpDirectory, `wp-now-tests-hidden-folder`);
+import path7 from "path";
+function getWpAppHome() {
+  return process.env[WP_APP_HOME_ENV] || path7.join(os.homedir(), WP_APP_HIDDEN_FOLDER);
 }
-
-// src/get-wp-now-path.ts
-function getWpNowPath() {
-  if (process.env.NODE_ENV !== "test") {
-    return path8.join(os2.homedir(), WP_NOW_HIDDEN_FOLDER);
-  }
-  return getWpNowTmpPath();
+function getCachePath() {
+  return ensureDir(path7.join(getWpAppHome(), "cache"));
 }
-
-// src/get-wordpress-versions-path.ts
-import path9 from "path";
-function getWordpressVersionsPath() {
-  return path9.join(getWpNowPath(), "wordpress-versions");
+function getSitePath(projectPath) {
+  const projectName = path7.basename(path7.resolve(projectPath));
+  const hash = crypto.createHash("sha1").update(path7.resolve(projectPath)).digest("hex");
+  return path7.join(getWpAppHome(), "sites", `${projectName}-${hash}`);
 }
-
-// src/get-sqlite-path.ts
-import path10 from "path";
-function getSqlitePath() {
-  return path10.join(getWpNowPath(), `${SQLITE_FILENAME}-main`);
+function ensureDir(dir) {
+  fs8.mkdirSync(dir, { recursive: true });
+  return dir;
 }
 
 // src/download.ts
-function getWordPressVersionUrl(version = DEFAULT_WORDPRESS_VERSION) {
+function getWordPressVersionUrl(version) {
   if (!isValidWordPressVersion(version)) {
     throw new Error(
       'Unrecognized WordPress version. Please use "latest", numeric versions such as "6.2", "6.0.1", "6.2-beta1", "6.2-RC1", or "classicpress" / "classicpress-2.4.1".'
@@ -253,129 +189,35 @@ function getClassicPressVersionUrl(version) {
   const tag = version.slice("classicpress-".length);
   return `https://github.com/ClassicPress/ClassicPress-release/archive/refs/tags/${tag}.zip`;
 }
-followRedirects.maxRedirects = 5;
-var { https } = followRedirects;
-async function downloadFileAndUnzip({
-  url,
-  destinationFolder,
-  checkFinalPath,
-  itemName
-}) {
-  if (fs8.existsSync(checkFinalPath)) {
-    output?.log(`${itemName} folder already exists. Skipping download.`);
-    return { downloaded: false, statusCode: 0 };
-  }
-  let statusCode = 0;
-  try {
-    fs8.ensureDirSync(path11.dirname(destinationFolder));
-    output?.log(`Downloading ${itemName}...`);
-    const response = await new Promise(
-      (resolve) => https.get(url, (response2) => resolve(response2))
-    );
-    statusCode = response.statusCode;
-    if (response.statusCode !== 200) {
+async function cachedZip(url, cacheKey) {
+  const cacheFile = path8.join(getCachePath(), cacheKey);
+  if (!fs9.existsSync(cacheFile)) {
+    output?.log(`Downloading ${cacheKey}...`);
+    const response = await fetch(url, { redirect: "follow" });
+    if (!response.ok) {
       throw new Error(
-        `Failed to download file (Status code ${response.statusCode}).`
+        `Failed to download ${url} (HTTP ${response.status}).`
       );
     }
-    await response.pipe(unzipper.Parse()).on("entry", (entry) => {
-      const filePath = path11.join(destinationFolder, entry.path);
-      fs8.ensureDirSync(path11.dirname(filePath));
-      if (entry.type !== "Directory") {
-        entry.pipe(fs8.createWriteStream(filePath));
-      }
-    }).promise();
-    return { downloaded: true, statusCode };
-  } catch (err) {
-    output?.error(`Error downloading or unzipping ${itemName}:`, err);
-  }
-  return { downloaded: false, statusCode };
-}
-async function downloadWordPress(wordPressVersion = DEFAULT_WORDPRESS_VERSION) {
-  const finalFolder = path11.join(getWordpressVersionsPath(), wordPressVersion);
-  if (isClassicPressVersion(wordPressVersion)) {
-    return downloadClassicPress(wordPressVersion, finalFolder);
-  }
-  const tempFolder = os3.tmpdir();
-  const { downloaded, statusCode } = await downloadFileAndUnzip({
-    url: getWordPressVersionUrl(wordPressVersion),
-    destinationFolder: tempFolder,
-    checkFinalPath: finalFolder,
-    itemName: `WordPress ${wordPressVersion}`
-  });
-  if (downloaded) {
-    fs8.ensureDirSync(path11.dirname(finalFolder));
-    fs8.moveSync(path11.join(tempFolder, "wordpress"), finalFolder, {
-      overwrite: true
-    });
-  } else if (404 === statusCode) {
-    output?.log(
-      `WordPress ${wordPressVersion} not found. Check https://wordpress.org/download/releases/ for available versions.`
-    );
-    process.exit(1);
+    const bytes = Buffer.from(await response.arrayBuffer());
+    fs9.writeFileSync(`${cacheFile}.partial`, bytes);
+    fs9.renameSync(`${cacheFile}.partial`, cacheFile);
+    output?.log(`Cached ${cacheKey} (${bytes.length} bytes).`);
   }
+  return new File([fs9.readFileSync(cacheFile)], cacheKey);
 }
-async function downloadClassicPress(version, finalFolder) {
-  const tempFolder = path11.join(os3.tmpdir(), `wp-app-classicpress-${Date.now()}`);
-  const { downloaded, statusCode } = await downloadFileAndUnzip({
-    url: getClassicPressVersionUrl(version),
-    destinationFolder: tempFolder,
-    checkFinalPath: finalFolder,
-    itemName: `ClassicPress ${version}`
-  });
-  if (downloaded) {
-    fs8.ensureDirSync(path11.dirname(finalFolder));
-    const entries = fs8.readdirSync(tempFolder);
-    const singleDirRoot = entries.length === 1 && fs8.statSync(path11.join(tempFolder, entries[0])).isDirectory() ? path11.join(tempFolder, entries[0]) : null;
-    fs8.moveSync(singleDirRoot ?? tempFolder, finalFolder, {
-      overwrite: true
-    });
-    fs8.removeSync(tempFolder);
-  } else if (404 === statusCode) {
-    output?.log(
-      `ClassicPress ${version} not found. Check https://www.classicpress.net for available releases.`
-    );
-    process.exit(1);
+async function getCoreZip(version) {
+  if (isClassicPressVersion(version)) {
+    return cachedZip(getClassicPressVersionUrl(version), `${version}.zip`);
   }
+  return cachedZip(getWordPressVersionUrl(version), `wordpress-${version}.zip`);
 }
-async function downloadSqliteIntegrationPlugin() {
-  return downloadFileAndUnzip({
-    url: SQLITE_URL,
-    destinationFolder: getWpNowPath(),
-    checkFinalPath: getSqlitePath(),
-    itemName: "SQLite"
-  });
+async function getSqliteIntegrationZip() {
+  return cachedZip(SQLITE_URL, "sqlite-database-integration.zip");
 }
-async function downloadMuPlugins() {
-  fs8.ensureDirSync(path11.join(getWpNowPath(), "mu-plugins"));
-  fs8.writeFile(
-    path11.join(getWpNowPath(), "mu-plugins", "0-allow-wp-org.php"),
-    `<?php
-	// Needed because gethostbyname( 'wordpress.org' ) returns
-	// a private network IP address for some reason.
-	add_filter( 'allowed_redirect_hosts', function( $deprecated = '' ) {
-		return array(
-			'wordpress.org',
-			'api.wordpress.org',
-			'downloads.wordpress.org',
-		);
-	} );`
-  );
-}
-
-// src/wp-now.ts
-import {
-  activatePlugin,
-  activateTheme,
-  defineWpConfigConsts,
-  login
-} from "@wp-playground/blueprints";
 
 // src/config.ts
-import {
-  SupportedPHPVersionsList
-} from "@php-wasm/universal";
-import crypto from "crypto";
+import { SupportedPHPVersionsList } from "@php-wasm/universal";
 
 // src/github-codespaces.ts
 var isGitHubCodespace = Boolean(
@@ -385,15 +227,61 @@ function getCodeSpaceURL(port) {
   return `https://${process.env.CODESPACE_NAME}-${port}.${process.env.GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN}`;
 }
 
+// src/port-finder.ts
+import http from "http";
+var PortFinder = class _PortFinder {
+  static #instance;
+  #searchPort = DEFAULT_PORT;
+  #openPort = null;
+  constructor() {
+  }
+  static getInstance() {
+    if (!_PortFinder.#instance) {
+      _PortFinder.#instance = new _PortFinder();
+    }
+    return _PortFinder.#instance;
+  }
+  #incrementPort() {
+    return this.#searchPort++;
+  }
+  #isPortFree() {
+    return new Promise((resolve) => {
+      const server = http.createServer();
+      server.listen(this.#searchPort, () => {
+        server.close();
+        resolve(true);
+      }).on("error", () => {
+        resolve(false);
+      });
+    });
+  }
+  /**
+   * Returns the first available open port, caching and reusing it for subsequent calls.
+   *
+   * @returns {Promise<number>} A promise that resolves to the open port number.
+   */
+  async getOpenPort() {
+    if (this.#openPort) {
+      return this.#openPort;
+    }
+    while (!await this.#isPortFree()) {
+      this.#incrementPort();
+    }
+    this.#openPort = this.#searchPort;
+    return this.#openPort;
+  }
+  setPort(port) {
+    this.#openPort = port;
+  }
+};
+var portFinder = PortFinder.getInstance();
+
 // src/config.ts
-import path12 from "path";
 var DEFAULT_OPTIONS = {
   phpVersion: DEFAULT_PHP_VERSION,
   wordPressVersion: DEFAULT_WORDPRESS_VERSION,
-  documentRoot: "/var/www/html",
   projectPath: process.cwd(),
-  mode: "auto" /* AUTO */,
-  numberOfPhpInstances: 1
+  mode: "auto" /* AUTO */
 };
 async function getAbsoluteURL() {
   const port = await portFinder.getOpenPort();
@@ -402,13 +290,7 @@ async function getAbsoluteURL() {
   }
   return `http://localhost:${port}`;
 }
-function getWpContentHomePath(projectPath, mode) {
-  const basename2 = path12.basename(projectPath);
-  const directoryHash = crypto.createHash("sha1").update(projectPath).digest("hex");
-  const projectDirectory = mode === "playground" /* PLAYGROUND */ ? "playground" : `${basename2}-${directoryHash}`;
-  return path12.join(getWpNowPath(), "wp-content", projectDirectory);
-}
-async function getWpNowConfig(args) {
+async function getWpAppConfig(args) {
   if (args.port) {
     portFinder.setPort(args.port);
   }
@@ -431,12 +313,6 @@ async function getWpNowConfig(args) {
   if (!options.mode || options.mode === "auto") {
     options.mode = inferMode(options.projectPath);
   }
-  if (!options.wpContentPath) {
-    options.wpContentPath = getWpContentHomePath(
-      options.projectPath,
-      options.mode
-    );
-  }
   if (!options.absoluteUrl) {
     options.absoluteUrl = await getAbsoluteURL();
   }
@@ -453,241 +329,145 @@ async function getWpNowConfig(args) {
   return options;
 }
 
-// src/wp-now.ts
-function seemsLikeAPHPFile(path15) {
-  return path15.endsWith(".php") || path15.includes(".php/");
-}
-async function applyToInstances(phpInstances, callback) {
-  for (let i = 0; i < phpInstances.length; i++) {
-    await callback(phpInstances[i]);
-  }
-}
-async function startWPNow(options = {}) {
-  const { documentRoot } = options;
-  const nodePHPOptions = {
-    requestHandler: {
-      documentRoot,
-      absoluteUrl: options.absoluteUrl,
-      isStaticFilePath: (path15) => {
-        try {
-          const fullPath = options.documentRoot + path15;
-          return php.fileExists(fullPath) && !php.isDir(fullPath) && !seemsLikeAPHPFile(fullPath);
-        } catch (e) {
-          output?.error(e);
-          return false;
-        }
-      }
-    }
-  };
-  const phpInstances = [];
-  for (let i = 0; i < Math.max(options.numberOfPhpInstances, 1); i++) {
-    phpInstances.push(
-      await NodePHP.load(options.phpVersion, nodePHPOptions)
-    );
-  }
-  const php = phpInstances[0];
-  phpInstances.forEach((_php) => {
-    _php.mkdirTree(documentRoot);
-    _php.chdir(documentRoot);
-    _php.writeFile(
-      `${documentRoot}/index.php`,
-      `<?php echo 'Hello wp-app!';`
-    );
-  });
+// src/engine.ts
+async function startWPApp(options) {
+  const projectPath = path9.resolve(options.projectPath);
+  const mode = options.mode;
   output?.log(`directory: ${options.projectPath}`);
-  output?.log(`mode: ${options.mode}`);
+  output?.log(`mode: ${mode}`);
   output?.log(`php: ${options.phpVersion}`);
-  if (options.mode === "index" /* INDEX */) {
-    await applyToInstances(phpInstances, async (_php) => {
-      runIndexMode(_php, options);
-    });
-    return { php, phpInstances, options };
-  }
-  output?.log(`wp: ${options.wordPressVersion}`);
-  await Promise.all([
-    downloadWordPress(options.wordPressVersion),
-    downloadSqliteIntegrationPlugin(),
-    downloadMuPlugins()
-  ]);
-  const isFirstTimeProject = !fs9.existsSync(options.wpContentPath);
-  await applyToInstances(phpInstances, async (_php) => {
-    switch (options.mode) {
-      case "wp-content" /* WP_CONTENT */:
-        await runWpContentMode(_php, options);
-        break;
-      case "wordpress-develop" /* WORDPRESS_DEVELOP */:
-        await runWordPressDevelopMode(_php, options);
-        break;
-      case "wordpress" /* WORDPRESS */:
-        await runWordPressMode(_php, options);
-        break;
-      case "plugin" /* PLUGIN */:
-        await runPluginOrThemeMode(_php, options);
-        break;
-      case "theme" /* THEME */:
-        await runPluginOrThemeMode(_php, options);
-        break;
-      case "playground" /* PLAYGROUND */:
-        await runWpPlaygroundMode(_php, options);
-        break;
-    }
-  });
-  await installationStep2(php);
-  await login(php, {
-    username: "admin",
-    password: "password"
+  const hostDocroot = mode === "index" /* INDEX */ || mode === "wordpress" /* WORDPRESS */ ? projectPath : mode === "wordpress-develop" /* WORDPRESS_DEVELOP */ ? path9.join(projectPath, "build") : ensureDir(getSitePath(projectPath));
+  const isWordPressBacked = mode !== "index" /* INDEX */;
+  const freshSite = isWordPressBacked && !fs10.existsSync(path9.join(hostDocroot, "wp-load.php"));
+  if (isWordPressBacked) {
+    output?.log(`wp: ${options.wordPressVersion}`);
+    output?.log(`site data: ${hostDocroot}`);
+  }
+  const requestHandler = await bootWordPressAndRequestHandler({
+    siteUrl: options.absoluteUrl,
+    documentRoot: DOCROOT,
+    phpVersion: options.phpVersion,
+    maxPhpInstances: 1,
+    sapiName: "cli",
+    cookieStore: false,
+    createPhpRuntime: () => loadNodeRuntime(options.phpVersion, {
+      emscriptenOptions: { processId: process.pid }
+    }),
+    hooks: {
+      beforeWordPressFiles: async (php2) => {
+        php2.mkdir(DOCROOT);
+        await php2.mount(
+          DOCROOT,
+          createNodeFsMountHandler(hostDocroot)
+        );
+      }
+    },
+    wordPressZip: freshSite ? await getCoreZip(options.wordPressVersion) : void 0,
+    sqliteIntegrationPluginZip: isWordPressBacked ? await getSqliteIntegrationZip() : void 0,
+    dataSqlPath: isWordPressBacked ? `${DOCROOT}/wp-content/database/.ht.sqlite` : void 0,
+    wordpressInstallMode: isWordPressBacked ? "install-from-existing-files-if-needed" : "do-not-attempt-installing"
   });
-  if (isFirstTimeProject && ["plugin" /* PLUGIN */, "theme" /* THEME */].includes(options.mode)) {
-    await activatePluginOrTheme(php, options);
+  const php = await requestHandler.getPrimaryPhp();
+  await applyProjectMounts(php, mode, projectPath);
+  if (freshSite) {
+    await activateProject(php, mode, projectPath);
+  }
+  return { requestHandler, php, options, freshSite };
+}
+async function applyProjectMounts(php, mode, projectPath) {
+  const projectName = path9.basename(projectPath);
+  switch (mode) {
+    case "theme" /* THEME */:
+      await mountAt(
+        php,
+        projectPath,
+        `${DOCROOT}/wp-content/themes/${projectName}`
+      );
+      break;
+    case "plugin" /* PLUGIN */:
+      await mountAt(
+        php,
+        projectPath,
+        `${DOCROOT}/wp-content/plugins/${projectName}`
+      );
+      break;
+    case "wp-content" /* WP_CONTENT */:
+      for (const entry of fs10.readdirSync(projectPath)) {
+        if (entry === "index.php") {
+          continue;
+        }
+        await mountAt(
+          php,
+          path9.join(projectPath, entry),
+          `${DOCROOT}/wp-content/${entry}`
+        );
+      }
+      break;
+    default:
+      break;
   }
-  return {
-    php,
-    phpInstances,
-    options
-  };
 }
-async function runIndexMode(php, { documentRoot, projectPath }) {
-  php.mount(projectPath, documentRoot);
-}
-async function runWpContentMode(php, {
-  documentRoot,
-  wordPressVersion,
-  wpContentPath,
-  projectPath,
-  absoluteUrl
-}) {
-  const wordPressPath = path13.join(
-    getWordpressVersionsPath(),
-    wordPressVersion
-  );
-  php.mount(wordPressPath, documentRoot);
-  await initWordPress(php, wordPressVersion, documentRoot, absoluteUrl);
-  fs9.ensureDirSync(wpContentPath);
-  php.mount(projectPath, `${documentRoot}/wp-content`);
-  mountSqlitePlugin(php, documentRoot);
-  mountSqliteDatabaseDirectory(php, documentRoot, wpContentPath);
-  mountMuPlugins(php, documentRoot);
-}
-async function runWordPressDevelopMode(php, { documentRoot, projectPath, absoluteUrl }) {
-  await runWordPressMode(php, {
-    documentRoot,
-    projectPath: projectPath + "/build",
-    absoluteUrl
-  });
-}
-async function runWordPressMode(php, { documentRoot, wpContentPath, projectPath, absoluteUrl }) {
-  php.mount(projectPath, documentRoot);
-  const { initializeDefaultDatabase } = await initWordPress(
-    php,
-    "user-provided",
-    documentRoot,
-    absoluteUrl
-  );
-  if (initializeDefaultDatabase || fs9.existsSync(path13.join(wpContentPath, "database"))) {
-    mountSqlitePlugin(php, documentRoot);
-    mountSqliteDatabaseDirectory(php, documentRoot, wpContentPath);
+async function mountAt(php, hostPath, vfsPath) {
+  if (fs10.statSync(hostPath).isDirectory()) {
+    php.mkdir(vfsPath);
   }
-  mountMuPlugins(php, documentRoot);
+  await php.mount(vfsPath, createNodeFsMountHandler(hostPath));
 }
-async function runPluginOrThemeMode(php, {
-  wordPressVersion,
-  documentRoot,
-  projectPath,
-  wpContentPath,
-  absoluteUrl,
-  mode
-}) {
-  const wordPressPath = path13.join(
-    getWordpressVersionsPath(),
-    wordPressVersion
-  );
-  php.mount(wordPressPath, documentRoot);
-  await initWordPress(php, wordPressVersion, documentRoot, absoluteUrl);
-  fs9.ensureDirSync(wpContentPath);
-  fs9.copySync(
-    path13.join(getWordpressVersionsPath(), wordPressVersion, "wp-content"),
-    wpContentPath
-  );
-  php.mount(wpContentPath, `${documentRoot}/wp-content`);
-  const pluginName = path13.basename(projectPath);
-  const directoryName = mode === "plugin" /* PLUGIN */ ? "plugins" : "themes";
-  php.mount(
-    projectPath,
-    `${documentRoot}/wp-content/${directoryName}/${pluginName}`
-  );
-  mountSqlitePlugin(php, documentRoot);
-  mountMuPlugins(php, documentRoot);
-}
-async function runWpPlaygroundMode(php, { documentRoot, wordPressVersion, wpContentPath, absoluteUrl }) {
-  const wordPressPath = path13.join(
-    getWordpressVersionsPath(),
-    wordPressVersion
-  );
-  php.mount(wordPressPath, documentRoot);
-  await initWordPress(php, wordPressVersion, documentRoot, absoluteUrl);
-  fs9.ensureDirSync(wpContentPath);
-  fs9.copySync(
-    path13.join(getWordpressVersionsPath(), wordPressVersion, "wp-content"),
-    wpContentPath
-  );
-  php.mount(wpContentPath, `${documentRoot}/wp-content`);
-  mountSqlitePlugin(php, documentRoot);
-  mountMuPlugins(php, documentRoot);
-}
-async function initWordPress(php, wordPressVersion, vfsDocumentRoot, siteUrl) {
-  let initializeDefaultDatabase = false;
-  if (!php.fileExists(`${vfsDocumentRoot}/wp-config.php`)) {
-    php.writeFile(
-      `${vfsDocumentRoot}/wp-config.php`,
-      php.readFileAsText(`${vfsDocumentRoot}/wp-config-sample.php`)
+async function activateProject(php, mode, projectPath) {
+  const projectName = path9.basename(projectPath);
+  if (mode === "theme" /* THEME */) {
+    await runWordPressCode(
+      php,
+      `switch_theme(${phpString(projectName)});`
+    );
+  } else if (mode === "plugin" /* PLUGIN */) {
+    const pluginFile = findPluginFile(projectPath);
+    if (pluginFile) {
+      await runWordPressCode(
+        php,
+        `activate_plugin(${phpString(`${projectName}/${pluginFile}`)});`
+      );
+    }
+  } else if (mode === "wp-content" /* WP_CONTENT */) {
+    await runWordPressCode(
+      php,
+      `$theme = wp_get_theme();
+			if (!$theme->exists()) {
+				$themes = wp_get_themes();
+				if (count($themes) > 0) {
+					switch_theme(array_keys($themes)[0]);
+				}
+			}`
     );
-    initializeDefaultDatabase = true;
-  }
-  const wpConfigConsts = {
-    WP_HOME: siteUrl,
-    WP_SITEURL: siteUrl
-  };
-  if (wordPressVersion !== "user-defined") {
-    wpConfigConsts["WP_AUTO_UPDATE_CORE"] = wordPressVersion === "latest";
   }
-  await defineWpConfigConsts(php, {
-    consts: wpConfigConsts,
-    virtualize: true
-  });
-  return { initializeDefaultDatabase };
 }
-async function activatePluginOrTheme(php, { projectPath, mode }) {
-  if (mode === "plugin" /* PLUGIN */) {
-    const pluginFile = getPluginFile(projectPath);
-    await activatePlugin(php, { pluginPath: pluginFile });
-  } else if (mode === "theme" /* THEME */) {
-    const themeFolderName = path13.basename(projectPath);
-    await activateTheme(php, { themeFolderName });
+async function runWordPressCode(php, code) {
+  const response = await php.run({
+    code: `<?php
+			require ${phpString(`${DOCROOT}/wp-load.php`)};
+			require_once ${phpString(`${DOCROOT}/wp-admin/includes/plugin.php`)};
+			${code}
+		`
+  });
+  if (response.exitCode !== 0) {
+    output?.error(`Activation step failed: ${response.errors}`);
   }
 }
-function mountMuPlugins(php, vfsDocumentRoot) {
-  php.mount(
-    path13.join(getWpNowPath(), "mu-plugins"),
-    // VFS paths are always POSIX — path.join would break them on Windows.
-    `${vfsDocumentRoot}/wp-content/mu-plugins`
-  );
+function phpString(value) {
+  return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
 }
-function mountSqlitePlugin(php, vfsDocumentRoot) {
-  const sqlitePluginPath = `${vfsDocumentRoot}/wp-content/plugins/${SQLITE_FILENAME}`;
-  if (php.listFiles(sqlitePluginPath).length === 0) {
-    php.mount(getSqlitePath(), sqlitePluginPath);
-    php.mount(
-      path13.join(getSqlitePath(), "db.copy"),
-      `${vfsDocumentRoot}/wp-content/db.php`
-    );
+function findPluginFile(projectPath) {
+  const pluginNameRegex = /^(?:[ \t]*<\?php)?[ \t/*#@]*Plugin Name:(.*)$/im;
+  for (const file of fs10.readdirSync(projectPath)) {
+    if (!file.endsWith(".php")) {
+      continue;
+    }
+    const content = fs10.readFileSync(path9.join(projectPath, file), "utf8");
+    if (pluginNameRegex.test(content)) {
+      return file;
+    }
   }
-}
-function mountSqliteDatabaseDirectory(php, vfsDocumentRoot, wpContentPath) {
-  fs9.ensureDirSync(path13.join(wpContentPath, "database"));
-  php.mount(
-    path13.join(wpContentPath, "database"),
-    `${vfsDocumentRoot}/wp-content/database`
-  );
+  return null;
 }
 function inferMode(projectPath) {
   if (isWordPressDevelopDirectory(projectPath)) {
@@ -705,136 +485,107 @@ function inferMode(projectPath) {
   }
   return "playground" /* PLAYGROUND */;
 }
-async function installationStep2(php) {
-  const fields = new URLSearchParams({
-    language: "en",
-    prefix: "wp_",
-    weblog_title: "My WordPress Website",
-    user_name: "admin",
-    admin_password: "password",
-    admin_password2: "password",
-    Submit: "Install WordPress",
-    pw_weak: "1",
-    admin_email: "admin@localhost.com"
-  });
-  return php.request({
-    url: "/wp-admin/install.php?step=2",
-    method: "POST",
-    headers: {
-      "content-type": "application/x-www-form-urlencoded"
-    },
-    body: fields.toString()
-  });
-}
 
 // src/start-server.ts
-function requestBodyToMultipartFormData(json, boundary) {
-  let multipartData = "";
-  const eol = "\r\n";
-  for (const key in json) {
-    multipartData += `--${boundary}${eol}`;
-    multipartData += `Content-Disposition: form-data; name="${key}"${eol}${eol}`;
-    multipartData += `${json[key]}${eol}`;
-  }
-  multipartData += `--${boundary}--${eol}`;
-  return multipartData;
-}
-var requestBodyToString = async (req) => await new Promise((resolve) => {
-  let body = "";
-  req.on("data", (chunk) => {
-    body += chunk.toString();
-  });
-  req.on("end", () => {
-    resolve(body);
-  });
-});
 async function startServer(options = {}) {
-  if (!fs10.existsSync(options.projectPath)) {
+  if (!fs11.existsSync(options.projectPath)) {
     throw new Error(
       `The given path "${options.projectPath}" does not exist.`
     );
   }
-  const app = express();
-  app.use(fileUpload());
   const port = await portFinder.getOpenPort();
-  const { php, options: wpNowOptions } = await startWPNow(options);
+  const site = await startWPApp(options);
+  const app = express();
   app.use("/", async (req, res) => {
     try {
-      const requestHeaders = {};
-      if (req.rawHeaders && req.rawHeaders.length) {
-        for (let i = 0; i < req.rawHeaders.length; i += 2) {
-          requestHeaders[req.rawHeaders[i].toLowerCase()] = req.rawHeaders[i + 1];
-        }
-      }
-      const body = requestHeaders["content-type"]?.startsWith(
-        "multipart/form-data"
-      ) ? requestBodyToMultipartFormData(
-        req.body,
-        requestHeaders["content-type"].split("; boundary=")[1]
-      ) : await requestBodyToString(req);
-      const data = {
+      const phpRequest = {
         url: req.url,
-        headers: requestHeaders,
         method: req.method,
-        files: Object.fromEntries(
-          Object.entries(req.files || {}).map(
-            ([key, file]) => [
-              key,
-              {
-                key,
-                name: file.name,
-                size: file.size,
-                type: file.mimetype,
-                arrayBuffer: () => file.data.buffer
-              }
-            ]
-          )
-        ),
-        body
+        headers: parseHeaders(req),
+        body: await bufferRequestBody(req)
       };
-      const resp = await php.request(data);
-      res.statusCode = resp.httpStatusCode;
-      Object.keys(resp.headers).forEach((key) => {
-        res.setHeader(key, resp.headers[key]);
-      });
-      res.end(resp.bytes);
-    } catch (e) {
-      output?.trace(e);
+      const response = await site.requestHandler.requestStreamed(phpRequest);
+      await sendStreamedResponse(response, res);
+    } catch (error) {
+      output?.trace(error);
+      if (!res.headersSent) {
+        res.statusCode = 500;
+        res.end("Internal Server Error");
+      }
     }
   });
   const url = options.absoluteUrl;
   app.listen(port, () => {
     output?.log(`Server running at ${url}`);
   });
-  return {
-    url,
-    php,
-    options: wpNowOptions
-  };
+  return { ...site, url };
 }
+async function sendStreamedResponse(streamedResponse, res) {
+  const [headers, httpStatusCode] = await Promise.all([
+    streamedResponse.headers,
+    streamedResponse.httpStatusCode
+  ]);
+  res.statusCode = httpStatusCode;
+  for (const key in headers) {
+    res.setHeader(key, headers[key]);
+  }
+  const nodeStream = Readable.fromWeb(streamedResponse.stdout);
+  try {
+    await pipeline(nodeStream, res);
+  } catch (error) {
+    if (error instanceof Error && "code" in error && (error.code === "ERR_STREAM_PREMATURE_CLOSE" || error.code === "ERR_STREAM_UNABLE_TO_PIPE")) {
+      return;
+    }
+    throw error;
+  }
+}
+var bufferRequestBody = async (req) => await new Promise((resolve) => {
+  const body = [];
+  req.on("data", (chunk) => {
+    body.push(chunk);
+  });
+  req.on("end", () => {
+    resolve(new Uint8Array(Buffer.concat(body)));
+  });
+});
+var parseHeaders = (req) => {
+  const requestHeaders = {};
+  if (req.rawHeaders && req.rawHeaders.length) {
+    for (let i = 0; i < req.rawHeaders.length; i += 2) {
+      requestHeaders[req.rawHeaders[i].toLowerCase()] = req.rawHeaders[i + 1];
+    }
+  }
+  return requestHeaders;
+};
 
 // src/execute-php.ts
-async function executePHP(phpArgs, options = {}) {
-  if (phpArgs[0] !== "php") {
+import fs12 from "fs";
+import path10 from "path";
+import { loadNodeRuntime as loadNodeRuntime2 } from "@php-wasm/node";
+import { PHP } from "@php-wasm/universal";
+async function executePHP(phpArgs, options) {
+  const args = phpArgs.filter((arg) => arg !== "php" && arg !== "--");
+  let code;
+  if (args[0] === "-r" && typeof args[1] === "string") {
+    code = `<?php ${args[1]}`;
+  } else if (args[0] && fs12.existsSync(path10.resolve(args[0]))) {
+    code = fs12.readFileSync(path10.resolve(args[0]), "utf8");
+  } else {
     throw new Error(
-      'The first argument to executePHP must be the string "php".'
+      'Usage: wp-app php -- -r "<code>" | wp-app php -- <script.php>'
     );
   }
-  disableOutput();
-  const { phpInstances } = await startWPNow({
-    ...options,
-    numberOfPhpInstances: 2
-  });
-  const [, php] = phpInstances;
-  try {
-    php.useHostFilesystem();
-    await php.cli(phpArgs);
-  } catch (resultOrError) {
-    const success = resultOrError.name === "ExitStatus" && resultOrError.status === 0;
-    if (!success) {
-      throw resultOrError;
-    }
+  const php = new PHP(
+    await loadNodeRuntime2(options.phpVersion, {
+      emscriptenOptions: { processId: process.pid }
+    })
+  );
+  const response = await php.run({ code });
+  process.stdout.write(response.bytes);
+  if (response.errors) {
+    process.stderr.write(response.errors);
   }
+  process.exitCode = response.exitCode;
 }
 
 // src/run-cli.ts
@@ -900,7 +651,7 @@ async function runCli() {
       config.mode = argv.mode;
     }
     try {
-      await getWpNowConfig(config);
+      await getWpAppConfig(config);
     } catch (error) {
       return error.message;
     }
@@ -911,7 +662,7 @@ async function runCli() {
     (yargs2) => {
       serverParameters(yargs2);
       yargs2.option("reset", {
-        describe: "Create a new project environment, destroying the old one (wp-content and database).",
+        describe: "Create a new site environment, destroying the old one (WordPress files and database).",
         type: "boolean",
         default: false
       });
@@ -924,7 +675,7 @@ async function runCli() {
     async (argv) => {
       const spinner = startSpinner("Starting the server...");
       try {
-        const options = await getWpNowConfig({
+        const options = await getWpAppConfig({
           path: argv.path,
           php: argv.php,
           wp: argv.wp,
@@ -933,8 +684,21 @@ async function runCli() {
         });
         portFinder.setPort(options.port);
         if (argv.reset) {
-          fs11.removeSync(options.wpContentPath);
-          output?.log("Project environment reset.");
+          if (["wordpress", "wordpress-develop", "index"].includes(
+            options.mode
+          )) {
+            output?.log(
+              "--reset only applies to wp-app managed sites; your project files are never touched."
+            );
+          } else {
+            fs13.rmSync(getSitePath(options.projectPath), {
+              recursive: true,
+              force: true,
+              maxRetries: 10,
+              retryDelay: 100
+            });
+            output?.log("Site environment reset.");
+          }
         }
         const { url } = await startServer(options);
         if (argv.open) {
@@ -957,7 +721,7 @@ async function runCli() {
     async (argv) => {
       try {
         const args = process.argv.slice(2);
-        const options = await getWpNowConfig({
+        const options = await getWpAppConfig({
           path: argv.path,
           php: argv.php
         });
@@ -976,9 +740,9 @@ async function runCli() {
       commonParameters(yargs2);
     },
     async (argv) => {
-      const projectPath = argv.path ? path14.resolve(argv.path) : process.cwd();
+      const projectPath = argv.path ? path11.resolve(argv.path) : process.cwd();
       console.log(`Building project at ${projectPath}`);
-      if (fs11.existsSync(path14.join(projectPath, "composer.json"))) {
+      if (fs13.existsSync(path11.join(projectPath, "composer.json"))) {
         console.log("Running composer install...");
         try {
           execSync(
@@ -991,9 +755,11 @@ async function runCli() {
           );
         }
       }
-      const packageJsonPath = path14.join(projectPath, "package.json");
-      if (fs11.existsSync(packageJsonPath)) {
-        const pkg = fs11.readJsonSync(packageJsonPath);
+      const packageJsonPath = path11.join(projectPath, "package.json");
+      if (fs13.existsSync(packageJsonPath)) {
+        const pkg = JSON.parse(
+          fs13.readFileSync(packageJsonPath, "utf8")
+        );
         if (pkg.scripts?.build) {
           console.log("Running npm build...");
           execSync("npm run build", {
@@ -1012,7 +778,7 @@ async function runCli() {
     },
     async (argv) => {
       const selfScript = process.argv[1];
-      const watchDir = path14.resolve(
+      const watchDir = path11.resolve(
         argv.path || process.cwd()
       );
       const IGNORED = ["node_modules", "vendor", ".git", "dist"];
@@ -1033,7 +799,7 @@ async function runCli() {
         });
       };
       startChild();
-      fs11.watch(
+      fs13.watch(
         watchDir,
         { recursive: true },
         (_eventType, filename) => {
@@ -1086,11 +852,11 @@ function openInDefaultBrowser(url) {
 }
 
 // src/main.ts
-var requiredMajorVersion = 18;
+var requiredMajorVersion = 20;
 var currentNodeVersion = parseInt(process.versions?.node?.split(".")?.[0]);
 if (currentNodeVersion < requiredMajorVersion) {
   console.warn(
-    `You are running Node.js version ${currentNodeVersion}, but this application recommends at least Node.js ${requiredMajorVersion} and isn't guaranteed to work on lower versions. Please upgrade your Node.js version.`
+    `You are running Node.js version ${currentNodeVersion}, but this application requires at least Node.js ${requiredMajorVersion}. Please upgrade your Node.js version.`
   );
 }
 runCli();