44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
pnpm dev # Run with hot-reload (development)
|
|
pnpm start # Run production
|
|
pnpm lint # ESLint check (npx eslint src/)
|
|
```
|
|
|
|
## Architecture
|
|
|
|
Discord-to-Telegram message forwarder. Tracks messages from users with specific roles on Discord servers and forwards them to Telegram topics.
|
|
|
|
```
|
|
src/
|
|
├── index.ts # Entry point, initializes clients
|
|
├── env.ts # Environment variables (DISCORD_TOKEN, TELEGRAM_BOT_TOKEN)
|
|
├── config.ts # Loads config.json, validates server/role structure
|
|
├── types.ts # Shared TypeScript interfaces
|
|
├── discord/
|
|
│ ├── client.ts # discord.js-selfbot-v13 client
|
|
│ └── handlers.ts # messageCreate handler, role priority filtering
|
|
└── telegram/
|
|
├── client.ts # wrappergram client
|
|
└── sender.ts # Message forwarding, media group handling
|
|
```
|
|
|
|
**Flow**: Discord messageCreate → filter by guild + role → find highest priority role → forward to Telegram topic with attachments
|
|
|
|
**Role Priority**: Users with multiple tracked roles → message goes to first matching role's topic (config array order = priority)
|
|
|
|
## Config
|
|
|
|
- `config.json` - Server/role/topic mappings (see `config.json.example`)
|
|
- `.env` - Tokens (see `.env.example`)
|
|
|
|
## Code Style
|
|
|
|
- ESM with `.js` extensions in imports
|
|
- Node globals via explicit imports (`import process from 'node:process'`)
|
|
- @antfu/eslint-config with 2-space indent, single quotes
|