[PAGE LAYOUTS] Add widgets validation (#16635)

- Add widget validation - Remove 'None' option for primary axis group by - Fix error message parsing by passing the operation type in `useMetadataErrorHandler`
2026-01-07 16:00:13 +01:00
parent 701a713042
commit 4faed25624
71 changed files with 4004 additions and 1220 deletions
@@ -0,0 +1,9 @@
+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';
+
+export const VALID_GRAPH_CONFIGURATION_TYPES = [
+  WidgetConfigurationType.AGGREGATE_CHART,
+  WidgetConfigurationType.BAR_CHART,
+  WidgetConfigurationType.LINE_CHART,
+  WidgetConfigurationType.PIE_CHART,
+  WidgetConfigurationType.GAUGE_CHART,
+] as const;
@@ -0,0 +1,6 @@
+import { type GraphConfiguration } from './graph-configuration.type';
+
+export type BaseGraphConfiguration = Pick<
+  GraphConfiguration,
+  'configurationType' | 'aggregateFieldMetadataId' | 'aggregateOperation'
+>;
@@ -0,0 +1,12 @@
+import { type AggregateChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/aggregate-chart-configuration.dto';
+import { type BarChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/bar-chart-configuration.dto';
+import { type GaugeChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/gauge-chart-configuration.dto';
+import { type LineChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/line-chart-configuration.dto';
+import { type PieChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/pie-chart-configuration.dto';
+
+export type GraphConfiguration =
+  | BarChartConfigurationDTO
+  | LineChartConfigurationDTO
+  | PieChartConfigurationDTO
+  | AggregateChartConfigurationDTO
+  | GaugeChartConfigurationDTO;
@@ -0,0 +1,6 @@
+import { type WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';
+
+export type IframeConfiguration = {
+  configurationType?: WidgetConfigurationType;
+  url?: string;
+};
@@ -0,0 +1,22 @@
+import { type msg } from '@lingui/core/macro';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type WidgetType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-type.enum';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const rejectWidgetType = (
+  widgetType: WidgetType,
+  message: string,
+  userFriendlyMessage: ReturnType<typeof msg>,
+) => {
+  return (): FlatPageLayoutWidgetValidationError[] => {
+    return [
+      {
+        code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+        message,
+        value: widgetType,
+        userFriendlyMessage,
+      },
+    ];
+  };
+};
@@ -0,0 +1,31 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type BarChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/bar-chart-configuration.dto';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateBarChartConfiguration = (
+  configuration: BarChartConfigurationDTO,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.primaryAxisGroupByFieldMetadataId)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Primary axis group by field is required for bar chart widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Primary axis group by field is required for bar chart`,
+    });
+  }
+
+  if (!isDefined(configuration.layout)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Layout is required for bar chart widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Layout is required for bar chart`,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,31 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type BaseGraphConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/base-graph-configuration.type';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateBaseGraphFields = (
+  configuration: BaseGraphConfiguration,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.aggregateFieldMetadataId)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Aggregate field metadata ID is required for graph widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Aggregate field is required for graph widget`,
+    });
+  }
+
+  if (!isDefined(configuration.aggregateOperation)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Aggregate operation is required for graph widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Aggregate operation is required for graph widget`,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,27 @@
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type GraphConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/graph-configuration.type';
+import { validateBarChartConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-bar-chart-configuration.util';
+import { validateLineChartConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-line-chart-configuration.util';
+import { validatePieChartConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-pie-chart-configuration.util';
+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';
+
+export const validateGraphConfigurationByType = (
+  configuration: GraphConfiguration,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const configurationType = configuration.configurationType;
+
+  switch (configurationType) {
+    case WidgetConfigurationType.BAR_CHART:
+      return validateBarChartConfiguration(configuration, widgetTitle);
+    case WidgetConfigurationType.LINE_CHART:
+      return validateLineChartConfiguration(configuration, widgetTitle);
+    case WidgetConfigurationType.PIE_CHART:
+      return validatePieChartConfiguration(configuration, widgetTitle);
+    case WidgetConfigurationType.AGGREGATE_CHART:
+    case WidgetConfigurationType.GAUGE_CHART:
+      return [];
+    default:
+      return [];
+  }
+};
@@ -0,0 +1,44 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { VALID_GRAPH_CONFIGURATION_TYPES } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/constants/valid-graph-configuration-types.constant';
+import { type GraphConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/graph-configuration.type';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateGraphConfigurationType = (
+  configuration: GraphConfiguration,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.configurationType)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Configuration type is required for widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Configuration type is required`,
+    });
+
+    return errors;
+  }
+
+  const isValidGraphConfigurationType =
+    VALID_GRAPH_CONFIGURATION_TYPES.includes(configuration.configurationType);
+
+  if (!isValidGraphConfigurationType) {
+    const expectedConfigurationTypes = VALID_GRAPH_CONFIGURATION_TYPES.map(
+      (type) => type.toString(),
+    ).join(', ');
+
+    const configurationTypeString = configuration.configurationType.toString();
+
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Invalid configuration type for graph widget "${widgetTitle}". Expected one of ${expectedConfigurationTypes}, got ${configurationTypeString}`,
+      userFriendlyMessage: msg`Invalid configuration type for graph widget`,
+      value: configuration.configurationType,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,54 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type ValidateFlatPageLayoutWidgetTypeSpecificitiesForCreationArgs } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type GraphConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/graph-configuration.type';
+import { validateBaseGraphFields } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-base-graph-fields.util';
+import { validateGraphConfigurationByType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-graph-configuration-by-type.util';
+import { validateGraphConfigurationType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-graph-configuration-type.util';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateGraphFlatPageLayoutWidgetForCreation = (
+  args: ValidateFlatPageLayoutWidgetTypeSpecificitiesForCreationArgs,
+): FlatPageLayoutWidgetValidationError[] => {
+  const { flatEntityToValidate } = args;
+  const { configuration, title } = flatEntityToValidate;
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Configuration is required for graph widget "${title}"`,
+      userFriendlyMessage: msg`Configuration is required for graph widget`,
+    });
+
+    return errors;
+  }
+
+  const graphConfiguration = configuration as GraphConfiguration;
+
+  const configurationTypeErrors = validateGraphConfigurationType(
+    graphConfiguration,
+    title,
+  );
+
+  errors.push(...configurationTypeErrors);
+
+  if (configurationTypeErrors.length > 0) {
+    return errors;
+  }
+
+  const baseFieldErrors = validateBaseGraphFields(graphConfiguration, title);
+
+  errors.push(...baseFieldErrors);
+
+  const typeSpecificErrors = validateGraphConfigurationByType(
+    graphConfiguration,
+    title,
+  );
+
+  errors.push(...typeSpecificErrors);
+
+  return errors;
+};
@@ -0,0 +1,46 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { type ValidateFlatPageLayoutWidgetTypeSpecificitiesForUpdateArgs } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type GraphConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/graph-configuration.type';
+import { validateBaseGraphFields } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-base-graph-fields.util';
+import { validateGraphConfigurationByType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-graph-configuration-by-type.util';
+import { validateGraphConfigurationType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-graph-configuration-type.util';
+
+export const validateGraphFlatPageLayoutWidgetForUpdate = (
+  args: ValidateFlatPageLayoutWidgetTypeSpecificitiesForUpdateArgs,
+): FlatPageLayoutWidgetValidationError[] => {
+  const { flatEntityToValidate } = args;
+  const { configuration, title } = flatEntityToValidate;
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration)) {
+    return [];
+  }
+
+  const graphConfiguration = configuration as GraphConfiguration;
+
+  const configurationTypeErrors = validateGraphConfigurationType(
+    graphConfiguration,
+    title,
+  );
+
+  errors.push(...configurationTypeErrors);
+
+  if (configurationTypeErrors.length > 0) {
+    return errors;
+  }
+
+  const baseFieldErrors = validateBaseGraphFields(graphConfiguration, title);
+
+  errors.push(...baseFieldErrors);
+
+  const typeSpecificErrors = validateGraphConfigurationByType(
+    graphConfiguration,
+    title,
+  );
+
+  errors.push(...typeSpecificErrors);
+
+  return errors;
+};
@@ -0,0 +1,37 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type IframeConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/iframe-configuration.type';
+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateIframeConfigurationType = (
+  configuration: IframeConfiguration,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.configurationType)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Configuration type is required for widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Configuration type is required`,
+    });
+
+    return errors;
+  }
+
+  if (configuration.configurationType !== WidgetConfigurationType.IFRAME) {
+    const configurationTypeString = configuration.configurationType.toString();
+
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Invalid configuration type for iframe widget "${widgetTitle}". Expected IFRAME, got ${configurationTypeString}`,
+      userFriendlyMessage: msg`Invalid configuration type for iframe widget`,
+      value: configuration.configurationType,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,42 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type ValidateFlatPageLayoutWidgetTypeSpecificitiesForCreationArgs } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type IframeConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/iframe-configuration.type';
+import { validateIframeConfigurationType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-iframe-configuration-type.util';
+import { validateIframeUrl } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-iframe-url.util';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateIframeFlatPageLayoutWidgetForCreation = (
+  args: ValidateFlatPageLayoutWidgetTypeSpecificitiesForCreationArgs,
+): FlatPageLayoutWidgetValidationError[] => {
+  const { flatEntityToValidate } = args;
+  const { configuration, title } = flatEntityToValidate;
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Configuration is required for iframe widget "${title}"`,
+      userFriendlyMessage: msg`Configuration is required for iframe widget`,
+    });
+
+    return errors;
+  }
+
+  const iframeConfiguration = configuration as IframeConfiguration;
+
+  const configurationTypeErrors = validateIframeConfigurationType(
+    iframeConfiguration,
+    title,
+  );
+
+  errors.push(...configurationTypeErrors);
+
+  const urlErrors = validateIframeUrl(iframeConfiguration, title);
+
+  errors.push(...urlErrors);
+
+  return errors;
+};
@@ -0,0 +1,34 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { type ValidateFlatPageLayoutWidgetTypeSpecificitiesForUpdateArgs } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type IframeConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/iframe-configuration.type';
+import { validateIframeConfigurationType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-iframe-configuration-type.util';
+import { validateIframeUrl } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-iframe-url.util';
+
+export const validateIframeFlatPageLayoutWidgetForUpdate = (
+  args: ValidateFlatPageLayoutWidgetTypeSpecificitiesForUpdateArgs,
+): FlatPageLayoutWidgetValidationError[] => {
+  const { flatEntityToValidate } = args;
+  const { configuration, title } = flatEntityToValidate;
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration)) {
+    return [];
+  }
+
+  const iframeConfiguration = configuration as IframeConfiguration;
+
+  const configurationTypeErrors = validateIframeConfigurationType(
+    iframeConfiguration,
+    title,
+  );
+
+  errors.push(...configurationTypeErrors);
+
+  const urlErrors = validateIframeUrl(iframeConfiguration, title);
+
+  errors.push(...urlErrors);
+
+  return errors;
+};
@@ -0,0 +1,24 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type IframeConfiguration } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/types/iframe-configuration.type';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateIframeUrl = (
+  configuration: IframeConfiguration,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (isDefined(configuration.url) && typeof configuration.url !== 'string') {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`URL must be a string for widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`URL must be a string`,
+      value: configuration.url,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,23 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type LineChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/line-chart-configuration.dto';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateLineChartConfiguration = (
+  configuration: LineChartConfigurationDTO,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.primaryAxisGroupByFieldMetadataId)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Primary axis group by field is required for line chart widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Primary axis group by field is required for line chart`,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,23 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type PieChartConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/pie-chart-configuration.dto';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validatePieChartConfiguration = (
+  configuration: PieChartConfigurationDTO,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.groupByFieldMetadataId)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Group by field is required for pie chart widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Group by field is required for pie chart`,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,37 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type StandaloneRichTextConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/standalone-rich-text-configuration.dto';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateStandaloneRichTextBody = (
+  configuration: StandaloneRichTextConfigurationDTO,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.body)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Body is required for standalone rich text widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Body is required for standalone rich text widget`,
+    });
+
+    return errors;
+  }
+
+  if (
+    typeof configuration.body !== 'object' ||
+    Array.isArray(configuration.body)
+  ) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Body must be an object for widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Body must be an object`,
+      value: configuration.body,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,43 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { type StandaloneRichTextConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/standalone-rich-text-configuration.dto';
+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateStandaloneRichTextConfigurationType = (
+  configuration: StandaloneRichTextConfigurationDTO,
+  widgetTitle: string,
+): FlatPageLayoutWidgetValidationError[] => {
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration.configurationType)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Configuration type is required for widget "${widgetTitle}"`,
+      userFriendlyMessage: msg`Configuration type is required`,
+    });
+
+    return errors;
+  }
+
+  if (
+    configuration.configurationType !==
+    WidgetConfigurationType.STANDALONE_RICH_TEXT
+  ) {
+    const expectedConfigurationType =
+      WidgetConfigurationType.STANDALONE_RICH_TEXT;
+
+    const configurationType = configuration.configurationType;
+
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Invalid configuration type for standalone rich text widget "${widgetTitle}". Expected ${expectedConfigurationType}, got ${configurationType}`,
+      userFriendlyMessage: msg`Invalid configuration type for standalone rich text widget`,
+      value: configuration.configurationType,
+    });
+  }
+
+  return errors;
+};
@@ -0,0 +1,46 @@
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type ValidateFlatPageLayoutWidgetTypeSpecificitiesForCreationArgs } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { validateStandaloneRichTextBody } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-standalone-rich-text-body.util';
+import { validateStandaloneRichTextConfigurationType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-standalone-rich-text-configuration-type.util';
+import { type StandaloneRichTextConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/standalone-rich-text-configuration.dto';
+import { PageLayoutWidgetExceptionCode } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
+
+export const validateStandaloneRichTextFlatPageLayoutWidgetForCreation = (
+  args: ValidateFlatPageLayoutWidgetTypeSpecificitiesForCreationArgs,
+): FlatPageLayoutWidgetValidationError[] => {
+  const { flatEntityToValidate } = args;
+  const { configuration, title } = flatEntityToValidate;
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration)) {
+    errors.push({
+      code: PageLayoutWidgetExceptionCode.INVALID_PAGE_LAYOUT_WIDGET_DATA,
+      message: t`Configuration is required for standalone rich text widget "${title}"`,
+      userFriendlyMessage: msg`Configuration is required for standalone rich text widget`,
+    });
+
+    return errors;
+  }
+
+  const standaloneRichTextConfiguration =
+    configuration as StandaloneRichTextConfigurationDTO;
+
+  const configurationTypeErrors = validateStandaloneRichTextConfigurationType(
+    standaloneRichTextConfiguration,
+    title,
+  );
+
+  errors.push(...configurationTypeErrors);
+
+  const bodyErrors = validateStandaloneRichTextBody(
+    standaloneRichTextConfiguration,
+    title,
+  );
+
+  errors.push(...bodyErrors);
+
+  return errors;
+};
@@ -0,0 +1,38 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { type ValidateFlatPageLayoutWidgetTypeSpecificitiesForUpdateArgs } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
+import { type FlatPageLayoutWidgetValidationError } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget-validation-error.type';
+import { validateStandaloneRichTextBody } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-standalone-rich-text-body.util';
+import { validateStandaloneRichTextConfigurationType } from 'src/engine/metadata-modules/flat-page-layout-widget/validators/utils/validate-standalone-rich-text-configuration-type.util';
+import { type StandaloneRichTextConfigurationDTO } from 'src/engine/metadata-modules/page-layout-widget/dtos/standalone-rich-text-configuration.dto';
+
+export const validateStandaloneRichTextFlatPageLayoutWidgetForUpdate = (
+  args: ValidateFlatPageLayoutWidgetTypeSpecificitiesForUpdateArgs,
+): FlatPageLayoutWidgetValidationError[] => {
+  const { flatEntityToValidate } = args;
+  const { configuration, title } = flatEntityToValidate;
+  const errors: FlatPageLayoutWidgetValidationError[] = [];
+
+  if (!isDefined(configuration)) {
+    return [];
+  }
+
+  const standaloneRichTextConfiguration =
+    configuration as StandaloneRichTextConfigurationDTO;
+
+  const configurationTypeErrors = validateStandaloneRichTextConfigurationType(
+    standaloneRichTextConfiguration,
+    title,
+  );
+
+  errors.push(...configurationTypeErrors);
+
+  const bodyErrors = validateStandaloneRichTextBody(
+    standaloneRichTextConfiguration,
+    title,
+  );
+
+  errors.push(...bodyErrors);
+
+  return errors;
+};