// 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 ByteHours float64 SegmentHours float64 ObjectHours float64 EgressData int64 Hours int } // 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) // QueryAllAttribution queries all partner bucket attribution data. QueryAllAttribution(ctx context.Context, start time.Time, end time.Time) ([]*CSVRow, error) }