mqtt-plus 1.4.13 → 1.4.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/AGENTS.md +0 -1
  2. package/CHANGELOG.md +18 -0
  3. package/dst-stage1/mqtt-plus-api.js +1 -0
  4. package/dst-stage1/mqtt-plus-api.js.map +1 -0
  5. package/dst-stage1/mqtt-plus-auth.js +1 -0
  6. package/dst-stage1/mqtt-plus-auth.js.map +1 -0
  7. package/dst-stage1/mqtt-plus-base.js +1 -0
  8. package/dst-stage1/mqtt-plus-base.js.map +1 -0
  9. package/dst-stage1/mqtt-plus-codec.js +1 -0
  10. package/dst-stage1/mqtt-plus-codec.js.map +1 -0
  11. package/dst-stage1/mqtt-plus-encode.js +1 -0
  12. package/dst-stage1/mqtt-plus-encode.js.map +1 -0
  13. package/dst-stage1/mqtt-plus-error.js +1 -0
  14. package/dst-stage1/mqtt-plus-error.js.map +1 -0
  15. package/dst-stage1/mqtt-plus-event.js +1 -0
  16. package/dst-stage1/mqtt-plus-event.js.map +1 -0
  17. package/dst-stage1/mqtt-plus-info.js +1 -0
  18. package/dst-stage1/mqtt-plus-info.js.map +1 -0
  19. package/dst-stage1/mqtt-plus-meta.js +1 -0
  20. package/dst-stage1/mqtt-plus-meta.js.map +1 -0
  21. package/dst-stage1/mqtt-plus-msg.js +1 -0
  22. package/dst-stage1/mqtt-plus-msg.js.map +1 -0
  23. package/dst-stage1/mqtt-plus-options.js +1 -0
  24. package/dst-stage1/mqtt-plus-options.js.map +1 -0
  25. package/dst-stage1/mqtt-plus-service.js +1 -0
  26. package/dst-stage1/mqtt-plus-service.js.map +1 -0
  27. package/dst-stage1/mqtt-plus-sink.js +14 -2
  28. package/dst-stage1/mqtt-plus-sink.js.map +1 -0
  29. package/dst-stage1/mqtt-plus-source.js +27 -16
  30. package/dst-stage1/mqtt-plus-source.js.map +1 -0
  31. package/dst-stage1/mqtt-plus-subscription.js +1 -0
  32. package/dst-stage1/mqtt-plus-subscription.js.map +1 -0
  33. package/dst-stage1/mqtt-plus-timer.js +1 -0
  34. package/dst-stage1/mqtt-plus-timer.js.map +1 -0
  35. package/dst-stage1/mqtt-plus-trace.js +1 -0
  36. package/dst-stage1/mqtt-plus-trace.js.map +1 -0
  37. package/dst-stage1/mqtt-plus-util.js +1 -0
  38. package/dst-stage1/mqtt-plus-util.js.map +1 -0
  39. package/dst-stage1/mqtt-plus-version.d.ts +1 -1
  40. package/dst-stage1/mqtt-plus-version.js +3 -1
  41. package/dst-stage1/mqtt-plus-version.js.map +1 -0
  42. package/dst-stage1/mqtt-plus.js +1 -0
  43. package/dst-stage1/mqtt-plus.js.map +1 -0
  44. package/dst-stage2/mqtt-plus.cjs.js +1972 -2161
  45. package/dst-stage2/mqtt-plus.esm.js +1934 -2131
  46. package/dst-stage2/mqtt-plus.umd.js +13 -14
  47. package/etc/c8.json +16 -0
  48. package/etc/knip.jsonc +7 -1
  49. package/etc/stx.conf +36 -4
  50. package/etc/tsc.json +1 -1
  51. package/etc/vite.mts +11 -5
  52. package/package.d/vite+8.0.0.patch +12 -0
  53. package/package.json +12 -3
  54. package/src/mqtt-plus-sink.ts +14 -2
  55. package/src/mqtt-plus-source.ts +27 -16
  56. package/src/mqtt-plus-version.ts +2 -3
  57. package/tst/.c8/base.css +224 -0
  58. package/tst/.c8/block-navigation.js +87 -0
  59. package/tst/.c8/favicon.png +0 -0
  60. package/tst/.c8/index.html +371 -0
  61. package/tst/.c8/mqtt-plus-auth.ts.html +538 -0
  62. package/tst/.c8/mqtt-plus-base.ts.html +826 -0
  63. package/tst/.c8/mqtt-plus-codec.ts.html +457 -0
  64. package/tst/.c8/mqtt-plus-encode.ts.html +310 -0
  65. package/tst/.c8/mqtt-plus-error.ts.html +1186 -0
  66. package/tst/.c8/mqtt-plus-event.ts.html +733 -0
  67. package/tst/.c8/mqtt-plus-meta.ts.html +271 -0
  68. package/tst/.c8/mqtt-plus-msg.ts.html +1693 -0
  69. package/tst/.c8/mqtt-plus-options.ts.html +319 -0
  70. package/tst/.c8/mqtt-plus-service.ts.html +865 -0
  71. package/tst/.c8/mqtt-plus-sink.ts.html +1645 -0
  72. package/tst/.c8/mqtt-plus-source.ts.html +1585 -0
  73. package/tst/.c8/mqtt-plus-subscription.ts.html +706 -0
  74. package/tst/.c8/mqtt-plus-timer.ts.html +286 -0
  75. package/tst/.c8/mqtt-plus-trace.ts.html +463 -0
  76. package/tst/.c8/mqtt-plus-util.ts.html +823 -0
  77. package/tst/.c8/mqtt-plus-version.ts.html +205 -0
  78. package/tst/.c8/mqtt-plus.ts.html +193 -0
  79. package/tst/.c8/prettify.css +1 -0
  80. package/tst/.c8/prettify.js +2 -0
  81. package/tst/.c8/sort-arrow-sprite.png +0 -0
  82. package/tst/.c8/sorter.js +210 -0
  83. package/tst/.c8/tmp/coverage-6577-1773528098323-2.json +1 -0
  84. package/tst/.c8/tmp/coverage-6577-1773528098331-1.json +1 -0
  85. package/tst/.c8/tmp/coverage-6577-1773528098353-0.json +1 -0
  86. package/tst/.c8/tmp/coverage-6578-1773528089194-0.json +1 -0
  87. package/tst/mqtt-plus-2-event.spec.ts +29 -0
  88. package/tst/mqtt-plus-6-misc.spec.ts +79 -2
  89. package/tst/mqtt-plus-7-spool.spec.ts +101 -0
  90. package/tst/mqtt-plus-8-run.spec.ts +115 -0
  91. package/tst/{tsc.json → tsc.cov.json} +4 -3
  92. package/tst/tsc.std.json +31 -0
package/tst/.c8/mqtt-plus-event.ts.html ADDED
@@ -0,0 +1,733 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for mqtt-plus-event.ts</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="prettify.css" />
9
+ <link rel="stylesheet" href="base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="index.html">All files</a> mqtt-plus-event.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">99.07% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>214/216</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">75% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>27/36</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">100% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>9/9</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">99.07% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>214/216</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line high'></div>
65
+ <pre><table class="coverage">
66
+ <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
+ <a name='L2'></a><a href='#L2'>2</a>
68
+ <a name='L3'></a><a href='#L3'>3</a>
69
+ <a name='L4'></a><a href='#L4'>4</a>
70
+ <a name='L5'></a><a href='#L5'>5</a>
71
+ <a name='L6'></a><a href='#L6'>6</a>
72
+ <a name='L7'></a><a href='#L7'>7</a>
73
+ <a name='L8'></a><a href='#L8'>8</a>
74
+ <a name='L9'></a><a href='#L9'>9</a>
75
+ <a name='L10'></a><a href='#L10'>10</a>
76
+ <a name='L11'></a><a href='#L11'>11</a>
77
+ <a name='L12'></a><a href='#L12'>12</a>
78
+ <a name='L13'></a><a href='#L13'>13</a>
79
+ <a name='L14'></a><a href='#L14'>14</a>
80
+ <a name='L15'></a><a href='#L15'>15</a>
81
+ <a name='L16'></a><a href='#L16'>16</a>
82
+ <a name='L17'></a><a href='#L17'>17</a>
83
+ <a name='L18'></a><a href='#L18'>18</a>
84
+ <a name='L19'></a><a href='#L19'>19</a>
85
+ <a name='L20'></a><a href='#L20'>20</a>
86
+ <a name='L21'></a><a href='#L21'>21</a>
87
+ <a name='L22'></a><a href='#L22'>22</a>
88
+ <a name='L23'></a><a href='#L23'>23</a>
89
+ <a name='L24'></a><a href='#L24'>24</a>
90
+ <a name='L25'></a><a href='#L25'>25</a>
91
+ <a name='L26'></a><a href='#L26'>26</a>
92
+ <a name='L27'></a><a href='#L27'>27</a>
93
+ <a name='L28'></a><a href='#L28'>28</a>
94
+ <a name='L29'></a><a href='#L29'>29</a>
95
+ <a name='L30'></a><a href='#L30'>30</a>
96
+ <a name='L31'></a><a href='#L31'>31</a>
97
+ <a name='L32'></a><a href='#L32'>32</a>
98
+ <a name='L33'></a><a href='#L33'>33</a>
99
+ <a name='L34'></a><a href='#L34'>34</a>
100
+ <a name='L35'></a><a href='#L35'>35</a>
101
+ <a name='L36'></a><a href='#L36'>36</a>
102
+ <a name='L37'></a><a href='#L37'>37</a>
103
+ <a name='L38'></a><a href='#L38'>38</a>
104
+ <a name='L39'></a><a href='#L39'>39</a>
105
+ <a name='L40'></a><a href='#L40'>40</a>
106
+ <a name='L41'></a><a href='#L41'>41</a>
107
+ <a name='L42'></a><a href='#L42'>42</a>
108
+ <a name='L43'></a><a href='#L43'>43</a>
109
+ <a name='L44'></a><a href='#L44'>44</a>
110
+ <a name='L45'></a><a href='#L45'>45</a>
111
+ <a name='L46'></a><a href='#L46'>46</a>
112
+ <a name='L47'></a><a href='#L47'>47</a>
113
+ <a name='L48'></a><a href='#L48'>48</a>
114
+ <a name='L49'></a><a href='#L49'>49</a>
115
+ <a name='L50'></a><a href='#L50'>50</a>
116
+ <a name='L51'></a><a href='#L51'>51</a>
117
+ <a name='L52'></a><a href='#L52'>52</a>
118
+ <a name='L53'></a><a href='#L53'>53</a>
119
+ <a name='L54'></a><a href='#L54'>54</a>
120
+ <a name='L55'></a><a href='#L55'>55</a>
121
+ <a name='L56'></a><a href='#L56'>56</a>
122
+ <a name='L57'></a><a href='#L57'>57</a>
123
+ <a name='L58'></a><a href='#L58'>58</a>
124
+ <a name='L59'></a><a href='#L59'>59</a>
125
+ <a name='L60'></a><a href='#L60'>60</a>
126
+ <a name='L61'></a><a href='#L61'>61</a>
127
+ <a name='L62'></a><a href='#L62'>62</a>
128
+ <a name='L63'></a><a href='#L63'>63</a>
129
+ <a name='L64'></a><a href='#L64'>64</a>
130
+ <a name='L65'></a><a href='#L65'>65</a>
131
+ <a name='L66'></a><a href='#L66'>66</a>
132
+ <a name='L67'></a><a href='#L67'>67</a>
133
+ <a name='L68'></a><a href='#L68'>68</a>
134
+ <a name='L69'></a><a href='#L69'>69</a>
135
+ <a name='L70'></a><a href='#L70'>70</a>
136
+ <a name='L71'></a><a href='#L71'>71</a>
137
+ <a name='L72'></a><a href='#L72'>72</a>
138
+ <a name='L73'></a><a href='#L73'>73</a>
139
+ <a name='L74'></a><a href='#L74'>74</a>
140
+ <a name='L75'></a><a href='#L75'>75</a>
141
+ <a name='L76'></a><a href='#L76'>76</a>
142
+ <a name='L77'></a><a href='#L77'>77</a>
143
+ <a name='L78'></a><a href='#L78'>78</a>
144
+ <a name='L79'></a><a href='#L79'>79</a>
145
+ <a name='L80'></a><a href='#L80'>80</a>
146
+ <a name='L81'></a><a href='#L81'>81</a>
147
+ <a name='L82'></a><a href='#L82'>82</a>
148
+ <a name='L83'></a><a href='#L83'>83</a>
149
+ <a name='L84'></a><a href='#L84'>84</a>
150
+ <a name='L85'></a><a href='#L85'>85</a>
151
+ <a name='L86'></a><a href='#L86'>86</a>
152
+ <a name='L87'></a><a href='#L87'>87</a>
153
+ <a name='L88'></a><a href='#L88'>88</a>
154
+ <a name='L89'></a><a href='#L89'>89</a>
155
+ <a name='L90'></a><a href='#L90'>90</a>
156
+ <a name='L91'></a><a href='#L91'>91</a>
157
+ <a name='L92'></a><a href='#L92'>92</a>
158
+ <a name='L93'></a><a href='#L93'>93</a>
159
+ <a name='L94'></a><a href='#L94'>94</a>
160
+ <a name='L95'></a><a href='#L95'>95</a>
161
+ <a name='L96'></a><a href='#L96'>96</a>
162
+ <a name='L97'></a><a href='#L97'>97</a>
163
+ <a name='L98'></a><a href='#L98'>98</a>
164
+ <a name='L99'></a><a href='#L99'>99</a>
165
+ <a name='L100'></a><a href='#L100'>100</a>
166
+ <a name='L101'></a><a href='#L101'>101</a>
167
+ <a name='L102'></a><a href='#L102'>102</a>
168
+ <a name='L103'></a><a href='#L103'>103</a>
169
+ <a name='L104'></a><a href='#L104'>104</a>
170
+ <a name='L105'></a><a href='#L105'>105</a>
171
+ <a name='L106'></a><a href='#L106'>106</a>
172
+ <a name='L107'></a><a href='#L107'>107</a>
173
+ <a name='L108'></a><a href='#L108'>108</a>
174
+ <a name='L109'></a><a href='#L109'>109</a>
175
+ <a name='L110'></a><a href='#L110'>110</a>
176
+ <a name='L111'></a><a href='#L111'>111</a>
177
+ <a name='L112'></a><a href='#L112'>112</a>
178
+ <a name='L113'></a><a href='#L113'>113</a>
179
+ <a name='L114'></a><a href='#L114'>114</a>
180
+ <a name='L115'></a><a href='#L115'>115</a>
181
+ <a name='L116'></a><a href='#L116'>116</a>
182
+ <a name='L117'></a><a href='#L117'>117</a>
183
+ <a name='L118'></a><a href='#L118'>118</a>
184
+ <a name='L119'></a><a href='#L119'>119</a>
185
+ <a name='L120'></a><a href='#L120'>120</a>
186
+ <a name='L121'></a><a href='#L121'>121</a>
187
+ <a name='L122'></a><a href='#L122'>122</a>
188
+ <a name='L123'></a><a href='#L123'>123</a>
189
+ <a name='L124'></a><a href='#L124'>124</a>
190
+ <a name='L125'></a><a href='#L125'>125</a>
191
+ <a name='L126'></a><a href='#L126'>126</a>
192
+ <a name='L127'></a><a href='#L127'>127</a>
193
+ <a name='L128'></a><a href='#L128'>128</a>
194
+ <a name='L129'></a><a href='#L129'>129</a>
195
+ <a name='L130'></a><a href='#L130'>130</a>
196
+ <a name='L131'></a><a href='#L131'>131</a>
197
+ <a name='L132'></a><a href='#L132'>132</a>
198
+ <a name='L133'></a><a href='#L133'>133</a>
199
+ <a name='L134'></a><a href='#L134'>134</a>
200
+ <a name='L135'></a><a href='#L135'>135</a>
201
+ <a name='L136'></a><a href='#L136'>136</a>
202
+ <a name='L137'></a><a href='#L137'>137</a>
203
+ <a name='L138'></a><a href='#L138'>138</a>
204
+ <a name='L139'></a><a href='#L139'>139</a>
205
+ <a name='L140'></a><a href='#L140'>140</a>
206
+ <a name='L141'></a><a href='#L141'>141</a>
207
+ <a name='L142'></a><a href='#L142'>142</a>
208
+ <a name='L143'></a><a href='#L143'>143</a>
209
+ <a name='L144'></a><a href='#L144'>144</a>
210
+ <a name='L145'></a><a href='#L145'>145</a>
211
+ <a name='L146'></a><a href='#L146'>146</a>
212
+ <a name='L147'></a><a href='#L147'>147</a>
213
+ <a name='L148'></a><a href='#L148'>148</a>
214
+ <a name='L149'></a><a href='#L149'>149</a>
215
+ <a name='L150'></a><a href='#L150'>150</a>
216
+ <a name='L151'></a><a href='#L151'>151</a>
217
+ <a name='L152'></a><a href='#L152'>152</a>
218
+ <a name='L153'></a><a href='#L153'>153</a>
219
+ <a name='L154'></a><a href='#L154'>154</a>
220
+ <a name='L155'></a><a href='#L155'>155</a>
221
+ <a name='L156'></a><a href='#L156'>156</a>
222
+ <a name='L157'></a><a href='#L157'>157</a>
223
+ <a name='L158'></a><a href='#L158'>158</a>
224
+ <a name='L159'></a><a href='#L159'>159</a>
225
+ <a name='L160'></a><a href='#L160'>160</a>
226
+ <a name='L161'></a><a href='#L161'>161</a>
227
+ <a name='L162'></a><a href='#L162'>162</a>
228
+ <a name='L163'></a><a href='#L163'>163</a>
229
+ <a name='L164'></a><a href='#L164'>164</a>
230
+ <a name='L165'></a><a href='#L165'>165</a>
231
+ <a name='L166'></a><a href='#L166'>166</a>
232
+ <a name='L167'></a><a href='#L167'>167</a>
233
+ <a name='L168'></a><a href='#L168'>168</a>
234
+ <a name='L169'></a><a href='#L169'>169</a>
235
+ <a name='L170'></a><a href='#L170'>170</a>
236
+ <a name='L171'></a><a href='#L171'>171</a>
237
+ <a name='L172'></a><a href='#L172'>172</a>
238
+ <a name='L173'></a><a href='#L173'>173</a>
239
+ <a name='L174'></a><a href='#L174'>174</a>
240
+ <a name='L175'></a><a href='#L175'>175</a>
241
+ <a name='L176'></a><a href='#L176'>176</a>
242
+ <a name='L177'></a><a href='#L177'>177</a>
243
+ <a name='L178'></a><a href='#L178'>178</a>
244
+ <a name='L179'></a><a href='#L179'>179</a>
245
+ <a name='L180'></a><a href='#L180'>180</a>
246
+ <a name='L181'></a><a href='#L181'>181</a>
247
+ <a name='L182'></a><a href='#L182'>182</a>
248
+ <a name='L183'></a><a href='#L183'>183</a>
249
+ <a name='L184'></a><a href='#L184'>184</a>
250
+ <a name='L185'></a><a href='#L185'>185</a>
251
+ <a name='L186'></a><a href='#L186'>186</a>
252
+ <a name='L187'></a><a href='#L187'>187</a>
253
+ <a name='L188'></a><a href='#L188'>188</a>
254
+ <a name='L189'></a><a href='#L189'>189</a>
255
+ <a name='L190'></a><a href='#L190'>190</a>
256
+ <a name='L191'></a><a href='#L191'>191</a>
257
+ <a name='L192'></a><a href='#L192'>192</a>
258
+ <a name='L193'></a><a href='#L193'>193</a>
259
+ <a name='L194'></a><a href='#L194'>194</a>
260
+ <a name='L195'></a><a href='#L195'>195</a>
261
+ <a name='L196'></a><a href='#L196'>196</a>
262
+ <a name='L197'></a><a href='#L197'>197</a>
263
+ <a name='L198'></a><a href='#L198'>198</a>
264
+ <a name='L199'></a><a href='#L199'>199</a>
265
+ <a name='L200'></a><a href='#L200'>200</a>
266
+ <a name='L201'></a><a href='#L201'>201</a>
267
+ <a name='L202'></a><a href='#L202'>202</a>
268
+ <a name='L203'></a><a href='#L203'>203</a>
269
+ <a name='L204'></a><a href='#L204'>204</a>
270
+ <a name='L205'></a><a href='#L205'>205</a>
271
+ <a name='L206'></a><a href='#L206'>206</a>
272
+ <a name='L207'></a><a href='#L207'>207</a>
273
+ <a name='L208'></a><a href='#L208'>208</a>
274
+ <a name='L209'></a><a href='#L209'>209</a>
275
+ <a name='L210'></a><a href='#L210'>210</a>
276
+ <a name='L211'></a><a href='#L211'>211</a>
277
+ <a name='L212'></a><a href='#L212'>212</a>
278
+ <a name='L213'></a><a href='#L213'>213</a>
279
+ <a name='L214'></a><a href='#L214'>214</a>
280
+ <a name='L215'></a><a href='#L215'>215</a>
281
+ <a name='L216'></a><a href='#L216'>216</a>
282
+ <a name='L217'></a><a href='#L217'>217</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
283
+ <span class="cline-any cline-yes">1x</span>
284
+ <span class="cline-any cline-yes">1x</span>
285
+ <span class="cline-any cline-yes">1x</span>
286
+ <span class="cline-any cline-yes">1x</span>
287
+ <span class="cline-any cline-yes">1x</span>
288
+ <span class="cline-any cline-yes">1x</span>
289
+ <span class="cline-any cline-yes">1x</span>
290
+ <span class="cline-any cline-yes">1x</span>
291
+ <span class="cline-any cline-yes">1x</span>
292
+ <span class="cline-any cline-yes">1x</span>
293
+ <span class="cline-any cline-yes">1x</span>
294
+ <span class="cline-any cline-yes">1x</span>
295
+ <span class="cline-any cline-yes">1x</span>
296
+ <span class="cline-any cline-yes">1x</span>
297
+ <span class="cline-any cline-yes">1x</span>
298
+ <span class="cline-any cline-yes">1x</span>
299
+ <span class="cline-any cline-yes">1x</span>
300
+ <span class="cline-any cline-yes">1x</span>
301
+ <span class="cline-any cline-yes">1x</span>
302
+ <span class="cline-any cline-yes">1x</span>
303
+ <span class="cline-any cline-yes">1x</span>
304
+ <span class="cline-any cline-yes">1x</span>
305
+ <span class="cline-any cline-yes">1x</span>
306
+ <span class="cline-any cline-yes">1x</span>
307
+ <span class="cline-any cline-yes">1x</span>
308
+ <span class="cline-any cline-yes">1x</span>
309
+ <span class="cline-any cline-yes">1x</span>
310
+ <span class="cline-any cline-yes">1x</span>
311
+ <span class="cline-any cline-yes">1x</span>
312
+ <span class="cline-any cline-yes">1x</span>
313
+ <span class="cline-any cline-yes">1x</span>
314
+ <span class="cline-any cline-yes">1x</span>
315
+ <span class="cline-any cline-yes">1x</span>
316
+ <span class="cline-any cline-yes">1x</span>
317
+ <span class="cline-any cline-yes">1x</span>
318
+ <span class="cline-any cline-yes">1x</span>
319
+ <span class="cline-any cline-yes">1x</span>
320
+ <span class="cline-any cline-yes">1x</span>
321
+ <span class="cline-any cline-yes">1x</span>
322
+ <span class="cline-any cline-yes">1x</span>
323
+ <span class="cline-any cline-yes">1x</span>
324
+ <span class="cline-any cline-yes">1x</span>
325
+ <span class="cline-any cline-yes">1x</span>
326
+ <span class="cline-any cline-yes">1x</span>
327
+ <span class="cline-any cline-yes">1x</span>
328
+ <span class="cline-any cline-yes">1x</span>
329
+ <span class="cline-any cline-yes">1x</span>
330
+ <span class="cline-any cline-yes">1x</span>
331
+ <span class="cline-any cline-yes">1x</span>
332
+ <span class="cline-any cline-yes">1x</span>
333
+ <span class="cline-any cline-yes">1x</span>
334
+ <span class="cline-any cline-yes">1x</span>
335
+ <span class="cline-any cline-yes">1x</span>
336
+ <span class="cline-any cline-yes">10x</span>
337
+ <span class="cline-any cline-yes">10x</span>
338
+ <span class="cline-any cline-yes">10x</span>
339
+ <span class="cline-any cline-yes">10x</span>
340
+ <span class="cline-any cline-yes">10x</span>
341
+ <span class="cline-any cline-yes">10x</span>
342
+ <span class="cline-any cline-yes">10x</span>
343
+ <span class="cline-any cline-yes">10x</span>
344
+ <span class="cline-any cline-yes">10x</span>
345
+ <span class="cline-any cline-yes">10x</span>
346
+ <span class="cline-any cline-yes">10x</span>
347
+ <span class="cline-any cline-yes">10x</span>
348
+ <span class="cline-any cline-yes">10x</span>
349
+ <span class="cline-any cline-yes">10x</span>
350
+ <span class="cline-any cline-yes">10x</span>
351
+ <span class="cline-any cline-yes">10x</span>
352
+ <span class="cline-any cline-yes">2x</span>
353
+ <span class="cline-any cline-yes">2x</span>
354
+ <span class="cline-any cline-yes">2x</span>
355
+ <span class="cline-any cline-yes">2x</span>
356
+ <span class="cline-any cline-yes">2x</span>
357
+ <span class="cline-any cline-yes">2x</span>
358
+ <span class="cline-any cline-yes">2x</span>
359
+ <span class="cline-any cline-yes">8x</span>
360
+ <span class="cline-any cline-yes">8x</span>
361
+ <span class="cline-any cline-yes">8x</span>
362
+ <span class="cline-any cline-yes">8x</span>
363
+ <span class="cline-any cline-yes">8x</span>
364
+ <span class="cline-any cline-yes">10x</span>
365
+ <span class="cline-any cline-yes">10x</span>
366
+ <span class="cline-any cline-yes">10x</span>
367
+ <span class="cline-any cline-yes">10x</span>
368
+ <span class="cline-any cline-yes">10x</span>
369
+ <span class="cline-any cline-yes">10x</span>
370
+ <span class="cline-any cline-yes">10x</span>
371
+ <span class="cline-any cline-yes">10x</span>
372
+ <span class="cline-any cline-yes">10x</span>
373
+ <span class="cline-any cline-yes">10x</span>
374
+ <span class="cline-any cline-yes">10x</span>
375
+ <span class="cline-any cline-yes">10x</span>
376
+ <span class="cline-any cline-yes">10x</span>
377
+ <span class="cline-any cline-yes">10x</span>
378
+ <span class="cline-any cline-yes">10x</span>
379
+ <span class="cline-any cline-yes">8x</span>
380
+ <span class="cline-any cline-yes">8x</span>
381
+ <span class="cline-any cline-yes">8x</span>
382
+ <span class="cline-any cline-yes">8x</span>
383
+ <span class="cline-any cline-yes">8x</span>
384
+ <span class="cline-any cline-yes">8x</span>
385
+ <span class="cline-any cline-yes">8x</span>
386
+ <span class="cline-any cline-yes">8x</span>
387
+ <span class="cline-any cline-yes">8x</span>
388
+ <span class="cline-any cline-yes">8x</span>
389
+ <span class="cline-any cline-yes">8x</span>
390
+ <span class="cline-any cline-yes">8x</span>
391
+ <span class="cline-any cline-yes">8x</span>
392
+ <span class="cline-any cline-yes">8x</span>
393
+ <span class="cline-any cline-yes">8x</span>
394
+ <span class="cline-any cline-yes">8x</span>
395
+ <span class="cline-any cline-yes">8x</span>
396
+ <span class="cline-any cline-yes">8x</span>
397
+ <span class="cline-any cline-yes">8x</span>
398
+ <span class="cline-any cline-yes">8x</span>
399
+ <span class="cline-any cline-yes">8x</span>
400
+ <span class="cline-any cline-yes">8x</span>
401
+ <span class="cline-any cline-yes">8x</span>
402
+ <span class="cline-any cline-yes">1x</span>
403
+ <span class="cline-any cline-yes">1x</span>
404
+ <span class="cline-any cline-yes">1x</span>
405
+ <span class="cline-any cline-yes">1x</span>
406
+ <span class="cline-any cline-yes">10x</span>
407
+ <span class="cline-any cline-yes">10x</span>
408
+ <span class="cline-any cline-yes">10x</span>
409
+ <span class="cline-any cline-yes">10x</span>
410
+ <span class="cline-any cline-yes">10x</span>
411
+ <span class="cline-any cline-yes">10x</span>
412
+ <span class="cline-any cline-yes">9x</span>
413
+ <span class="cline-any cline-yes">9x</span>
414
+ <span class="cline-any cline-yes">9x</span>
415
+ <span class="cline-any cline-yes">10x</span>
416
+ <span class="cline-any cline-yes">1x</span>
417
+ <span class="cline-any cline-yes">1x</span>
418
+ <span class="cline-any cline-yes">1x</span>
419
+ <span class="cline-any cline-yes">1x</span>
420
+ <span class="cline-any cline-yes">1x</span>
421
+ <span class="cline-any cline-yes">1x</span>
422
+ <span class="cline-any cline-yes">1x</span>
423
+ <span class="cline-any cline-yes">1x</span>
424
+ <span class="cline-any cline-yes">1x</span>
425
+ <span class="cline-any cline-yes">1x</span>
426
+ <span class="cline-any cline-yes">1x</span>
427
+ <span class="cline-any cline-yes">1x</span>
428
+ <span class="cline-any cline-yes">1x</span>
429
+ <span class="cline-any cline-yes">1x</span>
430
+ <span class="cline-any cline-yes">1x</span>
431
+ <span class="cline-any cline-yes">1x</span>
432
+ <span class="cline-any cline-yes">1x</span>
433
+ <span class="cline-any cline-yes">1x</span>
434
+ <span class="cline-any cline-yes">1x</span>
435
+ <span class="cline-any cline-yes">1x</span>
436
+ <span class="cline-any cline-yes">1x</span>
437
+ <span class="cline-any cline-yes">1x</span>
438
+ <span class="cline-any cline-yes">1x</span>
439
+ <span class="cline-any cline-yes">1x</span>
440
+ <span class="cline-any cline-yes">1x</span>
441
+ <span class="cline-any cline-yes">1x</span>
442
+ <span class="cline-any cline-yes">9x</span>
443
+ <span class="cline-any cline-yes">9x</span>
444
+ <span class="cline-any cline-yes">9x</span>
445
+ <span class="cline-any cline-yes">9x</span>
446
+ <span class="cline-any cline-yes">9x</span>
447
+ <span class="cline-any cline-yes">9x</span>
448
+ <span class="cline-any cline-yes">9x</span>
449
+ <span class="cline-any cline-yes">9x</span>
450
+ <span class="cline-any cline-yes">9x</span>
451
+ <span class="cline-any cline-yes">9x</span>
452
+ <span class="cline-any cline-yes">9x</span>
453
+ <span class="cline-any cline-yes">9x</span>
454
+ <span class="cline-any cline-yes">9x</span>
455
+ <span class="cline-any cline-yes">9x</span>
456
+ <span class="cline-any cline-yes">9x</span>
457
+ <span class="cline-any cline-yes">9x</span>
458
+ <span class="cline-any cline-yes">9x</span>
459
+ <span class="cline-any cline-yes">9x</span>
460
+ <span class="cline-any cline-yes">3x</span>
461
+ <span class="cline-any cline-yes">3x</span>
462
+ <span class="cline-any cline-yes">3x</span>
463
+ <span class="cline-any cline-yes">3x</span>
464
+ <span class="cline-any cline-yes">3x</span>
465
+ <span class="cline-any cline-yes">3x</span>
466
+ <span class="cline-any cline-yes">3x</span>
467
+ <span class="cline-any cline-yes">3x</span>
468
+ <span class="cline-any cline-yes">6x</span>
469
+ <span class="cline-any cline-yes">6x</span>
470
+ <span class="cline-any cline-yes">6x</span>
471
+ <span class="cline-any cline-yes">6x</span>
472
+ <span class="cline-any cline-yes">6x</span>
473
+ <span class="cline-any cline-yes">9x</span>
474
+ <span class="cline-any cline-yes">9x</span>
475
+ <span class="cline-any cline-yes">9x</span>
476
+ <span class="cline-any cline-yes">9x</span>
477
+ <span class="cline-any cline-yes">9x</span>
478
+ <span class="cline-any cline-yes">9x</span>
479
+ <span class="cline-any cline-yes">9x</span>
480
+ <span class="cline-any cline-yes">9x</span>
481
+ <span class="cline-any cline-yes">9x</span>
482
+ <span class="cline-any cline-yes">9x</span>
483
+ <span class="cline-any cline-yes">9x</span>
484
+ <span class="cline-any cline-yes">9x</span>
485
+ <span class="cline-any cline-yes">9x</span>
486
+ <span class="cline-any cline-yes">9x</span>
487
+ <span class="cline-any cline-yes">9x</span>
488
+ <span class="cline-any cline-yes">9x</span>
489
+ <span class="cline-any cline-yes">9x</span>
490
+ <span class="cline-any cline-yes">9x</span>
491
+ <span class="cline-any cline-yes">8x</span>
492
+ <span class="cline-any cline-yes">8x</span>
493
+ <span class="cline-any cline-yes">8x</span>
494
+ <span class="cline-any cline-no">&nbsp;</span>
495
+ <span class="cline-any cline-yes">8x</span>
496
+ <span class="cline-any cline-yes">9x</span>
497
+ <span class="cline-any cline-no">&nbsp;</span>
498
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js"><span class="branch-0 cbranch-no" title="branch not covered" >/*</span>
499
+ ** MQTT+ -- MQTT Communication Patterns
500
+ ** Copyright (c) 2018-2026 Dr. Ralf S. Engelschall &lt;rse@engelschall.com&gt;
501
+ **
502
+ ** Permission is hereby granted, free of charge, to any person obtaining
503
+ ** a copy of this software and associated documentation files (the
504
+ ** "Software"), to deal in the Software without restriction, including
505
+ ** without limitation the rights to use, copy, modify, merge, publish,
506
+ ** distribute, sublicense, and/or sell copies of the Software, and to
507
+ ** permit persons to whom the Software is furnished to do so, subject to
508
+ ** the following conditions:
509
+ **
510
+ ** The above copyright notice and this permission notice shall be included
511
+ ** in all copies or substantial portions of the Software.
512
+ **
513
+ ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
514
+ ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
515
+ ** MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
516
+ ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
517
+ ** CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
518
+ ** TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
519
+ ** SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
520
+ */
521
+ &nbsp;
522
+ /* external requirements */
523
+ import type { IClientPublishOptions,
524
+ IClientSubscribeOptions } from "mqtt"
525
+ import { nanoid } from "nanoid"
526
+ &nbsp;
527
+ /* internal requirements */
528
+ import type { EventEmission } from "./mqtt-plus-msg"
529
+ import type { APISchema, EventKeys,
530
+ Registration } from "./mqtt-plus-api"
531
+ import type { WithInfo, InfoEvent } from "./mqtt-plus-info"
532
+ import { AuthTrait, type AuthOption } from "./mqtt-plus-auth"
533
+ import { Spool, ensureError } from "./mqtt-plus-error"
534
+ &nbsp;
535
+ /* Event Emission Trait */
536
+ export class EventTrait&lt;T extends APISchema = APISchema&gt; extends AuthTrait&lt;T&gt; {
537
+ /* register an event handler */
538
+ async event&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
539
+ name: K,
540
+ callback: WithInfo&lt;T[K], InfoEvent&gt;
541
+ ): Promise&lt;Registration&gt;
542
+ async event&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
543
+ config: {
544
+ name: K,
545
+ callback: WithInfo&lt;T[K], InfoEvent&gt;,
546
+ options?: Partial&lt;IClientSubscribeOptions&gt;,
547
+ share?: string,
548
+ auth?: AuthOption
549
+ }
550
+ ): Promise&lt;Registration&gt;
551
+ async event&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
552
+ nameOrConfig: K | {
553
+ name: K,
554
+ callback: WithInfo&lt;T[K], InfoEvent&gt;,
555
+ options?: Partial&lt;IClientSubscribeOptions&gt;,
556
+ share?: string,
557
+ auth?: AuthOption
558
+ },
559
+ ...args: any[]
560
+ ): Promise&lt;Registration&gt; {
561
+ /* determine actual parameters */
562
+ let name: K
563
+ let callback: WithInfo&lt;T[K], InfoEvent&gt;
564
+ let options: Partial&lt;IClientSubscribeOptions&gt; = {}
565
+ let share = this.options.share
566
+ let auth: AuthOption | undefined
567
+ if (typeof nameOrConfig === "object" &amp;&amp; nameOrConfig !== null) {
568
+ /* object-based API */
569
+ name = nameOrConfig.name
570
+ callback = nameOrConfig.callback
571
+ options = nameOrConfig.options ?? {}
572
+ share = nameOrConfig.share ?? this.options.share
573
+ auth = nameOrConfig.auth
574
+ }
575
+ else {
576
+ /* positional API */
577
+ name = nameOrConfig
578
+ callback = args[0]
579
+ }
580
+ &nbsp;
581
+ /* create resource spool */
582
+ const spool = new Spool()
583
+ &nbsp;
584
+ /* sanity check situation */
585
+ if (this.onRequest.has(`event-emission:${name}`))
586
+ throw new Error(`event: event "${name}" already registered`)
587
+ &nbsp;
588
+ /* generate the corresponding MQTT topics for broadcast and direct use */
589
+ const topicS = share !== "" ? `$share/${share}/${name}` : name
590
+ const topicB = this.options.topicMake(topicS, "event-emission")
591
+ const topicD = this.options.topicMake(name, "event-emission", this.options.id)
592
+ &nbsp;
593
+ /* remember the registration */
594
+ this.onRequest.set(`event-emission:${name}`, async (request: EventEmission, topicName: string) =&gt; {
595
+ /* determine event information */
596
+ const senderId = request.sender
597
+ if (senderId === undefined || senderId === "")
598
+ <span class="branch-0 cbranch-no" title="branch not covered" > throw new Error("invalid request: missing sender")</span>
599
+ const params = request.<span class="branch-0 cbranch-no" title="branch not covered" >params ?? []</span>
600
+ &nbsp;
601
+ /* create information object */
602
+ const info: InfoEvent = { sender: senderId }
603
+ if (request.receiver)
604
+ <span class="branch-0 cbranch-no" title="branch not covered" > info.receiver = request.receiver</span>
605
+ if (request.meta)
606
+ info.meta = request.meta
607
+ &nbsp;
608
+ /* asynchronously execute handler */
609
+ try {
610
+ if (topicName !== request.name)
611
+ <span class="branch-0 cbranch-no" title="branch not covered" > throw new Error(`event name mismatch (topic: "${topicName}", payload: "${request.name}")`)</span>
612
+ if (auth)
613
+ <span class="branch-0 cbranch-no" title="branch not covered" > info.authenticated = await this.authenticated(senderId, request.auth, auth)</span>
614
+ if (info.authenticated !== <span class="branch-0 cbranch-no" title="branch not covered" >undefined &amp;&amp; !info.authenticated)</span>
615
+ <span class="branch-0 cbranch-no" title="branch not covered" > throw new Error(`event "${name}" failed authentication`)</span>
616
+ await callback(...params, info)
617
+ }
618
+ catch (result: unknown) {
619
+ const error = ensureError(result)
620
+ this.error(error, `handler for event "${name}" failed`)
621
+ }
622
+ })
623
+ spool.roll(() =&gt; { this.onRequest.delete(`event-emission:${name}`) })
624
+ &nbsp;
625
+ /* subscribe to MQTT topics */
626
+ await this.subscribeTopicAndSpool(spool, topicB, options)
627
+ await this.subscribeTopicAndSpool(spool, topicD, options)
628
+ &nbsp;
629
+ /* provide a registration for subsequent destruction */
630
+ return this.makeRegistration(spool, "event", name, `event-emission:${name}`)
631
+ }
632
+ &nbsp;
633
+ /* emit event ("fire and forget") */
634
+ emit&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
635
+ name: K,
636
+ ...params: Parameters&lt;T[K]&gt;
637
+ ): void
638
+ emit&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
639
+ config: {
640
+ name: K,
641
+ params: Parameters&lt;T[K]&gt;,
642
+ receiver?: string,
643
+ options?: IClientPublishOptions,
644
+ meta?: Record&lt;string, any&gt;
645
+ }
646
+ ): void
647
+ emit&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
648
+ config: {
649
+ name: K,
650
+ params: Parameters&lt;T[K]&gt;,
651
+ receiver?: string,
652
+ options?: IClientPublishOptions,
653
+ meta?: Record&lt;string, any&gt;,
654
+ dry: true
655
+ }
656
+ ): { topic: string, payload: string | Uint8Array, options: IClientPublishOptions }
657
+ emit&lt;K extends EventKeys&lt;T&gt; &amp; string&gt; (
658
+ nameOrConfig: K | {
659
+ name: K,
660
+ params: Parameters&lt;T[K]&gt;,
661
+ receiver?: string,
662
+ options?: IClientPublishOptions,
663
+ meta?: Record&lt;string, any&gt;,
664
+ dry?: true
665
+ },
666
+ ...args: any[]
667
+ ): void | { topic: string, payload: string | Uint8Array, options: IClientPublishOptions } {
668
+ /* determine actual parameters */
669
+ let name: K
670
+ let params: Parameters&lt;T[K]&gt;
671
+ let receiver: string | undefined
672
+ let options: IClientPublishOptions = {}
673
+ let meta: Record&lt;string, any&gt; | undefined
674
+ let dry: boolean | undefined
675
+ if (typeof nameOrConfig === "object" &amp;&amp; nameOrConfig !== null) {
676
+ /* object-based API */
677
+ name = nameOrConfig.name
678
+ params = nameOrConfig.params
679
+ receiver = nameOrConfig.receiver
680
+ options = nameOrConfig.options ?? {}
681
+ meta = nameOrConfig.meta
682
+ dry = nameOrConfig.dry
683
+ }
684
+ else {
685
+ /* positional API */
686
+ name = nameOrConfig
687
+ params = args as Parameters&lt;T[K]&gt;
688
+ }
689
+ &nbsp;
690
+ /* generate unique request id */
691
+ const requestId = nanoid()
692
+ &nbsp;
693
+ /* generate encoded message */
694
+ const auth = this.authenticate()
695
+ const metaStore = this.metaStore(meta)
696
+ const request = this.msg.makeEventEmission(requestId, name, params,
697
+ this.options.id, receiver, auth, metaStore)
698
+ const message = this.codec.encode(request)
699
+ &nbsp;
700
+ /* generate corresponding MQTT topic */
701
+ const topic = this.options.topicMake(name, "event-emission", receiver)
702
+ &nbsp;
703
+ /* produce result */
704
+ if (dry)
705
+ /* return publish information */
706
+ return { topic, payload: message, options: { qos: 2, ...options } }
707
+ else
708
+ /* publish message to MQTT topic */
709
+ this.publishToTopic(topic, message, { qos: 2, ...options }).catch((err: Error) =&gt; {
710
+ <span class="cstat-no" title="statement not covered" > this.error(err, `emitting event "${name}" failed`)</span>
711
+ })
712
+ }
713
+ <span class="cstat-no" title="statement not covered" ><span class="branch-0 cbranch-no" title="branch not covered" >}</span></span>
714
+ &nbsp;</pre></td></tr></table></pre>
715
+
716
+ <div class='push'></div><!-- for sticky footer -->
717
+ </div><!-- /wrapper -->
718
+ <div class='footer quiet pad2 space-top1 center small'>
719
+ Code coverage generated by
720
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
721
+ at 2026-03-14T22:41:38.599Z
722
+ </div>
723
+ <script src="prettify.js"></script>
724
+ <script>
725
+ window.onload = function () {
726
+ prettyPrint();
727
+ };
728
+ </script>
729
+ <script src="sorter.js"></script>
730
+ <script src="block-navigation.js"></script>
731
+ </body>
732
+ </html>
733
+