capability

type ArchiveItem struct {
	ID        string    `json:"id"`
	URL       string    `json:"url"`
	Title     string    `json:"title,omitzero"`
	Status    string    `json:"status"`
	CreatedAt time.Time `json:"created_at"`
}

type Bookmark struct {
	ID         string    `json:"id"`
	URL        string    `json:"url"`
	Title      string    `json:"title,omitzero"`
	Summary    string    `json:"summary,omitzero"`
	Tags       []string  `json:"tags,omitzero"`
	Archived   bool      `json:"archived"`
	Favourited bool      `json:"favourited"`
	CreatedAt  time.Time `json:"created_at"`
}

type BookmarkListQuery struct {
	Page       PageRequest
	Archived   *bool
	Favourited *bool
	Tags       []string
}

type BookmarkSearchQuery struct {
	Page PageRequest
	Q    string
}

type CursorPayload struct {
	Capability string `json:"capability,omitempty"`
	// Backend is retained only for decoding cursors issued before CapType==provider ID.
	// New encoders must leave it empty; do not write this field.
	Backend        string    `json:"backend,omitempty"`
	Strategy       string    `json:"strategy,omitempty"`
	ProviderCursor string    `json:"provider_cursor,omitempty"`
	Page           int       `json:"page,omitempty"`
	Offset         int       `json:"offset,omitempty"`
	Limit          int       `json:"limit,omitempty"`
	SortBy         string    `json:"sort_by,omitempty"`
	SortOrder      string    `json:"sort_order,omitempty"`
	FilterHash     string    `json:"filter_hash,omitempty"`
	ExpiresAt      time.Time `json:"expires_at"`
}

type DevopsDashboard struct {
	UID   string `json:"uid"`
	Title string `json:"title"`
	URL   string `json:"url,omitzero"`
}

type DevopsDatasource struct {
	ID   int64  `json:"id"`
	UID  string `json:"uid,omitzero"`
	Name string `json:"name"`
	Type string `json:"type,omitzero"`
}

type DevopsDozzleInfo struct {
	Healthy bool   `json:"healthy"`
	Version string `json:"version,omitzero"`
}

type DevopsGrafanaHealth struct {
	Database string `json:"database,omitzero"`
	Version  string `json:"version,omitzero"`
}

type DevopsGrafanaQueryField struct {
	Name   string `json:"name"`
	Type   string `json:"type,omitzero"`
	Values any    `json:"values,omitzero"`
}

type DevopsGrafanaQueryFrame struct {
	Name   string                    `json:"name,omitzero"`
	RefID  string                    `json:"ref_id,omitzero"`
	Fields []DevopsGrafanaQueryField `json:"fields,omitzero"`
}

type DevopsGrafanaQueryResult struct {
	Backend        string                    `json:"backend"`
	DatasourceUID  string                    `json:"datasource_uid"`
	DatasourceType string                    `json:"datasource_type"`
	Frames         []DevopsGrafanaQueryFrame `json:"frames,omitzero"`
}

type DevopsMetricFamily struct {
	Name  string `json:"name"`
	Help  string `json:"help,omitzero"`
	Count int    `json:"sample_count"`
}

type DevopsNetalertxDevice struct {
	Name   string `json:"name"`
	MAC    string `json:"mac,omitzero"`
	IP     string `json:"ip,omitzero"`
	Type   string `json:"type,omitzero"`
	Status string `json:"status,omitzero"`
	Vendor string `json:"vendor,omitzero"`
}

type DevopsNetalertxTotals struct {
	All       int `json:"all"`
	Connected int `json:"connected"`
	Favorites int `json:"favorites"`
	New       int `json:"new"`
	Down      int `json:"down"`
	Archived  int `json:"archived"`
}

type DevopsRouter struct {
	Name    string `json:"name"`
	Rule    string `json:"rule,omitzero"`
	Service string `json:"service,omitzero"`
	Status  string `json:"status,omitzero"`
}

type DevopsService struct {
	Name   string `json:"name"`
	Type   string `json:"type,omitzero"`
	Status string `json:"status,omitzero"`
}

type DevopsStatus struct {
	Backends map[string]bool `json:"backends"`
}

type DevopsSystem struct {
	ID     string `json:"id"`
	Name   string `json:"name"`
	Status string `json:"status,omitzero"`
	Host   string `json:"host,omitzero"`
}

type DevopsTraefikOverview struct {
	HTTPRouters  int `json:"http_routers"`
	HTTPServices int `json:"http_services"`
}

type DevopsWakapiProject struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type DevopsWakapiSummary struct {
	TotalSeconds int64 `json:"total_seconds"`
}

type Entry struct {
	ID          int64     `json:"id"`
	Title       string    `json:"title"`
	URL         string    `json:"url"`
	Content     string    `json:"content,omitzero"`
	Status      string    `json:"status"`
	Starred     bool      `json:"starred"`
	PublishedAt time.Time `json:"published_at"`
	FeedTitle   string    `json:"feed_title,omitzero"`
}

type EventEmitter func(ctx context.Context, result *InvokeResult)

type EventRef struct {
	EventID   string `json:"event_id"`
	EventType string `json:"event_type"`
	EntityID  string `json:"entity_id,omitzero"`
}

type EventSourceEmitter func(ctx context.Context, events []types.DataEvent) error

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

type EventStore interface {
	AppendDataEvent(ctx context.Context, event types.DataEvent) error
	AppendEventOutbox(ctx context.Context, event types.DataEvent) error
}

type ExampleListQuery struct {
	Page PageRequest
}

type Feed struct {
	ID       int64  `json:"id"`
	Title    string `json:"title"`
	FeedURL  string `json:"feed_url"`
	SiteURL  string `json:"site_url,omitzero"`
	Category string `json:"category,omitzero"`
}

type FinanceAbout struct {
	Version    string `json:"version"`
	APIVersion string `json:"api_version,omitzero"`
	PHPVersion string `json:"php_version,omitzero"`
	OS         string `json:"os,omitzero"`
	Driver     string `json:"driver,omitzero"`
}

type FinanceUser struct {
	ID    string `json:"id"`
	Email string `json:"email,omitzero"`
	Role  string `json:"role,omitzero"`
}

type ForgeCommitDiff struct {
	CommitID      string   `json:"commit_id"`
	CommitMessage string   `json:"commit_message"`
	Files         []string `json:"files"`
	DiffContent   string   `json:"diff_content"`
}

type ForgeIssue struct {
	ID      int64  `json:"id"`
	Index   int64  `json:"number"`
	Title   string `json:"title"`
	Body    string `json:"body,omitzero"`
	State   string `json:"state"`
	HTMLURL string `json:"html_url"`
	Author  string `json:"author,omitzero"`
}

type ForgeListIssuesQuery struct {
	Page  PageRequest
	State string
}

type ForgeRepo struct {
	ID          int64  `json:"id"`
	Name        string `json:"name"`
	FullName    string `json:"full_name"`
	Description string `json:"description,omitzero"`
	Private     bool   `json:"private"`
	HTMLURL     string `json:"html_url"`
	CloneURL    string `json:"clone_url,omitzero"`
	Owner       string `json:"owner"`
}

type ForgeUser struct {
	ID        int64  `json:"id"`
	UserName  string `json:"username"`
	Email     string `json:"email,omitzero"`
	AvatarURL string `json:"avatar_url,omitzero"`
}

type GithubListIssuesQuery struct {
	Page  PageRequest
	State string
}

type GithubPageQuery struct {
	Page PageRequest
}

type Host struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	Address string `json:"address,omitzero"`
	Status  string `json:"status"`
}

type InvokeResult struct {
	Capability hub.CapabilityType `json:"capability"`
	Operation  string             `json:"operation"`
	Data       any                `json:"data,omitzero"`
	Page       *PageInfo          `json:"page,omitzero"`
	Text       string             `json:"text,omitzero"`
	Meta       map[string]any     `json:"meta,omitzero"`
	Events     []EventRef         `json:"events,omitzero"`
	Resource   *ResourceMeta      `json:"_resource,omitempty"`
}

type Invoker func(ctx context.Context, params map[string]any) (*InvokeResult, error)

type KanbanCreateTaskRequest struct {
	Title       string
	Description string
	ProjectID   int
	ColumnID    int
	Tags        []string
	Reference   string
}

type KanbanMoveTaskRequest struct {
	ColumnID   int
	Position   int
	SwimlaneID int
	ProjectID  int
}

type KanbanSearchQuery struct {
	Page      PageRequest
	ProjectID int
	Q         string
}

type KanbanTaskQuery struct {
	Page      PageRequest
	ProjectID int
	ColumnID  int
	Status    string
}

type KanbanUpdateTaskRequest struct {
	Title       string
	Description string
}

type ListResult[T any] struct {
	Items []*T      `json:"items"`
	Page  *PageInfo `json:"page,omitzero"`
}

type Memo struct {
	Name       string    `json:"name"`
	State      string    `json:"state,omitzero"`
	Content    string    `json:"content,omitzero"`
	Visibility string    `json:"visibility,omitzero"`
	Tags       []string  `json:"tags,omitzero"`
	Pinned     bool      `json:"pinned"`
	Creator    string    `json:"creator,omitzero"`
	Snippet    string    `json:"snippet,omitzero"`
	CreateTime time.Time `json:"create_time,omitzero"`
	UpdateTime time.Time `json:"update_time,omitzero"`
}

type MemoListQuery struct {
	Page PageRequest
}

type NocoBase struct {
	ID    string `json:"id"`
	Title string `json:"title,omitzero"`
}

type NocoColumn struct {
	ID    string `json:"id"`
	Title string `json:"title,omitzero"`
	Type  string `json:"type,omitzero"`
}

type NocoRecord struct {
	ID     string         `json:"id"`
	Fields map[string]any `json:"fields,omitzero"`
}

type NocoTable struct {
	ID      string       `json:"id"`
	Title   string       `json:"title,omitzero"`
	BaseID  string       `json:"base_id,omitzero"`
	Columns []NocoColumn `json:"columns,omitzero"`
}

type Note struct {
	ID              string   `json:"id"`
	Title           string   `json:"title"`
	Type            string   `json:"type,omitzero"`
	Content         string   `json:"content,omitzero"`
	ParentNoteIDs   []string `json:"parent_note_ids,omitzero"`
	ChildNoteIDs    []string `json:"child_note_ids,omitzero"`
	IsProtected     bool     `json:"is_protected"`
	DateCreated     string   `json:"date_created,omitzero"`
	DateModified    string   `json:"date_modified,omitzero"`
	UtcDateCreated  string   `json:"utc_date_created,omitzero"`
	UtcDateModified string   `json:"utc_date_modified,omitzero"`
}

type NoteListQuery struct {
	Page  PageRequest
	Query string
}

type Notification struct {
	ID         string    `json:"id"`
	Reason     string    `json:"reason,omitzero"`
	Unread     bool      `json:"unread"`
	Subject    string    `json:"subject,omitzero"`
	RepoName   string    `json:"repo_name,omitzero"`
	UpdatedAt  time.Time `json:"updated_at"`
	LastReadAt time.Time `json:"last_read_at,omitzero"`
}

type OpDef struct {
	Name        string
	Description string
	Scopes      []string
	Mutation    bool
	Input       []hub.ParamDef
	Handler     Invoker
}

type PageInfo struct {
	Limit      int    `json:"limit"`
	HasMore    bool   `json:"has_more"`
	NextCursor string `json:"next_cursor,omitzero"`
	PrevCursor string `json:"prev_cursor,omitzero"`
	Total      *int64 `json:"total,omitzero"`
}

type PageRequest struct {
	Limit     int    `json:"limit,omitzero"`
	Cursor    string `json:"cursor,omitzero"`
	SortBy    string `json:"sort_by,omitzero"`
	SortOrder string `json:"sort_order,omitzero"`
}

type Persistence interface {
	LoadAll(ctx context.Context) (map[string]PollingEntry, error)
	Save(ctx context.Context, resourceName, cursor string, knownHashes map[string]string) error
}

type PollResult struct {
	Items      []any
	NextCursor string
	HasMore    bool
}

type PollingEntry struct {
	Cursor      string
	KnownHashes map[string]string
	UpdatedAt   time.Time
}

type PollingResource interface {
	// ResourceName returns a unique name for the polled resource type.
	ResourceName() string
	// DefaultInterval returns the recommended polling interval for this resource.
	DefaultInterval() time.Duration
	// DiffKey returns a unique key from an item used to detect changes between polls.
	DiffKey(item any) string
	// ContentHash returns a hash of the item content for change detection.
	ContentHash(item any) string
	// CursorField returns the field name used for cursor-based pagination.
	CursorField() string
	// List fetches a batch of items from the provider starting after cursor.
	List(ctx context.Context, cursor string) (PollResult, error)
}

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

type ReaderEntryQuery struct {
	Page   PageRequest
	Status string
	FeedID int64
}

type ReaderFeedQuery struct {
	Page PageRequest
}

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

type Release struct {
	ID          int64     `json:"id"`
	TagName     string    `json:"tag_name"`
	Name        string    `json:"name,omitzero"`
	Body        string    `json:"body,omitzero"`
	Draft       bool      `json:"draft"`
	Prerelease  bool      `json:"prerelease"`
	HTMLURL     string    `json:"html_url,omitzero"`
	PublishedAt time.Time `json:"published_at,omitzero"`
}

type ResourceMeta struct {
	EventID  string `json:"event_id"`
	EntityID string `json:"entity_id"`
	App      string `json:"app"`
}

type Spec struct {
	Type        hub.CapabilityType
	App         string
	Description string
	Events      []hub.EventDef
	Instance    any
	Ops         []OpDef
}

type Task struct {
	ID          int      `json:"id"`
	Title       string   `json:"title"`
	Description string   `json:"description,omitzero"`
	ProjectID   int      `json:"project_id"`
	ColumnID    int      `json:"column_id"`
	Tags        []string `json:"tags,omitzero"`
	Reference   string   `json:"reference,omitzero"`
}

type Torrent struct {
	ID           int64   `json:"id"`
	Name         string  `json:"name,omitzero"`
	Status       string  `json:"status,omitzero"`
	PercentDone  float64 `json:"percent_done,omitzero"`
	RateDownload int64   `json:"rate_download,omitzero"`
	RateUpload   int64   `json:"rate_upload,omitzero"`
	DownloadDir  string  `json:"download_dir,omitzero"`
	HashString   string  `json:"hash_string,omitzero"`
	ErrorString  string  `json:"error_string,omitzero"`
}

type Transaction struct {
	ID              string `json:"id"`
	Type            string `json:"type,omitzero"`
	Amount          string `json:"amount,omitzero"`
	Description     string `json:"description,omitzero"`
	Date            string `json:"date,omitzero"`
	CurrencyCode    string `json:"currency_code,omitzero"`
	SourceName      string `json:"source_name,omitzero"`
	DestinationName string `json:"destination_name,omitzero"`
	CategoryName    string `json:"category_name,omitzero"`
	Notes           string `json:"notes,omitzero"`
}

type WebhookConverter interface {
	// WebhookPath returns the URL path that the webhook endpoint listens on.
	WebhookPath() string
	// VerifySignature validates the incoming webhook payload against the provider's signing scheme.
	VerifySignature(headers map[string]string, body []byte) error
	// Convert transforms a raw webhook payload into one or more DataEvent records.
	Convert(body []byte, headers map[string]string) ([]types.DataEvent, error)
}