sure/app/models/snaptrade_item/provided.rb

module SnaptradeItem::Provided
  extend ActiveSupport::Concern

  included do
    before_destroy :revoke_oauth_tokens
  end

  def snaptrade_provider
    return nil unless oauth_configured?

    Provider::Snaptrade.new(self)
  end

  # Exchange an authorization code for tokens and mark the item usable.
  def complete_oauth_exchange!(code:, redirect_uri:, code_verifier:)
    payload = Provider::Snaptrade.exchange_code(
      code: code,
      redirect_uri: redirect_uri,
      code_verifier: code_verifier
    )
    apply_oauth_tokens!(payload)
    update!(status: :good)
    payload
  end

  # Get the connection portal URL for linking brokerages
  def connection_portal_url(redirect_url:, broker: nil)
    provider = snaptrade_provider
    raise StandardError, "SnapTrade is not authorized" unless provider

    provider.get_connection_url(redirect_url: redirect_url, broker: broker)
  end

  # Fetch all brokerage connections from SnapTrade API. Returns Array<Hash>.
  def fetch_connections
    provider = snaptrade_provider
    return [] unless provider

    provider.list_connections
  rescue Provider::Snaptrade::ApiError => e
    Rails.logger.error "SnaptradeItem #{id} - Failed to list connections: #{e.message}"
    raise
  end

  private

    # Best-effort token revocation when the item is destroyed.
    def revoke_oauth_tokens
      token = oauth_refresh_token.presence || oauth_access_token
      return if token.blank?

      Provider::Snaptrade.revoke_token(token: token)
    rescue => e
      # Never block deletion on revocation failures
      Rails.logger.warn "SnapTrade: Failed to revoke tokens for item #{id}: #{e.class} - #{e.message}"
    end
end