@php-wasm/xdebug-bridge 2.0.12 → 2.0.13

package/README.md

@@ -1,6 +1,6 @@
 # @php-wasm/xdebug-bridge
 
-XDebug bridge server for PHP.wasm that enables debugging connections between XDebug and debugging clients.
+A bridge server for XDebug and PHP.wasm that facilitates debugging connections between XDebug and Browser devtools.
 
 ## Installation
 
@@ -18,6 +18,10 @@ import { startBridge } from './xdebug-bridge/src/start-bridge';
 // Start with default settings
 const server = startBridge();
 await server.start();
+```
+
+```typescript
+import { startBridge } from './xdebug-bridge/src/start-bridge';
 
 // Start with custom configuration
 const server = startBridge({
@@ -37,20 +41,29 @@ await server.start();
 npx xdebug-bridge
 
 # Custom port and verbose logging
-npx xdebug-bridge --port 9000 --verbose
+npx xdebug-bridge --port 9000 --verbosity debug
 
 # Show help
 npx xdebug-bridge --help
 ```
 
-## Configuration Options
+## Configuration Options (CLI)
+
+-   `port`: Xdebug port to listen on (default: 9003)
+-   `host`: Xdebug host to bind to (default: 'localhost')
+-   `php-root`: Path to PHP root directory (default: './')
+-   `verbosity`: Output logs and progress messages (choices: "quiet", "normal", "debug") (default: "normal")
+-   `help`: Display help
+
+## Configuration Options (API)
 
 -   `cdpPort`: Port to listen for CDP connections (default: 9229)
 -   `cdpHost`: Host to bind to (default: 'localhost')
 -   `dbgpPort`: Port to listen for XDebug connections (default: 9003)
--   `phpRoot`: Root path for php files;
--   `remoteRoot`: Remote root path for php files;
--   `localRoot`: Local root path for php files;
+-   `phpRoot`: Root path for php files
+-   `verbosity`: Output logs and progress messages (choices: "quiet", "normal", "debug") (default: "normal")
+-   `remoteRoot`: Remote root path for php files
+-   `localRoot`: Local root path for php files
 -   `phpInstance`: PHP instance
 -   `getPHPFile`: Custom file listing function
 
@@ -58,11 +71,15 @@ npx xdebug-bridge --help
 
 The bridge listens to events for monitoring connection activity:
 
+#### From Xdebug
+
 -   `connected`: Xdebug Server has started
 -   `close`: Xdebug Server has stopped
 -   `message`: Raw XDebug data received
 -   `error`: Xdebug Server error occurred
 
+#### To Devtools
+
 -   `clientConnected`: Devtools client connected
 -   `clientDisconnected`: Devtools client disconnected
 -   `message`: Raw Devtools data received

package/cli.cjs

@@ -1 +1 @@
-"use strict";const i=require("./run-cli-BKbM-eYC.cjs");i.main();
+"use strict";const i=require("./run-cli-CioU2BLc.cjs");i.main();

package/cli.js

@@ -1,2 +1,2 @@
-import { m } from "./run-cli-Cs104r6H.js";
+import { m } from "./run-cli-BmBrNemj.js";
 m();

package/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./run-cli-BKbM-eYC.cjs");exports.CDPServer=e.CDPServer;exports.DbgpSession=e.DbgpSession;exports.XdebugCDPBridge=e.XdebugCDPBridge;exports.main=e.main;exports.startBridge=e.startBridge;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./run-cli-CioU2BLc.cjs");exports.CDPServer=e.CDPServer;exports.DbgpSession=e.DbgpSession;exports.XdebugCDPBridge=e.XdebugCDPBridge;exports.main=e.main;exports.startBridge=e.startBridge;

package/index.js

@@ -1,4 +1,4 @@
-import { C as e, D as r, X as g, m as i, s as D } from "./run-cli-Cs104r6H.js";
+import { C as e, D as r, X as g, m as i, s as D } from "./run-cli-BmBrNemj.js";
 export {
   e as CDPServer,
   r as DbgpSession,

package/lib/cdp-server.d.ts

@@ -5,4 +5,5 @@ export declare class CDPServer extends EventEmitter {
     private ws;
     constructor(port?: number);
     sendMessage(message: any): void;
+    close(): void;
 }

package/lib/dbgp-session.d.ts

@@ -8,4 +8,5 @@ export declare class DbgpSession extends EventEmitter {
     constructor(port?: number);
     private onData;
     sendCommand(command: string): void;
+    close(): void;
 }

package/lib/xdebug-cdp-bridge.d.ts

@@ -25,6 +25,7 @@ export declare class XdebugCDPBridge {
     private localRoot;
     constructor(dbgp: DbgpSession, cdp: CDPServer, config: XdebugCDPBridgeConfig);
     start(): void;
+    stop(): void;
     private sendInitialScripts;
     private getOrCreateScriptId;
     private formatPropertyFullName;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@php-wasm/xdebug-bridge",
-  "version": "2.0.12",
+  "version": "2.0.13",
   "description": "XDebug bridge server for PHP.wasm",
   "repository": {
     "type": "git",
@@ -39,17 +39,22 @@
   },
   "license": "GPL-2.0-or-later",
   "types": "index.d.ts",
-  "gitHead": "7a2f0f5dc0171895433af3d24d2ade36cd1d5ace",
+  "gitHead": "c9d2979597806e5f14985a0607c9c61e48d54c9b",
   "engines": {
     "node": ">=20.18.3",
     "npm": ">=10.1.0"
   },
   "dependencies": {
+    "express": "4.21.2",
     "ini": "4.1.2",
+    "wasm-feature-detect": "1.8.0",
     "ws": "8.18.1",
     "xml2js": "0.6.2",
     "yargs": "17.7.2",
-    "@php-wasm/universal": "2.0.12"
+    "@php-wasm/logger": "2.0.13",
+    "@php-wasm/universal": "2.0.13",
+    "@wp-playground/common": "2.0.13",
+    "@php-wasm/node": "2.0.13"
   },
   "overrides": {
     "rollup": "^4.34.6",