Skip to content

The open alternative to Salesforce, designed for AI.

Configure related record paths in object settings (#29335)

Charles Bocheteb2f6eb06e55
diff --git a/packages/twenty-front/codegen-metadata.cjs b/packages/twenty-front/codegen-metadata.cjs
index a9df831799a..5843bb7bfc6 100644
--- a/packages/twenty-front/codegen-metadata.cjs
+++ b/packages/twenty-front/codegen-metadata.cjs
@@ -28,6 +28,7 @@ module.exports = {
'./src/modules/analytics/graphql/**/*.{ts,tsx}',
'./src/modules/object-metadata/graphql/**/*.{ts,tsx}',
'./src/modules/validation-rules/graphql/**/*.{ts,tsx}',
+ './src/modules/related-record-paths/graphql/**/*.{ts,tsx}',
'./src/modules/navigation-menu-item/**/graphql/**/*.{ts,tsx}',
'./src/modules/command-menu-item/graphql/**/*.{ts,tsx}',
'./src/modules/file/graphql/**/*.{ts,tsx}',
diff --git a/packages/twenty-front/src/generated-metadata/graphql.ts b/packages/twenty-front/src/generated-metadata/graphql.ts
index 6e917e8bcae..b259678e3f3 100644
--- a/packages/twenty-front/src/generated-metadata/graphql.ts
+++ b/packages/twenty-front/src/generated-metadata/graphql.ts
@@ -1617,6 +1617,27 @@ export type ExportRecordsSubscriptionVariables = Exact<{
export type ExportRecordsSubscription = { exportRecords: { __typename: 'RecordExport', id: string, filename: string, progress: number, errorMessage: string | null, downloadPath: string | null } };
+export type RelatedRecordPathFragmentFragment = { __typename: 'RelatedRecordPath', id: string, objectMetadataId: string, firstFieldMetadataId: string, secondFieldMetadataId: string | null, thirdFieldMetadataId: string | null, isInherent: boolean };
+
+export type CreateRelatedRecordPathMutationVariables = Exact<{
+ input: Types.CreateRelatedRecordPathInput;
+}>;
+
+
+export type CreateRelatedRecordPathMutation = { createRelatedRecordPath: { __typename: 'RelatedRecordPath', id: string, objectMetadataId: string, firstFieldMetadataId: string, secondFieldMetadataId: string | null, thirdFieldMetadataId: string | null, isInherent: boolean } };
+
+export type DeleteRelatedRecordPathMutationVariables = Exact<{
+ id: string;
+}>;
+
+
+export type DeleteRelatedRecordPathMutation = { deleteRelatedRecordPath: { __typename: 'RelatedRecordPath', id: string, objectMetadataId: string, firstFieldMetadataId: string, secondFieldMetadataId: string | null, thirdFieldMetadataId: string | null, isInherent: boolean } };
+
+export type FindManyRelatedRecordPathsQueryVariables = Exact<{ [key: string]: never; }>;
+
+
+export type FindManyRelatedRecordPathsQuery = { relatedRecordPaths: Array<{ __typename: 'RelatedRecordPath', id: string, objectMetadataId: string, firstFieldMetadataId: string, secondFieldMetadataId: string | null, thirdFieldMetadataId: string | null, isInherent: boolean }> };
+
export type CreateEmailGroupChannelMutationVariables = Exact<{
input: Types.CreateEmailGroupChannelInput;
}>;
@@ -2875,6 +2896,7 @@ export const MarketplaceAppFieldsFragmentDoc = {"kind":"Document","definitions":
export const NavigationMenuItemFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"NavigationMenuItemFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NavigationMenuItem"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"userWorkspaceId"}},{"kind":"Field","name":{"kind":"Name","value":"targetRecordId"}},{"kind":"Field","name":{"kind":"Name","value":"targetObjectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"folderId"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"link"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutId"}},{"kind":"Field","name":{"kind":"Name","value":"agentChatChannelId"}},{"kind":"Field","name":{"kind":"Name","value":"position"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<NavigationMenuItemFieldsFragment, unknown>;
export const NavigationMenuItemQueryFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"NavigationMenuItemQueryFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NavigationMenuItem"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"NavigationMenuItemFields"}},{"kind":"Field","name":{"kind":"Name","value":"targetRecordIdentifier"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"labelIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"imageIdentifier"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"NavigationMenuItemFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NavigationMenuItem"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"userWorkspaceId"}},{"kind":"Field","name":{"kind":"Name","value":"targetRecordId"}},{"kind":"Field","name":{"kind":"Name","value":"targetObjectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"folderId"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"link"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutId"}},{"kind":"Field","name":{"kind":"Name","value":"agentChatChannelId"}},{"kind":"Field","name":{"kind":"Name","value":"position"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<NavigationMenuItemQueryFieldsFragment, unknown>;
export const RecordSharingFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"RecordSharingFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RecordSharingDTO"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"sharingMode"}},{"kind":"Field","name":{"kind":"Name","value":"canManageSharing"}},{"kind":"Field","name":{"kind":"Name","value":"permissions"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"canRead"}},{"kind":"Field","name":{"kind":"Name","value":"canUpdate"}},{"kind":"Field","name":{"kind":"Name","value":"canDelete"}},{"kind":"Field","name":{"kind":"Name","value":"canSoftDelete"}}]}},{"kind":"Field","name":{"kind":"Name","value":"generalAccessLevel"}},{"kind":"Field","name":{"kind":"Name","value":"defaultGeneralAccessLevel"}},{"kind":"Field","name":{"kind":"Name","value":"hasManagedGeneralAccess"}},{"kind":"Field","name":{"kind":"Name","value":"shares"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"principalId"}},{"kind":"Field","name":{"kind":"Name","value":"principalType"}},{"kind":"Field","name":{"kind":"Name","value":"principalRoleId"}},{"kind":"Field","name":{"kind":"Name","value":"accessLevel"}},{"kind":"Field","name":{"kind":"Name","value":"rowCause"}}]}},{"kind":"Field","name":{"kind":"Name","value":"roles"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"label"}},{"kind":"Field","name":{"kind":"Name","value":"canRead"}},{"kind":"Field","name":{"kind":"Name","value":"canUpdate"}}]}}]}}]} as unknown as DocumentNode<RecordSharingFieldsFragment, unknown>;
+export const RelatedRecordPathFragmentFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"RelatedRecordPathFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RelatedRecordPath"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"firstFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"thirdFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isInherent"}}]}}]} as unknown as DocumentNode<RelatedRecordPathFragmentFragment, unknown>;
export const ApplicationRegistrationFragmentFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"ApplicationRegistrationFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ApplicationRegistration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"logoUrl"}},{"kind":"Field","name":{"kind":"Name","value":"galleryImagesUrls"}},{"kind":"Field","name":{"kind":"Name","value":"oAuthClientId"}},{"kind":"Field","name":{"kind":"Name","value":"oAuthRedirectUris"}},{"kind":"Field","name":{"kind":"Name","value":"oAuthScopes"}},{"kind":"Field","name":{"kind":"Name","value":"sourceType"}},{"kind":"Field","name":{"kind":"Name","value":"sourcePackage"}},{"kind":"Field","name":{"kind":"Name","value":"latestAvailableVersion"}},{"kind":"Field","name":{"kind":"Name","value":"isListed"}},{"kind":"Field","name":{"kind":"Name","value":"isPreInstalled"}},{"kind":"Field","name":{"kind":"Name","value":"isConfigured"}},{"kind":"Field","name":{"kind":"Name","value":"ownerWorkspaceId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<ApplicationRegistrationFragmentFragment, unknown>;
export const ApplicationRegistrationListItemFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"ApplicationRegistrationListItem"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ApplicationRegistration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"sourceType"}},{"kind":"Field","name":{"kind":"Name","value":"logoUrl"}}]}}]} as unknown as DocumentNode<ApplicationRegistrationListItemFragment, unknown>;
export const ApplicationConnectionProviderFragmentFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"ApplicationConnectionProviderFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ApplicationConnectionProvider"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"displayName"}},{"kind":"Field","name":{"kind":"Name","value":"scope"}},{"kind":"Field","name":{"kind":"Name","value":"logoUrl"}},{"kind":"Field","name":{"kind":"Name","value":"oauth"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"scopes"}},{"kind":"Field","name":{"kind":"Name","value":"isClientCredentialsConfigured"}}]}}]}}]} as unknown as DocumentNode<ApplicationConnectionProviderFragmentFragment, unknown>;
@@ -3078,6 +3100,9 @@ export const BarChartDataDocument = {"kind":"Document","definitions":[{"kind":"O
export const LineChartDataDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"LineChartData"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"LineChartDataInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"lineChartData"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"series"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"key"}},{"kind":"Field","name":{"kind":"Name","value":"label"}},{"kind":"Field","name":{"kind":"Name","value":"data"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"x"}},{"kind":"Field","name":{"kind":"Name","value":"y"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"xAxisLabel"}},{"kind":"Field","name":{"kind":"Name","value":"yAxisLabel"}},{"kind":"Field","name":{"kind":"Name","value":"showLegend"}},{"kind":"Field","name":{"kind":"Name","value":"showDataLabels"}},{"kind":"Field","name":{"kind":"Name","value":"hasTooManyGroups"}},{"kind":"Field","name":{"kind":"Name","value":"formattedToRawLookup"}}]}}]}}]} as unknown as DocumentNode<LineChartDataQuery, LineChartDataQueryVariables>;
export const PieChartDataDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"PieChartData"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"PieChartDataInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"pieChartData"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"data"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"key"}},{"kind":"Field","name":{"kind":"Name","value":"value"}}]}},{"kind":"Field","name":{"kind":"Name","value":"showLegend"}},{"kind":"Field","name":{"kind":"Name","value":"showDataLabels"}},{"kind":"Field","name":{"kind":"Name","value":"showCenterMetric"}},{"kind":"Field","name":{"kind":"Name","value":"hasTooManyGroups"}},{"kind":"Field","name":{"kind":"Name","value":"formattedToRawLookup"}}]}}]}}]} as unknown as DocumentNode<PieChartDataQuery, PieChartDataQueryVariables>;
export const ExportRecordsDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"subscription","name":{"kind":"Name","value":"ExportRecords"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"CreateRecordExportInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"exportRecords"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"filename"}},{"kind":"Field","name":{"kind":"Name","value":"progress"}},{"kind":"Field","name":{"kind":"Name","value":"errorMessage"}},{"kind":"Field","name":{"kind":"Name","value":"downloadPath"}}]}}]}}]} as unknown as DocumentNode<ExportRecordsSubscription, ExportRecordsSubscriptionVariables>;
+export const CreateRelatedRecordPathDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"CreateRelatedRecordPath"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"CreateRelatedRecordPathInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"createRelatedRecordPath"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"RelatedRecordPathFragment"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"RelatedRecordPathFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RelatedRecordPath"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"firstFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"thirdFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isInherent"}}]}}]} as unknown as DocumentNode<CreateRelatedRecordPathMutation, CreateRelatedRecordPathMutationVariables>;
+export const DeleteRelatedRecordPathDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"DeleteRelatedRecordPath"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"id"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"UUID"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"deleteRelatedRecordPath"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"id"},"value":{"kind":"Variable","name":{"kind":"Name","value":"id"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"RelatedRecordPathFragment"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"RelatedRecordPathFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RelatedRecordPath"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"firstFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"thirdFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isInherent"}}]}}]} as unknown as DocumentNode<DeleteRelatedRecordPathMutation, DeleteRelatedRecordPathMutationVariables>;
+export const FindManyRelatedRecordPathsDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"FindManyRelatedRecordPaths"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"relatedRecordPaths"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"RelatedRecordPathFragment"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"RelatedRecordPathFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RelatedRecordPath"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"firstFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"thirdFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isInherent"}}]}}]} as unknown as DocumentNode<FindManyRelatedRecordPathsQuery, FindManyRelatedRecordPathsQueryVariables>;
export const CreateEmailGroupChannelDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"CreateEmailGroupChannel"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"CreateEmailGroupChannelInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"createEmailGroupChannel"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"messageChannel"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"handle"}},{"kind":"Field","name":{"kind":"Name","value":"visibility"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"isSyncEnabled"}},{"kind":"Field","name":{"kind":"Name","value":"excludeGroupEmails"}},{"kind":"Field","name":{"kind":"Name","value":"contactAutoCreationPolicy"}}]}},{"kind":"Field","name":{"kind":"Name","value":"forwardingAddress"}}]}}]}}]} as unknown as DocumentNode<CreateEmailGroupChannelMutation, CreateEmailGroupChannelMutationVariables>;
export const DeleteConnectedAccountDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"DeleteConnectedAccount"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"id"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"UUID"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"deleteConnectedAccount"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"id"},"value":{"kind":"Variable","name":{"kind":"Name","value":"id"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}}]}}]}}]} as unknown as DocumentNode<DeleteConnectedAccountMutation, DeleteConnectedAccountMutationVariables>;
export const DeleteEmailGroupChannelDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"DeleteEmailGroupChannel"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"id"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"UUID"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"deleteEmailGroupChannel"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"id"},"value":{"kind":"Variable","name":{"kind":"Name","value":"id"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}}]}}]}}]} as unknown as DocumentNode<DeleteEmailGroupChannelMutation, DeleteEmailGroupChannelMutationVariables>;
diff --git a/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathAddDropdown.tsx b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathAddDropdown.tsx
new file mode 100644
index 00000000000..c4e864fa919
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathAddDropdown.tsx
@@ -0,0 +1,44 @@
+import { useLingui } from '@lingui/react/macro';
+import { Dropdown } from 'twenty-ui/components/navigation';
+import { IconPlus } from 'twenty-ui/icon';
+import { Button } from 'twenty-ui/primitives/input';
+
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { SettingsObjectRelatedRecordPathPicker } from '@/related-record-paths/components/SettingsObjectRelatedRecordPathPicker';
+import { DropdownContent } from '@/ui/layout/dropdown/components/DropdownContent';
+import { DropdownRoot } from '@/ui/layout/dropdown/components/DropdownRoot';
+import { GenericDropdownContentWidth } from '@/ui/layout/dropdown/constants/GenericDropdownContentWidth';
+
+type SettingsObjectRelatedRecordPathAddDropdownProps = {
+ sourceObjectMetadataItem: EnrichedObjectMetadataItem;
+};
+
+export const SettingsObjectRelatedRecordPathAddDropdown = ({
+ sourceObjectMetadataItem,
+}: SettingsObjectRelatedRecordPathAddDropdownProps) => {
+ const { t } = useLingui();
+
+ return (
+ <DropdownRoot
+ dropdownId={`related-record-path-add-${sourceObjectMetadataItem.id}`}
+ type="picker"
+ >
+ <Dropdown.Trigger
+ render={
+ <Button startIcon={<IconPlus />} size="sm" variant="outline">
+ {t`Add path`}
+ </Button>
+ }
+ />
+ <DropdownContent
+ align="end"
+ sideOffset={4}
+ width={GenericDropdownContentWidth.ExtraLarge}
+ >
+ <SettingsObjectRelatedRecordPathPicker
+ sourceObjectMetadataItem={sourceObjectMetadataItem}
+ />
+ </DropdownContent>
+ </DropdownRoot>
+ );
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathPicker.tsx b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathPicker.tsx
new file mode 100644
index 00000000000..58791ca43b2
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathPicker.tsx
@@ -0,0 +1,159 @@
+import { useLingui } from '@lingui/react/macro';
+import { isNonEmptyString } from '@sniptt/guards';
+import { useState } from 'react';
+import { isDefined, isNonEmptyArray } from 'twenty-shared/utils';
+import { LightIconButton } from 'twenty-ui/components/input';
+import { Dropdown } from 'twenty-ui/components/navigation';
+import { IconChevronLeft, useIcons } from 'twenty-ui/icon';
+import { normalizeSearchText } from 'twenty-ui/utilities';
+
+import { useObjectMetadataItems } from '@/object-metadata/hooks/useObjectMetadataItems';
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { getObjectColorWithFallback } from '@/object-metadata/utils/getObjectColorWithFallback';
+import { useRelatedRecordPathMutations } from '@/related-record-paths/hooks/useRelatedRecordPathMutations';
+import { RELATED_RECORD_PATH_MAXIMUM_FIELD_COUNT } from '@/related-record-paths/constants/RelatedRecordPathMaximumFieldCount';
+import { findRelationTargetObjectMetadataItem } from '@/related-record-paths/utils/findRelationTargetObjectMetadataItem';
+import { getRelatedRecordPathNextFieldMetadataItems } from '@/related-record-paths/utils/getRelatedRecordPathNextFieldMetadataItems';
+import { getRelatedRecordPathSteps } from '@/related-record-paths/utils/getRelatedRecordPathSteps';
+import { SelectOptionIcon } from '@/ui/input/components/SelectOptionIcon';
+
+type SettingsObjectRelatedRecordPathPickerProps = {
+ sourceObjectMetadataItem: EnrichedObjectMetadataItem;
+};
+
+export const SettingsObjectRelatedRecordPathPicker = ({
+ sourceObjectMetadataItem,
+}: SettingsObjectRelatedRecordPathPickerProps) => {
+ const { t } = useLingui();
+ const [fieldMetadataIds, setFieldMetadataIds] = useState<string[]>([]);
+ const [searchInput, setSearchInput] = useState('');
+ const { createRelatedRecordPath } = useRelatedRecordPathMutations();
+ const { getIcon } = useIcons();
+ const { objectMetadataItems } = useObjectMetadataItems();
+
+ const steps = getRelatedRecordPathSteps({
+ sourceObjectMetadataItem,
+ fieldMetadataIds,
+ objectMetadataItems,
+ });
+ const lastStep = steps.at(-1);
+ const isLastHop =
+ steps.length === RELATED_RECORD_PATH_MAXIMUM_FIELD_COUNT - 1;
+
+ const candidateFieldMetadataItems =
+ getRelatedRecordPathNextFieldMetadataItems({
+ sourceObjectMetadataItem,
+ steps,
+ })
+ .filter((fieldMetadataItem) =>
+ normalizeSearchText(fieldMetadataItem.label).includes(
+ normalizeSearchText(searchInput),
+ ),
+ )
+ .sort((left, right) => left.label.localeCompare(right.label));
+
+ const navigateTo = (nextFieldMetadataIds: string[]) => {
+ setSearchInput('');
+ setFieldMetadataIds(nextFieldMetadataIds);
+ };
+
+ const createPath = ([
+ firstFieldMetadataId,
+ secondFieldMetadataId,
+ thirdFieldMetadataId,
+ ]: string[]) =>
+ createRelatedRecordPath({
+ objectMetadataId: sourceObjectMetadataItem.id,
+ firstFieldMetadataId,
+ secondFieldMetadataId,
+ thirdFieldMetadataId,
+ isInherent: false,
+ });
+
+ return (
+ <>
+ <Dropdown.Header>
+ {isNonEmptyArray(steps) && (
+ <LightIconButton
+ size="sm"
+ aria-label={t`Back`}
+ onClick={() => navigateTo(fieldMetadataIds.slice(0, -1))}
+ >
+ <IconChevronLeft />
+ </LightIconButton>
+ )}
+ <Dropdown.Title>
+ {lastStep?.fieldMetadataItem.label ??
+ sourceObjectMetadataItem.labelPlural}
+ </Dropdown.Title>
+ <Dropdown.Close aria-label={t`Close`} />
+ </Dropdown.Header>
+ <Dropdown.Search
+ key={fieldMetadataIds.join('.')}
+ autoFocus
+ aria-label={t`Search relations`}
+ placeholder={t`Search relations`}
+ value={searchInput}
+ onValueChange={setSearchInput}
+ />
+ <Dropdown.Separator />
+ <Dropdown.Section scrollable>
+ {isDefined(lastStep) && !isNonEmptyString(searchInput) && (
+ <>
+ <Dropdown.OptionItem
+ description={t`Add this path`}
+ startIcon={
+ <SelectOptionIcon
+ Icon={getIcon(lastStep.targetObjectMetadataItem.icon)}
+ color={getObjectColorWithFallback(
+ lastStep.targetObjectMetadataItem,
+ )}
+ />
+ }
+ onSelect={() => createPath(fieldMetadataIds)}
+ >
+ {lastStep.targetObjectMetadataItem.labelPlural}
+ </Dropdown.OptionItem>
+ {isNonEmptyArray(candidateFieldMetadataItems) && (
+ <Dropdown.Separator />
+ )}
+ </>
+ )}
+ {candidateFieldMetadataItems.map((fieldMetadataItem) => {
+ const nextFieldMetadataIds = [
+ ...fieldMetadataIds,
+ fieldMetadataItem.id,
+ ];
+
+ return (
+ <Dropdown.OptionItem
+ key={fieldMetadataItem.id}
+ hasSubmenu={!isLastHop}
+ closeOnSelect={isLastHop}
+ description={
+ findRelationTargetObjectMetadataItem({
+ fieldMetadataItem,
+ objectMetadataItems,
+ })?.labelPlural
+ }
+ startIcon={
+ <SelectOptionIcon Icon={getIcon(fieldMetadataItem.icon)} />
+ }
+ onSelect={() =>
+ isLastHop
+ ? createPath(nextFieldMetadataIds)
+ : navigateTo(nextFieldMetadataIds)
+ }
+ >
+ {fieldMetadataItem.label}
+ </Dropdown.OptionItem>
+ );
+ })}
+ {!isDefined(lastStep) &&
+ !isNonEmptyArray(candidateFieldMetadataItems) && (
+ <Dropdown.Empty>{t`No relations`}</Dropdown.Empty>
+ )}
+ </Dropdown.Section>
+ </>
+ );
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathTableRow.tsx b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathTableRow.tsx
new file mode 100644
index 00000000000..1f3708dc3b1
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathTableRow.tsx
@@ -0,0 +1,108 @@
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { Fragment } from 'react';
+import { LightIconButton } from 'twenty-ui/components/input';
+import { IconChevronRight, IconTrash, useIcons } from 'twenty-ui/icon';
+import { OverflowingTextWithTooltip } from 'twenty-ui/primitives/typography';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+
+import { ObjectMetadataIcon } from '@/object-metadata/components/ObjectMetadataIcon';
+import { useObjectMetadataItems } from '@/object-metadata/hooks/useObjectMetadataItems';
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { useRelatedRecordPathMutations } from '@/related-record-paths/hooks/useRelatedRecordPathMutations';
+import { RELATED_RECORD_PATH_TABLE_GRID_TEMPLATE_COLUMNS } from '@/related-record-paths/constants/RelatedRecordPathTableGridTemplateColumns';
+import { getRelatedRecordPathFieldMetadataIds } from '@/related-record-paths/utils/getRelatedRecordPathFieldMetadataIds';
+import { getRelatedRecordPathSteps } from '@/related-record-paths/utils/getRelatedRecordPathSteps';
+import { TableCell } from '@/ui/layout/table/components/TableCell';
+import { TableRow } from '@/ui/layout/table/components/TableRow';
+import { type RelatedRecordPath } from '~/generated-metadata/graphql';
+
+const StyledInlineIcon = styled.span<{ isSeparator?: boolean }>`
+ color: ${({ isSeparator }) =>
+ isSeparator ? themeCssVariables.font.color.tertiary : 'inherit'};
+ display: inline-flex;
+ margin: ${({ isSeparator }) =>
+ isSeparator
+ ? `0 ${themeCssVariables.spacing[1]}`
+ : `0 ${themeCssVariables.spacing[1]} 0 0`};
+ vertical-align: middle;
+`;
+
+type SettingsObjectRelatedRecordPathTableRowProps = {
+ sourceObjectMetadataItem: EnrichedObjectMetadataItem;
+ relatedRecordPath: RelatedRecordPath;
+ isReadOnly: boolean;
+};
+
+export const SettingsObjectRelatedRecordPathTableRow = ({
+ sourceObjectMetadataItem,
+ relatedRecordPath,
+ isReadOnly,
+}: SettingsObjectRelatedRecordPathTableRowProps) => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const { getIcon } = useIcons();
+ const { objectMetadataItems } = useObjectMetadataItems();
+ const { deleteRelatedRecordPath, isSaving } = useRelatedRecordPathMutations();
+
+ const steps = getRelatedRecordPathSteps({
+ sourceObjectMetadataItem,
+ fieldMetadataIds: getRelatedRecordPathFieldMetadataIds(relatedRecordPath),
+ objectMetadataItems,
+ });
+ const reachedObjectMetadataItem = steps.at(-1)?.targetObjectMetadataItem;
+ const relationLabel = steps
+ .map(({ fieldMetadataItem }) => fieldMetadataItem.label)
+ .join(' > ');
+
+ return (
+ <TableRow
+ gridTemplateColumns={RELATED_RECORD_PATH_TABLE_GRID_TEMPLATE_COLUMNS}
+ >
+ <TableCell
+ color={themeCssVariables.font.color.primary}
+ gap={themeCssVariables.spacing[2]}
+ >
+ <ObjectMetadataIcon
+ objectMetadataItem={reachedObjectMetadataItem}
+ size={theme.icon.size.md}
+ />
+ {reachedObjectMetadataItem?.labelPlural ?? t`Unavailable object`}
+ </TableCell>
+ <TableCell minWidth="0" overflow="hidden">
+ <OverflowingTextWithTooltip
+ tooltipContent={relationLabel}
+ text={steps.map(({ fieldMetadataItem }, index) => {
+ const FieldIcon = getIcon(fieldMetadataItem.icon);
+
+ return (
+ <Fragment key={fieldMetadataItem.id}>
+ {index > 0 && (
+ <StyledInlineIcon isSeparator>
+ <IconChevronRight size={theme.icon.size.sm} />
+ </StyledInlineIcon>
+ )}
+ <StyledInlineIcon>
+ <FieldIcon size={theme.icon.size.sm} />
+ </StyledInlineIcon>
+ <span>{fieldMetadataItem.label}</span>
+ </Fragment>
+ );
+ })}
+ />
+ </TableCell>
+ <TableCell align="center">
+ {!isReadOnly && (
+ <LightIconButton
+ emphasis="subtle"
+ disabled={isSaving}
+ aria-label={t`Delete related record path`}
+ onClick={() => deleteRelatedRecordPath(relatedRecordPath.id)}
+ >
+ <IconTrash />
+ </LightIconButton>
+ )}
+ </TableCell>
+ </TableRow>
+ );
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathsSection.tsx b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathsSection.tsx
new file mode 100644
index 00000000000..02197df2c9e
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/components/SettingsObjectRelatedRecordPathsSection.tsx
@@ -0,0 +1,93 @@
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { isDefined } from 'twenty-shared/utils';
+import { themeCssVariables } from 'twenty-ui/theme';
+
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { SettingsObjectRelatedRecordPathAddDropdown } from '@/related-record-paths/components/SettingsObjectRelatedRecordPathAddDropdown';
+import { SettingsObjectRelatedRecordPathTableRow } from '@/related-record-paths/components/SettingsObjectRelatedRecordPathTableRow';
+import { RELATED_RECORD_PATH_TABLE_GRID_TEMPLATE_COLUMNS } from '@/related-record-paths/constants/RelatedRecordPathTableGridTemplateColumns';
+import { useRelatedRecordPaths } from '@/related-record-paths/hooks/useRelatedRecordPaths';
+import { Table } from '@/ui/layout/table/components/Table';
+import { TableBody } from '@/ui/layout/table/components/TableBody';
+import { TableHeader } from '@/ui/layout/table/components/TableHeader';
+import { TableRow } from '@/ui/layout/table/components/TableRow';
+
+const StyledContent = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[3]};
+`;
+
+const StyledTableContainer = styled.div`
+ border-bottom: 1px solid ${themeCssVariables.border.color.light};
+`;
+
+const StyledEmpty = styled.div`
+ color: ${themeCssVariables.font.color.tertiary};
+ font-size: ${themeCssVariables.font.size.md};
+ padding: ${themeCssVariables.spacing[3]} ${themeCssVariables.spacing[2]};
+`;
+
+const StyledButtonContainer = styled.div`
+ display: flex;
+ justify-content: flex-end;
+`;
+
+type SettingsObjectRelatedRecordPathsSectionProps = {
+ objectMetadataItem: EnrichedObjectMetadataItem;
+ isReadOnly: boolean;
+};
+
+export const SettingsObjectRelatedRecordPathsSection = ({
+ objectMetadataItem,
+ isReadOnly,
+}: SettingsObjectRelatedRecordPathsSectionProps) => {
+ const { t } = useLingui();
+ const { relatedRecordPaths, loading, error } = useRelatedRecordPaths({
+ objectMetadataId: objectMetadataItem.id,
+ });
+
+ return (
+ <StyledContent>
+ <StyledTableContainer>
+ <Table>
+ <TableRow
+ gridTemplateColumns={
+ RELATED_RECORD_PATH_TABLE_GRID_TEMPLATE_COLUMNS
+ }
+ >
+ <TableHeader>{t`Object`}</TableHeader>
+ <TableHeader>{t`Relation`}</TableHeader>
+ <TableHeader />
+ </TableRow>
+ <TableBody>
+ {isDefined(error) && (
+ <StyledEmpty>{t`Could not load related records`}</StyledEmpty>
+ )}
+ {relatedRecordPaths.length === 0 &&
+ !loading &&
+ !isDefined(error) && (
+ <StyledEmpty>{t`No related records follow this object yet`}</StyledEmpty>
+ )}
+ {relatedRecordPaths.map((relatedRecordPath) => (
+ <SettingsObjectRelatedRecordPathTableRow
+ key={relatedRecordPath.id}
+ sourceObjectMetadataItem={objectMetadataItem}
+ relatedRecordPath={relatedRecordPath}
+ isReadOnly={isReadOnly}
+ />
+ ))}
+ </TableBody>
+ </Table>
+ </StyledTableContainer>
+ {!isReadOnly && (
+ <StyledButtonContainer>
+ <SettingsObjectRelatedRecordPathAddDropdown
+ sourceObjectMetadataItem={objectMetadataItem}
+ />
+ </StyledButtonContainer>
+ )}
+ </StyledContent>
+ );
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/components/__stories__/SettingsObjectRelatedRecordPathsSection.stories.tsx b/packages/twenty-front/src/modules/related-record-paths/components/__stories__/SettingsObjectRelatedRecordPathsSection.stories.tsx
new file mode 100644
index 00000000000..7f43ccea2e7
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/components/__stories__/SettingsObjectRelatedRecordPathsSection.stories.tsx
@@ -0,0 +1,187 @@
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import { HttpResponse } from 'msw';
+import { expect, fn, userEvent, waitFor, within } from 'storybook/test';
+import { isDefined } from 'twenty-shared/utils';
+import { ComponentDecorator } from 'twenty-ui/testing';
+
+import { SettingsObjectRelatedRecordPathsSection } from '@/related-record-paths/components/SettingsObjectRelatedRecordPathsSection';
+import { IconsProviderDecorator } from '~/testing/decorators/IconsProviderDecorator';
+import { ObjectMetadataItemsDecorator } from '~/testing/decorators/ObjectMetadataItemsDecorator';
+import { ToastDecorator } from '~/testing/decorators/ToastDecorator';
+import { graphqlMocks, metadataGraphql } from '~/testing/graphqlMocks';
+import { getMockObjectMetadataItemOrThrow } from '~/testing/utils/getMockObjectMetadataItemOrThrow';
+
+const company = getMockObjectMetadataItemOrThrow('company');
+const noteTarget = getMockObjectMetadataItemOrThrow('noteTarget');
+
+const getFieldMetadataIdOrThrow = ({
+ objectMetadataItem,
+ fieldName,
+}: {
+ objectMetadataItem: Pick<typeof company, 'fields'>;
+ fieldName: string;
+}) => {
+ const field = objectMetadataItem.fields.find(
+ (candidate) => candidate.name === fieldName,
+ );
+
+ if (!isDefined(field)) {
+ throw new Error(`Field ${fieldName} not found`);
+ }
+
+ return field.id;
+};
+
+const RELATED_RECORD_PATHS = [
+ {
+ __typename: 'RelatedRecordPath',
+ id: 'c6c3a4b1-0b0e-4c55-9c39-6f3f0f0c0a01',
+ objectMetadataId: company.id,
+ firstFieldMetadataId: getFieldMetadataIdOrThrow({
+ objectMetadataItem: company,
+ fieldName: 'attachments',
+ }),
+ secondFieldMetadataId: null,
+ thirdFieldMetadataId: null,
+ isInherent: true,
+ },
+ {
+ __typename: 'RelatedRecordPath',
+ id: 'c6c3a4b1-0b0e-4c55-9c39-6f3f0f0c0a02',
+ objectMetadataId: company.id,
+ firstFieldMetadataId: getFieldMetadataIdOrThrow({
+ objectMetadataItem: company,
+ fieldName: 'noteTargets',
+ }),
+ secondFieldMetadataId: getFieldMetadataIdOrThrow({
+ objectMetadataItem: noteTarget,
+ fieldName: 'note',
+ }),
+ thirdFieldMetadataId: null,
+ isInherent: false,
+ },
+];
+
+const createRelatedRecordPath = fn();
+
+const meta: Meta<typeof SettingsObjectRelatedRecordPathsSection> = {
+ title: 'Modules/RelatedRecordPaths/SettingsObjectRelatedRecordPathsSection',
+ component: SettingsObjectRelatedRecordPathsSection,
+ decorators: [
+ ComponentDecorator,
+ IconsProviderDecorator,
+ ObjectMetadataItemsDecorator,
+ ToastDecorator,
+ ],
+ args: {
+ objectMetadataItem: company,
+ isReadOnly: false,
+ },
+ parameters: {
+ msw: {
+ handlers: [
+ metadataGraphql.query('FindManyRelatedRecordPaths', () =>
+ HttpResponse.json({
+ data: { relatedRecordPaths: RELATED_RECORD_PATHS },
+ }),
+ ),
+ metadataGraphql.mutation('CreateRelatedRecordPath', ({ variables }) => {
+ createRelatedRecordPath(variables.input);
+
+ return HttpResponse.json({
+ data: {
+ createRelatedRecordPath: {
+ __typename: 'RelatedRecordPath',
+ id: 'c6c3a4b1-0b0e-4c55-9c39-6f3f0f0c0a03',
+ secondFieldMetadataId: null,
+ thirdFieldMetadataId: null,
+ ...variables.input,
+ },
+ },
+ });
+ }),
+ ...graphqlMocks.handlers,
+ ],
+ },
+ },
+};
+
+export default meta;
+
+type Story = StoryObj<typeof SettingsObjectRelatedRecordPathsSection>;
+
+export const Default: Story = {
+ play: async ({ canvasElement }) => {
+ const canvas = within(canvasElement);
+
+ expect(await canvas.findByText('Note')).toBeVisible();
+ expect(canvas.queryByText('Inherent')).not.toBeInTheDocument();
+ },
+};
+
+export const ReadOnly: Story = {
+ args: { isReadOnly: true },
+ play: async ({ canvasElement }) => {
+ const canvas = within(canvasElement);
+
+ expect(await canvas.findByText('Note')).toBeVisible();
+ expect(
+ canvas.queryByRole('button', { name: 'Add path' }),
+ ).not.toBeInTheDocument();
+ expect(
+ canvas.queryByRole('button', { name: 'Delete related record path' }),
+ ).not.toBeInTheDocument();
+ },
+};
+
+export const AddPathThroughRelations: Story = {
+ beforeEach: () => {
+ createRelatedRecordPath.mockClear();
+ },
+ play: async ({ canvasElement }) => {
+ const canvas = within(canvasElement);
+ const body = within(canvasElement.ownerDocument.body);
+
+ await userEvent.click(
+ await canvas.findByRole('button', { name: 'Add path' }),
+ );
+
+ const search = await body.findByRole('searchbox', {
+ name: 'Search relations',
+ });
+
+ await userEvent.type(search, 'Notes');
+ await userEvent.click(await body.findByRole('button', { name: /^Notes/ }));
+
+ expect(
+ await body.findByRole('button', { name: /Add this path/ }),
+ ).toBeVisible();
+
+ await userEvent.type(
+ await body.findByRole('searchbox', { name: 'Search relations' }),
+ 'Note',
+ );
+ await userEvent.click(await body.findByRole('button', { name: /^Note/ }));
+ await userEvent.click(
+ await body.findByRole('button', { name: /Add this path/ }),
+ );
+
+ await waitFor(() =>
+ expect(createRelatedRecordPath).toHaveBeenCalledTimes(1),
+ );
+ await waitFor(() =>
+ expect(createRelatedRecordPath).toHaveBeenCalledWith({
+ objectMetadataId: company.id,
+ firstFieldMetadataId: getFieldMetadataIdOrThrow({
+ objectMetadataItem: company,
+ fieldName: 'noteTargets',
+ }),
+ secondFieldMetadataId: getFieldMetadataIdOrThrow({
+ objectMetadataItem: noteTarget,
+ fieldName: 'note',
+ }),
+ isInherent: false,
+ }),
+ );
+ },
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/constants/RelatedRecordPathMaximumFieldCount.ts b/packages/twenty-front/src/modules/related-record-paths/constants/RelatedRecordPathMaximumFieldCount.ts
new file mode 100644
index 00000000000..11a76a01e3a
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/constants/RelatedRecordPathMaximumFieldCount.ts
@@ -0,0 +1 @@
+export const RELATED_RECORD_PATH_MAXIMUM_FIELD_COUNT = 3;
diff --git a/packages/twenty-front/src/modules/related-record-paths/constants/RelatedRecordPathTableGridTemplateColumns.ts b/packages/twenty-front/src/modules/related-record-paths/constants/RelatedRecordPathTableGridTemplateColumns.ts
new file mode 100644
index 00000000000..ce9a240db2c
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/constants/RelatedRecordPathTableGridTemplateColumns.ts
@@ -0,0 +1 @@
+export const RELATED_RECORD_PATH_TABLE_GRID_TEMPLATE_COLUMNS = '1fr 2fr 36px';
diff --git a/packages/twenty-front/src/modules/related-record-paths/graphql/fragments/relatedRecordPathFragment.ts b/packages/twenty-front/src/modules/related-record-paths/graphql/fragments/relatedRecordPathFragment.ts
new file mode 100644
index 00000000000..f3ac2e9a25d
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/graphql/fragments/relatedRecordPathFragment.ts
@@ -0,0 +1,12 @@
+import gql from 'graphql-tag';
+
+export const RELATED_RECORD_PATH_FRAGMENT = gql`
+ fragment RelatedRecordPathFragment on RelatedRecordPath {
+ id
+ objectMetadataId
+ firstFieldMetadataId
+ secondFieldMetadataId
+ thirdFieldMetadataId
+ isInherent
+ }
+`;
diff --git a/packages/twenty-front/src/modules/related-record-paths/graphql/mutations/createRelatedRecordPath.ts b/packages/twenty-front/src/modules/related-record-paths/graphql/mutations/createRelatedRecordPath.ts
new file mode 100644
index 00000000000..8d5103e759f
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/graphql/mutations/createRelatedRecordPath.ts
@@ -0,0 +1,12 @@
+import gql from 'graphql-tag';
+
+import { RELATED_RECORD_PATH_FRAGMENT } from '@/related-record-paths/graphql/fragments/relatedRecordPathFragment';
+
+export const CREATE_RELATED_RECORD_PATH = gql`
+ mutation CreateRelatedRecordPath($input: CreateRelatedRecordPathInput!) {
+ createRelatedRecordPath(input: $input) {
+ ...RelatedRecordPathFragment
+ }
+ }
+ ${RELATED_RECORD_PATH_FRAGMENT}
+`;
diff --git a/packages/twenty-front/src/modules/related-record-paths/graphql/mutations/deleteRelatedRecordPath.ts b/packages/twenty-front/src/modules/related-record-paths/graphql/mutations/deleteRelatedRecordPath.ts
new file mode 100644
index 00000000000..c8a3a89228f
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/graphql/mutations/deleteRelatedRecordPath.ts
@@ -0,0 +1,12 @@
+import gql from 'graphql-tag';
+
+import { RELATED_RECORD_PATH_FRAGMENT } from '@/related-record-paths/graphql/fragments/relatedRecordPathFragment';
+
+export const DELETE_RELATED_RECORD_PATH = gql`
+ mutation DeleteRelatedRecordPath($id: UUID!) {
+ deleteRelatedRecordPath(id: $id) {
+ ...RelatedRecordPathFragment
+ }
+ }
+ ${RELATED_RECORD_PATH_FRAGMENT}
+`;
diff --git a/packages/twenty-front/src/modules/related-record-paths/graphql/queries/findManyRelatedRecordPaths.ts b/packages/twenty-front/src/modules/related-record-paths/graphql/queries/findManyRelatedRecordPaths.ts
new file mode 100644
index 00000000000..65c4974eeb9
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/graphql/queries/findManyRelatedRecordPaths.ts
@@ -0,0 +1,12 @@
+import gql from 'graphql-tag';
+
+import { RELATED_RECORD_PATH_FRAGMENT } from '@/related-record-paths/graphql/fragments/relatedRecordPathFragment';
+
+export const FIND_MANY_RELATED_RECORD_PATHS = gql`
+ query FindManyRelatedRecordPaths {
+ relatedRecordPaths {
+ ...RelatedRecordPathFragment
+ }
+ }
+ ${RELATED_RECORD_PATH_FRAGMENT}
+`;
diff --git a/packages/twenty-front/src/modules/related-record-paths/hooks/useHasRelatedRecordPathsEntitlement.ts b/packages/twenty-front/src/modules/related-record-paths/hooks/useHasRelatedRecordPathsEntitlement.ts
new file mode 100644
index 00000000000..4856c39d86a
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/hooks/useHasRelatedRecordPathsEntitlement.ts
@@ -0,0 +1,13 @@
+import { currentWorkspaceState } from '@/auth/states/currentWorkspaceState';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { checkIfBillingEntitlementIsEnabledOnWorkspace } from '@/workspace/utils/checkIfBillingEntitlementIsEnabledOnWorkspace';
+import { BillingEntitlementKey } from '~/generated-metadata/graphql';
+
+export const useHasRelatedRecordPathsEntitlement = () => {
+ const currentWorkspace = useAtomStateValue(currentWorkspaceState);
+
+ return checkIfBillingEntitlementIsEnabledOnWorkspace(
+ BillingEntitlementKey.RLS,
+ currentWorkspace,
+ );
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/hooks/useRelatedRecordPathMutations.ts b/packages/twenty-front/src/modules/related-record-paths/hooks/useRelatedRecordPathMutations.ts
new file mode 100644
index 00000000000..1167bfcf913
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/hooks/useRelatedRecordPathMutations.ts
@@ -0,0 +1,75 @@
+import { CombinedGraphQLErrors } from '@apollo/client/errors';
+import { useMutation } from '@apollo/client/react';
+import { useLingui } from '@lingui/react/macro';
+import { CrudOperationType } from 'twenty-shared/types';
+import { useToast } from 'twenty-ui/components/feedback';
+
+import { useMetadataErrorHandler } from '@/metadata-error-handler/hooks/useMetadataErrorHandler';
+import {
+ type CreateRelatedRecordPathInput,
+ CreateRelatedRecordPathDocument,
+ DeleteRelatedRecordPathDocument,
+ FindManyRelatedRecordPathsDocument,
+} from '~/generated-metadata/graphql';
+
+const REFETCH_OPTIONS = {
+ refetchQueries: [{ query: FindManyRelatedRecordPathsDocument }],
+ awaitRefetchQueries: true,
+};
+
+export const useRelatedRecordPathMutations = () => {
+ const { t } = useLingui();
+ const { enqueueToast } = useToast();
+ const { handleMetadataError } = useMetadataErrorHandler();
+
+ const [createMutation, { loading: isCreating }] = useMutation(
+ CreateRelatedRecordPathDocument,
+ REFETCH_OPTIONS,
+ );
+ const [deleteMutation, { loading: isDeleting }] = useMutation(
+ DeleteRelatedRecordPathDocument,
+ REFETCH_OPTIONS,
+ );
+
+ const handleError = ({
+ error,
+ operationType,
+ }: {
+ error: unknown;
+ operationType: CrudOperationType;
+ }) => {
+ if (CombinedGraphQLErrors.is(error)) {
+ handleMetadataError(error, {
+ primaryMetadataName: 'relatedRecordPath',
+ operationType,
+ });
+ return;
+ }
+
+ enqueueToast({ status: 'error', children: t`An error occurred.` });
+ };
+
+ const createRelatedRecordPath = async (
+ input: CreateRelatedRecordPathInput,
+ ) => {
+ try {
+ await createMutation({ variables: { input } });
+ } catch (error) {
+ handleError({ error, operationType: CrudOperationType.CREATE });
+ }
+ };
+
+ const deleteRelatedRecordPath = async (id: string) => {
+ try {
+ await deleteMutation({ variables: { id } });
+ } catch (error) {
+ handleError({ error, operationType: CrudOperationType.DELETE });
+ }
+ };
+
+ return {
+ createRelatedRecordPath,
+ deleteRelatedRecordPath,
+ isSaving: isCreating || isDeleting,
+ };
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/hooks/useRelatedRecordPaths.ts b/packages/twenty-front/src/modules/related-record-paths/hooks/useRelatedRecordPaths.ts
new file mode 100644
index 00000000000..5de13b40977
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/hooks/useRelatedRecordPaths.ts
@@ -0,0 +1,34 @@
+import { useQuery } from '@apollo/client/react';
+import { useCallback } from 'react';
+
+import { useListenToMetadataOperationBrowserEvent } from '@/browser-event/hooks/useListenToMetadataOperationBrowserEvent';
+import {
+ AllMetadataName,
+ FindManyRelatedRecordPathsDocument,
+} from '~/generated-metadata/graphql';
+
+export const useRelatedRecordPaths = ({
+ objectMetadataId,
+}: {
+ objectMetadataId: string;
+}) => {
+ const { data, loading, error, refetch } = useQuery(
+ FindManyRelatedRecordPathsDocument,
+ );
+
+ const refetchOnRelatedRecordPathOperation = useCallback(() => {
+ void refetch();
+ }, [refetch]);
+
+ useListenToMetadataOperationBrowserEvent({
+ metadataName: AllMetadataName.relatedRecordPath,
+ onMetadataOperationBrowserEvent: refetchOnRelatedRecordPathOperation,
+ });
+
+ const relatedRecordPaths = (data?.relatedRecordPaths ?? []).filter(
+ (relatedRecordPath) =>
+ relatedRecordPath.objectMetadataId === objectMetadataId,
+ );
+
+ return { relatedRecordPaths, loading, error };
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/types/RelatedRecordPathStep.ts b/packages/twenty-front/src/modules/related-record-paths/types/RelatedRecordPathStep.ts
new file mode 100644
index 00000000000..f7586d8f04b
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/types/RelatedRecordPathStep.ts
@@ -0,0 +1,7 @@
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { type FieldMetadataItem } from '@/object-metadata/types/FieldMetadataItem';
+
+export type RelatedRecordPathStep = {
+ fieldMetadataItem: FieldMetadataItem;
+ targetObjectMetadataItem: EnrichedObjectMetadataItem;
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/utils/__tests__/getRelatedRecordPathNextFieldMetadataItems.test.ts b/packages/twenty-front/src/modules/related-record-paths/utils/__tests__/getRelatedRecordPathNextFieldMetadataItems.test.ts
new file mode 100644
index 00000000000..25c39538a13
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/utils/__tests__/getRelatedRecordPathNextFieldMetadataItems.test.ts
@@ -0,0 +1,42 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { getRelatedRecordPathNextFieldMetadataItems } from '@/related-record-paths/utils/getRelatedRecordPathNextFieldMetadataItems';
+import { getRelatedRecordPathSteps } from '@/related-record-paths/utils/getRelatedRecordPathSteps';
+import { getMockObjectMetadataItemOrThrow } from '~/testing/utils/getMockObjectMetadataItemOrThrow';
+import { getTestEnrichedObjectMetadataItemsMock } from '~/testing/utils/getTestEnrichedObjectMetadataItemsMock';
+
+const objectMetadataItems = getTestEnrichedObjectMetadataItemsMock();
+const company = getMockObjectMetadataItemOrThrow('company');
+const companyNoteTargetsId = company.fields.find(
+ (field) => field.name === 'noteTargets',
+)?.id;
+
+describe('getRelatedRecordPathNextFieldMetadataItems', () => {
+ it('should offer active relation fields of the source object', () => {
+ const fieldNames = getRelatedRecordPathNextFieldMetadataItems({
+ sourceObjectMetadataItem: company,
+ steps: [],
+ }).map((field) => field.name);
+
+ expect(fieldNames).toEqual(
+ expect.arrayContaining(['noteTargets', 'people', 'accountOwner']),
+ );
+ expect(fieldNames).not.toContain('name');
+ });
+
+ it('should exclude relations leading back to an object already visited', () => {
+ const steps = getRelatedRecordPathSteps({
+ sourceObjectMetadataItem: company,
+ fieldMetadataIds: [companyNoteTargetsId].filter(isDefined),
+ objectMetadataItems,
+ });
+
+ const fieldNames = getRelatedRecordPathNextFieldMetadataItems({
+ sourceObjectMetadataItem: company,
+ steps,
+ }).map((field) => field.name);
+
+ expect(fieldNames).toContain('note');
+ expect(fieldNames).not.toContain('targetCompany');
+ });
+});
diff --git a/packages/twenty-front/src/modules/related-record-paths/utils/__tests__/getRelatedRecordPathSteps.test.ts b/packages/twenty-front/src/modules/related-record-paths/utils/__tests__/getRelatedRecordPathSteps.test.ts
new file mode 100644
index 00000000000..4ecd7201472
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/utils/__tests__/getRelatedRecordPathSteps.test.ts
@@ -0,0 +1,66 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { getRelatedRecordPathSteps } from '@/related-record-paths/utils/getRelatedRecordPathSteps';
+import { getMockObjectMetadataItemOrThrow } from '~/testing/utils/getMockObjectMetadataItemOrThrow';
+import { getTestEnrichedObjectMetadataItemsMock } from '~/testing/utils/getTestEnrichedObjectMetadataItemsMock';
+
+const objectMetadataItems = getTestEnrichedObjectMetadataItemsMock();
+const company = getMockObjectMetadataItemOrThrow('company');
+const noteTarget = getMockObjectMetadataItemOrThrow('noteTarget');
+
+const getFieldOrThrow = ({
+ objectMetadataItem,
+ fieldName,
+}: {
+ objectMetadataItem: Pick<typeof company, 'fields'>;
+ fieldName: string;
+}) => {
+ const field = objectMetadataItem.fields.find(
+ (candidate) => candidate.name === fieldName,
+ );
+
+ if (!isDefined(field)) {
+ throw new Error(`Field ${fieldName} not found`);
+ }
+
+ return field;
+};
+
+const companyNoteTargets = getFieldOrThrow({
+ objectMetadataItem: company,
+ fieldName: 'noteTargets',
+});
+const noteTargetNote = getFieldOrThrow({
+ objectMetadataItem: noteTarget,
+ fieldName: 'note',
+});
+
+describe('getRelatedRecordPathSteps', () => {
+ it('should follow each field from the object reached by the previous one', () => {
+ const steps = getRelatedRecordPathSteps({
+ sourceObjectMetadataItem: company,
+ fieldMetadataIds: [companyNoteTargets.id, noteTargetNote.id],
+ objectMetadataItems,
+ });
+
+ expect(
+ steps.map(({ fieldMetadataItem, targetObjectMetadataItem }) => [
+ fieldMetadataItem.name,
+ targetObjectMetadataItem.nameSingular,
+ ]),
+ ).toEqual([
+ ['noteTargets', 'noteTarget'],
+ ['note', 'note'],
+ ]);
+ });
+
+ it('should stop at a field that does not belong to the reached object', () => {
+ const steps = getRelatedRecordPathSteps({
+ sourceObjectMetadataItem: company,
+ fieldMetadataIds: [noteTargetNote.id],
+ objectMetadataItems,
+ });
+
+ expect(steps).toEqual([]);
+ });
+});
diff --git a/packages/twenty-front/src/modules/related-record-paths/utils/findRelationTargetObjectMetadataItem.ts b/packages/twenty-front/src/modules/related-record-paths/utils/findRelationTargetObjectMetadataItem.ts
new file mode 100644
index 00000000000..d4118206cc4
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/utils/findRelationTargetObjectMetadataItem.ts
@@ -0,0 +1,15 @@
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { type FieldMetadataItem } from '@/object-metadata/types/FieldMetadataItem';
+
+export const findRelationTargetObjectMetadataItem = ({
+ fieldMetadataItem,
+ objectMetadataItems,
+}: {
+ fieldMetadataItem: Pick<FieldMetadataItem, 'relation'>;
+ objectMetadataItems: EnrichedObjectMetadataItem[];
+}): EnrichedObjectMetadataItem | undefined =>
+ objectMetadataItems.find(
+ (objectMetadataItem) =>
+ objectMetadataItem.id ===
+ fieldMetadataItem.relation?.targetObjectMetadata.id,
+ );
diff --git a/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathFieldMetadataIds.ts b/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathFieldMetadataIds.ts
new file mode 100644
index 00000000000..76918ab3f9c
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathFieldMetadataIds.ts
@@ -0,0 +1,15 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { type RelatedRecordPath } from '~/generated-metadata/graphql';
+
+export const getRelatedRecordPathFieldMetadataIds = (
+ relatedRecordPath: Pick<
+ RelatedRecordPath,
+ 'firstFieldMetadataId' | 'secondFieldMetadataId' | 'thirdFieldMetadataId'
+ >,
+): string[] =>
+ [
+ relatedRecordPath.firstFieldMetadataId,
+ relatedRecordPath.secondFieldMetadataId,
+ relatedRecordPath.thirdFieldMetadataId,
+ ].filter(isDefined);
diff --git a/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathNextFieldMetadataItems.ts b/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathNextFieldMetadataItems.ts
new file mode 100644
index 00000000000..0b26657615a
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathNextFieldMetadataItems.ts
@@ -0,0 +1,30 @@
+import { FieldMetadataType } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { type FieldMetadataItem } from '@/object-metadata/types/FieldMetadataItem';
+import { type RelatedRecordPathStep } from '@/related-record-paths/types/RelatedRecordPathStep';
+
+export const getRelatedRecordPathNextFieldMetadataItems = ({
+ sourceObjectMetadataItem,
+ steps,
+}: {
+ sourceObjectMetadataItem: Pick<EnrichedObjectMetadataItem, 'id' | 'fields'>;
+ steps: RelatedRecordPathStep[];
+}): FieldMetadataItem[] => {
+ const reachedObjectMetadataItem =
+ steps.at(-1)?.targetObjectMetadataItem ?? sourceObjectMetadataItem;
+
+ const visitedObjectMetadataIds = new Set([
+ sourceObjectMetadataItem.id,
+ ...steps.map((step) => step.targetObjectMetadataItem.id),
+ ]);
+
+ return reachedObjectMetadataItem.fields.filter(
+ (field) =>
+ field.type === FieldMetadataType.RELATION &&
+ field.isActive &&
+ isDefined(field.relation) &&
+ !visitedObjectMetadataIds.has(field.relation.targetObjectMetadata.id),
+ );
+};
diff --git a/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathSteps.ts b/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathSteps.ts
new file mode 100644
index 00000000000..f7327623789
--- /dev/null
+++ b/packages/twenty-front/src/modules/related-record-paths/utils/getRelatedRecordPathSteps.ts
@@ -0,0 +1,43 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { type RelatedRecordPathStep } from '@/related-record-paths/types/RelatedRecordPathStep';
+import { findRelationTargetObjectMetadataItem } from '@/related-record-paths/utils/findRelationTargetObjectMetadataItem';
+
+export const getRelatedRecordPathSteps = ({
+ sourceObjectMetadataItem,
+ fieldMetadataIds,
+ objectMetadataItems,
+}: {
+ sourceObjectMetadataItem: Pick<EnrichedObjectMetadataItem, 'fields'>;
+ fieldMetadataIds: string[];
+ objectMetadataItems: EnrichedObjectMetadataItem[];
+}): RelatedRecordPathStep[] => {
+ const steps: RelatedRecordPathStep[] = [];
+ let currentObjectMetadataItem: Pick<EnrichedObjectMetadataItem, 'fields'> =
+ sourceObjectMetadataItem;
+
+ for (const fieldMetadataId of fieldMetadataIds) {
+ const fieldMetadataItem = currentObjectMetadataItem.fields.find(
+ (field) => field.id === fieldMetadataId,
+ );
+
+ if (!isDefined(fieldMetadataItem)) {
+ break;
+ }
+
+ const targetObjectMetadataItem = findRelationTargetObjectMetadataItem({
+ fieldMetadataItem,
+ objectMetadataItems,
+ });
+
+ if (!isDefined(targetObjectMetadataItem)) {
+ break;
+ }
+
+ steps.push({ fieldMetadataItem, targetObjectMetadataItem });
+ currentObjectMetadataItem = targetObjectMetadataItem;
+ }
+
+ return steps;
+};
diff --git a/packages/twenty-front/src/modules/settings/data-model/object-details/components/tabs/ObjectSettings.tsx b/packages/twenty-front/src/modules/settings/data-model/object-details/components/tabs/ObjectSettings.tsx
index 1855e6fad2d..ce7cd09e8f9 100644
--- a/packages/twenty-front/src/modules/settings/data-model/object-details/components/tabs/ObjectSettings.tsx
+++ b/packages/twenty-front/src/modules/settings/data-model/object-details/components/tabs/ObjectSettings.tsx
@@ -5,12 +5,15 @@ import { useUpdateOneObjectMetadataItem } from '@/object-metadata/hooks/useUpdat
import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
import { getObjectColorWithFallback } from '@/object-metadata/utils/getObjectColorWithFallback';
import { isObjectMetadataReadOnly } from '@/object-record/read-only/utils/isObjectMetadataReadOnly';
+import { SettingsObjectRelatedRecordPathsSection } from '@/related-record-paths/components/SettingsObjectRelatedRecordPathsSection';
+import { useHasRelatedRecordPathsEntitlement } from '@/related-record-paths/hooks/useHasRelatedRecordPathsEntitlement';
import { SettingsCard } from '@/settings/components/SettingsCard';
import { SettingsEnterpriseFeatureGateCard } from '@/settings/components/SettingsEnterpriseFeatureGateCard';
import { SettingsUpdateDataModelObjectAboutForm } from '@/settings/data-model/object-details/components/SettingsUpdateDataModelObjectAboutForm';
import { SettingsObjectValidationRulesSection } from '@/settings/data-model/object-details/components/tabs/SettingsObjectValidationRulesSection';
import { SettingsDataModelObjectSettingsFormCard } from '@/settings/data-model/objects/forms/components/SettingsDataModelObjectSettingsFormCard';
import { OrganizationAdornment } from '@/settings/enterprise/components/OrganizationAdornment';
+import { useHasPermissionFlag } from '@/settings/roles/hooks/useHasPermissionFlag';
import {
type SettingsDataModelObjectAboutFormValues,
settingsDataModelObjectAboutFormSchema,
@@ -32,7 +35,10 @@ import { Section } from 'twenty-ui/components/layout';
import { IconArchive, IconBolt, IconSearch, IconTrash } from 'twenty-ui/icon';
import { Button } from 'twenty-ui/primitives/input';
import { themeCssVariables, useTheme } from 'twenty-ui/theme';
-import { FeatureFlagKey } from '~/generated-metadata/graphql';
+import {
+ FeatureFlagKey,
+ PermissionFlagType,
+} from '~/generated-metadata/graphql';
import { useNavigateSettings } from '~/hooks/useNavigateSettings';
type ObjectSettingsProps = {
@@ -103,6 +109,12 @@ export const ObjectSettings = ({
FeatureFlagKey.IS_RECORD_CREATION_FORM_ENABLED,
);
const hasValidationRulesEntitlement = useHasValidationRulesEntitlement();
+ const isRelatedRecordPathsEnabled = useIsFeatureEnabled(
+ FeatureFlagKey.IS_RELATED_RECORD_PATHS_ENABLED,
+ );
+ const hasRolesPermission = useHasPermissionFlag(PermissionFlagType.ROLES);
+ const hasRelatedRecordPathsEntitlement =
+ useHasRelatedRecordPathsEntitlement();
const handleDisable = async () => {
const result = await updateOneObjectMetadataItem({
@@ -157,6 +169,29 @@ export const ObjectSettings = ({
objectMetadataItem={objectMetadataItem}
/>
</Section.Root>
+ {isRelatedRecordPathsEnabled &&
+ hasRolesPermission &&
+ !objectMetadataItem.isRemote && (
+ <Section.Root>
+ <Section.Header
+ title={t`Related records`}
+ description={t`Records reached through these relations follow access to ${objectLabel}.`}
+ actions={
+ <OrganizationAdornment
+ tooltipContent={
+ hasRelatedRecordPathsEntitlement
+ ? undefined
+ : t`Upgrade to Organization to change related records`
+ }
+ />
+ }
+ />
+ <SettingsObjectRelatedRecordPathsSection
+ objectMetadataItem={objectMetadataItem}
+ isReadOnly={isDDLLocked || !hasRelatedRecordPathsEntitlement}
+ />
+ </Section.Root>
+ )}
{isRecordCreationFormEnabled &&
!objectMetadataItem.isRemote &&
!objectMetadataItem.isSystem && (
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
index dcb383355a1..c70d6e763fe 100644
--- 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
@@ -9,6 +9,7 @@ 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',
+ RELATED_RECORD_PATHS_NOT_ENTITLED = 'RELATED_RECORD_PATHS_NOT_ENTITLED',
}
const getRelatedRecordPathExceptionUserFriendlyMessage = (
@@ -19,6 +20,8 @@ const getRelatedRecordPathExceptionUserFriendlyMessage = (
return msg`Related record path not found.`;
case RelatedRecordPathExceptionCode.INVALID_RELATED_RECORD_PATH_INPUT:
return msg`Invalid related record path input.`;
+ case RelatedRecordPathExceptionCode.RELATED_RECORD_PATHS_NOT_ENTITLED:
+ return msg`Related record paths require the Organization plan.`;
default:
assertUnreachable(code);
}
diff --git a/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.module.ts b/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.module.ts
index 94d9c9fe78b..be3e555218b 100644
--- a/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.module.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.module.ts
@@ -3,6 +3,7 @@
import { Module } from '@nestjs/common';
import { ApplicationModule } from 'src/engine/core-modules/application/application.module';
+import { BillingModule } from 'src/engine/core-modules/billing/billing.module';
import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-flag.module';
import { WorkspaceManyOrAllFlatEntityMapsCacheModule } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module';
import { PermissionsModule } from 'src/engine/metadata-modules/permissions/permissions.module';
@@ -14,6 +15,7 @@ import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace
imports: [
WorkspaceManyOrAllFlatEntityMapsCacheModule,
ApplicationModule,
+ BillingModule,
FeatureFlagModule,
PermissionsModule,
WorkspaceMigrationModule,
diff --git a/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.service.ts b/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.service.ts
index 73b7e8b6adb..963990b7c1a 100644
--- a/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.service.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/related-record-path/related-record-path.service.ts
@@ -5,6 +5,8 @@ import { Injectable } from '@nestjs/common';
import { isDefined } from 'twenty-shared/utils';
import { ApplicationService } from 'src/engine/core-modules/application/application.service';
+import { BillingEntitlementKey } from 'src/engine/core-modules/billing/enums/billing-entitlement-key.enum';
+import { BillingSubscriptionService } from 'src/engine/core-modules/billing/services/billing-subscription.service';
import { WorkspaceManyOrAllFlatEntityMapsCacheService } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.service';
import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
import { findFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
@@ -26,8 +28,26 @@ export class RelatedRecordPathService {
private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,
private readonly workspaceManyOrAllFlatEntityMapsCacheService: WorkspaceManyOrAllFlatEntityMapsCacheService,
private readonly applicationService: ApplicationService,
+ private readonly billingSubscriptionService: BillingSubscriptionService,
) {}
+ private async assertHasRelatedRecordPathsEntitlementOrThrow(
+ workspaceId: string,
+ ): Promise<void> {
+ const hasEntitlement =
+ await this.billingSubscriptionService.getWorkspaceEntitlementValue(
+ workspaceId,
+ BillingEntitlementKey.RLS,
+ );
+
+ if (!hasEntitlement) {
+ throw new RelatedRecordPathException(
+ 'Related record paths are not included in the workspace plan',
+ RelatedRecordPathExceptionCode.RELATED_RECORD_PATHS_NOT_ENTITLED,
+ );
+ }
+ }
+
private async getFlatRelatedRecordPathMaps(workspaceId: string) {
const { flatRelatedRecordPathMaps } =
await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
@@ -110,6 +130,8 @@ export class RelatedRecordPathService {
input: CreateRelatedRecordPathInput;
workspaceId: string;
}): Promise<RelatedRecordPathDTO> {
+ await this.assertHasRelatedRecordPathsEntitlementOrThrow(workspaceId);
+
const { flatObjectMetadataMaps, flatFieldMetadataMaps } =
await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
{
@@ -158,6 +180,8 @@ export class RelatedRecordPathService {
id: string;
workspaceId: string;
}): Promise<RelatedRecordPathDTO> {
+ await this.assertHasRelatedRecordPathsEntitlementOrThrow(workspaceId);
+
const flatRelatedRecordPathMaps =
await this.getFlatRelatedRecordPathMaps(workspaceId);
diff --git a/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/related-record-path-graphql-api-exception-handler.util.ts b/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/related-record-path-graphql-api-exception-handler.util.ts
index 1774a67ee13..fd6e663a3a2 100644
--- a/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/related-record-path-graphql-api-exception-handler.util.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/related-record-path/utils/related-record-path-graphql-api-exception-handler.util.ts
@@ -3,6 +3,7 @@
import { assertUnreachable } from 'twenty-shared/utils';
import {
+ ForbiddenError,
NotFoundError,
UserInputError,
} from 'src/engine/core-modules/graphql/utils/graphql-errors.util';
@@ -18,6 +19,8 @@ export const relatedRecordPathGraphqlApiExceptionHandler = (error: Error) => {
throw new NotFoundError(error);
case RelatedRecordPathExceptionCode.INVALID_RELATED_RECORD_PATH_INPUT:
throw new UserInputError(error);
+ case RelatedRecordPathExceptionCode.RELATED_RECORD_PATHS_NOT_ENTITLED:
+ throw new ForbiddenError(error);
default: {
return assertUnreachable(error.code);
}
diff --git a/packages/twenty-server/test/integration/metadata/suites/related-record-path/failing-related-record-path-without-entitlement.integration-spec.ts b/packages/twenty-server/test/integration/metadata/suites/related-record-path/failing-related-record-path-without-entitlement.integration-spec.ts
new file mode 100644
index 00000000000..736959f6733
--- /dev/null
+++ b/packages/twenty-server/test/integration/metadata/suites/related-record-path/failing-related-record-path-without-entitlement.integration-spec.ts
@@ -0,0 +1,62 @@
+/* @license Enterprise */
+
+import { createRelatedRecordPath } from 'test/integration/metadata/suites/related-record-path/utils/create-related-record-path.util';
+import { deleteRelatedRecordPath } from 'test/integration/metadata/suites/related-record-path/utils/delete-related-record-path.util';
+import { findRelatedRecordPaths } from 'test/integration/metadata/suites/related-record-path/utils/find-related-record-paths.util';
+import { updateFeatureFlag } from 'test/integration/metadata/suites/utils/update-feature-flag.util';
+import { getAppProviderByClassName } from 'test/integration/utils/get-app-provider-by-class-name.util';
+import { FeatureFlagKey } from 'twenty-shared/types';
+
+import { type EnterprisePlanService } from 'src/engine/core-modules/enterprise/services/enterprise-plan.service';
+
+describe('Related record paths without the RLS entitlement', () => {
+ beforeAll(async () => {
+ await updateFeatureFlag({
+ featureFlag: FeatureFlagKey.IS_RELATED_RECORD_PATHS_ENABLED,
+ value: true,
+ expectToFail: false,
+ });
+
+ jest
+ .spyOn(
+ getAppProviderByClassName<EnterprisePlanService>(
+ 'EnterprisePlanService',
+ ),
+ 'isValid',
+ )
+ .mockReturnValue(false);
+ });
+
+ afterAll(async () => {
+ jest.restoreAllMocks();
+
+ await updateFeatureFlag({
+ featureFlag: FeatureFlagKey.IS_RELATED_RECORD_PATHS_ENABLED,
+ value: false,
+ expectToFail: false,
+ });
+ });
+
+ it('should list paths but reject creating and deleting them', async () => {
+ const [existingPath] = await findRelatedRecordPaths();
+
+ expect(existingPath).toBeDefined();
+
+ const createResponse = await createRelatedRecordPath({
+ objectMetadataId: existingPath.objectMetadataId,
+ firstFieldMetadataId: existingPath.firstFieldMetadataId,
+ });
+
+ expect(createResponse.body.errors?.[0]?.extensions?.code).toBe('FORBIDDEN');
+
+ const deleteResponse = await deleteRelatedRecordPath(existingPath.id);
+
+ expect(deleteResponse.body.errors?.[0]?.extensions?.code).toBe('FORBIDDEN');
+
+ const remainingPathIds = (await findRelatedRecordPaths()).map(
+ (relatedRecordPath) => relatedRecordPath.id,
+ );
+
+ expect(remainingPathIds).toContain(existingPath.id);
+ });
+});