api

type Account ¶

type Account struct {
	ID       string
	Name     string
	Handle   string
	Verified bool
}

Account is the identity attached to the imported browser session.

type AmbiguousPostError ¶

type AmbiguousPostError struct {
	Reconciliation string
}

AmbiguousPostError means the CreateTweet mutation returned without a trustworthy success id or a structured rejection. The post may exist, so callers must preserve the draft and must not automatically retry.

func (e *AmbiguousPostError) Error() string

type AutomationBlockedError ¶

type AutomationBlockedError struct {
	Message string
}

AutomationBlockedError means X accepted the HTTP request but rejected this post as suspected automation or spam. The decision can be content-sensitive, so callers must not claim the whole session is blocked or retry the mutation automatically.

func (e *AutomationBlockedError) Error() string

type ConnectionError ¶

type ConnectionError struct {
	Kind string
	Err  error
}

ConnectionError gives network failures a stable, actionable message while retaining the original error for errors.Is/errors.As checks and diagnostics.

func (e *ConnectionError) Error() string

func (e *ConnectionError) Unwrap() error

type ConversationPage ¶

type ConversationPage struct {
	Posts      []ConversationPost
	Unresolved []TimelinePost
	Cursor     string
}

ConversationPage is one ordered page from X's TweetDetail timeline.

type ConversationPost ¶

type ConversationPost struct {
	TimelinePost
	Depth int
}

ConversationPost is one post in a TweetDetail conversation. Depth is relative to the focal post (the focal post itself has depth zero).

type DiagnosticError ¶

type DiagnosticError interface {
	error
	Diagnostic() string
}

DiagnosticError is implemented by errors that carry a sanitized diagnostic string. Diagnostics contain response shape and request metadata only, never cookies or post contents.

type LoginResult ¶

type LoginResult struct {
	AuthToken    string
	CT0          string
	Profile      string
	CookieDomain string
	ExpiresAt    time.Time
	LastUsedAt   time.Time
}

LoginResult is the session material an auth method yields.

func ImportBrowserSession(name string) (*LoginResult, string, error)

type Notification ¶ added in v0.1.11

type Notification struct {
	ID   string
	Kind NotificationKind
	Post TimelinePost
}

Notification is a reply or mention with the post that caused it.

type NotificationKind ¶ added in v0.1.11

type NotificationKind string

NotificationKind identifies the actionable conversation events Xeet shows.

const (
	NotificationReply   NotificationKind = "reply"
	NotificationMention NotificationKind = "mention"
)

type NotificationPage ¶ added in v0.1.11

type NotificationPage struct {
	Notifications []Notification
	Cursor        string
	AccountID     string
}

NotificationPage is one page from the authenticated notification timeline.

type PostEvent ¶

type PostEvent struct {
	Stage            PostStage
	Current          int
	Total            int
	Name             string
	TransferredBytes int64
	TotalBytes       int64
}

PostEvent reports coarse posting progress. The callback is optional. Chunked uploads additionally fill the byte counters so UIs can show a percentage while a video transfers.

type PostStage ¶

type PostStage string

const (
	PostStageUploading   PostStage = "uploading"
	PostStageProcessing  PostStage = "processing"
	PostStageDiscovering PostStage = "discovering"
	PostStagePublishing  PostStage = "publishing"
	PostStageReconciling PostStage = "reconciling"
	PostStageComplete    PostStage = "complete"
)

type PostingRestrictedError ¶

type PostingRestrictedError struct{}

PostingRestrictedError means X rejected this particular post under an account or content posting restriction.

func (e *PostingRestrictedError) Error() string

type ProgressFunc ¶

type ProgressFunc func(PostEvent)

type RateLimitError ¶

type RateLimitError struct {
	Reset time.Time
}

RateLimitError means X throttled the request (HTTP 429 or GraphQL code 88). Reset is when the limit window ends, when X told us; zero otherwise.

func (e *RateLimitError) Error() string

type RecentlyPostedError ¶

type RecentlyPostedError struct{}

RecentlyPostedError means X classified the text as recently posted. Xeet attributes that decision to X instead of claiming the posts are identical.

func (e *RecentlyPostedError) Error() string

type RequestShape ¶

type RequestShape struct {
	HeaderNames     []string
	CookieNames     []string
	BodyKeys        []string
	VariableKeys    []string
	FeatureKeys     []string
	UserAgentFamily string
	UserAgentMajor  string
	Platform        string
}

RequestShape contains only structural metadata from a CreateTweet request. It intentionally excludes every header value, cookie value, and body value.

type RequestShapeComparison ¶

type RequestShapeComparison struct {
	Browser RequestShape
	Xeet    RequestShape
}

RequestShapeComparison compares a successful browser request with the request Xeet currently builds. Every field is safe to print.

func CompareCreateTweetHAR(reader io.Reader) (*RequestShapeComparison, error)

func (c *RequestShapeComparison) String() string

type ServiceUnavailableError ¶

type ServiceUnavailableError struct{ Status int }

ServiceUnavailableError means X's servers failed after bounded retries.

func (e *ServiceUnavailableError) Error() string

type TimelineMedia ¶

type TimelineMedia struct {
	URL      string
	Type     string
	AltText  string
	Width    int
	Height   int
	VideoURL string
}

type TimelinePage ¶

type TimelinePage struct {
	Posts  []TimelinePost
	Cursor string
}

type TimelinePost ¶

type TimelinePost struct {
	ID             string
	Text           string
	AuthorName     string
	Handle         string
	CreatedAt      time.Time
	ReplyCount     int
	RepostCount    int
	LikeCount      int
	ViewCount      string
	MediaCount     int
	Media          []TimelineMedia
	Liked          bool
	InReplyToID    string
	ConversationID string
}

type Upload ¶

type Upload struct {
	Filename    string
	ContentType string
	Data        []byte
	Path        string
}

Upload is one media item to upload and attach to a post. Images travel in Data; large media (video) sets Path instead and streams from disk through the chunked endpoint.

type WebClient ¶

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

WebClient posts through x.com's internal GraphQL API using a logged-in browser session (auth_token + ct0 cookies) instead of the developer API.

func NewWebClient(cfg *config.Config) *WebClient

func (c *WebClient) ApplyRefreshedQueryIDs(cfg *config.Config) bool

func (c *WebClient) FetchBookmarks(ctx context.Context, cursor string, count int) (*TimelinePage, error)

func (c *WebClient) FetchFollowingTimeline(ctx context.Context, cursor string, count int) (*TimelinePage, error)

func (c *WebClient) FetchHomeTimeline(ctx context.Context, cursor string, count int) (*TimelinePage, error)

func (c *WebClient) FetchNotifications(ctx context.Context, cursor string, count int) (*NotificationPage, error)

func (c *WebClient) FetchSearchTimeline(ctx context.Context, query, cursor string, count int) (*TimelinePage, error)

func (c *WebClient) FetchTweetDetail(ctx context.Context, tweetID, cursor string, count int) (*ConversationPage, error)

func (c *WebClient) FetchViewer(ctx context.Context) (*Account, error)

func (c *WebClient) LastDiagnostic() string

func (c *WebClient) PostTweet(ctx context.Context, text, replyToID string, uploads []Upload, progress ProgressFunc) (string, error)

func (c *WebClient) SetTweetLiked(ctx context.Context, tweetID string, liked bool) error

func (c *WebClient) Verify(ctx context.Context) error