source_monitor 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3831f3ec3fa841e1e15fb16fc7ab780177d35353fce96975338c2e7aa129bd9f
-  data.tar.gz: ac970a0b226c1b8c1c9a266a892754941d92173b8753ac37d2a4cd89f1895fd9
+  metadata.gz: bd1d2946507443d80b3adc99bc086b6c773edf86618754a041c9139ae8763b84
+  data.tar.gz: 18dde3e77a9d466268c1d868bf7ff0de3cee1f99486a007c6f962d4499e0c843
 SHA512:
-  metadata.gz: 46dc5a034c7b7c294877d124a59b632aec2cfbc420544835b06d0809a7e8d574930ffc86cd5bfbceb436516a0bc88b55ffdb34a38a0bb873ae3892bb3615b503
-  data.tar.gz: 542c9c82713daadb6f0cfa4151ab99df55440a8e86a553ee46b2223806096f6d36d1e1987890f50aaad83132498c674793cae11c11752a897daca6c36efb1a94
+  metadata.gz: 1e272942510d791f2f0dc1944b12e561ee9461821cd95faaa761fc0ec1eb1c40b1a58ac37eabd3d9a6d2ba29fe210d0a9fd0bc93e732aad0c864fc471a652b27
+  data.tar.gz: 772e12e49fad3658facfd044d839d7864c0c377577927f239c43c4d7ab09636b71a539ad41f8ef06bbb2f6e02bcdd25c9815f040cd6c8f068d549b5031da762b

data/CHANGELOG.md

@@ -15,6 +15,38 @@ All notable changes to this project are documented below. The format follows [Ke
 
 - No unreleased changes yet.
 
+## [0.2.0] - 2025-11-25
+
+### Added
+
+- OPML import wizard with multi-step flow (upload, preview with selection, health checks, bulk configure, confirm) and Turbo-powered navigation.
+- Health check enqueuing for selected feeds plus realtime Turbo Stream row/progress updates during the wizard.
+- Bulk configuration reuse of source form fields with identity fields hidden for batch apply.
+- Background OPML import job with ImportHistory persistence, per-source success/failure/duplicate tracking, and Turbo broadcast of results to the Sources index.
+- Sources index “Recent OPML import” panel surfacing latest ImportHistory (counts, failures).
+
+### Changed
+
+- Shared source params helper for defaults/permitted attributes to drive bulk settings and single-source forms consistently.
+- Wizard fallback auth handling for unauthenticated host apps to enable usage in simple dummy setups.
+
+### Testing
+
+- `rbenv exec bundle exec rubocop`
+- `rbenv exec ruby bin/rails test`
+- `./bin/test-coverage`
+- `rbenv exec ruby bin/check-diff-coverage`
+
+## [0.1.3] - 2025-11-13
+
+### Added
+
+- Clarified installation instructions for consumers: add `gem "source_monitor"` via RubyGems before running the guided workflow (README + docs/setup.md).
+
+### Testing
+
+- Documentation-only update; no code changes.
+
 ## [0.1.2] - 2025-11-13
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    source_monitor (0.1.2)
+    source_monitor (0.2.0)
       cssbundling-rails (~> 1.4)
       faraday (~> 2.9)
       faraday-follow_redirects (~> 0.4)

data/README.md

@@ -2,6 +2,20 @@
 
 SourceMonitor is a production-ready Rails 8 mountable engine for ingesting, normalising, scraping, and monitoring RSS/Atom/JSON feeds. It ships with a Tailwind-powered admin UI, Solid Queue job orchestration, Solid Cable realtime broadcasting, and an extensible configuration layer so host applications can offer full-stack feed operations without rebuilding infrastructure.
 
+> **Note:** Application developers consume SourceMonitor via RubyGems—add the gem to your host application's Gemfile and follow the guided installer. Clone this repository only when contributing to the engine itself.
+
+## Installation (RubyGems)
+
+In your host Rails app:
+
+```bash
+bundle add source_monitor --version "~> 0.1.2"
+# or add `gem "source_monitor", "~> 0.1.2"` manually, then run:
+bundle install
+```
+
+This exposes `bin/source_monitor` (via Bundler binstubs) so you can run the guided workflow described below.
+
 ## Highlights
 - Full-featured source and item administration backed by Turbo Streams and Tailwind UI components
 - Adaptive fetch pipeline (Feedjira + Faraday) with conditional GETs, retention pruning, and scrape orchestration
@@ -22,6 +36,16 @@ SourceMonitor is a production-ready Rails 8 mountable engine for ingesting, norm
 
 > **Command prefixes:** Examples below show bare `bundle`, `bin/rails`, and `bin/source_monitor`. If you use rbenv/asdf or containerized tooling, prefix/adjust commands accordingly so they run inside your Ruby environment.
 
+### Install the Gem
+
+Before running any SourceMonitor commands inside your host app, add the gem and install dependencies:
+
+```bash
+bundle add source_monitor --version "~> 0.1.2"
+# or edit your Gemfile, then run
+bundle install
+```
+
 ### Recommended: Guided Workflow
 1. **Optional prerequisite check:** `bin/rails source_monitor:setup:check`
 2. **Run the guided installer:** `bin/source_monitor install --yes`
@@ -30,7 +54,7 @@ SourceMonitor is a production-ready Rails 8 mountable engine for ingesting, norm
 4. **Verify anytime:** `bin/source_monitor verify` (also exposed as `bin/rails source_monitor:setup:verify`). The command prints a human summary plus JSON so CI can gate on Solid Queue and Action Cable health.
 5. **Visit the dashboard** at the chosen mount path and trigger “Fetch Now” on a source to confirm everything is wired.
 
-See [docs/setup.md](docs/setup.md) for the full workflow (prereq table, rollback steps, telemetry flag, Devise system test template).
+See [docs/setup.md](docs/setup.md) for the full workflow (prereq table, gem installation, rollback steps, telemetry flag, Devise system test template).
 
 ### Manual Install (Advanced)
 Prefer explicit Rails generator steps or need to customize each phase? The same document covers a full **Manual Installation** section so you can copy/paste each command into bespoke pipelines.

data/app/assets/javascripts/source_monitor/application.js

@@ -3,6 +3,8 @@ import AsyncSubmitController from "./controllers/async_submit_controller";
 import NotificationController from "./controllers/notification_controller";
 import DropdownController from "./controllers/dropdown_controller";
 import ModalController from "./controllers/modal_controller";
+import ConfirmNavigationController from "./controllers/confirm_navigation_controller";
+import SelectAllController from "./controllers/select_all_controller";
 import "./turbo_actions";
 
 const existingApplication = window.SourceMonitorStimulus;
@@ -16,5 +18,7 @@ application.register("notification", NotificationController);
 application.register("async-submit", AsyncSubmitController);
 application.register("dropdown", DropdownController);
 application.register("modal", ModalController);
+application.register("confirm-navigation", ConfirmNavigationController);
+application.register("select-all", SelectAllController);
 
 export default application;

data/app/assets/javascripts/source_monitor/controllers/confirm_navigation_controller.js

@@ -0,0 +1,49 @@
+import { Controller } from "@hotwired/stimulus";
+
+export default class extends Controller {
+  static values = {
+    message: {
+      type: String,
+      default: "You have unsaved changes. Are you sure you want to leave this page?"
+    }
+  };
+
+  connect() {
+    this.boundBeforeUnload = this.beforeUnload.bind(this);
+    this.boundTurboVisit = this.beforeTurboVisit.bind(this);
+
+    window.addEventListener("beforeunload", this.boundBeforeUnload);
+    document.addEventListener("turbo:before-visit", this.boundTurboVisit);
+  }
+
+  disconnect() {
+    this.removeGuards();
+  }
+
+  disable() {
+    this.removeGuards();
+  }
+
+  beforeUnload(event) {
+    event.preventDefault();
+    event.returnValue = this.messageValue;
+    return this.messageValue;
+  }
+
+  beforeTurboVisit(event) {
+    if (this.skipPrompt) return;
+
+    if (!window.confirm(this.messageValue)) {
+      event.preventDefault();
+      return;
+    }
+
+    this.skipPrompt = true;
+    this.removeGuards();
+  }
+
+  removeGuards() {
+    window.removeEventListener("beforeunload", this.boundBeforeUnload);
+    document.removeEventListener("turbo:before-visit", this.boundTurboVisit);
+  }
+}

data/app/assets/javascripts/source_monitor/controllers/select_all_controller.js

@@ -0,0 +1,36 @@
+import { Controller } from "@hotwired/stimulus";
+
+export default class extends Controller {
+  static targets = ["master", "item"];
+
+  connect() {
+    this.syncMaster();
+  }
+
+  itemTargetConnected() {
+    this.syncMaster();
+  }
+
+  itemTargetDisconnected() {
+    this.syncMaster();
+  }
+
+  toggleAll(event) {
+    const checked = event.target.checked;
+    this.itemTargets.forEach((checkbox) => {
+      if (checkbox.disabled) return;
+      checkbox.checked = checked;
+    });
+  }
+
+  toggleItem() {
+    this.syncMaster();
+  }
+
+  syncMaster() {
+    if (!this.hasMasterTarget) return;
+    const selectable = this.itemTargets.filter((checkbox) => !checkbox.disabled);
+    const allChecked = selectable.length > 0 && selectable.every((checkbox) => checkbox.checked);
+    this.masterTarget.checked = allChecked;
+  }
+}