openapi

type Client ¶

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

Client is Aether's internal aggregator for all OpenAPI integrations.

The Client is intentionally simple: it wraps the shared internal HTTP fetcher. Actual service logic (Wikipedia, HN, GitHub, etc.) lives in separate files within this package.

The design allows:

• zero-copy reuse of Aether’s HTTP/cache/robots pipeline
• strong isolation between integrations
• safe concurrent usage across goroutines

OpenAPI Client is safe for concurrent use.

func New(cfg *config.Config, logger log.Logger, httpClient *httpclient.Client) *Client

func (c *Client) GitHubReadme(ctx context.Context, owner, repo, ref string) (*GitHubReadme, error)

func (c *Client) GovernmentPress(ctx context.Context, limit int) ([]PressRelease, error)

func (c *Client) HackerNewsTopStories(ctx context.Context, limit int) ([]HNStory, error)

func (c *Client) WeatherAt(ctx context.Context, lat, lon float64, hours int) ([]Weather, error)

func (c *Client) WhiteHouseRecentPosts(ctx context.Context, limit int) ([]WhiteHousePost, error)

func (c *Client) WikidataLookup(ctx context.Context, name string) (*WikidataEntity, error)

func (c *Client) WikipediaSummary(ctx context.Context, title string) (*WikiSummary, error)

type GitHubReadme ¶

type GitHubReadme struct {
	Owner   string
	Repo    string
	Ref     string
	URL     string
	Content string
}

GitHubReadme represents a normalized GitHub README document.

type HNStory ¶

type HNStory struct {
	ID           int64
	Title        string
	URL          string
	Author       string
	Score        int
	Time         time.Time
	CommentCount int
}

HNStory represents a normalized Hacker News story.

type PressRelease ¶

type PressRelease struct {
	Title   string
	URL     string
	Source  string
	Snippet string
	Date    time.Time
}

PressRelease represents a normalized government press item.

type Weather ¶

type Weather struct {
	Time        time.Time
	Temperature float64
	Humidity    float64
	WindSpeed   float64
	Summary     string
}

Weather represents a normalized hourly weather entry.

type WhiteHousePost ¶

type WhiteHousePost struct {
	ID      int64
	Title   string
	URL     string
	Date    time.Time
	Excerpt string
}

WhiteHousePost represents a normalized White House post.

type WikiSummary ¶

type WikiSummary struct {
	Title       string
	Description string
	Extract     string
	URL         string
	Language    string
}

WikiSummary is the internal Wikipedia summary representation.

type WikidataEntity ¶

type WikidataEntity struct {
	ID          string
	Title       string
	Description string
	URL         string
}

WikidataEntity is the normalized Wikidata entity info.