@metamask/snaps-utils 8.0.1 → 8.1.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 (975) hide show
  1. package/CHANGELOG.md +16 -1
  2. package/dist/array.cjs +17 -0
  3. package/dist/array.cjs.map +1 -0
  4. package/dist/array.d.cts +11 -0
  5. package/dist/array.d.cts.map +1 -0
  6. package/dist/array.d.mts +11 -0
  7. package/dist/array.d.mts.map +1 -0
  8. package/dist/array.mjs +12 -7
  9. package/dist/array.mjs.map +1 -1
  10. package/dist/auxiliary-files.cjs +39 -0
  11. package/dist/auxiliary-files.cjs.map +1 -0
  12. package/dist/auxiliary-files.d.cts +17 -0
  13. package/dist/auxiliary-files.d.cts.map +1 -0
  14. package/dist/auxiliary-files.d.mts +17 -0
  15. package/dist/auxiliary-files.d.mts.map +1 -0
  16. package/dist/auxiliary-files.mjs +33 -14
  17. package/dist/auxiliary-files.mjs.map +1 -1
  18. package/dist/base64.cjs +38 -0
  19. package/dist/base64.cjs.map +1 -0
  20. package/dist/base64.d.cts +16 -0
  21. package/dist/base64.d.cts.map +1 -0
  22. package/dist/base64.d.mts +16 -0
  23. package/dist/base64.d.mts.map +1 -0
  24. package/dist/base64.mjs +32 -12
  25. package/dist/base64.mjs.map +1 -1
  26. package/dist/bytes.cjs +22 -0
  27. package/dist/bytes.cjs.map +1 -0
  28. package/dist/bytes.d.cts +9 -0
  29. package/dist/bytes.d.cts.map +1 -0
  30. package/dist/bytes.d.mts +9 -0
  31. package/dist/bytes.d.mts.map +1 -0
  32. package/dist/bytes.mjs +17 -9
  33. package/dist/bytes.mjs.map +1 -1
  34. package/dist/caveats.cjs +51 -0
  35. package/dist/caveats.cjs.map +1 -0
  36. package/dist/caveats.d.cts +47 -0
  37. package/dist/caveats.d.cts.map +1 -0
  38. package/dist/caveats.d.mts +47 -0
  39. package/dist/caveats.d.mts.map +1 -0
  40. package/dist/caveats.mjs +47 -7
  41. package/dist/caveats.mjs.map +1 -1
  42. package/dist/checksum.cjs +49 -0
  43. package/dist/checksum.cjs.map +1 -0
  44. package/dist/checksum.d.cts +22 -0
  45. package/dist/checksum.d.cts.map +1 -0
  46. package/dist/checksum.d.mts +22 -0
  47. package/dist/checksum.d.mts.map +1 -0
  48. package/dist/checksum.mjs +43 -12
  49. package/dist/checksum.mjs.map +1 -1
  50. package/dist/constants.cjs +8 -0
  51. package/dist/constants.cjs.map +1 -0
  52. package/dist/constants.d.cts +2 -0
  53. package/dist/constants.d.cts.map +1 -0
  54. package/dist/constants.d.mts +2 -0
  55. package/dist/constants.d.mts.map +1 -0
  56. package/dist/constants.mjs +4 -7
  57. package/dist/constants.mjs.map +1 -1
  58. package/dist/cronjob.cjs +70 -0
  59. package/dist/cronjob.cjs.map +1 -0
  60. package/dist/cronjob.d.cts +90 -0
  61. package/dist/cronjob.d.cts.map +1 -0
  62. package/dist/cronjob.d.mts +90 -0
  63. package/dist/cronjob.d.mts.map +1 -0
  64. package/dist/cronjob.mjs +64 -19
  65. package/dist/cronjob.mjs.map +1 -1
  66. package/dist/deep-clone.cjs +9 -0
  67. package/dist/deep-clone.cjs.map +1 -0
  68. package/dist/deep-clone.d.cts +2 -0
  69. package/dist/deep-clone.d.cts.map +1 -0
  70. package/dist/deep-clone.d.mts +2 -0
  71. package/dist/deep-clone.d.mts.map +1 -0
  72. package/dist/deep-clone.mjs +9 -7
  73. package/dist/deep-clone.mjs.map +1 -1
  74. package/dist/default-endowments.cjs +42 -0
  75. package/dist/default-endowments.cjs.map +1 -0
  76. package/dist/default-endowments.d.cts +5 -0
  77. package/dist/default-endowments.d.cts.map +1 -0
  78. package/dist/default-endowments.d.mts +5 -0
  79. package/dist/default-endowments.d.mts.map +1 -0
  80. package/dist/default-endowments.mjs +38 -7
  81. package/dist/default-endowments.mjs.map +1 -1
  82. package/dist/derivation-paths.cjs +215 -0
  83. package/dist/derivation-paths.cjs.map +1 -0
  84. package/dist/derivation-paths.d.cts +25 -0
  85. package/dist/derivation-paths.d.cts.map +1 -0
  86. package/dist/derivation-paths.d.mts +25 -0
  87. package/dist/derivation-paths.d.mts.map +1 -0
  88. package/dist/derivation-paths.mjs +206 -12
  89. package/dist/derivation-paths.mjs.map +1 -1
  90. package/dist/entropy.cjs +8 -0
  91. package/dist/entropy.cjs.map +1 -0
  92. package/dist/entropy.d.cts +4 -0
  93. package/dist/entropy.d.cts.map +1 -0
  94. package/dist/entropy.d.mts +4 -0
  95. package/dist/entropy.d.mts.map +1 -0
  96. package/dist/entropy.mjs +4 -9
  97. package/dist/entropy.mjs.map +1 -1
  98. package/dist/errors.cjs +189 -0
  99. package/dist/errors.cjs.map +1 -0
  100. package/dist/errors.d.cts +85 -0
  101. package/dist/errors.d.cts.map +1 -0
  102. package/dist/errors.d.mts +85 -0
  103. package/dist/errors.d.mts.map +1 -0
  104. package/dist/errors.mjs +179 -18
  105. package/dist/errors.mjs.map +1 -1
  106. package/dist/eval-worker.cjs +42 -0
  107. package/dist/eval-worker.cjs.map +1 -0
  108. package/dist/eval-worker.d.cts +2 -0
  109. package/dist/eval-worker.d.cts.map +1 -0
  110. package/dist/eval-worker.d.mts +2 -0
  111. package/dist/eval-worker.d.mts.map +1 -0
  112. package/dist/eval-worker.mjs +28 -31
  113. package/dist/eval-worker.mjs.map +1 -1
  114. package/dist/eval.cjs +54 -0
  115. package/dist/eval.cjs.map +1 -0
  116. package/dist/eval.d.cts +17 -0
  117. package/dist/eval.d.cts.map +1 -0
  118. package/dist/eval.d.mts +17 -0
  119. package/dist/eval.d.mts.map +1 -0
  120. package/dist/eval.mjs +48 -16
  121. package/dist/eval.mjs.map +1 -1
  122. package/dist/fs.cjs +159 -0
  123. package/dist/fs.cjs.map +1 -0
  124. package/dist/fs.d.cts +70 -0
  125. package/dist/fs.d.cts.map +1 -0
  126. package/dist/fs.d.mts +70 -0
  127. package/dist/fs.d.mts.map +1 -0
  128. package/dist/fs.mjs +144 -27
  129. package/dist/fs.mjs.map +1 -1
  130. package/dist/handler-types.cjs +18 -0
  131. package/dist/handler-types.cjs.map +1 -0
  132. package/dist/handler-types.d.cts +35 -0
  133. package/dist/handler-types.d.cts.map +1 -0
  134. package/dist/handler-types.d.mts +35 -0
  135. package/dist/handler-types.d.mts.map +1 -0
  136. package/dist/handler-types.mjs +14 -9
  137. package/dist/handler-types.mjs.map +1 -1
  138. package/dist/handlers.cjs +119 -0
  139. package/dist/handlers.cjs.map +1 -0
  140. package/dist/handlers.d.cts +750 -0
  141. package/dist/handlers.d.cts.map +1 -0
  142. package/dist/handlers.d.mts +750 -0
  143. package/dist/handlers.d.mts.map +1 -0
  144. package/dist/handlers.mjs +114 -33
  145. package/dist/handlers.mjs.map +1 -1
  146. package/dist/icon.cjs +58 -0
  147. package/dist/icon.cjs.map +1 -0
  148. package/dist/icon.d.cts +20 -0
  149. package/dist/icon.d.cts.map +1 -0
  150. package/dist/icon.d.mts +20 -0
  151. package/dist/icon.d.mts.map +1 -0
  152. package/dist/icon.mjs +52 -14
  153. package/dist/icon.mjs.map +1 -1
  154. package/dist/iframe.cjs +54 -0
  155. package/dist/iframe.cjs.map +1 -0
  156. package/dist/iframe.d.cts +12 -0
  157. package/dist/iframe.d.cts.map +1 -0
  158. package/dist/iframe.d.mts +12 -0
  159. package/dist/iframe.d.mts.map +1 -0
  160. package/dist/iframe.mjs +49 -7
  161. package/dist/iframe.mjs.map +1 -1
  162. package/dist/iframe.test.browser.cjs +15 -0
  163. package/dist/iframe.test.browser.cjs.map +1 -0
  164. package/dist/iframe.test.browser.d.cts +2 -0
  165. package/dist/iframe.test.browser.d.cts.map +1 -0
  166. package/dist/iframe.test.browser.d.mts +2 -0
  167. package/dist/iframe.test.browser.d.mts.map +1 -0
  168. package/dist/iframe.test.browser.mjs +13 -0
  169. package/dist/iframe.test.browser.mjs.map +1 -0
  170. package/dist/index.cjs +49 -0
  171. package/dist/index.cjs.map +1 -0
  172. package/dist/index.d.cts +33 -0
  173. package/dist/index.d.cts.map +1 -0
  174. package/dist/index.d.mts +33 -0
  175. package/dist/index.d.mts.map +1 -0
  176. package/dist/index.executionenv.cjs +25 -0
  177. package/dist/index.executionenv.cjs.map +1 -0
  178. package/dist/index.executionenv.d.cts +8 -0
  179. package/dist/index.executionenv.d.cts.map +1 -0
  180. package/dist/index.executionenv.d.mts +8 -0
  181. package/dist/index.executionenv.d.mts.map +1 -0
  182. package/dist/index.executionenv.mjs +8 -127
  183. package/dist/index.executionenv.mjs.map +1 -1
  184. package/dist/index.mjs +32 -397
  185. package/dist/index.mjs.map +1 -1
  186. package/dist/json-rpc.cjs +135 -0
  187. package/dist/json-rpc.cjs.map +1 -0
  188. package/dist/json-rpc.d.cts +56 -0
  189. package/dist/json-rpc.d.cts.map +1 -0
  190. package/dist/json-rpc.d.mts +56 -0
  191. package/dist/json-rpc.d.mts.map +1 -0
  192. package/dist/json-rpc.mjs +127 -17
  193. package/dist/json-rpc.mjs.map +1 -1
  194. package/dist/json.cjs +34 -0
  195. package/dist/json.cjs.map +1 -0
  196. package/dist/json.d.cts +23 -0
  197. package/dist/json.d.cts.map +1 -0
  198. package/dist/json.d.mts +23 -0
  199. package/dist/json.d.mts.map +1 -0
  200. package/dist/json.mjs +28 -9
  201. package/dist/json.mjs.map +1 -1
  202. package/dist/localization.cjs +128 -0
  203. package/dist/localization.cjs.map +1 -0
  204. package/dist/localization.d.cts +146 -0
  205. package/dist/localization.d.cts.map +1 -0
  206. package/dist/localization.d.mts +146 -0
  207. package/dist/localization.d.mts.map +1 -0
  208. package/dist/localization.mjs +119 -22
  209. package/dist/localization.mjs.map +1 -1
  210. package/dist/logging.cjs +67 -0
  211. package/dist/logging.cjs.map +1 -0
  212. package/dist/logging.d.cts +50 -0
  213. package/dist/logging.d.cts.map +1 -0
  214. package/dist/logging.d.mts +50 -0
  215. package/dist/logging.d.mts.map +1 -0
  216. package/dist/logging.mjs +60 -13
  217. package/dist/logging.mjs.map +1 -1
  218. package/dist/manifest/index.cjs +18 -0
  219. package/dist/manifest/index.cjs.map +1 -0
  220. package/dist/manifest/index.d.cts +2 -0
  221. package/dist/manifest/index.d.cts.map +1 -0
  222. package/dist/manifest/index.d.mts +2 -0
  223. package/dist/manifest/index.d.mts.map +1 -0
  224. package/dist/manifest/index.mjs +1 -64
  225. package/dist/manifest/index.mjs.map +1 -1
  226. package/dist/manifest/manifest.cjs +267 -0
  227. package/dist/manifest/manifest.cjs.map +1 -0
  228. package/dist/manifest/manifest.d.cts +100 -0
  229. package/dist/manifest/manifest.d.cts.map +1 -0
  230. package/dist/manifest/manifest.d.mts +100 -0
  231. package/dist/manifest/manifest.d.mts.map +1 -0
  232. package/dist/manifest/manifest.mjs +252 -57
  233. package/dist/manifest/manifest.mjs.map +1 -1
  234. package/dist/manifest/node.cjs +19 -0
  235. package/dist/manifest/node.cjs.map +1 -0
  236. package/dist/manifest/node.d.cts +3 -0
  237. package/dist/manifest/node.d.cts.map +1 -0
  238. package/dist/manifest/node.d.mts +3 -0
  239. package/dist/manifest/node.d.mts.map +1 -0
  240. package/dist/manifest/node.mjs +2 -105
  241. package/dist/manifest/node.mjs.map +1 -1
  242. package/dist/manifest/validation.cjs +194 -0
  243. package/dist/manifest/validation.cjs.map +1 -0
  244. package/dist/manifest/validation.d.cts +254 -0
  245. package/dist/manifest/validation.d.cts.map +1 -0
  246. package/dist/manifest/validation.d.mts +254 -0
  247. package/dist/manifest/validation.d.mts.map +1 -0
  248. package/dist/manifest/validation.mjs +186 -63
  249. package/dist/manifest/validation.mjs.map +1 -1
  250. package/dist/manifest/validator-types.cjs +3 -0
  251. package/dist/manifest/validator-types.cjs.map +1 -0
  252. package/dist/manifest/validator-types.d.cts +35 -0
  253. package/dist/manifest/validator-types.d.cts.map +1 -0
  254. package/dist/manifest/validator-types.d.mts +35 -0
  255. package/dist/manifest/validator-types.d.mts.map +1 -0
  256. package/dist/manifest/validator-types.mjs +1 -0
  257. package/dist/manifest/validator-types.mjs.map +1 -1
  258. package/dist/manifest/validator.cjs +109 -0
  259. package/dist/manifest/validator.cjs.map +1 -0
  260. package/dist/manifest/validator.d.cts +24 -0
  261. package/dist/manifest/validator.d.cts.map +1 -0
  262. package/dist/manifest/validator.d.mts +24 -0
  263. package/dist/manifest/validator.d.mts.map +1 -0
  264. package/dist/manifest/validator.mjs +79 -42
  265. package/dist/manifest/validator.mjs.map +1 -1
  266. package/dist/manifest/validators/checksum.cjs +23 -0
  267. package/dist/manifest/validators/checksum.cjs.map +1 -0
  268. package/dist/manifest/validators/checksum.d.cts +6 -0
  269. package/dist/manifest/validators/checksum.d.cts.map +1 -0
  270. package/dist/manifest/validators/checksum.d.mts +6 -0
  271. package/dist/manifest/validators/checksum.d.mts.map +1 -0
  272. package/dist/manifest/validators/checksum.mjs +18 -13
  273. package/dist/manifest/validators/checksum.mjs.map +1 -1
  274. package/dist/manifest/validators/expected-files.cjs +24 -0
  275. package/dist/manifest/validators/expected-files.cjs.map +1 -0
  276. package/dist/manifest/validators/expected-files.d.cts +6 -0
  277. package/dist/manifest/validators/expected-files.d.cts.map +1 -0
  278. package/dist/manifest/validators/expected-files.d.mts +6 -0
  279. package/dist/manifest/validators/expected-files.d.mts.map +1 -0
  280. package/dist/manifest/validators/expected-files.mjs +19 -7
  281. package/dist/manifest/validators/expected-files.mjs.map +1 -1
  282. package/dist/manifest/validators/icon-declared.cjs +15 -0
  283. package/dist/manifest/validators/icon-declared.cjs.map +1 -0
  284. package/dist/manifest/validators/icon-declared.d.cts +6 -0
  285. package/dist/manifest/validators/icon-declared.d.cts.map +1 -0
  286. package/dist/manifest/validators/icon-declared.d.mts +6 -0
  287. package/dist/manifest/validators/icon-declared.d.mts.map +1 -0
  288. package/dist/manifest/validators/icon-declared.mjs +10 -6
  289. package/dist/manifest/validators/icon-declared.mjs.map +1 -1
  290. package/dist/manifest/validators/icon-dimensions.cjs +20 -0
  291. package/dist/manifest/validators/icon-dimensions.cjs.map +1 -0
  292. package/dist/manifest/validators/icon-dimensions.d.cts +6 -0
  293. package/dist/manifest/validators/icon-dimensions.d.cts.map +1 -0
  294. package/dist/manifest/validators/icon-dimensions.d.mts +6 -0
  295. package/dist/manifest/validators/icon-dimensions.d.mts.map +1 -0
  296. package/dist/manifest/validators/icon-dimensions.mjs +15 -8
  297. package/dist/manifest/validators/icon-dimensions.mjs.map +1 -1
  298. package/dist/manifest/validators/icon-missing.cjs +16 -0
  299. package/dist/manifest/validators/icon-missing.cjs.map +1 -0
  300. package/dist/manifest/validators/icon-missing.d.cts +6 -0
  301. package/dist/manifest/validators/icon-missing.d.cts.map +1 -0
  302. package/dist/manifest/validators/icon-missing.d.mts +6 -0
  303. package/dist/manifest/validators/icon-missing.d.mts.map +1 -0
  304. package/dist/manifest/validators/icon-missing.mjs +11 -6
  305. package/dist/manifest/validators/icon-missing.mjs.map +1 -1
  306. package/dist/manifest/validators/index.cjs +31 -0
  307. package/dist/manifest/validators/index.cjs.map +1 -0
  308. package/dist/manifest/validators/index.d.cts +15 -0
  309. package/dist/manifest/validators/index.d.cts.map +1 -0
  310. package/dist/manifest/validators/index.d.mts +15 -0
  311. package/dist/manifest/validators/index.d.mts.map +1 -0
  312. package/dist/manifest/validators/index.mjs +14 -79
  313. package/dist/manifest/validators/index.mjs.map +1 -1
  314. package/dist/manifest/validators/is-localization-file.cjs +23 -0
  315. package/dist/manifest/validators/is-localization-file.cjs.map +1 -0
  316. package/dist/manifest/validators/is-localization-file.d.cts +6 -0
  317. package/dist/manifest/validators/is-localization-file.d.cts.map +1 -0
  318. package/dist/manifest/validators/is-localization-file.d.mts +6 -0
  319. package/dist/manifest/validators/is-localization-file.d.mts.map +1 -0
  320. package/dist/manifest/validators/is-localization-file.mjs +18 -10
  321. package/dist/manifest/validators/is-localization-file.mjs.map +1 -1
  322. package/dist/manifest/validators/is-package-json.cjs +24 -0
  323. package/dist/manifest/validators/is-package-json.cjs.map +1 -0
  324. package/dist/manifest/validators/is-package-json.d.cts +6 -0
  325. package/dist/manifest/validators/is-package-json.d.cts.map +1 -0
  326. package/dist/manifest/validators/is-package-json.d.mts +6 -0
  327. package/dist/manifest/validators/is-package-json.d.mts.map +1 -0
  328. package/dist/manifest/validators/is-package-json.mjs +19 -9
  329. package/dist/manifest/validators/is-package-json.mjs.map +1 -1
  330. package/dist/manifest/validators/is-snap-icon.cjs +24 -0
  331. package/dist/manifest/validators/is-snap-icon.cjs.map +1 -0
  332. package/dist/manifest/validators/is-snap-icon.d.cts +6 -0
  333. package/dist/manifest/validators/is-snap-icon.d.cts.map +1 -0
  334. package/dist/manifest/validators/is-snap-icon.d.mts +6 -0
  335. package/dist/manifest/validators/is-snap-icon.d.mts.map +1 -0
  336. package/dist/manifest/validators/is-snap-icon.mjs +19 -8
  337. package/dist/manifest/validators/is-snap-icon.mjs.map +1 -1
  338. package/dist/manifest/validators/is-snap-manifest.cjs +25 -0
  339. package/dist/manifest/validators/is-snap-manifest.cjs.map +1 -0
  340. package/dist/manifest/validators/is-snap-manifest.d.cts +6 -0
  341. package/dist/manifest/validators/is-snap-manifest.d.cts.map +1 -0
  342. package/dist/manifest/validators/is-snap-manifest.d.mts +6 -0
  343. package/dist/manifest/validators/is-snap-manifest.d.mts.map +1 -0
  344. package/dist/manifest/validators/is-snap-manifest.mjs +20 -21
  345. package/dist/manifest/validators/is-snap-manifest.mjs.map +1 -1
  346. package/dist/manifest/validators/manifest-localization.cjs +30 -0
  347. package/dist/manifest/validators/manifest-localization.cjs.map +1 -0
  348. package/dist/manifest/validators/manifest-localization.d.cts +6 -0
  349. package/dist/manifest/validators/manifest-localization.d.cts.map +1 -0
  350. package/dist/manifest/validators/manifest-localization.d.mts +6 -0
  351. package/dist/manifest/validators/manifest-localization.d.mts.map +1 -0
  352. package/dist/manifest/validators/manifest-localization.mjs +25 -8
  353. package/dist/manifest/validators/manifest-localization.mjs.map +1 -1
  354. package/dist/manifest/validators/package-json-recommended-fields.cjs +18 -0
  355. package/dist/manifest/validators/package-json-recommended-fields.cjs.map +1 -0
  356. package/dist/manifest/validators/package-json-recommended-fields.d.cts +6 -0
  357. package/dist/manifest/validators/package-json-recommended-fields.d.cts.map +1 -0
  358. package/dist/manifest/validators/package-json-recommended-fields.d.mts +6 -0
  359. package/dist/manifest/validators/package-json-recommended-fields.d.mts.map +1 -0
  360. package/dist/manifest/validators/package-json-recommended-fields.mjs +13 -6
  361. package/dist/manifest/validators/package-json-recommended-fields.mjs.map +1 -1
  362. package/dist/manifest/validators/package-name-match.cjs +21 -0
  363. package/dist/manifest/validators/package-name-match.cjs.map +1 -0
  364. package/dist/manifest/validators/package-name-match.d.cts +6 -0
  365. package/dist/manifest/validators/package-name-match.d.cts.map +1 -0
  366. package/dist/manifest/validators/package-name-match.d.mts +6 -0
  367. package/dist/manifest/validators/package-name-match.d.mts.map +1 -0
  368. package/dist/manifest/validators/package-name-match.mjs +16 -7
  369. package/dist/manifest/validators/package-name-match.mjs.map +1 -1
  370. package/dist/manifest/validators/repository-match.cjs +29 -0
  371. package/dist/manifest/validators/repository-match.cjs.map +1 -0
  372. package/dist/manifest/validators/repository-match.d.cts +6 -0
  373. package/dist/manifest/validators/repository-match.d.cts.map +1 -0
  374. package/dist/manifest/validators/repository-match.d.mts +6 -0
  375. package/dist/manifest/validators/repository-match.d.mts.map +1 -0
  376. package/dist/manifest/validators/repository-match.mjs +28 -8
  377. package/dist/manifest/validators/repository-match.mjs.map +1 -1
  378. package/dist/manifest/validators/version-match.cjs +21 -0
  379. package/dist/manifest/validators/version-match.cjs.map +1 -0
  380. package/dist/manifest/validators/version-match.d.cts +6 -0
  381. package/dist/manifest/validators/version-match.d.cts.map +1 -0
  382. package/dist/manifest/validators/version-match.d.mts +6 -0
  383. package/dist/manifest/validators/version-match.d.mts.map +1 -0
  384. package/dist/manifest/validators/version-match.mjs +16 -7
  385. package/dist/manifest/validators/version-match.mjs.map +1 -1
  386. package/dist/mock.cjs +113 -0
  387. package/dist/mock.cjs.map +1 -0
  388. package/dist/mock.d.cts +15 -0
  389. package/dist/mock.d.cts.map +1 -0
  390. package/dist/mock.d.mts +15 -0
  391. package/dist/mock.d.mts.map +1 -0
  392. package/dist/mock.mjs +103 -11
  393. package/dist/mock.mjs.map +1 -1
  394. package/dist/namespace.cjs +136 -0
  395. package/dist/namespace.cjs.map +1 -0
  396. package/dist/namespace.d.cts +130 -0
  397. package/dist/namespace.d.cts.map +1 -0
  398. package/dist/namespace.d.mts +130 -0
  399. package/dist/namespace.d.mts.map +1 -0
  400. package/dist/namespace.mjs +125 -43
  401. package/dist/namespace.mjs.map +1 -1
  402. package/dist/node.cjs +25 -0
  403. package/dist/node.cjs.map +1 -0
  404. package/dist/node.d.cts +8 -0
  405. package/dist/node.d.cts.map +1 -0
  406. package/dist/node.d.mts +8 -0
  407. package/dist/node.d.mts.map +1 -0
  408. package/dist/node.mjs +8 -475
  409. package/dist/node.mjs.map +1 -1
  410. package/dist/path.cjs +21 -0
  411. package/dist/path.cjs.map +1 -0
  412. package/dist/path.d.cts +8 -0
  413. package/dist/path.d.cts.map +1 -0
  414. package/dist/path.d.mts +8 -0
  415. package/dist/path.d.mts.map +1 -0
  416. package/dist/path.mjs +16 -7
  417. package/dist/path.mjs.map +1 -1
  418. package/dist/post-process.cjs +339 -0
  419. package/dist/post-process.cjs.map +1 -0
  420. package/dist/post-process.d.cts +72 -0
  421. package/dist/post-process.d.cts.map +1 -0
  422. package/dist/post-process.d.mts +72 -0
  423. package/dist/post-process.d.mts.map +1 -0
  424. package/dist/post-process.mjs +335 -9
  425. package/dist/post-process.mjs.map +1 -1
  426. package/dist/promise.cjs +3 -0
  427. package/dist/promise.cjs.map +1 -0
  428. package/dist/promise.d.cts +2 -0
  429. package/dist/promise.d.cts.map +1 -0
  430. package/dist/promise.d.mts +2 -0
  431. package/dist/promise.d.mts.map +1 -0
  432. package/dist/promise.mjs +1 -1
  433. package/dist/promise.mjs.map +1 -1
  434. package/dist/snaps.cjs +207 -0
  435. package/dist/snaps.cjs.map +1 -0
  436. package/dist/snaps.d.cts +170 -0
  437. package/dist/snaps.d.cts.map +1 -0
  438. package/dist/snaps.d.mts +170 -0
  439. package/dist/snaps.d.mts.map +1 -0
  440. package/dist/snaps.mjs +200 -45
  441. package/dist/snaps.mjs.map +1 -1
  442. package/dist/strings.cjs +15 -0
  443. package/dist/strings.cjs.map +1 -0
  444. package/dist/strings.d.cts +9 -0
  445. package/dist/strings.d.cts.map +1 -0
  446. package/dist/strings.d.mts +9 -0
  447. package/dist/strings.d.mts.map +1 -0
  448. package/dist/strings.mjs +10 -7
  449. package/dist/strings.mjs.map +1 -1
  450. package/dist/structs.cjs +316 -0
  451. package/dist/structs.cjs.map +1 -0
  452. package/dist/structs.d.cts +181 -0
  453. package/dist/structs.d.cts.map +1 -0
  454. package/dist/structs.d.mts +181 -0
  455. package/dist/structs.d.mts.map +1 -0
  456. package/dist/structs.mjs +300 -32
  457. package/dist/structs.mjs.map +1 -1
  458. package/dist/svg.cjs +49 -0
  459. package/dist/svg.cjs.map +1 -0
  460. package/dist/svg.d.cts +15 -0
  461. package/dist/svg.d.cts.map +1 -0
  462. package/dist/svg.d.mts +15 -0
  463. package/dist/svg.d.mts.map +1 -0
  464. package/dist/svg.mjs +43 -9
  465. package/dist/svg.mjs.map +1 -1
  466. package/dist/types.cjs +64 -0
  467. package/dist/types.cjs.map +1 -0
  468. package/dist/types.d.cts +104 -0
  469. package/dist/types.d.cts.map +1 -0
  470. package/dist/types.d.mts +104 -0
  471. package/dist/types.d.mts.map +1 -0
  472. package/dist/types.mjs +58 -21
  473. package/dist/types.mjs.map +1 -1
  474. package/dist/ui.cjs +405 -0
  475. package/dist/ui.cjs.map +1 -0
  476. package/dist/ui.d.cts +93 -0
  477. package/dist/ui.d.cts.map +1 -0
  478. package/dist/ui.d.mts +93 -0
  479. package/dist/ui.d.mts.map +1 -0
  480. package/dist/ui.mjs +391 -23
  481. package/dist/ui.mjs.map +1 -1
  482. package/dist/validation.cjs +23 -0
  483. package/dist/validation.cjs.map +1 -0
  484. package/dist/validation.d.cts +9 -0
  485. package/dist/validation.d.cts.map +1 -0
  486. package/dist/validation.d.mts +9 -0
  487. package/dist/validation.d.mts.map +1 -0
  488. package/dist/validation.mjs +18 -26
  489. package/dist/validation.mjs.map +1 -1
  490. package/dist/versions.cjs +44 -0
  491. package/dist/versions.cjs.map +1 -0
  492. package/dist/versions.d.cts +22 -0
  493. package/dist/versions.d.cts.map +1 -0
  494. package/dist/versions.d.mts +22 -0
  495. package/dist/versions.d.mts.map +1 -0
  496. package/dist/versions.mjs +38 -11
  497. package/dist/versions.mjs.map +1 -1
  498. package/dist/virtual-file/VirtualFile.cjs +75 -0
  499. package/dist/virtual-file/VirtualFile.cjs.map +1 -0
  500. package/dist/virtual-file/VirtualFile.d.cts +35 -0
  501. package/dist/virtual-file/VirtualFile.d.cts.map +1 -0
  502. package/dist/virtual-file/VirtualFile.d.mts +35 -0
  503. package/dist/virtual-file/VirtualFile.d.mts.map +1 -0
  504. package/dist/virtual-file/VirtualFile.mjs +70 -8
  505. package/dist/virtual-file/VirtualFile.mjs.map +1 -1
  506. package/dist/virtual-file/index.cjs +18 -0
  507. package/dist/virtual-file/index.cjs.map +1 -0
  508. package/dist/virtual-file/index.d.cts +2 -0
  509. package/dist/virtual-file/index.d.cts.map +1 -0
  510. package/dist/virtual-file/index.d.mts +2 -0
  511. package/dist/virtual-file/index.d.mts.map +1 -0
  512. package/dist/virtual-file/index.mjs +1 -9
  513. package/dist/virtual-file/index.mjs.map +1 -1
  514. package/dist/virtual-file/node.cjs +19 -0
  515. package/dist/virtual-file/node.cjs.map +1 -0
  516. package/dist/virtual-file/node.d.cts +3 -0
  517. package/dist/virtual-file/node.d.cts.map +1 -0
  518. package/dist/virtual-file/node.d.mts +3 -0
  519. package/dist/virtual-file/node.d.mts.map +1 -0
  520. package/dist/virtual-file/node.mjs +2 -16
  521. package/dist/virtual-file/node.mjs.map +1 -1
  522. package/dist/virtual-file/toVirtualFile.cjs +31 -0
  523. package/dist/virtual-file/toVirtualFile.cjs.map +1 -0
  524. package/dist/virtual-file/toVirtualFile.d.cts +24 -0
  525. package/dist/virtual-file/toVirtualFile.d.cts.map +1 -0
  526. package/dist/virtual-file/toVirtualFile.d.mts +24 -0
  527. package/dist/virtual-file/toVirtualFile.d.mts.map +1 -0
  528. package/dist/virtual-file/toVirtualFile.mjs +25 -11
  529. package/dist/virtual-file/toVirtualFile.mjs.map +1 -1
  530. package/package.json +36 -24
  531. package/dist/array.js +0 -8
  532. package/dist/array.js.map +0 -1
  533. package/dist/auxiliary-files.js +0 -15
  534. package/dist/auxiliary-files.js.map +0 -1
  535. package/dist/base64.js +0 -13
  536. package/dist/base64.js.map +0 -1
  537. package/dist/bytes.js +0 -10
  538. package/dist/bytes.js.map +0 -1
  539. package/dist/caveats.js +0 -8
  540. package/dist/caveats.js.map +0 -1
  541. package/dist/checksum.js +0 -13
  542. package/dist/checksum.js.map +0 -1
  543. package/dist/chunk-37EUH3KZ.js +0 -293
  544. package/dist/chunk-37EUH3KZ.js.map +0 -1
  545. package/dist/chunk-3N27GIUS.mjs +0 -229
  546. package/dist/chunk-3N27GIUS.mjs.map +0 -1
  547. package/dist/chunk-3OXW5H4F.js +0 -30
  548. package/dist/chunk-3OXW5H4F.js.map +0 -1
  549. package/dist/chunk-3RFGTBEP.js +0 -151
  550. package/dist/chunk-3RFGTBEP.js.map +0 -1
  551. package/dist/chunk-3RUWAMJT.mjs +0 -31
  552. package/dist/chunk-3RUWAMJT.mjs.map +0 -1
  553. package/dist/chunk-3S4INAGA.mjs +0 -18
  554. package/dist/chunk-3S4INAGA.mjs.map +0 -1
  555. package/dist/chunk-44VFHYJO.js +0 -249
  556. package/dist/chunk-44VFHYJO.js.map +0 -1
  557. package/dist/chunk-4AA3TKRJ.mjs +0 -153
  558. package/dist/chunk-4AA3TKRJ.mjs.map +0 -1
  559. package/dist/chunk-4BGZ2CHC.mjs +0 -22
  560. package/dist/chunk-4BGZ2CHC.mjs.map +0 -1
  561. package/dist/chunk-4CMD46B2.js +0 -1
  562. package/dist/chunk-4CMD46B2.js.map +0 -1
  563. package/dist/chunk-4RYTYEUQ.mjs +0 -33
  564. package/dist/chunk-4RYTYEUQ.mjs.map +0 -1
  565. package/dist/chunk-4ZJOU3LR.js +0 -71
  566. package/dist/chunk-4ZJOU3LR.js.map +0 -1
  567. package/dist/chunk-53QXTM77.js +0 -229
  568. package/dist/chunk-53QXTM77.js.map +0 -1
  569. package/dist/chunk-5FTBWYCW.mjs +0 -27
  570. package/dist/chunk-5FTBWYCW.mjs.map +0 -1
  571. package/dist/chunk-5MABKEV7.mjs +0 -66
  572. package/dist/chunk-5MABKEV7.mjs.map +0 -1
  573. package/dist/chunk-5R7UF7KM.mjs +0 -21
  574. package/dist/chunk-5R7UF7KM.mjs.map +0 -1
  575. package/dist/chunk-5UAPBOKO.js +0 -37
  576. package/dist/chunk-5UAPBOKO.js.map +0 -1
  577. package/dist/chunk-5WKQI22S.js +0 -7
  578. package/dist/chunk-5WKQI22S.js.map +0 -1
  579. package/dist/chunk-63OXILAY.mjs +0 -69
  580. package/dist/chunk-63OXILAY.mjs.map +0 -1
  581. package/dist/chunk-6ATNGN44.js +0 -300
  582. package/dist/chunk-6ATNGN44.js.map +0 -1
  583. package/dist/chunk-6HXIPMBN.js +0 -103
  584. package/dist/chunk-6HXIPMBN.js.map +0 -1
  585. package/dist/chunk-6YJWU77L.js +0 -19
  586. package/dist/chunk-6YJWU77L.js.map +0 -1
  587. package/dist/chunk-7HLSXEHK.mjs +0 -300
  588. package/dist/chunk-7HLSXEHK.mjs.map +0 -1
  589. package/dist/chunk-7LG4D4XA.mjs +0 -20
  590. package/dist/chunk-7LG4D4XA.mjs.map +0 -1
  591. package/dist/chunk-7P62OIGX.js +0 -69
  592. package/dist/chunk-7P62OIGX.js.map +0 -1
  593. package/dist/chunk-7T7FYH77.mjs +0 -37
  594. package/dist/chunk-7T7FYH77.mjs.map +0 -1
  595. package/dist/chunk-7VJ2BOVU.js +0 -15
  596. package/dist/chunk-7VJ2BOVU.js.map +0 -1
  597. package/dist/chunk-A3RRMELT.mjs +0 -1
  598. package/dist/chunk-A3RRMELT.mjs.map +0 -1
  599. package/dist/chunk-AMW2VJ3N.js +0 -32
  600. package/dist/chunk-AMW2VJ3N.js.map +0 -1
  601. package/dist/chunk-ANYNWSCA.mjs +0 -104
  602. package/dist/chunk-ANYNWSCA.mjs.map +0 -1
  603. package/dist/chunk-AOGVLPQZ.js +0 -18
  604. package/dist/chunk-AOGVLPQZ.js.map +0 -1
  605. package/dist/chunk-AS5P6JRP.mjs +0 -9
  606. package/dist/chunk-AS5P6JRP.mjs.map +0 -1
  607. package/dist/chunk-ASZWZ7JT.js +0 -20
  608. package/dist/chunk-ASZWZ7JT.js.map +0 -1
  609. package/dist/chunk-B5GNTDE2.js +0 -109
  610. package/dist/chunk-B5GNTDE2.js.map +0 -1
  611. package/dist/chunk-BGSO2GQC.mjs +0 -41
  612. package/dist/chunk-BGSO2GQC.mjs.map +0 -1
  613. package/dist/chunk-BPK5BH7K.js +0 -27
  614. package/dist/chunk-BPK5BH7K.js.map +0 -1
  615. package/dist/chunk-CJK7DDV2.mjs +0 -109
  616. package/dist/chunk-CJK7DDV2.mjs.map +0 -1
  617. package/dist/chunk-CPG2UGAA.js +0 -25
  618. package/dist/chunk-CPG2UGAA.js.map +0 -1
  619. package/dist/chunk-DE22V5AO.mjs +0 -53
  620. package/dist/chunk-DE22V5AO.mjs.map +0 -1
  621. package/dist/chunk-DEQUNIME.js +0 -53
  622. package/dist/chunk-DEQUNIME.js.map +0 -1
  623. package/dist/chunk-DKO64Y4H.mjs +0 -27
  624. package/dist/chunk-DKO64Y4H.mjs.map +0 -1
  625. package/dist/chunk-E3BDBG6T.js +0 -20
  626. package/dist/chunk-E3BDBG6T.js.map +0 -1
  627. package/dist/chunk-EFRPCO3C.js +0 -1
  628. package/dist/chunk-EFRPCO3C.js.map +0 -1
  629. package/dist/chunk-EVHDXNOC.mjs +0 -35
  630. package/dist/chunk-EVHDXNOC.mjs.map +0 -1
  631. package/dist/chunk-EYWMVDCD.mjs +0 -25
  632. package/dist/chunk-EYWMVDCD.mjs.map +0 -1
  633. package/dist/chunk-FA4QIZH6.js +0 -1
  634. package/dist/chunk-FA4QIZH6.js.map +0 -1
  635. package/dist/chunk-FBZ5SU7X.js +0 -189
  636. package/dist/chunk-FBZ5SU7X.js.map +0 -1
  637. package/dist/chunk-GIVJAZ2Q.mjs +0 -248
  638. package/dist/chunk-GIVJAZ2Q.mjs.map +0 -1
  639. package/dist/chunk-GJAVOB7B.js +0 -24
  640. package/dist/chunk-GJAVOB7B.js.map +0 -1
  641. package/dist/chunk-GXSTPU7D.mjs +0 -293
  642. package/dist/chunk-GXSTPU7D.mjs.map +0 -1
  643. package/dist/chunk-HY4W6BUH.mjs +0 -24
  644. package/dist/chunk-HY4W6BUH.mjs.map +0 -1
  645. package/dist/chunk-HYF7Q6VY.mjs +0 -1
  646. package/dist/chunk-HYF7Q6VY.mjs.map +0 -1
  647. package/dist/chunk-I2SWLZ34.js +0 -30
  648. package/dist/chunk-I2SWLZ34.js.map +0 -1
  649. package/dist/chunk-IELPPZJP.mjs +0 -189
  650. package/dist/chunk-IELPPZJP.mjs.map +0 -1
  651. package/dist/chunk-IJX3CXOY.js +0 -9
  652. package/dist/chunk-IJX3CXOY.js.map +0 -1
  653. package/dist/chunk-IPUL74MZ.mjs +0 -30
  654. package/dist/chunk-IPUL74MZ.mjs.map +0 -1
  655. package/dist/chunk-IV3FSWZ7.mjs +0 -9
  656. package/dist/chunk-IV3FSWZ7.mjs.map +0 -1
  657. package/dist/chunk-IVDERT5W.js +0 -22
  658. package/dist/chunk-IVDERT5W.js.map +0 -1
  659. package/dist/chunk-JETPRED3.js +0 -248
  660. package/dist/chunk-JETPRED3.js.map +0 -1
  661. package/dist/chunk-JI5NQ2C3.mjs +0 -1
  662. package/dist/chunk-JI5NQ2C3.mjs.map +0 -1
  663. package/dist/chunk-JJTIVHFX.mjs +0 -38
  664. package/dist/chunk-JJTIVHFX.mjs.map +0 -1
  665. package/dist/chunk-L2DHOOBX.js +0 -33
  666. package/dist/chunk-L2DHOOBX.js.map +0 -1
  667. package/dist/chunk-LEKZPKS2.js +0 -21
  668. package/dist/chunk-LEKZPKS2.js.map +0 -1
  669. package/dist/chunk-LHQP7CUJ.mjs +0 -107
  670. package/dist/chunk-LHQP7CUJ.mjs.map +0 -1
  671. package/dist/chunk-LOJA2ZS4.js +0 -107
  672. package/dist/chunk-LOJA2ZS4.js.map +0 -1
  673. package/dist/chunk-LQSEBGOX.js +0 -34
  674. package/dist/chunk-LQSEBGOX.js.map +0 -1
  675. package/dist/chunk-MDOG3S4V.mjs +0 -34
  676. package/dist/chunk-MDOG3S4V.mjs.map +0 -1
  677. package/dist/chunk-MFGLB75H.mjs +0 -22
  678. package/dist/chunk-MFGLB75H.mjs.map +0 -1
  679. package/dist/chunk-MKFQAXRF.js +0 -21
  680. package/dist/chunk-MKFQAXRF.js.map +0 -1
  681. package/dist/chunk-MQURBEO4.mjs +0 -16
  682. package/dist/chunk-MQURBEO4.mjs.map +0 -1
  683. package/dist/chunk-MWAZGSRO.js +0 -75
  684. package/dist/chunk-MWAZGSRO.js.map +0 -1
  685. package/dist/chunk-N2JAYIUP.mjs +0 -75
  686. package/dist/chunk-N2JAYIUP.mjs.map +0 -1
  687. package/dist/chunk-N4MA537G.js +0 -22
  688. package/dist/chunk-N4MA537G.js.map +0 -1
  689. package/dist/chunk-N5HVDE3P.mjs +0 -30
  690. package/dist/chunk-N5HVDE3P.mjs.map +0 -1
  691. package/dist/chunk-N722KRZW.js +0 -41
  692. package/dist/chunk-N722KRZW.js.map +0 -1
  693. package/dist/chunk-NNYGTNHP.mjs +0 -1
  694. package/dist/chunk-NNYGTNHP.mjs.map +0 -1
  695. package/dist/chunk-NSVVZNSD.mjs +0 -183
  696. package/dist/chunk-NSVVZNSD.mjs.map +0 -1
  697. package/dist/chunk-NUCLSR2G.js +0 -8
  698. package/dist/chunk-NUCLSR2G.js.map +0 -1
  699. package/dist/chunk-OBN2WDFU.js +0 -38
  700. package/dist/chunk-OBN2WDFU.js.map +0 -1
  701. package/dist/chunk-P252LKUT.mjs +0 -9
  702. package/dist/chunk-P252LKUT.mjs.map +0 -1
  703. package/dist/chunk-PAOTMYIM.mjs +0 -69
  704. package/dist/chunk-PAOTMYIM.mjs.map +0 -1
  705. package/dist/chunk-PJMEJVOB.mjs +0 -29
  706. package/dist/chunk-PJMEJVOB.mjs.map +0 -1
  707. package/dist/chunk-PLBSSUVY.js +0 -29
  708. package/dist/chunk-PLBSSUVY.js.map +0 -1
  709. package/dist/chunk-PLNIERDY.js +0 -34
  710. package/dist/chunk-PLNIERDY.js.map +0 -1
  711. package/dist/chunk-PO5BBHHX.mjs +0 -22
  712. package/dist/chunk-PO5BBHHX.mjs.map +0 -1
  713. package/dist/chunk-PTOH2SVI.mjs +0 -55
  714. package/dist/chunk-PTOH2SVI.mjs.map +0 -1
  715. package/dist/chunk-PZF4KWU2.mjs +0 -151
  716. package/dist/chunk-PZF4KWU2.mjs.map +0 -1
  717. package/dist/chunk-QD3LTING.js +0 -34
  718. package/dist/chunk-QD3LTING.js.map +0 -1
  719. package/dist/chunk-QGCNQRIQ.js +0 -35
  720. package/dist/chunk-QGCNQRIQ.js.map +0 -1
  721. package/dist/chunk-QYPLUMB7.mjs +0 -249
  722. package/dist/chunk-QYPLUMB7.mjs.map +0 -1
  723. package/dist/chunk-RAZ7XG4Z.mjs +0 -1
  724. package/dist/chunk-RAZ7XG4Z.mjs.map +0 -1
  725. package/dist/chunk-RNMJQSVQ.js +0 -69
  726. package/dist/chunk-RNMJQSVQ.js.map +0 -1
  727. package/dist/chunk-RRFKK45V.mjs +0 -15
  728. package/dist/chunk-RRFKK45V.mjs.map +0 -1
  729. package/dist/chunk-S3BWTUTZ.js +0 -31
  730. package/dist/chunk-S3BWTUTZ.js.map +0 -1
  731. package/dist/chunk-SKKANJ45.mjs +0 -19
  732. package/dist/chunk-SKKANJ45.mjs.map +0 -1
  733. package/dist/chunk-SPCIIRSB.mjs +0 -7
  734. package/dist/chunk-SPCIIRSB.mjs.map +0 -1
  735. package/dist/chunk-SRMDDOVO.mjs +0 -20
  736. package/dist/chunk-SRMDDOVO.mjs.map +0 -1
  737. package/dist/chunk-SYYDKPK3.js +0 -15
  738. package/dist/chunk-SYYDKPK3.js.map +0 -1
  739. package/dist/chunk-T2VA4YJE.js +0 -104
  740. package/dist/chunk-T2VA4YJE.js.map +0 -1
  741. package/dist/chunk-T3VM5YXY.js +0 -1
  742. package/dist/chunk-T3VM5YXY.js.map +0 -1
  743. package/dist/chunk-T3YY4JIJ.js +0 -9
  744. package/dist/chunk-T3YY4JIJ.js.map +0 -1
  745. package/dist/chunk-T5ZOOZ46.js +0 -22
  746. package/dist/chunk-T5ZOOZ46.js.map +0 -1
  747. package/dist/chunk-TAMKWZ4E.js +0 -183
  748. package/dist/chunk-TAMKWZ4E.js.map +0 -1
  749. package/dist/chunk-TFP64TMV.js +0 -1
  750. package/dist/chunk-TFP64TMV.js.map +0 -1
  751. package/dist/chunk-TYWGZIOF.mjs +0 -34
  752. package/dist/chunk-TYWGZIOF.mjs.map +0 -1
  753. package/dist/chunk-UAINMOUU.js +0 -18
  754. package/dist/chunk-UAINMOUU.js.map +0 -1
  755. package/dist/chunk-UNNEBOL4.mjs +0 -15
  756. package/dist/chunk-UNNEBOL4.mjs.map +0 -1
  757. package/dist/chunk-UW74NLTC.mjs +0 -18
  758. package/dist/chunk-UW74NLTC.mjs.map +0 -1
  759. package/dist/chunk-VBYSWMSU.js +0 -66
  760. package/dist/chunk-VBYSWMSU.js.map +0 -1
  761. package/dist/chunk-VEPYH26P.js +0 -27
  762. package/dist/chunk-VEPYH26P.js.map +0 -1
  763. package/dist/chunk-VIAHMNTA.mjs +0 -34
  764. package/dist/chunk-VIAHMNTA.mjs.map +0 -1
  765. package/dist/chunk-VWLBM7XM.js +0 -1
  766. package/dist/chunk-VWLBM7XM.js.map +0 -1
  767. package/dist/chunk-W7A3BYUP.mjs +0 -1
  768. package/dist/chunk-W7A3BYUP.mjs.map +0 -1
  769. package/dist/chunk-W7KRIAIX.js +0 -55
  770. package/dist/chunk-W7KRIAIX.js.map +0 -1
  771. package/dist/chunk-X2GGUOMY.js +0 -153
  772. package/dist/chunk-X2GGUOMY.js.map +0 -1
  773. package/dist/chunk-X3UZCGO5.mjs +0 -103
  774. package/dist/chunk-X3UZCGO5.mjs.map +0 -1
  775. package/dist/chunk-XF2AZMWG.mjs +0 -32
  776. package/dist/chunk-XF2AZMWG.mjs.map +0 -1
  777. package/dist/chunk-XWYJQWHG.js +0 -56
  778. package/dist/chunk-XWYJQWHG.js.map +0 -1
  779. package/dist/chunk-XZ7362GQ.mjs +0 -63
  780. package/dist/chunk-XZ7362GQ.mjs.map +0 -1
  781. package/dist/chunk-XZNJFDBF.mjs +0 -21
  782. package/dist/chunk-XZNJFDBF.mjs.map +0 -1
  783. package/dist/chunk-YJHQZFR4.mjs +0 -71
  784. package/dist/chunk-YJHQZFR4.mjs.map +0 -1
  785. package/dist/chunk-YL2EHYAA.js +0 -16
  786. package/dist/chunk-YL2EHYAA.js.map +0 -1
  787. package/dist/chunk-Z2JQNSVL.mjs +0 -8
  788. package/dist/chunk-Z2JQNSVL.mjs.map +0 -1
  789. package/dist/chunk-ZT3KKTS2.js +0 -9
  790. package/dist/chunk-ZT3KKTS2.js.map +0 -1
  791. package/dist/constants.js +0 -8
  792. package/dist/constants.js.map +0 -1
  793. package/dist/cronjob.js +0 -20
  794. package/dist/cronjob.js.map +0 -1
  795. package/dist/deep-clone.js +0 -8
  796. package/dist/deep-clone.js.map +0 -1
  797. package/dist/default-endowments.js +0 -8
  798. package/dist/default-endowments.js.map +0 -1
  799. package/dist/derivation-paths.js +0 -13
  800. package/dist/derivation-paths.js.map +0 -1
  801. package/dist/entropy.js +0 -10
  802. package/dist/entropy.js.map +0 -1
  803. package/dist/errors.js +0 -20
  804. package/dist/errors.js.map +0 -1
  805. package/dist/eval-worker.js +0 -43
  806. package/dist/eval-worker.js.map +0 -1
  807. package/dist/eval.js +0 -17
  808. package/dist/eval.js.map +0 -1
  809. package/dist/fs.js +0 -28
  810. package/dist/fs.js.map +0 -1
  811. package/dist/handler-types.js +0 -10
  812. package/dist/handler-types.js.map +0 -1
  813. package/dist/handlers.js +0 -35
  814. package/dist/handlers.js.map +0 -1
  815. package/dist/icon.js +0 -15
  816. package/dist/icon.js.map +0 -1
  817. package/dist/iframe.js +0 -8
  818. package/dist/iframe.js.map +0 -1
  819. package/dist/index.executionenv.js +0 -128
  820. package/dist/index.executionenv.js.map +0 -1
  821. package/dist/index.js +0 -398
  822. package/dist/index.js.map +0 -1
  823. package/dist/json-rpc.js +0 -18
  824. package/dist/json-rpc.js.map +0 -1
  825. package/dist/json.js +0 -10
  826. package/dist/json.js.map +0 -1
  827. package/dist/localization.js +0 -23
  828. package/dist/localization.js.map +0 -1
  829. package/dist/logging.js +0 -14
  830. package/dist/logging.js.map +0 -1
  831. package/dist/manifest/index.js +0 -65
  832. package/dist/manifest/index.js.map +0 -1
  833. package/dist/manifest/manifest.js +0 -59
  834. package/dist/manifest/manifest.js.map +0 -1
  835. package/dist/manifest/node.js +0 -106
  836. package/dist/manifest/node.js.map +0 -1
  837. package/dist/manifest/validation.js +0 -64
  838. package/dist/manifest/validation.js.map +0 -1
  839. package/dist/manifest/validator-types.js +0 -1
  840. package/dist/manifest/validator-types.js.map +0 -1
  841. package/dist/manifest/validator.js +0 -44
  842. package/dist/manifest/validator.js.map +0 -1
  843. package/dist/manifest/validators/checksum.js +0 -15
  844. package/dist/manifest/validators/checksum.js.map +0 -1
  845. package/dist/manifest/validators/expected-files.js +0 -9
  846. package/dist/manifest/validators/expected-files.js.map +0 -1
  847. package/dist/manifest/validators/icon-declared.js +0 -8
  848. package/dist/manifest/validators/icon-declared.js.map +0 -1
  849. package/dist/manifest/validators/icon-dimensions.js +0 -10
  850. package/dist/manifest/validators/icon-dimensions.js.map +0 -1
  851. package/dist/manifest/validators/icon-missing.js +0 -8
  852. package/dist/manifest/validators/icon-missing.js.map +0 -1
  853. package/dist/manifest/validators/index.js +0 -80
  854. package/dist/manifest/validators/index.js.map +0 -1
  855. package/dist/manifest/validators/is-localization-file.js +0 -12
  856. package/dist/manifest/validators/is-localization-file.js.map +0 -1
  857. package/dist/manifest/validators/is-package-json.js +0 -11
  858. package/dist/manifest/validators/is-package-json.js.map +0 -1
  859. package/dist/manifest/validators/is-snap-icon.js +0 -10
  860. package/dist/manifest/validators/is-snap-icon.js.map +0 -1
  861. package/dist/manifest/validators/is-snap-manifest.js +0 -23
  862. package/dist/manifest/validators/is-snap-manifest.js.map +0 -1
  863. package/dist/manifest/validators/manifest-localization.js +0 -10
  864. package/dist/manifest/validators/manifest-localization.js.map +0 -1
  865. package/dist/manifest/validators/package-json-recommended-fields.js +0 -8
  866. package/dist/manifest/validators/package-json-recommended-fields.js.map +0 -1
  867. package/dist/manifest/validators/package-name-match.js +0 -9
  868. package/dist/manifest/validators/package-name-match.js.map +0 -1
  869. package/dist/manifest/validators/repository-match.js +0 -10
  870. package/dist/manifest/validators/repository-match.js.map +0 -1
  871. package/dist/manifest/validators/version-match.js +0 -9
  872. package/dist/manifest/validators/version-match.js.map +0 -1
  873. package/dist/mock.js +0 -13
  874. package/dist/mock.js.map +0 -1
  875. package/dist/namespace.js +0 -44
  876. package/dist/namespace.js.map +0 -1
  877. package/dist/node.js +0 -476
  878. package/dist/node.js.map +0 -1
  879. package/dist/path.js +0 -8
  880. package/dist/path.js.map +0 -1
  881. package/dist/post-process.js +0 -10
  882. package/dist/post-process.js.map +0 -1
  883. package/dist/promise.js +0 -2
  884. package/dist/promise.js.map +0 -1
  885. package/dist/snaps.js +0 -46
  886. package/dist/snaps.js.map +0 -1
  887. package/dist/strings.js +0 -8
  888. package/dist/strings.js.map +0 -1
  889. package/dist/structs.js +0 -33
  890. package/dist/structs.js.map +0 -1
  891. package/dist/svg.js +0 -10
  892. package/dist/svg.js.map +0 -1
  893. package/dist/tsconfig.build.tsbuildinfo +0 -1
  894. package/dist/types/array.d.ts +0 -10
  895. package/dist/types/auxiliary-files.d.ts +0 -16
  896. package/dist/types/base64.d.ts +0 -15
  897. package/dist/types/bytes.d.ts +0 -8
  898. package/dist/types/caveats.d.ts +0 -46
  899. package/dist/types/checksum.d.ts +0 -21
  900. package/dist/types/constants.d.ts +0 -1
  901. package/dist/types/cronjob.d.ts +0 -89
  902. package/dist/types/deep-clone.d.ts +0 -1
  903. package/dist/types/default-endowments.d.ts +0 -4
  904. package/dist/types/derivation-paths.d.ts +0 -24
  905. package/dist/types/entropy.d.ts +0 -3
  906. package/dist/types/errors.d.ts +0 -84
  907. package/dist/types/eval-worker.d.ts +0 -1
  908. package/dist/types/eval.d.ts +0 -16
  909. package/dist/types/fs.d.ts +0 -69
  910. package/dist/types/handler-types.d.ts +0 -34
  911. package/dist/types/handlers.d.ts +0 -749
  912. package/dist/types/icon.d.ts +0 -19
  913. package/dist/types/iframe.d.ts +0 -11
  914. package/dist/types/iframe.test.browser.d.ts +0 -1
  915. package/dist/types/index.d.ts +0 -32
  916. package/dist/types/index.executionenv.d.ts +0 -7
  917. package/dist/types/json-rpc.d.ts +0 -55
  918. package/dist/types/json.d.ts +0 -22
  919. package/dist/types/localization.d.ts +0 -145
  920. package/dist/types/logging.d.ts +0 -49
  921. package/dist/types/manifest/index.d.ts +0 -1
  922. package/dist/types/manifest/manifest.d.ts +0 -98
  923. package/dist/types/manifest/node.d.ts +0 -2
  924. package/dist/types/manifest/validation.d.ts +0 -253
  925. package/dist/types/manifest/validator-types.d.ts +0 -34
  926. package/dist/types/manifest/validator.d.ts +0 -22
  927. package/dist/types/manifest/validators/checksum.d.ts +0 -5
  928. package/dist/types/manifest/validators/expected-files.d.ts +0 -5
  929. package/dist/types/manifest/validators/icon-declared.d.ts +0 -5
  930. package/dist/types/manifest/validators/icon-dimensions.d.ts +0 -5
  931. package/dist/types/manifest/validators/icon-missing.d.ts +0 -5
  932. package/dist/types/manifest/validators/index.d.ts +0 -14
  933. package/dist/types/manifest/validators/is-localization-file.d.ts +0 -5
  934. package/dist/types/manifest/validators/is-package-json.d.ts +0 -5
  935. package/dist/types/manifest/validators/is-snap-icon.d.ts +0 -5
  936. package/dist/types/manifest/validators/is-snap-manifest.d.ts +0 -5
  937. package/dist/types/manifest/validators/manifest-localization.d.ts +0 -5
  938. package/dist/types/manifest/validators/package-json-recommended-fields.d.ts +0 -5
  939. package/dist/types/manifest/validators/package-name-match.d.ts +0 -5
  940. package/dist/types/manifest/validators/repository-match.d.ts +0 -5
  941. package/dist/types/manifest/validators/version-match.d.ts +0 -5
  942. package/dist/types/mock.d.ts +0 -14
  943. package/dist/types/namespace.d.ts +0 -129
  944. package/dist/types/node.d.ts +0 -7
  945. package/dist/types/path.d.ts +0 -7
  946. package/dist/types/post-process.d.ts +0 -71
  947. package/dist/types/promise.d.ts +0 -1
  948. package/dist/types/snaps.d.ts +0 -169
  949. package/dist/types/strings.d.ts +0 -8
  950. package/dist/types/structs.d.ts +0 -180
  951. package/dist/types/svg.d.ts +0 -14
  952. package/dist/types/types.d.ts +0 -103
  953. package/dist/types/ui.d.ts +0 -84
  954. package/dist/types/validation.d.ts +0 -8
  955. package/dist/types/versions.d.ts +0 -21
  956. package/dist/types/virtual-file/VirtualFile.d.ts +0 -34
  957. package/dist/types/virtual-file/index.d.ts +0 -1
  958. package/dist/types/virtual-file/node.d.ts +0 -2
  959. package/dist/types/virtual-file/toVirtualFile.d.ts +0 -21
  960. package/dist/types.js +0 -22
  961. package/dist/types.js.map +0 -1
  962. package/dist/ui.js +0 -24
  963. package/dist/ui.js.map +0 -1
  964. package/dist/validation.js +0 -27
  965. package/dist/validation.js.map +0 -1
  966. package/dist/versions.js +0 -12
  967. package/dist/versions.js.map +0 -1
  968. package/dist/virtual-file/VirtualFile.js +0 -9
  969. package/dist/virtual-file/VirtualFile.js.map +0 -1
  970. package/dist/virtual-file/index.js +0 -10
  971. package/dist/virtual-file/index.js.map +0 -1
  972. package/dist/virtual-file/node.js +0 -17
  973. package/dist/virtual-file/node.js.map +0 -1
  974. package/dist/virtual-file/toVirtualFile.js +0 -12
  975. package/dist/virtual-file/toVirtualFile.js.map +0 -1
@@ -0,0 +1,100 @@
1
+ /// <reference types="node" />
2
+ import type { Json } from "@metamask/utils";
3
+ import type { SnapFiles } from "../types.mjs";
4
+ import { VirtualFile } from "../virtual-file/node.mjs";
5
+ import type { SnapManifest } from "./validation.mjs";
6
+ import type { ValidatorResults } from "./validator.mjs";
7
+ import type { ValidatorMeta, ValidatorReport } from "./validator-types.mjs";
8
+ export type CheckManifestReport = Omit<ValidatorReport, 'fix'> & {
9
+ wasFixed?: boolean;
10
+ };
11
+ /**
12
+ * The result from the `checkManifest` function.
13
+ *
14
+ * @property manifest - The fixed manifest object.
15
+ * @property updated - Whether the manifest was written and updated.
16
+ */
17
+ export type CheckManifestResult = {
18
+ files?: SnapFiles;
19
+ updated: boolean;
20
+ reports: CheckManifestReport[];
21
+ };
22
+ export type WriteFileFunction = (path: string, data: string) => Promise<void>;
23
+ /**
24
+ * Validates a snap.manifest.json file. Attempts to fix the manifest and write
25
+ * the fixed version to disk if `writeManifest` is true. Throws if validation
26
+ * fails.
27
+ *
28
+ * @param basePath - The path to the folder with the manifest files.
29
+ * @param options - Additional options for the function.
30
+ * @param options.sourceCode - The source code of the Snap.
31
+ * @param options.writeFileFn - The function to use to write the manifest to disk.
32
+ * @param options.updateAndWriteManifest - Whether to auto-magically try to fix errors and then write the manifest to disk.
33
+ * @returns Whether the manifest was updated, and an array of warnings that
34
+ * were encountered during processing of the manifest files.
35
+ */
36
+ export declare function checkManifest(basePath: string, { updateAndWriteManifest, sourceCode, writeFileFn, }?: {
37
+ updateAndWriteManifest?: boolean;
38
+ sourceCode?: string;
39
+ writeFileFn?: WriteFileFunction;
40
+ }): Promise<CheckManifestResult>;
41
+ /**
42
+ * Run the algorithm for automatically fixing errors in manifest.
43
+ *
44
+ * The algorithm updates the manifest by fixing all fixable problems,
45
+ * and then run validation again to check if the new manifest is now correct.
46
+ * If not correct, the algorithm will use the manifest from previous iteration
47
+ * and try again `MAX_ATTEMPTS` times to update it before bailing and
48
+ * resulting in failure.
49
+ *
50
+ * @param results - Results of the initial run of validation.
51
+ * @param rules - Optional list of rules to run the fixes with.
52
+ * @returns The updated manifest and whether it was updated.
53
+ */
54
+ export declare function runFixes(results: ValidatorResults, rules?: ValidatorMeta[]): Promise<CheckManifestResult>;
55
+ /**
56
+ * Given an unvalidated Snap manifest, attempts to extract the location of the
57
+ * bundle source file location and read the file.
58
+ *
59
+ * @param basePath - The path to the folder with the manifest files.
60
+ * @param manifest - The unvalidated Snap manifest file contents.
61
+ * @param sourceCode - Override source code for plugins.
62
+ * @returns The contents of the bundle file, if any.
63
+ */
64
+ export declare function getSnapSourceCode(basePath: string, manifest: Json, sourceCode?: string): Promise<VirtualFile | undefined>;
65
+ /**
66
+ * Given an unvalidated Snap manifest, attempts to extract the location of the
67
+ * icon and read the file.
68
+ *
69
+ * @param basePath - The path to the folder with the manifest files.
70
+ * @param manifest - The unvalidated Snap manifest file contents.
71
+ * @returns The contents of the icon, if any.
72
+ */
73
+ export declare function getSnapIcon(basePath: string, manifest: Json): Promise<VirtualFile | undefined>;
74
+ /**
75
+ * Get an array of paths from an unvalidated Snap manifest.
76
+ *
77
+ * @param manifest - The unvalidated Snap manifest file contents.
78
+ * @param selector - A function that returns the paths to the files.
79
+ * @returns The paths to the files, if any.
80
+ */
81
+ export declare function getSnapFilePaths(manifest: Json, selector: (manifest: Partial<SnapManifest>) => string[] | undefined): string[] | undefined;
82
+ /**
83
+ * Given an unvalidated Snap manifest, attempts to extract the files with the
84
+ * given paths and read them.
85
+ *
86
+ * @param basePath - The path to the folder with the manifest files.
87
+ * @param paths - The paths to the files.
88
+ * @param encoding - An optional encoding to pass down to readVirtualFile.
89
+ * @returns A list of auxiliary files and their contents, if any.
90
+ */
91
+ export declare function getSnapFiles(basePath: string, paths: string[] | undefined, encoding?: BufferEncoding | null): Promise<VirtualFile[] | undefined>;
92
+ /**
93
+ * Sorts the given manifest in our preferred sort order and removes the
94
+ * `repository` field if it is falsy (it may be `null`).
95
+ *
96
+ * @param manifest - The manifest to sort and modify.
97
+ * @returns The disk-ready manifest.
98
+ */
99
+ export declare function getWritableManifest(manifest: SnapManifest): SnapManifest;
100
+ //# sourceMappingURL=manifest.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.d.mts","sourceRoot":"","sources":["../../src/manifest/manifest.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAQ5C,OAAO,KAAK,EAAE,SAAS,EAAwB,qBAAiB;AAEhE,OAAO,EAAmB,WAAW,EAAE,iCAA6B;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAqB;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAoB;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,8BAA0B;AAcxE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,GAAG;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,EACE,sBAA6B,EAC7B,UAAU,EACV,WAA0B,GAC3B,GAAE;IACD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC5B,GACL,OAAO,CAAC,mBAAmB,CAAC,CA6E9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,aAAa,EAAE,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAiE9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,IAAI,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA8BlC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,IAAI,GACb,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAqBlC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,GAAG,SAAS,wBAcpE;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAC3B,QAAQ,GAAE,cAAc,GAAG,IAAa,GACvC,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,CAcpC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAkBxE"}
@@ -1,59 +1,254 @@
1
- import {
2
- checkManifest,
3
- getSnapFilePaths,
4
- getSnapFiles,
5
- getSnapIcon,
6
- getSnapSourceCode,
7
- getWritableManifest,
8
- runFixes
9
- } from "../chunk-GIVJAZ2Q.mjs";
10
- import "../chunk-5MABKEV7.mjs";
11
- import "../chunk-PAOTMYIM.mjs";
12
- import "../chunk-7T7FYH77.mjs";
13
- import "../chunk-EYWMVDCD.mjs";
14
- import "../chunk-MDOG3S4V.mjs";
15
- import "../chunk-TYWGZIOF.mjs";
16
- import "../chunk-SKKANJ45.mjs";
17
- import "../chunk-MFGLB75H.mjs";
18
- import "../chunk-5FTBWYCW.mjs";
19
- import "../chunk-PO5BBHHX.mjs";
20
- import "../chunk-DKO64Y4H.mjs";
21
- import "../chunk-4BGZ2CHC.mjs";
22
- import "../chunk-MQURBEO4.mjs";
23
- import "../chunk-HY4W6BUH.mjs";
24
- import "../chunk-RRFKK45V.mjs";
25
- import "../chunk-4RYTYEUQ.mjs";
26
- import "../chunk-GXSTPU7D.mjs";
27
- import "../chunk-NSVVZNSD.mjs";
28
- import "../chunk-3N27GIUS.mjs";
29
- import "../chunk-IV3FSWZ7.mjs";
30
- import "../chunk-CJK7DDV2.mjs";
31
- import "../chunk-PTOH2SVI.mjs";
32
- import "../chunk-EVHDXNOC.mjs";
33
- import "../chunk-N2JAYIUP.mjs";
34
- import "../chunk-LHQP7CUJ.mjs";
35
- import "../chunk-ANYNWSCA.mjs";
36
- import "../chunk-AS5P6JRP.mjs";
37
- import "../chunk-X3UZCGO5.mjs";
38
- import "../chunk-RAZ7XG4Z.mjs";
39
- import "../chunk-XZNJFDBF.mjs";
40
- import "../chunk-HYF7Q6VY.mjs";
41
- import "../chunk-UNNEBOL4.mjs";
42
- import "../chunk-P252LKUT.mjs";
43
- import "../chunk-7LG4D4XA.mjs";
44
- import "../chunk-XF2AZMWG.mjs";
45
- import "../chunk-3S4INAGA.mjs";
46
- import "../chunk-DE22V5AO.mjs";
47
- import "../chunk-Z2JQNSVL.mjs";
48
- import "../chunk-YJHQZFR4.mjs";
49
- import "../chunk-3RUWAMJT.mjs";
50
- export {
51
- checkManifest,
52
- getSnapFilePaths,
53
- getSnapFiles,
54
- getSnapIcon,
55
- getSnapSourceCode,
56
- getWritableManifest,
57
- runFixes
1
+ import { getErrorMessage } from "@metamask/snaps-sdk";
2
+ import { assert, isPlainObject } from "@metamask/utils";
3
+ import { promises as fs } from "fs";
4
+ import pathUtils from "path";
5
+ import { deepClone } from "../deep-clone.mjs";
6
+ import { readJsonFile } from "../fs.mjs";
7
+ import { parseJson } from "../json.mjs";
8
+ import { NpmSnapFileNames } from "../types.mjs";
9
+ import { readVirtualFile, VirtualFile } from "../virtual-file/node.mjs";
10
+ import { hasFixes, runValidators } from "./validator.mjs";
11
+ const MANIFEST_SORT_ORDER = {
12
+ $schema: 1,
13
+ version: 2,
14
+ description: 3,
15
+ proposedName: 4,
16
+ repository: 5,
17
+ source: 6,
18
+ initialConnections: 7,
19
+ initialPermissions: 8,
20
+ manifestVersion: 9,
58
21
  };
22
+ /**
23
+ * Validates a snap.manifest.json file. Attempts to fix the manifest and write
24
+ * the fixed version to disk if `writeManifest` is true. Throws if validation
25
+ * fails.
26
+ *
27
+ * @param basePath - The path to the folder with the manifest files.
28
+ * @param options - Additional options for the function.
29
+ * @param options.sourceCode - The source code of the Snap.
30
+ * @param options.writeFileFn - The function to use to write the manifest to disk.
31
+ * @param options.updateAndWriteManifest - Whether to auto-magically try to fix errors and then write the manifest to disk.
32
+ * @returns Whether the manifest was updated, and an array of warnings that
33
+ * were encountered during processing of the manifest files.
34
+ */
35
+ export async function checkManifest(basePath, { updateAndWriteManifest = true, sourceCode, writeFileFn = fs.writeFile, } = {}) {
36
+ const manifestPath = pathUtils.join(basePath, NpmSnapFileNames.Manifest);
37
+ const manifestFile = await readJsonFile(manifestPath);
38
+ const unvalidatedManifest = manifestFile.result;
39
+ const packageFile = await readJsonFile(pathUtils.join(basePath, NpmSnapFileNames.PackageJson));
40
+ const auxiliaryFilePaths = getSnapFilePaths(unvalidatedManifest, (manifest) => manifest?.source?.files);
41
+ const localizationFilePaths = getSnapFilePaths(unvalidatedManifest, (manifest) => manifest?.source?.locales);
42
+ const localizationFiles = (await getSnapFiles(basePath, localizationFilePaths)) ?? [];
43
+ for (const localization of localizationFiles) {
44
+ try {
45
+ localization.result = parseJson(localization.toString());
46
+ }
47
+ catch (error) {
48
+ assert(error instanceof SyntaxError, error);
49
+ throw new Error(`Failed to parse localization file "${localization.path}" as JSON.`);
50
+ }
51
+ }
52
+ const snapFiles = {
53
+ manifest: manifestFile,
54
+ packageJson: packageFile,
55
+ sourceCode: await getSnapSourceCode(basePath, unvalidatedManifest, sourceCode),
56
+ svgIcon: await getSnapIcon(basePath, unvalidatedManifest),
57
+ // Intentionally pass null as the encoding here since the files may be binary
58
+ auxiliaryFiles: (await getSnapFiles(basePath, auxiliaryFilePaths, null)) ?? [],
59
+ localizationFiles,
60
+ };
61
+ const validatorResults = await runValidators(snapFiles);
62
+ let manifestResults = {
63
+ updated: false,
64
+ files: validatorResults.files,
65
+ reports: validatorResults.reports,
66
+ };
67
+ if (updateAndWriteManifest && hasFixes(manifestResults)) {
68
+ const fixedResults = await runFixes(validatorResults);
69
+ if (fixedResults.updated) {
70
+ manifestResults = fixedResults;
71
+ assert(manifestResults.files);
72
+ try {
73
+ await writeFileFn(pathUtils.join(basePath, NpmSnapFileNames.Manifest), manifestResults.files.manifest.toString());
74
+ }
75
+ catch (error) {
76
+ // Note: This error isn't pushed to the errors array, because it's not an
77
+ // error in the manifest itself.
78
+ throw new Error(`Failed to update "snap.manifest.json": ${getErrorMessage(error)}`);
79
+ }
80
+ }
81
+ }
82
+ return manifestResults;
83
+ }
84
+ /**
85
+ * Run the algorithm for automatically fixing errors in manifest.
86
+ *
87
+ * The algorithm updates the manifest by fixing all fixable problems,
88
+ * and then run validation again to check if the new manifest is now correct.
89
+ * If not correct, the algorithm will use the manifest from previous iteration
90
+ * and try again `MAX_ATTEMPTS` times to update it before bailing and
91
+ * resulting in failure.
92
+ *
93
+ * @param results - Results of the initial run of validation.
94
+ * @param rules - Optional list of rules to run the fixes with.
95
+ * @returns The updated manifest and whether it was updated.
96
+ */
97
+ export async function runFixes(results, rules) {
98
+ let shouldRunFixes = true;
99
+ const MAX_ATTEMPTS = 10;
100
+ assert(results.files);
101
+ let fixResults = results;
102
+ assert(fixResults.files);
103
+ fixResults.files.manifest = fixResults.files.manifest.clone();
104
+ for (let attempts = 1; shouldRunFixes && attempts <= MAX_ATTEMPTS; attempts++) {
105
+ assert(fixResults.files);
106
+ let manifest = fixResults.files.manifest.result;
107
+ const fixable = fixResults.reports.filter((report) => report.fix);
108
+ for (const report of fixable) {
109
+ assert(report.fix);
110
+ ({ manifest } = await report.fix({ manifest }));
111
+ }
112
+ fixResults.files.manifest.value = `${JSON.stringify(getWritableManifest(manifest), null, 2)}\n`;
113
+ fixResults.files.manifest.result = manifest;
114
+ fixResults = await runValidators(fixResults.files, rules);
115
+ shouldRunFixes = hasFixes(fixResults);
116
+ }
117
+ const initialReports = deepClone(results.reports);
118
+ // Was fixed
119
+ if (!shouldRunFixes) {
120
+ for (const report of initialReports) {
121
+ if (report.fix) {
122
+ report.wasFixed = true;
123
+ delete report.fix;
124
+ }
125
+ }
126
+ return {
127
+ files: fixResults.files,
128
+ updated: true,
129
+ reports: initialReports,
130
+ };
131
+ }
132
+ for (const report of initialReports) {
133
+ delete report.fix;
134
+ }
135
+ return {
136
+ files: results.files,
137
+ updated: false,
138
+ reports: initialReports,
139
+ };
140
+ }
141
+ /**
142
+ * Given an unvalidated Snap manifest, attempts to extract the location of the
143
+ * bundle source file location and read the file.
144
+ *
145
+ * @param basePath - The path to the folder with the manifest files.
146
+ * @param manifest - The unvalidated Snap manifest file contents.
147
+ * @param sourceCode - Override source code for plugins.
148
+ * @returns The contents of the bundle file, if any.
149
+ */
150
+ export async function getSnapSourceCode(basePath, manifest, sourceCode) {
151
+ if (!isPlainObject(manifest)) {
152
+ return undefined;
153
+ }
154
+ const sourceFilePath = manifest.source?.location
155
+ ?.npm?.filePath;
156
+ if (!sourceFilePath) {
157
+ return undefined;
158
+ }
159
+ if (sourceCode) {
160
+ return new VirtualFile({
161
+ path: pathUtils.join(basePath, sourceFilePath),
162
+ value: sourceCode,
163
+ });
164
+ }
165
+ try {
166
+ const virtualFile = await readVirtualFile(pathUtils.join(basePath, sourceFilePath), 'utf8');
167
+ return virtualFile;
168
+ }
169
+ catch (error) {
170
+ throw new Error(`Failed to read snap bundle file: ${getErrorMessage(error)}`);
171
+ }
172
+ }
173
+ /**
174
+ * Given an unvalidated Snap manifest, attempts to extract the location of the
175
+ * icon and read the file.
176
+ *
177
+ * @param basePath - The path to the folder with the manifest files.
178
+ * @param manifest - The unvalidated Snap manifest file contents.
179
+ * @returns The contents of the icon, if any.
180
+ */
181
+ export async function getSnapIcon(basePath, manifest) {
182
+ if (!isPlainObject(manifest)) {
183
+ return undefined;
184
+ }
185
+ const iconPath = manifest.source?.location?.npm
186
+ ?.iconPath;
187
+ if (!iconPath) {
188
+ return undefined;
189
+ }
190
+ try {
191
+ const virtualFile = await readVirtualFile(pathUtils.join(basePath, iconPath), 'utf8');
192
+ return virtualFile;
193
+ }
194
+ catch (error) {
195
+ throw new Error(`Failed to read snap icon file: ${getErrorMessage(error)}`);
196
+ }
197
+ }
198
+ /**
199
+ * Get an array of paths from an unvalidated Snap manifest.
200
+ *
201
+ * @param manifest - The unvalidated Snap manifest file contents.
202
+ * @param selector - A function that returns the paths to the files.
203
+ * @returns The paths to the files, if any.
204
+ */
205
+ export function getSnapFilePaths(manifest, selector) {
206
+ if (!isPlainObject(manifest)) {
207
+ return undefined;
208
+ }
209
+ const snapManifest = manifest;
210
+ const paths = selector(snapManifest);
211
+ if (!Array.isArray(paths)) {
212
+ return undefined;
213
+ }
214
+ return paths;
215
+ }
216
+ /**
217
+ * Given an unvalidated Snap manifest, attempts to extract the files with the
218
+ * given paths and read them.
219
+ *
220
+ * @param basePath - The path to the folder with the manifest files.
221
+ * @param paths - The paths to the files.
222
+ * @param encoding - An optional encoding to pass down to readVirtualFile.
223
+ * @returns A list of auxiliary files and their contents, if any.
224
+ */
225
+ export async function getSnapFiles(basePath, paths, encoding = 'utf8') {
226
+ if (!paths) {
227
+ return undefined;
228
+ }
229
+ try {
230
+ return await Promise.all(paths.map(async (filePath) => readVirtualFile(pathUtils.join(basePath, filePath), encoding)));
231
+ }
232
+ catch (error) {
233
+ throw new Error(`Failed to read snap files: ${getErrorMessage(error)}`);
234
+ }
235
+ }
236
+ /**
237
+ * Sorts the given manifest in our preferred sort order and removes the
238
+ * `repository` field if it is falsy (it may be `null`).
239
+ *
240
+ * @param manifest - The manifest to sort and modify.
241
+ * @returns The disk-ready manifest.
242
+ */
243
+ export function getWritableManifest(manifest) {
244
+ const { repository, ...remaining } = manifest;
245
+ const keys = Object.keys(repository ? { ...remaining, repository } : remaining);
246
+ const writableManifest = keys
247
+ .sort((a, b) => MANIFEST_SORT_ORDER[a] - MANIFEST_SORT_ORDER[b])
248
+ .reduce((result, key) => ({
249
+ ...result,
250
+ [key]: manifest[key],
251
+ }), {});
252
+ return writableManifest;
253
+ }
59
254
  //# sourceMappingURL=manifest.mjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
1
+ {"version":3,"file":"manifest.mjs","sourceRoot":"","sources":["../../src/manifest/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { getErrorMessage } from '@metamask/snaps-sdk';\nimport type { Json } from '@metamask/utils';\nimport { assert, isPlainObject } from '@metamask/utils';\nimport { promises as fs } from 'fs';\nimport pathUtils from 'path';\n\nimport { deepClone } from '../deep-clone';\nimport { readJsonFile } from '../fs';\nimport { parseJson } from '../json';\nimport type { SnapFiles, UnvalidatedSnapFiles } from '../types';\nimport { NpmSnapFileNames } from '../types';\nimport { readVirtualFile, VirtualFile } from '../virtual-file/node';\nimport type { SnapManifest } from './validation';\nimport type { ValidatorResults } from './validator';\nimport { hasFixes, runValidators } from './validator';\nimport type { ValidatorMeta, ValidatorReport } from './validator-types';\n\nconst MANIFEST_SORT_ORDER: Record<keyof SnapManifest, number> = {\n $schema: 1,\n version: 2,\n description: 3,\n proposedName: 4,\n repository: 5,\n source: 6,\n initialConnections: 7,\n initialPermissions: 8,\n manifestVersion: 9,\n};\n\nexport type CheckManifestReport = Omit<ValidatorReport, 'fix'> & {\n wasFixed?: boolean;\n};\n\n/**\n * The result from the `checkManifest` function.\n *\n * @property manifest - The fixed manifest object.\n * @property updated - Whether the manifest was written and updated.\n */\nexport type CheckManifestResult = {\n files?: SnapFiles;\n updated: boolean;\n reports: CheckManifestReport[];\n};\n\nexport type WriteFileFunction = (path: string, data: string) => Promise<void>;\n\n/**\n * Validates a snap.manifest.json file. Attempts to fix the manifest and write\n * the fixed version to disk if `writeManifest` is true. Throws if validation\n * fails.\n *\n * @param basePath - The path to the folder with the manifest files.\n * @param options - Additional options for the function.\n * @param options.sourceCode - The source code of the Snap.\n * @param options.writeFileFn - The function to use to write the manifest to disk.\n * @param options.updateAndWriteManifest - Whether to auto-magically try to fix errors and then write the manifest to disk.\n * @returns Whether the manifest was updated, and an array of warnings that\n * were encountered during processing of the manifest files.\n */\nexport async function checkManifest(\n basePath: string,\n {\n updateAndWriteManifest = true,\n sourceCode,\n writeFileFn = fs.writeFile,\n }: {\n updateAndWriteManifest?: boolean;\n sourceCode?: string;\n writeFileFn?: WriteFileFunction;\n } = {},\n): Promise<CheckManifestResult> {\n const manifestPath = pathUtils.join(basePath, NpmSnapFileNames.Manifest);\n const manifestFile = await readJsonFile(manifestPath);\n const unvalidatedManifest = manifestFile.result;\n\n const packageFile = await readJsonFile(\n pathUtils.join(basePath, NpmSnapFileNames.PackageJson),\n );\n\n const auxiliaryFilePaths = getSnapFilePaths(\n unvalidatedManifest,\n (manifest) => manifest?.source?.files,\n );\n\n const localizationFilePaths = getSnapFilePaths(\n unvalidatedManifest,\n (manifest) => manifest?.source?.locales,\n );\n const localizationFiles =\n (await getSnapFiles(basePath, localizationFilePaths)) ?? [];\n for (const localization of localizationFiles) {\n try {\n localization.result = parseJson(localization.toString());\n } catch (error) {\n assert(error instanceof SyntaxError, error);\n throw new Error(\n `Failed to parse localization file \"${localization.path}\" as JSON.`,\n );\n }\n }\n\n const snapFiles: UnvalidatedSnapFiles = {\n manifest: manifestFile,\n packageJson: packageFile,\n sourceCode: await getSnapSourceCode(\n basePath,\n unvalidatedManifest,\n sourceCode,\n ),\n svgIcon: await getSnapIcon(basePath, unvalidatedManifest),\n // Intentionally pass null as the encoding here since the files may be binary\n auxiliaryFiles:\n (await getSnapFiles(basePath, auxiliaryFilePaths, null)) ?? [],\n localizationFiles,\n };\n\n const validatorResults = await runValidators(snapFiles);\n let manifestResults: CheckManifestResult = {\n updated: false,\n files: validatorResults.files,\n reports: validatorResults.reports,\n };\n\n if (updateAndWriteManifest && hasFixes(manifestResults)) {\n const fixedResults = await runFixes(validatorResults);\n\n if (fixedResults.updated) {\n manifestResults = fixedResults;\n\n assert(manifestResults.files);\n\n try {\n await writeFileFn(\n pathUtils.join(basePath, NpmSnapFileNames.Manifest),\n manifestResults.files.manifest.toString(),\n );\n } catch (error) {\n // Note: This error isn't pushed to the errors array, because it's not an\n // error in the manifest itself.\n throw new Error(\n `Failed to update \"snap.manifest.json\": ${getErrorMessage(error)}`,\n );\n }\n }\n }\n\n return manifestResults;\n}\n\n/**\n * Run the algorithm for automatically fixing errors in manifest.\n *\n * The algorithm updates the manifest by fixing all fixable problems,\n * and then run validation again to check if the new manifest is now correct.\n * If not correct, the algorithm will use the manifest from previous iteration\n * and try again `MAX_ATTEMPTS` times to update it before bailing and\n * resulting in failure.\n *\n * @param results - Results of the initial run of validation.\n * @param rules - Optional list of rules to run the fixes with.\n * @returns The updated manifest and whether it was updated.\n */\nexport async function runFixes(\n results: ValidatorResults,\n rules?: ValidatorMeta[],\n): Promise<CheckManifestResult> {\n let shouldRunFixes = true;\n const MAX_ATTEMPTS = 10;\n\n assert(results.files);\n\n let fixResults: ValidatorResults = results;\n assert(fixResults.files);\n fixResults.files.manifest = fixResults.files.manifest.clone();\n\n for (\n let attempts = 1;\n shouldRunFixes && attempts <= MAX_ATTEMPTS;\n attempts++\n ) {\n assert(fixResults.files);\n\n let manifest = fixResults.files.manifest.result;\n\n const fixable = fixResults.reports.filter((report) => report.fix);\n for (const report of fixable) {\n assert(report.fix);\n ({ manifest } = await report.fix({ manifest }));\n }\n\n fixResults.files.manifest.value = `${JSON.stringify(\n getWritableManifest(manifest),\n null,\n 2,\n )}\\n`;\n fixResults.files.manifest.result = manifest;\n\n fixResults = await runValidators(fixResults.files, rules);\n shouldRunFixes = hasFixes(fixResults);\n }\n\n const initialReports: (CheckManifestReport & ValidatorReport)[] = deepClone(\n results.reports,\n );\n\n // Was fixed\n if (!shouldRunFixes) {\n for (const report of initialReports) {\n if (report.fix) {\n report.wasFixed = true;\n delete report.fix;\n }\n }\n\n return {\n files: fixResults.files,\n updated: true,\n reports: initialReports,\n };\n }\n\n for (const report of initialReports) {\n delete report.fix;\n }\n\n return {\n files: results.files,\n updated: false,\n reports: initialReports,\n };\n}\n\n/**\n * Given an unvalidated Snap manifest, attempts to extract the location of the\n * bundle source file location and read the file.\n *\n * @param basePath - The path to the folder with the manifest files.\n * @param manifest - The unvalidated Snap manifest file contents.\n * @param sourceCode - Override source code for plugins.\n * @returns The contents of the bundle file, if any.\n */\nexport async function getSnapSourceCode(\n basePath: string,\n manifest: Json,\n sourceCode?: string,\n): Promise<VirtualFile | undefined> {\n if (!isPlainObject(manifest)) {\n return undefined;\n }\n\n const sourceFilePath = (manifest as Partial<SnapManifest>).source?.location\n ?.npm?.filePath;\n\n if (!sourceFilePath) {\n return undefined;\n }\n\n if (sourceCode) {\n return new VirtualFile({\n path: pathUtils.join(basePath, sourceFilePath),\n value: sourceCode,\n });\n }\n\n try {\n const virtualFile = await readVirtualFile(\n pathUtils.join(basePath, sourceFilePath),\n 'utf8',\n );\n return virtualFile;\n } catch (error) {\n throw new Error(\n `Failed to read snap bundle file: ${getErrorMessage(error)}`,\n );\n }\n}\n\n/**\n * Given an unvalidated Snap manifest, attempts to extract the location of the\n * icon and read the file.\n *\n * @param basePath - The path to the folder with the manifest files.\n * @param manifest - The unvalidated Snap manifest file contents.\n * @returns The contents of the icon, if any.\n */\nexport async function getSnapIcon(\n basePath: string,\n manifest: Json,\n): Promise<VirtualFile | undefined> {\n if (!isPlainObject(manifest)) {\n return undefined;\n }\n\n const iconPath = (manifest as Partial<SnapManifest>).source?.location?.npm\n ?.iconPath;\n\n if (!iconPath) {\n return undefined;\n }\n\n try {\n const virtualFile = await readVirtualFile(\n pathUtils.join(basePath, iconPath),\n 'utf8',\n );\n return virtualFile;\n } catch (error) {\n throw new Error(`Failed to read snap icon file: ${getErrorMessage(error)}`);\n }\n}\n\n/**\n * Get an array of paths from an unvalidated Snap manifest.\n *\n * @param manifest - The unvalidated Snap manifest file contents.\n * @param selector - A function that returns the paths to the files.\n * @returns The paths to the files, if any.\n */\nexport function getSnapFilePaths(\n manifest: Json,\n selector: (manifest: Partial<SnapManifest>) => string[] | undefined,\n) {\n if (!isPlainObject(manifest)) {\n return undefined;\n }\n\n const snapManifest = manifest as Partial<SnapManifest>;\n const paths = selector(snapManifest);\n\n if (!Array.isArray(paths)) {\n return undefined;\n }\n\n return paths;\n}\n\n/**\n * Given an unvalidated Snap manifest, attempts to extract the files with the\n * given paths and read them.\n *\n * @param basePath - The path to the folder with the manifest files.\n * @param paths - The paths to the files.\n * @param encoding - An optional encoding to pass down to readVirtualFile.\n * @returns A list of auxiliary files and their contents, if any.\n */\nexport async function getSnapFiles(\n basePath: string,\n paths: string[] | undefined,\n encoding: BufferEncoding | null = 'utf8',\n): Promise<VirtualFile[] | undefined> {\n if (!paths) {\n return undefined;\n }\n\n try {\n return await Promise.all(\n paths.map(async (filePath) =>\n readVirtualFile(pathUtils.join(basePath, filePath), encoding),\n ),\n );\n } catch (error) {\n throw new Error(`Failed to read snap files: ${getErrorMessage(error)}`);\n }\n}\n\n/**\n * Sorts the given manifest in our preferred sort order and removes the\n * `repository` field if it is falsy (it may be `null`).\n *\n * @param manifest - The manifest to sort and modify.\n * @returns The disk-ready manifest.\n */\nexport function getWritableManifest(manifest: SnapManifest): SnapManifest {\n const { repository, ...remaining } = manifest;\n\n const keys = Object.keys(\n repository ? { ...remaining, repository } : remaining,\n ) as (keyof SnapManifest)[];\n\n const writableManifest = keys\n .sort((a, b) => MANIFEST_SORT_ORDER[a] - MANIFEST_SORT_ORDER[b])\n .reduce<Partial<SnapManifest>>(\n (result, key) => ({\n ...result,\n [key]: manifest[key],\n }),\n {},\n );\n\n return writableManifest as SnapManifest;\n}\n"]}
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./index.cjs"), exports);
18
+ __exportStar(require("./manifest.cjs"), exports);
19
+ //# sourceMappingURL=node.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node.cjs","sourceRoot":"","sources":["../../src/manifest/node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAAkB;AAClB,iDAA2B","sourcesContent":["export * from '.';\nexport * from './manifest';\n"]}
@@ -0,0 +1,3 @@
1
+ export * from "./index.cjs";
2
+ export * from "./manifest.cjs";
3
+ //# sourceMappingURL=node.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node.d.cts","sourceRoot":"","sources":["../../src/manifest/node.ts"],"names":[],"mappings":"AAAA,4BAAkB;AAClB,+BAA2B"}
@@ -0,0 +1,3 @@
1
+ export * from "./index.mjs";
2
+ export * from "./manifest.mjs";
3
+ //# sourceMappingURL=node.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node.d.mts","sourceRoot":"","sources":["../../src/manifest/node.ts"],"names":[],"mappings":"AAAA,4BAAkB;AAClB,+BAA2B"}
@@ -1,106 +1,3 @@
1
- import "../chunk-A3RRMELT.mjs";
2
- import {
3
- checkManifest,
4
- getSnapFilePaths,
5
- getSnapFiles,
6
- getSnapIcon,
7
- getSnapSourceCode,
8
- getWritableManifest,
9
- runFixes
10
- } from "../chunk-GIVJAZ2Q.mjs";
11
- import "../chunk-5MABKEV7.mjs";
12
- import "../chunk-PAOTMYIM.mjs";
13
- import "../chunk-7T7FYH77.mjs";
14
- import "../chunk-EYWMVDCD.mjs";
15
- import "../chunk-MDOG3S4V.mjs";
16
- import "../chunk-TYWGZIOF.mjs";
17
- import "../chunk-SKKANJ45.mjs";
18
- import "../chunk-MFGLB75H.mjs";
19
- import "../chunk-5FTBWYCW.mjs";
20
- import "../chunk-PO5BBHHX.mjs";
21
- import "../chunk-DKO64Y4H.mjs";
22
- import "../chunk-4BGZ2CHC.mjs";
23
- import "../chunk-MQURBEO4.mjs";
24
- import "../chunk-HY4W6BUH.mjs";
25
- import "../chunk-RRFKK45V.mjs";
26
- import "../chunk-4RYTYEUQ.mjs";
27
- import "../chunk-JI5NQ2C3.mjs";
28
- import {
29
- Bip32EntropyStruct,
30
- Bip32PathStruct,
31
- ChainIdsStruct,
32
- CurveStruct,
33
- EmptyObjectStruct,
34
- FORBIDDEN_COIN_TYPES,
35
- HandlerCaveatsStruct,
36
- InitialConnectionsStruct,
37
- LookupMatchersStruct,
38
- MAXIMUM_REQUEST_TIMEOUT,
39
- MINIMUM_REQUEST_TIMEOUT,
40
- MaxRequestTimeStruct,
41
- PermissionsStruct,
42
- SemVerRangeStruct,
43
- SnapAuxilaryFilesStruct,
44
- SnapGetBip32EntropyPermissionsStruct,
45
- SnapIdsStruct,
46
- SnapManifestStruct,
47
- assertIsSnapManifest,
48
- bip32entropy,
49
- createSnapManifest,
50
- isSnapManifest
51
- } from "../chunk-GXSTPU7D.mjs";
52
- import "../chunk-NSVVZNSD.mjs";
53
- import "../chunk-3N27GIUS.mjs";
54
- import "../chunk-IV3FSWZ7.mjs";
55
- import "../chunk-CJK7DDV2.mjs";
56
- import "../chunk-PTOH2SVI.mjs";
57
- import "../chunk-EVHDXNOC.mjs";
58
- import "../chunk-N2JAYIUP.mjs";
59
- import "../chunk-LHQP7CUJ.mjs";
60
- import "../chunk-ANYNWSCA.mjs";
61
- import "../chunk-AS5P6JRP.mjs";
62
- import "../chunk-X3UZCGO5.mjs";
63
- import "../chunk-RAZ7XG4Z.mjs";
64
- import "../chunk-XZNJFDBF.mjs";
65
- import "../chunk-HYF7Q6VY.mjs";
66
- import "../chunk-UNNEBOL4.mjs";
67
- import "../chunk-P252LKUT.mjs";
68
- import "../chunk-7LG4D4XA.mjs";
69
- import "../chunk-XF2AZMWG.mjs";
70
- import "../chunk-3S4INAGA.mjs";
71
- import "../chunk-DE22V5AO.mjs";
72
- import "../chunk-Z2JQNSVL.mjs";
73
- import "../chunk-YJHQZFR4.mjs";
74
- import "../chunk-3RUWAMJT.mjs";
75
- export {
76
- Bip32EntropyStruct,
77
- Bip32PathStruct,
78
- ChainIdsStruct,
79
- CurveStruct,
80
- EmptyObjectStruct,
81
- FORBIDDEN_COIN_TYPES,
82
- HandlerCaveatsStruct,
83
- InitialConnectionsStruct,
84
- LookupMatchersStruct,
85
- MAXIMUM_REQUEST_TIMEOUT,
86
- MINIMUM_REQUEST_TIMEOUT,
87
- MaxRequestTimeStruct,
88
- PermissionsStruct,
89
- SemVerRangeStruct,
90
- SnapAuxilaryFilesStruct,
91
- SnapGetBip32EntropyPermissionsStruct,
92
- SnapIdsStruct,
93
- SnapManifestStruct,
94
- assertIsSnapManifest,
95
- bip32entropy,
96
- checkManifest,
97
- createSnapManifest,
98
- getSnapFilePaths,
99
- getSnapFiles,
100
- getSnapIcon,
101
- getSnapSourceCode,
102
- getWritableManifest,
103
- isSnapManifest,
104
- runFixes
105
- };
1
+ export * from "./index.mjs";
2
+ export * from "./manifest.mjs";
106
3
  //# sourceMappingURL=node.mjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
1
+ {"version":3,"file":"node.mjs","sourceRoot":"","sources":["../../src/manifest/node.ts"],"names":[],"mappings":"AAAA,4BAAkB;AAClB,+BAA2B","sourcesContent":["export * from '.';\nexport * from './manifest';\n"]}