[rameerez]

Four gaps a production app (Pro at $24/mo, $54/quarter, $108/yr) had to work around by hand.

1. Price every billing interval for real

plan :pro do
  price        month: 24, quarter: 54, year: 108
  stripe_price month: "price_pro_m", quarter: "price_pro_q", year: "price_pro_y"
end

pro.prices                      # => { month: 24, quarter: 54, year: 108 }
pro.price                       # => 24 (still the monthly amount)
pro.billing_intervals           # => [:month, :quarter, :year]
pc = pro.price_components(interval: :quarter)
pc.label                        # => "$54/qtr"   (declared, not derived)
pc.monthly_equivalent_cents     # => 1800
pc.monthly_equivalent_label     # => "$18/mo"
pro.price_id_for(:quarter)      # => "price_pro_q"
pro.cta_url(interval: :quarter) # => subscribe_path(plan: :pro, interval: :quarter)

• Intervals: :day, :week, :month, :quarter, :year, in both price and stripe_price (plus :id, which counts as monthly). String intervals (params[:interval]) are accepted everywhere; unknown ones raise (ConfigurationError in config, ArgumentError at call sites).
• price 24 stays shorthand for price month: 24, so existing configs don't change. An undeclared interval is derived from the monthly price only as a fallback; with no monthly price it is reported as not present.
• Stripe's interval: "month", interval_count: 3 reads as :quarter; week/day monthly equivalents are computed correctly (52/12, 365/12).
• to_view_model adds billing_intervals and interval_prices; pricing_plan_cta(plan, interval:) passes the interval through.
• If price is a Hash and stripe_price is declared too, both must cover the same intervals (raises at boot). Otherwise the page would show an amount Stripe doesn't charge, or offer an interval checkout can't sell.

2. Public price → plan lookup

PricingPlans.plan_for_price("price_pro_q")       # => #<PricingPlans::Plan :pro>, nil when unknown (hidden plans included)
PricingPlans.billing_interval_for("price_pro_q") # => :quarter, nil when unknown
plan.billing_interval_for("price_pro_q")         # => :quarter for this plan's own ids only

PlanResolver.plan_for_processor_plan now delegates to Registry.plan_for_price, so there is one implementation.

3. Stable plan order

PricingPlans.plans used sort_by, which is not stable, so Stripe-only plans (all ranked 10_000) and equally priced plans came back in arbitrary order. Ties now break by declaration index. test_plans_with_the_same_rank_keep_declaration_order fails on main and passes here.

4. Warn when a paid plan silently compares as $0

A Stripe-only paid plan whose price can't be resolved still compares as $0 in upgrade_from?/downgrade_from?, but it now logs one warning per plan naming it and suggesting a local price (to Rails.logger, or stderr outside Rails). Nothing else changes.

Things to note

• stripe_price Hash keys are now validated. Any key other than :id or an interval raises at boot. Before, such keys were silently ignored by monthly_price_id/yearly_price_id. This is flagged as a heads-up in the CHANGELOG.
• Labels keep cents ($29.99/mo, including Stripe-derived labels that used to round to $30/mo), and whole amounts drop .0.
• No version bump; the CHANGELOG entry is under ## [Unreleased].

Tests

• bundle exec rake test: 739 runs, 2379 assertions, 0 failures (main: 663 runs). Line coverage is 88.51% and branch coverage 70.01%, up from 87.42% and 68.74%.
• Appraisals: rails-7.1, rails-7.2 and rails-8.1 all green.
• RuboCop offenses in the touched lib files go down, from 198 to 194.

🤖 Generated with Claude Code

https://claude.ai/code/session_01GHFoaVbFsz35hTz1TQLfbe