lghs/rocket2matter

How lghs/rocket2matter works

Rocket2Matter converts a read-only RocketChat MongoDB database into Mattermost bulk-import JSONL and attachment data, then packages them for mmctl. The principal workflow runs through the CLI: export, package, import externally, then optionally reset migrated-account passwords. The exporter covers core records, conversations and state, plus files and profile assets. README-described export details are represented, but the excerpt does not expose every internal call, so those relationships are documented rather than inferred from sibling modules.

Main entry points: index.ts Export Orchestrator · cli.ts CLI Router · package.ts Zip Packager · assets.ts Avatars, Emojis

Components 19

Commands

CLI Router src/cli.ts

Migration Export

Export Orchestrator src/index.ts
Export Configuration src/config.ts
Teams, Users, Channels src/index.ts
Posts, Threads, DMs src/index.ts
Memberships, Read State src/index.ts
Avatars, Emojis src/assets.ts
File Attachments src/files.ts
Conversion Helpers src/util.ts
Source and Import Types src/types.ts

Import Artifacts

Import JSONL
Attachment Data
Zip Packager src/package.ts
Import ZIP

Post-import

Password Reset src/reset-password.ts
Inactive Account Deactivation scripts/deactivate-users.sh

Other components

Operator
RocketChat MongoDB
Mattermost mmctl

Connections 21

Operator → CLI Router: runs command README.md
CLI Router → Export Orchestrator: dispatches export src/cli.ts
CLI Router → Zip Packager: dispatches package src/cli.ts
CLI Router → Password Reset: dispatches reset src/cli.ts
Export Orchestrator → Export Configuration: uses settings src/index.ts
Export Orchestrator → RocketChat MongoDB: reads source README.md
Export Orchestrator → Teams, Users, Channels: exports records README.md
Export Orchestrator → Posts, Threads, DMs: exports conversations README.md
Export Orchestrator → Memberships, Read State: exports state README.md
Export Orchestrator → File Attachments: extracts files src/index.ts
Export Orchestrator → Avatars, Emojis: exports assets src/index.ts
Export Orchestrator → Conversion Helpers: uses conversions src/index.ts
Export Orchestrator → Import JSONL: writes JSONL src/index.ts
File Attachments → Attachment Data: writes files src/files.ts
Avatars, Emojis → Attachment Data: writes images src/assets.ts
Zip Packager → Import JSONL: reads export src/package.ts
Zip Packager → Attachment Data: includes files src/package.ts
Zip Packager → Import ZIP: creates ZIP src/package.ts
Import ZIP → Mattermost mmctl: uploaded for import README.md
Password Reset → Mattermost mmctl: enables account
Inactive Account Deactivation → Mattermost mmctl: deactivates accounts

More TypeScript diagrams: surgioproject/surgio · aieditor-team/aieditor · delibae/claude-prism · getsentry/sentry-react-native · tableflowhq/csv-import

Drawn by GitDiagram on October 1, 2026 from the repository's file tree, README and source files. Read as Markdown ·