@php-wasm/universal 1.0.28 → 1.1.0

package/lib/fs-helpers.d.ts

@@ -1,4 +1,4 @@
-import { Emscripten } from './emscripten-types';
+import type { Emscripten } from './emscripten-types';
 export interface RmDirOptions {
     /**
      * If true, recursively removes the directory and all its contents.

package/lib/http-cookie-store.d.ts

@@ -1,7 +1,8 @@
+import type { CookieStore } from './php-request-handler';
 /**
  * @public
  */
-export declare class HttpCookieStore {
+export declare class HttpCookieStore implements CookieStore {
     cookies: Record<string, string>;
     rememberCookiesFromResponseHeaders(headers: Record<string, string[]>): void;
     getCookieRequestHeader(): string;

package/lib/index.d.ts

@@ -18,11 +18,11 @@ export type { SupportedPHPVersion } from './supported-php-versions';
 export { PHP, __private__dont__use } from './php';
 export type { MountHandler, UnmountFunction } from './php';
 export { loadPHPRuntime, getLoadedRuntime } from './load-php-runtime';
-export type * from './emscripten-types';
+export type { Emscripten } from './emscripten-types';
 export type { DataModule, EmscriptenOptions, PHPLoaderModule, PHPRuntime, PHPRuntimeId, RuntimeType, } from './load-php-runtime';
 export type { PHPRequestHandlerConfiguration, RewriteRule, } from './php-request-handler';
 export { PHPRequestHandler, applyRewriteRules } from './php-request-handler';
-export type { FileNotFoundGetActionCallback, FileNotFoundToInternalRedirect, FileNotFoundToResponse, FileNotFoundAction, } from './php-request-handler';
+export type { FileNotFoundGetActionCallback, FileNotFoundToInternalRedirect, FileNotFoundToResponse, FileNotFoundAction, CookieStore, } from './php-request-handler';
 export { rotatePHPRuntime } from './rotate-php-runtime';
 export { writeFiles } from './write-files';
 export type { FileTree } from './write-files';

package/lib/ini.d.ts

@@ -1,4 +1,4 @@
-import { UniversalPHP } from './universal-php';
+import type { UniversalPHP } from './universal-php';
 /**
  * Reads the php.ini file and returns its entries.
  *

package/lib/iterate-files.d.ts

@@ -1,4 +1,4 @@
-import { UniversalPHP } from './universal-php';
+import type { UniversalPHP } from './universal-php';
 export type IteratePhpFilesOptions = {
     /**
      * Should yield paths relative to the root directory?

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

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { IncomingMessage, Server, ServerResponse } from 'http';
+import type { IncomingMessage, Server, ServerResponse } from 'http';
 /**
  * Loads the PHP runtime with the given arguments and data dependencies.
  *
@@ -116,10 +116,10 @@ import { IncomingMessage, Server, ServerResponse } from 'http';
  *
  * @public
  * @param  phpLoaderModule         - The ESM-wrapped Emscripten module. Consult the Dockerfile for the build process.
- * @param  phpModuleArgs           - The Emscripten module arguments, see https://emscripten.org/docs/api_reference/module.html#affecting-execution.
+ * @param  options                 - The Emscripten module arguments, see https://emscripten.org/docs/api_reference/module.html#affecting-execution.
  * @returns Loaded runtime id.
  */
-export declare function loadPHPRuntime(phpLoaderModule: PHPLoaderModule, phpModuleArgs?: EmscriptenOptions): Promise<number>;
+export declare function loadPHPRuntime(phpLoaderModule: PHPLoaderModule, ...options: EmscriptenOptions[]): Promise<number>;
 export type RuntimeType = 'NODE' | 'WEB' | 'WORKER';
 export type PHPRuntimeId = number;
 export declare function getLoadedRuntime(id: PHPRuntimeId): PHPRuntime;
@@ -147,7 +147,7 @@ export type EmscriptenOptions = {
     print?: (message: string) => void;
     printErr?: (message: string) => void;
     quit?: (status: number, toThrow: any) => void;
-    onRuntimeInitialized?: () => void;
+    onRuntimeInitialized?: (phpRuntime: PHPRuntime) => void;
     monitorRunDependencies?: (left: number) => void;
     onMessage?: (listener: EmscriptenMessageListener) => void;
     outboundNetworkProxyServer?: Server<typeof IncomingMessage, typeof ServerResponse>;

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

@@ -1,4 +1,4 @@
-import { PHP } from './php';
+import type { PHP } from './php';
 export type PHPFactoryOptions = {
     isPrimary: boolean;
 };

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

@@ -1,7 +1,8 @@
-import { PHP } from './php';
+import type { PHP } from './php';
 import { PHPResponse } from './php-response';
-import { PHPRequest } from './universal-php';
-import { PHPFactoryOptions, PHPProcessManager } from './php-process-manager';
+import type { PHPRequest } from './universal-php';
+import type { PHPFactoryOptions } from './php-process-manager';
+import { PHPProcessManager } from './php-process-manager';
 export type RewriteRule = {
     match: RegExp;
     replacement: string;
@@ -19,6 +20,22 @@ export type FileNotFoundTo404 = {
 };
 export type FileNotFoundAction = FileNotFoundToResponse | FileNotFoundToInternalRedirect | FileNotFoundTo404;
 export type FileNotFoundGetActionCallback = (relativePath: string) => FileNotFoundAction;
+/**
+ * Interface for cookie storage implementations.
+ * This allows different cookie handling strategies to be used with the PHP request handler.
+ */
+export interface CookieStore {
+    /**
+     * Processes and stores cookies from response headers
+     * @param headers Response headers containing Set-Cookie directives
+     */
+    rememberCookiesFromResponseHeaders(headers: Record<string, string[]>): void;
+    /**
+     * Gets the cookie header string for the next request
+     * @returns Formatted cookie header string
+     */
+    getCookieRequestHeader(): string;
+}
 interface BaseConfiguration {
     /**
      * The directory in the PHP filesystem where the server will look
@@ -62,7 +79,9 @@ export type PHPRequestHandlerConfiguration = BaseConfiguration & ({
      * the same time.
      */
     maxPhpInstances?: number;
-});
+}) & {
+    cookieStore?: CookieStore | false;
+};
 /**
  * Handles HTTP requests using PHP runtime as a backend.
  *

package/lib/php-worker.d.ts

@@ -1,9 +1,9 @@
-import { EmscriptenDownloadMonitor } from '@php-wasm/progress';
-import { PHP } from './php';
-import { PHPRequestHandler } from './php-request-handler';
-import { PHPResponse } from './php-response';
-import { PHPRequest, PHPRunOptions, MessageListener, PHPEvent, PHPEventListener } from './universal-php';
-import { RmDirOptions, ListFilesOptions } from './fs-helpers';
+import type { EmscriptenDownloadMonitor } from '@php-wasm/progress';
+import type { PHP } from './php';
+import type { PHPRequestHandler } from './php-request-handler';
+import type { PHPResponse } from './php-response';
+import type { PHPRequest, PHPRunOptions, MessageListener, PHPEvent, PHPEventListener } from './universal-php';
+import type { RmDirOptions, ListFilesOptions } from './fs-helpers';
 export type LimitedPHPApi = Pick<PHP, 'request' | 'defineConstant' | 'addEventListener' | 'removeEventListener' | 'mkdir' | 'mkdirTree' | 'readFileAsText' | 'readFileAsBuffer' | 'writeFile' | 'unlink' | 'mv' | 'rmdir' | 'listFiles' | 'isDir' | 'fileExists' | 'chdir' | 'run' | 'onMessage'> & {
     documentRoot: PHP['documentRoot'];
     absoluteUrl: PHP['absoluteUrl'];

package/lib/php.d.ts

@@ -1,15 +1,16 @@
 import { PHPResponse } from './php-response';
 import type { PHPRuntimeId } from './load-php-runtime';
-import { MessageListener, PHPRequest, PHPRequestHeaders, PHPRunOptions, SpawnHandler, PHPEventListener, PHPEvent } from './universal-php';
-import { RmDirOptions, ListFilesOptions } from './fs-helpers';
+import type { MessageListener, PHPRequest, PHPRequestHeaders, PHPRunOptions, SpawnHandler, PHPEventListener, PHPEvent } from './universal-php';
+import type { RmDirOptions, ListFilesOptions } from './fs-helpers';
 import { Semaphore } from '@php-wasm/util';
-import { PHPRequestHandler } from './php-request-handler';
-import { Emscripten } from './emscripten-types';
+import type { PHPRequestHandler } from './php-request-handler';
+import type { Emscripten } from './emscripten-types';
 export declare const __private__dont__use: unique symbol;
+type ErrorSource = 'request' | 'php-wasm';
 export declare class PHPExecutionFailureError extends Error {
     response: PHPResponse;
-    source: 'request' | 'php-wasm';
-    constructor(message: string, response: PHPResponse, source: 'request' | 'php-wasm');
+    source: ErrorSource;
+    constructor(message: string, response: PHPResponse, source: ErrorSource);
 }
 export type UnmountFunction = (() => Promise<any>) | (() => any);
 export type MountHandler = (php: PHP, FS: Emscripten.RootFS, vfsMountPoint: string) => UnmountFunction | Promise<UnmountFunction>;
@@ -345,3 +346,4 @@ export declare class PHP implements Disposable {
     [Symbol.dispose](): void;
 }
 export declare function normalizeHeaders(headers: PHPRequestHeaders): PHPRequestHeaders;
+export {};

package/lib/proxy-file-system.d.ts

@@ -1,4 +1,4 @@
-import { PHP } from './php';
+import type { PHP } from './php';
 /**
  * Proxy specific paths to the parent's MEMFS instance.
  * This is useful for sharing the WordPress installation

package/lib/rethrow-file-system-error.d.ts

@@ -15,4 +15,4 @@ export interface ErrnoError extends Error {
  */
 export declare const FileErrorCodes: any;
 export declare function getEmscriptenFsError(e: any): any;
-export declare function rethrowFileSystemError(messagePrefix?: string): (target: any, methodName: string, descriptor: PropertyDescriptor) => void;
+export declare function rethrowFileSystemError(messagePrefix?: string): (value: (...args: any[]) => any) => (...args: any[]) => any;

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

@@ -1,4 +1,4 @@
-import { PHP } from './php';
+import type { PHP } from './php';
 export interface RotateOptions {
     php: PHP;
     cwd: string;

package/lib/stream-read-file-from-php.d.ts

@@ -1,4 +1,4 @@
-import { UniversalPHP } from './universal-php';
+import type { UniversalPHP } from './universal-php';
 /**
  * Reads a file from PHP filesystem using a stream.
  */

package/lib/supported-php-versions.d.ts

@@ -1,4 +1,4 @@
-export declare const SupportedPHPVersions: readonly ["8.4", "8.3", "8.2", "8.1", "8.0", "7.4", "7.3", "7.2", "7.1", "7.0"];
+export declare const SupportedPHPVersions: readonly ["8.4", "8.3", "8.2", "8.1", "8.0", "7.4", "7.3", "7.2"];
 export declare const LatestSupportedPHPVersion: "8.4";
 export declare const SupportedPHPVersionsList: string[];
 export type SupportedPHPVersion = (typeof SupportedPHPVersions)[number];

package/lib/universal-php.d.ts

@@ -1,5 +1,5 @@
-import { Remote } from 'comlink';
-import { LimitedPHPApi } from './php-worker';
+import type { Remote } from 'comlink';
+import type { LimitedPHPApi } from './php-worker';
 /**
  * Represents an event related to the PHP request.
  */

package/lib/write-files-stream-to-php.d.ts

@@ -1,4 +1,4 @@
-import { UniversalPHP } from './universal-php';
+import type { UniversalPHP } from './universal-php';
 /**
  * Writes streamed files to PHP filesystem.
  */

package/lib/write-files.d.ts

@@ -1,4 +1,6 @@
-import { UniversalPHP } from './universal-php';
+import type { UniversalPHP } from './universal-php';
+export interface FileTree extends Record<string, Uint8Array | string | FileTree> {
+}
 export interface WriteFilesOptions {
     /**
      * Whether to wipe out the contents of the
@@ -6,8 +8,6 @@ export interface WriteFilesOptions {
      */
     rmRoot?: boolean;
 }
-export interface FileTree extends Record<string, Uint8Array | string | FileTree> {
-}
 /**
  * Writes multiple files to a specified directory in the Playground
  * filesystem.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "1.0.28",
+  "version": "1.1.0",
   "description": "PHP.wasm – emscripten bindings for PHP",
   "repository": {
     "type": "git",
@@ -37,18 +37,25 @@
   "module": "./index.js",
   "types": "index.d.ts",
   "license": "GPL-2.0-or-later",
-  "gitHead": "ed7171a91717c70dd7162e3d93283f66d21c001d",
+  "gitHead": "9dbbe2b22ccbacda9c0da4444c51d5739e784302",
   "engines": {
-    "node": ">=18.18.0",
-    "npm": ">=8.11.0"
+    "node": ">=20.18.3",
+    "npm": ">=10.1.0"
   },
   "dependencies": {
     "comlink": "^4.4.1",
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "1.0.28",
-    "@php-wasm/logger": "1.0.28",
-    "@php-wasm/util": "1.0.28",
-    "@php-wasm/stream-compression": "1.0.28",
-    "@php-wasm/progress": "1.0.28"
+    "@php-wasm/node-polyfills": "1.1.0",
+    "@php-wasm/logger": "1.1.0",
+    "@php-wasm/util": "1.1.0",
+    "@php-wasm/stream-compression": "1.1.0",
+    "@php-wasm/progress": "1.1.0"
+  },
+  "overrides": {
+    "rollup": "^4.34.6",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.4.5",
+    "ws": "^8.18.0"
   }
-}
+}