@onlineapps/conn-orch-registry 8.0.0 → 9.0.0

package/CHANGELOG.md

@@ -4,6 +4,61 @@ All notable changes to this package. Follows [Keep a Changelog](https://keepacha
 
 ## [Unreleased]
 
+## [9.0.0] — 2026-10-12
+
+### Changed — BREAKING — zděděné chování `@onlineapps/mq-client-core` 6.0.0 (platí s pinem 6.0.0, který přijde s vydáním jádra; d.1361, d.1363)
+
+`QueueManager` je tenký průchod k `BaseClient` jádra — `publish()` (`src/queueManager.js:225-226`)
+a `consume()` (`:242-243`) předávají volání i odmítnutí beze změny. Z jádra tenhle balíček nic
+znovu nevydává (`src/index.js`: `ServiceRegistryClient`, `RegistryEventConsumer`, `EVENTS`) a
+konfiguraci jádra nepropouští (`BaseClient` se staví s pevnými klíči `type`, `host`,
+`serviceName`, `logger`, `src/queueManager.js:73-78`), takže odebrání `criticalHealthShutdown`
+a `health:shutdown` (jádro d.1275) volajícího nezasáhne. Co z CHANGELOGu jádra projde k
+volajícímu veřejnými metodami `ServiceRegistryClient`, jakmile se pin `@onlineapps/mq-client-core`
+zvedne z 5.1.0 na 6.0.0 (zdejší kód se nemění):
+
+- **`sendHeartbeat()` a `deregister()` propouštějí `PublishError` jádra neobalený**
+  (`src/registryClient.js:931`, `:880`; volby `{ persistent: true }`, tedy výchozí
+  `bufferOnFailure: true`). S jádrem 6.0.0 (d.1300): publish, jehož čekání na obnovu skončí
+  standby (vyčerpaný cyklus), odmítne `PublishError` s `buffered: true`, `sent: false` — dřív
+  bez `buffered` — a zprávu DRŽÍ v bufferu; přehraje ji po příštím `reconnected`/`unblocked`.
+  Skončí-li obnova fatálně, nese chyba `code: 'MQ_CONNECTION_FATAL'` a `reason`
+  (`'cycles-spent'` | `'broker-refused'`) přímo na sobě; nic se nedrží. Volající, který po
+  odmítnutí posílal heartbeat nebo deregistraci znovu sám, ji teď může poslat dvakrát.
+  Smyčka `startHeartbeat()` počítá odmítnutý beat jako selhání dál stejně (obal s `cause`).
+- **`init()` předává `code`/`reason` chyby `consume()` na svůj obal** (`src/registryClient.js:305`
+  → `_startRegistryConsumer`, `:370-371`). S jádrem 6.0.0 (d.1297) nese chyba `consume()` po
+  fatálním cyklu `code: 'MQ_CONNECTION_FATAL'` a `reason` NAHOŘE (dřív jen v `cause`, obal měl
+  `code` `undefined`). Volající, který podle `error.code` rozhoduje — `@onlineapps/service-wrapper`
+  v bootu (`ServiceWrapper.js`, větve `error.code !== 'MQ_CONNECTION_FATAL'`) — bere týž výpadek
+  jako TRVALÝ konec bootu, ne přechodný. Standby, `disconnect()` a `reconnectEnabled: false`
+  `code` dál nenesou.
+- **`register()` — zpráva držená přes standby se přehraje i po odmítnutí** (`src/registryClient.js:777`,
+  `:798-801`). `register()` chybu publishe obaluje (`Failed to send registration message: <věta
+  jádra>`, bez `code`) a čekající registraci zruší; zprávu `register`, kterou jádro 6.0.0 po
+  standby drží (d.1300), ale po reconnectu přehraje — registr tak dostane registraci, o které
+  volající ví, že selhala; její odpověď skončí řádkem WARN
+  „Registration response has no matching pending request“ (`:519`). Sousední cesta (přechodná chyba →
+  čekání na běžící reconnect → selhání) držela zprávu už v 5.1.0; 6.0.0 přidává standby.
+
+Precedent: `@onlineapps/conn-infra-mq` `[Unreleased]` „BREAKING — zděděné chování
+`@onlineapps/mq-client-core` 6.0.0“ a `@onlineapps/conn-orch-cookbook` `[7.0.0]`. Rozhodnutí
+leada d.1361: major 9.0.0.
+
+### Tests — brána „broker pod alarmem“ IT tieru má jedno tělo v repu (d.1326)
+
+- `refuseBrokerUnderAlarm` z `tests/integration/setup.js` (originál, d.775/d.783) přesunut do
+  `api/scripts/tests/brokerAlarm.js` vedle `sweepOrphanQueues.js` (d.1320), kam z tohoto tieru
+  odešel i sweep; `setup.js` ho volá `refuseBrokerUnderAlarm({ ask: mgmtReader(config), context,
+  where })` — čtenář zůstává zdejší `mgmtReader` (rozpočet `withinBudget`). Věta odmítnutí beze
+  změny tvrzení (`environmentProbe.integration.test.js`: `[conn-orch-registry/integration] The
+  broker is under a resource alarm and is blocking publishers`, `memory on rabbit@…`, `HTTP 503
+  from <host:port>`); `Fix` nově jmenuje i `rabbitmq-diagnostics -q alarms`.
+- Čtyři otázky `change-discipline.md` § Removing (za všechny tři kopie): četl je jen `setup.js`
+  každého tieru (+ unit testy wrapperu a mq-client-core); psal je každý tier zvlášť (tři
+  implementace, měřeno `diff`); nahrazuje je jedno tělo s injektovaným čtenářem; porušení se
+  pozná větou alarmu v globalSetup tieru před prvním testem (IT `environmentProbe` to drží stubem).
+
 ## [8.0.0] — 2026-10-03
 
 pin: `@onlineapps/mq-client-core` 5.0.0 → 5.1.0

package/README.md

@@ -6,7 +6,7 @@ Uniform: [library/orchestration](../conn-orch-validator/manifests/library.manife
 
 Duty sections that apply:
 
-- `all`: L-MAIN, L-ENGINES, L-TESTS, L-TEST-SCRIPT, L-PACK-TESTS, L-PINS, L-NO-FILE-RANGE, L-CHANGELOG, L-README, L-README-REGION, L-CONSUMER
+- `all`: L-MAIN, L-ENGINES, L-TESTS, L-TEST-SCRIPT, L-PACK-TESTS, L-PINS, L-NO-FILE-RANGE, L-CHANGELOG, L-PACK-CHANGELOG, L-README, L-README-REGION, L-CONSUMER
 <!-- END GENERATED: library-uniform -->
 
 # @onlineapps/conn-orch-registry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/conn-orch-registry",
-  "version": "8.0.0",
+  "version": "9.0.0",
   "license": "MIT",
   "description": "conn-orch-registry provides the core communication mechanism for microservices in this environment. It enables them to interact with a services_registry to receive and fulfill tasks by submitting heartbeats or their API descriptions.",
   "keywords": [
@@ -38,8 +38,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@onlineapps/logger-contract": "2.0.0",
-    "@onlineapps/mq-client-core": "5.1.0",
+    "@onlineapps/logger-contract": "2.1.0",
+    "@onlineapps/mq-client-core": "6.0.0",
     "uuid": "^9.0.1"
   },
   "devDependencies": {