feat(svc): add servers database

errors/servers/servers/servers_multiple_port_routers.md

@@ -0,0 +1,9 @@
+---
+name = "SERVERS_MULTIPLE_PORT_ROUTERS"
+description = "Multiple server port routers were provided."
+http_status = 400
+---
+
+# Multiple Server Port Routers
+
+Multiple server port routers were provided.

errors/servers/servers/servers_multiple_runtimes.md

@@ -0,0 +1,9 @@
+---
+name = "SERVERS_MULTIPLE_RUNTIMES"
+description = "Multiple server runtimes were provided."
+http_status = 400
+---
+
+# Multiple Server Runtimes
+
+Multiple server runtimes were provided.

errors/servers/servers/servers_no_port_routers.md

@@ -0,0 +1,9 @@
+---
+name = "SERVERS_NO_PORT_ROUTERS"
+description = "No port routers were provided."
+http_status = 400
+---
+
+# No Port Routers
+
+No port routers were provided.

errors/servers/servers/servers_no_runtime.md

@@ -0,0 +1,9 @@
+---
+name = "SERVERS_NO_RUNTIME"
+description = "No server runtime were provided."
+http_status = 400
+---
+
+# No Server Runtime
+
+No server runtime were provided.

fern/definition/cloud/games/tokens.yml

@@ -12,6 +12,14 @@ service:
         game_id:
           type: uuid
       response: CreateCloudTokenResponse
+    createServiceToken:
+      path: /games/{game_id}/tokens/service
+      method: POST
+      docs: Creates a new game service token.
+      path-parameters:
+        game_id:
+          type: uuid
+      response: CreateCloudTokenResponse
 
 types:
   CreateCloudTokenResponse:
@@ -22,3 +30,9 @@ types:
           Slightly modified to include a description prefix and use Protobufs of
           JSON.
         type: string
+  CreateServiceTokenResponse:
+    properties:
+      token:
+        docs: |-
+          A JSON Web Token.
+        type: string

fern/definition/dynamic-servers/common.yml

@@ -0,0 +1,78 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/fern-api/fern/main/fern.schema.json
+
+types:
+  Server:
+    properties:
+      server_id: uuid
+      game_id: uuid
+      datacenter_id: uuid
+      cluster_id: uuid
+      metadata: unknown
+      resources: Resources
+      kill_timeout:
+        docs: >-
+          The duration to wait for in milliseconds before killing the server.
+          This should be set to a safe default, and can be overridden during a
+          DELETE request if needed.
+        type: optional<long>
+      runtime: Runtime
+      create_ts: long
+      destroy_ts: optional<long>
+
+  Resources:
+    properties:
+      cpu:
+        docs: |
+          The number of CPU cores in millicores, or 1/1000 of a core. For example,
+          1/8 of a core would be 125 millicores, and 1 core would be 1000
+          millicores.
+        type: integer
+      memory:
+        docs: The amount of memory in megabytes
+        type: integer
+
+  Runtime:
+    properties:
+      docker: optional<DockerRuntime>
+
+  DockerRuntime:
+    properties:
+      image_id: uuid
+      args: optional<list<string>>
+      environment: optional<map<string, string>>
+      network: DockerNetwork
+
+  DockerNetwork:
+    properties:
+      mode: optional<DockerNetworkMode>
+      ports: map<string, DockerPort>
+
+  DockerNetworkMode:
+    enum:
+      - bridge
+      - host
+
+  DockerPort:
+    properties:
+      port: optional<integer>
+      routing: DockerPortRouting
+
+  DockerPortRouting:  
+    properties:
+      game_guard: optional<DockerGameGuardRouting>
+      host: optional<DockerHostRouting>
+
+  DockerGameGuardRouting:
+    properties:
+      protocol: optional<GameGuardProtocol>
+
+  GameGuardProtocol:
+    enum:
+      - http
+      - https
+      - tcp
+      - tcp_tls
+      - udp
+
+  DockerHostRouting:
+    properties: {}

fern/definition/dynamic-servers/servers.yml

@@ -0,0 +1,59 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/fern-api/fern/main/fern.schema.json
+
+imports:
+  commons: common.yml
+
+service:
+  auth: true
+  base-path: /dynamic-servers/servers
+  endpoints:
+    create:
+      path: ""
+      method: POST
+      docs: Create a new dynamic server.
+      request:
+        body: CreateServerRequest
+      response: CreateServerResponse
+    destroy:
+      path: "/{server_id}"
+      method: DELETE
+      docs: Destroy a dynamic server.
+      path-parameters:
+        server_id:
+          docs: The id of the server to destroy
+          type: uuid
+      request:
+        name: DestroyServerRequest
+        query-parameters:
+          override_kill_timeout:
+            docs: >-
+              The duration to wait for in milliseconds before killing the server.
+              This should be used to override the default kill timeout if a faster
+              time is needed, say for ignoring a graceful shutdown.
+            type: optional<long>
+      response: DestroyServerResponse
+
+types:
+  CreateServerRequest:
+    properties:
+      datacenter:
+        docs: The name ID of the datacenter
+        type: string
+      metadata: unknown
+      resources: commons.Resources
+      kill_timeout:
+        docs: >-
+          The duration to wait for in milliseconds before killing the server.
+          This should be set to a safe default, and can be overridden during a
+          DELETE request if needed.
+        type: optional<long>
+      runtime: commons.Runtime
+  CreateServerResponse:
+    properties:
+      server:
+        docs: The server that was created
+        type: commons.Server
+  DestroyServerResponse:
+    properties:
+      server_id:
+        type: uuid