@photostructure/fs-metadata 0.3.3 → 0.5.0

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 (183) hide show
  1. package/C++_REVIEW_TODO.md +291 -0
  2. package/CHANGELOG.md +33 -1
  3. package/CLAUDE.md +169 -0
  4. package/CONTRIBUTING.md +25 -0
  5. package/coverage/base.css +224 -0
  6. package/coverage/block-navigation.js +87 -0
  7. package/coverage/favicon.png +0 -0
  8. package/coverage/index.html +131 -0
  9. package/coverage/lcov-report/base.css +224 -0
  10. package/coverage/lcov-report/block-navigation.js +87 -0
  11. package/coverage/lcov-report/favicon.png +0 -0
  12. package/coverage/lcov-report/index.html +131 -0
  13. package/coverage/lcov-report/prettify.css +1 -0
  14. package/coverage/lcov-report/prettify.js +2 -0
  15. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  16. package/coverage/lcov-report/sorter.js +196 -0
  17. package/coverage/lcov-report/src/array.ts.html +217 -0
  18. package/coverage/lcov-report/src/async.ts.html +547 -0
  19. package/coverage/lcov-report/src/debuglog.ts.html +187 -0
  20. package/coverage/lcov-report/src/defer.ts.html +175 -0
  21. package/coverage/lcov-report/src/dirname.ts.html +124 -0
  22. package/coverage/lcov-report/src/error.ts.html +322 -0
  23. package/coverage/lcov-report/src/fs.ts.html +316 -0
  24. package/coverage/lcov-report/src/glob.ts.html +472 -0
  25. package/coverage/lcov-report/src/hidden.ts.html +724 -0
  26. package/coverage/lcov-report/src/index.html +521 -0
  27. package/coverage/lcov-report/src/index.ts.html +676 -0
  28. package/coverage/lcov-report/src/linux/dev_disk.ts.html +316 -0
  29. package/coverage/lcov-report/src/linux/index.html +146 -0
  30. package/coverage/lcov-report/src/linux/mount_points.ts.html +364 -0
  31. package/coverage/lcov-report/src/linux/mtab.ts.html +493 -0
  32. package/coverage/lcov-report/src/mount_point.ts.html +106 -0
  33. package/coverage/lcov-report/src/number.ts.html +148 -0
  34. package/coverage/lcov-report/src/object.ts.html +265 -0
  35. package/coverage/lcov-report/src/options.ts.html +475 -0
  36. package/coverage/lcov-report/src/path.ts.html +268 -0
  37. package/coverage/lcov-report/src/platform.ts.html +112 -0
  38. package/coverage/lcov-report/src/random.ts.html +205 -0
  39. package/coverage/lcov-report/src/remote_info.ts.html +553 -0
  40. package/coverage/lcov-report/src/stack_path.ts.html +298 -0
  41. package/coverage/lcov-report/src/string.ts.html +382 -0
  42. package/coverage/lcov-report/src/string_enum.ts.html +208 -0
  43. package/coverage/lcov-report/src/system_volume.ts.html +301 -0
  44. package/coverage/lcov-report/src/unc.ts.html +274 -0
  45. package/coverage/lcov-report/src/units.ts.html +274 -0
  46. package/coverage/lcov-report/src/uuid.ts.html +157 -0
  47. package/coverage/lcov-report/src/volume_health_status.ts.html +259 -0
  48. package/coverage/lcov-report/src/volume_metadata.ts.html +787 -0
  49. package/coverage/lcov-report/src/volume_mount_points.ts.html +388 -0
  50. package/coverage/lcov.info +3581 -0
  51. package/coverage/prettify.css +1 -0
  52. package/coverage/prettify.js +2 -0
  53. package/coverage/sort-arrow-sprite.png +0 -0
  54. package/coverage/sorter.js +196 -0
  55. package/coverage/src/array.ts.html +217 -0
  56. package/coverage/src/async.ts.html +547 -0
  57. package/coverage/src/debuglog.ts.html +187 -0
  58. package/coverage/src/defer.ts.html +175 -0
  59. package/coverage/src/dirname.ts.html +124 -0
  60. package/coverage/src/error.ts.html +322 -0
  61. package/coverage/src/fs.ts.html +316 -0
  62. package/coverage/src/glob.ts.html +472 -0
  63. package/coverage/src/hidden.ts.html +724 -0
  64. package/coverage/src/index.html +521 -0
  65. package/coverage/src/index.ts.html +676 -0
  66. package/coverage/src/linux/dev_disk.ts.html +316 -0
  67. package/coverage/src/linux/index.html +146 -0
  68. package/coverage/src/linux/mount_points.ts.html +364 -0
  69. package/coverage/src/linux/mtab.ts.html +493 -0
  70. package/coverage/src/mount_point.ts.html +106 -0
  71. package/coverage/src/number.ts.html +148 -0
  72. package/coverage/src/object.ts.html +265 -0
  73. package/coverage/src/options.ts.html +475 -0
  74. package/coverage/src/path.ts.html +268 -0
  75. package/coverage/src/platform.ts.html +112 -0
  76. package/coverage/src/random.ts.html +205 -0
  77. package/coverage/src/remote_info.ts.html +553 -0
  78. package/coverage/src/stack_path.ts.html +298 -0
  79. package/coverage/src/string.ts.html +382 -0
  80. package/coverage/src/string_enum.ts.html +208 -0
  81. package/coverage/src/system_volume.ts.html +301 -0
  82. package/coverage/src/unc.ts.html +274 -0
  83. package/coverage/src/units.ts.html +274 -0
  84. package/coverage/src/uuid.ts.html +157 -0
  85. package/coverage/src/volume_health_status.ts.html +259 -0
  86. package/coverage/src/volume_metadata.ts.html +787 -0
  87. package/coverage/src/volume_mount_points.ts.html +388 -0
  88. package/jest.config.cjs +67 -6
  89. package/package.json +51 -40
  90. package/prebuilds/linux-x64/@photostructure+fs-metadata.glibc.node +0 -0
  91. package/scripts/check-memory.mjs +243 -0
  92. package/scripts/clang-tidy.mjs +73 -0
  93. package/scripts/is-platform.mjs +12 -0
  94. package/scripts/post-build.mjs +21 -0
  95. package/scripts/run-asan.sh +92 -0
  96. package/scripts/valgrind-test.mjs +83 -0
  97. package/scripts/valgrind.sh +70 -0
  98. package/src/async.ts +3 -3
  99. package/src/binding.cpp +3 -3
  100. package/src/darwin/hidden.cpp +14 -0
  101. package/src/darwin/raii_utils.h +85 -0
  102. package/src/darwin/volume_metadata.cpp +35 -60
  103. package/src/darwin/volume_mount_points.cpp +31 -22
  104. package/src/error.ts +3 -3
  105. package/src/fs.ts +1 -1
  106. package/src/glob.ts +2 -2
  107. package/src/hidden.ts +6 -6
  108. package/src/index.ts +19 -23
  109. package/src/linux/blkid_cache.cpp +15 -12
  110. package/src/linux/dev_disk.ts +2 -2
  111. package/src/linux/gio_mount_points.cpp +7 -7
  112. package/src/linux/gio_utils.cpp +19 -8
  113. package/src/linux/gio_volume_metadata.cpp +15 -15
  114. package/src/linux/mount_points.ts +9 -9
  115. package/src/linux/mtab.ts +7 -7
  116. package/src/linux/volume_metadata.cpp +6 -1
  117. package/src/object.ts +9 -4
  118. package/src/options.ts +4 -4
  119. package/src/path.ts +4 -4
  120. package/src/remote_info.ts +5 -5
  121. package/src/system_volume.ts +8 -8
  122. package/src/test-utils/assert.ts +2 -2
  123. package/src/test-utils/debuglog-child.ts +1 -3
  124. package/src/test-utils/debuglog-enabled-child.ts +10 -0
  125. package/src/test-utils/hidden-tests.ts +1 -1
  126. package/src/test-utils/platform.ts +3 -3
  127. package/src/types/native_bindings.ts +3 -3
  128. package/src/types/volume_metadata.ts +2 -2
  129. package/src/unc.ts +2 -2
  130. package/src/uuid.ts +1 -1
  131. package/src/volume_health_status.ts +6 -6
  132. package/src/volume_metadata.ts +20 -23
  133. package/src/volume_mount_points.ts +12 -17
  134. package/src/windows/drive_status.h +30 -13
  135. package/src/windows/hidden.cpp +12 -0
  136. package/src/windows/volume_metadata.cpp +17 -7
  137. package/tsup.config.ts +8 -2
  138. package/dist/index.cjs +0 -1439
  139. package/dist/index.cjs.map +0 -1
  140. package/dist/index.mjs +0 -1396
  141. package/dist/index.mjs.map +0 -1
  142. package/dist/types/array.d.ts +0 -25
  143. package/dist/types/async.d.ts +0 -42
  144. package/dist/types/debuglog.d.ts +0 -3
  145. package/dist/types/defer.d.ts +0 -10
  146. package/dist/types/dirname.d.ts +0 -1
  147. package/dist/types/error.d.ts +0 -17
  148. package/dist/types/fs.d.ts +0 -22
  149. package/dist/types/glob.d.ts +0 -17
  150. package/dist/types/hidden.d.ts +0 -29
  151. package/dist/types/index.d.ts +0 -91
  152. package/dist/types/linux/dev_disk.d.ts +0 -13
  153. package/dist/types/linux/mount_points.d.ts +0 -6
  154. package/dist/types/linux/mtab.d.ts +0 -47
  155. package/dist/types/mount_point.d.ts +0 -2
  156. package/dist/types/number.d.ts +0 -3
  157. package/dist/types/object.d.ts +0 -13
  158. package/dist/types/options.d.ts +0 -33
  159. package/dist/types/path.d.ts +0 -17
  160. package/dist/types/platform.d.ts +0 -4
  161. package/dist/types/random.d.ts +0 -12
  162. package/dist/types/remote_info.d.ts +0 -6
  163. package/dist/types/stack_path.d.ts +0 -2
  164. package/dist/types/string.d.ts +0 -37
  165. package/dist/types/string_enum.d.ts +0 -19
  166. package/dist/types/system_volume.d.ts +0 -14
  167. package/dist/types/types/hidden_metadata.d.ts +0 -32
  168. package/dist/types/types/mount_point.d.ts +0 -46
  169. package/dist/types/types/native_bindings.d.ts +0 -51
  170. package/dist/types/types/options.d.ts +0 -47
  171. package/dist/types/types/remote_info.d.ts +0 -33
  172. package/dist/types/types/volume_metadata.d.ts +0 -46
  173. package/dist/types/unc.d.ts +0 -11
  174. package/dist/types/units.d.ts +0 -38
  175. package/dist/types/uuid.d.ts +0 -16
  176. package/dist/types/volume_health_status.d.ts +0 -24
  177. package/dist/types/volume_metadata.d.ts +0 -8
  178. package/dist/types/volume_mount_points.d.ts +0 -6
  179. package/jest.config.base.cjs +0 -63
  180. package/prebuilds/darwin-arm64/@photostructure+fs-metadata.glibc.node +0 -0
  181. package/prebuilds/linux-arm64/@photostructure+fs-metadata.musl.node +0 -0
  182. package/prebuilds/linux-x64/@photostructure+fs-metadata.musl.node +0 -0
  183. package/prebuilds/win32-x64/@photostructure+fs-metadata.glibc.node +0 -0
@@ -0,0 +1,676 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for src/index.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> index.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">96.44% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>190/197</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">81.81% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>9/11</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">53.33% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>8/15</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">96.44% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>190/197</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></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
264
+ <span class="cline-any cline-yes">1x</span>
265
+ <span class="cline-any cline-yes">1x</span>
266
+ <span class="cline-any cline-yes">1x</span>
267
+ <span class="cline-any cline-yes">1x</span>
268
+ <span class="cline-any cline-yes">1x</span>
269
+ <span class="cline-any cline-yes">1x</span>
270
+ <span class="cline-any cline-yes">1x</span>
271
+ <span class="cline-any cline-yes">1x</span>
272
+ <span class="cline-any cline-yes">1x</span>
273
+ <span class="cline-any cline-yes">1x</span>
274
+ <span class="cline-any cline-yes">1x</span>
275
+ <span class="cline-any cline-yes">1x</span>
276
+ <span class="cline-any cline-yes">1x</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">1x</span>
284
+ <span class="cline-any cline-yes">1x</span>
285
+ <span class="cline-any cline-yes">1x</span>
286
+ <span class="cline-any cline-yes">1x</span>
287
+ <span class="cline-any cline-yes">1x</span>
288
+ <span class="cline-any cline-yes">1x</span>
289
+ <span class="cline-any cline-yes">1x</span>
290
+ <span class="cline-any cline-yes">1x</span>
291
+ <span class="cline-any cline-yes">1x</span>
292
+ <span class="cline-any cline-yes">1x</span>
293
+ <span class="cline-any cline-yes">1x</span>
294
+ <span class="cline-any cline-yes">1x</span>
295
+ <span class="cline-any cline-yes">1x</span>
296
+ <span class="cline-any cline-yes">1x</span>
297
+ <span class="cline-any cline-yes">1x</span>
298
+ <span class="cline-any cline-yes">1x</span>
299
+ <span class="cline-any cline-yes">1x</span>
300
+ <span class="cline-any cline-yes">1x</span>
301
+ <span class="cline-any cline-yes">1x</span>
302
+ <span class="cline-any cline-yes">1x</span>
303
+ <span class="cline-any cline-yes">1x</span>
304
+ <span class="cline-any cline-yes">1x</span>
305
+ <span class="cline-any cline-yes">1x</span>
306
+ <span class="cline-any cline-yes">1x</span>
307
+ <span class="cline-any cline-yes">1x</span>
308
+ <span class="cline-any cline-yes">1x</span>
309
+ <span class="cline-any cline-yes">1x</span>
310
+ <span class="cline-any cline-yes">1x</span>
311
+ <span class="cline-any cline-yes">1x</span>
312
+ <span class="cline-any cline-yes">1x</span>
313
+ <span class="cline-any cline-yes">1x</span>
314
+ <span class="cline-any cline-yes">1x</span>
315
+ <span class="cline-any cline-yes">1x</span>
316
+ <span class="cline-any cline-yes">1x</span>
317
+ <span class="cline-any cline-yes">1x</span>
318
+ <span class="cline-any cline-yes">2x</span>
319
+ <span class="cline-any cline-yes">2x</span>
320
+ <span class="cline-any cline-yes">2x</span>
321
+ <span class="cline-any cline-yes">2x</span>
322
+ <span class="cline-any cline-yes">2x</span>
323
+ <span class="cline-any cline-no">&nbsp;</span>
324
+ <span class="cline-any cline-no">&nbsp;</span>
325
+ <span class="cline-any cline-no">&nbsp;</span>
326
+ <span class="cline-any cline-no">&nbsp;</span>
327
+ <span class="cline-any cline-yes">2x</span>
328
+ <span class="cline-any cline-yes">2x</span>
329
+ <span class="cline-any cline-yes">2x</span>
330
+ <span class="cline-any cline-yes">2x</span>
331
+ <span class="cline-any cline-yes">2x</span>
332
+ <span class="cline-any cline-no">&nbsp;</span>
333
+ <span class="cline-any cline-no">&nbsp;</span>
334
+ <span class="cline-any cline-no">&nbsp;</span>
335
+ <span class="cline-any cline-yes">2x</span>
336
+ <span class="cline-any cline-yes">2x</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">18x</span>
350
+ <span class="cline-any cline-yes">18x</span>
351
+ <span class="cline-any cline-yes">18x</span>
352
+ <span class="cline-any cline-yes">18x</span>
353
+ <span class="cline-any cline-yes">18x</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">51x</span>
362
+ <span class="cline-any cline-yes">51x</span>
363
+ <span class="cline-any cline-yes">51x</span>
364
+ <span class="cline-any cline-yes">51x</span>
365
+ <span class="cline-any cline-yes">51x</span>
366
+ <span class="cline-any cline-yes">51x</span>
367
+ <span class="cline-any cline-yes">51x</span>
368
+ <span class="cline-any cline-yes">51x</span>
369
+ <span class="cline-any cline-yes">51x</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">1x</span>
383
+ <span class="cline-any cline-yes">1x</span>
384
+ <span class="cline-any cline-yes">1x</span>
385
+ <span class="cline-any cline-yes">1x</span>
386
+ <span class="cline-any cline-yes">1x</span>
387
+ <span class="cline-any cline-yes">1x</span>
388
+ <span class="cline-any cline-yes">1x</span>
389
+ <span class="cline-any cline-yes">1x</span>
390
+ <span class="cline-any cline-yes">1x</span>
391
+ <span class="cline-any cline-yes">1x</span>
392
+ <span class="cline-any cline-yes">1x</span>
393
+ <span class="cline-any cline-yes">1x</span>
394
+ <span class="cline-any cline-yes">1x</span>
395
+ <span class="cline-any cline-yes">1x</span>
396
+ <span class="cline-any cline-yes">1x</span>
397
+ <span class="cline-any cline-yes">1x</span>
398
+ <span class="cline-any cline-yes">1x</span>
399
+ <span class="cline-any cline-yes">1x</span>
400
+ <span class="cline-any cline-yes">1x</span>
401
+ <span class="cline-any cline-yes">1x</span>
402
+ <span class="cline-any cline-yes">1x</span>
403
+ <span class="cline-any cline-yes">27x</span>
404
+ <span class="cline-any cline-yes">27x</span>
405
+ <span class="cline-any cline-yes">27x</span>
406
+ <span class="cline-any cline-yes">1x</span>
407
+ <span class="cline-any cline-yes">1x</span>
408
+ <span class="cline-any cline-yes">1x</span>
409
+ <span class="cline-any cline-yes">1x</span>
410
+ <span class="cline-any cline-yes">1x</span>
411
+ <span class="cline-any cline-yes">1x</span>
412
+ <span class="cline-any cline-yes">1x</span>
413
+ <span class="cline-any cline-yes">1x</span>
414
+ <span class="cline-any cline-yes">13x</span>
415
+ <span class="cline-any cline-yes">13x</span>
416
+ <span class="cline-any cline-yes">13x</span>
417
+ <span class="cline-any cline-yes">1x</span>
418
+ <span class="cline-any cline-yes">1x</span>
419
+ <span class="cline-any cline-yes">1x</span>
420
+ <span class="cline-any cline-yes">1x</span>
421
+ <span class="cline-any cline-yes">1x</span>
422
+ <span class="cline-any cline-yes">1x</span>
423
+ <span class="cline-any cline-yes">1x</span>
424
+ <span class="cline-any cline-yes">8x</span>
425
+ <span class="cline-any cline-yes">8x</span>
426
+ <span class="cline-any cline-yes">8x</span>
427
+ <span class="cline-any cline-yes">1x</span>
428
+ <span class="cline-any cline-yes">1x</span>
429
+ <span class="cline-any cline-yes">1x</span>
430
+ <span class="cline-any cline-yes">1x</span>
431
+ <span class="cline-any cline-yes">1x</span>
432
+ <span class="cline-any cline-yes">1x</span>
433
+ <span class="cline-any cline-yes">1x</span>
434
+ <span class="cline-any cline-yes">1x</span>
435
+ <span class="cline-any cline-yes">1x</span>
436
+ <span class="cline-any cline-yes">1x</span>
437
+ <span class="cline-any cline-yes">1x</span>
438
+ <span class="cline-any cline-yes">1x</span>
439
+ <span class="cline-any cline-yes">1x</span>
440
+ <span class="cline-any cline-yes">1x</span>
441
+ <span class="cline-any cline-yes">1x</span>
442
+ <span class="cline-any cline-yes">29x</span>
443
+ <span class="cline-any cline-yes">29x</span>
444
+ <span class="cline-any cline-yes">29x</span>
445
+ <span class="cline-any cline-yes">29x</span>
446
+ <span class="cline-any cline-yes">29x</span>
447
+ <span class="cline-any cline-yes">29x</span>
448
+ <span class="cline-any cline-yes">29x</span>
449
+ <span class="cline-any cline-yes">1x</span>
450
+ <span class="cline-any cline-yes">1x</span>
451
+ <span class="cline-any cline-yes">1x</span>
452
+ <span class="cline-any cline-yes">1x</span>
453
+ <span class="cline-any cline-yes">1x</span>
454
+ <span class="cline-any cline-yes">1x</span>
455
+ <span class="cline-any cline-yes">1x</span>
456
+ <span class="cline-any cline-yes">1x</span>
457
+ <span class="cline-any cline-yes">1x</span>
458
+ <span class="cline-any cline-yes">1x</span>
459
+ <span class="cline-any cline-yes">1x</span>
460
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/index.ts
461
+ &nbsp;
462
+ import NodeGypBuild from "node-gyp-build";
463
+ import { debug, debugLogContext, isDebugEnabled } from "./debuglog";
464
+ import { defer } from "./defer";
465
+ import { _dirname } from "./dirname";
466
+ import { findAncestorDir } from "./fs";
467
+ import type { HideMethod, SetHiddenResult } from "./hidden";
468
+ import {
469
+ getHiddenMetadataImpl,
470
+ isHiddenImpl,
471
+ isHiddenRecursiveImpl,
472
+ setHiddenImpl,
473
+ } from "./hidden";
474
+ import {
475
+ IncludeSystemVolumesDefault,
476
+ LinuxMountTablePathsDefault,
477
+ OptionsDefault,
478
+ optionsWithDefaults,
479
+ SystemFsTypesDefault,
480
+ SystemPathPatternsDefault,
481
+ TimeoutMsDefault,
482
+ } from "./options";
483
+ import type { StringEnum, StringEnumKeys, StringEnumType } from "./string_enum";
484
+ import type { SystemVolumeConfig } from "./system_volume";
485
+ import type { HiddenMetadata } from "./types/hidden_metadata";
486
+ import type { MountPoint } from "./types/mount_point";
487
+ import { NativeBindings } from "./types/native_bindings";
488
+ import type { Options } from "./types/options";
489
+ import type { VolumeMetadata } from "./types/volume_metadata";
490
+ import type { VolumeHealthStatus } from "./volume_health_status";
491
+ import { VolumeHealthStatuses } from "./volume_health_status";
492
+ import {
493
+ getAllVolumeMetadataImpl,
494
+ getVolumeMetadataImpl,
495
+ } from "./volume_metadata";
496
+ import type { GetVolumeMountPointOptions } from "./volume_mount_points";
497
+ import { getVolumeMountPointsImpl } from "./volume_mount_points";
498
+ &nbsp;
499
+ export type {
500
+ GetVolumeMountPointOptions,
501
+ HiddenMetadata,
502
+ HideMethod,
503
+ MountPoint,
504
+ Options,
505
+ SetHiddenResult,
506
+ StringEnum,
507
+ StringEnumKeys,
508
+ StringEnumType,
509
+ SystemVolumeConfig,
510
+ VolumeHealthStatus,
511
+ VolumeMetadata,
512
+ };
513
+ &nbsp;
514
+ const nativeFn = defer&lt;Promise&lt;NativeBindings&gt;&gt;(async () =&gt; {
515
+ const start = Date.now();
516
+ try {
517
+ const dirname = _dirname();
518
+ const dir = await findAncestorDir(dirname, "binding.gyp");
519
+ if (dir == null) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
520
+ <span class="cstat-no" title="statement not covered" > throw new Error(</span>
521
+ <span class="cstat-no" title="statement not covered" > "Could not find bindings.gyp in any ancestor directory of " + dirname,</span>
522
+ <span class="cstat-no" title="statement not covered" > );</span>
523
+ <span class="cstat-no" title="statement not covered" > }</span>
524
+ const bindings = NodeGypBuild(dir) as NativeBindings;
525
+ bindings.setDebugLogging(isDebugEnabled());
526
+ bindings.setDebugPrefix(debugLogContext() + ":native");
527
+ return bindings;
528
+ } <span class="branch-0 cbranch-no" title="branch not covered" >catch (error) {</span>
529
+ <span class="cstat-no" title="statement not covered" > debug("Loading native bindings failed: %s", error);</span>
530
+ <span class="cstat-no" title="statement not covered" > throw error;</span>
531
+ <span class="cstat-no" title="statement not covered" > } finally {</span>
532
+ debug(`Native bindings took %d ms to load`, Date.now() - start);
533
+ }
534
+ });
535
+ &nbsp;
536
+ /**
537
+ * List all active local and remote mount points on the system.
538
+ *
539
+ * Only readable directories are included in the results.
540
+ *
541
+ * Note that on Windows, `timeoutMs` will be used **per system call** and not
542
+ * for the entire operation.
543
+ *
544
+ * @param opts Optional filesystem operation settings to override default values
545
+ */
546
+ export function getVolumeMountPoints(
547
+ opts?: Partial&lt;GetVolumeMountPointOptions&gt;,
548
+ ): Promise&lt;MountPoint[]&gt; {
549
+ return getVolumeMountPointsImpl(optionsWithDefaults(opts), nativeFn);
550
+ }
551
+ &nbsp;
552
+ /**
553
+ * Get metadata for the volume at the given mount point.
554
+ *
555
+ * @param mountPoint Must be a non-blank string
556
+ * @param opts Optional filesystem operation settings
557
+ */
558
+ export function getVolumeMetadata(
559
+ mountPoint: string,
560
+ opts?: Partial&lt;Pick&lt;Options, "timeoutMs"&gt;&gt;,
561
+ ): Promise&lt;VolumeMetadata&gt; {
562
+ return getVolumeMetadataImpl(
563
+ { ...optionsWithDefaults(opts), mountPoint },
564
+ nativeFn,
565
+ );
566
+ }
567
+ &nbsp;
568
+ /**
569
+ * Retrieves metadata for all mounted volumes with optional filtering and
570
+ * concurrency control.
571
+ *
572
+ * @param opts - Optional configuration object
573
+ * @param opts.includeSystemVolumes - If true, includes system volumes in the
574
+ * results. Defaults to true on Windows and false elsewhere.
575
+ * @param opts.maxConcurrency - Maximum number of concurrent operations.
576
+ * Defaults to the system's available parallelism: see
577
+ * {@link https://nodejs.org/api/os.html#osavailableparallelism | os.availableParallelism()}
578
+ * @param opts.timeoutMs - Maximum time to wait for
579
+ * {@link getVolumeMountPointsImpl}, as well as **each** {@link getVolumeMetadataImpl}
580
+ * to complete. Defaults to {@link TimeoutMsDefault}
581
+ * @returns Promise that resolves to an array of either VolumeMetadata objects
582
+ * or error objects containing the mount point and error
583
+ * @throws Never - errors are caught and returned as part of the result array
584
+ */
585
+ export function getAllVolumeMetadata(
586
+ opts?: Partial&lt;Options&gt; &amp; { includeSystemVolumes?: boolean },
587
+ ): Promise&lt;VolumeMetadata[]&gt; {
588
+ return getAllVolumeMetadataImpl(optionsWithDefaults(opts), nativeFn);
589
+ }
590
+ &nbsp;
591
+ /**
592
+ * Check if a file or directory is hidden.
593
+ *
594
+ * Note that `path` may be _effectively_ hidden if any of the ancestor
595
+ * directories are hidden: use {@link isHiddenRecursive} to check for this.
596
+ *
597
+ * @param pathname Path to file or directory
598
+ * @returns Promise resolving to boolean indicating hidden state
599
+ */
600
+ export function isHidden(pathname: string): Promise&lt;boolean&gt; {
601
+ return isHiddenImpl(pathname, nativeFn);
602
+ }
603
+ &nbsp;
604
+ /**
605
+ * Check if a file or directory is hidden, or if any of its ancestor
606
+ * directories are hidden.
607
+ *
608
+ * @param pathname Path to file or directory
609
+ * @returns Promise resolving to boolean indicating hidden state
610
+ */
611
+ export function isHiddenRecursive(pathname: string): Promise&lt;boolean&gt; {
612
+ return isHiddenRecursiveImpl(pathname, nativeFn);
613
+ }
614
+ &nbsp;
615
+ /**
616
+ * Get detailed metadata about the hidden state of a file or directory.
617
+ *
618
+ * @param pathname Path to file or directory
619
+ * @returns Promise resolving to metadata about the hidden state
620
+ */
621
+ export function getHiddenMetadata(pathname: string): Promise&lt;HiddenMetadata&gt; {
622
+ return getHiddenMetadataImpl(pathname, nativeFn);
623
+ }
624
+ &nbsp;
625
+ /**
626
+ * Set the hidden state of a file or directory
627
+ *
628
+ * @param pathname Path to file or directory
629
+ * @param hidden - Whether the item should be hidden (true) or visible (false)
630
+ * @param method Method to use for hiding the file or directory. The default
631
+ * is "auto", which is "dotPrefix" on Linux and macOS, and "systemFlag" on
632
+ * Windows. "all" will attempt to use all relevant methods for the current
633
+ * operating system.
634
+ * @returns Promise resolving the final name of the file or directory (as it
635
+ * will change on POSIX systems), and the action(s) taken.
636
+ * @throws {Error} If the file doesn't exist, permissions are insufficient, or
637
+ * the requested method is unsupported
638
+ */
639
+ export function setHidden(
640
+ pathname: string,
641
+ hidden: boolean,
642
+ method: HideMethod = "auto",
643
+ ): Promise&lt;SetHiddenResult&gt; {
644
+ return setHiddenImpl(pathname, hidden, method, nativeFn);
645
+ }
646
+ &nbsp;
647
+ export {
648
+ <span class="fstat-no" title="function not covered" > IncludeSystemVolumesDefault,</span>
649
+ <span class="fstat-no" title="function not covered" > LinuxMountTablePathsDefault,</span>
650
+ <span class="fstat-no" title="function not covered" > OptionsDefault,</span>
651
+ <span class="fstat-no" title="function not covered" > optionsWithDefaults,</span>
652
+ <span class="fstat-no" title="function not covered" > SystemFsTypesDefault,</span>
653
+ <span class="fstat-no" title="function not covered" > SystemPathPatternsDefault,</span>
654
+ <span class="fstat-no" title="function not covered" > TimeoutMsDefault,</span>
655
+ VolumeHealthStatuses,
656
+ };
657
+ &nbsp;</pre></td></tr></table></pre>
658
+
659
+ <div class='push'></div><!-- for sticky footer -->
660
+ </div><!-- /wrapper -->
661
+ <div class='footer quiet pad2 space-top1 center small'>
662
+ Code coverage generated by
663
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
664
+ at 2025-06-01T20:18:02.872Z
665
+ </div>
666
+ <script src="../prettify.js"></script>
667
+ <script>
668
+ window.onload = function () {
669
+ prettyPrint();
670
+ };
671
+ </script>
672
+ <script src="../sorter.js"></script>
673
+ <script src="../block-navigation.js"></script>
674
+ </body>
675
+ </html>
676
+