@litert/televoke 1.0.3 → 1.2.0

package/lib/transporters/websocket/WebSocket.Client.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,13 +15,24 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWssConnector = exports.createWsConnector = void 0;
+exports.createWsConnector = createWsConnector;
+exports.createWssConnector = createWssConnector;
 const LibWS = require("@litert/websocket");
 const dWS = require("./WebSocket.decl");
 const WebSocket_Transporter_1 = require("./WebSocket.Transporter");
 class WsConnector {
     constructor(_opts) {
+        var _a;
         this._opts = _opts;
+        (_a = this._opts).headers ?? (_a.headers = {});
+    }
+    setHeaders(newHeaders, append = true) {
+        if (append) {
+            Object.assign(this._opts.headers, newHeaders);
+        }
+        else {
+            this._opts.headers = newHeaders;
+        }
     }
     async connect() {
         const ws = await LibWS.wsConnect({
@@ -39,7 +50,17 @@ class WsConnector {
 }
 class WssConnector {
     constructor(_opts) {
+        var _a;
         this._opts = _opts;
+        (_a = this._opts).headers ?? (_a.headers = {});
+    }
+    setHeaders(newHeaders, append = true) {
+        if (append) {
+            Object.assign(this._opts.headers, newHeaders);
+        }
+        else {
+            this._opts.headers = newHeaders;
+        }
     }
     async connect() {
         const ws = await LibWS.wssConnect({
@@ -59,10 +80,8 @@ function createWsConnector(opts) {
     opts.frameReceiveMode = LibWS.EFrameReceiveMode.LITE;
     return new WsConnector(opts);
 }
-exports.createWsConnector = createWsConnector;
 function createWssConnector(opts) {
     opts.frameReceiveMode = LibWS.EFrameReceiveMode.LITE;
     return new WssConnector(opts);
 }
-exports.createWssConnector = createWssConnector;
 //# sourceMappingURL=WebSocket.Client.js.map

package/lib/transporters/websocket/WebSocket.Client.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocket.Client.js","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,2CAA2C;AAC3C,wCAAwC;AAExC,mEAA+D;AAE/D,MAAM,WAAW;IAEb,YAAoC,KAA8B;QAA9B,UAAK,GAAL,KAAK,CAAyB;IAAG,CAAC;IAE/D,KAAK,CAAC,OAAO;QAEhB,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC;YAC7B,GAAG,IAAI,CAAC,KAAK;YACb,OAAO,EAAE;gBACL,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO;gBACtB,GAAG,KAAK,CAAC,4BAA4B,CAAC;oBAClC,cAAc,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;iBAC/C,CAAC;aACL;SACJ,CAAC,CAAC;QAEH,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,IAAI,4CAAoB,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;CACJ;AAED,MAAM,YAAY;IAEd,YAAoC,KAA+B;QAA/B,UAAK,GAAL,KAAK,CAA0B;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAO;QAEhB,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;YAC9B,GAAG,IAAI,CAAC,KAAK;YACb,OAAO,EAAE;gBACL,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO;gBACtB,GAAG,KAAK,CAAC,4BAA4B,CAAC;oBAClC,cAAc,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;iBAC/C,CAAC;aACL;SACJ,CAAC,CAAC;QAEH,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,IAAI,4CAAoB,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;CACJ;AAED,SAAgB,iBAAiB,CAAC,IAA6B;IAE3D,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACrD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAJD,8CAIC;AAED,SAAgB,kBAAkB,CAAC,IAA8B;IAE7D,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACrD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAJD,gDAIC"}
+{"version":3,"file":"WebSocket.Client.js","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAgGH,8CAIC;AAED,gDAIC;AAxGD,2CAA2C;AAE3C,wCAAwC;AAExC,mEAA+D;AAE/D,MAAM,WAAW;IAEb,YAAoC,KAA8B;;QAA9B,UAAK,GAAL,KAAK,CAAyB;QAC9D,MAAA,IAAI,CAAC,KAAK,EAAC,OAAO,QAAP,OAAO,GAAK,EAAE,EAAC;IAC9B,CAAC;IAEM,UAAU,CAAC,UAAwC,EAAE,SAAkB,IAAI;QAE9E,IAAI,MAAM,EAAE,CAAC;YAET,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAQ,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;aACI,CAAC;YAEF,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC;QACpC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,OAAO;QAEhB,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC;YAC7B,GAAG,IAAI,CAAC,KAAK;YACb,OAAO,EAAE;gBACL,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO;gBACtB,GAAG,KAAK,CAAC,4BAA4B,CAAC;oBAClC,cAAc,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;iBAC/C,CAAC;aACL;SACJ,CAAC,CAAC;QAEH,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,IAAI,4CAAoB,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;CACJ;AAED,MAAM,YAAY;IAEd,YAAoC,KAA+B;;QAA/B,UAAK,GAAL,KAAK,CAA0B;QAC/D,MAAA,IAAI,CAAC,KAAK,EAAC,OAAO,QAAP,OAAO,GAAK,EAAE,EAAC;IAC9B,CAAC;IAEM,UAAU,CAAC,UAAwC,EAAE,SAAkB,IAAI;QAE9E,IAAI,MAAM,EAAE,CAAC;YAET,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAQ,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;aACI,CAAC;YAEF,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC;QACpC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,OAAO;QAEhB,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;YAC9B,GAAG,IAAI,CAAC,KAAK;YACb,OAAO,EAAE;gBACL,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO;gBACtB,GAAG,KAAK,CAAC,4BAA4B,CAAC;oBAClC,cAAc,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;iBAC/C,CAAC;aACL;SACJ,CAAC,CAAC;QAEH,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAErB,OAAO,IAAI,4CAAoB,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;CACJ;AAkBD,SAAgB,iBAAiB,CAAC,IAA6B;IAE3D,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACrD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAA8B;IAE7D,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACrD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/lib/transporters/websocket/WebSocket.Server.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,8 +13,18 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type * as NodeHttp from 'node:http';
 import type * as Listener from '../http-listener';
 import type * as dT from '../Transporter.decl';
+export interface IRegisterListenerOptions {
+    onErrorCallback: (e: Error) => void;
+    onUpgradeCallback: (req: NodeHttp.IncomingMessage, socket: NodeJS.Socket, head: Buffer) => void;
+}
+export interface IRegisterListenerResult {
+    stop?: () => void | Promise<void>;
+    start?: () => void | Promise<void>;
+    readonly running: boolean;
+}
 export interface IWebSocketGatewayOptions {
     /**
      * The timeout of WebSocket connections.
@@ -26,10 +36,22 @@ export interface IWebSocketGatewayOptions {
     timeout?: number;
 }
 /**
- * Create a WebSocket gateway.
+ * Create a WebSocket gateway, binding to a simple built-in HTTP(S) listener.
+ *
+ * > When using built-in HTTP server, the api will ignore other headers, path and query string in the URL.
  *
  * @param listener      The HTTP(S) listener object.
  * @param server        The televoke server object.
  */
 export declare function createWebsocketGateway(listener: Listener.IHttpListener, server: dT.IServer, options?: IWebSocketGatewayOptions): dT.IGateway;
+/**
+ * Create a WebSocket gateway, binding to a custom HTTP server.
+ *
+ * > When using a custom HTTP server, it's able to preprocess the request before passing to the server, like
+ * > authentication, rate limiting, custom routing, etc.
+ *
+ * @param registerListener  The function to register the listener to the custom HTTP server.
+ * @param server            The server to process the requests.
+ */
+export declare function createCustomWebsocketGateway(registerListener: (opts: IRegisterListenerOptions) => IRegisterListenerResult, server: dT.IServer): dT.IGateway;
 //# sourceMappingURL=WebSocket.Server.d.ts.map

package/lib/transporters/websocket/WebSocket.Server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocket.Server.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAwF/C,MAAM,WAAW,wBAAwB;IAErC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,QAAQ,CAAC,aAAa,EAChC,MAAM,EAAE,EAAE,CAAC,OAAO,EAClB,OAAO,GAAE,wBAA6B,GACvC,EAAE,CAAC,QAAQ,CAGb"}
+{"version":3,"file":"WebSocket.Server.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,KAAK,QAAQ,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAI/C,MAAM,WAAW,wBAAwB;IAErC,eAAe,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAEpC,iBAAiB,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnG;AAED,MAAM,WAAW,uBAAuB;IAEpC,IAAI,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B;AAyFD,MAAM,WAAW,wBAAwB;IAErC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,QAAQ,CAAC,aAAa,EAChC,MAAM,EAAE,EAAE,CAAC,OAAO,EAClB,OAAO,GAAE,wBAA6B,GACvC,EAAE,CAAC,QAAQ,CAUb;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CACxC,gBAAgB,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,uBAAuB,EAC7E,MAAM,EAAE,EAAE,CAAC,OAAO,GACnB,EAAE,CAAC,QAAQ,CAGb"}

package/lib/transporters/websocket/WebSocket.Server.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,15 +15,15 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWebsocketGateway = void 0;
+exports.createWebsocketGateway = createWebsocketGateway;
+exports.createCustomWebsocketGateway = createCustomWebsocketGateway;
 const LibWS = require("@litert/websocket");
 const dWS = require("./WebSocket.decl");
 const node_events_1 = require("node:events");
 const WebSocket_Transporter_1 = require("./WebSocket.Transporter");
 class WebSocketGateway extends node_events_1.EventEmitter {
-    constructor(_listener, _server, timeout) {
+    constructor(registerListener, _server, timeout) {
         super();
-        this._listener = _listener;
         this._server = _server;
         this._onUpgrade = (req, socket) => {
             let apn = req.headers[LibWS.H1_HDR_NAME_WS_PROTOCOL];
@@ -51,9 +51,10 @@ class WebSocketGateway extends node_events_1.EventEmitter {
             });
             this._server.registerChannel(new WebSocket_Transporter_1.WebSocketTransporter(dWS.WS_PROTOCOL_NAME, ws));
         };
-        this._listener
-            .on('error', (e) => this.emit('error', e))
-            .setUpgradeProcessor(this._onUpgrade);
+        this._listener = registerListener({
+            'onErrorCallback': (e) => this.emit('error', e),
+            'onUpgradeCallback': this._onUpgrade,
+        });
         this._wsServer = LibWS.createServer({
             frameReceiveMode: LibWS.EFrameReceiveMode.LITE,
             timeout,
@@ -66,23 +67,40 @@ class WebSocketGateway extends node_events_1.EventEmitter {
         if (this.running) {
             return;
         }
-        await this._listener.start();
+        await this._listener.start?.();
     }
     async stop() {
         if (!this.running) {
             return;
         }
-        await this._listener.stop();
+        await this._listener.stop?.();
     }
 }
 /**
- * Create a WebSocket gateway.
+ * Create a WebSocket gateway, binding to a simple built-in HTTP(S) listener.
+ *
+ * > When using built-in HTTP server, the api will ignore other headers, path and query string in the URL.
  *
  * @param listener      The HTTP(S) listener object.
  * @param server        The televoke server object.
  */
 function createWebsocketGateway(listener, server, options = {}) {
-    return new WebSocketGateway(listener, server, options.timeout);
+    return new WebSocketGateway((o) => {
+        listener.on('error', o.onErrorCallback);
+        listener.setUpgradeProcessor(o.onUpgradeCallback);
+        return listener;
+    }, server, options.timeout);
+}
+/**
+ * Create a WebSocket gateway, binding to a custom HTTP server.
+ *
+ * > When using a custom HTTP server, it's able to preprocess the request before passing to the server, like
+ * > authentication, rate limiting, custom routing, etc.
+ *
+ * @param registerListener  The function to register the listener to the custom HTTP server.
+ * @param server            The server to process the requests.
+ */
+function createCustomWebsocketGateway(registerListener, server) {
+    return new WebSocketGateway(registerListener, server);
 }
-exports.createWebsocketGateway = createWebsocketGateway;
 //# sourceMappingURL=WebSocket.Server.js.map

package/lib/transporters/websocket/WebSocket.Server.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocket.Server.js","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Server.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,2CAA2C;AAC3C,wCAAwC;AAGxC,6CAA2C;AAC3C,mEAA+D;AAE/D,MAAM,gBAAiB,SAAQ,0BAAY;IAIvC,YACqB,SAAiC,EACjC,OAAmB,EACpC,OAAgB;QAGhB,KAAK,EAAE,CAAC;QALS,cAAS,GAAT,SAAS,CAAwB;QACjC,YAAO,GAAP,OAAO,CAAY;QAgBvB,eAAU,GAA+B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAEtE,IAAI,GAAG,GAAsB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAE,CAAC;YAEzE,IAAI,CAAC,GAAG,EAAE,CAAC;gBAEP,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;oBAClB,SAAS,EAAE,GAAG;oBACd,QAAQ,EAAE,MAAa;iBAC1B,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAEtB,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBAE5C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;oBAClB,SAAS,EAAE,GAAG;oBACd,QAAQ,EAAE,MAAa;iBAC1B,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;YAED,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAC7B,SAAS,EAAE,GAAG;gBACd,QAAQ,EAAE,MAAa;gBACvB,aAAa,EAAE,GAAG,CAAC,sBAAsB;aAC5C,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,4CAAoB,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC;QA5CE,IAAI,CAAC,SAAS;aACT,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;aACzC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC;YAChC,gBAAgB,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI;YAC9C,OAAO;SACV,CAAC,CAAC;IACP,CAAC;IAsCD,IAAW,OAAO;QAEd,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,KAAK;QAEd,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAEf,OAAO;QACX,CAAC;QAED,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,IAAI;QAEb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAEhB,OAAO;QACX,CAAC;QAED,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACJ;AAcD;;;;;GAKG;AACH,SAAgB,sBAAsB,CAClC,QAAgC,EAChC,MAAkB,EAClB,UAAoC,EAAE;IAGtC,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAPD,wDAOC"}
+{"version":3,"file":"WebSocket.Server.js","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Server.ts"],"names":[],"mappings":"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"}

package/lib/transporters/websocket/WebSocket.Transporter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,8 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-/// <reference types="node" />
-/// <reference types="node" />
 import * as LibWS from '@litert/websocket';
 import * as Shared from '../../shared';
 import type * as dT from '../Transporter.decl';
@@ -28,7 +26,7 @@ export declare class WebSocketTransporter extends EventEmitter implements dT.ITr
     getAllProperties(): Record<string, unknown>;
     getProperty(name: string): unknown;
     get writable(): boolean;
-    write(frame: string | Buffer | Array<string | Buffer>): void;
-    end(frame?: Buffer | string): void;
+    write(frame: Array<string | Buffer>): void;
+    end(): void;
 }
 //# sourceMappingURL=WebSocket.Transporter.d.ts.map

package/lib/transporters/websocket/WebSocket.Transporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocket.Transporter.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Transporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,qBAAa,oBAAqB,SAAQ,YAAa,YAAW,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY;aAG9E,QAAQ,EAAE,MAAM;IAChC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU;gBAD1B,QAAQ,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,CAAC,UAAU;IA4BvC,OAAO,IAAI,IAAI;IAKf,gBAAgB,IAAI,MAAM,EAAE;IAK5B,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAW3C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAczC,IAAW,QAAQ,IAAI,OAAO,CAG7B;IAEM,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAiB5D,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAmB5C"}
+{"version":3,"file":"WebSocket.Transporter.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Transporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,qBAAa,oBAAqB,SAAQ,YAAa,YAAW,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY;aAG9E,QAAQ,EAAE,MAAM;IAChC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU;gBAD1B,QAAQ,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,CAAC,UAAU;IA4BvC,OAAO,IAAI,IAAI;IAKf,gBAAgB,IAAI,MAAM,EAAE;IAK5B,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAW3C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAczC,IAAW,QAAQ,IAAI,OAAO,CAG7B;IAEM,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAiB1C,GAAG,IAAI,IAAI;CAOrB"}

package/lib/transporters/websocket/WebSocket.Transporter.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -88,16 +88,8 @@ class WebSocketTransporter extends node_events_1.EventEmitter {
             throw new Shared.errors.network_error({ reason: 'conn_lost', cause: e });
         }
     }
-    end(frame) {
+    end() {
         if (this._conn.writable) {
-            if (frame) {
-                try {
-                    this._conn.writeBinary(frame);
-                }
-                catch (e) {
-                    throw new Shared.errors.network_error({ reason: 'conn_lost', cause: e });
-                }
-            }
             this._conn.end();
         }
     }

package/lib/transporters/websocket/WebSocket.Transporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocket.Transporter.js","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Transporter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WebSocket.Transporter.js","sourceRoot":"","sources":["../../../src/lib/transporters/websocket/WebSocket.Transporter.ts"],"names":[],"mappings":"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"}

package/lib/transporters/websocket/WebSocket.decl.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/lib/transporters/websocket/WebSocket.decl.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/lib/transporters/websocket/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/lib/transporters/websocket/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Copyright 2024 Angus.Fenying <fenying@litert.org>
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/lib/transporters/worker-thread/WorkerThread.Client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as NodeWorker from 'node:worker_threads';
+import type * as dT from '../Transporter.decl';
+/**
+ * Create a connector to connect to the server running in the main thread.
+ *
+ * @experimental
+ */
+export declare function connectToMainThreadServer(): dT.IConnector;
+/**
+ * Create a connector to connect to the server running in the worker thread.
+ *
+ * @experimental
+ */
+export declare function connectToWorkerThreadServer(worker: NodeWorker.Worker): dT.IConnector;
+//# sourceMappingURL=WorkerThread.Client.d.ts.map

package/lib/transporters/worker-thread/WorkerThread.Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerThread.Client.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/worker-thread/WorkerThread.Client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AA0C/C;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,EAAE,CAAC,UAAU,CAQzD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,UAAU,CAQpF"}

package/lib/transporters/worker-thread/WorkerThread.Client.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectToMainThreadServer = connectToMainThreadServer;
+exports.connectToWorkerThreadServer = connectToWorkerThreadServer;
+const NodeWorker = require("node:worker_threads");
+const eWT = require("./WorkerThread.Errors");
+const WorkerThread_Constants_1 = require("./WorkerThread.Constants");
+const WorkerThread_Transporter_1 = require("./WorkerThread.Transporter");
+class MainServerConnector {
+    constructor() {
+        this._transporter = null;
+    }
+    async connect() {
+        return Promise.resolve(this._transporter ?? (this._transporter = new WorkerThread_Transporter_1.WorkerThreadTransporter(WorkerThread_Constants_1.MAIN_THREAD_PROTOCOL_NAME)));
+    }
+}
+class WorkerServerConnector {
+    constructor(worker) {
+        this._worker = null;
+        this._transporter = null;
+        this._worker = worker
+            .on('exit', () => { this._worker = null; });
+    }
+    async connect() {
+        if (!this._worker) {
+            throw new eWT.E_WORKER_THREAD_OFFLINE();
+        }
+        this._transporter ?? (this._transporter = new WorkerThread_Transporter_1.MainThreadTransporter(WorkerThread_Constants_1.MAIN_THREAD_PROTOCOL_NAME, this._worker));
+        return Promise.resolve(this._transporter);
+    }
+}
+let inst = null;
+/**
+ * Create a connector to connect to the server running in the main thread.
+ *
+ * @experimental
+ */
+function connectToMainThreadServer() {
+    if (NodeWorker.isMainThread) {
+        throw new eWT.E_WORKER_THREAD_ONLY();
+    }
+    return inst ?? (inst = new MainServerConnector());
+}
+/**
+ * Create a connector to connect to the server running in the worker thread.
+ *
+ * @experimental
+ */
+function connectToWorkerThreadServer(worker) {
+    if (!NodeWorker.isMainThread) {
+        throw new eWT.E_MAIN_THREAD_ONLY();
+    }
+    return new WorkerServerConnector(worker);
+}
+//# sourceMappingURL=WorkerThread.Client.js.map

package/lib/transporters/worker-thread/WorkerThread.Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerThread.Client.js","sourceRoot":"","sources":["../../../src/lib/transporters/worker-thread/WorkerThread.Client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAkDH,8DAQC;AAOD,kEAQC;AAvED,kDAAkD;AAElD,6CAA6C;AAC7C,qEAAqE;AACrE,yEAA4F;AAE5F,MAAM,mBAAmB;IAAzB;QAEY,iBAAY,GAA2B,IAAI,CAAC;IAMxD,CAAC;IAJU,KAAK,CAAC,OAAO;QAEhB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,KAAjB,IAAI,CAAC,YAAY,GAAK,IAAI,kDAAuB,CAAC,kDAAyB,CAAC,EAAC,CAAC;IACzG,CAAC;CACJ;AAED,MAAM,qBAAqB;IAIvB,YAAmB,MAAyB;QAFpC,YAAO,GAA6B,IAAI,CAAC;QAQzC,iBAAY,GAA2B,IAAI,CAAC;QAJhD,IAAI,CAAC,OAAO,GAAG,MAAM;aAChB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAIM,KAAK,CAAC,OAAO;QAEhB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAEhB,MAAM,IAAI,GAAG,CAAC,uBAAuB,EAAE,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,YAAY,KAAjB,IAAI,CAAC,YAAY,GAAK,IAAI,gDAAqB,CAAC,kDAAyB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAC;QAEzF,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;CACJ;AAED,IAAI,IAAI,GAA+B,IAAI,CAAC;AAE5C;;;;GAIG;AACH,SAAgB,yBAAyB;IAErC,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,IAAI,KAAJ,IAAI,GAAK,IAAI,mBAAmB,EAAE,EAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAgB,2BAA2B,CAAC,MAAyB;IAEjE,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QAE3B,MAAM,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;IACvC,CAAC;IAED,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/lib/transporters/worker-thread/WorkerThread.Constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare const MAIN_THREAD_PROTOCOL_NAME = "worker_thread/main";
+export declare const WORKER_THREAD_PROTOCOL_NAME = "worker_thread/worker";
+//# sourceMappingURL=WorkerThread.Constants.d.ts.map

package/lib/transporters/worker-thread/WorkerThread.Constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerThread.Constants.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/worker-thread/WorkerThread.Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,eAAO,MAAM,2BAA2B,yBAAyB,CAAC"}

package/lib/transporters/worker-thread/WorkerThread.Constants.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKER_THREAD_PROTOCOL_NAME = exports.MAIN_THREAD_PROTOCOL_NAME = void 0;
+exports.MAIN_THREAD_PROTOCOL_NAME = 'worker_thread/main';
+exports.WORKER_THREAD_PROTOCOL_NAME = 'worker_thread/worker';
+//# sourceMappingURL=WorkerThread.Constants.js.map

package/lib/transporters/worker-thread/WorkerThread.Constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerThread.Constants.js","sourceRoot":"","sources":["../../../src/lib/transporters/worker-thread/WorkerThread.Constants.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEU,QAAA,yBAAyB,GAAG,oBAAoB,CAAC;AAEjD,QAAA,2BAA2B,GAAG,sBAAsB,CAAC"}

package/lib/transporters/worker-thread/WorkerThread.Errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare const E_WORKER_THREAD_OFFLINE: {
+    new (origin?: unknown): {
+        readonly origin: unknown;
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare const E_MAIN_THREAD_ONLY: {
+    new (origin?: unknown): {
+        readonly origin: unknown;
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare const E_WORKER_THREAD_ONLY: {
+    new (origin?: unknown): {
+        readonly origin: unknown;
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+//# sourceMappingURL=WorkerThread.Errors.d.ts.map

package/lib/transporters/worker-thread/WorkerThread.Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerThread.Errors.d.ts","sourceRoot":"","sources":["../../../src/lib/transporters/worker-thread/WorkerThread.Errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,eAAO,MAAM,uBAAuB;kBAEL,OAAO;;;;;;;mDAiCmwI,OAAQ,QAAQ;;CAzBxzI,CAAC;AAEF,eAAO,MAAM,kBAAkB;kBAEA,OAAO;;;;;;;mDAqBmwI,OAAQ,QAAQ;;CAbxzI,CAAC;AAEF,eAAO,MAAM,oBAAoB;kBAEF,OAAO;;;;;;;mDASmwI,OAAQ,QAAQ;;CADxzI,CAAC"}

package/lib/transporters/worker-thread/WorkerThread.Errors.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.E_WORKER_THREAD_ONLY = exports.E_MAIN_THREAD_ONLY = exports.E_WORKER_THREAD_OFFLINE = void 0;
+const shared_1 = require("../../shared");
+const E_WORKER_THREAD_OFFLINE = class extends shared_1.TelevokeError {
+    constructor(origin = null) {
+        super('worker_thread_offline', 'The worker thread is offline.', origin);
+    }
+};
+exports.E_WORKER_THREAD_OFFLINE = E_WORKER_THREAD_OFFLINE;
+const E_MAIN_THREAD_ONLY = class extends shared_1.TelevokeError {
+    constructor(origin = null) {
+        super('main_thread_only', 'The operation is only allowed in the main thread.', origin);
+    }
+};
+exports.E_MAIN_THREAD_ONLY = E_MAIN_THREAD_ONLY;
+const E_WORKER_THREAD_ONLY = class extends shared_1.TelevokeError {
+    constructor(origin = null) {
+        super('worker_thread_only', 'The operation is only allowed in a worker thread.', origin);
+    }
+};
+exports.E_WORKER_THREAD_ONLY = E_WORKER_THREAD_ONLY;
+//# sourceMappingURL=WorkerThread.Errors.js.map

package/lib/transporters/worker-thread/WorkerThread.Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerThread.Errors.js","sourceRoot":"","sources":["../../../src/lib/transporters/worker-thread/WorkerThread.Errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yCAA6C;AAEtC,MAAM,uBAAuB,GAAG,KAAM,SAAQ,sBAAa;IAE9D,YAAmB,SAAkB,IAAI;QAErC,KAAK,CACD,uBAAuB,EACvB,+BAA+B,EAC/B,MAAM,CACT,CAAC;IACN,CAAC;CACJ,CAAC;AAVW,QAAA,uBAAuB,2BAUlC;AAEK,MAAM,kBAAkB,GAAG,KAAM,SAAQ,sBAAa;IAEzD,YAAmB,SAAkB,IAAI;QAErC,KAAK,CACD,kBAAkB,EAClB,mDAAmD,EACnD,MAAM,CACT,CAAC;IACN,CAAC;CACJ,CAAC;AAVW,QAAA,kBAAkB,sBAU7B;AAEK,MAAM,oBAAoB,GAAG,KAAM,SAAQ,sBAAa;IAE3D,YAAmB,SAAkB,IAAI;QAErC,KAAK,CACD,oBAAoB,EACpB,mDAAmD,EACnD,MAAM,CACT,CAAC;IACN,CAAC;CACJ,CAAC;AAVW,QAAA,oBAAoB,wBAU/B"}

package/lib/transporters/worker-thread/WorkerThread.Server.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright 2025 Angus.Fenying <fenying@litert.org>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as NodeWorker from 'node:worker_threads';
+import type * as dT from '../Transporter.decl';
+export interface IMainThreadGateway extends dT.IGateway {
+    /**
+     * Add a worker thread to the gateway, so that the gateway can communicate with it.
+     *
+     * > The worker thread must be online already.
+     *
+     * @param worker    The worker instance on the main thread.
+     */
+    registerWorker(worker: NodeWorker.Worker): void;
+}
+/**
+ * Create a gateway that runs in the main thread.
+ *
+ * @param server    The server instance.
+ * @experimental
+ */
+export declare function createMainThreadGateway(server: dT.IServer): IMainThreadGateway;
+/**
+ * Create a gateway that runs in the worker thread.
+ *
+ * @param server    The server instance.
+ * @experimental
+ */
+export declare function createWorkerThreadGateway(server: dT.IServer): dT.IGateway;
+//# sourceMappingURL=WorkerThread.Server.d.ts.map