@rmdes/indiekit-endpoint-youtube 1.2.2 → 1.2.3

package/README.md

@@ -5,7 +5,7 @@
 
 YouTube channel endpoint for [Indiekit](https://getindiekit.com/).
 
-Display latest videos and live streaming status from any YouTube channel on your IndieWeb site.
+Display latest videos and live streaming status from any YouTube channel (or multiple channels) on your IndieWeb site.
 
 ## Installation
 
@@ -17,7 +17,8 @@ npm install @rmdes/indiekit-endpoint-youtube
 
 ## Features
 
-- **Admin Dashboard** - Overview of channel with latest videos in Indiekit's admin UI
+- **Single or Multi-Channel** - Monitor one channel or aggregate multiple channels
+- **Admin Dashboard** - Overview of channel(s) with latest videos in Indiekit's admin UI
 - **Live Status** - Shows when channel is live streaming (with animated badge)
 - **Upcoming Streams** - Display scheduled upcoming live streams
 - **Latest Videos** - Grid of recent uploads with thumbnails, duration, view counts
@@ -27,6 +28,8 @@ npm install @rmdes/indiekit-endpoint-youtube
 
 ## Configuration
 
+### Single Channel
+
 Add to your `indiekit.config.js`:
 
 ```javascript
@@ -50,6 +53,39 @@ export default {
 };
 ```
 
+### Multiple Channels
+
+Monitor multiple YouTube channels simultaneously:
+
+```javascript
+import YouTubeEndpoint from "@rmdes/indiekit-endpoint-youtube";
+
+export default {
+  plugins: [
+    new YouTubeEndpoint({
+      mountPath: "/youtube",
+      apiKey: process.env.YOUTUBE_API_KEY,
+      channels: [
+        { id: "UC...", name: "Main Channel" },
+        { handle: "@SecondChannel", name: "Second Channel" },
+        { id: "UC...", name: "Third Channel" },
+      ],
+      cacheTtl: 300_000,
+      liveCacheTtl: 60_000,
+      limits: {
+        videos: 10,
+      },
+    }),
+  ],
+};
+```
+
+In multi-channel mode:
+- Dashboard shows all channels with separate sections
+- API endpoints aggregate data from all channels
+- Videos are sorted by date across all channels
+- Live status shows any channel that is currently live
+
 ## Environment Variables
 
 | Variable | Required | Description |
@@ -58,7 +94,7 @@ export default {
 | `YOUTUBE_CHANNEL_ID` | Yes* | Channel ID (starts with `UC...`) |
 | `YOUTUBE_CHANNEL_HANDLE` | Yes* | Channel handle (e.g., `@YourChannel`) |
 
-*Either `channelId` or `channelHandle` is required.
+*Either `channelId` or `channelHandle` is required for single-channel mode. In multi-channel mode, use the `channels` array instead.
 
 ### Getting a YouTube API Key
 
@@ -81,7 +117,7 @@ export default {
 | Route | Description |
 |-------|-------------|
 | `GET /youtube/` | Dashboard with channel info, live status, latest videos |
-| `POST /youtube/refresh` | Clear cache and refresh data |
+| `POST /youtube/refresh` | Clear cache and refresh data (returns JSON) |
 
 ### Public API Routes (JSON)
 
@@ -89,7 +125,8 @@ export default {
 |-------|-------------|
 | `GET /youtube/api/videos` | Latest videos (supports `?limit=N`) |
 | `GET /youtube/api/channel` | Channel information |
-| `GET /youtube/api/live` | Live streaming status |
+| `GET /youtube/api/live` | Live streaming status (efficient by default) |
+| `GET /youtube/api/live?full=true` | Live status using search API (more accurate, costs more quota) |
 
 ### Example: Eleventy Integration
 
@@ -119,6 +156,7 @@ export default async function() {
 
 ### GET /youtube/api/live
 
+**Single channel:**
 ```json
 {
   "isLive": true,
@@ -133,8 +171,34 @@ export default async function() {
 }
 ```
 
+**Multi-channel:**
+```json
+{
+  "isLive": true,
+  "isUpcoming": false,
+  "stream": {
+    "videoId": "abc123",
+    "title": "Live Stream Title"
+  },
+  "liveStatuses": [
+    {
+      "channelConfigName": "Main Channel",
+      "isLive": true,
+      "stream": { "videoId": "abc123" }
+    },
+    {
+      "channelConfigName": "Second Channel",
+      "isLive": false,
+      "stream": null
+    }
+  ],
+  "cached": true
+}
+```
+
 ### GET /youtube/api/videos
 
+**Single channel:**
 ```json
 {
   "videos": [
@@ -155,17 +219,75 @@ export default async function() {
 }
 ```
 
+**Multi-channel:**
+```json
+{
+  "videos": [],
+  "videosByChannel": {
+    "Main Channel": [],
+    "Second Channel": []
+  },
+  "count": 20,
+  "cached": true
+}
+```
+
+### GET /youtube/api/channel
+
+**Single channel:**
+```json
+{
+  "channel": {
+    "id": "UC...",
+    "title": "Channel Name",
+    "description": "Channel description",
+    "thumbnail": "https://...",
+    "subscriberCount": 12345,
+    "videoCount": 100,
+    "viewCount": 999999
+  },
+  "cached": true
+}
+```
+
+**Multi-channel:**
+```json
+{
+  "channels": [
+    { "id": "UC...", "title": "Channel 1", "configName": "Main Channel" },
+    { "id": "UC...", "title": "Channel 2", "configName": "Second Channel" }
+  ],
+  "channel": {},
+  "cached": true
+}
+```
+
 ## Options
 
 | Option | Default | Description |
 |--------|---------|-------------|
 | `mountPath` | `/youtube` | URL path for the endpoint |
 | `apiKey` | - | YouTube Data API key |
-| `channelId` | - | Channel ID (UC...) |
-| `channelHandle` | - | Channel handle (@...) |
+| `channelId` | - | Channel ID (UC...) - single channel mode |
+| `channelHandle` | - | Channel handle (@...) - single channel mode |
+| `channels` | `null` | Array of channels for multi-channel mode |
 | `cacheTtl` | `300000` | Cache TTL in ms (5 min) |
 | `liveCacheTtl` | `60000` | Live status cache TTL in ms (1 min) |
-| `limits.videos` | `10` | Number of videos to fetch |
+| `limits.videos` | `10` | Number of videos to fetch per channel |
+
+### Channels Array Format
+
+For multi-channel mode, the `channels` option accepts an array of objects:
+
+```javascript
+channels: [
+  { id: "UC...", name: "Display Name" },          // Using channel ID
+  { handle: "@username", name: "Display Name" },  // Using handle
+  { id: "UC..." }                                  // Name defaults to channel title
+]
+```
+
+Either `id` or `handle` is required. The `name` field is optional and used for display purposes.
 
 ## Quota Efficiency
 
@@ -175,16 +297,19 @@ YouTube Data API has a daily quota (10,000 units by default). This plugin is opt
 |-----------|------------|--------|
 | Get videos | 2 units | Uses uploads playlist (not search) |
 | Get channel | 1 unit | Cached for 24 hours |
-| Check live status | 2 units | Checks recent videos (efficient) |
-| Full live search | 100 units | Only when explicitly requested |
+| Check live status (efficient) | 2 units | Checks recent videos |
+| Check live status (full) | 100 units | Only when explicitly requested |
+
+**Single channel:** With default settings (5-min cache), ~600 units/day.
 
-With default settings (5-min cache), you'll use ~600 units/day for video checks.
+**Multi-channel:** Quota usage scales linearly. 3 channels = ~1,800 units/day.
 
 ## Requirements
 
 - Indiekit >= 1.0.0-beta.25
 - YouTube Data API v3 enabled
 - Valid API key with YouTube Data API access
+- Node.js >= 20
 
 ## License
 

package/locales/de.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Neueste Videos",
+    "channel": "Kanal",
+    "live": "Live jetzt",
+    "upcoming": "Demnächst",
+    "offline": "Offline",
+    "subscribers": "Abonnenten",
+    "views": "Aufrufe",
+    "watchNow": "Jetzt ansehen",
+    "viewChannel": "Kanal anzeigen",
+    "viewAll": "Alle Videos anzeigen",
+    "noVideos": "Keine Videos gefunden",
+    "refreshed": "Aktualisiert",
+    "error": {
+      "noApiKey": "YouTube-API-Schlüssel nicht konfiguriert",
+      "noChannel": "YouTube-Kanal nicht angegeben",
+      "connection": "Verbindung zur YouTube-API nicht möglich"
+    },
+    "widget": {
+      "description": "Vollständigen Kanal auf YouTube anzeigen",
+      "view": "YouTube-Kanal öffnen"
+    }
+  }
+}

package/locales/es-419.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Videos más recientes",
+    "channel": "Canal",
+    "live": "En vivo ahora",
+    "upcoming": "Próximamente",
+    "offline": "Desconectado",
+    "subscribers": "suscriptores",
+    "views": "vistas",
+    "watchNow": "Ver ahora",
+    "viewChannel": "Ver canal",
+    "viewAll": "Ver todos los videos",
+    "noVideos": "No se encontraron videos",
+    "refreshed": "Actualizado",
+    "error": {
+      "noApiKey": "Clave API de YouTube no configurada",
+      "noChannel": "Canal de YouTube no especificado",
+      "connection": "No se pudo conectar con la API de YouTube"
+    },
+    "widget": {
+      "description": "Ver el canal completo en YouTube",
+      "view": "Abrir canal de YouTube"
+    }
+  }
+}

package/locales/es.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Últimos vídeos",
+    "channel": "Canal",
+    "live": "En directo",
+    "upcoming": "Próximamente",
+    "offline": "Desconectado",
+    "subscribers": "suscriptores",
+    "views": "visualizaciones",
+    "watchNow": "Ver ahora",
+    "viewChannel": "Ver canal",
+    "viewAll": "Ver todos los vídeos",
+    "noVideos": "No se encontraron vídeos",
+    "refreshed": "Actualizado",
+    "error": {
+      "noApiKey": "Clave API de YouTube no configurada",
+      "noChannel": "Canal de YouTube no especificado",
+      "connection": "No se pudo conectar con la API de YouTube"
+    },
+    "widget": {
+      "description": "Ver el canal completo en YouTube",
+      "view": "Abrir canal de YouTube"
+    }
+  }
+}

package/locales/fr.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Dernières vidéos",
+    "channel": "Chaîne",
+    "live": "En direct",
+    "upcoming": "À venir",
+    "offline": "Hors ligne",
+    "subscribers": "abonnés",
+    "views": "vues",
+    "watchNow": "Regarder maintenant",
+    "viewChannel": "Voir la chaîne",
+    "viewAll": "Voir toutes les vidéos",
+    "noVideos": "Aucune vidéo trouvée",
+    "refreshed": "Actualisé",
+    "error": {
+      "noApiKey": "Clé API YouTube non configurée",
+      "noChannel": "Chaîne YouTube non spécifiée",
+      "connection": "Impossible de se connecter à l'API YouTube"
+    },
+    "widget": {
+      "description": "Voir la chaîne complète sur YouTube",
+      "view": "Ouvrir la chaîne YouTube"
+    }
+  }
+}

package/locales/hi.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "नवीनतम वीडियो",
+    "channel": "चैनल",
+    "live": "अभी लाइव",
+    "upcoming": "आने वाला",
+    "offline": "ऑफ़लाइन",
+    "subscribers": "सब्सक्राइबर",
+    "views": "दृश्य",
+    "watchNow": "अभी देखें",
+    "viewChannel": "चैनल देखें",
+    "viewAll": "सभी वीडियो देखें",
+    "noVideos": "कोई वीडियो नहीं मिला",
+    "refreshed": "ताज़ा किया गया",
+    "error": {
+      "noApiKey": "YouTube API कुंजी कॉन्फ़िगर नहीं है",
+      "noChannel": "YouTube चैनल निर्दिष्ट नहीं है",
+      "connection": "YouTube API से कनेक्ट नहीं हो सका"
+    },
+    "widget": {
+      "description": "YouTube पर पूरा चैनल देखें",
+      "view": "YouTube चैनल खोलें"
+    }
+  }
+}

package/locales/id.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Video Terbaru",
+    "channel": "Saluran",
+    "live": "Live Sekarang",
+    "upcoming": "Akan Datang",
+    "offline": "Offline",
+    "subscribers": "pelanggan",
+    "views": "tayangan",
+    "watchNow": "Tonton Sekarang",
+    "viewChannel": "Lihat Saluran",
+    "viewAll": "Lihat Semua Video",
+    "noVideos": "Tidak ada video ditemukan",
+    "refreshed": "Diperbarui",
+    "error": {
+      "noApiKey": "Kunci API YouTube tidak dikonfigurasi",
+      "noChannel": "Saluran YouTube tidak ditentukan",
+      "connection": "Tidak dapat terhubung ke YouTube API"
+    },
+    "widget": {
+      "description": "Lihat saluran lengkap di YouTube",
+      "view": "Buka Saluran YouTube"
+    }
+  }
+}

package/locales/it.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Video recenti",
+    "channel": "Canale",
+    "live": "In diretta ora",
+    "upcoming": "In arrivo",
+    "offline": "Offline",
+    "subscribers": "iscritti",
+    "views": "visualizzazioni",
+    "watchNow": "Guarda ora",
+    "viewChannel": "Visualizza canale",
+    "viewAll": "Visualizza tutti i video",
+    "noVideos": "Nessun video trovato",
+    "refreshed": "Aggiornato",
+    "error": {
+      "noApiKey": "Chiave API YouTube non configurata",
+      "noChannel": "Canale YouTube non specificato",
+      "connection": "Impossibile connettersi all'API di YouTube"
+    },
+    "widget": {
+      "description": "Visualizza il canale completo su YouTube",
+      "view": "Apri canale YouTube"
+    }
+  }
+}

package/locales/nl.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Nieuwste video's",
+    "channel": "Kanaal",
+    "live": "Nu live",
+    "upcoming": "Binnenkort",
+    "offline": "Offline",
+    "subscribers": "abonnees",
+    "views": "weergaven",
+    "watchNow": "Nu kijken",
+    "viewChannel": "Kanaal bekijken",
+    "viewAll": "Alle video's bekijken",
+    "noVideos": "Geen video's gevonden",
+    "refreshed": "Vernieuwd",
+    "error": {
+      "noApiKey": "YouTube API-sleutel niet geconfigureerd",
+      "noChannel": "YouTube-kanaal niet opgegeven",
+      "connection": "Kon geen verbinding maken met YouTube API"
+    },
+    "widget": {
+      "description": "Volledig kanaal op YouTube bekijken",
+      "view": "YouTube-kanaal openen"
+    }
+  }
+}

package/locales/pl.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Najnowsze filmy",
+    "channel": "Kanał",
+    "live": "Teraz na żywo",
+    "upcoming": "Nadchodzące",
+    "offline": "Offline",
+    "subscribers": "subskrybentów",
+    "views": "wyświetleń",
+    "watchNow": "Obejrzyj teraz",
+    "viewChannel": "Wyświetl kanał",
+    "viewAll": "Wyświetl wszystkie filmy",
+    "noVideos": "Nie znaleziono filmów",
+    "refreshed": "Odświeżono",
+    "error": {
+      "noApiKey": "Klucz API YouTube nie jest skonfigurowany",
+      "noChannel": "Kanał YouTube nie został określony",
+      "connection": "Nie można połączyć się z API YouTube"
+    },
+    "widget": {
+      "description": "Zobacz pełny kanał na YouTube",
+      "view": "Otwórz kanał YouTube"
+    }
+  }
+}

package/locales/pt-BR.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Vídeos mais recentes",
+    "channel": "Canal",
+    "live": "Ao vivo agora",
+    "upcoming": "Em breve",
+    "offline": "Offline",
+    "subscribers": "inscritos",
+    "views": "visualizações",
+    "watchNow": "Assistir agora",
+    "viewChannel": "Ver canal",
+    "viewAll": "Ver todos os vídeos",
+    "noVideos": "Nenhum vídeo encontrado",
+    "refreshed": "Atualizado",
+    "error": {
+      "noApiKey": "Chave API do YouTube não configurada",
+      "noChannel": "Canal do YouTube não especificado",
+      "connection": "Não foi possível conectar à API do YouTube"
+    },
+    "widget": {
+      "description": "Ver o canal completo no YouTube",
+      "view": "Abrir canal do YouTube"
+    }
+  }
+}

package/locales/pt.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Vídeos mais recentes",
+    "channel": "Canal",
+    "live": "Ao vivo agora",
+    "upcoming": "Em breve",
+    "offline": "Offline",
+    "subscribers": "subscritores",
+    "views": "visualizações",
+    "watchNow": "Ver agora",
+    "viewChannel": "Ver canal",
+    "viewAll": "Ver todos os vídeos",
+    "noVideos": "Nenhum vídeo encontrado",
+    "refreshed": "Atualizado",
+    "error": {
+      "noApiKey": "Chave API do YouTube não configurada",
+      "noChannel": "Canal do YouTube não especificado",
+      "connection": "Não foi possível ligar à API do YouTube"
+    },
+    "widget": {
+      "description": "Ver o canal completo no YouTube",
+      "view": "Abrir canal do YouTube"
+    }
+  }
+}

package/locales/sr.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Најновији видео снимци",
+    "channel": "Канал",
+    "live": "Уживо сада",
+    "upcoming": "Ускоро",
+    "offline": "Офлајн",
+    "subscribers": "претплатника",
+    "views": "прегледа",
+    "watchNow": "Гледај сада",
+    "viewChannel": "Погледај канал",
+    "viewAll": "Погледај све видео снимке",
+    "noVideos": "Нису пронађени видео снимци",
+    "refreshed": "Освежено",
+    "error": {
+      "noApiKey": "YouTube API кључ није конфигурисан",
+      "noChannel": "YouTube канал није наведен",
+      "connection": "Није могуће повезати се са YouTube API"
+    },
+    "widget": {
+      "description": "Погледајте комплетан канал на YouTube",
+      "view": "Отвори YouTube канал"
+    }
+  }
+}

package/locales/sv.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "Senaste videor",
+    "channel": "Kanal",
+    "live": "Live nu",
+    "upcoming": "Kommande",
+    "offline": "Offline",
+    "subscribers": "prenumeranter",
+    "views": "visningar",
+    "watchNow": "Titta nu",
+    "viewChannel": "Visa kanal",
+    "viewAll": "Visa alla videor",
+    "noVideos": "Inga videor hittades",
+    "refreshed": "Uppdaterad",
+    "error": {
+      "noApiKey": "YouTube API-nyckel inte konfigurerad",
+      "noChannel": "YouTube-kanal inte angiven",
+      "connection": "Kunde inte ansluta till YouTube API"
+    },
+    "widget": {
+      "description": "Visa fullständig kanal på YouTube",
+      "view": "Öppna YouTube-kanal"
+    }
+  }
+}

package/locales/zh-Hans-CN.json

@@ -0,0 +1,26 @@
+{
+  "youtube": {
+    "title": "YouTube",
+    "videos": "最新视频",
+    "channel": "频道",
+    "live": "正在直播",
+    "upcoming": "即将开始",
+    "offline": "离线",
+    "subscribers": "订阅者",
+    "views": "次观看",
+    "watchNow": "立即观看",
+    "viewChannel": "查看频道",
+    "viewAll": "查看所有视频",
+    "noVideos": "未找到视频",
+    "refreshed": "已刷新",
+    "error": {
+      "noApiKey": "未配置 YouTube API 密钥",
+      "noChannel": "未指定 YouTube 频道",
+      "connection": "无法连接到 YouTube API"
+    },
+    "widget": {
+      "description": "在 YouTube 上查看完整频道",
+      "view": "打开 YouTube 频道"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-youtube",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "YouTube channel endpoint for Indiekit. Display latest videos and live status from any YouTube channel.",
   "keywords": [
     "indiekit",