feat: support usage of the consistency option

[ewanharris]

Description

This is an initial attempt at introducing support for the experimental consistency option in the relevant APIs, this is supported on the following APIs:

• Check
• List Users
• List Objects + Streamed List Objects
• Expand
• Read

And the following SDK methods

• listRelations
• batchCheck

When introducing this option to the OpenFGAClient class, we decided that this option fits better in the options object as opposed to the request object as it's more of an "override" choice akin to the existing model ID and store ID.

So the usage looks like so

const { allowed } = await fgaClient.check({
  user: "user:anne",
  relation: "viewer",
  object: "document:roadmap",
}, { consistency: ConsistencyPreference.HigherConsistency });

I think there is a question around the correct usage for batchCheck, in that instance should the consistency choice be per check or for the entire batchCheck, currently we have it for the entire batchCheck but personally I don't think this is ideal.

await fgaClient.batchCheck([{
  user: "user:anne",
  relation: "viewer",
  object: "document:roadmap",
}], { consistency: ConsistencyPreference.HigherConsistency });

References

Review Checklist

• I have clicked on "allow edits by maintainers".
• I have added documentation for new/changed functionality in this PR or in a PR to openfga.dev [Provide a link to any relevant PRs in the references section above]
• The correct base branch is being used, if not main
• I have added tests to validate that the change in functionality is working as expected

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.13%. Comparing base (78daf78) to head (bacbd79).
Report is 5 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #129      +/-   ##
==========================================
+ Coverage   88.08%   88.13%   +0.04%     
==========================================
  Files          19       19              
  Lines         999     1003       +4     
  Branches      149      150       +1     
==========================================
+ Hits          880      884       +4     
  Misses         82       82              
  Partials       37       37              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.