member-console/internal/server/operator_tier_changes.go

// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
// SPDX-FileCopyrightText: 2025-2026 Christian Galo

package server

import (
	"strings"

	"git.coopcloud.tech/wiki-cafe/member-console/internal/entitlements"
)

// humanizeTransitionReason renders a machine-written
// pool_provision_transitions.reason value as the sentence design D3
// assigns it, matched by prefix where the writer appends an identifier or
// a label. known is false for a reason the map does not recognize; callers
// then fall back to the raw string (D3: "a reason the map does not know
// renders raw"). Issue grant copies the operator's note into the reason, so
// the reasons an act writes for itself count only from the writer that
// writes them: a resumption's and a delivery's from "system", an extension's
// from an "operator" transition of the type its conferral records (transfer,
// or the incumbent's end beside it); the same text from anyone else renders
// raw.
func humanizeTransitionReason(raw, transitionType, actorType string) (label string, known bool) {
	bySystem := actorType == "system"
	extension := actorType == "operator" && (transitionType == "transfer" || transitionType == "end")
	switch {
	case raw == "operator_revocation":
		return "Revoked by an operator", true
	case raw == entitlements.ExtensionTransitionReason && extension:
		return "Extended by an operator", true
	case raw == "post-revocation default restoration":
		return "Default restored after a revocation", true
	case raw == "post-cancellation default restoration":
		return "Default restored after a subscription ended", true
	case raw == "auto-provisioning on org creation":
		return "Default on organization creation", true
	case raw == "demoseed: floor personal pool at org-type default":
		return "Seeded default", true
	case bySystem && strings.HasPrefix(raw, entitlements.ResumptionReasonSubscription):
		return "Grant resumed after a subscription ended", true
	case bySystem && strings.HasPrefix(raw, entitlements.ResumptionReasonRevocation):
		return "Grant resumed after a revocation", true
	case bySystem && strings.HasPrefix(raw, entitlements.ResumptionReasonExpiration):
		return "Grant resumed after a grant expired", true
	case bySystem && strings.HasPrefix(raw, entitlements.SubscriptionDeliveryRevocation):
		return "Subscription delivers again after a revocation", true
	case bySystem && strings.HasPrefix(raw, entitlements.SubscriptionDeliveryExpiration):
		return "Subscription delivers again after a grant expired", true
	case bySystem && strings.HasPrefix(raw, entitlements.SubscriptionDeliverySubscription):
		return "Subscription delivers again after a subscription ended", true
	case bySystem && strings.HasPrefix(raw, entitlements.SubscriptionDeliveryDropped):
		return "Subscription delivers again after a subscription dropped its tier", true
	case strings.HasPrefix(raw, "grant-expiration:") && strings.HasSuffix(raw, " default restoration"):
		return "Default restored after a grant expired", true
	case strings.HasPrefix(raw, "grant-expiration:"):
		return "Grant expired", true
	case strings.HasPrefix(raw, "org-type default change ("):
		return "Org-type default changed", true
	case strings.HasPrefix(raw, "tier added to ladder "):
		return "Tier added to the ladder", true
	case strings.HasPrefix(raw, "plan-ladder tier reorder ("):
		return "Ladder tiers reordered", true
	case strings.HasPrefix(raw, "tier removal ("):
		return "Tier removed from the ladder", true
	default:
		return raw, false
	}
}

// transitionChangeLabels maps the transition_type enum to operator
// vocabulary. transfer gets a tooltip: same rank, different funding
// source (model card invariant: callers never choose the type; confer
// derives it from ranks), except the transfer an extension causes, which
// is labelled Extended and needs no tooltip (transitionChange).
var transitionChangeLabels = map[string]string{
	"initiate":  "Started",
	"upgrade":   "Upgraded",
	"downgrade": "Downgraded",
	"transfer":  "Transferred",
	"end":       "Ended",
}

// transitionChange is the one label rule for a tier change, wherever one is
// named: the Tier changes list's Change badge and the recent-activity line
// (grant-resumption D22). kind is the kind of change the database names for
// the row (core.transition_change_kind, which also says when a reason
// counts): a resumption's start reads "Resumed" and an extension's transfer
// "Extended"; every other row is its type and keeps its type's label, so a
// restored default stays "Started" and its reason says what it restored
// after, and the incumbent's end that core.confer writes beside an
// extension's transfer keeps "Ended", as it keeps it beside any other
// supersession. kind is also the badge map's key for the label.
func transitionChange(kind string) string {
	switch kind {
	case "extension", "resumption":
		return badgeMap[kind].Label
	}
	if label := transitionChangeLabels[kind]; label != "" {
		return label
	}
	return kind
}

// humanizeTransitionSummary renders one transition event's one-line
// summary in the composite's vocabulary: the verb the Tier changes list's
// Change badge reads (transitionChange, so a resumption reads "Resumed" and
// an extension "Extended", grant-resumption D22) plus the resolved tier
// label(s) the change moved between. kind is the kind of change the
// database names for the row (transitionChange). fromLabel and toLabel are
// already resolved product names (or a "rank N" / "—" fallback — see
// tierLabel) so this function only picks which label(s) the sentence needs
// for the given change type.
func humanizeTransitionSummary(transitionType, kind, fromLabel, toLabel string) string {
	verb := transitionChange(kind)
	// Separators are a colon and the word "to": UI copy carries no em
	// dashes (design-system §4; the lint rule covers templates, this
	// string reaches the page through one).
	switch transitionType {
	case "upgrade", "downgrade":
		return verb + ": " + fromLabel + " to " + toLabel
	case "end":
		return verb + ": " + fromLabel
	default:
		// initiate, transfer, and any future type: the position lands ON
		// toLabel (transfer keeps the same tier under a new funding source,
		// so fromLabel/toLabel are equal there).
		return verb + ": " + toLabel
	}
}