mapper

Mar 26, 2026

Changes in this version

+ func AllBuiltinConverters() []copier.TypeConverter

+ func ApplyPlan[P any, E any](plan *MapperPlan, m *CopierMapper[P, E], presets *PresetRegistry, ...) error

+ func IsNil(v any) bool

+ func NewGenericConverterPair[A any, B any](aToB func(A) (B, error), bToA func(B) (A, error)) []copier.TypeConverter

+ func NewInt64PointerConverterPair() []copier.TypeConverter

+ func NewIntInt32ConverterPair() []copier.TypeConverter

+ func NewStringPointerConverterPair() []copier.TypeConverter

+ func NewTimeConverterPair() []copier.TypeConverter

+ func NewTimestamppbConverterPair() []copier.TypeConverter

+ func NewUUIDStringConverterPair() []copier.TypeConverter

+ func Ptr[T any](v T) *T

+ func Val[T any](p *T) T

+ type ConverterKind string

+ const ConverterEnumString

+ const ConverterInt64PTR

+ const ConverterIntInt32

+ const ConverterStringPTR

+ const ConverterTimePTR

+ const ConverterTimestampTime

+ const ConverterUUIDString

+ type CopierMapper struct

+ func NewCopierMapper[P any, E any]() *CopierMapper[P, E]

+ func (m *CopierMapper[P, E]) AppendConverter(c copier.TypeConverter) *CopierMapper[P, E]

+ func (m *CopierMapper[P, E]) AppendConverters(cs []copier.TypeConverter) *CopierMapper[P, E]

+ func (m *CopierMapper[P, E]) MustToEntity(proto *P) *E

+ func (m *CopierMapper[P, E]) MustToProto(entity *E) *P

+ func (m *CopierMapper[P, E]) ToEntity(proto *P) (*E, error)

+ func (m *CopierMapper[P, E]) ToEntityList(protos []*P) ([]*E, error)

+ func (m *CopierMapper[P, E]) ToProto(entity *E) (*P, error)

+ func (m *CopierMapper[P, E]) ToProtoList(entities []*E) ([]*P, error)

+ func (m *CopierMapper[P, E]) WithFieldMapping(mapping map[string]string) *CopierMapper[P, E]

+ func (m *CopierMapper[P, E]) WithPostToEntityHook(fn func(proto *P, entity *E) error) *CopierMapper[P, E]

+ func (m *CopierMapper[P, E]) WithPostToProtoHook(fn func(entity *E, proto *P) error) *CopierMapper[P, E]

+ type EnumConverter struct

+ func NewEnumConverter[DTO ~int32, Entity ~string](nameMap map[int32]string, valueMap map[string]int32) *EnumConverter[DTO, Entity]

+ func (c *EnumConverter[DTO, Entity]) NewConverterPair() []copier.TypeConverter

+ func (c *EnumConverter[DTO, Entity]) ToDomain(entity *Entity) *DTO

+ func (c *EnumConverter[DTO, Entity]) ToEntity(dto *DTO) *Entity

+ type HookRegistry struct

+ func NewHookRegistry() *HookRegistry

+ func (r *HookRegistry) CheckRequired(names ...string) error

+ func (r *HookRegistry) Get(name string) ([]copier.TypeConverter, bool)

+ func (r *HookRegistry) MustGet(name string) []copier.TypeConverter

+ func (r *HookRegistry) Register(name string, converters ...copier.TypeConverter)

+ type Mapper struct

+ func NewForwardMapper[A, B any](aToB func(*A) *B) *Mapper[A, B]

+ func NewMapper[A, B any](aToB func(*A) *B, bToA func(*B) *A) *Mapper[A, B]

+ func (m *Mapper[A, B]) Map(a *A) *B

+ func (m *Mapper[A, B]) MapSlice(as []*A) []*B

+ func (m *Mapper[A, B]) Reverse(b *B) *A

+ func (m *Mapper[A, B]) ReverseSlice(bs []*B) []*A

+ type MapperPlan struct

+ CustomHooks []string

+ FieldConverters map[string]ConverterKind

+ FieldMapping map[string]string

+ IgnoredFields []string

+ Presets []string

+ func (p *MapperPlan) Validate(presets *PresetRegistry, hooks *HookRegistry) error

+ type PresetRegistry struct

+ func DefaultPresets() *PresetRegistry

+ func NewPresetRegistry() *PresetRegistry

+ func (r *PresetRegistry) Collect(names ...string) ([]copier.TypeConverter, error)

+ func (r *PresetRegistry) Get(name string) ([]copier.TypeConverter, bool)

+ func (r *PresetRegistry) Register(name string, factory func() []copier.TypeConverter)

+ func (r *PresetRegistry) RegisterDefaults()

+ type TypeConverter = copier.TypeConverter