@wrongstack/telegram 0.295.0 → 0.296.2

package/dist/outbound-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbound-queue.d.ts","sourceRoot":"","sources":["../src/outbound-queue.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAaD,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAWD,qBAAa,aAAa;;IAqBxB,YAAY,IAAI,EAAE,oBAAoB,EASrC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA0D9C;IAED,0EAA0E;IAC1E,KAAK,IAAI,kBAAkB,CAW1B;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1B;CAyFF"}
+{"version":3,"file":"outbound-queue.d.ts","sourceRoot":"","sources":["../src/outbound-queue.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAaD,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAWD,qBAAa,aAAa;;IAqBxB,YAAY,IAAI,EAAE,oBAAoB,EASrC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA6D9C;IAED,0EAA0E;IAC1E,KAAK,IAAI,kBAAkB,CAW1B;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1B;CAuFF"}

package/dist/poll-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poll-lock.d.ts","sourceRoot":"","sources":["../src/poll-lock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAsBrD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAqB,GAAG,MAAM,CAGvF;AAED,qBAAa,QAAQ;IAYjB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAX3B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,KAAK,CAAS;IAEtB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAElC,YACW,QAAQ,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,eAAe,EAKvB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;;OAGG;IACH,UAAU,IAAI,OAAO,CA8BpB;IAED,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CASd;IAMD,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;CAUnB"}
+{"version":3,"file":"poll-lock.d.ts","sourceRoot":"","sources":["../src/poll-lock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAsBrD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAqB,GAAG,MAAM,CAGvF;AAED,qBAAa,QAAQ;IAYjB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAX3B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,KAAK,CAAS;IAEtB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAElC,YACW,QAAQ,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,eAAe,EAKvB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;;OAGG;IACH,UAAU,IAAI,OAAO,CA8BpB;IAED,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CASd;IAMD,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;CAUnB"}

package/dist/rate-limiter.d.ts

@@ -9,6 +9,13 @@ export interface TokenBucket {
     waitForToken(timeoutMs?: number | undefined): Promise<void>;
     /** Current fill level (for diagnostics). */
     fill(): number;
+    /**
+     * True once the bucket has refilled to full capacity. A full, idle bucket
+     * holds no pacing state — recreating it yields an identical full bucket — so
+     * callers can safely evict it to bound a per-chat bucket map without losing
+     * any rate-limit state. A depleted (in-use) bucket is never full.
+     */
+    isFull(): boolean;
 }
 /**
  * Create a token bucket for a single chat.

package/dist/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,4CAA4C;IAC5C,IAAI,IAAI,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAoDxE"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,4CAA4C;IAC5C,IAAI,IAAI,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAyDxE"}

package/dist/telemetry.d.ts

@@ -0,0 +1,106 @@
+import type { Logger } from '@wrongstack/core/types';
+/** Single counter with last-update timestamp. */
+export interface Counter {
+    /** Total number of occurrences since the counter was created. */
+    count: number;
+    /** ISO-8601 timestamp of the most recent increment. */
+    lastAt: string;
+}
+export interface Gauge {
+    /** Current value. */
+    value: number;
+}
+export interface Histogram {
+    count: number;
+    min: number;
+    max: number;
+    sum: number;
+}
+export interface TelegramTelemetrySnapshot {
+    /** Time this snapshot was generated. */
+    generatedAt: string;
+    poll: {
+        /** Total successful polls. */
+        success: Counter;
+        /** Total failed polls (any error). */
+        failure: Counter;
+        /** Current poll latency histogram (ms). */
+        latencyMs: Histogram;
+        /** Consecutive HTTP 409 conflict streak (reset on success). */
+        conflictStreak: Gauge;
+    };
+    updates: {
+        /** Total updates received via getUpdates. */
+        received: Counter;
+        /** Updates accepted (passed inbound auth). */
+        accepted: Counter;
+        /** Updates rejected (failed inbound auth). */
+        rejected: Counter;
+        /** Callback queries received. */
+        callbacks: Counter;
+        /** Callback queries settled (approved/denied). */
+        callbacksSettled: Counter;
+        /** Deduplicated updates (same update_id seen again). */
+        deduplicated: Counter;
+        /** Current cursor offset. */
+        cursorOffset: Gauge;
+    };
+    retry: {
+        /** Total retry attempts across all operations. */
+        attempts: Counter;
+        /** HTTP 429 rate-limit responses handled. */
+        rateLimited: Counter;
+        /** Terminal (non-retryable) errors. */
+        terminalErrors: Counter;
+    };
+    queue: {
+        /** Total items enqueued (all kinds). */
+        enqueued: Counter;
+        /** Total items sent successfully. */
+        sent: Counter;
+        /** Total items dropped (overflow). */
+        dropped: Counter;
+        /** Total send failures. */
+        failures: Counter;
+        /** Current in-flight count. */
+        inflight: Gauge;
+        /** Current pending count. */
+        pending: Gauge;
+    };
+    approvals: {
+        /** Total approval requests created. */
+        created: Counter;
+        /** Approvals that timed out. */
+        timedOut: Counter;
+        /** Approvals that were cancelled (abort). */
+        cancelled: Counter;
+        /** Approvals settled by user action. */
+        settled: Counter;
+    };
+    locks: {
+        /** Acquire attempts (including re-acquire). */
+        acquireAttempts: Counter;
+        /** Successful acquires. */
+        acquires: Counter;
+        /** Lost locks (stolen by another instance). */
+        lost: Counter;
+        /** Releases. */
+        releases: Counter;
+        /** Current held state. */
+        held: Gauge;
+    };
+}
+export declare function newCounter(): Counter;
+export declare function bumpCounter(c: Counter): void;
+export declare function newGauge(v?: number): Gauge;
+export declare function newHistogram(): Histogram;
+export declare function observeHistogram(h: Histogram, ms: number): void;
+export declare class TelegramTelemetry {
+    readonly snapshot: TelegramTelemetrySnapshot;
+    constructor();
+    /** Produce a snapshot and log key metrics. The host Logger contract is
+     *  string-only, so we format counters into one concise line that can be
+     *  grepped for `telegram.metrics`. */
+    logSnapshot(log: Logger): void;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

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

package/package.json

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