v12 to v13 migration guide doesn't contain information about ISocketSessionInterceptor interface changes

[eddex]

Is there an existing issue for this?

• I have searched the existing issues

Product

Hot Chocolate

Describe the bug

In my project I use an implementation of the ISocketSessionInterceptor to do authentication of the websocket sessions.

After updating from HotChocolate 12 to 13, the ISocketSessionInterceptor interface has changed.

It would be great to have a section about the interface changes in the migration docs.

My main issue is that the OnConnectAsync method's message parameter (in v13 connectionInitMessage) has changed type from InitializeConnectionMessage to IOperationMessagePayload. I was using the message.Payload property which is not there anymore on the new interface-type. I'm not sure how to fix this.

Steps to reproduce

1. Use HotChocolate v12
2. Use the ISocketSessionInterceptor interface
3. Update to HotChocolate v13
4. Implementation is broken

Relevant log output

No response

Additional Context?

If I figure out how to fix this, I'll gladly add the information to the migration guide myself and create a PR.

Version

13.7.0

[eddex]

It seems like the v13 documentation for the ISocketSessionInterceptor is also outdated: https://chillicream.com/docs/hotchocolate/v13/server/interceptors/#isocketsessioninterceptor

[eddex]

I found below example in the tests. I'm assuming that I have to create a class that has a property with the same name as the property in my payload. Will test this as soon as I'm done with the rest of the migration.

graphql-platform/src/HotChocolate/AspNetCore/test/AspNetCore.Tests/Subscriptions/GraphQLOverWebSocket/WebSocketProtocolTests.cs

Lines 898 to 919 in e1db3a3

	private class AuthInterceptor : DefaultSocketSessionInterceptor
	{
	public override ValueTask<ConnectionStatus> OnConnectAsync(
	ISocketSession session,
	IOperationMessagePayload connectionInitMessage,
	CancellationToken cancellationToken = default)
	{
	var payload = connectionInitMessage.As<Auth>();
	if (payload?.Token is not null)
	{
	return base.OnConnectAsync(session, connectionInitMessage, cancellationToken);
	}
	return new(ConnectionStatus.Reject());
	}
	private sealed class Auth
	{
	public string? Token { get; set; }
	}
	}