nextmail 0.0.1 → 0.1.0

data/lib/nextmail/transport.rb

@@ -43,6 +43,21 @@ module Nextmail
       deliver(outbound, repeatable.nil? ? Protocol::RETRY[:METHODS].include?(verb) : repeatable, accept, binary)
     end
 
+    def stream(path, query: nil, headers: nil, accept: nil, api_key: nil, timeout: nil, idle_timeout: nil, &)
+      raise ArgumentError, Defaults::MESSAGES[:STREAM_BLOCK_REQUIRED] unless block_given?
+
+      outbound = HttpRequest.new(
+        method: Protocol::HTTP_METHODS[:GET],
+        url: Endpoint.build_url(@base_url, path, query),
+        headers: headers_for(body: nil, raw: nil, content_type: nil, api_key:, inbox_token: nil, anonymous: false,
+          idempotent: false, idempotency_key: nil, accept:, extra: headers),
+        body: nil,
+        timeout: seconds(timeout.nil? ? @timeout : timeout_option(timeout))
+      )
+
+      open_stream(outbound, idle_timeout.nil? ? nil : seconds(timeout_option(idle_timeout)), &)
+    end
+
     def inspect
       "#<#{self.class.name} base_url=#{@base_url.inspect}>"
     end
@@ -81,20 +96,116 @@ module Nextmail
       response = @adapter.call(outbound)
       HttpResponse.new(status: Integer(response.status), headers: header_table(response.headers), body: response.body.to_s)
     rescue Timeout::Error => error
-      NetworkError.new(format(Defaults::MESSAGES[:TIMED_OUT], seconds: outbound.timeout), original: error, timeout: true)
+      timed_out(outbound.timeout, error)
     rescue *PROGRAMMING_ERRORS
       raise
     rescue => error
+      unreachable(error)
+    end
+
+    def timed_out(seconds, error)
+      NetworkError.new(format(Defaults::MESSAGES[:TIMED_OUT], seconds:), original: error, timeout: true)
+    end
+
+    def unreachable(error)
       NetworkError.new(format(Defaults::MESSAGES[:UNREACHABLE], base_url: @base_url, reason: error.message),
         original: error)
     end
 
+    def open_stream(outbound, idle)
+      refusal = nil
+      result = nil
+      inside = false
+
+      begin
+        receive_stream(outbound, idle) do |response|
+          if response.ok?
+            inside = true
+            result = yield response.with(body: guarded_chunks(response.body, idle))
+            inside = false
+          else
+            refusal = refused(response)
+          end
+        end
+      rescue Timeout::Error => error
+        raise if inside
+
+        raise timed_out(outbound.timeout, error)
+      rescue *PROGRAMMING_ERRORS
+        raise
+      rescue => error
+        raise if inside
+
+        raise unreachable(error)
+      end
+
+      raise api_error(refusal, retry_after(refusal.header(Protocol::HEADER_KEYS[:RETRY_AFTER]))) unless refusal.nil?
+
+      result
+    end
+
+    def receive_stream(outbound, idle)
+      unless @adapter.respond_to?(:stream)
+        whole = @adapter.call(outbound)
+        return yield HttpStream.new(status: Integer(whole.status), headers: header_table(whole.headers),
+          body: [whole.body.to_s])
+      end
+
+      @adapter.stream(outbound, idle_timeout: idle) do |response|
+        yield HttpStream.new(status: Integer(response.status), headers: header_table(response.headers),
+          body: response.body)
+      end
+    end
+
+    def refused(response)
+      body = begin
+        response.read
+      rescue *PROGRAMMING_ERRORS
+        raise
+      rescue
+        ""
+      end
+
+      HttpResponse.new(status: response.status, headers: response.headers, body:)
+    end
+
+    def guarded_chunks(body, idle)
+      Enumerator.new do |chunks|
+        inside = false
+
+        begin
+          body.each do |chunk|
+            inside = true
+            chunks << chunk
+            inside = false
+          end
+        rescue *PROGRAMMING_ERRORS
+          raise
+        rescue => error
+          raise if inside
+
+          raise stream_failure(error, idle)
+        end
+      end
+    end
+
+    def stream_failure(error, idle)
+      timeout = error.is_a?(Timeout::Error)
+      if timeout && !idle.nil?
+        return NetworkError.new(format(Defaults::MESSAGES[:STREAM_IDLE], seconds: idle), original: error, timeout:)
+      end
+
+      NetworkError.new(format(Defaults::MESSAGES[:STREAM_BROKEN], base_url: @base_url, reason: error.message),
+        original: error, timeout:)
+    end
+
     def header_table(headers)
       (headers || {}).to_h { |name, value| [name.to_s.downcase, value.is_a?(Array) ? value.join(", ") : value.to_s] }
     end
 
-    def headers_for(body:, raw:, content_type:, api_key:, inbox_token:, anonymous:, idempotent:, idempotency_key:, accept:)
-      headers = @headers.merge(
+    def headers_for(body:, raw:, content_type:, api_key:, inbox_token:, anonymous:, idempotent:, idempotency_key:, accept:,
+      extra: nil)
+      headers = @headers.merge(extra_headers(extra)).merge(
         Protocol::HEADER_KEYS[:ACCEPT] => accept || Protocol::CONTENT_TYPES[:JSON],
         Protocol::HEADER_KEYS[:USER_AGENT] => @user_agent
       )
@@ -141,6 +252,10 @@ module Nextmail
       "#{Protocol::IDEMPOTENCY_KEY_PREFIX}#{SecureRandom.uuid}"
     end
 
+    def extra_headers(extra)
+      (extra || {}).to_h { |name, value| [header_name(name), header_value(value)] }
+    end
+
     def header_name(name)
       text = name.to_s
       raise ArgumentError, Defaults::MESSAGES[:HEADER_SHAPE] unless HEADER_NAME.match?(text)

data/lib/nextmail/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nextmail
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/lib/nextmail/wire.rb

@@ -27,6 +27,20 @@ module Nextmail
       end
     end
 
+    def email_raw(body)
+      recipients(body).tap do |wire|
+        wire["raw"] = raw(wire["raw"]) if wire.key?("raw")
+        wire["followUpAt"] = instant(wire["followUpAt"]) if wire.key?("followUpAt")
+      end
+    end
+
+    def raw(value)
+      return [RawBody.read(value)].pack("m0") unless value.is_a?(String) && value.encoding != Encoding::BINARY
+      return value if BASE64_TEXT.match?(value.delete(BASE64_WHITESPACE))
+
+      raise ArgumentError, Defaults::MESSAGES[:RAW_MESSAGE_SHAPE]
+    end
+
     def with_attachments(body)
       body.dup.tap do |wire|
         next unless wire.key?("attachments")

data/lib/nextmail.rb

@@ -23,8 +23,10 @@ require_relative "nextmail/raw_body"
 require_relative "nextmail/wire"
 require_relative "nextmail/image_crop"
 require_relative "nextmail/http"
+require_relative "nextmail/event_stream"
 require_relative "nextmail/update_notice"
 require_relative "nextmail/transport"
+require_relative "nextmail/live_event_stream"
 require_relative "nextmail/results"
 require_relative "nextmail/pagination"
 require_relative "nextmail/webhook"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: nextmail
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Nextmail
 bindir: bin
 cert_chain: []
-date: 2026-10-25 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies: []
 description: Send email and broadcasts, work with threads, drafts, labels, templates,
   rules, webhooks, tracking, contacts, audiences, sign-up forms, domains, suppressions,
@@ -26,9 +26,11 @@ files:
 - lib/nextmail/defaults.rb
 - lib/nextmail/endpoint.rb
 - lib/nextmail/errors.rb
+- lib/nextmail/event_stream.rb
 - lib/nextmail/http.rb
 - lib/nextmail/image_crop.rb
 - lib/nextmail/languages.rb
+- lib/nextmail/live_event_stream.rb
 - lib/nextmail/pagination.rb
 - lib/nextmail/protocol.rb
 - lib/nextmail/raw_body.rb
@@ -64,6 +66,7 @@ files:
 - lib/nextmail/resources/knowledge.rb
 - lib/nextmail/resources/labels.rb
 - lib/nextmail/resources/languages.rb
+- lib/nextmail/resources/live_events.rb
 - lib/nextmail/resources/me.rb
 - lib/nextmail/resources/members.rb
 - lib/nextmail/resources/out_of_office.rb
@@ -75,6 +78,8 @@ files:
 - lib/nextmail/resources/senders.rb
 - lib/nextmail/resources/sending.rb
 - lib/nextmail/resources/settings.rb
+- lib/nextmail/resources/share_links.rb
+- lib/nextmail/resources/shared.rb
 - lib/nextmail/resources/signatures.rb
 - lib/nextmail/resources/subscriptions.rb
 - lib/nextmail/resources/support.rb
@@ -85,6 +90,7 @@ files:
 - lib/nextmail/resources/threads.rb
 - lib/nextmail/resources/tools.rb
 - lib/nextmail/resources/tracking.rb
+- lib/nextmail/resources/traffic.rb
 - lib/nextmail/resources/webhooks.rb
 - lib/nextmail/resources/workspaces.rb
 - lib/nextmail/results.rb