boldsign 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fc744443078d2ffab4156204b7921ef617c3788d373253956a0fe9f3455a14a
-  data.tar.gz: 133c334403bb3a2655f61ab7c14f8d9d75c9e3adf5212f9bdf7e69811a2cda2a
+  metadata.gz: 1f5158801c4b85358c9f7b45376a2767bb98c3374e994b2cb643840245ce641f
+  data.tar.gz: d4748c0000aabf9012b0d0403ca54d147a5bf190674cf80c96079302fa97dd95
 SHA512:
-  metadata.gz: 96e5622f76bf23b2df6be9663542fb0db5da070f40480e6649960da33d336c14afcafc36c308b5dad867fa4ce90ab3faf574c3c956011c330c7599713cf3afe2
-  data.tar.gz: 640539d3b260f4b50de92bddca66ed45a794c0c54c722d32d807134eee505d06f737542d077403ab71f5699f23e106567d1bf19dfb4954420398904e9cd756e2
+  metadata.gz: 7b8e468b7897ee9a34c9bed4256cd2fd305a58e43af9ab07c889de9ad5c024d8da6e7b01b4bc1d3ca572e5b785b786ebc9544b4559797b7e95d96cc01cb493ea
+  data.tar.gz: 29670ea3951d2adade1a687d6786510409e48707d27844dedc07b2659637b3ea7c5089672ea1f9d550e7fced26d89fcd2f98c4bea29ae324430e83652d807550

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] — 2026-07-27
+
+### Added
+- Multi-signer support for multipart `send_document` (file uploads). Array-valued
+  body fields (e.g. `signers: [...]`) now emit one JSON-object part per element,
+  all under the same field name (`Signers`, `Signers`, …) via
+  `Faraday::Multipart::Middleware`'s `flat_encode: true` — confirmed against
+  BoldSign's docs as the correct encoding for a multi-recipient envelope sent
+  alongside an uploaded file (as opposed to a template reference). Previously
+  this raised `NotImplementedError`. Multi-file uploads are still unsupported
+  and still raise.
+
 ## [0.5.0] — 2026-06-02
 
 ### Added
@@ -90,6 +102,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 100% line and branch test coverage enforced via SimpleCov.
 - GitHub Actions CI on Ruby 3.4 and 4.0.
 
-[Unreleased]: https://github.com/kleinjm/boldsign-ruby/compare/v0.5.0...HEAD
-[0.5.0]: https://github.com/kleinjm/boldsign-ruby/compare/v0.4.0...v0.5.0
-[0.1.0]: https://github.com/kleinjm/boldsign-ruby/releases/tag/v0.1.0
+[Unreleased]: https://github.com/EscrowSafe/boldsign-ruby/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/EscrowSafe/boldsign-ruby/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/EscrowSafe/boldsign-ruby/compare/v0.4.0...v0.5.0
+[0.1.0]: https://github.com/EscrowSafe/boldsign-ruby/releases/tag/v0.1.0

data/README.md

@@ -1,7 +1,7 @@
 # boldsign-ruby
 
-[![CI](https://github.com/kleinjm/boldsign-ruby/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/kleinjm/boldsign-ruby/actions/workflows/ci.yml)
-[![API docs](https://img.shields.io/badge/docs-rubydoc.info-blue.svg)](https://rubydoc.info/github/kleinjm/boldsign-ruby/main)
+[![CI](https://github.com/EscrowSafe/boldsign-ruby/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/EscrowSafe/boldsign-ruby/actions/workflows/ci.yml)
+[![API docs](https://img.shields.io/badge/docs-rubydoc.info-blue.svg)](https://rubydoc.info/github/EscrowSafe/boldsign-ruby/main)
 
 A Ruby client for the [BoldSign](https://developers.boldsign.com/) e-signature API.
 
@@ -138,7 +138,7 @@ HTTP errors raise a typed subclass of `Boldsign::Error`:
 ## Documentation
 
 Full YARD API documentation is auto-built and hosted at
-[rubydoc.info/github/kleinjm/boldsign-ruby/main](https://rubydoc.info/github/kleinjm/boldsign-ruby/main).
+[rubydoc.info/github/EscrowSafe/boldsign-ruby/main](https://rubydoc.info/github/EscrowSafe/boldsign-ruby/main).
 
 To generate locally:
 

data/boldsign.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.summary     = "Ruby client for the BoldSign e-signature API"
   spec.description = "A Ruby wrapper for the BoldSign REST API (documents, templates, " \
                      "contacts, teams, brands, webhooks, and more)."
-  spec.homepage    = "https://github.com/kleinjm/boldsign-ruby"
+  spec.homepage    = "https://github.com/EscrowSafe/boldsign-ruby"
   spec.license     = "MIT"
   spec.required_ruby_version = ">= 3.0"
 

data/lib/boldsign/client.rb

@@ -172,7 +172,13 @@ module Boldsign
 
     def connection(multipart: false)
       Faraday.new(url: @base_url) do |f|
-        f.request :multipart if multipart
+        # flat_encode: true makes Faraday::Multipart::Middleware emit each
+        # Array element as its own part under the *same* field name (e.g. two
+        # `Signers` parts) instead of bracket-suffixing it (`Signers[]=`),
+        # which BoldSign's /v1/document/send endpoint rejects. See
+        # Resources::Document#encode_multipart_value, the caller that relies
+        # on this.
+        f.request :multipart, flat_encode: true if multipart
         f.request :url_encoded
         apply_auth(f.headers)
         f.headers["Accept"] = "application/json"

data/lib/boldsign/resources/document.rb

@@ -74,13 +74,16 @@ module Boldsign
       private
 
       # BoldSign's POST /v1/document/send multipart endpoint is fussy about
-      # repeated/array-valued parts. Single signers must be sent as one
-      # multipart part whose value is the signer JSON OBJECT (not a JSON array
-      # containing one object). Files must be sent as a single FilePart value
-      # for one upload; Faraday's automatic `Files[]` bracketing breaks the
-      # request. For the single-signer, single-file flow (the common case) we
-      # unwrap one-element arrays here. Multi-signer / multi-file is not yet
-      # supported via this helper and will raise.
+      # repeated/array-valued parts. Multi-valued fields (e.g. two signers)
+      # must be sent as one multipart part per element, each keyed with the
+      # *same* field name and JSON-encoding just that one element — not a
+      # single field whose value is a JSON array, and not Faraday's default
+      # `Signers[]=` bracket-suffixed encoding (BoldSign rejects both). See
+      # `Client#connection`'s `flat_encode: true`, which is what makes
+      # `encode_multipart_value`'s Array output emit that way. Files must be
+      # sent as a single FilePart value for one upload; Faraday's automatic
+      # `Files[]` bracketing breaks the request the same way. Multi-file is
+      # not yet supported via this helper and will raise.
       def multipart_send_body(body, files)
         parts = body.each_with_object({}) do |(key, value), acc|
           next if value.nil?
@@ -95,12 +98,15 @@ module Boldsign
         parts
       end
 
+      # Scalars pass through as-is. A Hash (or single-element Array, once
+      # `flat_encode` unwraps it to one part) becomes one JSON-object part.
+      # A multi-element Array becomes one JSON-object part *per element*,
+      # all sharing the same field name — see `multipart_send_body`'s comment.
       def encode_multipart_value(value)
         return value.to_s if scalar?(value)
-        return JSON.generate(Boldsign::CaseConvert.camelize(value)) unless value.is_a?(Array)
-        raise NotImplementedError, "multi-element arrays are not supported in multipart bodies yet" if value.size > 1
+        return value.map { |v| JSON.generate(Boldsign::CaseConvert.camelize(v)) } if value.is_a?(Array)
 
-        JSON.generate(Boldsign::CaseConvert.camelize(value.first))
+        JSON.generate(Boldsign::CaseConvert.camelize(value))
       end
 
       def file_part(file)

data/lib/boldsign/version.rb

@@ -1,3 +1,3 @@
 module Boldsign
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: boldsign
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - James Klein
@@ -109,14 +109,14 @@ files:
 - lib/boldsign/resources/template.rb
 - lib/boldsign/resources/user.rb
 - lib/boldsign/version.rb
-homepage: https://github.com/kleinjm/boldsign-ruby
+homepage: https://github.com/EscrowSafe/boldsign-ruby
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/kleinjm/boldsign-ruby
-  source_code_uri: https://github.com/kleinjm/boldsign-ruby
-  changelog_uri: https://github.com/kleinjm/boldsign-ruby/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/kleinjm/boldsign-ruby/issues
+  homepage_uri: https://github.com/EscrowSafe/boldsign-ruby
+  source_code_uri: https://github.com/EscrowSafe/boldsign-ruby
+  changelog_uri: https://github.com/EscrowSafe/boldsign-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/EscrowSafe/boldsign-ruby/issues
   documentation_uri: https://rubydoc.info/gems/boldsign
   rubygems_mfa_required: 'true'
 rdoc_options: []