# Commerce

Host-neutral Go contracts and client logic for membership, credits, and the
first-registration credits reward.

The package intentionally does not know Tutti or TSH session files, Cookie
formats, renderer state, Electron, or VM paths. A host must provide:

- a trusted Commerce base URL;
- a request authorizer;
- a host-local reward receipt store;
- optionally, its shared HTTP client and clock.

The host remains responsible for combining Commerce data with Account identity
and for mapping the result into its local API and UI.

`ProductSummary.MembershipAccess` is the stable behavior contract for hosts:

- `free`: Commerce explicitly reports no paid membership;
- `active`: paid membership access is explicitly active;
- `inactive`: paid membership access is explicitly inactive;
- `unknown`: membership data is missing, partial, or uses an unrecognized
  status.

Hosts must use this enum for upgrade/recharge behavior instead of parsing
`TierKey`, `Status`, `AccessStatus`, or display labels. Unknown values fail
closed to `unknown`.