pgoutput-decoder 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1a32b04410b404b4eb936eac7e3cae1548830c13cdbe7a1eb5e1604fb2bdabe
-  data.tar.gz: b14c651c88ea56ef70b9674def89cfd774de17c1efaf9894544e6d5212061045
+  metadata.gz: 3a963632f6c43a96fee216f4f66e7ac5743f7b4374dec2a61bf5d5ab6c0111fe
+  data.tar.gz: 283c438cd2b5bc332483ba79a313fdbf5feda5134200f0478e8b283339fd1a68
 SHA512:
-  metadata.gz: aa2a36f348bab0d37668e40909acefc4b101e38a8ee990ef217848087eaaa5b3473741e33238a5fff6106e660138a946451f42ba9db25ca069ee49117cc72973
-  data.tar.gz: a965ef38835a5134b0ebd7f9a5eca4a54bf3786421f8365fc9110907088b797a7d2d8e86b14d2321ed37af4633df1f03ccf68b317d9209a0b43d94adc64606ee
+  metadata.gz: 05d855963feccb5872525b81318f80b58152153e344abeade63b20ede94e76e2c71932566e1ae3b8213695e2946a6b5cbb54df45e947745c0885b0d063feb7df
+  data.tar.gz: 07e90807168a43c177e448b47005b6e668d6bd1bee18b0f5e0665ed70f245d9734a22fee40a82f0162731b28c8f16ea38eecf34bdbec13c6a776ed3bc77bfff3

data/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased]
 
+## 0.2.0 - 2026-07-17
+
+### Fixed
+
+* Decode UPDATE and DELETE old-key tuples using relation key-column flags.
+* Preserve composite and non-`id` keys while omitting non-key placeholders from
+  full-width PostgreSQL tuples.
+* Restored SimpleCov result finalization, HTML report generation, and minimum
+  line/branch coverage enforcement.
+
+### Documentation
+
+* Documented exact replica-key tuple behavior.
+
 ## 0.1.1 - 2026-06-17
 
 ### Fixed

data/README.md

@@ -239,6 +239,11 @@ delete.old_values
 # => { ... } or nil
 ```
 
+`old_key` contains only columns marked as replica-key columns by the preceding
+`Relation` message. Composite and non-`id` identities retain their declared
+column order; full-width tuples with non-key placeholders do not leak those
+placeholders into the decoded key.
+
 ---
 
 ## Ractor Safety
@@ -262,10 +267,11 @@ The decoder instance itself is stateful and should not be shared across Ractors.
 bundle exec rake test
 ```
 
-With coverage:
+The test task generates line and branch coverage in `coverage/` and enforces
+the configured minimums:
 
 ```bash
-COVERAGE=true bundle exec rake test
+bundle exec rake test
 ```
 
 ---

data/lib/pgoutput/decoder/row_builder.rb

@@ -19,11 +19,34 @@ module Pgoutput
       # @param tuple [Array<Pgoutput::Messages::TupleValue>]
       # @return [Hash<String, Object>]
       def build(relation, tuple)
+        build_columns(relation.columns, tuple)
+      end
+
+      # Build a decoded replica-key hash.
+      #
+      # PostgreSQL may encode an old-key tuple at full relation width with
+      # placeholders for non-key columns, while compact protocol fixtures may
+      # contain only key values. Relation flags determine the exact key columns
+      # in both representations.
+      #
+      # @param relation [Pgoutput::Messages::Relation]
+      # @param tuple [Array<Pgoutput::Messages::TupleValue>]
+      # @return [Hash<String, Object>]
+      def build_key(relation, tuple)
+        key_columns = relation.columns.select { |column| key_column?(column) }
+        columns = tuple.length == relation.columns.length ? relation.columns : key_columns
+        build_columns(columns, tuple, key_only: true)
+      end
+
+      private
+
+      def build_columns(columns, tuple, key_only: false)
         row = {} # : Hash[String, untyped]
 
         tuple.each_with_index do |tuple_value, index|
-          column = relation.columns[index]
+          column = columns[index]
           next unless column
+          next if key_only && !key_column?(column)
 
           normalized_value = normalize_oid(tuple_value, column.oid)
           row[column.name] = @value_decoder.decode(normalized_value)
@@ -32,7 +55,9 @@ module Pgoutput
         Ractor.make_shareable(row.freeze)
       end
 
-      private
+      def key_column?(column)
+        column.flags.allbits?(1)
+      end
 
       def normalize_oid(tuple_value, oid)
         return tuple_value unless tuple_value.oid.nil?

data/lib/pgoutput/decoder/type_registry.rb

@@ -129,11 +129,14 @@ module Pgoutput
       class << self
         private
 
+        # This decodes a PostgreSQL boolean value; it is not an object predicate.
+        # rubocop:disable Naming/PredicateMethod
         def decode_bool(raw, format)
           return raw == "t" if format == :text
 
           raw.unpack1("C") == 1
         end
+        # rubocop:enable Naming/PredicateMethod
 
         def decode_int(raw, format, expected_length, template)
           return raw.to_i if format == :text

data/lib/pgoutput/decoder/version.rb

@@ -3,6 +3,6 @@
 module Pgoutput
   class Decoder
     # Gem version.
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

data/lib/pgoutput/decoder.rb

@@ -120,7 +120,7 @@ module Pgoutput
           message.relation_id,
           relation.schema,
           relation.table,
-          optional_row(relation, message.old_key_tuple),
+          optional_row(relation, message.old_key_tuple, key: true),
           optional_row(relation, message.old_tuple),
           @row_builder.build(relation, message.new_tuple)
         )
@@ -137,14 +137,15 @@ module Pgoutput
           message.relation_id,
           relation.schema,
           relation.table,
-          optional_row(relation, message.old_key_tuple),
+          optional_row(relation, message.old_key_tuple, key: true),
           optional_row(relation, message.old_tuple)
         )
       )
     end
 
-    def optional_row(relation, tuple)
+    def optional_row(relation, tuple, key: false)
       return nil if tuple.nil?
+      return @row_builder.build_key(relation, tuple) if key
 
       @row_builder.build(relation, tuple)
     end

data/sig/pgoutput_decoder.rbs

@@ -30,7 +30,7 @@ module Pgoutput
     def decode_insert: (parser_message message) -> Events::Insert
     def decode_update: (parser_message message) -> Events::Update
     def decode_delete: (parser_message message) -> Events::Delete
-    def optional_row: (relation relation, tuple? tuple) -> Hash[String, untyped]?
+    def optional_row: (relation relation, tuple? tuple, ?key: bool) -> Hash[String, untyped]?
     def relation_for: (Integer relation_id) -> relation
     def require_transaction_id: () -> Integer
     def clear_transaction!: () -> nil
@@ -156,9 +156,12 @@ module Pgoutput
 
       def initialize: (?type_registry: TypeRegistry) -> void
       def build: (relation relation, tuple tuple) -> Hash[String, untyped]
+      def build_key: (relation relation, tuple tuple) -> Hash[String, untyped]
 
       private
 
+      def build_columns: (Array[untyped] columns, tuple tuple, ?key_only: bool) -> Hash[String, untyped]
+      def key_column?: (untyped column) -> bool
       def normalize_oid: (untyped tuple_value, Integer oid) -> untyped
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgoutput-decoder
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Ken C. Demanawa