errors

const (
	// CodeUnknown is the fallback for an error that is not an AppError or carries no code:
	// HTTP 500, gRPC INTERNAL; neither transient nor permanent.
	CodeUnknown ErrorCode = "UNKNOWN"

	// CodeInternal is an unexpected server-side failure: HTTP 500, gRPC INTERNAL; neither
	// transient nor permanent.
	CodeInternal ErrorCode = "INTERNAL"

	// CodeNotFound is a missing resource: HTTP 404, gRPC NOT_FOUND; permanent.
	CodeNotFound ErrorCode = "NOT_FOUND"

	// CodeUnauthorized is a missing or invalid authentication credential: HTTP 401, gRPC
	// UNAUTHENTICATED; permanent.
	CodeUnauthorized ErrorCode = "UNAUTHORIZED"

	// CodeForbidden is an authenticated caller lacking permission for the action: HTTP 403,
	// gRPC PERMISSION_DENIED; permanent.
	CodeForbidden ErrorCode = "FORBIDDEN"

	// CodeInvalidInput is a malformed or otherwise rejected request payload: HTTP 400, gRPC
	// INVALID_ARGUMENT; permanent.
	CodeInvalidInput ErrorCode = "INVALID_INPUT"

	// CodeConflict is a state conflict, such as a duplicate or a concurrent modification:
	// HTTP 409, gRPC ALREADY_EXISTS; permanent.
	CodeConflict ErrorCode = "CONFLICT"

	// CodeTimeout is an operation that exceeded its deadline: HTTP 504, gRPC
	// DEADLINE_EXCEEDED; transient.
	CodeTimeout ErrorCode = "TIMEOUT"

	// CodeCanceled is an operation the caller canceled: HTTP 500, gRPC CANCELLED; neither
	// transient nor permanent.
	CodeCanceled ErrorCode = "CANCELED"

	// CodeUnavailable is a temporarily unreachable dependency: HTTP 503, gRPC UNAVAILABLE;
	// transient.
	CodeUnavailable ErrorCode = "UNAVAILABLE"

	// CodeIngestion is a failure in the document ingestion pipeline: HTTP 500, gRPC
	// INTERNAL; neither transient nor permanent.
	CodeIngestion ErrorCode = "INGESTION_ERROR"

	// CodeQualityFailed is a failed quality gate: HTTP 500, gRPC INTERNAL; neither transient
	// nor permanent.
	CodeQualityFailed ErrorCode = "QUALITY_FAILED"

	// CodeUpstream is a failure originating in an upstream dependency: HTTP 502, gRPC
	// UNAVAILABLE; neither transient nor permanent.
	CodeUpstream ErrorCode = "UPSTREAM"

	// CodeResourceExhausted is a request rejected because a quota or budget is spent: HTTP
	// 429, gRPC RESOURCE_EXHAUSTED; neither transient nor permanent.
	//
	// It is neither transient (retrying before the window resets only burns the quota check)
	// nor permanent (the request succeeds once the window resets).
	CodeResourceExhausted ErrorCode = "RESOURCE_EXHAUSTED"
)