49 lines
1.4 KiB
Go
49 lines
1.4 KiB
Go
// Copyright (C) 2019 Storj Labs, Inc.
|
|
// See LICENSE for copying information.
|
|
|
|
// Package attribution implements value attribution from docs/design/value-attribution.md
|
|
package attribution
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/zeebo/errs"
|
|
|
|
"storj.io/common/uuid"
|
|
)
|
|
|
|
// ErrBucketNotAttributed is returned if a requested bucket not attributed(entry not found).
|
|
var ErrBucketNotAttributed = errs.Class("bucket not attributed")
|
|
|
|
// Info describing value attribution from partner to bucket.
|
|
type Info struct {
|
|
ProjectID uuid.UUID
|
|
BucketName []byte
|
|
PartnerID uuid.UUID
|
|
UserAgent []byte
|
|
CreatedAt time.Time
|
|
}
|
|
|
|
// CSVRow represents data from QueryAttribution without exposing dbx.
|
|
type CSVRow struct {
|
|
PartnerID []byte
|
|
UserAgent []byte
|
|
ProjectID []byte
|
|
BucketName []byte
|
|
TotalBytesPerHour float64
|
|
EgressData int64
|
|
}
|
|
|
|
// DB implements the database for value attribution table.
|
|
//
|
|
// architecture: Database
|
|
type DB interface {
|
|
// Get retrieves attribution info using project id and bucket name.
|
|
Get(ctx context.Context, projectID uuid.UUID, bucketName []byte) (*Info, error)
|
|
// Insert creates and stores new Info
|
|
Insert(ctx context.Context, info *Info) (*Info, error)
|
|
// QueryAttribution queries partner bucket attribution data
|
|
QueryAttribution(ctx context.Context, partnerID uuid.UUID, userAgent []byte, start time.Time, end time.Time) ([]*CSVRow, error)
|
|
}
|