fix(web): accept legacy install-key success responses

- Preserve automatic key installation across supported Unraid releases.

- Previously required a success status and message, rejecting valid legacy 2xx responses after the key could already be written.

- Accept non-array response objects with a string status, an optional string message, and no error member.

- Add historical response fixtures plus malformed and resolved-error regression coverage.

Author: Ajit-Mehrotra

web/__test__/store/installKey.test.ts

@@ -113,6 +113,33 @@ describe('InstallKey Store', () => {
       expect(store.keyType).toBe('license');
     });
 
+    it.each([
+      {
+        name: 'Unraid 6.12.15/7.0 stopped-array response',
+        response: { status: 'Please Stop array to complete key installation' },
+      },
+      {
+        name: 'Unraid 6.12.15/7.0 stopped response',
+        response: { status: '' },
+      },
+      {
+        name: 'Unraid 7.1.4 stopped response',
+        response: { status: 'success' },
+      },
+    ])('should accept the $name', async ({ response }) => {
+      mockJsonFn.mockResolvedValueOnce(response);
+
+      await store.install(
+        createTestAction({
+          type: 'purchase',
+          keyUrl: 'https://example.com/license.key',
+        })
+      );
+
+      expect(store.keyInstallStatus).toBe('success');
+      expect(mockSetError).not.toHaveBeenCalled();
+    });
+
     it('should install trialStart keys using the same install flow', async () => {
       mockJsonFn.mockResolvedValueOnce({ status: 'success', message: 'Key installed' });
       const action = createTestAction({
@@ -221,8 +248,15 @@ describe('InstallKey Store', () => {
       });
     });
 
-    it('should reject an invalid success response', async () => {
-      mockJsonFn.mockResolvedValueOnce({ success: true });
+    it.each([
+      { name: 'response without a string status', response: { success: true } },
+      { name: 'array response', response: [{ status: 'success' }] },
+      {
+        name: 'response with a non-string optional message',
+        response: { status: 'success', message: null },
+      },
+    ])('should reject a $name', async ({ response }) => {
+      mockJsonFn.mockResolvedValueOnce(response);
 
       await store.install(
         createTestAction({
@@ -240,5 +274,25 @@ describe('InstallKey Store', () => {
         type: 'installKey',
       });
     });
+
+    it('should reject a resolved response containing an error', async () => {
+      mockJsonFn.mockResolvedValueOnce({ status: 'success', error: 'download error 8' });
+
+      await store.install(
+        createTestAction({
+          type: 'purchase',
+          keyUrl: 'https://example.com/license.key',
+        })
+      );
+
+      expect(store.keyInstallStatus).toBe('failed');
+      expect(mockSetError).toHaveBeenCalledWith({
+        heading: 'Failed to install key',
+        message: 'download error 8',
+        level: 'error',
+        ref: 'installKey',
+        type: 'installKey',
+      });
+    });
   });
 });

web/src/store/installKey.ts

@@ -7,8 +7,8 @@ import { WebguiInstallKey } from '~/composables/services/webgui';
 import { useErrorsStore } from '~/store/errors';
 
 interface InstallKeySuccessResponse {
-  message: string;
-  status: 'success';
+  message?: string;
+  status: string;
 }
 
 interface InstallKeyErrorResponse {
@@ -18,10 +18,11 @@ interface InstallKeyErrorResponse {
 const isInstallKeySuccessResponse = (response: unknown): response is InstallKeySuccessResponse =>
   typeof response === 'object' &&
   response !== null &&
-  'message' in response &&
-  typeof response.message === 'string' &&
+  !Array.isArray(response) &&
   'status' in response &&
-  response.status === 'success';
+  typeof response.status === 'string' &&
+  (!('message' in response) || typeof response.message === 'string') &&
+  !('error' in response);
 
 const isInstallKeyErrorResponse = (response: unknown): response is InstallKeyErrorResponse =>
   typeof response === 'object' &&