Workspace migration v2 Metadadata runner object and field (#13377)

# Introduction
Created the runner metadata for the field and object
We should keep in mind that any runner handler will only iterate over an
atomic instance of entity ( object field index etc )
Never triggerring any side effect or whats over

In this way we will need to implement a deferred transaction, as for
when we create a relation we will inject to the first created field of
both the `relationTargetFieldMetadataId` deterministically computed
before its own creation
This would result in pg constraint brokage if not deferred

## Updates
- We decided gather create_fields under the create_object as they will
be building within the same sql query. This will ease both generation
and computation and avoid disassembling to reassemble afterwards
- Refactored FlatFieldMetadata to handle relation typing with flat
occurences
```ts
  runCreateFieldSchemaMigration = async ({
    action,
    queryRunner,
  }: WorkspaceMigrationActionRunnerArgs<CreateFieldAction>) => {
    if (isFlatFieldMetadataEntityOfType(action.flatFieldMetadata, FieldMetadataType.RELATION)) {
      action.flatFieldMetadata.flatRelationTargetObjectMetadata
    }else {
      action.flatFieldMetadata.flatRelationTargetObjectMetadata // tsc-error never
    }
    return;
  };
```

## TODO
- ~~Discuss action signature with @Weiko in order to anticipate `schema`
runner needed grain~~
- ~~Refactor the object actions to contain picked `flatObjectMetadata`~~
- Implem index service

packages/twenty-server/src/engine/metadata-modules/field-metadata/field-metadata.entity.ts

@@ -1,4 +1,4 @@
-import { FieldMetadataType, IsExactly } from 'twenty-shared/types';
+import { FieldMetadataType } from 'twenty-shared/types';
 import {
   Column,
   CreateDateColumn,
@@ -18,19 +18,11 @@ import { FieldMetadataOptions } from 'src/engine/metadata-modules/field-metadata
 import { FieldMetadataSettings } from 'src/engine/metadata-modules/field-metadata/interfaces/field-metadata-settings.interface';
 
 import { FieldStandardOverridesDTO } from 'src/engine/metadata-modules/field-metadata/dtos/field-standard-overrides.dto';
+import { AssignTypeIfIsRelationFieldMetadataType } from 'src/engine/metadata-modules/field-metadata/types/assign-type-if-is-relation-field-metadata-type.type';
 import { IndexFieldMetadataEntity } from 'src/engine/metadata-modules/index-metadata/index-field-metadata.entity';
 import { ObjectMetadataEntity } from 'src/engine/metadata-modules/object-metadata/object-metadata.entity';
 import { FieldPermissionEntity } from 'src/engine/metadata-modules/object-permission/field-permission/field-permission.entity';
 
-type IsRelationType<Ttype, T extends FieldMetadataType = FieldMetadataType> =
-  IsExactly<T, FieldMetadataType> extends true
-    ? null | Ttype // Could be improved to be | unknown
-    : T extends FieldMetadataType.RELATION
-      ? Ttype
-      : T extends FieldMetadataType.MORPH_RELATION
-        ? Ttype
-        : never;
-
 @Entity('fieldMetadata')
 @Index(
   'IDX_FIELD_METADATA_NAME_OBJMID_WORKSPACE_ID_EXCEPT_MORPH_UNIQUE',
@@ -127,7 +119,10 @@ export class FieldMetadataEntity<
   isLabelSyncedWithName: boolean;
 
   @Column({ nullable: true, type: 'uuid' })
-  relationTargetFieldMetadataId: IsRelationType<string, T>;
+  relationTargetFieldMetadataId: AssignTypeIfIsRelationFieldMetadataType<
+    string,
+    T
+  >;
 
   @OneToOne(
     () => FieldMetadataEntity,
@@ -136,10 +131,16 @@ export class FieldMetadataEntity<
     { nullable: true },
   )
   @JoinColumn({ name: 'relationTargetFieldMetadataId' })
-  relationTargetFieldMetadata: IsRelationType<Relation<FieldMetadataEntity>, T>;
+  relationTargetFieldMetadata: AssignTypeIfIsRelationFieldMetadataType<
+    Relation<FieldMetadataEntity>,
+    T
+  >;
 
   @Column({ nullable: true, type: 'uuid' })
-  relationTargetObjectMetadataId: IsRelationType<string, T>;
+  relationTargetObjectMetadataId: AssignTypeIfIsRelationFieldMetadataType<
+    string,
+    T
+  >;
 
   @ManyToOne(
     () => ObjectMetadataEntity,
@@ -148,7 +149,7 @@ export class FieldMetadataEntity<
     { onDelete: 'CASCADE', nullable: true },
   )
   @JoinColumn({ name: 'relationTargetObjectMetadataId' })
-  relationTargetObjectMetadata: IsRelationType<
+  relationTargetObjectMetadata: AssignTypeIfIsRelationFieldMetadataType<
     Relation<ObjectMetadataEntity>,
     T
   >;

packages/twenty-server/src/engine/metadata-modules/field-metadata/types/assign-type-if-is-relation-field-metadata-type.type.ts

@@ -0,0 +1,13 @@
+import { FieldMetadataType, IsExactly } from 'twenty-shared/types';
+
+export type AssignTypeIfIsRelationFieldMetadataType<
+  Ttype,
+  T extends FieldMetadataType,
+> =
+  IsExactly<T, FieldMetadataType> extends true
+    ? null | Ttype // Could be improved to be | unknown
+    : T extends FieldMetadataType.RELATION
+      ? Ttype
+      : T extends FieldMetadataType.MORPH_RELATION
+        ? Ttype
+        : never;

packages/twenty-server/src/engine/metadata-modules/object-metadata/object-metadata.service.ts

@@ -3,6 +3,7 @@ import { InjectRepository } from '@nestjs/typeorm';
 
 import { Query, QueryOptions } from '@ptc-org/nestjs-query-core';
 import { TypeOrmQueryService } from '@ptc-org/nestjs-query-typeorm';
+import { FieldMetadataType } from 'twenty-shared/types';
 import { capitalize, isDefined } from 'twenty-shared/utils';
 import {
   FindManyOptions,
@@ -11,7 +12,6 @@ import {
   QueryRunner,
   Repository,
 } from 'typeorm';
-import { FieldMetadataType } from 'twenty-shared/types';
 
 import { DataSourceService } from 'src/engine/metadata-modules/data-source/data-source.service';
 import { FieldMetadataEntity } from 'src/engine/metadata-modules/field-metadata/field-metadata.entity';
@@ -43,11 +43,11 @@ import { WorkspaceMetadataCacheService } from 'src/engine/metadata-modules/works
 import { WorkspaceMetadataVersionService } from 'src/engine/metadata-modules/workspace-metadata-version/services/workspace-metadata-version.service';
 import { WorkspacePermissionsCacheService } from 'src/engine/metadata-modules/workspace-permissions-cache/workspace-permissions-cache.service';
 import { computeObjectTargetTable } from 'src/engine/utils/compute-object-target-table.util';
+import { isFieldMetadataEntityOfType } from 'src/engine/utils/is-field-metadata-of-type.util';
 import { WorkspaceDataSourceService } from 'src/engine/workspace-datasource/workspace-datasource.service';
 import { WorkspaceMigrationRunnerService } from 'src/engine/workspace-manager/workspace-migration-runner/workspace-migration-runner.service';
 import { CUSTOM_OBJECT_STANDARD_FIELD_IDS } from 'src/engine/workspace-manager/workspace-sync-metadata/constants/standard-field-ids';
 import { isSearchableFieldType } from 'src/engine/workspace-manager/workspace-sync-metadata/utils/is-searchable-field.util';
-import { isFieldMetadataEntityOfType } from 'src/engine/utils/is-field-metadata-of-type.util';
 
 import { ObjectMetadataEntity } from './object-metadata.entity';