- Expose RagnarokClient on INgrokHostedService

- Add extension method to open tunnel using TunnelDetail

Author: 0phios

src/Ragnarok.AgentApi/Helpers/Extensions/RagnorokClientExtensions.cs

@@ -67,6 +67,31 @@ public static async Task<TunnelDetail> ConnectAsync(this RagnarokClient client,
             return await ConnectAsync(client, definition.Value, authToken, cancellationToken);
         }
 
+        /// <summary>
+        /// Start ngrok and open a tunnel
+        /// </summary>
+        /// <param name="client">An instance of <see cref="RagnarokClient"/></param>
+        /// <param name="details"><see cref="TunnelDetail"/> to replicate</param>
+        /// <param name="authToken">Authorization token to register in ngrok.yml</param>
+        /// <param name="cancellationToken">Propagates notification that operations should be canceled</param>
+        /// <remarks>
+        /// Creates a new tunnel based on properties defined in the provided <see cref="TunnelDetail"/> <br/>
+        /// <see cref="RagnarokClient.InitializeAsync"/> will be called if not previously executed
+        /// </remarks>
+        public static async Task<TunnelDetail> ConnectAsync(this RagnarokClient client, TunnelDetail details, 
+                                                            string authToken = null, CancellationToken cancellationToken = default)
+        {
+            return await ConnectAsync(client, options =>
+            {
+                options.Name = details.Name;
+                options.Protocol = details.Proto;
+                options.Address = details.Config.Address;
+                options.BindTLS = details.Proto == TunnelProtocol.HTTP ? BindTLS.False : BindTLS.True;
+            }, 
+            authToken: authToken,
+            cancellationToken: cancellationToken);
+        }
+
         /// <summary>
         /// Start ngrok and open a tunnel
         /// </summary>

src/Ragnarok.HostedService/Contracts/INgrokHostedService.cs

@@ -1,4 +1,6 @@
 using Microsoft.Extensions.Hosting;
+using Ragnarok.AgentApi;
+using Ragnarok.HostedService.Models;
 using System;
 
 namespace Ragnarok.HostedService.Contracts
@@ -10,6 +12,11 @@ public interface INgrokHostedService : IHostedService
         /// <summary>
         /// Raised when all tunnels have been created
         /// </summary>
-        event EventHandler Ready;
+        event EventHandler<ReadyEventArgs> Ready;
+
+        /// <summary>
+        /// An instance of <see cref="RagnarokClient"/> that provides access to the ngrok client process and the ngrok Agent Api
+        /// </summary>
+        public RagnarokClient RagnarokClient { get; }
     }
 }

src/Ragnarok.HostedService/NgrokHostedService.cs

@@ -23,7 +23,7 @@ public class NgrokHostedService : INgrokHostedService, IDisposable
         /// <summary>
         /// <inheritdoc/>
         /// </summary>
-        public event EventHandler Ready;
+        public event EventHandler<ReadyEventArgs> Ready;
 
         /// <summary>
         /// Raises the <see cref="Ready"/> event
@@ -32,7 +32,7 @@ public class NgrokHostedService : INgrokHostedService, IDisposable
         protected virtual void OnReady(IEnumerable<TunnelDetail> tunnels) => Ready?.Invoke(this, new ReadyEventArgs() { Tunnels = tunnels });
 
         /// <summary>
-        /// An instance of <see cref="RagnarokClient"/> that provides access to the ngrok client process and the ngrok Agent Api
+        /// <inheritdoc/>
         /// </summary>
         public RagnarokClient RagnarokClient { get; }