api

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

type Comment struct {
	*Item
	Depth    int
	Children []*Comment
}

type Item struct {
	ID          int    `json:"id"`
	Type        string `json:"type"`
	By          string `json:"by"`
	Time        int64  `json:"time"`
	Text        string `json:"text"`
	URL         string `json:"url"`
	Title       string `json:"title"`
	Score       int    `json:"score"`
	Kids        []int  `json:"kids"`
	Parent      int    `json:"parent"`
	Descendants int    `json:"descendants"`
	Deleted     bool   `json:"deleted"`
	Dead        bool   `json:"dead"`
}

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

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

type Source interface {
	// Name returns the display name of the source
	Name() string

	// FeedNames returns the available feed names for this source
	FeedNames() []string

	// FeedLabels returns the display labels for feeds (for UI tabs)
	FeedLabels() []string

	// FetchStoryIDs fetches the list of story IDs for a given feed
	// For sources without IDs (like Lobste.rs), this returns page-based pseudo-IDs
	FetchStoryIDs(feed string) ([]int, error)

	// FetchItem fetches a single item by ID
	FetchItem(id int) (*Item, error)

	// FetchItems fetches multiple items by ID
	FetchItems(ids []int) ([]*Item, error)

	// FetchCommentTree fetches the comment tree for a story
	FetchCommentTree(item *Item, maxDepth int) ([]*Comment, error)

	// StoryURL returns the URL for viewing a story on the source's website
	StoryURL(item *Item) string
}