@statocysts/cli 0.2.2

package/README.md

@@ -0,0 +1,80 @@
+# @statocysts/cli
+
+Command-line interface for [statocysts](https://github.com/octoplorer/statocysts) notification library.
+
+## Installation
+
+```bash
+npm install -g @statocysts/cli
+# or
+pnpm add -g @statocysts/cli
+```
+
+## Usage
+
+```bash
+statocysts -u <url> [-m <message> | -f <file>]
+```
+
+### Options
+
+| Option      | Alias | Description                                                   |
+| ----------- | ----- | ------------------------------------------------------------- |
+| `--url`     | `-u`  | Notification service URL(s). Can be specified multiple times. |
+| `--message` | `-m`  | Message content to send directly.                             |
+| `--file`    | `-f`  | Read message content from a file.                             |
+| `--help`    |       | Show help information.                                        |
+| `--version` |       | Show version number.                                          |
+
+### Message Priority
+
+The message content is determined in the following order:
+
+1. `--message` argument (highest priority)
+2. `--file` argument
+3. Standard input (stdin)
+
+## Examples
+
+### Send to a single URL
+
+```bash
+statocysts -u "slack://webhook/xxx/yyy/zzz" -m "Hello World"
+```
+
+### Send to multiple URLs
+
+```bash
+statocysts -u "slack://webhook/xxx/yyy/zzz" -u "json://example.com/api/notify" -m "Hello World"
+```
+
+### Read message from file
+
+```bash
+statocysts -u "slack://webhook/xxx/yyy/zzz" -f message.txt
+```
+
+### Read message from stdin
+
+```bash
+echo "Hello World" | statocysts -u "slack://webhook/xxx/yyy/zzz"
+```
+
+### Use with pipeline
+
+```bash
+cat deployment.log | statocysts -u "slack://webhook/xxx/yyy/zzz"
+```
+
+## Supported Services
+
+This CLI supports all notification services provided by statocysts:
+
+- **Slack**: `slack://webhook/xxx/yyy/zzz` or `slack://bot@channel:token`
+- **JSON**: `json://example.com/api/endpoint`
+
+For more details on URL formats, please refer to the [statocysts documentation](https://github.com/octoplorer/statocysts).
+
+## License
+
+MIT

package/dist/cli.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import process from "node:process";
+import * as readline from "node:readline";
+import { send } from "statocysts";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+
+//#region src/cli.ts
+/**
+* Read message content from stdin
+*/
+async function readFromStdin() {
+	if (process.stdin.isTTY) return "";
+	return new Promise((resolve, reject) => {
+		const rl = readline.createInterface({
+			input: process.stdin,
+			terminal: false
+		});
+		const lines = [];
+		rl.on("line", (line) => {
+			lines.push(line);
+		});
+		rl.on("close", () => {
+			resolve(lines.join("\n"));
+		});
+		rl.on("error", reject);
+	});
+}
+/**
+* Get message content from various sources
+* Priority: --message > --file > stdin
+*/
+async function getMessage(args) {
+	if (args.message) return args.message;
+	if (args.file) try {
+		return fs.readFileSync(args.file, "utf-8").trim();
+	} catch (error) {
+		throw new Error(`Failed to read file "${args.file}": ${error.message}`);
+	}
+	const stdinContent = await readFromStdin();
+	if (stdinContent) return stdinContent.trim();
+	return "";
+}
+/**
+* Send notifications to all specified URLs
+*/
+async function sendNotifications(urls, message) {
+	const results = await Promise.allSettled(urls.map((url) => send(url, message)));
+	const failures = [];
+	results.forEach((result, index) => {
+		if (result.status === "rejected") failures.push({
+			url: urls[index],
+			error: result.reason?.message || String(result.reason)
+		});
+	});
+	if (failures.length > 0) {
+		console.error("\nFailed to send to some URLs:");
+		failures.forEach(({ url, error }) => {
+			console.error(`  - ${url}: ${error}`);
+		});
+		if (failures.length === urls.length) process.exit(1);
+	}
+}
+async function main() {
+	const argv = await yargs(hideBin(process.argv)).scriptName("statocysts").usage("$0 -u <url> [-m <message> | -f <file>]").option("url", {
+		alias: "u",
+		type: "string",
+		array: true,
+		demandOption: true,
+		description: "Notification service URL(s)"
+	}).option("message", {
+		alias: "m",
+		type: "string",
+		description: "Message content to send"
+	}).option("file", {
+		alias: "f",
+		type: "string",
+		description: "Read message content from file"
+	}).example([
+		["$0 -u \"slack://webhook/xxx/yyy/zzz\" -m \"Hello World\"", "Send message to Slack webhook"],
+		["$0 -u \"slack://webhook/a/b/c\" -u \"json://example.com/api\" -m \"Hello\"", "Send to multiple URLs"],
+		["$0 -u \"slack://webhook/xxx/yyy/zzz\" -f message.txt", "Send message from file"],
+		["echo \"Hello\" | $0 -u \"slack://webhook/xxx/yyy/zzz\"", "Send message from stdin"]
+	]).help().version().strict().parse();
+	try {
+		const message = await getMessage(argv);
+		if (!message) {
+			console.error("Error: No message provided. Use -m, -f, or pipe content via stdin.");
+			process.exit(1);
+		}
+		await sendNotifications(argv.url, message);
+		console.log("Notification sent successfully!");
+	} catch (error) {
+		console.error(`Error: ${error.message}`);
+		process.exit(1);
+	}
+}
+main();
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@statocysts/cli",
+  "type": "module",
+  "version": "0.2.2",
+  "description": "CLI for statocysts notification library",
+  "license": "MIT",
+  "homepage": "https://github.com/octoplorer/statocysts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/octoplorer/statocysts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/octoplorer/statocysts/issues"
+  },
+  "keywords": [
+    "notification",
+    "cli",
+    "statocysts"
+  ],
+  "bin": {
+    "stato": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=23"
+  },
+  "dependencies": {
+    "yargs": "^18.0.0",
+    "statocysts": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/yargs": "^17.0.35",
+    "tsdown": "^0.18.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}