@btravstack/amqp-worker 0.13.0 → 0.15.0

package/README.md

@@ -188,15 +188,15 @@ module lists (`imports`, `provides`, `exports`, `needs`). The `amqp()`
 primitive does not take `handlers` as an option — it **needs** the handlers
 provider on its own port, which is how the composition root supplies it:
 
-| Option                   | What it is                                                                                                                      |
-| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
-| `contract`               | the `amqp-contract` contract; the queues consumed are read off it                                                               |
-| `handlers`               | the handlers provider — what `AmqpHandlers(contract)(...)` returns for this contract                                            |
-| `url`                    | pins `AMQP_URL` (default `amqp://127.0.0.1:5672`) — a test's container                                                          |
-| `connectionOptions`      | `AmqpConnectionOptions`, the library's own connection tuning: heartbeat, reconnect interval, `findServers`, TLS                 |
-| `defaultConsumerOptions` | the library's `ConsumerOptions`, applied to every handler: `prefetch` (the throughput knob), `priority`, …                      |
-| `connectTimeoutMs`       | pins `AMQP_CONNECT_TIMEOUT_MS` — how long startup waits before an unreachable broker is a `RuntimeStartFailed` (default `5000`) |
-| `unit`                   | `{ message }` — the module the worker forks per delivery, seeded with the message on `AmqpMessage(contract)`                    |
+| Option                   | What it is                                                                                                                                          |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `contract`               | the `amqp-contract` contract; the queues consumed are read off it                                                                                   |
+| `handlers`               | the handlers provider — what `AmqpHandlers(contract)(...)` returns for this contract                                                                |
+| `url`                    | pins `AMQP_URL` (default `amqp://127.0.0.1:5672`) — a test's container                                                                              |
+| `connectionOptions`      | `AmqpConnectionOptions`, the library's own connection tuning: heartbeat, reconnect interval, `findServers`, TLS                                     |
+| `defaultConsumerOptions` | the library's `ConsumerOptions`, applied to every handler: `prefetch` (the throughput knob — unset is `10`, `"unbounded"` is no cap), `priority`, … |
+| `connectTimeoutMs`       | pins `AMQP_CONNECT_TIMEOUT_MS` — how long startup waits before an unreachable broker is a `RuntimeStartFailed` (default `5000`)                     |
+| `unit`                   | `{ message }` — the module the worker forks per delivery, seeded with the message on `AmqpMessage(contract)`                                        |
 
 The full table — required/optional, defaults, and the reasoning — lives on
 [the reference page](https://btravstack.github.io/btravstack/reference/amqp-worker),

package/dist/index.cjs

@@ -5,6 +5,60 @@ let _btravstack_config = require("@btravstack/config");
 let _btravstack_core = require("@btravstack/core");
 let unthrown = require("unthrown");
 let node_crypto = require("node:crypto");
+//#region src/broker-log.ts
+/**
+* The library's own diagnostics, as operations on `Observers`.
+*
+* **`@amqp-contract/worker` takes a `logger` and was given none**, so every
+* line it writes was discarded: "Consumer cancelled by server", "poison message
+* will be lost on nack", "Max retries exceeded, sending to DLQ", "Publish for
+* retry failed; leaving original un-ack'd", "Failed to parse/validate message;
+* sending to DLQ", and the channel's own `error`. Each of those is a fact an
+* operator has no other way to learn: the first three are permanent outages
+* this package's own `Serving` cannot see, and the last is where a poison
+* stream goes — nacked before the handler middleware runs, so the `outcome`
+* dimension a healthy-looking rate is read off never sees it.
+*
+* **Observers rather than the kernel's `Logger` port.** Forwarding `Logger`
+* would put it in `amqp()`'s `Needs`, which is exactly the compile error the
+* `instrumented` flag was deleted for: a root that wants a worker and no
+* OpenTelemetry SDK should not be handed a port list. This costs a root
+* nothing — the starter already injects `Observers` and contributes the no-op
+* member — and a root composing `observability()` gets the lines for free.
+*
+* **`debug` and `info` are dropped, and that is the shape of the seam rather
+* than a judgement about them.** An observer writes no line for a successful
+* operation — the repository's own rule, and what keeps a per-request metric
+* from also being a per-request line — so an `info` mapped to `outcome: "ok"`
+* would be silently discarded anyway. Every diagnostic the issue named is a
+* `warn` or an `error`, which is the half that survives.
+*
+* `traced: false`: these have no duration, and a zero-length span per broker
+* line is noise in a trace rather than information.
+*/
+const brokerLog = (observers) => {
+	const report = (level) => (message, context) => {
+		(0, _btravstack_core.observe)(observers, {
+			component: "amqp",
+			name: "broker",
+			attributes: { level },
+			details: { message },
+			traced: false
+		})({
+			outcome: "error",
+			attributes: {},
+			...context?.error === void 0 ? {} : { cause: context.error }
+		});
+	};
+	const ignore = () => {};
+	return {
+		debug: ignore,
+		info: ignore,
+		warn: report("warn"),
+		error: report("error")
+	};
+};
+//#endregion
 //#region src/unit.ts
 /**
 * Where `messageUnits` leaves the forked context for the piece wrappers to read.
@@ -268,6 +322,7 @@ const createWorker = (host, config, options, handlers, observers) => _amqp_contr
 	contract: options.contract,
 	handlers,
 	middleware: messageUnits(host, observers, options.unit?.message),
+	logger: brokerLog(observers),
 	urls: [config.url],
 	...options.connectionOptions === void 0 ? {} : { connectionOptions: options.connectionOptions },
 	...options.defaultConsumerOptions === void 0 ? {} : { defaultConsumerOptions: options.defaultConsumerOptions },

package/dist/index.d.cts

@@ -53,7 +53,7 @@ type AmqpMessageInstance = PortInstance<"AmqpMessage", unknown>;
  * at the type level, the move `AmqpHandlersPort` makes, so a module built for
  * one contract cannot read another's message.
  */
-declare const AmqpMessage: <C extends AnyAmqpContract>(contract: C) => AmqpMessagePortOf<C>;
+export declare const AmqpMessage: <C extends AnyAmqpContract>(contract: C) => AmqpMessagePortOf<C>;
 /**
  * The port one piece targets. Its id carries the contract key, which is what
  * makes two slices claiming one consumer di's duplicate-provider defect rather
@@ -84,7 +84,7 @@ type MintedHandler<C extends AnyAmqpContract, K extends HandlerKeyOf<C>, N, U ex
  * of the fork the delivery opened; the root's `unit.message` module must export
  * every one of them.
  */
-declare const AmqpHandler: <C extends AnyAmqpContract, const K extends HandlerKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
+export declare const AmqpHandler: <C extends AnyAmqpContract, const K extends HandlerKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
   readonly inject: D;
   /** The unit-scoped ports this handler reads off `context.unit`. */
   readonly unit?: U;
@@ -107,13 +107,13 @@ declare const AmqpConfig_base: import("@btravstack/di").PortClass<"AmqpConfig">;
  * unless pinned, and anything else in the graph may read it — a publisher
  * sharing the consumer's broker, say.
  */
-declare class AmqpConfig extends AmqpConfig_base<{
+export declare class AmqpConfig extends AmqpConfig_base<{
   readonly url: string;
   /** How long `create` waits for the connection before failing. */
   readonly connectTimeoutMs: number;
 }> {}
 /** The runtime's port: what `amqp()` provides, and what the module `start` boots must export. */
-declare class AmqpRuntime extends RuntimePort<Runtime<never, AmqpInfo>> {}
+export declare class AmqpRuntime extends RuntimePort<Runtime<never, AmqpInfo>> {}
 /**
  * A module `unit.message` may bind, as the upper bound `amqp()` constrains its
  * own `Unit` type parameter to. `Module`'s `_exports` channel is contravariant,
@@ -192,7 +192,7 @@ type AmqpTuning<Unit extends AnyUnitModule | undefined = undefined> = {
  *
  * With `url` pinned the module reads nothing from the environment.
  */
-declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf<Unit>>;
+export declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf<Unit>>;
 /** One piece of the handlers record — what `AmqpHandler(contract, key)(…)` returns, as the composing form consumes it. */
 type PieceOf<C extends AnyAmqpContract> = { readonly [K in HandlerKeyOf<C>]: {
   readonly port: HandlerPortOf<C, K>;
@@ -276,7 +276,7 @@ type Compose<C extends AnyAmqpContract> = <const T extends readonly PieceOf<C>[]
  * record IS the handlers record. Every declared key must be covered, and two
  * slices claiming one key are di's duplicate-provider defect at build.
  */
-declare const AmqpHandlers: <C extends AnyAmqpContract>(contract: C) => Whole<C> & Compose<C>;
+export declare const AmqpHandlers: <C extends AnyAmqpContract>(contract: C) => Whole<C> & Compose<C>;
 //#endregion
 //#region src/amqp-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
@@ -322,6 +322,6 @@ type AmqpModuleOptions<TContract extends AnyAmqpContract, HandlersError, Handler
  * await runMain(OrderAmqpWorker);
  * ```
  */
-declare const AmqpModule: <const Name extends string>(name: Name) => <TContract extends AnyAmqpContract, HandlersError, HandlersNeeds, Declared = never, Unit extends AnyUnitModule | undefined = undefined, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, TContract, Unit>, Provides<P, TContract, HandlersError, HandlersNeeds>>[] = [], const N extends readonly AnyPort[] = []>(options: AmqpModuleOptions<TContract, HandlersError, HandlersNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof AmqpRuntime, ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_1 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[1] | ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_2) ? T_2 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]> | Exclude<((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]>>;
+export declare const AmqpModule: <const Name extends string>(name: Name) => <TContract extends AnyAmqpContract, HandlersError, HandlersNeeds, Declared = never, Unit extends AnyUnitModule | undefined = undefined, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, TContract, Unit>, Provides<P, TContract, HandlersError, HandlersNeeds>>[] = [], const N extends readonly AnyPort[] = []>(options: AmqpModuleOptions<TContract, HandlersError, HandlersNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof AmqpRuntime, ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_1 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[1] | ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_2) ? T_2 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]> | Exclude<((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]>>;
 //#endregion
-export { AmqpConfig, type AmqpConnectionOptions, AmqpHandler, AmqpHandlers, type AmqpInfo, AmqpMessage, type AmqpMessageOf, type AmqpMessagePortOf, AmqpModule, type AmqpModuleOptions, type AmqpOptions, AmqpRuntime, type HandlerPortOf, type HandlersInstanceOf, type HandlersPortOf, amqp };
+export type { AmqpConnectionOptions, AmqpInfo, AmqpMessageOf, AmqpMessagePortOf, AmqpModuleOptions, AmqpOptions, HandlerPortOf, HandlersInstanceOf, HandlersPortOf };

package/dist/index.d.mts

@@ -53,7 +53,7 @@ type AmqpMessageInstance = PortInstance<"AmqpMessage", unknown>;
  * at the type level, the move `AmqpHandlersPort` makes, so a module built for
  * one contract cannot read another's message.
  */
-declare const AmqpMessage: <C extends AnyAmqpContract>(contract: C) => AmqpMessagePortOf<C>;
+export declare const AmqpMessage: <C extends AnyAmqpContract>(contract: C) => AmqpMessagePortOf<C>;
 /**
  * The port one piece targets. Its id carries the contract key, which is what
  * makes two slices claiming one consumer di's duplicate-provider defect rather
@@ -84,7 +84,7 @@ type MintedHandler<C extends AnyAmqpContract, K extends HandlerKeyOf<C>, N, U ex
  * of the fork the delivery opened; the root's `unit.message` module must export
  * every one of them.
  */
-declare const AmqpHandler: <C extends AnyAmqpContract, const K extends HandlerKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
+export declare const AmqpHandler: <C extends AnyAmqpContract, const K extends HandlerKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
   readonly inject: D;
   /** The unit-scoped ports this handler reads off `context.unit`. */
   readonly unit?: U;
@@ -107,13 +107,13 @@ declare const AmqpConfig_base: import("@btravstack/di").PortClass<"AmqpConfig">;
  * unless pinned, and anything else in the graph may read it — a publisher
  * sharing the consumer's broker, say.
  */
-declare class AmqpConfig extends AmqpConfig_base<{
+export declare class AmqpConfig extends AmqpConfig_base<{
   readonly url: string;
   /** How long `create` waits for the connection before failing. */
   readonly connectTimeoutMs: number;
 }> {}
 /** The runtime's port: what `amqp()` provides, and what the module `start` boots must export. */
-declare class AmqpRuntime extends RuntimePort<Runtime<never, AmqpInfo>> {}
+export declare class AmqpRuntime extends RuntimePort<Runtime<never, AmqpInfo>> {}
 /**
  * A module `unit.message` may bind, as the upper bound `amqp()` constrains its
  * own `Unit` type parameter to. `Module`'s `_exports` channel is contravariant,
@@ -192,7 +192,7 @@ type AmqpTuning<Unit extends AnyUnitModule | undefined = undefined> = {
  *
  * With `url` pinned the module reads nothing from the environment.
  */
-declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf<Unit>>;
+export declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf<Unit>>;
 /** One piece of the handlers record — what `AmqpHandler(contract, key)(…)` returns, as the composing form consumes it. */
 type PieceOf<C extends AnyAmqpContract> = { readonly [K in HandlerKeyOf<C>]: {
   readonly port: HandlerPortOf<C, K>;
@@ -276,7 +276,7 @@ type Compose<C extends AnyAmqpContract> = <const T extends readonly PieceOf<C>[]
  * record IS the handlers record. Every declared key must be covered, and two
  * slices claiming one key are di's duplicate-provider defect at build.
  */
-declare const AmqpHandlers: <C extends AnyAmqpContract>(contract: C) => Whole<C> & Compose<C>;
+export declare const AmqpHandlers: <C extends AnyAmqpContract>(contract: C) => Whole<C> & Compose<C>;
 //#endregion
 //#region src/amqp-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
@@ -322,6 +322,6 @@ type AmqpModuleOptions<TContract extends AnyAmqpContract, HandlersError, Handler
  * await runMain(OrderAmqpWorker);
  * ```
  */
-declare const AmqpModule: <const Name extends string>(name: Name) => <TContract extends AnyAmqpContract, HandlersError, HandlersNeeds, Declared = never, Unit extends AnyUnitModule | undefined = undefined, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, TContract, Unit>, Provides<P, TContract, HandlersError, HandlersNeeds>>[] = [], const N extends readonly AnyPort[] = []>(options: AmqpModuleOptions<TContract, HandlersError, HandlersNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof AmqpRuntime, ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_1 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[1] | ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_2) ? T_2 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]> | Exclude<((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]>>;
+export declare const AmqpModule: <const Name extends string>(name: Name) => <TContract extends AnyAmqpContract, HandlersError, HandlersNeeds, Declared = never, Unit extends AnyUnitModule | undefined = undefined, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, TContract, Unit>, Provides<P, TContract, HandlersError, HandlersNeeds>>[] = [], const N extends readonly AnyPort[] = []>(options: AmqpModuleOptions<TContract, HandlersError, HandlersNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof AmqpRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof AmqpRuntime, ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_1 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[1] | ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_2) ? T_2 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]> | Exclude<((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((readonly [...I, AmqpStarter<TContract, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, AmqpStarter<TContract, Unit>])[number] ? T_4 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<HandlersInstanceOf<TContract>, HandlersError, HandlersNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]>>;
 //#endregion
-export { AmqpConfig, type AmqpConnectionOptions, AmqpHandler, AmqpHandlers, type AmqpInfo, AmqpMessage, type AmqpMessageOf, type AmqpMessagePortOf, AmqpModule, type AmqpModuleOptions, type AmqpOptions, AmqpRuntime, type HandlerPortOf, type HandlersInstanceOf, type HandlersPortOf, amqp };
+export type { AmqpConnectionOptions, AmqpInfo, AmqpMessageOf, AmqpMessagePortOf, AmqpModuleOptions, AmqpOptions, HandlerPortOf, HandlersInstanceOf, HandlersPortOf };

package/dist/index.mjs

@@ -4,6 +4,60 @@ import { Config, Env } from "@btravstack/config";
 import { Observers, RuntimePort, RuntimeStartFailed, noObserver, observe, releasedBy, traceIdOfTraceparent } from "@btravstack/core";
 import { P } from "unthrown";
 import { randomUUID } from "node:crypto";
+//#region src/broker-log.ts
+/**
+* The library's own diagnostics, as operations on `Observers`.
+*
+* **`@amqp-contract/worker` takes a `logger` and was given none**, so every
+* line it writes was discarded: "Consumer cancelled by server", "poison message
+* will be lost on nack", "Max retries exceeded, sending to DLQ", "Publish for
+* retry failed; leaving original un-ack'd", "Failed to parse/validate message;
+* sending to DLQ", and the channel's own `error`. Each of those is a fact an
+* operator has no other way to learn: the first three are permanent outages
+* this package's own `Serving` cannot see, and the last is where a poison
+* stream goes — nacked before the handler middleware runs, so the `outcome`
+* dimension a healthy-looking rate is read off never sees it.
+*
+* **Observers rather than the kernel's `Logger` port.** Forwarding `Logger`
+* would put it in `amqp()`'s `Needs`, which is exactly the compile error the
+* `instrumented` flag was deleted for: a root that wants a worker and no
+* OpenTelemetry SDK should not be handed a port list. This costs a root
+* nothing — the starter already injects `Observers` and contributes the no-op
+* member — and a root composing `observability()` gets the lines for free.
+*
+* **`debug` and `info` are dropped, and that is the shape of the seam rather
+* than a judgement about them.** An observer writes no line for a successful
+* operation — the repository's own rule, and what keeps a per-request metric
+* from also being a per-request line — so an `info` mapped to `outcome: "ok"`
+* would be silently discarded anyway. Every diagnostic the issue named is a
+* `warn` or an `error`, which is the half that survives.
+*
+* `traced: false`: these have no duration, and a zero-length span per broker
+* line is noise in a trace rather than information.
+*/
+const brokerLog = (observers) => {
+	const report = (level) => (message, context) => {
+		observe(observers, {
+			component: "amqp",
+			name: "broker",
+			attributes: { level },
+			details: { message },
+			traced: false
+		})({
+			outcome: "error",
+			attributes: {},
+			...context?.error === void 0 ? {} : { cause: context.error }
+		});
+	};
+	const ignore = () => {};
+	return {
+		debug: ignore,
+		info: ignore,
+		warn: report("warn"),
+		error: report("error")
+	};
+};
+//#endregion
 //#region src/unit.ts
 /**
 * Where `messageUnits` leaves the forked context for the piece wrappers to read.
@@ -267,6 +321,7 @@ const createWorker = (host, config, options, handlers, observers) => TypedAmqpWo
 	contract: options.contract,
 	handlers,
 	middleware: messageUnits(host, observers, options.unit?.message),
+	logger: brokerLog(observers),
 	urls: [config.url],
 	...options.connectionOptions === void 0 ? {} : { connectionOptions: options.connectionOptions },
 	...options.defaultConsumerOptions === void 0 ? {} : { defaultConsumerOptions: options.defaultConsumerOptions },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/amqp-worker",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "The AMQP starter for @btravstack/core: the handlers as a port, one unit per delivery, and a drain the kernel's deadline releases",
   "keywords": [
     "amqp",
@@ -47,29 +47,29 @@
     "@amqp-contract/contract": "3.0.0-beta.7",
     "@amqp-contract/testing": "3.0.0-beta.7",
     "@amqp-contract/worker": "3.0.0-beta.7",
+    "@btravstack/config": "0.15.0",
+    "@btravstack/core": "0.15.0",
+    "@btravstack/di": "0.15.0",
+    "@btravstack/internal-test-infra": "0.0.0",
+    "@btravstack/testing": "0.15.0",
     "@btravstack/tsconfig": "0.4.0",
     "@opentelemetry/api": "1.9.1",
-    "@types/node": "26.4.0",
-    "@unthrown/vitest": "5.7.0",
+    "@types/node": "26.4.1",
+    "@unthrown/vitest": "5.8.0",
     "@vitest/coverage-v8": "4.1.11",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "unthrown": "5.7.0",
+    "unthrown": "5.8.0",
     "vitest": "4.1.11",
-    "zod": "4.5.3",
-    "@btravstack/config": "0.13.0",
-    "@btravstack/core": "0.13.0",
-    "@btravstack/di": "0.13.0",
-    "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/testing": "0.13.0"
+    "zod": "4.5.4"
   },
   "peerDependencies": {
     "@amqp-contract/worker": "^3.0.0-beta.7",
+    "@btravstack/config": "^0.15.0",
+    "@btravstack/core": "^0.15.0",
+    "@btravstack/di": "^0.15.0",
     "@opentelemetry/api": "^1",
-    "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.13.0",
-    "@btravstack/core": "^0.13.0",
-    "@btravstack/di": "^0.13.0"
+    "unthrown": "^5.0.0"
   },
   "engines": {
     "node": ">=22"
@@ -78,7 +78,6 @@
     "build": "tsdown src/index.ts --format cjs,esm --dts --clean",
     "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest run --coverage",
-    "test:types": "tsc --noEmit -p tsconfig.test-d.json",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test-d.json"
   }
 }