cosmonats 0.1.3 → 0.2.0

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>

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>

data/lib/cosmo/web/views/streams/_info.erb

@@ -0,0 +1,89 @@
+<div class="cards-container">
+  <article class="stat-card">
+    <h3><%= format_numbers(@state.messages) %></h3>
+    <p>Messages</p>
+  </article>
+  <article class="stat-card">
+    <h3><%= format_bytes(@state.bytes) %></h3>
+    <p>Size</p>
+  </article>
+  <article class="stat-card">
+    <h3><%= @state.consumer_count %></h3>
+    <p>Consumers</p>
+  </article>
+  <article class="stat-card">
+    <h3><%= format_numbers(@state.first_seq) + " &rarr; " + format_numbers(@state.last_seq) %></h3>
+    <p>Sequence Range</p>
+  </article>
+</div>
+
+<div class="nav">
+  <a href="<%= url_for('/streams') %>"
+     hx-get="<%= url_for('/streams') %>"
+     hx-target="#content"
+     hx-push-url="true"
+     class="btn">Back to Streams</a>
+</div>
+
+<h2>Configuration</h2>
+<div class="table-container">
+  <table>
+    <tbody>
+      <tr>
+        <th>Name</th>
+        <td>
+          <code><%= h(@name) %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Retention</th>
+        <td>
+          <code><%= h(@config.retention.to_s) %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Storage</th>
+        <td>
+          <code><%= h(@config.storage.to_s) %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Discard Policy</th>
+        <td>
+          <code><%= h(@config.discard.to_s) %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Max Consumers</th>
+        <td>
+          <code><%= @config.max_consumers || "Unlimited" %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Max Messages</th>
+        <td>
+          <code><%= @config.max_msgs || "Unlimited" %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Max Bytes</th>
+        <td>
+          <code><%= @config.max_bytes&.positive? ? format_bytes(@config.max_bytes) : "Unlimited" %></code>
+        </td>
+      </tr>
+      <tr>
+        <th>Max Age</th>
+        <td>
+          <code><%= @config.max_age&.positive? ? "#{@config.max_age}ns" : "Unlimited" %></code>
+        </td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+<h2>Subjects</h2>
+<div class="subjects" style="margin-top: var(--space-2x);">
+  <% Array(@config.subjects).each do |sub| -%>
+    <div class="subject-tag" style="padding: var(--space) var(--space-2x); font-size: 1rem;"><%= h(sub) %></div>
+  <% end -%>
+</div>