esa 3.5.0 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac45c200f0f20ec377611b5a480e4bedfb478b5317d2b19c79dc65a4dc2312a4
-  data.tar.gz: 9c168a382f6f580cca8f9444a21d7279db81669b984361658e3aa14fd76732d4
+  metadata.gz: 31ac99673b27154dd0f51e26e9b2df21cc5ae9748836882d783fb20313844f60
+  data.tar.gz: ab2481808f8e74884def974efdcb432263917608e0e8effa6233eaff51eee09e
 SHA512:
-  metadata.gz: 5dc4a01286d6181df8eb2e10e044710a3d3501f270f8bdb3ef04eb182825c2d27f55f7f0f7a52c7bf78f8c47883b8107ef2440ee9e56f6540aa752b7f1a5ee65
-  data.tar.gz: d67a9937c5610d04091e7dc2664a8f65999ab0ad24f821c2a5a940795c57c198dcb2e7036f7b2a7e9618eba086d6341f8b86781a447b67caf1978d9747581e04
+  metadata.gz: d3bb3fddea7149f744e344eaf9113a67cf3cbf2032dbfa9b14255657909bb3172431f9d100170e788f5744eb7593eb617b93661b73cf9791b2c85aaf3e217e0e
+  data.tar.gz: e03f488a818d740f1a303512ec5c9871372313e66c3a656354f98aa7962b3be942b6d5ec2a510356b983a1ae76103b0b6623e26d0c2990a76e4d95ac642bdeca

data/CHANGELOG.md

@@ -1,15 +1,25 @@
 ## Unreleased
 
-nothing
+Nothing
+
+## 3.7.0 (2026-08-04)
+
+- add: [Add create_attachment instead of upload_attachment](https://github.com/esaio/esa-ruby/pull/102)
+  - **deprecated**: `#upload_attachment` has been deprecated. Use `#create_attachment` instead. 
+- ci: [CI: Use latest bundler for ruby-head](https://github.com/esaio/esa-ruby/pull/103)
+
+## 3.6.0 (2026-06-17)
+
+- add: [Add prepend_post API support](https://github.com/esaio/esa-ruby/pull/98)
 
 ## 3.5.0 (2026-02-18)
 
-- [Tweak CI matrix](https://github.com/esaio/esa-ruby/pull/83)
+- ci: [Tweak CI matrix](https://github.com/esaio/esa-ruby/pull/83)
   - **changed**: Add support for Ruby 4.0 (formerly Ruby 3.5)
 
 ## 3.4.0 (2025-11-27)
 
-- [Add ruby 3.5 and drop 3.1 from CI/required_ruby_version](https://github.com/esaio/esa-ruby/pull/77)
+- ci: [Add ruby 3.5 and drop 3.1 from CI/required_ruby_version](https://github.com/esaio/esa-ruby/pull/77)
   - **changed**: Drop support for Ruby 3.1
 
 ## 3.3.0 (2025-07-18)

data/README.md

@@ -87,6 +87,10 @@ client.update_post(post_number, name: 'bar')
 client.append_post(post_number, content: 'bar')
 #=> POST /v1/teams/foobar/posts/1/append
 
+# (beta)
+client.prepend_post(post_number, content: 'bar')
+#=> POST /v1/teams/foobar/posts/1/prepend
+
 client.delete_post(post_number)
 #=> DELETE /v1/teams/foobar/posts/1
 
@@ -198,7 +202,17 @@ client.create_emoji(code: 'alias_code', origin_code: 'team_emoji')
 client.delete_emoji('team_emoji')
 #=> DELETE /v1/teams/foobar/emojis/team_emoji
 
-# Upload Attachment(beta)
+# Upload Attachment
+client.create_attachment('/Users/foo/Desktop/foo.png')                 # Path
+client.create_attachment(File.open('/Users/foo/Desktop/foo.png'))      # File
+client.create_attachment('http://example.com/foo.png')                 # Remote URL
+client.create_attachment(['http://example.com/foo.png', cookie_str])   # Remote URL + Cookie
+client.create_attachment(['http://example.com/foo.png', headers_hash]) # Remote URL + Headers
+client.create_attachment('/Users/foo/Desktop/foo.png', name: 'bar.png') # Path + Name
+#=> POST /v1/teams/foobar/attachments
+#=> { "attachment" => { "url" => "https://img.esa.io/uploads/...", "name" => "foo.png", "size" => 12345, "content_type" => "image/png" } }
+
+# Upload Attachment(beta): deprecated, use create_attachment instead
 client.upload_attachment('/Users/foo/Desktop/foo.png')                 # Path
 client.upload_attachment(File.open('/Users/foo/Desktop/foo.png'))      # File
 client.upload_attachment('http://example.com/foo.png')                 # Remote URL

data/lib/esa/api_methods.rb

@@ -53,6 +53,10 @@ module Esa
       send_post("/v1/teams/#{current_team!}/posts/#{post_number}/append", wrap(params, :post), headers)
     end
 
+    def prepend_post(post_number, params = nil, headers = nil)
+      send_post("/v1/teams/#{current_team!}/posts/#{post_number}/prepend", wrap(params, :post), headers)
+    end
+
     def revisions(post_number, params = nil, headers = nil)
       send_get("/v1/teams/#{current_team!}/posts/#{post_number}/revisions", params, headers)
     end
@@ -192,8 +196,23 @@ module Esa
       end
     end
 
-    # beta
+    def create_attachment(path_or_file_or_url, params = {}, headers = nil)
+      file = file_from(path_or_file_or_url)
+      content_type = params.delete(:content_type) || content_type_from_file(file) || 'application/octet-stream'
+
+      form_data = { file: Faraday::FilePart.new(file, content_type) }
+      form_data[:name] = params[:name] if params[:name]
+
+      send_multipart_post("/v1/teams/#{current_team!}/attachments", form_data, headers)
+    end
+
+    # deprecated: Use #create_attachment instead
     def upload_attachment(path_or_file_or_url, params = {}, headers = nil)
+      unless @upload_attachment_deprecation_warned
+        warn '[DEPRECATION] `upload_attachment` is deprecated. Use `create_attachment` instead.'
+        @upload_attachment_deprecation_warned = true
+      end
+
       file = file_from(path_or_file_or_url)
       setup_params_for_upload(params, file)
 

data/lib/esa/client.rb

@@ -43,8 +43,12 @@ module Esa
       send_request(:delete, path, params, headers)
     end
 
-    def send_request(method, path, params = nil, headers = nil)
-      response = esa_connection.send(method, path, params, headers)
+    def send_multipart_post(path, params = nil, headers = nil)
+      send_request(:post, path, params, headers, connection: multipart_connection)
+    end
+
+    def send_request(method, path, params = nil, headers = nil, connection: esa_connection)
+      response = connection.send(method, path, params, headers)
       raise TooManyRequestError if retry_on_rate_limit_exceeded && response.status == 429 # too_many_requests
       Esa::Response.new(response)
     rescue TooManyRequestError
@@ -71,6 +75,16 @@ module Esa
       end
     end
 
+    def multipart_connection
+      @multipart_connection ||= Faraday.new(faraday_options) do |c|
+        faraday_middlewares.each { |faraday_middleware| c.use faraday_middleware }
+        c.request :multipart
+        c.request :url_encoded
+        c.response :json
+        c.adapter Faraday.default_adapter
+      end
+    end
+
     def s3_connection
       @s3_connection ||= Faraday.new do |c|
         faraday_middlewares.each { |faraday_middleware| c.use faraday_middleware }

data/lib/esa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Esa
-  VERSION = '3.5.0'
+  VERSION = '3.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: esa
 version: !ruby/object:Gem::Version
-  version: 3.5.0
+  version: 3.7.0
 platform: ruby
 authors:
 - fukayatsu
@@ -201,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: esa API v1 client library, written in Ruby
 test_files: []