@sriinnu/harmon-apple 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# @sriinnu/harmon-apple
+
+![logo](./logo.svg)
+
+> Apple Music API client and provider adapter for catalog search, playlist tracks, library access, recent-play signals, and Apple-backed session discovery.
+
+## Install
+
+```bash
+pnpm add @sriinnu/harmon-apple
+```
+
+## Pack Auth
+
+These commands are for the provider pack checkout or a profile-aware loader that executes inside the pack root. They are not exposed as a global installed binary. From a fresh repo checkout, run `pnpm build` once before you use them.
+
+```bash
+npm run auth
+npm run auth:status
+npm run auth:refresh
+```
+
+I keep local Apple Music auth state in `~/.chitragupta/harmon/provider-packs/harmon-apple/apple-music.json` by default. Set `HARMON_PACK_STATE_DIR` if you need a different local root. I also ship `.chitragupta-ecosystem/.profile.json` so Chitragupta-style loaders can discover the pack entrypoints and env contract directly.
+
+I keep the auth flow honest:
+
+- `npm run auth` uses `APPLE_MUSIC_DEVELOPER_TOKEN` directly, or generates one from `APPLE_MUSIC_TEAM_ID`, `APPLE_MUSIC_KEY_ID`, and `APPLE_MUSIC_PRIVATE_KEY_PATH`
+- I then open a local MusicKit page to mint and save the Apple `Music-User-Token`
+- `npm run auth:refresh` refreshes the developer-token side only; if the user token expires, rerun `npm run auth`
+
+## Quick Start
+
+```typescript
+import { createAppleMusicClient } from '@sriinnu/harmon-apple';
+
+const client = createAppleMusicClient({
+  developerToken: process.env.APPLE_MUSIC_DEVELOPER_TOKEN!,
+  userToken: process.env.APPLE_MUSIC_USER_TOKEN,
+});
+const results = await client.search('ambient study', ['songs']);
+console.log(results.songs[0].name);
+```
+
+## API
+
+| Export | Description |
+|---|---|
+| `createAppleMusicClient(config)` | Create authenticated API client |
+| `AppleMusicClient` | Interface: search, getSong, getAlbum, getArtist, getPlaylist, getPlaylistTracks |
+| `client.getLibrarySongs()` | Fetch user's library songs (requires user token) |
+| `client.getLibraryAlbums()` | Fetch user's library albums |
+| `client.getLibraryPlaylists()` | Fetch user's library playlists |
+| `client.getRecentlyPlayedTracks()` | Fetch the user's recent Apple Music tracks (requires user token) |
+| `client.getPlaylistTracks()` | Fetch playlist tracks from catalog playlists, or library playlists when a user token is available |
+| `AppleMusicConfig` | `{ developerToken, userToken?, storefront? }` |
+| `AppleMusicSong` | Song type with id, name, artistName, durationMs |
+| `AppleMusicSearchResult` | Grouped results: songs, albums, artists, playlists |
+
+## Architecture
+
+harmon-apple wraps the Apple Music REST API (`api.music.apple.com/v1`) and exposes a `MusicProvider` adapter for catalog search, library access, playlist browsing, recent-play signals, and recommendation seeding. The daemon pairs this package with either macOS AppleScript local playback or a daemon-side iOS remote companion contract, and it keeps local playback available on macOS even when remote companion auth is configured. Catalog endpoints use the developer token; personal library and recent-play endpoints additionally require a user Music-User-Token. I do not synthesize a separate Apple `topTracks` surface because the provider contract cannot distinguish that honestly from recent plays; harmond layers local playback history on top when that signal is needed for sessions.
+
+## License
+
+GNU Affero General Public License v3.0 only. See [LICENSE](../../LICENSE).

package/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: harmon-apple
+description: Apple Music API client with catalog search, library access, and MusicProvider adapter
+capabilities:
+  - Search the Apple Music catalog for songs, albums, artists, and playlists
+  - Access user library songs, albums, and playlists with Music-User-Token auth
+  - Adapt Apple Music API to the harmon-core MusicProvider interface
+tags:
+  - apple-music
+  - music
+  - api
+  - streaming
+provider: harmon
+version: 0.1.0
+---
+
+# Harmon Apple
+
+## What this does
+harmon-apple provides a typed client for the Apple Music API, covering both the public catalog (search, get song/album/artist/playlist) and the authenticated user library. It maps Apple Music song data to the provider-agnostic TrackInfo format and implements the MusicProvider interface so harmon-core can treat Apple Music as a first-class track source alongside Spotify and YouTube Music.
+
+## Pack auth
+- `npm run auth` resolves a developer token and opens a local MusicKit bootstrap page for the user token
+- `npm run auth:refresh` refreshes the developer-token side and validates any stored user token
+- `npm run auth:status` prints the current Apple Music auth posture and local auth file path
+- `.chitragupta-ecosystem/.profile.json` is the explicit loader contract for this pack
+
+## When to use
+- Searching the Apple Music catalog or reading a user's Apple Music library
+- Adding Apple Music as a track source in a harmon session
+- Converting Apple Music song metadata to the shared TrackInfo format
+
+## Key exports
+- `createAppleMusicClient` — factory that returns an AppleMusicClient for catalog and library calls
+- `createAppleMusicProvider` — MusicProvider adapter for harmon-core
+
+## Example
+```typescript
+import { createAppleMusicClient, createAppleMusicProvider } from '@sriinnu/harmon-apple';
+
+const client = createAppleMusicClient({ developerToken, userToken });
+const results = await client.search('Nils Frahm', ['songs'], { limit: 10 });
+const provider = createAppleMusicProvider(client);
+const tracks = await provider.search('Nils Frahm', 10);
+```

package/dist/auth-cli.d.ts

@@ -0,0 +1,5 @@
+/**
+ * I bootstrap and validate Apple Music auth for the standalone provider pack.
+ */
+export {};
+//# sourceMappingURL=auth-cli.d.ts.map

package/dist/auth-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-cli.d.ts","sourceRoot":"","sources":["../src/auth-cli.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/auth-cli.js

@@ -0,0 +1,328 @@
+/**
+ * I bootstrap and validate Apple Music auth for the standalone provider pack.
+ */
+import { spawn } from 'node:child_process';
+import { createPrivateKey, createSign, randomBytes } from 'node:crypto';
+import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import os from 'node:os';
+import path from 'node:path';
+import process from 'node:process';
+import { createAppleMusicClient } from './index.js';
+const authPath = resolveAuthPath('apple-music.json');
+/**
+ * I keep Apple Music auth state under user-local storage instead of the
+ * package tree so published packs never carry live tokens.
+ */
+function resolveAuthPath(fileName) {
+    const overrideRoot = process.env.HARMON_PACK_STATE_DIR?.trim();
+    const stateRoot = overrideRoot && overrideRoot.length > 0
+        ? overrideRoot
+        : path.join(os.homedir(), '.chitragupta', 'harmon', 'provider-packs');
+    return path.join(stateRoot, 'harmon-apple', fileName);
+}
+async function readJson(filePath) {
+    try {
+        return JSON.parse(await readFile(filePath, 'utf8'));
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+async function writeJson(filePath, value) {
+    await mkdir(path.dirname(filePath), { mode: 0o700, recursive: true });
+    if (value == null) {
+        await rm(filePath, { force: true });
+        return;
+    }
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+    await chmod(filePath, 0o600);
+}
+async function openUrl(url) {
+    if (process.env.HARMON_NO_BROWSER === '1') {
+        return;
+    }
+    const opener = process.platform === 'darwin'
+        ? ['open', [url]]
+        : process.platform === 'win32'
+            ? ['cmd', ['/c', 'start', '', url]]
+            : ['xdg-open', [url]];
+    await new Promise(resolve => {
+        const child = spawn(opener[0], opener[1], { stdio: 'ignore' });
+        child.on('error', () => resolve());
+        child.on('close', () => resolve());
+    });
+}
+function readConfig() {
+    const port = Number.parseInt(process.env.APPLE_MUSIC_BOOTSTRAP_PORT || '8788', 10);
+    return {
+        appName: process.env.APPLE_MUSIC_APP_NAME || 'Harmon',
+        appBuild: process.env.APPLE_MUSIC_APP_BUILD || '0.1.0',
+        bootstrapUrl: process.env.APPLE_MUSIC_BOOTSTRAP_URL || `http://127.0.0.1:${port}/`,
+        storefront: process.env.APPLE_MUSIC_STOREFRONT || 'us',
+        developerToken: process.env.APPLE_MUSIC_DEVELOPER_TOKEN,
+        userToken: process.env.APPLE_MUSIC_USER_TOKEN,
+        keyId: process.env.APPLE_MUSIC_KEY_ID,
+        teamId: process.env.APPLE_MUSIC_TEAM_ID,
+        privateKeyPath: process.env.APPLE_MUSIC_PRIVATE_KEY_PATH,
+        privateKey: process.env.APPLE_MUSIC_PRIVATE_KEY?.replace(/\\n/g, '\n'),
+        ttlSeconds: Math.min(Number.parseInt(process.env.APPLE_MUSIC_DEVELOPER_TOKEN_TTL_SECONDS || `${30 * 24 * 60 * 60}`, 10), 15_777_000),
+    };
+}
+function base64Url(value) {
+    return Buffer.from(value).toString('base64url');
+}
+/**
+ * I resolve the Apple developer token from direct env input, local key material, or stored state.
+ */
+async function resolveDeveloperToken(config, existingState) {
+    if (config.developerToken) {
+        return { token: config.developerToken, source: 'env', expiresAt: null };
+    }
+    if (config.keyId && config.teamId && (config.privateKey || config.privateKeyPath)) {
+        const privateKeyPath = config.privateKeyPath;
+        const privateKey = config.privateKey || (privateKeyPath ? await readFile(privateKeyPath, 'utf8') : null);
+        if (!privateKey) {
+            throw new Error('APPLE_MUSIC_PRIVATE_KEY_PATH must point to a valid private key file.');
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const payload = { iss: config.teamId, iat: now, exp: now + config.ttlSeconds };
+        const encoded = `${base64Url(JSON.stringify({ alg: 'ES256', kid: config.keyId, typ: 'JWT' }))}.${base64Url(JSON.stringify(payload))}`;
+        const signer = createSign('SHA256');
+        signer.update(encoded);
+        signer.end();
+        const signature = signer.sign({
+            key: createPrivateKey(privateKey),
+            dsaEncoding: 'ieee-p1363',
+        });
+        return {
+            token: `${encoded}.${signature.toString('base64url')}`,
+            source: 'generated',
+            expiresAt: new Date(payload.exp * 1000).toISOString(),
+        };
+    }
+    if (existingState?.developerToken) {
+        return {
+            token: existingState.developerToken,
+            source: existingState.developerTokenSource,
+            expiresAt: existingState.developerTokenExpiresAt,
+        };
+    }
+    return null;
+}
+/**
+ * I validate both the catalog token and the optional user token against the live Apple Music API.
+ */
+async function validateApple(state) {
+    const client = createAppleMusicClient({
+        developerToken: state.developerToken,
+        userToken: state.userToken || undefined,
+        storefront: state.storefront,
+    });
+    await client.search('ambient', ['songs'], { limit: 1 });
+    if (state.userToken) {
+        await client.getLibraryPlaylists({ limit: 1 });
+    }
+}
+function renderBootstrapPage(developerToken, appName, appBuild, tokenPath, state) {
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${appName} Apple Music Auth</title>
+    <script src="https://js-cdn.music.apple.com/musickit/v3/musickit.js"></script>
+  </head>
+  <body>
+    <main>
+      <h1>${appName} Apple Music Auth</h1>
+      <p>I use MusicKit JS to mint a user token for the local provider pack.</p>
+      <button id="authorize">Authorize Apple Music</button>
+      <pre id="status"></pre>
+    </main>
+    <script>
+      const developerToken = ${JSON.stringify(developerToken)};
+      const appName = ${JSON.stringify(appName)};
+      const appBuild = ${JSON.stringify(appBuild)};
+      const state = ${JSON.stringify(state)};
+      const tokenPath = ${JSON.stringify(tokenPath)};
+      const status = document.getElementById('status');
+      document.getElementById('authorize').addEventListener('click', async () => {
+        try {
+          MusicKit.configure({ developerToken, app: { name: appName, build: appBuild } });
+          const music = MusicKit.getInstance();
+          const userToken = await music.authorize();
+          const storefront = music.storefrontId || null;
+          await fetch(tokenPath, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ state, userToken, storefront }),
+          });
+          status.textContent = 'Apple Music auth complete. I saved your token locally.';
+        } catch (error) {
+          status.textContent = String(error && error.message ? error.message : error);
+        }
+      });
+    </script>
+  </body>
+</html>`;
+}
+/**
+ * I serve a local MusicKit bootstrap page and wait for the browser to post the user token back.
+ */
+async function captureUserToken(config, developerToken) {
+    const bootstrapUrl = new URL(config.bootstrapUrl);
+    const bootstrapState = randomBytes(24).toString('base64url');
+    const tokenPath = bootstrapUrl.pathname === '/'
+        ? '/token'
+        : `${bootstrapUrl.pathname.replace(/\/$/, '')}/token`;
+    return new Promise((resolve, reject) => {
+        const server = createServer((request, response) => {
+            const requestUrl = new URL(request.url || '/', bootstrapUrl);
+            if (request.method === 'GET' && requestUrl.pathname === bootstrapUrl.pathname) {
+                response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                response.end(renderBootstrapPage(developerToken, config.appName, config.appBuild, tokenPath, bootstrapState));
+                return;
+            }
+            if (request.method === 'POST' && requestUrl.pathname === tokenPath) {
+                let body = '';
+                request.on('data', chunk => { body += chunk.toString(); });
+                request.on('end', () => {
+                    try {
+                        const payload = JSON.parse(body || '{}');
+                        const origin = request.headers.origin;
+                        if (origin && origin !== bootstrapUrl.origin) {
+                            throw new Error('Apple Music bootstrap origin did not match the local bootstrap server.');
+                        }
+                        if (payload.state !== bootstrapState) {
+                            throw new Error('Apple Music bootstrap state did not match the login attempt.');
+                        }
+                        response.writeHead(200).end('ok');
+                        resolve(payload);
+                    }
+                    catch (error) {
+                        response.writeHead(400).end('invalid bootstrap request');
+                        reject(error);
+                    }
+                    finally {
+                        server.close();
+                    }
+                });
+                return;
+            }
+            response.writeHead(404).end('Not found');
+        });
+        server.on('error', reject);
+        server.listen(Number(bootstrapUrl.port || 80), bootstrapUrl.hostname);
+    });
+}
+/**
+ * I print the current Apple Music auth posture in a machine-friendly format.
+ */
+async function printStatus(state, lifecycle) {
+    console.log(JSON.stringify({
+        provider: 'apple-music',
+        state: lifecycle,
+        connected: Boolean(state?.developerToken),
+        hasDeveloperToken: Boolean(state?.developerToken),
+        hasUserToken: Boolean(state?.userToken),
+        mode: !state?.developerToken ? 'disconnected' : state.userToken ? 'catalog-and-library' : 'catalog-only',
+        storefront: state?.storefront || null,
+        developerTokenSource: state?.developerTokenSource || null,
+        developerTokenExpiresAt: state?.developerTokenExpiresAt || null,
+        authFile: authPath,
+    }, null, 2));
+}
+async function bootstrap() {
+    const config = readConfig();
+    const existing = await readJson(authPath);
+    const developer = await resolveDeveloperToken(config, existing);
+    if (!developer) {
+        throw new Error('Set APPLE_MUSIC_DEVELOPER_TOKEN or APPLE_MUSIC_TEAM_ID / APPLE_MUSIC_KEY_ID / APPLE_MUSIC_PRIVATE_KEY_PATH.');
+    }
+    if (existing?.userToken && process.env.HARMON_AUTH_FORCE !== '1' && !config.userToken) {
+        const current = {
+            ...existing,
+            storefront: config.storefront || existing.storefront,
+            developerToken: developer.token,
+            developerTokenSource: developer.source,
+            developerTokenExpiresAt: developer.expiresAt,
+        };
+        try {
+            await validateApple(current);
+            await writeJson(authPath, current);
+            await printStatus(current, 'already-authenticated');
+            return;
+        }
+        catch {
+            // I fall through to MusicKit bootstrap so rerunning auth can repair an
+            // expired stored user token without requiring an undocumented force flag.
+        }
+    }
+    console.error(`Apple Music bootstrap URL: ${config.bootstrapUrl}`);
+    const tokenPromise = config.userToken
+        ? Promise.resolve({ userToken: config.userToken, storefront: config.storefront })
+        : captureUserToken(config, developer.token);
+    if (!config.userToken) {
+        await openUrl(config.bootstrapUrl);
+    }
+    const tokenPayload = await tokenPromise;
+    const state = {
+        provider: 'apple-music',
+        updatedAt: new Date().toISOString(),
+        developerToken: developer.token,
+        developerTokenSource: developer.source,
+        developerTokenExpiresAt: developer.expiresAt,
+        userToken: tokenPayload.userToken || null,
+        storefront: tokenPayload.storefront || config.storefront,
+        appName: config.appName,
+        appBuild: config.appBuild,
+    };
+    await validateApple(state);
+    await writeJson(authPath, state);
+    await printStatus(state, 'bootstrapped');
+}
+async function refresh() {
+    const config = readConfig();
+    const existing = await readJson(authPath);
+    const developer = await resolveDeveloperToken(config, existing);
+    if (!developer) {
+        throw new Error('I cannot refresh Apple Music auth without a developer token or key material.');
+    }
+    const state = {
+        provider: 'apple-music',
+        updatedAt: new Date().toISOString(),
+        developerToken: developer.token,
+        developerTokenSource: developer.source,
+        developerTokenExpiresAt: developer.expiresAt,
+        userToken: config.userToken || existing?.userToken || null,
+        storefront: config.storefront || existing?.storefront || 'us',
+        appName: config.appName,
+        appBuild: config.appBuild,
+    };
+    await validateApple(state);
+    await writeJson(authPath, state);
+    await printStatus(state, 'refreshed');
+}
+async function status() {
+    const state = await readJson(authPath);
+    await printStatus(state, 'status');
+}
+function isNodeError(error) {
+    return error !== null && typeof error === 'object' && 'code' in error;
+}
+const action = process.argv[2] || 'bootstrap';
+const handlers = { bootstrap, refresh, status };
+if (!handlers[action]) {
+    console.error(`Unknown Apple Music auth command: ${action}`);
+    process.exitCode = 1;
+}
+else {
+    handlers[action]().catch(error => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=auth-cli.js.map

package/dist/auth-cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Harmon Apple - Apple Music API client
+ */
+import type { TrackInfo } from '@sriinnu/harmon-protocol';
+import type { MusicProvider, AudioFeatures } from '@sriinnu/harmon-core';
+export interface AppleMusicConfig {
+    developerToken: string;
+    userToken?: string;
+    storefront?: string;
+}
+export type AppleSearchType = 'songs' | 'albums' | 'artists' | 'playlists';
+export interface AppleListOptions {
+    limit?: number;
+    offset?: number;
+}
+export interface AppleMusicSearchResult {
+    songs: AppleMusicSong[];
+    albums: AppleMusicAlbum[];
+    artists: AppleMusicArtist[];
+    playlists: AppleMusicPlaylist[];
+}
+export interface AppleMusicSong {
+    id: string;
+    name: string;
+    artistName: string;
+    albumName?: string;
+    durationMs?: number;
+    url?: string;
+}
+export interface AppleMusicAlbum {
+    id: string;
+    name: string;
+    artistName: string;
+    releaseDate?: string;
+    trackCount?: number;
+    url?: string;
+}
+export interface AppleMusicArtist {
+    id: string;
+    name: string;
+    url?: string;
+}
+export interface AppleMusicPlaylist {
+    id: string;
+    name: string;
+    curatorName?: string;
+    trackCount?: number;
+    url?: string;
+}
+export interface AppleMusicLibrarySong {
+    id: string;
+    name: string;
+    artistName: string;
+    albumName?: string;
+}
+export interface AppleMusicLibraryAlbum {
+    id: string;
+    name: string;
+    artistName: string;
+    trackCount?: number;
+}
+export interface AppleMusicLibraryPlaylist {
+    id: string;
+    name: string;
+    trackCount?: number;
+}
+export interface AppleMusicClient {
+    search(term: string, types: AppleSearchType[], options?: AppleListOptions): Promise<AppleMusicSearchResult>;
+    getSong(id: string): Promise<AppleMusicSong | null>;
+    getAlbum(id: string): Promise<AppleMusicAlbum | null>;
+    getArtist(id: string): Promise<AppleMusicArtist | null>;
+    getPlaylist(id: string): Promise<AppleMusicPlaylist | null>;
+    getPlaylistTracks(id: string, options?: AppleListOptions): Promise<AppleMusicSong[]>;
+    getRecentlyPlayedTracks(options?: AppleListOptions): Promise<AppleMusicSong[]>;
+    getLibrarySongs(options?: AppleListOptions): Promise<AppleMusicLibrarySong[]>;
+    getLibraryAlbums(options?: AppleListOptions): Promise<AppleMusicLibraryAlbum[]>;
+    getLibraryPlaylists(options?: AppleListOptions): Promise<AppleMusicLibraryPlaylist[]>;
+}
+/**
+ * Adapts AppleMusicClient to the MusicProvider interface.
+ */
+export declare class AppleMusicProvider implements MusicProvider {
+    readonly name: "apple";
+    private client;
+    private connected;
+    constructor(client: AppleMusicClient, connected?: boolean);
+    isConnected(): boolean;
+    search(query: string, limit?: number): Promise<TrackInfo[]>;
+    getLibraryTracks(options?: {
+        limit?: number;
+    }): Promise<TrackInfo[]>;
+    /**
+     * I reject synthetic top-track semantics so the Apple provider stays honest
+     * about the personal-history surface it actually implements.
+     */
+    getTopTracks(options?: {
+        limit?: number;
+    }): Promise<TrackInfo[]>;
+    getRecentlyPlayed(options?: {
+        limit?: number;
+    }): Promise<TrackInfo[]>;
+    getPlaylistTracks(playlistId: string, options?: {
+        limit?: number;
+    }): Promise<TrackInfo[]>;
+    /**
+     * 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.
+     */
+    getRecommendations(options: {
+        seedTrackIds?: string[];
+        limit?: number;
+    }): Promise<TrackInfo[]>;
+    getTrackFeatures(trackIds: string[]): Promise<(AudioFeatures | null)[]>;
+    /**
+     * I prefer explicit seed tracks and fall back to recent listening history so
+     * recommendation discovery remains provider-aware for Apple sessions.
+     */
+    private resolveRecommendationSeeds;
+}
+export declare function createAppleMusicProvider(client: AppleMusicClient): MusicProvider;
+export declare function createAppleMusicClient(config: AppleMusicConfig): AppleMusicClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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