@btravstack/amqp-worker 0.25.0 → 0.27.0

package/dist/index.cjs

@@ -242,7 +242,7 @@ const amqp = (options) => {
 * AmqpHandlers(orderContract)([orderNotifications, orderAudit])
 * ```
 *
-* The first is `{ inject, unit?, sync }`, whose `sync` hands back the whole
+* The first is `{ inject?, unit?, sync }`, whose `sync` hands back the whole
 * handlers record — one `unit:` record for every entry in it. The second takes
 * the pieces `AmqpHandler(contract, key)` builds: they are the provider's deps,
 * keyed by the contract key each piece's port id carries, so the services

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ConfigInvalid, Env } from "@btravstack/config";
+import { ConfigInvalid, EnvReading } from "@btravstack/config";
 import { AnyUnitModule, Refuse, Runtime, RuntimePort, UnitGate, UnitNeedsOf, UnitRecordOf } from "@btravstack/core";
 import { AnyModule, AnyPort, AnyProvider, Exportable, Module, NeedsGate, PortClassOf, PortInstance, Provider, ServiceOf } from "@btravstack/di";
 import { ConsumerOptions, TypedAmqpWorker, WorkerInferHandlers } from "@amqp-contract/worker";
@@ -68,8 +68,8 @@ 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.
  */
-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;
+export declare const AmqpHandler: <C extends AnyAmqpContract, const K extends HandlerKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>> = Record<never, never>, 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;
   readonly sync: (services: { readonly [N in keyof D]: ServiceOf<InstanceType<D[N]>>; }) => WorkerInferHandlers<C, {
@@ -77,7 +77,9 @@ export declare const AmqpHandler: <C extends AnyAmqpContract, const K extends Ha
   }>[K & keyof WorkerInferHandlers<C, {
     readonly unit: UnitRecordOf<U>;
   }>];
-}) => MintedHandler<C, K, InstanceType<D[keyof D]>, U>;
+} & ([keyof D] extends [never] ? unknown : {
+  readonly inject: D;
+})) => MintedHandler<C, K, InstanceType<D[keyof D]>, U>;
 //#endregion
 //#region src/amqp-runtime.d.ts
 /** What the worker publishes once it is consuming, read back through `RunningApp.runtimeInfo()`. */
@@ -162,7 +164,7 @@ type AmqpTuning<Unit extends AnyUnitModule | undefined = undefined> = {
  *
  * With `url` pinned the module reads nothing from the environment.
  */
-export declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf$1<Unit>>;
+export declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, EnvReading<never, "AMQP_URL" | "AMQP_CONNECT_TIMEOUT_MS"> | HandlersInstanceOf<TContract> | UnitNeedsOf$1<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>;
@@ -185,21 +187,23 @@ type Uncovered<C extends AnyAmqpContract, T extends readonly PieceOf<C>[]> = Exc
  * The record arm: the whole handlers record from one `sync`, with one `unit:`
  * record shared by every entry in it.
  *
- * It is `{ inject, unit?, sync }` — di's other arms are gone — for PARITY, not
+ * It is `{ inject?, unit?, sync }` — di's other arms are gone — for PARITY, not
  * for a type-system reason: `value` could have carried the record just as well,
  * since `U` infers from `unit` and never from the arm. `@btravstack/http-server`'s
- * `api.OrpcRouter(contract)` is `{ inject, unit?, sync }` and so are all three
+ * `api.OrpcRouter(contract)` is `{ inject?, unit?, sync }` and so are all three
  * packages' piece factories, so one arm across the family is one surface to
  * learn and one to keep.
  */
-type Whole<C extends AnyAmqpContract> = <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
-  readonly inject: D;
+type Whole<C extends AnyAmqpContract> = <const D extends Readonly<Record<string, AnyPort>> = Record<never, never>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
+  readonly inject?: D;
   /** The unit-scoped ports every handler in the record reads off `context.unit`. */
   readonly unit?: U;
   readonly sync: (services: { readonly [N in keyof D]: ServiceOf<InstanceType<D[N]>>; }) => WorkerInferHandlers<C, {
     readonly unit: UnitRecordOf<U>;
   }>;
-}) => Provider<HandlersInstanceOf<C>, never, InstanceType<D[keyof D]>> & {
+} & ([keyof D] extends [never] ? unknown : {
+  readonly inject: D;
+})) => Provider<HandlersInstanceOf<C>, never, InstanceType<D[keyof D]>> & {
   readonly port: HandlersPortOf<C>;
   /** Phantom: the declared ports, which `AmqpModule` gates `unit.message` against. */
   readonly _declaredUnit?: InstanceType<U[keyof U]>;
@@ -226,7 +230,7 @@ type Compose<C extends AnyAmqpContract> = <const T extends readonly PieceOf<C>[]
  * AmqpHandlers(orderContract)([orderNotifications, orderAudit])
  * ```
  *
- * The first is `{ inject, unit?, sync }`, whose `sync` hands back the whole
+ * The first is `{ inject?, unit?, sync }`, whose `sync` hands back the whole
  * handlers record — one `unit:` record for every entry in it. The second takes
  * the pieces `AmqpHandler(contract, key)` builds: they are the provider's deps,
  * keyed by the contract key each piece's port id carries, so the services
@@ -237,7 +241,7 @@ export declare const AmqpHandlers: <C extends AnyAmqpContract>(contract: C) => W
 //#endregion
 //#region src/amqp-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
-type AmqpStarter<TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined> = Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf$1<Unit>>;
+type AmqpStarter<TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined> = Module<AmqpRuntime | AmqpConfig, ConfigInvalid, EnvReading<never, "AMQP_URL" | "AMQP_CONNECT_TIMEOUT_MS"> | HandlersInstanceOf<TContract> | UnitNeedsOf$1<Unit>>;
 /** The application's imports plus the starter — the tuple `Module(name)` is handed. */
 type Imports<I extends readonly AnyModule[], TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined> = readonly [...I, AmqpStarter<TContract, Unit>];
 /** The handlers provider plus the application's own — the tuple `Module(name)` is handed. */

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { AnyModule, AnyPort, AnyProvider, Exportable, Module, NeedsGate, PortClassOf, PortInstance, Provider, ServiceOf } from "@btravstack/di";
 import { ConsumerOptions, TypedAmqpWorker, WorkerInferHandlers } from "@amqp-contract/worker";
-import { ConfigInvalid, Env } from "@btravstack/config";
+import { ConfigInvalid, EnvReading } from "@btravstack/config";
 import { AnyUnitModule, Refuse, Runtime, RuntimePort, UnitGate, UnitNeedsOf, UnitRecordOf } from "@btravstack/core";
 //#region src/handler.d.ts
 /** The consumer and rpc names `C` declares — the keys of its handlers record. */
@@ -68,8 +68,8 @@ 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.
  */
-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;
+export declare const AmqpHandler: <C extends AnyAmqpContract, const K extends HandlerKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>> = Record<never, never>, 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;
   readonly sync: (services: { readonly [N in keyof D]: ServiceOf<InstanceType<D[N]>>; }) => WorkerInferHandlers<C, {
@@ -77,7 +77,9 @@ export declare const AmqpHandler: <C extends AnyAmqpContract, const K extends Ha
   }>[K & keyof WorkerInferHandlers<C, {
     readonly unit: UnitRecordOf<U>;
   }>];
-}) => MintedHandler<C, K, InstanceType<D[keyof D]>, U>;
+} & ([keyof D] extends [never] ? unknown : {
+  readonly inject: D;
+})) => MintedHandler<C, K, InstanceType<D[keyof D]>, U>;
 //#endregion
 //#region src/amqp-runtime.d.ts
 /** What the worker publishes once it is consuming, read back through `RunningApp.runtimeInfo()`. */
@@ -162,7 +164,7 @@ type AmqpTuning<Unit extends AnyUnitModule | undefined = undefined> = {
  *
  * With `url` pinned the module reads nothing from the environment.
  */
-export declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf$1<Unit>>;
+export declare const amqp: <TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined = undefined>(options: AmqpOptions<TContract, Unit>) => Module<AmqpRuntime | AmqpConfig, ConfigInvalid, EnvReading<never, "AMQP_URL" | "AMQP_CONNECT_TIMEOUT_MS"> | HandlersInstanceOf<TContract> | UnitNeedsOf$1<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>;
@@ -185,21 +187,23 @@ type Uncovered<C extends AnyAmqpContract, T extends readonly PieceOf<C>[]> = Exc
  * The record arm: the whole handlers record from one `sync`, with one `unit:`
  * record shared by every entry in it.
  *
- * It is `{ inject, unit?, sync }` — di's other arms are gone — for PARITY, not
+ * It is `{ inject?, unit?, sync }` — di's other arms are gone — for PARITY, not
  * for a type-system reason: `value` could have carried the record just as well,
  * since `U` infers from `unit` and never from the arm. `@btravstack/http-server`'s
- * `api.OrpcRouter(contract)` is `{ inject, unit?, sync }` and so are all three
+ * `api.OrpcRouter(contract)` is `{ inject?, unit?, sync }` and so are all three
  * packages' piece factories, so one arm across the family is one surface to
  * learn and one to keep.
  */
-type Whole<C extends AnyAmqpContract> = <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
-  readonly inject: D;
+type Whole<C extends AnyAmqpContract> = <const D extends Readonly<Record<string, AnyPort>> = Record<never, never>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
+  readonly inject?: D;
   /** The unit-scoped ports every handler in the record reads off `context.unit`. */
   readonly unit?: U;
   readonly sync: (services: { readonly [N in keyof D]: ServiceOf<InstanceType<D[N]>>; }) => WorkerInferHandlers<C, {
     readonly unit: UnitRecordOf<U>;
   }>;
-}) => Provider<HandlersInstanceOf<C>, never, InstanceType<D[keyof D]>> & {
+} & ([keyof D] extends [never] ? unknown : {
+  readonly inject: D;
+})) => Provider<HandlersInstanceOf<C>, never, InstanceType<D[keyof D]>> & {
   readonly port: HandlersPortOf<C>;
   /** Phantom: the declared ports, which `AmqpModule` gates `unit.message` against. */
   readonly _declaredUnit?: InstanceType<U[keyof U]>;
@@ -226,7 +230,7 @@ type Compose<C extends AnyAmqpContract> = <const T extends readonly PieceOf<C>[]
  * AmqpHandlers(orderContract)([orderNotifications, orderAudit])
  * ```
  *
- * The first is `{ inject, unit?, sync }`, whose `sync` hands back the whole
+ * The first is `{ inject?, unit?, sync }`, whose `sync` hands back the whole
  * handlers record — one `unit:` record for every entry in it. The second takes
  * the pieces `AmqpHandler(contract, key)` builds: they are the provider's deps,
  * keyed by the contract key each piece's port id carries, so the services
@@ -237,7 +241,7 @@ export declare const AmqpHandlers: <C extends AnyAmqpContract>(contract: C) => W
 //#endregion
 //#region src/amqp-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
-type AmqpStarter<TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined> = Module<AmqpRuntime | AmqpConfig, ConfigInvalid, Env | HandlersInstanceOf<TContract> | UnitNeedsOf$1<Unit>>;
+type AmqpStarter<TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined> = Module<AmqpRuntime | AmqpConfig, ConfigInvalid, EnvReading<never, "AMQP_URL" | "AMQP_CONNECT_TIMEOUT_MS"> | HandlersInstanceOf<TContract> | UnitNeedsOf$1<Unit>>;
 /** The application's imports plus the starter — the tuple `Module(name)` is handed. */
 type Imports<I extends readonly AnyModule[], TContract extends AnyAmqpContract, Unit extends AnyUnitModule | undefined> = readonly [...I, AmqpStarter<TContract, Unit>];
 /** The handlers provider plus the application's own — the tuple `Module(name)` is handed. */

package/dist/index.mjs

@@ -241,7 +241,7 @@ const amqp = (options) => {
 * AmqpHandlers(orderContract)([orderNotifications, orderAudit])
 * ```
 *
-* The first is `{ inject, unit?, sync }`, whose `sync` hands back the whole
+* The first is `{ inject?, unit?, sync }`, whose `sync` hands back the whole
 * handlers record — one `unit:` record for every entry in it. The second takes
 * the pieces `AmqpHandler(contract, key)` builds: they are the provider's deps,
 * keyed by the contract key each piece's port id carries, so the services

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/amqp-worker",
-  "version": "0.25.0",
+  "version": "0.27.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,11 +47,11 @@
     "@amqp-contract/contract": "3.0.0-beta.11",
     "@amqp-contract/testing": "3.0.0-beta.11",
     "@amqp-contract/worker": "3.0.0-beta.11",
-    "@btravstack/config": "0.25.0",
-    "@btravstack/core": "0.25.0",
-    "@btravstack/di": "0.25.0",
+    "@btravstack/config": "0.27.0",
+    "@btravstack/core": "0.27.0",
+    "@btravstack/di": "0.27.0",
     "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/testing": "0.25.0",
+    "@btravstack/testing": "0.27.0",
     "@btravstack/tsconfig": "0.4.0",
     "@opentelemetry/api": "1.9.1",
     "@types/node": "26.6.4",
@@ -66,9 +66,9 @@
   },
   "peerDependencies": {
     "@amqp-contract/worker": "^3.0.0-beta.7",
-    "@btravstack/config": "^0.25.0",
-    "@btravstack/core": "^0.25.0",
-    "@btravstack/di": "^0.25.0",
+    "@btravstack/config": "^0.27.0",
+    "@btravstack/core": "^0.27.0",
+    "@btravstack/di": "^0.27.0",
     "@opentelemetry/api": "^1",
     "unthrown": "^5.7.0"
   },