Previous Basic Usage | Next Advanced Usage

The Steps DSL provides Given, and_then, Continue, and and_expose for expressing complex workflows clearly.

class User::Creation < Solid::Process
  input do
    attribute :email, :string
    attribute :name, :string
  end

  def call(attributes)
    rollback_on_failure {
      Given(attributes)
        .and_then(:validate_email)  # ← Stops here if Failure
        .and_then(:create_user)
    }.and_expose(:user_created, [:user])
  end

  private

  def validate_email(email:, **)
    return Failure(:email_taken) if User.exists?(email:)

    Continue()
  end

  def create_user(email:, name:, **)
    user = User.create!(email:, name:)

    Continue(user:)
  end
end

Note: Using create! inside rollback_on_failure lets exceptions trigger automatic rollback. For manual control, use create and check .persisted?.

• Given(attributes) — starts the step chain with initial data
• and_then(:method) — calls a method; short-circuits on Failure
• Continue(hash) — merges data and proceeds to next step
• and_expose(:type, [:keys]) — ends chain with Success containing only specified keys
• rollback_on_failure { } — wraps steps in a database transaction
• Always use ** in step method signatures to ignore extra keys

For detailed explanations, examples, and advanced patterns, see:

• Steps DSL — complete DSL reference
• Transactions — rollback strategies

Previous Basic Usage | Next Advanced Usage