boldsign 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0a4d128418d45a484979b044ce83a9e868ef1a142145962ec0580b0f34f4e20
-  data.tar.gz: 4ee136cc02d3020b4beb1e70d614929de07f0f64e7965d8e0742a3e74cb0b893
+  metadata.gz: 32abdfa0ebbbb1803c298cc8055169d7330f7cc43a62b15838f9ae39594c146e
+  data.tar.gz: 4dd1f27abb3fb5209d5fe9a570db74336b6babc7300692f82cfa992544700263
 SHA512:
-  metadata.gz: 486cb527ac17cef2ddcf9505a5a2bfe59b3736ee75d9e9b8778344c16a8b6c0e5795d17f5fa7d739fb87f6dc70e1e353fea13929e4303ab8abf1c08adf66e792
-  data.tar.gz: 79edff344004bd59f868a44b6812c1c16bfa922823d0a16eaf28be54f970714b75c16d19be411e6ea175d37b4de8e7ab7bcc30b75da592ade64c49a7afbd9a12
+  metadata.gz: a92371ad102e288e429f7bcb3d2d535d64572dcf1208de7459bfe41dde8f3b52b72eb895af05fd0ee9dfe3dad9f38bae86bd3d678ebf03ac13c986df0b6312c0
+  data.tar.gz: 4fc0bf95e332d59d2a170225bf6d75173951d03594b2017fddc82d28cec38bccbe308bc826a5894fe5cb426b0880b5c2f1d962b195569852b68dacee90021816

data/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] — 2026-05-22
+
+### Added
+- `Boldsign::Resources::Document#send_document` now supports multipart file
+  uploads via a `files:` keyword. Pass an array of `{io:, filename:,
+  content_type:}` hashes (or `Faraday::Multipart::FilePart` instances) to
+  send PDFs (or other supported file types) for signature. When `files:` is
+  omitted the request is sent as JSON, preserving the prior behavior.
+
 ## [0.1.0] — 2026-05-22
 
 ### Added

data/lib/boldsign/resources/document.rb

@@ -4,11 +4,17 @@ module Boldsign
     # sending, listing, downloading, editing, reminding, authenticating, tagging,
     # and embedded signing flows.
     #
-    # @example Send a document
+    # @example Send a document (JSON body)
+    #   client.documents.send_document(
+    #     title: "NDA",
+    #     signers: [{ name: "Jane", emailAddress: "jane@example.com", signerOrder: 1 }]
+    #   )
+    #
+    # @example Send a document with file uploads (multipart)
     #   client.documents.send_document(
     #     title: "NDA",
     #     signers: [{ name: "Jane", emailAddress: "jane@example.com", signerOrder: 1 }],
-    #     files: [...]
+    #     files: [{ io: StringIO.new(pdf_bytes), filename: "nda.pdf", content_type: "application/pdf" }]
     #   )
     #
     # @see https://developers.boldsign.com/documents
@@ -18,7 +24,25 @@ module Boldsign
       def behalf_list(**params); @client.get("/v1/document/behalfList", params); end
       def properties(document_id); @client.get("/v1/document/properties", documentId: document_id); end
 
-      def send_document(body);  @client.post("/v1/document/send", body: body); end
+      # Send a document for signature.
+      #
+      # Pass `files:` to upload one or more PDFs (or other supported file types)
+      # via multipart/form-data. Without `files:`, the request is sent as JSON
+      # and BoldSign must already know the file content (e.g. via Base64 in the
+      # body or by referencing an existing template).
+      #
+      # @param files [Array<Hash>, nil] When present, each hash must include
+      #   `:io` and `:filename` and may include `:content_type`. The request
+      #   switches to multipart/form-data and remaining kwargs are serialized
+      #   to multipart string parts (non-scalar values become JSON strings).
+      # @param body [Hash] Top-level BoldSign send-document fields
+      #   (`title:`, `signers:`, `disableEmails:`, `metadata:`, etc.).
+      def send_document(files: nil, **body)
+        return @client.post("/v1/document/send", body: body) if files.nil?
+
+        @client.post("/v1/document/send", body: multipart_send_body(body, files), multipart: true)
+      end
+
       def draft_send(body);     @client.post("/v1/document/draftSend", body: body); end
       def edit(document_id, body); @client.put("/v1/document/edit", body: body, params: { documentId: document_id }); end
       def cancel_editing(document_id); @client.post("/v1/document/cancelEditing", params: { documentId: document_id }); end
@@ -46,6 +70,35 @@ module Boldsign
       def add_authentication(document_id, body);    @client.patch("/v1/document/addAuthentication", body: body, params: { documentId: document_id }); end
 
       def prefill_fields(document_id, body); @client.patch("/v1/document/prefillFields", body: body, params: { documentId: document_id }); end
+
+      private
+
+      def multipart_send_body(body, files)
+        parts = body.each_with_object({}) do |(key, value), acc|
+          next if value.nil?
+
+          acc[key.to_s] = scalar?(value) ? value.to_s : JSON.generate(value)
+        end
+        parts["Files"] = Array(files).map { |f| file_part(f) }
+        parts
+      end
+
+      def file_part(file)
+        return file if file.is_a?(Faraday::Multipart::FilePart)
+
+        unless file.is_a?(Hash)
+          raise ArgumentError, "files entries must be Hash with :io and :filename, or Faraday::Multipart::FilePart"
+        end
+
+        io       = file[:io] || file["io"] or raise ArgumentError, "file part missing :io"
+        filename = file[:filename] || file["filename"] or raise ArgumentError, "file part missing :filename"
+        type     = file[:content_type] || file["content_type"] || "application/octet-stream"
+        Faraday::Multipart::FilePart.new(io, type, filename)
+      end
+
+      def scalar?(value)
+        value.is_a?(String) || value.is_a?(Numeric) || value == true || value == false
+      end
     end
   end
 end

data/lib/boldsign/version.rb

@@ -1,3 +1,3 @@
 module Boldsign
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: boldsign
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - James Klein