@wrongstack/telegram 0.309.0 → 0.310.0

package/dist/outbox.d.ts

@@ -0,0 +1,41 @@
+import type { Logger } from '@wrongstack/core/types';
+import { type TelegramApiClient, type TelegramApiMessage } from './api-client.js';
+import type { TelegramBotResponse } from './bot-types.js';
+/**
+ * Outbound Telegram API surface (card 7A-4): retry-wrapped senders and the
+ * health probe. Moved verbatim from bot.ts (the P1.3 retry/backoff policy is
+ * frozen behavior); only the state reads changed shape.
+ */
+export interface TelegramOutboxDeps {
+    /**
+     * Live api accessor — called at use time, NOT captured at construction
+     * (card 7A-2 lesson): tests replace `bot.api` after construction via
+     * Object.assign / property assignment, so a captured instance would never
+     * see the mock.
+     */
+    api: () => TelegramApiClient;
+    log: Logger;
+    /** Resolved per attempt; empty string or `undefined` → plain text. */
+    getParseMode?: (() => '' | 'HTML' | 'MarkdownV2' | undefined) | undefined;
+}
+export declare class TelegramOutbox {
+    private readonly deps;
+    constructor(deps: TelegramOutboxDeps);
+    sendMessage(chatId: string | number, text: string, signal?: AbortSignal | undefined): Promise<TelegramBotResponse<TelegramApiMessage>>;
+    /**
+     * Send a message that has up to one row of inline buttons (Telegram's
+     * `inline_keyboard`). Used by `telegram_approve` to present a
+     * yes/no prompt. The keyboard payload is opaque to the outbox — callers
+     * pass already-encoded `callback_data` strings (≤ 64 bytes each).
+     */
+    sendMessageWithKeyboard(chatId: string | number, text: string, buttons: Array<{
+        text: string;
+        callback_data: string;
+    }>, signal?: AbortSignal | undefined): Promise<TelegramBotResponse<TelegramApiMessage>>;
+    health(signal?: AbortSignal | undefined): Promise<{
+        ok: boolean;
+        username?: string | undefined;
+        error?: string | undefined;
+    }>;
+}
+//# sourceMappingURL=outbox.d.ts.map

package/dist/poller.d.ts

@@ -0,0 +1,48 @@
+import type { Logger } from '@wrongstack/core/types';
+import { type TelegramApiClient } from './api-client.js';
+import type { OffsetStore } from './offset-store.js';
+import type { PollLock } from './poll-lock.js';
+export declare class Poller {
+    private readonly api;
+    private readonly pollIntervalMs;
+    private readonly log;
+    private readonly controller;
+    private readonly offsetStore?;
+    private readonly lock?;
+    private readonly standbyRetryMs;
+    private pollTimer;
+    private standbyTimer;
+    private standbyAnnounced;
+    private pollActive;
+    private _startedAt;
+    private offset;
+    private _conflictStreak;
+    private static readonly CONFLICT_BACKOFF_AFTER;
+    private static readonly CONFLICT_POLL_MS;
+    private readonly onCallbackQuery;
+    private readonly onMessageUpdate;
+    constructor(deps: {
+        api: () => TelegramApiClient;
+        pollIntervalMs: number;
+        log: Logger;
+        controller: AbortController;
+        offsetStore?: OffsetStore | undefined;
+        lock?: PollLock | undefined;
+        standbyRetryMs: number;
+        onCallbackQuery: Poller['onCallbackQuery'];
+        onMessageUpdate: Poller['onMessageUpdate'];
+    });
+    get active(): boolean;
+    get startedAt(): number | null;
+    get standby(): boolean;
+    get conflictStreak(): number;
+    start(): void;
+    stop(): void;
+    acquireAndPoll(): void;
+    handleLockLost(): void;
+    schedulePoll(): void;
+    poll(): Promise<void>;
+    loadOffset(): Promise<void>;
+    saveOffset(): Promise<void>;
+}
+//# sourceMappingURL=poller.d.ts.map

package/dist/text-format.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Telegram platform text-formatting utilities.
+ *
+ * Extracted from bot.ts (card #7A-1) — pure string helpers bound to
+ * Telegram's message-length platform contract, with no dependency on the
+ * bot's polling, approval, or API-client machinery. Kept separate from
+ * ./format.ts (event humanizers) because that module renders host events
+ * while this one enforces platform limits.
+ */
+/**
+ * Truncate text to fit Telegram's 4096-char message limit.
+ * Preserves semantic boundaries in this priority order:
+ *   1. Paragraph break (double newline)
+ *   2. Sentence break (. ! ? followed by space/newline)
+ *   3. Word break (space)
+ *   4. Hard cut with ellipsis
+ *
+ * When a clean boundary is found, appends "…" to signal intentional truncation.
+ */
+export declare function truncateForTelegram(text: string, maxLen?: number): string;
+/**
+ * Escape HTML special chars for Telegram's HTML parse mode.
+ */
+export declare function escapeHtml(text: string): string;
+//# sourceMappingURL=text-format.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/telegram",
-  "version": "0.309.0",
+  "version": "0.310.0",
   "license": "MIT",
   "description": "WrongStack plugin — Telegram bridge: send messages, receive prompts, get notified.",
   "repository": {
@@ -26,12 +26,12 @@
     "!dist/**/*.map"
   ],
   "peerDependencies": {
-    "@wrongstack/core": "0.309.0"
+    "@wrongstack/core": "0.310.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
     "typescript": "^7.0.2",
-    "@wrongstack/core": "0.309.0"
+    "@wrongstack/core": "0.310.0"
   },
   "publishConfig": {
     "access": "public"