enhancement: implement find on entity

[lostman]

Description

Closes #1437.

Example usage:

// Test searching for a string field
let f = FindEntity::find(
    FindEntity::string_value()
        .gt("f".to_string())
        .order_by_asc(FindEntity::value()),
)

This PR extends the codegen to generate field selectors for an @entity, e.g.:

1460   │     pub fn id() -> Field<ChainInfo, ID> {
1461   │         Field::new("id".to_string())
1462   │     }
1463   │     pub fn base_chain_height() -> Field<ChainInfo, U32> {
1464   │         Field::new("base_chain_height".to_string())
1465   │     }
1466   │     pub fn name() -> Field<ChainInfo, String> {
1467   │         Field::new("name".to_string())
1468   │     }
1469   │     pub fn peer_count() -> Field<ChainInfo, I32> {
1470   │         Field::new("peer_count".to_string())
1471   │     }
1472   │     pub fn latest_block() -> Field<ChainInfo, UID> {
1473   │         Field::new("latest_block".to_string())
1474   │     }
1475   │     pub fn consensus_parameters() -> Field<ChainInfo, UID> {
1476   │         Field::new("consensus_parameters".to_string())
1477   │     }

Field<T> structs implement methods such as eq, gt, lt, etc., which return a Filter<T>, which, in turn, can be combined using and and or to produce a mode complex Filter<T>. Finally, a Filter<T> can be ordered ascending or descending, turning it into a QueryFragment<T>.

The find function on Entity takes a Filter or QueryFragment and fetches the corresponding object from the database, if any exists.

Testing steps

CI testing. This PR includes an integration test for added functionality.

Changelog

• Add find(query: impl Into<QueryFragment<Self>>) -> Option<Self> to Entity.
• Add ff_single_select to FFI, and single_select to the indexer.
• Add fuel_indexer_plugin::find module, which contains the code for generating SQL query fragments.
• Decoder now generates field_selectors, e.g., pub fn base_chain_height() -> Field<ChainInfo, U32> which are used to construct queries

[ra0x3]

• Wow @lostman very well done 👏🏼
• Very clean and sets us up in a good spot to extend and continue the ORM work
• ⭐ ⭐⭐⭐⭐
• I left a comment about the syntax of your order clause. That's my only real feedback
• The rustdoc comments make this pretty easy to follow thankfully 🙏🏼

[ra0x3]

🥇

[deekerno]

Looks great, just left one comment about the usage of .unwrap().

[deekerno]

Can we get rid of the .unwrap()s here? From what I can tell, the other functions in this module don't use them.