service

type EntityCreationOptions struct {
	// Parent entity ID (for originated entities like artifacts, releases)
	OriginatingEntityID *uuid.UUID

	// Whether to register with provider (e.g., create webhooks)
	RegisterWithProvider bool

	// Whether to publish reconciliation events
	PublishReconciliationEvent bool
}

type EntityCreator interface {
	// CreateEntity creates an entity of any type
	CreateEntity(
		ctx context.Context,
		provider *db.Provider,
		projectID uuid.UUID,
		entityType pb.Entity,
		identifyingProps *properties.Properties,
		opts *EntityCreationOptions,
	) (*models.EntityWithProperties, error)
}

type EntityService interface {
	// ListEntities retrieves all entities for the specific project and provider
	ListEntities(
		ctx context.Context,
		projectID uuid.UUID,
		providerID uuid.UUID,
		entityType pb.Entity,
		cursor string,
		limit int64,
	) ([]*pb.EntityInstance, string, error)

	// GetEntityByID retrieves an entity by its ID
	GetEntityByID(
		ctx context.Context,
		entityID uuid.UUID,
		projectID uuid.UUID,
	) (*pb.EntityInstance, error)

	// GetEntityByName retrieves an entity by its name
	GetEntityByName(
		ctx context.Context,
		name string,
		projectID uuid.UUID,
		providerID uuid.UUID,
		entityType pb.Entity,
	) (*pb.EntityInstance, error)

	// DeleteEntityByID deletes an entity by its ID
	DeleteEntityByID(
		ctx context.Context,
		entityID uuid.UUID,
		projectID uuid.UUID,
	) error
}