@kody/spotify

import {
	DEFAULT_SPOTIFY_INTEGRATION,
	SPOTIFY_ALLOWED_HOSTS,
	SPOTIFY_API_BASE_URL,
	SPOTIFY_AUTHORIZE_URL,
	SPOTIFY_CALLBACK_URL,
	SPOTIFY_DASHBOARD_URL,
	SPOTIFY_FULL_CONNECT_URL,
	SPOTIFY_FULL_SCOPES,
	SPOTIFY_GUIDE_SCOPES,
	SPOTIFY_READ_CONNECT_URL,
	SPOTIFY_READ_SCOPES,
	SPOTIFY_TOKEN_URL,
	accounts,
} from './lib/accounts.ts'

/** Describe the Spotify helpers package, PKCE connect URLs, and export surface. */
export default async function describeSpotifyPackage() {
	return {
		package: '@kody/spotify',
		kodyId: 'spotify',
		purpose:
			'Official Spotify helpers for profile, search, library, playlists, devices, and playback.',
		defaultIntegration: DEFAULT_SPOTIFY_INTEGRATION,
		callbackUrl: SPOTIFY_CALLBACK_URL,
		authorizeUrl: SPOTIFY_AUTHORIZE_URL,
		tokenUrl: SPOTIFY_TOKEN_URL,
		apiBaseUrl: SPOTIFY_API_BASE_URL,
		dashboardUrl: SPOTIFY_DASHBOARD_URL,
		requiredHosts: [...SPOTIFY_ALLOWED_HOSTS],
		flow: 'pkce',
		connectUrl: SPOTIFY_FULL_CONNECT_URL,
		readConnectUrl: SPOTIFY_READ_CONNECT_URL,
		scopes: {
			guide: [...SPOTIFY_GUIDE_SCOPES],
			read: [...SPOTIFY_READ_SCOPES],
			full: [...SPOTIFY_FULL_SCOPES],
		},
		accounts: accounts(),
		publicUrl: 'https://kody.codes/@kody/spotify',
		exports: {
			'get-profile': 'Read the connected Spotify user profile.',
			search: 'Search tracks, albums, artists, or playlists.',
			'get-saved-tracks': 'Read liked/saved library tracks.',
			'save-tracks': 'Save tracks to the library (dryRun supported).',
			'list-playlists': 'List the user’s playlists.',
			'get-devices': 'List Spotify Connect devices.',
			'playback-state': 'Read current playback.',
			'play-context': 'Start album/playlist/artist playback (dryRun supported).',
		},
		safety: {
			dryRunAvailable: true,
			mutations:
				'Playlist writes and playback helpers accept dryRun: true to preview without writing.',
			multiAccount:
				'Pass integration: "spotify" (default) or a spotify-* connection name. No personal aliases.',
		},
	}
}