topkat-utils 1.2.100 → 1.2.102

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 (43) hide show
  1. package/coverage/clover.xml +1767 -0
  2. package/coverage/coverage-final.json +16 -0
  3. package/coverage/lcov-report/base.css +224 -0
  4. package/coverage/lcov-report/block-navigation.js +87 -0
  5. package/coverage/lcov-report/clean-stack-trace.ts.html +205 -0
  6. package/coverage/lcov-report/config.ts.html +340 -0
  7. package/coverage/lcov-report/error-utils.ts.html +700 -0
  8. package/coverage/lcov-report/favicon.png +0 -0
  9. package/coverage/lcov-report/index.html +326 -0
  10. package/coverage/lcov-report/is-empty.ts.html +103 -0
  11. package/coverage/lcov-report/is-nodejs.ts.html +109 -0
  12. package/coverage/lcov-report/is-object.ts.html +91 -0
  13. package/coverage/lcov-report/isset.ts.html +91 -0
  14. package/coverage/lcov-report/logger-utils.ts.html +1156 -0
  15. package/coverage/lcov-report/loop-utils.ts.html +382 -0
  16. package/coverage/lcov-report/object-utils.ts.html +1393 -0
  17. package/coverage/lcov-report/prettify.css +1 -0
  18. package/coverage/lcov-report/prettify.js +2 -0
  19. package/coverage/lcov-report/regexp-utils.ts.html +205 -0
  20. package/coverage/lcov-report/remove-circular-json-stringify.ts.html +139 -0
  21. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  22. package/coverage/lcov-report/sorter.js +196 -0
  23. package/coverage/lcov-report/string-utils.ts.html +922 -0
  24. package/coverage/lcov-report/timer-utils.ts.html +289 -0
  25. package/coverage/lcov-report/transaction-utils.ts.html +268 -0
  26. package/coverage/lcov.info +2151 -0
  27. package/dist/jest.config.d.ts +7 -0
  28. package/dist/jest.config.js +21 -0
  29. package/dist/jest.config.js.map +1 -0
  30. package/dist/src/timer-utils.d.ts +2 -0
  31. package/dist/src/timer-utils.js +9 -1
  32. package/dist/src/timer-utils.js.map +1 -1
  33. package/dist/src/transaction-utils.js +3 -2
  34. package/dist/src/transaction-utils.js.map +1 -1
  35. package/dist/src/transaction-utils.spec.d.ts +1 -0
  36. package/dist/src/transaction-utils.spec.js +49 -0
  37. package/dist/src/transaction-utils.spec.js.map +1 -0
  38. package/jest.config.ts +22 -0
  39. package/package.json +14 -8
  40. package/src/timer-utils.ts +11 -0
  41. package/src/transaction-utils.spec.ts +74 -0
  42. package/src/transaction-utils.ts +3 -2
  43. package/tsconfig.json +2 -1
package/coverage/lcov-report/timer-utils.ts.html ADDED
@@ -0,0 +1,289 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for timer-utils.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> timer-utils.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">49.27% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>34/69</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">100% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>3/3</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">33.33% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>2/6</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">49.27% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>34/69</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 low'></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></td><td class="line-coverage quiet"><span class="cline-any cline-yes">2x</span>
135
+ <span class="cline-any cline-yes">2x</span>
136
+ <span class="cline-any cline-yes">2x</span>
137
+ <span class="cline-any cline-yes">2x</span>
138
+ <span class="cline-any cline-yes">2x</span>
139
+ <span class="cline-any cline-yes">2x</span>
140
+ <span class="cline-any cline-yes">2x</span>
141
+ <span class="cline-any cline-yes">2x</span>
142
+ <span class="cline-any cline-yes">2x</span>
143
+ <span class="cline-any cline-yes">2x</span>
144
+ <span class="cline-any cline-yes">2x</span>
145
+ <span class="cline-any cline-yes">2x</span>
146
+ <span class="cline-any cline-yes">2x</span>
147
+ <span class="cline-any cline-yes">2x</span>
148
+ <span class="cline-any cline-yes">2x</span>
149
+ <span class="cline-any cline-yes">2x</span>
150
+ <span class="cline-any cline-yes">2x</span>
151
+ <span class="cline-any cline-yes">2x</span>
152
+ <span class="cline-any cline-yes">2x</span>
153
+ <span class="cline-any cline-yes">2x</span>
154
+ <span class="cline-any cline-no">&nbsp;</span>
155
+ <span class="cline-any cline-no">&nbsp;</span>
156
+ <span class="cline-any cline-no">&nbsp;</span>
157
+ <span class="cline-any cline-no">&nbsp;</span>
158
+ <span class="cline-any cline-no">&nbsp;</span>
159
+ <span class="cline-any cline-no">&nbsp;</span>
160
+ <span class="cline-any cline-no">&nbsp;</span>
161
+ <span class="cline-any cline-no">&nbsp;</span>
162
+ <span class="cline-any cline-no">&nbsp;</span>
163
+ <span class="cline-any cline-no">&nbsp;</span>
164
+ <span class="cline-any cline-no">&nbsp;</span>
165
+ <span class="cline-any cline-no">&nbsp;</span>
166
+ <span class="cline-any cline-no">&nbsp;</span>
167
+ <span class="cline-any cline-yes">2x</span>
168
+ <span class="cline-any cline-yes">2x</span>
169
+ <span class="cline-any cline-yes">2x</span>
170
+ <span class="cline-any cline-yes">2x</span>
171
+ <span class="cline-any cline-yes">2x</span>
172
+ <span class="cline-any cline-yes">2x</span>
173
+ <span class="cline-any cline-yes">2x</span>
174
+ <span class="cline-any cline-yes">2x</span>
175
+ <span class="cline-any cline-yes">2x</span>
176
+ <span class="cline-any cline-yes">2x</span>
177
+ <span class="cline-any cline-yes">2x</span>
178
+ <span class="cline-any cline-no">&nbsp;</span>
179
+ <span class="cline-any cline-no">&nbsp;</span>
180
+ <span class="cline-any cline-no">&nbsp;</span>
181
+ <span class="cline-any cline-no">&nbsp;</span>
182
+ <span class="cline-any cline-no">&nbsp;</span>
183
+ <span class="cline-any cline-no">&nbsp;</span>
184
+ <span class="cline-any cline-no">&nbsp;</span>
185
+ <span class="cline-any cline-no">&nbsp;</span>
186
+ <span class="cline-any cline-no">&nbsp;</span>
187
+ <span class="cline-any cline-no">&nbsp;</span>
188
+ <span class="cline-any cline-no">&nbsp;</span>
189
+ <span class="cline-any cline-no">&nbsp;</span>
190
+ <span class="cline-any cline-no">&nbsp;</span>
191
+ <span class="cline-any cline-no">&nbsp;</span>
192
+ <span class="cline-any cline-yes">2x</span>
193
+ <span class="cline-any cline-yes">2x</span>
194
+ <span class="cline-any cline-yes">2x</span>
195
+ <span class="cline-any cline-no">&nbsp;</span>
196
+ <span class="cline-any cline-no">&nbsp;</span>
197
+ <span class="cline-any cline-no">&nbsp;</span>
198
+ <span class="cline-any cline-no">&nbsp;</span>
199
+ <span class="cline-any cline-no">&nbsp;</span>
200
+ <span class="cline-any cline-no">&nbsp;</span>
201
+ <span class="cline-any cline-no">&nbsp;</span>
202
+ <span class="cline-any cline-no">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">&nbsp;
203
+ //----------------------------------------
204
+ // TIMEOUT UTILS
205
+ //----------------------------------------
206
+ import { cliProgressBar, C } from './logger-utils'
207
+ import { DescriptiveError } from './error-utils'
208
+ &nbsp;
209
+ &nbsp;
210
+ export async function timeout(ms, fn = () =&gt; { /* */ }) { return new Promise(res =&gt; setTimeout(res, ms)).then(fn) }
211
+ &nbsp;
212
+ export <span class="fstat-no" title="function not covered" >async function runAsync(callback, milliseconds$ = 1) { return timeout(milliseconds$, callback) }</span>
213
+ &nbsp;
214
+ /**
215
+ *
216
+ * @param {Function} callback function that shall return ===true asynchronously
217
+ * @param {Number} timeoutSec default:10; general timeout in seconds
218
+ * @param {Boolean|String} errorAfterNSeconds default:true output an error in case of timeout, can be the displayed error message
219
+ * @param {*} cliOutput write a cli progress to show that a process is running
220
+ */
221
+ export <span class="fstat-no" title="function not covered" >async function waitUntilTrue(callback, timeoutSec = 10, errorAfterNSeconds = true, cliOutput = true) {</span>
222
+ <span class="cstat-no" title="statement not covered" > let generalTimeout = true</span>
223
+ <span class="cstat-no" title="statement not covered" > let step = 3</span>
224
+ <span class="cstat-no" title="statement not covered" > const errMess = typeof errorAfterNSeconds === 'string' ? 'Timeout: ' + errorAfterNSeconds : 'Timeout for waitUntilTrue() callback'</span>
225
+ <span class="cstat-no" title="statement not covered" ></span>
226
+ <span class="cstat-no" title="statement not covered" > if (timeoutSec) setTimeout(() =&gt; generalTimeout = false, timeoutSec * 1000)</span>
227
+ <span class="cstat-no" title="statement not covered" ></span>
228
+ <span class="cstat-no" title="statement not covered" > while (callback() !== true &amp;&amp; generalTimeout) {</span>
229
+ <span class="cstat-no" title="statement not covered" > if (cliOutput) cliProgressBar(step++)</span>
230
+ <span class="cstat-no" title="statement not covered" > await timeout(300)</span>
231
+ <span class="cstat-no" title="statement not covered" > }</span>
232
+ <span class="cstat-no" title="statement not covered" > if (cliOutput) process.stdout.write(`\n`)</span>
233
+ <span class="cstat-no" title="statement not covered" > if (!generalTimeout &amp;&amp; errorAfterNSeconds) throw new DescriptiveError(errMess, { code: 500 })</span>
234
+ <span class="cstat-no" title="statement not covered" >}</span>
235
+ &nbsp;
236
+ &nbsp;
237
+ const delayedLoopParams: [any, number, any][] = []
238
+ let isExecuting = false
239
+ &nbsp;
240
+ /** Allow to perform an action in a delayed loop, useful for example to avoid reaching limits on servers. This function can be securely called multiple times.
241
+ * @param {Function} callback
242
+ * @param {Number} time default: 500ms;
243
+ * @param {Function} errorCallback default: e =&gt; C.error(e)
244
+ */
245
+ export <span class="fstat-no" title="function not covered" >async function executeInDelayedLoop(callback, time = 500, errorCallback = e =&gt; C.error(e)) {</span>
246
+ <span class="cstat-no" title="statement not covered" > delayedLoopParams.push([callback, time, errorCallback])</span>
247
+ <span class="cstat-no" title="statement not covered" > if (isExecuting) return</span>
248
+ <span class="cstat-no" title="statement not covered" > isExecuting = true</span>
249
+ <span class="cstat-no" title="statement not covered" > while (delayedLoopParams.length) {</span>
250
+ <span class="cstat-no" title="statement not covered" > const [callback, time, errorCallback] = delayedLoopParams.shift() as any</span>
251
+ <span class="cstat-no" title="statement not covered" > try {</span>
252
+ <span class="cstat-no" title="statement not covered" > await callback()</span>
253
+ <span class="cstat-no" title="statement not covered" > await timeout(time)</span>
254
+ <span class="cstat-no" title="statement not covered" > } catch (err) {</span>
255
+ <span class="cstat-no" title="statement not covered" > errorCallback(err)</span>
256
+ <span class="cstat-no" title="statement not covered" > }</span>
257
+ <span class="cstat-no" title="statement not covered" > }</span>
258
+ <span class="cstat-no" title="statement not covered" > isExecuting = false</span>
259
+ <span class="cstat-no" title="statement not covered" >}</span>
260
+ &nbsp;
261
+ /** Will first wait before calling callback every seconds configured in retrySeconds array */
262
+ export <span class="fstat-no" title="function not covered" >async function retryWithDelay(</span>
263
+ <span class="cstat-no" title="statement not covered" > callback: Function,</span>
264
+ <span class="cstat-no" title="statement not covered" > retrySeconds: number[]</span>
265
+ <span class="cstat-no" title="statement not covered" >) {</span>
266
+ <span class="cstat-no" title="statement not covered" > for (const n of retrySeconds) {</span>
267
+ <span class="cstat-no" title="statement not covered" > await timeout(n * 1000)</span>
268
+ <span class="cstat-no" title="statement not covered" > await callback()</span>
269
+ <span class="cstat-no" title="statement not covered" > }</span>
270
+ <span class="cstat-no" title="statement not covered" >}</span></pre></td></tr></table></pre>
271
+
272
+ <div class='push'></div><!-- for sticky footer -->
273
+ </div><!-- /wrapper -->
274
+ <div class='footer quiet pad2 space-top1 center small'>
275
+ Code coverage generated by
276
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
277
+ at 2024-08-30T12:49:01.025Z
278
+ </div>
279
+ <script src="prettify.js"></script>
280
+ <script>
281
+ window.onload = function () {
282
+ prettyPrint();
283
+ };
284
+ </script>
285
+ <script src="sorter.js"></script>
286
+ <script src="block-navigation.js"></script>
287
+ </body>
288
+ </html>
289
+
package/coverage/lcov-report/transaction-utils.ts.html ADDED
@@ -0,0 +1,268 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for transaction-utils.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> transaction-utils.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">80.64% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>50/62</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">76.92% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>10/13</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">66.66% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>2/3</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">80.64% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>50/62</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></td><td class="line-coverage quiet"><span class="cline-any cline-yes">2x</span>
128
+ <span class="cline-any cline-yes">2x</span>
129
+ <span class="cline-any cline-yes">2x</span>
130
+ <span class="cline-any cline-yes">2x</span>
131
+ <span class="cline-any cline-yes">2x</span>
132
+ <span class="cline-any cline-yes">2x</span>
133
+ <span class="cline-any cline-yes">2x</span>
134
+ <span class="cline-any cline-yes">2x</span>
135
+ <span class="cline-any cline-yes">2x</span>
136
+ <span class="cline-any cline-yes">2x</span>
137
+ <span class="cline-any cline-yes">2x</span>
138
+ <span class="cline-any cline-yes">2x</span>
139
+ <span class="cline-any cline-yes">2x</span>
140
+ <span class="cline-any cline-yes">2x</span>
141
+ <span class="cline-any cline-yes">2x</span>
142
+ <span class="cline-any cline-yes">2x</span>
143
+ <span class="cline-any cline-yes">2x</span>
144
+ <span class="cline-any cline-yes">2x</span>
145
+ <span class="cline-any cline-yes">2x</span>
146
+ <span class="cline-any cline-yes">16x</span>
147
+ <span class="cline-any cline-no">&nbsp;</span>
148
+ <span class="cline-any cline-no">&nbsp;</span>
149
+ <span class="cline-any cline-no">&nbsp;</span>
150
+ <span class="cline-any cline-yes">16x</span>
151
+ <span class="cline-any cline-yes">16x</span>
152
+ <span class="cline-any cline-yes">16x</span>
153
+ <span class="cline-any cline-yes">16x</span>
154
+ <span class="cline-any cline-yes">16x</span>
155
+ <span class="cline-any cline-yes">16x</span>
156
+ <span class="cline-any cline-yes">16x</span>
157
+ <span class="cline-any cline-yes">16x</span>
158
+ <span class="cline-any cline-yes">2x</span>
159
+ <span class="cline-any cline-yes">2x</span>
160
+ <span class="cline-any cline-yes">16x</span>
161
+ <span class="cline-any cline-yes">16x</span>
162
+ <span class="cline-any cline-yes">16x</span>
163
+ <span class="cline-any cline-yes">16x</span>
164
+ <span class="cline-any cline-yes">16x</span>
165
+ <span class="cline-any cline-no">&nbsp;</span>
166
+ <span class="cline-any cline-no">&nbsp;</span>
167
+ <span class="cline-any cline-yes">16x</span>
168
+ <span class="cline-any cline-yes">16x</span>
169
+ <span class="cline-any cline-yes">16x</span>
170
+ <span class="cline-any cline-yes">16x</span>
171
+ <span class="cline-any cline-yes">2x</span>
172
+ <span class="cline-any cline-yes">2x</span>
173
+ <span class="cline-any cline-yes">16x</span>
174
+ <span class="cline-any cline-yes">6x</span>
175
+ <span class="cline-any cline-yes">16x</span>
176
+ <span class="cline-any cline-yes">6x</span>
177
+ <span class="cline-any cline-yes">2x</span>
178
+ <span class="cline-any cline-yes">2x</span>
179
+ <span class="cline-any cline-yes">2x</span>
180
+ <span class="cline-any cline-yes">2x</span>
181
+ <span class="cline-any cline-yes">2x</span>
182
+ <span class="cline-any cline-no">&nbsp;</span>
183
+ <span class="cline-any cline-no">&nbsp;</span>
184
+ <span class="cline-any cline-no">&nbsp;</span>
185
+ <span class="cline-any cline-no">&nbsp;</span>
186
+ <span class="cline-any cline-no">&nbsp;</span>
187
+ <span class="cline-any cline-no">&nbsp;</span>
188
+ <span class="cline-any cline-no">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">//----------------------------------------
189
+ // TRANSACTION
190
+ //----------------------------------------
191
+ import { isset } from './isset'
192
+ import { C } from './logger-utils'
193
+ import { timeout } from './timer-utils'
194
+ &nbsp;
195
+ const transactionRunning = { __default: false }
196
+ const queue = { __default: [] }
197
+ &nbsp;
198
+ /** Allow to perform async functions in a defined order
199
+ * This adds the callback to a queue and is resolved when ALL previous callbacks with same name are executed
200
+ * Use it like: await transaction('nameOfTheFlow', async () =&gt; { ...myFunction })
201
+ * @param {String|Function} name name for the actions that should never happen concurrently
202
+ * @param {Function} asyncCallback
203
+ * @param {Number} timeout default: 120000 (120s) will throw an error if transaction time is higher that this amount of ms
204
+ * @returns {Promise}
205
+ */
206
+ export async function transaction(name, asyncCallback, timeout = 120000, doNotThrow = false) {
207
+ if (typeof name === 'function') <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
208
+ <span class="cstat-no" title="statement not covered" > asyncCallback = name</span>
209
+ <span class="cstat-no" title="statement not covered" > name = '__default'</span>
210
+ <span class="cstat-no" title="statement not covered" > }</span>
211
+ if (!isset(queue[name])) queue[name] = []
212
+ if (!isset(transactionRunning[name])) transactionRunning[name] = false
213
+ &nbsp;
214
+ return await new Promise((resolve, reject) =&gt; {
215
+ if (doNotThrow) <span class="branch-0 cbranch-no" title="branch not covered" >reject = C.error</span>
216
+ queue[name].push(async () =&gt; {
217
+ try {
218
+ const to = setTimeout(() =&gt; {
219
+ C.warning('Transaction Timeout') // in case not catched
220
+ reject(new Error('transactionTimeout'))
221
+ }, timeout)
222
+ const res = await asyncCallback()
223
+ clearTimeout(to)
224
+ resolve(res)
225
+ } <span class="branch-0 cbranch-no" title="branch not covered" >catch (err) {</span>
226
+ <span class="cstat-no" title="statement not covered" > reject(err)</span>
227
+ <span class="cstat-no" title="statement not covered" > }</span>
228
+ })
229
+ removeItemFromQueue(name)
230
+ })
231
+ }
232
+ &nbsp;
233
+ export async function removeItemFromQueue(name) {// meoww!
234
+ if (transactionRunning[name] === true) return // v
235
+ transactionRunning[name] = true // A A /\
236
+ while (queue[name].length) await queue[name].shift()() // ||
237
+ transactionRunning[name] = false // \==/_______||
238
+ } // l ____ *|
239
+ // 11 11
240
+ &nbsp;
241
+ /** Wait for a transaction to complete without creating a new transaction */
242
+ export <span class="fstat-no" title="function not covered" >async function waitForTransaction(transactionName, forceReleaseInSeconds = 30) {</span>
243
+ <span class="cstat-no" title="statement not covered" > let brk = false</span>
244
+ <span class="cstat-no" title="statement not covered" > setTimeout(() =&gt; brk = true, forceReleaseInSeconds * 1000)</span>
245
+ <span class="cstat-no" title="statement not covered" > while (isset(transactionRunning[transactionName]) &amp;&amp; transactionRunning[transactionName] === true) {</span>
246
+ <span class="cstat-no" title="statement not covered" > if (brk) break</span>
247
+ <span class="cstat-no" title="statement not covered" > await timeout(15)</span>
248
+ <span class="cstat-no" title="statement not covered" > }</span>
249
+ <span class="cstat-no" title="statement not covered" >}</span></pre></td></tr></table></pre>
250
+
251
+ <div class='push'></div><!-- for sticky footer -->
252
+ </div><!-- /wrapper -->
253
+ <div class='footer quiet pad2 space-top1 center small'>
254
+ Code coverage generated by
255
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
256
+ at 2024-08-30T12:49:01.025Z
257
+ </div>
258
+ <script src="prettify.js"></script>
259
+ <script>
260
+ window.onload = function () {
261
+ prettyPrint();
262
+ };
263
+ </script>
264
+ <script src="sorter.js"></script>
265
+ <script src="block-navigation.js"></script>
266
+ </body>
267
+ </html>
268
+