@sympoies/dsh-telegram 0.0.0-bootstrap.0 → 0.6.0

package/lib/telegram/poller.js

@@ -0,0 +1,94 @@
+/**
+ * The long-poll receive loop.
+ *
+ * Telegram's `getUpdates` offset is the delivery guarantee: an update is
+ * redelivered until an offset past it is acknowledged. So the offset advances
+ * only after the handler for that update returns. A handler that throws leaves
+ * the offset where it is and the update comes back on the next poll — which is
+ * why the router above it never throws for ordinary failures, and only a real
+ * fault gets a retry.
+ *
+ * Reconnection is the loop's other job. A laptop that sleeps, a network that
+ * drops, a Telegram hiccup — each surfaces as a rejected poll, and the bot has
+ * to come back on its own rather than going quietly silent.
+ */
+import { SILENT_LOGGER } from '../harness/types.js';
+export class UpdatePoller {
+    options;
+    logger;
+    sleep;
+    offset = 0;
+    connected = false;
+    constructor(options) {
+        this.options = options;
+        this.logger = options.logger ?? SILENT_LOGGER;
+        this.sleep = options.sleep ?? defaultSleep;
+    }
+    /** The next offset that will be acknowledged; exposed for tests and status. */
+    get acknowledged() {
+        return this.offset;
+    }
+    /**
+     * Poll until the signal aborts.
+     *
+     * @param signal - stops the loop; an in-flight poll is aborted with it.
+     */
+    async run(signal) {
+        let attempt = 0;
+        while (!signal.aborted) {
+            try {
+                const updates = await this.options.source.getUpdates(this.offset, this.options.longPollSeconds ?? 25, signal);
+                attempt = 0;
+                if (!this.connected) {
+                    this.connected = true;
+                    this.options.onConnected?.();
+                }
+                await this.dispatch(updates, signal);
+            }
+            catch (error) {
+                if (signal.aborted)
+                    return;
+                this.connected = false;
+                attempt += 1;
+                const delay = this.backoff(attempt);
+                this.logger.warn(`[dsh-telegram] poll failed; retrying in ${delay}ms`, error);
+                await this.sleep(delay, signal);
+            }
+        }
+    }
+    /**
+     * Hand each update to the handler, acknowledging only after it returns.
+     * A throw stops the batch so the failed update is redelivered.
+     */
+    async dispatch(updates, signal) {
+        for (const update of updates) {
+            if (signal.aborted)
+                return;
+            await this.options.onUpdate(update);
+            this.offset = Math.max(this.offset, update.update_id + 1);
+        }
+    }
+    /** Exponential backoff, capped so a long outage still retries regularly. */
+    backoff(attempt) {
+        const base = this.options.baseDelayMs ?? 1000;
+        const max = this.options.maxDelayMs ?? 30_000;
+        return Math.min(base * 2 ** Math.min(attempt - 1, 8), max);
+    }
+}
+/** Cancellable sleep used between reconnect attempts. */
+function defaultSleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted)
+            return resolve();
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=poller.js.map

package/lib/telegram/poller.js.map

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

package/lib/telegram/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * The slice of the Telegram Bot API this plugin actually speaks.
+ *
+ * Deliberately partial: every field here is one the adapter reads, so an
+ * upstream schema change surfaces as a type error at the exact use site rather
+ * than as a silently-undefined value deep in the pipeline.
+ */
+/** A button in an inline keyboard. */
+export interface InlineButton {
+    /** Label shown on the button. */
+    readonly text: string;
+    /** Opaque payload echoed back in the callback query (Telegram caps it at 64 bytes). */
+    readonly callbackData: string;
+}
+/** Rows of inline buttons; each inner array is one row. */
+export type InlineKeyboard = readonly (readonly InlineButton[])[];
+/** The bot's own account, as returned by `getMe`. */
+export interface BotUser {
+    readonly id: number;
+    readonly is_bot: boolean;
+    readonly first_name?: string;
+    readonly username?: string;
+}
+/** A Telegram chat. */
+export interface TelegramChat {
+    readonly id: number;
+    readonly type: 'private' | 'group' | 'supergroup' | 'channel';
+    readonly title?: string;
+    readonly username?: string;
+}
+/** A Telegram user. */
+export interface TelegramUser {
+    readonly id: number;
+    readonly is_bot?: boolean;
+    readonly first_name?: string;
+    readonly username?: string;
+}
+/** One parsed span of message text. */
+export interface TelegramEntity {
+    readonly type: string;
+    readonly offset: number;
+    readonly length: number;
+    /** Present on a `text_mention`, which is how a user without a @handle is named. */
+    readonly user?: TelegramUser;
+}
+/** An incoming message. */
+export interface TelegramMessage {
+    readonly message_id: number;
+    readonly date?: number;
+    readonly chat: TelegramChat;
+    readonly from?: TelegramUser;
+    readonly text?: string;
+    readonly caption?: string;
+    readonly message_thread_id?: number;
+    /**
+     * Shared by every message of one album.
+     *
+     * Telegram has no "several photos in one message": an album arrives as N
+     * separate updates tied together only by this id, with the caption on one of
+     * them. Treating them as N messages is why sending three screenshots used to
+     * start three conversations' worth of turns, two of them contextless.
+     */
+    readonly media_group_id?: string;
+    /**
+     * The message this one replies to, with enough of its sender to tell whether
+     * it was ours — which is how a group conversation continues without an
+     * @mention on every line.
+     */
+    readonly reply_to_message?: {
+        readonly message_id: number;
+        readonly from?: TelegramUser;
+    };
+    /** Text markup Telegram parsed, including the mentions this bot looks for. */
+    readonly entities?: readonly TelegramEntity[];
+    /** The same, for a photo or document caption. */
+    readonly caption_entities?: readonly TelegramEntity[];
+    /**
+     * Every size Telegram generated, smallest first. The dimensions matter: the
+     * largest is routinely bigger than the harness will store.
+     */
+    readonly photo?: readonly {
+        readonly file_id: string;
+        readonly file_size?: number;
+        readonly width?: number;
+        readonly height?: number;
+    }[];
+    readonly document?: {
+        readonly file_id: string;
+        readonly file_name?: string;
+        readonly mime_type?: string;
+    };
+    readonly voice?: {
+        readonly file_id: string;
+        readonly duration?: number;
+    };
+    readonly audio?: {
+        readonly file_id: string;
+        readonly mime_type?: string;
+    };
+    readonly video?: {
+        readonly file_id: string;
+        readonly mime_type?: string;
+    };
+}
+/**
+ * A button press. This is the update type the existing channel plugin never
+ * subscribes to, and the reason questions cannot be answered from Telegram.
+ */
+export interface TelegramCallbackQuery {
+    readonly id: string;
+    readonly from: TelegramUser;
+    readonly data?: string;
+    readonly message?: TelegramMessage;
+}
+/** One entry from `getUpdates`. */
+export interface TelegramUpdate {
+    readonly update_id: number;
+    readonly message?: TelegramMessage;
+    readonly edited_message?: TelegramMessage;
+    readonly callback_query?: TelegramCallbackQuery;
+}
+/** File metadata from `getFile`. */
+export interface TelegramFile {
+    readonly file_id: string;
+    readonly file_size?: number;
+    readonly file_path?: string;
+}
+/** Chat actions the adapter uses as a progress indicator. */
+export type ChatAction = 'typing' | 'upload_document' | 'upload_photo';
+//# sourceMappingURL=types.d.ts.map

package/lib/telegram/types.d.ts.map

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

package/lib/telegram/types.js

@@ -0,0 +1,9 @@
+/**
+ * The slice of the Telegram Bot API this plugin actually speaks.
+ *
+ * Deliberately partial: every field here is one the adapter reads, so an
+ * upstream schema change surfaces as a type error at the exact use site rather
+ * than as a silently-undefined value deep in the pipeline.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/telegram/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/telegram/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/lib/telegram/typing.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Keeping Telegram's own "typing…" indicator alive.
+ *
+ * `sendChatAction` lasts five seconds and then lapses, which is fine for the
+ * work it was written for and useless for the work this bot does: reading an
+ * image on a vision model, waiting behind another message, or a turn that
+ * spends a minute in a tool call all outlast it several times over. One call
+ * therefore reads as a bot that started and died.
+ *
+ * So a hold is taken for as long as nothing is visible in the chat, and the
+ * action is re-sent inside its own expiry until the hold is released. Holds
+ * are counted per conversation: the router's hold over reading an attachment
+ * and the bridge's hold over a turn overlap, and the indicator should stop
+ * when the last of them lets go, not the first.
+ *
+ * Everything here is cosmetic, so nothing it does may fail a message.
+ */
+import type { ChatTarget } from '../interact/surface.js';
+/** The one Bot API call this needs. */
+export interface ChatActionSender {
+    sendChatAction?(chatId: string, action: 'typing', threadId?: number): Promise<void>;
+}
+/** Construction options. */
+export interface TypingIndicatorOptions {
+    readonly chat: ChatActionSender;
+    readonly refreshMs?: number;
+    readonly maxHoldMs?: number;
+}
+export declare class TypingIndicator {
+    private readonly options;
+    private readonly held;
+    constructor(options: TypingIndicatorOptions);
+    /**
+     * Show that this conversation is being worked on, until released.
+     *
+     * @param target - the conversation to show it in.
+     * @returns a release function, safe to call more than once.
+     */
+    hold(target: ChatTarget): () => void;
+    /** Stop every indicator — the plugin is unloading. */
+    dispose(): void;
+    /** Send one action, swallowing whatever it does; this is decoration. */
+    private send;
+    /** Forget a conversation's indicator and stop its timers. */
+    private clear;
+}
+//# sourceMappingURL=typing.d.ts.map

package/lib/telegram/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","sourceRoot":"","sources":["../../src/telegram/typing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAaxD,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpF;AAED,4BAA4B;AAC5B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AASD,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;gBAElB,OAAO,EAAE,sBAAsB;IAE5D;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI;IA4BpC,sDAAsD;IACtD,OAAO,IAAI,IAAI;IAIf,wEAAwE;IACxE,OAAO,CAAC,IAAI;IAMZ,6DAA6D;IAC7D,OAAO,CAAC,KAAK;CAQd"}

package/lib/telegram/typing.js

@@ -0,0 +1,91 @@
+/**
+ * Keeping Telegram's own "typing…" indicator alive.
+ *
+ * `sendChatAction` lasts five seconds and then lapses, which is fine for the
+ * work it was written for and useless for the work this bot does: reading an
+ * image on a vision model, waiting behind another message, or a turn that
+ * spends a minute in a tool call all outlast it several times over. One call
+ * therefore reads as a bot that started and died.
+ *
+ * So a hold is taken for as long as nothing is visible in the chat, and the
+ * action is re-sent inside its own expiry until the hold is released. Holds
+ * are counted per conversation: the router's hold over reading an attachment
+ * and the bridge's hold over a turn overlap, and the indicator should stop
+ * when the last of them lets go, not the first.
+ *
+ * Everything here is cosmetic, so nothing it does may fail a message.
+ */
+/** How often to re-send. Comfortably inside Telegram's five-second expiry. */
+const REFRESH_MS = 4_000;
+/**
+ * How long one hold may keep the indicator alive.
+ *
+ * A backstop, not a policy: a release that never runs — a listener dropped, a
+ * turn whose end never arrives — would otherwise leave a chat typing forever.
+ */
+const MAX_HOLD_MS = 10 * 60 * 1000;
+export class TypingIndicator {
+    options;
+    held = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Show that this conversation is being worked on, until released.
+     *
+     * @param target - the conversation to show it in.
+     * @returns a release function, safe to call more than once.
+     */
+    hold(target) {
+        const key = keyOf(target);
+        const existing = this.held.get(key);
+        if (existing) {
+            existing.holders += 1;
+        }
+        else {
+            this.send(target);
+            this.held.set(key, {
+                holders: 1,
+                timer: setInterval(() => this.send(target), this.options.refreshMs ?? REFRESH_MS),
+                deadline: setTimeout(() => this.clear(key), this.options.maxHoldMs ?? MAX_HOLD_MS),
+            });
+        }
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const entry = this.held.get(key);
+            if (!entry)
+                return;
+            entry.holders -= 1;
+            if (entry.holders <= 0)
+                this.clear(key);
+        };
+    }
+    /** Stop every indicator — the plugin is unloading. */
+    dispose() {
+        for (const key of [...this.held.keys()])
+            this.clear(key);
+    }
+    /** Send one action, swallowing whatever it does; this is decoration. */
+    send(target) {
+        void this.options.chat
+            .sendChatAction?.(target.chatId, 'typing', target.threadId)
+            .catch(() => undefined);
+    }
+    /** Forget a conversation's indicator and stop its timers. */
+    clear(key) {
+        const entry = this.held.get(key);
+        if (!entry)
+            return;
+        this.held.delete(key);
+        clearInterval(entry.timer);
+        clearTimeout(entry.deadline);
+    }
+}
+/** A key distinguishing forum topics, which are separate conversations. */
+function keyOf(target) {
+    return target.threadId === undefined ? target.chatId : `${target.chatId}#${target.threadId}`;
+}
+//# sourceMappingURL=typing.js.map

package/lib/telegram/typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.js","sourceRoot":"","sources":["../../src/telegram/typing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,8EAA8E;AAC9E,MAAM,UAAU,GAAG,KAAK,CAAA;AAExB;;;;;GAKG;AACH,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAqBlC,MAAM,OAAO,eAAe;IAGG;IAFZ,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAA;IAE/C,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEhE;;;;;OAKG;IACH,IAAI,CAAC,MAAkB;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEnC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACjB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;gBACjB,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC;gBACjF,QAAQ,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC;aACnF,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YAEf,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAChC,IAAI,CAAC,KAAK;gBAAE,OAAM;YAElB,KAAK,CAAC,OAAO,IAAI,CAAC,CAAA;YAClB,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC;IAED,sDAAsD;IACtD,OAAO;QACL,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1D,CAAC;IAED,wEAAwE;IAChE,IAAI,CAAC,MAAkB;QAC7B,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI;aACnB,cAAc,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;aAC1D,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC3B,CAAC;IAED,6DAA6D;IACrD,KAAK,CAAC,GAAW;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,OAAM;QAElB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACrB,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1B,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,2EAA2E;AAC3E,SAAS,KAAK,CAAC,MAAkB;IAC/B,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAA;AAC9F,CAAC"}

package/lib/versions.d.ts

@@ -0,0 +1,63 @@
+/**
+ * What is installed here, and what is published.
+ *
+ * The question behind "should there be an /update" is really "am I behind?",
+ * and that one can be answered without any of the risk. Updating the harness
+ * takes effect only after a restart, and restarting it from inside a plugin
+ * running in it kills the process answering you — with nothing to bring it
+ * back on a machine with no supervisor. So this reports, and the person
+ * decides when and where to act on it.
+ *
+ * Both halves degrade quietly. A version that cannot be read reports as
+ * unknown, and a registry that cannot be reached simply says nothing about
+ * what is published; neither is worth failing a command over.
+ */
+/** One package's installed and published versions. */
+export interface VersionReport {
+    readonly name: string;
+    readonly installed: string;
+    readonly latest?: string;
+    /** Whether what is published is newer than what is installed. */
+    readonly behind: boolean;
+}
+/** Fetching, injected so tests need no network. */
+export type FetchLike = (url: string, init: {
+    signal: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    json(): Promise<unknown>;
+}>;
+/** Construction options. */
+export interface VersionCheckOptions {
+    readonly fetchImpl?: FetchLike;
+    readonly cacheMs?: number;
+    readonly timeoutMs?: number;
+    readonly now?: () => number;
+}
+export declare class VersionCheck {
+    private readonly options;
+    private readonly cache;
+    constructor(options?: VersionCheckOptions);
+    /**
+     * Compare one installed version against what npm publishes.
+     *
+     * @param name - the package name.
+     * @param installed - the version running here.
+     */
+    check(name: string, installed: string): Promise<VersionReport>;
+    /** The published version, from cache when it is fresh enough. */
+    private latest;
+    /** Ask the registry, and say nothing if it cannot be reached. */
+    private ask;
+}
+/**
+ * Compare two semantic versions.
+ *
+ * Prereleases are the reason this is written out rather than compared as
+ * strings: the harness ships as `0.1.0-rc.8`, and `"0.1.0-rc.8" < "0.1.0-rc.10"`
+ * is false as text and true as versions.
+ *
+ * @returns negative when `a` is older, positive when newer, zero when equal.
+ */
+export declare function compareVersions(a: string, b: string): number;
+//# sourceMappingURL=versions.d.ts.map

package/lib/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC;IAC9E,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CACzB,CAAC,CAAA;AAEF,4BAA4B;AAC5B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgE;gBAEzD,OAAO,GAAE,mBAAwB;IAE9D;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUpE,iEAAiE;YACnD,MAAM;IAUpB,iEAAiE;YACnD,GAAG;CAwBlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5D"}

package/lib/versions.js

@@ -0,0 +1,135 @@
+/**
+ * What is installed here, and what is published.
+ *
+ * The question behind "should there be an /update" is really "am I behind?",
+ * and that one can be answered without any of the risk. Updating the harness
+ * takes effect only after a restart, and restarting it from inside a plugin
+ * running in it kills the process answering you — with nothing to bring it
+ * back on a machine with no supervisor. So this reports, and the person
+ * decides when and where to act on it.
+ *
+ * Both halves degrade quietly. A version that cannot be read reports as
+ * unknown, and a registry that cannot be reached simply says nothing about
+ * what is published; neither is worth failing a command over.
+ */
+/** How long a registry answer is good for. Long enough that /diag is free. */
+const CACHE_MS = 60 * 60 * 1000;
+/** How long to wait on the registry before giving up on it. */
+const TIMEOUT_MS = 4000;
+export class VersionCheck {
+    options;
+    cache = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Compare one installed version against what npm publishes.
+     *
+     * @param name - the package name.
+     * @param installed - the version running here.
+     */
+    async check(name, installed) {
+        const latest = await this.latest(name);
+        return {
+            name,
+            installed,
+            ...(latest === undefined ? {} : { latest }),
+            behind: latest !== undefined && compareVersions(installed, latest) < 0,
+        };
+    }
+    /** The published version, from cache when it is fresh enough. */
+    async latest(name) {
+        const now = this.options.now?.() ?? Date.now();
+        const cached = this.cache.get(name);
+        if (cached && now - cached.at < (this.options.cacheMs ?? CACHE_MS))
+            return cached.latest;
+        const latest = await this.ask(name);
+        this.cache.set(name, { at: now, latest });
+        return latest;
+    }
+    /** Ask the registry, and say nothing if it cannot be reached. */
+    async ask(name) {
+        const fetchImpl = this.options.fetchImpl ?? globalThis.fetch;
+        if (fetchImpl === undefined)
+            return undefined;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.options.timeoutMs ?? TIMEOUT_MS);
+        try {
+            // The `latest` dist-tag endpoint rather than the full document: a
+            // package's full metadata can be megabytes, and only one field is wanted.
+            const response = await fetchImpl(`https://registry.npmjs.org/${name.replace('/', '%2F')}/latest`, { signal: controller.signal });
+            if (!response.ok)
+                return undefined;
+            const body = (await response.json());
+            return typeof body.version === 'string' ? body.version : undefined;
+        }
+        catch {
+            return undefined;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+/**
+ * Compare two semantic versions.
+ *
+ * Prereleases are the reason this is written out rather than compared as
+ * strings: the harness ships as `0.1.0-rc.8`, and `"0.1.0-rc.8" < "0.1.0-rc.10"`
+ * is false as text and true as versions.
+ *
+ * @returns negative when `a` is older, positive when newer, zero when equal.
+ */
+export function compareVersions(a, b) {
+    const [coreA = '', preA = ''] = splitPrerelease(a);
+    const [coreB = '', preB = ''] = splitPrerelease(b);
+    const numbersA = coreA.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    const numbersB = coreB.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    for (let index = 0; index < Math.max(numbersA.length, numbersB.length); index += 1) {
+        const difference = (numbersA[index] ?? 0) - (numbersB[index] ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    // A release outranks any prerelease of the same core: 1.0.0 beats 1.0.0-rc.9.
+    if (preA === '' && preB === '')
+        return 0;
+    if (preA === '')
+        return 1;
+    if (preB === '')
+        return -1;
+    return comparePrerelease(preA, preB);
+}
+/** Split `1.2.3-rc.4` into its core and its prerelease. */
+function splitPrerelease(version) {
+    const trimmed = version.trim().replace(/^v/, '').split('+')[0] ?? '';
+    const dash = trimmed.indexOf('-');
+    return dash === -1 ? [trimmed, ''] : [trimmed.slice(0, dash), trimmed.slice(dash + 1)];
+}
+/** Compare prerelease tags dot-part by dot-part, numbers numerically. */
+function comparePrerelease(a, b) {
+    const partsA = a.split('.');
+    const partsB = b.split('.');
+    for (let index = 0; index < Math.max(partsA.length, partsB.length); index += 1) {
+        const one = partsA[index];
+        const two = partsB[index];
+        // A shorter prerelease sorts first: rc.1 is older than rc.1.1.
+        if (one === undefined)
+            return -1;
+        if (two === undefined)
+            return 1;
+        if (one === two)
+            continue;
+        const numericOne = /^\d+$/.test(one);
+        const numericTwo = /^\d+$/.test(two);
+        // Numeric parts compare as numbers, and always sort below alphanumeric.
+        if (numericOne && numericTwo)
+            return Number(one) - Number(two);
+        if (numericOne)
+            return -1;
+        if (numericTwo)
+            return 1;
+        return one < two ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=versions.js.map

package/lib/versions.js.map

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