iris-relay 1.0.0 → 1.1.0

package/dist/file.js

@@ -0,0 +1,60 @@
+import { resolveConfig, isDryRun } from "./relay.js";
+import { createReadStream } from "node:fs";
+import { basename } from "node:path";
+import { stat } from "node:fs/promises";
+const TG_API = "https://api.telegram.org";
+/**
+ * Send a file to your Telegram chat via sendDocument API.
+ *
+ * @example
+ * ```ts
+ * import { relayFile } from "iris-relay";
+ * await relayFile("./logs/error.log", "Latest error log");
+ * ```
+ */
+export async function relayFile(filePath, caption, config) {
+    const { botToken, chatId, silent, parseMode } = resolveConfig(config);
+    if (isDryRun()) {
+        console.log(`[iris-relay DRY RUN] 📎 File: ${filePath}${caption ? ` — ${caption}` : ""}`);
+        return { success: true, messageId: 0 };
+    }
+    // Check file exists
+    try {
+        await stat(filePath);
+    }
+    catch {
+        return { success: false, error: `File not found: ${filePath}` };
+    }
+    const form = new FormData();
+    form.append("chat_id", chatId);
+    // Read file as buffer
+    const fileStream = createReadStream(filePath);
+    const chunks = [];
+    for await (const chunk of fileStream) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const fileBuffer = Buffer.concat(chunks);
+    const blob = new Blob([fileBuffer]);
+    form.append("document", blob, basename(filePath));
+    if (caption)
+        form.append("caption", caption);
+    if (parseMode)
+        form.append("parse_mode", parseMode);
+    if (silent)
+        form.append("disable_notification", "true");
+    try {
+        const res = await fetch(`${TG_API}/bot${botToken}/sendDocument`, {
+            method: "POST",
+            body: form,
+        });
+        const data = (await res.json());
+        if (!data.ok) {
+            return { success: false, error: data.description ?? `Telegram API error (${data.error_code})` };
+        }
+        return { success: true, messageId: data.result?.message_id };
+    }
+    catch (err) {
+        return { success: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,30 @@
+import type { RelayConfig, RelayResult, DeployMeta } from "./types.js";
+/**
+ * Relay a formatted error with stack trace to Telegram.
+ *
+ * @example
+ * ```ts
+ * catch (err) { await relayError(err); }
+ * ```
+ */
+export declare function relayError(err: unknown, config?: RelayConfig): Promise<RelayResult>;
+/**
+ * Relay a pretty-printed JSON object to Telegram.
+ *
+ * @example
+ * ```ts
+ * await relayJSON({ users: 42, status: "healthy" });
+ * ```
+ */
+export declare function relayJSON(obj: unknown, label?: string, config?: RelayConfig): Promise<RelayResult>;
+/**
+ * Send a deploy notification with optional git info.
+ * Auto-reads git branch/commit if not provided.
+ *
+ * @example
+ * ```ts
+ * await relayDeploy({ app: "my-api", env: "production" });
+ * ```
+ */
+export declare function relayDeploy(meta?: DeployMeta, config?: RelayConfig): Promise<RelayResult>;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGvE;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAUzF;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAKxG;AAWD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB/F"}

package/dist/format.js

@@ -0,0 +1,86 @@
+import { relay } from "./relay.js";
+import { execSync } from "node:child_process";
+/**
+ * Relay a formatted error with stack trace to Telegram.
+ *
+ * @example
+ * ```ts
+ * catch (err) { await relayError(err); }
+ * ```
+ */
+export async function relayError(err, config) {
+    let message;
+    if (err instanceof Error) {
+        message = `🚨 <b>Error:</b> ${escapeHtml(err.message)}\n\n<pre>${escapeHtml(err.stack ?? "No stack trace")}</pre>`;
+    }
+    else {
+        message = `🚨 <b>Error:</b>\n<pre>${escapeHtml(String(err))}</pre>`;
+    }
+    return relay(message, { parseMode: "HTML", ...config });
+}
+/**
+ * Relay a pretty-printed JSON object to Telegram.
+ *
+ * @example
+ * ```ts
+ * await relayJSON({ users: 42, status: "healthy" });
+ * ```
+ */
+export async function relayJSON(obj, label, config) {
+    const json = JSON.stringify(obj, null, 2);
+    const header = label ? `📋 <b>${escapeHtml(label)}</b>\n\n` : "";
+    const message = `${header}<pre>${escapeHtml(json)}</pre>`;
+    return relay(message, { parseMode: "HTML", ...config });
+}
+/** Try to read git info, returns undefined if git is not available */
+function tryGit(cmd) {
+    try {
+        return execSync(cmd, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Send a deploy notification with optional git info.
+ * Auto-reads git branch/commit if not provided.
+ *
+ * @example
+ * ```ts
+ * await relayDeploy({ app: "my-api", env: "production" });
+ * ```
+ */
+export async function relayDeploy(meta, config) {
+    const branch = meta?.branch ?? tryGit("git rev-parse --abbrev-ref HEAD");
+    const commit = meta?.commit ?? tryGit("git rev-parse --short HEAD");
+    const commitMsg = tryGit("git log -1 --pretty=%s");
+    const lines = ["🚀 <b>Deploy Notification</b>", ""];
+    if (meta?.app)
+        lines.push(`📦 <b>App:</b> ${escapeHtml(meta.app)}`);
+    if (meta?.env)
+        lines.push(`🌍 <b>Env:</b> ${escapeHtml(meta.env)}`);
+    if (meta?.version)
+        lines.push(`🏷️ <b>Version:</b> ${escapeHtml(meta.version)}`);
+    if (branch)
+        lines.push(`🌿 <b>Branch:</b> ${escapeHtml(branch)}`);
+    if (commit)
+        lines.push(`📝 <b>Commit:</b> <code>${escapeHtml(commit)}</code>${commitMsg ? ` — ${escapeHtml(commitMsg)}` : ""}`);
+    if (meta?.by)
+        lines.push(`👤 <b>By:</b> ${escapeHtml(meta.by)}`);
+    lines.push(`⏰ <b>Time:</b> ${new Date().toISOString()}`);
+    if (meta?.extra) {
+        for (const [key, value] of Object.entries(meta.extra)) {
+            lines.push(`• <b>${escapeHtml(key)}:</b> ${escapeHtml(value)}`);
+        }
+    }
+    return relay(lines.join("\n"), { parseMode: "HTML", ...config });
+}
+/** Escape HTML special characters for Telegram HTML parse mode */
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,9 @@
-export { relay, createRelay } from "./relay.js";
-export type { RelayConfig, RelayResult, TelegramResponse } from "./types.js";
+export { relay, createRelay, isDryRun } from "./relay.js";
+export { relayError, relayJSON, relayDeploy } from "./format.js";
+export { message, MessageBuilder } from "./builder.js";
+export { relayFile } from "./file.js";
+export { watchProcess, startHeartbeat } from "./watch.js";
+export { irisMiddleware, irisErrorHandler } from "./middleware.js";
+export { createChannels } from "./channels.js";
+export type { RelayConfig, RelayResult, TelegramResponse, DeployMeta, HeartbeatOptions, MiddlewareOptions, Channel, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,YAAY,EACR,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,15 @@
-export { relay, createRelay } from "./relay.js";
+// Core
+export { relay, createRelay, isDryRun } from "./relay.js";
+// Formatters
+export { relayError, relayJSON, relayDeploy } from "./format.js";
+// Message builder
+export { message, MessageBuilder } from "./builder.js";
+// File relay
+export { relayFile } from "./file.js";
+// Process monitoring
+export { watchProcess, startHeartbeat } from "./watch.js";
+// Middleware
+export { irisMiddleware, irisErrorHandler } from "./middleware.js";
+// Multi-channel
+export { createChannels } from "./channels.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1D,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE,kBAAkB;AAClB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvD,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,qBAAqB;AACrB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1D,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,25 @@
+import type { MiddlewareOptions, RelayConfig } from "./types.js";
+/**
+ * Express/Fastify-compatible middleware that reports errors and slow requests to Telegram.
+ *
+ * @example
+ * ```ts
+ * import express from "express";
+ * import { irisMiddleware } from "iris-relay";
+ *
+ * const app = express();
+ * app.use(irisMiddleware({ slowThreshold: 3000 }));
+ * ```
+ */
+export declare function irisMiddleware(options?: MiddlewareOptions): (req: any, res: any, next: any) => void;
+/**
+ * Express error-handling middleware that sends error details to Telegram.
+ *
+ * @example
+ * ```ts
+ * // Add AFTER all routes
+ * app.use(irisErrorHandler());
+ * ```
+ */
+export declare function irisErrorHandler(config?: RelayConfig): (err: any, req: any, res: any, next: any) => void;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,iBAAiB,IAS9C,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,UAkCxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,IACzC,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,UAclD"}

package/dist/middleware.js

@@ -0,0 +1,74 @@
+import { relay } from "./relay.js";
+/**
+ * Express/Fastify-compatible middleware that reports errors and slow requests to Telegram.
+ *
+ * @example
+ * ```ts
+ * import express from "express";
+ * import { irisMiddleware } from "iris-relay";
+ *
+ * const app = express();
+ * app.use(irisMiddleware({ slowThreshold: 3000 }));
+ * ```
+ */
+export function irisMiddleware(options) {
+    const { slowThreshold = 3000, reportErrors = true, reportSlow = true, relay: relayConfig, } = options ?? {};
+    // Standard Express middleware signature
+    return (req, res, next) => {
+        const start = Date.now();
+        const method = req.method;
+        const url = req.originalUrl || req.url;
+        // Hook into response finish to check timing
+        res.on("finish", async () => {
+            const duration = Date.now() - start;
+            const status = res.statusCode;
+            // Report slow requests
+            if (reportSlow && duration > slowThreshold) {
+                const msg = `🐢 <b>Slow Request</b>\n\n` +
+                    `<b>Method:</b> ${method}\n` +
+                    `<b>URL:</b> <code>${escapeHtml(url)}</code>\n` +
+                    `<b>Status:</b> ${status}\n` +
+                    `<b>Duration:</b> ${duration}ms (threshold: ${slowThreshold}ms)`;
+                relay(msg, { parseMode: "HTML", silent: true, ...relayConfig }).catch(() => { });
+            }
+            // Report server errors (5xx)
+            if (reportErrors && status >= 500) {
+                const msg = `🔥 <b>Server Error ${status}</b>\n\n` +
+                    `<b>Method:</b> ${method}\n` +
+                    `<b>URL:</b> <code>${escapeHtml(url)}</code>\n` +
+                    `<b>Duration:</b> ${duration}ms`;
+                relay(msg, { parseMode: "HTML", ...relayConfig }).catch(() => { });
+            }
+        });
+        next();
+    };
+}
+/**
+ * Express error-handling middleware that sends error details to Telegram.
+ *
+ * @example
+ * ```ts
+ * // Add AFTER all routes
+ * app.use(irisErrorHandler());
+ * ```
+ */
+export function irisErrorHandler(config) {
+    return (err, req, res, next) => {
+        const method = req.method;
+        const url = req.originalUrl || req.url;
+        const msg = `🚨 <b>Unhandled Error</b>\n\n` +
+            `<b>Method:</b> ${method}\n` +
+            `<b>URL:</b> <code>${escapeHtml(url)}</code>\n` +
+            `<b>Error:</b> ${escapeHtml(err.message ?? String(err))}\n\n` +
+            `<pre>${escapeHtml(err.stack ?? "No stack trace")}</pre>`;
+        relay(msg, { parseMode: "HTML", ...config }).catch(() => { });
+        next(err);
+    };
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACtD,MAAM,EACF,aAAa,GAAG,IAAI,EACpB,YAAY,GAAG,IAAI,EACnB,UAAU,GAAG,IAAI,EACjB,KAAK,EAAE,WAAW,GACrB,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,wCAAwC;IACxC,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG,CAAC;QAEvC,4CAA4C;QAC5C,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACpC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC;YAE9B,uBAAuB;YACvB,IAAI,UAAU,IAAI,QAAQ,GAAG,aAAa,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,4BAA4B;oBACpC,kBAAkB,MAAM,IAAI;oBAC5B,qBAAqB,UAAU,CAAC,GAAG,CAAC,WAAW;oBAC/C,kBAAkB,MAAM,IAAI;oBAC5B,oBAAoB,QAAQ,kBAAkB,aAAa,KAAK,CAAC;gBAErE,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YACrF,CAAC;YAED,6BAA6B;YAC7B,IAAI,YAAY,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,sBAAsB,MAAM,UAAU;oBAC9C,kBAAkB,MAAM,IAAI;oBAC5B,qBAAqB,UAAU,CAAC,GAAG,CAAC,WAAW;oBAC/C,oBAAoB,QAAQ,IAAI,CAAC;gBAErC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YACvE,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACX,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACjD,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,GAAQ,EAAE,IAAS,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG,CAAC;QAEvC,MAAM,GAAG,GAAG,+BAA+B;YACvC,kBAAkB,MAAM,IAAI;YAC5B,qBAAqB,UAAU,CAAC,GAAG,CAAC,WAAW;YAC/C,iBAAiB,UAAU,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM;YAC7D,QAAQ,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAE9D,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAE9D,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC5B,OAAO,IAAI;SACN,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/relay.d.ts

@@ -1,27 +1,22 @@
 import type { RelayConfig, RelayResult } from "./types.js";
+/** Check if dry run mode is enabled */
+export declare function isDryRun(): boolean;
+export declare function resolveConfig(overrides?: RelayConfig): {
+    botToken: string;
+    chatId: string;
+    parseMode?: "HTML" | "Markdown" | "MarkdownV2";
+    disablePreview?: boolean;
+    silent?: boolean;
+    retries?: number;
+    retryDelay?: number;
+};
 /**
- * Send a one-off message to your Telegram chat.
- *
- * Reads `IRIS_BOT_TOKEN` and `IRIS_CHAT_ID` from env, or accepts them via config.
- *
- * @example
- * ```ts
- * import { relay } from "iris";
- * await relay("Hello from my server!");
- * ```
+ * Send a message to your Telegram chat.
+ * Supports dry run mode, retries with exponential backoff.
  */
 export declare function relay(message: string, config?: RelayConfig): Promise<RelayResult>;
 /**
  * Create a pre-configured relay function with baked-in credentials.
- *
- * @example
- * ```ts
- * import { createRelay } from "iris";
- *
- * const send = createRelay({ botToken: "...", chatId: "..." });
- * await send("Deploy successful ✅");
- * await send("Build failed ❌");
- * ```
  */
 export declare function createRelay(config: RelayConfig): (message: string, overrides?: Partial<RelayConfig>) => Promise<RelayResult>;
 //# sourceMappingURL=relay.d.ts.map

package/dist/relay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAkB7E;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,IAEnC,SAAS,MAAM,EAAE,YAAY,OAAO,CAAC,WAAW,CAAC,KAAG,OAAO,CAAC,WAAW,CAAC,CAEnF"}
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAO7E,uCAAuC;AACvC,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW;;;;;;;;EAUpD;AAOD;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAiDvF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,IAEnC,SAAS,MAAM,EAAE,YAAY,OAAO,CAAC,WAAW,CAAC,KAAG,OAAO,CAAC,WAAW,CAAC,CAEnF"}

package/dist/relay.js

@@ -2,7 +2,11 @@ import { config } from "dotenv";
 // Auto-load .env on import — true plug-and-play
 config();
 const TG_API = "https://api.telegram.org";
-function resolveConfig(overrides) {
+/** Check if dry run mode is enabled */
+export function isDryRun() {
+    return process.env.XERO_DRY_RUN === "true" || process.env.XERO_DRY_RUN === "1";
+}
+export function resolveConfig(overrides) {
     const botToken = overrides?.botToken
         ?? process.env.XERO_BOT_TOKEN;
     const chatId = overrides?.chatId
@@ -13,47 +17,58 @@ function resolveConfig(overrides) {
         throw new Error("iris: chatId is required — pass it in config or set XERO_CHAT_ID env var");
     return { botToken, chatId, ...overrides };
 }
+/** Sleep helper for retry backoff */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 /**
- * Send a one-off message to your Telegram chat.
- *
- * Reads `IRIS_BOT_TOKEN` and `IRIS_CHAT_ID` from env, or accepts them via config.
- *
- * @example
- * ```ts
- * import { relay } from "iris";
- * await relay("Hello from my server!");
- * ```
+ * Send a message to your Telegram chat.
+ * Supports dry run mode, retries with exponential backoff.
  */
 export async function relay(message, config) {
-    const { botToken, chatId, parseMode, disablePreview, silent } = resolveConfig(config);
-    const res = await fetch(`${TG_API}/bot${botToken}/sendMessage`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            chat_id: chatId,
-            text: message,
-            ...(parseMode && { parse_mode: parseMode }),
-            ...(disablePreview && { disable_web_page_preview: true }),
-            ...(silent && { disable_notification: true }),
-        }),
-    });
-    const data = (await res.json());
-    if (!data.ok) {
-        return { success: false, error: data.description ?? `Telegram API error (${data.error_code})` };
+    const { botToken, chatId, parseMode, disablePreview, silent, retries = 0, retryDelay = 1000 } = resolveConfig(config);
+    // Dry run — log to console instead
+    if (isDryRun()) {
+        console.log(`[iris-relay DRY RUN] → ${message}`);
+        return { success: true, messageId: 0 };
+    }
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        if (attempt > 0) {
+            const delay = retryDelay * Math.pow(2, attempt - 1);
+            console.log(`[iris-relay] Retry ${attempt}/${retries} in ${delay}ms...`);
+            await sleep(delay);
+        }
+        try {
+            const res = await fetch(`${TG_API}/bot${botToken}/sendMessage`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    chat_id: chatId,
+                    text: message,
+                    ...(parseMode && { parse_mode: parseMode }),
+                    ...(disablePreview && { disable_web_page_preview: true }),
+                    ...(silent && { disable_notification: true }),
+                }),
+            });
+            const data = (await res.json());
+            if (data.ok) {
+                return { success: true, messageId: data.result?.message_id };
+            }
+            lastError = data.description ?? `Telegram API error (${data.error_code})`;
+            // Don't retry on 4xx client errors (bad token, bad chat id, etc.)
+            if (data.error_code && data.error_code >= 400 && data.error_code < 500) {
+                return { success: false, error: lastError };
+            }
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : String(err);
+        }
     }
-    return { success: true, messageId: data.result?.message_id };
+    return { success: false, error: lastError };
 }
 /**
  * Create a pre-configured relay function with baked-in credentials.
- *
- * @example
- * ```ts
- * import { createRelay } from "iris";
- *
- * const send = createRelay({ botToken: "...", chatId: "..." });
- * await send("Deploy successful ✅");
- * await send("Build failed ❌");
- * ```
  */
 export function createRelay(config) {
     const resolved = resolveConfig(config);

package/dist/relay.js.map

@@ -1 +1 @@
-{"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,gDAAgD;AAChD,MAAM,EAAE,CAAC;AAET,MAAM,MAAM,GAAG,0BAA0B,CAAC;AAE1C,SAAS,aAAa,CAAC,SAAuB;IAC1C,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ;WAC7B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClC,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM;WACzB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAChC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAC/G,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAEzG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe,EAAE,MAAoB;IAC7D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,OAAO,QAAQ,cAAc,EAAE;QAC5D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACjB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,OAAO;YACb,GAAG,CAAC,SAAS,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;YAC3C,GAAG,CAAC,cAAc,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC;YACzD,GAAG,CAAC,MAAM,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;SAChD,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqB,CAAC;IAEpD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,uBAAuB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACpG,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,OAAe,EAAE,SAAgC,EAAwB,EAAE,CAC/E,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+/** Core relay config */
 export interface RelayConfig {
     /** Telegram Bot API token from @BotFather */
     botToken?: string;
@@ -9,6 +10,10 @@ export interface RelayConfig {
     disablePreview?: boolean;
     /** Send message silently (no notification sound) */
     silent?: boolean;
+    /** Max retries on failure (default: 0) */
+    retries?: number;
+    /** Base delay in ms for exponential backoff (default: 1000) */
+    retryDelay?: number;
 }
 export interface TelegramResponse {
     ok: boolean;
@@ -18,7 +23,7 @@ export interface TelegramResponse {
             id: number;
             type: string;
         };
-        text: string;
+        text?: string;
         date: number;
     };
     description?: string;
@@ -29,4 +34,52 @@ export interface RelayResult {
     messageId?: number;
     error?: string;
 }
+/** Deploy metadata for relayDeploy() */
+export interface DeployMeta {
+    /** App or service name */
+    app?: string;
+    /** Environment (production, staging, etc.) */
+    env?: string;
+    /** Version string */
+    version?: string;
+    /** Git branch */
+    branch?: string;
+    /** Git commit hash */
+    commit?: string;
+    /** Deployer name */
+    by?: string;
+    /** Custom extra fields */
+    extra?: Record<string, string>;
+}
+/** Heartbeat options */
+export interface HeartbeatOptions {
+    /** Interval in ms (default: 60000 = 1 minute) */
+    interval?: number;
+    /** Custom message (default: "💓 Heartbeat — {app} is alive") */
+    message?: string;
+    /** App name for the heartbeat message */
+    app?: string;
+}
+/** Middleware options for Express/Fastify */
+export interface MiddlewareOptions {
+    /** Slow request threshold in ms (default: 3000) */
+    slowThreshold?: number;
+    /** Report errors to Telegram (default: true) */
+    reportErrors?: boolean;
+    /** Report slow requests to Telegram (default: true) */
+    reportSlow?: boolean;
+    /** Relay config overrides */
+    relay?: RelayConfig;
+}
+/** Channel definition for multi-channel support */
+export interface Channel {
+    name: string;
+    chatId: string;
+    /** Optional separate bot token per channel */
+    botToken?: string;
+    /** Default parse mode for this channel */
+    parseMode?: RelayConfig["parseMode"];
+    /** Send silently by default */
+    silent?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACnC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,WAAW,WAAW;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACnC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACvB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAC9B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/watch.d.ts

@@ -0,0 +1,26 @@
+import type { RelayConfig, HeartbeatOptions } from "./types.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 declare function watchProcess(config?: RelayConfig): void;
+/**
+ * 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 declare function startHeartbeat(options?: HeartbeatOptions, config?: RelayConfig): () => void;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CA2BvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAiB3F"}