@imessaging/core 0.8.13 → 0.8.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/core",
-  "version": "0.8.13",
+  "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 {
@@ -58,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;
@@ -589,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>;
+}