cosmonats 0.1.4 → 0.2.0

data/lib/cosmo/web/controllers/actions.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "cosmo/web/controllers/application"
+
+module Cosmo
+  class Web
+    module Controllers
+      class Actions < Application
+        def index
+          content_for :title, "Actions"
+          ok render("actions/index", layout: true)
+        end
+      end
+    end
+  end
+end

data/lib/cosmo/web/controllers/application.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cosmo
+  class Web
+    module Controllers
+      class Application
+        include Renderer
+
+        def initialize(request)
+          @request = request
+        end
+
+        def content_for(name, content)
+          @content_for ||= {}
+          @content_for[name] = content
+        end
+
+        def render(template, locals = nil, layout: false)
+          defaults = { request: @request }
+          locals = Hash(locals).merge(defaults)
+          view = erb(template, locals)
+          return view unless layout
+
+          @content_for ||= {}
+          @content_for[:view] = view
+          erb("layout", defaults, @content_for)
+        end
+
+        def params
+          @request.params
+        end
+
+        def path
+          @request.path
+        end
+
+        def hx_request?
+          @request.get_header("HTTP_HX_REQUEST") == "true"
+        end
+      end
+    end
+  end
+end

data/lib/cosmo/web/controllers/jobs.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require "cosmo/web/controllers/application"
+
+module Cosmo
+  class Web
+    module Controllers
+      class Jobs < Application
+        def index
+          content_for :title, "Jobs"
+          ok render("jobs/index", layout: true)
+        end
+
+        def busy
+          return _busy if hx_request?
+
+          content_for :title, "Busy Jobs"
+          ok render("jobs/busy", layout: true)
+        end
+
+        def enqueued
+          return _enqueued if hx_request?
+
+          content_for :title, "Enqueued Jobs"
+          stream_name, _stream_names = streams
+          ok render("jobs/enqueued", { stream_name: }, layout: true)
+        end
+
+        def scheduled
+          return _scheduled if hx_request?
+
+          content_for :title, "Scheduled Jobs"
+          ok render("jobs/scheduled", layout: true)
+        end
+
+        def dead
+          return _dead if hx_request?
+
+          content_for :title, "Dead Jobs"
+          ok render("jobs/dead", layout: true)
+        end
+
+        def retry
+          seq = path.split("/").last.to_i
+          stream = API::Stream.new("dead")
+          stream.retry(seq)
+          ok
+        end
+
+        def delete
+          seq = path.split("/").last.to_i
+          stream = API::Stream.new("dead")
+          stream.delete(seq)
+          ok
+        end
+
+        def _scheduled
+          stream = API::Stream.new("scheduled")
+          jobs = stream.messages(page: params["page"], limit: params["limit"])
+          ok render("jobs/_scheduled", { jobs: jobs, total: stream.total })
+        end
+
+        def _dead
+          stream = API::Stream.new("dead")
+          jobs = stream.messages(page: params["page"], limit: params["limit"])
+          ok render("jobs/_dead", { jobs: jobs, total: stream.total })
+        end
+
+        def _busy
+          limit = (limit || 25).to_i
+          jobs  = API::Busy.instance.list(limit:)
+          ok render("jobs/_busy", { jobs: jobs, total: API::Busy.instance.size })
+        end
+
+        def _enqueued
+          stream_name, stream_names = streams
+          stream = API::Stream.new(stream_name)
+          jobs = stream.messages(page: params["page"], limit: params["limit"])
+
+          ok render("jobs/_enqueued", { jobs:, total: stream.total, stream_name:, stream_names: })
+        end
+
+        def _stats
+          ok render("jobs/_stats", API::Stats.summary)
+        end
+
+        private
+
+        def streams
+          stream_names = API::Stream.jobs.map(&:name)
+          stream_name = params.fetch("stream_name", stream_names.first)
+          [stream_name, stream_names]
+        end
+      end
+    end
+  end
+end

data/lib/cosmo/web/controllers/streams.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "cosmo/web/controllers/application"
+
+module Cosmo
+  class Web
+    module Controllers
+      class Streams < Application
+        def index
+          return _table if hx_request?
+
+          content_for :title, "Streams"
+          ok render("streams/index", layout: true)
+        end
+
+        def info
+          name = Rack::Utils.unescape(@request.params["name"])
+          return _info if hx_request?
+
+          content_for :title, "Streams"
+          ok render("streams/info", { name: name }, layout: true)
+        end
+
+        def _table
+          streams = API::Stream.all.map do |stream|
+            state, config = stream.info.values
+            { name: stream.name, messages: state.messages, bytes: state.bytes,
+              first_seq: state.first_seq, last_seq: state.last_seq,
+              consumer_count: state.consumer_count,
+              subjects: config.subjects }
+          end
+
+          ok render("streams/_table", { streams: streams })
+        end
+
+        def _info
+          name = Rack::Utils.unescape(@request.params["name"])
+          state = API::Stream.new(name).info.merge(name:)
+          ok render("streams/_info", state)
+        end
+      end
+    end
+  end
+end

data/lib/cosmo/web/helpers/application.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "cosmo/web/renderer"
+
+module Cosmo
+  class Web
+    module Helpers
+      module Application
+        include Renderer
+
+        def format_bytes(bytes)
+          b = bytes.to_i
+          return "0 B" if b.zero?
+
+          sizes = %w[B KB MB GB TB]
+          i = [(Math.log(b) / Math.log(1024)).floor, sizes.size - 1].min
+          "#{(b / (1024.0**i)).round(2)} #{sizes[i]}"
+        end
+
+        def format_numbers(num)
+          num.to_s.reverse.gsub(/(\d{3})(?=\d)/, "\\1,").reverse
+        end
+
+        def format_timestamp(value)
+          return "N/A" unless value
+
+          Time.at(value.to_f).strftime("%Y-%m-%d %H:%M:%S")
+        rescue StandardError
+          value.to_s
+        end
+
+        def elapsed(value)
+          elapsed = Time.now.to_i - value.to_i
+
+          if elapsed < 60
+            "#{elapsed}s"
+          elsif elapsed < 3600
+            "#{elapsed / 60}m #{elapsed % 60}s"
+          else
+            "#{elapsed / 3600}h #{(elapsed % 3600) / 60}m"
+          end
+        end
+
+        def time_until(value)
+          return "N/A" unless value
+
+          diff = value.to_f - Time.now.to_f
+          return "Ready" if diff <= 0
+          return "#{diff.to_i}s" if diff < 60
+          return "#{(diff / 60).to_i}m" if diff < 3_600
+          return "#{(diff / 3_600).to_i}h" if diff < 86_400
+
+          "#{(diff / 86_400).to_i}d"
+        end
+
+        def h(value)
+          Rack::Utils.escape_html(value.to_s)
+        end
+
+        def u(value)
+          Rack::Utils.escape(value.to_s)
+        end
+
+        def current_page?(path)
+          request_path = @request.path_info
+          request_path = "/" if request_path.empty?
+          request_path == url_for(path)
+        end
+
+        def referrer?(path)
+          URI(@request.referrer).path == path
+        end
+      end
+    end
+  end
+end

data/lib/cosmo/web/renderer.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Cosmo
+  class Web
+    module Renderer
+      ASSETS_ROOT = File.expand_path("assets", __dir__).freeze
+      VIEWS_ROOT  = File.expand_path("views",  __dir__).freeze
+
+      def redirect_to(url, status = 302)
+        [status, { "location" => url_for(url) }, []]
+      end
+
+      def serve(filename, content_type, headers = nil)
+        path = File.join(ASSETS_ROOT, filename)
+        return not_found unless File.exist?(path)
+
+        respond_with 200, body: File.read(path), headers: { "content-type" => content_type }.merge(headers || {})
+      end
+
+      def ok(body = "")
+        headers = { "content-type" => "text/html; charset=utf-8" }
+        respond_with 200, body:, headers:
+      end
+
+      def no_content
+        respond_with 204, body: ""
+      end
+
+      def not_found
+        body = "<div class='alert alert-danger'>404 — Not Found</div>"
+        headers = { "content-type" => "text/html; charset=utf-8" }
+        respond_with 404, body:, headers:
+      end
+
+      # Prepend the mount prefix to an internal route.
+      #   url_for("/jobs")  # => "/admin/cosmo/jobs"  (mounted)
+      #   url_for("/jobs")  # => "/jobs"              (standalone)
+      def url_for(path, params = nil)
+        url = "#{@request.script_name}#{path}"
+        url = "#{url}?#{params.to_a.map { _1.join("=") }.join("&")}" if params
+        url
+      end
+
+      private
+
+      def respond_with(status, headers: nil, body: "")
+        [status, Hash(headers), [body]]
+      end
+
+      def erb(path, locals, content_for = nil)
+        path = File.join(VIEWS_ROOT, "#{path}.erb")
+        erb  = ERB.new(File.read(path), trim_mode: "-")
+        context = Context.new(locals, content_for)
+        erb.result(context.binding)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,7 @@
+<section>
+  <header></header>
+
+  <div>
+    <div class="alert alert-info">None</div>
+  </div>
+</section>

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

@@ -0,0 +1,50 @@
+<div class="pending">
+  <span></span>
+  <span class="text-muted"><%= @total %> job(s) running</span>
+</div>
+
+<% if @jobs.empty? -%>
+  <div class="alert alert-success">No jobs are currently running</div>
+<% else -%>
+  <div class="table-container">
+    <table>
+      <thead>
+        <tr>
+          <th>Job</th>
+          <th>JID[Args]</th>
+          <th>Stream</th>
+          <th>Worker</th>
+          <th>Running for</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @jobs.each do |job| -%>
+        <tr>
+          <td>
+            <div class="job-class">
+              <%= h(job.dig(:data, :class).to_s) %>
+            </div>
+          </td>
+          <td>
+            <div class="job-id">
+              <details>
+                <summary>
+                  <code><%= h(job.dig(:data, :jid)) %></code>
+                </summary>
+                <code><%= h(JSON.pretty_generate(job.dig(:data, :args))) %></code>
+              </details>
+            </div>
+          </td>
+          <td>
+            <code><%= h(job[:stream].to_s) %></code>
+          </td>
+          <td><code style="font-size: var(--font-size-small);"><%= h(job[:worker].to_s) %></code></td>
+          <td>
+            <%= elapsed(job[:started_at]) %>
+          </td>
+        </tr>
+        <% end -%>
+      </tbody>
+    </table>
+  </div>
+<% end -%>

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

@@ -0,0 +1,65 @@
+<% if @jobs.empty? -%>
+  <div class="alert alert-success">No dead jobs found</div>
+<% else -%>
+  <div class="table-container">
+    <table>
+      <thead>
+        <tr>
+          <th>Job</th>
+          <th>JID[Args]</th>
+          <th>Stream</th>
+          <th>Error</th>
+          <th>Failed</th>
+          <th>Actions</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @jobs.each do |job| -%>
+        <tr class="dead-row" id="dead-row-<%= job.seq %>">
+          <td>
+            <div class="job-class">
+              <%= h(job.data[:class].to_s) %>
+            </div>
+          </td>
+          <td>
+            <div class="job-id">
+              <details>
+                <summary>
+                  <code><%= h(job.data[:jid].to_s) %></code>
+                </summary>
+                <code><%= h((JSON.pretty_generate(job.data[:args]) rescue job.data[:args].to_s)) %></code>
+              </details>
+            </div>
+          </td>
+          <td>
+            <code><%= h(job.stream) %></code>
+          </td>
+          <td style="max-width: 400px;">
+            <% if job.data[:error] -%>
+            <div class="error-message">
+              <strong><%= h(job.data[:error].to_s.split(":").first || "Error") %></strong>
+              <p><%= h(job.data[:error]) %></p>
+            </div>
+            <% end -%>
+          </td>
+          <td style="white-space: nowrap;">
+            <time><%= h(job.timestamp) %></time>
+          </td>
+          <td>
+            <a hx-patch="<%= url_for("/jobs/retry/#{job.seq}") %>"
+               hx-target="#dead-row-<%= job.seq %>"
+               hx-swap="innerHTML"
+               class="btn btn-primary"
+               style="width: 100%; text-align: center; margin-bottom: 3px">&#x21BB; Retry</a>
+            <a hx-delete="<%= url_for("/jobs/delete/#{job.seq}") %>"
+               hx-target="#dead-row-<%= job.seq %>"
+               hx-swap="innerHTML"
+               class="btn btn-danger"
+               style="width: 100%; text-align: center; margin-bottom: 3px">&#x2715; Delete</a>
+          </td>
+        </tr>
+        <% end -%>
+      </tbody>
+    </table>
+  </div>
+<% end -%>

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

@@ -0,0 +1,60 @@
+<div class="nav">
+  <% @stream_names.each do |stream_name| -%>
+    <button hx-get="<%= url_for('/jobs/enqueued', { stream_name: }) %>"
+            hx-target="#content"
+            hx-swap="innerHTML"
+            hx-push-url="true"
+            class="btn <%= "btn-primary" if @stream_name.to_s == stream_name.to_s %>">
+      <%= h(stream_name) %>
+    </button>
+  <% end -%>
+</div>
+
+<div class="pending">
+  <span></span>
+  <span class="text-muted"><%= @total %> message(s) pending</span>
+</div>
+
+<% if @jobs.empty? -%>
+  <div class="alert alert-success">Stream <code><%= h(@stream_name) %></code> is empty</div>
+<% else -%>
+  <div class="table-container">
+    <table>
+      <thead>
+        <tr>
+          <th>Job</th>
+          <th>JID[Args]</th>
+          <th>Stream</th>
+          <th>Seq</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @jobs.each do |job| -%>
+        <tr>
+          <td>
+            <div class="job-class">
+              <%= h(job.data[:class].to_s) %>
+            </div>
+          </td>
+          <td>
+            <div class="job-id">
+              <details>
+                <summary>
+                  <code><%= h(job.data[:jid].to_s) %></code>
+                </summary>
+                <code><%= h((JSON.pretty_generate(job.data[:args]) rescue job.data[:args].to_s)) %></code>
+              </details>
+            </div>
+          </td>
+          <td>
+            <code><%= h(job.stream) %></code>
+          </td>
+          <td>
+            <code><%= job.seq %></code>
+          </td>
+        </tr>
+        <% end -%>
+      </tbody>
+    </table>
+  </div>
+<% end -%>

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

@@ -0,0 +1,49 @@
+<div class="pending">
+  <span></span>
+  <span class="text-muted"><%= @total %> job(s) scheduled</span>
+</div>
+
+<% if @jobs.empty? -%>
+  <div class="alert alert-success">No scheduled jobs found</div>
+<% else -%>
+  <div class="table-container">
+    <table>
+      <thead>
+        <tr>
+          <th>Job</th>
+          <th>JID[Args]</th>
+          <th>Stream</th>
+          <th>When</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @jobs.each do |job| -%>
+        <tr>
+          <td>
+            <div class="job-class">
+              <%= h(job.data[:class].to_s) %>
+            </div>
+          </td>
+          <td>
+            <div class="job-id">
+              <details>
+                <summary>
+                  <code><%= h(job.data[:jid].to_s) %></code>
+                </summary>
+                <code><%= h((JSON.pretty_generate(job.data[:args]) rescue job.data[:args].to_s)) %></code>
+              </details>
+            </div>
+          </td>
+          <td>
+            <code><%= h(job.x_stream) %></code>
+          </td>
+          <td style="white-space: nowrap;">
+            <div class="time-badge"><%= h(time_until(job.execute_at)) %></div>
+            <time><%= h(format_timestamp(job.execute_at)) %></time>
+          </td>
+        </tr>
+        <% end -%>
+      </tbody>
+    </table>
+  </div>
+<% end -%>

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

@@ -0,0 +1,69 @@
+<div class="cards-container">
+  <article class="stat-card">
+    <div class="row">
+      <p>&#x1F4AA; Processed</p>
+      <h4><%= format_numbers(@processed) %></h4>
+    </div>
+    <div class="row">
+      <p>&#x1F625; Failed</p>
+      <h4><%= format_numbers(@failed) %></h4>
+    </div>
+    <div class="row">
+      <p>&#x1F504; Retries</p>
+      <h4><%= format_numbers(@retries) %></h4>
+    </div>
+  </article>
+  <article class="stat-card">
+    <h3><%= format_numbers(@busy) %></h3>
+    <p>
+      <a href="<%= url_for('/jobs/busy') %>"
+         hx-get="<%= url_for('/jobs/busy') %>"
+         hx-target="#content"
+         hx-push-url="true">&#x23F3; Busy</a>
+    </p>
+  </article>
+  <article class="stat-card">
+    <h3><%= format_numbers(@enqueued) %></h3>
+    <p>
+      <a href="<%= url_for('/jobs/enqueued') %>"
+         hx-get="<%= url_for('/jobs/enqueued') %>"
+         hx-target="#content"
+         hx-push-url="true"
+         class="<%= 'active' if referrer?('/jobs/enqueued') %>">&#x1F4EC; Enqueued</a>
+    </p>
+  </article>
+  <article class="stat-card">
+    <h3><%= format_numbers(@scheduled) %></h3>
+    <p>
+      <a href="<%= url_for('/jobs/scheduled') %>"
+         hx-get="<%= url_for('/jobs/scheduled') %>"
+         hx-target="#content"
+         hx-push-url="true"
+         class="<%= 'active' if referrer?('/jobs/scheduled') %>">&#x23F0; Scheduled</a>
+    </p>
+  </article>
+  <article class="stat-card">
+    <h3><%= format_numbers(@dead) %></h3>
+    <p>
+      <a href="<%= url_for('/jobs/dead') %>"
+         hx-get="<%= url_for('/jobs/dead') %>"
+         hx-target="#content"
+         hx-push-url="true"
+         class="<%= 'active' if referrer?('/jobs/dead') %>">&#x1F480; Dead</a>
+    </p>
+  </article>
+</div>
+
+<script>
+  (function () {
+    const links = document.querySelectorAll('.cards-container a');
+
+    links.forEach(link => {
+      link.addEventListener('click', () => {
+        links.forEach(item => item.classList.remove('active'));
+
+        link.classList.add('active');
+      });
+    });
+  })();
+</script>

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

@@ -0,0 +1,16 @@
+<section>
+  <header></header>
+
+  <div hx-get="<%= url_for('/jobs/_stats') %>"
+       hx-trigger="load, every 5s"
+       hx-swap="innerHTML">
+    <div class="alert alert-info">Loading statistics…</div>
+  </div>
+
+  <div id="content"
+       hx-get="<%= url_for('/jobs/_busy') %>"
+       hx-trigger="load, every 5s"
+       hx-swap="innerHTML">
+    <div class="alert alert-info">Loading busy jobs&hellip;</div>
+  </div>
+</section>

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

@@ -0,0 +1,17 @@
+<section>
+  <header></header>
+
+  <div hx-get="<%= url_for('/jobs/_stats') %>"
+       hx-trigger="load, every 5s"
+       hx-swap="innerHTML">
+    <div class="alert alert-info">Loading statistics…</div>
+  </div>
+
+  <div id="content">
+    <div hx-get="<%= url_for('/jobs/_dead') %>"
+         hx-trigger="load, every 5s"
+         hx-swap="innerHTML">
+      <div class="alert alert-info">Loading dead jobs…</div>
+    </div>
+  </div>
+</section>