@rmdes/indiekit-endpoint-blogroll 1.0.16 → 1.0.18

package/README.md

@@ -0,0 +1,241 @@
+# Blogroll Endpoint for Indiekit
+
+An Indiekit plugin that provides a comprehensive blogroll management system with feed aggregation, admin UI, and public API.
+
+## Features
+
+- **Multiple Source Types:** Import blogs from OPML files/URLs, Microsub subscriptions, or add manually
+- **Background Feed Fetching:** Automatically syncs blogs and caches recent items
+- **Microsub Integration:** Mirror your Microsub subscriptions as a blogroll (zero duplication)
+- **Admin UI:** Manage sources, blogs, and view recent activity
+- **Public JSON API:** Read-only endpoints for frontend integration
+- **OPML Export:** Export your blogroll as OPML (all or by category)
+- **Feed Discovery:** Auto-discover feeds from website URLs
+- **Item Retention:** Automatic cleanup of old items (encourages fresh content discovery)
+
+## Installation
+
+```bash
+npm install @rmdes/indiekit-endpoint-blogroll
+```
+
+## Configuration
+
+Add to your `indiekit.config.js`:
+
+```javascript
+import BlogrollEndpoint from "@rmdes/indiekit-endpoint-blogroll";
+
+export default {
+  plugins: [
+    new BlogrollEndpoint({
+      mountPath: "/blogrollapi",    // Admin UI and API base path
+      syncInterval: 3600000,         // 1 hour (in milliseconds)
+      maxItemsPerBlog: 50,           // Items to fetch per blog
+      maxItemAge: 7,                 // Days - older items auto-deleted
+      fetchTimeout: 15000            // 15 seconds per feed fetch
+    })
+  ]
+};
+```
+
+## Requirements
+
+- **Indiekit:** `>=1.0.0-beta.25`
+- **MongoDB:** Required for data storage
+- **Optional:** `@rmdes/indiekit-endpoint-microsub` for Microsub integration
+
+## Usage
+
+### Admin UI
+
+Navigate to `/blogrollapi` in your Indiekit instance to access:
+
+- **Dashboard:** View sync status, blog counts, recent activity
+- **Sources:** Manage OPML and Microsub sources
+- **Blogs:** Add/edit/delete individual blogs, refresh feeds
+- **Manual Sync:** Trigger immediate sync or clear and resync
+
+### Source Types
+
+1. **OPML URL:** Point to a public OPML file (e.g., your feed reader's export)
+2. **OPML File:** Paste OPML XML directly into the form
+3. **Microsub:** Import subscriptions from your Microsub channels
+4. **Manual:** Add individual blog feeds one at a time
+
+### Public API
+
+All API endpoints return JSON (except OPML export which returns XML).
+
+**List Blogs**
+```
+GET /blogrollapi/api/blogs?category=Tech&limit=100&offset=0
+```
+
+**Get Blog with Recent Items**
+```
+GET /blogrollapi/api/blogs/:id
+```
+
+**List Items Across All Blogs**
+```
+GET /blogrollapi/api/items?blog=<id>&category=Tech&limit=50&offset=0
+```
+
+**List Categories**
+```
+GET /blogrollapi/api/categories
+```
+
+**Sync Status**
+```
+GET /blogrollapi/api/status
+```
+
+**Export OPML**
+```
+GET /blogrollapi/api/opml                  (all blogs)
+GET /blogrollapi/api/opml/:category        (specific category)
+```
+
+### Example Response
+
+**GET /blogrollapi/api/blogs**
+```json
+{
+  "items": [
+    {
+      "id": "507f1f77bcf86cd799439011",
+      "title": "Example Blog",
+      "description": "A great blog about tech",
+      "feedUrl": "https://example.com/feed",
+      "siteUrl": "https://example.com",
+      "feedType": "rss",
+      "category": "Tech",
+      "tags": ["programming", "web"],
+      "photo": "https://example.com/icon.png",
+      "status": "active",
+      "itemCount": 25,
+      "pinned": false,
+      "lastFetchAt": "2026-02-13T10:30:00.000Z"
+    }
+  ],
+  "total": 42,
+  "hasMore": true
+}
+```
+
+**GET /blogrollapi/api/items**
+```json
+{
+  "items": [
+    {
+      "id": "507f1f77bcf86cd799439011",
+      "url": "https://example.com/post/hello",
+      "title": "Hello World",
+      "summary": "My first blog post...",
+      "published": "2026-02-13T10:00:00.000Z",
+      "isFuture": false,
+      "author": { "name": "Jane Doe" },
+      "photo": ["https://example.com/image.jpg"],
+      "categories": ["announcement"],
+      "blog": {
+        "id": "507f1f77bcf86cd799439011",
+        "title": "Example Blog",
+        "siteUrl": "https://example.com",
+        "category": "Tech",
+        "photo": "https://example.com/icon.png"
+      }
+    }
+  ],
+  "hasMore": false
+}
+```
+
+## Microsub Integration
+
+If you have `@rmdes/indiekit-endpoint-microsub` installed, the blogroll can mirror your subscriptions:
+
+1. Create a Microsub source in the admin UI
+2. Select specific channels or sync all channels
+3. Add a category prefix (optional) to distinguish Microsub blogs
+4. Blogs and items are referenced, not duplicated
+
+**Benefits:**
+- Zero data duplication - items are served directly from Microsub
+- Automatic orphan cleanup when feeds are unsubscribed
+- Webhook support for real-time updates
+
+## Background Sync
+
+The plugin automatically syncs in the background:
+
+1. **Initial Sync:** Runs 15 seconds after server startup
+2. **Periodic Sync:** Runs every `syncInterval` milliseconds (default 1 hour)
+3. **What it Does:**
+   - Syncs enabled sources (OPML/Microsub)
+   - Fetches new items from active blogs
+   - Deletes items older than `maxItemAge` days
+   - Updates sync statistics
+
+**Manual Sync:**
+- Trigger from the dashboard
+- Use `POST /blogrollapi/sync` (protected endpoint)
+- Use `POST /blogrollapi/clear-resync` to clear and resync all
+
+## Feed Discovery
+
+The plugin includes auto-discovery for finding feeds from website URLs:
+
+```javascript
+// In the admin UI, when adding a blog, paste a website URL
+// The plugin will:
+// 1. Check <link rel="alternate"> tags in HTML
+// 2. Try common feed paths (/feed, /rss, /atom.xml, etc.)
+// 3. Suggest discovered feeds
+```
+
+## Item Retention
+
+By default, items older than 7 days are automatically deleted during sync. This encourages discovery of fresh content rather than archiving everything.
+
+**To Change Retention:**
+```javascript
+new BlogrollEndpoint({
+  maxItemAge: 30  // Keep items for 30 days instead
+})
+```
+
+## Blog Status
+
+- **active:** Blog is working, fetching items normally
+- **error:** Last fetch failed (see `lastError` for details)
+- **deleted:** Soft-deleted, won't be recreated by sync
+
+## Navigation
+
+The plugin adds itself to Indiekit's navigation:
+
+- **Menu Item:** "Blogroll" (requires database)
+- **Shortcut:** Bookmark icon in admin dashboard
+
+## Security
+
+- **Protected Routes:** Admin UI and management endpoints require authentication
+- **Public Routes:** Read-only API endpoints are publicly accessible
+- **XSS Prevention:** Feed content is sanitized with `sanitize-html`
+- **Feed Discovery:** Protected to prevent abuse (requires authentication)
+
+## Supported Feed Formats
+
+- RSS 2.0
+- Atom 1.0
+- JSON Feed 1.0
+
+## Contributing
+
+Report issues at: https://github.com/rmdes/indiekit-endpoint-blogroll/issues
+
+## License
+
+MIT

package/lib/storage/blogs.js

@@ -86,7 +86,7 @@ export async function getBlogByFeedUrl(application, feedUrl) {
  */
 export async function createBlog(application, data) {
   const collection = getCollection(application);
-  const now = new Date();
+  const now = new Date().toISOString();
 
   const blog = {
     sourceId: data.sourceId ? new ObjectId(data.sourceId) : null,
@@ -127,7 +127,7 @@ export async function updateBlog(application, id, data) {
 
   const update = {
     ...data,
-    updatedAt: new Date(),
+    updatedAt: new Date().toISOString(),
   };
 
   // Remove fields that shouldn't be updated directly
@@ -162,8 +162,8 @@ export async function deleteBlog(application, id) {
       $set: {
         status: "deleted",
         hidden: true,
-        deletedAt: new Date(),
-        updatedAt: new Date(),
+        deletedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
       },
     }
   );
@@ -181,12 +181,12 @@ export async function updateBlogStatus(application, id, status) {
   const objectId = typeof id === "string" ? new ObjectId(id) : id;
 
   const update = {
-    updatedAt: new Date(),
+    updatedAt: new Date().toISOString(),
   };
 
   if (status.success) {
     update.status = "active";
-    update.lastFetchAt = new Date();
+    update.lastFetchAt = new Date().toISOString();
     update.lastError = null;
     if (status.itemCount !== undefined) {
       update.itemCount = status.itemCount;
@@ -246,7 +246,7 @@ export async function getCategories(application) {
  */
 export async function upsertBlog(application, data) {
   const collection = getCollection(application);
-  const now = new Date();
+  const now = new Date().toISOString();
 
   // Skip if a blog with this feedUrl was soft-deleted
   const deleted = await collection.findOne({

package/lib/storage/items.js

@@ -206,7 +206,7 @@ export async function countItems(application, options = {}) {
  */
 export async function upsertItem(application, data) {
   const collection = getCollection(application);
-  const now = new Date();
+  const now = new Date().toISOString();
 
   const result = await collection.updateOne(
     { blogId: new ObjectId(data.blogId), uid: data.uid },

package/lib/storage/sources.js

@@ -45,7 +45,7 @@ export async function getSource(application, id) {
  */
 export async function createSource(application, data) {
   const collection = getCollection(application);
-  const now = new Date();
+  const now = new Date().toISOString();
 
   const source = {
     type: data.type, // "opml_url" | "opml_file" | "manual" | "json_feed" | "microsub"
@@ -80,7 +80,7 @@ export async function updateSource(application, id, data) {
 
   const update = {
     ...data,
-    updatedAt: new Date(),
+    updatedAt: new Date().toISOString(),
   };
 
   // Remove fields that shouldn't be updated directly
@@ -135,11 +135,11 @@ export async function updateSourceSyncStatus(application, id, status) {
   const objectId = typeof id === "string" ? new ObjectId(id) : id;
 
   const update = {
-    updatedAt: new Date(),
+    updatedAt: new Date().toISOString(),
   };
 
   if (status.success) {
-    update.lastSyncAt = new Date();
+    update.lastSyncAt = new Date().toISOString();
     update.lastSyncError = null;
   } else {
     update.lastSyncError = status.error;

package/lib/sync/feed.js

@@ -142,8 +142,8 @@ function parseJsonFeed(content, feedUrl, maxItems) {
       text: item.content_text,
     },
     summary: decodeEntities(item.summary) || truncateText(item.content_text, 300),
-    published: item.date_published ? new Date(item.date_published) : new Date(),
-    updated: item.date_modified ? new Date(item.date_modified) : undefined,
+    published: item.date_published ? new Date(item.date_published).toISOString() : new Date().toISOString(),
+    updated: item.date_modified ? new Date(item.date_modified).toISOString() : undefined,
     author: item.author || (item.authors?.[0]),
     photo: item.image ? [item.image] : undefined,
     categories: item.tags || [],
@@ -168,6 +168,10 @@ function parseJsonFeed(content, feedUrl, maxItems) {
 function normalizeItem(item, feedUrl) {
   const description = item.description || item.summary || "";
 
+  // Convert dates to ISO strings - feedparser returns Date objects
+  const published = item.pubdate || item.date;
+  const updated = item.date;
+
   return {
     uid: generateUid(feedUrl, item.guid || item.link),
     url: item.link || item.origlink,
@@ -177,8 +181,8 @@ function normalizeItem(item, feedUrl) {
       text: stripHtml(description),
     },
     summary: truncateText(stripHtml(item.summary || description), 300),
-    published: item.pubdate || item.date || new Date(),
-    updated: item.date,
+    published: published ? (published instanceof Date ? published.toISOString() : new Date(published).toISOString()) : new Date().toISOString(),
+    updated: updated ? (updated instanceof Date ? updated.toISOString() : new Date(updated).toISOString()) : undefined,
     author: item.author ? { name: item.author } : undefined,
     photo: extractPhotos(item),
     categories: item.categories || [],

package/lib/sync/microsub.js

@@ -100,8 +100,8 @@ export async function syncMicrosubSource(application, source) {
           $set: {
             status: "deleted",
             hidden: true,
-            deletedAt: new Date(),
-            updatedAt: new Date(),
+            deletedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
           },
         }
       );
@@ -227,8 +227,8 @@ export async function handleMicrosubWebhook(application, data) {
         {
           $set: {
             status: "inactive",
-            unsubscribedAt: new Date(),
-            updatedAt: new Date(),
+            unsubscribedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
           },
         }
       );

package/lib/sync/scheduler.js

@@ -110,7 +110,7 @@ export async function runFullSync(application, options = {}) {
       {
         $set: {
           key: "syncStats",
-          lastFullSync: new Date(),
+          lastFullSync: new Date().toISOString(),
           duration,
           sources: {
             total: enabledSources.length,

package/locales/de.json

@@ -0,0 +1,133 @@
+{
+  "blogroll": {
+    "title": "Blogroll",
+    "description": "Verwalten Sie Ihre Blogroll-Quellen und Blogs",
+    "enabled": "Aktiviert",
+    "disabled": "Deaktiviert",
+    "edit": "Bearbeiten",
+    "sync": "Synchronisieren",
+    "refresh": "Aktualisieren",
+    "cancel": "Abbrechen",
+    "never": "Nie",
+
+    "stats": {
+      "title": "Übersicht",
+      "sources": "Quellen",
+      "blogs": "Blogs",
+      "items": "Einträge",
+      "errors": "Fehler",
+      "lastSync": "Letzte Synchronisation"
+    },
+
+    "actions": {
+      "title": "Aktionen",
+      "syncNow": "Jetzt synchronisieren",
+      "clearResync": "Löschen & Neu synchronisieren",
+      "clearConfirm": "Dadurch werden alle zwischengespeicherten Einträge gelöscht und alles neu abgerufen. Fortfahren?"
+    },
+
+    "errors": {
+      "title": "Blogs mit Fehlern",
+      "seeAll": "Alle %{count} Blogs mit Fehlern anzeigen"
+    },
+
+    "sources": {
+      "title": "OPML-Synchronisation",
+      "manage": "OPML-Synchronisation",
+      "add": "OPML-Quelle hinzufügen",
+      "new": "Neue OPML-Quelle",
+      "edit": "OPML-Quelle bearbeiten",
+      "create": "Erstellen",
+      "save": "Speichern",
+      "empty": "Keine OPML-Quellen konfiguriert. Verwenden Sie diese Funktion, um Blogs aus FreshRSS oder anderen Feed-Readern zu importieren.",
+      "recent": "OPML-Quellen",
+      "interval": "Alle %{minutes} Min.",
+      "lastSync": "Zuletzt synchronisiert",
+      "deleteConfirm": "Diese OPML-Quelle löschen? Importierte Blogs bleiben erhalten.",
+      "created": "OPML-Quelle erfolgreich erstellt.",
+      "created_synced": "OPML-Quelle erfolgreich erstellt und synchronisiert.",
+      "created_sync_failed": "OPML-Quelle erstellt, aber Synchronisation fehlgeschlagen: %{error}",
+      "updated": "OPML-Quelle erfolgreich aktualisiert.",
+      "deleted": "OPML-Quelle erfolgreich gelöscht.",
+      "synced": "Erfolgreich synchronisiert. Hinzugefügt: %{added}, Aktualisiert: %{updated}",
+      "form": {
+        "name": "Name",
+        "type": "Import-Typ",
+        "typeHint": "URL synchronisiert regelmäßig, Datei ist ein einmaliger Import",
+        "url": "OPML-URL",
+        "urlHint": "URL zu Ihrer OPML-Datei (z.B. FreshRSS-Export-URL)",
+        "opmlContent": "OPML-Inhalt",
+        "opmlContentHint": "Fügen Sie hier den vollständigen OPML-XML-Inhalt ein",
+        "syncInterval": "Synchronisationsintervall",
+        "enabled": "Automatische Synchronisation aktivieren"
+      }
+    },
+
+    "blogs": {
+      "title": "Blogs",
+      "manage": "Blogs verwalten",
+      "add": "Blog hinzufügen",
+      "new": "Neuer Blog",
+      "edit": "Blog bearbeiten",
+      "create": "Blog hinzufügen",
+      "save": "Blog speichern",
+      "empty": "Noch keine Blogs. Fügen Sie einen hinzu oder importieren Sie aus einer OPML-Quelle.",
+      "recent": "Aktuelle Blogs",
+      "pinned": "Angeheftet",
+      "hidden": "Versteckt",
+      "noItems": "Noch keine Einträge abgerufen.",
+      "recentItems": "Aktuelle Einträge",
+      "allCategories": "Alle Kategorien",
+      "allStatuses": "Alle Status",
+      "statusActive": "Aktiv",
+      "statusError": "Fehler",
+      "statusPending": "Ausstehend",
+      "clearFilters": "Filter löschen",
+      "deleteConfirm": "Diesen Blog und alle zwischengespeicherten Einträge löschen?",
+      "created": "Blog erfolgreich hinzugefügt.",
+      "created_synced": "Blog hinzugefügt und synchronisiert. %{items} Einträge abgerufen.",
+      "created_sync_failed": "Blog hinzugefügt, aber erster Abruf fehlgeschlagen: %{error}",
+      "updated": "Blog erfolgreich aktualisiert.",
+      "deleted": "Blog erfolgreich gelöscht.",
+      "refreshed": "Blog aktualisiert. %{items} neue Einträge hinzugefügt.",
+      "form": {
+        "discoverUrl": "Website-URL",
+        "discover": "Feed entdecken",
+        "discoverHint": "Geben Sie eine Website-URL ein, um automatisch RSS/Atom-Feeds zu finden",
+        "discoverNoUrl": "Bitte geben Sie eine Website-URL ein",
+        "discovering": "Suche läuft...",
+        "discoveringHint": "Suche nach RSS/Atom-Feeds...",
+        "discoverFailed": "Feeds konnten nicht gefunden werden",
+        "discoverNoFeeds": "Keine Feeds auf dieser Website gefunden",
+        "discoverFoundOne": "Feed gefunden:",
+        "discoverFoundMultiple": "Mehrere Feeds gefunden. Klicken Sie auf einen, um ihn auszuwählen:",
+        "discoverSelected": "Ausgewählter Feed:",
+        "feedUrl": "Feed-URL",
+        "feedUrlHint": "RSS-, Atom- oder JSON-Feed-URL",
+        "title": "Titel",
+        "titlePlaceholder": "Automatisch aus Feed erkannt",
+        "titleHint": "Leer lassen, um den Feed-Titel zu verwenden",
+        "siteUrl": "Website-URL",
+        "siteUrlHint": "Link zur Startseite des Blogs (optional)",
+        "category": "Kategorie",
+        "categoryHint": "Gruppieren Sie Blogs nach Kategorie zum Filtern und OPML-Export",
+        "tags": "Schlagwörter",
+        "tagsHint": "Kommagetrennte Schlagwörter für zusätzliche Organisation",
+        "notes": "Notizen",
+        "notesPlaceholder": "Warum Sie diesem Blog folgen...",
+        "notesHint": "Persönliche Notizen (nicht öffentlich sichtbar)",
+        "pinned": "Diesen Blog anheften (oben in Listen anzeigen)",
+        "hidden": "Vor öffentlicher API verbergen (nur für Sie sichtbar)"
+      }
+    },
+
+    "api": {
+      "title": "API-Endpunkte",
+      "blogs": "Alle Blogs mit Metadaten auflisten",
+      "items": "Aktuelle Einträge von allen Blogs auflisten",
+      "categories": "Alle Kategorien auflisten",
+      "opml": "Als OPML exportieren",
+      "status": "Synchronisationsstatus und Statistiken"
+    }
+  }
+}

package/locales/es-419.json

@@ -0,0 +1,133 @@
+{
+  "blogroll": {
+    "title": "Blogroll",
+    "description": "Administra tus fuentes de blogroll y blogs",
+    "enabled": "Habilitado",
+    "disabled": "Deshabilitado",
+    "edit": "Editar",
+    "sync": "Sincronizar",
+    "refresh": "Actualizar",
+    "cancel": "Cancelar",
+    "never": "Nunca",
+
+    "stats": {
+      "title": "Resumen",
+      "sources": "Fuentes",
+      "blogs": "Blogs",
+      "items": "Entradas",
+      "errors": "Errores",
+      "lastSync": "Última sincronización"
+    },
+
+    "actions": {
+      "title": "Acciones",
+      "syncNow": "Sincronizar todo ahora",
+      "clearResync": "Limpiar y resincronizar",
+      "clearConfirm": "Esto eliminará todas las entradas almacenadas en caché y volverá a descargar todo. ¿Continuar?"
+    },
+
+    "errors": {
+      "title": "Blogs con errores",
+      "seeAll": "Ver los %{count} blogs con errores"
+    },
+
+    "sources": {
+      "title": "Sincronización OPML",
+      "manage": "Sincronización OPML",
+      "add": "Agregar fuente OPML",
+      "new": "Nueva fuente OPML",
+      "edit": "Editar fuente OPML",
+      "create": "Crear",
+      "save": "Guardar",
+      "empty": "No hay fuentes OPML configuradas. Usa esto para importar blogs de forma masiva desde FreshRSS u otros lectores de feeds.",
+      "recent": "Fuentes OPML",
+      "interval": "Cada %{minutes} min",
+      "lastSync": "Última sincronización",
+      "deleteConfirm": "¿Eliminar esta fuente OPML? Los blogs importados se conservarán.",
+      "created": "Fuente OPML creada exitosamente.",
+      "created_synced": "Fuente OPML creada y sincronizada exitosamente.",
+      "created_sync_failed": "Fuente OPML creada, pero la sincronización falló: %{error}",
+      "updated": "Fuente OPML actualizada exitosamente.",
+      "deleted": "Fuente OPML eliminada exitosamente.",
+      "synced": "Sincronización exitosa. Agregados: %{added}, Actualizados: %{updated}",
+      "form": {
+        "name": "Nombre",
+        "type": "Tipo de importación",
+        "typeHint": "La URL sincroniza periódicamente, el archivo es una importación única",
+        "url": "URL OPML",
+        "urlHint": "URL de tu archivo OPML (ej., URL de exportación de FreshRSS)",
+        "opmlContent": "Contenido OPML",
+        "opmlContentHint": "Pega aquí el contenido XML OPML completo",
+        "syncInterval": "Intervalo de sincronización",
+        "enabled": "Habilitar sincronización automática"
+      }
+    },
+
+    "blogs": {
+      "title": "Blogs",
+      "manage": "Administrar blogs",
+      "add": "Agregar blog",
+      "new": "Nuevo blog",
+      "edit": "Editar blog",
+      "create": "Agregar blog",
+      "save": "Guardar blog",
+      "empty": "Todavía no hay blogs. Agrega uno o importa desde una fuente OPML.",
+      "recent": "Blogs recientes",
+      "pinned": "Fijado",
+      "hidden": "Oculto",
+      "noItems": "Aún no se descargaron entradas.",
+      "recentItems": "Entradas recientes",
+      "allCategories": "Todas las categorías",
+      "allStatuses": "Todos los estados",
+      "statusActive": "Activo",
+      "statusError": "Error",
+      "statusPending": "Pendiente",
+      "clearFilters": "Limpiar filtros",
+      "deleteConfirm": "¿Eliminar este blog y todas sus entradas almacenadas?",
+      "created": "Blog agregado exitosamente.",
+      "created_synced": "Blog agregado y sincronizado. Se descargaron %{items} entradas.",
+      "created_sync_failed": "Blog agregado, pero la descarga inicial falló: %{error}",
+      "updated": "Blog actualizado exitosamente.",
+      "deleted": "Blog eliminado exitosamente.",
+      "refreshed": "Blog actualizado. Se agregaron %{items} entradas nuevas.",
+      "form": {
+        "discoverUrl": "URL del sitio web",
+        "discover": "Descubrir feed",
+        "discoverHint": "Ingresa una URL de sitio web para descubrir automáticamente su feed RSS/Atom",
+        "discoverNoUrl": "Por favor ingresa una URL de sitio web",
+        "discovering": "Descubriendo...",
+        "discoveringHint": "Buscando feeds RSS/Atom...",
+        "discoverFailed": "No se pudieron descubrir feeds",
+        "discoverNoFeeds": "No se encontraron feeds en este sitio web",
+        "discoverFoundOne": "Feed encontrado:",
+        "discoverFoundMultiple": "Se encontraron varios feeds. Hace clic en uno para seleccionarlo:",
+        "discoverSelected": "Feed seleccionado:",
+        "feedUrl": "URL del feed",
+        "feedUrlHint": "URL de RSS, Atom o JSON Feed",
+        "title": "Título",
+        "titlePlaceholder": "Detectado automáticamente del feed",
+        "titleHint": "Dejar en blanco para usar el título del feed",
+        "siteUrl": "URL del sitio",
+        "siteUrlHint": "Enlace a la página principal del blog (opcional)",
+        "category": "Categoría",
+        "categoryHint": "Agrupa blogs por categoría para filtrar y exportar a OPML",
+        "tags": "Etiquetas",
+        "tagsHint": "Etiquetas separadas por comas para organización adicional",
+        "notes": "Notas",
+        "notesPlaceholder": "Por qué sigues este blog...",
+        "notesHint": "Notas personales (no se muestran públicamente)",
+        "pinned": "Fijar este blog (mostrar al inicio de las listas)",
+        "hidden": "Ocultar de la API pública (visible solo para vos)"
+      }
+    },
+
+    "api": {
+      "title": "Endpoints de la API",
+      "blogs": "Listar todos los blogs con metadatos",
+      "items": "Listar entradas recientes de todos los blogs",
+      "categories": "Listar todas las categorías",
+      "opml": "Exportar como OPML",
+      "status": "Estado de sincronización y estadísticas"
+    }
+  }
+}