procband 0.2.0 → 0.2.1

package/README.md

@@ -20,7 +20,6 @@ import process from 'node:process'
 import { supervise } from 'procband'
 
 const proc = supervise({
-  name: 'api',
   command: process.execPath,
   args: ['-e', 'console.log("ready")'],
 })

package/dist/index.d.mts

@@ -27,8 +27,10 @@ type MatchStream = 'stdout' | 'stderr' | 'both';
 interface ProcessConfig {
   /**
    * Stable identifier used in prefixed output and emitted match events.
+   *
+   * Defaults to the trailing `/[-\w]+$/` match from `command`.
    */
-  name: string;
+  name?: string;
   /**
    * Executable or shell-free command name passed to `spawn()`.
    */
@@ -271,8 +273,8 @@ interface ProcbandProcess extends ChildProcess, PromiseLike<ProcessResult> {
  *
  * @param config The subprocess configuration to supervise.
  * @returns A `ChildProcess`-compatible wrapper with procband-specific helpers.
- * @throws When `config` is invalid, such as a missing `name`, missing
- * `command`, or an invalid reserved color.
+ * @throws When `config` is invalid, such as a missing `command`, a `command`
+ * that does not produce a fallback `name`, or an invalid reserved color.
  * @example
  * ```ts
  * import process from 'node:process'

package/dist/index.mjs

@@ -352,8 +352,8 @@ function isMissingProcessError(error) {
 *
 * @param config The subprocess configuration to supervise.
 * @returns A `ChildProcess`-compatible wrapper with procband-specific helpers.
-* @throws When `config` is invalid, such as a missing `name`, missing
-* `command`, or an invalid reserved color.
+* @throws When `config` is invalid, such as a missing `command`, a `command`
+* that does not produce a fallback `name`, or an invalid reserved color.
 * @example
 * ```ts
 * import process from 'node:process'
@@ -395,10 +395,10 @@ var ProcbandProcessImpl = class extends EventEmitter {
 	terminalResultObserved = false;
 	constructor(config) {
 		super();
-		validateProcessConfig(config);
+		const name = validateProcessConfig(config);
 		this.config = config;
-		this.name = config.name;
-		this.label = config.label ?? config.name;
+		this.name = name;
+		this.label = config.label ?? name;
 		this.color = resolveProcessColor(config.color);
 		this.matches = new MatchRegistry(this.name);
 		this.restart = new RestartController(config.restart);
@@ -686,9 +686,14 @@ var ProcbandProcessImpl = class extends EventEmitter {
 const liveProcesses = /* @__PURE__ */ new Set();
 let propagatedFailure = false;
 function validateProcessConfig(config) {
-	if (!config.name) throw new Error("ProcessConfig.name is required");
 	if (!config.command) throw new Error("ProcessConfig.command is required");
 	validateProcessColor(config.color);
+	const name = config.name || inferProcessName(config.command);
+	if (!name) throw new Error("ProcessConfig.name is required when command does not match /[-\\w]+$/");
+	return name;
+}
+function inferProcessName(command) {
+	return command.match(/[-\w]+$/)?.[0];
 }
 function getResultExitCode(code, signal) {
 	if (code != null) return code;

package/docs/context.md

@@ -109,11 +109,14 @@ Supervision adds four behaviors on top of raw `spawn()`:
   supervised process exists.
 - `stderr` prefixes always use the reserved red, even when a custom process
   color is configured.
+- `ProcessConfig.name` is optional. When omitted, it falls back to the
+  trailing `/[-\w]+$/` match from `command`.
 
 # Error Model
 
-- `supervise()` throws synchronously for invalid config such as missing `name`,
-  missing `command`, or an invalid reserved color.
+- `supervise()` throws synchronously for invalid config such as missing
+  `command`, a `command` that does not produce a fallback `name`, or an
+  invalid reserved color.
 - `waitFor()` rejects on timeout or terminal exit before a future match.
 - A thrown `match()` callback only unsubscribes that callback.
 - Errors from `ProcessConfig.stderr` stop teeing to that sink but do not stop

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "procband",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Supervise subprocesses from TypeScript: prefix logs, wait for output patterns, and manage lifecycle/restarts.",
   "license": "MIT",
   "author": "Alec Larson",