# nathanmbr/telegram-videos-uploader architecture

> Architecture diagram of the GitHub repository nathanmbr/telegram-videos-uploader, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nathanmbr/telegram-videos-uploader
- Repository: https://github.com/nathanmbr/telegram-videos-uploader

## Overview

This is a Node.js/TypeScript CLI for uploading videos to Telegram. Its main workflow loads settings, lets the user choose a preset, initializes that preset’s database, then presents actions; uploading checks Telegram connectivity, prepares video files and metadata, uploads video segments, and records results. The README also documents both official and self-hosted Bot API use. Edges reflect the shown boot and upload calls, repository database operations, and Telegram API requests; unsampled use-case internals are represented without inferred call flows.

Main entry points: [`src/main/boot.ts`](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/main/boot.ts) (Application boot), [`src/usecases/UploadVideosUsecase.ts`](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/UploadVideosUsecase.ts) (Video upload), [`src/repositories/VideoUploadsRepository.ts`](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/repositories/VideoUploadsRepository.ts) (Upload records), [`src/repositories/VideosRepository.ts`](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/repositories/VideosRepository.ts) (Video records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry and control"]
  node_boot["Application boot<br/>[boot.ts]"]
end

subgraph group_workflow["Video workflows"]
  node_menu["Action menu<br/>[MenuUsecase.ts]"]
  node_printpreset["Preset details"]
  node_printvideo["Video details"]
  node_availability["Availability listing"]
  node_upload["Video upload"]
  node_edit["Video editing"]
  node_delete["Video deletion"]
end

subgraph group_services["Services and integrations"]
  node_settings["Settings loader<br/>[SettingsService.ts]"]
  node_cli["Interactive CLI<br/>[ClackCLIService.ts]"]
  node_video_service["Video processing<br/>[VideosService.ts]"]
  node_telegram_service["Telegram operations<br/>[TelegramService.ts]"]
end

subgraph group_state["Domain and persistence"]
  node_preset["Preset model<br/>[Preset.ts]"]
  node_metadata["Video metadata<br/>[VideoMetadata.ts]"]
  node_videos_repo["Video records"]
  node_uploads_repo["Upload records"]
  node_connection["Database connection"]
  node_video_table[("Video tables<br/>[videosTable.ts]")]
  node_upload_table[("Upload tables")]
end

node_user(("CLI user"))
node_telegram{{"Telegram Bot API"}}

node_user -->|"starts"| node_boot
node_boot -->|"loads settings"| node_settings
node_boot -->|"selects preset"| node_cli
node_boot -->|"runs migrations"| node_connection
node_boot -->|"executes menu"| node_menu
node_boot -->|"registers action"| node_printpreset
node_boot -->|"registers action"| node_printvideo
node_boot -->|"registers action"| node_availability
node_boot -->|"registers action"| node_upload
node_boot -->|"registers action"| node_edit
node_boot -->|"registers action"| node_delete
node_upload -->|"checks and uploads"| node_telegram_service
node_upload -->|"processes videos"| node_video_service
node_upload -->|"reads and updates"| node_videos_repo
node_upload -->|"records uploads"| node_uploads_repo
node_telegram_service -->|"calls Bot API"| node_telegram
node_videos_repo -->|"queries through"| node_connection
node_videos_repo -->|"reads and writes"| node_video_table
node_uploads_repo -->|"queries through"| node_connection
node_uploads_repo -->|"reads and writes"| node_upload_table
node_uploads_repo -->|"joins"| node_video_table
node_upload -->|"uses metadata"| node_metadata
node_boot -->|"selects configured preset"| node_preset

click node_boot "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/main/boot.ts"
click node_settings "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/SettingsService.ts"
click node_cli "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/cli/ClackCLIService.ts"
click node_menu "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/MenuUsecase.ts"
click node_printpreset "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/PrintPresetInfoUsecase.ts"
click node_printvideo "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/PrintVideoInfoUsecase.ts"
click node_availability "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/PrintVideosByAvailabilityUsecase.ts"
click node_upload "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/UploadVideosUsecase.ts"
click node_edit "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/EditVideoUsecase.ts"
click node_delete "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/DeleteVideoUsecase.ts"
click node_preset "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/domain/Preset.ts"
click node_metadata "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/domain/VideoMetadata.ts"
click node_video_service "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/VideosService.ts"
click node_telegram_service "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/TelegramService.ts"
click node_videos_repo "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/repositories/VideosRepository.ts"
click node_uploads_repo "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/repositories/VideoUploadsRepository.ts"
click node_connection "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/db/DrizzleConnection.ts"
click node_video_table "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/db/schemas/videosTable.ts"
click node_upload_table "https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/db/schemas/videoUploadsTable.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_boot,node_user toneBlue
class node_menu,node_printpreset,node_printvideo,node_availability,node_upload,node_edit,node_delete toneAmber
class node_settings,node_cli,node_video_service,node_telegram_service,node_telegram toneMint
class node_preset,node_metadata,node_videos_repo,node_uploads_repo,node_connection,node_video_table,node_upload_table toneRose
```

## Components

### CLI entry and control

- [Application boot](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/main/boot.ts): `src/main/boot.ts`

### Video workflows

- [Action menu](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/MenuUsecase.ts): `src/usecases/MenuUsecase.ts`
- [Preset details](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/PrintPresetInfoUsecase.ts): `src/usecases/PrintPresetInfoUsecase.ts`
- [Video details](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/PrintVideoInfoUsecase.ts): `src/usecases/PrintVideoInfoUsecase.ts`
- [Availability listing](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/PrintVideosByAvailabilityUsecase.ts): `src/usecases/PrintVideosByAvailabilityUsecase.ts`
- [Video upload](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/UploadVideosUsecase.ts): `src/usecases/UploadVideosUsecase.ts`
- [Video editing](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/EditVideoUsecase.ts): `src/usecases/EditVideoUsecase.ts`
- [Video deletion](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/usecases/DeleteVideoUsecase.ts): `src/usecases/DeleteVideoUsecase.ts`

### Services and integrations

- [Settings loader](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/SettingsService.ts): `src/services/resources/SettingsService.ts`
- [Interactive CLI](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/cli/ClackCLIService.ts): `src/services/resources/cli/ClackCLIService.ts`
- [Video processing](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/VideosService.ts): `src/services/resources/VideosService.ts`
- [Telegram operations](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/services/resources/TelegramService.ts): `src/services/resources/TelegramService.ts`

### Domain and persistence

- [Preset model](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/domain/Preset.ts): `src/domain/Preset.ts`
- [Video metadata](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/domain/VideoMetadata.ts): `src/domain/VideoMetadata.ts`
- [Video records](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/repositories/VideosRepository.ts): `src/repositories/VideosRepository.ts`
- [Upload records](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/repositories/VideoUploadsRepository.ts): `src/repositories/VideoUploadsRepository.ts`
- [Database connection](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/db/DrizzleConnection.ts): `src/db/DrizzleConnection.ts`
- [Video tables](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/db/schemas/videosTable.ts): `src/db/schemas/videosTable.ts`
- [Upload tables](https://github.com/nathanmbr/telegram-videos-uploader/blob/master/src/db/schemas/videoUploadsTable.ts): `src/db/schemas/videoUploadsTable.ts`

### Other components

- **CLI user**
- **Telegram Bot API**

## Connections

- CLI user → Application boot: starts (evidence: `README.md`)
- Application boot → Settings loader: loads settings (evidence: `src/main/boot.ts`)
- Application boot → Interactive CLI: selects preset (evidence: `src/main/boot.ts`)
- Application boot → Database connection: runs migrations (evidence: `src/main/boot.ts`)
- Application boot → Action menu: executes menu (evidence: `src/main/boot.ts`)
- Application boot → Preset details: registers action (evidence: `src/main/boot.ts`)
- Application boot → Video details: registers action (evidence: `src/main/boot.ts`)
- Application boot → Availability listing: registers action (evidence: `src/main/boot.ts`)
- Application boot → Video upload: registers action (evidence: `src/main/boot.ts`)
- Application boot → Video editing: registers action (evidence: `src/main/boot.ts`)
- Application boot → Video deletion: registers action (evidence: `src/main/boot.ts`)
- Video upload → Telegram operations: checks and uploads (evidence: `src/usecases/UploadVideosUsecase.ts`)
- Video upload → Video processing: processes videos (evidence: `src/usecases/UploadVideosUsecase.ts`)
- Video upload → Video records: reads and updates (evidence: `src/usecases/UploadVideosUsecase.ts`)
- Video upload → Upload records: records uploads (evidence: `src/usecases/UploadVideosUsecase.ts`)
- Telegram operations → Telegram Bot API: calls Bot API (evidence: `src/services/resources/TelegramService.ts`)
- Video records → Database connection: queries through (evidence: `src/repositories/VideosRepository.ts`)
- Video records → Video tables: reads and writes (evidence: `src/repositories/VideosRepository.ts`)
- Upload records → Database connection: queries through (evidence: `src/repositories/VideoUploadsRepository.ts`)
- Upload records → Upload tables: reads and writes (evidence: `src/repositories/VideoUploadsRepository.ts`)
- Upload records → Video tables: joins (evidence: `src/repositories/VideoUploadsRepository.ts`)
- Video upload → Video metadata: uses metadata (evidence: `src/usecases/UploadVideosUsecase.ts`)
- Application boot → Preset model: selects configured preset (evidence: `src/main/boot.ts`)
