spotted-ts 0.1.0

package/resources/browse/browse.d.ts

@@ -0,0 +1,165 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import * as CategoriesAPI from "./categories.js";
+import { Categories, CategoryGetPlaylistsParams, CategoryGetPlaylistsResponse, CategoryListParams, CategoryListResponse, CategoryRetrieveParams, CategoryRetrieveResponse } from "./categories.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Browse extends APIResource {
+    categories: CategoriesAPI.Categories;
+    /**
+     * Get a list of Spotify featured playlists (shown, for example, on a Spotify
+     * player's 'Browse' tab).
+     *
+     * @deprecated
+     */
+    getFeaturedPlaylists(query?: BrowseGetFeaturedPlaylistsParams | null | undefined, options?: RequestOptions): APIPromise<BrowseGetFeaturedPlaylistsResponse>;
+    /**
+     * Get a list of new album releases featured in Spotify (shown, for example, on a
+     * Spotify player’s “Browse” tab).
+     */
+    getNewReleases(query?: BrowseGetNewReleasesParams | null | undefined, options?: RequestOptions): APIPromise<BrowseGetNewReleasesResponse>;
+}
+export interface BrowseGetFeaturedPlaylistsResponse {
+    /**
+     * The localized message of a playlist.
+     */
+    message?: string;
+    playlists?: Shared.PagingPlaylistObject;
+}
+export interface BrowseGetNewReleasesResponse {
+    albums: BrowseGetNewReleasesResponse.Albums;
+}
+export declare namespace BrowseGetNewReleasesResponse {
+    interface Albums {
+        /**
+         * A link to the Web API endpoint returning the full result of the request
+         */
+        href: string;
+        items: Array<Albums.Item>;
+        /**
+         * The maximum number of items in the response (as set in the query or by default).
+         */
+        limit: number;
+        /**
+         * URL to the next page of items. ( `null` if none)
+         */
+        next: string | null;
+        /**
+         * The offset of the items returned (as set in the query or by default)
+         */
+        offset: number;
+        /**
+         * URL to the previous page of items. ( `null` if none)
+         */
+        previous: string | null;
+        /**
+         * The total number of items available to return.
+         */
+        total: number;
+    }
+    namespace Albums {
+        interface Item {
+            /**
+             * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+             * album.
+             */
+            id: string;
+            /**
+             * The type of the album.
+             */
+            album_type: 'album' | 'single' | 'compilation';
+            /**
+             * The artists of the album. Each artist object includes a link in `href` to more
+             * detailed information about the artist.
+             */
+            artists: Array<Shared.SimplifiedArtistObject>;
+            /**
+             * The markets in which the album is available:
+             * [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+             * _**NOTE**: an album is considered available in a market when at least 1 of its
+             * tracks is available in that market._
+             */
+            available_markets: Array<string>;
+            /**
+             * Known external URLs for this album.
+             */
+            external_urls: Shared.ExternalURLObject;
+            /**
+             * A link to the Web API endpoint providing full details of the album.
+             */
+            href: string;
+            /**
+             * The cover art for the album in various sizes, widest first.
+             */
+            images: Array<Shared.ImageObject>;
+            /**
+             * The name of the album. In case of an album takedown, the value may be an empty
+             * string.
+             */
+            name: string;
+            /**
+             * The date the album was first released.
+             */
+            release_date: string;
+            /**
+             * The precision with which `release_date` value is known.
+             */
+            release_date_precision: 'year' | 'month' | 'day';
+            /**
+             * The number of tracks in the album.
+             */
+            total_tracks: number;
+            /**
+             * The object type.
+             */
+            type: 'album';
+            /**
+             * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+             * album.
+             */
+            uri: string;
+            /**
+             * Included in the response when a content restriction is applied.
+             */
+            restrictions?: Shared.AlbumRestrictionObject;
+        }
+    }
+}
+export interface BrowseGetFeaturedPlaylistsParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The desired language, consisting of an
+     * [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+     * [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+     * joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+     * (Mexico)&quot;. Provide this parameter if you want the category strings returned
+     * in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+     * specified language is not available, the category strings returned will be in
+     * the Spotify default language (American English)._
+     */
+    locale?: string;
+    /**
+     * The index of the first item to return. Default: 0 (the first item). Use with
+     * limit to get the next set of items.
+     */
+    offset?: number;
+}
+export interface BrowseGetNewReleasesParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The index of the first item to return. Default: 0 (the first item). Use with
+     * limit to get the next set of items.
+     */
+    offset?: number;
+}
+export declare namespace Browse {
+    export { type BrowseGetFeaturedPlaylistsResponse as BrowseGetFeaturedPlaylistsResponse, type BrowseGetNewReleasesResponse as BrowseGetNewReleasesResponse, type BrowseGetFeaturedPlaylistsParams as BrowseGetFeaturedPlaylistsParams, type BrowseGetNewReleasesParams as BrowseGetNewReleasesParams, };
+    export { Categories as Categories, type CategoryRetrieveResponse as CategoryRetrieveResponse, type CategoryListResponse as CategoryListResponse, type CategoryGetPlaylistsResponse as CategoryGetPlaylistsResponse, type CategoryRetrieveParams as CategoryRetrieveParams, type CategoryListParams as CategoryListParams, type CategoryGetPlaylistsParams as CategoryGetPlaylistsParams, };
+}
+//# sourceMappingURL=browse.d.ts.map

package/resources/browse/browse.d.ts.map

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

package/resources/browse/browse.js

@@ -0,0 +1,33 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Browse = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const CategoriesAPI = tslib_1.__importStar(require("./categories.js"));
+const categories_1 = require("./categories.js");
+class Browse extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.categories = new CategoriesAPI.Categories(this._client);
+    }
+    /**
+     * Get a list of Spotify featured playlists (shown, for example, on a Spotify
+     * player's 'Browse' tab).
+     *
+     * @deprecated
+     */
+    getFeaturedPlaylists(query = {}, options) {
+        return this._client.get('/browse/featured-playlists', { query, ...options });
+    }
+    /**
+     * Get a list of new album releases featured in Spotify (shown, for example, on a
+     * Spotify player’s “Browse” tab).
+     */
+    getNewReleases(query = {}, options) {
+        return this._client.get('/browse/new-releases', { query, ...options });
+    }
+}
+exports.Browse = Browse;
+Browse.Categories = categories_1.Categories;
+//# sourceMappingURL=browse.js.map

package/resources/browse/browse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.js","sourceRoot":"","sources":["../../src/resources/browse/browse.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,uEAA8C;AAC9C,gDAQsB;AAItB,MAAa,MAAO,SAAQ,sBAAW;IAAvC;;QACE,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyBpF,CAAC;IAvBC;;;;;OAKG;IACH,oBAAoB,CAClB,QAA6D,EAAE,EAC/D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;OAGG;IACH,cAAc,CACZ,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AA1BD,wBA0BC;AA0KD,MAAM,CAAC,UAAU,GAAG,uBAAU,CAAC"}

package/resources/browse/browse.mjs

@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as CategoriesAPI from "./categories.mjs";
+import { Categories, } from "./categories.mjs";
+export class Browse extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.categories = new CategoriesAPI.Categories(this._client);
+    }
+    /**
+     * Get a list of Spotify featured playlists (shown, for example, on a Spotify
+     * player's 'Browse' tab).
+     *
+     * @deprecated
+     */
+    getFeaturedPlaylists(query = {}, options) {
+        return this._client.get('/browse/featured-playlists', { query, ...options });
+    }
+    /**
+     * Get a list of new album releases featured in Spotify (shown, for example, on a
+     * Spotify player’s “Browse” tab).
+     */
+    getNewReleases(query = {}, options) {
+        return this._client.get('/browse/new-releases', { query, ...options });
+    }
+}
+Browse.Categories = Categories;
+//# sourceMappingURL=browse.mjs.map

package/resources/browse/browse.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.mjs","sourceRoot":"","sources":["../../src/resources/browse/browse.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,aAAa;OAClB,EACL,UAAU,GAOX;AAID,MAAM,OAAO,MAAO,SAAQ,WAAW;IAAvC;;QACE,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyBpF,CAAC;IAvBC;;;;;OAKG;IACH,oBAAoB,CAClB,QAA6D,EAAE,EAC/D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;OAGG;IACH,cAAc,CACZ,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AA0KD,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC"}

package/resources/browse/categories.d.mts

@@ -0,0 +1,151 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as Shared from "../shared.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Categories extends APIResource {
+    /**
+     * Get a single category used to tag items in Spotify (on, for example, the Spotify
+     * player’s “Browse” tab).
+     */
+    retrieve(categoryID: string, query?: CategoryRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CategoryRetrieveResponse>;
+    /**
+     * Get a list of categories used to tag items in Spotify (on, for example, the
+     * Spotify player’s “Browse” tab).
+     */
+    list(query?: CategoryListParams | null | undefined, options?: RequestOptions): APIPromise<CategoryListResponse>;
+    /**
+     * Get a list of Spotify playlists tagged with a particular category.
+     *
+     * @deprecated
+     */
+    getPlaylists(categoryID: string, query?: CategoryGetPlaylistsParams | null | undefined, options?: RequestOptions): APIPromise<CategoryGetPlaylistsResponse>;
+}
+export interface CategoryRetrieveResponse {
+    /**
+     * The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+     * the category.
+     */
+    id: string;
+    /**
+     * A link to the Web API endpoint returning full details of the category.
+     */
+    href: string;
+    /**
+     * The category icon, in various sizes.
+     */
+    icons: Array<Shared.ImageObject>;
+    /**
+     * The name of the category.
+     */
+    name: string;
+}
+export interface CategoryListResponse {
+    categories: CategoryListResponse.Categories;
+}
+export declare namespace CategoryListResponse {
+    interface Categories {
+        /**
+         * A link to the Web API endpoint returning the full result of the request
+         */
+        href: string;
+        items: Array<Categories.Item>;
+        /**
+         * The maximum number of items in the response (as set in the query or by default).
+         */
+        limit: number;
+        /**
+         * URL to the next page of items. ( `null` if none)
+         */
+        next: string | null;
+        /**
+         * The offset of the items returned (as set in the query or by default)
+         */
+        offset: number;
+        /**
+         * URL to the previous page of items. ( `null` if none)
+         */
+        previous: string | null;
+        /**
+         * The total number of items available to return.
+         */
+        total: number;
+    }
+    namespace Categories {
+        interface Item {
+            /**
+             * The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+             * the category.
+             */
+            id: string;
+            /**
+             * A link to the Web API endpoint returning full details of the category.
+             */
+            href: string;
+            /**
+             * The category icon, in various sizes.
+             */
+            icons: Array<Shared.ImageObject>;
+            /**
+             * The name of the category.
+             */
+            name: string;
+        }
+    }
+}
+export interface CategoryGetPlaylistsResponse {
+    /**
+     * The localized message of a playlist.
+     */
+    message?: string;
+    playlists?: Shared.PagingPlaylistObject;
+}
+export interface CategoryRetrieveParams {
+    /**
+     * The desired language, consisting of an
+     * [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+     * [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+     * joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+     * (Mexico)&quot;. Provide this parameter if you want the category strings returned
+     * in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+     * specified language is not available, the category strings returned will be in
+     * the Spotify default language (American English)._
+     */
+    locale?: string;
+}
+export interface CategoryListParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The desired language, consisting of an
+     * [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+     * [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+     * joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+     * (Mexico)&quot;. Provide this parameter if you want the category strings returned
+     * in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+     * specified language is not available, the category strings returned will be in
+     * the Spotify default language (American English)._
+     */
+    locale?: string;
+    /**
+     * The index of the first item to return. Default: 0 (the first item). Use with
+     * limit to get the next set of items.
+     */
+    offset?: number;
+}
+export interface CategoryGetPlaylistsParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The index of the first item to return. Default: 0 (the first item). Use with
+     * limit to get the next set of items.
+     */
+    offset?: number;
+}
+export declare namespace Categories {
+    export { type CategoryRetrieveResponse as CategoryRetrieveResponse, type CategoryListResponse as CategoryListResponse, type CategoryGetPlaylistsResponse as CategoryGetPlaylistsResponse, type CategoryRetrieveParams as CategoryRetrieveParams, type CategoryListParams as CategoryListParams, type CategoryGetPlaylistsParams as CategoryGetPlaylistsParams, };
+}
+//# sourceMappingURL=categories.d.mts.map

package/resources/browse/categories.d.mts.map

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

package/resources/browse/categories.d.ts

@@ -0,0 +1,151 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Categories extends APIResource {
+    /**
+     * Get a single category used to tag items in Spotify (on, for example, the Spotify
+     * player’s “Browse” tab).
+     */
+    retrieve(categoryID: string, query?: CategoryRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CategoryRetrieveResponse>;
+    /**
+     * Get a list of categories used to tag items in Spotify (on, for example, the
+     * Spotify player’s “Browse” tab).
+     */
+    list(query?: CategoryListParams | null | undefined, options?: RequestOptions): APIPromise<CategoryListResponse>;
+    /**
+     * Get a list of Spotify playlists tagged with a particular category.
+     *
+     * @deprecated
+     */
+    getPlaylists(categoryID: string, query?: CategoryGetPlaylistsParams | null | undefined, options?: RequestOptions): APIPromise<CategoryGetPlaylistsResponse>;
+}
+export interface CategoryRetrieveResponse {
+    /**
+     * The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+     * the category.
+     */
+    id: string;
+    /**
+     * A link to the Web API endpoint returning full details of the category.
+     */
+    href: string;
+    /**
+     * The category icon, in various sizes.
+     */
+    icons: Array<Shared.ImageObject>;
+    /**
+     * The name of the category.
+     */
+    name: string;
+}
+export interface CategoryListResponse {
+    categories: CategoryListResponse.Categories;
+}
+export declare namespace CategoryListResponse {
+    interface Categories {
+        /**
+         * A link to the Web API endpoint returning the full result of the request
+         */
+        href: string;
+        items: Array<Categories.Item>;
+        /**
+         * The maximum number of items in the response (as set in the query or by default).
+         */
+        limit: number;
+        /**
+         * URL to the next page of items. ( `null` if none)
+         */
+        next: string | null;
+        /**
+         * The offset of the items returned (as set in the query or by default)
+         */
+        offset: number;
+        /**
+         * URL to the previous page of items. ( `null` if none)
+         */
+        previous: string | null;
+        /**
+         * The total number of items available to return.
+         */
+        total: number;
+    }
+    namespace Categories {
+        interface Item {
+            /**
+             * The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of
+             * the category.
+             */
+            id: string;
+            /**
+             * A link to the Web API endpoint returning full details of the category.
+             */
+            href: string;
+            /**
+             * The category icon, in various sizes.
+             */
+            icons: Array<Shared.ImageObject>;
+            /**
+             * The name of the category.
+             */
+            name: string;
+        }
+    }
+}
+export interface CategoryGetPlaylistsResponse {
+    /**
+     * The localized message of a playlist.
+     */
+    message?: string;
+    playlists?: Shared.PagingPlaylistObject;
+}
+export interface CategoryRetrieveParams {
+    /**
+     * The desired language, consisting of an
+     * [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+     * [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+     * joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+     * (Mexico)&quot;. Provide this parameter if you want the category strings returned
+     * in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+     * specified language is not available, the category strings returned will be in
+     * the Spotify default language (American English)._
+     */
+    locale?: string;
+}
+export interface CategoryListParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The desired language, consisting of an
+     * [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an
+     * [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
+     * joined by an underscore. For example: `es_MX`, meaning &quot;Spanish
+     * (Mexico)&quot;. Provide this parameter if you want the category strings returned
+     * in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the
+     * specified language is not available, the category strings returned will be in
+     * the Spotify default language (American English)._
+     */
+    locale?: string;
+    /**
+     * The index of the first item to return. Default: 0 (the first item). Use with
+     * limit to get the next set of items.
+     */
+    offset?: number;
+}
+export interface CategoryGetPlaylistsParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The index of the first item to return. Default: 0 (the first item). Use with
+     * limit to get the next set of items.
+     */
+    offset?: number;
+}
+export declare namespace Categories {
+    export { type CategoryRetrieveResponse as CategoryRetrieveResponse, type CategoryListResponse as CategoryListResponse, type CategoryGetPlaylistsResponse as CategoryGetPlaylistsResponse, type CategoryRetrieveParams as CategoryRetrieveParams, type CategoryListParams as CategoryListParams, type CategoryGetPlaylistsParams as CategoryGetPlaylistsParams, };
+}
+//# sourceMappingURL=categories.d.ts.map

package/resources/browse/categories.d.ts.map

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

package/resources/browse/categories.js

@@ -0,0 +1,32 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Categories = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+class Categories extends resource_1.APIResource {
+    /**
+     * Get a single category used to tag items in Spotify (on, for example, the Spotify
+     * player’s “Browse” tab).
+     */
+    retrieve(categoryID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/browse/categories/${categoryID}`, { query, ...options });
+    }
+    /**
+     * Get a list of categories used to tag items in Spotify (on, for example, the
+     * Spotify player’s “Browse” tab).
+     */
+    list(query = {}, options) {
+        return this._client.get('/browse/categories', { query, ...options });
+    }
+    /**
+     * Get a list of Spotify playlists tagged with a particular category.
+     *
+     * @deprecated
+     */
+    getPlaylists(categoryID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/browse/categories/${categoryID}/playlists`, { query, ...options });
+    }
+}
+exports.Categories = Categories;
+//# sourceMappingURL=categories.js.map

package/resources/browse/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/resources/browse/categories.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,uDAAiD;AAEjD,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;OAGG;IACH,QAAQ,CACN,UAAkB,EAClB,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,sBAAsB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,UAAkB,EAClB,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,sBAAsB,UAAU,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;CACF;AApCD,gCAoCC"}

package/resources/browse/categories.mjs

@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Categories extends APIResource {
+    /**
+     * Get a single category used to tag items in Spotify (on, for example, the Spotify
+     * player’s “Browse” tab).
+     */
+    retrieve(categoryID, query = {}, options) {
+        return this._client.get(path `/browse/categories/${categoryID}`, { query, ...options });
+    }
+    /**
+     * Get a list of categories used to tag items in Spotify (on, for example, the
+     * Spotify player’s “Browse” tab).
+     */
+    list(query = {}, options) {
+        return this._client.get('/browse/categories', { query, ...options });
+    }
+    /**
+     * Get a list of Spotify playlists tagged with a particular category.
+     *
+     * @deprecated
+     */
+    getPlaylists(categoryID, query = {}, options) {
+        return this._client.get(path `/browse/categories/${categoryID}/playlists`, { query, ...options });
+    }
+}
+//# sourceMappingURL=categories.mjs.map

package/resources/browse/categories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.mjs","sourceRoot":"","sources":["../../src/resources/browse/categories.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;OAGG;IACH,QAAQ,CACN,UAAkB,EAClB,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,sBAAsB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,UAAkB,EAClB,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,sBAAsB,UAAU,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;CACF"}

package/resources/browse/index.d.mts

@@ -0,0 +1,3 @@
+export { Browse, type BrowseGetFeaturedPlaylistsResponse, type BrowseGetNewReleasesResponse, type BrowseGetFeaturedPlaylistsParams, type BrowseGetNewReleasesParams, } from "./browse.mjs";
+export { Categories, type CategoryRetrieveResponse, type CategoryListResponse, type CategoryGetPlaylistsResponse, type CategoryRetrieveParams, type CategoryListParams, type CategoryGetPlaylistsParams, } from "./categories.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/browse/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/browse/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,kCAAkC,EACvC,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,GAChC;OACM,EACL,UAAU,EACV,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC"}

package/resources/browse/index.d.ts

@@ -0,0 +1,3 @@
+export { Browse, type BrowseGetFeaturedPlaylistsResponse, type BrowseGetNewReleasesResponse, type BrowseGetFeaturedPlaylistsParams, type BrowseGetNewReleasesParams, } from "./browse.js";
+export { Categories, type CategoryRetrieveResponse, type CategoryListResponse, type CategoryGetPlaylistsResponse, type CategoryRetrieveParams, type CategoryListParams, type CategoryGetPlaylistsParams, } from "./categories.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/browse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/browse/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,kCAAkC,EACvC,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,GAChC;OACM,EACL,UAAU,EACV,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC"}

package/resources/browse/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Categories = exports.Browse = void 0;
+var browse_1 = require("./browse.js");
+Object.defineProperty(exports, "Browse", { enumerable: true, get: function () { return browse_1.Browse; } });
+var categories_1 = require("./categories.js");
+Object.defineProperty(exports, "Categories", { enumerable: true, get: function () { return categories_1.Categories; } });
+//# sourceMappingURL=index.js.map

package/resources/browse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/browse/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAMkB;AALhB,gGAAA,MAAM,OAAA;AAMR,8CAQsB;AAPpB,wGAAA,UAAU,OAAA"}