Change CacheState.register to a fluent API

[pkoenig10]

Follow up from #1919

This is a slightly less obvious but more ergonomic API for consumers.

[changelog-app]

Generate changelog in changelog/@unreleased

What do the change types mean?

• feature: A new feature of the service.
• improvement: An incremental improvement in the functionality or operation of the service.
• fix: Remedies the incorrect behaviour of a component of the service in a backwards-compatible way.
• break: Has the potential to break consumers of this service's API, inclusive of both Palantir services
  and external consumers of the service's API (e.g. customer-written software or integrations).
• deprecation: Advertises the intention to remove service functionality without any change to the
  operation of the service itself.
• manualTask: Requires the possibility of manual intervention (running a script, eyeballing configuration,
  performing database surgery, ...) at the time of upgrade for it to succeed.
• migration: A fully automatic upgrade migration task with no engineer input required.

Note: only one type should be chosen.

How are new versions calculated?

• ❗The break and manual task changelog types will result in a major release!
• 🐛 The fix changelog type will result in a minor release in most cases, and a patch release version for patch branches. This behaviour is configurable in autorelease.
• ✨ All others will result in a minor version release.

Type

• Feature
• Improvement
• Fix
• Break
• Deprecation
• Manual task
• Migration

Description

CacheState.register has been changed to be a more fluent API.

Check the box to generate changelog(s)

• Generate changelog entry

[carterkozak]

nice

[svc-autorelease]

Released 0.85.0

[pkoenig10]

One nice thing about this API is that it makes it difficult to forget to call recordStats, since the provided CacheStats variable will be unused otherwise.

[carterkozak]

Before this rolls out broadly, could we add a check to throw if stats aren't being recorded (which implies the cacheStats value hasn't been provided to the builder)?

[pkoenig10]

#1922