scoundrel-remote-eval 1.0.18 → 1.0.20

package/README.md

@@ -25,7 +25,7 @@ const client = new Client(clientWebSocket)
 
 const math = await client.import("math")
 const pi = await math.readAttributeWithReference("pi")
-const cosOfPi = await math.callMethodWithReference("cos", pi)
+const cosOfPi = await math.callMethod("cos", {returnReference: true}, pi)
 const result = await cosOfPi.serialize()
 
 expect(result).toEqual(-1)
@@ -34,6 +34,44 @@ client.close()
 pythonWebSocketRunner.close()
 ```
 
+## Client and reference examples
+
+Create remote objects, call methods, and fetch attributes:
+
+```js
+const arrayRef = await client.newObjectWithReference("Array")
+await arrayRef.callMethod("push", "one", "two")
+const joined = await arrayRef.callMethod("join", ", ")
+expect(joined).toEqual("one, two")
+
+const lengthRef = await arrayRef.callMethod("push", {returnReference: true}, "three")
+const length = await lengthRef.serialize()
+expect(length).toEqual(3)
+```
+
+Read attributes directly or as references:
+
+```js
+const math = await client.import("math")
+const piRef = await math.readAttributeWithReference("pi")
+const pi = await piRef.serialize()
+
+const e = await math.readAttribute("E")
+expect([pi, e].every((value) => typeof value === "number")).toEqual(true)
+```
+
+Fetch globally available or registered objects:
+
+```js
+client.registerObject("config", {mode: "test"})
+
+const configRef = await client.getObject("config")
+const config = await configRef.serialize()
+expect(config).toEqual({mode: "test"})
+
+client.unregisterObject("config")
+```
+
 ## Serialization
 
 `Reference#serialize()` only supports JSON-safe values (strings, numbers, booleans, null, plain objects, and arrays). It throws an error if the value contains functions, symbols, bigints, class instances/non-plain objects, circular references, non-finite numbers, or other unsupported types.
@@ -82,7 +120,13 @@ const client = new Client(clientWebSocket, {enableServerControl: false})
 // equivalent to: new Client(clientWebSocket)
 ```
 
-Registered objects and classes are available inside `evalWithReference`:
+You can also enable it after construction:
+
+```js
+client.enableServerControl()
+```
+
+Registered objects and classes are available inside `eval`:
 
 ```js
 const client = new Client(clientWebSocket, {enableServerControl: true})
@@ -101,8 +145,28 @@ client.registerClass("TestGreeter", TestGreeter)
 client.registerObject("testSettings", {prefix: "Hello"})
 
 const serverClient = server.getClients()[0] // from your ScoundrelServer instance
-const greetingRef = await serverClient.evalWithReference("(() => { const greeter = new TestGreeter(testSettings.prefix); return greeter.greet('World') })()")
+const greetingRef = await serverClient.eval("(() => { const greeter = new TestGreeter(testSettings.prefix); return greeter.greet('World') })()")
 const greeting = await greetingRef.serialize()
 
 expect(greeting).toEqual("Hello World")
 ```
+
+You can unregister classes or objects to remove them from server-side lookups and `eval` scope:
+
+```js
+client.unregisterClass("TestGreeter")
+client.unregisterObject("testSettings")
+```
+
+`eval` defaults to returning a reference, but you can request the raw result:
+
+```js
+const result = await serverClient.eval({returnResult: true}, "(() => 1 + 1)()")
+expect(result).toEqual(2)
+```
+
+Use `eval` with `returnReference` if you need to be explicit:
+
+```js
+const greetingRef = await serverClient.eval({returnReference: true}, "(() => { return 'Hello' })()")
+```

package/build/client/connections/web-socket/index.d.ts

@@ -9,24 +9,24 @@ export default class WebSocket {
     commandsCount: number;
     close(): Promise<void>;
     /**
-     * @param {(data: any) => void} callback
+     * @param {(data: any) => void} callback Handler for incoming commands
      */
     onCommand(callback: (data: any) => void): void;
     onCommandCallback: (data: any) => void;
     /**
-     * @param {Event} event
+     * @param {Event} event WebSocket error event
      */
     onSocketError: (event: Event) => void;
     /**
-     * @param {MessageEvent} event
+     * @param {MessageEvent} event WebSocket message event
      */
     onSocketMessage: (event: MessageEvent) => void;
     /**
-     * @param {Event} event
+     * @param {Event} event WebSocket open event
      */
     onSocketOpen: (event: Event) => void;
     /**
-     * @param {Record<string, any>} data
+     * @param {Record<string, any>} data Payload to send
      */
     send(data: Record<string, any>): void;
     waitForOpened: () => Promise<any>;

package/build/client/connections/web-socket/index.js

@@ -9,13 +9,13 @@ export default class WebSocket {
      */
     constructor(ws) {
         /**
-         * @param {Event} event
+         * @param {Event} event WebSocket error event
          */
         this.onSocketError = (event) => {
             logger.error(() => ["onSocketError", event]);
         };
         /**
-         * @param {MessageEvent} event
+         * @param {MessageEvent} event WebSocket message event
          */
         this.onSocketMessage = (event) => {
             const data = JSON.parse(event.data);
@@ -26,7 +26,7 @@ export default class WebSocket {
             this.onCommandCallback(data);
         };
         /**
-         * @param {Event} event
+         * @param {Event} event WebSocket open event
          */
         this.onSocketOpen = (event) => {
             logger.log(() => ["onSocketOpen", event]);
@@ -51,13 +51,13 @@ export default class WebSocket {
         await this.ws.close();
     }
     /**
-     * @param {(data: any) => void} callback
+     * @param {(data: any) => void} callback Handler for incoming commands
      */
     onCommand(callback) {
         this.onCommandCallback = callback;
     }
     /**
-     * @param {Record<string, any>} data
+     * @param {Record<string, any>} data Payload to send
      */
     send(data) {
         const sendData = JSON.stringify(data);
@@ -66,4 +66,4 @@ export default class WebSocket {
         this.ws.send(sendData);
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY2xpZW50L2Nvbm5lY3Rpb25zL3dlYi1zb2NrZXQvaW5kZXguanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sTUFBTSxNQUFNLG9CQUFvQixDQUFBO0FBRXZDLE1BQU0sTUFBTSxHQUFHLElBQUksTUFBTSxDQUFDLHFCQUFxQixDQUFDLENBQUE7QUFFaEQsd0JBQXdCO0FBRXhCLE1BQU0sQ0FBQyxPQUFPLE9BQU8sU0FBUztJQUM1Qjs7O09BR0c7SUFDSCxZQUFZLEVBQUU7UUEyQmQ7O1dBRUc7UUFDSCxrQkFBYSxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUU7WUFDeEIsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLGVBQWUsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFBO1FBQzlDLENBQUMsQ0FBQTtRQUVEOztXQUVHO1FBQ0gsb0JBQWUsR0FBRyxDQUFDLEtBQUssRUFBRSxFQUFFO1lBQzFCLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFBO1lBRW5DLE1BQU0sQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxnREFBZ0QsRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFBO1lBRTFFLElBQUksQ0FBQyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztnQkFDNUIsTUFBTSxJQUFJLEtBQUssQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFBO1lBQ2hFLENBQUM7WUFFRCxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUE7UUFDOUIsQ0FBQyxDQUFBO1FBRUQ7O1dBRUc7UUFDSCxpQkFBWSxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUU7WUFDdkIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLGNBQWMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFBO1FBQzNDLENBQUMsQ0FBQTtRQWFELGtCQUFhLEdBQUcsR0FBRyxFQUFFLENBQUMsSUFBSSxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsTUFBTSxFQUFFLEVBQUU7WUFDcEQsYUFBYTtZQUNiLElBQUksQ0FBQyxFQUFFLENBQUMsZ0JBQWdCLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFBO1lBRXpDLGFBQWE7WUFDYixJQUFJLENBQUMsRUFBRSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQTtRQUMzQyxDQUFDLENBQUMsQ0FBQTtRQXhFQSxJQUFJLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQTtRQUVaLGFBQWE7UUFDYixJQUFJLENBQUMsRUFBRSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsYUFBYSxDQUFDLENBQUE7UUFFckQsYUFBYTtRQUNiLElBQUksQ0FBQyxFQUFFLENBQUMsZ0JBQWdCLENBQUMsTUFBTSxFQUFFLElBQUksQ0FBQyxZQUFZLENBQUMsQ0FBQTtRQUVuRCxhQUFhO1FBQ2IsSUFBSSxDQUFDLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLGVBQWUsQ0FBQyxDQUFBO1FBRXpELElBQUksQ0FBQyxRQUFRLEdBQUcsRUFBRSxDQUFBO1FBQ2xCLElBQUksQ0FBQyxhQUFhLEdBQUcsQ0FBQyxDQUFBO0lBQ3hCLENBQUM7SUFFRCxLQUFLLENBQUMsS0FBSztRQUNULE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxLQUFLLEVBQUUsQ0FBQTtJQUN2QixDQUFDO0lBRUQ7O09BRUc7SUFDSCxTQUFTLENBQUMsUUFBUTtRQUNoQixJQUFJLENBQUMsaUJBQWlCLEdBQUcsUUFBUSxDQUFBO0lBQ25DLENBQUM7SUErQkQ7O09BRUc7SUFDSCxJQUFJLENBQUMsSUFBSTtRQUNQLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLENBQUE7UUFDckMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLFNBQVMsRUFBRSxRQUFRLENBQUMsQ0FBQyxDQUFBO1FBRXZDLGFBQWE7UUFDYixJQUFJLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTtJQUN4QixDQUFDO0NBU0YiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBAdHMtY2hlY2tcblxuaW1wb3J0IExvZ2dlciBmcm9tIFwiLi4vLi4vLi4vbG9nZ2VyLmpzXCJcblxuY29uc3QgbG9nZ2VyID0gbmV3IExvZ2dlcihcIlNjb3VuZHJlbCBXZWJTb2NrZXRcIilcblxuLy8gbG9nZ2VyLnNldERlYnVnKHRydWUpXG5cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFdlYlNvY2tldCB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IFdlYlNvY2tldCBjb25uZWN0aW9uIGhhbmRsZXJcbiAgICogQHBhcmFtIHtXZWJTb2NrZXR9IHdzIFRoZSBXZWJTb2NrZXQgaW5zdGFuY2VcbiAgICovXG4gIGNvbnN0cnVjdG9yKHdzKSB7XG4gICAgdGhpcy53cyA9IHdzXG5cbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5hZGRFdmVudExpc3RlbmVyKFwiZXJyb3JcIiwgdGhpcy5vblNvY2tldEVycm9yKVxuXG4gICAgLy8gQHRzLWlnbm9yZVxuICAgIHRoaXMud3MuYWRkRXZlbnRMaXN0ZW5lcihcIm9wZW5cIiwgdGhpcy5vblNvY2tldE9wZW4pXG5cbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5hZGRFdmVudExpc3RlbmVyKFwibWVzc2FnZVwiLCB0aGlzLm9uU29ja2V0TWVzc2FnZSlcblxuICAgIHRoaXMuY29tbWFuZHMgPSB7fVxuICAgIHRoaXMuY29tbWFuZHNDb3VudCA9IDBcbiAgfVxuXG4gIGFzeW5jIGNsb3NlKCkge1xuICAgIGF3YWl0IHRoaXMud3MuY2xvc2UoKVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7KGRhdGE6IGFueSkgPT4gdm9pZH0gY2FsbGJhY2tcbiAgICovXG4gIG9uQ29tbWFuZChjYWxsYmFjaykge1xuICAgIHRoaXMub25Db21tYW5kQ2FsbGJhY2sgPSBjYWxsYmFja1xuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7RXZlbnR9IGV2ZW50XG4gICAqL1xuICBvblNvY2tldEVycm9yID0gKGV2ZW50KSA9PiB7XG4gICAgbG9nZ2VyLmVycm9yKCgpID0+IFtcIm9uU29ja2V0RXJyb3JcIiwgZXZlbnRdKVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7TWVzc2FnZUV2ZW50fSBldmVudFxuICAgKi9cbiAgb25Tb2NrZXRNZXNzYWdlID0gKGV2ZW50KSA9PiB7XG4gICAgY29uc3QgZGF0YSA9IEpTT04ucGFyc2UoZXZlbnQuZGF0YSlcblxuICAgIGxvZ2dlci5sb2coKCkgPT4gW1wiQ2xpZW50OjpDb25uZWN0aW9uczo6V2ViU29ja2V0IG9uU29ja2V0TWVzc2FnZVwiLCBkYXRhXSlcblxuICAgIGlmICghdGhpcy5vbkNvbW1hbmRDYWxsYmFjaykge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFwiTm8gb25Db21tYW5kIGNhbGxiYWNrIHNldCwgaWdub3JpbmcgbWVzc2FnZVwiKVxuICAgIH1cblxuICAgIHRoaXMub25Db21tYW5kQ2FsbGJhY2soZGF0YSlcbiAgfVxuXG4gIC8qKlxuICAgKiBAcGFyYW0ge0V2ZW50fSBldmVudFxuICAgKi9cbiAgb25Tb2NrZXRPcGVuID0gKGV2ZW50KSA9PiB7XG4gICAgbG9nZ2VyLmxvZygoKSA9PiBbXCJvblNvY2tldE9wZW5cIiwgZXZlbnRdKVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgYW55Pn0gZGF0YVxuICAgKi9cbiAgc2VuZChkYXRhKSB7XG4gICAgY29uc3Qgc2VuZERhdGEgPSBKU09OLnN0cmluZ2lmeShkYXRhKVxuICAgIGxvZ2dlci5sb2coKCkgPT4gW1wiU2VuZGluZ1wiLCBzZW5kRGF0YV0pXG5cbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5zZW5kKHNlbmREYXRhKVxuICB9XG5cbiAgd2FpdEZvck9wZW5lZCA9ICgpID0+IG5ldyBQcm9taXNlKChyZXNvbHZlLCByZWplY3QpID0+IHtcbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5hZGRFdmVudExpc3RlbmVyKFwib3BlblwiLCByZXNvbHZlKVxuXG4gICAgLy8gQHRzLWlnbm9yZVxuICAgIHRoaXMud3MuYWRkRXZlbnRMaXN0ZW5lcihcImVycm9yXCIsIHJlamVjdClcbiAgfSlcbn1cbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY2xpZW50L2Nvbm5lY3Rpb25zL3dlYi1zb2NrZXQvaW5kZXguanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sTUFBTSxNQUFNLG9CQUFvQixDQUFBO0FBRXZDLE1BQU0sTUFBTSxHQUFHLElBQUksTUFBTSxDQUFDLHFCQUFxQixDQUFDLENBQUE7QUFFaEQsd0JBQXdCO0FBRXhCLE1BQU0sQ0FBQyxPQUFPLE9BQU8sU0FBUztJQUM1Qjs7O09BR0c7SUFDSCxZQUFZLEVBQUU7UUEyQmQ7O1dBRUc7UUFDSCxrQkFBYSxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUU7WUFDeEIsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLGVBQWUsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFBO1FBQzlDLENBQUMsQ0FBQTtRQUVEOztXQUVHO1FBQ0gsb0JBQWUsR0FBRyxDQUFDLEtBQUssRUFBRSxFQUFFO1lBQzFCLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFBO1lBRW5DLE1BQU0sQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxnREFBZ0QsRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFBO1lBRTFFLElBQUksQ0FBQyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztnQkFDNUIsTUFBTSxJQUFJLEtBQUssQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFBO1lBQ2hFLENBQUM7WUFFRCxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUE7UUFDOUIsQ0FBQyxDQUFBO1FBRUQ7O1dBRUc7UUFDSCxpQkFBWSxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUU7WUFDdkIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLGNBQWMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFBO1FBQzNDLENBQUMsQ0FBQTtRQWFELGtCQUFhLEdBQUcsR0FBRyxFQUFFLENBQUMsSUFBSSxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsTUFBTSxFQUFFLEVBQUU7WUFDcEQsYUFBYTtZQUNiLElBQUksQ0FBQyxFQUFFLENBQUMsZ0JBQWdCLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFBO1lBRXpDLGFBQWE7WUFDYixJQUFJLENBQUMsRUFBRSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQTtRQUMzQyxDQUFDLENBQUMsQ0FBQTtRQXhFQSxJQUFJLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQTtRQUVaLGFBQWE7UUFDYixJQUFJLENBQUMsRUFBRSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsYUFBYSxDQUFDLENBQUE7UUFFckQsYUFBYTtRQUNiLElBQUksQ0FBQyxFQUFFLENBQUMsZ0JBQWdCLENBQUMsTUFBTSxFQUFFLElBQUksQ0FBQyxZQUFZLENBQUMsQ0FBQTtRQUVuRCxhQUFhO1FBQ2IsSUFBSSxDQUFDLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLGVBQWUsQ0FBQyxDQUFBO1FBRXpELElBQUksQ0FBQyxRQUFRLEdBQUcsRUFBRSxDQUFBO1FBQ2xCLElBQUksQ0FBQyxhQUFhLEdBQUcsQ0FBQyxDQUFBO0lBQ3hCLENBQUM7SUFFRCxLQUFLLENBQUMsS0FBSztRQUNULE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQyxLQUFLLEVBQUUsQ0FBQTtJQUN2QixDQUFDO0lBRUQ7O09BRUc7SUFDSCxTQUFTLENBQUMsUUFBUTtRQUNoQixJQUFJLENBQUMsaUJBQWlCLEdBQUcsUUFBUSxDQUFBO0lBQ25DLENBQUM7SUErQkQ7O09BRUc7SUFDSCxJQUFJLENBQUMsSUFBSTtRQUNQLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLENBQUE7UUFDckMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLFNBQVMsRUFBRSxRQUFRLENBQUMsQ0FBQyxDQUFBO1FBRXZDLGFBQWE7UUFDYixJQUFJLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTtJQUN4QixDQUFDO0NBU0YiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBAdHMtY2hlY2tcblxuaW1wb3J0IExvZ2dlciBmcm9tIFwiLi4vLi4vLi4vbG9nZ2VyLmpzXCJcblxuY29uc3QgbG9nZ2VyID0gbmV3IExvZ2dlcihcIlNjb3VuZHJlbCBXZWJTb2NrZXRcIilcblxuLy8gbG9nZ2VyLnNldERlYnVnKHRydWUpXG5cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFdlYlNvY2tldCB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IFdlYlNvY2tldCBjb25uZWN0aW9uIGhhbmRsZXJcbiAgICogQHBhcmFtIHtXZWJTb2NrZXR9IHdzIFRoZSBXZWJTb2NrZXQgaW5zdGFuY2VcbiAgICovXG4gIGNvbnN0cnVjdG9yKHdzKSB7XG4gICAgdGhpcy53cyA9IHdzXG5cbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5hZGRFdmVudExpc3RlbmVyKFwiZXJyb3JcIiwgdGhpcy5vblNvY2tldEVycm9yKVxuXG4gICAgLy8gQHRzLWlnbm9yZVxuICAgIHRoaXMud3MuYWRkRXZlbnRMaXN0ZW5lcihcIm9wZW5cIiwgdGhpcy5vblNvY2tldE9wZW4pXG5cbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5hZGRFdmVudExpc3RlbmVyKFwibWVzc2FnZVwiLCB0aGlzLm9uU29ja2V0TWVzc2FnZSlcblxuICAgIHRoaXMuY29tbWFuZHMgPSB7fVxuICAgIHRoaXMuY29tbWFuZHNDb3VudCA9IDBcbiAgfVxuXG4gIGFzeW5jIGNsb3NlKCkge1xuICAgIGF3YWl0IHRoaXMud3MuY2xvc2UoKVxuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7KGRhdGE6IGFueSkgPT4gdm9pZH0gY2FsbGJhY2sgSGFuZGxlciBmb3IgaW5jb21pbmcgY29tbWFuZHNcbiAgICovXG4gIG9uQ29tbWFuZChjYWxsYmFjaykge1xuICAgIHRoaXMub25Db21tYW5kQ2FsbGJhY2sgPSBjYWxsYmFja1xuICB9XG5cbiAgLyoqXG4gICAqIEBwYXJhbSB7RXZlbnR9IGV2ZW50IFdlYlNvY2tldCBlcnJvciBldmVudFxuICAgKi9cbiAgb25Tb2NrZXRFcnJvciA9IChldmVudCkgPT4ge1xuICAgIGxvZ2dlci5lcnJvcigoKSA9PiBbXCJvblNvY2tldEVycm9yXCIsIGV2ZW50XSlcbiAgfVxuXG4gIC8qKlxuICAgKiBAcGFyYW0ge01lc3NhZ2VFdmVudH0gZXZlbnQgV2ViU29ja2V0IG1lc3NhZ2UgZXZlbnRcbiAgICovXG4gIG9uU29ja2V0TWVzc2FnZSA9IChldmVudCkgPT4ge1xuICAgIGNvbnN0IGRhdGEgPSBKU09OLnBhcnNlKGV2ZW50LmRhdGEpXG5cbiAgICBsb2dnZXIubG9nKCgpID0+IFtcIkNsaWVudDo6Q29ubmVjdGlvbnM6OldlYlNvY2tldCBvblNvY2tldE1lc3NhZ2VcIiwgZGF0YV0pXG5cbiAgICBpZiAoIXRoaXMub25Db21tYW5kQ2FsbGJhY2spIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcIk5vIG9uQ29tbWFuZCBjYWxsYmFjayBzZXQsIGlnbm9yaW5nIG1lc3NhZ2VcIilcbiAgICB9XG5cbiAgICB0aGlzLm9uQ29tbWFuZENhbGxiYWNrKGRhdGEpXG4gIH1cblxuICAvKipcbiAgICogQHBhcmFtIHtFdmVudH0gZXZlbnQgV2ViU29ja2V0IG9wZW4gZXZlbnRcbiAgICovXG4gIG9uU29ja2V0T3BlbiA9IChldmVudCkgPT4ge1xuICAgIGxvZ2dlci5sb2coKCkgPT4gW1wib25Tb2NrZXRPcGVuXCIsIGV2ZW50XSlcbiAgfVxuXG4gIC8qKlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIGFueT59IGRhdGEgUGF5bG9hZCB0byBzZW5kXG4gICAqL1xuICBzZW5kKGRhdGEpIHtcbiAgICBjb25zdCBzZW5kRGF0YSA9IEpTT04uc3RyaW5naWZ5KGRhdGEpXG4gICAgbG9nZ2VyLmxvZygoKSA9PiBbXCJTZW5kaW5nXCIsIHNlbmREYXRhXSlcblxuICAgIC8vIEB0cy1pZ25vcmVcbiAgICB0aGlzLndzLnNlbmQoc2VuZERhdGEpXG4gIH1cblxuICB3YWl0Rm9yT3BlbmVkID0gKCkgPT4gbmV3IFByb21pc2UoKHJlc29sdmUsIHJlamVjdCkgPT4ge1xuICAgIC8vIEB0cy1pZ25vcmVcbiAgICB0aGlzLndzLmFkZEV2ZW50TGlzdGVuZXIoXCJvcGVuXCIsIHJlc29sdmUpXG5cbiAgICAvLyBAdHMtaWdub3JlXG4gICAgdGhpcy53cy5hZGRFdmVudExpc3RlbmVyKFwiZXJyb3JcIiwgcmVqZWN0KVxuICB9KVxufVxuIl19

package/build/client/index.d.ts

@@ -1,9 +1,13 @@
+/**
+ * @typedef {{returnReference?: boolean, returnResult?: boolean}} ReturnOptions
+ * @typedef {ReturnOptions & {returnResult?: false}} ReturnReferenceOptions
+ * @typedef {ReturnOptions & {returnResult: true, returnReference?: false}} ReturnResultOptions
+ */
 export default class Client {
     /**
      * Creates a new Scoundrel Client
-     *
      * @param {any} backend The backend connection (e.g., WebSocket)
-     * @param {{enableServerControl?: boolean}} [options]
+     * @param {{enableServerControl?: boolean}} [options] Client configuration options
      */
     constructor(backend: any, options?: {
         enableServerControl?: boolean;
@@ -30,65 +34,103 @@ export default class Client {
     close(): Promise<void>;
     /**
      * Calls a method on a reference and returns the result directly
-     *
-     * @param {number} referenceId
-     * @param {string} methodName
-     * @param  {...any} args
-     * @returns {Promise<any>}
+     * @overload
+     * @param {number} referenceId Reference identifier
+     * @param {string} methodName Method name to invoke
+     * @param  {...any} args Arguments to pass to the method
+     * @returns {Promise<any>} Result from the method call
      */
     callMethodOnReference(referenceId: number, methodName: string, ...args: any[]): Promise<any>;
     /**
      * Calls a method on a reference and returns a new reference
-     *
-     * @param {number} referenceId
-     * @param {string} methodName
-     * @param  {...any} args
-     * @returns {Promise<Reference>}
+     * @overload
+     * @param {number} referenceId Reference identifier
+     * @param {string} methodName Method name to invoke
+     * @param {ReturnReferenceOptions} options Options for the call
+     * @param  {...any} args Arguments to pass to the method
+     * @returns {Promise<Reference>} Reference to the returned value
+     */
+    callMethodOnReference(referenceId: number, methodName: string, options: ReturnReferenceOptions, ...args: any[]): Promise<Reference>;
+    /**
+     * Calls a method on a reference and returns the result directly
+     * @overload
+     * @param {number} referenceId Reference identifier
+     * @param {string} methodName Method name to invoke
+     * @param {ReturnResultOptions} options Options for the call
+     * @param  {...any} args Arguments to pass to the method
+     * @returns {Promise<any>} Result from the method call
+     */
+    callMethodOnReference(referenceId: number, methodName: string, options: ReturnResultOptions, ...args: any[]): Promise<any>;
+    /**
+     * Calls a method on a reference and returns a new reference
+     * @param {number} referenceId Reference identifier
+     * @param {string} methodName Method name to invoke
+     * @param  {...any} args Arguments to pass to the method
+     * @returns {Promise<Reference>} Reference to the return value
      */
     callMethodOnReferenceWithReference(referenceId: number, methodName: string, ...args: any[]): Promise<Reference>;
+    /**
+     * Evaluates a string and returns a reference or result
+     * @overload
+     * @param {string} evalString Code to evaluate
+     * @returns {Promise<Reference>} Reference to the evaluated value
+     */
+    eval(evalString: string): Promise<Reference>;
+    /**
+     * Evaluates a string and returns a reference or result
+     * @overload
+     * @param {ReturnReferenceOptions} options Eval options
+     * @param {string} evalString Code to evaluate
+     * @returns {Promise<Reference>} Reference to the evaluated value
+     */
+    eval(options: ReturnReferenceOptions, evalString: string): Promise<Reference>;
+    /**
+     * Evaluates a string and returns a reference or result
+     * @overload
+     * @param {ReturnResultOptions} options Eval options
+     * @param {string} evalString Code to evaluate
+     * @returns {Promise<any>} Evaluated result
+     */
+    eval(options: ReturnResultOptions, evalString: string): Promise<any>;
     /**
      * Evaluates a string and returns a new reference
-     *
-     * @param {string} evalString
-     * @returns {Promise<Reference>}
+     * @param {string} evalString Code to evaluate
+     * @returns {Promise<Reference>} Reference to the evaluated value
      */
     evalWithReference(evalString: string): Promise<Reference>;
     /**
      * Imports a module and returns a reference to it
-     *
-     * @param {string} importName
-     * @returns {Promise<Reference>}
+     * @param {string} importName Module name to import
+     * @returns {Promise<Reference>} Reference to the module
      */
     import(importName: string): Promise<Reference>;
     /**
      * Gets a registered object by name
-     *
-     * @param {string} objectName
-     * @returns {Promise<Reference>}
+     * @param {string} objectName Registered object name
+     * @returns {Promise<Reference>} Reference to the object
      */
     getObject(objectName: string): Promise<Reference>;
     /**
      * Spawns a new reference to an object
-     *
-     * @param {string} className
-     * @param  {...any} args
-     * @returns {Promise<Reference>}
+     * @param {string} className Class name to construct
+     * @param  {...any} args Constructor arguments
+     * @returns {Promise<Reference>} Reference to the new instance
      */
     newObjectWithReference(className: string, ...args: any[]): Promise<Reference>;
     /**
      * Checks if the input is a plain object
-     * @param {any} input
-     * @returns {boolean}
+     * @param {any} input Value to inspect
+     * @returns {boolean} True when the value is a plain object
      */
     isPlainObject(input: any): boolean;
     /**
      * Handles an incoming command from the backend
-     * @param {object} args
-     * @param {string} args.command
-     * @param {number} args.command_id
-     * @param {any} args.data
-     * @param {string} [args.error]
-     * @param {string} [args.errorStack]
+     * @param {object} args Command payload
+     * @param {string} args.command Command name
+     * @param {number} args.command_id Command identifier
+     * @param {any} args.data Command data
+     * @param {string} [args.error] Error message from the backend
+     * @param {string} [args.errorStack] Error stack from the backend
      */
     onCommand: ({ command, command_id: commandID, data, error, errorStack, ...restArgs }: {
         command: string;
@@ -99,95 +141,106 @@ export default class Client {
     }) => void;
     /**
      * Parases an argument for sending to the server
-     *
-     * @param {any} arg
-     * @returns {any}
+     * @param {any} arg Argument to serialize for transport
+     * @returns {any} Serialized argument payload
      */
     parseArg(arg: any): any;
     /**
      * Reads an attribute on a reference and returns a new reference
-     *
-     * @param {number} referenceId
-     * @param {string} attributeName
-     * @returns {Promise<Reference>}
+     * @param {number} referenceId Reference identifier
+     * @param {string} attributeName Attribute name to read
+     * @returns {Promise<Reference>} Reference to the attribute value
      */
     readAttributeOnReferenceWithReference(referenceId: number, attributeName: string): Promise<Reference>;
     /**
      * Reads an attribute on a reference and returns the result directly
-     *
-     * @param {number} referenceId
-     * @param {string} attributeName
-     * @returns {Promise<any>}
+     * @param {number} referenceId Reference identifier
+     * @param {string} attributeName Attribute name to read
+     * @returns {Promise<any>} Attribute value
      */
     readAttributeOnReference(referenceId: number, attributeName: string): Promise<any>;
     /**
      * Registers a class by name
-     *
-     * @param {string} className
-     * @param {any} classInstance
+     * @param {string} className Class name to register
+     * @param {any} classInstance Class constructor or instance
      */
     registerClass(className: string, classInstance: any): void;
+    /**
+     * Unregisters a class by name
+     * @param {string} className Class name to remove
+     */
+    unregisterClass(className: string): void;
     /**
      * Gets a registered class by name
-     *
-     * @param {string} className
-     * @returns {any}
+     * @param {string} className Class name to look up
+     * @returns {any} Registered class or undefined
      */
     _getRegisteredClass(className: string): any;
     /**
      * Gets a registered class by name
-     *
-     * @param {string} className
-     * @returns {any}
+     * @param {string} className Class name to look up
+     * @returns {any} Registered class or undefined
      */
     getClass(className: string): any;
     /**
      * Registers an object by name
-     *
-     * @param {string} objectName
-     * @param {any} objectInstance
+     * @param {string} objectName Object name to register
+     * @param {any} objectInstance Object instance
      */
     registerObject(objectName: string, objectInstance: any): void;
+    /**
+     * Unregisters an object by name
+     * @param {string} objectName Object name to remove
+     */
+    unregisterObject(objectName: string): void;
     /**
      * Gets a registered object by name
-     *
-     * @param {string} objectName
-     * @returns {any}
+     * @param {string} objectName Object name to look up
+     * @returns {any} Registered object or undefined
      */
     _getRegisteredObject(objectName: string): any;
     /**
      * Responds to a command from the backend
-     * @param {number} commandId
-     * @param {any} data
+     * @param {number} commandId Command identifier
+     * @param {any} data Response payload
      */
     respondToCommand(commandId: number, data: any): void;
     /**
      * Sends a command to the backend and returns a promise that resolves with the response
-     * @param {string} command
-     * @param {any} data
-     * @returns {Promise<any>}
+     * @param {string} command Command name
+     * @param {any} data Command payload
+     * @returns {Promise<any>} Response from the backend
      */
     sendCommand(command: string, data: any): Promise<any>;
     /**
      * Sends data to the backend
-     * @param {any} data
+     * @param {any} data Payload to send
      */
     send(data: any): void;
     /**
      * Serializes a reference and returns the result directly
-     *
-     * @param {number} referenceId
-     * @returns {Promise<any>}
+     * @param {number} referenceId Reference identifier
+     * @returns {Promise<any>} Parsed JSON representation
      */
     serializeReference(referenceId: number): Promise<any>;
     /**
      * Spawns a new reference to an object
-     *
-     * @param {string} id
-     * @returns {Reference}
+     * @param {string} id Reference identifier
+     * @returns {Reference} Reference instance
      */
     spawnReference(id: string): Reference;
     enableServerControl(): void;
 }
+export type ReturnOptions = {
+    returnReference?: boolean;
+    returnResult?: boolean;
+};
+export type ReturnReferenceOptions = ReturnOptions & {
+    returnResult?: false;
+};
+export type ReturnResultOptions = ReturnOptions & {
+    returnResult: true;
+    returnReference?: false;
+};
 import Reference from "./reference.js";
 //# sourceMappingURL=index.d.ts.map

package/build/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.js"],"names":[],"mappings":"AAUA;IACE;;;;;OAKG;IACH,qBAHW,GAAG,YACH;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAC,EA2BzC;IAxBC,aAAsB;IAGtB,kCAAkC;IAClC,kBADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACJ;IAC1B,qBAA0B;IAC1B,8BAA8B;IAE9B,kCAAkC;IAClC,UADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACZ;IAElB,kCAAkC;IAClC,UADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACZ;IAElB,wCAAwC;IACxC,YADW,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAChB;IAEpB,kCAAkC;IAClC,SADW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACb;IAEjB,qBAAqB;IAErB,sBAAsB;IACtB,sBADW,OAAO,CAC8C;IAGlE;;OAEG;IACH,uBAEC;IAED;;;;;;;OAOG;IACH,mCALW,MAAM,cACN,MAAM,WACF,GAAG,EAAA,GACL,OAAO,CAAC,GAAG,CAAC,CAWxB;IAED;;;;;;;OAOG;IACH,gDALW,MAAM,cACN,MAAM,WACF,GAAG,EAAA,GACL,OAAO,CAAC,SAAS,CAAC,CAY9B;IAED;;;;;OAKG;IACH,8BAHW,MAAM,GACJ,OAAO,CAAC,SAAS,CAAC,CAe9B;IAED;;;;;OAKG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,SAAS,CAAC,CAe9B;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,OAAO,CAAC,SAAS,CAAC,CAY9B;IAED;;;;;;OAMG;IACH,kCAJW,MAAM,WACF,GAAG,EAAA,GACL,OAAO,CAAC,SAAS,CAAC,CAe9B;IAED;;;;OAIG;IACH,qBAHW,GAAG,GACD,OAAO,CAQnB;IAED;;;;;;;;OAQG;IACH,YAAa,0EANV;QAAqB,OAAO,EAApB,MAAM;QACO,UAAU,EAAvB,MAAM;QACI,IAAI,EAAd,GAAG;QACW,KAAK,GAAnB,MAAM;QACQ,UAAU,GAAxB,MAAM;KAEkE,UAuPlF;IAED;;;;;OAKG;IACH,cAHW,GAAG,GACD,GAAG,CAwBf;IAED;;;;;;OAMG;IACH,mDAJW,MAAM,iBACN,MAAM,GACJ,OAAO,CAAC,SAAS,CAAC,CAW9B;IAED;;;;;;OAMG;IACH,sCAJW,MAAM,iBACN,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CASxB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,iBACN,GAAG,QAMb;IAED;;;;;OAKG;IACH,+BAHW,MAAM,GACJ,GAAG,CAIf;IAED;;;;;OAKG;IACH,oBAHW,MAAM,GACJ,GAAG,CAIf;IAED;;;;;OAKG;IACH,2BAHW,MAAM,kBACN,GAAG,QAMb;IAED;;;;;OAKG;IACH,iCAHW,MAAM,GACJ,GAAG,CAIf;IAED;;;;OAIG;IACH,4BAHW,MAAM,QACN,GAAG,QAIb;IAED;;;;;OAKG;IACH,qBAJW,MAAM,QACN,GAAG,GACD,OAAO,CAAC,GAAG,CAAC,CAkBxB;IAED;;;OAGG;IACH,WAFW,GAAG,QAIb;IAED;;;;;OAKG;IACH,gCAHW,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CAMxB;IAED;;;;;OAKG;IACH,mBAHW,MAAM,GACJ,SAAS,CAQrB;IAED,4BAEC;CACF;sBApnBqB,gBAAgB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.js"],"names":[],"mappings":"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"}