nextmail 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9a95ef0efdad1840601c1e9b93d29a8835ce66ece247254f797d5d69d5a0fe2
-  data.tar.gz: 90eb6c5cb4bf078a7e1b5906142b5a177eac61daaf5ebc2826778c6ac1f30a3b
+  metadata.gz: dbdaac1fbcacdd3371bd98fdb8405c1679e09c69156634cb92f841f53227f855
+  data.tar.gz: f84a7bccb20b20fc80184e4294e7f9fc22827e8927914706cf7982bf5a51db71
 SHA512:
-  metadata.gz: 9c3125ed20b91ac82fedac71f7b1144f3c802c9257ae896e26863b9b3c54a228aa21f9f99086fba6a7815e193fbff59a7b265e6450285ece3eda405b8aabdce0
-  data.tar.gz: b2cad49d82ab24d0b83b63a23978f55162ff0de442aeec62d0af09daff29d731bd2e2d92c7171456e5d16475b3a0e6e042fc002d8f979da6cbfcf9b96fb84a10
+  metadata.gz: 8eab86537fc254e7c2da37545a72774ce9c01095892c514e4936da54ef287f508bc579a2ab93612980479490f044148e4d547598d4c4f8fcf82a749320ab9d8c
+  data.tar.gz: 2724b5a4b6d5d5fa385c138e25946de4c58d706ed85da7c746d0f678e2d30345eb5cff951418fc9ab16b936f09cdb0c6084de13a01cb08c39b4113ffd0187f61

data/README.md

@@ -81,6 +81,18 @@ end
 
 Every paginated resource has `list` for one page (`Nextmail::Page` with `items`, `has_more?` and `next_cursor`), `list_all` for every page at once as an Array, and `iterate`, which yields each item to a block, or without one returns an Enumerator that fetches the next page only when it gets there, so `first(10)` stops early. `addresses.list_all` is the exception and returns the whole address book.
 
+### Following the mailbox
+```ruby
+client.live_events.stream(types: ["message.received"]) do |event|
+  next if event[:type] == "reset"
+
+  thread = client.threads.get(event[:data][:threadId])
+  puts thread[:id]
+end
+```
+
+`live_events.stream` yields each change to the mailbox as it happens, a message received or sent, a conversation changed or deleted, a delivery that moved on, and runs until the block breaks or raises. It reconnects by itself and resumes where it left off, and when it cannot it yields a `reset` first, so list again what you keep in sync. Each stream holds a connection of its own, so give it a thread of its own when the program has other work to do. To wait for one message instead, such as a sign-in code, `threads.wait_for_email(from: "github.com", timeout: 60)` holds the request open until it arrives.
+
 ### Errors
 ```ruby
 template = "order-shipped"
@@ -176,7 +188,7 @@ client.raw.request("/something-new", method: :post, body: {name: "Invoices"})
 
 The path must begin with a single `/`, and a path whose finished URL leaves the base URL's origin raises before a request is sent, so the credential never reaches another host.
 
-`adapter:` swaps the HTTP layer for anything that responds to `call(request)` and returns `Nextmail::HttpResponse`, which is how a test drives the client without a network.
+`adapter:` swaps the HTTP layer for anything that responds to `call(request)` and returns `Nextmail::HttpResponse`, which is how a test drives the client without a network. To stream, it also responds to `stream(request, idle_timeout:)` and yields one `Nextmail::HttpStream` whose `body` gives the chunks as they arrive. Without it, `live_events.stream` and `client.raw.stream` get the body whole, once the server ends it.
 
 When a newer version is on RubyGems the client says so once on a TTY. `NEXTMAIL_DISABLE_UPDATE_NOTICE=1` or `disable_update_notice: true` turns that off.
 

data/lib/nextmail/api_paths.rb

@@ -28,6 +28,8 @@ module Nextmail
     ACCOUNT_USERNAME = "/account/username"
     ACCOUNT_USERNAME_AVAILABILITY = "/account/username/availability"
     ADDRESSES = "/addresses"
+    ADDRESS_BOOKS = "/contacts/address-books"
+    ADDRESS_BOOK_MEMBER = "/contacts/address-books/:id/members/:memberId"
     ANALYTICS_MAILBOX = "/analytics/mailbox"
     ANALYTICS_SENDING = "/analytics/sending"
     APP_HOST = "/app-host"
@@ -101,6 +103,9 @@ module Nextmail
     BROADCAST_RESEND = "/broadcasts/:id/resend"
     BROADCAST_SEND = "/broadcasts/:id/send"
     BROADCAST_STATS = "/broadcasts/:id/stats"
+    CALENDAR_CALENDAR = "/calendar/calendars/:id"
+    CALENDAR_CALENDARS = "/calendar/calendars"
+    CALENDAR_CALENDAR_MEMBER = "/calendar/calendars/:id/members/:memberId"
     CALENDAR_EVENT = "/calendar/events/:id"
     CALENDAR_EVENTS = "/calendar/events"
     CALENDAR_EVENT_CANCEL = "/calendar/events/:id/cancel"
@@ -116,9 +121,14 @@ module Nextmail
     CALENDAR_IMPORT = "/calendar/imports/:id"
     CALENDAR_IMPORTS = "/calendar/imports"
     CALENDAR_IMPORT_UNDO = "/calendar/imports/:id/undo"
+    CALENDAR_LOGIN = "/calendar/logins/:id"
+    CALENDAR_LOGINS = "/calendar/logins"
+    CALENDAR_LOGIN_PROFILE_LINK = "/calendar/logins/profile-link"
     CALENDAR_SUBSCRIPTION = "/calendar/subscriptions/:id"
     CALENDAR_SUBSCRIPTIONS = "/calendar/subscriptions"
     CALENDAR_SUBSCRIPTION_REFRESH = "/calendar/subscriptions/:id/refresh"
+    CALENDAR_TODO = "/calendar/todos/:id"
+    CALENDAR_TODOS = "/calendar/todos"
     CHAT = "/chats/:id"
     CHATS = "/chats"
     CHAT_MESSAGES = "/chats/:id/messages"
@@ -198,6 +208,7 @@ module Nextmail
     EMAILS_CHECK = "/emails/check"
     EMAILS_COMPOSE = "/emails/compose"
     EMAILS_EVENTS = "/emails/events"
+    EMAILS_RAW = "/emails/raw"
     EMAILS_REWRITE = "/emails/rewrite"
     EMAILS_SUBJECT = "/emails/subject"
     EMAILS_TRANSLATE = "/emails/translate"
@@ -283,6 +294,7 @@ module Nextmail
     LABEL_COLORS = "/labels/colors"
     LABEL_TEST = "/labels/:id/test"
     LANGUAGES = "/languages"
+    LIVE_EVENTS = "/live-events"
     MAILBOX_EXPORT = "/exports/:id"
     MAILBOX_EXPORTS = "/exports"
     MAILBOX_EXPORTS_PREVIEW = "/exports/preview"
@@ -328,6 +340,10 @@ module Nextmail
     SENDING_STREAMS = "/sending/streams"
     SENDING_STREAM_RESUME = "/sending/streams/:stream/resume"
     SETTINGS = "/settings"
+    SHARED_ITEM = "/shared/:token"
+    SHARED_ITEM_COPY = "/shared/:token/copy"
+    SHARE_LINK = "/share-links/:kind/:itemId"
+    SHARE_LINKS = "/share-links"
     SIGNATURE = "/signatures/:id"
     SIGNATURES = "/signatures"
     SIGNATURE_COPY = "/signatures/:id/copy"
@@ -385,7 +401,9 @@ module Nextmail
     THREAD = "/threads/:id"
     THREADS = "/threads"
     THREADS_COUNTS = "/threads/counts"
+    THREADS_WAIT = "/threads/wait"
     THREAD_ASSIGNEE = "/threads/:id/assignee"
+    THREAD_AUTOMATIONS = "/threads/:id/automations"
     THREAD_COMMENT = "/threads/:id/comments/:commentId"
     THREAD_COMMENTS = "/threads/:id/comments"
     THREAD_DELIVERY = "/threads/:id/delivery"
@@ -424,6 +442,7 @@ module Nextmail
     TRACKED_OPENS = "/tracking/:id/opens"
     TRACKING = "/tracking"
     TRACKING_STATS = "/tracking/stats"
+    TRAFFIC = "/traffic"
     WEBHOOK = "/webhooks/:id"
     WEBHOOKS = "/webhooks"
     WEBHOOKS_ACTIVITY = "/webhooks/activity"

data/lib/nextmail/client.rb

@@ -8,6 +8,7 @@ module Nextmail
       keys: Resources::Keys,
       addresses: Resources::Addresses,
       languages: Resources::Languages,
+      live_events: Resources::LiveEvents,
       emails: Resources::Emails,
       templates: Resources::Templates,
       tracking: Resources::Tracking,
@@ -21,6 +22,8 @@ module Nextmail
       forms: Resources::Forms,
       automations: Resources::Automations,
       events: Resources::Events,
+      share_links: Resources::ShareLinks,
+      shared: Resources::Shared,
       broadcasts: Resources::Broadcasts,
       domains: Resources::Domains,
       app_host: Resources::AppHost,
@@ -35,6 +38,7 @@ module Nextmail
       roles: Resources::Roles,
       members: Resources::Members,
       suppressions: Resources::Suppressions,
+      traffic: Resources::Traffic,
       sending: Resources::Sending,
       files: Resources::Files,
       knowledge: Resources::Knowledge,

data/lib/nextmail/constants.rb

@@ -32,7 +32,13 @@ module Nextmail
     SEND_FAILED: "send-failed"
   }.freeze
 
-  ADDRESS_FORWARD_STATUSES = {LIVE: "live", PENDING: "pending", REFUSED: "refused", PAUSED: "paused"}.freeze
+  ADDRESS_FORWARD_STATUSES = {
+    LIVE: "live",
+    PENDING: "pending",
+    REFUSED: "refused",
+    PAUSED: "paused",
+    BOUNCED: "bounced"
+  }.freeze
 
   ADDRESS_GROUP_POSTING_POLICIES = {ANYONE: "anyone", MEMBERS: "members", WORKSPACE: "workspace"}.freeze
 
@@ -66,7 +72,8 @@ module Nextmail
     WEBHOOK_DISABLED: "webhook_disabled",
     REWRITE_DOMAIN_REMOVED: "rewrite_domain_removed",
     FORWARD_PENDING: "forward_pending",
-    FORWARD_REFUSED: "forward_refused"
+    FORWARD_REFUSED: "forward_refused",
+    FORWARD_BOUNCED: "forward_bounced"
   }.freeze
 
   ADDRESS_ROUTE_TEST_STEPS = {
@@ -232,6 +239,8 @@ module Nextmail
     REPLY: "reply"
   }.freeze
 
+  AUTOMATION_THREAD_ROLES = {STARTED: "started", SENT: "sent"}.freeze
+
   AUTOMATION_TRIGGER_KINDS = {
     AUDIENCE_JOINED: "audience_joined",
     FORM_SUBMITTED: "form_submitted",
@@ -396,6 +405,8 @@ module Nextmail
 
   CALENDAR_FEED_MODES = {FULL: "full", BUSY: "busy"}.freeze
 
+  CALENDAR_KINDS = {EVENTS: "events", TODOS: "todos"}.freeze
+
   CALENDAR_REMINDER_ACTIONS = {DISPLAY: "DISPLAY", EMAIL: "EMAIL", AUDIO: "AUDIO"}.freeze
 
   CALENDAR_RESPONSES = {ACCEPTED: "ACCEPTED", DECLINED: "DECLINED", TENTATIVE: "TENTATIVE"}.freeze
@@ -439,6 +450,10 @@ module Nextmail
     FAILED: "failed"
   }.freeze
 
+  COLLECTION_ACCESS_LEVELS = {READ: "read", WRITE: "write"}.freeze
+
+  COLLECTION_RIGHTS = {OWNER: "owner", WRITE: "write", READ: "read"}.freeze
+
   CONNECTED_APP_KINDS = {APP: "app", CLI: "cli"}.freeze
 
   CONNECTED_APP_STATUSES = {
@@ -1095,6 +1110,26 @@ module Nextmail
     {code: "tpi", label: "Tok Pisin", native: "Tok Pisin", flag: "🇵🇬", rtl: false}.freeze
   ].freeze
 
+  LIVE_EVENT_TYPES = {
+    MESSAGE_RECEIVED: "message.received",
+    MESSAGE_SENT: "message.sent",
+    THREAD_CHANGED: "thread.changed",
+    THREAD_DELETED: "thread.deleted",
+    MESSAGE_STATUS_CHANGED: "message.status_changed"
+  }.freeze
+
+  LIVE_RESET_REASONS = {EXPIRED: "expired", UNKNOWN: "unknown"}.freeze
+
+  LIVE_SEND_STATUSES = {
+    DELIVERED: "delivered",
+    DELIVERY_DELAYED: "delivery_delayed",
+    BOUNCED: "bounced",
+    COMPLAINED: "complained",
+    FAILED: "failed",
+    SUPPRESSED: "suppressed",
+    CANCELLED: "cancelled"
+  }.freeze
+
   LOGIN_BACKGROUND_KINDS = {PRESET: "preset", COLOR: "color", IMAGE: "image"}.freeze
 
   LOGIN_BACKGROUND_PRESETS = {
@@ -1147,6 +1182,7 @@ module Nextmail
     ICLOUD: "icloud",
     FASTMAIL: "fastmail",
     ZOHO: "zoho",
+    OPENEMAIL: "openemail",
     OTHER: "other"
   }.freeze
 
@@ -1169,6 +1205,7 @@ module Nextmail
     PROTON: "proton",
     ZOHO: "zoho",
     FASTMAIL: "fastmail",
+    OPENEMAIL: "openemail",
     RESEND: "resend",
     SENDGRID: "sendgrid",
     MAILGUN: "mailgun",
@@ -1327,6 +1364,8 @@ module Nextmail
     TWO_FACTOR_REQUIREMENT_CHANGED: "two-factor-requirement-changed",
     ADDRESS_PASSWORD_SET: "address-password-set",
     ADDRESS_PASSWORD_REMOVED: "address-password-removed",
+    CALENDAR_LOGIN_CREATED: "calendar-login-created",
+    CALENDAR_LOGIN_REVOKED: "calendar-login-revoked",
     DIRECTORY_SYNC_CONNECTED: "directory-sync-connected",
     DIRECTORY_SYNC_DISCONNECTED: "directory-sync-disconnected",
     DIRECTORY_SYNC_TOKEN_ROTATED: "directory-sync-token-rotated",
@@ -1407,6 +1446,8 @@ module Nextmail
 
   SETTINGS_WEEK_STARTS = {MONDAY: "monday", SUNDAY: "sunday"}.freeze
 
+  SHARE_KINDS = {TEMPLATE: "template", FORM: "form", AUTOMATION: "automation"}.freeze
+
   STEP_UP_ERROR_CODES = {
     STEP_UP_REQUIRED: "step_up_required",
     STEP_UP_NOT_APPLICABLE: "step_up_not_applicable",
@@ -1517,6 +1558,45 @@ module Nextmail
 
   THREAD_SUMMARY_STATES = {READY: "ready", PENDING: "pending", FAILED: "failed", NONE: "none"}.freeze
 
+  TODO_STATES = {OPEN: "open", DONE: "done", ALL: "all"}.freeze
+
+  TODO_STATUSES = {
+    NEEDS_ACTION: "NEEDS-ACTION",
+    IN_PROCESS: "IN-PROCESS",
+    COMPLETED: "COMPLETED",
+    CANCELLED: "CANCELLED"
+  }.freeze
+
+  TRAFFIC_DIRECTIONS = {INBOUND: "inbound", OUTBOUND: "outbound"}.freeze
+
+  TRAFFIC_OUTCOMES = {
+    DELIVERED: "delivered",
+    DEFERRED: "deferred",
+    BOUNCED: "bounced",
+    SUPPRESSED: "suppressed",
+    COMPLAINED: "complained",
+    REJECTED: "rejected",
+    FAILED: "failed",
+    FORWARDED: "forwarded",
+    FILED: "filed",
+    SPAM: "spam",
+    ROUTED: "routed",
+    REFUSED: "refused",
+    DROPPED: "dropped",
+    REPORT: "report"
+  }.freeze
+
+  TRAFFIC_REASONS = {
+    UNKNOWN_RECIPIENT: "unknown_recipient",
+    ADDRESS_LIMITS: "address_limits",
+    BLOCKED_SENDER: "blocked_sender",
+    RULE: "rule",
+    GROUP_POLICY: "group_policy",
+    UNREADABLE: "unreadable",
+    TOO_LARGE: "too_large",
+    REPORT_REFUSED: "report_refused"
+  }.freeze
+
   UNSUBSCRIBE_METHODS = {ONE_CLICK: "one-click", EMAIL: "email", LINK: "link"}.freeze
 
   UNSUBSCRIBE_SOURCES = {

data/lib/nextmail/defaults.rb

@@ -24,6 +24,8 @@ module Nextmail
     IPV4_DECIMAL_PART = /\A(?:0|[1-9]\d*)\z/
     IPV4_OCTAL_PART = /\A0[0-7]+\z/
     IPV4_HEX_PART = /\A0x[0-9a-f]*\z/i
+    EVENT_STREAM_LINE_END = /[\r\n]/
+    EVENT_STREAM_RETRY_VALUE = /\A\d+\z/
 
     CONTENT_TYPES_BY_EXTENSION = {
       ".png" => "image/png",
@@ -91,6 +93,7 @@ module Nextmail
       RAW_BODY_SHAPE: "Pass the bytes as a String, an IO or a Pathname.",
       HEADER_SHAPE: "A header name must be a token and a header value must not contain a line break.",
       TIMEOUT_SHAPE: "Pass timeout: as a number of seconds, or 0 for no timeout.",
+      RAW_MESSAGE_SHAPE: "A raw message must be base64 text, or its bytes as a binary String or an IO",
       ATTACHMENT_CONTENT_SHAPE: "An attachment's content must be base64 text, or the raw bytes as a binary String " \
         "(File.binread), an IO or a Pathname, which are encoded for you.",
       CROP_SHAPE: "Pass crop: as a Hash of four numbers, :x, :y, :width and :height, each a fraction of the image " \
@@ -98,6 +101,13 @@ module Nextmail
       SEGMENT_ENCODING: "An id must be valid UTF-8 text.",
       TIMED_OUT: "Request timed out after %<seconds>ss.",
       UNREACHABLE: "Could not reach %<base_url>s: %<reason>s",
+      STREAM_IDLE: "The stream sent nothing for %<seconds>ss.",
+      STREAM_BROKEN: "The stream from %<base_url>s broke off: %<reason>s",
+      STREAM_BLOCK_TOO_LARGE: "The event stream sent more than %<limit>s bytes without ending an event.",
+      STREAM_BLOCK_REQUIRED: "Pass a block: the stream stays open while the block runs and closes when it returns.",
+      NOT_AN_EVENT_STREAM: "The API answered %<status>s with %<media_type>s where an event stream was expected.",
+      NO_CONTENT_TYPE: "no content type",
+      WAIT_TIMEOUT_SHAPE: "Pass timeout: as a whole number of seconds from 0 to 60, how long the API waits for a message.",
       NOT_JSON: "The API answered %<status>s with a body that is not JSON.",
       UNRECOGNISED_BODY: "The API responded %<status>s with a body this client did not recognise.",
       WEBHOOK_MISSING_HEADER: "Missing the X-Webhook-Signature header.",

data/lib/nextmail/event_stream.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module Nextmail
+  EventStreamRecord = Data.define(:id, :event, :data, :retry_ms)
+
+  class EventStreamParser
+    FIELDS = Protocol::EVENT_STREAM_FIELDS
+    SYNTAX = Protocol::EVENT_STREAM_SYNTAX
+    CARRIAGE_RETURN = SYNTAX[:CARRIAGE_RETURN].ord
+    LINE_FEED = SYNTAX[:LINE_FEED].ord
+
+    def initialize
+      @pending = String.new(encoding: Encoding::BINARY)
+      @skip_line_feed = false
+      @first_line = true
+      clear
+    end
+
+    def push(chunk)
+      records = []
+      text = chunk.to_s.b
+      return records if text.empty?
+
+      text = text.byteslice(1, text.bytesize - 1) if @skip_line_feed && text.getbyte(0) == LINE_FEED
+      @skip_line_feed = false
+      start = 0
+
+      while (index = text.index(Defaults::EVENT_STREAM_LINE_END, start))
+        line(@pending + text.byteslice(start, index - start), records)
+        @pending = String.new(encoding: Encoding::BINARY)
+        start = line_end(text, index) + 1
+      end
+
+      @pending << text.byteslice(start, text.bytesize - start)
+      refuse_oversized_block
+      records
+    end
+
+    def inspect
+      "#<#{self.class.name}>"
+    end
+
+    private
+
+    def line_end(text, index)
+      return index unless text.getbyte(index) == CARRIAGE_RETURN
+
+      if index + 1 == text.bytesize
+        @skip_line_feed = true
+        index
+      else
+        (text.getbyte(index + 1) == LINE_FEED) ? index + 1 : index
+      end
+    end
+
+    def line(bytes, records)
+      text = bytes.force_encoding(Encoding::UTF_8).scrub
+      text = text.delete_prefix(Decode::BYTE_ORDER_MARK) if @first_line
+      @first_line = false
+      return dispatch(records) if text.empty?
+      return if text.start_with?(SYNTAX[:COLON])
+
+      name, _colon, value = text.partition(SYNTAX[:COLON])
+      field(name, value.delete_prefix(SYNTAX[:SPACE]))
+    end
+
+    def field(name, value)
+      case name
+      when FIELDS[:EVENT] then @event = value
+      when FIELDS[:DATA] then data(value)
+      when FIELDS[:ID]
+        return if value.include?(SYNTAX[:NULL])
+
+        @id = value
+      when FIELDS[:RETRY]
+        return unless Defaults::EVENT_STREAM_RETRY_VALUE.match?(value)
+
+        @retry_ms = Integer(value, 10)
+      else
+        return
+      end
+
+      @touched = true
+    end
+
+    def data(value)
+      @data << value
+      @stored += value.bytesize
+    end
+
+    def dispatch(records)
+      if @touched
+        records << EventStreamRecord.new(
+          id: @id,
+          event: @event.empty? ? SYNTAX[:DEFAULT_EVENT] : @event,
+          data: @data.empty? ? nil : @data.join(SYNTAX[:LINE_FEED]),
+          retry_ms: @retry_ms
+        )
+      end
+
+      clear
+    end
+
+    def clear
+      @id = nil
+      @event = ""
+      @data = []
+      @retry_ms = nil
+      @touched = false
+      @stored = 0
+    end
+
+    def refuse_oversized_block
+      limit = SYNTAX[:MAX_BLOCK_CHARS]
+      return if @stored + @pending.bytesize <= limit
+
+      raise NetworkError, format(Defaults::MESSAGES[:STREAM_BLOCK_TOO_LARGE], limit:)
+    end
+  end
+end

data/lib/nextmail/http.rb

@@ -31,6 +31,38 @@ module Nextmail
     end
   end
 
+  HttpStream = Data.define(:status, :headers, :body) do
+    def ok?
+      status.between?(200, 299)
+    end
+
+    def header(name)
+      headers[name.to_s.downcase]
+    end
+
+    def each_chunk(&)
+      body.each(&)
+    end
+
+    def read
+      text = String.new(encoding: Encoding::BINARY)
+      each_chunk { |chunk| text << chunk.to_s.b }
+      text
+    end
+
+    def inspect
+      "#<data #{self.class.name} status=#{status.inspect}, headers=#{headers.inspect}>"
+    end
+
+    def to_s
+      inspect
+    end
+
+    def pretty_print(printer)
+      printer.text(inspect)
+    end
+  end
+
   class NetHttpAdapter
     def initialize(max_idle: Defaults::MAX_IDLE_CONNECTIONS, keep_alive_timeout: Defaults::KEEP_ALIVE_TIMEOUT)
       @max_idle = max_idle
@@ -56,6 +88,18 @@ module Nextmail
       response
     end
 
+    def stream(request, idle_timeout: nil, &)
+      deadline = request.timeout && (clock + request.timeout)
+      uri = URI.parse(request.url)
+      connection = connect(uri, remaining(deadline))
+
+      begin
+        receive(connection, uri, request, deadline, idle_timeout, &)
+      ensure
+        finish(connection)
+      end
+    end
+
     def close
       connections = @lock.synchronize do
         drained = @idle.values.flatten
@@ -91,6 +135,26 @@ module Nextmail
       HttpResponse.new(status: response.code.to_i, headers: response.each_header.to_h, body:)
     end
 
+    def receive(connection, uri, request, deadline, idle_timeout)
+      limit(connection, deadline)
+      outbound = Net::HTTPGenericRequest.new(request.method, !request.body.nil?, request.method != "HEAD",
+        uri.request_uri, headers_for(request))
+      outbound.body = request.body unless request.body.nil?
+
+      catch do |done|
+        connection.request(outbound) do |incoming|
+          connection.read_timeout = idle_timeout
+          yield HttpStream.new(status: incoming.code.to_i, headers: incoming.each_header.to_h, body: chunks_of(incoming))
+          throw done
+        end
+      end
+      nil
+    end
+
+    def chunks_of(incoming)
+      Enumerator.new { |chunks| incoming.read_body { |chunk| chunks << chunk } }
+    end
+
     def limit(connection, deadline)
       left = remaining(deadline)
       raise Net::ReadTimeout if left && left <= 0