services

type App struct {
	Posts PostService
	Feeds FeedService
	Tags  TagService
	Build BuildService

	// Manager is the underlying lifecycle manager (for advanced access)
	Manager *lifecycle.Manager
}

type BuildEvent struct {
	// Type is the event type
	Type BuildEventType

	// Stage is the current build stage
	Stage string

	// Message is the event message
	Message string

	// Progress is the progress percentage (0-100)
	Progress int

	// Error is the error if Type is BuildEventError
	Error error
}

type BuildEventType string

type BuildOptions struct {
	// Watch enables watch mode for continuous rebuilding
	Watch bool

	// Serve enables the development server
	Serve bool

	// Port is the server port (default: 8080)
	Port int

	// Clean removes output directory before building
	Clean bool

	// Concurrency sets parallel processing level
	Concurrency int
}

type BuildResult struct {
	// Success indicates if the build completed successfully
	Success bool

	// Duration is the build time
	Duration time.Duration

	// PostsProcessed is the number of posts processed
	PostsProcessed int

	// FilesWritten is the number of files written
	FilesWritten int

	// Errors contains any errors that occurred
	Errors []error

	// Warnings contains non-critical warnings
	Warnings []string
}

type BuildService interface {
	// Build runs the build process.
	Build(ctx context.Context, opts BuildOptions) (*BuildResult, error)

	// LoadOnly runs only the load stage (for TUI browsing without full build).
	LoadOnly(ctx context.Context) error

	// LoadForTUI runs through Collect stage for TUI browsing.
	// This includes Transform (for stats, titles) and Collect (for feeds).
	LoadForTUI(ctx context.Context) error

	// Subscribe returns a channel for build progress events.
	Subscribe() <-chan BuildEvent
}

type DateRange struct {
	Start *time.Time
	End   *time.Time
}

type FeedService interface {
	// List returns all configured feeds.
	List(ctx context.Context) ([]*lifecycle.Feed, error)

	// Get returns a single feed by name.
	Get(ctx context.Context, name string) (*lifecycle.Feed, error)

	// GetPosts returns posts belonging to a feed.
	GetPosts(ctx context.Context, feedName string, opts ListOptions) ([]*models.Post, error)
}

type ListOptions struct {
	// Filter is a filter expression (same syntax as lifecycle.Manager.Filter)
	Filter string

	// Tags filters posts by tags (AND logic - post must have all tags)
	Tags []string

	// DateRange filters posts by date range
	DateRange *DateRange

	// Published filters by published status (nil = all)
	Published *bool

	// Draft filters by draft status (nil = all)
	Draft *bool

	// SortBy is the field to sort by (e.g., "date", "title")
	SortBy string

	// SortOrder is the sort direction (default: desc for date, asc for title)
	SortOrder SortOrder

	// Offset is the number of items to skip (for pagination)
	Offset int

	// Limit is the maximum number of items to return (0 = no limit)
	Limit int
}

type PostService interface {
	// List returns posts matching the given options.
	List(ctx context.Context, opts ListOptions) ([]*models.Post, error)

	// Get returns a single post by path.
	Get(ctx context.Context, path string) (*models.Post, error)

	// Search returns posts matching a text query.
	Search(ctx context.Context, query string, opts SearchOptions) ([]*models.Post, error)

	// Count returns the total number of posts matching options.
	Count(ctx context.Context, opts ListOptions) (int, error)
}

type SearchOptions struct {
	// Fields to search in (default: title, description, content)
	Fields []string

	// CaseSensitive enables case-sensitive search
	CaseSensitive bool

	// Fuzzy enables fuzzy matching
	Fuzzy bool

	// Limit is the maximum number of results (0 = no limit)
	Limit int
}

type SortOrder string

type TagInfo struct {
	// Name is the tag name
	Name string

	// Count is the number of posts with this tag
	Count int

	// Slug is the URL-safe version of the tag
	Slug string
}

type TagService interface {
	// List returns all tags with their post counts.
	List(ctx context.Context) ([]TagInfo, error)

	// GetPosts returns posts with a specific tag.
	GetPosts(ctx context.Context, tag string, opts ListOptions) ([]*models.Post, error)
}