How awsl-project/awsl-telegram-storage works
AWSL Telegram Storage is a Cloudflare Workers API for storing files through Telegram, with uploads returning Telegram file IDs and download or video-stream endpoints retrieving them. The main workflow is client → routed endpoint → Telegram Bot API → client; uploads may use permanent or temporary upload-scoped JWT authentication. The graph also preserves media-group uploads, token generation, OpenAPI/CORS, and range-aware chunk streaming. Evidence for route wiring and upload helpers is excerpted; download and stream rely on documented behavior and shown endpoint code, without claiming a shared Telegram helper.
Main entry points: index.ts HTTP router · api_upload.ts Single upload · api_upload_group.ts Media-group upload · api_stream.ts Video streaming
Components 13
API surface
- HTTP router
src/index.ts - OpenAPI docs
src/index.ts - CORS handling
src/index.ts
Upload and auth
- Single upload
src/api_upload.ts - Media-group upload
src/api_upload_group.ts - JWT generation
src/api_token_generate.ts - Token validation
src/auth.ts - Upload helpers
src/telegram.ts
File retrieval
- File download
src/api_download.ts - Video streaming
src/api_stream.ts
Telegram service
- Telegram Bot API
- Telegram file storage
Other components
- Client
Connections 20
- Client → HTTP router: sends requests
README.md - HTTP router → Single upload: routes uploads
src/index.ts - HTTP router → Media-group upload: routes groups
src/index.ts - HTTP router → JWT generation: routes token requests
src/index.ts - HTTP router → File download: routes downloads
src/index.ts - HTTP router → Video streaming: routes streams
src/index.ts - HTTP router → OpenAPI docs: serves docs
src/index.ts - HTTP router → CORS handling: applies CORS
src/index.ts - Single upload → Token validation: validates token
src/api_upload.ts - Media-group upload → Token validation: validates token
src/api_upload_group.ts - Single upload → Upload helpers: uses upload helpers
src/api_upload.ts - Media-group upload → Upload helpers: uses upload helpers
src/api_upload_group.ts - Single upload → Telegram Bot API: sends file
src/api_upload.ts - Media-group upload → Telegram Bot API: sends media group
src/api_upload_group.ts - JWT generation → Telegram Bot API: includes chat ID
- Telegram Bot API → Telegram file storage: stores files
README.md - Telegram Bot API → File download: returns file data
src/api_download.ts - Video streaming → Telegram Bot API: fetches chunks
src/api_stream.ts - File download → Client: returns file stream
README.md - Video streaming → Client: returns ranged stream
README.md