api

type Client interface {
	// GetServer retrieves a single server by its reverse-DNS name
	GetServer(ctx context.Context, name string) (*v0.ServerJSON, error)

	// ListServers retrieves all servers with automatic pagination handling
	ListServers(ctx context.Context, opts *ListOptions) ([]*v0.ServerJSON, error)

	// SearchServers searches for servers matching the query string
	// Always returns the latest version of each server
	SearchServers(ctx context.Context, query string) ([]*v0.ServerJSON, error)

	// ValidateEndpoint validates that the endpoint implements the MCP Registry API
	ValidateEndpoint(ctx context.Context) error
}

type ListOptions struct {
	// Limit is the maximum number of servers to retrieve per page (default: 100)
	Limit int

	// UpdatedSince filters servers updated after this RFC3339 timestamp
	UpdatedSince string

	// Version filters servers by version (e.g., "latest")
	Version string
}

type RegistryHTTPError struct {
	StatusCode int
	Body       string
	URL        string
}

type SkillsClient interface {
	// GetSkill retrieves a skill by namespace and name (latest version).
	GetSkill(ctx context.Context, namespace, name string) (*thvregistry.Skill, error)
	// GetSkillVersion retrieves a specific version of a skill.
	GetSkillVersion(ctx context.Context, namespace, name, version string) (*thvregistry.Skill, error)
	// ListSkills retrieves skills with optional filtering and pagination.
	ListSkills(ctx context.Context, opts *SkillsListOptions) (*SkillsListResult, error)
	// SearchSkills searches for skills matching the query (single page, no auto-pagination).
	SearchSkills(ctx context.Context, query string) (*SkillsListResult, error)
	// ListSkillVersions lists all versions of a specific skill.
	ListSkillVersions(ctx context.Context, namespace, name string) (*SkillsListResult, error)
}

type SkillsListOptions struct {
	// Search is an optional search query to filter skills.
	Search string
	// Limit is the maximum number of skills per page (default: 100).
	Limit int
	// Cursor is the pagination cursor for fetching the next page.
	Cursor string
}

type SkillsListResult struct {
	Skills     []*thvregistry.Skill
	NextCursor string
}