@onlineapps/conn-orch-registry 6.0.2 → 7.0.0

package/API.md

@@ -0,0 +1,831 @@
+## Modules
+
+<dl>
+<dt><a href="#module_@onlineapps/conn-orch-registry/src/events">@onlineapps/conn-orch-registry/src/events</a></dt>
+<dd><p>events.js</p>
+<p>List of events used in the conn-orch-registry module.
+Acts as a central place for constants to avoid typos
+when emitting and listening for events.</p>
+<p>Legacy <code>apiDescriptionRequest</code> / <code>apiDescriptionSent</code> events were removed —
+the full service specification travels as part of the <code>register</code> message.</p>
+</dd>
+<dt><a href="#module_@onlineapps/conn-orch-registry">@onlineapps/conn-orch-registry</a></dt>
+<dd><p>Service registry connector for dynamic service discovery, health monitoring,
+and OpenAPI specification management in OA Drive microservices architecture.</p>
+</dd>
+<dt><a href="#module_@onlineapps/conn-orch-registry/src/queueManager">@onlineapps/conn-orch-registry/src/queueManager</a></dt>
+<dd><p>queueManager.js</p>
+<p>The one MQ connection of the registry connector, and the only surface through
+which this package talks to the broker.</p>
+<p>Overview:</p>
+<ul>
+<li>Owns a single <code>@onlineapps/mq-client-core</code> client: connect, declare,
+publish, consume, close.</li>
+<li>Queues managed by the microservice: <code>&lt;serviceName&gt;.registry</code> and
+<code>&lt;serviceName&gt;.registry.events</code>. Their names are business-queue names and
+their DECLARATION (durability, TTL, dead-letter route) belongs to
+<code>queueConfig</code> in the core — never to an options object written here.</li>
+<li>Infrastructure queues (<code>registry.register</code>, …) are CHECKED, never
+asserted: they are created by the infrastructure service that owns them
+(<code>api/docs/standards/queue-ownership.md</code>).</li>
+</ul>
+<p>Why there is no <code>channel</code> on this object any more (d.198b-3): until 2026-09-14
+this class handed out a raw amqplib channel, and both consumers of the package
+settled every delivery on it by hand — <code>channel.ack(msg)</code> / <code>channel.nack(msg, false, false)</code>. That is a second implementation of the delivery contract
+(<code>.claude/rules/change-discipline.md</code> § One rail per concern) and the half that
+cannot count: a hand-written nack knows nothing about the attempt budget, the
+<code>x-oa-delivery-attempts</code> header or the <code>message_dlq</code> event the core publishes.
+<code>consume()</code> below forwards to the core&#39;s, which owns all three.</p>
+<p>Usage:
+  const qm = new QueueManager(amqpUrl, serviceName, logger);
+  await qm.init();
+  await qm.consume(<code>${serviceName}.registry</code>, handler, { requeueOnError: false });</p>
+</dd>
+<dt><a href="#module_@onlineapps/conn-orch-registry/src/registryClient">@onlineapps/conn-orch-registry/src/registryClient</a></dt>
+<dd><p>registryClient.js</p>
+<p>ServiceRegistryClient for communication between a microservice (via Agent)
+and the central registry. Sends the service&#39;s <code>operations</code> map in the
+<code>register</code> message and periodic heartbeat messages. Receives registration
+responses (register.confirmed / register.rejected) and revalidation requests
+from the registry.</p>
+<p>Legacy <code>apiDescription</code> / <code>apiDescriptionRequest</code> round-trips have been
+removed — what the registry validates travels in the <code>register</code> message
+itself, as <code>operations</code> (schema-v3). The <code>spec</code> key that used to carry an
+OpenAPI document beside it left in d.562: nothing ever read it.</p>
+<p>Uses QueueManager to manage AMQP queues. Emits events through EventEmitter.</p>
+<p>Events (see src/events.js):</p>
+<ul>
+<li>&#39;heartbeatSent&#39;</li>
+<li>&#39;revalidate&#39;</li>
+<li>&#39;registerConfirmed&#39;</li>
+<li>&#39;registerRejected&#39;</li>
+<li>&#39;error&#39;</li>
+</ul>
+</dd>
+<dt><a href="#module_@onlineapps/conn-orch-registry/src/registryEventConsumer">@onlineapps/conn-orch-registry/src/registryEventConsumer</a></dt>
+<dd><p>registryEventConsumer.js</p>
+<p>Extension for ServiceRegistryClient to consume registry change events.
+Implements opt-in subscription to registry.changes exchange.
+Maintains local service index and enables lazy loading of specs.</p>
+</dd>
+</dl>
+
+<a name="module_@onlineapps/conn-orch-registry/src/events"></a>
+
+## @onlineapps/conn-orch-registry/src/events
+events.js
+
+List of events used in the conn-orch-registry module.
+Acts as a central place for constants to avoid typos
+when emitting and listening for events.
+
+Legacy `apiDescriptionRequest` / `apiDescriptionSent` events were removed —
+the full service specification travels as part of the `register` message.
+
+**See**: api/docs/biz/30-operations/registration-wire.md §2 MQ wire format  
+
+* [@onlineapps/conn-orch-registry/src/events](#module_@onlineapps/conn-orch-registry/src/events)
+    * [~EVENTS](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)
+        * [.HEARTBEAT_SENT](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.HEARTBEAT_SENT)
+        * [.REGISTER_CONFIRMED](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.REGISTER_CONFIRMED)
+        * [.REGISTER_REJECTED](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.REGISTER_REJECTED)
+        * [.REVALIDATE](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.REVALIDATE)
+        * [.ERROR](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.ERROR)
+
+<a name="module_@onlineapps/conn-orch-registry/src/events..EVENTS"></a>
+
+### @onlineapps/conn-orch-registry/src/events~EVENTS
+Named EventEmitter events for ServiceRegistryClient.
+
+**Kind**: inner constant of [<code>@onlineapps/conn-orch-registry/src/events</code>](#module_@onlineapps/conn-orch-registry/src/events)  
+
+* [~EVENTS](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)
+    * [.HEARTBEAT_SENT](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.HEARTBEAT_SENT)
+    * [.REGISTER_CONFIRMED](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.REGISTER_CONFIRMED)
+    * [.REGISTER_REJECTED](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.REGISTER_REJECTED)
+    * [.REVALIDATE](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.REVALIDATE)
+    * [.ERROR](#module_@onlineapps/conn-orch-registry/src/events..EVENTS.ERROR)
+
+<a name="module_@onlineapps/conn-orch-registry/src/events..EVENTS.HEARTBEAT_SENT"></a>
+
+#### EVENTS.HEARTBEAT\_SENT
+Emitted after a successful heartbeat is sent. Payload: { id, type, serviceName, version, timestamp }
+
+**Kind**: static property of [<code>EVENTS</code>](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)  
+<a name="module_@onlineapps/conn-orch-registry/src/events..EVENTS.REGISTER_CONFIRMED"></a>
+
+#### EVENTS.REGISTER\_CONFIRMED
+Emitted when the registry confirms a successful registration. Payload: { requestId, certificate, ... }
+
+**Kind**: static property of [<code>EVENTS</code>](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)  
+<a name="module_@onlineapps/conn-orch-registry/src/events..EVENTS.REGISTER_REJECTED"></a>
+
+#### EVENTS.REGISTER\_REJECTED
+Emitted when the registry rejects a registration. Payload: { requestId, reason, errors, ... }
+
+**Kind**: static property of [<code>EVENTS</code>](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)  
+<a name="module_@onlineapps/conn-orch-registry/src/events..EVENTS.REVALIDATE"></a>
+
+#### EVENTS.REVALIDATE
+Emitted when the registry asks the service to revalidate (e.g. infra fingerprint change).
+
+**Kind**: static property of [<code>EVENTS</code>](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)  
+<a name="module_@onlineapps/conn-orch-registry/src/events..EVENTS.ERROR"></a>
+
+#### EVENTS.ERROR
+Emitted on internal errors. Payload: Error instance or error description.
+
+**Kind**: static property of [<code>EVENTS</code>](#module_@onlineapps/conn-orch-registry/src/events..EVENTS)  
+<a name="module_@onlineapps/conn-orch-registry"></a>
+
+## @onlineapps/conn-orch-registry
+Service registry connector for dynamic service discovery, health monitoring,
+and OpenAPI specification management in OA Drive microservices architecture.
+
+**Since**: 1.0.0  
+**Author**: OA Drive Team  
+**License**: MIT  
+
+* [@onlineapps/conn-orch-registry](#module_@onlineapps/conn-orch-registry)
+    * [.ServiceRegistryClient](#module_@onlineapps/conn-orch-registry.ServiceRegistryClient) : <code>function</code>
+    * [.RegistryEventConsumer](#module_@onlineapps/conn-orch-registry.RegistryEventConsumer) : <code>function</code>
+    * [.EVENTS](#module_@onlineapps/conn-orch-registry.EVENTS) : <code>Object</code>
+
+<a name="module_@onlineapps/conn-orch-registry.ServiceRegistryClient"></a>
+
+### @onlineapps/conn-orch-registry.ServiceRegistryClient : <code>function</code>
+Class for registering a service and sending heartbeats to the central registry.
+
+**Kind**: static property of [<code>@onlineapps/conn-orch-registry</code>](#module_@onlineapps/conn-orch-registry)  
+<a name="module_@onlineapps/conn-orch-registry.RegistryEventConsumer"></a>
+
+### @onlineapps/conn-orch-registry.RegistryEventConsumer : <code>function</code>
+Class for consuming registry change events (opt-in).
+
+**Kind**: static property of [<code>@onlineapps/conn-orch-registry</code>](#module_@onlineapps/conn-orch-registry)  
+<a name="module_@onlineapps/conn-orch-registry.EVENTS"></a>
+
+### @onlineapps/conn-orch-registry.EVENTS : <code>Object</code>
+Constant containing the list of events emitted by ServiceRegistryClient.
+
+**Kind**: static property of [<code>@onlineapps/conn-orch-registry</code>](#module_@onlineapps/conn-orch-registry)  
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager"></a>
+
+## @onlineapps/conn-orch-registry/src/queueManager
+queueManager.js
+
+The one MQ connection of the registry connector, and the only surface through
+which this package talks to the broker.
+
+Overview:
+  - Owns a single `@onlineapps/mq-client-core` client: connect, declare,
+    publish, consume, close.
+  - Queues managed by the microservice: `<serviceName>.registry` and
+    `<serviceName>.registry.events`. Their names are business-queue names and
+    their DECLARATION (durability, TTL, dead-letter route) belongs to
+    `queueConfig` in the core — never to an options object written here.
+  - Infrastructure queues (`registry.register`, …) are CHECKED, never
+    asserted: they are created by the infrastructure service that owns them
+    (`api/docs/standards/queue-ownership.md`).
+
+Why there is no `channel` on this object any more (d.198b-3): until 2026-09-14
+this class handed out a raw amqplib channel, and both consumers of the package
+settled every delivery on it by hand — `channel.ack(msg)` / `channel.nack(msg,
+false, false)`. That is a second implementation of the delivery contract
+(`.claude/rules/change-discipline.md` § One rail per concern) and the half that
+cannot count: a hand-written nack knows nothing about the attempt budget, the
+`x-oa-delivery-attempts` header or the `message_dlq` event the core publishes.
+`consume()` below forwards to the core's, which owns all three.
+
+Usage:
+  const qm = new QueueManager(amqpUrl, serviceName, logger);
+  await qm.init();
+  await qm.consume(`${serviceName}.registry`, handler, { requeueOnError: false });
+
+**See**: node_modules/@onlineapps/mq-client-core/README.md § `consume()` — the delivery contract  
+
+* [@onlineapps/conn-orch-registry/src/queueManager](#module_@onlineapps/conn-orch-registry/src/queueManager)
+    * [~QueueManager](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)
+        * [new QueueManager(amqpUrl, serviceName, logger)](#new_module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager_new)
+        * [.init()](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+init) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.isConnected()](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+isConnected) ⇒ <code>boolean</code>
+        * [.ensureQueues([queues])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+ensureQueues) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.checkQueue(queue)](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+checkQueue) ⇒ <code>Promise.&lt;Object&gt;</code>
+        * [.assertExchange(exchange, type, [options])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+assertExchange) ⇒ <code>Promise.&lt;Object&gt;</code>
+        * [.bindQueue(queue, exchange, pattern)](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+bindQueue) ⇒ <code>Promise.&lt;Object&gt;</code>
+        * [.publish(queue, message, [options])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+publish) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.consume(queue, handler, [options])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+consume) ⇒ <code>Promise.&lt;string&gt;</code>
+        * [.close()](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+close) ⇒ <code>Promise.&lt;void&gt;</code>
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager"></a>
+
+### @onlineapps/conn-orch-registry/src/queueManager~QueueManager
+Queue manager for the microservice connector.
+
+**Kind**: inner class of [<code>@onlineapps/conn-orch-registry/src/queueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager)  
+
+* [~QueueManager](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)
+    * [new QueueManager(amqpUrl, serviceName, logger)](#new_module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager_new)
+    * [.init()](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+init) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.isConnected()](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+isConnected) ⇒ <code>boolean</code>
+    * [.ensureQueues([queues])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+ensureQueues) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.checkQueue(queue)](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+checkQueue) ⇒ <code>Promise.&lt;Object&gt;</code>
+    * [.assertExchange(exchange, type, [options])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+assertExchange) ⇒ <code>Promise.&lt;Object&gt;</code>
+    * [.bindQueue(queue, exchange, pattern)](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+bindQueue) ⇒ <code>Promise.&lt;Object&gt;</code>
+    * [.publish(queue, message, [options])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+publish) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.consume(queue, handler, [options])](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+consume) ⇒ <code>Promise.&lt;string&gt;</code>
+    * [.close()](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+close) ⇒ <code>Promise.&lt;void&gt;</code>
+
+<a name="new_module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager_new"></a>
+
+#### new QueueManager(amqpUrl, serviceName, logger)
+
+| Param | Type | Description |
+| --- | --- | --- |
+| amqpUrl | <code>string</code> | RabbitMQ server URL (AMQP URI) |
+| serviceName | <code>string</code> | Name of the microservice (e.g. 'invoicing') |
+| logger | <code>Object</code> | Logger with info/warn/error/debug; required, validated here   (docs/governance/confirmations/connector-logger-contract.md 001) |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+init"></a>
+
+#### queueManager.init() ⇒ <code>Promise.&lt;void&gt;</code>
+Opens the connection to RabbitMQ.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+**Throws**:
+
+- <code>Error</code> If connecting fails; the message names the broker without its credential.
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+isConnected"></a>
+
+#### queueManager.isConnected() ⇒ <code>boolean</code>
+Is the broker connection open? The one question `register()` asks before it
+publishes; a closed client is not reusable.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+ensureQueues"></a>
+
+#### queueManager.ensureQueues([queues]) ⇒ <code>Promise.&lt;void&gt;</code>
+Declares the business queues this service owns.
+
+The declaration — durability, TTL, cap, dead-letter route — comes from
+`queueConfig` inside the core and is never written here: a name the central
+config declares carries no caller options, and asserting one with arguments
+of our own is how a queue ends up declared two different ways and the broker
+answers the second declarer `406 PRECONDITION-FAILED`.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+**Throws**:
+
+- <code>Error</code> If a name is an infrastructure queue, or the broker refuses the declaration.
+
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| [queues] | <code>Array.&lt;string&gt;</code> | <code>[]</code> | Business queue names owned by this service |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+checkQueue"></a>
+
+#### queueManager.checkQueue(queue) ⇒ <code>Promise.&lt;Object&gt;</code>
+Confirms an infrastructure queue exists without creating it.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+**Returns**: <code>Promise.&lt;Object&gt;</code> - The broker's `queue.declare-ok`  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| queue | <code>string</code> | Queue name |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+assertExchange"></a>
+
+#### queueManager.assertExchange(exchange, type, [options]) ⇒ <code>Promise.&lt;Object&gt;</code>
+Declares an exchange this package binds to.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| exchange | <code>string</code> | Exchange name |
+| type | <code>string</code> | Exchange type; required, never guessed |
+| [options] | <code>Object</code> | Exchange options |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+bindQueue"></a>
+
+#### queueManager.bindQueue(queue, exchange, pattern) ⇒ <code>Promise.&lt;Object&gt;</code>
+Binds one of this service's queues to an exchange.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| queue | <code>string</code> |  |
+| exchange | <code>string</code> |  |
+| pattern | <code>string</code> | Routing pattern; `''` is legal for a fanout |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+publish"></a>
+
+#### queueManager.publish(queue, message, [options]) ⇒ <code>Promise.&lt;void&gt;</code>
+Publishes one message.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+**Returns**: <code>Promise.&lt;void&gt;</code> - Resolves when published; THROWS on failure — there is no falsy return  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| queue | <code>string</code> | Target queue (or the exchange's name when `options.exchange` is set) |
+| message | <code>Object</code> | Payload; serialized by the core |
+| [options] | <code>Object</code> | `persistent`, `exchange`, `routingKey`, `headers` |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+consume"></a>
+
+#### queueManager.consume(queue, handler, [options]) ⇒ <code>Promise.&lt;string&gt;</code>
+Attaches a consumer on the core's delivery rail.
+
+The handler reports failure by THROWING. Settling is the core's: a handler
+that returns is acked once, a handler that throws is counted against the
+delivery budget and, when the budget is spent, rejected into `<service>.dlq`
+with a `message_dlq` event.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+**Returns**: <code>Promise.&lt;string&gt;</code> - The broker's consumer tag  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| queue | <code>string</code> |  |
+| handler | <code>function</code> |  |
+| [options] | <code>Object</code> | `requeueOnError`, `maxAttempts`, `classify`, `prefetch` |
+
+<a name="module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager+close"></a>
+
+#### queueManager.close() ⇒ <code>Promise.&lt;void&gt;</code>
+Closes the connection.
+
+**Kind**: instance method of [<code>QueueManager</code>](#module_@onlineapps/conn-orch-registry/src/queueManager..QueueManager)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient"></a>
+
+## @onlineapps/conn-orch-registry/src/registryClient
+registryClient.js
+
+ServiceRegistryClient for communication between a microservice (via Agent)
+and the central registry. Sends the service's `operations` map in the
+`register` message and periodic heartbeat messages. Receives registration
+responses (register.confirmed / register.rejected) and revalidation requests
+from the registry.
+
+Legacy `apiDescription` / `apiDescriptionRequest` round-trips have been
+removed — what the registry validates travels in the `register` message
+itself, as `operations` (schema-v3). The `spec` key that used to carry an
+OpenAPI document beside it left in d.562: nothing ever read it.
+
+Uses QueueManager to manage AMQP queues. Emits events through EventEmitter.
+
+Events (see src/events.js):
+ - 'heartbeatSent'
+ - 'revalidate'
+ - 'registerConfirmed'
+ - 'registerRejected'
+ - 'error'
+
+**See**
+
+- api/docs/biz/30-operations/registration-wire.md §2 MQ wire format
+- api/docs/biz/30-operations/schema-v3.md
+
+
+* [@onlineapps/conn-orch-registry/src/registryClient](#module_@onlineapps/conn-orch-registry/src/registryClient)
+    * [~ServiceRegistryClient](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)
+        * [new ServiceRegistryClient(opts)](#new_module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient_new)
+        * [.init()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+init) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.register(serviceInfo)](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+register) ⇒ <code>Promise.&lt;{success: boolean, message: string, serviceName: string, version: string, registrationId: (string\|undefined), validated: boolean, certificate: (Object\|null), errorCode: (string\|null\|undefined)}&gt;</code>
+        * [.deregister()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+deregister) ⇒ <code>Promise.&lt;{requestId: string, serviceName: string, version: string, publishedTo: string, heartbeatStopped: boolean, publishedAt: string}&gt;</code>
+        * [.unregister()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+unregister) ⇒ <code>Promise.&lt;Object&gt;</code>
+        * [.sendHeartbeat()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+sendHeartbeat) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.startHeartbeat(options)](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+startHeartbeat)
+        * [.stopHeartbeat()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+stopHeartbeat)
+        * [.subscribeToChanges()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+subscribeToChanges) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.getService(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+getService) ⇒ <code>Promise.&lt;(ServiceSummary\|null)&gt;</code>
+        * [.close()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+close) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [~RETIRED_SERVICE_INFO_KEYS](#module_@onlineapps/conn-orch-registry/src/registryClient..RETIRED_SERVICE_INFO_KEYS)
+    * [~ACCEPTED_SERVICE_INFO_KEYS](#module_@onlineapps/conn-orch-registry/src/registryClient..ACCEPTED_SERVICE_INFO_KEYS)
+    * [~ServiceSummary](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceSummary) : <code>Object</code>
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient"></a>
+
+### @onlineapps/conn-orch-registry/src/registryClient~ServiceRegistryClient
+**Kind**: inner class of [<code>@onlineapps/conn-orch-registry/src/registryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient)  
+
+* [~ServiceRegistryClient](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)
+    * [new ServiceRegistryClient(opts)](#new_module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient_new)
+    * [.init()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+init) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.register(serviceInfo)](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+register) ⇒ <code>Promise.&lt;{success: boolean, message: string, serviceName: string, version: string, registrationId: (string\|undefined), validated: boolean, certificate: (Object\|null), errorCode: (string\|null\|undefined)}&gt;</code>
+    * [.deregister()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+deregister) ⇒ <code>Promise.&lt;{requestId: string, serviceName: string, version: string, publishedTo: string, heartbeatStopped: boolean, publishedAt: string}&gt;</code>
+    * [.unregister()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+unregister) ⇒ <code>Promise.&lt;Object&gt;</code>
+    * [.sendHeartbeat()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+sendHeartbeat) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.startHeartbeat(options)](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+startHeartbeat)
+    * [.stopHeartbeat()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+stopHeartbeat)
+    * [.subscribeToChanges()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+subscribeToChanges) ⇒ <code>Promise.&lt;void&gt;</code>
+    * [.getService(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+getService) ⇒ <code>Promise.&lt;(ServiceSummary\|null)&gt;</code>
+    * [.close()](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+close) ⇒ <code>Promise.&lt;void&gt;</code>
+
+<a name="new_module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient_new"></a>
+
+#### new ServiceRegistryClient(opts)
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| opts | <code>Object</code> |  |  |
+| opts.amqpUrl | <code>string</code> |  | AMQP URI for connecting to RabbitMQ |
+| opts.serviceName | <code>string</code> |  | Name of the service (e.g., 'invoicing') |
+| opts.version | <code>string</code> |  | Version of the service (e.g., '1.2.0') |
+| opts.specificationEndpoint | <code>string</code> |  | Path the `register` and `heartbeat` messages   carry. REQUIRED: the wire format declares it required   (api/docs/biz/30-operations/registration-wire.md §2.1) and the registry stores what it   is sent, so a default here would write a path nobody configured into `registry:services`. |
+| opts.heartbeatInterval | <code>number</code> |  | Milliseconds between heartbeats. REQUIRED: the   cadence has ONE owner and it is not a library default (owner confirmation   docs/governance/confirmations/biz-health-freshness.md 001 point 3); ServiceWrapper   passes `wrapper.registry.heartbeatInterval`, itself fed from BIZ_HEARTBEAT_INTERVAL_MS. |
+| [opts.apiQueue] | <code>string</code> | <code>&quot;&#x27;api_services_queuer&#x27;&quot;</code> | Queue name for heartbeat and API traffic |
+| [opts.registryQueue] | <code>string</code> | <code>&quot;&#x27;registry.register&#x27;&quot;</code> | Queue name for registry messages |
+| [opts.validationProof] | <code>Object</code> | <code></code> | Validation proof object {hash, data} (injected from outside) |
+| [opts.registrationTimeoutMs] | <code>number</code> |  | How long register() waits for the registry response   before rejecting. Default comes from ./defaults.js (30000 ms); never read from the environment here. |
+| opts.logger | <code>Object</code> |  | Logger with info/warn/error/debug. Required and validated here:   registration, heartbeat and revalidation events are what this client exists to report, and   until 2026-09-05 they went to stdout through bare printing while this parameter was accepted   and never read. Owner confirmation:   docs/governance/confirmations/connector-logger-contract.md 001 + 002. |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+init"></a>
+
+#### serviceRegistryClient.init() ⇒ <code>Promise.&lt;void&gt;</code>
+Initializes the connection, ensures queues exist, and starts consuming the service response queue.
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+register"></a>
+
+#### serviceRegistryClient.register(serviceInfo) ⇒ <code>Promise.&lt;{success: boolean, message: string, serviceName: string, version: string, registrationId: (string\|undefined), validated: boolean, certificate: (Object\|null), errorCode: (string\|null\|undefined)}&gt;</code>
+Registers the service with the registry.
+Registry will validate if the service is properly tested and valid.
+Upon successful validation, the service will be activated and can start heartbeats.
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+**Returns**: <code>Promise.&lt;{success: boolean, message: string, serviceName: string, version: string, registrationId: (string\|undefined), validated: boolean, certificate: (Object\|null), errorCode: (string\|null\|undefined)}&gt;</code> - The registry verdict. `errorCode` is the
+  registry's machine reason for a refusal (`UNDECLARED_SERVICE`,
+  `INVALID_OPERATIONS_SCHEMA`, `VALIDATOR_UNAVAILABLE`, …) — branch on it rather
+  than on `message`, whose wording is not a contract. It is passed through
+  verbatim: `null` on a confirmed registration, `undefined` when the reply
+  carried no code at all.  
+**See**: api/docs/biz/30-operations/registration-wire.md §8  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| serviceInfo | <code>Object</code> | Service registration information. It accepts EXACTLY the keys   below (`ACCEPTED_SERVICE_INFO_KEYS`) — any other key is refused by name, and a retired one   (`RETIRED_SERVICE_INFO_KEYS`) with the reason it went. Nothing is dropped in silence: a key   this call ignored would leave the caller believing it travelled. |
+| [serviceInfo.endpoints] | <code>Array</code> | API endpoints provided by the service; `[]` for v3 services |
+| [serviceInfo.operations] | <code>Object</code> | The complete `operations` map the registry validates |
+| [serviceInfo.metadata] | <code>Object</code> | `{ version, description }` stored beside the spec |
+| [serviceInfo.health] | <code>string</code> | Legacy health path; liveness travels by heartbeat |
+| [serviceInfo.workspaceScoped] | <code>boolean</code> | Emitted only when the service declares it |
+| [serviceInfo.timeout] | <code>number</code> | How long THIS call waits for the registry verdict   (default: the constructor's registrationTimeoutMs). It reaches no message. |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+deregister"></a>
+
+#### serviceRegistryClient.deregister() ⇒ <code>Promise.&lt;{requestId: string, serviceName: string, version: string, publishedTo: string, heartbeatStopped: boolean, publishedAt: string}&gt;</code>
+Deregisters the service from the registry.
+
+The registry sends NO reply to a `deregister`
+(api/docs/biz/30-operations/registration-wire.md §2.3 — `processDeregistration`
+removes the record and publishes `service.deregistered` to monitoring), so
+there is no verdict to report and none is invented. Until d.278c this method
+answered a hardcoded `{ success: true, message: 'Service deregistered
+successfully' }` whatever happened — a claim about the registry made by the
+one party that never heard from it.
+
+What this call knows, and therefore what it returns: the request it published,
+where it published it, and that the heartbeat timer is stopped. A publish that
+fails REJECTS; reaching the return means the broker took the message.
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+unregister"></a>
+
+#### serviceRegistryClient.unregister() ⇒ <code>Promise.&lt;Object&gt;</code>
+Alias for deregister() - used by ServiceWrapper.shutdown()
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+**Returns**: <code>Promise.&lt;Object&gt;</code> - Deregistration result  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+sendHeartbeat"></a>
+
+#### serviceRegistryClient.sendHeartbeat() ⇒ <code>Promise.&lt;void&gt;</code>
+Sends a heartbeat message to the API queue.
+Should be called only after successful registration.
+Emits 'heartbeatSent'.
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+startHeartbeat"></a>
+
+#### serviceRegistryClient.startHeartbeat(options)
+Starts periodic heartbeat messages, and gives up after a budget of
+consecutive failures.
+
+A heartbeat loop with no budget is worse than none: the beats stop reaching
+the registry, the loop logs and reschedules forever, and the service keeps
+running while every consumer of `registry:services` reads it as stale. Until
+2026-09-15 that budget lived in `@onlineapps/service-wrapper`, in a second
+loop around `sendHeartbeat()` — two loops for one cadence
+(`.claude/rules/change-discipline.md` § One rail per concern).
+
+The cadence is NOT an argument here. It has one owner and it is the
+constructor's `heartbeatInterval` (owner confirmation
+docs/governance/confirmations/biz-health-freshness.md 001 point 3); taking it
+again per call would be the second number that confirmation refuses.
+
+Neither option is defaulted. How many missed beats mean death, and what death
+means, are decisions of the caller that owns the process — this client only
+counts and reports (`.claude/rules/architecture-principles.md` §3, §4).
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| options | <code>Object</code> |  |
+| options.maxFailures | <code>number</code> | REQUIRED. Consecutive failed beats the   service may accumulate before it can no longer prove it is alive. A   positive whole number; one success resets the count to zero. |
+| options.onFatal | <code>function</code> | REQUIRED. Called exactly once,   with the §5 error naming the count and the last cause, at the moment the   budget is spent. The loop is already stopped when it is called. |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+stopHeartbeat"></a>
+
+#### serviceRegistryClient.stopHeartbeat()
+Stops periodic heartbeat messages.
+
+One scheduler, one cancel: `startHeartbeat()` arms the loop with a recursive
+`setTimeout` and nothing in this class has created an interval since that
+rewrite (d.503), so `clearTimeout` is the whole job. A `clearInterval` on the
+same handle stood beside it until d.752, under a comment offering to cancel
+"whether it's from setTimeout or setInterval" — a choice the class does not
+have, and one that told every reader the loop might be an interval.
+
+Setting `heartbeatTimer` to null is the second half and not a formality: the
+loop reads it before arming the next beat, so a beat already in flight sees
+the stop and schedules nothing.
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+subscribeToChanges"></a>
+
+#### serviceRegistryClient.subscribeToChanges() ⇒ <code>Promise.&lt;void&gt;</code>
+Subscribe to registry change events (opt-in)
+Creates event consumer and starts listening to registry.changes exchange
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+getService"></a>
+
+#### serviceRegistryClient.getService(serviceName) ⇒ <code>Promise.&lt;(ServiceSummary\|null)&gt;</code>
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+
+| Param | Type |
+| --- | --- |
+| serviceName | <code>string</code> | 
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient+close"></a>
+
+#### serviceRegistryClient.close() ⇒ <code>Promise.&lt;void&gt;</code>
+Releases resources: stops heartbeat and closes connection.
+
+**Kind**: instance method of [<code>ServiceRegistryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient..ServiceRegistryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..RETIRED_SERVICE_INFO_KEYS"></a>
+
+### @onlineapps/conn-orch-registry/src/registryClient~RETIRED\_SERVICE\_INFO\_KEYS
+Keys `register()` REFUSES, with the reason the caller needs to act on
+(d.562, extended by d.592).
+
+Each of them used to travel on every registration and nothing ever read them:
+`api/infra/api_services_registry/src/listeners/registry.listener.js`
+destructures the `register` message without them, and no other reader exists on
+the platform (`api/docs/biz/30-operations/registration-wire.md` §2.1).
+
+They are refused rather than ignored: a key silently dropped leaves the caller
+believing something travelled. And they are refused under BOTH spellings each
+was accepted by (`token` / `validationToken`, `secret` / `tokenSecret`) — two
+names for one field is the defect this table closes, not a compatibility list.
+
+**Kind**: inner constant of [<code>@onlineapps/conn-orch-registry/src/registryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ACCEPTED_SERVICE_INFO_KEYS"></a>
+
+### @onlineapps/conn-orch-registry/src/registryClient~ACCEPTED\_SERVICE\_INFO\_KEYS
+The keys `register()` ACCEPTS — the whole input contract of the call (d.702).
+
+It is the caller's half of `api/docs/biz/30-operations/registration-wire.md`
+§2.1: the five register-message fields a CALLER supplies, plus `timeout`, which
+is this call's own response budget and reaches no message. The rest of §2.1
+(`id`, `type`, `serviceName`, `version`, `specificationEndpoint`,
+`responseQueue`, `timestamp`, `validationProof`, `validationData`) is client
+state bound in the constructor, never caller input — a caller cannot set it and
+this table must not invite one to try.
+
+Any other key is refused BY NAME, for the same reason the table above exists:
+until d.702 `register()` refused six retired keys and dropped everything else in
+silence, so `helth`, `current_step` or `name` bought a confirmed registration
+whose message never carried the value. A key silently dropped leaves the caller
+believing something travelled, and a typo in an optional key is exactly the
+shape nobody notices (`architecture-principles.md` §3 no fallbacks, §4
+fail-fast).
+
+`RETIRED_SERVICE_INFO_KEYS` is the subset that can still say WHY the key went;
+ONE membership check reads both tables, so there is no second list to drift
+(`.claude/rules/change-discipline.md` § One rail per concern).
+
+**Kind**: inner constant of [<code>@onlineapps/conn-orch-registry/src/registryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryClient..ServiceSummary"></a>
+
+### @onlineapps/conn-orch-registry/src/registryClient~ServiceSummary : <code>Object</code>
+Get basic service state for service discovery.
+
+Reads the projection the registry already maintains — the `<prefix>services`
+hash, one JSON summary per service name. **Not HTTP.** The owner decided that
+on 2026-09-02 (confirmation biz-discovery-redis-001). It is its own decision,
+not a reading of ADR 0005: that ADR
+(api/docs/biz/80-decisions/0005-no-http-in-biz-containers.md) bans an HTTP
+LISTENER in a biz container and is silent on outbound calls — this extends the
+same reasoning to the calls a biz container makes.
+Until then this method polled `GET /services`, which is what made every biz
+container an HTTP client of the registry ~142x a day.
+
+There is deliberately no HTTP fallback. A missing Redis client is a wiring
+error and says so (architecture-principles §3, §4) — falling back would
+restore the very traffic this change removes, and hide the misconfiguration.
+
+cookbook-router expects `{ status }`; the registry writes it lowercase
+('active'/'inactive') into the summary, so no normalization happens here.
+
+**Kind**: inner typedef of [<code>@onlineapps/conn-orch-registry/src/registryClient</code>](#module_@onlineapps/conn-orch-registry/src/registryClient)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| serviceName | <code>string</code> |  |
+| status | <code>string</code> | lowercase, as the registry writes it ('active'/'inactive') |
+| [version] | <code>string</code> |  |
+| [lastHeartbeatAt] | <code>string</code> |  |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer"></a>
+
+## @onlineapps/conn-orch-registry/src/registryEventConsumer
+registryEventConsumer.js
+
+Extension for ServiceRegistryClient to consume registry change events.
+Implements opt-in subscription to registry.changes exchange.
+Maintains local service index and enables lazy loading of specs.
+
+
+* [@onlineapps/conn-orch-registry/src/registryEventConsumer](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer)
+    * [~RegistryEventConsumer](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)
+        * [new RegistryEventConsumer(opts)](#new_module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer_new)
+        * [.initStorage()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+initStorage)
+        * [.subscribeToChanges()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+subscribeToChanges)
+        * [.handleSpecPublished()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleSpecPublished)
+        * [.handleStatusChanged()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleStatusChanged)
+        * [.handleSnapshot()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleSnapshot)
+        * [.handleServiceRemoved()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleServiceRemoved)
+        * [.requestSnapshot()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+requestSnapshot)
+        * [.getServiceSpec(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getServiceSpec) ⇒ <code>Promise.&lt;Object&gt;</code>
+        * [.isServiceActive(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+isServiceActive) ⇒ <code>boolean</code>
+        * [.getActiveServices()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getActiveServices) ⇒ <code>Array.&lt;string&gt;</code>
+        * [.getServiceInfo(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getServiceInfo) ⇒ <code>Object</code> \| <code>null</code>
+        * [.persistIndex()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+persistIndex)
+        * [.loadIndexFromCache()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+loadIndexFromCache)
+        * [.clearCache()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+clearCache)
+        * [.getStats()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getStats)
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer"></a>
+
+### @onlineapps/conn-orch-registry/src/registryEventConsumer~RegistryEventConsumer
+**Kind**: inner class of [<code>@onlineapps/conn-orch-registry/src/registryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer)  
+
+* [~RegistryEventConsumer](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)
+    * [new RegistryEventConsumer(opts)](#new_module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer_new)
+    * [.initStorage()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+initStorage)
+    * [.subscribeToChanges()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+subscribeToChanges)
+    * [.handleSpecPublished()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleSpecPublished)
+    * [.handleStatusChanged()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleStatusChanged)
+    * [.handleSnapshot()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleSnapshot)
+    * [.handleServiceRemoved()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleServiceRemoved)
+    * [.requestSnapshot()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+requestSnapshot)
+    * [.getServiceSpec(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getServiceSpec) ⇒ <code>Promise.&lt;Object&gt;</code>
+    * [.isServiceActive(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+isServiceActive) ⇒ <code>boolean</code>
+    * [.getActiveServices()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getActiveServices) ⇒ <code>Array.&lt;string&gt;</code>
+    * [.getServiceInfo(serviceName)](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getServiceInfo) ⇒ <code>Object</code> \| <code>null</code>
+    * [.persistIndex()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+persistIndex)
+    * [.loadIndexFromCache()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+loadIndexFromCache)
+    * [.clearCache()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+clearCache)
+    * [.getStats()](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getStats)
+
+<a name="new_module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer_new"></a>
+
+#### new RegistryEventConsumer(opts)
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| opts | <code>Object</code> |  |  |
+| opts.queueManager | <code>Object</code> |  | QueueManager instance from ServiceRegistryClient |
+| opts.serviceName | <code>string</code> |  | Name of the consuming service |
+| [opts.redis] | <code>Object</code> |  | Optional Redis client for index persistence |
+| [opts.storageConfig] | <code>Object</code> |  | Configuration for StorageConnector |
+| [opts.StorageConnector] | <code>Object</code> |  | Injectable StorageConnector class for testing |
+| opts.logger | <code>Object</code> |  | Logger with info/warn/error/debug; required, validated here   (docs/governance/confirmations/connector-logger-contract.md 001) |
+| [opts.cacheEnabled] | <code>boolean</code> | <code>true</code> | Enable local spec caching |
+| [opts.maxCacheSize] | <code>number</code> | <code>50</code> | Maximum cached specs |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+initStorage"></a>
+
+#### registryEventConsumer.initStorage()
+Initialize storage connector
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+subscribeToChanges"></a>
+
+#### registryEventConsumer.subscribeToChanges()
+Subscribe to registry change events (opt-in)
+Creates service-specific queue bound to registry.changes exchange
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleSpecPublished"></a>
+
+#### registryEventConsumer.handleSpecPublished()
+Handle SERVICE_SPEC_PUBLISHED event
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleStatusChanged"></a>
+
+#### registryEventConsumer.handleStatusChanged()
+Handle SERVICE_STATUS_CHANGED event
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleSnapshot"></a>
+
+#### registryEventConsumer.handleSnapshot()
+Handle REGISTRY_SNAPSHOT event
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+handleServiceRemoved"></a>
+
+#### registryEventConsumer.handleServiceRemoved()
+Handle SERVICE_REMOVED event
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+requestSnapshot"></a>
+
+#### registryEventConsumer.requestSnapshot()
+Request initial snapshot from registry
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getServiceSpec"></a>
+
+#### registryEventConsumer.getServiceSpec(serviceName) ⇒ <code>Promise.&lt;Object&gt;</code>
+Get service spec with lazy loading from MinIO
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+**Returns**: <code>Promise.&lt;Object&gt;</code> - - Service specification  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| serviceName | <code>string</code> | Name of the service |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+isServiceActive"></a>
+
+#### registryEventConsumer.isServiceActive(serviceName) ⇒ <code>boolean</code>
+Check if service is active (synchronous, from local index)
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| serviceName | <code>string</code> | Name of the service |
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getActiveServices"></a>
+
+#### registryEventConsumer.getActiveServices() ⇒ <code>Array.&lt;string&gt;</code>
+Get list of active services (synchronous, from local index)
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getServiceInfo"></a>
+
+#### registryEventConsumer.getServiceInfo(serviceName) ⇒ <code>Object</code> \| <code>null</code>
+Get service info from local index
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+
+| Param | Type |
+| --- | --- |
+| serviceName | <code>string</code> | 
+
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+persistIndex"></a>
+
+#### registryEventConsumer.persistIndex()
+Persist index to Redis (if configured)
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+loadIndexFromCache"></a>
+
+#### registryEventConsumer.loadIndexFromCache()
+Load index from Redis cache
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+clearCache"></a>
+
+#### registryEventConsumer.clearCache()
+Clear all caches
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)  
+<a name="module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer+getStats"></a>
+
+#### registryEventConsumer.getStats()
+Get stats about current state
+
+**Kind**: instance method of [<code>RegistryEventConsumer</code>](#module_@onlineapps/conn-orch-registry/src/registryEventConsumer..RegistryEventConsumer)