@btravstack/amqp-worker 0.9.0 → 0.10.0

package/README.md

@@ -13,7 +13,7 @@
 
 ```sh
 pnpm add @btravstack/amqp-worker @btravstack/core @btravstack/config @btravstack/di unthrown \
-  @amqp-contract/worker @opentelemetry/api
+  @amqp-contract/worker@^3.0.0-beta.7 @opentelemetry/api
 ```
 
 All six are peer dependencies — install them (`@opentelemetry/api` because
@@ -53,7 +53,7 @@ import { ErrAsync, OkAsync, P } from "unthrown";
 const orderHandlers = AmqpHandlers(orderContract)({
   inject: { placeOrder: PlaceOrder },
   sync: ({ placeOrder }) => ({
-    orderNotifications: (message) =>
+    orderNotifications: ({ input: message }) =>
       placeOrder
         .execute(
           TenantId(message.payload.tenantId),
@@ -106,6 +106,10 @@ pieces' ports, not what they close over. Two slices claiming one key are di's
 duplicate-provider defect at build, which is the point: a consumer belongs to
 exactly one slice.
 
+Its own test suite needs a **Docker daemon**: the specs run against the shared
+`rabbitmq` container `internal/test-infra` starts once per machine and every
+workspace reuses. Nothing else here does.
+
 ## Options
 
 `AmqpModule(name)({...})` takes `amqp()`'s options plus `handlers` and the

package/dist/index.cjs

@@ -34,7 +34,17 @@ const AmqpHandler = (contract, key) => {
 * handler that must stop when the kernel stops waiting reads
 * `currentUnit()?.signal`.
 */
-const messageUnits = (host) => (args, next) => host.run(metaFor(args.rawMessage), () => next());
+const messageUnits = (host, observers) => (args, next) => {
+	const settle = (0, _btravstack_core.observe)(observers, {
+		component: "amqp",
+		name: "delivery",
+		attributes: { handler: args.handlerName }
+	});
+	return host.run(metaFor(args.rawMessage), () => next()).tap(() => settle({ outcome: "ok" })).tapFailure((failure) => settle({
+		outcome: "error",
+		cause: failure.tag === "Err" ? failure.error : failure.cause
+	}));
+};
 /**
 * `UnitMeta.id` must be unique per unit, and a **delivery tag is not one**: tags
 * are per-channel and restart at `1` after a reconnect, which
@@ -115,17 +125,25 @@ const amqp = (options) => {
 	}));
 	return (0, _btravstack_di.Module)("Amqp")({
 		needs: [_btravstack_config.Env, AmqpHandlersPort],
-		provides: [config, (0, _btravstack_di.Provider)(AmqpRuntime)({
-			inject: {
-				config: AmqpConfig,
-				handlers: AmqpHandlersPort
-			},
-			sync: ({ config: bound, handlers }) => ({
-				name: "amqp",
-				resolves: [],
-				start: (host) => createWorker(host, bound, options, handlers)
+		provides: [
+			config,
+			_btravstack_di.Provider.member(_btravstack_core.Observers)({
+				inject: {},
+				value: _btravstack_core.noObserver
+			}),
+			(0, _btravstack_di.Provider)(AmqpRuntime)({
+				inject: {
+					config: AmqpConfig,
+					handlers: AmqpHandlersPort,
+					observers: _btravstack_core.Observers
+				},
+				sync: ({ config: bound, handlers, observers }) => ({
+					name: "amqp",
+					resolves: [],
+					start: (host) => createWorker(host, bound, options, handlers, observers)
+				})
 			})
-		})],
+		],
 		exports: [AmqpRuntime, AmqpConfig]
 	});
 };
@@ -165,15 +183,15 @@ const queuesOf = (contract) => [...new Set(Object.values({
 	...contract.consumers,
 	...contract.rpcs
 }).map((entry) => entry.queue.name))].sort();
-const createWorker = (host, config, options, handlers) => _amqp_contract_worker.TypedAmqpWorker.create({
+const createWorker = (host, config, options, handlers, observers) => _amqp_contract_worker.TypedAmqpWorker.create({
 	contract: options.contract,
 	handlers,
-	middleware: messageUnits(host),
+	middleware: messageUnits(host, observers),
 	urls: [config.url],
 	...options.connectionOptions === void 0 ? {} : { connectionOptions: options.connectionOptions },
 	...options.defaultConsumerOptions === void 0 ? {} : { defaultConsumerOptions: options.defaultConsumerOptions },
 	connectTimeoutMs: config.connectTimeoutMs
-}).map((worker) => consume(worker, queuesOf(options.contract))).recoverDefect((cause) => (0, unthrown.ErrAsync)(startFailed(cause)));
+}).map((worker) => consume(worker, queuesOf(options.contract))).mapErrCases((matcher) => matcher.with(unthrown.P.tag("@amqp-contract/ConnectionError"), (error) => startFailed(error)));
 const consume = (worker, queues) => {
 	let closing;
 	const beginClose = () => closing ??= worker.close({ drainTimeoutMs: null });

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { Module, Port, Provider } from "@btravstack/di";
 import { TypedAmqpWorker } from "@amqp-contract/worker";
 import { Config, Env } from "@btravstack/config";
-import { RuntimePort, RuntimeStartFailed, releasedBy } from "@btravstack/core";
-import { ErrAsync } from "unthrown";
+import { Observers, RuntimePort, RuntimeStartFailed, noObserver, observe, releasedBy } from "@btravstack/core";
+import { P } from "unthrown";
 import { randomUUID } from "node:crypto";
 //#region src/handler.ts
 /** The prefix a piece's port id carries; the composing form strips it to recover the key. */
@@ -33,7 +33,17 @@ const AmqpHandler = (contract, key) => {
 * handler that must stop when the kernel stops waiting reads
 * `currentUnit()?.signal`.
 */
-const messageUnits = (host) => (args, next) => host.run(metaFor(args.rawMessage), () => next());
+const messageUnits = (host, observers) => (args, next) => {
+	const settle = observe(observers, {
+		component: "amqp",
+		name: "delivery",
+		attributes: { handler: args.handlerName }
+	});
+	return host.run(metaFor(args.rawMessage), () => next()).tap(() => settle({ outcome: "ok" })).tapFailure((failure) => settle({
+		outcome: "error",
+		cause: failure.tag === "Err" ? failure.error : failure.cause
+	}));
+};
 /**
 * `UnitMeta.id` must be unique per unit, and a **delivery tag is not one**: tags
 * are per-channel and restart at `1` after a reconnect, which
@@ -114,17 +124,25 @@ const amqp = (options) => {
 	}));
 	return Module("Amqp")({
 		needs: [Env, AmqpHandlersPort],
-		provides: [config, Provider(AmqpRuntime)({
-			inject: {
-				config: AmqpConfig,
-				handlers: AmqpHandlersPort
-			},
-			sync: ({ config: bound, handlers }) => ({
-				name: "amqp",
-				resolves: [],
-				start: (host) => createWorker(host, bound, options, handlers)
+		provides: [
+			config,
+			Provider.member(Observers)({
+				inject: {},
+				value: noObserver
+			}),
+			Provider(AmqpRuntime)({
+				inject: {
+					config: AmqpConfig,
+					handlers: AmqpHandlersPort,
+					observers: Observers
+				},
+				sync: ({ config: bound, handlers, observers }) => ({
+					name: "amqp",
+					resolves: [],
+					start: (host) => createWorker(host, bound, options, handlers, observers)
+				})
 			})
-		})],
+		],
 		exports: [AmqpRuntime, AmqpConfig]
 	});
 };
@@ -164,15 +182,15 @@ const queuesOf = (contract) => [...new Set(Object.values({
 	...contract.consumers,
 	...contract.rpcs
 }).map((entry) => entry.queue.name))].sort();
-const createWorker = (host, config, options, handlers) => TypedAmqpWorker.create({
+const createWorker = (host, config, options, handlers, observers) => TypedAmqpWorker.create({
 	contract: options.contract,
 	handlers,
-	middleware: messageUnits(host),
+	middleware: messageUnits(host, observers),
 	urls: [config.url],
 	...options.connectionOptions === void 0 ? {} : { connectionOptions: options.connectionOptions },
 	...options.defaultConsumerOptions === void 0 ? {} : { defaultConsumerOptions: options.defaultConsumerOptions },
 	connectTimeoutMs: config.connectTimeoutMs
-}).map((worker) => consume(worker, queuesOf(options.contract))).recoverDefect((cause) => ErrAsync(startFailed(cause)));
+}).map((worker) => consume(worker, queuesOf(options.contract))).mapErrCases((matcher) => matcher.with(P.tag("@amqp-contract/ConnectionError"), (error) => startFailed(error)));
 const consume = (worker, queues) => {
 	let closing;
 	const beginClose = () => closing ??= worker.close({ drainTimeoutMs: null });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/amqp-worker",
-  "version": "0.9.0",
+  "version": "0.10.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",
@@ -44,9 +44,9 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@amqp-contract/contract": "3.0.0-beta.6",
-    "@amqp-contract/testing": "3.0.0-beta.6",
-    "@amqp-contract/worker": "3.0.0-beta.6",
+    "@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/tsconfig": "0.2.0",
     "@opentelemetry/api": "1.9.1",
     "@types/node": "26.4.0",
@@ -56,20 +56,20 @@
     "typescript": "7.0.2",
     "unthrown": "5.7.0",
     "vitest": "4.1.11",
-    "zod": "4.5.1",
-    "@btravstack/config": "0.9.0",
-    "@btravstack/core": "0.9.0",
-    "@btravstack/di": "0.9.0",
+    "zod": "4.5.3",
+    "@btravstack/config": "0.10.0",
+    "@btravstack/core": "0.10.0",
+    "@btravstack/di": "0.10.0",
     "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/testing": "0.9.0"
+    "@btravstack/testing": "0.10.0"
   },
   "peerDependencies": {
-    "@amqp-contract/worker": "^3.0.0-beta.6",
+    "@amqp-contract/worker": "^3.0.0-beta.7",
     "@opentelemetry/api": "^1",
     "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.9.0",
-    "@btravstack/core": "^0.9.0",
-    "@btravstack/di": "^0.9.0"
+    "@btravstack/config": "^0.10.0",
+    "@btravstack/core": "^0.10.0",
+    "@btravstack/di": "^0.10.0"
   },
   "engines": {
     "node": ">=22"