anvil-ruby 0.1.0

data/quickstart_signature.rb

@@ -0,0 +1,220 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Anvil E-Signature Quickstart
+# Based on: https://www.useanvil.com/docs/api/e-signatures
+
+$LOAD_PATH.unshift File.expand_path('lib', __dir__)
+require 'anvil'
+require 'anvil/env_loader'
+
+# Load .env file
+Anvil::EnvLoader.load(File.expand_path('.env', __dir__))
+
+# Configure Anvil
+Anvil.configure do |config|
+  config.api_key = ENV.fetch('ANVIL_API_KEY', nil)
+  config.environment = :development
+end
+
+puts '=' * 50
+puts 'Anvil E-Signature Quickstart'
+puts '=' * 50
+puts "\nUsing API Key: #{ENV.fetch('ANVIL_API_KEY', nil)[0..10]}..."
+
+# Since the Signature class uses GraphQL, we need to test it differently
+# Let's create a test packet using the REST API directly
+
+def create_test_etch_packet
+  puts "\n📝 Creating a test e-signature packet..."
+
+  client = Anvil::Client.new
+
+  # GraphQL mutation for creating an Etch packet
+  # Note: This creates a simple test packet without files
+  mutation = <<~GRAPHQL
+    mutation CreateEtchPacket {
+      createEtchPacket(
+        name: "Test Agreement - Ruby Gem #{Time.now.to_i}",
+        isDraft: false,
+        signers: [
+          {
+            name: "Test Signer 1",
+            email: "test1@example.com",
+            signerType: "email"
+          }
+        ]
+      ) {
+        eid
+        name
+        status
+        createdAt
+        signers {
+          eid
+          name
+          email
+          status
+        }
+      }
+    }
+  GRAPHQL
+
+  begin
+    response = client.post('https://app.useanvil.com/graphql', {
+                             query: mutation
+                           })
+
+    if response.success?
+      data = response.data
+      if data[:data] && data[:data][:createEtchPacket]
+        packet = data[:data][:createEtchPacket]
+
+        puts '✅ Signature packet created successfully!'
+        puts "\n📋 Packet Details:"
+        puts "   EID: #{packet[:eid]}"
+        puts "   Name: #{packet[:name]}"
+        puts "   Status: #{packet[:status]}"
+        puts "   Created: #{packet[:createdAt]}"
+
+        if packet[:signers]
+          puts "\n👥 Signers:"
+          packet[:signers].each do |signer|
+            puts "   - #{signer[:name]} (#{signer[:email]})"
+            puts "     Status: #{signer[:status]}"
+            puts "     EID: #{signer[:eid]}"
+          end
+        end
+
+        # Get signing URL
+        generate_signing_url(packet[:eid], packet[:signers].first[:eid])
+
+        packet
+      else
+        puts '❌ No packet data returned'
+        puts "Response: #{data.inspect}"
+      end
+    else
+      puts "❌ Request failed: #{response.error_message}"
+    end
+  rescue StandardError => e
+    puts "❌ Error: #{e.message}"
+    puts e.backtrace.first(5)
+  end
+end
+
+def generate_signing_url(packet_eid, signer_eid)
+  puts "\n🔗 Generating signing URL..."
+
+  client = Anvil::Client.new
+
+  mutation = <<~GRAPHQL
+    mutation GenerateEtchSignURL {
+      generateEtchSignURL(
+        input: {
+          packetEid: "#{packet_eid}"
+          signerEid: "#{signer_eid}"
+        }
+      ) {
+        url
+      }
+    }
+  GRAPHQL
+
+  begin
+    response = client.post('https://app.useanvil.com/graphql', {
+                             query: mutation
+                           })
+
+    if response.success?
+      data = response.data
+      if data[:data] && data[:data][:generateEtchSignURL]
+        url = data[:data][:generateEtchSignURL][:url]
+        puts '✅ Signing URL generated:'
+        puts "   #{url}"
+        puts "\n📧 Send this URL to the signer to collect their signature"
+        url
+      else
+        puts '❌ No URL returned'
+      end
+    else
+      puts "❌ Failed to generate URL: #{response.error_message}"
+    end
+  rescue StandardError => e
+    puts "❌ Error: #{e.message}"
+  end
+end
+
+def list_etch_packets
+  puts "\n📑 Listing your signature packets..."
+
+  client = Anvil::Client.new
+
+  query = <<~GRAPHQL
+    query ListEtchPackets {
+      etchPackets(limit: 5) {
+        eid
+        name
+        status
+        createdAt
+        completedAt
+      }
+    }
+  GRAPHQL
+
+  begin
+    response = client.post('https://app.useanvil.com/graphql', {
+                             query: query
+                           })
+
+    if response.success?
+      data = response.data
+      if data[:data] && data[:data][:etchPackets]
+        packets = data[:data][:etchPackets]
+
+        if packets.empty?
+          puts 'No signature packets found'
+        else
+          puts "Found #{packets.length} packet(s):"
+          packets.each do |packet|
+            puts "\n   📋 #{packet[:name]}"
+            puts "      EID: #{packet[:eid]}"
+            puts "      Status: #{packet[:status]}"
+            puts "      Created: #{packet[:createdAt]}"
+            puts "      Completed: #{packet[:completedAt] || 'Not yet'}"
+          end
+        end
+      end
+    else
+      puts "❌ Failed to list packets: #{response.error_message}"
+    end
+  rescue StandardError => e
+    puts "❌ Error: #{e.message}"
+  end
+end
+
+# Main execution
+puts "\n🚀 Testing Anvil E-Signature API..."
+
+# List existing packets
+list_etch_packets
+
+# Create a new test packet
+create_test_etch_packet
+
+puts "\n#{'=' * 50}"
+puts '✅ E-Signature API test complete!'
+puts '=' * 50
+
+puts "\n📚 What just happened:"
+puts '1. Created a signature packet with the Anvil API'
+puts '2. Added a test signer'
+puts '3. Generated a signing URL'
+
+puts "\n💡 Next steps:"
+puts '1. The signer would receive the URL via email (in production)'
+puts '2. They click the link and sign the document'
+puts '3. You receive a webhook when complete'
+puts '4. You can download the signed document'
+
+puts "\n📖 Learn more:"
+puts '   https://www.useanvil.com/docs/api/e-signatures'

data/test_api_connection.rb

@@ -0,0 +1,143 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Test Anvil API connection and endpoints
+
+$LOAD_PATH.unshift File.expand_path('lib', __dir__)
+require 'anvil'
+require 'anvil/env_loader'
+require 'net/http'
+require 'uri'
+require 'json'
+
+# Load .env file
+Anvil::EnvLoader.load(File.expand_path('.env', __dir__))
+
+puts '=' * 50
+puts 'Anvil API Connection Test'
+puts '=' * 50
+
+api_key = ENV.fetch('ANVIL_API_KEY', nil)
+puts "\nUsing API Key: #{api_key[0..10]}..."
+
+# Test 1: Direct REST API call (we know this works)
+def test_rest_api(api_key)
+  puts "\n1️⃣  Testing REST API (PDF Generation)..."
+
+  uri = URI('https://app.useanvil.com/api/v1/generate-pdf')
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true
+
+  request = Net::HTTP::Post.new(uri.path)
+  request.basic_auth(api_key, '')
+  request['Content-Type'] = 'application/json'
+  request.body = {
+    type: 'markdown',
+    data: [{ content: '# Test\nThis is a test.' }]
+  }.to_json
+
+  response = http.request(request)
+
+  if response.code == '200'
+    puts '   ✅ REST API works! (PDF generated)'
+    true
+  else
+    puts "   ❌ REST API failed: #{response.code}"
+    puts "   Response: #{response.body[0..200]}"
+    false
+  end
+rescue StandardError => e
+  puts "   ❌ Error: #{e.message}"
+  false
+end
+
+# Test 2: GraphQL API
+def test_graphql_api(api_key)
+  puts "\n2️⃣  Testing GraphQL API..."
+
+  uri = URI('https://app.useanvil.com/graphql')
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true
+
+  request = Net::HTTP::Post.new(uri.path)
+  request.basic_auth(api_key, '')
+  request['Content-Type'] = 'application/json'
+
+  # Simple query to test GraphQL
+  query = {
+    query: <<~GRAPHQL
+      query {
+        currentUser {
+          eid
+          name
+        }
+      }
+    GRAPHQL
+  }.to_json
+
+  request.body = query
+
+  response = http.request(request)
+
+  if response.code == '200'
+    data = JSON.parse(response.body)
+    if data['data']
+      puts '   ✅ GraphQL API works!'
+      puts "   User: #{data['data']['currentUser']}"
+      true
+    else
+      puts '   ⚠️  GraphQL responded but no data'
+      puts "   Response: #{response.body[0..200]}"
+      false
+    end
+  else
+    puts "   ❌ GraphQL API failed: #{response.code}"
+    puts "   Response: #{response.body[0..200]}"
+    false
+  end
+rescue StandardError => e
+  puts "   ❌ Error: #{e.message}"
+  false
+end
+
+# Test 3: Using the Ruby gem client
+def test_gem_client(api_key)
+  puts "\n3️⃣  Testing Ruby Gem Client..."
+
+  Anvil.configure do |config|
+    config.api_key = api_key
+    config.environment = :development
+  end
+
+  # Test PDF generation (we know this works)
+  Anvil::PDF.generate_from_markdown('# Test Document')
+  puts '   ✅ Gem client works! (PDF generated)'
+  true
+rescue StandardError => e
+  puts "   ❌ Gem client error: #{e.message}"
+  false
+end
+
+# Run all tests
+rest_ok = test_rest_api(api_key)
+graphql_ok = test_graphql_api(api_key)
+gem_ok = test_gem_client(api_key)
+
+puts "\n#{'=' * 50}"
+puts 'Test Results:'
+puts '=' * 50
+puts "REST API:    #{rest_ok ? '✅' : '❌'}"
+puts "GraphQL API: #{graphql_ok ? '✅' : '❌'}"
+puts "Ruby Gem:    #{gem_ok ? '✅' : '❌'}"
+
+if graphql_ok
+  puts "\n✅ GraphQL is working! We can proceed with e-signatures."
+else
+  puts "\n⚠️  GraphQL is not working. E-signatures require GraphQL."
+  puts "\nPossible issues:"
+  puts '1. GraphQL might require a different authentication method'
+  puts '2. The endpoint might be different'
+  puts '3. Your account might not have GraphQL access'
+  puts "\n💡 Try the REST API e-signature endpoints instead:"
+  puts '   POST https://app.useanvil.com/api/v1/etch-packets'
+end

data/test_etch_signature.rb

@@ -0,0 +1,230 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Create an Anvil Etch E-Signature Packet
+# Using the correct GraphQL endpoint and mutation structure
+
+$LOAD_PATH.unshift File.expand_path('lib', __dir__)
+require 'anvil'
+require 'anvil/env_loader'
+require 'net/http'
+require 'uri'
+require 'json'
+
+# Load .env file
+Anvil::EnvLoader.load(File.expand_path('.env', __dir__))
+
+puts '=' * 50
+puts '🖊️  Anvil Etch E-Signature Test'
+puts '=' * 50
+
+api_key = ENV.fetch('ANVIL_API_KEY', nil)
+puts "\nUsing API Key: #{api_key[0..10]}..."
+
+# Test 1: Basic GraphQL query to verify connection
+def test_graphql_connection(api_key)
+  puts "\n1️⃣  Testing GraphQL connection..."
+
+  uri = URI('https://graphql.useanvil.com/')
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true
+
+  request = Net::HTTP::Post.new(uri.path || '/')
+  request.basic_auth(api_key, '')
+  request['Content-Type'] = 'application/json'
+
+  query = {
+    query: <<~GRAPHQL
+      query {
+        currentUser {
+          eid
+          name
+        }
+      }
+    GRAPHQL
+  }
+
+  request.body = query.to_json
+  response = http.request(request)
+
+  if response.code == '200'
+    data = JSON.parse(response.body)
+    if data['data']
+      puts '   ✅ GraphQL connection works!'
+      puts "   User: #{data['data']['currentUser']}"
+      return true
+    end
+  end
+
+  puts "   ❌ GraphQL connection failed: #{response.code}"
+  puts "   Response: #{response.body[0..200]}"
+  false
+rescue StandardError => e
+  puts "   ❌ Error: #{e.message}"
+  false
+end
+
+# Test 2: Create a simple Etch packet (without a template for now)
+def create_simple_etch_packet(api_key)
+  puts "\n2️⃣  Creating a simple Etch packet..."
+
+  uri = URI('https://graphql.useanvil.com/')
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true
+
+  request = Net::HTTP::Post.new(uri.path || '/')
+  request.basic_auth(api_key, '')
+  request['Content-Type'] = 'application/json'
+
+  # Simple mutation - create a draft packet
+  mutation = {
+    query: <<~GRAPHQL
+      mutation CreateTestPacket {
+        createEtchPacket(
+          name: "Test Signature Packet #{Time.now.to_i}"
+          isDraft: true
+          isTest: true
+          signers: [
+            {
+              id: "signer1"
+              name: "Test Signer"
+              email: "test@example.com"
+              signerType: "email"
+            }
+          ]
+        ) {
+          eid
+          name
+          status
+          createdAt
+        }
+      }
+    GRAPHQL
+  }
+
+  request.body = mutation.to_json
+  response = http.request(request)
+  result = JSON.parse(response.body)
+
+  if response.code == '200'
+    if result['data'] && result['data']['createEtchPacket']
+      packet = result['data']['createEtchPacket']
+      puts '   ✅ Etch packet created!'
+      puts "   EID: #{packet['eid']}"
+      puts "   Name: #{packet['name']}"
+      puts "   Status: #{packet['status']}"
+      return packet
+    elsif result['errors']
+      puts '   ❌ GraphQL errors:'
+      result['errors'].each do |error|
+        puts "      - #{error['message']}"
+      end
+    end
+  else
+    puts "   ❌ Request failed: #{response.code}"
+    puts "   Response: #{result}"
+  end
+
+  nil
+rescue StandardError => e
+  puts "   ❌ Error: #{e.message}"
+  nil
+end
+
+# Test 3: List existing Etch packets
+def list_etch_packets(api_key)
+  puts "\n3️⃣  Listing existing Etch packets..."
+
+  uri = URI('https://graphql.useanvil.com/')
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true
+
+  request = Net::HTTP::Post.new(uri.path || '/')
+  request.basic_auth(api_key, '')
+  request['Content-Type'] = 'application/json'
+
+  query = {
+    query: <<~GRAPHQL
+      query {
+        etchPackets(limit: 5) {
+          eid
+          name
+          status
+          createdAt
+        }
+      }
+    GRAPHQL
+  }
+
+  request.body = query.to_json
+  response = http.request(request)
+
+  if response.code == '200'
+    data = JSON.parse(response.body)
+    if data['data'] && data['data']['etchPackets']
+      packets = data['data']['etchPackets']
+      if packets.empty?
+        puts '   No Etch packets found'
+      else
+        puts "   Found #{packets.length} packet(s):"
+        packets.each do |p|
+          puts "   - #{p['name']} (#{p['status']})"
+        end
+      end
+      return true
+    end
+  end
+
+  puts '   ❌ Failed to list packets'
+  false
+rescue StandardError => e
+  puts "   ❌ Error: #{e.message}"
+  false
+end
+
+# Main execution
+puts "\n🚀 Starting Etch e-signature tests..."
+
+# Test GraphQL connection
+if test_graphql_connection(api_key)
+  # Try to list existing packets
+  list_etch_packets(api_key)
+
+  # Try to create a new packet
+  packet = create_simple_etch_packet(api_key)
+
+  if packet
+    puts "\n#{'=' * 50}"
+    puts '✅ Success!'
+    puts '=' * 50
+    puts "\nYou've successfully created an Etch signature packet!"
+    puts "\nPacket ID: #{packet['eid']}"
+    puts "Status: #{packet['status']}"
+
+    puts "\n📚 Next steps:"
+    puts '1. Add a PDF template or upload a document'
+    puts '2. Configure signature fields'
+    puts '3. Send to signers'
+    puts '4. Track signature progress'
+
+    puts "\n💡 To use with a PDF template:"
+    puts '1. Upload a PDF template at https://app.useanvil.com'
+    puts "2. Get the template's castEid"
+    puts '3. Include it in the createEtchPacket mutation:'
+    puts '   files: [{ id: "file1", castEid: "your_template_eid" }]'
+  else
+    puts "\n⚠️  Couldn't create a packet, but connection works!"
+    puts "\nThis might be because:"
+    puts '1. Your account might require a PDF file/template'
+    puts '2. Additional fields might be required'
+    puts '3. Check the Anvil dashboard for more details'
+  end
+else
+  puts "\n❌ GraphQL connection failed"
+  puts "\nPlease check:"
+  puts '1. Your API key is correct'
+  puts '2. Your account has API access enabled'
+  puts '3. The GraphQL endpoint is accessible'
+end
+
+puts "\n📖 Documentation: https://www.useanvil.com/docs/api/e-signatures"

data/test_gem.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Quick test script for the Anvil gem
+
+$LOAD_PATH.unshift File.expand_path('lib', __dir__)
+require 'anvil'
+require 'anvil/env_loader'
+
+# Load .env file
+Anvil::EnvLoader.load(File.expand_path('.env', __dir__))
+
+# Configure Anvil (will use ANVIL_API_KEY from .env file)
+Anvil.configure do |config|
+  config.api_key = ENV['ANVIL_API_KEY'] || 'YOUR_API_KEY_HERE'
+  config.environment = :development
+end
+
+puts '=' * 50
+puts 'Testing Anvil Ruby Gem'
+puts '=' * 50
+
+begin
+  # Test 1: Generate a simple PDF from Markdown
+  puts "\n📄 Generating PDF from Markdown..."
+
+  pdf = Anvil::PDF.generate_from_markdown(<<~MD
+    # Anvil Ruby Test
+
+    This is a test of the Anvil Ruby gem!
+
+    ## Features Working
+
+    - ✅ API Configuration
+    - ✅ PDF Generation
+    - ✅ Zero dependencies
+
+    Generated at: #{Time.now}
+  MD
+                                         )
+
+  filename = "test_output_#{Time.now.to_i}.pdf"
+  pdf.save_as(filename)
+
+  puts "✅ Success! PDF saved as: #{filename}"
+  puts "📏 Size: #{pdf.size_human}"
+
+  # Test 2: Generate from HTML
+  puts "\n📄 Generating PDF from HTML..."
+
+  pdf2 = Anvil::PDF.generate_from_html(
+    html: '<h1>Hello from Ruby!</h1><p>The Anvil gem is working!</p>',
+    css: 'h1 { color: #007bff; }',
+    title: 'Test PDF'
+  )
+
+  filename2 = "test_html_#{Time.now.to_i}.pdf"
+  pdf2.save_as(filename2)
+
+  puts "✅ Success! HTML PDF saved as: #{filename2}"
+  puts "📏 Size: #{pdf2.size_human}"
+
+  puts "\n🎉 All tests passed! Your Anvil Ruby gem is working!"
+rescue Anvil::AuthenticationError => e
+  puts "❌ Authentication failed: #{e.message}"
+  puts 'Please check your API key above'
+rescue Anvil::Error => e
+  puts "❌ Anvil error: #{e.message}"
+rescue StandardError => e
+  puts "❌ Error: #{e.message}"
+  puts e.backtrace.first(3)
+end