/* Real-time Online/Offline Charging System (OCS) for Telecom & ISP environments Copyright (C) ITsysCOM GmbH This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see */ package engine import ( "fmt" "net" "reflect" "regexp" "strconv" "strings" "time" "github.com/cgrates/birpc/context" "github.com/cgrates/cgrates/config" "github.com/cgrates/cgrates/utils" "github.com/cgrates/cron" ) // NewFilterS initializtes the filter service func NewFilterS(cfg *config.CGRConfig, connMgr *ConnManager, dm *DataManager) (fS *FilterS) { fS = &FilterS{ dm: dm, cfg: cfg, connMgr: connMgr, } return } // FilterS is a service used to take decisions in case of filters // uses lazy connections where necessary to avoid deadlocks on service startup type FilterS struct { cfg *config.CGRConfig dm *DataManager connMgr *ConnManager } // Pass will check all filters wihin filterIDs and require them passing for dataProvider // there should be at least one filter passing, ie: if filters are not active event will fail to pass // receives the event as DataProvider so we can accept undecoded data (ie: HttpRequest) func (fS *FilterS) Pass(ctx *context.Context, tenant string, filterIDs []string, ev utils.DataProvider) (pass bool, err error) { if len(filterIDs) == 0 { return true, nil } dDP := newDynamicDP(ctx, fS.cfg.FilterSCfg().ResourceSConns, fS.cfg.FilterSCfg().StatSConns, fS.cfg.FilterSCfg().AccountSConns, tenant, ev) for _, fltrID := range filterIDs { f, err := fS.dm.GetFilter(ctx, tenant, fltrID, true, true, utils.NonTransactional) if err != nil { if err == utils.ErrNotFound { err = utils.ErrPrefixNotFound(fltrID) } return false, err } for _, fltr := range f.Rules { if pass, err = fltr.Pass(ctx, dDP); err != nil || !pass { return pass, err } } pass = true } return } // checkPrefix verify if the value has as prefix one of the prefixes func checkPrefix(value string, prefixes []string) (hasPrefix bool) { for _, prefix := range prefixes { if strings.HasPrefix(value, prefix) { hasPrefix = true break } } if !hasPrefix { return false } return } // verifyPrefixes verify the Element and the Values from FilterRule if has as prefix one of the prefixes func verifyPrefixes(rule *FilterRule, prefixes []string) (hasPrefix bool) { if strings.HasPrefix(rule.Element, utils.DynamicDataPrefix) { if hasPrefix = checkPrefix(rule.Element, prefixes); !hasPrefix { return } } for _, value := range rule.Values { hasPrefix = false // reset hasPrefix if strings.HasPrefix(value, utils.DynamicDataPrefix) { if hasPrefix = checkPrefix(value, prefixes); !hasPrefix { return } } } return true } // LazyPass is almost the same as Pass except that it verify if the // Element of the Values from FilterRules has as prefix one of the pathPrfxs func (fS *FilterS) LazyPass(ctx *context.Context, tenant string, filterIDs []string, ev utils.DataProvider, pathPrfxs []string) (pass bool, lazyCheckRules []*FilterRule, err error) { if len(filterIDs) == 0 { return true, nil, nil } pass = true dDP := newDynamicDP(ctx, fS.cfg.FilterSCfg().ResourceSConns, fS.cfg.FilterSCfg().StatSConns, fS.cfg.FilterSCfg().AccountSConns, tenant, ev) for _, fltrID := range filterIDs { var f *Filter f, err = fS.dm.GetFilter(ctx, tenant, fltrID, true, true, utils.NonTransactional) if err != nil { if err == utils.ErrNotFound { err = utils.ErrPrefixNotFound(fltrID) } return } for _, rule := range f.Rules { if !verifyPrefixes(rule, pathPrfxs) { lazyCheckRules = append(lazyCheckRules, rule) continue } if pass, err = rule.Pass(ctx, dDP); err != nil || !pass { return } } } return } func splitDynFltrValues(val, sep string) (vals []string) { startIdx := strings.IndexByte(val, utils.RSRDynStartChar) endIdx := strings.IndexByte(val, utils.RSRDynEndChar) if startIdx == -1 || endIdx == -1 { return strings.Split(val, sep) } vals = strings.Split(val[:startIdx], sep) vals[len(vals)-1] += val[startIdx : endIdx+1] val = val[endIdx+1:] if len(val) == 0 { return } valsEnd := splitDynFltrValues(val, sep) vals[len(vals)-1] += valsEnd[0] return append(vals, valsEnd[1:]...) } // NewFilterFromInline parses an inline rule into a compiled Filter func NewFilterFromInline(tenant, inlnRule string) (f *Filter, err error) { ruleSplt := utils.SplitPath(inlnRule, utils.InInFieldSep[0], 3) if len(ruleSplt) != 3 { return nil, fmt.Errorf("inline parse error for string: <%s>", inlnRule) } var vals []string if ruleSplt[2] != utils.EmptyString { vals = splitDynFltrValues(ruleSplt[2], utils.PipeSep) } f = &Filter{ Tenant: tenant, ID: inlnRule, Rules: []*FilterRule{{ Type: ruleSplt[0], Element: ruleSplt[1], Values: vals, }}, } if err = f.Compile(); err != nil { return nil, err } return } type ArgsFiltersMatch struct { *utils.CGREvent FilterIDs []string } // Filter structure to define a basic filter type Filter struct { Tenant string ID string Rules []*FilterRule } // FilterWithOpts the arguments for the replication type FilterWithAPIOpts struct { *Filter APIOpts map[string]interface{} } // TenantID returns the tenant wit the ID func (fltr *Filter) TenantID() string { return utils.ConcatenatedKey(fltr.Tenant, fltr.ID) } // Compile will compile the underlaying request filters where necessary (ie. regexp rules) func (fltr *Filter) Compile() (err error) { for _, rf := range fltr.Rules { if err = rf.CompileValues(); err != nil { return } } return } var supportedFiltersType utils.StringSet = utils.NewStringSet([]string{ utils.MetaString, utils.MetaPrefix, utils.MetaSuffix, utils.MetaCronExp, utils.MetaRSR, utils.MetaEmpty, utils.MetaExists, utils.MetaLessThan, utils.MetaLessOrEqual, utils.MetaGreaterThan, utils.MetaGreaterOrEqual, utils.MetaEqual, utils.MetaIPNet, utils.MetaAPIBan, utils.MetaActivationInterval, utils.MetaRegex, utils.MetaNever}) var needsFieldName utils.StringSet = utils.NewStringSet([]string{ utils.MetaString, utils.MetaPrefix, utils.MetaSuffix, utils.MetaCronExp, utils.MetaRSR, utils.MetaLessThan, utils.MetaEmpty, utils.MetaExists, utils.MetaLessOrEqual, utils.MetaGreaterThan, utils.MetaGreaterOrEqual, utils.MetaEqual, utils.MetaIPNet, utils.MetaAPIBan, utils.MetaActivationInterval, utils.MetaRegex}) var needsValues utils.StringSet = utils.NewStringSet([]string{ utils.MetaString, utils.MetaPrefix, utils.MetaSuffix, utils.MetaCronExp, utils.MetaRSR, utils.MetaLessThan, utils.MetaLessOrEqual, utils.MetaGreaterThan, utils.MetaGreaterOrEqual, utils.MetaEqual, utils.MetaIPNet, utils.MetaAPIBan, utils.MetaActivationInterval, utils.MetaRegex}) // NewFilterRule returns a new filter func NewFilterRule(rfType, fieldName string, vals []string) (*FilterRule, error) { var negative bool rType := rfType if strings.HasPrefix(rfType, utils.MetaNot) { rType = utils.Meta + strings.TrimPrefix(rfType, utils.MetaNot) negative = true } if !supportedFiltersType.Has(rType) { return nil, fmt.Errorf("Unsupported filter Type: %s", rfType) } if fieldName == "" && needsFieldName.Has(rType) { return nil, fmt.Errorf("Element is mandatory for Type: %s", rfType) } if len(vals) == 0 && needsValues.Has(rType) { return nil, fmt.Errorf("Values is mandatory for Type: %s", rfType) } rf := &FilterRule{ Type: rfType, Element: fieldName, Values: vals, negative: utils.BoolPointer(negative), } if err := rf.CompileValues(); err != nil { return nil, err } return rf, nil } // FilterRule filters requests coming into various places // Pass rule: default negative, one matching rule should pass the filter type FilterRule struct { Type string // Filter type (*string, *timing, *rsr_filters, *stats, *lt, *lte, *gt, *gte) Element string // Name of the field providing us the Values to check (used in case of some ) Values []string // Filter definition rsrValues config.RSRParsers // Cache here the rsrElement *config.RSRParser // Cache here the rsrFilters utils.RSRFilters // Cache here the RSRFilter Values regexValues []*regexp.Regexp negative *bool } // IsValid checks whether a filter rule is valid or not func (fltr *FilterRule) IsValid() bool { // Type must be specified if fltr.Type == utils.EmptyString { return false } // Element must be specified only when the type is different from *never if fltr.Element == utils.EmptyString { return fltr.Type == utils.MetaNever } if len(fltr.Values) == 0 && !utils.IsSliceMember([]string{utils.MetaExists, utils.MetaNotExists, utils.MetaEmpty, utils.MetaNotEmpty}, fltr.Type) { return false } return true } // CompileValues compiles RSR fields func (fltr *FilterRule) CompileValues() (err error) { switch fltr.Type { case utils.MetaRegex, utils.MetaNotRegex: fltr.regexValues = make([]*regexp.Regexp, len(fltr.Values)) for i, val := range fltr.Values { if fltr.regexValues[i], err = regexp.Compile(val); err != nil { return } } case utils.MetaRSR, utils.MetaNotRSR: if fltr.rsrFilters, err = utils.ParseRSRFiltersFromSlice(fltr.Values); err != nil { return } case utils.MetaExists, utils.MetaNotExists, utils.MetaEmpty, utils.MetaNotEmpty: // only the element is built case utils.MetaActivationInterval, utils.MetaNotActivationInterval: fltr.rsrValues = make(config.RSRParsers, len(fltr.Values)) for i, strVal := range fltr.Values { if fltr.rsrValues[i], err = config.NewRSRParser(strVal); err != nil { return } } case utils.MetaNever: //return since there is not need for the values to be compiled in this case return default: if fltr.rsrValues, err = config.NewRSRParsersFromSlice(fltr.Values); err != nil { return } } if fltr.rsrElement, err = config.NewRSRParser(fltr.Element); err != nil { return } else if fltr.rsrElement == nil { return fmt.Errorf("empty RSRParser in rule: <%s>", fltr.Element) } return } // Pass is the method which should be used from outside. func (fltr *FilterRule) Pass(ctx *context.Context, dDP utils.DataProvider) (result bool, err error) { if fltr.negative == nil { fltr.negative = utils.BoolPointer(strings.HasPrefix(fltr.Type, utils.MetaNot)) } switch fltr.Type { case utils.MetaString, utils.MetaNotString: result, err = fltr.passString(dDP) case utils.MetaEmpty, utils.MetaNotEmpty: result, err = fltr.passEmpty(dDP) case utils.MetaExists, utils.MetaNotExists: result, err = fltr.passExists(dDP) case utils.MetaPrefix, utils.MetaNotPrefix: result, err = fltr.passStringPrefix(dDP) case utils.MetaSuffix, utils.MetaNotSuffix: result, err = fltr.passStringSuffix(dDP) case utils.MetaCronExp, utils.MetaNotCronExp: result, err = fltr.passCronExp(ctx, dDP) case utils.MetaRSR, utils.MetaNotRSR: result, err = fltr.passRSR(dDP) case utils.MetaLessThan, utils.MetaLessOrEqual, utils.MetaGreaterThan, utils.MetaGreaterOrEqual: result, err = fltr.passGreaterThan(dDP) case utils.MetaEqual, utils.MetaNotEqual: result, err = fltr.passEqualTo(dDP) case utils.MetaIPNet, utils.MetaNotIPNet: result, err = fltr.passIPNet(dDP) case utils.MetaAPIBan, utils.MetaNotAPIBan: result, err = fltr.passAPIBan(ctx, dDP) case utils.MetaActivationInterval, utils.MetaNotActivationInterval: result, err = fltr.passActivationInterval(dDP) case utils.MetaRegex, utils.MetaNotRegex: result, err = fltr.passRegex(dDP) case utils.MetaNever: result, err = fltr.passNever(dDP) default: err = utils.ErrPrefixNotErrNotImplemented(fltr.Type) } if err != nil { return false, err } return result != *(fltr.negative), nil } func (fltr *FilterRule) passString(dDP utils.DataProvider) (bool, error) { strVal, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } for _, val := range fltr.rsrValues { sval, err := val.ParseDataProvider(dDP) if err != nil { continue } if strVal == sval { return true, nil } } return false, nil } func (fltr *FilterRule) passExists(dDP utils.DataProvider) (bool, error) { path, err := fltr.rsrElement.CompileDynRule(dDP) if err != nil { return false, err } if _, err := utils.DPDynamicInterface(path, dDP); err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } return true, nil } func (fltr *FilterRule) passEmpty(dDP utils.DataProvider) (bool, error) { path, err := fltr.rsrElement.CompileDynRule(dDP) if err != nil { return false, err } val, err := utils.DPDynamicInterface(path, dDP) if err != nil { if err == utils.ErrNotFound { return true, nil } return false, err } if val == nil { return true, nil } rval := reflect.ValueOf(val) if rval.Type().Kind() == reflect.Ptr { if rval.IsNil() { return true, nil } rval = rval.Elem() } switch rval.Type().Kind() { case reflect.Slice: return rval.Len() == 0, nil case reflect.Map: return len(rval.MapKeys()) == 0, nil default: return rval.IsZero(), nil } } func (fltr *FilterRule) passStringPrefix(dDP utils.DataProvider) (bool, error) { strVal, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } for _, prfxVal := range fltr.rsrValues { prfx, err := prfxVal.ParseDataProvider(dDP) if err != nil { continue } if strings.HasPrefix(strVal, prfx) { return true, nil } } return false, nil } func (fltr *FilterRule) passStringSuffix(dDP utils.DataProvider) (bool, error) { strVal, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } for _, prfxVal := range fltr.rsrValues { prfx, err := prfxVal.ParseDataProvider(dDP) if err != nil { continue } if strings.HasSuffix(strVal, prfx) { return true, nil } } return false, nil } func (fltr *FilterRule) passCronExp(ctx *context.Context, dDP utils.DataProvider) (bool, error) { tm, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } tmTime, err := utils.IfaceAsTime(tm, config.CgrConfig().GeneralCfg().DefaultTimezone) if err != nil { return false, err } // tmTime = tmTime.Truncate(time.Second) tmTime = tmTime.Truncate(time.Minute) tmBefore := tmTime.Add(-time.Second) for _, valCronIDVal := range fltr.rsrValues { valTmID, err := valCronIDVal.ParseDataProvider(dDP) if err != nil { continue } exp, err := cron.ParseStandard(valTmID) if err != nil { continue } if exp.Next(tmBefore) == tmTime { return true, nil } } return false, nil } func (fltr *FilterRule) passRSR(dDP utils.DataProvider) (bool, error) { fld, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { match := fltr.rsrFilters.FilterRules() == "^$" return match, nil } return false, err } match := fltr.rsrFilters.Pass(fld, false) return match, nil } func (fltr *FilterRule) passGreaterThan(dDP utils.DataProvider) (bool, error) { fldStr, err := fltr.rsrElement.ParseDataProviderWithInterfaces(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } fldIf := utils.StringToInterface(fldStr) orEqual := fltr.Type == utils.MetaGreaterOrEqual || fltr.Type == utils.MetaLessThan for _, val := range fltr.rsrValues { sval, err := val.ParseDataProviderWithInterfaces(dDP) if err != nil { continue } if gte, err := utils.GreaterThan(fldIf, utils.StringToInterface(sval), orEqual); err != nil { return false, err } else if (utils.MetaGreaterThan == fltr.Type || utils.MetaGreaterOrEqual == fltr.Type) && gte { return true, nil } else if (utils.MetaLessThan == fltr.Type || utils.MetaLessOrEqual == fltr.Type) && !gte { return true, nil } } return false, nil } func (fltr *FilterRule) passEqualTo(dDP utils.DataProvider) (bool, error) { fldStr, err := fltr.rsrElement.ParseDataProviderWithInterfaces(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } fldIf := utils.StringToInterface(fldStr) for _, val := range fltr.rsrValues { sval, err := val.ParseDataProviderWithInterfaces(dDP) if err != nil { continue } if eq, err := utils.EqualTo(fldIf, utils.StringToInterface(sval)); err != nil { return false, err } else if eq { return true, nil } } return false, nil } func (fltr *FilterRule) passIPNet(dDP utils.DataProvider) (bool, error) { strVal, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } ip := net.ParseIP(strVal) if ip == nil { return false, nil } for _, val := range fltr.rsrValues { sval, err := val.ParseDataProvider(dDP) if err != nil { continue } _, ipNet, err := net.ParseCIDR(sval) if err != nil { continue } if ipNet.Contains(ip) { return true, nil } } return false, nil } func (fltr *FilterRule) passAPIBan(ctx *context.Context, dDP utils.DataProvider) (bool, error) { strVal, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } if fltr.Values[0] != utils.MetaAll && fltr.Values[0] != utils.MetaSingle { // force only valid values return false, fmt.Errorf("invalid value for apiban filter: <%s>", fltr.Values[0]) } return GetAPIBan(ctx, strVal, config.CgrConfig().APIBanCfg().Keys, fltr.Values[0] != utils.MetaAll, true, true) } func parseTime(rsr *config.RSRParser, dDp utils.DataProvider) (_ time.Time, err error) { var str string if str, err = rsr.ParseDataProvider(dDp); err != nil { return } return utils.ParseTimeDetectLayout(str, config.CgrConfig().GeneralCfg().DefaultTimezone) } func (fltr *FilterRule) passActivationInterval(dDp utils.DataProvider) (bool, error) { timeVal, err := parseTime(fltr.rsrElement, dDp) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } if len(fltr.rsrValues) == 2 { endTime, err := parseTime(fltr.rsrValues[1], dDp) if err != nil { return false, err } if fltr.rsrValues[0] == nil { return timeVal.Before(endTime), nil } startTime, err := parseTime(fltr.rsrValues[0], dDp) if err != nil { return false, err } return startTime.Before(timeVal) && timeVal.Before(endTime), nil } startTime, err := parseTime(fltr.rsrValues[0], dDp) if err != nil { return false, err } return startTime.Before(timeVal), nil } func verifyInlineFilterS(fltrs []string) (err error) { for _, fl := range fltrs { if strings.HasPrefix(fl, utils.Meta) { if _, err = NewFilterFromInline(utils.EmptyString, fl); err != nil { return } } } return } func CheckFilter(fltr *Filter) (err error) { for _, rls := range fltr.Rules { valFunc := utils.IsPathValid if rls.Type == utils.MetaEmpty || rls.Type == utils.MetaExists { valFunc = utils.IsPathValidForExporters } if err = valFunc(rls.Element); err != nil { return fmt.Errorf("%s for filter <%v>", err, fltr) //encapsulated error } for _, val := range rls.Values { if err = valFunc(val); err != nil { return fmt.Errorf("%s for filter <%v>", err, fltr) //encapsulated error } } } return nil } func (fltr *FilterRule) passRegex(dDP utils.DataProvider) (bool, error) { strVal, err := fltr.rsrElement.ParseDataProvider(dDP) if err != nil { if err == utils.ErrNotFound { return false, nil } return false, err } for _, val := range fltr.regexValues { if val.MatchString(strVal) { return true, nil } } return false, nil } func (fltr *FilterRule) passNever(dDP utils.DataProvider) (bool, error) { return false, nil } func (fltr *Filter) Set(path []string, val interface{}, newBranch bool, _ string) (err error) { switch len(path) { default: return utils.ErrWrongPath case 1: switch path[0] { default: return utils.ErrWrongPath case utils.Tenant: fltr.Tenant = utils.IfaceAsString(val) case utils.ID: fltr.ID = utils.IfaceAsString(val) } case 2: if path[0] != utils.Rules { return utils.ErrWrongPath } if len(fltr.Rules) == 0 || newBranch { fltr.Rules = append(fltr.Rules, new(FilterRule)) } switch path[1] { case utils.Type: fltr.Rules[len(fltr.Rules)-1].Type = utils.IfaceAsString(val) case utils.Element: fltr.Rules[len(fltr.Rules)-1].Element = utils.IfaceAsString(val) case utils.Values: fltr.Rules[len(fltr.Rules)-1].Values, err = utils.IfaceAsStringSlice(val) default: return utils.ErrWrongPath } } return } func (fltr *Filter) Compress() { newRules := make([]*FilterRule, 0, len(fltr.Rules)) for i, flt := range fltr.Rules { if i == 0 || newRules[len(newRules)-1].Type != flt.Type || newRules[len(newRules)-1].Element != flt.Element { newRules = append(newRules, flt) continue } newRules[len(newRules)-1].Values = append(newRules[len(newRules)-1].Values, flt.Values...) } fltr.Rules = newRules } func (fltr *Filter) Merge(v2 interface{}) { vi := v2.(*Filter) if len(vi.Tenant) != 0 { fltr.Tenant = vi.Tenant } if len(vi.ID) != 0 { fltr.ID = vi.ID } for _, rule := range vi.Rules { if rule.Type != utils.EmptyString { fltr.Rules = append(fltr.Rules, rule) } } } func (fltr *Filter) String() string { return utils.ToJSON(fltr) } func (fltr *Filter) FieldAsString(fldPath []string) (_ string, err error) { var val interface{} if val, err = fltr.FieldAsInterface(fldPath); err != nil { return } return utils.IfaceAsString(val), nil } func (fltr *Filter) FieldAsInterface(fldPath []string) (_ interface{}, err error) { if len(fldPath) == 1 { switch fldPath[0] { default: fld, idx := utils.GetPathIndex(fldPath[0]) if fld == utils.Rules && idx != nil && *idx < len(fltr.Rules) { return fltr.Rules[*idx], nil } return nil, utils.ErrNotFound case utils.Tenant: return fltr.Tenant, nil case utils.ID: return fltr.ID, nil } } if len(fldPath) == 0 || !strings.HasPrefix(fldPath[0], utils.Rules) || fldPath[0][5] != '[' || fldPath[0][len(fldPath[0])-1] != ']' { return nil, utils.ErrNotFound } var idx int if idx, err = strconv.Atoi(fldPath[0][6 : len(fldPath[0])-1]); err != nil { return } if idx >= len(fltr.Rules) { return nil, utils.ErrNotFound } return fltr.Rules[idx].FieldAsInterface(fldPath[1:]) } func (fltr *FilterRule) String() string { return utils.ToJSON(fltr) } func (fltr *FilterRule) FieldAsString(fldPath []string) (_ string, err error) { var val interface{} if val, err = fltr.FieldAsInterface(fldPath); err != nil { return } return utils.IfaceAsString(val), nil } func (fltr *FilterRule) FieldAsInterface(fldPath []string) (_ interface{}, err error) { if len(fldPath) != 1 { return nil, utils.ErrNotFound } switch fldPath[0] { default: fld, idx := utils.GetPathIndex(fldPath[0]) if fld == utils.Values && idx != nil && *idx < len(fltr.Values) { return fltr.Values[*idx], nil } return nil, utils.ErrNotFound case utils.Type: return fltr.Type, nil case utils.Element: return fltr.Element, nil case utils.Values: return fltr.Values, nil } }