fix(RHOAIENG-21136): humanize K8s error messages in hardware profiles (opendatahub-io#6842)

- Add humanizeHardwareProfileError utility that translates raw K8s
  resource group references (e.g. hardwareprofiles.infrastructure.opendatahub.io)
  into user-friendly "hardware profile" language
- Special-case "already exists" errors to produce a clear duplicate-name message
- Apply translation in both create and update error handlers
- Add unit tests for all translation branches

Fixes: https://redhat.atlassian.net/browse/RHOAIENG-21136
Made-with: Cursor

Author: claudialphonse78

frontend/src/pages/hardwareProfiles/manage/ManageHardwareProfileFooter.tsx

@@ -13,6 +13,7 @@ import { HardwareProfileFormData } from '#~/pages/hardwareProfiles/manage/types'
 import { createHardwareProfile, updateHardwareProfile } from '#~/api';
 import useNotification from '#~/utilities/useNotification';
 import { useDashboardNamespace } from '#~/redux/selectors';
+import { humanizeHardwareProfileError } from '#~/pages/hardwareProfiles/manage/utils';
 
 type ManageHardwareProfileFooterProps = {
   state: HardwareProfileFormData;
@@ -60,7 +61,7 @@ const ManageHardwareProfileFooter: React.FC<ManageHardwareProfileFooterProps> =
         navigate(redirectPath);
       })
       .catch((err) => {
-        setErrorMessage(err.message);
+        setErrorMessage(humanizeHardwareProfileError(err.message));
       })
       .finally(() => {
         setIsLoading(false);
@@ -84,7 +85,7 @@ const ManageHardwareProfileFooter: React.FC<ManageHardwareProfileFooterProps> =
         .then(() => Promise.all(getUpdatePromises(false)))
         .then(() => navigate(redirectPath))
         .catch((err) => {
-          setErrorMessage(err.message);
+          setErrorMessage(humanizeHardwareProfileError(err.message));
         })
         .finally(() => {
           setIsLoading(false);

frontend/src/pages/hardwareProfiles/manage/__tests__/utils.spec.ts

@@ -0,0 +1,30 @@
+import { humanizeHardwareProfileError } from '#~/pages/hardwareProfiles/manage/utils';
+
+describe('humanizeHardwareProfileError', () => {
+  it('should return a friendly message when a duplicate name error includes a quoted name', () => {
+    const k8sError = 'hardwareprofiles.infrastructure.opendatahub.io "my-profile" already exists';
+    expect(humanizeHardwareProfileError(k8sError)).toBe(
+      'A hardware profile with the name "my-profile" already exists. Please use a different name.',
+    );
+  });
+
+  it('should return a friendly message when a duplicate name error has no quoted name', () => {
+    const k8sError = 'the resource already exists';
+    expect(humanizeHardwareProfileError(k8sError)).toBe(
+      'A hardware profile with this name already exists. Please use a different name.',
+    );
+  });
+
+  it('should replace K8s resource group references in non-duplicate errors', () => {
+    const k8sError =
+      'hardwareprofiles.infrastructure.opendatahub.io is forbidden: User cannot create';
+    expect(humanizeHardwareProfileError(k8sError)).toBe(
+      'hardware profile is forbidden: User cannot create',
+    );
+  });
+
+  it('should pass through unrelated error messages unchanged', () => {
+    const genericError = 'Network error: connection refused';
+    expect(humanizeHardwareProfileError(genericError)).toBe(genericError);
+  });
+});

frontend/src/pages/hardwareProfiles/manage/utils.ts

@@ -0,0 +1,13 @@
+const K8S_RESOURCE_PATTERN = /hardwareprofiles\.\S+/gi;
+
+export const humanizeHardwareProfileError = (message: string): string => {
+  if (/already exists/i.test(message)) {
+    const nameMatch = message.match(/"([^"]+)"/);
+    const name = nameMatch?.[1];
+    return name
+      ? `A hardware profile with the name "${name}" already exists. Please use a different name.`
+      : 'A hardware profile with this name already exists. Please use a different name.';
+  }
+
+  return message.replace(K8S_RESOURCE_PATTERN, 'hardware profile');
+};