feat: share files/images/videos into Matrix via /send #1

Merged

mxm merged 10 commits from feat/matrix-media-send into main 2026-06-08 17:35:42 +00:00

Conversation 1 Commits 10 Files changed 12 +1116 -10

mxm commented 2026-06-08 17:28:40 +00:00

Owner

Copy link

Summary

• Extend POST /send to send media (image/video/audio/file) into Matrix rooms, including E2EE
• n8n passes a mediaUrl (+ kind, filename, optional fetchAuthHeader, replyToEventId); the bot downloads, encrypts for E2EE rooms, uploads to the content repo, and sends the event
• Configurable download cap MATRIX_MAX_DOWNLOAD_BYTES (default 50 MB); http/https-only fetch guard

Test Plan

• 41/41 unit tests pass (cd bot && npm test); build clean (npm run build)
• Manual: POST a media mediaUrl to /send → renders inline in an encrypted room
• Manual: oversized file → HTTP 413; replyToEventId → threads as reply

## Summary - Extend `POST /send` to send media (image/video/audio/file) into Matrix rooms, including E2EE - n8n passes a `mediaUrl` (+ `kind`, `filename`, optional `fetchAuthHeader`, `replyToEventId`); the bot downloads, encrypts for E2EE rooms, uploads to the content repo, and sends the event - Configurable download cap `MATRIX_MAX_DOWNLOAD_BYTES` (default 50 MB); http/https-only fetch guard ## Test Plan - [x] 41/41 unit tests pass (`cd bot && npm test`); build clean (`npm run build`) - [ ] Manual: POST a media `mediaUrl` to `/send` → renders inline in an encrypted room - [ ] Manual: oversized file → HTTP 413; `replyToEventId` → threads as reply

mxm added 9 commits 2026-06-08 17:28:40 +00:00

docs: add Matrix media send design spec ... a118c0611c

Extend POST /send to share files/images/videos/audio into Matrix rooms
(including E2EE) via URL delivery. Bot downloads, encrypts when the room
is encrypted, uploads to the content repo, and sends the media event.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs: add Matrix media send implementation plan ... f23bbb8ca3

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

feat: add maxDownloadBytes config (MATRIX_MAX_DOWNLOAD_BYTES, default 50MB) b7ec7dbc8d

feat: parse media requests in /send (discriminated union) 6f8e845659

feat: add buildMediaContent event builder a26eedbb42

feat: add downloadMedia with streaming size cap 3fbeb32baf

feat: send media via /send (download, encrypt for E2EE, upload) fc18cbfdc6

docs: document MATRIX_MAX_DOWNLOAD_BYTES 92784955c1

fix: harden media config + download per review ... 96ec32426b

- fail hard on invalid MATRIX_MAX_DOWNLOAD_BYTES (was silently NaN → cap disabled)
- restrict media downloads to http/https schemes (SSRF guard)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

mxm added 1 commit 2026-06-08 17:30:37 +00:00

docs: document media /send payload mode in CLAUDE.md ... 27e275a283

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

mxm reviewed 2026-06-08 17:35:37 +00:00

mxm left a comment

Copy link

looks good

looks good

mxm merged commit 285514e84d into main 2026-06-08 17:35:42 +00:00

mxm referenced this pull request from a commit 2026-06-08 17:35:42 +00:00

Merge pull request 'feat: share files/images/videos into Matrix via /send' (#1) from feat/matrix-media-send into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

mxm/n8n-matrix-bridge!1

No description provided.