add an overload for AuthenticateAsPanaClientAsync which accepts route-B credentials via the Action<IBufferWriter<byte>> instead of ReadOnlyMemory<byte>

Author: smdn

src/Smdn.Net.SkStackIP/Smdn.Net.SkStackIP/SkStackClient.Functions.PANA.AuthenticateAsPaC.cs

@@ -23,13 +23,31 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
     ReadOnlyMemory<byte> password,
     SkStackActiveScanOptions? scanOptions = null,
     CancellationToken cancellationToken = default
+  )
+    => AuthenticateAsPanaClientAsync(
+      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
+      writePassword: CreateActionForWritingPassword(password, nameof(password)),
+      scanOptions: scanOptions,
+      cancellationToken: cancellationToken
+    );
+
+  /// <inheritdoc cref="AuthenticateAsPanaClientAsyncCore"/>
+  /// <param name="writeRBID">A delegate to write Route-B ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="writePassword">A delegate to write password ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="scanOptions">Options such as scanning behavior when performing active scanning.</param>
+  /// <param name="cancellationToken">The <see cref="CancellationToken" /> to monitor for cancellation requests.</param>
+  public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
+    Action<IBufferWriter<byte>> writeRBID,
+    Action<IBufferWriter<byte>> writePassword,
+    SkStackActiveScanOptions? scanOptions = null,
+    CancellationToken cancellationToken = default
   )
   {
     ThrowIfPanaSessionAlreadyEstablished();
 
     return AuthenticateAsPanaClientAsyncCore(
-      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
-      writePassword: CreateActionForWritingPassword(password, nameof(password)),
+      writeRBID: writeRBID ?? throw new ArgumentNullException(nameof(writeRBID)),
+      writePassword: writePassword ?? throw new ArgumentNullException(nameof(writePassword)),
       getPaaAddressTask: default,
       channel: null,
       panId: null,
@@ -54,8 +72,8 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
     CancellationToken cancellationToken = default
   )
     => AuthenticateAsPanaClientAsync(
-      rbid: rbid,
-      password: password,
+      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
+      writePassword: CreateActionForWritingPassword(password, nameof(password)),
       paaAddress: paaAddress,
       channel: SkStackChannel.FindByChannelNumber(channelNumber, nameof(channelNumber)),
       panId: panId,
@@ -76,6 +94,30 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
     SkStackChannel channel,
     int panId,
     CancellationToken cancellationToken = default
+  )
+    => AuthenticateAsPanaClientAsync(
+      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
+      writePassword: CreateActionForWritingPassword(password, nameof(password)),
+      paaAddress: paaAddress,
+      channel: channel,
+      panId: panId,
+      cancellationToken: cancellationToken
+    );
+
+  /// <inheritdoc cref="AuthenticateAsPanaClientAsyncCore"/>
+  /// <param name="writeRBID">A delegate to write Route-B ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="writePassword">A delegate to write password ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="paaAddress">An <see cref="IPAddress"/> representing the IP address of the PANA Authentication Agent (PAA).</param>
+  /// <param name="channel">A <see cref="SkStackChannel"/> representing the channel to be used for PANA session.</param>
+  /// <param name="panId">A Personal Area Network (PAN) ID to be used for PANA session.</param>
+  /// <param name="cancellationToken">The <see cref="CancellationToken" /> to monitor for cancellation requests.</param>
+  public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
+    Action<IBufferWriter<byte>> writeRBID,
+    Action<IBufferWriter<byte>> writePassword,
+    IPAddress paaAddress,
+    SkStackChannel channel,
+    int panId,
+    CancellationToken cancellationToken = default
   )
   {
     ThrowIfPanaSessionAlreadyEstablished();
@@ -84,8 +126,8 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
       throw new ArgumentException(message: "invalid channel (empty channel)", paramName: nameof(channel));
 
     return AuthenticateAsPanaClientAsyncCore(
-      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
-      writePassword: CreateActionForWritingPassword(password, nameof(password)),
+      writeRBID: writeRBID ?? throw new ArgumentNullException(nameof(writeRBID)),
+      writePassword: writePassword ?? throw new ArgumentNullException(nameof(writePassword)),
       getPaaAddressTask: new(paaAddress ?? throw new ArgumentNullException(nameof(paaAddress))),
       channel: channel,
       panId: ValidatePanIdAndThrowIfInvalid(panId, nameof(panId)),
@@ -114,6 +156,26 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
       cancellationToken: cancellationToken
     );
 
+  /// <inheritdoc cref="AuthenticateAsPanaClientAsyncCore"/>
+  /// <param name="writeRBID">A delegate to write Route-B ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="writePassword">A delegate to write password ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="pan">A <see cref="SkStackPanDescription"/> representing the address of the PANA Authentication Agent (PAA), PAN ID, and channel used for PANA session.</param>
+  /// <param name="cancellationToken">The <see cref="CancellationToken" /> to monitor for cancellation requests.</param>
+  public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
+    Action<IBufferWriter<byte>> writeRBID,
+    Action<IBufferWriter<byte>> writePassword,
+    SkStackPanDescription pan,
+    CancellationToken cancellationToken = default
+  )
+    => AuthenticateAsPanaClientAsync(
+      writeRBID: writeRBID,
+      writePassword: writePassword,
+      paaMacAddress: pan.MacAddress,
+      channel: pan.Channel,
+      panId: pan.Id,
+      cancellationToken: cancellationToken
+    );
+
   /// <inheritdoc cref="AuthenticateAsPanaClientAsyncCore"/>
   /// <param name="rbid">A Route-B ID used for PANA authentication.</param>
   /// <param name="password">A password ID used for PANA authentication.</param>
@@ -130,8 +192,8 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
     CancellationToken cancellationToken = default
   )
     => AuthenticateAsPanaClientAsync(
-      rbid: rbid,
-      password: password,
+      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
+      writePassword: CreateActionForWritingPassword(password, nameof(password)),
       paaMacAddress: paaMacAddress,
       channel: SkStackChannel.FindByChannelNumber(channelNumber, nameof(channelNumber)),
       panId: panId,
@@ -152,13 +214,37 @@ public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
     SkStackChannel channel,
     int panId,
     CancellationToken cancellationToken = default
+  )
+    => AuthenticateAsPanaClientAsync(
+      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
+      writePassword: CreateActionForWritingPassword(password, nameof(password)),
+      paaMacAddress: paaMacAddress,
+      channel: channel,
+      panId: panId,
+      cancellationToken: cancellationToken
+    );
+
+  /// <inheritdoc cref="AuthenticateAsPanaClientAsyncCore"/>
+  /// <param name="writeRBID">A delegate to write Route-B ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="writePassword">A delegate to write password ID used for PANA authentication to the <see cref="IBufferWriter{Byte}"/>.</param>
+  /// <param name="paaMacAddress">A <see cref="PhysicalAddress"/> representing the MAC address of the PANA Authentication Agent (PAA).</param>
+  /// <param name="channel">A <see cref="SkStackChannel"/> representing the channel to be used for PANA session.</param>
+  /// <param name="panId">A Personal Area Network (PAN) ID to be used for PANA session.</param>
+  /// <param name="cancellationToken">The <see cref="CancellationToken" /> to monitor for cancellation requests.</param>
+  public ValueTask<SkStackPanaSessionInfo> AuthenticateAsPanaClientAsync(
+    Action<IBufferWriter<byte>> writeRBID,
+    Action<IBufferWriter<byte>> writePassword,
+    PhysicalAddress paaMacAddress,
+    SkStackChannel channel,
+    int panId,
+    CancellationToken cancellationToken = default
   )
   {
     ThrowIfPanaSessionAlreadyEstablished();
 
     return AuthenticateAsPanaClientAsyncCore(
-      writeRBID: CreateActionForWritingRBID(rbid, nameof(rbid)),
-      writePassword: CreateActionForWritingPassword(password, nameof(password)),
+      writeRBID: writeRBID ?? throw new ArgumentNullException(nameof(writeRBID)),
+      writePassword: writePassword ?? throw new ArgumentNullException(nameof(writePassword)),
 #pragma warning disable CA2012, CS8620
       getPaaAddressTask: ConvertToIPv6LinkLocalAddressAsync(
         paaMacAddress ?? throw new ArgumentNullException(nameof(paaMacAddress)),