productcatalog

type CreateFeatureInputs struct {
	Name                string            `json:"name"`
	Key                 string            `json:"key"`
	Namespace           string            `json:"namespace"`
	MeterSlug           string            `json:"meterSlug"`
	MeterGroupByFilters map[string]string `json:"meterGroupByFilters"`
}

type Feature struct {
	Namespace string `json:"-"`
	ID        string `json:"id,omitempty"`

	// Name The name of the feature.
	Name string `json:"name"`
	// Key The unique key of the feature.
	Key string `json:"key"`

	// MeterSlug The meter that the feature is associated with and decreases grants by usage.
	MeterSlug string `json:"meterSlug,omitempty"`

	// MeterGroupByFilters Optional meter group by filters. Useful if the meter scope is broader than what feature tracks.
	MeterGroupByFilters *map[string]string `json:"meterGroupByFilters,omitempty"`

	// Read-only fields
	ArchivedAt *time.Time `json:"archivedAt,omitempty"`

	CreatedAt time.Time `json:"createdAt,omitempty"`
	UpdatedAt time.Time `json:"updatedAt,omitempty"`
}

type FeatureConnector interface {
	// Feature Management
	CreateFeature(ctx context.Context, feature CreateFeatureInputs) (Feature, error)
	// Should just use deletedAt, there's no real "archiving"
	ArchiveFeature(ctx context.Context, featureID models.NamespacedID) error
	ListFeatures(ctx context.Context, params ListFeaturesParams) ([]Feature, error)
	GetFeature(ctx context.Context, featureID models.NamespacedID) (Feature, error)
}

type FeatureInvalidFiltersError struct {
	RequestedFilters    map[string]string
	MeterGroupByColumns []string
}

type FeatureInvalidMeterAggregationError struct {
	MeterSlug         string
	Aggregation       models.MeterAggregation
	ValidAggregations []models.MeterAggregation
}

type FeatureNotFoundError struct {
	ID string
}

type FeatureOrderBy string

type FeatureRepo interface {
	CreateFeature(ctx context.Context, feature FeatureRepoCreateFeatureInputs) (Feature, error)
	ArchiveFeature(ctx context.Context, featureID models.NamespacedID) error
	ListFeatures(ctx context.Context, params ListFeaturesParams) ([]Feature, error)
	FindByKey(ctx context.Context, namespace string, key string, includeArchived bool) (*Feature, error)
	GetByID(ctx context.Context, featureID models.NamespacedID) (Feature, error)

	entutils.TxCreator
	entutils.TxUser[FeatureRepo]
}

type FeatureRepoCreateFeatureInputs struct {
	Name                string
	Key                 string
	Namespace           string
	MeterSlug           string
	MeterGroupByFilters map[string]string
}

type FeatureWithNameAlreadyExistsError struct {
	Name string
	ID   string
}

type ListFeaturesParams struct {
	Namespace       string
	IncludeArchived bool
	Offset          int
	Limit           int
	OrderBy         FeatureOrderBy
}