mammoth 0.7.2 → 0.9.0

data/lib/mammoth/transaction_envelope_serializer.rb

@@ -15,16 +15,20 @@ module Mammoth
     # Default payload type for transaction webhook delivery.
     PAYLOAD_TYPE = "transaction.committed"
 
-    # Serialize a CDC::Core::TransactionEnvelope-like object into a Hash.
+    # Serialize a CDC::Core::TransactionEnvelope into a Hash.
     #
-    # @param envelope [#events, #transaction_id] transaction envelope
+    # @param envelope [CDC::Core::TransactionEnvelope] transaction envelope
     # @return [Hash] webhook-ready transaction payload
     def self.call(envelope)
       new(envelope).call
     end
 
-    # @param envelope [#events, #transaction_id] transaction envelope
+    # @param envelope [CDC::Core::TransactionEnvelope] transaction envelope
     def initialize(envelope)
+      unless envelope.is_a?(CDC::Core::TransactionEnvelope)
+        raise ArgumentError, "envelope must be a CDC::Core::TransactionEnvelope"
+      end
+
       @envelope = envelope
     end
 
@@ -34,7 +38,7 @@ module Mammoth
     def call
       event_payloads = envelope.events.map { |event| EventSerializer.call(event) }
       {
-        "event_id" => envelope_value("event_id") || SecureRandom.uuid,
+        "event_id" => envelope_metadata["event_id"] || SecureRandom.uuid,
         "type" => PAYLOAD_TYPE,
         "source" => first_event_value(event_payloads, "source") || EventSerializer::DEFAULT_SOURCE,
         "transaction_id" => envelope.transaction_id,
@@ -43,7 +47,7 @@ module Mammoth
         "committed_at" => committed_at,
         "event_count" => event_payloads.length,
         "events" => event_payloads,
-        "metadata" => envelope_value("metadata") || {}
+        "metadata" => envelope_metadata
       }
     end
 
@@ -58,27 +62,21 @@ module Mammoth
 
     attr_reader :envelope
 
-    def envelope_hash
-      @envelope_hash ||= envelope.respond_to?(:to_h) ? stringify_keys(envelope.to_h) : {}
-    end
-
     def stringify_keys(hash)
       hash.to_h.transform_keys(&:to_s)
     end
 
-    def envelope_value(key)
-      return envelope.public_send(key) if envelope.respond_to?(key)
-
-      envelope_hash[key]
+    def envelope_metadata
+      @envelope_metadata ||= stringify_keys(envelope.metadata)
     end
 
     def source_position(event_payloads)
-      envelope_value("source_position") || envelope_value("commit_lsn") ||
+      envelope.commit_lsn ||
         first_event_value(event_payloads.reverse, "source_position")
     end
 
     def committed_at
-      value = envelope_value("committed_at") || envelope_value("commit_time")
+      value = envelope.committed_at
       return value.iso8601 if value.respond_to?(:iso8601)
 
       value || Time.now.utc.iso8601

data/lib/mammoth/version.rb

@@ -2,5 +2,5 @@
 
 module Mammoth
   # Current Mammoth gem version.
-  VERSION = "0.7.2"
+  VERSION = "0.9.0"
 end

data/lib/mammoth/webhook_sink.rb

@@ -94,7 +94,7 @@ module Mammoth
 
     # Deliver an event to the webhook endpoint.
     #
-    # @param event [Hash, #to_h] normalized event
+    # @param event [CDC::Core::ChangeEvent] normalized event
     # @return [Hash] delivery result
     # @raise [Mammoth::DeliveryError] when delivery fails
     def deliver(event)
@@ -103,7 +103,7 @@ module Mammoth
 
     # Deliver a transaction envelope to the webhook endpoint.
     #
-    # @param envelope [#events, #transaction_id] CDC transaction envelope
+    # @param envelope [CDC::Core::TransactionEnvelope] CDC transaction envelope
     # @return [Hash] delivery result
     # @raise [Mammoth::DeliveryError] when delivery fails
     def deliver_transaction(envelope)

data/lib/mammoth.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "cdc/core"
+
 require_relative "mammoth/version"
 require_relative "mammoth/errors"
 require_relative "mammoth/registry"
@@ -14,6 +16,9 @@ require_relative "mammoth/commands/status_command"
 require_relative "mammoth/commands/start_command"
 require_relative "mammoth/commands/deliver_sample_command"
 require_relative "mammoth/commands/dead_letters_command"
+require_relative "mammoth/dispatch_metrics"
+require_relative "mammoth/metrics_observer"
+require_relative "mammoth/observability_metrics"
 require_relative "mammoth/observability_snapshot"
 require_relative "mammoth/observability_server"
 require_relative "mammoth/sqlite_store"
@@ -22,6 +27,7 @@ require_relative "mammoth/dead_letter_store"
 require_relative "mammoth/delivered_envelope_store"
 require_relative "mammoth/event_serializer"
 require_relative "mammoth/transaction_envelope_serializer"
+require_relative "mammoth/persisted_payload_deserializer"
 require_relative "mammoth/route_filter"
 require_relative "mammoth/webhook_sink"
 require_relative "mammoth/operational_state/adapter"
@@ -37,6 +43,7 @@ require_relative "mammoth/concurrent_delivery_runtime"
 require_relative "mammoth/runtimes/adapter"
 require_relative "mammoth/runtimes/inline_adapter"
 require_relative "mammoth/runtimes/concurrent_adapter"
+require_relative "mammoth/runtimes/batching_runtime"
 require_relative "mammoth/runtimes/registry"
 require_relative "mammoth/sources/postgres"
 require_relative "mammoth/cdc_source"
@@ -47,7 +54,7 @@ require_relative "mammoth/cli"
 
 # Mammoth is a self-hosted PostgreSQL event relay.
 #
-# Mammoth 0.7.x is a single-node PostgreSQL CDC relay with webhook fanout,
+# Mammoth 0.8.x is a single-node PostgreSQL CDC relay with webhook fanout,
 # replayable operational SQLite state, health/metrics endpoints, and explicit
 # extension contracts for state, destination, runtime, lifecycle, configuration,
 # and local command integrations.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mammoth
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Ken C. Demanawa
@@ -99,14 +99,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -179,20 +185,25 @@ files:
 - lib/mammoth/destinations/adapter.rb
 - lib/mammoth/destinations/registry.rb
 - lib/mammoth/destinations/webhook_adapter.rb
+- lib/mammoth/dispatch_metrics.rb
 - lib/mammoth/errors.rb
 - lib/mammoth/event_serializer.rb
 - lib/mammoth/fanout_delivery_worker.rb
 - lib/mammoth/lifecycle_hooks.rb
+- lib/mammoth/metrics_observer.rb
 - lib/mammoth/node_identity.rb
+- lib/mammoth/observability_metrics.rb
 - lib/mammoth/observability_server.rb
 - lib/mammoth/observability_snapshot.rb
 - lib/mammoth/operational_state/adapter.rb
 - lib/mammoth/operational_state/registry.rb
 - lib/mammoth/operational_state/sqlite_adapter.rb
+- lib/mammoth/persisted_payload_deserializer.rb
 - lib/mammoth/registry.rb
 - lib/mammoth/replication_consumer.rb
 - lib/mammoth/route_filter.rb
 - lib/mammoth/runtimes/adapter.rb
+- lib/mammoth/runtimes/batching_runtime.rb
 - lib/mammoth/runtimes/concurrent_adapter.rb
 - lib/mammoth/runtimes/inline_adapter.rb
 - lib/mammoth/runtimes/registry.rb