🏠 Overview › 🧩 Components ›🧩 Field Mapping Resolver

Field Mapping Resolver

Component Detail

Service Layer medium complexity backend
1
Dependencies
1
Dependents
2
Entities
0
Integrations

Description

Service that loads, caches, and applies per-organization field mappings from the database JSONB column when formatting export payloads. Resolves mapping chains, applies transformations, and handles missing or unmapped fields with configurable fallback strategies.

Feature: External System Integration Configuration

field-mapping-resolver

Responsibilities

  • Load field mappings from organization_integrations JSONB column
  • Apply mappings to transform internal data models to external field names
  • Handle missing mappings with fallback defaults and emit warnings

Interfaces

getMappings(integrationId: string): Promise<FieldMapping[]>
applyMappings(data: Record<string, unknown>, mappings: FieldMapping[]): Record<string, unknown>
validateMappingCoverage(mappings: FieldMapping[], requiredFields: string[]): MissingFieldReport
cacheMappings(integrationId: string, mappings: FieldMapping[]): void
invalidateCache(integrationId: string): void

Relationships

Dependencies (1)

Components this component depends on

data Organization Integration Repository

Dependents (1)

Components that depend on this component

infrastructure Integration Edge Functions

Related Data Entities (2)

Data entities managed by this component

Field Mapping 14 fields configuration Organization Integration 20 fields core