Compare commits
39 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
d0ba671452 | ||
|
|
282c8ffc80 | ||
|
|
6dd2ec75f0 | ||
|
|
ae386b90a6 | ||
|
|
4d1ec9e65c | ||
|
|
2fcd463eb6 | ||
|
|
b44629c84e | ||
|
|
9f0a962991 | ||
|
|
f3df8c6f97 | ||
|
|
d6ab098063 | ||
|
|
614920c40c | ||
|
|
58d7d23b2f | ||
|
|
25c92b787a | ||
|
|
0b9c59a7be | ||
|
|
9c836c9262 | ||
|
|
9c62a73b15 | ||
|
|
447b18835c | ||
|
|
2341cbef10 | ||
|
|
73d802ff0d | ||
|
|
cf1bd78ee1 | ||
|
|
a10667a0e8 | ||
|
|
aaecaaec39 | ||
|
|
be5416a68e | ||
|
|
f8c5344a4e | ||
|
|
3c99bf21a9 | ||
|
|
63728d86a5 | ||
|
|
ff66222687 | ||
|
|
fa92f79304 | ||
|
|
f70d73b011 | ||
|
|
6a310de708 | ||
|
|
d5519a6828 | ||
|
|
2cf8ba1e67 | ||
|
|
9d080b6c1a | ||
|
|
755e18da50 | ||
|
|
4bd2dce434 | ||
|
|
b698389491 | ||
|
|
14badaeeb5 | ||
|
|
ae7e766a98 | ||
|
|
daafe33e86 |
21
README.md
21
README.md
@@ -3,6 +3,8 @@ Matrix chat server client for [Node-RED](https://nodered.org/)
|
||||
|
||||
***Currently we are in beta. We ask that you open any issues you have on our repository to help us reach a stable well tested version. Things may change & break before our first release so check changelog before updating.***
|
||||
|
||||
If you need help with this feel free to join our public matrix room at [#node-red-contrib-matrix-chat:skylar.tech](https://app.element.io/#/room/#node-red-contrib-matrix-chat:skylar.tech)
|
||||
|
||||
### Features
|
||||
|
||||
The following is supported from this package:
|
||||
@@ -30,9 +32,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,10 +39,18 @@ You can either install from within Node-RED by searching for `node-red-contrib-m
|
||||
npm install node-red-contrib-matrix-chat
|
||||
```
|
||||
|
||||
### 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.
|
||||
### Usage
|
||||
We have examples! [Check them out](https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#readme)
|
||||
|
||||
This module stores a folder in your Node-RED directory called `matrix-local-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).
|
||||
#### 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.
|
||||
|
||||
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).
|
||||
|
||||
Want to contribute? Any help on getting the last pieces of e2ee figured out would be greatly appreciated :)
|
||||
|
||||
@@ -61,4 +68,4 @@ You will need a user to use this module. Luckily this module comes with a node t
|
||||
### Contributing
|
||||
All contributions are welcome! If you do add a feature please do a pull request so that everyone benefits :)
|
||||
|
||||
Sharing is caring!
|
||||
Sharing is caring!
|
||||
|
||||
@@ -9,12 +9,21 @@ 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)
|
||||
- [Respond to "file" with an uploaded file](#respond-to-file-with-an-uploaded-file)
|
||||
- [Respond to "react" with a reaction](#respond-to-react-with-a-reaction)
|
||||
- [Respond to "users" with full list of server users](#respond-to-users-with-full-list-of-server-users)
|
||||
- [Respond to "newroom" by creating new room and inviting user](#respond-to-newroom-by-creating-new-room-and-inviting-user)
|
||||
- [Respond to "joinroom <room_id_or_alias>" by joining mentioned room](#respond-to-joinroom-room_id_or_alias-by-joining-mentioned-room)
|
||||
- [Respond to "rooms <user_id>" with user's rooms (list server's rooms if <user_id> is left blank)](#respond-to-rooms-user_id-with-users-rooms-list-servers-rooms-if-user_id-is-left-blank)
|
||||
- [Respond to "whois <user_id>" with information about the user's session](#respond-to-whois-user_id-with-information-about-the-users-session)
|
||||
- [Respond to "room_users" with current room's users](#respond-to-room_users-with-current-rooms-users)
|
||||
- [Download & store all received files/images](#download--store-all-received-filesimages)
|
||||
- [Kick/Ban user from room](#kickban-user-from-room)
|
||||
- [Deactivate user](#deactivate-user)
|
||||
|
||||
|
||||
### Create user with Shared Secret Registration
|
||||
@@ -27,7 +36,7 @@ Edit the object on the inject node to the user/pass combo you want to create and
|
||||
|
||||
**Note:** This only works on Synapse servers.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Create/Edit Synapse User
|
||||
@@ -36,16 +45,28 @@ Edit the object on the inject node to the user/pass combo you want to create and
|
||||
|
||||
Allows an administrator to create or modify a user account with a specified `msg.userId`.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Use function node to run any command
|
||||
|
||||
[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.
|
||||
|
||||
**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).
|
||||
|
||||
|
||||
|
||||
### Respond to "ping" with "pong"
|
||||
|
||||
[View JSON](respond-to-html-with-html.json)
|
||||
[View JSON](respond-ping-pong.json)
|
||||
|
||||
Use this flow to respond to anyone that says "ping" with "pong" into the same room.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -55,7 +76,7 @@ Use this flow to respond to anyone that says "ping" with "pong" into the same ro
|
||||
|
||||
Use this flow to respond to anyone that says "html" with an example HTML message. This shows how easy it is to send HTML.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -65,7 +86,7 @@ Use this flow to respond to anyone that says "html" with an example HTML message
|
||||
|
||||
You will need an image on the machine running Node-RED. In this case example.png exists inside the Node-RED directory.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -75,7 +96,7 @@ You will need an image on the machine running Node-RED. In this case example.png
|
||||
|
||||
You will need a file on the machine running Node-RED. In this case sample.pdf exists inside the Node-RED directory.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -85,7 +106,7 @@ You will need a file on the machine running Node-RED. In this case sample.pdf ex
|
||||
|
||||
Give a 👍 reaction when someone says "react"
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -93,8 +114,109 @@ Give a 👍 reaction when someone says "react"
|
||||
|
||||
[View JSON](respond-users-list.json)
|
||||
|
||||
When someone sends the text "users" they get a HTML message back containing all the current users on the server.
|
||||
When someone sends the text "users" they get a HTML message back containing all the current users on the server. If your server has a lot of users this paginates and sends a message with 25 users per message.
|
||||
|
||||
This requires admin privileges.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Respond to "newroom" by creating new room and inviting user
|
||||
|
||||
[View JSON](respond-users-list.json)
|
||||
|
||||
When someone sends "newroom" a new room will be created and the user that said the message will be invited. The client will also send a welcome message into the new room.
|
||||
|
||||
|
||||
|
||||
|
||||
### Respond to "joinroom <room_id_or_alias>" by joining mentioned room
|
||||
|
||||
[View JSON](respond-joinroom.json)
|
||||
|
||||
When someone sends "newroom" a new room will be created and the user that said the message will be invited. The client will also send a welcome message into the new room.
|
||||
|
||||
|
||||
|
||||
### Respond to "rooms <user_id>" with user's rooms (list server's rooms if <user_id> is left blank)
|
||||
|
||||
[View JSON](respond-rooms.json)
|
||||
|
||||
Responds to "rooms <user_id>" with that user's rooms. If the message is just "rooms" it responds with a list of all rooms the server is participating in.
|
||||
|
||||
Note: If there are a lot of rooms this may fail to send the message as it is too large. This also only works for user's that are on the current server.
|
||||
|
||||
This requires admin privileges.
|
||||
|
||||
|
||||
|
||||
|
||||
### Respond to "whois <user_id>" with information about the user's session
|
||||
|
||||
[View JSON](respond-whois.json)
|
||||
|
||||
This lists out the user's session info. Each session contains the IP address, when it was last seen, and the user agent. Useful to find out more about a specific user on your server.
|
||||
|
||||
Note: If there are a lot of sessions this may fail to send the message as it is too large. This also only works for user's that are on the current server.
|
||||
|
||||
This requires admin privileges.
|
||||
|
||||
|
||||
|
||||
|
||||
### Respond to "room_users" with current room's users
|
||||
|
||||
[View JSON](respond-room-users.json)
|
||||
|
||||
List out the users participating in a room.
|
||||
|
||||
Note: If there are a lot of users in the room this will fail to send due to a large message error.
|
||||
|
||||
|
||||
|
||||
|
||||
### Download & store all received files/images
|
||||
|
||||
[View JSON](store-received-files.json)
|
||||
|
||||
Download received files/images. If the file is encrypted it will decrypt it for you. The decrypt node downloads the file for you otherwise you need to use a HTTP Request node to download the file.
|
||||
|
||||
Note: You may need to edit the storage directory for this to work. Default action is to create a `downloads` folder in the Node-RED directory and places files in that but there is a good chance your Node-RED instance doesn't have access to write to this directory.
|
||||
|
||||
|
||||
|
||||
|
||||
### Kick/Ban user from room
|
||||
|
||||
[View JSON](room-kick-ban.json)
|
||||
|
||||
If you say "kick @test:example.com" the bot will kick @test:example.com from the current room.
|
||||
|
||||
If you say "ban @test:example.com" the bot will ban @test:example.com from the current room.
|
||||
|
||||
Note: This requires the bot to have permissions to kick/ban in the current room.
|
||||
|
||||
|
||||
|
||||
|
||||
### Deactivate user
|
||||
|
||||
[View JSON](deactivate-user.json)
|
||||
|
||||
If you say "deactivate_user @test:example.com" the bot will deactivate the @test:example.com account on the server.
|
||||
|
||||
Note: This requires the bot to be a server admin.
|
||||
|
||||
WARNING: Accounts that are deleted cannot be restored. If you want to temp-disable edit the user instead.
|
||||
|
||||
|
||||
|
||||
### Force user to join room
|
||||
|
||||
[View JSON](force-join-room.json)
|
||||
|
||||
If you say "force_join @test:example.com !320j90mf0394f:example.com" the bot will force the user `@test:example.com` into room `!320j90mf0394f:example.com`
|
||||
|
||||
Note: This requires the bot to be a server admin. This also only works for rooms on the same server.
|
||||
|
||||
|
||||
113
examples/custom-redact-function-node.json
Normal file
113
examples/custom-redact-function-node.json
Normal file
@@ -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": []
|
||||
}
|
||||
]
|
||||
BIN
examples/custom-redact-function-node.png
Normal file
BIN
examples/custom-redact-function-node.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 18 KiB |
116
examples/deactivate-user.json
Normal file
116
examples/deactivate-user.json
Normal file
@@ -0,0 +1,116 @@
|
||||
[
|
||||
{
|
||||
"id": "843c48978ab1b0a0",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 590,
|
||||
"y": 3260,
|
||||
"wires": [
|
||||
[
|
||||
"b77d071077487ddc"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "93ea76ce5e65a250",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": false,
|
||||
"acceptStickers": false,
|
||||
"acceptReactions": false,
|
||||
"acceptFiles": false,
|
||||
"acceptImages": false,
|
||||
"x": 420,
|
||||
"y": 3260,
|
||||
"wires": [
|
||||
[
|
||||
"843c48978ab1b0a0"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "d6795b522954bccd",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"deactivate_user <user_id>\" by deactivating the user on the server",
|
||||
"info": "",
|
||||
"x": 590,
|
||||
"y": 3220,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "b77d071077487ddc",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload filter",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "regex",
|
||||
"v": "^deactivate_user",
|
||||
"vt": "str",
|
||||
"case": false
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 770,
|
||||
"y": 3260,
|
||||
"wires": [
|
||||
[
|
||||
"3c0e1e130e91206e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "3c0e1e130e91206e",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let matches = msg.payload.match(/^deactivate_user ?(\\@.*)?/);\nmsg.userId = matches[1].trim() ? matches[1].trim() : null;\nif(!msg.userId) {\n return null;\n}\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 420,
|
||||
"y": 3320,
|
||||
"wires": [
|
||||
[
|
||||
"1f4870b7171cc70f"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "1f4870b7171cc70f",
|
||||
"type": "matrix-synapse-deactivate-user",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"x": 610,
|
||||
"y": 3320,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
}
|
||||
]
|
||||
BIN
examples/deactivate-user.png
Normal file
BIN
examples/deactivate-user.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
117
examples/force-join-room.json
Normal file
117
examples/force-join-room.json
Normal file
@@ -0,0 +1,117 @@
|
||||
[
|
||||
{
|
||||
"id": "897b8de477d7d0df",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 470,
|
||||
"y": 3460,
|
||||
"wires": [
|
||||
[
|
||||
"1f73f36092a9536b"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "973b2caeb68f3a60",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": false,
|
||||
"acceptStickers": false,
|
||||
"acceptReactions": false,
|
||||
"acceptFiles": false,
|
||||
"acceptImages": false,
|
||||
"x": 300,
|
||||
"y": 3460,
|
||||
"wires": [
|
||||
[
|
||||
"897b8de477d7d0df"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "be5c7290e6223b7b",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Say \"force_join <user_id> <room_id_or_alias>\" to force a user into a room",
|
||||
"info": "",
|
||||
"x": 460,
|
||||
"y": 3420,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "1f73f36092a9536b",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload filter",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "regex",
|
||||
"v": "^deactivate_user",
|
||||
"vt": "str",
|
||||
"case": false
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 650,
|
||||
"y": 3460,
|
||||
"wires": [
|
||||
[
|
||||
"6a2a73bc9dfdaece"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "6a2a73bc9dfdaece",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let matches = msg.payload.match(/^force_join (\\@.*) (.*)/);\nmsg.userId = matches[1].trim() ? matches[1].trim() : null;\nif(!msg.userId) {\n return null;\n}\nmsg.topic = matches[2].trim() ? matches[2].trim() : null;\nif(!msg.topic) {\n return null;\n}\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 300,
|
||||
"y": 3520,
|
||||
"wires": [
|
||||
[
|
||||
"212e060e320918d3"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "212e060e320918d3",
|
||||
"type": "matrix-synapse-join-room",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"x": 490,
|
||||
"y": 3520,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
}
|
||||
]
|
||||
BIN
examples/force-join-room.png
Normal file
BIN
examples/force-join-room.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 23 KiB |
90
examples/respond-joinroom.json
Normal file
90
examples/respond-joinroom.json
Normal file
@@ -0,0 +1,90 @@
|
||||
[
|
||||
{
|
||||
"id": "9a737b0c57b35063",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 430,
|
||||
"y": 2020,
|
||||
"wires": [
|
||||
[
|
||||
"2a44927d9317a4b4"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "f377ad37af7dc49e",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": true,
|
||||
"acceptStickers": true,
|
||||
"acceptReactions": true,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 260,
|
||||
"y": 2020,
|
||||
"wires": [
|
||||
[
|
||||
"9a737b0c57b35063"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "f7112a1d2808cfbb",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"joinroom <room_id_or_alias>\" by joining the mentioned room",
|
||||
"info": "",
|
||||
"x": 440,
|
||||
"y": 1980,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "2a44927d9317a4b4",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload == \"joinroom\"",
|
||||
"func": "if(!msg.payload.startsWith(\"joinroom\")) {\n return null;\n}\n\nlet split = msg.payload.split(\" \");\nif(split.length < 2) {\n return; // no room provided\n}\n\nmsg.topic = split[1];\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 640,
|
||||
"y": 2020,
|
||||
"wires": [
|
||||
[
|
||||
"a34d05c3b6f6bd27"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "a34d05c3b6f6bd27",
|
||||
"type": "matrix-join-room",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"x": 850,
|
||||
"y": 2020,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
}
|
||||
]
|
||||
BIN
examples/respond-joinroom.png
Normal file
BIN
examples/respond-joinroom.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
157
examples/respond-newroom-invite.json
Normal file
157
examples/respond-newroom-invite.json
Normal file
@@ -0,0 +1,157 @@
|
||||
[
|
||||
{
|
||||
"id": "ea0921f33b58e337",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload is \"newroom\"",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "newroom",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 640,
|
||||
"y": 1820,
|
||||
"wires": [
|
||||
[
|
||||
"d7ce5027bc1e2eee"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "9f9a24376b94c977",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 430,
|
||||
"y": 1820,
|
||||
"wires": [
|
||||
[
|
||||
"ea0921f33b58e337"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "3bce23488138c013",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": true,
|
||||
"acceptStickers": true,
|
||||
"acceptReactions": true,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 260,
|
||||
"y": 1820,
|
||||
"wires": [
|
||||
[
|
||||
"9f9a24376b94c977"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "d7ce5027bc1e2eee",
|
||||
"type": "matrix-create-room",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"x": 250,
|
||||
"y": 1880,
|
||||
"wires": [
|
||||
[
|
||||
"735b9d9fd1401e96"
|
||||
],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "735b9d9fd1401e96",
|
||||
"type": "matrix-invite-room",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"x": 410,
|
||||
"y": 1880,
|
||||
"wires": [
|
||||
[
|
||||
"089f2a7f0c079b6b"
|
||||
],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "222ee3c08028c1df",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"messageType": "m.text",
|
||||
"messageFormat": "",
|
||||
"x": 760,
|
||||
"y": 1880,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "089f2a7f0c079b6b",
|
||||
"type": "change",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"rules": [
|
||||
{
|
||||
"t": "set",
|
||||
"p": "payload",
|
||||
"pt": "msg",
|
||||
"to": "Welcome to my new room!",
|
||||
"tot": "str"
|
||||
}
|
||||
],
|
||||
"action": "",
|
||||
"property": "",
|
||||
"from": "",
|
||||
"to": "",
|
||||
"reg": false,
|
||||
"x": 580,
|
||||
"y": 1880,
|
||||
"wires": [
|
||||
[
|
||||
"222ee3c08028c1df"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "48a1fd26227f277e",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"newroom\" by creating new room and inviting person that said it then send welcome message",
|
||||
"info": "",
|
||||
"x": 520,
|
||||
"y": 1780,
|
||||
"wires": []
|
||||
}
|
||||
]
|
||||
BIN
examples/respond-newroom-invite.png
Normal file
BIN
examples/respond-newroom-invite.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
134
examples/respond-room-users.json
Normal file
134
examples/respond-room-users.json
Normal file
@@ -0,0 +1,134 @@
|
||||
[
|
||||
{
|
||||
"id": "a7581a6224cbd24d",
|
||||
"type": "matrix-room-users",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"x": 440,
|
||||
"y": 2800,
|
||||
"wires": [
|
||||
[
|
||||
"3e37b5fded58782d"
|
||||
],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "2764620d2d514996",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 610,
|
||||
"y": 2740,
|
||||
"wires": [
|
||||
[
|
||||
"f487951ea1b22a95"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "7ed8fc36ba75298a",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": true,
|
||||
"acceptStickers": true,
|
||||
"acceptReactions": true,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 440,
|
||||
"y": 2740,
|
||||
"wires": [
|
||||
[
|
||||
"2764620d2d514996"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "f487951ea1b22a95",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload filter",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "room_users",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 790,
|
||||
"y": 2740,
|
||||
"wires": [
|
||||
[
|
||||
"a7581a6224cbd24d"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "3e37b5fded58782d",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Room List (for user or all)",
|
||||
"func": "let payload = null;\nif(!msg.payload || !msg.payload.joined) {\n payload = 'No users in room.';\n} else {\n payload = `Room ${msg.topic} users:`;\n payload += '<ul>';\n for(let user_id in msg.payload.joined) {\n payload += `<li>${msg.payload.joined[user_id].display_name} - ${user_id}</li>`;\n }\n payload += '</ul>'\n}\n\nif(payload){\n msg.payload = payload;\n}\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 650,
|
||||
"y": 2800,
|
||||
"wires": [
|
||||
[
|
||||
"86a4895c4fe46657"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "86a4895c4fe46657",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Send HTML Message",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"messageType": "m.text",
|
||||
"messageFormat": "html",
|
||||
"x": 880,
|
||||
"y": 2800,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "cae1a37fe034b8f8",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"room_users\" with that room's users",
|
||||
"info": "",
|
||||
"x": 600,
|
||||
"y": 2700,
|
||||
"wires": []
|
||||
}
|
||||
]
|
||||
BIN
examples/respond-room-users.png
Normal file
BIN
examples/respond-room-users.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
151
examples/respond-rooms.json
Normal file
151
examples/respond-rooms.json
Normal file
@@ -0,0 +1,151 @@
|
||||
[
|
||||
{
|
||||
"id": "2eb2dd1b5dbdd03b",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Response to \"rooms\" with all rooms",
|
||||
"info": "",
|
||||
"x": 580,
|
||||
"y": 2500,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "f3415a10f124d586",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let matches = msg.payload.match(/^rooms ?(\\@.*)?/);\nmsg.userId = matches[1] ? matches[1] : null;\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 420,
|
||||
"y": 2620,
|
||||
"wires": [
|
||||
[
|
||||
"2cae98732747989d"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "2cae98732747989d",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Room List (for user or all)",
|
||||
"func": "let matrixClient = global.get(\"matrixClient['@bot:example.com']\"),\n matrixOnline = global.get(\"matrixClientOnline['@bot:example.com']\");\n\nif(!matrixOnline) {\n msg.payload = 'Matrix client not connected.';\n return [null, msg];\n}\n\nif(msg.userId) {\n matrixClient.http\n .authedRequest(\n undefined,\n 'GET',\n `/_synapse/admin/v1/users/${msg.userId}/joined_rooms`,\n {}, // query params\n undefined,\n { prefix: '' }\n ).then(function(e){\n msg.payload = e;\n if(!e.joined_rooms) {\n msg.payload = 'User is not part of any rooms.';\n } else {\n msg.payload = `${msg.userId}'s rooms:`;\n msg.payload += '<ul>';\n e.joined_rooms.forEach(function(room_id){\n msg.payload += `<li>${room_id}</li>`;\n });\n msg.payload += '</ul>'\n }\n node.send([msg, null]);\n }).catch(function(e){\n node.warn(\"Error fetching server user list \" + e);\n msg.payload = e;\n node.send([null, msg]);\n });\n} else {\n matrixClient.http\n .authedRequest(\n undefined,\n 'GET',\n `/_synapse/admin/v1/rooms`,\n {}, // query params\n undefined,\n { prefix: '' }\n ).then(function(e){\n msg.payload = e;\n if(!e.rooms) {\n msg.payload = 'Server has no rooms.';\n } else {\n msg.payload = `Server rooms:`;\n msg.payload += '<ul>';\n e.rooms.forEach(function(room){\n msg.payload += `<li>${room.name} - ${room.room_id} (members: ${room.joined_members} | creator: ${room.creator})</li>`;\n });\n msg.payload += '</ul>'\n }\n node.send([msg, null]);\n }).catch(function(e){\n node.warn(\"Error fetching server user list \" + e);\n msg.payload = e;\n node.send([null, msg]);\n });\n}",
|
||||
"outputs": 2,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 610,
|
||||
"y": 2620,
|
||||
"wires": [
|
||||
[
|
||||
"d7508993ec1ce895"
|
||||
],
|
||||
[
|
||||
"d7508993ec1ce895"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "2f8c696ec0dc8f6d",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"rooms <user_id>\" with that user's rooms",
|
||||
"info": "",
|
||||
"x": 590,
|
||||
"y": 2540,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "d7508993ec1ce895",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Send HTML Message",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"messageType": "m.text",
|
||||
"messageFormat": "html",
|
||||
"x": 840,
|
||||
"y": 2620,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "13a9a0331352338a",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 590,
|
||||
"y": 2580,
|
||||
"wires": [
|
||||
[
|
||||
"afe88b8e115f661f"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "e261cc12da739901",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": true,
|
||||
"acceptStickers": true,
|
||||
"acceptReactions": true,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 420,
|
||||
"y": 2580,
|
||||
"wires": [
|
||||
[
|
||||
"13a9a0331352338a"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "afe88b8e115f661f",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload filter",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "regex",
|
||||
"v": "^rooms",
|
||||
"vt": "str",
|
||||
"case": false
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 770,
|
||||
"y": 2580,
|
||||
"wires": [
|
||||
[
|
||||
"f3415a10f124d586"
|
||||
]
|
||||
]
|
||||
}
|
||||
]
|
||||
BIN
examples/respond-rooms.png
Normal file
BIN
examples/respond-rooms.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 27 KiB |
@@ -1,27 +1,257 @@
|
||||
[
|
||||
{
|
||||
"id": "a9b412957063b06c",
|
||||
"type": "matrix-receive",
|
||||
"id": "49e4b3a1ee3e9e1e",
|
||||
"type": "matrix-synapse-users",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"roomId": "",
|
||||
"ignoreText": false,
|
||||
"ignoreReactions": false,
|
||||
"ignoreFiles": false,
|
||||
"ignoreImages": false,
|
||||
"x": 460,
|
||||
"y": 120,
|
||||
"server": null,
|
||||
"x": 610,
|
||||
"y": 2240,
|
||||
"wires": [
|
||||
[
|
||||
"4aa45cd8653ba898"
|
||||
"d4978f7c2dad7ecf"
|
||||
],
|
||||
[
|
||||
"da9d25c324cb727e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "4aa45cd8653ba898",
|
||||
"id": "e199d3db1ea6757c",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Send HTML Notice",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"messageType": "m.notice",
|
||||
"messageFormat": "html",
|
||||
"x": 970,
|
||||
"y": 2240,
|
||||
"wires": [
|
||||
[
|
||||
"e248881d6749ba70"
|
||||
],
|
||||
[
|
||||
"da9d25c324cb727e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "d4978f7c2dad7ecf",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "msg.next_token = msg.payload.next_token || false;\nlet new_payload = '<ul>';\nmsg.payload.users.forEach(function(user, index){\n if(msg.guests == 'false' && user.is_guest) {\n return;\n }\n new_payload += '<li>'+ JSON.stringify(user, null, 2).replace(/(?:\\r\\n|\\r|\\n)/g, \"\\n<br>\"); + '</li>'\n});\nmsg.payload = new_payload + '</ul>';\n\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 800,
|
||||
"y": 2240,
|
||||
"wires": [
|
||||
[
|
||||
"e199d3db1ea6757c"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "880cac7307d9a786",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Response to \"users\" with full server user list (excluding guests)",
|
||||
"info": "",
|
||||
"x": 620,
|
||||
"y": 2160,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "469d2ebd9995747a",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"messageType": "m.notice",
|
||||
"messageFormat": "",
|
||||
"x": 600,
|
||||
"y": 2300,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "da9d25c324cb727e",
|
||||
"type": "change",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"rules": [
|
||||
{
|
||||
"t": "set",
|
||||
"p": "payload",
|
||||
"pt": "msg",
|
||||
"to": "error",
|
||||
"tot": "msg"
|
||||
}
|
||||
],
|
||||
"action": "",
|
||||
"property": "",
|
||||
"from": "",
|
||||
"to": "",
|
||||
"reg": false,
|
||||
"x": 420,
|
||||
"y": 2300,
|
||||
"wires": [
|
||||
[
|
||||
"469d2ebd9995747a"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "86577e484ca26aca",
|
||||
"type": "change",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"rules": [
|
||||
{
|
||||
"t": "set",
|
||||
"p": "guests",
|
||||
"pt": "msg",
|
||||
"to": "false",
|
||||
"tot": "str"
|
||||
},
|
||||
{
|
||||
"t": "set",
|
||||
"p": "limit",
|
||||
"pt": "msg",
|
||||
"to": "25",
|
||||
"tot": "num"
|
||||
},
|
||||
{
|
||||
"t": "set",
|
||||
"p": "order_by",
|
||||
"pt": "msg",
|
||||
"to": "creation_ts",
|
||||
"tot": "str"
|
||||
}
|
||||
],
|
||||
"action": "",
|
||||
"property": "",
|
||||
"from": "",
|
||||
"to": "",
|
||||
"reg": false,
|
||||
"x": 420,
|
||||
"y": 2240,
|
||||
"wires": [
|
||||
[
|
||||
"49e4b3a1ee3e9e1e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "e248881d6749ba70",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload == \"users\"",
|
||||
"name": "More to paginate?",
|
||||
"property": "next_token",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "istype",
|
||||
"v": "string",
|
||||
"vt": "string"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 1190,
|
||||
"y": 2240,
|
||||
"wires": [
|
||||
[
|
||||
"11d7fcf6335bc75b"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "11d7fcf6335bc75b",
|
||||
"type": "change",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"rules": [
|
||||
{
|
||||
"t": "set",
|
||||
"p": "from",
|
||||
"pt": "msg",
|
||||
"to": "next_token",
|
||||
"tot": "msg"
|
||||
}
|
||||
],
|
||||
"action": "",
|
||||
"property": "",
|
||||
"from": "",
|
||||
"to": "",
|
||||
"reg": false,
|
||||
"x": 1370,
|
||||
"y": 2240,
|
||||
"wires": [
|
||||
[
|
||||
"49e4b3a1ee3e9e1e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "8b48e27a118999ec",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 590,
|
||||
"y": 2200,
|
||||
"wires": [
|
||||
[
|
||||
"7a64319e26e8b689"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "553da6dd77e5e03b",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": true,
|
||||
"acceptStickers": true,
|
||||
"acceptReactions": true,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 420,
|
||||
"y": 2200,
|
||||
"wires": [
|
||||
[
|
||||
"8b48e27a118999ec"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "7a64319e26e8b689",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload filter",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
@@ -34,70 +264,12 @@
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 670,
|
||||
"y": 120,
|
||||
"x": 770,
|
||||
"y": 2200,
|
||||
"wires": [
|
||||
[
|
||||
"b95a674179d93416"
|
||||
"86577e484ca26aca"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "b95a674179d93416",
|
||||
"type": "matrix-synapse-users",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"x": 890,
|
||||
"y": 120,
|
||||
"wires": [
|
||||
[
|
||||
"19b654e5f28d93c4"
|
||||
],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "8720c66e867f89f6",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Send HTML Notice",
|
||||
"roomId": "",
|
||||
"messageType": "m.notice",
|
||||
"messageFormat": "html",
|
||||
"x": 1230,
|
||||
"y": 120,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "19b654e5f28d93c4",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let new_payload = '<ul>';\nmsg.payload.users.forEach(function(user, index){\n new_payload += '<li>'+ JSON.stringify(user, null, 2).replace(/(?:\\r\\n|\\r|\\n)/g, \"\\n<br>\"); + '</li>'\n});\nmsg.payload = new_payload + '</ul>';\n\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 1060,
|
||||
"y": 120,
|
||||
"wires": [
|
||||
[
|
||||
"8720c66e867f89f6"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "563da45ab1747c2b",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Response to \"users\" with full server user list",
|
||||
"info": "",
|
||||
"x": 550,
|
||||
"y": 80,
|
||||
"wires": []
|
||||
}
|
||||
]
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 44 KiB |
153
examples/respond-whois.json
Normal file
153
examples/respond-whois.json
Normal file
@@ -0,0 +1,153 @@
|
||||
[
|
||||
{
|
||||
"id": "93df869346a728d3",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Response to \"whois <user_id>\" with user information",
|
||||
"info": "",
|
||||
"x": 610,
|
||||
"y": 2360,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "656ed1e444fd2e0a",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let matches = msg.payload.match(/^whois ?(\\@.*)?/);\nmsg.userId = matches[1].trim() ? matches[1].trim() : msg.userId;\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 440,
|
||||
"y": 2440,
|
||||
"wires": [
|
||||
[
|
||||
"4869676dab929d20"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "4869676dab929d20",
|
||||
"type": "matrix-whois-user",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"x": 590,
|
||||
"y": 2440,
|
||||
"wires": [
|
||||
[
|
||||
"a894fcabf9e41dca"
|
||||
],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "a894fcabf9e41dca",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "try { \n var sessions = msg.payload.devices[\"\"].sessions || null;\n} catch (error) { \n var sessions = null;\n}\nlet html = \"whois (session) information for <strong>\" + msg.userId + \"</strong>\\n<ol>\";\nfor(let session of sessions) {\n try { \n var connections = session.connections;\n } catch (error) { \n var connections = null;\n }\n for(let connection of connections) {\n html += \"\\n<li><pre><code>\"+JSON.stringify(connection, null, 2)+\"</code></pre></li>\"\n }\n}\nhtml += \"</ol>\"\nmsg.payload = html;\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 740,
|
||||
"y": 2440,
|
||||
"wires": [
|
||||
[
|
||||
"898b8974f2b24861"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "898b8974f2b24861",
|
||||
"type": "matrix-send-message",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Send HTML Notice",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"messageType": "m.notice",
|
||||
"messageFormat": "html",
|
||||
"x": 910,
|
||||
"y": 2440,
|
||||
"wires": [
|
||||
[],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "c8855c79f194796e",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 590,
|
||||
"y": 2400,
|
||||
"wires": [
|
||||
[
|
||||
"ae1537a16b9e3b4c"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "39109d4f02d241ca",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": true,
|
||||
"acceptStickers": true,
|
||||
"acceptReactions": true,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 420,
|
||||
"y": 2400,
|
||||
"wires": [
|
||||
[
|
||||
"c8855c79f194796e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "ae1537a16b9e3b4c",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "msg.payload filter",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "regex",
|
||||
"v": "^whois",
|
||||
"vt": "str",
|
||||
"case": false
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 770,
|
||||
"y": 2400,
|
||||
"wires": [
|
||||
[
|
||||
"656ed1e444fd2e0a"
|
||||
]
|
||||
]
|
||||
}
|
||||
]
|
||||
BIN
examples/respond-whois.png
Normal file
BIN
examples/respond-whois.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 22 KiB |
211
examples/room-kick-ban.json
Normal file
211
examples/room-kick-ban.json
Normal file
@@ -0,0 +1,211 @@
|
||||
[
|
||||
{
|
||||
"id": "d78dd157085ed843",
|
||||
"type": "matrix-room-kick",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"x": 570,
|
||||
"y": 2980,
|
||||
"wires": [
|
||||
[
|
||||
"44d49fcaad67790c"
|
||||
],
|
||||
[
|
||||
"44d49fcaad67790c"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "32a99c44b50fe3f3",
|
||||
"type": "matrix-room-ban",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"x": 570,
|
||||
"y": 3080,
|
||||
"wires": [
|
||||
[
|
||||
"04628a976e7acf1b"
|
||||
],
|
||||
[
|
||||
"04628a976e7acf1b"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "5e786bbae3b1a368",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "is from me",
|
||||
"property": "userId",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "@skylord123:skylar.tech",
|
||||
"vt": "str"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 230,
|
||||
"y": 3020,
|
||||
"wires": [
|
||||
[
|
||||
"5b3ddae8335383e7"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "ca278a6ffc3b9d6b",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": true,
|
||||
"acceptEmotes": false,
|
||||
"acceptStickers": false,
|
||||
"acceptReactions": false,
|
||||
"acceptFiles": false,
|
||||
"acceptImages": false,
|
||||
"x": 220,
|
||||
"y": 2960,
|
||||
"wires": [
|
||||
[
|
||||
"5e786bbae3b1a368"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "b6830f430157be4e",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"room_ban <user_id>\" by banning user from room",
|
||||
"info": "",
|
||||
"x": 580,
|
||||
"y": 3040,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "8bffe425d3c1bf24",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Respond to \"room_kick <user_id>\" by kicking user from room",
|
||||
"info": "",
|
||||
"x": 580,
|
||||
"y": 2940,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "5b3ddae8335383e7",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Kick or Ban",
|
||||
"property": "payload",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "regex",
|
||||
"v": "^room_kick",
|
||||
"vt": "str",
|
||||
"case": false
|
||||
},
|
||||
{
|
||||
"t": "regex",
|
||||
"v": "^room_ban",
|
||||
"vt": "str",
|
||||
"case": false
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 2,
|
||||
"x": 230,
|
||||
"y": 3060,
|
||||
"wires": [
|
||||
[
|
||||
"a19b38afd7b52834"
|
||||
],
|
||||
[
|
||||
"925c59f485bf7247"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "925c59f485bf7247",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let matches = msg.payload.match(/^room_ban ?(\\@.*)?/);\nmsg.userId = matches[1].trim() ? matches[1].trim() : null;\nif(!msg.userId) {\n return null;\n}\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 420,
|
||||
"y": 3080,
|
||||
"wires": [
|
||||
[
|
||||
"32a99c44b50fe3f3"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "a19b38afd7b52834",
|
||||
"type": "function",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"func": "let matches = msg.payload.match(/^room_kick ?(\\@.*)?/);\nmsg.userId = matches[1].trim() ? matches[1].trim() : null;\nif(!msg.userId) {\n return null;\n}\nreturn msg;",
|
||||
"outputs": 1,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 420,
|
||||
"y": 2980,
|
||||
"wires": [
|
||||
[
|
||||
"d78dd157085ed843"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "04628a976e7acf1b",
|
||||
"type": "debug",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"active": true,
|
||||
"tosidebar": true,
|
||||
"console": false,
|
||||
"tostatus": false,
|
||||
"complete": "true",
|
||||
"targetType": "full",
|
||||
"statusVal": "",
|
||||
"statusType": "auto",
|
||||
"x": 710,
|
||||
"y": 3080,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "44d49fcaad67790c",
|
||||
"type": "debug",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"active": true,
|
||||
"tosidebar": true,
|
||||
"console": false,
|
||||
"tostatus": false,
|
||||
"complete": "true",
|
||||
"targetType": "full",
|
||||
"statusVal": "",
|
||||
"statusType": "auto",
|
||||
"x": 710,
|
||||
"y": 2980,
|
||||
"wires": []
|
||||
}
|
||||
]
|
||||
BIN
examples/room-kick-ban.png
Normal file
BIN
examples/room-kick-ban.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
166
examples/store-received-files.json
Normal file
166
examples/store-received-files.json
Normal file
@@ -0,0 +1,166 @@
|
||||
[
|
||||
{
|
||||
"id": "d7573ed76980dc64",
|
||||
"type": "matrix-receive",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"server": null,
|
||||
"roomId": "",
|
||||
"acceptText": false,
|
||||
"acceptEmotes": false,
|
||||
"acceptStickers": false,
|
||||
"acceptReactions": false,
|
||||
"acceptFiles": true,
|
||||
"acceptImages": true,
|
||||
"x": 1740,
|
||||
"y": 600,
|
||||
"wires": [
|
||||
[
|
||||
"4d4e992ed895413f"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "addcccdfea9935b1",
|
||||
"type": "comment",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "Download & store received files/images and decrypt if necessary",
|
||||
"info": "",
|
||||
"x": 1970,
|
||||
"y": 560,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "4d4e992ed895413f",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"property": "encrypted",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "true"
|
||||
},
|
||||
{
|
||||
"t": "else"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 2,
|
||||
"x": 1890,
|
||||
"y": 600,
|
||||
"wires": [
|
||||
[
|
||||
"660782188696fc62"
|
||||
],
|
||||
[
|
||||
"857bce169036e3cb"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "660782188696fc62",
|
||||
"type": "matrix-decrypt-file",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": null,
|
||||
"x": 2050,
|
||||
"y": 600,
|
||||
"wires": [
|
||||
[
|
||||
"cdbaf88f6631322e"
|
||||
],
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "b62db6caf4697242",
|
||||
"type": "file",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"filename": "",
|
||||
"appendNewline": true,
|
||||
"createDir": false,
|
||||
"overwriteFile": "true",
|
||||
"encoding": "none",
|
||||
"x": 2240,
|
||||
"y": 660,
|
||||
"wires": [
|
||||
[]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "857bce169036e3cb",
|
||||
"type": "http request",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"method": "GET",
|
||||
"ret": "bin",
|
||||
"paytoqs": "ignore",
|
||||
"url": "",
|
||||
"tls": "",
|
||||
"persist": false,
|
||||
"proxy": "",
|
||||
"authType": "",
|
||||
"senderr": false,
|
||||
"x": 1910,
|
||||
"y": 660,
|
||||
"wires": [
|
||||
[
|
||||
"7d0be52f8c3f1b54"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "7d0be52f8c3f1b54",
|
||||
"type": "switch",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "",
|
||||
"property": "statusCode",
|
||||
"propertyType": "msg",
|
||||
"rules": [
|
||||
{
|
||||
"t": "eq",
|
||||
"v": "200",
|
||||
"vt": "num"
|
||||
}
|
||||
],
|
||||
"checkall": "true",
|
||||
"repair": false,
|
||||
"outputs": 1,
|
||||
"x": 2050,
|
||||
"y": 660,
|
||||
"wires": [
|
||||
[
|
||||
"cdbaf88f6631322e"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "cdbaf88f6631322e",
|
||||
"type": "change",
|
||||
"z": "f025a8b9fbd1b054",
|
||||
"name": "set directory",
|
||||
"rules": [
|
||||
{
|
||||
"t": "set",
|
||||
"p": "filename",
|
||||
"pt": "msg",
|
||||
"to": "\"downloads/\" & msg.filename",
|
||||
"tot": "jsonata"
|
||||
}
|
||||
],
|
||||
"action": "",
|
||||
"property": "",
|
||||
"from": "",
|
||||
"to": "",
|
||||
"reg": false,
|
||||
"x": 2230,
|
||||
"y": 600,
|
||||
"wires": [
|
||||
[
|
||||
"b62db6caf4697242"
|
||||
]
|
||||
]
|
||||
}
|
||||
]
|
||||
BIN
examples/store-received-files.png
Normal file
BIN
examples/store-received-files.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
8326
package-lock.json
generated
8326
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
17
package.json
17
package.json
@@ -1,16 +1,18 @@
|
||||
{
|
||||
"name": "node-red-contrib-matrix-chat",
|
||||
"version": "0.1.8",
|
||||
"version": "0.4.6",
|
||||
"description": "Matrix chat server client for Node-RED",
|
||||
"dependencies": {
|
||||
"got": "^11.8.2",
|
||||
"fs-extra": "^10.0.0",
|
||||
"got": "^12.0.1",
|
||||
"isomorphic-webcrypto": "^2.3.8",
|
||||
"matrix-js-sdk": "^12.2.0",
|
||||
"olm": "https://packages.matrix.org/npm/olm/olm-3.1.4.tgz",
|
||||
"utf8": "^3.0.0",
|
||||
"node-localstorage": "^2.2.1"
|
||||
"matrix-js-sdk": "^15.5.0",
|
||||
"node-localstorage": "^2.2.1",
|
||||
"olm": "https://packages.matrix.org/npm/olm/olm-3.2.1.tgz",
|
||||
"utf8": "^3.0.0"
|
||||
},
|
||||
"node-red": {
|
||||
"version": ">=1.3.0",
|
||||
"nodes": {
|
||||
"matrix-server-config": "src/matrix-server-config.js",
|
||||
"matrix-receive": "src/matrix-receive.js",
|
||||
@@ -33,6 +35,9 @@
|
||||
"matrix-room-users": "src/matrix-room-users.js"
|
||||
}
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=14.0.0"
|
||||
},
|
||||
"keywords": [
|
||||
"node-red",
|
||||
"matrix",
|
||||
|
||||
@@ -27,30 +27,19 @@
|
||||
<label for="node-input-server"><i class="fa fa-user"></i> Matrix Server Config</label>
|
||||
<input type="text" id="node-input-server">
|
||||
</div>
|
||||
|
||||
<div class="form-tips" style="margin-bottom: 12px;">
|
||||
User must be an admin to use this endpoint.
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-create-room">
|
||||
<h3>Details</h3>
|
||||
<p>
|
||||
Create a room with the defined options in <code>msg.payload</code>
|
||||
</p>
|
||||
<a href="https://matrix-org.github.io/synapse/develop/admin_api/room_membership.html#edit-room-membership-api" target="_blank">Synapse API Endpoint Information</a>
|
||||
<p>Create a Matrix room</p>
|
||||
<a href="https://matrix.org/docs/spec/client_server/r0.4.0#id266" target="_blank">Matrix API Endpoint Information</a>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload
|
||||
<span class="property-type">string</span>
|
||||
<dt class="optional">msg.payload
|
||||
<span class="property-type">string | object | null</span>
|
||||
</dt>
|
||||
<dd> a list of options to pass to the /createRoom API. <a href="https://matrix.org/docs/spec/client_server/r0.4.0#id266">Click here</a> for information about what can be passed.</dd>
|
||||
|
||||
<dt>msg.userId
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> User's ID that will be set into the room.</dd>
|
||||
<dd> a list of options to pass to the /createRoom API. <a href="https://matrix.org/docs/spec/client_server/latest#post-matrix-client-r0-createroom">Click here</a> for information about what can be passed. If this is a string it just sets the room name and ignores other options.</dd>
|
||||
</dl>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
|
||||
@@ -53,7 +53,6 @@ module.exports = function(RED) {
|
||||
};
|
||||
}
|
||||
|
||||
// we need the status code, so set onlydata to false for this request
|
||||
node.server.matrixClient
|
||||
.createRoom(msg.payload || {})
|
||||
.then(function(e){
|
||||
|
||||
@@ -25,22 +25,22 @@
|
||||
|
||||
<script type="text/html" data-help-name="matrix-decrypt-file">
|
||||
<h3>Details</h3>
|
||||
<p>Files sent in an encrypted room are themselves encrypted. Use this node to encrypt/decrypt files. Note: This node will download the encryted file (required to decrypt)</p>
|
||||
<p>Files sent in an encrypted room are themselves encrypted. Use this node to encrypt/decrypt files. Note: This node will download the encrypted file so be cautious of large downloads.</p>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.content
|
||||
<span class="property-type">Object</span>
|
||||
<span class="property-type">object</span>
|
||||
</dt>
|
||||
<dd> content of the decrypted message</dd>
|
||||
|
||||
<dt>msg.content.file
|
||||
<span class="property-type">Object</span>
|
||||
<span class="property-type">object</span>
|
||||
</dt>
|
||||
<dd> the information needed to decode the file</dd>
|
||||
|
||||
<dt>msg.url
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> the decoded mxc url.</dd>
|
||||
</dl>
|
||||
@@ -57,6 +57,9 @@
|
||||
|
||||
<dt>msg.filename <span class="property-type">string</span></dt>
|
||||
<dd>filename of the decoded file (if content.filename isn't defined on the message we fallback to content.body).</dd>
|
||||
|
||||
<dt>msg.thumbnail_payload <span class="property-type">buffer</span></dt>
|
||||
<dd>If the file is an image then this property is set to the buffer of the thumbnail. If not an image this is left off.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
module.exports = function(RED) {
|
||||
const got = require('got');
|
||||
const crypto = require('isomorphic-webcrypto');
|
||||
|
||||
function MatrixDecryptFile(n) {
|
||||
@@ -10,6 +9,8 @@ module.exports = function(RED) {
|
||||
this.name = n.name;
|
||||
|
||||
node.on("input", async function (msg) {
|
||||
const { got } = await import('got');
|
||||
|
||||
if(!msg.type) {
|
||||
node.error('msg.type is required.');
|
||||
return;
|
||||
|
||||
@@ -8,7 +8,8 @@
|
||||
outputs: 2,
|
||||
defaults: {
|
||||
name: { value: null },
|
||||
server: { value: "", type: "matrix-server-config" }
|
||||
server: { value: "", type: "matrix-server-config" },
|
||||
roomId: { value: null },
|
||||
},
|
||||
label: function() {
|
||||
return this.name || "Room Invite";
|
||||
@@ -27,12 +28,17 @@
|
||||
<label for="node-input-server"><i class="fa fa-user"></i> Matrix Server Config</label>
|
||||
<input type="text" id="node-input-server">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-invite-room">
|
||||
<h3>Details</h3>
|
||||
<p>
|
||||
This API invites a user to participate in a particular room. They do not start participating in the room until they actually join the room.
|
||||
This node invites a user to participate in a particular room. They do not start participating in the room until they actually join the room. The client must be in the room and have permissions to invite.
|
||||
</p>
|
||||
<a href="https://matrix-org.github.io/synapse/develop/admin_api/room_membership.html#edit-room-membership-api" target="_blank">Synapse API Endpoint Information</a>
|
||||
|
||||
@@ -41,7 +47,7 @@
|
||||
<dt>msg.topic
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> The room identifier to invite to: for example, <code>!h8zld9j31:example.com. If configured on the node it overrides this input and is no longer required.</code>.</dd>
|
||||
<dd> The room identifier to invite to: for example, <code>!h8zld9j31:example.com</code>. Ignored if configured on the node, otherwise required.</dd>
|
||||
|
||||
<dt>msg.userId
|
||||
<span class="property-type">string</span>
|
||||
|
||||
@@ -6,6 +6,7 @@ module.exports = function(RED) {
|
||||
|
||||
this.name = n.name;
|
||||
this.server = RED.nodes.getNode(n.server);
|
||||
this.roomId = n.roomId;
|
||||
|
||||
if(!this.server) {
|
||||
node.error('Server must be configured on the node.');
|
||||
@@ -47,7 +48,7 @@ module.exports = function(RED) {
|
||||
|
||||
msg.topic = node.roomId || msg.topic;
|
||||
if(!msg.topic) {
|
||||
node.error("msg.topic must be defined or configured on the node.");
|
||||
node.error("room must be defined in either msg.topic or in node config");
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -58,7 +59,7 @@ module.exports = function(RED) {
|
||||
msg.payload = e;
|
||||
node.send([msg, null]);
|
||||
}).catch(function(e){
|
||||
node.warn("Error creating room " + e);
|
||||
node.warn("Error inviting to room " + e);
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
|
||||
@@ -26,25 +26,22 @@
|
||||
<label for="node-input-server"><i class="fa fa-user"></i> Matrix Server Config</label>
|
||||
<input type="text" id="node-input-server">
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Room ID must either be defined here or passed in via <code>msg.topic</code>. The config takes precedence over the input.
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-join-room">
|
||||
<h3>Details</h3>
|
||||
<p>This API starts a user participating in a particular room, if that user is allowed to participate in that room. After this call, the client is allowed to see all current state events in the room, and all subsequent events associated with the room until the user leaves the room.</p>
|
||||
<p>This node starts the client participating in a particular room, if the client is allowed to participate in that room. After this call, the client is allowed to see all current state events in the room, and all subsequent events associated with the room until the user leaves the room.</p>
|
||||
<a href="https://matrix.org/docs/spec/client_server/latest#id291" target="_blank">Matrix API Endpoint Information</a>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.topic
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> The room identifier or alias to join.</dd>
|
||||
|
||||
<dt class="optional">msg.joinOpts
|
||||
<span class="property-type">Object</span>
|
||||
<span class="property-type">object | null</span>
|
||||
</dt>
|
||||
<dd> Extra options that can be passed when joining a room.</dd>
|
||||
|
||||
@@ -62,11 +59,6 @@
|
||||
<span class="property-type">[string]</span>
|
||||
</dt>
|
||||
<dd> The servers to attempt to join the room through. One of the servers must be participating in the room.</dd>
|
||||
|
||||
<dt class="optional">msg.reason
|
||||
<span class="property-type">String</span>
|
||||
</dt>
|
||||
<dd> Reason for kicking the user.</dd>
|
||||
</dl>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
|
||||
@@ -38,11 +38,6 @@ module.exports = function(RED) {
|
||||
return;
|
||||
}
|
||||
|
||||
if(!msg.userId) {
|
||||
node.error("msg.userId was not set.");
|
||||
return;
|
||||
}
|
||||
|
||||
node.server.matrixClient.joinRoom(msg.topic, msg.joinOpts || {})
|
||||
.then(function(e) {
|
||||
msg.payload = e;
|
||||
|
||||
@@ -29,33 +29,7 @@
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId">
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-messageType">
|
||||
Message Type
|
||||
</label>
|
||||
<select id="node-input-messageType">
|
||||
<option value="m.text">m.text</option>
|
||||
<option value="m.notice">m.notice</option>
|
||||
<option value="msg.type">msg.type input</option>
|
||||
</select>
|
||||
<div class="form-tips">
|
||||
It's recommended to use m.notice for bots because the message will render in a lighter text (at least in Element client) for users to distinguish bot and real user messages.
|
||||
</div>
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-messageFormat">
|
||||
Message Format
|
||||
</label>
|
||||
<select id="node-input-messageFormat">
|
||||
<option value="">Default (plaintext)</option>
|
||||
<option value="html">HTML</option>
|
||||
<option value="msg.format">msg.format input</option>
|
||||
</select>
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Must be a valid <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
</script>
|
||||
|
||||
@@ -66,18 +40,18 @@
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Usually an emoji but can also be text. </dd>
|
||||
|
||||
<dt>msg.topic
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> Room ID to send image to. Optional if configured on the node. If configured on the node this will be ignored.</dd>
|
||||
|
||||
<dt>msg.referenceEventId<br />
|
||||
msg.eventId
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> One of these is required. This is the eventId of the message to react to. Uses <code>msg.referenceEventId</code> first and falls back to <code>msg.eventId</code>.</dd>
|
||||
</dl>
|
||||
@@ -86,8 +60,6 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the posted reaction.</dd>
|
||||
</dl>
|
||||
|
||||
@@ -53,16 +53,14 @@ module.exports = function(RED) {
|
||||
|
||||
msg.type = 'm.reaction';
|
||||
|
||||
node.server.matrixClient.sendCompleteEvent(
|
||||
node.server.matrixClient.sendEvent(
|
||||
msg.topic,
|
||||
'm.reaction',
|
||||
{
|
||||
type: 'm.reaction',
|
||||
content: {
|
||||
"m.relates_to": {
|
||||
event_id: eventId,
|
||||
key: msg.payload,
|
||||
rel_type: "m.annotation"
|
||||
}
|
||||
"m.relates_to": {
|
||||
event_id: eventId,
|
||||
key: msg.payload,
|
||||
rel_type: "m.annotation"
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
@@ -107,7 +107,7 @@
|
||||
<p>Receive events from Matrix.</p>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
<ol class="node-ports">
|
||||
<ul class="node-ports">
|
||||
<li>Always Returned
|
||||
<dl class="message-properties">
|
||||
<dt>msg.type <span class="property-type">string</span></dt>
|
||||
@@ -146,6 +146,11 @@
|
||||
<dd>the event object returned by the Matrix server</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.eventId <span class="property-type">object</span></dt>
|
||||
<dd>The event ID, e.g. $143350589368169JsLZx:localhost</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.content <span class="property-type">object</span></dt>
|
||||
<dd>the message's content object</dd>
|
||||
@@ -159,11 +164,6 @@
|
||||
</li>
|
||||
|
||||
<li><code>msg.type</code> == '<strong>m.reaction</strong>'
|
||||
<dl class="message-properties">
|
||||
<dt>msg.info <span class="property-type">object</span></dt>
|
||||
<dd>the content's info.</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.referenceEventId <span class="property-type">string</span></dt>
|
||||
<dd>the message that the reaction relates to</dd>
|
||||
@@ -187,39 +187,64 @@
|
||||
<dd>URL to the sticker image</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.mxc_url <span class="property-type">string</span></dt>
|
||||
<dd>Matrix URL to the sticker image</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.thumbnail_url <span class="property-type">string</span></dt>
|
||||
<dd>URL to the thumbnail of the sticker</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.thumbnail_mxc_url <span class="property-type">string</span></dt>
|
||||
<dd>Matrix URL to the thumbnail of the sticker</dd>
|
||||
</dl>
|
||||
</li>
|
||||
|
||||
<li><code>msg.type</code> == '<strong>m.file</strong>'
|
||||
<dl class="message-properties">
|
||||
<dt>msg.file.info <span class="property-type">string</span></dt>
|
||||
<dd>the content's info.</dd>
|
||||
<dt>msg.filename <span class="property-type">string</span></dt>
|
||||
<dd>the file's parsed filename</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.file.url <span class="property-type">string</span></dt>
|
||||
<dt>msg.url <span class="property-type">string</span></dt>
|
||||
<dd>the file's URL</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.mxc_url <span class="property-type">string</span></dt>
|
||||
<dd>the file's Matrix URL</dd>
|
||||
</dl>
|
||||
</li>
|
||||
|
||||
<li><code>msg.type</code> == '<strong>m.image</strong>'
|
||||
<dl class="message-properties">
|
||||
<dt>msg.image.info <span class="property-type">string</span></dt>
|
||||
<dd>the image info.</dd>
|
||||
<dt>msg.filename <span class="property-type">string</span></dt>
|
||||
<dd>the image's parsed filename</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.file.url <span class="property-type">string</span></dt>
|
||||
<dt>msg.url <span class="property-type">string</span></dt>
|
||||
<dd>the image's URL</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.file.thumbnail_url <span class="property-type">string</span></dt>
|
||||
<dt>msg.mxc_url <span class="property-type">string</span></dt>
|
||||
<dd>the image's Matrix URL</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.thumbnail_url <span class="property-type">string</span></dt>
|
||||
<dd>the image's thumbnail URL</dd>
|
||||
</dl>
|
||||
|
||||
<dl class="message-properties">
|
||||
<dt>msg.thumbnail_mxc_url <span class="property-type">string</span></dt>
|
||||
<dd>the image's thumbnail Matrix URL</dd>
|
||||
</dl>
|
||||
</li>
|
||||
</ol>
|
||||
</ul>
|
||||
</script>
|
||||
@@ -22,7 +22,7 @@ module.exports = function(RED) {
|
||||
return;
|
||||
}
|
||||
|
||||
node.server.on("disconnected", function() {
|
||||
node.server.on("disconnected", function(){
|
||||
node.status({ fill: "red", shape: "ring", text: "disconnected" });
|
||||
});
|
||||
|
||||
@@ -30,43 +30,12 @@ module.exports = function(RED) {
|
||||
node.status({ fill: "green", shape: "ring", text: "connected" });
|
||||
});
|
||||
|
||||
node.server.on("Room.timeline", async function(event, room, toStartOfTimeline, data) {
|
||||
if (toStartOfTimeline) {
|
||||
return; // ignore paginated results
|
||||
}
|
||||
if (!event.getSender() || event.getSender() === node.server.userId) {
|
||||
return; // ignore our own messages
|
||||
}
|
||||
if (!event.getUnsigned() || event.getUnsigned().age > 1000) {
|
||||
return; // ignore old messages
|
||||
}
|
||||
|
||||
node.server.on("Room.timeline", async function(event, room, toStartOfTimeline, removed, data, msg) {
|
||||
// if node has a room ID set we only listen on that room
|
||||
if(node.roomIds.length && node.roomIds.indexOf(room.roomId) === -1) {
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
await node.server.matrixClient.decryptEventIfNeeded(event);
|
||||
} catch (error) {
|
||||
node.error(error);
|
||||
return;
|
||||
}
|
||||
|
||||
let msg = {
|
||||
encrypted : event.isEncrypted(),
|
||||
redacted : event.isRedacted(),
|
||||
content : event.getContent(),
|
||||
type : (event.getContent()['msgtype'] || event.getType()) || null,
|
||||
payload : (event.getContent()['body'] || event.getContent()) || null,
|
||||
userId : event.getSender(),
|
||||
topic : event.getRoomId(),
|
||||
eventId : event.getId(),
|
||||
event : event,
|
||||
};
|
||||
|
||||
node.log("Received" + (msg.encrypted ? ' encrypted' : '') +" timeline event [" + msg.type + "]: (" + room.name + ") " + event.getSender() + " :: " + msg.content.body);
|
||||
|
||||
switch(msg.type) {
|
||||
case 'm.emote':
|
||||
if(!node.acceptEmotes) return;
|
||||
@@ -81,16 +50,19 @@ module.exports = function(RED) {
|
||||
if(msg.content.info) {
|
||||
if(msg.content.info.thumbnail_url) {
|
||||
msg.thumbnail_url = node.server.matrixClient.mxcUrlToHttp(msg.content.info.thumbnail_url);
|
||||
msg.thumbnail_mxc_url = msg.content.info.thumbnail_url;
|
||||
}
|
||||
|
||||
if(msg.content.url) {
|
||||
msg.url = node.server.matrixClient.mxcUrlToHttp(msg.content.url);
|
||||
msg.mxc_url = msg.content.url;
|
||||
}
|
||||
}
|
||||
break;
|
||||
|
||||
case 'm.file':
|
||||
if(!node.acceptFiles) return;
|
||||
msg.filename = msg.content.filename || msg.content.body;
|
||||
if(msg.encrypted) {
|
||||
msg.url = node.server.matrixClient.mxcUrlToHttp(msg.content.file.url);
|
||||
msg.mxc_url = msg.content.file.url;
|
||||
@@ -102,7 +74,7 @@ module.exports = function(RED) {
|
||||
|
||||
case 'm.image':
|
||||
if(!node.acceptImages) return;
|
||||
|
||||
msg.filename = msg.content.filename || msg.content.body;
|
||||
if(msg.encrypted) {
|
||||
msg.url = node.server.matrixClient.mxcUrlToHttp(msg.content.file.url);
|
||||
msg.mxc_url = msg.content.file.url;
|
||||
|
||||
@@ -31,9 +31,6 @@
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Room ID must either be defined here or passed in via <code>msg.topic</code>. The config takes precedence over the input.
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-room-ban">
|
||||
@@ -42,18 +39,18 @@
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt class="optional">msg.userId
|
||||
<span class="property-type">String</span>
|
||||
<dt>msg.userId
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> The ID of the user to ban.</dd>
|
||||
|
||||
<dt class="optional">msg.topic
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> The room to ban the user from. Required if not defined on the config. Config takes precedence.</dd>
|
||||
<dd> The room to ban the user from. Ignored if configured on the node, otherwise required.</dd>
|
||||
|
||||
<dt class="optional">msg.reason
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Reason for banning the user.</dd>
|
||||
</dl>
|
||||
@@ -62,7 +59,8 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved. Node doesn't set anything.</dd>
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the ban event.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -31,9 +31,6 @@
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Room ID must either be defined here or passed in via <code>msg.topic</code>. The config takes precedence over the input.
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-room-kick">
|
||||
@@ -43,17 +40,17 @@
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.userId
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> The ID of the user to kick.</dd>
|
||||
|
||||
<dt class="optional">msg.topic
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> The room to kick the user from. Required if not defined on the config. Config takes precedence.</dd>
|
||||
<dd> The room to kick the user from. Ignored if configured on the node, otherwise required.</dd>
|
||||
|
||||
<dt class="optional">msg.reason
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Reason for kicking the user.</dd>
|
||||
</dl>
|
||||
@@ -62,7 +59,8 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved. Node doesn't set anything.</dd>
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the kick event.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -31,22 +31,19 @@
|
||||
<label for="node-input-server"><i class="fa fa-user"></i> Room Id</label>
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
This only works on Synapse servers. The user also must be an administrator.
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-room-users">
|
||||
<h3>Details</h3>
|
||||
<p>A list of members of the room. If you are joined to the room then this will be the current members of the room. If you have left the room then this will be the members of the room when you left.</p>
|
||||
<p>This node returns a map of MXIDs to member info objects for members of the room. The current user must be in the room for it to work, unless it is an Application Service in which case any of the AS's users must be in the room. This API is primarily for Application Services and should be faster to respond than /members as it can be implemented more efficiently on the server.</p>
|
||||
<a href="https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-rooms-roomid-joined-members" target="_blank">Matrix API Endpoint Information</a>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt class="optional">msg.topic
|
||||
<span class="property-type">Integer</span>
|
||||
<span class="property-type">integer</span>
|
||||
</dt>
|
||||
<dd> Room ID to get member list from. Required if not configured on the node.</dd>
|
||||
<dd> Room ID to get member list from. Ignored if configured on the node, otherwise it's required.</dd>
|
||||
</dl>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
|
||||
@@ -30,14 +30,14 @@
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId">
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-contentType"><i class="fa fa-user"></i> Content-Type</label>
|
||||
<input type="text" id="node-input-contentType" placeholder="application/pdf">
|
||||
<input type="text" id="node-input-contentType" placeholder="msg.contentType">
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Must be a valid <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>
|
||||
Must be a valid <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a> (ex: application/pdf) or left empty
|
||||
</div>
|
||||
</script>
|
||||
|
||||
@@ -48,36 +48,42 @@
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload
|
||||
<span class="property-type">File | String | Buffer | ReadStream | Blob</span>
|
||||
<span class="property-type">File | string | Buffer | ReadStream | Blob</span>
|
||||
</dt>
|
||||
<dd> the contents of the file to upload. </dd>
|
||||
|
||||
<dt>msg.topic
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Room ID to send file to. Optional if configured on the node. Overrides node configuration if set.</dd>
|
||||
<dd> Room ID to send file to. Ignored if configured on the node, otherwise required.</dd>
|
||||
|
||||
<dt class="optional">msg.filename
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> name of the file to upload (optional). Overrides node configuration.</dd>
|
||||
|
||||
<dt class="optional">msg.contentType
|
||||
<span class="property-type">String | Null</span>
|
||||
</dt>
|
||||
<dd> Content <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>. Optional if configured on the node. Overrides node configuration if set.</dd>
|
||||
<dd> name of the file to upload (optional). Note: If this is not defined the file will receive a randomly generated name (without an extension).</dd>
|
||||
|
||||
<dt class="optional">msg.body
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> this will be the display name the client will see when rendered in their chat client. If this is left empty the it uses <code>msg.filename</code>. If <code>msg.filename</code> is also undefined it sets it to empty string</dd>
|
||||
<dd> this will be the display name the client will see when rendered in their chat client. If this is left empty it will just display as "Attachment".</dd>
|
||||
|
||||
<dt class="optional">msg.contentType
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> Content <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>. Optional but highly recommended (so the client receiving knows what type of file it is).</dd>
|
||||
|
||||
<dt class="optional">msg.content
|
||||
<span class="property-type">object | null</span>
|
||||
</dt>
|
||||
<dd> craft your own msg.content to send to the server. If defined then <code>msg.filename</code>, <code>msg.contentType</code>, <code>msg.body</code>, and <code>msg.payload</code> aren't required since the file already exists.</dd>
|
||||
</dl>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the posted message.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -61,17 +61,12 @@ module.exports = function(RED) {
|
||||
return;
|
||||
}
|
||||
|
||||
msg.contentType = msg.contentType || node.contentType;
|
||||
if(!msg.contentType) {
|
||||
node.error('msg.contentType is required');
|
||||
return;
|
||||
}
|
||||
|
||||
msg.contentType = node.contentType || msg.contentType || null;
|
||||
node.log("Uploading file " + msg.filename);
|
||||
node.server.matrixClient.uploadContent(
|
||||
msg.payload, {
|
||||
name: msg.filename || null, // Name to give the file on the server.
|
||||
rawResponse: (msg.rawResponse || false), // Return the raw body, rather than parsing the JSON.
|
||||
rawResponse: false, // Return the raw body, rather than parsing the JSON.
|
||||
type: msg.contentType, // Content-type for the upload. Defaults to file.type, or applicaton/octet-stream.
|
||||
onlyContentUri: false // Just return the content URI, rather than the whole body. Defaults to false. Ignored if opts.rawResponse is true.
|
||||
})
|
||||
@@ -79,18 +74,18 @@ module.exports = function(RED) {
|
||||
const content = {
|
||||
msgtype: 'm.file',
|
||||
url: file.content_uri,
|
||||
body: (msg.body || msg.filename) || "",
|
||||
body: msg.body || "",
|
||||
};
|
||||
node.server.matrixClient
|
||||
.sendMessage(msg.topic, content)
|
||||
.then(function(imgResp) {
|
||||
node.log("File message sent: " + imgResp);
|
||||
msg.eventId = e.eventId;
|
||||
.then(function(e) {
|
||||
node.log("File message sent: " + e);
|
||||
msg.eventId = e.event_id;
|
||||
node.send([msg, null]);
|
||||
})
|
||||
.catch(function(e){
|
||||
node.warn("Error sending file message " + e);
|
||||
msg.matrixError = e;
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
}).catch(function(e){
|
||||
|
||||
@@ -30,50 +30,50 @@
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId">
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-input-contentType"><i class="fa fa-user"></i> Content-Type</label>
|
||||
<input type="text" id="node-input-contentType" placeholder="application/png">
|
||||
<input type="text" id="node-input-contentType" placeholder="msg.contentType">
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Must be a valid <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>
|
||||
Must be a valid <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a> (ex: image/png) or left empty
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-send-image">
|
||||
<h3>Details</h3>
|
||||
<p>This node will send an image to a Matrix chat room. You can link this directly to a File In node.</p>
|
||||
<p>This node will send an image to a Matrix chat room. Supports direct linking to a File In node. It's recommended you set <code>msg.contentType</code> so the client knows how to render the image (otherwise the image could show blank).</p>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload
|
||||
<span class="property-type">File | String | Buffer | ReadStream | Blob</span>
|
||||
<span class="property-type">File | string | Buffer | ReadStream | Blob</span>
|
||||
</dt>
|
||||
<dd> the contents of the image to upload. </dd>
|
||||
|
||||
<dt>msg.topic
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Room ID to send image to. Optional if configured on the node. Overrides node configuration if set.</dd>
|
||||
<dd> Room ID to send image to. Ignored if configured on the node, otherwise required.</dd>
|
||||
|
||||
<dt class="optional">msg.filename
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> name of the image file to upload (optional). Overrides node configuration.</dd>
|
||||
|
||||
<dt class="optional">msg.contentType
|
||||
<span class="property-type">String | Null</span>
|
||||
</dt>
|
||||
<dd> Content <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>. Optional if configured on the node. Overrides node configuration if set.</dd>
|
||||
<dd> name of the image to upload (optional). Note: If this is not defined the file will receive a randomly generated name (without an extension).</dd>
|
||||
|
||||
<dt class="optional">msg.body
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> this will be the display name the client will see when rendered in their chat client. If this is left empty the it uses <code>msg.filename</code>. If <code>msg.filename</code> is also undefined it sets it to empty string</dd>
|
||||
<dd> this will be the display name the client will see when rendered in their chat client. If this is left empty it will just display as "Attachment".</dd>
|
||||
|
||||
<dt class="optional">msg.contentType
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> Content <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>. Overridden if configured on the node. Optional but highly recommended (so the client receiving knows what type of file it is).</dd>
|
||||
|
||||
<dt class="optional">msg.content
|
||||
<span class="property-type">Object | Null</span>
|
||||
<span class="property-type">object | null</span>
|
||||
</dt>
|
||||
<dd> craft your own msg.content to send to the server. If defined then <code>msg.filename</code>, <code>msg.contentType</code>, <code>msg.body</code>, and <code>msg.payload</code> aren't required since the file already exists.</dd>
|
||||
</dl>
|
||||
@@ -82,8 +82,6 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the posted message.</dd>
|
||||
</dl>
|
||||
|
||||
@@ -61,37 +61,40 @@ module.exports = function(RED) {
|
||||
return;
|
||||
}
|
||||
|
||||
msg.contentType = msg.contentType || node.contentType;
|
||||
if(!msg.contentType) {
|
||||
node.error('msg.contentType is required');
|
||||
return;
|
||||
}
|
||||
|
||||
msg.contentType = node.contentType || msg.contentType || null;
|
||||
node.log("Uploading image " + msg.filename);
|
||||
node.server.matrixClient.uploadContent(
|
||||
msg.payload, {
|
||||
name: msg.filename || null, // Name to give the file on the server.
|
||||
rawResponse: (msg.rawResponse || false), // Return the raw body, rather than parsing the JSON.
|
||||
rawResponse: false, // Return the raw body, rather than parsing the JSON.
|
||||
type: msg.contentType, // Content-type for the upload. Defaults to file.type, or applicaton/octet-stream.
|
||||
onlyContentUri: false // Just return the content URI, rather than the whole body. Defaults to false. Ignored if opts.rawResponse is true.
|
||||
})
|
||||
.then(function(file){
|
||||
node.server.matrixClient
|
||||
.sendImageMessage(msg.topic, file.content_uri, {}, (msg.body || msg.filename) || "")
|
||||
.sendImageMessage(
|
||||
msg.topic,
|
||||
file.content_uri,
|
||||
{},
|
||||
(msg.body || msg.filename) || null,
|
||||
null
|
||||
)
|
||||
.then(function(e) {
|
||||
node.log("Image message sent: " + e);
|
||||
msg.eventId = e.event_id;
|
||||
msg.content_uri_mxc = file.content_uri;
|
||||
msg.content_uri = node.server.matrixClient.mxcUrlToHttp(file.content_uri);
|
||||
node.send([msg, null]);
|
||||
})
|
||||
.catch(function(e){
|
||||
node.warn("Error sending image message " + e);
|
||||
node.warn("Error sending image message: " + e);
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
})
|
||||
.catch(function(e){
|
||||
node.warn("Error uploading image message " + e);
|
||||
msg.matrixError = e;
|
||||
node.warn("Error uploading image message: " + e);
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
});
|
||||
|
||||
@@ -25,14 +25,17 @@
|
||||
<label for="node-input-name"><i class="icon-tag"></i> Name</label>
|
||||
<input type="text" id="node-input-name" placeholder="Name">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-input-server"><i class="fa fa-user"></i> Matrix Server Config</label>
|
||||
<input type="text" id="node-input-server">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-input-roomId"><i class="fa fa-user"></i> Room ID</label>
|
||||
<input type="text" id="node-input-roomId">
|
||||
<input type="text" id="node-input-roomId" placeholder="msg.topic">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-input-messageType">
|
||||
Message Type
|
||||
@@ -42,10 +45,11 @@
|
||||
<option value="m.notice">m.notice</option>
|
||||
<option value="msg.type">msg.type input</option>
|
||||
</select>
|
||||
<div class="form-tips">
|
||||
It's recommended to use m.notice for bots because the message will render in a lighter text (at least in Element client) for users to distinguish bot and real user messages.
|
||||
</div>
|
||||
</div>
|
||||
<div class="form-row form-tips">
|
||||
It's recommended to use m.notice for bots because the message will render in a lighter text (at least in Element client) for users to distinguish bot and real user messages.
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-input-messageFormat">
|
||||
Message Format
|
||||
@@ -56,49 +60,44 @@
|
||||
<option value="msg.format">msg.format input</option>
|
||||
</select>
|
||||
</div>
|
||||
<div class="form-tips">
|
||||
Must be a valid <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types" target="_blank">MIME Type</a>
|
||||
</div>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-send-message">
|
||||
<h3>Details</h3>
|
||||
<p>Sends a message to a Matrix room.</p>
|
||||
<p>Sends a message to a Matrix room. Messages are auto encrypted if necessary.</p>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.topic
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Room ID to send image to. Optional if configured on the node. If configured on the node this input will be overridden.</dd>
|
||||
|
||||
<dt>msg.payload
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> the message text. </dd>
|
||||
|
||||
<dt class="optional">msg.formatted_payload
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> the formatted HTML message (uses msg.payload if not defined). This only affects HTML messages.</dd>
|
||||
|
||||
<dt>msg.topic
|
||||
<span class="property-type">String | Null</span>
|
||||
</dt>
|
||||
<dd> Room ID to send image to. Optional if configured on the node. Overrides node configuration if set.</dd>
|
||||
|
||||
<dt class="optional">msg.type
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> This is only used and required when configured so on the node. Must be set to either 'm.text' or 'm.notice'</dd>
|
||||
<dd> This is only used and required when configured so on the node. Must be set to either <code>'m.text'</code> or <code>'m.notice'</code></dd>
|
||||
|
||||
<dt class="optional">msg.format
|
||||
<span class="property-type">String | Null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> This is only used and required when configured so on the node. Set to null for plain text and 'html' for HTML.</dd>
|
||||
<dd> This is only used and required when configured so on the node. Set to <code>null</code> for plain text and <code>'html'</code> for HTML.</dd>
|
||||
</dl>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the posted message.</dd>
|
||||
</dl>
|
||||
|
||||
@@ -89,6 +89,7 @@ module.exports = function(RED) {
|
||||
if(!node.server.isConnected()) {
|
||||
node.error("Matrix server connection is currently closed");
|
||||
node.send([null, msg]);
|
||||
return;
|
||||
}
|
||||
|
||||
msg.topic = node.roomId || msg.topic;
|
||||
@@ -109,13 +110,16 @@ module.exports = function(RED) {
|
||||
|
||||
if(msgFormat === 'html') {
|
||||
content.format = "org.matrix.custom.html";
|
||||
content.formatted_body = msg.formatted_payload || msg.payload;
|
||||
content.formatted_body =
|
||||
(typeof msg.formatted_payload !== 'undefined' && msg.formatted_payload)
|
||||
? msg.formatted_payload.toString()
|
||||
: msg.payload.toString();
|
||||
}
|
||||
|
||||
node.server.matrixClient.sendMessage(msg.topic, content)
|
||||
.then(function(e) {
|
||||
node.log("Message sent: " + msg.payload);
|
||||
msg.eventId = e.eventId;
|
||||
msg.eventId = e.event_id;
|
||||
node.send([msg, null]);
|
||||
})
|
||||
.catch(function(e){
|
||||
|
||||
@@ -1,17 +1,42 @@
|
||||
<style>
|
||||
.matrix-loader {
|
||||
border: 8px solid #f3f3f3;
|
||||
border-radius: 50%;
|
||||
border-top: 8px solid #3498db;
|
||||
border-bottom: 8px solid #3498db;
|
||||
width: 20px;
|
||||
height: 20px;
|
||||
-webkit-animation: matrix-spin 2s linear infinite;
|
||||
animation: matrix-spin 2s linear infinite;
|
||||
}
|
||||
|
||||
@-webkit-keyframes matrix-spin {
|
||||
0% { -webkit-transform: rotate(0deg); }
|
||||
100% { -webkit-transform: rotate(360deg); }
|
||||
}
|
||||
|
||||
@keyframes matrix-spin {
|
||||
0% { transform: rotate(0deg); }
|
||||
100% { transform: rotate(360deg); }
|
||||
}
|
||||
</style>
|
||||
|
||||
<script type="text/javascript">
|
||||
RED.nodes.registerType('matrix-server-config',{
|
||||
category: 'config',
|
||||
color: '#00b7ca',
|
||||
credentials: {
|
||||
userId: { type: "text", required: true },
|
||||
deviceLabel: { type: "text", required: false },
|
||||
accessToken: { type: "password", required: true },
|
||||
deviceId: { type: "text", required: true },
|
||||
deviceId: { type: "text", required: false },
|
||||
url: { type: "text", required: true }
|
||||
},
|
||||
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() {
|
||||
@@ -25,35 +50,58 @@
|
||||
<label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
|
||||
<input type="text" id="node-config-input-name" placeholder="Name">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-userId"><i class="fa fa-server"></i> User ID</label>
|
||||
<label for="node-config-input-deviceLabel"><i class="fa fa-tag"></i> Device Label</label>
|
||||
<input type="text" placeholder="Node-RED" id="node-config-input-deviceLabel">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-url"><i class="fa fa-server"></i> Server URL</label>
|
||||
<input type="text" placeholder="https://matrix.org" id="node-config-input-url">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-userId"><i class="fa fa-user"></i> User ID</label>
|
||||
<input type="text" placeholder="@example:matrix.org" id="node-config-input-userId">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-password"><i class="fa fa-key"></i> Password</label>
|
||||
<input type="password" placeholder="" id="node-config-input-password">
|
||||
</div>
|
||||
<div class="form-tips" style="margin-bottom: 12px;">
|
||||
Password is never saved and is only used to fetch an access token using the button below.
|
||||
</div>
|
||||
<pre class="form-tips" id="matrix-chat-login-error" style="color: #721c24;background-color: #f8d7da;border-color: #f5c6cb;margin-bottom: 12px;display:none;"></pre>
|
||||
<pre class="form-tips" id="matrix-chat-login-success" style="color: #155724;background-color: #d4edda;border-color: #c3e6cb;margin-bottom: 12px;display:none;"></pre>
|
||||
<button class="ui-button ui-corner-all ui-widget primary" id="matrix-login-btn">Update Access Token</button>
|
||||
<div class="matrix-loader" id="matrix-access-token-loader" style="display:none;"></div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-accessToken"><i class="fa fa-key"></i> Access Token</label>
|
||||
<input type="text" id="node-config-input-accessToken">
|
||||
</div>
|
||||
<div class="form-tips" style="margin-bottom: 12px;">
|
||||
View the <a href="javascript:$('#red-ui-tab-help-link-button').click();">node docs</a> to figure out how to generate an Access Token. You can also generate them using the Shared Secret Registration node.
|
||||
You can either provide/generate an access token yourself or use the login button above to do it automatically. View the <a href="javascript:$('#red-ui-tab-help-link-button').click();">node docs</a> to figure out how to generate an Access Token manually. If you generated a user with shared secret registration you will already have an access token you can place here.
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-deviceId"><i class="fa fa-key"></i> Device ID</label>
|
||||
<label for="node-config-input-deviceId"><i class="fa fa-desktop"></i> Device ID</label>
|
||||
<input type="text" id="node-config-input-deviceId">
|
||||
</div>
|
||||
<div class="form-tips" style="margin-bottom: 12px;">
|
||||
This can either be an existing Device ID attached to the above Access Token or you can enter a unique value to set a new one.
|
||||
If you have a Device ID for this auth token you can place it here, or you can leave it blank to have one automatically generated (this field will always be blank if auto generated as it is saved internally). DO NOT manually set one, this must be generated by the server.<br />
|
||||
WARNING: If you change this after the client has already initialized you will break encryption. Your Device ID is tied to your encryption keys.
|
||||
</div>
|
||||
<div class="form-row">
|
||||
<label for="node-config-input-url"><i class="fa fa-globe"></i> Server URL</label>
|
||||
<input type="text" placeholder="https://matrix.org" id="node-config-input-url">
|
||||
</div>
|
||||
|
||||
<div class="form-row">
|
||||
<input
|
||||
type="checkbox"
|
||||
id="node-config-input-autoAcceptRoomInvites"
|
||||
style="width: auto; margin-left: 125px; vertical-align: top"
|
||||
/>
|
||||
<label for="node-config-input-autoAcceptRoomInvites" style="width: auto">
|
||||
<label for="node-config-input-autoAcceptRoomInvites" style="width: auto;max-width:50%;">
|
||||
Auto join invited rooms
|
||||
</label>
|
||||
</div>
|
||||
@@ -63,17 +111,107 @@
|
||||
id="node-config-input-enableE2ee"
|
||||
style="width: auto; margin-left: 125px; vertical-align: top"
|
||||
/>
|
||||
<label for="node-config-input-enableE2ee" style="width: auto">
|
||||
Enable end-to-end encryption (requires DeviceID)
|
||||
<label for="node-config-input-enableE2ee" style="width: auto;max-width:50%;">
|
||||
Enable end-to-end encryption
|
||||
</label>
|
||||
</div>
|
||||
|
||||
<div class="form-tips" style="margin-bottom: 12px;">
|
||||
E2ee requires a Device ID to be set.
|
||||
<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 global access is enabled you can access the client directly within a Function node. This way you can do <a href="https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#use-function-node-to-run-any-command" target="_blank">whatever you want</a> with the client. Example:<br>
|
||||
<code style="white-space: normal;">let client = global.get("matrixClient['@bot:example.com']");</code>
|
||||
</div>
|
||||
</div>
|
||||
<script type="text/javascript">
|
||||
$("#matrix-login-btn").on("click", function() {
|
||||
function prettyPrintJson(json) {
|
||||
try{
|
||||
return typeof json === 'object' ? JSON.stringify(json, null, 2) : json;
|
||||
}
|
||||
catch (error){
|
||||
return json;
|
||||
}
|
||||
}
|
||||
|
||||
let userId = $("#node-config-input-userId").val(),
|
||||
userPassword = $("#node-config-input-password").val(),
|
||||
serverUrl = $("#node-config-input-url").val();
|
||||
|
||||
if(!userId) {
|
||||
alert("User ID is required to fetch access token.");
|
||||
return;
|
||||
}
|
||||
if(!userPassword) {
|
||||
alert("Password is required to fetch access token.");
|
||||
return;
|
||||
}
|
||||
if(!serverUrl) {
|
||||
alert("Server URL is required to fetch access token.");
|
||||
return;
|
||||
}
|
||||
|
||||
$("#matrix-login-btn, #matrix-chat-login-error, #matrix-chat-login-success").hide();
|
||||
$("#matrix-access-token-loader").show();
|
||||
$.ajax({
|
||||
type: 'POST',
|
||||
url: '/matrix-chat/login',
|
||||
dataType: 'json',
|
||||
data: {
|
||||
'userId': userId,
|
||||
'password': userPassword,
|
||||
'baseUrl': serverUrl,
|
||||
'displayName': $("#node-config-input-deviceLabel").val(),
|
||||
}
|
||||
}).then(
|
||||
function(data) {
|
||||
if(data.result && data.result === 'ok') {
|
||||
$("#matrix-chat-login-error").hide();
|
||||
$("#matrix-chat-login-success")
|
||||
.html("Login Successful! Auth Token and Device ID have been set below.")
|
||||
.show();
|
||||
|
||||
$("#node-config-input-accessToken").val(data.token);
|
||||
$("#node-config-input-deviceId").val(data.device_id);
|
||||
} else if(data.result && data.result === 'error') {
|
||||
$("#matrix-chat-login-success").hide();
|
||||
$("#matrix-chat-login-error")
|
||||
.html(data.message ? ('Failed to login: <br />' + prettyPrintJson(data.message)) : 'Failed to login')
|
||||
.show();
|
||||
}
|
||||
$("#matrix-login-btn").show();
|
||||
$("#matrix-access-token-loader").hide();
|
||||
}, function() {
|
||||
$("#matrix-chat-login-success").hide();
|
||||
$("#matrix-chat-login-error")
|
||||
.html("Failed to login due to server error communicating with Node-RED")
|
||||
.show();
|
||||
$("#matrix-login-btn").show();
|
||||
$("#matrix-access-token-loader").hide();
|
||||
}
|
||||
);
|
||||
});
|
||||
</script>
|
||||
</script>
|
||||
|
||||
<script type="text/html" data-help-name="matrix-server-config">
|
||||
<h3>Details</h3>
|
||||
<p>Matrix client configuration node</p>
|
||||
<p>Matrix client connection configuration</p>
|
||||
|
||||
<h3>Setting up an account</h3>
|
||||
<div>
|
||||
<p>
|
||||
You need an account for your client to use. If you are going to be using End-to-End Encryption you should generate the bot and only use it within Node-RED otherwise if you have other clients connected on the same user it could cause problems with e2ee (key sharing is currently not supported).
|
||||
</p>
|
||||
<p>If you have access to the server directly you can use Shared Secret Registration as described <a href="https://github.com/Skylar-Tech/node-red-contrib-matrix-chat/tree/master/examples#create-user-with-shared-secret-registration" target="_blank" style="text-decoration: underline;">here</a>.</p>
|
||||
<p>If this is a server you do not administrate/have access to follow these instructions:</p>
|
||||
<ol><li>In a private/incognito browser window, open Element.</li><li>Log in to the account you want to get the access token for, such as the bot's account. <strong>Do not setup key storage</strong>.</li><li>Click on the bot's name in the top left corner then "Settings".</li><li>(Optional) Set your bot's display name and avatar.</li><li>Click the "Help & About" tab (left side of the dialog).</li><li>Scroll to the bottom and click the <code><click to reveal></code> part of <code>Access Token: <click to reveal></code>.</li><li>Copy your access token to a safe place, like the bot's configuration file.</li><li><strong>Do not log out.</strong> Instead, just close the window. If you used a private browsing session, you should be able to still use Element for your own account. Logging out deletes the access token from the server, making the bot unable to use it.</li></ol>
|
||||
</div>
|
||||
</script>
|
||||
@@ -1,79 +1,191 @@
|
||||
global.Olm = require('olm');
|
||||
const fs = require("fs-extra");
|
||||
const sdk = require("matrix-js-sdk");
|
||||
const { resolve } = require('path');
|
||||
const { LocalStorage } = require('node-localstorage');
|
||||
const { LocalStorageCryptoStore } = require('matrix-js-sdk/lib/crypto/store/localStorage-crypto-store');
|
||||
|
||||
module.exports = function(RED) {
|
||||
const sdk = require("matrix-js-sdk");
|
||||
const { LocalStorage } = require('node-localstorage');
|
||||
const localStorage = new LocalStorage('./matrix-local-storage');
|
||||
const { LocalStorageCryptoStore } = require('matrix-js-sdk/lib/crypto/store/localStorage-crypto-store');
|
||||
function MatrixFolderNameFromUserId(name) {
|
||||
return name.replace(/[^a-z0-9]/gi, '_').toLowerCase();
|
||||
}
|
||||
|
||||
function MatrixServerNode(n) {
|
||||
// we should add support for getting access token automatically from username/password
|
||||
// ref: https://matrix.org/docs/guides/usage-of-the-matrix-js-sdk#login-with-an-access-token
|
||||
|
||||
let node = this,
|
||||
storageDir = RED.settings.userDir + '/matrix-client-storage';
|
||||
RED.nodes.createNode(this, n);
|
||||
node.setMaxListeners(1000);
|
||||
|
||||
let node = this;
|
||||
node.log("Initializing Matrix Server Config node");
|
||||
|
||||
if(!this.credentials) {
|
||||
this.credentials = {};
|
||||
}
|
||||
|
||||
node.setMaxListeners(1000);
|
||||
|
||||
this.connected = false;
|
||||
this.connected = null;
|
||||
this.name = n.name;
|
||||
this.userId = this.credentials.userId;
|
||||
this.deviceLabel = this.credentials.deviceLabel || null;
|
||||
this.deviceId = this.credentials.deviceId || null;
|
||||
this.url = this.credentials.url;
|
||||
this.autoAcceptRoomInvites = n.autoAcceptRoomInvites;
|
||||
this.enableE2ee = n.enableE2ee || false;
|
||||
this.e2ee = (this.enableE2ee && this.deviceId);
|
||||
this.globalAccess = n.global;
|
||||
this.initializedAt = new Date();
|
||||
|
||||
if(!this.userId) {
|
||||
node.log("Matrix connection failed: missing user ID in configuration.");
|
||||
return;
|
||||
}
|
||||
|
||||
let localStorageDir = storageDir + '/' + MatrixFolderNameFromUserId(this.userId),
|
||||
localStorage = new LocalStorage(localStorageDir),
|
||||
initialSetup = false;
|
||||
|
||||
let retryStartTimeout = null;
|
||||
|
||||
if(!this.credentials.accessToken) {
|
||||
node.log("Matrix connection failed: missing access token.");
|
||||
node.error("Matrix connection failed: missing access token in configuration.");
|
||||
} else if(!this.url) {
|
||||
node.log("Matrix connection failed: missing server URL.");
|
||||
} else if(!this.userId) {
|
||||
node.log("Matrix connection failed: missing user ID.");
|
||||
node.error("Matrix connection failed: missing server URL in configuration.");
|
||||
} else {
|
||||
node.setConnected = function(connected, cb) {
|
||||
if (node.connected !== connected) {
|
||||
node.connected = connected;
|
||||
if(typeof cb === 'function') {
|
||||
cb(connected);
|
||||
}
|
||||
|
||||
if (connected) {
|
||||
node.log("Matrix server connection ready.");
|
||||
node.emit("connected");
|
||||
if(!initialSetup) {
|
||||
// store Device ID internally
|
||||
let stored_device_id = getStoredDeviceId(localStorage),
|
||||
device_id = this.matrixClient.getDeviceId();
|
||||
if(!stored_device_id || stored_device_id !== device_id) {
|
||||
node.log(`Saving Device ID (old:${stored_device_id} new:${device_id})`);
|
||||
storeDeviceId(localStorage, device_id);
|
||||
}
|
||||
|
||||
// update device label
|
||||
if(node.deviceLabel) {
|
||||
node.matrixClient
|
||||
.getDevice(device_id)
|
||||
.then(
|
||||
function(response) {
|
||||
if(response.display_name !== node.deviceLabel) {
|
||||
node.matrixClient.setDeviceDetails(device_id, {
|
||||
display_name: node.deviceLabel
|
||||
}).then(
|
||||
function(response) {},
|
||||
function(error) {
|
||||
node.error("Failed to set device label: " + error);
|
||||
}
|
||||
);
|
||||
}
|
||||
},
|
||||
function(error) {
|
||||
node.error("Failed to fetch device: " + error);
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
initialSetup = true;
|
||||
}
|
||||
} else {
|
||||
node.emit("disconnected");
|
||||
}
|
||||
|
||||
if(this.globalAccess) {
|
||||
this.context().global.set('matrixClientOnline["'+this.userId+'"]', connected);
|
||||
}
|
||||
}
|
||||
};
|
||||
node.setConnected(false);
|
||||
|
||||
fs.ensureDirSync(storageDir); // create storage directory if it doesn't exist
|
||||
upgradeDirectoryIfNecessary(node, storageDir);
|
||||
node.matrixClient = sdk.createClient({
|
||||
baseUrl: this.url,
|
||||
accessToken: this.credentials.accessToken,
|
||||
sessionStore: new sdk.WebStorageSessionStore(localStorage),
|
||||
cryptoStore: new LocalStorageCryptoStore(localStorage),
|
||||
userId: this.userId,
|
||||
deviceId: this.deviceId || undefined,
|
||||
deviceId: (this.deviceId || getStoredDeviceId(localStorage)) || undefined
|
||||
});
|
||||
|
||||
node.on('close', function(done) {
|
||||
if(node.matrixClient) {
|
||||
node.matrixClient.close();
|
||||
// set globally if configured to do so
|
||||
if(this.globalAccess) {
|
||||
this.context().global.set('matrixClient["'+this.userId+'"]', node.matrixClient);
|
||||
}
|
||||
|
||||
function stopClient() {
|
||||
if(node.matrixClient && node.matrixClient.clientRunning) {
|
||||
node.matrixClient.stopClient();
|
||||
node.setConnected(false);
|
||||
}
|
||||
|
||||
if(retryStartTimeout) {
|
||||
clearTimeout(retryStartTimeout);
|
||||
}
|
||||
}
|
||||
|
||||
node.on('close', function(done) {
|
||||
stopClient();
|
||||
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");
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
node.isConnected = function() {
|
||||
return node.connected;
|
||||
};
|
||||
|
||||
node.matrixClient.on("Room.timeline", async function(event, room, toStartOfTimeline, data) {
|
||||
node.emit("Room.timeline", event, room, toStartOfTimeline, data);
|
||||
node.matrixClient.on("Room.timeline", async function(event, room, toStartOfTimeline, removed, data) {
|
||||
if (toStartOfTimeline) {
|
||||
return; // ignore paginated results
|
||||
}
|
||||
if (!event.getSender() || event.getSender() === node.userId) {
|
||||
return; // ignore our own messages
|
||||
}
|
||||
if (!data || !data.liveEvent) {
|
||||
return; // ignore old message (we only want live events)
|
||||
}
|
||||
if(node.initializedAt > event.getDate()) {
|
||||
return; // skip events that occurred before our client initialized
|
||||
}
|
||||
|
||||
try {
|
||||
await node.matrixClient.decryptEventIfNeeded(event);
|
||||
} catch (error) {
|
||||
node.error(error);
|
||||
return;
|
||||
}
|
||||
|
||||
let msg = {
|
||||
encrypted : event.isEncrypted(),
|
||||
redacted : event.isRedacted(),
|
||||
content : event.getContent(),
|
||||
type : (event.getContent()['msgtype'] || event.getType()) || null,
|
||||
payload : (event.getContent()['body'] || event.getContent()) || null,
|
||||
userId : event.getSender(),
|
||||
topic : event.getRoomId(),
|
||||
eventId : event.getId(),
|
||||
event : event,
|
||||
};
|
||||
|
||||
node.log("Received" + (msg.encrypted ? ' encrypted' : '') +" timeline event [" + msg.type + "]: (" + room.name + ") " + event.getSender() + " :: " + msg.content.body + (toStartOfTimeline ? ' [PAGINATED]' : ''));
|
||||
node.emit("Room.timeline", event, room, toStartOfTimeline, removed, data, msg);
|
||||
});
|
||||
|
||||
/**
|
||||
* Fires when we want to suggest to the user that they restore their megolm keys
|
||||
* from backup or by cross-signing the device.
|
||||
*
|
||||
* @event module:client~MatrixClient#"crypto.suggestKeyRestore"
|
||||
*/
|
||||
node.matrixClient.on("crypto.suggestKeyRestore", function(){
|
||||
|
||||
});
|
||||
|
||||
// node.matrixClient.on("RoomMember.typing", async function(event, member) {
|
||||
@@ -108,29 +220,70 @@ module.exports = function(RED) {
|
||||
});
|
||||
|
||||
node.matrixClient.on("sync", async function(state, prevState, data) {
|
||||
switch (state) {
|
||||
case "ERROR":
|
||||
node.debug("SYNC [STATE=" + state + "] [PREVSTATE=" + prevState + "]");
|
||||
if(prevState === null && state === "PREPARED" ) {
|
||||
// Occurs when the initial sync is completed first time.
|
||||
// This involves setting up filters and obtaining push rules.
|
||||
node.setConnected(true, function(){
|
||||
node.log("Matrix client connected");
|
||||
});
|
||||
} else if(prevState === null && state === "ERROR") {
|
||||
// Occurs when the initial sync failed first time.
|
||||
node.setConnected(false, function(){
|
||||
node.error("Failed to connect to Matrix server");
|
||||
});
|
||||
} else if(prevState === "ERROR" && state === "PREPARED") {
|
||||
// Occurs when the initial sync succeeds
|
||||
// after previously failing.
|
||||
node.setConnected(true, function(){
|
||||
node.log("Matrix client connected");
|
||||
});
|
||||
} else if(prevState === "PREPARED" && state === "SYNCING") {
|
||||
// Occurs immediately after transitioning to PREPARED.
|
||||
// Starts listening for live updates rather than catching up.
|
||||
node.setConnected(true, function(){
|
||||
node.log("Matrix client connected");
|
||||
});
|
||||
} else if(prevState === "SYNCING" && state === "RECONNECTING") {
|
||||
// Occurs when the live update fails.
|
||||
node.setConnected(false, function(){
|
||||
node.error("Connection to Matrix server lost");
|
||||
node.setConnected(false);
|
||||
break;
|
||||
|
||||
case "RECONNECTING":
|
||||
case "STOPPED":
|
||||
node.setConnected(false);
|
||||
break;
|
||||
|
||||
case "SYNCING":
|
||||
break;
|
||||
|
||||
case "PREPARED":
|
||||
node.setConnected(true);
|
||||
break;
|
||||
|
||||
// case "PREPARED":
|
||||
// // the client instance is ready to be queried.
|
||||
// node.log("Matrix server connection ready.");
|
||||
// node.setConnected(true);
|
||||
// break;
|
||||
});
|
||||
} else if(prevState === "RECONNECTING" && state === "RECONNECTING") {
|
||||
// Can occur if the update calls continue to fail,
|
||||
// but the keepalive calls (to /versions) succeed.
|
||||
node.setConnected(false, function(){
|
||||
node.error("Connection to Matrix server lost");
|
||||
});
|
||||
} else if(prevState === "RECONNECTING" && state === "ERROR") {
|
||||
// Occurs when the keepalive call also fails
|
||||
node.setConnected(false, function(){
|
||||
node.error("Connection to Matrix server lost");
|
||||
});
|
||||
} else if(prevState === "ERROR" && state === "SYNCING") {
|
||||
// Occurs when the client has performed a
|
||||
// live update after having previously failed.
|
||||
node.setConnected(true, function(){
|
||||
node.log("Matrix client connected");
|
||||
});
|
||||
} else if(prevState === "ERROR" && state === "ERROR") {
|
||||
// Occurs when the client has failed to
|
||||
// keepalive for a second time or more.
|
||||
node.setConnected(false, function(){
|
||||
node.error("Connection to Matrix server lost");
|
||||
});
|
||||
} else if(prevState === "SYNCING" && state === "SYNCING") {
|
||||
// Occurs when the client has performed a live update.
|
||||
// This is called <i>after</i> processing.
|
||||
node.setConnected(true, function(){
|
||||
node.log("Matrix client connected");
|
||||
});
|
||||
} else if(state === "STOPPED") {
|
||||
// Occurs once the client has stopped syncing or
|
||||
// trying to sync after stopClient has been called.
|
||||
node.setConnected(false, function(){
|
||||
node.error("Connection to Matrix server lost");
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
@@ -146,39 +299,147 @@ module.exports = function(RED) {
|
||||
// httpStatus: 401
|
||||
// }
|
||||
|
||||
node.error("[Session.logged_out] " + errorObj);
|
||||
node.error("Authentication failure: " + errorObj);
|
||||
stopClient();
|
||||
});
|
||||
|
||||
async function run() {
|
||||
if(node.e2ee){
|
||||
const initCrypto = ms => new Promise(res => node.matrixClient.initCrypto());
|
||||
try {
|
||||
await initCrypto();
|
||||
} catch(error){
|
||||
node.error(error);
|
||||
}
|
||||
node.matrixClient.setGlobalErrorOnUnknownDevices(false);
|
||||
}
|
||||
|
||||
const startClient = ms => new Promise(res => node.matrixClient.startClient({ initialSyncLimit: 8 }));
|
||||
try {
|
||||
await startClient();
|
||||
} catch(error){
|
||||
if(node.e2ee){
|
||||
node.log("Initializing crypto...");
|
||||
await node.matrixClient.initCrypto();
|
||||
node.matrixClient.setGlobalErrorOnUnknownDevices(false);
|
||||
}
|
||||
node.log("Connecting to Matrix server...");
|
||||
await node.matrixClient.startClient({
|
||||
initialSyncLimit: 8
|
||||
});
|
||||
} catch(error) {
|
||||
node.error(error);
|
||||
}
|
||||
}
|
||||
|
||||
node.log("Connecting to Matrix server...");
|
||||
run().catch((error) => node.error(error));
|
||||
// do an authed request and only continue if we don't get an error
|
||||
// this prevent the matrix client from crashing Node-RED on invalid auth token
|
||||
(function checkAuthTokenThenStart() {
|
||||
if(node.matrixClient.clientRunning) {
|
||||
return;
|
||||
}
|
||||
|
||||
node.matrixClient.getAccountDataFromServer()
|
||||
.then(
|
||||
function() {
|
||||
run().catch((error) => node.error(error));
|
||||
},
|
||||
function(err) {
|
||||
// if the error isn't authentication related retry in a little bit
|
||||
if(err.code !== "M_UNKNOWN_TOKEN") {
|
||||
retryStartTimeout = setTimeout(checkAuthTokenThenStart, 15000);
|
||||
node.error("Auth check failed: " + err);
|
||||
}
|
||||
}
|
||||
)
|
||||
})();
|
||||
}
|
||||
}
|
||||
|
||||
RED.nodes.registerType("matrix-server-config", MatrixServerNode, {
|
||||
credentials: {
|
||||
userId: { type:"text", required: true },
|
||||
accessToken: { type:"text", required: true },
|
||||
deviceId: { type: "text", required: true },
|
||||
url: { type: "text", required: true },
|
||||
deviceLabel: { type: "text", required: false },
|
||||
userId: { type: "text", required: true },
|
||||
accessToken: { type: "text", required: true },
|
||||
deviceId: { type: "text", required: false },
|
||||
url: { type: "text", required: true }
|
||||
}
|
||||
});
|
||||
|
||||
RED.httpAdmin.post(
|
||||
"/matrix-chat/login",
|
||||
RED.auth.needsPermission('flows.write'),
|
||||
function(req, res) {
|
||||
let userId = req.body.userId || undefined,
|
||||
password = req.body.password || undefined,
|
||||
baseUrl = req.body.baseUrl || undefined,
|
||||
deviceId = req.body.deviceId || undefined,
|
||||
displayName = req.body.displayName || undefined;
|
||||
|
||||
const matrixClient = sdk.createClient({
|
||||
baseUrl: baseUrl,
|
||||
deviceId: deviceId,
|
||||
localTimeoutMs: '30000'
|
||||
});
|
||||
|
||||
matrixClient.login(
|
||||
'm.login.password', {
|
||||
user: userId,
|
||||
password: password,
|
||||
initial_device_display_name: displayName
|
||||
})
|
||||
.then(
|
||||
function(response) {
|
||||
res.json({
|
||||
'result': 'ok',
|
||||
'token': response.access_token,
|
||||
'device_id': response.device_id,
|
||||
'user_id': response.user_id,
|
||||
});
|
||||
},
|
||||
function(err) {
|
||||
res.json({
|
||||
'result': 'error',
|
||||
'message': err
|
||||
});
|
||||
}
|
||||
);
|
||||
});
|
||||
|
||||
function upgradeDirectoryIfNecessary(node, storageDir) {
|
||||
let oldStorageDir = './matrix-local-storage',
|
||||
oldStorageDir2 = './matrix-client-storage';
|
||||
|
||||
// if the old storage location exists lets move it to it's new location
|
||||
if(fs.pathExistsSync(oldStorageDir)){
|
||||
RED.nodes.eachNode(function(n){
|
||||
try {
|
||||
if(n.type !== 'matrix-server-config') return;
|
||||
let { userId } = RED.nodes.getCredentials(n.id);
|
||||
let dir = storageDir + '/' + MatrixFolderNameFromUserId(userId);
|
||||
if(!fs.pathExistsSync(dir)) {
|
||||
fs.ensureDirSync(dir);
|
||||
node.log("found old '" + oldStorageDir + "' path, copying to new location '" + dir);
|
||||
fs.copySync(oldStorageDir, dir);
|
||||
}
|
||||
} catch (err) {
|
||||
console.error(err)
|
||||
}
|
||||
});
|
||||
|
||||
// rename folder to keep as a backup (and so we don't run again)
|
||||
node.log("archiving old config folder '" + oldStorageDir + "' to '" + oldStorageDir + "-backup");
|
||||
fs.renameSync(oldStorageDir, oldStorageDir + "-backup");
|
||||
}
|
||||
|
||||
if(RED.settings.userDir !== resolve('./')) {
|
||||
// user directory does not match running directory
|
||||
// check if we stored stuff in wrong directory and move it
|
||||
if(fs.pathExistsSync(oldStorageDir2)){
|
||||
fs.ensureDirSync(storageDir);
|
||||
node.log("found old '" + oldStorageDir2 + "' path, copying to new location '" + storageDir);
|
||||
fs.copySync(oldStorageDir2, storageDir);
|
||||
// rename folder to keep as a backup (and so we don't run again)
|
||||
fs.renameSync(oldStorageDir2, oldStorageDir2 + "-backup");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* If a device ID is stored we will use that for the client
|
||||
*/
|
||||
function getStoredDeviceId(localStorage) {
|
||||
return localStorage.getItem('my_device_id');
|
||||
}
|
||||
|
||||
function storeDeviceId(localStorage, deviceId) {
|
||||
localStorage.setItem('my_device_id', deviceId);
|
||||
}
|
||||
}
|
||||
@@ -46,7 +46,7 @@
|
||||
<dd> ID of user to create/edit (ex: @bob:example.com)</dd>
|
||||
|
||||
<dt>msg.payload
|
||||
<span class="property-type">Object</span>
|
||||
<span class="property-type">object</span>
|
||||
</dt>
|
||||
<dd> Details of the new user to create. <a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#create-or-modify-account" target="_blank">Click here</a> to see what valid data you can pass via this input. If the user already exists then optional parameters default to the current value.</dd>
|
||||
</dl>
|
||||
@@ -55,8 +55,6 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
|
||||
<dt>msg.payload <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the posted message.</dd>
|
||||
</dl>
|
||||
|
||||
@@ -29,7 +29,7 @@
|
||||
</div>
|
||||
|
||||
<div class="form-tips" style="margin-bottom: 12px;">
|
||||
User must be an admin to use this endpoint. Only works with Synapse servers. This is permanent so make sure you actually want to do it.
|
||||
User must be an admin to use this endpoint. Only works with Synapse servers. This is permanent so be cautious.
|
||||
</div>
|
||||
</script>
|
||||
|
||||
@@ -79,7 +79,8 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
<dt>msg.error <span class="property-type">object</span></dt>
|
||||
<dd>empty object response</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -55,7 +55,13 @@ module.exports = function(RED) {
|
||||
{ $userId: msg.userId },
|
||||
);
|
||||
node.server.matrixClient.http
|
||||
.authedRequest(undefined, 'POST', path, undefined, { "erase": (msg.erase || false) }, { prefix: '' })
|
||||
.authedRequest(
|
||||
undefined,
|
||||
'POST',
|
||||
path,
|
||||
undefined,
|
||||
{"erase": (msg.erase || false)},
|
||||
{"prefix": '' })
|
||||
.then(function(e){
|
||||
msg.payload = e;
|
||||
node.send([msg, null]);
|
||||
|
||||
@@ -51,7 +51,7 @@
|
||||
<dt>msg.topic
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> The room identifier or alias to join: for example, <code>!h8zld9j31:example.com.</code>. Not required if set in the config and will be ignored even if set.</dd>
|
||||
<dd> The room identifier or alias to join: for example, <code>!h8zld9j31:example.com.</code>. Ignored if configured on the node, otherwise required.</dd>
|
||||
|
||||
<dt>msg.userId
|
||||
<span class="property-type">string</span>
|
||||
@@ -63,8 +63,8 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload <span class="property-type">string</span></dt>
|
||||
<dd>This returns data directly from the API endpoint. <a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#query-current-sessions-for-a-user" target="_blank">Click here</a> to see what this returns.</dd>
|
||||
<dt>msg.topic <span class="property-type">string</span></dt>
|
||||
<dd> the ID of the room we just added the user to.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -46,8 +46,8 @@ module.exports = function(RED) {
|
||||
node.send([null, msg]);
|
||||
}
|
||||
|
||||
let roomId = node.roomId || msg.topic;
|
||||
if(!roomId) {
|
||||
msg.topic = node.roomId || msg.topic;
|
||||
if(!msg.topic) {
|
||||
node.error("room must be defined in either msg.topic or in node config");
|
||||
return;
|
||||
}
|
||||
@@ -64,13 +64,13 @@ module.exports = function(RED) {
|
||||
'POST',
|
||||
node.encodeUri(
|
||||
"/_synapse/admin/v1/join/$room_id_or_alias",
|
||||
{ $room_id_or_alias: roomId },
|
||||
{ $room_id_or_alias: msg.topic },
|
||||
),
|
||||
undefined,
|
||||
{ "user_id": msg.userId },
|
||||
{ prefix: '' }
|
||||
).then(function(e){
|
||||
msg.payload = e;
|
||||
msg.topic = e.room_id;
|
||||
node.send([msg, null]);
|
||||
}).catch(function(e){
|
||||
node.warn("Error joining user to room " + e);
|
||||
|
||||
@@ -51,42 +51,43 @@
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload
|
||||
<span class="property-type">Object</span>
|
||||
<span class="property-type">object</span>
|
||||
</dt>
|
||||
<dd> Details of the new user to create. </dd>
|
||||
|
||||
<dt class="optional">msg.payload.displayname
|
||||
<span class="property-type">String | null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> Set the displayname for the user (default to username if not set). </dd>
|
||||
|
||||
<dt>msg.payload.username
|
||||
<span class="property-type">Object</span>
|
||||
<span class="property-type">object</span>
|
||||
</dt>
|
||||
<dd> Username for the new user. </dd>
|
||||
|
||||
<dt>msg.payload.password
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd> Password for the new user. </dd>
|
||||
|
||||
<dt>msg.payload.admin
|
||||
<span class="property-type">Bool</span>
|
||||
<span class="property-type">bool</span>
|
||||
</dt>
|
||||
<dd> If true, the new user will be an admin. Default to false. </dd>
|
||||
|
||||
<dt class="optional">msg.payload.user_type
|
||||
<span class="property-type">String | null</span>
|
||||
<span class="property-type">string | null</span>
|
||||
</dt>
|
||||
<dd> Set the user type. Leave this to null if you don't know what it is for. Check <a href="https://github.com/matrix-org/synapse/blob/master/synapse/api/constants.py">here</a> and look for <code>class UserTypes</code> to figure out what is valid.</dd>
|
||||
<dd>
|
||||
Set the user type. Leave this to null if you don't know what it is for. Check <a href="https://github.com/matrix-org/synapse/blob/master/synapse/api/constants.py">here</a> and look for <code>class UserTypes</code> to figure out what is valid.<br>
|
||||
NOTE: Testing shows that "bot" and "support" do not work for this. Generate a normal user to use as a bot.
|
||||
</dd>
|
||||
</dl>
|
||||
|
||||
<h3>Outputs</h3>
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dd>original msg object preserved.</dd>
|
||||
|
||||
<dl class="message-properties">`
|
||||
<dt>msg.eventId <span class="property-type">string</span></dt>
|
||||
<dd>the eventId from the posted message.</dd>
|
||||
</dl>
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
module.exports = function(RED) {
|
||||
const got = require("got");
|
||||
const utf8 = require('utf8');
|
||||
const crypto = require('crypto');
|
||||
|
||||
@@ -22,7 +21,8 @@ module.exports = function(RED) {
|
||||
return;
|
||||
}
|
||||
|
||||
node.on("input", function (msg) {
|
||||
node.on("input", async function (msg) {
|
||||
const { got } = await import('got');
|
||||
|
||||
if(!msg.payload.username) {
|
||||
node.error("msg.payload.username is required");
|
||||
@@ -34,7 +34,7 @@ module.exports = function(RED) {
|
||||
return;
|
||||
}
|
||||
|
||||
(async () => {
|
||||
await (async () => {
|
||||
try {
|
||||
var response = await got.get(this.server + '/_synapse/admin/v1/register', {
|
||||
responseType: 'json'
|
||||
@@ -62,7 +62,13 @@ module.exports = function(RED) {
|
||||
.update(utf8.encode(msg.payload.password))
|
||||
.update("\x00")
|
||||
.update(msg.payload.admin ? "admin" : "notadmin")
|
||||
.digest('hex');
|
||||
|
||||
if(msg.payload.user_type || null) {
|
||||
hmac.update("\x00")
|
||||
.update(msg.payload.user_type);
|
||||
}
|
||||
|
||||
hmac = hmac.digest('hex');
|
||||
|
||||
try {
|
||||
response = await got.post(this.server + '/_synapse/admin/v1/register', {
|
||||
|
||||
@@ -39,22 +39,22 @@
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
<dt class="optional">msg.from
|
||||
<span class="property-type">Integer</span>
|
||||
<span class="property-type">integer</span>
|
||||
</dt>
|
||||
<dd> Is optional but used for pagination, denoting the offset in the returned results. This should be treated as an opaque value and not explicitly set to anything other than the return value of next_token from a previous call. Defaults to 0.</dd>
|
||||
<dd> Is optional but used for pagination, denoting the offset in the returned results. This should be treated as an opaque value and not explicitly set to anything other than the return value of <code>msg.next_token</code> from a previous call. Defaults to 0.</dd>
|
||||
|
||||
<dt class="optional">msg.limit
|
||||
<span class="property-type">Integer</span>
|
||||
<span class="property-type">integer</span>
|
||||
</dt>
|
||||
<dd> limit - representing a positive integer - Is optional but is used for pagination, denoting the maximum number of items to return in this call. Defaults to 100.</dd>
|
||||
|
||||
<dt class="optional">msg.guests
|
||||
<span class="property-type">Bool</span>
|
||||
<span class="property-type">bool</span>
|
||||
</dt>
|
||||
<dd> Is optional and if false will exclude guest users. Defaults to true to include guest users.</dd>
|
||||
|
||||
<dt class="optional">msg.order_by
|
||||
<span class="property-type">String</span>
|
||||
<span class="property-type">string</span>
|
||||
</dt>
|
||||
<dd>
|
||||
The method by which to sort the returned list of users.
|
||||
@@ -85,14 +85,41 @@
|
||||
<dt>msg.payload <span class="property-type">object</span></dt>
|
||||
<dd>the response object from the server.</dd>
|
||||
|
||||
<dt>msg.payload.next_token <span class="property-type">string</span></dt>
|
||||
<dd>string representing a positive integer - Indication for pagination. If this is unset then there are no more users to paginate through.</dd>
|
||||
|
||||
<dt>msg.payload.total <span class="property-type">integer</span></dt>
|
||||
<dd>Total number of users.</dd>
|
||||
|
||||
<dt>msg.payload.users <span class="property-type">array</span></dt>
|
||||
<dd>list of users from the Matrix server. <a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#list-accounts" target="_blank">Click here</a> for details on what this contains (or do a test and dump the output). We would put the details here in the doc but Synapse is constantly changing so it's best to reference the official Synapse docs.</dd>
|
||||
<dd>list of users from the Matrix server. <a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#list-accounts" target="_blank">Click here</a> for details on what this contains (or do a debug on the output).</dd>
|
||||
|
||||
<dt>msg.next_token <span class="property-type">string</span></dt>
|
||||
<dd>string representing a positive integer - Indication for pagination. See above (input msg.from)</dd>
|
||||
<dt>msg.payload.users[].name <span class="property-type">string</span></dt>
|
||||
<dd>Fully-qualified user ID (ex. <code>@user:server.com</code>).</dd>
|
||||
|
||||
<dt>msg.total <span class="property-type">integer</span></dt>
|
||||
<dd>Total number of media.</dd>
|
||||
<dt>msg.payload.users[].is_guest <span class="property-type">bool</span></dt>
|
||||
<dd>Status if that user is a guest account.</dd>
|
||||
|
||||
<dt>msg.payload.users[].admin <span class="property-type">string</span></dt>
|
||||
<dd>Status if that user is a server administrator.</dd>
|
||||
|
||||
<dt>msg.payload.users[].user_type <span class="property-type">string</span></dt>
|
||||
<dd>Type of the user. Normal users are type <code>None</code>. This allows user type specific behaviour. There are also types <code>support</code> and <code>bot</code>.</dd>
|
||||
|
||||
<dt>msg.payload.users[].deactivated <span class="property-type">bool</span></dt>
|
||||
<dd>Status if that user has been marked as deactivated.</dd>
|
||||
|
||||
<dt>msg.payload.users[].shadow_banned <span class="property-type">bool</span></dt>
|
||||
<dd>Status if that user has been marked as shadow banned.</dd>
|
||||
|
||||
<dt>msg.payload.users[].displayname <span class="property-type">string</span></dt>
|
||||
<dd>The user's display name if they have set one.</dd>
|
||||
|
||||
<dt>msg.payload.users[].avatar_url <span class="property-type">string</span></dt>
|
||||
<dd>The user's avatar URL if they have set one.</dd>
|
||||
|
||||
<dt>msg.payload.users[].creation_ts <span class="property-type">integer</span></dt>
|
||||
<dd>The user's creation timestamp in ms.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -39,7 +39,7 @@ module.exports = function(RED) {
|
||||
};
|
||||
|
||||
if(msg.guests) {
|
||||
queryParams['guests'] = msg.guests;
|
||||
queryParams['guests'] = msg.guests ? 'true' : 'false';
|
||||
}
|
||||
|
||||
if(msg.order_by) {
|
||||
@@ -58,7 +58,7 @@ module.exports = function(RED) {
|
||||
msg.payload = e;
|
||||
node.send([msg, null]);
|
||||
}).catch(function(e){
|
||||
node.warn("Error fetching user list " + e);
|
||||
node.warn("Error fetching server user list " + e);
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
|
||||
@@ -36,6 +36,7 @@
|
||||
<script type="text/html" data-help-name="matrix-whois-user">
|
||||
<h3>Details</h3>
|
||||
<p>This node returns information about the active sessions for a specific user.</p>
|
||||
<a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#query-current-sessions-for-a-user" target="_blank">Matrix API Endpoint Information</a>
|
||||
|
||||
<h3>Inputs</h3>
|
||||
<dl class="message-properties">
|
||||
@@ -49,8 +50,29 @@
|
||||
<ol class="node-ports">
|
||||
<li>Success
|
||||
<dl class="message-properties">
|
||||
<dt>msg.payload <span class="property-type">string</span></dt>
|
||||
<dd>This returns data directly from the API endpoint. <a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#query-current-sessions-for-a-user" target="_blank">Click here</a> to see what this returns.</dd>
|
||||
<dt>msg.payload <span class="property-type">object</span></dt>
|
||||
<dd>This returns data directly from the API endpoint. <a href="https://matrix-org.github.io/synapse/develop/admin_api/user_admin_api.html#query-current-sessions-for-a-user" target="_blank">Click here</a> to see more info.</dd>
|
||||
|
||||
<dt>msg.payload.user_id <span class="property-type">string</span></dt>
|
||||
<dd>The Matrix user ID of the user.</dd>
|
||||
|
||||
<dt>msg.payload.devices <span class="property-type">object</span></dt>
|
||||
<dd>Each key in this object is an identifier for one of the user's devices.</dd>
|
||||
|
||||
<dt>msg.payload.devices.X.sessions <span class="property-type">array</span></dt>
|
||||
<dd>A user's sessions (i.e. what they did with an access token from one login).</dd>
|
||||
|
||||
<dt>msg.payload.devices.X.sessions[].connections <span class="property-type">array</span></dt>
|
||||
<dd>Information about particular connections in the session.</dd>
|
||||
|
||||
<dt>msg.payload.devices.X.sessions[].connections[].ip <span class="property-type">string</span></dt>
|
||||
<dd>Most recently seen IP address of the session.</dd>
|
||||
|
||||
<dt>msg.payload.devices.X.sessions[].connections[].last_seen <span class="property-type">integer</span></dt>
|
||||
<dd>Unix timestamp that the session was last active.</dd>
|
||||
|
||||
<dt>msg.payload.devices.X.sessions[].connections[].user_agent <span class="property-type">string</span></dt>
|
||||
<dd>User agent string last seen in the session.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li>Error
|
||||
|
||||
@@ -63,13 +63,13 @@ module.exports = function(RED) {
|
||||
msg.payload,
|
||||
{ prefix: '' }
|
||||
).then(function(e){
|
||||
msg.payload = e;
|
||||
node.send([msg, null]);
|
||||
}).catch(function(e){
|
||||
node.warn("Error creating/editing user " + e);
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
msg.payload = e;
|
||||
node.send([msg, null]);
|
||||
}).catch(function(e){
|
||||
node.warn("Error fetching user whois information " + e);
|
||||
msg.error = e;
|
||||
node.send([null, msg]);
|
||||
});
|
||||
});
|
||||
}
|
||||
RED.nodes.registerType("matrix-whois-user", MatrixWhoIsUser);
|
||||
|
||||
Reference in New Issue
Block a user