@myronsi/messenger-api 2.1.0-alpha.1 → 2.1.0-alpha.10

package/dist/schema.d.ts

@@ -1,4 +1,4 @@
-/* Generated from api/openapi.yaml 2.1.0-alpha.1. Do not edit. */
+/* Generated from api/openapi.yaml 2.1.0-alpha.10. Do not edit. */
 export interface paths {
     "/meta": {
         parameters: {
@@ -328,6 +328,36 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/me/avatars/{avatar_id}": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Version of the client app, for logs and the per-client metric. */
+                "X-Client-Version"?: components["parameters"]["ClientVersion"];
+                /** @description Contract version the client was built with (`API_VERSION` of `@myronsi/messenger-api`). A different MAJOR or a version below `min_client_api_version` is answered with `426`; a malformed value with `400` (`invalid_client_version`). */
+                "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
+            };
+            path: {
+                /** @description `id` of an `AvatarVersion` of the caller. */
+                avatar_id: components["schemas"]["Id"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete one of your avatars
+         * @description Removes the avatar from your history. When it is the current one, the newest remaining avatar becomes
+         *     current again; without one you get the default avatar. The image is deleted from storage once nothing
+         *     uses it any more.
+         */
+        delete: operations["deleteMyAvatar"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/me/password": {
         parameters: {
             query?: never;
@@ -531,7 +561,7 @@ export interface paths {
                 "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
             };
             path: {
-                setting_key: "avatar_visibility" | "profile_visibility" | "presence_visibility" | "group_invites";
+                setting_key: "avatar_visibility" | "profile_visibility" | "presence_visibility" | "group_invites" | "direct_messages" | "search_visibility";
                 effect: "allow" | "deny";
             };
             cookie?: never;
@@ -630,7 +660,12 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Profile by username */
+        /**
+         * Profile by username
+         * @description Like `GET /users/{user_id}`: a user whose `search_visibility` hides them from the current user (`nobody`
+         *     without an `allow` exception, or a `deny` exception) is `404` unless the two share a chat. Lookups are
+         *     rate limited per user.
+         */
         get: operations["getUserByUsername"];
         put?: never;
         post?: never;
@@ -654,7 +689,12 @@ export interface paths {
             };
             cookie?: never;
         };
-        /** Profile by ID */
+        /**
+         * Profile by ID
+         * @description A user whose `search_visibility` hides them from the current user (`nobody` without an `allow` exception,
+         *     or a `deny` exception) is `404` unless the two share a chat. Your own profile is always found. Lookups are
+         *     rate limited per user.
+         */
         get: operations["getUser"];
         put?: never;
         post?: never;
@@ -681,7 +721,9 @@ export interface paths {
         /**
          * Current avatar image
          * @description Respects the avatar visibility of the user; falls back to the default avatar. With `version`, an
-         *     earlier avatar of the history (`AvatarVersion.url`).
+         *     earlier avatar of the history (`AvatarVersion.url`). `avatar_url` carries `rev`, the revision of the
+         *     current avatar: while it matches, the answer may be cached for a year (`immutable`), because a new
+         *     avatar gets a new `rev` and so a new URL.
          */
         get: operations["getUserAvatar"];
         put?: never;
@@ -731,7 +773,11 @@ export interface paths {
             cookie?: never;
         };
         get?: never;
-        /** Set your own display name for a user */
+        /**
+         * Set your own display name for a user
+         * @description Follows the rules of `GET /users/{user_id}`: a user whose `search_visibility` hides them from you is `404`
+         *     unless the two of you share a chat, and the calls count against the same per-user limit.
+         */
         put: operations["setContactName"];
         post?: never;
         /** Remove your display name for a user */
@@ -1029,7 +1075,10 @@ export interface paths {
         delete: operations["deleteMessage"];
         options?: never;
         head?: never;
-        /** Edit your text message */
+        /**
+         * Edit your text message or the caption of your file
+         * @description An empty `content` removes the caption of a file message; a text message needs at least one character.
+         */
         patch: operations["editMessage"];
         trace?: never;
     };
@@ -1057,6 +1106,64 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/chats/{chat_id}/messages/forward": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Version of the client app, for logs and the per-client metric. */
+                "X-Client-Version"?: components["parameters"]["ClientVersion"];
+                /** @description Contract version the client was built with (`API_VERSION` of `@myronsi/messenger-api`). A different MAJOR or a version below `min_client_api_version` is answered with `426`; a malformed value with `400` (`invalid_client_version`). */
+                "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
+            };
+            path: {
+                chat_id: components["parameters"]["ChatId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Forward several messages of a chat to other chats
+         * @description Copies up to 20 messages of the chat, oldest first, into every target chat, at most 20 copies in all. Every
+         *     copy counts against the sender's message rate. Every message and target is checked before anything is
+         *     written, so a refused one forwards nothing.
+         */
+        post: operations["forwardMessages"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/chats/{chat_id}/messages/delete": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Version of the client app, for logs and the per-client metric. */
+                "X-Client-Version"?: components["parameters"]["ClientVersion"];
+                /** @description Contract version the client was built with (`API_VERSION` of `@myronsi/messenger-api`). A different MAJOR or a version below `min_client_api_version` is answered with `426`; a malformed value with `400` (`invalid_client_version`). */
+                "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
+            };
+            path: {
+                chat_id: components["parameters"]["ChatId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Delete several messages of a chat
+         * @description Deletes up to 100 messages of the chat with the rules of `DELETE /messages/{message_id}`. Every message
+         *     is checked first: when one may not be deleted, none is. With `scope` everyone, messages that are already
+         *     deleted for everyone count as done, so a retry after a partial failure finishes the rest.
+         */
+        post: operations["deleteMessages"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/search/messages": {
         parameters: {
             query?: never;
@@ -1340,10 +1447,187 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/me/notifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Notification preferences and supported push platforms */
+        get: operations["getNotificationSettings"];
+        /** Replace notification preferences */
+        put: operations["updateNotificationSettings"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/avatar/{token}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description `avatar_token` of a push notification. */
+                token: string;
+            };
+            cookie?: never;
+        };
+        /**
+         * Sender avatar for a push notification
+         * @description For the service worker, which has no session: the token in the push payload names the recipient
+         *     and the sender and expires after an hour. Follows the sender's avatar visibility for the recipient.
+         */
+        get: operations["getNotificationAvatar"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/notifications/read/{token}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description `read_token` of a push notification. */
+                token: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark a chat read from a push notification
+         * @description For the notification's "Mark as read" action: marks the chat read up to the notified message for
+         *     the recipient the token names. The token expires after seven days.
+         */
+        post: operations["markNotificationRead"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/me/notification-devices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Register a push destination for the current session */
+        post: operations["registerNotificationDevice"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/me/notification-devices/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Unregister a push destination for the current session */
+        delete: operations["deleteNotificationDevice"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/chats/{chatId}/notification-mute": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                chatId: components["schemas"]["Id"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        /** Mute or unmute a chat */
+        put: operations["setNotificationMute"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/me/notification-devices/{id}/activity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        /** Report a visible client with a healthy live connection */
+        put: operations["updateNotificationActivity"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        NotificationPreferences: {
+            enabled: boolean;
+            sound: boolean;
+            previews: boolean;
+        };
+        NotificationSettings: {
+            preferences: components["schemas"]["NotificationPreferences"];
+            mutes: {
+                chat_id: components["schemas"]["Id"];
+                /** Format: date-time */
+                until: string;
+            }[];
+            web_push: boolean;
+            android_push: boolean;
+            ios_push: boolean;
+            vapid_public_key: string;
+        };
+        NotificationDeviceRequest: {
+            /** @enum {string} */
+            platform: "web" | "android" | "ios";
+            destination: string;
+            p256dh?: string;
+            auth?: string;
+        };
+        NotificationDeviceRegistered: {
+            /** Format: uuid */
+            id: string;
+        };
+        NotificationMuteRequest: {
+            /** @enum {string} */
+            duration: "off" | "1h" | "8h" | "forever";
+        };
+        NotificationActivity: {
+            active: boolean;
+            /** Format: uuid */
+            client_id: string;
+        };
         /**
          * @description Decimal ID as a string (Snowflake IDs exceed 2^53).
          * @example 7217400317439950848
@@ -1530,7 +1814,8 @@ export interface components {
             code: string;
         };
         /**
-         * @description Who may see the item. `*_except` scopes use the exception lists.
+         * @description Who may see the item. The exception lists apply to every value; `*_except` behave like `everyone` and `nobody`.
+         *     `contacts` are the users you share a group with, or a direct chat that you opened or read in.
          * @enum {string}
          */
         Visibility: "everyone" | "contacts" | "everyone_except" | "nobody_except" | "nobody";
@@ -1540,7 +1825,7 @@ export interface components {
         GroupInvitePolicy: "everyone" | "contacts" | "everyone_except" | "nobody_except" | "nobody" | "wait_approval";
         /** @enum {string} */
         SearchVisibility: "everyone" | "nobody";
-        /** @description User IDs per setting; `allow` applies to `nobody_except`, `deny` to `everyone_except`. */
+        /** @description User IDs per setting. An exception wins over the setting whatever its value; `allow` always lets the user in, `deny` always keeps them out. */
         PrivacyExceptions: {
             [key: string]: {
                 allow: components["schemas"]["Id"][];
@@ -1576,7 +1861,7 @@ export interface components {
             display_name: string;
             /** @description The requesting user's own name for this user, if set. */
             contact_name?: string | null;
-            /** @description Path of the avatar, always same-origin (`/api/v2/users/{id}/avatar`). */
+            /** @description Path of the avatar, always same-origin (`/api/v2/users/{id}/avatar?rev={revision}`). */
             avatar_url: string | null;
             bio: string | null;
             is_online: boolean;
@@ -1646,6 +1931,20 @@ export interface components {
             sender_id: components["schemas"]["Id"] | null;
             sender_name: string;
         };
+        /**
+         * @description What a reply shows of the message it answers, so a client can draw the quote without loading that
+         *     message. Set on messages of history pages and `message` events when the recipient can see the answered
+         *     message; absent when it is gone or hidden for them, and on chat-list previews and search results.
+         */
+        ReplyPreview: {
+            id: components["schemas"]["Id"];
+            type: components["schemas"]["MessageType"];
+            sender: components["schemas"]["User"] | null;
+            /** @description The first 100 characters of the text or caption; `null` when deleted or empty. */
+            content: string | null;
+            attachment: components["schemas"]["Attachment"] | null;
+            is_deleted: boolean;
+        };
         Message: {
             id: components["schemas"]["Id"];
             chat_id: components["schemas"]["Id"];
@@ -1656,6 +1955,7 @@ export interface components {
             content: string | null;
             attachment: components["schemas"]["Attachment"] | null;
             reply_to: components["schemas"]["Id"] | null;
+            reply_preview?: components["schemas"]["ReplyPreview"];
             forwarded_from: components["schemas"]["ForwardedFrom"] | null;
             reactions: components["schemas"]["Reaction"][];
             read_by: components["schemas"]["ReadReceipt"][];
@@ -1699,11 +1999,21 @@ export interface components {
             reply_to?: components["schemas"]["Id"] | null;
         };
         EditMessageRequest: {
+            /** @description New text, or the new caption of a file. Empty removes a file's caption; a text message rejects it. */
             content: string;
         };
         ForwardMessageRequest: {
             chat_ids: components["schemas"]["Id"][];
         };
+        ForwardMessagesRequest: {
+            message_ids: components["schemas"]["Id"][];
+            chat_ids: components["schemas"]["Id"][];
+        };
+        DeleteMessagesRequest: {
+            message_ids: components["schemas"]["Id"][];
+            /** @enum {string} */
+            scope: "me" | "everyone";
+        };
         MarkReadRequest: {
             /** @description Everything up to and including this message is read. */
             message_id: components["schemas"]["Id"];
@@ -2443,6 +2753,38 @@ export interface operations {
             426: components["responses"]["ClientOutdated"];
         };
     };
+    deleteMyAvatar: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Version of the client app, for logs and the per-client metric. */
+                "X-Client-Version"?: components["parameters"]["ClientVersion"];
+                /** @description Contract version the client was built with (`API_VERSION` of `@myronsi/messenger-api`). A different MAJOR or a version below `min_client_api_version` is answered with `426`; a malformed value with `400` (`invalid_client_version`). */
+                "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
+            };
+            path: {
+                /** @description `id` of an `AvatarVersion` of the caller. */
+                avatar_id: components["schemas"]["Id"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Updated user */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Me"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            426: components["responses"]["ClientOutdated"];
+        };
+    };
     changePassword: {
         parameters: {
             query?: never;
@@ -2794,7 +3136,7 @@ export interface operations {
                 "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
             };
             path: {
-                setting_key: "avatar_visibility" | "profile_visibility" | "presence_visibility" | "group_invites";
+                setting_key: "avatar_visibility" | "profile_visibility" | "presence_visibility" | "group_invites" | "direct_messages" | "search_visibility";
                 effect: "allow" | "deny";
             };
             cookie?: never;
@@ -2976,6 +3318,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             404: components["responses"]["NotFound"];
             426: components["responses"]["ClientOutdated"];
+            429: components["responses"]["TooManyRequests"];
         };
     };
     getUser: {
@@ -3007,6 +3350,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             404: components["responses"]["NotFound"];
             426: components["responses"]["ClientOutdated"];
+            429: components["responses"]["TooManyRequests"];
         };
     };
     getUserAvatar: {
@@ -3014,6 +3358,8 @@ export interface operations {
             query?: {
                 /** @description `id` of an `AvatarVersion` of this user. */
                 version?: components["schemas"]["Id"];
+                /** @description Revision of the current avatar, as given in `avatar_url`. */
+                rev?: string;
             };
             header?: {
                 /** @description Version of the client app, for logs and the per-client metric. */
@@ -3139,6 +3485,7 @@ export interface operations {
             404: components["responses"]["NotFound"];
             422: components["responses"]["ValidationFailed"];
             426: components["responses"]["ClientOutdated"];
+            429: components["responses"]["TooManyRequests"];
         };
     };
     removeContactName: {
@@ -3789,24 +4136,99 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
-    searchAllMessages: {
+    forwardMessages: {
         parameters: {
-            query: {
-                q: string;
-                /** @description Only this chat */
-                chat_id?: components["schemas"]["Id"];
-                /** @description Only messages of this user */
-                sender_id?: components["schemas"]["Id"];
-                type?: "text" | "file" | "voice";
-                /** @description Messages created at or after this time */
-                from?: components["schemas"]["Timestamp"];
-                /** @description Messages created before this time */
-                to?: components["schemas"]["Timestamp"];
-                /** @description Page size */
-                limit?: components["parameters"]["Limit"];
-                /** @description Opaque `next_cursor` of the previous page */
-                after?: components["parameters"]["After"];
-            };
+            query?: never;
+            header?: {
+                /** @description Version of the client app, for logs and the per-client metric. */
+                "X-Client-Version"?: components["parameters"]["ClientVersion"];
+                /** @description Contract version the client was built with (`API_VERSION` of `@myronsi/messenger-api`). A different MAJOR or a version below `min_client_api_version` is answered with `426`; a malformed value with `400` (`invalid_client_version`). */
+                "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
+            };
+            path: {
+                chat_id: components["parameters"]["ChatId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ForwardMessagesRequest"];
+            };
+        };
+        responses: {
+            /** @description The new messages, per target chat oldest first */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        items: components["schemas"]["Message"][];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["ValidationFailed"];
+            426: components["responses"]["ClientOutdated"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    deleteMessages: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Version of the client app, for logs and the per-client metric. */
+                "X-Client-Version"?: components["parameters"]["ClientVersion"];
+                /** @description Contract version the client was built with (`API_VERSION` of `@myronsi/messenger-api`). A different MAJOR or a version below `min_client_api_version` is answered with `426`; a malformed value with `400` (`invalid_client_version`). */
+                "X-Client-Api-Version"?: components["parameters"]["ClientApiVersion"];
+            };
+            path: {
+                chat_id: components["parameters"]["ChatId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteMessagesRequest"];
+            };
+        };
+        responses: {
+            /** @description Deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["ValidationFailed"];
+            426: components["responses"]["ClientOutdated"];
+        };
+    };
+    searchAllMessages: {
+        parameters: {
+            query: {
+                q: string;
+                /** @description Only this chat */
+                chat_id?: components["schemas"]["Id"];
+                /** @description Only messages of this user */
+                sender_id?: components["schemas"]["Id"];
+                type?: "text" | "file" | "voice";
+                /** @description Messages created at or after this time */
+                from?: components["schemas"]["Timestamp"];
+                /** @description Messages created before this time */
+                to?: components["schemas"]["Timestamp"];
+                /** @description Page size */
+                limit?: components["parameters"]["Limit"];
+                /** @description Opaque `next_cursor` of the previous page */
+                after?: components["parameters"]["After"];
+            };
             header?: {
                 /** @description Version of the client app, for logs and the per-client metric. */
                 "X-Client-Version"?: components["parameters"]["ClientVersion"];
@@ -4311,4 +4733,238 @@ export interface operations {
             426: components["responses"]["ClientOutdated"];
         };
     };
+    getNotificationSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Notification settings or registered device */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationSettings"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    updateNotificationSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["NotificationPreferences"];
+            };
+        };
+        responses: {
+            /** @description Saved */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    getNotificationAvatar: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description `avatar_token` of a push notification. */
+                token: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Image */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "image/*": string;
+                };
+            };
+            /** @description The requested byte range (`Range` header) */
+            206: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "image/*": string;
+                };
+            };
+            /** @description Redirect to a short-lived signed storage URL (with `MEDIA_SIGNED_URLS`) */
+            302: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not modified (`If-None-Match` with the `ETag` of an earlier answer) */
+            304: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+            /** @description The requested range is outside the file */
+            416: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    markNotificationRead: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description `read_token` of a push notification. */
+                token: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Marked as read */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    registerNotificationDevice: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["NotificationDeviceRequest"];
+            };
+        };
+        responses: {
+            /** @description Notification settings or registered device */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationDeviceRegistered"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    deleteNotificationDevice: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    setNotificationMute: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                chatId: components["schemas"]["Id"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["NotificationMuteRequest"];
+            };
+        };
+        responses: {
+            /** @description Saved */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    updateNotificationActivity: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["NotificationActivity"];
+            };
+        };
+        responses: {
+            /** @description Saved */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
 }