The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
feat(record-form): provision a RECORD_FORM page layout per object (#24999)
Thomas Trompette676a70316e87
diff --git a/packages/twenty-docs/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/developers/extend/apps/layout/page-layouts.mdxindex 7d40c5e8c8d..357f6b78942 100644--- a/packages/twenty-docs/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/developers/extend/apps/layout/page-layouts.mdx@@ -51,7 +51,7 @@ export default definePageLayout({### Key points-- `type` is one of `'RECORD_INDEX'`, `'RECORD_PAGE'`, `'DASHBOARD'`, `'STANDALONE_PAGE'` or `'RECORD_FORM'`. Use `'RECORD_PAGE'` to customize the detail view of a specific object. `'RECORD_FORM'` describes the creation form of an object and only accepts `FORM_FIELD` widgets, each rendering a single field; conversely, every other widget type is rejected in a `'RECORD_FORM'` layout. Twenty does not render record forms yet.+- `type` is one of `'RECORD_INDEX'`, `'RECORD_PAGE'`, `'DASHBOARD'`, `'STANDALONE_PAGE'` or `'RECORD_FORM'`. Use `'RECORD_PAGE'` to customize the detail view of a specific object. `'RECORD_FORM'` describes the creation form of an object and holds `FORM_FIELD` widgets, each rendering a single field. Twenty provisions one `'RECORD_FORM'` layout per object with one widget per creatable field, so you rarely need to author one; it does not render record forms yet.- `objectUniversalIdentifier` specifies which object this layout applies to.- Each `tab` defines a section of the page with a `title`, `position`, and `layoutMode`: `VERTICAL_LIST` for record pages and standalone pages, `GRID` for dashboards, and `CANVAS` for a single widget that should fill the tab viewport. A `VERTICAL_LIST` tab stacks widgets vertically. Built-in widgets that manage their own scrolling, such as timelines, files, notes, tasks, and workflows, fill one viewport; fields, front components, graphs, and other fit-content widgets render at their content or configured height. A `GRID` tab always lays its widgets out as cards on a 12-column grid. A `CANVAS` widget has no coordinates and can omit `position`; Twenty normalizes it to `{ layoutMode: PageLayoutTabLayoutMode.CANVAS }` from the tab layout mode. If a canvas tab contains multiple widgets, they render at their content height instead of filling the viewport.- A widget `position` matches its tab layout mode. `VERTICAL_LIST` uses `{ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST, index }`, `GRID` uses `{ layoutMode: PageLayoutTabLayoutMode.GRID, row, column, rowSpan, columnSpan }`, and `CANVAS` uses `{ layoutMode: PageLayoutTabLayoutMode.CANVAS }` or omits `position`.diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-upgrade-version-command.module.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-upgrade-version-command.module.tsindex 7cf316895e6..df4584449ea 100644--- a/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-upgrade-version-command.module.ts+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-upgrade-version-command.module.ts@@ -2,19 +2,24 @@ import { Module } from '@nestjs/common';import { WorkspaceIteratorModule } from 'src/database/commands/command-runners/workspace-iterator.module';import { ConvertLogicFunctionsToPrebuiltCommand } from 'src/database/commands/upgrade-version-command/2-39/2-39-workspace-command-1788338950836-convert-logic-functions-to-prebuilt.command';+import { BackfillRecordFormCommand } from 'src/database/commands/upgrade-version-command/2-39/2-39-workspace-command-1788524477000-backfill-record-form.command';import { TypeORMModule } from 'src/database/typeorm/typeorm.module';import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-flag.module';import { WorkspaceManyOrAllFlatEntityMapsCacheModule } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module';+import { WorkspaceCacheModule } from 'src/engine/workspace-cache/workspace-cache.module';+import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration.module';import { WorkspaceSchemaMigrationRunnerActionHandlersModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module';@Module({imports: [FeatureFlagModule,TypeORMModule,+ WorkspaceCacheModule,WorkspaceIteratorModule,WorkspaceManyOrAllFlatEntityMapsCacheModule,+ WorkspaceMigrationModule,WorkspaceSchemaMigrationRunnerActionHandlersModule,],- providers: [ConvertLogicFunctionsToPrebuiltCommand],+ providers: [ConvertLogicFunctionsToPrebuiltCommand, BackfillRecordFormCommand],})export class V2_39_UpgradeVersionCommandModule {}diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-workspace-command-1788524477000-backfill-record-form.command.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-workspace-command-1788524477000-backfill-record-form.command.tsnew file mode 100644index 00000000000..9b2a4af3553--- /dev/null+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/2-39/2-39-workspace-command-1788524477000-backfill-record-form.command.ts@@ -0,0 +1,313 @@+import { Command } from 'nest-commander';+import { isDefined } from 'twenty-shared/utils';++import { ProvisionedWorkspaceCommandRunner } from 'src/database/commands/command-runners/provisioned-workspace.command-runner';+import { WorkspaceIteratorService } from 'src/database/commands/command-runners/workspace-iterator.service';+import { type RunOnWorkspaceArgs } from 'src/database/commands/command-runners/workspace.command-runner';+import { RegisteredWorkspaceCommand } from 'src/engine/core-modules/upgrade/decorators/registered-workspace-command.decorator';+import { type AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';+import { type AllFlatEntityOperationByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-to-create-delete-update.type';+import { computeRecordFormFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util';+import { buildSystemFormFieldPageLayoutWidget } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/build-system-form-field-page-layout-widget.util';+import { computeSystemRecordFormPageLayoutToCreate } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-record-form-page-layout-to-create.util';+import { WorkspaceCacheService } from 'src/engine/workspace-cache/services/workspace-cache.service';+import { WorkspaceMigrationValidateBuildAndRunService } from 'src/engine/workspace-manager/workspace-migration/services/workspace-migration-validate-build-and-run-service';+import { type UniversalFlatPageLayoutTab } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout-tab.type';+import { type UniversalFlatPageLayoutWidget } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout-widget.type';+import { type UniversalFlatPageLayout } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout.type';++type BackfillOperations = {+ pageLayoutsToCreate: UniversalFlatPageLayout[];+ pageLayoutTabsToCreate: UniversalFlatPageLayoutTab[];+ pageLayoutWidgetsToCreate: UniversalFlatPageLayoutWidget[];+};++type BackfillOperationsByApplication = Map<string, BackfillOperations>;++@RegisteredWorkspaceCommand('2.39.0', 1788524477000)+@Command({+ name: 'upgrade:2-39:backfill-record-form',+ description:+ 'Backfill the RECORD_FORM page layout stack for every object missing it, converging upgraded installs with what objectRecordFormOnCreate and fieldRecordFormWidgetOnCreate emit at creation time. Twenty-standard objects are included: the standard definitions only reach a workspace at creation, so an upgraded workspace would otherwise never get their form, and both paths derive the same entities.',+})+export class BackfillRecordFormCommand extends ProvisionedWorkspaceCommandRunner {+ constructor(+ protected readonly workspaceIteratorService: WorkspaceIteratorService,+ private readonly workspaceCacheService: WorkspaceCacheService,+ private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,+ ) {+ super(workspaceIteratorService);+ }++ override async runOnWorkspace({+ workspaceId,+ options,+ }: RunOnWorkspaceArgs): Promise<void> {+ const isDryRun = options.dryRun ?? false;++ const {+ flatObjectMetadataMaps,+ flatFieldMetadataMaps,+ flatPageLayoutMaps,+ flatPageLayoutTabMaps,+ flatPageLayoutWidgetMaps,+ } = await this.workspaceCacheService.getOrRecompute(workspaceId, [+ 'flatObjectMetadataMaps',+ 'flatFieldMetadataMaps',+ 'flatPageLayoutMaps',+ 'flatPageLayoutTabMaps',+ 'flatPageLayoutWidgetMaps',+ ]);++ const backfillOperationsByApplication =+ this.computeBackfillOperationsByApplication({+ flatObjectMetadataMaps,+ flatFieldMetadataMaps,+ flatPageLayoutMaps,+ flatPageLayoutTabMaps,+ flatPageLayoutWidgetMaps,+ });++ const totalCreateCount = [+ ...backfillOperationsByApplication.values(),+ ].reduce(+ (count, operations) =>+ count ++ operations.pageLayoutsToCreate.length ++ operations.pageLayoutTabsToCreate.length ++ operations.pageLayoutWidgetsToCreate.length,+ 0,+ );++ if (totalCreateCount === 0) {+ this.logger.log(`No record form to backfill for workspace ${workspaceId}`);++ return;+ }++ this.logger.log(+ `${isDryRun ? '[DRY RUN] ' : ''}Backfilling ${totalCreateCount} record-form entit(ies) for workspace ${workspaceId}`,+ );++ if (isDryRun) {+ return;+ }++ await this.runBackfillMigrations({+ workspaceId,+ backfillOperationsByApplication,+ });++ this.logger.log(+ `Backfilled ${totalCreateCount} record-form entit(ies) for workspace ${workspaceId}`,+ );+ }++ private computeBackfillOperationsByApplication({+ flatObjectMetadataMaps,+ flatFieldMetadataMaps,+ flatPageLayoutMaps,+ flatPageLayoutTabMaps,+ flatPageLayoutWidgetMaps,+ }: Pick<+ AllFlatEntityMaps,+ | 'flatObjectMetadataMaps'+ | 'flatFieldMetadataMaps'+ | 'flatPageLayoutMaps'+ | 'flatPageLayoutTabMaps'+ | 'flatPageLayoutWidgetMaps'+ >): BackfillOperationsByApplication {+ const backfillOperationsByApplication: BackfillOperationsByApplication =+ new Map();++ const getApplicationBucket = (applicationUniversalIdentifier: string) => {+ const existingBucket = backfillOperationsByApplication.get(+ applicationUniversalIdentifier,+ );++ if (isDefined(existingBucket)) {+ return existingBucket;+ }++ const newBucket: BackfillOperations = {+ pageLayoutsToCreate: [],+ pageLayoutTabsToCreate: [],+ pageLayoutWidgetsToCreate: [],+ };++ backfillOperationsByApplication.set(+ applicationUniversalIdentifier,+ newBucket,+ );++ return newBucket;+ };++ for (const flatObjectMetadata of Object.values(+ flatObjectMetadataMaps.byUniversalIdentifier,+ )) {+ if (!isDefined(flatObjectMetadata) || flatObjectMetadata.isRemote) {+ continue;+ }++ const { pageLayout, pageLayoutTab } =+ computeSystemRecordFormPageLayoutToCreate({+ objectMetadata: flatObjectMetadata,+ applicationUniversalIdentifier:+ flatObjectMetadata.applicationUniversalIdentifier,+ });++ const existingFlatPageLayout =+ flatPageLayoutMaps.byUniversalIdentifier[+ pageLayout.universalIdentifier+ ];+ const existingFlatPageLayoutTab =+ flatPageLayoutTabMaps.byUniversalIdentifier[+ pageLayoutTab.universalIdentifier+ ];++ const objectApplicationBucket = getApplicationBucket(+ flatObjectMetadata.applicationUniversalIdentifier,+ );++ if (!isDefined(existingFlatPageLayout)) {+ objectApplicationBucket.pageLayoutsToCreate.push(pageLayout);+ }++ if (!isDefined(existingFlatPageLayoutTab)) {+ objectApplicationBucket.pageLayoutTabsToCreate.push(pageLayoutTab);+ }++ const orderedFormFlatFieldMetadatas = computeRecordFormFlatFieldMetadatas(+ {+ flatFieldMetadatas: flatObjectMetadata.fieldUniversalIdentifiers+ .map(+ (fieldUniversalIdentifier) =>+ flatFieldMetadataMaps.byUniversalIdentifier[+ fieldUniversalIdentifier+ ],+ )+ .filter(isDefined),+ labelIdentifierFieldMetadataUniversalIdentifier:+ flatObjectMetadata.labelIdentifierFieldMetadataUniversalIdentifier,+ },+ );++ orderedFormFlatFieldMetadatas.forEach((flatFieldMetadata, index) => {+ const pageLayoutWidget = buildSystemFormFieldPageLayoutWidget({+ applicationUniversalIdentifier:+ flatFieldMetadata.applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier: pageLayoutTab.universalIdentifier,+ objectMetadataUniversalIdentifier:+ flatObjectMetadata.universalIdentifier,+ flatFieldMetadata,+ index,+ });++ if (+ isDefined(+ flatPageLayoutWidgetMaps.byUniversalIdentifier[+ pageLayoutWidget.universalIdentifier+ ],+ )+ ) {+ return;+ }++ getApplicationBucket(+ flatFieldMetadata.applicationUniversalIdentifier,+ ).pageLayoutWidgetsToCreate.push(pageLayoutWidget);+ });+ }++ return backfillOperationsByApplication;+ }++ private async runBackfillMigrations({+ workspaceId,+ backfillOperationsByApplication,+ }: {+ workspaceId: string;+ backfillOperationsByApplication: BackfillOperationsByApplication;+ }): Promise<void> {+ for (const [+ applicationUniversalIdentifier,+ { pageLayoutsToCreate, pageLayoutTabsToCreate },+ ] of backfillOperationsByApplication.entries()) {+ if (+ pageLayoutsToCreate.length === 0 &&+ pageLayoutTabsToCreate.length === 0+ ) {+ continue;+ }++ await this.runBackfillMigration({+ workspaceId,+ applicationUniversalIdentifier,+ allFlatEntityOperationByMetadataName: {+ pageLayout: {+ flatEntityToCreate: pageLayoutsToCreate,+ flatEntityToDelete: [],+ flatEntityToUpdate: [],+ },+ pageLayoutTab: {+ flatEntityToCreate: pageLayoutTabsToCreate,+ flatEntityToDelete: [],+ flatEntityToUpdate: [],+ },+ },+ });+ }++ for (const [+ applicationUniversalIdentifier,+ { pageLayoutWidgetsToCreate },+ ] of backfillOperationsByApplication.entries()) {+ if (pageLayoutWidgetsToCreate.length === 0) {+ continue;+ }++ await this.runBackfillMigration({+ workspaceId,+ applicationUniversalIdentifier,+ allFlatEntityOperationByMetadataName: {+ pageLayoutWidget: {+ flatEntityToCreate: pageLayoutWidgetsToCreate,+ flatEntityToDelete: [],+ flatEntityToUpdate: [],+ },+ },+ });+ }+ }++ private async runBackfillMigration({+ workspaceId,+ applicationUniversalIdentifier,+ allFlatEntityOperationByMetadataName,+ }: {+ workspaceId: string;+ applicationUniversalIdentifier: string;+ allFlatEntityOperationByMetadataName: AllFlatEntityOperationByMetadataName;+ }): Promise<void> {+ const result =+ await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunLegacyWorkspaceMigration(+ {+ isSystemBuild: true,+ workspaceId,+ applicationUniversalIdentifier,+ allFlatEntityOperationByMetadataName,+ },+ );++ if (result.status === 'fail') {+ this.logger.error(+ `Failed to backfill record form(s) for application ${applicationUniversalIdentifier} in workspace ${workspaceId}:\n${JSON.stringify(result, null, 2)}`,+ );++ throw new Error(+ `Failed to backfill record form(s) for workspace ${workspaceId}`,+ );+ }+ }+}diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-side-effect-companion-metadata-names.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-side-effect-companion-metadata-names.constant.tsindex 159660f27d5..e6ba92a12ae 100644--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-side-effect-companion-metadata-names.constant.ts+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-side-effect-companion-metadata-names.constant.ts@@ -7,6 +7,7 @@ export const ALL_METADATA_SIDE_EFFECT_COMPANION_METADATA_NAMES = {'view','viewField','viewFieldGroup',+ 'pageLayoutTab','pageLayoutWidget',],objectMetadata: [diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/constants/record-form-tab-props.constant.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/constants/record-form-tab-props.constant.tsnew file mode 100644index 00000000000..3236008e75e--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/constants/record-form-tab-props.constant.ts@@ -0,0 +1,10 @@+import { PageLayoutTabLayoutMode } from 'twenty-shared/types';++export const RECORD_FORM_PAGE_LAYOUT_NAME = 'Creation Form';++export const RECORD_FORM_TAB_PROPS = {+ title: 'Fields',+ position: 10,+ icon: 'IconList',+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+} as const;diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-create-side-effect-handler.service.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-create-side-effect-handler.service.tsnew file mode 100644index 00000000000..7a3c595f45e--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-create-side-effect-handler.service.ts@@ -0,0 +1,154 @@+import { Injectable } from '@nestjs/common';++import { isDefined } from 'twenty-shared/utils';++import { buildFieldSideEffectParentNotFoundFailure } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/utils/build-field-side-effect-parent-not-found-failure.util';+import { resolveParentFlatObjectMetadataAfterStateForFieldSideEffect } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/utils/resolve-parent-flat-object-metadata-after-state-for-field-side-effect.util';+import { getRecordFormPageLayoutTabUniversalIdentifier } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/get-record-form-page-layout-tab-universal-identifier.util';+import { computeCallerFlatFieldMetadatasForObject } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-caller-flat-field-metadatas-for-object.util';+import { computeRecordFormFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util';+import { isFlatFieldMetadataEligibleForRecordForm } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util';+import { computeOrderedNewRecordFormFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-ordered-new-record-form-flat-field-metadatas.util';+import { computeRecordFormWidgetForExistingObject } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-widget-for-existing-object.util';+import { buildSystemFormFieldPageLayoutWidget } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/build-system-form-field-page-layout-widget.util';+import {+ type BuildSideEffectsArgs,+ MetadataSideEffectHandler,+} from 'src/engine/metadata-modules/metadata-side-effect/interfaces/base-metadata-side-effect-handler.service';+import { type MetadataSideEffectResult } from 'src/engine/metadata-modules/metadata-side-effect/types/metadata-side-effect-result.type';+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';+import { type UniversalFlatPageLayoutWidget } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout-widget.type';++@Injectable()+export class FieldRecordFormWidgetOnCreateSideEffectHandlerService extends MetadataSideEffectHandler(+ {+ operation: 'create',+ metadataName: 'fieldMetadata',+ name: 'fieldRecordFormWidgetOnCreate',+ description:+ 'When a caller-provided field is created, provision its engine-owned FORM_FIELD widget on the engine-owned RECORD_FORM "Fields" tab, resolved strictly by its derived universal identifier. Widgets are the form equivalent of the record page view fields, except there is no view: the widget itself carries the field, so this handler owns every widget on the form, including the ones for fields created in the same batch as their object. On same-batch creation no tab exists in the maps yet, so the index is derived statelessly from the ordered caller field list, exactly as objectRecordFormOnCreate would have ordered it. On an existing object the widget appends after the last FORM_FIELD widget of the tab. Noop when the field is not creatable (system, non UI editable, id, and any type the form has no input for, which today means ACTOR, FILES, NUMERIC, POSITION, RATING, TS_VECTOR and relations other than MANY_TO_ONE), when the object has no engine record form tab, or when the (tab, field) pair is already synced. Unlike the record page, the label identifier gets a widget: a creation form must let the user fill it.',+ },+) {+ buildSideEffects({+ flatEntity: sourceFlatFieldMetadata,+ allFlatEntityOperationRecordByMetadataName,+ relatedFlatEntityMaps,+ }: BuildSideEffectsArgs<'fieldMetadata'>): MetadataSideEffectResult {+ if (!isFlatFieldMetadataEligibleForRecordForm(sourceFlatFieldMetadata)) {+ return { status: 'noop' };+ }++ const { objectMetadataUniversalIdentifier } = sourceFlatFieldMetadata;++ const parentFlatObjectMetadata =+ resolveParentFlatObjectMetadataAfterStateForFieldSideEffect({+ objectMetadataUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ relatedFlatEntityMaps,+ });++ if (!isDefined(parentFlatObjectMetadata)) {+ return buildFieldSideEffectParentNotFoundFailure({+ flatFieldMetadata: sourceFlatFieldMetadata,+ operation: 'create',+ });+ }++ const objectApplicationUniversalIdentifier =+ parentFlatObjectMetadata.applicationUniversalIdentifier;++ const recordFormPageLayoutTabUniversalIdentifier =+ getRecordFormPageLayoutTabUniversalIdentifier({+ objectApplicationUniversalIdentifier,+ objectMetadataUniversalIdentifier,+ });++ const { labelIdentifierFieldMetadataUniversalIdentifier } =+ parentFlatObjectMetadata;++ const orderedFormFlatFieldMetadatasInBatch =+ computeRecordFormFlatFieldMetadatas({+ flatFieldMetadatas: computeCallerFlatFieldMetadatasForObject({+ objectMetadataUniversalIdentifier,+ labelIdentifierFieldMetadataUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ }),+ labelIdentifierFieldMetadataUniversalIdentifier,+ });++ const parentObjectCreatedInSameBatch = isDefined(+ allFlatEntityOperationRecordByMetadataName.objectMetadata+ ?.flatEntityToCreate[objectMetadataUniversalIdentifier],+ );++ const flatPageLayoutWidgetToCreate = parentObjectCreatedInSameBatch+ ? this.buildRecordFormWidgetForObjectCreatedInSameBatch({+ sourceFlatFieldMetadata,+ orderedFormFlatFieldMetadatasInBatch,+ recordFormPageLayoutTabUniversalIdentifier,+ })+ : computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ orderedFormFlatFieldMetadatasInBatch:+ computeOrderedNewRecordFormFlatFieldMetadatas({+ objectMetadataUniversalIdentifier,+ labelIdentifierFieldMetadataUniversalIdentifier,+ recordFormPageLayoutTabUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ flatPageLayoutWidgetMaps:+ relatedFlatEntityMaps.flatPageLayoutWidgetMaps,+ }),+ recordFormPageLayoutTabUniversalIdentifier,+ flatPageLayoutTabMaps: relatedFlatEntityMaps.flatPageLayoutTabMaps,+ flatPageLayoutWidgetMaps:+ relatedFlatEntityMaps.flatPageLayoutWidgetMaps,+ });++ if (!isDefined(flatPageLayoutWidgetToCreate)) {+ return { status: 'noop' };+ }++ return {+ status: 'success',+ operations: {+ pageLayoutWidget: {+ flatEntityToCreate: {+ [flatPageLayoutWidgetToCreate.universalIdentifier]:+ flatPageLayoutWidgetToCreate,+ },+ },+ },+ };+ }++ private buildRecordFormWidgetForObjectCreatedInSameBatch({+ sourceFlatFieldMetadata,+ orderedFormFlatFieldMetadatasInBatch,+ recordFormPageLayoutTabUniversalIdentifier,+ }: {+ sourceFlatFieldMetadata: UniversalFlatFieldMetadata;+ orderedFormFlatFieldMetadatasInBatch: UniversalFlatFieldMetadata[];+ recordFormPageLayoutTabUniversalIdentifier: string;+ }): UniversalFlatPageLayoutWidget | undefined {+ const index = orderedFormFlatFieldMetadatasInBatch.findIndex(+ (orderedFlatFieldMetadata) =>+ orderedFlatFieldMetadata.universalIdentifier ===+ sourceFlatFieldMetadata.universalIdentifier,+ );++ if (index === -1) {+ return undefined;+ }++ return buildSystemFormFieldPageLayoutWidget({+ applicationUniversalIdentifier:+ sourceFlatFieldMetadata.applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier:+ recordFormPageLayoutTabUniversalIdentifier,+ objectMetadataUniversalIdentifier:+ sourceFlatFieldMetadata.objectMetadataUniversalIdentifier,+ flatFieldMetadata: sourceFlatFieldMetadata,+ index,+ });+ }+}diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-delete-side-effect-handler.service.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-delete-side-effect-handler.service.tsnew file mode 100644index 00000000000..3e42c9c4900--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-delete-side-effect-handler.service.ts@@ -0,0 +1,82 @@+import { Injectable } from '@nestjs/common';++import { getSystemFormFieldPageLayoutWidgetUniversalIdentifier } from 'twenty-shared/application';+import { isDefined } from 'twenty-shared/utils';++import { getRecordFormPageLayoutTabUniversalIdentifier } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/get-record-form-page-layout-tab-universal-identifier.util';+import { resolveParentFlatObjectMetadataAfterStateForFieldSideEffect } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/utils/resolve-parent-flat-object-metadata-after-state-for-field-side-effect.util';+import {+ type BuildSideEffectsArgs,+ MetadataSideEffectHandler,+} from 'src/engine/metadata-modules/metadata-side-effect/interfaces/base-metadata-side-effect-handler.service';+import { type MetadataSideEffectResult } from 'src/engine/metadata-modules/metadata-side-effect/types/metadata-side-effect-result.type';++@Injectable()+export class FieldRecordFormWidgetOnDeleteSideEffectHandlerService extends MetadataSideEffectHandler(+ {+ operation: 'delete',+ metadataName: 'fieldMetadata',+ name: 'fieldRecordFormWidgetOnDelete',+ description:+ 'When a field is deleted, cascade-delete the engine-owned FORM_FIELD widget displaying it, counterpart of fieldRecordFormWidgetOnCreate. A widget references its field through its configuration jsonb, not a foreign key, so nothing else would ever remove it: neither the database cascade nor manifest deletion inference, which excludes isSystemSideEffect entities. The widget is resolved by its derived universal identifier rather than by scanning, which means the layout and tab identifiers must be derived from the application owning the OBJECT, exactly as fieldRecordFormWidgetOnCreate derives them; the application owning the FIELD differs whenever an app contributes a field to a foreign object, and deriving from it would miss the widget and orphan it. Noop when the object is already gone, since the object delete cascade takes the whole stack. Caller-authored widgets displaying the same field are NOT touched: they are deleted through normal deletion inference.',+ },+) {+ buildSideEffects({+ flatEntity: sourceFlatFieldMetadata,+ allFlatEntityOperationRecordByMetadataName,+ relatedFlatEntityMaps,+ }: BuildSideEffectsArgs<'fieldMetadata'>): MetadataSideEffectResult {+ const { objectMetadataUniversalIdentifier } = sourceFlatFieldMetadata;++ const parentFlatObjectMetadata =+ resolveParentFlatObjectMetadataAfterStateForFieldSideEffect({+ objectMetadataUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ relatedFlatEntityMaps,+ });++ if (!isDefined(parentFlatObjectMetadata)) {+ return { status: 'noop' };+ }++ const objectApplicationUniversalIdentifier =+ parentFlatObjectMetadata.applicationUniversalIdentifier;++ const recordFormPageLayoutTabUniversalIdentifier =+ getRecordFormPageLayoutTabUniversalIdentifier({+ objectApplicationUniversalIdentifier,+ objectMetadataUniversalIdentifier,+ });++ const flatPageLayoutWidgetToDelete =+ relatedFlatEntityMaps.flatPageLayoutWidgetMaps.byUniversalIdentifier[+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier:+ sourceFlatFieldMetadata.applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier:+ recordFormPageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier:+ sourceFlatFieldMetadata.universalIdentifier,+ })+ ];++ if (+ !isDefined(flatPageLayoutWidgetToDelete) ||+ flatPageLayoutWidgetToDelete.isSystemSideEffect !== true+ ) {+ return { status: 'noop' };+ }++ return {+ status: 'success',+ operations: {+ pageLayoutWidget: {+ flatEntityToDelete: {+ [flatPageLayoutWidgetToDelete.universalIdentifier]:+ flatPageLayoutWidgetToDelete,+ },+ },+ },+ };+ }+}diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-update-side-effect-handler.service.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-update-side-effect-handler.service.tsnew file mode 100644index 00000000000..063faec3d55--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-update-side-effect-handler.service.ts@@ -0,0 +1,139 @@+import { Injectable } from '@nestjs/common';++import { getSystemFormFieldPageLayoutWidgetUniversalIdentifier } from 'twenty-shared/application';+import { isDefined } from 'twenty-shared/utils';++import { buildFieldSideEffectParentNotFoundFailure } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/utils/build-field-side-effect-parent-not-found-failure.util';+import { resolveParentFlatObjectMetadataAfterStateForFieldSideEffect } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/utils/resolve-parent-flat-object-metadata-after-state-for-field-side-effect.util';+import { computeOrderedNewRecordFormFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-ordered-new-record-form-flat-field-metadatas.util';+import { computeRecordFormWidgetForExistingObject } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-widget-for-existing-object.util';+import { getRecordFormPageLayoutTabUniversalIdentifier } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/get-record-form-page-layout-tab-universal-identifier.util';+import { isFlatFieldMetadataEligibleForRecordForm } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util';+import {+ type BuildSideEffectsArgs,+ MetadataSideEffectHandler,+} from 'src/engine/metadata-modules/metadata-side-effect/interfaces/base-metadata-side-effect-handler.service';+import { type MetadataSideEffectResult } from 'src/engine/metadata-modules/metadata-side-effect/types/metadata-side-effect-result.type';++@Injectable()+export class FieldRecordFormWidgetOnUpdateSideEffectHandlerService extends MetadataSideEffectHandler(+ {+ operation: 'update',+ metadataName: 'fieldMetadata',+ name: 'fieldRecordFormWidgetOnUpdate',+ description:+ 'When a field is updated, realign its engine-owned FORM_FIELD widget with the form eligibility predicate, which unlike the record page one reads mutable properties: isActive, isUIEditable and the relation type in settings. Deactivating a field, revoking its UI editability or retargeting a relation away from MANY_TO_ONE deletes its widget; the reverse re-provisions one, appended after the last widget of the tab. Without this the form drifts permanently: a deactivated field would keep a widget pointing at it, and a field that only became creatable later would never get one, since fieldRecordFormWidgetOnCreate fires once. The record page needs no such handler because its predicate reads only immutable properties plus the label identifier, which objectRecordPageLabelIdentifierOnUpdate owns. Noop when eligibility did not change relative to the widget that exists, when the object has no engine record form tab, or when the widget found is not engine-owned.',+ },+) {+ buildSideEffects({+ flatEntity: sourceFlatFieldMetadata,+ allFlatEntityOperationRecordByMetadataName,+ relatedFlatEntityMaps,+ }: BuildSideEffectsArgs<'fieldMetadata'>): MetadataSideEffectResult {+ const { objectMetadataUniversalIdentifier } = sourceFlatFieldMetadata;++ const parentFlatObjectMetadata =+ resolveParentFlatObjectMetadataAfterStateForFieldSideEffect({+ objectMetadataUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ relatedFlatEntityMaps,+ });++ if (!isDefined(parentFlatObjectMetadata)) {+ return buildFieldSideEffectParentNotFoundFailure({+ flatFieldMetadata: sourceFlatFieldMetadata,+ operation: 'update',+ });+ }++ const recordFormPageLayoutTabUniversalIdentifier =+ getRecordFormPageLayoutTabUniversalIdentifier({+ objectApplicationUniversalIdentifier:+ parentFlatObjectMetadata.applicationUniversalIdentifier,+ objectMetadataUniversalIdentifier,+ });++ const existingFlatPageLayoutWidget =+ relatedFlatEntityMaps.flatPageLayoutWidgetMaps.byUniversalIdentifier[+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier:+ sourceFlatFieldMetadata.applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier:+ recordFormPageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier:+ sourceFlatFieldMetadata.universalIdentifier,+ })+ ];++ const isEligible = isFlatFieldMetadataEligibleForRecordForm(+ sourceFlatFieldMetadata,+ );++ const orderedNewlyEligibleFlatFieldMetadatas =+ computeOrderedNewRecordFormFlatFieldMetadatas({+ objectMetadataUniversalIdentifier,+ labelIdentifierFieldMetadataUniversalIdentifier:+ parentFlatObjectMetadata.labelIdentifierFieldMetadataUniversalIdentifier,+ recordFormPageLayoutTabUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ flatPageLayoutWidgetMaps:+ relatedFlatEntityMaps.flatPageLayoutWidgetMaps,+ });++ if (+ isEligible &&+ !isDefined(existingFlatPageLayoutWidget) &&+ !isDefined(+ allFlatEntityOperationRecordByMetadataName.fieldMetadata+ ?.flatEntityToCreate[sourceFlatFieldMetadata.universalIdentifier],+ )+ ) {+ const flatPageLayoutWidgetToCreate =+ computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ orderedFormFlatFieldMetadatasInBatch:+ orderedNewlyEligibleFlatFieldMetadatas,+ recordFormPageLayoutTabUniversalIdentifier,+ flatPageLayoutTabMaps: relatedFlatEntityMaps.flatPageLayoutTabMaps,+ flatPageLayoutWidgetMaps:+ relatedFlatEntityMaps.flatPageLayoutWidgetMaps,+ });++ if (!isDefined(flatPageLayoutWidgetToCreate)) {+ return { status: 'noop' };+ }++ return {+ status: 'success',+ operations: {+ pageLayoutWidget: {+ flatEntityToCreate: {+ [flatPageLayoutWidgetToCreate.universalIdentifier]:+ flatPageLayoutWidgetToCreate,+ },+ },+ },+ };+ }++ if (+ !isEligible &&+ isDefined(existingFlatPageLayoutWidget) &&+ existingFlatPageLayoutWidget.isSystemSideEffect === true+ ) {+ return {+ status: 'success',+ operations: {+ pageLayoutWidget: {+ flatEntityToDelete: {+ [existingFlatPageLayoutWidget.universalIdentifier]:+ existingFlatPageLayoutWidget,+ },+ },+ },+ };+ }++ return { status: 'noop' };+ }+}diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/metadata-side-effect-handlers.module.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/metadata-side-effect-handlers.module.tsindex 6397c4267dc..a5751164a4f 100644--- a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/metadata-side-effect-handlers.module.ts+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/metadata-side-effect-handlers.module.ts@@ -2,6 +2,9 @@ import { Module } from '@nestjs/common';import { FieldSearchFieldMetadataOnDeleteSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-search-field-metadata-on-delete-side-effect-handler.service';import { FieldIndexViewFieldOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-index-view-field-on-create-side-effect-handler.service';+import { FieldRecordFormWidgetOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-create-side-effect-handler.service';+import { FieldRecordFormWidgetOnDeleteSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-delete-side-effect-handler.service';+import { FieldRecordFormWidgetOnUpdateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-form-widget-on-update-side-effect-handler.service';import { FieldRecordPageViewFieldOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-record-page-view-field-on-create-side-effect-handler.service';import { FieldSystemViewFieldsOnDeleteSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-system-view-fields-on-delete-side-effect-handler.service';import { FieldUniqueBackingIndexOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/field-metadata/services/field-unique-backing-index-on-create-side-effect-handler.service';@@ -12,6 +15,7 @@ import { ObjectIndexViewOnCreateSideEffectHandlerService } from 'src/engine/metaimport { ObjectNavigationCommandOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-navigation-command-on-create-side-effect-handler.service';import { ObjectNavigationCommandOnUpdateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-navigation-command-on-update-side-effect-handler.service';import { ObjectRecordPageLabelIdentifierOnUpdateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-record-page-label-identifier-on-update-side-effect-handler.service';+import { ObjectRecordFormOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-record-form-on-create-side-effect-handler.service';import { ObjectRecordPageOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-record-page-on-create-side-effect-handler.service';import { ObjectSearchVectorOnCreateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-search-vector-on-create-side-effect-handler.service';import { ObjectSearchVectorOnUpdateSideEffectHandlerService } from 'src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-search-vector-on-update-side-effect-handler.service';@@ -28,12 +32,16 @@ import { ObjectSystemSideEffectsOnDeleteSideEffectHandlerService } from 'src/engFieldSearchFieldMetadataOnDeleteSideEffectHandlerService,FieldIndexViewFieldOnCreateSideEffectHandlerService,FieldRecordPageViewFieldOnCreateSideEffectHandlerService,+ FieldRecordFormWidgetOnCreateSideEffectHandlerService,+ FieldRecordFormWidgetOnDeleteSideEffectHandlerService,+ FieldRecordFormWidgetOnUpdateSideEffectHandlerService,FieldSystemViewFieldsOnDeleteSideEffectHandlerService,ObjectSystemFieldsOnCreateSideEffectHandlerService,ObjectIndexViewOnCreateSideEffectHandlerService,ObjectRecordPageOnCreateSideEffectHandlerService,ObjectNavigationCommandOnCreateSideEffectHandlerService,ObjectNavigationCommandOnUpdateSideEffectHandlerService,+ ObjectRecordFormOnCreateSideEffectHandlerService,ObjectSystemRelationsOnCreateSideEffectHandlerService,ObjectSystemRelationsOnUpdateSideEffectHandlerService,ObjectSearchVectorOnCreateSideEffectHandlerService,diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-record-form-on-create-side-effect-handler.service.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-record-form-on-create-side-effect-handler.service.tsnew file mode 100644index 00000000000..e2c554448a5--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-record-form-on-create-side-effect-handler.service.ts@@ -0,0 +1,46 @@+import { Injectable } from '@nestjs/common';++import { computeSystemRecordFormPageLayoutToCreate } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-record-form-page-layout-to-create.util';+import {+ type BuildSideEffectsArgs,+ MetadataSideEffectHandler,+} from 'src/engine/metadata-modules/metadata-side-effect/interfaces/base-metadata-side-effect-handler.service';+import { type MetadataSideEffectResult } from 'src/engine/metadata-modules/metadata-side-effect/types/metadata-side-effect-result.type';++@Injectable()+export class ObjectRecordFormOnCreateSideEffectHandlerService extends MetadataSideEffectHandler(+ {+ operation: 'create',+ metadataName: 'objectMetadata',+ name: 'objectRecordFormOnCreate',+ description:+ 'When an object is created, provision the shell of its RECORD_FORM page layout: the layout itself and its single "Fields" tab, both empty of widgets. Unlike RECORD_PAGE there is no view underneath: one creatable field is one FORM_FIELD widget, so every widget is owned by fieldRecordFormWidgetOnCreate, whether the field is created in the same batch as the object or later. That single ownership is what keeps the two paths from emitting the same deterministic widget identifier twice. Both entities are isSystemSideEffect with name-free deterministic universal identifiers, so an object rename keeps every identifier.',+ },+) {+ buildSideEffects({+ flatEntity: sourceFlatObjectMetadata,+ }: BuildSideEffectsArgs<'objectMetadata'>): MetadataSideEffectResult {+ const { pageLayout, pageLayoutTab } =+ computeSystemRecordFormPageLayoutToCreate({+ objectMetadata: sourceFlatObjectMetadata,+ applicationUniversalIdentifier:+ sourceFlatObjectMetadata.applicationUniversalIdentifier,+ });++ return {+ status: 'success',+ operations: {+ pageLayout: {+ flatEntityToCreate: {+ [pageLayout.universalIdentifier]: pageLayout,+ },+ },+ pageLayoutTab: {+ flatEntityToCreate: {+ [pageLayoutTab.universalIdentifier]: pageLayoutTab,+ },+ },+ },+ };+ }+}diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-system-side-effects-on-delete-side-effect-handler.service.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-system-side-effects-on-delete-side-effect-handler.service.tsindex f5122bc3eee..9381953aaea 100644--- a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-system-side-effects-on-delete-side-effect-handler.service.ts+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/object-metadata/services/object-system-side-effects-on-delete-side-effect-handler.service.ts@@ -35,7 +35,7 @@ export class ObjectSystemSideEffectsOnDeleteSideEffectHandlerService extends MetmetadataName: 'objectMetadata',name: 'objectSystemSideEffectsOnDelete',description:- 'When an object is deleted, cascade-delete its engine-owned side effects: the reserved system fields, the default relation fields (forward field on the deleted object and reverse morph field on the standard object), every system index (reverse join-column indexes, the GIN searchVector index), its searchFieldMetadata rows, its engine-owned views (the INDEX table view and the FIELDS_WIDGET record-page view) with their view fields and view field groups, its engine-owned record-page layout stack (pageLayout, pageLayoutTab, pageLayoutWidget), and its engine-owned navigation command menu item (provisioned by objectNavigationCommandOnCreate). View fields of the deleted system fields are cascaded too even when they live on another object view, which happens for the reverse relation fields. Every lookup walks a foreign key aggregator down from the deleted object (its fields, indexes, searchFieldMetadatas, views, then their view fields and groups, then its page layouts, their tabs and widgets, and its command menu items) and indexes into the flat entity maps. The engine is the sole authority for isSystemSideEffect entities on delete: the API object delete transpiler cascades only user-authored fields and indexes and emits nothing for the layout stack, and manifest deletion inference excludes these entities entirely, so without these buckets the layout stack would only ever disappear through raw DB foreign key cascade, behind the engine back. Caller-provided defaults (e.g. the name field) are NOT engine-owned and are deleted through normal deletion inference / the object delete transpiler.',+ 'When an object is deleted, cascade-delete its engine-owned side effects: the reserved system fields, the default relation fields (forward field on the deleted object and reverse morph field on the standard object), every system index (reverse join-column indexes, the GIN searchVector index), its searchFieldMetadata rows, its engine-owned views (the INDEX table view and the FIELDS_WIDGET record-page view) with their view fields and view field groups, its engine-owned page layout stacks (pageLayout, pageLayoutTab, pageLayoutWidget), which covers the record page and the record form alike since the walk keeps every isSystemSideEffect layout of the object whatever its type, and its engine-owned navigation command menu item (provisioned by objectNavigationCommandOnCreate). View fields of the deleted system fields are cascaded too even when they live on another object view, which happens for the reverse relation fields. Every lookup walks a foreign key aggregator down from the deleted object (its fields, indexes, searchFieldMetadatas, views, then their view fields and groups, then its page layouts, their tabs and widgets, and its command menu items) and indexes into the flat entity maps. The engine is the sole authority for isSystemSideEffect entities on delete: the API object delete transpiler cascades only user-authored fields and indexes and emits nothing for the layout stack, and manifest deletion inference excludes these entities entirely, so without these buckets the layout stack would only ever disappear through raw DB foreign key cascade, behind the engine back. Caller-provided defaults (e.g. the name field) are NOT engine-owned and are deleted through normal deletion inference / the object delete transpiler.',},) {buildSideEffects({diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/build-system-form-field-page-layout-widget.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/build-system-form-field-page-layout-widget.util.spec.tsnew file mode 100644index 00000000000..c8982994135--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/build-system-form-field-page-layout-widget.util.spec.ts@@ -0,0 +1,75 @@+import {+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier,+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';+import { PageLayoutTabLayoutMode, WidgetType } from 'twenty-shared/types';++import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';++import { buildSystemFormFieldPageLayoutWidget } from '../build-system-form-field-page-layout-widget.util';++const applicationUniversalIdentifier = 'a1a2a3a4-a5a6-4000-8000-000000000001';+const objectUniversalIdentifier = 'b1b2b3b4-b5b6-4000-8000-000000000001';+const fieldUniversalIdentifier = 'c1c2c3c4-c5c6-4000-8000-000000000001';++const derivedPageLayoutTabUniversalIdentifier =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutUniversalIdentifier:+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ objectUniversalIdentifier,+ }),+ title: 'Fields',+ });++describe('buildSystemFormFieldPageLayoutWidget', () => {+ const buildWidget = (index: number) =>+ buildSystemFormFieldPageLayoutWidget({+ applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier: derivedPageLayoutTabUniversalIdentifier,+ objectMetadataUniversalIdentifier: objectUniversalIdentifier,+ flatFieldMetadata: {+ universalIdentifier: fieldUniversalIdentifier,+ },+ index,+ });++ it('should build a system-owned FORM_FIELD widget pointing at the field', () => {+ const widget = buildWidget(0);++ expect(widget.universalIdentifier).toBe(+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier:+ derivedPageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier: fieldUniversalIdentifier,+ }),+ );+ expect(widget.type).toBe(WidgetType.FORM_FIELD);+ expect(widget.title).toBe('');+ expect(widget.universalConfiguration).toEqual({+ configurationType: WidgetConfigurationType.FORM_FIELD,+ fieldMetadataId: fieldUniversalIdentifier,+ });+ expect(widget.isActive).toBe(true);+ expect(widget.isSystemSideEffect).toBe(true);+ });++ it('should place the widget at the given vertical list index', () => {+ expect(buildWidget(3).position).toEqual({+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index: 3,+ });+ });++ it('should keep the same identifier whatever the position', () => {+ expect(buildWidget(0).universalIdentifier).toBe(+ buildWidget(7).universalIdentifier,+ );+ });+});diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-record-form-flat-field-metadatas.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-record-form-flat-field-metadatas.util.spec.tsnew file mode 100644index 00000000000..23a4a371b39--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-record-form-flat-field-metadatas.util.spec.ts@@ -0,0 +1,106 @@+import { FieldMetadataType, RelationType } from 'twenty-shared/types';++import { type RecordFormCandidateFlatFieldMetadata } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util';++import { computeRecordFormFlatFieldMetadatas } from '../compute-record-form-flat-field-metadatas.util';++const buildFlatFieldMetadata = ({+ universalIdentifier,+ name,+ type = FieldMetadataType.TEXT,+ isSystem = false,+ isSystemSideEffect = false,+ isUIEditable = true,+ isActive = true,+ universalSettings = null,+}: {+ universalIdentifier: string;+ name: string;+ type?: FieldMetadataType;+ isSystem?: boolean;+ isSystemSideEffect?: boolean;+ isUIEditable?: boolean;+ isActive?: boolean;+ universalSettings?: Record<string, unknown> | null;+}): RecordFormCandidateFlatFieldMetadata =>+ ({+ universalIdentifier,+ name,+ type,+ isSystem,+ isSystemSideEffect,+ isUIEditable,+ isActive,+ universalSettings,+ }) as RecordFormCandidateFlatFieldMetadata;++const nameField = buildFlatFieldMetadata({+ universalIdentifier: 'field-name',+ name: 'name',+});+const cityField = buildFlatFieldMetadata({+ universalIdentifier: 'field-city',+ name: 'city',+});++describe('computeRecordFormFlatFieldMetadatas', () => {+ it('should place the label identifier first and keep the caller order after it', () => {+ const result = computeRecordFormFlatFieldMetadatas({+ flatFieldMetadatas: [cityField, nameField],+ labelIdentifierFieldMetadataUniversalIdentifier: 'field-name',+ });++ expect(result.map((field) => field.universalIdentifier)).toEqual([+ 'field-name',+ 'field-city',+ ]);+ });++ it.each([+ ['system', { isSystem: true }],+ ['engine owned', { isSystemSideEffect: true }],+ ['not UI editable', { isUIEditable: false }],+ ['inactive', { isActive: false }],+ ['of an unsupported type', { type: FieldMetadataType.POSITION }],+ ])('should drop a %s field', (_label, overrides) => {+ const result = computeRecordFormFlatFieldMetadatas({+ flatFieldMetadatas: [+ nameField,+ buildFlatFieldMetadata({+ universalIdentifier: 'field-dropped',+ name: 'dropped',+ ...overrides,+ }),+ ],+ labelIdentifierFieldMetadataUniversalIdentifier: 'field-name',+ });++ expect(result.map((field) => field.universalIdentifier)).toEqual([+ 'field-name',+ ]);+ });++ it('should keep a many to one relation and drop the other relation types', () => {+ const result = computeRecordFormFlatFieldMetadatas({+ flatFieldMetadatas: [+ buildFlatFieldMetadata({+ universalIdentifier: 'field-company',+ name: 'company',+ type: FieldMetadataType.RELATION,+ universalSettings: { relationType: RelationType.MANY_TO_ONE },+ }),+ buildFlatFieldMetadata({+ universalIdentifier: 'field-people',+ name: 'people',+ type: FieldMetadataType.RELATION,+ universalSettings: { relationType: RelationType.ONE_TO_MANY },+ }),+ ],+ labelIdentifierFieldMetadataUniversalIdentifier: null,+ });++ expect(result.map((field) => field.universalIdentifier)).toEqual([+ 'field-company',+ ]);+ });+});diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-record-form-widget-for-existing-object.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-record-form-widget-for-existing-object.util.spec.tsnew file mode 100644index 00000000000..3f56e8fe472--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-record-form-widget-for-existing-object.util.spec.ts@@ -0,0 +1,291 @@+import {+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';+import { PageLayoutTabLayoutMode, WidgetType } from 'twenty-shared/types';++import { type AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';++import { computeRecordFormWidgetForExistingObject } from '../compute-record-form-widget-for-existing-object.util';++type RecordFormFlatEntityMaps = Pick<+ AllFlatEntityMaps,+ 'flatPageLayoutTabMaps' | 'flatPageLayoutWidgetMaps'+>;++const applicationUniversalIdentifier = 'a1a2a3a4-a5a6-4000-8000-000000000001';+const objectUniversalIdentifier = 'b1b2b3b4-b5b6-4000-8000-000000000001';+const fieldUniversalIdentifier = 'c1c2c3c4-c5c6-4000-8000-000000000001';+const otherFieldUniversalIdentifier = 'c1c2c3c4-c5c6-4000-8000-000000000002';++const pageLayoutTabUniversalIdentifier =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutUniversalIdentifier:+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ objectUniversalIdentifier,+ }),+ title: 'Fields',+ });++const buildFlatFieldMetadata = (universalIdentifier: string) =>+ ({+ universalIdentifier,+ applicationUniversalIdentifier,+ objectMetadataUniversalIdentifier: objectUniversalIdentifier,+ }) as unknown as UniversalFlatFieldMetadata;++const sourceFlatFieldMetadata = buildFlatFieldMetadata(+ fieldUniversalIdentifier,+);++const secondFlatFieldMetadata = buildFlatFieldMetadata(+ otherFieldUniversalIdentifier,+);++const buildFlatPageLayoutTab = (overrides: Record<string, unknown> = {}) => ({+ universalIdentifier: pageLayoutTabUniversalIdentifier,+ isSystemSideEffect: true,+ deletedAt: null,+ widgetUniversalIdentifiers: [],+ ...overrides,+});++const buildFormFieldWidget = ({+ universalIdentifier,+ fieldMetadataId,+ index,+ deletedAt = null,+}: {+ universalIdentifier: string;+ fieldMetadataId: string;+ index: number;+ deletedAt?: string | null;+}) => ({+ universalIdentifier,+ type: WidgetType.FORM_FIELD,+ deletedAt,+ position: {+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index,+ },+ universalConfiguration: {+ configurationType: WidgetConfigurationType.FORM_FIELD,+ fieldMetadataId,+ },+});++const buildMaps = ({+ flatPageLayoutTab,+ flatPageLayoutWidgets = {},+}: {+ flatPageLayoutTab?: ReturnType<typeof buildFlatPageLayoutTab>;+ flatPageLayoutWidgets?: Record<+ string,+ ReturnType<typeof buildFormFieldWidget>+ >;+}): RecordFormFlatEntityMaps =>+ ({+ flatPageLayoutTabMaps: {+ byUniversalIdentifier: flatPageLayoutTab+ ? { [pageLayoutTabUniversalIdentifier]: flatPageLayoutTab }+ : {},+ },+ flatPageLayoutWidgetMaps: {+ byUniversalIdentifier: flatPageLayoutWidgets,+ },+ }) as unknown as RecordFormFlatEntityMaps;++describe('computeRecordFormWidgetForExistingObject', () => {+ it('should append at index 0 on a tab with no widget', () => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({ flatPageLayoutTab: buildFlatPageLayoutTab() }),+ });++ expect(result?.position).toEqual({+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index: 0,+ });+ });++ it('should append after the last existing widget of the tab', () => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({+ flatPageLayoutTab: buildFlatPageLayoutTab({+ widgetUniversalIdentifiers: ['widget-1', 'widget-2'],+ }),+ flatPageLayoutWidgets: {+ 'widget-1': buildFormFieldWidget({+ universalIdentifier: 'widget-1',+ fieldMetadataId: otherFieldUniversalIdentifier,+ index: 0,+ }),+ 'widget-2': buildFormFieldWidget({+ universalIdentifier: 'widget-2',+ fieldMetadataId: 'c1c2c3c4-c5c6-4000-8000-000000000003',+ index: 4,+ }),+ },+ }),+ });++ expect(result?.position).toEqual({+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index: 5,+ });+ });++ it('should give each field of one batch a distinct index', () => {+ const maps = buildMaps({+ flatPageLayoutTab: buildFlatPageLayoutTab({+ widgetUniversalIdentifiers: ['widget-1'],+ }),+ flatPageLayoutWidgets: {+ 'widget-1': buildFormFieldWidget({+ universalIdentifier: 'widget-1',+ fieldMetadataId: 'c1c2c3c4-c5c6-4000-8000-000000000009',+ index: 2,+ }),+ },+ });+ const orderedFormFlatFieldMetadatasInBatch = [+ sourceFlatFieldMetadata,+ secondFlatFieldMetadata,+ ];++ const indexes = orderedFormFlatFieldMetadatasInBatch.map(+ (flatFieldMetadata) =>+ computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata: flatFieldMetadata,+ orderedFormFlatFieldMetadatasInBatch,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ ...maps,+ })?.position,+ );++ expect(indexes).toEqual([+ { layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST, index: 3 },+ { layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST, index: 4 },+ ]);+ });++ it('should noop when the field already has a widget on the tab', () => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({+ flatPageLayoutTab: buildFlatPageLayoutTab({+ widgetUniversalIdentifiers: ['widget-1'],+ }),+ flatPageLayoutWidgets: {+ 'widget-1': buildFormFieldWidget({+ universalIdentifier: 'widget-1',+ fieldMetadataId: fieldUniversalIdentifier,+ index: 0,+ }),+ },+ }),+ });++ expect(result).toBeUndefined();+ });++ it('should ignore a soft deleted widget for both idempotency and indexing', () => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({+ flatPageLayoutTab: buildFlatPageLayoutTab({+ widgetUniversalIdentifiers: ['widget-1'],+ }),+ flatPageLayoutWidgets: {+ 'widget-1': buildFormFieldWidget({+ universalIdentifier: 'widget-1',+ fieldMetadataId: fieldUniversalIdentifier,+ index: 6,+ deletedAt: '2026-08-28T00:00:00.000Z',+ }),+ },+ }),+ });++ expect(result?.position).toEqual({+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index: 0,+ });+ });++ it('should not count another field soft deleted widget toward the append index', () => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({+ flatPageLayoutTab: buildFlatPageLayoutTab({+ widgetUniversalIdentifiers: ['widget-1'],+ }),+ flatPageLayoutWidgets: {+ 'widget-1': buildFormFieldWidget({+ universalIdentifier: 'widget-1',+ fieldMetadataId: otherFieldUniversalIdentifier,+ index: 6,+ deletedAt: '2026-08-28T00:00:00.000Z',+ }),+ },+ }),+ });++ expect(result?.position).toEqual({+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index: 0,+ });+ });++ it('should noop when the object has no engine record form tab', () => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({}),+ });++ expect(result).toBeUndefined();+ });++ it.each([+ ['not engine owned', { isSystemSideEffect: false }],+ ['soft deleted', { deletedAt: '2026-08-28T00:00:00.000Z' }],+ ])('should noop when the record form tab is %s', (_label, overrides) => {+ const result = computeRecordFormWidgetForExistingObject({+ sourceFlatFieldMetadata,+ recordFormPageLayoutTabUniversalIdentifier:+ pageLayoutTabUniversalIdentifier,+ orderedFormFlatFieldMetadatasInBatch: [sourceFlatFieldMetadata],+ ...buildMaps({+ flatPageLayoutTab: buildFlatPageLayoutTab(overrides),+ }),+ });++ expect(result).toBeUndefined();+ });+});diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-record-form-page-layout-to-create.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-record-form-page-layout-to-create.util.spec.tsnew file mode 100644index 00000000000..066861e199d--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-record-form-page-layout-to-create.util.spec.ts@@ -0,0 +1,71 @@+import {+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';+import { PageLayoutTabLayoutMode, PageLayoutType } from 'twenty-shared/types';++import { computeSystemRecordFormPageLayoutToCreate } from '../compute-system-record-form-page-layout-to-create.util';++const applicationUniversalIdentifier = 'a1a2a3a4-a5a6-4000-8000-000000000001';+const objectUniversalIdentifier = 'b1b2b3b4-b5b6-4000-8000-000000000001';++const objectMetadata = {+ universalIdentifier: objectUniversalIdentifier,+};++const derivedPageLayoutUniversalIdentifier =+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ objectUniversalIdentifier,+ });++const derivedPageLayoutTabUniversalIdentifier =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutUniversalIdentifier: derivedPageLayoutUniversalIdentifier,+ title: 'Fields',+ });++describe('computeSystemRecordFormPageLayoutToCreate', () => {+ it('should build a system-owned RECORD_FORM layout on the derived identifier', () => {+ const { pageLayout } = computeSystemRecordFormPageLayoutToCreate({+ applicationUniversalIdentifier,+ objectMetadata,+ });++ expect(pageLayout.universalIdentifier).toBe(+ derivedPageLayoutUniversalIdentifier,+ );+ expect(pageLayout.type).toBe(PageLayoutType.RECORD_FORM);+ expect(pageLayout.name).toBe('Creation Form');+ expect(pageLayout.objectMetadataUniversalIdentifier).toBe(+ objectUniversalIdentifier,+ );+ expect(pageLayout.tabUniversalIdentifiers).toEqual([+ derivedPageLayoutTabUniversalIdentifier,+ ]);+ expect(pageLayout.isSystemSideEffect).toBe(true);+ });++ it('should build a single vertical list tab holding no widget of its own', () => {+ const { pageLayoutTab } = computeSystemRecordFormPageLayoutToCreate({+ applicationUniversalIdentifier,+ objectMetadata,+ });++ expect(pageLayoutTab.universalIdentifier).toBe(+ derivedPageLayoutTabUniversalIdentifier,+ );+ expect(pageLayoutTab.pageLayoutUniversalIdentifier).toBe(+ derivedPageLayoutUniversalIdentifier,+ );+ expect(pageLayoutTab.layoutMode).toBe(+ PageLayoutTabLayoutMode.VERTICAL_LIST,+ );+ expect(pageLayoutTab.widgetUniversalIdentifiers).toEqual([]);+ expect(pageLayoutTab.isActive).toBe(true);+ expect(pageLayoutTab.isSystemSideEffect).toBe(true);+ });+});diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/build-system-form-field-page-layout-widget.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/build-system-form-field-page-layout-widget.util.tsnew file mode 100644index 00000000000..a8703414a0c--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/build-system-form-field-page-layout-widget.util.ts@@ -0,0 +1,52 @@+import { getSystemFormFieldPageLayoutWidgetUniversalIdentifier } from 'twenty-shared/application';+import { PageLayoutTabLayoutMode, WidgetType } from 'twenty-shared/types';++import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';+import { type UniversalFlatPageLayoutWidget } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout-widget.type';++export const buildSystemFormFieldPageLayoutWidget = ({+ applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier,+ objectMetadataUniversalIdentifier,+ flatFieldMetadata,+ index,+}: {+ applicationUniversalIdentifier: string;+ pageLayoutTabUniversalIdentifier: string;+ objectMetadataUniversalIdentifier: string;+ flatFieldMetadata: Pick<UniversalFlatFieldMetadata, 'universalIdentifier'>;+ index: number;+}): UniversalFlatPageLayoutWidget => {+ const now = new Date().toISOString();++ return {+ universalIdentifier: getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier: flatFieldMetadata.universalIdentifier,+ }),+ applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier,+ title: '',+ type: WidgetType.FORM_FIELD,+ position: {+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index,+ },+ universalConfiguration: {+ configurationType: WidgetConfigurationType.FORM_FIELD,+ fieldMetadataId: flatFieldMetadata.universalIdentifier,+ },+ objectMetadataUniversalIdentifier,+ isActive: true,+ isSystemSideEffect: true,+ createdAt: now,+ updatedAt: now,+ deletedAt: null,+ conditionalDisplay: null,+ conditionalAvailabilityExpression: null,+ universalOverrides: null,+ };+};diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-ordered-new-record-form-flat-field-metadatas.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-ordered-new-record-form-flat-field-metadatas.util.tsnew file mode 100644index 00000000000..8fc118d8468--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-ordered-new-record-form-flat-field-metadatas.util.ts@@ -0,0 +1,69 @@+import { getSystemFormFieldPageLayoutWidgetUniversalIdentifier } from 'twenty-shared/application';+import { isDefined } from 'twenty-shared/utils';++import { type AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';+import { type AllFlatEntityOperationRecordByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-operation-record-by-metadata-name.type';+import { computeRecordFormFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util';+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';++// Creations and updates are handled by two handlers but share one index space+// on the tab, so both must rank against the same ordered batch or they collide.+export const computeOrderedNewRecordFormFlatFieldMetadatas = ({+ objectMetadataUniversalIdentifier,+ labelIdentifierFieldMetadataUniversalIdentifier,+ recordFormPageLayoutTabUniversalIdentifier,+ allFlatEntityOperationRecordByMetadataName,+ flatPageLayoutWidgetMaps,+}: {+ objectMetadataUniversalIdentifier: string;+ labelIdentifierFieldMetadataUniversalIdentifier: string | null;+ recordFormPageLayoutTabUniversalIdentifier: string;+ allFlatEntityOperationRecordByMetadataName: AllFlatEntityOperationRecordByMetadataName;+} & Pick<+ AllFlatEntityMaps,+ 'flatPageLayoutWidgetMaps'+>): UniversalFlatFieldMetadata[] => {+ const flatFieldMetadataOperations =+ allFlatEntityOperationRecordByMetadataName.fieldMetadata;++ const candidateFlatFieldMetadatas = [+ ...Object.values(flatFieldMetadataOperations?.flatEntityToCreate ?? {}),+ ...Object.values(flatFieldMetadataOperations?.flatEntityToUpdate ?? {}),+ ].filter(isDefined);++ const seenUniversalIdentifiers = new Set<string>();+ const objectFlatFieldMetadatas = candidateFlatFieldMetadatas.filter(+ (flatFieldMetadata) => {+ if (+ flatFieldMetadata.objectMetadataUniversalIdentifier !==+ objectMetadataUniversalIdentifier ||+ seenUniversalIdentifiers.has(flatFieldMetadata.universalIdentifier)+ ) {+ return false;+ }++ seenUniversalIdentifiers.add(flatFieldMetadata.universalIdentifier);++ return true;+ },+ );++ return computeRecordFormFlatFieldMetadatas({+ flatFieldMetadatas: objectFlatFieldMetadatas,+ labelIdentifierFieldMetadataUniversalIdentifier,+ }).filter(+ (eligibleFlatFieldMetadata) =>+ !isDefined(+ flatPageLayoutWidgetMaps.byUniversalIdentifier[+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier:+ eligibleFlatFieldMetadata.applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier:+ recordFormPageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier:+ eligibleFlatFieldMetadata.universalIdentifier,+ })+ ],+ ),+ );+};diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util.tsnew file mode 100644index 00000000000..151836b6a22--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util.ts@@ -0,0 +1,21 @@+import {+ isFlatFieldMetadataEligibleForRecordForm,+ type RecordFormCandidateFlatFieldMetadata,+} from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util';+import { orderFlatFieldMetadatasForSystemIndexView } from 'src/engine/metadata-modules/object-metadata/utils/order-flat-field-metadatas-for-system-index-view.util';++export const computeRecordFormFlatFieldMetadatas = <+ TFlatFieldMetadata extends RecordFormCandidateFlatFieldMetadata,+>({+ flatFieldMetadatas,+ labelIdentifierFieldMetadataUniversalIdentifier,+}: {+ flatFieldMetadatas: TFlatFieldMetadata[];+ labelIdentifierFieldMetadataUniversalIdentifier: string | null;+}): TFlatFieldMetadata[] =>+ orderFlatFieldMetadatasForSystemIndexView({+ labelIdentifierFieldMetadataUniversalIdentifier,+ flatFieldMetadatas: flatFieldMetadatas.filter(+ isFlatFieldMetadataEligibleForRecordForm,+ ),+ });diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-widget-for-existing-object.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-widget-for-existing-object.util.tsnew file mode 100644index 00000000000..3decc10fa2b--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-widget-for-existing-object.util.ts@@ -0,0 +1,104 @@+import { PageLayoutTabLayoutMode } from 'twenty-shared/types';+import { isDefined } from 'twenty-shared/utils';++import { type AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';+import { buildSystemFormFieldPageLayoutWidget } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/build-system-form-field-page-layout-widget.util';+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';+import { type UniversalFlatPageLayoutWidget } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout-widget.type';++type RecordFormWidgetFlatFieldMetadata = Pick<+ UniversalFlatFieldMetadata,+ | 'universalIdentifier'+ | 'applicationUniversalIdentifier'+ | 'objectMetadataUniversalIdentifier'+>;++export const computeRecordFormWidgetForExistingObject = ({+ sourceFlatFieldMetadata,+ orderedFormFlatFieldMetadatasInBatch,+ recordFormPageLayoutTabUniversalIdentifier,+ flatPageLayoutTabMaps,+ flatPageLayoutWidgetMaps,+}: {+ sourceFlatFieldMetadata: RecordFormWidgetFlatFieldMetadata;+ orderedFormFlatFieldMetadatasInBatch: Pick<+ UniversalFlatFieldMetadata,+ 'universalIdentifier'+ >[];+ recordFormPageLayoutTabUniversalIdentifier: string;+} & Pick<+ AllFlatEntityMaps,+ 'flatPageLayoutTabMaps' | 'flatPageLayoutWidgetMaps'+>): UniversalFlatPageLayoutWidget | undefined => {+ const recordFormFlatPageLayoutTab =+ flatPageLayoutTabMaps.byUniversalIdentifier[+ recordFormPageLayoutTabUniversalIdentifier+ ];++ if (+ !isDefined(recordFormFlatPageLayoutTab) ||+ recordFormFlatPageLayoutTab.isSystemSideEffect !== true ||+ isDefined(recordFormFlatPageLayoutTab.deletedAt)+ ) {+ return undefined;+ }++ const tabFormFieldWidgets =+ recordFormFlatPageLayoutTab.widgetUniversalIdentifiers+ .map(+ (widgetUniversalIdentifier) =>+ flatPageLayoutWidgetMaps.byUniversalIdentifier[+ widgetUniversalIdentifier+ ],+ )+ .filter(isDefined)+ .filter(+ (flatPageLayoutWidget) =>+ !isDefined(flatPageLayoutWidget.deletedAt) &&+ flatPageLayoutWidget.universalConfiguration?.configurationType ===+ WidgetConfigurationType.FORM_FIELD,+ );++ const pairAlreadySynced = tabFormFieldWidgets.some(+ (flatPageLayoutWidget) =>+ flatPageLayoutWidget.universalConfiguration.configurationType ===+ WidgetConfigurationType.FORM_FIELD &&+ flatPageLayoutWidget.universalConfiguration.fieldMetadataId ===+ sourceFlatFieldMetadata.universalIdentifier,+ );++ if (pairAlreadySynced) {+ return undefined;+ }++ const lastExistingIndex = tabFormFieldWidgets.reduce(+ (maxIndex, flatPageLayoutWidget) =>+ flatPageLayoutWidget.position?.layoutMode ===+ PageLayoutTabLayoutMode.VERTICAL_LIST+ ? Math.max(maxIndex, flatPageLayoutWidget.position.index)+ : maxIndex,+ -1,+ );++ const rankInBatch = orderedFormFlatFieldMetadatasInBatch.findIndex(+ (flatFieldMetadata) =>+ flatFieldMetadata.universalIdentifier ===+ sourceFlatFieldMetadata.universalIdentifier,+ );++ if (rankInBatch === -1) {+ return undefined;+ }++ return buildSystemFormFieldPageLayoutWidget({+ applicationUniversalIdentifier:+ sourceFlatFieldMetadata.applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier:+ recordFormPageLayoutTabUniversalIdentifier,+ objectMetadataUniversalIdentifier:+ sourceFlatFieldMetadata.objectMetadataUniversalIdentifier,+ flatFieldMetadata: sourceFlatFieldMetadata,+ index: lastExistingIndex + 1 + rankInBatch,+ });+};diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-record-form-page-layout-to-create.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-record-form-page-layout-to-create.util.tsnew file mode 100644index 00000000000..2e5d92ff7ba--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-record-form-page-layout-to-create.util.ts@@ -0,0 +1,75 @@+import {+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';+import { PageLayoutType } from 'twenty-shared/types';++import {+ RECORD_FORM_PAGE_LAYOUT_NAME,+ RECORD_FORM_TAB_PROPS,+} from 'src/engine/metadata-modules/metadata-side-effect/constants/record-form-tab-props.constant';+import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';+import { type UniversalFlatPageLayoutTab } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout-tab.type';+import { type UniversalFlatPageLayout } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-page-layout.type';++export const computeSystemRecordFormPageLayoutToCreate = ({+ objectMetadata,+ applicationUniversalIdentifier,+}: {+ applicationUniversalIdentifier: string;+ objectMetadata: Pick<UniversalFlatObjectMetadata, 'universalIdentifier'>;+}): {+ pageLayout: UniversalFlatPageLayout;+ pageLayoutTab: UniversalFlatPageLayoutTab;+} => {+ const now = new Date().toISOString();++ const pageLayoutUniversalIdentifier =+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ objectUniversalIdentifier: objectMetadata.universalIdentifier,+ });++ const pageLayoutTabUniversalIdentifier =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutUniversalIdentifier,+ title: RECORD_FORM_TAB_PROPS.title,+ });++ const pageLayoutTab: UniversalFlatPageLayoutTab = {+ universalIdentifier: pageLayoutTabUniversalIdentifier,+ applicationUniversalIdentifier,+ title: RECORD_FORM_TAB_PROPS.title,+ position: RECORD_FORM_TAB_PROPS.position,+ pageLayoutUniversalIdentifier,+ widgetUniversalIdentifiers: [],+ isActive: true,+ isSystemSideEffect: true,+ createdAt: now,+ updatedAt: now,+ deletedAt: null,+ icon: RECORD_FORM_TAB_PROPS.icon,+ layoutMode: RECORD_FORM_TAB_PROPS.layoutMode,+ overrides: null,+ };++ const pageLayout: UniversalFlatPageLayout = {+ universalIdentifier: pageLayoutUniversalIdentifier,+ applicationUniversalIdentifier,+ name: RECORD_FORM_PAGE_LAYOUT_NAME,+ type: PageLayoutType.RECORD_FORM,+ isFirstTabPinned: true,+ objectMetadataUniversalIdentifier: objectMetadata.universalIdentifier,+ tabUniversalIdentifiers: [pageLayoutTabUniversalIdentifier],+ isSystemSideEffect: true,+ createdAt: now,+ updatedAt: now,+ deletedAt: null,+ defaultTabToFocusOnMobileAndSidePanelUniversalIdentifier: null,+ };++ return { pageLayout, pageLayoutTab };+};diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/get-record-form-page-layout-tab-universal-identifier.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/get-record-form-page-layout-tab-universal-identifier.util.tsnew file mode 100644index 00000000000..6f042530815--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/get-record-form-page-layout-tab-universal-identifier.util.ts@@ -0,0 +1,25 @@+import {+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';++import { RECORD_FORM_TAB_PROPS } from 'src/engine/metadata-modules/metadata-side-effect/constants/record-form-tab-props.constant';++export const getRecordFormPageLayoutTabUniversalIdentifier = ({+ objectApplicationUniversalIdentifier,+ objectMetadataUniversalIdentifier,+}: {+ objectApplicationUniversalIdentifier: string;+ objectMetadataUniversalIdentifier: string;+}): string =>+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ objectApplicationUniversalIdentifier,+ pageLayoutUniversalIdentifier:+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ objectApplicationUniversalIdentifier,+ objectUniversalIdentifier: objectMetadataUniversalIdentifier,+ }),+ title: RECORD_FORM_TAB_PROPS.title,+ });diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util.tsnew file mode 100644index 00000000000..84b0bcdcb6f--- /dev/null+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/is-flat-field-metadata-eligible-for-record-form.util.ts@@ -0,0 +1,40 @@+import {+ isDefined,+ isFieldMetadataEligibleForRecordForm,+} from 'twenty-shared/utils';++import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';++export type RecordFormCandidateFlatFieldMetadata = Pick<+ UniversalFlatFieldMetadata,+ | 'universalIdentifier'+ | 'name'+ | 'type'+ | 'isActive'+ | 'isSystem'+ | 'isUIEditable'+ | 'isSystemSideEffect'+ | 'universalSettings'+>;++export const isFlatFieldMetadataEligibleForRecordForm = (+ flatFieldMetadata: RecordFormCandidateFlatFieldMetadata,+): boolean => {+ if (flatFieldMetadata.isSystemSideEffect) {+ return false;+ }++ const { universalSettings } = flatFieldMetadata;++ return isFieldMetadataEligibleForRecordForm({+ fieldName: flatFieldMetadata.name,+ fieldType: flatFieldMetadata.type,+ isActive: flatFieldMetadata.isActive,+ isSystem: flatFieldMetadata.isSystem,+ isUIEditable: flatFieldMetadata.isUIEditable,+ relationType:+ isDefined(universalSettings) && 'relationType' in universalSettings+ ? universalSettings.relationType+ : undefined,+ });+};diff --git a/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/page-layout/__tests__/compute-standard-record-form-flat-entities.util.spec.ts b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/page-layout/__tests__/compute-standard-record-form-flat-entities.util.spec.tsnew file mode 100644index 00000000000..b5071cddc5e--- /dev/null+++ b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/page-layout/__tests__/compute-standard-record-form-flat-entities.util.spec.ts@@ -0,0 +1,109 @@+import {+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';+import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-shared/metadata';+import { PageLayoutType, WidgetType } from 'twenty-shared/types';+import { isDefined } from 'twenty-shared/utils';++import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';+import { TWENTY_STANDARD_APPLICATION } from 'src/engine/workspace-manager/twenty-standard-application/constants/twenty-standard-applications';+import { computeTwentyStandardApplicationAllFlatEntityMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/twenty-standard-application-all-flat-entity-maps.constant';++const { allFlatEntityMaps } = computeTwentyStandardApplicationAllFlatEntityMaps(+ {+ now: '2026-01-01T00:00:00.000Z',+ workspaceId: '20202020-0000-4000-8000-000000000000',+ twentyStandardApplicationId: '20202020-0000-4000-8000-000000000001',+ },+);++const getRecordFormWidgetFieldNames = (objectUniversalIdentifier: string) => {+ const pageLayoutUniversalIdentifier =+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ TWENTY_STANDARD_APPLICATION.universalIdentifier,+ objectUniversalIdentifier,+ });++ const pageLayoutTabUniversalIdentifier =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ TWENTY_STANDARD_APPLICATION.universalIdentifier,+ pageLayoutUniversalIdentifier,+ title: 'Fields',+ });++ const flatPageLayoutTab =+ allFlatEntityMaps.flatPageLayoutTabMaps.byUniversalIdentifier[+ pageLayoutTabUniversalIdentifier+ ];++ if (!isDefined(flatPageLayoutTab)) {+ throw new Error('expected the standard record form tab');+ }++ return flatPageLayoutTab.widgetUniversalIdentifiers+ .map(+ (widgetUniversalIdentifier) =>+ allFlatEntityMaps.flatPageLayoutWidgetMaps.byUniversalIdentifier[+ widgetUniversalIdentifier+ ],+ )+ .filter(isDefined)+ .map((flatPageLayoutWidget) => {+ expect(flatPageLayoutWidget.type).toBe(WidgetType.FORM_FIELD);+ expect(flatPageLayoutWidget.isSystemSideEffect).toBe(true);++ if (+ flatPageLayoutWidget.universalConfiguration.configurationType !==+ WidgetConfigurationType.FORM_FIELD+ ) {+ throw new Error('expected a FORM_FIELD configuration');+ }++ return allFlatEntityMaps.flatFieldMetadataMaps.byUniversalIdentifier[+ flatPageLayoutWidget.universalConfiguration.fieldMetadataId+ ]?.name;+ });+};++describe('computeStandardRecordFormFlatEntities', () => {+ it('should give every standard object a RECORD_FORM layout', () => {+ const recordFormPageLayouts = Object.values(+ allFlatEntityMaps.flatPageLayoutMaps.byUniversalIdentifier,+ )+ .filter(isDefined)+ .filter(+ (flatPageLayout) => flatPageLayout.type === PageLayoutType.RECORD_FORM,+ );++ const objectCount = Object.values(+ allFlatEntityMaps.flatObjectMetadataMaps.byUniversalIdentifier,+ ).filter(isDefined).length;++ expect(recordFormPageLayouts).toHaveLength(objectCount);+ });++ it('should keep the many to one relation of person and drop its one to many ones', () => {+ const fieldNames = getRecordFormWidgetFieldNames(+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person,+ );++ expect(fieldNames).toContain('company');+ expect(fieldNames).not.toContain('taskTargets');+ expect(fieldNames).not.toContain('noteTargets');+ });++ it('should put the label identifier first and drop system fields', () => {+ const fieldNames = getRecordFormWidgetFieldNames(+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company,+ );++ expect(fieldNames[0]).toBe('name');+ expect(fieldNames).not.toContain('id');+ expect(fieldNames).not.toContain('createdAt');+ expect(fieldNames).not.toContain('position');+ expect(fieldNames).not.toContain('searchVector');+ });+});diff --git a/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/page-layout/compute-standard-record-form-flat-entities.util.ts b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/page-layout/compute-standard-record-form-flat-entities.util.tsnew file mode 100644index 00000000000..0b2dc69c6a0--- /dev/null+++ b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/page-layout/compute-standard-record-form-flat-entities.util.ts@@ -0,0 +1,220 @@+import { msg } from '@lingui/core/macro';+import {+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier,+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+} from 'twenty-shared/application';+import {+ PageLayoutTabLayoutMode,+ PageLayoutType,+ WidgetType,+} from 'twenty-shared/types';+import { isDefined } from 'twenty-shared/utils';+import { v4 } from 'uuid';++import { type FlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-maps.type';+import { type FlatFieldMetadata } from 'src/engine/metadata-modules/flat-field-metadata/types/flat-field-metadata.type';+import { type FlatObjectMetadata } from 'src/engine/metadata-modules/flat-object-metadata/types/flat-object-metadata.type';+import { type FlatPageLayoutTab } from 'src/engine/metadata-modules/flat-page-layout-tab/types/flat-page-layout-tab.type';+import { type FlatPageLayoutWidget } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget.type';+import { type FlatPageLayout } from 'src/engine/metadata-modules/flat-page-layout/types/flat-page-layout.type';+import { RECORD_FORM_TAB_PROPS } from 'src/engine/metadata-modules/metadata-side-effect/constants/record-form-tab-props.constant';+import { computeRecordFormFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-record-form-flat-field-metadatas.util';+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';+import { TWENTY_STANDARD_APPLICATION } from 'src/engine/workspace-manager/twenty-standard-application/constants/twenty-standard-applications';+import { i18nLabel } from 'src/engine/workspace-manager/twenty-standard-application/utils/i18n-label.util';++const STANDARD_RECORD_FORM_TAB_TITLE = i18nLabel(+ msg({+ message: `Fields`,+ context: 'pageLayoutTab.title',+ }),+);++const STANDARD_RECORD_FORM_NAME = i18nLabel(+ msg({+ message: `Creation Form`,+ context: 'pageLayout.name',+ }),+);++type ComputeStandardRecordFormFlatEntitiesArgs = {+ now: string;+ workspaceId: string;+ twentyStandardApplicationId: string;+ flatObjectMetadataMaps: FlatEntityMaps<FlatObjectMetadata>;+ flatFieldMetadataMaps: FlatEntityMaps<FlatFieldMetadata>;+};++export const computeStandardRecordFormFlatEntities = ({+ now,+ workspaceId,+ twentyStandardApplicationId,+ flatObjectMetadataMaps,+ flatFieldMetadataMaps,+}: ComputeStandardRecordFormFlatEntitiesArgs): {+ flatPageLayouts: FlatPageLayout[];+ flatPageLayoutTabs: FlatPageLayoutTab[];+ flatPageLayoutWidgets: FlatPageLayoutWidget[];+} => {+ const applicationUniversalIdentifier =+ TWENTY_STANDARD_APPLICATION.universalIdentifier;++ const flatPageLayouts: FlatPageLayout[] = [];+ const flatPageLayoutTabs: FlatPageLayoutTab[] = [];+ const flatPageLayoutWidgets: FlatPageLayoutWidget[] = [];++ const flatFieldMetadatasByObjectUniversalIdentifier = new Map<+ string,+ FlatFieldMetadata[]+ >();++ for (const flatFieldMetadata of Object.values(+ flatFieldMetadataMaps.byUniversalIdentifier,+ )) {+ if (!isDefined(flatFieldMetadata)) {+ continue;+ }++ const objectFlatFieldMetadatas =+ flatFieldMetadatasByObjectUniversalIdentifier.get(+ flatFieldMetadata.objectMetadataUniversalIdentifier,+ ) ?? [];++ objectFlatFieldMetadatas.push(flatFieldMetadata);+ flatFieldMetadatasByObjectUniversalIdentifier.set(+ flatFieldMetadata.objectMetadataUniversalIdentifier,+ objectFlatFieldMetadatas,+ );+ }++ for (const flatObjectMetadata of Object.values(+ flatObjectMetadataMaps.byUniversalIdentifier,+ )) {+ if (!isDefined(flatObjectMetadata)) {+ continue;+ }++ const pageLayoutId = v4();+ const pageLayoutTabId = v4();++ const pageLayoutUniversalIdentifier =+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ objectUniversalIdentifier: flatObjectMetadata.universalIdentifier,+ });++ const pageLayoutTabUniversalIdentifier =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutUniversalIdentifier,+ title: RECORD_FORM_TAB_PROPS.title,+ });++ const orderedFormFlatFieldMetadatas = computeRecordFormFlatFieldMetadatas({+ flatFieldMetadatas:+ flatFieldMetadatasByObjectUniversalIdentifier.get(+ flatObjectMetadata.universalIdentifier,+ ) ?? [],+ labelIdentifierFieldMetadataUniversalIdentifier:+ flatObjectMetadata.labelIdentifierFieldMetadataUniversalIdentifier,+ });++ const objectFlatPageLayoutWidgets: FlatPageLayoutWidget[] =+ orderedFormFlatFieldMetadatas.map((flatFieldMetadata, index) => ({+ id: v4(),+ universalIdentifier:+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier:+ applicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier:+ flatFieldMetadata.universalIdentifier,+ }),+ applicationId: twentyStandardApplicationId,+ applicationUniversalIdentifier,+ workspaceId,+ pageLayoutTabId,+ pageLayoutTabUniversalIdentifier,+ title: '',+ type: WidgetType.FORM_FIELD,+ position: {+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ index,+ },+ configuration: {+ configurationType: WidgetConfigurationType.FORM_FIELD,+ fieldMetadataId: flatFieldMetadata.id,+ },+ universalConfiguration: {+ configurationType: WidgetConfigurationType.FORM_FIELD,+ fieldMetadataId: flatFieldMetadata.universalIdentifier,+ },+ objectMetadataId: flatObjectMetadata.id,+ objectMetadataUniversalIdentifier:+ flatObjectMetadata.universalIdentifier,+ isActive: true,+ isSystemSideEffect: true,+ createdAt: now,+ updatedAt: now,+ deletedAt: null,+ conditionalDisplay: null,+ conditionalAvailabilityExpression: null,+ overrides: null,+ universalOverrides: null,+ }));++ flatPageLayoutWidgets.push(...objectFlatPageLayoutWidgets);++ flatPageLayoutTabs.push({+ id: pageLayoutTabId,+ universalIdentifier: pageLayoutTabUniversalIdentifier,+ applicationId: twentyStandardApplicationId,+ applicationUniversalIdentifier,+ workspaceId,+ title: STANDARD_RECORD_FORM_TAB_TITLE,+ position: RECORD_FORM_TAB_PROPS.position,+ pageLayoutId,+ pageLayoutUniversalIdentifier,+ widgetIds: objectFlatPageLayoutWidgets.map(+ (flatPageLayoutWidget) => flatPageLayoutWidget.id,+ ),+ widgetUniversalIdentifiers: objectFlatPageLayoutWidgets.map(+ (flatPageLayoutWidget) => flatPageLayoutWidget.universalIdentifier,+ ),+ isActive: true,+ isSystemSideEffect: true,+ createdAt: now,+ updatedAt: now,+ deletedAt: null,+ icon: RECORD_FORM_TAB_PROPS.icon,+ layoutMode: RECORD_FORM_TAB_PROPS.layoutMode,+ overrides: null,+ });++ flatPageLayouts.push({+ id: pageLayoutId,+ universalIdentifier: pageLayoutUniversalIdentifier,+ applicationId: twentyStandardApplicationId,+ applicationUniversalIdentifier,+ workspaceId,+ name: STANDARD_RECORD_FORM_NAME,+ type: PageLayoutType.RECORD_FORM,+ isFirstTabPinned: true,+ objectMetadataId: flatObjectMetadata.id,+ objectMetadataUniversalIdentifier: flatObjectMetadata.universalIdentifier,+ isSystemSideEffect: true,+ tabIds: [pageLayoutTabId],+ tabUniversalIdentifiers: [pageLayoutTabUniversalIdentifier],+ createdAt: now,+ updatedAt: now,+ deletedAt: null,+ defaultTabToFocusOnMobileAndSidePanelId: null,+ defaultTabToFocusOnMobileAndSidePanelUniversalIdentifier: null,+ });+ }++ return { flatPageLayouts, flatPageLayoutTabs, flatPageLayoutWidgets };+};diff --git a/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/twenty-standard-application-all-flat-entity-maps.constant.ts b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/twenty-standard-application-all-flat-entity-maps.constant.tsindex 488ea86feda..3311730cbba 100644--- a/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/twenty-standard-application-all-flat-entity-maps.constant.ts+++ b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/twenty-standard-application-all-flat-entity-maps.constant.ts@@ -14,6 +14,8 @@ import { buildStandardFlatNavigationMenuItemMaps } from 'src/engine/workspace-maimport { buildStandardFlatObjectMetadataMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/object-metadata/build-standard-flat-object-metadata-maps.util';import { buildStandardFlatPageLayoutTabMetadataMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/page-layout-tab/build-standard-flat-page-layout-tab-metadata-maps.util';import { buildStandardFlatPageLayoutWidgetMetadataMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/page-layout-widget/build-standard-flat-page-layout-widget-metadata-maps.util';+import { addFlatEntityToFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/add-flat-entity-to-flat-entity-maps-or-throw.util';+import { computeStandardRecordFormFlatEntities } from 'src/engine/workspace-manager/twenty-standard-application/utils/page-layout/compute-standard-record-form-flat-entities.util';import { buildStandardFlatPageLayoutMetadataMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/page-layout/build-standard-flat-page-layout-metadata-maps.util';import { buildStandardFlatPermissionFlagMetadataMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/permission-flag/build-standard-flat-permission-flag-metadata-maps.util';import { buildStandardFlatRoleMetadataMaps } from 'src/engine/workspace-manager/twenty-standard-application/utils/role-metadata/build-standard-flat-role-metadata-maps.util';@@ -205,6 +207,35 @@ export const computeTwentyStandardApplicationAllFlatEntityMaps = ({standardPageLayoutMetadataRelatedEntityIds,});+ const standardRecordFormFlatEntities = computeStandardRecordFormFlatEntities({+ now,+ workspaceId,+ twentyStandardApplicationId,+ flatObjectMetadataMaps,+ flatFieldMetadataMaps,+ });++ const flatPageLayoutMapsWithRecordForms =+ standardRecordFormFlatEntities.flatPageLayouts.reduce(+ (flatEntityMaps, flatEntity) =>+ addFlatEntityToFlatEntityMapsOrThrow({ flatEntity, flatEntityMaps }),+ flatPageLayoutMaps,+ );++ const flatPageLayoutTabMapsWithRecordForms =+ standardRecordFormFlatEntities.flatPageLayoutTabs.reduce(+ (flatEntityMaps, flatEntity) =>+ addFlatEntityToFlatEntityMapsOrThrow({ flatEntity, flatEntityMaps }),+ flatPageLayoutTabMaps,+ );++ const flatPageLayoutWidgetMapsWithRecordForms =+ standardRecordFormFlatEntities.flatPageLayoutWidgets.reduce(+ (flatEntityMaps, flatEntity) =>+ addFlatEntityToFlatEntityMapsOrThrow({ flatEntity, flatEntityMaps }),+ flatPageLayoutWidgetMaps,+ );+const flatNavigationMenuItemMaps = buildStandardFlatNavigationMenuItemMaps({now,workspaceId,@@ -245,9 +276,9 @@ export const computeTwentyStandardApplicationAllFlatEntityMaps = ({flatRoleMaps,flatAgentMaps,flatSkillMaps,- flatPageLayoutMaps,- flatPageLayoutTabMaps,- flatPageLayoutWidgetMaps,+ flatPageLayoutMaps: flatPageLayoutMapsWithRecordForms,+ flatPageLayoutTabMaps: flatPageLayoutTabMapsWithRecordForms,+ flatPageLayoutWidgetMaps: flatPageLayoutWidgetMapsWithRecordForms,flatCommandMenuItemMaps,flatTimelineActivityTypeMaps,};diff --git a/packages/twenty-server/test/integration/metadata/suites/application/__snapshots__/successful-sync-application-workspace-migration.integration-spec.ts.snap b/packages/twenty-server/test/integration/metadata/suites/application/__snapshots__/successful-sync-application-workspace-migration.integration-spec.ts.snapindex f8752c74d17..f149d53d07f 100644--- a/packages/twenty-server/test/integration/metadata/suites/application/__snapshots__/successful-sync-application-workspace-migration.integration-spec.ts.snap+++ b/packages/twenty-server/test/integration/metadata/suites/application/__snapshots__/successful-sync-application-workspace-migration.integration-spec.ts.snap@@ -104,6 +104,35 @@ exports[`syncApplication should create a TEXT field on the standard Company obje"metadataName": "role","type": "create",},+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "conditionalAvailabilityExpression": null,+ "conditionalDisplay": null,+ "createdAt": Any<String>,+ "deletedAt": null,+ "isActive": true,+ "isSystemSideEffect": true,+ "objectMetadataUniversalIdentifier": Any<String>,+ "pageLayoutTabUniversalIdentifier": Any<String>,+ "position": {+ "index": 11,+ "layoutMode": "VERTICAL_LIST",+ },+ "title": "",+ "type": "FORM_FIELD",+ "universalConfiguration": {+ "configurationType": "FORM_FIELD",+ "fieldMetadataId": Any<String>,+ },+ "universalIdentifier": Any<String>,+ "universalOverrides": null,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayoutWidget",+ "type": "create",+ },],"applicationUniversalIdentifier": Any<String>,},@@ -1164,6 +1193,24 @@ exports[`syncApplication should delete old field and create equivalent one when"metadataName": "pageLayout","type": "create",},+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "createdAt": Any<String>,+ "defaultTabToFocusOnMobileAndSidePanelUniversalIdentifier": null,+ "deletedAt": null,+ "isFirstTabPinned": true,+ "isSystemSideEffect": true,+ "name": "Creation Form",+ "objectMetadataUniversalIdentifier": Any<String>,+ "type": "RECORD_FORM",+ "universalIdentifier": Any<String>,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayout",+ "type": "create",+ },{"flatEntity": {"applicationUniversalIdentifier": Any<String>,@@ -1264,6 +1311,55 @@ exports[`syncApplication should delete old field and create equivalent one when"metadataName": "pageLayoutTab","type": "create",},+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "createdAt": Any<String>,+ "deletedAt": null,+ "icon": "IconList",+ "isActive": true,+ "isSystemSideEffect": true,+ "layoutMode": "VERTICAL_LIST",+ "overrides": null,+ "pageLayoutUniversalIdentifier": Any<String>,+ "position": 10,+ "title": "Fields",+ "universalIdentifier": Any<String>,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayoutTab",+ "type": "create",+ },+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "conditionalAvailabilityExpression": null,+ "conditionalDisplay": null,+ "createdAt": Any<String>,+ "deletedAt": null,+ "isActive": true,+ "isSystemSideEffect": true,+ "objectMetadataUniversalIdentifier": Any<String>,+ "pageLayoutTabUniversalIdentifier": Any<String>,+ "position": {+ "index": 0,+ "layoutMode": "VERTICAL_LIST",+ },+ "title": "",+ "type": "FORM_FIELD",+ "universalConfiguration": {+ "configurationType": "FORM_FIELD",+ "fieldMetadataId": Any<String>,+ },+ "universalIdentifier": Any<String>,+ "universalOverrides": null,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayoutWidget",+ "type": "create",+ },{"flatEntity": {"applicationUniversalIdentifier": Any<String>,@@ -1575,6 +1671,70 @@ exports[`syncApplication should delete old field and create equivalent one when"metadataName": "viewField","type": "create",},+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "conditionalAvailabilityExpression": null,+ "conditionalDisplay": null,+ "createdAt": Any<String>,+ "deletedAt": null,+ "gridPosition": {+ "column": 0,+ "columnSpan": 12,+ "row": 0,+ "rowSpan": 1,+ },+ "isActive": true,+ "isSystemSideEffect": true,+ "objectMetadataUniversalIdentifier": Any<String>,+ "pageLayoutTabUniversalIdentifier": Any<String>,+ "position": {+ "index": 0,+ "layoutMode": "VERTICAL_LIST",+ },+ "title": "",+ "type": "FORM_FIELD",+ "universalConfiguration": {+ "configurationType": "FORM_FIELD",+ "fieldMetadataId": Any<String>,+ },+ "universalIdentifier": Any<String>,+ "universalOverrides": null,+ "updatedAt": Any<String>,+ },+ "metadataName": "pageLayoutWidget",+ "type": "delete",+ "universalIdentifier": Any<String>,+ },+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "conditionalAvailabilityExpression": null,+ "conditionalDisplay": null,+ "createdAt": Any<String>,+ "deletedAt": null,+ "isActive": true,+ "isSystemSideEffect": true,+ "objectMetadataUniversalIdentifier": Any<String>,+ "pageLayoutTabUniversalIdentifier": Any<String>,+ "position": {+ "index": 1,+ "layoutMode": "VERTICAL_LIST",+ },+ "title": "",+ "type": "FORM_FIELD",+ "universalConfiguration": {+ "configurationType": "FORM_FIELD",+ "fieldMetadataId": Any<String>,+ },+ "universalIdentifier": Any<String>,+ "universalOverrides": null,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayoutWidget",+ "type": "create",+ },],"applicationUniversalIdentifier": Any<String>,},@@ -2655,6 +2815,24 @@ This is a test skill.","metadataName": "pageLayout","type": "create",},+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "createdAt": Any<String>,+ "defaultTabToFocusOnMobileAndSidePanelUniversalIdentifier": null,+ "deletedAt": null,+ "isFirstTabPinned": true,+ "isSystemSideEffect": true,+ "name": "Creation Form",+ "objectMetadataUniversalIdentifier": Any<String>,+ "type": "RECORD_FORM",+ "universalIdentifier": Any<String>,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayout",+ "type": "create",+ },{"flatEntity": {"applicationUniversalIdentifier": Any<String>,@@ -2755,6 +2933,55 @@ This is a test skill.","metadataName": "pageLayoutTab","type": "create",},+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "createdAt": Any<String>,+ "deletedAt": null,+ "icon": "IconList",+ "isActive": true,+ "isSystemSideEffect": true,+ "layoutMode": "VERTICAL_LIST",+ "overrides": null,+ "pageLayoutUniversalIdentifier": Any<String>,+ "position": 10,+ "title": "Fields",+ "universalIdentifier": Any<String>,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayoutTab",+ "type": "create",+ },+ {+ "flatEntity": {+ "applicationUniversalIdentifier": Any<String>,+ "conditionalAvailabilityExpression": null,+ "conditionalDisplay": null,+ "createdAt": Any<String>,+ "deletedAt": null,+ "isActive": true,+ "isSystemSideEffect": true,+ "objectMetadataUniversalIdentifier": Any<String>,+ "pageLayoutTabUniversalIdentifier": Any<String>,+ "position": {+ "index": 0,+ "layoutMode": "VERTICAL_LIST",+ },+ "title": "",+ "type": "FORM_FIELD",+ "universalConfiguration": {+ "configurationType": "FORM_FIELD",+ "fieldMetadataId": Any<String>,+ },+ "universalIdentifier": Any<String>,+ "universalOverrides": null,+ "updatedAt": Any<String>,+ },+ "id": Any<String>,+ "metadataName": "pageLayoutWidget",+ "type": "create",+ },{"flatEntity": {"applicationUniversalIdentifier": Any<String>,diff --git a/packages/twenty-server/test/integration/metadata/suites/application/record-form-side-effects-manifest-sync.integration-spec.ts b/packages/twenty-server/test/integration/metadata/suites/application/record-form-side-effects-manifest-sync.integration-spec.tsnew file mode 100644index 00000000000..55b41fd4ea2--- /dev/null+++ b/packages/twenty-server/test/integration/metadata/suites/application/record-form-side-effects-manifest-sync.integration-spec.ts@@ -0,0 +1,333 @@+import { buildBaseManifest } from 'test/integration/metadata/suites/application/utils/build-base-manifest.util';+import { buildDefaultObjectManifest } from 'test/integration/metadata/suites/application/utils/build-default-object-manifest.util';+import { cleanupApplicationAndAppRegistration } from 'test/integration/metadata/suites/application/utils/cleanup-application-and-app-registration.util';+import { setupApplicationForSync } from 'test/integration/metadata/suites/application/utils/setup-application-for-sync.util';+import { syncApplication } from 'test/integration/metadata/suites/application/utils/sync-application.util';+import { findManyObjectMetadata } from 'test/integration/metadata/suites/object-metadata/utils/find-many-object-metadata.util';+import { findPageLayoutTabs } from 'test/integration/metadata/suites/page-layout-tab/utils/find-page-layout-tabs.util';+import { findPageLayoutWidgets } from 'test/integration/metadata/suites/page-layout-widget/utils/find-page-layout-widgets.util';+import { findPageLayouts } from 'test/integration/metadata/suites/page-layout/utils/find-page-layouts.util';+import {+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier,+ getSystemPageLayoutTabUniversalIdentifier,+ getSystemRecordFormPageLayoutUniversalIdentifier,+ type ObjectManifest,+} from 'twenty-shared/application';+import { WidgetConfigurationType } from 'src/engine/metadata-modules/page-layout-widget/enums/widget-configuration-type.type';+import {+ FieldMetadataType,+ PageLayoutType,+ WidgetType,+} from 'twenty-shared/types';+import { isDefined } from 'twenty-shared/utils';+import { v4 as uuidv4 } from 'uuid';++const TEST_APP_ID = uuidv4();+const TEST_ROLE_ID = uuidv4();+const TEST_OBJECT_ID = uuidv4();+const NAME_FIELD_ID = uuidv4();+const CODE_FIELD_ID = uuidv4();+const RATING_FIELD_ID = uuidv4();+const RATING_OPTION_ID = uuidv4();++const NAME_FIELD: ObjectManifest['fields'][number] = {+ universalIdentifier: NAME_FIELD_ID,+ type: FieldMetadataType.TEXT,+ name: 'name',+ label: 'Name',+};++const CODE_FIELD: ObjectManifest['fields'][number] = {+ universalIdentifier: CODE_FIELD_ID,+ type: FieldMetadataType.TEXT,+ name: 'code',+ label: 'Code',+};++const RATING_FIELD: ObjectManifest['fields'][number] = {+ universalIdentifier: RATING_FIELD_ID,+ type: FieldMetadataType.RATING,+ name: 'severity',+ label: 'Severity',+ options: [+ {+ id: RATING_OPTION_ID,+ label: '1',+ value: 'RATING_1',+ position: 0,+ },+ ],+};++const buildTicketObject = (additionalFields: ObjectManifest['fields']) =>+ buildDefaultObjectManifest({+ applicationUniversalIdentifier: TEST_APP_ID,+ universalIdentifier: TEST_OBJECT_ID,+ nameSingular: 'ticket',+ namePlural: 'tickets',+ labelSingular: 'Ticket',+ labelPlural: 'Tickets',+ description: 'A support ticket',+ icon: 'IconTicket',+ labelIdentifierFieldMetadataUniversalIdentifier: NAME_FIELD_ID,+ additionalFields,+ });++const buildManifest = (object: ObjectManifest) =>+ buildBaseManifest({+ appId: TEST_APP_ID,+ roleId: TEST_ROLE_ID,+ overrides: { objects: [object] },+ });++const DERIVED_RECORD_FORM_LAYOUT_UNIVERSAL_IDENTIFIER =+ getSystemRecordFormPageLayoutUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier: TEST_APP_ID,+ objectUniversalIdentifier: TEST_OBJECT_ID,+ });++const DERIVED_RECORD_FORM_TAB_UNIVERSAL_IDENTIFIER =+ getSystemPageLayoutTabUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier: TEST_APP_ID,+ pageLayoutUniversalIdentifier:+ DERIVED_RECORD_FORM_LAYOUT_UNIVERSAL_IDENTIFIER,+ title: 'Fields',+ });++const derivedFormFieldWidgetUniversalIdentifier = (+ fieldMetadataUniversalIdentifier: string,+) =>+ getSystemFormFieldPageLayoutWidgetUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier: TEST_APP_ID,+ pageLayoutTabUniversalIdentifier:+ DERIVED_RECORD_FORM_TAB_UNIVERSAL_IDENTIFIER,+ fieldMetadataUniversalIdentifier,+ });++const findTicketObject = async () => {+ const { objects } = await findManyObjectMetadata({+ input: {+ filter: {},+ paging: { first: 100 },+ },+ gqlFields: `+ id+ universalIdentifier+ fieldsList {+ id+ name+ applicationId+ universalIdentifier+ }+ `,+ expectToFail: false,+ });++ return objects.find(+ (object) => object.universalIdentifier === TEST_OBJECT_ID,+ );+};++const findRecordFormTabId = async (objectMetadataId: string) => {+ const { data: pageLayoutsData } = await findPageLayouts({+ input: { objectMetadataId },+ gqlFields:+ 'id type objectMetadataId universalIdentifier applicationId isSystemSideEffect',+ expectToFail: false,+ });++ const recordFormLayout = pageLayoutsData?.getPageLayouts.find(+ (pageLayout) => pageLayout.type === PageLayoutType.RECORD_FORM,+ );++ if (!isDefined(recordFormLayout)) {+ throw new Error('expected the engine record-form layout');+ }++ expect(recordFormLayout.universalIdentifier).toBe(+ DERIVED_RECORD_FORM_LAYOUT_UNIVERSAL_IDENTIFIER,+ );+ expect(recordFormLayout.isSystemSideEffect).toBe(true);++ const { data: tabsData } = await findPageLayoutTabs({+ input: { pageLayoutId: recordFormLayout.id },+ gqlFields: 'id title universalIdentifier isSystemSideEffect',+ expectToFail: false,+ });++ const tabs = tabsData?.getPageLayoutTabs ?? [];++ expect(tabs).toHaveLength(1);+ expect(tabs[0].title).toBe('Fields');+ expect(tabs[0].universalIdentifier).toBe(+ DERIVED_RECORD_FORM_TAB_UNIVERSAL_IDENTIFIER,+ );+ expect(tabs[0].isSystemSideEffect).toBe(true);++ return tabs[0].id;+};++const findRecordFormWidgets = async (pageLayoutTabId: string) => {+ const { data } = await findPageLayoutWidgets({+ input: { pageLayoutTabId },+ gqlFields:+ 'id title type universalIdentifier isSystemSideEffect configuration { ... on FormFieldConfiguration { configurationType fieldMetadataId } }',+ expectToFail: false,+ });++ return (data?.getPageLayoutWidgets ?? []).map((pageLayoutWidget) => ({+ ...pageLayoutWidget,+ formFieldMetadataId:+ pageLayoutWidget.configuration?.configurationType ===+ WidgetConfigurationType.FORM_FIELD+ ? pageLayoutWidget.configuration.fieldMetadataId+ : undefined,+ }));+};++describe('Manifest sync - engine-provisioned record-form stack', () => {+ beforeEach(async () => {+ await setupApplicationForSync({+ applicationUniversalIdentifier: TEST_APP_ID,+ name: 'Test Application',+ description: 'App for testing the engine-provisioned record-form stack',+ sourcePath: 'test-record-form-side-effects',+ });+ }, 60000);++ afterEach(async () => {+ await cleanupApplicationAndAppRegistration({+ applicationUniversalIdentifier: TEST_APP_ID,+ });+ });++ it('provisions the RECORD_FORM layout with one FORM_FIELD widget per creatable field, skipping the types the form has no input for', async () => {+ await syncApplication({+ manifest: buildManifest(+ buildTicketObject([NAME_FIELD, CODE_FIELD, RATING_FIELD]),+ ),+ expectToFail: false,+ });++ const ticket = await findTicketObject();++ if (!isDefined(ticket)) {+ throw new Error('expected the ticket object');+ }++ const recordFormTabId = await findRecordFormTabId(ticket.id);+ const widgets = await findRecordFormWidgets(recordFormTabId);++ const nameField = ticket.fieldsList?.find((field) => field.name === 'name');+ const codeField = ticket.fieldsList?.find((field) => field.name === 'code');++ if (!isDefined(nameField) || !isDefined(codeField)) {+ throw new Error('expected the name and code fields');+ }++ expect(+ widgets.every((widget) => widget.type === WidgetType.FORM_FIELD),+ ).toBe(true);+ expect(widgets.every((widget) => widget.isSystemSideEffect)).toBe(true);++ const widgetFieldMetadataIds = widgets.map(+ (widget) => widget.formFieldMetadataId,+ );++ expect(widgetFieldMetadataIds).toContain(nameField.id);+ expect(widgetFieldMetadataIds).toContain(codeField.id);++ expect(widgets).toHaveLength(2);++ const nameWidget = widgets.find(+ (widget) => widget.formFieldMetadataId === nameField.id,+ );++ expect(nameWidget?.universalIdentifier).toBe(+ derivedFormFieldWidgetUniversalIdentifier(NAME_FIELD_ID),+ );+ }, 60000);++ it('removes the widget when a field stops being UI editable and restores it when it comes back', async () => {+ await syncApplication({+ manifest: buildManifest(buildTicketObject([NAME_FIELD, CODE_FIELD])),+ expectToFail: false,+ });++ const ticket = await findTicketObject();++ if (!isDefined(ticket)) {+ throw new Error('expected the ticket object');+ }++ const recordFormTabId = await findRecordFormTabId(ticket.id);++ await syncApplication({+ manifest: buildManifest(+ buildTicketObject([NAME_FIELD, { ...CODE_FIELD, isUIEditable: false }]),+ ),+ expectToFail: false,+ });++ expect(+ (await findRecordFormWidgets(recordFormTabId)).map(+ (widget) => widget.universalIdentifier,+ ),+ ).toEqual([derivedFormFieldWidgetUniversalIdentifier(NAME_FIELD_ID)]);++ await syncApplication({+ manifest: buildManifest(buildTicketObject([NAME_FIELD, CODE_FIELD])),+ expectToFail: false,+ });++ expect(+ (await findRecordFormWidgets(recordFormTabId)).map(+ (widget) => widget.universalIdentifier,+ ),+ ).toEqual(+ expect.arrayContaining([+ derivedFormFieldWidgetUniversalIdentifier(NAME_FIELD_ID),+ derivedFormFieldWidgetUniversalIdentifier(CODE_FIELD_ID),+ ]),+ );+ }, 60000);++ it('appends a widget for a field added after the object and removes it on field deletion', async () => {+ await syncApplication({+ manifest: buildManifest(buildTicketObject([NAME_FIELD])),+ expectToFail: false,+ });++ await syncApplication({+ manifest: buildManifest(buildTicketObject([NAME_FIELD, CODE_FIELD])),+ expectToFail: false,+ });++ const ticket = await findTicketObject();++ if (!isDefined(ticket)) {+ throw new Error('expected the ticket object');+ }++ const recordFormTabId = await findRecordFormTabId(ticket.id);+ const widgetsAfterAdd = await findRecordFormWidgets(recordFormTabId);++ expect(widgetsAfterAdd.map((widget) => widget.universalIdentifier)).toEqual(+ expect.arrayContaining([+ derivedFormFieldWidgetUniversalIdentifier(NAME_FIELD_ID),+ derivedFormFieldWidgetUniversalIdentifier(CODE_FIELD_ID),+ ]),+ );++ await syncApplication({+ manifest: buildManifest(buildTicketObject([NAME_FIELD])),+ expectToFail: false,+ });++ const widgetsAfterDelete = await findRecordFormWidgets(recordFormTabId);++ expect(+ widgetsAfterDelete.map((widget) => widget.universalIdentifier),+ ).toEqual([derivedFormFieldWidgetUniversalIdentifier(NAME_FIELD_ID)]);+ }, 60000);+});diff --git a/packages/twenty-shared/src/application/deterministic-identifier/get-system-form-field-page-layout-widget-universal-identifier.util.ts b/packages/twenty-shared/src/application/deterministic-identifier/get-system-form-field-page-layout-widget-universal-identifier.util.tsnew file mode 100644index 00000000000..8bb0c361a00--- /dev/null+++ b/packages/twenty-shared/src/application/deterministic-identifier/get-system-form-field-page-layout-widget-universal-identifier.util.ts@@ -0,0 +1,16 @@+import { computeDeterministicUuid } from '@/application/deterministic-identifier/compute-deterministic-uuid.util';++export const getSystemFormFieldPageLayoutWidgetUniversalIdentifier = ({+ fieldMetadataApplicationUniversalIdentifier,+ pageLayoutTabUniversalIdentifier,+ fieldMetadataUniversalIdentifier,+}: {+ fieldMetadataApplicationUniversalIdentifier: string;+ pageLayoutTabUniversalIdentifier: string;+ fieldMetadataUniversalIdentifier: string;+}): string =>+ computeDeterministicUuid({+ entityNamespace: 'pageLayoutWidget',+ value: `${pageLayoutTabUniversalIdentifier}:${fieldMetadataUniversalIdentifier}`,+ applicationUniversalIdentifier: fieldMetadataApplicationUniversalIdentifier,+ });diff --git a/packages/twenty-shared/src/application/deterministic-identifier/get-system-record-form-page-layout-universal-identifier.util.ts b/packages/twenty-shared/src/application/deterministic-identifier/get-system-record-form-page-layout-universal-identifier.util.tsnew file mode 100644index 00000000000..a0b066cd4ac--- /dev/null+++ b/packages/twenty-shared/src/application/deterministic-identifier/get-system-record-form-page-layout-universal-identifier.util.ts@@ -0,0 +1,16 @@+import { getPageLayoutUniversalIdentifier } from '@/application/deterministic-identifier/get-page-layout-universal-identifier.util';+import { PageLayoutType } from '@/types';++export const getSystemRecordFormPageLayoutUniversalIdentifier = ({+ objectMetadataApplicationUniversalIdentifier,+ objectUniversalIdentifier,+}: {+ objectMetadataApplicationUniversalIdentifier: string;+ objectUniversalIdentifier: string;+}): string =>+ getPageLayoutUniversalIdentifier({+ applicationUniversalIdentifier:+ objectMetadataApplicationUniversalIdentifier,+ objectUniversalIdentifier,+ name: PageLayoutType.RECORD_FORM,+ });diff --git a/packages/twenty-shared/src/application/index.ts b/packages/twenty-shared/src/application/index.tsindex e4a899d2db0..498f0a93c3c 100644--- a/packages/twenty-shared/src/application/index.ts+++ b/packages/twenty-shared/src/application/index.ts@@ -97,9 +97,11 @@ export { getRoleUniversalIdentifier } from './deterministic-identifier/get-role-export { getSearchFieldUniversalIdentifier } from './deterministic-identifier/get-search-field-universal-identifier.util';export { getSelectOptionUniversalIdentifier } from './deterministic-identifier/get-select-option-universal-identifier.util';export { getSkillUniversalIdentifier } from './deterministic-identifier/get-skill-universal-identifier.util';+export { getSystemFormFieldPageLayoutWidgetUniversalIdentifier } from './deterministic-identifier/get-system-form-field-page-layout-widget-universal-identifier.util';export { getSystemNavigationCommandMenuItemUniversalIdentifier } from './deterministic-identifier/get-system-navigation-command-menu-item-universal-identifier.util';export { getSystemPageLayoutTabUniversalIdentifier } from './deterministic-identifier/get-system-page-layout-tab-universal-identifier.util';export { getSystemPageLayoutWidgetUniversalIdentifier } from './deterministic-identifier/get-system-page-layout-widget-universal-identifier.util';+export { getSystemRecordFormPageLayoutUniversalIdentifier } from './deterministic-identifier/get-system-record-form-page-layout-universal-identifier.util';export { getSystemRecordPageLayoutUniversalIdentifier } from './deterministic-identifier/get-system-record-page-layout-universal-identifier.util';export { getSystemRelationFieldUniversalIdentifier } from './deterministic-identifier/get-system-relation-field-universal-identifier.util';export { getSystemViewFieldGroupUniversalIdentifier } from './deterministic-identifier/get-system-view-field-group-universal-identifier.util';diff --git a/packages/twenty-shared/src/utils/fieldMetadata/__tests__/isFieldMetadataEligibleForRecordForm.spec.ts b/packages/twenty-shared/src/utils/fieldMetadata/__tests__/isFieldMetadataEligibleForRecordForm.spec.tsnew file mode 100644index 00000000000..219b77e9ad5--- /dev/null+++ b/packages/twenty-shared/src/utils/fieldMetadata/__tests__/isFieldMetadataEligibleForRecordForm.spec.ts@@ -0,0 +1,87 @@+import { FieldMetadataType, RelationType } from '@/types';+import { isFieldMetadataEligibleForRecordForm } from '@/utils/fieldMetadata/isFieldMetadataEligibleForRecordForm';++const ELIGIBLE_TEXT_FIELD = {+ fieldName: 'name',+ fieldType: FieldMetadataType.TEXT,+ isActive: true,+ isSystem: false,+ isUIEditable: true,+};++describe('isFieldMetadataEligibleForRecordForm', () => {+ it('accepts an editable text field', () => {+ expect(isFieldMetadataEligibleForRecordForm(ELIGIBLE_TEXT_FIELD)).toBe(+ true,+ );+ });++ it.each([+ ['inactive', { isActive: false }],+ ['system', { isSystem: true }],+ ['not UI editable', { isUIEditable: false }],+ ])('rejects a %s field', (_label, overrides) => {+ expect(+ isFieldMetadataEligibleForRecordForm({+ ...ELIGIBLE_TEXT_FIELD,+ ...overrides,+ }),+ ).toBe(false);+ });++ it('rejects the id field', () => {+ expect(+ isFieldMetadataEligibleForRecordForm({+ ...ELIGIBLE_TEXT_FIELD,+ fieldName: 'id',+ fieldType: FieldMetadataType.UUID,+ }),+ ).toBe(false);+ });++ it.each([+ FieldMetadataType.TS_VECTOR,+ FieldMetadataType.POSITION,+ FieldMetadataType.ACTOR,+ FieldMetadataType.RATING,+ FieldMetadataType.FILES,+ FieldMetadataType.NUMERIC,+ ])('rejects the unsupported type %s', (fieldType) => {+ expect(+ isFieldMetadataEligibleForRecordForm({+ ...ELIGIBLE_TEXT_FIELD,+ fieldType,+ }),+ ).toBe(false);+ });++ it('accepts a many to one relation', () => {+ expect(+ isFieldMetadataEligibleForRecordForm({+ ...ELIGIBLE_TEXT_FIELD,+ fieldType: FieldMetadataType.RELATION,+ relationType: RelationType.MANY_TO_ONE,+ }),+ ).toBe(true);+ });++ it('rejects a one to many relation', () => {+ expect(+ isFieldMetadataEligibleForRecordForm({+ ...ELIGIBLE_TEXT_FIELD,+ fieldType: FieldMetadataType.RELATION,+ relationType: RelationType.ONE_TO_MANY,+ }),+ ).toBe(false);+ });++ it('rejects a relation with no relation type', () => {+ expect(+ isFieldMetadataEligibleForRecordForm({+ ...ELIGIBLE_TEXT_FIELD,+ fieldType: FieldMetadataType.MORPH_RELATION,+ relationType: null,+ }),+ ).toBe(false);+ });+});diff --git a/packages/twenty-shared/src/utils/fieldMetadata/isFieldMetadataEligibleForRecordForm.ts b/packages/twenty-shared/src/utils/fieldMetadata/isFieldMetadataEligibleForRecordForm.tsnew file mode 100644index 00000000000..72f06324ec6--- /dev/null+++ b/packages/twenty-shared/src/utils/fieldMetadata/isFieldMetadataEligibleForRecordForm.ts@@ -0,0 +1,61 @@+import { FieldMetadataType, RelationType } from '@/types';++const RECORD_FORM_SUPPORTED_FIELD_TYPES: readonly FieldMetadataType[] = [+ FieldMetadataType.ADDRESS,+ FieldMetadataType.ARRAY,+ FieldMetadataType.BOOLEAN,+ FieldMetadataType.CURRENCY,+ FieldMetadataType.DATE,+ FieldMetadataType.DATE_TIME,+ FieldMetadataType.EMAILS,+ FieldMetadataType.FULL_NAME,+ FieldMetadataType.LINKS,+ FieldMetadataType.MORPH_RELATION,+ FieldMetadataType.MULTI_SELECT,+ FieldMetadataType.NUMBER,+ FieldMetadataType.PHONES,+ FieldMetadataType.RAW_JSON,+ FieldMetadataType.RELATION,+ FieldMetadataType.RICH_TEXT,+ FieldMetadataType.SELECT,+ FieldMetadataType.TEXT,+ FieldMetadataType.UUID,+];++export const isFieldMetadataEligibleForRecordForm = ({+ fieldName,+ fieldType,+ isActive,+ isSystem,+ isUIEditable,+ relationType,+}: {+ fieldName: string;+ fieldType: FieldMetadataType;+ isActive: boolean;+ isSystem: boolean;+ isUIEditable: boolean;+ relationType?: RelationType | null;+}): boolean => {+ if (!isActive || isSystem || !isUIEditable) {+ return false;+ }++ if (fieldName === 'id') {+ return false;+ }++ if (!RECORD_FORM_SUPPORTED_FIELD_TYPES.includes(fieldType)) {+ return false;+ }++ const isRelationField =+ fieldType === FieldMetadataType.RELATION ||+ fieldType === FieldMetadataType.MORPH_RELATION;++ if (isRelationField && relationType !== RelationType.MANY_TO_ONE) {+ return false;+ }++ return true;+};diff --git a/packages/twenty-shared/src/utils/index.ts b/packages/twenty-shared/src/utils/index.tsindex ea25fbf3668..b19dd1ec1e2 100644--- a/packages/twenty-shared/src/utils/index.ts+++ b/packages/twenty-shared/src/utils/index.ts@@ -65,6 +65,7 @@ export {export { isFieldMetadataArrayKind } from './fieldMetadata/isFieldMetadataArrayKind';export { isFieldMetadataDateKind } from './fieldMetadata/isFieldMetadataDateKind';export { isFieldMetadataEligibleForFieldsWidget } from './fieldMetadata/isFieldMetadataEligibleForFieldsWidget';+export { isFieldMetadataEligibleForRecordForm } from './fieldMetadata/isFieldMetadataEligibleForRecordForm';export { isFieldMetadataEnumKind } from './fieldMetadata/isFieldMetadataEnumKind';export { isFieldMetadataNumericKind } from './fieldMetadata/isFieldMetadataNumericKind';export { isFieldMetadataSelectKind } from './fieldMetadata/isFieldMetadataSelectKind';