phronomy 0.18.0 → 0.19.0

data/lib/phronomy/state_store/base.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-module Phronomy
-  module StateStore
-    # Abstract base class for workflow state persistence backends.
-    #
-    # Subclasses must implement {#load}, {#save}, and {#delete}.
-    # A snapshot is a plain +Hash+ with two keys:
-    #   +:fields+ — output of +context.to_h+
-    #   +:phase+  — +context.phase.to_s+
-    #
-    # @example Implementing a custom backend
-    #   class MyStore < Phronomy::StateStore::Base
-    #     def load(thread_id) = MyRecord.find_by(thread_id:)&.to_h
-    #     def save(thread_id, snapshot) = MyRecord.upsert(thread_id:, data: snapshot)
-    #     def delete(thread_id) = MyRecord.where(thread_id:).delete_all
-    #   end
-    class Base
-      # Load the stored snapshot for +thread_id+.
-      #
-      # @param thread_id [String]
-      # @return [Hash, nil] stored snapshot hash, or +nil+ if absent
-      # @api public
-      def load(thread_id)
-        raise NotImplementedError, "#{self.class}#load is not implemented"
-      end
-
-      # Persist +snapshot+ for +thread_id+. Overwrites any existing snapshot.
-      #
-      # @param thread_id [String]
-      # @param snapshot [Hash] serialisable hash of workflow state
-      # @return [void]
-      # @api public
-      def save(thread_id, snapshot)
-        raise NotImplementedError, "#{self.class}#save is not implemented"
-      end
-
-      # Delete the stored snapshot for +thread_id+. No-op if absent.
-      #
-      # @param thread_id [String]
-      # @return [void]
-      # @api public
-      def delete(thread_id)
-        raise NotImplementedError, "#{self.class}#delete is not implemented"
-      end
-    end
-  end
-end

data/lib/phronomy/state_store/in_memory.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-module Phronomy
-  module StateStore
-    # Thread-safe in-process state store backed by a plain Ruby Hash.
-    #
-    # Used as the recommended default for single-process applications and tests.
-    # State does not survive process restart.
-    #
-    # @example
-    #   store = Phronomy::StateStore::InMemory.new
-    #   store.save("t1", { fields: { count: 1 }, phase: "__end__" })
-    #   store.load("t1")   # => { fields: { count: 1 }, phase: "__end__" }
-    #   store.delete("t1")
-    #   store.load("t1")   # => nil
-    class InMemory < Base
-      def initialize
-        @data = {}
-        @mutex = Mutex.new
-      end
-
-      # @param thread_id [String]
-      # @return [Hash, nil]
-      # @api public
-      def load(thread_id)
-        @mutex.synchronize do
-          snap = @data[thread_id]
-          snap ? deep_dup(snap) : nil
-        end
-      end
-
-      # @param thread_id [String]
-      # @param snapshot [Hash]
-      # @return [void]
-      # @api public
-      def save(thread_id, snapshot)
-        @mutex.synchronize { @data[thread_id] = deep_dup(snapshot) }
-        nil
-      end
-
-      # @param thread_id [String]
-      # @return [void]
-      # @api public
-      def delete(thread_id)
-        @mutex.synchronize { @data.delete(thread_id) }
-        nil
-      end
-
-      private
-
-      # Recursively deep-duplicates a plain-data value (Hash, Array, or scalar).
-      # Sufficient for snapshot data which consists of JSON-compatible types.
-      def deep_dup(val)
-        case val
-        when Hash then val.each_with_object({}) { |(k, v), h| h[k] = deep_dup(v) }
-        when Array then val.map { |v| deep_dup(v) }
-        else val.frozen? ? val : (val.dup rescue val) # rubocop:disable Style/RescueModifier
-        end
-      end
-    end
-  end
-end