@wrongstack/telegram 0.295.1 → 0.296.3

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.1",
+  "version": "0.296.3",
   "license": "MIT",
   "description": "WrongStack plugin — Telegram bridge: send messages, receive prompts, get notified.",
   "repository": {
@@ -25,12 +25,12 @@
     "dist"
   ],
   "peerDependencies": {
-    "@wrongstack/core": "0.295.1"
+    "@wrongstack/core": "0.296.3"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
     "typescript": "^7.0.2",
-    "@wrongstack/core": "0.295.1"
+    "@wrongstack/core": "0.296.3"
   },
   "publishConfig": {
     "access": "public"