@php-wasm/universal 3.1.1 → 3.1.2

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

@@ -1,5 +1,5 @@
 import type { PHP } from './php';
-import { PHPResponse } from './php-response';
+import { PHPResponse, StreamedPHPResponse } from './php-response';
 import type { PHPRequest } from './universal-php';
 import type { PHPFactoryOptions } from './php-process-manager';
 import type { PHPInstanceManager } from './php-instance-manager';
@@ -261,6 +261,18 @@ export declare class PHPRequestHandler implements AsyncDisposable {
      * @param  request - PHP Request data.
      */
     request(request: PHPRequest): Promise<PHPResponse>;
+    /**
+     * Serves the request with streaming support – returns a StreamedPHPResponse
+     * that allows processing the response body incrementally without buffering
+     * the entire response in memory.
+     *
+     * This is useful for large file downloads (>2GB) that would otherwise
+     * exceed JavaScript's Uint8Array size limits.
+     *
+     * @param request - PHP Request data.
+     * @returns A StreamedPHPResponse.
+     */
+    requestStreamed(request: PHPRequest): Promise<StreamedPHPResponse>;
     /**
      * Computes the essential $_SERVER entries for a request.
      *

package/lib/php-response.d.ts

@@ -23,10 +23,7 @@ export interface PHPResponseData {
     readonly httpStatusCode: number;
 }
 export declare class StreamedPHPResponse {
-    /**
-     * Response headers.
-     */
-    private readonly headersStream;
+    #private;
     /**
      * Response body. Contains the output from `echo`,
      * `print`, inline HTML etc.
@@ -45,6 +42,21 @@ export declare class StreamedPHPResponse {
     private cachedStdoutBytes;
     private cachedStderrText;
     constructor(headers: ReadableStream<Uint8Array>, stdout: ReadableStream<Uint8Array>, stderr: ReadableStream<Uint8Array>, exitCode: Promise<number>);
+    /**
+     * Creates a StreamedPHPResponse from a buffered PHPResponse.
+     * Useful for unifying response handling when both types may be returned.
+     */
+    static fromPHPResponse(response: PHPResponse): StreamedPHPResponse;
+    /**
+     * Creates a StreamedPHPResponse for a given HTTP status code.
+     * Shorthand for `StreamedPHPResponse.fromPHPResponse(PHPResponse.forHttpCode(...))`.
+     */
+    static forHttpCode(httpStatusCode: number, text?: string): StreamedPHPResponse;
+    /**
+     * Returns the raw headers stream for serialization purposes.
+     * For parsed headers, use the `headers` property instead.
+     */
+    getHeadersStream(): ReadableStream<Uint8Array>;
     /**
      * True if the response is successful (HTTP status code 200-399),
      * false otherwise.

package/lib/php-worker.d.ts

@@ -59,6 +59,17 @@ export declare class PHPWorker implements LimitedPHPApi, AsyncDisposable {
     rmdir(path: string, options?: RmDirOptions): Promise<void>;
     /** @inheritDoc @php-wasm/universal!PHPRequestHandler.request */
     request(request: PHPRequest): Promise<PHPResponse>;
+    /**
+     * Handles a request with streaming support for large responses.
+     * Returns a StreamedPHPResponse that allows processing the response
+     * body incrementally without buffering the entire response in memory.
+     *
+     * This is useful for large file downloads (>2GB) that would otherwise
+     * exceed JavaScript's Uint8Array size limits.
+     *
+     * @param request - PHP Request data.
+     */
+    requestStreamed(request: PHPRequest): Promise<StreamedPHPResponse>;
     /** @inheritDoc @php-wasm/universal!/PHP.run */
     run(request: PHPRunOptions): Promise<PHPResponse>;
     /** @inheritDoc @php-wasm/universal!/PHP.cli */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,18 +37,18 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "71560d81fcde96435d5730a0430abcafaa6f92b8",
+  "gitHead": "4a2f8903e9d4a58e33382f8f888ef94d42d913dc",
   "engines": {
     "node": ">=20.10.0",
     "npm": ">=10.2.3"
   },
   "dependencies": {
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "3.1.1",
-    "@php-wasm/logger": "3.1.1",
-    "@php-wasm/util": "3.1.1",
-    "@php-wasm/stream-compression": "3.1.1",
-    "@php-wasm/progress": "3.1.1"
+    "@php-wasm/node-polyfills": "3.1.2",
+    "@php-wasm/logger": "3.1.2",
+    "@php-wasm/util": "3.1.2",
+    "@php-wasm/stream-compression": "3.1.2",
+    "@php-wasm/progress": "3.1.2"
   },
   "packageManager": "npm@10.9.2",
   "overrides": {