feat: Add client method to handle loading a ref

[pnwpedro]

Description

• Add IClient.LoadRefAsync(BaseRef reference) method. This will load a ref by querying Fauna, or return the loaded value if it's already present.

Motivation and context

BT-5137

If a user has a reference to a document, allow a low effort way of materializing it.

How was the change tested?

Add e2e tests

Screenshots (if appropriate):

Change types

• • Bug fix (non-breaking change that fixes an issue)
• • New feature (non-breaking change that adds functionality)
• • Breaking change (backwards-incompatible fix or feature)

Checklist:

• • My code follows the code style of this project.
• • My change requires a change to Fauna documentation.
• • My change requires a change to the README, and I have updated it accordingly.

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[github-actions]

Summary

Summary

Generated on:	10/09/2024 - 16:04:34
Parser:	OpenCover
Assemblies:	1
Classes:	118
Files:	93
Line coverage:	80.9% (3120 of 3855)
Covered lines:	3120
Uncovered lines:	735
Coverable lines:	3855
Total lines:	8567
Branch coverage:	70.8% (1005 of 1418)
Covered branches:	1005
Total branches:	1418
Method coverage:	Feature is only available for sponsors
Tag:	34c8ccd

Coverage

Fauna - 80.9%

Name	Line	Branch
Fauna	80.9%	70.8%
Fauna.BaseClient	83.3%	72.2%
Fauna.Client	73.4%	52.9%
Fauna.Configuration	100%	100%
Fauna.Core.Connection	94.1%	72.2%
Fauna.Core.Endpoints	100%	100%
Fauna.Core.ErrorInfo	100%
Fauna.Core.QueryFailure	100%	66.6%
Fauna.Core.QueryOptions	82.1%	81.8%
Fauna.Core.QueryResponse	70%	77.2%
Fauna.Core.QueryStats	57.1%
Fauna.Core.QuerySuccess`1	69.2%	50%
Fauna.Core.RetryConfiguration	100%	100%
Fauna.Core.Stats	100%
Fauna.Core.StatsCollector	86.2%	100%
Fauna.Core.StreamEnumerable`1	100%	66.6%
Fauna.Exceptions.AbortException	100%	83.3%
Fauna.Exceptions.AuthenticationException	100%
Fauna.Exceptions.AuthorizationException	100%
Fauna.Exceptions.BadGatewayException	0%
Fauna.Exceptions.ConstraintFailure	100%
Fauna.Exceptions.ConstraintFailureException	100%
Fauna.Exceptions.ContendedTransactionException	100%
Fauna.Exceptions.ExceptionHandler	84.3%	89.3%
Fauna.Exceptions.FaunaException	25%
Fauna.Exceptions.InvalidRequestException	100%
Fauna.Exceptions.NetworkException	100%
Fauna.Exceptions.NullDocumentException	100%	100%
Fauna.Exceptions.ProtocolException	0%
Fauna.Exceptions.QueryCheckException	100%
Fauna.Exceptions.QueryRuntimeException	100%
Fauna.Exceptions.QueryTimeoutException	100%
Fauna.Exceptions.SerializationException	100%
Fauna.Exceptions.ServiceException	80.9%
Fauna.Exceptions.ThrottlingException	42.8%
Fauna.Exceptions.TimeoutException	100%
Fauna.IQueryFragmentExtensions	0%
Fauna.Linq.DataContext	84.1%	87.5%
Fauna.Linq.DataContextBuilder`1	92.1%	86.6%
Fauna.Linq.IntermediateQueryHelpers	80%	83.3%
Fauna.Linq.IPipelineExecutor	55.2%	28.2%
Fauna.Linq.IQuerySource	0%	0%
Fauna.Linq.LookupTable	40%	16.6%
Fauna.Linq.MappedDeserializer`2	75%
Fauna.Linq.Pipeline	100%	100%
Fauna.Linq.ProjectionAnalysisVisitor	96.1%	87.5%
Fauna.Linq.ProjectionDeserializer	80.9%	58.3%
Fauna.Linq.ProjectionRewriteVisitor	100%	100%
Fauna.Linq.QuerySource	100%
Fauna.Linq.QuerySource`1	93.7%	90.7%
Fauna.Linq.QuerySourceExtensions	25%	50%
Fauna.Linq.SubQuerySwitch	56.7%	19.4%
Fauna.Mapping.BaseFieldAttribute	100%
Fauna.Mapping.CollectionAttribute	100%
Fauna.Mapping.FieldAttribute	100%
Fauna.Mapping.FieldInfo	100%	91.6%
Fauna.Mapping.FieldName	100%	100%
Fauna.Mapping.IdAttribute	100%	50%
Fauna.Mapping.IgnoreAttribute	100%
Fauna.Mapping.MappingContext	100%	100%
Fauna.Mapping.MappingInfo	96.5%	100%
Fauna.Mapping.TsAttribute	100%
Fauna.Query	100%
Fauna.QueryArr	58.6%	50%
Fauna.QueryExpr	80%	50%
Fauna.QueryLiteral	86.1%	62.5%
Fauna.QueryObj	32.1%	0%
Fauna.QueryStringHandler	100%	100%
Fauna.QueryVal	79.5%	50%
Fauna.Serialization.BaseRefSerializer`1	82.8%	78.5%
Fauna.Serialization.BaseSerializer`1	18.7%	0%
Fauna.Serialization.BooleanSerializer	92.3%	83.3%
Fauna.Serialization.ByteSerializer	92.3%	83.3%
Fauna.Serialization.ClassSerializer`1	83.6%	80.9%
Fauna.Serialization.DateOnlySerializer	92.3%	83.3%
Fauna.Serialization.DateTimeOffsetSerializer	92.3%	83.3%
Fauna.Serialization.DateTimeSerializer	92.3%	83.3%
Fauna.Serialization.DictionarySerializer`1	84%	75%
Fauna.Serialization.DoubleSerializer	92.3%	83.3%
Fauna.Serialization.DynamicSerializer	90.7%	75%
Fauna.Serialization.FloatSerializer	92.3%	83.3%
Fauna.Serialization.IntSerializer	92.3%	83.3%
Fauna.Serialization.ListSerializer`1	85%	66.6%
Fauna.Serialization.LongSerializer	92.3%	83.3%
Fauna.Serialization.ModuleSerializer	30.7%	16.6%
Fauna.Serialization.NamedRefSerializer`1	100%
Fauna.Serialization.NullableSerializer`1	100%	100%
Fauna.Serialization.NullableStructSerializer`1	100%	100%
Fauna.Serialization.PageSerializer`1	92.1%	87.5%
Fauna.Serialization.QueryArrSerializer	0%	0%
Fauna.Serialization.QueryExprSerializer	77.7%	66.6%
Fauna.Serialization.QueryLiteralSerializer	55.5%	50%
Fauna.Serialization.QueryObjSerializer	69.2%	50%
Fauna.Serialization.QuerySerializer	60%	50%
Fauna.Serialization.QueryValSerializer	69.2%	50%
Fauna.Serialization.RefSerializer`1	100%
Fauna.Serialization.SByteSerializer	92.3%	83.3%
Fauna.Serialization.Serializer	90.3%	82.2%
Fauna.Serialization.ShortSerializer	92.3%	83.3%
Fauna.Serialization.StreamSerializer	57.1%	50%
Fauna.Serialization.StringSerializer	92.8%	87.5%
Fauna.Serialization.UIntSerializer	92.3%	83.3%
Fauna.Serialization.UShortSerializer	92.3%	83.3%
Fauna.Serialization.Utf8FaunaReader	72.6%	77.8%
Fauna.Serialization.Utf8FaunaWriter	90.1%
Fauna.StreamOptions	61.5%
Fauna.Types.BaseRef`1	55%
Fauna.Types.BaseRefBuilder`1	95%	81.8%
Fauna.Types.Event`1	85.4%	66.6%
Fauna.Types.Module	52.6%	20%
Fauna.Types.NamedRef`1	60%	62.5%
Fauna.Types.Page`1	100%
Fauna.Types.Ref`1	60%	62.5%
Fauna.Types.Stream	66.6%	35.7%
Fauna.Util.DefaultExpressionSwitch`1	0%
Fauna.Util.Expressions	100%	100%
Fauna.Util.ExpressionSwitch`1	84.8%	75.5%
Fauna.Util.Extensions.PaginationExtensions	100%	100%
Fauna.Util.Extensions.TypeExtensions	93.3%	81.2%

Delta Summary

Generated on:	10/09/2024 - 16:04
Description	Previous	Current	Delta
Coverage date:	10/09/2024 - 16:03	10/09/2024 - 16:04
Tag:	main	34c8ccd
Line coverage:	80.7%	80.9%	0.2%
Covered lines:	3106	3120	14
Coverable lines:	3847	3855	8
Total lines:	14836	14875	39
Branch coverage:	70.7%	70.8%	0.1%
Covered branches:	1002	1005	3
Total branches:	1416	1418	2
Method coverage:	Feature is only available for sponsors