@sriinnu/harmon-apple 0.1.0

package/dist/index.js

@@ -0,0 +1,298 @@
+/**
+ * Harmon Apple - Apple Music API client
+ */
+const APPLE_MUSIC_API_BASE = 'https://api.music.apple.com/v1';
+class AppleMusicClientImpl {
+    developerToken;
+    userToken;
+    storefront;
+    constructor(config) {
+        if (!config.developerToken) {
+            throw new Error('Missing Apple Music developer token');
+        }
+        this.developerToken = config.developerToken;
+        this.userToken = config.userToken;
+        this.storefront = config.storefront || 'us';
+    }
+    async search(term, types, options = {}) {
+        const data = await this.request(`/catalog/${this.storefront}/search`, {
+            term,
+            types: types.join(','),
+            ...listQuery(options),
+        });
+        return {
+            songs: (data.results?.songs?.data || []).map(mapSong),
+            albums: (data.results?.albums?.data || []).map(mapAlbum),
+            artists: (data.results?.artists?.data || []).map(mapArtist),
+            playlists: (data.results?.playlists?.data || []).map(mapPlaylist),
+        };
+    }
+    async getSong(id) {
+        const data = await this.request(`/catalog/${this.storefront}/songs/${id}`);
+        return data.data?.[0] ? mapSong(data.data[0]) : null;
+    }
+    async getAlbum(id) {
+        const data = await this.request(`/catalog/${this.storefront}/albums/${id}`);
+        return data.data?.[0] ? mapAlbum(data.data[0]) : null;
+    }
+    async getArtist(id) {
+        const data = await this.request(`/catalog/${this.storefront}/artists/${id}`);
+        return data.data?.[0] ? mapArtist(data.data[0]) : null;
+    }
+    async getPlaylist(id) {
+        const data = await this.request(`/catalog/${this.storefront}/playlists/${id}`);
+        return data.data?.[0] ? mapPlaylist(data.data[0]) : null;
+    }
+    async getPlaylistTracks(id, options = {}) {
+        if (this.userToken) {
+            try {
+                const libraryTracks = await this.request(`/me/library/playlists/${id}/tracks`, listQuery(options), true);
+                return (libraryTracks.data || []).map(mapLibrarySongToAppleMusicSong);
+            }
+            catch (error) {
+                if (!isAppleNotFoundError(error)) {
+                    throw error;
+                }
+            }
+        }
+        const data = await this.request(`/catalog/${this.storefront}/playlists/${id}/tracks`, listQuery(options));
+        return (data.data || []).map(mapSong);
+    }
+    async getRecentlyPlayedTracks(options = {}) {
+        const data = await this.request('/me/recent/played/tracks', listQuery(options), true);
+        return (data.data || []).map(mapSong);
+    }
+    async getLibrarySongs(options = {}) {
+        const data = await this.request('/me/library/songs', listQuery(options), true);
+        return (data.data || []).map(mapLibrarySong);
+    }
+    async getLibraryAlbums(options = {}) {
+        const data = await this.request('/me/library/albums', listQuery(options), true);
+        return (data.data || []).map(mapLibraryAlbum);
+    }
+    async getLibraryPlaylists(options = {}) {
+        const data = await this.request('/me/library/playlists', listQuery(options), true);
+        return (data.data || []).map(mapLibraryPlaylist);
+    }
+    async request(path, query, requireUserToken = false) {
+        const url = new URL(`${APPLE_MUSIC_API_BASE}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.developerToken}`,
+        };
+        if (requireUserToken) {
+            if (!this.userToken) {
+                throw new Error('Apple Music user token required for library endpoints');
+            }
+            headers['Music-User-Token'] = this.userToken;
+        }
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            const detail = await response.text();
+            throw new Error(`Apple Music API error: ${response.status} ${detail}`);
+        }
+        return (await response.json());
+    }
+}
+function listQuery(options) {
+    const query = {};
+    if (typeof options.limit === 'number') {
+        query.limit = options.limit.toString();
+    }
+    if (typeof options.offset === 'number') {
+        query.offset = options.offset.toString();
+    }
+    return query;
+}
+function mapSong(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        artistName: resource.attributes.artistName,
+        albumName: resource.attributes.albumName,
+        durationMs: resource.attributes.durationInMillis,
+        url: resource.attributes.url,
+    };
+}
+function mapAlbum(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        artistName: resource.attributes.artistName,
+        releaseDate: resource.attributes.releaseDate,
+        trackCount: resource.attributes.trackCount,
+        url: resource.attributes.url,
+    };
+}
+function mapArtist(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        url: resource.attributes.url,
+    };
+}
+function mapPlaylist(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        curatorName: resource.attributes.curatorName,
+        trackCount: resource.attributes.trackCount,
+        url: resource.attributes.url,
+    };
+}
+function mapLibrarySong(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        artistName: resource.attributes.artistName,
+        albumName: resource.attributes.albumName,
+    };
+}
+function mapLibrarySongToAppleMusicSong(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        artistName: resource.attributes.artistName,
+        albumName: resource.attributes.albumName,
+    };
+}
+function mapLibraryAlbum(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        artistName: resource.attributes.artistName,
+        trackCount: resource.attributes.trackCount,
+    };
+}
+function mapLibraryPlaylist(resource) {
+    return {
+        id: resource.id,
+        name: resource.attributes.name,
+        trackCount: resource.attributes.trackCount,
+    };
+}
+/** Map Apple Music song to provider-agnostic TrackInfo */
+function mapSongToTrackInfo(song) {
+    return {
+        id: song.id,
+        name: song.name,
+        artist: song.artistName,
+        album: song.albumName || '',
+        durationMs: song.durationMs || 0,
+        uri: song.url || `apple:song:${song.id}`,
+        provider: 'apple',
+    };
+}
+function mapLibrarySongToTrackInfo(song) {
+    return {
+        id: song.id,
+        name: song.name,
+        artist: song.artistName,
+        album: song.albumName || '',
+        durationMs: 0,
+        uri: `apple:song:${song.id}`,
+        provider: 'apple',
+    };
+}
+/**
+ * Adapts AppleMusicClient to the MusicProvider interface.
+ */
+export class AppleMusicProvider {
+    name = 'apple';
+    client;
+    connected;
+    constructor(client, connected = true) {
+        this.client = client;
+        this.connected = connected;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    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(mapLibrarySongToTrackInfo);
+    }
+    /**
+     * I reject synthetic top-track semantics so the Apple provider stays honest
+     * about the personal-history surface it actually implements.
+     */
+    async getTopTracks(options) {
+        void options;
+        throw new Error('Apple Music top tracks are not available from the current provider contract. Use recently played tracks instead.');
+    }
+    async getRecentlyPlayed(options) {
+        const songs = await this.client.getRecentlyPlayedTracks(options);
+        return songs.map(mapSongToTrackInfo);
+    }
+    async getPlaylistTracks(playlistId, options) {
+        const songs = await this.client.getPlaylistTracks(playlistId, options);
+        return songs.map(mapSongToTrackInfo);
+    }
+    /**
+     * I build Apple recommendations from the user's recent plays plus catalog
+     * artist searches because Apple does not expose a simple seed-track
+     * recommendations endpoint that matches the shared provider contract.
+     */
+    async getRecommendations(options) {
+        const limit = Math.max(1, Math.min(options.limit ?? 20, 50));
+        const seeds = await this.resolveRecommendationSeeds(options.seedTrackIds);
+        if (seeds.length === 0) {
+            return [];
+        }
+        const perSeed = Math.max(2, Math.ceil(limit / seeds.length));
+        const excludedIds = new Set(seeds.map((seed) => seed.id));
+        const recommendations = [];
+        const seen = new Set();
+        for (const seed of seeds) {
+            const searchTerm = [seed.artistName, seed.albumName].filter(Boolean).join(' ').trim() || seed.name;
+            const result = await this.client.search(searchTerm, ['songs'], { limit: perSeed + 4 });
+            for (const song of result.songs) {
+                if (excludedIds.has(song.id) || seen.has(song.id)) {
+                    continue;
+                }
+                seen.add(song.id);
+                recommendations.push(mapSongToTrackInfo(song));
+                if (recommendations.length >= limit) {
+                    return recommendations;
+                }
+            }
+        }
+        return recommendations;
+    }
+    async getTrackFeatures(trackIds) {
+        // Apple Music has no audio features API — return nulls
+        return trackIds.map(() => null);
+    }
+    /**
+     * I prefer explicit seed tracks and fall back to recent listening history so
+     * recommendation discovery remains provider-aware for Apple sessions.
+     */
+    async resolveRecommendationSeeds(seedTrackIds) {
+        const explicitSeeds = await Promise.all((seedTrackIds || [])
+            .slice(0, 3)
+            .map(async (trackId) => this.client.getSong(trackId)));
+        const resolvedSeeds = explicitSeeds.filter((song) => Boolean(song));
+        if (resolvedSeeds.length > 0) {
+            return resolvedSeeds;
+        }
+        return this.client.getRecentlyPlayedTracks({ limit: 3 });
+    }
+}
+export function createAppleMusicProvider(client) {
+    return new AppleMusicProvider(client);
+}
+export function createAppleMusicClient(config) {
+    return new AppleMusicClientImpl(config);
+}
+function isAppleNotFoundError(error) {
+    return error instanceof Error && error.message.startsWith('Apple Music API error: 404');
+}
+//# 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,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" fill="none">
+  <!-- I am the Apple mark: a person reaching toward a playback phone. -->
+  <rect width="64" height="64" rx="16" fill="#F3E7D4"/>
+  <g stroke="#171513" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
+    <rect x="34" y="14" width="14" height="30" rx="4.5"/>
+    <path d="M39.5 20V30"/>
+    <path d="M39.5 21L45 19V27"/>
+    <circle cx="37.5" cy="32" r="3.5"/>
+    <circle cx="45" cy="28" r="3.5"/>
+    <path d="M17 49L19 37"/>
+    <path d="M18 31L28 26"/>
+  </g>
+  <g fill="#171513">
+    <circle cx="18" cy="23" r="5"/>
+    <path d="M12 36C14 31 22 31 24 36V42H12V36Z"/>
+  </g>
+</svg>

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@sriinnu/harmon-apple",
+  "version": "0.1.0",
+  "description": "Apple Music API client",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sriinnu/harmon.git",
+    "directory": "packages/harmon-apple"
+  },
+  "homepage": "https://github.com/sriinnu/harmon/tree/main/packages/harmon-apple#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-apple/src/index.test.ts",
+    "test:run": "vitest --root ../.. run packages/harmon-apple/src/index.test.ts"
+  }
+}