entitlements

type Config struct {
	// Billing is RIVOLT_BILLING: false (the default, every self-hosted install) makes every account Pro without reading the table.
	// Without a database there is nothing to read, so billing counts as off.
	Billing bool
	// Demo is the demo account's id (always Pro with billing on); uuid.Nil for none.
	Demo uuid.UUID
	// TTL is how long an account's rows are cached; 0 means DefaultTTL. A grant written on another replica is seen within it.
	TTL time.Duration
	Log *slog.Logger
	// StripeManage is true when Stripe is configured: only then does a billing-off server look at the rows to tell which accounts still
	// hold a Stripe subscription (ManageSubscription). Every self-hosted install that sells nothing leaves it false and reads no row.
	StripeManage bool
	// OnLookupError is told each time the rows could not be read (the metric beside the fail-open warning).
	OnLookupError func()
}

type FoundingReport struct {
	Eligible int // accounts that existed at launch, the demo excluded
	Already  int // of those, how many already have a founding row
	ToGrant  int
	IDs      []uuid.UUID // accounts to grant, sorted
}

type Row struct {
	Source    string
	Status    string
	PeriodEnd *time.Time // nil: no end
	// CancelAtPeriodEnd is a paid subscription set to not renew: still Pro until PeriodEnd (plan_cancels_at).
	CancelAtPeriodEnd bool
	// UpdatedAt is when the row last changed; it dates an ended row that has no period end (a refund, a revoke).
	UpdatedAt time.Time
}

type Rowset []Row

type Service struct {
	// contains filtered or unexported fields
}

type State struct {
	Pro bool
	// Source is what makes the account Pro: the strongest granting row (a paid one, then founding, grant, trial), billing_off or demo.
	// Empty when free.
	Source string
	// PeriodEnd is when that grant ends, grace included; nil when free or when it has no end.
	PeriodEnd *time.Time
	// TrialEnds is the trial's end, only while the trial is what grants Pro; nil otherwise.
	TrialEnds *time.Time
	// CancelsAt is when a paid subscription that is set to not renew stops granting Pro (its period end): "cancelled, paid until ...".
	// Only for an active stripe or apple row that is the one granting; nil otherwise.
	CancelsAt *time.Time
	// GraceEnds is when the grace of a paid subscription whose renewal failed runs out: "payment failed, update your card by ...".
	// Only while the row granting Pro is a past-due paid one (stripe or apple); nil otherwise.
	GraceEnds *time.Time
	// EndedAt and EndedSource describe a LAPSE: for a free account that once had Pro, when the most recent grant stopped and which source
	// it was ("Your Pro ended on ..."). Nil/empty for an account that never had Pro, and always for a Pro account.
	EndedAt     *time.Time
	EndedSource string
}

type Stats struct {
	ByKind   map[[2]string]int // [source, status] -> rows
	Accounts int
}