@matter/nodejs 0.16.0-alpha.0-20251006-3fe1e7c57 → 0.16.0-alpha.0-20251013-89bb7099d

package/dist/esm/net/NodeJsUdpChannel.js

@@ -4,10 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import {
+  AddressInUseError,
+  BindError,
   Bytes,
   ChannelType,
   createPromise,
   Diagnostic,
+  ImplementationError,
   isIPv4,
   isIPv6,
   Logger,
@@ -31,7 +34,20 @@ function createDgramSocket(host, port, options) {
       try {
         socket.close();
       } catch (error2) {
-        logger.debug("Error closing socket", error2);
+        logger.debug("Error closing socket:", error2);
+      }
+      const code = error?.code;
+      let desc = `${host ? host : options.type === "udp4" ? "0.0.0.0" : "{::}"}`;
+      if (port !== void 0) {
+        desc = `${desc}:${port}`;
+      }
+      switch (code) {
+        case "EADDRINUSE":
+          error = new AddressInUseError(`Cannot bind ${desc} because port is already in use`);
+          break;
+        default:
+          error = new BindError(`Cannot bind to ${desc} (code ${code})`);
+          break;
       }
       reject(error);
     };
@@ -55,11 +71,26 @@ class NodeJsUdpChannel {
   #type;
   #socket;
   #netInterface;
-  static async create({ listeningPort, type, listeningAddress, netInterface }) {
-    const socketOptions = { type, reuseAddr: true };
+  static async create({ listeningPort, type, listeningAddress, netInterface, reuseAddress }) {
+    let dgramType;
+    switch (type) {
+      case "udp":
+      case "udp6":
+        dgramType = "udp6";
+        break;
+      case "udp4":
+        dgramType = "udp4";
+        break;
+      default:
+        throw new ImplementationError(`Unrecognized UDP socket type ${type}`);
+    }
+    const socketOptions = { type: dgramType };
     if (type === "udp6") {
       socketOptions.ipv6Only = true;
     }
+    if (reuseAddress) {
+      socketOptions.reuseAddr = true;
+    }
     const socket = await createDgramSocket(listeningAddress, listeningPort, socketOptions);
     socket.setBroadcast(true);
     let netInterfaceZone;

package/dist/esm/net/NodeJsUdpChannel.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/NodeJsUdpChannel.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["error"]
 }

package/dist/esm/net/WsAdapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpEndpoint } from "#general";
+import { IncomingMessage } from "node:http";
+import { Duplex } from "node:stream";
+/**
+ * This is a pluggable component that handles the upgrade to a WsConnection.
+ *
+ * We do not implement directly here because Node.js does not support WebSocket servers natively, so we must use a
+ * third-party dependency.
+ */
+export interface WsAdapter {
+    handle(req: IncomingMessage, socket: Duplex, head: Buffer): Promise<HttpEndpoint.WsConnection>;
+    close(): Promise<void>;
+}
+export declare namespace WsAdapter {
+    let defaultFactory: undefined | Factory;
+    interface Factory {
+        (): WsAdapter;
+    }
+}
+//# sourceMappingURL=WsAdapter.d.ts.map

package/dist/esm/net/WsAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsAdapter.d.ts","sourceRoot":"","sources":["../../../src/net/WsAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAC/F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,yBAAiB,SAAS,CAAC;IAEhB,IAAI,cAAc,EAAgB,SAAS,GAAG,OAAO,CAAC;IAE7D,UAAiB,OAAO;QACpB,IAAI,SAAS,CAAC;KACjB;CACJ"}

package/dist/esm/net/WsAdapter.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var WsAdapter;
+((WsAdapter2) => {
+  WsAdapter2.defaultFactory = void 0;
+})(WsAdapter || (WsAdapter = {}));
+export {
+  WsAdapter
+};
+//# sourceMappingURL=WsAdapter.js.map

package/dist/esm/net/WsAdapter.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/net/WsAdapter.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,IAAU;AAAA,CAAV,CAAUA,eAAV;AAEI,EAAIA,WAAA,iBAAiB;AAAA,GAFf;",
+  "names": ["WsAdapter"]
+}

package/dist/esm/net/index.d.ts

@@ -3,6 +3,8 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+export * from "./NodeJsHttpEndpoint.js";
 export * from "./NodeJsNetwork.js";
 export * from "./NodeJsUdpChannel.js";
+export * from "./WsAdapter.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/net/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}

package/dist/esm/net/index.js

@@ -3,6 +3,8 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+export * from "./NodeJsHttpEndpoint.js";
 export * from "./NodeJsNetwork.js";
 export * from "./NodeJsUdpChannel.js";
+export * from "./WsAdapter.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/net/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/index.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/nodejs",
-    "version": "0.16.0-alpha.0-20251006-3fe1e7c57",
+    "version": "0.16.0-alpha.0-20251013-89bb7099d",
     "description": "Node.js platform support for matter.js",
     "keywords": [
         "iot",
@@ -44,17 +44,17 @@
         "#*": "./src/*"
     },
     "dependencies": {
-        "@matter/general": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/node": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/protocol": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/types": "0.16.0-alpha.0-20251006-3fe1e7c57"
+        "@matter/general": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/node": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/protocol": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/types": "0.16.0-alpha.0-20251013-89bb7099d"
     },
     "devDependencies": {
-        "@matter/model": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/protocol": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/tools": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/testing": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@project-chip/matter.js": "0.16.0-alpha.0-20251006-3fe1e7c57",
+        "@matter/model": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/protocol": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/testing": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/tools": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@project-chip/matter.js": "0.16.0-alpha.0-20251013-89bb7099d",
         "@types/bytebuffer": "^5.0.49"
     },
     "files": [

package/src/config.ts

@@ -164,7 +164,7 @@ export const config = {
     },
 
     /**
-     * Enables handling of SIGINT, SIGTERM and SIGUSR2 (depending on platform; default: true).
+     * Enables handling of SIGINT, SIGTERM, SIGUSR2 and SIGABRT (depending on platform; default: true).
      */
     get trapProcessSignals() {
         return trapProcessSignals;

package/src/environment/NodeJsEnvironment.ts

@@ -11,6 +11,7 @@ import {
     Boot,
     Crypto,
     Environment,
+    HttpEndpointFactory,
     ImplementationError,
     LogFormat,
     Logger,
@@ -19,6 +20,7 @@ import {
     StorageService,
     VariableService,
 } from "#general";
+import { NodeJsHttpEndpoint } from "#net/NodeJsHttpEndpoint.js";
 import { existsSync, readFileSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -65,6 +67,8 @@ import { ProcessManager } from "./ProcessManager.js";
  * * `runtime.signals` - By default register SIGINT and SIGUSR2 (diag) handlers, set to false if not wanted
  * * `runtime.exitcode` - By default we set the process.exitcode to 0 (ok) or 1 (crash); set to false to disable
  * * `runtime.unhandlederrors` - By default we log unhandled errors to matter.js log; set to false to disable
+ *
+ * TODO - this should go away.  Node.js services should register with {@link ServiceBundle.default}
  */
 export function NodeJsEnvironment() {
     const env = new Environment("default");
@@ -127,6 +131,11 @@ function loadVariables(env: Environment) {
     };
 }
 
+function rootDirOf(env: Environment) {
+    // path.root should always be set when this is called so the "." fallback should not be used
+    return env.vars.get("path.root", ".");
+}
+
 function configureCrypto(env: Environment) {
     Boot.init(() => {
         if (config.installCrypto || (env.vars.boolean("nodejs.crypto") ?? true)) {
@@ -144,9 +153,16 @@ function configureNetwork(env: Environment) {
 
     Boot.init(() => {
         if (config.installNetwork || (env.vars.boolean("nodejs.network") ?? true)) {
+            const basePathForUnixSockets = rootDirOf(env);
             env.set(Network, new NodeJsNetwork());
-        } else if (Environment.default.has(Network)) {
-            env.set(Network, Environment.default.get(Network));
+            env.set(HttpEndpointFactory, new NodeJsHttpEndpoint.Factory(basePathForUnixSockets));
+        } else {
+            if (Environment.default.has(Network)) {
+                env.set(Network, Environment.default.get(Network));
+            }
+            if (Environment.default.has(HttpEndpointFactory)) {
+                env.set(HttpEndpointFactory, Environment.default.get(HttpEndpointFactory));
+            }
         }
     });
 }
@@ -164,11 +180,13 @@ function configureStorage(env: Environment) {
     const service = env.get(StorageService);
 
     env.vars.use(() => {
-        service.location = env.vars.get("storage.path", env.vars.get("path.root", "."));
+        service.location = env.vars.get("storage.path", rootDirOf(env));
     });
 
     service.factory = namespace =>
         new StorageBackendDisk(resolve(service.location ?? ".", namespace), env.vars.get("storage.clear", false));
+
+    service.resolve = (...paths) => resolve(rootDirOf(env), ...paths);
 }
 
 export function loadConfigFile(vars: VariableService) {

package/src/environment/ProcessManager.ts

@@ -110,6 +110,16 @@ export class ProcessManager implements Destructable {
         this.runtime.interrupt();
     };
 
+    protected abortHandler = () => {
+        this.uninstallInterruptHandlers();
+
+        logger.fatal("Terminating due to SIGABRT of JS runtime, diagnostics follow");
+        logger.info(JSON.stringify(process.report.getReport(), undefined, 2));
+
+        // Arbitrary code that kind of looks like standard SIGABRT exit code of -6
+        process.exit(-66);
+    };
+
     protected exitHandler = () => {
         if (process.exitCode === 13) {
             logger.error("Internal error: Premature process exit because ongoing work has stalled");
@@ -123,11 +133,13 @@ export class ProcessManager implements Destructable {
     protected installInterruptHandlers = () => {
         process.on("SIGINT", this.interruptHandler);
         process.on("SIGTERM", this.interruptHandler);
+        process.on("SIGABRT", this.abortHandler);
     };
 
     protected uninstallInterruptHandlers = () => {
         process.off("SIGINT", this.interruptHandler);
         process.off("SIGTERM", this.interruptHandler);
+        process.off("SIGABRT", this.abortHandler);
     };
 
     #ignoreSignals() {

package/src/net/NodeJsHttpEndpoint.ts

@@ -0,0 +1,358 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { AppAddress, asError, HttpEndpoint, HttpEndpointFactory, Logger, NetworkError } from "#general";
+import { existsSync, ReadStream, rmSync, statSync } from "node:fs";
+import { createServer, IncomingMessage, Server, ServerResponse } from "node:http";
+import { ListenOptions } from "node:net";
+import { normalize, resolve } from "node:path";
+import { Duplex } from "node:stream";
+
+// Node's ReadableStream type definition do not exactly match the standard version so we need to import to support casts
+import type { ReadableStream as NodeReadableStream } from "node:stream/web";
+import { WsAdapter } from "./WsAdapter.js";
+
+const logger = new Logger("NodeJsHttpEndpoint");
+
+/**
+ * An implementation of {@link HttpEndpoint} that uses Node.js's standard {@link Server}.
+ *
+ * WebSocket support is optional.  You can install by importing `@matter/nodejs-ws`.
+ *
+ * This implementation is a little ugly because the native Node.js HTTP server API is pre-async and has some design
+ * flaws.  Other runtimes tend build on WinterTC standards and adapters will be much simpler.
+ */
+export class NodeJsHttpEndpoint implements HttpEndpoint {
+    #server: Server;
+    #ready: Promise<void>;
+    #http?: HttpEndpoint.HttpHandler;
+    #httpListener?: (req: IncomingMessage, res: ServerResponse) => void;
+    #ws?: HttpEndpoint.WsHandler;
+    #wsListener?: (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
+    #notFound: (res: ServerResponse) => void;
+
+    #wsAdapter?: WsAdapter;
+    #wsAdapterFactory?: WsAdapter.Factory;
+
+    static async create(options: NodeJsHttpEndpoint.Options): Promise<NodeJsHttpEndpoint> {
+        const endpoint = new NodeJsHttpEndpoint(options);
+        await endpoint.ready;
+        return endpoint;
+    }
+
+    /**
+     * Create a new endpoint.
+     *
+     * You may pass an existing {@link Server} or pass {@link NodeJsHttpEndpoint.Options} to create a server dedicated
+     * to this endpoint.
+     */
+    constructor(optionsOrServer: Server | NodeJsHttpEndpoint.Options) {
+        let close, ready, server, notFound;
+
+        if ("on" in optionsOrServer) {
+            ({ close, ready, server, notFound } = this.#bindToServer(optionsOrServer));
+        } else {
+            ({ close, ready, server, notFound } = this.#createDedicatedServer(optionsOrServer));
+        }
+
+        this.#server = server;
+        this.#ready = ready;
+        this.close = close;
+        this.#notFound = notFound;
+    }
+
+    get server() {
+        return this.#server;
+    }
+
+    #bindToServer(server: Server) {
+        return {
+            server,
+            ready: Promise.resolve(),
+            close: async () => {
+                this.http = undefined;
+                this.ws = undefined;
+            },
+            notFound: () => undefined,
+        };
+    }
+
+    #createDedicatedServer(options: NodeJsHttpEndpoint.Options) {
+        const server = createServer({ keepAlive: true });
+
+        const opts = {} as ListenOptions;
+
+        const address = AppAddress.for(options.address);
+        const { transport } = address;
+        switch (transport.kind) {
+            case "ip":
+                if (!address.isWildcardHost) {
+                    opts.host = address.host;
+                }
+                if (!address.isWildcardPort) {
+                    opts.port = address.portNum;
+                }
+                break;
+
+            case "unix":
+                const path = decodeURIComponent(address.hostname);
+                if (options.basePathForUnixSockets) {
+                    opts.path = resolve(options.basePathForUnixSockets, normalize(path));
+                } else {
+                    opts.path = normalize(path);
+                }
+                if (existsSync(opts.path)) {
+                    if (statSync(opts.path).isSocket()) {
+                        try {
+                            rmSync(opts.path);
+                        } catch (e) {
+                            throw new NetworkError(
+                                `Error deleting previous socket at ${opts.path}: ${asError(e).message}`,
+                            );
+                        }
+                    } else {
+                        throw new NetworkError(`UNIX socket path ${opts.path} exists and is not a socket`);
+                    }
+                }
+                break;
+
+            default:
+                throw new NetworkError(
+                    `Unsupported address type "${(options.address as any)?.type}" for HTTP endpoint`,
+                );
+        }
+
+        server.listen(opts);
+
+        return {
+            server,
+
+            ready: new Promise<void>((resolve, reject) => {
+                let settled = false;
+                server.once("listening", () => {
+                    if (settled) {
+                        return;
+                    }
+
+                    settled = true;
+                    resolve();
+                });
+                server.on("error", error => {
+                    if (settled) {
+                        logger.warn("HTTP server error:", error.message);
+                        return;
+                    }
+
+                    settled = true;
+                    reject(error);
+                });
+            }),
+
+            close: async () => {
+                return new Promise<void>((resolve, reject) => {
+                    server.close(err => {
+                        if (err) {
+                            reject(err);
+                            return;
+                        }
+
+                        resolve();
+                    });
+                });
+            },
+
+            notFound: (res: ServerResponse) => respondError(res, 404),
+        };
+    }
+
+    get ready() {
+        return this.#ready;
+    }
+
+    set http(handler: HttpEndpoint.HttpHandler | undefined) {
+        this.#http = handler;
+
+        if (!this.#http) {
+            if (this.#httpListener) {
+                this.#server.off("request", this.#httpListener);
+            }
+            return;
+        }
+
+        if (this.#httpListener) {
+            return;
+        }
+
+        this.#httpListener = (req, res) => {
+            this.#handleHttp(req, res).catch(error => {
+                logger.error("Unhandled error in HTTP endpoint handler", error);
+                respondError(res, 500);
+            });
+        };
+
+        this.#server.on("request", this.#httpListener);
+    }
+
+    set ws(handler: HttpEndpoint.WsHandler | undefined) {
+        this.#ws = handler;
+
+        if (!this.#ws) {
+            if (this.#wsListener) {
+                this.#server.off("upgrade", this.#wsListener);
+            }
+            return;
+        }
+
+        let adapter = this.#wsAdapter;
+        if (!adapter) {
+            const factory = this.#wsAdapterFactory ?? WsAdapter.defaultFactory;
+            if (!factory) {
+                logger.warn(
+                    "WebSocket support disabled because no adapter is installed; please import @matter/nodejs-ws or equivalent",
+                );
+                return;
+            }
+            adapter = this.#wsAdapter = factory();
+        }
+
+        this.#wsListener = (req, socket, head) => {
+            this.#handleUpgrade(adapter, req, socket, head).catch(error => {
+                logger.error("Unhandled error WebSocket endpoint", error);
+            });
+        };
+
+        this.#server.on("upgrade", this.#wsListener);
+    }
+
+    close: () => Promise<void>;
+
+    async #handleHttp(req: IncomingMessage, res: ServerResponse) {
+        if (!this.#http) {
+            return;
+        }
+
+        const request = new NodeJsHttpRequest(req);
+
+        const response = await this.#http(request);
+        if (!response) {
+            this.#notFound(res);
+            return;
+        }
+
+        res.statusCode = response.status;
+        res.statusMessage = response.statusText;
+
+        response.headers.forEach(([name, value]) => res.appendHeader(name, value));
+
+        if (response.body === null) {
+            res.end();
+            return;
+        }
+
+        const nodeBodyStream = ReadStream.fromWeb(response.body as NodeReadableStream);
+
+        nodeBodyStream.on("error", error => {
+            logger.error("Error transmitting HTTP body", error);
+            respondError(res, 500);
+        });
+
+        nodeBodyStream.pipe(res);
+    }
+
+    async #handleUpgrade(adapter: WsAdapter, req: IncomingMessage, socket: Duplex, head: Buffer) {
+        if (req.headers.upgrade !== "websocket") {
+            // Not clear how to send a 426 with Node's API
+            socket.destroy();
+            return;
+        }
+
+        // This shouldn't happen
+        if (!this.#ws) {
+            socket.destroy();
+            return;
+        }
+
+        const request = new NodeJsHttpRequest(req);
+
+        try {
+            await this.#ws(request, async () => {
+                return adapter.handle(req, socket, head);
+            });
+        } finally {
+            // Node API is fairly broken and offers no way to indicate we've skipped the socket so we must destroy it
+            // if not already handled
+            if (!socket.destroyed) {
+                socket.destroy();
+            }
+        }
+    }
+}
+
+class NodeJsHttpRequest extends Request {
+    constructor(message: IncomingMessage) {
+        const { method, rawHeaders } = message;
+
+        const url = `http://${message.headers.host ?? "unknown"}${message.url ?? "/"}`;
+
+        const headers = new Headers();
+
+        for (let i = 0; i < message.rawHeaders.length; i += 2) {
+            headers.append(rawHeaders[i], rawHeaders[i + 1]);
+        }
+
+        const init = {
+            method,
+            headers,
+            duplex: "half", // Not in RequestInit type but required by node
+        } as RequestInit;
+
+        if (method !== "GET" && method !== "HEAD") {
+            init.body = IncomingMessage.toWeb(message) as ReadableStream;
+        }
+
+        super(url, init);
+    }
+}
+
+function respondError(res: ServerResponse, code: number) {
+    if (res.closed) {
+        return;
+    }
+
+    try {
+        if (!res.headersSent) {
+            res.statusCode = code;
+            res.setHeader("Content-Type", "text/plain");
+            res.end(`HTTP error ${code}\n`);
+        } else {
+            res.end();
+        }
+    } catch (e) {
+        logger.warn(`Error conveying ${code} error:`, asError(e).message);
+    }
+}
+
+export namespace NodeJsHttpEndpoint {
+    export interface Options extends HttpEndpoint.Options {
+        basePathForUnixSockets?: string;
+    }
+
+    export class Factory extends HttpEndpointFactory {
+        #basePathForUnixSockets?: string;
+
+        constructor(basePathForUnixSockets?: string) {
+            super();
+            this.#basePathForUnixSockets = basePathForUnixSockets;
+        }
+
+        async create(options: HttpEndpoint.Options) {
+            return NodeJsHttpEndpoint.create({
+                basePathForUnixSockets: this.#basePathForUnixSockets,
+                ...options,
+            });
+        }
+    }
+}