iris-relay 1.1.4 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,17 +5,30 @@ Lightweight Telegram relay dev tool — crash alerts, deploy notifications, hear
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
+
# pnpm
|
|
8
9
|
pnpm add iris-relay
|
|
10
|
+
|
|
11
|
+
# npm
|
|
12
|
+
npm install iris-relay
|
|
9
13
|
```
|
|
10
14
|
|
|
11
15
|
## Setup
|
|
12
16
|
|
|
13
|
-
|
|
17
|
+
Run the interactive setup wizard:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
# pnpm
|
|
21
|
+
pnpm dlx iris-relay init
|
|
22
|
+
|
|
23
|
+
# npm
|
|
24
|
+
npx iris-relay init
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Or manually create a `.env` file:
|
|
14
28
|
|
|
15
29
|
```env
|
|
16
30
|
XERO_BOT_TOKEN=your_bot_token_from_botfather
|
|
17
31
|
XERO_CHAT_ID=your_telegram_chat_id
|
|
18
|
-
XERO_DRY_RUN=false
|
|
19
32
|
```
|
|
20
33
|
|
|
21
34
|
> **Bot Token** → [@BotFather](https://t.me/BotFather) · **Chat ID** → [@userinfobot](https://t.me/userinfobot)
|
|
@@ -228,16 +241,31 @@ Set `XERO_DRY_RUN=true` in `.env` to log messages to console instead of sending
|
|
|
228
241
|
## Getting Started
|
|
229
242
|
|
|
230
243
|
```bash
|
|
244
|
+
# pnpm
|
|
245
|
+
pnpm dlx iris-relay init
|
|
246
|
+
|
|
247
|
+
# npm
|
|
231
248
|
npx iris-relay init
|
|
232
249
|
```
|
|
233
250
|
|
|
234
251
|
The setup wizard will:
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
252
|
+
|
|
253
|
+
**Step 1 — Credentials**
|
|
254
|
+
- Ask for your **Bot Token** (from @BotFather)
|
|
255
|
+
- Ask for your **Chat ID** (from @userinfobot)
|
|
256
|
+
|
|
257
|
+
**Step 2 — Features** (auto-detects your framework & package manager)
|
|
258
|
+
- 🛡️ Crash watcher — auto-report uncaught exceptions
|
|
259
|
+
- 💓 Heartbeat — periodic alive pings with custom interval
|
|
260
|
+
- 🔌 Express/Fastify middleware — slow request & error reporting (only if detected)
|
|
261
|
+
- 🧪 Dry run mode — log to console instead of sending
|
|
262
|
+
|
|
263
|
+
**Step 3 — Scaffolding**
|
|
264
|
+
- 📄 Generates `iris.ts` or `iris.js` starter file with selected features pre-wired
|
|
265
|
+
- 🚀 GitHub Actions deploy notification workflow
|
|
266
|
+
- 🐳 Docker Compose env var setup
|
|
267
|
+
|
|
268
|
+
**Then** → writes `.env`, updates `.gitignore`, sends a test message ✅
|
|
241
269
|
|
|
242
270
|
---
|
|
243
271
|
|
|
@@ -245,19 +273,19 @@ The setup wizard will:
|
|
|
245
273
|
|
|
246
274
|
```bash
|
|
247
275
|
# Interactive setup
|
|
248
|
-
npx iris-relay init
|
|
276
|
+
pnpm dlx iris-relay init # or: npx iris-relay init
|
|
249
277
|
|
|
250
278
|
# Send a message
|
|
251
|
-
|
|
279
|
+
pnpm dlx iris-relay "Deploy complete ✅" # or: npx iris-relay "..."
|
|
252
280
|
|
|
253
281
|
# Send with HTML
|
|
254
|
-
|
|
282
|
+
pnpm dlx iris-relay --html "<b>Bold</b> message"
|
|
255
283
|
|
|
256
284
|
# Send a file
|
|
257
|
-
|
|
285
|
+
pnpm dlx iris-relay --file ./logs/error.log "Error log attached"
|
|
258
286
|
|
|
259
287
|
# Silent (no notification sound)
|
|
260
|
-
|
|
288
|
+
pnpm dlx iris-relay --silent "Background update"
|
|
261
289
|
```
|
|
262
290
|
|
|
263
291
|
---
|
package/package.json
CHANGED