cdc-core 0.1.0 → 0.1.1

data/sig/cdc/core/processor.rbs

@@ -23,6 +23,37 @@ module CDC
       # @return [Boolean]
       def ractor_safe?: () -> untyped
 
+      # Start the processor.
+      #
+      # Runtime layers can call this before dispatch begins. The default
+      # implementation is a no-op.
+      #
+      # @return [self]
+      def start: () -> self
+
+      # Stop the processor.
+      #
+      # Runtime layers can call this during shutdown. The default implementation
+      # is a no-op.
+      #
+      # @return [self]
+      def stop: () -> self
+
+      # Flush any buffered work.
+      #
+      # Runtime layers can call this before shutdown or checkpoints. The
+      # default implementation is a no-op.
+      #
+      # @return [self]
+      def flush: () -> self
+
+      # Whether the processor is healthy and ready to accept work.
+      #
+      # The default implementation assumes the processor is healthy.
+      #
+      # @return [Boolean]
+      def healthy?: () -> bool
+
       # Process one event.
       #
       # Subclasses must override this method.

data/sig/cdc/core/processor_result.rbs

@@ -6,6 +6,7 @@ module CDC
     # successful processing, skipped events, and failures without relying on
     # processor-specific return values.
     class ProcessorResult
+      VALID_STATUSES: untyped
       @status: untyped
 
       @event: untyped
@@ -49,9 +50,13 @@ module CDC
       #
       # @param error [Exception] processor error
       # @param event [ChangeEvent, nil] event being processed
+      # @param reason [String, nil] human-readable failure reason
+      # @param retryable [Boolean, nil] whether the failure can be retried
+      # @param processor [String, nil] processor name associated with the failure
+      # @param failed_at [String, nil] timestamp for when the failure occurred
       # @param metadata [Hash, EventMetadata] result metadata
       # @return [ProcessorResult]
-      def self.failure: (untyped error, ?event: untyped?, ?metadata: ::Hash[untyped, untyped]) -> untyped
+      def self.failure: (untyped error, ?event: untyped?, ?reason: untyped?, ?retryable: untyped?, ?processor: untyped?, ?failed_at: untyped?, ?metadata: untyped) -> untyped
 
       # Build a skipped result.
       #
@@ -76,6 +81,50 @@ module CDC
 
       # @return [Boolean] true when status is :skipped
       def skipped?: () -> untyped
+
+      # Human-readable failure reason, when present.
+      #
+      # @return [String, nil]
+      def failure_reason: () -> untyped
+
+      # Whether the failure is retryable.
+      #
+      # @return [Boolean]
+      def retryable?: () -> bool
+
+      # Name of the processor associated with the failure, when present.
+      #
+      # @return [String, nil]
+      def processor_name: () -> untyped
+
+      # Timestamp for when the failure occurred, when present.
+      #
+      # @return [String, nil]
+      def failed_at: () -> untyped
+
+      # Error class name, when present.
+      #
+      # @return [String, nil]
+      def error_class: () -> untyped
+
+      # Error message, when present.
+      #
+      # @return [String, nil]
+      def error_message: () -> untyped
+
+      # Error backtrace, when present.
+      #
+      # @return [Array<String>]
+      def error_backtrace: () -> untyped
+
+      # Convert the result into a shareable hash.
+      #
+      # @return [Hash{String=>Object,nil}]
+      def to_h: () -> untyped
+
+      private
+
+      def normalize_status: (untyped status) -> untyped
     end
   end
 end

data/sig/cdc/core/router.rbs

@@ -0,0 +1,24 @@
+module CDC
+  module Core
+    # Routes CDC work items to the appropriate handler.
+    class Router
+      @processor: untyped
+      @transaction_processor: untyped
+      @observer: untyped
+
+      attr_reader processor: untyped
+      attr_reader transaction_processor: untyped
+      attr_reader observer: untyped
+
+      def initialize: (processor: untyped, ?transaction_processor: untyped?, ?observer: untyped?) -> void
+      def process: (untyped item) -> untyped
+
+      private
+
+      def route_transaction: (untyped transaction) -> untyped
+      def route_many: (untyped items) -> untyped
+      def observe_result: (untyped result) -> untyped
+      def observe_results: (untyped results) -> untyped
+    end
+  end
+end

data/sig/cdc/core/source_adapter.rbs

@@ -0,0 +1,10 @@
+# Base class for source adapters that normalize upstream payloads into CDC
+# core domain objects.
+module CDC
+  module Core
+    class SourceAdapter
+      def normalize: (untyped input) -> untyped
+      def normalize_many: (untyped inputs) -> ::Array[untyped]
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cdc-core
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ken C. Demanawa
@@ -28,11 +28,19 @@ files:
 - lib/cdc/core/composite_processor.rb
 - lib/cdc/core/errors.rb
 - lib/cdc/core/event_metadata.rb
+- lib/cdc/core/event_position.rb
 - lib/cdc/core/filter.rb
+- lib/cdc/core/null_observer.rb
+- lib/cdc/core/observer.rb
 - lib/cdc/core/operation.rb
+- lib/cdc/core/ordering_key.rb
+- lib/cdc/core/ordering_policy.rb
+- lib/cdc/core/ordering_scope.rb
 - lib/cdc/core/pipeline.rb
 - lib/cdc/core/processor.rb
 - lib/cdc/core/processor_result.rb
+- lib/cdc/core/router.rb
+- lib/cdc/core/source_adapter.rb
 - lib/cdc/core/transaction_envelope.rb
 - lib/cdc/core/version.rb
 - lib/cdc_core.rb
@@ -42,11 +50,19 @@ files:
 - sig/cdc/core/composite_processor.rbs
 - sig/cdc/core/errors.rbs
 - sig/cdc/core/event_metadata.rbs
+- sig/cdc/core/event_position.rbs
 - sig/cdc/core/filter.rbs
+- sig/cdc/core/null_observer.rbs
+- sig/cdc/core/observer.rbs
 - sig/cdc/core/operation.rbs
+- sig/cdc/core/ordering_key.rbs
+- sig/cdc/core/ordering_policy.rbs
+- sig/cdc/core/ordering_scope.rbs
 - sig/cdc/core/pipeline.rbs
 - sig/cdc/core/processor.rbs
 - sig/cdc/core/processor_result.rbs
+- sig/cdc/core/router.rbs
+- sig/cdc/core/source_adapter.rbs
 - sig/cdc/core/transaction_envelope.rbs
 - sig/cdc/core/version.rbs
 - sig/cdc_core.rbs