gem 'elia_ruby'

require 'elia_ruby'

# Find an MCC
code = Elia::Mcc.find("5411")
code.mcc                    # => "5411"
code.iso_description        # => "Grocery Stores, Supermarkets"
code.stripe_code            # => "grocery_stores_supermarkets"
code.irs_reportable?        # => false

# Strict lookup (raises if not found)
Elia::Mcc.find!("5411")     # => Elia::Mcc::Code
Elia::Mcc.find!("99999")    # => raises Elia::Mcc::NotFound

# Shorthand
Elia::Mcc["5411"]           # => same as find

# Get all MCCs
Elia::Mcc.all                          # => Array of all codes

# Filter by attributes
Elia::Mcc.where(irs_reportable: true)  # => IRS reportable codes

# Range queries
Elia::Mcc.in_range("5000", "5999")     # => Retail MCCs

# Search descriptions
Elia::Mcc.search("restaurant")         # => fuzzy search results

# Available categories
Elia::Mcc.categories  # => [:airlines, :gambling, :adult, :crypto, ...]

# Get codes in a category
Elia::Mcc.in_category(:gambling)       # => gambling-related MCCs
Elia::Mcc.in_category(:airlines)       # => airline MCCs only

# Check a code's categories
code = Elia::Mcc.find("7995")
code.categories                        # => [:gambling]
code.in_category?(:gambling)           # => true

# Get all ranges
Elia::Mcc.ranges  # => Array of Elia::Mcc::Range objects

# Check a code's range
code = Elia::Mcc.find("5411")
code.range.name   # => "Retail Outlets"

# Check if valid
Elia::Mcc.valid?("5411")   # => true
Elia::Mcc.valid?("99999")  # => false

class Transaction < ApplicationRecord
  validates :mcc_code, mcc: true

  # Or with category restrictions
  validates :mcc_code, mcc: {
    deny_categories: [:gambling, :adult],
    message: "category is blocked"
  }
end

# config/initializers/elia_mcc.rb
Elia::Mcc.configure do |config|
  config.default_description_source = :stripe  # or :iso, :visa, etc.
  config.include_reserved_ranges = false
end

code = Elia::Mcc.find("5411")

# Core
code.mcc                     # => "5411"

# Multi-source descriptions
code.iso_description
code.usda_description
code.stripe_description
code.stripe_code             # => programmatic identifier
code.visa_description
code.visa_clearing_name
code.mastercard_description
code.amex_description
code.alipay_description

# IRS
code.irs_description
code.irs_reportable?

# Categorization
code.range                   # => Elia::Mcc::Range
code.categories              # => Array of symbols

# Serialization
code.to_h                    # => Hash with all attributes
code.as_json                 # => JSON-ready hash