# 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 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/channel structure
├── types.ts              # Shared TypeScript interfaces
├── discord/
│   ├── client.ts         # discord.js-selfbot-v13 client
│   └── handlers.ts       # messageCreate handler, channel/role matching
└── telegram/
    ├── client.ts         # wrappergram client
    └── sender.ts         # Message forwarding, media group handling
```

**Flow**: Discord messageCreate → match by channel or role → forward to Telegram topic with attachments

**Matching Priority**:
1. Channels checked first (if configured)
2. Roles checked second (highest priority role = first in config array)

Servers can have `channels`, `roles`, or both. Channel matches skip role display in Telegram message.

## Config

- `config.json` - Server/channel/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