Refactor flat entity maps to be universal oriented (#17665)

# Introduction
In preparation of the workspace agnostic builder, we're migrating
`FlatEntityMaps` to be universal identifier oriented and based
As in the builder context there're won't be any ids at all
Please also note that the FlatEntity is a UniversalFlatEntity superset

From
```ts
import { type SyncableFlatEntity } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-from.type';

export type FlatEntityMaps<T extends SyncableFlatEntity> = {
  byId: Partial<Record<string, T>>;
  idByUniversalIdentifier: Partial<Record<string, string>>;
  universalIdentifiersByApplicationId: Partial<Record<string, string[]>>;
};
```

To
```ts
export type FlatEntityMaps<
  T extends SyncableFlatEntity | UniversalSyncableFlatEntity,
> = {
  byUniversalIdentifier: Partial<Record<string, T>>;
  universalIdentifierById: Partial<Record<string, string>>;
  universalIdentifiersByApplicationId: Partial<Record<string, string[]>>; // this might make more sense to be migrated to universalIdentifiersByApplicationUniversalIdentifier but it's the main topic of this PR
};
```

## Low level maps tools
Had to refactor find | create | delete | replace | find-many | get-sub
tools ( through mutations and or throw equivalent )
This commit is contained in:
Paul Rastoin
2026-02-03 17:16:02 +01:00
committed by GitHub
parent 43042d55b2
commit 476bdf764c
202 changed files with 1853 additions and 909 deletions
@@ -33,16 +33,19 @@ describe('ViewToolsFactory', () => {
};
const mockFlatObjectMetadataMaps = {
byId: {
[mockObjectMetadataId]: {
byUniversalIdentifier: {
'object-universal-id': {
id: mockObjectMetadataId,
nameSingular: mockObjectNameSingular,
namePlural: 'companies',
labelSingular: 'Company',
labelPlural: 'Companies',
universalIdentifier: 'object-universal-id',
},
},
idByUniversalIdentifier: {},
universalIdentifierById: {
[mockObjectMetadataId]: 'object-universal-id',
},
universalIdentifiersByApplicationId: {},
};
@@ -88,9 +88,9 @@ export class ViewToolsFactory {
},
);
const objectMetadata = Object.values(flatObjectMetadataMaps.byId).find(
(obj) => obj?.nameSingular === objectNameSingular,
);
const objectMetadata = Object.values(
flatObjectMetadataMaps.byUniversalIdentifier,
).find((obj) => obj?.nameSingular === objectNameSingular);
if (!objectMetadata) {
throw new Error(