@btc-vision/bitcoin 6.4.10 → 6.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 (220) hide show
  1. package/.babelrc +13 -4
  2. package/.mocharc.json +13 -13
  3. package/.prettierrc.json +12 -12
  4. package/CHANGELOG.md +403 -403
  5. package/CONTRIBUTING.md +83 -83
  6. package/LICENSE +21 -21
  7. package/README.md +201 -201
  8. package/browser/chunks/crypto-C6FlKKmp.js +2006 -0
  9. package/browser/chunks/payments-BE4vwHhV.js +1045 -0
  10. package/browser/chunks/psbt-Dlosf9CT.js +3853 -0
  11. package/browser/chunks/script-COWGdiOo.js +318 -0
  12. package/browser/chunks/transaction-BiXwH2v4.js +421 -0
  13. package/browser/chunks/utils-BKmkTzNZ.js +759 -0
  14. package/browser/crypto/crypto.d.ts +1 -1
  15. package/browser/index.d.ts +7 -27
  16. package/browser/index.js +92 -2
  17. package/build/index.d.ts +7 -27
  18. package/build/index.js +2 -2
  19. package/cjs/package.json +3 -3
  20. package/gulpfile.js +42 -42
  21. package/package.json +153 -150
  22. package/src/bip66.ts +107 -107
  23. package/src/block.ts +233 -233
  24. package/src/bufferutils.ts +188 -188
  25. package/src/crypto.ts +108 -108
  26. package/src/ecc_lib.ts +94 -94
  27. package/src/hooks/AdvancedSignatureManager.ts +104 -104
  28. package/src/hooks/SignatureManager.ts +84 -84
  29. package/src/index.ts +83 -105
  30. package/src/merkle.ts +31 -31
  31. package/src/opcodes.ts +280 -280
  32. package/src/payments/bip341.ts +140 -140
  33. package/src/payments/embed.ts +61 -61
  34. package/src/payments/index.ts +172 -172
  35. package/src/payments/lazy.ts +28 -28
  36. package/src/payments/p2ms.ts +156 -156
  37. package/src/payments/p2op.ts +195 -195
  38. package/src/payments/p2pk.ts +93 -93
  39. package/src/payments/p2pkh.ts +214 -214
  40. package/src/payments/p2tr.ts +309 -309
  41. package/src/psbt/bip371.ts +441 -441
  42. package/src/push_data.ts +97 -97
  43. package/src/script.ts +247 -247
  44. package/src/script_number.ts +72 -72
  45. package/src/script_signature.ts +91 -91
  46. package/src/transaction.ts +656 -656
  47. package/test/address.spec.ts +155 -155
  48. package/test/bitcoin.core.spec.ts +212 -212
  49. package/test/block.spec.ts +171 -171
  50. package/test/bufferutils.spec.ts +450 -450
  51. package/test/crypto.spec.ts +49 -49
  52. package/test/fixtures/address.json +329 -329
  53. package/test/fixtures/block.json +148 -148
  54. package/test/fixtures/bufferutils.json +102 -102
  55. package/test/fixtures/core/README.md +26 -26
  56. package/test/fixtures/core/base58_encode_decode.json +50 -50
  57. package/test/fixtures/core/base58_keys_invalid.json +152 -152
  58. package/test/fixtures/core/base58_keys_valid.json +452 -452
  59. package/test/fixtures/core/blocks.json +27 -27
  60. package/test/fixtures/core/sig_canonical.json +7 -7
  61. package/test/fixtures/core/sig_noncanonical.json +33 -33
  62. package/test/fixtures/core/sighash.json +3505 -3505
  63. package/test/fixtures/core/tx_valid.json +2023 -2023
  64. package/test/fixtures/crypto.json +43 -43
  65. package/test/fixtures/ecdsa.json +217 -217
  66. package/test/fixtures/ecpair.json +141 -141
  67. package/test/fixtures/embed.json +108 -108
  68. package/test/fixtures/p2ms.json +434 -434
  69. package/test/fixtures/p2pk.json +179 -179
  70. package/test/fixtures/p2pkh.json +276 -276
  71. package/test/fixtures/p2sh.json +508 -508
  72. package/test/fixtures/p2tr.json +1198 -1198
  73. package/test/fixtures/p2wpkh.json +290 -290
  74. package/test/fixtures/p2wsh.json +489 -489
  75. package/test/fixtures/psbt.json +924 -924
  76. package/test/fixtures/script.json +465 -465
  77. package/test/fixtures/script_number.json +225 -225
  78. package/test/fixtures/signature.json +140 -140
  79. package/test/fixtures/transaction.json +916 -916
  80. package/test/integration/_regtest.ts +6 -6
  81. package/test/integration/addresses.spec.ts +142 -142
  82. package/test/integration/bip32.spec.ts +130 -130
  83. package/test/integration/blocks.spec.ts +28 -28
  84. package/test/integration/cltv.spec.ts +241 -241
  85. package/test/integration/csv.spec.ts +452 -452
  86. package/test/integration/payments.spec.ts +110 -110
  87. package/test/integration/taproot.spec.ts +663 -663
  88. package/test/integration/transactions.spec.ts +668 -668
  89. package/test/payments.spec.ts +114 -114
  90. package/test/payments.utils.ts +165 -165
  91. package/test/psbt.spec.ts +1285 -1285
  92. package/test/script.spec.ts +186 -186
  93. package/test/script_number.spec.ts +26 -26
  94. package/test/script_signature.spec.ts +66 -66
  95. package/test/transaction.spec.ts +337 -337
  96. package/test/ts-node-register.js +7 -7
  97. package/test/tsconfig.json +48 -48
  98. package/test/types.spec.ts +53 -53
  99. package/tsconfig.base.json +27 -27
  100. package/tsconfig.json +19 -19
  101. package/tsconfig.webpack.json +18 -18
  102. package/vite.config.browser.ts +93 -0
  103. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/.ready +0 -0
  104. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/.release-please-manifest.json +0 -3
  105. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/CHANGELOG.md +0 -962
  106. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/CONTRIBUTING.md +0 -34
  107. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/LICENSE +0 -24
  108. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/README.md +0 -273
  109. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/SECURITY.md +0 -2
  110. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/addon.gypi +0 -204
  111. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/bin/node-gyp.js +0 -138
  112. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/.release-please-manifest.json +0 -3
  113. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/LICENSE +0 -28
  114. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/data/ninja/build.ninja +0 -4
  115. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/data/win/large-pdb-shim.cc +0 -12
  116. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/GypVsCMake.md +0 -116
  117. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/Hacking.md +0 -46
  118. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/InputFormatReference.md +0 -1080
  119. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/LanguageSpecification.md +0 -430
  120. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/README.md +0 -27
  121. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/Testing.md +0 -450
  122. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/UserDocumentation.md +0 -965
  123. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/gyp +0 -8
  124. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/gyp.bat +0 -5
  125. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/gyp_main.py +0 -45
  126. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSNew.py +0 -365
  127. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSProject.py +0 -206
  128. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSSettings.py +0 -1272
  129. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSSettings_test.py +0 -1547
  130. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSToolFile.py +0 -59
  131. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSUserFile.py +0 -153
  132. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSUtil.py +0 -271
  133. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSVersion.py +0 -574
  134. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/__init__.py +0 -692
  135. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/common.py +0 -711
  136. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/common_test.py +0 -171
  137. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/easy_xml.py +0 -169
  138. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/easy_xml_test.py +0 -113
  139. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/flock_tool.py +0 -55
  140. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/__init__.py +0 -0
  141. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/analyzer.py +0 -804
  142. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/android.py +0 -1173
  143. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/cmake.py +0 -1318
  144. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/compile_commands_json.py +0 -127
  145. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/dump_dependency_json.py +0 -103
  146. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/eclipse.py +0 -461
  147. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/gypd.py +0 -89
  148. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/gypsh.py +0 -57
  149. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/make.py +0 -2745
  150. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/msvs.py +0 -3976
  151. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/msvs_test.py +0 -44
  152. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/ninja.py +0 -2964
  153. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/ninja_test.py +0 -67
  154. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/xcode.py +0 -1391
  155. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/xcode_test.py +0 -25
  156. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/input.py +0 -3115
  157. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/input_test.py +0 -98
  158. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/mac_tool.py +0 -771
  159. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/msvs_emulation.py +0 -1260
  160. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/ninja_syntax.py +0 -174
  161. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/simple_copy.py +0 -61
  162. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/win_tool.py +0 -373
  163. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py +0 -1938
  164. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation_test.py +0 -53
  165. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcode_ninja.py +0 -302
  166. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcodeproj_file.py +0 -3198
  167. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xml_fix.py +0 -65
  168. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/LICENSE +0 -3
  169. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/LICENSE.APACHE +0 -177
  170. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/LICENSE.BSD +0 -23
  171. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/__init__.py +0 -15
  172. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_elffile.py +0 -108
  173. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_manylinux.py +0 -252
  174. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_musllinux.py +0 -83
  175. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_parser.py +0 -359
  176. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_structures.py +0 -61
  177. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_tokenizer.py +0 -192
  178. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/markers.py +0 -252
  179. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/metadata.py +0 -825
  180. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/py.typed +0 -0
  181. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/requirements.py +0 -90
  182. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/specifiers.py +0 -1030
  183. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/tags.py +0 -553
  184. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/utils.py +0 -172
  185. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/version.py +0 -563
  186. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pyproject.toml +0 -120
  187. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/release-please-config.json +0 -11
  188. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/test_gyp.py +0 -261
  189. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/Find-VisualStudio.cs +0 -250
  190. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/build.js +0 -227
  191. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/clean.js +0 -15
  192. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/configure.js +0 -328
  193. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/create-config-gypi.js +0 -150
  194. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/download.js +0 -39
  195. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/find-node-directory.js +0 -63
  196. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/find-python.js +0 -310
  197. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/find-visualstudio.js +0 -590
  198. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/install.js +0 -415
  199. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/list.js +0 -26
  200. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/log.js +0 -168
  201. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/node-gyp.js +0 -188
  202. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/process-release.js +0 -146
  203. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/rebuild.js +0 -12
  204. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/remove.js +0 -43
  205. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/util.js +0 -81
  206. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/macOS_Catalina_acid_test.sh +0 -21
  207. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/package.json +0 -51
  208. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/release-please-config.json +0 -40
  209. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/src/win_delay_load_hook.cc +0 -39
  210. package/browser/index.js.LICENSE.txt +0 -14
  211. package/browser/ops.d.ts +0 -126
  212. package/build/ops.d.ts +0 -126
  213. package/build/ops.js +0 -127
  214. package/coverage/tmp/coverage-31752-1735543485354-0.json +0 -1
  215. package/coverage/tmp/coverage-59920-1735543484555-0.json +0 -1
  216. package/coverage/tmp/coverage-66252-1735543483919-0.json +0 -1
  217. package/coverage/tmp/coverage-68440-1735543485236-0.json +0 -1
  218. package/coverage/tmp/coverage-70588-1735543484426-0.json +0 -1
  219. package/coverage/tmp/coverage-79292-1735543485296-0.json +0 -1
  220. package/coverage/tmp/coverage-80212-1735543483980-0.json +0 -1
@@ -1,590 +0,0 @@
1
- 'use strict'
2
-
3
- const log = require('./log')
4
- const { existsSync } = require('fs')
5
- const { win32: path } = require('path')
6
- const { regSearchKeys, execFile } = require('./util')
7
-
8
- class VisualStudioFinder {
9
- static findVisualStudio = (...args) => new VisualStudioFinder(...args).findVisualStudio()
10
-
11
- log = log.withPrefix('find VS')
12
-
13
- regSearchKeys = regSearchKeys
14
-
15
- constructor (nodeSemver, configMsvsVersion) {
16
- this.nodeSemver = nodeSemver
17
- this.configMsvsVersion = configMsvsVersion
18
- this.errorLog = []
19
- this.validVersions = []
20
- }
21
-
22
- // Logs a message at verbose level, but also saves it to be displayed later
23
- // at error level if an error occurs. This should help diagnose the problem.
24
- addLog (message) {
25
- this.log.verbose(message)
26
- this.errorLog.push(message)
27
- }
28
-
29
- async findVisualStudio () {
30
- this.configVersionYear = null
31
- this.configPath = null
32
- if (this.configMsvsVersion) {
33
- this.addLog('msvs_version was set from command line or npm config')
34
- if (this.configMsvsVersion.match(/^\d{4}$/)) {
35
- this.configVersionYear = parseInt(this.configMsvsVersion, 10)
36
- this.addLog(
37
- `- looking for Visual Studio version ${this.configVersionYear}`)
38
- } else {
39
- this.configPath = path.resolve(this.configMsvsVersion)
40
- this.addLog(
41
- `- looking for Visual Studio installed in "${this.configPath}"`)
42
- }
43
- } else {
44
- this.addLog('msvs_version not set from command line or npm config')
45
- }
46
-
47
- if (process.env.VCINSTALLDIR) {
48
- this.envVcInstallDir =
49
- path.resolve(process.env.VCINSTALLDIR, '..')
50
- this.addLog('running in VS Command Prompt, installation path is:\n' +
51
- `"${this.envVcInstallDir}"\n- will only use this version`)
52
- } else {
53
- this.addLog('VCINSTALLDIR not set, not running in VS Command Prompt')
54
- }
55
-
56
- const checks = [
57
- () => this.findVisualStudio2019OrNewerFromSpecifiedLocation(),
58
- () => this.findVisualStudio2019OrNewerUsingSetupModule(),
59
- () => this.findVisualStudio2019OrNewer(),
60
- () => this.findVisualStudio2017FromSpecifiedLocation(),
61
- () => this.findVisualStudio2017UsingSetupModule(),
62
- () => this.findVisualStudio2017(),
63
- () => this.findVisualStudio2015(),
64
- () => this.findVisualStudio2013()
65
- ]
66
-
67
- for (const check of checks) {
68
- const info = await check()
69
- if (info) {
70
- return this.succeed(info)
71
- }
72
- }
73
-
74
- return this.fail()
75
- }
76
-
77
- succeed (info) {
78
- this.log.info(`using VS${info.versionYear} (${info.version}) found at:` +
79
- `\n"${info.path}"` +
80
- '\nrun with --verbose for detailed information')
81
- return info
82
- }
83
-
84
- fail () {
85
- if (this.configMsvsVersion && this.envVcInstallDir) {
86
- this.errorLog.push(
87
- 'msvs_version does not match this VS Command Prompt or the',
88
- 'installation cannot be used.')
89
- } else if (this.configMsvsVersion) {
90
- // If msvs_version was specified but finding VS failed, print what would
91
- // have been accepted
92
- this.errorLog.push('')
93
- if (this.validVersions) {
94
- this.errorLog.push('valid versions for msvs_version:')
95
- this.validVersions.forEach((version) => {
96
- this.errorLog.push(`- "${version}"`)
97
- })
98
- } else {
99
- this.errorLog.push('no valid versions for msvs_version were found')
100
- }
101
- }
102
-
103
- const errorLog = this.errorLog.join('\n')
104
-
105
- // For Windows 80 col console, use up to the column before the one marked
106
- // with X (total 79 chars including logger prefix, 62 chars usable here):
107
- // X
108
- const infoLog = [
109
- '**************************************************************',
110
- 'You need to install the latest version of Visual Studio',
111
- 'including the "Desktop development with C++" workload.',
112
- 'For more information consult the documentation at:',
113
- 'https://github.com/nodejs/node-gyp#on-windows',
114
- '**************************************************************'
115
- ].join('\n')
116
-
117
- this.log.error(`\n${errorLog}\n\n${infoLog}\n`)
118
- throw new Error('Could not find any Visual Studio installation to use')
119
- }
120
-
121
- async findVisualStudio2019OrNewerFromSpecifiedLocation () {
122
- return this.findVSFromSpecifiedLocation([2019, 2022])
123
- }
124
-
125
- async findVisualStudio2017FromSpecifiedLocation () {
126
- if (this.nodeSemver.major >= 22) {
127
- this.addLog(
128
- 'not looking for VS2017 as it is only supported up to Node.js 21')
129
- return null
130
- }
131
- return this.findVSFromSpecifiedLocation([2017])
132
- }
133
-
134
- async findVSFromSpecifiedLocation (supportedYears) {
135
- if (!this.envVcInstallDir) {
136
- return null
137
- }
138
- const info = {
139
- path: path.resolve(this.envVcInstallDir),
140
- // Assume the version specified by the user is correct.
141
- // Since Visual Studio 2015, the Developer Command Prompt sets the
142
- // VSCMD_VER environment variable which contains the version information
143
- // for Visual Studio.
144
- // https://learn.microsoft.com/en-us/visualstudio/ide/reference/command-prompt-powershell?view=vs-2022
145
- version: process.env.VSCMD_VER,
146
- packages: [
147
- 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64',
148
- // Assume MSBuild exists. It will be checked in processing.
149
- 'Microsoft.VisualStudio.VC.MSBuild.Base'
150
- ]
151
- }
152
-
153
- // Is there a better way to get SDK information?
154
- const envWindowsSDKVersion = process.env.WindowsSDKVersion
155
- const sdkVersionMatched = envWindowsSDKVersion?.match(/^(\d+)\.(\d+)\.(\d+)\..*/)
156
- if (sdkVersionMatched) {
157
- info.packages.push(`Microsoft.VisualStudio.Component.Windows10SDK.${sdkVersionMatched[3]}.Desktop`)
158
- }
159
- // pass for further processing
160
- return this.processData([info], supportedYears)
161
- }
162
-
163
- async findVisualStudio2019OrNewerUsingSetupModule () {
164
- return this.findNewVSUsingSetupModule([2019, 2022])
165
- }
166
-
167
- async findVisualStudio2017UsingSetupModule () {
168
- if (this.nodeSemver.major >= 22) {
169
- this.addLog(
170
- 'not looking for VS2017 as it is only supported up to Node.js 21')
171
- return null
172
- }
173
- return this.findNewVSUsingSetupModule([2017])
174
- }
175
-
176
- async findNewVSUsingSetupModule (supportedYears) {
177
- const ps = path.join(process.env.SystemRoot, 'System32',
178
- 'WindowsPowerShell', 'v1.0', 'powershell.exe')
179
- const vcInstallDir = this.envVcInstallDir
180
-
181
- const checkModuleArgs = [
182
- '-NoProfile',
183
- '-Command',
184
- '&{@(Get-Module -ListAvailable -Name VSSetup).Version.ToString()}'
185
- ]
186
- this.log.silly('Running', ps, checkModuleArgs)
187
- const [cErr] = await this.execFile(ps, checkModuleArgs)
188
- if (cErr) {
189
- this.addLog('VSSetup module doesn\'t seem to exist. You can install it via: "Install-Module VSSetup -Scope CurrentUser"')
190
- this.log.silly('VSSetup error = %j', cErr && (cErr.stack || cErr))
191
- return null
192
- }
193
- const filterArg = vcInstallDir !== undefined ? `| where {$_.InstallationPath -eq '${vcInstallDir}' }` : ''
194
- const psArgs = [
195
- '-NoProfile',
196
- '-Command',
197
- `&{Get-VSSetupInstance ${filterArg} | ConvertTo-Json -Depth 3}`
198
- ]
199
-
200
- this.log.silly('Running', ps, psArgs)
201
- const [err, stdout, stderr] = await this.execFile(ps, psArgs)
202
- let parsedData = this.parseData(err, stdout, stderr)
203
- if (parsedData === null) {
204
- return null
205
- }
206
- this.log.silly('Parsed data', parsedData)
207
- if (!Array.isArray(parsedData)) {
208
- // if there are only 1 result, then Powershell will output non-array
209
- parsedData = [parsedData]
210
- }
211
- // normalize output
212
- parsedData = parsedData.map((info) => {
213
- info.path = info.InstallationPath
214
- info.version = `${info.InstallationVersion.Major}.${info.InstallationVersion.Minor}.${info.InstallationVersion.Build}.${info.InstallationVersion.Revision}`
215
- info.packages = info.Packages.map((p) => p.Id)
216
- return info
217
- })
218
- // pass for further processing
219
- return this.processData(parsedData, supportedYears)
220
- }
221
-
222
- // Invoke the PowerShell script to get information about Visual Studio 2019
223
- // or newer installations
224
- async findVisualStudio2019OrNewer () {
225
- return this.findNewVS([2019, 2022])
226
- }
227
-
228
- // Invoke the PowerShell script to get information about Visual Studio 2017
229
- async findVisualStudio2017 () {
230
- if (this.nodeSemver.major >= 22) {
231
- this.addLog(
232
- 'not looking for VS2017 as it is only supported up to Node.js 21')
233
- return null
234
- }
235
- return this.findNewVS([2017])
236
- }
237
-
238
- // Invoke the PowerShell script to get information about Visual Studio 2017
239
- // or newer installations
240
- async findNewVS (supportedYears) {
241
- const ps = path.join(process.env.SystemRoot, 'System32',
242
- 'WindowsPowerShell', 'v1.0', 'powershell.exe')
243
- const csFile = path.join(__dirname, 'Find-VisualStudio.cs')
244
- const psArgs = [
245
- '-ExecutionPolicy',
246
- 'Unrestricted',
247
- '-NoProfile',
248
- '-Command',
249
- '&{Add-Type -Path \'' + csFile + '\';' + '[VisualStudioConfiguration.Main]::PrintJson()}'
250
- ]
251
-
252
- this.log.silly('Running', ps, psArgs)
253
- const [err, stdout, stderr] = await this.execFile(ps, psArgs)
254
- const parsedData = this.parseData(err, stdout, stderr, { checkIsArray: true })
255
- if (parsedData === null) {
256
- return null
257
- }
258
- return this.processData(parsedData, supportedYears)
259
- }
260
-
261
- // Parse the output of the PowerShell script, make sanity checks
262
- parseData (err, stdout, stderr, sanityCheckOptions) {
263
- const defaultOptions = {
264
- checkIsArray: false
265
- }
266
-
267
- // Merging provided options with the default options
268
- const sanityOptions = { ...defaultOptions, ...sanityCheckOptions }
269
-
270
- this.log.silly('PS stderr = %j', stderr)
271
-
272
- const failPowershell = (failureDetails) => {
273
- this.addLog(
274
- `could not use PowerShell to find Visual Studio 2017 or newer, try re-running with '--loglevel silly' for more details. \n
275
- Failure details: ${failureDetails}`)
276
- return null
277
- }
278
-
279
- if (err) {
280
- this.log.silly('PS err = %j', err && (err.stack || err))
281
- return failPowershell(`${err}`.substring(0, 40))
282
- }
283
-
284
- let vsInfo
285
- try {
286
- vsInfo = JSON.parse(stdout)
287
- } catch (e) {
288
- this.log.silly('PS stdout = %j', stdout)
289
- this.log.silly(e)
290
- return failPowershell()
291
- }
292
-
293
- if (sanityOptions.checkIsArray && !Array.isArray(vsInfo)) {
294
- this.log.silly('PS stdout = %j', stdout)
295
- return failPowershell('Expected array as output of the PS script')
296
- }
297
- return vsInfo
298
- }
299
-
300
- // Process parsed data containing information about VS installations
301
- // Look for the required parts, extract and output them back
302
- processData (vsInfo, supportedYears) {
303
- vsInfo = vsInfo.map((info) => {
304
- this.log.silly(`processing installation: "${info.path}"`)
305
- info.path = path.resolve(info.path)
306
- const ret = this.getVersionInfo(info)
307
- ret.path = info.path
308
- ret.msBuild = this.getMSBuild(info, ret.versionYear)
309
- ret.toolset = this.getToolset(info, ret.versionYear)
310
- ret.sdk = this.getSDK(info)
311
- return ret
312
- })
313
- this.log.silly('vsInfo:', vsInfo)
314
-
315
- // Remove future versions or errors parsing version number
316
- // Also remove any unsupported versions
317
- vsInfo = vsInfo.filter((info) => {
318
- if (info.versionYear && supportedYears.indexOf(info.versionYear) !== -1) {
319
- return true
320
- }
321
- this.addLog(`${info.versionYear ? 'unsupported' : 'unknown'} version "${info.version}" found at "${info.path}"`)
322
- return false
323
- })
324
-
325
- // Sort to place newer versions first
326
- vsInfo.sort((a, b) => b.versionYear - a.versionYear)
327
-
328
- for (let i = 0; i < vsInfo.length; ++i) {
329
- const info = vsInfo[i]
330
- this.addLog(`checking VS${info.versionYear} (${info.version}) found ` +
331
- `at:\n"${info.path}"`)
332
-
333
- if (info.msBuild) {
334
- this.addLog('- found "Visual Studio C++ core features"')
335
- } else {
336
- this.addLog('- "Visual Studio C++ core features" missing')
337
- continue
338
- }
339
-
340
- if (info.toolset) {
341
- this.addLog(`- found VC++ toolset: ${info.toolset}`)
342
- } else {
343
- this.addLog('- missing any VC++ toolset')
344
- continue
345
- }
346
-
347
- if (info.sdk) {
348
- this.addLog(`- found Windows SDK: ${info.sdk}`)
349
- } else {
350
- this.addLog('- missing any Windows SDK')
351
- continue
352
- }
353
-
354
- if (!this.checkConfigVersion(info.versionYear, info.path)) {
355
- continue
356
- }
357
-
358
- return info
359
- }
360
-
361
- this.addLog(
362
- 'could not find a version of Visual Studio 2017 or newer to use')
363
- return null
364
- }
365
-
366
- // Helper - process version information
367
- getVersionInfo (info) {
368
- const match = /^(\d+)\.(\d+)(?:\..*)?/.exec(info.version)
369
- if (!match) {
370
- this.log.silly('- failed to parse version:', info.version)
371
- return {}
372
- }
373
- this.log.silly('- version match = %j', match)
374
- const ret = {
375
- version: info.version,
376
- versionMajor: parseInt(match[1], 10),
377
- versionMinor: parseInt(match[2], 10)
378
- }
379
- if (ret.versionMajor === 15) {
380
- ret.versionYear = 2017
381
- return ret
382
- }
383
- if (ret.versionMajor === 16) {
384
- ret.versionYear = 2019
385
- return ret
386
- }
387
- if (ret.versionMajor === 17) {
388
- ret.versionYear = 2022
389
- return ret
390
- }
391
- this.log.silly('- unsupported version:', ret.versionMajor)
392
- return {}
393
- }
394
-
395
- msBuildPathExists (path) {
396
- return existsSync(path)
397
- }
398
-
399
- // Helper - process MSBuild information
400
- getMSBuild (info, versionYear) {
401
- const pkg = 'Microsoft.VisualStudio.VC.MSBuild.Base'
402
- const msbuildPath = path.join(info.path, 'MSBuild', 'Current', 'Bin', 'MSBuild.exe')
403
- const msbuildPathArm64 = path.join(info.path, 'MSBuild', 'Current', 'Bin', 'arm64', 'MSBuild.exe')
404
- if (info.packages.indexOf(pkg) !== -1) {
405
- this.log.silly('- found VC.MSBuild.Base')
406
- if (versionYear === 2017) {
407
- return path.join(info.path, 'MSBuild', '15.0', 'Bin', 'MSBuild.exe')
408
- }
409
- if (versionYear === 2019) {
410
- if (process.arch === 'arm64' && this.msBuildPathExists(msbuildPathArm64)) {
411
- return msbuildPathArm64
412
- } else {
413
- return msbuildPath
414
- }
415
- }
416
- }
417
- /**
418
- * Visual Studio 2022 doesn't have the MSBuild package.
419
- * Support for compiling _on_ ARM64 was added in MSVC 14.32.31326,
420
- * so let's leverage it if the user has an ARM64 device.
421
- */
422
- if (process.arch === 'arm64' && this.msBuildPathExists(msbuildPathArm64)) {
423
- return msbuildPathArm64
424
- } else if (this.msBuildPathExists(msbuildPath)) {
425
- return msbuildPath
426
- }
427
- return null
428
- }
429
-
430
- // Helper - process toolset information
431
- getToolset (info, versionYear) {
432
- const pkg = 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64'
433
- const express = 'Microsoft.VisualStudio.WDExpress'
434
-
435
- if (info.packages.indexOf(pkg) !== -1) {
436
- this.log.silly('- found VC.Tools.x86.x64')
437
- } else if (info.packages.indexOf(express) !== -1) {
438
- this.log.silly('- found Visual Studio Express (looking for toolset)')
439
- } else {
440
- return null
441
- }
442
-
443
- if (versionYear === 2017) {
444
- return 'v141'
445
- } else if (versionYear === 2019) {
446
- return 'v142'
447
- } else if (versionYear === 2022) {
448
- return 'v143'
449
- }
450
- this.log.silly('- invalid versionYear:', versionYear)
451
- return null
452
- }
453
-
454
- // Helper - process Windows SDK information
455
- getSDK (info) {
456
- const win8SDK = 'Microsoft.VisualStudio.Component.Windows81SDK'
457
- const win10SDKPrefix = 'Microsoft.VisualStudio.Component.Windows10SDK.'
458
- const win11SDKPrefix = 'Microsoft.VisualStudio.Component.Windows11SDK.'
459
-
460
- let Win10or11SDKVer = 0
461
- info.packages.forEach((pkg) => {
462
- if (!pkg.startsWith(win10SDKPrefix) && !pkg.startsWith(win11SDKPrefix)) {
463
- return
464
- }
465
- const parts = pkg.split('.')
466
- if (parts.length > 5 && parts[5] !== 'Desktop') {
467
- this.log.silly('- ignoring non-Desktop Win10/11SDK:', pkg)
468
- return
469
- }
470
- const foundSdkVer = parseInt(parts[4], 10)
471
- if (isNaN(foundSdkVer)) {
472
- // Microsoft.VisualStudio.Component.Windows10SDK.IpOverUsb
473
- this.log.silly('- failed to parse Win10/11SDK number:', pkg)
474
- return
475
- }
476
- this.log.silly('- found Win10/11SDK:', foundSdkVer)
477
- Win10or11SDKVer = Math.max(Win10or11SDKVer, foundSdkVer)
478
- })
479
-
480
- if (Win10or11SDKVer !== 0) {
481
- return `10.0.${Win10or11SDKVer}.0`
482
- } else if (info.packages.indexOf(win8SDK) !== -1) {
483
- this.log.silly('- found Win8SDK')
484
- return '8.1'
485
- }
486
- return null
487
- }
488
-
489
- // Find an installation of Visual Studio 2015 to use
490
- async findVisualStudio2015 () {
491
- if (this.nodeSemver.major >= 19) {
492
- this.addLog(
493
- 'not looking for VS2015 as it is only supported up to Node.js 18')
494
- return null
495
- }
496
- return this.findOldVS({
497
- version: '14.0',
498
- versionMajor: 14,
499
- versionMinor: 0,
500
- versionYear: 2015,
501
- toolset: 'v140'
502
- })
503
- }
504
-
505
- // Find an installation of Visual Studio 2013 to use
506
- async findVisualStudio2013 () {
507
- if (this.nodeSemver.major >= 9) {
508
- this.addLog(
509
- 'not looking for VS2013 as it is only supported up to Node.js 8')
510
- return null
511
- }
512
- return this.findOldVS({
513
- version: '12.0',
514
- versionMajor: 12,
515
- versionMinor: 0,
516
- versionYear: 2013,
517
- toolset: 'v120'
518
- })
519
- }
520
-
521
- // Helper - common code for VS2013 and VS2015
522
- async findOldVS (info) {
523
- const regVC7 = ['HKLM\\Software\\Microsoft\\VisualStudio\\SxS\\VC7',
524
- 'HKLM\\Software\\Wow6432Node\\Microsoft\\VisualStudio\\SxS\\VC7']
525
- const regMSBuild = 'HKLM\\Software\\Microsoft\\MSBuild\\ToolsVersions'
526
-
527
- this.addLog(`looking for Visual Studio ${info.versionYear}`)
528
- try {
529
- let res = await this.regSearchKeys(regVC7, info.version, [])
530
- const vsPath = path.resolve(res, '..')
531
- this.addLog(`- found in "${vsPath}"`)
532
- const msBuildRegOpts = process.arch === 'ia32' ? [] : ['/reg:32']
533
-
534
- try {
535
- res = await this.regSearchKeys([`${regMSBuild}\\${info.version}`], 'MSBuildToolsPath', msBuildRegOpts)
536
- } catch (err) {
537
- this.addLog('- could not find MSBuild in registry for this version')
538
- return null
539
- }
540
-
541
- const msBuild = path.join(res, 'MSBuild.exe')
542
- this.addLog(`- MSBuild in "${msBuild}"`)
543
-
544
- if (!this.checkConfigVersion(info.versionYear, vsPath)) {
545
- return null
546
- }
547
-
548
- info.path = vsPath
549
- info.msBuild = msBuild
550
- info.sdk = null
551
- return info
552
- } catch (err) {
553
- this.addLog('- not found')
554
- return null
555
- }
556
- }
557
-
558
- // After finding a usable version of Visual Studio:
559
- // - add it to validVersions to be displayed at the end if a specific
560
- // version was requested and not found;
561
- // - check if this is the version that was requested.
562
- // - check if this matches the Visual Studio Command Prompt
563
- checkConfigVersion (versionYear, vsPath) {
564
- this.validVersions.push(versionYear)
565
- this.validVersions.push(vsPath)
566
-
567
- if (this.configVersionYear && this.configVersionYear !== versionYear) {
568
- this.addLog('- msvs_version does not match this version')
569
- return false
570
- }
571
- if (this.configPath &&
572
- path.relative(this.configPath, vsPath) !== '') {
573
- this.addLog('- msvs_version does not point to this installation')
574
- return false
575
- }
576
- if (this.envVcInstallDir &&
577
- path.relative(this.envVcInstallDir, vsPath) !== '') {
578
- this.addLog('- does not match this Visual Studio Command Prompt')
579
- return false
580
- }
581
-
582
- return true
583
- }
584
-
585
- async execFile (exec, args) {
586
- return await execFile(exec, args, { encoding: 'utf8' })
587
- }
588
- }
589
-
590
- module.exports = VisualStudioFinder