@spotify/web-api-ts-sdk/src/endpoints/ChaptersEndpoints.ts

A typescript SDK for the Spotify Web API

import type { Chapter, Chapters } from '../types.js';
import EndpointsBase from './EndpointsBase.js';

// These are mandatory, and the only supported market codes for the Chapters API
export type ChapterMarket = "GB" | "US" | "IE" | "NZ" | "AU";

export default class ChaptersEndpoints extends EndpointsBase {
    public get(id: string, market: ChapterMarket): Promise<Chapter>;
    public get(ids: string[], market: ChapterMarket): Promise<Chapter[]>;
    public async get(idOrIds: string | string[], market: ChapterMarket) {
        if (typeof idOrIds === 'string') {
            const params = this.paramsFor({ market });
            return this.getRequest<Chapter>(`chapters/${idOrIds}${params}`);
        }

        // TODO: Only returns top 50, validate / pre-check here
        const params = this.paramsFor({ ids: idOrIds, market });
        const response = await this.getRequest<Chapters>(`chapters${params}`);
        return response.chapters;
    }
}