Implement page layout override (#18472)

packages/twenty-server/src/engine/metadata-modules/flat-page-layout-widget/constants/flat-page-layout-widget-editable-properties.constant.ts

@@ -7,4 +7,5 @@ export const FLAT_PAGE_LAYOUT_WIDGET_EDITABLE_PROPERTIES = [
   'gridPosition',
   'position',
   'configuration',
+  'conditionalDisplay',
 ] as const satisfies MetadataEntityPropertyName<'pageLayoutWidget'>[];

packages/twenty-server/src/engine/metadata-modules/flat-page-layout-widget/utils/from-create-page-layout-widget-input-to-flat-page-layout-widget-to-create.util.ts

@@ -73,6 +73,7 @@ export const fromCreatePageLayoutWidgetInputToFlatPageLayoutWidgetToCreate = ({
     applicationId: flatApplication.id,
     applicationUniversalIdentifier: flatApplication.universalIdentifier,
     conditionalDisplay: null,
+    overrides: null,
     universalConfiguration:
       fromPageLayoutWidgetConfigurationToUniversalConfiguration({
         configuration: createPageLayoutWidgetInput.configuration,

packages/twenty-server/src/engine/metadata-modules/flat-page-layout-widget/utils/from-update-page-layout-widget-input-to-flat-page-layout-widget-to-update-or-throw.util.ts

@@ -17,6 +17,8 @@ import {
   PageLayoutWidgetExceptionCode,
 } from 'src/engine/metadata-modules/page-layout-widget/exceptions/page-layout-widget.exception';
 import { validateWidgetConfigurationInput } from 'src/engine/metadata-modules/page-layout-widget/utils/validate-widget-configuration-input.util';
+import { isCallerOverridingEntity } from 'src/engine/metadata-modules/utils/is-caller-overriding-entity.util';
+import { sanitizeOverridableEntityInput } from 'src/engine/metadata-modules/utils/sanitize-overridable-entity-input.util';
 import { mergeUpdateInExistingRecord } from 'src/utils/merge-update-in-existing-record.util';
 
 export type UpdatePageLayoutWidgetInputWithId = {
@@ -33,9 +35,13 @@ export const fromUpdatePageLayoutWidgetInputToFlatPageLayoutWidgetToUpdateOrThro
     flatFrontComponentMaps,
     flatViewFieldGroupMaps,
     flatViewMaps,
+    callerApplicationUniversalIdentifier,
+    workspaceCustomApplicationUniversalIdentifier,
   }: {
     updatePageLayoutWidgetInput: UpdatePageLayoutWidgetInputWithId;
     flatPageLayoutWidgetMaps: FlatPageLayoutWidgetMaps;
+    callerApplicationUniversalIdentifier: string;
+    workspaceCustomApplicationUniversalIdentifier: string;
   } & Pick<
     AllFlatEntityMaps,
     | 'flatObjectMetadataMaps'
@@ -62,29 +68,44 @@ export const fromUpdatePageLayoutWidgetInputToFlatPageLayoutWidgetToUpdateOrThro
       );
     }
 
-    const updatedEditableFieldProperties = extractAndSanitizeObjectStringFields(
+    const editableProperties = extractAndSanitizeObjectStringFields(
       rawUpdatePageLayoutWidgetInput.update,
       FLAT_PAGE_LAYOUT_WIDGET_EDITABLE_PROPERTIES,
     );
 
     if (
-      Object.prototype.hasOwnProperty.call(
-        updatedEditableFieldProperties,
-        'configuration',
-      )
+      Object.prototype.hasOwnProperty.call(editableProperties, 'configuration')
     ) {
       validateWidgetConfigurationInput({
-        configuration: updatedEditableFieldProperties.configuration,
+        configuration: editableProperties.configuration,
       });
     }
 
-    const flatPageLayoutWidgetToUpdate = mergeUpdateInExistingRecord({
-      existing: existingFlatPageLayoutWidgetToUpdate,
-      properties: FLAT_PAGE_LAYOUT_WIDGET_EDITABLE_PROPERTIES,
-      update: updatedEditableFieldProperties,
+    const shouldOverride = isCallerOverridingEntity({
+      callerApplicationUniversalIdentifier,
+      entityApplicationUniversalIdentifier:
+        existingFlatPageLayoutWidgetToUpdate.applicationUniversalIdentifier,
+      workspaceCustomApplicationUniversalIdentifier,
     });
 
-    if (updatedEditableFieldProperties.objectMetadataId !== undefined) {
+    const { overrides, updatedEditableProperties } =
+      sanitizeOverridableEntityInput({
+        metadataName: 'pageLayoutWidget',
+        existingFlatEntity: existingFlatPageLayoutWidgetToUpdate,
+        updatedEditableProperties: editableProperties,
+        shouldOverride,
+      });
+
+    const flatPageLayoutWidgetToUpdate = {
+      ...mergeUpdateInExistingRecord({
+        existing: existingFlatPageLayoutWidgetToUpdate,
+        properties: FLAT_PAGE_LAYOUT_WIDGET_EDITABLE_PROPERTIES,
+        update: updatedEditableProperties,
+      }),
+      overrides,
+    };
+
+    if (updatedEditableProperties.objectMetadataId !== undefined) {
       const { objectMetadataUniversalIdentifier } =
         resolveEntityRelationUniversalIdentifiers({
           metadataName: 'pageLayoutWidget',
@@ -98,7 +119,7 @@ export const fromUpdatePageLayoutWidgetInputToFlatPageLayoutWidgetToUpdateOrThro
         objectMetadataUniversalIdentifier;
     }
 
-    if (isDefined(updatedEditableFieldProperties.configuration)) {
+    if (isDefined(updatedEditableProperties.configuration)) {
       flatPageLayoutWidgetToUpdate.universalConfiguration =
         fromPageLayoutWidgetConfigurationToUniversalConfiguration({
           configuration: flatPageLayoutWidgetToUpdate.configuration,