instructingFI.go

// Copyright 2020 The Moov Authors
// Use of this source code is governed by an Apache License
// license that can be found in the LICENSE file.

package wire

import (
	"encoding/json"
	"strings"
	"unicode/utf8"
)

// InstructingFI is the instructing financial institution
type InstructingFI struct {
	// tag
	tag string
	// Financial Institution
	FinancialInstitution FinancialInstitution `json:"financialInstitution,omitempty"`

	// converters is composed for WIRE to GoLang Converters
	converters
}

// NewInstructingFI returns a new InstructingFI
func NewInstructingFI() *InstructingFI {
	ifi := &InstructingFI{
		tag: TagInstructingFI,
	}

	return ifi
}

// Parse takes the input string and parses the InstructingFI values
//
// Parse provides no guarantee about all fields being filled in. Callers should make a Validate() call to confirm
// successful parsing and data validity.
func (ifi *InstructingFI) Parse(record string) error {
	if utf8.RuneCountInString(record) < 7 {
		return NewTagMinLengthErr(7, len(record))
	}

	ifi.tag = record[:6]
	ifi.FinancialInstitution.IdentificationCode = ifi.parseStringField(record[6:7])
	length := 7

	value, read, err := ifi.parseVariableStringField(record[length:], 34)
	if err != nil {
		return fieldError("Identifier", err)
	}
	ifi.FinancialInstitution.Identifier = value
	length += read

	value, read, err = ifi.parseVariableStringField(record[length:], 35)
	if err != nil {
		return fieldError("Name", err)
	}
	ifi.FinancialInstitution.Name = value
	length += read

	value, read, err = ifi.parseVariableStringField(record[length:], 35)
	if err != nil {
		return fieldError("AddressLineOne", err)
	}
	ifi.FinancialInstitution.Address.AddressLineOne = value
	length += read

	value, read, err = ifi.parseVariableStringField(record[length:], 35)
	if err != nil {
		return fieldError("AddressLineTwo", err)
	}
	ifi.FinancialInstitution.Address.AddressLineTwo = value
	length += read

	value, read, err = ifi.parseVariableStringField(record[length:], 35)
	if err != nil {
		return fieldError("AddressLineThree", err)
	}
	ifi.FinancialInstitution.Address.AddressLineThree = value
	length += read

	if err := ifi.verifyDataWithReadLength(record, length); err != nil {
		return NewTagMaxLengthErr(err)
	}

	return nil
}

func (ifi *InstructingFI) UnmarshalJSON(data []byte) error {
	type Alias InstructingFI
	aux := struct {
		*Alias
	}{
		(*Alias)(ifi),
	}
	if err := json.Unmarshal(data, &aux); err != nil {
		return err
	}
	ifi.tag = TagInstructingFI
	return nil
}

// String returns a fixed-width InstructingFI record
func (ifi *InstructingFI) String() string {
	return ifi.Format(FormatOptions{
		VariableLengthFields: false,
	})
}

// Format returns a InstructingFI record formatted according to the FormatOptions
func (ifi *InstructingFI) Format(options FormatOptions) string {
	var buf strings.Builder
	buf.Grow(181)

	buf.WriteString(ifi.tag)
	buf.WriteString(ifi.IdentificationCodeField())
	buf.WriteString(ifi.FormatIdentifier(options) + Delimiter)
	buf.WriteString(ifi.FormatName(options) + Delimiter)
	buf.WriteString(ifi.FormatAddressLineOne(options) + Delimiter)
	buf.WriteString(ifi.FormatAddressLineTwo(options) + Delimiter)
	buf.WriteString(ifi.FormatAddressLineThree(options) + Delimiter)

	if options.VariableLengthFields {
		return ifi.stripDelimiters(buf.String())
	} else {
		return buf.String()
	}
}

// Validate performs WIRE format rule checks on InstructingFI and returns an error if not Validated
// The first error encountered is returned and stops that parsing.
// If ID Code is present, Identifier is mandatory and vice versa.
func (ifi *InstructingFI) Validate() error {
	if ifi.tag != TagInstructingFI {
		return fieldError("tag", ErrValidTagForType, ifi.tag)
	}

	if err := ifi.FinancialInstitution.Validate(); err != nil {
		return err
	}

	return nil
}

// IdentificationCodeField gets a string of the IdentificationCode field
func (ifi *InstructingFI) IdentificationCodeField() string {
	return ifi.alphaField(ifi.FinancialInstitution.IdentificationCode, 1)
}

// IdentifierField gets a string of the Identifier field
func (ifi *InstructingFI) IdentifierField() string {
	return ifi.alphaField(ifi.FinancialInstitution.Identifier, 34)
}

// NameField gets a string of the Name field
func (ifi *InstructingFI) NameField() string {
	return ifi.alphaField(ifi.FinancialInstitution.Name, 35)
}

// AddressLineOneField gets a string of AddressLineOne field
func (ifi *InstructingFI) AddressLineOneField() string {
	return ifi.alphaField(ifi.FinancialInstitution.Address.AddressLineOne, 35)
}

// AddressLineTwoField gets a string of AddressLineTwo field
func (ifi *InstructingFI) AddressLineTwoField() string {
	return ifi.alphaField(ifi.FinancialInstitution.Address.AddressLineTwo, 35)
}

// AddressLineThreeField gets a string of AddressLineThree field
func (ifi *InstructingFI) AddressLineThreeField() string {
	return ifi.alphaField(ifi.FinancialInstitution.Address.AddressLineThree, 35)
}

// FormatIdentifier returns Advice.LineOne formatted according to the FormatOptions
func (ifi *InstructingFI) FormatIdentifier(options FormatOptions) string {
	return ifi.formatAlphaField(ifi.FinancialInstitution.Identifier, 34, options)
}

// FormatName returns Advice.LineOne formatted according to the FormatOptions
func (ifi *InstructingFI) FormatName(options FormatOptions) string {
	return ifi.formatAlphaField(ifi.FinancialInstitution.Name, 35, options)
}

// FormatAddressLineOne returns Advice.LineOne formatted according to the FormatOptions
func (ifi *InstructingFI) FormatAddressLineOne(options FormatOptions) string {
	return ifi.formatAlphaField(ifi.FinancialInstitution.Address.AddressLineOne, 35, options)
}

// FormatAddressLineTwo returns Advice.LineOne formatted according to the FormatOptions
func (ifi *InstructingFI) FormatAddressLineTwo(options FormatOptions) string {
	return ifi.formatAlphaField(ifi.FinancialInstitution.Address.AddressLineTwo, 35, options)
}

// FormatAddressLineThree returns Advice.LineOne formatted according to the FormatOptions
func (ifi *InstructingFI) FormatAddressLineThree(options FormatOptions) string {
	return ifi.formatAlphaField(ifi.FinancialInstitution.Address.AddressLineThree, 35, options)
}