out-of-your-element/notes.md

d2m

Remember that a discord message may be transformed to multiple matrix messages.

A database will be used to store the discord id to matrix event id mapping. Table columns:

• discord id
• matrix id
• the "type" of the matrix id, used to update things properly next time. for example, whether it is the message text or an attachment

There needs to be a way to easily manually trigger something later. For example, it should be easy to manually retry sending a message, or check all members for changes, etc.

Transforming content

1. Upload attachments to mxc if they are small enough.
2. Convert discord message text and embeds to matrix event.
   1. Convert discord mentions, names, channel links, message links, and emojis to intermediate formats.
   2. Convert discord text to body.
   3. Convert discord text to formatted_body using custom discord-markdown npm module.
   4. Convert discord embeds to quotes.
3. Gather relevant reply data.
4. Send reply+message.
5. Send attachments.
6. Store in database.

Message sent

1. Transform content.
2. Send to matrix.

Message deleted

1. Look up equivalents on matrix.
2. Delete on matrix.

Message edited / embeds added

1. Look up equivalents on matrix.
2. Replace content on matrix.

Reaction added

1. Add reaction on matrix.

Reaction removed

1. Remove reaction on matrix.

Member data changed

1. Compare current member against cached version in database.
2. Update member on matrix.
3. Update cached version in database.

Channel created / updated

(but I should be able to manually call this function at any time to run the same code on any given channel)

1. Compare current channel against cached version in database.
2. If channel does not yet exist in database:
   1. Create the corresponding room.
   2. Add to database.
3. Update room details to match.
4. Add to space.