pub(all) suberror ApduError {
  Truncated
  BadLength
  LeTooLarge(Int)
  DataTooLarge(Int)
}

pub(all) suberror DolError {
  InvalidDol
}

pub(all) suberror TlvError {
  Truncated
  BadTag
  BadLength
  TooDeep
}

pub(all) struct AflEntry {
  sfi : Int
  first_record : Int
  last_record : Int
  oda_count : Int
}

pub(all) struct Apdu {
  cla : Int
  ins : Int
  p1 : Int
  p2 : Int
  data : Array[Int]
  le : Int?
}

pub(all) struct ApduResponse {
  data : Array[Int]
  sw : Int
}

pub(all) struct CardData {
  pan : String?
  expiry : String?
  cardholder : String?
  label : String?
}

pub(all) struct GpoInfo {
  aip : Array[Int]
  afl : Array[Int]
}

pub(all) struct SessionIssue {
  step : Int
  code : String
  severity : String
  detail : String
}

pub(all) struct SessionReport {
  verdict : String
  candidates : Array[String]
  selected_aid : String?
  aip : String?
  afl : Array[AflEntry]
  records : Array[(Int, Int)]
  issues : Array[SessionIssue]
  steps : Int
}

pub(all) struct Tlv {
  tag : Int
  constructed : Bool
  value : Array[Int]
  children : Array[Tlv]
}

pub(all) struct Track2 {
  pan : String
  expiry : String
  service_code : String
}

pub(all) struct TxReport {
  steps : Array[TxStep]
  errors : Array[String]
  pan : String?
  expiry : String?
  cardholder : String?
  label : String?
}

pub(all) struct TxStep {
  direction : String
  bytes : Array[Int]
  apdu : Apdu?
  response : ApduResponse?
  tlv : Array[Tlv]
  note : String
}

pub(all) struct TxSummary {
  commands : Int
  responses : Int
  successes : Int
  errors : Int
}

fn analyze_session(raw_report : TxReport) -> SessionReport

fn ascii_bytes(text : String) -> Array[Int]

fn ascii_of(bytes : Array[Int]) -> String

fn bcd_to_string(bytes : Array[Int]) -> String?

fn card_data_from_tlv(items : Array[Tlv]) -> CardData

fn cardholder_from_tlv(items : Array[Tlv]) -> String?

fn cdol_total_length(fields : Array[(Int, Int)]) -> Int

fn collect_tag_values(items : Array[Tlv], tag : Int) -> Array[Array[Int]]

fn collect_tags(items : Array[Tlv]) -> Array[Int]

fn command_name(apdu : Apdu) -> String

fn encode_tlv(item : Tlv) -> Array[Int]

fn encode_tlvs(items : Array[Tlv]) -> Array[Int]

fn expiry_from_tlv(items : Array[Tlv]) -> String?

fn find_path(items : Array[Tlv], path : Array[Int]) -> Tlv?

fn find_tag(items : Array[Tlv], tag : Int) -> Tlv?

fn flatten_tlvs(items : Array[Tlv]) -> Array[Tlv]

fn format_expiry(yymmdd : String) -> String

fn generate_ac(p1 : Int, cdol_data : Array[Int]) -> Apdu

fn get_data(tag : Int) -> Apdu

fn gpo(pdol_data : Array[Int]) -> Apdu

fn hex_decode(text : String) -> Array[Int]?

fn hex_encode(bytes : Array[Int]) -> String

fn hex_int(value : Int, width : Int) -> String

fn hex_nibble_char(value : Int) -> Char

fn label_from_tlv(items : Array[Tlv]) -> String?

fn luhn_valid(digits : String) -> Bool

fn mask_pan(pan : String) -> String

fn pan_from_tlv(items : Array[Tlv]) -> String?

fn parse_afl(afl : Array[Int]) -> Array[AflEntry]

fn parse_apdu(bytes : Array[Int]) -> Apdu raise ApduError

fn parse_cdol(value : Array[Int]) -> Array[(Int, Int)]

fn parse_dol(bytes : Array[Int]) -> Array[(Int, Int)] raise DolError

fn parse_gpo_response(bytes : Array[Int]) -> GpoInfo? raise TlvError

fn parse_record(bytes : Array[Int]) -> Array[Tlv]? raise TlvError

fn parse_response(bytes : Array[Int]) -> ApduResponse raise ApduError

fn parse_tlv(bytes : Array[Int]) -> Array[Tlv] raise TlvError

fn parse_track2(value : Array[Int]) -> Track2?

fn parse_transaction_log(text : String) -> TxReport

fn read_record(record : Int, sfi : Int) -> Apdu

fn render_session(report : SessionReport) -> String

fn render_transaction(report : TxReport) -> String

fn render_transaction_csv(report : TxReport) -> String

fn render_transaction_json(report : TxReport) -> String

fn resolve_apdu_procedures(raw : TxReport) -> TxReport

fn select_aid(aid : Array[Int]) -> Apdu

fn select_ppse() -> Apdu

fn service_code_text(code : String) -> String

fn status_description(sw : Int) -> String

fn summarize_transaction(report : TxReport) -> TxSummary

fn tag_name(tag : Int) -> String

fn tag_to_hex(tag : Int) -> String

fn validate_expiry(yymmdd : String) -> Array[String]

fn validate_pan(pan : String) -> Array[String]

fn validate_service_code(code : String) -> Array[String]

fn verify_pin(pin_block : Array[Int]) -> Apdu