add api to return available request strategies

Author: gildesmarais

app.rb

@@ -2,11 +2,14 @@
 
 require 'roda'
 require 'rack/cache'
+require 'json'
 
 require 'html2rss'
 require_relative 'app/ssrf_filter_strategy'
 require_relative 'app/auto_source'
 require_relative 'app/feeds'
+require_relative 'app/health_check'
+require_relative 'app/api_routes'
 
 module Html2rss
   module Web
@@ -15,6 +18,8 @@ module Web
     #
     # It is built with [Roda](https://roda.jeremyevans.net/).
     class App < Roda
+      include ApiRoutes
+
       CONTENT_TYPE_RSS = 'application/xml'
 
       Html2rss::RequestService.register_strategy(:ssrf_filter, SsrfFilterStrategy)
@@ -71,8 +76,14 @@ def self.development? = ENV['RACK_ENV'] == 'development'
           JSON.generate(Feeds.list_feeds)
         end
 
+        r.on 'strategies.json' do
+          response['Content-Type'] = 'application/json'
+          response['Cache-Control'] = 'public, max-age=3600'
+          JSON.generate(ApiRoutes.list_available_strategies)
+        end
+
         r.on String do |feed_name|
-          handle_feed_generation(r, feed_name)
+          ApiRoutes.handle_feed_generation(r, feed_name)
         end
       end
 
@@ -98,25 +109,6 @@ def self.development? = ENV['RACK_ENV'] == 'development'
 
       private
 
-      # API route helpers
-      def handle_feed_generation(router, feed_name)
-        params = router.params
-        rss_content = Feeds.generate_feed(feed_name, params)
-        set_rss_headers
-        rss_content.to_s
-      rescue StandardError => error
-        response.status = 500
-        response['Content-Type'] = CONTENT_TYPE_RSS
-        Feeds.error_feed(error.message)
-      end
-
-      def set_rss_headers
-        response['Content-Type'] = CONTENT_TYPE_RSS
-        response['Cache-Control'] = 'public, max-age=3600'
-        response['X-Content-Type-Options'] = 'nosniff'
-        response['X-XSS-Protection'] = '1; mode=block'
-      end
-
       # Auto source route helpers
       def auto_source_disabled_response
         response.status = 400

app/api_routes.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Html2rss
+  module Web
+    ##
+    # API routes for the html2rss-web application
+    module ApiRoutes
+      module_function
+
+      def list_available_strategies
+        strategies = Html2rss::RequestService.strategy_names.map do |name|
+          {
+            name: name.to_s,
+            display_name: name.to_s.split('_').map(&:capitalize).join(' ')
+          }
+        end
+
+        { strategies: strategies }
+      end
+
+      def handle_feed_generation(router, feed_name)
+        params = router.params
+        rss_content = Feeds.generate_feed(feed_name, params)
+        set_rss_headers(router)
+        rss_content.to_s
+      rescue StandardError => error
+        router.response.status = 500
+        router.response['Content-Type'] = 'application/xml'
+        Feeds.error_feed(error.message)
+      end
+
+      def set_rss_headers(router)
+        router.response['Content-Type'] = 'application/xml'
+        router.response['Cache-Control'] = 'public, max-age=3600'
+        router.response['X-Content-Type-Options'] = 'nosniff'
+        router.response['X-XSS-Protection'] = '1; mode=block'
+      end
+    end
+  end
+end

frontend/src/pages/index.astro

@@ -4,29 +4,24 @@ import StarlightPage from "@astrojs/starlight/components/StarlightPage.astro";
 import { Icon, Card, Steps, Aside } from "@astrojs/starlight/components";
 ---
 
-<StarlightPage frontmatter={{
-  title: "html2rss-web - Convert websites to RSS feeds",
-  template: "splash",
-}}>
+<StarlightPage
+  frontmatter={{
+    title: "html2rss-web - Convert websites to RSS feeds",
+    template: "splash",
+  }}
+>
   <Card title="Generate RSS Feed">
     <form id="auto-source-form" novalidate>
       <div>
         <label for="url">Website URL:</label>
-        <input
-          type="url"
-          id="url"
-          name="url"
-          placeholder="https://example.com"
-          required
-          autocomplete="url"
-        />
+        <input type="url" id="url" name="url" placeholder="https://example.com" required autocomplete="url" />
       </div>
 
       <div>
         <label for="strategy">Strategy:</label>
         <select id="strategy" name="strategy">
+          <!-- Fallback options for when JS is disabled -->
           <option value="ssrf_filter">SSRF Filter (Recommended)</option>
-          <option value="faraday">Faraday</option>
         </select>
       </div>
 
@@ -42,7 +37,8 @@ import { Icon, Card, Steps, Aside } from "@astrojs/starlight/components";
             id="subscribe-link"
             href="#"
             class="sl-link-button"
-            aria-label="Subscribe to the generated RSS feed">Subscribe</a>
+            aria-label="Subscribe to the generated RSS feed">Subscribe</a
+          >
         </p>
       </div>
     </div>
@@ -96,6 +92,35 @@ import { Icon, Card, Steps, Aside } from "@astrojs/starlight/components";
   // Initialize bookmarklet on page load
   initBookmarklet();
 
+  // Load available strategies dynamically
+  async function loadStrategies() {
+    try {
+      const response = await fetch("/api/strategies.json");
+      if (!response.ok) return;
+
+      const data = await response.json();
+      const strategySelect = document.getElementById("strategy") as HTMLSelectElement;
+      if (!strategySelect) return;
+
+      // Clear existing options
+      strategySelect.innerHTML = "";
+
+      // Add strategies from API
+      data.strategies.forEach((strategy: any) => {
+        const option = document.createElement("option");
+        option.value = strategy.name;
+        option.textContent = strategy.display_name;
+        strategySelect.appendChild(option);
+      });
+    } catch (error) {
+      console.warn("Failed to load strategies:", error);
+      // Fallback options remain in HTML
+    }
+  }
+
+  // Load strategies on page load
+  loadStrategies();
+
   // Handle URL parameters from bookmarklet
   function handleUrlParams() {
     const params = new URLSearchParams(window.location.search);