@php-wasm/universal 1.2.2 → 2.0.0

package/lib/error-reporting.d.ts

@@ -0,0 +1,12 @@
+import type { StreamedPHPResponse } from './php-response';
+import { PHPResponse } from './php-response';
+export declare function printDebugDetails(e: any, streamedResponse?: StreamedPHPResponse): Promise<void>;
+/**
+ * Pretty prints the full stack trace of the error and all its causes.
+ * Includes debug details for each error in the chain.
+ * This is needed
+ *
+ * @param e
+ */
+export declare function prettyPrintFullStackTrace(e: any): Promise<void>;
+export declare function printResponseDebugDetails(response: PHPResponse): void;

package/lib/index.d.ts

@@ -3,6 +3,7 @@ export { FSHelpers } from './fs-helpers';
 export type { ListFilesOptions, RmDirOptions } from './fs-helpers';
 export { PHPWorker } from './php-worker';
 export { getPhpIniEntries, setPhpIniEntries, withPHPIniValues } from './ini';
+export { printDebugDetails, prettyPrintFullStackTrace, printResponseDebugDetails, } from './error-reporting';
 export { UnhandledRejectionsTarget } from './wasm-error-reporting';
 export { HttpCookieStore } from './http-cookie-store';
 export type { IteratePhpFilesOptions as IterateFilesOptions } from './iterate-files';
@@ -29,5 +30,6 @@ 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 { sandboxedSpawnHandlerFactory } from './sandboxed-spawn-handler-factory';
 export * from './api';
 export type { WithAPIState as WithIsReady } from './api';

package/lib/php-worker.d.ts

@@ -27,6 +27,14 @@ export declare class PHPWorker implements LimitedPHPApi, AsyncDisposable {
      * a warning.
      */
     protected __internal_getPHP(): PHP | undefined;
+    /**
+     * @internal
+     * @deprecated
+     * Do not use this method directly in the code consuming
+     * the web API. It will change or even be removed without
+     * a warning.
+     */
+    protected __internal_getRequestHandler(): PHPRequestHandler | undefined;
     setPrimaryPHP(php: PHP): Promise<void>;
     /** @inheritDoc @php-wasm/universal!PHPRequestHandler.pathToInternalUrl  */
     pathToInternalUrl(path: string): string;

package/lib/php.d.ts

@@ -15,6 +15,7 @@ export declare class PHPExecutionFailureError extends Error {
 export type UnmountFunction = (() => Promise<any>) | (() => any);
 export type MountHandler = (php: PHP, FS: Emscripten.RootFS, vfsMountPoint: string) => UnmountFunction | Promise<UnmountFunction>;
 export declare const PHP_INI_PATH = "/internal/shared/php.ini";
+export declare const USE_OPCACHE = true;
 /**
  * An environment-agnostic wrapper around the Emscripten PHP runtime
  * that universals the super low-level API and provides a more convenient
@@ -27,6 +28,8 @@ export declare class PHP implements Disposable {
     #private;
     protected [__private__dont__use]: any;
     requestHandler?: PHPRequestHandler;
+    private cliCalled;
+    private runStreamCalled;
     /**
      * An exclusive lock that prevent multiple requests from running at
      * the same time.
@@ -114,6 +117,12 @@ export declare class PHP implements Disposable {
      * @param  path - The new working directory.
      */
     chdir(path: string): void;
+    /**
+     * Changes the permissions of a file or directory.
+     * @param path - The path to the file or directory.
+     * @param mode - The new permissions.
+     */
+    chmod(path: string, mode: number): void;
     /**
      * Do not use. Use new PHPRequestHandler() instead.
      * @deprecated

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

@@ -5,10 +5,10 @@
  * @see https://github.com/emscripten-core/emscripten/blob/main/system/lib/libc/musl/arch/emscripten/bits/errno.h
  * @see https://github.com/emscripten-core/emscripten/blob/38eedc630f17094b3202fd48ac0c2c585dbea31e/system/include/wasi/api.h#L336
  */
-export interface ErrnoError extends Error {
+export declare class ErrnoError extends Error {
+    constructor(errno: number, message?: string, options?: any);
     node?: any;
     errno: number;
-    message: string;
 }
 /**
  * @see https://github.com/emscripten-core/emscripten/blob/38eedc630f17094b3202fd48ac0c2c585dbea31e/system/include/wasi/api.h#L336

package/lib/sandboxed-spawn-handler-factory.d.ts

@@ -0,0 +1,12 @@
+import type { PHPProcessManager } from './php-process-manager';
+/**
+ * An isomorphic proc_open() handler that implements typical shell in TypeScript
+ * without relying on a server runtime. It can be used in the browser and Node.js
+ * alike whenever you need to spawn a PHP subprocess, query the terminal size, etc.
+ * It is open for future expansion if more shell or busybox calls are needed, but
+ * advanced shell features such as piping, stream redirection etc. are outside of
+ * the scope of this minimal handler. If they become vital at any point, let's
+ * explore bringing in an actual shell implementation or at least a proper command
+ * parser.
+ */
+export declare function sandboxedSpawnHandlerFactory(processManager: PHPProcessManager): any;

package/lib/serialize-error.d.ts

@@ -0,0 +1,17 @@
+export type ErrorObject = {
+    name?: string;
+    message?: string;
+    stack?: string;
+    cause?: unknown;
+    code?: string;
+} & Record<string, unknown>;
+export declare const errorConstructors: Map<unknown, unknown>;
+export declare function addKnownErrorConstructor(constructor: any): void;
+export declare class NonError extends Error {
+    name: string;
+    constructor(message: any);
+    static _prepareSuperMessage(message: any): string;
+}
+export declare function serializeError(value: any, options?: any): any;
+export declare function deserializeError(value: any, options?: any): any;
+export declare function isErrorLike(value: any): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/universal",
-  "version": "1.2.2",
+  "version": "2.0.0",
   "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": "aca5a878610532b47b07a5922fb6056993df0642",
+  "gitHead": "4aa6ec4f0fe23920f735c0050228a509d94ce077",
   "engines": {
     "node": ">=20.18.3",
     "npm": ">=10.1.0"
   },
   "dependencies": {
     "ini": "4.1.2",
-    "@php-wasm/node-polyfills": "1.2.2",
-    "@php-wasm/logger": "1.2.2",
-    "@php-wasm/util": "1.2.2",
-    "@php-wasm/stream-compression": "1.2.2",
-    "@php-wasm/progress": "1.2.2"
+    "@php-wasm/node-polyfills": "2.0.0",
+    "@php-wasm/logger": "2.0.0",
+    "@php-wasm/util": "2.0.0",
+    "@php-wasm/stream-compression": "2.0.0",
+    "@php-wasm/progress": "2.0.0"
   },
   "overrides": {
     "rollup": "^4.34.6",

package/__vite-browser-external-Dyvby5gX.cjs

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=__vite-browser-external-Dyvby5gX.cjs.map

package/__vite-browser-external-Dyvby5gX.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"__vite-browser-external-Dyvby5gX.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/__vite-browser-external-l0sNRNKZ.js

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=__vite-browser-external-l0sNRNKZ.js.map

package/__vite-browser-external-l0sNRNKZ.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__vite-browser-external-l0sNRNKZ.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}