mqtt-plus 1.4.3 → 1.4.4

package/AGENTS.md

@@ -107,26 +107,36 @@ Each trait lives in its own file: `src/mqtt-plus-<trait>.ts`.
 
 ### Documentation
 
-The `doc/` directory contains D2 diagram sources and generated SVG files
-illustrating the four communication patterns:
+The `doc/` directory contains Markdown documentation, D2 diagram sources,
+and generated SVG files:
 
-- `doc/mqtt-plus-comm-event-emission.{d2,svg}`
-- `doc/mqtt-plus-comm-service-call.{d2,svg}`
-- `doc/mqtt-plus-comm-sink-push.{d2,svg}`
-- `doc/mqtt-plus-comm-source-fetch.{d2,svg}`
-- `doc/theme.d2` — shared D2 theme
+- `doc/mqtt-plus-api.md` — public API reference
+- `doc/mqtt-plus-architecture.{d2,svg,md}` — architecture overview (diagram + docs)
+- `doc/mqtt-plus-broker-setup.md` — MQTT broker setup guide
+- `doc/mqtt-plus-comm.md` — communication patterns overview
+- `doc/mqtt-plus-comm-event-emission.{d2,svg}` — Event Emission pattern diagram
+- `doc/mqtt-plus-comm-service-call.{d2,svg}` — Service Call pattern diagram
+- `doc/mqtt-plus-comm-sink-push.{d2,svg}` — Sink Push pattern diagram
+- `doc/mqtt-plus-comm-source-fetch.{d2,svg}` — Source Fetch pattern diagram
+- `doc/mqtt-plus-internals.md` — internal implementation details
 
-Regenerate with `npm start build-doc` (requires the `etc/d2.mts` helper script).
+Regenerate diagrams with `npm start build-doc` (requires the `etc/d2.mts` helper script).
 
 ### Tests
 
 Test files live in `tst/`:
 
-| File                          | Role |
-|-------------------------------|------|
-| `tst/mqtt-plus.spec.ts`      | Main Mocha test suite covering all four communication patterns |
-| `tst/mqtt-plus-mosquitto.ts`  | Helper for starting/stopping the Mosquitto MQTT broker |
-| `tst/tsc.json`               | TypeScript configuration for the test directory |
+| File                              | Role |
+|-----------------------------------|------|
+| `tst/mqtt-plus-0-fixture.ts`      | Shared test fixture setup (broker, MQTTp instances, etc.) |
+| `tst/mqtt-plus-0-mosquitto.ts`    | Helper for starting/stopping the Mosquitto MQTT broker |
+| `tst/mqtt-plus-1-api.spec.ts`     | API type and endpoint definition tests |
+| `tst/mqtt-plus-2-event.spec.ts`   | Event Emission pattern tests |
+| `tst/mqtt-plus-3-service.spec.ts` | Service Call / RPC pattern tests |
+| `tst/mqtt-plus-4-sink.spec.ts`    | Sink Push pattern tests |
+| `tst/mqtt-plus-5-source.spec.ts`  | Source Fetch pattern tests |
+| `tst/mqtt-plus-6-misc.spec.ts`    | Miscellaneous / edge-case tests |
+| `tst/tsc.json`                    | TypeScript configuration for the test directory |
 
 ### Type System
 

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 ChangeLog
 =========
 
+1.4.4 (2026-02-21)
+------------------
+
+- CLEANUP: cleanup documentation
+
 1.4.3 (2026-02-21)
 ------------------
 

package/README.md

@@ -131,6 +131,15 @@ Additional auxilliary documentation:
 Notice
 ------
 
+> [!Note]
+> **MQTT+** and its peer dependency **MQTT** provide a powerful
+> functionality, but are not small in size. **MQTT+** is 3.500 LoC
+> and 75 KB in size (ESM and CJS format). When bundled with all its
+> dependencies, it is 220 KB in size (UMD format). Its peer dependency
+> **MQTT.js** is 370 KB (ESM and CJS format) and 860 KB (UMD format) in
+> size. For a Node.js application, this usually doesn't matter. For a
+> HTML5 SPA it matters more, but usually is still acceptable.
+
 > [!Note]
 > **MQTT+** is still somewhat similar to and originally derived from the weaker
 > [MQTT-JSON-RPC](https://github.com/rse/mqtt-json-rpc) library of the same

package/dst-stage1/mqtt-plus-subscription.js

@@ -118,7 +118,7 @@ export class SubscriptionTrait extends BaseTrait {
         super(...arguments);
         this.subscriptions = new RefCountedSubscription((topic, options) => this._subscribeTopic(topic, options), (topic) => this._unsubscribeTopic(topic));
     }
-    /*  destroy topic trait  */
+    /*  destroy subscription trait  */
     async destroy() {
         await this.subscriptions.flush();
         await super.destroy();

package/dst-stage2/mqtt-plus.cjs.js

@@ -1131,7 +1131,7 @@ class SubscriptionTrait extends BaseTrait {
     super(...arguments);
     this.subscriptions = new RefCountedSubscription((topic, options) => this._subscribeTopic(topic, options), (topic) => this._unsubscribeTopic(topic));
   }
-  /*  destroy topic trait  */
+  /*  destroy subscription trait  */
   async destroy() {
     await this.subscriptions.flush();
     await super.destroy();

package/dst-stage2/mqtt-plus.esm.js

@@ -1110,7 +1110,7 @@ class SubscriptionTrait extends BaseTrait {
     super(...arguments);
     this.subscriptions = new RefCountedSubscription((topic, options) => this._subscribeTopic(topic, options), (topic) => this._unsubscribeTopic(topic));
   }
-  /*  destroy topic trait  */
+  /*  destroy subscription trait  */
   async destroy() {
     await this.subscriptions.flush();
     await super.destroy();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":                           "mqtt-plus",
-    "version":                        "1.4.3",
+    "version":                        "1.4.4",
     "description":                    "MQTT Communication Patterns",
     "keywords":                       [   "mqtt",
                                           "event", "emit",

package/src/mqtt-plus-subscription.ts

@@ -133,7 +133,7 @@ export class SubscriptionTrait<T extends APISchema = APISchema> extends BaseTrai
         (topic)          => this._unsubscribeTopic(topic)
     )
 
-    /*  destroy topic trait  */
+    /*  destroy subscription trait  */
     override async destroy () {
         await this.subscriptions.flush()
         await super.destroy()