129 lines
3.0 KiB
Go
129 lines
3.0 KiB
Go
// Copyright (C) 2019 Storj Labs, Inc.
|
|
// See LICENSE for copying information
|
|
|
|
package rewards
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/zeebo/errs"
|
|
|
|
"storj.io/storj/private/currency"
|
|
)
|
|
|
|
var (
|
|
// ErrReachedMaxCapacity is the error class used when an offer has reached its redemption capacity.
|
|
ErrReachedMaxCapacity = errs.Class("offer redemption has reached its capacity")
|
|
// ErrOfferNotExist is the error class used when no current offer is set.
|
|
ErrOfferNotExist = errs.Class("no current offer")
|
|
)
|
|
|
|
// DB holds information about offers.
|
|
//
|
|
// architecture: Database
|
|
type DB interface {
|
|
ListAll(ctx context.Context) (Offers, error)
|
|
GetActiveOffersByType(ctx context.Context, offerType OfferType) (Offers, error)
|
|
Create(ctx context.Context, offer *NewOffer) (*Offer, error)
|
|
Finish(ctx context.Context, offerID int) error
|
|
}
|
|
|
|
// NewOffer holds information that's needed for creating a new offer.
|
|
type NewOffer struct {
|
|
Name string
|
|
Description string
|
|
|
|
AwardCredit currency.USD
|
|
InviteeCredit currency.USD
|
|
|
|
RedeemableCap int
|
|
|
|
AwardCreditDurationDays int
|
|
InviteeCreditDurationDays int
|
|
|
|
ExpiresAt time.Time
|
|
|
|
Status OfferStatus
|
|
Type OfferType
|
|
}
|
|
|
|
// UpdateOffer holds fields needed for update an offer.
|
|
type UpdateOffer struct {
|
|
ID int
|
|
Status OfferStatus
|
|
ExpiresAt time.Time
|
|
}
|
|
|
|
// RedeemOffer holds field needed for redeem an offer.
|
|
type RedeemOffer struct {
|
|
RedeemableCap int
|
|
Status OfferStatus
|
|
Type OfferType
|
|
}
|
|
|
|
// Offers contains a slice of offers.
|
|
type Offers []Offer
|
|
|
|
// OfferType indicates the type of an offer.
|
|
type OfferType int
|
|
|
|
const (
|
|
// Invalid is a default value for offers that don't have correct type associated with it.
|
|
Invalid = OfferType(0)
|
|
// FreeCredit is a type of offers used for Free Credit Program.
|
|
FreeCredit = OfferType(1)
|
|
// Referral is a type of offers used for Referral Program.
|
|
Referral = OfferType(2)
|
|
// Partner is an OfferType used be the Open Source Partner Program.
|
|
Partner = OfferType(3)
|
|
)
|
|
|
|
// OfferStatus represents the different stage an offer can have in its life-cycle.
|
|
type OfferStatus int
|
|
|
|
const (
|
|
// Done is the status of an offer that is no longer in use.
|
|
Done = OfferStatus(iota)
|
|
// Default is the status of an offer when there is no active offer.
|
|
Default
|
|
// Active is the status of an offer that is currently in use.
|
|
Active
|
|
)
|
|
|
|
// Offer contains info needed for giving users free credits through different offer programs.
|
|
type Offer struct {
|
|
ID int
|
|
Name string
|
|
Description string
|
|
|
|
AwardCredit currency.USD
|
|
InviteeCredit currency.USD
|
|
|
|
AwardCreditDurationDays int
|
|
InviteeCreditDurationDays int
|
|
|
|
RedeemableCap int
|
|
|
|
ExpiresAt time.Time
|
|
CreatedAt time.Time
|
|
|
|
Status OfferStatus
|
|
Type OfferType
|
|
}
|
|
|
|
// IsEmpty evaluates whether or not an on offer is empty.
|
|
func (offer Offer) IsEmpty() bool {
|
|
return offer.Name == ""
|
|
}
|
|
|
|
// IsZero returns whether it's equivalent to empty struct.
|
|
func (offer Offer) IsZero() bool {
|
|
return offer == Offer{}
|
|
}
|
|
|
|
// IsDefault checks if a offer's status is default.
|
|
func (status OfferStatus) IsDefault() bool {
|
|
return status == Default
|
|
}
|