package adminstop

// Stable error codes returned in `Result.ErrorCode`. The values match
// the vocabulary frozen by `gamemaster/README.md §Error Model` and
// `gamemaster/api/internal-openapi.yaml`. Service-layer callers (Stage
// 19 handlers) import these names rather than redeclare them; renaming
// any of them is a contract change.
const (
	// ErrorCodeInvalidRequest reports that the request envelope failed
	// structural validation (empty GameID, unknown stop reason).
	ErrorCodeInvalidRequest = "invalid_request"

	// ErrorCodeRuntimeNotFound reports that no runtime_records row
	// exists for the requested game id.
	ErrorCodeRuntimeNotFound = "runtime_not_found"

	// ErrorCodeConflict reports that the runtime is in a status that
	// cannot transition to `stopped` (currently only `starting`), or
	// that a CAS guard mid-flow lost the race to a concurrent mutation.
	ErrorCodeConflict = "conflict"

	// ErrorCodeServiceUnavailable reports that a steady-state dependency
	// (PostgreSQL, Runtime Manager) was unreachable for this call.
	ErrorCodeServiceUnavailable = "service_unavailable"

	// ErrorCodeInternal reports an unexpected error not classified by
	// the other codes.
	ErrorCodeInternal = "internal_error"
)

// Allowed values of Input.Reason mirror the README §Stop wording
// «reason ∈ {admin_request, finished, timeout}». Callers that pass an
// empty string get the documented default `admin_request`.
const (
	// ReasonAdminRequest is the operator-driven stop reason and the
	// default when Input.Reason is empty.
	ReasonAdminRequest = "admin_request"

	// ReasonFinished is reserved for callers that wrap a
	// finish-detected stop (currently unused; documented for
	// completeness).
	ReasonFinished = "finished"

	// ReasonTimeout is reserved for callers that wrap an automated
	// timeout-driven stop (currently unused; documented for
	// completeness).
	ReasonTimeout = "timeout"
)