ingitdb

type ChangeKind string

type ChangedFile struct {
	Kind    ChangeKind
	Path    string // repo-relative path
	OldPath string // set only for ChangeKindRenamed
}

type CollectionDef struct {
	ID           string                `json:"-"` // Taken from dir name
	DirPath      string                `yaml:"-" json:"-"`
	Titles       map[string]string     `yaml:"titles,omitempty"`
	RecordFile   *RecordFileDef        `yaml:"record_file"`
	DataDir      string                `yaml:"data_dir,omitempty"`
	Columns      map[string]*ColumnDef `yaml:"columns"`
	ColumnsOrder []string              `yaml:"columns_order,omitempty"`
	DefaultView  string                `yaml:"default_view,omitempty"`
	// SubCollections are not part of the collection definition file,
	// they are stored in the "subcollections" subdirectory as directories,
	// each containing their own .collection/definition.yaml.
	SubCollections map[string]*CollectionDef `yaml:"-" json:"-"`
	// Views are not part of the collection definition file,
	// they are stored in the "views" subdirectory.
	Views map[string]*ViewDef `yaml:"-" json:"-"`

	Readme *CollectionReadmeDef `yaml:"readme,omitempty" json:"readme,omitempty"`
}

type CollectionReadmeDef struct {
	HideColumns        bool     `yaml:"hide_columns,omitempty" json:"hide_columns,omitempty"`
	HideSubcollections bool     `yaml:"hide_subcollections,omitempty" json:"hide_subcollections,omitempty"`
	HideViews          bool     `yaml:"hide_views,omitempty" json:"hide_views,omitempty"`
	HideTriggers       bool     `yaml:"hide_triggers,omitempty" json:"hide_triggers,omitempty"`
	DataPreview        *ViewDef `yaml:"data_preview,omitempty" json:"data_preview,omitempty"`
}

type CollectionsReader interface {
	ReadDefinition(dbPath string, opts ...ReadOption) (*Definition, error)
}

type ColumnDef struct {
	Type       ColumnType        `yaml:"type"`
	Title      string            `yaml:"title,omitempty"`
	Titles     map[string]string `yaml:"titles,omitempty"`
	ValueTitle string            `yaml:"valueTitle,omitempty"`
	Required   bool              `yaml:"required,omitempty"`
	Length     int               `yaml:"length,omitempty"`
	MinLength  int               `yaml:"min_length,omitempty"`
	MaxLength  int               `yaml:"max_length,omitempty"`
	ForeignKey string            `yaml:"foreign_key,omitempty"`
	// Locale pairs this column with a map[locale]string column named <this_column_name>+"s".
	// For example, column "title" with locale "en" is paired with column "titles".
	// When reading, the locale value is extracted from the pair column and exposed as this column.
	// When writing, this column is stored as-is in the file; if the pair column contains an entry
	// for the primary locale key, that entry is promoted here and removed from the pair column.
	Locale string `yaml:"locale,omitempty"`
}

type ColumnDefWithID struct {
	ID string `yaml:"id"`
	ColumnDef
}

type ColumnType string

type Definition struct {
	Collections map[string]*CollectionDef `yaml:"collections,omitempty"`
	Subscribers map[string]*SubscriberDef `yaml:"subscribers,omitempty"`
}

type DiscordDef struct {
	HandlerBase `yaml:",inline"`
	WebhookURL  string `yaml:"webhook_url"`
}

type EmailDef struct {
	HandlerBase `yaml:",inline"`
	From        string   `yaml:"from,omitempty"`
	To          []string `yaml:"to"`
	SMTP        string   `yaml:"smtp"`
	Port        int      `yaml:"port,omitempty"`
	User        string   `yaml:"user,omitempty"`
	Pass        string   `yaml:"pass,omitempty"`
	Subject     string   `yaml:"subject,omitempty"`
}

type GitHubActionDef struct {
	HandlerBase `yaml:",inline"`
	Owner       string `yaml:"owner"`
	Repo        string `yaml:"repo"`
	Workflow    string `yaml:"workflow"`
	Ref         string `yaml:"ref"`
	Token       string `yaml:"token"`
}

type GitLabCIDef struct {
	HandlerBase `yaml:",inline"`
	ProjectID   string `yaml:"project_id"`
	Ref         string `yaml:"ref"`
	Token       string `yaml:"token"`
	Host        string `yaml:"host,omitempty"`
}

type HandlerBase struct {
	Name string `yaml:"name,omitempty"`
}

type MaterializeResult struct {
	FilesWritten   int
	FilesUnchanged int
	Errors         []error
}

type NtfyDef struct {
	HandlerBase `yaml:",inline"`
	Topic       string `yaml:"topic"`
	Server      string `yaml:"server,omitempty"`
}

type ProgressEvent struct {
	Kind     ProgressKind
	TaskName string           // "validate" or "materialize"
	Scope    string           // collection or view ID
	ItemKey  string           // record key or output file name
	Done     int              // items completed so far
	Total    int              // total items; 0 = unknown
	Err      *ValidationError // non-nil only for ProgressKindError
}

type ProgressKind string

type RSSDef struct {
	HandlerBase `yaml:",inline"`
	Output      string `yaml:"output"`
	Title       string `yaml:"title"`
	Link        string `yaml:"link"`
	Format      string `yaml:"format,omitempty"`
}

type ReadOption func(*ReadOptions)

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

type RecordEntry struct {
	Key      string // may be empty for list-type files
	FilePath string // absolute path
	Data     map[string]any
}

type RecordFileDef struct {
	Name   string       `yaml:"name"`
	Format RecordFormat `yaml:"format"`

	// RecordType can have next values:
	// "map[string]any" - each record in a separate file
	// "[]map[string]any" - list of records
	// "map[string]map[string]any" - dictionary of records
	// "map[id]map[field]any" - all records in one file; top-level keys are record IDs, second level is field names
	RecordType RecordType `yaml:"type"`
}

type RecordFormat string

type RecordType string

type RecordsReader interface {
	ReadRecords(
		ctx context.Context,
		dbPath string,
		col *CollectionDef,
		yield func(RecordEntry) error,
	) error
}

type SMSDef struct {
	HandlerBase `yaml:",inline"`
	Provider    string `yaml:"provider"`
	From        string `yaml:"from"`
	To          string `yaml:"to"`
	AccountSID  string `yaml:"account_sid,omitempty"`
	AuthToken   string `yaml:"auth_token"`
	APIKey      string `yaml:"api_key,omitempty"`
}

type Scanner interface {
	// Scan walks dbPath, validates all records, and rebuilds all views.
	Scan(ctx context.Context, dbPath string, def *Definition) error
}

type SearchIndexDef struct {
	HandlerBase `yaml:",inline"`
	Provider    string `yaml:"provider"`
	Index       string `yaml:"index"`
	AppID       string `yaml:"app_id,omitempty"`
	APIKey      string `yaml:"api_key"`
	Host        string `yaml:"host,omitempty"`
}

type Severity string

type SlackDef struct {
	HandlerBase `yaml:",inline"`
	WebhookURL  string `yaml:"webhook_url"`
}

type SubscriberDef struct {
	HandlerBase   `yaml:",inline"`
	For           *SubscriberFor    `yaml:"for"`
	Webhooks      []WebhookDef      `yaml:"webhooks,omitempty"`
	Emails        []EmailDef        `yaml:"emails,omitempty"`
	Telegrams     []TelegramDef     `yaml:"telegrams,omitempty"`
	WhatsApp      []WhatsAppDef     `yaml:"whatsapp,omitempty"`
	Slacks        []SlackDef        `yaml:"slacks,omitempty"`
	Discords      []DiscordDef      `yaml:"discords,omitempty"`
	GitHubActions []GitHubActionDef `yaml:"github_actions,omitempty"`
	GitLabCI      []GitLabCIDef     `yaml:"gitlab_ci,omitempty"`
	Ntfy          []NtfyDef         `yaml:"ntfy,omitempty"`
	SMS           []SMSDef          `yaml:"sms,omitempty"`
	SearchIndexes []SearchIndexDef  `yaml:"search_indexes,omitempty"`
	RSS           []RSSDef          `yaml:"rss,omitempty"`
}

type SubscriberFor struct {
	Paths  []string           `yaml:"paths,omitempty"`
	Events []TriggerEventType `yaml:"events,omitempty"`
}

type TelegramDef struct {
	HandlerBase `yaml:",inline"`
	Token       string `yaml:"token"`
	ChatID      string `yaml:"chat_id"`
}

type TriggerDef struct {
	On   []TriggerEventType        `yaml:"on"`
	Jobs map[string]*TriggerJobDef `yaml:"jobs"`
}

type TriggerEventType string

type TriggerJobDef struct {
	RunsOn string           `yaml:"runs-on"`
	Steps  []TriggerStepDef `yaml:"steps"`
}

type TriggerStepDef struct {
	Run string `yaml:"run"`
}

type ValidationError struct {
	Severity     Severity
	CollectionID string // e.g. "todo.tasks"
	FilePath     string // absolute path to offending file
	RecordKey    string // empty for list/map files where key is unknown
	FieldName    string // set for field-level errors
	Message      string
	Err          error // wrapped cause
}

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

type ViewDef struct {
	ID      string            `yaml:"-"`
	Titles  map[string]string `yaml:"titles,omitempty"`
	OrderBy string            `yaml:"order_by,omitempty"`

	// Formats TODO: Needs definition
	Formats []string `yaml:"formats,omitempty"`

	Columns []string `yaml:"columns,omitempty"`

	// How many records to include; 0 means all
	Top int `yaml:"top,omitempty"`

	// Where holds filtering condition
	Where string `yaml:"where,omitempty"`

	// Template path relative to the collection directory.
	/*
		Build in templates:
		  - md-table - renders a Markdown table
		  - md-list - renders a Markdown list
		  - JSON - renders JSON
		  - YAML - renders YAML
	*/
	Template string `yaml:"template,omitempty"`

	// Output file name relative to the collection directory.
	FileName string `yaml:"file_name,omitempty"`

	// RecordsVarName provides a custom Template variable name for the records slice. The default is "records".
	RecordsVarName string `yaml:"records_var_name,omitempty"`
}

type WebhookDef struct {
	HandlerBase `yaml:",inline"`
	URL         string            `yaml:"url"`
	Method      string            `yaml:"method,omitempty"`
	Headers     map[string]string `yaml:"headers,omitempty"`
}

type WhatsAppDef struct {
	HandlerBase `yaml:",inline"`
	From        string `yaml:"from"`
	To          string `yaml:"to"`
	AccountSID  string `yaml:"account_sid"`
	AuthToken   string `yaml:"auth_token"`
}