@norz/teleadclient

Ultra-minimalist admin panel for CoupMain adbots management.

Quick Start (Development)

npm install
npm run dev

Opens at http://localhost:5173/admin/

Production Build

npm run build        # Standalone SPA → dist/
npm run build:lib    # Library bundle → dist/admin-client.js

Use as npm Package

import AdminPanel from '@norz/teleadclient'
import '@norz/teleadclient/dist/admin-client.css'

function App() {
  return <AdminPanel basename="/admin" apiBaseUrl="/api/admin" />
}

Configuration

// Before loading, or via configureApi():
import { configureApi } from '@norz/teleadclient'
configureApi({ apiBaseUrl: '/custom-api', loginPath: '/custom-login' })

Features

| Feature | Superadmin | Admin | |---------|-----------|-------| | Dashboard | Full stats + admin actions | Own bot stats | | Mass Report (MTProto) | ✅ | ❌ | | Admin Users CRUD | ✅ | ❌ | | All Bots Config | ✅ | Uses "My Bots" | | Accounts / Groups | ✅ | ✅ | | Proxies (CRUD + URL sync) | ✅ | ✅ | | Backups (PG export/import) | ✅ | ✅ | | Broadcast / Premium | ✅ | ✅ | | Logs / Settings | ✅ | ✅ |

API Endpoints Required

POST /api/admin/login
GET  /api/admin/verify
GET  /api/admin/stats
GET  /api/admin/me
GET  /api/admin/adbots
POST /api/admin/adbots
GET  /api/admin/adbots/:id
DELETE /api/admin/adbots/:id
GET  /api/admin/adbots/:id/settings
POST /api/admin/adbots/:id/settings
GET  /api/admin/accounts
POST /api/admin/accounts/:id/disconnect
DELETE /api/admin/accounts/:id
GET  /api/admin/groups
POST /api/admin/groups/:id/toggle
GET  /api/admin/premium
POST /api/admin/premium/grant
POST /api/admin/premium/:userId/update
GET  /api/admin/proxies
POST /api/admin/proxies
PUT  /api/admin/proxies/:id
DELETE /api/admin/proxies/:id
GET  /api/admin/proxies/sync/config
POST /api/admin/proxies/sync
GET  /api/admin/backups
POST /api/admin/backups
POST /api/admin/backups/:id/restore
DELETE /api/admin/backups/:id
GET  /api/admin/backup-configs
POST /api/admin/reports/tg-user      (superadmin)
GET  /api/admin/mass-reports         (superadmin)
GET  /api/admin/reports
GET  /api/admin/reports/reasons
POST /api/admin/reports
POST /api/admin/reports/:id/cancel
GET  /api/admin/broadcast/active
POST /api/admin/broadcast/start
POST /api/admin/broadcast/stop
GET  /api/admin/broadcast-stats/all
GET  /api/admin/logs
GET  /api/admin/users                (superadmin)
POST /api/admin/users                (superadmin)
DELETE /api/admin/users/:id          (superadmin)
GET  /api/admin/adbot-keys

AdBot Integration

Add to bot .env:

ADMIN_SERVER_URL=http://your-admin-server:3001
ADMIN_SERVER_API_KEY=your-api-key

Publishing

npm login
npm publish --access public

License

MIT