repository

type AnnoGroupListNotFoundError struct{}

type AnnoListNotFoundError struct{}

type AnnoNotFoundError struct {
	ID string
}

type AnnoTagNotFoundError struct {
	Tag string
}

type FeatureAnnotationRepository interface {
	// GetFeatureAnnotation retrieves a feature annotation by ID
	GetFeatureAnnotation(id string) (*model.FeatureAnnotationDoc, error)
	// GetFeatureAnnotationByName retrieves a feature annotation by name
	GetFeatureAnnotationByName(name string) (*model.FeatureAnnotationDoc, error)
	// AddFeatureAnnotation creates a new feature annotation
	AddFeatureAnnotation(
		doc *feature.NewFeatureAnnotation,
	) (*model.FeatureAnnotationDoc, error)
	// EditFeatureAnnotation updates an existing feature annotation
	EditFeatureAnnotation(
		doc *feature.FeatureAnnotationUpdate,
	) (*model.FeatureAnnotationDoc, error)
	// RemoveFeatureAnnotation deletes a feature annotation
	RemoveFeatureAnnotation(id string, purge bool) error
	// ClearFeatureAnnotations removes all feature annotations
	ClearFeatureAnnotations() error
	// Dbh returns the underlying database handler
	Dbh() *manager.Database
	// Tag management methods
	// AddTag adds a single tag to an existing feature annotation
	AddTag(req *feature.AddTagRequest) (*model.FeatureAnnotationDoc, error)
	// AddTags adds multiple tags to an existing feature annotation
	AddTags(req *feature.AddTagsRequest) (*model.FeatureAnnotationDoc, error)
	// SetTags replaces all tags for a feature annotation with the provided set
	SetTags(req *feature.SetTagsRequest) (*model.FeatureAnnotationDoc, error)
	// RemoveTags removes tags from a feature annotation by tag and value
	RemoveTags(req *feature.RemoveTagsRequest) (*model.FeatureAnnotationDoc, error)

	// Publication-based queries
	// ListByPublicationID retrieves all feature annotations associated with the given publication ID and source
	ListByPublicationID(id string, source string) ([]*model.FeatureAnnotationDoc, error)
}

type FeatureNameNotFoundError struct {
	Name string
}

type GroupNotFoundError struct {
	ID string
}

type ListAnnotationsParams struct {
	Cursor int64
	Limit  int64  `validate:"required"`
	Filter string `validate:"required"`
}

type ListNotFoundError struct{}

type OrganismNotFoundError struct {
	ID string
}

type OrganismRepository interface {
	// GetOrganism retrieves an organism by ID
	GetOrganism(id string) (*model.OrganismDoc, error)
	// GetOrganismByName retrieves an organism by scientific name (genus + species)
	GetOrganismByName(genus, species string) (*model.OrganismDoc, error)
	// AddOrganism creates a new organism
	AddOrganism(doc *organism.NewOrganism) (*model.OrganismDoc, error)
	// EditOrganism updates an existing organism
	EditOrganism(doc *organism.OrganismUpdate) (*model.OrganismDoc, error)
	// RemoveOrganism deletes an organism
	RemoveOrganism(id string) error
	// ListOrganisms provides a paginated list of organisms along with optional filtering
	ListOrganisms() ([]*model.OrganismDoc, error)
	// ClearOrganisms removes all organisms
	ClearOrganisms() error
	// Dbh returns the underlying database handler
	Dbh() *manager.Database
}

type PublicationAnnotationNotFoundError struct {
	ID     string
	Source string
}

type TaggedAnnotationRepository interface {
	// GetAnnotationById retrieves an annotation
	GetAnnotationByID(id string) (*model.AnnoDoc, error)
	GetAnnotationByEntry(
		req *annotation.EntryAnnotationRequest,
	) (*model.AnnoDoc, error)
	AddAnnotation(na *annotation.NewTaggedAnnotation) (*model.AnnoDoc, error)
	EditAnnotation(
		ua *annotation.TaggedAnnotationUpdate,
	) (*model.AnnoDoc, error)
	RemoveAnnotation(id string, purge bool) error
	// ListAnnotationGroup provides a paginated list of annotation along
	// with optional filtering
	ListAnnotations(*ListAnnotationsParams) ([]*model.AnnoDoc, error)
	ClearAnnotations() error
	Clear() error
	// AddAnnotationGroup creates a new annotation group
	AddAnnotationGroup(idslice ...string) (*model.AnnoGroup, error)
	// GetAnnotationGroup retrieves an annotation group
	GetAnnotationGroup(groupID string) (*model.AnnoGroup, error)
	// AppendToAnnotationGroup adds new annotations to an existing group
	AppendToAnnotationGroup(
		groupID string,
		idslice ...string,
	) (*model.AnnoGroup, error)
	// DeleteAnnotationGroup deletes an annotation group
	RemoveAnnotationGroup(groupID string) error
	// RemoveFromAnnotationGroup remove annotations from an existing group
	RemoveFromAnnotationGroup(
		groupID string,
		idslice ...string,
	) (*model.AnnoGroup, error)
	// ListAnnotationGroup provides a paginated list of annotation groups along
	// with optional filtering
	ListAnnotationGroup(
		cursor, limit int64,
		filter string,
	) ([]*model.AnnoGroup, error)
	// GetAnnotationTag retrieves tag information
	GetAnnotationTag(name, ontology string) (*model.AnnoTag, error)
	Dbh() *manager.Database
	LoadOboJSON(r io.Reader) (*storage.UploadInformation, error)
}