scoundrel-remote-eval 1.0.9 → 1.0.10

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

@@ -22,9 +22,9 @@ export default class WebSocket {
      */
     onSocketMessage: (event: MessageEvent) => void;
     /**
-     * @param {Event} _event
+     * @param {Event} event
      */
-    onSocketOpen: (_event: Event) => void;
+    onSocketOpen: (event: Event) => void;
     /**
      * @param {Record<string, any>} data
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/connections/web-socket/index.js"],"names":[],"mappings":"AAQA;IACE;;;OAGG;IACH,gBAFW,SAAS,EAgBnB;IAbC,cAAY;IAWZ,aAAkB;IAClB,sBAAsB;IAGxB,uBAEC;IAED;;OAEG;IACH,oBAFW,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,QAI7B;IADC,0BAHgB,GAAG,KAAK,IAAI,CAGK;IAGnC;;OAEG;IACH,gBAAiB,OAFN,KAEW,UAErB;IAED;;OAEG;IACH,kBAAmB,OAFR,YAEa,UAUvB;IAED;;OAEG;IACH,eAAgB,QAFL,KAEW,UAErB;IAED;;OAEG;IACH,WAFW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAQ7B;IAED,kCAME;CACH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/connections/web-socket/index.js"],"names":[],"mappings":"AAQA;IACE;;;OAGG;IACH,gBAFW,SAAS,EAgBnB;IAbC,cAAY;IAWZ,aAAkB;IAClB,sBAAsB;IAGxB,uBAEC;IAED;;OAEG;IACH,oBAFW,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,QAI7B;IADC,0BAHgB,GAAG,KAAK,IAAI,CAGK;IAGnC;;OAEG;IACH,gBAAiB,OAFN,KAEW,UAErB;IAED;;OAEG;IACH,kBAAmB,OAFR,YAEa,UAUvB;IAED;;OAEG;IACH,eAAgB,OAFL,KAEU,UAEpB;IAED;;OAEG;IACH,WAFW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAQ7B;IAED,kCAME;CACH"}

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

@@ -26,10 +26,10 @@ export default class WebSocket {
             this.onCommandCallback(data);
         };
         /**
-         * @param {Event} _event
+         * @param {Event} event
          */
-        this.onSocketOpen = (_event) => {
-            logger.log("onSocketOpen");
+        this.onSocketOpen = (event) => {
+            logger.log(() => ["onSocketOpen", event]);
         };
         this.waitForOpened = () => new Promise((resolve, reject) => {
             // @ts-ignore

package/build/client/index.d.ts

@@ -3,8 +3,11 @@ export default class Client {
      * Creates a new Scoundrel Client
      *
      * @param {any} backend The backend connection (e.g., WebSocket)
+     * @param {{enableServerControl?: boolean}} [options]
      */
-    constructor(backend: any);
+    constructor(backend: any, options?: {
+        enableServerControl?: boolean;
+    });
     backend: any;
     /** @type {Record<number, any>} */
     outgoingCommands: Record<number, any>;
@@ -19,6 +22,8 @@ export default class Client {
     /** @type {Record<number, any>} */
     objects: Record<number, any>;
     objectsCount: number;
+    /** @type {boolean} */
+    serverControlEnabled: boolean;
     /**
      * Closes the client connection
      */
@@ -175,6 +180,7 @@ export default class Client {
      * @returns {Reference}
      */
     spawnReference(id: string): Reference;
+    enableServerControl(): void;
 }
 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":"AASA;IACE;;;;OAIG;IACH,qBAFW,GAAG,EAwBb;IArBC,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;IAGvB;;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,CAU9B;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,UA+GlF;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,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,CAexB;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;CACF;sBAjdqB,gBAAgB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.js"],"names":[],"mappings":"AASA;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,CAM9B;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,UAkJlF;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,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,CAexB;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;sBAxfqB,gBAAgB"}

package/build/client/index.js

@@ -8,8 +8,9 @@ export default class Client {
      * Creates a new Scoundrel Client
      *
      * @param {any} backend The backend connection (e.g., WebSocket)
+     * @param {{enableServerControl?: boolean}} [options]
      */
-    constructor(backend) {
+    constructor(backend, options = {}) {
         /**
          * Handles an incoming command from the backend
          * @param {object} args
@@ -25,6 +26,28 @@ export default class Client {
                 if (!command) {
                     throw new Error(`No command key given in data: ${Object.keys(restArgs).join(", ")}`);
                 }
+                else if (command == "command_response") {
+                    if (!(commandID in this.outgoingCommands)) {
+                        throw new Error(`Outgoing command ${commandID} not found: ${Object.keys(this.outgoingCommands).join(", ")}`);
+                    }
+                    const savedCommand = this.outgoingCommands[commandID];
+                    delete this.outgoingCommands[commandID];
+                    if (error) {
+                        const errorToThrow = new Error(error);
+                        if (errorStack) {
+                            errorToThrow.stack = `${errorStack}\n\n${errorToThrow.stack}`;
+                        }
+                        savedCommand.reject(errorToThrow);
+                    }
+                    else {
+                        logger.log(() => [`Resolving command ${commandID} with data`, data]);
+                        savedCommand.resolve(data.data);
+                    }
+                }
+                else if (!this.serverControlEnabled) {
+                    this.send({ command: "command_response", command_id: commandID, error: "Server control is disabled" });
+                    return;
+                }
                 else if (command == "get_object") {
                     const serverObject = this._getRegisteredObject(data.object_name);
                     let object;
@@ -65,7 +88,14 @@ export default class Client {
                     if (!method)
                         throw new Error(`No method called '${data.method_name}' on a '${object.constructor.name}'`);
                     const response = method.call(object, ...data.args);
-                    this.respondToCommand(commandID, { response });
+                    if (data.with == "reference") {
+                        const objectId = ++this.objectsCount;
+                        this.objects[objectId] = response;
+                        this.respondToCommand(commandID, { response: objectId });
+                    }
+                    else {
+                        this.respondToCommand(commandID, { response });
+                    }
                 }
                 else if (command == "serialize_reference") {
                     const referenceId = data.reference_id;
@@ -91,22 +121,30 @@ export default class Client {
                         this.respondToCommand(commandID, { response: attribute });
                     }
                 }
-                else if (command == "command_response") {
-                    if (!(commandID in this.outgoingCommands)) {
-                        throw new Error(`Outgoing command ${commandID} not found: ${Object.keys(this.outgoingCommands).join(", ")}`);
-                    }
-                    const savedCommand = this.outgoingCommands[commandID];
-                    delete this.outgoingCommands[commandID];
-                    if (error) {
-                        const errorToThrow = new Error(error);
-                        if (errorStack) {
-                            errorToThrow.stack = `${errorStack}\n\n${errorToThrow.stack}`;
+                else if (command == "eval") {
+                    const respondWithResult = (evalResult) => {
+                        if (data.with_reference) {
+                            const objectId = ++this.objectsCount;
+                            this.objects[objectId] = evalResult;
+                            this.respondToCommand(commandID, { object_id: objectId });
                         }
-                        savedCommand.reject(errorToThrow);
+                        else {
+                            this.respondToCommand(commandID, { response: evalResult });
+                        }
+                    };
+                    const evalResult = eval(data.eval_string);
+                    if (evalResult && typeof evalResult.then == "function") {
+                        evalResult.then(respondWithResult).catch((promiseError) => {
+                            if (promiseError instanceof Error) {
+                                this.send({ command: "command_response", command_id: commandID, error: promiseError.message, errorStack: promiseError.stack });
+                            }
+                            else {
+                                this.send({ command: "command_response", command_id: commandID, error: String(promiseError) });
+                            }
+                        });
                     }
                     else {
-                        logger.log(() => [`Resolving command ${commandID} with data`, data]);
-                        savedCommand.resolve(data.data);
+                        respondWithResult(evalResult);
                     }
                 }
                 else {
@@ -138,6 +176,8 @@ export default class Client {
         /** @type {Record<number, any>} */
         this.objects = {};
         this.objectsCount = 0;
+        /** @type {boolean} */
+        this.serverControlEnabled = Boolean(options.enableServerControl);
     }
     /**
      * Closes the client connection
@@ -187,12 +227,8 @@ export default class Client {
      * @returns {Promise<Reference>}
      */
     async evalWithReference(evalString) {
-        const result = await this.sendCommand("eval", {
-            eval_string: evalString,
-            with_reference: true
-        });
-        const id = result.object_id;
-        return this.spawnReference(id);
+        const evalReference = await this.getObject("eval");
+        return await evalReference.callMethodWithReference("call", null, evalString);
     }
     /**
      * Imports a module and returns a reference to it
@@ -410,4 +446,7 @@ export default class Client {
         this.references[id] = reference;
         return reference;
     }
+    enableServerControl() {
+        this.serverControlEnabled = true;
+    }
 }

package/build/client/reference-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference-proxy.d.ts","sourceRoot":"","sources":["../../src/client/reference-proxy.js"],"names":[],"mappings":";AA8CA;;;GAGG;AACH,+CAHW,GAAG,oBAGwE"}
+{"version":3,"file":"reference-proxy.d.ts","sourceRoot":"","sources":["../../src/client/reference-proxy.js"],"names":[],"mappings":";AAyCA;;;GAGG;AACH,+CAHW,GAAG,oBAGwE"}

package/build/client/reference-proxy.js

@@ -27,14 +27,10 @@ const proxyObjectHandler = {
      * @param {any} newValue
      */
     set(receiver, prop, newValue) {
+        void receiver;
+        void prop;
+        void newValue;
         throw new Error("set property isn't supported yet");
-        // @ts-expect-error
-        if (typeof receiver == "function")
-            receiver = receiver(); // eslint-disable-line no-unreachable
-        // @ts-expect-error
-        if (!(prop in receiver))
-            throw new PropertyNotFoundError(`Property not found: ${prop}`); // eslint-disable-line no-undef
-        return Reflect.set(receiver, prop, newValue);
     }
 };
 /**

package/build/server/index.d.ts

@@ -8,13 +8,20 @@ export default class ScoundrelServer {
     /** @type {Client[]} */
     clients: Client[];
     events: EventEmitter<any>;
+    /** @type {SingleEventEmitter<(client: Client) => void>} */
+    onNewClientEventEmitter: SingleEventEmitter<(client: Client) => void>;
+    onNewClient: (listener: (client: Client) => void) => void;
+    /** @returns {void} */
     close(): void;
+    /** @returns {Client[]} */
     getClients(): Client[];
     /**
      * @param {import("./connections/web-socket/client.js").default} clientBackend
+     * @returns {void}
      */
-    onNewClient: (clientBackend: import("./connections/web-socket/client.js").default) => void;
+    onNewClientFromBackend: (clientBackend: import("./connections/web-socket/client.js").default) => void;
 }
 import Client from "../client/index.js";
 import EventEmitter from "events";
+import SingleEventEmitter from "../utils/single-event-emitter.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.js"],"names":[],"mappings":"AAKA;IACE;;;OAGG;IACH,qBAFW,OAAO,mCAAmC,EAAE,OAAO,EAU7D;IAPC,6DAAsB;IAGtB,uBAAuB;IACvB,SADW,MAAM,EAAE,CACF;IAEjB,0BAAgC;IAGlC,cAAgC;IAChC,uBAAoC;IAEpC;;OAEG;IACH,cAAe,eAFJ,OAAO,oCAAoC,EAAE,OAE5B,UAK3B;CACF;mBA9BkB,oBAAoB;yBACd,QAAQ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.js"],"names":[],"mappings":"AAMA;IACE;;;OAGG;IACH,qBAFW,OAAO,mCAAmC,EAAE,OAAO,EAc7D;IAXC,6DAAsB;IAGtB,uBAAuB;IACvB,SADW,MAAM,EAAE,CACF;IAEjB,0BAAgC;IAEhC,2DAA2D;IAC3D,yBADW,kBAAkB,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CACA;IACvD,iCAFuC,MAAM,KAAK,IAAI,UAEK;IAG7D,sBAAsB;IACtB,SADc,IAAI,CACc;IAEhC,0BAA0B;IAC1B,cADc,MAAM,EAAE,CACc;IAEpC;;;OAGG;IACH,yBAA0B,eAHf,OAAO,oCAAoC,EAAE,OAGjB,KAF1B,IAAI,CAShB;CACF;mBAzCkB,oBAAoB;yBACd,QAAQ;+BACF,kCAAkC"}

package/build/server/index.js

@@ -1,6 +1,7 @@
 // @ts-check
 import Client from "../client/index.js";
 import EventEmitter from "events";
+import SingleEventEmitter from "../utils/single-event-emitter.js";
 export default class ScoundrelServer {
     /**
      * Creates a new Scoundrel server
@@ -9,18 +10,25 @@ export default class ScoundrelServer {
     constructor(backend) {
         /**
          * @param {import("./connections/web-socket/client.js").default} clientBackend
+         * @returns {void}
          */
-        this.onNewClient = (clientBackend) => {
-            const client = new Client(clientBackend);
+        this.onNewClientFromBackend = (clientBackend) => {
+            const client = new Client(clientBackend, { enableServerControl: true });
             this.clients.push(client);
             this.events.emit("newClient", client);
+            this.onNewClientEventEmitter.emit([client]);
         };
         this.backend = backend;
-        this.backend.onNewClient(this.onNewClient);
+        this.backend.onNewClient(this.onNewClientFromBackend);
         /** @type {Client[]} */
         this.clients = [];
         this.events = new EventEmitter();
+        /** @type {SingleEventEmitter<(client: Client) => void>} */
+        this.onNewClientEventEmitter = new SingleEventEmitter();
+        this.onNewClient = this.onNewClientEventEmitter.connector();
     }
+    /** @returns {void} */
     close() { this.backend.close(); }
+    /** @returns {Client[]} */
     getClients() { return this.clients; }
 }

package/build/utils/single-event-emitter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SingleEventEmitter: one listener at a time, strongly typed via JSDoc.
+ *
+ * @template {(...args: any[]) => any} Listener
+ */
+export default class SingleEventEmitter<Listener extends (...args: any[]) => any> {
+    /**
+     * @param {{ strict?: boolean }=} options
+     *  - strict (default true): throw if a listener is already connected
+     */
+    constructor(options?: {
+        strict?: boolean;
+    } | undefined);
+    /**
+     * Connect a listener (type-checked).
+     * @param {Listener} listener
+     * @returns {void}
+     */
+    connect(listener: Listener): void;
+    /**
+     * Disconnect only if the same listener is currently connected.
+     * @param {Listener} listener
+     * @returns {void}
+     */
+    disconnect(listener: Listener): void;
+    /** @returns {void} */
+    clear(): void;
+    /** @returns {boolean} */
+    hasListener(): boolean;
+    /**
+     * Emit the event to the connected listener (if any).
+     * Arguments are type-checked against Listener parameters.
+     * @param {...Parameters<Listener>} args
+     * @returns {boolean} true if a listener was called
+     */
+    emit(...args: Parameters<Listener>[]): boolean;
+    /**
+     * Create a "connect method" you can expose as `onNewClient` etc.
+     * The returned function is type-checked as (listener: Listener) => void.
+     *
+     * @returns {(listener: Listener) => void}
+     */
+    connector(): (listener: Listener) => void;
+    #private;
+}
+//# sourceMappingURL=single-event-emitter.d.ts.map

package/build/utils/single-event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-event-emitter.d.ts","sourceRoot":"","sources":["../../src/utils/single-event-emitter.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wCAFuC,QAAQ,SAAlC,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAI;IASpC;;;OAGG;IACH,sBAHW;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,YAAC,EAK/B;IAED;;;;OAIG;IACH,kBAHW,QAAQ,GACN,IAAI,CAOhB;IAED;;;;OAIG;IACH,qBAHW,QAAQ,GACN,IAAI,CAIhB;IAED,sBAAsB;IACtB,SADc,IAAI,CAGjB;IAED,yBAAyB;IACzB,eADc,OAAO,CAGpB;IAED;;;;;OAKG;IACH,cAHc,UAAU,CAAC,QAAQ,CAAC,EAAA,GACrB,OAAO,CAOnB;IAED;;;;;OAKG;IACH,aAFa,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAKxC;;CACF"}

package/build/utils/single-event-emitter.js

@@ -0,0 +1,86 @@
+// @ts-check
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SingleEventEmitter_listener, _SingleEventEmitter_strict;
+/**
+ * SingleEventEmitter: one listener at a time, strongly typed via JSDoc.
+ *
+ * @template {(...args: any[]) => any} Listener
+ */
+class SingleEventEmitter {
+    /**
+     * @param {{ strict?: boolean }=} options
+     *  - strict (default true): throw if a listener is already connected
+     */
+    constructor(options) {
+        /** @type {Listener | null} */
+        _SingleEventEmitter_listener.set(this, null
+        /** @type {boolean} */
+        );
+        /** @type {boolean} */
+        _SingleEventEmitter_strict.set(this, void 0);
+        __classPrivateFieldSet(this, _SingleEventEmitter_strict, options?.strict ?? true, "f");
+    }
+    /**
+     * Connect a listener (type-checked).
+     * @param {Listener} listener
+     * @returns {void}
+     */
+    connect(listener) {
+        if (__classPrivateFieldGet(this, _SingleEventEmitter_listener, "f") && __classPrivateFieldGet(this, _SingleEventEmitter_strict, "f")) {
+            throw new Error("SingleEventEmitter already has a listener connected");
+        }
+        __classPrivateFieldSet(this, _SingleEventEmitter_listener, listener, "f");
+    }
+    /**
+     * Disconnect only if the same listener is currently connected.
+     * @param {Listener} listener
+     * @returns {void}
+     */
+    disconnect(listener) {
+        if (__classPrivateFieldGet(this, _SingleEventEmitter_listener, "f") === listener)
+            __classPrivateFieldSet(this, _SingleEventEmitter_listener, null, "f");
+    }
+    /** @returns {void} */
+    clear() {
+        __classPrivateFieldSet(this, _SingleEventEmitter_listener, null, "f");
+    }
+    /** @returns {boolean} */
+    hasListener() {
+        return __classPrivateFieldGet(this, _SingleEventEmitter_listener, "f") !== null;
+    }
+    /**
+     * Emit the event to the connected listener (if any).
+     * Arguments are type-checked against Listener parameters.
+     * @param {...Parameters<Listener>} args
+     * @returns {boolean} true if a listener was called
+     */
+    emit(...args) {
+        const fn = __classPrivateFieldGet(this, _SingleEventEmitter_listener, "f");
+        if (!fn)
+            return false;
+        fn(...args);
+        return true;
+    }
+    /**
+     * Create a "connect method" you can expose as `onNewClient` etc.
+     * The returned function is type-checked as (listener: Listener) => void.
+     *
+     * @returns {(listener: Listener) => void}
+     */
+    connector() {
+        // bind() keeps `this`, and the return type is enforced by the JSDoc above
+        return this.connect.bind(this);
+    }
+}
+_SingleEventEmitter_listener = new WeakMap(), _SingleEventEmitter_strict = new WeakMap();
+export default SingleEventEmitter;

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "scoundrel-remote-eval",
   "type": "module",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": ["build/**"],
   "scripts": {
+    "all-checks": "npm run typecheck && npm run lint && npm run test",
     "build": "rm -rf build && tsc",
     "lint": "eslint",
     "prepublishOnly": "npm run build",