1 files changed, 32 insertions, 4 deletions

diff --git a/src/DotNetOpenId/Extensions/IExtension.cs b/src/DotNetOpenId/Extensions/IExtension.cs
index 2450a8a..e43565a 100644
--- a/src/DotNetOpenId/Extensions/IExtension.cs
+++ b/src/DotNetOpenId/Extensions/IExtension.cs
@@ -11,6 +11,22 @@ namespace DotNetOpenId.Extensions {
 		/// Gets the TypeURI the extension uses in the OpenID protocol and in XRDS advertisements.

 		/// </summary>

 		string TypeUri { get; }

+		/// <summary>

+		/// Additional TypeURIs that are supported by this extension, in preferred order.

+		/// May be empty if none other than <see cref="TypeUri"/> is supported, but

+		/// should not be null.

+		/// </summary>

+		/// <remarks>

+		/// Useful for reading in messages with an older version of an extension.

+		/// The value in the <see cref="TypeUri"/> property is always checked before

+		/// trying this list.

+		/// If you do support multiple versions of an extension using this method,

+		/// consider adding a CreateResponse method to your request extension class

+		/// so that the response can have the context it needs to remain compatible

+		/// given the version of the extension in the request message.

+		/// The <see cref="SimpleRegistration.ClaimsRequest.CreateResponse"/> for an example.

+		/// </remarks>

+		IEnumerable<string> AdditionalSupportedTypeUris { get; }

 	}

 

 	/// <summary>

@@ -26,8 +42,14 @@ namespace DotNetOpenId.Extensions {
 		/// <summary>

 		/// Reads the extension information on an authentication request to the provider.

 		/// </summary>

-		/// <returns>True if the extension found any of its parameters in the request, false otherwise.</returns>

-		bool Deserialize(IDictionary<string, string> fields, Provider.IRequest request);

+		/// <param name="fields">The fields belonging to the extension.</param>

+		/// <param name="request">The incoming OpenID request carrying the extension.</param>

+		/// <param name="typeUri">The actual extension TypeUri that was recognized in the message.</param>

+		/// <returns>

+		/// True if the extension found a valid set of recognized parameters in the request, 

+		/// false otherwise.

+		/// </returns>

+		bool Deserialize(IDictionary<string, string> fields, Provider.IRequest request, string typeUri);

 	}

 

 	/// <summary>

@@ -43,7 +65,13 @@ namespace DotNetOpenId.Extensions {
 		/// <summary>

 		/// Reads a Provider's response for extension values.

 		/// </summary>

-		/// <returns>True if the extension found any of its parameters in the response.</returns>

-		bool Deserialize(IDictionary<string, string> fields, RelyingParty.IAuthenticationResponse response);

+		/// <param name="fields">The fields belonging to the extension.</param>

+		/// <param name="response">The incoming OpenID response carrying the extension.</param>

+		/// <param name="typeUri">The actual extension TypeUri that was recognized in the message.</param>

+		/// <returns>

+		/// True if the extension found a valid set of recognized parameters in the response, 

+		/// false otherwise.

+		/// </returns>

+		bool Deserialize(IDictionary<string, string> fields, RelyingParty.IAuthenticationResponse response, string typeUri);

 	}

 }