Context Support

[sc-ivanlieckens]

Description / Motivation

This allows creating connections to the Edge using the Edge Platform Context instead of an ApiKey. It introduces new extension methods on the SitecoreLayoutClientBuilder called AddGraphQlWithContextHandler for the LayoutService.Client and enhances the extensions on GraphQlConfiguration called AddGraphQlClient for the GraphQL. Introducing ContextId to the SitecoreGraphQlClientOptions as well as by default using the https://edge-platform.sitecorecloud.io/v1/content/api/graphql/v1 endpoint instead of throwing an exception when passing in a ContextId.

Moving forward Sitecore and XM Cloud in particular will greatly rely on the unified Edge Platform endpoint with ContextId making this an important addition to the SDK.

This resolves #10

Testing

• The Unit & Intergration tests are passing.
• I have added the necessary tests to cover my changes.

Terms

• I agree to follow this project's Code of Conduct.

[robearlam]

@sc-ivanlieckens This all looks good, one question I had was whether we want to handle the developer making a mistake and providing all config sections for both ContextId approach and ApiKey approach.

Should we throw an exception in that case, like we do when both are missing, to force the developer to tidy it up and be explicit about the approach they want to use?

[sc-ivanlieckens]

@sc-ivanlieckens This all looks good, one question I had was whether we want to handle the developer making a mistake and providing all config sections for both ContextId approach and ApiKey approach.

Should we throw an exception in that case, like we do when both are missing, to force the developer to tidy it up and be explicit about the approach they want to use?

Actually I don't want to prevent that, it might be a very rare case but you might want to be running 1 site off XM on-prem and 1 site from XMC with the same head. You're simply registering handlers and which handler is the default is your choice and you can configure as you like/need. Does that make sense?