rails_orbit 0.1.0

data/public/assets/rails_orbit/application.js

@@ -0,0 +1,237 @@
+(() => {
+  "use strict";
+
+  // ── Poll Controller ───────────────────────────────────────────────────────
+
+  class OrbitPollController {
+    constructor(element) {
+      this.element  = element;
+      this.url      = element.dataset.orbitPollUrlValue;
+      this.interval = parseInt(element.dataset.orbitPollIntervalValue, 10) || 5000;
+      this.timer    = null;
+    }
+
+    start() {
+      if (!this.url) return;
+      this.poll();
+      this.timer = setInterval(() => this.poll(), this.interval);
+    }
+
+    stop() {
+      if (this.timer) { clearInterval(this.timer); this.timer = null; }
+    }
+
+    async poll() {
+      try {
+        const response = await fetch(this.url, {
+          headers: { "Accept": "text/vnd.turbo-stream.html" }
+        });
+        if (!response.ok) return;
+
+        const html = await response.text();
+        if (!html) return;
+
+        if (typeof Turbo !== "undefined" && Turbo.renderStreamMessage) {
+          Turbo.renderStreamMessage(html);
+        } else {
+          this.fallbackUpdate(html);
+        }
+        this.refreshTimestamp();
+      } catch (err) {
+        // Silently swallow network errors — will retry on next interval
+      }
+    }
+
+    fallbackUpdate(html) {
+      const doc = new DOMParser().parseFromString(html, "text/html");
+      for (const stream of doc.querySelectorAll("turbo-stream")) {
+        const target = document.getElementById(stream.getAttribute("target"));
+        if (!target) continue;
+        const tpl = stream.querySelector("template");
+        if (!tpl) continue;
+        const action = stream.getAttribute("action");
+        if (action === "update" || action === "replace") {
+          target.innerHTML = tpl.innerHTML;
+        }
+      }
+    }
+
+    refreshTimestamp() {
+      const el = document.getElementById("orbit-last-updated");
+      if (!el) return;
+      el.dataset.time = new Date().toISOString();
+      el.textContent  = "Updated just now";
+    }
+  }
+
+  // ── Timestamp Ticker ──────────────────────────────────────────────────────
+
+  function startTimestampTicker() {
+    setInterval(() => {
+      const el = document.getElementById("orbit-last-updated");
+      if (!el || !el.dataset.time) return;
+      const s = Math.floor((Date.now() - new Date(el.dataset.time).getTime()) / 1000);
+      if (s < 5)       el.textContent = "Updated just now";
+      else if (s < 60) el.textContent = `Updated ${s}s ago`;
+      else             el.textContent = `Updated ${Math.floor(s / 60)}m ago`;
+    }, 5000);
+  }
+
+  // ── Interactive SVG Chart ─────────────────────────────────────────────────
+
+  class OrbitChart {
+    constructor(container) {
+      this.container = container;
+      this.data      = JSON.parse(container.dataset.chart || "[]");
+      this.unit      = container.dataset.unit || "";
+      this.color     = container.dataset.color || "var(--orbit-primary)";
+      this.gradId    = container.dataset.gradientId || `orbit-grad-${Math.random().toString(36).slice(2, 8)}`;
+
+      if (this.data.length > 0) this.render();
+    }
+
+    render() {
+      const W = 700, H = 90, PAD_TOP = 5, PAD_BOT = 5;
+      const { data, unit, color, gradId } = this;
+      const vals  = data.map(d => d.v);
+      const maxV  = Math.max(...vals) || 1;
+      const minV  = Math.min(...vals);
+      const range = maxV - minV || 1;
+      const stepX = data.length > 1 ? W / (data.length - 1) : W;
+
+      const yPos = v => PAD_TOP + ((maxV - v) / range) * (H - PAD_TOP - PAD_BOT);
+
+      const points = data.map((d, i) => ({
+        x: (i * stepX).toFixed(1),
+        y: yPos(d.v).toFixed(1)
+      }));
+
+      const polyline = points.map(p => `${p.x},${p.y}`).join(" ");
+      const polygon  = `0,${H} ${polyline} ${W},${H}`;
+
+      const ns = "http://www.w3.org/2000/svg";
+      const svg = document.createElementNS(ns, "svg");
+      svg.setAttribute("viewBox", `0 0 ${W} ${H + 2}`);
+      svg.setAttribute("preserveAspectRatio", "none");
+      svg.setAttribute("class", "orbit-chart");
+
+      svg.innerHTML =
+        `<defs><linearGradient id="${gradId}" x1="0" y1="0" x2="0" y2="1">` +
+        `<stop offset="0%" stop-color="${color}" stop-opacity="0.25"/>` +
+        `<stop offset="100%" stop-color="${color}" stop-opacity="0.02"/>` +
+        `</linearGradient></defs>` +
+        `<polygon points="${polygon}" fill="url(#${gradId})"/>` +
+        `<polyline points="${polyline}" fill="none" stroke="${color}" stroke-width="1.5" stroke-linejoin="round"/>`;
+
+      const hitZones = document.createElementNS(ns, "g");
+      hitZones.setAttribute("class", "orbit-chart__hitzone");
+
+      for (let i = 0; i < points.length; i++) {
+        const rect = document.createElementNS(ns, "rect");
+        const x0 = i === 0 ? 0 : parseFloat(points[i].x) - stepX / 2;
+        rect.setAttribute("x", x0);
+        rect.setAttribute("y", 0);
+        rect.setAttribute("width", stepX);
+        rect.setAttribute("height", H);
+        rect.setAttribute("fill", "transparent");
+        rect.setAttribute("data-idx", i);
+        hitZones.appendChild(rect);
+      }
+      svg.appendChild(hitZones);
+
+      const dot = document.createElementNS(ns, "circle");
+      dot.setAttribute("r", "3");
+      dot.setAttribute("fill", color);
+      dot.setAttribute("class", "orbit-chart__dot");
+      dot.style.display = "none";
+      svg.appendChild(dot);
+
+      const vLine = document.createElementNS(ns, "line");
+      vLine.setAttribute("y1", "0");
+      vLine.setAttribute("y2", H);
+      vLine.setAttribute("stroke", "var(--orbit-border-hover)");
+      vLine.setAttribute("stroke-width", "1");
+      vLine.setAttribute("stroke-dasharray", "2,2");
+      vLine.setAttribute("class", "orbit-chart__vline");
+      vLine.style.display = "none";
+      svg.appendChild(vLine);
+
+      const tooltip = document.createElement("div");
+      tooltip.className = "orbit-chart__tooltip";
+      tooltip.style.display = "none";
+
+      const wrap = document.createElement("div");
+      wrap.className = "orbit-chart-wrap";
+      wrap.appendChild(svg);
+      wrap.appendChild(tooltip);
+
+      const labels = document.createElement("div");
+      labels.className = "orbit-chart__labels";
+      labels.innerHTML =
+        `<span class="orbit-chart__label">${minV.toFixed(1)}${unit}</span>` +
+        `<span class="orbit-chart__label orbit-chart__label--current">${data[data.length - 1].v.toFixed(1)}${unit} now</span>` +
+        `<span class="orbit-chart__label">${maxV.toFixed(1)}${unit} peak</span>`;
+      wrap.appendChild(labels);
+
+      this.container.innerHTML = "";
+      this.container.appendChild(wrap);
+
+      svg.addEventListener("mousemove", e => {
+        const rect = svg.getBoundingClientRect();
+        const mx = (e.clientX - rect.left) / rect.width * W;
+        let idx = Math.round(mx / stepX);
+        idx = Math.max(0, Math.min(idx, data.length - 1));
+
+        const pt = points[idx];
+        dot.setAttribute("cx", pt.x);
+        dot.setAttribute("cy", pt.y);
+        dot.style.display = "";
+
+        vLine.setAttribute("x1", pt.x);
+        vLine.setAttribute("x2", pt.x);
+        vLine.style.display = "";
+
+        tooltip.textContent = `${this.formatTime(data[idx].t)}  ${data[idx].v.toFixed(1)}${unit}`;
+        tooltip.style.display = "";
+
+        const pctX = parseFloat(pt.x) / W * 100;
+        tooltip.style.left = `${pctX}%`;
+        tooltip.style.transform = pctX > 80 ? "translateX(-100%)" : (pctX < 20 ? "translateX(0)" : "translateX(-50%)");
+      });
+
+      svg.addEventListener("mouseleave", () => {
+        dot.style.display = "none";
+        vLine.style.display = "none";
+        tooltip.style.display = "none";
+      });
+    }
+
+    formatTime(ts) {
+      if (!ts) return "";
+      const d = new Date(ts.replace(" ", "T") + (ts.includes("Z") ? "" : "Z"));
+      if (isNaN(d.getTime())) return ts;
+      const h = d.getHours().toString().padStart(2, "0");
+      const m = d.getMinutes().toString().padStart(2, "0");
+      const mon = d.toLocaleString("en", { month: "short" });
+      return `${mon} ${d.getDate()} ${h}:${m}`;
+    }
+  }
+
+  // ── Init ──────────────────────────────────────────────────────────────────
+
+  function initAll() {
+    for (const el of document.querySelectorAll("[data-controller='orbit-poll']")) {
+      new OrbitPollController(el).start();
+    }
+    for (const el of document.querySelectorAll(".orbit-chart-interactive")) {
+      new OrbitChart(el);
+    }
+    startTimestampTicker();
+  }
+
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", initAll);
+  } else {
+    initAll();
+  }
+})();

metadata

@@ -0,0 +1,264 @@
+--- !ruby/object:Gem::Specification
+name: rails_orbit
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- dev-ham
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: turbo-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: factory_bot_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: solid_queue
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: solid_cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: solid_errors
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A mountable Rails engine providing real-time metrics, job monitoring,
+  cache analytics, and error tracking for applications built on the Solid trifecta.
+email:
+- devhammad.masood@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- app/assets/javascripts/rails_orbit/application.js
+- app/assets/stylesheets/rails_orbit/application.css
+- app/controllers/rails_orbit/application_controller.rb
+- app/controllers/rails_orbit/dashboard_controller.rb
+- app/controllers/rails_orbit/stream_controller.rb
+- app/helpers/rails_orbit/dashboard_helper.rb
+- app/helpers/rails_orbit/icon_helper.rb
+- app/jobs/rails_orbit/application_job.rb
+- app/jobs/rails_orbit/retention_job.rb
+- app/models/rails_orbit/application_record.rb
+- app/models/rails_orbit/metric.rb
+- app/views/layouts/rails_orbit/application.html.erb
+- app/views/rails_orbit/dashboard/_overview_card.html.erb
+- app/views/rails_orbit/dashboard/cache.html.erb
+- app/views/rails_orbit/dashboard/errors.html.erb
+- app/views/rails_orbit/dashboard/jobs.html.erb
+- app/views/rails_orbit/dashboard/overview.html.erb
+- app/views/rails_orbit/shared/_delta.html.erb
+- app/views/rails_orbit/shared/_nav.html.erb
+- app/views/rails_orbit/shared/_range_picker.html.erb
+- app/views/rails_orbit/stream/_cache_stats.html.erb
+- app/views/rails_orbit/stream/_error_count.html.erb
+- app/views/rails_orbit/stream/_queue_stats.html.erb
+- app/views/rails_orbit/stream/index.turbo_stream.erb
+- config/routes.rb
+- lib/generators/rails_orbit/install_generator.rb
+- lib/generators/rails_orbit/templates/create_orbit_metrics.rb.erb
+- lib/generators/rails_orbit/templates/initializer.rb
+- lib/rails_orbit.rb
+- lib/rails_orbit/configuration.rb
+- lib/rails_orbit/database_setup.rb
+- lib/rails_orbit/engine.rb
+- lib/rails_orbit/instrumentation.rb
+- lib/rails_orbit/kamal/config_reader.rb
+- lib/rails_orbit/kamal/poller.rb
+- lib/rails_orbit/kamal/stats_collector.rb
+- lib/rails_orbit/metric_writer.rb
+- lib/rails_orbit/time_range.rb
+- lib/rails_orbit/version.rb
+- lib/tasks/rails_orbit.rake
+- public/assets/rails_orbit/application.css
+- public/assets/rails_orbit/application.js
+homepage: https://github.com/dev-ham/rails_orbit
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/dev-ham/rails_orbit
+  changelog_uri: https://github.com/dev-ham/rails_orbit/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/dev-ham/rails_orbit/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Observability dashboard for solid_queue, solid_cache, and solid_errors
+test_files: []