@momo2555/koppeliajs 0.0.167 → 0.0.169

package/dist/scripts/customCallback.d.ts

@@ -1,11 +1,20 @@
 import type { Console } from "./console.js";
 /**
  * Manages the registration and network-wide execution of custom callbacks.
- * Allows different nodes in the system to broadcast and react to custom function calls.
+ * Supports multiple listeners for the same callback name.
  */
 export declare class CustomCallbacks {
     private _console;
-    private _customCallbacks;
+    /**
+     * Internal storage for callbacks.
+     * _registry: Map<uniqueId, { name: string, func: Function }>
+     */
+    private _registry;
+    /**
+     * Quick lookup to find all unique IDs associated with a specific callback name.
+     * _nameToIds: Map<callbackName, Set<uniqueId>>
+     */
+    private _nameToIds;
     constructor(console: Console);
     /**
      * Broadcasts a request across the network to execute a registered custom callback.
@@ -19,13 +28,26 @@ export declare class CustomCallbacks {
      * Registers a local function to be executed when a specific custom callback request is received.
      * @param name The identifier name for this callback.
      * @param callback The function to execute when triggered by the network.
+     * @returns A unique ID for this specific registration.
      */
     registerCustomCallback(name: string, callback: (args: {
         [key: string]: any;
-    }) => void): void;
+    }) => void): string;
     /**
-     * Removes a previously registered custom callback from the local listener registry.
-     * @param name The identifier name of the callback to remove.
+     * Removes all listeners registered under a specific callback name.
+     * @param name The identifier name of the callbacks to remove.
      */
     unregisterCustomCallback(name: string): void;
+    /**
+     * Removes a specific listener using its unique registration ID.
+     * @param id The unique identifier returned by registerCustomCallback.
+     * @returns True if the callback was found and removed, false otherwise.
+     */
+    unregisterById(id: string): boolean;
+    /**
+     * Internal method to trigger all local functions associated with a callback name.
+     * @param name The callback name received from the network.
+     * @param args The arguments received from the network.
+     */
+    private _executeLocalCallbacks;
 }

package/dist/scripts/customCallback.js

@@ -2,22 +2,28 @@ import { logger } from "./logger.js";
 import { Message, MessageType, PeerType } from "./message.js";
 /**
  * Manages the registration and network-wide execution of custom callbacks.
- * Allows different nodes in the system to broadcast and react to custom function calls.
+ * Supports multiple listeners for the same callback name.
  */
 export class CustomCallbacks {
     _console;
-    _customCallbacks;
+    /**
+     * Internal storage for callbacks.
+     * _registry: Map<uniqueId, { name: string, func: Function }>
+     */
+    _registry;
+    /**
+     * Quick lookup to find all unique IDs associated with a specific callback name.
+     * _nameToIds: Map<callbackName, Set<uniqueId>>
+     */
+    _nameToIds;
     constructor(console) {
         this._console = console;
-        this._console.onReady(() => {
-        });
-        this._customCallbacks = {};
+        this._registry = new Map();
+        this._nameToIds = new Map();
         this._console.onDataExchange((from, data) => {
             if (data.customCallbackName != undefined &&
                 data.customCallbackArgs != undefined) {
-                if (Object.hasOwn(this._customCallbacks, data.customCallbackName)) {
-                    this._customCallbacks[data.customCallbackName](data.customCallbackArgs);
-                }
+                this._executeLocalCallbacks(data.customCallbackName, data.customCallbackArgs);
             }
         });
     }
@@ -38,17 +44,74 @@ export class CustomCallbacks {
      * Registers a local function to be executed when a specific custom callback request is received.
      * @param name The identifier name for this callback.
      * @param callback The function to execute when triggered by the network.
+     * @returns A unique ID for this specific registration.
      */
     registerCustomCallback(name, callback) {
-        this._customCallbacks[name] = callback;
+        const id = Math.random().toString(36).substring(2, 15);
+        // Register the function in the main registry
+        this._registry.set(id, { name, func: callback });
+        // Add the ID to the name-based lookup table
+        if (!this._nameToIds.has(name)) {
+            this._nameToIds.set(name, new Set());
+        }
+        this._nameToIds.get(name).add(id);
+        return id;
     }
     /**
-     * Removes a previously registered custom callback from the local listener registry.
-     * @param name The identifier name of the callback to remove.
+     * Removes all listeners registered under a specific callback name.
+     * @param name The identifier name of the callbacks to remove.
      */
     unregisterCustomCallback(name) {
-        if (Object.hasOwn(this._customCallbacks, name)) {
-            delete this._customCallbacks[name];
+        const ids = this._nameToIds.get(name);
+        if (ids) {
+            for (const id of ids) {
+                this._registry.delete(id);
+            }
+            this._nameToIds.delete(name);
+        }
+    }
+    /**
+     * Removes a specific listener using its unique registration ID.
+     * @param id The unique identifier returned by registerCustomCallback.
+     * @returns True if the callback was found and removed, false otherwise.
+     */
+    unregisterById(id) {
+        const entry = this._registry.get(id);
+        if (entry) {
+            const { name } = entry;
+            // Remove from the main registry
+            this._registry.delete(id);
+            // Remove from the name-based lookup table
+            const ids = this._nameToIds.get(name);
+            if (ids) {
+                ids.delete(id);
+                if (ids.size === 0) {
+                    this._nameToIds.delete(name);
+                }
+            }
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Internal method to trigger all local functions associated with a callback name.
+     * @param name The callback name received from the network.
+     * @param args The arguments received from the network.
+     */
+    _executeLocalCallbacks(name, args) {
+        const ids = this._nameToIds.get(name);
+        if (ids) {
+            for (const id of ids) {
+                const entry = this._registry.get(id);
+                if (entry) {
+                    try {
+                        entry.func(args);
+                    }
+                    catch (error) {
+                        logger.log(`Error executing custom callback "${name}" (ID: ${id}):`, error);
+                    }
+                }
+            }
         }
     }
 }

package/dist/scripts/device.d.ts

@@ -41,6 +41,11 @@ export declare class Device {
      * @param callback Function to execute with the incoming speed data.
      */
     onBiking(callback: (speed: number) => void): string;
+    /**
+     * Enables the biking module and listens for speed updates.
+     * @param callback Function to execute with the incoming speed data.
+     */
+    onRotation(callback: (omega: number) => void): string;
     /**
      * Enables the vertical detector module and listens for orientation updates.
      * @param callback Function to execute with the boolean vertical state.

package/dist/scripts/device.js

@@ -78,6 +78,21 @@ export class Device {
         this._callbackIds.push(callbackId);
         return callbackId;
     }
+    /**
+     * Enables the biking module and listens for speed updates.
+     * @param callback Function to execute with the incoming speed data.
+     */
+    onRotation(callback) {
+        this._enableModule("rot");
+        this._attachEvent("rotation");
+        let callbackId = this._console.onRequest((request, params, form, address) => {
+            if (request == "rotation" && address == this._address) {
+                callback(params.omega);
+            }
+        });
+        this._callbackIds.push(callbackId);
+        return callbackId;
+    }
     /**
      * Enables the vertical detector module and listens for orientation updates.
      * @param callback Function to execute with the boolean vertical state.

package/dist/scripts/koppelia.d.ts

@@ -240,10 +240,15 @@ export declare class Koppelia {
      */
     on(callbackName: string, callback: (args: {
         [key: string]: any;
-    }) => void): void;
+    }) => void): string;
     /**
      * Unregisters a locally listening custom callback.
-     * @param callbackName The identifier of the callback to remove.
+     * @param callbackName The name of the callbacks to remove.
      */
     unsub(callbackName: string): void;
+    /**
+     * Unregisters a locally listening custom callback using its unique ID
+     * @param callbackId The identifier of the callback to remove.
+     */
+    unsubById(callbackId: string): void;
 }

package/dist/scripts/koppelia.js

@@ -518,13 +518,20 @@ export class Koppelia {
      * @param callback The local function to execute.
      */
     on(callbackName, callback) {
-        this._callbacks.registerCustomCallback(callbackName, callback);
+        return this._callbacks.registerCustomCallback(callbackName, callback);
     }
     /**
      * Unregisters a locally listening custom callback.
-     * @param callbackName The identifier of the callback to remove.
+     * @param callbackName The name of the callbacks to remove.
      */
     unsub(callbackName) {
         this._callbacks.unregisterCustomCallback(callbackName);
     }
+    /**
+     * Unregisters a locally listening custom callback using its unique ID
+     * @param callbackId The identifier of the callback to remove.
+     */
+    unsubById(callbackId) {
+        this._callbacks.unregisterById(callbackId);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@momo2555/koppeliajs",
-	"version": "0.0.167",
+	"version": "0.0.169",
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run package",