inquirex 0.5.0 → 0.6.0

data/lib/inquirex/rules/less_than.rb

@@ -6,6 +6,8 @@ module Inquirex
     class LessThan < Base
       attr_reader :field, :value
 
+      # @param field [Symbol, String] step id whose answer is compared
+      # @param value [Integer] threshold the answer must stay below
       def initialize(field, value)
         super()
         @field = field.to_sym
@@ -13,18 +15,28 @@ module Inquirex
         freeze
       end
 
+      # True when the field's answer, coerced to an Integer, is below the threshold.
+      #
+      # @param answers [Hash{Symbol => Object}] answer context, step_id => value
+      # @return [Boolean]
       def evaluate(answers)
         answers[@field].to_i < @value
       end
 
+      # @return [Hash{String => Object}] wire format, same shape .from_h accepts
       def to_h
         { "op" => "less_than", "field" => @field.to_s, "value" => @value }
       end
 
+      # @return [String] human-readable form, e.g. "dependents < 2"
       def to_s
         "#{@field} < #{@value}"
       end
 
+      # Deserializes a LessThan rule from a plain Hash.
+      #
+      # @param hash [Hash] rule hash with string or symbol keys
+      # @return [LessThan]
       def self.from_h(hash)
         field = hash["field"] || hash[:field]
         value = (hash["value"] || hash[:value]).to_i

data/lib/inquirex/rules/not_empty.rb

@@ -6,12 +6,18 @@ module Inquirex
     class NotEmpty < Base
       attr_reader :field
 
+      # @param field [Symbol, String] step id whose answer is checked for presence
       def initialize(field)
         super()
         @field = field.to_sym
         freeze
       end
 
+      # True when the field's answer is neither nil nor empty
+      # (empty String, Array, Hash, etc. all evaluate false).
+      #
+      # @param answers [Hash{Symbol => Object}] answer context, step_id => value
+      # @return [Boolean]
       def evaluate(answers)
         val = answers[@field]
         return false if val.nil?
@@ -20,14 +26,20 @@ module Inquirex
         true
       end
 
+      # @return [Hash{String => Object}] wire format, same shape .from_h accepts
       def to_h
         { "op" => "not_empty", "field" => @field.to_s }
       end
 
+      # @return [String] human-readable form, e.g. "income_types is not empty"
       def to_s
         "#{@field} is not empty"
       end
 
+      # Deserializes a NotEmpty rule from a plain Hash.
+      #
+      # @param hash [Hash] rule hash with string or symbol keys
+      # @return [NotEmpty]
       def self.from_h(hash)
         field = hash["field"] || hash[:field]
         new(field)

data/lib/inquirex/validation/adapter.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Inquirex
+  # Namespace for pluggable step-answer validation adapters.
   module Validation
     # Result of validating a step answer.
     #

data/lib/inquirex/validation/null_adapter.rb

@@ -5,6 +5,11 @@ module Inquirex
     # No-op validator: always accepts any input.
     # Used by default when no validation adapter is configured.
     class NullAdapter < Adapter
+      # Accepts any input unconditionally.
+      #
+      # @param _node [Node] the current step (ignored)
+      # @param _input [Object] value submitted by the user (ignored)
+      # @return [Result] always valid, with no errors
       def validate(_node, _input)
         Result.new(valid: true)
       end

data/lib/inquirex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Inquirex
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/lib/inquirex/widget_registry.rb

@@ -10,6 +10,7 @@ module Inquirex
   # Adapters (TTY, JS, Rails) use this to pick an appropriate renderer when
   # the DSL author has not specified an explicit `widget` hint.
   module WidgetRegistry
+    # Every widget type an adapter may be asked to render, across all contexts.
     WIDGET_TYPES = %i[
       text_input
       textarea

data/lib/inquirex.rb

@@ -24,16 +24,29 @@ require_relative "inquirex/accumulator"
 require_relative "inquirex/node"
 require_relative "inquirex/definition"
 require_relative "inquirex/answers"
+require_relative "inquirex/completion_metadata"
 
 # Validation
 require_relative "inquirex/validation/adapter"
 require_relative "inquirex/validation/null_adapter"
 
+# Post-completion actions
+require_relative "inquirex/actions"
+require_relative "inquirex/actions/template"
+require_relative "inquirex/actions/outbox"
+require_relative "inquirex/actions/base"
+require_relative "inquirex/actions/send_email"
+require_relative "inquirex/actions/webhook"
+require_relative "inquirex/actions/custom"
+require_relative "inquirex/actions/action"
+require_relative "inquirex/actions/runner"
+
 # DSL
 require_relative "inquirex/dsl"
 require_relative "inquirex/dsl/rule_helpers"
 require_relative "inquirex/dsl/step_builder"
 require_relative "inquirex/dsl/flow_builder"
+require_relative "inquirex/dsl/action_builder"
 
 # Engine
 require_relative "inquirex/engine/state_serializer"

metadata

@@ -1,21 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: inquirex
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Konstantin Gredeskoul
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 description: Inquirex lets you define multi-step questionnaires as directed graphs
   with conditional branching, using a conversational DSL (ask, say, mention) and an
   AST-based rule system (contains, equals, greater_than, all, any). The engine walks
   the graph, collects structured answers, and serializes everything to JSON — making
   it the ideal backbone for cross-platform intake forms where the frontend is a chat
-  widget, a terminal, or a mobile app. Framework-agnostic, zero dependencies, thread-safe
-  immutable definitions.
+  widget, a terminal, or a mobile app. Framework-agnostic, no third-party dependencies,
+  thread-safe immutable definitions.
 email:
 - kigster@gmail.com
 executables: []
@@ -35,14 +49,26 @@ files:
 - examples/01_readme_example.rb
 - examples/02_readme_mermaid.png
 - examples/02_readme_mermaid.rb
+- examples/03_send_email_actions.rb
 - examples/README.md
 - justfile
 - lefthook.yml
 - lib/inquirex.rb
 - lib/inquirex/accumulator.rb
+- lib/inquirex/actions.rb
+- lib/inquirex/actions/action.rb
+- lib/inquirex/actions/base.rb
+- lib/inquirex/actions/custom.rb
+- lib/inquirex/actions/outbox.rb
+- lib/inquirex/actions/runner.rb
+- lib/inquirex/actions/send_email.rb
+- lib/inquirex/actions/template.rb
+- lib/inquirex/actions/webhook.rb
 - lib/inquirex/answers.rb
+- lib/inquirex/completion_metadata.rb
 - lib/inquirex/definition.rb
 - lib/inquirex/dsl.rb
+- lib/inquirex/dsl/action_builder.rb
 - lib/inquirex/dsl/flow_builder.rb
 - lib/inquirex/dsl/rule_helpers.rb
 - lib/inquirex/dsl/step_builder.rb