Overhault Nitro CLI docs

src/Nitro/CommandLine/src/CommandLine/Commands/Launch/LaunchCommand.cs

@@ -3,6 +3,7 @@
 #endif
 
 using ChilliCream.Nitro.CommandLine.Helpers;
+using ChilliCream.Nitro.CommandLine.Services.Sessions;
 
 namespace ChilliCream.Nitro.CommandLine.Commands.Launch;
 
@@ -27,10 +28,36 @@ private static Task<int> ExecuteAsync(
         CancellationToken cancellationToken)
     {
         var console = services.GetRequiredService<INitroConsole>();
+        var sessionService = services.GetRequiredService<ISessionService>();
+        var browser = services.GetRequiredService<IBrowserLauncher>();
 
-        SystemBrowser.Open(Constants.NitroWebUrl);
-        console.OkLine($"[link={Constants.NitroWebUrl}]Nitro[/] is launched!");
+        var url = ResolveUrl(sessionService.Session);
+
+        browser.Open(url);
+        console.OkLine($"[link={url}]Nitro[/] is launched!");
 
         return Task.FromResult(ExitCodes.Success);
     }
+
+    private static string ResolveUrl(Session? session)
+    {
+        if (session is null)
+        {
+            return Constants.NitroWebUrl;
+        }
+
+        var defaultApiUrl = Constants.ApiUrl["https://".Length..];
+
+        if (session.ApiUrl == defaultApiUrl || session.ApiUrl == Constants.ApiUrl)
+        {
+            return Constants.NitroWebUrl;
+        }
+
+        var baseUrl = session.ApiUrl.StartsWith("https://", StringComparison.OrdinalIgnoreCase)
+                || session.ApiUrl.StartsWith("http://", StringComparison.OrdinalIgnoreCase)
+            ? session.ApiUrl
+            : $"https://{session.ApiUrl}";
+
+        return $"{baseUrl.TrimEnd('/')}/ui";
+    }
 }

src/Nitro/CommandLine/src/CommandLine/Extensions/ServiceCollectionExtensions.cs

@@ -1,3 +1,4 @@
+using ChilliCream.Nitro.CommandLine.Helpers;
 using ChilliCream.Nitro.CommandLine.Results;
 using ChilliCream.Nitro.CommandLine.Services;
 using ChilliCream.Nitro.CommandLine.Services.Configuration;
@@ -21,6 +22,8 @@ public static IServiceCollection AddNitroServices(this IServiceCollection servic
         services.TryAddSingleton<IResultHolder, ResultHolder>();
         services.TryAddSingleton<IResultFormatter, JsonResultFormatter>();
 
+        services.TryAddSingleton<IBrowserLauncher, SystemBrowserLauncher>();
+
         return services;
     }
 }

src/Nitro/CommandLine/src/CommandLine/Helpers/Constants.cs

@@ -4,9 +4,6 @@ internal static class Constants
 {
     public const int DefaultPrintWidth = 1_000;
 
-    // 5 Minutes
-    public const int DefaultTimeoutSec = 60 * 5;
-
     public const string NitroWebUrl = "https://nitro.chillicream.com";
 
     public const string ApiUrl = "https://api.chillicream.com";

src/Nitro/CommandLine/src/CommandLine/Helpers/IBrowserLauncher.cs

@@ -0,0 +1,6 @@
+namespace ChilliCream.Nitro.CommandLine.Helpers;
+
+internal interface IBrowserLauncher
+{
+    void Open(string url);
+}

src/Nitro/CommandLine/src/CommandLine/Helpers/SystemBrowserLauncher.cs

@@ -0,0 +1,6 @@
+namespace ChilliCream.Nitro.CommandLine.Helpers;
+
+internal sealed class SystemBrowserLauncher : IBrowserLauncher
+{
+    public void Open(string url) => SystemBrowser.Open(url);
+}

src/Nitro/CommandLine/src/CommandLine/Options/BaseSchemaFileOption.cs

@@ -6,7 +6,7 @@ public BaseSchemaFileOption() : base("--schema")
     {
         Description = "The path to the graphql file with the schema";
         Required = true;
-        this.DefaultFileFromEnvironmentValue("SCHEMA_FILE");
+        this.DefaultFileFromEnvironmentValue(EnvironmentVariables.SchemaFile);
         this.LegalFilePathsOnly();
     }
 }

src/Nitro/CommandLine/src/CommandLine/Options/EnvironmentVariables.cs

@@ -33,4 +33,6 @@ internal static class EnvironmentVariables
     public const string TreatDangerousAsBreaking = "TREAT_DANGEROUS_AS_BREAKING";
     public const string AllowBreakingSchemaChanges = "ALLOW_BREAKING_SCHEMA_CHANGES";
     public const string OperationsFile = "OPERATIONS_FILE";
+    public const string SchemaFile = "SCHEMA_FILE";
+    public const string SchemaExtensionFile = "SCHEMA_EXTENSION_FILE";
 }

src/Nitro/CommandLine/src/CommandLine/Options/ExtensionFileOption.cs

@@ -6,7 +6,7 @@ public ExtensionFileOption() : base("--extension")
     {
         Description = "The path to the graphql file with the schema extension";
         Required = true;
-        this.DefaultFileFromEnvironmentValue("SCHEMA_EXTENSION_FILE");
+        this.DefaultFileFromEnvironmentValue(EnvironmentVariables.SchemaExtensionFile);
         this.LegalFilePathsOnly();
     }
 }

src/Nitro/CommandLine/src/CommandLine/Options/SchemaFileOption.cs

@@ -6,7 +6,7 @@ public SchemaFileOption() : base("--schema-file")
     {
         Description = "The path to the graphql file with the schema definition";
         Required = true;
-        this.DefaultFileFromEnvironmentValue("SCHEMA_FILE");
+        this.DefaultFileFromEnvironmentValue(EnvironmentVariables.SchemaFile);
         this.LegalFilePathsOnly();
     }
 }

src/Nitro/CommandLine/test/CommandLine.Tests/Commands/CommandTestBase.cs

@@ -48,6 +48,7 @@ public abstract class CommandTestBase
     protected readonly Mock<IEnvironmentsClient> EnvironmentsClientMock = new(MockBehavior.Strict);
     protected readonly Mock<IStagesClient> StagesClientMock = new(MockBehavior.Strict);
     internal readonly Mock<Services.Sessions.ISessionService> _sessionServiceMock = new();
+    internal readonly Mock<IBrowserLauncher> BrowserLauncherMock = new();
     protected readonly Mock<IWorkspacesClient> WorkspacesClientMock = new(MockBehavior.Strict);
     private InteractionMode _interactionMode = InteractionMode.NonInteractive;
     private bool _authenticated = true;
@@ -225,6 +226,7 @@ private ServiceProvider BuildServices(INitroConsole console)
         services.Replace(ServiceDescriptor.Singleton(_fileSystemMock.Object));
         services.Replace(ServiceDescriptor.Singleton(_environmentVariableProviderMock.Object));
         services.Replace(ServiceDescriptor.Singleton(_sessionServiceMock.Object));
+        services.Replace(ServiceDescriptor.Singleton(BrowserLauncherMock.Object));
         services.Replace(ServiceDescriptor.Singleton(WorkspacesClientMock.Object));
         services.Replace(ServiceDescriptor.Singleton(SchemasClientMock.Object));
         services.Replace(ServiceDescriptor.Singleton(FusionConfigurationClientMock.Object));

src/Nitro/CommandLine/test/CommandLine.Tests/Commands/Session/LaunchCommandTests.cs

@@ -0,0 +1,95 @@
+using ChilliCream.Nitro.CommandLine.Helpers;
+using Moq;
+
+namespace ChilliCream.Nitro.CommandLine.Tests.Commands.Session;
+
+public sealed class LaunchCommandTests(NitroCommandFixture fixture) : SessionCommandTestBase(fixture)
+{
+    [Fact]
+    public async Task Help_ReturnsSuccess()
+    {
+        // arrange & act
+        var result = await ExecuteCommandAsync(
+            "launch",
+            "--help");
+
+        // assert
+        result.AssertHelpOutput(
+            """
+            Description:
+              Launch Nitro in your default browser.
+
+            Usage:
+              nitro launch [options]
+
+            Options:
+              -?, -h, --help  Show help and usage information
+
+            Example:
+              nitro launch
+            """);
+    }
+
+    [Fact]
+    public async Task NoSession_OpensDefaultNitroWebUrl()
+    {
+        // arrange
+        SetupInteractionMode(InteractionMode.Interactive);
+
+        // act
+        var result = await ExecuteCommandAsync("launch");
+
+        // assert
+        Assert.Equal(0, result.ExitCode);
+        BrowserLauncherMock.Verify(x => x.Open(Constants.NitroWebUrl), Times.Once);
+    }
+
+    [Fact]
+    public async Task DefaultApiUrl_OpensDefaultNitroWebUrl()
+    {
+        // arrange
+        SetupInteractionMode(InteractionMode.Interactive);
+        SetupCustomSession();
+
+        // act
+        var result = await ExecuteCommandAsync("launch");
+
+        // assert
+        Assert.Equal(0, result.ExitCode);
+        BrowserLauncherMock.Verify(x => x.Open(Constants.NitroWebUrl), Times.Once);
+    }
+
+    [Fact]
+    public async Task CustomApiUrl_OpensBaseUrlSlashUi()
+    {
+        // arrange
+        SetupInteractionMode(InteractionMode.Interactive);
+        SetupCustomSession(
+            apiUrl: "api.custom.com",
+            identityUrl: "https://id.custom.com");
+
+        // act
+        var result = await ExecuteCommandAsync("launch");
+
+        // assert
+        Assert.Equal(0, result.ExitCode);
+        BrowserLauncherMock.Verify(x => x.Open("https://api.custom.com/ui"), Times.Once);
+    }
+
+    [Fact]
+    public async Task CustomApiUrlWithScheme_OpensBaseUrlSlashUi()
+    {
+        // arrange
+        SetupInteractionMode(InteractionMode.Interactive);
+        SetupCustomSession(
+            apiUrl: "https://api.custom.com",
+            identityUrl: "https://id.custom.com");
+
+        // act
+        var result = await ExecuteCommandAsync("launch");
+
+        // assert
+        Assert.Equal(0, result.ExitCode);
+        BrowserLauncherMock.Verify(x => x.Open("https://api.custom.com/ui"), Times.Once);
+    }
+}