spotted-ts 0.1.0

package/resources/users/playlists.d.mts

@@ -0,0 +1,194 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as Shared from "../shared.mjs";
+import { SimplifiedPlaylistObjectsCursorURLPage } from "../shared.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Playlists extends APIResource {
+    /**
+     * Create a playlist for a Spotify user. (The playlist will be empty until you
+     * [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
+     * user is generally limited to a maximum of 11000 playlists.
+     *
+     * @example
+     * ```ts
+     * const playlist = await client.users.playlists.create(
+     *   'smedjan',
+     *   { name: 'New Playlist' },
+     * );
+     * ```
+     */
+    create(userID: string, body: PlaylistCreateParams, options?: RequestOptions): APIPromise<PlaylistCreateResponse>;
+    /**
+     * Get a list of the playlists owned or followed by a Spotify user.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const simplifiedPlaylistObject of client.users.playlists.list(
+     *   'smedjan',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID: string, query?: PlaylistListParams | null | undefined, options?: RequestOptions): PagePromise<SimplifiedPlaylistObjectsCursorURLPage, Shared.SimplifiedPlaylistObject>;
+}
+export interface PlaylistCreateResponse {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * playlist.
+     */
+    id?: string;
+    /**
+     * `true` if the owner allows other users to modify the playlist.
+     */
+    collaborative?: boolean;
+    /**
+     * The playlist description. _Only returned for modified, verified playlists,
+     * otherwise_ `null`.
+     */
+    description?: string | null;
+    /**
+     * Known external URLs for this playlist.
+     */
+    external_urls?: Shared.ExternalURLObject;
+    /**
+     * Information about the followers of the playlist.
+     */
+    followers?: Shared.FollowersObject;
+    /**
+     * A link to the Web API endpoint providing full details of the playlist.
+     */
+    href?: string;
+    /**
+     * Images for the playlist. The array may be empty or contain up to three images.
+     * The images are returned by size in descending order. See
+     * [Working with Playlists](/documentation/web-api/concepts/playlists). _**Note**:
+     * If returned, the source URL for the image (`url`) is temporary and will expire
+     * in less than a day._
+     */
+    images?: Array<Shared.ImageObject>;
+    /**
+     * The name of the playlist.
+     */
+    name?: string;
+    /**
+     * The user who owns the playlist
+     */
+    owner?: PlaylistCreateResponse.Owner;
+    /**
+     * The playlist's public/private status (if it is added to the user's profile):
+     * `true` the playlist is public, `false` the playlist is private, `null` the
+     * playlist status is not relevant. For more about public/private status, see
+     * [Working with Playlists](/documentation/web-api/concepts/playlists)
+     */
+    public?: boolean;
+    /**
+     * The version identifier for the current playlist. Can be supplied in other
+     * requests to target a specific playlist version
+     */
+    snapshot_id?: string;
+    /**
+     * The tracks of the playlist.
+     */
+    tracks?: PlaylistCreateResponse.Tracks;
+    /**
+     * The object type: "playlist"
+     */
+    type?: string;
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * playlist.
+     */
+    uri?: string;
+}
+export declare namespace PlaylistCreateResponse {
+    /**
+     * The user who owns the playlist
+     */
+    interface Owner extends Shared.PlaylistUserObject {
+        /**
+         * The name displayed on the user's profile. `null` if not available.
+         */
+        display_name?: string | null;
+    }
+    /**
+     * The tracks of the playlist.
+     */
+    interface Tracks {
+        /**
+         * A link to the Web API endpoint returning the full result of the request
+         */
+        href: string;
+        items: Array<Shared.PlaylistTrackObject>;
+        /**
+         * 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;
+    }
+}
+export interface PlaylistCreateParams {
+    /**
+     * The name for the new playlist, for example `"Your Coolest Playlist"`. This name
+     * does not need to be unique; a user may have several playlists with the same
+     * name.
+     */
+    name: string;
+    /**
+     * Defaults to `false`. If `true` the playlist will be collaborative. _**Note**: to
+     * create a collaborative playlist you must also set `public` to `false`. To create
+     * collaborative playlists you must have granted `playlist-modify-private` and
+     * `playlist-modify-public`
+     * [scopes](/documentation/web-api/concepts/scopes/#list-of-scopes)._
+     */
+    collaborative?: boolean;
+    /**
+     * value for playlist description as displayed in Spotify Clients and in the Web
+     * API.
+     */
+    description?: string;
+    /**
+     * Defaults to `true`. The playlist's public/private status (if it should be added
+     * to the user's profile or not): `true` the playlist will be public, `false` the
+     * playlist will be private. To be able to create private playlists, the user must
+     * have granted the `playlist-modify-private`
+     * [scope](/documentation/web-api/concepts/scopes/#list-of-scopes). For more about
+     * public/private status, see
+     * [Working with Playlists](/documentation/web-api/concepts/playlists)
+     */
+    public?: boolean;
+    [k: string]: unknown;
+}
+export interface PlaylistListParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The index of the first playlist to return. Default: 0 (the first object).
+     * Maximum offset: 100.000\. Use with `limit` to get the next set of playlists.
+     */
+    offset?: number;
+}
+export declare namespace Playlists {
+    export { type PlaylistCreateResponse as PlaylistCreateResponse, type PlaylistCreateParams as PlaylistCreateParams, type PlaylistListParams as PlaylistListParams, };
+}
+export { type SimplifiedPlaylistObjectsCursorURLPage };
+//# sourceMappingURL=playlists.d.mts.map

package/resources/users/playlists.d.mts.map

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

package/resources/users/playlists.d.ts

@@ -0,0 +1,194 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import { SimplifiedPlaylistObjectsCursorURLPage } from "../shared.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Playlists extends APIResource {
+    /**
+     * Create a playlist for a Spotify user. (The playlist will be empty until you
+     * [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
+     * user is generally limited to a maximum of 11000 playlists.
+     *
+     * @example
+     * ```ts
+     * const playlist = await client.users.playlists.create(
+     *   'smedjan',
+     *   { name: 'New Playlist' },
+     * );
+     * ```
+     */
+    create(userID: string, body: PlaylistCreateParams, options?: RequestOptions): APIPromise<PlaylistCreateResponse>;
+    /**
+     * Get a list of the playlists owned or followed by a Spotify user.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const simplifiedPlaylistObject of client.users.playlists.list(
+     *   'smedjan',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID: string, query?: PlaylistListParams | null | undefined, options?: RequestOptions): PagePromise<SimplifiedPlaylistObjectsCursorURLPage, Shared.SimplifiedPlaylistObject>;
+}
+export interface PlaylistCreateResponse {
+    /**
+     * The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * playlist.
+     */
+    id?: string;
+    /**
+     * `true` if the owner allows other users to modify the playlist.
+     */
+    collaborative?: boolean;
+    /**
+     * The playlist description. _Only returned for modified, verified playlists,
+     * otherwise_ `null`.
+     */
+    description?: string | null;
+    /**
+     * Known external URLs for this playlist.
+     */
+    external_urls?: Shared.ExternalURLObject;
+    /**
+     * Information about the followers of the playlist.
+     */
+    followers?: Shared.FollowersObject;
+    /**
+     * A link to the Web API endpoint providing full details of the playlist.
+     */
+    href?: string;
+    /**
+     * Images for the playlist. The array may be empty or contain up to three images.
+     * The images are returned by size in descending order. See
+     * [Working with Playlists](/documentation/web-api/concepts/playlists). _**Note**:
+     * If returned, the source URL for the image (`url`) is temporary and will expire
+     * in less than a day._
+     */
+    images?: Array<Shared.ImageObject>;
+    /**
+     * The name of the playlist.
+     */
+    name?: string;
+    /**
+     * The user who owns the playlist
+     */
+    owner?: PlaylistCreateResponse.Owner;
+    /**
+     * The playlist's public/private status (if it is added to the user's profile):
+     * `true` the playlist is public, `false` the playlist is private, `null` the
+     * playlist status is not relevant. For more about public/private status, see
+     * [Working with Playlists](/documentation/web-api/concepts/playlists)
+     */
+    public?: boolean;
+    /**
+     * The version identifier for the current playlist. Can be supplied in other
+     * requests to target a specific playlist version
+     */
+    snapshot_id?: string;
+    /**
+     * The tracks of the playlist.
+     */
+    tracks?: PlaylistCreateResponse.Tracks;
+    /**
+     * The object type: "playlist"
+     */
+    type?: string;
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the
+     * playlist.
+     */
+    uri?: string;
+}
+export declare namespace PlaylistCreateResponse {
+    /**
+     * The user who owns the playlist
+     */
+    interface Owner extends Shared.PlaylistUserObject {
+        /**
+         * The name displayed on the user's profile. `null` if not available.
+         */
+        display_name?: string | null;
+    }
+    /**
+     * The tracks of the playlist.
+     */
+    interface Tracks {
+        /**
+         * A link to the Web API endpoint returning the full result of the request
+         */
+        href: string;
+        items: Array<Shared.PlaylistTrackObject>;
+        /**
+         * 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;
+    }
+}
+export interface PlaylistCreateParams {
+    /**
+     * The name for the new playlist, for example `"Your Coolest Playlist"`. This name
+     * does not need to be unique; a user may have several playlists with the same
+     * name.
+     */
+    name: string;
+    /**
+     * Defaults to `false`. If `true` the playlist will be collaborative. _**Note**: to
+     * create a collaborative playlist you must also set `public` to `false`. To create
+     * collaborative playlists you must have granted `playlist-modify-private` and
+     * `playlist-modify-public`
+     * [scopes](/documentation/web-api/concepts/scopes/#list-of-scopes)._
+     */
+    collaborative?: boolean;
+    /**
+     * value for playlist description as displayed in Spotify Clients and in the Web
+     * API.
+     */
+    description?: string;
+    /**
+     * Defaults to `true`. The playlist's public/private status (if it should be added
+     * to the user's profile or not): `true` the playlist will be public, `false` the
+     * playlist will be private. To be able to create private playlists, the user must
+     * have granted the `playlist-modify-private`
+     * [scope](/documentation/web-api/concepts/scopes/#list-of-scopes). For more about
+     * public/private status, see
+     * [Working with Playlists](/documentation/web-api/concepts/playlists)
+     */
+    public?: boolean;
+    [k: string]: unknown;
+}
+export interface PlaylistListParams {
+    /**
+     * The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
+     */
+    limit?: number;
+    /**
+     * The index of the first playlist to return. Default: 0 (the first object).
+     * Maximum offset: 100.000\. Use with `limit` to get the next set of playlists.
+     */
+    offset?: number;
+}
+export declare namespace Playlists {
+    export { type PlaylistCreateResponse as PlaylistCreateResponse, type PlaylistCreateParams as PlaylistCreateParams, type PlaylistListParams as PlaylistListParams, };
+}
+export { type SimplifiedPlaylistObjectsCursorURLPage };
+//# sourceMappingURL=playlists.d.ts.map

package/resources/users/playlists.d.ts.map

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

package/resources/users/playlists.js

@@ -0,0 +1,43 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Playlists = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+class Playlists extends resource_1.APIResource {
+    /**
+     * Create a playlist for a Spotify user. (The playlist will be empty until you
+     * [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
+     * user is generally limited to a maximum of 11000 playlists.
+     *
+     * @example
+     * ```ts
+     * const playlist = await client.users.playlists.create(
+     *   'smedjan',
+     *   { name: 'New Playlist' },
+     * );
+     * ```
+     */
+    create(userID, body, options) {
+        return this._client.post((0, path_1.path) `/users/${userID}/playlists`, { body, ...options });
+    }
+    /**
+     * Get a list of the playlists owned or followed by a Spotify user.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const simplifiedPlaylistObject of client.users.playlists.list(
+     *   'smedjan',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/users/${userID}/playlists`, (pagination_1.CursorURLPage), { query, ...options });
+    }
+}
+exports.Playlists = Playlists;
+//# sourceMappingURL=playlists.js.map

package/resources/users/playlists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlists.js","sourceRoot":"","sources":["../../src/resources/users/playlists.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,yDAAmE;AAEnE,uDAAiD;AAEjD,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,MAAc,EACd,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,UAAU,MAAM,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,MAAc,EACd,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,UAAU,MAAM,YAAY,EAChC,CAAA,0BAA8C,CAAA,EAC9C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;CACF;AA9CD,8BA8CC"}

package/resources/users/playlists.mjs

@@ -0,0 +1,39 @@
+// 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";
+import { path } from "../../internal/utils/path.mjs";
+export class Playlists extends APIResource {
+    /**
+     * Create a playlist for a Spotify user. (The playlist will be empty until you
+     * [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each
+     * user is generally limited to a maximum of 11000 playlists.
+     *
+     * @example
+     * ```ts
+     * const playlist = await client.users.playlists.create(
+     *   'smedjan',
+     *   { name: 'New Playlist' },
+     * );
+     * ```
+     */
+    create(userID, body, options) {
+        return this._client.post(path `/users/${userID}/playlists`, { body, ...options });
+    }
+    /**
+     * Get a list of the playlists owned or followed by a Spotify user.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const simplifiedPlaylistObject of client.users.playlists.list(
+     *   'smedjan',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID, query = {}, options) {
+        return this._client.getAPIList(path `/users/${userID}/playlists`, (CursorURLPage), { query, ...options });
+    }
+}
+//# sourceMappingURL=playlists.mjs.map

package/resources/users/playlists.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlists.mjs","sourceRoot":"","sources":["../../src/resources/users/playlists.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,aAAa,EAAe;OAE9B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,MAAc,EACd,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,UAAU,MAAM,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,MAAc,EACd,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,UAAU,MAAM,YAAY,EAChC,CAAA,aAA8C,CAAA,EAC9C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;CACF"}

package/resources/users/users.d.mts

@@ -0,0 +1,61 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as Shared from "../shared.mjs";
+import * as PlaylistsAPI from "./playlists.mjs";
+import { PlaylistCreateParams, PlaylistCreateResponse, PlaylistListParams, Playlists } from "./playlists.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Users extends APIResource {
+    playlists: PlaylistsAPI.Playlists;
+    /**
+     * Get public profile information about a Spotify user.
+     *
+     * @example
+     * ```ts
+     * const response = await client.users.retrieveProfile(
+     *   'smedjan',
+     * );
+     * ```
+     */
+    retrieveProfile(userID: string, options?: RequestOptions): APIPromise<UserRetrieveProfileResponse>;
+}
+export interface UserRetrieveProfileResponse {
+    /**
+     * The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this
+     * user.
+     */
+    id?: string;
+    /**
+     * The name displayed on the user's profile. `null` if not available.
+     */
+    display_name?: string | null;
+    /**
+     * Known public external URLs for this user.
+     */
+    external_urls?: Shared.ExternalURLObject;
+    /**
+     * Information about the followers of this user.
+     */
+    followers?: Shared.FollowersObject;
+    /**
+     * A link to the Web API endpoint for this user.
+     */
+    href?: string;
+    /**
+     * The user's profile image.
+     */
+    images?: Array<Shared.ImageObject>;
+    /**
+     * The object type.
+     */
+    type?: 'user';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this
+     * user.
+     */
+    uri?: string;
+}
+export declare namespace Users {
+    export { type UserRetrieveProfileResponse as UserRetrieveProfileResponse };
+    export { Playlists as Playlists, type PlaylistCreateResponse as PlaylistCreateResponse, type PlaylistCreateParams as PlaylistCreateParams, type PlaylistListParams as PlaylistListParams, };
+}
+//# sourceMappingURL=users.d.mts.map

package/resources/users/users.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.mts","sourceRoot":"","sources":["../../src/resources/users/users.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,KAAK,YAAY;OACjB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,SAAS,EAAE;OAC/E,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAE7E;;;;;;;;;OASG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,2BAA2B,CAAC;CAGnG;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;IAE3E,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/users/users.d.ts

@@ -0,0 +1,61 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import * as PlaylistsAPI from "./playlists.js";
+import { PlaylistCreateParams, PlaylistCreateResponse, PlaylistListParams, Playlists } from "./playlists.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Users extends APIResource {
+    playlists: PlaylistsAPI.Playlists;
+    /**
+     * Get public profile information about a Spotify user.
+     *
+     * @example
+     * ```ts
+     * const response = await client.users.retrieveProfile(
+     *   'smedjan',
+     * );
+     * ```
+     */
+    retrieveProfile(userID: string, options?: RequestOptions): APIPromise<UserRetrieveProfileResponse>;
+}
+export interface UserRetrieveProfileResponse {
+    /**
+     * The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this
+     * user.
+     */
+    id?: string;
+    /**
+     * The name displayed on the user's profile. `null` if not available.
+     */
+    display_name?: string | null;
+    /**
+     * Known public external URLs for this user.
+     */
+    external_urls?: Shared.ExternalURLObject;
+    /**
+     * Information about the followers of this user.
+     */
+    followers?: Shared.FollowersObject;
+    /**
+     * A link to the Web API endpoint for this user.
+     */
+    href?: string;
+    /**
+     * The user's profile image.
+     */
+    images?: Array<Shared.ImageObject>;
+    /**
+     * The object type.
+     */
+    type?: 'user';
+    /**
+     * The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this
+     * user.
+     */
+    uri?: string;
+}
+export declare namespace Users {
+    export { type UserRetrieveProfileResponse as UserRetrieveProfileResponse };
+    export { Playlists as Playlists, type PlaylistCreateResponse as PlaylistCreateResponse, type PlaylistCreateParams as PlaylistCreateParams, type PlaylistListParams as PlaylistListParams, };
+}
+//# sourceMappingURL=users.d.ts.map

package/resources/users/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/resources/users/users.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,KAAK,YAAY;OACjB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,SAAS,EAAE;OAC/E,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAE7E;;;;;;;;;OASG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,2BAA2B,CAAC;CAGnG;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;IAE3E,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/users/users.js

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Users = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const PlaylistsAPI = tslib_1.__importStar(require("./playlists.js"));
+const playlists_1 = require("./playlists.js");
+const path_1 = require("../../internal/utils/path.js");
+class Users extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.playlists = new PlaylistsAPI.Playlists(this._client);
+    }
+    /**
+     * Get public profile information about a Spotify user.
+     *
+     * @example
+     * ```ts
+     * const response = await client.users.retrieveProfile(
+     *   'smedjan',
+     * );
+     * ```
+     */
+    retrieveProfile(userID, options) {
+        return this._client.get((0, path_1.path) `/users/${userID}`, options);
+    }
+}
+exports.Users = Users;
+Users.Playlists = playlists_1.Playlists;
+//# sourceMappingURL=users.js.map

package/resources/users/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/resources/users/users.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,qEAA4C;AAC5C,8CAA0G;AAG1G,uDAAiD;AAEjD,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAe/E,CAAC;IAbC;;;;;;;;;OASG;IACH,eAAe,CAAC,MAAc,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF;AAhBD,sBAgBC;AA8CD,KAAK,CAAC,SAAS,GAAG,qBAAS,CAAC"}