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.
Files changed (2) hide show
  1. package/README.md +41 -13
  2. 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
- Create a `.env` file in your project root:
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
- 1. Ask for your **Bot Token** (from @BotFather)
236
- 2. Ask for your **Chat ID** (from @userinfobot)
237
- 3. Optionally enable **dry run mode**
238
- 4. Optionally generate a **GitHub Actions workflow**
239
- 5. Write your `.env` and add it to `.gitignore`
240
- 6. Send a **test message** to verify everything works
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
- npx iris-relay "Deploy complete ✅"
279
+ pnpm dlx iris-relay "Deploy complete ✅" # or: npx iris-relay "..."
252
280
 
253
281
  # Send with HTML
254
- npx iris-relay --html "<b>Bold</b> message"
282
+ pnpm dlx iris-relay --html "<b>Bold</b> message"
255
283
 
256
284
  # Send a file
257
- npx iris-relay --file ./logs/error.log "Error log attached"
285
+ pnpm dlx iris-relay --file ./logs/error.log "Error log attached"
258
286
 
259
287
  # Silent (no notification sound)
260
- npx iris-relay --silent "Background update"
288
+ pnpm dlx iris-relay --silent "Background update"
261
289
  ```
262
290
 
263
291
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iris-relay",
3
- "version": "1.1.4",
3
+ "version": "1.2.0",
4
4
  "description": "Lightweight Telegram message relay — dev tool for notifications, crash alerts, deploy pings, and more",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",