usage

type AGPLInserter struct{}

type Inserter interface {
	// InsertDiscreteUsageEvent writes a discrete usage event to the database
	// within the given transaction.
	// The caller context must be authorized to create usage events in the
	// database.
	InsertDiscreteUsageEvent(ctx context.Context, tx database.Store, event usagetypes.DiscreteEvent) error

	// InsertHeartbeatUsageEvent writes a heartbeat usage event to the database
	// within the given transaction.
	//
	// The caller context must be authorized to create usage events in the database.
	//
	// The `id` should be a stable identifier for the event. Heartbeat events may be
	// emitted by multiple replicas of the same daemon, so the same logical event
	// may be submitted multiple times concurrently. For this reason the identifier
	// must be deterministic and stateless, allowing duplicate submissions to be
	// safely ignored.
	//
	// Inserts with the same `id` must be idempotent. The database enforces this by
	// ignoring duplicate records.
	InsertHeartbeatUsageEvent(ctx context.Context, tx database.Store, id string, event usagetypes.HeartbeatEvent) error
}