@sriinnu/harmon-youtube 0.1.0

package/dist/index.js

@@ -0,0 +1,347 @@
+/**
+ * Harmon YouTube - YouTube Music integration
+ *
+ * I keep this adapter on the official YouTube Data API.
+ * That means I can support search, owned playlists, liked-library tracks,
+ * playlist tracks, and related-track recommendations without pulling in
+ * private YouTube Music endpoints that would make the runtime brittle.
+ */
+const YT_DATA_API_BASE = 'https://www.googleapis.com/youtube/v3';
+// ============================================================================
+// Implementation
+// ============================================================================
+class YouTubeMusicClientImpl {
+    config;
+    constructor(config) {
+        if (!config.accessToken && !config.apiKey) {
+            throw new Error('YouTube Music requires an access token or API key. Cookies-only mode is not implemented in this build.');
+        }
+        this.config = config;
+    }
+    isConnected() {
+        return !!(this.config.accessToken || this.config.apiKey);
+    }
+    async search(query, types = ['songs'], options = {}) {
+        const result = {
+            songs: [], albums: [], artists: [], playlists: [],
+        };
+        if (types.includes('songs')) {
+            const data = await this.ytDataRequest('/search', {
+                q: query,
+                type: 'video',
+                videoCategoryId: '10',
+                maxResults: (options.limit || 20).toString(),
+                part: 'snippet',
+            });
+            result.songs = (data.items || [])
+                .map(mapYtSearchToSong)
+                .filter((song) => song !== null);
+        }
+        if (types.includes('artists')) {
+            const data = await this.ytDataRequest('/search', {
+                q: query,
+                type: 'channel',
+                maxResults: (options.limit || 20).toString(),
+                part: 'snippet',
+            });
+            result.artists = (data.items || [])
+                .map(mapYtSearchToArtist)
+                .filter((artist) => artist !== null);
+        }
+        if (types.includes('playlists')) {
+            const data = await this.ytDataRequest('/search', {
+                q: query,
+                type: 'playlist',
+                maxResults: (options.limit || 20).toString(),
+                part: 'snippet',
+            });
+            result.playlists = (data.items || [])
+                .map(mapYtSearchToPlaylist)
+                .filter((playlist) => playlist !== null);
+        }
+        if (types.includes('albums')) {
+            const data = await this.ytDataRequest('/search', {
+                q: `${query} album`,
+                type: 'playlist',
+                maxResults: (options.limit || 20).toString(),
+                part: 'snippet',
+            });
+            result.albums = (data.items || [])
+                .map(mapYtSearchToAlbum)
+                .filter((album) => album !== null);
+        }
+        return result;
+    }
+    async getSong(videoId) {
+        const data = await this.ytDataRequest('/videos', {
+            id: videoId,
+            part: 'snippet,contentDetails',
+        });
+        const item = data.items?.[0];
+        if (!item)
+            return null;
+        return {
+            id: item.id,
+            name: item.snippet.title,
+            artistName: item.snippet.channelTitle.replace(/ - Topic$/, ''),
+            durationMs: parseDuration(item.contentDetails?.duration),
+            thumbnailUrl: item.snippet.thumbnails?.medium?.url,
+        };
+    }
+    async getLibrarySongs(_options = {}) {
+        const likesPlaylistId = await this.getLikesPlaylistId();
+        return this.getPlaylistTracks(likesPlaylistId, _options);
+    }
+    async getPlaylists(options = {}) {
+        this.requireAuthorizedUserSurface('YouTube Music playlist listing');
+        const data = await this.ytDataRequest('/playlists', {
+            mine: 'true',
+            maxResults: Math.min(options.limit || 20, 50).toString(),
+            part: 'snippet,contentDetails',
+        });
+        return (data.items || [])
+            .map(mapPlaylistListItem)
+            .filter((playlist) => playlist !== null);
+    }
+    async getPlaylistTracks(playlistId, options = {}) {
+        const data = await this.ytDataRequest('/playlistItems', {
+            playlistId,
+            maxResults: Math.min(options.limit || 20, 50).toString(),
+            part: 'snippet,contentDetails',
+        });
+        return (data.items || [])
+            .map(mapPlaylistItemToSong)
+            .filter((song) => song !== null);
+    }
+    async getRecommendations(options = {}) {
+        const seedSong = (await this.getLibrarySongs({ limit: 1 }))[0];
+        if (!seedSong) {
+            return [];
+        }
+        return this.getWatchPlaylist(seedSong.id, options);
+    }
+    async getWatchPlaylist(videoId, options = {}) {
+        const data = await this.ytDataRequest('/search', {
+            relatedToVideoId: videoId,
+            type: 'video',
+            videoCategoryId: '10',
+            maxResults: Math.min(options.limit || 20, 50).toString(),
+            part: 'snippet',
+        });
+        return (data.items || [])
+            .map(mapYtSearchToSong)
+            .filter((song) => song !== null && song.id !== videoId);
+    }
+    /**
+     * I keep user-library surfaces behind OAuth because API-key access cannot
+     * read a signed-in user's playlists or likes.
+     */
+    requireAuthorizedUserSurface(surface) {
+        if (!this.config.accessToken) {
+            throw new Error(`${surface} requires YOUTUBE_MUSIC_ACCESS_TOKEN or GOOGLE_ACCESS_TOKEN.`);
+        }
+    }
+    async getLikesPlaylistId() {
+        this.requireAuthorizedUserSurface('YouTube Music library access');
+        const data = await this.ytDataRequest('/channels', {
+            mine: 'true',
+            part: 'contentDetails',
+            maxResults: '1',
+        });
+        const likesPlaylistId = data.items?.[0]?.contentDetails?.relatedPlaylists?.likes;
+        if (!likesPlaylistId) {
+            throw new Error('YouTube Music liked tracks playlist was not available for the authenticated user.');
+        }
+        return likesPlaylistId;
+    }
+    async ytDataRequest(path, query) {
+        const url = new URL(`${YT_DATA_API_BASE}${path}`);
+        for (const [key, value] of Object.entries(query)) {
+            url.searchParams.set(key, value);
+        }
+        const headers = {};
+        if (this.config.accessToken) {
+            headers.Authorization = `Bearer ${this.config.accessToken}`;
+        }
+        else if (this.config.apiKey) {
+            url.searchParams.set('key', this.config.apiKey);
+        }
+        const response = await fetch(url, { headers });
+        if (response.status === 429) {
+            const retryAfter = parseInt(response.headers.get('Retry-After') || '5', 10);
+            await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
+            const retry = await fetch(url, { headers });
+            if (!retry.ok) {
+                throw new Error(`YouTube API error: ${retry.status} ${await retry.text()}`);
+            }
+            return (await retry.json());
+        }
+        if (!response.ok) {
+            throw new Error(`YouTube API error: ${response.status} ${await response.text()}`);
+        }
+        return (await response.json());
+    }
+}
+// ============================================================================
+// Mappers
+// ============================================================================
+function mapYtSearchToSong(item) {
+    const videoId = item.id.videoId;
+    if (!videoId || !item.snippet.title || !item.snippet.channelTitle) {
+        return null;
+    }
+    return {
+        id: videoId,
+        name: item.snippet.title,
+        artistName: item.snippet.channelTitle.replace(/ - Topic$/, ''),
+        thumbnailUrl: item.snippet.thumbnails?.medium?.url,
+    };
+}
+function mapYtSearchToArtist(item) {
+    const artistId = item.id.channelId;
+    if (!artistId || !item.snippet.title) {
+        return null;
+    }
+    return {
+        id: artistId,
+        name: item.snippet.title,
+        thumbnailUrl: item.snippet.thumbnails?.medium?.url,
+    };
+}
+function mapYtSearchToPlaylist(item) {
+    const playlistId = item.id.playlistId;
+    if (!playlistId || !item.snippet.title) {
+        return null;
+    }
+    return {
+        id: playlistId,
+        name: item.snippet.title,
+        author: item.snippet.channelTitle,
+        thumbnailUrl: item.snippet.thumbnails?.medium?.url,
+    };
+}
+function mapYtSearchToAlbum(item) {
+    const playlist = mapYtSearchToPlaylist(item);
+    if (!playlist) {
+        return null;
+    }
+    return {
+        id: playlist.id,
+        name: playlist.name,
+        artistName: playlist.author || 'YouTube Music',
+        thumbnailUrl: playlist.thumbnailUrl,
+    };
+}
+function mapPlaylistListItem(item) {
+    if (!item.id || !item.snippet?.title) {
+        return null;
+    }
+    return {
+        id: item.id,
+        name: item.snippet.title,
+        author: item.snippet.channelTitle,
+        trackCount: item.contentDetails?.itemCount,
+        thumbnailUrl: item.snippet.thumbnails?.medium?.url,
+    };
+}
+function mapPlaylistItemToSong(item) {
+    const videoId = item.contentDetails?.videoId || item.snippet?.resourceId?.videoId;
+    const title = item.snippet?.title;
+    const channelTitle = item.snippet?.channelTitle;
+    if (!videoId || !title || !channelTitle || title === 'Deleted video' || title === 'Private video') {
+        return null;
+    }
+    return {
+        id: videoId,
+        name: title,
+        artistName: channelTitle.replace(/ - Topic$/, ''),
+        thumbnailUrl: item.snippet?.thumbnails?.medium?.url,
+    };
+}
+/** Convert YouTube Music song to provider-agnostic TrackInfo */
+export function mapSongToTrackInfo(song) {
+    return {
+        id: song.id,
+        name: song.name,
+        artist: song.artistName,
+        artistIds: song.artistId ? [song.artistId] : undefined,
+        album: song.albumName || '',
+        durationMs: song.durationMs || 0,
+        uri: `youtube:video:${song.id}`,
+        provider: 'youtube',
+        imageUrl: song.thumbnailUrl,
+    };
+}
+/** Parse ISO 8601 duration (PT3M45S) to milliseconds */
+function parseDuration(iso) {
+    if (!iso)
+        return undefined;
+    const m = iso.match(/PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?/);
+    if (!m)
+        return undefined;
+    return ((parseInt(m[1] || '0') * 3600) + (parseInt(m[2] || '0') * 60) + parseInt(m[3] || '0')) * 1000;
+}
+// ============================================================================
+// Provider Adapter
+// ============================================================================
+/**
+ * Adapts YouTubeMusicClient to the MusicProvider interface.
+ */
+export class YouTubeMusicProvider {
+    name = 'youtube';
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    isConnected() {
+        return this.client.isConnected();
+    }
+    async search(query, limit) {
+        const result = await this.client.search(query, ['songs'], { limit });
+        return result.songs.map(mapSongToTrackInfo);
+    }
+    async getLibraryTracks(options) {
+        const songs = await this.client.getLibrarySongs(options);
+        return songs.map(mapSongToTrackInfo);
+    }
+    /**
+     * I reject synthetic top-track semantics so the YouTube provider stays
+     * aligned with what the official API actually exposes.
+     */
+    async getTopTracks(options) {
+        void options;
+        throw new Error('YouTube Music top tracks are not available from the official provider contract. Use recently played or library tracks instead.');
+    }
+    async getRecentlyPlayed(options) {
+        return this.getLibraryTracks(options);
+    }
+    async getPlaylistTracks(playlistId, options) {
+        const songs = await this.client.getPlaylistTracks(playlistId, options);
+        return songs.map(mapSongToTrackInfo);
+    }
+    async getRecommendations(options) {
+        if (options.seedTrackIds && options.seedTrackIds.length > 0) {
+            const songs = await this.client.getWatchPlaylist(options.seedTrackIds[0], { limit: options.limit });
+            return songs.map(mapSongToTrackInfo);
+        }
+        const songs = await this.client.getRecommendations({ limit: options.limit });
+        return songs.map(mapSongToTrackInfo);
+    }
+    async getTrackFeatures(trackIds) {
+        return trackIds.map(() => null); // YouTube has no audio features
+    }
+}
+export function createYouTubeMusicProvider(client) {
+    return new YouTubeMusicProvider(client);
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * I create a YouTube Music client for the currently supported Data API
+ * surface: song search and individual song lookup.
+ */
+export function createYouTubeMusicClient(config) {
+    return new YouTubeMusicClientImpl(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/logo.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" fill="none">
+  <!-- I am the YouTube mark: a browser frame, a play symbol, and handoff motion. -->
+  <rect width="64" height="64" rx="16" fill="#F3E7D4"/>
+  <g stroke="#171513" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
+    <rect x="16" y="18" width="32" height="20" rx="8"/>
+    <path d="M29 24L38 28L29 32V24Z"/>
+    <path d="M43 14L49 18"/>
+    <path d="M18 49L20 38"/>
+    <path d="M29 46C35 43 42 43 48 47"/>
+  </g>
+  <g fill="#171513">
+    <circle cx="18" cy="34" r="5"/>
+    <path d="M13 46C15 41 22 41 24 46V51H13V46Z"/>
+  </g>
+</svg>

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@sriinnu/harmon-youtube",
+  "version": "0.1.0",
+  "description": "YouTube Music integration for Harmon",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sriinnu/harmon.git",
+    "directory": "packages/harmon-youtube"
+  },
+  "homepage": "https://github.com/sriinnu/harmon/tree/main/packages/harmon-youtube#readme",
+  "bugs": {
+    "url": "https://github.com/sriinnu/harmon/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    ".chitragupta-ecosystem/",
+    "README.md",
+    "SKILL.md",
+    "logo.svg"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@sriinnu/harmon-protocol": "0.1.0",
+    "@sriinnu/harmon-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.8",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "auth": "node ./dist/auth-cli.js bootstrap",
+    "auth:refresh": "node ./dist/auth-cli.js refresh",
+    "auth:status": "node ./dist/auth-cli.js status",
+    "build": "node --experimental-strip-types ../../scripts/clean-build.ts ./dist ./tsconfig.tsbuildinfo && tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest --root ../.. packages/harmon-youtube/src/index.test.ts",
+    "test:run": "vitest --root ../.. run packages/harmon-youtube/src/index.test.ts"
+  }
+}