cosmonats 0.7.0 → 0.8.0

data/lib/cosmo/web/views/jobs/_processes.erb

@@ -1,5 +1,6 @@
 <% nav = @polling ? { limit: @limit } : { limit: @limit, poll: 0 } -%>
 <% states = { "running" => "badge-success", "quiet" => "badge-warning", "stopping" => "badge-danger" } -%>
+<% kinds = { "jobs" => "Jobs", "streams" => "Streams", "jobs+streams" => "Jobs & Streams", "none" => "No subscriptions" } -%>
 <div id="processes-poller"
      <% if @polling -%>
      hx-get="<%= url_for('/jobs/_processes', page: @page, limit: @limit) %>"
@@ -27,7 +28,7 @@
     </span>
   </div>
 
-  <% if @processes.empty? -%>
+  <% if @groups.empty? -%>
     <div class="alert alert-warning">No worker processes are running</div>
   <% else -%>
     <div class="table-container">
@@ -47,44 +48,57 @@
           </tr>
         </thead>
         <tbody>
-          <% @processes.each do |process| -%>
-          <% nats = Hash(process[:nats]) -%>
-          <tr>
-            <td>
-              <div class="job-class"><%= h(process[:hostname]) %>:<%= h(process[:pid]) %></div>
-              <div class="text-muted" style="font-size: var(--font-size-small);">
-                <%= h(nats[:ip] || "unknown IP") %>
-                <% if nats[:name] -%>&middot; <code><%= h(nats[:name]) %></code><% end -%>
-              </div>
-            </td>
-            <td>
-              <% cmdline = process[:cmdline].to_s -%>
-              <div class="job-id">
-                <details>
-                  <summary>
-                    <code><%= h(cmdline.length > 40 ? "#{cmdline[0, 40]}…" : cmdline) %></code>
-                  </summary>
-                  <code style="font-size: var(--font-size-small);"><%= h(cmdline) %></code>
+          <% @groups.each do |kind, group| -%>
+            <tr class="group-row">
+              <td colspan="10"><%= h(kinds.fetch(kind, kind)) %> <span class="text-muted">(<%= group.size %>)</span></td>
+            </tr>
+            <% group.each do |process| -%>
+            <% nats = Hash(process[:nats]) -%>
+            <tr>
+              <td>
+                <div class="job-class"><%= h(process[:hostname]) %>:<%= h(process[:pid]) %></div>
+                <div class="text-muted" style="font-size: var(--font-size-small);">
+                  <%= h(nats[:ip] || "unknown IP") %>
+                  <% if nats[:name] -%>&middot; <code><%= h(nats[:name]) %></code><% end -%>
+                </div>
+              </td>
+              <td>
+                <% cmdline = process[:cmdline].to_s -%>
+                <div class="job-id">
+                  <% if cmdline.length > 32 -%>
+                    <details>
+                      <summary>
+                        <code class="truncate" title="<%= h(cmdline) %>"><%= h(cmdline) %></code>
+                      </summary>
+                      <code style="font-size: var(--font-size-small);"><%= h(cmdline) %></code>
+                    </details>
+                  <% else -%>
+                    <code style="font-size: var(--font-size-small);"><%= h(cmdline) %></code>
+                  <% end -%>
                   <div class="text-muted" style="font-size: var(--font-size-small);">
                     cosmo <%= h(process[:version]) %> &middot; <%= h(process[:ruby]) %>
                     <% if process[:http_port] -%>&middot; http :<%= h(process[:http_port]) %><% end -%>
                   </div>
-                </details>
-              </div>
-            </td>
-            <td>
-              <% Hash(process[:subscriptions]).each do |type, names| -%>
-                <div><span class="text-muted"><%= h(type) %>:</span> <code><%= h(Array(names).join(", ")) %></code></div>
-              <% end -%>
-            </td>
-            <td><%= h(process[:busy]) %> / <%= h(process[:concurrency]) %></td>
-            <td><span class="badge <%= states.fetch(process[:state].to_s, 'badge-info') %>"><%= h(process[:state]) %></span></td>
-            <td><%= nats[:rtt] ? "#{h(nats[:rtt])}ms" : '&mdash;' %></td>
-            <td><%= h(nats[:reconnects].to_i) %></td>
-            <td><%= process[:rss] ? format_bytes(process[:rss].to_i * 1024) : '&mdash;' %></td>
-            <td><%= elapsed(process[:started_at]) %></td>
-            <td><%= elapsed(process[:beat_at]) %> ago</td>
-          </tr>
+                </div>
+              </td>
+              <td>
+                <% Hash(process[:subscriptions]).each do |type, names| -%>
+                  <% next if Array(names).empty? -%>
+                  <div>
+                    <% if kind == "jobs+streams" -%><span class="text-muted"><%= h(type) %>:</span><% end -%>
+                    <code><%= h(Array(names).join(", ")) %></code>
+                  </div>
+                <% end -%>
+              </td>
+              <td><%= h(process[:busy]) %> / <%= h(process[:concurrency]) %></td>
+              <td><span class="badge <%= states.fetch(process[:state].to_s, 'badge-info') %>"><%= h(process[:state]) %></span></td>
+              <td><%= nats[:rtt] ? "#{h(nats[:rtt])}ms" : '&mdash;' %></td>
+              <td><%= h(nats[:reconnects].to_i) %></td>
+              <td><%= process[:rss] ? format_bytes(process[:rss].to_i * 1024) : '&mdash;' %></td>
+              <td><%= elapsed(process[:started_at]) %></td>
+              <td><%= elapsed(process[:beat_at]) %> ago</td>
+            </tr>
+            <% end -%>
           <% end -%>
         </tbody>
       </table>

data/lib/cosmo/web/views/jobs/_stats.erb

@@ -34,6 +34,7 @@
          class="<%= 'active' if referrer?('/jobs/enqueued') %>">&#x1F4EC; Enqueued</a>
     </p>
   </article>
+<% if Cosmo::Config.scheduled.enabled -%>
   <article class="stat-card">
     <h3><%= format_numbers(@scheduled) %></h3>
     <p>
@@ -45,6 +46,8 @@
          class="<%= 'active' if referrer?('/jobs/scheduled') %>">&#x23F0; Scheduled</a>
     </p>
   </article>
+<% end -%>
+<% if Cosmo::Config.dead.enabled -%>
   <article class="stat-card">
     <h3><%= format_numbers(@dead) %></h3>
     <p>
@@ -56,6 +59,7 @@
          class="<%= 'active' if referrer?('/jobs/dead') %>">&#x1F480; Dead</a>
     </p>
   </article>
+<% end -%>
 </div>
 
 <script>

data/lib/cosmo/web/views/jobs/_tabs.erb

@@ -3,6 +3,12 @@
      class="<%= 'active' if path_prefix?('/jobs') %>">&#x1F4CB; Dashboard</a>
   <a href="<%= url_for('/batches') %>"
      class="<%= 'active' if path_prefix?('/batches') %>">&#x1F4E6; Batches</a>
+<% if Cosmo::Config.scheduled.enabled -%>
   <a href="<%= url_for('/crons') %>"
      class="<%= 'active' if path_prefix?('/crons') %>">&#x23F0; Crons</a>
+<% end -%>
+<% if Cosmo::Config.metrics.enabled -%>
+  <a href="<%= url_for('/metrics') %>"
+     class="<%= 'active' if path_prefix?('/metrics') %>">&#x1F4CA; Metrics</a>
+<% end -%>
 </nav>

data/lib/cosmo/web/views/jobs/index.erb

@@ -9,7 +9,7 @@
 
   <div id="content">
     <div id="processes-poller"
-         hx-get="<%= url_for('/jobs/_processes') %>"
+         hx-get="<%= url_for('/jobs/_processes', (@processes_query unless @processes_query.empty?)) %>"
          hx-trigger="load"
          hx-swap="outerHTML">
       <div class="alert alert-info">Loading processes&hellip;</div>

data/lib/cosmo/web/views/layout.erb

@@ -14,7 +14,7 @@
         <a href="<%= url_for('/jobs') %>" class="navbar-brand">🚀 Cosmo</a>
         <ul class="nav-list">
           <li>
-            <a href="<%= url_for('/jobs') %>" class="<%= "active" if path_prefix?('/jobs', '/crons', '/batches') %>">Jobs</a>
+            <a href="<%= url_for('/jobs') %>" class="<%= "active" if path_prefix?('/jobs', '/crons', '/batches', '/metrics') %>">Jobs</a>
           </li>
           <li>
             <a href="<%= url_for('/streams') %>" class="<%= "active" if current_page?('/streams') %>">Streams</a>

data/lib/cosmo/web/views/metrics/_chart.erb

@@ -0,0 +1,36 @@
+<div class="metrics-chart">
+  <div class="metrics-chart-header">
+    <span><code><%= h(@job) %></code> <span class="text-muted">last <%= @days %> days</span></span>
+    <span class="metrics-legend">
+      <span class="metrics-legend-runs">runs per day</span>
+      <span class="metrics-legend-exec">avg execution (ms)</span>
+    </span>
+  </div>
+  <% if @chart.empty? -%>
+    <div class="alert alert-info">No runs of <code><%= h(@job) %></code> in this period.</div>
+  <% else -%>
+    <svg viewBox="0 0 <%= Cosmo::Web::Chart::WIDTH %> <%= Cosmo::Web::Chart::HEIGHT %>" role="img"
+         aria-label="Runs per day and average execution time of <%= h(@job) %>">
+      <% @chart.ticks.each do |tick| -%>
+        <line class="chart-grid" x1="<%= Cosmo::Web::Chart::LEFT %>" x2="<%= Cosmo::Web::Chart::RIGHT %>"
+              y1="<%= tick[:y] %>" y2="<%= tick[:y] %>"/>
+        <text class="chart-axis" x="<%= Cosmo::Web::Chart::LEFT - 6 %>" y="<%= tick[:y] + 4 %>"
+              text-anchor="end"><%= format_numbers(tick[:count]) %></text>
+        <text class="chart-axis chart-axis-exec" x="<%= Cosmo::Web::Chart::RIGHT + 6 %>" y="<%= tick[:y] + 4 %>"
+              text-anchor="start"><%= format_numbers(tick[:exec_ms]) %></text>
+      <% end -%>
+      <% @chart.bars.each do |bar| -%>
+        <rect class="chart-bar" x="<%= bar[:x] %>" y="<%= bar[:y] %>" width="<%= bar[:width] %>"
+              height="<%= bar[:height] %>"><title><%= h(bar[:title]) %></title></rect>
+      <% end -%>
+      <polyline class="chart-line" points="<%= @chart.line %>"/>
+      <% @chart.points.each do |point| -%>
+        <circle class="chart-point" cx="<%= point[:x] %>" cy="<%= point[:y] %>" r="4"><title><%= h(point[:title]) %></title></circle>
+      <% end -%>
+      <% @chart.labels.each do |label| -%>
+        <text class="chart-axis" x="<%= label[:x] %>" y="<%= Cosmo::Web::Chart::BOTTOM + 18 %>"
+              text-anchor="middle"><%= label[:text] %></text>
+      <% end -%>
+    </svg>
+  <% end -%>
+</div>

data/lib/cosmo/web/views/metrics/_panel.erb

@@ -0,0 +1,13 @@
+<div id="metrics-panel"
+     hx-get="<%= url_for('/metrics/_panel', { days: @days, job: u(@job) }) %>"
+     hx-trigger="every 30s"
+     hx-swap="outerHTML">
+  <% if @rows.empty? -%>
+    <div class="alert alert-success">No metrics recorded in this period.</div>
+  <% else -%>
+    <% if @chart -%>
+      <%= render('metrics/_chart', { job: @job, days: @days, chart: @chart }) %>
+    <% end -%>
+    <%= render('metrics/_table', { rows: @rows, job: @job, days: @days }) %>
+  <% end -%>
+</div>

data/lib/cosmo/web/views/metrics/_table.erb

@@ -0,0 +1,41 @@
+<% selectable = @days > 1 -%>
+<% if selectable -%>
+  <p class="metrics-hint">Click a job to chart it.</p>
+<% end -%>
+<div class="table-container">
+  <table class="metrics-table">
+    <thead>
+      <tr>
+        <th>Job</th>
+        <th>Runs</th>
+        <th>Failed</th>
+        <th>Avg execution</th>
+        <th>Avg wait</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @rows.each do |row| -%>
+        <% selected = selectable && row[:job] == @job -%>
+        <tr<% if selectable -%>
+            class="selectable<%= ' selected' if selected %>"
+            hx-get="<%= url_for('/metrics/_panel', { days: @days, job: u(row[:job]) }) %>"
+            hx-target="#metrics-panel"
+            hx-swap="outerHTML"
+            <% if selected -%>aria-selected="true"<% end -%>
+          <% end -%>>
+          <td><code><%= h(row[:job]) %></code></td>
+          <td><%= format_numbers(row[:count]) %></td>
+          <td>
+            <% if row[:failed].positive? -%>
+              <span class="badge badge-danger"><%= format_numbers(row[:failed]) %></span>
+            <% else -%>
+              <span class="text-muted">0</span>
+            <% end -%>
+          </td>
+          <td><%= duration(row[:exec_ms]) %></td>
+          <td><%= duration(row[:wait_ms]) %></td>
+        </tr>
+      <% end -%>
+    </tbody>
+  </table>
+</div>

data/lib/cosmo/web/views/metrics/index.erb

@@ -0,0 +1,17 @@
+<section>
+  <header><%= render('jobs/_tabs') %></header>
+
+  <div class="nav">
+    <% @ranges.each do |range, name| -%>
+      <a href="<%= url_for('/metrics', { days: range }) %>"
+         class="btn <%= 'btn-primary' if @days == range %>"><%= h(name) %></a>
+    <% end -%>
+  </div>
+
+  <div id="metrics-panel"
+       hx-get="<%= url_for('/metrics/_panel', { days: @days }) %>"
+       hx-trigger="load"
+       hx-swap="outerHTML">
+    <div class="alert alert-info">Loading metrics&hellip;</div>
+  </div>
+</section>

data/lib/cosmo/web.rb

@@ -11,6 +11,7 @@ require "cosmo/web/controllers/streams"
 require "cosmo/web/controllers/actions"
 require "cosmo/web/controllers/crons"
 require "cosmo/web/controllers/batches"
+require "cosmo/web/controllers/metrics"
 
 module Cosmo
   class Web
@@ -51,6 +52,8 @@ module Cosmo
                  in [:get,    "/crons/_table"]          then [Controllers::Crons,   :_table]
                  in [:delete, "/crons/delete"]          then [Controllers::Crons,   :delete]
                  in [:post,   "/crons/run"]             then [Controllers::Crons,   :run_now]
+                 in [:get,    "/metrics"]               then [Controllers::Metrics, :index]
+                 in [:get,    "/metrics/_panel"]        then [Controllers::Metrics, :_panel]
                  in [:get,    "/batches"]               then [Controllers::Batches, :index]
                  in [:get,    "/batches/_table"]        then [Controllers::Batches, :_table]
                  in [:get,    "/actions"]               then [Controllers::Actions, :index]

data/lib/cosmo.rb

@@ -14,6 +14,8 @@ require "cosmo/cli"
 require "cosmo/heartbeat"
 require "cosmo/engine"
 require "cosmo/api"
+require "cosmo/middleware"
+require "cosmo/services"
 require "cosmo/railtie" if defined?(Rails::Railtie)
 
 module Cosmo
@@ -22,18 +24,54 @@ module Cosmo
   # Optional, requires rack and webrick gems. Loaded only when an HTTP port is configured.
   autoload :HTTPServer, "cosmo/http_server"
 
+  # Programmatic setup, typically from an initializer:
+  #
+  #   Cosmo.configure do |config|
+  #     config.logger = Rails.logger
+  #     config.log_level = :debug
+  #     config.server_middleware { |c| c.add MyMiddleware }
+  #   end
+  #
+  # @yieldparam config [Config] the {Config} singleton
+  # @return [void]
+  def self.configure
+    yield Config.instance
+  end
+
+  # Hands +error+ to every handler in {Config#error_handlers}. A handler that raises is logged and skipped, so error
+  # reporting never breaks processing.
+  #
+  # @param error [Exception]
+  # @param context [Hash] where it happened, see {Config#error_handlers}
+  # @return [void]
+  def self.handle_error(error, context)
+    Config.error_handlers.each do |handler|
+      handler.call(error, context)
+    rescue StandardError => e
+      Logger.error "Error handler failed: #{e.class}: #{e.message}"
+    end
+  end
+
   class Error < StandardError; end
 
   class ArgumentError < Error; end
 
   class NotImplementedError < Error; end
 
+  class ConfigError < Error; end
+
   class ConfigNotFoundError < Error
     def initialize(config_file)
       super("No such file #{config_file}")
     end
   end
 
+  class SchedulingDisabledError < Error
+    def initialize
+      super("Scheduling is turned off (config.scheduled.enabled = false), so delayed jobs and crons are unavailable")
+    end
+  end
+
   class StreamNotFoundError < Error
     def initialize(stream_name)
       super("Missing stream `#{stream_name}`")

data/sig/cosmo/api/counter.rbs

@@ -1,13 +1,12 @@
 module Cosmo
   module API
     class Counter
-      STREAM_NAME: ::String
-      STREAM_CONFIG: Hash[Symbol, untyped]
-
       @namespace: ::String
 
       def self.setup!: () -> void
 
+      def self.stream_config: () -> Hash[Symbol, untyped]
+
       def initialize: (::String namespace) -> void
 
       def increment: (Symbol key, ?by: ::Integer) -> ::Integer

data/sig/cosmo/api/stats/busy.rbs

@@ -12,7 +12,7 @@ module Cosmo
 
         def initialize: () -> void
 
-        def with: (untyped message) { () -> void } -> void
+        def with: [T] (untyped message) { () -> T } -> T
 
         def add: (untyped message) -> void
 

data/sig/cosmo/api/stats/metrics.rbs

@@ -0,0 +1,42 @@
+module Cosmo
+  module API
+    module Stats
+      class Metrics < Counter
+        STREAM_NAME: ::String
+        DESCRIPTION: ::String
+        DAY: Integer
+
+        self.@instance: Metrics
+
+        @lock: Thread::Mutex
+        @buffer: Hash[[::String, ::String], Hash[Symbol, Numeric]]
+
+        def self.instance: () -> Metrics
+
+        def self.stream_config: () -> Hash[Symbol, untyped]
+
+        def initialize: () -> void
+
+        def record: (::String job_class, ?exec_ms: Numeric?, ?wait_ms: Numeric?, ?failed: bool) -> void
+
+        def flush: () -> void
+
+        def summary: (?days: Integer) -> Array[Hash[Symbol, untyped]]
+
+        def daily: (::String job_class, ?days: Integer) -> Array[Hash[Symbol, untyped]]
+
+        private
+
+        def buffer: () -> Hash[[::String, ::String], Hash[Symbol, Numeric]]
+
+        def read: (Integer days) -> Array[[[::String, ::String, Symbol], Integer]]
+
+        def dates: (Integer days) -> Array[::String]
+
+        def row: (Hash[Symbol, Numeric] sums) -> Hash[Symbol, untyped]
+
+        def average: (Numeric total, Numeric count) -> Float?
+      end
+    end
+  end
+end

data/sig/cosmo/api/stats/processes.rbs

@@ -4,6 +4,9 @@ module Cosmo
       class Processes < Registry
         TTL: ::Integer
         BUCKET: ::String
+        KINDS: Array[::String]
+
+        def self.kind: (Hash[Symbol, untyped] process) -> ::String
 
         def list: (?page: ::Integer?, ?limit: ::Integer) -> Array[Hash[Symbol, untyped]]
 

data/sig/cosmo/api/stats/totals.rbs

@@ -2,12 +2,13 @@ module Cosmo
   module API
     module Stats
       class Totals < Counter
+        STREAM_NAME: ::String
+        DESCRIPTION: ::String
+
         self.@instance: Totals
 
         def self.instance: () -> Totals
 
-        def with: () { () -> bool } -> void
-
         def processed: () -> ::Integer
 
         def failed: () -> ::Integer

data/sig/cosmo/batch/counters.rbs

@@ -0,0 +1,10 @@
+module Cosmo
+  class Batch
+    class Counters < API::Counter
+      STREAM_NAME: ::String
+      DESCRIPTION: ::String
+
+      def self.stream_config: () -> Hash[Symbol, untyped]
+    end
+  end
+end

data/sig/cosmo/batch.rbs

@@ -3,17 +3,16 @@ module Cosmo
     extend Dispatcher
 
     BUCKET: ::String
-    DEFAULT_EXPIRY: ::String
     EVENTS: ::Array[Symbol]
 
-    self.@counter: API::Counter
+    self.@counter: Batch::Counters
     self.@kv: API::KV
 
     def self.current: () -> Batch?
 
     def self.notify: (::String bid, ::String jid, success: bool) -> void
 
-    def self.counter: () -> API::Counter
+    def self.counter: () -> Batch::Counters
 
     def self.kv: () -> API::KV
 
@@ -36,7 +35,7 @@ module Cosmo
 
     private
 
-    def counter: () -> API::Counter
+    def counter: () -> Batch::Counters
 
     def kv: () -> API::KV
 

data/sig/cosmo/cli.rbs

@@ -20,6 +20,8 @@ module Cosmo
 
     def load_config: (Hash[Symbol, untyped] flags) -> void
 
+    def run_init: () -> void
+
     def boot_application: () -> void
 
     def require_path: (::String? path) -> void

data/sig/cosmo/client.rbs

@@ -54,6 +54,8 @@ module Cosmo
 
     def get_message: (::String | Symbol name, **untyped options) -> NATS::JetStream::API::RawStreamMsg
 
+    def last_messages: (::String stream_name, Array[::String] filters) -> Hash[::String, ::String]
+
     def delete_message: (::String name, ::Integer seq) -> Hash[::String, untyped]
 
     def purge: (::String stream_name, ::String? subject) -> ::Integer?
@@ -66,6 +68,6 @@ module Cosmo
 
     def ephemeral_subscribe: (::String | Array[::String] subject, Hash[Symbol, untyped] config) -> untyped
 
-    def create_kv_with_msg_ttl: (::String name, **untyped opts) -> untyped
+    def create_kv_with_msg_ttl: (::String name, ?replicas: Integer, **untyped opts) -> untyped
   end
 end

data/sig/cosmo/config/settings.rbs

@@ -0,0 +1,31 @@
+module Cosmo
+  class Config < ::Hash[Symbol, untyped]
+    class Scheduled
+      attr_accessor enabled: bool
+
+      def self.new: (enabled: bool) -> Scheduled
+    end
+
+    class Dead
+      attr_accessor enabled: bool
+      attr_accessor max_age: Numeric | ::String
+      attr_accessor max_msgs: Integer
+      attr_accessor max_bytes: Integer
+
+      def self.new: (enabled: bool, max_age: Numeric | ::String, max_msgs: Integer, max_bytes: Integer) -> Dead
+    end
+
+    class Batches
+      attr_accessor expiry: Numeric | ::String
+
+      def self.new: (expiry: Numeric | ::String) -> Batches
+    end
+
+    class Metrics
+      attr_accessor enabled: bool
+      attr_accessor retention: Numeric | ::String
+
+      def self.new: (enabled: bool, retention: Numeric | ::String) -> Metrics
+    end
+  end
+end

data/sig/cosmo/config.rbs

@@ -2,6 +2,8 @@ module Cosmo
   class Config < ::Hash[Symbol, untyped]
     NANO: Integer
     DEFAULT_PATH: ::String
+    DEFAULTS_FILE: ::String
+    SERVICE_STREAMS: Array[Symbol]
 
     self.@instance: Config
     self.@internal: Hash[Symbol, untyped]
@@ -12,8 +14,14 @@ module Cosmo
 
     def self.to_ns: (Numeric seconds) -> ::Integer
 
+    def self.read: (::String path) -> Hash[Symbol, untyped]
+
     def self.parse_file: (::String path) -> Hash[Symbol, untyped]
 
+    def self.build: (Hash[Symbol, untyped] user) -> Hash[Symbol, untyped]
+
+    def self.validate!: (Hash[Symbol, untyped] config) -> void
+
     def self.normalize!: (Hash[Symbol, untyped] config) -> void
 
     def self.deliver_policy: (Symbol | ::String | Time start_position) -> Hash[Symbol, ::String]
@@ -24,15 +32,61 @@ module Cosmo
 
     def self.dig: (*Symbol keys) -> untyped
 
-    def self.to_h: () -> Hash[Symbol, untyped]
+    def self.load: (?::String? path, ?overrides: Hash[Symbol, untyped]?) -> void
+
+    def self.replicas: () -> Integer
+
+    def self.scheduled: () -> Scheduled
+
+    def self.dead: () -> Dead
+
+    def self.batches: () -> Batches
+
+    def self.metrics: () -> Metrics
+
+    def self.server_middleware: () ?{ (Middleware::Chain chain) -> void } -> Middleware::Chain
+
+    def self.client_middleware: () ?{ (Middleware::Chain chain) -> void } -> Middleware::Chain
+
+    def self.error_handlers: () -> Array[untyped]
+
+    @server_middleware: Middleware::Chain
+
+    def load: (?::String? path, ?overrides: Hash[Symbol, untyped]?) -> void
+
+    def server_middleware: () ?{ (Middleware::Chain chain) -> void } -> Middleware::Chain
+
+    @client_middleware: Middleware::Chain
+
+    def client_middleware: () ?{ (Middleware::Chain chain) -> void } -> Middleware::Chain
+
+    @error_handlers: Array[untyped]
+
+    def error_handlers: () -> Array[untyped]
+
+    @replicas: Integer?
+    @scheduled: Scheduled
+    @dead: Dead
+    @batches: Batches
+
+    attr_writer replicas: Integer
+
+    def replicas: () -> Integer
+
+    def scheduled: () -> Scheduled
+
+    def dead: () -> Dead
+
+    def batches: () -> Batches
 
-    def self.set: (*untyped) -> untyped
+    @metrics: Metrics
 
-    def self.load: (?::String? path) -> void
+    def metrics: () -> Metrics
 
+    def logger: () -> untyped
 
-    def set: (*untyped) -> untyped
+    def logger=: (untyped logger) -> void
 
-    def load: (?::String? path) -> void
+    def log_level=: (Symbol | ::String | Integer level) -> void
   end
 end