MistralTranslator

# Installation
gem 'mistral_translator'

# Configuration
MistralTranslator.configure do |config|
  config.api_key = ENV['MISTRAL_API_KEY']
end

# Basic usage
MistralTranslator.translate("Bonjour le monde", from: "fr", to: "en")
# => "Hello world"

gem 'mistral_translator'

# Environment variable (recommended)
export MISTRAL_API_KEY="your_api_key_here"

# Or in Rails config/initializers/mistral_translator.rb
MistralTranslator.configure do |config|
  config.api_key = ENV['MISTRAL_API_KEY']
  config.enable_metrics = Rails.env.production?
end

# Basic translation
result = MistralTranslator.translate("Bonjour", from: "fr", to: "en")
# => "Hello"

# With context for better accuracy
result = MistralTranslator.translate(
  "Le produit est disponible",
  from: "fr",
  to: "en",
  context: "E-commerce website"
)
# => "The product is available"

# With custom glossary
result = MistralTranslator.translate(
  "Notre API est performante",
  from: "fr",
  to: "en",
  glossary: { "API" => "API" }  # Preserve technical terms
)
# => "Our API is high-performing"

# Automatic source language detection
MistralTranslator.translate_auto("¡Hola mundo!", to: "fr")
# => "Salut le monde !"

texts = ["Bonjour", "Merci", "Au revoir"]
results = MistralTranslator.translate_batch(texts, from: "fr", to: "en")
# => {0 => "Hello", 1 => "Thank you", 2 => "Goodbye"}

long_text = "Ruby on Rails is a web framework..."

# Simple summary
summary = MistralTranslator.summarize(long_text, language: "en", max_words: 50)

# Summary with translation
summary = MistralTranslator.summarize_and_translate(
  long_text,
  from: "en",
  to: "fr",
  max_words: 100
)

# With Mobility
class Article < ApplicationRecord
  extend Mobility
  translates :title, :content, backend: :table

  def translate_to_all_languages!
    MistralTranslator::RecordTranslation.translate_mobility_record(
      self,
      [:title, :content],
      source_locale: I18n.locale
    )
  end
end

# Usage
article = Article.create!(title_fr: "Titre français", content_fr: "Contenu...")
article.translate_to_all_languages!

MistralTranslator.configure do |config|
  # Required
  config.api_key = ENV['MISTRAL_API_KEY']

  # Optional
  config.model = "mistral-small"                    # AI model to use
  config.retry_delays = [1, 2, 4, 8, 16]          # Retry delays in seconds
  config.enable_metrics = true                     # Enable performance metrics

  # Callbacks for monitoring
  config.on_translation_complete = ->(from, to, orig_len, trans_len, duration) {
    Rails.logger.info "Translation #{from}→#{to} completed in #{duration.round(2)}s"
  }

  config.on_translation_error = ->(from, to, error, attempt, timestamp) {
    Rails.logger.error "Translation failed: #{error.message} (attempt #{attempt})"
  }
end

begin
  result = MistralTranslator.translate("Hello", from: "en", to: "fr")
rescue MistralTranslator::RateLimitError
  # Rate limit hit - automatic retry with backoff
  retry
rescue MistralTranslator::AuthenticationError
  # Invalid API key
  Rails.logger.error "Check your Mistral API key"
rescue MistralTranslator::UnsupportedLanguageError => e
  # Language not supported
  Rails.logger.error "Language '#{e.language}' not supported"
rescue MistralTranslator::Error => e
  # General error handling
  Rails.logger.error "Translation failed: #{e.message}"
end

# Enable metrics
MistralTranslator.configure { |c| c.enable_metrics = true }

# View metrics
metrics = MistralTranslator.metrics
puts "Total translations: #{metrics[:total_translations]}"
puts "Average time: #{metrics[:average_translation_time]}s"
puts "Error rate: #{metrics[:error_rate]}%"