Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

usage

package

Go to main page

Versions in this module

v1

v1.4.1

Jul 26, 2026

Changes in this version

type LiveUsageTracker

+ func (t *LiveUsageTracker) RecordAndCheckTx(ctx context.Context, tx pgx.Tx, userID, agentID, domain, direction string) (bool, error)

type NoopUsageTracker

+ func (t *NoopUsageTracker) RecordAndCheckTx(context.Context, pgx.Tx, string, string, string, string) (bool, error)

type Store

+ func (s *Store) GetAccountClassTx(ctx context.Context, tx pgx.Tx, userID string) (AccountClass, error)

+ func (s *Store) IncrementUsageSummaryTx(ctx context.Context, tx pgx.Tx, userID, bucketDate, direction string) error

+ func (s *Store) RecordUsageEventTx(ctx context.Context, tx pgx.Tx, event *UsageEvent) error

+ type TransactionalUsageTracker interface

+ RecordAndCheckTx func(context.Context, pgx.Tx, string, string, string, string) (bool, error)

v1.1.0

Jul 21, 2026

Changes in this version

+ func CurrentDate() string

+ func RateLimited(c AccountClass) bool

+ type AccountClass string

+ const ClassDemo

+ const ClassInternal

+ const ClassStandard

+ const ClassSystem

+ type LiveUsageTracker struct

+ func NewUsageTracker(store *Store) *LiveUsageTracker

+ func (t *LiveUsageTracker) RecordAndCheck(ctx context.Context, userID, agentID, domain, direction string) (bool, error)

+ type MeteringPolicy struct

+ Analytics bool

+ Bill bool

+ Meter bool

+ func PolicyFor(c AccountClass) MeteringPolicy

+ type NoopUsageTracker struct

+ func NewNoopUsageTracker() *NoopUsageTracker

+ func (t *NoopUsageTracker) RecordAndCheck(ctx context.Context, userID, agentID, domain, direction string) (bool, error)

+ type Store struct

+ func NewStore(pool *pgxpool.Pool) *Store

+ func (s *Store) CountAgentsByUser(ctx context.Context, userID string) (int, error)

+ func (s *Store) CountDomainsByUser(ctx context.Context, userID string) (int, error)

+ func (s *Store) GetAccountClass(ctx context.Context, userID string) (AccountClass, error)

+ func (s *Store) GetStorageBytes(ctx context.Context, userID string) (int64, error)

+ func (s *Store) GetUsageSummary(ctx context.Context, userID, bucketDate string) (*UsageSummary, error)

+ func (s *Store) IncrementUsageSummary(ctx context.Context, userID, bucketDate, direction string) error

+ func (s *Store) MessagesThisMonth(ctx context.Context, userID string) (int, error)

+ func (s *Store) RecordUsageEvent(ctx context.Context, event *UsageEvent) error

+ type UsageEvent struct

+ AgentID string

+ CreatedAt time.Time

+ Direction string

+ Domain string

+ EventType string

+ ID string

+ UserID string

+ type UsageSummary struct

+ BucketDate string

+ InboundCount int

+ OutboundCount int

+ TotalCount int

+ UserID string

+ type UsageTracker interface

+ RecordAndCheck func(ctx context.Context, userID, agentID, domain, direction string) (allowed bool, err error)