@php-wasm/universal 0.9.28 → 0.9.29

package/index.js

@@ -1528,8 +1528,9 @@ class PHPProcessManager {
   /**
    * Get a PHP instance.
    *
-   * It could be either the primary PHP instance, an idle disposable PHP instance,
-   * or a newly spawned PHP instance – depending on the resource availability.
+   * It could be either the primary PHP instance, an idle disposable PHP
+   * instance, or a newly spawned PHP instance – depending on the resource
+   * availability.
    *
    * @throws {MaxPhpInstancesError} when the maximum number of PHP instances is reached
    *                                and the waiting timeout is exceeded.
@@ -1863,8 +1864,8 @@ class PHPRequestHandler {
    * dispatching it to the PHP runtime.
    *
    * The request() method mode behaves like a web server and only works if
-   * the PHP was initialized with a `requestHandler` option (which the online version
-   * of WordPress Playground does by default).
+   * the PHP was initialized with a `requestHandler` option (which the online
+   * version of WordPress Playground does by default).
    *
    * In the request mode, you pass an object containing the request information
    * (method, headers, body, etc.) and the path to the PHP file to run:
@@ -1972,9 +1973,9 @@ P = new WeakMap(), R = new WeakMap(), T = new WeakMap(), v = new WeakMap(), F =
     200,
     {
       "content-length": [`${s.byteLength}`],
-      // @TODO: Infer the content-type from the arrayBuffer instead of the file path.
-      //        The code below won't return the correct mime-type if the extension
-      //        was tampered with.
+      // @TODO: Infer the content-type from the arrayBuffer instead of the
+      // file path. The code below won't return the correct mime-type if the
+      // extension was tampered with.
       "content-type": [inferMimeType(r)],
       "accept-ranges": ["bytes"],
       "cache-control": ["public, max-age=0"]

package/lib/emscripten-types.d.ts

@@ -1,4 +1,7 @@
-/** Other WebAssembly declarations, for compatibility with older versions of Typescript */
+/**
+ * Other WebAssembly declarations, for compatibility with older versions of
+ * Typescript
+ */
 export declare namespace Emscripten {
     export interface RootFS extends Emscripten.FileSystemInstance {
         filesystems: Record<string, Emscripten.FileSystemType>;
@@ -86,12 +89,12 @@ export declare namespace Emscripten {
      * to `1` in your Emscripten build. It return a Promise that resolves to an
      * initialized, ready-to-call `EmscriptenModule` instance.
      *
-     * By default, the factory function will be named `Module`. It's recommended to
-     * use the `EXPORT_ES6` option, in which the factory function will be the
-     * default export. If used without `EXPORT_ES6`, the factory function will be a
-     * global variable. You can rename the variable using the `EXPORT_NAME` build
-     * option. It's left to you to export any global variables as needed in your
-     * application's types.
+     * By default, the factory function will be named `Module`. It's recommended
+     * to use the `EXPORT_ES6` option, in which the factory function will be the
+     * default export. If used without `EXPORT_ES6`, the factory function will be
+     * a global variable. You can rename the variable using the `EXPORT_NAME`
+     * build option. It's left to you to export any global variables as needed in
+     * your application's types.
      * @param moduleOverrides Default properties for the initialized module.
      */
     export type EmscriptenModuleFactory<T extends EmscriptenModule = EmscriptenModule> = (moduleOverrides?: Partial<T>) => Promise<T>;

package/lib/load-php-runtime.d.ts

@@ -1,7 +1,8 @@
 /**
  * Loads the PHP runtime with the given arguments and data dependencies.
  *
- * This function handles the entire PHP initialization pipeline. In particular, it:
+ * This function handles the entire PHP initialization pipeline. In particular,
+ * it:
  *
  * * Instantiates the Emscripten PHP module
  * * Wires it together with the data dependencies and loads them
@@ -19,10 +20,10 @@
  *
  * **The PHP loader module:**
  *
- * In the basic usage example, `phpLoaderModule` is **not** a vanilla Emscripten module. Instead,
- * it's an ESM module that wraps the regular Emscripten output and adds some
- * extra functionality. It's generated by the Dockerfile shipped with this repo.
- * Here's the API it provides:
+ * In the basic usage example, `phpLoaderModule` is **not** a vanilla
+ * Emscripten module. Instead, it's an ESM module that wraps the regular
+ * Emscripten output and adds some extra functionality. It's generated by the
+ * Dockerfile shipped with this repo. Here's the API it provides:
  *
  * ```js
  * // php.wasm size in bytes:
@@ -72,17 +73,19 @@
  * be quite inconvenient. Fortunately, Emscripten provides a "data dependencies"
  * feature.
  *
- * Data dependencies consist of a `dependency.data` file and a `dependency.js` loader and
- * can be packaged with the [file_packager.py tool]( https://emscripten.org/docs/porting/files/packaging_files.html#packaging-using-the-file-packager-tool).
- * This project requires wrapping the Emscripten-generated `dependency.js` file in an ES
- * module as follows:
+ * Data dependencies consist of a `dependency.data` file and a `dependency.js`
+ * loader and can be packaged with the [file_packager.py tool](
+ * https://emscripten.org/docs/porting/files/packaging_files.html#packaging-using-the-file-packager-tool).
+ * This project requires wrapping the Emscripten-generated `dependency.js` file
+ * in an ES module as follows:
  *
  * 1. Prepend `export default function(emscriptenPHPModule) {'; `
  * 2. Prepend `export const dependencyFilename = '<DATA FILE NAME>'; `
  * 3. Prepend `export const dependenciesTotalSize = <DATA FILE SIZE>;`
  * 4. Append `}`
  *
- * Be sure to use the `--export-name="emscriptenPHPModule"` file_packager.py option.
+ * Be sure to use the `--export-name="emscriptenPHPModule"` file_packager.py
+ * option.
  *
  * You want the final output to look as follows:
  *
@@ -96,8 +99,8 @@
  * }
  * ```
  *
- * Such a constructions enables loading the `dependency.js` as an ES Module using
- * `import("/dependency.js")`.
+ * Such a constructions enables loading the `dependency.js` as an ES Module
+ * using `import("/dependency.js")`.
  *
  * Once it's ready, you can load PHP and your data dependencies as follows:
  *

package/lib/php-process-manager.d.ts

@@ -44,18 +44,20 @@ export declare class MaxPhpInstancesError extends Error {
  * * A pool of disposable PHP instances that are spawned to handle a single
  *   request and reaped immediately after.
  *
- * When a new request comes in, PHPProcessManager yields the idle instance to handle it,
- * and immediately starts initializing a new idle instance. In other words, for n concurrent
- * requests, there are at most n+1 PHP instances running at the same time.
+ * When a new request comes in, PHPProcessManager yields the idle instance to
+ * handle it, and immediately starts initializing a new idle instance. In other
+ * words, for n concurrent requests, there are at most n+1 PHP instances
+ * running at the same time.
  *
- * A slight nuance is that the first idle instance is not initialized until the first
- * concurrent request comes in. This is because many use-cases won't involve parallel
- * requests and, for those, we can avoid eagerly spinning up a second PHP instance.
+ * A slight nuance is that the first idle instance is not initialized until the
+ * first concurrent request comes in. This is because many use-cases won't
+ * involve parallel requests and, for those, we can avoid eagerly spinning up a
+ * second PHP instance.
  *
- * This strategy is inspired by Cowboy, an Erlang HTTP server. Handling a single extra
- * request can happen immediately, while handling multiple extra requests requires
- * extra time to spin up a few PHP instances. This is a more resource-friendly tradeoff
- * than keeping 5 idle instances at all times.
+ * This strategy is inspired by Cowboy, an Erlang HTTP server. Handling a
+ * single extra request can happen immediately, while handling multiple extra
+ * requests requires extra time to spin up a few PHP instances. This is a more
+ * resource-friendly tradeoff than keeping 5 idle instances at all times.
  */
 export declare class PHPProcessManager implements AsyncDisposable {
     private primaryPhp?;
@@ -82,8 +84,9 @@ export declare class PHPProcessManager implements AsyncDisposable {
     /**
      * Get a PHP instance.
      *
-     * It could be either the primary PHP instance, an idle disposable PHP instance,
-     * or a newly spawned PHP instance – depending on the resource availability.
+     * It could be either the primary PHP instance, an idle disposable PHP
+     * instance, or a newly spawned PHP instance – depending on the resource
+     * availability.
      *
      * @throws {MaxPhpInstancesError} when the maximum number of PHP instances is reached
      *                                and the waiting timeout is exceeded.

package/lib/php-request-handler.d.ts

@@ -165,8 +165,8 @@ export declare class PHPRequestHandler {
      * dispatching it to the PHP runtime.
      *
      * The request() method mode behaves like a web server and only works if
-     * the PHP was initialized with a `requestHandler` option (which the online version
-     * of WordPress Playground does by default).
+     * the PHP was initialized with a `requestHandler` option (which the online
+     * version of WordPress Playground does by default).
      *
      * In the request mode, you pass an object containing the request information
      * (method, headers, body, etc.) and the path to the PHP file to run:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "0.9.28",
+  "version": "0.9.29",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,7 +37,7 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "15d87898b0a7f8a0cf322425923336df1d84843b",
+  "gitHead": "79ef61d98407b1a90f622f6bef8f91001c568d00",
   "engines": {
     "node": ">=18.18.0",
     "npm": ">=8.11.0"
@@ -45,10 +45,10 @@
   "dependencies": {
     "comlink": "^4.4.1",
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "0.9.28",
-    "@php-wasm/logger": "0.9.28",
-    "@php-wasm/util": "0.9.28",
-    "@php-wasm/stream-compression": "0.9.28",
-    "@php-wasm/progress": "0.9.28"
+    "@php-wasm/node-polyfills": "0.9.29",
+    "@php-wasm/logger": "0.9.29",
+    "@php-wasm/util": "0.9.29",
+    "@php-wasm/stream-compression": "0.9.29",
+    "@php-wasm/progress": "0.9.29"
   }
 }