feat(api): restructure versioning information in GraphQL schema

- Introduced new CoreVersions and PackageVersions types to encapsulate core system and software package version details.
- Updated InfoVersions type to include references to CoreVersions and PackageVersions.
- Modified the versions resolver to return structured version information.
- Added a new query for fetching version information in the frontend.
- Updated the HeaderOsVersion component to display the new version information.
- Created a ReleaseNotesModal component for viewing OS release notes.

Author: elibosley

api/dev/configs/api.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.13.1",
+  "version": "4.14.0",
   "extraOrigins": [],
   "sandbox": true,
   "ssoSubIds": [],

api/generated-schema.graphql

@@ -1501,12 +1501,18 @@ type InfoBaseboard implements Node {
   memSlots: Float
 }
 
-type InfoVersions implements Node {
-  id: PrefixedID!
+type CoreVersions {
+  """Unraid version"""
+  unraid: String
+
+  """Unraid API version"""
+  api: String
 
   """Kernel version"""
   kernel: String
+}
 
+type PackageVersions {
   """OpenSSL version"""
   openssl: String
 
@@ -1590,9 +1596,16 @@ type InfoVersions implements Node {
 
   """Docker version"""
   docker: String
+}
 
-  """Unraid version"""
-  unraid: String
+type InfoVersions implements Node {
+  id: PrefixedID!
+
+  """Core system versions"""
+  core: CoreVersions!
+
+  """Software package versions"""
+  packages: PackageVersions!
 }
 
 type Info implements Node {

api/src/unraid-api/cli/generated/graphql.ts

@@ -1041,6 +1041,8 @@ export type InfoVersions = Node & {
   __typename?: 'InfoVersions';
   /** Apache version */
   apache?: Maybe<Scalars['String']['output']>;
+  /** Unraid API version */
+  api?: Maybe<Scalars['String']['output']>;
   /** Docker version */
   docker?: Maybe<Scalars['String']['output']>;
   /** gcc version */

api/src/unraid-api/graph/resolvers/info/info.module.ts

@@ -8,6 +8,8 @@ import { DisplayService } from '@app/unraid-api/graph/resolvers/info/display/dis
 import { InfoResolver } from '@app/unraid-api/graph/resolvers/info/info.resolver.js';
 import { MemoryService } from '@app/unraid-api/graph/resolvers/info/memory/memory.service.js';
 import { OsService } from '@app/unraid-api/graph/resolvers/info/os/os.service.js';
+import { CoreVersionsResolver } from '@app/unraid-api/graph/resolvers/info/versions/core-versions.resolver.js';
+import { VersionsResolver } from '@app/unraid-api/graph/resolvers/info/versions/versions.resolver.js';
 import { VersionsService } from '@app/unraid-api/graph/resolvers/info/versions/versions.service.js';
 import { ServicesModule } from '@app/unraid-api/graph/services/services.module.js';
 
@@ -19,6 +21,8 @@ import { ServicesModule } from '@app/unraid-api/graph/services/services.module.j
 
         // Sub-resolvers
         DevicesResolver,
+        VersionsResolver,
+        CoreVersionsResolver,
 
         // Services
         CpuService,
@@ -28,6 +32,6 @@ import { ServicesModule } from '@app/unraid-api/graph/services/services.module.j
         VersionsService,
         DisplayService,
     ],
-    exports: [InfoResolver, DevicesResolver, DisplayService],
+    exports: [InfoResolver, DevicesResolver, VersionsResolver, CoreVersionsResolver, DisplayService],
 })
 export class InfoModule {}

api/src/unraid-api/graph/resolvers/info/info.resolver.integration.spec.ts

@@ -169,12 +169,7 @@ describe('InfoResolver Integration Tests', () => {
             const result = await infoResolver.versions();
 
             expect(result).toHaveProperty('id', 'info/versions');
-            expect(result).toHaveProperty('unraid');
-            expect(result).toHaveProperty('kernel');
-            expect(result).toHaveProperty('node');
-            expect(result).toHaveProperty('npm');
-            // Verify unraid version from mock
-            expect(result.unraid).toBe('6.12.0');
+            // Versions now returns a stub object, with actual data resolved via field resolvers
         });
     });
 

api/src/unraid-api/graph/resolvers/info/info.resolver.ts

@@ -94,7 +94,7 @@ export class InfoResolver {
     }
 
     @ResolveField(() => InfoVersions)
-    public async versions(): Promise<InfoVersions> {
+    public versions(): Partial<InfoVersions> {
         return this.versionsService.generateVersions();
     }
 }

api/src/unraid-api/graph/resolvers/info/versions/core-versions.resolver.ts

@@ -0,0 +1,14 @@
+import { ResolveField, Resolver } from '@nestjs/graphql';
+
+import { versions } from 'systeminformation';
+
+import { CoreVersions } from '@app/unraid-api/graph/resolvers/info/versions/versions.model.js';
+
+@Resolver(() => CoreVersions)
+export class CoreVersionsResolver {
+    @ResolveField(() => String, { nullable: true })
+    async kernel(): Promise<string | undefined> {
+        const softwareVersions = await versions();
+        return softwareVersions.kernel;
+    }
+}

api/src/unraid-api/graph/resolvers/info/versions/get-api-version.ts

@@ -0,0 +1,20 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+let cachedVersion: string | undefined;
+
+export function getApiVersion(): string {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+
+    try {
+        const packagePath = join(process.cwd(), 'package.json');
+        const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        cachedVersion = packageJson.version || 'unknown';
+        return cachedVersion;
+    } catch (error) {
+        console.error('Failed to read API version from package.json:', error);
+        return 'unknown';
+    }
+}

api/src/unraid-api/graph/resolvers/info/versions/versions.model.ts

@@ -2,11 +2,20 @@ import { Field, ObjectType } from '@nestjs/graphql';
 
 import { Node } from '@unraid/shared/graphql.model.js';
 
-@ObjectType({ implements: () => Node })
-export class InfoVersions extends Node {
+@ObjectType()
+export class CoreVersions {
+    @Field(() => String, { nullable: true, description: 'Unraid version' })
+    unraid?: string;
+
+    @Field(() => String, { nullable: true, description: 'Unraid API version' })
+    api?: string;
+
     @Field(() => String, { nullable: true, description: 'Kernel version' })
     kernel?: string;
+}
 
+@ObjectType()
+export class PackageVersions {
     @Field(() => String, { nullable: true, description: 'OpenSSL version' })
     openssl?: string;
 
@@ -90,7 +99,13 @@ export class InfoVersions extends Node {
 
     @Field(() => String, { nullable: true, description: 'Docker version' })
     docker?: string;
+}
 
-    @Field(() => String, { nullable: true, description: 'Unraid version' })
-    unraid?: string;
+@ObjectType({ implements: () => Node })
+export class InfoVersions extends Node {
+    @Field(() => CoreVersions, { description: 'Core system versions' })
+    core!: CoreVersions;
+
+    @Field(() => PackageVersions, { description: 'Software package versions' })
+    packages!: PackageVersions;
 }

api/src/unraid-api/graph/resolvers/info/versions/versions.resolver.ts

@@ -0,0 +1,63 @@
+import { ConfigService } from '@nestjs/config';
+import { ResolveField, Resolver } from '@nestjs/graphql';
+
+import { versions } from 'systeminformation';
+
+import {
+    CoreVersions,
+    InfoVersions,
+    PackageVersions,
+} from '@app/unraid-api/graph/resolvers/info/versions/versions.model.js';
+
+@Resolver(() => InfoVersions)
+export class VersionsResolver {
+    constructor(private readonly configService: ConfigService) {}
+
+    @ResolveField(() => CoreVersions)
+    core(): CoreVersions {
+        const unraid = this.configService.get<string>('store.emhttp.var.version') || 'unknown';
+        const api = this.configService.get<string>('api.version') || 'unknown';
+
+        return {
+            unraid,
+            api,
+            kernel: undefined, // Will be resolved separately if requested
+        };
+    }
+
+    @ResolveField(() => PackageVersions)
+    async packages(): Promise<PackageVersions> {
+        const softwareVersions = await versions();
+
+        return {
+            openssl: softwareVersions.openssl,
+            systemOpenssl: softwareVersions.systemOpenssl,
+            node: softwareVersions.node,
+            v8: softwareVersions.v8,
+            npm: softwareVersions.npm,
+            yarn: softwareVersions.yarn,
+            pm2: softwareVersions.pm2,
+            gulp: softwareVersions.gulp,
+            grunt: softwareVersions.grunt,
+            git: softwareVersions.git,
+            tsc: softwareVersions.tsc,
+            mysql: softwareVersions.mysql,
+            redis: softwareVersions.redis,
+            mongodb: softwareVersions.mongodb,
+            apache: (softwareVersions as any).apache,
+            nginx: softwareVersions.nginx,
+            php: softwareVersions.php,
+            postfix: softwareVersions.postfix,
+            postgresql: softwareVersions.postgresql,
+            perl: softwareVersions.perl,
+            python: softwareVersions.python,
+            python3: softwareVersions.python3,
+            pip: softwareVersions.pip,
+            pip3: softwareVersions.pip3,
+            java: softwareVersions.java,
+            gcc: softwareVersions.gcc,
+            virtualbox: softwareVersions.virtualbox,
+            docker: softwareVersions.docker,
+        };
+    }
+}