@rmdes/indiekit-endpoint-rss 1.0.10 → 1.0.12

package/README.md

@@ -0,0 +1,291 @@
+# @rmdes/indiekit-endpoint-rss
+
+RSS feed reader endpoint for Indiekit. Aggregates multiple feeds, caches in MongoDB, displays on frontend.
+
+## Features
+
+- **Multi-Feed Aggregation** - Subscribe to unlimited RSS/Atom/JSON feeds
+- **Background Sync** - Automatic updates every 15 minutes (configurable)
+- **MongoDB Caching** - Fast access to cached feed items
+- **Admin Dashboard** - Add/remove feeds, view recent items, trigger manual sync
+- **Public JSON API** - Read-only endpoints for frontend display
+- **Feed Management** - Enable/disable feeds, view sync status and errors
+- **Automatic Cleanup** - Prunes items older than 30 days (configurable)
+- **Format Support** - RSS 2.0, Atom, JSON Feed, Google Reader API (FreshRSS)
+- **Concurrency Control** - Fetches 3 feeds in parallel to avoid overwhelming servers
+- **HTML Sanitization** - Strips dangerous tags, keeps basic formatting
+
+## Installation
+
+```bash
+npm install @rmdes/indiekit-endpoint-rss
+```
+
+## Configuration
+
+Add to your `indiekit.config.js`:
+
+```javascript
+import RssEndpoint from "@rmdes/indiekit-endpoint-rss";
+
+export default {
+  plugins: [
+    new RssEndpoint({
+      mountPath: "/rssapi",          // Default: /rssapi
+      syncInterval: 900_000,         // 15 minutes (in milliseconds)
+      maxItemsPerFeed: 50,           // Max items per feed to cache
+      fetchTimeout: 10_000,          // 10 second timeout per feed
+      maxConcurrentFetches: 3,       // Parallel feed fetches
+      retentionDays: 30              // Days to keep items
+    })
+  ],
+  // MongoDB database is REQUIRED
+  mongodbUrl: process.env.MONGODB_URL
+};
+```
+
+## Usage
+
+### Admin Dashboard
+
+Navigate to `/rssapi` (or your configured `mountPath`) to access the admin dashboard.
+
+**Features:**
+- View all subscribed feeds
+- Add new feeds by URL
+- Enable/disable feeds
+- Remove feeds
+- View recent items
+- Manual sync trigger
+- Clear cache and re-sync
+
+### Adding Feeds
+
+**Via Admin UI:**
+1. Go to `/rssapi`
+2. Enter feed URL in the "Add Feed" form
+3. Click "Add Feed"
+
+**Via API:**
+```bash
+curl -X POST https://yoursite.com/rssapi/api/feeds \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -d '{"url": "https://example.com/feed.xml"}'
+```
+
+### Public API Endpoints
+
+**List All Feeds:**
+```bash
+GET /rssapi/api/feeds
+```
+
+**List Feed Items (Paginated):**
+```bash
+GET /rssapi/api/items?page=1&limit=20&feedId=FEED_ID&includeContent=true
+```
+
+**Get Single Item:**
+```bash
+GET /rssapi/api/items/:id
+```
+
+**Sync Status:**
+```bash
+GET /rssapi/api/status
+```
+
+### Example: Display Items in Eleventy
+
+```javascript
+// _data/rssItems.js
+export default async function () {
+  const response = await fetch("https://yoursite.com/rssapi/api/items?limit=10");
+  const data = await response.json();
+  return data.items;
+}
+```
+
+```nunjucks
+<!-- index.njk -->
+<h2>Latest News</h2>
+{% for item in rssItems %}
+  <article>
+    <h3><a href="{{ item.link }}">{{ item.title }}</a></h3>
+    <p class="meta">{{ item.feedTitle }} - {{ item.pubDate | date("PPp") }}</p>
+    <p>{{ item.description }}</p>
+    {% if item.imageUrl %}
+      <img src="{{ item.imageUrl }}" alt="">
+    {% endif %}
+  </article>
+{% endfor %}
+```
+
+## Supported Feed Formats
+
+- **RSS 2.0** - Standard blog feeds
+- **Atom** - GitHub releases, podcasts, etc.
+- **JSON Feed** - jsonfeed.org spec (v1.0, v1.1)
+- **Google Reader API** - FreshRSS, NewsBlur, Miniflux (use `?f=json` or `?f=greader`)
+
+## FreshRSS Integration
+
+This plugin has special support for FreshRSS (and other Google Reader API compatible aggregators):
+
+1. Get your FreshRSS API feed URL (Settings → Authentication → API feed URL)
+2. Add `?f=json` or `?f=greader` to the URL
+3. Add the URL to Indiekit RSS endpoint
+
+**Example:**
+```
+https://freshrss.example.com/api/greader.php/reader/api/0/stream/contents/reading-list?f=json&n=50&user=admin&apiKey=YOUR_API_KEY
+```
+
+**Features:**
+- Preserves original feed source (via `origin` object)
+- Filters out internal FreshRSS categories
+- Extracts images from media content
+- Handles FreshRSS timestamps (Unix seconds, microseconds)
+
+## API Reference
+
+### GET /api/feeds
+
+List all feeds.
+
+**Response:**
+```json
+{
+  "feeds": [
+    {
+      "id": "507f1f77bcf86cd799439011",
+      "url": "https://example.com/feed.xml",
+      "title": "Example Blog",
+      "siteUrl": "https://example.com",
+      "description": "A blog about things",
+      "imageUrl": "https://example.com/icon.png",
+      "enabled": true,
+      "addedAt": "2025-02-01T12:00:00.000Z",
+      "lastFetchedAt": "2025-02-13T14:30:00.000Z",
+      "lastError": null,
+      "itemCount": 42
+    }
+  ],
+  "total": 1
+}
+```
+
+### GET /api/items
+
+List feed items with pagination.
+
+**Query Parameters:**
+- `page` (number, default: 1) - Page number
+- `limit` (number, default: 20, max: 100) - Items per page
+- `feedId` (string, optional) - Filter by feed ID
+- `includeContent` (boolean, default: false) - Include full HTML content
+
+**Response:**
+```json
+{
+  "items": [
+    {
+      "id": "507f1f77bcf86cd799439012",
+      "feedId": "507f1f77bcf86cd799439011",
+      "feedTitle": "Example Blog",
+      "guid": "https://example.com/post-1",
+      "title": "Hello World",
+      "link": "https://example.com/post-1",
+      "description": "A short summary...",
+      "author": "John Doe",
+      "pubDate": "2025-02-13T12:00:00.000Z",
+      "imageUrl": "https://example.com/image.jpg",
+      "categories": ["tech", "web"],
+      "fetchedAt": "2025-02-13T14:30:00.000Z",
+      "sourceTitle": "Original Feed Title",
+      "sourceUrl": "https://original-source.com"
+    }
+  ],
+  "pagination": {
+    "page": 1,
+    "limit": 20,
+    "total": 100,
+    "totalPages": 5,
+    "hasNext": true,
+    "hasPrev": false
+  }
+}
+```
+
+### GET /api/items/:id
+
+Get a single item by ID.
+
+**Response:**
+```json
+{
+  "item": {
+    "id": "507f1f77bcf86cd799439012",
+    "feedId": "507f1f77bcf86cd799439011",
+    "feedTitle": "Example Blog",
+    "title": "Hello World",
+    "link": "https://example.com/post-1",
+    "description": "A short summary...",
+    "content": "<p>Full sanitized HTML content...</p>",
+    "author": "John Doe",
+    "pubDate": "2025-02-13T12:00:00.000Z",
+    "imageUrl": "https://example.com/image.jpg",
+    "categories": ["tech", "web"],
+    "enclosure": {
+      "url": "https://example.com/podcast.mp3",
+      "type": "audio/mpeg",
+      "length": 12345678
+    },
+    "fetchedAt": "2025-02-13T14:30:00.000Z"
+  }
+}
+```
+
+### GET /api/status
+
+Get sync status and statistics.
+
+**Response:**
+```json
+{
+  "status": "idle",
+  "lastSync": "2025-02-13T14:30:00.000Z",
+  "nextSync": "2025-02-13T14:45:00.000Z",
+  "lastError": null,
+  "stats": {
+    "feedsCount": 5,
+    "enabledFeedsCount": 4,
+    "itemsCount": 200,
+    "lastFeedsProcessed": 4,
+    "lastItemsAdded": 12
+  },
+  "config": {
+    "syncInterval": 900000,
+    "maxItemsPerFeed": 50
+  }
+}
+```
+
+## Requirements
+
+- **Indiekit** >= 1.0.0-beta.25
+- **MongoDB** database
+- **Node.js** >= 20
+
+## License
+
+MIT
+
+## Author
+
+Ricardo Mendes - https://rmendes.net
+
+## Repository
+
+https://github.com/rmdes/indiekit-endpoint-rss

package/lib/controllers/dashboard.js

@@ -68,7 +68,7 @@ export const dashboardController = {
         totalItems,
         syncState: {
           syncing: syncState.syncing,
-          lastSync: syncState.lastSync?.toISOString(),
+          lastSync: syncState.lastSync,
           lastError: syncState.lastError,
         },
         mountPath: request.baseUrl,

package/lib/sync.js

@@ -93,7 +93,7 @@ export async function runSync(dbOrIndiekit, options) {
     const feeds = await feedsCollection.find({ enabled: true }).toArray();
 
     if (feeds.length === 0) {
-      syncState.lastSync = new Date();
+      syncState.lastSync = new Date().toISOString();
       syncState.syncing = false;
       return { feedsProcessed: 0, itemsAdded: 0 };
     }
@@ -124,7 +124,7 @@ export async function runSync(dbOrIndiekit, options) {
       retentionDays,
     );
 
-    syncState.lastSync = new Date();
+    syncState.lastSync = new Date().toISOString();
     syncState.syncing = false;
 
     console.log(
@@ -176,7 +176,7 @@ async function syncFeed(
           siteUrl: feedMeta.siteUrl,
           description: feedMeta.description,
           imageUrl: feedMeta.imageUrl,
-          lastFetchedAt: new Date(),
+          lastFetchedAt: new Date().toISOString(),
           lastError: null,
         },
       }
@@ -196,7 +196,7 @@ async function syncFeed(
               feedId: feed._id,
               feedTitle: feedMeta.title,
               ...item,
-              fetchedAt: new Date(),
+              fetchedAt: new Date().toISOString(),
             },
           },
           { upsert: true }
@@ -230,7 +230,7 @@ async function syncFeed(
       { _id: feed._id },
       {
         $set: {
-          lastFetchedAt: new Date(),
+          lastFetchedAt: new Date().toISOString(),
           lastError: lastError,
         },
       }

package/lib/utils.js

@@ -1,5 +1,18 @@
 import sanitizeHtmlLib from "sanitize-html";
 
+/**
+ * Ensure a value is an ISO 8601 date string.
+ * Handles both Date objects (old MongoDB data) and strings (new data).
+ * @param {*} value - Date object, ISO string, or null
+ * @returns {string|null} ISO string or null
+ */
+function toISO(value) {
+  if (!value) return null;
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "string") return value;
+  return null;
+}
+
 /**
  * Sanitize HTML content - strip dangerous tags, keep basic formatting
  * @param {string} html - Raw HTML
@@ -116,10 +129,10 @@ export function formatItem(item, options = {}) {
     link: item.link,
     description: description || "",
     author: item.author,
-    pubDate: item.pubDate?.toISOString(),
+    pubDate: toISO(item.pubDate),
     imageUrl: item.imageUrl,
     categories: item.categories || [],
-    fetchedAt: item.fetchedAt?.toISOString(),
+    fetchedAt: toISO(item.fetchedAt),
     // Source info for aggregators (like FreshRSS) - represents the original feed
     sourceTitle: item.sourceTitle || null,
     sourceUrl: item.sourceUrl || null,
@@ -155,8 +168,8 @@ export function formatFeed(feed) {
     description: feed.description,
     imageUrl: feed.imageUrl,
     enabled: feed.enabled,
-    addedAt: feed.addedAt?.toISOString(),
-    lastFetchedAt: feed.lastFetchedAt?.toISOString(),
+    addedAt: toISO(feed.addedAt),
+    lastFetchedAt: toISO(feed.lastFetchedAt),
     lastError: feed.lastError,
     itemCount: feed.itemCount || 0,
   };

package/locales/de.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "RSS-Reader",
+    "feeds": "Feeds",
+    "items": "Feed-Einträge",
+    "addFeed": "Feed hinzufügen",
+    "removeFeed": "Feed entfernen",
+    "enableFeed": "Aktivieren",
+    "disableFeed": "Deaktivieren",
+    "syncNow": "Jetzt synchronisieren",
+    "clearResync": "Löschen & neu synchronisieren",
+    "syncing": "Synchronisiere...",
+    "lastSynced": "Zuletzt synchronisiert",
+    "noFeeds": "Keine Feeds konfiguriert. Fügen Sie eine Feed-URL hinzu, um zu beginnen.",
+    "noItems": "Keine Einträge gefunden.",
+    "feedUrl": "Feed-URL",
+    "feedUrlPlaceholder": "https://example.com/feed.xml",
+    "recentItems": "Aktuelle Einträge",
+    "viewAll": "Alle anzeigen",
+    "enabled": "Aktiviert",
+    "disabled": "Deaktiviert",
+    "itemCount": "Einträge",
+    "actions": "Aktionen",
+    "status": "Status",
+    "syncStatus": "Synchronisierungsstatus",
+    "feedsCount": "Feeds insgesamt",
+    "itemsCount": "Einträge insgesamt",
+    "lastSync": "Letzte Synchronisierung",
+    "nextSync": "Nächste Synchronisierung",
+    "never": "Nie",
+    "error": {
+      "invalidUrl": "Bitte geben Sie eine gültige Feed-URL ein",
+      "feedExists": "Dieser Feed wurde bereits hinzugefügt",
+      "feedNotFound": "Feed nicht gefunden",
+      "fetchFailed": "Feed konnte nicht abgerufen werden",
+      "noConfig": "RSS-Endpunkt nicht korrekt konfiguriert",
+      "noDatabase": "Datenbank nicht verfügbar"
+    },
+    "success": {
+      "feedAdded": "Feed erfolgreich hinzugefügt",
+      "feedRemoved": "Feed entfernt",
+      "feedEnabled": "Feed aktiviert",
+      "feedDisabled": "Feed deaktiviert",
+      "syncComplete": "Synchronisierung abgeschlossen",
+      "clearResync": "Einträge gelöscht und neu synchronisiert"
+    },
+    "widget": {
+      "description": "Aggregierte RSS-Feeds auf der öffentlichen Seite anzeigen",
+      "view": "Nachrichtenseite anzeigen"
+    }
+  }
+}

package/locales/es-419.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Lector RSS",
+    "feeds": "Fuentes",
+    "items": "Elementos de fuentes",
+    "addFeed": "Agregar fuente",
+    "removeFeed": "Quitar fuente",
+    "enableFeed": "Habilitar",
+    "disableFeed": "Deshabilitar",
+    "syncNow": "Sincronizar ahora",
+    "clearResync": "Limpiar y resincronizar",
+    "syncing": "Sincronizando...",
+    "lastSynced": "Última sincronización",
+    "noFeeds": "No hay fuentes configuradas. Agregá una URL de fuente para comenzar.",
+    "noItems": "No se encontraron elementos.",
+    "feedUrl": "URL de la fuente",
+    "feedUrlPlaceholder": "https://ejemplo.com/feed.xml",
+    "recentItems": "Elementos recientes",
+    "viewAll": "Ver todos",
+    "enabled": "Habilitado",
+    "disabled": "Deshabilitado",
+    "itemCount": "elementos",
+    "actions": "Acciones",
+    "status": "Estado",
+    "syncStatus": "Estado de sincronización",
+    "feedsCount": "Total de fuentes",
+    "itemsCount": "Total de elementos",
+    "lastSync": "Última sincronización",
+    "nextSync": "Próxima sincronización",
+    "never": "Nunca",
+    "error": {
+      "invalidUrl": "Por favor ingresá una URL de fuente válida",
+      "feedExists": "Esta fuente ya fue agregada",
+      "feedNotFound": "Fuente no encontrada",
+      "fetchFailed": "Error al obtener la fuente",
+      "noConfig": "El endpoint RSS no está configurado correctamente",
+      "noDatabase": "Base de datos no disponible"
+    },
+    "success": {
+      "feedAdded": "Fuente agregada exitosamente",
+      "feedRemoved": "Fuente quitada",
+      "feedEnabled": "Fuente habilitada",
+      "feedDisabled": "Fuente deshabilitada",
+      "syncComplete": "Sincronización completa",
+      "clearResync": "Elementos limpiados y resincronizados"
+    },
+    "widget": {
+      "description": "Ver fuentes RSS agregadas en la página pública",
+      "view": "Ver página de noticias"
+    }
+  }
+}

package/locales/es.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Lector RSS",
+    "feeds": "Fuentes",
+    "items": "Entradas de fuentes",
+    "addFeed": "Añadir fuente",
+    "removeFeed": "Eliminar fuente",
+    "enableFeed": "Activar",
+    "disableFeed": "Desactivar",
+    "syncNow": "Sincronizar ahora",
+    "clearResync": "Borrar y resincronizar",
+    "syncing": "Sincronizando...",
+    "lastSynced": "Última sincronización",
+    "noFeeds": "No hay fuentes configuradas. Añade una URL de fuente para empezar.",
+    "noItems": "No se encontraron entradas.",
+    "feedUrl": "URL de la fuente",
+    "feedUrlPlaceholder": "https://ejemplo.com/feed.xml",
+    "recentItems": "Entradas recientes",
+    "viewAll": "Ver todo",
+    "enabled": "Activado",
+    "disabled": "Desactivado",
+    "itemCount": "entradas",
+    "actions": "Acciones",
+    "status": "Estado",
+    "syncStatus": "Estado de sincronización",
+    "feedsCount": "Total de fuentes",
+    "itemsCount": "Total de entradas",
+    "lastSync": "Última sincronización",
+    "nextSync": "Próxima sincronización",
+    "never": "Nunca",
+    "error": {
+      "invalidUrl": "Por favor, introduce una URL de fuente válida",
+      "feedExists": "Esta fuente ya ha sido añadida",
+      "feedNotFound": "Fuente no encontrada",
+      "fetchFailed": "Error al obtener la fuente",
+      "noConfig": "El endpoint RSS no está configurado correctamente",
+      "noDatabase": "Base de datos no disponible"
+    },
+    "success": {
+      "feedAdded": "Fuente añadida correctamente",
+      "feedRemoved": "Fuente eliminada",
+      "feedEnabled": "Fuente activada",
+      "feedDisabled": "Fuente desactivada",
+      "syncComplete": "Sincronización completa",
+      "clearResync": "Entradas borradas y resincronizadas"
+    },
+    "widget": {
+      "description": "Ver fuentes RSS agregadas en la página pública",
+      "view": "Ver página de noticias"
+    }
+  }
+}

package/locales/fr.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Lecteur RSS",
+    "feeds": "Flux",
+    "items": "Articles de flux",
+    "addFeed": "Ajouter un flux",
+    "removeFeed": "Supprimer le flux",
+    "enableFeed": "Activer",
+    "disableFeed": "Désactiver",
+    "syncNow": "Synchroniser maintenant",
+    "clearResync": "Effacer et resynchroniser",
+    "syncing": "Synchronisation...",
+    "lastSynced": "Dernière synchronisation",
+    "noFeeds": "Aucun flux configuré. Ajoutez une URL de flux pour commencer.",
+    "noItems": "Aucun article trouvé.",
+    "feedUrl": "URL du flux",
+    "feedUrlPlaceholder": "https://exemple.com/feed.xml",
+    "recentItems": "Articles récents",
+    "viewAll": "Voir tout",
+    "enabled": "Activé",
+    "disabled": "Désactivé",
+    "itemCount": "articles",
+    "actions": "Actions",
+    "status": "Statut",
+    "syncStatus": "État de synchronisation",
+    "feedsCount": "Total des flux",
+    "itemsCount": "Total des articles",
+    "lastSync": "Dernière synchronisation",
+    "nextSync": "Prochaine synchronisation",
+    "never": "Jamais",
+    "error": {
+      "invalidUrl": "Veuillez saisir une URL de flux valide",
+      "feedExists": "Ce flux a déjà été ajouté",
+      "feedNotFound": "Flux introuvable",
+      "fetchFailed": "Échec de récupération du flux",
+      "noConfig": "Le point de terminaison RSS n'est pas configuré correctement",
+      "noDatabase": "Base de données non disponible"
+    },
+    "success": {
+      "feedAdded": "Flux ajouté avec succès",
+      "feedRemoved": "Flux supprimé",
+      "feedEnabled": "Flux activé",
+      "feedDisabled": "Flux désactivé",
+      "syncComplete": "Synchronisation terminée",
+      "clearResync": "Articles effacés et resynchronisés"
+    },
+    "widget": {
+      "description": "Voir les flux RSS agrégés sur la page publique",
+      "view": "Voir la page d'actualités"
+    }
+  }
+}

package/locales/hi.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "RSS रीडर",
+    "feeds": "फ़ीड",
+    "items": "फ़ीड आइटम",
+    "addFeed": "फ़ीड जोड़ें",
+    "removeFeed": "फ़ीड हटाएं",
+    "enableFeed": "सक्षम करें",
+    "disableFeed": "अक्षम करें",
+    "syncNow": "अभी सिंक करें",
+    "clearResync": "साफ़ करें और फिर से सिंक करें",
+    "syncing": "सिंक हो रहा है...",
+    "lastSynced": "अंतिम सिंक",
+    "noFeeds": "कोई फ़ीड कॉन्फ़िगर नहीं है। शुरू करने के लिए एक फ़ीड URL जोड़ें।",
+    "noItems": "कोई आइटम नहीं मिला।",
+    "feedUrl": "फ़ीड URL",
+    "feedUrlPlaceholder": "https://example.com/feed.xml",
+    "recentItems": "हाल के आइटम",
+    "viewAll": "सभी देखें",
+    "enabled": "सक्षम",
+    "disabled": "अक्षम",
+    "itemCount": "आइटम",
+    "actions": "क्रियाएं",
+    "status": "स्थिति",
+    "syncStatus": "सिंक स्थिति",
+    "feedsCount": "कुल फ़ीड",
+    "itemsCount": "कुल आइटम",
+    "lastSync": "अंतिम सिंक",
+    "nextSync": "अगला सिंक",
+    "never": "कभी नहीं",
+    "error": {
+      "invalidUrl": "कृपया एक मान्य फ़ीड URL दर्ज करें",
+      "feedExists": "यह फ़ीड पहले से जोड़ा गया है",
+      "feedNotFound": "फ़ीड नहीं मिला",
+      "fetchFailed": "फ़ीड लाने में विफल",
+      "noConfig": "RSS एंडपॉइंट सही तरीके से कॉन्फ़िगर नहीं है",
+      "noDatabase": "डेटाबेस उपलब्ध नहीं है"
+    },
+    "success": {
+      "feedAdded": "फ़ीड सफलतापूर्वक जोड़ा गया",
+      "feedRemoved": "फ़ीड हटाया गया",
+      "feedEnabled": "फ़ीड सक्षम किया गया",
+      "feedDisabled": "फ़ीड अक्षम किया गया",
+      "syncComplete": "सिंक पूर्ण",
+      "clearResync": "आइटम साफ़ किए गए और फिर से सिंक किए गए"
+    },
+    "widget": {
+      "description": "सार्वजनिक पृष्ठ पर समेकित RSS फ़ीड देखें",
+      "view": "समाचार पृष्ठ देखें"
+    }
+  }
+}

package/locales/id.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Pembaca RSS",
+    "feeds": "Umpan",
+    "items": "Item Umpan",
+    "addFeed": "Tambah Umpan",
+    "removeFeed": "Hapus Umpan",
+    "enableFeed": "Aktifkan",
+    "disableFeed": "Nonaktifkan",
+    "syncNow": "Sinkronkan Sekarang",
+    "clearResync": "Hapus & Sinkronkan Ulang",
+    "syncing": "Menyinkronkan...",
+    "lastSynced": "Terakhir disinkronkan",
+    "noFeeds": "Tidak ada umpan yang dikonfigurasi. Tambahkan URL umpan untuk memulai.",
+    "noItems": "Tidak ada item ditemukan.",
+    "feedUrl": "URL Umpan",
+    "feedUrlPlaceholder": "https://contoh.com/feed.xml",
+    "recentItems": "Item Terbaru",
+    "viewAll": "Lihat Semua",
+    "enabled": "Aktif",
+    "disabled": "Nonaktif",
+    "itemCount": "item",
+    "actions": "Tindakan",
+    "status": "Status",
+    "syncStatus": "Status Sinkronisasi",
+    "feedsCount": "Total Umpan",
+    "itemsCount": "Total Item",
+    "lastSync": "Sinkronisasi Terakhir",
+    "nextSync": "Sinkronisasi Berikutnya",
+    "never": "Tidak Pernah",
+    "error": {
+      "invalidUrl": "Masukkan URL umpan yang valid",
+      "feedExists": "Umpan ini sudah ditambahkan",
+      "feedNotFound": "Umpan tidak ditemukan",
+      "fetchFailed": "Gagal mengambil umpan",
+      "noConfig": "Endpoint RSS tidak dikonfigurasi dengan benar",
+      "noDatabase": "Basis data tidak tersedia"
+    },
+    "success": {
+      "feedAdded": "Umpan berhasil ditambahkan",
+      "feedRemoved": "Umpan dihapus",
+      "feedEnabled": "Umpan diaktifkan",
+      "feedDisabled": "Umpan dinonaktifkan",
+      "syncComplete": "Sinkronisasi selesai",
+      "clearResync": "Item dihapus dan disinkronkan ulang"
+    },
+    "widget": {
+      "description": "Lihat umpan RSS terkumpul di halaman publik",
+      "view": "Lihat Halaman Berita"
+    }
+  }
+}

package/locales/it.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Lettore RSS",
+    "feeds": "Feed",
+    "items": "Elementi del feed",
+    "addFeed": "Aggiungi feed",
+    "removeFeed": "Rimuovi feed",
+    "enableFeed": "Abilita",
+    "disableFeed": "Disabilita",
+    "syncNow": "Sincronizza ora",
+    "clearResync": "Cancella e risincronizza",
+    "syncing": "Sincronizzazione...",
+    "lastSynced": "Ultima sincronizzazione",
+    "noFeeds": "Nessun feed configurato. Aggiungi un URL feed per iniziare.",
+    "noItems": "Nessun elemento trovato.",
+    "feedUrl": "URL del feed",
+    "feedUrlPlaceholder": "https://esempio.com/feed.xml",
+    "recentItems": "Elementi recenti",
+    "viewAll": "Visualizza tutto",
+    "enabled": "Abilitato",
+    "disabled": "Disabilitato",
+    "itemCount": "elementi",
+    "actions": "Azioni",
+    "status": "Stato",
+    "syncStatus": "Stato sincronizzazione",
+    "feedsCount": "Totale feed",
+    "itemsCount": "Totale elementi",
+    "lastSync": "Ultima sincronizzazione",
+    "nextSync": "Prossima sincronizzazione",
+    "never": "Mai",
+    "error": {
+      "invalidUrl": "Inserisci un URL feed valido",
+      "feedExists": "Questo feed è già stato aggiunto",
+      "feedNotFound": "Feed non trovato",
+      "fetchFailed": "Recupero del feed non riuscito",
+      "noConfig": "Endpoint RSS non configurato correttamente",
+      "noDatabase": "Database non disponibile"
+    },
+    "success": {
+      "feedAdded": "Feed aggiunto con successo",
+      "feedRemoved": "Feed rimosso",
+      "feedEnabled": "Feed abilitato",
+      "feedDisabled": "Feed disabilitato",
+      "syncComplete": "Sincronizzazione completata",
+      "clearResync": "Elementi cancellati e risincronizzati"
+    },
+    "widget": {
+      "description": "Visualizza i feed RSS aggregati sulla pagina pubblica",
+      "view": "Visualizza pagina notizie"
+    }
+  }
+}

package/locales/nl.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "RSS-lezer",
+    "feeds": "Feeds",
+    "items": "Feed-items",
+    "addFeed": "Feed toevoegen",
+    "removeFeed": "Feed verwijderen",
+    "enableFeed": "Inschakelen",
+    "disableFeed": "Uitschakelen",
+    "syncNow": "Nu synchroniseren",
+    "clearResync": "Wissen en opnieuw synchroniseren",
+    "syncing": "Synchroniseren...",
+    "lastSynced": "Laatst gesynchroniseerd",
+    "noFeeds": "Geen feeds geconfigureerd. Voeg een feed-URL toe om te beginnen.",
+    "noItems": "Geen items gevonden.",
+    "feedUrl": "Feed-URL",
+    "feedUrlPlaceholder": "https://voorbeeld.nl/feed.xml",
+    "recentItems": "Recente items",
+    "viewAll": "Alles bekijken",
+    "enabled": "Ingeschakeld",
+    "disabled": "Uitgeschakeld",
+    "itemCount": "items",
+    "actions": "Acties",
+    "status": "Status",
+    "syncStatus": "Synchronisatiestatus",
+    "feedsCount": "Totaal aantal feeds",
+    "itemsCount": "Totaal aantal items",
+    "lastSync": "Laatste synchronisatie",
+    "nextSync": "Volgende synchronisatie",
+    "never": "Nooit",
+    "error": {
+      "invalidUrl": "Voer een geldige feed-URL in",
+      "feedExists": "Deze feed is al toegevoegd",
+      "feedNotFound": "Feed niet gevonden",
+      "fetchFailed": "Ophalen van feed mislukt",
+      "noConfig": "RSS-endpoint niet correct geconfigureerd",
+      "noDatabase": "Database niet beschikbaar"
+    },
+    "success": {
+      "feedAdded": "Feed succesvol toegevoegd",
+      "feedRemoved": "Feed verwijderd",
+      "feedEnabled": "Feed ingeschakeld",
+      "feedDisabled": "Feed uitgeschakeld",
+      "syncComplete": "Synchronisatie voltooid",
+      "clearResync": "Items gewist en opnieuw gesynchroniseerd"
+    },
+    "widget": {
+      "description": "Bekijk geaggregeerde RSS-feeds op de openbare pagina",
+      "view": "Bekijk nieuwspagina"
+    }
+  }
+}

package/locales/pl.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Czytnik RSS",
+    "feeds": "Kanały",
+    "items": "Elementy kanałów",
+    "addFeed": "Dodaj kanał",
+    "removeFeed": "Usuń kanał",
+    "enableFeed": "Włącz",
+    "disableFeed": "Wyłącz",
+    "syncNow": "Synchronizuj teraz",
+    "clearResync": "Wyczyść i zsynchronizuj ponownie",
+    "syncing": "Synchronizacja...",
+    "lastSynced": "Ostatnia synchronizacja",
+    "noFeeds": "Brak skonfigurowanych kanałów. Dodaj adres URL kanału, aby rozpocząć.",
+    "noItems": "Nie znaleziono elementów.",
+    "feedUrl": "Adres URL kanału",
+    "feedUrlPlaceholder": "https://przyklad.pl/feed.xml",
+    "recentItems": "Ostatnie elementy",
+    "viewAll": "Pokaż wszystkie",
+    "enabled": "Włączony",
+    "disabled": "Wyłączony",
+    "itemCount": "elementów",
+    "actions": "Działania",
+    "status": "Status",
+    "syncStatus": "Status synchronizacji",
+    "feedsCount": "Łącznie kanałów",
+    "itemsCount": "Łącznie elementów",
+    "lastSync": "Ostatnia synchronizacja",
+    "nextSync": "Następna synchronizacja",
+    "never": "Nigdy",
+    "error": {
+      "invalidUrl": "Wprowadź prawidłowy adres URL kanału",
+      "feedExists": "Ten kanał został już dodany",
+      "feedNotFound": "Nie znaleziono kanału",
+      "fetchFailed": "Nie udało się pobrać kanału",
+      "noConfig": "Endpoint RSS nie jest poprawnie skonfigurowany",
+      "noDatabase": "Baza danych niedostępna"
+    },
+    "success": {
+      "feedAdded": "Kanał dodany pomyślnie",
+      "feedRemoved": "Kanał usunięty",
+      "feedEnabled": "Kanał włączony",
+      "feedDisabled": "Kanał wyłączony",
+      "syncComplete": "Synchronizacja zakończona",
+      "clearResync": "Elementy wyczyszczone i zsynchronizowane ponownie"
+    },
+    "widget": {
+      "description": "Wyświetl zagregowane kanały RSS na stronie publicznej",
+      "view": "Zobacz stronę aktualności"
+    }
+  }
+}

package/locales/pt-BR.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Leitor RSS",
+    "feeds": "Feeds",
+    "items": "Itens de feeds",
+    "addFeed": "Adicionar feed",
+    "removeFeed": "Remover feed",
+    "enableFeed": "Ativar",
+    "disableFeed": "Desativar",
+    "syncNow": "Sincronizar agora",
+    "clearResync": "Limpar e ressincronizar",
+    "syncing": "Sincronizando...",
+    "lastSynced": "Última sincronização",
+    "noFeeds": "Nenhum feed configurado. Adicione uma URL de feed para começar.",
+    "noItems": "Nenhum item encontrado.",
+    "feedUrl": "URL do feed",
+    "feedUrlPlaceholder": "https://exemplo.com/feed.xml",
+    "recentItems": "Itens recentes",
+    "viewAll": "Ver tudo",
+    "enabled": "Ativado",
+    "disabled": "Desativado",
+    "itemCount": "itens",
+    "actions": "Ações",
+    "status": "Status",
+    "syncStatus": "Status de sincronização",
+    "feedsCount": "Total de feeds",
+    "itemsCount": "Total de itens",
+    "lastSync": "Última sincronização",
+    "nextSync": "Próxima sincronização",
+    "never": "Nunca",
+    "error": {
+      "invalidUrl": "Por favor, insira uma URL de feed válida",
+      "feedExists": "Este feed já foi adicionado",
+      "feedNotFound": "Feed não encontrado",
+      "fetchFailed": "Falha ao buscar o feed",
+      "noConfig": "O endpoint RSS não está configurado corretamente",
+      "noDatabase": "Banco de dados não disponível"
+    },
+    "success": {
+      "feedAdded": "Feed adicionado com sucesso",
+      "feedRemoved": "Feed removido",
+      "feedEnabled": "Feed ativado",
+      "feedDisabled": "Feed desativado",
+      "syncComplete": "Sincronização concluída",
+      "clearResync": "Itens limpos e ressincronizados"
+    },
+    "widget": {
+      "description": "Ver feeds RSS agregados na página pública",
+      "view": "Ver página de notícias"
+    }
+  }
+}

package/locales/pt.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "Leitor RSS",
+    "feeds": "Feeds",
+    "items": "Itens de feeds",
+    "addFeed": "Adicionar feed",
+    "removeFeed": "Remover feed",
+    "enableFeed": "Activar",
+    "disableFeed": "Desactivar",
+    "syncNow": "Sincronizar agora",
+    "clearResync": "Limpar e ressincronizar",
+    "syncing": "A sincronizar...",
+    "lastSynced": "Última sincronização",
+    "noFeeds": "Nenhum feed configurado. Adicione um URL de feed para começar.",
+    "noItems": "Nenhum item encontrado.",
+    "feedUrl": "URL do feed",
+    "feedUrlPlaceholder": "https://exemplo.com/feed.xml",
+    "recentItems": "Itens recentes",
+    "viewAll": "Ver tudo",
+    "enabled": "Activado",
+    "disabled": "Desactivado",
+    "itemCount": "itens",
+    "actions": "Acções",
+    "status": "Estado",
+    "syncStatus": "Estado de sincronização",
+    "feedsCount": "Total de feeds",
+    "itemsCount": "Total de itens",
+    "lastSync": "Última sincronização",
+    "nextSync": "Próxima sincronização",
+    "never": "Nunca",
+    "error": {
+      "invalidUrl": "Por favor, introduza um URL de feed válido",
+      "feedExists": "Este feed já foi adicionado",
+      "feedNotFound": "Feed não encontrado",
+      "fetchFailed": "Falha ao obter o feed",
+      "noConfig": "O endpoint RSS não está configurado correctamente",
+      "noDatabase": "Base de dados não disponível"
+    },
+    "success": {
+      "feedAdded": "Feed adicionado com sucesso",
+      "feedRemoved": "Feed removido",
+      "feedEnabled": "Feed activado",
+      "feedDisabled": "Feed desactivado",
+      "syncComplete": "Sincronização concluída",
+      "clearResync": "Itens limpos e ressincronizados"
+    },
+    "widget": {
+      "description": "Ver feeds RSS agregados na página pública",
+      "view": "Ver página de notícias"
+    }
+  }
+}

package/locales/sr.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "RSS читач",
+    "feeds": "Довоји",
+    "items": "Ставке довода",
+    "addFeed": "Додај довод",
+    "removeFeed": "Уклони довод",
+    "enableFeed": "Омогући",
+    "disableFeed": "Онемогући",
+    "syncNow": "Синхронизуј сада",
+    "clearResync": "Обриши и поново синхронизуј",
+    "syncing": "Синхронизација...",
+    "lastSynced": "Последња синхронизација",
+    "noFeeds": "Нема конфигурисаних довода. Додајте URL довода да бисте почели.",
+    "noItems": "Нема пронађених ставки.",
+    "feedUrl": "URL довода",
+    "feedUrlPlaceholder": "https://primer.rs/feed.xml",
+    "recentItems": "Недавне ставке",
+    "viewAll": "Прикажи све",
+    "enabled": "Омогућено",
+    "disabled": "Онемогућено",
+    "itemCount": "ставки",
+    "actions": "Радње",
+    "status": "Статус",
+    "syncStatus": "Статус синхронизације",
+    "feedsCount": "Укупно довода",
+    "itemsCount": "Укупно ставки",
+    "lastSync": "Последња синхронизација",
+    "nextSync": "Следећа синхронизација",
+    "never": "Никада",
+    "error": {
+      "invalidUrl": "Молимо унесите важећи URL довода",
+      "feedExists": "Овај довод је већ додат",
+      "feedNotFound": "Довод није пронађен",
+      "fetchFailed": "Неуспешно преузимање довода",
+      "noConfig": "RSS крајња тачка није правилно конфигурисана",
+      "noDatabase": "База података није доступна"
+    },
+    "success": {
+      "feedAdded": "Довод је успешно додат",
+      "feedRemoved": "Довод уклоњен",
+      "feedEnabled": "Довод омогућен",
+      "feedDisabled": "Довод онемогућен",
+      "syncComplete": "Синхронизација завршена",
+      "clearResync": "Ставке обрисане и поново синхронизоване"
+    },
+    "widget": {
+      "description": "Погледајте обједињене RSS доводе на јавној страници",
+      "view": "Погледај страницу вести"
+    }
+  }
+}

package/locales/sv.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "RSS-läsare",
+    "feeds": "Flöden",
+    "items": "Flödesobjekt",
+    "addFeed": "Lägg till flöde",
+    "removeFeed": "Ta bort flöde",
+    "enableFeed": "Aktivera",
+    "disableFeed": "Inaktivera",
+    "syncNow": "Synkronisera nu",
+    "clearResync": "Rensa och synkronisera om",
+    "syncing": "Synkroniserar...",
+    "lastSynced": "Senast synkroniserad",
+    "noFeeds": "Inga flöden konfigurerade. Lägg till en flödes-URL för att komma igång.",
+    "noItems": "Inga objekt hittades.",
+    "feedUrl": "Flödes-URL",
+    "feedUrlPlaceholder": "https://exempel.se/feed.xml",
+    "recentItems": "Senaste objekten",
+    "viewAll": "Visa alla",
+    "enabled": "Aktiverad",
+    "disabled": "Inaktiverad",
+    "itemCount": "objekt",
+    "actions": "Åtgärder",
+    "status": "Status",
+    "syncStatus": "Synkroniseringsstatus",
+    "feedsCount": "Totalt antal flöden",
+    "itemsCount": "Totalt antal objekt",
+    "lastSync": "Senaste synkronisering",
+    "nextSync": "Nästa synkronisering",
+    "never": "Aldrig",
+    "error": {
+      "invalidUrl": "Ange en giltig flödes-URL",
+      "feedExists": "Detta flöde har redan lagts till",
+      "feedNotFound": "Flödet hittades inte",
+      "fetchFailed": "Misslyckades med att hämta flöde",
+      "noConfig": "RSS-ändpunkten är inte korrekt konfigurerad",
+      "noDatabase": "Databasen är inte tillgänglig"
+    },
+    "success": {
+      "feedAdded": "Flödet har lagts till",
+      "feedRemoved": "Flödet har tagits bort",
+      "feedEnabled": "Flödet aktiverat",
+      "feedDisabled": "Flödet inaktiverat",
+      "syncComplete": "Synkronisering klar",
+      "clearResync": "Objekt rensade och omsynkroniserade"
+    },
+    "widget": {
+      "description": "Visa aggregerade RSS-flöden på den publika sidan",
+      "view": "Visa nyhetssida"
+    }
+  }
+}

package/locales/zh-Hans-CN.json

@@ -0,0 +1,52 @@
+{
+  "rss": {
+    "title": "RSS 阅读器",
+    "feeds": "订阅源",
+    "items": "订阅项目",
+    "addFeed": "添加订阅源",
+    "removeFeed": "删除订阅源",
+    "enableFeed": "启用",
+    "disableFeed": "禁用",
+    "syncNow": "立即同步",
+    "clearResync": "清除并重新同步",
+    "syncing": "同步中...",
+    "lastSynced": "上次同步",
+    "noFeeds": "未配置订阅源。添加订阅源 URL 以开始使用。",
+    "noItems": "未找到任何项目。",
+    "feedUrl": "订阅源 URL",
+    "feedUrlPlaceholder": "https://example.com/feed.xml",
+    "recentItems": "最近项目",
+    "viewAll": "查看全部",
+    "enabled": "已启用",
+    "disabled": "已禁用",
+    "itemCount": "项",
+    "actions": "操作",
+    "status": "状态",
+    "syncStatus": "同步状态",
+    "feedsCount": "订阅源总数",
+    "itemsCount": "项目总数",
+    "lastSync": "上次同步",
+    "nextSync": "下次同步",
+    "never": "从未",
+    "error": {
+      "invalidUrl": "请输入有效的订阅源 URL",
+      "feedExists": "此订阅源已添加",
+      "feedNotFound": "未找到订阅源",
+      "fetchFailed": "获取订阅源失败",
+      "noConfig": "RSS 端点未正确配置",
+      "noDatabase": "数据库不可用"
+    },
+    "success": {
+      "feedAdded": "订阅源添加成功",
+      "feedRemoved": "订阅源已删除",
+      "feedEnabled": "订阅源已启用",
+      "feedDisabled": "订阅源已禁用",
+      "syncComplete": "同步完成",
+      "clearResync": "项目已清除并重新同步"
+    },
+    "widget": {
+      "description": "在公共页面上查看聚合的 RSS 订阅源",
+      "view": "查看新闻页面"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-rss",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "RSS feed reader endpoint for Indiekit. Aggregates multiple feeds, caches in MongoDB, displays on frontend.",
   "keywords": [
     "indiekit",