The communications platform that puts data protection first.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Rocket.Chat/ee/packages/federation-matrix
Diego Sampaio 0cbd1c3e48
test(federation): cover more DMs use cases (#37891)
2 weeks ago
..
docker-compose chore: federation-matrix integration tests (#37219) 2 months ago
src fix(federation): update group DMs names (#37840) 3 weeks ago
tests test(federation): cover more DMs use cases (#37891) 2 weeks ago
.env.example chore: federation-matrix integration tests (#37219) 2 months ago
.eslintrc.json chore: Reformat package manifest files (#37639) 1 month ago
.gitignore test(federation): remove qase monkey patch (#37818) 3 weeks ago
CHANGELOG.md Release 7.13.2 2 weeks ago
README.md chore: federation-matrix integration tests (#37219) 2 months ago
docker-compose.test.yml chore: federation-matrix integration tests (#37219) 2 months ago
jest.config.federation.ts test(federation): create DM tests (#37777) 3 weeks ago
jest.config.ts chore(federation-matrix): Review build configuration (#37858) 3 weeks ago
package.json Merge remote-tracking branch 'origin/master' into develop 2 weeks ago
tsconfig.build.json chore(federation-matrix): Review build configuration (#37858) 3 weeks ago
tsconfig.json chore(federation-matrix): Review build configuration (#37858) 3 weeks ago

README.md

Federation Matrix

Rocket.Chat's Matrix federation integration package for cross-platform communication.

Integration Tests

Setup

Before running integration tests, add the following entries to your /etc/hosts file:

127.0.0.1       element
127.0.0.1       hs1
127.0.0.1       rc1

How It Works

The integration test script builds Rocket.Chat locally, starts federation services (Rocket.Chat, Synapse, MongoDB), waits for all services to be ready, then runs end-to-end tests. The script automatically handles cleanup unless you specify otherwise.

Available Flags

  • No flags (default): Builds local code and runs tests
  • --image [IMAGE]: Uses a pre-built Docker image instead of building locally (defaults to rocketchat/rocket.chat:latest if no image specified)
  • --keep-running: Keeps containers running after tests complete for manual validation
  • --element: Includes Element web client in the test environment
  • --no-test: Starts containers and skips running tests (useful for manual testing or debugging)

Usage Examples

Basic local testing:

yarn test:integration

Test with pre-built image:

yarn test:integration --image

Test with specific pre-built image:

yarn test:integration --image rocketchat/rocket.chat:latest

Keep services running for manual inspection:

yarn test:integration --keep-running

Run with Element client:

yarn test:integration --element

Start containers only (skip tests):

yarn test:integration --no-test

Start containers with Element and keep them running (skip tests):

yarn test:integration --keep-running --element --no-test

Combine flags:

yarn test:integration --image rocketchat/rocket.chat:latest --keep-running --element

Service URLs (when using --keep-running or --no-test)