Files
sure/app/helpers/brex_items_helper.rb
ghost 95f6451b39 feat(sync): add Brex provider connections (#1752)
* feat(sync): add Brex provider schema

Adds Brex item and account tables with per-family credentials, scoped upstream account uniqueness, encrypted token storage, and sanitized provider payload columns.

* feat(sync): add Brex provider core

Adds Brex item/account models, provider client and adapter support, family connection helpers, and provider enum registration for read-only Brex cash and card data.

* feat(sync): add Brex import pipeline

Adds Brex account discovery, linked-account sync, cash/card balance processors, transaction import, sanitized metadata handling, and idempotent provider entry processing.

* feat(sync): add Brex connection flows

Adds Mercury-style Brex connection management, explicit item-scoped account selection and linking, settings provider UI, account index visibility, localized copy, and per-item cache handling.

* test(sync): cover Brex provider workflows

Adds targeted coverage for Brex provider requests, adapter config, item/account guards, importer behavior, entry processing, and Mercury-style controller flows.

* fix(sync): align Brex API edge cases

Tightens Brex account fetching against the official card-account response shape, sends transaction start filters as RFC3339 date-times, and keeps provider error bodies out of user-facing messages while expanding provider client guard coverage.

* fix(sync): harden Brex provider integration

Restrict Brex API base URLs to official hosts, tighten account-selection UI behavior, and add tests for invalid credentials, cache scoping, and provider setup edge cases.

* test(sync): avoid Brex secret-shaped fixtures

* refactor(sync): extract Brex account flows

* fix(sync): address Brex provider review feedback

* fix(sync): address Brex review follow-ups

Move remaining Brex review cleanup into focused model behavior, tighten link/setup edge cases, localize summaries, and add regression coverage from CodeRabbit feedback.

Also records the security-review pass as no-findings after diff-scoped inspection and Brakeman validation.

* refactor(sync): split Brex account flow controllers

Route Brex account selection and setup actions through small namespaced controllers while keeping existing URLs and helpers stable.

Business flow remains in BrexItem::AccountFlow; the main Brex item controller now only handles connection CRUD, provider-panel rendering, destroy, and sync.

* fix(sync): address Brex CodeRabbit review

* fix(sync): address Brex follow-up review

* fix(sync): address Brex review follow-ups

* fix(sync): address Brex sync review findings

* fix(sync): polish Brex review copy and errors

* fix(sync): register Brex provider health

* fix(sync): polish Brex bank sync presentation

* fix(sync): address Brex review follow-ups

* fix(sync): tighten Brex setup params

* test(api): stabilize usage rate-limit window

* fix(sync): polish Brex setup flow nits

* fix(sync): harden Brex setup params

* fix(sync): finalize Brex review cleanup

---------

Signed-off-by: Juan José Mata <juanjo.mata@gmail.com>
Co-authored-by: Juan José Mata <juanjo.mata@gmail.com>
2026-05-13 18:13:48 +02:00

77 lines
2.2 KiB
Ruby

# frozen_string_literal: true
module BrexItemsHelper
BrexAccountDisplay = Struct.new(
:id,
:name,
:kind,
:currency,
:status,
:blank_name,
keyword_init: true
) do
alias_method :blank_name?, :blank_name
end
def brex_account_display(account)
data = account.with_indifferent_access
kind = BrexAccount.kind_for(data)
name = BrexAccount.name_for(data)
BrexAccountDisplay.new(
id: data[:id],
name: name,
kind: kind,
currency: BrexAccount.currency_code_from_money(data[:current_balance] || data[:available_balance] || data[:account_limit]),
status: data[:status],
blank_name: name.blank?
)
end
def brex_account_metadata(display)
parts = [
t("brex_items.account_metadata.provider"),
display.currency,
translated_brex_metadata_value("kinds", display.kind),
translated_brex_metadata_value("statuses", display.status)
].compact
parts.join(t("brex_items.account_metadata.separator"))
end
def brex_item_render_locals(brex_item, sync_stats_map: nil, account_counts_map: nil, institutions_count_map: nil)
counts = (account_counts_map || {})[brex_item.id] || {}
{
brex_item: brex_item,
stats: (sync_stats_map || {})[brex_item.id] || brex_item.syncs.ordered.first&.sync_stats || {},
unlinked_count: counts[:unlinked] || brex_item.unlinked_accounts_count,
linked_count: counts[:linked] || brex_item.linked_accounts_count,
total_count: counts[:total] || brex_item.total_accounts_count,
institutions_count: (institutions_count_map || {})[brex_item.id] || brex_item.connected_institutions.size
}
end
def default_brex_depository_subtype(account_name)
normalized_name = account_name.to_s.downcase
if normalized_name.match?(/\bchecking\b|\bchequing\b|\bck\b|demand\s+deposit/)
"checking"
elsif normalized_name.match?(/\bsavings\b|\bsv\b/)
"savings"
elsif normalized_name.match?(/money\s+market|\bmm\b/)
"money_market"
else
"checking"
end
end
private
def translated_brex_metadata_value(scope, value)
key = value.to_s
return nil if key.blank?
t("brex_items.#{scope}.#{key}", default: key.titleize)
end
end