@imessaging/headhunter 0.7.0

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@imessaging/headhunter",
+  "version": "0.7.0",
+  "description": "HeadHunter employer-dialog transport for imessaging",
+  "keywords": [
+    "headhunter",
+    "hh.ru",
+    "messaging",
+    "transport"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iconicompany/imessaging.git",
+    "directory": "packages/headhunter"
+  },
+  "files": [
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "type-check": "bunx tsgo --noEmit -p tsconfig.json",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@imessaging/core": "0.7.0"
+  }
+}

package/src/headhunter-transport.ts

@@ -0,0 +1,130 @@
+import type {
+  MessageTransport,
+  OutboundMessage,
+  SendResult,
+  TransportStatus,
+} from "@imessaging/core";
+
+const DEFAULT_API_BASE_URL = "https://api.hh.ru";
+
+export type HeadhunterTransportOptions = {
+  accountId: string;
+  accessToken: string;
+  /** Базовый URL API — позволяет проверить транспорт без сети. */
+  apiBaseUrl?: string;
+  userAgent?: string;
+};
+
+export class HeadhunterApiError extends Error {
+  constructor(
+    readonly status: number,
+    readonly payload: unknown,
+  ) {
+    super(`HeadHunter API returned HTTP ${status}: ${payloadText(payload)}`);
+    this.name = "HeadhunterApiError";
+  }
+}
+
+/** Отправляет в уже существующий работодательский диалог HH по его negotiation ID. */
+export class HeadhunterTransport implements MessageTransport {
+  readonly id: string;
+  private readonly apiBaseUrl: string;
+  private connected = false;
+  private lastActivityAt?: Date;
+  private error?: string;
+
+  constructor(private readonly options: HeadhunterTransportOptions) {
+    if (!options.accountId.trim()) throw new Error("accountId must not be empty");
+    if (!options.accessToken.trim()) throw new Error("accessToken must not be empty");
+    this.id = `headhunter:${options.accountId}`;
+    this.apiBaseUrl = (options.apiBaseUrl ?? DEFAULT_API_BASE_URL).replace(/\/+$/u, "");
+  }
+
+  async connect(): Promise<void> {
+    try {
+      await this.request("/me");
+      this.connected = true;
+      this.error = undefined;
+    } catch (cause) {
+      this.connected = false;
+      this.error = messageOf(cause);
+      throw cause;
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    this.connected = false;
+  }
+
+  async send(message: OutboundMessage): Promise<SendResult> {
+    if (!this.connected) throw new Error(`${this.id} is not connected`);
+    if (message.recipient.type !== "headhunter") {
+      throw new Error(
+        `${this.id} sends HeadHunter messages and cannot address ${message.recipient.type}`,
+      );
+    }
+    const negotiationId = message.recipient.negotiationId.trim();
+    if (!negotiationId) throw new Error("HeadHunter negotiationId must not be empty");
+    try {
+      const result = await this.request<{ id?: string | number }>(
+        `/negotiations/${encodeURIComponent(negotiationId)}/messages`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/x-www-form-urlencoded" },
+          body: new URLSearchParams({ message: message.text }).toString(),
+        },
+      );
+      this.lastActivityAt = new Date();
+      return {
+        transportId: this.id,
+        messageId: String(result.id ?? ""),
+        recipientId: negotiationId,
+      };
+    } catch (cause) {
+      this.error = messageOf(cause);
+      throw cause;
+    }
+  }
+
+  async getStatus(): Promise<TransportStatus> {
+    return {
+      connected: this.connected,
+      transportId: this.id,
+      accountId: this.options.accountId,
+      lastActivityAt: this.lastActivityAt,
+      error: this.error,
+    };
+  }
+
+  private async request<T = Record<string, never>>(path: string, init?: RequestInit): Promise<T> {
+    const response = await fetch(`${this.apiBaseUrl}${path}`, {
+      ...init,
+      headers: {
+        "User-Agent": this.options.userAgent ?? "imessaging/0.6",
+        Authorization: `Bearer ${this.options.accessToken}`,
+        ...init?.headers,
+      },
+    });
+    const payload = await readPayload(response);
+    if (!response.ok) throw new HeadhunterApiError(response.status, payload);
+    return payload as T;
+  }
+}
+
+async function readPayload(response: Response): Promise<unknown> {
+  const text = await response.text();
+  if (!text) return {};
+  try {
+    return JSON.parse(text) as unknown;
+  } catch {
+    return text;
+  }
+}
+
+function payloadText(value: unknown): string {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+
+function messageOf(cause: unknown): string {
+  return cause instanceof Error ? cause.message : String(cause);
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export {
+  HeadhunterApiError,
+  HeadhunterTransport,
+  type HeadhunterTransportOptions,
+} from "./headhunter-transport";