@php-wasm/universal 1.2.2 → 1.2.3

package/index.js

@@ -1,13 +1,18 @@
-var W = (t) => {
+var q = (t) => {
   throw TypeError(t);
 };
-var q = (t, e, r) => e.has(t) || W("Cannot " + r);
-var u = (t, e, r) => (q(t, e, "read from private field"), r ? r.call(t) : e.get(t)), y = (t, e, r) => e.has(t) ? W("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, r), g = (t, e, r, s) => (q(t, e, "write to private field"), s ? s.call(t, r) : e.set(t, r), r), m = (t, e, r) => (q(t, e, "access private method"), r);
+var N = (t, e, r) => e.has(t) || q("Cannot " + r);
+var u = (t, e, r) => (N(t, e, "read from private field"), r ? r.call(t) : e.get(t)), _ = (t, e, r) => e.has(t) ? q("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, r), f = (t, e, r, s) => (N(t, e, "write to private field"), s ? s.call(t, r) : e.set(t, r), r), m = (t, e, r) => (N(t, e, "access private method"), r);
 import "@php-wasm/node-polyfills";
 import { logger } from "@php-wasm/logger";
 import { dirname, joinPaths, Semaphore, createSpawnHandler, normalizePath, AcquireTimeoutError } from "@php-wasm/util";
 import { parse, stringify } from "ini";
 import { StreamedFile } from "@php-wasm/stream-compression";
+class ErrnoError extends Error {
+  constructor(e, r, s) {
+    super(r, s), this.name = "ErrnoError", this.errno = e;
+  }
+}
 const FileErrorCodes = {
   0: "No error occurred. System call completed successfully.",
   1: "Argument list too long.",
@@ -100,10 +105,14 @@ function rethrowFileSystemError(t = "") {
       } catch (n) {
         const i = typeof n == "object" ? n == null ? void 0 : n.errno : null;
         if (i in FileErrorCodes) {
-          const o = FileErrorCodes[i], a = typeof s[1] == "string" ? s[1] : null, c = a !== null ? t.replaceAll("{path}", a) : t;
-          throw new Error(`${c}: ${o}`, {
-            cause: n
-          });
+          const o = FileErrorCodes[i], a = typeof s[1] == "string" ? s[1] : null, l = a !== null ? t.replaceAll("{path}", a) : t;
+          throw new ErrnoError(
+            i,
+            `${l}: ${o}`,
+            {
+              cause: n
+            }
+          );
         }
         throw n;
       }
@@ -184,9 +193,12 @@ class FSHelpers {
    * @param options Options for the removal.
    */
   static rmdir(e, r, s = { recursive: !0 }) {
-    s != null && s.recursive && FSHelpers.listFiles(e, r).forEach((n) => {
-      const i = `${r}/${n}`;
-      FSHelpers.isDir(e, i) ? FSHelpers.rmdir(e, i, s) : FSHelpers.unlink(e, i);
+    const n = e.lookupPath(r, { follow: !1 });
+    if ((n == null ? void 0 : n.node.mount.mountpoint) === r)
+      throw new ErrnoError(10);
+    s != null && s.recursive && FSHelpers.listFiles(e, r).forEach((i) => {
+      const o = `${r}/${i}`;
+      FSHelpers.isDir(e, o) ? FSHelpers.rmdir(e, o, s) : FSHelpers.unlink(e, o);
     }), e.getPath(e.lookupPath(r).node) === e.cwd() && e.chdir(joinPaths(e.cwd(), "..")), e.rmdir(r);
   }
   /**
@@ -311,8 +323,7 @@ class FSHelpers {
           joinPaths(r, o),
           joinPaths(s, o)
         );
-    } else
-      e.writeFile(s, e.readFile(r));
+    } else e.isLink(n.mode) ? e.symlink(e.readlink(r), s) : e.writeFile(s, e.readFile(r));
   }
 }
 FSHelpers.readFileAsText = rethrowFileSystemError('Could not read "{path}"')(
@@ -649,14 +660,14 @@ const RuntimeId = Symbol("RuntimeId"), loadedRuntimes = /* @__PURE__ */ new Map(
 let lastRuntimeId = 0;
 async function loadPHPRuntime(t, ...e) {
   const r = Object.assign({}, ...e), [s, n, i] = makePromise(), o = t.init(currentJsRuntime, {
-    onAbort(c) {
-      i(c), logger.error(c);
+    onAbort(l) {
+      i(l), logger.error(l);
     },
     ENV: {},
     // Emscripten sometimes prepends a '/' to the path, which
     // breaks vite dev mode. An identity `locateFile` function
     // fixes it.
-    locateFile: (c) => c,
+    locateFile: (l) => l,
     ...r,
     noInitialRun: !0,
     onRuntimeInitialized() {
@@ -665,8 +676,8 @@ async function loadPHPRuntime(t, ...e) {
   });
   await s;
   const a = ++lastRuntimeId;
-  return o.FS, o.id = a, o.originalExit = o._exit, o._exit = function(c) {
-    return o.outboundNetworkProxyServer && (o.outboundNetworkProxyServer.close(), o.outboundNetworkProxyServer.closeAllConnections()), loadedRuntimes.delete(a), o.originalExit(c);
+  return o.FS, o.id = a, o.originalExit = o._exit, o._exit = function(l) {
+    return o.outboundNetworkProxyServer && (o.outboundNetworkProxyServer.close(), o.outboundNetworkProxyServer.closeAllConnections()), loadedRuntimes.delete(a), o.originalExit(l);
   }, o[RuntimeId] = a, loadedRuntimes.set(a, o), a;
 }
 function getLoadedRuntime(t) {
@@ -747,11 +758,9 @@ function improveWASMErrorReporting(t) {
             (i = t.lastAsyncifyStackSource) == null ? void 0 : i.stack
           );
           if (e.hasListeners()) {
-            const c = new ErrorEvent("error", {
-              error: o,
-              message: a
-            });
-            throw e.dispatchEvent(c), o;
+            o.message = a;
+            const l = new ErrorEvent("error", { error: o });
+            throw e.dispatchEvent(l), o;
           }
           throw (!isExitCode(o) || o.status !== 0) && showCriticalErrorBox(a), o;
         }
@@ -769,7 +778,7 @@ function clarifyErrorMessage(t, e) {
     e || (r += `
 
 This stack trace is lacking. For a better one initialize 
-the PHP runtime with { debug: true }, e.g. PHPNode.load('8.1', { debug: true }).
+the PHP runtime with debug: true, e.g. loadNodeRuntime('8.1', { emscriptenOptions: { debug: true } }).
 
 `);
     const s = new Set(
@@ -787,7 +796,8 @@ the PHP runtime with { debug: true }, e.g. PHPNode.load('8.1', { debug: true }).
     for (const i of s)
       r += `    * ${i}
 `;
-    return r;
+    return r += `Original error message: ${t.message}
+`, r;
   }
   return t.message;
 }
@@ -852,7 +862,7 @@ class PHPExecutionFailureError extends Error {
   }
 }
 const PHP_INI_PATH = "/internal/shared/php.ini", AUTO_PREPEND_SCRIPT = "/internal/shared/auto_prepend_file.php";
-var A, P, T, E, F, M, p, B, j, $, V, G, Y, J, K, X, O, Q, z, D;
+var k, E, x, g, v, T, d, z, W, B, $, V, G, J, Y, K, L, X, U, O;
 class PHP {
   /**
    * Initializes a PHP runtime.
@@ -862,14 +872,14 @@ class PHP {
    * @param  requestHandlerOptions - Optional. Options for the PHPRequestHandler. If undefined, no request handler will be initialized.
    */
   constructor(t) {
-    y(this, p);
-    y(this, A);
-    y(this, P, !1);
-    y(this, T, null);
-    y(this, E, /* @__PURE__ */ new Map());
-    y(this, F, []);
-    y(this, M, {});
-    this.semaphore = new Semaphore({ concurrency: 1 }), t !== void 0 && this.initializeRuntime(t);
+    _(this, d);
+    _(this, k);
+    _(this, E);
+    _(this, x);
+    _(this, g);
+    _(this, v);
+    _(this, T);
+    f(this, E, !1), f(this, x, null), f(this, g, /* @__PURE__ */ new Map()), f(this, v, []), f(this, T, {}), this.cliCalled = !1, this.runStreamCalled = !1, this.semaphore = new Semaphore({ concurrency: 1 }), t !== void 0 && this.initializeRuntime(t);
   }
   /**
    * Adds an event listener for a PHP event.
@@ -877,7 +887,7 @@ class PHP {
    * @param listener - The listener function to be called when the event is triggered.
    */
   addEventListener(t, e) {
-    u(this, E).has(t) || u(this, E).set(t, /* @__PURE__ */ new Set()), u(this, E).get(t).add(e);
+    u(this, g).has(t) || u(this, g).set(t, /* @__PURE__ */ new Set()), u(this, g).get(t).add(e);
   }
   /**
    * Removes an event listener for a PHP event.
@@ -886,10 +896,10 @@ class PHP {
    */
   removeEventListener(t, e) {
     var r;
-    (r = u(this, E).get(t)) == null || r.delete(e);
+    (r = u(this, g).get(t)) == null || r.delete(e);
   }
   dispatchEvent(t) {
-    const e = u(this, E).get(t.type);
+    const e = u(this, g).get(t.type);
     if (e)
       for (const r of e)
         r(t);
@@ -934,8 +944,8 @@ class PHP {
    * @param listener Callback function to handle the message.
    */
   onMessage(t) {
-    return u(this, F).push(t), async () => {
-      g(this, F, u(this, F).filter(
+    return u(this, v).push(t), async () => {
+      f(this, v, u(this, v).filter(
         (e) => e !== t
       ));
     };
@@ -1011,13 +1021,13 @@ class PHP {
 				}
 				`
     ), e.onMessage = async (r) => {
-      for (const s of u(this, F)) {
+      for (const s of u(this, v)) {
         const n = await s(r);
         if (n)
           return n;
       }
       return "";
-    }, g(this, T, improveWASMErrorReporting(e)), this.dispatchEvent({
+    }, f(this, x, improveWASMErrorReporting(e)), this.dispatchEvent({
       type: "runtime.initialized"
     });
   }
@@ -1032,7 +1042,7 @@ class PHP {
       throw new Error(
         "Could not set SAPI name. This can only be done before the PHP WASM module is initialized.Did you already dispatch any requests?"
       );
-    g(this, A, t);
+    f(this, k, t);
   }
   /**
    * Changes the current working directory in the PHP filesystem.
@@ -1045,6 +1055,14 @@ class PHP {
   chdir(t) {
     this[__private__dont__use].FS.chdir(t);
   }
+  /**
+   * Changes the permissions of a file or directory.
+   * @param path - The path to the file or directory.
+   * @param mode - The new permissions.
+   */
+  chmod(t, e) {
+    this[__private__dont__use].FS.chmod(t, e);
+  }
   /**
    * Do not use. Use new PHPRequestHandler() instead.
    * @deprecated
@@ -1132,24 +1150,18 @@ class PHP {
     const e = await this.runStream(t), r = await PHPResponse.fromStreamedResponse(
       e
     );
-    if (r.exitCode !== 0) {
-      logger.warn("PHP.run() output was:", r.text);
-      const s = new PHPExecutionFailureError(
-        `PHP.run() failed with exit code ${r.exitCode} and the following output: ` + r.errors + `
+    if (r.exitCode !== 0)
+      throw new PHPExecutionFailureError(
+        `PHP.run() failed with exit code ${r.exitCode}. 
+
+=== Stdout ===
+ ${r.text}
 
-` + r.text,
+=== Stderr ===
+ ${r.errors}`,
         r,
         "request"
       );
-      throw logger.error(s), this.dispatchEvent({
-        type: "request.error",
-        error: new Error(
-          "PHP.run() failed with exit code " + r.exitCode
-        ),
-        // Distinguish between PHP request and PHP-wasm errors
-        source: "request"
-      }), s;
-    }
     return r;
   }
   /**
@@ -1244,30 +1256,35 @@ class PHP {
    * @returns A StreamedPHPResponse object.
    */
   async runStream(t) {
+    if (this.cliCalled)
+      throw new Error(
+        "php.runStream() can only be called if php.cli() was not called before. The two methods set a conflicting C-level global state."
+      );
+    this.runStreamCalled = !0;
     const e = await this.semaphore.acquire();
     let r;
-    const s = m(this, p, D).call(this, async () => {
-      if (u(this, P) || (await m(this, p, j).call(this), g(this, P, !0)), t.scriptPath && !this.fileExists(t.scriptPath))
+    const s = m(this, d, O).call(this, async () => {
+      if (u(this, E) || (await m(this, d, W).call(this), f(this, E, !0)), t.scriptPath && !this.fileExists(t.scriptPath))
         throw new Error(
           `The script path "${t.scriptPath}" does not exist.`
         );
-      m(this, p, $).call(this, t.relativeUri || ""), m(this, p, J).call(this, t.method || "GET");
-      const n = normalizeHeaders(t.headers || {}), i = n.host || "example.com:443", o = m(this, p, Y).call(this, i, t.protocol || "http");
-      if (m(this, p, V).call(this, i), m(this, p, G).call(this, o), m(this, p, K).call(this, n), t.body && (r = m(this, p, X).call(this, t.body)), typeof t.code == "string")
-        this.writeFile("/internal/eval.php", t.code), m(this, p, O).call(this, "/internal/eval.php");
+      m(this, d, B).call(this, t.relativeUri || ""), m(this, d, J).call(this, t.method || "GET");
+      const n = normalizeHeaders(t.headers || {}), i = n.host || "example.com:443", o = m(this, d, G).call(this, i, t.protocol || "http");
+      if (m(this, d, $).call(this, i), m(this, d, V).call(this, o), m(this, d, Y).call(this, n), t.body && (r = m(this, d, K).call(this, t.body)), typeof t.code == "string")
+        this.writeFile("/internal/eval.php", t.code), m(this, d, L).call(this, "/internal/eval.php");
       else if (typeof t.scriptPath == "string")
-        m(this, p, O).call(this, t.scriptPath || "");
+        m(this, d, L).call(this, t.scriptPath || "");
       else
         throw new TypeError(
           "The request object must have either a `code` or a `scriptPath` property."
         );
-      const a = m(this, p, B).call(this, t.$_SERVER, n, o);
-      for (const l in a)
-        m(this, p, Q).call(this, l, a[l]);
-      const c = t.env || {};
-      for (const l in c)
-        m(this, p, z).call(this, l, c[l]);
-      return u(this, P) || (await m(this, p, j).call(this), g(this, P, !0)), await this[__private__dont__use].ccall(
+      const a = m(this, d, z).call(this, t.$_SERVER, n, o);
+      for (const c in a)
+        m(this, d, X).call(this, c, a[c]);
+      const l = t.env || {};
+      for (const c in l)
+        m(this, d, U).call(this, c, l[c]);
+      return await this[__private__dont__use].ccall(
         "wasm_sapi_handle_request",
         NUMBER,
         [],
@@ -1276,12 +1293,12 @@ class PHP {
       );
     });
     return await s.catch((n) => {
-      this.dispatchEvent({
+      throw this.dispatchEvent({
         type: "request.error",
         error: n,
         // Distinguish between PHP request and PHP-wasm errors
         source: n.source ?? "php-wasm"
-      });
+      }), n;
     }).finally(() => {
       r && this[__private__dont__use].free(r);
     }).finally(() => {
@@ -1472,13 +1489,13 @@ class PHP {
    */
   async hotSwapPHPRuntime(t, e) {
     const r = this[__private__dont__use].FS, s = [];
-    for (const [n, i] of Object.entries(u(this, M)))
+    for (const [n, i] of Object.entries(u(this, T)))
       s.push({ mountHandler: i.mountHandler, vfsPath: n }), await i.unmount();
     try {
       this.exit();
     } catch {
     }
-    this.initializeRuntime(t), u(this, A) && this.setSapiName(u(this, A)), copyFS(r, this[__private__dont__use].FS, "/internal"), e && copyFS(r, this[__private__dont__use].FS, e);
+    this.initializeRuntime(t), u(this, k) && this.setSapiName(u(this, k)), copyFS(r, this[__private__dont__use].FS, "/internal"), e && copyFS(r, this[__private__dont__use].FS, e);
     for (const { mountHandler: n, vfsPath: i } of s)
       this.mkdir(i), await this.mount(i, n);
   }
@@ -1497,10 +1514,10 @@ class PHP {
     ), s = {
       mountHandler: e,
       unmount: async () => {
-        await r(), delete u(this, M)[t];
+        await r(), delete u(this, T)[t];
       }
     };
-    return u(this, M)[t] = s, () => {
+    return u(this, T)[t] = s, () => {
       s.unmount();
     };
   }
@@ -1518,9 +1535,18 @@ class PHP {
    * @returns The exit code of the CLI session.
    */
   async cli(t, e = {}) {
+    if (this.cliCalled)
+      throw new Error(
+        "php.cli() can only be called once. The method sets a C-level global state that does not allow repeated calls."
+      );
+    if (this.runStreamCalled)
+      throw new Error(
+        "php.cli() can only be called if php.runStream() was not called before. The two methods set a conflicting C-level global state."
+      );
+    this.cliCalled = !0;
     const r = await this.semaphore.acquire(), s = e.env || {};
     for (const [n, i] of Object.entries(s))
-      m(this, p, z).call(this, n, i);
+      m(this, d, U).call(this, n, i);
     t = [t[0], "-c", PHP_INI_PATH, ...t.slice(1)];
     for (const n of t)
       this[__private__dont__use].ccall(
@@ -1529,15 +1555,9 @@ class PHP {
         [STRING],
         [n]
       );
-    return await m(this, p, D).call(this, async () => await this[__private__dont__use].ccall(
-      "run_cli",
-      null,
-      [],
-      [],
-      {
-        async: !0
-      }
-    )).then((n) => (n.exitCode.finally(r), n));
+    return await m(this, d, O).call(this, () => this[__private__dont__use].ccall("run_cli", null, [], [], {
+      async: !0
+    })).then((n) => (n.exitCode.finally(r), n));
   }
   setSkipShebang(t) {
     this[__private__dont__use].ccall(
@@ -1555,13 +1575,13 @@ class PHP {
       this[__private__dont__use]._exit(t);
     } catch {
     }
-    g(this, P, !1), g(this, T, null), this[__private__dont__use] && (delete this[__private__dont__use].onMessage, delete this[__private__dont__use]);
+    f(this, E, !1), f(this, x, null), this[__private__dont__use] && (delete this[__private__dont__use].onMessage, delete this[__private__dont__use]);
   }
   [Symbol.dispose]() {
-    u(this, P) && this.exit(0);
+    u(this, E) && this.exit(0);
   }
 }
-A = new WeakMap(), P = new WeakMap(), T = new WeakMap(), E = new WeakMap(), F = new WeakMap(), M = new WeakMap(), p = new WeakSet(), /**
+k = new WeakMap(), E = new WeakMap(), x = new WeakMap(), g = new WeakMap(), v = new WeakMap(), T = new WeakMap(), d = new WeakSet(), /**
  * Prepares the $_SERVER entries for the PHP runtime.
  *
  * @param defaults Default entries to include in $_SERVER.
@@ -1570,7 +1590,7 @@ A = new WeakMap(), P = new WeakMap(), T = new WeakMap(), E = new WeakMap(), F =
  *             was provided.
  * @returns Computed $_SERVER entries.
  */
-B = function(t, e, r) {
+z = function(t, e, r) {
   const s = {
     ...t || {}
   };
@@ -1580,11 +1600,11 @@ B = function(t, e, r) {
     ["content-type", "content-length"].includes(n.toLowerCase()) && (i = ""), s[`${i}${n.toUpperCase().replace(/-/g, "_")}`] = e[n];
   }
   return s;
-}, j = async function() {
-  await this[__private__dont__use].ccall("php_wasm_init", null, [], [], {
-    async: !0
+}, W = function() {
+  return this[__private__dont__use].ccall("php_wasm_init", null, [], [], {
+    isAsync: !0
   });
-}, $ = function(t) {
+}, B = function(t) {
   this[__private__dont__use].ccall(
     "wasm_set_request_uri",
     null,
@@ -1598,21 +1618,21 @@ B = function(t, e, r) {
     [STRING],
     [e]
   );
-}, V = function(t) {
+}, $ = function(t) {
   this[__private__dont__use].ccall(
     "wasm_set_request_host",
     null,
     [STRING],
     [t]
   );
-}, G = function(t) {
+}, V = function(t) {
   this[__private__dont__use].ccall(
     "wasm_set_request_port",
     null,
     [NUMBER],
     [t]
   );
-}, Y = function(t, e) {
+}, G = function(t, e) {
   let r;
   try {
     r = parseInt(new URL(t).port, 10);
@@ -1626,7 +1646,7 @@ B = function(t, e, r) {
     [STRING],
     [t]
   );
-}, K = function(t) {
+}, Y = function(t) {
   t.cookie && this[__private__dont__use].ccall(
     "wasm_set_cookies",
     null,
@@ -1643,7 +1663,7 @@ B = function(t, e, r) {
     [NUMBER],
     [parseInt(t["content-length"], 10)]
   );
-}, X = function(t) {
+}, K = function(t) {
   let e, r;
   typeof t == "string" ? (logger.warn(
     "Passing a string as the request body is deprecated. Please use a Uint8Array instead. See https://github.com/WordPress/wordpress-playground/issues/997 for more details"
@@ -1666,82 +1686,75 @@ B = function(t, e, r) {
     [NUMBER],
     [r]
   ), s;
-}, O = function(t) {
+}, L = function(t) {
   this[__private__dont__use].ccall(
     "wasm_set_path_translated",
     null,
     [STRING],
     [t]
   );
-}, Q = function(t, e) {
+}, X = function(t, e) {
   this[__private__dont__use].ccall(
     "wasm_add_SERVER_entry",
     null,
     [STRING, STRING],
     [t, e]
   );
-}, z = function(t, e) {
+}, U = function(t, e) {
   this[__private__dont__use].ccall(
     "wasm_add_ENV_entry",
     null,
     [STRING, STRING],
     [t, e]
   );
-}, D = async function(t) {
+}, O = async function(t) {
   const e = this[__private__dont__use], r = await createInvertedReadableStream();
-  e.onHeaders = (d) => {
-    a || s || r.controller.enqueue(d.slice());
+  e.onHeaders = (h) => {
+    a || s || r.controller.enqueue(h.slice());
   };
   let s = !1;
   const n = () => {
     s || (s = !0, r.controller.close());
   }, i = await createInvertedReadableStream();
-  e.onStdout = (d) => {
-    n(), !a && i.controller.enqueue(d.slice());
+  e.onStdout = (h) => {
+    n(), !a && i.controller.enqueue(h.slice());
   };
   const o = await createInvertedReadableStream();
-  e.onStderr = (d) => {
-    a || o.controller.enqueue(d.slice());
+  e.onStderr = (h) => {
+    a || o.controller.enqueue(h.slice());
   };
-  let a = !1, c;
-  const h = (async () => {
-    var d;
+  let a = !1, l;
+  const p = (async () => {
+    var h;
     try {
       return await Promise.race([
         t(),
-        new Promise((_, w) => {
-          var k;
-          c = (v) => {
-            if (isExitCode(v.error) && v.error.status === 0)
-              _(v.error.status);
-            else {
-              const U = new Error("Rethrown");
-              U.cause = v.error, U.betterMessage = v.message, w(U);
-            }
-          }, (k = u(this, T)) == null || k.addEventListener(
+        new Promise((w, b) => {
+          var j;
+          l = (D) => {
+            isExitCode(D.error) || b(D.error);
+          }, (j = u(this, x)) == null || j.addEventListener(
             "error",
-            c,
+            l,
             { once: !0 }
           );
         })
       ]);
-    } catch (f) {
-      if (isExitCode(f))
-        return f.status;
-      i.controller.error(f), o.controller.error(f), r.controller.error(f), a = !0;
-      for (const v in this)
-        typeof this[v] == "function" && (this[v] = () => {
+    } catch (y) {
+      if (isExitCode(y))
+        return y.status;
+      i.controller.error(y), o.controller.error(y), r.controller.error(y), a = !0;
+      for (const w in this)
+        typeof this[w] == "function" && (this[w] = () => {
           throw new Error(
             "PHP runtime has crashed – see the earlier error for details."
           );
         });
-      this.functionsMaybeMissingFromAsyncify = getFunctionsMaybeMissingFromAsyncify();
-      const _ = f, w = "betterMessage" in _ ? _.betterMessage : _.message, k = new Error(w);
-      throw k.cause = _, logger.error(k), k;
+      throw this.functionsMaybeMissingFromAsyncify = getFunctionsMaybeMissingFromAsyncify(), y;
     } finally {
-      a || (i.controller.close(), o.controller.close(), n(), a = !0), (d = u(this, T)) == null || d.removeEventListener(
+      a || (i.controller.close(), o.controller.close(), n(), a = !0), (h = u(this, x)) == null || h.removeEventListener(
         "error",
-        c
+        l
       );
     }
   })();
@@ -1749,7 +1762,7 @@ B = function(t, e, r) {
     r.stream,
     i.stream,
     o.stream,
-    h
+    p
   );
 };
 function normalizeHeaders(t) {
@@ -1817,6 +1830,58 @@ async function withPHPIniValues(t, e, r) {
     await t.writeFile(PHP_INI_PATH, s);
   }
 }
+async function printDebugDetails(t, e) {
+  e && printResponseDebugDetails(
+    await PHPResponse.fromStreamedResponse(e)
+  ), await prettyPrintFullStackTrace(t);
+}
+async function prettyPrintFullStackTrace(t) {
+  let e = t, r = !0;
+  for (; e; )
+    r || process.stderr.write(`
+Caused by:
+
+`), process.stderr.write(e.originalErrorClassName ?? e.name), process.stderr.write(": " + e.message + `
+`), process.stderr.write(
+      (e.stack + "").split(`
+`).slice(1).join(`
+`)
+    ), process.stderr.write(`
+`), e.response && printResponseDebugDetails(e.response), e.phpLogs && (process.stderr.write(`
+
+==== PHP error log ====
+
+`), process.stderr.write(e.phpLogs)), e = e.cause, r = !1;
+  process.stderr.write(`
+`);
+}
+function printResponseDebugDetails(t) {
+  process.stderr.write(
+    `
+    exitCode=${t.exitCode} httpStatusCode=${t.httpStatusCode} `
+  );
+  const e = t.headers && Object.keys(t.headers).length > 0;
+  e || process.stderr.write("responseHeaders=(empty) "), t.text || process.stderr.write("stdout=(empty) "), t.errors || process.stderr.write("stderr=(empty) "), process.stderr.write(`
+`), e && process.stderr.write(
+    `
+==== PHP response headers ====
+
+${JSON.stringify(
+      t.headers,
+      null,
+      2
+    )}
+
+`
+  ), t.text && (process.stderr.write(`
+==== PHP stdout ====
+
+`), process.stderr.write(t.text)), t.errors && (process.stderr.write(`
+==== PHP stderr ====
+
+`), process.stderr.write(t.errors)), process.stderr.write(`
+`);
+}
 class HttpCookieStore {
   constructor() {
     this.cookies = {};
@@ -1860,16 +1925,16 @@ async function* iteratePhpFiles(t, e, {
     if (!o)
       return;
     const a = await t.listFiles(o);
-    for (const c of a) {
-      const l = `${o}/${c}`;
-      if (n.includes(l.substring(e.length + 1)))
+    for (const l of a) {
+      const c = `${o}/${l}`;
+      if (n.includes(c.substring(e.length + 1)))
         continue;
-      await t.isDir(l) ? i.push(l) : yield new StreamedFile(
-        streamReadFileFromPHP(t, l),
+      await t.isDir(c) ? i.push(c) : yield new StreamedFile(
+        streamReadFileFromPHP(t, c),
         r ? joinPaths(
           s || "",
-          l.substring(e.length + 1)
-        ) : l
+          c.substring(e.length + 1)
+        ) : c
       );
     }
   }
@@ -1940,7 +2005,7 @@ class PHPProcessManager {
    *                                and the waiting timeout is exceeded.
    */
   async acquirePHPInstance({
-    considerPrimary: e = !0
+    considerPrimary: e = !1
   } = {}) {
     if (this.primaryPhp || await this.getPrimaryPhp(), this.primaryIdle && e)
       return this.primaryIdle = !1, {
@@ -1959,7 +2024,7 @@ class PHPProcessManager {
    * for PHP to spawn.
    */
   spawn(e) {
-    if (e.isPrimary && this.primaryPhpPromise && !this.primaryPhp)
+    if (e.isPrimary && this.allInstances.length > 0)
       throw new Error(
         "Requested spawning a primary PHP instance when another primary instance already started spawning."
       );
@@ -2030,22 +2095,22 @@ function ensurePathPrefix(t, e) {
 }
 async function encodeAsMultipart(t) {
   const e = `----${Math.random().toString(36).slice(2)}`, r = `multipart/form-data; boundary=${e}`, s = new TextEncoder(), n = [];
-  for (const [c, l] of Object.entries(t))
+  for (const [l, c] of Object.entries(t))
     n.push(`--${e}\r
-`), n.push(`Content-Disposition: form-data; name="${c}"`), l instanceof File && n.push(`; filename="${l.name}"`), n.push(`\r
-`), l instanceof File && (n.push("Content-Type: application/octet-stream"), n.push(`\r
+`), n.push(`Content-Disposition: form-data; name="${l}"`), c instanceof File && n.push(`; filename="${c.name}"`), n.push(`\r
+`), c instanceof File && (n.push("Content-Type: application/octet-stream"), n.push(`\r
 `)), n.push(`\r
-`), l instanceof File ? n.push(await fileToUint8Array(l)) : n.push(l), n.push(`\r
+`), c instanceof File ? n.push(await fileToUint8Array(c)) : n.push(c), n.push(`\r
 `);
   n.push(`--${e}--\r
 `);
-  const i = n.reduce((c, l) => c + l.length, 0), o = new Uint8Array(i);
+  const i = n.reduce((l, c) => l + c.length, 0), o = new Uint8Array(i);
   let a = 0;
-  for (const c of n)
+  for (const l of n)
     o.set(
-      typeof c == "string" ? s.encode(c) : c,
+      typeof l == "string" ? s.encode(l) : l,
       a
-    ), a += c.length;
+    ), a += l.length;
   return { bytes: o, contentType: r };
 }
 function fileToUint8Array(t) {
@@ -2147,7 +2212,7 @@ const _default = "application/octet-stream", asx = "video/x-ms-asf", atom = "app
   xspf,
   zip
 };
-var S, C, L, b, I, x, N, R, H, Z, ee, te;
+var S, C, A, F, I, P, M, R, H, Q, Z, ee;
 class PHPRequestHandler {
   /**
    * The request handler needs to decide whether to serve a static asset or
@@ -2161,15 +2226,15 @@ class PHPRequestHandler {
    * @param  config - Request Handler configuration.
    */
   constructor(e) {
-    y(this, H);
-    y(this, S);
-    y(this, C);
-    y(this, L);
-    y(this, b);
-    y(this, I);
-    y(this, x);
-    y(this, N);
-    y(this, R);
+    _(this, H);
+    _(this, S);
+    _(this, C);
+    _(this, A);
+    _(this, F);
+    _(this, I);
+    _(this, P);
+    _(this, M);
+    _(this, R);
     const {
       documentRoot: r = "/www/",
       absoluteUrl: s = typeof location == "object" ? location.href : DEFAULT_BASE_URL,
@@ -2177,25 +2242,25 @@ class PHPRequestHandler {
       getFileNotFoundAction: i = () => ({ type: "404" })
     } = e;
     "processManager" in e ? this.processManager = e.processManager : this.processManager = new PHPProcessManager({
-      phpFactory: async (c) => {
-        const l = await e.phpFactory({
-          ...c,
+      phpFactory: async (l) => {
+        const c = await e.phpFactory({
+          ...l,
           requestHandler: this
         });
-        return l.isDir(r) || l.mkdir(r), l.chdir(r), l.requestHandler = this, l;
+        return c.isDir(r) || c.mkdir(r), c.chdir(r), c.requestHandler = this, c;
       },
       maxPhpInstances: e.maxPhpInstances
-    }), g(this, R, e.cookieStore === void 0 ? new HttpCookieStore() : e.cookieStore), g(this, S, r);
+    }), f(this, R, e.cookieStore === void 0 ? new HttpCookieStore() : e.cookieStore), f(this, S, r);
     const o = new URL(s);
-    g(this, L, o.hostname), g(this, b, o.port ? Number(o.port) : o.protocol === "https:" ? 443 : 80), g(this, C, (o.protocol || "").replace(":", ""));
-    const a = u(this, b) !== 443 && u(this, b) !== 80;
-    g(this, I, [
-      u(this, L),
-      a ? `:${u(this, b)}` : ""
-    ].join("")), g(this, x, o.pathname.replace(/\/+$/, "")), g(this, N, [
+    f(this, A, o.hostname), f(this, F, o.port ? Number(o.port) : o.protocol === "https:" ? 443 : 80), f(this, C, (o.protocol || "").replace(":", ""));
+    const a = u(this, F) !== 443 && u(this, F) !== 80;
+    f(this, I, [
+      u(this, A),
+      a ? `:${u(this, F)}` : ""
+    ].join("")), f(this, P, o.pathname.replace(/\/+$/, "")), f(this, M, [
       `${u(this, C)}://`,
       u(this, I),
-      u(this, x)
+      u(this, P)
     ].join("")), this.rewriteRules = n, this.getFileNotFoundAction = i;
   }
   async getPrimaryPhp() {
@@ -2220,13 +2285,13 @@ class PHPRequestHandler {
    */
   internalUrlToPath(e) {
     const r = new URL(e);
-    return r.pathname.startsWith(u(this, x)) && (r.pathname = r.pathname.slice(u(this, x).length)), toRelativeUrl(r);
+    return r.pathname.startsWith(u(this, P)) && (r.pathname = r.pathname.slice(u(this, P).length)), toRelativeUrl(r);
   }
   /**
    * The absolute URL of this PHPRequestHandler instance.
    */
   get absoluteUrl() {
-    return u(this, N);
+    return u(this, M);
   }
   /**
    * The directory in the PHP filesystem where the server will look
@@ -2291,7 +2356,7 @@ class PHPRequestHandler {
     ), n = applyRewriteRules(
       removePathPrefix(
         decodeURIComponent(s.pathname),
-        u(this, x)
+        u(this, P)
       ),
       this.rewriteRules
     ), i = await this.getPrimaryPhp();
@@ -2304,9 +2369,9 @@ class PHPRequestHandler {
           new Uint8Array(0)
         );
       for (const a of ["index.php", "index.html"]) {
-        const c = joinPaths(o, a);
-        if (i.isFile(c)) {
-          o = c;
+        const l = joinPaths(o, a);
+        if (i.isFile(l)) {
+          o = l;
           break;
         }
       }
@@ -2336,9 +2401,9 @@ class PHPRequestHandler {
           // Pass along URL with the #fragment filtered out
           url: s.toString()
         };
-        return m(this, H, ee).call(this, a, o);
+        return m(this, H, Z).call(this, a, o);
       } else
-        return m(this, H, Z).call(this, i, o);
+        return m(this, H, Q).call(this, i, o);
     else
       return PHPResponse.forHttpCode(404);
   }
@@ -2346,13 +2411,13 @@ class PHPRequestHandler {
     await this.processManager[Symbol.asyncDispose]();
   }
 }
-S = new WeakMap(), C = new WeakMap(), L = new WeakMap(), b = new WeakMap(), I = new WeakMap(), x = new WeakMap(), N = new WeakMap(), R = new WeakMap(), H = new WeakSet(), /**
+S = new WeakMap(), C = new WeakMap(), A = new WeakMap(), F = new WeakMap(), I = new WeakMap(), P = new WeakMap(), M = new WeakMap(), R = new WeakMap(), H = new WeakSet(), /**
  * Serves a static file from the PHP filesystem.
  *
  * @param  fsPath - Absolute path of the static file to serve.
  * @returns The response.
  */
-Z = function(e, r) {
+Q = function(e, r) {
   const s = e.readFileAsBuffer(r);
   return new PHPResponse(
     200,
@@ -2367,7 +2432,7 @@ Z = function(e, r) {
     },
     s
   );
-}, ee = async function(e, r) {
+}, Z = async function(e, r) {
   let s;
   try {
     s = await this.processManager.acquirePHPInstance({
@@ -2377,11 +2442,11 @@ Z = function(e, r) {
     return n instanceof MaxPhpInstancesError ? PHPResponse.forHttpCode(502) : PHPResponse.forHttpCode(500);
   }
   try {
-    return await m(this, H, te).call(this, s.php, e, r);
+    return await m(this, H, ee).call(this, s.php, e, r);
   } finally {
     s.reap();
   }
-}, te = async function(e, r, s) {
+}, ee = async function(e, r, s) {
   let n = "GET";
   const i = {
     host: u(this, I),
@@ -2391,21 +2456,21 @@ Z = function(e, r) {
   let o = r.body;
   if (typeof o == "object" && !(o instanceof Uint8Array)) {
     n = "POST";
-    const { bytes: a, contentType: c } = await encodeAsMultipart(o);
-    o = a, i["content-type"] = c;
+    const { bytes: a, contentType: l } = await encodeAsMultipart(o);
+    o = a, i["content-type"] = l;
   }
   try {
     const a = await e.run({
       relativeUri: ensurePathPrefix(
         toRelativeUrl(new URL(r.url)),
-        u(this, x)
+        u(this, P)
       ),
       protocol: u(this, C),
       method: r.method || n,
       $_SERVER: {
         REMOTE_ADDR: "127.0.0.1",
         DOCUMENT_ROOT: u(this, S),
-        HTTPS: u(this, N).startsWith("https://") ? "on" : ""
+        HTTPS: u(this, M).startsWith("https://") ? "on" : ""
       },
       body: o,
       scriptPath: s,
@@ -2415,9 +2480,9 @@ Z = function(e, r) {
       a.headers
     ), a;
   } catch (a) {
-    const c = a;
-    if (c != null && c.response)
-      return c.response;
+    const l = a;
+    if (l != null && l.response)
+      return l.response;
     throw a;
   }
 };
@@ -2447,18 +2512,18 @@ function rotatePHPRuntime({
 }) {
   let n = 0;
   async function i() {
-    const c = await t.semaphore.acquire();
+    const l = await t.semaphore.acquire();
     try {
       await t.hotSwapPHPRuntime(await r(), e), n = 0;
     } finally {
-      c();
+      l();
     }
   }
   async function o() {
     ++n < s || await i();
   }
-  async function a(c) {
-    c.type === "request.error" && c.source === "php-wasm" && await i();
+  async function a(l) {
+    l.type === "request.error" && l.source === "php-wasm" && await i();
   }
   return t.addEventListener("request.error", a), t.addEventListener("request.end", o), function() {
     t.removeEventListener("request.error", a), t.removeEventListener("request.end", o);
@@ -2485,6 +2550,56 @@ function proxyFileSystem(t, e, r) {
       n
     );
 }
+function sandboxedSpawnHandlerFactory(t) {
+  return createSpawnHandler(async function(e, r, s) {
+    r.notifySpawn(), e[0] === "exec" && e.shift(), (e[0].endsWith(".php") || e[0].endsWith(".phar")) && e.unshift("php");
+    const n = e[0].split("/").pop();
+    if (e[0] === "/usr/bin/env" && e[1] === "stty" && e[2] === "size")
+      r.stdout("18 140"), r.exit(0);
+    else if (n === "tput" && e[1] === "cols")
+      r.stdout("140"), r.exit(0);
+    else if (n === "less")
+      r.on("stdin", (i) => {
+        r.stdout(i);
+      }), r.exit(0);
+    else if (n === "php") {
+      const { php: i, reap: o } = await t.acquirePHPInstance({
+        considerPrimary: !1
+      });
+      i.chdir(s.cwd);
+      try {
+        const a = await i.cli(e, {
+          env: {
+            ...s.env,
+            SCRIPT_PATH: e[1],
+            // Set SHELL_PIPE to 0 to ensure WP-CLI formats
+            // the output as ASCII tables.
+            // @see https://github.com/wp-cli/wp-cli/issues/1102
+            SHELL_PIPE: "0"
+          }
+        });
+        a.stdout.pipeTo(
+          new WritableStream({
+            write(l) {
+              r.stdout(l);
+            }
+          })
+        ), a.stderr.pipeTo(
+          new WritableStream({
+            write(l) {
+              r.stderr(l);
+            }
+          })
+        ), r.exit(await a.exitCode);
+      } catch (a) {
+        throw r.exit(1), a;
+      } finally {
+        o();
+      }
+    } else
+      r.exit(1);
+  });
+}
 function exposeSync(t, e, r, s = ["*"]) {
   return expose(t, e, s, r.afterResponseSent);
 }
@@ -2511,16 +2626,16 @@ function createSyncProxy(t, e = [], r) {
     apply(s, n, i) {
       if (e.at(-1) === "bind")
         return createSyncProxy(t, e.slice(0, -1), r);
-      const [a, c] = processArguments(i), l = r.send(
+      const [a, l] = processArguments(i), c = r.send(
         t,
         {
           type: MessageType.APPLY,
           path: e.map(String),
           argumentList: a
         },
-        c
+        l
       );
-      return fromWireValue(l);
+      return fromWireValue(c);
     },
     construct(s, n) {
       const [i, o] = processArguments(n), a = r.send(
@@ -2541,9 +2656,15 @@ function wrapSync(t, e) {
 }
 class NodeSABSyncReceiveMessageTransport {
   static async create() {
-    return NodeSABSyncReceiveMessageTransport.receiveMessageOnPort || (NodeSABSyncReceiveMessageTransport.receiveMessageOnPort = await import("./__vite-browser-external-l0sNRNKZ.js").then(
-      (e) => e.receiveMessageOnPort
-    )), new NodeSABSyncReceiveMessageTransport();
+    if (!NodeSABSyncReceiveMessageTransport.receiveMessageOnPort)
+      try {
+        NodeSABSyncReceiveMessageTransport.receiveMessageOnPort = require("worker_threads").receiveMessageOnPort;
+      } catch {
+        NodeSABSyncReceiveMessageTransport.receiveMessageOnPort = await import("worker_threads").then(
+          (e) => e.receiveMessageOnPort
+        );
+      }
+    return new NodeSABSyncReceiveMessageTransport();
   }
   constructor() {
   }
@@ -2555,7 +2676,7 @@ class NodeSABSyncReceiveMessageTransport {
     }
   }
   send(e, r, s) {
-    var l;
+    var c;
     const n = new SharedArrayBuffer(4), i = new Int32Array(n);
     i[0] = 0;
     const o = generateUUID();
@@ -2565,10 +2686,10 @@ class NodeSABSyncReceiveMessageTransport {
     ), Atomics.wait(i, 0, 0, 5e3) === "timed-out")
       throw new Error("Timeout waiting for response");
     for (; ; ) {
-      const h = NodeSABSyncReceiveMessageTransport.receiveMessageOnPort(e);
-      if (((l = h.message) == null ? void 0 : l.id) === o)
-        return h.message;
-      if (!h)
+      const p = NodeSABSyncReceiveMessageTransport.receiveMessageOnPort(e);
+      if (((c = p.message) == null ? void 0 : c.id) === o)
+        return p.message;
+      if (!p)
         throw new Error("No response received");
     }
   }
@@ -2605,7 +2726,7 @@ const WireValueType = {
   deserialize(t) {
     return t.start(), wrap(t);
   }
-}, throwTransferHandler = {
+}, throwTransferHandler$1 = {
   canHandle: (t) => isObject(t) && throwMarker in t,
   serialize({ value: t }) {
     let e;
@@ -2626,7 +2747,7 @@ const WireValueType = {
   }
 }, transferHandlers = /* @__PURE__ */ new Map([
   ["proxy", proxyTransferHandler],
-  ["throw", throwTransferHandler]
+  ["throw", throwTransferHandler$1]
 ]);
 function isAllowedOrigin(t, e) {
   for (const r of t)
@@ -2642,55 +2763,55 @@ function expose(t, e = globalThis, r = ["*"], s) {
       console.warn(`Invalid origin '${i.origin}' for comlink proxy`);
       return;
     }
-    const { id: o, type: a, path: c } = {
+    const { id: o, type: a, path: l } = {
       path: [],
       ...i.data
-    }, l = (i.data.argumentList || []).map(fromWireValue);
-    let h;
+    }, c = (i.data.argumentList || []).map(fromWireValue);
+    let p;
     try {
-      const d = c.slice(0, -1).reduce((_, w) => _[w], t), f = c.reduce((_, w) => _[w], t);
+      const h = l.slice(0, -1).reduce((w, b) => w[b], t), y = l.reduce((w, b) => w[b], t);
       switch (a) {
         case MessageType.GET:
-          h = f;
+          p = y;
           break;
         case MessageType.SET:
-          d[c.slice(-1)[0]] = fromWireValue(
+          h[l.slice(-1)[0]] = fromWireValue(
             i.data.value
-          ), h = !0;
+          ), p = !0;
           break;
         case MessageType.APPLY:
-          h = f.apply(d, l);
+          p = y.apply(h, c);
           break;
         case MessageType.CONSTRUCT:
           {
-            const _ = new f(...l);
-            h = proxy(_);
+            const w = new y(...c);
+            p = proxy(w);
           }
           break;
         case MessageType.ENDPOINT:
           {
-            const { port1: _, port2: w } = new MessageChannel();
-            expose(t, w), h = transfer(_, [_]);
+            const { port1: w, port2: b } = new MessageChannel();
+            expose(t, b), p = transfer(w, [w]);
           }
           break;
         case MessageType.RELEASE:
-          h = void 0;
+          p = void 0;
           break;
         default:
           return;
       }
-    } catch (d) {
-      h = { value: d, [throwMarker]: 0 };
+    } catch (h) {
+      p = { value: h, [throwMarker]: 0 };
     }
-    Promise.resolve(h).catch((d) => ({ value: d, [throwMarker]: 0 })).then((d) => {
-      const [f, _] = toWireValue(d);
-      e.postMessage({ ...f, id: o }, _), a === MessageType.RELEASE && (e.removeEventListener("message", n), closeEndPoint(e), finalizer in t && typeof t[finalizer] == "function" && t[finalizer]());
+    Promise.resolve(p).catch((h) => ({ value: h, [throwMarker]: 0 })).then((h) => {
+      const [y, w] = toWireValue(h);
+      e.postMessage({ ...y, id: o }, w), a === MessageType.RELEASE && (e.removeEventListener("message", n), closeEndPoint(e), finalizer in t && typeof t[finalizer] == "function" && t[finalizer]());
     }).catch(() => {
-      const [d, f] = toWireValue({
+      const [h, y] = toWireValue({
         value: new TypeError("Unserializable return value"),
         [throwMarker]: 0
       });
-      e.postMessage({ ...d, id: o }, f);
+      e.postMessage({ ...h, id: o }, y);
     }).finally(() => {
       s == null || s(i);
     });
@@ -2751,61 +2872,61 @@ function createProxy(t, e, r = [], s = function() {
       if (a === "then") {
         if (r.length === 0)
           return { then: () => i };
-        const c = requestResponseMessage(t, e, {
+        const l = requestResponseMessage(t, e, {
           type: MessageType.GET,
-          path: r.map((l) => l.toString())
+          path: r.map((c) => c.toString())
         }).then(fromWireValue);
-        return c.then.bind(c);
+        return l.then.bind(l);
       }
       return createProxy(t, e, [...r, a]);
     },
-    set(o, a, c) {
+    set(o, a, l) {
       throwIfProxyReleased(n);
-      const [l, h] = toWireValue(c);
+      const [c, p] = toWireValue(l);
       return requestResponseMessage(
         t,
         e,
         {
           type: MessageType.SET,
-          path: [...r, a].map((d) => d.toString()),
-          value: l
+          path: [...r, a].map((h) => h.toString()),
+          value: c
         },
-        h
+        p
       ).then(fromWireValue);
     },
-    apply(o, a, c) {
+    apply(o, a, l) {
       throwIfProxyReleased(n);
-      const l = r[r.length - 1];
-      if (l === createEndpoint)
+      const c = r[r.length - 1];
+      if (c === createEndpoint)
         return requestResponseMessage(t, e, {
           type: MessageType.ENDPOINT
         }).then(fromWireValue);
-      if (l === "bind")
+      if (c === "bind")
         return createProxy(t, e, r.slice(0, -1));
-      const [h, d] = processArguments(c);
+      const [p, h] = processArguments(l);
       return requestResponseMessage(
         t,
         e,
         {
           type: MessageType.APPLY,
-          path: r.map((f) => f.toString()),
-          argumentList: h
+          path: r.map((y) => y.toString()),
+          argumentList: p
         },
-        d
+        h
       ).then(fromWireValue);
     },
     construct(o, a) {
       throwIfProxyReleased(n);
-      const [c, l] = processArguments(a);
+      const [l, c] = processArguments(a);
       return requestResponseMessage(
         t,
         e,
         {
           type: MessageType.CONSTRUCT,
-          path: r.map((h) => h.toString()),
-          argumentList: c
+          path: r.map((p) => p.toString()),
+          argumentList: l
         },
-        l
+        c
       ).then(fromWireValue);
     }
   });
@@ -2889,6 +3010,153 @@ function nodeEndpoint(t) {
     start: t.start && t.start.bind(t)
   };
 }
+const list = [
+  // Native ES errors https://262.ecma-international.org/12.0/#sec-well-known-intrinsic-objects
+  Error,
+  EvalError,
+  RangeError,
+  ReferenceError,
+  SyntaxError,
+  TypeError,
+  URIError,
+  AggregateError,
+  // Built-in errors
+  globalThis.DOMException,
+  // Node-specific errors
+  // https://nodejs.org/api/errors.html
+  globalThis.AssertionError,
+  globalThis.SystemError
+].filter(Boolean).map((t) => [t.name, t]), errorConstructors = new Map(list);
+class NonError extends Error {
+  constructor(e) {
+    super(NonError._prepareSuperMessage(e)), this.name = "NonError";
+  }
+  static _prepareSuperMessage(e) {
+    try {
+      return JSON.stringify(e);
+    } catch {
+      return String(e);
+    }
+  }
+}
+const errorProperties = [
+  {
+    property: "name",
+    enumerable: !1
+  },
+  {
+    property: "message",
+    enumerable: !1
+  },
+  {
+    property: "stack",
+    enumerable: !1
+  },
+  {
+    property: "code",
+    enumerable: !0
+  },
+  {
+    property: "cause",
+    enumerable: !1
+  },
+  {
+    property: "errors",
+    enumerable: !1
+  }
+], toJsonWasCalled = /* @__PURE__ */ new WeakSet(), toJSON = (t) => {
+  toJsonWasCalled.add(t);
+  const e = t.toJSON();
+  return toJsonWasCalled.delete(t), e;
+}, newError = (t) => {
+  const e = errorConstructors.get(t) ?? Error;
+  return e === AggregateError ? new e([]) : new e();
+}, destroyCircular = ({
+  from: t,
+  seen: e,
+  to: r,
+  forceEnumerable: s,
+  maxDepth: n,
+  depth: i,
+  useToJSON: o,
+  serialize: a
+}) => {
+  if (r || (Array.isArray(t) ? r = [] : !a && isErrorLike(t) ? r = newError(t.name) : r = {}), e.push(t), i >= n)
+    return r;
+  if (o && typeof t.toJSON == "function" && !toJsonWasCalled.has(t))
+    return toJSON(t);
+  const l = (c) => destroyCircular({
+    from: c,
+    seen: [...e],
+    forceEnumerable: s,
+    maxDepth: n,
+    depth: i,
+    useToJSON: o,
+    serialize: a
+  });
+  for (const [c, p] of Object.entries(t)) {
+    if (p && p instanceof Uint8Array && p.constructor.name === "Buffer") {
+      r[c] = "[object Buffer]";
+      continue;
+    }
+    if (p !== null && typeof p == "object" && typeof p.pipe == "function") {
+      r[c] = "[object Stream]";
+      continue;
+    }
+    if (typeof p != "function") {
+      if (!p || typeof p != "object") {
+        try {
+          r[c] = p;
+        } catch {
+        }
+        continue;
+      }
+      if (!e.includes(t[c])) {
+        i++, r[c] = l(t[c]);
+        continue;
+      }
+      r[c] = "[Circular]";
+    }
+  }
+  if (a || r instanceof Error)
+    for (const { property: c, enumerable: p } of errorProperties)
+      t[c] !== void 0 && t[c] !== null && Object.defineProperty(r, c, {
+        value: isErrorLike(t[c]) || Array.isArray(t[c]) ? l(t[c]) : t[c],
+        enumerable: s ? !0 : p,
+        configurable: !0,
+        writable: !0
+      });
+  return r;
+};
+function serializeError(t, e = {}) {
+  const { maxDepth: r = Number.POSITIVE_INFINITY, useToJSON: s = !0 } = e;
+  return typeof t == "object" && t !== null ? destroyCircular({
+    from: t,
+    seen: [],
+    forceEnumerable: !0,
+    maxDepth: r,
+    depth: 0,
+    useToJSON: s,
+    serialize: !0
+  }) : typeof t == "function" ? `[Function: ${t.name || "anonymous"}]` : t;
+}
+function deserializeError(t, e = {}) {
+  const { maxDepth: r = Number.POSITIVE_INFINITY } = e;
+  return t instanceof Error ? t : isMinimumViableSerializedError(t) ? destroyCircular({
+    from: t,
+    seen: [],
+    to: newError(t.name),
+    maxDepth: r,
+    depth: 0,
+    serialize: !1
+  }) : new NonError(t);
+}
+function isErrorLike(t) {
+  return !!t && typeof t == "object" && typeof t.name == "string" && typeof t.message == "string" && typeof t.stack == "string";
+}
+function isMinimumViableSerializedError(t) {
+  return !!t && typeof t == "object" && typeof t.message == "string" && !Array.isArray(t);
+}
 async function consumeAPISync(t) {
   setupTransferHandlers();
   const e = await NodeSABSyncReceiveMessageTransport.create();
@@ -2931,10 +3199,10 @@ function prepareForExpose(t, e) {
   setupTransferHandlers();
   const r = Promise.resolve();
   let s, n;
-  const i = new Promise((c, l) => {
-    s = c, n = l;
+  const i = new Promise((l, c) => {
+    s = l, n = c;
   }), o = proxyClone(t), a = new Proxy(o, {
-    get: (c, l) => l === "isConnected" ? () => r : l === "isReady" ? () => i : l in c ? c[l] : e == null ? void 0 : e[l]
+    get: (l, c) => c === "isConnected" ? () => r : c === "isReady" ? () => i : c in l ? l[c] : e == null ? void 0 : e[c]
   });
   return { setReady: s, setFailed: n, exposedApi: a };
 }
@@ -2985,6 +3253,28 @@ function setupTransferHandlers() {
     return r.response && (s[0].value.response = r.response), r.source && (s[0].value.source = r.source), s;
   };
 }
+const throwTransferHandler = transferHandlers.get(
+  "throw"
+), throwTransferHandlerCustom = {
+  canHandle: throwTransferHandler.canHandle,
+  serialize: ({ value: t }) => {
+    let e;
+    return t instanceof Error ? (e = {
+      isError: !0,
+      value: serializeError(t)
+    }, e.value.originalErrorClassName = t.constructor.name) : e = { isError: !1, value: t }, [e, []];
+  },
+  deserialize: (t) => {
+    if (t.isError) {
+      const e = deserializeError(t.value);
+      throw new Error("Comlink method call failed", {
+        cause: e
+      });
+    }
+    throw t.value;
+  }
+};
+transferHandlers.set("throw", throwTransferHandlerCustom);
 function proxyClone(t) {
   return new Proxy(t, {
     get(e, r) {
@@ -3030,9 +3320,13 @@ export {
   isExitCode,
   iteratePhpFiles as iterateFiles,
   loadPHPRuntime,
+  prettyPrintFullStackTrace,
+  printDebugDetails,
+  printResponseDebugDetails,
   proxyFileSystem,
   removePathPrefix,
   rotatePHPRuntime,
+  sandboxedSpawnHandlerFactory,
   setPhpIniEntries,
   toRelativeUrl,
   withPHPIniValues,