@php-wasm/universal 1.1.3 → 1.1.4

package/lib/api.d.ts

@@ -0,0 +1,18 @@
+import * as Comlink from 'comlink';
+import type { NodeEndpoint } from 'comlink/dist/esm/node-adapter';
+export type WithAPIState = {
+    /**
+     * Resolves to true when the remote API is ready for
+     * Comlink communication, but not necessarily fully initialized yet.
+     */
+    isConnected: () => Promise<void>;
+    /**
+     * Resolves to true when the remote API is declares it's
+     * fully loaded and ready to be used.
+     */
+    isReady: () => Promise<void>;
+};
+export type RemoteAPI<T> = Comlink.Remote<T> & WithAPIState;
+export declare function consumeAPI<APIType>(remote: Worker | Window | NodeEndpoint, context?: undefined | EventTarget): RemoteAPI<APIType>;
+export type PublicAPI<Methods, PipedAPI = unknown> = RemoteAPI<Methods & PipedAPI>;
+export declare function exposeAPI<Methods, PipedAPI>(apiMethods?: Methods, pipedApi?: PipedAPI, targetWorker?: NodeEndpoint): [() => void, (e: Error) => void, PublicAPI<Methods, PipedAPI>];

package/lib/index.d.ts

@@ -29,3 +29,5 @@ export type { FileTree } from './write-files';
 export { DEFAULT_BASE_URL, ensurePathPrefix, removePathPrefix, toRelativeUrl, } from './urls';
 export { isExitCode } from './is-exit-code';
 export { proxyFileSystem } from './proxy-file-system';
+export * from './api';
+export type { WithAPIState as WithIsReady } from './api';

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

@@ -136,7 +136,7 @@ export type PHPRequestHandlerConfiguration = BaseConfiguration & ({
  * // "Hi from PHP!"
  * ```
  */
-export declare class PHPRequestHandler {
+export declare class PHPRequestHandler implements AsyncDisposable {
     #private;
     rewriteRules: RewriteRule[];
     processManager: PHPProcessManager;
@@ -228,6 +228,7 @@ export declare class PHPRequestHandler {
      * @param  request - PHP Request data.
      */
     request(request: PHPRequest): Promise<PHPResponse>;
+    [Symbol.asyncDispose](): Promise<void>;
 }
 /**
  * Applies the given rewrite rules to the given path.

package/lib/php-worker.d.ts

@@ -11,7 +11,7 @@ export type LimitedPHPApi = Pick<PHP, 'request' | 'defineConstant' | 'addEventLi
 /**
  * A PHP client that can be used to run PHP code in the browser.
  */
-export declare class PHPWorker implements LimitedPHPApi {
+export declare class PHPWorker implements LimitedPHPApi, AsyncDisposable {
     /** @inheritDoc @php-wasm/universal!RequestHandler.absoluteUrl  */
     absoluteUrl: string;
     /** @inheritDoc @php-wasm/universal!RequestHandler.documentRoot  */
@@ -76,4 +76,5 @@ export declare class PHPWorker implements LimitedPHPApi {
     addEventListener(eventType: PHPEvent['type'], listener: PHPEventListener): void;
     /** @inheritDoc @php-wasm/universal!/PHP.removeEventListener */
     removeEventListener(eventType: PHPEvent['type'], listener: PHPEventListener): void;
+    [Symbol.asyncDispose](): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,19 +37,19 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "977f8e90eabb2c8d4eed75677ddd9fb6c13274ae",
+  "gitHead": "ed646326d99ba84bad911d65b6634265f508f073",
   "engines": {
     "node": ">=20.18.3",
     "npm": ">=10.1.0"
   },
   "dependencies": {
-    "comlink": "^4.4.1",
+    "comlink": "^4.4.2",
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "1.1.3",
-    "@php-wasm/logger": "1.1.3",
-    "@php-wasm/util": "1.1.3",
-    "@php-wasm/stream-compression": "1.1.3",
-    "@php-wasm/progress": "1.1.3"
+    "@php-wasm/node-polyfills": "1.1.4",
+    "@php-wasm/logger": "1.1.4",
+    "@php-wasm/util": "1.1.4",
+    "@php-wasm/stream-compression": "1.1.4",
+    "@php-wasm/progress": "1.1.4"
   },
   "overrides": {
     "rollup": "^4.34.6",