spotted-ts 0.1.0

package/resources/me/top.d.mts

@@ -0,0 +1,72 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as Shared from "../shared.mjs";
+import { ArtistObjectsCursorURLPage, TrackObjectsCursorURLPage } from "../shared.mjs";
+import { PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Top extends APIResource {
+    /**
+     * Get the current user's top artists based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const artistObject of client.me.top.listTopArtists()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopArtists(query?: TopListTopArtistsParams | null | undefined, options?: RequestOptions): PagePromise<ArtistObjectsCursorURLPage, Shared.ArtistObject>;
+    /**
+     * Get the current user's top tracks based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackObject of client.me.top.listTopTracks()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopTracks(query?: TopListTopTracksParams | null | undefined, options?: RequestOptions): PagePromise<TrackObjectsCursorURLPage, Shared.TrackObject>;
+}
+export interface TopListTopArtistsParams {
+    /**
+     * 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;
+    /**
+     * Over what time frame the affinities are computed. Valid values: `long_term`
+     * (calculated from ~1 year of data and including all new data as it becomes
+     * available), `medium_term` (approximately last 6 months), `short_term`
+     * (approximately last 4 weeks). Default: `medium_term`
+     */
+    time_range?: string;
+}
+export interface TopListTopTracksParams {
+    /**
+     * 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;
+    /**
+     * Over what time frame the affinities are computed. Valid values: `long_term`
+     * (calculated from ~1 year of data and including all new data as it becomes
+     * available), `medium_term` (approximately last 6 months), `short_term`
+     * (approximately last 4 weeks). Default: `medium_term`
+     */
+    time_range?: string;
+}
+export declare namespace Top {
+    export { type TopListTopArtistsParams as TopListTopArtistsParams, type TopListTopTracksParams as TopListTopTracksParams, };
+}
+export { type ArtistObjectsCursorURLPage, type TrackObjectsCursorURLPage };
+//# sourceMappingURL=top.d.mts.map

package/resources/me/top.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"top.d.mts","sourceRoot":"","sources":["../../src/resources/me/top.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,0BAA0B,EAAE,yBAAyB,EAAE;OACzD,EAAiB,WAAW,EAAE;OAC9B,EAAE,cAAc,EAAE;AAEzB,qBAAa,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;OAUG;IACH,cAAc,CACZ,KAAK,GAAE,uBAAuB,GAAG,IAAI,GAAG,SAAc,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,0BAA0B,EAAE,MAAM,CAAC,YAAY,CAAC;IAO/D;;;;;;;;;;OAUG;IACH,aAAa,CACX,KAAK,GAAE,sBAAsB,GAAG,IAAI,GAAG,SAAc,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,yBAAyB,EAAE,MAAM,CAAC,WAAW,CAAC;CAM9D;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH;AAED,OAAO,EAAE,KAAK,0BAA0B,EAAE,KAAK,yBAAyB,EAAE,CAAC"}

package/resources/me/top.d.ts

@@ -0,0 +1,72 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import { ArtistObjectsCursorURLPage, TrackObjectsCursorURLPage } from "../shared.js";
+import { PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Top extends APIResource {
+    /**
+     * Get the current user's top artists based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const artistObject of client.me.top.listTopArtists()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopArtists(query?: TopListTopArtistsParams | null | undefined, options?: RequestOptions): PagePromise<ArtistObjectsCursorURLPage, Shared.ArtistObject>;
+    /**
+     * Get the current user's top tracks based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackObject of client.me.top.listTopTracks()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopTracks(query?: TopListTopTracksParams | null | undefined, options?: RequestOptions): PagePromise<TrackObjectsCursorURLPage, Shared.TrackObject>;
+}
+export interface TopListTopArtistsParams {
+    /**
+     * 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;
+    /**
+     * Over what time frame the affinities are computed. Valid values: `long_term`
+     * (calculated from ~1 year of data and including all new data as it becomes
+     * available), `medium_term` (approximately last 6 months), `short_term`
+     * (approximately last 4 weeks). Default: `medium_term`
+     */
+    time_range?: string;
+}
+export interface TopListTopTracksParams {
+    /**
+     * 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;
+    /**
+     * Over what time frame the affinities are computed. Valid values: `long_term`
+     * (calculated from ~1 year of data and including all new data as it becomes
+     * available), `medium_term` (approximately last 6 months), `short_term`
+     * (approximately last 4 weeks). Default: `medium_term`
+     */
+    time_range?: string;
+}
+export declare namespace Top {
+    export { type TopListTopArtistsParams as TopListTopArtistsParams, type TopListTopTracksParams as TopListTopTracksParams, };
+}
+export { type ArtistObjectsCursorURLPage, type TrackObjectsCursorURLPage };
+//# sourceMappingURL=top.d.ts.map

package/resources/me/top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"top.d.ts","sourceRoot":"","sources":["../../src/resources/me/top.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,0BAA0B,EAAE,yBAAyB,EAAE;OACzD,EAAiB,WAAW,EAAE;OAC9B,EAAE,cAAc,EAAE;AAEzB,qBAAa,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;OAUG;IACH,cAAc,CACZ,KAAK,GAAE,uBAAuB,GAAG,IAAI,GAAG,SAAc,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,0BAA0B,EAAE,MAAM,CAAC,YAAY,CAAC;IAO/D;;;;;;;;;;OAUG;IACH,aAAa,CACX,KAAK,GAAE,sBAAsB,GAAG,IAAI,GAAG,SAAc,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,yBAAyB,EAAE,MAAM,CAAC,WAAW,CAAC;CAM9D;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH;AAED,OAAO,EAAE,KAAK,0BAA0B,EAAE,KAAK,yBAAyB,EAAE,CAAC"}

package/resources/me/top.js

@@ -0,0 +1,44 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Top = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+class Top extends resource_1.APIResource {
+    /**
+     * Get the current user's top artists based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const artistObject of client.me.top.listTopArtists()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopArtists(query = {}, options) {
+        return this._client.getAPIList('/me/top/artists', (pagination_1.CursorURLPage), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Get the current user's top tracks based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackObject of client.me.top.listTopTracks()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopTracks(query = {}, options) {
+        return this._client.getAPIList('/me/top/tracks', (pagination_1.CursorURLPage), {
+            query,
+            ...options,
+        });
+    }
+}
+exports.Top = Top;
+//# sourceMappingURL=top.js.map

package/resources/me/top.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"top.js","sourceRoot":"","sources":["../../src/resources/me/top.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,yDAAmE;AAGnE,MAAa,GAAI,SAAQ,sBAAW;IAClC;;;;;;;;;;OAUG;IACH,cAAc,CACZ,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAA,0BAAkC,CAAA,EAAE;YACpF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CACX,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA,0BAAiC,CAAA,EAAE;YAClF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AA1CD,kBA0CC"}

package/resources/me/top.mjs

@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { CursorURLPage } from "../../core/pagination.mjs";
+export class Top extends APIResource {
+    /**
+     * Get the current user's top artists based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const artistObject of client.me.top.listTopArtists()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopArtists(query = {}, options) {
+        return this._client.getAPIList('/me/top/artists', (CursorURLPage), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Get the current user's top tracks based on calculated affinity.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackObject of client.me.top.listTopTracks()) {
+     *   // ...
+     * }
+     * ```
+     */
+    listTopTracks(query = {}, options) {
+        return this._client.getAPIList('/me/top/tracks', (CursorURLPage), {
+            query,
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=top.mjs.map

package/resources/me/top.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"top.mjs","sourceRoot":"","sources":["../../src/resources/me/top.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,aAAa,EAAe;AAGrC,MAAM,OAAO,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;OAUG;IACH,cAAc,CACZ,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAA,aAAkC,CAAA,EAAE;YACpF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CACX,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA,aAAiC,CAAA,EAAE;YAClF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/me/tracks.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 { CursorURLPage, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Tracks extends APIResource {
+    /**
+     * Get a list of the songs saved in the current Spotify user's 'Your Music'
+     * library.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackListResponse of client.me.tracks.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: TrackListParams | null | undefined, options?: RequestOptions): PagePromise<TrackListResponsesCursorURLPage, TrackListResponse>;
+    /**
+     * Check if one or more tracks is already saved in the current Spotify user's 'Your
+     * Music' library.
+     *
+     * @example
+     * ```ts
+     * const response = await client.me.tracks.check({
+     *   ids: '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B',
+     * });
+     * ```
+     */
+    check(query: TrackCheckParams, options?: RequestOptions): APIPromise<TrackCheckResponse>;
+    /**
+     * Remove one or more tracks from the current user's 'Your Music' library.
+     *
+     * @example
+     * ```ts
+     * await client.me.tracks.remove();
+     * ```
+     */
+    remove(body?: TrackRemoveParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Save one or more tracks to the current user's 'Your Music' library.
+     *
+     * @example
+     * ```ts
+     * await client.me.tracks.save({ ids: ['string'] });
+     * ```
+     */
+    save(body: TrackSaveParams, options?: RequestOptions): APIPromise<void>;
+}
+export type TrackListResponsesCursorURLPage = CursorURLPage<TrackListResponse>;
+export interface TrackListResponse {
+    /**
+     * The date and time the track was saved. Timestamps are returned in ISO 8601
+     * format as Coordinated Universal Time (UTC) with a zero offset:
+     * YYYY-MM-DDTHH:MM:SSZ. If the time is imprecise (for example, the date/time of an
+     * album release), an additional field indicates the precision; see for example,
+     * release_date in an album object.
+     */
+    added_at?: string;
+    /**
+     * Information about the track.
+     */
+    track?: Shared.TrackObject;
+}
+export type TrackCheckResponse = Array<boolean>;
+export interface TrackListParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * An
+     * [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+     * If a country code is specified, only content that is available in that market
+     * will be returned.<br/> If a valid user access token is specified in the request
+     * header, the country associated with the user account will take priority over
+     * this parameter.<br/> _**Note**: If neither market or user country are provided,
+     * the content is considered unavailable for the client._<br/> Users can view the
+     * country that is associated with their account in the
+     * [account settings](https://www.spotify.com/account/overview/).
+     */
+    market?: 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 TrackCheckParams {
+    /**
+     * A comma-separated list of the
+     * [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+     * `ids=4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M`. Maximum: 50 IDs.
+     */
+    ids: string;
+}
+export interface TrackRemoveParams {
+    /**
+     * A JSON array of the
+     * [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+     * `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+     * can be specified in one request. _**Note**: if the `ids` parameter is present in
+     * the query string, any IDs listed here in the body will be ignored._
+     */
+    ids?: Array<string>;
+    [k: string]: unknown;
+}
+export interface TrackSaveParams {
+    /**
+     * A JSON array of the
+     * [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+     * `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+     * can be specified in one request. _**Note**: if the `timestamped_ids` is present
+     * in the body, any IDs listed in the query parameters (deprecated) or the `ids`
+     * field in the body will be ignored._
+     */
+    ids: Array<string>;
+    /**
+     * A JSON array of objects containing track IDs with their corresponding
+     * timestamps. Each object must include a track ID and an `added_at` timestamp.
+     * This allows you to specify when tracks were added to maintain a specific
+     * chronological order in the user's library.<br/>A maximum of 50 items can be
+     * specified in one request. _**Note**: if the `timestamped_ids` is present in the
+     * body, any IDs listed in the query parameters (deprecated) or the `ids` field in
+     * the body will be ignored._
+     */
+    timestamped_ids?: Array<TrackSaveParams.TimestampedID>;
+    [k: string]: unknown;
+}
+export declare namespace TrackSaveParams {
+    interface TimestampedID {
+        /**
+         * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+         * track.
+         */
+        id: string;
+        /**
+         * The timestamp when the track was added to the library. Use ISO 8601 format with
+         * UTC timezone (e.g., `2023-01-15T14:30:00Z`). You can specify past timestamps to
+         * insert tracks at specific positions in the library's chronological order. The
+         * API uses minute-level granularity for ordering, though the timestamp supports
+         * millisecond precision.
+         */
+        added_at: string;
+    }
+}
+export declare namespace Tracks {
+    export { type TrackListResponse as TrackListResponse, type TrackCheckResponse as TrackCheckResponse, type TrackListResponsesCursorURLPage as TrackListResponsesCursorURLPage, type TrackListParams as TrackListParams, type TrackCheckParams as TrackCheckParams, type TrackRemoveParams as TrackRemoveParams, type TrackSaveParams as TrackSaveParams, };
+}
+//# sourceMappingURL=tracks.d.mts.map

package/resources/me/tracks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracks.d.mts","sourceRoot":"","sources":["../../src/resources/me/tracks.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,WAAW,EAAE;OAE9B,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,+BAA+B,EAAE,iBAAiB,CAAC;IAIlE;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIxF;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQnG;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOxE;AAED,MAAM,MAAM,+BAA+B,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEpB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAEvD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,yBAAiB,eAAe,CAAC;IAC/B,UAAiB,aAAa;QAC5B;;;WAGG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;;;;WAMG;QACH,QAAQ,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/me/tracks.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 { CursorURLPage, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Tracks extends APIResource {
+    /**
+     * Get a list of the songs saved in the current Spotify user's 'Your Music'
+     * library.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackListResponse of client.me.tracks.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: TrackListParams | null | undefined, options?: RequestOptions): PagePromise<TrackListResponsesCursorURLPage, TrackListResponse>;
+    /**
+     * Check if one or more tracks is already saved in the current Spotify user's 'Your
+     * Music' library.
+     *
+     * @example
+     * ```ts
+     * const response = await client.me.tracks.check({
+     *   ids: '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B',
+     * });
+     * ```
+     */
+    check(query: TrackCheckParams, options?: RequestOptions): APIPromise<TrackCheckResponse>;
+    /**
+     * Remove one or more tracks from the current user's 'Your Music' library.
+     *
+     * @example
+     * ```ts
+     * await client.me.tracks.remove();
+     * ```
+     */
+    remove(body?: TrackRemoveParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Save one or more tracks to the current user's 'Your Music' library.
+     *
+     * @example
+     * ```ts
+     * await client.me.tracks.save({ ids: ['string'] });
+     * ```
+     */
+    save(body: TrackSaveParams, options?: RequestOptions): APIPromise<void>;
+}
+export type TrackListResponsesCursorURLPage = CursorURLPage<TrackListResponse>;
+export interface TrackListResponse {
+    /**
+     * The date and time the track was saved. Timestamps are returned in ISO 8601
+     * format as Coordinated Universal Time (UTC) with a zero offset:
+     * YYYY-MM-DDTHH:MM:SSZ. If the time is imprecise (for example, the date/time of an
+     * album release), an additional field indicates the precision; see for example,
+     * release_date in an album object.
+     */
+    added_at?: string;
+    /**
+     * Information about the track.
+     */
+    track?: Shared.TrackObject;
+}
+export type TrackCheckResponse = Array<boolean>;
+export interface TrackListParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * An
+     * [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+     * If a country code is specified, only content that is available in that market
+     * will be returned.<br/> If a valid user access token is specified in the request
+     * header, the country associated with the user account will take priority over
+     * this parameter.<br/> _**Note**: If neither market or user country are provided,
+     * the content is considered unavailable for the client._<br/> Users can view the
+     * country that is associated with their account in the
+     * [account settings](https://www.spotify.com/account/overview/).
+     */
+    market?: 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 TrackCheckParams {
+    /**
+     * A comma-separated list of the
+     * [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+     * `ids=4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M`. Maximum: 50 IDs.
+     */
+    ids: string;
+}
+export interface TrackRemoveParams {
+    /**
+     * A JSON array of the
+     * [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+     * `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+     * can be specified in one request. _**Note**: if the `ids` parameter is present in
+     * the query string, any IDs listed here in the body will be ignored._
+     */
+    ids?: Array<string>;
+    [k: string]: unknown;
+}
+export interface TrackSaveParams {
+    /**
+     * A JSON array of the
+     * [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example:
+     * `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items
+     * can be specified in one request. _**Note**: if the `timestamped_ids` is present
+     * in the body, any IDs listed in the query parameters (deprecated) or the `ids`
+     * field in the body will be ignored._
+     */
+    ids: Array<string>;
+    /**
+     * A JSON array of objects containing track IDs with their corresponding
+     * timestamps. Each object must include a track ID and an `added_at` timestamp.
+     * This allows you to specify when tracks were added to maintain a specific
+     * chronological order in the user's library.<br/>A maximum of 50 items can be
+     * specified in one request. _**Note**: if the `timestamped_ids` is present in the
+     * body, any IDs listed in the query parameters (deprecated) or the `ids` field in
+     * the body will be ignored._
+     */
+    timestamped_ids?: Array<TrackSaveParams.TimestampedID>;
+    [k: string]: unknown;
+}
+export declare namespace TrackSaveParams {
+    interface TimestampedID {
+        /**
+         * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+         * track.
+         */
+        id: string;
+        /**
+         * The timestamp when the track was added to the library. Use ISO 8601 format with
+         * UTC timezone (e.g., `2023-01-15T14:30:00Z`). You can specify past timestamps to
+         * insert tracks at specific positions in the library's chronological order. The
+         * API uses minute-level granularity for ordering, though the timestamp supports
+         * millisecond precision.
+         */
+        added_at: string;
+    }
+}
+export declare namespace Tracks {
+    export { type TrackListResponse as TrackListResponse, type TrackCheckResponse as TrackCheckResponse, type TrackListResponsesCursorURLPage as TrackListResponsesCursorURLPage, type TrackListParams as TrackListParams, type TrackCheckParams as TrackCheckParams, type TrackRemoveParams as TrackRemoveParams, type TrackSaveParams as TrackSaveParams, };
+}
+//# sourceMappingURL=tracks.d.ts.map

package/resources/me/tracks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracks.d.ts","sourceRoot":"","sources":["../../src/resources/me/tracks.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,WAAW,EAAE;OAE9B,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,+BAA+B,EAAE,iBAAiB,CAAC;IAIlE;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAIxF;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQnG;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOxE;AAED,MAAM,MAAM,+BAA+B,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEpB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAEvD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,yBAAiB,eAAe,CAAC;IAC/B,UAAiB,aAAa;QAC5B;;;WAGG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;;;;WAMG;QACH,QAAQ,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/me/tracks.js

@@ -0,0 +1,70 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracks = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const headers_1 = require("../../internal/headers.js");
+class Tracks extends resource_1.APIResource {
+    /**
+     * Get a list of the songs saved in the current Spotify user's 'Your Music'
+     * library.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const trackListResponse of client.me.tracks.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/me/tracks', (pagination_1.CursorURLPage), { query, ...options });
+    }
+    /**
+     * Check if one or more tracks is already saved in the current Spotify user's 'Your
+     * Music' library.
+     *
+     * @example
+     * ```ts
+     * const response = await client.me.tracks.check({
+     *   ids: '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B',
+     * });
+     * ```
+     */
+    check(query, options) {
+        return this._client.get('/me/tracks/contains', { query, ...options });
+    }
+    /**
+     * Remove one or more tracks from the current user's 'Your Music' library.
+     *
+     * @example
+     * ```ts
+     * await client.me.tracks.remove();
+     * ```
+     */
+    remove(body = {}, options) {
+        return this._client.delete('/me/tracks', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Save one or more tracks to the current user's 'Your Music' library.
+     *
+     * @example
+     * ```ts
+     * await client.me.tracks.save({ ids: ['string'] });
+     * ```
+     */
+    save(body, options) {
+        return this._client.put('/me/tracks', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Tracks = Tracks;
+//# sourceMappingURL=tracks.js.map

package/resources/me/tracks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracks.js","sourceRoot":"","sources":["../../src/resources/me/tracks.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,yDAAmE;AACnE,uDAAsD;AAGtD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,0BAAgC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAuB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAA6C,EAAE,EAAE,OAAwB;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE;YACvC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,IAAqB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAlED,wBAkEC"}