@wildo-ai/saas-backend-lib 1.1.1 → 1.1.3

package/dist/esm/queue/adapters/queue-adapter.backend.binding.js

@@ -0,0 +1,47 @@
+import { QueueAdapterType } from '@wildo-ai/saas-models';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { InMemoryQueueAdapterBackendService } from '../../queue/adapters/in-memory-queue-adapter.backend.service.js';
+import { RabbitMQAdapterBackendService } from '../../queue/adapters/rabbitmq-adapter.backend.service.js';
+/**
+ * The one place a queue adapter is chosen (#502).
+ *
+ * ## Why this function exists at all
+ *
+ * `QueueAdapterType` had **zero readers**. It declared three adapters while one class existed and
+ * every consumer injected that class by name, so the enum was a vocabulary describing a choice
+ * nothing could make — and adding an adapter without adding a way to select it would have produced a
+ * second unreachable thing rather than fixing the first.
+ *
+ * So the enum is now read HERE, and this is the only site that maps a member to an implementation.
+ * A `Record` over the type rather than a `switch` with a default, for the reason
+ * `invariant-call-site-enumeration.md` #21 records: a `default:` arm silently absorbs a new member
+ * into whatever it returns, while a total record makes adding one a compile error until somebody
+ * says which class serves it.
+ *
+ * ## The default is RabbitMQ, and that is not a placeholder
+ *
+ * A deployed application wants a broker: durability across a restart, visibility across processes,
+ * and permissions per runtime are the properties it is buying. {@link QueueAdapterType.MEMORY} is
+ * for a test lane, and for a single-process runtime that has declared it wants no broker — it is not
+ * a smaller RabbitMQ, and `InMemoryQueueAdapterBackendService` says exactly what it does not provide.
+ */
+const QUEUE_ADAPTER_IMPLEMENTATIONS = {
+    [QueueAdapterType.RABBITMQ]: RabbitMQAdapterBackendService,
+    [QueueAdapterType.MEMORY]: InMemoryQueueAdapterBackendService,
+};
+/**
+ * Bind the queue adapter a runtime will use.
+ *
+ * Rebinds when the token is already bound, so a test lane can select the in-memory adapter against a
+ * container the framework has already configured — which is the shape every consumer of this
+ * actually needs, and a bind-only version would have forced each of them to build a container from
+ * scratch.
+ */
+export function bindQueueAdapter(container, adapterType) {
+    const implementation = QUEUE_ADAPTER_IMPLEMENTATIONS[adapterType];
+    if (container.isBound(SAAS_SERVICE_TYPES.RabbitMQAdapterService)) {
+        container.unbind(SAAS_SERVICE_TYPES.RabbitMQAdapterService);
+    }
+    container.bind(SAAS_SERVICE_TYPES.RabbitMQAdapterService).to(implementation).inSingletonScope();
+}
+//# sourceMappingURL=queue-adapter.backend.binding.js.map

package/dist/esm/queue/adapters/queue-adapter.backend.binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-adapter.backend.binding.js","sourceRoot":"","sources":["../../../../../src/queue/adapters/queue-adapter.backend.binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,kCAAkC,EAAE,MAAM,2EAA2E,CAAC;AAC/H,OAAO,EAAE,6BAA6B,EAAE,MAAM,oEAAoE,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,6BAA6B,GAAG;IACpC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,6BAA6B;IAC1D,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,kCAAkC;CACiB,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoB,EAAE,WAA6B;IAClF,MAAM,cAAc,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAClE,IAAI,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACjE,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IAC9D,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAClG,CAAC","sourcesContent":["import type { Container } from 'inversify';\nimport { QueueAdapterType } from '@wildo-ai/saas-models';\n\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { InMemoryQueueAdapterBackendService } from '~wildo-backend-lib/queue/adapters/in-memory-queue-adapter.backend.service';\nimport { RabbitMQAdapterBackendService } from '~wildo-backend-lib/queue/adapters/rabbitmq-adapter.backend.service';\n\n/**\n * The one place a queue adapter is chosen (#502).\n *\n * ## Why this function exists at all\n *\n * `QueueAdapterType` had **zero readers**. It declared three adapters while one class existed and\n * every consumer injected that class by name, so the enum was a vocabulary describing a choice\n * nothing could make — and adding an adapter without adding a way to select it would have produced a\n * second unreachable thing rather than fixing the first.\n *\n * So the enum is now read HERE, and this is the only site that maps a member to an implementation.\n * A `Record` over the type rather than a `switch` with a default, for the reason\n * `invariant-call-site-enumeration.md` #21 records: a `default:` arm silently absorbs a new member\n * into whatever it returns, while a total record makes adding one a compile error until somebody\n * says which class serves it.\n *\n * ## The default is RabbitMQ, and that is not a placeholder\n *\n * A deployed application wants a broker: durability across a restart, visibility across processes,\n * and permissions per runtime are the properties it is buying. {@link QueueAdapterType.MEMORY} is\n * for a test lane, and for a single-process runtime that has declared it wants no broker — it is not\n * a smaller RabbitMQ, and `InMemoryQueueAdapterBackendService` says exactly what it does not provide.\n */\nconst QUEUE_ADAPTER_IMPLEMENTATIONS = {\n  [QueueAdapterType.RABBITMQ]: RabbitMQAdapterBackendService,\n  [QueueAdapterType.MEMORY]: InMemoryQueueAdapterBackendService,\n} as const satisfies Record<QueueAdapterType, new (...args: never[]) => unknown>;\n\n/**\n * Bind the queue adapter a runtime will use.\n *\n * Rebinds when the token is already bound, so a test lane can select the in-memory adapter against a\n * container the framework has already configured — which is the shape every consumer of this\n * actually needs, and a bind-only version would have forced each of them to build a container from\n * scratch.\n */\nexport function bindQueueAdapter(container: Container, adapterType: QueueAdapterType): void {\n  const implementation = QUEUE_ADAPTER_IMPLEMENTATIONS[adapterType];\n  if (container.isBound(SAAS_SERVICE_TYPES.RabbitMQAdapterService)) {\n    container.unbind(SAAS_SERVICE_TYPES.RabbitMQAdapterService);\n  }\n  container.bind(SAAS_SERVICE_TYPES.RabbitMQAdapterService).to(implementation).inSingletonScope();\n}\n"]}

package/dist/esm/queue/adapters/queue-adapter.backend.interface.d.ts

@@ -0,0 +1,87 @@
+import type { JobPayload, JobResult } from '@wildo-ai/saas-models';
+import type { PublishOptions, QueueAssertOptions } from '../../queue/adapters/queue-adapter.backend.options';
+/**
+ * The queue port every background-work consumer depends on (#502).
+ *
+ * ## Why this exists, and what it deliberately excludes
+ *
+ * `QueueAdapterType` declared RabbitMQ, Redis and in-memory adapters and there was **one** class,
+ * injected concretely by every consumer through `SAAS_SERVICE_TYPES.RabbitMQAdapterService`. So the
+ * enum offered a choice nothing could make, and there was no shape a second adapter could satisfy.
+ *
+ * The surface here is not the RabbitMQ class's public API — it is what consumers were **measured**
+ * to call. Two amqplib escape hatches are excluded on purpose:
+ *
+ * - `getChannel()` / `getTopologyChannel()` return an amqplib `Channel`, which nothing but a broker
+ *   can produce. Their one consumer outside the adapter was queue monitoring, reading a queue depth,
+ *   and that is now {@link QueueAdapter.getQueueDepth} — a question every adapter can answer about
+ *   itself instead of a connection handle only one of them has.
+ *
+ * Anything genuinely RabbitMQ-specific stays on `RabbitMQAdapterBackendService` and is reached by
+ * naming that class, which is an honest dependency rather than a port with a hole in it.
+ */
+/**
+ * One delivered message, in the shape a handler reads it.
+ *
+ * Structurally satisfied by amqplib's `ConsumeMessage`, so the RabbitMQ adapter passes its own
+ * messages through unchanged and no translation layer sits on the hot path. Handlers were measured
+ * to read `content` and `properties` only; `fields` is carried because the redelivery flag is the
+ * kind of thing a retry decision legitimately reaches for, and omitting it would push a consumer
+ * straight back to the amqplib type.
+ */
+export interface QueueConsumeMessage {
+    readonly content: Buffer;
+    readonly fields: {
+        readonly redelivered: boolean;
+    };
+    readonly properties: {
+        readonly correlationId?: string | null;
+        readonly replyTo?: string;
+    };
+}
+/**
+ * Settling a delivery: the only thing handlers ever did with the `Channel` they were handed.
+ *
+ * Measured across every consumer before this was carved: **15 `nack` and 7 `ack`**, and nothing
+ * else. An amqplib `Channel` satisfies this structurally, which is what keeps the RabbitMQ path
+ * unchanged — it hands the real channel over and the narrower type simply stops a handler reaching
+ * for `sendToQueue` or `prefetch` from inside a message callback.
+ */
+export interface QueueMessageAcknowledger {
+    ack(message: QueueConsumeMessage): void;
+    nack(message: QueueConsumeMessage, allUpTo?: boolean, requeue?: boolean): void;
+}
+export type MessageHandler = (message: QueueConsumeMessage, acknowledger: QueueMessageAcknowledger) => Promise<void>;
+/** What a background-work consumer needs from a queue, and nothing more. */
+export interface QueueAdapter {
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    assertQueue(queueName: string, options?: QueueAssertOptions): Promise<void>;
+    publish(queueName: string, payload: JobPayload, options?: PublishOptions): Promise<void>;
+    /**
+     * Re-deliver a job after a delay.
+     *
+     * A first-class port method rather than "publish to a queue you named yourself", because the delay
+     * is realised very differently per adapter — RabbitMQ needs a per-delay queue with a TTL and a
+     * dead-letter exchange back to the source, while an in-memory adapter needs a timer. A consumer
+     * that had to know which is a consumer that cannot change adapters.
+     */
+    scheduleDelayedRetry(sourceQueueName: string, job: JobPayload, delayMs: number, options?: PublishOptions): Promise<void>;
+    consume(queueName: string, handler: MessageHandler): Promise<string>;
+    cancelConsumer(queueName: string): Promise<void>;
+    setupReplyQueue(appId: string, onReply: (correlationId: string, result: JobResult) => void): Promise<string>;
+    publishResult(replyTo: string, correlationId: string, result: JobResult): Promise<void>;
+    getReplyQueueName(): string | null;
+    /**
+     * How many messages are waiting, or `null` when this adapter cannot say.
+     *
+     * `null` is an ANSWER — "not observable here" — and monitoring reports empty metrics for it,
+     * exactly as it already did when no channel was open. It is not an error, because a queue depth
+     * being unavailable is not a fault in the runtime being monitored.
+     */
+    getQueueDepth(queueName: string): Promise<number | null>;
+    /** Identifies the consuming process, so a reply queue is addressed to one runtime. */
+    getPodId(): string;
+}
+//# sourceMappingURL=queue-adapter.backend.interface.d.ts.map

package/dist/esm/queue/adapters/queue-adapter.backend.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-adapter.backend.interface.d.ts","sourceRoot":"","sources":["../../../../../src/queue/adapters/queue-adapter.backend.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAE1H;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAUzB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5F;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAChF;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,wBAAwB,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,OAAO,CAAC;IAEvB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF;;;;;;;OAOG;IACH,oBAAoB,CAClB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7G,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAAC;IAEnC;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzD,sFAAsF;IACtF,QAAQ,IAAI,MAAM,CAAC;CACpB"}

package/dist/esm/queue/adapters/queue-adapter.backend.interface.js

@@ -0,0 +1 @@
+//# sourceMappingURL=queue-adapter.backend.interface.js.map

package/dist/esm/queue/adapters/queue-adapter.backend.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-adapter.backend.interface.js","sourceRoot":"","sources":["../../../../../src/queue/adapters/queue-adapter.backend.interface.ts"],"names":[],"mappings":"","sourcesContent":["import type { JobPayload, JobResult } from '@wildo-ai/saas-models';\n\nimport type { PublishOptions, QueueAssertOptions } from '~wildo-backend-lib/queue/adapters/queue-adapter.backend.options';\n\n/**\n * The queue port every background-work consumer depends on (#502).\n *\n * ## Why this exists, and what it deliberately excludes\n *\n * `QueueAdapterType` declared RabbitMQ, Redis and in-memory adapters and there was **one** class,\n * injected concretely by every consumer through `SAAS_SERVICE_TYPES.RabbitMQAdapterService`. So the\n * enum offered a choice nothing could make, and there was no shape a second adapter could satisfy.\n *\n * The surface here is not the RabbitMQ class's public API — it is what consumers were **measured**\n * to call. Two amqplib escape hatches are excluded on purpose:\n *\n * - `getChannel()` / `getTopologyChannel()` return an amqplib `Channel`, which nothing but a broker\n *   can produce. Their one consumer outside the adapter was queue monitoring, reading a queue depth,\n *   and that is now {@link QueueAdapter.getQueueDepth} — a question every adapter can answer about\n *   itself instead of a connection handle only one of them has.\n *\n * Anything genuinely RabbitMQ-specific stays on `RabbitMQAdapterBackendService` and is reached by\n * naming that class, which is an honest dependency rather than a port with a hole in it.\n */\n\n/**\n * One delivered message, in the shape a handler reads it.\n *\n * Structurally satisfied by amqplib's `ConsumeMessage`, so the RabbitMQ adapter passes its own\n * messages through unchanged and no translation layer sits on the hot path. Handlers were measured\n * to read `content` and `properties` only; `fields` is carried because the redelivery flag is the\n * kind of thing a retry decision legitimately reaches for, and omitting it would push a consumer\n * straight back to the amqplib type.\n */\nexport interface QueueConsumeMessage {\n  readonly content: Buffer;\n  /*\n   * NO index signature on either member, and that is load-bearing rather than minimal.\n   *\n   * amqplib's `ConsumeMessageFields` and `MessageProperties` are closed interfaces, and an index\n   * signature makes them un-assignable (\"index signature for type 'string' is missing\") — so the\n   * RabbitMQ adapter could not hand its own messages through and would have needed a translation\n   * layer on the hot path, purely to satisfy a convenience this port does not need. Declaring only\n   * the members consumers were measured to read keeps the real message structurally compatible.\n   */\n  readonly fields: { readonly redelivered: boolean };\n  readonly properties: { readonly correlationId?: string | null; readonly replyTo?: string };\n}\n\n/**\n * Settling a delivery: the only thing handlers ever did with the `Channel` they were handed.\n *\n * Measured across every consumer before this was carved: **15 `nack` and 7 `ack`**, and nothing\n * else. An amqplib `Channel` satisfies this structurally, which is what keeps the RabbitMQ path\n * unchanged — it hands the real channel over and the narrower type simply stops a handler reaching\n * for `sendToQueue` or `prefetch` from inside a message callback.\n */\nexport interface QueueMessageAcknowledger {\n  ack(message: QueueConsumeMessage): void;\n  nack(message: QueueConsumeMessage, allUpTo?: boolean, requeue?: boolean): void;\n}\n\nexport type MessageHandler = (\n  message: QueueConsumeMessage,\n  acknowledger: QueueMessageAcknowledger,\n) => Promise<void>;\n\n/** What a background-work consumer needs from a queue, and nothing more. */\nexport interface QueueAdapter {\n  connect(): Promise<void>;\n  close(): Promise<void>;\n  isConnected(): boolean;\n\n  assertQueue(queueName: string, options?: QueueAssertOptions): Promise<void>;\n  publish(queueName: string, payload: JobPayload, options?: PublishOptions): Promise<void>;\n  /**\n   * Re-deliver a job after a delay.\n   *\n   * A first-class port method rather than \"publish to a queue you named yourself\", because the delay\n   * is realised very differently per adapter — RabbitMQ needs a per-delay queue with a TTL and a\n   * dead-letter exchange back to the source, while an in-memory adapter needs a timer. A consumer\n   * that had to know which is a consumer that cannot change adapters.\n   */\n  scheduleDelayedRetry(\n    sourceQueueName: string,\n    job: JobPayload,\n    delayMs: number,\n    options?: PublishOptions,\n  ): Promise<void>;\n\n  consume(queueName: string, handler: MessageHandler): Promise<string>;\n  cancelConsumer(queueName: string): Promise<void>;\n\n  setupReplyQueue(appId: string, onReply: (correlationId: string, result: JobResult) => void): Promise<string>;\n  publishResult(replyTo: string, correlationId: string, result: JobResult): Promise<void>;\n  getReplyQueueName(): string | null;\n\n  /**\n   * How many messages are waiting, or `null` when this adapter cannot say.\n   *\n   * `null` is an ANSWER — \"not observable here\" — and monitoring reports empty metrics for it,\n   * exactly as it already did when no channel was open. It is not an error, because a queue depth\n   * being unavailable is not a fault in the runtime being monitored.\n   */\n  getQueueDepth(queueName: string): Promise<number | null>;\n\n  /** Identifies the consuming process, so a reply queue is addressed to one runtime. */\n  getPodId(): string;\n}\n"]}

package/dist/esm/queue/adapters/queue-adapter.backend.options.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Broker-neutral options shared by every queue adapter (#502).
+ *
+ * These sat inside `rabbitmq-adapter.backend.service.ts` while there was only one adapter. They
+ * describe INTENT — durability, a dead-letter destination, a correlation id — rather than any
+ * broker's wire format, so leaving them there would have made the port import the implementation it
+ * exists to abstract.
+ *
+ * An adapter that cannot honour an option ignores it rather than refusing: an in-memory queue has no
+ * meaningful `persistent`, and a caller asking for durability from a queue that lives in a process is
+ * not making a mistake — it is asking for the same job semantics on a different substrate.
+ */
+/** Queue assertion options. */
+export interface QueueAssertOptions {
+    durable?: boolean;
+    exclusive?: boolean;
+    autoDelete?: boolean;
+    deadLetterExchange?: string;
+    deadLetterRoutingKey?: string;
+    messageTtl?: number;
+    maxLength?: number;
+}
+/** Publish options for messages. */
+export interface PublishOptions {
+    correlationId?: string;
+    replyTo?: string;
+    persistent?: boolean;
+    expiration?: string;
+    priority?: number;
+}
+//# sourceMappingURL=queue-adapter.backend.options.d.ts.map

package/dist/esm/queue/adapters/queue-adapter.backend.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-adapter.backend.options.d.ts","sourceRoot":"","sources":["../../../../../src/queue/adapters/queue-adapter.backend.options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/esm/queue/adapters/queue-adapter.backend.options.js

@@ -0,0 +1,13 @@
+/**
+ * Broker-neutral options shared by every queue adapter (#502).
+ *
+ * These sat inside `rabbitmq-adapter.backend.service.ts` while there was only one adapter. They
+ * describe INTENT — durability, a dead-letter destination, a correlation id — rather than any
+ * broker's wire format, so leaving them there would have made the port import the implementation it
+ * exists to abstract.
+ *
+ * An adapter that cannot honour an option ignores it rather than refusing: an in-memory queue has no
+ * meaningful `persistent`, and a caller asking for durability from a queue that lives in a process is
+ * not making a mistake — it is asking for the same job semantics on a different substrate.
+ */
+//# sourceMappingURL=queue-adapter.backend.options.js.map

package/dist/esm/queue/adapters/queue-adapter.backend.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-adapter.backend.options.js","sourceRoot":"","sources":["../../../../../src/queue/adapters/queue-adapter.backend.options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG","sourcesContent":["/**\n * Broker-neutral options shared by every queue adapter (#502).\n *\n * These sat inside `rabbitmq-adapter.backend.service.ts` while there was only one adapter. They\n * describe INTENT — durability, a dead-letter destination, a correlation id — rather than any\n * broker's wire format, so leaving them there would have made the port import the implementation it\n * exists to abstract.\n *\n * An adapter that cannot honour an option ignores it rather than refusing: an in-memory queue has no\n * meaningful `persistent`, and a caller asking for durability from a queue that lives in a process is\n * not making a mistake — it is asking for the same job semantics on a different substrate.\n */\n\n/** Queue assertion options. */\nexport interface QueueAssertOptions {\n  durable?: boolean;\n  exclusive?: boolean;\n  autoDelete?: boolean;\n  deadLetterExchange?: string;\n  deadLetterRoutingKey?: string;\n  messageTtl?: number;\n  maxLength?: number;\n}\n\n/** Publish options for messages. */\nexport interface PublishOptions {\n  correlationId?: string;\n  replyTo?: string;\n  persistent?: boolean;\n  expiration?: string;\n  priority?: number;\n}\n"]}

package/dist/esm/queue/adapters/rabbitmq-adapter.backend.service.d.ts

@@ -10,6 +10,8 @@ import { AppConfigurationService } from '../../config/services/app-configuration
 import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service';
 import { JobPayload, JobResult } from '@wildo-ai/saas-models';
 import type { Channel, ConsumeMessage } from 'amqplib';
+import type { MessageHandler, QueueAdapter } from '../../queue/adapters/queue-adapter.backend.interface';
+import type { PublishOptions, QueueAssertOptions } from '../../queue/adapters/queue-adapter.backend.options';
 /**
  * RabbitMQ configuration for connection.
  */
@@ -24,32 +26,15 @@ export interface RabbitMQConfig {
     channelMax?: number;
 }
 /**
- * Queue assertion options.
- */
-export interface QueueAssertOptions {
-    durable?: boolean;
-    exclusive?: boolean;
-    autoDelete?: boolean;
-    deadLetterExchange?: string;
-    deadLetterRoutingKey?: string;
-    messageTtl?: number;
-    maxLength?: number;
-}
-/**
- * Publish options for messages.
- */
-export interface PublishOptions {
-    correlationId?: string;
-    replyTo?: string;
-    persistent?: boolean;
-    expiration?: string;
-    priority?: number;
-}
-/**
- * Message handler type for consumers.
+ * The RabbitMQ realisation of {@link QueueAdapter} (#502).
+ *
+ * Everything a background-work consumer needs is declared on the port; what remains here and NOT on
+ * it is genuinely broker-specific — `configure()` takes a `RabbitMQConfig`, and `getChannel()` /
+ * `getTopologyChannel()` hand out an amqplib `Channel` that only a broker can produce. A caller that
+ * needs one of those names this class, which is an honest dependency rather than a port with a hole
+ * in it.
  */
-export type MessageHandler = (msg: ConsumeMessage, channel: Channel) => Promise<void>;
-export declare class RabbitMQAdapterBackendService {
+export declare class RabbitMQAdapterBackendService implements QueueAdapter {
     private readonly logger;
     private readonly appConfigService;
     private readonly errorBuilder;
@@ -268,6 +253,15 @@ export declare class RabbitMQAdapterBackendService {
     /**
      * Get pod ID for this instance.
      */
+    /**
+     * Queue depth from the broker, or `null` when no channel is open (#502).
+     *
+     * This replaces monitoring reaching for `getChannel()` and calling `checkQueue` itself. The
+     * behaviour is unchanged — `null` here produces the same empty metrics that a null channel already
+     * produced — but the question is now one every adapter can answer about itself, instead of a
+     * connection handle only this one can hand out.
+     */
+    getQueueDepth(queueName: string): Promise<number | null>;
     getPodId(): string;
 }
 //# sourceMappingURL=rabbitmq-adapter.backend.service.d.ts.map

package/dist/esm/queue/adapters/rabbitmq-adapter.backend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rabbitmq-adapter.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/queue/adapters/rabbitmq-adapter.backend.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rabbitmq-adapter.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/queue/adapters/rabbitmq-adapter.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAsB,SAAS,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAG9G,OAAO,EAGL,UAAU,EACV,SAAS,EAMV,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAW,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAEb,MAAM,mEAAmE,CAAC;AAC3E,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,iEAAiE,CAAC;AAKzE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,qBACa,6BAA8B,YAAW,YAAY;IAoD9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAGS,OAAO,CAAC,QAAQ,CAAC,SAAS;IA1DlE,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,OAAO,CAAwB;IACvC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAkC;IACtD;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAU;gBAIpC,MAAM,EAAE,aAAa,EAErB,gBAAgB,EAAE,uBAAuB,EAEzC,YAAY,EAAE,0BAA0B,EAGF,SAAS,EAAE,SAAS;IAY7E;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAM9C;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkFrC;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,UAAU,IAAI,OAAO;IAc5B;;;;;OAKG;YACW,qBAAqB;IAkBnC;;;;;OAKG;IACU,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBnD;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;;;;;;;;OASG;IACU,WAAW,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAkChB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;;;;OAOG;YACW,wBAAwB;IAsCtC;;OAEG;IACU,OAAO,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA8ChB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,oBAAoB,CAC/B,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACU,aAAa,CACxB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,OAAO,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC;IA+ClB;;OAEG;IACU,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D;;OAEG;IAEH;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,4BAA4B;IAkBvB,eAAe,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,GAC1D,OAAO,CAAC,MAAM,CAAC;IA4ClB;;OAEG;IACI,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAKrC;;OAEG;IACI,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI;IAKhE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CnC;;OAEG;IACH;;;;;;;OAOG;IACU,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgB9D,QAAQ,IAAI,MAAM;CAG1B"}

package/dist/esm/queue/adapters/rabbitmq-adapter.backend.service.js

@@ -25,6 +25,15 @@ import { ErrorBuilderBackendService } from '../../errors/services/error-builder.
 import { describeCaughtError, projectCaughtErrorLogFields } from '../../errors/utils/error-log-level-classification.backend.utils.js';
 import { runInFreshRequestContextIfAbsent } from '../../runtime/models/request-context.als.backend.js';
 import { ErrorType, ErrorCustomMessageReference, RabbitMQQueueArgKeys, buildReplyQueueName, buildDelayQueueName, buildRabbitMQConnectionUrl, } from '@wildo-ai/saas-models';
+/**
+ * The RabbitMQ realisation of {@link QueueAdapter} (#502).
+ *
+ * Everything a background-work consumer needs is declared on the port; what remains here and NOT on
+ * it is genuinely broker-specific — `configure()` takes a `RabbitMQConfig`, and `getChannel()` /
+ * `getTopologyChannel()` hand out an amqplib `Channel` that only a broker can produce. A caller that
+ * needs one of those names this class, which is an honest dependency rather than a port with a hole
+ * in it.
+ */
 let RabbitMQAdapterBackendService = class RabbitMQAdapterBackendService {
     logger;
     appConfigService;
@@ -662,6 +671,30 @@ let RabbitMQAdapterBackendService = class RabbitMQAdapterBackendService {
     /**
      * Get pod ID for this instance.
      */
+    /**
+     * Queue depth from the broker, or `null` when no channel is open (#502).
+     *
+     * This replaces monitoring reaching for `getChannel()` and calling `checkQueue` itself. The
+     * behaviour is unchanged — `null` here produces the same empty metrics that a null channel already
+     * produced — but the question is now one every adapter can answer about itself, instead of a
+     * connection handle only this one can hand out.
+     */
+    async getQueueDepth(queueName) {
+        const channel = this.getChannel();
+        if (!channel) {
+            return null;
+        }
+        // `checkQueue` CLOSES the channel when the queue does not exist — the reason monitoring stopped
+        // probing dead-letter queues (see `getQueueMetrics`). Reported as "not observable" rather than
+        // thrown: a queue that has not been asserted yet is not a fault in the runtime being monitored.
+        try {
+            const queueInfo = await channel.checkQueue(queueName);
+            return queueInfo.messageCount;
+        }
+        catch {
+            return null;
+        }
+    }
     getPodId() {
         return this.podId;
     }

package/dist/esm/queue/adapters/rabbitmq-adapter.backend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"rabbitmq-adapter.backend.service.js","sourceRoot":"","sources":["../../../../../src/queue/adapters/rabbitmq-adapter.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RabbitMQ Adapter for Queue System\n *\n * Provides connection management, publishing, and consuming capabilities.\n * Uses amqplib for RabbitMQ communication.\n */\n\nimport { buildRuntimePrincipalQueueSegment, runtimePrincipalKindFromRuntimeProfile } from '@wildo-ai/platform-config-lib';\nimport { injectable, inject, Container } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { AppConfigurationService } from '~wildo-backend-lib/config/services/app-configuration.backend.service';\nimport { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport { describeCaughtError, projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { runInFreshRequestContextIfAbsent } from '~wildo-backend-lib/runtime/models/request-context.als.backend';\nimport {\n  ErrorType,\n  ErrorCustomMessageReference,\n  JobPayload,\n  JobResult,\n  RabbitMQQueueArgKeys,\n  buildQueueName,\n  buildReplyQueueName,\n  buildDelayQueueName,\n  buildRabbitMQConnectionUrl,\n} from '@wildo-ai/saas-models';\n\n// Import amqplib types\n// Note: We use 'any' for Connection because amqplib types are complex and vary between versions\nimport type { Channel, ConsumeMessage, Options } from 'amqplib';\n\n// Connection type from amqplib - using any for compatibility with different type versions\ntype AmqpConnection = any;\n\n/**\n * RabbitMQ configuration for connection.\n */\nexport interface RabbitMQConfig {\n  host: string;\n  port: number;\n  username: string;\n  password: string;\n  vhost?: string;\n  heartbeat?: number;\n  connectionTimeout?: number;\n  channelMax?: number;\n}\n\n/**\n * Queue assertion options.\n */\nexport interface QueueAssertOptions {\n  durable?: boolean;\n  exclusive?: boolean;\n  autoDelete?: boolean;\n  deadLetterExchange?: string;\n  deadLetterRoutingKey?: string;\n  messageTtl?: number;\n  maxLength?: number;\n}\n\n/**\n * Publish options for messages.\n */\nexport interface PublishOptions {\n  correlationId?: string;\n  replyTo?: string;\n  persistent?: boolean;\n  expiration?: string;\n  priority?: number;\n}\n\n/**\n * Message handler type for consumers.\n */\nexport type MessageHandler = (msg: ConsumeMessage, channel: Channel) => Promise<void>;\n\n@injectable()\nexport class RabbitMQAdapterBackendService {\n  protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n  private connection: AmqpConnection | null = null;\n  private channel: Channel | null = null;\n  /**\n   * Dedicated channel used ONLY for topology declarations (`assertQueue`).\n   *\n   * Queue declarations can fail with `406 PRECONDITION_FAILED` when an\n   * already-existing durable queue is redeclared with different immutable\n   * arguments (e.g. a pre-DLX `operations` queue redeclared with an\n   * `x-dead-letter-exchange`). RabbitMQ responds to a 406 by **closing the\n   * channel it arrived on**. If declarations ran on the primary\n   * publish/consume channel, one incompatible legacy queue would tear down the\n   * whole channel — the adapter would report itself disconnected, every\n   * subsequent (compatible) declaration would be skipped, and the app would\n   * crash-loop during bring-up.\n   *\n   * Isolating declarations on their own channel means a 406 kills only THIS\n   * channel; the primary channel stays alive, and the topology channel is\n   * lazily recreated on the next declaration. See {@link getTopologyChannel}.\n   */\n  private topologyChannel: Channel | null = null;\n  private readonly config: RabbitMQConfig | null = null;\n  private isConfigured = false;\n  private consumerTags: Map<string, string> = new Map();\n  /**\n   * Names of retry/delay queues already asserted on the current channel.\n   * `scheduleDelayedRetry` declares a delay queue per distinct delay value; this\n   * cache skips the redundant round-trip on subsequent retries. Cleared when the\n   * channel closes so a fresh channel re-asserts (queues are durable, but a reset\n   * vhost / broker would otherwise be assumed present).\n   */\n  private assertedDelayQueues: Set<string> = new Set();\n  private replyQueueName: string | null = null;\n  private readonly podId: string;\n  /**\n   * Opt-in gate for automatic topology remediation of a `406\n   * PRECONDITION_FAILED` on `assertQueue`. When enabled AND the mismatched\n   * queue is **empty**, the adapter deletes the legacy queue and re-declares it\n   * with the desired arguments instead of throwing. Read once from\n   * `WILDO_QUEUE_TOPOLOGY_AUTO_REMEDIATE=true`.\n   *\n   * Fail-closed by default (`false`): auto-deleting a queue is a data-loss\n   * footgun outside greenfield/dev, so the framework refuses to do it unless an\n   * operator explicitly opts in. Even when enabled, a queue that still holds\n   * messages is NEVER auto-deleted — the assertion re-throws so a human\n   * decides. See {@link remediateMismatchedQueue}.\n   */\n  private readonly topologyAutoRemediateEnabled: boolean;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger)\n    private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.AppConfigService)\n    private readonly appConfigService: AppConfigurationService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService)\n    private readonly errorBuilder: ErrorBuilderBackendService,\n    // Appended LAST — this constructor is resolved positionally by several\n    // containers, and inserting mid-list silently shifts every later dependency.\n    @inject(SAAS_SERVICE_TYPES.Container) private readonly container: Container,\n  ) {\n    this.logDebug = this.logger.debugByType('RabbitMQAdapterBackendService');\n    this.logger.setDebugTypeLogging('RabbitMQAdapterBackendService', false);\n    // Get pod ID from environment or generate one\n    this.podId = process.env.K8S_POD_NAME ||\n                 process.env.HOSTNAME ||\n                 `local-${Math.random().toString(36).substring(2, 10)}`;\n    this.topologyAutoRemediateEnabled =\n      process.env.WILDO_QUEUE_TOPOLOGY_AUTO_REMEDIATE === 'true';\n  }\n\n  /**\n   * Configure the RabbitMQ adapter with connection settings.\n   * Must be called before connect().\n   */\n  public configure(config: RabbitMQConfig): void {\n    (this as any).config = config;\n    this.isConfigured = true;\n    this.logger.info('RabbitMQ adapter configured', { host: config.host, port: config.port });\n  }\n\n  /**\n   * Connect to RabbitMQ server.\n   */\n  public async connect(): Promise<void> {\n    if (!this.isConfigured || !this.config) {\n      throw this.errorBuilder.buildError(\n        ErrorType.CONFIGURATION,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_INITIALIZATION_FAILED,\n          context: { message: 'RabbitMQ adapter not configured. Call configure() first.' },\n        }\n      );\n    }\n\n    try {\n      // Dynamic import amqplib\n      const amqp = await import('amqplib');\n\n      const connectionUrl = buildRabbitMQConnectionUrl({\n        host: this.config.host,\n        port: this.config.port,\n        username: this.config.username,\n        password: this.config.password,\n        vhost: this.config.vhost,\n      });\n\n      this.connection = await amqp.connect(connectionUrl, {\n        heartbeat: this.config.heartbeat ?? 60,\n        timeout: this.config.connectionTimeout ?? 30000,\n      });\n\n      // Handle connection events\n      this.connection.on('error', (err) => {\n        this.logger.error('RabbitMQ connection error', { error: err.message });\n      });\n\n      this.connection.on('close', () => {\n        this.logger.warn('RabbitMQ connection closed');\n        this.connection = null;\n        this.channel = null;\n        // The topology channel dies with the connection too.\n        this.topologyChannel = null;\n      });\n\n      // Create the primary publish/consume channel.\n      this.channel = await this.connection.createChannel();\n\n      // Handle channel events (prevent unhandled errors during RabbitMQ restarts)\n      this.channel.on('error', (err) => {\n        this.logger.error('RabbitMQ channel error', { error: err.message });\n      });\n\n      this.channel.on('close', () => {\n        this.logger.warn('RabbitMQ channel closed');\n        this.channel = null;\n        // Force re-assertion of delay queues on the next channel.\n        this.assertedDelayQueues.clear();\n      });\n\n      // Set prefetch for fair dispatch\n      await this.channel.prefetch(1);\n\n      // Eagerly create the dedicated topology-declaration channel so the first\n      // `assertQueue` does not pay a channel round-trip. Its lifecycle is\n      // independent of the primary channel: a `406 PRECONDITION_FAILED` closes\n      // only this channel, never the primary publish/consume path.\n      this.topologyChannel = await this.createTopologyChannel(this.connection);\n\n      this.logger.info('Connected to RabbitMQ', { host: this.config.host });\n    } catch (error) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CONNECTION_FAILED,\n          context: {\n            host: this.config.host,\n            error: describeCaughtError(error),\n          },\n        }\n      );\n    }\n  }\n\n  /**\n   * Check if connected to RabbitMQ.\n   */\n  public isConnected(): boolean {\n    return this.connection !== null && this.channel !== null;\n  }\n\n  /**\n   * Get the channel for direct operations.\n   */\n  public getChannel(): Channel {\n    if (!this.channel) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CHANNEL_CLOSED,\n          context: { message: 'RabbitMQ channel not available' },\n        }\n      );\n    }\n    return this.channel;\n  }\n\n  /**\n   * Create a dedicated topology-declaration channel with isolated error\n   * handling. A `406 PRECONDITION_FAILED` on a declaration closes only this\n   * channel; the close handler nulls the reference so it is lazily recreated on\n   * the next declaration. Never carries consumers or publishes.\n   */\n  private async createTopologyChannel(connection: AmqpConnection): Promise<Channel> {\n    const channel: Channel = await connection.createChannel();\n\n    channel.on('error', (err: Error) => {\n      // Expected on a 406 arg-mismatch declaration. Log, but do NOT treat as a\n      // connection failure — the primary channel is unaffected.\n      this.logger.error('RabbitMQ topology channel error', { error: err.message });\n    });\n\n    channel.on('close', () => {\n      this.topologyChannel = null;\n      // A delay queue asserted on a now-closed channel must be re-asserted.\n      this.assertedDelayQueues.clear();\n    });\n\n    return channel;\n  }\n\n  /**\n   * Get the dedicated topology-declaration channel, recreating it if a prior\n   * `406` (or a broker restart) closed it. Public so callers that must declare\n   * with raw arguments not modelled by {@link QueueAssertOptions} (e.g. a\n   * quorum-queue `x-queue-type`) still benefit from primary-channel isolation.\n   */\n  public async getTopologyChannel(): Promise<Channel> {\n    if (this.topologyChannel) {\n      return this.topologyChannel;\n    }\n    if (!this.connection) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CHANNEL_CLOSED,\n          context: { message: 'RabbitMQ connection not available for topology channel' },\n        }\n      );\n    }\n    this.topologyChannel = await this.createTopologyChannel(this.connection);\n    return this.topologyChannel;\n  }\n\n  /**\n   * Translate {@link QueueAssertOptions} into amqplib's `Options.AssertQueue`.\n   *\n   * `deadLetterExchange === ''` is meaningful: it selects the DEFAULT exchange,\n   * which routes a dead-lettered message by `x-dead-letter-routing-key` (a queue\n   * name) — this is exactly how the durable retry/delay queues loop a held\n   * message back to its source queue. Only skip when the caller passed nothing\n   * (`undefined`), i.e. does not want dead-lettering at all.\n   */\n  private buildAssertQueueOptions(options: QueueAssertOptions): Options.AssertQueue {\n    const queueOptions: Options.AssertQueue = {\n      durable: options.durable ?? true,\n      exclusive: options.exclusive ?? false,\n      autoDelete: options.autoDelete ?? false,\n      arguments: {} as Record<string, unknown>,\n    };\n\n    if (options.deadLetterExchange !== undefined) {\n      (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.DEAD_LETTER_EXCHANGE] =\n        options.deadLetterExchange;\n      if (options.deadLetterRoutingKey) {\n        (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.DEAD_LETTER_ROUTING_KEY] =\n          options.deadLetterRoutingKey;\n      }\n    }\n    if (options.messageTtl) {\n      (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.MESSAGE_TTL] = options.messageTtl;\n    }\n    if (options.maxLength) {\n      (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.MAX_LENGTH] = options.maxLength;\n    }\n\n    return queueOptions;\n  }\n\n  /**\n   * Assert a queue exists (create if not).\n   *\n   * Declared on the dedicated {@link topologyChannel} so an arg-mismatch `406`\n   * cannot tear down the primary publish/consume channel. When the mismatch is\n   * unrecoverable in place (a pre-existing queue with different immutable args)\n   * and {@link topologyAutoRemediateEnabled} is set, an EMPTY legacy queue is\n   * deleted and re-declared with the desired args; otherwise the `406`\n   * propagates with a descriptive, operator-actionable error.\n   */\n  public async assertQueue(\n    queueName: string,\n    options: QueueAssertOptions = {}\n  ): Promise<void> {\n    const queueOptions = this.buildAssertQueueOptions(options);\n\n    try {\n      const channel = await this.getTopologyChannel();\n      await channel.assertQueue(queueName, queueOptions);\n    } catch (error) {\n      if (!this.isPreconditionFailed(error)) {\n        throw error;\n      }\n      if (!this.topologyAutoRemediateEnabled) {\n        throw this.errorBuilder.buildError(\n          ErrorType.INFRASTRUCTURE,\n          undefined,\n          {\n            customMessageReference: ErrorCustomMessageReference.QUEUE_INITIALIZATION_FAILED,\n            context: {\n              queueName,\n              message:\n                `Queue '${queueName}' already exists with incompatible arguments ` +\n                `(406 PRECONDITION_FAILED). RabbitMQ cannot mutate a live queue's args. ` +\n                `Delete the stale queue once so it re-declares with the new args, or set ` +\n                `WILDO_QUEUE_TOPOLOGY_AUTO_REMEDIATE=true to auto-delete it when empty.`,\n              error: describeCaughtError(error),\n            },\n          }\n        );\n      }\n      await this.remediateMismatchedQueue(queueName, queueOptions);\n    }\n\n    this.logger.debug('Queue asserted', { queueName, options });\n  }\n\n  /**\n   * Whether an amqplib channel error is a `406 PRECONDITION_FAILED` (immutable\n   * queue-argument mismatch on a redeclaration).\n   */\n  private isPreconditionFailed(error: unknown): boolean {\n    const e = error as { code?: number; message?: unknown } | null;\n    return (\n      e?.code === 406 ||\n      (typeof e?.message === 'string' && e.message.includes('PRECONDITION_FAILED'))\n    );\n  }\n\n  /**\n   * Remediate a `406` arg-mismatch by deleting the legacy queue and\n   * re-declaring it with the desired arguments — but ONLY when the queue is\n   * empty. A non-empty queue is never auto-deleted; the assertion re-throws so a\n   * human decides (data loss must be an explicit human action, never a\n   * bring-up side effect). Runs on a fresh topology channel (the prior one was\n   * closed by the 406).\n   */\n  private async remediateMismatchedQueue(\n    queueName: string,\n    queueOptions: Options.AssertQueue\n  ): Promise<void> {\n    // The 406 already killed the topology channel broker-side; its `close`\n    // event nulls the cached reference, but that arrives on a later microtask,\n    // so the cache may still point at the dead channel here. Discard it\n    // explicitly and force a fresh one — `checkQueue`/`deleteQueue` on a closed\n    // channel would otherwise reject.\n    this.topologyChannel = null;\n    const channel = await this.getTopologyChannel();\n\n    const { messageCount } = await channel.checkQueue(queueName);\n    if (messageCount > 0) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_INITIALIZATION_FAILED,\n          context: {\n            queueName,\n            messageCount,\n            message:\n              `Refusing to auto-remediate queue '${queueName}': it holds ${messageCount} ` +\n              `message(s). Drain or manually delete it before it can re-declare with the ` +\n              `new arguments.`,\n          },\n        }\n      );\n    }\n\n    await channel.deleteQueue(queueName);\n    await channel.assertQueue(queueName, queueOptions);\n    this.logger.warn('Topology auto-remediation: deleted empty mismatched queue and re-declared', {\n      queueName,\n    });\n  }\n\n  /**\n   * Publish a job payload to a queue.\n   */\n  public async publish(\n    queueName: string,\n    payload: JobPayload,\n    options: PublishOptions = {}\n  ): Promise<void> {\n    const channel = this.getChannel();\n\n    try {\n      const content = Buffer.from(JSON.stringify(payload));\n\n      const publishOptions: Options.Publish = {\n        persistent: options.persistent ?? true,\n        correlationId: options.correlationId,\n        replyTo: options.replyTo,\n        priority: options.priority,\n      };\n\n      if (options.expiration) {\n        publishOptions.expiration = options.expiration;\n      }\n\n      channel.sendToQueue(queueName, content, publishOptions);\n\n      this.logger.debug('Message published', {\n        queueName,\n        jobId: payload.jobId,\n        // NOT `correlationId`. This is the AMQP RPC REPLY-MATCHING id (`Options.Publish.correlationId`),\n        // a different id from the request's Wildo `correlationId` that the logger's request-context\n        // mixin already stamps on every line. Logging it under the name `correlationId` merged OVER the\n        // mixin and SHADOWED the request's trace id — and on the fire-and-forget path, where this is\n        // `undefined`, it replaced a real id with `\"[undefined]\"`, making the publish line unattributable.\n        // Same distinction the job schema draws by naming its field `rpcReplyCorrelationId`.\n        ...(options.correlationId ? { rpcReplyCorrelationId: options.correlationId } : {}),\n      });\n    } catch (error) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_PUBLISH_FAILED,\n          context: {\n            queueName,\n            jobId: payload.jobId,\n            error: describeCaughtError(error),\n          },\n        }\n      );\n    }\n  }\n\n  /**\n   * Schedule a durable, broker-timed retry of a failed job.\n   *\n   * Replaces the old in-process `setTimeout` backoff (which lost the retry if the\n   * worker crashed during the wait, since the original message was already ACKed).\n   * The job is published to a dedicated **delay queue** that holds it for\n   * `delayMs` via RabbitMQ's per-queue `x-message-ttl`, then dead-letters it back\n   * to `sourceQueueName` (through the default exchange, routed by queue name) for\n   * re-delivery. The delay queue has NO consumer — the broker owns the wait, so a\n   * held retry survives a worker (or broker) restart because both the queue and\n   * the message are durable/persistent.\n   *\n   * One delay queue is declared per distinct `delayMs`, so every message in a\n   * given delay queue shares the same TTL — avoiding RabbitMQ's per-message-TTL\n   * head-of-line blocking (a short-delay message never waits behind a longer one).\n   *\n   * Contract: the caller MUST have incremented `retryCount` on `job` before\n   * calling, and MUST ACK the original message afterward — the retry is now\n   * durably owned by the broker.\n   *\n   * @param sourceQueueName - Queue the message returns to when the delay elapses\n   * @param job - The (retry-incremented) job payload to redeliver\n   * @param delayMs - How long the broker holds the message before redelivery\n   * @param options - Publish options to preserve across the hop (RPC replyTo/correlationId)\n   */\n  public async scheduleDelayedRetry(\n    sourceQueueName: string,\n    job: JobPayload,\n    delayMs: number,\n    options: PublishOptions = {}\n  ): Promise<void> {\n    const delayQueueName = buildDelayQueueName(sourceQueueName, delayMs);\n\n    // Lazily declare the delay queue (idempotent; cached to skip the round-trip).\n    if (!this.assertedDelayQueues.has(delayQueueName)) {\n      await this.assertQueue(delayQueueName, {\n        durable: true,\n        messageTtl: delayMs,\n        deadLetterExchange: '', // default exchange → routes by routing key (queue name)\n        deadLetterRoutingKey: sourceQueueName,\n      });\n      this.assertedDelayQueues.add(delayQueueName);\n    }\n\n    // Publish persistent so the held retry survives a broker restart.\n    await this.publish(delayQueueName, job, options);\n\n    this.logDebug('Retry scheduled via delay queue', {\n      jobId: job.jobId,\n      delayQueueName,\n      delayMs,\n      retryCount: job.retryCount,\n    });\n  }\n\n  /**\n   * Publish a job result to a reply queue.\n   */\n  public async publishResult(\n    replyTo: string,\n    correlationId: string,\n    result: JobResult\n  ): Promise<void> {\n    const channel = this.getChannel();\n\n    try {\n      const content = Buffer.from(JSON.stringify(result));\n\n      channel.sendToQueue(replyTo, content, {\n        correlationId,\n        persistent: false, // Reply messages don't need persistence\n      });\n\n      this.logger.debug('Result published', {\n        replyTo,\n        // See the note in `publish` — this is the RPC reply-matching id, not the request's trace id.\n        rpcReplyCorrelationId: correlationId,\n        jobId: result.jobId,\n        status: result.status,\n      });\n    } catch (error) {\n      this.logger.error('Failed to publish result', {\n        replyTo,\n        // See the note in `publish`. This one is at ERROR level, where shadowing the request's trace id\n        // is worst: the line an operator reaches for first would name an unrelated RPC id instead.\n        rpcReplyCorrelationId: correlationId,\n        ...projectCaughtErrorLogFields(error),\n      });\n    }\n  }\n\n  /**\n   * Set up a consumer for a queue.\n   *\n   * **Every consumed message runs inside a request-context frame, established HERE.** A consumed\n   * message is an independent unit of work with no ambient context of its own, so without a frame its\n   * log lines carry no `correlationId`, `buildError` has no id to fall back on, and any audit row it\n   * writes lands unattributed. Framing at the ADAPTER rather than in each consumer is deliberate: this\n   * method is the single door every AMQP consumer passes through — the job consumer, the domain-queue\n   * consumer, the scheduled/cron lane, and the minion tick lane (which injects this same service from\n   * `saas-minions-lib`) — so a future consumer cannot forget it. Hand-applying the wrapper per consumer\n   * is precisely the \"invariant applied at N-1 of N call sites\" shape that has already produced repeat\n   * findings in this codebase (`.claude/rules/invariant-call-site-enumeration.md`).\n   *\n   * `runInFreshRequestContextIfAbsent` (not `runWithRequestContext`) so it is idempotent: a consumer\n   * that already established its own frame keeps it, and a message consumed from inside an existing\n   * request (rare, but possible for an in-process drain) stays part of that request's trace.\n   *\n   * The frame wraps the error branch too — a message that fails still gets an attributable log line.\n   * What this canNOT do is adopt the enqueuing request's `originCorrelationId`: that lives INSIDE the\n   * payload, which only the consumer knows how to parse, so adoption stays each consumer's job\n   * (`adoptCorrelationIdIntoCurrentFrame`) and this frame is the fresh id it starts from.\n   */\n  public async consume(\n    queueName: string,\n    handler: MessageHandler\n  ): Promise<string> {\n    const channel = this.getChannel();\n\n    try {\n      const { consumerTag } = await channel.consume(\n        queueName,\n        async (msg) => {\n          if (!msg) return;\n\n          await runInFreshRequestContextIfAbsent(async () => {\n          try {\n            await handler(msg, channel);\n          } catch (error) {\n            this.logger.error('Consumer handler error', {\n              queueName,\n              ...projectCaughtErrorLogFields(error),\n            });\n            // Nack without requeue on handler error. When the consumed queue has\n            // a dead-letter-exchange wired (operations / scheduled / domain all\n            // do now), the broker parks the message in that queue's `.deadletter`\n            // for inspection; on a queue without a DLX it is discarded.\n            channel.nack(msg, false, false);\n          }\n          });\n        },\n        { noAck: false }\n      );\n\n      this.consumerTags.set(queueName, consumerTag);\n      this.logDebug('Consumer started', { queueName, consumerTag });\n\n      return consumerTag;\n    } catch (error) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CONSUME_FAILED,\n          context: {\n            queueName,\n            error: describeCaughtError(error),\n          },\n        }\n      );\n    }\n  }\n\n  /**\n   * Cancel a consumer.\n   */\n  public async cancelConsumer(queueName: string): Promise<void> {\n    const channel = this.getChannel();\n    const consumerTag = this.consumerTags.get(queueName);\n\n    if (consumerTag) {\n      await channel.cancel(consumerTag);\n      this.consumerTags.delete(queueName);\n      this.logDebug('Consumer cancelled', { queueName, consumerTag });\n    }\n  }\n\n  /**\n   * Set up reply queue for RPC pattern (per pod).\n   */\n\n  /**\n   * The runtime segment embedded in this process's reply-queue name.\n   *\n   * `undefined` for the application backend, deliberately: it keeps the\n   * historical `wildo.reply.<appId>.<podId>` layout, so an existing deployment's\n   * queue names do not move and its broker permission keeps matching. A named\n   * runtime contributes `<kind>-<name>`, which is what a per-principal read\n   * regex anchors on.\n   *\n   * Resolved fail-SAFE. An unresolvable principal cannot be a minion (minion\n   * startup binds and initializes it), so falling back to the backend layout\n   * preserves today's behaviour for minimal and test containers rather than\n   * inventing a segment nobody granted.\n   */\n  private resolveReplyPrincipalSegment(): string | undefined {\n    try {\n      const descriptor = this.container\n        .get<{ describe(): { runtimeProfile: string; runtimeKey?: string } }>(SAAS_SERVICE_TYPES.RuntimePrincipalService)\n        .describe();\n      // Derived through the SHARED builder, never locally. The broker permission\n      // this queue name must satisfy is built from the same function, so the two\n      // cannot drift; they previously agreed only because every minion name so\n      // far happened to survive sanitisation unchanged.\n      return buildRuntimePrincipalQueueSegment(\n        runtimePrincipalKindFromRuntimeProfile(descriptor.runtimeProfile),\n        descriptor.runtimeKey,\n      );\n    } catch {\n      return undefined;\n    }\n  }\n\n  public async setupReplyQueue(\n    appId: string,\n    onReply: (correlationId: string, result: JobResult) => void\n  ): Promise<string> {\n    const channel = this.getChannel();\n\n    // The reply queue carries the OWNING RUNTIME in its name (see\n    // `buildReplyQueueName`). Without it a minion's reply queue and the\n    // application backend's differ only by an opaque per-process token, so a\n    // broker permission cannot admit one and refuse the other — which is why\n    // narrowing a minion's `read` refused its own replies and crash-looped it.\n    this.replyQueueName = buildReplyQueueName(appId, this.podId, this.resolveReplyPrincipalSegment());\n\n    // Create exclusive, auto-delete reply queue\n    await channel.assertQueue(this.replyQueueName, {\n      exclusive: true,\n      autoDelete: true,\n      durable: false,\n    });\n\n    // Start consuming replies\n    await channel.consume(\n      this.replyQueueName,\n      (msg) => {\n        if (!msg) return;\n\n        const correlationId = msg.properties.correlationId;\n        try {\n          const result: JobResult = JSON.parse(msg.content.toString());\n          onReply(correlationId, result);\n        } catch (error) {\n          this.logger.error('Failed to parse reply', {\n            correlationId,\n            ...projectCaughtErrorLogFields(error),\n          });\n        }\n\n        channel.ack(msg);\n      },\n      { noAck: false }\n    );\n\n    this.logger.info('Reply queue set up', { replyQueueName: this.replyQueueName });\n\n    return this.replyQueueName;\n  }\n\n  /**\n   * Get the reply queue name for this pod.\n   */\n  public getReplyQueueName(): string | null {\n    return this.replyQueueName;\n  }\n\n  /**\n   * Acknowledge a message.\n   */\n  public ack(msg: ConsumeMessage): void {\n    const channel = this.getChannel();\n    channel.ack(msg);\n  }\n\n  /**\n   * Reject a message.\n   */\n  public nack(msg: ConsumeMessage, requeue: boolean = false): void {\n    const channel = this.getChannel();\n    channel.nack(msg, false, requeue);\n  }\n\n  /**\n   * Close the connection gracefully.\n   */\n  public async close(): Promise<void> {\n    // Cancel all consumers\n    for (const [queueName, consumerTag] of this.consumerTags) {\n      try {\n        await this.channel?.cancel(consumerTag);\n        this.logger.debug('Consumer cancelled', { queueName, consumerTag });\n      } catch (error) {\n        this.logger.warn('Failed to cancel consumer', { queueName, error });\n      }\n    }\n    this.consumerTags.clear();\n\n    // Close the topology-declaration channel (best-effort; independent of the\n    // primary channel).\n    if (this.topologyChannel) {\n      try {\n        await this.topologyChannel.close();\n        this.logger.debug('Topology channel closed');\n      } catch (error) {\n        this.logger.warn('Failed to close topology channel', { error });\n      }\n      this.topologyChannel = null;\n    }\n\n    // Close channel\n    if (this.channel) {\n      try {\n        await this.channel.close();\n        this.logger.debug('Channel closed');\n      } catch (error) {\n        this.logger.warn('Failed to close channel', { error });\n      }\n      this.channel = null;\n    }\n\n    // Close connection\n    if (this.connection) {\n      try {\n        await this.connection.close();\n        this.logger.info('RabbitMQ connection closed');\n      } catch (error) {\n        this.logger.warn('Failed to close connection', { error });\n      }\n      this.connection = null;\n    }\n  }\n\n  /**\n   * Get pod ID for this instance.\n   */\n  public getPodId(): string {\n    return this.podId;\n  }\n}\n"]}
+{"version":3,"file":"rabbitmq-adapter.backend.service.js","sourceRoot":"","sources":["../../../../../src/queue/adapters/rabbitmq-adapter.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RabbitMQ Adapter for Queue System\n *\n * Provides connection management, publishing, and consuming capabilities.\n * Uses amqplib for RabbitMQ communication.\n */\n\nimport { buildRuntimePrincipalQueueSegment, runtimePrincipalKindFromRuntimeProfile } from '@wildo-ai/platform-config-lib';\nimport { injectable, inject, Container } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { AppConfigurationService } from '~wildo-backend-lib/config/services/app-configuration.backend.service';\nimport { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport { describeCaughtError, projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { runInFreshRequestContextIfAbsent } from '~wildo-backend-lib/runtime/models/request-context.als.backend';\nimport {\n  ErrorType,\n  ErrorCustomMessageReference,\n  JobPayload,\n  JobResult,\n  RabbitMQQueueArgKeys,\n  buildQueueName,\n  buildReplyQueueName,\n  buildDelayQueueName,\n  buildRabbitMQConnectionUrl,\n} from '@wildo-ai/saas-models';\n\n// Import amqplib types\n// Note: We use 'any' for Connection because amqplib types are complex and vary between versions\nimport type { Channel, ConsumeMessage, Options } from 'amqplib';\nimport type {\n  MessageHandler,\n  QueueAdapter,\n  QueueConsumeMessage,\n} from '~wildo-backend-lib/queue/adapters/queue-adapter.backend.interface';\nimport type {\n  PublishOptions,\n  QueueAssertOptions,\n} from '~wildo-backend-lib/queue/adapters/queue-adapter.backend.options';\n\n// Connection type from amqplib - using any for compatibility with different type versions\ntype AmqpConnection = any;\n\n/**\n * RabbitMQ configuration for connection.\n */\nexport interface RabbitMQConfig {\n  host: string;\n  port: number;\n  username: string;\n  password: string;\n  vhost?: string;\n  heartbeat?: number;\n  connectionTimeout?: number;\n  channelMax?: number;\n}\n\n/**\n * The RabbitMQ realisation of {@link QueueAdapter} (#502).\n *\n * Everything a background-work consumer needs is declared on the port; what remains here and NOT on\n * it is genuinely broker-specific — `configure()` takes a `RabbitMQConfig`, and `getChannel()` /\n * `getTopologyChannel()` hand out an amqplib `Channel` that only a broker can produce. A caller that\n * needs one of those names this class, which is an honest dependency rather than a port with a hole\n * in it.\n */\n@injectable()\nexport class RabbitMQAdapterBackendService implements QueueAdapter {\n  protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n  private connection: AmqpConnection | null = null;\n  private channel: Channel | null = null;\n  /**\n   * Dedicated channel used ONLY for topology declarations (`assertQueue`).\n   *\n   * Queue declarations can fail with `406 PRECONDITION_FAILED` when an\n   * already-existing durable queue is redeclared with different immutable\n   * arguments (e.g. a pre-DLX `operations` queue redeclared with an\n   * `x-dead-letter-exchange`). RabbitMQ responds to a 406 by **closing the\n   * channel it arrived on**. If declarations ran on the primary\n   * publish/consume channel, one incompatible legacy queue would tear down the\n   * whole channel — the adapter would report itself disconnected, every\n   * subsequent (compatible) declaration would be skipped, and the app would\n   * crash-loop during bring-up.\n   *\n   * Isolating declarations on their own channel means a 406 kills only THIS\n   * channel; the primary channel stays alive, and the topology channel is\n   * lazily recreated on the next declaration. See {@link getTopologyChannel}.\n   */\n  private topologyChannel: Channel | null = null;\n  private readonly config: RabbitMQConfig | null = null;\n  private isConfigured = false;\n  private consumerTags: Map<string, string> = new Map();\n  /**\n   * Names of retry/delay queues already asserted on the current channel.\n   * `scheduleDelayedRetry` declares a delay queue per distinct delay value; this\n   * cache skips the redundant round-trip on subsequent retries. Cleared when the\n   * channel closes so a fresh channel re-asserts (queues are durable, but a reset\n   * vhost / broker would otherwise be assumed present).\n   */\n  private assertedDelayQueues: Set<string> = new Set();\n  private replyQueueName: string | null = null;\n  private readonly podId: string;\n  /**\n   * Opt-in gate for automatic topology remediation of a `406\n   * PRECONDITION_FAILED` on `assertQueue`. When enabled AND the mismatched\n   * queue is **empty**, the adapter deletes the legacy queue and re-declares it\n   * with the desired arguments instead of throwing. Read once from\n   * `WILDO_QUEUE_TOPOLOGY_AUTO_REMEDIATE=true`.\n   *\n   * Fail-closed by default (`false`): auto-deleting a queue is a data-loss\n   * footgun outside greenfield/dev, so the framework refuses to do it unless an\n   * operator explicitly opts in. Even when enabled, a queue that still holds\n   * messages is NEVER auto-deleted — the assertion re-throws so a human\n   * decides. See {@link remediateMismatchedQueue}.\n   */\n  private readonly topologyAutoRemediateEnabled: boolean;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger)\n    private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.AppConfigService)\n    private readonly appConfigService: AppConfigurationService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService)\n    private readonly errorBuilder: ErrorBuilderBackendService,\n    // Appended LAST — this constructor is resolved positionally by several\n    // containers, and inserting mid-list silently shifts every later dependency.\n    @inject(SAAS_SERVICE_TYPES.Container) private readonly container: Container,\n  ) {\n    this.logDebug = this.logger.debugByType('RabbitMQAdapterBackendService');\n    this.logger.setDebugTypeLogging('RabbitMQAdapterBackendService', false);\n    // Get pod ID from environment or generate one\n    this.podId = process.env.K8S_POD_NAME ||\n                 process.env.HOSTNAME ||\n                 `local-${Math.random().toString(36).substring(2, 10)}`;\n    this.topologyAutoRemediateEnabled =\n      process.env.WILDO_QUEUE_TOPOLOGY_AUTO_REMEDIATE === 'true';\n  }\n\n  /**\n   * Configure the RabbitMQ adapter with connection settings.\n   * Must be called before connect().\n   */\n  public configure(config: RabbitMQConfig): void {\n    (this as any).config = config;\n    this.isConfigured = true;\n    this.logger.info('RabbitMQ adapter configured', { host: config.host, port: config.port });\n  }\n\n  /**\n   * Connect to RabbitMQ server.\n   */\n  public async connect(): Promise<void> {\n    if (!this.isConfigured || !this.config) {\n      throw this.errorBuilder.buildError(\n        ErrorType.CONFIGURATION,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_INITIALIZATION_FAILED,\n          context: { message: 'RabbitMQ adapter not configured. Call configure() first.' },\n        }\n      );\n    }\n\n    try {\n      // Dynamic import amqplib\n      const amqp = await import('amqplib');\n\n      const connectionUrl = buildRabbitMQConnectionUrl({\n        host: this.config.host,\n        port: this.config.port,\n        username: this.config.username,\n        password: this.config.password,\n        vhost: this.config.vhost,\n      });\n\n      this.connection = await amqp.connect(connectionUrl, {\n        heartbeat: this.config.heartbeat ?? 60,\n        timeout: this.config.connectionTimeout ?? 30000,\n      });\n\n      // Handle connection events\n      this.connection.on('error', (err) => {\n        this.logger.error('RabbitMQ connection error', { error: err.message });\n      });\n\n      this.connection.on('close', () => {\n        this.logger.warn('RabbitMQ connection closed');\n        this.connection = null;\n        this.channel = null;\n        // The topology channel dies with the connection too.\n        this.topologyChannel = null;\n      });\n\n      // Create the primary publish/consume channel.\n      this.channel = await this.connection.createChannel();\n\n      // Handle channel events (prevent unhandled errors during RabbitMQ restarts)\n      this.channel.on('error', (err) => {\n        this.logger.error('RabbitMQ channel error', { error: err.message });\n      });\n\n      this.channel.on('close', () => {\n        this.logger.warn('RabbitMQ channel closed');\n        this.channel = null;\n        // Force re-assertion of delay queues on the next channel.\n        this.assertedDelayQueues.clear();\n      });\n\n      // Set prefetch for fair dispatch\n      await this.channel.prefetch(1);\n\n      // Eagerly create the dedicated topology-declaration channel so the first\n      // `assertQueue` does not pay a channel round-trip. Its lifecycle is\n      // independent of the primary channel: a `406 PRECONDITION_FAILED` closes\n      // only this channel, never the primary publish/consume path.\n      this.topologyChannel = await this.createTopologyChannel(this.connection);\n\n      this.logger.info('Connected to RabbitMQ', { host: this.config.host });\n    } catch (error) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CONNECTION_FAILED,\n          context: {\n            host: this.config.host,\n            error: describeCaughtError(error),\n          },\n        }\n      );\n    }\n  }\n\n  /**\n   * Check if connected to RabbitMQ.\n   */\n  public isConnected(): boolean {\n    return this.connection !== null && this.channel !== null;\n  }\n\n  /**\n   * Get the channel for direct operations.\n   */\n  public getChannel(): Channel {\n    if (!this.channel) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CHANNEL_CLOSED,\n          context: { message: 'RabbitMQ channel not available' },\n        }\n      );\n    }\n    return this.channel;\n  }\n\n  /**\n   * Create a dedicated topology-declaration channel with isolated error\n   * handling. A `406 PRECONDITION_FAILED` on a declaration closes only this\n   * channel; the close handler nulls the reference so it is lazily recreated on\n   * the next declaration. Never carries consumers or publishes.\n   */\n  private async createTopologyChannel(connection: AmqpConnection): Promise<Channel> {\n    const channel: Channel = await connection.createChannel();\n\n    channel.on('error', (err: Error) => {\n      // Expected on a 406 arg-mismatch declaration. Log, but do NOT treat as a\n      // connection failure — the primary channel is unaffected.\n      this.logger.error('RabbitMQ topology channel error', { error: err.message });\n    });\n\n    channel.on('close', () => {\n      this.topologyChannel = null;\n      // A delay queue asserted on a now-closed channel must be re-asserted.\n      this.assertedDelayQueues.clear();\n    });\n\n    return channel;\n  }\n\n  /**\n   * Get the dedicated topology-declaration channel, recreating it if a prior\n   * `406` (or a broker restart) closed it. Public so callers that must declare\n   * with raw arguments not modelled by {@link QueueAssertOptions} (e.g. a\n   * quorum-queue `x-queue-type`) still benefit from primary-channel isolation.\n   */\n  public async getTopologyChannel(): Promise<Channel> {\n    if (this.topologyChannel) {\n      return this.topologyChannel;\n    }\n    if (!this.connection) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CHANNEL_CLOSED,\n          context: { message: 'RabbitMQ connection not available for topology channel' },\n        }\n      );\n    }\n    this.topologyChannel = await this.createTopologyChannel(this.connection);\n    return this.topologyChannel;\n  }\n\n  /**\n   * Translate {@link QueueAssertOptions} into amqplib's `Options.AssertQueue`.\n   *\n   * `deadLetterExchange === ''` is meaningful: it selects the DEFAULT exchange,\n   * which routes a dead-lettered message by `x-dead-letter-routing-key` (a queue\n   * name) — this is exactly how the durable retry/delay queues loop a held\n   * message back to its source queue. Only skip when the caller passed nothing\n   * (`undefined`), i.e. does not want dead-lettering at all.\n   */\n  private buildAssertQueueOptions(options: QueueAssertOptions): Options.AssertQueue {\n    const queueOptions: Options.AssertQueue = {\n      durable: options.durable ?? true,\n      exclusive: options.exclusive ?? false,\n      autoDelete: options.autoDelete ?? false,\n      arguments: {} as Record<string, unknown>,\n    };\n\n    if (options.deadLetterExchange !== undefined) {\n      (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.DEAD_LETTER_EXCHANGE] =\n        options.deadLetterExchange;\n      if (options.deadLetterRoutingKey) {\n        (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.DEAD_LETTER_ROUTING_KEY] =\n          options.deadLetterRoutingKey;\n      }\n    }\n    if (options.messageTtl) {\n      (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.MESSAGE_TTL] = options.messageTtl;\n    }\n    if (options.maxLength) {\n      (queueOptions.arguments as Record<string, unknown>)[RabbitMQQueueArgKeys.MAX_LENGTH] = options.maxLength;\n    }\n\n    return queueOptions;\n  }\n\n  /**\n   * Assert a queue exists (create if not).\n   *\n   * Declared on the dedicated {@link topologyChannel} so an arg-mismatch `406`\n   * cannot tear down the primary publish/consume channel. When the mismatch is\n   * unrecoverable in place (a pre-existing queue with different immutable args)\n   * and {@link topologyAutoRemediateEnabled} is set, an EMPTY legacy queue is\n   * deleted and re-declared with the desired args; otherwise the `406`\n   * propagates with a descriptive, operator-actionable error.\n   */\n  public async assertQueue(\n    queueName: string,\n    options: QueueAssertOptions = {}\n  ): Promise<void> {\n    const queueOptions = this.buildAssertQueueOptions(options);\n\n    try {\n      const channel = await this.getTopologyChannel();\n      await channel.assertQueue(queueName, queueOptions);\n    } catch (error) {\n      if (!this.isPreconditionFailed(error)) {\n        throw error;\n      }\n      if (!this.topologyAutoRemediateEnabled) {\n        throw this.errorBuilder.buildError(\n          ErrorType.INFRASTRUCTURE,\n          undefined,\n          {\n            customMessageReference: ErrorCustomMessageReference.QUEUE_INITIALIZATION_FAILED,\n            context: {\n              queueName,\n              message:\n                `Queue '${queueName}' already exists with incompatible arguments ` +\n                `(406 PRECONDITION_FAILED). RabbitMQ cannot mutate a live queue's args. ` +\n                `Delete the stale queue once so it re-declares with the new args, or set ` +\n                `WILDO_QUEUE_TOPOLOGY_AUTO_REMEDIATE=true to auto-delete it when empty.`,\n              error: describeCaughtError(error),\n            },\n          }\n        );\n      }\n      await this.remediateMismatchedQueue(queueName, queueOptions);\n    }\n\n    this.logger.debug('Queue asserted', { queueName, options });\n  }\n\n  /**\n   * Whether an amqplib channel error is a `406 PRECONDITION_FAILED` (immutable\n   * queue-argument mismatch on a redeclaration).\n   */\n  private isPreconditionFailed(error: unknown): boolean {\n    const e = error as { code?: number; message?: unknown } | null;\n    return (\n      e?.code === 406 ||\n      (typeof e?.message === 'string' && e.message.includes('PRECONDITION_FAILED'))\n    );\n  }\n\n  /**\n   * Remediate a `406` arg-mismatch by deleting the legacy queue and\n   * re-declaring it with the desired arguments — but ONLY when the queue is\n   * empty. A non-empty queue is never auto-deleted; the assertion re-throws so a\n   * human decides (data loss must be an explicit human action, never a\n   * bring-up side effect). Runs on a fresh topology channel (the prior one was\n   * closed by the 406).\n   */\n  private async remediateMismatchedQueue(\n    queueName: string,\n    queueOptions: Options.AssertQueue\n  ): Promise<void> {\n    // The 406 already killed the topology channel broker-side; its `close`\n    // event nulls the cached reference, but that arrives on a later microtask,\n    // so the cache may still point at the dead channel here. Discard it\n    // explicitly and force a fresh one — `checkQueue`/`deleteQueue` on a closed\n    // channel would otherwise reject.\n    this.topologyChannel = null;\n    const channel = await this.getTopologyChannel();\n\n    const { messageCount } = await channel.checkQueue(queueName);\n    if (messageCount > 0) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_INITIALIZATION_FAILED,\n          context: {\n            queueName,\n            messageCount,\n            message:\n              `Refusing to auto-remediate queue '${queueName}': it holds ${messageCount} ` +\n              `message(s). Drain or manually delete it before it can re-declare with the ` +\n              `new arguments.`,\n          },\n        }\n      );\n    }\n\n    await channel.deleteQueue(queueName);\n    await channel.assertQueue(queueName, queueOptions);\n    this.logger.warn('Topology auto-remediation: deleted empty mismatched queue and re-declared', {\n      queueName,\n    });\n  }\n\n  /**\n   * Publish a job payload to a queue.\n   */\n  public async publish(\n    queueName: string,\n    payload: JobPayload,\n    options: PublishOptions = {}\n  ): Promise<void> {\n    const channel = this.getChannel();\n\n    try {\n      const content = Buffer.from(JSON.stringify(payload));\n\n      const publishOptions: Options.Publish = {\n        persistent: options.persistent ?? true,\n        correlationId: options.correlationId,\n        replyTo: options.replyTo,\n        priority: options.priority,\n      };\n\n      if (options.expiration) {\n        publishOptions.expiration = options.expiration;\n      }\n\n      channel.sendToQueue(queueName, content, publishOptions);\n\n      this.logger.debug('Message published', {\n        queueName,\n        jobId: payload.jobId,\n        // NOT `correlationId`. This is the AMQP RPC REPLY-MATCHING id (`Options.Publish.correlationId`),\n        // a different id from the request's Wildo `correlationId` that the logger's request-context\n        // mixin already stamps on every line. Logging it under the name `correlationId` merged OVER the\n        // mixin and SHADOWED the request's trace id — and on the fire-and-forget path, where this is\n        // `undefined`, it replaced a real id with `\"[undefined]\"`, making the publish line unattributable.\n        // Same distinction the job schema draws by naming its field `rpcReplyCorrelationId`.\n        ...(options.correlationId ? { rpcReplyCorrelationId: options.correlationId } : {}),\n      });\n    } catch (error) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_PUBLISH_FAILED,\n          context: {\n            queueName,\n            jobId: payload.jobId,\n            error: describeCaughtError(error),\n          },\n        }\n      );\n    }\n  }\n\n  /**\n   * Schedule a durable, broker-timed retry of a failed job.\n   *\n   * Replaces the old in-process `setTimeout` backoff (which lost the retry if the\n   * worker crashed during the wait, since the original message was already ACKed).\n   * The job is published to a dedicated **delay queue** that holds it for\n   * `delayMs` via RabbitMQ's per-queue `x-message-ttl`, then dead-letters it back\n   * to `sourceQueueName` (through the default exchange, routed by queue name) for\n   * re-delivery. The delay queue has NO consumer — the broker owns the wait, so a\n   * held retry survives a worker (or broker) restart because both the queue and\n   * the message are durable/persistent.\n   *\n   * One delay queue is declared per distinct `delayMs`, so every message in a\n   * given delay queue shares the same TTL — avoiding RabbitMQ's per-message-TTL\n   * head-of-line blocking (a short-delay message never waits behind a longer one).\n   *\n   * Contract: the caller MUST have incremented `retryCount` on `job` before\n   * calling, and MUST ACK the original message afterward — the retry is now\n   * durably owned by the broker.\n   *\n   * @param sourceQueueName - Queue the message returns to when the delay elapses\n   * @param job - The (retry-incremented) job payload to redeliver\n   * @param delayMs - How long the broker holds the message before redelivery\n   * @param options - Publish options to preserve across the hop (RPC replyTo/correlationId)\n   */\n  public async scheduleDelayedRetry(\n    sourceQueueName: string,\n    job: JobPayload,\n    delayMs: number,\n    options: PublishOptions = {}\n  ): Promise<void> {\n    const delayQueueName = buildDelayQueueName(sourceQueueName, delayMs);\n\n    // Lazily declare the delay queue (idempotent; cached to skip the round-trip).\n    if (!this.assertedDelayQueues.has(delayQueueName)) {\n      await this.assertQueue(delayQueueName, {\n        durable: true,\n        messageTtl: delayMs,\n        deadLetterExchange: '', // default exchange → routes by routing key (queue name)\n        deadLetterRoutingKey: sourceQueueName,\n      });\n      this.assertedDelayQueues.add(delayQueueName);\n    }\n\n    // Publish persistent so the held retry survives a broker restart.\n    await this.publish(delayQueueName, job, options);\n\n    this.logDebug('Retry scheduled via delay queue', {\n      jobId: job.jobId,\n      delayQueueName,\n      delayMs,\n      retryCount: job.retryCount,\n    });\n  }\n\n  /**\n   * Publish a job result to a reply queue.\n   */\n  public async publishResult(\n    replyTo: string,\n    correlationId: string,\n    result: JobResult\n  ): Promise<void> {\n    const channel = this.getChannel();\n\n    try {\n      const content = Buffer.from(JSON.stringify(result));\n\n      channel.sendToQueue(replyTo, content, {\n        correlationId,\n        persistent: false, // Reply messages don't need persistence\n      });\n\n      this.logger.debug('Result published', {\n        replyTo,\n        // See the note in `publish` — this is the RPC reply-matching id, not the request's trace id.\n        rpcReplyCorrelationId: correlationId,\n        jobId: result.jobId,\n        status: result.status,\n      });\n    } catch (error) {\n      this.logger.error('Failed to publish result', {\n        replyTo,\n        // See the note in `publish`. This one is at ERROR level, where shadowing the request's trace id\n        // is worst: the line an operator reaches for first would name an unrelated RPC id instead.\n        rpcReplyCorrelationId: correlationId,\n        ...projectCaughtErrorLogFields(error),\n      });\n    }\n  }\n\n  /**\n   * Set up a consumer for a queue.\n   *\n   * **Every consumed message runs inside a request-context frame, established HERE.** A consumed\n   * message is an independent unit of work with no ambient context of its own, so without a frame its\n   * log lines carry no `correlationId`, `buildError` has no id to fall back on, and any audit row it\n   * writes lands unattributed. Framing at the ADAPTER rather than in each consumer is deliberate: this\n   * method is the single door every AMQP consumer passes through — the job consumer, the domain-queue\n   * consumer, the scheduled/cron lane, and the minion tick lane (which injects this same service from\n   * `saas-minions-lib`) — so a future consumer cannot forget it. Hand-applying the wrapper per consumer\n   * is precisely the \"invariant applied at N-1 of N call sites\" shape that has already produced repeat\n   * findings in this codebase (`.claude/rules/invariant-call-site-enumeration.md`).\n   *\n   * `runInFreshRequestContextIfAbsent` (not `runWithRequestContext`) so it is idempotent: a consumer\n   * that already established its own frame keeps it, and a message consumed from inside an existing\n   * request (rare, but possible for an in-process drain) stays part of that request's trace.\n   *\n   * The frame wraps the error branch too — a message that fails still gets an attributable log line.\n   * What this canNOT do is adopt the enqueuing request's `originCorrelationId`: that lives INSIDE the\n   * payload, which only the consumer knows how to parse, so adoption stays each consumer's job\n   * (`adoptCorrelationIdIntoCurrentFrame`) and this frame is the fresh id it starts from.\n   */\n  public async consume(\n    queueName: string,\n    handler: MessageHandler\n  ): Promise<string> {\n    const channel = this.getChannel();\n\n    try {\n      const { consumerTag } = await channel.consume(\n        queueName,\n        async (msg) => {\n          if (!msg) return;\n\n          await runInFreshRequestContextIfAbsent(async () => {\n          try {\n            await handler(msg, channel);\n          } catch (error) {\n            this.logger.error('Consumer handler error', {\n              queueName,\n              ...projectCaughtErrorLogFields(error),\n            });\n            // Nack without requeue on handler error. When the consumed queue has\n            // a dead-letter-exchange wired (operations / scheduled / domain all\n            // do now), the broker parks the message in that queue's `.deadletter`\n            // for inspection; on a queue without a DLX it is discarded.\n            channel.nack(msg, false, false);\n          }\n          });\n        },\n        { noAck: false }\n      );\n\n      this.consumerTags.set(queueName, consumerTag);\n      this.logDebug('Consumer started', { queueName, consumerTag });\n\n      return consumerTag;\n    } catch (error) {\n      throw this.errorBuilder.buildError(\n        ErrorType.INFRASTRUCTURE,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.QUEUE_CONSUME_FAILED,\n          context: {\n            queueName,\n            error: describeCaughtError(error),\n          },\n        }\n      );\n    }\n  }\n\n  /**\n   * Cancel a consumer.\n   */\n  public async cancelConsumer(queueName: string): Promise<void> {\n    const channel = this.getChannel();\n    const consumerTag = this.consumerTags.get(queueName);\n\n    if (consumerTag) {\n      await channel.cancel(consumerTag);\n      this.consumerTags.delete(queueName);\n      this.logDebug('Consumer cancelled', { queueName, consumerTag });\n    }\n  }\n\n  /**\n   * Set up reply queue for RPC pattern (per pod).\n   */\n\n  /**\n   * The runtime segment embedded in this process's reply-queue name.\n   *\n   * `undefined` for the application backend, deliberately: it keeps the\n   * historical `wildo.reply.<appId>.<podId>` layout, so an existing deployment's\n   * queue names do not move and its broker permission keeps matching. A named\n   * runtime contributes `<kind>-<name>`, which is what a per-principal read\n   * regex anchors on.\n   *\n   * Resolved fail-SAFE. An unresolvable principal cannot be a minion (minion\n   * startup binds and initializes it), so falling back to the backend layout\n   * preserves today's behaviour for minimal and test containers rather than\n   * inventing a segment nobody granted.\n   */\n  private resolveReplyPrincipalSegment(): string | undefined {\n    try {\n      const descriptor = this.container\n        .get<{ describe(): { runtimeProfile: string; runtimeKey?: string } }>(SAAS_SERVICE_TYPES.RuntimePrincipalService)\n        .describe();\n      // Derived through the SHARED builder, never locally. The broker permission\n      // this queue name must satisfy is built from the same function, so the two\n      // cannot drift; they previously agreed only because every minion name so\n      // far happened to survive sanitisation unchanged.\n      return buildRuntimePrincipalQueueSegment(\n        runtimePrincipalKindFromRuntimeProfile(descriptor.runtimeProfile),\n        descriptor.runtimeKey,\n      );\n    } catch {\n      return undefined;\n    }\n  }\n\n  public async setupReplyQueue(\n    appId: string,\n    onReply: (correlationId: string, result: JobResult) => void\n  ): Promise<string> {\n    const channel = this.getChannel();\n\n    // The reply queue carries the OWNING RUNTIME in its name (see\n    // `buildReplyQueueName`). Without it a minion's reply queue and the\n    // application backend's differ only by an opaque per-process token, so a\n    // broker permission cannot admit one and refuse the other — which is why\n    // narrowing a minion's `read` refused its own replies and crash-looped it.\n    this.replyQueueName = buildReplyQueueName(appId, this.podId, this.resolveReplyPrincipalSegment());\n\n    // Create exclusive, auto-delete reply queue\n    await channel.assertQueue(this.replyQueueName, {\n      exclusive: true,\n      autoDelete: true,\n      durable: false,\n    });\n\n    // Start consuming replies\n    await channel.consume(\n      this.replyQueueName,\n      (msg) => {\n        if (!msg) return;\n\n        const correlationId = msg.properties.correlationId;\n        try {\n          const result: JobResult = JSON.parse(msg.content.toString());\n          onReply(correlationId, result);\n        } catch (error) {\n          this.logger.error('Failed to parse reply', {\n            correlationId,\n            ...projectCaughtErrorLogFields(error),\n          });\n        }\n\n        channel.ack(msg);\n      },\n      { noAck: false }\n    );\n\n    this.logger.info('Reply queue set up', { replyQueueName: this.replyQueueName });\n\n    return this.replyQueueName;\n  }\n\n  /**\n   * Get the reply queue name for this pod.\n   */\n  public getReplyQueueName(): string | null {\n    return this.replyQueueName;\n  }\n\n  /**\n   * Acknowledge a message.\n   */\n  public ack(msg: ConsumeMessage): void {\n    const channel = this.getChannel();\n    channel.ack(msg);\n  }\n\n  /**\n   * Reject a message.\n   */\n  public nack(msg: ConsumeMessage, requeue: boolean = false): void {\n    const channel = this.getChannel();\n    channel.nack(msg, false, requeue);\n  }\n\n  /**\n   * Close the connection gracefully.\n   */\n  public async close(): Promise<void> {\n    // Cancel all consumers\n    for (const [queueName, consumerTag] of this.consumerTags) {\n      try {\n        await this.channel?.cancel(consumerTag);\n        this.logger.debug('Consumer cancelled', { queueName, consumerTag });\n      } catch (error) {\n        this.logger.warn('Failed to cancel consumer', { queueName, error });\n      }\n    }\n    this.consumerTags.clear();\n\n    // Close the topology-declaration channel (best-effort; independent of the\n    // primary channel).\n    if (this.topologyChannel) {\n      try {\n        await this.topologyChannel.close();\n        this.logger.debug('Topology channel closed');\n      } catch (error) {\n        this.logger.warn('Failed to close topology channel', { error });\n      }\n      this.topologyChannel = null;\n    }\n\n    // Close channel\n    if (this.channel) {\n      try {\n        await this.channel.close();\n        this.logger.debug('Channel closed');\n      } catch (error) {\n        this.logger.warn('Failed to close channel', { error });\n      }\n      this.channel = null;\n    }\n\n    // Close connection\n    if (this.connection) {\n      try {\n        await this.connection.close();\n        this.logger.info('RabbitMQ connection closed');\n      } catch (error) {\n        this.logger.warn('Failed to close connection', { error });\n      }\n      this.connection = null;\n    }\n  }\n\n  /**\n   * Get pod ID for this instance.\n   */\n  /**\n   * Queue depth from the broker, or `null` when no channel is open (#502).\n   *\n   * This replaces monitoring reaching for `getChannel()` and calling `checkQueue` itself. The\n   * behaviour is unchanged — `null` here produces the same empty metrics that a null channel already\n   * produced — but the question is now one every adapter can answer about itself, instead of a\n   * connection handle only this one can hand out.\n   */\n  public async getQueueDepth(queueName: string): Promise<number | null> {\n    const channel = this.getChannel();\n    if (!channel) {\n      return null;\n    }\n    // `checkQueue` CLOSES the channel when the queue does not exist — the reason monitoring stopped\n    // probing dead-letter queues (see `getQueueMetrics`). Reported as \"not observable\" rather than\n    // thrown: a queue that has not been asserted yet is not a fault in the runtime being monitored.\n    try {\n      const queueInfo = await channel.checkQueue(queueName);\n      return queueInfo.messageCount;\n    } catch {\n      return null;\n    }\n  }\n\n  public getPodId(): string {\n    return this.podId;\n  }\n}\n"]}