Skip to content

The open alternative to Salesforce, designed for AI.

Add the related record path metadata entity (#29229)

Charles Bochetd2e90a727b18
diff --git a/packages/twenty-client-sdk/src/metadata/generated/schema.graphql b/packages/twenty-client-sdk/src/metadata/generated/schema.graphql
index a3b7cef3a84..2ab0981360f 100644
--- a/packages/twenty-client-sdk/src/metadata/generated/schema.graphql
+++ b/packages/twenty-client-sdk/src/metadata/generated/schema.graphql
@@ -296,6 +296,7 @@ enum AllMetadataName {
pageLayoutTab
pageLayoutWidget
permissionFlag
+ relatedRecordPath
role
rolePermissionFlag
roleTarget
diff --git a/packages/twenty-client-sdk/src/metadata/generated/schema.ts b/packages/twenty-client-sdk/src/metadata/generated/schema.ts
index f326fa236df..1a33324a72a 100644
--- a/packages/twenty-client-sdk/src/metadata/generated/schema.ts
+++ b/packages/twenty-client-sdk/src/metadata/generated/schema.ts
@@ -252,7 +252,7 @@ export interface AiSystemPromptSection {
__typename: 'AiSystemPromptSection'
}
-export type AllMetadataName = 'agent' | 'agentChatChannel' | 'agentChatChannelRole' | 'applicationVariable' | 'commandMenuItem' | 'connectionProvider' | 'fieldMetadata' | 'fieldPermission' | 'frontComponent' | 'index' | 'logicFunction' | 'mcpServer' | 'messagingProvider' | 'navigationMenuItem' | 'objectMetadata' | 'objectPermission' | 'pageLayout' | 'pageLayoutTab' | 'pageLayoutWidget' | 'permissionFlag' | 'role' | 'rolePermissionFlag' | 'roleTarget' | 'rowLevelPermissionPredicate' | 'rowLevelPermissionPredicateGroup' | 'searchFieldMetadata' | 'settingsMenuItem' | 'skill' | 'timelineActivityType' | 'validationRule' | 'view' | 'viewField' | 'viewFieldGroup' | 'viewFilter' | 'viewFilterGroup' | 'viewGroup' | 'viewSort' | 'webhook' | 'workflow' | 'workflowVersion'
+export type AllMetadataName = 'agent' | 'agentChatChannel' | 'agentChatChannelRole' | 'applicationVariable' | 'commandMenuItem' | 'connectionProvider' | 'fieldMetadata' | 'fieldPermission' | 'frontComponent' | 'index' | 'logicFunction' | 'mcpServer' | 'messagingProvider' | 'navigationMenuItem' | 'objectMetadata' | 'objectPermission' | 'pageLayout' | 'pageLayoutTab' | 'pageLayoutWidget' | 'permissionFlag' | 'relatedRecordPath' | 'role' | 'rolePermissionFlag' | 'roleTarget' | 'rowLevelPermissionPredicate' | 'rowLevelPermissionPredicateGroup' | 'searchFieldMetadata' | 'settingsMenuItem' | 'skill' | 'timelineActivityType' | 'validationRule' | 'view' | 'viewField' | 'viewFieldGroup' | 'viewFilter' | 'viewFilterGroup' | 'viewGroup' | 'viewSort' | 'webhook' | 'workflow' | 'workflowVersion'
export interface Analytics {
/** Boolean that confirms query was dispatched */
@@ -11960,6 +11960,7 @@ export const enumAllMetadataName = {
pageLayoutTab: 'pageLayoutTab' as const,
pageLayoutWidget: 'pageLayoutWidget' as const,
permissionFlag: 'permissionFlag' as const,
+ relatedRecordPath: 'relatedRecordPath' as const,
role: 'role' as const,
rolePermissionFlag: 'rolePermissionFlag' as const,
roleTarget: 'roleTarget' as const,
diff --git a/packages/twenty-front/src/generated-metadata/schema.ts b/packages/twenty-front/src/generated-metadata/schema.ts
index 9097cccf4e7..8f06b88800b 100644
--- a/packages/twenty-front/src/generated-metadata/schema.ts
+++ b/packages/twenty-front/src/generated-metadata/schema.ts
@@ -332,6 +332,7 @@ export enum AllMetadataName {
pageLayoutTab = 'pageLayoutTab',
pageLayoutWidget = 'pageLayoutWidget',
permissionFlag = 'permissionFlag',
+ relatedRecordPath = 'relatedRecordPath',
role = 'role',
rolePermissionFlag = 'rolePermissionFlag',
roleTarget = 'roleTarget',
diff --git a/packages/twenty-front/src/modules/metadata-error-handler/hooks/useMetadataErrorHandler.ts b/packages/twenty-front/src/modules/metadata-error-handler/hooks/useMetadataErrorHandler.ts
index 7bf488f9d11..94473724d69 100644
--- a/packages/twenty-front/src/modules/metadata-error-handler/hooks/useMetadataErrorHandler.ts
+++ b/packages/twenty-front/src/modules/metadata-error-handler/hooks/useMetadataErrorHandler.ts
@@ -57,6 +57,7 @@ export const useMetadataErrorHandler = () => {
searchFieldMetadata: t`search field metadata`,
timelineActivityType: t`timeline activity type`,
settingsMenuItem: t`settings menu item`,
+ relatedRecordPath: t`related record path`,
validationRule: t`validation rule`,
workflow: t`workflow`,
workflowVersion: t`workflow version`,
diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/2-54/2-54-instance-command-fast-1793291361887-add-related-record-path-table.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/2-54/2-54-instance-command-fast-1793291361887-add-related-record-path-table.ts
new file mode 100644
index 00000000000..81d1aa3e5f5
--- /dev/null
+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/2-54/2-54-instance-command-fast-1793291361887-add-related-record-path-table.ts
@@ -0,0 +1,45 @@
+import { QueryRunner } from 'typeorm';
+
+import { RegisteredInstanceCommand } from 'src/engine/core-modules/upgrade/decorators/registered-instance-command.decorator';
+import { FastInstanceCommand } from 'src/engine/core-modules/upgrade/interfaces/fast-instance-command.interface';
+
+@RegisteredInstanceCommand('2.54.0', 1793291361887)
+export class AddRelatedRecordPathTableFastInstanceCommand implements FastInstanceCommand {
+ public async up(queryRunner: QueryRunner): Promise<void> {
+ await queryRunner.query('CREATE TABLE "core"."relatedRecordPath" ("workspaceId" uuid NOT NULL, "universalIdentifier" uuid NOT NULL, "applicationId" uuid NOT NULL, "id" uuid NOT NULL DEFAULT uuid_generate_v4(), "objectMetadataId" uuid NOT NULL, "firstFieldMetadataId" uuid NOT NULL, "secondFieldMetadataId" uuid, "thirdFieldMetadataId" uuid, "createdAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(), "updatedAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT now(), CONSTRAINT "PK_5105d98eee85b6a1e674109ba3d" PRIMARY KEY ("id"))');
+ await queryRunner.query('CREATE UNIQUE INDEX "IDX_054f9c52cf0e890640683d0a4a" ON "core"."relatedRecordPath" ("workspaceId", "universalIdentifier") ');
+ await queryRunner.query('CREATE INDEX "IDX_RELATED_RECORD_PATH_THIRD_FIELD_METADATA_ID" ON "core"."relatedRecordPath" ("thirdFieldMetadataId") ');
+ await queryRunner.query('CREATE INDEX "IDX_RELATED_RECORD_PATH_SECOND_FIELD_METADATA_ID" ON "core"."relatedRecordPath" ("secondFieldMetadataId") ');
+ await queryRunner.query('CREATE INDEX "IDX_RELATED_RECORD_PATH_FIRST_FIELD_METADATA_ID" ON "core"."relatedRecordPath" ("firstFieldMetadataId") ');
+ await queryRunner.query('CREATE INDEX "IDX_RELATED_RECORD_PATH_OBJECT_METADATA_ID" ON "core"."relatedRecordPath" ("objectMetadataId") ');
+ await queryRunner.query('CREATE INDEX "IDX_RELATED_RECORD_PATH_APPLICATION_ID" ON "core"."relatedRecordPath" ("applicationId") ');
+ await queryRunner.query('CREATE UNIQUE INDEX "IDX_RELATED_RECORD_PATH_UNIQUE_THREE_HOPS" ON "core"."relatedRecordPath" ("firstFieldMetadataId", "secondFieldMetadataId", "thirdFieldMetadataId") WHERE "thirdFieldMetadataId" IS NOT NULL');
+ await queryRunner.query('CREATE UNIQUE INDEX "IDX_RELATED_RECORD_PATH_UNIQUE_TWO_HOPS" ON "core"."relatedRecordPath" ("firstFieldMetadataId", "secondFieldMetadataId") WHERE "secondFieldMetadataId" IS NOT NULL AND "thirdFieldMetadataId" IS NULL');
+ await queryRunner.query('CREATE UNIQUE INDEX "IDX_RELATED_RECORD_PATH_UNIQUE_ONE_HOP" ON "core"."relatedRecordPath" ("firstFieldMetadataId") WHERE "secondFieldMetadataId" IS NULL');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" ADD CONSTRAINT "FK_623b51b39f35e8166ab756cf516" FOREIGN KEY ("workspaceId") REFERENCES "core"."workspace"("id") ON DELETE CASCADE ON UPDATE NO ACTION');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" ADD CONSTRAINT "FK_9caff61edf6734e6ec7e08d7863" FOREIGN KEY ("applicationId") REFERENCES "core"."application"("id") ON DELETE CASCADE ON UPDATE NO ACTION');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" ADD CONSTRAINT "FK_8c0230764deef4970404480a259" FOREIGN KEY ("objectMetadataId") REFERENCES "core"."objectMetadata"("id") ON DELETE CASCADE ON UPDATE NO ACTION');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" ADD CONSTRAINT "FK_49d185010a658fe0c23d90ee658" FOREIGN KEY ("firstFieldMetadataId") REFERENCES "core"."fieldMetadata"("id") ON DELETE CASCADE ON UPDATE NO ACTION');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" ADD CONSTRAINT "FK_c15bed1409e7a69ac2dfbbd6ea4" FOREIGN KEY ("secondFieldMetadataId") REFERENCES "core"."fieldMetadata"("id") ON DELETE CASCADE ON UPDATE NO ACTION');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" ADD CONSTRAINT "FK_5edcdacfe9a320166f833bd951d" FOREIGN KEY ("thirdFieldMetadataId") REFERENCES "core"."fieldMetadata"("id") ON DELETE CASCADE ON UPDATE NO ACTION');
+ }
+
+ public async down(queryRunner: QueryRunner): Promise<void> {
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" DROP CONSTRAINT "FK_5edcdacfe9a320166f833bd951d"');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" DROP CONSTRAINT "FK_c15bed1409e7a69ac2dfbbd6ea4"');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" DROP CONSTRAINT "FK_49d185010a658fe0c23d90ee658"');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" DROP CONSTRAINT "FK_8c0230764deef4970404480a259"');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" DROP CONSTRAINT "FK_9caff61edf6734e6ec7e08d7863"');
+ await queryRunner.query('ALTER TABLE "core"."relatedRecordPath" DROP CONSTRAINT "FK_623b51b39f35e8166ab756cf516"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_UNIQUE_ONE_HOP"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_UNIQUE_TWO_HOPS"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_UNIQUE_THREE_HOPS"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_APPLICATION_ID"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_OBJECT_METADATA_ID"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_FIRST_FIELD_METADATA_ID"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_SECOND_FIELD_METADATA_ID"');
+ await queryRunner.query('DROP INDEX "core"."IDX_RELATED_RECORD_PATH_THIRD_FIELD_METADATA_ID"');
+ await queryRunner.query('DROP INDEX "core"."IDX_054f9c52cf0e890640683d0a4a"');
+ await queryRunner.query('DROP TABLE "core"."relatedRecordPath"');
+ }
+}
diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/2-54/add-related-record-path-table-upgrade-command-name.constant.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/2-54/add-related-record-path-table-upgrade-command-name.constant.ts
new file mode 100644
index 00000000000..9924a984c8f
--- /dev/null
+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/2-54/add-related-record-path-table-upgrade-command-name.constant.ts
@@ -0,0 +1,2 @@
+export const ADD_RELATED_RECORD_PATH_TABLE_UPGRADE_COMMAND_NAME =
+ '2.54.0_AddRelatedRecordPathTableFastInstanceCommand_1793291361887';
diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/instance-commands.constant.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/instance-commands.constant.ts
index f7cedb92fbb..041e27222a6 100644
--- a/packages/twenty-server/src/database/commands/upgrade-version-command/instance-commands.constant.ts
+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/instance-commands.constant.ts
@@ -269,6 +269,7 @@ import { UnlistUnreviewedApplicationRegistrationsSlowInstanceCommand } from 'src
import { PurgeSoftDeletedAgentsSlowInstanceCommand } from 'src/database/commands/upgrade-version-command/2-54/2-54-instance-command-slow-1793272266091-purge-soft-deleted-agents';
import { AddGeolocationToUserSessionFastInstanceCommand } from 'src/database/commands/upgrade-version-command/2-54/2-54-instance-command-fast-1793274494191-add-geolocation-to-user-session';
import { AddWorkspaceChatAssistantModesFastInstanceCommand } from 'src/database/commands/upgrade-version-command/2-54/2-54-instance-command-fast-1793280483473-add-workspace-chat-assistant-modes';
+import { AddRelatedRecordPathTableFastInstanceCommand } from 'src/database/commands/upgrade-version-command/2-54/2-54-instance-command-fast-1793291361887-add-related-record-path-table';
export const INSTANCE_COMMANDS = [
AddViewFieldGroupIdIndexOnViewFieldFastInstanceCommand,
@@ -540,4 +541,5 @@ export const INSTANCE_COMMANDS = [
PurgeSoftDeletedAgentsSlowInstanceCommand,
AddGeolocationToUserSessionFastInstanceCommand,
AddWorkspaceChatAssistantModesFastInstanceCommand,
+ AddRelatedRecordPathTableFastInstanceCommand,
];
diff --git a/packages/twenty-server/src/engine/core-modules/application/application-manifest/utils/find-manifest-entity-descriptor-by-universal-identifier.util.ts b/packages/twenty-server/src/engine/core-modules/application/application-manifest/utils/find-manifest-entity-descriptor-by-universal-identifier.util.ts
index a5130d29c2b..3be40c7d20d 100644
--- a/packages/twenty-server/src/engine/core-modules/application/application-manifest/utils/find-manifest-entity-descriptor-by-universal-identifier.util.ts
+++ b/packages/twenty-server/src/engine/core-modules/application/application-manifest/utils/find-manifest-entity-descriptor-by-universal-identifier.util.ts
@@ -296,6 +296,10 @@ export const MANIFEST_ENTITY_REGISTRY: Record<
entityKind: 'workflow version',
getCandidates: () => NO_MANIFEST_CANDIDATES,
},
+ relatedRecordPath: {
+ entityKind: 'related record path',
+ getCandidates: () => NO_MANIFEST_CANDIDATES,
+ },
validationRule: {
entityKind: 'validation rule',
getCandidates: () => NO_MANIFEST_CANDIDATES,
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/all-universal-flat-entity-properties-to-compare-and-stringify.constant.spec.ts.snap b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/all-universal-flat-entity-properties-to-compare-and-stringify.constant.spec.ts.snap
index 648d7ef28dc..998f8cb013f 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/all-universal-flat-entity-properties-to-compare-and-stringify.constant.spec.ts.snap
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/all-universal-flat-entity-properties-to-compare-and-stringify.constant.spec.ts.snap
@@ -322,6 +322,15 @@ exports[`ALL_UNIVERSAL_FLAT_ENTITY_PROPERTIES_TO_COMPARE_AND_STRINGIFY should ma
],
"propertiesToStringify": [],
},
+ "relatedRecordPath": {
+ "propertiesToCompare": [
+ "objectMetadataUniversalIdentifier",
+ "firstFieldMetadataUniversalIdentifier",
+ "secondFieldMetadataUniversalIdentifier",
+ "thirdFieldMetadataUniversalIdentifier",
+ ],
+ "propertiesToStringify": [],
+ },
"role": {
"propertiesToCompare": [
"label",
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/overridable-and-translatable-properties.constant.spec.ts.snap b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/overridable-and-translatable-properties.constant.spec.ts.snap
index 1080dc3e756..f7ab553265d 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/overridable-and-translatable-properties.constant.spec.ts.snap
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/__tests__/__snapshots__/overridable-and-translatable-properties.constant.spec.ts.snap
@@ -69,6 +69,7 @@ exports[`registry-derived override property maps derives the overridable propert
"isActive",
],
"permissionFlag": [],
+ "relatedRecordPath": [],
"role": [],
"rolePermissionFlag": [],
"roleTarget": [],
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-entity-properties-configuration-by-metadata-name.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-entity-properties-configuration-by-metadata-name.constant.ts
index bd8b01030e6..25f005c829f 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-entity-properties-configuration-by-metadata-name.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-entity-properties-configuration-by-metadata-name.constant.ts
@@ -2199,6 +2199,38 @@ export const ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME = {
universalProperty: undefined,
},
},
+ relatedRecordPath: {
+ objectMetadataId: {
+ toCompare: true,
+ toStringify: false,
+ universalProperty: 'objectMetadataUniversalIdentifier',
+ },
+ firstFieldMetadataId: {
+ toCompare: true,
+ toStringify: false,
+ universalProperty: 'firstFieldMetadataUniversalIdentifier',
+ },
+ secondFieldMetadataId: {
+ toCompare: true,
+ toStringify: false,
+ universalProperty: 'secondFieldMetadataUniversalIdentifier',
+ },
+ thirdFieldMetadataId: {
+ toCompare: true,
+ toStringify: false,
+ universalProperty: 'thirdFieldMetadataUniversalIdentifier',
+ },
+ createdAt: {
+ toCompare: false,
+ toStringify: false,
+ universalProperty: undefined,
+ },
+ updatedAt: {
+ toCompare: false,
+ toStringify: false,
+ universalProperty: undefined,
+ },
+ },
validationRule: {
objectMetadataId: {
toCompare: false,
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-foreign-key.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-foreign-key.constant.ts
index 71e078ea4c0..a405c9d9540 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-foreign-key.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-foreign-key.constant.ts
@@ -352,6 +352,22 @@ export const ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY = {
foreignKey: 'tsVectorFieldMetadataId',
},
},
+ relatedRecordPath: {
+ workspace: null,
+ application: null,
+ objectMetadata: {
+ foreignKey: 'objectMetadataId',
+ },
+ firstFieldMetadata: {
+ foreignKey: 'firstFieldMetadataId',
+ },
+ secondFieldMetadata: {
+ foreignKey: 'secondFieldMetadataId',
+ },
+ thirdFieldMetadata: {
+ foreignKey: 'thirdFieldMetadataId',
+ },
+ },
validationRule: {
workspace: null,
application: null,
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-relations.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-relations.constant.ts
index d71e2083914..56a9ac33f30 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-relations.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-many-to-one-metadata-relations.constant.ts
@@ -616,6 +616,38 @@ export const ALL_MANY_TO_ONE_METADATA_RELATIONS = {
universalForeignKey: 'tsVectorFieldMetadataUniversalIdentifier',
},
},
+ relatedRecordPath: {
+ workspace: null,
+ application: null,
+ objectMetadata: {
+ metadataName: 'objectMetadata',
+ foreignKey: 'objectMetadataId',
+ inverseOneToManyProperty: null,
+ isNullable: false,
+ universalForeignKey: 'objectMetadataUniversalIdentifier',
+ },
+ firstFieldMetadata: {
+ metadataName: 'fieldMetadata',
+ foreignKey: 'firstFieldMetadataId',
+ inverseOneToManyProperty: null,
+ isNullable: false,
+ universalForeignKey: 'firstFieldMetadataUniversalIdentifier',
+ },
+ secondFieldMetadata: {
+ metadataName: 'fieldMetadata',
+ foreignKey: 'secondFieldMetadataId',
+ inverseOneToManyProperty: null,
+ isNullable: true,
+ universalForeignKey: 'secondFieldMetadataUniversalIdentifier',
+ },
+ thirdFieldMetadata: {
+ metadataName: 'fieldMetadata',
+ foreignKey: 'thirdFieldMetadataId',
+ inverseOneToManyProperty: null,
+ isNullable: true,
+ universalForeignKey: 'thirdFieldMetadataUniversalIdentifier',
+ },
+ },
validationRule: {
workspace: null,
application: null,
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-entity-by-metadata-name.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-entity-by-metadata-name.constant.ts
index 44e026d0665..a82f3306581 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-entity-by-metadata-name.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-entity-by-metadata-name.constant.ts
@@ -38,6 +38,7 @@ import { ViewGroupEntity } from 'src/engine/metadata-modules/view-group/entities
import { ViewEntity } from 'src/engine/metadata-modules/view/entities/view.entity';
import { ViewSortEntity } from 'src/engine/metadata-modules/view-sort/entities/view-sort.entity';
import { SearchFieldMetadataEntity } from 'src/engine/metadata-modules/search-field-metadata/search-field-metadata.entity';
+import { RelatedRecordPathEntity } from 'src/engine/metadata-modules/related-record-path/entities/related-record-path.entity';
import { ValidationRuleEntity } from 'src/engine/metadata-modules/validation-rule/entities/validation-rule.entity';
import { TimelineActivityTypeEntity } from 'src/engine/metadata-modules/timeline-activity-type/entities/timeline-activity-type.entity';
import { SettingsMenuItemEntity } from 'src/engine/metadata-modules/settings-menu-item/entities/settings-menu-item.entity';
@@ -78,6 +79,7 @@ export const ALL_METADATA_ENTITY_BY_METADATA_NAME = {
searchFieldMetadata: SearchFieldMetadataEntity,
timelineActivityType: TimelineActivityTypeEntity,
settingsMenuItem: SettingsMenuItemEntity,
+ relatedRecordPath: RelatedRecordPathEntity,
validationRule: ValidationRuleEntity,
workflow: WorkflowEntity,
workflowVersion: WorkflowVersionEntity,
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-required-metadata-for-validation.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-required-metadata-for-validation.constant.ts
index 31099ea6e2c..151a3014efc 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-required-metadata-for-validation.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-required-metadata-for-validation.constant.ts
@@ -142,6 +142,10 @@ export const ALL_METADATA_REQUIRED_METADATA_FOR_VALIDATION = {
settingsMenuItem: {
frontComponent: true,
},
+ relatedRecordPath: {
+ objectMetadata: true,
+ fieldMetadata: true,
+ },
validationRule: {
objectMetadata: true,
fieldMetadata: true,
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-serialized-relation.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-serialized-relation.constant.ts
index ac806e0107a..8eecacfd470 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-serialized-relation.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-serialized-relation.constant.ts
@@ -58,6 +58,7 @@ export const ALL_METADATA_SERIALIZED_RELATION = {
connectionProvider: {},
messagingProvider: {},
timelineActivityType: {},
+ relatedRecordPath: {},
validationRule: {},
searchFieldMetadata: {},
settingsMenuItem: {},
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-one-to-many-metadata-relations.constant.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-one-to-many-metadata-relations.constant.ts
index be87ced6276..765288c5b52 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-one-to-many-metadata-relations.constant.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-one-to-many-metadata-relations.constant.ts
@@ -314,6 +314,7 @@ export const ALL_ONE_TO_MANY_METADATA_RELATIONS = {
searchFieldMetadata: {},
timelineActivityType: {},
settingsMenuItem: {},
+ relatedRecordPath: {},
validationRule: {},
workflow: {},
workflowVersion: {},
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module.ts
index 17c2b721631..489521a73ac 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module.ts
@@ -25,6 +25,7 @@ import { WorkspaceFlatTimelineActivityTypeMapCacheService } from 'src/engine/met
import { WorkspaceFlatAgentChatChannelMapCacheService } from 'src/engine/metadata-modules/flat-agent-chat-channel/services/workspace-flat-agent-chat-channel-map-cache.service';
import { WorkspaceFlatAgentChatChannelRoleMapCacheService } from 'src/engine/metadata-modules/flat-agent-chat-channel-role/services/workspace-flat-agent-chat-channel-role-map-cache.service';
import { WorkspaceFlatSettingsMenuItemMapCacheService } from 'src/engine/metadata-modules/flat-settings-menu-item/services/workspace-flat-settings-menu-item-map-cache.service';
+import { WorkspaceFlatRelatedRecordPathMapCacheService } from 'src/engine/metadata-modules/flat-related-record-path/services/workspace-flat-related-record-path-map-cache.service';
import { WorkspaceFlatValidationRuleMapCacheService } from 'src/engine/metadata-modules/flat-validation-rule/services/workspace-flat-validation-rule-map-cache.service';
import { WorkspaceFlatViewSortMapCacheService } from 'src/engine/metadata-modules/flat-view-sort/services/workspace-flat-view-sort-map-cache.service';
import { WorkspaceFlatViewMapCacheService } from 'src/engine/metadata-modules/flat-view/services/workspace-flat-view-map-cache.service';
@@ -59,6 +60,7 @@ import { WorkspaceCacheModule } from 'src/engine/workspace-cache/workspace-cache
WorkspaceFlatSettingsMenuItemMapCacheService,
WorkspaceFlatAgentChatChannelMapCacheService,
WorkspaceFlatAgentChatChannelRoleMapCacheService,
+ WorkspaceFlatRelatedRecordPathMapCacheService,
WorkspaceFlatValidationRuleMapCacheService,
WorkspaceFlatMcpServerMapCacheService,
],
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name.type.ts b/packages/twenty-server/src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name.type.ts
index a7e940b3f13..249cda57255 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name.type.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name.type.ts
@@ -30,6 +30,8 @@ import { type FlatMessagingProviderMaps } from 'src/engine/metadata-modules/flat
import { type FlatMessagingProvider } from 'src/engine/metadata-modules/flat-messaging-provider/types/flat-messaging-provider.type';
import { type FlatTimelineActivityTypeMaps } from 'src/engine/metadata-modules/flat-timeline-activity-type/types/flat-timeline-activity-type-maps.type';
import { type FlatTimelineActivityType } from 'src/engine/metadata-modules/flat-timeline-activity-type/types/flat-timeline-activity-type.type';
+import { type FlatRelatedRecordPathMaps } from 'src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path-maps.type';
+import { type FlatRelatedRecordPath } from 'src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path.type';
import { type FlatValidationRuleMaps } from 'src/engine/metadata-modules/flat-validation-rule/types/flat-validation-rule-maps.type';
import { type FlatValidationRule } from 'src/engine/metadata-modules/flat-validation-rule/types/flat-validation-rule.type';
import { type FlatCommandMenuItem } from 'src/engine/metadata-modules/flat-command-menu-item/types/flat-command-menu-item.type';
@@ -98,6 +100,7 @@ import { type UniversalFlatCommandMenuItem } from 'src/engine/workspace-manager/
import { type UniversalFlatConnectionProvider } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-connection-provider.type';
import { type UniversalFlatMessagingProvider } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-messaging-provider.type';
import { type UniversalFlatTimelineActivityType } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-timeline-activity-type.type';
+import { type UniversalFlatRelatedRecordPath } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-related-record-path.type';
import { type UniversalFlatValidationRule } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-validation-rule.type';
import { type UniversalFlatEntityFrom } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-entity-from.type';
import { type UniversalFlatFieldPermission } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-permission.type';
@@ -168,6 +171,14 @@ import {
type UniversalDeleteTimelineActivityTypeAction,
type UniversalUpdateTimelineActivityTypeAction,
} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/timeline-activity-type/types/workspace-migration-timeline-activity-type-action.type';
+import {
+ type FlatCreateRelatedRecordPathAction,
+ type FlatDeleteRelatedRecordPathAction,
+ type FlatUpdateRelatedRecordPathAction,
+ type UniversalCreateRelatedRecordPathAction,
+ type UniversalDeleteRelatedRecordPathAction,
+ type UniversalUpdateRelatedRecordPathAction,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type';
import {
type FlatCreateValidationRuleAction,
type FlatDeleteValidationRuleAction,
@@ -1038,6 +1049,22 @@ export type AllFlatEntityTypesByMetadataName = {
universalFlatEntity: UniversalFlatSettingsMenuItem;
entity: MetadataEntity<'settingsMenuItem'>;
};
+ relatedRecordPath: {
+ flatEntityMaps: FlatRelatedRecordPathMaps;
+ universalActions: {
+ create: UniversalCreateRelatedRecordPathAction;
+ update: UniversalUpdateRelatedRecordPathAction;
+ delete: UniversalDeleteRelatedRecordPathAction;
+ };
+ flatActions: {
+ create: FlatCreateRelatedRecordPathAction;
+ update: FlatUpdateRelatedRecordPathAction;
+ delete: FlatDeleteRelatedRecordPathAction;
+ };
+ flatEntity: FlatRelatedRecordPath;
+ universalFlatEntity: UniversalFlatRelatedRecordPath;
+ entity: MetadataEntity<'relatedRecordPath'>;
+ };
validationRule: {
flatEntityMaps: FlatValidationRuleMaps;
universalActions: {
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/get-metadata-related-metadata-names.util.spec.ts.snap b/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/get-metadata-related-metadata-names.util.spec.ts.snap
index 2be69621a71..74339444531 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/get-metadata-related-metadata-names.util.spec.ts.snap
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/get-metadata-related-metadata-names.util.spec.ts.snap
@@ -126,6 +126,13 @@ exports[`getMetadataRelatedMetadataNames should return related metadata names fo
]
`;
+exports[`getMetadataRelatedMetadataNames should return related metadata names for relatedRecordPath 1`] = `
+[
+ "objectMetadata",
+ "fieldMetadata",
+]
+`;
+
exports[`getMetadataRelatedMetadataNames should return related metadata names for role 1`] = `
[
"roleTarget",
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/sort-metadata-names-children-first.util.spec.ts.snap b/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/sort-metadata-names-children-first.util.spec.ts.snap
index 937e3b1f6ee..839d9b5981b 100644
--- a/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/sort-metadata-names-children-first.util.spec.ts.snap
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/sort-metadata-names-children-first.util.spec.ts.snap
@@ -5,6 +5,7 @@ exports[`sortMetadataNamesChildrenFirst should return metadata names sorted with
"navigationMenuItem",
"rowLevelPermissionPredicate",
"commandMenuItem",
+ "relatedRecordPath",
"viewFilter",
"fieldPermission",
"searchFieldMetadata",
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/services/workspace-flat-related-record-path-map-cache.service.ts b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/services/workspace-flat-related-record-path-map-cache.service.ts
new file mode 100644
index 00000000000..d6097c3f6cc
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/services/workspace-flat-related-record-path-map-cache.service.ts
@@ -0,0 +1,65 @@
+/* @license Enterprise */
+
+import { Injectable } from '@nestjs/common';
+
+import { MetadataFlatEntityMapsCacheProvider } from 'src/engine/workspace-cache/interfaces/metadata-flat-entity-maps-cache-provider.service';
+
+import { createEmptyFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/constant/create-empty-flat-entity-maps.constant';
+import { type FlatRelatedRecordPathMaps } from 'src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path-maps.type';
+import { fromRelatedRecordPathEntityToFlatRelatedRecordPath } from 'src/engine/metadata-modules/flat-related-record-path/utils/from-related-record-path-entity-to-flat-related-record-path.util';
+import { WorkspaceCache } from 'src/engine/workspace-cache/decorators/workspace-cache.decorator';
+import { type WorkspaceCacheProviderContext } from 'src/engine/workspace-cache/types/workspace-cache-provider-context.type';
+import { createIdToUniversalIdentifierMap } from 'src/engine/workspace-cache/utils/create-id-to-universal-identifier-map.util';
+import { addFlatEntityToFlatEntityMapsThroughMutationOrThrow } from 'src/engine/workspace-manager/workspace-migration/utils/add-flat-entity-to-flat-entity-maps-through-mutation-or-throw.util';
+
+const FLAT_RELATED_RECORD_PATH_ROWS_REQUIREMENT = {
+ relatedRecordPath: true,
+ application: ['id', 'universalIdentifier'],
+ objectMetadata: ['id', 'universalIdentifier'],
+ fieldMetadata: ['id', 'universalIdentifier'],
+} as const;
+
+@Injectable()
+@WorkspaceCache('flatRelatedRecordPathMaps', { packingPonderation: 1 })
+export class WorkspaceFlatRelatedRecordPathMapCacheService extends MetadataFlatEntityMapsCacheProvider<'relatedRecordPath'> {
+ override readonly rowsRequirement = FLAT_RELATED_RECORD_PATH_ROWS_REQUIREMENT;
+
+ computeForCache({
+ rows,
+ }: WorkspaceCacheProviderContext<
+ typeof FLAT_RELATED_RECORD_PATH_ROWS_REQUIREMENT
+ >): FlatRelatedRecordPathMaps {
+ const {
+ relatedRecordPath: relatedRecordPaths,
+ application: applications,
+ objectMetadata: objectMetadatas,
+ fieldMetadata: fieldMetadatas,
+ } = rows;
+
+ const applicationIdToUniversalIdentifierMap =
+ createIdToUniversalIdentifierMap(applications);
+ const objectMetadataIdToUniversalIdentifierMap =
+ createIdToUniversalIdentifierMap(objectMetadatas);
+ const fieldMetadataIdToUniversalIdentifierMap =
+ createIdToUniversalIdentifierMap(fieldMetadatas);
+
+ const flatRelatedRecordPathMaps = createEmptyFlatEntityMaps();
+
+ for (const relatedRecordPathEntity of relatedRecordPaths) {
+ const flatRelatedRecordPath =
+ fromRelatedRecordPathEntityToFlatRelatedRecordPath({
+ entity: relatedRecordPathEntity,
+ applicationIdToUniversalIdentifierMap,
+ objectMetadataIdToUniversalIdentifierMap,
+ fieldMetadataIdToUniversalIdentifierMap,
+ });
+
+ addFlatEntityToFlatEntityMapsThroughMutationOrThrow({
+ flatEntity: flatRelatedRecordPath,
+ flatEntityMapsToMutate: flatRelatedRecordPathMaps,
+ });
+ }
+
+ return flatRelatedRecordPathMaps;
+ }
+}
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path-maps.type.ts b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path-maps.type.ts
new file mode 100644
index 00000000000..59a13d89f6e
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path-maps.type.ts
@@ -0,0 +1,6 @@
+/* @license Enterprise */
+
+import { type FlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-maps.type';
+import { type FlatRelatedRecordPath } from 'src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path.type';
+
+export type FlatRelatedRecordPathMaps = FlatEntityMaps<FlatRelatedRecordPath>;
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path.type.ts b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path.type.ts
new file mode 100644
index 00000000000..d8b6736f450
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path.type.ts
@@ -0,0 +1,6 @@
+/* @license Enterprise */
+
+import { type FlatEntityFrom } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-from.type';
+import { type RelatedRecordPathEntity } from 'src/engine/metadata-modules/related-record-path/entities/related-record-path.entity';
+
+export type FlatRelatedRecordPath = FlatEntityFrom<RelatedRecordPathEntity>;
diff --git a/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/utils/from-related-record-path-entity-to-flat-related-record-path.util.ts b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/utils/from-related-record-path-entity-to-flat-related-record-path.util.ts
new file mode 100644
index 00000000000..febc3577eb4
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/flat-related-record-path/utils/from-related-record-path-entity-to-flat-related-record-path.util.ts
@@ -0,0 +1,28 @@
+/* @license Enterprise */
+
+import { fromEntityToScalarEntity } from 'src/engine/metadata-modules/flat-entity/utils/from-entity-to-scalar-entity.util';
+import { type FlatRelatedRecordPath } from 'src/engine/metadata-modules/flat-related-record-path/types/flat-related-record-path.type';
+import { type FromEntityToFlatEntityArgs } from 'src/engine/workspace-cache/types/from-entity-to-flat-entity-args.type';
+import { resolveManyToOneRelationIdsToUniversalIdentifiers } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/resolve-many-to-one-relation-ids-to-universal-identifiers.util';
+
+export const fromRelatedRecordPathEntityToFlatRelatedRecordPath = (
+ args: FromEntityToFlatEntityArgs<'relatedRecordPath'>,
+): FlatRelatedRecordPath => {
+ const { entity: relatedRecordPathEntity } = args;
+
+ const relatedRecordPathScalarEntity = fromEntityToScalarEntity({
+ metadataName: 'relatedRecordPath',
+ entity: relatedRecordPathEntity,
+ });
+
+ const relationUniversalIdentifiers =
+ resolveManyToOneRelationIdsToUniversalIdentifiers({
+ metadataName: 'relatedRecordPath',
+ ...args,
+ });
+
+ return {
+ ...relatedRecordPathScalarEntity,
+ ...relationUniversalIdentifiers,
+ };
+};
diff --git a/packages/twenty-server/src/engine/metadata-modules/related-record-path/entities/related-record-path.entity.ts b/packages/twenty-server/src/engine/metadata-modules/related-record-path/entities/related-record-path.entity.ts
new file mode 100644
index 00000000000..e20e57ed3a1
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/related-record-path/entities/related-record-path.entity.ts
@@ -0,0 +1,95 @@
+/* @license Enterprise */
+
+import {
+ Column,
+ CreateDateColumn,
+ Entity,
+ Index,
+ JoinColumn,
+ ManyToOne,
+ PrimaryGeneratedColumn,
+ Relation,
+ UpdateDateColumn,
+} from 'typeorm';
+
+import { ADD_RELATED_RECORD_PATH_TABLE_UPGRADE_COMMAND_NAME } from 'src/database/commands/upgrade-version-command/2-54/add-related-record-path-table-upgrade-command-name.constant';
+import { WasIntroducedInUpgrade } from 'src/engine/core-modules/upgrade/decorators/was-introduced-in-upgrade.decorator';
+import { FieldMetadataEntity } from 'src/engine/metadata-modules/field-metadata/field-metadata.entity';
+import { ObjectMetadataEntity } from 'src/engine/metadata-modules/object-metadata/object-metadata.entity';
+import { SyncableEntity } from 'src/engine/workspace-manager/types/syncable-entity.interface';
+
+@Entity({ name: 'relatedRecordPath', schema: 'core' })
+@WasIntroducedInUpgrade({
+ upgradeCommandName: ADD_RELATED_RECORD_PATH_TABLE_UPGRADE_COMMAND_NAME,
+})
+// Postgres treats NULLs as distinct, so each path length gets its own unique index.
+@Index('IDX_RELATED_RECORD_PATH_UNIQUE_ONE_HOP', ['firstFieldMetadataId'], {
+ unique: true,
+ where: '"secondFieldMetadataId" IS NULL',
+})
+@Index(
+ 'IDX_RELATED_RECORD_PATH_UNIQUE_TWO_HOPS',
+ ['firstFieldMetadataId', 'secondFieldMetadataId'],
+ {
+ unique: true,
+ where:
+ '"secondFieldMetadataId" IS NOT NULL AND "thirdFieldMetadataId" IS NULL',
+ },
+)
+@Index(
+ 'IDX_RELATED_RECORD_PATH_UNIQUE_THREE_HOPS',
+ ['firstFieldMetadataId', 'secondFieldMetadataId', 'thirdFieldMetadataId'],
+ { unique: true, where: '"thirdFieldMetadataId" IS NOT NULL' },
+)
+@Index('IDX_RELATED_RECORD_PATH_APPLICATION_ID', ['applicationId'])
+@Index('IDX_RELATED_RECORD_PATH_OBJECT_METADATA_ID', ['objectMetadataId'])
+@Index('IDX_RELATED_RECORD_PATH_FIRST_FIELD_METADATA_ID', [
+ 'firstFieldMetadataId',
+])
+@Index('IDX_RELATED_RECORD_PATH_SECOND_FIELD_METADATA_ID', [
+ 'secondFieldMetadataId',
+])
+@Index('IDX_RELATED_RECORD_PATH_THIRD_FIELD_METADATA_ID', [
+ 'thirdFieldMetadataId',
+])
+export class RelatedRecordPathEntity
+ extends SyncableEntity
+ implements Required<RelatedRecordPathEntity>
+{
+ @PrimaryGeneratedColumn('uuid')
+ id: string;
+
+ @Column({ nullable: false, type: 'uuid' })
+ objectMetadataId: string;
+
+ @ManyToOne(() => ObjectMetadataEntity, { onDelete: 'CASCADE' })
+ @JoinColumn({ name: 'objectMetadataId' })
+ objectMetadata: Relation<ObjectMetadataEntity>;
+
+ @Column({ nullable: false, type: 'uuid' })
+ firstFieldMetadataId: string;
+
+ @ManyToOne(() => FieldMetadataEntity, { onDelete: 'CASCADE' })
+ @JoinColumn({ name: 'firstFieldMetadataId' })
+ firstFieldMetadata: Relation<FieldMetadataEntity>;
+
+ @Column({ nullable: true, type: 'uuid' })
+ secondFieldMetadataId: string | null;
+
+ @ManyToOne(() => FieldMetadataEntity, { onDelete: 'CASCADE' })
+ @JoinColumn({ name: 'secondFieldMetadataId' })
+ secondFieldMetadata: Relation<FieldMetadataEntity> | null;
+
+ @Column({ nullable: true, type: 'uuid' })
+ thirdFieldMetadataId: string | null;
+
+ @ManyToOne(() => FieldMetadataEntity, { onDelete: 'CASCADE' })
+ @JoinColumn({ name: 'thirdFieldMetadataId' })
+ thirdFieldMetadata: Relation<FieldMetadataEntity> | null;
+
+ @CreateDateColumn({ type: 'timestamptz' })
+ createdAt: Date;
+
+ @UpdateDateColumn({ type: 'timestamptz' })
+ updatedAt: Date;
+}
diff --git a/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.exception.ts b/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.exception.ts
new file mode 100644
index 00000000000..dcb383355a1
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.exception.ts
@@ -0,0 +1,39 @@
+/* @license Enterprise */
+
+import { type MessageDescriptor } from '@lingui/core';
+import { msg } from '@lingui/core/macro';
+import { assertUnreachable } from 'twenty-shared/utils';
+
+import { CustomException } from 'src/utils/custom-exception';
+
+export enum RelatedRecordPathExceptionCode {
+ RELATED_RECORD_PATH_NOT_FOUND = 'RELATED_RECORD_PATH_NOT_FOUND',
+ INVALID_RELATED_RECORD_PATH_INPUT = 'INVALID_RELATED_RECORD_PATH_INPUT',
+}
+
+const getRelatedRecordPathExceptionUserFriendlyMessage = (
+ code: RelatedRecordPathExceptionCode,
+) => {
+ switch (code) {
+ case RelatedRecordPathExceptionCode.RELATED_RECORD_PATH_NOT_FOUND:
+ return msg`Related record path not found.`;
+ case RelatedRecordPathExceptionCode.INVALID_RELATED_RECORD_PATH_INPUT:
+ return msg`Invalid related record path input.`;
+ default:
+ assertUnreachable(code);
+ }
+};
+
+export class RelatedRecordPathException extends CustomException<RelatedRecordPathExceptionCode> {
+ constructor(
+ message: string,
+ code: RelatedRecordPathExceptionCode,
+ { userFriendlyMessage }: { userFriendlyMessage?: MessageDescriptor } = {},
+ ) {
+ super(message, code, {
+ userFriendlyMessage:
+ userFriendlyMessage ??
+ getRelatedRecordPathExceptionUserFriendlyMessage(code),
+ });
+ }
+}
diff --git a/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/get-related-record-path-field-metadata-universal-identifiers.util.ts b/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/get-related-record-path-field-metadata-universal-identifiers.util.ts
new file mode 100644
index 00000000000..36cc929d6f8
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/get-related-record-path-field-metadata-universal-identifiers.util.ts
@@ -0,0 +1,21 @@
+/* @license Enterprise */
+
+import { isDefined } from 'twenty-shared/utils';
+
+import { type UniversalFlatRelatedRecordPath } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-related-record-path.type';
+
+export const getRelatedRecordPathFieldMetadataUniversalIdentifiers = ({
+ firstFieldMetadataUniversalIdentifier,
+ secondFieldMetadataUniversalIdentifier,
+ thirdFieldMetadataUniversalIdentifier,
+}: Pick<
+ UniversalFlatRelatedRecordPath,
+ | 'firstFieldMetadataUniversalIdentifier'
+ | 'secondFieldMetadataUniversalIdentifier'
+ | 'thirdFieldMetadataUniversalIdentifier'
+>): string[] =>
+ [
+ firstFieldMetadataUniversalIdentifier,
+ secondFieldMetadataUniversalIdentifier,
+ thirdFieldMetadataUniversalIdentifier,
+ ].filter(isDefined);
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/services/workspace-migration-build-orchestrator.service.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/services/workspace-migration-build-orchestrator.service.ts
index eebe3b13cf8..faf00cec44e 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/services/workspace-migration-build-orchestrator.service.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/services/workspace-migration-build-orchestrator.service.ts
@@ -35,6 +35,7 @@ import { WorkspaceMigrationCommandMenuItemActionsBuilderService } from 'src/engi
import { WorkspaceMigrationConnectionProviderActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/connection-provider/workspace-migration-connection-provider-actions-builder.service';
import { WorkspaceMigrationMessagingProviderActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/messaging-provider/workspace-migration-messaging-provider-actions-builder.service';
import { WorkspaceMigrationTimelineActivityTypeActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/timeline-activity-type/workspace-migration-timeline-activity-type-actions-builder.service';
+import { WorkspaceMigrationRelatedRecordPathActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/workspace-migration-related-record-path-actions-builder.service';
import { WorkspaceMigrationValidationRuleActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/validation-rule/workspace-migration-validation-rule-actions-builder.service';
import { WorkspaceMigrationFieldPermissionActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/field-permission/workspace-migration-field-permission-actions-builder.service';
import { WorkspaceMigrationFieldActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/field/workspace-migration-field-actions-builder.service';
@@ -166,6 +167,7 @@ export class WorkspaceMigrationBuildOrchestratorService {
workspaceMigrationConnectionProviderActionsBuilderService: WorkspaceMigrationConnectionProviderActionsBuilderService,
workspaceMigrationMessagingProviderActionsBuilderService: WorkspaceMigrationMessagingProviderActionsBuilderService,
workspaceMigrationTimelineActivityTypeActionsBuilderService: WorkspaceMigrationTimelineActivityTypeActionsBuilderService,
+ workspaceMigrationRelatedRecordPathActionsBuilderService: WorkspaceMigrationRelatedRecordPathActionsBuilderService,
workspaceMigrationValidationRuleActionsBuilderService: WorkspaceMigrationValidationRuleActionsBuilderService,
workspaceMigrationSearchFieldMetadataActionsBuilderService: WorkspaceMigrationSearchFieldMetadataActionsBuilderService,
workspaceMigrationWorkflowActionsBuilderService: WorkspaceMigrationWorkflowActionsBuilderService,
@@ -312,6 +314,10 @@ export class WorkspaceMigrationBuildOrchestratorService {
ALL_METADATA_NAME.timelineActivityType,
workspaceMigrationTimelineActivityTypeActionsBuilderService,
),
+ createEntityActionsBuilderTask(
+ ALL_METADATA_NAME.relatedRecordPath,
+ workspaceMigrationRelatedRecordPathActionsBuilderService,
+ ),
createEntityActionsBuilderTask(
ALL_METADATA_NAME.validationRule,
workspaceMigrationValidationRuleActionsBuilderService,
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/__tests__/__snapshots__/all-universal-flat-entity-foreign-key-aggregator-properties.constant.spec.ts.snap b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/__tests__/__snapshots__/all-universal-flat-entity-foreign-key-aggregator-properties.constant.spec.ts.snap
index d7203e58c45..eb46eb872a4 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/__tests__/__snapshots__/all-universal-flat-entity-foreign-key-aggregator-properties.constant.spec.ts.snap
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/__tests__/__snapshots__/all-universal-flat-entity-foreign-key-aggregator-properties.constant.spec.ts.snap
@@ -52,6 +52,7 @@ exports[`ALL_UNIVERSAL_FLAT_ENTITY_FOREIGN_KEY_AGGREGATOR_PROPERTIES should matc
"permissionFlag": [
"rolePermissionFlagUniversalIdentifiers",
],
+ "relatedRecordPath": [],
"role": [
"roleTargetUniversalIdentifiers",
"objectPermissionUniversalIdentifiers",
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/all-jsonb-properties-with-serialized-relation-by-metadata-name.constant.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/all-jsonb-properties-with-serialized-relation-by-metadata-name.constant.ts
index 439c192706c..a3672d6083b 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/all-jsonb-properties-with-serialized-relation-by-metadata-name.constant.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/constants/all-jsonb-properties-with-serialized-relation-by-metadata-name.constant.ts
@@ -51,6 +51,7 @@ export const ALL_JSONB_PROPERTIES_WITH_SERIALIZED_RELATION_BY_METADATA_NAME = {
connectionProvider: {},
messagingProvider: {},
timelineActivityType: {},
+ relatedRecordPath: {},
validationRule: {},
searchFieldMetadata: {},
agentChatChannel: {},
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-related-record-path.type.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-related-record-path.type.ts
new file mode 100644
index 00000000000..d27df40cfa2
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-related-record-path.type.ts
@@ -0,0 +1,9 @@
+/* @license Enterprise */
+
+import { type RelatedRecordPathEntity } from 'src/engine/metadata-modules/related-record-path/entities/related-record-path.entity';
+import { type UniversalFlatEntityFrom } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-entity-from.type';
+
+export type UniversalFlatRelatedRecordPath = UniversalFlatEntityFrom<
+ RelatedRecordPathEntity,
+ 'relatedRecordPath'
+>;
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/utils/compute-ordered-migration-actions.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/utils/compute-ordered-migration-actions.util.ts
index a81bfb54588..3a3d571531b 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/utils/compute-ordered-migration-actions.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/utils/compute-ordered-migration-actions.util.ts
@@ -165,8 +165,11 @@ export const computeOrderedMigrationActions = (
...aggregatedOrchestratorActionsReport.timelineActivityType.delete,
...aggregatedOrchestratorActionsReport.timelineActivityType.create,
...aggregatedOrchestratorActionsReport.timelineActivityType.update,
+ ...aggregatedOrchestratorActionsReport.relatedRecordPath.delete,
...aggregatedOrchestratorActionsReport.validationRule.delete,
+ ...aggregatedOrchestratorActionsReport.relatedRecordPath.create,
...aggregatedOrchestratorActionsReport.validationRule.create,
+ ...aggregatedOrchestratorActionsReport.relatedRecordPath.update,
...aggregatedOrchestratorActionsReport.validationRule.update,
];
};
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type.ts
new file mode 100644
index 00000000000..7dff80f21ba
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type.ts
@@ -0,0 +1,26 @@
+/* @license Enterprise */
+
+import { type BaseFlatCreateWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-flat-create-workspace-migration-action.type';
+import { type BaseFlatDeleteWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-flat-delete-workspace-migration-action.type';
+import { type BaseFlatUpdateWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-flat-update-workspace-migration-action.type';
+import { type BaseUniversalCreateWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-universal-create-workspace-migration-action.type';
+import { type BaseUniversalDeleteWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-universal-delete-workspace-migration-action.type';
+import { type BaseUniversalUpdateWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-universal-update-workspace-migration-action.type';
+
+export type FlatCreateRelatedRecordPathAction =
+ BaseFlatCreateWorkspaceMigrationAction<'relatedRecordPath'>;
+
+export type UniversalCreateRelatedRecordPathAction =
+ BaseUniversalCreateWorkspaceMigrationAction<'relatedRecordPath'>;
+
+export type FlatUpdateRelatedRecordPathAction =
+ BaseFlatUpdateWorkspaceMigrationAction<'relatedRecordPath'>;
+
+export type UniversalUpdateRelatedRecordPathAction =
+ BaseUniversalUpdateWorkspaceMigrationAction<'relatedRecordPath'>;
+
+export type UniversalDeleteRelatedRecordPathAction =
+ BaseUniversalDeleteWorkspaceMigrationAction<'relatedRecordPath'>;
+
+export type FlatDeleteRelatedRecordPathAction =
+ BaseFlatDeleteWorkspaceMigrationAction<'relatedRecordPath'>;
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/workspace-migration-related-record-path-actions-builder.service.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/workspace-migration-related-record-path-actions-builder.service.ts
new file mode 100644
index 00000000000..e8398d59f7e
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/workspace-migration-related-record-path-actions-builder.service.ts
@@ -0,0 +1,124 @@
+/* @license Enterprise */
+
+import { Injectable } from '@nestjs/common';
+
+import { ALL_METADATA_NAME } from 'twenty-shared/metadata';
+
+import { UniversalUpdateRelatedRecordPathAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type';
+import { WorkspaceEntityMigrationBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/services/workspace-entity-migration-builder.service';
+import { FlatEntityUpdateValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/universal-flat-entity-update-validation-args.type';
+import { UniversalFlatEntityValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/universal-flat-entity-validation-args.type';
+import { UniversalFlatEntityValidationReturnType } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/universal-flat-entity-validation-result.type';
+import { FlatRelatedRecordPathValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-related-record-path-validator.service';
+
+@Injectable()
+export class WorkspaceMigrationRelatedRecordPathActionsBuilderService extends WorkspaceEntityMigrationBuilderService<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+> {
+ constructor(
+ private readonly flatRelatedRecordPathValidatorService: FlatRelatedRecordPathValidatorService,
+ ) {
+ super(ALL_METADATA_NAME.relatedRecordPath);
+ }
+
+ protected validateFlatEntityCreation(
+ args: UniversalFlatEntityValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >,
+ ): UniversalFlatEntityValidationReturnType<
+ typeof ALL_METADATA_NAME.relatedRecordPath,
+ 'create'
+ > {
+ const validationResult =
+ this.flatRelatedRecordPathValidatorService.validateFlatRelatedRecordPathCreation(
+ args,
+ );
+
+ if (validationResult.errors.length > 0) {
+ return {
+ status: 'fail',
+ ...validationResult,
+ };
+ }
+
+ const { flatEntityToValidate: flatRelatedRecordPathToValidate } = args;
+
+ return {
+ status: 'success',
+ action: {
+ type: 'create',
+ metadataName: 'relatedRecordPath',
+ flatEntity: flatRelatedRecordPathToValidate,
+ },
+ };
+ }
+
+ protected validateFlatEntityDeletion(
+ args: UniversalFlatEntityValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >,
+ ): UniversalFlatEntityValidationReturnType<
+ typeof ALL_METADATA_NAME.relatedRecordPath,
+ 'delete'
+ > {
+ const validationResult =
+ this.flatRelatedRecordPathValidatorService.validateFlatRelatedRecordPathDeletion(
+ args,
+ );
+
+ if (validationResult.errors.length > 0) {
+ return {
+ status: 'fail',
+ ...validationResult,
+ };
+ }
+
+ const { flatEntityToValidate: flatRelatedRecordPathToValidate } = args;
+
+ return {
+ status: 'success',
+ action: {
+ type: 'delete',
+ metadataName: 'relatedRecordPath',
+ universalIdentifier:
+ flatRelatedRecordPathToValidate.universalIdentifier,
+ },
+ };
+ }
+
+ protected validateFlatEntityUpdate(
+ args: FlatEntityUpdateValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >,
+ ): UniversalFlatEntityValidationReturnType<
+ typeof ALL_METADATA_NAME.relatedRecordPath,
+ 'update'
+ > {
+ const validationResult =
+ this.flatRelatedRecordPathValidatorService.validateFlatRelatedRecordPathUpdate(
+ args,
+ );
+
+ if (validationResult.errors.length > 0) {
+ return {
+ status: 'fail',
+ ...validationResult,
+ };
+ }
+
+ const { universalIdentifier, flatEntityUpdate } = args;
+
+ const updateRelatedRecordPathAction: UniversalUpdateRelatedRecordPathAction =
+ {
+ type: 'update',
+ metadataName: 'relatedRecordPath',
+ universalIdentifier,
+ update: flatEntityUpdate,
+ };
+
+ return {
+ status: 'success',
+ action: updateRelatedRecordPathAction,
+ };
+ }
+}
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-related-record-path-validator.service.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-related-record-path-validator.service.ts
new file mode 100644
index 00000000000..eff66c71538
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-related-record-path-validator.service.ts
@@ -0,0 +1,294 @@
+/* @license Enterprise */
+
+import { Injectable } from '@nestjs/common';
+
+import { msg, t } from '@lingui/core/macro';
+import { type ALL_METADATA_NAME } from 'twenty-shared/metadata';
+import { isDefined, isMorphRelationHead } from 'twenty-shared/utils';
+
+import { findFlatEntityByUniversalIdentifier } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-universal-identifier.util';
+import { isMorphOrRelationUniversalFlatFieldMetadata } from 'src/engine/metadata-modules/flat-field-metadata/utils/is-morph-or-relation-flat-field-metadata.util';
+import { RelatedRecordPathExceptionCode } from 'src/engine/metadata-modules/related-record-path/related-record-path.exception';
+import { getRelatedRecordPathFieldMetadataUniversalIdentifiers } from 'src/engine/metadata-modules/related-record-path/utils/get-related-record-path-field-metadata-universal-identifiers.util';
+import { type UniversalFlatRelatedRecordPath } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-related-record-path.type';
+import {
+ type FailedFlatEntityValidation,
+ type FlatEntityValidationError,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/types/failed-flat-entity-validation.type';
+import { getEmptyFlatEntityValidationError } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/utils/get-flat-entity-validation-error.util';
+import { type FlatEntityUpdateValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/universal-flat-entity-update-validation-args.type';
+import { type UniversalFlatEntityValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/universal-flat-entity-validation-args.type';
+
+type RelatedRecordPathRelatedMaps = Pick<
+ UniversalFlatEntityValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >['optimisticFlatEntityMapsAndRelatedFlatEntityMaps'],
+ | 'flatObjectMetadataMaps'
+ | 'flatFieldMetadataMaps'
+ | 'flatRelatedRecordPathMaps'
+>;
+
+const buildInvalidInputError = ({
+ message,
+ userFriendlyMessage,
+}: Pick<
+ FlatEntityValidationError,
+ 'message' | 'userFriendlyMessage'
+>): FlatEntityValidationError => ({
+ code: RelatedRecordPathExceptionCode.INVALID_RELATED_RECORD_PATH_INPUT,
+ message,
+ userFriendlyMessage,
+});
+
+const buildNotFoundError = (): FlatEntityValidationError => ({
+ code: RelatedRecordPathExceptionCode.RELATED_RECORD_PATH_NOT_FOUND,
+ message: t`Related record path not found`,
+ userFriendlyMessage: msg`Related record path not found`,
+});
+
+@Injectable()
+export class FlatRelatedRecordPathValidatorService {
+ private collectPathErrors({
+ universalFlatRelatedRecordPath,
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps: {
+ flatObjectMetadataMaps,
+ flatFieldMetadataMaps,
+ flatRelatedRecordPathMaps,
+ },
+ }: {
+ universalFlatRelatedRecordPath: UniversalFlatRelatedRecordPath;
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps: RelatedRecordPathRelatedMaps;
+ }): FlatEntityValidationError[] {
+ const {
+ objectMetadataUniversalIdentifier,
+ secondFieldMetadataUniversalIdentifier,
+ thirdFieldMetadataUniversalIdentifier,
+ } = universalFlatRelatedRecordPath;
+
+ const flatObjectMetadata = findFlatEntityByUniversalIdentifier({
+ universalIdentifier: objectMetadataUniversalIdentifier,
+ flatEntityMaps: flatObjectMetadataMaps,
+ });
+
+ if (!isDefined(flatObjectMetadata)) {
+ return [
+ buildInvalidInputError({
+ message: t`Related record path object not found`,
+ userFriendlyMessage: msg`Related record path object not found`,
+ }),
+ ];
+ }
+
+ if (
+ isDefined(thirdFieldMetadataUniversalIdentifier) &&
+ !isDefined(secondFieldMetadataUniversalIdentifier)
+ ) {
+ return [
+ buildInvalidInputError({
+ message: t`Related record path cannot skip its second relation`,
+ userFriendlyMessage: msg`Related record path cannot skip its second relation`,
+ }),
+ ];
+ }
+
+ const fieldMetadataUniversalIdentifiers =
+ getRelatedRecordPathFieldMetadataUniversalIdentifiers(
+ universalFlatRelatedRecordPath,
+ );
+
+ const visitedObjectMetadataUniversalIdentifiers = new Set([
+ objectMetadataUniversalIdentifier,
+ ]);
+ let currentObjectMetadataUniversalIdentifier =
+ objectMetadataUniversalIdentifier;
+
+ for (const fieldMetadataUniversalIdentifier of fieldMetadataUniversalIdentifiers) {
+ const flatFieldMetadata = findFlatEntityByUniversalIdentifier({
+ universalIdentifier: fieldMetadataUniversalIdentifier,
+ flatEntityMaps: flatFieldMetadataMaps,
+ });
+
+ if (!isDefined(flatFieldMetadata)) {
+ return [
+ buildInvalidInputError({
+ message: t`Related record path field not found`,
+ userFriendlyMessage: msg`Related record path field not found`,
+ }),
+ ];
+ }
+
+ if (
+ flatFieldMetadata.objectMetadataUniversalIdentifier !==
+ currentObjectMetadataUniversalIdentifier
+ ) {
+ return [
+ buildInvalidInputError({
+ message: t`Each related record path field must belong to the object reached by the previous relation`,
+ userFriendlyMessage: msg`Each related record path field must belong to the object reached by the previous relation`,
+ }),
+ ];
+ }
+
+ if (
+ !isMorphOrRelationUniversalFlatFieldMetadata(flatFieldMetadata) ||
+ isMorphRelationHead(flatFieldMetadata) ||
+ !isDefined(
+ flatFieldMetadata.relationTargetObjectMetadataUniversalIdentifier,
+ )
+ ) {
+ return [
+ buildInvalidInputError({
+ message: t`Related record path fields must be relations`,
+ userFriendlyMessage: msg`Related record path fields must be relations`,
+ }),
+ ];
+ }
+
+ if (!flatFieldMetadata.isActive) {
+ return [
+ buildInvalidInputError({
+ message: t`Related record path fields must be active`,
+ userFriendlyMessage: msg`Related record path fields must be active`,
+ }),
+ ];
+ }
+
+ const nextObjectMetadataUniversalIdentifier =
+ flatFieldMetadata.relationTargetObjectMetadataUniversalIdentifier;
+
+ if (
+ visitedObjectMetadataUniversalIdentifiers.has(
+ nextObjectMetadataUniversalIdentifier,
+ )
+ ) {
+ return [
+ buildInvalidInputError({
+ message: t`Related record path cannot visit the same object twice`,
+ userFriendlyMessage: msg`Related record path cannot visit the same object twice`,
+ }),
+ ];
+ }
+
+ visitedObjectMetadataUniversalIdentifiers.add(
+ nextObjectMetadataUniversalIdentifier,
+ );
+ currentObjectMetadataUniversalIdentifier =
+ nextObjectMetadataUniversalIdentifier;
+ }
+
+ const hasDuplicatePath = Object.values(
+ flatRelatedRecordPathMaps.byUniversalIdentifier,
+ ).some(
+ (otherFlatRelatedRecordPath) =>
+ isDefined(otherFlatRelatedRecordPath) &&
+ otherFlatRelatedRecordPath.universalIdentifier !==
+ universalFlatRelatedRecordPath.universalIdentifier &&
+ getRelatedRecordPathFieldMetadataUniversalIdentifiers(
+ otherFlatRelatedRecordPath,
+ ).join() === fieldMetadataUniversalIdentifiers.join(),
+ );
+
+ if (hasDuplicatePath) {
+ return [
+ buildInvalidInputError({
+ message: t`This related record path already exists`,
+ userFriendlyMessage: msg`This related record path already exists`,
+ }),
+ ];
+ }
+
+ return [];
+ }
+
+ public validateFlatRelatedRecordPathCreation({
+ flatEntityToValidate: universalFlatRelatedRecordPath,
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps,
+ }: UniversalFlatEntityValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >): FailedFlatEntityValidation<'relatedRecordPath', 'create'> {
+ const validationResult = getEmptyFlatEntityValidationError({
+ flatEntityMinimalInformation: {
+ universalIdentifier: universalFlatRelatedRecordPath.universalIdentifier,
+ },
+ metadataName: 'relatedRecordPath',
+ type: 'create',
+ });
+
+ validationResult.errors.push(
+ ...this.collectPathErrors({
+ universalFlatRelatedRecordPath,
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps,
+ }),
+ );
+
+ return validationResult;
+ }
+
+ public validateFlatRelatedRecordPathDeletion({
+ flatEntityToValidate,
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps: {
+ flatRelatedRecordPathMaps,
+ },
+ }: UniversalFlatEntityValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >): FailedFlatEntityValidation<'relatedRecordPath', 'delete'> {
+ const validationResult = getEmptyFlatEntityValidationError({
+ flatEntityMinimalInformation: {
+ universalIdentifier: flatEntityToValidate.universalIdentifier,
+ },
+ metadataName: 'relatedRecordPath',
+ type: 'delete',
+ });
+
+ const existingFlatRelatedRecordPath = findFlatEntityByUniversalIdentifier({
+ universalIdentifier: flatEntityToValidate.universalIdentifier,
+ flatEntityMaps: flatRelatedRecordPathMaps,
+ });
+
+ if (!isDefined(existingFlatRelatedRecordPath)) {
+ validationResult.errors.push(buildNotFoundError());
+ }
+
+ return validationResult;
+ }
+
+ public validateFlatRelatedRecordPathUpdate({
+ universalIdentifier,
+ flatEntityUpdate,
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps,
+ }: FlatEntityUpdateValidationArgs<
+ typeof ALL_METADATA_NAME.relatedRecordPath
+ >): FailedFlatEntityValidation<'relatedRecordPath', 'update'> {
+ const validationResult = getEmptyFlatEntityValidationError({
+ flatEntityMinimalInformation: {
+ universalIdentifier,
+ },
+ metadataName: 'relatedRecordPath',
+ type: 'update',
+ });
+
+ const existingFlatRelatedRecordPath = findFlatEntityByUniversalIdentifier({
+ universalIdentifier,
+ flatEntityMaps:
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps.flatRelatedRecordPathMaps,
+ });
+
+ if (!isDefined(existingFlatRelatedRecordPath)) {
+ validationResult.errors.push(buildNotFoundError());
+
+ return validationResult;
+ }
+
+ validationResult.errors.push(
+ ...this.collectPathErrors({
+ universalFlatRelatedRecordPath: {
+ ...existingFlatRelatedRecordPath,
+ ...flatEntityUpdate,
+ },
+ optimisticFlatEntityMapsAndRelatedFlatEntityMaps,
+ }),
+ );
+
+ return validationResult;
+ }
+}
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts
index 2747ccd8468..704923fb4a5 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts
@@ -37,6 +37,7 @@ import { FlatTimelineActivityTypeValidatorService } from 'src/engine/workspace-m
import { FlatAgentChatChannelRoleValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-agent-chat-channel-role-validator.service';
import { FlatAgentChatChannelValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-agent-chat-channel-validator.service';
import { FlatSettingsMenuItemValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-settings-menu-item-validator.service';
+import { FlatRelatedRecordPathValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-related-record-path-validator.service';
import { FlatValidationRuleValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-validation-rule-validator.service';
import { FlatSearchFieldMetadataValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-search-field-metadata-validator.service';
@@ -79,6 +80,7 @@ import { FlatSearchFieldMetadataValidatorService } from 'src/engine/workspace-ma
FlatSettingsMenuItemValidatorService,
FlatAgentChatChannelValidatorService,
FlatAgentChatChannelRoleValidatorService,
+ FlatRelatedRecordPathValidatorService,
FlatValidationRuleValidatorService,
FlatSearchFieldMetadataValidatorService,
],
@@ -118,6 +120,7 @@ import { FlatSearchFieldMetadataValidatorService } from 'src/engine/workspace-ma
FlatSettingsMenuItemValidatorService,
FlatAgentChatChannelValidatorService,
FlatAgentChatChannelRoleValidatorService,
+ FlatRelatedRecordPathValidatorService,
FlatValidationRuleValidatorService,
FlatSearchFieldMetadataValidatorService,
],
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts
index 4c6dfc49044..ddecf9a6fea 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts
@@ -40,6 +40,7 @@ import { WorkspaceMigrationTimelineActivityTypeActionsBuilderService } from 'src
import { WorkspaceMigrationAgentChatChannelActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/agent-chat-channel/workspace-migration-agent-chat-channel-actions-builder.service';
import { WorkspaceMigrationAgentChatChannelRoleActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/agent-chat-channel-role/workspace-migration-agent-chat-channel-role-actions-builder.service';
import { WorkspaceMigrationSettingsMenuItemActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/settings-menu-item/workspace-migration-settings-menu-item-actions-builder.service';
+import { WorkspaceMigrationRelatedRecordPathActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/workspace-migration-related-record-path-actions-builder.service';
import { WorkspaceMigrationValidationRuleActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/validation-rule/workspace-migration-validation-rule-actions-builder.service';
import { WorkspaceMigrationSearchFieldMetadataActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/search-field-metadata/workspace-migration-search-field-metadata-actions.builder.service';
import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module';
@@ -86,6 +87,7 @@ import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-
WorkspaceMigrationSettingsMenuItemActionsBuilderService,
WorkspaceMigrationAgentChatChannelActionsBuilderService,
WorkspaceMigrationAgentChatChannelRoleActionsBuilderService,
+ WorkspaceMigrationRelatedRecordPathActionsBuilderService,
WorkspaceMigrationValidationRuleActionsBuilderService,
WorkspaceMigrationSearchFieldMetadataActionsBuilderService,
],
@@ -128,6 +130,7 @@ import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-
WorkspaceMigrationSettingsMenuItemActionsBuilderService,
WorkspaceMigrationAgentChatChannelActionsBuilderService,
WorkspaceMigrationAgentChatChannelRoleActionsBuilderService,
+ WorkspaceMigrationRelatedRecordPathActionsBuilderService,
WorkspaceMigrationValidationRuleActionsBuilderService,
WorkspaceMigrationSearchFieldMetadataActionsBuilderService,
],
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/create-related-record-path-action-handler.service.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/create-related-record-path-action-handler.service.ts
new file mode 100644
index 00000000000..134914cfe45
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/create-related-record-path-action-handler.service.ts
@@ -0,0 +1,80 @@
+/* @license Enterprise */
+
+import { Injectable } from '@nestjs/common';
+
+import { v4 } from 'uuid';
+
+import { WorkspaceMigrationRunnerActionHandler } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { getUniversalFlatEntityEmptyForeignKeyAggregators } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/reset-universal-flat-entity-foreign-key-aggregators.util';
+import { resolveUniversalRelationIdentifiersToIds } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/resolve-universal-relation-identifiers-to-ids.util';
+import {
+ FlatCreateRelatedRecordPathAction,
+ UniversalCreateRelatedRecordPathAction,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type';
+import {
+ WorkspaceMigrationActionRunnerArgs,
+ WorkspaceMigrationActionRunnerContext,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class CreateRelatedRecordPathActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+ 'create',
+ 'relatedRecordPath',
+) {
+ override async transpileUniversalActionToFlatAction({
+ action,
+ allFlatEntityMaps,
+ flatApplication,
+ workspaceId,
+ }: WorkspaceMigrationActionRunnerArgs<UniversalCreateRelatedRecordPathAction>): Promise<FlatCreateRelatedRecordPathAction> {
+ const {
+ objectMetadataId,
+ firstFieldMetadataId,
+ secondFieldMetadataId,
+ thirdFieldMetadataId,
+ } = resolveUniversalRelationIdentifiersToIds({
+ flatEntityMaps: allFlatEntityMaps,
+ metadataName: action.metadataName,
+ universalForeignKeyValues: action.flatEntity,
+ });
+
+ const emptyUniversalForeignKeyAggregators =
+ getUniversalFlatEntityEmptyForeignKeyAggregators({
+ metadataName: 'relatedRecordPath',
+ });
+
+ return {
+ ...action,
+ flatEntity: {
+ ...action.flatEntity,
+ objectMetadataId,
+ firstFieldMetadataId,
+ secondFieldMetadataId,
+ thirdFieldMetadataId,
+ applicationId: flatApplication.id,
+ id: action.id ?? v4(),
+ workspaceId,
+ ...emptyUniversalForeignKeyAggregators,
+ },
+ };
+ }
+
+ async executeForMetadata(
+ context: WorkspaceMigrationActionRunnerContext<FlatCreateRelatedRecordPathAction>,
+ ): Promise<void> {
+ const { flatAction, queryRunner } = context;
+ const { flatEntity } = flatAction;
+
+ await this.insertFlatEntitiesInRepository({
+ queryRunner,
+ flatEntities: [flatEntity],
+ });
+ }
+
+ async executeForWorkspaceSchema(
+ _context: WorkspaceMigrationActionRunnerContext<FlatCreateRelatedRecordPathAction>,
+ ): Promise<void> {
+ return;
+ }
+}
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/delete-related-record-path-action-handler.service.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/delete-related-record-path-action-handler.service.ts
new file mode 100644
index 00000000000..4772e7ac5ef
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/delete-related-record-path-action-handler.service.ts
@@ -0,0 +1,49 @@
+/* @license Enterprise */
+
+import { Injectable } from '@nestjs/common';
+
+import { WorkspaceMigrationRunnerActionHandler } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { RelatedRecordPathEntity } from 'src/engine/metadata-modules/related-record-path/entities/related-record-path.entity';
+import {
+ FlatDeleteRelatedRecordPathAction,
+ UniversalDeleteRelatedRecordPathAction,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type';
+import {
+ WorkspaceMigrationActionRunnerArgs,
+ WorkspaceMigrationActionRunnerContext,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class DeleteRelatedRecordPathActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+ 'delete',
+ 'relatedRecordPath',
+) {
+ override async transpileUniversalActionToFlatAction(
+ context: WorkspaceMigrationActionRunnerArgs<UniversalDeleteRelatedRecordPathAction>,
+ ): Promise<FlatDeleteRelatedRecordPathAction> {
+ return this.transpileUniversalDeleteActionToFlatDeleteAction(context);
+ }
+
+ async executeForMetadata(
+ context: WorkspaceMigrationActionRunnerContext<FlatDeleteRelatedRecordPathAction>,
+ ): Promise<void> {
+ const { flatAction, queryRunner, workspaceId } = context;
+
+ const repository =
+ queryRunner.manager.getRepository<RelatedRecordPathEntity>(
+ RelatedRecordPathEntity,
+ );
+
+ await repository.delete({
+ id: flatAction.entityId,
+ workspaceId,
+ });
+ }
+
+ async executeForWorkspaceSchema(
+ _context: WorkspaceMigrationActionRunnerContext<FlatDeleteRelatedRecordPathAction>,
+ ): Promise<void> {
+ return;
+ }
+}
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/update-related-record-path-action-handler.service.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/update-related-record-path-action-handler.service.ts
new file mode 100644
index 00000000000..1d61230fde9
--- /dev/null
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/update-related-record-path-action-handler.service.ts
@@ -0,0 +1,67 @@
+/* @license Enterprise */
+
+import { Injectable } from '@nestjs/common';
+
+import { WorkspaceMigrationRunnerActionHandler } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { findFlatEntityByUniversalIdentifierOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-universal-identifier-or-throw.util';
+import { RelatedRecordPathEntity } from 'src/engine/metadata-modules/related-record-path/entities/related-record-path.entity';
+import { resolveUniversalUpdateRelationIdentifiersToIds } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/resolve-universal-update-relation-identifiers-to-ids.util';
+import {
+ FlatUpdateRelatedRecordPathAction,
+ UniversalUpdateRelatedRecordPathAction,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/related-record-path/types/workspace-migration-related-record-path-action.type';
+import {
+ WorkspaceMigrationActionRunnerArgs,
+ WorkspaceMigrationActionRunnerContext,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class UpdateRelatedRecordPathActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+ 'update',
+ 'relatedRecordPath',
+) {
+ override async transpileUniversalActionToFlatAction(
+ context: WorkspaceMigrationActionRunnerArgs<UniversalUpdateRelatedRecordPathAction>,
+ ): Promise<FlatUpdateRelatedRecordPathAction> {
+ const { action, allFlatEntityMaps } = context;
+
+ const flatRelatedRecordPath = findFlatEntityByUniversalIdentifierOrThrow({
+ flatEntityMaps: allFlatEntityMaps.flatRelatedRecordPathMaps,
+ universalIdentifier: action.universalIdentifier,
+ });
+
+ const update = resolveUniversalUpdateRelationIdentifiersToIds({
+ metadataName: 'relatedRecordPath',
+ universalUpdate: action.update,
+ allFlatEntityMaps,
+ });
+
+ return {
+ type: 'update',
+ metadataName: 'relatedRecordPath',
+ entityId: flatRelatedRecordPath.id,
+ update,
+ };
+ }
+
+ async executeForMetadata(
+ context: WorkspaceMigrationActionRunnerContext<FlatUpdateRelatedRecordPathAction>,
+ ): Promise<void> {
+ const { flatAction, queryRunner, workspaceId } = context;
+ const { entityId, update } = flatAction;
+
+ const repository =
+ queryRunner.manager.getRepository<RelatedRecordPathEntity>(
+ RelatedRecordPathEntity,
+ );
+
+ await repository.update({ id: entityId, workspaceId }, update);
+ }
+
+ async executeForWorkspaceSchema(
+ _context: WorkspaceMigrationActionRunnerContext<FlatUpdateRelatedRecordPathAction>,
+ ): Promise<void> {
+ return;
+ }
+}
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module.ts
index 19c3f433d56..8033066403f 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module.ts
@@ -116,8 +116,11 @@ import { DeleteAgentChatChannelRoleActionHandlerService } from 'src/engine/works
import { CreateSettingsMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/settings-menu-item/services/create-settings-menu-item-action-handler.service';
import { DeleteSettingsMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/settings-menu-item/services/delete-settings-menu-item-action-handler.service';
import { UpdateSettingsMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/settings-menu-item/services/update-settings-menu-item-action-handler.service';
+import { CreateRelatedRecordPathActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/create-related-record-path-action-handler.service';
import { CreateValidationRuleActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/validation-rule/services/create-validation-rule-action-handler.service';
+import { DeleteRelatedRecordPathActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/delete-related-record-path-action-handler.service';
import { DeleteValidationRuleActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/validation-rule/services/delete-validation-rule-action-handler.service';
+import { UpdateRelatedRecordPathActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/related-record-path/services/update-related-record-path-action-handler.service';
import { UpdateValidationRuleActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/validation-rule/services/update-validation-rule-action-handler.service';
import { CreateSearchFieldMetadataActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/search-field-metadata/services/create-search-field-metadata-action-handler.service';
import { DeleteSearchFieldMetadataActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/search-field-metadata/services/delete-search-field-metadata-action-handler.service';
@@ -283,8 +286,11 @@ import { WorkflowDeletionModule } from 'src/modules/workflow/workflow-deletion/w
CreateAgentChatChannelRoleActionHandlerService,
UpdateAgentChatChannelRoleActionHandlerService,
DeleteAgentChatChannelRoleActionHandlerService,
+ CreateRelatedRecordPathActionHandlerService,
CreateValidationRuleActionHandlerService,
+ UpdateRelatedRecordPathActionHandlerService,
UpdateValidationRuleActionHandlerService,
+ DeleteRelatedRecordPathActionHandlerService,
DeleteValidationRuleActionHandlerService,
CreateSearchFieldMetadataActionHandlerService,
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/constants/metadata-event-to-emit.constant.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/constants/metadata-event-to-emit.constant.ts
index b90cba85820..405d2a08dd6 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/constants/metadata-event-to-emit.constant.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/constants/metadata-event-to-emit.constant.ts
@@ -34,6 +34,7 @@ export const METADATA_EVENTS_TO_EMIT = {
connectionProvider: true,
messagingProvider: true,
timelineActivityType: true,
+ relatedRecordPath: true,
validationRule: true,
searchFieldMetadata: true,
agentChatChannel: true,
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-create-action.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-create-action.util.ts
index 0ec63282c80..b7cd52f17f4 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-create-action.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-create-action.util.ts
@@ -107,6 +107,7 @@ const deriveAllMetadataEventsFromCreateAction = (
case 'agentChatChannel':
case 'agentChatChannelRole':
case 'settingsMenuItem':
+ case 'relatedRecordPath':
case 'validationRule':
case 'searchFieldMetadata': {
return [
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-delete-action.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-delete-action.util.ts
index f144db319df..e7caa18eae6 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-delete-action.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-delete-action.util.ts
@@ -71,6 +71,7 @@ const deriveAllMetadataEventsFromDeleteAction = ({
case 'agentChatChannel':
case 'agentChatChannelRole':
case 'settingsMenuItem':
+ case 'relatedRecordPath':
case 'validationRule':
case 'searchFieldMetadata': {
const flatEntityToDelete = findFlatEntityByIdInFlatEntityMapsOrThrow<
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-update-action.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-update-action.util.ts
index 9076031cef1..1243479f92d 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-update-action.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/derive-metadata-events-from-update-action.util.ts
@@ -149,6 +149,7 @@ const deriveAllMetadataEventsFromUpdateAction = ({
case 'agentChatChannel':
case 'agentChatChannelRole':
case 'settingsMenuItem':
+ case 'relatedRecordPath':
case 'validationRule':
case 'searchFieldMetadata': {
const flatEntityMapsKey = getMetadataFlatEntityMapsKey(
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-create-action-on-all-flat-entity-maps.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-create-action-on-all-flat-entity-maps.util.ts
index 7f80c8e8f93..5f17a501dc1 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-create-action-on-all-flat-entity-maps.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-create-action-on-all-flat-entity-maps.util.ts
@@ -94,6 +94,7 @@ export const optimisticallyApplyCreateActionOnAllFlatEntityMaps = ({
case 'agentChatChannel':
case 'agentChatChannelRole':
case 'settingsMenuItem':
+ case 'relatedRecordPath':
case 'validationRule': {
addFlatEntityToFlatEntityAndRelatedEntityMapsThroughMutationOrThrow({
flatEntity: flatAction.flatEntity,
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-delete-action-on-all-flat-entity-maps.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-delete-action-on-all-flat-entity-maps.util.ts
index f94a18eaaab..667f4f2dff4 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-delete-action-on-all-flat-entity-maps.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-delete-action-on-all-flat-entity-maps.util.ts
@@ -55,6 +55,7 @@ export const optimisticallyApplyDeleteActionOnAllFlatEntityMaps = ({
case 'agentChatChannel':
case 'agentChatChannelRole':
case 'settingsMenuItem':
+ case 'relatedRecordPath':
case 'validationRule':
case 'searchFieldMetadata': {
const flatEntityToDelete = findFlatEntityByIdInFlatEntityMapsOrThrow<
diff --git a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-update-action-on-all-flat-entity-maps.util.ts b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-update-action-on-all-flat-entity-maps.util.ts
index 062b28fc792..3b0e1637787 100644
--- a/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-update-action-on-all-flat-entity-maps.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-update-action-on-all-flat-entity-maps.util.ts
@@ -76,6 +76,7 @@ export const optimisticallyApplyUpdateActionOnAllFlatEntityMaps = ({
case 'agentChatChannel':
case 'agentChatChannelRole':
case 'settingsMenuItem':
+ case 'relatedRecordPath':
case 'validationRule':
case 'searchFieldMetadata': {
const flatEntityMapsKey = getMetadataFlatEntityMapsKey(
diff --git a/packages/twenty-shared/src/metadata/constants/all-metadata-name.constant.ts b/packages/twenty-shared/src/metadata/constants/all-metadata-name.constant.ts
index af4e8fc23d6..c1c9fe66a88 100644
--- a/packages/twenty-shared/src/metadata/constants/all-metadata-name.constant.ts
+++ b/packages/twenty-shared/src/metadata/constants/all-metadata-name.constant.ts
@@ -34,6 +34,7 @@ export const ALL_METADATA_NAME = {
searchFieldMetadata: 'searchFieldMetadata',
timelineActivityType: 'timelineActivityType',
settingsMenuItem: 'settingsMenuItem',
+ relatedRecordPath: 'relatedRecordPath',
validationRule: 'validationRule',
workflow: 'workflow',
workflowVersion: 'workflowVersion',