omnizip 0.3.53 → 0.3.55

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7e72a57eaeb6e597e40020de67aa0242da65c6e6e8ceaa933d779d926e55666
-  data.tar.gz: 105cf4f238610f518462c115d398403fef5daca9b2994788361b027c7c5ec648
+  metadata.gz: 7de280d85fcea7072c88798c925b5aa3e03bcff124c1294e72abeb6f976cc5e8
+  data.tar.gz: 579759d99f27af57c070e5e1b6a6d6b121651932b10681da88e96331adb36bee
 SHA512:
-  metadata.gz: a5301b14047d1150885624527d03176c61a979464b7a16329a47449e13fe05679c1e5ce11a650bfd29101aaaf502b5ab81513558fc080dca85554266ae30f8dc
-  data.tar.gz: a44ffd04cc02fa03e2b23a330da4f6612d268bfd350d9b9672e42d7a107dcad65201ed9707651b3533fdd790a5841a5ff9297d6f3a8e937b51e0f1614d756c55
+  metadata.gz: a08a53e33284555a3fe7493834f522e0bf00a8609705e06d6c05578bb342bb3db4e4ba1c3c0793f18a001ef55305fd3396a7300b6c7f1c82196a9702931fc374
+  data.tar.gz: 7b0550e981ff0cb317beffdcb7eff7b233a7fff0bc4812eae01a566f1a0d255de8896e217d1d1ce62618b56bb5ea284dc414c98b53c171fa4af0b54a1a048b86

data/CHANGELOG.md

@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.54] - 2026-09-01
+
+### Changed
+- The 7z tree's 38 bare `raise "string"` sites gain their matching
+  classes: `PasswordError` for encrypted-header problems (with a
+  new autoload entry — the class lives at the top of password.rb,
+  so referencing it never loaded the file),
+  `InvalidArchiveError`/`UnsupportedFormatError` for parse and
+  structure failures, `ChecksumError` for CRC mismatches,
+  `AlgorithmNotFoundError`/`UnknownFilterError` in CoderChain, and
+  `Errno::ENOENT` for missing entries and volumes. The reader's
+  encrypted-header probe re-raises password errors by class instead
+  of matching message text.
+- In-memory ZIP leaves the rubyzip compat layer: `Buffer.create`
+  writes through the native Writer (which gains a per-entry
+  compression-method override so `:store` entries work beside
+  deflated ones), and `Buffer.open`/`MemoryExtractor` read through
+  the native Reader via a temporary-file spill.
+  `MemoryArchive::Entry#read` now has true IO streaming semantics —
+  successive chunks and nil at EOF (an always-returning read looped
+  forever in `Pipe::StreamDecompressor`).
+- The parallel subsystem is revived: Engine drives our own
+  WorkerPool instead of a phantom `Fractor::WorkerPool`,
+  ParallelExtractor reads through the native ZIP reader and runs on
+  a bounded ThreadPool — Ractor workers cannot trigger Omnizip's
+  autoloads or cross into Proc-holding codec constants on
+  Ruby <= 3.3 — JobScheduler's implemented round_robin/bin_packing
+  strategies are reachable, directory entries extract idempotently,
+  and the subsystem gains specs.
+
+### Fixed
+- par2_compatibility_spec was missing `require "tmpdir"` and failed
+  9 of 15 examples whenever no earlier spec happened to load tmpdir
+  first.
+
+## [0.3.53] - 2026-09-01
+
+### Changed
+- The last six hand-rolled `to_h` serializers migrate onto
+  lutaml-model like their siblings: `ConversionResult`,
+  `PerformanceResult`, `ProfileReport` (with a nested Summary model
+  built from aggregates), `OptimizationSuggestion`, `MatchResult`,
+  and `FilterConfig`. Computed report fields (size_reduction,
+  throughput, priority_score, summary aggregates) serialize through
+  lutaml derived attributes keyed under their documented names.
+  Serialized hashes now use string keys (`to_hash`, matching the
+  other migrated models).
+- `Formats::Zip::Reader` gains `read_entry_stream`, yielding bounded
+  chunks (raw copy for STORE, incremental inflater for DEFLATE) with
+  a CRC check after the last chunk. `Chunked.decompress_file`
+  streams through it — the memory-efficient path no longer holds the
+  whole decompressed entry in memory to slice it. Extracting a
+  single 7z entry in memory (`MemoryExtractor`) extracts just that
+  entry instead of decompressing the entire archive.
+
+### Fixed
+- Boundary errors stop masquerading as bare RuntimeErrors:
+  `Checksums::Verifier` raises `UnknownChecksumError` (the class
+  existed unused), and thirty more `raise "string"` sites gained
+  their matching classes (`Errno::ENOENT` for missing entries
+  — matching the handler-registry convention — `Errno::EEXIST`,
+  `IOError`, `InvalidArchiveError`, `DecompressionError`,
+  `RarNotAvailableError`). The never-called placeholder
+  `decode_escape_code` in the RAR PPMd decoder is deleted.
+
 ## [0.3.52] - 2026-09-01
 
 ### Changed

data/lib/omnizip/algorithms/lzma/dictionary.rb

@@ -31,7 +31,7 @@ module Omnizip
 
         # Read bytes from dictionary at a distance back
         def read_bytes(distance, length)
-          raise "Invalid distance: #{distance}" if distance > @buffer.bytesize
+          raise Omnizip::DecompressionError, "Invalid distance: #{distance}" if distance > @buffer.bytesize
 
           result = String.new(encoding: Encoding::BINARY)
           src_pos = @buffer.bytesize - distance
@@ -46,7 +46,7 @@ module Omnizip
 
         # Get byte at distance back
         def get_byte(distance)
-          raise "Invalid distance: #{distance}" if distance > @buffer.bytesize
+          raise Omnizip::DecompressionError, "Invalid distance: #{distance}" if distance > @buffer.bytesize
 
           @buffer.getbyte(@buffer.bytesize - distance)
         end

data/lib/omnizip/algorithms/lzma/lzma_alone_decoder.rb

@@ -118,12 +118,12 @@ module Omnizip
           # Step 1: Parse properties byte (SEQ_PROPERTIES)
           # Reference: alone_decoder.c:64-68
           props = @input.getbyte
-          raise "Invalid .lzma header: missing properties byte" if props.nil?
+          raise Omnizip::DecompressionError, "Invalid .lzma header: missing properties byte" if props.nil?
 
           # Use XZ Utils property byte parsing
           # Reference: /Users/mulgogi/src/external/xz/src/liblzma/lzma/lzma_decoder.c:1216-1228
           if props > MAX_PROPERTY_BYTE
-            raise "Invalid .lzma header: properties byte #{props} exceeds maximum #{MAX_PROPERTY_BYTE}"
+            raise Omnizip::DecompressionError, "Invalid .lzma header: properties byte #{props} exceeds maximum #{MAX_PROPERTY_BYTE}"
           end
 
           # Parse lc, lp, pb from properties byte
@@ -136,7 +136,7 @@ module Omnizip
           # Validate lc + lp <= 4 (LZMA_LCLP_MAX)
           # Reference: lzma_decoder.c:1227
           if @lc + @lp > 4
-            raise "Invalid .lzma header: lc (#{@lc}) + lp (#{@lp}) exceeds maximum 4"
+            raise Omnizip::DecompressionError, "Invalid .lzma header: lc (#{@lc}) + lp (#{@lp}) exceeds maximum 4"
           end
 
           # Step 2: Parse dictionary size (SEQ_DICTIONARY_SIZE)
@@ -144,7 +144,7 @@ module Omnizip
           @dict_size = 0
           4.times do |i|
             byte = @input.getbyte
-            raise "Incomplete .lzma header: missing dictionary size byte" if byte.nil?
+            raise Omnizip::DecompressionError, "Incomplete .lzma header: missing dictionary size byte" if byte.nil?
 
             @dict_size |= (byte << (i * 8))
           end
@@ -163,7 +163,7 @@ module Omnizip
             d += 1
 
             if d != @dict_size
-              raise "Invalid .lzma header: dictionary size #{@dict_size} is not 2^n or 2^n + 2^(n-1)"
+              raise Omnizip::DecompressionError, "Invalid .lzma header: dictionary size #{@dict_size} is not 2^n or 2^n + 2^(n-1)"
             end
           end
 
@@ -172,7 +172,7 @@ module Omnizip
           @uncompressed_size = 0
           8.times do |i|
             byte = @input.getbyte
-            raise "Incomplete .lzma header: missing uncompressed size byte" if byte.nil?
+            raise Omnizip::DecompressionError, "Incomplete .lzma header: missing uncompressed size byte" if byte.nil?
 
             @uncompressed_size |= (byte << (i * 8))
           end
@@ -182,7 +182,7 @@ module Omnizip
           # Reference: alone_decoder.c:116-120
           if @picky && @uncompressed_size != 0xFFFFFFFFFFFFFFFF &&
               @uncompressed_size >= MAX_UNCOMPRESSED_SIZE
-            raise "Invalid .lzma header: uncompressed size #{@uncompressed_size} exceeds maximum #{MAX_UNCOMPRESSED_SIZE}"
+            raise Omnizip::DecompressionError, "Invalid .lzma header: uncompressed size #{@uncompressed_size} exceeds maximum #{MAX_UNCOMPRESSED_SIZE}"
           end
 
           # Note: XZ Utils uses UINT64_MAX (0xFFFFFFFFFFFFFFFF) for unknown size

data/lib/omnizip/algorithms/lzma/xz_buffered_range_encoder.rb

@@ -97,7 +97,7 @@ module Omnizip
         # @param prob [BitModel] Probability model
         # @param bit [Integer] Bit value (0 or 1)
         def queue_bit(prob, bit)
-          raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+          raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
           @symbols[@count] = bit.zero? ? RC_BIT_0 : RC_BIT_1
           @probs[@count] = prob
@@ -111,7 +111,7 @@ module Omnizip
         def queue_direct_bits(value, num_bits)
           num_bits.downto(1) do |i|
             bit = (value >> (i - 1)) & 1
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = bit.zero? ? RC_DIRECT_0 : RC_DIRECT_1
             @probs[@count] = nil
@@ -122,7 +122,7 @@ module Omnizip
         # Queue flush operation
         def queue_flush
           5.times do
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = RC_FLUSH
             @probs[@count] = nil
@@ -237,7 +237,7 @@ module Omnizip
 
         # Forget queued symbols (e.g., when output limit reached)
         def forget
-          raise "Cannot forget with partial encoding" unless @pos.zero?
+          raise Omnizip::CompressionError, "Cannot forget with partial encoding" unless @pos.zero?
 
           @count = 0
         end

data/lib/omnizip/algorithms/lzma/xz_range_encoder_exact.rb

@@ -63,7 +63,7 @@ module Omnizip
 
         # Forget pending symbols (matches XZ Utils rc_forget)
         def forget
-          raise "Cannot forget while encoding" if @pos != 0
+          raise Omnizip::CompressionError, "Cannot forget while encoding" if @pos != 0
 
           @count = 0
         end
@@ -73,7 +73,7 @@ module Omnizip
         # @param prob [Probability] Probability model
         # @param bit [Integer] Bit value (0 or 1)
         def bit(prob, bit)
-          raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+          raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
           @symbols[@count] = bit
           @probs[@count] = prob
@@ -118,7 +118,7 @@ module Omnizip
         # @param bit_count [Integer] Number of bits
         def direct(value, bit_count)
           bit_count.times do
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = RC_DIRECT_0 | ((value >> (bit_count -= 1)) & 1)
             @probs[@count] = nil
@@ -129,7 +129,7 @@ module Omnizip
         # Queue flush operation (matches XZ Utils rc_flush)
         def flush
           5.times do
-            raise "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
+            raise Omnizip::CompressionError, "Symbol buffer overflow" if @count >= RC_SYMBOLS_MAX
 
             @symbols[@count] = RC_FLUSH
             @probs[@count] = nil
@@ -159,7 +159,7 @@ module Omnizip
         # @param out_size [Integer] Output buffer size
         # @return [Boolean] True if output buffer filled before encoding complete
         def encode(out, out_pos, out_size)
-          raise "Symbol buffer overflow" if @count > RC_SYMBOLS_MAX
+          raise Omnizip::CompressionError, "Symbol buffer overflow" if @count > RC_SYMBOLS_MAX
 
           skip_increment = false
 
@@ -214,7 +214,7 @@ module Omnizip
               break
 
             else
-              raise "Unknown symbol type: #{@symbols[@pos]}"
+              raise Omnizip::CompressionError, "Unknown symbol type: #{@symbols[@pos]}"
             end
 
             @pos += 1 unless skip_increment
@@ -288,7 +288,7 @@ module Omnizip
 
         # Forget pending symbols (matches XZ Utils rc_forget)
         def forget
-          raise "Cannot forget while encoding" if @pos != 0
+          raise Omnizip::CompressionError, "Cannot forget while encoding" if @pos != 0
 
           @count = 0
         end

data/lib/omnizip/algorithms/lzma/xz_utils_decoder.rb

@@ -318,7 +318,7 @@ check_rc_finished: true)
 
           # Handle nil @pos or limit gracefully
           if limit && (@pos.nil? || limit.nil?)
-            raise "Invalid state: @pos=#{@pos.inspect}, limit=#{limit.inspect}"
+            raise Omnizip::DecompressionError, "Invalid state: @pos=#{@pos.inspect}, limit=#{limit.inspect}"
           end
 
           # Circular buffer: flush output before it can be overwritten.
@@ -757,7 +757,7 @@ check_rc_finished: true)
       def read_header
         # Property byte
         props = @input.getbyte
-        raise "Invalid LZMA header" if props.nil?
+        raise Omnizip::DecompressionError, "Invalid LZMA header" if props.nil?
 
         @lc = props % 9
         remainder = props / 9
@@ -768,7 +768,7 @@ check_rc_finished: true)
         @dict_size = 0
         4.times do |i|
           byte = @input.getbyte
-          raise "Incomplete header" if byte.nil?
+          raise Omnizip::DecompressionError, "Incomplete header" if byte.nil?
 
           @dict_size |= (byte << (i * 8))
         end
@@ -780,7 +780,7 @@ check_rc_finished: true)
         @uncompressed_size = 0
         8.times do |i|
           byte = @input.getbyte
-          raise "Incomplete header" if byte.nil?
+          raise Omnizip::DecompressionError, "Incomplete header" if byte.nil?
 
           @uncompressed_size |= (byte << (i * 8))
         end
@@ -791,9 +791,9 @@ check_rc_finished: true)
       # @return [void]
       # @raise [RuntimeError] If parameters are invalid
       def validate_parameters
-        raise "Invalid lc (#{@lc})" unless @lc.between?(0, 8)
-        raise "Invalid lp (#{@lp})" unless @lp.between?(0, 4)
-        raise "Invalid pb (#{@pb})" unless @pb.between?(0, 4)
+        raise Omnizip::DecompressionError, "Invalid lc (#{@lc})" unless @lc.between?(0, 8)
+        raise Omnizip::DecompressionError, "Invalid lp (#{@lp})" unless @lp.between?(0, 4)
+        raise Omnizip::DecompressionError, "Invalid pb (#{@pb})" unless @pb.between?(0, 4)
       end
 
       # Initialize probability models
@@ -1201,7 +1201,7 @@ check_rc_finished: true)
         # @dict_full is clamped at @dict_size. Use actual bytes written for validation.
         actual_bytes_written = @pos - LZ_DICT_INIT_POS
         unless actual_bytes_written > distance
-          raise "Invalid rep distance: #{distance} (bytes_written: #{actual_bytes_written})"
+          raise Omnizip::DecompressionError, "Invalid rep distance: #{distance} (bytes_written: #{actual_bytes_written})"
         end
 
         # IMPORTANT: Limit match length to not exceed uncompressed_size

data/lib/omnizip/buffer/memory_archive.rb

@@ -9,27 +9,24 @@ module Omnizip
     # (for creating) and InputStream (for reading).
     #
     # @example Creating an archive
-    #   buffer = StringIO.new
-    #   Omnizip::Zip::OutputStream.open(buffer) do |zos|
-    #     archive = MemoryArchive.new(zos, :zip)
-    #     archive.add('file.txt', 'content')
-    #   end
+    #   writer = Formats::Zip::Writer.new(nil)
+    #   archive = MemoryArchive.new(writer, :zip)
+    #   archive.add('file.txt', 'content')
+    #   writer.write_to_io(buffer)
     #
     # @example Reading an archive
-    #   Omnizip::Zip::InputStream.open(buffer) do |zis|
-    #     archive = MemoryArchive.new(zis, :zip)
-    #     archive.each_entry do |entry|
-    #       puts entry.name
-    #     end
+    #   archive = MemoryArchive.new(Formats::Zip::Reader.new(path), :zip)
+    #   archive.each_entry do |entry|
+    #     puts entry.name
     #   end
     class MemoryArchive
       attr_reader :format, :stream
 
       # Initialize memory archive wrapper
       #
-      # @param stream [Omnizip::Zip::OutputStream, Omnizip::Zip::InputStream]
-      #   Underlying stream
-      # @param format [Symbol] Archive format (:zip, :seven_zip)
+      # @param stream [Formats::Zip::Writer, Formats::Zip::Reader]
+      #   Native writer (write mode) or reader (read mode)
+      # @param format [Symbol] Archive format (:zip)
       def initialize(stream, format)
         @stream = stream
         @format = format
@@ -57,13 +54,13 @@ module Omnizip
       def add(name, data, **options)
         ensure_write_mode!
 
-        case stream
-        when Omnizip::Zip::OutputStream
-          stream.put_next_entry(name, **options)
-          stream.write(data) unless name.end_with?("/")
+        if name.end_with?("/") && data.to_s.empty?
+          stream.add_directory(name)
         else
-          raise NotImplementedError,
-                "Unsupported stream type: #{stream.class}"
+          method = if options[:compression] == :store
+                     Formats::Zip::Constants::COMPRESSION_STORE
+                   end
+          stream.add_data(name, data, nil, compression_method: method)
         end
 
         self
@@ -101,15 +98,8 @@ module Omnizip
       def each_entry
         ensure_read_mode!
 
-        case stream
-        when Omnizip::Zip::InputStream
-          while (zip_entry = stream.get_next_entry)
-            entry = Entry.new(zip_entry, stream)
-            yield(entry)
-          end
-        else
-          raise NotImplementedError,
-                "Unsupported stream type: #{stream.class}"
+        stream.entries.each do |zip_entry|
+          yield(Entry.new(zip_entry, stream))
         end
       end
 
@@ -142,22 +132,10 @@ module Omnizip
       def to_s
         ensure_write_mode!
 
-        case stream
-        when Omnizip::Zip::OutputStream
-          # OutputStream wraps the IO, we need to get the underlying buffer
-          # This is only safe after close
-          unless stream.closed?
-            raise "Archive must be closed before accessing data"
-          end
-
-          # The buffer was passed in during creation, but we don't have
-          # direct access. This method should be called on the StringIO
-          # returned by Buffer.create instead.
-          raise NotImplementedError,
-                "Use Buffer.create return value instead"
-        else
-          raise "Cannot get string from read mode archive"
-        end
+        # The buffer is owned by Buffer.create; this method should be
+        # called on the StringIO it returns instead.
+        raise NotImplementedError,
+              "Use Buffer.create return value instead"
       end
 
       # Entry wrapper with read capability
@@ -169,17 +147,19 @@ module Omnizip
 
         # Initialize entry wrapper
         #
-        # @param entry [Omnizip::Zip::Entry] Underlying entry
-        # @param stream [Omnizip::Zip::InputStream] Stream to read from
-        def initialize(entry, stream)
+        # @param entry [Formats::Zip::CentralDirectoryHeader] entry
+        # @param reader [Formats::Zip::Reader] Native archive reader
+        def initialize(entry, reader)
           @entry = entry
-          @stream = stream
-          @name = entry.name
-          @size = entry.size
+          @reader = reader
+          @name = entry.filename
+          @size = entry.uncompressed_size
           @compressed_size = entry.compressed_size
           @time = entry.time
-          @comment = entry.comment
+          @comment = entry.comment.to_s
           @directory = entry.directory?
+          @content = nil
+          @pos = 0
         end
 
         # Read entry content
@@ -195,7 +175,20 @@ module Omnizip
         #     process_chunk(chunk)
         #   end
         def read(size = nil)
-          @stream.read(size)
+          # IO-like streaming semantics: successive reads return
+          # successive chunks, nil at end-of-content. Callers like
+          # Pipe::StreamDecompressor loop on this — a read that
+          # always returns data would loop forever.
+          @content ||= @reader.read_entry(@name)
+          return nil if @pos >= @content.bytesize
+
+          chunk = if size
+                    @content.byteslice(@pos, size)
+                  else
+                    @content.byteslice(@pos, @content.bytesize - @pos)
+                  end
+          @pos += chunk.bytesize
+          chunk
         end
 
         # Check if entry is a directory
@@ -229,22 +222,24 @@ module Omnizip
 
       private
 
-      # Ensure stream is in write mode (OutputStream)
+      # Ensure stream is in write mode (native Writer)
       #
-      # @raise [RuntimeError] If not in write mode
+      # @raise [Omnizip::IOError] If not in write mode
       def ensure_write_mode!
-        return if stream.is_a?(Omnizip::Zip::OutputStream)
+        return if stream.is_a?(Omnizip::Formats::Zip::Writer)
 
-        raise "Operation requires write mode (OutputStream)"
+        raise Omnizip::IOError,
+              "Operation requires write mode (Formats::Zip::Writer)"
       end
 
-      # Ensure stream is in read mode (InputStream)
+      # Ensure stream is in read mode (native Reader)
       #
-      # @raise [RuntimeError] If not in read mode
+      # @raise [Omnizip::IOError] If not in read mode
       def ensure_read_mode!
-        return if stream.is_a?(Omnizip::Zip::InputStream)
+        return if stream.is_a?(Omnizip::Formats::Zip::Reader)
 
-        raise "Operation requires read mode (InputStream)"
+        raise Omnizip::IOError,
+              "Operation requires read mode (Formats::Zip::Reader)"
       end
     end
   end

data/lib/omnizip/buffer/memory_extractor.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "stringio"
+require "tmpdir"
 
 module Omnizip
   module Buffer
@@ -159,18 +160,28 @@ module Omnizip
         Omnizip::Buffer.detect_format(@buffer)
       end
 
-      # Extract all entries from ZIP
+      # The native ZIP reader parses from a path; spill the buffer to
+      # a temporary file and yield a reader over it.
+      def with_zip_reader
+        @buffer.rewind
+        Dir.mktmpdir("omnizip_extractor_zip") do |tmp|
+          path = File.join(tmp, "buffer.zip")
+          File.binwrite(path, @buffer.read)
+          yield Omnizip::Formats::Zip::Reader.new(path)
+        end
+      end
+
+      # Extract all entries from ZIP through the native reader
       #
       # @param result [Hash] Hash to populate with entries
       def extract_all_zip(result)
-        @buffer.rewind
-        Omnizip::Zip::InputStream.open(@buffer) do |zis|
-          while (entry = zis.get_next_entry)
+        with_zip_reader do |reader|
+          reader.entries.each do |entry|
             next if entry.directory?
 
-            content = zis.read
-            result[entry.name] = content
-            @extracted_cache[entry.name] = content
+            content = reader.read_entry(entry.filename)
+            result[entry.filename] = content
+            @extracted_cache[entry.filename] = content
           end
         end
       end
@@ -199,36 +210,23 @@ module Omnizip
         end
       end
 
-      # Extract single entry from ZIP
+      # Extract single entry from ZIP through the native reader
       #
       # @param name [String] Entry name
       # @return [String, nil] Entry content or nil if not found
       def extract_entry_zip(name)
-        @buffer.rewind
-        content = nil
-
-        Omnizip::Zip::InputStream.open(@buffer) do |zis|
-          while (entry = zis.get_next_entry)
-            if entry.name == name
-              content = zis.read unless entry.directory?
-              break
-            end
-          end
+        with_zip_reader do |reader|
+          entry = reader.entries.find { |e| e.filename == name }
+          reader.read_entry(name) if entry && !entry.directory?
         end
-
-        content
       end
 
-      # List all entry names from ZIP
+      # List all entry names from ZIP through the native reader
       #
       # @param names [Array] Array to populate with names
       def list_entries_zip(names)
-        @buffer.rewind
-
-        Omnizip::Zip::InputStream.open(@buffer) do |zis|
-          while (entry = zis.get_next_entry)
-            names << entry.name
-          end
+        with_zip_reader do |reader|
+          reader.entries.each { |entry| names << entry.filename }
         end
       end
     end

data/lib/omnizip/buffer.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "stringio"
+require "tmpdir"
 
 module Omnizip
   # In-memory archive operations without filesystem I/O
@@ -150,27 +151,33 @@ module Omnizip
 
       private
 
-      # Create ZIP archive in buffer
+      # Create ZIP archive in buffer through the native writer
       #
       # @param buffer [StringIO] Buffer to write to
       # @param options [Hash] ZIP-specific options
       # @yield [archive] Block to populate archive
       def create_zip(buffer, _options, &block)
-        Omnizip::Zip::OutputStream.open(buffer) do |zos|
-          archive = Buffer::MemoryArchive.new(zos, :zip)
-          block&.call(archive)
-        end
+        writer = Formats::Zip::Writer.new(nil)
+        archive = Buffer::MemoryArchive.new(writer, :zip)
+        block&.call(archive)
+        writer.write_to_io(buffer)
       end
 
-      # Open ZIP archive from buffer
+      # Open ZIP archive from buffer through the native reader.
+      # The reader parses from a path, so the buffer spills to a
+      # temporary file (same pattern as the 7z bridge).
       #
       # @param buffer [StringIO] Buffer containing ZIP data
       # @yield [archive] Block to read from archive
       # @return [MemoryArchive, Object] Archive or block return value
       def open_zip(buffer, &block)
         result = nil
-        Omnizip::Zip::InputStream.open(buffer) do |zis|
-          archive = Buffer::MemoryArchive.new(zis, :zip)
+        Dir.mktmpdir("omnizip_buffer_zip") do |tmp|
+          path = File.join(tmp, "buffer.zip")
+          File.binwrite(path, buffer.string)
+
+          archive = Buffer::MemoryArchive.new(Formats::Zip::Reader.new(path),
+                                              :zip)
           result = block ? yield(archive) : archive
         end
         result