atlas_rb 1.8.1 → 1.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de8129aceabcd06af713b7bddf2e4be8ff259bc3f8095af41d9e63cc2f03c17b
-  data.tar.gz: 9a45c13597c30c4b0c09c9dfb0bf199edb7d919d050f10faaadc32cc2024af3b
+  metadata.gz: 0a0fac04427bc3f23f92da8a5241a263111f45b28fa01cc8829da0de3b6b48f9
+  data.tar.gz: 8e95150d0f2ecd0a33c52179e384f8462546b422dcd6997c69886163215811c8
 SHA512:
-  metadata.gz: ee4d49599431a9052c3f3bc55d2d336bb967fedc61edb2815dda42cee74d2250b6700a51ea88c5b74a959fe2f562923e4486831bba66ceb7d5b0236fa74b054c
-  data.tar.gz: 75e2208c86cc1d3e6e13a1bcde956d2d821a7e6e5a141004b2bc2743b550778bd621bcc70aed2528122fabcb931f60a2bc356ed99226a9ece39b125b4d3a3f09
+  metadata.gz: 4ced2b3f0f3fee473712f38ae3161ea8f678d9468abaf1250c9577e13261b5688be16ea687a69f6b28931a6e8920ad737d7a2057059c14751cceb683e463c2ef
+  data.tar.gz: 017e1004f59a5529184e3f07f93c815a463da07937863ff72b2063b3e1986f624e5e8ea83c0b5750b57885e7942ef981b32e66f7d3e5931ea6545108c643162d

data/.version

@@ -1 +1 @@
-1.8.1
+1.8.2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.8.1)
+    atlas_rb (1.8.2)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)

data/lib/atlas_rb/blob.rb

@@ -86,10 +86,18 @@ module AtlasRb
     #
     # The body is **not** buffered — each chunk Faraday receives is yielded
     # to `chunk_handler` immediately, making this safe for files larger than
-    # available memory. The first chunk's response headers are captured and
-    # returned so callers can inspect `Content-Type`, `Content-Length`, etc.
+    # available memory.
+    #
+    # Pass `range:` (e.g. `"bytes=0-1048575"`) to forward an HTTP `Range`
+    # header; Atlas answers `206 Partial Content` and the chunks yielded are
+    # just the requested slice. The returned hash exposes both the response
+    # **status** (200 vs 206) and the response **headers** — so a caller
+    # proxying to a browser media element can relay `Content-Range`,
+    # `Content-Length` and `Accept-Ranges` verbatim and reproduce the 206.
     #
     # @param id [String] the Blob ID.
+    # @param range [String, nil] optional HTTP byte range (`"bytes=START-END"`,
+    #   `"bytes=START-"`, or `"bytes=-SUFFIX"`). Omitted ⇒ whole-body `200`.
     # @param nuid [String, nil] optional acting user's NUID. On the relay-signing
     #   path it is signed into the assertion `sub`; on the BYO-JWT (`ATLAS_JWT`)
     #   path it is ignored (identity lives in the token).
@@ -97,22 +105,25 @@ module AtlasRb
     #   header. Falls through to {AtlasRb.config}.default_on_behalf_of when
     #   omitted.
     # @yieldparam chunk [String] the next chunk of binary data.
-    # @return [Hash] the response headers from `GET /files/<id>/content`.
+    # @return [Hash] `{ status: Integer, headers: Faraday::Utils::Headers }` for
+    #   `GET /files/<id>/content` (`headers` is case-insensitive, hash-like).
     #
-    # @example Stream to disk
+    # @example Stream the whole body to disk
     #   File.open("/tmp/out.pdf", "wb") do |f|
-    #     headers = AtlasRb::Blob.content("b-321") { |chunk| f.write(chunk) }
-    #     puts headers["content-type"]
+    #     res = AtlasRb::Blob.content("b-321") { |chunk| f.write(chunk) }
+    #     puts res[:headers]["content-type"]
     #   end
-    def self.content(id, nuid: nil, on_behalf_of: nil, &chunk_handler)
-      headers = {}
-      connection({}, nuid, on_behalf_of: on_behalf_of).get("#{ROUTE}#{id}/content") do |req|
-        req.options.on_data = proc do |chunk, _bytes_received, env|
-          headers = env.response_headers if headers.empty? && env
-          chunk_handler.call(chunk)
-        end
+    #
+    # @example Relay a browser's Range request as a 206
+    #   res = AtlasRb::Blob.content("b-321", range: "bytes=0-1048575") { |c| out << c }
+    #   res[:status]                       # => 206
+    #   res[:headers]["content-range"]     # => "bytes 0-1048575/52428800"
+    def self.content(id, range: nil, nuid: nil, on_behalf_of: nil, &chunk_handler)
+      response = connection({}, nuid, on_behalf_of: on_behalf_of).get("#{ROUTE}#{id}/content") do |req|
+        req.headers["Range"] = range if range
+        req.options.on_data = proc { |chunk, _bytes_received, _env| chunk_handler.call(chunk) }
       end
-      headers
+      { status: response.status, headers: response.headers }
     end
 
     # Upload a new Blob attached to a Work.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.8.2
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-25 00:00:00.000000000 Z
+date: 2026-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday