@php-wasm/web 0.1.59 → 0.1.61

package/index.d.ts

@@ -372,7 +372,48 @@ export interface IsomorphicLocalPHP extends RequestHandler {
 	 * @param  options - PHP runtime options.
 	 */
 	run(options: PHPRunOptions): Promise<PHPResponse>;
+	/**
+	 * Listens to message sent by the PHP code.
+	 *
+	 * To dispatch messages, call:
+	 *
+	 *     post_message_to_js(string $data)
+	 *
+	 *     Arguments:
+	 *         $data – any extra information as a string
+	 *
+	 * @example
+	 *
+	 * ```ts
+	 * const php = await PHP.load('8.0');
+	 *
+	 * php.onMessage(
+	 *     // The data is always passed as a string
+	 *     function (data: string) {
+	 *         // Let's decode and log the data:
+	 *         console.log(JSON.parse(data));
+	 *     }
+	 * );
+	 *
+	 * // Now that we have a listener in place, let's
+	 * // dispatch a message:
+	 * await php.run({
+	 *     code: `<?php
+	 *         post_message_to_js(
+	 *             json_encode([
+	 *                 'post_id' => '15',
+	 *                 'post_title' => 'This is a blog post!'
+	 *             ])
+	 *         ));
+	 *     `,
+	 * });
+	 * ```
+	 *
+	 * @param listener Callback function to handle the message.
+	 */
+	onMessage(listener: MessageListener): void;
 }
+export type MessageListener = (data: string) => void;
 export type HTTPMethod = "GET" | "POST" | "HEAD" | "OPTIONS" | "PATCH" | "PUT" | "DELETE";
 export type PHPRequestHeaders = Record<string, string>;
 export interface PHPRequest {
@@ -577,7 +618,9 @@ export type EmscriptenOptions = {
 	quit?: (status: number, toThrow: any) => void;
 	onRuntimeInitialized?: () => void;
 	monitorRunDependencies?: (left: number) => void;
+	onMessage?: (listener: EmscriptenMessageListener) => void;
 } & Record<string, any>;
+export type EmscriptenMessageListener = (type: string, data: string) => void;
 declare const __private__dont__use: unique symbol;
 declare abstract class BasePHP implements IsomorphicLocalPHP {
 	#private;
@@ -592,6 +635,8 @@ declare abstract class BasePHP implements IsomorphicLocalPHP {
 	 */
 	constructor(PHPRuntimeId?: PHPRuntimeId, serverOptions?: PHPRequestHandlerConfiguration);
 	/** @inheritDoc */
+	onMessage(listener: MessageListener): Promise<void>;
+	/** @inheritDoc */
 	get absoluteUrl(): string;
 	/** @inheritDoc */
 	get documentRoot(): string;
@@ -676,7 +721,6 @@ export declare class WebPHP extends BasePHP {
 	static loadSync(phpVersion: SupportedPHPVersion, options?: PHPWebLoaderOptions): {
 		php: WebPHP;
 		phpReady: Promise<WebPHP>;
-		dataModules: Promise<DataModule[]>;
 	};
 }
 /**
@@ -729,6 +773,8 @@ export declare class WebPHPEndpoint implements IsomorphicLocalPHP {
 	isDir(path: string): boolean;
 	/** @inheritDoc @php-wasm/web!WebPHP.fileExists */
 	fileExists(path: string): boolean;
+	/** @inheritDoc @php-wasm/web!WebPHP.onMessage */
+	onMessage(listener: MessageListener): void;
 }
 export declare function getPHPLoaderModule(version?: SupportedPHPVersion): Promise<PHPLoaderModule>;
 /**