@photostructure/fs-metadata 0.5.0 → 0.5.1

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 (130) hide show
  1. package/C++_REVIEW_TODO.md +1 -1
  2. package/CHANGELOG.md +11 -2
  3. package/CLAUDE.md +269 -92
  4. package/CONTRIBUTING.md +41 -0
  5. package/README.md +20 -1
  6. package/WINDOWS_DEBUG_GUIDE.md +89 -0
  7. package/binding.gyp +3 -2
  8. package/dist/index.cjs +1440 -0
  9. package/dist/index.cjs.map +1 -0
  10. package/dist/index.d.cts +360 -0
  11. package/dist/index.d.mts +360 -0
  12. package/dist/index.d.ts +360 -0
  13. package/dist/index.mjs +1398 -0
  14. package/dist/index.mjs.map +1 -0
  15. package/jest.config.cjs +1 -0
  16. package/package.json +25 -27
  17. package/prebuilds/darwin-arm64/@photostructure+fs-metadata.glibc.node +0 -0
  18. package/prebuilds/linux-arm64/@photostructure+fs-metadata.glibc.node +0 -0
  19. package/prebuilds/linux-arm64/@photostructure+fs-metadata.musl.node +0 -0
  20. package/prebuilds/linux-x64/@photostructure+fs-metadata.glibc.node +0 -0
  21. package/prebuilds/linux-x64/@photostructure+fs-metadata.musl.node +0 -0
  22. package/prebuilds/win32-x64/@photostructure+fs-metadata.glibc.node +0 -0
  23. package/scripts/check-memory.mjs +53 -173
  24. package/scripts/clang-tidy.ts +241 -0
  25. package/scripts/prebuild-linux-glibc.sh +108 -0
  26. package/scripts/precommit.ts +45 -0
  27. package/scripts/sanitizers-test.sh +157 -0
  28. package/scripts/{configure.mjs → setup-native.mjs} +4 -1
  29. package/scripts/valgrind-test.mjs +1 -1
  30. package/scripts/{valgrind.sh → valgrind-test.sh} +15 -0
  31. package/src/binding.cpp +1 -1
  32. package/src/common/error_utils.h +17 -0
  33. package/src/common/metadata_worker.h +4 -1
  34. package/src/darwin/hidden.cpp +13 -6
  35. package/src/darwin/volume_metadata.cpp +2 -2
  36. package/src/darwin/volume_mount_points.cpp +8 -1
  37. package/src/linux/blkid_cache.cpp +8 -2
  38. package/src/linux/volume_metadata.cpp +1 -1
  39. package/src/platform.ts +25 -0
  40. package/src/test-utils/benchmark-harness.ts +192 -0
  41. package/src/test-utils/debuglog-child.ts +30 -2
  42. package/src/test-utils/debuglog-enabled-child.ts +38 -8
  43. package/src/test-utils/jest-setup.ts +14 -0
  44. package/src/test-utils/worker-thread-helper.cjs +92 -0
  45. package/src/windows/hidden.cpp +20 -11
  46. package/coverage/base.css +0 -224
  47. package/coverage/block-navigation.js +0 -87
  48. package/coverage/favicon.png +0 -0
  49. package/coverage/index.html +0 -131
  50. package/coverage/lcov-report/base.css +0 -224
  51. package/coverage/lcov-report/block-navigation.js +0 -87
  52. package/coverage/lcov-report/favicon.png +0 -0
  53. package/coverage/lcov-report/index.html +0 -131
  54. package/coverage/lcov-report/prettify.css +0 -1
  55. package/coverage/lcov-report/prettify.js +0 -2
  56. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  57. package/coverage/lcov-report/sorter.js +0 -196
  58. package/coverage/lcov-report/src/array.ts.html +0 -217
  59. package/coverage/lcov-report/src/async.ts.html +0 -547
  60. package/coverage/lcov-report/src/debuglog.ts.html +0 -187
  61. package/coverage/lcov-report/src/defer.ts.html +0 -175
  62. package/coverage/lcov-report/src/dirname.ts.html +0 -124
  63. package/coverage/lcov-report/src/error.ts.html +0 -322
  64. package/coverage/lcov-report/src/fs.ts.html +0 -316
  65. package/coverage/lcov-report/src/glob.ts.html +0 -472
  66. package/coverage/lcov-report/src/hidden.ts.html +0 -724
  67. package/coverage/lcov-report/src/index.html +0 -521
  68. package/coverage/lcov-report/src/index.ts.html +0 -676
  69. package/coverage/lcov-report/src/linux/dev_disk.ts.html +0 -316
  70. package/coverage/lcov-report/src/linux/index.html +0 -146
  71. package/coverage/lcov-report/src/linux/mount_points.ts.html +0 -364
  72. package/coverage/lcov-report/src/linux/mtab.ts.html +0 -493
  73. package/coverage/lcov-report/src/mount_point.ts.html +0 -106
  74. package/coverage/lcov-report/src/number.ts.html +0 -148
  75. package/coverage/lcov-report/src/object.ts.html +0 -265
  76. package/coverage/lcov-report/src/options.ts.html +0 -475
  77. package/coverage/lcov-report/src/path.ts.html +0 -268
  78. package/coverage/lcov-report/src/platform.ts.html +0 -112
  79. package/coverage/lcov-report/src/random.ts.html +0 -205
  80. package/coverage/lcov-report/src/remote_info.ts.html +0 -553
  81. package/coverage/lcov-report/src/stack_path.ts.html +0 -298
  82. package/coverage/lcov-report/src/string.ts.html +0 -382
  83. package/coverage/lcov-report/src/string_enum.ts.html +0 -208
  84. package/coverage/lcov-report/src/system_volume.ts.html +0 -301
  85. package/coverage/lcov-report/src/unc.ts.html +0 -274
  86. package/coverage/lcov-report/src/units.ts.html +0 -274
  87. package/coverage/lcov-report/src/uuid.ts.html +0 -157
  88. package/coverage/lcov-report/src/volume_health_status.ts.html +0 -259
  89. package/coverage/lcov-report/src/volume_metadata.ts.html +0 -787
  90. package/coverage/lcov-report/src/volume_mount_points.ts.html +0 -388
  91. package/coverage/lcov.info +0 -3581
  92. package/coverage/prettify.css +0 -1
  93. package/coverage/prettify.js +0 -2
  94. package/coverage/sort-arrow-sprite.png +0 -0
  95. package/coverage/sorter.js +0 -196
  96. package/coverage/src/array.ts.html +0 -217
  97. package/coverage/src/async.ts.html +0 -547
  98. package/coverage/src/debuglog.ts.html +0 -187
  99. package/coverage/src/defer.ts.html +0 -175
  100. package/coverage/src/dirname.ts.html +0 -124
  101. package/coverage/src/error.ts.html +0 -322
  102. package/coverage/src/fs.ts.html +0 -316
  103. package/coverage/src/glob.ts.html +0 -472
  104. package/coverage/src/hidden.ts.html +0 -724
  105. package/coverage/src/index.html +0 -521
  106. package/coverage/src/index.ts.html +0 -676
  107. package/coverage/src/linux/dev_disk.ts.html +0 -316
  108. package/coverage/src/linux/index.html +0 -146
  109. package/coverage/src/linux/mount_points.ts.html +0 -364
  110. package/coverage/src/linux/mtab.ts.html +0 -493
  111. package/coverage/src/mount_point.ts.html +0 -106
  112. package/coverage/src/number.ts.html +0 -148
  113. package/coverage/src/object.ts.html +0 -265
  114. package/coverage/src/options.ts.html +0 -475
  115. package/coverage/src/path.ts.html +0 -268
  116. package/coverage/src/platform.ts.html +0 -112
  117. package/coverage/src/random.ts.html +0 -205
  118. package/coverage/src/remote_info.ts.html +0 -553
  119. package/coverage/src/stack_path.ts.html +0 -298
  120. package/coverage/src/string.ts.html +0 -382
  121. package/coverage/src/string_enum.ts.html +0 -208
  122. package/coverage/src/system_volume.ts.html +0 -301
  123. package/coverage/src/unc.ts.html +0 -274
  124. package/coverage/src/units.ts.html +0 -274
  125. package/coverage/src/uuid.ts.html +0 -157
  126. package/coverage/src/volume_health_status.ts.html +0 -259
  127. package/coverage/src/volume_metadata.ts.html +0 -787
  128. package/coverage/src/volume_mount_points.ts.html +0 -388
  129. package/scripts/clang-tidy.mjs +0 -73
  130. package/scripts/run-asan.sh +0 -92
package/coverage/lcov-report/src/async.ts.html DELETED
@@ -1,547 +0,0 @@
1
-
2
- <!doctype html>
3
- <html lang="en">
4
-
5
- <head>
6
- <title>Code coverage report for src/async.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> / <a href="index.html">src</a> async.ts</h1>
23
- <div class='clearfix'>
24
-
25
- <div class='fl pad1y space-right2'>
26
- <span class="strong">98.7% </span>
27
- <span class="quiet">Statements</span>
28
- <span class='fraction'>152/154</span>
29
- </div>
30
-
31
-
32
- <div class='fl pad1y space-right2'>
33
- <span class="strong">96.96% </span>
34
- <span class="quiet">Branches</span>
35
- <span class='fraction'>32/33</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'>4/4</span>
43
- </div>
44
-
45
-
46
- <div class='fl pad1y space-right2'>
47
- <span class="strong">98.7% </span>
48
- <span class="quiet">Lines</span>
49
- <span class='fraction'>152/154</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></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
221
- <span class="cline-any cline-yes">1x</span>
222
- <span class="cline-any cline-yes">1x</span>
223
- <span class="cline-any cline-yes">1x</span>
224
- <span class="cline-any cline-yes">1x</span>
225
- <span class="cline-any cline-yes">1x</span>
226
- <span class="cline-any cline-yes">1x</span>
227
- <span class="cline-any cline-yes">1x</span>
228
- <span class="cline-any cline-yes">1x</span>
229
- <span class="cline-any cline-yes">1x</span>
230
- <span class="cline-any cline-yes">1x</span>
231
- <span class="cline-any cline-yes">1x</span>
232
- <span class="cline-any cline-yes">279x</span>
233
- <span class="cline-any cline-yes">279x</span>
234
- <span class="cline-any cline-yes">279x</span>
235
- <span class="cline-any cline-yes">279x</span>
236
- <span class="cline-any cline-yes">279x</span>
237
- <span class="cline-any cline-yes">279x</span>
238
- <span class="cline-any cline-yes">279x</span>
239
- <span class="cline-any cline-yes">1x</span>
240
- <span class="cline-any cline-yes">1x</span>
241
- <span class="cline-any cline-yes">1x</span>
242
- <span class="cline-any cline-yes">1x</span>
243
- <span class="cline-any cline-yes">1x</span>
244
- <span class="cline-any cline-yes">1x</span>
245
- <span class="cline-any cline-yes">1x</span>
246
- <span class="cline-any cline-yes">1x</span>
247
- <span class="cline-any cline-yes">1x</span>
248
- <span class="cline-any cline-yes">1x</span>
249
- <span class="cline-any cline-yes">1x</span>
250
- <span class="cline-any cline-yes">1x</span>
251
- <span class="cline-any cline-yes">1x</span>
252
- <span class="cline-any cline-yes">1x</span>
253
- <span class="cline-any cline-yes">1x</span>
254
- <span class="cline-any cline-yes">320x</span>
255
- <span class="cline-any cline-yes">320x</span>
256
- <span class="cline-any cline-yes">320x</span>
257
- <span class="cline-any cline-yes">320x</span>
258
- <span class="cline-any cline-yes">320x</span>
259
- <span class="cline-any cline-yes">320x</span>
260
- <span class="cline-any cline-yes">320x</span>
261
- <span class="cline-any cline-yes">8x</span>
262
- <span class="cline-any cline-yes">8x</span>
263
- <span class="cline-any cline-yes">8x</span>
264
- <span class="cline-any cline-yes">8x</span>
265
- <span class="cline-any cline-yes">8x</span>
266
- <span class="cline-any cline-yes">8x</span>
267
- <span class="cline-any cline-yes">312x</span>
268
- <span class="cline-any cline-yes">312x</span>
269
- <span class="cline-any cline-yes">312x</span>
270
- <span class="cline-any cline-yes">320x</span>
271
- <span class="cline-any cline-yes">2x</span>
272
- <span class="cline-any cline-yes">2x</span>
273
- <span class="cline-any cline-yes">2x</span>
274
- <span class="cline-any cline-yes">2x</span>
275
- <span class="cline-any cline-yes">310x</span>
276
- <span class="cline-any cline-yes">320x</span>
277
- <span class="cline-any cline-yes">1x</span>
278
- <span class="cline-any cline-yes">1x</span>
279
- <span class="cline-any cline-yes">1x</span>
280
- <span class="cline-any cline-yes">1x</span>
281
- <span class="cline-any cline-yes">1x</span>
282
- <span class="cline-any cline-yes">1x</span>
283
- <span class="cline-any cline-yes">309x</span>
284
- <span class="cline-any cline-yes">320x</span>
285
- <span class="cline-any cline-yes">31x</span>
286
- <span class="cline-any cline-yes">31x</span>
287
- <span class="cline-any cline-yes">278x</span>
288
- <span class="cline-any cline-yes">278x</span>
289
- <span class="cline-any cline-yes">278x</span>
290
- <span class="cline-any cline-yes">278x</span>
291
- <span class="cline-any cline-yes">278x</span>
292
- <span class="cline-any cline-yes">278x</span>
293
- <span class="cline-any cline-yes">278x</span>
294
- <span class="cline-any cline-yes">320x</span>
295
- <span class="cline-any cline-yes">33x</span>
296
- <span class="cline-any cline-yes">33x</span>
297
- <span class="cline-any cline-yes">33x</span>
298
- <span class="cline-any cline-yes">33x</span>
299
- <span class="cline-any cline-yes">245x</span>
300
- <span class="cline-any cline-yes">245x</span>
301
- <span class="cline-any cline-yes">245x</span>
302
- <span class="cline-any cline-yes">245x</span>
303
- <span class="cline-any cline-yes">245x</span>
304
- <span class="cline-any cline-yes">245x</span>
305
- <span class="cline-any cline-yes">243x</span>
306
- <span class="cline-any cline-yes">235x</span>
307
- <span class="cline-any cline-yes">235x</span>
308
- <span class="cline-any cline-yes">235x</span>
309
- <span class="cline-any cline-yes">245x</span>
310
- <span class="cline-any cline-yes">245x</span>
311
- <span class="cline-any cline-yes">245x</span>
312
- <span class="cline-any cline-yes">245x</span>
313
- <span class="cline-any cline-yes">10x</span>
314
- <span class="cline-any cline-yes">10x</span>
315
- <span class="cline-any cline-yes">10x</span>
316
- <span class="cline-any cline-yes">10x</span>
317
- <span class="cline-any cline-yes">10x</span>
318
- <span class="cline-any cline-yes">245x</span>
319
- <span class="cline-any cline-yes">245x</span>
320
- <span class="cline-any cline-yes">245x</span>
321
- <span class="cline-any cline-yes">245x</span>
322
- <span class="cline-any cline-yes">245x</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">45x</span>
333
- <span class="cline-any cline-yes">45x</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">32x</span>
341
- <span class="cline-any cline-yes">32x</span>
342
- <span class="cline-any cline-yes">32x</span>
343
- <span class="cline-any cline-yes">32x</span>
344
- <span class="cline-any cline-yes">32x</span>
345
- <span class="cline-any cline-yes">32x</span>
346
- <span class="cline-any cline-yes">32x</span>
347
- <span class="cline-any cline-yes">32x</span>
348
- <span class="cline-any cline-yes">32x</span>
349
- <span class="cline-any cline-yes">32x</span>
350
- <span class="cline-any cline-yes">2x</span>
351
- <span class="cline-any cline-yes">2x</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">30x</span>
355
- <span class="cline-any cline-yes">32x</span>
356
- <span class="cline-any cline-no">&nbsp;</span>
357
- <span class="cline-any cline-no">&nbsp;</span>
358
- <span class="cline-any cline-yes">30x</span>
359
- <span class="cline-any cline-yes">30x</span>
360
- <span class="cline-any cline-yes">30x</span>
361
- <span class="cline-any cline-yes">30x</span>
362
- <span class="cline-any cline-yes">32x</span>
363
- <span class="cline-any cline-yes">196x</span>
364
- <span class="cline-any cline-yes">196x</span>
365
- <span class="cline-any cline-yes">58x</span>
366
- <span class="cline-any cline-yes">58x</span>
367
- <span class="cline-any cline-yes">196x</span>
368
- <span class="cline-any cline-yes">196x</span>
369
- <span class="cline-any cline-yes">196x</span>
370
- <span class="cline-any cline-yes">196x</span>
371
- <span class="cline-any cline-yes">30x</span>
372
- <span class="cline-any cline-yes">30x</span>
373
- <span class="cline-any cline-yes">30x</span>
374
- <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { availableParallelism } from "node:os";
375
- import { env } from "node:process";
376
- import { gt0, isNumber } from "./number";
377
- import { isBlank } from "./string";
378
- import { DayMs } from "./units";
379
- &nbsp;
380
- /**
381
- * An error that is thrown when a promise does not resolve within the specified
382
- * time.
383
- */
384
- export class TimeoutError extends Error {
385
- constructor(message: string, captureStackTrace = true) {
386
- super(message);
387
- this.name = "TimeoutError";
388
- // Capture the stack trace up to the calling site
389
- if (captureStackTrace &amp;&amp; Error.captureStackTrace) {
390
- Error.captureStackTrace(this, this.constructor);
391
- }
392
- }
393
- }
394
- /**
395
- * Rejects the promise with a TimeoutError if it does not resolve within the
396
- * specified time.
397
- *
398
- * @param promise The promise to wrap.
399
- * @param timeoutMs The timeout in milliseconds. Timeouts are disabled if this is 0.
400
- * @returns A promise that resolves when the input promise resolves, or rejects
401
- * with a TimeoutError if the input promise does not resolve within the
402
- * specified time.
403
- * @throws {TimeoutError} if the input promise does not resolve within the
404
- * specified time.
405
- * @throws {TypeError} if timeoutMs is not a number that is greater than 0.
406
- */
407
- export async function withTimeout&lt;T&gt;(opts: {
408
- desc?: string;
409
- promise: Promise&lt;T&gt;;
410
- timeoutMs: number;
411
- }): Promise&lt;T&gt; {
412
- const desc = isBlank(opts.desc) ? "thenOrTimeout()" : opts.desc;
413
- &nbsp;
414
- if (!isNumber(opts.timeoutMs)) {
415
- throw new TypeError(
416
- desc +
417
- ": Expected timeoutMs to be numeric, but got " +
418
- JSON.stringify(opts.timeoutMs),
419
- );
420
- }
421
- &nbsp;
422
- const timeoutMs = Math.floor(opts.timeoutMs);
423
- &nbsp;
424
- if (timeoutMs &lt; 0) {
425
- throw new TypeError(
426
- desc + ": Expected timeoutMs to be &gt; 0, but got " + timeoutMs,
427
- );
428
- }
429
- &nbsp;
430
- if (timeoutMs &gt; DayMs) {
431
- throw new TypeError(
432
- desc +
433
- ": Invalid timeoutMs is too large: must be less than one day, but got " +
434
- timeoutMs,
435
- );
436
- }
437
- &nbsp;
438
- if (timeoutMs === 0) {
439
- return opts.promise;
440
- }
441
- &nbsp;
442
- // Create error here to captured the caller's stack trace. If we create it in
443
- // the timeout callback, the stack trace will be truncated to this function.
444
- const timeoutError = new TimeoutError(
445
- `${desc}: timeout after ${timeoutMs}ms`,
446
- );
447
- &nbsp;
448
- if (env["NODE_ENV"] === "test" &amp;&amp; timeoutMs === 1) {
449
- timeoutError.message += "(timeout test)";
450
- opts.promise.catch(() =&gt; {}); // &lt; avoid unhandled rejection warnings
451
- throw timeoutError;
452
- }
453
- &nbsp;
454
- let timeoutId: NodeJS.Timeout | undefined;
455
- &nbsp;
456
- opts.promise
457
- .catch(() =&gt; {}) // &lt; avoid unhandled rejection warnings
458
- .finally(() =&gt; {
459
- if (timeoutId != null) {
460
- clearTimeout(timeoutId);
461
- timeoutId = undefined;
462
- }
463
- });
464
- &nbsp;
465
- const timeoutPromise = new Promise&lt;never&gt;((_, reject) =&gt; {
466
- timeoutId = setTimeout(() =&gt; {
467
- if (timeoutId != null) {
468
- timeoutError.message += "(timeout callback)";
469
- reject(timeoutError);
470
- }
471
- timeoutId = undefined;
472
- }, timeoutMs);
473
- });
474
- &nbsp;
475
- return Promise.race([opts.promise, timeoutPromise]);
476
- }
477
- &nbsp;
478
- /**
479
- * Delay for the specified number of milliseconds.
480
- *
481
- * @param ms The number of milliseconds to delay
482
- * @param t Optional value to resolve with after delay
483
- * @returns Promise that resolves with the provided value (or void if none provided)
484
- */
485
- export async function delay&lt;T = void&gt;(ms: number, t?: T): Promise&lt;T&gt; {
486
- return new Promise&lt;T&gt;((resolve) =&gt; setTimeout(() =&gt; resolve(t as T), ms));
487
- }
488
- &nbsp;
489
- /**
490
- * Apply `fn` to every item in `items` with a maximum concurrency of
491
- * `maxConcurrency`.
492
- */
493
- export async function mapConcurrent&lt;I, O&gt;({
494
- items,
495
- fn,
496
- maxConcurrency = availableParallelism(),
497
- }: {
498
- items: I[];
499
- fn: (t: I) =&gt; Promise&lt;O&gt;;
500
- maxConcurrency?: number;
501
- }): Promise&lt;(O | Error)[]&gt; {
502
- // Validate maxConcurrency
503
- if (!gt0(maxConcurrency)) {
504
- throw new Error(
505
- `maxConcurrency must be a positive integer, got: ${maxConcurrency}`,
506
- );
507
- }
508
- &nbsp;
509
- if (typeof fn !== "function") <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
510
- <span class="cstat-no" title="statement not covered" > throw new TypeError(`fn must be a function, got: ${typeof fn}`);</span>
511
- <span class="cstat-no" title="statement not covered" > }</span>
512
- &nbsp;
513
- const results: Promise&lt;O | Error&gt;[] = [];
514
- const executing: Set&lt;Promise&lt;void&gt;&gt; = new Set();
515
- &nbsp;
516
- for (const [index, item] of items.entries()) {
517
- // Create a wrapped promise that handles cleanup
518
- while (executing.size &gt;= maxConcurrency) {
519
- await Promise.race(executing);
520
- }
521
- const p = (results[index] = fn(item).catch((error) =&gt; error));
522
- executing.add(p);
523
- p.finally(() =&gt; executing.delete(p));
524
- }
525
- &nbsp;
526
- return Promise.all(results);
527
- }
528
- &nbsp;</pre></td></tr></table></pre>
529
-
530
- <div class='push'></div><!-- for sticky footer -->
531
- </div><!-- /wrapper -->
532
- <div class='footer quiet pad2 space-top1 center small'>
533
- Code coverage generated by
534
- <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
535
- at 2025-06-01T20:18:02.849Z
536
- </div>
537
- <script src="../prettify.js"></script>
538
- <script>
539
- window.onload = function () {
540
- prettyPrint();
541
- };
542
- </script>
543
- <script src="../sorter.js"></script>
544
- <script src="../block-navigation.js"></script>
545
- </body>
546
- </html>
547
-