Changelog

All notable changes to this project will be documented in this file.

[1.1.0] — 2026-06-04

Rails generator ofx_kit:eject removed in favour of ofx_kit:install
YAML-based field mappings removed: OFX::Configuration#load_mappings and auto-loading of config/initializers/ofx_mappings.yml are no longer supported. Use a Ruby initializer instead.

OFX.configure { |c| c.section.map "TAG", to: "attr" }

Before	After
`OFX::Errors::` (any subclass)*	`OFX::Error::*`
`OFX::ParseError`	`OFX::Error::Parse`
`OFX::InvalidHeaderError`	`OFX::Error::InvalidHeader`
`OFX::InvalidBodyError`	`OFX::Error::InvalidBody`
`OFX::UnsupportedVersionError`	`OFX::Error::UnsupportedVersion`
`OFX::EncodingError`	`OFX::Error::UnsupportedEncoding`
`OFX::ConfigurationError`	`OFX::Error::InvalidConfiguration`
`OFX::MultipleStatementsError`	`OFX::Error::MultipleStatements`

rescue OFX::Error continues to catch all gem exceptions.

Rails generator ofx_kit:install — creates config/initializers/ofx_kit.rb with all field mapping options and behavioral settings pre-written and commented, ready to uncomment and customize.
Mapping the same XML key twice in an OFX.configure block now raises OFX::Error::InvalidConfiguration instead of silently overwriting the first mapping.

OFX::Configuration#default_currency removed — currency is always derived from CURDEF in the OFX file
Rails generator renamed from rails generate ofx:eject to rails generate ofx_kit:eject
Error classes split into individual files under lib/ofx_kit/errors/; require paths changed accordingly

Documentation migrated from YARD (@return/@param) to RDoc (##) throughout the codebase
lib/ofx_kit/configuration.rb removed — submodules (core, section_proxy, etc.) now loaded directly

rdoc Rake task configured with README.md, CHANGELOG.md, and lib/**/*.rb as sources
README section with instructions to generate API docs locally via rake rdoc

Parse OFX 1.x (SGML) and OFX 2.x (XML) files via OFX.new(path_or_io)
OFX::BankAccount and OFX::CreditCardAccount domain objects
OFX::BankStatement and OFX::CreditCardStatement with account, balance, and transactions
OFX::TransactionCollection — Enumerable with .credits, .debits, .total_credits, .total_debits, .net
OFX::Balance with amount (Money), amount_cents, and posted_at
Configurable field mappings via OFX.configure and OFX.config
OFX.configure { |c| c.transaction.map "TAG", to: :attr } for custom/renamed fields
OFX.config.load_mappings("path/to/mappings.yml") for YAML-based configuration
OFX.config.multi_statement_warnings flag to silence aggregation warnings
Rails generator rails generate ofx:eject to copy default mappings into the app
Auto-load of config/initializers/ofx_mappings.yml in Rails projects