@imessaging/core 0.8.14 → 0.8.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/core",
-  "version": "0.8.14",
+  "version": "0.8.16",
   "description": "Core messaging transport contracts and Telegram peer storage",
   "keywords": [
     "messaging",

package/src/index.ts

@@ -12,6 +12,7 @@ export {
   type TextFormat,
 } from "./markup";
 export { MemoryCursorStore } from "./memory-cursor-store";
+export { PartialSendError } from "./types";
 export { MemoryPeerStore } from "./memory-peer-store";
 export { createPeerKey } from "./peer-key";
 export {
@@ -71,11 +72,13 @@ export type {
   OutboundButton,
   OutboundDocument,
   OutboundMessage,
+  OutboundVideo,
   ReactionTransport,
   ResolvedPeer,
   SelfAccount,
   SelfAwareTransport,
   SendResult,
+  SentPart,
   TelegramPeerStore,
   TelegramRecipient,
   TransportStatus,

package/src/types.ts

@@ -77,11 +77,21 @@ export function isTelegramRecipient(recipient: MessageRecipient): recipient is T
   );
 }
 
+/** Вложение: байты в памяти (`data`) или файл на диске (`path`) — ровно одно из двух. */
 export type OutboundDocument = {
-  data: Uint8Array;
   filename: string;
   caption?: string;
   mimeType?: string;
+  /** Видео: канал покажет плеер, а не файл. Размеры и длительность в секундах — снять ffprobe. */
+  video?: OutboundVideo;
+} & ({ data: Uint8Array; path?: never } | { path: string; data?: never });
+
+export type OutboundVideo = {
+  width: number;
+  height: number;
+  duration: number;
+  /** Можно смотреть до полной загрузки (mp4 с moov в начале). */
+  supportsStreaming?: boolean;
 };
 
 export type OutboundButton = {
@@ -96,6 +106,8 @@ export type OutboundMessage = {
   replyToMessageId?: number;
   threadId?: number;
   documents?: OutboundDocument[];
+  /** telegram-mtproto: текст — подпись первого вложения вместо его `caption`. Пустой `text` — только вложения. */
+  textAsCaption?: boolean;
   buttons?: OutboundButton[][];
   /**
    * Снять постоянную клавиатуру (ReplyKeyboardMarkup) у собеседника. Действует без `buttons`;
@@ -119,8 +131,27 @@ export type SendResult = {
   recipientId: string;
   /** Получатель — взаимный контакт учётки. Нет — канал не прислал пользователя в ответе на отправку. */
   mutualContact?: boolean;
+  /** Все отправленные сообщения по порядку. Нет — транспорт их не перечисляет. */
+  parts?: SentPart[];
 };
 
+/** Одно отправленное сообщение. `media: false` у вложения — канал принял сообщение без файла. */
+export type SentPart = { messageId: string; kind: "text" | "document"; media: boolean };
+
+/** Отправка оборвалась, когда часть уже в чате: `parts` — что ушло, повтор целиком задвоит. */
+export class PartialSendError extends Error {
+  constructor(
+    readonly parts: SentPart[],
+    cause: unknown,
+  ) {
+    super(
+      `Отправлено частично (${parts.length}): ${cause instanceof Error ? cause.message : String(cause)}`,
+      { cause },
+    );
+    this.name = "PartialSendError";
+  }
+}
+
 /**
  * Правка уже отправленного сообщения.
  *
@@ -425,6 +456,8 @@ export type MessageDraft = {
   format?: TextFormat;
   /** Черновик ответом на это сообщение. */
   replyToMessageId?: string;
+  /** Тема форума: черновик ложится в неё, а не в общий чат. */
+  threadId?: number;
 };
 
 export interface DraftTransport extends MessageTransport {