@rhythmjs/cli 0.0.15 → 0.0.16

package/README.md

@@ -2,7 +2,7 @@
 
 The command-line layer of Rhythm, the Bun-native backend framework: CLI command routing on top of the `@rhythmjs/rhythm` kernel. `RhythmCli` matches commands against argv positional tokens with a simple linear scan (appropriate for the handful-to-dozens of commands a real CLI has), supports prefixes and nested command groups, and mounts flat into a parent `Rhythm` app via `.use(cli.middleware())`, so an unmatched command correctly falls through to whatever's registered after it.
 
-`RhythmCli` is not an app and does not extend `Rhythm`; it is a controller that compiles commands and middleware down to a single middleware (`.middleware()`). It shares the core middleware contract (`compose`, `Middleware`, `derive`; `next()` takes no arguments, extend the context with `derive()`), but has no a startup `context` or `register()`, and it can't be served on its own: a `Rhythm` app is always the host that owns the lifecycle.
+`RhythmCli` is not an app and does not extend `Rhythm`; it is a controller that compiles commands and middleware down to a single middleware (`.middleware()`). It shares the core middleware contract (`compose`, `Middleware`, `derive`; `next()` takes no arguments, extend the context with `derive()`), but has no startup `context` or `register()`, and it can't be served on its own: a `Rhythm` app is always the host that owns the lifecycle.
 
 ## Example
 
@@ -31,7 +31,8 @@ A fuller runnable version, including nested command groups and interactive promp
 - **Interactive prompts**: `createPrompt()` gives `text()`/`confirm()`/`select()`/`multiSelect()` (the latter two support an `allowCustom` option that adds a "type your own" choice). Wire it in via `app.context.prompt = ...` on the host `Rhythm` app; see the example.
 - **Prefixes compose across nesting**: a child cli mounted into a prefixed parent via `.use(child)` gets the parent's prefix segments joined onto every one of its commands, at any nesting depth. Mounting copies the child's commands and middleware at that moment; commands added to the child afterwards don't appear in the parent, and the child keeps working standalone.
 - **Registration order is execution order**: a `.use()` middleware wraps only the commands registered after it, and runs only when one of them matches the argv (so a guard never answers `help` or another cli's commands); a mounted cli (`.use(child.middleware())`) always runs; commands registered before it are untouched, and a matched command that doesn't call `next()` returns without reaching anything registered later. An unmatched command falls through, entry by entry, to the outer `next()`.
-- **A cli is a controller, not a module**: it has no a startup `context` or `register()`, and it cannot be `register()`ed into a `Rhythm` app either; `register()` composes `Rhythm` modules only. A cli mounts into an app exactly one way: koa-style, via `.use(cli.middleware())`.
+- **Conditional middleware**: `.use(fn, condition)` also needs `condition(ctx)` to return true (sync or async); the second callback only narrows, so a middleware registered after every command still never runs.
+- **A cli is a controller, not a module**: it has no startup `context` or `register()`, and it cannot be `register()`ed into a `Rhythm` app either; `register()` composes `Rhythm` modules only. A cli mounts into an app exactly one way: koa-style, via `.use(cli.middleware())`.
 
 ## API
 

package/dist/rhythm-cli.d.ts

@@ -1,4 +1,4 @@
-import type { DeriveMiddleware, Middleware } from "@rhythmjs/rhythm/types";
+import type { Condition, DeriveMiddleware, Middleware } from "@rhythmjs/rhythm/types";
 import type { RhythmCliContext } from "./context";
 export interface RhythmCliCommandContext {
     readonly args: Readonly<Record<string, string>>;
@@ -19,7 +19,7 @@ export declare class RhythmCli<TContext extends RhythmCliContext = RhythmCliCont
     constructor(options?: RhythmCliOptions);
     get entries(): readonly CliEntry[];
     use<TExtra extends object>(fn: DeriveMiddleware<TContext, TExtra>): RhythmCli<TContext & TExtra, TInput>;
-    use(fn: Middleware<TContext>): this;
+    use(fn: Middleware<TContext>, condition?: Condition<TContext>): this;
     command<TExtra extends object>(path: string, middleware: DeriveMiddleware<TContext & RhythmCliCommandContext, TExtra>, ...handlers: Middleware<TContext & RhythmCliCommandContext & TExtra>[]): this;
     command(path: string, ...handlers: Middleware<TContext & RhythmCliCommandContext>[]): this;
     middleware(): Middleware<TInput>;

package/dist/rhythm-cli.js

@@ -4,7 +4,7 @@ import {
 } from "./rhythm-cli-qdf1cds9.js";
 
 // src/rhythm-cli.ts
-import { compose } from "@rhythmjs/rhythm/compose";
+import { compose, gate } from "@rhythmjs/rhythm/compose";
 import { sourceOf, withSource } from "@rhythmjs/rhythm/source";
 function toSegments(command) {
   return command.trim().split(/\s+/).filter(Boolean);
@@ -71,10 +71,14 @@ class RhythmCli {
   get #prefixSegments() {
     return this.#options.prefix ? toSegments(this.#options.prefix) : [];
   }
-  use(fn) {
+  use(fn, condition) {
     if (typeof fn !== "function")
       throw new TypeError("middleware must be a function!");
-    this.#entries.push({ kind: "middleware", fn });
+    if (condition !== undefined && typeof condition !== "function")
+      throw new TypeError("condition must be a function!");
+    const source = sourceOf(fn);
+    const wrapped = condition ? gate(fn, condition) : fn;
+    this.#entries.push({ kind: "middleware", fn: condition && source ? withSource(wrapped, source) : wrapped });
     return this;
   }
   command(path, ...handlers) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhythmjs/cli",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "Command-line argument parsing, prompts, and command routing for the Rhythm middleware kernel, running on Bun.",
   "homepage": "https://rhythm.js.org/cli",
   "license": "ISC",
@@ -49,7 +49,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@rhythmjs/rhythm": "0.0.15"
+    "@rhythmjs/rhythm": "0.0.16"
   },
   "devDependencies": {
     "@types/bun": "^1.4.2",