tgclient

type ChatInfo struct {
	ID            int64   `json:"id"`
	Name          string  `json:"name"`
	Type          string  `json:"type"`
	Username      *string `json:"username"`
	Phone         *string `json:"phone,omitempty"`
	Contact       *bool   `json:"contact,omitempty"`
	MutualContact *bool   `json:"mutual_contact,omitempty"`
	About         *string `json:"about,omitempty"`
	Members       *int    `json:"members,omitempty"`
}

type ChatRef struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
	Type string `json:"type"`
}

type Conn struct {
	Client *telegram.Client
	API    *tg.Client
	Config config.Config
	Cache  *PeerCache
	Self   *tg.User // set when Options.NeedAuth
}

type ContactsResult struct {
	Mine   []User `json:"mine"`
	Public []User `json:"public"`
}

type Dialog struct {
	ID       int64        `json:"id"`
	Name     string       `json:"name"`
	Type     string       `json:"type"`
	Username *string      `json:"username"`
	Unread   int          `json:"unread"`
	Mentions int          `json:"mentions"`
	Pinned   bool         `json:"pinned"`
	Archived bool         `json:"archived"`
	Muted    bool         `json:"muted"`
	Last     *LastMessage `json:"last,omitempty"`

	Peer           Peer `json:"-"`
	TopMessage     int  `json:"-"`
	ReadInboxMaxID int  `json:"-"`
}

type Download struct {
	Path  string `json:"path"`
	Media *Media `json:"media"`
}

type FileStorage struct {
	Path  string
	Write func(path string, data []byte) error
}

type Folder int

type HistoryQuery struct {
	Limit      int
	OffsetID   int       // ids below this (or above it when Reverse)
	OffsetDate time.Time // messages before this (or after it when Reverse)
	MinID      int       // exclusive
	MaxID      int       // exclusive
	Reverse    bool      // oldest first
	Topic      int       // forum topic id (messages.getReplies)
}

type Kind string

type LastMessage struct {
	ID     int     `json:"id"`
	Date   string  `json:"date"`
	FromMe bool    `json:"from_me"`
	Text   string  `json:"text"`
	Media  *string `json:"media"`
}

type Media struct {
	Type     string `json:"type"`
	Name     string `json:"name,omitempty"`
	Mime     string `json:"mime,omitempty"`
	Size     int64  `json:"size,omitempty"`
	URL      string `json:"url,omitempty"`
	Title    string `json:"title,omitempty"`
	Question string `json:"question,omitempty"`
}

type MentionsQuery struct {
	Unread bool // messages.getUnreadMentions (does not mark them read)
	Limit  int
	Scan   int // without a chat and Unread: how many recent groups to search (0 = default)
}

type Message struct {
	ID            int     `json:"id"`
	ChatID        int64   `json:"chat_id"`
	ChatName      *string `json:"chat_name"`
	Date          string  `json:"date"`
	FromMe        bool    `json:"from_me"`
	SenderID      *int64  `json:"sender_id"`
	SenderName    *string `json:"sender_name"`
	Text          string  `json:"text"`
	Edited        string  `json:"edited,omitempty"`
	ReplyTo       int     `json:"reply_to,omitempty"`
	ForwardedFrom any     `json:"forwarded_from,omitempty"`
	Media         *Media  `json:"media,omitempty"`
	Album         int64   `json:"album,omitempty"`
	Service       string  `json:"service,omitempty"`
	Views         *int    `json:"views,omitempty"`
	Mentioned     bool    `json:"mentioned,omitempty"`

	Time time.Time `json:"-"`
}

type Options struct {
	Paths      config.Paths
	AppVersion string
	AuthMode   bool // allow auth.* methods through the read-only guard
	NeedAuth   bool // fail with an auth error unless the session is logged in
	// UpdateHandler enables updates (needed for QR login); nil means no updates.
	UpdateHandler telegram.UpdateHandler
	// Middlewares run after the read-only guard, i.e. they see only what goes to the network.
	Middlewares []telegram.Middleware
}

type Peer struct {
	ID         int64  `json:"id"`
	Name       string `json:"name"`
	Type       string `json:"type"`
	Username   string `json:"username,omitempty"`
	Kind       Kind   `json:"-"`
	RawID      int64  `json:"-"`
	AccessHash int64  `json:"-"`
}

type PeerCache struct {
	// contains filtered or unexported fields
}

type Ref struct {
	Kind  RefKind
	ID    int64
	Value string // username, invite hash, phone digits, or name
}

type RefKind int

type SearchQuery struct {
	Query  string
	From   *Peer // sender filter; needs a chat
	Limit  int
	After  time.Time
	Before time.Time
}

type Session struct {
	// contains filtered or unexported fields
}

type Telegram interface {
	Self(ctx context.Context) (*User, error)

	// IterDialogs calls fn for each dialog (pinned first, then by recency) until fn returns false.
	IterDialogs(ctx context.Context, folder Folder, fn func(Dialog) bool) error
	// Resolve accepts a marked id, @username, t.me link, +phone, or a dialog name.
	Resolve(ctx context.Context, ref string) (*Peer, error)
	PeerInfo(ctx context.Context, p *Peer) (*ChatInfo, error)

	History(ctx context.Context, p *Peer, q HistoryQuery) ([]Message, error)
	// Search searches one chat, or the whole account when p is nil.
	Search(ctx context.Context, p *Peer, q SearchQuery) ([]Message, error)
	MessagesByID(ctx context.Context, p *Peer, ids []int) ([]Message, error)
	// Mentions lists messages that mention or reply to the user, in one chat or all (p nil).
	Mentions(ctx context.Context, p *Peer, q MentionsQuery) ([]Message, error)

	SearchContacts(ctx context.Context, query string, limit int) (*ContactsResult, error)
	DownloadMedia(ctx context.Context, p *Peer, msgID int, dir string) (*Download, error)

	SendText(ctx context.Context, p *Peer, text string, replyTo int) (*Message, error)
	SendFile(ctx context.Context, p *Peer, path, caption string, replyTo int) (*Message, error)
}

type TelethonImport struct {
	Data  *session.Data
	Peers []TelethonPeer
}

type TelethonPeer struct {
	Peer  Peer
	Phone string
}

type User struct {
	ID            int64   `json:"id"`
	Name          string  `json:"name"`
	Type          string  `json:"type"`
	Username      *string `json:"username"`
	Phone         *string `json:"phone"`
	Contact       bool    `json:"contact"`
	MutualContact bool    `json:"-"`
}