iris-relay 1.0.0 → 1.1.0

package/dist/watch.js

@@ -0,0 +1,70 @@
+import { relay } from "./relay.js";
+import { relayError } from "./format.js";
+/**
+ * Watch for uncaught exceptions and unhandled rejections.
+ * Sends crash reports to Telegram before the process exits.
+ *
+ * @example
+ * ```ts
+ * import { watchProcess } from "iris-relay";
+ * watchProcess(); // done — crashes get reported
+ * ```
+ */
+export function watchProcess(config) {
+    process.on("uncaughtException", async (err) => {
+        console.error("[iris-relay] Uncaught Exception:", err);
+        try {
+            await relayError(err, config);
+        }
+        catch { /* don't throw during crash handler */ }
+        process.exit(1);
+    });
+    process.on("unhandledRejection", async (reason) => {
+        console.error("[iris-relay] Unhandled Rejection:", reason);
+        try {
+            const err = reason instanceof Error ? reason : new Error(String(reason));
+            await relayError(err, config);
+        }
+        catch { /* don't throw during crash handler */ }
+    });
+    // Notify on graceful shutdown
+    const signals = ["SIGINT", "SIGTERM"];
+    for (const signal of signals) {
+        process.on(signal, async () => {
+            try {
+                await relay(`⚠️ Process received ${signal} — shutting down`, config);
+            }
+            catch { /* best effort */ }
+            process.exit(0);
+        });
+    }
+}
+/**
+ * Start sending periodic heartbeat messages.
+ * Returns a cleanup function to stop the heartbeat.
+ *
+ * @example
+ * ```ts
+ * import { startHeartbeat } from "iris-relay";
+ *
+ * const stop = startHeartbeat({ interval: 60000, app: "my-api" });
+ * // Later: stop();
+ * ```
+ */
+export function startHeartbeat(options, config) {
+    const interval = options?.interval ?? 60_000;
+    const app = options?.app ?? "Service";
+    const msg = options?.message ?? `💓 Heartbeat — <b>${app}</b> is alive`;
+    const id = setInterval(async () => {
+        try {
+            await relay(msg, { parseMode: "HTML", silent: true, ...config });
+        }
+        catch (err) {
+            console.error("[iris-relay] Heartbeat failed:", err);
+        }
+    }, interval);
+    // Don't prevent process from exiting
+    id.unref();
+    return () => clearInterval(id);
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC7C,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1C,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC;YACD,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAC,sCAAsC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC9C,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACzE,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAC,sCAAsC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,OAAO,GAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC;gBACD,MAAM,KAAK,CAAC,uBAAuB,MAAM,kBAAkB,EAAE,MAAM,CAAC,CAAC;YACzE,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAA0B,EAAE,MAAoB;IAC3E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,SAAS,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,EAAE,OAAO,IAAI,qBAAqB,GAAG,eAAe,CAAC;IAExE,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC9B,IAAI,CAAC;YACD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;IACL,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEb,qCAAqC;IACrC,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "iris-relay",
-  "version": "1.0.0",
-  "description": "Lightweight, zero-dependency Telegram message relay",
+  "version": "1.1.0",
+  "description": "Lightweight Telegram message relay — dev tool for notifications, crash alerts, deploy pings, and more",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "iris-relay": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,7 +22,12 @@
     "relay",
     "bot",
     "message",
-    "notification"
+    "notification",
+    "devtool",
+    "crash-reporter",
+    "deploy",
+    "heartbeat",
+    "monitoring"
   ],
   "author": "",
   "license": "MIT",
@@ -27,14 +35,14 @@
     "node": ">=18"
   },
   "sideEffects": false,
+  "dependencies": {
+    "dotenv": "^17.3.1"
+  },
   "devDependencies": {
     "@types/node": "^25.3.5",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "dependencies": {
-    "dotenv": "^17.3.1"
-  },
   "scripts": {
     "build": "tsc",
     "test": "tsx test.ts"