@php-wasm/universal 3.1.39 → 3.1.41

package/index.js

@@ -371,12 +371,12 @@ FSHelpers.mkdir = rethrowFileSystemError('Could not create directory "{path}"')(
   FSHelpers.mkdir
 );
 const _private = /* @__PURE__ */ new WeakMap();
-var j;
+var U;
 class PHPWorker {
   /** @inheritDoc */
   constructor(e, t) {
-    E(this, j);
-    this.absoluteUrl = "", this.documentRoot = "", this.chroot = null, x(this, j, /* @__PURE__ */ new Map()), this.onMessageListeners = [], _private.set(this, {
+    E(this, U);
+    this.absoluteUrl = "", this.documentRoot = "", this.chroot = null, x(this, U, /* @__PURE__ */ new Map()), this.onMessageListeners = [], _private.set(this, {
       monitor: t
     }), e && this.__internal_setRequestHandler(e);
   }
@@ -551,7 +551,7 @@ class PHPWorker {
   }
   /** @inheritDoc @php-wasm/universal!/PHP.addEventListener */
   addEventListener(e, t) {
-    p(this, j).has(e) || p(this, j).set(e, /* @__PURE__ */ new Set()), p(this, j).get(e).add(t);
+    p(this, U).has(e) || p(this, U).set(e, /* @__PURE__ */ new Set()), p(this, U).get(e).add(t);
   }
   /**
    * Removes an event listener for a PHP event.
@@ -560,10 +560,10 @@ class PHPWorker {
    */
   removeEventListener(e, t) {
     var s;
-    (s = p(this, j).get(e)) == null || s.delete(t);
+    (s = p(this, U).get(e)) == null || s.delete(t);
   }
   dispatchEvent(e) {
-    const t = p(this, j).get(e.type);
+    const t = p(this, U).get(e.type);
     if (t)
       for (const s of t)
         s(e);
@@ -595,7 +595,7 @@ class PHPWorker {
       throw new Error("PHPWorker is not connected to a request handler.");
   }
 }
-j = new WeakMap();
+U = new WeakMap();
 function isExitCode(r) {
   return r instanceof Error ? (r == null ? void 0 : r.name) === "ExitStatus" && "status" in r : !1;
 }
@@ -1069,7 +1069,7 @@ class PHPExecutionFailureError extends Error {
   }
 }
 const PHP_INI_PATH = "/internal/shared/php.ini", AUTO_PREPEND_SCRIPT = "/internal/shared/auto_prepend_file.php", OPCACHE_FILE_FOLDER = "/internal/shared/opcache";
-var J, V, z, D, G, X, F, g, Pe, we, _e, ve, Ee, xe, Se, Fe, fe, ke, he, me;
+var Y, V, z, D, G, J, k, g, Pe, we, _e, ve, Ee, xe, Se, ke, fe, Fe, he, me;
 class PHP {
   /**
    * Initializes a PHP runtime.
@@ -1080,7 +1080,7 @@ class PHP {
    */
   constructor(r) {
     E(this, g);
-    E(this, J);
+    E(this, Y);
     E(this, V, !1);
     E(this, z, null);
     E(this, D, /* @__PURE__ */ new Map([
@@ -1088,8 +1088,8 @@ class PHP {
       ["*", /* @__PURE__ */ new Set()]
     ]));
     E(this, G, []);
-    E(this, X, {});
-    E(this, F, {
+    E(this, J, {});
+    E(this, k, {
       enabled: !1,
       recreateRuntime: () => 0,
       needsRotating: !1,
@@ -1097,7 +1097,7 @@ class PHP {
       requestsMade: 0
     });
     this.semaphore = new Semaphore({ concurrency: 1 }), r !== void 0 && this.initializeRuntime(r), this.addEventListener("request.error", (e) => {
-      e.source === "php-wasm" && (p(this, F).needsRotating = !0);
+      e.source === "php-wasm" && (p(this, k).needsRotating = !0);
     });
   }
   /**
@@ -1282,7 +1282,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?"
       );
-    x(this, J, r);
+    x(this, Y, r);
   }
   /**
    * Changes the current working directory in the PHP filesystem.
@@ -1519,7 +1519,7 @@ class PHP {
         );
       _(this, g, we).call(this, r.relativeUri || ""), _(this, g, xe).call(this, r.method || "GET");
       const o = normalizeHeaders(r.headers || {}), i = o.host || "example.com:443", a = _(this, g, Ee).call(this, i, r.protocol || "http");
-      if (_(this, g, _e).call(this, i), _(this, g, ve).call(this, a), _(this, g, Se).call(this, o), r.body && (t = _(this, g, Fe).call(this, r.body)), typeof r.code == "string")
+      if (_(this, g, _e).call(this, i), _(this, g, ve).call(this, a), _(this, g, Se).call(this, o), r.body && (t = _(this, g, ke).call(this, r.body)), typeof r.code == "string")
         this.writeFile("/internal/eval.php", r.code), _(this, g, fe).call(this, "/internal/eval.php");
       else if (typeof r.scriptPath == "string")
         _(this, g, fe).call(this, r.scriptPath || "");
@@ -1529,7 +1529,7 @@ class PHP {
         );
       const c = _(this, g, Pe).call(this, r.$_SERVER, o, a);
       for (const d in c)
-        _(this, g, ke).call(this, d, c[d]);
+        _(this, g, Fe).call(this, d, c[d]);
       const l = r.env || {};
       for (const d in l)
         _(this, g, he).call(this, d, l[d]);
@@ -1770,21 +1770,21 @@ class PHP {
    * or an internal crash.
    */
   enableRuntimeRotation(r) {
-    x(this, F, {
-      ...p(this, F),
+    x(this, k, {
+      ...p(this, k),
       enabled: !0,
       recreateRuntime: r.recreateRuntime,
       maxRequests: r.maxRequests ?? 400
     });
   }
   async rotateRuntime() {
-    if (!p(this, F).enabled)
+    if (!p(this, k).enabled)
       throw new Error(
         "Runtime rotation is not enabled. Call enableRuntimeRotation() first."
       );
     await this.hotSwapPHPRuntime(
-      await p(this, F).recreateRuntime()
-    ), p(this, F).requestsMade = 0, p(this, F).needsRotating = !1;
+      await p(this, k).recreateRuntime()
+    ), p(this, k).requestsMade = 0, p(this, k).needsRotating = !1;
   }
   /**
    * Hot-swaps the PHP runtime for a new one without
@@ -1795,13 +1795,14 @@ class PHP {
   async hotSwapPHPRuntime(r) {
     const e = this[__private__dont__use].FS, t = this.listFiles("/").map((c) => `/${c}`), s = this[__private__dont__use].spawnProcess, n = e.cwd();
     e.chdir("/");
-    const o = Object.entries(p(this, X)).map(
+    const o = Object.entries(p(this, J)).map(
       ([c, l]) => ({
         mountHandler: l.mountHandler,
+        mountPointSnapshot: snapshotMountPoint(e, c),
         vfsPath: c
       })
     ), i = Object.values(
-      p(this, X)
+      p(this, J)
     ).reverse();
     for (const c of i)
       await c.unmount();
@@ -1809,12 +1810,30 @@ class PHP {
       this.exit();
     } catch {
     }
-    this.initializeRuntime(r), s && (this[__private__dont__use].spawnProcess = s), p(this, J) && this.setSapiName(p(this, J));
+    this.initializeRuntime(r), s && (this[__private__dont__use].spawnProcess = s), p(this, Y) && this.setSapiName(p(this, Y));
     const a = this[__private__dont__use].FS;
     for (const c of t)
       c && c !== "/request" && copyMEMFSNodes(e, a, c);
-    for (const { mountHandler: c, vfsPath: l } of o)
-      this.mkdir(l), await this.mount(l, c);
+    for (const {
+      mountHandler: c,
+      mountPointSnapshot: l,
+      vfsPath: d
+    } of o)
+      try {
+        await this.mount(d, c);
+      } catch (u) {
+        if (isMissingMountSourceError(u)) {
+          restoreMountPointSnapshot(
+            a,
+            d,
+            l
+          );
+          continue;
+        }
+        if (!isMissingMountTargetPathError(u))
+          throw u;
+        this.mkdir(d), await this.mount(d, c);
+      }
     try {
       a.chdir(n);
     } catch (c) {
@@ -1844,11 +1863,11 @@ class PHP {
         try {
           await t();
         } finally {
-          delete p(this, X)[r];
+          delete p(this, J)[r];
         }
       }
     };
-    return p(this, X)[r] = s, () => s.unmount();
+    return p(this, J)[r] = s, () => s.unmount();
   }
   /**
    * Starts a PHP CLI session with given arguments.
@@ -1866,7 +1885,7 @@ class PHP {
   async cli(r, e = {}) {
     if (basename(r[0] ?? "") !== "php")
       return this.subProcess(r, e);
-    p(this, V) && (p(this, F).needsRotating = !0);
+    p(this, V) && (p(this, k).needsRotating = !0);
     const t = await this.semaphore.acquire();
     return await _(this, g, me).call(this, () => {
       const s = e.env || {};
@@ -1884,7 +1903,7 @@ class PHP {
         async: !0
       });
     }).then((s) => (s.exitCode.finally(t), s)).finally(() => {
-      p(this, F).needsRotating = !0;
+      p(this, k).needsRotating = !0;
     });
   }
   /**
@@ -1972,7 +1991,7 @@ class PHP {
     this.exit(0);
   }
 }
-J = new WeakMap(), V = new WeakMap(), z = new WeakMap(), D = new WeakMap(), G = new WeakMap(), X = new WeakMap(), F = new WeakMap(), g = new WeakSet(), /**
+Y = new WeakMap(), V = new WeakMap(), z = new WeakMap(), D = new WeakMap(), G = new WeakMap(), J = new WeakMap(), k = new WeakMap(), g = new WeakSet(), /**
  * Prepares the $_SERVER entries for the PHP runtime.
  *
  * @param defaults Default entries to include in $_SERVER.
@@ -2050,7 +2069,7 @@ Pe = function(r, e, t) {
     [NUMBER],
     [parseInt(r["content-length"], 10)]
   );
-}, Fe = function(r) {
+}, ke = function(r) {
   let e, t;
   typeof r == "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"
@@ -2080,7 +2099,7 @@ Pe = function(r, e, t) {
     [STRING],
     [r]
   );
-}, ke = function(r, e) {
+}, Fe = function(r, e) {
   this[__private__dont__use].ccall(
     "wasm_add_SERVER_entry",
     null,
@@ -2095,7 +2114,7 @@ Pe = function(r, e, t) {
     [r, e]
   );
 }, me = async function(r) {
-  p(this, F).enabled && p(this, F).needsRotating && await this.rotateRuntime(), ++p(this, F).requestsMade, p(this, F).requestsMade >= p(this, F).maxRequests && (p(this, F).needsRotating = !0);
+  p(this, k).enabled && p(this, k).needsRotating && await this.rotateRuntime(), ++p(this, k).requestsMade, p(this, k).requestsMade >= p(this, k).maxRequests && (p(this, k).needsRotating = !0);
   const e = this[__private__dont__use], t = await createInvertedReadableStream();
   e.onHeaders = (u) => {
     a || s || t.controller.enqueue(u.slice());
@@ -2194,6 +2213,29 @@ function copyMEMFSNodes(r, e, t) {
   for (const o of n)
     copyMEMFSNodes(r, e, joinPaths(t, o));
 }
+function snapshotMountPoint(r, e) {
+  try {
+    const t = r.lookupPath(e, { follow: !1 });
+    return r.isLink(t.node.mode) ? { kind: "symlink", target: r.readlink(e) } : r.isDir(t.node.mode) ? { kind: "directory" } : { kind: "file" };
+  } catch {
+    return;
+  }
+}
+function restoreMountPointSnapshot(r, e, t) {
+  if (!(!t || getNodeType(r, e) !== "missing")) {
+    if (t.kind === "directory") {
+      r.mkdirTree(e);
+      return;
+    }
+    r.mkdirTree(dirname(e)), t.kind === "symlink" ? r.symlink(t.target, e) : r.writeFile(e, new Uint8Array());
+  }
+}
+function isMissingMountSourceError(r) {
+  return r.phpWasmMountSourceMissing === !0;
+}
+function isMissingMountTargetPathError(r) {
+  return r.errno === 44;
+}
 async function createInvertedReadableStream(r = {}) {
   let e;
   const t = new Promise(
@@ -2284,6 +2326,34 @@ Caused by:
   process.stderr.write(`
 `);
 }
+function describeError(r, e = /* @__PURE__ */ new WeakSet(), t = 0, s = {}) {
+  return t > 10 ? "[Max error cause depth exceeded]" : r instanceof Error ? r.message ? r.message : describeErrorObject(r, e, t, {
+    ...s,
+    suppressGenericErrorName: !0
+  }) : r && typeof r == "object" ? describeErrorObject(r, e, t, s) : String(r);
+}
+function describeErrorObject(r, e, t, s = {}) {
+  if (e.has(r))
+    return "[Circular error cause]";
+  e.add(r);
+  const n = [];
+  if (r.name && !(s.suppressGenericErrorName && r.name === "Error") && n.push(String(r.name)), r.message && n.push(String(r.message)), r.errno !== void 0 && n.push(`errno: ${r.errno}`), r.code !== void 0 && n.push(`code: ${r.code}`), r.cause && n.push(
+    `caused by: ${describeError(
+      r.cause,
+      e,
+      t + 1,
+      s
+    )}`
+  ), n.length > 0)
+    return n.join(" — ");
+  if (typeof r.stack == "string")
+    return r.stack;
+  try {
+    return JSON.stringify(r);
+  } catch {
+    return String(r);
+  }
+}
 function printResponseDebugDetails(r) {
   process.stderr.write(
     `
@@ -2662,7 +2732,7 @@ const _default = "application/octet-stream", asx = "video/x-ms-asf", atom = "app
   xspf,
   zip
 };
-var A, Q, re, Y, K, M, Z, $, se, b, Re, oe, be, He, Te;
+var A, Q, re, X, K, I, Z, $, se, R, be, oe, Re, He, Te;
 class PHPRequestHandler {
   /**
    * The request handler needs to decide whether to serve a static asset or
@@ -2676,13 +2746,13 @@ class PHPRequestHandler {
    * @param  config - Request Handler configuration.
    */
   constructor(e) {
-    E(this, b);
+    E(this, R);
     E(this, A);
     E(this, Q);
     E(this, re);
-    E(this, Y);
+    E(this, X);
     E(this, K);
-    E(this, M);
+    E(this, I);
     E(this, Z);
     E(this, $);
     E(this, se);
@@ -2716,15 +2786,15 @@ class PHPRequestHandler {
       );
     x(this, $, e.cookieStore === void 0 ? new HttpCookieStore() : e.cookieStore), x(this, A, t);
     const c = new URL(s);
-    x(this, re, c.hostname), x(this, Y, c.port ? Number(c.port) : c.protocol === "https:" ? 443 : 80), x(this, Q, (c.protocol || "").replace(":", ""));
-    const l = p(this, Y) !== 443 && p(this, Y) !== 80;
+    x(this, re, c.hostname), x(this, X, c.port ? Number(c.port) : c.protocol === "https:" ? 443 : 80), x(this, Q, (c.protocol || "").replace(":", ""));
+    const l = p(this, X) !== 443 && p(this, X) !== 80;
     x(this, K, [
       p(this, re),
-      l ? `:${p(this, Y)}` : ""
-    ].join("")), x(this, M, c.pathname.replace(/\/+$/, "")), x(this, Z, [
+      l ? `:${p(this, X)}` : ""
+    ].join("")), x(this, I, c.pathname.replace(/\/+$/, "")), x(this, Z, [
       `${p(this, Q)}://`,
       p(this, K),
-      p(this, M)
+      p(this, I)
     ].join("")), this.rewriteRules = n, x(this, se, o), this.getFileNotFoundAction = i;
   }
   async getPrimaryPhp() {
@@ -2749,7 +2819,7 @@ class PHPRequestHandler {
    */
   internalUrlToPath(e) {
     const t = new URL(e, "https://playground.internal");
-    return t.pathname.startsWith(p(this, M)) && (t.pathname = t.pathname.slice(p(this, M).length)), toRelativeUrl(t);
+    return t.pathname.startsWith(p(this, I)) && (t.pathname = t.pathname.slice(p(this, I).length)), toRelativeUrl(t);
   }
   /**
    * The absolute URL of this PHPRequestHandler instance.
@@ -2838,15 +2908,15 @@ class PHPRequestHandler {
       // Remove the hash part of the URL as it's not meant for the server.
       e.url.split("#")[0],
       t ? void 0 : DEFAULT_BASE_URL
-    ), n = _(this, b, Re).call(this, s), o = await this.getPrimaryPhp(), i = removePathPrefix(
+    ), n = _(this, R, be).call(this, s), o = await this.getPrimaryPhp(), i = removePathPrefix(
       /**
        * URL.pathname returns a URL-encoded path. We need to decode it
        * before using it as a filesystem path.
        */
       decodeURIComponent(n.pathname),
-      p(this, M)
+      p(this, I)
     );
-    let a = _(this, b, oe).call(this, i);
+    let a = _(this, R, oe).call(this, i);
     if (o.isDir(a)) {
       if (!i.endsWith("/"))
         return StreamedPHPResponse.fromPHPResponse(
@@ -2871,10 +2941,10 @@ class PHPRequestHandler {
       let c = i;
       for (; c.startsWith("/") && c !== dirname(c); ) {
         c = dirname(c);
-        const l = _(this, b, oe).call(this, c);
+        const l = _(this, R, oe).call(this, c);
         if (o.isFile(l) && // Only run partial path resolution for PHP files.
         l.endsWith(".php")) {
-          a = _(this, b, oe).call(this, c);
+          a = _(this, R, oe).call(this, c);
           break;
         }
       }
@@ -2899,8 +2969,8 @@ class PHPRequestHandler {
           );
       }
     }
-    return o.isFile(a) ? a.endsWith(".php") ? await _(this, b, He).call(this, e, s, n, a) : StreamedPHPResponse.fromPHPResponse(
-      _(this, b, be).call(this, o, a)
+    return o.isFile(a) ? a.endsWith(".php") ? await _(this, R, He).call(this, e, s, n, a) : StreamedPHPResponse.fromPHPResponse(
+      _(this, R, Re).call(this, o, a)
     ) : StreamedPHPResponse.forHttpCode(404);
   }
   /**
@@ -3010,21 +3080,21 @@ class PHPRequestHandler {
     await this.instanceManager[Symbol.asyncDispose]();
   }
 }
-A = new WeakMap(), Q = new WeakMap(), re = new WeakMap(), Y = new WeakMap(), K = new WeakMap(), M = new WeakMap(), Z = new WeakMap(), $ = new WeakMap(), se = new WeakMap(), b = new WeakSet(), /**
+A = new WeakMap(), Q = new WeakMap(), re = new WeakMap(), X = new WeakMap(), K = new WeakMap(), I = new WeakMap(), Z = new WeakMap(), $ = new WeakMap(), se = new WeakMap(), R = new WeakSet(), /**
  * Apply the rewrite rules to the original request URL.
  *
  * @param originalRequestUrl - The original request URL.
  * @returns The rewritten request URL.
  */
-Re = function(e) {
+be = function(e) {
   const t = removePathPrefix(
     decodeURIComponent(e.pathname),
-    p(this, M)
+    p(this, I)
   ), s = applyRewriteRules(
     t,
     this.rewriteRules
   ), n = new URL(
-    joinPaths(p(this, M), s),
+    joinPaths(p(this, I), s),
     e.toString()
   );
   for (const [o, i] of e.searchParams.entries())
@@ -3052,7 +3122,7 @@ oe = function(e) {
  * @param  fsPath - Absolute path of the static file to serve.
  * @returns The response.
  */
-be = function(e, t) {
+Re = function(e, t) {
   const s = e.readFileAsBuffer(t);
   return new PHPResponse(
     200,
@@ -3076,7 +3146,7 @@ be = function(e, t) {
   }
   let i;
   try {
-    i = await _(this, b, Te).call(this, o.php, e, t, s, n);
+    i = await _(this, R, Te).call(this, o.php, e, t, s, n);
   } catch (a) {
     throw o.reap(), a;
   }
@@ -3099,7 +3169,7 @@ be = function(e, t) {
   const l = await e.runStream({
     relativeUri: ensurePathPrefix(
       toRelativeUrl(new URL(n.toString())),
-      p(this, M)
+      p(this, I)
     ),
     protocol: p(this, Q),
     method: t.method || i,
@@ -3290,15 +3360,15 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
   let o = null, i = 0;
   if (i === 0)
     if (r && typeof r == "object" && !Array.isArray(r)) {
-      let L;
-      if (r.name === void 0 && (L = "name") || r.artifacts === void 0 && (L = "artifacts"))
+      let M;
+      if (r.name === void 0 && (M = "name") || r.artifacts === void 0 && (M = "artifacts"))
         return validate11.errors = [
           {
             instancePath: e,
             schemaPath: "#/required",
             keyword: "required",
-            params: { missingProperty: L },
-            message: "must have required property '" + L + "'"
+            params: { missingProperty: M },
+            message: "must have required property '" + M + "'"
           }
         ], !1;
       {
@@ -3349,7 +3419,7 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
             if (a) {
               if (r.mode !== void 0) {
                 let f = r.mode;
-                const R = i;
+                const b = i;
                 if (typeof f != "string")
                   return validate11.errors = [
                     {
@@ -3372,7 +3442,7 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                       message: "must be equal to constant"
                     }
                   ], !1;
-                var a = R === i;
+                var a = b === i;
               } else
                 var a = !0;
               if (a) {
@@ -3392,15 +3462,15 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                 if (a) {
                   if (r.iniEntries !== void 0) {
                     let f = r.iniEntries;
-                    const R = i;
-                    if (i === R)
+                    const b = i;
+                    if (i === b)
                       if (f && typeof f == "object" && !Array.isArray(f))
-                        for (const U in f) {
+                        for (const j in f) {
                           const m = i;
-                          if (typeof f[U] != "string")
+                          if (typeof f[j] != "string")
                             return validate11.errors = [
                               {
-                                instancePath: e + "/iniEntries/" + U.replace(
+                                instancePath: e + "/iniEntries/" + j.replace(
                                   /~/g,
                                   "~0"
                                 ).replace(
@@ -3431,21 +3501,21 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                             message: "must be object"
                           }
                         ], !1;
-                    var a = R === i;
+                    var a = b === i;
                   } else
                     var a = !0;
                   if (a) {
                     if (r.env !== void 0) {
                       let f = r.env;
-                      const R = i;
-                      if (i === R)
+                      const b = i;
+                      if (i === b)
                         if (f && typeof f == "object" && !Array.isArray(f))
-                          for (const U in f) {
+                          for (const j in f) {
                             const m = i;
-                            if (typeof f[U] != "string")
+                            if (typeof f[j] != "string")
                               return validate11.errors = [
                                 {
-                                  instancePath: e + "/env/" + U.replace(
+                                  instancePath: e + "/env/" + j.replace(
                                     /~/g,
                                     "~0"
                                   ).replace(
@@ -3476,7 +3546,7 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                               message: "must be object"
                             }
                           ], !1;
-                      var a = R === i;
+                      var a = b === i;
                     } else
                       var a = !0;
                     if (a) {
@@ -3500,29 +3570,29 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                       if (a) {
                         if (r.artifacts !== void 0) {
                           let f = r.artifacts;
-                          const R = i;
-                          if (i === R)
+                          const b = i;
+                          if (i === b)
                             if (Array.isArray(f)) {
                               var d = !0;
-                              const U = f.length;
-                              for (let m = 0; m < U; m++) {
+                              const j = f.length;
+                              for (let m = 0; m < j; m++) {
                                 let w = f[m];
-                                const q = i;
-                                if (i === q)
+                                const W = i;
+                                if (i === W)
                                   if (w && typeof w == "object" && !Array.isArray(
                                     w
                                   )) {
-                                    let W;
-                                    if (w.phpVersion === void 0 && (W = "phpVersion") || w.sourcePath === void 0 && (W = "sourcePath"))
+                                    let q;
+                                    if (w.phpVersion === void 0 && (q = "phpVersion") || w.sourcePath === void 0 && (q = "sourcePath"))
                                       return validate11.errors = [
                                         {
                                           instancePath: e + "/artifacts/" + m,
                                           schemaPath: "#/properties/artifacts/items/required",
                                           keyword: "required",
                                           params: {
-                                            missingProperty: W
+                                            missingProperty: q
                                           },
-                                          message: "must have required property '" + W + "'"
+                                          message: "must have required property '" + q + "'"
                                         }
                                       ], !1;
                                     {
@@ -3625,16 +3695,16 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                             v
                                                           )) {
                                                             var P = !0;
-                                                            const Ie = v.length;
-                                                            for (let C = 0; C < Ie; C++) {
-                                                              let I = v[C];
+                                                            const Le = v.length;
+                                                            for (let C = 0; C < Le; C++) {
+                                                              let L = v[C];
                                                               const ye = i;
                                                               if (i === ye)
-                                                                if (I && typeof I == "object" && !Array.isArray(
-                                                                  I
+                                                                if (L && typeof L == "object" && !Array.isArray(
+                                                                  L
                                                                 )) {
                                                                   let ue;
-                                                                  if (I.vfsPath === void 0 && (ue = "vfsPath"))
+                                                                  if (L.vfsPath === void 0 && (ue = "vfsPath"))
                                                                     return validate11.errors = [
                                                                       {
                                                                         instancePath: e + "/artifacts/" + m + "/extraFiles/nodes/" + C,
@@ -3647,8 +3717,8 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                                       }
                                                                     ], !1;
                                                                   {
-                                                                    const Me = i;
-                                                                    for (const T in I)
+                                                                    const Ie = i;
+                                                                    for (const T in L)
                                                                       if (!(T === "vfsPath" || T === "type" || T === "sourcePath"))
                                                                         return validate11.errors = [
                                                                           {
@@ -3661,10 +3731,10 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                                             message: "must NOT have additional properties"
                                                                           }
                                                                         ], !1;
-                                                                    if (Me === i) {
-                                                                      if (I.vfsPath !== void 0) {
+                                                                    if (Ie === i) {
+                                                                      if (L.vfsPath !== void 0) {
                                                                         const T = i;
-                                                                        if (typeof I.vfsPath != "string")
+                                                                        if (typeof L.vfsPath != "string")
                                                                           return validate11.errors = [
                                                                             {
                                                                               instancePath: e + "/artifacts/" + m + "/extraFiles/nodes/" + C + "/vfsPath",
@@ -3680,8 +3750,8 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                                       } else
                                                                         var S = !0;
                                                                       if (S) {
-                                                                        if (I.type !== void 0) {
-                                                                          let T = I.type;
+                                                                        if (L.type !== void 0) {
+                                                                          let T = L.type;
                                                                           const Ce = i;
                                                                           if (typeof T != "string")
                                                                             return validate11.errors = [
@@ -3711,9 +3781,9 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                                         } else
                                                                           var S = !0;
                                                                         if (S)
-                                                                          if (I.sourcePath !== void 0) {
+                                                                          if (L.sourcePath !== void 0) {
                                                                             const T = i;
-                                                                            if (typeof I.sourcePath != "string")
+                                                                            if (typeof L.sourcePath != "string")
                                                                               return validate11.errors = [
                                                                                 {
                                                                                   instancePath: e + "/artifacts/" + m + "/extraFiles/nodes/" + C + "/sourcePath",
@@ -3793,7 +3863,7 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                         message: "must be object"
                                       }
                                     ], !1;
-                                var d = q === i;
+                                var d = W === i;
                                 if (!d)
                                   break;
                               }
@@ -3809,13 +3879,13 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                   message: "must be array"
                                 }
                               ], !1;
-                          var a = R === i;
+                          var a = b === i;
                         } else
                           var a = !0;
                         if (a)
                           if (r.extraFiles !== void 0) {
                             let f = r.extraFiles;
-                            const R = i;
+                            const b = i;
                             if (i === i)
                               if (f && typeof f == "object" && !Array.isArray(
                                 f
@@ -3855,14 +3925,14 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                   if (N)
                                     if (f.nodes !== void 0) {
                                       let w = f.nodes;
-                                      const q = i;
-                                      if (i === q)
+                                      const W = i;
+                                      if (i === W)
                                         if (Array.isArray(
                                           w
                                         )) {
                                           var B = !0;
-                                          const W = w.length;
-                                          for (let H = 0; H < W; H++) {
+                                          const q = w.length;
+                                          for (let H = 0; H < q; H++) {
                                             let y = w[H];
                                             const ne = i;
                                             if (i === ne)
@@ -3912,10 +3982,10 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                             message: "must be string"
                                                           }
                                                         ], !1;
-                                                      var k = v === i;
+                                                      var F = v === i;
                                                     } else
-                                                      var k = !0;
-                                                    if (k) {
+                                                      var F = !0;
+                                                    if (F) {
                                                       if (y.type !== void 0) {
                                                         let v = y.type;
                                                         const ie = i;
@@ -3943,10 +4013,10 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                               message: "must be equal to one of the allowed values"
                                                             }
                                                           ], !1;
-                                                        var k = ie === i;
+                                                        var F = ie === i;
                                                       } else
-                                                        var k = !0;
-                                                      if (k)
+                                                        var F = !0;
+                                                      if (F)
                                                         if (y.sourcePath !== void 0) {
                                                           const v = i;
                                                           if (typeof y.sourcePath != "string")
@@ -3961,9 +4031,9 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                                                 message: "must be string"
                                                               }
                                                             ], !1;
-                                                          var k = v === i;
+                                                          var F = v === i;
                                                         } else
-                                                          var k = !0;
+                                                          var F = !0;
                                                     }
                                                   }
                                                 }
@@ -3995,7 +4065,7 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                               message: "must be array"
                                             }
                                           ], !1;
-                                      var N = q === i;
+                                      var N = W === i;
                                     } else
                                       var N = !0;
                                 }
@@ -4011,7 +4081,7 @@ function validate11(r, { instancePath: e = "", parentData: t, parentDataProperty
                                     message: "must be object"
                                   }
                                 ], !1;
-                            var a = R === i;
+                            var a = b === i;
                           } else
                             var a = !0;
                       }
@@ -4057,9 +4127,9 @@ async function resolvePHPExtension(r) {
       );
     n = toUint8Array(t.bytes);
   } else if (t.format === "url") {
-    let k;
+    let F;
     try {
-      k = new URL(String(t.url));
+      F = new URL(String(t.url));
     } catch {
       throw new Error(
         `source.url must be an absolute URL when loading a PHP extension from a direct URL. Received: ${String(
@@ -4067,21 +4137,21 @@ async function resolvePHPExtension(r) {
         )}`
       );
     }
-    if (s || (s = t.name), !s && k.pathname.endsWith(".so") && (s = basename(k.pathname).slice(0, -3)), !s)
+    if (s || (s = t.name), !s && F.pathname.endsWith(".so") && (s = basename(F.pathname).slice(0, -3)), !s)
       throw new Error(
         "name is required when loading an extension from a direct URL."
       );
-    n = await fetchBytes(e, k);
+    n = await fetchBytes(e, F);
   } else {
-    let k, L;
-    if ("manifest" in t ? (k = t.manifest, t.baseUrl && (L = new URL(String(t.baseUrl)))) : (L = new URL(String(t.manifestUrl)), k = await (await e(L)).json()), !validate10(k))
+    let F, M;
+    if ("manifest" in t ? (F = t.manifest, t.baseUrl && (M = new URL(String(t.baseUrl)))) : (M = new URL(String(t.manifestUrl)), F = await (await e(M)).json()), !validate10(F))
       throw new Error(
         `Invalid PHP extension manifest: ${JSON.stringify(
           validate10.errors
         )}`
       );
-    const O = k;
-    if (!L)
+    const O = F;
+    if (!M)
       throw new Error(
         "Manifest artifacts require a manifest URL or baseUrl so relative files can be resolved."
       );
@@ -4093,29 +4163,29 @@ async function resolvePHPExtension(r) {
         `No extension artifact found for PHP ${r.phpVersion}.`
       );
     s ?? (s = O.name), a = O.loadWithIniDirective, c = O.iniEntries, l = O.env, d = O.extensionDir;
-    const R = new Semaphore({
+    const b = new Semaphore({
       concurrency: MAX_EXTENSION_SIDECAR_FILE_REQUESTS
     }), ce = [];
     for (const m of [O.extraFiles, f.extraFiles])
       for (const w of (m == null ? void 0 : m.nodes) ?? []) {
-        const q = joinPaths(m.vfsRoot ?? "", w.vfsPath);
+        const W = joinPaths(m.vfsRoot ?? "", w.vfsPath);
         if (w.type === "directory") {
-          i.push(q);
+          i.push(W);
           continue;
         }
         if (!w.sourcePath) continue;
-        const Le = new URL(w.sourcePath, L);
+        const Me = new URL(w.sourcePath, M);
         ce.push(
-          R.run(() => fetchBytes(e, Le)).then((W) => {
-            o[q] = W;
+          b.run(() => fetchBytes(e, Me)).then((q) => {
+            o[W] = q;
           })
         );
       }
-    const [U] = await Promise.all([
-      fetchBytes(e, new URL(f.sourcePath, L)),
+    const [j] = await Promise.all([
+      fetchBytes(e, new URL(f.sourcePath, M)),
       ...ce
     ]);
-    n = U;
+    n = j;
   }
   const u = normalizePath(
     r.extensionDir ?? d ?? PHP_EXTENSIONS_DIR
@@ -5971,6 +6041,7 @@ export {
   consumeAPISync,
   createLegacyPhpIniPreRunStep,
   createObjectPoolProxy,
+  describeError,
   ensurePathPrefix,
   exposeAPI,
   exposeSyncAPI,