e-invoice-api 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c941e7dfc13571104cdb94d431d83ef109ab8ded9b974ee47c200dda4a7a45a8
-  data.tar.gz: d72386e973236ade308a80cdffa96895f4b6ebe14f7a00991ed1a056b482a896
+  metadata.gz: 8499e5d0cae2a5f9bf6b83427b46cf763b5de0df6f17981dbe45251e2079e1ec
+  data.tar.gz: 4a946717056ba3c1533b0448fd5a7cf3d177b8c2b7fffe665fdc18a1957972b0
 SHA512:
-  metadata.gz: 41f10efbd7bf90d8dd3374a9b2a2ad888c494cba639d9a8bf9624a0a44bafcf9c7820540fd9eae8166605d3501428af730dd0e247e0ad2e9a3cd0a294621c5d1
-  data.tar.gz: 20ad9882275064b83ca81bd0e07f419dcc625fcdfcbbe18c16720b5fcf3c42a48181574c7282f8e8137c69b19a23f50149f473b8914adcd60e90d9d647be3520
+  metadata.gz: 79934e3197eec9a699e19f201133a2edc38c5bbb52048143ab6c08e124366c9f80e5fad928759b4f8c5ab0efb96d117d624f968850e19a94ab9b2824c6196356
+  data.tar.gz: c180a7b76f5b2de21fae67d8484c78d17eca2c8fde15fee43fa54cb7df29a95ca5a998d05d1b7dbed9ed54fc76bfc1dae04f16a28c3a171c83ea3ec23e15d5aa

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.5.0 (2025-09-23)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** api update ([34569bc](https://github.com/e-invoice-be/e-invoice-rb/commit/34569bc552219bee2c829c83f5f702c0bb07954f))
+* expose response headers for both streams and errors ([060ee53](https://github.com/e-invoice-be/e-invoice-rb/commit/060ee535da0a4f4c7cc2ed22c88c05793ce48d79))
+
+
+### Chores
+
+* do not install brew dependencies in ./scripts/bootstrap by default ([7e7229e](https://github.com/e-invoice-be/e-invoice-rb/commit/7e7229e7d4296da7b82cd2d4d042e74a28a19aa9))
+
 ## 0.4.0 (2025-09-16)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.3.0...v0.4.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "e-invoice-api", "~> 0.4.0"
+gem "e-invoice-api", "~> 0.5.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/e_invoice_api/errors.rb

@@ -40,6 +40,9 @@ module EInvoiceAPI
       # @return [Integer, nil]
       attr_accessor :status
 
+      # @return [Hash{String=>String}, nil]
+      attr_accessor :headers
+
       # @return [Object, nil]
       attr_accessor :body
 
@@ -47,13 +50,15 @@ module EInvoiceAPI
       #
       # @param url [URI::Generic]
       # @param status [Integer, nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status: nil, body: nil, request: nil, response: nil, message: nil)
+      def initialize(url:, status: nil, headers: nil, body: nil, request: nil, response: nil, message: nil)
         @url = url
         @status = status
+        @headers = headers
         @body = body
         @request = request
         @response = response
@@ -74,6 +79,7 @@ module EInvoiceAPI
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -81,6 +87,7 @@ module EInvoiceAPI
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -95,6 +102,7 @@ module EInvoiceAPI
       #
       # @param url [URI::Generic]
       # @param status [nil]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [nil]
       # @param request [nil]
       # @param response [nil]
@@ -102,6 +110,7 @@ module EInvoiceAPI
       def initialize(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,21 +125,24 @@ module EInvoiceAPI
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
       #
       # @return [self]
-      def self.for(url:, status:, body:, request:, response:, message: nil)
-        kwargs = {
-          url: url,
-          status: status,
-          body: body,
-          request: request,
-          response: response,
-          message: message
-        }
+      def self.for(url:, status:, headers:, body:, request:, response:, message: nil)
+        kwargs =
+          {
+            url: url,
+            status: status,
+            headers: headers,
+            body: body,
+            request: request,
+            response: response,
+            message: message
+          }
 
         case status
         in 400
@@ -162,15 +174,17 @@ module EInvoiceAPI
       #
       # @param url [URI::Generic]
       # @param status [Integer]
+      # @param headers [Hash{String=>String}, nil]
       # @param body [Object, nil]
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status:, body:, request:, response:, message: nil)
+      def initialize(url:, status:, headers:, body:, request:, response:, message: nil)
         message ||= {url: url.to_s, status: status, body: body}
         super(
           url: url,
           status: status,
+          headers: headers,
           body: body,
           request: request,
           response: response,

data/lib/e_invoice_api/internal/documents_number_page.rb

@@ -66,7 +66,7 @@ module EInvoiceAPI
       #
       # @param client [EInvoiceAPI::Internal::Transport::BaseClient]
       # @param req [Hash{Symbol=>Object}]
-      # @param headers [Hash{String=>String}, Net::HTTPHeader]
+      # @param headers [Hash{String=>String}]
       # @param page_data [Hash{Symbol=>Object}]
       def initialize(client:, req:, headers:, page_data:)
         super

data/lib/e_invoice_api/internal/transport/base_client.rb

@@ -47,7 +47,7 @@ module EInvoiceAPI
           # @api private
           #
           # @param status [Integer]
-          # @param headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param headers [Hash{String=>String}]
           #
           # @return [Boolean]
           def should_retry?(status, headers:)
@@ -85,7 +85,7 @@ module EInvoiceAPI
           #
           # @param status [Integer]
           #
-          # @param response_headers [Hash{String=>String}, Net::HTTPHeader]
+          # @param response_headers [Hash{String=>String}]
           #
           # @return [Hash{Symbol=>Object}]
           def follow_redirect(request, status:, response_headers:)
@@ -378,6 +378,7 @@ module EInvoiceAPI
           rescue EInvoiceAPI::Errors::APIConnectionError => e
             status = e
           end
+          headers = EInvoiceAPI::Internal::Util.normalized_headers(response&.each_header&.to_h)
 
           case status
           in ..299
@@ -390,7 +391,7 @@ module EInvoiceAPI
           in 300..399
             self.class.reap_connection!(status, stream: stream)
 
-            request = self.class.follow_redirect(request, status: status, response_headers: response)
+            request = self.class.follow_redirect(request, status: status, response_headers: headers)
             send_request(
               request,
               redirect_count: redirect_count + 1,
@@ -399,9 +400,9 @@ module EInvoiceAPI
             )
           in EInvoiceAPI::Errors::APIConnectionError if retry_count >= max_retries
             raise status
-          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: response)
+          in (400..) if retry_count >= max_retries || !self.class.should_retry?(status, headers: headers)
             decoded = Kernel.then do
-              EInvoiceAPI::Internal::Util.decode_content(response, stream: stream, suppress_error: true)
+              EInvoiceAPI::Internal::Util.decode_content(headers, stream: stream, suppress_error: true)
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
@@ -409,6 +410,7 @@ module EInvoiceAPI
             raise EInvoiceAPI::Errors::APIStatusError.for(
               url: url,
               status: status,
+              headers: headers,
               body: decoded,
               request: nil,
               response: response
@@ -485,19 +487,21 @@ module EInvoiceAPI
             send_retry_header: send_retry_header
           )
 
-          decoded = EInvoiceAPI::Internal::Util.decode_content(response, stream: stream)
+          headers = EInvoiceAPI::Internal::Util.normalized_headers(response.each_header.to_h)
+          decoded = EInvoiceAPI::Internal::Util.decode_content(headers, stream: stream)
           case req
           in {stream: Class => st}
             st.new(
               model: model,
               url: url,
               status: status,
+              headers: headers,
               response: response,
               unwrap: unwrap,
               stream: decoded
             )
           in {page: Class => page}
-            page.new(client: self, req: req, headers: response, page_data: decoded)
+            page.new(client: self, req: req, headers: headers, page_data: decoded)
           else
             unwrapped = EInvoiceAPI::Internal::Util.dig(decoded, unwrap)
             EInvoiceAPI::Internal::Type::Converter.coerce(model, unwrapped)

data/lib/e_invoice_api/internal/type/base_page.rb

@@ -39,7 +39,7 @@ module EInvoiceAPI
         #
         # @param client [EInvoiceAPI::Internal::Transport::BaseClient]
         # @param req [Hash{Symbol=>Object}]
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param page_data [Object]
         def initialize(client:, req:, headers:, page_data:)
           @client = client

data/lib/e_invoice_api/internal/util.rb

@@ -647,7 +647,7 @@ module EInvoiceAPI
         #
         # Assumes each chunk in stream has `Encoding::BINARY`.
         #
-        # @param headers [Hash{String=>String}, Net::HTTPHeader]
+        # @param headers [Hash{String=>String}]
         # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #

data/lib/e_invoice_api/resources/inbox.rb

@@ -3,7 +3,8 @@
 module EInvoiceAPI
   module Resources
     class Inbox
-      # Retrieve a paginated list of received documents with filtering options.
+      # Retrieve a paginated list of received documents with filtering options including
+      # state, type, sender, date range, and text search.
       #
       # @overload list(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, state: nil, type: nil, request_options: {})
       #

data/lib/e_invoice_api/resources/outbox.rb

@@ -28,7 +28,8 @@ module EInvoiceAPI
         )
       end
 
-      # Retrieve a paginated list of received documents with filtering options.
+      # Retrieve a paginated list of sent documents with filtering options including
+      # state, type, sender, date range, and text search.
       #
       # @overload list_received_documents(date_from: nil, date_to: nil, page: nil, page_size: nil, search: nil, sender: nil, state: nil, type: nil, request_options: {})
       #

data/lib/e_invoice_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EInvoiceAPI
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/rbi/e_invoice_api/errors.rbi

@@ -33,6 +33,9 @@ module EInvoiceAPI
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module EInvoiceAPI
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module EInvoiceAPI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -70,6 +75,7 @@ module EInvoiceAPI
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module EInvoiceAPI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module EInvoiceAPI
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module EInvoiceAPI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module EInvoiceAPI
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module EInvoiceAPI
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/e_invoice_api/internal/transport/base_client.rbi

@@ -85,10 +85,9 @@ module EInvoiceAPI
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -99,7 +98,7 @@ module EInvoiceAPI
               request:
                 EInvoiceAPI::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(
               EInvoiceAPI::Internal::Transport::BaseClient::RequestInput
             )

data/rbi/e_invoice_api/internal/type/base_page.rbi

@@ -31,7 +31,7 @@ module EInvoiceAPI
             client: EInvoiceAPI::Internal::Transport::BaseClient,
             req:
               EInvoiceAPI::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end

data/rbi/e_invoice_api/internal/util.rbi

@@ -361,7 +361,7 @@ module EInvoiceAPI
         # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             stream: T::Enumerable[String],
             suppress_error: T::Boolean
           ).returns(T.anything)

data/rbi/e_invoice_api/resources/inbox.rbi

@@ -3,7 +3,8 @@
 module EInvoiceAPI
   module Resources
     class Inbox
-      # Retrieve a paginated list of received documents with filtering options.
+      # Retrieve a paginated list of received documents with filtering options including
+      # state, type, sender, date range, and text search.
       sig do
         params(
           date_from: T.nilable(Time),

data/rbi/e_invoice_api/resources/outbox.rbi

@@ -24,7 +24,8 @@ module EInvoiceAPI
       )
       end
 
-      # Retrieve a paginated list of received documents with filtering options.
+      # Retrieve a paginated list of sent documents with filtering options including
+      # state, type, sender, date range, and text search.
       sig do
         params(
           date_from: T.nilable(Time),

data/sig/e_invoice_api/errors.rbs

@@ -21,11 +21,14 @@ module EInvoiceAPI
 
       attr_accessor status: Integer?
 
+      attr_accessor headers: ::Hash[String, String]?
+
       attr_accessor body: top?
 
       def initialize: (
         url: URI::Generic,
         ?status: Integer?,
+        ?headers: ::Hash[String, String]?,
         ?body: Object?,
         ?request: nil,
         ?response: nil,
@@ -37,6 +40,7 @@ module EInvoiceAPI
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -48,6 +52,7 @@ module EInvoiceAPI
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -59,6 +64,7 @@ module EInvoiceAPI
       def self.for: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,
@@ -68,6 +74,7 @@ module EInvoiceAPI
       def initialize: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: e-invoice-api
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - e-invoice
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-16 00:00:00.000000000 Z
+date: 2025-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool