From 6a310de70810210528427fa20b58fdef632f2af0 Mon Sep 17 00:00:00 2001
From: Skylar Sadlier <skylord123@gmail.com>
Date: Fri, 3 Sep 2021 08:24:02 -0600
Subject: [PATCH 1/4] Closes #21 - Can now access the matrix client globally so
 it can be used in function nodes (this way you are not limited by only the
 nodes we have published) - Added example for using the Matrix Client in a
 function to redact messages. This should be a great example to show people
 what is possible.

---
 README.md                                 |   5 +
 examples/README.md                        |  13 +++
 examples/custom-redact-function-node.json | 113 ++++++++++++++++++++++
 examples/custom-redact-function-node.png  | Bin 0 -> 18565 bytes
 src/matrix-server-config.html             |  19 +++-
 src/matrix-server-config.js               |  10 ++
 6 files changed, 158 insertions(+), 2 deletions(-)
 create mode 100644 examples/custom-redact-function-node.json
 create mode 100644 examples/custom-redact-function-node.png

diff --git a/README.md b/README.md
index f70d2ac..399e022 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,11 @@ You can either install from within Node-RED by searching for `node-red-contrib-m
 npm install node-red-contrib-matrix-chat
 ```
 
+### Extra functionality
+You are not limited by just the nodes we have created. If you turn on global access when setting up your Matrix Client you can access the client directly from any function node to write your own logic.
+
+View an example [here](https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#use-function-node-to-run-any-command)
+
 ### End-to-End Encryption Notes
 Currently this module has no way of getting encryption keys from other devices on the same account. Therefore it is recommended you use the bot exclusively with Node-RED after it's creation. Failure to do so will lead to your bot being unable to receive messages from e2ee rooms it joined from another client. Shared secret registration makes this super easy since it returns a token and device ID.
 
diff --git a/examples/README.md b/examples/README.md
index 8c1dae2..b1b51b7 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -9,6 +9,7 @@ Build something cool with these nodes? Feel free to submit a pull request to sha
 
 - [Create User with Shared Secret Registration](#create-user-with-shared-secret-registration)
 - [Create/Edit Synapse User](#createedit-synapse-user)
+- [Use function node to run any command](#use-function-node-to-run-any-command)
 - [Respond to "ping" with "pong"](#respond-to-ping-with-pong)
 - [Respond to "html" with an HTML message](#respond-to-html-with-an-html-message)
 - [Respond to "image" with an uploaded image](#respond-to-image-with-an-uploaded-image)
@@ -39,6 +40,18 @@ Allows an administrator to create or modify a user account with a specified `msg
 ![img.png](add-user-with-admin-user.png)
 
 
+### Use function node to run any command
+
+[View JSON](acustom-redact-function-node.json)
+
+If we do not have a node for something you want to do (such as redacting events/messages) you can do this manually with a function node.
+
+**Note:** You should make sure to catch any errors in your function node otherwise you could cause Node-RED to crash.
+
+To view what sort of functions you have access to check out the `client.ts` file from `matrix-js-sdk` [here](https://github.com/matrix-org/matrix-js-sdk/blob/master/src/client.ts).
+
+![img.png](custom-redact-function-node.png)
+
 ### Respond to "ping" with "pong"
 
 [View JSON](respond-to-html-with-html.json)
diff --git a/examples/custom-redact-function-node.json b/examples/custom-redact-function-node.json
new file mode 100644
index 0000000..a4af92d
--- /dev/null
+++ b/examples/custom-redact-function-node.json
@@ -0,0 +1,113 @@
+[
+  {
+    "id": "89eed7ddf7a96070",
+    "type": "function",
+    "z": "f025a8b9fbd1b054",
+    "name": "Redact Message",
+    "func": "let matrixClient = global.get(\"matrixClient['@bot:example.com']\"),\n    matrixOnline = global.get(\"matrixClientOnline['@bot:example.com']\");\n\nif(!matrixOnline) {\n    msg.error = 'Matrix client not connected.';\n    return [null, msg];\n}\n    \nmatrixClient.redactEvent(msg.topic, msg.eventId, undefined, {\n    reason: 'Redacted, muhahaha!'\n})\n    .then(function(e) {\n        msg.eventId = e.eventId;\n        node.send([msg, null]);\n    })\n    .catch(function(e){\n        node.warn(\"Error sending message \" + e);\n        msg.error = e;\n        node.send([null, msg]);\n    });",
+    "outputs": 2,
+    "noerr": 0,
+    "initialize": "",
+    "finalize": "",
+    "libs": [],
+    "x": 730,
+    "y": 1580,
+    "wires": [
+      [
+        "5decd492e2da79d9"
+      ],
+      [
+        "fadcf8c32bdfd8be"
+      ]
+    ]
+  },
+  {
+    "id": "5decd492e2da79d9",
+    "type": "debug",
+    "z": "f025a8b9fbd1b054",
+    "name": "",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 890,
+    "y": 1560,
+    "wires": []
+  },
+  {
+    "id": "f3636f4221511a81",
+    "type": "comment",
+    "z": "f025a8b9fbd1b054",
+    "name": "If message is \"redact\" then redact the message.",
+    "info": "",
+    "x": 420,
+    "y": 1540,
+    "wires": []
+  },
+  {
+    "id": "9f777828840bb9a2",
+    "type": "matrix-receive",
+    "z": "f025a8b9fbd1b054",
+    "name": "",
+    "roomId": "",
+    "acceptText": true,
+    "acceptEmotes": false,
+    "acceptStickers": false,
+    "acceptReactions": false,
+    "acceptFiles": false,
+    "acceptImages": false,
+    "x": 320,
+    "y": 1580,
+    "wires": [
+      [
+        "21a00b09f8c85399"
+      ]
+    ]
+  },
+  {
+    "id": "21a00b09f8c85399",
+    "type": "switch",
+    "z": "f025a8b9fbd1b054",
+    "name": "filter on msg.payload",
+    "property": "payload",
+    "propertyType": "msg",
+    "rules": [
+      {
+        "t": "eq",
+        "v": "redact",
+        "vt": "str"
+      }
+    ],
+    "checkall": "true",
+    "repair": false,
+    "outputs": 1,
+    "x": 520,
+    "y": 1580,
+    "wires": [
+      [
+        "89eed7ddf7a96070"
+      ]
+    ]
+  },
+  {
+    "id": "fadcf8c32bdfd8be",
+    "type": "debug",
+    "z": "f025a8b9fbd1b054",
+    "name": "",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 890,
+    "y": 1600,
+    "wires": []
+  }
+]
\ No newline at end of file
diff --git a/examples/custom-redact-function-node.png b/examples/custom-redact-function-node.png
new file mode 100644
index 0000000000000000000000000000000000000000..a5c1f300c824bd41a9beea3dcc2a92ea923d6adb
GIT binary patch
literal 18565
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

literal 0
HcmV?d00001

diff --git a/src/matrix-server-config.html b/src/matrix-server-config.html
index fc77518..1e6fffc 100644
--- a/src/matrix-server-config.html
+++ b/src/matrix-server-config.html
@@ -11,7 +11,8 @@
         defaults: {
             name: { value: null },
             autoAcceptRoomInvites: { value: true },
-            enableE2ee: { type: "checkbox", value: true }
+            enableE2ee: { type: "checkbox", value: true },
+            global: { type: "checkbox", value: true }
         },
         icon: "matrix.png",
         label: function() {
@@ -67,10 +68,24 @@
             Enable end-to-end encryption (requires DeviceID)
         </label>
     </div>
-
     <div class="form-tips" style="margin-bottom: 12px;">
         E2ee requires a Device ID to be set.
     </div>
+
+    <div class="form-row">
+        <input
+                type="checkbox"
+                id="node-config-input-global"
+                style="width: auto; margin-left: 125px; vertical-align: top"
+        />
+        <label for="node-config-input-global" style="width: auto">
+            Global access to Matrix Client
+        </label>
+        <div class="form-tips" style="margin-bottom: 12px;">
+            If enabled this allows you to access the matrix client directly with a Function node. This way you can do whatever you want with the client.<br />
+            Example: <code>let client = global.get("matrixClient['@bot:example.com']")</code>
+        </div>
+    </div>
 </script>
 
 <script type="text/html" data-help-name="matrix-server-config">
diff --git a/src/matrix-server-config.js b/src/matrix-server-config.js
index 68f8b17..7dfbdb2 100644
--- a/src/matrix-server-config.js
+++ b/src/matrix-server-config.js
@@ -34,6 +34,7 @@ module.exports = function(RED) {
         this.autoAcceptRoomInvites = n.autoAcceptRoomInvites;
         this.enableE2ee = n.enableE2ee || false;
         this.e2ee = (this.enableE2ee && this.deviceId);
+        this.globalAccess = n.global;
 
         if(!this.credentials.accessToken) {
             node.log("Matrix connection failed: missing access token.");
@@ -56,6 +57,11 @@ module.exports = function(RED) {
                 deviceId: this.deviceId || undefined,
             });
 
+            // set globally if configured to do so
+            if(this.globalAccess) {
+                this.context().global.set('matrixClient["'+this.userId+'"]', node.matrixClient);
+            }
+
             node.on('close', function(done) {
                 if(node.matrixClient) {
                     node.matrixClient.close();
@@ -75,6 +81,10 @@ module.exports = function(RED) {
                     } else {
                         node.emit("disconnected");
                     }
+
+                    if(this.globalAccess) {
+                        this.context().global.set('matrixClientOnline["'+this.userId+'"]', connected);
+                    }
                 }
             };
 

From f70d73b01130987ce3435765de8ee417faf8538e Mon Sep 17 00:00:00 2001
From: Skylar Sadlier <skylord123@gmail.com>
Date: Fri, 3 Sep 2021 08:26:46 -0600
Subject: [PATCH 2/4] - Fix typo in example json file name

---
 examples/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/README.md b/examples/README.md
index b1b51b7..97ab4b3 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -42,7 +42,7 @@ Allows an administrator to create or modify a user account with a specified `msg
 
 ### Use function node to run any command
 
-[View JSON](acustom-redact-function-node.json)
+[View JSON](custom-redact-function-node.json)
 
 If we do not have a node for something you want to do (such as redacting events/messages) you can do this manually with a function node.
 

From fa92f793041f847b1401cbf1140855413a901626 Mon Sep 17 00:00:00 2001
From: Skylar Sadlier <skylord123@gmail.com>
Date: Fri, 3 Sep 2021 08:28:27 -0600
Subject: [PATCH 3/4] Move installing section of readme above usage

---
 README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 399e022..586a9cc 100644
--- a/README.md
+++ b/README.md
@@ -30,9 +30,6 @@ The following is supported from this package:
 
 Therefore, you can easily build a bot, chat relay, or administrate your Matrix server from within [Node-RED](https://nodered.org/).
 
-### Usage
-We have examples! [Check them out](https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#readme)
-
 ### Installing
 
 You can either install from within Node-RED by searching for `node-red-contrib-matrix-chat` or run this from within your Node-RED directory:
@@ -40,13 +37,16 @@ You can either install from within Node-RED by searching for `node-red-contrib-m
 npm install node-red-contrib-matrix-chat
 ```
 
-### Extra functionality
+### Usage
+We have examples! [Check them out](https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#readme)
+
+#### Extra functionality
 You are not limited by just the nodes we have created. If you turn on global access when setting up your Matrix Client you can access the client directly from any function node to write your own logic.
 
 View an example [here](https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#use-function-node-to-run-any-command)
 
 ### End-to-End Encryption Notes
-Currently this module has no way of getting encryption keys from other devices on the same account. Therefore it is recommended you use the bot exclusively with Node-RED after it's creation. Failure to do so will lead to your bot being unable to receive messages from e2ee rooms it joined from another client. Shared secret registration makes this super easy since it returns a token and device ID.
+Currently, this module has no way of getting encryption keys from other devices on the same account. Therefore it is recommended you use the bot exclusively with Node-RED after it's creation. Failure to do so will lead to your bot being unable to receive messages from e2ee rooms it joined from another client. Shared secret registration makes this super easy since it returns a token and device ID.
 
 This module stores a folder in your Node-RED directory called `matrix-client-storage` and is it vital that you periodically back this up if you are using e2ee. This is where the client stores all the keys necessary to decrypt messages and if lost you will lose access to e2e rooms. If you move your client to another NR install make sure to migrate this folder as well (and do not let both the old and new client run at same time).
 

From ff6622268799c80e8e7bb572b96f1701c30abda8 Mon Sep 17 00:00:00 2001
From: Skylar Sadlier <skylord123@gmail.com>
Date: Fri, 3 Sep 2021 08:43:13 -0600
Subject: [PATCH 4/4] Fix global variable for matrix client online status not
 setting to false when connection fails

---
 src/matrix-server-config.js | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/src/matrix-server-config.js b/src/matrix-server-config.js
index 7dfbdb2..de2555e 100644
--- a/src/matrix-server-config.js
+++ b/src/matrix-server-config.js
@@ -26,7 +26,7 @@ module.exports = function(RED) {
 
         node.setMaxListeners(1000);
 
-        this.connected = false;
+        this.connected = null;
         this.name = n.name;
         this.userId = this.credentials.userId;
         this.deviceId = this.credentials.deviceId || null;
@@ -43,6 +43,23 @@ module.exports = function(RED) {
         } else if(!this.userId) {
             node.log("Matrix connection failed: missing user ID.");
         } else {
+            node.setConnected = function(connected) {
+                if (node.connected !== connected) {
+                    node.connected = connected;
+                    if (connected) {
+                        node.log("Matrix server connection ready.");
+                        node.emit("connected");
+                    } else {
+                        node.emit("disconnected");
+                    }
+
+                    if(this.globalAccess) {
+                        this.context().global.set('matrixClientOnline["'+this.userId+'"]', connected);
+                    }
+                }
+            };
+            node.setConnected(false);
+
             let localStorageDir = storageDir + '/' + MatrixFolderNameFromUserId(this.userId);
 
             fs.ensureDirSync(storageDir); // create storage directory if it doesn't exist
@@ -72,22 +89,6 @@ module.exports = function(RED) {
                 done();
             });
 
-            node.setConnected = function(connected) {
-                if (node.connected !== connected) {
-                    node.connected = connected;
-                    if (connected) {
-                        node.log("Matrix server connection ready.");
-                        node.emit("connected");
-                    } else {
-                        node.emit("disconnected");
-                    }
-
-                    if(this.globalAccess) {
-                        this.context().global.set('matrixClientOnline["'+this.userId+'"]', connected);
-                    }
-                }
-            };
-
             node.isConnected = function() {
                 return node.connected;
             };