@rhythmjs/rhythm 0.0.11 → 0.0.12

package/README.md

@@ -1,13 +1,13 @@
 # @rhythmjs/rhythm
 
-The core composition kernel `@rhythmjs/router` and `@rhythmjs/cli` are built on. Framework-agnostic — no router, no HTTP layer, and never will be.
+The composition kernel at the core of Rhythm, the Bun-native backend framework, the piece `@rhythmjs/router` and `@rhythmjs/cli` are built on. It gives an application its structure (onion middleware, lifecycle-managed providers, encapsulated modules, all checked at compile time) and deliberately nothing else: no router, no HTTP layer, and never will be.
 
 ## Concepts
 
-- **Onion middleware** — `use()` wraps downstream steps, running code before _and_ after `next()`.
-- **Providers** — `provide()` registers a value or async factory that resolves once and joins the context at its position in the chain: only middleware (and mounted controllers) added after it see the value. A returned key prefixed with `#` (e.g. `"#close"`) stays out of context but is still passed in full to `dispose()`.
-- **Encapsulated modules** — `register()` mounts a child `Rhythm`; its context stays sealed unless you explicitly export fields from it.
-- **Readonly context** — the context passed to middleware is deeply readonly at the type level; state only changes via `next(extra)`, or through a value branded with the `RhythmMutable` symbol (how `RhythmRouter`/`RhythmCli`'s response objects stay mutable).
+- **Onion middleware**: `use()` wraps downstream steps, running code before _and_ after `next()`.
+- **Providers**: `provide()` registers a value or async factory that resolves once and joins the context at its position in the chain: only middleware (and mounted controllers) added after it see the value. A returned key prefixed with `#` (e.g. `"#close"`) stays out of context but is still passed in full to `dispose()`.
+- **Encapsulated modules**: `register()` mounts a child `Rhythm`; its context stays sealed unless you explicitly export fields from it.
+- **Readonly context**: the context passed to middleware is deeply readonly at the type level; state only changes via `next(extra)`, or through a value branded with the `RhythmMutable` symbol (how `RhythmRouter`/`RhythmCli`'s response objects stay mutable).
 
 ## Example
 
@@ -32,7 +32,7 @@ await app.run({ userId: "u1" });
 await app.teardown();
 ```
 
-`provide()` factories run once, in declaration order, each receiving everything resolved so far via `deps`. On each `run()`, the whole chain — middleware and provider injections alike — executes in registration order, onion-style: everything only applies to what was chained after it.
+`provide()` factories run once, in declaration order, each receiving everything resolved so far via `deps`. On each `run()`, the whole chain, middleware and provider injections alike, executes in registration order, onion-style: everything only applies to what was chained after it.
 
 ### Module registration
 
@@ -55,13 +55,13 @@ const app = new Rhythm<{ userId: string }>()
 
 ## API
 
-- `new Rhythm<TInput>(options?)` — creates a pipeline; `options.name`/`options.type` label errors from `register()`.
-- `.use(fn: (ctx, next) => Promise<void> | void)` — add an onion middleware step.
-- `.provide(factory: (deps) => TValue | Promise<TValue>, dispose?)` — register a provider; resolved once, injected at its chain position, disposed in reverse order on `teardown()`.
-- `.register(other: Rhythm, exportValue?)` — mount a child `Rhythm` module; sealed by default, opt in via `exportValue`. Controllers (`RhythmRouter`, `RhythmCli`) are not modules — they mount via `.use()` instead.
-- `.run(input)` — runs `setup()` if needed, dispatches `input` through the middleware chain.
-- `.callback()` — returns the cached, reusable `(input) => Promise<TContext>` handler `run()` uses internally.
-- `.middleware()` — returns this instance as a plain middleware, for flat mounting into a parent via `.use()` instead of `.register()`.
-- `.setup()` — resolves all providers, cascading into registered modules. Idempotent; retryable on failure.
-- `.teardown()` — disposes all providers in reverse order, cascading into registered modules.
-- `compose(middleware[])` — the standalone Koa-style onion dispatcher `Rhythm` is built on.
+- `new Rhythm<TInput>(options?)`: creates a pipeline; `options.name`/`options.type` label errors from `register()`.
+- `.use(fn: (ctx, next) => Promise<void> | void)`: add an onion middleware step.
+- `.provide(factory: (deps) => TValue | Promise<TValue>, dispose?)`: register a provider; resolved once, injected at its chain position, disposed in reverse order on `teardown()`.
+- `.register(other: Rhythm, exportValue?)`: mount a child `Rhythm` module; sealed by default, opt in via `exportValue`. Controllers (`RhythmRouter`, `RhythmCli`) are not modules; they mount via `.use()` instead.
+- `.run(input)`: runs `setup()` if needed, dispatches `input` through the middleware chain.
+- `.callback()`: returns the cached, reusable `(input) => Promise<TContext>` handler `run()` uses internally.
+- `.middleware()`: returns this instance as a plain middleware, for flat mounting into a parent via `.use()` instead of `.register()`.
+- `.setup()`: resolves all providers, cascading into registered modules. Idempotent; retryable on failure.
+- `.teardown()`: disposes all providers in reverse order, cascading into registered modules.
+- `compose(middleware[])`: the standalone Koa-style onion dispatcher `Rhythm` is built on.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhythmjs/rhythm",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "A minimal, type-safe onion-middleware and provider composition kernel.",
   "homepage": "https://rhythm.js.org/rhythm",
   "license": "ISC",