Anvil Ruby

gem 'anvil-ruby'

Anvil.configure do |config|
  config.api_key = Rails.application.credentials.anvil[:api_key]
  config.environment = Rails.env.production? ? :production : :development
end

require 'anvil'
Anvil.api_key = "your_api_key_here"

# Fill a PDF template
pdf = Anvil::PDF.fill(
  template_id: "your_template_id",
  data: {
    name: "John Doe",
    email: "john@example.com",
    date: Date.today.strftime("%B %d, %Y")
  }
)

# Save the filled PDF
pdf.save_as("contract.pdf")

# Get as base64 (for database storage)
base64_pdf = pdf.to_base64

pdf = Anvil::PDF.generate_from_html(
  html: "<h1>Invoice #123</h1><p>Amount: $100</p>",
  css: "h1 { color: blue; }",
  title: "Invoice"
)

pdf.save_as("invoice.pdf")

pdf = Anvil::PDF.generate_from_markdown(
  <<~MD
    # Report

    ## Summary
    This is a **markdown** document with:
    - Bullet points
    - *Italic text*
    - [Links](https://anvil.com)
  MD
)

pdf.save_as("report.pdf")

# Create a signature packet
packet = Anvil::Signature.create(
  name: "Employment Agreement",
  signers: [
    {
      name: "John Doe",
      email: "john@example.com",
      role: "employee"
    },
    {
      name: "Jane Smith",
      email: "jane@company.com",
      role: "manager"
    }
  ],
  files: [
    { type: :pdf, id: "template_id_here" }
  ]
)

# Get signing URL for a signer
signer = packet.signers.first
signing_url = signer.signing_url

# Check status
packet.reload!
if packet.complete?
  puts "All signatures collected!"
end

class AnvilWebhooksController < ApplicationController
  skip_before_action :verify_authenticity_token

  def create
    webhook = Anvil::Webhook.new(
      payload: request.body.read,
      token: params[:token]
    )

    if webhook.valid?
      case webhook.action
      when 'signerComplete'
        handle_signer_complete(webhook.data)
      when 'etchPacketComplete'
        handle_packet_complete(webhook.data)
      end

      head :no_content
    else
      head :unauthorized
    end
  end

  private

  def handle_signer_complete(data)
    # Process signer completion
    SignerCompleteJob.perform_later(data)
  end

  def handle_packet_complete(data)
    # All signatures collected
    PacketCompleteJob.perform_later(data)
  end
end

post '/webhooks/anvil' do
  webhook = Anvil::Webhook.new(
    payload: request.body.read,
    token: params[:token]
  )

  halt 401 unless webhook.valid?

  # Process webhook
  case webhook.action
  when 'signerComplete'
    # Handle signer completion
  end

  status 204
end

# Override API key for specific operations
pdf = Anvil::PDF.fill(
  template_id: "template_123",
  data: { name: "John" },
  api_key: current_tenant.anvil_api_key
)

# Or create a custom client
client = Anvil::Client.new(api_key: tenant.api_key)
pdf = Anvil::PDF.new(client: client).fill(...)

begin
  pdf = Anvil::PDF.fill(template_id: "123", data: {})
rescue Anvil::ValidationError => e
  # Invalid data or parameters
  puts "Validation failed: #{e.message}"
  puts "Errors: #{e.errors}"
rescue Anvil::AuthenticationError => e
  # Invalid or missing API key
  puts "Auth failed: #{e.message}"
rescue Anvil::RateLimitError => e
  # Rate limit exceeded
  puts "Rate limited. Retry after: #{e.retry_after} seconds"
rescue Anvil::NotFoundError => e
  # Resource not found
  puts "Not found: #{e.message}"
rescue Anvil::NetworkError => e
  # Network issues
  puts "Network error: #{e.message}"
rescue Anvil::Error => e
  # Generic Anvil error
  puts "Error: #{e.message}"
end

# Configure custom retry behavior
client = Anvil::Client.new
client.rate_limiter = Anvil::RateLimiter.new(
  max_retries: 5,
  base_delay: 2.0
)

Anvil.configure do |config|
  config.api_key = "your_dev_key"
  config.environment = :development  # Watermarks PDFs, verbose logging
end

Anvil.configure do |config|
  # Required
  config.api_key = "your_api_key"

  # Optional
  config.environment = :production  # :development or :production
  config.base_url = "https://app.useanvil.com/api/v1"  # API endpoint
  config.timeout = 120  # Read timeout in seconds
  config.open_timeout = 30  # Connection timeout
  config.webhook_token = "your_webhook_token"  # For webhook verification
end