Glossary

Glossary

Application Support

A macOS location for app-managed persistent data. Under App Sandbox, the exact path can live inside the application's container.

Attachment

A normalized downloadable Telegram media/file record containing identity, filename provenance, category, known size, sent date, and eligibility.

Attachment identity

The combination of Telegram chat ID, message ID, and file ID used to distinguish attachments independently from display names.

Bounded scan

A history scan limited to the latest 25, 50, 100, 250, or 500 distinct messages.

Conflict

A state where a planned destination already exists or two selected files plan the same destination path.

Download Again

An explicit temporary override of the local already-downloaded guard. It does not override filesystem conflict safety.

Generated filename

A neutral deterministic fallback used only when Telegram provides no usable original or file-representation filename.

Keychain

The macOS credential store used for the Telegram API ID and API hash.

Message range

The selected history scope. It is part of the attachment-cache key and is saved per chat.

Original filename

The filename supplied by Telegram's media representation. It is preferred over music metadata, captions, or generated names.

Preflight

The required preparation step that deduplicates Telegram file IDs, calculates known size, checks destination capacity, and discovers filename conflicts.

Save a Copy

An explicit conflict action that creates a new destination name using a visible copy suffix.

Security-scoped bookmark

A persistent macOS token that lets the sandbox reopen a folder previously selected by the user.

Snapshot

A partial or complete local attachment index for one chat ID and message range.

TDLib

Telegram Database Library, the official Telegram client library used for authorization, chats, history, updates, and file transfers.

TDLib file ID

Telegram's file identifier used for transfer and the local already-downloaded guard. It is not a content hash.

@MainActor

Swift isolation used for observable interface state and user intents.

Actor

A Swift concurrency construct used to serialize access to mutable shared state such as TDLib requests, repositories, persistence, downloads, and destination access.