Orchestrator 1.9 backport (#2874)

* fix(orchestrator): preserve nested extraErrors and async validation errors (#2818)

* fix(orchestrator-form): Review step with empty form data (#2834)

Empty pruned form data (e.g. display-only ActiveText) made generateReviewTableData return undefined and NestedReviewTable throw. Return {} from generateReviewTableData and guard NestedReviewTable. Add regression test and changeset.

Made-with: Cursor

* fix(orchestrator-form-react): fix ui styling issues in workflow results page (#2808)

---------

Co-authored-by: Karthik Jeeyar <karthik@redhat.com>

Author: lokanandaprabhu

workspaces/orchestrator/.changeset/fix-review-empty-formdata.md

@@ -0,0 +1,5 @@
+---
+'@red-hat-developer-hub/backstage-plugin-orchestrator-form-react': patch
+---
+
+fix: avoid Review step crash when form data is empty (for example display-only `ActiveText` with no submitted values). `generateReviewTableData` returns `{}` instead of undefined, and `NestedReviewTable` handles missing data.

workspaces/orchestrator/.changeset/new-books-matter.md

@@ -0,0 +1,5 @@
+---
+'@red-hat-developer-hub/backstage-plugin-orchestrator': patch
+---
+
+Fix UI styling issues in worfkflow results page

workspaces/orchestrator/.changeset/sharp-dots-sing.md

@@ -0,0 +1,10 @@
+---
+'@red-hat-developer-hub/backstage-plugin-orchestrator-form-widgets': patch
+'@red-hat-developer-hub/backstage-plugin-orchestrator-form-react': patch
+---
+
+Fix multi-step workflow forms dropping or misplacing async validation errors and deep nested field paths.
+
+- @red-hat-developer-hub/backstage-plugin-orchestrator-form-widgets: Fix safeSet deep paths and sequential async validation in getExtraErrors.
+
+- @red-hat-developer-hub/backstage-plugin-orchestrator-form-react: Wrap extraErrors with the active step key so RJSF matches the root schema.

workspaces/orchestrator/plugins/orchestrator-form-react/src/components/NestedReviewTable.tsx

@@ -112,9 +112,10 @@ export const NestedReviewTable: React.FC<NestedReviewTableProps> = ({
   data,
 }) => {
   const { classes } = useStyles();
+  const safeData = data ?? {};
 
   // Group top-level sections
-  const sections: [string, JsonValue][] = Object.entries(data).filter(
+  const sections: [string, JsonValue][] = Object.entries(safeData).filter(
     ([_, value]) => value !== undefined,
   ) as [string, JsonValue][];
 

workspaces/orchestrator/plugins/orchestrator-form-react/src/components/OrchestratorFormWrapper.tsx

@@ -35,6 +35,7 @@ import {
 import { useTranslation } from '../hooks/useTranslation';
 import { getActiveStepKey } from '../utils/getSortedStepEntries';
 import { useStepperContext } from '../utils/StepperContext';
+import { toRootExtraErrors } from '../utils/toRootExtraErrors';
 import useValidator from '../utils/useValidator';
 import { AuthRequester } from './AuthRequester';
 import { createHiddenFieldTemplate } from './HiddenFieldTemplate';
@@ -108,15 +109,7 @@ const FormComponent = (decoratorProps: FormDecoratorProps) => {
           extraErrorsUiSchema,
         );
 
-        if (activeKey) {
-          setExtraErrors(
-            _extraErrors?.[activeKey]
-              ? (_extraErrors[activeKey] as ErrorSchema<JsonObject>)
-              : undefined,
-          );
-        } else {
-          setExtraErrors(_extraErrors);
-        }
+        setExtraErrors(toRootExtraErrors(activeKey, _extraErrors));
       } catch (err) {
         _validationError = err as Error;
       } finally {

workspaces/orchestrator/plugins/orchestrator-form-react/src/utils/generateReviewTableData.test.ts

@@ -351,4 +351,21 @@ describe('mapSchemaToData', () => {
     const result = generateReviewTableData(schema, data);
     expect(result).toEqual(expectedResult);
   });
+
+  it('returns an empty object when form data is empty (e.g. display-only ActiveText)', () => {
+    const schema: JSONSchema7 = {
+      type: 'object',
+      title: 'Access request',
+      properties: {
+        infoMessage: {
+          type: 'string',
+          title: 'Info',
+          'ui:widget': 'ActiveText',
+        } as JSONSchema7,
+      },
+    };
+
+    const result = generateReviewTableData(schema, {});
+    expect(result).toEqual({});
+  });
 });

workspaces/orchestrator/plugins/orchestrator-form-react/src/utils/generateReviewTableData.ts

@@ -101,7 +101,8 @@ function generateReviewTableData(
     data,
     options?.includeHiddenFields ?? false,
   );
-  return result[''] as JsonObject;
+  const root = result[''] as JsonObject | undefined;
+  return root ?? {};
 }
 
 export default generateReviewTableData;

workspaces/orchestrator/plugins/orchestrator-form-react/src/utils/toRootExtraErrors.test.ts

@@ -0,0 +1,53 @@
+/*
+ * Copyright Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ERRORS_KEY } from '@rjsf/utils';
+
+import { toRootExtraErrors } from './toRootExtraErrors';
+
+describe('toRootExtraErrors', () => {
+  it('returns undefined when extraErrors is undefined', () => {
+    expect(toRootExtraErrors('my-step', undefined)).toBeUndefined();
+  });
+
+  it('returns extraErrors unchanged when activeKey is undefined', () => {
+    const tree = { a: { [ERRORS_KEY]: ['x'] } };
+    expect(toRootExtraErrors(undefined, tree)).toBe(tree);
+  });
+
+  it('wraps the active step slice so RJSF receives root-shaped errors', () => {
+    const inner = {
+      xParams: {
+        fieldA: { [ERRORS_KEY]: ['invalid A'] },
+        fieldB: { [ERRORS_KEY]: ['invalid B'] },
+      },
+    };
+    const fromGetExtraErrors = {
+      'my-solution': inner,
+    };
+    expect(toRootExtraErrors('my-solution', fromGetExtraErrors)).toEqual({
+      'my-solution': inner,
+    });
+  });
+
+  it('returns undefined when the active step has no errors in the tree', () => {
+    expect(
+      toRootExtraErrors('missing-step', {
+        'other-step': { [ERRORS_KEY]: ['e'] },
+      }),
+    ).toBeUndefined();
+  });
+});

workspaces/orchestrator/plugins/orchestrator-form-react/src/utils/toRootExtraErrors.ts

@@ -0,0 +1,41 @@
+/*
+ * Copyright Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { JsonObject } from '@backstage/types';
+
+import { ErrorSchema } from '@rjsf/utils';
+
+/**
+ * RJSF `extraErrors` must match the root `schema.properties` shape. For
+ * multi-step forms, `getExtraErrors` returns a tree keyed by step name; pass
+ * `activeKey` so the slice is wrapped again for the root form.
+ */
+export function toRootExtraErrors(
+  activeKey: string | undefined,
+  extraErrors: ErrorSchema<JsonObject> | undefined,
+): ErrorSchema<JsonObject> | undefined {
+  if (!extraErrors) {
+    return undefined;
+  }
+  if (!activeKey) {
+    return extraErrors;
+  }
+  const slice = extraErrors[activeKey];
+  if (!slice) {
+    return undefined;
+  }
+  return { [activeKey]: slice } as ErrorSchema<JsonObject>;
+}

workspaces/orchestrator/plugins/orchestrator-form-widgets/src/utils/safeSet.test.ts

@@ -0,0 +1,68 @@
+/*
+ * Copyright Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ERRORS_KEY } from '@rjsf/utils';
+
+import { safeSet } from './safeSet';
+import { JsonObject } from '@backstage/types/index';
+
+describe('safeSet', () => {
+  it('splits only on the first dot so deep paths (e.g. step.x.y) are not truncated', () => {
+    // `String.prototype.split(".", 2)` truncates remainder (e.g. "a.b.c" -> ["a","b"]);
+    // paths with three or more segments must recurse on `a` + `b.c`, not `a` + `b` only.
+    const errors: JsonObject = {};
+    safeSet(errors, 'a.b.c.d', { [ERRORS_KEY]: ['deep'] });
+    expect(errors).toEqual({
+      a: {
+        b: {
+          c: {
+            d: {
+              [ERRORS_KEY]: ['deep'],
+            },
+          },
+        },
+      },
+    });
+  });
+
+  it('sets a single-segment path', () => {
+    const errors: JsonObject = {};
+    safeSet(errors, 'onlyKey', { [ERRORS_KEY]: ['msg'] });
+    expect(errors).toEqual({ onlyKey: { [ERRORS_KEY]: ['msg'] } });
+  });
+
+  it('merges sibling leaf paths under a shared prefix when applied sequentially', () => {
+    const errors: JsonObject = {};
+    safeSet(errors, 'my-solution.xParams.fieldA', {
+      [ERRORS_KEY]: ['a'],
+    });
+    safeSet(errors, 'my-solution.xParams.fieldB', {
+      [ERRORS_KEY]: ['b'],
+    });
+    safeSet(errors, 'my-solution.xParams.fieldC', {
+      [ERRORS_KEY]: ['c'],
+    });
+    expect(errors).toEqual({
+      'my-solution': {
+        xParams: {
+          fieldA: { [ERRORS_KEY]: ['a'] },
+          fieldB: { [ERRORS_KEY]: ['b'] },
+          fieldC: { [ERRORS_KEY]: ['c'] },
+        },
+      },
+    });
+  });
+});