api

type API interface {
	component.Component
	config.Watcher

	QueryAppConfigSchema(
		ctx context.Context,
		req *QueryAppConfigSchemaRequest,
	) (resp *QueryAppConfigSchemaResponse, err error)
	QueryAppConfig(ctx context.Context, req *QueryAppConfigRequest) (resp *QueryAppConfigResponse, err error)
	ApplyAppConfig(ctx context.Context, req *ApplyAppConfigRequest) (resp *ApplyAppConfigResponse, err error)

	QueryRSSHubCategories(
		ctx context.Context,
		req *QueryRSSHubCategoriesRequest,
	) (resp *QueryRSSHubCategoriesResponse, err error)
	QueryRSSHubWebsites(
		ctx context.Context,
		req *QueryRSSHubWebsitesRequest,
	) (resp *QueryRSSHubWebsitesResponse, err error)
	QueryRSSHubRoutes(ctx context.Context, req *QueryRSSHubRoutesRequest) (resp *QueryRSSHubRoutesResponse, err error)

	Write(ctx context.Context, req *WriteRequest) (resp *WriteResponse, err error) // WARN: beta!!!
	Query(ctx context.Context, req *QueryRequest) (resp *QueryResponse, err error)
}

type ApplyAppConfigRequest struct {
	config.App `yaml:",inline" json:",inline"`
}

type ApplyAppConfigResponse struct{}

type Config struct {
	RSSHubEndpoint string
	LLM            string
}

type Dependencies struct {
	ConfigManager config.Manager
	FeedStorage   feed.Storage
	LLMFactory    llm.Factory
}

type Error struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type Factory component.Factory[API, config.App, Dependencies]

type QueryAppConfigRequest struct{}

type QueryAppConfigResponse struct {
	config.App `yaml:",inline" json:",inline"`
}

type QueryAppConfigSchemaRequest struct{}

type QueryAppConfigSchemaResponse map[string]any

type QueryRSSHubCategoriesRequest struct{}

type QueryRSSHubCategoriesResponse struct {
	Categories []string `json:"categories,omitempty"`
}

type QueryRSSHubRoutesRequest struct {
	WebsiteID string `json:"website_id,omitempty"`
}

type QueryRSSHubRoutesResponse struct {
	Routes []RSSHubRoute `json:"routes,omitempty"`
}

type QueryRSSHubWebsitesRequest struct {
	Category string `json:"category,omitempty"`
}

type QueryRSSHubWebsitesResponse struct {
	Websites []RSSHubWebsite `json:"websites,omitempty"`
}

type QueryRequest struct {
	Query        string    `json:"query,omitempty"`
	Threshold    float32   `json:"threshold,omitempty"`
	LabelFilters []string  `json:"label_filters,omitempty"`
	Summarize    bool      `json:"summarize,omitempty"`
	Limit        int       `json:"limit,omitempty"`
	Start        time.Time `json:"start,omitempty"`
	End          time.Time `json:"end,omitempty"`
}

type QueryRequestSemanticFilter struct {
	Query     string  `json:"query,omitempty"`
	Threshold float32 `json:"threshold,omitempty"`
}

type QueryResponse struct {
	Summary string          `json:"summary,omitempty"`
	Feeds   []*block.FeedVO `json:"feeds"`
	Count   int             `json:"count"`
}

type RSSHubRoute struct {
	Name        string         `json:"name,omitempty"`
	Description string         `json:"description,omitempty"`
	Path        any            `json:"path,omitempty"`
	Example     string         `json:"example,omitempty"`
	Parameters  map[string]any `json:"parameters,omitempty"`
	Features    map[string]any `json:"features,omitempty"`
}

type RSSHubWebsite struct {
	ID          string   `json:"id,omitempty"`
	Name        string   `json:"name,omitempty"`
	Description string   `json:"description,omitempty"`
	Categories  []string `json:"categories,omitempty"`
}

type WriteRequest struct {
	Feeds []*model.Feed `json:"feeds"`
}

type WriteResponse struct{} // TODO: data may lost (if crash just now) after Response returned.