kicksdk-js 0.1.1 → 0.3.0

package/pkg/kicksdk.d.ts

@@ -1,28 +1,319 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/** Base URLs to use instead of Kick's. Any left out, or undefined, stay Kick's. */
+export interface Endpoints {
+    /** The official API's host, without a version: `https://api.kick.com`. */
+    api?: string | undefined;
+    /** OAuth: `https://id.kick.com`. */
+    id?: string | undefined;
+    /** kick.com itself, whose `/api/v2` is the website API. */
+    website?: string | undefined;
+    /** The realtime endpoints: `https://web.kick.com/api/v1/realtime`. */
+    realtime?: string | undefined;
+}
+
+/** The message a reply answers, from its chat event: `sender_id` is the sender's user id. */
+export interface ReplyTo {
+    message_id: string;
+    content?: string | undefined;
+    sender_id: number;
+    sender_username: string;
+}
+
+/** A webhook delivery's headers: `[name, value]` pairs (a fetch `Headers` will do) or an object. */
+export type WebhookHeaders = Iterable<readonly [string, string]> | Record<string, string>;
+
+/** How a delivery's timestamp is checked. By default: within 5 minutes of this machine's clock. */
+export interface VerifyOptions {
+    /** Now, Unix **seconds** (not `Date.now()`'s milliseconds). Default: this machine's clock. */
+    now?: number | undefined;
+    /** How far from `now` the timestamp may be, either way, in seconds. Default 300. */
+    toleranceSecs?: number | undefined;
+    /** No freshness check: to re-check a delivery stored earlier. A live receiver never skips it. */
+    skipFreshness?: boolean | undefined;
+}
+
+/** A delivery that passed: its headers and the typed event. */
+export interface VerifiedWebhook {
+    headers: {
+        message_id: string;
+        timestamp: string;
+        signature: string;
+        event_type: string;
+        version: string;
+        subscription_id: string | null;
+    };
+    event: { type: string; [key: string]: unknown };
+}
+
+/** A request for `fetch`: what every `…Request` function returns. */
+export interface HttpRequest {
+    method: string;
+    url: string;
+    headers: [string, string][];
+    body: string | null;
+}
+
+/** A user token's scope, as Kick spells it: the 13 Kick documents, or one added since. */
+export type Scope =
+| 'ads:read'
+| 'ads:write'
+| 'channel:read'
+| 'channel:write'
+| 'channel:rewards:read'
+| 'channel:rewards:write'
+| 'chat:write'
+| 'events:subscribe'
+| 'kicks:read'
+| 'moderation:ban'
+| 'moderation:chat_message:manage'
+| 'streamkey:read'
+| 'user:read'
+| (string & {});
+
+/**
+ * A PKCE pair: `challenge` goes in `oauthAuthorizeUrl`, `verifier` is a
+ * secret kept until the user comes back, for `oauthCodeRequest`. Never log it.
+ */
+export interface Pkce {
+    verifier: string;
+    challenge: string;
+}
+
+/** A user token. Both tokens are secrets: never log them. */
+export interface UserToken {
+    access_token: string;
+    /** For `oauthRefreshRequest`; each refresh gives a new one. */
+    refresh_token: string | null;
+    /** Seconds until the access token expires. */
+    expires_in: number | null;
+    /** Seconds until the refresh token expires, from every refresh. */
+    refresh_expires_in: number | null;
+    token_type: string | null;
+    scopes: Scope[];
+}
+
+/** Which kind of token `oauthRevokeRequest` revokes. */
+export type TokenTypeHint = 'access_token' | 'refresh_token';
+
+/** What Kick says about a token. When it is not `active`, nothing else. */
+export interface Introspection {
+    active: boolean;
+    client_id: string | null;
+    /** Unix seconds. */
+    exp: number | null;
+    scopes: Scope[];
+    /** `user` or `app`. */
+    token_type: string | null;
+}
+
+/** One page of a paginated answer: pass `next_cursor` back for the next. */
+export interface Page<T> {
+    data: T[];
+    next_cursor: string | null;
+}
+
+export interface User {
+    user_id: number;
+    name: string | null;
+    profile_picture: string | null;
+    /** Only for a user token with `user:read`, for its own user. */
+    email: string | null;
+}
+
+export interface Category {
+    id: number | null;
+    name: string | null;
+    thumbnail: string | null;
+    /** Only `categoriesRequest` gives them; empty elsewhere. */
+    tags: string[];
+}
+
+export interface LivestreamStats {
+    total_count: number | null;
+}
+
+export interface KicksEntry {
+    user_id: number;
+    username: string | null;
+    rank: number | null;
+    gifted_amount: number | null;
+}
+
+export interface KicksLeaderboard {
+    lifetime: KicksEntry[];
+    month: KicksEntry[];
+    week: KicksEntry[];
+}
+
+/** Who `chatSendRequest` sends as: the token's user, into a channel by its broadcaster's user id, or the app's bot. */
+export type ChatSender = { user: number } | 'bot';
+
+/** What Kick says about a message sent. */
+export interface Sent {
+    is_sent: boolean;
+    /** The new message's id, for `chatDeleteRequest`. */
+    message_id: string | null;
+}
+
+export interface Reward {
+    id: string;
+    title: string | null;
+    description: string | null;
+    cost: number | null;
+    background_color: string | null;
+    is_enabled: boolean | null;
+    is_paused: boolean | null;
+    is_user_input_required: boolean | null;
+    should_redemptions_skip_request_queue: boolean | null;
+}
+
+/** A reward's settings: what is left out is not sent. Creating needs `title` and `cost`. */
+export interface RewardFields {
+    title?: string | undefined;
+    cost?: number | undefined;
+    description?: string | undefined;
+    background_color?: string | undefined;
+    is_enabled?: boolean | undefined;
+    is_paused?: boolean | undefined;
+    is_user_input_required?: boolean | undefined;
+    should_redemptions_skip_request_queue?: boolean | undefined;
+}
+
+export type RedemptionStatus = 'pending' | 'accepted' | 'rejected';
+
+export interface Redemption {
+    id: string;
+    status: string | null;
+    redeemed_at: string | null;
+    /** The redeemer's user id. */
+    redeemer: number | null;
+    user_input: string | null;
+}
+
+export interface RedeemedReward {
+    id: string;
+    title: string | null;
+    description: string | null;
+    cost: number | null;
+    can_manage: boolean | null;
+    is_deleted: boolean;
+}
+
+export interface RedemptionPage {
+    rewards: { reward: RedeemedReward; redemptions: Redemption[] }[];
+    next_cursor: string | null;
+}
+
+/** A redemption Kick did not accept or reject: `NOT_PENDING`, `NOT_FOUND`, `NOT_OWNED`, `UNKNOWN`. */
+export interface FailedRedemption {
+    id: string;
+    reason: string | null;
+}
+
+export interface AdBreak {
+    id: string | null;
+    ad_break_id: string | null;
+    remaining_ad_breaks: number | null;
+}
+
+export interface AdStatus {
+    opted_in: boolean | null;
+    ads_blocked: boolean | null;
+    auto_ads_active: boolean | null;
+    remaining_ad_breaks: number | null;
+    limits: { max: number | null; period_seconds: number | null } | null;
+    ad_breaks: {
+        id: string | null;
+        ad_break_id: string | null;
+        status: string | null;
+        source: string | null;
+        break_duration_seconds: number | null;
+        created_at: string | null;
+    }[];
+}
+
+/** What `dropsClaimsRequest` lists by: what is left out is not filtered. */
+export interface ClaimFilter {
+    campaign_id?: string | undefined;
+    claim_id?: string | undefined;
+    user_id?: number | undefined;
+    external_status?: string | undefined;
+    /** 1 to 1000. */
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}
+
+export interface Claim {
+    claim_id: string;
+    user_id: number | null;
+    campaign_id: string | null;
+    reward_id: string | null;
+    external_id: string | null;
+    external_status: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+
+export interface Claims {
+    claims: Claim[];
+    /** The next page's, for `ClaimFilter.cursor`. */
+    cursor: string | null;
+}
+
+/** One claim's new status, for `dropsUpdateClaimsRequest`. */
+export interface ClaimUpdate {
+    claim_id: string;
+    external_status: string;
+}
+
+
+
 /**
- * Reconnect delays: 1 s doubling to 30 s.
+ * Reconnect delays: 1 s doubling to 30 s, and a slower stage for terminal
+ * closes (`nextDelayFor`).
  */
 export class Backoff {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * From `initialMs`, doubling to `maxMs`.
+     * From `initialMs`, doubling to `maxMs` (whole milliseconds).
      */
     constructor(initial_ms?: number | null, max_ms?: number | null);
+    /**
+     * The wait before reconnecting after a connection ended, ms.
+     * `retryAfterMs` is what the end asked for: a `close` action's
+     * `retry_after_ms`, `retryAfterMs(code)` for a socket's close code, or 0
+     * for a failure without a code. With 0, exactly `nextDelayJittered`.
+     * With more (a terminal close), at least that, doubling with each
+     * terminal close since `reset()` up to six times it (300000: 5, 10, 20,
+     * then 30 minutes), plus up to a quarter more by `random`. Reconnect
+     * with a new client id after a terminal close.
+     */
+    nextDelayFor(retry_after_ms: number, random: number): number;
+    /**
+     * The next wait, ms, spread over [half of it, all of it] by `random`,
+     * drawn uniformly from [0, 1) (`Math.random()`), so that clients dropped
+     * together do not all come back together. Out of range is clamped, NaN
+     * taken as 0.
+     */
+    nextDelayJittered(random: number): number;
     /**
      * The next wait, ms.
      */
     nextDelay(): number;
     /**
-     * A connection worked.
+     * The chat feed subscribed: back to the first wait, and the terminal
+     * streak ends.
      */
     reset(): void;
 }
 
 /**
  * One connection's protocol. Each method returns the actions to carry out.
+ * `now` is whole milliseconds from a clock that only goes forward
+ * (`Math.floor(performance.now())`, or `Date.now()`).
  */
 export class Session {
     free(): void;
@@ -65,35 +356,93 @@ export class Session {
     tick(now: number): any;
 }
 
+/**
+ * Kick's webhook key, read once: `new WebhookPublicKey(pem)`, then
+ * `key.verify(headers, body, options?)` for each delivery.
+ */
+export class WebhookPublicKey {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Reads a PEM key (`BEGIN PUBLIC KEY`, as Kick serves it, or
+     * `BEGIN RSA PUBLIC KEY`); throws if it is not one.
+     */
+    constructor(pem: string);
+    /**
+     * `verifyWebhook`, with this key.
+     */
+    verify(headers: WebhookHeaders, body: string | Uint8Array | ArrayBuffer, options?: VerifyOptions | null): VerifiedWebhook;
+}
+
+/**
+ * Starts an ad break of 7 to 90 `seconds`; `id` is a UUID you make up
+ * (`crypto.randomUUID()`).
+ */
+export function adsAdBreakRequest(token: string, id: string, seconds: number, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Enrolls the channel in ads; `parseDone` reads the answer.
+ */
+export function adsEnrollRequest(token: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Reads an `adsAdBreakRequest` answer.
+ */
+export function adsParseAdBreak(status: number, body: string): AdBreak;
+
+/**
+ * Reads an `adsStatusRequest` answer.
+ */
+export function adsParseStatus(status: number, body: string): AdStatus;
+
+/**
+ * The channel's ads: enrolled or not, limits, recent ad breaks.
+ */
+export function adsStatusRequest(token: string, endpoints?: Endpoints | null): HttpRequest;
+
 /**
  * An app token request (client credentials).
  */
-export function appTokenRequest(client_id: string, client_secret: string, endpoints_: any): any;
+export function appTokenRequest(client_id: string, client_secret: string, endpoints?: Endpoints | null): any;
 
 /**
  * Bans a user for good.
  */
-export function banRequest(session: string, channel_slug: string, username: string, endpoints_: any): any;
+export function banRequest(session: string, channel_slug: string, username: string, endpoints?: Endpoints | null): any;
+
+/**
+ * One page of categories (`/public/v2/categories`): by `names` and `tags`
+ * (no commas in them), or by `ids`; none of them, all. `limit` is 1 to 1000
+ * (Kick's default 25); `cursor` is the previous page's `next_cursor`.
+ */
+export function categoriesRequest(token: string, names?: readonly string[] | null, tags?: readonly string[] | null, ids?: readonly number[] | null, limit?: number | null, cursor?: string | null, endpoints?: Endpoints | null): HttpRequest;
 
 /**
  * A channel by slug (`kick.com/api/v2`): chatroom id, followers, live state.
  */
-export function channelRequest(slug: string, endpoints_: any): any;
+export function channelRequest(slug: string, endpoints?: Endpoints | null): any;
 
 /**
  * A user as a channel sees them.
  */
-export function channelUserRequest(channel_slug: string, username: string, endpoints_: any): any;
+export function channelUserRequest(channel_slug: string, username: string, endpoints?: Endpoints | null): any;
 
 /**
  * `/channels` for up to 50 user ids.
  */
-export function channelsByIdsRequest(token: string, user_ids: Float64Array, endpoints_: any): any;
+export function channelsByIdsRequest(token: string, user_ids: readonly number[], endpoints?: Endpoints | null): any;
 
 /**
  * `/channels` for up to 50 slugs (one unknown slug fails them all).
  */
-export function channelsBySlugsRequest(token: string, slugs: string[], endpoints_: any): any;
+export function channelsBySlugsRequest(token: string, slugs: string[], endpoints?: Endpoints | null): any;
+
+/**
+ * Sets what is given of the token's channel's category, custom tags (`[]`
+ * clears them, up to 10) and stream title. Scope `channel:write`;
+ * `parseDone` reads the answer.
+ */
+export function channelsUpdateRequest(token: string, category_id?: number | null, custom_tags?: readonly string[] | null, stream_title?: string | null, endpoints?: Endpoints | null): HttpRequest;
 
 /**
  * The feeds for one chat, the chat feed first.
@@ -103,17 +452,51 @@ export function chatChannels(chatroom_id: number, channel_id?: number | null): s
 /**
  * Where a channel's chat is served.
  */
-export function chatConnectionRequest(channel_id: number, client_id: string, endpoints_: any): any;
+export function chatConnectionRequest(channel_id: number, client_id: string, endpoints?: Endpoints | null): any;
+
+/**
+ * Deletes a message by id. Scope `moderation:chat_message:manage`;
+ * `parseDone` reads the answer.
+ */
+export function chatDeleteRequest(token: string, message_id: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Reads a `chatSendRequest` answer.
+ */
+export function chatParseSend(status: number, body: string): Sent;
+
+/**
+ * Sends `content` as the token's user into a channel (`{user:
+ * broadcasterUserId}`) or as the app's bot (`'bot'`), as a reply if
+ * `replyToMessageId` is given. Scope `chat:write`.
+ */
+export function chatSendRequest(token: string, sender: ChatSender, content: string, reply_to_message_id?: string | null, endpoints?: Endpoints | null): HttpRequest;
 
 /**
  * Where Kick's realtime is served in general.
  */
-export function connectionRequest(client_id: string, endpoints_: any): any;
+export function connectionRequest(client_id: string, endpoints?: Endpoints | null): any;
 
 /**
  * Deletes a message.
  */
-export function deleteMessageRequest(session: string, chatroom_id: number, message_id: string, endpoints_: any): any;
+export function deleteMessageRequest(session: string, chatroom_id: number, message_id: string, endpoints?: Endpoints | null): any;
+
+/**
+ * Drops reward claims, with an **app** token. `filter`: what is left out
+ * is not filtered.
+ */
+export function dropsClaimsRequest(token: string, filter?: ClaimFilter | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Reads a `dropsClaimsRequest` answer.
+ */
+export function dropsParseClaims(status: number, body: string): Claims;
+
+/**
+ * Sets 1 to 100 claims' `external_status`; `parseDone` reads the answer.
+ */
+export function dropsUpdateClaimsRequest(token: string, updates: readonly ClaimUpdate[], endpoints?: Endpoints | null): HttpRequest;
 
 /**
  * An emote's image URL.
@@ -123,17 +506,111 @@ export function emoteUrl(id: string): string;
 /**
  * Recent chat and the pin, by channel id.
  */
-export function historyRequest(channel_id: number, endpoints_: any): any;
+export function historyRequest(channel_id: number, endpoints?: Endpoints | null): any;
+
+/**
+ * The top `top` Kicks gifters (1 to 100; Kick's default 10) of the token's
+ * own channel. A user token with `kicks:read`.
+ */
+export function kicksLeaderboardRequest(token: string, top?: number | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * How many streams are live on Kick.
+ */
+export function livestreamStatsRequest(token: string, endpoints?: Endpoints | null): HttpRequest;
 
 /**
- * `/livestreams` for any number of user ids: one request per 50.
+ * One page of the streams live now (`/public/v2/livestreams`), in up to 25
+ * categories and 25 languages (none: all). `limit` is 1 to 1000 (Kick's
+ * default 100); `cursor` is the previous page's `next_cursor`. Kick has no
+ * sort: streams come oldest first.
  */
-export function livestreamsRequests(token: string, user_ids: Float64Array, endpoints_: any): any;
+export function livestreamsPageRequest(token: string, category_ids?: readonly number[] | null, language_codes?: readonly string[] | null, limit?: number | null, cursor?: string | null, endpoints?: Endpoints | null): any;
+
+/**
+ * `/public/v1/users/livestreams` for any number of user ids: one request
+ * per 100.
+ */
+export function livestreamsRequests(token: string, user_ids: readonly number[], endpoints?: Endpoints | null): any;
 
 /**
  * The signed-in viewer's standing on a channel.
  */
-export function meRequest(session: string, channel_slug: string, endpoints_: any): any;
+export function meRequest(session: string, channel_slug: string, endpoints?: Endpoints | null): any;
+
+/**
+ * Bans a user for good. Scope `moderation:ban`; `parseDone` reads the answer.
+ */
+export function moderationBanRequest(token: string, broadcaster_user_id: number, user_id: number, reason?: string | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Times a user out for 1 to 10080 minutes. Scope `moderation:ban`.
+ */
+export function moderationTimeoutRequest(token: string, broadcaster_user_id: number, user_id: number, minutes: number, reason?: string | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Lifts a ban or a timeout. Scope `moderation:ban`.
+ */
+export function moderationUnbanRequest(token: string, broadcaster_user_id: number, user_id: number, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Where to send the user's browser to approve the app. `state` (from
+ * `newState()`) must come back unchanged on the redirect; `verifier` is the
+ * `Pkce`'s.
+ */
+export function oauthAuthorizeUrl(client_id: string, redirect_uri: string, scopes: readonly Scope[], state: string, verifier: string, endpoints?: Endpoints | null): string;
+
+/**
+ * A user token for the `code` on the redirect, with the PKCE verifier.
+ */
+export function oauthCodeRequest(client_id: string, client_secret: string, redirect_uri: string, code: string, code_verifier: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Asks Kick about the token it is sent with (a user or an app token).
+ */
+export function oauthIntrospectRequest(token: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Reads an `oauthIntrospectRequest` answer.
+ */
+export function oauthParseIntrospect(status: number, body: string): Introspection;
+
+/**
+ * Whether a revoke worked; throws with `status` if not.
+ */
+export function oauthParseRevoke(status: number, body: string): void;
+
+/**
+ * Reads an `oauthCodeRequest` or `oauthRefreshRequest` answer.
+ */
+export function oauthParseUserToken(status: number, body: string): UserToken;
+
+/**
+ * A PKCE pair from 32 to 96 bytes drawn from a CSPRNG (`newPkce()` draws
+ * them). The verifier is a secret: keep it, never log it.
+ */
+export function oauthPkce(random: Uint8Array): Pkce;
+
+/**
+ * The PKCE pair for a verifier kept from before (43 to 128 characters of
+ * `A-Z a-z 0-9 - . _ ~`).
+ */
+export function oauthPkceFromVerifier(verifier: string): Pkce;
+
+/**
+ * A new user token (and refresh token) for a refresh token.
+ */
+export function oauthRefreshRequest(client_id: string, client_secret: string, refresh_token: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Revokes a token. It goes in the URL: keep the URL out of logs.
+ */
+export function oauthRevokeRequest(token: string, token_type_hint?: TokenTypeHint | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Every scope Kick documents.
+ */
+export function oauthScopes(): Scope[];
 
 /**
  * Whether an acting call worked; throws with `status` if not.
@@ -145,6 +622,11 @@ export function parseAction(status: number, body: string): void;
  */
 export function parseAppToken(status: number, body: string): any;
 
+/**
+ * Reads a `categoriesRequest` answer: `{data, next_cursor}`.
+ */
+export function parseCategories(status: number, body: string): Page<Category>;
+
 /**
  * Reads a website channel answer.
  */
@@ -170,6 +652,12 @@ export function parseConnection(status: number, body: string): any;
  */
 export function parseContent(text: string, combine: boolean): any;
 
+/**
+ * Whether a user-token call whose answer carries nothing worked (any 2xx);
+ * throws with `status` if not.
+ */
+export function parseDone(status: number, body: string): void;
+
 /**
  * A feed event, typed: `{type: "chat_message", …}`. `data` as Kick sent it.
  */
@@ -181,10 +669,25 @@ export function parseEvent(name: string, data: any): any;
 export function parseHistory(status: number, body: string): any;
 
 /**
- * Reads a `/livestreams` answer.
+ * Reads a `kicksLeaderboardRequest` answer.
+ */
+export function parseKicksLeaderboard(status: number, body: string): KicksLeaderboard;
+
+/**
+ * Reads a `livestreamStatsRequest` answer.
+ */
+export function parseLivestreamStats(status: number, body: string): LivestreamStats;
+
+/**
+ * Reads a `livestreamsRequests` answer (or a page's streams alone).
  */
 export function parseLivestreams(status: number, body: string): any;
 
+/**
+ * Reads a `livestreamsPageRequest` answer: `{data, next_cursor}`.
+ */
+export function parseLivestreamsPage(status: number, body: string): any;
+
 /**
  * Reads a `me` answer.
  */
@@ -205,73 +708,158 @@ export function parseSubscriptions(status: number, body: string): any;
  */
 export function parseToken(status: number, body: string): string;
 
+/**
+ * Reads a `usersRequest` answer.
+ */
+export function parseUsers(status: number, body: string): User[];
+
 /**
  * Reads a delivery's body by its type header, without checking anything.
+ * Throws when the body is not that type's shape. `body` is text or bytes.
  */
-export function parseWebhook(event_type: string, body: string): any;
+export function parseWebhook(event_type: string, body: string | Uint8Array | ArrayBuffer): any;
 
 /**
- * Pins a message (the feed's data for it, whole) for `minutes`.
+ * Pins a message (the feed's data for it, whole) for 1 to 10080 minutes.
  */
-export function pinRequest(session: string, channel_slug: string, message: any, minutes: number, endpoints_: any): any;
+export function pinRequest(session: string, channel_slug: string, message: any, minutes: number, endpoints?: Endpoints | null): any;
 
 /**
  * The webhook signing key request.
  */
-export function publicKeyRequest(endpoints_: any): any;
+export function publicKeyRequest(endpoints?: Endpoints | null): any;
+
+/**
+ * The least to wait, ms, before reconnecting after the socket closed with
+ * this code: 300000 (5 minutes) for Kick's terminal codes (3500-3999 and
+ * 4500-4999: a bad token, a ban, a refused request), then reconnect with a
+ * new client id; 0, the ordinary backoff, for the rest (1006, a network
+ * drop, among them).
+ */
+export function retryAfterMs(code: number): number;
+
+/**
+ * Accepts 1 to 25 pending redemptions; `rewardsParseFailures` reads the
+ * answer.
+ */
+export function rewardsAcceptRequest(token: string, ids: readonly string[], endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Creates a reward: `fields` needs `title` and `cost`.
+ */
+export function rewardsCreateRequest(token: string, fields: RewardFields, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Deletes reward `id`; `parseDone` reads the answer.
+ */
+export function rewardsDeleteRequest(token: string, id: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Every channel-points reward of the token's channel.
+ */
+export function rewardsListRequest(token: string, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * The redemptions an accept or reject failed for; empty is all done.
+ */
+export function rewardsParseFailures(status: number, body: string): FailedRedemption[];
+
+/**
+ * Reads a `rewardsRedemptionsRequest` or `rewardsRedemptionsByIdsRequest`
+ * answer.
+ */
+export function rewardsParseRedemptions(status: number, body: string): RedemptionPage;
+
+/**
+ * Reads a `rewardsCreateRequest` or `rewardsUpdateRequest` answer.
+ */
+export function rewardsParseReward(status: number, body: string): Reward;
+
+/**
+ * Reads a `rewardsListRequest` answer.
+ */
+export function rewardsParseRewards(status: number, body: string): Reward[];
+
+/**
+ * Redemptions by id, whatever their status.
+ */
+export function rewardsRedemptionsByIdsRequest(token: string, ids: readonly string[], cursor?: string | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Redemptions, grouped by reward: of one reward or all, with one `status`
+ * (Kick's default `'pending'`), from `cursor`.
+ */
+export function rewardsRedemptionsRequest(token: string, reward_id?: string | null, status?: RedemptionStatus | null, cursor?: string | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Rejects 1 to 25 pending redemptions; `rewardsParseFailures` reads the
+ * answer.
+ */
+export function rewardsRejectRequest(token: string, ids: readonly string[], endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Changes what `fields` sets of reward `id`.
+ */
+export function rewardsUpdateRequest(token: string, id: string, fields: RewardFields, endpoints?: Endpoints | null): HttpRequest;
 
 /**
  * Sends a message, or a reply when `replyTo` is
  * `{message_id, content, sender_id, sender_username}`.
  */
-export function sendRequest(session: string, chatroom_id: number, text: string, message_ref: string, reply_to: any, endpoints_: any): any;
+export function sendRequest(session: string, chatroom_id: number, text: string, message_ref: string, reply_to?: ReplyTo | null, endpoints?: Endpoints | null): any;
 
 /**
- * Subscribes the app to webhook `events` (`[{name, version}]`) for one channel.
+ * Subscribes the app to webhook `events` (`[{name, version?}]`, version 1
+ * when left out) for one channel.
  */
-export function subscribeRequest(token: string, broadcaster_user_id: number, events: any, endpoints_: any): any;
+export function subscribeRequest(token: string, broadcaster_user_id: number, events: ReadonlyArray<{ name: string; version?: number }>, endpoints?: Endpoints | null): any;
 
 /**
  * Every webhook subscription the app has.
  */
-export function subscriptionsRequest(token: string, endpoints_: any): any;
+export function subscriptionsRequest(token: string, endpoints?: Endpoints | null): any;
 
 /**
- * Times a user out.
+ * Times a user out for 1 to 10080 minutes.
  */
-export function timeoutRequest(session: string, channel_slug: string, username: string, minutes: number, endpoints_: any): any;
+export function timeoutRequest(session: string, channel_slug: string, username: string, minutes: number, endpoints?: Endpoints | null): any;
 
 /**
  * A guest token request for `clientId`.
  */
-export function tokenRequest(client_id: string, endpoints_: any): any;
-
-/**
- * The top live streams, overall or in a category or language: up to 100.
- * `sort` is `"viewer_count"` (the default) or `"started_at"`.
- */
-export function topLivestreamsRequest(token: string, category_id: number | null | undefined, language: string | null | undefined, sort: string | null | undefined, limit: number | null | undefined, endpoints_: any): any;
+export function tokenRequest(client_id: string, endpoints?: Endpoints | null): any;
 
 /**
  * Lifts a ban or timeout.
  */
-export function unbanRequest(session: string, channel_slug: string, username: string, endpoints_: any): any;
+export function unbanRequest(session: string, channel_slug: string, username: string, endpoints?: Endpoints | null): any;
 
 /**
  * Removes the pin.
  */
-export function unpinRequest(session: string, channel_slug: string, endpoints_: any): any;
+export function unpinRequest(session: string, channel_slug: string, endpoints?: Endpoints | null): any;
 
 /**
  * Removes subscriptions, 50 per request.
  */
-export function unsubscribeRequests(token: string, ids: string[], endpoints_: any): any;
+export function unsubscribeRequests(token: string, ids: string[], endpoints?: Endpoints | null): any;
 
 /**
- * Checks a delivery: `headers` as `[[name, value]…]` or an object, `body` the
- * raw text. Returns the typed event, or throws.
+ * Users by id, up to 50; none, with a user token: the token's own user.
+ */
+export function usersRequest(token: string, user_ids?: readonly number[] | null, endpoints?: Endpoints | null): HttpRequest;
+
+/**
+ * Checks a delivery and returns `{headers, event}`, or throws. `headers` as
+ * `[[name, value]…]`, a fetch `Headers` or an object; `body` the raw body,
+ * as text or bytes. The timestamp must be within 5 minutes of this
+ * machine's clock, unless `options` says otherwise: `now` (Unix seconds),
+ * `toleranceSecs`, or `skipFreshness: true` to re-check a stored delivery.
+ *
+ * A receiver checking many deliveries reads the key once, with
+ * `new WebhookPublicKey(pem)`, and calls its `verify`.
  */
-export function verifyWebhook(public_key_pem: string, headers: any, body: string): any;
+export function verifyWebhook(public_key_pem: string, headers: WebhookHeaders, body: string | Uint8Array | ArrayBuffer, options?: VerifyOptions | null): VerifiedWebhook;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
@@ -279,68 +867,118 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_backoff_free: (a: number, b: number) => void;
     readonly __wbg_session_free: (a: number, b: number) => void;
-    readonly appTokenRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly backoff_new: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbg_webhookpublickey_free: (a: number, b: number) => void;
+    readonly adsAdBreakRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly adsEnrollRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly adsParseAdBreak: (a: number, b: number, c: number, d: number) => void;
+    readonly adsParseStatus: (a: number, b: number, c: number, d: number) => void;
+    readonly adsStatusRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly appTokenRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly backoff_new: (a: number, b: number, c: number) => void;
     readonly backoff_nextDelay: (a: number) => number;
+    readonly backoff_nextDelayFor: (a: number, b: number, c: number, d: number) => void;
+    readonly backoff_nextDelayJittered: (a: number, b: number, c: number) => void;
     readonly backoff_reset: (a: number) => void;
-    readonly banRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
-    readonly channelRequest: (a: number, b: number, c: any) => [number, number, number];
-    readonly channelUserRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly channelsByIdsRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly channelsBySlugsRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly chatChannels: (a: number, b: number, c: number) => [number, number];
-    readonly chatConnectionRequest: (a: number, b: number, c: number, d: any) => [number, number, number];
-    readonly connectionRequest: (a: number, b: number, c: any) => [number, number, number];
-    readonly deleteMessageRequest: (a: number, b: number, c: number, d: number, e: number, f: any) => [number, number, number];
-    readonly emoteUrl: (a: number, b: number) => [number, number];
-    readonly historyRequest: (a: number, b: any) => [number, number, number];
-    readonly livestreamsRequests: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly meRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly parseAction: (a: number, b: number, c: number) => [number, number];
-    readonly parseAppToken: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseChannel: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseChannelUser: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseChannels: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseConnection: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseContent: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseEvent: (a: number, b: number, c: any) => [number, number, number];
-    readonly parseHistory: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseLivestreams: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseMe: (a: number, b: number, c: number) => [number, number, number];
-    readonly parsePublicKey: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly parseSubscriptions: (a: number, b: number, c: number) => [number, number, number];
-    readonly parseToken: (a: number, b: number, c: number) => [number, number, number, number];
-    readonly parseWebhook: (a: number, b: number, c: number, d: number) => [number, number, number];
-    readonly pinRequest: (a: number, b: number, c: number, d: number, e: any, f: number, g: any) => [number, number, number];
-    readonly publicKeyRequest: (a: any) => [number, number, number];
-    readonly sendRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: any, i: any) => [number, number, number];
-    readonly session_closed: (a: number) => [number, number, number];
-    readonly session_deadline: (a: number) => [number, number];
+    readonly banRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly categoriesRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly channelRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly channelUserRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly channelsByIdsRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly channelsBySlugsRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly channelsUpdateRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly chatChannels: (a: number, b: number, c: number) => void;
+    readonly chatConnectionRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly chatDeleteRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly chatParseSend: (a: number, b: number, c: number, d: number) => void;
+    readonly chatSendRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly connectionRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly deleteMessageRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly dropsClaimsRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly dropsParseClaims: (a: number, b: number, c: number, d: number) => void;
+    readonly dropsUpdateClaimsRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly emoteUrl: (a: number, b: number, c: number) => void;
+    readonly historyRequest: (a: number, b: number, c: number) => void;
+    readonly kicksLeaderboardRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly livestreamStatsRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly livestreamsPageRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly livestreamsRequests: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly meRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly moderationBanRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly moderationTimeoutRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly moderationUnbanRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly oauthAuthorizeUrl: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+    readonly oauthCodeRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
+    readonly oauthIntrospectRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly oauthParseIntrospect: (a: number, b: number, c: number, d: number) => void;
+    readonly oauthParseRevoke: (a: number, b: number, c: number, d: number) => void;
+    readonly oauthParseUserToken: (a: number, b: number, c: number, d: number) => void;
+    readonly oauthPkce: (a: number, b: number) => void;
+    readonly oauthPkceFromVerifier: (a: number, b: number, c: number) => void;
+    readonly oauthRefreshRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly oauthRevokeRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly oauthScopes: (a: number) => void;
+    readonly parseAction: (a: number, b: number, c: number, d: number) => void;
+    readonly parseAppToken: (a: number, b: number, c: number, d: number) => void;
+    readonly parseCategories: (a: number, b: number, c: number, d: number) => void;
+    readonly parseChannel: (a: number, b: number, c: number, d: number) => void;
+    readonly parseChannelUser: (a: number, b: number, c: number, d: number) => void;
+    readonly parseChannels: (a: number, b: number, c: number, d: number) => void;
+    readonly parseConnection: (a: number, b: number, c: number, d: number) => void;
+    readonly parseContent: (a: number, b: number, c: number, d: number) => void;
+    readonly parseDone: (a: number, b: number, c: number, d: number) => void;
+    readonly parseEvent: (a: number, b: number, c: number, d: number) => void;
+    readonly parseHistory: (a: number, b: number, c: number, d: number) => void;
+    readonly parseKicksLeaderboard: (a: number, b: number, c: number, d: number) => void;
+    readonly parseLivestreamStats: (a: number, b: number, c: number, d: number) => void;
+    readonly parseLivestreams: (a: number, b: number, c: number, d: number) => void;
+    readonly parseLivestreamsPage: (a: number, b: number, c: number, d: number) => void;
+    readonly parseMe: (a: number, b: number, c: number, d: number) => void;
+    readonly parsePublicKey: (a: number, b: number, c: number, d: number) => void;
+    readonly parseSubscriptions: (a: number, b: number, c: number, d: number) => void;
+    readonly parseToken: (a: number, b: number, c: number, d: number) => void;
+    readonly parseUsers: (a: number, b: number, c: number, d: number) => void;
+    readonly parseWebhook: (a: number, b: number, c: number, d: number) => void;
+    readonly pinRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly publicKeyRequest: (a: number, b: number) => void;
+    readonly retryAfterMs: (a: number, b: number) => void;
+    readonly rewardsAcceptRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly rewardsCreateRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly rewardsDeleteRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly rewardsListRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly rewardsParseFailures: (a: number, b: number, c: number, d: number) => void;
+    readonly rewardsParseRedemptions: (a: number, b: number, c: number, d: number) => void;
+    readonly rewardsParseReward: (a: number, b: number, c: number, d: number) => void;
+    readonly rewardsParseRewards: (a: number, b: number, c: number, d: number) => void;
+    readonly rewardsRedemptionsByIdsRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly rewardsRedemptionsRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly rewardsRejectRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly rewardsUpdateRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly sendRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly session_closed: (a: number, b: number) => void;
+    readonly session_deadline: (a: number, b: number) => void;
     readonly session_isConnected: (a: number) => number;
     readonly session_isSubscribed: (a: number, b: number, c: number) => number;
     readonly session_new: (a: number, b: number) => number;
-    readonly session_open: (a: number, b: number, c: number, d: number) => [number, number, number];
-    readonly session_receive: (a: number, b: number, c: number, d: number) => [number, number, number];
-    readonly session_refresh: (a: number, b: number, c: number, d: number) => [number, number, number];
-    readonly session_tick: (a: number, b: number) => [number, number, number];
-    readonly subscribeRequest: (a: number, b: number, c: number, d: any, e: any) => [number, number, number];
-    readonly subscriptionsRequest: (a: number, b: number, c: any) => [number, number, number];
-    readonly timeoutRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: any) => [number, number, number];
-    readonly tokenRequest: (a: number, b: number, c: any) => [number, number, number];
-    readonly topLivestreamsRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: any) => [number, number, number];
-    readonly unbanRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
-    readonly unpinRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly unsubscribeRequests: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
-    readonly verifyWebhook: (a: number, b: number, c: any, d: number, e: number) => [number, number, number];
-    readonly __wbindgen_malloc: (a: number, b: number) => number;
-    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-    readonly __wbindgen_exn_store: (a: number) => void;
-    readonly __externref_table_alloc: () => number;
-    readonly __wbindgen_externrefs: WebAssembly.Table;
-    readonly __externref_table_dealloc: (a: number) => void;
-    readonly __externref_drop_slice: (a: number, b: number) => void;
-    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
-    readonly __wbindgen_start: () => void;
+    readonly session_open: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly session_receive: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly session_refresh: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly session_tick: (a: number, b: number, c: number) => void;
+    readonly subscribeRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly subscriptionsRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly timeoutRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly tokenRequest: (a: number, b: number, c: number, d: number) => void;
+    readonly unbanRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+    readonly unpinRequest: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly unsubscribeRequests: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly usersRequest: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly verifyWebhook: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly webhookpublickey_new: (a: number, b: number, c: number) => void;
+    readonly webhookpublickey_verify: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+    readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;