Adding ExportReplace to support the Context object [breaking change for 1.0]

[element-of-surprise]

This PR adds support for the Context object in caches that are implementing a cache.

We cannot update ExportReplace without breaking implementors, so we are introducing an ExportReplaceCtx as a superset.

Calls that use methods from ExportReplace will now check for the existence of ExportReplaceCtx and use those superset methods instead if available.

[chlowell]

I added some changes to help get this to the finish line:

• retarget to dev branch
• add Context parameters and error returns to existing methods--breaking compatibility--instead of adding new methods (closes Replace any *Ctx methods with the original method names #379)
• methods accessing the cache fail on cache I/O errors and propagate those errors
  • I changed some functions to use named return params so they can return errors from deferred functions. I'm not fond of that syntax, feel free to suggest better ideas

[bgavrilMS]

Consider naming the id accountId instead of homeAccountId. The concept of "home" implies tenancy, which is only in AAD. ADFS doesn't have this. And as we expand to other IdPs, they likely won't have this either.

[element-of-surprise]

As discussed, clothe the returns and ignore my comment on the named returns, I apparently was too tired to be doing reviews, I now see the defer with assignments.

This is approved, however since I created this thing and you are finishing it, I can't approve it.

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
5 Code Smells

No Coverage information
0.0% Duplication