ts-twitch-api 0.2.2 → 0.2.3

package/dist/index.cjs

@@ -73,10 +73,17 @@ var TwitchApi = class {
       options.headers.set("Client-Id", clientId || this._clientId);
     }
     const response = await fetch(url, options);
+    const status = response.status;
+    let data = null;
+    if (status === 200 && path === "/schedule/icalendar") {
+      data = await response.text();
+    } else if (status !== 204) {
+      data = await response.json();
+    }
     return {
       ok: response.ok,
-      status: response.status,
-      data: await response.json()
+      status,
+      data
     };
   }
   ads = {

package/dist/index.d.cts

@@ -12264,7 +12264,61 @@ declare class TwitchApi {
                 date_range: {
                     started_at: string;
                     ended_at: string;
-                };
+                }; /**
+                 * Gets an organization’s list of entitlements that have been granted to a game, a user, or both.
+                 *
+                 * **NOTE:** Entitlements returned in the response body data are not guaranteed to be sorted by any field returned by the API. To retrieve **CLAIMED** or **FULFILLED** entitlements, use the `fulfillment_status` query parameter to filter results. To retrieve entitlements for a specific game, use the `game_id` query parameter to filter results.
+                 *
+                 * The following table identifies the request parameters that you may specify based on the type of access token used.
+                 *
+                 * | Access token type | Parameter | Description |
+                 * | - | - | - |
+                 * | App | None | If you don’t specify request parameters, the request returns all entitlements that your organization owns. |
+                 * | App | user_id | The request returns all entitlements for any game that the organization granted to the specified user. |
+                 * | App | user_id, game_id | The request returns all entitlements that the specified game granted to the specified user. |
+                 * | App | game_id | The request returns all entitlements that the specified game granted to all entitled users. |
+                 * | User | None | If you don’t specify request parameters, the request returns all entitlements for any game that the organization granted to the user identified in the access token. |
+                 * | User | user_id | Invalid. |
+                 * | User | user_id, game_id | Invalid. |
+                 * | User | game_id | The request returns all entitlements that the specified game granted to the user identified in the access token. |
+                 *
+                 *
+                 * __Authorization:__
+                 *
+                 * Requires an [app access token](https://dev.twitch.tv/docs/authentication#app-access-tokens) or [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens). The client ID in the access token must own the game.
+                 *
+                 * __URL:__
+                 *
+                 * `GET https://api.twitch.tv/helix/entitlements/drops`
+                 *
+                 * __Response Codes:__
+                 *
+                 * _200 OK_
+                 *
+                 * Successfully retrieved the entitlements.
+                 *
+                 * _400 Bad Request_
+                 *
+                 * * The value in the _fulfillment\_status_ query parameter is not valid.
+                 * * The ID in the _user\_id_ query parameter must match the user ID in the user access token.
+                 * * The client in the access token is not associated with a known organization.
+                 * * The owner of the client in the access token is not a member of the organization.
+                 *
+                 * _401 Unauthorized_
+                 *
+                 * * The ID in the Client-Id header must match the Client ID in the access token.
+                 * * The Authorization header is required and must specify an app access token or user access token.
+                 * * The access token is not valid.
+                 *
+                 * _403 Forbidden_
+                 *
+                 * * The organization associated with the client in the access token must own the game specified in the _game\_id_ query parameter.
+                 * * The organization associated with the client in the access token must own the entitlements specified in the _id_ query parameter.
+                 *
+                 * _500 Internal Server Error_
+                 *
+                 * @see https://dev.twitch.tv/docs/api/reference#get-drops-entitlements
+                 */
                 total: number;
             };
         } | {
@@ -12407,7 +12461,43 @@ declare class TwitchApi {
                     user_id: string;
                     user_login: string;
                     user_name: string;
-                    product_type: "BITS_IN_EXTENSION";
+                    product_type: "BITS_IN_EXTENSION"; /**
+                     * Gets the specified configuration segment from the specified extension.
+                     *
+                     * **Rate Limits**: You may retrieve each segment a maximum of 20 times per minute.
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a signed JSON Web Token (JWT) created by an Extension Backend Service (EBS). For signing requirements, see [Signing the JWT](https://dev.twitch.tv/docs/extensions/building/#signing-the-jwt). The signed JWT must include the `role`, `user_id`, and `exp` fields (see [JWT Schema](https://dev.twitch.tv/docs/extensions/reference/#jwt-schema)). The `role` field must be set to _external_.
+                     *
+                     * __URL:__
+                     *
+                     * `GET https://api.twitch.tv/helix/extensions/configurations`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully retrieved the configurations.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The _extension\_id_ query parameter is required.
+                     * * The value in the _segment_ query parameter is not valid.
+                     * * The _broadcaster\_id_ query parameter is required if the _segment_ query parameter is set to broadcaster or developer.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must specify a JWT token.
+                     * * The JWT token is not valid.
+                     * * The Client-Id header is required.
+                     *
+                     * _429 Too Many Requests_
+                     *
+                     * * The app exceeded the number of requests that it may make per minute. See Rate Limits above.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#get-extension-configuration-segment
+                     */
                     product_data: {
                         sku: string;
                         domain: string;
@@ -13117,7 +13207,9 @@ declare class TwitchApi {
                 data: {
                     broadcaster_id: string;
                     broadcaster_login: string;
-                    broadcaster_name: string; /**
+                    broadcaster_name: string;
+                    id: string;
+                    user_id: string; /**
                      * Adds or updates a Bits product that the extension created. If the SKU doesn’t exist, the product is added. You may update all fields except the `sku` field.
                      *
                      * __Authorization:__
@@ -13153,8 +13245,6 @@ declare class TwitchApi {
                      *
                      * @see https://dev.twitch.tv/docs/api/reference#update-extension-bits-product
                      */
-                    id: string;
-                    user_id: string;
                     user_name: string;
                     user_login: string;
                     reward: {
@@ -13225,7 +13315,9 @@ declare class TwitchApi {
                 data: {
                     broadcaster_id: string;
                     broadcaster_login: string;
-                    broadcaster_name: string; /**
+                    broadcaster_name: string;
+                    id: string;
+                    user_id: string; /**
                      * Adds or updates a Bits product that the extension created. If the SKU doesn’t exist, the product is added. You may update all fields except the `sku` field.
                      *
                      * __Authorization:__
@@ -13261,8 +13353,6 @@ declare class TwitchApi {
                      *
                      * @see https://dev.twitch.tv/docs/api/reference#update-extension-bits-product
                      */
-                    id: string;
-                    user_id: string;
                     user_name: string;
                     user_login: string;
                     reward: {
@@ -14303,37 +14393,7 @@ declare class TwitchApi {
                     creator_id: string;
                     creator_name: string;
                     video_id: string;
-                    game_id: string; /**
-                     * Gets all users that the broadcaster banned or put in a timeout.
-                     *
-                     * __Authorization:__
-                     *
-                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **moderation:read** or **moderator:manage:banned\_users** scope.
-                     *
-                     * __URL:__
-                     *
-                     * `GET https://api.twitch.tv/helix/moderation/banned`
-                     *
-                     * __Response Codes:__
-                     *
-                     * _200 OK_
-                     *
-                     * Successfully retrieved the list of banned users.
-                     *
-                     * _400 Bad Request_
-                     *
-                     * * The _broadcaster\_id_ query parameter is required.
-                     *
-                     * _401 Unauthorized_
-                     *
-                     * * The ID in _broadcaster\_id_ must match the user ID in the user access token.
-                     * * The Authorization header is required and must contain a user access token.
-                     * * The user access token must include the **moderation:read** scope.
-                     * * The access token is not valid.
-                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
-                     *
-                     * @see https://dev.twitch.tv/docs/api/reference#get-banned-users
-                     */
+                    game_id: string;
                     language: string;
                     title: string;
                     view_count: number;
@@ -14569,42 +14629,7 @@ declare class TwitchApi {
                         session_id?: string;
                         connected_at?: string;
                         disconnected_at?: string;
-                    }; /**
-                     * BETA Gets a list of unban requests for a broadcaster’s channel.
-                     *
-                     * __Authorization:__
-                     *
-                     * * Requires a user access token that includes the **moderator:read:unban\_requests** or **moderator:manage:unban\_requests** scope.
-                     * * Query parameter `moderator_id` must match the `user_id` in the [user access token](https://dev.twitch.tv/docs/authentication/#user-access-tokens).
-                     *
-                     * __URL:__
-                     *
-                     * `GET https://api.twitch.tv/helix/moderation/unban_requests`
-                     *
-                     * __Response Codes:__
-                     *
-                     * _200 OK_
-                     *
-                     * Successfully retrieved the list of unban requests.
-                     *
-                     * _400 Bad Request_
-                     *
-                     * * The _broadcaster\_id_ query parameter is required.
-                     * * The ID in the _broadcaster\_id_ query parameter is not valid.
-                     * * The _moderator\_id_ query parameter is required.
-                     * * The ID in the _moderator\_id_ query parameter is not valid.
-                     * * The pagination cursor is not valid.
-                     *
-                     * _401 Unauthorized_
-                     *
-                     * * The ID in _moderator\_id_ must match the user ID in the user access token.
-                     * * The Authorization header is required and must contain a user access token.
-                     * * The user access token must include the **moderator:read:unban\_requests** or **moderator:manage:unban\_requests** scope.
-                     * * The access token is not valid.
-                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
-                     *
-                     * @see https://dev.twitch.tv/docs/api/reference#get-unban-requests
-                     */
+                    };
                 }[];
                 pagination?: {
                     cursor?: string;
@@ -15349,6 +15374,46 @@ declare class TwitchApi {
                             can_link_external_content: boolean;
                         };
                     };
+                    /**
+                     * Activates or deactivates the broadcaster’s Shield Mode.
+                     *
+                     * Twitch’s Shield Mode feature is like a panic button that broadcasters can push to protect themselves from chat abuse coming from one or more accounts. When activated, Shield Mode applies the overrides that the broadcaster configured in the Twitch UX. If the broadcaster hasn’t configured Shield Mode, it applies default overrides.
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **moderator:manage:shield\_mode** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/moderation/shield_mode`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the broadcaster’s Shield Mode status.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The _broadcaster\_id_ query parameter is required.
+                     * * The ID in the _broadcaster\_id_ query parameter is not valid.
+                     * * The `is_active` field is required.
+                     * * The value in the `is_active` field is not valid.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The ID in _moderator\_id_ must match the user ID in the user access token.
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **moderator:manage:shield\_mode** scope.
+                     * * The access token is not valid.
+                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _403 Forbidden_
+                     *
+                     * * The user in _moderator\_id_ is not one of the broadcaster's moderators.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-shield-mode-status
+                     */
                     allowlisted_config_urls: string[];
                     allowlisted_panel_urls: string[];
                 }[];
@@ -15447,6 +15512,46 @@ declare class TwitchApi {
                             can_link_external_content: boolean;
                         };
                     };
+                    /**
+                     * Activates or deactivates the broadcaster’s Shield Mode.
+                     *
+                     * Twitch’s Shield Mode feature is like a panic button that broadcasters can push to protect themselves from chat abuse coming from one or more accounts. When activated, Shield Mode applies the overrides that the broadcaster configured in the Twitch UX. If the broadcaster hasn’t configured Shield Mode, it applies default overrides.
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **moderator:manage:shield\_mode** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/moderation/shield_mode`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the broadcaster’s Shield Mode status.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The _broadcaster\_id_ query parameter is required.
+                     * * The ID in the _broadcaster\_id_ query parameter is not valid.
+                     * * The `is_active` field is required.
+                     * * The value in the `is_active` field is not valid.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The ID in _moderator\_id_ must match the user ID in the user access token.
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **moderator:manage:shield\_mode** scope.
+                     * * The access token is not valid.
+                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _403 Forbidden_
+                     *
+                     * * The user in _moderator\_id_ is not one of the broadcaster's moderators.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-shield-mode-status
+                     */
                     allowlisted_config_urls: string[];
                     allowlisted_panel_urls: string[];
                 }[];
@@ -16494,41 +16599,7 @@ declare class TwitchApi {
                         id: string;
                         last_contribution: {
                             total: number;
-                            type: "BITS" | "SUBS" | "OTHER"; /**
-                             * Gets the channels that match the specified query and have streamed content within the past 6 months.
-                             *
-                             * The fields that the API uses for comparison depends on the value that the _live\_only_ query parameter is set to. If _live\_only_ is **false**, the API matches on the broadcaster’s login name. However, if _live\_only_ is **true**, the API matches on the broadcaster’s name and category name.
-                             *
-                             * To match, the beginning of the broadcaster’s name or category must match the query string. The comparison is case insensitive. If the query string is angel\_of\_death, it matches all names that begin with angel\_of\_death. However, if the query string is a phrase like _angel of death_, it matches to names starting with angelofdeath or names starting with angel\_of\_death.
-                             *
-                             * By default, the results include both live and offline channels. To get only live channels set the _live\_only_ query parameter to **true**.
-                             *
-                             * __Authorization:__
-                             *
-                             * Requires an [app access token](https://dev.twitch.tv/docs/authentication#app-access-tokens) or [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens).
-                             *
-                             * __URL:__
-                             *
-                             * `GET https://api.twitch.tv/helix/search/channels`
-                             *
-                             * __Response Codes:__
-                             *
-                             * _200 OK_
-                             *
-                             * Successfully retrieved the list of category names that matched the specified query string.
-                             *
-                             * _400 Bad Request_
-                             *
-                             * * The _query_ query parameter is required.
-                             *
-                             * _401 Unauthorized_
-                             *
-                             * * The Authorization header is required and must contain an app access token or user access token.
-                             * * The access token is not valid.
-                             * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
-                             *
-                             * @see https://dev.twitch.tv/docs/api/reference#search-channels
-                             */
+                            type: "BITS" | "SUBS" | "OTHER";
                             user: string;
                         };
                         level: number;
@@ -17817,38 +17888,7 @@ declare class TwitchApi {
                     is_active: boolean;
                     moderator_id: string;
                     moderator_login: string;
-                    moderator_name: string; /**
-                     * Updates the specified user’s information. The user ID in the OAuth token identifies the user whose information you want to update.
-                     *
-                     * To include the user’s verified email address in the response, the user access token must also include the **user:read:email** scope.
-                     *
-                     * __Authorization:__
-                     *
-                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit** scope.
-                     *
-                     * __URL:__
-                     *
-                     * `PUT https://api.twitch.tv/helix/users`
-                     *
-                     * __Response Codes:__
-                     *
-                     * _200 OK_
-                     *
-                     * Successfully updated the specified user's information.
-                     *
-                     * _400 Bad Request_
-                     *
-                     * * The string in the _description_ query parameter is too long.
-                     *
-                     * _401 Unauthorized_
-                     *
-                     * * The Authorization header is required and must contain a user access token.
-                     * * The user access token must include the **user:edit** scope.
-                     * * The access token is not valid.
-                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
-                     *
-                     * @see https://dev.twitch.tv/docs/api/reference#update-user
-                     */
+                    moderator_name: string;
                     last_activated_at: string;
                 }[];
             };
@@ -18116,7 +18156,42 @@ declare class TwitchApi {
                     broadcaster_id: string;
                     broadcaster_name: string;
                     broadcaster_login: string;
-                    title: string;
+                    title: string; /**
+                     * Updates an installed extension’s information. You can update the extension’s activation state, ID, and version number. The user ID in the access token identifies the broadcaster whose extensions you’re updating.
+                     *
+                     * NOTE: If you try to activate an extension under multiple extension types, the last write wins (and there is no guarantee of write order).
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit:broadcast** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/users/extensions`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the active extensions.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The JSON payload is malformed.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **user:edit:broadcast** scope.
+                     * * The access token is not valid.
+                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _404 Not Found_
+                     *
+                     * * An extension with the specified `id` and `version` values was not found.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-user-extensions
+                     */
                     winning_outcome_id: string | null;
                     outcomes: {
                         id: string;
@@ -18200,7 +18275,42 @@ declare class TwitchApi {
                     broadcaster_id: string;
                     broadcaster_name: string;
                     broadcaster_login: string;
-                    title: string;
+                    title: string; /**
+                     * Updates an installed extension’s information. You can update the extension’s activation state, ID, and version number. The user ID in the access token identifies the broadcaster whose extensions you’re updating.
+                     *
+                     * NOTE: If you try to activate an extension under multiple extension types, the last write wins (and there is no guarantee of write order).
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit:broadcast** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/users/extensions`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the active extensions.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The JSON payload is malformed.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **user:edit:broadcast** scope.
+                     * * The access token is not valid.
+                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _404 Not Found_
+                     *
+                     * * An extension with the specified `id` and `version` values was not found.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-user-extensions
+                     */
                     winning_outcome_id: string | null;
                     outcomes: {
                         id: string;
@@ -18279,7 +18389,42 @@ declare class TwitchApi {
                     broadcaster_id: string;
                     broadcaster_name: string;
                     broadcaster_login: string;
-                    title: string;
+                    title: string; /**
+                     * Updates an installed extension’s information. You can update the extension’s activation state, ID, and version number. The user ID in the access token identifies the broadcaster whose extensions you’re updating.
+                     *
+                     * NOTE: If you try to activate an extension under multiple extension types, the last write wins (and there is no guarantee of write order).
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit:broadcast** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/users/extensions`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the active extensions.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The JSON payload is malformed.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **user:edit:broadcast** scope.
+                     * * The access token is not valid.
+                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _404 Not Found_
+                     *
+                     * * An extension with the specified `id` and `version` values was not found.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-user-extensions
+                     */
                     winning_outcome_id: string | null;
                     outcomes: {
                         id: string;

package/dist/index.d.ts

@@ -12264,7 +12264,61 @@ declare class TwitchApi {
                 date_range: {
                     started_at: string;
                     ended_at: string;
-                };
+                }; /**
+                 * Gets an organization’s list of entitlements that have been granted to a game, a user, or both.
+                 *
+                 * **NOTE:** Entitlements returned in the response body data are not guaranteed to be sorted by any field returned by the API. To retrieve **CLAIMED** or **FULFILLED** entitlements, use the `fulfillment_status` query parameter to filter results. To retrieve entitlements for a specific game, use the `game_id` query parameter to filter results.
+                 *
+                 * The following table identifies the request parameters that you may specify based on the type of access token used.
+                 *
+                 * | Access token type | Parameter | Description |
+                 * | - | - | - |
+                 * | App | None | If you don’t specify request parameters, the request returns all entitlements that your organization owns. |
+                 * | App | user_id | The request returns all entitlements for any game that the organization granted to the specified user. |
+                 * | App | user_id, game_id | The request returns all entitlements that the specified game granted to the specified user. |
+                 * | App | game_id | The request returns all entitlements that the specified game granted to all entitled users. |
+                 * | User | None | If you don’t specify request parameters, the request returns all entitlements for any game that the organization granted to the user identified in the access token. |
+                 * | User | user_id | Invalid. |
+                 * | User | user_id, game_id | Invalid. |
+                 * | User | game_id | The request returns all entitlements that the specified game granted to the user identified in the access token. |
+                 *
+                 *
+                 * __Authorization:__
+                 *
+                 * Requires an [app access token](https://dev.twitch.tv/docs/authentication#app-access-tokens) or [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens). The client ID in the access token must own the game.
+                 *
+                 * __URL:__
+                 *
+                 * `GET https://api.twitch.tv/helix/entitlements/drops`
+                 *
+                 * __Response Codes:__
+                 *
+                 * _200 OK_
+                 *
+                 * Successfully retrieved the entitlements.
+                 *
+                 * _400 Bad Request_
+                 *
+                 * * The value in the _fulfillment\_status_ query parameter is not valid.
+                 * * The ID in the _user\_id_ query parameter must match the user ID in the user access token.
+                 * * The client in the access token is not associated with a known organization.
+                 * * The owner of the client in the access token is not a member of the organization.
+                 *
+                 * _401 Unauthorized_
+                 *
+                 * * The ID in the Client-Id header must match the Client ID in the access token.
+                 * * The Authorization header is required and must specify an app access token or user access token.
+                 * * The access token is not valid.
+                 *
+                 * _403 Forbidden_
+                 *
+                 * * The organization associated with the client in the access token must own the game specified in the _game\_id_ query parameter.
+                 * * The organization associated with the client in the access token must own the entitlements specified in the _id_ query parameter.
+                 *
+                 * _500 Internal Server Error_
+                 *
+                 * @see https://dev.twitch.tv/docs/api/reference#get-drops-entitlements
+                 */
                 total: number;
             };
         } | {
@@ -12407,7 +12461,43 @@ declare class TwitchApi {
                     user_id: string;
                     user_login: string;
                     user_name: string;
-                    product_type: "BITS_IN_EXTENSION";
+                    product_type: "BITS_IN_EXTENSION"; /**
+                     * Gets the specified configuration segment from the specified extension.
+                     *
+                     * **Rate Limits**: You may retrieve each segment a maximum of 20 times per minute.
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a signed JSON Web Token (JWT) created by an Extension Backend Service (EBS). For signing requirements, see [Signing the JWT](https://dev.twitch.tv/docs/extensions/building/#signing-the-jwt). The signed JWT must include the `role`, `user_id`, and `exp` fields (see [JWT Schema](https://dev.twitch.tv/docs/extensions/reference/#jwt-schema)). The `role` field must be set to _external_.
+                     *
+                     * __URL:__
+                     *
+                     * `GET https://api.twitch.tv/helix/extensions/configurations`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully retrieved the configurations.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The _extension\_id_ query parameter is required.
+                     * * The value in the _segment_ query parameter is not valid.
+                     * * The _broadcaster\_id_ query parameter is required if the _segment_ query parameter is set to broadcaster or developer.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must specify a JWT token.
+                     * * The JWT token is not valid.
+                     * * The Client-Id header is required.
+                     *
+                     * _429 Too Many Requests_
+                     *
+                     * * The app exceeded the number of requests that it may make per minute. See Rate Limits above.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#get-extension-configuration-segment
+                     */
                     product_data: {
                         sku: string;
                         domain: string;
@@ -13117,7 +13207,9 @@ declare class TwitchApi {
                 data: {
                     broadcaster_id: string;
                     broadcaster_login: string;
-                    broadcaster_name: string; /**
+                    broadcaster_name: string;
+                    id: string;
+                    user_id: string; /**
                      * Adds or updates a Bits product that the extension created. If the SKU doesn’t exist, the product is added. You may update all fields except the `sku` field.
                      *
                      * __Authorization:__
@@ -13153,8 +13245,6 @@ declare class TwitchApi {
                      *
                      * @see https://dev.twitch.tv/docs/api/reference#update-extension-bits-product
                      */
-                    id: string;
-                    user_id: string;
                     user_name: string;
                     user_login: string;
                     reward: {
@@ -13225,7 +13315,9 @@ declare class TwitchApi {
                 data: {
                     broadcaster_id: string;
                     broadcaster_login: string;
-                    broadcaster_name: string; /**
+                    broadcaster_name: string;
+                    id: string;
+                    user_id: string; /**
                      * Adds or updates a Bits product that the extension created. If the SKU doesn’t exist, the product is added. You may update all fields except the `sku` field.
                      *
                      * __Authorization:__
@@ -13261,8 +13353,6 @@ declare class TwitchApi {
                      *
                      * @see https://dev.twitch.tv/docs/api/reference#update-extension-bits-product
                      */
-                    id: string;
-                    user_id: string;
                     user_name: string;
                     user_login: string;
                     reward: {
@@ -14303,37 +14393,7 @@ declare class TwitchApi {
                     creator_id: string;
                     creator_name: string;
                     video_id: string;
-                    game_id: string; /**
-                     * Gets all users that the broadcaster banned or put in a timeout.
-                     *
-                     * __Authorization:__
-                     *
-                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **moderation:read** or **moderator:manage:banned\_users** scope.
-                     *
-                     * __URL:__
-                     *
-                     * `GET https://api.twitch.tv/helix/moderation/banned`
-                     *
-                     * __Response Codes:__
-                     *
-                     * _200 OK_
-                     *
-                     * Successfully retrieved the list of banned users.
-                     *
-                     * _400 Bad Request_
-                     *
-                     * * The _broadcaster\_id_ query parameter is required.
-                     *
-                     * _401 Unauthorized_
-                     *
-                     * * The ID in _broadcaster\_id_ must match the user ID in the user access token.
-                     * * The Authorization header is required and must contain a user access token.
-                     * * The user access token must include the **moderation:read** scope.
-                     * * The access token is not valid.
-                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
-                     *
-                     * @see https://dev.twitch.tv/docs/api/reference#get-banned-users
-                     */
+                    game_id: string;
                     language: string;
                     title: string;
                     view_count: number;
@@ -14569,42 +14629,7 @@ declare class TwitchApi {
                         session_id?: string;
                         connected_at?: string;
                         disconnected_at?: string;
-                    }; /**
-                     * BETA Gets a list of unban requests for a broadcaster’s channel.
-                     *
-                     * __Authorization:__
-                     *
-                     * * Requires a user access token that includes the **moderator:read:unban\_requests** or **moderator:manage:unban\_requests** scope.
-                     * * Query parameter `moderator_id` must match the `user_id` in the [user access token](https://dev.twitch.tv/docs/authentication/#user-access-tokens).
-                     *
-                     * __URL:__
-                     *
-                     * `GET https://api.twitch.tv/helix/moderation/unban_requests`
-                     *
-                     * __Response Codes:__
-                     *
-                     * _200 OK_
-                     *
-                     * Successfully retrieved the list of unban requests.
-                     *
-                     * _400 Bad Request_
-                     *
-                     * * The _broadcaster\_id_ query parameter is required.
-                     * * The ID in the _broadcaster\_id_ query parameter is not valid.
-                     * * The _moderator\_id_ query parameter is required.
-                     * * The ID in the _moderator\_id_ query parameter is not valid.
-                     * * The pagination cursor is not valid.
-                     *
-                     * _401 Unauthorized_
-                     *
-                     * * The ID in _moderator\_id_ must match the user ID in the user access token.
-                     * * The Authorization header is required and must contain a user access token.
-                     * * The user access token must include the **moderator:read:unban\_requests** or **moderator:manage:unban\_requests** scope.
-                     * * The access token is not valid.
-                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
-                     *
-                     * @see https://dev.twitch.tv/docs/api/reference#get-unban-requests
-                     */
+                    };
                 }[];
                 pagination?: {
                     cursor?: string;
@@ -15349,6 +15374,46 @@ declare class TwitchApi {
                             can_link_external_content: boolean;
                         };
                     };
+                    /**
+                     * Activates or deactivates the broadcaster’s Shield Mode.
+                     *
+                     * Twitch’s Shield Mode feature is like a panic button that broadcasters can push to protect themselves from chat abuse coming from one or more accounts. When activated, Shield Mode applies the overrides that the broadcaster configured in the Twitch UX. If the broadcaster hasn’t configured Shield Mode, it applies default overrides.
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **moderator:manage:shield\_mode** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/moderation/shield_mode`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the broadcaster’s Shield Mode status.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The _broadcaster\_id_ query parameter is required.
+                     * * The ID in the _broadcaster\_id_ query parameter is not valid.
+                     * * The `is_active` field is required.
+                     * * The value in the `is_active` field is not valid.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The ID in _moderator\_id_ must match the user ID in the user access token.
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **moderator:manage:shield\_mode** scope.
+                     * * The access token is not valid.
+                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _403 Forbidden_
+                     *
+                     * * The user in _moderator\_id_ is not one of the broadcaster's moderators.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-shield-mode-status
+                     */
                     allowlisted_config_urls: string[];
                     allowlisted_panel_urls: string[];
                 }[];
@@ -15447,6 +15512,46 @@ declare class TwitchApi {
                             can_link_external_content: boolean;
                         };
                     };
+                    /**
+                     * Activates or deactivates the broadcaster’s Shield Mode.
+                     *
+                     * Twitch’s Shield Mode feature is like a panic button that broadcasters can push to protect themselves from chat abuse coming from one or more accounts. When activated, Shield Mode applies the overrides that the broadcaster configured in the Twitch UX. If the broadcaster hasn’t configured Shield Mode, it applies default overrides.
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **moderator:manage:shield\_mode** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/moderation/shield_mode`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the broadcaster’s Shield Mode status.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The _broadcaster\_id_ query parameter is required.
+                     * * The ID in the _broadcaster\_id_ query parameter is not valid.
+                     * * The `is_active` field is required.
+                     * * The value in the `is_active` field is not valid.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The ID in _moderator\_id_ must match the user ID in the user access token.
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **moderator:manage:shield\_mode** scope.
+                     * * The access token is not valid.
+                     * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _403 Forbidden_
+                     *
+                     * * The user in _moderator\_id_ is not one of the broadcaster's moderators.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-shield-mode-status
+                     */
                     allowlisted_config_urls: string[];
                     allowlisted_panel_urls: string[];
                 }[];
@@ -16494,41 +16599,7 @@ declare class TwitchApi {
                         id: string;
                         last_contribution: {
                             total: number;
-                            type: "BITS" | "SUBS" | "OTHER"; /**
-                             * Gets the channels that match the specified query and have streamed content within the past 6 months.
-                             *
-                             * The fields that the API uses for comparison depends on the value that the _live\_only_ query parameter is set to. If _live\_only_ is **false**, the API matches on the broadcaster’s login name. However, if _live\_only_ is **true**, the API matches on the broadcaster’s name and category name.
-                             *
-                             * To match, the beginning of the broadcaster’s name or category must match the query string. The comparison is case insensitive. If the query string is angel\_of\_death, it matches all names that begin with angel\_of\_death. However, if the query string is a phrase like _angel of death_, it matches to names starting with angelofdeath or names starting with angel\_of\_death.
-                             *
-                             * By default, the results include both live and offline channels. To get only live channels set the _live\_only_ query parameter to **true**.
-                             *
-                             * __Authorization:__
-                             *
-                             * Requires an [app access token](https://dev.twitch.tv/docs/authentication#app-access-tokens) or [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens).
-                             *
-                             * __URL:__
-                             *
-                             * `GET https://api.twitch.tv/helix/search/channels`
-                             *
-                             * __Response Codes:__
-                             *
-                             * _200 OK_
-                             *
-                             * Successfully retrieved the list of category names that matched the specified query string.
-                             *
-                             * _400 Bad Request_
-                             *
-                             * * The _query_ query parameter is required.
-                             *
-                             * _401 Unauthorized_
-                             *
-                             * * The Authorization header is required and must contain an app access token or user access token.
-                             * * The access token is not valid.
-                             * * The client ID specified in the Client-Id header does not match the client ID specified in the access token.
-                             *
-                             * @see https://dev.twitch.tv/docs/api/reference#search-channels
-                             */
+                            type: "BITS" | "SUBS" | "OTHER";
                             user: string;
                         };
                         level: number;
@@ -17817,38 +17888,7 @@ declare class TwitchApi {
                     is_active: boolean;
                     moderator_id: string;
                     moderator_login: string;
-                    moderator_name: string; /**
-                     * Updates the specified user’s information. The user ID in the OAuth token identifies the user whose information you want to update.
-                     *
-                     * To include the user’s verified email address in the response, the user access token must also include the **user:read:email** scope.
-                     *
-                     * __Authorization:__
-                     *
-                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit** scope.
-                     *
-                     * __URL:__
-                     *
-                     * `PUT https://api.twitch.tv/helix/users`
-                     *
-                     * __Response Codes:__
-                     *
-                     * _200 OK_
-                     *
-                     * Successfully updated the specified user's information.
-                     *
-                     * _400 Bad Request_
-                     *
-                     * * The string in the _description_ query parameter is too long.
-                     *
-                     * _401 Unauthorized_
-                     *
-                     * * The Authorization header is required and must contain a user access token.
-                     * * The user access token must include the **user:edit** scope.
-                     * * The access token is not valid.
-                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
-                     *
-                     * @see https://dev.twitch.tv/docs/api/reference#update-user
-                     */
+                    moderator_name: string;
                     last_activated_at: string;
                 }[];
             };
@@ -18116,7 +18156,42 @@ declare class TwitchApi {
                     broadcaster_id: string;
                     broadcaster_name: string;
                     broadcaster_login: string;
-                    title: string;
+                    title: string; /**
+                     * Updates an installed extension’s information. You can update the extension’s activation state, ID, and version number. The user ID in the access token identifies the broadcaster whose extensions you’re updating.
+                     *
+                     * NOTE: If you try to activate an extension under multiple extension types, the last write wins (and there is no guarantee of write order).
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit:broadcast** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/users/extensions`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the active extensions.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The JSON payload is malformed.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **user:edit:broadcast** scope.
+                     * * The access token is not valid.
+                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _404 Not Found_
+                     *
+                     * * An extension with the specified `id` and `version` values was not found.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-user-extensions
+                     */
                     winning_outcome_id: string | null;
                     outcomes: {
                         id: string;
@@ -18200,7 +18275,42 @@ declare class TwitchApi {
                     broadcaster_id: string;
                     broadcaster_name: string;
                     broadcaster_login: string;
-                    title: string;
+                    title: string; /**
+                     * Updates an installed extension’s information. You can update the extension’s activation state, ID, and version number. The user ID in the access token identifies the broadcaster whose extensions you’re updating.
+                     *
+                     * NOTE: If you try to activate an extension under multiple extension types, the last write wins (and there is no guarantee of write order).
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit:broadcast** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/users/extensions`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the active extensions.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The JSON payload is malformed.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **user:edit:broadcast** scope.
+                     * * The access token is not valid.
+                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _404 Not Found_
+                     *
+                     * * An extension with the specified `id` and `version` values was not found.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-user-extensions
+                     */
                     winning_outcome_id: string | null;
                     outcomes: {
                         id: string;
@@ -18279,7 +18389,42 @@ declare class TwitchApi {
                     broadcaster_id: string;
                     broadcaster_name: string;
                     broadcaster_login: string;
-                    title: string;
+                    title: string; /**
+                     * Updates an installed extension’s information. You can update the extension’s activation state, ID, and version number. The user ID in the access token identifies the broadcaster whose extensions you’re updating.
+                     *
+                     * NOTE: If you try to activate an extension under multiple extension types, the last write wins (and there is no guarantee of write order).
+                     *
+                     * __Authorization:__
+                     *
+                     * Requires a [user access token](https://dev.twitch.tv/docs/authentication#user-access-tokens) that includes the **user:edit:broadcast** scope.
+                     *
+                     * __URL:__
+                     *
+                     * `PUT https://api.twitch.tv/helix/users/extensions`
+                     *
+                     * __Response Codes:__
+                     *
+                     * _200 OK_
+                     *
+                     * Successfully updated the active extensions.
+                     *
+                     * _400 Bad Request_
+                     *
+                     * * The JSON payload is malformed.
+                     *
+                     * _401 Unauthorized_
+                     *
+                     * * The Authorization header is required and must contain a user access token.
+                     * * The user access token must include the **user:edit:broadcast** scope.
+                     * * The access token is not valid.
+                     * * The ID specified in the Client-Id header does not match the client ID specified in the access token.
+                     *
+                     * _404 Not Found_
+                     *
+                     * * An extension with the specified `id` and `version` values was not found.
+                     *
+                     * @see https://dev.twitch.tv/docs/api/reference#update-user-extensions
+                     */
                     winning_outcome_id: string | null;
                     outcomes: {
                         id: string;

package/dist/index.js

@@ -47,10 +47,17 @@ var TwitchApi = class {
       options.headers.set("Client-Id", clientId || this._clientId);
     }
     const response = await fetch(url, options);
+    const status = response.status;
+    let data = null;
+    if (status === 200 && path === "/schedule/icalendar") {
+      data = await response.text();
+    } else if (status !== 204) {
+      data = await response.json();
+    }
     return {
       ok: response.ok,
-      status: response.status,
-      data: await response.json()
+      status,
+      data
     };
   }
   ads = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-twitch-api",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Very simple TwitchApi class and TypeScript interfaces for all Twitch API endpoints",
   "author": "DmitryScaletta",
   "license": "MIT",
@@ -34,9 +34,9 @@
     "gen": "pnpm dlx openapi-typescript https://github.com/DmitryScaletta/twitch-api-swagger/raw/main/openapi.json --output twitch-api.generated.ts"
   },
   "devDependencies": {
-    "@types/node": "^20.11.2",
-    "tsup": "^8.0.1",
-    "tsx": "^4.7.0",
-    "typescript": "^5.3.3"
+    "@types/node": "^20.11.28",
+    "tsup": "^8.0.2",
+    "tsx": "^4.7.1",
+    "typescript": "^5.4.2"
   }
 }