emv

type AFL struct {
	Entries      []AFLEntry   `json:"entries"`
	ReadRecords  []ReadRecord `json:"read_records"`
	TotalRecords int          `json:"total_records"`
}

type AFLEntry struct {
	SFI         int   `json:"sfi"`
	FirstRecord int   `json:"first_record"`
	LastRecord  int   `json:"last_record"`
	ODARecords  int   `json:"oda_records"`
	Records     []int `json:"records"`
}

type CVMList struct {
	AmountX uint32    `json:"amount_x"`
	AmountY uint32    `json:"amount_y"`
	Rules   []CVMRule `json:"rules"`
	Notes   []string  `json:"notes,omitempty"`
}

type CVMRule struct {
	Raw                     string `json:"raw"` // the 2 bytes, hex
	MethodByte              string `json:"method_byte"`
	MethodCode              int    `json:"method_code"` // low 6 bits
	Method                  string `json:"method"`
	ApplyNextIfUnsuccessful bool   `json:"apply_next_if_unsuccessful"` // bit 7 (0x40): else fail CVM
	ConditionByte           string `json:"condition_byte"`
	Condition               string `json:"condition"`
}

type DOL struct {
	Entries     []DOLEntry `json:"entries"`
	Count       int        `json:"count"`
	TotalLength int        `json:"total_length"`
}

type DOLEntry struct {
	Tag    uint32 `json:"tag"`
	TagHex string `json:"tag_hex"`
	Name   string `json:"name,omitempty"`
	Length int    `json:"length"`
}

type Magstripe struct {
	Track1 *Track1  `json:"track1,omitempty"`
	Track2 *Track2  `json:"track2,omitempty"`
	Notes  []string `json:"notes,omitempty"`
}

type ReadRecord struct {
	SFI    int `json:"sfi"`
	Record int `json:"record"`
}

type TLV struct {
	// Tag is the BER tag as a uint32 — the encoded big-endian bytes
	// of the tag identifier. Single-byte tags use the low byte;
	// multi-byte tags pack into successively higher bytes (so 0x9F02
	// is the most common Amount Authorised tag, 0x5F2A is the
	// Transaction Currency Code, etc.). Stored as uint32 so the
	// tag-name lookup map can key on it without a string conversion.
	Tag uint32 `json:"tag"`
	// TagHex is the operator-facing rendering of Tag — always
	// uppercase, no 0x prefix, no leading zeros. Matches the format
	// every EMV book / forum post uses ("9F02", "5F2A").
	TagHex string `json:"tag_hex"`
	// Name is the canonical EMV name for the tag, or "" when the
	// tag isn't in the curated lookup table.
	Name string `json:"name,omitempty"`
	// Constructed reports whether the value bytes contain nested
	// TLVs (per BER class+P/C bit). When true, Children holds the
	// parsed sub-tree and Value is the raw bytes (kept for callers
	// that want to re-emit the original structure).
	Constructed bool   `json:"constructed"`
	Value       []byte `json:"value,omitempty"`
	// ValueHex is the operator-facing hex rendering of Value.
	// Convenient for JSON output without forcing every caller to
	// re-encode.
	ValueHex string `json:"value_hex,omitempty"`
	// Children is non-nil iff Constructed is true. May be empty
	// when a constructed tag's body is zero-length (legal per the
	// spec, occasionally seen in templated responses).
	Children []TLV `json:"children,omitempty"`
}

type Track1 struct {
	FormatCode         string   `json:"format_code"` // 'B' = financial/bank
	PAN                string   `json:"pan"`
	PANMasked          string   `json:"pan_masked"`
	Name               string   `json:"name,omitempty"`
	Surname            string   `json:"surname,omitempty"`
	GivenName          string   `json:"given_name,omitempty"`
	Expiry             string   `json:"expiry,omitempty"`       // raw YYMM
	ExpiryFormatted    string   `json:"expiry_mm_yy,omitempty"` // MM/YY
	ServiceCode        string   `json:"service_code,omitempty"`
	ServiceCodeMeaning string   `json:"service_code_meaning,omitempty"`
	Discretionary      string   `json:"discretionary_data,omitempty"`
	LuhnValid          bool     `json:"luhn_valid"`
	LRC                string   `json:"lrc,omitempty"` // trailing redundancy char, surfaced raw (not validated)
	Notes              []string `json:"notes,omitempty"`
}

type Track2 struct {
	PAN                string   `json:"pan"`
	PANMasked          string   `json:"pan_masked"`
	Expiry             string   `json:"expiry"`       // raw YYMM as encoded
	ExpiryFormatted    string   `json:"expiry_mm_yy"` // MM/YY
	ServiceCode        string   `json:"service_code"` // 3 digits
	ServiceCodeMeaning string   `json:"service_code_meaning,omitempty"`
	Discretionary      string   `json:"discretionary_data,omitempty"`
	LuhnValid          bool     `json:"luhn_valid"`
	Notes              []string `json:"notes,omitempty"`
}