@mono-agent/telegram-adapter 0.2.1 → 0.2.2

package/dist/start.d.ts

@@ -1,56 +1,45 @@
-import { type AgentResponder, type TelegramAdapterLogger, type TelegramAdapterMessages, type TelegramAdapterStreamOptions } from "./adapter.js";
-import { type TelegramLongPollerOptions, type TelegramLongPollerStartOptions } from "./long-poller.js";
-import { type TelegramBotApiClientOptions } from "./telegram-client.js";
-import type { TelegramBotApi, TelegramChatId } from "./types.js";
-/**
- * Minimal surface a long poller must expose for {@link startTelegramAdapter} to
- * drive it. The real {@link TelegramLongPoller} satisfies this, and tests can
- * supply a fake via {@link TelegramAdapterStartOptions.pollerFactory}.
- */
-export interface TelegramPollerLike {
-    start(options?: TelegramLongPollerStartOptions): Promise<void>;
-}
+import type { RunnerHandle } from "@grammyjs/runner";
+import type { Bot } from "grammy";
+import type { AgentResponder, TelegramAdapterLogger, TelegramAdapterMessages, TelegramAdapterStreamOptions } from "./adapter.js";
+import type { TelegramChatId } from "./types.js";
 export interface TelegramAdapterStartOptions {
-    /** Bot API token, used to construct the default {@link TelegramBotApiClient}. */
+    /** Bot API token used to construct the grammY {@link Bot}. */
     readonly botToken: string;
     /** Allowlisted chat ids. Required unless {@link allowAllChats} is true. */
     readonly allowedChatIds?: readonly TelegramChatId[];
     /** Explicitly permit every chat. Leave off when using an allowlist. */
     readonly allowAllChats?: boolean;
-    /** Responder the adapter routes authorized text updates to. */
+    /** Responder the bot routes authorized text messages to. */
     readonly responder: AgentResponder;
-    /** Optional per-response stream tuning forwarded to the adapter. */
+    /** Optional per-response stream tuning. */
     readonly stream?: TelegramAdapterStreamOptions;
-    /** Optional message-copy overrides forwarded to the adapter. */
+    /** Optional message-copy overrides. */
     readonly messages?: TelegramAdapterMessages;
-    /** Optional logger shared by the adapter, stream, and poller. */
+    /** Optional logger shared by the bot and stream. */
     readonly logger?: TelegramAdapterLogger;
-    /** Restrict the update types requested from Telegram. Defaults to messages only. */
+    /** Restrict the update types polled from Telegram. Defaults to messages only. */
     readonly allowedUpdates?: readonly string[];
     /** Delete any configured webhook before polling. Defaults to true. */
     readonly deleteWebhookOnStart?: boolean;
-    /**
-     * Override how the {@link TelegramBotApi} client is built. Defaults to a real
-     * {@link TelegramBotApiClient}. Tests inject a fake to avoid hitting Telegram.
-     */
-    readonly clientFactory?: (options: TelegramBotApiClientOptions) => TelegramBotApi;
-    /**
-     * Override how the long poller is built. Defaults to a real
-     * {@link TelegramLongPoller}. Tests inject a fake to assert wiring and stop.
-     */
-    readonly pollerFactory?: (options: TelegramLongPollerOptions) => TelegramPollerLike;
+    /** Drop updates queued before start. Defaults to false. */
+    readonly dropPendingUpdates?: boolean;
+    /** Called when polling crashes after a successful start (lets the host mark the channel failed). */
+    readonly onPollingError?: (error: unknown) => void;
+    /** Test seam: build the grammY {@link Bot}. */
+    readonly botFactory?: (token: string) => Bot;
+    /** Test seam: build the polling runner. */
+    readonly runnerFactory?: (bot: Bot) => RunnerHandle;
 }
 export interface TelegramAdapterStartResult {
-    /** Stops the long poller cleanly and waits for the polling loop to settle. */
+    /** Stops polling and waits for the runner to settle. */
     stop(): Promise<void>;
 }
 /**
- * Composition-root entrypoint: builds the Telegram client, adapter, and long
- * poller from a single options bag and starts polling. Mirrors the HTTP
- * adapters' `startX(options): Promise<{ stop }>` shape so a host can launch
- * Telegram with one call.
+ * Composition-root entrypoint: builds and starts a grammY-backed Telegram bot
+ * from a single options bag. Mirrors the HTTP adapters' `startX(options):
+ * Promise<{ stop }>` shape so a host can launch Telegram with one call.
  *
- * Fail-closed: the underlying {@link TelegramAdapter} throws when neither
+ * Fail-closed: {@link createTelegramBot} throws when neither
  * {@link TelegramAdapterStartOptions.allowedChatIds} nor
  * {@link TelegramAdapterStartOptions.allowAllChats} is provided.
  */

package/dist/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;IAC/C,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAC5C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,oFAAoF;IACpF,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,cAAc,CAAC;IAClF;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,kBAAkB,CAAC;CACrF;AAED,MAAM,WAAW,0BAA0B;IACzC,8EAA8E;IAC9E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA+CrC"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;IAC/C,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAC5C,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,oGAAoG;IACpG,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,YAAY,CAAC;CACrD;AAED,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAMrC"}

package/dist/start.js

@@ -1,57 +1,39 @@
-import { TelegramAdapter, } from "./adapter.js";
-import { TelegramLongPoller, } from "./long-poller.js";
-import { TelegramBotApiClient, } from "./telegram-client.js";
+import { createTelegramBot } from "./bot.js";
 /**
- * Composition-root entrypoint: builds the Telegram client, adapter, and long
- * poller from a single options bag and starts polling. Mirrors the HTTP
- * adapters' `startX(options): Promise<{ stop }>` shape so a host can launch
- * Telegram with one call.
+ * Composition-root entrypoint: builds and starts a grammY-backed Telegram bot
+ * from a single options bag. Mirrors the HTTP adapters' `startX(options):
+ * Promise<{ stop }>` shape so a host can launch Telegram with one call.
  *
- * Fail-closed: the underlying {@link TelegramAdapter} throws when neither
+ * Fail-closed: {@link createTelegramBot} throws when neither
  * {@link TelegramAdapterStartOptions.allowedChatIds} nor
  * {@link TelegramAdapterStartOptions.allowAllChats} is provided.
  */
 export async function startTelegramAdapter(options) {
-    const buildClient = options.clientFactory ?? ((clientOptions) => new TelegramBotApiClient(clientOptions));
-    const buildPoller = options.pollerFactory ?? ((pollerOptions) => new TelegramLongPoller(pollerOptions));
-    const api = buildClient({ token: options.botToken });
-    const adapter = new TelegramAdapter({
-        api,
+    const controller = createTelegramBot(toCreateOptions(options));
+    await controller.start();
+    return {
+        stop: () => controller.stop(),
+    };
+}
+function toCreateOptions(options) {
+    return {
+        botToken: options.botToken,
         responder: options.responder,
-        ...(options.allowedChatIds === undefined ? {} : { allowedChatIds: [...options.allowedChatIds] }),
+        ...(options.allowedChatIds === undefined ? {} : { allowedChatIds: options.allowedChatIds }),
         ...(options.allowAllChats === undefined ? {} : { allowAllChats: options.allowAllChats }),
         ...(options.stream === undefined ? {} : { stream: options.stream }),
         ...(options.messages === undefined ? {} : { messages: options.messages }),
         ...(options.logger === undefined ? {} : { logger: options.logger }),
-    });
-    const poller = buildPoller({
-        api,
-        adapter,
-        deleteWebhookOnStart: options.deleteWebhookOnStart ?? true,
-        allowedUpdates: options.allowedUpdates === undefined ? ["message"] : [...options.allowedUpdates],
-        ...(options.logger === undefined ? {} : { logger: options.logger }),
-    });
-    const controller = new AbortController();
-    const running = poller.start({ signal: controller.signal });
-    // Surface late polling failures to the shared logger without leaving an
-    // unhandled rejection; stop() still awaits this same promise.
-    running.catch((error) => {
-        if (!controller.signal.aborted) {
-            options.logger?.error?.("Telegram polling stopped with an error.", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    });
-    let stopped = false;
-    return {
-        async stop() {
-            if (stopped) {
-                return;
-            }
-            stopped = true;
-            controller.abort();
-            await running.catch(() => undefined);
-        },
+        ...(options.allowedUpdates === undefined ? {} : { allowedUpdates: options.allowedUpdates }),
+        ...(options.deleteWebhookOnStart === undefined
+            ? {}
+            : { deleteWebhookOnStart: options.deleteWebhookOnStart }),
+        ...(options.dropPendingUpdates === undefined
+            ? {}
+            : { dropPendingUpdates: options.dropPendingUpdates }),
+        ...(options.onPollingError === undefined ? {} : { onPollingError: options.onPollingError }),
+        ...(options.botFactory === undefined ? {} : { botFactory: options.botFactory }),
+        ...(options.runnerFactory === undefined ? {} : { runnerFactory: options.runnerFactory }),
     };
 }
 //# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,iBAAiB,EAAiC,MAAM,UAAU,CAAC;AAqC5E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,UAAU,GAAG,iBAAiB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAoC;IAC3D,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,oBAAoB,KAAK,SAAS;YAC5C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACvD,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC"}

package/dist/telegram-error.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Transport-agnostic error type for failed Telegram Bot API calls.
+ *
+ * The streaming delivery logic ({@link import("./message-stream.js")}) and its
+ * recovery policy (`classifyTelegramError`) depend only on this shape, never on
+ * how the request was made. The grammY-backed client maps `GrammyError` /
+ * `HttpError` onto it, so the delivery layer is unaware of the transport.
+ */
+export type TelegramApiErrorKind = "http" | "telegram" | "malformed" | "network" | "aborted";
+export interface TelegramApiErrorDetails {
+    kind: TelegramApiErrorKind;
+    method: string;
+    status?: number;
+    errorCode?: number;
+    telegramDescription?: string;
+    /**
+     * How long to wait before retrying, in milliseconds. Lifted from a Telegram
+     * `parameters.retry_after` value (seconds) when present. Only the integer is
+     * carried — never a raw response body — so bot tokens cannot leak.
+     */
+    retryAfterMs?: number;
+    cause?: unknown;
+}
+export declare class TelegramApiError extends Error {
+    readonly kind: TelegramApiErrorKind;
+    readonly method: string;
+    readonly status?: number;
+    readonly errorCode?: number;
+    readonly telegramDescription?: string;
+    readonly retryAfterMs?: number;
+    readonly cause?: unknown;
+    constructor(message: string, details: TelegramApiErrorDetails);
+}
+//# sourceMappingURL=telegram-error.d.ts.map

package/dist/telegram-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-error.d.ts","sourceRoot":"","sources":["../src/telegram-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;CAqB9D"}

package/dist/telegram-error.js

@@ -0,0 +1,39 @@
+/**
+ * Transport-agnostic error type for failed Telegram Bot API calls.
+ *
+ * The streaming delivery logic ({@link import("./message-stream.js")}) and its
+ * recovery policy (`classifyTelegramError`) depend only on this shape, never on
+ * how the request was made. The grammY-backed client maps `GrammyError` /
+ * `HttpError` onto it, so the delivery layer is unaware of the transport.
+ */
+export class TelegramApiError extends Error {
+    kind;
+    method;
+    status;
+    errorCode;
+    telegramDescription;
+    retryAfterMs;
+    cause;
+    constructor(message, details) {
+        super(message);
+        this.name = "TelegramApiError";
+        this.kind = details.kind;
+        this.method = details.method;
+        if (details.status !== undefined) {
+            this.status = details.status;
+        }
+        if (details.errorCode !== undefined) {
+            this.errorCode = details.errorCode;
+        }
+        if (details.telegramDescription !== undefined) {
+            this.telegramDescription = details.telegramDescription;
+        }
+        if (details.retryAfterMs !== undefined) {
+            this.retryAfterMs = details.retryAfterMs;
+        }
+        if (details.cause !== undefined) {
+            this.cause = details.cause;
+        }
+    }
+}
+//# sourceMappingURL=telegram-error.js.map

package/dist/telegram-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-error.js","sourceRoot":"","sources":["../src/telegram-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwBH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,MAAM,CAAS;IACf,MAAM,CAAU;IAChB,SAAS,CAAU;IACnB,mBAAmB,CAAU;IAC7B,YAAY,CAAU;IACb,KAAK,CAAW;IAElC,YAAY,OAAe,EAAE,OAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrC,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACzD,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/telegram-markdown.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Render a Markdown string into the MarkdownV2 dialect Telegram accepts with
+ * `parse_mode: "MarkdownV2"`.
+ *
+ * Delegates to `telegramify-markdown`, which parses Markdown with remark and
+ * re-serializes it as MarkdownV2 with every reserved character escaped. Unlike a
+ * regex converter it cannot emit overlapping or unbalanced entities that
+ * Telegram's parser rejects, so the stream's plain-text fallback is reserved for
+ * genuinely exceptional input rather than ordinary formatting.
+ *
+ * The `"escape"` strategy keeps constructs Telegram cannot render (e.g. tables)
+ * as escaped literal text instead of dropping them. telegramify appends a
+ * trailing newline; it is stripped so callers receive the trimmed shape the rest
+ * of the delivery pipeline expects.
+ */
+export declare function renderTelegramMarkdown(markdown: string): string;
+//# sourceMappingURL=telegram-markdown.d.ts.map

package/dist/telegram-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-markdown.d.ts","sourceRoot":"","sources":["../src/telegram-markdown.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/telegram-markdown.js

@@ -0,0 +1,20 @@
+import telegramify from "telegramify-markdown";
+/**
+ * Render a Markdown string into the MarkdownV2 dialect Telegram accepts with
+ * `parse_mode: "MarkdownV2"`.
+ *
+ * Delegates to `telegramify-markdown`, which parses Markdown with remark and
+ * re-serializes it as MarkdownV2 with every reserved character escaped. Unlike a
+ * regex converter it cannot emit overlapping or unbalanced entities that
+ * Telegram's parser rejects, so the stream's plain-text fallback is reserved for
+ * genuinely exceptional input rather than ordinary formatting.
+ *
+ * The `"escape"` strategy keeps constructs Telegram cannot render (e.g. tables)
+ * as escaped literal text instead of dropping them. telegramify appends a
+ * trailing newline; it is stripped so callers receive the trimmed shape the rest
+ * of the delivery pipeline expects.
+ */
+export function renderTelegramMarkdown(markdown) {
+    return telegramify(markdown, "escape").replace(/\n+$/u, "");
+}
+//# sourceMappingURL=telegram-markdown.js.map

package/dist/telegram-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-markdown.js","sourceRoot":"","sources":["../src/telegram-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,OAAO,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/types.d.ts

@@ -57,9 +57,16 @@ export interface TelegramGetUpdatesParams {
 export interface TelegramDeleteWebhookParams {
     drop_pending_updates?: boolean;
 }
-export interface TelegramBotApi {
+/**
+ * The minimal Telegram surface the streaming delivery layer needs: sending a
+ * message and editing it in place. Update polling lives in the grammY runner, so
+ * the delivery layer depends only on these two calls.
+ */
+export interface TelegramMessageSender {
     sendMessage(params: TelegramSendMessageParams, options?: TelegramRequestOptions): Promise<TelegramSentMessage>;
     editMessageText(params: TelegramEditMessageTextParams, options?: TelegramRequestOptions): Promise<TelegramSentMessage | true>;
+}
+export interface TelegramBotApi extends TelegramMessageSender {
     getUpdates(params: TelegramGetUpdatesParams, options?: TelegramRequestOptions): Promise<TelegramUpdate[]>;
     deleteWebhook?(params?: TelegramDeleteWebhookParams, options?: TelegramRequestOptions): Promise<true>;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CACT,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,eAAe,CACb,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACvC,UAAU,CACR,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,aAAa,CAAC,CACZ,MAAM,CAAC,EAAE,2BAA2B,EACpC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mono-agent/telegram-adapter",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Telegram communication adapter for host-compatible runtimes.",
   "type": "module",
   "license": "UNLICENSED",
@@ -18,8 +18,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@mono-agent/agent-contracts": "0.2.1",
-    "@mono-agent/settings": "0.2.1"
+    "@grammyjs/runner": "^2.0.3",
+    "@mono-agent/agent-contracts": "0.2.2",
+    "@mono-agent/settings": "0.2.2",
+    "grammy": "^1.44.0",
+    "telegramify-markdown": "^1.3.3"
   },
   "publishConfig": {
     "access": "public"

package/dist/long-poller.d.ts

@@ -1,55 +0,0 @@
-import type { TelegramBotApi, TelegramUpdate } from "./types.js";
-import type { TelegramUpdateHandlingResult } from "./adapter.js";
-export interface TelegramUpdateHandler {
-    handleUpdate(update: TelegramUpdate): Promise<TelegramUpdateHandlingResult>;
-}
-export interface TelegramLongPollerBackoffOptions {
-    initialMs?: number;
-    maxMs?: number;
-}
-export interface TelegramLongPollerLogger {
-    debug?(message: string, metadata?: Record<string, unknown>): void;
-    info?(message: string, metadata?: Record<string, unknown>): void;
-    warn?(message: string, metadata?: Record<string, unknown>): void;
-    error?(message: string, metadata?: Record<string, unknown>): void;
-}
-export interface TelegramLongPollerOptions {
-    api: TelegramBotApi;
-    adapter: TelegramUpdateHandler;
-    initialOffset?: number;
-    limit?: number;
-    timeoutSeconds?: number;
-    allowedUpdates?: string[];
-    deleteWebhookOnStart?: boolean;
-    dropPendingUpdates?: boolean;
-    backoff?: TelegramLongPollerBackoffOptions;
-    onError?: (error: unknown) => void | Promise<void>;
-    logger?: TelegramLongPollerLogger;
-}
-export interface TelegramLongPollerStartOptions {
-    signal?: AbortSignal;
-}
-export interface TelegramLongPollerPollOptions {
-    signal?: AbortSignal;
-}
-export declare class TelegramLongPoller {
-    private readonly api;
-    private readonly adapter;
-    private readonly limit;
-    private readonly timeoutSeconds;
-    private readonly allowedUpdates;
-    private readonly deleteWebhookOnStart;
-    private readonly dropPendingUpdates;
-    private readonly initialBackoffMs;
-    private readonly maxBackoffMs;
-    private readonly onError;
-    private readonly logger;
-    private nextUpdateOffset;
-    constructor(options: TelegramLongPollerOptions);
-    get nextOffset(): number | undefined;
-    start(options?: TelegramLongPollerStartOptions): Promise<void>;
-    pollOnce(options?: TelegramLongPollerPollOptions): Promise<number>;
-    private buildGetUpdatesParams;
-    private deleteWebhook;
-}
-//# sourceMappingURL=long-poller.d.ts.map

package/dist/long-poller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"long-poller.d.ts","sourceRoot":"","sources":["../src/long-poller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAId,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,gCAAgC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,gCAAgC,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAOD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,gBAAgB,CAAqB;gBAEjC,OAAO,EAAE,yBAAyB;IAoC9C,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAEK,KAAK,CAAC,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClE,QAAQ,CAAC,OAAO,GAAE,6BAAkC,GAAG,OAAO,CAAC,MAAM,CAAC;IA0B5E,OAAO,CAAC,qBAAqB;YAcf,aAAa;CAgB5B"}

package/dist/long-poller.js

@@ -1,156 +0,0 @@
-const DEFAULT_LIMIT = 100;
-const DEFAULT_TIMEOUT_SECONDS = 30;
-const DEFAULT_INITIAL_BACKOFF_MS = 500;
-const DEFAULT_MAX_BACKOFF_MS = 10_000;
-export class TelegramLongPoller {
-    api;
-    adapter;
-    limit;
-    timeoutSeconds;
-    allowedUpdates;
-    deleteWebhookOnStart;
-    dropPendingUpdates;
-    initialBackoffMs;
-    maxBackoffMs;
-    onError;
-    logger;
-    nextUpdateOffset;
-    constructor(options) {
-        if (options.api === undefined) {
-            throw new TypeError("TelegramLongPoller requires a Telegram Bot API client.");
-        }
-        if (typeof options.adapter?.handleUpdate !== "function") {
-            throw new TypeError("TelegramLongPoller requires an adapter with handleUpdate().");
-        }
-        this.api = options.api;
-        this.adapter = options.adapter;
-        this.limit = options.limit ?? DEFAULT_LIMIT;
-        this.timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
-        this.allowedUpdates = options.allowedUpdates?.slice();
-        this.deleteWebhookOnStart = options.deleteWebhookOnStart === true;
-        this.dropPendingUpdates = options.dropPendingUpdates === true;
-        this.initialBackoffMs =
-            options.backoff?.initialMs ?? DEFAULT_INITIAL_BACKOFF_MS;
-        this.maxBackoffMs = options.backoff?.maxMs ?? DEFAULT_MAX_BACKOFF_MS;
-        this.onError = options.onError;
-        this.logger = options.logger;
-        this.nextUpdateOffset = options.initialOffset;
-        if (!Number.isInteger(this.limit) || this.limit < 1 || this.limit > 100) {
-            throw new RangeError("TelegramLongPoller limit must be an integer between 1 and 100.");
-        }
-        if (!Number.isFinite(this.timeoutSeconds) || this.timeoutSeconds < 0) {
-            throw new RangeError("TelegramLongPoller timeoutSeconds must be non-negative.");
-        }
-        if (!Number.isFinite(this.initialBackoffMs) || this.initialBackoffMs < 0) {
-            throw new RangeError("TelegramLongPoller initial backoff must be non-negative.");
-        }
-        if (!Number.isFinite(this.maxBackoffMs) || this.maxBackoffMs < this.initialBackoffMs) {
-            throw new RangeError("TelegramLongPoller max backoff must be at least the initial backoff.");
-        }
-    }
-    get nextOffset() {
-        return this.nextUpdateOffset;
-    }
-    async start(options = {}) {
-        if (isSignalAborted(options.signal)) {
-            return;
-        }
-        if (this.deleteWebhookOnStart) {
-            await this.deleteWebhook(options.signal);
-        }
-        let backoffMs = this.initialBackoffMs;
-        while (!isSignalAborted(options.signal)) {
-            try {
-                const pollOptions = {};
-                if (options.signal !== undefined) {
-                    pollOptions.signal = options.signal;
-                }
-                await this.pollOnce(pollOptions);
-                backoffMs = this.initialBackoffMs;
-            }
-            catch (error) {
-                if (isSignalAborted(options.signal) || isAbortError(error)) {
-                    return;
-                }
-                this.logger?.warn?.("Telegram long polling failed; backing off.", {
-                    error: error instanceof Error ? error.message : String(error),
-                    backoffMs,
-                });
-                await this.onError?.(error);
-                await abortableDelay(backoffMs, options.signal);
-                backoffMs = Math.min(this.maxBackoffMs, Math.max(backoffMs * 2, 1));
-            }
-        }
-    }
-    async pollOnce(options = {}) {
-        if (isSignalAborted(options.signal)) {
-            throw new DOMException("Telegram polling was aborted.", "AbortError");
-        }
-        const params = this.buildGetUpdatesParams();
-        const requestOptions = {};
-        if (options.signal !== undefined) {
-            requestOptions.signal = options.signal;
-        }
-        const updates = await this.api.getUpdates(params, requestOptions);
-        let handled = 0;
-        for (const update of updates) {
-            if (isSignalAborted(options.signal)) {
-                throw new DOMException("Telegram polling was aborted.", "AbortError");
-            }
-            await this.adapter.handleUpdate(update);
-            this.nextUpdateOffset = update.update_id + 1;
-            handled += 1;
-        }
-        return handled;
-    }
-    buildGetUpdatesParams() {
-        const params = {
-            limit: this.limit,
-            timeout: this.timeoutSeconds,
-        };
-        if (this.nextUpdateOffset !== undefined) {
-            params.offset = this.nextUpdateOffset;
-        }
-        if (this.allowedUpdates !== undefined) {
-            params.allowed_updates = this.allowedUpdates;
-        }
-        return params;
-    }
-    async deleteWebhook(signal) {
-        if (typeof this.api.deleteWebhook !== "function") {
-            throw new TypeError("TelegramLongPoller deleteWebhookOnStart requires api.deleteWebhook().");
-        }
-        const params = {
-            drop_pending_updates: this.dropPendingUpdates,
-        };
-        const requestOptions = {};
-        if (signal !== undefined) {
-            requestOptions.signal = signal;
-        }
-        await this.api.deleteWebhook(params, requestOptions);
-    }
-}
-function isAbortError(error) {
-    return (error instanceof DOMException && error.name === "AbortError") || (error instanceof Error && error.name === "AbortError");
-}
-function isSignalAborted(signal) {
-    return signal?.aborted === true;
-}
-function abortableDelay(ms, signal) {
-    if (ms <= 0 || signal?.aborted === true) {
-        return Promise.resolve();
-    }
-    return new Promise((resolve) => {
-        const timeout = setTimeout(() => {
-            signal?.removeEventListener("abort", onAbort);
-            resolve();
-        }, ms);
-        const onAbort = () => {
-            clearTimeout(timeout);
-            signal?.removeEventListener("abort", onAbort);
-            resolve();
-        };
-        signal?.addEventListener("abort", onAbort, { once: true });
-    });
-}
-//# sourceMappingURL=long-poller.js.map

package/dist/long-poller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"long-poller.js","sourceRoot":"","sources":["../src/long-poller.ts"],"names":[],"mappings":"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"}