cosmonats 0.1.4 → 0.3.0

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

@@ -0,0 +1,70 @@
+# 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 pause
+          name = Rack::Utils.unescape(@request.params["name"])
+          stream = API::Stream.new(name)
+          stream.pause!
+          return ok render("streams/_pause_banner", banner_locals(stream)) if @request.params["banner"]
+
+          ok render("streams/_stream_row", { stream: row_locals(stream) })
+        end
+
+        def unpause
+          name = Rack::Utils.unescape(@request.params["name"])
+          stream = API::Stream.new(name)
+          stream.unpause!
+          return ok render("streams/_pause_banner", banner_locals(stream)) if @request.params["banner"]
+
+          ok render("streams/_stream_row", { stream: row_locals(stream) })
+        end
+
+        def _table
+          streams = API::Stream.all.map { row_locals(_1) }
+          ok render("streams/_table", { streams: streams })
+        end
+
+        def _info
+          name = Rack::Utils.unescape(@request.params["name"])
+          stream = API::Stream.new(name)
+          ok render("streams/_info", stream.info.merge(name:, paused: stream.paused?))
+        end
+
+        private
+
+        def row_locals(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,
+            paused: stream.paused? }
+        end
+
+        def banner_locals(stream)
+          { name: stream.name, paused: stream.paused? }
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require "cosmo/web/renderer"
+
+module Cosmo
+  class Web
+    module Helpers
+      module Application
+        include Renderer
+
+        def render(template, locals = nil)
+          defaults = { request: @request }
+          locals = Hash(locals).merge(defaults)
+          erb(template, locals)
+        end
+
+        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 == path
+        end
+
+        def referrer?(path)
+          referrer_uri  = URI(@request.referrer)
+          referrer_path = referrer_uri.path
+          script_name   = @request.script_name
+          referrer_path = referrer_path.delete_prefix(script_name) if script_name && !script_name.empty?
+          referrer_path = "/" if referrer_path.empty?
+          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>

data/lib/cosmo/web/views/jobs/enqueued.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/_enqueued', stream_name: @stream_name) %>"
+       hx-trigger="load"
+       hx-swap="innerHTML">
+    <div class="alert alert-info">Loading enqueued jobs&hellip;</div>
+  </div>
+</section>

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

@@ -0,0 +1,12 @@
+<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>
+</section>

data/lib/cosmo/web/views/jobs/scheduled.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/_scheduled') %>"
+         hx-trigger="load, every 5s"
+         hx-swap="innerHTML">
+      <div class="alert alert-info">Loading scheduled jobs…</div>
+    </div>
+  </div>
+</section>

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

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Cosmo<%= " — #{h(content_for :title)}" if content_for?(:title) %></title>
+  <script src="<%= url_for('/assets/htmx.min.js.gz') %>" defer></script>
+  <link rel="stylesheet" href="<%= url_for('/assets/app.css') %>">
+</head>
+<body>
+  <header>
+    <div class="container">
+      <nav class="nav">
+        <a href="<%= url_for('/jobs') %>" class="navbar-brand">🚀 Cosmo</a>
+        <ul class="nav-list">
+          <li>
+            <a href="<%= url_for('/jobs') %>" class="<%= "active" if current_page?('/jobs') %>">Jobs</a>
+          </li>
+          <li>
+            <a href="<%= url_for('/streams') %>" class="<%= "active" if current_page?('/streams') %>">Streams</a>
+          </li>
+          <li>
+            <a href="<%= url_for('/actions') %>" class="<%= "active" if current_page?('/actions') %>">Actions</a>
+          </li>
+        </ul>
+      </nav>
+    </div>
+  </header>
+  <main class="container">
+    <%= content_for :view %>
+  </main>
+</body>
+</html>