Set allowNestedFunctions default to false, and added an option to suppress errors when a callback is missing.

Author: xjsdev

index.esm.js

@@ -74,9 +74,10 @@ const recuCopy = (tree, mutable) => {
  */
 const createIorpc = (sendFn, localApi = {}, {
   maxPendingResponses = 10000,
-  allowNestedFunctions = true,
+  allowNestedFunctions = false,
   exposeErrors = true,
-  injectToThis = true
+  injectToThis = true,
+  ignoreCallbackUnavailable = false
 }) => {
   const clbs = {};
   let trimWarningFired = false;
@@ -278,6 +279,7 @@ const createIorpc = (sendFn, localApi = {}, {
       if (isNaN(message.apiFunc)) {
         errMsg = `Function '${message.apiFunc}' is not registered for the iorpc API. Please verify it is properly defined and exposed.`;
       } else {
+        if (ignoreCallbackUnavailable) return;
         errMsg = `Callback '${message.apiFunc}' is unavailable. It might have been removed from the waiting queue (maxPendingResponses overflow) or via unbind().`;
       }
       const e = new Error(errMsg);

index.js

@@ -75,9 +75,10 @@
    */
   const createIorpc = (sendFn, localApi = {}, {
     maxPendingResponses = 10000,
-    allowNestedFunctions = true,
+    allowNestedFunctions = false,
     exposeErrors = true,
-    injectToThis = true
+    injectToThis = true,
+    ignoreCallbackUnavailable = false
   }) => {
     const clbs = {};
     let trimWarningFired = false;
@@ -279,6 +280,7 @@
         if (isNaN(message.apiFunc)) {
           errMsg = `Function '${message.apiFunc}' is not registered for the iorpc API. Please verify it is properly defined and exposed.`;
         } else {
+          if (ignoreCallbackUnavailable) return;
           errMsg = `Callback '${message.apiFunc}' is unavailable. It might have been removed from the waiting queue (maxPendingResponses overflow) or via unbind().`;
         }
         const e = new Error(errMsg);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "iorpc",
-  "version": "9.0.6",
+  "version": "9.1.0",
   "keywords": [
     "rpc",
     "callback",

readme.md

@@ -373,12 +373,14 @@ ws.on('open', async () => {
     }
     cbWithErr.unbind()
 
-    // The ability to pass function references within objects or arrays is implemented. Make sure to unbind them when they are no longer in use.
-    const {fn1, fn2} = await remote.functionWithReturnOfTwoFn()
-    console.log(await fn1()) // fn1
-    console.log(await fn2()) // fn2
-    fn1.unbind()
-    fn2.unbind()
+    if (false) { // works if allowNestedFunctions option is true
+      // The ability to pass function references within objects or arrays is implemented. Make sure to unbind them when they are no longer in use.
+      const {fn1, fn2} = await remote.functionWithReturnOfTwoFn()
+      console.log(await fn1()) // fn1
+      console.log(await fn2()) // fn2
+      fn1.unbind()
+      fn2.unbind()
+    }
     const remoteClbsSize2 = await remote.clbsSize()
     console.log(remoteClbsSize2) // 0
   }, 3000)
@@ -411,9 +413,10 @@ It should accept a callback which will receive parsed message objects.
 `options?: Object` – Optional configuration parameters:
 
 - `maxPendingResponses: number = 10000` – Maximum number of unresolved async calls allowed at once. Prevents overflow. It warns once about an error if the limit is exceeded, and deletes the oldest one used.
-- `allowNestedFunctions: boolean = true` – If true, allows functions to be nested in objects or arrays and passed remotely.
+- `allowNestedFunctions: boolean = false` – If true, allows functions to be nested in objects or arrays and passed remotely.
 - `exposeErrors: boolean = true` – If true, forwards full remote error details (like stack traces). If false, replaces them with a generic message.
 - `injectToThis: boolean = true` – If true, replaces this inside called functions with `this.remoteApi`.
+- `ignoreCallbackUnavailable: boolean = false` – If true, errors due to missing callbacks will be ignored. Useful when integrating multiple interfaces over a single channel.
 
 `Return` - An object with the following properties:
 - `remote: Object` – A proxy object. Accessing `remote.someFunction()` will trigger a remote call to `someFunction` on the other side.