@bzenky/spoti 0.1.0

package/dist/auth/spotify-auth-client.js

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+import { AppError, toError } from '../utils/errors.js';
+const TOKEN_ENDPOINT = 'https://accounts.spotify.com/api/token';
+const CURRENT_USER_ENDPOINT = 'https://api.spotify.com/v1/me';
+const MAX_RATE_LIMIT_RETRIES = 3;
+const sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+const tokenResponseSchema = z.object({
+    access_token: z.string().min(1),
+    refresh_token: z.string().min(1).optional(),
+    expires_in: z.number().int().positive(),
+});
+const userProfileSchema = z.object({
+    id: z.string().min(1),
+    display_name: z.string().nullable(),
+    product: z.string().optional(),
+});
+export class OAuthTokenError extends AppError {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export class SpotifyAuthClient {
+    fetchImplementation;
+    sleeper;
+    constructor(fetchImplementation = globalThis.fetch, sleeper = sleep) {
+        this.fetchImplementation = fetchImplementation;
+        this.sleeper = sleeper;
+    }
+    async exchangeCode(input) {
+        return this.requestToken(new URLSearchParams({
+            grant_type: 'authorization_code',
+            client_id: input.clientId,
+            code: input.code,
+            redirect_uri: input.redirectUri,
+            code_verifier: input.codeVerifier,
+        }));
+    }
+    async refreshAccessToken(input) {
+        return this.requestToken(new URLSearchParams({
+            grant_type: 'refresh_token',
+            client_id: input.clientId,
+            refresh_token: input.refreshToken,
+        }));
+    }
+    async getCurrentUser(accessToken) {
+        const response = await this.fetchWithTimeout(CURRENT_USER_ENDPOINT, {
+            headers: { authorization: `Bearer ${accessToken}` },
+        });
+        const body = await readJson(response);
+        if (!response.ok) {
+            throw new AppError(getErrorMessage(body, 'Unable to fetch the current Spotify user.'));
+        }
+        const profile = userProfileSchema.safeParse(body);
+        if (!profile.success) {
+            throw new AppError('Spotify returned an invalid user profile response.');
+        }
+        const result = {
+            id: profile.data.id,
+            displayName: profile.data.display_name ?? profile.data.id,
+        };
+        if (profile.data.product !== undefined)
+            result.product = profile.data.product;
+        return result;
+    }
+    async requestToken(parameters) {
+        const response = await this.fetchWithTimeout(TOKEN_ENDPOINT, {
+            method: 'POST',
+            headers: { 'content-type': 'application/x-www-form-urlencoded' },
+            body: parameters,
+        });
+        const body = await readJson(response);
+        if (!response.ok) {
+            const oauthErrorCode = getOAuthErrorCode(body);
+            const message = getErrorMessage(body, 'Spotify token request failed.');
+            if (oauthErrorCode)
+                throw new OAuthTokenError(oauthErrorCode, message);
+            throw new AppError(message);
+        }
+        const token = tokenResponseSchema.safeParse(body);
+        if (!token.success) {
+            throw new AppError('Spotify returned an invalid token response.');
+        }
+        const result = {
+            accessToken: token.data.access_token,
+            expiresIn: token.data.expires_in,
+        };
+        if (token.data.refresh_token !== undefined) {
+            result.refreshToken = token.data.refresh_token;
+        }
+        return result;
+    }
+    async fetchWithTimeout(url, init) {
+        for (let attempt = 0;; attempt += 1) {
+            let response;
+            try {
+                response = await this.fetchImplementation(url, {
+                    ...init,
+                    signal: AbortSignal.timeout(15_000),
+                });
+            }
+            catch (error) {
+                const normalizedError = toError(error);
+                if (normalizedError.name === 'TimeoutError') {
+                    throw new AppError('Spotify did not respond within 15 seconds. Try again.');
+                }
+                throw new AppError(`Unable to reach Spotify: ${normalizedError.message}`);
+            }
+            if (response.status !== 429 || attempt >= MAX_RATE_LIMIT_RETRIES)
+                return response;
+            const retryAfterSeconds = Number(response.headers.get('retry-after'));
+            const retryAfterMs = Number.isFinite(retryAfterSeconds) && retryAfterSeconds >= 0
+                ? retryAfterSeconds * 1_000
+                : 0;
+            await this.sleeper(Math.max(retryAfterMs, 500 * 2 ** attempt));
+        }
+    }
+}
+async function readJson(response) {
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new AppError('Spotify returned a malformed response.');
+    }
+}
+function getOAuthErrorCode(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    const error = body.error;
+    return typeof error === 'string' ? error : null;
+}
+function getErrorMessage(body, fallback) {
+    if (!body || typeof body !== 'object')
+        return fallback;
+    const record = body;
+    if (typeof record.error_description === 'string')
+        return record.error_description;
+    if (typeof record.error === 'string')
+        return `Spotify request failed: ${record.error}`;
+    if (record.error && typeof record.error === 'object') {
+        const nestedError = record.error;
+        if (typeof nestedError.message === 'string')
+            return nestedError.message;
+    }
+    return fallback;
+}
+//# sourceMappingURL=spotify-auth-client.js.map

package/dist/auth/spotify-auth-client.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { createProgram } from './app.js';
+import { AuthService } from './services/auth.service.js';
+import { PlayerService } from './services/player.service.js';
+import { SearchService } from './services/search.service.js';
+import { SpotifyClient } from './spotify/client.js';
+import { consoleOutput } from './ui/output.js';
+import { AppError, toError } from './utils/errors.js';
+const auth = new AuthService();
+const spotify = new SpotifyClient(auth);
+const program = createProgram({
+    auth,
+    player: new PlayerService(spotify),
+    search: new SearchService(spotify),
+    output: consoleOutput,
+});
+try {
+    await program.parseAsync(process.argv);
+}
+catch (error) {
+    const normalizedError = toError(error);
+    consoleOutput.error(normalizedError.message);
+    process.exitCode = error instanceof AppError ? error.exitCode : 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAC/B,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;AACxC,MAAM,OAAO,GAAG,aAAa,CAAC;IAC5B,IAAI;IACJ,MAAM,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC;IAClC,MAAM,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC;IAClC,MAAM,EAAE,aAAa;CACtB,CAAC,CAAC;AAEH,IAAI,CAAC;IACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,CAAC,QAAQ,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/services/auth.service.d.ts

@@ -0,0 +1,36 @@
+import type { UserProfile } from './models.js';
+import { type PkcePair } from '../auth/pkce.js';
+import { type AuthConfig } from '../auth/config.js';
+import { type SpotifyAuthApi } from '../auth/spotify-auth-client.js';
+import { type CredentialStore } from '../storage/credentials.js';
+type AuthorizationCodeProvider = (authorizationUrl: string, redirectUri: string, expectedState: string) => Promise<string>;
+export interface AuthServiceDependencies {
+    credentialStore?: CredentialStore;
+    spotifyAuthApi?: SpotifyAuthApi;
+    loadConfig?: () => AuthConfig;
+    requestAuthorizationCode?: AuthorizationCodeProvider;
+    createPkcePair?: () => PkcePair;
+    createState?: () => string;
+    now?: () => number;
+}
+export declare class AuthService {
+    private readonly credentialStore;
+    private readonly spotifyAuthApi;
+    private readonly configLoader;
+    private readonly authorizationCodeProvider;
+    private readonly pkceFactory;
+    private readonly stateFactory;
+    private readonly clock;
+    private refreshPromise;
+    constructor(dependencies?: AuthServiceDependencies);
+    login(): Promise<UserProfile>;
+    logout(): Promise<void>;
+    getAccessToken(): Promise<string>;
+    forceRefreshAccessToken(): Promise<string>;
+    getCurrentUser(): Promise<UserProfile>;
+    isAuthenticated(): Promise<boolean>;
+    private startTokenRefresh;
+    private performTokenRefresh;
+}
+export declare function createAuthorizationUrl(config: AuthConfig, codeChallenge: string, state: string): string;
+export {};

package/dist/services/auth.service.js

@@ -0,0 +1,127 @@
+import { SPOTIFY_SCOPES } from '../spotify/scopes.js';
+import { generateOAuthState, generatePkcePair, } from '../auth/pkce.js';
+import { loadAuthConfig } from '../auth/config.js';
+import { requestAuthorizationCode } from '../auth/callback.js';
+import { OAuthTokenError, SpotifyAuthClient, } from '../auth/spotify-auth-client.js';
+import { FileCredentialStore, isTokenExpired, } from '../storage/credentials.js';
+import { AuthenticationRequiredError, ConfigurationError, } from '../utils/errors.js';
+const AUTHORIZE_ENDPOINT = 'https://accounts.spotify.com/authorize';
+export class AuthService {
+    credentialStore;
+    spotifyAuthApi;
+    configLoader;
+    authorizationCodeProvider;
+    pkceFactory;
+    stateFactory;
+    clock;
+    refreshPromise;
+    constructor(dependencies = {}) {
+        this.credentialStore = dependencies.credentialStore ?? new FileCredentialStore();
+        this.spotifyAuthApi = dependencies.spotifyAuthApi ?? new SpotifyAuthClient();
+        this.configLoader = dependencies.loadConfig ?? loadAuthConfig;
+        this.authorizationCodeProvider =
+            dependencies.requestAuthorizationCode ?? requestAuthorizationCode;
+        this.pkceFactory = dependencies.createPkcePair ?? generatePkcePair;
+        this.stateFactory = dependencies.createState ?? generateOAuthState;
+        this.clock = dependencies.now ?? Date.now;
+    }
+    async login() {
+        const config = this.configLoader();
+        const pkce = this.pkceFactory();
+        const state = this.stateFactory();
+        const authorizationUrl = createAuthorizationUrl(config, pkce.challenge, state);
+        const code = await this.authorizationCodeProvider(authorizationUrl, config.redirectUri, state);
+        const token = await this.spotifyAuthApi.exchangeCode({
+            clientId: config.clientId,
+            code,
+            redirectUri: config.redirectUri,
+            codeVerifier: pkce.verifier,
+        });
+        if (!token.refreshToken) {
+            throw new ConfigurationError('Spotify did not return a refresh token during login.');
+        }
+        const credentials = {
+            accessToken: token.accessToken,
+            refreshToken: token.refreshToken,
+            expiresAt: this.clock() + token.expiresIn * 1_000,
+        };
+        const user = await this.spotifyAuthApi.getCurrentUser(credentials.accessToken);
+        await this.credentialStore.write(credentials);
+        return user;
+    }
+    async logout() {
+        await this.credentialStore.delete();
+    }
+    async getAccessToken() {
+        const credentials = await this.credentialStore.read();
+        if (!credentials)
+            throw new AuthenticationRequiredError();
+        if (!isTokenExpired(credentials, this.clock()))
+            return credentials.accessToken;
+        return this.startTokenRefresh(credentials);
+    }
+    async forceRefreshAccessToken() {
+        const credentials = await this.credentialStore.read();
+        if (!credentials)
+            throw new AuthenticationRequiredError();
+        return this.startTokenRefresh(credentials);
+    }
+    async getCurrentUser() {
+        const accessToken = await this.getAccessToken();
+        return this.spotifyAuthApi.getCurrentUser(accessToken);
+    }
+    async isAuthenticated() {
+        return (await this.credentialStore.read()) !== null;
+    }
+    startTokenRefresh(credentials) {
+        if (!this.refreshPromise) {
+            const refreshPromise = this.performTokenRefresh(credentials);
+            this.refreshPromise = refreshPromise;
+            void refreshPromise
+                .finally(() => {
+                if (this.refreshPromise === refreshPromise)
+                    this.refreshPromise = undefined;
+            })
+                .catch(() => undefined);
+        }
+        return this.refreshPromise;
+    }
+    async performTokenRefresh(credentials) {
+        const config = this.configLoader();
+        let token;
+        try {
+            token = await this.spotifyAuthApi.refreshAccessToken({
+                clientId: config.clientId,
+                refreshToken: credentials.refreshToken,
+            });
+        }
+        catch (error) {
+            if (error instanceof OAuthTokenError && error.code === 'invalid_grant') {
+                await this.credentialStore.delete();
+                throw new AuthenticationRequiredError('Your Spotify session has expired or was revoked.\n\nRun: spoti login');
+            }
+            throw error;
+        }
+        const updatedCredentials = {
+            accessToken: token.accessToken,
+            refreshToken: token.refreshToken ?? credentials.refreshToken,
+            expiresAt: this.clock() + token.expiresIn * 1_000,
+        };
+        await this.credentialStore.write(updatedCredentials);
+        return updatedCredentials.accessToken;
+    }
+}
+export function createAuthorizationUrl(config, codeChallenge, state) {
+    const url = new URL(AUTHORIZE_ENDPOINT);
+    url.search = new URLSearchParams({
+        client_id: config.clientId,
+        response_type: 'code',
+        redirect_uri: config.redirectUri,
+        code_challenge_method: 'S256',
+        code_challenge: codeChallenge,
+        state,
+        scope: SPOTIFY_SCOPES.join(' '),
+    }).toString();
+    return url.toString();
+}
+//# sourceMappingURL=auth.service.js.map

package/dist/services/auth.service.js.map

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

package/dist/services/models.d.ts

@@ -0,0 +1,20 @@
+export interface UserProfile {
+    id: string;
+    displayName: string;
+    product?: string;
+}
+export interface Track {
+    id: string;
+    uri: string;
+    name: string;
+    artists: string[];
+    album: string;
+    durationMs: number;
+    externalUrl?: string;
+}
+export interface CurrentPlayback {
+    isPlaying: boolean;
+    track: Track;
+    progressMs: number;
+    deviceName?: string;
+}

package/dist/services/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/dist/services/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/services/models.ts"],"names":[],"mappings":""}

package/dist/services/player.service.d.ts

@@ -0,0 +1,12 @@
+import type { SpotifyApi } from '../spotify/client.js';
+import type { CurrentPlayback } from './models.js';
+export declare class PlayerService {
+    private readonly spotify;
+    constructor(spotify: SpotifyApi);
+    getCurrentPlayback(): Promise<CurrentPlayback | null>;
+    playTrack(uri: string): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    next(): Promise<void>;
+    previous(): Promise<void>;
+}

package/dist/services/player.service.js

@@ -0,0 +1,45 @@
+export class PlayerService {
+    spotify;
+    constructor(spotify) {
+        this.spotify = spotify;
+    }
+    async getCurrentPlayback() {
+        const playback = await this.spotify.get('/me/player');
+        if (!playback?.item)
+            return null;
+        return {
+            isPlaying: playback.is_playing,
+            track: mapTrack(playback.item),
+            progressMs: playback.progress_ms ?? 0,
+            deviceName: playback.device.name,
+        };
+    }
+    async playTrack(uri) {
+        await this.spotify.put('/me/player/play', { body: { uris: [uri] } });
+    }
+    async pause() {
+        await this.spotify.put('/me/player/pause');
+    }
+    async resume() {
+        await this.spotify.put('/me/player/play');
+    }
+    async next() {
+        await this.spotify.post('/me/player/next');
+    }
+    async previous() {
+        await this.spotify.post('/me/player/previous');
+    }
+}
+function mapTrack(track) {
+    const externalUrl = track.external_urls?.spotify;
+    return {
+        id: track.id,
+        uri: track.uri,
+        name: track.name,
+        artists: track.artists.map((artist) => artist.name),
+        album: track.album.name,
+        durationMs: track.duration_ms,
+        ...(externalUrl ? { externalUrl } : {}),
+    };
+}
+//# sourceMappingURL=player.service.js.map

package/dist/services/player.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.service.js","sourceRoot":"","sources":["../../src/services/player.service.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,kBAAkB;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAmC,YAAY,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,EAAE,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,UAAU;YAC9B,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC9B,UAAU,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;YACrC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAO,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAO,kBAAkB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAO,iBAAiB,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAO,iBAAiB,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAO,qBAAqB,CAAC,CAAC;IACvD,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAwC;IACxD,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC;IACjD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACnD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACvB,UAAU,EAAE,KAAK,CAAC,WAAW;QAC7B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/services/search.service.d.ts

@@ -0,0 +1,7 @@
+import type { SpotifyApi } from '../spotify/client.js';
+import type { Track } from './models.js';
+export declare class SearchService {
+    private readonly spotify;
+    constructor(spotify: SpotifyApi);
+    searchTracks(query: string, limit?: number): Promise<Track[]>;
+}

package/dist/services/search.service.js

@@ -0,0 +1,28 @@
+export class SearchService {
+    spotify;
+    constructor(spotify) {
+        this.spotify = spotify;
+    }
+    async searchTracks(query, limit = 10) {
+        const normalizedQuery = query.trim();
+        if (!normalizedQuery)
+            return [];
+        const response = await this.spotify.get('/search', {
+            query: { q: normalizedQuery, type: 'track', limit },
+        });
+        return response.tracks.items.map(mapTrack);
+    }
+}
+function mapTrack(track) {
+    const externalUrl = track.external_urls?.spotify;
+    return {
+        id: track.id,
+        uri: track.uri,
+        name: track.name,
+        artists: track.artists.map((artist) => artist.name),
+        album: track.album.name,
+        durationMs: track.duration_ms,
+        ...(externalUrl ? { externalUrl } : {}),
+    };
+}
+//# sourceMappingURL=search.service.js.map

package/dist/services/search.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.service.js","sourceRoot":"","sources":["../../src/services/search.service.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC1C,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAwB,SAAS,EAAE;YACxE,KAAK,EAAE,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;SACpD,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAmB;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC;IACjD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACnD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACvB,UAAU,EAAE,KAAK,CAAC,WAAW;QAC7B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/spotify/client.d.ts

@@ -0,0 +1,27 @@
+type Sleep = (milliseconds: number) => Promise<void>;
+export interface RequestOptions {
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+}
+export interface SpotifyApi {
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+export interface AccessTokenProvider {
+    getAccessToken(): Promise<string>;
+    forceRefreshAccessToken(): Promise<string>;
+}
+export declare class SpotifyClient implements SpotifyApi {
+    private readonly authService;
+    private readonly fetcher;
+    private readonly sleeper;
+    constructor(authService: AccessTokenProvider, fetcher?: typeof fetch, sleeper?: Sleep);
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    private request;
+}
+export {};

package/dist/spotify/client.js

@@ -0,0 +1,113 @@
+import { AppError, AuthenticationRequiredError, NoActiveDeviceError, PremiumRequiredError, RateLimitedError, SpotifyApiError, toError, } from '../utils/errors.js';
+const API_BASE_URL = 'https://api.spotify.com/v1';
+const MAX_RATE_LIMIT_RETRIES = 3;
+const sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+export class SpotifyClient {
+    authService;
+    fetcher;
+    sleeper;
+    constructor(authService, fetcher = fetch, sleeper = sleep) {
+        this.authService = authService;
+        this.fetcher = fetcher;
+        this.sleeper = sleeper;
+    }
+    get(path, options) {
+        return this.request('GET', path, options);
+    }
+    post(path, options) {
+        return this.request('POST', path, options);
+    }
+    put(path, options) {
+        return this.request('PUT', path, options);
+    }
+    delete(path, options) {
+        return this.request('DELETE', path, options);
+    }
+    async request(method, path, options = {}) {
+        const url = new URL(`${API_BASE_URL}${path.startsWith('/') ? path : `/${path}`}`);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        const headers = new Headers();
+        let body;
+        if (options.body !== undefined) {
+            headers.set('Content-Type', 'application/json');
+            body = JSON.stringify(options.body);
+        }
+        const execute = async (token) => {
+            headers.set('Authorization', `Bearer ${token}`);
+            try {
+                return await this.fetcher(url, {
+                    method,
+                    headers,
+                    signal: AbortSignal.timeout(15_000),
+                    ...(body === undefined ? {} : { body }),
+                });
+            }
+            catch (error) {
+                const normalizedError = toError(error);
+                if (normalizedError.name === 'TimeoutError') {
+                    throw new AppError('Spotify did not respond within 15 seconds. Try again.');
+                }
+                throw new AppError(`Unable to reach Spotify: ${normalizedError.message}`);
+            }
+        };
+        let accessToken = await this.authService.getAccessToken();
+        let refreshedToken = false;
+        let rateLimitRetries = 0;
+        let response;
+        while (true) {
+            response = await execute(accessToken);
+            if (response.status === 401 && !refreshedToken) {
+                accessToken = await this.authService.forceRefreshAccessToken();
+                refreshedToken = true;
+                continue;
+            }
+            if (response.status === 429 && rateLimitRetries < MAX_RATE_LIMIT_RETRIES) {
+                const retryAfterMs = getRetryAfterMilliseconds(response);
+                const exponentialBackoffMs = 500 * 2 ** rateLimitRetries;
+                rateLimitRetries += 1;
+                await this.sleeper(Math.max(retryAfterMs, exponentialBackoffMs));
+                continue;
+            }
+            break;
+        }
+        if (!response.ok)
+            throw await mapSpotifyError(response);
+        if (response.status === 204)
+            return undefined;
+        const text = await response.text();
+        return (text ? JSON.parse(text) : undefined);
+    }
+}
+function getRetryAfterMilliseconds(response) {
+    const seconds = Number(response.headers.get('retry-after'));
+    return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1_000 : 0;
+}
+async function mapSpotifyError(response) {
+    const body = await readErrorBody(response);
+    const spotifyMessage = typeof body.error === 'object' ? body.error?.message : body.error_description;
+    const message = spotifyMessage || `Spotify API request failed with HTTP ${response.status}.`;
+    if (response.status === 401) {
+        return new AuthenticationRequiredError('Spotify authentication has expired or was revoked.\n\nRun: spoti login');
+    }
+    if (response.status === 403 && /premium/i.test(message))
+        return new PremiumRequiredError();
+    if (response.status === 404 && /device/i.test(message))
+        return new NoActiveDeviceError();
+    if (response.status === 429) {
+        const retryAfter = Number(response.headers.get('retry-after') ?? '1');
+        return new RateLimitedError(Number.isFinite(retryAfter) ? retryAfter : 1);
+    }
+    return new SpotifyApiError(message, response.status);
+}
+async function readErrorBody(response) {
+    try {
+        return (await response.json());
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=client.js.map