@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/src/hidden.ts.html DELETED
@@ -1,724 +0,0 @@
1
-
2
- <!doctype html>
3
- <html lang="en">
4
-
5
- <head>
6
- <title>Code coverage report for src/hidden.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> hidden.ts</h1>
23
- <div class='clearfix'>
24
-
25
- <div class='fl pad1y space-right2'>
26
- <span class="strong">89.67% </span>
27
- <span class="quiet">Statements</span>
28
- <span class='fraction'>191/213</span>
29
- </div>
30
-
31
-
32
- <div class='fl pad1y space-right2'>
33
- <span class="strong">78.43% </span>
34
- <span class="quiet">Branches</span>
35
- <span class='fraction'>40/51</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'>8/8</span>
43
- </div>
44
-
45
-
46
- <div class='fl pad1y space-right2'>
47
- <span class="strong">89.67% </span>
48
- <span class="quiet">Lines</span>
49
- <span class='fraction'>191/213</span>
50
- </div>
51
-
52
-
53
- </div>
54
- <p class="quiet">
55
- Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
- </p>
57
- <template id="filterTemplate">
58
- <div class="quiet">
59
- Filter:
60
- <input type="search" id="fileSearch">
61
- </div>
62
- </template>
63
- </div>
64
- <div class='status-line high'></div>
65
- <pre><table class="coverage">
66
- <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
- <a name='L2'></a><a href='#L2'>2</a>
68
- <a name='L3'></a><a href='#L3'>3</a>
69
- <a name='L4'></a><a href='#L4'>4</a>
70
- <a name='L5'></a><a href='#L5'>5</a>
71
- <a name='L6'></a><a href='#L6'>6</a>
72
- <a name='L7'></a><a href='#L7'>7</a>
73
- <a name='L8'></a><a href='#L8'>8</a>
74
- <a name='L9'></a><a href='#L9'>9</a>
75
- <a name='L10'></a><a href='#L10'>10</a>
76
- <a name='L11'></a><a href='#L11'>11</a>
77
- <a name='L12'></a><a href='#L12'>12</a>
78
- <a name='L13'></a><a href='#L13'>13</a>
79
- <a name='L14'></a><a href='#L14'>14</a>
80
- <a name='L15'></a><a href='#L15'>15</a>
81
- <a name='L16'></a><a href='#L16'>16</a>
82
- <a name='L17'></a><a href='#L17'>17</a>
83
- <a name='L18'></a><a href='#L18'>18</a>
84
- <a name='L19'></a><a href='#L19'>19</a>
85
- <a name='L20'></a><a href='#L20'>20</a>
86
- <a name='L21'></a><a href='#L21'>21</a>
87
- <a name='L22'></a><a href='#L22'>22</a>
88
- <a name='L23'></a><a href='#L23'>23</a>
89
- <a name='L24'></a><a href='#L24'>24</a>
90
- <a name='L25'></a><a href='#L25'>25</a>
91
- <a name='L26'></a><a href='#L26'>26</a>
92
- <a name='L27'></a><a href='#L27'>27</a>
93
- <a name='L28'></a><a href='#L28'>28</a>
94
- <a name='L29'></a><a href='#L29'>29</a>
95
- <a name='L30'></a><a href='#L30'>30</a>
96
- <a name='L31'></a><a href='#L31'>31</a>
97
- <a name='L32'></a><a href='#L32'>32</a>
98
- <a name='L33'></a><a href='#L33'>33</a>
99
- <a name='L34'></a><a href='#L34'>34</a>
100
- <a name='L35'></a><a href='#L35'>35</a>
101
- <a name='L36'></a><a href='#L36'>36</a>
102
- <a name='L37'></a><a href='#L37'>37</a>
103
- <a name='L38'></a><a href='#L38'>38</a>
104
- <a name='L39'></a><a href='#L39'>39</a>
105
- <a name='L40'></a><a href='#L40'>40</a>
106
- <a name='L41'></a><a href='#L41'>41</a>
107
- <a name='L42'></a><a href='#L42'>42</a>
108
- <a name='L43'></a><a href='#L43'>43</a>
109
- <a name='L44'></a><a href='#L44'>44</a>
110
- <a name='L45'></a><a href='#L45'>45</a>
111
- <a name='L46'></a><a href='#L46'>46</a>
112
- <a name='L47'></a><a href='#L47'>47</a>
113
- <a name='L48'></a><a href='#L48'>48</a>
114
- <a name='L49'></a><a href='#L49'>49</a>
115
- <a name='L50'></a><a href='#L50'>50</a>
116
- <a name='L51'></a><a href='#L51'>51</a>
117
- <a name='L52'></a><a href='#L52'>52</a>
118
- <a name='L53'></a><a href='#L53'>53</a>
119
- <a name='L54'></a><a href='#L54'>54</a>
120
- <a name='L55'></a><a href='#L55'>55</a>
121
- <a name='L56'></a><a href='#L56'>56</a>
122
- <a name='L57'></a><a href='#L57'>57</a>
123
- <a name='L58'></a><a href='#L58'>58</a>
124
- <a name='L59'></a><a href='#L59'>59</a>
125
- <a name='L60'></a><a href='#L60'>60</a>
126
- <a name='L61'></a><a href='#L61'>61</a>
127
- <a name='L62'></a><a href='#L62'>62</a>
128
- <a name='L63'></a><a href='#L63'>63</a>
129
- <a name='L64'></a><a href='#L64'>64</a>
130
- <a name='L65'></a><a href='#L65'>65</a>
131
- <a name='L66'></a><a href='#L66'>66</a>
132
- <a name='L67'></a><a href='#L67'>67</a>
133
- <a name='L68'></a><a href='#L68'>68</a>
134
- <a name='L69'></a><a href='#L69'>69</a>
135
- <a name='L70'></a><a href='#L70'>70</a>
136
- <a name='L71'></a><a href='#L71'>71</a>
137
- <a name='L72'></a><a href='#L72'>72</a>
138
- <a name='L73'></a><a href='#L73'>73</a>
139
- <a name='L74'></a><a href='#L74'>74</a>
140
- <a name='L75'></a><a href='#L75'>75</a>
141
- <a name='L76'></a><a href='#L76'>76</a>
142
- <a name='L77'></a><a href='#L77'>77</a>
143
- <a name='L78'></a><a href='#L78'>78</a>
144
- <a name='L79'></a><a href='#L79'>79</a>
145
- <a name='L80'></a><a href='#L80'>80</a>
146
- <a name='L81'></a><a href='#L81'>81</a>
147
- <a name='L82'></a><a href='#L82'>82</a>
148
- <a name='L83'></a><a href='#L83'>83</a>
149
- <a name='L84'></a><a href='#L84'>84</a>
150
- <a name='L85'></a><a href='#L85'>85</a>
151
- <a name='L86'></a><a href='#L86'>86</a>
152
- <a name='L87'></a><a href='#L87'>87</a>
153
- <a name='L88'></a><a href='#L88'>88</a>
154
- <a name='L89'></a><a href='#L89'>89</a>
155
- <a name='L90'></a><a href='#L90'>90</a>
156
- <a name='L91'></a><a href='#L91'>91</a>
157
- <a name='L92'></a><a href='#L92'>92</a>
158
- <a name='L93'></a><a href='#L93'>93</a>
159
- <a name='L94'></a><a href='#L94'>94</a>
160
- <a name='L95'></a><a href='#L95'>95</a>
161
- <a name='L96'></a><a href='#L96'>96</a>
162
- <a name='L97'></a><a href='#L97'>97</a>
163
- <a name='L98'></a><a href='#L98'>98</a>
164
- <a name='L99'></a><a href='#L99'>99</a>
165
- <a name='L100'></a><a href='#L100'>100</a>
166
- <a name='L101'></a><a href='#L101'>101</a>
167
- <a name='L102'></a><a href='#L102'>102</a>
168
- <a name='L103'></a><a href='#L103'>103</a>
169
- <a name='L104'></a><a href='#L104'>104</a>
170
- <a name='L105'></a><a href='#L105'>105</a>
171
- <a name='L106'></a><a href='#L106'>106</a>
172
- <a name='L107'></a><a href='#L107'>107</a>
173
- <a name='L108'></a><a href='#L108'>108</a>
174
- <a name='L109'></a><a href='#L109'>109</a>
175
- <a name='L110'></a><a href='#L110'>110</a>
176
- <a name='L111'></a><a href='#L111'>111</a>
177
- <a name='L112'></a><a href='#L112'>112</a>
178
- <a name='L113'></a><a href='#L113'>113</a>
179
- <a name='L114'></a><a href='#L114'>114</a>
180
- <a name='L115'></a><a href='#L115'>115</a>
181
- <a name='L116'></a><a href='#L116'>116</a>
182
- <a name='L117'></a><a href='#L117'>117</a>
183
- <a name='L118'></a><a href='#L118'>118</a>
184
- <a name='L119'></a><a href='#L119'>119</a>
185
- <a name='L120'></a><a href='#L120'>120</a>
186
- <a name='L121'></a><a href='#L121'>121</a>
187
- <a name='L122'></a><a href='#L122'>122</a>
188
- <a name='L123'></a><a href='#L123'>123</a>
189
- <a name='L124'></a><a href='#L124'>124</a>
190
- <a name='L125'></a><a href='#L125'>125</a>
191
- <a name='L126'></a><a href='#L126'>126</a>
192
- <a name='L127'></a><a href='#L127'>127</a>
193
- <a name='L128'></a><a href='#L128'>128</a>
194
- <a name='L129'></a><a href='#L129'>129</a>
195
- <a name='L130'></a><a href='#L130'>130</a>
196
- <a name='L131'></a><a href='#L131'>131</a>
197
- <a name='L132'></a><a href='#L132'>132</a>
198
- <a name='L133'></a><a href='#L133'>133</a>
199
- <a name='L134'></a><a href='#L134'>134</a>
200
- <a name='L135'></a><a href='#L135'>135</a>
201
- <a name='L136'></a><a href='#L136'>136</a>
202
- <a name='L137'></a><a href='#L137'>137</a>
203
- <a name='L138'></a><a href='#L138'>138</a>
204
- <a name='L139'></a><a href='#L139'>139</a>
205
- <a name='L140'></a><a href='#L140'>140</a>
206
- <a name='L141'></a><a href='#L141'>141</a>
207
- <a name='L142'></a><a href='#L142'>142</a>
208
- <a name='L143'></a><a href='#L143'>143</a>
209
- <a name='L144'></a><a href='#L144'>144</a>
210
- <a name='L145'></a><a href='#L145'>145</a>
211
- <a name='L146'></a><a href='#L146'>146</a>
212
- <a name='L147'></a><a href='#L147'>147</a>
213
- <a name='L148'></a><a href='#L148'>148</a>
214
- <a name='L149'></a><a href='#L149'>149</a>
215
- <a name='L150'></a><a href='#L150'>150</a>
216
- <a name='L151'></a><a href='#L151'>151</a>
217
- <a name='L152'></a><a href='#L152'>152</a>
218
- <a name='L153'></a><a href='#L153'>153</a>
219
- <a name='L154'></a><a href='#L154'>154</a>
220
- <a name='L155'></a><a href='#L155'>155</a>
221
- <a name='L156'></a><a href='#L156'>156</a>
222
- <a name='L157'></a><a href='#L157'>157</a>
223
- <a name='L158'></a><a href='#L158'>158</a>
224
- <a name='L159'></a><a href='#L159'>159</a>
225
- <a name='L160'></a><a href='#L160'>160</a>
226
- <a name='L161'></a><a href='#L161'>161</a>
227
- <a name='L162'></a><a href='#L162'>162</a>
228
- <a name='L163'></a><a href='#L163'>163</a>
229
- <a name='L164'></a><a href='#L164'>164</a>
230
- <a name='L165'></a><a href='#L165'>165</a>
231
- <a name='L166'></a><a href='#L166'>166</a>
232
- <a name='L167'></a><a href='#L167'>167</a>
233
- <a name='L168'></a><a href='#L168'>168</a>
234
- <a name='L169'></a><a href='#L169'>169</a>
235
- <a name='L170'></a><a href='#L170'>170</a>
236
- <a name='L171'></a><a href='#L171'>171</a>
237
- <a name='L172'></a><a href='#L172'>172</a>
238
- <a name='L173'></a><a href='#L173'>173</a>
239
- <a name='L174'></a><a href='#L174'>174</a>
240
- <a name='L175'></a><a href='#L175'>175</a>
241
- <a name='L176'></a><a href='#L176'>176</a>
242
- <a name='L177'></a><a href='#L177'>177</a>
243
- <a name='L178'></a><a href='#L178'>178</a>
244
- <a name='L179'></a><a href='#L179'>179</a>
245
- <a name='L180'></a><a href='#L180'>180</a>
246
- <a name='L181'></a><a href='#L181'>181</a>
247
- <a name='L182'></a><a href='#L182'>182</a>
248
- <a name='L183'></a><a href='#L183'>183</a>
249
- <a name='L184'></a><a href='#L184'>184</a>
250
- <a name='L185'></a><a href='#L185'>185</a>
251
- <a name='L186'></a><a href='#L186'>186</a>
252
- <a name='L187'></a><a href='#L187'>187</a>
253
- <a name='L188'></a><a href='#L188'>188</a>
254
- <a name='L189'></a><a href='#L189'>189</a>
255
- <a name='L190'></a><a href='#L190'>190</a>
256
- <a name='L191'></a><a href='#L191'>191</a>
257
- <a name='L192'></a><a href='#L192'>192</a>
258
- <a name='L193'></a><a href='#L193'>193</a>
259
- <a name='L194'></a><a href='#L194'>194</a>
260
- <a name='L195'></a><a href='#L195'>195</a>
261
- <a name='L196'></a><a href='#L196'>196</a>
262
- <a name='L197'></a><a href='#L197'>197</a>
263
- <a name='L198'></a><a href='#L198'>198</a>
264
- <a name='L199'></a><a href='#L199'>199</a>
265
- <a name='L200'></a><a href='#L200'>200</a>
266
- <a name='L201'></a><a href='#L201'>201</a>
267
- <a name='L202'></a><a href='#L202'>202</a>
268
- <a name='L203'></a><a href='#L203'>203</a>
269
- <a name='L204'></a><a href='#L204'>204</a>
270
- <a name='L205'></a><a href='#L205'>205</a>
271
- <a name='L206'></a><a href='#L206'>206</a>
272
- <a name='L207'></a><a href='#L207'>207</a>
273
- <a name='L208'></a><a href='#L208'>208</a>
274
- <a name='L209'></a><a href='#L209'>209</a>
275
- <a name='L210'></a><a href='#L210'>210</a>
276
- <a name='L211'></a><a href='#L211'>211</a>
277
- <a name='L212'></a><a href='#L212'>212</a>
278
- <a name='L213'></a><a href='#L213'>213</a>
279
- <a name='L214'></a><a href='#L214'>214</a></td><td class="line-coverage quiet"><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-no">&nbsp;</span>
316
- <span class="cline-any cline-no">&nbsp;</span>
317
- <span class="cline-any cline-no">&nbsp;</span>
318
- <span class="cline-any cline-yes">1x</span>
319
- <span class="cline-any cline-yes">1x</span>
320
- <span class="cline-any cline-yes">1x</span>
321
- <span class="cline-any cline-yes">1x</span>
322
- <span class="cline-any cline-yes">1x</span>
323
- <span class="cline-any cline-yes">1x</span>
324
- <span class="cline-any cline-yes">1x</span>
325
- <span class="cline-any cline-yes">48x</span>
326
- <span class="cline-any cline-yes">48x</span>
327
- <span class="cline-any cline-yes">48x</span>
328
- <span class="cline-any cline-yes">48x</span>
329
- <span class="cline-any cline-yes">48x</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-yes">46x</span>
333
- <span class="cline-any cline-yes">48x</span>
334
- <span class="cline-any cline-yes">27x</span>
335
- <span class="cline-any cline-yes">48x</span>
336
- <span class="cline-any cline-yes">48x</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">13x</span>
340
- <span class="cline-any cline-yes">13x</span>
341
- <span class="cline-any cline-yes">13x</span>
342
- <span class="cline-any cline-yes">13x</span>
343
- <span class="cline-any cline-yes">13x</span>
344
- <span class="cline-any cline-yes">2x</span>
345
- <span class="cline-any cline-yes">2x</span>
346
- <span class="cline-any cline-yes">13x</span>
347
- <span class="cline-any cline-yes">21x</span>
348
- <span class="cline-any cline-yes">6x</span>
349
- <span class="cline-any cline-yes">6x</span>
350
- <span class="cline-any cline-yes">15x</span>
351
- <span class="cline-any cline-yes">15x</span>
352
- <span class="cline-any cline-yes">5x</span>
353
- <span class="cline-any cline-yes">5x</span>
354
- <span class="cline-any cline-yes">1x</span>
355
- <span class="cline-any cline-yes">34x</span>
356
- <span class="cline-any cline-yes">34x</span>
357
- <span class="cline-any cline-yes">34x</span>
358
- <span class="cline-any cline-yes">2x</span>
359
- <span class="cline-any cline-yes">2x</span>
360
- <span class="cline-any cline-yes">32x</span>
361
- <span class="cline-any cline-yes">32x</span>
362
- <span class="cline-any cline-yes">34x</span>
363
- <span class="cline-any cline-yes">34x</span>
364
- <span class="cline-any cline-yes">34x</span>
365
- <span class="cline-any cline-yes">1x</span>
366
- <span class="cline-any cline-yes">22x</span>
367
- <span class="cline-any cline-yes">22x</span>
368
- <span class="cline-any cline-yes">22x</span>
369
- <span class="cline-any cline-yes">22x</span>
370
- <span class="cline-any cline-yes">22x</span>
371
- <span class="cline-any cline-yes">22x</span>
372
- <span class="cline-any cline-yes">22x</span>
373
- <span class="cline-any cline-yes">22x</span>
374
- <span class="cline-any cline-yes">22x</span>
375
- <span class="cline-any cline-no">&nbsp;</span>
376
- <span class="cline-any cline-no">&nbsp;</span>
377
- <span class="cline-any cline-no">&nbsp;</span>
378
- <span class="cline-any cline-yes">1x</span>
379
- <span class="cline-any cline-yes">76x</span>
380
- <span class="cline-any cline-yes">76x</span>
381
- <span class="cline-any cline-yes">76x</span>
382
- <span class="cline-any cline-yes">76x</span>
383
- <span class="cline-any cline-yes">76x</span>
384
- <span class="cline-any cline-yes">1x</span>
385
- <span class="cline-any cline-yes">6x</span>
386
- <span class="cline-any cline-yes">6x</span>
387
- <span class="cline-any cline-yes">6x</span>
388
- <span class="cline-any cline-yes">6x</span>
389
- <span class="cline-any cline-yes">6x</span>
390
- <span class="cline-any cline-yes">6x</span>
391
- <span class="cline-any cline-yes">6x</span>
392
- <span class="cline-any cline-yes">6x</span>
393
- <span class="cline-any cline-yes">6x</span>
394
- <span class="cline-any cline-no">&nbsp;</span>
395
- <span class="cline-any cline-no">&nbsp;</span>
396
- <span class="cline-any cline-no">&nbsp;</span>
397
- <span class="cline-any cline-no">&nbsp;</span>
398
- <span class="cline-any cline-no">&nbsp;</span>
399
- <span class="cline-any cline-no">&nbsp;</span>
400
- <span class="cline-any cline-no">&nbsp;</span>
401
- <span class="cline-any cline-no">&nbsp;</span>
402
- <span class="cline-any cline-yes">6x</span>
403
- <span class="cline-any cline-yes">6x</span>
404
- <span class="cline-any cline-yes">1x</span>
405
- <span class="cline-any cline-yes">1x</span>
406
- <span class="cline-any cline-yes">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">8x</span>
412
- <span class="cline-any cline-yes">8x</span>
413
- <span class="cline-any cline-yes">8x</span>
414
- <span class="cline-any cline-yes">8x</span>
415
- <span class="cline-any cline-yes">8x</span>
416
- <span class="cline-any cline-yes">2x</span>
417
- <span class="cline-any cline-yes">2x</span>
418
- <span class="cline-any cline-yes">6x</span>
419
- <span class="cline-any cline-yes">6x</span>
420
- <span class="cline-any cline-yes">6x</span>
421
- <span class="cline-any cline-yes">8x</span>
422
- <span class="cline-any cline-yes">8x</span>
423
- <span class="cline-any cline-yes">8x</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">29x</span>
440
- <span class="cline-any cline-yes">29x</span>
441
- <span class="cline-any cline-yes">29x</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">2x</span>
447
- <span class="cline-any cline-yes">2x</span>
448
- <span class="cline-any cline-yes">27x</span>
449
- <span class="cline-any cline-yes">29x</span>
450
- <span class="cline-any cline-no">&nbsp;</span>
451
- <span class="cline-any cline-no">&nbsp;</span>
452
- <span class="cline-any cline-yes">27x</span>
453
- <span class="cline-any cline-yes">29x</span>
454
- <span class="cline-any cline-yes">2x</span>
455
- <span class="cline-any cline-yes">2x</span>
456
- <span class="cline-any cline-yes">25x</span>
457
- <span class="cline-any cline-yes">25x</span>
458
- <span class="cline-any cline-yes">25x</span>
459
- <span class="cline-any cline-yes">29x</span>
460
- <span class="cline-any cline-yes">1x</span>
461
- <span class="cline-any cline-yes">1x</span>
462
- <span class="cline-any cline-yes">24x</span>
463
- <span class="cline-any cline-yes">29x</span>
464
- <span class="cline-any cline-no">&nbsp;</span>
465
- <span class="cline-any cline-no">&nbsp;</span>
466
- <span class="cline-any cline-yes">24x</span>
467
- <span class="cline-any cline-yes">24x</span>
468
- <span class="cline-any cline-yes">24x</span>
469
- <span class="cline-any cline-yes">24x</span>
470
- <span class="cline-any cline-yes">24x</span>
471
- <span class="cline-any cline-yes">24x</span>
472
- <span class="cline-any cline-yes">24x</span>
473
- <span class="cline-any cline-yes">24x</span>
474
- <span class="cline-any cline-yes">29x</span>
475
- <span class="cline-any cline-yes">24x</span>
476
- <span class="cline-any cline-yes">22x</span>
477
- <span class="cline-any cline-yes">22x</span>
478
- <span class="cline-any cline-yes">22x</span>
479
- <span class="cline-any cline-yes">24x</span>
480
- <span class="cline-any cline-yes">24x</span>
481
- <span class="cline-any cline-yes">24x</span>
482
- <span class="cline-any cline-yes">24x</span>
483
- <span class="cline-any cline-yes">24x</span>
484
- <span class="cline-any cline-no">&nbsp;</span>
485
- <span class="cline-any cline-yes">29x</span>
486
- <span class="cline-any cline-no">&nbsp;</span>
487
- <span class="cline-any cline-no">&nbsp;</span>
488
- <span class="cline-any cline-no">&nbsp;</span>
489
- <span class="cline-any cline-yes">24x</span>
490
- <span class="cline-any cline-yes">24x</span>
491
- <span class="cline-any cline-yes">24x</span>
492
- <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">// src/hidden.ts
493
- &nbsp;
494
- import { rename } from "node:fs/promises";
495
- import { basename, dirname, join } from "node:path";
496
- import { WrappedError } from "./error";
497
- import { canStatAsync, statAsync } from "./fs";
498
- import { isRootDirectory, normalizePath } from "./path";
499
- import { isWindows } from "./platform";
500
- import type { HiddenMetadata } from "./types/hidden_metadata";
501
- import type { NativeBindingsFn } from "./types/native_bindings";
502
- &nbsp;
503
- const HiddenSupportByPlatform: Partial&lt;
504
- Record&lt;NodeJS.Platform, Pick&lt;HiddenMetadata, "supported"&gt;&gt;
505
- &gt; = {
506
- win32: {
507
- supported: {
508
- dotPrefix: false,
509
- systemFlag: true,
510
- },
511
- },
512
- darwin: {
513
- supported: {
514
- dotPrefix: true,
515
- systemFlag: true,
516
- },
517
- },
518
- linux: {
519
- supported: {
520
- dotPrefix: true,
521
- systemFlag: false,
522
- },
523
- },
524
- };
525
- &nbsp;
526
- export const LocalSupport = HiddenSupportByPlatform[process.platform]
527
- ?.supported<span class="branch-0 cbranch-no" title="branch not covered" > ?? {</span>
528
- <span class="cstat-no" title="statement not covered" > dotPrefix: false,</span>
529
- <span class="cstat-no" title="statement not covered" > systemFlag: false,</span>
530
- <span class="cstat-no" title="statement not covered" >};</span>
531
- &nbsp;
532
- /**
533
- * Checks if the file or directory is hidden through any available method
534
- * @returns A boolean indicating if the item is hidden
535
- * @throws {Error} If the file doesn't exist or permissions are insufficient
536
- */
537
- export async function isHiddenImpl(
538
- pathname: string,
539
- nativeFn: NativeBindingsFn,
540
- ): Promise&lt;boolean&gt; {
541
- const norm = normalizePath(pathname);
542
- if (norm == null) {
543
- throw new Error("Invalid pathname: " + JSON.stringify(pathname));
544
- }
545
- return (
546
- (LocalSupport.dotPrefix &amp;&amp; isPosixHidden(norm)) ||
547
- (LocalSupport.systemFlag<span class="branch-0 cbranch-no" title="branch not covered" > &amp;&amp; isSystemHidden(norm, nativeFn))</span>
548
- );
549
- }
550
- &nbsp;
551
- export async function isHiddenRecursiveImpl(
552
- path: string,
553
- nativeFn: NativeBindingsFn,
554
- ): Promise&lt;boolean&gt; {
555
- let norm = normalizePath(path);
556
- if (norm == null) {
557
- throw new Error("Invalid path: " + JSON.stringify(path));
558
- }
559
- while (!isRootDirectory(norm)) {
560
- if (await isHiddenImpl(norm, nativeFn)) {
561
- return true;
562
- }
563
- norm = dirname(norm);
564
- }
565
- return false;
566
- }
567
- &nbsp;
568
- export function createHiddenPosixPath(pathname: string, hidden: boolean) {
569
- const norm = normalizePath(pathname);
570
- if (norm == null) {
571
- throw new Error("Invalid pathname: " + JSON.stringify(pathname));
572
- }
573
- const dir = dirname(norm);
574
- const srcBase = basename(norm).replace(/^\./, "");
575
- const dest = join(dir, (hidden ? "." : "") + srcBase);
576
- return dest;
577
- }
578
- &nbsp;
579
- async function setHiddenPosix(
580
- pathname: string,
581
- hidden: boolean,
582
- ): Promise&lt;string&gt; {
583
- if (LocalSupport.dotPrefix) {
584
- const dest = createHiddenPosixPath(pathname, hidden);
585
- if (pathname !== dest) await rename(pathname, dest);
586
- return dest;
587
- }
588
- <span class="cstat-no" title="statement not covered" ><span class="branch-0 cbranch-no" title="branch not covered" ></span></span>
589
- <span class="cstat-no" title="statement not covered" > throw new Error("Unsupported platform");</span>
590
- <span class="cstat-no" title="statement not covered" >}</span>
591
- &nbsp;
592
- function isPosixHidden(pathname: string): boolean {
593
- if (!LocalSupport.dotPrefix) <span class="branch-0 cbranch-no" title="branch not covered" >return false;</span>
594
- const b = basename(pathname);
595
- return b.startsWith(".") &amp;&amp; b !== "." &amp;&amp; b !== "..";
596
- }
597
- &nbsp;
598
- async function isSystemHidden(
599
- pathname: string,
600
- nativeFn: NativeBindingsFn,
601
- ): Promise&lt;boolean&gt; {
602
- if (!LocalSupport.systemFlag) {
603
- // not supported on this platform
604
- return false;
605
- }
606
- <span class="branch-0 cbranch-no" title="branch not covered" > if (isWindows &amp;&amp; isRootDirectory(pathname))</span> <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
607
- <span class="cstat-no" title="statement not covered" > // windows `attr` thinks all drive letters don't exist.</span>
608
- <span class="cstat-no" title="statement not covered" > return false;</span>
609
- <span class="cstat-no" title="statement not covered" > }</span>
610
- <span class="cstat-no" title="statement not covered" ></span>
611
- <span class="cstat-no" title="statement not covered" > // don't bother the native bindings if the file doesn't exist:</span>
612
- <span class="cstat-no" title="statement not covered" > return (</span>
613
- <span class="cstat-no" title="statement not covered" > (await canStatAsync(pathname)) &amp;&amp;</span>
614
- <span class="cstat-no" title="statement not covered" > (await (await nativeFn()).isHidden(pathname))</span>
615
- );
616
- }
617
- &nbsp;
618
- /**
619
- * Gets detailed information about the hidden state of the file or directory
620
- * @returns An object containing detailed hidden state information
621
- * @throws {Error} If the file doesn't exist or permissions are insufficient
622
- */
623
- export async function getHiddenMetadataImpl(
624
- pathname: string,
625
- nativeFn: NativeBindingsFn,
626
- ): Promise&lt;HiddenMetadata&gt; {
627
- const norm = normalizePath(pathname);
628
- if (norm == null) {
629
- throw new Error("Invalid pathname: " + JSON.stringify(pathname));
630
- }
631
- const dotPrefix = isPosixHidden(norm);
632
- const systemFlag = await isSystemHidden(norm, nativeFn);
633
- return {
634
- hidden: dotPrefix || systemFlag,
635
- dotPrefix,
636
- systemFlag,
637
- supported: LocalSupport,
638
- };
639
- }
640
- &nbsp;
641
- export type HideMethod = "dotPrefix" | "systemFlag" | "all" | "auto";
642
- &nbsp;
643
- export type SetHiddenResult = {
644
- pathname: string;
645
- actions: {
646
- dotPrefix: boolean;
647
- systemFlag: boolean;
648
- };
649
- };
650
- &nbsp;
651
- export async function setHiddenImpl(
652
- pathname: string,
653
- hide: boolean,
654
- method: HideMethod,
655
- nativeFn: NativeBindingsFn,
656
- ): Promise&lt;SetHiddenResult&gt; {
657
- let norm = normalizePath(pathname);
658
- if (norm == null) {
659
- throw new Error("Invalid pathname: " + JSON.stringify(pathname));
660
- }
661
- &nbsp;
662
- if (method === "dotPrefix" &amp;&amp; !LocalSupport.dotPrefix) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
663
- <span class="cstat-no" title="statement not covered" > throw new Error("Dot prefix hiding is not supported on this platform");</span>
664
- <span class="cstat-no" title="statement not covered" > }</span>
665
- &nbsp;
666
- if (method === "systemFlag" &amp;&amp; !LocalSupport.systemFlag) {
667
- throw new Error("System flag hiding is not supported on this platform");
668
- }
669
- &nbsp;
670
- try {
671
- await statAsync(norm);
672
- } catch (cause) {
673
- throw new WrappedError("setHidden()", { cause });
674
- }
675
- &nbsp;
676
- if (isWindows<span class="branch-0 cbranch-no" title="branch not covered" > &amp;&amp; isRootDirectory(norm))</span> <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
677
- <span class="cstat-no" title="statement not covered" > throw new Error("Cannot hide root directory on Windows");</span>
678
- <span class="cstat-no" title="statement not covered" > }</span>
679
- &nbsp;
680
- const actions = {
681
- dotPrefix: false,
682
- systemFlag: false,
683
- };
684
- &nbsp;
685
- let acted = false;
686
- &nbsp;
687
- if (LocalSupport.dotPrefix &amp;&amp; ["auto", "all", "dotPrefix"].includes(method)) {
688
- if (isPosixHidden(norm) !== hide) {
689
- norm = await setHiddenPosix(norm, hide);
690
- actions.dotPrefix = true;
691
- }
692
- acted = true;
693
- }
694
- &nbsp;
695
- if (
696
- LocalSupport.systemFlag<span class="branch-0 cbranch-no" title="branch not covered" > &amp;&amp;</span>
697
- <span class="cstat-no" title="statement not covered" > (["all", "systemFlag"].includes(method) || (!acted &amp;&amp; method === "auto"))</span>
698
- ) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
699
- <span class="cstat-no" title="statement not covered" > await (await nativeFn()).setHidden(norm, hide);</span>
700
- <span class="cstat-no" title="statement not covered" > actions.systemFlag = true;</span>
701
- <span class="cstat-no" title="statement not covered" > }</span>
702
- &nbsp;
703
- return { pathname: norm, actions };
704
- }
705
- &nbsp;</pre></td></tr></table></pre>
706
-
707
- <div class='push'></div><!-- for sticky footer -->
708
- </div><!-- /wrapper -->
709
- <div class='footer quiet pad2 space-top1 center small'>
710
- Code coverage generated by
711
- <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
712
- at 2025-06-01T20:18:02.872Z
713
- </div>
714
- <script src="../prettify.js"></script>
715
- <script>
716
- window.onload = function () {
717
- prettyPrint();
718
- };
719
- </script>
720
- <script src="../sorter.js"></script>
721
- <script src="../block-navigation.js"></script>
722
- </body>
723
- </html>
724
-