sure/app/models/brex_item/unlinking.rb

# frozen_string_literal: true

module BrexItem::Unlinking
  # Concern that encapsulates unlinking logic for a Brex item.
  extend ActiveSupport::Concern

  # Idempotently remove all connections between this Brex item and local accounts.
  # - Detaches any AccountProvider links for each BrexAccount
  # - Detaches Holdings that point at the AccountProvider links
  # Returns a per-account result payload for observability
  def unlink_all!(dry_run: false)
    results = []

    brex_accounts.find_each do |provider_account|
      result = {
        provider_account_id: provider_account.id,
        name: provider_account.name,
        provider_link_ids: []
      }
      results << result

      if dry_run
        result[:provider_link_ids] = AccountProvider.where(provider_type: "BrexAccount", provider_id: provider_account.id).ids
        next
      end

      link_ids = []

      begin
        ActiveRecord::Base.transaction do
          links = AccountProvider.where(provider_type: "BrexAccount", provider_id: provider_account.id).to_a
          link_ids = links.map(&:id)
          result[:provider_link_ids] = link_ids

          # Detach holdings for any provider links found
          if link_ids.any?
            Holding.where(account_provider_id: link_ids).update_all(account_provider_id: nil)
          end

          # Destroy all provider links
          links.each do |ap|
            ap.destroy!
          end
        end
      rescue StandardError => e
        Rails.logger.warn(
          "BrexItem Unlinker: failed to fully unlink provider account ##{provider_account.id} (links=#{link_ids.inspect}): #{e.class} - #{e.message}"
        )
        # Record error for observability; continue with other accounts
        result[:error] = e.message
      end
    end

    results
  end
end