Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/backend/Progmasoft.Tala.Website.Api/Program.cs
blob: 7d2187925a94c65cfcb07886c10a98d6be60b512 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
// SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com>
// SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1

using Progmasoft.Tala.Website.Api;

WebApplication application = SiteApplication.Build(args);
application.Run();

namespace Progmasoft.Tala.Website.Api
{
    /// <summary>
    /// The language website's API: the site's own public state and a liveness probe. It has no account, package,
    /// publication or registry endpoint; Progmaweb owns those.
    /// </summary>
    public static class SiteApplication
    {
        /// <summary>The port the service listens on when the <c>PORT</c> variable names none.</summary>
        public const int DefaultPort = 5086;

        /// <summary>
        /// Builds the application. It listens on the loopback interface only; Nginx is the public side.
        /// </summary>
        /// <param name="args">The command-line arguments of the process.</param>
        /// <returns>The configured application, not yet running.</returns>
        public static WebApplication Build(string[] args)
        {
            WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
            int port = int.TryParse(Environment.GetEnvironmentVariable("PORT"), out int configured)
                && configured is > 0 and < 65536
                    ? configured
                    : DefaultPort;
            builder.WebHost.UseUrls($"http://127.0.0.1:{port}");
            builder.Logging.ClearProviders();
            builder.Logging.AddConsole();

            WebApplication application = builder.Build();
            Map(application);
            return application;
        }

        /// <summary>Maps the endpoints of the site onto <paramref name="routes"/>.</summary>
        /// <param name="routes">The application or route group that receives the endpoints.</param>
        public static void Map(IEndpointRouteBuilder routes)
        {
            routes.MapGet("/api/v1/site", () => Results.Json(SiteInformation.Current));
            // The service manager only needs to know that the process answers; no build or host data is disclosed.
            routes.MapGet("/health", () => Results.Ok());
        }
    }
}