feature: notify when a game plugin auto updates, and let it be turned off

hasura/metadata/actions.graphql

@@ -1864,6 +1864,13 @@ type Mutation {
   ): SuccessOutput
 }
 
+type Mutation {
+  setGamePluginAutoUpdate(
+    slug: String!
+    enabled: Boolean!
+  ): SuccessOutput
+}
+
 type Mutation {
   reconcileNodePlugins(
     nodeId: String!

hasura/metadata/actions.yaml

@@ -1187,6 +1187,14 @@ actions:
     permissions:
       - role: administrator
     comment: Remove a game plugin from a node's plugin store
+  - name: setGamePluginAutoUpdate
+    definition:
+      kind: synchronous
+      handler: '{{HASURA_GRAPHQL_ACTIONS_HOOK}}'
+      forward_client_headers: true
+    permissions:
+      - role: administrator
+    comment: Track new releases of a game plugin, or pin it where it is
   - name: reconcileNodePlugins
     definition:
       kind: synchronous

hasura/metadata/databases/default/tables/public_game_server_node_plugins.yaml

@@ -24,6 +24,7 @@ select_permissions:
         - runtime
         - version
         - detected_version
+        - previous_version
         - channel
         - status
         - source
@@ -46,6 +47,7 @@ insert_permissions:
         - runtime
         - version
         - detected_version
+        - previous_version
         - channel
         - status
         - source
@@ -62,6 +64,7 @@ update_permissions:
         - runtime
         - version
         - detected_version
+        - previous_version
         - channel
         - status
         - source

hasura/migrations/default/1880000004000_game_plugin_update_tracking/down.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "public"."game_server_node_plugins"
+    DROP COLUMN IF EXISTS "previous_version";

hasura/migrations/default/1880000004000_game_plugin_update_tracking/up.sql

@@ -0,0 +1,6 @@
+-- An Auto channel install changes version with nobody asking it to, and the row
+-- only ever held where it landed. Without the version it came from there is no
+-- record that anything moved -- the API overwrites `version` the moment a node
+-- reports Installing, so the old value is gone before the install finishes.
+ALTER TABLE "public"."game_server_node_plugins"
+    ADD COLUMN IF NOT EXISTS "previous_version" text;

src/game-plugins/game-plugins.controller.ts

@@ -46,8 +46,9 @@ export class GamePluginsController {
     @Body()
     body: {
       slug: string;
-      status: "Installing" | "Failed" | "Removing";
+      status: "Installing" | "Installed" | "Failed" | "Removing";
       version?: string | null;
+      previousVersion?: string | null;
       error?: string | null;
     },
   ) {
@@ -109,6 +110,22 @@ export class GamePluginsController {
     return { success: true };
   }
 
+  // Auto is what installing gives you, so the toggle is the only way back to a
+  // pinned version -- and the only way to say "yes, I meant it" about a plugin
+  // that changes underneath the fleet on its own.
+  @HasuraAction()
+  public async setGamePluginAutoUpdate(data: {
+    user: User;
+    slug: string;
+    enabled: boolean;
+  }) {
+    this.assertAdministrator(data.user);
+
+    await this.gamePlugins.setAutoUpdate(data.slug, data.enabled);
+
+    return { success: true };
+  }
+
   @HasuraAction()
   public async uninstallGamePlugin(data: {
     user: User;

src/game-plugins/game-plugins.module.ts

@@ -16,13 +16,15 @@ import { GameModesService } from "./game-modes.service";
 import { GamePluginsController } from "./game-plugins.controller";
 import { SyncGamePluginRegistry } from "./jobs/SyncGamePluginRegistry";
 import { CheckGamePluginUpdates } from "./jobs/CheckGamePluginUpdates";
+import { NotifyGamePluginUpdate } from "./jobs/NotifyGamePluginUpdate";
 
 @Module({
   providers: [
     GamePluginsService,
     GameModesService,
     SyncGamePluginRegistry,
     CheckGamePluginUpdates,
+    NotifyGamePluginUpdate,
     ...getQueuesProcessors("GamePlugins"),
     loggerFactory(),
     Logger,