cc-peer 1.6.2 → 1.6.4

package/README.md

@@ -1,6 +1,6 @@
 # cc-peer
 
-[![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/cc-peer) [![npm](https://img.shields.io/npm/v/cc-peer)](https://www.npmjs.com/package/cc-peer) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/cc-peer/ci.yml?branch=main)](https://github.com/ExaDev/cc-peer/actions)
+[![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/cc-peer) [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/cc-peer) [![Release](https://img.shields.io/github/v/release/ExaDev/cc-peer)](https://github.com/ExaDev/cc-peer/releases/latest) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/cc-peer/ci.yml?branch=main)](https://github.com/ExaDev/cc-peer/actions)
 
 Talk to the Claude Code instances running on your machine, from any Node application: send messages, register as a named peer other sessions can discover and message, receive replies and delivery receipts, and subscribe to idle notifications. Ships a REST facade you can run with `npx cc-peer`.
 
@@ -57,6 +57,8 @@ await peer.stop();
 
 Every release is also mirrored to the GitHub Packages registry as `@exadev/cc-peer` (GitHub Packages requires owner-scoped names), and single-executable binaries ship as release assets for every platform/architecture pair Node's own SEA feature supports (see Limitations for the one exception).
 
+`npx cc-peer --help` prints the options: `--port` and `--token` choose the listening port and bearer token, `--no-token` disables authentication, `--name` sets the peer name, and `--home` overrides the home directory holding `.claude`. An unknown option exits non-zero without starting anything.
+
 The REST facade (`npx cc-peer`) serves `GET /sessions`, `POST /messages`, `POST /idle-subscriptions`, `GET /events` (SSE), and a self-describing `GET /openapi.json` on loopback with a bearer token.
 
 ### Session discovery and reply aliases

package/dist/adapters/node/alias-worker.cjs

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require("../../rolldown-runtime-VH7oDXx4.cjs");
-const require_cc_peer = require("../../cc-peer-DNB8oHNm.cjs");
+const require_cc_peer = require("../../cc-peer-CUt7BwyE.cjs");
 const require_errors = require("../../errors-BAbklcGw.cjs");
 const require_alias_ipc = require("../../alias-ipc-BPc2wfmz.cjs");
 let node_process = require("node:process");

package/dist/adapters/node/alias-worker.mjs

@@ -1,4 +1,4 @@
-import { n as CcPeer } from "../../cc-peer-zz8MzHY8.mjs";
+import { n as CcPeer } from "../../cc-peer-8l2Nyivq.mjs";
 import { r as CcPeerError } from "../../errors-KYBco8pU.mjs";
 import { t as AliasCommandSchema } from "../../alias-ipc-BSh7Q4LL.mjs";
 import process from "node:process";

package/dist/bin/cc-peer.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 const require_rolldown_runtime = require("../rolldown-runtime-VH7oDXx4.cjs");
-const require_cc_peer = require("../cc-peer-DNB8oHNm.cjs");
+const require_cc_peer = require("../cc-peer-CUt7BwyE.cjs");
 const require_errors = require("../errors-BAbklcGw.cjs");
 let node_crypto = require("node:crypto");
 let zod = require("zod");
@@ -340,29 +340,82 @@ function openApiDocument() {
 }
 //#endregion
 //#region src/bin/main.ts
+const USAGE = `Usage: cc-peer [options]
+
+Starts the cc-peer REST facade on loopback and registers a peer for this process.
+
+Options:
+  --port <number>   Port to listen on (default: an ephemeral port)
+  --token <string>  Bearer token to require (default: a generated token)
+  --no-token        Disable bearer-token authentication
+  --name <string>   Peer name shown to Claude Code sessions
+  --home <path>     Home directory containing .claude (default: the current user's)
+  -h, --help        Print this help and exit
+`;
+const MAX_PORT = 65535;
+const VALUE_FLAGS = /* @__PURE__ */ new Set([
+	"--port",
+	"--token",
+	"--name",
+	"--home"
+]);
+/**
+* Parses command-line arguments (without the node and script entries) without any side effects.
+* `-h` and `--help` win over everything else; an unknown argument, a value flag with no value, or a
+* `--port` that is not an integer from 0 to 65535 yields an error command.
+*/
 function parseArgs(argv) {
+	if (argv.includes("--help") || argv.includes("-h")) return { kind: "help" };
 	const args = { noToken: false };
 	for (let i = 0; i < argv.length; i += 1) {
 		const arg = argv[i];
-		const next = argv[i + 1];
-		if (arg === "--port" && next !== void 0) {
-			args.port = Number.parseInt(next, 10);
-			i += 1;
-		} else if (arg === "--token" && next !== void 0) {
-			args.token = next;
-			i += 1;
-		} else if (arg === "--name" && next !== void 0) {
-			args.name = next;
-			i += 1;
-		} else if (arg === "--home" && next !== void 0) {
-			args.home = next;
-			i += 1;
-		} else if (arg === "--no-token") args.noToken = true;
+		if (arg === void 0) continue;
+		if (arg === "--no-token") {
+			args.noToken = true;
+			continue;
+		}
+		if (!VALUE_FLAGS.has(arg)) return {
+			kind: "error",
+			message: `unknown argument: ${arg}`
+		};
+		const value = argv[i + 1];
+		if (value === void 0) return {
+			kind: "error",
+			message: `${arg} requires a value`
+		};
+		i += 1;
+		if (arg === "--port") {
+			const port = Number(value);
+			if (!/^\d+$/.test(value) || port > MAX_PORT) return {
+				kind: "error",
+				message: `invalid --port: ${value}`
+			};
+			args.port = port;
+		} else if (arg === "--token") args.token = value;
+		else if (arg === "--name") args.name = value;
+		else args.home = value;
 	}
-	return args;
+	return {
+		kind: "run",
+		args
+	};
 }
-async function main() {
-	const args = parseArgs(node_process.default.argv.slice(2));
+/**
+* Runs the CLI. Arguments are parsed before any peer is created or socket bound, so `--help` and
+* argument errors have no side effects beyond output; an argument error sets a non-zero exit code.
+*/
+async function main(argv = node_process.default.argv.slice(2)) {
+	const command = parseArgs(argv);
+	if (command.kind === "help") {
+		node_process.default.stdout.write(USAGE);
+		return;
+	}
+	if (command.kind === "error") {
+		node_process.default.stderr.write(`[cc-peer] ${command.message}\nRun 'cc-peer --help' for usage.\n`);
+		node_process.default.exitCode = 2;
+		return;
+	}
+	const { args } = command;
 	const peer = await require_cc_peer.CcPeer.create({
 		...args.name !== void 0 ? { name: args.name } : {},
 		...args.home !== void 0 ? { homeDir: args.home } : {},

package/dist/bin/cc-peer.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as RegistryEntrySchema, n as CcPeer, r as PrioritySchema } from "../cc-peer-zz8MzHY8.mjs";
+import { i as RegistryEntrySchema, n as CcPeer, r as PrioritySchema } from "../cc-peer-8l2Nyivq.mjs";
 import { l as defineSchema } from "../errors-KYBco8pU.mjs";
 import { randomBytes } from "node:crypto";
 import { z } from "zod";
@@ -338,29 +338,82 @@ function openApiDocument() {
 }
 //#endregion
 //#region src/bin/main.ts
+const USAGE = `Usage: cc-peer [options]
+
+Starts the cc-peer REST facade on loopback and registers a peer for this process.
+
+Options:
+  --port <number>   Port to listen on (default: an ephemeral port)
+  --token <string>  Bearer token to require (default: a generated token)
+  --no-token        Disable bearer-token authentication
+  --name <string>   Peer name shown to Claude Code sessions
+  --home <path>     Home directory containing .claude (default: the current user's)
+  -h, --help        Print this help and exit
+`;
+const MAX_PORT = 65535;
+const VALUE_FLAGS = /* @__PURE__ */ new Set([
+	"--port",
+	"--token",
+	"--name",
+	"--home"
+]);
+/**
+* Parses command-line arguments (without the node and script entries) without any side effects.
+* `-h` and `--help` win over everything else; an unknown argument, a value flag with no value, or a
+* `--port` that is not an integer from 0 to 65535 yields an error command.
+*/
 function parseArgs(argv) {
+	if (argv.includes("--help") || argv.includes("-h")) return { kind: "help" };
 	const args = { noToken: false };
 	for (let i = 0; i < argv.length; i += 1) {
 		const arg = argv[i];
-		const next = argv[i + 1];
-		if (arg === "--port" && next !== void 0) {
-			args.port = Number.parseInt(next, 10);
-			i += 1;
-		} else if (arg === "--token" && next !== void 0) {
-			args.token = next;
-			i += 1;
-		} else if (arg === "--name" && next !== void 0) {
-			args.name = next;
-			i += 1;
-		} else if (arg === "--home" && next !== void 0) {
-			args.home = next;
-			i += 1;
-		} else if (arg === "--no-token") args.noToken = true;
+		if (arg === void 0) continue;
+		if (arg === "--no-token") {
+			args.noToken = true;
+			continue;
+		}
+		if (!VALUE_FLAGS.has(arg)) return {
+			kind: "error",
+			message: `unknown argument: ${arg}`
+		};
+		const value = argv[i + 1];
+		if (value === void 0) return {
+			kind: "error",
+			message: `${arg} requires a value`
+		};
+		i += 1;
+		if (arg === "--port") {
+			const port = Number(value);
+			if (!/^\d+$/.test(value) || port > MAX_PORT) return {
+				kind: "error",
+				message: `invalid --port: ${value}`
+			};
+			args.port = port;
+		} else if (arg === "--token") args.token = value;
+		else if (arg === "--name") args.name = value;
+		else args.home = value;
 	}
-	return args;
+	return {
+		kind: "run",
+		args
+	};
 }
-async function main() {
-	const args = parseArgs(process.argv.slice(2));
+/**
+* Runs the CLI. Arguments are parsed before any peer is created or socket bound, so `--help` and
+* argument errors have no side effects beyond output; an argument error sets a non-zero exit code.
+*/
+async function main(argv = process.argv.slice(2)) {
+	const command = parseArgs(argv);
+	if (command.kind === "help") {
+		process.stdout.write(USAGE);
+		return;
+	}
+	if (command.kind === "error") {
+		process.stderr.write(`[cc-peer] ${command.message}\nRun 'cc-peer --help' for usage.\n`);
+		process.exitCode = 2;
+		return;
+	}
+	const { args } = command;
 	const peer = await CcPeer.create({
 		...args.name !== void 0 ? { name: args.name } : {},
 		...args.home !== void 0 ? { homeDir: args.home } : {},

package/dist/{cc-peer-zz8MzHY8.mjs → cc-peer-8l2Nyivq.mjs}

@@ -8,7 +8,7 @@ import { z } from "zod";
 import { homedir } from "node:os";
 import { spawn } from "node:child_process";
 //#region package.json
-var version = "1.6.2";
+var version = "1.6.4";
 //#endregion
 //#region src/adapters/node/uds-transport.ts
 /** macOS linger before close, matching the reference client's ~150ms. */

package/dist/{cc-peer-DNB8oHNm.cjs → cc-peer-CUt7BwyE.cjs}

@@ -8,7 +8,7 @@ let zod = require("zod");
 let node_os = require("node:os");
 let node_child_process = require("node:child_process");
 //#region package.json
-var version = "1.6.2";
+var version = "1.6.4";
 //#endregion
 //#region src/adapters/node/uds-transport.ts
 /** macOS linger before close, matching the reference client's ~150ms. */

package/dist/cc-peer.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cc_peer = require("./cc-peer-DNB8oHNm.cjs");
+const require_cc_peer = require("./cc-peer-CUt7BwyE.cjs");
 exports.CC_PEER_VERSION = require_cc_peer.CC_PEER_VERSION;
 exports.CcPeer = require_cc_peer.CcPeer;

package/dist/cc-peer.mjs

@@ -1,2 +1,2 @@
-import { n as CcPeer, t as CC_PEER_VERSION } from "./cc-peer-zz8MzHY8.mjs";
+import { n as CcPeer, t as CC_PEER_VERSION } from "./cc-peer-8l2Nyivq.mjs";
 export { CC_PEER_VERSION, CcPeer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-peer",
-  "version": "1.6.2",
+  "version": "1.6.4",
   "description": "Communicate with local Claude Code instances over their native cross-session peer messaging: send and receive messages, register as a named discoverable peer, receipts, idle subscriptions, and a REST facade via `npx cc-peer`.",
   "type": "module",
   "license": "MIT",