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-service.ts.html ADDED
@@ -0,0 +1,865 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for mqtt-plus-service.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-service.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">96.92% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>252/260</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">76.74% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>33/43</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">96.92% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>252/260</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>
283
+ <a name='L218'></a><a href='#L218'>218</a>
284
+ <a name='L219'></a><a href='#L219'>219</a>
285
+ <a name='L220'></a><a href='#L220'>220</a>
286
+ <a name='L221'></a><a href='#L221'>221</a>
287
+ <a name='L222'></a><a href='#L222'>222</a>
288
+ <a name='L223'></a><a href='#L223'>223</a>
289
+ <a name='L224'></a><a href='#L224'>224</a>
290
+ <a name='L225'></a><a href='#L225'>225</a>
291
+ <a name='L226'></a><a href='#L226'>226</a>
292
+ <a name='L227'></a><a href='#L227'>227</a>
293
+ <a name='L228'></a><a href='#L228'>228</a>
294
+ <a name='L229'></a><a href='#L229'>229</a>
295
+ <a name='L230'></a><a href='#L230'>230</a>
296
+ <a name='L231'></a><a href='#L231'>231</a>
297
+ <a name='L232'></a><a href='#L232'>232</a>
298
+ <a name='L233'></a><a href='#L233'>233</a>
299
+ <a name='L234'></a><a href='#L234'>234</a>
300
+ <a name='L235'></a><a href='#L235'>235</a>
301
+ <a name='L236'></a><a href='#L236'>236</a>
302
+ <a name='L237'></a><a href='#L237'>237</a>
303
+ <a name='L238'></a><a href='#L238'>238</a>
304
+ <a name='L239'></a><a href='#L239'>239</a>
305
+ <a name='L240'></a><a href='#L240'>240</a>
306
+ <a name='L241'></a><a href='#L241'>241</a>
307
+ <a name='L242'></a><a href='#L242'>242</a>
308
+ <a name='L243'></a><a href='#L243'>243</a>
309
+ <a name='L244'></a><a href='#L244'>244</a>
310
+ <a name='L245'></a><a href='#L245'>245</a>
311
+ <a name='L246'></a><a href='#L246'>246</a>
312
+ <a name='L247'></a><a href='#L247'>247</a>
313
+ <a name='L248'></a><a href='#L248'>248</a>
314
+ <a name='L249'></a><a href='#L249'>249</a>
315
+ <a name='L250'></a><a href='#L250'>250</a>
316
+ <a name='L251'></a><a href='#L251'>251</a>
317
+ <a name='L252'></a><a href='#L252'>252</a>
318
+ <a name='L253'></a><a href='#L253'>253</a>
319
+ <a name='L254'></a><a href='#L254'>254</a>
320
+ <a name='L255'></a><a href='#L255'>255</a>
321
+ <a name='L256'></a><a href='#L256'>256</a>
322
+ <a name='L257'></a><a href='#L257'>257</a>
323
+ <a name='L258'></a><a href='#L258'>258</a>
324
+ <a name='L259'></a><a href='#L259'>259</a>
325
+ <a name='L260'></a><a href='#L260'>260</a>
326
+ <a name='L261'></a><a href='#L261'>261</a></td><td class="line-coverage quiet"><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">1x</span>
337
+ <span class="cline-any cline-yes">1x</span>
338
+ <span class="cline-any cline-yes">1x</span>
339
+ <span class="cline-any cline-yes">1x</span>
340
+ <span class="cline-any cline-yes">1x</span>
341
+ <span class="cline-any cline-yes">1x</span>
342
+ <span class="cline-any cline-yes">1x</span>
343
+ <span class="cline-any cline-yes">1x</span>
344
+ <span class="cline-any cline-yes">1x</span>
345
+ <span class="cline-any cline-yes">1x</span>
346
+ <span class="cline-any cline-yes">1x</span>
347
+ <span class="cline-any cline-yes">1x</span>
348
+ <span class="cline-any cline-yes">1x</span>
349
+ <span class="cline-any cline-yes">1x</span>
350
+ <span class="cline-any cline-yes">1x</span>
351
+ <span class="cline-any cline-yes">1x</span>
352
+ <span class="cline-any cline-yes">1x</span>
353
+ <span class="cline-any cline-yes">1x</span>
354
+ <span class="cline-any cline-yes">1x</span>
355
+ <span class="cline-any cline-yes">1x</span>
356
+ <span class="cline-any cline-yes">1x</span>
357
+ <span class="cline-any cline-yes">1x</span>
358
+ <span class="cline-any cline-yes">1x</span>
359
+ <span class="cline-any cline-yes">1x</span>
360
+ <span class="cline-any cline-yes">1x</span>
361
+ <span class="cline-any cline-yes">1x</span>
362
+ <span class="cline-any cline-yes">1x</span>
363
+ <span class="cline-any cline-yes">1x</span>
364
+ <span class="cline-any cline-yes">1x</span>
365
+ <span class="cline-any cline-yes">1x</span>
366
+ <span class="cline-any cline-yes">1x</span>
367
+ <span class="cline-any cline-yes">1x</span>
368
+ <span class="cline-any cline-yes">1x</span>
369
+ <span class="cline-any cline-yes">1x</span>
370
+ <span class="cline-any cline-yes">1x</span>
371
+ <span class="cline-any cline-yes">1x</span>
372
+ <span class="cline-any cline-yes">1x</span>
373
+ <span class="cline-any cline-yes">1x</span>
374
+ <span class="cline-any cline-yes">1x</span>
375
+ <span class="cline-any cline-yes">1x</span>
376
+ <span class="cline-any cline-yes">1x</span>
377
+ <span class="cline-any cline-yes">1x</span>
378
+ <span class="cline-any cline-yes">1x</span>
379
+ <span class="cline-any cline-yes">1x</span>
380
+ <span class="cline-any cline-yes">1x</span>
381
+ <span class="cline-any cline-yes">1x</span>
382
+ <span class="cline-any cline-yes">7x</span>
383
+ <span class="cline-any cline-yes">7x</span>
384
+ <span class="cline-any cline-yes">7x</span>
385
+ <span class="cline-any cline-yes">7x</span>
386
+ <span class="cline-any cline-yes">7x</span>
387
+ <span class="cline-any cline-yes">7x</span>
388
+ <span class="cline-any cline-yes">7x</span>
389
+ <span class="cline-any cline-yes">7x</span>
390
+ <span class="cline-any cline-yes">7x</span>
391
+ <span class="cline-any cline-yes">7x</span>
392
+ <span class="cline-any cline-yes">7x</span>
393
+ <span class="cline-any cline-yes">7x</span>
394
+ <span class="cline-any cline-yes">7x</span>
395
+ <span class="cline-any cline-yes">7x</span>
396
+ <span class="cline-any cline-yes">7x</span>
397
+ <span class="cline-any cline-yes">7x</span>
398
+ <span class="cline-any cline-yes">3x</span>
399
+ <span class="cline-any cline-yes">3x</span>
400
+ <span class="cline-any cline-yes">3x</span>
401
+ <span class="cline-any cline-yes">3x</span>
402
+ <span class="cline-any cline-yes">3x</span>
403
+ <span class="cline-any cline-yes">3x</span>
404
+ <span class="cline-any cline-yes">3x</span>
405
+ <span class="cline-any cline-yes">4x</span>
406
+ <span class="cline-any cline-yes">4x</span>
407
+ <span class="cline-any cline-yes">4x</span>
408
+ <span class="cline-any cline-yes">4x</span>
409
+ <span class="cline-any cline-yes">4x</span>
410
+ <span class="cline-any cline-yes">7x</span>
411
+ <span class="cline-any cline-yes">7x</span>
412
+ <span class="cline-any cline-yes">7x</span>
413
+ <span class="cline-any cline-yes">7x</span>
414
+ <span class="cline-any cline-yes">7x</span>
415
+ <span class="cline-any cline-yes">7x</span>
416
+ <span class="cline-any cline-yes">7x</span>
417
+ <span class="cline-any cline-yes">7x</span>
418
+ <span class="cline-any cline-yes">7x</span>
419
+ <span class="cline-any cline-yes">7x</span>
420
+ <span class="cline-any cline-yes">7x</span>
421
+ <span class="cline-any cline-yes">7x</span>
422
+ <span class="cline-any cline-yes">7x</span>
423
+ <span class="cline-any cline-yes">7x</span>
424
+ <span class="cline-any cline-yes">7x</span>
425
+ <span class="cline-any cline-yes">11x</span>
426
+ <span class="cline-any cline-yes">11x</span>
427
+ <span class="cline-any cline-yes">11x</span>
428
+ <span class="cline-any cline-yes">11x</span>
429
+ <span class="cline-any cline-yes">11x</span>
430
+ <span class="cline-any cline-yes">11x</span>
431
+ <span class="cline-any cline-yes">11x</span>
432
+ <span class="cline-any cline-yes">11x</span>
433
+ <span class="cline-any cline-yes">11x</span>
434
+ <span class="cline-any cline-yes">11x</span>
435
+ <span class="cline-any cline-yes">11x</span>
436
+ <span class="cline-any cline-yes">11x</span>
437
+ <span class="cline-any cline-yes">11x</span>
438
+ <span class="cline-any cline-yes">11x</span>
439
+ <span class="cline-any cline-yes">11x</span>
440
+ <span class="cline-any cline-yes">11x</span>
441
+ <span class="cline-any cline-yes">11x</span>
442
+ <span class="cline-any cline-yes">11x</span>
443
+ <span class="cline-any cline-yes">11x</span>
444
+ <span class="cline-any cline-yes">11x</span>
445
+ <span class="cline-any cline-yes">11x</span>
446
+ <span class="cline-any cline-yes">11x</span>
447
+ <span class="cline-any cline-yes">11x</span>
448
+ <span class="cline-any cline-yes">11x</span>
449
+ <span class="cline-any cline-yes">11x</span>
450
+ <span class="cline-any cline-yes">11x</span>
451
+ <span class="cline-any cline-yes">7x</span>
452
+ <span class="cline-any cline-yes">7x</span>
453
+ <span class="cline-any cline-yes">7x</span>
454
+ <span class="cline-any cline-yes">7x</span>
455
+ <span class="cline-any cline-yes">7x</span>
456
+ <span class="cline-any cline-yes">11x</span>
457
+ <span class="cline-any cline-yes">11x</span>
458
+ <span class="cline-any cline-yes">4x</span>
459
+ <span class="cline-any cline-yes">4x</span>
460
+ <span class="cline-any cline-yes">4x</span>
461
+ <span class="cline-any cline-yes">4x</span>
462
+ <span class="cline-any cline-yes">4x</span>
463
+ <span class="cline-any cline-yes">4x</span>
464
+ <span class="cline-any cline-yes">4x</span>
465
+ <span class="cline-any cline-yes">4x</span>
466
+ <span class="cline-any cline-yes">4x</span>
467
+ <span class="cline-any cline-yes">4x</span>
468
+ <span class="cline-any cline-yes">4x</span>
469
+ <span class="cline-any cline-yes">4x</span>
470
+ <span class="cline-any cline-yes">4x</span>
471
+ <span class="cline-any cline-yes">4x</span>
472
+ <span class="cline-any cline-no">&nbsp;</span>
473
+ <span class="cline-any cline-no">&nbsp;</span>
474
+ <span class="cline-any cline-no">&nbsp;</span>
475
+ <span class="cline-any cline-yes">4x</span>
476
+ <span class="cline-any cline-yes">7x</span>
477
+ <span class="cline-any cline-yes">7x</span>
478
+ <span class="cline-any cline-yes">7x</span>
479
+ <span class="cline-any cline-yes">7x</span>
480
+ <span class="cline-any cline-yes">7x</span>
481
+ <span class="cline-any cline-yes">7x</span>
482
+ <span class="cline-any cline-yes">7x</span>
483
+ <span class="cline-any cline-yes">7x</span>
484
+ <span class="cline-any cline-yes">7x</span>
485
+ <span class="cline-any cline-yes">7x</span>
486
+ <span class="cline-any cline-yes">1x</span>
487
+ <span class="cline-any cline-yes">1x</span>
488
+ <span class="cline-any cline-yes">1x</span>
489
+ <span class="cline-any cline-yes">1x</span>
490
+ <span class="cline-any cline-yes">1x</span>
491
+ <span class="cline-any cline-yes">1x</span>
492
+ <span class="cline-any cline-yes">1x</span>
493
+ <span class="cline-any cline-yes">1x</span>
494
+ <span class="cline-any cline-yes">1x</span>
495
+ <span class="cline-any cline-yes">1x</span>
496
+ <span class="cline-any cline-yes">1x</span>
497
+ <span class="cline-any cline-yes">1x</span>
498
+ <span class="cline-any cline-yes">1x</span>
499
+ <span class="cline-any cline-yes">1x</span>
500
+ <span class="cline-any cline-yes">1x</span>
501
+ <span class="cline-any cline-yes">1x</span>
502
+ <span class="cline-any cline-yes">12x</span>
503
+ <span class="cline-any cline-yes">12x</span>
504
+ <span class="cline-any cline-yes">12x</span>
505
+ <span class="cline-any cline-yes">12x</span>
506
+ <span class="cline-any cline-yes">12x</span>
507
+ <span class="cline-any cline-yes">12x</span>
508
+ <span class="cline-any cline-yes">12x</span>
509
+ <span class="cline-any cline-yes">12x</span>
510
+ <span class="cline-any cline-yes">12x</span>
511
+ <span class="cline-any cline-yes">12x</span>
512
+ <span class="cline-any cline-yes">12x</span>
513
+ <span class="cline-any cline-yes">12x</span>
514
+ <span class="cline-any cline-yes">12x</span>
515
+ <span class="cline-any cline-yes">12x</span>
516
+ <span class="cline-any cline-yes">12x</span>
517
+ <span class="cline-any cline-yes">12x</span>
518
+ <span class="cline-any cline-yes">3x</span>
519
+ <span class="cline-any cline-yes">3x</span>
520
+ <span class="cline-any cline-yes">3x</span>
521
+ <span class="cline-any cline-yes">3x</span>
522
+ <span class="cline-any cline-yes">3x</span>
523
+ <span class="cline-any cline-yes">3x</span>
524
+ <span class="cline-any cline-yes">3x</span>
525
+ <span class="cline-any cline-yes">9x</span>
526
+ <span class="cline-any cline-yes">9x</span>
527
+ <span class="cline-any cline-yes">9x</span>
528
+ <span class="cline-any cline-yes">9x</span>
529
+ <span class="cline-any cline-yes">9x</span>
530
+ <span class="cline-any cline-yes">12x</span>
531
+ <span class="cline-any cline-yes">12x</span>
532
+ <span class="cline-any cline-yes">12x</span>
533
+ <span class="cline-any cline-yes">12x</span>
534
+ <span class="cline-any cline-yes">12x</span>
535
+ <span class="cline-any cline-yes">12x</span>
536
+ <span class="cline-any cline-yes">12x</span>
537
+ <span class="cline-any cline-yes">12x</span>
538
+ <span class="cline-any cline-yes">12x</span>
539
+ <span class="cline-any cline-yes">12x</span>
540
+ <span class="cline-any cline-yes">12x</span>
541
+ <span class="cline-any cline-yes">12x</span>
542
+ <span class="cline-any cline-yes">12x</span>
543
+ <span class="cline-any cline-yes">12x</span>
544
+ <span class="cline-any cline-yes">12x</span>
545
+ <span class="cline-any cline-yes">12x</span>
546
+ <span class="cline-any cline-yes">12x</span>
547
+ <span class="cline-any cline-yes">12x</span>
548
+ <span class="cline-any cline-yes">12x</span>
549
+ <span class="cline-any cline-yes">1x</span>
550
+ <span class="cline-any cline-yes">1x</span>
551
+ <span class="cline-any cline-yes">12x</span>
552
+ <span class="cline-any cline-yes">12x</span>
553
+ <span class="cline-any cline-yes">12x</span>
554
+ <span class="cline-any cline-yes">11x</span>
555
+ <span class="cline-any cline-yes">11x</span>
556
+ <span class="cline-any cline-yes">11x</span>
557
+ <span class="cline-any cline-yes">7x</span>
558
+ <span class="cline-any cline-yes">7x</span>
559
+ <span class="cline-any cline-yes">12x</span>
560
+ <span class="cline-any cline-yes">12x</span>
561
+ <span class="cline-any cline-yes">12x</span>
562
+ <span class="cline-any cline-yes">12x</span>
563
+ <span class="cline-any cline-yes">12x</span>
564
+ <span class="cline-any cline-yes">12x</span>
565
+ <span class="cline-any cline-yes">12x</span>
566
+ <span class="cline-any cline-yes">12x</span>
567
+ <span class="cline-any cline-yes">12x</span>
568
+ <span class="cline-any cline-yes">12x</span>
569
+ <span class="cline-any cline-yes">12x</span>
570
+ <span class="cline-any cline-yes">12x</span>
571
+ <span class="cline-any cline-yes">12x</span>
572
+ <span class="cline-any cline-yes">12x</span>
573
+ <span class="cline-any cline-yes">12x</span>
574
+ <span class="cline-any cline-yes">12x</span>
575
+ <span class="cline-any cline-yes">12x</span>
576
+ <span class="cline-any cline-yes">12x</span>
577
+ <span class="cline-any cline-yes">12x</span>
578
+ <span class="cline-any cline-no">&nbsp;</span>
579
+ <span class="cline-any cline-no">&nbsp;</span>
580
+ <span class="cline-any cline-no">&nbsp;</span>
581
+ <span class="cline-any cline-no">&nbsp;</span>
582
+ <span class="cline-any cline-yes">12x</span>
583
+ <span class="cline-any cline-yes">12x</span>
584
+ <span class="cline-any cline-yes">12x</span>
585
+ <span class="cline-any cline-no">&nbsp;</span>
586
+ <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>
587
+ ** MQTT+ -- MQTT Communication Patterns
588
+ ** Copyright (c) 2018-2026 Dr. Ralf S. Engelschall &lt;rse@engelschall.com&gt;
589
+ **
590
+ ** Permission is hereby granted, free of charge, to any person obtaining
591
+ ** a copy of this software and associated documentation files (the
592
+ ** "Software"), to deal in the Software without restriction, including
593
+ ** without limitation the rights to use, copy, modify, merge, publish,
594
+ ** distribute, sublicense, and/or sell copies of the Software, and to
595
+ ** permit persons to whom the Software is furnished to do so, subject to
596
+ ** the following conditions:
597
+ **
598
+ ** The above copyright notice and this permission notice shall be included
599
+ ** in all copies or substantial portions of the Software.
600
+ **
601
+ ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
602
+ ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
603
+ ** MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
604
+ ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
605
+ ** CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
606
+ ** TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
607
+ ** SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
608
+ */
609
+ &nbsp;
610
+ /* external requirements */
611
+ import type { IClientPublishOptions,
612
+ IClientSubscribeOptions } from "mqtt"
613
+ import { nanoid } from "nanoid"
614
+ &nbsp;
615
+ /* internal requirements */
616
+ import { run, Spool, ensureError } from "./mqtt-plus-error"
617
+ import type { ServiceCallRequest,
618
+ ServiceCallResponse } from "./mqtt-plus-msg"
619
+ import type { APISchema, ServiceKeys,
620
+ Registration } from "./mqtt-plus-api"
621
+ import type { WithInfo, InfoService } from "./mqtt-plus-info"
622
+ import { EventTrait } from "./mqtt-plus-event"
623
+ import type { AuthOption } from "./mqtt-plus-auth"
624
+ &nbsp;
625
+ /* Service Call Trait */
626
+ export class ServiceTrait&lt;T extends APISchema = APISchema&gt; extends EventTrait&lt;T&gt; {
627
+ /* register a service call handler */
628
+ async service&lt;K extends ServiceKeys&lt;T&gt; &amp; string&gt; (
629
+ name: K,
630
+ callback: WithInfo&lt;T[K], InfoService&gt;
631
+ ): Promise&lt;Registration&gt;
632
+ async service&lt;K extends ServiceKeys&lt;T&gt; &amp; string&gt; (
633
+ config: {
634
+ name: K,
635
+ callback: WithInfo&lt;T[K], InfoService&gt;,
636
+ options?: Partial&lt;IClientSubscribeOptions&gt;,
637
+ share?: string,
638
+ auth?: AuthOption
639
+ }
640
+ ): Promise&lt;Registration&gt;
641
+ async service&lt;K extends ServiceKeys&lt;T&gt; &amp; string&gt; (
642
+ nameOrConfig: K | {
643
+ name: K,
644
+ callback: WithInfo&lt;T[K], InfoService&gt;,
645
+ options?: Partial&lt;IClientSubscribeOptions&gt;,
646
+ share?: string,
647
+ auth?: AuthOption
648
+ },
649
+ ...args: any[]
650
+ ): Promise&lt;Registration&gt; {
651
+ /* determine actual parameters */
652
+ let name: K
653
+ let callback: WithInfo&lt;T[K], InfoService&gt;
654
+ let options: Partial&lt;IClientSubscribeOptions&gt; = {}
655
+ let share = this.options.share
656
+ let auth: AuthOption | undefined
657
+ if (typeof nameOrConfig === "object" &amp;&amp; nameOrConfig !== null) {
658
+ /* object-based API */
659
+ name = nameOrConfig.name
660
+ callback = nameOrConfig.callback
661
+ options = nameOrConfig.options ?? {}
662
+ share = nameOrConfig.share ?? this.options.share
663
+ auth = nameOrConfig.auth
664
+ }
665
+ else {
666
+ /* positional API */
667
+ name = nameOrConfig
668
+ callback = args[0]
669
+ }
670
+ &nbsp;
671
+ /* create a resource spool */
672
+ const spool = new Spool()
673
+ &nbsp;
674
+ /* sanity check situation */
675
+ if (this.onRequest.has(`service-call-request:${name}`))
676
+ <span class="branch-0 cbranch-no" title="branch not covered" > throw new Error(`service: service "${name}" already registered`)</span>
677
+ &nbsp;
678
+ /* generate the corresponding MQTT topics for broadcast and direct use */
679
+ const topicS = share !== "" ? `$share/${share}/${name<span class="branch-0 cbranch-no" title="branch not covered" >}` : name</span>
680
+ const topicB = this.options.topicMake(topicS, "service-call-request")
681
+ const topicD = this.options.topicMake(name, "service-call-request", this.options.id)
682
+ &nbsp;
683
+ /* remember the registration */
684
+ this.onRequest.set(`service-call-request:${name}`, async (request: ServiceCallRequest, topicName: string) =&gt; {
685
+ /* determine request information */
686
+ const requestId = request.id
687
+ const senderId = request.sender
688
+ if (senderId === undefined || senderId === "")
689
+ <span class="branch-0 cbranch-no" title="branch not covered" > throw new Error("invalid request: missing sender")</span>
690
+ const params = request.<span class="branch-0 cbranch-no" title="branch not covered" >params ?? []</span>
691
+ &nbsp;
692
+ /* create information object */
693
+ const info: InfoService = { sender: senderId }
694
+ if (request.receiver)
695
+ info.receiver = request.receiver
696
+ if (request.meta)
697
+ info.meta = request.meta
698
+ &nbsp;
699
+ /* execute handler and send response */
700
+ try {
701
+ if (topicName !== request.name)
702
+ <span class="branch-0 cbranch-no" title="branch not covered" > throw new Error(`service name mismatch (topic: "${topicName}", payload: "${request.name}")`)</span>
703
+ if (auth)
704
+ info.authenticated = await this.authenticated(senderId, request.auth, auth)
705
+ if (info.authenticated !== undefined &amp;&amp; !info.authenticated)
706
+ throw new Error(`service "${name}" failed authentication`)
707
+ const result = await callback(...params, info)
708
+ &nbsp;
709
+ /* create success response message */
710
+ const rpcResponse = this.msg.makeServiceCallResponse(requestId, result,
711
+ undefined, this.options.id, senderId)
712
+ &nbsp;
713
+ /* send response message */
714
+ const encoded = this.codec.encode(rpcResponse)
715
+ const topic = this.options.topicMake(name, "service-call-response", senderId)
716
+ await this.publishToTopic(topic, encoded, { qos: options.qos ?? 2 })
717
+ }
718
+ catch (err: unknown) {
719
+ const error = ensureError(err)
720
+ &nbsp;
721
+ /* create error response message */
722
+ this.error(error, `handler for service "${name}" failed`)
723
+ const rpcResponse = this.msg.makeServiceCallResponse(requestId, undefined,
724
+ error.message, this.options.id, senderId)
725
+ &nbsp;
726
+ /* send response message */
727
+ try {
728
+ const encoded = this.codec.encode(rpcResponse)
729
+ const topic = this.options.topicMake(name, "service-call-response", senderId)
730
+ await this.publishToTopic(topic, encoded, { qos: options.qos ?? 2 })
731
+ <span class="branch-0 cbranch-no" title="branch not covered" > }</span>
732
+ <span class="cstat-no" title="statement not covered" > catch (err2: unknown) {</span>
733
+ <span class="cstat-no" title="statement not covered" > this.error(ensureError(err2), `sending error response for service "${name}" failed`)</span>
734
+ <span class="cstat-no" title="statement not covered" > }</span>
735
+ }
736
+ })
737
+ spool.roll(() =&gt; { this.onRequest.delete(`service-call-request:${name}`) })
738
+ &nbsp;
739
+ /* subscribe to MQTT topics */
740
+ await this.subscribeTopicAndSpool(spool, topicB, options)
741
+ await this.subscribeTopicAndSpool(spool, topicD, options)
742
+ &nbsp;
743
+ /* provide a registration for subsequent destruction */
744
+ return this.makeRegistration(spool, "service", name, `service-call-request:${name}`)
745
+ }
746
+ &nbsp;
747
+ /* call service ("request and response") */
748
+ async call&lt;K extends ServiceKeys&lt;T&gt; &amp; string&gt; (
749
+ name: K,
750
+ ...params: Parameters&lt;T[K]&gt;
751
+ ): Promise&lt;ReturnType&lt;T[K]&gt;&gt;
752
+ async call&lt;K extends ServiceKeys&lt;T&gt; &amp; string&gt; (
753
+ config: {
754
+ name: K,
755
+ params: Parameters&lt;T[K]&gt;,
756
+ receiver?: string,
757
+ options?: IClientPublishOptions,
758
+ meta?: Record&lt;string, any&gt;
759
+ }
760
+ ): Promise&lt;ReturnType&lt;T[K]&gt;&gt;
761
+ async call&lt;K extends ServiceKeys&lt;T&gt; &amp; string&gt; (
762
+ nameOrConfig: K | {
763
+ name: K,
764
+ params: Parameters&lt;T[K]&gt;,
765
+ receiver?: string,
766
+ options?: IClientPublishOptions,
767
+ meta?: Record&lt;string, any&gt;
768
+ },
769
+ ...args: any[]
770
+ ): Promise&lt;ReturnType&lt;T[K]&gt;&gt; {
771
+ /* determine actual parameters */
772
+ let name: K
773
+ let params: Parameters&lt;T[K]&gt;
774
+ let receiver: string | undefined
775
+ let options: IClientPublishOptions = {}
776
+ let meta: Record&lt;string, any&gt; | undefined
777
+ if (typeof nameOrConfig === "object" &amp;&amp; nameOrConfig !== null) {
778
+ /* object-based API */
779
+ name = nameOrConfig.name
780
+ params = nameOrConfig.params
781
+ receiver = nameOrConfig.receiver
782
+ options = nameOrConfig.options ?? {}
783
+ meta = nameOrConfig.meta
784
+ }
785
+ else {
786
+ /* positional API */
787
+ name = nameOrConfig
788
+ params = args as Parameters&lt;T[K]&gt;
789
+ }
790
+ &nbsp;
791
+ /* create a resource spool */
792
+ const spool = new Spool()
793
+ &nbsp;
794
+ /* generate unique request id */
795
+ let requestId = nanoid()
796
+ while (this.onResponse.has(`service-call-response:${requestId}`))
797
+ <span class="branch-0 cbranch-no" title="branch not covered" > requestId = nanoid()</span>
798
+ &nbsp;
799
+ /* subscribe to MQTT response topic */
800
+ const responseTopic = this.options.topicMake(name, "service-call-response", this.options.id)
801
+ await this.subscribeTopicAndSpool(spool, responseTopic, { qos: options.qos ?? 2 })
802
+ &nbsp;
803
+ /* create promise for MQTT response handling */
804
+ const timerId = `service-call:${requestId}`
805
+ let rejectPromise!: (reason?: any) =&gt; void
806
+ const promise: Promise&lt;ReturnType&lt;T[K]&gt;&gt; = new Promise((resolve, reject) =&gt; {
807
+ rejectPromise = reject
808
+ this.timerRefresh(timerId, async () =&gt; {
809
+ await spool.unroll()
810
+ reject(new Error("communication timeout"))
811
+ })
812
+ spool.roll(() =&gt; { this.timerClear(timerId) })
813
+ this.onResponse.set(`service-call-response:${requestId}`, async (response: ServiceCallResponse) =&gt; {
814
+ await spool.unroll()
815
+ if (response.error !== undefined)
816
+ reject(new Error(response.error))
817
+ else
818
+ resolve(response.result)
819
+ })
820
+ spool.roll(() =&gt; { this.onResponse.delete(`service-call-response:${requestId}`) })
821
+ })
822
+ &nbsp;
823
+ /* generate encoded message */
824
+ const auth = this.authenticate()
825
+ const metaStore = this.metaStore(meta)
826
+ const request = this.msg.makeServiceCallRequest(requestId, name, params,
827
+ this.options.id, receiver, auth, metaStore)
828
+ const message = this.codec.encode(request)
829
+ &nbsp;
830
+ /* generate corresponding MQTT topic */
831
+ const topic = this.options.topicMake(name, "service-call-request", receiver)
832
+ &nbsp;
833
+ /* publish message to MQTT topic */
834
+ try {
835
+ await run(`publish service request as MQTT message to topic "${topic}"`, spool, () =&gt;
836
+ this.publishToTopic(topic, message, { qos: 2, ...options }))
837
+ <span class="branch-0 cbranch-no" title="branch not covered" > }</span>
838
+ <span class="cstat-no" title="statement not covered" > catch (err: unknown) {</span>
839
+ <span class="cstat-no" title="statement not covered" > rejectPromise(err)</span>
840
+ <span class="cstat-no" title="statement not covered" > return promise</span>
841
+ <span class="cstat-no" title="statement not covered" > }</span>
842
+ &nbsp;
843
+ return promise
844
+ }
845
+ <span class="cstat-no" title="statement not covered" ><span class="branch-0 cbranch-no" title="branch not covered" >}</span></span>
846
+ &nbsp;</pre></td></tr></table></pre>
847
+
848
+ <div class='push'></div><!-- for sticky footer -->
849
+ </div><!-- /wrapper -->
850
+ <div class='footer quiet pad2 space-top1 center small'>
851
+ Code coverage generated by
852
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
853
+ at 2026-03-14T22:41:38.599Z
854
+ </div>
855
+ <script src="prettify.js"></script>
856
+ <script>
857
+ window.onload = function () {
858
+ prettyPrint();
859
+ };
860
+ </script>
861
+ <script src="sorter.js"></script>
862
+ <script src="block-navigation.js"></script>
863
+ </body>
864
+ </html>
865
+