subscription

Documentation

Index

• Variables
• func ClassifyReceivers(newReceiver []subscriptionreceiver.Relation, ...) (toUpsert []subscriptionreceiver.Relation, ...)
• type Filter
• type LogService
• type NamespaceService
• type NotFoundError
  • func (err NotFoundError) Error() string
• type Receiver
• type ReceiverService
• type ReceiverView
  • func (rcv *ReceiverView) FromReceiver(r receiver.Receiver)
• type Repository
• type Service
  • func NewService(repository Repository, logService LogService, ...) *Service
  • func (s *Service) CreateV2(ctx context.Context, sub *Subscription) error
  • func (s *Service) DeleteV2(ctx context.Context, id uint64) error
  • func (s *Service) GetV2(ctx context.Context, id uint64) (*Subscription, error)
  • func (s *Service) ListV2(ctx context.Context, flt Filter) ([]Subscription, error)
  • func (s *Service) MatchByLabelsV2(ctx context.Context, namespaceID uint64, notificationLabels map[string]string) ([]ReceiverView, error)
  • func (s *Service) UpdateV2(ctx context.Context, sub *Subscription) error
• type Subscription
  • func (s Subscription) ReceiversAsMap() map[uint64]Receiver
  • func (s Subscription) SilenceReceivers(silences []silence.Silence) (map[uint64][]silence.Silence, []Receiver, error)
• type SubscriptionReceiverService
• type Transactor

Variables

var (
	ErrDuplicate = errors.New("urn already exist")
	ErrRelation  = errors.New("namespace id does not exist")
)

Functions

func ClassifyReceivers

func ClassifyReceivers(newReceiver []subscriptionreceiver.Relation, existingReceiver []subscriptionreceiver.Relation) (toUpsert []subscriptionreceiver.Relation, toDelete []subscriptionreceiver.Relation)

ClassifyReceivers compare existing and new receivers of a subscription

Types

type Filter

type Filter struct {
	NamespaceID                uint64
	Match                      map[string]string
	NotificationMatch          map[string]string
	Metadata                   map[string]any
	SilenceID                  string
	IDs                        []int64
	SubscriptionReceiverLabels map[string]string
	ReceiverID                 uint64
	WithSubscriptionReceiver   bool
}

type LogService

type LogService interface {
	ListSubscriptionIDsBySilenceID(ctx context.Context, silenceID string) ([]int64, error)
}

type NamespaceService

type NamespaceService interface {
	List(context.Context) ([]namespace.Namespace, error)
	Create(context.Context, *namespace.Namespace) error
	Get(context.Context, uint64) (*namespace.Namespace, error)
	Update(context.Context, *namespace.Namespace) error
	Delete(context.Context, uint64) error
}

type NotFoundError

type NotFoundError struct {
	ID uint64
}

func (NotFoundError) Error

func (err NotFoundError) Error() string

type Receiver

type Receiver struct {
	ID                         uint64            `json:"id"`
	Configuration              map[string]any    `json:"configuration"`
	SubscriptionReceiverLabels map[string]string `json:"subscription_receiver_labels"`

	// Type won't be exposed to the end-user, this is used to add more details for notification purposes
	Type string
}

type ReceiverService

type ReceiverService interface {
	List(ctx context.Context, flt receiver.Filter) ([]receiver.Receiver, error)
	PostHookDBTransformConfigs(ctx context.Context, receiverType string, configs map[string]any) (map[string]any, error)
}

type ReceiverView

type ReceiverView struct {
	ID             uint64            `json:"id"` // receiver_id
	Name           string            `json:"name"`
	Labels         map[string]string `json:"labels"`
	Type           string            `json:"type"`
	Configurations map[string]any    `json:"configurations"`
	ParentID       uint64            `json:"parent_id"`
	CreatedAt      time.Time         `json:"created_at"`
	UpdatedAt      time.Time         `json:"updated_at"`
	SubscriptionID uint64            `json:"subscription_id"`
	Match          map[string]string `json:"match"`
}

func (*ReceiverView) FromReceiver

func (rcv *ReceiverView) FromReceiver(r receiver.Receiver)

type Repository

type Repository interface {
	Transactor
	List(context.Context, Filter) ([]Subscription, error)
	Create(context.Context, *Subscription) error
	Get(context.Context, uint64) (*Subscription, error)
	Update(context.Context, *Subscription) error
	Delete(context.Context, uint64) error
	MatchLabelsFetchReceivers(ctx context.Context, flt Filter) ([]ReceiverView, error)
}

type Service

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

Service handles business logic

func NewService

func NewService(
	repository Repository,
	logService LogService,
	namespaceService NamespaceService,
	receiverService ReceiverService,
	subscriptionReceiverService SubscriptionReceiverService,
) *Service

NewService returns service struct

func (*Service) CreateV2

func (s *Service) CreateV2(ctx context.Context, sub *Subscription) error

func (*Service) DeleteV2

func (s *Service) DeleteV2(ctx context.Context, id uint64) error

func (*Service) GetV2

func (s *Service) GetV2(ctx context.Context, id uint64) (*Subscription, error)

func (*Service) ListV2

func (s *Service) ListV2(ctx context.Context, flt Filter) ([]Subscription, error)

func (*Service) MatchByLabelsV2

func (s *Service) MatchByLabelsV2(ctx context.Context, namespaceID uint64, notificationLabels map[string]string) ([]ReceiverView, error)

func (*Service) UpdateV2

func (s *Service) UpdateV2(ctx context.Context, sub *Subscription) error

type Subscription

type Subscription struct {
	ID        uint64            `json:"id"`
	URN       string            `json:"urn"`
	Namespace uint64            `json:"namespace"`
	Receivers []Receiver        `json:"receivers"`
	Match     map[string]string `json:"match"`
	Metadata  map[string]any    `json:"metadata"`
	CreatedAt time.Time         `json:"created_at"`
	UpdatedAt time.Time         `json:"updated_at"`
	CreatedBy string            `json:"created_by"`
	UpdatedBy string            `json:"updated_by"`

	// for v1 api cases
	ReceiversRelation []subscriptionreceiver.Relation `json:"receivers_relation"`
}

func (Subscription) ReceiversAsMap

func (s Subscription) ReceiversAsMap() map[uint64]Receiver

func (Subscription) SilenceReceivers

func (s Subscription) SilenceReceivers(silences []silence.Silence) (map[uint64][]silence.Silence, []Receiver, error)

type SubscriptionReceiverService

type SubscriptionReceiverService interface {
	List(context.Context, subscriptionreceiver.Filter) ([]subscriptionreceiver.Relation, error)
	BulkCreate(context.Context, []subscriptionreceiver.Relation) error
	BulkUpsert(context.Context, []subscriptionreceiver.Relation) error
	BulkSoftDelete(context.Context, subscriptionreceiver.DeleteFilter) error
	BulkDelete(context.Context, subscriptionreceiver.DeleteFilter) error
}

type Transactor

type Transactor interface {
	WithTransaction(ctx context.Context) context.Context
	Rollback(ctx context.Context, err error) error
	Commit(ctx context.Context) error
}