@myronsi/messenger-api 2.1.0-alpha.5.next.70 → 2.1.0-alpha.6.next.71

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 Contract changes only. The backend changelog is `CHANGELOG.md` in the repository root. Rules: `docs/api-compatibility.md`.
 
+## 2.1.0-alpha.6
+
+- `Message` adds optional `reply_preview` (`ReplyPreview`: id, type, sender, the first 100 characters of the
+  text, attachment, is_deleted) on history pages and `message` events, so a reply shows what it answers even
+  when that message is not loaded. It is absent when the answered message is gone or hidden for the recipient.
+
 ## 2.1.0-alpha.5
 
 - A user's `avatar_url` adds `?rev={revision}`, which changes with every new avatar. `GET /users/{user_id}/avatar`

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-/* Generated from api/openapi.yaml 2.1.0-alpha.5. Do not edit. */
-export declare const API_VERSION: "2.1.0-alpha.5";
+/* Generated from api/openapi.yaml 2.1.0-alpha.6. Do not edit. */
+export declare const API_VERSION: "2.1.0-alpha.6";
 export type { paths, components, operations } from "./schema.js";
 export * from "./ws-events.js";

package/dist/index.js

@@ -1 +1 @@
-export const API_VERSION = "2.1.0-alpha.5";
+export const API_VERSION = "2.1.0-alpha.6";

package/dist/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Messenger API
-  version: 2.1.0-alpha.5
+  version: 2.1.0-alpha.6
   summary: REST contract of the Messenger backend (v2).
   description: |
     Contract for the Go backend. The WebSocket protocol is described in `websocket/` and
@@ -2641,6 +2641,29 @@ components:
             - $ref: "#/components/schemas/Id"
             - type: "null"
         sender_name: { type: string }
+    ReplyPreview:
+      type: object
+      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.
+      required: [id, type, sender, content, attachment, is_deleted]
+      properties:
+        id: { $ref: "#/components/schemas/Id" }
+        type: { $ref: "#/components/schemas/MessageType" }
+        sender:
+          oneOf:
+            - $ref: "#/components/schemas/User"
+            - type: "null"
+        content:
+          type: [string, "null"]
+          maxLength: 100
+          description: The first 100 characters of the text or caption; `null` when deleted or empty.
+        attachment:
+          oneOf:
+            - $ref: "#/components/schemas/Attachment"
+            - type: "null"
+        is_deleted: { type: boolean }
     Message:
       type: object
       required:
@@ -2678,6 +2701,8 @@ components:
           oneOf:
             - $ref: "#/components/schemas/Id"
             - type: "null"
+        reply_preview:
+          $ref: "#/components/schemas/ReplyPreview"
         forwarded_from:
           oneOf:
             - $ref: "#/components/schemas/ForwardedFrom"

package/dist/schema.d.ts

@@ -1,4 +1,4 @@
-/* Generated from api/openapi.yaml 2.1.0-alpha.5. Do not edit. */
+/* Generated from api/openapi.yaml 2.1.0-alpha.6. Do not edit. */
 export interface paths {
     "/meta": {
         parameters: {
@@ -1828,6 +1828,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"];
@@ -1838,6 +1852,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"][];

package/dist/ws-events.d.ts

@@ -1,4 +1,4 @@
-/* Generated from api/openapi.yaml 2.1.0-alpha.5. Do not edit. */
+/* Generated from api/openapi.yaml 2.1.0-alpha.6. Do not edit. */
 
 /**
  * Any WebSocket event, in either direction.
@@ -307,6 +307,7 @@ export interface Message {
   content: string | null;
   attachment: Attachment | null;
   reply_to: Id | null;
+  reply_preview?: ReplyPreview;
   forwarded_from: ForwardedFrom | null;
   reactions: Reaction[];
   read_by: ReadReceipt[];
@@ -337,6 +338,23 @@ export interface Attachment {
   duration_ms?: number | null;
   waveform?: number[] | null;
 }
+/**
+ * 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.
+ *
+ */
+export interface ReplyPreview {
+  id: Id;
+  type: MessageType;
+  sender: User | null;
+  /**
+   * The first 100 characters of the text or caption; `null` when deleted or empty.
+   */
+  content: string | null;
+  attachment: Attachment | null;
+  is_deleted: boolean;
+}
 export interface ForwardedFrom {
   message_id: Id;
   sender_id: Id | null;

package/dist/ws-events.schema.json

@@ -1276,6 +1276,57 @@
         }
       }
     },
+    "ReplyPreview": {
+      "type": "object",
+      "description": "What a reply shows of the message it answers, so a client can draw the quote without loading that\nmessage. Set on messages of history pages and `message` events when the recipient can see the answered\nmessage; absent when it is gone or hidden for them, and on chat-list previews and search results.\n",
+      "required": [
+        "id",
+        "type",
+        "sender",
+        "content",
+        "attachment",
+        "is_deleted"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/Id"
+        },
+        "type": {
+          "$ref": "#/$defs/MessageType"
+        },
+        "sender": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/User"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "content": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "maxLength": 100,
+          "description": "The first 100 characters of the text or caption; `null` when deleted or empty."
+        },
+        "attachment": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/Attachment"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "is_deleted": {
+          "type": "boolean"
+        }
+      }
+    },
     "Message": {
       "type": "object",
       "required": [
@@ -1342,6 +1393,9 @@
             }
           ]
         },
+        "reply_preview": {
+          "$ref": "#/$defs/ReplyPreview"
+        },
         "forwarded_from": {
           "oneOf": [
             {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myronsi/messenger-api",
-  "version": "2.1.0-alpha.5.next.70",
+  "version": "2.1.0-alpha.6.next.71",
   "description": "API contract of the Messenger backend: OpenAPI document, WebSocket event schemas and generated TypeScript types",
   "license": "MIT",
   "repository": {