gem "docpdf"

# Minimum for text + watermarking (one gem covers both):
gem "hexapdf"

# Or use two separate gems:
gem "prawn"       # text-to-PDF conversion + watermark stamp generation
gem "combine_pdf" # PDF watermark stamping

# For image conversion (pick one):
gem "rmagick"     # full ImageMagick bindings (handles HEIC, WebP, JPEG, PNG)
gem "mini_magick" # lighter shell wrapper (same format support)

# From a file path (format is detected automatically)
result = DocPDF.convert("document.docx")     # Word -> PDF via LibreOffice
result = DocPDF.convert("spreadsheet.xlsx")  # Excel -> PDF via LibreOffice
result = DocPDF.convert("slides.pptx")       # PowerPoint -> PDF via LibreOffice
result = DocPDF.convert("document.odt")      # OpenDocument -> PDF via LibreOffice
result = DocPDF.convert("data.csv")          # CSV -> PDF via LibreOffice
result = DocPDF.convert("page.html")         # HTML -> PDF via LibreOffice
result = DocPDF.convert("notes.txt")         # Text -> PDF via Prawn/HexaPDF
result = DocPDF.convert("scan.heic")         # Image -> PDF via RMagick/MiniMagick
result = DocPDF.convert("existing.pdf")      # PDF passthrough

# From an IO object (Rails UploadedFile, Tempfile, StringIO, etc.)
result = DocPDF.convert(params[:file])

# From raw binary data
result = DocPDF.convert(data: file_contents, mime_type: "image/png", filename: "photo.png")

# Image watermark
result = DocPDF.watermark("report.pdf",
  { image: "logo.png", opacity: 0.06, position: :center })

# Text watermark (e.g., "DRAFT" diagonally across the page)
result = DocPDF.watermark("report.pdf",
  { text: "DRAFT", opacity: 0.1, position: :center, rotation: 45 })

# Mix image and text stamps with page targeting
result = DocPDF.watermark("report.pdf",
  { text: "CONFIDENTIAL", opacity: 0.1, position: :center, font_size: 60, rotation: 45 },
  { image: "logo.png", opacity: 0.3, position: :top_right, width: 80, pages: :first })

# Chain onto a conversion
result = DocPDF.convert("document.docx")
  .watermark({ text: "DRAFT", opacity: 0.1 })

# ActionDispatch::Http::UploadedFile
result = DocPDF.convert(params[:document])

# Dragonfly
result = DocPDF.convert(record.document, filename: "output.pdf")

# Active Storage
result = DocPDF.convert(user.document)

# CarrierWave / Shrine
result = DocPDF.convert(record.file)

DocPDF.configure do |config|
  # LibreOffice binary path (default: "soffice", found via PATH)
  config.soffice_path = "/usr/bin/soffice"

  # Stamper adapter for watermarking (default: nil, auto-detects hexapdf then combine_pdf)
  config.stamper = :hexapdf  # or :combine_pdf

  # Page size (default: "LETTER")
  config.page_size = "A4"

  # Plain text file conversion defaults
  config.text_options = {
    font: "Helvetica",          # default: "Courier"
    font_size: 12,              # default: 10
    margins: [72, 72, 72, 72],  # default: [50, 50, 50, 50] (points: top, right, bottom, left)
    color: "000000",            # default: "333333" (hex)
  }

  # Text watermark defaults (per-stamp options override these)
  config.watermark_options = {
    font: "Times",       # default: "Helvetica"
    font_size: 96,       # default: 72
    color: "FF0000",     # default: "AAAAAA" (hex)
    rotation: 30,        # default: 45 (degrees counter-clockwise)
  }
end

# Custom converter for a specific MIME type
DocPDF::ConverterResolver.register(:my_converter,
  require_name: "my_gem",
  mime_types: %w[application/x-custom],
  loader: -> { require "docpdf/adapters/converters/my_converter"; MyConverter })

# Custom stamper
DocPDF::StamperResolver.register(:my_stamper,
  loader: -> { require "my_stamper"; MyStamper })

begin
  result = DocPDF.convert("file.docx")
rescue DocPDF::Error => e
  # Catch any docpdf error
end