## Context
`CommonResultGettersService` selects field handlers by mapping every
returned record field to the handler registered for its metadata type.
Handlers are shared instances, and each handler already receives the
complete field metadata list. This means that when multiple fields have
the same handled type, the same handler is added and executed multiple
times.
For example, a record with two `FILES` fields previously produced this
execution list:
```text
[objectHandler, filesHandler, filesHandler]
```
Each `filesHandler` execution processes both `FILES` fields. As a
result, both file URLs were signed twice. With several fields of the
same type, this can make the work grow quadratically.
The same duplication can affect rich-text processing, including JSON
parsing, serialization, and embedded file URL signing.
## What changed
Field handler instances are collected in an insertion-ordered `Set`
before execution:
```text
[objectHandler, filesHandler]
```
Each distinct field handler now runs once per record and continues to
process every matching field.
## Why this is safe
- The object-specific handler still runs first.
- Different field-handler types keep their first-seen order.
- No field is skipped, handlers still receive the complete field
metadata list.
- Requests with zero or one field for a handled type are unchanged.
- No cache or cross-request state is introduced.
## Expected impact
This removes repeated synchronous file-token signing and repeated
rich-text transformations for records with multiple fields of the same
handled type. It also reduces event-loop blocking when large result sets
contain several file or rich-text fields.
## Tests
Added a regression test with two `FILES` fields. It verifies that both
fields are processed while `signFileByIdUrl` is called exactly once per
file, two calls instead of the previous four.
Validated with:
```bash
yarn nx jest twenty-server --runInBand --runTestsByPath src/engine/api/common/common-result-getters/__tests__/common-result-getters.service.spec.ts
```
Touched files also pass type-aware Oxlint and Oxfmt.
Weiko
5c23ddb1ac