RubyGems - servus - Versions diffs - 0.3.0 → 0.5.0 - Mend

servus 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (144) hide show

checksums.yaml +4 -4
data/lib/generators/servus/event/event_generator.rb +54 -0
data/lib/generators/servus/event/templates/event.rb.erb +44 -0
data/lib/generators/servus/event/templates/event_spec.rb.erb +20 -0
data/lib/generators/servus/guard/guard_generator.rb +1 -1
data/lib/generators/servus/guard/templates/guard.rb.erb +5 -3
data/lib/generators/servus/service/service_generator.rb +1 -1
data/lib/servus/base.rb +46 -3
data/lib/servus/config.rb +85 -12
data/lib/servus/event.rb +235 -0
data/lib/servus/events/bus.rb +111 -72
data/lib/servus/events/class_router.rb +40 -0
data/lib/servus/events/emitter.rb +21 -6
data/lib/servus/events/invocation.rb +94 -0
data/lib/servus/events/router.rb +44 -0
data/lib/servus/guard.rb +7 -6
data/lib/servus/guards/falsey_guard.rb +3 -3
data/lib/servus/guards/presence_guard.rb +4 -4
data/lib/servus/guards/state_guard.rb +4 -5
data/lib/servus/guards/truthy_guard.rb +3 -3
data/lib/servus/helpers/controller_helpers.rb +40 -0
data/lib/servus/railtie.rb +10 -8
data/lib/servus/support/errors.rb +16 -0
data/lib/servus/support/lockdown.rb +94 -0
data/lib/servus/support/logger.rb +18 -0
data/lib/servus/support/validator.rb +70 -40
data/lib/servus/testing/example_builders.rb +52 -0
data/lib/servus/testing/matchers.rb +103 -4
data/lib/servus/version.rb +1 -1
data/lib/servus.rb +7 -2
metadata +14 -116
data/.claude/commands/check-docs.md +0 -1
data/.claude/commands/consistency-check.md +0 -1
data/.claude/commands/fine-tooth-comb.md +0 -1
data/.claude/commands/red-green-refactor.md +0 -5
data/.claude/settings.json +0 -24
data/.rspec +0 -3
data/.rubocop.yml +0 -27
data/.yardopts +0 -6
data/CHANGELOG.md +0 -169
data/CLAUDE.md +0 -10
data/IDEAS.md +0 -5
data/LICENSE.txt +0 -21
data/READme.md +0 -856
data/Rakefile +0 -45
data/docs/core/1_overview.md +0 -81
data/docs/core/2_architecture.md +0 -120
data/docs/core/3_service_objects.md +0 -154
data/docs/features/1_schema_validation.md +0 -161
data/docs/features/2_error_handling.md +0 -129
data/docs/features/3_async_execution.md +0 -81
data/docs/features/4_logging.md +0 -64
data/docs/features/5_event_bus.md +0 -244
data/docs/features/6_guards.md +0 -356
data/docs/features/7_lazy_resolvers.md +0 -238
data/docs/features/guards_naming_convention.md +0 -540
data/docs/guides/1_common_patterns.md +0 -90
data/docs/guides/2_migration_guide.md +0 -225
data/docs/integration/1_configuration.md +0 -154
data/docs/integration/2_testing.md +0 -304
data/docs/integration/3_rails_integration.md +0 -99
data/docs/yard/Servus/Base.html +0 -1645
data/docs/yard/Servus/Config.html +0 -582
data/docs/yard/Servus/Extensions/Async/Call.html +0 -400
data/docs/yard/Servus/Extensions/Async/Errors/AsyncError.html +0 -140
data/docs/yard/Servus/Extensions/Async/Errors/JobEnqueueError.html +0 -154
data/docs/yard/Servus/Extensions/Async/Errors/ServiceNotFoundError.html +0 -154
data/docs/yard/Servus/Extensions/Async/Errors.html +0 -128
data/docs/yard/Servus/Extensions/Async/Ext.html +0 -119
data/docs/yard/Servus/Extensions/Async/Job.html +0 -310
data/docs/yard/Servus/Extensions/Async.html +0 -141
data/docs/yard/Servus/Extensions.html +0 -117
data/docs/yard/Servus/Generators/ServiceGenerator.html +0 -261
data/docs/yard/Servus/Generators.html +0 -115
data/docs/yard/Servus/Helpers/ControllerHelpers.html +0 -457
data/docs/yard/Servus/Helpers.html +0 -115
data/docs/yard/Servus/Railtie.html +0 -134
data/docs/yard/Servus/Support/Errors/AuthenticationError.html +0 -287
data/docs/yard/Servus/Support/Errors/BadRequestError.html +0 -283
data/docs/yard/Servus/Support/Errors/ForbiddenError.html +0 -284
data/docs/yard/Servus/Support/Errors/InternalServerError.html +0 -283
data/docs/yard/Servus/Support/Errors/NotFoundError.html +0 -284
data/docs/yard/Servus/Support/Errors/ServiceError.html +0 -489
data/docs/yard/Servus/Support/Errors/ServiceUnavailableError.html +0 -290
data/docs/yard/Servus/Support/Errors/UnauthorizedError.html +0 -200
data/docs/yard/Servus/Support/Errors/UnprocessableEntityError.html +0 -288
data/docs/yard/Servus/Support/Errors/ValidationError.html +0 -200
data/docs/yard/Servus/Support/Errors.html +0 -140
data/docs/yard/Servus/Support/Logger.html +0 -856
data/docs/yard/Servus/Support/Rescuer/BlockContext.html +0 -585
data/docs/yard/Servus/Support/Rescuer/CallOverride.html +0 -257
data/docs/yard/Servus/Support/Rescuer/ClassMethods.html +0 -343
data/docs/yard/Servus/Support/Rescuer.html +0 -267
data/docs/yard/Servus/Support/Response.html +0 -574
data/docs/yard/Servus/Support/Validator.html +0 -1150
data/docs/yard/Servus/Support.html +0 -119
data/docs/yard/Servus/Testing/ExampleBuilders.html +0 -523
data/docs/yard/Servus/Testing/ExampleExtractor.html +0 -578
data/docs/yard/Servus/Testing.html +0 -142
data/docs/yard/Servus.html +0 -343
data/docs/yard/_index.html +0 -535
data/docs/yard/class_list.html +0 -54
data/docs/yard/css/common.css +0 -1
data/docs/yard/css/full_list.css +0 -58
data/docs/yard/css/style.css +0 -503
data/docs/yard/file.1_common_patterns.html +0 -154
data/docs/yard/file.1_configuration.html +0 -115
data/docs/yard/file.1_overview.html +0 -142
data/docs/yard/file.1_schema_validation.html +0 -188
data/docs/yard/file.2_architecture.html +0 -157
data/docs/yard/file.2_error_handling.html +0 -190
data/docs/yard/file.2_migration_guide.html +0 -242
data/docs/yard/file.2_testing.html +0 -227
data/docs/yard/file.3_async_execution.html +0 -145
data/docs/yard/file.3_rails_integration.html +0 -160
data/docs/yard/file.3_service_objects.html +0 -191
data/docs/yard/file.4_logging.html +0 -135
data/docs/yard/file.ErrorHandling.html +0 -190
data/docs/yard/file.READme.html +0 -674
data/docs/yard/file.architecture.html +0 -157
data/docs/yard/file.async_execution.html +0 -145
data/docs/yard/file.common_patterns.html +0 -154
data/docs/yard/file.configuration.html +0 -115
data/docs/yard/file.error_handling.html +0 -190
data/docs/yard/file.logging.html +0 -135
data/docs/yard/file.migration_guide.html +0 -242
data/docs/yard/file.overview.html +0 -142
data/docs/yard/file.rails_integration.html +0 -160
data/docs/yard/file.schema_validation.html +0 -188
data/docs/yard/file.service_objects.html +0 -191
data/docs/yard/file.testing.html +0 -227
data/docs/yard/file_list.html +0 -119
data/docs/yard/frames.html +0 -22
data/docs/yard/index.html +0 -674
data/docs/yard/js/app.js +0 -344
data/docs/yard/js/full_list.js +0 -242
data/docs/yard/js/jquery.js +0 -4
data/docs/yard/method_list.html +0 -542
data/docs/yard/top-level-namespace.html +0 -110
data/lib/generators/servus/event_handler/event_handler_generator.rb +0 -59
data/lib/generators/servus/event_handler/templates/handler.rb.erb +0 -86
data/lib/generators/servus/event_handler/templates/handler_spec.rb.erb +0 -48
data/lib/servus/event_handler.rb +0 -290
data/lib/servus/events/errors.rb +0 -10

data/docs/yard/file.2_migration_guide.html DELETED Viewed

@@ -1,242 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>
-  File: Guides / 2. Migration Guide
-    &mdash; Servus | Service Object Framework
-</title>
-  <link rel="stylesheet" href="css/style.css" type="text/css" />
-  <link rel="stylesheet" href="css/common.css" type="text/css" />
-<script type="text/javascript">
-  pathId = "2_migration_guide";
-  relpath = '';
-</script>
-  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
-  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
-  </head>
-  <body>
-    <div class="nav_wrap">
-      <iframe id="nav" src="file_list.html?1"></iframe>
-      <div id="resizer"></div>
-    </div>
-    <div id="main" tabindex="-1">
-      <div id="header">
-        <div id="menu">
-    <a href="_index.html">Index</a> &raquo;
-    <span class="title">File: Guides / 2. Migration Guide</span>
-</div>
-        <div id="search">
-    <a class="full_list_link" id="class_list_link"
-        href="class_list.html">
-        <svg width="24" height="24">
-          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
-          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
-          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
-        </svg>
-    </a>
-</div>
-        <div class="clear"></div>
-      </div>
-      <div id="content"><div id='filecontents'><h1 id="migration-guide">Migration Guide</h1>
-<p>Strategies for adopting Servus in existing Rails applications.</p>
-<h2 id="incremental-adoption">Incremental Adoption</h2>
-<p>Servus coexists with existing code - no need to rewrite your entire application. Start with one complex use case, validate the pattern works for your team, then expand gradually.</p>
-<h2 id="extracting-from-fat-controllers">Extracting from Fat Controllers</h2>
-<p>Identify controller actions with complex business logic and extract to services:</p>
-<p><strong>Before</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>OrdersController</span> <span class='op'>&lt;</span> <span class='const'>ApplicationController</span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_create'>create</span>
-    <span class='comment'># 50 lines of business logic
-</span>    <span class='comment'># Multiple model operations
-</span>    <span class='comment'># External API calls
-</span>    <span class='comment'># Email sending
-</span>  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<p><strong>After</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>OrdersController</span> <span class='op'>&lt;</span> <span class='const'>ApplicationController</span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_create'>create</span>
-    <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='const'>Orders</span><span class='op'>::</span><span class='const'>Create</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_order_params'>order_params</span><span class='rparen'>)</span>
-    <span class='kw'>if</span> <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_success?'>success?</span>
-      <span class='id identifier rubyid_render'>render</span> <span class='label'>json:</span> <span class='lbrace'>{</span> <span class='label'>order:</span> <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='lbracket'>[</span><span class='symbol'>:order</span><span class='rbracket'>]</span> <span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>status:</span> <span class='symbol'>:created</span>
-    <span class='kw'>else</span>
-      <span class='id identifier rubyid_render'>render</span> <span class='label'>json:</span> <span class='lbrace'>{</span> <span class='label'>error:</span> <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='period'>.</span><span class='id identifier rubyid_api_error'>api_error</span> <span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>status:</span> <span class='symbol'>:unprocessable_entity</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-<span class='comment'># Or use the helper
-</span><span class='kw'>class</span> <span class='const'>OrdersController</span> <span class='op'>&lt;</span> <span class='const'>ApplicationController</span>
-  <span class='id identifier rubyid_include'>include</span> <span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Helpers.html" title="Servus::Helpers (module)">Helpers</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Helpers/ControllerHelpers.html" title="Servus::Helpers::ControllerHelpers (module)">ControllerHelpers</a></span></span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_create'>create</span>
-    <span class='id identifier rubyid_run_service'>run_service</span><span class='lparen'>(</span><span class='const'>Orders</span><span class='op'>::</span><span class='const'>Create</span><span class='op'>::</span><span class='const'>Service</span><span class='comma'>,</span> <span class='id identifier rubyid_order_params'>order_params</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_result'>result</span><span class='op'>|</span>
-      <span class='id identifier rubyid_render'>render</span> <span class='label'>json:</span> <span class='lbrace'>{</span> <span class='label'>order:</span> <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='lbracket'>[</span><span class='symbol'>:order</span><span class='rbracket'>]</span> <span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>status:</span> <span class='symbol'>:created</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<h2 id="extracting-from-fat-models">Extracting from Fat Models</h2>
-<p>Move orchestration logic from models to services. Keep data-related methods in models:</p>
-<p><strong>Before</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>Order</span> <span class='op'>&lt;</span> <span class='const'>ApplicationRecord</span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_complete_purchase'>complete_purchase</span>
-    <span class='id identifier rubyid_charge_payment'>charge_payment</span>
-    <span class='id identifier rubyid_update_inventory'>update_inventory</span>
-    <span class='id identifier rubyid_send_confirmation_email'>send_confirmation_email</span>
-    <span class='id identifier rubyid_create_invoice'>create_invoice</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<p><strong>After</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>Order</span> <span class='op'>&lt;</span> <span class='const'>ApplicationRecord</span>
-  <span class='comment'># Model focuses on data
-</span>  <span class='id identifier rubyid_validates'>validates</span> <span class='symbol'>:total</span><span class='comma'>,</span> <span class='label'>presence:</span> <span class='kw'>true</span>
-  <span class='id identifier rubyid_belongs_to'>belongs_to</span> <span class='symbol'>:user</span>
-<span class='kw'>end</span>
-<span class='kw'>class</span> <span class='const'>Orders</span><span class='op'>::</span><span class='const'>CompletePurchase</span><span class='op'>::</span><span class='const'>Service</span> <span class='op'>&lt;</span> <span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Base.html" title="Servus::Base (class)">Base</a></span></span>
-  <span class='comment'># Service handles orchestration
-</span>  <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>order_id:</span><span class='rparen'>)</span>
-    <span class='ivar'>@order_id</span> <span class='op'>=</span> <span class='id identifier rubyid_order_id'>order_id</span>
-  <span class='kw'>end</span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_call'>call</span>
-    <span class='id identifier rubyid_order'>order</span> <span class='op'>=</span> <span class='const'>Order</span><span class='period'>.</span><span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='ivar'>@order_id</span><span class='rparen'>)</span>
-    <span class='const'>Payments</span><span class='op'>::</span><span class='const'>Charge</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='label'>order_id:</span> <span class='id identifier rubyid_order'>order</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
-    <span class='const'>Inventory</span><span class='op'>::</span><span class='const'>Update</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='label'>order_id:</span> <span class='id identifier rubyid_order'>order</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
-    <span class='const'>Mailers</span><span class='op'>::</span><span class='const'>SendConfirmation</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='label'>order_id:</span> <span class='id identifier rubyid_order'>order</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_success'>success</span><span class='lparen'>(</span><span class='label'>order:</span> <span class='id identifier rubyid_order'>order</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<h2 id="replacing-callbacks">Replacing Callbacks</h2>
-<p>Extract callback logic to explicit service calls:</p>
-<p><strong>Before</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>User</span> <span class='op'>&lt;</span> <span class='const'>ApplicationRecord</span>
-  <span class='id identifier rubyid_after_create'>after_create</span> <span class='symbol'>:send_welcome_email</span>
-  <span class='id identifier rubyid_after_create'>after_create</span> <span class='symbol'>:create_default_account</span>
-  <span class='id identifier rubyid_after_update'>after_update</span> <span class='symbol'>:notify_changes</span><span class='comma'>,</span> <span class='label'>if:</span> <span class='symbol'>:email_changed?</span>
-<span class='kw'>end</span>
-</code></pre>
-<p><strong>After</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>User</span> <span class='op'>&lt;</span> <span class='const'>ApplicationRecord</span>
-  <span class='comment'># Minimal or no callbacks
-</span><span class='kw'>end</span>
-<span class='kw'>class</span> <span class='const'>Users</span><span class='op'>::</span><span class='const'>Create</span><span class='op'>::</span><span class='const'>Service</span> <span class='op'>&lt;</span> <span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Base.html" title="Servus::Base (class)">Base</a></span></span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_call'>call</span>
-    <span class='id identifier rubyid_user'>user</span> <span class='op'>=</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span><span class='lparen'>(</span><span class='id identifier rubyid_params'>params</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_send_welcome_email'>send_welcome_email</span><span class='lparen'>(</span><span class='id identifier rubyid_user'>user</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_create_default_account'>create_default_account</span><span class='lparen'>(</span><span class='id identifier rubyid_user'>user</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_success'>success</span><span class='lparen'>(</span><span class='label'>user:</span> <span class='id identifier rubyid_user'>user</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<h2 id="migrating-background-jobs">Migrating Background Jobs</h2>
-<p>Extract job logic to services, call via <code>.call_async</code>:</p>
-<p><strong>Before</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>ProcessOrderJob</span> <span class='op'>&lt;</span> <span class='const'>ApplicationJob</span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_perform'>perform</span><span class='lparen'>(</span><span class='id identifier rubyid_order_id'>order_id</span><span class='rparen'>)</span>
-    <span class='comment'># 50 lines of business logic
-</span>  <span class='kw'>end</span>
-<span class='kw'>end</span>
-<span class='const'>ProcessOrderJob</span><span class='period'>.</span><span class='id identifier rubyid_perform_later'>perform_later</span><span class='lparen'>(</span><span class='id identifier rubyid_order'>order</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
-</code></pre>
-<p><strong>After</strong>:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>Orders</span><span class='op'>::</span><span class='const'>Process</span><span class='op'>::</span><span class='const'>Service</span> <span class='op'>&lt;</span> <span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Base.html" title="Servus::Base (class)">Base</a></span></span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>order_id:</span><span class='rparen'>)</span>
-    <span class='ivar'>@order_id</span> <span class='op'>=</span> <span class='id identifier rubyid_order_id'>order_id</span>
-  <span class='kw'>end</span>
-  <span class='kw'>def</span> <span class='id identifier rubyid_call'>call</span>
-    <span class='comment'># Business logic
-</span>  <span class='kw'>end</span>
-<span class='kw'>end</span>
-<span class='const'>Orders</span><span class='op'>::</span><span class='const'>Process</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call_async'>call_async</span><span class='lparen'>(</span><span class='label'>order_id:</span> <span class='id identifier rubyid_order'>order</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span>
-</code></pre>
-<p>Now the service can be called synchronously (from console, tests) or asynchronously (from controllers, jobs).</p>
-<h2 id="testing-during-migration">Testing During Migration</h2>
-<p>Keep existing tests working while adding service tests:</p>
-<pre class="code ruby"><code class="ruby"><span class='comment'># Keep existing controller test
-</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>OrdersController</span> <span class='kw'>do</span>
-  <span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>creates order</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-    <span class='id identifier rubyid_post'>post</span> <span class='symbol'>:create</span><span class='comma'>,</span> <span class='label'>params:</span> <span class='id identifier rubyid_params'>params</span>
-    <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be_successful'>be_successful</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-<span class='comment'># Add service test
-</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>Orders</span><span class='op'>::</span><span class='const'>Create</span><span class='op'>::</span><span class='const'>Service</span> <span class='kw'>do</span>
-  <span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>creates order</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-    <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='id identifier rubyid_described_class'>described_class</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_params'>params</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_success?'>success?</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be'>be</span> <span class='kw'>true</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<p>Remove legacy tests after service tests prove comprehensive.</p>
-</div></div>
-      <div id="footer">
-  Generated on Fri Nov 21 00:33:23 2025 by
-  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.4.4).
-</div>
-    </div>
-  </body>
-</html>

data/docs/yard/file.2_testing.html DELETED Viewed

@@ -1,227 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>
-  File: Integration / 2. Testing
-    &mdash; Servus | Service Object Framework
-</title>
-  <link rel="stylesheet" href="css/style.css" type="text/css" />
-  <link rel="stylesheet" href="css/common.css" type="text/css" />
-<script type="text/javascript">
-  pathId = "2_testing";
-  relpath = '';
-</script>
-  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
-  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
-  </head>
-  <body>
-    <div class="nav_wrap">
-      <iframe id="nav" src="file_list.html?1"></iframe>
-      <div id="resizer"></div>
-    </div>
-    <div id="main" tabindex="-1">
-      <div id="header">
-        <div id="menu">
-    <a href="_index.html">Index</a> &raquo;
-    <span class="title">File: Integration / 2. Testing</span>
-</div>
-        <div id="search">
-    <a class="full_list_link" id="class_list_link"
-        href="class_list.html">
-        <svg width="24" height="24">
-          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
-          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
-          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
-        </svg>
-    </a>
-</div>
-        <div class="clear"></div>
-      </div>
-      <div id="content"><div id='filecontents'><h1 id="testing">Testing</h1>
-<p>Services are designed for easy testing with explicit inputs (arguments) and outputs (Response objects). No special test infrastructure needed.</p>
-<h2 id="schema-example-helpers">Schema Example Helpers</h2>
-<p>Servus provides test helpers that extract <code>example</code> values from your JSON schemas, making it easy to generate test fixtures without maintaining separate factories.</p>
-<h3 id="setup">Setup</h3>
-<p>Include the helpers in your test suite:</p>
-<pre class="code ruby"><code class="ruby"><span class='comment'># spec/spec_helper.rb
-</span><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>servus/testing</span><span class='tstring_end'>&#39;</span></span>
-<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_configure'>configure</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_config'>config</span><span class='op'>|</span>
-  <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_include'>include</span> <span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Testing.html" title="Servus::Testing (module)">Testing</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Testing/ExampleBuilders.html" title="Servus::Testing::ExampleBuilders (module)">ExampleBuilders</a></span></span>
-<span class='kw'>end</span>
-</code></pre>
-<h3 id="using-schema-examples">Using Schema Examples</h3>
-<p>Add <code>example</code> or <code>examples</code> keywords to your schemas:</p>
-<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span> <span class='op'>&lt;</span> <span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Base.html" title="Servus::Base (class)">Base</a></span></span>
-  <span class='id identifier rubyid_schema'>schema</span><span class='lparen'>(</span>
-    <span class='label'>arguments:</span> <span class='lbrace'>{</span>
-      <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>object</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
-      <span class='label'>properties:</span> <span class='lbrace'>{</span>
-        <span class='label'>user_id:</span> <span class='lbrace'>{</span> <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>integer</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>example:</span> <span class='int'>123</span> <span class='rbrace'>}</span><span class='comma'>,</span>
-        <span class='label'>amount:</span> <span class='lbrace'>{</span> <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>number</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>example:</span> <span class='float'>100.0</span> <span class='rbrace'>}</span><span class='comma'>,</span>
-        <span class='label'>currency:</span> <span class='lbrace'>{</span> <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>string</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>examples:</span> <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>EUR</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>GBP</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='rbrace'>}</span>
-      <span class='rbrace'>}</span>
-    <span class='rbrace'>}</span><span class='comma'>,</span>
-    <span class='label'>result:</span> <span class='lbrace'>{</span>
-      <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>object</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
-      <span class='label'>properties:</span> <span class='lbrace'>{</span>
-        <span class='label'>transaction_id:</span> <span class='lbrace'>{</span> <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>string</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>example:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>txn_abc123</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
-        <span class='label'>status:</span> <span class='lbrace'>{</span> <span class='label'>type:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>string</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>example:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>approved</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span>
-      <span class='rbrace'>}</span>
-    <span class='rbrace'>}</span>
-  <span class='rparen'>)</span>
-<span class='kw'>end</span>
-</code></pre>
-<p>Then use the helpers in your tests:</p>
-<pre class="code ruby"><code class="ruby"><span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span> <span class='kw'>do</span>
-  <span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>processes payment successfully</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-    <span class='comment'># Extract examples from schema and override specific values
-</span>    <span class='id identifier rubyid_args'>args</span> <span class='op'>=</span> <span class='id identifier rubyid_servus_arguments_example'>servus_arguments_example</span><span class='lparen'>(</span><span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span><span class='comma'>,</span> <span class='label'>amount:</span> <span class='float'>50.0</span><span class='rparen'>)</span>
-    <span class='comment'># =&gt; { user_id: 123, amount: 50.0, currency: &quot;USD&quot; }
-</span>
-    <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='op'>**</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be_success'>be_success</span>
-    <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_match_array'>match_array</span><span class='lparen'>(</span>
-      <span class='id identifier rubyid_servus_result_example'>servus_result_example</span><span class='lparen'>(</span><span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span>
-    <span class='rparen'>)</span>
-  <span class='kw'>end</span>
-  <span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>handles different currencies</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-    <span class='qwords_beg'>%w[</span><span class='tstring_content'>USD</span><span class='words_sep'> </span><span class='tstring_content'>EUR</span><span class='words_sep'> </span><span class='tstring_content'>GBP</span><span class='tstring_end'>]</span></span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_currency'>currency</span><span class='op'>|</span>
-      <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span>
-        <span class='op'>**</span><span class='id identifier rubyid_servus_arguments_example'>servus_arguments_example</span><span class='lparen'>(</span><span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span><span class='comma'>,</span> <span class='label'>currency:</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span>
-      <span class='rparen'>)</span>
-      <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be_success'>be_success</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<h3 id="deep-merging">Deep Merging</h3>
-<p>Overrides are deep-merged with schema examples, allowing you to override nested values:</p>
-<pre class="code ruby"><code class="ruby"><span class='comment'># Schema has nested structure
-</span><span class='id identifier rubyid_args'>args</span> <span class='op'>=</span> <span class='id identifier rubyid_servus_arguments_example'>servus_arguments_example</span><span class='lparen'>(</span>
-  <span class='const'>CreateUser</span><span class='op'>::</span><span class='const'>Service</span><span class='comma'>,</span>
-  <span class='label'>user:</span> <span class='lbrace'>{</span> <span class='label'>profile:</span> <span class='lbrace'>{</span> <span class='label'>age:</span> <span class='int'>35</span> <span class='rbrace'>}</span> <span class='rbrace'>}</span>
-<span class='rparen'>)</span>
-<span class='comment'># =&gt; { user: { id: 1, profile: { name: &#39;Alice&#39;, age: 35 } } }
-</span></code></pre>
-<h3 id="available-helpers">Available Helpers</h3>
-<ul>
-<li><code>servus_arguments_example(ServiceClass, **overrides)</code> - Returns hash of argument examples</li>
-<li><code>servus_result_example(ServiceClass, **overrides)</code> - Returns Response object with result examples</li>
-</ul>
-<h2 id="basic-testing-pattern">Basic Testing Pattern</h2>
-<pre class="code ruby"><code class="ruby"><span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>ProcessPayment</span><span class='op'>::</span><span class='const'>Service</span> <span class='kw'>do</span>
-  <span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>.call</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-    <span class='id identifier rubyid_let'>let</span><span class='lparen'>(</span><span class='symbol'>:user</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='id identifier rubyid_create'>create</span><span class='lparen'>(</span><span class='symbol'>:user</span><span class='comma'>,</span> <span class='label'>balance:</span> <span class='int'>1000</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
-    <span class='id identifier rubyid_subject'>subject</span><span class='lparen'>(</span><span class='symbol'>:result</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='id identifier rubyid_described_class'>described_class</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='label'>user_id:</span> <span class='id identifier rubyid_user'>user</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='comma'>,</span> <span class='label'>amount:</span> <span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
-    <span class='id identifier rubyid_context'>context</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>with sufficient balance</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-      <span class='id identifier rubyid_let'>let</span><span class='lparen'>(</span><span class='symbol'>:amount</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='int'>50</span> <span class='rbrace'>}</span>
-      <span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>processes payment</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-        <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_success?'>success?</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be'>be</span> <span class='kw'>true</span>
-        <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='lbracket'>[</span><span class='symbol'>:new_balance</span><span class='rbracket'>]</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_eq'>eq</span><span class='lparen'>(</span><span class='int'>950</span><span class='rparen'>)</span>
-        <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_reload'>reload</span><span class='period'>.</span><span class='id identifier rubyid_balance'>balance</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_eq'>eq</span><span class='lparen'>(</span><span class='int'>950</span><span class='rparen'>)</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-    <span class='id identifier rubyid_context'>context</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>with insufficient balance</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-      <span class='id identifier rubyid_let'>let</span><span class='lparen'>(</span><span class='symbol'>:amount</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='int'>2000</span> <span class='rbrace'>}</span>
-      <span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>returns failure</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-        <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_success?'>success?</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be'>be</span> <span class='kw'>false</span>
-        <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_eq'>eq</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Insufficient funds</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-        <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be_a'>be_a</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Support.html" title="Servus::Support (module)">Support</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Support/Errors.html" title="Servus::Support::Errors (module)">Errors</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Support/Errors/ServiceError.html" title="Servus::Support::Errors::ServiceError (class)">ServiceError</a></span></span><span class='rparen'>)</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-</code></pre>
-<h2 id="testing-service-composition">Testing Service Composition</h2>
-<p>When testing services that call other services, mock the child services:</p>
-<pre class="code ruby"><code class="ruby">describe Users::CreateWithAccount::Service do
-  # Make local or global helpers to clean up tests
-  def servus_success_result(data)
-    Servus::Support::Response.new(success: true, data: data, error: nil)
-  end
-  it &quot;calls both create services&quot; do
-    # Mock child services
-    allow(Users::Create::Service).to receive(:call).and_return(servus_success_result{ user: user })
-    allow(Accounts::Create::Service).to receive(:call).and_return(servus_success_result{ account: account })
-    result = described_class.call(email: &quot;test@example.com&quot;, plan: &quot;premium&quot;)
-    expect(Users::Create::Service).to have_received(:call)
-    expect(Accounts::Create::Service).to have_received(:call)
-    expect(result.success?).to be true
-  end
-end
-</code></pre>
-<h2 id="testing-schema-validation">Testing Schema Validation</h2>
-<p>Don&#39;t test that valid arguments pass validation - that&#39;s testing the framework. Do test that your schema catches invalid inputs:</p>
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>validates required fields</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>do</span>
-  <span class='id identifier rubyid_expect'>expect</span> <span class='lbrace'>{</span>
-    <span class='const'>Service</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='label'>invalid:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>params</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-  <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_raise_error'>raise_error</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="Servus.html" title="Servus (module)">Servus</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Support.html" title="Servus::Support (module)">Support</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Support/Errors.html" title="Servus::Support::Errors (module)">Errors</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Servus/Support/Errors/ValidationError.html" title="Servus::Support::Errors::ValidationError (class)">ValidationError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>required</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span>
-<span class='kw'>end</span>
-</code></pre>
-</div></div>
-      <div id="footer">
-  Generated on Fri Nov 21 00:33:23 2025 by
-  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.4.4).
-</div>
-    </div>
-  </body>
-</html>