Created API + Deployment Setup for Starting and Endpoint for Getting Website HTML

.gitignore

@@ -1,2 +1,8 @@
 .swiftlint.yml
 .swiftformat
+infra/docker-secrets/*
+.env
+.env.*
+!.env.example
+!.env.example.*
+.fly.toml

API/.env.example

@@ -0,0 +1,3 @@
+SELENIUM_GRID_HUB_BASE=
+FLY_METRICS_TOKEN=
+

API/.env.example.cli

@@ -0,0 +1,2 @@
+ENVIRONMENT=
+

API/.env.example.testing

@@ -0,0 +1,2 @@
+SELENIUM_GRID_HUB_BASE=
+FLY_METRICS_TOKEN=

API/.gitignore

@@ -6,7 +6,4 @@ DerivedData/
 .DS_Store
 db.sqlite
 .swiftpm
-.env
-.env.*
-!.env.example
 default.profraw

API/Dockerfile

@@ -12,13 +12,17 @@ RUN export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true \
 # Set up a build area
 WORKDIR /build
 
+RUN --mount=type=secret,id=GITHUB_SSH_AUTHENTICATION_TOKEN \
+    TOKEN=$(cat /run/secrets/GITHUB_SSH_AUTHENTICATION_TOKEN) && \
+    git config --global url."https://x-access-token:${TOKEN}@github.com/".insteadOf "https://github.com/"
+
 # First just resolve dependencies.
 # This creates a cached layer that can be reused
 # as long as your Package.swift/Package.resolved
 # files do not change.
 COPY ./Package.* ./
 RUN swift package resolve \
-        $([ -f ./Package.resolved ] && echo "--force-resolved-versions" || true)
+    $([ -f ./Package.resolved ] && echo "--force-resolved-versions" || true)
 
 # Copy entire repo into container
 COPY . .
@@ -29,9 +33,9 @@ RUN mkdir /staging
 # N.B.: The static version of jemalloc is incompatible with the static Swift runtime.
 RUN --mount=type=cache,target=/build/.build \
     swift build -c release \
-        --product API \
-        --static-swift-stdlib \
-        -Xlinker -ljemalloc && \
+    --product API \
+    --static-swift-stdlib \
+    -Xlinker -ljemalloc && \
     # Copy main executable to staging area
     cp "$(swift build -c release --show-bin-path)/API" /staging && \
     # Copy resources bundled by SPM to staging area
@@ -59,13 +63,13 @@ RUN export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true \
     && apt-get -q update \
     && apt-get -q dist-upgrade -y \
     && apt-get -q install -y \
-      libjemalloc2 \
-      ca-certificates \
-      tzdata \
-# If your app or its dependencies import FoundationNetworking, also install `libcurl4`.
-      # libcurl4 \
-# If your app or its dependencies import FoundationXML, also install `libxml2`.
-      # libxml2 \
+    libjemalloc2 \
+    ca-certificates \
+    tzdata \
+    # If your app or its dependencies import FoundationNetworking, also install `libcurl4`.
+    libcurl4 \
+    # If your app or its dependencies import FoundationXML, also install `libxml2`.
+    # libxml2 \
     && rm -r /var/lib/apt/lists/*
 
 # Create a vapor user and group with /app as its home directory

API/Sources/API/Controllers/APIController.swift

@@ -0,0 +1,46 @@
+// APIController.swift
+// Copyright (c) 2025 GetAutomaApp
+// All source code and related assets are the property of GetAutomaApp.
+// All rights reserved.
+
+import AutomaUtilities
+import Vapor
+
+internal struct APIController: RouteCollection {
+    public func boot(routes: any RoutesBuilder) throws {
+        let twitterRoute = routes.grouped("api")
+        twitterRoute.get(use: get)
+        twitterRoute.post(use: post)
+        twitterRoute.put(use: put)
+        twitterRoute.patch(use: patch)
+        twitterRoute.delete(use: delete)
+    }
+
+    @Sendable
+    public func get(req: Request) async throws -> String {
+        let payload = try req.content.decode(AutomaWebCoreAPIEndpointPayload.self)
+        return try await WebBrowserClient(logger: req.logger, payload: payload).getHTML()
+    }
+
+    // Endpoints where implementation becomes required when making any type of request (GET, POST, etc)
+    // with a body and headers becomes necessary for the next version of the app
+    @Sendable
+    public func post(req _: Request) async throws -> String {
+        "hello world"
+    }
+
+    @Sendable
+    public func put(req _: Request) async throws -> String {
+        "hello world"
+    }
+
+    @Sendable
+    public func patch(req _: Request) async throws -> String {
+        "hello world"
+    }
+
+    @Sendable
+    public func delete(req _: Request) async throws -> String {
+        "hello world"
+    }
+}

API/Sources/API/DataTypes/APIError.swift

@@ -0,0 +1,8 @@
+// APIError.swift
+// Copyright (c) 2025 GetAutomaApp
+// All source code and related assets are the property of GetAutomaApp.
+// All rights reserved.
+
+internal enum APIError: Error {
+    case webBrowserClientError(error: String)
+}

API/Sources/API/DataTypes/WebCoreMetric.swift

@@ -0,0 +1,25 @@
+// WebCoreMetric.swift
+// Copyright (c) 2025 GetAutomaApp
+// All source code and related assets are the property of GetAutomaApp.
+// All rights reserved.
+
+import AutomaUtilities
+import Foundation
+import Prometheus
+
+internal enum APIMetric {
+    public static func getWebsiteHTMLCall(
+        websiteUrl: URL,
+        jsRender: Bool,
+        status: MetricStatus
+    ) -> Prometheus.Counter {
+        MetricsService.global.makeCounter(
+            name: "get_website_html_call",
+            labels: [
+                "status": status.rawValue,
+                "website_url": websiteUrl.absoluteString,
+                "js_render": "\(jsRender)",
+            ]
+        )
+    }
+}