@imessaging/core 0.8.12 → 0.8.14

package/package.json

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

package/src/index.ts

@@ -11,6 +11,7 @@ export {
   type TextEntityType,
   type TextFormat,
 } from "./markup";
+export { MemoryCursorStore } from "./memory-cursor-store";
 export { MemoryPeerStore } from "./memory-peer-store";
 export { createPeerKey } from "./peer-key";
 export {
@@ -37,6 +38,7 @@ export type {
   IncomingAttachment,
   IncomingLink,
   IncomingMessage,
+  IncomingMessageKind,
   IncomingMessageTransport,
   OutgoingReadReceipt,
   OutgoingReadReceiptTransport,
@@ -57,6 +59,8 @@ export type {
   PhoneMatch,
   PeerInfo,
   PeerInfoTransport,
+  AvitoRecipient,
+  CursorStore,
   EditResult,
   EmailRecipient,
   HeadhunterRecipient,

package/src/memory-cursor-store.ts

@@ -0,0 +1,14 @@
+import type { CursorStore } from "./types";
+
+/** Курсоры в памяти процесса: после рестарта опрос начинает с текущего момента. */
+export class MemoryCursorStore implements CursorStore {
+  private readonly values = new Map<string, string>();
+
+  async get(key: string): Promise<string | null> {
+    return this.values.get(key) ?? null;
+  }
+
+  async set(key: string, value: string): Promise<void> {
+    this.values.set(key, value);
+  }
+}

package/src/types.ts

@@ -33,10 +33,22 @@ export type MaxRecipient = {
   chatId: string;
 };
 
-/** Диалог (отклик) HeadHunter, в который работодатель уже может написать. */
-export type HeadhunterRecipient = {
-  type: "headhunter";
-  negotiationId: string;
+/**
+ * Адресат HeadHunter. Три вида:
+ * - `negotiationId` — отклик, старый путь `/negotiations/{id}/messages`;
+ * - `chatId` — чат `/common/chats/{id}`, в том числе чат без вакансии;
+ * - `resumeHash` — чата ещё нет: транспорт создаёт или находит чат без вакансии по резюме
+ *   и возвращает его `chatId` в `SendResult.recipientId`.
+ */
+export type HeadhunterRecipient =
+  | { type: "headhunter"; negotiationId: string }
+  | { type: "headhunter"; chatId: string }
+  | { type: "headhunter"; resumeHash: string };
+
+/** Чат Avito Messenger. `chatId` выдаёт API Avito. */
+export type AvitoRecipient = {
+  type: "avito";
+  chatId: string;
 };
 
 export type MessageRecipient =
@@ -44,7 +56,8 @@ export type MessageRecipient =
   | TelegramIdRecipient
   | EmailRecipient
   | MaxRecipient
-  | HeadhunterRecipient;
+  | HeadhunterRecipient
+  | AvitoRecipient;
 
 /** Получатель, адресуемый в Telegram. Сужение для транспортов, которые кроме него ничего не умеют. */
 export type TelegramRecipient = UsernameRecipient | TelegramIdRecipient;
@@ -280,6 +293,21 @@ export type IncomingLink = {
  * `transportId` и `accountId` входят В САМО сообщение, а не подставляются потребителем: один
  * продукт слушает несколько учёток сразу, и `chatId` уникален только внутри пары «канал + учётка».
  */
+/** Что лежит в сообщении. `unsupported` — клиент такой вид не знает, `other` — знает, но отдельного кода нет. */
+export type IncomingMessageKind =
+  | "text"
+  | "voice"
+  | "video_note"
+  | "sticker"
+  | "poll"
+  | "contact"
+  | "geo"
+  | "photo"
+  | "video"
+  | "document"
+  | "unsupported"
+  | "other";
+
 export type IncomingMessage = {
   transportId: string;
   accountId: string;
@@ -303,6 +331,8 @@ export type IncomingMessage = {
   /** Общий у частей одного альбома: Telegram присылает его отдельными сообщениями. */
   albumId?: string;
   text: string;
+  /** Вид содержимого: голосовое, кружок, опрос… Нет — канал вид не сообщает. */
+  kind?: IncomingMessageKind;
   /** Когда отправлено. Нет — канал время не сообщает. */
   sentAt?: Date;
   /** Когда правили последний раз. Нет — не правили. */
@@ -572,3 +602,12 @@ export function canObserveOutgoingRead(
 ): transport is OutgoingReadReceiptTransport {
   return typeof (transport as OutgoingReadReceiptTransport).onOutgoingRead === "function";
 }
+
+/**
+ * Где транспорт с опросом (hh, Avito) помнит, до какого сообщения дочитал каждый чат.
+ * Значение — непрозрачная строка транспорта. Своё хранилище (Redis, БД) — чтобы рестарт не терял сообщения.
+ */
+export interface CursorStore {
+  get(key: string): Promise<string | null>;
+  set(key: string, value: string): Promise<void>;
+}